framepayments-react-native 1.0.0 → 2.0.0

package/lib/__tests__/native.test.js

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

package/lib/index.d.ts

@@ -1,12 +1,22 @@
 /**
- * @framepayments/react-native-frame
+ * framepayments-react-native
  *
  * 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.
  */
-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(), 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;AACpE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;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

@@ -1,9 +1,13 @@
 /**
- * @framepayments/react-native-frame
+ * framepayments-react-native
  *
  * 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.
  */
-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(), Frame.presentCart(), Frame.presentOnboarding() */
+export default { initialize, presentCheckout, presentCart, presentOnboarding };

package/lib/native.d.ts

@@ -1,11 +1,11 @@
 /**
  * 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;
-}): void;
+}): Promise<void>;
 export declare function presentCheckout(options: {
     customerId?: string | null;
     amount: number;
@@ -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,IAAI,CAMjF;AAwBD,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACvC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,YAAY,CAAC,CAKxB;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE;IACnC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC;CAC/B,GAAG,OAAO,CAAC,YAAY,CAAC,CASxB"}
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,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

@@ -3,7 +3,7 @@
  */
 import { NativeModules } from 'react-native';
 import { ErrorCodes } from './errors';
-const LINKING_ERROR = `The package '@framepayments/react-native-frame' doesn't seem to be linked. Make sure you have run 'pod install' (iOS) or rebuilt the app (Android).`;
+const LINKING_ERROR = `The package 'framepayments-react-native' doesn't seem to be linked. Make sure you have run 'pod install' (iOS) or rebuilt the app (Android).`;
 const FrameSDK = NativeModules.FrameSDK
     ? NativeModules.FrameSDK
     : new Proxy({}, {
@@ -16,12 +16,13 @@ export function initialize(options) {
     if (!options?.apiKey) {
         throw new Error('Frame.initialize requires apiKey');
     }
-    FrameSDK.initialize(options.apiKey, options.debugMode ?? false);
-    isInitialized = true;
+    return wrapPromise(FrameSDK.initialize(options.apiKey, options.debugMode ?? false)).then(() => {
+        isInitialized = true;
+    });
 }
 function guardInitialized() {
     if (!isInitialized) {
-        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;
@@ -47,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.0",
+  "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",
@@ -28,9 +28,9 @@
   },
   "homepage": "https://github.com/Frame-Payments/frame-react-native#readme",
   "peerDependencies": {
+    "framepayments": "*",
     "react": "*",
-    "react-native": ">=0.72.0",
-    "framepayments": "*"
+    "react-native": ">=0.74.0"
   },
   "peerDependenciesMeta": {
     "framepayments": {
@@ -38,15 +38,15 @@
     }
   },
   "devDependencies": {
-    "eslint": "^8.57.0",
+    "@types/jest": "^29.5.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",
-    "@types/jest": "^29.5.0",
-    "@types/react": "^18.2.0",
-    "@types/react-native": "^0.72.0",
+    "eslint": "^8.57.0",
     "jest": "^29.7.0",
-    "react": "18.2.0",
-    "react-native": "0.72.0",
+    "react": "19.1.1",
+    "react-native": "^0.82.1",
     "ts-jest": "^29.1.0",
     "typescript": "^5.0.0"
   },
@@ -60,5 +60,8 @@
     "android",
     "README.md",
     "LICENSE"
-  ]
+  ],
+  "dependencies": {
+    "@babel/runtime": "^7.28.6"
+  }
 }

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

@@ -1,12 +1,31 @@
 /**
- * @framepayments/react-native-frame
+ * framepayments-react-native
  *
  * 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.
  */
 
-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(), Frame.presentCart(), Frame.presentOnboarding() */
+export default { initialize, presentCheckout, presentCart, presentOnboarding };

package/src/native.ts

@@ -3,11 +3,11 @@
  */
 
 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 =
-  `The package '@framepayments/react-native-frame' doesn't seem to be linked. Make sure you have run 'pod install' (iOS) or rebuilt the app (Android).`;
+  `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
@@ -22,18 +22,21 @@ const FrameSDK = NativeModules.FrameSDK
 
 let isInitialized = false;
 
-export function initialize(options: { apiKey: string; debugMode?: boolean }): void {
+export function initialize(options: { apiKey: string; debugMode?: boolean }): Promise<void> {
   if (!options?.apiKey) {
     throw new Error('Frame.initialize requires apiKey');
   }
-  FrameSDK.initialize(options.apiKey, options.debugMode ?? false);
-  isInitialized = true;
+  return wrapPromise(
+    FrameSDK.initialize(options.apiKey, options.debugMode ?? false)
+  ).then(() => {
+    isInitialized = true;
+  });
 }
 
 function guardInitialized(): 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;
@@ -76,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 ?? []
+    )
+  );
+}