@valve-tech/tx-flight-react 0.0.1

package/dist/store/reducers.js

@@ -0,0 +1,135 @@
+/**
+ * @fileoverview Pure reducers for the tx-flight store.
+ *
+ * Side effects (start watcher, save storage, call unsub) belong in the
+ * Provider. Reducers fold state changes only. The Provider invokes
+ * reducers with `now` parameters so timestamping is testable.
+ */
+const TERMINAL_STATUSES = new Set([
+    'confirmed',
+    'failed',
+    'dropped',
+    'replaced',
+]);
+const isTerminal = (tx) => TERMINAL_STATUSES.has(tx.status);
+/**
+ * The "when did this tx settle / start" timestamp used for both
+ * eviction passes. For terminals: `confirmedAt` if set (the Provider
+ * stamps it on status flip via `updateReducer`), else `submittedAt`
+ * as a conservative fallback for terminals that were added directly
+ * (e.g., via `addManual`). For non-terminals: `submittedAt`.
+ */
+const settledOrSubmittedAt = (tx) => isTerminal(tx) ? (tx.confirmedAt ?? tx.submittedAt) : tx.submittedAt;
+/**
+ * Insert (or overwrite) a TrackedTx and an optional watcher unsub.
+ *
+ * When overwriting a tx that previously had a watcher, the caller MUST
+ * call the previous watcher's unsub BEFORE invoking this reducer —
+ * reducers are pure and don't perform side effects. The Provider owns
+ * watcher lifecycle.
+ */
+export const addReducer = (state, tx, watcher) => {
+    const txs = new Map(state.txs);
+    txs.set(tx.id, tx);
+    const watchers = new Map(state.watchers);
+    if (watcher) {
+        watchers.set(tx.id, watcher);
+    }
+    else {
+        watchers.delete(tx.id);
+    }
+    return { txs, watchers };
+};
+/**
+ * Patch an existing tx's fields. No-op (returns the same state
+ * reference) on a missing id.
+ *
+ * If the patch flips status to a terminal value and `confirmedAt` is
+ * not yet set, stamps `confirmedAt` to `now`. This gives `evictReducer`
+ * a uniform "settled at" timestamp regardless of which terminal status
+ * the tx ended in.
+ */
+export const updateReducer = (state, txId, patch, now) => {
+    const existing = state.txs.get(txId);
+    if (!existing)
+        return state;
+    const next = { ...existing, ...patch };
+    if (isTerminal(next) && next.confirmedAt === undefined) {
+        next.confirmedAt = now;
+    }
+    const txs = new Map(state.txs);
+    txs.set(txId, next);
+    return { txs, watchers: state.watchers };
+};
+/**
+ * Drop a tx and its watcher map entry. The Provider is responsible for
+ * calling the watcher's unsub BEFORE this reducer runs.
+ *
+ * No-op (returns the same state reference) on a missing id.
+ */
+export const removeReducer = (state, txId) => {
+    if (!state.txs.has(txId) && !state.watchers.has(txId))
+        return state;
+    const txs = new Map(state.txs);
+    txs.delete(txId);
+    const watchers = new Map(state.watchers);
+    watchers.delete(txId);
+    return { txs, watchers };
+};
+/**
+ * Two-pass eviction. Returns the same state reference when nothing
+ * changed.
+ *
+ * Pass 1: drop terminal entries older than `terminalRetentionMs` —
+ *   `now - (confirmedAt ?? submittedAt) > terminalRetentionMs`.
+ * Pass 2: if the surviving set is still larger than `maxItems`, drop
+ *   in priority order: terminals first (oldest first by their settled
+ *   timestamp), then non-terminals (oldest first by submittedAt).
+ *   Non-terminals are preserved over terminals at the same age — an
+ *   active in-flight tx is more valuable than a settled one.
+ */
+export const evictReducer = (state, opts) => {
+    const { maxItems, terminalRetentionMs, now } = opts;
+    // Pass 1: collect terminals past their retention window.
+    const expired = new Set();
+    for (const [id, tx] of state.txs) {
+        if (!isTerminal(tx))
+            continue;
+        if (now - settledOrSubmittedAt(tx) > terminalRetentionMs)
+            expired.add(id);
+    }
+    // Pass 2: if still over cap, sort survivors by (terminal-first,
+    // then oldest-first) and slice off the head until under cap.
+    const survivorsAfterPass1 = state.txs.size - expired.size;
+    let extraEvictions = [];
+    if (survivorsAfterPass1 > maxItems) {
+        const survivors = [];
+        for (const [id, tx] of state.txs) {
+            if (!expired.has(id))
+                survivors.push(tx);
+        }
+        survivors.sort((a, b) => {
+            const aT = isTerminal(a) ? 0 : 1;
+            const bT = isTerminal(b) ? 0 : 1;
+            if (aT !== bT)
+                return aT - bT;
+            return settledOrSubmittedAt(a) - settledOrSubmittedAt(b);
+        });
+        const evictCount = survivorsAfterPass1 - maxItems;
+        extraEvictions = survivors.slice(0, evictCount).map((t) => t.id);
+    }
+    if (expired.size === 0 && extraEvictions.length === 0)
+        return state;
+    const txs = new Map(state.txs);
+    const watchers = new Map(state.watchers);
+    for (const id of expired) {
+        txs.delete(id);
+        watchers.delete(id);
+    }
+    for (const id of extraEvictions) {
+        txs.delete(id);
+        watchers.delete(id);
+    }
+    return { txs, watchers };
+};
+//# sourceMappingURL=reducers.js.map

package/dist/store/reducers.js.map

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

package/dist/store/store.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @fileoverview Subscribable store wrapping the pure reducers with the
+ * side effects the Provider needs:
+ *
+ *  - notify subscribers on state change (so React's
+ *    `useSyncExternalStore` re-renders consumers)
+ *  - call watcher unsub on remove / clear / evict / overwrite (the
+ *    reducers are forbidden from doing this — see AGENTS.md invariant 1)
+ *  - cache the txs-as-array projection so `useSyncExternalStore` sees
+ *    a stable reference between dispatches
+ *
+ * Storage IO and the eviction `setInterval` belong in the Provider,
+ * not here. The store exposes `dispatch.evict()` so the Provider can
+ * invoke it on its own schedule (testable + composable).
+ */
+import type { TrackedTx } from '@valve-tech/wallet-adapter';
+import type { InternalState } from '../types.js';
+export interface TxFlightStoreOptions {
+    /** Cap on retained entries. Eviction tick prunes terminals first, then non-terminals if still over. */
+    maxItems: number;
+    /** How long terminals linger before eviction. */
+    terminalRetentionMs: number;
+    /**
+     * Routed for watcher-unsub failures. Storage errors come from the
+     * Provider, not the store. Optional — undefined silently swallows.
+     */
+    onError?: (method: string, err: unknown) => void;
+}
+export interface TxFlightStore {
+    getState(): InternalState;
+    /** Stable-reference array projection of txs. Recomputed only on state change. */
+    getTxs(): readonly TrackedTx[];
+    subscribe(listener: () => void): () => void;
+    dispatch: {
+        /**
+         * Insert (or overwrite) a TrackedTx with an optional watcher unsub.
+         * If a prior watcher was registered for the same `tx.id`, it is
+         * unsubscribed BEFORE the state changes — so its in-flight callbacks
+         * cannot pollute the new entry.
+         */
+        addWithTx: (tx: TrackedTx, watcher: (() => void) | null) => void;
+        update: (txId: string, patch: Partial<TrackedTx>) => void;
+        /** Remove a tx + its watcher. Calls the watcher's unsub before state changes. */
+        remove: (txId: string) => void;
+        /** Empty the store. Calls every watcher's unsub before state changes. */
+        clear: () => void;
+        /**
+         * Periodic eviction tick. Calls `evictReducer` with `Date.now()`;
+         * when the resulting state drops txs that had watchers, those
+         * watchers are unsubscribed.
+         */
+        evict: () => void;
+    };
+}
+export declare const createTxFlightStore: (options: TxFlightStoreOptions) => TxFlightStore;
+//# sourceMappingURL=store.d.ts.map

package/dist/store/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/store/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAE3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAQhD,MAAM,WAAW,oBAAoB;IACnC,uGAAuG;IACvG,QAAQ,EAAE,MAAM,CAAA;IAChB,iDAAiD;IACjD,mBAAmB,EAAE,MAAM,CAAA;IAC3B;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,CAAA;CACjD;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,IAAI,aAAa,CAAA;IACzB,iFAAiF;IACjF,MAAM,IAAI,SAAS,SAAS,EAAE,CAAA;IAC9B,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAA;IAC3C,QAAQ,EAAE;QACR;;;;;WAKG;QACH,SAAS,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,KAAK,IAAI,CAAA;QAChE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,KAAK,IAAI,CAAA;QACzD,iFAAiF;QACjF,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;QAC9B,yEAAyE;QACzE,KAAK,EAAE,MAAM,IAAI,CAAA;QACjB;;;;WAIG;QACH,KAAK,EAAE,MAAM,IAAI,CAAA;KAClB,CAAA;CACF;AAOD,eAAO,MAAM,mBAAmB,YACrB,oBAAoB,KAC5B,aAiEF,CAAA"}

package/dist/store/store.js

@@ -0,0 +1,93 @@
+/**
+ * @fileoverview Subscribable store wrapping the pure reducers with the
+ * side effects the Provider needs:
+ *
+ *  - notify subscribers on state change (so React's
+ *    `useSyncExternalStore` re-renders consumers)
+ *  - call watcher unsub on remove / clear / evict / overwrite (the
+ *    reducers are forbidden from doing this — see AGENTS.md invariant 1)
+ *  - cache the txs-as-array projection so `useSyncExternalStore` sees
+ *    a stable reference between dispatches
+ *
+ * Storage IO and the eviction `setInterval` belong in the Provider,
+ * not here. The store exposes `dispatch.evict()` so the Provider can
+ * invoke it on its own schedule (testable + composable).
+ */
+import { addReducer, evictReducer, removeReducer, updateReducer, } from './reducers.js';
+const emptyInternalState = () => ({
+    txs: new Map(),
+    watchers: new Map(),
+});
+export const createTxFlightStore = (options) => {
+    let state = emptyInternalState();
+    let cachedTxs = null;
+    const listeners = new Set();
+    const safeUnsub = (unsub) => {
+        try {
+            unsub();
+        }
+        catch (err) {
+            options.onError?.('watcher-unsub', err);
+        }
+    };
+    const setState = (next) => {
+        if (next === state)
+            return;
+        state = next;
+        cachedTxs = null;
+        for (const fn of listeners)
+            fn();
+    };
+    return {
+        getState: () => state,
+        getTxs: () => {
+            if (cachedTxs === null)
+                cachedTxs = Array.from(state.txs.values());
+            return cachedTxs;
+        },
+        subscribe: (listener) => {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+        dispatch: {
+            addWithTx: (tx, watcher) => {
+                const priorUnsub = state.watchers.get(tx.id);
+                if (priorUnsub)
+                    safeUnsub(priorUnsub);
+                setState(addReducer(state, tx, watcher));
+            },
+            update: (txId, patch) => {
+                setState(updateReducer(state, txId, patch, Date.now()));
+            },
+            remove: (txId) => {
+                const unsub = state.watchers.get(txId);
+                if (unsub)
+                    safeUnsub(unsub);
+                setState(removeReducer(state, txId));
+            },
+            clear: () => {
+                const unsubs = Array.from(state.watchers.values());
+                for (const unsub of unsubs)
+                    safeUnsub(unsub);
+                setState(emptyInternalState());
+            },
+            evict: () => {
+                const next = evictReducer(state, {
+                    maxItems: options.maxItems,
+                    terminalRetentionMs: options.terminalRetentionMs,
+                    now: Date.now(),
+                });
+                if (next === state)
+                    return;
+                for (const [id, unsub] of state.watchers) {
+                    if (!next.watchers.has(id))
+                        safeUnsub(unsub);
+                }
+                setState(next);
+            },
+        },
+    };
+};
+//# sourceMappingURL=store.js.map

package/dist/store/store.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,96 @@
+/**
+ * @fileoverview Public + internal type surface for `@valve-tech/tx-flight-react`.
+ *
+ * Public types: the three add-input shapes (`AddWithWalletAdapterInput`,
+ * `AddByHashInput`, `AddManualInput`), the `TxFlightStorage` adapter
+ * contract, and provider/hook option bags.
+ *
+ * Internal types: `InternalState` (used by reducers + store) is exported
+ * for cross-module use within the package but is NOT re-exported from
+ * `index.ts` — consumers don't need it.
+ *
+ * wallet-adapter and viem types are imported as `type`-only so the
+ * optional-peer-dep posture (spec §6.1) holds: a wallet-adapter-only
+ * consumer doesn't pay any tx-tracker bundle cost, and a hash-only
+ * consumer doesn't pay any wallet-adapter cost.
+ */
+import type { Hex, PublicClient } from 'viem';
+import type { TrackedTx, TxFlow, WriteHookParams, WalletSendTransactionRequest } from '@valve-tech/wallet-adapter';
+export type { TrackedTx, TxFlow };
+/**
+ * Input for `addWithWalletAdapter(input)`. Use when the caller is
+ * submitting their tx via `sendTransactionWithHooks` from
+ * `@valve-tech/wallet-adapter`. The strip wraps `hooks` so each phase
+ * fans out to both the caller's original callbacks AND the strip's
+ * store dispatch.
+ */
+export interface AddWithWalletAdapterInput {
+    /** The hooks bag the consumer is already passing to sendTransactionWithHooks. */
+    hooks: WriteHookParams;
+    /** Echoed onto TrackedTx.flow. Caller-defined string. */
+    flow: TxFlow;
+    /** Echoed onto TrackedTx.chainId. */
+    chainId: number;
+    /** Echoed onto TrackedTx.request — used for replay/replace flows. */
+    request: WalletSendTransactionRequest;
+}
+/**
+ * Input for `addByHash(input)`. Use when the caller already has a tx
+ * hash + chainId and a `PublicClient` to watch with. Internally builds
+ * a private `ChainSource` + `TxTracker` pair (dynamic-imports
+ * `@valve-tech/tx-tracker` + `@valve-tech/chain-source`).
+ */
+export interface AddByHashInput {
+    hash: Hex;
+    chainId: number;
+    /** viem PublicClient pointed at the chain. */
+    client: PublicClient;
+    flow?: TxFlow;
+    /** Confirmations before TrackedTx.status flips to mined. Default 1. */
+    confirmations?: number;
+    /** Blocks of unseen observation before TrackedTx.status flips to dropped. Default 12. */
+    staleAfterBlocks?: number;
+    /**
+     * If true, fetches the receipt at inclusion. When the receipt's
+     * status is reverted, the strip surfaces `failed`. Adds one RPC.
+     */
+    withReceipts?: boolean;
+}
+/**
+ * Input for `addManual(input)`. Use when the caller already has a
+ * fully-formed `TrackedTx` (e.g., back-filling from a server push,
+ * surfacing a tx observed elsewhere). The strip stores the entry
+ * verbatim and does NOT auto-update — caller drives subsequent state
+ * by calling `addManual` again with the same `tx.id` (overwrites in
+ * place) or `remove(id)`.
+ */
+export interface AddManualInput {
+    tx: TrackedTx;
+}
+/**
+ * Pluggable persistence contract for the tx-flight strip. The Provider
+ * loads on mount and saves on state change (debounced ~250ms).
+ *
+ * Built-in adapters live at `@valve-tech/tx-flight-react/storage`:
+ * `localStorageAdapter` (default), `indexedDBAdapter`, `memoryAdapter`.
+ * Custom adapters just satisfy this two-method interface.
+ */
+export interface TxFlightStorage {
+    /** Returns null if no entry exists for the given id. */
+    load(id: string): Promise<TrackedTx[] | null>;
+    /** Replace stored value. Called debounced ~250ms by the Provider. */
+    save(id: string, txs: TrackedTx[]): Promise<void>;
+}
+export interface InternalState {
+    /** TrackedTx records keyed by their assigned id. */
+    txs: ReadonlyMap<string, TrackedTx>;
+    /**
+     * Per-tx unsubscribe handles for active watchers (addByHash spawns
+     * one; addWithWalletAdapter and addManual leave this empty for the
+     * tx). The reducers don't call these — the Provider does on remove
+     * or unmount, keeping reducers pure.
+     */
+    watchers: ReadonlyMap<string, () => void>;
+}
+export declare const emptyState: InternalState;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAC7C,OAAO,KAAK,EACV,SAAS,EACT,MAAM,EACN,eAAe,EACf,4BAA4B,EAC7B,MAAM,4BAA4B,CAAA;AASnC,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,CAAA;AAIjC;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB;IACxC,iFAAiF;IACjF,KAAK,EAAE,eAAe,CAAA;IACtB,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAA;IACZ,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAA;IACf,qEAAqE;IACrE,OAAO,EAAE,4BAA4B,CAAA;CACtC;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,GAAG,CAAA;IACT,OAAO,EAAE,MAAM,CAAA;IACf,8CAA8C;IAC9C,MAAM,EAAE,YAAY,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,uEAAuE;IACvE,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,yFAAyF;IACzF,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,SAAS,CAAA;CACd;AAID;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,CAAA;IAC7C,qEAAqE;IACrE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAClD;AAQD,MAAM,WAAW,aAAa;IAC5B,oDAAoD;IACpD,GAAG,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IACnC;;;;;OAKG;IACH,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,CAAA;CAC1C;AAED,eAAO,MAAM,UAAU,EAAE,aAGxB,CAAA"}

package/dist/types.js

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview Public + internal type surface for `@valve-tech/tx-flight-react`.
+ *
+ * Public types: the three add-input shapes (`AddWithWalletAdapterInput`,
+ * `AddByHashInput`, `AddManualInput`), the `TxFlightStorage` adapter
+ * contract, and provider/hook option bags.
+ *
+ * Internal types: `InternalState` (used by reducers + store) is exported
+ * for cross-module use within the package but is NOT re-exported from
+ * `index.ts` — consumers don't need it.
+ *
+ * wallet-adapter and viem types are imported as `type`-only so the
+ * optional-peer-dep posture (spec §6.1) holds: a wallet-adapter-only
+ * consumer doesn't pay any tx-tracker bundle cost, and a hash-only
+ * consumer doesn't pay any wallet-adapter cost.
+ */
+export const emptyState = {
+    txs: new Map(),
+    watchers: new Map(),
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AA6GH,MAAM,CAAC,MAAM,UAAU,GAAkB;IACvC,GAAG,EAAE,IAAI,GAAG,EAAE;IACd,QAAQ,EAAE,IAAI,GAAG,EAAE;CACpB,CAAA"}

package/dist/use-tx-flight.d.ts

@@ -0,0 +1,31 @@
+import type { TrackedTx, WriteHookParams } from '@valve-tech/wallet-adapter';
+import { type AddWithWalletAdapterResult } from './integrations/wallet-adapter.js';
+import type { AddByHashInput, AddManualInput, AddWithWalletAdapterInput } from './types.js';
+export interface UseTxFlightReturn {
+    /** Reactive snapshot — re-renders when state changes. */
+    txs: readonly TrackedTx[];
+    /**
+     * Add a tx the consumer is submitting via @valve-tech/wallet-adapter.
+     * Returns the assigned id and a wrapped `WriteHookParams` to pass to
+     * `sendTransactionWithHooks`. Each phase fans out to the consumer's
+     * original callbacks AND a store dispatch reflecting the new state.
+     */
+    addWithWalletAdapter: (input: AddWithWalletAdapterInput) => AddWithWalletAdapterResult;
+    /**
+     * Add a tx by its hash + chainId. Internally builds a private
+     * ChainSource + TxTracker and watches the hash. Async because
+     * `@valve-tech/tx-tracker` is dynamic-imported (optional peer dep).
+     */
+    addByHash: (input: AddByHashInput) => Promise<string>;
+    /** Add a fully-formed TrackedTx. Returns the supplied id. */
+    addManual: (input: AddManualInput) => string;
+    /** Remove an entry by id. No-op if not found. */
+    remove: (id: string) => void;
+    /** Empty the strip (terminal + non-terminal). */
+    clear: () => void;
+    /** Imperative read; doesn't subscribe to re-renders. */
+    get: (id: string) => TrackedTx | null;
+}
+export type { WriteHookParams, AddWithWalletAdapterResult };
+export declare const useTxFlight: (id?: string) => UseTxFlightReturn;
+//# sourceMappingURL=use-tx-flight.d.ts.map

package/dist/use-tx-flight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tx-flight.d.ts","sourceRoot":"","sources":["../src/use-tx-flight.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAG5E,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,kCAAkC,CAAA;AAEzC,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,yBAAyB,EAC1B,MAAM,YAAY,CAAA;AAEnB,MAAM,WAAW,iBAAiB;IAChC,yDAAyD;IACzD,GAAG,EAAE,SAAS,SAAS,EAAE,CAAA;IACzB;;;;;OAKG;IACH,oBAAoB,EAAE,CAAC,KAAK,EAAE,yBAAyB,KAAK,0BAA0B,CAAA;IACtF;;;;OAIG;IACH,SAAS,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IACrD,6DAA6D;IAC7D,SAAS,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,MAAM,CAAA;IAC5C,iDAAiD;IACjD,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5B,iDAAiD;IACjD,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,wDAAwD;IACxD,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,SAAS,GAAG,IAAI,CAAA;CACtC;AAED,YAAY,EAAE,eAAe,EAAE,0BAA0B,EAAE,CAAA;AAE3D,eAAO,MAAM,WAAW,QAAS,MAAM,KAAG,iBA4BzC,CAAA"}

package/dist/use-tx-flight.js

@@ -0,0 +1,47 @@
+'use client';
+/**
+ * @fileoverview `useTxFlight(id?)` — the consumer's entry point to a
+ * Provider's store.
+ *
+ * Resolution order for the id:
+ *   1. Explicit argument — `useTxFlight('settings-page')`.
+ *   2. Ambient context from the nearest `<TxFlightProvider>`.
+ *   3. Fallback `'default'`.
+ *
+ * Throws if no Provider has registered a store for the resolved id.
+ *
+ * For Task 5 the hook surface is `txs` + `addManual` + `remove` +
+ * `clear` + `get`. The wallet-adapter (`addWithWalletAdapter`) and
+ * tx-tracker (`addByHash`) integrations land in Tasks 7 and 8 and
+ * extend this surface.
+ */
+import { useSyncExternalStore } from 'react';
+import { addByHashImpl } from './integrations/tx-tracker.js';
+import { addWithWalletAdapterImpl, } from './integrations/wallet-adapter.js';
+import { _getStoreForId, _useTxFlightContext } from './provider.js';
+export const useTxFlight = (id) => {
+    const ambient = _useTxFlightContext();
+    const resolvedId = id ?? ambient?.id ?? 'default';
+    const store = _getStoreForId(resolvedId);
+    if (!store) {
+        throw new Error(`[@valve-tech/tx-flight-react] No <TxFlightProvider id="${resolvedId}"> found in tree`);
+    }
+    const txs = useSyncExternalStore(store.subscribe, store.getTxs, store.getTxs);
+    return {
+        txs,
+        addWithWalletAdapter: (input) => addWithWalletAdapterImpl(store, input),
+        addByHash: (input) => addByHashImpl(store, input),
+        addManual: (input) => {
+            store.dispatch.addWithTx(input.tx, null);
+            return input.tx.id;
+        },
+        remove: (txId) => {
+            store.dispatch.remove(txId);
+        },
+        clear: () => {
+            store.dispatch.clear();
+        },
+        get: (txId) => store.getState().txs.get(txId) ?? null,
+    };
+};
+//# sourceMappingURL=use-tx-flight.js.map

package/dist/use-tx-flight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tx-flight.js","sourceRoot":"","sources":["../src/use-tx-flight.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAA;AAG5C,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAC5D,OAAO,EACL,wBAAwB,GAEzB,MAAM,kCAAkC,CAAA;AACzC,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAmCnE,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,EAAW,EAAqB,EAAE;IAC5D,MAAM,OAAO,GAAG,mBAAmB,EAAE,CAAA;IACrC,MAAM,UAAU,GAAG,EAAE,IAAI,OAAO,EAAE,EAAE,IAAI,SAAS,CAAA;IACjD,MAAM,KAAK,GAAG,cAAc,CAAC,UAAU,CAAC,CAAA;IACxC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,0DAA0D,UAAU,kBAAkB,CACvF,CAAA;IACH,CAAC;IAED,MAAM,GAAG,GAAG,oBAAoB,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IAE7E,OAAO;QACL,GAAG;QACH,oBAAoB,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,CAAC;QACvE,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC;QACjD,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE;YACnB,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;YACxC,OAAO,KAAK,CAAC,EAAE,CAAC,EAAE,CAAA;QACpB,CAAC;QACD,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACf,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAC7B,CAAC;QACD,KAAK,EAAE,GAAG,EAAE;YACV,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAA;QACxB,CAAC;QACD,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI;KACtD,CAAA;AACH,CAAC,CAAA"}

package/package.json

@@ -0,0 +1,83 @@
+{
+  "name": "@valve-tech/tx-flight-react",
+  "version": "0.0.1",
+  "description": "React UI primitives for rendering an in-flight transaction strip. Provider with multi-instance scoping (id + storage key), three add methods (addWithWalletAdapter for callers using @valve-tech/wallet-adapter, addByHash for raw hash + chain via @valve-tech/tx-tracker, addManual for back-fill), pluggable storage (localStorage default, IndexedDB and memory adapters included), atomic + layout components for headless composition, SSR-safe (the package's React-side hooks are client-only; storage adapters no-op on the server). Part of the valve-tech/evm-toolkit synchronized release line.",
+  "license": "MIT",
+  "homepage": "https://github.com/valve-tech/evm-toolkit/tree/main/packages/tx-flight-react#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/valve-tech/evm-toolkit.git",
+    "directory": "packages/tx-flight-react"
+  },
+  "bugs": {
+    "url": "https://github.com/valve-tech/evm-toolkit/issues"
+  },
+  "keywords": [
+    "ethereum",
+    "evm",
+    "viem",
+    "react",
+    "tx-flight",
+    "tx-status",
+    "transaction-tracker",
+    "wallet-adapter",
+    "ui-primitives"
+  ],
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./storage": {
+      "types": "./dist/storage/index.d.ts",
+      "import": "./dist/storage/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc -p .",
+    "typecheck": "tsc -p . --noEmit",
+    "lint": "eslint src",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "prepare": "yarn build"
+  },
+  "peerDependencies": {
+    "@valve-tech/chain-source": "^0.8.1",
+    "@valve-tech/tx-tracker": "^0.8.1",
+    "@valve-tech/wallet-adapter": "^0.8.1",
+    "react": "^18.2.0 || ^19.0.0",
+    "react-dom": "^18.2.0 || ^19.0.0",
+    "viem": "^2.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@valve-tech/chain-source": {
+      "optional": true
+    },
+    "@valve-tech/tx-tracker": {
+      "optional": true
+    },
+    "@valve-tech/wallet-adapter": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@testing-library/dom": "^10.4.0",
+    "@testing-library/react": "^16.1.0",
+    "@types/react": "^18.3.0",
+    "@types/react-dom": "^18.3.0",
+    "fake-indexeddb": "^6.0.0",
+    "happy-dom": "^15.0.0",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1"
+  }
+}