@rash2x/bridge-widget 0.7.6 → 0.7.8

package/dist/index.d.ts

@@ -198,7 +198,7 @@ declare class ChainStrategyRegistry {
  * Compute fee breakdown: message fee in native token, bridge fee in transfer token,
  * gas on destination in dst native token, total in USD
  */
-export declare function computeFeeBreakdownUsd(quote: Quote | undefined, srcToken: Token | undefined, tokens: Token[] | undefined, chains: Chain[] | undefined, srcChain?: Chain, dstChain?: Chain): FeeBreakdown;
+export declare function computeFeeBreakdownUsd(quote: Quote | undefined, srcToken: Token | undefined, dstToken: Token | undefined, tokens: Token[] | undefined, chains: Chain[] | undefined, srcChain?: Chain, dstChain?: Chain): FeeBreakdown;
 
 declare interface ConnectedWalletActions {
     setTonConnected: (connected: boolean) => void;
@@ -276,6 +276,14 @@ export declare interface EvaaBridgeProps {
     urlParams?: BridgeUrlParams;
     onUrlParamsChange?: (params: BridgeUrlParams) => void;
     onInitialized?: () => void;
+    /**
+     * Called before swap transaction starts. Can be used for authorization checks.
+     * - Return `true` or `undefined` to proceed with the transaction
+     * - Return `false` to cancel the transaction
+     * - Return a Promise to await authorization (e.g., user accepting policy)
+     *   - Promise resolves to `true`: transaction continues
+     *   - Promise resolves to `false`: transaction is cancelled
+     */
     onSwapStart?: (data: SwapStartData) => boolean | Promise<boolean> | void;
     onSwapSuccess?: (data: SwapSuccessData) => void;
     onSwapError?: (error: SwapErrorData) => void;
@@ -560,6 +568,26 @@ declare interface SettingsState {
 declare type Store = TransactionState & TransactionActions;
 
 export declare interface SwapCallbacks {
+    /**
+     * Called before swap transaction starts. Can be used for authorization checks.
+     * - Return `true` or `undefined` to proceed with the transaction
+     * - Return `false` to cancel the transaction
+     * - Return a Promise to await authorization (e.g., user accepting policy)
+     *   - Promise resolves to `true`: transaction continues
+     *   - Promise resolves to `false`: transaction is cancelled
+     *
+     * @example
+     * ```typescript
+     * // Simple synchronous check
+     * onSwapStart: () => isUserAuthorized()
+     *
+     * // Async authorization that waits for user action
+     * onSwapStart: async () => {
+     *   const authorized = await showAuthModalAndWait();
+     *   return authorized; // true to continue, false to cancel
+     * }
+     * ```
+     */
     onSwapStart?: (data: SwapStartData) => boolean | Promise<boolean> | void;
     onSwapSuccess?: (data: SwapSuccessData) => void;
     onSwapError?: (error: SwapErrorData) => void;