framepayments-react-native 1.0.1 → 2.0.0

package/ios/FrameSDKBridge.swift

@@ -10,6 +10,7 @@ import React
 import UIKit
 import SwiftUI
 import Frame
+import FrameOnboarding
 
 @objc(ObjCFrameSDKBridge)
 public class FrameSDKBridge: NSObject {
@@ -40,13 +41,22 @@ public class FrameSDKBridge: NSObject {
     presentCartOnMain(from: viewController, customerId: customerId as? String, cartItems: cartItems, shippingAmountInCents: shippingAmountInCents, resolve: resolve, reject: reject)
   }
 
+  @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, resolve: resolve, reject: reject)
+  }
+
+  // MARK: - Private helpers
+
   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(
+    var hosting: CheckoutHostingController!
+    hosting = CheckoutHostingController(rootView: FrameCheckoutView(
       customerId: customerId,
       paymentAmount: amount,
-      checkoutCallback: { [weak delegate] chargeIntent in
-        delegate?.didComplete = true
+      checkoutCallback: { [weak hosting] chargeIntent in
+        hosting?.didComplete = true
         top.dismiss(animated: true)
         DispatchQueue.main.async {
           if let dict = Self.encodeChargeIntent(chargeIntent) {
@@ -56,15 +66,19 @@ public class FrameSDKBridge: NSObject {
           }
         }
       }
-    )
-    let hosting = UIHostingController(rootView: checkoutView)
+    ))
+    hosting.onCancel = {
+      DispatchQueue.main.async {
+        reject("USER_CANCELED", "User dismissed checkout without completing payment", nil)
+      }
+    }
     hosting.modalPresentationStyle = UIModalPresentationStyle.pageSheet
     if let sheet = hosting.sheetPresentationController {
       sheet.detents = [UISheetPresentationController.Detent.large()]
     }
-    objc_setAssociatedObject(hosting, &checkoutDismissKey, delegate, .OBJC_ASSOCIATION_RETAIN)
-    hosting.presentationController?.delegate = delegate
-    top.present(hosting, animated: true)
+    top.present(hosting, animated: true) {
+      hosting.presentationController?.delegate = hosting
+    }
   }
 
   private static func encodeChargeIntent(_ intent: FrameObjects.ChargeIntent) -> [String: Any]? {
@@ -92,6 +106,16 @@ public class FrameSDKBridge: NSObject {
     return result
   }
 
+  private func parseCapabilities(_ capabilities: NSArray) -> [FrameObjects.Capabilities] {
+    var result: [FrameObjects.Capabilities] = []
+    for item in capabilities {
+      guard let raw = item as? String,
+            let cap = FrameObjects.Capabilities(rawValue: raw) else { continue }
+      result.append(cap)
+    }
+    return result
+  }
+
   private func presentCartOnMain(from top: UIViewController, customerId: String?, cartItems: [RNFrameCartItem], shippingAmountInCents: Int, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
     let cartView = FrameCartView(
       customer: nil,
@@ -106,27 +130,81 @@ public class FrameSDKBridge: NSObject {
     // 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)
-    hosting.presentationController?.delegate = delegate
-    top.present(hosting, animated: true)
+    top.present(hosting, animated: true) {
+      hosting.presentationController?.delegate = delegate
+    }
+  }
+
+  private func presentOnboardingOnMain(from top: UIViewController, accountId: String?, capabilities: [FrameObjects.Capabilities], resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
+    let hosting = OnboardingHostingController(
+      rootView: OnboardingContainerView(
+        accountId: accountId,
+        requiredCapabilities: capabilities
+      )
+    )
+    hosting.modalPresentationStyle = UIModalPresentationStyle.pageSheet
+    if let sheet = hosting.sheetPresentationController {
+      sheet.detents = [UISheetPresentationController.Detent.large()]
+    }
+    let delegate = OnboardingDismissDelegate(hosting: hosting, resolve: resolve)
+    objc_setAssociatedObject(hosting, &onboardingDismissKey, delegate, .OBJC_ASSOCIATION_RETAIN)
+    hosting.onProgrammaticDismiss = { [weak delegate] in
+      delegate?.finish(completed: true)
+    }
+    top.present(hosting, animated: true) {
+      hosting.presentationController?.delegate = delegate
+    }
   }
 }
 
-private final class CheckoutDismissDelegate: NSObject, UIAdaptivePresentationControllerDelegate {
-  let resolve: RCTPromiseResolveBlock
-  let reject: RCTPromiseRejectBlock
+// MARK: - CheckoutHostingController
+// Intercepts both dismiss paths for FrameCheckoutView:
+//   1. Programmatic: SwiftUI's @Environment(\.dismiss) routes through override dismiss().
+//   2. Swipe-to-dismiss: UIAdaptivePresentationControllerDelegate.presentationControllerDidDismiss fires.
+// In both cases, if the checkout callback hasn't fired, we reject the promise.
+// onCancel is guarded by `cancelled` so it only fires once regardless of dismiss path.
+
+private final class CheckoutHostingController: UIHostingController<FrameCheckoutView>, UIAdaptivePresentationControllerDelegate {
   var didComplete = false
-  init(resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
-    self.resolve = resolve
-    self.reject = reject
+  var onCancel: (() -> Void)?
+  private var cancelled = false
+
+  func cancel() {
+    guard !didComplete, !cancelled else { return }
+    cancelled = true
+    onCancel?()
+  }
+
+  override func dismiss(animated flag: Bool, completion: (() -> Void)? = nil) {
+    cancel()
+    super.dismiss(animated: flag, completion: completion)
   }
+
   func presentationControllerDidDismiss(_ presentationController: UIPresentationController) {
-    guard !didComplete else { return }
-    DispatchQueue.main.async { [reject] in
-      reject("USER_CANCELED", "User dismissed checkout without completing payment", nil)
-    }
+    cancel()
+  }
+}
+
+// MARK: - OnboardingHostingController
+// Subclass UIHostingController to intercept programmatic dismiss() calls from OnboardingContainerView.
+// When SwiftUI calls @Environment(\.dismiss), it routes through UIHostingController.dismiss(animated:).
+// We override this to set programmaticDismiss = true before forwarding.
+
+private final class OnboardingHostingController<V: View>: UIHostingController<V> {
+  var programmaticDismiss = false
+  var onProgrammaticDismiss: (() -> Void)?
+
+  override func dismiss(animated flag: Bool, completion: (() -> Void)? = nil) {
+    programmaticDismiss = true
+    super.dismiss(animated: flag, completion: { [weak self] in
+      self?.onProgrammaticDismiss?()
+      completion?()
+    })
   }
 }
 
+// MARK: - Delegates
+
 private final class CartDismissDelegate: NSObject, UIAdaptivePresentationControllerDelegate {
   let resolve: RCTPromiseResolveBlock
   init(resolve: @escaping RCTPromiseResolveBlock) { self.resolve = resolve }
@@ -137,6 +215,26 @@ private final class CartDismissDelegate: NSObject, UIAdaptivePresentationControl
   }
 }
 
-private var cartDismissKey: UInt8 = 0
-private var checkoutDismissKey: UInt8 = 0
+private final class OnboardingDismissDelegate: NSObject, UIAdaptivePresentationControllerDelegate {
+  let resolve: RCTPromiseResolveBlock
+  var didFinish = false
+
+  init(hosting: OnboardingHostingController<OnboardingContainerView>, resolve: @escaping RCTPromiseResolveBlock) {
+    self.resolve = resolve
+  }
+
+  func finish(completed: Bool) {
+    guard !didFinish else { return }
+    didFinish = true
+    DispatchQueue.main.async { [resolve, completed] in
+      resolve(["status": completed ? "completed" : "cancelled"])
+    }
+  }
+
+  func presentationControllerDidDismiss(_ presentationController: UIPresentationController) {
+    finish(completed: false)
+  }
+}
 
+private var cartDismissKey: UInt8 = 0
+private var onboardingDismissKey: UInt8 = 0

package/lib/index.d.ts

@@ -3,18 +3,20 @@
  *
  * React Native SDK for Frame Payments.
  * - Initialize the SDK, then use presentCheckout / presentCart for payment UI.
+ * - Use presentOnboarding for KYC, identity verification, and payment method onboarding flows.
  * - 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';
+import { initialize, presentCheckout, presentCart, presentOnboarding } from './native';
+export { initialize, presentCheckout, presentCart, presentOnboarding } from './native';
+export type { FrameCartItem, ChargeIntent, ChargeIntentStatus, AuthorizationMode, FrameError, BillingAddress, PaymentCard, BankAccount, PaymentMethod, OnboardingCapability, OnboardingResult, OnboardingResultStatus, } from './types';
 export { ErrorCodes } from './errors';
 export type { FrameErrorShape, FrameErrorCode } from './errors';
-/** Default export for Frame.initialize(), Frame.presentCheckout(), etc. */
+/** Default export for Frame.initialize(), Frame.presentCheckout(), Frame.presentCart(), Frame.presentOnboarding() */
 declare const _default: {
     initialize: typeof initialize;
     presentCheckout: typeof presentCheckout;
     presentCart: typeof presentCart;
+    presentOnboarding: typeof presentOnboarding;
 };
 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;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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAEvF,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACvF,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,GACvB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAEhE,qHAAqH;;;;;;;AACrH,wBAA+E"}

package/lib/index.js

@@ -3,10 +3,11 @@
  *
  * React Native SDK for Frame Payments.
  * - Initialize the SDK, then use presentCheckout / presentCart for payment UI.
+ * - Use presentOnboarding for KYC, identity verification, and payment method onboarding flows.
  * - 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';
+import { initialize, presentCheckout, presentCart, presentOnboarding } from './native';
+export { initialize, presentCheckout, presentCart, presentOnboarding } from './native';
 export { ErrorCodes } from './errors';
-/** Default export for Frame.initialize(), Frame.presentCheckout(), etc. */
-export default { initialize, presentCheckout, presentCart };
+/** Default export for Frame.initialize(), Frame.presentCheckout(), Frame.presentCart(), Frame.presentOnboarding() */
+export default { initialize, presentCheckout, presentCart, presentOnboarding };

package/lib/native.d.ts

@@ -1,7 +1,7 @@
 /**
  * Native module bridge. Uses NativeModules for classic React Native bridge.
  */
-import type { ChargeIntent, FrameCartItem } from './types';
+import type { ChargeIntent, FrameCartItem, OnboardingCapability, OnboardingResult } from './types';
 export declare function initialize(options: {
     apiKey: string;
     debugMode?: boolean;
@@ -15,4 +15,8 @@ export declare function presentCart(options: {
     items: FrameCartItem[];
     shippingAmountInCents: number;
 }): Promise<ChargeIntent>;
+export declare function presentOnboarding(options: {
+    accountId?: string | null;
+    capabilities?: OnboardingCapability[];
+}): Promise<OnboardingResult>;
 //# 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,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"}
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAmBnG,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;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IACzC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,CAAC,EAAE,oBAAoB,EAAE,CAAC;CACvC,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAQ5B"}

package/lib/native.js

@@ -22,7 +22,7 @@ export function initialize(options) {
 }
 function guardInitialized() {
     if (!isInitialized) {
-        const message = 'Frame SDK must be initialized before calling presentCheckout or presentCart. Call Frame.initialize({ apiKey }) first.';
+        const message = 'Frame SDK must be initialized before calling presentCheckout, presentCart, or presentOnboarding. Call Frame.initialize({ apiKey }) first.';
         const err = new Error(message);
         err.code = ErrorCodes.NOT_INITIALIZED;
         throw err;
@@ -48,3 +48,7 @@ export function presentCart(options) {
     guardInitialized();
     return wrapPromise(FrameSDK.presentCart(options.customerId ?? null, options.items, options.shippingAmountInCents));
 }
+export function presentOnboarding(options) {
+    guardInitialized();
+    return wrapPromise(FrameSDK.presentOnboarding(options.accountId ?? null, options.capabilities ?? []));
+}

package/lib/types.d.ts

@@ -9,23 +9,79 @@ export interface FrameCartItem {
     amountInCents: number;
     imageUrl: string;
 }
+export type ChargeIntentStatus = 'canceled' | 'disputed' | 'failed' | 'incomplete' | 'pending' | 'refunded' | 'reversed' | 'succeeded';
+export type AuthorizationMode = 'automatic' | 'manual';
+export interface BillingAddress {
+    city?: string;
+    country?: string;
+    state?: string;
+    postalCode: string;
+    addressLine1?: string;
+    addressLine2?: string;
+}
+export interface PaymentCard {
+    brand: string;
+    expirationMonth: string;
+    expirationYear: string;
+    lastFourDigits: string;
+    issuer?: string;
+    currency?: string;
+    type?: string;
+}
+export interface BankAccount {
+    bankName?: string;
+    lastFour?: string;
+    accountType?: string;
+}
+export interface PaymentMethod {
+    id: string;
+    type: 'card' | 'ach';
+    status: string;
+    created: number;
+    updated: number;
+    livemode: boolean;
+    object: string;
+    customerId?: string;
+    card?: PaymentCard;
+    ach?: BankAccount;
+    billing?: BillingAddress;
+}
+export interface Customer {
+    id: string;
+    object: string;
+    created: number;
+    updated: number;
+    livemode: boolean;
+    name?: string;
+    email?: string;
+    phone?: string;
+}
+export interface Charge {
+    id: string;
+    object: string;
+    amount: number;
+    currency: string;
+    status: string;
+    created: number;
+    livemode: boolean;
+}
 /** Charge intent returned from presentCheckout / presentCart */
 export interface ChargeIntent {
     id: string;
     currency: string;
     amount: number;
-    status: string;
+    status: ChargeIntentStatus;
     created: number;
     updated: number;
     livemode: boolean;
     object: string;
     description?: string;
-    customer?: Record<string, unknown>;
-    payment_method?: Record<string, unknown>;
-    latest_charge?: Record<string, unknown>;
-    authorization_mode?: string;
-    failure_description?: string;
-    shipping?: Record<string, unknown>;
+    authorizationMode?: AuthorizationMode;
+    failureDescription?: string;
+    customer?: Customer;
+    paymentMethod?: PaymentMethod;
+    latestCharge?: Charge;
+    shipping?: BillingAddress;
 }
 /** Error shape when native module rejects (same as FrameErrorShape from errors.ts) */
 export interface FrameError {
@@ -33,4 +89,13 @@ export interface FrameError {
     message: string;
     nativeError?: string;
 }
+/** Capabilities that drive which onboarding steps are shown */
+export type OnboardingCapability = 'kyc' | 'kyc_prefill' | 'phone_verification' | 'creator_shield' | 'card_verification' | 'card_send' | 'card_receive' | 'address_verification' | 'bank_account_verification' | 'bank_account_send' | 'bank_account_receive' | 'geo_compliance' | 'age_verification';
+export type OnboardingResultStatus = 'completed' | 'cancelled';
+/** Result returned from presentOnboarding */
+export interface OnboardingResult {
+    status: OnboardingResultStatus;
+    /** Present when status === 'completed' and a payment method was created/verified */
+    paymentMethodId?: string;
+}
 //# sourceMappingURL=types.d.ts.map

package/lib/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,gEAAgE;AAChE,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,sFAAsF;AACtF,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "framepayments-react-native",
-  "version": "1.0.1",
+  "version": "2.0.0",
   "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",
@@ -30,7 +30,7 @@
   "peerDependencies": {
     "framepayments": "*",
     "react": "*",
-    "react-native": ">=0.72.0"
+    "react-native": ">=0.74.0"
   },
   "peerDependenciesMeta": {
     "framepayments": {
@@ -39,14 +39,14 @@
   },
   "devDependencies": {
     "@types/jest": "^29.5.0",
-    "@types/react": "^18.2.0",
-    "@types/react-native": "^0.72.0",
+    "@types/react": "^19.1.1",
+    "@types/react-native": "^0.73.0",
     "@typescript-eslint/eslint-plugin": "^6.21.0",
     "@typescript-eslint/parser": "^6.21.0",
     "eslint": "^8.57.0",
     "jest": "^29.7.0",
-    "react": "18.2.0",
-    "react-native": "^0.72.17",
+    "react": "19.1.1",
+    "react-native": "^0.82.1",
     "ts-jest": "^29.1.0",
     "typescript": "^5.0.0"
   },

package/src/__tests__/native.test.ts

@@ -6,6 +6,7 @@
 const mockInitialize = jest.fn((_apiKey: 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' }));
 
 jest.mock('react-native', () => ({
   NativeModules: {
@@ -13,28 +14,32 @@ jest.mock('react-native', () => ({
       initialize: mockInitialize,
       presentCheckout: mockPresentCheckout,
       presentCart: mockPresentCart,
+      presentOnboarding: mockPresentOnboarding,
     },
   },
 }));
 
 // Re-import after mock so we get the mocked NativeModules
-let initialize: (opts: { apiKey: string; debugMode?: boolean }) => void;
+let initialize: (opts: { apiKey: string; debugMode?: boolean }) => Promise<void>;
 let presentCheckout: (opts: { customerId?: string | null; amount: number }) => Promise<unknown>;
 let presentCart: (opts: {
   customerId?: string | null;
   items: Array<{ id: string; title: string; amountInCents: number; imageUrl: string }>;
   shippingAmountInCents: number;
 }) => Promise<unknown>;
+let presentOnboarding: (opts: { accountId?: string | null; capabilities?: string[] }) => Promise<unknown>;
 
 beforeEach(() => {
   jest.resetModules();
   mockInitialize.mockClear();
   mockPresentCheckout.mockClear();
   mockPresentCart.mockClear();
+  mockPresentOnboarding.mockClear();
   const native = require('../native');
   initialize = native.initialize;
   presentCheckout = native.presentCheckout;
   presentCart = native.presentCart;
+  presentOnboarding = native.presentOnboarding;
 });
 
 describe('initialize', () => {
@@ -69,14 +74,14 @@ describe('presentCheckout', () => {
   });
 
   it('calls native presentCheckout with customerId and amount after initialize', async () => {
-    initialize({ apiKey: 'sk_xxx' });
+    await 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 initialize({ apiKey: 'sk_xxx' });
     await presentCheckout({ amount: 5000 });
     expect(mockPresentCheckout).toHaveBeenCalledWith(null, 5000);
   });
@@ -98,7 +103,7 @@ describe('presentCart', () => {
   });
 
   it('calls native presentCart with customerId, items, shipping after initialize', async () => {
-    initialize({ apiKey: 'sk_xxx' });
+    await initialize({ apiKey: 'sk_xxx' });
     const result = await presentCart({
       customerId: 'cus_2',
       items,
@@ -109,8 +114,34 @@ describe('presentCart', () => {
   });
 
   it('passes null for customerId when not provided', async () => {
-    initialize({ apiKey: 'sk_xxx' });
+    await initialize({ apiKey: 'sk_xxx' });
     await presentCart({ items, shippingAmountInCents: 0 });
     expect(mockPresentCart).toHaveBeenCalledWith(null, items, 0);
   });
 });
+
+describe('presentOnboarding', () => {
+  it('throws NOT_INITIALIZED if initialize was not called', async () => {
+    try {
+      await presentOnboarding({});
+      expect(true).toBe(false);
+    } catch (e: any) {
+      expect(e.code).toBe('NOT_INITIALIZED');
+      expect(e.message).toContain('initialized');
+    }
+    expect(mockPresentOnboarding).not.toHaveBeenCalled();
+  });
+
+  it('calls native presentOnboarding with accountId and capabilities after initialize', async () => {
+    await initialize({ apiKey: 'sk_xxx' });
+    const result = await presentOnboarding({ accountId: 'acct_1', capabilities: ['kyc', 'bank_account_verification'] });
+    expect(mockPresentOnboarding).toHaveBeenCalledWith('acct_1', ['kyc', 'bank_account_verification']);
+    expect(result).toEqual({ status: 'completed', paymentMethodId: 'pm_1' });
+  });
+
+  it('passes null for accountId and empty array for capabilities when not provided', async () => {
+    await initialize({ apiKey: 'sk_xxx' });
+    await presentOnboarding({});
+    expect(mockPresentOnboarding).toHaveBeenCalledWith(null, []);
+  });
+});

package/src/index.ts

@@ -3,15 +3,29 @@
  *
  * React Native SDK for Frame Payments.
  * - Initialize the SDK, then use presentCheckout / presentCart for payment UI.
+ * - Use presentOnboarding for KYC, identity verification, and payment method onboarding flows.
  * - For API calls (customers, charge intents, refunds), use the framepayments (frame-node) package from JS.
  */
 
-import { initialize, presentCheckout, presentCart } from './native';
+import { initialize, presentCheckout, presentCart, presentOnboarding } from './native';
 
-export { initialize, presentCheckout, presentCart } from './native';
-export type { FrameCartItem, ChargeIntent, FrameError } from './types';
+export { initialize, presentCheckout, presentCart, presentOnboarding } from './native';
+export type {
+  FrameCartItem,
+  ChargeIntent,
+  ChargeIntentStatus,
+  AuthorizationMode,
+  FrameError,
+  BillingAddress,
+  PaymentCard,
+  BankAccount,
+  PaymentMethod,
+  OnboardingCapability,
+  OnboardingResult,
+  OnboardingResultStatus,
+} from './types';
 export { ErrorCodes } from './errors';
 export type { FrameErrorShape, FrameErrorCode } from './errors';
 
-/** Default export for Frame.initialize(), Frame.presentCheckout(), etc. */
-export default { initialize, presentCheckout, presentCart };
+/** Default export for Frame.initialize(), Frame.presentCheckout(), Frame.presentCart(), Frame.presentOnboarding() */
+export default { initialize, presentCheckout, presentCart, presentOnboarding };

package/src/native.ts

@@ -3,7 +3,7 @@
  */
 
 import { NativeModules } from 'react-native';
-import type { ChargeIntent, FrameCartItem } from './types';
+import type { ChargeIntent, FrameCartItem, OnboardingCapability, OnboardingResult } from './types';
 import { ErrorCodes } from './errors';
 
 const LINKING_ERROR =
@@ -36,7 +36,7 @@ export function initialize(options: { apiKey: string; debugMode?: boolean }): Pr
 function guardInitialized(): void {
   if (!isInitialized) {
     const message =
-      'Frame SDK must be initialized before calling presentCheckout or presentCart. Call Frame.initialize({ apiKey }) first.';
+      'Frame SDK must be initialized before calling presentCheckout, presentCart, or presentOnboarding. Call Frame.initialize({ apiKey }) first.';
     const err = new Error(message) as Error & { code: string };
     err.code = ErrorCodes.NOT_INITIALIZED;
     throw err;
@@ -79,3 +79,16 @@ export function presentCart(options: {
     )
   );
 }
+
+export function presentOnboarding(options: {
+  accountId?: string | null;
+  capabilities?: OnboardingCapability[];
+}): Promise<OnboardingResult> {
+  guardInitialized();
+  return wrapPromise(
+    FrameSDK.presentOnboarding(
+      options.accountId ?? null,
+      options.capabilities ?? []
+    )
+  );
+}