@tokenflight/swap 0.2.0 → 0.3.0-rc.0

package/dist/active-bridge-DTyKObda.js

@@ -0,0 +1 @@
+var e=null;function t(t){e=t}function n(){return e}export{t as n,n as t};

package/dist/bridge-C9uFKAdS.js

@@ -0,0 +1 @@
+var e=1,t=0;function n(e,n){return{type:`tf:${e}`,protocolVersion:1,seq:++t,payload:n}}function r(e){if(typeof e!=`object`||!e)return null;let t=e;return typeof t.type!=`string`||!t.type.startsWith(`tf:`)||t.protocolVersion!==1||typeof t.seq!=`number`||!(`payload`in t)?null:e}function i(e,t){return e.type===t}var a=new Set;function o(){return crypto.randomUUID()}function s(e){if(a.has(e))return!1;if(a.add(e),a.size>1e4){let e=[...a];for(let t=0;t<5e3;t++)a.delete(e[t])}return!0}var c=[[/user (rejected|denied|cancelled|refused)/i,`USER_REJECTED`],[/chain.*switch|switch.*chain|network.*change/i,`CHAIN_SWITCH_FAILED`],[/insufficient.*funds|not enough/i,`INSUFFICIENT_FUNDS`],[/timed?\s*out|timeout/i,`TIMEOUT`]];function l(e){for(let[t,n]of c)if(t.test(e))return n;return`UNKNOWN`}function u(e){if(e instanceof Error){let t=e,n=t.code;return{code:typeof n==`string`?n:l(e.message),message:e.message,details:t.details}}if(typeof e==`string`)return{code:l(e),message:e};if(typeof e==`object`&&e){let t=e;return{code:typeof t.code==`string`?t.code:`UNKNOWN`,message:typeof t.message==`string`?t.message:String(e),details:t.details}}return{code:`UNKNOWN`,message:String(e)}}function d(e){let t=Error(e.message);return t.code=e.code,e.details!==void 0&&(t.details=e.details),t}var f,p=`https://embed.tokenflight.ai/widget`,m=15e3,h=500,g=class e{constructor(e){if(this.listeners=new Map,this.ready=!1,this.destroyed=!1,this.readyTimer=null,this.popup=null,this.popupPollTimer=null,this.popupOrderId=null,this.popupMessageHandler=null,this.handleMessage=e=>{if(this.destroyed||e.origin!==this.widgetOrigin||e.source!==this.iframe.contentWindow)return;let t=r(e.data);t&&(i(t,`tf:ready`)?this.handleReady(t.payload.version,t.payload.protocolVersion):i(t,`tf:signRequest`)?this.handleSignRequest(t.payload.requestId,t.payload.action,t.payload.timeoutMs):i(t,`tf:connectWallet`)?this.handleConnectWallet(t.payload.chainType):i(t,`tf:disconnectWallet`)?this.handleDisconnectWallet():i(t,`tf:event`)?this.handleWidgetEvent(t.payload.name,t.payload.data):i(t,`tf:resize`)?this.handleResize(t.payload.height):i(t,`tf:preOpenPopup`)?this.handlePreOpenPopup():i(t,`tf:navigatePopup`)&&this.navigatePopup(t.payload.url,t.payload.orderId))},this.options=e,this.wallet=e.wallet,typeof e.container==`string`){let t=document.querySelector(e.container);if(!t)throw Error(`TokenFlightBridge: container "${e.container}" not found`);this.container=t}else this.container=e.container;let t=e.iframeSrc??p,n=typeof window<`u`?window.location.href:void 0;this.widgetOrigin=new URL(t,n).origin,this.iframe=document.createElement(`iframe`),this.iframe.src=t,this.iframe.style.display=`block`,this.iframe.style.width=`100%`,this.iframe.style.height=`600px`,this.iframe.style.minWidth=`375px`,this.iframe.style.colorScheme=`normal`,this.iframe.style.borderRadius=`var(--tf-radius-xl, 20px)`,this.iframe.style.overflow=`hidden`,e.config.noBackground||(this.iframe.style.background=`var(--tf-bg, #0d0f14)`),e.config.noBorder?this.iframe.style.border=`none`:(this.iframe.style.border=`1px solid var(--tf-border, #252a38)`,this.iframe.style.boxShadow=`var(--tf-shadow-lg, none)`),this.iframe.setAttribute(`allow`,`camera;microphone;payment;clipboard-write`),this.iframe.setAttribute(`title`,`TokenFlight Widget`),this.container.appendChild(this.iframe),window.addEventListener(`message`,this.handleMessage),this.walletHandler=e=>{this.sendWalletState(e.type)},this.subscribeWalletEvents();let a=e.readyTimeout??m;this.readyTimer=setTimeout(()=>{!this.ready&&!this.destroyed&&e.onLoadError?.(Error(`TokenFlightBridge: widget did not send tf:ready within timeout`))},a)}setConfig(e){this.postToIframe(n(`setConfig`,e)),e.noBackground!==void 0&&(this.iframe.style.background=e.noBackground?``:`var(--tf-bg, #0d0f14)`),e.noBorder!==void 0&&(this.iframe.style.border=e.noBorder?`none`:`1px solid var(--tf-border, #252a38)`,this.iframe.style.boxShadow=e.noBorder?`none`:`var(--tf-shadow-lg, none)`)}setStyle(e){this.postToIframe(n(`setStyle`,e))}setWallet(e){this.unsubscribeWalletEvents(),this.wallet=e,this.subscribeWalletEvents(),this.sendWalletState()}on(e,t){let n=this.listeners.get(e);n||(n=new Set,this.listeners.set(e,n)),n.add(t)}off(e,t){this.listeners.get(e)?.delete(t)}destroy(){this.destroyed||(this.destroyed=!0,this.readyTimer&&(clearTimeout(this.readyTimer),this.readyTimer=null),window.removeEventListener(`message`,this.handleMessage),this.unsubscribeWalletEvents(),this.closePopup(),this.iframe.remove(),this.listeners.clear())}async handleReady(e,t){if(t!==1){this.options.onLoadError?.(Error(`TokenFlightBridge: protocol version mismatch (bridge=1, widget=${t})`));return}this.ready=!0,this.readyTimer&&(clearTimeout(this.readyTimer),this.readyTimer=null);let r=this.wallet?.isConnected()??!1,i=null;if(r&&this.wallet)try{i=await this.wallet.getAddress()}catch{}this.postToIframe(n(`init`,{config:this.options.config,style:this.options.style,walletAddress:i,connected:r})),this.options.onReady?.(e),this.emit(`ready`,{version:e})}async handleSignRequest(e,t,r){if(!this.wallet){this.postToIframe(n(`signResult`,{requestId:e,error:{code:`ADAPTER_ERROR`,message:`No wallet adapter configured`}}));return}try{let r=await this.wallet.executeWalletAction(t);this.postToIframe(n(`signResult`,{requestId:e,result:r}))}catch(t){this.postToIframe(n(`signResult`,{requestId:e,error:u(t)}))}}async handleConnectWallet(e){if(this.wallet)try{await this.wallet.connect(e)}catch{}}async handleDisconnectWallet(){if(this.wallet)try{await this.wallet.disconnect()}catch{}}handleWidgetEvent(e,t){let n=_[e];n&&this.emit(n,t)}handleResize(e){this.iframe.style.height=`${e}px`,this.emit(`resize`,{height:e})}handlePreOpenPopup(){this.closePopup(),this.popup=window.open(`about:blank`,`tf-payment`,`width=500,height=700`)}navigatePopup(e,t){if(!this.popup||this.popup.closed){this.postToIframe(n(`fiatPopupClosed`,{orderId:t}));return}try{let r=new URL(e);if(r.protocol!==`https:`&&r.protocol!==`http:`){this.postToIframe(n(`fiatPopupClosed`,{orderId:t}));return}}catch{this.postToIframe(n(`fiatPopupClosed`,{orderId:t}));return}this.popup.location.href=e,this.popupOrderId=t,this.installPopupMessageHandler(),this.popupPollTimer=setInterval(()=>{this.popup?.closed&&(this.closePopup(),this.postToIframe(n(`fiatPopupClosed`,{orderId:this.popupOrderId??t})),this.popupOrderId=null)},h)}installPopupMessageHandler(){if(this.popupMessageHandler)return;let e,t=this.options.config.fiatApiEndpoint;if(!t)return;try{e=new URL(t).origin}catch{return}let r=new Set([`widget_ready`,`order_completed`,`order_failed`,`widget_close`]);this.popupMessageHandler=t=>{if(this.destroyed||t.origin!==e)return;let i=t.data;if(!i||i.type!==`FIAT_WIDGET_EVENT`||typeof i.event!=`string`||!r.has(i.event))return;let a=this.popupOrderId;a&&(typeof i.orderId==`string`&&i.orderId!==a||this.postToIframe(n(`fiatProviderEvent`,{orderId:a,event:i.event,provider:typeof i.provider==`string`?i.provider:void 0,data:i.data??void 0})))},window.addEventListener(`message`,this.popupMessageHandler)}closePopup(){this.popupPollTimer&&(clearInterval(this.popupPollTimer),this.popupPollTimer=null),this.popupMessageHandler&&(window.removeEventListener(`message`,this.popupMessageHandler),this.popupMessageHandler=null),this.popup&&!this.popup.closed&&this.popup.close(),this.popup=null}subscribeWalletEvents(){if(this.wallet)for(let t of e.WALLET_EVENTS)this.wallet.on(t,this.walletHandler)}unsubscribeWalletEvents(){if(this.wallet)for(let t of e.WALLET_EVENTS)this.wallet.off(t,this.walletHandler)}async sendWalletState(e){if(!this.wallet)return;let t=this.wallet.isConnected(),r=null;if(t)try{r=await this.wallet.getAddress()}catch{}this.postToIframe(n(`walletState`,{connected:t,address:r,event:e}))}postToIframe(e){this.destroyed||this.iframe.contentWindow?.postMessage(e,this.widgetOrigin)}emit(e,t){let n=this.listeners.get(e);if(n)for(let e of n)try{e(t)}catch{}}};f=g,f.WALLET_EVENTS=[`connect`,`disconnect`,`chainChanged`,`accountsChanged`];var _={swapComplete:`swapComplete`,error:`error`,fiatOrderCreated:`fiatOrderCreated`,fiatOrderCompleted:`fiatOrderCompleted`};function v(e){return new g(e)}export{o as a,r as c,n as i,u as l,v as n,d as o,s as r,i as s,g as t,e as u};

package/dist/bridge.d.ts

@@ -0,0 +1,597 @@
+export declare interface BridgeEventMap {
+    ready: {
+        version: string;
+    };
+    swapComplete: {
+        orderId: string;
+        txHash?: string;
+    };
+    error: {
+        code: string;
+        message: string;
+        details?: unknown;
+    };
+    fiatOrderCreated: {
+        orderId: string;
+        widgetUrl: string;
+    };
+    fiatOrderCompleted: {
+        orderId: string;
+        status: string;
+        txHash?: string;
+    };
+    resize: {
+        height: number;
+    };
+}
+
+export declare type BridgeEventName = keyof BridgeEventMap;
+
+export declare interface BridgeOptions {
+    /** Mount point — CSS selector or HTMLElement. */
+    container: string | HTMLElement;
+    /** Wallet adapter running on the host page. */
+    wallet?: IWalletAdapter;
+    /** Widget configuration. */
+    config: WidgetConfig;
+    /** Style overrides (CSS variables, custom CSS, remote stylesheet). */
+    style?: StyleOverrides;
+    /** Iframe source URL. Defaults to latest hosted widget. */
+    iframeSrc?: string;
+    /** Called when the widget iframe fails to load. */
+    onLoadError?: (error: Error) => void;
+    /** Called when the widget iframe is ready. */
+    onReady?: (version: string) => void;
+    /** Timeout in ms for waiting for tf:ready (default: 15000). */
+    readyTimeout?: number;
+}
+
+/** Chain type for multi-chain support */
+declare type ChainType = "evm" | "solana";
+
+/**
+ * Consume a request ID (one-time use). Returns `true` if the ID was valid
+ * and not yet consumed, `false` if already consumed or unknown.
+ */
+export declare function consumeRequestId(id: string): boolean;
+
+/**
+ * Create a typed bridge message envelope.
+ *
+ * ```ts
+ * const msg = createMessage("init", { config, walletAddress });
+ * // → { type: "tf:init", protocolVersion: 1, seq: 1, payload: { ... } }
+ * ```
+ */
+export declare function createMessage<T extends string, P>(type: T, payload: P): TfMessageEnvelope<T, P>;
+
+/** Generate a unique request ID using crypto.randomUUID(). */
+export declare function createRequestId(): string;
+
+/**
+ * Create a new TokenFlight bridge instance.
+ *
+ * ```ts
+ * const bridge = createTokenFlightBridge({
+ *   container: '#widget',
+ *   wallet: adapter,
+ *   config: { theme: 'dark', fromToken: '...' },
+ * });
+ * ```
+ */
+export declare function createTokenFlightBridge(options: BridgeOptions): TokenFlightBridge;
+
+/**
+ * Custom color overrides — keys are CSS variable names.
+ * Typed keys provide autocomplete; arbitrary `--tf-*` strings are also accepted.
+ *
+ * ```ts
+ * customColors: {
+ *   "--tf-primary": "#FF6B00",
+ *   "--tf-bg": "#1A1A2E",
+ *   "--tf-button-radius": "4px",
+ *   "--tf-widget-max-width": "480px",
+ * }
+ * ```
+ */
+declare type CustomColors = Partial<Record<TfCssVar, string>> & Record<string, string>;
+
+/** Reconstruct an Error from a SerializedError. */
+export declare function deserializeError(err: SerializedError): Error & {
+    code: string;
+};
+
+/** EVM wallet action via EIP-1193 */
+declare interface EvmWalletAction {
+    type: "eip1193_request";
+    chainId: number;
+    method: string;
+    params: unknown[];
+}
+
+/**
+ * Iframe-embed bridge integration for the fiat popup. When the widget is
+ * embedded as an iframe via `@tokenflight/swap/bridge`, the host page owns the
+ * payment popup (to avoid 3-level iframe nesting through the wrapper page).
+ * The widget delegates `window.open` to the host and consumes popup-closed
+ * notifications + forwarded provider events via callback registries.
+ */
+declare interface FiatIframeBridge {
+    /** Synchronously ask the host to pre-open a blank popup in the user-gesture chain. */
+    requestPreOpenPopup: () => void;
+    /** Ask the host to navigate the pre-opened popup to the wrapper URL. */
+    requestNavigatePopup: (url: string, orderId: string) => void;
+    /**
+     * Subscribe to popup-closed notifications forwarded from the host bridge.
+     * Returns an unsubscribe function. The handler receives the orderId the host
+     * was tracking; checkout state filters out stale closures by comparing it
+     * against the current `orderId()` signal.
+     */
+    onPopupClosed: (handler: (closedOrderId: string) => void) => () => void;
+    /**
+     * Subscribe to provider terminal events forwarded from the host bridge.
+     * Returns an unsubscribe function. The host installs its own
+     * `FIAT_WIDGET_EVENT` listener (origin-validated against `fiatApiEndpoint`)
+     * and forwards matched events here so the widget's `paymentOutcome` signal
+     * can be driven exactly the same way as in non-iframe mode.
+     */
+    onProviderEvent: (handler: (event: ForwardedFiatProviderEvent) => void) => () => void;
+}
+
+/** Payload of a forwarded provider event (extracted from the message envelope). */
+declare type FiatProviderEventPayload = TfFiatProviderEventMessage["payload"];
+
+/**
+ * Forwarded provider terminal event payload — mirrors the postMessage event
+ * the wrapper page would dispatch directly in non-iframe mode. The host bridge
+ * unpacks `FIAT_WIDGET_EVENT` postMessages on its own window and re-broadcasts
+ * them as this shape via `tf:fiatProviderEvent`.
+ */
+declare interface ForwardedFiatProviderEvent {
+    orderId: string;
+    event: "widget_ready" | "order_completed" | "order_failed" | "widget_close";
+    provider?: string;
+    data?: Record<string, unknown>;
+}
+
+/**
+ * Get the host page origin from the referrer or document.referrer.
+ * Returns null if not in iframe mode or origin cannot be determined.
+ */
+export declare function getHostOrigin(): string | null;
+
+/** Union of all Host → iframe messages. */
+export declare type HostToIframeMessage = TfInitMessage | TfSetConfigMessage | TfSetStyleMessage | TfWalletStateMessage | TfSignResultMessage | TfFiatPopupClosedMessage | TfFiatProviderEventMessage;
+
+/**
+ * Wallet adapter that runs inside the widget iframe and proxies all
+ * wallet operations to the host page's real adapter via postMessage.
+ */
+export declare class IframeBridgeWalletAdapter implements IWalletAdapter {
+    readonly name = "IframeBridge";
+    readonly supportedActionTypes: WalletActionType[];
+    private connected;
+    private address;
+    private chainType;
+    private lastWalletSeq;
+    private readonly hostOrigin;
+    private readonly eventListeners;
+    private readonly pendingRequests;
+    private pendingConnect;
+    private pendingDisconnect;
+    private destroyed;
+    constructor(hostOrigin: string);
+    connect(chainType?: ChainType): Promise<void>;
+    disconnect(): Promise<void>;
+    isConnected(_chainType?: ChainType): boolean;
+    getAddress(_chainType?: ChainType): Promise<string | null>;
+    executeWalletAction(action: WalletAction): Promise<WalletActionResult>;
+    on(event: WalletEventType, handler: (event: WalletEvent) => void): void;
+    off(event: WalletEventType, handler: (event: WalletEvent) => void): void;
+    destroy(): void;
+    /** Set initial wallet state from tf:init payload. */
+    setInitialState(connected: boolean, address: string | null, chainType?: ChainType): void;
+    private handleMessage;
+    private handleWalletState;
+    private handleSignResult;
+    private postToHost;
+    private emit;
+}
+
+/**
+ * Runs inside the widget iframe. Listens for postMessage from the host Bridge
+ * and orchestrates config application and wallet adapter setup.
+ *
+ * Returns the IframeBridgeWalletAdapter that should be passed to the widget
+ * as its wallet adapter.
+ */
+export declare class IframeReceiver {
+    readonly walletAdapter: IframeBridgeWalletAdapter;
+    private readonly hostOrigin;
+    private readonly callbacks;
+    private destroyed;
+    private resizeObserver;
+    private lastReportedHeight;
+    /** Subscribers to forwarded popup-closed events (set by useFiatCheckout in bridge mode). */
+    private readonly popupClosedHandlers;
+    /** Subscribers to forwarded provider terminal events (also useFiatCheckout). */
+    private readonly providerEventHandlers;
+    constructor(hostOrigin: string, callbacks: IframeReceiverCallbacks);
+    /**
+     * Returns the {@link FiatIframeBridge} accessor object that
+     * `useFiatCheckout` consumes. Methods are bound to this receiver instance.
+     */
+    getFiatBridge(): FiatIframeBridge;
+    /** Start observing widget root for height changes → tf:resize. */
+    observeResize(element: HTMLElement): void;
+    /** Emit a widget event to the host (e.g. swapComplete). */
+    emitEvent(name: string, data: unknown): void;
+    /** Request the host to pre-open a popup (fiat flow). */
+    requestPreOpenPopup(): void;
+    /** Request the host to navigate the popup to a URL (fiat flow). */
+    requestNavigatePopup(url: string, orderId: string): void;
+    /** Clean up all listeners and observers. */
+    destroy(): void;
+    private handleMessage;
+    private handleInit;
+    private postToHost;
+}
+
+export declare interface IframeReceiverCallbacks {
+    /** Called on tf:init — apply initial config to the widget. */
+    onInit: (config: WidgetConfig, style?: StyleOverrides) => void;
+    /** Called on tf:setConfig — apply config update. */
+    onConfigUpdate: (config: Partial<WidgetConfig>) => void;
+    /** Called on tf:setStyle — apply style overrides. */
+    onStyleUpdate: (style: StyleOverrides) => void;
+    /** Called on tf:fiatPopupClosed — used by fiat checkout in iframe mode. */
+    onFiatPopupClosed?: (orderId: string) => void;
+    /**
+     * Called on tf:fiatProviderEvent — host bridge forwards a provider terminal
+     * event from the popup wrapper page so the widget can drive `paymentOutcome`.
+     */
+    onFiatProviderEvent?: (event: FiatProviderEventPayload) => void;
+}
+
+/** Union of all iframe → Host messages. */
+export declare type IframeToHostMessage = TfReadyMessage | TfSignRequestMessage | TfConnectWalletMessage | TfDisconnectWalletMessage | TfEventMessage | TfResizeMessage | TfPreOpenPopupMessage | TfNavigatePopupMessage;
+
+/** Check if the current window is running inside an iframe. */
+export declare function isIframeMode(): boolean;
+
+/**
+ * Type guard: check if a message has a specific type.
+ */
+export declare function isMessageType<T extends TfBridgeMessage["type"]>(msg: TfBridgeMessage, type: T): msg is Extract<TfBridgeMessage, {
+    type: T;
+}>;
+
+/** Wallet adapter interface that all adapters must implement */
+declare interface IWalletAdapter {
+    /** Human-readable name */
+    readonly name: string;
+    /** Icon URL */
+    readonly icon?: string;
+    /** Supported action types */
+    readonly supportedActionTypes: WalletActionType[];
+    /** Optional: supported chain IDs — when set, the widget only shows tokens on these chains */
+    readonly supportedChainIds?: number[];
+    /** Connect the wallet */
+    connect(chainType?: ChainType): Promise<void>;
+    /** Disconnect the wallet */
+    disconnect(): Promise<void>;
+    /** Check if connected */
+    isConnected(chainType?: ChainType): boolean;
+    /** Get the current address */
+    getAddress(chainType?: ChainType): Promise<string | null>;
+    /** Execute a wallet action */
+    executeWalletAction(action: WalletAction): Promise<WalletActionResult>;
+    /** Optional: sign a message */
+    signMessage?(message: string, chainType?: ChainType): Promise<string>;
+    /** Optional: open the wallet's native account/connected modal */
+    openAccountModal?(): Promise<void>;
+    /** Optional: clean up internal subscriptions and watchers */
+    destroy?(): void;
+    /** Subscribe to wallet events */
+    on(event: WalletEventType, handler: (event: WalletEvent) => void): void;
+    /** Unsubscribe from wallet events */
+    off(event: WalletEventType, handler: (event: WalletEvent) => void): void;
+}
+
+/**
+ * Validate and parse a raw postMessage data object as a bridge message.
+ * Returns `null` if the data is not a valid bridge message.
+ */
+export declare function parseMessage(data: unknown): TfBridgeMessage | null;
+
+export declare interface SerializedError {
+    code: string;
+    message: string;
+    details?: unknown;
+}
+
+/** Serialize any error value into a structured object safe for postMessage. */
+export declare function serializeError(err: unknown): SerializedError;
+
+/** Solana sign and send transaction action */
+declare interface SolanaSignAndSendAction {
+    type: "solana_signAndSendTransaction";
+    transaction: string;
+}
+
+/** Solana sign transaction action */
+declare interface SolanaSignTransactionAction {
+    type: "solana_signTransaction";
+    transaction: string;
+}
+
+export declare interface StyleOverrides {
+    /** CSS custom property overrides (only --tf-* keys accepted). */
+    vars?: Partial<Record<TfCssVar, string>> & Record<string, string>;
+    /** Raw CSS string injected into <style> inside the widget Shadow DOM.
+     *  Use [part="..."] selectors. @import rules are stripped. Max 50 KB. */
+    css?: string;
+    /** URL to an external stylesheet loaded via <link> inside the widget.
+     *  Must be HTTPS. */
+    cssUrl?: string;
+}
+
+/** Supported locale identifiers. Accepts any string for forward-compat; known values get bundled translations. */
+declare type SupportedLocale = "en-US" | "zh-CN" | "zh-TW" | "ja-JP" | "ko-KR" | (string & {});
+
+/** Payment methods available in swap widget */
+declare type SwapPayMethod = "crypto" | "card";
+
+/** Current protocol version. Bumped on breaking message format changes. */
+export declare const TF_PROTOCOL_VERSION = 1;
+
+/** Union of all bridge messages (both directions). */
+export declare type TfBridgeMessage = HostToIframeMessage | IframeToHostMessage;
+
+/** Request host to trigger wallet connection. */
+export declare type TfConnectWalletMessage = TfMessageEnvelope<"connectWallet", {
+    chainType?: ChainType;
+}>;
+
+/** All first-party CSS custom properties exposed for theming. */
+declare type TfCssVar = "--tf-bg" | "--tf-bg-secondary" | "--tf-bg-elevated" | "--tf-surface" | "--tf-surface-hover" | "--tf-input-bg" | "--tf-glass" | "--tf-text" | "--tf-text-secondary" | "--tf-text-tertiary" | "--tf-text-on-primary" | "--tf-border" | "--tf-border-light" | "--tf-primary" | "--tf-primary-alpha" | "--tf-primary-light" | "--tf-primary-glow" | "--tf-success" | "--tf-success-bg" | "--tf-error" | "--tf-error-bg" | "--tf-error-alpha" | "--tf-warning" | "--tf-warning-bg" | "--tf-shadow" | "--tf-shadow-lg" | "--tf-skeleton" | "--tf-radius-xs" | "--tf-radius-sm" | "--tf-radius" | "--tf-radius-lg" | "--tf-radius-xl" | "--tf-button-radius" | "--tf-widget-max-width" | "--tf-font-family" | "--tf-font-family-mono" | "--tf-font-size" | "--tf-line-height" | "--tf-font-sm" | "--tf-font-base" | "--tf-font-md" | "--tf-font-lg" | "--tf-font-xl" | "--tf-font-heading" | "--tf-font-amount" | "--tf-font-amount-lg" | "--tf-font-amount-sm";
+
+/** Request host to disconnect wallet. */
+export declare type TfDisconnectWalletMessage = TfMessageEnvelope<"disconnectWallet", Record<string, never>>;
+
+/** Widget events (swapComplete, error, etc.). */
+export declare type TfEventMessage = TfMessageEnvelope<"event", {
+    name: string;
+    data: unknown;
+}>;
+
+/** Notify widget that the fiat popup was closed by the user. */
+export declare type TfFiatPopupClosedMessage = TfMessageEnvelope<"fiatPopupClosed", {
+    orderId: string;
+}>;
+
+/**
+ * Forward a fiat provider terminal event from the host bridge to the widget.
+ *
+ * In iframe-embed mode the payment popup is opened by the host page, so the
+ * provider's wrapper script (`fiat.hyperstream.dev`) posts `FIAT_WIDGET_EVENT`
+ * messages to the host's `window.opener` — never to the widget iframe. The
+ * host bridge listens for those events (origin-validated against the widget
+ * config's `fiatApiEndpoint`, filtered by the active popup's orderId) and
+ * forwards them as this message so `useFiatCheckout` can drive the
+ * `paymentOutcome` signal exactly the same way it does in non-iframe mode.
+ */
+export declare type TfFiatProviderEventMessage = TfMessageEnvelope<"fiatProviderEvent", {
+    orderId: string;
+    /** Provider event name as forwarded by the wrapper bridge. */
+    event: "widget_ready" | "order_completed" | "order_failed" | "widget_close";
+    /** Provider id (e.g. "transak"). */
+    provider?: string;
+    /** Optional event-specific payload (failedReason, providerStatus, etc.). */
+    data?: Record<string, unknown>;
+}>;
+
+/** Initial config + wallet state, sent after tf:ready. */
+export declare type TfInitMessage = TfMessageEnvelope<"init", {
+    config: WidgetConfig;
+    style?: StyleOverrides;
+    walletAddress?: string | null;
+    chainType?: ChainType;
+    connected?: boolean;
+}>;
+
+export declare interface TfMessageEnvelope<T extends string = string, P = unknown> {
+    type: `tf:${T}`;
+    protocolVersion: typeof TF_PROTOCOL_VERSION;
+    /** Monotonically increasing per sender — used for ordering & staleness detection. */
+    seq: number;
+    payload: P;
+}
+
+/** Request host to navigate the pre-opened popup to a fiat payment URL. */
+export declare type TfNavigatePopupMessage = TfMessageEnvelope<"navigatePopup", {
+    url: string;
+    orderId: string;
+}>;
+
+/** Request host to pre-open a blank popup (must be in user gesture context). */
+export declare type TfPreOpenPopupMessage = TfMessageEnvelope<"preOpenPopup", Record<string, never>>;
+
+/** Widget loaded and ready. */
+export declare type TfReadyMessage = TfMessageEnvelope<"ready", {
+    version: string;
+    protocolVersion: number;
+}>;
+
+/** Suggested iframe height for responsive layout. */
+export declare type TfResizeMessage = TfMessageEnvelope<"resize", {
+    height: number;
+}>;
+
+/** Dynamic config update. */
+export declare type TfSetConfigMessage = TfMessageEnvelope<"setConfig", Partial<WidgetConfig>>;
+
+/** Dynamic style update. */
+export declare type TfSetStyleMessage = TfMessageEnvelope<"setStyle", StyleOverrides>;
+
+/** Request host to sign a transaction. */
+export declare type TfSignRequestMessage = TfMessageEnvelope<"signRequest", {
+    requestId: string;
+    action: WalletAction;
+    timeoutMs?: number;
+}>;
+
+/** Response to a signing request. */
+export declare type TfSignResultMessage = TfMessageEnvelope<"signResult", {
+    requestId: string;
+    result?: WalletActionResult;
+    error?: SerializedError;
+}>;
+
+/** Wallet state change (connect, disconnect, address change). */
+export declare type TfWalletStateMessage = TfMessageEnvelope<"walletState", {
+    connected: boolean;
+    address: string | null;
+    chainType?: ChainType;
+    event?: WalletEventType;
+}>;
+
+/** Visual theme mode. */
+declare type Theme = "light" | "dark" | "auto";
+
+/**
+ * Bridge that connects a host page's wallet adapter to a TokenFlight widget
+ * running inside an iframe via postMessage.
+ *
+ * ```ts
+ * const bridge = createTokenFlightBridge({
+ *   container: '#swap-widget',
+ *   wallet: adapter,
+ *   config: { fromToken: '...', toToken: '...' },
+ * });
+ * bridge.on('swapComplete', (data) => { ... });
+ * bridge.destroy();
+ * ```
+ */
+export declare class TokenFlightBridge {
+    readonly iframe: HTMLIFrameElement;
+    private readonly container;
+    private wallet;
+    private readonly options;
+    private readonly listeners;
+    private readonly walletHandler;
+    private widgetOrigin;
+    private ready;
+    private destroyed;
+    private readyTimer;
+    private popup;
+    private popupPollTimer;
+    private popupOrderId;
+    /** Window listener forwarding FIAT_WIDGET_EVENT messages → tf:fiatProviderEvent. */
+    private popupMessageHandler;
+    constructor(options: BridgeOptions);
+    /** Update widget configuration without iframe reload. */
+    setConfig(config: Partial<WidgetConfig>): void;
+    /** Update style overrides. */
+    setStyle(style: StyleOverrides): void;
+    /** Set or replace the wallet adapter (supports deferred setup). */
+    setWallet(adapter: IWalletAdapter | undefined): void;
+    /** Subscribe to a widget event. */
+    on<K extends BridgeEventName>(event: K, handler: (data: BridgeEventMap[K]) => void): void;
+    /** Unsubscribe from a widget event. */
+    off<K extends BridgeEventName>(event: K, handler: (data: BridgeEventMap[K]) => void): void;
+    /** Remove iframe, clean up listeners, close popup if open. */
+    destroy(): void;
+    private handleMessage;
+    private handleReady;
+    private handleSignRequest;
+    private handleConnectWallet;
+    private handleDisconnectWallet;
+    private handleWidgetEvent;
+    private handleResize;
+    private handlePreOpenPopup;
+    /** Called internally when the widget wants to navigate the pre-opened popup. */
+    private navigatePopup;
+    /**
+     * Subscribe to provider terminal events arriving on the host window from
+     * the popup's wrapper page. Origin-validated against the widget config's
+     * `fiatApiEndpoint`; filtered by the active `popupOrderId`. Drops messages
+     * that don't match the expected `FiatWidgetEvent` shape.
+     */
+    private installPopupMessageHandler;
+    private closePopup;
+    private static readonly WALLET_EVENTS;
+    private subscribeWalletEvents;
+    private unsubscribeWalletEvents;
+    private sendWalletState;
+    private postToIframe;
+    private emit;
+}
+
+/**
+ * Flexible token identifier supporting:
+ * - Direct object: { chainId: 1, address: "0x..." }
+ * - CAIP-10 string: "eip155:1:0x..."
+ * - JSON string: '{"chainId":1,"address":"0x..."}'
+ */
+declare type TokenIdentifier = string | TokenTarget;
+
+/** Token target as chain + address pair */
+declare interface TokenTarget {
+    chainId: number;
+    address: string;
+}
+
+/** Union of all wallet action types */
+declare type WalletAction = EvmWalletAction | SolanaSignTransactionAction | SolanaSignAndSendAction;
+
+/** Result of executing a wallet action */
+declare interface WalletActionResult {
+    success: boolean;
+    data?: unknown;
+    error?: string;
+    txHash?: string;
+}
+
+/** Wallet action types */
+declare type WalletActionType = "eip1193_request" | "solana_signTransaction" | "solana_signAndSendTransaction";
+
+/** Well-known error codes for wallet operations. */
+export declare type WalletErrorCode = "USER_REJECTED" | "CHAIN_SWITCH_FAILED" | "INSUFFICIENT_FUNDS" | "TIMEOUT" | "ADAPTER_ERROR" | "UNKNOWN";
+
+/** Wallet event payload */
+declare interface WalletEvent {
+    type: WalletEventType;
+    data?: unknown;
+}
+
+/** Wallet event types */
+declare type WalletEventType = "connect" | "disconnect" | "chainChanged" | "accountsChanged";
+
+export declare interface WidgetConfig {
+    apiEndpoint?: string;
+    fiatApiEndpoint?: string;
+    theme?: Theme;
+    locale?: SupportedLocale;
+    customColors?: CustomColors;
+    fromToken?: TokenIdentifier;
+    toToken?: TokenIdentifier | TokenIdentifier[];
+    tradeType?: "EXACT_INPUT" | "EXACT_OUTPUT";
+    amount?: string;
+    recipient?: string;
+    methods?: SwapPayMethod[];
+    defaultPayMethod?: SwapPayMethod;
+    fiatCurrency?: string;
+    fromTokens?: TokenIdentifier[];
+    toTokens?: TokenIdentifier[];
+    titleText?: string;
+    titleImageUrl?: string;
+    hideTitle?: boolean;
+    hidePoweredBy?: boolean;
+    noBackground?: boolean;
+    noBorder?: boolean;
+    lockFromToken?: boolean;
+    lockToToken?: boolean;
+}
+
+export { }

package/dist/bridge.js

@@ -0,0 +1 @@
+import{n as e}from"./active-bridge-DTyKObda.js";import{a as t,c as n,i as r,l as i,n as a,o,r as s,s as c,t as l,u}from"./bridge-C9uFKAdS.js";var d=12e4,f=6e4,p=class{constructor(e){this.name=`IframeBridge`,this.supportedActionTypes=[`eip1193_request`,`solana_signTransaction`,`solana_signAndSendTransaction`],this.connected=!1,this.address=null,this.lastWalletSeq=0,this.eventListeners=new Map,this.pendingRequests=new Map,this.pendingConnect=null,this.pendingDisconnect=null,this.destroyed=!1,this.handleMessage=e=>{if(this.destroyed||e.origin!==this.hostOrigin)return;let t=n(e.data);t&&(c(t,`tf:walletState`)?this.handleWalletState(t.payload,t.seq):c(t,`tf:signResult`)&&this.handleSignResult(t.payload.requestId,t.payload.result,t.payload.error))},this.hostOrigin=e,window.addEventListener(`message`,this.handleMessage)}async connect(e){return this.postToHost(r(`connectWallet`,{chainType:e})),new Promise((e,t)=>{this.pendingConnect={resolve:e,reject:t},setTimeout(()=>{this.pendingConnect&&(this.pendingConnect.reject(Error(`Wallet connection timed out`)),this.pendingConnect=null)},f)})}async disconnect(){return this.postToHost(r(`disconnectWallet`,{})),new Promise((e,t)=>{this.pendingDisconnect={resolve:e,reject:t},setTimeout(()=>{this.pendingDisconnect&&(this.pendingDisconnect.reject(Error(`Wallet disconnect timed out`)),this.pendingDisconnect=null)},f)})}isConnected(e){return this.connected}async getAddress(e){return this.address}async executeWalletAction(e){let n=t();return new Promise((t,i)=>{let a=setTimeout(()=>{this.pendingRequests.delete(n),i(Error(`Wallet action timed out`))},d);this.pendingRequests.set(n,{resolve:t,reject:i,timer:a}),this.postToHost(r(`signRequest`,{requestId:n,action:e}))})}on(e,t){let n=this.eventListeners.get(e);n||(n=new Set,this.eventListeners.set(e,n)),n.add(t)}off(e,t){this.eventListeners.get(e)?.delete(t)}destroy(){if(!this.destroyed){this.destroyed=!0,window.removeEventListener(`message`,this.handleMessage);for(let[,e]of this.pendingRequests)clearTimeout(e.timer),e.reject(Error(`Bridge destroyed`));this.pendingRequests.clear(),this.pendingConnect&&(this.pendingConnect.reject(Error(`Bridge destroyed`)),this.pendingConnect=null),this.pendingDisconnect&&(this.pendingDisconnect.reject(Error(`Bridge destroyed`)),this.pendingDisconnect=null),this.eventListeners.clear()}}setInitialState(e,t,n){this.connected=e,this.address=t,this.chainType=n}handleWalletState(e,t){if(t<=this.lastWalletSeq)return;this.lastWalletSeq=t;let n=this.connected;this.connected=e.connected,this.address=e.address,e.chainType&&(this.chainType=e.chainType),e.connected&&this.pendingConnect&&(this.pendingConnect.resolve(),this.pendingConnect=null),!e.connected&&this.pendingDisconnect&&(this.pendingDisconnect.resolve(),this.pendingDisconnect=null),e.event?this.emit(e.event,{type:e.event,data:e}):e.connected&&!n?this.emit(`connect`,{type:`connect`,data:e}):!e.connected&&n?this.emit(`disconnect`,{type:`disconnect`,data:e}):e.connected&&this.emit(`accountsChanged`,{type:`accountsChanged`,data:e})}handleSignResult(e,t,n){let r=this.pendingRequests.get(e);r&&(this.pendingRequests.delete(e),clearTimeout(r.timer),n?r.reject(o(n)):t?r.resolve(t):r.reject(Error(`Invalid sign result: missing both result and error`)))}postToHost(e){this.destroyed||typeof window>`u`||!window.parent||window.parent.postMessage(e,this.hostOrigin)}emit(e,t){let n=this.eventListeners.get(e);if(n)for(let e of n)try{e(t)}catch{}}},m=`__TF_VERSION__`,h=class{constructor(t,i){this.destroyed=!1,this.resizeObserver=null,this.lastReportedHeight=0,this.popupClosedHandlers=new Set,this.providerEventHandlers=new Set,this.handleMessage=e=>{if(this.destroyed||e.origin!==this.hostOrigin)return;let t=n(e.data);if(t){if(c(t,`tf:init`))this.handleInit(t.payload);else if(c(t,`tf:setConfig`))this.callbacks.onConfigUpdate(t.payload);else if(c(t,`tf:setStyle`))this.callbacks.onStyleUpdate(t.payload);else if(c(t,`tf:fiatPopupClosed`)){let e=t.payload.orderId;this.callbacks.onFiatPopupClosed?.(e);for(let t of this.popupClosedHandlers)t(e)}else if(c(t,`tf:fiatProviderEvent`)){let e=t.payload;this.callbacks.onFiatProviderEvent?.(e);for(let t of this.providerEventHandlers)t(e)}}},this.hostOrigin=t,this.callbacks=i,this.walletAdapter=new p(t),window.addEventListener(`message`,this.handleMessage),e(this.getFiatBridge()),this.postToHost(r(`ready`,{version:m,protocolVersion:1}))}getFiatBridge(){return{requestPreOpenPopup:()=>this.requestPreOpenPopup(),requestNavigatePopup:(e,t)=>this.requestNavigatePopup(e,t),onPopupClosed:e=>(this.popupClosedHandlers.add(e),()=>this.popupClosedHandlers.delete(e)),onProviderEvent:e=>(this.providerEventHandlers.add(e),()=>this.providerEventHandlers.delete(e))}}observeResize(e){this.resizeObserver=new ResizeObserver(e=>{let t=e[0];if(!t)return;let n=Math.ceil(t.borderBoxSize?.[0]?.blockSize??t.contentRect.height);Math.abs(n-this.lastReportedHeight)<2||(this.lastReportedHeight=n,this.postToHost(r(`resize`,{height:n})))}),this.resizeObserver.observe(e)}emitEvent(e,t){this.postToHost(r(`event`,{name:e,data:t}))}requestPreOpenPopup(){this.postToHost(r(`preOpenPopup`,{}))}requestNavigatePopup(e,t){this.postToHost(r(`navigatePopup`,{url:e,orderId:t}))}destroy(){this.destroyed||(this.destroyed=!0,window.removeEventListener(`message`,this.handleMessage),this.walletAdapter.destroy(),this.popupClosedHandlers.clear(),this.providerEventHandlers.clear(),e(null),this.resizeObserver&&(this.resizeObserver.disconnect(),this.resizeObserver=null))}handleInit(e){this.walletAdapter.setInitialState(e.connected??!1,e.walletAddress??null,e.chainType),this.callbacks.onInit(e.config,e.style)}postToHost(e){this.destroyed||window.parent.postMessage(e,this.hostOrigin)}};function g(){try{return window!==window.top}catch{return!0}}function _(){if(!g())return null;try{if(document.referrer)return new URL(document.referrer).origin}catch{}return null}export{p as IframeBridgeWalletAdapter,h as IframeReceiver,u as TF_PROTOCOL_VERSION,l as TokenFlightBridge,s as consumeRequestId,r as createMessage,t as createRequestId,a as createTokenFlightBridge,o as deserializeError,_ as getHostOrigin,g as isIframeMode,c as isMessageType,n as parseMessage,i as serializeError};