@swype-org/react-sdk 0.1.28 → 0.1.29

package/dist/index.d.cts

@@ -162,6 +162,18 @@ interface Destination {
         symbol: string;
     };
 }
+/** Merchant-signed authorization envelope required for transfer creation. */
+interface MerchantAuthorization {
+    merchantId: string;
+    payload: string;
+    signature: string;
+}
+/** Public key metadata used to verify merchant-signed payment links. */
+interface MerchantPublicKey {
+    merchantId: string;
+    algorithm: string;
+    publicKey: string;
+}
 /** List response wrapper */
 interface ListResponse<T> {
     items: T[];
@@ -274,6 +286,75 @@ declare function useSwypeDepositAmount(): {
     setAmount: (amount: number | null) => void;
 };
 
+declare function fetchProviders(apiBaseUrl: string, token: string): Promise<Provider[]>;
+declare function fetchChains(apiBaseUrl: string, token: string): Promise<Chain[]>;
+declare function fetchAccounts(apiBaseUrl: string, token: string, credentialId: string): Promise<Account[]>;
+interface CreateTransferParams {
+    /** Caller-supplied UUID v4 for idempotency. If omitted, a random UUID is generated. */
+    id?: string;
+    credentialId: string;
+    merchantAuthorization?: MerchantAuthorization;
+    sourceType: SourceType;
+    sourceId: string;
+    destination: Destination;
+    amount: number;
+    currency?: string;
+}
+declare function createTransfer(apiBaseUrl: string, token: string, params: CreateTransferParams): Promise<Transfer>;
+declare function fetchMerchantPublicKey(apiBaseUrl: string, merchantId: string): Promise<MerchantPublicKey>;
+declare function fetchTransfer(apiBaseUrl: string, token: string, transferId: string, authorizationSessionToken?: string): Promise<Transfer>;
+/**
+ * Submit a passkey-signed UserOperation for a transfer.
+ * PATCH /v1/transfers/{transferId}
+ */
+declare function signTransfer(apiBaseUrl: string, token: string, transferId: string, signedUserOp: Record<string, unknown>, authorizationSessionToken?: string): Promise<Transfer>;
+declare function fetchAuthorizationSession(apiBaseUrl: string, sessionId: string): Promise<AuthorizationSessionDetail>;
+/**
+ * Registers a WebAuthn passkey for the authenticated user.
+ * POST /v1/users/config/passkey
+ */
+declare function registerPasskey(apiBaseUrl: string, token: string, credentialId: string, publicKey: string): Promise<void>;
+/**
+ * Fetches the authenticated user's config, including passkey status.
+ * GET /v1/users/config
+ */
+declare function fetchUserConfig(apiBaseUrl: string, token: string): Promise<{
+    id: string;
+    config: UserConfig;
+}>;
+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;
+declare const api_createTransfer: typeof createTransfer;
+declare const api_fetchAccounts: typeof fetchAccounts;
+declare const api_fetchAuthorizationSession: typeof fetchAuthorizationSession;
+declare const api_fetchChains: typeof fetchChains;
+declare const api_fetchMerchantPublicKey: typeof fetchMerchantPublicKey;
+declare const api_fetchProviders: typeof fetchProviders;
+declare const api_fetchTransfer: typeof fetchTransfer;
+declare const api_fetchUserConfig: typeof fetchUserConfig;
+declare const api_registerPasskey: typeof registerPasskey;
+declare const api_reportActionCompletion: typeof reportActionCompletion;
+declare const api_signTransfer: typeof signTransfer;
+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_fetchMerchantPublicKey as fetchMerchantPublicKey, api_fetchProviders as fetchProviders, api_fetchTransfer as fetchTransfer, api_fetchUserConfig as fetchUserConfig, api_registerPasskey as registerPasskey, api_reportActionCompletion as reportActionCompletion, api_signTransfer as signTransfer, api_updateUserConfig as updateUserConfig, api_updateUserConfigBySession as updateUserConfigBySession };
+}
+
 interface SwypePaymentProps {
     /**
      * Where the funds go -- controlled by the host app (merchant).
@@ -305,8 +386,10 @@ interface SwypePaymentProps {
      * flow without creating duplicate transfers.
      */
     idempotencyKey?: string;
+    /** Merchant-signed transfer authorization envelope required by the API. */
+    merchantAuthorization?: CreateTransferParams['merchantAuthorization'];
 }
-declare function SwypePayment({ destination, onComplete, onError, useWalletConnector, idempotencyKey, }: SwypePaymentProps): react_jsx_runtime.JSX.Element | null;
+declare function SwypePayment({ destination, onComplete, onError, useWalletConnector, idempotencyKey, merchantAuthorization, }: SwypePaymentProps): react_jsx_runtime.JSX.Element | null;
 
 type AccessTokenGetter = () => Promise<string | null | undefined>;
 /**
@@ -420,70 +503,4 @@ interface UseTransferSigningOptions {
  */
 declare function useTransferSigning(pollIntervalMs?: number, options?: UseTransferSigningOptions): UseTransferSigningResult;
 
-declare function fetchProviders(apiBaseUrl: string, token: string): Promise<Provider[]>;
-declare function fetchChains(apiBaseUrl: string, token: string): Promise<Chain[]>;
-declare function fetchAccounts(apiBaseUrl: string, token: string, credentialId: string): Promise<Account[]>;
-interface CreateTransferParams {
-    /** Caller-supplied UUID v4 for idempotency. If omitted, a random UUID is generated. */
-    id?: string;
-    credentialId: string;
-    sourceType: SourceType;
-    sourceId: string;
-    destination: Destination;
-    amount: number;
-    currency?: string;
-}
-declare function createTransfer(apiBaseUrl: string, token: string, params: CreateTransferParams): Promise<Transfer>;
-declare function fetchTransfer(apiBaseUrl: string, token: string, transferId: string, authorizationSessionToken?: string): Promise<Transfer>;
-/**
- * Submit a passkey-signed UserOperation for a transfer.
- * PATCH /v1/transfers/{transferId}
- */
-declare function signTransfer(apiBaseUrl: string, token: string, transferId: string, signedUserOp: Record<string, unknown>, authorizationSessionToken?: string): Promise<Transfer>;
-declare function fetchAuthorizationSession(apiBaseUrl: string, sessionId: string): Promise<AuthorizationSessionDetail>;
-/**
- * Registers a WebAuthn passkey for the authenticated user.
- * POST /v1/users/config/passkey
- */
-declare function registerPasskey(apiBaseUrl: string, token: string, credentialId: string, publicKey: string): Promise<void>;
-/**
- * Fetches the authenticated user's config, including passkey status.
- * GET /v1/users/config
- */
-declare function fetchUserConfig(apiBaseUrl: string, token: string): Promise<{
-    id: string;
-    config: UserConfig;
-}>;
-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;
-declare const api_createTransfer: typeof createTransfer;
-declare const api_fetchAccounts: typeof fetchAccounts;
-declare const api_fetchAuthorizationSession: typeof fetchAuthorizationSession;
-declare const api_fetchChains: typeof fetchChains;
-declare const api_fetchProviders: typeof fetchProviders;
-declare const api_fetchTransfer: typeof fetchTransfer;
-declare const api_fetchUserConfig: typeof fetchUserConfig;
-declare const api_registerPasskey: typeof registerPasskey;
-declare const api_reportActionCompletion: typeof reportActionCompletion;
-declare const api_signTransfer: typeof signTransfer;
-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_fetchUserConfig as fetchUserConfig, api_registerPasskey as registerPasskey, api_reportActionCompletion as reportActionCompletion, api_signTransfer as signTransfer, api_updateUserConfig as updateUserConfig, api_updateUserConfigBySession as updateUserConfigBySession };
-}
-
-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 SourceOption, type SourceSelection, 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, createPasskeyCredential, darkTheme, deviceHasPasskey, findDevicePasskey, getTheme, lightTheme, api as swypeApi, useAuthorizationExecutor, useSwypeConfig, useSwypeDepositAmount, useTransferPolling, useTransferSigning };
+export { type Account, type ActionExecutionResult, type AdvancedSettings, type Amount, type AuthorizationAction, type AuthorizationSession, type AuthorizationSessionDetail, type Chain, type Destination, type ErrorResponse, type ListResponse, type MerchantAuthorization, type MerchantPublicKey, type PaymentStep, type Provider, type SourceOption, type SourceSelection, 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, createPasskeyCredential, darkTheme, deviceHasPasskey, findDevicePasskey, getTheme, lightTheme, api as swypeApi, useAuthorizationExecutor, useSwypeConfig, useSwypeDepositAmount, useTransferPolling, useTransferSigning };

package/dist/index.d.ts

@@ -162,6 +162,18 @@ interface Destination {
         symbol: string;
     };
 }
+/** Merchant-signed authorization envelope required for transfer creation. */
+interface MerchantAuthorization {
+    merchantId: string;
+    payload: string;
+    signature: string;
+}
+/** Public key metadata used to verify merchant-signed payment links. */
+interface MerchantPublicKey {
+    merchantId: string;
+    algorithm: string;
+    publicKey: string;
+}
 /** List response wrapper */
 interface ListResponse<T> {
     items: T[];
@@ -274,6 +286,75 @@ declare function useSwypeDepositAmount(): {
     setAmount: (amount: number | null) => void;
 };
 
+declare function fetchProviders(apiBaseUrl: string, token: string): Promise<Provider[]>;
+declare function fetchChains(apiBaseUrl: string, token: string): Promise<Chain[]>;
+declare function fetchAccounts(apiBaseUrl: string, token: string, credentialId: string): Promise<Account[]>;
+interface CreateTransferParams {
+    /** Caller-supplied UUID v4 for idempotency. If omitted, a random UUID is generated. */
+    id?: string;
+    credentialId: string;
+    merchantAuthorization?: MerchantAuthorization;
+    sourceType: SourceType;
+    sourceId: string;
+    destination: Destination;
+    amount: number;
+    currency?: string;
+}
+declare function createTransfer(apiBaseUrl: string, token: string, params: CreateTransferParams): Promise<Transfer>;
+declare function fetchMerchantPublicKey(apiBaseUrl: string, merchantId: string): Promise<MerchantPublicKey>;
+declare function fetchTransfer(apiBaseUrl: string, token: string, transferId: string, authorizationSessionToken?: string): Promise<Transfer>;
+/**
+ * Submit a passkey-signed UserOperation for a transfer.
+ * PATCH /v1/transfers/{transferId}
+ */
+declare function signTransfer(apiBaseUrl: string, token: string, transferId: string, signedUserOp: Record<string, unknown>, authorizationSessionToken?: string): Promise<Transfer>;
+declare function fetchAuthorizationSession(apiBaseUrl: string, sessionId: string): Promise<AuthorizationSessionDetail>;
+/**
+ * Registers a WebAuthn passkey for the authenticated user.
+ * POST /v1/users/config/passkey
+ */
+declare function registerPasskey(apiBaseUrl: string, token: string, credentialId: string, publicKey: string): Promise<void>;
+/**
+ * Fetches the authenticated user's config, including passkey status.
+ * GET /v1/users/config
+ */
+declare function fetchUserConfig(apiBaseUrl: string, token: string): Promise<{
+    id: string;
+    config: UserConfig;
+}>;
+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;
+declare const api_createTransfer: typeof createTransfer;
+declare const api_fetchAccounts: typeof fetchAccounts;
+declare const api_fetchAuthorizationSession: typeof fetchAuthorizationSession;
+declare const api_fetchChains: typeof fetchChains;
+declare const api_fetchMerchantPublicKey: typeof fetchMerchantPublicKey;
+declare const api_fetchProviders: typeof fetchProviders;
+declare const api_fetchTransfer: typeof fetchTransfer;
+declare const api_fetchUserConfig: typeof fetchUserConfig;
+declare const api_registerPasskey: typeof registerPasskey;
+declare const api_reportActionCompletion: typeof reportActionCompletion;
+declare const api_signTransfer: typeof signTransfer;
+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_fetchMerchantPublicKey as fetchMerchantPublicKey, api_fetchProviders as fetchProviders, api_fetchTransfer as fetchTransfer, api_fetchUserConfig as fetchUserConfig, api_registerPasskey as registerPasskey, api_reportActionCompletion as reportActionCompletion, api_signTransfer as signTransfer, api_updateUserConfig as updateUserConfig, api_updateUserConfigBySession as updateUserConfigBySession };
+}
+
 interface SwypePaymentProps {
     /**
      * Where the funds go -- controlled by the host app (merchant).
@@ -305,8 +386,10 @@ interface SwypePaymentProps {
      * flow without creating duplicate transfers.
      */
     idempotencyKey?: string;
+    /** Merchant-signed transfer authorization envelope required by the API. */
+    merchantAuthorization?: CreateTransferParams['merchantAuthorization'];
 }
-declare function SwypePayment({ destination, onComplete, onError, useWalletConnector, idempotencyKey, }: SwypePaymentProps): react_jsx_runtime.JSX.Element | null;
+declare function SwypePayment({ destination, onComplete, onError, useWalletConnector, idempotencyKey, merchantAuthorization, }: SwypePaymentProps): react_jsx_runtime.JSX.Element | null;
 
 type AccessTokenGetter = () => Promise<string | null | undefined>;
 /**
@@ -420,70 +503,4 @@ interface UseTransferSigningOptions {
  */
 declare function useTransferSigning(pollIntervalMs?: number, options?: UseTransferSigningOptions): UseTransferSigningResult;
 
-declare function fetchProviders(apiBaseUrl: string, token: string): Promise<Provider[]>;
-declare function fetchChains(apiBaseUrl: string, token: string): Promise<Chain[]>;
-declare function fetchAccounts(apiBaseUrl: string, token: string, credentialId: string): Promise<Account[]>;
-interface CreateTransferParams {
-    /** Caller-supplied UUID v4 for idempotency. If omitted, a random UUID is generated. */
-    id?: string;
-    credentialId: string;
-    sourceType: SourceType;
-    sourceId: string;
-    destination: Destination;
-    amount: number;
-    currency?: string;
-}
-declare function createTransfer(apiBaseUrl: string, token: string, params: CreateTransferParams): Promise<Transfer>;
-declare function fetchTransfer(apiBaseUrl: string, token: string, transferId: string, authorizationSessionToken?: string): Promise<Transfer>;
-/**
- * Submit a passkey-signed UserOperation for a transfer.
- * PATCH /v1/transfers/{transferId}
- */
-declare function signTransfer(apiBaseUrl: string, token: string, transferId: string, signedUserOp: Record<string, unknown>, authorizationSessionToken?: string): Promise<Transfer>;
-declare function fetchAuthorizationSession(apiBaseUrl: string, sessionId: string): Promise<AuthorizationSessionDetail>;
-/**
- * Registers a WebAuthn passkey for the authenticated user.
- * POST /v1/users/config/passkey
- */
-declare function registerPasskey(apiBaseUrl: string, token: string, credentialId: string, publicKey: string): Promise<void>;
-/**
- * Fetches the authenticated user's config, including passkey status.
- * GET /v1/users/config
- */
-declare function fetchUserConfig(apiBaseUrl: string, token: string): Promise<{
-    id: string;
-    config: UserConfig;
-}>;
-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;
-declare const api_createTransfer: typeof createTransfer;
-declare const api_fetchAccounts: typeof fetchAccounts;
-declare const api_fetchAuthorizationSession: typeof fetchAuthorizationSession;
-declare const api_fetchChains: typeof fetchChains;
-declare const api_fetchProviders: typeof fetchProviders;
-declare const api_fetchTransfer: typeof fetchTransfer;
-declare const api_fetchUserConfig: typeof fetchUserConfig;
-declare const api_registerPasskey: typeof registerPasskey;
-declare const api_reportActionCompletion: typeof reportActionCompletion;
-declare const api_signTransfer: typeof signTransfer;
-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_fetchUserConfig as fetchUserConfig, api_registerPasskey as registerPasskey, api_reportActionCompletion as reportActionCompletion, api_signTransfer as signTransfer, api_updateUserConfig as updateUserConfig, api_updateUserConfigBySession as updateUserConfigBySession };
-}
-
-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 SourceOption, type SourceSelection, 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, createPasskeyCredential, darkTheme, deviceHasPasskey, findDevicePasskey, getTheme, lightTheme, api as swypeApi, useAuthorizationExecutor, useSwypeConfig, useSwypeDepositAmount, useTransferPolling, useTransferSigning };
+export { type Account, type ActionExecutionResult, type AdvancedSettings, type Amount, type AuthorizationAction, type AuthorizationSession, type AuthorizationSessionDetail, type Chain, type Destination, type ErrorResponse, type ListResponse, type MerchantAuthorization, type MerchantPublicKey, type PaymentStep, type Provider, type SourceOption, type SourceSelection, 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, createPasskeyCredential, darkTheme, deviceHasPasskey, findDevicePasskey, getTheme, lightTheme, api as swypeApi, useAuthorizationExecutor, useSwypeConfig, useSwypeDepositAmount, useTransferPolling, useTransferSigning };