@bananapus/nana-sdk-core 2.38.2 → 2.40.0

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

@@ -0,0 +1,54 @@
+import { type SavedAttempt, type SavedAttemptOutcome, type SavedAttemptRecovery, type SavedAttemptRetirement, type WriteHoldClient } from "../index.js";
+export type UseSavedAttemptOptions<T> = {
+    /** The app's one saved-attempt recovery (createSavedAttemptRecovery()). */
+    recovery: SavedAttemptRecovery;
+    /** The saved attempt; none while nothing is saved. */
+    attempt: SavedAttempt<T> | null | undefined;
+    /** Reads the attempt's chain. */
+    client: WriteHoldClient | undefined;
+    /** The check action's next step: "I checked it. <next>." ("Review it again" by default). */
+    checkNext?: string;
+};
+/** What a retirement returned: whether it took, and whether it outlives this tab. */
+type Retired = Awaited<ReturnType<SavedAttemptRecovery["retire"]>>;
+export type UseSavedAttemptResult<T> = {
+    /** How recovery ended; null until it has, or with no attempt. */
+    outcome: SavedAttemptOutcome<T> | null;
+    recovering: boolean;
+    /** Recover again now: also "Check again" on a success whose details are unavailable. */
+    recover: () => Promise<SavedAttemptOutcome<T> | null>;
+    /** On `check`: the one explicit action, which retires the attempt for every tab and reload. */
+    checkAction: {
+        line: string;
+        warning: string;
+        label: string;
+        run: () => Promise<Retired>;
+    } | null;
+    /**
+     * Only after the check action came back `reason: "unreadable"` (the browser
+     * has storage it can't read): the warned exit, "I checked my wallet.
+     * Continue anyway", which retires in this tab alone if storage still can't
+     * be read. Never a first option.
+     */
+    unreadableAction: {
+        line: string;
+        label: string;
+        run: () => Promise<Retired>;
+    } | null;
+    /**
+     * Retire after the user's exit or a followed settlement; recovers again.
+     * Bound to the attempt it was rendered for: called after that attempt (or
+     * its recovery or client) changed, it refuses before anything is saved.
+     */
+    retire: (reason: SavedAttemptRetirement) => Promise<Retired>;
+};
+/**
+ * One saved attempt's recovery, the one way every app runs it: recovered
+ * when it (or the client) appears, before the app prepares any new send, with
+ * the check action ready on `check`. Every answer and callback belongs to the
+ * attempt, recovery and client it started with: an earlier one's, or an older
+ * request's, never reaches the current one.
+ */
+export declare function useSavedAttempt<T>(options: UseSavedAttemptOptions<T>): UseSavedAttemptResult<T>;
+export {};
+//# sourceMappingURL=useSavedAttempt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useSavedAttempt.d.ts","sourceRoot":"","sources":["../../../../src/review/react/useSavedAttempt.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAUrB,MAAM,MAAM,sBAAsB,CAAC,CAAC,IAAI;IACtC,2EAA2E;IAC3E,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,sDAAsD;IACtD,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IAC5C,iCAAiC;IACjC,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC;IACpC,4FAA4F;IAC5F,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,qFAAqF;AACrF,KAAK,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AAEnE,MAAM,MAAM,qBAAqB,CAAC,CAAC,IAAI;IACrC,iEAAiE;IACjE,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACvC,UAAU,EAAE,OAAO,CAAC;IACpB,wFAAwF;IACxF,OAAO,EAAE,MAAM,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACtD,+FAA+F;IAC/F,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;KAC7B,GAAG,IAAI,CAAC;IACT;;;;;OAKG;IACH,gBAAgB,EAAE;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;KAC7B,GAAG,IAAI,CAAC;IACT;;;;OAIG;IACH,MAAM,EAAE,CAAC,MAAM,EAAE,sBAAsB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9D,CAAC;AASF;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,OAAO,EAAE,sBAAsB,CAAC,CAAC,CAAC,GACjC,qBAAqB,CAAC,CAAC,CAAC,CAoG1B"}

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

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useSavedAttempt = useSavedAttempt;
+const index_js_1 = require("../index.js");
+const react_1 = require("react");
+const keyOf = (attempt) => attempt
+    ? JSON.stringify({ ...attempt, authenticate: undefined }, (_, value) => typeof value === "bigint" ? value.toString() : value)
+    : null;
+/**
+ * One saved attempt's recovery, the one way every app runs it: recovered
+ * when it (or the client) appears, before the app prepares any new send, with
+ * the check action ready on `check`. Every answer and callback belongs to the
+ * attempt, recovery and client it started with: an earlier one's, or an older
+ * request's, never reaches the current one.
+ */
+function useSavedAttempt(options) {
+    const { recovery, client, checkNext } = options;
+    const key = keyOf(options.attempt);
+    const attempt = options.attempt;
+    /** The attempt as last rendered: the same saved fields, with the app's newest callbacks. */
+    const latest = (0, react_1.useRef)(attempt);
+    latest.current = attempt;
+    /** One lifecycle per attempt, recovery and client, with its latest request. */
+    const lifecycle = (0, react_1.useMemo)(() => ({ attempt, recovery, client, request: 0 }), 
+    // The key stands for the attempt.
+    [key, recovery, client]);
+    /** Whether `of` is the mounted hook's lifecycle now. */
+    const current = (of) => mounted.current && rendered.current === of;
+    /**
+     * The lifecycle last rendered: set during render, so a callback of an
+     * earlier one is refused from the next commit's first layout effect on. A
+     * render React then discards leaves the shown callbacks refused (fail
+     * closed) until the next commit.
+     */
+    const rendered = (0, react_1.useRef)(undefined);
+    rendered.current = lifecycle;
+    /** Whether the hook is mounted: no callback or answer acts after unmount. */
+    const mounted = (0, react_1.useRef)(false);
+    (0, react_1.useLayoutEffect)(() => {
+        mounted.current = true;
+        return () => {
+            mounted.current = false;
+        };
+    }, []);
+    const [shown, setShown] = (0, react_1.useState)({ outcome: null, recovering: false });
+    /** The lifecycle whose check action last found storage unreadable. */
+    const [unreadable, setUnreadable] = (0, react_1.useState)();
+    const recover = (0, react_1.useCallback)(async () => {
+        const { recovery, client } = lifecycle;
+        const attempt = latest.current;
+        if (!attempt || !client || !current(lifecycle))
+            return null;
+        const request = ++lifecycle.request;
+        setShown((now) => ({
+            of: lifecycle,
+            outcome: now.of === lifecycle ? now.outcome : null,
+            recovering: true,
+        }));
+        const outcome = await recovery.recover(attempt, client);
+        // Only the latest request of the mounted lifecycle shows.
+        if (!current(lifecycle) || lifecycle.request !== request)
+            return null;
+        setShown({ of: lifecycle, outcome, recovering: false });
+        return outcome;
+    }, [lifecycle]);
+    (0, react_1.useEffect)(() => {
+        void recover();
+    }, [recover]);
+    const retire = (0, react_1.useCallback)(async (reason) => {
+        const { recovery } = lifecycle;
+        const attempt = latest.current;
+        if (!attempt || !current(lifecycle))
+            return { retired: false };
+        const retired = await recovery.retire(attempt, reason);
+        if (!current(lifecycle))
+            return retired;
+        if (!retired.retired && retired.reason === "unreadable")
+            setUnreadable(lifecycle);
+        await recover();
+        return retired;
+    }, [lifecycle, recover]);
+    const outcome = shown.of === lifecycle ? shown.outcome : null;
+    return {
+        outcome,
+        recovering: shown.of === lifecycle && shown.recovering,
+        recover,
+        checkAction: outcome?.status === "check"
+            ? {
+                line: outcome.line,
+                warning: outcome.warning,
+                label: (0, index_js_1.checkedItLabel)(checkNext),
+                run: () => retire({ by: "check", outcome }),
+            }
+            : null,
+        unreadableAction: outcome?.status === "check" && unreadable === lifecycle
+            ? {
+                line: index_js_1.SAVED_ATTEMPT_UNREADABLE_LINE,
+                label: index_js_1.SAVED_ATTEMPT_CONTINUE_ANYWAY_LABEL,
+                run: () => retire({ by: "check", outcome, force: "unreadable" }),
+            }
+            : null,
+        retire,
+    };
+}
+//# sourceMappingURL=useSavedAttempt.js.map

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

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

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

@@ -0,0 +1,180 @@
+import type { Address, Hex } from "viem";
+import type { WriteHeldState, WriteHold, WriteHoldClient, WriteHoldHandle } from "./writeHold.js";
+import { type HeldWriteStorage, type ReviewedWriteRecoveryInput } from "./writeRecovery.js";
+/** What the app's domain check says of one transaction (or, given none, of a search for the attempt). */
+export type SavedAttemptProof<T> = 
+/** The chain shows this attempt ran, with the app's result (a project ID, a launch). */
+{
+    result: "proven";
+    value: T;
+}
+/** The transaction is some other write. */
+ | {
+    result: "not-this";
+    reason?: string;
+}
+/** It couldn't be read or shown. */
+ | {
+    result: "unknown";
+    reason?: string;
+};
+/** Where a saved attempt was held, and what the app saved of it. Only what was saved: nothing fresh. */
+export type SavedAttemptScope = {
+    chainId: number;
+    /** The account that sent it: the wallet, or the Safe. */
+    account: Address;
+    /** Whether `account` is a Safe; a saved `safeTxHash` says so too. */
+    safe?: boolean;
+    /** Every intent namespace the attempt may be held under, the current one first, legacy ones after. */
+    namespaces: readonly string[];
+    /** The exact saved call, when kept: a saved hash is adopted into the hold against it. */
+    call?: ReviewedWriteRecoveryInput["call"];
+    /**
+     * The app's re-read of its own domain journal, required: awaited under
+     * the hold's locks before any check or exit retirement, it is the final say
+     * of Rule E (only a followed settlement retires a success). Return false,
+     * or throw, while the journal records the attempt's success or can't be
+     * read.
+     */
+    confirmRetirable(): Promise<boolean>;
+    saved?: {
+        /**
+         * The app's send began: the wallet may have opened. Only an explicit
+         * `false`, with no hash or nonce evidence, is proof that nothing was sent.
+         */
+        started?: boolean;
+        /** The transaction hash the wallet returned. */
+        hash?: Hex;
+        /** The Safe proposal the wallet returned. */
+        safeTxHash?: Hex;
+        /** That proposal's Safe nonce, when saved. */
+        safeNonce?: number;
+        /** The account's next nonce before the wallet opened, with the block it was read at. */
+        nonce?: number | bigint;
+        sentNonce?: number | bigint;
+        fromBlock?: bigint;
+        /** When the wallet returned the hash, in milliseconds since the epoch. */
+        submittedAt?: number;
+        /** Settlements already shown before this attempt began: never this attempt's. */
+        before?: readonly Hex[];
+    };
+};
+/** A saved attempt with the app's domain check of a transaction (or, given none, its search for the attempt). */
+export type SavedAttempt<T> = SavedAttemptScope & {
+    authenticate(hash: Hex | undefined): Promise<SavedAttemptProof<T>>;
+};
+/**
+ * What a retirement returned. `durable: false`: it lasts in this tab alone
+ * (show `SAVED_ATTEMPT_TAB_ONLY_LINE`); another tab or a reload asks
+ * again, never sends. `reason: "unreadable"`: the browser has storage but
+ * can't read it, so the warned exit may be offered.
+ */
+export type SavedAttemptRetired = {
+    retired: false;
+    reason?: "unreadable";
+} | {
+    retired: true;
+    durable: boolean;
+};
+/** Why an attempt is retired: the only three things that retire one. */
+export type SavedAttemptRetirement = 
+/** The user's exit released the hold. */
+{
+    by: "exit";
+}
+/**
+ * The user's "I checked it. ..." on exactly this check outcome. With
+ * `force: "unreadable"` (the warned "I checked my wallet. Continue anyway",
+ * offered only after a retirement came back `reason: "unreadable"`), it
+ * retires in this tab alone if the hold's storage still can't be read.
+ */
+ | {
+    by: "check";
+    outcome: SavedAttemptCheck;
+    force?: "unreadable";
+}
+/** The app followed and recorded this settlement. */
+ | {
+    by: "settled";
+    hash?: Hex;
+};
+export type SavedAttemptCheck = {
+    status: "check";
+    /** What couldn't be shown, for logs and details. */
+    reason: string;
+    line: string;
+    warning: string;
+    /** The hold evidence this check evaluated: the user's check retires exactly this. */
+    evidence: string;
+};
+/**
+ * How recovering a saved attempt ended, the one rule every app follows
+ * before any send or discard:
+ * - `held`: the hold still holds the write. Count nothing; show `state`, and
+ *   its exit when due (through `handle`);
+ * - `done`: `success` ran. `authenticated: true` when the app's check showed
+ *   it as this attempt (`value`); `false` when the hold settled it but the
+ *   app's details are unavailable (`reason`): record its `hash` and follow it,
+ *   with "Check again" (recover again) as its only action. Either way, never
+ *   send it again; only `retire({ by: "settled" })` retires it. `failed` is
+ *   the hold's proven revert of it;
+ * - `check`: it can't be shown. One explicit action, "I checked it. ...",
+ *   and only that, retires it (`retire({ by: "check", outcome })`);
+ * - `none`: the hold proves nothing was reserved and nothing saved says it
+ *   was sent, or the attempt was retired (`retired`): by the user or a
+ *   followed settlement, or by the SDK itself when it dropped every
+ *   reservation of it on a definite wallet rejection or an abort before the
+ *   wallet opened (`"rejected"`: nothing can have been sent).
+ */
+export type SavedAttemptOutcome<T> = {
+    status: "held";
+    state: WriteHeldState;
+    handle: WriteHoldHandle;
+} | {
+    status: "done";
+    result: "success";
+    authenticated: true;
+    hash?: Hex;
+    value: T;
+} | {
+    status: "done";
+    result: "success";
+    authenticated: false;
+    /** The settled transaction; absent when another tab's check proved it without one. */
+    hash?: Hex;
+    reason: string;
+} | {
+    status: "done";
+    result: "failed";
+    hash: Hex;
+} | SavedAttemptCheck | {
+    status: "none";
+    retired?: SavedAttemptRetirement["by"] | "rejected";
+};
+/**
+ * Saved-attempt recovery over the app's write hold, framework-free: every
+ * app's launches, linked plans, shop updates and other saved writes recover
+ * the same way. Pass the hold's own `storage` and `locks` when it was made
+ * with custom ones; the defaults are the hold's defaults.
+ *
+ * - Recovery needs only what was saved: run it right after a saved attempt is
+ *   found, before any fresh-send preparation.
+ * - Absence of evidence is `check`, never `none`: a missing hold record, a
+ *   refused or unreadable adoption, an empty search and every exception.
+ * - A settled success always wins: it is never downgraded by a later failed
+ *   or empty read, and it blocks discard until followed.
+ * - Only the user's exit, the user's check action, a followed settlement and
+ *   the SDK's own drop of a rejected reservation retire an attempt, persisted under the hold's locks for every tab and
+ *   reload, and only for the hold evidence they saw.
+ */
+export declare function createSavedAttemptRecovery(options: {
+    hold: WriteHold;
+    storage?: HeldWriteStorage;
+    locks?: Pick<LockManager, "request">;
+}): {
+    recover: <T>(attempt: SavedAttempt<T>, client: WriteHoldClient) => Promise<SavedAttemptOutcome<T>>;
+    retire: (attempt: SavedAttemptScope, reason: SavedAttemptRetirement) => Promise<SavedAttemptRetired>;
+    canDiscard: (attempt: SavedAttemptScope) => boolean;
+};
+export type SavedAttemptRecovery = ReturnType<typeof createSavedAttemptRecovery>;
+//# sourceMappingURL=savedAttempt.d.ts.map

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

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