@valve-tech/tx-flight-react 0.0.1

package/dist/provider.js

@@ -0,0 +1,182 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * @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 { createContext, useContext, useEffect, useState, } from 'react';
+import { resumeByHashWatcher } from './integrations/tx-tracker.js';
+import { localStorageAdapter } from './storage/local-storage.js';
+import { createTxFlightStore } from './store/store.js';
+const DEFAULT_ID = 'default';
+const DEFAULT_MAX_ITEMS = 50;
+const DEFAULT_TERMINAL_RETENTION_MS = 60000;
+const DEFAULT_SAVE_DEBOUNCE_MS = 250;
+const DEFAULT_EVICT_INTERVAL_MS = 5000;
+const registry = new Map();
+/** @internal — read by `useTxFlight` to find the store for an id. */
+export const _getStoreForId = (id) => registry.get(id)?.store;
+/** @internal — test escape hatch; tears down every entry. */
+export const _resetRegistry = () => {
+    for (const entry of registry.values())
+        entry.dispose();
+    registry.clear();
+};
+const TxFlightContext = createContext(null);
+/** @internal — read by `useTxFlight` to resolve the ambient id. */
+export const _useTxFlightContext = () => useContext(TxFlightContext);
+const startEntry = (id, entry, storage, onError, clientFactory) => {
+    // Idempotent restart: tear down any prior dispose (the placeholder
+    // on a fresh entry, or a real teardown on a re-start). Keeps
+    // startEntry safe to call more than once on the same entry.
+    entry.dispose();
+    const store = entry.store;
+    const evictTimer = setInterval(() => store.dispatch.evict(), DEFAULT_EVICT_INTERVAL_MS);
+    // No persistence: only the eviction tick.
+    if (!storage) {
+        entry.dispose = () => {
+            clearInterval(evictTimer);
+        };
+        return;
+    }
+    // Persistence: subscribe for debounced save, kick off rehydrate,
+    // tear all of it down on dispose.
+    let saveTimer = null;
+    const flushSave = () => {
+        if (saveTimer === null)
+            return;
+        clearTimeout(saveTimer);
+        saveTimer = null;
+        storage.save(id, [...store.getTxs()]).catch((err) => {
+            onError?.('storage-save', err);
+        });
+    };
+    const unsubscribeStore = store.subscribe(() => {
+        if (saveTimer !== null)
+            clearTimeout(saveTimer);
+        saveTimer = setTimeout(flushSave, DEFAULT_SAVE_DEBOUNCE_MS);
+    });
+    storage.load(id).then((loaded) => {
+        if (loaded === null)
+            return;
+        for (const tx of loaded) {
+            if (store.getState().txs.has(tx.id))
+                continue;
+            // Pre-hash in-flight states cannot resume across a reload — the
+            // wallet interaction is gone. Translate to a terminal failure
+            // so the consumer's UI shows the loss honestly.
+            if (tx.status === 'preparing' || tx.status === 'awaiting-signature') {
+                store.dispatch.addWithTx({ ...tx, status: 'failed', notes: 'lost during reload' }, null);
+                continue;
+            }
+            // Default: seed the entry. For 'pending' with a hash + a
+            // configured client, async-attach a tx-tracker watcher so the
+            // entry continues advancing toward terminal.
+            store.dispatch.addWithTx(tx, null);
+            if (tx.status === 'pending' &&
+                tx.hash !== undefined &&
+                clientFactory !== undefined) {
+                const client = clientFactory(tx.chainId);
+                if (client !== undefined) {
+                    // resumeByHashWatcher swallows its own failures into onError.
+                    void resumeByHashWatcher(store, tx, client, onError);
+                }
+            }
+        }
+    }).catch((err) => {
+        onError?.('storage-load', err);
+    });
+    entry.dispose = () => {
+        clearInterval(evictTimer);
+        unsubscribeStore();
+        flushSave();
+    };
+};
+export const TxFlightProvider = (props) => {
+    const id = props.id ?? DEFAULT_ID;
+    const maxItems = props.maxItems ?? DEFAULT_MAX_ITEMS;
+    const terminalRetentionMs = props.terminalRetentionMs ?? DEFAULT_TERMINAL_RETENTION_MS;
+    const onError = props.onError;
+    const clientFactory = props.clientFactory;
+    const storage = props.storage === null
+        ? null
+        : (props.storage ?? localStorageAdapter());
+    // Eager: claim a registry entry on first render so children that
+    // call `useTxFlight` in their FIRST render see a valid store. Lazy
+    // `useState` initializers run once per component instance and are
+    // safe to perform a single registration side effect from.
+    //
+    // refCount is owned by `useEffect` (commit phase). Render-phase
+    // registration leaves refCount at 0; the effect bumps it.
+    useState(() => {
+        const existing = registry.get(id);
+        if (existing)
+            return existing;
+        const store = createTxFlightStore({ maxItems, terminalRetentionMs, onError });
+        const fresh = {
+            store,
+            refCount: 0,
+            started: false,
+            dispose: () => undefined,
+        };
+        registry.set(id, fresh);
+        return fresh;
+    });
+    useEffect(() => {
+        // The render-phase entry may be missing on this commit if a Strict
+        // Mode dev cycle disposed it between setup runs (or a test reset
+        // ran). Re-create so children's hooks keep working.
+        let entry = registry.get(id);
+        if (!entry) {
+            const store = createTxFlightStore({ maxItems, terminalRetentionMs, onError });
+            entry = {
+                store,
+                refCount: 0,
+                started: false,
+                dispose: () => undefined,
+            };
+            registry.set(id, entry);
+        }
+        entry.refCount += 1;
+        if (!entry.started) {
+            entry.started = true;
+            startEntry(id, entry, storage, onError, clientFactory);
+        }
+        // Capture in closure so cleanup uses the entry this commit
+        // claimed, not whatever happens to be in the registry later.
+        const captured = entry;
+        return () => {
+            captured.refCount -= 1;
+            if (captured.refCount > 0)
+                return;
+            captured.dispose();
+            // Only clear our slot. A test reset may have replaced the entry.
+            if (registry.get(id) === captured)
+                registry.delete(id);
+        };
+    }, [id, storage, maxItems, terminalRetentionMs, onError, clientFactory]);
+    return (_jsx(TxFlightContext.Provider, { value: { id }, children: props.children }));
+};
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

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

package/dist/storage/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Public surface for `@valve-tech/tx-flight-react/storage`.
+ */
+export { memoryAdapter } from './memory.js';
+export { localStorageAdapter, type LocalStorageAdapterOptions, } from './local-storage.js';
+export { indexedDBAdapter, type IndexedDBAdapterOptions, } from './indexed-db.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EACL,mBAAmB,EACnB,KAAK,0BAA0B,GAChC,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,GAC7B,MAAM,iBAAiB,CAAA"}

package/dist/storage/index.js

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Public surface for `@valve-tech/tx-flight-react/storage`.
+ */
+export { memoryAdapter } from './memory.js';
+export { localStorageAdapter, } from './local-storage.js';
+export { indexedDBAdapter, } from './indexed-db.js';
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EACL,mBAAmB,GAEpB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,gBAAgB,GAEjB,MAAM,iBAAiB,CAAA"}

package/dist/storage/indexed-db.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview IndexedDB adapter — opt-in for consumers who outgrow
+ * localStorage's ~5MB cap or need cross-tab persistence with structured
+ * data. Async by nature.
+ *
+ * One database, one object store. Records are keyed by the Provider's
+ * `id`; each record stores the serialized JSON string (same format as
+ * the localStorage adapter, see `serialize.ts`).
+ *
+ * SSR-safe: when `globalThis.indexedDB === undefined`, `load` resolves
+ * null and `save` resolves no-op.
+ */
+import type { TxFlightStorage } from '../types.js';
+export interface IndexedDBAdapterOptions {
+    /** Database name. Default: 'tx-flight'. */
+    dbName?: string;
+    /** Object store name. Default: 'flights'. */
+    storeName?: string;
+}
+export declare const indexedDBAdapter: (options?: IndexedDBAdapterOptions) => TxFlightStorage;
+//# sourceMappingURL=indexed-db.d.ts.map

package/dist/storage/indexed-db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexed-db.d.ts","sourceRoot":"","sources":["../../src/storage/indexed-db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAGlD,MAAM,WAAW,uBAAuB;IACtC,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AA2BD,eAAO,MAAM,gBAAgB,aAClB,uBAAuB,KAC/B,eAuBF,CAAA"}

package/dist/storage/indexed-db.js

@@ -0,0 +1,58 @@
+/**
+ * @fileoverview IndexedDB adapter — opt-in for consumers who outgrow
+ * localStorage's ~5MB cap or need cross-tab persistence with structured
+ * data. Async by nature.
+ *
+ * One database, one object store. Records are keyed by the Provider's
+ * `id`; each record stores the serialized JSON string (same format as
+ * the localStorage adapter, see `serialize.ts`).
+ *
+ * SSR-safe: when `globalThis.indexedDB === undefined`, `load` resolves
+ * null and `save` resolves no-op.
+ */
+import { serialize, deserialize } from './serialize.js';
+const getIndexedDB = () => {
+    if (typeof globalThis.indexedDB === 'undefined')
+        return null;
+    return globalThis.indexedDB;
+};
+const openDb = (factory, dbName, storeName) => new Promise((resolve, reject) => {
+    const request = factory.open(dbName, 1);
+    request.onupgradeneeded = () => {
+        request.result.createObjectStore(storeName);
+    };
+    request.onsuccess = () => resolve(request.result);
+    request.onerror = () => reject(request.error);
+});
+const promisifyRequest = (request) => new Promise((resolve, reject) => {
+    request.onsuccess = () => resolve(request.result);
+    request.onerror = () => reject(request.error);
+});
+export const indexedDBAdapter = (options = {}) => {
+    const dbName = options.dbName ?? 'tx-flight';
+    const storeName = options.storeName ?? 'flights';
+    return {
+        load: async (id) => {
+            const factory = getIndexedDB();
+            if (!factory)
+                return null;
+            const db = await openDb(factory, dbName, storeName);
+            const tx = db.transaction(storeName, 'readonly');
+            const raw = await promisifyRequest(tx.objectStore(storeName).get(id));
+            db.close();
+            if (typeof raw !== 'string')
+                return null;
+            return deserialize(raw);
+        },
+        save: async (id, txs) => {
+            const factory = getIndexedDB();
+            if (!factory)
+                return;
+            const db = await openDb(factory, dbName, storeName);
+            const tx = db.transaction(storeName, 'readwrite');
+            await promisifyRequest(tx.objectStore(storeName).put(serialize(txs), id));
+            db.close();
+        },
+    };
+};
+//# sourceMappingURL=indexed-db.js.map

package/dist/storage/indexed-db.js.map

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

package/dist/storage/local-storage.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @fileoverview localStorage adapter — the default persistence path.
+ *
+ * Storage key: `${keyPrefix}:${id}`, default `tx-flight:default`.
+ * SSR-safe: when `globalThis.window === undefined`, `load` resolves
+ * null and `save` resolves no-op (no throw). Hydration on the client
+ * picks up the persisted state.
+ *
+ * The Provider debounces calls to `save` (~250ms), so the
+ * sync-write-on-every-keystroke concern doesn't apply here.
+ */
+import type { TxFlightStorage } from '../types.js';
+export interface LocalStorageAdapterOptions {
+    /** Storage key prefix. Default: 'tx-flight'. */
+    keyPrefix?: string;
+}
+export declare const localStorageAdapter: (options?: LocalStorageAdapterOptions) => TxFlightStorage;
+//# sourceMappingURL=local-storage.d.ts.map

package/dist/storage/local-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-storage.d.ts","sourceRoot":"","sources":["../../src/storage/local-storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAGlD,MAAM,WAAW,0BAA0B;IACzC,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAOD,eAAO,MAAM,mBAAmB,aACrB,0BAA0B,KAClC,eAiBF,CAAA"}

package/dist/storage/local-storage.js

@@ -0,0 +1,39 @@
+/**
+ * @fileoverview localStorage adapter — the default persistence path.
+ *
+ * Storage key: `${keyPrefix}:${id}`, default `tx-flight:default`.
+ * SSR-safe: when `globalThis.window === undefined`, `load` resolves
+ * null and `save` resolves no-op (no throw). Hydration on the client
+ * picks up the persisted state.
+ *
+ * The Provider debounces calls to `save` (~250ms), so the
+ * sync-write-on-every-keystroke concern doesn't apply here.
+ */
+import { serialize, deserialize } from './serialize.js';
+const getStorage = () => {
+    if (typeof globalThis.window === 'undefined')
+        return null;
+    return globalThis.window.localStorage;
+};
+export const localStorageAdapter = (options = {}) => {
+    const prefix = options.keyPrefix ?? 'tx-flight';
+    const keyOf = (id) => `${prefix}:${id}`;
+    return {
+        load: async (id) => {
+            const storage = getStorage();
+            if (!storage)
+                return null;
+            const raw = storage.getItem(keyOf(id));
+            if (raw === null)
+                return null;
+            return deserialize(raw);
+        },
+        save: async (id, txs) => {
+            const storage = getStorage();
+            if (!storage)
+                return;
+            storage.setItem(keyOf(id), serialize(txs));
+        },
+    };
+};
+//# sourceMappingURL=local-storage.js.map

package/dist/storage/local-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-storage.js","sourceRoot":"","sources":["../../src/storage/local-storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAOvD,MAAM,UAAU,GAAG,GAAmB,EAAE;IACtC,IAAI,OAAO,UAAU,CAAC,MAAM,KAAK,WAAW;QAAE,OAAO,IAAI,CAAA;IACzD,OAAO,UAAU,CAAC,MAAM,CAAC,YAAY,CAAA;AACvC,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,UAAsC,EAAE,EACvB,EAAE;IACnB,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,IAAI,WAAW,CAAA;IAC/C,MAAM,KAAK,GAAG,CAAC,EAAU,EAAU,EAAE,CAAC,GAAG,MAAM,IAAI,EAAE,EAAE,CAAA;IACvD,OAAO;QACL,IAAI,EAAE,KAAK,EAAE,EAAE,EAA+B,EAAE;YAC9C,MAAM,OAAO,GAAG,UAAU,EAAE,CAAA;YAC5B,IAAI,CAAC,OAAO;gBAAE,OAAO,IAAI,CAAA;YACzB,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAA;YACtC,IAAI,GAAG,KAAK,IAAI;gBAAE,OAAO,IAAI,CAAA;YAC7B,OAAO,WAAW,CAAC,GAAG,CAAC,CAAA;QACzB,CAAC;QACD,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAiB,EAAE;YACrC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAA;YAC5B,IAAI,CAAC,OAAO;gBAAE,OAAM;YACpB,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAA;QAC5C,CAAC;KACF,CAAA;AACH,CAAC,CAAA"}

package/dist/storage/memory.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview In-process storage adapter. Test seam; consumer-facing
+ * use case is "explicitly opt out of persistence."
+ */
+import type { TxFlightStorage } from '../types.js';
+export declare const memoryAdapter: () => TxFlightStorage;
+//# sourceMappingURL=memory.d.ts.map

package/dist/storage/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/storage/memory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElD,eAAO,MAAM,aAAa,QAAO,eAWhC,CAAA"}

package/dist/storage/memory.js

@@ -0,0 +1,17 @@
+/**
+ * @fileoverview In-process storage adapter. Test seam; consumer-facing
+ * use case is "explicitly opt out of persistence."
+ */
+export const memoryAdapter = () => {
+    const data = new Map();
+    return {
+        load: async (id) => {
+            const stored = data.get(id);
+            return stored ? [...stored] : null;
+        },
+        save: async (id, txs) => {
+            data.set(id, [...txs]);
+        },
+    };
+};
+//# sourceMappingURL=memory.js.map

package/dist/storage/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/storage/memory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,CAAC,MAAM,aAAa,GAAG,GAAoB,EAAE;IACjD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAuB,CAAA;IAC3C,OAAO;QACL,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;YACjB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;YAC3B,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;QACpC,CAAC;QACD,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE;YACtB,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAA;QACxB,CAAC;KACF,CAAA;AACH,CAAC,CAAA"}

package/dist/storage/serialize.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview Bigint-safe JSON for TrackedTx persistence.
+ *
+ * `JSON.stringify` rejects bigints. The only bigint fields on a
+ * TrackedTx live under `submittedGas: { maxFeePerGas, maxPriorityFeePerGas }`,
+ * so the serializer narrows there. Hex-string encoding with a `0x`
+ * prefix matches the rest of the toolkit's wire-format convention
+ * (chain-source, gas-oracle).
+ */
+import type { TrackedTx } from '@valve-tech/wallet-adapter';
+export declare const serialize: (txs: readonly TrackedTx[]) => string;
+export declare const deserialize: (raw: string) => TrackedTx[];
+//# sourceMappingURL=serialize.d.ts.map

package/dist/storage/serialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../src/storage/serialize.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAgB,MAAM,4BAA4B,CAAA;AAqBzE,eAAO,MAAM,SAAS,QAAS,SAAS,SAAS,EAAE,KAAG,MAMnD,CAAA;AAEH,eAAO,MAAM,WAAW,QAAS,MAAM,KAAG,SAAS,EAMlD,CAAA"}

package/dist/storage/serialize.js

@@ -0,0 +1,29 @@
+/**
+ * @fileoverview Bigint-safe JSON for TrackedTx persistence.
+ *
+ * `JSON.stringify` rejects bigints. The only bigint fields on a
+ * TrackedTx live under `submittedGas: { maxFeePerGas, maxPriorityFeePerGas }`,
+ * so the serializer narrows there. Hex-string encoding with a `0x`
+ * prefix matches the rest of the toolkit's wire-format convention
+ * (chain-source, gas-oracle).
+ */
+const gasToWire = (gas) => ({
+    maxFeePerGas: '0x' + gas.maxFeePerGas.toString(16),
+    maxPriorityFeePerGas: '0x' + gas.maxPriorityFeePerGas.toString(16),
+});
+const gasFromWire = (gas) => ({
+    maxFeePerGas: BigInt(gas.maxFeePerGas),
+    maxPriorityFeePerGas: BigInt(gas.maxPriorityFeePerGas),
+});
+export const serialize = (txs) => JSON.stringify(txs.map(({ submittedGas, ...rest }) => ({
+    ...rest,
+    ...(submittedGas ? { submittedGas: gasToWire(submittedGas) } : {}),
+})));
+export const deserialize = (raw) => {
+    const parsed = JSON.parse(raw);
+    return parsed.map(({ submittedGas, ...rest }) => ({
+        ...rest,
+        ...(submittedGas ? { submittedGas: gasFromWire(submittedGas) } : {}),
+    }));
+};
+//# sourceMappingURL=serialize.js.map

package/dist/storage/serialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.js","sourceRoot":"","sources":["../../src/storage/serialize.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH,MAAM,SAAS,GAAG,CAAC,GAAiB,EAAiB,EAAE,CAAC,CAAC;IACvD,YAAY,EAAE,IAAI,GAAG,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC;IAClD,oBAAoB,EAAE,IAAI,GAAG,GAAG,CAAC,oBAAoB,CAAC,QAAQ,CAAC,EAAE,CAAC;CACnE,CAAC,CAAA;AAEF,MAAM,WAAW,GAAG,CAAC,GAAkB,EAAgB,EAAE,CAAC,CAAC;IACzD,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC;IACtC,oBAAoB,EAAE,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC;CACvD,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,GAAyB,EAAU,EAAE,CAC7D,IAAI,CAAC,SAAS,CACZ,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,EAAE,GAAG,IAAI,EAAE,EAAuB,EAAE,CAAC,CAAC;IAC3D,GAAG,IAAI;IACP,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,SAAS,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;CACnE,CAAC,CAAC,CACJ,CAAA;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,GAAW,EAAe,EAAE;IACtD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA0B,CAAA;IACvD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,EAAE,GAAG,IAAI,EAAE,EAAa,EAAE,CAAC,CAAC;QAC3D,GAAG,IAAI;QACP,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,WAAW,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrE,CAAC,CAAC,CAAA;AACL,CAAC,CAAA"}

package/dist/store/reducers.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @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.
+ */
+import type { TrackedTx } from '@valve-tech/wallet-adapter';
+import type { InternalState } from '../types.js';
+/**
+ * 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 declare const addReducer: (state: InternalState, tx: TrackedTx, watcher: (() => void) | null) => InternalState;
+/**
+ * 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 declare const updateReducer: (state: InternalState, txId: string, patch: Partial<TrackedTx>, now: number) => InternalState;
+/**
+ * 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 declare const removeReducer: (state: InternalState, txId: string) => InternalState;
+/**
+ * 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 declare const evictReducer: (state: InternalState, opts: {
+    maxItems: number;
+    terminalRetentionMs: number;
+    now: number;
+}) => InternalState;
+//# sourceMappingURL=reducers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reducers.d.ts","sourceRoot":"","sources":["../../src/store/reducers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,4BAA4B,CAAA;AAE5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAqBhD;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,UACd,aAAa,MAChB,SAAS,WACJ,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,KAC3B,aAUF,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,UACjB,aAAa,QACd,MAAM,SACL,OAAO,CAAC,SAAS,CAAC,OACpB,MAAM,KACV,aAUF,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,aAAa,UACjB,aAAa,QACd,MAAM,KACX,aAOF,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,YAAY,UAChB,aAAa,QACd;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,mBAAmB,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,KACnE,aA0CF,CAAA"}