@valve-tech/tx-flight-react 0.0.1

package/dist/components/status-icon.js

@@ -0,0 +1,28 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+const STATUS_LABEL = {
+    preparing: 'Preparing',
+    'awaiting-signature': 'Awaiting signature',
+    pending: 'Pending',
+    confirmed: 'Confirmed',
+    failed: 'Failed',
+    replaced: 'Replaced',
+    dropped: 'Dropped',
+};
+const STATUS_COLOR = {
+    preparing: '#9ca3af',
+    'awaiting-signature': '#3b82f6',
+    pending: '#f59e0b',
+    confirmed: '#10b981',
+    failed: '#ef4444',
+    replaced: '#a855f7',
+    dropped: '#6b7280',
+};
+export const TxFlightStatusIcon = ({ status, size = 16, className, style, }) => (_jsx("span", { role: "img", "aria-label": STATUS_LABEL[status], "data-status": status, className: className, style: {
+        display: 'inline-block',
+        width: size,
+        height: size,
+        borderRadius: '50%',
+        backgroundColor: STATUS_COLOR[status],
+        ...style,
+    } }));
+//# sourceMappingURL=status-icon.js.map

package/dist/components/status-icon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-icon.js","sourceRoot":"","sources":["../../src/components/status-icon.tsx"],"names":[],"mappings":";AAcA,MAAM,YAAY,GAAoC;IACpD,SAAS,EAAE,WAAW;IACtB,oBAAoB,EAAE,oBAAoB;IAC1C,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;CACnB,CAAA;AAED,MAAM,YAAY,GAAoC;IACpD,SAAS,EAAE,SAAS;IACpB,oBAAoB,EAAE,SAAS;IAC/B,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,SAAS;IACpB,MAAM,EAAE,SAAS;IACjB,QAAQ,EAAE,SAAS;IACnB,OAAO,EAAE,SAAS;CACnB,CAAA;AAUD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,EACjC,MAAM,EACN,IAAI,GAAG,EAAE,EACT,SAAS,EACT,KAAK,GACmB,EAAa,EAAE,CAAC,CACxC,eACE,IAAI,EAAC,KAAK,gBACE,YAAY,CAAC,MAAM,CAAC,iBACnB,MAAM,EACnB,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE;QACL,OAAO,EAAE,cAAc;QACvB,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,IAAI;QACZ,YAAY,EAAE,KAAK;QACnB,eAAe,EAAE,YAAY,CAAC,MAAM,CAAC;QACrC,GAAG,KAAK;KACT,GACD,CACH,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @fileoverview Public API of `@valve-tech/tx-flight-react`.
+ *
+ * Public surface lands progressively across tasks 2-12 of
+ * `docs/superpowers/plans/2026-05-07-tx-flight-react.md`. This file
+ * is the single entrypoint; storage adapters live at the
+ * `./storage` sub-export.
+ */
+export type { AddWithWalletAdapterInput, AddByHashInput, AddManualInput, TxFlightStorage, TrackedTx, TxFlow, } from './types.js';
+export { TxFlightProvider, type TxFlightProviderProps, } from './provider.js';
+export { useTxFlight, type UseTxFlightReturn } from './use-tx-flight.js';
+export { TxFlightStatusIcon, type TxFlightStatusIconProps, } from './components/status-icon.js';
+export { TxFlightHashLink, type TxFlightHashLinkProps, type HashTruncate, } from './components/hash-link.js';
+export { TxFlightAge, type TxFlightAgeProps } from './components/age.js';
+export { TxFlightActions, type TxFlightActionsProps, type TxFlightActionsShow, } from './components/actions.js';
+export { TxFlightItem, type TxFlightItemProps, type TxFlightItemRenderParts, } from './components/item.js';
+export { TxFlightList, type TxFlightListProps } from './components/list.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,YAAY,EACV,yBAAyB,EACzB,cAAc,EACd,cAAc,EACd,eAAe,EACf,SAAS,EACT,MAAM,GACP,MAAM,YAAY,CAAA;AAInB,OAAO,EACL,gBAAgB,EAChB,KAAK,qBAAqB,GAC3B,MAAM,eAAe,CAAA;AAEtB,OAAO,EAAE,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAIxE,OAAO,EACL,kBAAkB,EAClB,KAAK,uBAAuB,GAC7B,MAAM,6BAA6B,CAAA;AACpC,OAAO,EACL,gBAAgB,EAChB,KAAK,qBAAqB,EAC1B,KAAK,YAAY,GAClB,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACxE,OAAO,EACL,eAAe,EACf,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,yBAAyB,CAAA;AAChC,OAAO,EACL,YAAY,EACZ,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,GAC7B,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/index.js

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview Public API of `@valve-tech/tx-flight-react`.
+ *
+ * Public surface lands progressively across tasks 2-12 of
+ * `docs/superpowers/plans/2026-05-07-tx-flight-react.md`. This file
+ * is the single entrypoint; storage adapters live at the
+ * `./storage` sub-export.
+ */
+// ─── Provider + hook ───────────────────────────────────────────────────────
+export { TxFlightProvider, } from './provider.js';
+export { useTxFlight } from './use-tx-flight.js';
+// ─── Components ────────────────────────────────────────────────────────────
+export { TxFlightStatusIcon, } from './components/status-icon.js';
+export { TxFlightHashLink, } from './components/hash-link.js';
+export { TxFlightAge } from './components/age.js';
+export { TxFlightActions, } from './components/actions.js';
+export { TxFlightItem, } from './components/item.js';
+export { TxFlightList } from './components/list.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAaH,8EAA8E;AAE9E,OAAO,EACL,gBAAgB,GAEjB,MAAM,eAAe,CAAA;AAEtB,OAAO,EAAE,WAAW,EAA0B,MAAM,oBAAoB,CAAA;AAExE,8EAA8E;AAE9E,OAAO,EACL,kBAAkB,GAEnB,MAAM,6BAA6B,CAAA;AACpC,OAAO,EACL,gBAAgB,GAGjB,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAAE,WAAW,EAAyB,MAAM,qBAAqB,CAAA;AACxE,OAAO,EACL,eAAe,GAGhB,MAAM,yBAAyB,CAAA;AAChC,OAAO,EACL,YAAY,GAGb,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,YAAY,EAA0B,MAAM,sBAAsB,CAAA"}

package/dist/integrations/tx-tracker.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @fileoverview tx-tracker integration for `addByHash`.
+ *
+ * Dynamic-imports `@valve-tech/tx-tracker` and `@valve-tech/chain-source`
+ * inside the call so wallet-adapter-only consumers don't pay the
+ * bundle cost. This is what makes `addByHash` async (the only async
+ * method on the hook).
+ *
+ * Internally builds a private `ChainSource` + `TxTracker` pair (same
+ * pattern as `watchTransaction` in tx-tracker), subscribes to the
+ * hash, and routes every relevant event into a `store.dispatch.update`
+ * patch. The watcher-unsub is registered with the tx so `remove(id)`
+ * (and Provider unmount via `dispatch.clear`) cleans up the
+ * subscription.
+ *
+ * Tests inject a stub `ChainSource` via `_sourceOverride`; this
+ * mirrors the seam used by `watchTransaction` and keeps test runs
+ * hermetic (no real RPC, no live timers).
+ */
+import type { ChainSource } from '@valve-tech/chain-source';
+import type { TrackedTx } from '@valve-tech/wallet-adapter';
+import type { PublicClient } from 'viem';
+import type { AddByHashInput } from '../types.js';
+import type { TxFlightStore } from '../store/store.js';
+/**
+ * Internal options — not part of the public API.
+ *
+ * `_sourceOverride` is a test-only seam (mirrors the pattern in
+ * `watchTransaction`'s `WatchTransactionInternalOptions`). Production
+ * callers never use it.
+ *
+ * @internal
+ */
+export interface AddByHashInternalOptions {
+    _sourceOverride?: ChainSource;
+}
+export declare const addByHashImpl: (store: TxFlightStore, input: AddByHashInput, onError?: (method: string, err: unknown) => void, internal?: AddByHashInternalOptions) => Promise<string>;
+/**
+ * Resume watching an already-persisted TrackedTx. Used by Provider on
+ * rehydrate to re-attach a tx-tracker subscription to a `pending` tx
+ * we loaded from storage. Overwrites the existing entry with itself
+ * plus the new watcher.
+ *
+ * No-op if `tx.hash` is missing — those entries were caught earlier
+ * in the rehydrate path and translated to `failed`.
+ */
+export declare const resumeByHashWatcher: (store: TxFlightStore, tx: TrackedTx, client: PublicClient, onError?: (method: string, err: unknown) => void, internal?: AddByHashInternalOptions) => Promise<void>;
+//# sourceMappingURL=tx-tracker.d.ts.map

package/dist/integrations/tx-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tx-tracker.d.ts","sourceRoot":"","sources":["../../src/integrations/tx-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAE3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,KAAK,EAAO,YAAY,EAAE,MAAM,MAAM,CAAA;AAE7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAmDtD;;;;;;;;GAQG;AACH,MAAM,WAAW,wBAAwB;IACvC,eAAe,CAAC,EAAE,WAAW,CAAA;CAC9B;AA6DD,eAAO,MAAM,aAAa,UACjB,aAAa,SACb,cAAc,YACX,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,aACrC,wBAAwB,KAClC,OAAO,CAAC,MAAM,CA2BhB,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,UACvB,aAAa,MAChB,SAAS,UACL,YAAY,YACV,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,aACrC,wBAAwB,KAClC,OAAO,CAAC,IAAI,CA8Bd,CAAA"}

package/dist/integrations/tx-tracker.js

@@ -0,0 +1,169 @@
+/**
+ * @fileoverview tx-tracker integration for `addByHash`.
+ *
+ * Dynamic-imports `@valve-tech/tx-tracker` and `@valve-tech/chain-source`
+ * inside the call so wallet-adapter-only consumers don't pay the
+ * bundle cost. This is what makes `addByHash` async (the only async
+ * method on the hook).
+ *
+ * Internally builds a private `ChainSource` + `TxTracker` pair (same
+ * pattern as `watchTransaction` in tx-tracker), subscribes to the
+ * hash, and routes every relevant event into a `store.dispatch.update`
+ * patch. The watcher-unsub is registered with the tx so `remove(id)`
+ * (and Provider unmount via `dispatch.clear`) cleans up the
+ * subscription.
+ *
+ * Tests inject a stub `ChainSource` via `_sourceOverride`; this
+ * mirrors the seam used by `watchTransaction` and keeps test runs
+ * hermetic (no real RPC, no live timers).
+ */
+const DEFAULT_CONFIRMATIONS = 1;
+const DEFAULT_STALE_AFTER_BLOCKS = 12;
+const DEFAULT_FLOW = 'unknown';
+let txIdCounter = 0;
+const generateTxId = () => `txflight-${Date.now()}-${++txIdCounter}`;
+/**
+ * Translate a tx-tracker event into a TrackedTx patch (or `null` to
+ * skip). The translation is conservative: events that don't change
+ * lifecycle state (`started`, `stopped`, signal-*, `left-mempool`)
+ * return null.
+ *
+ * Confirmations gate: a `seen-in-block` event only flips to
+ * `confirmed` when `event.confirmations >= input.confirmations`. With
+ * receipts, a reverted receipt flips to `failed` instead.
+ *
+ * `staleAfterBlocks` is enforced by the tracker via the
+ * `unseenThresholdBlocks` option; this function trusts the threshold
+ * and turns every `unseen-for-N-blocks` it receives into `dropped`.
+ */
+const patchFromTxEvent = (event, confirmations) => {
+    switch (event.kind) {
+        case 'seen-in-mempool':
+            return { status: 'pending' };
+        case 'seen-in-block': {
+            if (event.confirmations < confirmations)
+                return null;
+            if (event.receipt && event.receipt.status === 'reverted') {
+                return { status: 'failed', notes: 'Transaction reverted', hash: event.hash };
+            }
+            return { status: 'confirmed', hash: event.hash };
+        }
+        case 'vanished-from-block':
+            return { status: 'pending' };
+        case 'replaced-by':
+            return {
+                status: 'replaced',
+                replacedBy: event.replacementHash,
+            };
+        case 'unseen-for-N-blocks':
+            return { status: 'dropped' };
+        default:
+            return null;
+    }
+};
+/** Build the private ChainSource + TxTracker pair and return a single unsub. */
+const subscribeWatcher = async (opts) => {
+    // Dynamic import — keeps the bundle cost off the wallet-adapter-only
+    // consumer path. Resolves the workspace packages on demand.
+    const [{ createChainSource }, { createTxTracker }] = await Promise.all([
+        import('@valve-tech/chain-source'),
+        import('@valve-tech/tx-tracker'),
+    ]);
+    const ownsSource = opts.sourceOverride === undefined;
+    const source = opts.sourceOverride ?? createChainSource({
+        client: opts.client,
+        onError: opts.onError,
+    });
+    const tracker = createTxTracker({
+        source,
+        chainId: opts.chainId,
+        onError: opts.onError,
+    });
+    source.start();
+    tracker.start();
+    const trackerUnsub = tracker.subscribe(opts.hash, (event) => {
+        const patch = patchFromTxEvent(event, opts.confirmations);
+        if (patch !== null)
+            opts.store.dispatch.update(opts.txId, patch);
+    }, {
+        emitInitial: false,
+        withReceipts: opts.withReceipts,
+        unseenThresholdBlocks: opts.staleAfterBlocks,
+    });
+    return () => {
+        trackerUnsub();
+        tracker.stop();
+        // Don't stop a source we don't own — the test seam owns it.
+        if (ownsSource)
+            source.stop();
+    };
+};
+export const addByHashImpl = async (store, input, onError, internal) => {
+    const id = generateTxId();
+    const unsub = await subscribeWatcher({
+        store,
+        txId: id,
+        hash: input.hash,
+        chainId: input.chainId,
+        client: input.client,
+        confirmations: input.confirmations ?? DEFAULT_CONFIRMATIONS,
+        staleAfterBlocks: input.staleAfterBlocks ?? DEFAULT_STALE_AFTER_BLOCKS,
+        withReceipts: input.withReceipts,
+        onError,
+        sourceOverride: internal?._sourceOverride,
+    });
+    const initialTx = {
+        id,
+        hash: input.hash,
+        chainId: input.chainId,
+        flow: input.flow ?? DEFAULT_FLOW,
+        submittedAt: Date.now(),
+        submittedTier: 'standard',
+        status: 'pending',
+    };
+    store.dispatch.addWithTx(initialTx, unsub);
+    return id;
+};
+/**
+ * Resume watching an already-persisted TrackedTx. Used by Provider on
+ * rehydrate to re-attach a tx-tracker subscription to a `pending` tx
+ * we loaded from storage. Overwrites the existing entry with itself
+ * plus the new watcher.
+ *
+ * No-op if `tx.hash` is missing — those entries were caught earlier
+ * in the rehydrate path and translated to `failed`.
+ */
+export const resumeByHashWatcher = async (store, tx, client, onError, internal) => {
+    if (tx.hash === undefined)
+        return;
+    let unsub;
+    try {
+        unsub = await subscribeWatcher({
+            store,
+            txId: tx.id,
+            hash: tx.hash,
+            chainId: tx.chainId,
+            client,
+            confirmations: DEFAULT_CONFIRMATIONS,
+            staleAfterBlocks: DEFAULT_STALE_AFTER_BLOCKS,
+            withReceipts: undefined,
+            onError,
+            sourceOverride: internal?._sourceOverride,
+        });
+    }
+    catch (err) {
+        onError?.('rehydrate-watcher', err);
+        return;
+    }
+    // The current state still holds the entry — overwrite with the same
+    // tx + the new watcher unsub.
+    const current = store.getState().txs.get(tx.id);
+    if (!current) {
+        // Tx was removed (e.g., user dispatched remove) before our async
+        // subscribe completed. Tear down rather than reattach.
+        unsub();
+        return;
+    }
+    store.dispatch.addWithTx(current, unsub);
+};
+//# sourceMappingURL=tx-tracker.js.map

package/dist/integrations/tx-tracker.js.map

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

package/dist/integrations/wallet-adapter.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @fileoverview wallet-adapter integration for `addWithWalletAdapter`.
+ *
+ * Two pieces:
+ *
+ *  - `wrapHooks(userHooks, store, txId, onError?)`: returns a new
+ *    `WriteHookParams` bag where every named callback fans out to
+ *    BOTH the consumer's original callback AND a `store.dispatch.update`
+ *    that reflects the new lifecycle state on the strip's TrackedTx.
+ *    Errors thrown by user callbacks are routed to `onError` and
+ *    swallowed so a buggy user callback can't break the store update.
+ *
+ *  - `addWithWalletAdapterImpl(store, input, onError?)`: builds the
+ *    initial `preparing`-status TrackedTx, inserts it via
+ *    `store.dispatch.addWithTx`, and returns `{ id, hooks }` so the
+ *    consumer can pipe the wrapped hooks straight into
+ *    `sendTransactionWithHooks`.
+ *
+ * No runtime `import` from `@valve-tech/wallet-adapter` — only `import
+ * type`. wallet-adapter is an optional peer dep; consumers who never
+ * use `addWithWalletAdapter` shouldn't pay the dependency cost. The
+ * status values (`'preparing'`, `'pending'`, etc.) live as string
+ * literals here, typed against `TrackedTxStatus`.
+ */
+import type { WriteHookParams } from '@valve-tech/wallet-adapter';
+import type { AddWithWalletAdapterInput } from '../types.js';
+import type { TxFlightStore } from '../store/store.js';
+export declare const wrapHooks: (userHooks: WriteHookParams, store: TxFlightStore, txId: string, onError?: (method: string, err: unknown) => void) => WriteHookParams;
+export interface AddWithWalletAdapterResult {
+    id: string;
+    hooks: WriteHookParams;
+}
+export declare const addWithWalletAdapterImpl: (store: TxFlightStore, input: AddWithWalletAdapterInput, onError?: (method: string, err: unknown) => void) => AddWithWalletAdapterResult;
+//# sourceMappingURL=wallet-adapter.d.ts.map

package/dist/integrations/wallet-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-adapter.d.ts","sourceRoot":"","sources":["../../src/integrations/wallet-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAEV,eAAe,EAChB,MAAM,4BAA4B,CAAA;AAEnC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAA;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAkBtD,eAAO,MAAM,SAAS,cACT,eAAe,SACnB,aAAa,QACd,MAAM,YACF,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,KAC/C,eA0CD,CAAA;AAEF,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,eAAe,CAAA;CACvB;AAED,eAAO,MAAM,wBAAwB,UAC5B,aAAa,SACb,yBAAyB,YACtB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,KAC/C,0BAeF,CAAA"}

package/dist/integrations/wallet-adapter.js

@@ -0,0 +1,97 @@
+/**
+ * @fileoverview wallet-adapter integration for `addWithWalletAdapter`.
+ *
+ * Two pieces:
+ *
+ *  - `wrapHooks(userHooks, store, txId, onError?)`: returns a new
+ *    `WriteHookParams` bag where every named callback fans out to
+ *    BOTH the consumer's original callback AND a `store.dispatch.update`
+ *    that reflects the new lifecycle state on the strip's TrackedTx.
+ *    Errors thrown by user callbacks are routed to `onError` and
+ *    swallowed so a buggy user callback can't break the store update.
+ *
+ *  - `addWithWalletAdapterImpl(store, input, onError?)`: builds the
+ *    initial `preparing`-status TrackedTx, inserts it via
+ *    `store.dispatch.addWithTx`, and returns `{ id, hooks }` so the
+ *    consumer can pipe the wrapped hooks straight into
+ *    `sendTransactionWithHooks`.
+ *
+ * No runtime `import` from `@valve-tech/wallet-adapter` — only `import
+ * type`. wallet-adapter is an optional peer dep; consumers who never
+ * use `addWithWalletAdapter` shouldn't pay the dependency cost. The
+ * status values (`'preparing'`, `'pending'`, etc.) live as string
+ * literals here, typed against `TrackedTxStatus`.
+ */
+let txIdCounter = 0;
+const generateTxId = () => `txflight-${Date.now()}-${++txIdCounter}`;
+const safeFire = (fn, arg, onError) => {
+    if (!fn)
+        return;
+    try {
+        fn(arg);
+    }
+    catch (err) {
+        onError?.('user-hook', err);
+    }
+};
+export const wrapHooks = (userHooks, store, txId, onError) => ({
+    onAwaitingSignature: (info) => {
+        safeFire(userHooks.onAwaitingSignature, info, onError);
+        store.dispatch.update(txId, { status: 'awaiting-signature' });
+    },
+    onTransactionHash: (info) => {
+        safeFire(userHooks.onTransactionHash, info, onError);
+        store.dispatch.update(txId, { status: 'pending', hash: info.hash });
+    },
+    onConfirmed: (info) => {
+        safeFire(userHooks.onConfirmed, info, onError);
+        store.dispatch.update(txId, { status: 'confirmed', hash: info.hash });
+    },
+    onFailed: (info) => {
+        safeFire(userHooks.onFailed, info, onError);
+        const patch = {
+            status: 'failed',
+            notes: info.error.message,
+        };
+        if (info.hash !== undefined)
+            patch.hash = info.hash;
+        store.dispatch.update(txId, patch);
+    },
+    onDropped: (info) => {
+        safeFire(userHooks.onDropped, info, onError);
+        store.dispatch.update(txId, { status: 'dropped', hash: info.hash });
+    },
+    onReplaced: (info) => {
+        safeFire(userHooks.onReplaced, info, onError);
+        store.dispatch.update(txId, {
+            status: 'replaced',
+            replacedBy: info.replacement,
+            hash: info.original,
+        });
+    },
+    // `onPhase` only fans out to the consumer's onPhase; the named-hook
+    // path above is what writes to the store. wallet-adapter fires both
+    // shapes for every transition, so we don't lose any updates by
+    // attaching the dispatch to one side only — and we avoid double-
+    // writes when the same transition fires both shapes.
+    onPhase: (event) => {
+        safeFire(userHooks.onPhase, event, onError);
+    },
+});
+export const addWithWalletAdapterImpl = (store, input, onError) => {
+    const id = generateTxId();
+    const initialTx = {
+        id,
+        chainId: input.chainId,
+        flow: input.flow,
+        submittedAt: Date.now(),
+        // Default tier; addManual is the path for consumers who need a
+        // specific gas-oracle tier echoed onto the record.
+        submittedTier: 'standard',
+        status: 'preparing',
+    };
+    store.dispatch.addWithTx(initialTx, null);
+    const hooks = wrapHooks(input.hooks, store, id, onError);
+    return { id, hooks };
+};
+//# sourceMappingURL=wallet-adapter.js.map

package/dist/integrations/wallet-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-adapter.js","sourceRoot":"","sources":["../../src/integrations/wallet-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAUH,IAAI,WAAW,GAAG,CAAC,CAAA;AACnB,MAAM,YAAY,GAAG,GAAW,EAAE,CAAC,YAAY,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,CAAA;AAE5E,MAAM,QAAQ,GAAG,CACf,EAAkC,EAClC,GAAM,EACN,OAA6D,EACvD,EAAE;IACR,IAAI,CAAC,EAAE;QAAE,OAAM;IACf,IAAI,CAAC;QACH,EAAE,CAAC,GAAG,CAAC,CAAA;IACT,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,CAAC,WAAW,EAAE,GAAG,CAAC,CAAA;IAC7B,CAAC;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,SAA0B,EAC1B,KAAoB,EACpB,IAAY,EACZ,OAAgD,EAC/B,EAAE,CAAC,CAAC;IACrB,mBAAmB,EAAE,CAAC,IAAI,EAAE,EAAE;QAC5B,QAAQ,CAAC,SAAS,CAAC,mBAAmB,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;QACtD,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC,CAAA;IAC/D,CAAC;IACD,iBAAiB,EAAE,CAAC,IAAI,EAAE,EAAE;QAC1B,QAAQ,CAAC,SAAS,CAAC,iBAAiB,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;QACpD,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;IACrE,CAAC;IACD,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE;QACpB,QAAQ,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;QAC9C,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;IACvE,CAAC;IACD,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE;QACjB,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;QAC3C,MAAM,KAAK,GAAuB;YAChC,MAAM,EAAE,QAAQ;YAChB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO;SAC1B,CAAA;QACD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAA;QACnD,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IACpC,CAAC;IACD,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE;QAClB,QAAQ,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;QAC5C,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;IACrE,CAAC;IACD,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE;QACnB,QAAQ,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;QAC7C,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE;YAC1B,MAAM,EAAE,UAAU;YAClB,UAAU,EAAE,IAAI,CAAC,WAAW;YAC5B,IAAI,EAAE,IAAI,CAAC,QAAQ;SACpB,CAAC,CAAA;IACJ,CAAC;IACD,oEAAoE;IACpE,oEAAoE;IACpE,+DAA+D;IAC/D,iEAAiE;IACjE,qDAAqD;IACrD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;QACjB,QAAQ,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;IAC7C,CAAC;CACF,CAAC,CAAA;AAOF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CACtC,KAAoB,EACpB,KAAgC,EAChC,OAAgD,EACpB,EAAE;IAC9B,MAAM,EAAE,GAAG,YAAY,EAAE,CAAA;IACzB,MAAM,SAAS,GAAc;QAC3B,EAAE;QACF,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;QACvB,+DAA+D;QAC/D,mDAAmD;QACnD,aAAa,EAAE,UAAU;QACzB,MAAM,EAAE,WAAW;KACpB,CAAA;IACD,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;IACzC,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,CAAC,CAAA;IACxD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAA;AACtB,CAAC,CAAA"}

package/dist/provider.d.ts

@@ -0,0 +1,67 @@
+/**
+ * @fileoverview <TxFlightProvider> — wraps the React tree with a
+ * tx-flight store, scoped by `id`.
+ *
+ * Lifecycle:
+ *  - First render: lazy `useState` acquires (or reuses) a store
+ *    registered under `id` in a module-level registry. Two Providers
+ *    with the same `id` silently share the same store via refCount.
+ *  - First commit: `useEffect` starts the side-effect machinery —
+ *    eviction interval, debounced storage save subscription, storage
+ *    rehydrate. Idempotent across same-id mounts via `entry.started`.
+ *  - Unmount: `useEffect` cleanup decrements refCount; if 0, the
+ *    entry is disposed (timers cleared, final save flushed) and
+ *    removed from the registry.
+ *
+ * Why eager registration: the children's first render calls
+ * `useTxFlight`, which throws if no store is registered for the id.
+ * Lazy `useState` runs once per component instance and is safe to
+ * mutate the registry from (no Strict-Mode double-invoke).
+ *
+ * SSR: `'use client'` keeps Next.js RSC from running this on the
+ * server. Other SSR frameworks (renderToString) will reach the lazy
+ * registration; that's acceptable for v0.9.0 because side effects
+ * (timers, storage IO) are gated by `useEffect`. Task 12 audits the
+ * surface for residual `window`/`document` access.
+ */
+import { type ReactNode } from 'react';
+import type { PublicClient } from 'viem';
+import { type TxFlightStore } from './store/store.js';
+import type { TxFlightStorage } from './types.js';
+export type TxFlightClientFactory = (chainId: number) => PublicClient | undefined;
+/** @internal — read by `useTxFlight` to find the store for an id. */
+export declare const _getStoreForId: (id: string) => TxFlightStore | undefined;
+/** @internal — test escape hatch; tears down every entry. */
+export declare const _resetRegistry: () => void;
+interface ContextValue {
+    id: string;
+}
+/** @internal — read by `useTxFlight` to resolve the ambient id. */
+export declare const _useTxFlightContext: () => ContextValue | null;
+export interface TxFlightProviderProps {
+    children: ReactNode;
+    /** Scopes both in-memory state and storage key. Default: 'default'. */
+    id?: string;
+    /**
+     * Pluggable persistence. Pass `null` to disable persistence
+     * (memory-only). Default: `localStorageAdapter()`.
+     */
+    storage?: TxFlightStorage | null;
+    /** Max retained entries before eviction prunes. Default: 50. */
+    maxItems?: number;
+    /** How long terminals linger after settling (ms). Default: 60_000. */
+    terminalRetentionMs?: number;
+    /** Surfaced for storage failures, watcher errors. */
+    onError?: (method: string, err: unknown) => void;
+    /**
+     * Optional. Returns a `PublicClient` for the given `chainId`, or
+     * `undefined` if not configured. Required only if you want
+     * persisted `pending` entries to auto-resume tx-tracker watching
+     * after a reload. Without this, persisted `pending` entries stay
+     * 'pending' until the consumer manually re-issues `addByHash`.
+     */
+    clientFactory?: TxFlightClientFactory;
+}
+export declare const TxFlightProvider: (props: TxFlightProviderProps) => ReactNode;
+export {};
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAKL,KAAK,SAAS,EACf,MAAM,OAAO,CAAA;AACd,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAIxC,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,YAAY,GAAG,SAAS,CAAA;AAmBjF,qEAAqE;AACrE,eAAO,MAAM,cAAc,OAAQ,MAAM,KAAG,aAAa,GAAG,SACnC,CAAA;AAEzB,6DAA6D;AAC7D,eAAO,MAAM,cAAc,QAAO,IAGjC,CAAA;AAED,UAAU,YAAY;IACpB,EAAE,EAAE,MAAM,CAAA;CACX;AAID,mEAAmE;AACnE,eAAO,MAAM,mBAAmB,QAAO,YAAY,GAAG,IACzB,CAAA;AAE7B,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,SAAS,CAAA;IACnB,uEAAuE;IACvE,EAAE,CAAC,EAAE,MAAM,CAAA;IACX;;;OAGG;IACH,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAAA;IAChC,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,sEAAsE;IACtE,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,qDAAqD;IACrD,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,CAAA;IAChD;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,qBAAqB,CAAA;CACtC;AAqFD,eAAO,MAAM,gBAAgB,UAAW,qBAAqB,KAAG,SAoE/D,CAAA"}