framepayments-react-native 2.0.9 → 2.1.1

package/README.md

@@ -299,32 +299,37 @@ On non-Android platforms `Frame.presentGooglePay` rejects synchronously with a n
 
 ---
 
-### `Frame.setTheme(theme)` (iOS)
+### Theming (iOS)
 
 Customizes colors, fonts, and corner radii on Frame's reusable components — checkout, cart, and the onboarding flow. Backed by `FrameTheme` introduced in Frame-iOS 2.1.2.
 
-Call once at app startup (after `Frame.initialize`). The theme applies to every subsequent `present*` call. Modals already on screen are not re-themed mid-flow. Pass `null` or `{}` to reset to defaults; pass a partial dict to override only specific tokens.
+Pass an optional `theme` to `Frame.initialize`. It's stored on `FrameNetworking.shared` and read by every Frame view at present time, so all subsequent `present*` calls render with it. Modals already on screen are not re-themed if the theme is changed mid-flow. Omit the field, or pass `{}`, to use SDK defaults; pass a partial dict to override only specific tokens.
 
 ```ts
 import Frame from 'framepayments-react-native';
 
-await Frame.setTheme({
-  colors: {
-    primaryButton: '#5B2DFF',
-    primaryButtonText: '#FFFFFF',
-    surface: '#0A0A0A',
-    textPrimary: '#FFFFFF',
-    error: '#E53935',
-  },
-  fonts: {
-    title: { name: 'Inter-Bold', size: 24 },
-    button: { name: 'Inter-SemiBold', size: 16 },
+await Frame.initialize({
+  secretKey: 'sk_sandbox_...',
+  publishableKey: 'pk_sandbox_...',
+  debugMode: __DEV__,
+  theme: {
+    colors: {
+      primaryButton: '#5B2DFF',
+      primaryButtonText: '#FFFFFF',
+      surface: '#0A0A0A',
+      textPrimary: '#FFFFFF',
+      error: '#E53935',
+    },
+    fonts: {
+      title: { name: 'Inter-Bold', size: 24 },
+      button: { name: 'Inter-SemiBold', size: 16 },
+    },
+    radii: { medium: 16 },
   },
-  radii: { medium: 16 },
 });
 ```
 
-**Android**: `setTheme()` resolves immediately and has no effect — `frame-android` does not yet have a matching theme API.
+**Android**: the `theme` field is accepted for cross-platform parity but currently has no effect — `frame-android` does not yet have a matching theme API.
 
 #### Tokens
 

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

@@ -31,7 +31,15 @@ class FrameSDKModule(reactContext: ReactApplicationContext) :
   }
 
   @ReactMethod
-  fun initialize(secretKey: String, publishableKey: String, debugMode: Boolean, promise: Promise) {
+  fun initialize(
+    secretKey: String,
+    publishableKey: String,
+    debugMode: Boolean,
+    @Suppress("UNUSED_PARAMETER") theme: com.facebook.react.bridge.ReadableMap?,
+    promise: Promise
+  ) {
+    // theme is accepted for cross-platform parity with iOS but is currently a
+    // no-op on Android — frame-android does not yet have a matching theme API.
     try {
       val ctx = reactApplicationContext.applicationContext
       FrameNetworking.initializeWithAPIKey(ctx, secretKey, publishableKey, debugMode)

package/ios/FrameRNTheme.swift

@@ -2,8 +2,9 @@
 //  FrameRNTheme.swift
 //  FrameReactNative
 //
-//  Bridges JS theme dictionaries to Frame-iOS's FrameTheme and applies it to
-//  every SwiftUI root view we present. Read/written only on the main thread.
+//  Parses JS theme dictionaries into Frame-iOS's FrameTheme. The parsed
+//  theme is handed to FrameNetworking.shared.configureTheme(_:); the SDK
+//  owns storage and applies it via its FrameThemeKey environment default.
 //
 
 import Foundation
@@ -11,12 +12,6 @@ import SwiftUI
 import Frame
 
 enum FrameRNTheme {
-  // Main-thread only: written by FrameSDKBridge.setTheme (dispatched to main),
-  // read by present* methods (already on main).
-  static var current: FrameTheme? = nil
-
-  static func resolved() -> FrameTheme { current ?? .default }
-
   static func parse(_ dict: [String: Any]) -> FrameTheme {
     var theme = FrameTheme.default
 
@@ -75,22 +70,6 @@ enum FrameRNTheme {
   }
 }
 
-// Applies the supplied FrameTheme to a single root view. Captured at present
-// time so each UIHostingController has a stable, concrete rootView type.
-struct ThemedRoot<Content: View>: View {
-  let theme: FrameTheme
-  let content: Content
-
-  init(_ content: Content, theme: FrameTheme) {
-    self.content = content
-    self.theme = theme
-  }
-
-  var body: some View {
-    content.frameTheme(theme)
-  }
-}
-
 extension Color {
   // Accepts "#RGB", "#RRGGBB", "#RRGGBBAA" with or without the leading '#'.
   init?(rnHex hex: String) {

package/ios/FrameSDKBridge.m

@@ -28,10 +28,7 @@
 RCT_EXTERN_METHOD(initialize:(NSString *)secretKey
                   publishableKey:(NSString *)publishableKey
                   debugMode:(BOOL)debugMode
-                  resolver:(RCTPromiseResolveBlock)resolve
-                  rejecter:(RCTPromiseRejectBlock)reject)
-
-RCT_EXTERN_METHOD(setTheme:(NSDictionary *)theme
+                  theme:(NSDictionary *)theme
                   resolver:(RCTPromiseResolveBlock)resolve
                   rejecter:(RCTPromiseRejectBlock)reject)
 
@@ -47,11 +44,6 @@ RCT_EXTERN_METHOD(presentCart:(id)customerId
                   rejecter:(RCTPromiseRejectBlock)reject)
 
 RCT_EXTERN_METHOD(presentOnboarding:(id)accountId
-                  capabilities:(NSArray *)capabilities
-                  resolver:(RCTPromiseResolveBlock)resolve
-                  rejecter:(RCTPromiseRejectBlock)reject)
-
-RCT_EXTERN_METHOD(presentOnboardingWithApplePay:(id)accountId
                   capabilities:(NSArray *)capabilities
                   applePayMerchantId:(id)applePayMerchantId
                   resolver:(RCTPromiseResolveBlock)resolve
@@ -76,12 +68,8 @@ RCT_EXTERN_METHOD(presentApplePay:(NSString *)ownerType
   return YES;
 }
 
-- (void)initialize:(NSString *)secretKey publishableKey:(NSString *)publishableKey debugMode:(BOOL)debugMode resolver:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject {
-  [[[ObjCFrameSDKBridge alloc] init] initialize:secretKey publishableKey:publishableKey debugMode:debugMode resolver:resolve rejecter:reject];
-}
-
-- (void)setTheme:(NSDictionary *)theme resolver:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject {
-  [[[ObjCFrameSDKBridge alloc] init] setTheme:theme resolver:resolve rejecter:reject];
+- (void)initialize:(NSString *)secretKey publishableKey:(NSString *)publishableKey debugMode:(BOOL)debugMode theme:(NSDictionary *)theme resolver:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject {
+  [[[ObjCFrameSDKBridge alloc] init] initialize:secretKey publishableKey:publishableKey debugMode:debugMode theme:theme resolver:resolve rejecter:reject];
 }
 
 - (void)presentCheckout:(id)customerId amount:(NSNumber *)amount resolver:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject {
@@ -107,25 +95,14 @@ RCT_EXTERN_METHOD(presentApplePay:(NSString *)ownerType
   });
 }
 
-- (void)presentOnboarding:(id)accountId capabilities:(NSArray *)capabilities 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 onboarding", nil);
-      return;
-    }
-    [[[ObjCFrameSDKBridge alloc] init] presentOnboardingFrom:topVC accountId:accountId capabilities:capabilities resolver:resolve rejecter:reject];
-  });
-}
-
-- (void)presentOnboardingWithApplePay:(id)accountId capabilities:(NSArray *)capabilities applePayMerchantId:(id)applePayMerchantId resolver:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject {
+- (void)presentOnboarding:(id)accountId capabilities:(NSArray *)capabilities applePayMerchantId:(id)applePayMerchantId 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 onboarding", nil);
       return;
     }
-    [[[ObjCFrameSDKBridge alloc] init] presentOnboardingWithApplePayFrom:topVC accountId:accountId capabilities:capabilities applePayMerchantId:applePayMerchantId resolver:resolve rejecter:reject];
+    [[[ObjCFrameSDKBridge alloc] init] presentOnboardingFrom:topVC accountId:accountId capabilities:capabilities applePayMerchantId:applePayMerchantId resolver:resolve rejecter:reject];
   });
 }
 

package/ios/FrameSDKBridge.swift

@@ -20,18 +20,11 @@ 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)
-      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)
+      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)
     }
   }
@@ -51,14 +44,7 @@ public class FrameSDKBridge: NSObject {
   }
 
   @objc public
-  func presentOnboarding(from viewController: UIViewController, accountId: NSObject?, capabilities: NSArray, resolver resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
-    let parsedCapabilities = parseCapabilities(capabilities)
-    let accountIdString = accountId as? String
-    presentOnboardingOnMain(from: viewController, accountId: accountIdString, capabilities: parsedCapabilities, applePayMerchantId: nil, resolve: resolve, reject: reject)
-  }
-
-  @objc public
-  func presentOnboardingWithApplePay(from viewController: UIViewController, accountId: NSObject?, capabilities: NSArray, applePayMerchantId: NSObject?, resolver resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
+  func presentOnboarding(from viewController: UIViewController, accountId: NSObject?, capabilities: NSArray, applePayMerchantId: NSObject?, resolver resolve: @escaping RCTPromiseResolveBlock, rejecter reject: @escaping RCTPromiseRejectBlock) {
     let parsedCapabilities = parseCapabilities(capabilities)
     let accountIdString = accountId as? String
     let merchantIdString = applePayMerchantId as? String
@@ -113,23 +99,20 @@ public class FrameSDKBridge: NSObject {
 
   private func presentCheckoutOnMain(from top: UIViewController, customerId: 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(
+      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)
           }
         }
-      ),
-      theme: FrameRNTheme.resolved()
+      }
     ))
     hosting.onCancel = {
       DispatchQueue.main.async {
@@ -186,7 +169,7 @@ public class FrameSDKBridge: NSObject {
       cartItems: cartItems,
       shippingAmountInCents: shippingAmountInCents
     )
-    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()]
@@ -200,20 +183,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,
@@ -229,7 +214,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))")
@@ -242,7 +226,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

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';
+import { initialize, presentCheckout, presentCart, presentOnboarding, presentApplePay, presentGooglePay } from './native';
+export { initialize, presentCheckout, presentCart, presentOnboarding, presentApplePay, presentGooglePay, } 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';
 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,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,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

@@ -6,6 +6,13 @@ 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>;
 export declare function presentCheckout(options: {
     customerId?: string | null;
@@ -24,13 +31,4 @@ export declare function presentOnboarding(options: {
 }): 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.
- *
- * Pass `null` or `{}` to reset to SDK defaults. Android is a no-op until
- * frame-android ships a matching theme API.
- */
-export declare function setTheme(theme: FrameTheme | null): Promise<void>;
 //# 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,CA0B5B;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,YAAY,EACZ,aAAa,EACb,UAAU,EACV,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,SAAS,CAAC;AAsBjB,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,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"}

package/lib/native.js

@@ -3,6 +3,8 @@
  */
 import { NativeModules, Platform } from 'react-native';
 import { ErrorCodes } from './errors';
+// 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
@@ -19,7 +21,10 @@ export function initialize(options) {
     if (!options?.publishableKey) {
         throw new Error('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))) {
+        throw new Error('Frame.initialize: theme must be an object');
+    }
+    return wrapPromise(FrameSDK.initialize(options.secretKey, options.publishableKey, options.debugMode ?? false, options.theme ?? null)).then(() => {
         isInitialized = true;
     });
 }
@@ -53,11 +58,8 @@ export function presentCart(options) {
 }
 export function presentOnboarding(options) {
     guardInitialized();
-    if (Platform.OS === 'ios' && options.applePayMerchantId) {
-        return wrapPromise(FrameSDK.presentOnboardingWithApplePay(options.accountId ?? null, options.capabilities ?? [], options.applePayMerchantId));
-    }
     if (Platform.OS === 'ios') {
-        return wrapPromise(FrameSDK.presentOnboarding(options.accountId ?? null, options.capabilities ?? []));
+        return wrapPromise(FrameSDK.presentOnboarding(options.accountId ?? null, options.capabilities ?? [], options.applePayMerchantId ?? null));
     }
     return wrapPromise(FrameSDK.presentOnboarding(options.accountId ?? null, options.capabilities ?? [], options.googlePayMerchantId ?? null));
 }
@@ -78,19 +80,3 @@ 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.
- *
- * Pass `null` or `{}` to reset to SDK defaults. Android is a no-op until
- * frame-android ships a matching theme API.
- */
-export function setTheme(theme) {
-    if (theme !== null && (typeof theme !== 'object' || Array.isArray(theme))) {
-        throw new Error('Frame.setTheme requires a theme object or null');
-    }
-    if (Platform.OS !== 'ios')
-        return Promise.resolve();
-    return wrapPromise(FrameSDK.setTheme(theme ?? {}));
-}

package/package.json

@@ -1,14 +1,16 @@
 {
   "name": "framepayments-react-native",
-  "version": "2.0.9",
+  "version": "2.1.1",
   "description": "React Native SDK for Frame Payments - modal checkout and cart, with API usage via frame-node.",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
   "scripts": {
     "build": "tsc",
+    "watch": "tsc --watch",
     "typecheck": "tsc --noEmit",
     "lint": "eslint src --ext .ts,.tsx",
     "test": "jest",
+    "prepare": "npm run build",
     "prepublishOnly": "npm run build"
   },
   "keywords": [

package/src/__tests__/native.test.ts

@@ -6,8 +6,7 @@
 const mockInitialize = jest.fn((_secretKey: string, _publishableKey: string, _debugMode: boolean) => Promise.resolve());
 const mockPresentCheckout = jest.fn((_customerId: unknown, _amount: number) => Promise.resolve({ id: 'ci_1', amount: 10000 }));
 const mockPresentCart = jest.fn((_customerId: unknown, _items: unknown[], _shipping: number) => Promise.resolve({ id: 'ci_2', amount: 15000 }));
-const mockPresentOnboarding = jest.fn((_accountId: unknown, _capabilities: unknown[]) => Promise.resolve({ status: 'completed', paymentMethodId: 'pm_1' }));
-const mockPresentOnboardingWithApplePay = jest.fn((_accountId: unknown, _capabilities: unknown[], _merchantId: string) => Promise.resolve({ status: 'completed', paymentMethodId: 'pm_2' }));
+const mockPresentOnboarding = jest.fn((_accountId: unknown, _capabilities: unknown[], _merchantId: string | null) => Promise.resolve({ status: 'completed', paymentMethodId: 'pm_1' }));
 
 const mockPlatform = { OS: 'ios' as 'ios' | 'android' };
 
@@ -18,7 +17,6 @@ jest.mock('react-native', () => ({
       presentCheckout: mockPresentCheckout,
       presentCart: mockPresentCart,
       presentOnboarding: mockPresentOnboarding,
-      presentOnboardingWithApplePay: mockPresentOnboardingWithApplePay,
     },
   },
   Platform: mockPlatform,
@@ -40,7 +38,6 @@ beforeEach(() => {
   mockPresentCheckout.mockClear();
   mockPresentCart.mockClear();
   mockPresentOnboarding.mockClear();
-  mockPresentOnboardingWithApplePay.mockClear();
   mockPlatform.OS = 'ios';
   const native = require('../native');
   initialize = native.initialize;
@@ -145,33 +142,33 @@ describe('presentOnboarding', () => {
     expect(mockPresentOnboarding).not.toHaveBeenCalled();
   });
 
-  it('calls native presentOnboarding with accountId and capabilities after initialize', async () => {
+  it('calls native presentOnboarding with accountId, capabilities, and null merchantId after initialize on iOS', async () => {
+    mockPlatform.OS = 'ios';
     await initialize({ secretKey: 'sk_xxx', publishableKey: 'pk_xxx' });
     const result = await presentOnboarding({ accountId: 'acct_1', capabilities: ['kyc', 'bank_account_verification'] });
-    expect(mockPresentOnboarding).toHaveBeenCalledWith('acct_1', ['kyc', 'bank_account_verification']);
+    expect(mockPresentOnboarding).toHaveBeenCalledWith('acct_1', ['kyc', 'bank_account_verification'], null);
     expect(result).toEqual({ status: 'completed', paymentMethodId: 'pm_1' });
   });
 
-  it('passes null for accountId and empty array for capabilities when not provided', async () => {
+  it('passes null for accountId and empty array for capabilities when not provided on iOS', async () => {
+    mockPlatform.OS = 'ios';
     await initialize({ secretKey: 'sk_xxx', publishableKey: 'pk_xxx' });
     await presentOnboarding({});
-    expect(mockPresentOnboarding).toHaveBeenCalledWith(null, []);
+    expect(mockPresentOnboarding).toHaveBeenCalledWith(null, [], null);
   });
 
-  it('routes to presentOnboardingWithApplePay on iOS when applePayMerchantId is set', async () => {
+  it('forwards applePayMerchantId on iOS', async () => {
     mockPlatform.OS = 'ios';
     await initialize({ secretKey: 'sk_xxx', publishableKey: 'pk_xxx' });
     await presentOnboarding({ accountId: 'acct_1', capabilities: ['kyc'], applePayMerchantId: 'merchant.com.example' });
-    expect(mockPresentOnboardingWithApplePay).toHaveBeenCalledWith('acct_1', ['kyc'], 'merchant.com.example');
-    expect(mockPresentOnboarding).not.toHaveBeenCalled();
+    expect(mockPresentOnboarding).toHaveBeenCalledWith('acct_1', ['kyc'], 'merchant.com.example');
   });
 
-  it('still routes to presentOnboarding on Android even when applePayMerchantId is set', async () => {
+  it('ignores applePayMerchantId on Android', async () => {
     mockPlatform.OS = 'android';
     await initialize({ secretKey: 'sk_xxx', publishableKey: 'pk_xxx' });
     await presentOnboarding({ accountId: 'acct_1', capabilities: ['kyc'], applePayMerchantId: 'merchant.com.example' });
     expect(mockPresentOnboarding).toHaveBeenCalledWith('acct_1', ['kyc'], null);
-    expect(mockPresentOnboardingWithApplePay).not.toHaveBeenCalled();
   });
 
   it('forwards googlePayMerchantId to native presentOnboarding on Android', async () => {
@@ -181,10 +178,10 @@ describe('presentOnboarding', () => {
     expect(mockPresentOnboarding).toHaveBeenCalledWith('acct_1', ['kyc'], 'BCR2DN4T...');
   });
 
-  it('does not forward googlePayMerchantId to native presentOnboarding on iOS', async () => {
+  it('ignores googlePayMerchantId on iOS', async () => {
     mockPlatform.OS = 'ios';
     await initialize({ secretKey: 'sk_xxx', publishableKey: 'pk_xxx' });
     await presentOnboarding({ accountId: 'acct_1', capabilities: ['kyc'], googlePayMerchantId: 'BCR2DN4T...' });
-    expect(mockPresentOnboarding).toHaveBeenCalledWith('acct_1', ['kyc']);
+    expect(mockPresentOnboarding).toHaveBeenCalledWith('acct_1', ['kyc'], null);
   });
 });

package/src/index.ts

@@ -15,7 +15,6 @@ import {
   presentOnboarding,
   presentApplePay,
   presentGooglePay,
-  setTheme,
 } from './native';
 
 export {
@@ -25,7 +24,6 @@ export {
   presentOnboarding,
   presentApplePay,
   presentGooglePay,
-  setTheme,
 } from './native';
 export type {
   FrameCartItem,
@@ -53,7 +51,7 @@ export type {
 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() */
 export default {
   initialize,
   presentCheckout,
@@ -61,5 +59,4 @@ export default {
   presentOnboarding,
   presentApplePay,
   presentGooglePay,
-  setTheme,
 };

package/src/native.ts

@@ -14,6 +14,9 @@ import type {
 } from './types';
 import { ErrorCodes } from './errors';
 
+// 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).`;
 
@@ -34,6 +37,13 @@ export 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> {
   if (!options?.secretKey) {
     throw new Error('Frame.initialize requires secretKey');
@@ -41,11 +51,15 @@ export function initialize(options: {
   if (!options?.publishableKey) {
     throw new Error('Frame.initialize requires publishableKey');
   }
+  if (options.theme !== undefined && (typeof options.theme !== 'object' || Array.isArray(options.theme))) {
+    throw new Error('Frame.initialize: theme must be an object');
+  }
   return wrapPromise(
     FrameSDK.initialize(
       options.secretKey,
       options.publishableKey,
-      options.debugMode ?? false
+      options.debugMode ?? false,
+      options.theme ?? null
     )
   ).then(() => {
     isInitialized = true;
@@ -106,20 +120,12 @@ export function presentOnboarding(options: {
   googlePayMerchantId?: string | null;
 }): Promise<OnboardingResult> {
   guardInitialized();
-  if (Platform.OS === 'ios' && options.applePayMerchantId) {
-    return wrapPromise(
-      FrameSDK.presentOnboardingWithApplePay(
-        options.accountId ?? null,
-        options.capabilities ?? [],
-        options.applePayMerchantId
-      )
-    );
-  }
   if (Platform.OS === 'ios') {
     return wrapPromise(
       FrameSDK.presentOnboarding(
         options.accountId ?? null,
-        options.capabilities ?? []
+        options.capabilities ?? [],
+        options.applePayMerchantId ?? null
       )
     );
   }
@@ -166,18 +172,3 @@ export function presentGooglePay(options: PresentGooglePayOptions): Promise<Char
   );
 }
 
-/**
- * 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.
- *
- * Pass `null` or `{}` to reset to SDK defaults. Android is a no-op until
- * frame-android ships a matching theme API.
- */
-export function setTheme(theme: FrameTheme | null): Promise<void> {
-  if (theme !== null && (typeof theme !== 'object' || Array.isArray(theme))) {
-    throw new Error('Frame.setTheme requires a theme object or null');
-  }
-  if (Platform.OS !== 'ios') return Promise.resolve();
-  return wrapPromise(FrameSDK.setTheme(theme ?? {}));
-}