expo-helium 0.8.5 → 3.0.5

package/build/revenuecat/revenuecat.js.map

@@ -1 +1 @@
-{"version":3,"file":"revenuecat.js","sourceRoot":"","sources":["../../src/revenuecat/revenuecat.ts"],"names":[],"mappings":"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","sourcesContent":["import Purchases, {PURCHASES_ERROR_CODE, PurchasesStoreProduct} from 'react-native-purchases';\nimport type { PurchasesError, PurchasesPackage, CustomerInfoUpdateListener, CustomerInfo, PurchasesEntitlementInfo } from 'react-native-purchases';\nimport {HeliumPurchaseConfig, HeliumPurchaseResult} from \"../HeliumPaywallSdk.types\";\n\n// Rename the factory function\nexport function createRevenueCatPurchaseConfig(config?: {\n  apiKey?: string;\n}): HeliumPurchaseConfig {\n    const rcHandler = new RevenueCatHeliumHandler(config?.apiKey);\n    return {\n      apiKey: config?.apiKey,\n      makePurchase: rcHandler.makePurchase.bind(rcHandler),\n      restorePurchases: rcHandler.restorePurchases.bind(rcHandler),\n    };\n}\n\nexport class RevenueCatHeliumHandler {\n    private productIdToPackageMapping: Record<string, PurchasesPackage> = {};\n    private isMappingInitialized: boolean = false;\n    private initializationPromise: Promise<void> | null = null;\n\n    private rcProductToPackageMapping: Record<string, PurchasesStoreProduct> = {};\n\n    constructor(apiKey?: string) {\n        if (apiKey) {\n            Purchases.configure({ apiKey });\n        } else {\n        }\n        this.initializePackageMapping();\n    }\n\n    private async initializePackageMapping(): Promise<void> {\n        if (this.initializationPromise) {\n            return this.initializationPromise;\n        }\n        this.initializationPromise = (async () => {\n            try {\n                const offerings = await Purchases.getOfferings();\n                const allOfferings = offerings.all;\n                for (const offering of Object.values(allOfferings)) {\n                    offering.availablePackages.forEach((pkg: PurchasesPackage) => {\n                        if (pkg.product?.identifier) {\n                            this.productIdToPackageMapping[pkg.product.identifier] = pkg;\n                        }\n                    });\n                }\n                this.isMappingInitialized = true;\n            } catch (error) {\n                this.isMappingInitialized = false;\n            } finally {\n                 this.initializationPromise = null;\n            }\n        })();\n         return this.initializationPromise;\n    }\n\n    private async ensureMappingInitialized(): Promise<void> {\n        if (!this.isMappingInitialized && !this.initializationPromise) {\n            await this.initializePackageMapping();\n        } else if (this.initializationPromise) {\n            await this.initializationPromise;\n        }\n    }\n\n    async makePurchase(productId: string): Promise<HeliumPurchaseResult> {\n        await this.ensureMappingInitialized();\n\n        const pkg: PurchasesPackage | undefined = this.productIdToPackageMapping[productId];\n        let rcProduct: PurchasesStoreProduct | undefined;\n        if (!pkg) {\n            // Use cached if available\n            rcProduct = this.rcProductToPackageMapping[productId];\n            if (!rcProduct) {\n                // Try to retrieve now\n                try {\n                    const rcProducts = await Purchases.getProducts([productId]);\n                    rcProduct = rcProducts.length > 0 ? rcProducts[0] : undefined;\n                } catch {\n                    // 'failed' status will be returned\n                }\n                if (rcProduct) {\n                    this.rcProductToPackageMapping[productId] = rcProduct;\n                }\n            }\n        }\n\n        try {\n            let customerInfo: CustomerInfo;\n            if (pkg) {\n                customerInfo = (await Purchases.purchasePackage(pkg)).customerInfo;\n            } else if (rcProduct) {\n                customerInfo = (await Purchases.purchaseStoreProduct(rcProduct)).customerInfo;\n            } else {\n               return { status: 'failed', error: `RevenueCat Product/Package not found for ID: ${productId}` };\n            }\n            const isActive = this.isProductActive(customerInfo, productId);\n            if (isActive) {\n                return { status: 'purchased' };\n            } else {\n                // This case might occur if the purchase succeeded but the entitlement wasn't immediately active\n                // or if a different product became active.\n                // Consider if polling/listening might be needed here too, similar to pending.\n                // For now, returning failed as the specific product isn't confirmed active.\n                return { status: 'failed', error: 'Purchase possibly complete but entitlement/subscription not active for this product.' };\n            }\n        } catch (error) {\n            const purchasesError = error as PurchasesError;\n\n            if (purchasesError?.code === PURCHASES_ERROR_CODE.PAYMENT_PENDING_ERROR) {\n                // Wait for a terminal state for up to 5 seconds\n                return new Promise((resolve) => {\n                    // Define the listener function separately to remove it later\n                    const updateListener: CustomerInfoUpdateListener = (updatedCustomerInfo: CustomerInfo) => {\n                        const isActive = this.isProductActive(updatedCustomerInfo, productId);\n                        if (isActive) {\n                            clearTimeout(timeoutId);\n                            // Remove listener using the function reference\n                            Purchases.removeCustomerInfoUpdateListener(updateListener);\n                            resolve({ status: 'purchased' });\n                        }\n                    };\n\n                    const timeoutId = setTimeout(() => {\n                         // Remove listener using the function reference on timeout\n                        Purchases.removeCustomerInfoUpdateListener(updateListener);\n                        resolve({ status: 'pending' });\n                    }, 5000);\n\n                    // Add the listener\n                    Purchases.addCustomerInfoUpdateListener(updateListener);\n                });\n            }\n\n            if (purchasesError?.code === PURCHASES_ERROR_CODE.PURCHASE_CANCELLED_ERROR) {\n                return { status: 'cancelled' };\n            }\n\n            // Handle other errors\n            return { status: 'failed', error: purchasesError?.message || 'RevenueCat purchase failed.' };\n        }\n    }\n\n    // Helper function to check if a product is active in CustomerInfo\n    private isProductActive(customerInfo: CustomerInfo, productId: string): boolean {\n        return Object.values(customerInfo.entitlements.active).some((entitlement: PurchasesEntitlementInfo) => entitlement.productIdentifier === productId)\n               || customerInfo.activeSubscriptions.includes(productId)\n               || customerInfo.allPurchasedProductIdentifiers.includes(productId);\n    }\n\n    async restorePurchases(): Promise<boolean> {\n        try {\n            const customerInfo = await Purchases.restorePurchases();\n            const isActive = Object.keys(customerInfo.entitlements.active).length > 0;\n            return isActive;\n        } catch (error) {\n            return false;\n        }\n    }\n}\n"]}
+{"version":3,"file":"revenuecat.js","sourceRoot":"","sources":["../../src/revenuecat/revenuecat.ts"],"names":[],"mappings":"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","sourcesContent":["import Purchases, {PURCHASES_ERROR_CODE, PurchasesStoreProduct} from 'react-native-purchases';\nimport type { PurchasesError, PurchasesPackage, CustomerInfoUpdateListener, CustomerInfo, PurchasesEntitlementInfo } from 'react-native-purchases';\nimport {HeliumPurchaseConfig, HeliumPurchaseResult} from \"../HeliumPaywallSdk.types\";\nimport {setRevenueCatAppUserId} from \"../index\";\n\n// Rename the factory function\nexport function createRevenueCatPurchaseConfig(config?: {\n  apiKey?: string;\n}): HeliumPurchaseConfig {\n    const rcHandler = new RevenueCatHeliumHandler(config?.apiKey);\n    return {\n      makePurchase: rcHandler.makePurchase.bind(rcHandler),\n      restorePurchases: rcHandler.restorePurchases.bind(rcHandler),\n    };\n}\n\nexport class RevenueCatHeliumHandler {\n    private productIdToPackageMapping: Record<string, PurchasesPackage> = {};\n    private isMappingInitialized: boolean = false;\n    private initializationPromise: Promise<void> | null = null;\n\n    private rcProductToPackageMapping: Record<string, PurchasesStoreProduct> = {};\n\n    constructor(apiKey?: string) {\n        if (apiKey) {\n            Purchases.configure({ apiKey });\n        }\n        void this.initializePackageMapping();\n    }\n\n    private async initializePackageMapping(): Promise<void> {\n        if (this.initializationPromise) {\n            return this.initializationPromise;\n        }\n        this.initializationPromise = (async () => {\n            try {\n                // Keep this value as up-to-date as possible\n                setRevenueCatAppUserId(await Purchases.getAppUserID());\n\n                const offerings = await Purchases.getOfferings();\n                const allOfferings = offerings.all;\n                for (const offering of Object.values(allOfferings)) {\n                    offering.availablePackages.forEach((pkg: PurchasesPackage) => {\n                        if (pkg.product?.identifier) {\n                            this.productIdToPackageMapping[pkg.product.identifier] = pkg;\n                        }\n                    });\n                }\n                this.isMappingInitialized = true;\n            } catch (error) {\n                this.isMappingInitialized = false;\n            } finally {\n                 this.initializationPromise = null;\n            }\n        })();\n         return this.initializationPromise;\n    }\n\n    private async ensureMappingInitialized(): Promise<void> {\n        if (!this.isMappingInitialized && !this.initializationPromise) {\n            await this.initializePackageMapping();\n        } else if (this.initializationPromise) {\n            await this.initializationPromise;\n        }\n    }\n\n    async makePurchase(productId: string): Promise<HeliumPurchaseResult> {\n        await this.ensureMappingInitialized();\n        // Keep this value as up-to-date as possible\n        setRevenueCatAppUserId(await Purchases.getAppUserID());\n\n        const pkg: PurchasesPackage | undefined = this.productIdToPackageMapping[productId];\n        let rcProduct: PurchasesStoreProduct | undefined;\n        if (!pkg) {\n            // Use cached if available\n            rcProduct = this.rcProductToPackageMapping[productId];\n            if (!rcProduct) {\n                // Try to retrieve now\n                try {\n                    const rcProducts = await Purchases.getProducts([productId]);\n                    rcProduct = rcProducts.length > 0 ? rcProducts[0] : undefined;\n                } catch {\n                    // 'failed' status will be returned\n                }\n                if (rcProduct) {\n                    this.rcProductToPackageMapping[productId] = rcProduct;\n                }\n            }\n        }\n\n        try {\n            let customerInfo: CustomerInfo;\n            if (pkg) {\n                customerInfo = (await Purchases.purchasePackage(pkg)).customerInfo;\n            } else if (rcProduct) {\n                customerInfo = (await Purchases.purchaseStoreProduct(rcProduct)).customerInfo;\n            } else {\n               return { status: 'failed', error: `RevenueCat Product/Package not found for ID: ${productId}` };\n            }\n            const isActive = this.isProductActive(customerInfo, productId);\n            if (isActive) {\n                return { status: 'purchased' };\n            } else {\n                // This case might occur if the purchase succeeded but the entitlement wasn't immediately active\n                // or if a different product became active.\n                // Consider if polling/listening might be needed here too, similar to pending.\n                // For now, returning failed as the specific product isn't confirmed active.\n                return { status: 'failed', error: 'Purchase possibly complete but entitlement/subscription not active for this product.' };\n            }\n        } catch (error) {\n            const purchasesError = error as PurchasesError;\n\n            if (purchasesError?.code === PURCHASES_ERROR_CODE.PAYMENT_PENDING_ERROR) {\n                // Wait for a terminal state for up to 5 seconds\n                return new Promise((resolve) => {\n                    // Define the listener function separately to remove it later\n                    const updateListener: CustomerInfoUpdateListener = (updatedCustomerInfo: CustomerInfo) => {\n                        const isActive = this.isProductActive(updatedCustomerInfo, productId);\n                        if (isActive) {\n                            clearTimeout(timeoutId);\n                            // Remove listener using the function reference\n                            Purchases.removeCustomerInfoUpdateListener(updateListener);\n                            resolve({ status: 'purchased' });\n                        }\n                    };\n\n                    const timeoutId = setTimeout(() => {\n                         // Remove listener using the function reference on timeout\n                        Purchases.removeCustomerInfoUpdateListener(updateListener);\n                        resolve({ status: 'pending' });\n                    }, 5000);\n\n                    // Add the listener\n                    Purchases.addCustomerInfoUpdateListener(updateListener);\n                });\n            }\n\n            if (purchasesError?.code === PURCHASES_ERROR_CODE.PURCHASE_CANCELLED_ERROR) {\n                return { status: 'cancelled' };\n            }\n\n            // Handle other errors\n            return { status: 'failed', error: purchasesError?.message || 'RevenueCat purchase failed.' };\n        }\n    }\n\n    // Helper function to check if a product is active in CustomerInfo\n    private isProductActive(customerInfo: CustomerInfo, productId: string): boolean {\n        return Object.values(customerInfo.entitlements.active).some((entitlement: PurchasesEntitlementInfo) => entitlement.productIdentifier === productId)\n               || customerInfo.activeSubscriptions.includes(productId)\n               || customerInfo.allPurchasedProductIdentifiers.includes(productId);\n    }\n\n    async restorePurchases(): Promise<boolean> {\n        try {\n            const customerInfo = await Purchases.restorePurchases();\n            const isActive = Object.keys(customerInfo.entitlements.active).length > 0;\n            return isActive;\n        } catch (error) {\n            return false;\n        }\n    }\n}\n"]}

package/ios/HeliumPaywallSdk.podspec

@@ -19,7 +19,7 @@ Pod::Spec.new do |s|
   s.static_framework = true
 
   s.dependency 'ExpoModulesCore'
-  s.dependency 'Helium', '2.3.0'
+  s.dependency 'Helium', '3.0.5'
 
   # Swift/Objective-C compatibility
   s.pod_target_xcconfig = {

package/ios/HeliumPaywallSdkModule.swift

@@ -56,19 +56,53 @@ public class HeliumPaywallSdkModule: Module {
 //     ])
 
     // Defines event names that the module can send to JavaScript.
-    Events("onHeliumPaywallEvent", "onDelegateActionEvent")
+    Events("onHeliumPaywallEvent", "onDelegateActionEvent", "paywallEventHandlers")
 
     // todo use Record here? https://docs.expo.dev/modules/module-api/#records
     Function("initialize") { (config: [String : Any]) in
-      let userTraitsMap = config["customUserTraits"] as? [String : Any]
+      let userTraitsMap = convertMarkersToBooleans(config["customUserTraits"] as? [String : Any])
       let fallbackBundleURLString = config["fallbackBundleUrlString"] as? String
       let fallbackBundleString = config["fallbackBundleString"] as? String
+      
+      let paywallLoadingConfig = convertMarkersToBooleans(config["paywallLoadingConfig"] as? [String: Any])
+      let useLoadingState = paywallLoadingConfig?["useLoadingState"] as? Bool ?? true
+      let loadingBudget = paywallLoadingConfig?["loadingBudget"] as? TimeInterval ?? 2.0
+      
+      var perTriggerLoadingConfig: [String: TriggerLoadingConfig]? = nil
+      if let perTriggerDict = paywallLoadingConfig?["perTriggerLoadingConfig"] as? [String: [String: Any]] {
+        var triggerConfigs: [String: TriggerLoadingConfig] = [:]
+        for (trigger, config) in perTriggerDict {
+          triggerConfigs[trigger] = TriggerLoadingConfig(
+            useLoadingState: config["useLoadingState"] as? Bool,
+            loadingBudget: config["loadingBudget"] as? TimeInterval
+          )
+        }
+        perTriggerLoadingConfig = triggerConfigs
+      }
+
+      let useDefaultDelegate = config["useDefaultDelegate"] as? Bool ?? false
+
+      let delegateEventHandler: (HeliumEvent) -> Void = { [weak self] event in
+          var eventDict = event.toDictionary()
+          // Add deprecated fields for backwards compatibility
+          if let paywallName = eventDict["paywallName"] {
+              eventDict["paywallTemplateName"] = paywallName
+          }
+          if let error = eventDict["error"] {
+              eventDict["errorDescription"] = error
+          }
+          if let productId = eventDict["productId"] {
+              eventDict["productKey"] = productId
+          }
+          if let buttonName = eventDict["buttonName"] {
+              eventDict["ctaName"] = buttonName
+          }
+          self?.sendEvent("onHeliumPaywallEvent", eventDict)
+      }
 
       // Create delegate with closures that send events to JavaScript
-      let delegate = InternalDelegate(
-        eventHandler: { [weak self] event in
-          self?.sendEvent("onHeliumPaywallEvent", event.toDictionary())
-        },
+      let internalDelegate = InternalDelegate(
+        eventHandler: delegateEventHandler,
         purchaseHandler: { [weak self] productId in
           guard let self else { return .failed(PurchaseError.purchaseFailed(errorMsg: "Module not active!")) }
           // Check if there's already a purchase in progress and cancel it
@@ -110,6 +144,8 @@ public class HeliumPaywallSdkModule: Module {
         }
       )
 
+      let defaultDelegate = DefaultPurchaseDelegate(eventHandler: delegateEventHandler)
+
       // Handle fallback bundle - either as URL string or JSON string
       var fallbackBundleURL: URL? = nil
       if let urlString = fallbackBundleURLString {
@@ -127,13 +163,17 @@ public class HeliumPaywallSdkModule: Module {
 
       Helium.shared.initialize(
         apiKey: config["apiKey"] as? String ?? "",
-        heliumPaywallDelegate: delegate,
-        fallbackPaywall: FallbackView(),
+        heliumPaywallDelegate: useDefaultDelegate ? defaultDelegate : internalDelegate,
+        fallbackConfig: HeliumFallbackConfig.withMultipleFallbacks(
+            fallbackBundle: fallbackBundleURL,
+            useLoadingState: useLoadingState,
+            loadingBudget: loadingBudget,
+            perTriggerLoadingConfig: perTriggerLoadingConfig
+        ),
         customUserId: config["customUserId"] as? String,
         customAPIEndpoint: config["customAPIEndpoint"] as? String,
         customUserTraits: userTraitsMap != nil ? HeliumUserTraits(userTraitsMap!) : nil,
-        revenueCatAppUserId: config["revenueCatAppUserId"] as? String,
-        fallbackBundleURL: fallbackBundleURL
+        revenueCatAppUserId: config["revenueCatAppUserId"] as? String
       )
     }
 
@@ -174,8 +214,25 @@ public class HeliumPaywallSdkModule: Module {
       continuation.resume(returning: success)
     }
 
-    Function("presentUpsell") { (trigger: String) in
-      Helium.shared.presentUpsell(trigger: trigger)
+    Function("presentUpsell") { (trigger: String, customPaywallTraits: [String: Any]?) in
+        Helium.shared.presentUpsell(
+            trigger: trigger,
+            eventHandlers: PaywallEventHandlers.withHandlers(
+                onOpen: { [weak self] event in
+                    self?.sendEvent("paywallEventHandlers", event.toDictionary())
+                },
+                onClose: { [weak self] event in
+                    self?.sendEvent("paywallEventHandlers", event.toDictionary())
+                },
+                onDismissed: { [weak self] event in
+                    self?.sendEvent("paywallEventHandlers", event.toDictionary())
+                },
+                onPurchaseSucceeded: { [weak self] event in
+                    self?.sendEvent("paywallEventHandlers", event.toDictionary())
+                }
+            ),
+            customPaywallTraits: convertMarkersToBooleans(customPaywallTraits)
+        )
     }
 
     Function("hideUpsell") {
@@ -221,10 +278,17 @@ public class HeliumPaywallSdkModule: Module {
       let canPresent: Bool
       let reason: String
 
+      let useLoading = Helium.shared.loadingStateEnabledFor(trigger: trigger)
+      let downloadInProgress = Helium.shared.getDownloadStatus() == .inProgress
+
       if paywallsLoaded && hasTrigger {
         // Normal case - paywall is ready
         canPresent = true
         reason = "ready"
+      } else if downloadInProgress && useLoading {
+        // Loading case - paywall still downloading
+        canPresent = true
+        reason = "loading"
       } else if HeliumFallbackViewManager.shared.getFallbackInfo(trigger: trigger) != nil {
         // Fallback is available (via downloaded bundle)
         canPresent = true
@@ -241,6 +305,10 @@ public class HeliumPaywallSdkModule: Module {
       )
     }
 
+    Function("setRevenueCatAppUserId") { (rcAppUserId: String) in
+        Helium.shared.setRevenueCatAppUserId(rcAppUserId)
+    }
+
     Function("handleDeepLink") { (urlString: String) in
       guard let url = URL(string: urlString) else {
         return false
@@ -249,15 +317,6 @@ public class HeliumPaywallSdkModule: Module {
       return Helium.shared.handleDeepLink(url)
     }
 
-    // Defines a JavaScript function that always returns a Promise and whose native code
-    // is by default dispatched on the different thread than the JavaScript runtime runs on.
-//     AsyncFunction("setValueAsync") { (value: String) in
-//       // Send an event to JavaScript.
-//       self.sendEvent("onHeliumPaywallEvent", [
-//         "value": value
-//       ])
-//     }
-
     // Enables the module to be used as a native view. Definition components that are accepted as part of the
     // view definition: Prop, Events.
     View(HeliumPaywallSdkView.self) {
@@ -271,15 +330,51 @@ public class HeliumPaywallSdkModule: Module {
       Events("onLoad")
     }
   }
+
+    /// Recursively converts special marker strings back to boolean values to restore
+    /// type information that was preserved when passing through native bridge
+    ///
+    /// Native bridge converts booleans to NSNumber (0/1), so we use
+    /// special marker strings to preserve the original intent. This helper converts:
+    /// - "__helium_rn_bool_true__" -> true
+    /// - "__helium_rn_bool_false__" -> false
+    /// - All other values remain unchanged
+    private func convertMarkersToBooleans(_ input: [String: Any]?) -> [String: Any]? {
+        guard let input = input else { return nil }
+
+        var result: [String: Any] = [:]
+        for (key, value) in input {
+            result[key] = convertValueMarkersToBooleans(value)
+        }
+        return result
+    }
+    /// Helper to recursively convert marker strings in any value type
+    private func convertValueMarkersToBooleans(_ value: Any) -> Any {
+        if let stringValue = value as? String {
+            switch stringValue {
+            case "__helium_rn_bool_true__":
+                return true
+            case "__helium_rn_bool_false__":
+                return false
+            default:
+                return stringValue
+            }
+        } else if let dictValue = value as? [String: Any] {
+            return convertMarkersToBooleans(dictValue) ?? [:]
+        } else if let arrayValue = value as? [Any] {
+            return arrayValue.map { convertValueMarkersToBooleans($0) }
+        }
+        return value
+    }
 }
 
 fileprivate class InternalDelegate: HeliumPaywallDelegate {
-    private let eventHandler: (HeliumPaywallEvent) -> Void
+    private let eventHandler: (HeliumEvent) -> Void
     private let purchaseHandler: (String) async -> HeliumPaywallTransactionStatus
     private let restoreHandler: () async -> Bool
 
     init(
-        eventHandler: @escaping (HeliumPaywallEvent) -> Void,
+        eventHandler: @escaping (HeliumEvent) -> Void,
         purchaseHandler: @escaping (String) async -> HeliumPaywallTransactionStatus,
         restoreHandler: @escaping () async -> Bool
     ) {
@@ -296,43 +391,20 @@ fileprivate class InternalDelegate: HeliumPaywallDelegate {
         return await restoreHandler()
     }
 
-    public func onHeliumPaywallEvent(event: HeliumPaywallEvent) {
+    func onPaywallEvent(_ event: any HeliumEvent) {
         eventHandler(event)
     }
 }
 
-fileprivate struct FallbackView: View {
-    @Environment(\.presentationMode) var presentationMode
-
-    var body: some View {
-        VStack(spacing: 20) {
-            Spacer()
-
-            Text("Fallback Paywall")
-                .font(.title)
-                .fontWeight(.bold)
-
-            Text("Something went wrong loading the paywall. Make sure you used the right trigger.")
-                .font(.body)
-                .multilineTextAlignment(.center)
-                .foregroundColor(.secondary)
-
-            Spacer()
-
-            Button(action: {
-                presentationMode.wrappedValue.dismiss()
-            }) {
-                Text("Close")
-                    .font(.headline)
-                    .foregroundColor(.white)
-                    .frame(maxWidth: .infinity)
-                    .padding()
-                    .background(Color.blue)
-                    .cornerRadius(10)
-            }
-            .padding(.horizontal, 40)
-            .padding(.bottom, 40)
-        }
-        .padding()
+fileprivate class DefaultPurchaseDelegate: StoreKitDelegate {
+    private let eventHandler: (HeliumEvent) -> Void
+    init(
+        eventHandler: @escaping (HeliumEvent) -> Void,
+    ) {
+        self.eventHandler = eventHandler
+    }
+
+    override func onPaywallEvent(_ event: any HeliumEvent) {
+        eventHandler(event)
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-helium",
-  "version": "0.8.5",
+  "version": "3.0.5",
   "description": "Helium paywalls expo sdk",
   "main": "build/index.js",
   "types": "build/index.d.ts",

package/src/HeliumPaywallSdk.types.ts

@@ -7,12 +7,30 @@ export type OnLoadEventPayload = {
 export type HeliumPaywallSdkModuleEvents = {
   onHeliumPaywallEvent: (params: HeliumPaywallEvent) => void;
   onDelegateActionEvent: (params: DelegateActionEvent) => void;
+  paywallEventHandlers: (params: HeliumPaywallEvent) => void;
 };
 export type HeliumPaywallEvent = {
-  type: string;
+  type: 'paywallOpen' | 'paywallClose' | 'paywallDismissed' |
+    'paywallOpenFailed' | 'paywallSkipped' | 'paywallButtonPressed' |
+    'productSelected' | 'purchasePressed' | 'purchaseSucceeded' |
+    'purchaseCancelled' | 'purchaseFailed' | 'purchaseRestored' |
+    'purchaseRestoreFailed' | 'purchasePending' | 'initializeStart' |
+    'paywallsDownloadSuccess' | 'paywallsDownloadError' | 'paywallWebViewRendered';
   triggerName?: string;
+  paywallName?: string;
+  /**
+   * @deprecated Use `paywallName` instead.
+   */
   paywallTemplateName?: string;
+  productId?: string;
+  /**
+   * @deprecated Use `productId` instead.
+   */
   productKey?: string;
+  buttonName?: string;
+  /**
+   * @deprecated Use `buttonName` instead.
+   */
   ctaName?: string;
   configId?: string;
   numAttempts?: number;
@@ -22,7 +40,16 @@ export type HeliumPaywallEvent = {
   fontsDownloadTimeTakenMS?: number;
   bundleDownloadTimeMS?: number;
   dismissAll?: boolean;
+  isSecondTry?: boolean;
+  error?: string;
+  /**
+   * @deprecated Use `error` instead.
+   */
   errorDescription?: string;
+  /**
+   * Unix timestamp in seconds
+   */
+  timestamp?: number;
 };
 export type DelegateActionEvent = {
   type: 'purchase' | 'restore';
@@ -49,9 +76,6 @@ export type HeliumDownloadStatus = 'downloadSuccess' | 'downloadFailure' | 'inPr
 export interface HeliumPurchaseConfig {
   makePurchase: (productId: string) => Promise<HeliumPurchaseResult>;
   restorePurchases: () => Promise<boolean>;
-
-  /** Optional RevenueCat API Key. If not provided, RevenueCat must be configured elsewhere. */
-  apiKey?: string;
 }
 
 // Helper function for creating Custom Purchase Config
@@ -65,17 +89,48 @@ export function createCustomPurchaseConfig(callbacks: {
   };
 }
 
+export type TriggerLoadingConfig = {
+  /** Whether to show loading state for this trigger. Set to nil to use the global `useLoadingState` setting. */
+  useLoadingState?: boolean;
+  /** Maximum seconds to show loading for this trigger. Set to nil to use the global `loadingBudget` setting. */
+  loadingBudget?: number;
+};
+
+export type HeliumPaywallLoadingConfig = {
+  /**
+   * Whether to show a loading state while fetching paywall configuration.
+   * When true, shows a loading view for up to `loadingBudget` seconds before falling back.
+   * Default: true
+   */
+  useLoadingState?: boolean;
+  /**
+   * Maximum time (in seconds) to show the loading state before displaying fallback.
+   * After this timeout, the fallback view will be shown even if the paywall is still downloading.
+   * Default: 2.0 seconds
+   */
+  loadingBudget?: number;
+  /**
+   * Optional per-trigger loading configuration overrides.
+   * Use this to customize loading behavior for specific triggers.
+   * Keys are trigger names, values are TriggerLoadingConfig instances.
+   * Example: Disable loading for "onboarding" trigger while keeping it for others.
+   */
+  perTriggerLoadingConfig?: Record<string, TriggerLoadingConfig>;
+};
+
 export interface HeliumConfig {
   /** Your Helium API Key */
   apiKey: string;
   /** Configuration for handling purchases. Can be custom functions or a pre-built handler config. */
-  purchaseConfig: HeliumPurchaseConfig;
+  purchaseConfig?: HeliumPurchaseConfig;
   /** Callback for receiving all Helium paywall events. */
   onHeliumPaywallEvent: (event: HeliumPaywallEvent) => void; // Still mandatory
 
   // Optional configurations
+  /** Fallback bundle in the rare situation that paywall is not ready to be shown. Highly recommended. See docs at https://docs.tryhelium.com/guides/fallback-bundle#react-native */
   fallbackBundle?: object;
-  triggers?: string[];
+  /** Configure loading behavior for paywalls that are mid-download. */
+  paywallLoadingConfig?: HeliumPaywallLoadingConfig;
   customUserId?: string;
   customAPIEndpoint?: string;
   customUserTraits?: Record<string, any>;
@@ -90,13 +145,62 @@ export interface NativeHeliumConfig {
   revenueCatAppUserId?: string;
   fallbackBundleUrlString?: string;
   fallbackBundleString?: string;
+  paywallLoadingConfig?: HeliumPaywallLoadingConfig;
+  useDefaultDelegate?: boolean;
 }
 
+export type PresentUpsellParams = {
+  triggerName: string;
+  /** Optional. This will be called when paywall fails to show due to an unsuccessful paywall download or if an invalid trigger is provided. */
+  onFallback?: () => void;
+  eventHandlers?: PaywallEventHandlers;
+  customPaywallTraits?: Record<string, any>;
+};
+
 export interface PaywallInfo {
   paywallTemplateName: string;
   shouldShow: boolean;
 }
 
+// Event handler types for per-presentation event handling
+export interface PaywallEventHandlers {
+  onOpen?: (event: PaywallOpenEvent) => void;
+  onClose?: (event: PaywallCloseEvent) => void;
+  onDismissed?: (event: PaywallDismissedEvent) => void;
+  onPurchaseSucceeded?: (event: PurchaseSucceededEvent) => void;
+}
+
+// Typed event interfaces
+export interface PaywallOpenEvent {
+  type: 'paywallOpen';
+  triggerName: string;
+  paywallName: string;
+  isSecondTry: boolean;
+  viewType?: 'presented' | 'embedded' | 'triggered';
+}
+
+export interface PaywallCloseEvent {
+  type: 'paywallClose';
+  triggerName: string;
+  paywallName: string;
+  isSecondTry: boolean;
+}
+
+export interface PaywallDismissedEvent {
+  type: 'paywallDismissed';
+  triggerName: string;
+  paywallName: string;
+  isSecondTry: boolean;
+}
+
+export interface PurchaseSucceededEvent {
+  type: 'purchaseSucceeded';
+  productId: string;
+  triggerName: string;
+  paywallName: string;
+  isSecondTry: boolean;
+}
+
 export const HELIUM_CTA_NAMES = {
   SCHEDULE_CALL: 'schedule_call',
   SUBSCRIBE_BUTTON: 'subscribe_button',

package/src/HeliumPaywallSdkModule.ts

@@ -21,7 +21,10 @@ interface CanPresentUpsellResult {
 declare class HeliumPaywallSdkModule extends NativeModule<HeliumPaywallSdkModuleEvents> {
   initialize(config: NativeHeliumConfig): void;
 
-  presentUpsell(triggerName: string): void;
+  presentUpsell(
+    triggerName: string,
+    customPaywallTraits?: Record<string, any>,
+  ): void;
 
   hideUpsell(): void;
 
@@ -47,6 +50,8 @@ declare class HeliumPaywallSdkModule extends NativeModule<HeliumPaywallSdkModule
   getPaywallInfo(trigger: string): PaywallInfoResult;
 
   handleDeepLink(urlString: string): boolean;
+
+  setRevenueCatAppUserId(rcAppUserId: string): void;
 }
 
 // This call loads the native module object from the JSI.