framepayments-react-native 3.0.1 → 4.0.0

package/lib/errors.js

@@ -1,6 +1,3 @@
-/**
- * Standard error codes and shape for the Frame React Native SDK.
- */
 export const ErrorCodes = {
     NOT_INITIALIZED: 'NOT_INITIALIZED',
     USER_CANCELED: 'USER_CANCELED',
@@ -18,11 +15,31 @@ export const ErrorCodes = {
     INIT_FAILED: 'INIT_FAILED',
     APPLE_PAY_UNAVAILABLE: 'APPLE_PAY_UNAVAILABLE',
     GOOGLE_PAY_UNAVAILABLE: 'GOOGLE_PAY_UNAVAILABLE',
+    PLAID_UNAVAILABLE: 'PLAID_UNAVAILABLE',
+    CAMERA_UNAVAILABLE: 'CAMERA_UNAVAILABLE',
+    PLATFORM_UNSUPPORTED: 'PLATFORM_UNSUPPORTED',
     NOT_ATTESTED: 'NOT_ATTESTED',
+    ATTESTATION_FAILED: 'ATTESTATION_FAILED',
     PAYMENT_METHOD_FAILED: 'PAYMENT_METHOD_FAILED',
     PAYMENT_FAILED: 'PAYMENT_FAILED',
+    API_DECODE: 'API_DECODE',
+    API_VALIDATION: 'API_VALIDATION',
+    API_NETWORK: 'API_NETWORK',
+    MISSING_PUBLISHABLE_KEY: 'MISSING_PUBLISHABLE_KEY',
+    MISSING_SECRET_KEY: 'MISSING_SECRET_KEY',
 };
+export function frameError(code, message) {
+    const err = new Error(message);
+    err.code = code;
+    return err;
+}
 export function isFrameError(error) {
+    // Plain Error instances (and subclasses like FrameAPIError) duck-type as
+    // FrameErrorShape via inherited .message and an added .code, but they're
+    // not the consumer-facing shape — exclude them so callers route through
+    // the proper adapter (api-errors.toFrameError).
+    if (error instanceof Error)
+        return false;
     return (typeof error === 'object' &&
         error !== null &&
         'code' in error &&

package/lib/evervault.d.ts

@@ -0,0 +1,10 @@
+export declare function configureEvervault(teamId: string, appId: string): Promise<void>;
+export declare function isEvervaultConfigured(): boolean;
+/**
+ * Encrypts the value with Evervault. Awaits any in-flight `configureEvervault`
+ * so callers immediately after `Frame.initialize()` don't see a spurious
+ * `EVERVAULT_NOT_CONFIGURED` while the prefetch is still finishing.
+ */
+export declare function encryptWithEvervault(value: string): Promise<string>;
+export declare function resetEvervault(): void;
+//# sourceMappingURL=evervault.d.ts.map

package/lib/evervault.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evervault.d.ts","sourceRoot":"","sources":["../src/evervault.ts"],"names":[],"mappings":"AAYA,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB/E;AAED,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAczE;AAED,wBAAgB,cAAc,IAAI,IAAI,CAIrC"}

package/lib/evervault.js

@@ -0,0 +1,61 @@
+// `init()` is deprecated by the Evervault RN SDK since 1.1.0 in favour of
+// <EvervaultProvider>. We keep the imperative form here because the SDK's
+// card-encryption call site sits in a view model (not a component subtree).
+// When 2.x drops `init()`, this wrapper will need to migrate to the provider
+// pattern by rendering a hidden <EvervaultProvider> at the modal root and
+// reading the encrypt function from React context.
+import { encrypt as evervaultEncrypt, init as evervaultInit } from '@evervault/evervault-react-native';
+let configuredTeamId = null;
+let configuredAppId = null;
+let inflight = null;
+export function configureEvervault(teamId, appId) {
+    if (!teamId || !appId) {
+        return Promise.reject(Object.assign(new Error('Evervault config requires non-empty teamId and appId'), {
+            code: 'EVERVAULT_CONFIG_INVALID',
+        }));
+    }
+    if (configuredTeamId === teamId && configuredAppId === appId)
+        return Promise.resolve();
+    if (inflight)
+        return inflight;
+    inflight = (async () => {
+        try {
+            await evervaultInit(teamId, appId);
+            configuredTeamId = teamId;
+            configuredAppId = appId;
+        }
+        finally {
+            inflight = null;
+        }
+    })();
+    return inflight;
+}
+export function isEvervaultConfigured() {
+    return configuredTeamId !== null && configuredAppId !== null;
+}
+/**
+ * Encrypts the value with Evervault. Awaits any in-flight `configureEvervault`
+ * so callers immediately after `Frame.initialize()` don't see a spurious
+ * `EVERVAULT_NOT_CONFIGURED` while the prefetch is still finishing.
+ */
+export async function encryptWithEvervault(value) {
+    if (inflight) {
+        try {
+            await inflight;
+        }
+        catch {
+            // configure failed; fall through to the not-configured throw below.
+        }
+    }
+    if (!isEvervaultConfigured()) {
+        throw Object.assign(new Error('Evervault is not configured. Call Frame.initialize(...) first.'), {
+            code: 'EVERVAULT_NOT_CONFIGURED',
+        });
+    }
+    return evervaultEncrypt(value);
+}
+export function resetEvervault() {
+    configuredTeamId = null;
+    configuredAppId = null;
+    inflight = null;
+}

package/lib/googlePay.d.ts

@@ -0,0 +1,30 @@
+import type { PresentGooglePayOptions } from './types';
+export interface GooglePayWalletConfig {
+    identifier: string | null;
+    environment: string | null;
+    processor: string | null;
+    processor_key: string | null;
+}
+export interface GooglePayBridgePresentArgs {
+    amountCents: number;
+    currencyCode: string;
+    googlePayMerchantId: string;
+    environment: 'TEST' | 'PRODUCTION';
+    walletConfig: GooglePayWalletConfig;
+}
+export interface GooglePayBridgeResponse {
+    apiVersion: number;
+    apiVersionMinor: number;
+    email?: string | null;
+    paymentMethodData: Record<string, unknown>;
+}
+export declare function isGooglePayReady(): Promise<boolean>;
+/**
+ * Google Pay token-out flow.
+ *   1. Fetch wallet config from Frame (gateway processor + processor merchant id).
+ *   2. Open the Google Pay sheet via the bridge; receive `PaymentData` JSON.
+ *   3. Create the Google Pay payment method via frame-node (publishable key).
+ *   4. Create a ChargeIntent (customer owner) or Transfer (account owner).
+ */
+export declare function presentGooglePayFlow(options: PresentGooglePayOptions): Promise<string>;
+//# sourceMappingURL=googlePay.d.ts.map

package/lib/googlePay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"googlePay.d.ts","sourceRoot":"","sources":["../src/googlePay.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,uBAAuB,EAAe,MAAM,SAAS,CAAC;AAKpE,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,0BAA0B;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,YAAY,CAAC;IACnC,YAAY,EAAE,qBAAqB,CAAC;CACrC;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAkBD,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAQzD;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyB5F"}

package/lib/googlePay.js

@@ -0,0 +1,96 @@
+import { NativeModules, Platform } from 'react-native';
+import { client } from './client';
+import { ErrorCodes, frameError } from './errors';
+import { getDebugMode, getGooglePayMerchantId } from './config';
+const LINKING_ERROR = "The native module 'FrameGooglePay' isn't linked. Rebuild the Android app.";
+const FrameGooglePay = NativeModules.FrameGooglePay
+    ? NativeModules.FrameGooglePay
+    : new Proxy({}, {
+        get() {
+            throw new Error(LINKING_ERROR);
+        },
+    });
+export async function isGooglePayReady() {
+    if (Platform.OS !== 'android')
+        return false;
+    const environment = getDebugMode() ? 'TEST' : 'PRODUCTION';
+    try {
+        return await FrameGooglePay.isGooglePayReady({ environment });
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Google Pay token-out flow.
+ *   1. Fetch wallet config from Frame (gateway processor + processor merchant id).
+ *   2. Open the Google Pay sheet via the bridge; receive `PaymentData` JSON.
+ *   3. Create the Google Pay payment method via frame-node (publishable key).
+ *   4. Create a ChargeIntent (customer owner) or Transfer (account owner).
+ */
+export async function presentGooglePayFlow(options) {
+    if (Platform.OS !== 'android') {
+        throw frameError(ErrorCodes.PLATFORM_UNSUPPORTED, 'Frame.presentGooglePay is Android-only; use presentApplePay on iOS.');
+    }
+    validateOwner(options.owner);
+    const merchantId = getGooglePayMerchantId();
+    if (!merchantId) {
+        throw frameError(ErrorCodes.INVALID_MERCHANT_ID, 'No Google Pay merchant ID configured. Pass `googlePayMerchantId` to Frame.initialize(...).');
+    }
+    const environment = getDebugMode() ? 'TEST' : 'PRODUCTION';
+    const walletConfig = await client.sdk.wallet.getGooglePayConfiguration({ usePublishableKey: true });
+    const sheetResponse = await FrameGooglePay.presentGooglePay({
+        amountCents: options.amountCents,
+        currencyCode: options.currencyCode ?? 'USD',
+        googlePayMerchantId: merchantId,
+        environment,
+        walletConfig,
+    });
+    return createPaymentMethodAndCharge(options, sheetResponse);
+}
+async function createPaymentMethodAndCharge(options, sheetResponse) {
+    const owner = options.owner;
+    const currency = options.currencyCode ?? 'USD';
+    const wallet = {
+        type: 'google_pay',
+        google_pay: {
+            apiVersion: sheetResponse.apiVersion,
+            apiVersionMinor: sheetResponse.apiVersionMinor,
+            email: sheetResponse.email,
+            paymentMethodData: sheetResponse.paymentMethodData,
+        },
+    };
+    if (owner.type === 'customer') {
+        const pm = await client.sdk.paymentMethods.createGooglePayPaymentMethod({ type: 'card', customer: owner.id, _wallet: wallet }, { usePublishableKey: true });
+        const intent = await client.sdk.chargeIntents.create({
+            amount: options.amountCents,
+            currency: currency.toLowerCase(),
+            customer: owner.id,
+            payment_method: pm.id,
+            confirm: true,
+        });
+        if (!intent || typeof intent.id !== 'string') {
+            throw frameError(ErrorCodes.PAYMENT_FAILED, 'Frame returned no ChargeIntent id.');
+        }
+        return intent.id;
+    }
+    const pm = await client.sdk.paymentMethods.createGooglePayPaymentMethod({ type: 'card', account: owner.id, _wallet: wallet }, { usePublishableKey: true });
+    const transfer = await client.sdk.transfers.create({
+        amount: options.amountCents,
+        account_id: owner.id,
+        currency: currency.toLowerCase(),
+        source_payment_method_id: pm.id,
+    });
+    if (!transfer || typeof transfer.id !== 'string') {
+        throw frameError(ErrorCodes.PAYMENT_FAILED, 'Frame returned no Transfer id.');
+    }
+    return transfer.id;
+}
+function validateOwner(owner) {
+    if (!owner || (owner.type !== 'customer' && owner.type !== 'account')) {
+        throw frameError(ErrorCodes.INVALID_OWNER, 'presentGooglePay requires owner: { type: "customer" | "account", id: string }');
+    }
+    if (!owner.id) {
+        throw frameError(ErrorCodes.INVALID_OWNER, 'presentGooglePay requires owner.id');
+    }
+}

package/lib/index.d.ts

@@ -1,18 +1,23 @@
-/**
- * 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.
- * - Use presentApplePay / presentGooglePay to launch the platform wallet sheet from your own button UI.
- * - For API calls (customers, charge intents, refunds), use the framepayments (frame-node) package from JS.
- */
 import { initialize, presentCheckout, presentCart, presentOnboarding, presentApplePay, presentGooglePay } from './native';
 export { initialize, presentCheckout, presentCart, presentOnboarding, presentApplePay, presentGooglePay, } from './native';
-export type { FrameCartItem, FrameError, BillingAddress, PaymentCard, BankAccount, PaymentMethod, OnboardingCapability, OnboardingResult, OnboardingResultStatus, WalletOwner, ApplePayOwner, PresentApplePayOptions, PresentGooglePayOptions, FrameTheme, FrameThemeColor, FrameThemeFont, FrameThemeColors, FrameThemeFonts, FrameThemeRadii, } from './types';
+export type { FrameCartItem, BillingAddress, PaymentCard, BankAccount, PaymentMethod, OnboardingCapability, OnboardingResult, OnboardingResultStatus, WalletOwner, ApplePayOwner, PresentApplePayOptions, PresentGooglePayOptions, FrameTheme, FrameThemeColor, FrameThemeFont, FrameThemeColors, FrameThemeFonts, FrameThemeRadii, } from './types';
 export { ErrorCodes } from './errors';
 export type { FrameErrorShape, FrameErrorCode } from './errors';
-/** Default export for Frame.initialize(), Frame.presentCheckout(), Frame.presentCart(), Frame.presentOnboarding(), Frame.presentApplePay(), Frame.presentGooglePay() */
+export { FrameProvider, type FrameProviderProps } from './ui/FrameProvider';
+export { useFrameTheme } from './ui/theme/ThemeContext';
+export { resolveTheme, type ColorScheme, type ResolvedFrameTheme } from './ui/theme/defaults';
+export { Button, type ButtonProps, type ButtonVariant } from './ui/primitives/Button';
+export { ValidatedTextField, type ValidatedTextFieldProps } from './ui/primitives/ValidatedTextField';
+export { ApplePayButton, type ApplePayButtonProps, type ApplePayButtonStyle, type ApplePayButtonType, } from './ui/primitives/ApplePayButton';
+export { GooglePayButton, type GooglePayButtonProps, type GooglePayButtonTheme, type GooglePayButtonType, } from './ui/primitives/GooglePayButton';
+export { validateNonEmpty, validateFullName, validateEmail, validateZipUS, validateCard, validateCardExpiry, validateSSNLast4, validateRoutingNumberUS, validateAccountNumberUS, validateDateOfBirth, validatePostalCode, validatePhoneE164, detectCardBrand, getSupportedPostalCodeCountries, POSTAL_CODE_COUNTRIES, type PostalCountryCode, } from './validation';
+import * as Validators from './validation';
+import { convertCentsToCurrencyString } from './currency';
+export { Validators };
+export { DEFAULT_COUNTRY, RESTRICTED_ALPHA2_CODES, RESTRICTED_COUNTRY_NAMES, alpha2ToFlag, getAllCountries, getAvailableCountries, getPhoneCountries, type AvailableCountry, type PhoneCountry, } from './countries';
+export { convertCentsToCurrencyString } from './currency';
+export { configureEvervault, encryptWithEvervault, isEvervaultConfigured, } from './evervault';
+export { ensureAttested, generateAssertionForPayment, getAttestedKeyId, isAttestationSupported, resetAttestation, } from './attestation';
 declare const _default: {
     initialize: typeof initialize;
     presentCheckout: typeof presentCheckout;
@@ -20,6 +25,8 @@ declare const _default: {
     presentOnboarding: typeof presentOnboarding;
     presentApplePay: typeof presentApplePay;
     presentGooglePay: typeof presentGooglePay;
+    Validators: typeof Validators;
+    convertCentsToCurrencyString: typeof convertCentsToCurrencyString;
 };
 export default _default;
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,UAAU,EACV,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,gBAAgB,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,UAAU,EACV,cAAc,EACd,WAAW,EACX,WAAW,EACX,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,WAAW,EACX,aAAa,EACb,sBAAsB,EACtB,uBAAuB,EACvB,UAAU,EACV,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,eAAe,GAChB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAEhE,wKAAwK;;;;;;;;;AACxK,wBAOE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,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,cAAc,EACd,WAAW,EACX,WAAW,EACX,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,WAAW,EACX,aAAa,EACb,sBAAsB,EACtB,uBAAuB,EACvB,UAAU,EACV,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,eAAe,GAChB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAEhE,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9F,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,EAAE,kBAAkB,EAAE,KAAK,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AACtG,OAAO,EACL,cAAc,EACd,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,eAAe,EACf,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,+BAA+B,EAC/B,qBAAqB,EACrB,KAAK,iBAAiB,GACvB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,CAAC;AAEtB,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,wBAAwB,EACxB,YAAY,EACZ,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,YAAY,GAClB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAC;AAE1D,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,cAAc,EACd,2BAA2B,EAC3B,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,eAAe,CAAC;;;;;;;;;;;AAEvB,wBASE"}

package/lib/index.js

@@ -1,16 +1,21 @@
-/**
- * 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.
- * - Use presentApplePay / presentGooglePay to launch the platform wallet sheet from your own button UI.
- * - For API calls (customers, charge intents, refunds), use the framepayments (frame-node) package from JS.
- */
 import { initialize, presentCheckout, presentCart, presentOnboarding, presentApplePay, presentGooglePay, } from './native';
 export { initialize, presentCheckout, presentCart, presentOnboarding, presentApplePay, presentGooglePay, } from './native';
 export { ErrorCodes } from './errors';
-/** Default export for Frame.initialize(), Frame.presentCheckout(), Frame.presentCart(), Frame.presentOnboarding(), Frame.presentApplePay(), Frame.presentGooglePay() */
+export { FrameProvider } from './ui/FrameProvider';
+export { useFrameTheme } from './ui/theme/ThemeContext';
+export { resolveTheme } from './ui/theme/defaults';
+export { Button } from './ui/primitives/Button';
+export { ValidatedTextField } from './ui/primitives/ValidatedTextField';
+export { ApplePayButton, } from './ui/primitives/ApplePayButton';
+export { GooglePayButton, } from './ui/primitives/GooglePayButton';
+export { validateNonEmpty, validateFullName, validateEmail, validateZipUS, validateCard, validateCardExpiry, validateSSNLast4, validateRoutingNumberUS, validateAccountNumberUS, validateDateOfBirth, validatePostalCode, validatePhoneE164, detectCardBrand, getSupportedPostalCodeCountries, POSTAL_CODE_COUNTRIES, } from './validation';
+import * as Validators from './validation';
+import { convertCentsToCurrencyString } from './currency';
+export { Validators };
+export { DEFAULT_COUNTRY, RESTRICTED_ALPHA2_CODES, RESTRICTED_COUNTRY_NAMES, alpha2ToFlag, getAllCountries, getAvailableCountries, getPhoneCountries, } from './countries';
+export { convertCentsToCurrencyString } from './currency';
+export { configureEvervault, encryptWithEvervault, isEvervaultConfigured, } from './evervault';
+export { ensureAttested, generateAssertionForPayment, getAttestedKeyId, isAttestationSupported, resetAttestation, } from './attestation';
 export default {
     initialize,
     presentCheckout,
@@ -18,4 +23,6 @@ export default {
     presentOnboarding,
     presentApplePay,
     presentGooglePay,
+    Validators,
+    convertCentsToCurrencyString,
 };

package/lib/ipAddress.d.ts

@@ -0,0 +1,5 @@
+/** Returns the device IP address, or null if the bridge isn't linked or the
+ *  lookup failed. Safe to call before native init has completed — failures
+ *  surface as null. */
+export declare function fetchIpAddress(): Promise<string | null>;
+//# sourceMappingURL=ipAddress.d.ts.map

package/lib/ipAddress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipAddress.d.ts","sourceRoot":"","sources":["../src/ipAddress.ts"],"names":[],"mappings":"AAkBA;;uBAEuB;AACvB,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAO7D"}

package/lib/ipAddress.js

@@ -0,0 +1,15 @@
+import { NativeModules } from 'react-native';
+const FrameIpAddress = NativeModules.FrameIpAddress ?? null;
+/** Returns the device IP address, or null if the bridge isn't linked or the
+ *  lookup failed. Safe to call before native init has completed — failures
+ *  surface as null. */
+export async function fetchIpAddress() {
+    if (!FrameIpAddress)
+        return null;
+    try {
+        return await FrameIpAddress.getIpAddress();
+    }
+    catch {
+        return null;
+    }
+}

package/lib/native.d.ts

@@ -1,74 +1,35 @@
-/**
- * Native module bridge. Uses NativeModules for classic React Native bridge.
- */
 import type { FrameCartItem, FrameTheme, OnboardingCapability, OnboardingResult, PresentApplePayOptions, PresentGooglePayOptions } from './types';
+import type { AddressMode } from './ui/screens/checkout/checkoutReducer';
 export declare function initialize(options: {
     secretKey: string;
     publishableKey: string;
     debugMode?: boolean;
-    /**
-     * Apple Pay merchant ID configured in your Apple Developer account. Applied to every
-     * Apple Pay surface (presentApplePay, the bundled checkout's wallet row, the
-     * onboarding wallet attach button). iOS-only — ignored on Android.
-     */
     applePayMerchantId?: string;
-    /**
-     * Google Pay merchant ID from the Google Pay & Wallet Console. Applied to every
-     * Google Pay surface (presentGooglePay, the bundled checkout's wallet row, the
-     * onboarding wallet attach button). Android-only — ignored on iOS.
-     */
     googlePayMerchantId?: string;
-    /**
-     * Optional theme applied SDK-wide to Frame's reusable iOS components
-     * (checkout, cart, onboarding). Pass any subset — unspecified tokens fall
-     * back to SDK defaults. No-op on Android until frame-android ships a
-     * matching theme API.
-     */
     theme?: FrameTheme;
 }): Promise<void>;
-/**
- * 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 declare function presentCheckout(options: {
+export interface PresentCheckoutOptions {
     accountId: string;
     amount: number;
-}): Promise<string>;
-/**
- * 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 declare function presentCart(options: {
+    currency?: string;
+    addressMode?: AddressMode;
+    title?: string;
+}
+export declare function presentCheckout(options: PresentCheckoutOptions): Promise<string>;
+export interface PresentCartOptions {
     accountId: string;
     items: FrameCartItem[];
     shippingAmountInCents: number;
-}): Promise<string>;
-export declare function presentOnboarding(options: {
+    currency?: string;
+    title?: string;
+    addressMode?: AddressMode;
+}
+export declare function presentCart(options: PresentCartOptions): Promise<string>;
+export interface PresentOnboardingOptions {
     accountId?: string | null;
     capabilities?: OnboardingCapability[];
-}): Promise<OnboardingResult>;
-/**
- * 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 declare function presentOnboarding(options: PresentOnboardingOptions): Promise<OnboardingResult>;
 export declare function presentApplePay(options: PresentApplePayOptions): Promise<string>;
-/**
- * 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 declare function presentGooglePay(options: PresentGooglePayOptions): Promise<string>;
 //# sourceMappingURL=native.d.ts.map

package/lib/native.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EACV,aAAa,EACb,UAAU,EACV,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,SAAS,CAAC;AAiCjB,wBAAgB,UAAU,CAAC,OAAO,EAAE;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;;OAKG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBhB;AAwBD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CAQlB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC;CAC/B,GAAG,OAAO,CAAC,MAAM,CAAC,CAYlB;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;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBhF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBlF"}
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../src/native.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,EACb,UAAU,EACV,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,SAAS,CAAC;AAKjB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AAoCzE,wBAAgB,UAAU,CAAC,OAAO,EAAE;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CAWhB;AA+HD,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAwBtF;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiB9E;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,CAAC,EAAE,oBAAoB,EAAE,CAAC;CACvC;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAapG;AAkED,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAGhF;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAGlF"}