fix: improve promotional offer error handling and logging

Author: hyochan

Sources/Helpers/StoreKitTypesBridge.swift

@@ -167,15 +167,22 @@ enum StoreKitTypesBridge {
         return nil
     }
 
-    static func purchaseOptions(from props: RequestPurchaseIosProps) -> Set<StoreKit.Product.PurchaseOption> {
+    static func purchaseOptions(from props: RequestPurchaseIosProps) throws -> Set<StoreKit.Product.PurchaseOption> {
         var options: Set<StoreKit.Product.PurchaseOption> = []
         if let quantity = props.quantity, quantity > 1 {
             options.insert(.quantity(quantity))
         }
         if let token = props.appAccountToken, let uuid = UUID(uuidString: token) {
             options.insert(.appAccountToken(uuid))
         }
-        if let offerInput = props.withOffer, let option = promotionalOffer(from: offerInput) {
+        if let offerInput = props.withOffer {
+            guard let option = promotionalOffer(from: offerInput) else {
+                throw PurchaseError.make(
+                    code: .developerError,
+                    productId: props.sku,
+                    message: "Invalid promotional offer: nonce must be valid UUID and signature must be base64 encoded"
+                )
+            }
             options.insert(option)
         }
         return options
@@ -278,11 +285,19 @@ private extension StoreKitTypesBridge {
     }
 
     static func promotionalOffer(from offer: DiscountOfferInputIOS) -> StoreKit.Product.PurchaseOption? {
-        guard let nonce = UUID(uuidString: offer.nonce),
-              let signature = Data(base64Encoded: offer.signature) else {
+        guard let nonce = UUID(uuidString: offer.nonce) else {
+            OpenIapLog.error("❌ Invalid nonce format: \(offer.nonce)")
+            return nil
+        }
+
+        guard let signature = Data(base64Encoded: offer.signature) else {
+            OpenIapLog.error("❌ Invalid signature format (must be base64): \(offer.signature)")
             return nil
         }
+
         let timestamp = Int(offer.timestamp)
+        OpenIapLog.debug("✅ Creating promotional offer - ID: \(offer.identifier), KeyID: \(offer.keyIdentifier), Timestamp: \(timestamp)")
+
         return .promotionalOffer(
             offerID: offer.identifier,
             keyID: offer.keyIdentifier,

Sources/OpenIapModule.swift

@@ -170,26 +170,51 @@ public final class OpenIapModule: NSObject, OpenIapModuleProtocol {
         let iosProps = try resolveIosPurchaseProps(from: params)
         let sku = iosProps.sku
         let product = try await storeProduct(for: sku)
-        let options = StoreKitTypesBridge.purchaseOptions(from: iosProps)
+        let options = try StoreKitTypesBridge.purchaseOptions(from: iosProps)
 
         let result: StoreKit.Product.PurchaseResult
-        #if canImport(UIKit)
-        if #available(iOS 17.0, *) {
-            let scene: UIWindowScene? = await MainActor.run {
-                UIApplication.shared.connectedScenes.first as? UIWindowScene
-            }
-            guard let scene else {
-                let error = makePurchaseError(code: .purchaseError, message: "Could not find window scene")
-                emitPurchaseError(error)
-                throw error
+        do {
+            #if canImport(UIKit)
+            if #available(iOS 17.0, *) {
+                let scene: UIWindowScene? = await MainActor.run {
+                    UIApplication.shared.connectedScenes.first as? UIWindowScene
+                }
+                guard let scene else {
+                    let error = makePurchaseError(code: .purchaseError, message: "Could not find window scene")
+                    emitPurchaseError(error)
+                    throw error
+                }
+                result = try await product.purchase(confirmIn: scene, options: options)
+            } else {
+                result = try await product.purchase(options: options)
             }
-            result = try await product.purchase(confirmIn: scene, options: options)
-        } else {
+            #else
             result = try await product.purchase(options: options)
+            #endif
+        } catch {
+            // Enhanced error handling for promotional offers
+            if iosProps.withOffer != nil {
+                OpenIapLog.error("Purchase with promotional offer failed: \(error.localizedDescription)")
+                let enhancedMessage = """
+                    Promotional offer purchase failed: \(error.localizedDescription)
+
+                    Common causes:
+                    1. Invalid signature - verify server generates correct signature
+                    2. Sandbox testing - ensure current subscription has expired before testing offers
+                    3. Offer eligibility - user may not be eligible for this promotional offer
+                    4. Key mismatch - verify using correct In-App Purchase key for environment
+                    """
+                let purchaseError = makePurchaseError(
+                    code: .purchaseError,
+                    productId: sku,
+                    message: enhancedMessage
+                )
+                emitPurchaseError(purchaseError)
+                throw purchaseError
+            }
+            // Re-throw original error for non-promotional purchases
+            throw error
         }
-        #else
-        result = try await product.purchase(options: options)
-        #endif
 
         switch result {
         case .success(let verification):

openiap-versions.json

@@ -1,4 +1,4 @@
 {
-  "apple": "1.2.11",
+  "apple": "1.2.13",
   "gql": "1.0.12"
 }