@rash2x/bridge-widget 0.7.5 → 0.7.7

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;
@@ -471,7 +479,9 @@ declare interface PollUntilDeliveredParams {
 
 export declare interface Quote {
     route: string;
-    error: string | null;
+    error: {
+        message: string;
+    } | null;
     srcAmount: string;
     dstAmount: string;
     srcAmountMax: string;
@@ -558,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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rash2x/bridge-widget",
-  "version": "0.7.5",
+  "version": "0.7.7",
   "description": "Cross-chain bridge widget powered by Stargate Protocol with multi-chain wallet support",
   "type": "module",
   "main": "./dist/evaa-bridge.cjs",