expo-helium 0.8.0

package/build/revenuecat/revenuecat.js

@@ -0,0 +1,126 @@
+import Purchases, { PURCHASES_ERROR_CODE } from 'react-native-purchases';
+// Rename the factory function
+export function createRevenueCatPurchaseConfig(config) {
+    const rcHandler = new RevenueCatHeliumHandler(config?.apiKey);
+    return {
+        apiKey: config?.apiKey,
+        makePurchase: rcHandler.makePurchase.bind(rcHandler),
+        restorePurchases: rcHandler.restorePurchases.bind(rcHandler),
+    };
+}
+export class RevenueCatHeliumHandler {
+    productIdToPackageMapping = {};
+    isMappingInitialized = false;
+    initializationPromise = null;
+    constructor(apiKey) {
+        if (apiKey) {
+            Purchases.configure({ apiKey });
+        }
+        else {
+        }
+        this.initializePackageMapping();
+    }
+    async initializePackageMapping() {
+        if (this.initializationPromise) {
+            return this.initializationPromise;
+        }
+        this.initializationPromise = (async () => {
+            try {
+                const offerings = await Purchases.getOfferings();
+                if (offerings.current?.availablePackages) {
+                    offerings.current.availablePackages.forEach((pkg) => {
+                        if (pkg.product?.identifier) {
+                            this.productIdToPackageMapping[pkg.product.identifier] = pkg;
+                        }
+                    });
+                }
+                else {
+                }
+                this.isMappingInitialized = true;
+            }
+            catch (error) {
+                this.isMappingInitialized = false;
+            }
+            finally {
+                this.initializationPromise = null;
+            }
+        })();
+        return this.initializationPromise;
+    }
+    async ensureMappingInitialized() {
+        if (!this.isMappingInitialized && !this.initializationPromise) {
+            await this.initializePackageMapping();
+        }
+        else if (this.initializationPromise) {
+            await this.initializationPromise;
+        }
+    }
+    async makePurchase(productId) {
+        await this.ensureMappingInitialized();
+        const pkg = this.productIdToPackageMapping[productId];
+        if (!pkg) {
+            return { status: 'failed', error: `RevenueCat Package not found for ID: ${productId}` };
+        }
+        try {
+            const { customerInfo } = await Purchases.purchasePackage(pkg);
+            const isActive = this.isProductActive(customerInfo, productId);
+            if (isActive) {
+                return { status: 'purchased' };
+            }
+            else {
+                // This case might occur if the purchase succeeded but the entitlement wasn't immediately active
+                // or if a different product became active.
+                // Consider if polling/listening might be needed here too, similar to pending.
+                // For now, returning failed as the specific product isn't confirmed active.
+                return { status: 'failed', error: 'Purchase possibly complete but entitlement/subscription not active for this product.' };
+            }
+        }
+        catch (error) {
+            const purchasesError = error;
+            if (purchasesError?.code === PURCHASES_ERROR_CODE.PAYMENT_PENDING_ERROR) {
+                // Wait for a terminal state for up to 5 seconds
+                return new Promise((resolve) => {
+                    // Define the listener function separately to remove it later
+                    const updateListener = (updatedCustomerInfo) => {
+                        const isActive = this.isProductActive(updatedCustomerInfo, productId);
+                        if (isActive) {
+                            clearTimeout(timeoutId);
+                            // Remove listener using the function reference
+                            Purchases.removeCustomerInfoUpdateListener(updateListener);
+                            resolve({ status: 'purchased' });
+                        }
+                    };
+                    const timeoutId = setTimeout(() => {
+                        // Remove listener using the function reference on timeout
+                        Purchases.removeCustomerInfoUpdateListener(updateListener);
+                        resolve({ status: 'pending' });
+                    }, 5000);
+                    // Add the listener
+                    Purchases.addCustomerInfoUpdateListener(updateListener);
+                });
+            }
+            if (purchasesError?.code === PURCHASES_ERROR_CODE.PURCHASE_CANCELLED_ERROR) {
+                return { status: 'cancelled' };
+            }
+            // Handle other errors
+            return { status: 'failed', error: purchasesError?.message || 'RevenueCat purchase failed.' };
+        }
+    }
+    // Helper function to check if a product is active in CustomerInfo
+    isProductActive(customerInfo, productId) {
+        return Object.values(customerInfo.entitlements.active).some((entitlement) => entitlement.productIdentifier === productId)
+            || customerInfo.activeSubscriptions.includes(productId)
+            || customerInfo.allPurchasedProductIdentifiers.includes(productId);
+    }
+    async restorePurchases() {
+        try {
+            const customerInfo = await Purchases.restorePurchases();
+            const isActive = Object.keys(customerInfo.entitlements.active).length > 0;
+            return isActive;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=revenuecat.js.map

package/build/revenuecat/revenuecat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"revenuecat.js","sourceRoot":"","sources":["../../src/revenuecat/revenuecat.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,EAAE,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAIzE,8BAA8B;AAC9B,MAAM,UAAU,8BAA8B,CAAC,MAE9C;IACG,MAAM,SAAS,GAAG,IAAI,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9D,OAAO;QACL,MAAM,EAAE,MAAM,EAAE,MAAM;QACtB,YAAY,EAAE,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC;QACpD,gBAAgB,EAAE,SAAS,CAAC,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC;KAC7D,CAAC;AACN,CAAC;AAED,MAAM,OAAO,uBAAuB;IACxB,yBAAyB,GAAqC,EAAE,CAAC;IACjE,oBAAoB,GAAY,KAAK,CAAC;IACtC,qBAAqB,GAAyB,IAAI,CAAC;IAE3D,YAAY,MAAe;QACvB,IAAI,MAAM,EAAE,CAAC;YACT,SAAS,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QACpC,CAAC;aAAM,CAAC;QACR,CAAC;QACD,IAAI,CAAC,wBAAwB,EAAE,CAAC;IACpC,CAAC;IAEO,KAAK,CAAC,wBAAwB;QAClC,IAAI,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC,qBAAqB,CAAC;QACtC,CAAC;QACD,IAAI,CAAC,qBAAqB,GAAG,CAAC,KAAK,IAAI,EAAE;YACrC,IAAI,CAAC;gBACD,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,YAAY,EAAE,CAAC;gBACjD,IAAI,SAAS,CAAC,OAAO,EAAE,iBAAiB,EAAE,CAAC;oBACvC,SAAS,CAAC,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,GAAqB,EAAE,EAAE;wBAClE,IAAI,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC;4BAC1B,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC;wBACjE,CAAC;oBACL,CAAC,CAAC,CAAC;gBACP,CAAC;qBAAM,CAAC;gBACR,CAAC;gBACD,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC;YACrC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,IAAI,CAAC,oBAAoB,GAAG,KAAK,CAAC;YACtC,CAAC;oBAAS,CAAC;gBACN,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC;YACvC,CAAC;QACL,CAAC,CAAC,EAAE,CAAC;QACJ,OAAO,IAAI,CAAC,qBAAqB,CAAC;IACvC,CAAC;IAEO,KAAK,CAAC,wBAAwB;QAClC,IAAI,CAAC,IAAI,CAAC,oBAAoB,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,CAAC;YAC5D,MAAM,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAC1C,CAAC;aAAM,IAAI,IAAI,CAAC,qBAAqB,EAAE,CAAC;YACpC,MAAM,IAAI,CAAC,qBAAqB,CAAC;QACrC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,SAAiB;QAChC,MAAM,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAEtC,MAAM,GAAG,GAAiC,IAAI,CAAC,yBAAyB,CAAC,SAAS,CAAC,CAAC;QACpF,IAAI,CAAC,GAAG,EAAE,CAAC;YACP,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,wCAAwC,SAAS,EAAE,EAAE,CAAC;QAC5F,CAAC;QAED,IAAI,CAAC;YACD,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,SAAS,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;YAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;YAC/D,IAAI,QAAQ,EAAE,CAAC;gBACX,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;YACnC,CAAC;iBAAM,CAAC;gBACJ,gGAAgG;gBAChG,2CAA2C;gBAC3C,8EAA8E;gBAC9E,4EAA4E;gBAC5E,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,sFAAsF,EAAE,CAAC;YAC/H,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,cAAc,GAAG,KAAuB,CAAC;YAE/C,IAAI,cAAc,EAAE,IAAI,KAAK,oBAAoB,CAAC,qBAAqB,EAAE,CAAC;gBACtE,gDAAgD;gBAChD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;oBAC3B,6DAA6D;oBAC7D,MAAM,cAAc,GAA+B,CAAC,mBAAiC,EAAE,EAAE;wBACrF,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,mBAAmB,EAAE,SAAS,CAAC,CAAC;wBACtE,IAAI,QAAQ,EAAE,CAAC;4BACX,YAAY,CAAC,SAAS,CAAC,CAAC;4BACxB,+CAA+C;4BAC/C,SAAS,CAAC,gCAAgC,CAAC,cAAc,CAAC,CAAC;4BAC3D,OAAO,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;wBACrC,CAAC;oBACL,CAAC,CAAC;oBAEF,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;wBAC7B,0DAA0D;wBAC3D,SAAS,CAAC,gCAAgC,CAAC,cAAc,CAAC,CAAC;wBAC3D,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;oBACnC,CAAC,EAAE,IAAI,CAAC,CAAC;oBAET,mBAAmB;oBACnB,SAAS,CAAC,6BAA6B,CAAC,cAAc,CAAC,CAAC;gBAC5D,CAAC,CAAC,CAAC;YACP,CAAC;YAED,IAAI,cAAc,EAAE,IAAI,KAAK,oBAAoB,CAAC,wBAAwB,EAAE,CAAC;gBACzE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;YACnC,CAAC;YAED,sBAAsB;YACtB,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,cAAc,EAAE,OAAO,IAAI,6BAA6B,EAAE,CAAC;QACjG,CAAC;IACL,CAAC;IAED,kEAAkE;IAC1D,eAAe,CAAC,YAA0B,EAAE,SAAiB;QACjE,OAAO,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,WAAqC,EAAE,EAAE,CAAC,WAAW,CAAC,iBAAiB,KAAK,SAAS,CAAC;eACzI,YAAY,CAAC,mBAAmB,CAAC,QAAQ,CAAC,SAAS,CAAC;eACpD,YAAY,CAAC,8BAA8B,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC9E,CAAC;IAED,KAAK,CAAC,gBAAgB;QAClB,IAAI,CAAC;YACD,MAAM,YAAY,GAAG,MAAM,SAAS,CAAC,gBAAgB,EAAE,CAAC;YACxD,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;YAC1E,OAAO,QAAQ,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;CACJ","sourcesContent":["import Purchases, { PURCHASES_ERROR_CODE } 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    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                if (offerings.current?.availablePackages) {\n                    offerings.current.availablePackages.forEach((pkg: PurchasesPackage) => {\n                        if (pkg.product?.identifier) {\n                            this.productIdToPackageMapping[pkg.product.identifier] = pkg;\n                        }\n                    });\n                } else {\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        if (!pkg) {\n            return { status: 'failed', error: `RevenueCat Package not found for ID: ${productId}` };\n        }\n\n        try {\n            const { customerInfo } = await Purchases.purchasePackage(pkg);\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/expo-module.config.json

@@ -0,0 +1,9 @@
+{
+  "platforms": ["apple", "android", "web"],
+  "apple": {
+    "modules": ["HeliumPaywallSdkModule"]
+  },
+  "android": {
+    "modules": ["expo.modules.paywallsdk.HeliumPaywallSdkModule"]
+  }
+}

package/ios/HeliumPaywallSdk.podspec

@@ -0,0 +1,30 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, '..', 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name           = 'HeliumPaywallSdk'
+  s.version        = package['version']
+  s.summary        = package['description']
+  s.description    = package['description']
+  s.license        = package['license']
+  s.author         = package['author']
+  s.homepage       = package['homepage']
+  s.platforms      = {
+    :ios => '15.1',
+    :tvos => '15.1'
+  }
+  s.swift_version  = '5.4'
+  s.source         = { git: 'https://github.com/salami/expo-paywall-sdk' }
+  s.static_framework = true
+
+  s.dependency 'ExpoModulesCore'
+  s.dependency 'Helium', '2.0.11'
+
+  # Swift/Objective-C compatibility
+  s.pod_target_xcconfig = {
+    'DEFINES_MODULE' => 'YES',
+  }
+
+  s.source_files = "**/*.{h,m,mm,swift,hpp,cpp}"
+end

package/ios/HeliumPaywallSdkModule.swift

@@ -0,0 +1,249 @@
+import ExpoModulesCore
+import Helium
+import SwiftUI
+
+// Define purchase error enum
+enum PurchaseError: LocalizedError {
+    case unknownStatus(status: String)
+    case purchaseFailed(errorMsg: String)
+
+    var errorDescription: String? {
+        switch self {
+        case let .unknownStatus(status):
+            return "Purchased not successful due to unknown status - \(status)."
+        case let .purchaseFailed(errorMsg):
+            return errorMsg
+        }
+    }
+}
+
+public class HeliumPaywallSdkModule: Module {
+  // Single continuations for ongoing operations
+  private var currentProductId: String? = nil
+  private var purchaseContinuation: CheckedContinuation<HeliumPaywallTransactionStatus, Never>? = nil
+  private var restoreContinuation: CheckedContinuation<Bool, Never>? = nil
+
+  // Each module class must implement the definition function. The definition consists of components
+  // that describes the module's functionality and behavior.
+  // See https://docs.expo.dev/modules/module-api for more details about available components.
+  public func definition() -> ModuleDefinition {
+    // Sets the name of the module that JavaScript code will use to refer to the module. Takes a string as an argument.
+    // Can be inferred from module's class name, but it's recommended to set it explicitly for clarity.
+    // The module will be accessible from `requireNativeModule('HeliumPaywallSdk')` in JavaScript.
+    Name("HeliumPaywallSdk")
+
+    // Sets constant properties on the module. Can take a dictionary or a closure that returns a dictionary.
+//     Constants([
+//       "PI": Double.pi
+//     ])
+
+    // Defines event names that the module can send to JavaScript.
+    Events("onHeliumPaywallEvent")
+
+    Events("onDelegateActionEvent")
+
+    // 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]
+
+      // Create delegate with closures that send events to JavaScript
+      let delegate = InternalDelegate(
+        eventHandler: { [weak self] event in
+          self?.sendEvent("onHeliumPaywallEvent", event.toDictionary())
+        },
+        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
+          if let existingContinuation = self.purchaseContinuation {
+            existingContinuation.resume(returning: .cancelled)
+            self.purchaseContinuation = nil
+            self.currentProductId = nil
+          }
+
+          return await withCheckedContinuation { continuation in
+            // Store the continuation and product ID
+            self.currentProductId = productId
+            self.purchaseContinuation = continuation
+
+            // Send event to JavaScript
+            self.sendEvent("onDelegateActionEvent", [
+              "type": "purchase",
+              "productId": productId
+            ])
+          }
+        },
+        restoreHandler: { [weak self] in
+          guard let self else { return false }
+          // Check if there's already a restore in progress and cancel it
+          if let existingContinuation = self.restoreContinuation {
+            existingContinuation.resume(returning: false)
+            self.restoreContinuation = nil
+          }
+
+          return await withCheckedContinuation { continuation in
+            // Store the continuation
+            self.restoreContinuation = continuation
+
+            // Send event to JavaScript
+            self.sendEvent("onDelegateActionEvent", [
+              "type": "restore"
+            ])
+          }
+        }
+      )
+
+      Helium.shared.initialize(
+        apiKey: config["apiKey"] as? String ?? "",
+        heliumPaywallDelegate: delegate,
+        fallbackPaywall: FallbackView(),
+        customUserId: config["customUserId"] as? String,
+        customAPIEndpoint: config["customAPIEndpoint"] as? String,
+        customUserTraits: userTraitsMap != nil ? HeliumUserTraits(userTraitsMap!) : nil,
+        revenueCatAppUserId: config["revenueCatAppUserId"] as? String
+      )
+    }
+
+    // Function for JavaScript to provide purchase result
+    Function("handlePurchaseResult") { [weak self] (statusString: String, errorMsg: String?) in
+      guard let continuation = self?.purchaseContinuation else {
+        return
+      }
+
+      // Parse status string
+      let lowercasedStatus = statusString.lowercased()
+      let status: HeliumPaywallTransactionStatus
+
+      switch lowercasedStatus {
+      case "purchased": status = .purchased
+      case "cancelled": status = .cancelled
+      case "restored":  status = .restored
+      case "pending":   status = .pending
+      case "failed":    status = .failed(PurchaseError.purchaseFailed(errorMsg: errorMsg ?? "Unexpected error."))
+      default:          status = .failed(PurchaseError.unknownStatus(status: lowercasedStatus))
+      }
+
+      // Clear the references
+      self?.purchaseContinuation = nil
+      self?.currentProductId = nil
+
+      // Resume the continuation with the status
+      continuation.resume(returning: status)
+    }
+
+    // Function for JavaScript to provide restore result
+    Function("handleRestoreResult") { [weak self] (success: Bool) in
+      guard let continuation = self?.restoreContinuation else {
+        return
+      }
+
+      self?.restoreContinuation = nil
+      continuation.resume(returning: success)
+    }
+
+    Function("presentUpsell") { (trigger: String) in
+      Helium.shared.presentUpsell(trigger: trigger);
+    }
+
+    Function("hideUpsell") {
+      let _ = Helium.shared.hideUpsell();
+    }
+
+    Function("hideAllUpsells") {
+      Helium.shared.hideAllUpsells();
+    }
+
+    Function("getDownloadStatus") {
+      return Helium.shared.getDownloadStatus().rawValue;
+    }
+
+    Function("fallbackOpenOrCloseEvent") { (trigger: String?, isOpen: Bool, viewType: String?) in
+      HeliumPaywallDelegateWrapper.shared.onFallbackOpenCloseEvent(trigger: trigger, isOpen: isOpen, viewType: viewType)
+    }
+
+    // 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) {
+      // Defines a setter for the `url` prop.
+      Prop("url") { (view: HeliumPaywallSdkView, url: URL) in
+        if view.webView.url != url {
+          view.webView.load(URLRequest(url: url))
+        }
+      }
+
+      Events("onLoad")
+    }
+  }
+}
+
+fileprivate class InternalDelegate: HeliumPaywallDelegate {
+    private let eventHandler: (HeliumPaywallEvent) -> Void
+    private let purchaseHandler: (String) async -> HeliumPaywallTransactionStatus
+    private let restoreHandler: () async -> Bool
+
+    init(
+        eventHandler: @escaping (HeliumPaywallEvent) -> Void,
+        purchaseHandler: @escaping (String) async -> HeliumPaywallTransactionStatus,
+        restoreHandler: @escaping () async -> Bool
+    ) {
+        self.eventHandler = eventHandler
+        self.purchaseHandler = purchaseHandler
+        self.restoreHandler = restoreHandler
+    }
+
+    public func makePurchase(productId: String) async -> HeliumPaywallTransactionStatus {
+        return await purchaseHandler(productId)
+    }
+
+    public func restorePurchases() async -> Bool {
+        return await restoreHandler()
+    }
+
+    public func onHeliumPaywallEvent(event: HeliumPaywallEvent) {
+        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")
+                .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()
+    }
+}

package/ios/HeliumPaywallSdkView.swift

@@ -0,0 +1,38 @@
+import ExpoModulesCore
+import WebKit
+
+// This view will be used as a native component. Make sure to inherit from `ExpoView`
+// to apply the proper styling (e.g. border radius and shadows).
+class HeliumPaywallSdkView: ExpoView {
+  let webView = WKWebView()
+  let onLoad = EventDispatcher()
+  var delegate: WebViewDelegate?
+
+  required init(appContext: AppContext? = nil) {
+    super.init(appContext: appContext)
+    clipsToBounds = true
+    delegate = WebViewDelegate { url in
+      self.onLoad(["url": url])
+    }
+    webView.navigationDelegate = delegate
+    addSubview(webView)
+  }
+
+  override func layoutSubviews() {
+    webView.frame = bounds
+  }
+}
+
+class WebViewDelegate: NSObject, WKNavigationDelegate {
+  let onUrlChange: (String) -> Void
+
+  init(onUrlChange: @escaping (String) -> Void) {
+    self.onUrlChange = onUrlChange
+  }
+
+  func webView(_ webView: WKWebView, didFinish navigation: WKNavigation) {
+    if let url = webView.url {
+      onUrlChange(url.absoluteString)
+    }
+  }
+}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "expo-helium",
+  "version": "0.8.0",
+  "description": "Helium paywalls expo sdk",
+  "main": "build/index.js",
+  "types": "build/index.d.ts",
+  "scripts": {
+    "build": "expo-module build",
+    "clean": "expo-module clean",
+    "lint": "expo-module lint",
+    "test": "expo-module test",
+    "prepare": "expo-module prepare",
+    "prepublishOnly": "expo-module prepublishOnly",
+    "expo-module": "expo-module",
+    "open:ios": "xed example/ios",
+    "open:android": "open -a \"Android Studio\" example/android"
+  },
+  "keywords": [
+    "react-native",
+    "expo",
+    "expo-helium",
+    "helium-expo-sdk",
+    "expo-helium-sdk",
+    "HeliumPaywallSdk"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cloudcaptainai/helium-expo-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/cloudcaptainai/helium-expo-sdk/issues"
+  },
+  "author": "Anish Doshi <anish@tryhelium.com> (https://tryhelium.com)",
+  "license": "MIT",
+  "homepage": "https://github.com/cloudcaptainai/helium-expo-sdk/#readme",
+  "dependencies": {},
+  "devDependencies": {
+    "@types/react": "~19.0.0",
+    "expo-module-scripts": "^4.1.9",
+    "expo": "~53.0.0",
+    "react-native": "0.79.1",
+    "react-native-purchases": ">=5.1.0"
+  },
+  "peerDependencies": {
+    "expo": "*",
+    "react": "*",
+    "react-native": "*",
+    "react-native-purchases": ">=5.1.0"
+  },
+  "peerDependenciesMeta": {
+    "react-native-purchases": {
+      "optional": true
+    }
+  }
+}

package/src/HeliumPaywallSdk.types.ts

@@ -0,0 +1,95 @@
+import type { StyleProp, ViewStyle } from 'react-native';
+
+export type OnLoadEventPayload = {
+  url: string;
+};
+
+export type HeliumPaywallSdkModuleEvents = {
+  onHeliumPaywallEvent: (params: HeliumPaywallEvent) => void;
+  onDelegateActionEvent: (params: DelegateActionEvent) => void;
+};
+export type HeliumPaywallEvent = {
+  type: string;
+  triggerName?: string;
+  paywallTemplateName?: string;
+  productKey?: string;
+  ctaName?: string;
+  configId?: string;
+  numAttempts?: number;
+  downloadTimeTakenMS?: number;
+  webviewRenderTimeTakenMS?: number;
+  imagesDownloadTimeTakenMS?: number;
+  fontsDownloadTimeTakenMS?: number;
+  bundleDownloadTimeMS?: number;
+  dismissAll?: boolean;
+  errorDescription?: string;
+};
+export type DelegateActionEvent = {
+  type: 'purchase' | 'restore';
+  productId?: string;
+};
+
+export type HeliumPaywallSdkViewProps = {
+  url: string;
+  onLoad: (event: { nativeEvent: OnLoadEventPayload }) => void;
+  style?: StyleProp<ViewStyle>;
+};
+
+export type HeliumTransactionStatus = 'purchased' | 'failed' | 'cancelled' | 'pending' | 'restored';
+export type HeliumPurchaseResult = {
+  status: HeliumTransactionStatus;
+  error?: string; // Optional error message
+};
+export type HeliumDownloadStatus = 'downloadSuccess' | 'downloadFailure' | 'inProgress' | 'notDownloadedYet';
+
+// --- Purchase Configuration Types ---
+
+/** Interface for providing custom purchase handling logic. */
+
+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
+export function createCustomPurchaseConfig(callbacks: {
+  makePurchase: (productId: string) => Promise<HeliumPurchaseResult>;
+  restorePurchases: () => Promise<boolean>;
+}): HeliumPurchaseConfig {
+  return {
+    makePurchase: callbacks.makePurchase,
+    restorePurchases: callbacks.restorePurchases,
+  };
+}
+
+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;
+  /** Callback for receiving all Helium paywall events. */
+  onHeliumPaywallEvent: (event: HeliumPaywallEvent) => void; // Still mandatory
+
+  // Optional configurations
+  triggers?: string[];
+  customUserId?: string;
+  customAPIEndpoint?: string;
+  customUserTraits?: Record<string, any>;
+  revenueCatAppUserId?: string;
+}
+
+export interface NativeHeliumConfig {
+  apiKey: string;
+  customUserId?: string;
+  customAPIEndpoint?: string;
+  customUserTraits?: Record<string, any>;
+  revenueCatAppUserId?: string;
+}
+
+export const HELIUM_CTA_NAMES = {
+  SCHEDULE_CALL: 'schedule_call',
+  SUBSCRIBE_BUTTON: 'subscribe_button',
+}

package/src/HeliumPaywallSdkModule.ts

@@ -0,0 +1,36 @@
+import { NativeModule, requireNativeModule } from "expo";
+
+import {
+  HeliumDownloadStatus,
+  HeliumPaywallSdkModuleEvents,
+  HeliumTransactionStatus,
+  NativeHeliumConfig,
+} from "./HeliumPaywallSdk.types";
+
+declare class HeliumPaywallSdkModule extends NativeModule<HeliumPaywallSdkModuleEvents> {
+  initialize(config: NativeHeliumConfig): void;
+
+  presentUpsell(triggerName: string): void;
+
+  hideUpsell(): void;
+
+  hideAllUpsells(): void;
+
+  getDownloadStatus(): HeliumDownloadStatus;
+
+  fallbackOpenOrCloseEvent(
+    trigger: string,
+    isOpen: boolean,
+    viewType: string,
+  ): void;
+
+  handlePurchaseResult(
+    statusString: HeliumTransactionStatus,
+    errorMsg?: string,
+  ): void;
+
+  handleRestoreResult(success: boolean): void;
+}
+
+// This call loads the native module object from the JSI.
+export default requireNativeModule<HeliumPaywallSdkModule>("HeliumPaywallSdk");

package/src/HeliumPaywallSdkView.tsx

@@ -0,0 +1,11 @@
+import { requireNativeView } from 'expo';
+import * as React from 'react';
+
+import { HeliumPaywallSdkViewProps } from './HeliumPaywallSdk.types';
+
+const NativeView: React.ComponentType<HeliumPaywallSdkViewProps> =
+  requireNativeView('HeliumPaywallSdk');
+
+export default function HeliumPaywallSdkView(props: HeliumPaywallSdkViewProps) {
+  return <NativeView {...props} />;
+}