framepayments-react-native 1.0.0 → 1.0.1

package/android/build.gradle

@@ -5,7 +5,7 @@ buildscript {
   }
   dependencies {
     classpath 'com.android.tools.build:gradle:8.1.0'
-    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:1.9.0"
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:2.1.0"
   }
 }
 
@@ -40,7 +40,11 @@ repositories {
 
 dependencies {
   implementation 'com.facebook.react:react-native:+'
-  implementation "org.jetbrains.kotlin:kotlin-stdlib:1.9.0"
+  implementation "org.jetbrains.kotlin:kotlin-stdlib:2.1.0"
   implementation 'com.framepayments:framesdk:1.2.0'
   implementation 'com.framepayments:framesdk_ui:1.2.0'
+  implementation 'com.google.code.gson:gson:2.10.1'
+  implementation 'androidx.constraintlayout:constraintlayout:2.1.4'
+  // Frame SDK UI uses Compose; LocalLifecycleOwner requires lifecycle-runtime-compose 2.8+
+  implementation 'androidx.lifecycle:lifecycle-runtime-compose:2.8.2'
 }

package/android/src/main/AndroidManifest.xml

@@ -1,4 +1,5 @@
-<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="com.framepayments.reactnativeframe">
   <application>
     <activity
       android:name="com.framepayments.reactnativeframe.FrameCheckoutActivity"

package/android/src/main/java/com/framepayments/reactnativeframe/FrameCheckoutActivity.kt

@@ -2,6 +2,8 @@ package com.framepayments.reactnativeframe
 
 import android.content.Intent
 import android.os.Bundle
+import android.os.Handler
+import android.os.Looper
 import android.widget.FrameLayout
 import androidx.appcompat.app.AppCompatActivity
 import com.framepayments.framesdk.FrameNetworking
@@ -11,6 +13,9 @@ import com.google.gson.Gson
 
 class FrameCheckoutActivity : AppCompatActivity() {
 
+  private val handler = Handler(Looper.getMainLooper())
+  private var pollRunnable: Runnable? = null
+
   override fun onCreate(savedInstanceState: Bundle?) {
     super.onCreate(savedInstanceState)
     val container = FrameLayout(this).apply {
@@ -22,6 +27,40 @@ class FrameCheckoutActivity : AppCompatActivity() {
     setContentView(container)
     val customerId = intent.getStringExtra(EXTRA_CUSTOMER_ID)
     val amount = intent.getIntExtra(EXTRA_AMOUNT, 0)
+
+    // Evervault must be configured before FrameCheckoutView (EncryptedPaymentCardInput) can inflate.
+    // configureEvervault() is async on first launch; direct checkout opens before it completes.
+    tryShowCheckout(container, customerId, amount)
+  }
+
+  private fun tryShowCheckout(container: FrameLayout, customerId: String?, amount: Int) {
+    if (FrameNetworking.isEvervaultConfigured) {
+      addCheckoutView(container, customerId, amount)
+      return
+    }
+    var attempts = 0
+    val maxAttempts = 50 // 5 seconds
+    pollRunnable = object : Runnable {
+      override fun run() {
+        if (isFinishing) return
+        if (FrameNetworking.isEvervaultConfigured) {
+          addCheckoutView(container, customerId, amount)
+          pollRunnable = null
+          return
+        }
+        attempts++
+        if (attempts >= maxAttempts) {
+          setResult(RESULT_CANCELED)
+          finish()
+          return
+        }
+        handler.postDelayed(this, 100)
+      }
+    }
+    handler.postDelayed(pollRunnable!!, 100)
+  }
+
+  private fun addCheckoutView(container: FrameLayout, customerId: String?, amount: Int) {
     val checkoutView = FrameCheckoutView(this)
     checkoutView.configure(customerId, amount) { chargeIntent ->
       val json = Gson().toJson(chargeIntent)
@@ -31,6 +70,11 @@ class FrameCheckoutActivity : AppCompatActivity() {
     container.addView(checkoutView)
   }
 
+  override fun onDestroy() {
+    pollRunnable?.let { handler.removeCallbacks(it) }
+    super.onDestroy()
+  }
+
   companion object {
     const val EXTRA_CUSTOMER_ID = "customer_id"
     const val EXTRA_AMOUNT = "amount"

package/android/src/main/java/com/framepayments/reactnativeframe/FrameSDKModule.kt

@@ -43,11 +43,13 @@ class FrameSDKModule(reactContext: ReactApplicationContext) :
       return
     }
     checkoutPromise = promise
-    val intent = Intent(activity, FrameCheckoutActivity::class.java).apply {
-      putExtra(FrameCheckoutActivity.EXTRA_CUSTOMER_ID, customerId)
-      putExtra(FrameCheckoutActivity.EXTRA_AMOUNT, amount.toInt())
+    activity.runOnUiThread {
+      val intent = Intent(activity, FrameCheckoutActivity::class.java).apply {
+        putExtra(FrameCheckoutActivity.EXTRA_CUSTOMER_ID, customerId)
+        putExtra(FrameCheckoutActivity.EXTRA_AMOUNT, amount.toInt())
+      }
+      activity.startActivityForResult(intent, FrameCheckoutActivity.REQUEST_CODE)
     }
-    activity.startActivityForResult(intent, FrameCheckoutActivity.REQUEST_CODE)
   }
 
   @ReactMethod
@@ -66,12 +68,14 @@ class FrameSDKModule(reactContext: ReactApplicationContext) :
       return
     }
     cartPromise = promise
-    val intent = Intent(activity, FrameFlowActivity::class.java).apply {
-      putExtra(FrameFlowActivity.EXTRA_CUSTOMER_ID, customerId)
-      putExtra(FrameFlowActivity.EXTRA_ITEMS_JSON, itemsJson)
-      putExtra(FrameFlowActivity.EXTRA_SHIPPING_CENTS, shippingAmountInCents.toInt())
+    activity.runOnUiThread {
+      val intent = Intent(activity, FrameFlowActivity::class.java).apply {
+        putExtra(FrameFlowActivity.EXTRA_CUSTOMER_ID, customerId)
+        putExtra(FrameFlowActivity.EXTRA_ITEMS_JSON, itemsJson)
+        putExtra(FrameFlowActivity.EXTRA_SHIPPING_CENTS, shippingAmountInCents.toInt())
+      }
+      activity.startActivityForResult(intent, FrameFlowActivity.REQUEST_CODE)
     }
-    activity.startActivityForResult(intent, FrameFlowActivity.REQUEST_CODE)
   }
 
   private fun readableArrayToJson(items: com.facebook.react.bridge.ReadableArray): String? {
@@ -82,7 +86,7 @@ class FrameSDKModule(reactContext: ReactApplicationContext) :
       obj.put("id", item.getString("id"))
       obj.put("title", item.getString("title"))
       obj.put("amountInCents", item.getDouble("amountInCents").toInt())
-      obj.put("imageUrl", item.getString("imageUrl"))
+      obj.put("imageUrl", item.getString("imageUrl") ?: "")
       arr.put(obj)
     }
     return arr.toString()

package/ios/FramePreloader.swift

@@ -0,0 +1,28 @@
+//
+//  FramePreloader.swift
+//  FrameReactNative
+//
+//  Preloads the Frame module on the main thread BEFORE the React Native bridge
+//  initializes. This avoids "Helpers are not supported by the default hub" crash
+//  that occurs when Frame/Evervault/Sift load on a background thread during
+//  bridge module discovery.
+//
+
+import Foundation
+import Frame
+
+@objc(FramePreloader)
+public final class FramePreloader: NSObject {
+
+    /// Call from AppDelegate before [super application:didFinishLaunchingWithOptions].
+    /// Forces Frame (and its deps: Evervault, Sift) to load on main thread.
+    @objc public static func preloadOnMainThread() {
+        guard Thread.isMainThread else {
+            DispatchQueue.main.sync { preloadOnMainThread() }
+            return
+        }
+        // Touch FrameNetworking to trigger Frame module load on main thread.
+        // Evervault/Sift config is deferred to initializeWithAPIKey.
+        _ = FrameNetworking.shared
+    }
+}

package/ios/FrameSDKBridge.m

@@ -2,10 +2,28 @@
 //  FrameSDKBridge.m
 //  FrameReactNative
 //
+//  ObjC adapter that forwards to Swift FrameSDKBridge.
+//
 
 #import <React/RCTBridgeModule.h>
+#import "FrameVCHelper.h"
+
+// Import app's Swift header (ObjCFrameSDKBridge, FramePreloader). The example uses FrameExampleTemp.
+// If your app has a different module name, add Preprocessor Macro: FRAME_SWIFT_HEADER="YourApp-Swift.h"
+#if defined(FRAME_SWIFT_HEADER)
+#import FRAME_SWIFT_HEADER
+#elif __has_include("FrameExampleTemp-Swift.h")
+#import "FrameExampleTemp-Swift.h"
+#elif __has_include(<FrameExampleTemp/FrameExampleTemp-Swift.h>)
+#import <FrameExampleTemp/FrameExampleTemp-Swift.h>
+#else
+#error "Swift header not found. Add FRAME_SWIFT_HEADER=\"YourApp-Swift.h\" to your app target's Preprocessor Macros, or ensure Swift files compile before this file."
+#endif
+
+@interface FrameSDKModule : NSObject <RCTBridgeModule>
+@end
 
-@interface RCT_EXTERN_MODULE(FrameSDK, FrameSDKBridge)
+@interface RCT_EXTERN_MODULE(FrameSDK, FrameSDKModule)
 
 RCT_EXTERN_METHOD(initialize:(NSString *)apiKey
                   debugMode:(BOOL)debugMode
@@ -24,3 +42,41 @@ RCT_EXTERN_METHOD(presentCart:(id)customerId
                   rejecter:(RCTPromiseRejectBlock)reject)
 
 @end
+
+@implementation FrameSDK
+@end
+
+@implementation FrameSDKModule
+
++ (BOOL)requiresMainQueueSetup {
+  return YES;
+}
+
+- (void)initialize:(NSString *)apiKey debugMode:(BOOL)debugMode resolver:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject {
+  [[[ObjCFrameSDKBridge alloc] init] initialize:apiKey debugMode:debugMode resolver:resolve rejecter:reject];
+}
+
+- (void)presentCheckout:(id)customerId amount:(NSNumber *)amount resolver:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject {
+  dispatch_async(dispatch_get_main_queue(), ^{
+    UIViewController *topVC = FrameGetTopViewController();
+    if (!topVC) {
+      reject(@"NO_ROOT_VC", @"Could not find root view controller to present checkout", nil);
+      return;
+    }
+    NSString *cId = [customerId isKindOfClass:[NSString class]] ? (NSString *)customerId : nil;
+    [[[ObjCFrameSDKBridge alloc] init] presentCheckoutFrom:topVC customerId:cId amount:amount.intValue resolver:resolve rejecter:reject];
+  });
+}
+
+- (void)presentCart:(id)customerId items:(NSArray *)items shippingAmountInCents:(NSNumber *)shippingAmountInCents resolver:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject {
+  dispatch_async(dispatch_get_main_queue(), ^{
+    UIViewController *topVC = FrameGetTopViewController();
+    if (!topVC) {
+      reject(@"NO_ROOT_VC", @"Could not find root view controller to present cart", nil);
+      return;
+    }
+    [[[ObjCFrameSDKBridge alloc] init] presentCartFrom:topVC customerId:customerId items:items shippingAmountInCents:shippingAmountInCents resolver:resolve rejecter:reject];
+  });
+}
+
+@end

package/ios/FrameSDKBridge.swift

@@ -11,14 +11,14 @@ import UIKit
 import SwiftUI
 import Frame
 
-@objc(FrameSDK)
-class FrameSDKBridge: NSObject {
+@objc(ObjCFrameSDKBridge)
+public class FrameSDKBridge: NSObject {
 
-  @objc static func requiresMainQueueSetup() -> Bool {
+  @objc public static func requiresMainQueueSetup() -> Bool {
     return true
   }
 
-  @objc
+  @objc public
   func initialize(_ apiKey: String, debugMode: Bool, resolver resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
     DispatchQueue.main.async {
       FrameNetworking.shared.initializeWithAPIKey(apiKey, debugMode: debugMode)
@@ -26,43 +26,41 @@ class FrameSDKBridge: NSObject {
     }
   }
 
-  @objc
-  func presentCheckout(_ customerId: NSObject, amount: NSNumber, resolver resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
-    let cId = customerId as? String
-    let amountInt = amount.intValue
-    DispatchQueue.main.async { [weak self] in
-      self?.presentCheckoutOnMain(customerId: cId, amount: amountInt, resolve: resolve, reject: reject)
-    }
+  @objc public
+  func presentCheckout(from viewController: UIViewController, customerId: String?, amount: Int, resolver resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
+    presentCheckoutOnMain(from: viewController, customerId: customerId, amount: amount, resolve: resolve, reject: reject)
   }
 
-  private func presentCheckoutOnMain(customerId: String?, amount: Int, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
-    guard let windowScene = UIApplication.shared.connectedScenes
-      .compactMap({ $0 as? UIWindowScene })
-      .first(where: { $0.activationState == .foregroundActive }),
-          let rootVC = windowScene.windows.first(where: { $0.isKeyWindow })?.rootViewController else {
-      reject("NO_ROOT_VC", "Could not find root view controller to present checkout", nil)
+  @objc public
+  func presentCart(from viewController: UIViewController, customerId: NSObject?, items: NSArray, shippingAmountInCents: Int, resolver resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
+    guard let cartItems = parseCartItems(items) else {
+      reject("INVALID_ITEMS", "Invalid cart items array", nil)
       return
     }
-    var top = rootVC
-    while let presented = top.presentedViewController { top = presented }
+    presentCartOnMain(from: viewController, customerId: customerId as? String, cartItems: cartItems, shippingAmountInCents: shippingAmountInCents, resolve: resolve, reject: reject)
+  }
+
+  private func presentCheckoutOnMain(from top: UIViewController, customerId: String?, amount: Int, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
     let delegate = CheckoutDismissDelegate(resolve: resolve, reject: reject)
     let checkoutView = FrameCheckoutView(
       customerId: customerId,
       paymentAmount: amount,
-      checkoutCallback: { [weak top, weak delegate] chargeIntent in
+      checkoutCallback: { [weak delegate] chargeIntent in
         delegate?.didComplete = true
-        top?.dismiss(animated: true)
-        if let dict = Self.encodeChargeIntent(chargeIntent) {
-          resolve(dict)
-        } else {
-          reject("ENCODE_ERROR", "Failed to encode charge intent", nil)
+        top.dismiss(animated: true)
+        DispatchQueue.main.async {
+          if let dict = Self.encodeChargeIntent(chargeIntent) {
+            resolve(dict)
+          } else {
+            reject("ENCODE_ERROR", "Failed to encode charge intent", nil)
+          }
         }
       }
     )
     let hosting = UIHostingController(rootView: checkoutView)
-    hosting.modalPresentationStyle = .pageSheet
+    hosting.modalPresentationStyle = UIModalPresentationStyle.pageSheet
     if let sheet = hosting.sheetPresentationController {
-      sheet.detents = [.large()]
+      sheet.detents = [UISheetPresentationController.Detent.large()]
     }
     objc_setAssociatedObject(hosting, &checkoutDismissKey, delegate, .OBJC_ASSOCIATION_RETAIN)
     hosting.presentationController?.delegate = delegate
@@ -74,19 +72,6 @@ class FrameSDKBridge: NSObject {
     return try? JSONSerialization.jsonObject(with: data) as? [String: Any]
   }
 
-  @objc
-  func presentCart(_ customerId: NSObject, items: NSArray, shippingAmountInCents: NSNumber, resolver resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
-    let cId = customerId as? String
-    let shipping = shippingAmountInCents.intValue
-    guard let cartItems = parseCartItems(items) else {
-      reject("INVALID_ITEMS", "Invalid cart items array", nil)
-      return
-    }
-    DispatchQueue.main.async { [weak self] in
-      self?.presentCartOnMain(customerId: cId, cartItems: cartItems, shippingAmountInCents: shipping, resolve: resolve, reject: reject)
-    }
-  }
-
   private struct RNFrameCartItem: FrameCartItem {
     var id: String
     var imageURL: String
@@ -107,25 +92,16 @@ class FrameSDKBridge: NSObject {
     return result
   }
 
-  private func presentCartOnMain(customerId: String?, cartItems: [RNFrameCartItem], shippingAmountInCents: Int, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
-    guard let windowScene = UIApplication.shared.connectedScenes
-      .compactMap({ $0 as? UIWindowScene })
-      .first(where: { $0.activationState == .foregroundActive }),
-          let rootVC = windowScene.windows.first(where: { $0.isKeyWindow })?.rootViewController else {
-      reject("NO_ROOT_VC", "Could not find root view controller to present cart", nil)
-      return
-    }
-    var top = rootVC
-    while let presented = top.presentedViewController { top = presented }
+  private func presentCartOnMain(from top: UIViewController, customerId: String?, cartItems: [RNFrameCartItem], shippingAmountInCents: Int, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
     let cartView = FrameCartView(
       customer: nil,
       cartItems: cartItems,
       shippingAmountInCents: shippingAmountInCents
     )
     let hosting = UIHostingController(rootView: cartView)
-    hosting.modalPresentationStyle = .pageSheet
+    hosting.modalPresentationStyle = UIModalPresentationStyle.pageSheet
     if let sheet = hosting.sheetPresentationController {
-      sheet.detents = [.large()]
+      sheet.detents = [UISheetPresentationController.Detent.large()]
     }
     // When the sheet is dismissed (swipe or close), resolve. Note: FrameCartView does not expose ChargeIntent from nested checkout.
     let delegate = CartDismissDelegate(resolve: resolve)
@@ -145,7 +121,9 @@ private final class CheckoutDismissDelegate: NSObject, UIAdaptivePresentationCon
   }
   func presentationControllerDidDismiss(_ presentationController: UIPresentationController) {
     guard !didComplete else { return }
-    reject("USER_CANCELED", "User dismissed checkout without completing payment", nil)
+    DispatchQueue.main.async { [reject] in
+      reject("USER_CANCELED", "User dismissed checkout without completing payment", nil)
+    }
   }
 }
 
@@ -153,9 +131,12 @@ private final class CartDismissDelegate: NSObject, UIAdaptivePresentationControl
   let resolve: RCTPromiseResolveBlock
   init(resolve: @escaping RCTPromiseResolveBlock) { self.resolve = resolve }
   func presentationControllerDidDismiss(_ presentationController: UIPresentationController) {
-    resolve([String: Any]())
+    DispatchQueue.main.async { [resolve] in
+      resolve([String: Any]())
+    }
   }
 }
 
 private var cartDismissKey: UInt8 = 0
 private var checkoutDismissKey: UInt8 = 0
+

package/ios/FrameVCHelper.h

@@ -0,0 +1,12 @@
+//
+//  FrameVCHelper.h
+//  FrameReactNative
+//
+
+#import <UIKit/UIKit.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+UIViewController * _Nullable FrameGetTopViewController(void);
+
+NS_ASSUME_NONNULL_END

package/ios/FrameVCHelper.m

@@ -0,0 +1,11 @@
+//
+//  FrameVCHelper.m
+//  FrameReactNative
+//
+
+#import "FrameVCHelper.h"
+#import <React/RCTUtils.h>
+
+UIViewController * _Nullable FrameGetTopViewController(void) {
+  return RCTPresentedViewController();
+}

package/lib/__tests__/native.test.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Unit tests for the native module bridge (initialize, presentCheckout, presentCart).
+ * NativeModules.FrameSDK is mocked.
+ */
+declare const mockInitialize: jest.Mock<Promise<void>, [_apiKey: string, _debugMode: boolean], any>;
+declare const mockPresentCheckout: jest.Mock<Promise<{
+    id: string;
+    amount: number;
+}>, [_customerId: unknown, _amount: number], any>;
+declare const mockPresentCart: jest.Mock<Promise<{
+    id: string;
+    amount: number;
+}>, [_customerId: unknown, _items: unknown[], _shipping: number], any>;
+declare let initialize: (opts: {
+    apiKey: string;
+    debugMode?: boolean;
+}) => void;
+declare let presentCheckout: (opts: {
+    customerId?: string | null;
+    amount: number;
+}) => Promise<unknown>;
+declare let presentCart: (opts: {
+    customerId?: string | null;
+    items: Array<{
+        id: string;
+        title: string;
+        amountInCents: number;
+        imageUrl: string;
+    }>;
+    shippingAmountInCents: number;
+}) => Promise<unknown>;
+//# sourceMappingURL=native.test.d.ts.map

package/lib/__tests__/native.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/native.test.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,QAAA,MAAM,cAAc,uEAAuE,CAAC;AAC5F,QAAA,MAAM,mBAAmB;;;iDAAqG,CAAC;AAC/H,QAAA,MAAM,eAAe;;;sEAA0H,CAAC;AAahJ,QAAA,IAAI,UAAU,EAAE,CAAC,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,KAAK,IAAI,CAAC;AACxE,QAAA,IAAI,eAAe,EAAE,CAAC,IAAI,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAChG,QAAA,IAAI,WAAW,EAAE,CAAC,IAAI,EAAE;IACtB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrF,qBAAqB,EAAE,MAAM,CAAC;CAC/B,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC"}

package/lib/__tests__/native.test.js

@@ -0,0 +1,101 @@
+"use strict";
+/**
+ * Unit tests for the native module bridge (initialize, presentCheckout, presentCart).
+ * NativeModules.FrameSDK is mocked.
+ */
+const mockInitialize = jest.fn((_apiKey, _debugMode) => Promise.resolve());
+const mockPresentCheckout = jest.fn((_customerId, _amount) => Promise.resolve({ id: 'ci_1', amount: 10000 }));
+const mockPresentCart = jest.fn((_customerId, _items, _shipping) => Promise.resolve({ id: 'ci_2', amount: 15000 }));
+jest.mock('react-native', () => ({
+    NativeModules: {
+        FrameSDK: {
+            initialize: mockInitialize,
+            presentCheckout: mockPresentCheckout,
+            presentCart: mockPresentCart,
+        },
+    },
+}));
+// Re-import after mock so we get the mocked NativeModules
+let initialize;
+let presentCheckout;
+let presentCart;
+beforeEach(() => {
+    jest.resetModules();
+    mockInitialize.mockClear();
+    mockPresentCheckout.mockClear();
+    mockPresentCart.mockClear();
+    const native = require('../native');
+    initialize = native.initialize;
+    presentCheckout = native.presentCheckout;
+    presentCart = native.presentCart;
+});
+describe('initialize', () => {
+    it('calls native FrameSDK.initialize with apiKey and debugMode', () => {
+        initialize({ apiKey: 'sk_test_xxx', debugMode: true });
+        expect(mockInitialize).toHaveBeenCalledTimes(1);
+        expect(mockInitialize).toHaveBeenCalledWith('sk_test_xxx', true);
+    });
+    it('defaults debugMode to false', () => {
+        initialize({ apiKey: 'sk_test_yyy' });
+        expect(mockInitialize).toHaveBeenCalledWith('sk_test_yyy', false);
+    });
+    it('throws if apiKey is missing', () => {
+        expect(() => initialize({ apiKey: '' })).toThrow();
+        expect(() => initialize({})).toThrow();
+        expect(mockInitialize).not.toHaveBeenCalled();
+    });
+});
+describe('presentCheckout', () => {
+    it('throws NOT_INITIALIZED if initialize was not called', async () => {
+        try {
+            await presentCheckout({ amount: 10000 });
+            expect(true).toBe(false);
+        }
+        catch (e) {
+            expect(e.code).toBe('NOT_INITIALIZED');
+            expect(e.message).toContain('initialized');
+        }
+        expect(mockPresentCheckout).not.toHaveBeenCalled();
+    });
+    it('calls native presentCheckout with customerId and amount after initialize', async () => {
+        initialize({ apiKey: 'sk_xxx' });
+        const result = await presentCheckout({ customerId: 'cus_1', amount: 10000 });
+        expect(mockPresentCheckout).toHaveBeenCalledWith('cus_1', 10000);
+        expect(result).toEqual({ id: 'ci_1', amount: 10000 });
+    });
+    it('passes null for customerId when not provided', async () => {
+        initialize({ apiKey: 'sk_xxx' });
+        await presentCheckout({ amount: 5000 });
+        expect(mockPresentCheckout).toHaveBeenCalledWith(null, 5000);
+    });
+});
+describe('presentCart', () => {
+    const items = [
+        { id: '1', title: 'Item A', amountInCents: 1000, imageUrl: 'https://example.com/a.jpg' },
+    ];
+    it('throws NOT_INITIALIZED if initialize was not called', async () => {
+        try {
+            await presentCart({ items, shippingAmountInCents: 500 });
+            expect(true).toBe(false);
+        }
+        catch (e) {
+            expect(e.code).toBe('NOT_INITIALIZED');
+        }
+        expect(mockPresentCart).not.toHaveBeenCalled();
+    });
+    it('calls native presentCart with customerId, items, shipping after initialize', async () => {
+        initialize({ apiKey: 'sk_xxx' });
+        const result = await presentCart({
+            customerId: 'cus_2',
+            items,
+            shippingAmountInCents: 500,
+        });
+        expect(mockPresentCart).toHaveBeenCalledWith('cus_2', items, 500);
+        expect(result).toEqual({ id: 'ci_2', amount: 15000 });
+    });
+    it('passes null for customerId when not provided', async () => {
+        initialize({ apiKey: 'sk_xxx' });
+        await presentCart({ items, shippingAmountInCents: 0 });
+        expect(mockPresentCart).toHaveBeenCalledWith(null, items, 0);
+    });
+});

package/lib/index.d.ts

@@ -1,12 +1,20 @@
 /**
- * @framepayments/react-native-frame
+ * framepayments-react-native
  *
  * React Native SDK for Frame Payments.
  * - Initialize the SDK, then use presentCheckout / presentCart for payment UI.
  * - For API calls (customers, charge intents, refunds), use the framepayments (frame-node) package from JS.
  */
+import { initialize, presentCheckout, presentCart } from './native';
 export { initialize, presentCheckout, presentCart } from './native';
 export type { FrameCartItem, ChargeIntent, FrameError } from './types';
 export { ErrorCodes } from './errors';
 export type { FrameErrorShape, FrameErrorCode } from './errors';
+/** Default export for Frame.initialize(), Frame.presentCheckout(), etc. */
+declare const _default: {
+    initialize: typeof initialize;
+    presentCheckout: typeof presentCheckout;
+    presentCart: typeof presentCart;
+};
+export default _default;
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACpE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACpE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAEhE,2EAA2E;;;;;;AAC3E,wBAA4D"}

package/lib/index.js

@@ -1,9 +1,12 @@
 /**
- * @framepayments/react-native-frame
+ * framepayments-react-native
  *
  * React Native SDK for Frame Payments.
  * - Initialize the SDK, then use presentCheckout / presentCart for payment UI.
  * - For API calls (customers, charge intents, refunds), use the framepayments (frame-node) package from JS.
  */
+import { initialize, presentCheckout, presentCart } from './native';
 export { initialize, presentCheckout, presentCart } from './native';
 export { ErrorCodes } from './errors';
+/** Default export for Frame.initialize(), Frame.presentCheckout(), etc. */
+export default { initialize, presentCheckout, presentCart };

package/lib/native.d.ts

@@ -5,7 +5,7 @@ import type { ChargeIntent, FrameCartItem } from './types';
 export declare function initialize(options: {
     apiKey: string;
     debugMode?: boolean;
-}): void;
+}): Promise<void>;
 export declare function presentCheckout(options: {
     customerId?: string | null;
     amount: number;

package/lib/native.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAmB3D,wBAAgB,UAAU,CAAC,OAAO,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAMjF;AAwBD,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACvC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,YAAY,CAAC,CAKxB;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE;IACnC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC;CAC/B,GAAG,OAAO,CAAC,YAAY,CAAC,CASxB"}
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAmB3D,wBAAgB,UAAU,CAAC,OAAO,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAS1F;AAwBD,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACvC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,YAAY,CAAC,CAKxB;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE;IACnC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC;CAC/B,GAAG,OAAO,CAAC,YAAY,CAAC,CASxB"}

package/lib/native.js

@@ -3,7 +3,7 @@
  */
 import { NativeModules } from 'react-native';
 import { ErrorCodes } from './errors';
-const LINKING_ERROR = `The package '@framepayments/react-native-frame' doesn't seem to be linked. Make sure you have run 'pod install' (iOS) or rebuilt the app (Android).`;
+const LINKING_ERROR = `The package 'framepayments-react-native' doesn't seem to be linked. Make sure you have run 'pod install' (iOS) or rebuilt the app (Android).`;
 const FrameSDK = NativeModules.FrameSDK
     ? NativeModules.FrameSDK
     : new Proxy({}, {
@@ -16,8 +16,9 @@ export function initialize(options) {
     if (!options?.apiKey) {
         throw new Error('Frame.initialize requires apiKey');
     }
-    FrameSDK.initialize(options.apiKey, options.debugMode ?? false);
-    isInitialized = true;
+    return wrapPromise(FrameSDK.initialize(options.apiKey, options.debugMode ?? false)).then(() => {
+        isInitialized = true;
+    });
 }
 function guardInitialized() {
     if (!isInitialized) {