@swype-org/react-sdk 0.2.215 → 0.2.220

package/dist/index.d.cts

@@ -400,6 +400,17 @@ interface BlinkConfig {
      * `useBlinkConfig().enableFullWidget ?? false`.
      */
     enableFullWidget?: boolean;
+    /**
+     * When true, the SDK is being rendered inside a native mobile app's in-app
+     * browser (e.g. via `deposit-mobile-sdk` opening an SFSafariViewController
+     * or Android Custom Tab). Hides the in-screen (X) close buttons (the host
+     * app's native chrome handles dismissal) and removes the rounded screen
+     * sheet corners so the widget renders edge-to-edge. Defaults to `false`.
+     *
+     * Optional for backwards compatibility; internal SDK code normalizes via
+     * `useBlinkConfig().isMobileApp ?? false`.
+     */
+    isMobileApp?: boolean;
 }
 interface BlinkProviderProps {
     /** Base URL for the Blink API (e.g. "http://localhost:3000") */
@@ -422,6 +433,12 @@ interface BlinkProviderProps {
      * before login for unauthenticated users. Defaults to `false`.
      */
     enableFullWidget?: boolean;
+    /**
+     * When true, the widget is hosted inside a native mobile app's in-app browser.
+     * Hides the in-screen (X) close buttons and removes rounded screen corners so
+     * the widget renders edge-to-edge. Defaults to `false`.
+     */
+    isMobileApp?: boolean;
     children: React.ReactNode;
 }
 /**
@@ -438,7 +455,7 @@ interface BlinkProviderProps {
  * </BlinkProvider>
  * ```
  */
-declare function BlinkProvider({ apiBaseUrl, theme, privyAppId, minTransferAmountUsd, enableFullWidget, children, }: BlinkProviderProps): react_jsx_runtime.JSX.Element;
+declare function BlinkProvider({ apiBaseUrl, theme, privyAppId, minTransferAmountUsd, enableFullWidget, isMobileApp, children, }: BlinkProviderProps): react_jsx_runtime.JSX.Element;
 /** Access the Blink SDK configuration. Throws if used outside BlinkProvider. */
 declare function useBlinkConfig(): BlinkConfig;
 /**
@@ -647,7 +664,9 @@ type ProbeActionCompletionResult = {
  * - `detected: false, reason: 'not-found'` — scan completed with no match
  *   (`DEPOSIT_TX_NOT_FOUND` for bridges, `APPROVE_NOT_DETECTED` for
  *   EVM approves, `APPROVE_SPL_NOT_DETECTED` for Solana approves); safe to
- *   prompt the wallet.
+ *   prompt the wallet only when no matching transaction may already have
+ *   been submitted. Post-submit callers must treat an approve miss as
+ *   inconclusive and avoid opening a duplicate approve prompt.
  * - `detected: false, reason: 'invalid-state'` — transfer already advanced
  *   past CREATED (race); the next orchestrator loop will observe it.
  * - `detected: false, reason: 'error'` — unexpected failure (network, 5xx);
@@ -1111,13 +1130,14 @@ interface OrchestratorRunOptions {
     alwaysPauseForOneTap?: boolean;
     /**
      * When true (default), before presenting the wallet for any of
-     * APPROVE_PERMIT2 / SIGN_PERMIT2 / APPROVE_SPL / EXECUTE_BRIDGE on this run, probe
+     * SIGN_PERMIT2 / APPROVE_SPL on this run, probe
      * the server to see if the action is already satisfied on-chain (e.g.
      * user confirmed pre-reload but the PATCH never landed, signed in
      * another tab, or the wallet returned a stale error after broadcasting).
+     * APPROVE_PERMIT2 is probed only after the orchestrator has evidence an
+     * approve transaction may already have been submitted.
      *
      * Probe semantics per action type:
-     *   - APPROVE_PERMIT2: backend re-checks ERC-20 allowance for Permit2.
      *   - SIGN_PERMIT2:    backend re-checks Permit2 allowance (single &
      *                      batched paths).
      *   - APPROVE_SPL:     backend re-checks SPL delegate authority.
@@ -1414,6 +1434,7 @@ interface StepHandlers {
     /** Leave funding subflow (setup / token picker) back to deposit: restore selection, cancel executor. */
     onBackFromSubflow: () => void;
     onLogin: () => void;
+    onCancelLogin: () => void;
     onSetDepositAmount: (amount: number) => void;
     onSetDepositToken: (symbol: string, chainName: string, walletId?: string, tokenAddress?: string, chainId?: number) => void;
     onConfirmSetupDeposit: () => void | Promise<void>;
@@ -1424,6 +1445,14 @@ interface StepRendererFlowProps {
     authenticated: boolean;
     passkeyLoading: boolean;
     isDesktop: boolean;
+    /**
+     * True when the SDK is hosted inside a native mobile app's in-app browser.
+     * Suppresses in-screen (X) close buttons (the host's native chrome handles
+     * dismissal) and removes rounded screen corners. Optional for backwards
+     * compatibility with pre-existing test fixtures; treated as `false` when
+     * absent.
+     */
+    isMobileApp?: boolean;
     merchantName?: string;
     onBack?: () => void;
     onDismiss?: () => void;

package/dist/index.d.ts

@@ -400,6 +400,17 @@ interface BlinkConfig {
      * `useBlinkConfig().enableFullWidget ?? false`.
      */
     enableFullWidget?: boolean;
+    /**
+     * When true, the SDK is being rendered inside a native mobile app's in-app
+     * browser (e.g. via `deposit-mobile-sdk` opening an SFSafariViewController
+     * or Android Custom Tab). Hides the in-screen (X) close buttons (the host
+     * app's native chrome handles dismissal) and removes the rounded screen
+     * sheet corners so the widget renders edge-to-edge. Defaults to `false`.
+     *
+     * Optional for backwards compatibility; internal SDK code normalizes via
+     * `useBlinkConfig().isMobileApp ?? false`.
+     */
+    isMobileApp?: boolean;
 }
 interface BlinkProviderProps {
     /** Base URL for the Blink API (e.g. "http://localhost:3000") */
@@ -422,6 +433,12 @@ interface BlinkProviderProps {
      * before login for unauthenticated users. Defaults to `false`.
      */
     enableFullWidget?: boolean;
+    /**
+     * When true, the widget is hosted inside a native mobile app's in-app browser.
+     * Hides the in-screen (X) close buttons and removes rounded screen corners so
+     * the widget renders edge-to-edge. Defaults to `false`.
+     */
+    isMobileApp?: boolean;
     children: React.ReactNode;
 }
 /**
@@ -438,7 +455,7 @@ interface BlinkProviderProps {
  * </BlinkProvider>
  * ```
  */
-declare function BlinkProvider({ apiBaseUrl, theme, privyAppId, minTransferAmountUsd, enableFullWidget, children, }: BlinkProviderProps): react_jsx_runtime.JSX.Element;
+declare function BlinkProvider({ apiBaseUrl, theme, privyAppId, minTransferAmountUsd, enableFullWidget, isMobileApp, children, }: BlinkProviderProps): react_jsx_runtime.JSX.Element;
 /** Access the Blink SDK configuration. Throws if used outside BlinkProvider. */
 declare function useBlinkConfig(): BlinkConfig;
 /**
@@ -647,7 +664,9 @@ type ProbeActionCompletionResult = {
  * - `detected: false, reason: 'not-found'` — scan completed with no match
  *   (`DEPOSIT_TX_NOT_FOUND` for bridges, `APPROVE_NOT_DETECTED` for
  *   EVM approves, `APPROVE_SPL_NOT_DETECTED` for Solana approves); safe to
- *   prompt the wallet.
+ *   prompt the wallet only when no matching transaction may already have
+ *   been submitted. Post-submit callers must treat an approve miss as
+ *   inconclusive and avoid opening a duplicate approve prompt.
  * - `detected: false, reason: 'invalid-state'` — transfer already advanced
  *   past CREATED (race); the next orchestrator loop will observe it.
  * - `detected: false, reason: 'error'` — unexpected failure (network, 5xx);
@@ -1111,13 +1130,14 @@ interface OrchestratorRunOptions {
     alwaysPauseForOneTap?: boolean;
     /**
      * When true (default), before presenting the wallet for any of
-     * APPROVE_PERMIT2 / SIGN_PERMIT2 / APPROVE_SPL / EXECUTE_BRIDGE on this run, probe
+     * SIGN_PERMIT2 / APPROVE_SPL on this run, probe
      * the server to see if the action is already satisfied on-chain (e.g.
      * user confirmed pre-reload but the PATCH never landed, signed in
      * another tab, or the wallet returned a stale error after broadcasting).
+     * APPROVE_PERMIT2 is probed only after the orchestrator has evidence an
+     * approve transaction may already have been submitted.
      *
      * Probe semantics per action type:
-     *   - APPROVE_PERMIT2: backend re-checks ERC-20 allowance for Permit2.
      *   - SIGN_PERMIT2:    backend re-checks Permit2 allowance (single &
      *                      batched paths).
      *   - APPROVE_SPL:     backend re-checks SPL delegate authority.
@@ -1414,6 +1434,7 @@ interface StepHandlers {
     /** Leave funding subflow (setup / token picker) back to deposit: restore selection, cancel executor. */
     onBackFromSubflow: () => void;
     onLogin: () => void;
+    onCancelLogin: () => void;
     onSetDepositAmount: (amount: number) => void;
     onSetDepositToken: (symbol: string, chainName: string, walletId?: string, tokenAddress?: string, chainId?: number) => void;
     onConfirmSetupDeposit: () => void | Promise<void>;
@@ -1424,6 +1445,14 @@ interface StepRendererFlowProps {
     authenticated: boolean;
     passkeyLoading: boolean;
     isDesktop: boolean;
+    /**
+     * True when the SDK is hosted inside a native mobile app's in-app browser.
+     * Suppresses in-screen (X) close buttons (the host's native chrome handles
+     * dismissal) and removes rounded screen corners. Optional for backwards
+     * compatibility with pre-existing test fixtures; treated as `false` when
+     * absent.
+     */
+    isMobileApp?: boolean;
     merchantName?: string;
     onBack?: () => void;
     onDismiss?: () => void;