@swype-org/react-sdk 0.1.0 → 0.1.2

package/dist/index.d.cts

@@ -27,6 +27,11 @@ interface WalletSource {
     token: WalletToken;
     balance: TokenBalance;
 }
+/** Token + chain most recently authorized via Permit2 for a wallet */
+interface LastAuthorizedToken {
+    symbol: string;
+    chainName: string;
+}
 /** Full wallet with chain, balance, and token sources */
 interface Wallet {
     id: string;
@@ -38,6 +43,8 @@ interface Wallet {
         id: string;
         name: string;
     };
+    /** The token+chain most recently authorized via Permit2, if any. */
+    lastAuthorizedToken?: LastAuthorizedToken | null;
     createDate: string;
     updateDate: string;
     authorizationSessions?: AuthorizationSession[];
@@ -123,6 +130,11 @@ interface ActionExecutionResult {
 }
 /** Source type discriminator for transfer creation */
 type SourceType = 'providerId' | 'accountId' | 'walletId' | 'tokenId';
+/** User's chain+token selection for the SELECT_SOURCE action. */
+interface SourceSelection {
+    chainName: string;
+    tokenSymbol: string;
+}
 /** Destination input provided by the host app */
 interface Destination {
     chainId: string;
@@ -142,7 +154,19 @@ interface UserConfig {
 /** Theme mode */
 type ThemeMode = 'light' | 'dark';
 /** Steps in the payment flow */
-type PaymentStep = 'login' | 'select-source' | 'enter-amount' | 'processing' | 'complete';
+type PaymentStep = 'login' | 'enter-amount' | 'ready' | 'processing' | 'complete';
+/** User-selected advanced settings for chain/asset override */
+interface AdvancedSettings {
+    /** Override asset (e.g. 'USDC', 'USDT'). Null = let backend decide. */
+    asset: string | null;
+    /** Override chain name (e.g. 'Base', 'Ethereum'). Null = let backend decide. */
+    chain: string | null;
+}
+/** User's top-up allowance selection for the SIGN_PERMIT2 action. */
+interface AllowanceSelection {
+    /** Extra amount (in human-readable units, e.g. 100 = $100) to add on top of the transfer amount. */
+    topUpAmount: number;
+}
 
 interface ThemeTokens {
     bg: string;
@@ -176,6 +200,10 @@ interface SwypeConfig {
     apiBaseUrl: string;
     theme: ThemeMode;
     tokens: ThemeTokens;
+    /** Pre-set deposit amount (controlled by host app via useSwypeDepositAmount) */
+    depositAmount: number | null;
+    /** Update the deposit amount from a host-app component */
+    setDepositAmount: (amount: number | null) => void;
 }
 interface SwypeProviderProps {
     /** Base URL for the Swype API (e.g. "http://localhost:3000") */
@@ -201,6 +229,26 @@ interface SwypeProviderProps {
 declare function SwypeProvider({ apiBaseUrl, theme, children, }: SwypeProviderProps): react_jsx_runtime.JSX.Element;
 /** Access the Swype SDK configuration. Throws if used outside SwypeProvider. */
 declare function useSwypeConfig(): SwypeConfig;
+/**
+ * Hook for host apps to pre-set the deposit amount before showing the
+ * payment widget. When set, the amount field in SwypePayment is
+ * auto-populated.
+ *
+ * @example
+ * ```tsx
+ * function ProductPage() {
+ *   const { setAmount } = useSwypeDepositAmount();
+ *   useEffect(() => { setAmount(25.00); }, []);
+ *   return <SwypePayment destination={dest} />;
+ * }
+ * ```
+ */
+declare function useSwypeDepositAmount(): {
+    /** Current deposit amount, or null if not set */
+    amount: number | null;
+    /** Set the deposit amount (pass null to clear) */
+    setAmount: (amount: number | null) => void;
+};
 
 interface SwypePaymentProps {
     /**
@@ -233,13 +281,26 @@ interface UseAuthorizationExecutorResult {
     executing: boolean;
     results: ActionExecutionResult[];
     error: string | null;
+    /** The SELECT_SOURCE action when paused for user selection, null otherwise. */
+    pendingSelectSource: AuthorizationAction | null;
+    /** Call this from the UI to provide the user's chain+token choice. */
+    resolveSelectSource: (selection: SourceSelection) => void;
+    /** The SIGN_PERMIT2 action when paused for allowance selection, null otherwise. */
+    pendingAllowanceSelection: AuthorizationAction | null;
+    /** Call this from the UI to provide the user's top-up allowance choice. */
+    resolveAllowanceSelection: (selection: AllowanceSelection) => void;
     executeSession: (transfer: Transfer) => Promise<void>;
 }
 /**
  * Executes the full authorization flow for a transfer's first session:
  * fetches the session, walks through PENDING actions (OPEN_PROVIDER,
- * SWITCH_CHAIN, APPROVE_PERMIT_2, SIGN_PERMIT2), reports each completion
- * to the server, and chains new actions that appear.
+ * SELECT_SOURCE, SWITCH_CHAIN, APPROVE_PERMIT_2, SIGN_PERMIT2), reports
+ * each completion to the server, and chains new actions that appear.
+ *
+ * When a SELECT_SOURCE action is encountered, the executor pauses and
+ * exposes the action via `pendingSelectSource`. The UI should display
+ * a chain+token selector and call `resolveSelectSource()` with the
+ * user's choice. The executor then resumes automatically.
  */
 declare function useAuthorizationExecutor(): UseAuthorizationExecutorResult;
 
@@ -259,6 +320,16 @@ declare function fetchAuthorizationSession(apiBaseUrl: string, sessionId: string
 declare function updateUserConfig(apiBaseUrl: string, token: string, config: {
     defaultAllowance: number;
 }): Promise<void>;
+/**
+ * Updates the user's default allowance, authenticated by session ID.
+ * PATCH /v1/authorization-sessions/{id}/user-config
+ *
+ * This does not require a bearer token — the session ID itself serves
+ * as proof of authorization.
+ */
+declare function updateUserConfigBySession(apiBaseUrl: string, sessionId: string, config: {
+    defaultAllowance: number;
+}): Promise<void>;
 declare function reportActionCompletion(apiBaseUrl: string, actionId: string, result: Record<string, unknown>): Promise<AuthorizationSessionDetail>;
 
 type api_CreateTransferParams = CreateTransferParams;
@@ -270,8 +341,9 @@ declare const api_fetchProviders: typeof fetchProviders;
 declare const api_fetchTransfer: typeof fetchTransfer;
 declare const api_reportActionCompletion: typeof reportActionCompletion;
 declare const api_updateUserConfig: typeof updateUserConfig;
+declare const api_updateUserConfigBySession: typeof updateUserConfigBySession;
 declare namespace api {
-  export { type api_CreateTransferParams as CreateTransferParams, api_createTransfer as createTransfer, api_fetchAccounts as fetchAccounts, api_fetchAuthorizationSession as fetchAuthorizationSession, api_fetchChains as fetchChains, api_fetchProviders as fetchProviders, api_fetchTransfer as fetchTransfer, api_reportActionCompletion as reportActionCompletion, api_updateUserConfig as updateUserConfig };
+  export { type api_CreateTransferParams as CreateTransferParams, api_createTransfer as createTransfer, api_fetchAccounts as fetchAccounts, api_fetchAuthorizationSession as fetchAuthorizationSession, api_fetchChains as fetchChains, api_fetchProviders as fetchProviders, api_fetchTransfer as fetchTransfer, api_reportActionCompletion as reportActionCompletion, api_updateUserConfig as updateUserConfig, api_updateUserConfigBySession as updateUserConfigBySession };
 }
 
-export { type Account, type ActionExecutionResult, type Amount, type AuthorizationAction, type AuthorizationSession, type AuthorizationSessionDetail, type Chain, type Destination, type ErrorResponse, type ListResponse, type PaymentStep, type Provider, type SourceType, SwypePayment, type SwypePaymentProps, SwypeProvider, type SwypeProviderProps, type ThemeMode, type ThemeTokens, type TokenBalance, type Transfer, type TransferDestination, type UserConfig, type Wallet, type WalletSource, type WalletToken, darkTheme, getTheme, lightTheme, api as swypeApi, useAuthorizationExecutor, useSwypeConfig, useTransferPolling };
+export { type Account, type ActionExecutionResult, type AdvancedSettings, type Amount, type AuthorizationAction, type AuthorizationSession, type AuthorizationSessionDetail, type Chain, type Destination, type ErrorResponse, type ListResponse, type PaymentStep, type Provider, type SourceType, SwypePayment, type SwypePaymentProps, SwypeProvider, type SwypeProviderProps, type ThemeMode, type ThemeTokens, type TokenBalance, type Transfer, type TransferDestination, type UserConfig, type Wallet, type WalletSource, type WalletToken, darkTheme, getTheme, lightTheme, api as swypeApi, useAuthorizationExecutor, useSwypeConfig, useSwypeDepositAmount, useTransferPolling };

package/dist/index.d.ts

@@ -27,6 +27,11 @@ interface WalletSource {
     token: WalletToken;
     balance: TokenBalance;
 }
+/** Token + chain most recently authorized via Permit2 for a wallet */
+interface LastAuthorizedToken {
+    symbol: string;
+    chainName: string;
+}
 /** Full wallet with chain, balance, and token sources */
 interface Wallet {
     id: string;
@@ -38,6 +43,8 @@ interface Wallet {
         id: string;
         name: string;
     };
+    /** The token+chain most recently authorized via Permit2, if any. */
+    lastAuthorizedToken?: LastAuthorizedToken | null;
     createDate: string;
     updateDate: string;
     authorizationSessions?: AuthorizationSession[];
@@ -123,6 +130,11 @@ interface ActionExecutionResult {
 }
 /** Source type discriminator for transfer creation */
 type SourceType = 'providerId' | 'accountId' | 'walletId' | 'tokenId';
+/** User's chain+token selection for the SELECT_SOURCE action. */
+interface SourceSelection {
+    chainName: string;
+    tokenSymbol: string;
+}
 /** Destination input provided by the host app */
 interface Destination {
     chainId: string;
@@ -142,7 +154,19 @@ interface UserConfig {
 /** Theme mode */
 type ThemeMode = 'light' | 'dark';
 /** Steps in the payment flow */
-type PaymentStep = 'login' | 'select-source' | 'enter-amount' | 'processing' | 'complete';
+type PaymentStep = 'login' | 'enter-amount' | 'ready' | 'processing' | 'complete';
+/** User-selected advanced settings for chain/asset override */
+interface AdvancedSettings {
+    /** Override asset (e.g. 'USDC', 'USDT'). Null = let backend decide. */
+    asset: string | null;
+    /** Override chain name (e.g. 'Base', 'Ethereum'). Null = let backend decide. */
+    chain: string | null;
+}
+/** User's top-up allowance selection for the SIGN_PERMIT2 action. */
+interface AllowanceSelection {
+    /** Extra amount (in human-readable units, e.g. 100 = $100) to add on top of the transfer amount. */
+    topUpAmount: number;
+}
 
 interface ThemeTokens {
     bg: string;
@@ -176,6 +200,10 @@ interface SwypeConfig {
     apiBaseUrl: string;
     theme: ThemeMode;
     tokens: ThemeTokens;
+    /** Pre-set deposit amount (controlled by host app via useSwypeDepositAmount) */
+    depositAmount: number | null;
+    /** Update the deposit amount from a host-app component */
+    setDepositAmount: (amount: number | null) => void;
 }
 interface SwypeProviderProps {
     /** Base URL for the Swype API (e.g. "http://localhost:3000") */
@@ -201,6 +229,26 @@ interface SwypeProviderProps {
 declare function SwypeProvider({ apiBaseUrl, theme, children, }: SwypeProviderProps): react_jsx_runtime.JSX.Element;
 /** Access the Swype SDK configuration. Throws if used outside SwypeProvider. */
 declare function useSwypeConfig(): SwypeConfig;
+/**
+ * Hook for host apps to pre-set the deposit amount before showing the
+ * payment widget. When set, the amount field in SwypePayment is
+ * auto-populated.
+ *
+ * @example
+ * ```tsx
+ * function ProductPage() {
+ *   const { setAmount } = useSwypeDepositAmount();
+ *   useEffect(() => { setAmount(25.00); }, []);
+ *   return <SwypePayment destination={dest} />;
+ * }
+ * ```
+ */
+declare function useSwypeDepositAmount(): {
+    /** Current deposit amount, or null if not set */
+    amount: number | null;
+    /** Set the deposit amount (pass null to clear) */
+    setAmount: (amount: number | null) => void;
+};
 
 interface SwypePaymentProps {
     /**
@@ -233,13 +281,26 @@ interface UseAuthorizationExecutorResult {
     executing: boolean;
     results: ActionExecutionResult[];
     error: string | null;
+    /** The SELECT_SOURCE action when paused for user selection, null otherwise. */
+    pendingSelectSource: AuthorizationAction | null;
+    /** Call this from the UI to provide the user's chain+token choice. */
+    resolveSelectSource: (selection: SourceSelection) => void;
+    /** The SIGN_PERMIT2 action when paused for allowance selection, null otherwise. */
+    pendingAllowanceSelection: AuthorizationAction | null;
+    /** Call this from the UI to provide the user's top-up allowance choice. */
+    resolveAllowanceSelection: (selection: AllowanceSelection) => void;
     executeSession: (transfer: Transfer) => Promise<void>;
 }
 /**
  * Executes the full authorization flow for a transfer's first session:
  * fetches the session, walks through PENDING actions (OPEN_PROVIDER,
- * SWITCH_CHAIN, APPROVE_PERMIT_2, SIGN_PERMIT2), reports each completion
- * to the server, and chains new actions that appear.
+ * SELECT_SOURCE, SWITCH_CHAIN, APPROVE_PERMIT_2, SIGN_PERMIT2), reports
+ * each completion to the server, and chains new actions that appear.
+ *
+ * When a SELECT_SOURCE action is encountered, the executor pauses and
+ * exposes the action via `pendingSelectSource`. The UI should display
+ * a chain+token selector and call `resolveSelectSource()` with the
+ * user's choice. The executor then resumes automatically.
  */
 declare function useAuthorizationExecutor(): UseAuthorizationExecutorResult;
 
@@ -259,6 +320,16 @@ declare function fetchAuthorizationSession(apiBaseUrl: string, sessionId: string
 declare function updateUserConfig(apiBaseUrl: string, token: string, config: {
     defaultAllowance: number;
 }): Promise<void>;
+/**
+ * Updates the user's default allowance, authenticated by session ID.
+ * PATCH /v1/authorization-sessions/{id}/user-config
+ *
+ * This does not require a bearer token — the session ID itself serves
+ * as proof of authorization.
+ */
+declare function updateUserConfigBySession(apiBaseUrl: string, sessionId: string, config: {
+    defaultAllowance: number;
+}): Promise<void>;
 declare function reportActionCompletion(apiBaseUrl: string, actionId: string, result: Record<string, unknown>): Promise<AuthorizationSessionDetail>;
 
 type api_CreateTransferParams = CreateTransferParams;
@@ -270,8 +341,9 @@ declare const api_fetchProviders: typeof fetchProviders;
 declare const api_fetchTransfer: typeof fetchTransfer;
 declare const api_reportActionCompletion: typeof reportActionCompletion;
 declare const api_updateUserConfig: typeof updateUserConfig;
+declare const api_updateUserConfigBySession: typeof updateUserConfigBySession;
 declare namespace api {
-  export { type api_CreateTransferParams as CreateTransferParams, api_createTransfer as createTransfer, api_fetchAccounts as fetchAccounts, api_fetchAuthorizationSession as fetchAuthorizationSession, api_fetchChains as fetchChains, api_fetchProviders as fetchProviders, api_fetchTransfer as fetchTransfer, api_reportActionCompletion as reportActionCompletion, api_updateUserConfig as updateUserConfig };
+  export { type api_CreateTransferParams as CreateTransferParams, api_createTransfer as createTransfer, api_fetchAccounts as fetchAccounts, api_fetchAuthorizationSession as fetchAuthorizationSession, api_fetchChains as fetchChains, api_fetchProviders as fetchProviders, api_fetchTransfer as fetchTransfer, api_reportActionCompletion as reportActionCompletion, api_updateUserConfig as updateUserConfig, api_updateUserConfigBySession as updateUserConfigBySession };
 }
 
-export { type Account, type ActionExecutionResult, type Amount, type AuthorizationAction, type AuthorizationSession, type AuthorizationSessionDetail, type Chain, type Destination, type ErrorResponse, type ListResponse, type PaymentStep, type Provider, type SourceType, SwypePayment, type SwypePaymentProps, SwypeProvider, type SwypeProviderProps, type ThemeMode, type ThemeTokens, type TokenBalance, type Transfer, type TransferDestination, type UserConfig, type Wallet, type WalletSource, type WalletToken, darkTheme, getTheme, lightTheme, api as swypeApi, useAuthorizationExecutor, useSwypeConfig, useTransferPolling };
+export { type Account, type ActionExecutionResult, type AdvancedSettings, type Amount, type AuthorizationAction, type AuthorizationSession, type AuthorizationSessionDetail, type Chain, type Destination, type ErrorResponse, type ListResponse, type PaymentStep, type Provider, type SourceType, SwypePayment, type SwypePaymentProps, SwypeProvider, type SwypeProviderProps, type ThemeMode, type ThemeTokens, type TokenBalance, type Transfer, type TransferDestination, type UserConfig, type Wallet, type WalletSource, type WalletToken, darkTheme, getTheme, lightTheme, api as swypeApi, useAuthorizationExecutor, useSwypeConfig, useSwypeDepositAmount, useTransferPolling };