@unifold/connect-react-native 0.1.52 → 0.1.54-beta.1

package/dist/index.d.mts

@@ -362,6 +362,21 @@ interface SupportedDestinationTokensResponse {
  */
 declare function getSupportedDestinationTokens(publishableKey?: string): Promise<SupportedDestinationTokensResponse>;
 
+/**
+ * Host-app-supplied user identity, shared across deposit flows. An object (not a
+ * bare string) so more fields can be added later without churning the public API.
+ * - Coinbase Apple Pay: a valid `email` skips the email-entry/OTP steps (the user
+ *   only verifies their phone; Coinbase's 60-day phone-freshness rule still applies).
+ * - Stripe Link Pay: `email`/`phone` pre-fill; with both set, Stripe may skip its
+ *   verify steps.
+ */
+interface UnifoldUser {
+    /** Host-trusted email. Coinbase skips its email steps when set & valid; Stripe pre-fills. */
+    email?: string;
+    /** User phone (Stripe Link pre-fill; with `email`, Stripe may skip verify steps). */
+    phone?: string;
+}
+
 interface BorderRadiusConfig {
     borderTopLeftRadius?: number;
     borderTopRightRadius?: number;
@@ -405,19 +420,7 @@ type TransferInputVariant = "single_input" | "double_input" | "compact";
  */
 type DepositMenuDisplay = "stacked" | "tabs";
 /** Controls which screen opens first when the deposit modal is shown */
-type DepositInitialScreen = "main" | "transfer" | "card" | "tracker" | "cashapp" | "wallet";
-/**
- * Host-app-supplied user identity used to pre-fill supported flows.
- * Currently consumed by Stripe Link Pay (email/phone pre-fill). Kept as an
- * extensible object so more fields can be added later without new top-level
- * props.
- */
-interface UnifoldUser {
-    /** Pre-fills the user's email (e.g. Stripe Link Pay). */
-    email?: string;
-    /** Pre-fills the user's phone; with `email`, Stripe may skip verify steps. */
-    phone?: string;
-}
+type DepositInitialScreen = "main" | "transfer" | "card" | "tracker" | "cashapp" | "wallet" | "apple_pay" | "stripe_link";
 interface DepositModalProps {
     /** Whether the modal is visible */
     visible: boolean;
@@ -432,6 +435,14 @@ interface DepositModalProps {
     publishableKey: string;
     /** Custom modal title */
     modalTitle?: string;
+    /** Overrides the Transfer Crypto row title on the main menu and the Transfer Crypto flow header. @default `"Transfer Crypto"` */
+    transferCryptoTitle?: string;
+    /**
+     * Host-app-supplied user identity, set via `beginDeposit({ user })`. Consumed by:
+     * - Coinbase Apple Pay — a valid `user.email` skips the email-entry/OTP steps.
+     * - Stripe Link Pay — `user.email` / `user.phone` pre-fill (both may skip verify steps).
+     */
+    user?: UnifoldUser;
     /** Target token symbol (e.g., "USDC") */
     destinationTokenSymbol?: string;
     /** Recipient wallet address */
@@ -458,17 +469,14 @@ interface DepositModalProps {
     enableCashApp?: boolean;
     /** Enable "Connect Wallet" option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? false. */
     enableConnectWallet?: boolean;
+    /** Enable "Pay with Apple Pay" (Coinbase headless onramp) option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? false. */
+    enableCoinbaseApplePay?: boolean;
     /** Enable "Deposit with Card" (fiat on-ramp) option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? true. */
     enableFiatOnramp?: boolean;
-    /** Show "Pay with Link" (Stripe) option in the deposit menu */
+    /** Show "Pay with Link" (Stripe) option in the deposit menu. Overrides dashboard default. Resolves as flag ?? dashboard value ?? false. The backend `stripe_link.is_hidden` kill switch force-hides it regardless. */
     enableStripeLink?: boolean;
     /** Registered Stripe onramp component (Connect sets this from `enableStripeLink`) */
     StripeOnrampComponent?: React$1.ComponentType<any>;
-    /**
-     * Host-app-supplied user identity. Pre-fills supported flows (currently Stripe
-     * Link Pay email/phone). Set via `beginDeposit({ user })`.
-     */
-    user?: UnifoldUser;
     /** Where to render the Stripe payment method selector: "header" or "inline". Default: "header" */
     stripePaymentSelectorPosition?: "header" | "inline";
     /** Skip the success confirmation screen and fire onComplete immediately. Default: false */
@@ -494,6 +502,10 @@ interface DepositModalProps {
      * - 'transfer': open Transfer Crypto immediately
      * - 'card': open Buy with Card immediately
      * - 'tracker': open Deposit Tracker immediately (ignored if the tracker is disabled)
+     * - 'cashapp': open Pay with Cash App immediately
+     * - 'wallet': open Connect Wallet immediately
+     * - 'apple_pay': open Coinbase Apple Pay immediately
+     * - 'stripe_link': open Stripe Link Pay immediately
      */
     initialScreen?: DepositInitialScreen;
     /** Callback when deposit succeeds */
@@ -539,6 +551,8 @@ interface DepositModalProps {
         stripeLink?: BorderRadiusConfig;
         /** Cash App sheet */
         cashApp?: BorderRadiusConfig;
+        /** Coinbase Apple Pay sheet */
+        coinbaseApplePay?: BorderRadiusConfig;
         /** Connect Wallet sheet */
         connectWallet?: BorderRadiusConfig;
         /** WebView sheet (inside buy with card) */
@@ -620,6 +634,8 @@ interface UnifoldConnectProviderConfig {
     publishableKey: string;
     config?: {
         modalTitle?: string;
+        /** Overrides the Transfer Crypto row title on the main deposit menu and the Transfer Crypto flow header. @default `"Transfer Crypto"` */
+        transferCryptoTitle?: string;
         hideDepositTracker?: boolean;
         /** Theme appearance: 'light', 'dark', or 'auto' (system preference). Defaults to 'dark' */
         appearance?: ThemeMode | "auto";
@@ -640,8 +656,11 @@ interface UnifoldConnectProviderConfig {
         /** Border radius configuration for all bottom sheets */
         sheetBorderRadius?: DepositModalProps["sheetBorderRadius"];
         /**
-         * Show "Pay with Link" (Stripe) option in the deposit menu.
-         * Stripe onramp is bundled with Connect; set to false to hide the option.
+         * Show "Pay with Link" (Stripe) option in the deposit menu. Overrides
+         * dashboard default. Resolves as flag ?? dashboard value ?? false — omit it
+         * to defer to the backend config. Stripe onramp is bundled with Connect.
+         * Note: the backend `stripe_link.is_hidden` kill switch force-hides the
+         * option regardless of this flag.
          */
         enableStripeLink?: boolean;
         /** Enable "Transfer Crypto" option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? true. */
@@ -650,6 +669,8 @@ interface UnifoldConnectProviderConfig {
         enableCashApp?: boolean;
         /** Enable "Connect Wallet" option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? false. */
         enableConnectWallet?: boolean;
+        /** Enable "Pay with Apple Pay" (Coinbase headless onramp) option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? false. */
+        enableCoinbaseApplePay?: boolean;
         /** Enable "Deposit with Card" (fiat on-ramp) option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? true. */
         enableFiatOnramp?: boolean;
         /** Stripe Link Pay tuning options (only applies when `enableStripeLink` is true). */
@@ -684,9 +705,11 @@ interface DepositConfig {
     showBalance?: boolean;
     /**
      * Host-app-supplied user identity (`beginDeposit` only — not provider config).
-     * Pre-fills supported flows; currently Stripe Link Pay uses `user.email` /
-     * `user.phone` (with both set, Stripe may skip verify steps). Kept as an
-     * object so more fields can be added later without new `stripeXxx` params.
+     * Pre-fills supported flows and is kept as an object so more fields can be
+     * added later without new top-level params. Consumed by:
+     * - Coinbase Apple Pay — a valid `user.email` skips the email-entry/OTP steps.
+     * - Stripe Link Pay — `user.email` / `user.phone` (with both set, Stripe may
+     *   skip verify steps).
      */
     user?: UnifoldUser;
     /**
@@ -702,6 +725,10 @@ interface DepositConfig {
      * - 'transfer': open Transfer Crypto immediately
      * - 'card': open Buy with Card immediately
      * - 'tracker': open Deposit Tracker immediately
+     * - 'cashapp': open Pay with Cash App immediately
+     * - 'wallet': open Connect Wallet immediately
+     * - 'apple_pay': open Coinbase Apple Pay immediately
+     * - 'stripe_link': open Stripe Link Pay immediately
      */
     initialScreen?: DepositInitialScreen;
     onSuccess?: (data: DepositResult) => void;

package/dist/index.d.ts

@@ -362,6 +362,21 @@ interface SupportedDestinationTokensResponse {
  */
 declare function getSupportedDestinationTokens(publishableKey?: string): Promise<SupportedDestinationTokensResponse>;
 
+/**
+ * Host-app-supplied user identity, shared across deposit flows. An object (not a
+ * bare string) so more fields can be added later without churning the public API.
+ * - Coinbase Apple Pay: a valid `email` skips the email-entry/OTP steps (the user
+ *   only verifies their phone; Coinbase's 60-day phone-freshness rule still applies).
+ * - Stripe Link Pay: `email`/`phone` pre-fill; with both set, Stripe may skip its
+ *   verify steps.
+ */
+interface UnifoldUser {
+    /** Host-trusted email. Coinbase skips its email steps when set & valid; Stripe pre-fills. */
+    email?: string;
+    /** User phone (Stripe Link pre-fill; with `email`, Stripe may skip verify steps). */
+    phone?: string;
+}
+
 interface BorderRadiusConfig {
     borderTopLeftRadius?: number;
     borderTopRightRadius?: number;
@@ -405,19 +420,7 @@ type TransferInputVariant = "single_input" | "double_input" | "compact";
  */
 type DepositMenuDisplay = "stacked" | "tabs";
 /** Controls which screen opens first when the deposit modal is shown */
-type DepositInitialScreen = "main" | "transfer" | "card" | "tracker" | "cashapp" | "wallet";
-/**
- * Host-app-supplied user identity used to pre-fill supported flows.
- * Currently consumed by Stripe Link Pay (email/phone pre-fill). Kept as an
- * extensible object so more fields can be added later without new top-level
- * props.
- */
-interface UnifoldUser {
-    /** Pre-fills the user's email (e.g. Stripe Link Pay). */
-    email?: string;
-    /** Pre-fills the user's phone; with `email`, Stripe may skip verify steps. */
-    phone?: string;
-}
+type DepositInitialScreen = "main" | "transfer" | "card" | "tracker" | "cashapp" | "wallet" | "apple_pay" | "stripe_link";
 interface DepositModalProps {
     /** Whether the modal is visible */
     visible: boolean;
@@ -432,6 +435,14 @@ interface DepositModalProps {
     publishableKey: string;
     /** Custom modal title */
     modalTitle?: string;
+    /** Overrides the Transfer Crypto row title on the main menu and the Transfer Crypto flow header. @default `"Transfer Crypto"` */
+    transferCryptoTitle?: string;
+    /**
+     * Host-app-supplied user identity, set via `beginDeposit({ user })`. Consumed by:
+     * - Coinbase Apple Pay — a valid `user.email` skips the email-entry/OTP steps.
+     * - Stripe Link Pay — `user.email` / `user.phone` pre-fill (both may skip verify steps).
+     */
+    user?: UnifoldUser;
     /** Target token symbol (e.g., "USDC") */
     destinationTokenSymbol?: string;
     /** Recipient wallet address */
@@ -458,17 +469,14 @@ interface DepositModalProps {
     enableCashApp?: boolean;
     /** Enable "Connect Wallet" option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? false. */
     enableConnectWallet?: boolean;
+    /** Enable "Pay with Apple Pay" (Coinbase headless onramp) option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? false. */
+    enableCoinbaseApplePay?: boolean;
     /** Enable "Deposit with Card" (fiat on-ramp) option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? true. */
     enableFiatOnramp?: boolean;
-    /** Show "Pay with Link" (Stripe) option in the deposit menu */
+    /** Show "Pay with Link" (Stripe) option in the deposit menu. Overrides dashboard default. Resolves as flag ?? dashboard value ?? false. The backend `stripe_link.is_hidden` kill switch force-hides it regardless. */
     enableStripeLink?: boolean;
     /** Registered Stripe onramp component (Connect sets this from `enableStripeLink`) */
     StripeOnrampComponent?: React$1.ComponentType<any>;
-    /**
-     * Host-app-supplied user identity. Pre-fills supported flows (currently Stripe
-     * Link Pay email/phone). Set via `beginDeposit({ user })`.
-     */
-    user?: UnifoldUser;
     /** Where to render the Stripe payment method selector: "header" or "inline". Default: "header" */
     stripePaymentSelectorPosition?: "header" | "inline";
     /** Skip the success confirmation screen and fire onComplete immediately. Default: false */
@@ -494,6 +502,10 @@ interface DepositModalProps {
      * - 'transfer': open Transfer Crypto immediately
      * - 'card': open Buy with Card immediately
      * - 'tracker': open Deposit Tracker immediately (ignored if the tracker is disabled)
+     * - 'cashapp': open Pay with Cash App immediately
+     * - 'wallet': open Connect Wallet immediately
+     * - 'apple_pay': open Coinbase Apple Pay immediately
+     * - 'stripe_link': open Stripe Link Pay immediately
      */
     initialScreen?: DepositInitialScreen;
     /** Callback when deposit succeeds */
@@ -539,6 +551,8 @@ interface DepositModalProps {
         stripeLink?: BorderRadiusConfig;
         /** Cash App sheet */
         cashApp?: BorderRadiusConfig;
+        /** Coinbase Apple Pay sheet */
+        coinbaseApplePay?: BorderRadiusConfig;
         /** Connect Wallet sheet */
         connectWallet?: BorderRadiusConfig;
         /** WebView sheet (inside buy with card) */
@@ -620,6 +634,8 @@ interface UnifoldConnectProviderConfig {
     publishableKey: string;
     config?: {
         modalTitle?: string;
+        /** Overrides the Transfer Crypto row title on the main deposit menu and the Transfer Crypto flow header. @default `"Transfer Crypto"` */
+        transferCryptoTitle?: string;
         hideDepositTracker?: boolean;
         /** Theme appearance: 'light', 'dark', or 'auto' (system preference). Defaults to 'dark' */
         appearance?: ThemeMode | "auto";
@@ -640,8 +656,11 @@ interface UnifoldConnectProviderConfig {
         /** Border radius configuration for all bottom sheets */
         sheetBorderRadius?: DepositModalProps["sheetBorderRadius"];
         /**
-         * Show "Pay with Link" (Stripe) option in the deposit menu.
-         * Stripe onramp is bundled with Connect; set to false to hide the option.
+         * Show "Pay with Link" (Stripe) option in the deposit menu. Overrides
+         * dashboard default. Resolves as flag ?? dashboard value ?? false — omit it
+         * to defer to the backend config. Stripe onramp is bundled with Connect.
+         * Note: the backend `stripe_link.is_hidden` kill switch force-hides the
+         * option regardless of this flag.
          */
         enableStripeLink?: boolean;
         /** Enable "Transfer Crypto" option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? true. */
@@ -650,6 +669,8 @@ interface UnifoldConnectProviderConfig {
         enableCashApp?: boolean;
         /** Enable "Connect Wallet" option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? false. */
         enableConnectWallet?: boolean;
+        /** Enable "Pay with Apple Pay" (Coinbase headless onramp) option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? false. */
+        enableCoinbaseApplePay?: boolean;
         /** Enable "Deposit with Card" (fiat on-ramp) option. Overrides dashboard default. Resolves as flag ?? dashboard value ?? true. */
         enableFiatOnramp?: boolean;
         /** Stripe Link Pay tuning options (only applies when `enableStripeLink` is true). */
@@ -684,9 +705,11 @@ interface DepositConfig {
     showBalance?: boolean;
     /**
      * Host-app-supplied user identity (`beginDeposit` only — not provider config).
-     * Pre-fills supported flows; currently Stripe Link Pay uses `user.email` /
-     * `user.phone` (with both set, Stripe may skip verify steps). Kept as an
-     * object so more fields can be added later without new `stripeXxx` params.
+     * Pre-fills supported flows and is kept as an object so more fields can be
+     * added later without new top-level params. Consumed by:
+     * - Coinbase Apple Pay — a valid `user.email` skips the email-entry/OTP steps.
+     * - Stripe Link Pay — `user.email` / `user.phone` (with both set, Stripe may
+     *   skip verify steps).
      */
     user?: UnifoldUser;
     /**
@@ -702,6 +725,10 @@ interface DepositConfig {
      * - 'transfer': open Transfer Crypto immediately
      * - 'card': open Buy with Card immediately
      * - 'tracker': open Deposit Tracker immediately
+     * - 'cashapp': open Pay with Cash App immediately
+     * - 'wallet': open Connect Wallet immediately
+     * - 'apple_pay': open Coinbase Apple Pay immediately
+     * - 'stripe_link': open Stripe Link Pay immediately
      */
     initialScreen?: DepositInitialScreen;
     onSuccess?: (data: DepositResult) => void;