framepayments-react-native 2.1.0 → 2.1.2

package/ios/FrameSDKBridge.swift

@@ -20,34 +20,35 @@ public class FrameSDKBridge: NSObject {
   }
 
   @objc public
-  func initialize(_ secretKey: String, publishableKey: String, debugMode: Bool, resolver resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
+  func initialize(_ secretKey: String, publishableKey: String, debugMode: Bool, theme: NSDictionary?, resolver resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
     DispatchQueue.main.async {
-      FrameNetworking.shared.initializeWithAPIKey(secretKey, publishableKey: publishableKey, debugMode: debugMode)
+      let themeDict = theme as? [String: Any] ?? [:]
+      let resolvedTheme = themeDict.isEmpty ? FrameTheme.default : FrameRNTheme.parse(themeDict)
+      FrameNetworking.shared.initializeWithAPIKey(secretKey, publishableKey: publishableKey, theme: resolvedTheme, debugMode: debugMode)
       resolve(nil)
     }
   }
 
   @objc public
-  func setTheme(_ theme: NSDictionary, resolver resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
-    DispatchQueue.main.async {
-      let dict = theme as? [String: Any] ?? [:]
-      FrameRNTheme.current = dict.isEmpty ? nil : FrameRNTheme.parse(dict)
-      resolve(nil)
+  func presentCheckout(from viewController: UIViewController, accountId: String?, amount: Int, resolver resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
+    guard let accountId, !accountId.isEmpty else {
+      reject("INVALID_ACCOUNT", "Frame.presentCheckout requires a non-empty accountId", nil)
+      return
     }
+    presentCheckoutOnMain(from: viewController, accountId: accountId, amount: amount, 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)
-  }
-
-  @objc public
-  func presentCart(from viewController: UIViewController, customerId: NSObject?, items: NSArray, shippingAmountInCents: Int, resolver resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
+  func presentCart(from viewController: UIViewController, accountId: 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
     }
-    presentCartOnMain(from: viewController, customerId: customerId as? String, cartItems: cartItems, shippingAmountInCents: shippingAmountInCents, resolve: resolve, reject: reject)
+    guard let accountIdString = accountId as? String, !accountIdString.isEmpty else {
+      reject("INVALID_ACCOUNT", "Frame.presentCart requires a non-empty accountId", nil)
+      return
+    }
+    presentCartOnMain(from: viewController, accountId: accountIdString, cartItems: cartItems, shippingAmountInCents: shippingAmountInCents, resolve: resolve, reject: reject)
   }
 
   @objc public
@@ -62,10 +63,10 @@ public class FrameSDKBridge: NSObject {
   func presentApplePay(_ ownerType: String, ownerId: String, amount: Int, currency: String, merchantId: String, resolver resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
     DispatchQueue.main.async {
       Task { @MainActor in
-        let owner: FrameApplePayViewModel.PaymentMethodOwner
+        let owner: ApplePayPresenter.Owner
         switch ownerType {
         case "customer": owner = .customer(ownerId)
-        case "account": owner = .account(ownerId)
+        case "account":  owner = .account(ownerId)
         default:
           reject("INVALID_OWNER", "owner.type must be 'customer' or 'account'", nil)
           return
@@ -104,25 +105,22 @@ public class FrameSDKBridge: NSObject {
 
   // MARK: - Private helpers
 
-  private func presentCheckoutOnMain(from top: UIViewController, customerId: String?, amount: Int, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
+  private func presentCheckoutOnMain(from top: UIViewController, accountId: String, amount: Int, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
     var hosting: CheckoutHostingController!
-    hosting = CheckoutHostingController(rootView: ThemedRoot(
-      FrameCheckoutView(
-        customerId: customerId,
-        paymentAmount: amount,
-        checkoutCallback: { [weak hosting] chargeIntent in
-          hosting?.didComplete = true
-          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)
-            }
+    hosting = CheckoutHostingController(rootView: FrameCheckoutView(
+      accountId: accountId,
+      paymentAmount: amount,
+      checkoutCallback: { [weak hosting] success, transferId in
+        hosting?.didComplete = true
+        top.dismiss(animated: true)
+        DispatchQueue.main.async {
+          if success, let transferId {
+            resolve(transferId)
+          } else {
+            reject("PAYMENT_FAILED", "Checkout did not produce a transfer id", nil)
           }
         }
-      ),
-      theme: FrameRNTheme.resolved()
+      }
     ))
     hosting.onCancel = {
       DispatchQueue.main.async {
@@ -138,11 +136,6 @@ public class FrameSDKBridge: NSObject {
     }
   }
 
-  internal static func encodeChargeIntent(_ intent: FrameObjects.ChargeIntent) -> [String: Any]? {
-    guard let data = try? JSONEncoder().encode(intent) else { return nil }
-    return try? JSONSerialization.jsonObject(with: data) as? [String: Any]
-  }
-
   private struct RNFrameCartItem: FrameCartItem {
     var id: String
     var imageURL: String
@@ -173,19 +166,29 @@ public class FrameSDKBridge: NSObject {
     return result
   }
 
-  private func presentCartOnMain(from top: UIViewController, customerId: String?, cartItems: [RNFrameCartItem], shippingAmountInCents: Int, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
+  private func presentCartOnMain(from top: UIViewController, accountId: String, cartItems: [RNFrameCartItem], shippingAmountInCents: Int, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
+    // Single dismiss delegate guards against double-resolve: the inner checkout
+    // calls `finish(.success)` with the transfer id; bare-dismiss (swipe-down
+    // without completing checkout) calls `finish(.cancel)`.
+    let delegate = CartDismissDelegate(resolve: resolve, reject: reject)
     let cartView = FrameCartView(
-      customer: nil,
+      accountId: accountId,
       cartItems: cartItems,
-      shippingAmountInCents: shippingAmountInCents
+      shippingAmountInCents: shippingAmountInCents,
+      checkoutCallback: { [weak top, delegate] success, transferId in
+        if success, let transferId {
+          delegate.finish(.success(transferId))
+        } else {
+          delegate.finish(.cancel)
+        }
+        top?.dismiss(animated: true)
+      }
     )
-    let hosting = UIHostingController(rootView: ThemedRoot(cartView, theme: FrameRNTheme.resolved()))
+    let hosting = UIHostingController(rootView: cartView)
     hosting.modalPresentationStyle = UIModalPresentationStyle.pageSheet
     if let sheet = hosting.sheetPresentationController {
       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)
     objc_setAssociatedObject(hosting, &cartDismissKey, delegate, .OBJC_ASSOCIATION_RETAIN)
     top.present(hosting, animated: true) {
       hosting.presentationController?.delegate = delegate
@@ -193,20 +196,22 @@ public class FrameSDKBridge: NSObject {
   }
 
   private func presentOnboardingOnMain(from top: UIViewController, accountId: String?, capabilities: [FrameObjects.Capabilities], applePayMerchantId: String?, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
-    var hosting: OnboardingHostingController<ThemedRoot<OnboardingContainerView>>!
-    var delegate: OnboardingDismissDelegate!
-    hosting = OnboardingHostingController(
-      rootView: ThemedRoot(
-        OnboardingContainerView(
-          accountId: accountId,
-          requiredCapabilities: capabilities,
-          applePayMerchantId: applePayMerchantId,
-          onComplete: { [weak top] in
-            delegate?.finish(completed: true)
-            top?.dismiss(animated: true)
-          }
-        ),
-        theme: FrameRNTheme.resolved()
+    // Build the dismiss delegate up-front so onComplete captures a non-nil
+    // instance directly. Earlier shape declared `var delegate: …!` and assigned
+    // it AFTER constructing OnboardingContainerView; the onComplete closure
+    // captured the local by reference, so any path that fired the callback
+    // before assignment landed on a nil delegate and silently no-op'd via `?.`.
+    let delegate = OnboardingDismissDelegate(resolve: resolve)
+
+    let hosting = OnboardingHostingController(
+      rootView: OnboardingContainerView(
+        accountId: accountId,
+        requiredCapabilities: capabilities,
+        applePayMerchantId: applePayMerchantId,
+        onComplete: { [delegate, weak top] in
+          delegate.finish(completed: true)
+          top?.dismiss(animated: true)
+        }
       )
     )
     // Embed in a UINavigationController so the outer sheet is a UIKit container,
@@ -222,7 +227,6 @@ public class FrameSDKBridge: NSObject {
     if let sheet = nav.sheetPresentationController {
       sheet.detents = [UISheetPresentationController.Detent.large()]
     }
-    delegate = OnboardingDismissDelegate(resolve: resolve)
     delegate.hostingController = nav
     objc_setAssociatedObject(nav, &onboardingDismissKey, delegate, .OBJC_ASSOCIATION_RETAIN)
     NSLog("[FrameRN][onb] presenting OnboardingHostingController (wrapped in UINavigationController) from \(type(of: top))")
@@ -235,7 +239,7 @@ public class FrameSDKBridge: NSObject {
 
 // MARK: - CheckoutHostingController
 
-private final class CheckoutHostingController: UIHostingController<ThemedRoot<FrameCheckoutView>>, UIAdaptivePresentationControllerDelegate {
+private final class CheckoutHostingController: UIHostingController<FrameCheckoutView>, UIAdaptivePresentationControllerDelegate {
   var didComplete = false
   var onCancel: (() -> Void)?
   private var cancelled = false
@@ -263,13 +267,34 @@ private final class OnboardingHostingController<V: View>: UIHostingController<V>
 // MARK: - Delegates
 
 private final class CartDismissDelegate: NSObject, UIAdaptivePresentationControllerDelegate {
-  let resolve: RCTPromiseResolveBlock
-  init(resolve: @escaping RCTPromiseResolveBlock) { self.resolve = resolve }
-  func presentationControllerDidDismiss(_ presentationController: UIPresentationController) {
-    DispatchQueue.main.async { [resolve] in
-      resolve([String: Any]())
+  enum Outcome {
+    case success(String)
+    case cancel
+  }
+
+  private let resolve: RCTPromiseResolveBlock
+  private let reject: RCTPromiseRejectBlock
+  private var didFinish = false
+
+  init(resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
+    self.resolve = resolve
+    self.reject = reject
+  }
+
+  func finish(_ outcome: Outcome) {
+    guard !didFinish else { return }
+    didFinish = true
+    DispatchQueue.main.async { [resolve, reject] in
+      switch outcome {
+      case .success(let transferId): resolve(transferId)
+      case .cancel: reject("USER_CANCELED", "User dismissed cart without completing checkout", nil)
+      }
     }
   }
+
+  func presentationControllerDidDismiss(_ presentationController: UIPresentationController) {
+    finish(.cancel)
+  }
 }
 
 private final class OnboardingDismissDelegate: NSObject, UIAdaptivePresentationControllerDelegate {

package/lib/errors.d.ts

@@ -7,12 +7,20 @@ export declare const ErrorCodes: {
     readonly NO_ROOT_VC: "NO_ROOT_VC";
     readonly NO_ACTIVITY: "NO_ACTIVITY";
     readonly INVALID_ITEMS: "INVALID_ITEMS";
+    readonly INVALID_ACCOUNT: "INVALID_ACCOUNT";
+    readonly INVALID_OWNER: "INVALID_OWNER";
+    readonly INVALID_MERCHANT_ID: "INVALID_MERCHANT_ID";
+    readonly INVALID_AMOUNT: "INVALID_AMOUNT";
     readonly NETWORK_ERROR: "NETWORK_ERROR";
     readonly API_ERROR: "API_ERROR";
     readonly PARSE_ERROR: "PARSE_ERROR";
     readonly NO_RESULT: "NO_RESULT";
     readonly INIT_FAILED: "INIT_FAILED";
-    readonly ENCODE_ERROR: "ENCODE_ERROR";
+    readonly APPLE_PAY_UNAVAILABLE: "APPLE_PAY_UNAVAILABLE";
+    readonly GOOGLE_PAY_UNAVAILABLE: "GOOGLE_PAY_UNAVAILABLE";
+    readonly NOT_ATTESTED: "NOT_ATTESTED";
+    readonly PAYMENT_METHOD_FAILED: "PAYMENT_METHOD_FAILED";
+    readonly PAYMENT_FAILED: "PAYMENT_FAILED";
 };
 export type FrameErrorCode = (typeof ErrorCodes)[keyof typeof ErrorCodes];
 export interface FrameErrorShape {

package/lib/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,UAAU;;;;;;;;;;;;CAYb,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAE1E,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CASrE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,eAAe,CAetE"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;CAoBb,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAE1E,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CASrE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,eAAe,CAetE"}

package/lib/errors.js

@@ -7,12 +7,20 @@ export const ErrorCodes = {
     NO_ROOT_VC: 'NO_ROOT_VC',
     NO_ACTIVITY: 'NO_ACTIVITY',
     INVALID_ITEMS: 'INVALID_ITEMS',
+    INVALID_ACCOUNT: 'INVALID_ACCOUNT',
+    INVALID_OWNER: 'INVALID_OWNER',
+    INVALID_MERCHANT_ID: 'INVALID_MERCHANT_ID',
+    INVALID_AMOUNT: 'INVALID_AMOUNT',
     NETWORK_ERROR: 'NETWORK_ERROR',
     API_ERROR: 'API_ERROR',
     PARSE_ERROR: 'PARSE_ERROR',
     NO_RESULT: 'NO_RESULT',
     INIT_FAILED: 'INIT_FAILED',
-    ENCODE_ERROR: 'ENCODE_ERROR',
+    APPLE_PAY_UNAVAILABLE: 'APPLE_PAY_UNAVAILABLE',
+    GOOGLE_PAY_UNAVAILABLE: 'GOOGLE_PAY_UNAVAILABLE',
+    NOT_ATTESTED: 'NOT_ATTESTED',
+    PAYMENT_METHOD_FAILED: 'PAYMENT_METHOD_FAILED',
+    PAYMENT_FAILED: 'PAYMENT_FAILED',
 };
 export function isFrameError(error) {
     return (typeof error === 'object' &&

package/lib/index.d.ts

@@ -7,12 +7,12 @@
  * - Use presentApplePay / presentGooglePay to launch the platform wallet sheet from your own button UI.
  * - For API calls (customers, charge intents, refunds), use the framepayments (frame-node) package from JS.
  */
-import { initialize, presentCheckout, presentCart, presentOnboarding, presentApplePay, presentGooglePay, setTheme } from './native';
-export { initialize, presentCheckout, presentCart, presentOnboarding, presentApplePay, presentGooglePay, setTheme, } from './native';
-export type { FrameCartItem, ChargeIntent, ChargeIntentStatus, AuthorizationMode, FrameError, BillingAddress, PaymentCard, BankAccount, PaymentMethod, OnboardingCapability, OnboardingResult, OnboardingResultStatus, ApplePayOwner, PresentApplePayOptions, PresentGooglePayOptions, FrameTheme, FrameThemeColor, FrameThemeFont, FrameThemeColors, FrameThemeFonts, FrameThemeRadii, } from './types';
+import { initialize, presentCheckout, presentCart, presentOnboarding, presentApplePay, presentGooglePay } from './native';
+export { initialize, presentCheckout, presentCart, presentOnboarding, presentApplePay, presentGooglePay, } from './native';
+export type { FrameCartItem, FrameError, BillingAddress, PaymentCard, BankAccount, PaymentMethod, OnboardingCapability, OnboardingResult, OnboardingResultStatus, WalletOwner, ApplePayOwner, PresentApplePayOptions, PresentGooglePayOptions, FrameTheme, FrameThemeColor, FrameThemeFont, FrameThemeColors, FrameThemeFonts, FrameThemeRadii, } from './types';
 export { ErrorCodes } from './errors';
 export type { FrameErrorShape, FrameErrorCode } from './errors';
-/** Default export for Frame.initialize(), Frame.presentCheckout(), Frame.presentCart(), Frame.presentOnboarding(), Frame.presentApplePay(), Frame.presentGooglePay(), Frame.setTheme() */
+/** Default export for Frame.initialize(), Frame.presentCheckout(), Frame.presentCart(), Frame.presentOnboarding(), Frame.presentApplePay(), Frame.presentGooglePay() */
 declare const _default: {
     initialize: typeof initialize;
     presentCheckout: typeof presentCheckout;
@@ -20,7 +20,6 @@ declare const _default: {
     presentOnboarding: typeof presentOnboarding;
     presentApplePay: typeof presentApplePay;
     presentGooglePay: typeof presentGooglePay;
-    setTheme: typeof setTheme;
 };
 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;;;;;;;;GAQG;AAEH,OAAO,EACL,UAAU,EACV,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,QAAQ,EACT,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,UAAU,EACV,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,QAAQ,GACT,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,WAAW,EACX,WAAW,EACX,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,aAAa,EACb,sBAAsB,EACtB,uBAAuB,EACvB,UAAU,EACV,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,eAAe,GAChB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAEhE,0LAA0L;;;;;;;;;;AAC1L,wBAQE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,UAAU,EACV,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,UAAU,EACV,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,aAAa,EACb,UAAU,EACV,cAAc,EACd,WAAW,EACX,WAAW,EACX,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,WAAW,EACX,aAAa,EACb,sBAAsB,EACtB,uBAAuB,EACvB,UAAU,EACV,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,eAAe,GAChB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAEhE,wKAAwK;;;;;;;;;AACxK,wBAOE"}

package/lib/index.js

@@ -7,10 +7,10 @@
  * - Use presentApplePay / presentGooglePay to launch the platform wallet sheet from your own button UI.
  * - For API calls (customers, charge intents, refunds), use the framepayments (frame-node) package from JS.
  */
-import { initialize, presentCheckout, presentCart, presentOnboarding, presentApplePay, presentGooglePay, setTheme, } from './native';
-export { initialize, presentCheckout, presentCart, presentOnboarding, presentApplePay, presentGooglePay, setTheme, } from './native';
+import { initialize, presentCheckout, presentCart, presentOnboarding, presentApplePay, presentGooglePay, } from './native';
+export { initialize, presentCheckout, presentCart, presentOnboarding, presentApplePay, presentGooglePay, } from './native';
 export { ErrorCodes } from './errors';
-/** Default export for Frame.initialize(), Frame.presentCheckout(), Frame.presentCart(), Frame.presentOnboarding(), Frame.presentApplePay(), Frame.presentGooglePay(), Frame.setTheme() */
+/** Default export for Frame.initialize(), Frame.presentCheckout(), Frame.presentCart(), Frame.presentOnboarding(), Frame.presentApplePay(), Frame.presentGooglePay() */
 export default {
     initialize,
     presentCheckout,
@@ -18,5 +18,4 @@ export default {
     presentOnboarding,
     presentApplePay,
     presentGooglePay,
-    setTheme,
 };

package/lib/native.d.ts

@@ -1,36 +1,64 @@
 /**
  * Native module bridge. Uses NativeModules for classic React Native bridge.
  */
-import type { ChargeIntent, FrameCartItem, FrameTheme, OnboardingCapability, OnboardingResult, PresentApplePayOptions, PresentGooglePayOptions } from './types';
+import type { FrameCartItem, FrameTheme, OnboardingCapability, OnboardingResult, PresentApplePayOptions, PresentGooglePayOptions } from './types';
 export declare function initialize(options: {
     secretKey: string;
     publishableKey: string;
     debugMode?: boolean;
+    /**
+     * Optional theme applied SDK-wide to Frame's reusable iOS components
+     * (checkout, cart, onboarding). Pass any subset — unspecified tokens fall
+     * back to SDK defaults. No-op on Android until frame-android ships a
+     * matching theme API.
+     */
+    theme?: FrameTheme;
 }): Promise<void>;
+/**
+ * Presents the Frame checkout sheet for the given account. Resolves with the
+ * created Transfer's id string on success, or rejects with `USER_CANCELED` if
+ * the user dismisses the sheet.
+ *
+ * `accountId` is required: the bundled checkout creates a `Transfer`, which is
+ * account-scoped. Callers needing a customer/ChargeIntent flow should use
+ * `presentApplePay` / `presentGooglePay` directly with a customer owner.
+ */
 export declare function presentCheckout(options: {
-    customerId?: string | null;
+    accountId: string;
     amount: number;
-}): Promise<ChargeIntent>;
+}): Promise<string>;
+/**
+ * Presents the Frame cart UI; tapping checkout routes through the same flow
+ * as `presentCheckout` and resolves with the created Transfer's id string.
+ *
+ * `accountId` is required for the same reason as `presentCheckout`.
+ */
 export declare function presentCart(options: {
-    customerId?: string | null;
+    accountId: string;
     items: FrameCartItem[];
     shippingAmountInCents: number;
-}): Promise<ChargeIntent>;
+}): Promise<string>;
 export declare function presentOnboarding(options: {
     accountId?: string | null;
     capabilities?: OnboardingCapability[];
     applePayMerchantId?: string | null;
     googlePayMerchantId?: string | null;
 }): Promise<OnboardingResult>;
-export declare function presentApplePay(options: PresentApplePayOptions): Promise<ChargeIntent>;
-export declare function presentGooglePay(options: PresentGooglePayOptions): Promise<ChargeIntent>;
 /**
- * Configure colors, fonts, and corner radii for Frame's reusable iOS
- * components. Applied to every subsequent `present*` call; an in-flight modal
- * is not re-themed mid-flow.
+ * Presents the Apple Pay sheet and creates a charge from the resulting wallet
+ * payment method. Resolves with the created resource's id string on success,
+ * or rejects with `USER_CANCELED` if the sheet is dismissed.
+ *
+ *  - `owner.type === 'customer'` → creates a `ChargeIntent`; resolves with its id.
+ *  - `owner.type === 'account'`  → creates a `Transfer`;     resolves with its id.
+ */
+export declare function presentApplePay(options: PresentApplePayOptions): Promise<string>;
+/**
+ * Presents Google Pay and creates a charge from the resulting wallet payment method.
+ * Resolves with the created resource's id string on success.
  *
- * Pass `null` or `{}` to reset to SDK defaults. Android is a no-op until
- * frame-android ships a matching theme API.
+ *  - `owner.type === 'customer'` → creates a `ChargeIntent`; resolves with its id.
+ *  - `owner.type === 'account'`  → creates a `Transfer`;     resolves with its id.
  */
-export declare function setTheme(theme: FrameTheme | null): Promise<void>;
+export declare function presentGooglePay(options: PresentGooglePayOptions): Promise<string>;
 //# sourceMappingURL=native.d.ts.map

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,EACV,YAAY,EACZ,aAAa,EACb,UAAU,EACV,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,SAAS,CAAC;AAmBjB,wBAAgB,UAAU,CAAC,OAAO,EAAE;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBhB;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;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IACzC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACtC,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAkB5B;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,YAAY,CAAC,CAoBtF;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,YAAY,CAAC,CAUxF;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAMhE"}
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EACV,aAAa,EACb,UAAU,EACV,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,SAAS,CAAC;AAiCjB,wBAAgB,UAAU,CAAC,OAAO,EAAE;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBhB;AAwBD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAQlB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC;CAC/B,GAAG,OAAO,CAAC,MAAM,CAAC,CAYlB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IACzC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACtC,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAkB5B;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoBhF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBlF"}

package/lib/native.js

@@ -3,6 +3,18 @@
  */
 import { NativeModules, Platform } from 'react-native';
 import { ErrorCodes } from './errors';
+/**
+ * Throw a coded error from synchronous JS validation. Mirrors the `code`/`message`
+ * shape that native rejections produce so consumers can catch `e.code === 'INVALID_*'`
+ * uniformly.
+ */
+function throwCoded(code, message) {
+    const err = new Error(message);
+    err.code = code;
+    throw err;
+}
+// theme is iOS-only today: frame-android does not yet have a matching theme API,
+// so the field is accepted on both platforms but ignored on Android until it does.
 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
@@ -14,12 +26,15 @@ const FrameSDK = NativeModules.FrameSDK
 let isInitialized = false;
 export function initialize(options) {
     if (!options?.secretKey) {
-        throw new Error('Frame.initialize requires secretKey');
+        throwCoded(ErrorCodes.INIT_FAILED, 'Frame.initialize requires secretKey');
     }
     if (!options?.publishableKey) {
-        throw new Error('Frame.initialize requires publishableKey');
+        throwCoded(ErrorCodes.INIT_FAILED, 'Frame.initialize requires publishableKey');
     }
-    return wrapPromise(FrameSDK.initialize(options.secretKey, options.publishableKey, options.debugMode ?? false)).then(() => {
+    if (options.theme !== undefined && (typeof options.theme !== 'object' || Array.isArray(options.theme))) {
+        throwCoded(ErrorCodes.INIT_FAILED, 'Frame.initialize: theme must be an object');
+    }
+    return wrapPromise(FrameSDK.initialize(options.secretKey, options.publishableKey, options.debugMode ?? false, options.theme ?? null)).then(() => {
         isInitialized = true;
     });
 }
@@ -43,13 +58,34 @@ function wrapPromise(p) {
         throw Object.assign(new Error(message), { code, message });
     });
 }
+/**
+ * Presents the Frame checkout sheet for the given account. Resolves with the
+ * created Transfer's id string on success, or rejects with `USER_CANCELED` if
+ * the user dismisses the sheet.
+ *
+ * `accountId` is required: the bundled checkout creates a `Transfer`, which is
+ * account-scoped. Callers needing a customer/ChargeIntent flow should use
+ * `presentApplePay` / `presentGooglePay` directly with a customer owner.
+ */
 export function presentCheckout(options) {
     guardInitialized();
-    return wrapPromise(FrameSDK.presentCheckout(options.customerId ?? null, options.amount));
+    if (!options?.accountId) {
+        throwCoded(ErrorCodes.INVALID_ACCOUNT, 'Frame.presentCheckout requires accountId');
+    }
+    return wrapPromise(FrameSDK.presentCheckout(options.accountId, options.amount));
 }
+/**
+ * Presents the Frame cart UI; tapping checkout routes through the same flow
+ * as `presentCheckout` and resolves with the created Transfer's id string.
+ *
+ * `accountId` is required for the same reason as `presentCheckout`.
+ */
 export function presentCart(options) {
     guardInitialized();
-    return wrapPromise(FrameSDK.presentCart(options.customerId ?? null, options.items, options.shippingAmountInCents));
+    if (!options?.accountId) {
+        throwCoded(ErrorCodes.INVALID_ACCOUNT, 'Frame.presentCart requires accountId');
+    }
+    return wrapPromise(FrameSDK.presentCart(options.accountId, options.items, options.shippingAmountInCents));
 }
 export function presentOnboarding(options) {
     guardInitialized();
@@ -58,36 +94,41 @@ export function presentOnboarding(options) {
     }
     return wrapPromise(FrameSDK.presentOnboarding(options.accountId ?? null, options.capabilities ?? [], options.googlePayMerchantId ?? null));
 }
+/**
+ * Presents the Apple Pay sheet and creates a charge from the resulting wallet
+ * payment method. Resolves with the created resource's id string on success,
+ * or rejects with `USER_CANCELED` if the sheet is dismissed.
+ *
+ *  - `owner.type === 'customer'` → creates a `ChargeIntent`; resolves with its id.
+ *  - `owner.type === 'account'`  → creates a `Transfer`;     resolves with its id.
+ */
 export function presentApplePay(options) {
     guardInitialized();
     if (!options?.owner || (options.owner.type !== 'customer' && options.owner.type !== 'account')) {
-        throw new Error('Frame.presentApplePay requires owner: { type: "customer" | "account", id: string }');
+        throwCoded(ErrorCodes.INVALID_OWNER, 'Frame.presentApplePay requires owner: { type: "customer" | "account", id: string }');
     }
     if (!options.owner.id) {
-        throw new Error('Frame.presentApplePay requires owner.id');
+        throwCoded(ErrorCodes.INVALID_OWNER, 'Frame.presentApplePay requires owner.id');
     }
     if (!options.merchantId) {
-        throw new Error('Frame.presentApplePay requires merchantId');
+        throwCoded(ErrorCodes.INVALID_MERCHANT_ID, 'Frame.presentApplePay requires merchantId');
     }
     return wrapPromise(FrameSDK.presentApplePay(options.owner.type, options.owner.id, options.amount, options.currency ?? 'usd', options.merchantId));
 }
-export function presentGooglePay(options) {
-    guardInitialized();
-    return wrapPromise(FrameSDK.presentGooglePay(options.amountCents, options.customerId ?? null, options.currencyCode ?? 'USD', options.googlePayMerchantId ?? null));
-}
 /**
- * Configure colors, fonts, and corner radii for Frame's reusable iOS
- * components. Applied to every subsequent `present*` call; an in-flight modal
- * is not re-themed mid-flow.
+ * Presents Google Pay and creates a charge from the resulting wallet payment method.
+ * Resolves with the created resource's id string on success.
  *
- * Pass `null` or `{}` to reset to SDK defaults. Android is a no-op until
- * frame-android ships a matching theme API.
+ *  - `owner.type === 'customer'` → creates a `ChargeIntent`; resolves with its id.
+ *  - `owner.type === 'account'`  → creates a `Transfer`;     resolves with its id.
  */
-export function setTheme(theme) {
-    if (theme !== null && (typeof theme !== 'object' || Array.isArray(theme))) {
-        throw new Error('Frame.setTheme requires a theme object or null');
+export function presentGooglePay(options) {
+    guardInitialized();
+    if (!options?.owner || (options.owner.type !== 'customer' && options.owner.type !== 'account')) {
+        throwCoded(ErrorCodes.INVALID_OWNER, 'Frame.presentGooglePay requires owner: { type: "customer" | "account", id: string }');
+    }
+    if (!options.owner.id) {
+        throwCoded(ErrorCodes.INVALID_OWNER, 'Frame.presentGooglePay requires owner.id');
     }
-    if (Platform.OS !== 'ios')
-        return Promise.resolve();
-    return wrapPromise(FrameSDK.setTheme(theme ?? {}));
+    return wrapPromise(FrameSDK.presentGooglePay(options.amountCents, options.owner.type, options.owner.id, options.currencyCode ?? 'USD', options.googlePayMerchantId ?? null));
 }