@swype-org/react-sdk 0.2.223 → 0.2.224

package/dist/index.d.cts

@@ -500,6 +500,13 @@ interface CreateAccountParams {
     nickname?: string;
     paymentIntent?: {
         merchantAuthorization: MerchantAuthorization;
+        /**
+         * Optional user-entered amount (USD) from the SDK's amount-entry screen.
+         * Forwarded to the backend so the resulting session's `paymentIntent`
+         * reflects the user's amount before `auth-app` opens. Only applied
+         * server-side when the merchant payload's `amount` is `null`.
+         */
+        amount?: number;
     };
 }
 declare function createAccount(apiBaseUrl: string, token: string, params: CreateAccountParams): Promise<Account>;
@@ -508,6 +515,13 @@ interface CreateAccountAuthorizationSessionOptions {
     chainId?: number;
     paymentIntent?: {
         merchantAuthorization: MerchantAuthorization;
+        /**
+         * Optional user-entered amount (USD) from the SDK's amount-entry screen.
+         * Forwarded to the backend so the resulting session's `paymentIntent`
+         * reflects the user's amount before `auth-app` opens. Only applied
+         * server-side when the merchant payload's `amount` is `null`.
+         */
+        amount?: number;
     };
 }
 declare function createAccountAuthorizationSession(apiBaseUrl: string, token: string, accountId: string, credentialId: string, options?: CreateAccountAuthorizationSessionOptions): Promise<AuthorizationSession>;
@@ -605,6 +619,20 @@ declare function updateUserConfig(apiBaseUrl: string, token: string, config: {
  * PATCH /v1/authorization-sessions/{id}
  */
 declare function setAuthorizationSessionProvider(apiBaseUrl: string, sessionId: string, providerId: string): Promise<AuthorizationSessionDetail>;
+/**
+ * Overlays a user-entered amount onto an existing authorization session's
+ * `paymentIntent.transferRequest.amount`. Used by the host SDK after a
+ * session has been created when the user changes the deposit amount (e.g.
+ * backs out of the wallet picker and edits the amount).
+ *
+ * No bearer token — the session id is the credential. Only honored when
+ * the merchant deferred the amount on the original signed payload; the
+ * server returns the (unchanged) session as a 200 no-op when the merchant
+ * fixed the amount.
+ *
+ * PATCH /v1/authorization-sessions/{id}/payment-intent
+ */
+declare function setAuthorizationSessionPaymentIntentAmount(apiBaseUrl: string, sessionId: string, amount: number): Promise<AuthorizationSessionDetail>;
 /**
  * Updates default allowance for the authorization session.
  * PATCH /v1/authorization-sessions/{id}/user-config
@@ -709,6 +737,7 @@ declare const api_probeActionCompletion: typeof probeActionCompletion;
 declare const api_registerPasskey: typeof registerPasskey;
 declare const api_reportActionCompletion: typeof reportActionCompletion;
 declare const api_reportPasskeyActivity: typeof reportPasskeyActivity;
+declare const api_setAuthorizationSessionPaymentIntentAmount: typeof setAuthorizationSessionPaymentIntentAmount;
 declare const api_setAuthorizationSessionProvider: typeof setAuthorizationSessionProvider;
 declare const api_setTransferSource: typeof setTransferSource;
 declare const api_signTransfer: typeof signTransfer;
@@ -716,7 +745,7 @@ declare const api_updateUserConfig: typeof updateUserConfig;
 declare const api_updateUserConfigBySession: typeof updateUserConfigBySession;
 declare const api_waitForActionTransactionReceipt: typeof waitForActionTransactionReceipt;
 declare namespace api {
-  export { type api_ActionTransactionReceiptWaitResult as ActionTransactionReceiptWaitResult, type api_BridgeCall as BridgeCall, type api_CreateAccountAuthorizationSessionOptions as CreateAccountAuthorizationSessionOptions, type api_CreateAccountParams as CreateAccountParams, type api_CreateManualTransferParams as CreateManualTransferParams, type api_CreateTransferParams as CreateTransferParams, type api_FetchManualTransferSourcesParams as FetchManualTransferSourcesParams, type api_ProbeActionCompletionResult as ProbeActionCompletionResult, type api_TransferQuote as TransferQuote, api_createAccount as createAccount, api_createAccountAuthorizationSession as createAccountAuthorizationSession, api_createManualTransfer as createManualTransfer, api_createTransfer as createTransfer, api_fetchAccount as fetchAccount, api_fetchAccounts as fetchAccounts, api_fetchAuthorizationSession as fetchAuthorizationSession, api_fetchAuthorizationSessionByToken as fetchAuthorizationSessionByToken, api_fetchChains as fetchChains, api_fetchManualTransferSession as fetchManualTransferSession, api_fetchManualTransferSources as fetchManualTransferSources, api_fetchMerchantPublicKey as fetchMerchantPublicKey, api_fetchProviders as fetchProviders, api_fetchTransfer as fetchTransfer, api_fetchUserConfig as fetchUserConfig, api_postTransferQuote as postTransferQuote, api_probeActionCompletion as probeActionCompletion, api_registerPasskey as registerPasskey, api_reportActionCompletion as reportActionCompletion, api_reportPasskeyActivity as reportPasskeyActivity, api_setAuthorizationSessionProvider as setAuthorizationSessionProvider, api_setTransferSource as setTransferSource, api_signTransfer as signTransfer, api_updateUserConfig as updateUserConfig, api_updateUserConfigBySession as updateUserConfigBySession, api_waitForActionTransactionReceipt as waitForActionTransactionReceipt };
+  export { type api_ActionTransactionReceiptWaitResult as ActionTransactionReceiptWaitResult, type api_BridgeCall as BridgeCall, type api_CreateAccountAuthorizationSessionOptions as CreateAccountAuthorizationSessionOptions, type api_CreateAccountParams as CreateAccountParams, type api_CreateManualTransferParams as CreateManualTransferParams, type api_CreateTransferParams as CreateTransferParams, type api_FetchManualTransferSourcesParams as FetchManualTransferSourcesParams, type api_ProbeActionCompletionResult as ProbeActionCompletionResult, type api_TransferQuote as TransferQuote, api_createAccount as createAccount, api_createAccountAuthorizationSession as createAccountAuthorizationSession, api_createManualTransfer as createManualTransfer, api_createTransfer as createTransfer, api_fetchAccount as fetchAccount, api_fetchAccounts as fetchAccounts, api_fetchAuthorizationSession as fetchAuthorizationSession, api_fetchAuthorizationSessionByToken as fetchAuthorizationSessionByToken, api_fetchChains as fetchChains, api_fetchManualTransferSession as fetchManualTransferSession, api_fetchManualTransferSources as fetchManualTransferSources, api_fetchMerchantPublicKey as fetchMerchantPublicKey, api_fetchProviders as fetchProviders, api_fetchTransfer as fetchTransfer, api_fetchUserConfig as fetchUserConfig, api_postTransferQuote as postTransferQuote, api_probeActionCompletion as probeActionCompletion, api_registerPasskey as registerPasskey, api_reportActionCompletion as reportActionCompletion, api_reportPasskeyActivity as reportPasskeyActivity, api_setAuthorizationSessionPaymentIntentAmount as setAuthorizationSessionPaymentIntentAmount, api_setAuthorizationSessionProvider as setAuthorizationSessionProvider, api_setTransferSource as setTransferSource, api_signTransfer as signTransfer, api_updateUserConfig as updateUserConfig, api_updateUserConfigBySession as updateUserConfigBySession, api_waitForActionTransactionReceipt as waitForActionTransactionReceipt };
 }
 
 interface BlinkPaymentProps {
@@ -748,7 +777,7 @@ interface SelectSourceChainChoice {
     }[];
 }
 
-type ScreenName = 'loading' | 'manual-transfer' | 'login' | 'success' | 'processing' | 'confirm-sign' | 'select-source' | 'setup' | 'open-wallet' | 'setup-deposit' | 'passkey-ready' | 'wallet-picker' | 'token-picker' | 'guest-source-picker' | 'amount-too-low' | 'deposit' | 'deposit-options';
+type ScreenName = 'loading' | 'manual-transfer' | 'login' | 'success' | 'processing' | 'confirm-sign' | 'select-source' | 'setup' | 'open-wallet' | 'setup-deposit' | 'passkey-ready' | 'wallet-picker' | 'token-picker' | 'guest-source-picker' | 'amount-too-low' | 'enter-amount' | 'deposit' | 'deposit-options';
 interface MobileFlowState {
     deeplinkUri: string;
     providerId: string | null;
@@ -813,6 +842,8 @@ type PaymentPhase = {
 } | {
     step: 'amount-too-low';
     minAmountUsd: number;
+} | {
+    step: 'enter-amount';
 };
 declare function screenForPhase(phase: PaymentPhase): ScreenName;
 
@@ -1386,6 +1417,13 @@ interface PaymentState {
      * options screen.
      */
     enableFullWidget: boolean;
+    /**
+     * When true, gate every other fresh phase on the user entering an amount
+     * inside the hosted flow. Initialized from `depositAmount == null` and
+     * cleared by `FINALIZE_AMOUNT` (user tapped Continue) or by `SYNC_AMOUNT`
+     * when the host later supplies a non-empty amount.
+     */
+    requireAmountEntry: boolean;
 }
 interface InitialStateConfig {
     depositAmount: number | null;
@@ -1436,6 +1474,18 @@ interface StepHandlers {
     onLogin: () => void;
     onCancelLogin: () => void;
     onSetDepositAmount: (amount: number) => void;
+    /**
+     * Update the in-flow amount-entry value (string display). Called by
+     * EnterAmountScreen on every keypress / preset tap. The view-model wires
+     * pure helpers (`enterAmountInput.ts`) into this handler so the component
+     * itself stays presentational.
+     */
+    onAmountInput: (value: string) => void;
+    /**
+     * Commit the in-flow amount-entry value and clear `requireAmountEntry`.
+     * Routes the user past the EnterAmountScreen back into the normal flow.
+     */
+    onFinalizeAmount: () => void;
     onSetDepositToken: (symbol: string, chainName: string, walletId?: string, tokenAddress?: string, chainId?: number) => void;
     onConfirmSetupDeposit: () => void | Promise<void>;
 }
@@ -1456,7 +1506,17 @@ interface StepRendererFlowProps {
     merchantName?: string;
     onBack?: () => void;
     onDismiss?: () => void;
+    /** Merchant-fixed depositAmount, or `null` for the hosted EnterAmountScreen flow. */
     depositAmount: number | null;
+    /**
+     * Effective deposit amount = `parseAmount(state.amount) ?? depositAmount`.
+     * View models should read this for display so the user's typed value from
+     * `EnterAmountScreen` propagates through `deposit`, `setup-deposit`,
+     * `processing`, and `token-picker` screens. `depositAmount` is retained
+     * separately for "did the merchant fix this?" semantics (e.g.
+     * `AmountTooLowScreen.canRetry`).
+     */
+    effectiveDepositAmount: number | null;
     minTransferAmountUsd: number;
     /** Needed to render ManualTransferFlow when phase is manual-transfer. */
     destination: Destination;

package/dist/index.d.ts

@@ -500,6 +500,13 @@ interface CreateAccountParams {
     nickname?: string;
     paymentIntent?: {
         merchantAuthorization: MerchantAuthorization;
+        /**
+         * Optional user-entered amount (USD) from the SDK's amount-entry screen.
+         * Forwarded to the backend so the resulting session's `paymentIntent`
+         * reflects the user's amount before `auth-app` opens. Only applied
+         * server-side when the merchant payload's `amount` is `null`.
+         */
+        amount?: number;
     };
 }
 declare function createAccount(apiBaseUrl: string, token: string, params: CreateAccountParams): Promise<Account>;
@@ -508,6 +515,13 @@ interface CreateAccountAuthorizationSessionOptions {
     chainId?: number;
     paymentIntent?: {
         merchantAuthorization: MerchantAuthorization;
+        /**
+         * Optional user-entered amount (USD) from the SDK's amount-entry screen.
+         * Forwarded to the backend so the resulting session's `paymentIntent`
+         * reflects the user's amount before `auth-app` opens. Only applied
+         * server-side when the merchant payload's `amount` is `null`.
+         */
+        amount?: number;
     };
 }
 declare function createAccountAuthorizationSession(apiBaseUrl: string, token: string, accountId: string, credentialId: string, options?: CreateAccountAuthorizationSessionOptions): Promise<AuthorizationSession>;
@@ -605,6 +619,20 @@ declare function updateUserConfig(apiBaseUrl: string, token: string, config: {
  * PATCH /v1/authorization-sessions/{id}
  */
 declare function setAuthorizationSessionProvider(apiBaseUrl: string, sessionId: string, providerId: string): Promise<AuthorizationSessionDetail>;
+/**
+ * Overlays a user-entered amount onto an existing authorization session's
+ * `paymentIntent.transferRequest.amount`. Used by the host SDK after a
+ * session has been created when the user changes the deposit amount (e.g.
+ * backs out of the wallet picker and edits the amount).
+ *
+ * No bearer token — the session id is the credential. Only honored when
+ * the merchant deferred the amount on the original signed payload; the
+ * server returns the (unchanged) session as a 200 no-op when the merchant
+ * fixed the amount.
+ *
+ * PATCH /v1/authorization-sessions/{id}/payment-intent
+ */
+declare function setAuthorizationSessionPaymentIntentAmount(apiBaseUrl: string, sessionId: string, amount: number): Promise<AuthorizationSessionDetail>;
 /**
  * Updates default allowance for the authorization session.
  * PATCH /v1/authorization-sessions/{id}/user-config
@@ -709,6 +737,7 @@ declare const api_probeActionCompletion: typeof probeActionCompletion;
 declare const api_registerPasskey: typeof registerPasskey;
 declare const api_reportActionCompletion: typeof reportActionCompletion;
 declare const api_reportPasskeyActivity: typeof reportPasskeyActivity;
+declare const api_setAuthorizationSessionPaymentIntentAmount: typeof setAuthorizationSessionPaymentIntentAmount;
 declare const api_setAuthorizationSessionProvider: typeof setAuthorizationSessionProvider;
 declare const api_setTransferSource: typeof setTransferSource;
 declare const api_signTransfer: typeof signTransfer;
@@ -716,7 +745,7 @@ declare const api_updateUserConfig: typeof updateUserConfig;
 declare const api_updateUserConfigBySession: typeof updateUserConfigBySession;
 declare const api_waitForActionTransactionReceipt: typeof waitForActionTransactionReceipt;
 declare namespace api {
-  export { type api_ActionTransactionReceiptWaitResult as ActionTransactionReceiptWaitResult, type api_BridgeCall as BridgeCall, type api_CreateAccountAuthorizationSessionOptions as CreateAccountAuthorizationSessionOptions, type api_CreateAccountParams as CreateAccountParams, type api_CreateManualTransferParams as CreateManualTransferParams, type api_CreateTransferParams as CreateTransferParams, type api_FetchManualTransferSourcesParams as FetchManualTransferSourcesParams, type api_ProbeActionCompletionResult as ProbeActionCompletionResult, type api_TransferQuote as TransferQuote, api_createAccount as createAccount, api_createAccountAuthorizationSession as createAccountAuthorizationSession, api_createManualTransfer as createManualTransfer, api_createTransfer as createTransfer, api_fetchAccount as fetchAccount, api_fetchAccounts as fetchAccounts, api_fetchAuthorizationSession as fetchAuthorizationSession, api_fetchAuthorizationSessionByToken as fetchAuthorizationSessionByToken, api_fetchChains as fetchChains, api_fetchManualTransferSession as fetchManualTransferSession, api_fetchManualTransferSources as fetchManualTransferSources, api_fetchMerchantPublicKey as fetchMerchantPublicKey, api_fetchProviders as fetchProviders, api_fetchTransfer as fetchTransfer, api_fetchUserConfig as fetchUserConfig, api_postTransferQuote as postTransferQuote, api_probeActionCompletion as probeActionCompletion, api_registerPasskey as registerPasskey, api_reportActionCompletion as reportActionCompletion, api_reportPasskeyActivity as reportPasskeyActivity, api_setAuthorizationSessionProvider as setAuthorizationSessionProvider, api_setTransferSource as setTransferSource, api_signTransfer as signTransfer, api_updateUserConfig as updateUserConfig, api_updateUserConfigBySession as updateUserConfigBySession, api_waitForActionTransactionReceipt as waitForActionTransactionReceipt };
+  export { type api_ActionTransactionReceiptWaitResult as ActionTransactionReceiptWaitResult, type api_BridgeCall as BridgeCall, type api_CreateAccountAuthorizationSessionOptions as CreateAccountAuthorizationSessionOptions, type api_CreateAccountParams as CreateAccountParams, type api_CreateManualTransferParams as CreateManualTransferParams, type api_CreateTransferParams as CreateTransferParams, type api_FetchManualTransferSourcesParams as FetchManualTransferSourcesParams, type api_ProbeActionCompletionResult as ProbeActionCompletionResult, type api_TransferQuote as TransferQuote, api_createAccount as createAccount, api_createAccountAuthorizationSession as createAccountAuthorizationSession, api_createManualTransfer as createManualTransfer, api_createTransfer as createTransfer, api_fetchAccount as fetchAccount, api_fetchAccounts as fetchAccounts, api_fetchAuthorizationSession as fetchAuthorizationSession, api_fetchAuthorizationSessionByToken as fetchAuthorizationSessionByToken, api_fetchChains as fetchChains, api_fetchManualTransferSession as fetchManualTransferSession, api_fetchManualTransferSources as fetchManualTransferSources, api_fetchMerchantPublicKey as fetchMerchantPublicKey, api_fetchProviders as fetchProviders, api_fetchTransfer as fetchTransfer, api_fetchUserConfig as fetchUserConfig, api_postTransferQuote as postTransferQuote, api_probeActionCompletion as probeActionCompletion, api_registerPasskey as registerPasskey, api_reportActionCompletion as reportActionCompletion, api_reportPasskeyActivity as reportPasskeyActivity, api_setAuthorizationSessionPaymentIntentAmount as setAuthorizationSessionPaymentIntentAmount, api_setAuthorizationSessionProvider as setAuthorizationSessionProvider, api_setTransferSource as setTransferSource, api_signTransfer as signTransfer, api_updateUserConfig as updateUserConfig, api_updateUserConfigBySession as updateUserConfigBySession, api_waitForActionTransactionReceipt as waitForActionTransactionReceipt };
 }
 
 interface BlinkPaymentProps {
@@ -748,7 +777,7 @@ interface SelectSourceChainChoice {
     }[];
 }
 
-type ScreenName = 'loading' | 'manual-transfer' | 'login' | 'success' | 'processing' | 'confirm-sign' | 'select-source' | 'setup' | 'open-wallet' | 'setup-deposit' | 'passkey-ready' | 'wallet-picker' | 'token-picker' | 'guest-source-picker' | 'amount-too-low' | 'deposit' | 'deposit-options';
+type ScreenName = 'loading' | 'manual-transfer' | 'login' | 'success' | 'processing' | 'confirm-sign' | 'select-source' | 'setup' | 'open-wallet' | 'setup-deposit' | 'passkey-ready' | 'wallet-picker' | 'token-picker' | 'guest-source-picker' | 'amount-too-low' | 'enter-amount' | 'deposit' | 'deposit-options';
 interface MobileFlowState {
     deeplinkUri: string;
     providerId: string | null;
@@ -813,6 +842,8 @@ type PaymentPhase = {
 } | {
     step: 'amount-too-low';
     minAmountUsd: number;
+} | {
+    step: 'enter-amount';
 };
 declare function screenForPhase(phase: PaymentPhase): ScreenName;
 
@@ -1386,6 +1417,13 @@ interface PaymentState {
      * options screen.
      */
     enableFullWidget: boolean;
+    /**
+     * When true, gate every other fresh phase on the user entering an amount
+     * inside the hosted flow. Initialized from `depositAmount == null` and
+     * cleared by `FINALIZE_AMOUNT` (user tapped Continue) or by `SYNC_AMOUNT`
+     * when the host later supplies a non-empty amount.
+     */
+    requireAmountEntry: boolean;
 }
 interface InitialStateConfig {
     depositAmount: number | null;
@@ -1436,6 +1474,18 @@ interface StepHandlers {
     onLogin: () => void;
     onCancelLogin: () => void;
     onSetDepositAmount: (amount: number) => void;
+    /**
+     * Update the in-flow amount-entry value (string display). Called by
+     * EnterAmountScreen on every keypress / preset tap. The view-model wires
+     * pure helpers (`enterAmountInput.ts`) into this handler so the component
+     * itself stays presentational.
+     */
+    onAmountInput: (value: string) => void;
+    /**
+     * Commit the in-flow amount-entry value and clear `requireAmountEntry`.
+     * Routes the user past the EnterAmountScreen back into the normal flow.
+     */
+    onFinalizeAmount: () => void;
     onSetDepositToken: (symbol: string, chainName: string, walletId?: string, tokenAddress?: string, chainId?: number) => void;
     onConfirmSetupDeposit: () => void | Promise<void>;
 }
@@ -1456,7 +1506,17 @@ interface StepRendererFlowProps {
     merchantName?: string;
     onBack?: () => void;
     onDismiss?: () => void;
+    /** Merchant-fixed depositAmount, or `null` for the hosted EnterAmountScreen flow. */
     depositAmount: number | null;
+    /**
+     * Effective deposit amount = `parseAmount(state.amount) ?? depositAmount`.
+     * View models should read this for display so the user's typed value from
+     * `EnterAmountScreen` propagates through `deposit`, `setup-deposit`,
+     * `processing`, and `token-picker` screens. `depositAmount` is retained
+     * separately for "did the merchant fix this?" semantics (e.g.
+     * `AmountTooLowScreen.canRetry`).
+     */
+    effectiveDepositAmount: number | null;
     minTransferAmountUsd: number;
     /** Needed to render ManualTransferFlow when phase is manual-transfer. */
     destination: Destination;