framepayments-react-native 1.0.1 → 2.0.1

package/lib/components/FrameGooglePayButton.js

@@ -0,0 +1,24 @@
+/**
+ * <FrameGooglePayButton /> — Android-only React Native view that wraps Frame Android SDK's
+ * native FrameGooglePayButton (Google Pay PaymentsClient + readiness check).
+ *
+ * On non-Android platforms this component renders nothing, so consumers can place it
+ * unconditionally in their JSX.
+ */
+import * as React from 'react';
+import { Platform, StyleSheet, requireNativeComponent, } from 'react-native';
+const NativeFrameGooglePayButton = Platform.OS === 'android'
+    ? requireNativeComponent('FrameGooglePayButtonView')
+    : null;
+export const FrameGooglePayButton = (props) => {
+    if (Platform.OS !== 'android' || NativeFrameGooglePayButton === null) {
+        return null;
+    }
+    const { style, ...rest } = props;
+    return (<NativeFrameGooglePayButton {...rest} style={[styles.button, style]}/>);
+};
+const styles = StyleSheet.create({
+    button: {
+        height: 48,
+    },
+});

package/lib/components/index.d.ts

@@ -0,0 +1,5 @@
+export { FrameApplePayButton } from './FrameApplePayButton';
+export type { FrameApplePayButtonProps } from './FrameApplePayButton';
+export { FrameGooglePayButton } from './FrameGooglePayButton';
+export type { FrameGooglePayButtonProps } from './FrameGooglePayButton';
+//# sourceMappingURL=index.d.ts.map

package/lib/components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC"}

package/lib/components/index.js

@@ -0,0 +1,2 @@
+export { FrameApplePayButton } from './FrameApplePayButton';
+export { FrameGooglePayButton } from './FrameGooglePayButton';

package/lib/index.d.ts

@@ -3,18 +3,23 @@
  *
  * 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.
+ * - 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 } from './native';
-export { initialize, presentCheckout, presentCart } from './native';
-export type { FrameCartItem, ChargeIntent, FrameError } from './types';
+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, } 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(), Frame.presentApplePay(), Frame.presentGooglePay() */
 declare const _default: {
     initialize: typeof initialize;
     presentCheckout: typeof presentCheckout;
     presentCart: typeof presentCart;
+    presentOnboarding: typeof presentOnboarding;
+    presentApplePay: typeof presentApplePay;
+    presentGooglePay: typeof presentGooglePay;
 };
 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;;;;;;;;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,GACxB,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

@@ -3,10 +3,19 @@
  *
  * 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.
+ * - 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 } from './native';
-export { initialize, presentCheckout, presentCart } 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(), etc. */
-export default { initialize, presentCheckout, presentCart };
+/** Default export for Frame.initialize(), Frame.presentCheckout(), Frame.presentCart(), Frame.presentOnboarding(), Frame.presentApplePay(), Frame.presentGooglePay() */
+export default {
+    initialize,
+    presentCheckout,
+    presentCart,
+    presentOnboarding,
+    presentApplePay,
+    presentGooglePay,
+};

package/lib/native.d.ts

@@ -1,9 +1,10 @@
 /**
  * Native module bridge. Uses NativeModules for classic React Native bridge.
  */
-import type { ChargeIntent, FrameCartItem } from './types';
+import type { ChargeIntent, FrameCartItem, OnboardingCapability, OnboardingResult, PresentApplePayOptions, PresentGooglePayOptions } from './types';
 export declare function initialize(options: {
-    apiKey: string;
+    secretKey: string;
+    publishableKey: string;
     debugMode?: boolean;
 }): Promise<void>;
 export declare function presentCheckout(options: {
@@ -15,4 +16,10 @@ export declare function presentCart(options: {
     items: FrameCartItem[];
     shippingAmountInCents: number;
 }): Promise<ChargeIntent>;
+export declare function presentOnboarding(options: {
+    accountId?: string | null;
+    capabilities?: OnboardingCapability[];
+}): Promise<OnboardingResult>;
+export declare function presentApplePay(options: PresentApplePayOptions): Promise<ChargeIntent>;
+export declare function presentGooglePay(options: PresentGooglePayOptions): Promise<ChargeIntent>;
 //# 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,EACV,YAAY,EACZ,aAAa,EACb,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;CACvC,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAQ5B;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

@@ -13,16 +13,19 @@ const FrameSDK = NativeModules.FrameSDK
     });
 let isInitialized = false;
 export function initialize(options) {
-    if (!options?.apiKey) {
-        throw new Error('Frame.initialize requires apiKey');
+    if (!options?.secretKey) {
+        throw new Error('Frame.initialize requires secretKey');
     }
-    return wrapPromise(FrameSDK.initialize(options.apiKey, options.debugMode ?? false)).then(() => {
+    if (!options?.publishableKey) {
+        throw new Error('Frame.initialize requires publishableKey');
+    }
+    return wrapPromise(FrameSDK.initialize(options.secretKey, options.publishableKey, 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;
@@ -48,3 +51,24 @@ 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 ?? []));
+}
+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 }');
+    }
+    if (!options.owner.id) {
+        throw new Error('Frame.presentApplePay requires owner.id');
+    }
+    if (!options.merchantId) {
+        throw new Error('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));
+}

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,43 @@ 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;
+}
+/** Identifies who the Apple Pay payment method belongs to. */
+export type ApplePayOwner = {
+    type: 'customer';
+    id: string;
+} | {
+    type: 'account';
+    id: string;
+};
+/** Options for Frame.presentApplePay. */
+export interface PresentApplePayOptions {
+    /** Payment amount in cents. */
+    amount: number;
+    /** ISO 4217 currency code. Defaults to 'usd'. */
+    currency?: string;
+    /** Customer or account that owns the resulting payment method. */
+    owner: ApplePayOwner;
+    /** Apple Pay merchant ID configured in your Apple Developer account. */
+    merchantId: string;
+}
+/** Options for Frame.presentGooglePay. */
+export interface PresentGooglePayOptions {
+    /** Payment amount in cents. */
+    amountCents: number;
+    /** Optional Frame customer ID to associate the resulting payment method with. */
+    customerId?: string | null;
+    /** ISO 4217 currency code. Defaults to 'USD'. */
+    currencyCode?: string;
+    /** Optional override for the Google Pay merchant ID. */
+    googlePayMerchantId?: 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.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",
@@ -28,25 +28,19 @@
   },
   "homepage": "https://github.com/Frame-Payments/frame-react-native#readme",
   "peerDependencies": {
-    "framepayments": "*",
     "react": "*",
-    "react-native": ">=0.72.0"
-  },
-  "peerDependenciesMeta": {
-    "framepayments": {
-      "optional": true
-    }
+    "react-native": ">=0.74.0"
   },
   "devDependencies": {
     "@types/jest": "^29.5.0",
-    "@types/react": "^18.2.0",
-    "@types/react-native": "^0.72.0",
-    "@typescript-eslint/eslint-plugin": "^6.21.0",
-    "@typescript-eslint/parser": "^6.21.0",
+    "@types/react": "^19.1.1",
+    "@types/react-native": "^0.73.0",
+    "@typescript-eslint/eslint-plugin": "^8.59.1",
+    "@typescript-eslint/parser": "^8.59.1",
     "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"
   },
@@ -62,6 +56,7 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@babel/runtime": "^7.28.6"
+    "@babel/runtime": "^7.28.6",
+    "framepayments": "^2.0.0"
   }
 }

package/src/__tests__/native.test.ts

@@ -3,9 +3,10 @@
  * NativeModules.FrameSDK is mocked.
  */
 
-const mockInitialize = jest.fn((_apiKey: string, _debugMode: boolean) => Promise.resolve());
+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' }));
 
 jest.mock('react-native', () => ({
   NativeModules: {
@@ -13,45 +14,55 @@ 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: { secretKey: string; publishableKey: 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', () => {
-  it('calls native FrameSDK.initialize with apiKey and debugMode', () => {
-    initialize({ apiKey: 'sk_test_xxx', debugMode: true });
+  it('calls native FrameSDK.initialize with secretKey, publishableKey, and debugMode', () => {
+    initialize({ secretKey: 'sk_test_xxx', publishableKey: 'pk_test_xxx', debugMode: true });
     expect(mockInitialize).toHaveBeenCalledTimes(1);
-    expect(mockInitialize).toHaveBeenCalledWith('sk_test_xxx', true);
+    expect(mockInitialize).toHaveBeenCalledWith('sk_test_xxx', 'pk_test_xxx', true);
   });
 
   it('defaults debugMode to false', () => {
-    initialize({ apiKey: 'sk_test_yyy' });
-    expect(mockInitialize).toHaveBeenCalledWith('sk_test_yyy', false);
+    initialize({ secretKey: 'sk_test_yyy', publishableKey: 'pk_test_yyy' });
+    expect(mockInitialize).toHaveBeenCalledWith('sk_test_yyy', 'pk_test_yyy', false);
   });
 
-  it('throws if apiKey is missing', () => {
-    expect(() => initialize({ apiKey: '' })).toThrow();
-    expect(() => (initialize as any)({})).toThrow();
+  it('throws if secretKey is missing', () => {
+    expect(() => initialize({ secretKey: '', publishableKey: 'pk_test' })).toThrow(/secretKey/);
+    expect(() => (initialize as any)({ publishableKey: 'pk_test' })).toThrow(/secretKey/);
+    expect(mockInitialize).not.toHaveBeenCalled();
+  });
+
+  it('throws if publishableKey is missing', () => {
+    expect(() => initialize({ secretKey: 'sk_test', publishableKey: '' })).toThrow(/publishableKey/);
+    expect(() => (initialize as any)({ secretKey: 'sk_test' })).toThrow(/publishableKey/);
     expect(mockInitialize).not.toHaveBeenCalled();
   });
 });
@@ -69,14 +80,14 @@ describe('presentCheckout', () => {
   });
 
   it('calls native presentCheckout with customerId and amount after initialize', async () => {
-    initialize({ apiKey: 'sk_xxx' });
+    await initialize({ secretKey: 'sk_xxx', publishableKey: 'pk_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({ secretKey: 'sk_xxx', publishableKey: 'pk_xxx' });
     await presentCheckout({ amount: 5000 });
     expect(mockPresentCheckout).toHaveBeenCalledWith(null, 5000);
   });
@@ -98,7 +109,7 @@ describe('presentCart', () => {
   });
 
   it('calls native presentCart with customerId, items, shipping after initialize', async () => {
-    initialize({ apiKey: 'sk_xxx' });
+    await initialize({ secretKey: 'sk_xxx', publishableKey: 'pk_xxx' });
     const result = await presentCart({
       customerId: 'cus_2',
       items,
@@ -109,8 +120,34 @@ describe('presentCart', () => {
   });
 
   it('passes null for customerId when not provided', async () => {
-    initialize({ apiKey: 'sk_xxx' });
+    await initialize({ secretKey: 'sk_xxx', publishableKey: 'pk_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({ 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(result).toEqual({ status: 'completed', paymentMethodId: 'pm_1' });
+  });
+
+  it('passes null for accountId and empty array for capabilities when not provided', async () => {
+    await initialize({ secretKey: 'sk_xxx', publishableKey: 'pk_xxx' });
+    await presentOnboarding({});
+    expect(mockPresentOnboarding).toHaveBeenCalledWith(null, []);
+  });
+});

package/src/index.ts

@@ -3,15 +3,54 @@
  *
  * 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.
+ * - 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 } from './native';
+import {
+  initialize,
+  presentCheckout,
+  presentCart,
+  presentOnboarding,
+  presentApplePay,
+  presentGooglePay,
+} from './native';
 
-export { initialize, presentCheckout, presentCart } from './native';
-export type { FrameCartItem, ChargeIntent, FrameError } from './types';
+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,
+} 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(), Frame.presentApplePay(), Frame.presentGooglePay() */
+export default {
+  initialize,
+  presentCheckout,
+  presentCart,
+  presentOnboarding,
+  presentApplePay,
+  presentGooglePay,
+};