feat: add the originalID property to StoreTransaction (#186)

Author: ns-vasilev

Sources/Flare/Classes/Models/Internal/Protocols/IStoreTransaction.swift

@@ -35,6 +35,11 @@ protocol IStoreTransaction: Sendable {
     ///
     /// - Note: This is only available for StoreKit 2 transactions.
     var environment: StoreEnvironment? { get }
+
+    /// The original transaction identifier of a purchase.
+    ///
+    /// - Note: This is only available for StoreKit 2 transactions.
+    var originalID: UInt64? { get }
 }
 
 /// Default implementation of the currency property for backward compatibility.

Sources/Flare/Classes/Models/Internal/SK1StoreTransaction.swift

@@ -27,6 +27,10 @@ struct SK1StoreTransaction {
 // MARK: IStoreTransaction
 
 extension SK1StoreTransaction: IStoreTransaction {
+    var originalID: UInt64? {
+        nil
+    }
+
     var productIdentifier: String {
         transaction.productIdentifier
     }

Sources/Flare/Classes/Models/Internal/SK2StoreTransaction.swift

@@ -35,6 +35,10 @@ struct SK2StoreTransaction {
 
 @available(iOS 15.0, tvOS 15.0, watchOS 8.0, macOS 12.0, *)
 extension SK2StoreTransaction: IStoreTransaction {
+    var originalID: UInt64? {
+        transaction.originalID
+    }
+
     var productIdentifier: String {
         transaction.productID
     }

Sources/Flare/Classes/Models/StoreTransaction.swift

@@ -49,6 +49,10 @@ extension StoreTransaction {
 // MARK: IStoreTransaction
 
 extension StoreTransaction: IStoreTransaction {
+    public var originalID: UInt64? {
+        storeTransaction.originalID
+    }
+
     public var productIdentifier: String {
         storeTransaction.productIdentifier
     }