@bananapus/nana-sdk-core 6.0.0 → 6.2.0

package/dist/cjs/review/locks.js

@@ -0,0 +1,232 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LockLostError = void 0;
+exports.assertLocksHeld = assertLocksHeld;
+exports.fencedLocks = fencedLocks;
+exports.browserLocks = browserLocks;
+const tabState_js_1 = require("./tabState.js");
+/** Thrown by {@link LockHandle.assertHeld} once this tab no longer holds the lock. */
+class LockLostError extends Error {
+    constructor(lock) {
+        super(`The "${lock}" lock was lost. Its work must stop before writing.`);
+        this.lock = lock;
+        this.name = "LockLostError";
+        this.code = "LOCK_LOST";
+    }
+}
+exports.LockLostError = LockLostError;
+/**
+ * Throws {@link LockLostError} unless every given lock is still this tab's,
+ * on a fresh read; `null` and `undefined` are skipped. One line before a
+ * write under several locks: `await assertLocksHeld([a, b]); save()`.
+ */
+async function assertLocksHeld(locks) {
+    await Promise.all((locks ?? []).map((lock) => lock?.assertHeld()));
+}
+const NEVER = new AbortController().signal;
+function handle(name, mode, held, signal = NEVER) {
+    return {
+        name,
+        mode,
+        signal,
+        held,
+        async assertHeld() {
+            if (!(await held()))
+                throw new LockLostError(name);
+        },
+    };
+}
+function isHandle(lock) {
+    return typeof lock.assertHeld === "function";
+}
+/** `request`'s two shapes, as `navigator.locks` takes them. */
+function shaped(options, work) {
+    return typeof options === "function" ? [{}, options] : [options, work];
+}
+/**
+ * Any Web Locks manager (`navigator.locks`, a test's) handing a
+ * {@link LockHandle}: a handle it hands already passes through; any other
+ * lock is never lost while its work runs.
+ */
+function fencedLocks(locks) {
+    return {
+        request(name, options, work) {
+            const [opts, run] = shaped(options, work);
+            return locks.request(name, opts, (lock) => {
+                if (!lock)
+                    return run(null);
+                if (isHandle(lock))
+                    return run(lock);
+                let running = true;
+                return Promise.resolve(run(handle(lock.name, lock.mode, async () => running))).finally(() => (running = false));
+            });
+        },
+    };
+}
+const TAB_QUEUES = tabState_js_1.TAB.queues;
+// Without Web Locks, writes in this tab still run one at a time per action,
+// across every copy of this module loaded in the tab.
+const tabQueues = (globalThis[TAB_QUEUES] ??= new Map());
+let tabLocksNoted = false;
+const tabLocks = {
+    async request(name, options, work) {
+        const held = tabQueues.get(name);
+        if (held && options.ifAvailable)
+            return work(null);
+        let release;
+        const mine = new Promise((resolve) => (release = resolve));
+        const queue = (held ?? Promise.resolve()).then(() => mine);
+        tabQueues.set(name, queue);
+        await held;
+        let running = true;
+        try {
+            return await work(handle(name, "exclusive", async () => running));
+        }
+        finally {
+            running = false;
+            release();
+            if (tabQueues.get(name) === queue)
+                tabQueues.delete(name);
+        }
+    },
+};
+// Without Web Locks, tabs share an IndexedDB lease per action. A readwrite
+// transaction is atomic across the origin's tabs, so claiming a lease is a
+// compare-and-set. Each acquisition has its own owner token. The holder
+// renews it while it works, only while it is still its own and unexpired; a
+// tab that closed or froze loses it once it lapses, and its handle then
+// reads as lost.
+const LEASE_DB = "nana-sdk-write-locks";
+const LEASE_STORE = "leases";
+const LEASE_MS = 15_000;
+const LEASE_RENEW_MS = 5_000;
+const LEASE_POLL_MS = 50;
+function leaseTransaction(db, mode, run) {
+    return new Promise((resolve, reject) => {
+        const transaction = db.transaction(LEASE_STORE, mode);
+        let result;
+        run(transaction.objectStore(LEASE_STORE), (value) => (result = value));
+        transaction.oncomplete = () => resolve(result);
+        transaction.onerror = transaction.onabort = () => reject(transaction.error);
+    });
+}
+/** Whether `lease` is `owner`'s and unexpired. */
+const owns = (lease, owner) => lease?.owner === owner && lease.expires > Date.now();
+/**
+ * Take `name`'s lease for `owner` (`renew`: only extend it while still
+ * `owner`'s); false while another tab holds it, or once a renewal finds it lost.
+ */
+function claimLease(db, name, owner, renew = false) {
+    return leaseTransaction(db, "readwrite", (store, done) => {
+        done(false);
+        const read = store.get(name);
+        read.onsuccess = () => {
+            const lease = read.result;
+            const now = Date.now();
+            if (renew ? !owns(lease, owner) : lease && lease.expires > now)
+                return;
+            store.put({ owner, expires: now + LEASE_MS }, name);
+            done(true);
+        };
+    });
+}
+function readLease(db, name) {
+    return leaseTransaction(db, "readonly", (store, done) => {
+        const read = store.get(name);
+        read.onsuccess = () => done(read.result);
+    });
+}
+/** Drop `name`'s lease only while it is still `owner`'s. */
+function dropLease(db, name, owner) {
+    return leaseTransaction(db, "readwrite", (store) => {
+        const read = store.get(name);
+        read.onsuccess = () => {
+            if (read.result?.owner === owner)
+                store.delete(name);
+        };
+    });
+}
+function leaseLocks(factory) {
+    let opened;
+    const database = () => (opened ??= new Promise((resolve, reject) => {
+        const request = factory.open(LEASE_DB, 1);
+        request.onupgradeneeded = () => request.result.createObjectStore(LEASE_STORE);
+        request.onsuccess = () => resolve(request.result);
+        request.onerror = () => reject(request.error);
+    }).catch((error) => {
+        opened = undefined;
+        throw error;
+    }));
+    return {
+        request: (name, options, work) => tabLocks.request(name, options, async (tabLock) => {
+            if (!tabLock)
+                return work(null);
+            let db;
+            try {
+                db = await database();
+            }
+            catch {
+                // IndexedDB refused (as in some private windows): this tab only.
+                return work(tabLock);
+            }
+            const owner = globalThis.crypto.randomUUID();
+            while (!(await claimLease(db, name, owner))) {
+                if (options.ifAvailable)
+                    return work(null);
+                await new Promise((resolve) => setTimeout(resolve, LEASE_POLL_MS));
+            }
+            const lost = new AbortController();
+            let running = true;
+            const held = async () => {
+                if (!running || lost.signal.aborted)
+                    return false;
+                // Never cached: a tab back from suspension reads what is there now.
+                const mine = owns(await readLease(db, name).catch(() => undefined), owner);
+                if (!mine)
+                    lost.abort(new LockLostError(name));
+                return mine && running;
+            };
+            const renew = setInterval(() => void claimLease(db, name, owner, true)
+                .then((kept) => kept || lost.abort(new LockLostError(name)))
+                .catch(() => { }), LEASE_RENEW_MS);
+            try {
+                return await work(handle(name, "exclusive", held, lost.signal));
+            }
+            finally {
+                running = false;
+                clearInterval(renew);
+                await dropLease(db, name, owner).catch(() => { });
+            }
+        }),
+    };
+}
+const inTabLocks = fencedLocks(tabLocks);
+let leasedLocks;
+/**
+ * The browser's Web Locks. Where a browser or wallet webview has none, an
+ * IndexedDB lease shared by the origin's tabs (one transaction, no visible
+ * delay; it waits only while another tab holds the action), with a one-time
+ * console note. With neither, a lock within this tab. Never refuses.
+ *
+ * `request(name, work)` or `request(name, options, work)`, as on
+ * `navigator.locks`; `work` gets a {@link LockHandle}. Call its
+ * `assertHeld()` immediately before every journal write and every wallet
+ * submission inside the lock: a lease can lapse while the tab is suspended
+ * (as while the user is in a wallet app) and pass to another tab. The check
+ * narrows that window to the time between the check and the write.
+ */
+function browserLocks() {
+    const native = globalThis.navigator?.locks;
+    if (native)
+        return fencedLocks(native);
+    if (!tabLocksNoted) {
+        tabLocksNoted = true;
+        console.info(globalThis.indexedDB
+            ? "Web Locks are unavailable, so wallet writes are coordinated across tabs through IndexedDB."
+            : "Web Locks are unavailable, so wallet writes are coordinated within this tab only.");
+    }
+    if (!globalThis.indexedDB)
+        return inTabLocks;
+    return (leasedLocks ??= fencedLocks(leaseLocks(globalThis.indexedDB)));
+}
+//# sourceMappingURL=locks.js.map

package/dist/cjs/review/locks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locks.js","sourceRoot":"","sources":["../../../src/review/locks.ts"],"names":[],"mappings":"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"}

package/dist/cjs/review/machines.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The send lifecycle's pure machines, apart from the `/review` barrel so a
+ * page that only shows a run's status or queues its reviews loads no Safe,
+ * Relayr or decoding code.
+ */
+export * from "./runStatus.js";
+export * from "./reviewDialogQueue.js";
+export * from "./relayrLaunch.js";
+//# sourceMappingURL=machines.d.ts.map

package/dist/cjs/review/machines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"machines.d.ts","sourceRoot":"","sources":["../../../src/review/machines.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC"}

package/dist/cjs/review/machines.js

@@ -0,0 +1,25 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * The send lifecycle's pure machines, apart from the `/review` barrel so a
+ * page that only shows a run's status or queues its reviews loads no Safe,
+ * Relayr or decoding code.
+ */
+__exportStar(require("./runStatus.js"), exports);
+__exportStar(require("./reviewDialogQueue.js"), exports);
+__exportStar(require("./relayrLaunch.js"), exports);
+//# sourceMappingURL=machines.js.map

package/dist/cjs/review/machines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"machines.js","sourceRoot":"","sources":["../../../src/review/machines.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;GAIG;AACH,iDAA+B;AAC/B,yDAAuC;AACvC,oDAAkC"}

package/dist/cjs/review/react/index.d.ts

@@ -4,4 +4,7 @@ export * from "./useHeldWrites.js";
 export * from "./useSavedAttempt.js";
 export * from "./useHeldSend.js";
 export * from "./useReviewedRun.js";
+export * from "./useFeeBuybackReview.js";
+export * from "./useStartOnce.js";
+export * from "./useMobileWallet.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/review/react/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/review/react/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/review/react/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC"}

package/dist/cjs/review/react/index.js

@@ -20,4 +20,7 @@ __exportStar(require("./useHeldWrites.js"), exports);
 __exportStar(require("./useSavedAttempt.js"), exports);
 __exportStar(require("./useHeldSend.js"), exports);
 __exportStar(require("./useReviewedRun.js"), exports);
+__exportStar(require("./useFeeBuybackReview.js"), exports);
+__exportStar(require("./useStartOnce.js"), exports);
+__exportStar(require("./useMobileWallet.js"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/review/react/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/review/react/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,oDAAkC;AAClC,qDAAmC;AACnC,uDAAqC;AACrC,mDAAiC;AACjC,sDAAoC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/review/react/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,oDAAkC;AAClC,qDAAmC;AACnC,uDAAqC;AACrC,mDAAiC;AACjC,sDAAoC;AACpC,2DAAyC;AACzC,oDAAkC;AAClC,uDAAqC"}

package/dist/cjs/review/react/useFeeBuybackReview.d.ts

@@ -0,0 +1,6 @@
+import { createFeeBuybackReview, type FeeReviewCall, type FeeReviewContext, type FeeReviewState } from "../../v6/feeBuyback.js";
+type FeeReview = ReturnType<typeof createFeeBuybackReview>;
+/** A review dialog's fee return check; it starts over when `calls` changes. */
+export declare function useFeeBuybackReview(calls: readonly FeeReviewCall[], context: FeeReviewContext): FeeReviewState & Pick<FeeReview, "confirm" | "retry" | "wait">;
+export {};
+//# sourceMappingURL=useFeeBuybackReview.d.ts.map

package/dist/cjs/review/react/useFeeBuybackReview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFeeBuybackReview.d.ts","sourceRoot":"","sources":["../../../../src/review/react/useFeeBuybackReview.ts"],"names":[],"mappings":"AACA,OAAO,EACL,sBAAsB,EACtB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACpB,MAAM,wBAAwB,CAAC;AAEhC,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAa3D,+EAA+E;AAC/E,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,aAAa,EAAE,EAC/B,OAAO,EAAE,gBAAgB,GACxB,cAAc,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC,CA8ChE"}

package/dist/cjs/review/react/useFeeBuybackReview.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useFeeBuybackReview = useFeeBuybackReview;
+const react_1 = require("react");
+const feeBuyback_js_1 = require("../../v6/feeBuyback.js");
+/** What `calls` show before their review starts: checking when one pays a fee. */
+function unchecked(calls) {
+    const first = (0, feeBuyback_js_1.createFeeBuybackReview)(calls, () => undefined, () => undefined);
+    first.stop();
+    return first.getState();
+}
+/** A review dialog's fee return check; it starts over when `calls` changes. */
+function useFeeBuybackReview(calls, context) {
+    const contextRef = (0, react_1.useRef)(context);
+    contextRef.current = context;
+    const review = (0, react_1.useRef)(null);
+    /** The calls last rendered: an action from an earlier render answers for nothing. */
+    const rendered = (0, react_1.useRef)(calls);
+    rendered.current = calls;
+    /** The state shown, with the review that made it: an action answers for that review only. */
+    const [shown, setShown] = (0, react_1.useState)(() => ({ of: null, calls, state: unchecked(calls) }));
+    const fresh = (0, react_1.useMemo)(() => unchecked(calls), [calls]);
+    (0, react_1.useEffect)(() => {
+        const current = (0, feeBuyback_js_1.createFeeBuybackReview)(calls, (chainId, from) => contextRef.current(chainId, from), (state) => setShown({ of: current, calls, state }));
+        review.current = current;
+        setShown({ of: current, calls, state: current.getState() });
+        return () => {
+            current.stop();
+            review.current = null;
+        };
+    }, [calls]);
+    const { of } = shown;
+    // Until these calls' review starts, they show as unchecked, never the earlier calls' result.
+    const state = shown.calls === calls ? shown.state : fresh;
+    /** These calls are the latest and their review has started. */
+    const current = () => rendered.current === calls && shown.calls === calls;
+    /** The review this render showed, while it is still the hook's. */
+    const live = () => (of && of === review.current ? of : null);
+    return {
+        ...state,
+        confirm: async () => {
+            const shownReview = live();
+            if (!current() || !shownReview)
+                return false;
+            const confirmed = await shownReview.confirm(state.result);
+            // Replaced or closed while confirming: the answer is for calls no longer shown.
+            return confirmed && current() && live() === shownReview;
+        },
+        retry: () => live()?.retry(),
+        wait: () => live()?.wait(),
+    };
+}
+//# sourceMappingURL=useFeeBuybackReview.js.map

package/dist/cjs/review/react/useFeeBuybackReview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFeeBuybackReview.js","sourceRoot":"","sources":["../../../../src/review/react/useFeeBuybackReview.ts"],"names":[],"mappings":"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"}

package/dist/cjs/review/react/useMobileWallet.d.ts

@@ -0,0 +1,15 @@
+export type MobileWalletState = "not-mobile" | "checking" | "injected" | "handoff";
+/** A phone or tablet, iPadOS included (it reports itself as a Mac with touch). */
+export declare function isMobileDevice(nav: {
+    userAgent?: string;
+    platform?: string;
+    maxTouchPoints?: number;
+}): boolean;
+/**
+ * On a phone, whether a wallet's provider is in the page (`injected`) or the
+ * page should offer to reopen in a wallet app (`handoff`). MetaMask Mobile
+ * injects late and emits `ethereum#initialized`, so it gets the documented
+ * three-second window (`checking`); EIP-6963 wallets are asked to announce.
+ */
+export declare function useMobileWallet(): MobileWalletState;
+//# sourceMappingURL=useMobileWallet.d.ts.map

package/dist/cjs/review/react/useMobileWallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMobileWallet.d.ts","sourceRoot":"","sources":["../../../../src/review/react/useMobileWallet.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,iBAAiB,GACzB,YAAY,GACZ,UAAU,GACV,UAAU,GACV,SAAS,CAAC;AAEd,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,GAAG,EAAE;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAKV;AAID;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,iBAAiB,CA8BnD"}

package/dist/cjs/review/react/useMobileWallet.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isMobileDevice = isMobileDevice;
+exports.useMobileWallet = useMobileWallet;
+const react_1 = require("react");
+/** A phone or tablet, iPadOS included (it reports itself as a Mac with touch). */
+function isMobileDevice(nav) {
+    return (/Android|iPhone|iPad|iPod/i.test(nav.userAgent || "") ||
+        (nav.platform === "MacIntel" && (nav.maxTouchPoints ?? 0) > 1));
+}
+const MOBILE_PROVIDER_WAIT_MS = 3_000;
+/**
+ * On a phone, whether a wallet's provider is in the page (`injected`) or the
+ * page should offer to reopen in a wallet app (`handoff`). MetaMask Mobile
+ * injects late and emits `ethereum#initialized`, so it gets the documented
+ * three-second window (`checking`); EIP-6963 wallets are asked to announce.
+ */
+function useMobileWallet() {
+    const [state, setState] = (0, react_1.useState)("not-mobile");
+    (0, react_1.useEffect)(() => {
+        if (!isMobileDevice(navigator))
+            return;
+        const page = window;
+        if (page.ethereum) {
+            setState("injected");
+            return;
+        }
+        setState("checking");
+        const stop = () => {
+            window.clearTimeout(timer);
+            window.removeEventListener("ethereum#initialized", ready);
+            window.removeEventListener("eip6963:announceProvider", ready);
+        };
+        const ready = () => {
+            stop();
+            setState("injected");
+        };
+        window.addEventListener("ethereum#initialized", ready);
+        window.addEventListener("eip6963:announceProvider", ready);
+        const timer = window.setTimeout(() => {
+            stop();
+            setState(page.ethereum ? "injected" : "handoff");
+        }, MOBILE_PROVIDER_WAIT_MS);
+        // EIP-6963: a wallet that announced before this listened announces again.
+        window.dispatchEvent(new Event("eip6963:requestProvider"));
+        return stop;
+    }, []);
+    return state;
+}
+//# sourceMappingURL=useMobileWallet.js.map

package/dist/cjs/review/react/useMobileWallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMobileWallet.js","sourceRoot":"","sources":["../../../../src/review/react/useMobileWallet.ts"],"names":[],"mappings":";;AASA,wCASC;AAUD,0CA8BC;AA1DD,iCAA4C;AAQ5C,kFAAkF;AAClF,SAAgB,cAAc,CAAC,GAI9B;IACC,OAAO,CACL,2BAA2B,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC;QACrD,CAAC,GAAG,CAAC,QAAQ,KAAK,UAAU,IAAI,CAAC,GAAG,CAAC,cAAc,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAC/D,CAAC;AACJ,CAAC;AAED,MAAM,uBAAuB,GAAG,KAAK,CAAC;AAEtC;;;;;GAKG;AACH,SAAgB,eAAe;IAC7B,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAA,gBAAQ,EAAoB,YAAY,CAAC,CAAC;IACpE,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC;YAAE,OAAO;QACvC,MAAM,IAAI,GAAG,MAAgD,CAAC;QAC9D,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,QAAQ,CAAC,UAAU,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QACD,QAAQ,CAAC,UAAU,CAAC,CAAC;QACrB,MAAM,IAAI,GAAG,GAAG,EAAE;YAChB,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;YAC3B,MAAM,CAAC,mBAAmB,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC;YAC1D,MAAM,CAAC,mBAAmB,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;QAChE,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,GAAG,EAAE;YACjB,IAAI,EAAE,CAAC;YACP,QAAQ,CAAC,UAAU,CAAC,CAAC;QACvB,CAAC,CAAC;QACF,MAAM,CAAC,gBAAgB,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC;QACvD,MAAM,CAAC,gBAAgB,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;QAC3D,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE;YACnC,IAAI,EAAE,CAAC;YACP,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACnD,CAAC,EAAE,uBAAuB,CAAC,CAAC;QAC5B,0EAA0E;QAC1E,MAAM,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC,CAAC;QAC3D,OAAO,IAAI,CAAC;IACd,CAAC,EAAE,EAAE,CAAC,CAAC;IACP,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/cjs/review/react/useReviewedRun.d.ts

@@ -1,4 +1,4 @@
-import { type HeldWriteView, type ReviewedAction, type ReviewedProgress, type ReviewedResult, type ReviewedSendDeps, type completeReviewedStep, type resumeReviewed, type sendReviewed } from "../index.js";
+import { type HeldWriteView, type ReviewedAction, type ReviewedCall, type ReviewedProgress, type ReviewedResult, type ReviewedRunStatus, type ReviewedSendDeps, type completeReviewedStep, type resumeReviewed, type sendReviewed } from "../index.js";
 import { type HeldViewActions } from "./heldView.js";
 import type { Address, Hex, TransactionReceipt } from "viem";
 /** The send engine: the review model, its decoder and the ABIs it reads. */
@@ -17,6 +17,8 @@ export type UseReviewedRunDeps = ReviewedSendDeps & {
      * again only after a load failed.
      */
     engine: () => Promise<ReviewedEngine>;
+    /** A held step `dismiss` closed later succeeded: refresh its reads. */
+    onDismissedSettled?: (call: ReviewedCall) => void;
 };
 /** A run that failed: `error` is the line to show, `failure` the value thrown. */
 export type ReviewedRunFailed = {
@@ -58,10 +60,27 @@ export type UseReviewedRunResult = {
      * is followed in place (`phase` "receipt"), in the same review, for
      * `follow.timeoutMs` (2 minutes by default); only then does the run resolve
      * `receipt`, and the hook follows the hold until it settles.
+     * `onCancelled` runs once when the run ends `cancelled`: nothing sent and
+     * nothing held; `onStopped` once when it ends `stopped`, with the last step
+     * sent. Both are told once that state rendered.
      */
     run: (action: Omit<ReviewedAction, "account" | "guard"> & {
         account?: Address;
+        onCancelled?: () => void;
+        onStopped?: (step: number) => void;
     }) => Promise<ReviewedResult | ReviewedRunReceipt | ReviewedRunFailed | null>;
+    /**
+     * The highest step of the action whose hash the wallet returned in the
+     * latest run (a resumed sequence's completed or proposed steps count), or
+     * null. It outlasts the run's failure or release; `reset` clears it.
+     */
+    lastSubmittedStep: number | null;
+    /** The run's status, from `reviewedRunStatus`: the one every app shows. */
+    status: ReviewedRunStatus;
+    /** Reviewing, simulating, signing or confirming in place (not `following`). */
+    busy: boolean;
+    /** The run only follows a sent step's hold: the confirm can close. */
+    following: boolean;
     phase: ReviewedProgress["phase"] | "idle";
     step: number;
     total: number;
@@ -96,6 +115,14 @@ export type UseReviewedRunResult = {
      */
     held: HeldWriteView | null;
     reset: () => void;
+    /**
+     * Closes the confirm; false while the review or wallet is open. A held
+     * earlier step ends the run (nothing more reviewed; its hold followed
+     * detached, `onDismissedSettled`). A held last step only ends the wait
+     * (`ended()` null) and stays shown. Otherwise it resets, following any hold
+     * it showed detached. Never evidence a step can be resent.
+     */
+    dismiss: () => boolean;
     /**
      * Loads the send engine now (on hover, focus or pointerdown of the action),
      * so the review opens without a wait. Safe to call any number of times: it

package/dist/cjs/review/react/useReviewedRun.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useReviewedRun.d.ts","sourceRoot":"","sources":["../../../../src/review/react/useReviewedRun.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useReviewedRun.d.ts","sourceRoot":"","sources":["../../../../src/review/react/useReviewedRun.ts"],"names":[],"mappings":"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"}