@daimo/sdk 1.0.0-rc.1

package/dist/web/hooks/types.d.ts

@@ -0,0 +1,72 @@
+import type { NavNode, SessionWithNav } from "../api/navTree.js";
+import type { WalletPaymentOption } from "../api/walletTypes.js";
+export type { SessionWithNav };
+/**
+ * A single entry in the navigation stack. Back = pop.
+ * autoNav marks entries pushed by auto-navigation (single-option chains).
+ */
+export type NavEntry = {
+    type: "choose-option";
+    nodeId: string;
+    autoNav: boolean;
+} | {
+    type: "deeplink";
+    nodeId: string;
+    autoNav?: boolean;
+} | {
+    type: "select-amount";
+    nodeId: string;
+    flowType: "deposit" | "tron" | "exchange";
+    autoNav?: boolean;
+} | {
+    type: "waiting-deposit";
+    nodeId: string;
+    amountUsd: number;
+    autoNav?: boolean;
+} | {
+    type: "waiting-tron";
+    nodeId: string;
+    amountUsd: number;
+    address?: string;
+    expiresAt?: number;
+    error?: string;
+    autoNav?: boolean;
+} | {
+    type: "exchange-page";
+    nodeId: string;
+    amountUsd: number;
+    exchangeUrl?: string;
+    waitingMessage?: string;
+    error?: string;
+    autoNav?: boolean;
+} | {
+    type: "wallet-connect";
+    nodeId: string;
+    autoNav?: boolean;
+} | {
+    type: "wallet-select-token";
+    nodeId: string;
+    autoNav?: boolean;
+} | {
+    type: "wallet-select-amount";
+    nodeId: string;
+    token: WalletPaymentOption;
+    autoNav?: boolean;
+} | {
+    type: "wallet-sending";
+    nodeId: string;
+    token: WalletPaymentOption;
+    amountUsd: number;
+    txHash?: string;
+    error?: string;
+    autoNav?: boolean;
+};
+export type DaimoModalEventHandlers = {
+    onPaymentStarted?: () => void;
+    onPaymentCompleted?: () => void;
+    onOpen?: () => void;
+    onClose?: () => void;
+};
+/** Helper to find a node by ID in the nav tree */
+export declare function findNode(nodeId: string, nodes: NavNode[]): NavNode | null;
+//# sourceMappingURL=types.d.ts.map

package/dist/web/hooks/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/web/hooks/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAChB;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GACvD;IACE,IAAI,EAAE,eAAe,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GACD;IACE,IAAI,EAAE,iBAAiB,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GACD;IACE,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GACD;IACE,IAAI,EAAE,eAAe,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GACD;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAClE;IACE,IAAI,EAAE,sBAAsB,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,mBAAmB,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GACD;IACE,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,mBAAmB,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEN,MAAM,MAAM,uBAAuB,GAAG;IACpC,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB,CAAC;AAEF,kDAAkD;AAClD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,GAAG,IAAI,CAQzE"}

package/dist/web/hooks/types.js

@@ -0,0 +1,14 @@
+/** Helper to find a node by ID in the nav tree */
+export function findNode(nodeId, nodes) {
+    for (const node of nodes) {
+        if (node.id === nodeId)
+            return node;
+        if (node.type !== "ChooseOption")
+            continue;
+        const found = findNode(nodeId, node.options);
+        if (found)
+            return found;
+    }
+    return null;
+}
+//# sourceMappingURL=types.js.map

package/dist/web/hooks/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/web/hooks/types.ts"],"names":[],"mappings":"AAmEA,kDAAkD;AAClD,MAAM,UAAU,QAAQ,CAAC,MAAc,EAAE,KAAgB;IACvD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,EAAE,KAAK,MAAM;YAAE,OAAO,IAAI,CAAC;QACpC,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc;YAAE,SAAS;QAC3C,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;IAC1B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/web/hooks/useCopyToClipboard.d.ts

@@ -0,0 +1,6 @@
+/** Web-only clipboard hook with visual feedback. */
+export declare function useCopyToClipboard(resetMs?: number): {
+    copy: (text: string) => Promise<void>;
+    copied: boolean;
+};
+//# sourceMappingURL=useCopyToClipboard.d.ts.map

package/dist/web/hooks/useCopyToClipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCopyToClipboard.d.ts","sourceRoot":"","sources":["../../../src/web/hooks/useCopyToClipboard.ts"],"names":[],"mappings":"AAEA,oDAAoD;AACpD,wBAAgB,kBAAkB,CAAC,OAAO,SAAO;iBAKhC,MAAM;;EActB"}

package/dist/web/hooks/useCopyToClipboard.js

@@ -0,0 +1,20 @@
+import { useCallback, useRef, useState } from "react";
+/** Web-only clipboard hook with visual feedback. */
+export function useCopyToClipboard(resetMs = 2000) {
+    const [copied, setCopied] = useState(false);
+    const timerRef = useRef(null);
+    const copy = useCallback(async (text) => {
+        try {
+            await navigator.clipboard.writeText(text);
+            setCopied(true);
+            if (timerRef.current)
+                clearTimeout(timerRef.current);
+            timerRef.current = setTimeout(() => setCopied(false), resetMs);
+        }
+        catch {
+            console.error("failed to copy to clipboard");
+        }
+    }, [resetMs]);
+    return { copy, copied };
+}
+//# sourceMappingURL=useCopyToClipboard.js.map

package/dist/web/hooks/useCopyToClipboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCopyToClipboard.js","sourceRoot":"","sources":["../../../src/web/hooks/useCopyToClipboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEtD,oDAAoD;AACpD,MAAM,UAAU,kBAAkB,CAAC,OAAO,GAAG,IAAI;IAC/C,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,MAAM,CAAuC,IAAI,CAAC,CAAC;IAEpE,MAAM,IAAI,GAAG,WAAW,CACtB,KAAK,EAAE,IAAY,EAAE,EAAE;QACrB,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC1C,SAAS,CAAC,IAAI,CAAC,CAAC;YAChB,IAAI,QAAQ,CAAC,OAAO;gBAAE,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACrD,QAAQ,CAAC,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;QACjE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC,EACD,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC1B,CAAC"}

package/dist/web/hooks/usePaymentCallbacks.d.ts

@@ -0,0 +1,15 @@
+import type { SessionWithNav } from "../api/navTree.js";
+type PaymentCallbacks = {
+    onOpen?: () => void;
+    onPaymentStarted?: () => void;
+    onPaymentCompleted?: () => void;
+};
+/**
+ * Manages payment lifecycle callbacks:
+ * - onOpen: when modal opens
+ * - onPaymentStarted: when first fulfillment is detected
+ * - onPaymentCompleted: when session completes
+ */
+export declare function usePaymentCallbacks(session: SessionWithNav, isOpen: boolean, callbacks: PaymentCallbacks): void;
+export {};
+//# sourceMappingURL=usePaymentCallbacks.d.ts.map

package/dist/web/hooks/usePaymentCallbacks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePaymentCallbacks.d.ts","sourceRoot":"","sources":["../../../src/web/hooks/usePaymentCallbacks.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,KAAK,gBAAgB,GAAG;IACtB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;CACjC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,gBAAgB,QAmB5B"}

package/dist/web/hooks/usePaymentCallbacks.js

@@ -0,0 +1,27 @@
+import { useEffect } from "react";
+/**
+ * Manages payment lifecycle callbacks:
+ * - onOpen: when modal opens
+ * - onPaymentStarted: when first fulfillment is detected
+ * - onPaymentCompleted: when session completes
+ */
+export function usePaymentCallbacks(session, isOpen, callbacks) {
+    const isStarted = session.status === "processing" ||
+        session.status === "succeeded" ||
+        session.status === "bounced";
+    const isCompleted = session.status === "succeeded";
+    const { onOpen, onPaymentStarted, onPaymentCompleted } = callbacks;
+    useEffect(() => {
+        if (isOpen)
+            onOpen?.();
+    }, [session.sessionId, isOpen, onOpen]);
+    useEffect(() => {
+        if (isStarted)
+            onPaymentStarted?.();
+    }, [session.sessionId, isStarted, onPaymentStarted]);
+    useEffect(() => {
+        if (isCompleted)
+            onPaymentCompleted?.();
+    }, [session.sessionId, isCompleted, onPaymentCompleted]);
+}
+//# sourceMappingURL=usePaymentCallbacks.js.map

package/dist/web/hooks/usePaymentCallbacks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePaymentCallbacks.js","sourceRoot":"","sources":["../../../src/web/hooks/usePaymentCallbacks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAUlC;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAuB,EACvB,MAAe,EACf,SAA2B;IAE3B,MAAM,SAAS,GACb,OAAO,CAAC,MAAM,KAAK,YAAY;QAC/B,OAAO,CAAC,MAAM,KAAK,WAAW;QAC9B,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC;IAC/B,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,KAAK,WAAW,CAAC;IAEnD,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,GAAG,SAAS,CAAC;IAEnE,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,MAAM;YAAE,MAAM,EAAE,EAAE,CAAC;IACzB,CAAC,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACxC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,SAAS;YAAE,gBAAgB,EAAE,EAAE,CAAC;IACtC,CAAC,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,EAAE,gBAAgB,CAAC,CAAC,CAAC;IACrD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,WAAW;YAAE,kBAAkB,EAAE,EAAE,CAAC;IAC1C,CAAC,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,WAAW,EAAE,kBAAkB,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/web/hooks/useSessionNav.d.ts

@@ -0,0 +1,28 @@
+import type { SessionWithNav } from "../api/navTree.js";
+import type { WalletPaymentOption } from "../api/walletTypes.js";
+import { type NavNodeType } from "./navEvent.js";
+import { type NavEntry } from "./types.js";
+type NodeContext = {
+    nodeId: string | null;
+    nodeType: NavNodeType | null;
+};
+type SessionNavResult = {
+    stack: NavEntry[];
+    topEntry: NavEntry | null;
+    getNodeCtx: () => NodeContext;
+    canGoBack: boolean;
+    handleNavigate: (nodeId: string, options?: {
+        autoNav?: boolean;
+    }) => void;
+    handleBack: () => void;
+    handleAmountContinue: (amountUsd: number) => void;
+    handleRetry: () => void;
+    handleRefresh: () => Promise<void>;
+    handleWalletConnected: () => void;
+    handleWalletSelectToken: (token: WalletPaymentOption) => void;
+    handleWalletSending: (token: WalletPaymentOption, amountUsd: number) => void;
+    handleWalletTxResult: (txHash?: string, error?: string) => void;
+};
+export declare function useSessionNav(session: SessionWithNav, setSession: React.Dispatch<React.SetStateAction<SessionWithNav>>, platform?: "ios" | "android" | "other"): SessionNavResult;
+export {};
+//# sourceMappingURL=useSessionNav.d.ts.map

package/dist/web/hooks/useSessionNav.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSessionNav.d.ts","sourceRoot":"","sources":["../../../src/web/hooks/useSessionNav.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAKjE,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAErD,KAAK,WAAW,GAAG;IAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAA;CAAE,CAAC;AAE3E,KAAK,gBAAgB,GAAG;IACtB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,WAAW,CAAC;IAC9B,SAAS,EAAE,OAAO,CAAC;IAEnB,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAC1E,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,oBAAoB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC,qBAAqB,EAAE,MAAM,IAAI,CAAC;IAClC,uBAAuB,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAC9D,mBAAmB,EAAE,CAAC,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7E,oBAAoB,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CACjE,CAAC;AAEF,wBAAgB,aAAa,CAC3B,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC,EAChE,QAAQ,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,OAAO,GACrC,gBAAgB,CAmelB"}

package/dist/web/hooks/useSessionNav.js

@@ -0,0 +1,422 @@
+import { useCallback, useMemo, useState } from "react";
+import { useDaimoClient } from "./DaimoClientContext.js";
+import { t } from "./locale.js";
+import { createNavLogger } from "./navEvent.js";
+import { findNode } from "./types.js";
+export function useSessionNav(session, setSession, platform) {
+    const client = useDaimoClient();
+    const logNavEvent = createNavLogger(client);
+    const [stack, setStack] = useState([]);
+    const topEntry = stack.length > 0 ? stack[stack.length - 1] : null;
+    const getNodeCtx = useCallback(() => {
+        const nodeId = topEntry?.nodeId ?? session.navTree[0]?.id ?? null;
+        const nodeType = nodeId
+            ? (findNode(nodeId, session.navTree)?.type ?? null)
+            : null;
+        return { nodeId, nodeType };
+    }, [topEntry, session.navTree]);
+    const canGoBack = stack.length > 0 && stack.some((e) => !e.autoNav);
+    // ─── Async fetchers ─────────────────────────────────────────────────────
+    const fetchTronAddress = useCallback(async (nodeId, amountUsd) => {
+        try {
+            const result = await client.sessions.paymentMethods.create(session.sessionId, {
+                clientSecret: session.clientSecret,
+                paymentMethod: { type: "tron", amountUsd },
+            });
+            if (!result.tron) {
+                throw new Error("tron address not returned");
+            }
+            logNavEvent(session.sessionId, session.clientSecret, {
+                nodeId,
+                nodeType: "TronDeposit",
+                action: "flow_tron_address",
+                success: true,
+                address: result.tron.receiverAddress,
+            });
+            setStack((prev) => {
+                const top = prev[prev.length - 1];
+                if (top?.type !== "waiting-tron" || top.nodeId !== nodeId)
+                    return prev;
+                return [
+                    ...prev.slice(0, -1),
+                    {
+                        ...top,
+                        address: result.tron.receiverAddress,
+                        expiresAt: result.tron.expiresAt,
+                        error: undefined,
+                    },
+                ];
+            });
+        }
+        catch (error) {
+            console.error("failed to create tron address:", error);
+            const errorMsg = error instanceof Error ? error.message : t.tronUnavailable;
+            logNavEvent(session.sessionId, session.clientSecret, {
+                nodeId,
+                nodeType: "TronDeposit",
+                action: "flow_tron_address",
+                success: false,
+                error: errorMsg,
+            });
+            setStack((prev) => {
+                const top = prev[prev.length - 1];
+                if (top?.type !== "waiting-tron" || top.nodeId !== nodeId)
+                    return prev;
+                return [...prev.slice(0, -1), { ...top, error: errorMsg }];
+            });
+        }
+    }, [session.sessionId, session.clientSecret, client]);
+    const fetchExchangeUrl = useCallback(async (nodeId, exchangeId, amountUsd) => {
+        try {
+            const result = await client.sessions.paymentMethods.create(session.sessionId, {
+                clientSecret: session.clientSecret,
+                paymentMethod: {
+                    type: "exchange",
+                    exchangeId: exchangeId,
+                    amountUsd,
+                    platform,
+                },
+            });
+            if (!result.exchange)
+                return;
+            logNavEvent(session.sessionId, session.clientSecret, {
+                nodeId,
+                nodeType: "Exchange",
+                action: "flow_exchange_url",
+                exchangeId,
+                success: true,
+                url: result.exchange.url,
+            });
+            setStack((prev) => {
+                const top = prev[prev.length - 1];
+                if (top?.type !== "exchange-page" || top.nodeId !== nodeId)
+                    return prev;
+                return [
+                    ...prev.slice(0, -1),
+                    {
+                        ...top,
+                        exchangeUrl: result.exchange.url,
+                        waitingMessage: result.exchange.waitingMessage,
+                        error: undefined,
+                    },
+                ];
+            });
+        }
+        catch (error) {
+            console.error("failed to get exchange url:", error);
+            const errorMsg = error instanceof Error ? error.message : "failed to get exchange url";
+            logNavEvent(session.sessionId, session.clientSecret, {
+                nodeId,
+                nodeType: "Exchange",
+                action: "flow_exchange_url",
+                exchangeId,
+                success: false,
+                error: errorMsg,
+            });
+            setStack((prev) => {
+                const top = prev[prev.length - 1];
+                if (top?.type !== "exchange-page" || top.nodeId !== nodeId)
+                    return prev;
+                return [...prev.slice(0, -1), { ...top, error: errorMsg }];
+            });
+        }
+    }, [session.sessionId, session.clientSecret, platform, client]);
+    // ─── Navigation handlers ────────────────────────────────────────────────
+    const handleNavigate = useCallback((nodeId, options) => {
+        const nodeCtx = getNodeCtx();
+        const targetNode = findNode(nodeId, session.navTree);
+        if (!targetNode)
+            return;
+        const autoNav = options?.autoNav ?? false;
+        if (targetNode.type === "Deeplink" && targetNode.url) {
+            logNavEvent(session.sessionId, session.clientSecret, {
+                ...nodeCtx,
+                action: "nav_deeplink",
+                url: targetNode.url,
+            });
+            window.open(targetNode.url, "_blank");
+        }
+        logNavEvent(session.sessionId, session.clientSecret, {
+            ...nodeCtx,
+            action: "nav_select",
+            targetNodeId: nodeId,
+            targetNodeType: targetNode.type,
+        });
+        if (targetNode.type === "ChooseOption") {
+            setStack((prev) => [
+                ...prev,
+                { type: "choose-option", nodeId, autoNav },
+            ]);
+            return;
+        }
+        if (targetNode.type === "Deeplink") {
+            setStack((prev) => [...prev, { type: "deeplink", nodeId, autoNav }]);
+            return;
+        }
+        if (targetNode.type === "ConnectedWallet") {
+            setStack((prev) => [
+                ...prev,
+                { type: "wallet-connect", nodeId, autoNav },
+            ]);
+            return;
+        }
+        const { amountUnits, tokenSymbol } = session.destination;
+        if (amountUnits) {
+            console.assert(tokenSymbol.includes("USD"), `expected USD destination, got ${tokenSymbol}`);
+        }
+        const requiredUsd = amountUnits ? parseFloat(amountUnits) : 0;
+        if (targetNode.type === "DepositAddress") {
+            if (requiredUsd > 0) {
+                setStack((prev) => [
+                    ...prev,
+                    {
+                        type: "waiting-deposit",
+                        nodeId,
+                        amountUsd: requiredUsd,
+                        autoNav,
+                    },
+                ]);
+                return;
+            }
+            setStack((prev) => [
+                ...prev,
+                { type: "select-amount", nodeId, flowType: "deposit", autoNav },
+            ]);
+            return;
+        }
+        if (targetNode.type === "TronDeposit") {
+            if (requiredUsd > 0) {
+                setStack((prev) => [
+                    ...prev,
+                    {
+                        type: "waiting-tron",
+                        nodeId,
+                        amountUsd: requiredUsd,
+                        autoNav,
+                    },
+                ]);
+                fetchTronAddress(nodeId, requiredUsd);
+                return;
+            }
+            setStack((prev) => [
+                ...prev,
+                { type: "select-amount", nodeId, flowType: "tron", autoNav },
+            ]);
+            return;
+        }
+        if (targetNode.type === "Exchange") {
+            if (requiredUsd > 0) {
+                setStack((prev) => [
+                    ...prev,
+                    { type: "exchange-page", nodeId, amountUsd: requiredUsd, autoNav },
+                ]);
+                fetchExchangeUrl(nodeId, targetNode.exchangeId, requiredUsd);
+                return;
+            }
+            setStack((prev) => [
+                ...prev,
+                { type: "select-amount", nodeId, flowType: "exchange", autoNav },
+            ]);
+        }
+    }, [
+        session.navTree,
+        session.sessionId,
+        session.destination,
+        getNodeCtx,
+        fetchTronAddress,
+        fetchExchangeUrl,
+    ]);
+    const handleBack = useCallback(() => {
+        logNavEvent(session.sessionId, session.clientSecret, { ...getNodeCtx(), action: "nav_back" });
+        setStack((prev) => {
+            if (prev.length === 0)
+                return prev;
+            const next = prev.slice(0, -1);
+            while (next.length > 0) {
+                const top = next[next.length - 1];
+                if (!top.autoNav)
+                    break;
+                if (top.type === "select-amount")
+                    break;
+                if (top.type === "choose-option") {
+                    const node = findNode(top.nodeId, session.navTree);
+                    if (node != null && node.options.length > 1)
+                        break;
+                }
+                next.pop();
+            }
+            return next;
+        });
+    }, [session.sessionId, session.navTree, getNodeCtx]);
+    // ─── Flow handlers ──────────────────────────────────────────────────────
+    const handleAmountContinue = useCallback((amountUsd) => {
+        if (!topEntry || topEntry.type !== "select-amount")
+            return;
+        const { nodeId, flowType } = topEntry;
+        logNavEvent(session.sessionId, session.clientSecret, {
+            nodeId,
+            nodeType: flowType === "deposit"
+                ? "DepositAddress"
+                : flowType === "tron"
+                    ? "TronDeposit"
+                    : "Exchange",
+            action: "flow_amount_continue",
+            amountUsd,
+        });
+        if (flowType === "deposit") {
+            setStack((prev) => [
+                ...prev,
+                { type: "waiting-deposit", nodeId, amountUsd },
+            ]);
+        }
+        else if (flowType === "tron") {
+            setStack((prev) => [
+                ...prev,
+                { type: "waiting-tron", nodeId, amountUsd },
+            ]);
+            fetchTronAddress(nodeId, amountUsd);
+        }
+        else if (flowType === "exchange") {
+            const node = findNode(nodeId, session.navTree);
+            setStack((prev) => [
+                ...prev,
+                { type: "exchange-page", nodeId, amountUsd },
+            ]);
+            if (node)
+                fetchExchangeUrl(nodeId, node.exchangeId, amountUsd);
+        }
+    }, [
+        topEntry,
+        session.sessionId,
+        session.navTree,
+        fetchTronAddress,
+        fetchExchangeUrl,
+    ]);
+    const handleRetry = useCallback(() => {
+        if (!topEntry)
+            return;
+        if (topEntry.type === "waiting-tron") {
+            setStack((prev) => {
+                const top = prev[prev.length - 1];
+                if (top?.type !== "waiting-tron")
+                    return prev;
+                return [
+                    ...prev.slice(0, -1),
+                    {
+                        ...top,
+                        address: undefined,
+                        expiresAt: undefined,
+                        error: undefined,
+                    },
+                ];
+            });
+            fetchTronAddress(topEntry.nodeId, topEntry.amountUsd);
+            return;
+        }
+        if (topEntry.type === "exchange-page") {
+            const node = findNode(topEntry.nodeId, session.navTree);
+            if (!node)
+                return;
+            setStack((prev) => {
+                const top = prev[prev.length - 1];
+                if (top?.type !== "exchange-page")
+                    return prev;
+                return [
+                    ...prev.slice(0, -1),
+                    { ...top, exchangeUrl: undefined, error: undefined },
+                ];
+            });
+            fetchExchangeUrl(topEntry.nodeId, node.exchangeId, topEntry.amountUsd);
+        }
+    }, [topEntry, session.navTree, fetchTronAddress, fetchExchangeUrl]);
+    const handleRefresh = useCallback(async () => {
+        logNavEvent(session.sessionId, session.clientSecret, { ...getNodeCtx(), action: "flow_refresh" });
+        try {
+            const { session: newSession } = await client.internal.sessions.recreate(session.sessionId, session.clientSecret);
+            setStack([]);
+            setSession(newSession);
+        }
+        catch (error) {
+            console.error("failed to recreate session:", error);
+        }
+    }, [session.sessionId, session.clientSecret, getNodeCtx, setSession, client]);
+    // ─── Wallet flow handlers ───────────────────────────────────────────────
+    const handleWalletConnected = useCallback(() => {
+        if (topEntry?.type !== "wallet-connect")
+            return;
+        setStack((prev) => [
+            ...prev,
+            { type: "wallet-select-token", nodeId: topEntry.nodeId },
+        ]);
+    }, [topEntry]);
+    const handleWalletSelectToken = useCallback((token) => {
+        if (topEntry?.type !== "wallet-select-token")
+            return;
+        const { amountUnits } = session.destination;
+        const requiredUsd = amountUnits ? parseFloat(amountUnits) : 0;
+        if (requiredUsd > 0) {
+            setStack((prev) => [
+                ...prev,
+                {
+                    type: "wallet-sending",
+                    nodeId: topEntry.nodeId,
+                    token,
+                    amountUsd: requiredUsd,
+                },
+            ]);
+        }
+        else {
+            setStack((prev) => [
+                ...prev,
+                { type: "wallet-select-amount", nodeId: topEntry.nodeId, token },
+            ]);
+        }
+    }, [topEntry, session.destination]);
+    const handleWalletSending = useCallback((token, amountUsd) => {
+        if (topEntry?.type !== "wallet-select-amount" &&
+            topEntry?.type !== "wallet-select-token")
+            return;
+        setStack((prev) => [
+            ...prev,
+            { type: "wallet-sending", nodeId: topEntry.nodeId, token, amountUsd },
+        ]);
+    }, [topEntry]);
+    const handleWalletTxResult = useCallback((txHash, error) => {
+        setStack((prev) => {
+            const top = prev[prev.length - 1];
+            if (top?.type !== "wallet-sending")
+                return prev;
+            return [...prev.slice(0, -1), { ...top, txHash, error }];
+        });
+    }, []);
+    return useMemo(() => ({
+        stack,
+        topEntry,
+        getNodeCtx,
+        canGoBack,
+        handleNavigate,
+        handleBack,
+        handleAmountContinue,
+        handleRetry,
+        handleRefresh,
+        handleWalletConnected,
+        handleWalletSelectToken,
+        handleWalletSending,
+        handleWalletTxResult,
+    }), [
+        stack,
+        topEntry,
+        getNodeCtx,
+        canGoBack,
+        handleNavigate,
+        handleBack,
+        handleAmountContinue,
+        handleRetry,
+        handleRefresh,
+        handleWalletConnected,
+        handleWalletSelectToken,
+        handleWalletSending,
+        handleWalletTxResult,
+    ]);
+}
+//# sourceMappingURL=useSessionNav.js.map