framepayments-react-native 2.1.1 → 2.1.3

package/lib/native.js

@@ -3,6 +3,16 @@
  */
 import { NativeModules, Platform } from 'react-native';
 import { ErrorCodes } from './errors';
+/**
+ * Throw a coded error from synchronous JS validation. Mirrors the `code`/`message`
+ * shape that native rejections produce so consumers can catch `e.code === 'INVALID_*'`
+ * uniformly.
+ */
+function throwCoded(code, message) {
+    const err = new Error(message);
+    err.code = code;
+    throw err;
+}
 // theme is iOS-only today: frame-android does not yet have a matching theme API,
 // so the field is accepted on both platforms but ignored on Android until it does.
 const LINKING_ERROR = `The package 'framepayments-react-native' doesn't seem to be linked. Make sure you have run 'pod install' (iOS) or rebuilt the app (Android).`;
@@ -16,13 +26,13 @@ const FrameSDK = NativeModules.FrameSDK
 let isInitialized = false;
 export function initialize(options) {
     if (!options?.secretKey) {
-        throw new Error('Frame.initialize requires secretKey');
+        throwCoded(ErrorCodes.INIT_FAILED, 'Frame.initialize requires secretKey');
     }
     if (!options?.publishableKey) {
-        throw new Error('Frame.initialize requires publishableKey');
+        throwCoded(ErrorCodes.INIT_FAILED, 'Frame.initialize requires publishableKey');
     }
     if (options.theme !== undefined && (typeof options.theme !== 'object' || Array.isArray(options.theme))) {
-        throw new Error('Frame.initialize: theme must be an object');
+        throwCoded(ErrorCodes.INIT_FAILED, 'Frame.initialize: theme must be an object');
     }
     return wrapPromise(FrameSDK.initialize(options.secretKey, options.publishableKey, options.debugMode ?? false, options.theme ?? null)).then(() => {
         isInitialized = true;
@@ -48,13 +58,34 @@ function wrapPromise(p) {
         throw Object.assign(new Error(message), { code, message });
     });
 }
+/**
+ * Presents the Frame checkout sheet for the given account. Resolves with the
+ * created Transfer's id string on success, or rejects with `USER_CANCELED` if
+ * the user dismisses the sheet.
+ *
+ * `accountId` is required: the bundled checkout creates a `Transfer`, which is
+ * account-scoped. Callers needing a customer/ChargeIntent flow should use
+ * `presentApplePay` / `presentGooglePay` directly with a customer owner.
+ */
 export function presentCheckout(options) {
     guardInitialized();
-    return wrapPromise(FrameSDK.presentCheckout(options.customerId ?? null, options.amount));
+    if (!options?.accountId) {
+        throwCoded(ErrorCodes.INVALID_ACCOUNT, 'Frame.presentCheckout requires accountId');
+    }
+    return wrapPromise(FrameSDK.presentCheckout(options.accountId, options.amount));
 }
+/**
+ * Presents the Frame cart UI; tapping checkout routes through the same flow
+ * as `presentCheckout` and resolves with the created Transfer's id string.
+ *
+ * `accountId` is required for the same reason as `presentCheckout`.
+ */
 export function presentCart(options) {
     guardInitialized();
-    return wrapPromise(FrameSDK.presentCart(options.customerId ?? null, options.items, options.shippingAmountInCents));
+    if (!options?.accountId) {
+        throwCoded(ErrorCodes.INVALID_ACCOUNT, 'Frame.presentCart requires accountId');
+    }
+    return wrapPromise(FrameSDK.presentCart(options.accountId, options.items, options.shippingAmountInCents));
 }
 export function presentOnboarding(options) {
     guardInitialized();
@@ -63,20 +94,41 @@ export function presentOnboarding(options) {
     }
     return wrapPromise(FrameSDK.presentOnboarding(options.accountId ?? null, options.capabilities ?? [], options.googlePayMerchantId ?? null));
 }
+/**
+ * Presents the Apple Pay sheet and creates a charge from the resulting wallet
+ * payment method. Resolves with the created resource's id string on success,
+ * or rejects with `USER_CANCELED` if the sheet is dismissed.
+ *
+ *  - `owner.type === 'customer'` → creates a `ChargeIntent`; resolves with its id.
+ *  - `owner.type === 'account'`  → creates a `Transfer`;     resolves with its id.
+ */
 export function presentApplePay(options) {
     guardInitialized();
     if (!options?.owner || (options.owner.type !== 'customer' && options.owner.type !== 'account')) {
-        throw new Error('Frame.presentApplePay requires owner: { type: "customer" | "account", id: string }');
+        throwCoded(ErrorCodes.INVALID_OWNER, 'Frame.presentApplePay requires owner: { type: "customer" | "account", id: string }');
     }
     if (!options.owner.id) {
-        throw new Error('Frame.presentApplePay requires owner.id');
+        throwCoded(ErrorCodes.INVALID_OWNER, 'Frame.presentApplePay requires owner.id');
     }
     if (!options.merchantId) {
-        throw new Error('Frame.presentApplePay requires merchantId');
+        throwCoded(ErrorCodes.INVALID_MERCHANT_ID, 'Frame.presentApplePay requires merchantId');
     }
     return wrapPromise(FrameSDK.presentApplePay(options.owner.type, options.owner.id, options.amount, options.currency ?? 'usd', options.merchantId));
 }
+/**
+ * Presents Google Pay and creates a charge from the resulting wallet payment method.
+ * Resolves with the created resource's id string on success.
+ *
+ *  - `owner.type === 'customer'` → creates a `ChargeIntent`; resolves with its id.
+ *  - `owner.type === 'account'`  → creates a `Transfer`;     resolves with its id.
+ */
 export function presentGooglePay(options) {
     guardInitialized();
-    return wrapPromise(FrameSDK.presentGooglePay(options.amountCents, options.customerId ?? null, options.currencyCode ?? 'USD', options.googlePayMerchantId ?? null));
+    if (!options?.owner || (options.owner.type !== 'customer' && options.owner.type !== 'account')) {
+        throwCoded(ErrorCodes.INVALID_OWNER, 'Frame.presentGooglePay requires owner: { type: "customer" | "account", id: string }');
+    }
+    if (!options.owner.id) {
+        throwCoded(ErrorCodes.INVALID_OWNER, 'Frame.presentGooglePay requires owner.id');
+    }
+    return wrapPromise(FrameSDK.presentGooglePay(options.amountCents, options.owner.type, options.owner.id, options.currencyCode ?? 'USD', options.googlePayMerchantId ?? null));
 }

package/lib/types.d.ts

@@ -9,8 +9,6 @@ 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;
@@ -46,43 +44,6 @@ export interface PaymentMethod {
     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: ChargeIntentStatus;
-    created: number;
-    updated: number;
-    livemode: boolean;
-    object: string;
-    description?: string;
-    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 {
     code: string;
@@ -98,22 +59,34 @@ export interface OnboardingResult {
     /** 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 = {
+/**
+ * Identifies who the wallet payment method belongs to and which downstream
+ * resource is created when the user authorizes payment. Used by both
+ * `presentApplePay` and `presentGooglePay`.
+ *
+ *  - `{ type: 'customer', id }` → creates a `ChargeIntent`; promise resolves with the ChargeIntent id.
+ *  - `{ type: 'account',  id }` → creates a `Transfer`;     promise resolves with the Transfer id.
+ *
+ * The promise always resolves with a string id; the caller knows which resource
+ * it refers to based on the owner type they passed in.
+ */
+export type WalletOwner = {
     type: 'customer';
     id: string;
 } | {
     type: 'account';
     id: string;
 };
+/** @deprecated Use {@link WalletOwner}. Retained as an alias for source compatibility. */
+export type ApplePayOwner = WalletOwner;
 /** 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;
+    /** Customer or account that owns the resulting payment method and charge. */
+    owner: WalletOwner;
     /** Apple Pay merchant ID configured in your Apple Developer account. */
     merchantId: string;
 }
@@ -121,8 +94,8 @@ export interface PresentApplePayOptions {
 export interface PresentGooglePayOptions {
     /** Payment amount in cents. */
     amountCents: number;
-    /** Optional Frame customer ID to associate the resulting payment method with. */
-    customerId?: string | null;
+    /** Customer or account that owns the resulting payment method and charge. */
+    owner: WalletOwner;
     /** ISO 4217 currency code. Defaults to 'USD'. */
     currencyCode?: string;
     /** Optional override for the Google Pay merchant ID. */

package/lib/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"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": "2.1.1",
+  "version": "2.1.3",
   "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",

package/src/__tests__/native.test.ts

@@ -1,11 +1,13 @@
 /**
- * Unit tests for the native module bridge (initialize, presentCheckout, presentCart).
- * NativeModules.FrameSDK is mocked.
+ * Unit tests for the native module bridge (initialize, presentCheckout, presentCart,
+ * presentApplePay, presentGooglePay, presentOnboarding). NativeModules.FrameSDK is mocked.
  */
 
 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 mockPresentCheckout = jest.fn((_accountId: unknown, _amount: number) => Promise.resolve('tr_1'));
+const mockPresentCart = jest.fn((_accountId: unknown, _items: unknown[], _shipping: number) => Promise.resolve('tr_2'));
+const mockPresentApplePay = jest.fn((_ownerType: string, _ownerId: string, _amount: number, _currency: string, _merchantId: string) => Promise.resolve('tr_3'));
+const mockPresentGooglePay = jest.fn((_amountCents: number, _ownerType: string, _ownerId: string, _currencyCode: string, _googlePayMerchantId: string | null) => Promise.resolve('tr_4'));
 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' };
@@ -16,6 +18,8 @@ jest.mock('react-native', () => ({
       initialize: mockInitialize,
       presentCheckout: mockPresentCheckout,
       presentCart: mockPresentCart,
+      presentApplePay: mockPresentApplePay,
+      presentGooglePay: mockPresentGooglePay,
       presentOnboarding: mockPresentOnboarding,
     },
   },
@@ -24,12 +28,14 @@ jest.mock('react-native', () => ({
 
 // Re-import after mock so we get the mocked NativeModules
 let initialize: (opts: { secretKey: string; publishableKey: string; debugMode?: boolean }) => Promise<void>;
-let presentCheckout: (opts: { customerId?: string | null; amount: number }) => Promise<unknown>;
+let presentCheckout: (opts: { accountId: string; amount: number }) => Promise<string>;
 let presentCart: (opts: {
-  customerId?: string | null;
+  accountId: string;
   items: Array<{ id: string; title: string; amountInCents: number; imageUrl: string }>;
   shippingAmountInCents: number;
-}) => Promise<unknown>;
+}) => Promise<string>;
+let presentApplePay: (opts: { amount: number; currency?: string; owner: { type: 'customer' | 'account'; id: string }; merchantId: string }) => Promise<string>;
+let presentGooglePay: (opts: { amountCents: number; owner: { type: 'customer' | 'account'; id: string }; currencyCode?: string; googlePayMerchantId?: string }) => Promise<string>;
 let presentOnboarding: (opts: { accountId?: string | null; capabilities?: string[]; applePayMerchantId?: string | null; googlePayMerchantId?: string | null }) => Promise<unknown>;
 
 beforeEach(() => {
@@ -37,12 +43,16 @@ beforeEach(() => {
   mockInitialize.mockClear();
   mockPresentCheckout.mockClear();
   mockPresentCart.mockClear();
+  mockPresentApplePay.mockClear();
+  mockPresentGooglePay.mockClear();
   mockPresentOnboarding.mockClear();
   mockPlatform.OS = 'ios';
   const native = require('../native');
   initialize = native.initialize;
   presentCheckout = native.presentCheckout;
   presentCart = native.presentCart;
+  presentApplePay = native.presentApplePay;
+  presentGooglePay = native.presentGooglePay;
   presentOnboarding = native.presentOnboarding;
 });
 
@@ -50,12 +60,12 @@ describe('initialize', () => {
   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', 'pk_test_xxx', true);
+    expect(mockInitialize).toHaveBeenCalledWith('sk_test_xxx', 'pk_test_xxx', true, null);
   });
 
   it('defaults debugMode to false', () => {
     initialize({ secretKey: 'sk_test_yyy', publishableKey: 'pk_test_yyy' });
-    expect(mockInitialize).toHaveBeenCalledWith('sk_test_yyy', 'pk_test_yyy', false);
+    expect(mockInitialize).toHaveBeenCalledWith('sk_test_yyy', 'pk_test_yyy', false, null);
   });
 
   it('throws if secretKey is missing', () => {
@@ -74,7 +84,7 @@ describe('initialize', () => {
 describe('presentCheckout', () => {
   it('throws NOT_INITIALIZED if initialize was not called', async () => {
     try {
-      await presentCheckout({ amount: 10000 });
+      await presentCheckout({ accountId: 'acct_1', amount: 10000 });
       expect(true).toBe(false);
     } catch (e: any) {
       expect(e.code).toBe('NOT_INITIALIZED');
@@ -83,17 +93,22 @@ describe('presentCheckout', () => {
     expect(mockPresentCheckout).not.toHaveBeenCalled();
   });
 
-  it('calls native presentCheckout with customerId and amount after initialize', async () => {
+  it('throws INVALID_ACCOUNT when accountId is missing', async () => {
     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 });
+    try {
+      await presentCheckout({ amount: 5000 } as any);
+      expect(true).toBe(false);
+    } catch (e: any) {
+      expect(e.code).toBe('INVALID_ACCOUNT');
+    }
+    expect(mockPresentCheckout).not.toHaveBeenCalled();
   });
 
-  it('passes null for customerId when not provided', async () => {
+  it('calls native presentCheckout with accountId and amount; resolves with transfer id string', async () => {
     await initialize({ secretKey: 'sk_xxx', publishableKey: 'pk_xxx' });
-    await presentCheckout({ amount: 5000 });
-    expect(mockPresentCheckout).toHaveBeenCalledWith(null, 5000);
+    const result = await presentCheckout({ accountId: 'acct_1', amount: 10000 });
+    expect(mockPresentCheckout).toHaveBeenCalledWith('acct_1', 10000);
+    expect(result).toBe('tr_1');
   });
 });
 
@@ -104,7 +119,7 @@ describe('presentCart', () => {
 
   it('throws NOT_INITIALIZED if initialize was not called', async () => {
     try {
-      await presentCart({ items, shippingAmountInCents: 500 });
+      await presentCart({ accountId: 'acct_1', items, shippingAmountInCents: 500 });
       expect(true).toBe(false);
     } catch (e: any) {
       expect(e.code).toBe('NOT_INITIALIZED');
@@ -112,21 +127,160 @@ describe('presentCart', () => {
     expect(mockPresentCart).not.toHaveBeenCalled();
   });
 
-  it('calls native presentCart with customerId, items, shipping after initialize', async () => {
+  it('throws INVALID_ACCOUNT when accountId is missing', async () => {
+    await initialize({ secretKey: 'sk_xxx', publishableKey: 'pk_xxx' });
+    try {
+      await presentCart({ items, shippingAmountInCents: 0 } as any);
+      expect(true).toBe(false);
+    } catch (e: any) {
+      expect(e.code).toBe('INVALID_ACCOUNT');
+    }
+    expect(mockPresentCart).not.toHaveBeenCalled();
+  });
+
+  it('calls native presentCart with accountId, items, shipping; resolves with transfer id string', async () => {
     await initialize({ secretKey: 'sk_xxx', publishableKey: 'pk_xxx' });
     const result = await presentCart({
-      customerId: 'cus_2',
+      accountId: 'acct_2',
       items,
       shippingAmountInCents: 500,
     });
-    expect(mockPresentCart).toHaveBeenCalledWith('cus_2', items, 500);
-    expect(result).toEqual({ id: 'ci_2', amount: 15000 });
+    expect(mockPresentCart).toHaveBeenCalledWith('acct_2', items, 500);
+    expect(result).toBe('tr_2');
+  });
+});
+
+describe('presentApplePay', () => {
+  it('throws NOT_INITIALIZED if initialize was not called', async () => {
+    try {
+      await presentApplePay({ amount: 100, owner: { type: 'account', id: 'acct_1' }, merchantId: 'merchant.test' });
+      expect(true).toBe(false);
+    } catch (e: any) {
+      expect(e.code).toBe('NOT_INITIALIZED');
+    }
+    expect(mockPresentApplePay).not.toHaveBeenCalled();
+  });
+
+  it('throws INVALID_OWNER when owner is missing', async () => {
+    await initialize({ secretKey: 'sk_xxx', publishableKey: 'pk_xxx' });
+    try {
+      await presentApplePay({ amount: 100, merchantId: 'merchant.test' } as any);
+      expect(true).toBe(false);
+    } catch (e: any) {
+      expect(e.code).toBe('INVALID_OWNER');
+    }
+    expect(mockPresentApplePay).not.toHaveBeenCalled();
+  });
+
+  it('throws INVALID_OWNER when owner.id is empty', async () => {
+    await initialize({ secretKey: 'sk_xxx', publishableKey: 'pk_xxx' });
+    try {
+      await presentApplePay({ amount: 100, owner: { type: 'account', id: '' }, merchantId: 'merchant.test' });
+      expect(true).toBe(false);
+    } catch (e: any) {
+      expect(e.code).toBe('INVALID_OWNER');
+    }
+    expect(mockPresentApplePay).not.toHaveBeenCalled();
+  });
+
+  it('throws INVALID_MERCHANT_ID when merchantId is missing', async () => {
+    await initialize({ secretKey: 'sk_xxx', publishableKey: 'pk_xxx' });
+    try {
+      await presentApplePay({ amount: 100, owner: { type: 'account', id: 'acct_1' } } as any);
+      expect(true).toBe(false);
+    } catch (e: any) {
+      expect(e.code).toBe('INVALID_MERCHANT_ID');
+    }
+    expect(mockPresentApplePay).not.toHaveBeenCalled();
+  });
+
+  it('forwards account owner; resolves with transfer id string', async () => {
+    await initialize({ secretKey: 'sk_xxx', publishableKey: 'pk_xxx' });
+    const result = await presentApplePay({
+      amount: 12345,
+      currency: 'usd',
+      owner: { type: 'account', id: 'acct_1' },
+      merchantId: 'merchant.test',
+    });
+    expect(mockPresentApplePay).toHaveBeenCalledWith('account', 'acct_1', 12345, 'usd', 'merchant.test');
+    expect(result).toBe('tr_3');
+  });
+
+  it('forwards customer owner; resolves with charge intent id string', async () => {
+    await initialize({ secretKey: 'sk_xxx', publishableKey: 'pk_xxx' });
+    await presentApplePay({
+      amount: 9999,
+      owner: { type: 'customer', id: 'cus_1' },
+      merchantId: 'merchant.test',
+    });
+    expect(mockPresentApplePay).toHaveBeenCalledWith('customer', 'cus_1', 9999, 'usd', 'merchant.test');
+  });
+
+  it('defaults currency to usd', async () => {
+    await initialize({ secretKey: 'sk_xxx', publishableKey: 'pk_xxx' });
+    await presentApplePay({ amount: 100, owner: { type: 'account', id: 'acct_1' }, merchantId: 'merchant.test' });
+    expect(mockPresentApplePay).toHaveBeenCalledWith('account', 'acct_1', 100, 'usd', 'merchant.test');
+  });
+});
+
+describe('presentGooglePay', () => {
+  it('throws NOT_INITIALIZED if initialize was not called', async () => {
+    try {
+      await presentGooglePay({ amountCents: 100, owner: { type: 'account', id: 'acct_1' } });
+      expect(true).toBe(false);
+    } catch (e: any) {
+      expect(e.code).toBe('NOT_INITIALIZED');
+    }
+    expect(mockPresentGooglePay).not.toHaveBeenCalled();
+  });
+
+  it('throws INVALID_OWNER when owner is missing', async () => {
+    await initialize({ secretKey: 'sk_xxx', publishableKey: 'pk_xxx' });
+    try {
+      await presentGooglePay({ amountCents: 100 } as any);
+      expect(true).toBe(false);
+    } catch (e: any) {
+      expect(e.code).toBe('INVALID_OWNER');
+    }
+    expect(mockPresentGooglePay).not.toHaveBeenCalled();
+  });
+
+  it('throws INVALID_OWNER when owner.id is empty', async () => {
+    await initialize({ secretKey: 'sk_xxx', publishableKey: 'pk_xxx' });
+    try {
+      await presentGooglePay({ amountCents: 100, owner: { type: 'account', id: '' } });
+      expect(true).toBe(false);
+    } catch (e: any) {
+      expect(e.code).toBe('INVALID_OWNER');
+    }
+    expect(mockPresentGooglePay).not.toHaveBeenCalled();
+  });
+
+  it('forwards account owner; resolves with transfer id string', async () => {
+    await initialize({ secretKey: 'sk_xxx', publishableKey: 'pk_xxx' });
+    const result = await presentGooglePay({
+      amountCents: 9999,
+      owner: { type: 'account', id: 'acct_1' },
+      currencyCode: 'EUR',
+      googlePayMerchantId: 'BCR2DN4T...',
+    });
+    expect(mockPresentGooglePay).toHaveBeenCalledWith(9999, 'account', 'acct_1', 'EUR', 'BCR2DN4T...');
+    expect(result).toBe('tr_4');
+  });
+
+  it('forwards customer owner; resolves with charge intent id string', async () => {
+    await initialize({ secretKey: 'sk_xxx', publishableKey: 'pk_xxx' });
+    await presentGooglePay({
+      amountCents: 4242,
+      owner: { type: 'customer', id: 'cus_1' },
+    });
+    expect(mockPresentGooglePay).toHaveBeenCalledWith(4242, 'customer', 'cus_1', 'USD', null);
   });
 
-  it('passes null for customerId when not provided', async () => {
+  it('defaults currencyCode to USD and merchantId to null', async () => {
     await initialize({ secretKey: 'sk_xxx', publishableKey: 'pk_xxx' });
-    await presentCart({ items, shippingAmountInCents: 0 });
-    expect(mockPresentCart).toHaveBeenCalledWith(null, items, 0);
+    await presentGooglePay({ amountCents: 100, owner: { type: 'account', id: 'acct_1' } });
+    expect(mockPresentGooglePay).toHaveBeenCalledWith(100, 'account', 'acct_1', 'USD', null);
   });
 });
 

package/src/errors.ts

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

package/src/index.ts

@@ -27,9 +27,6 @@ export {
 } from './native';
 export type {
   FrameCartItem,
-  ChargeIntent,
-  ChargeIntentStatus,
-  AuthorizationMode,
   FrameError,
   BillingAddress,
   PaymentCard,
@@ -38,6 +35,7 @@ export type {
   OnboardingCapability,
   OnboardingResult,
   OnboardingResultStatus,
+  WalletOwner,
   ApplePayOwner,
   PresentApplePayOptions,
   PresentGooglePayOptions,