@metamask-previews/bridge-status-controller 73.1.0-preview-e12e4a38f → 74.0.0-preview-4f9d41d

package/dist/quote-status-manager/quote-status-entry-store.d.cts

@@ -0,0 +1,144 @@
+import { QuoteStatusEntryStoreOptions, QuoteStatusPersistEntry, QuoteStatusRuntimeEntry } from "./types.cjs";
+/**
+ * In-memory store for quote status update entries.
+ *
+ * The store deduplicates entries by key, tracks timestamps used for retries and
+ * TTL eviction, and persists a cloned snapshot on each mutating operation.
+ */
+export declare class QuoteStatusEntryStore {
+    #private;
+    /**
+     * Creates a deterministic key for persisted quote status entries.
+     *
+     * @param entry - Entry identity fields.
+     * @param entry.quoteId - Quote identifier.
+     * @param entry.srcTxHash - Source transaction hash.
+     * @returns Stable key in `${quoteId}:${srcTxHash}` format.
+     */
+    static hash(entry: Pick<QuoteStatusPersistEntry, 'quoteId' | 'srcTxHash'>): string;
+    /**
+     * Creates a quote status entry store.
+     *
+     * @param options - Store dependencies and retention configuration.
+     * @param options.onPersistUpdates - Callback invoked with cloned snapshot updates.
+     * @param options.entryTtlMs - Entry time-to-live in milliseconds.
+     * @param options.initial - Optional initial persisted entries used to seed the store.
+     */
+    constructor({ onPersistUpdates, entryTtlMs, initial, }: QuoteStatusEntryStoreOptions);
+    /**
+     * Adds a new entry when the key is not already present.
+     *
+     * If an entry already exists, only a missing `txMetaId` is backfilled to avoid
+     * resetting timestamps and creating duplicate submission updates.
+     *
+     * @param key - Unique map key for the entry.
+     * @param value - Entry payload without internal timestamps.
+     * @param value.quoteId - Quote identifier.
+     * @param value.srcTxHash - Source transaction hash.
+     * @param value.status - Latest quote status.
+     * @param value.txMetaId - Optional transaction metadata identifier.
+     * @returns The tracked entry (the existing one when the key is already
+     * present, otherwise the newly created entry).
+     */
+    put(key: string, value: Omit<QuoteStatusRuntimeEntry, 'createdAt' | 'lastAttemptAt'>): QuoteStatusRuntimeEntry;
+    /**
+     * Returns an iterator over all tracked entries.
+     *
+     * Stale entries are transitioned to {@link QuoteStatusState.Expired} first (but
+     * kept in the store), so the iterator reflects their up-to-date terminal state.
+     *
+     * @returns An iterator over the currently tracked entries.
+     */
+    values(): IterableIterator<QuoteStatusRuntimeEntry>;
+    /**
+     * Returns every tracked entry matching the provided quote identifier.
+     *
+     * Stale entries are transitioned to {@link QuoteStatusState.Expired} first so
+     * callers observe their up-to-date terminal state.
+     *
+     * @param quoteId - Quote identifier to match.
+     * @returns The matching entries (empty when none exist).
+     */
+    getByQuoteId(quoteId: string): QuoteStatusRuntimeEntry[];
+    /**
+     * Number of entries currently tracked by the store.
+     *
+     * Note that this includes terminal entries (`Completed`/`Expired`), which are
+     * retained rather than evicted; call {@link expireStaleEntries} (or
+     * {@link values}) first when an up-to-date view of entry states is required.
+     *
+     * @returns The count of tracked entries.
+     */
+    get size(): number;
+    /**
+     * Looks up an entry by its transaction metadata identifier.
+     *
+     * If the matching entry has exceeded its TTL it is transitioned to
+     * {@link QuoteStatusState.Expired} (but kept) before being returned.
+     *
+     * @param txMetaId - Transaction metadata identifier to search for.
+     * @returns The matching entry, or `null` if none exists.
+     */
+    getByTxMetaId(txMetaId: string): QuoteStatusRuntimeEntry | null;
+    /**
+     * Retrieves an entry by key.
+     *
+     * If the entry has exceeded its TTL it is transitioned to
+     * {@link QuoteStatusState.Expired} (but kept) before being returned.
+     *
+     * @param key - Unique map key for the entry.
+     * @returns The matching entry, or `null` if absent.
+     */
+    get(key: string): QuoteStatusRuntimeEntry | null;
+    /**
+     * Persists the current snapshot after an in-place mutation of a tracked entry.
+     *
+     * Used when fields such as `lastAttemptAt` are mutated directly on an entry
+     * the caller already holds. No-ops if the entry is no longer tracked (e.g. the
+     * store was cleared in the meantime), so persistence only reflects live entries.
+     *
+     * @param entry - The mutated entry to persist.
+     */
+    update(entry: QuoteStatusRuntimeEntry): void;
+    /**
+     * Transitions every stale entry to {@link QuoteStatusState.Expired}, keeping it
+     * in the store.
+     *
+     * Expired entries are retained so that later interactions with the same quote
+     * (e.g. a duplicate `reportSubmitted`) can be recognized and rejected. Each
+     * transition persists the updated snapshot via the entry's FSM subscription;
+     * already-terminal entries cannot transition and are left untouched.
+     */
+    expireStaleEntries(): void;
+    /**
+     * Determines whether an entry has outlived the configured TTL.
+     *
+     * Expiry is measured from the entry's `createdAt` timestamp, not its last
+     * attempt, so an entry's total lifetime is bounded regardless of retries.
+     *
+     * @param entry - Entry to check.
+     * @returns `true` if the entry's age exceeds the TTL.
+     */
+    entryHasExpired(entry: QuoteStatusRuntimeEntry): boolean;
+    /**
+     * Transitions an entry to {@link QuoteStatusState.Expired} (keeping it) if it
+     * has exceeded its TTL.
+     *
+     * The transition persists the updated snapshot via the entry's FSM
+     * subscription. Already-terminal entries cannot transition and are left
+     * untouched.
+     *
+     * @param entry - Entry to check and possibly expire.
+     * @returns `true` if the entry was stale, otherwise `false`.
+     */
+    expireEntryIfStale(entry: QuoteStatusRuntimeEntry): boolean;
+    /**
+     * Removes every entry from the store.
+     *
+     * Detaches each entry's FSM listeners before clearing to prevent leaks and
+     * stale persist callbacks. Does not emit a persistence update; callers are
+     * expected to use this during teardown.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=quote-status-entry-store.d.cts.map

package/dist/quote-status-manager/quote-status-entry-store.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote-status-entry-store.d.cts","sourceRoot":"","sources":["../../src/quote-status-manager/quote-status-entry-store.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,4BAA4B,EAC5B,uBAAuB,EACvB,uBAAuB,EACxB,oBAAgB;AAEjB;;;;;GAKG;AACH,qBAAa,qBAAqB;;IAKhC;;;;;;;OAOG;IACH,MAAM,CAAC,IAAI,CACT,KAAK,EAAE,IAAI,CAAC,uBAAuB,EAAE,SAAS,GAAG,WAAW,CAAC,GAC5D,MAAM;IAQT;;;;;;;OAOG;gBACS,EACV,gBAAgB,EAChB,UAAU,EACV,OAAO,GACR,EAAE,4BAA4B;IAqC/B;;;;;;;;;;;;;;OAcG;IACH,GAAG,CACD,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,IAAI,CAAC,uBAAuB,EAAE,WAAW,GAAG,eAAe,CAAC,GAClE,uBAAuB;IAyB1B;;;;;;;OAOG;IACH,MAAM,IAAI,gBAAgB,CAAC,uBAAuB,CAAC;IAKnD;;;;;;;;OAQG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,uBAAuB,EAAE;IAaxD;;;;;;;;OAQG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;;;;;OAQG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,uBAAuB,GAAG,IAAI;IAW/D;;;;;;;;OAQG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,uBAAuB,GAAG,IAAI;IAUhD;;;;;;;;OAQG;IACH,MAAM,CAAC,KAAK,EAAE,uBAAuB,GAAG,IAAI;IAuB5C;;;;;;;;OAQG;IACH,kBAAkB,IAAI,IAAI;IAQ1B;;;;;;;;OAQG;IACH,eAAe,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO;IAKxD;;;;;;;;;;OAUG;IACH,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO;IAS3D;;;;;;OAMG;IACH,KAAK,IAAI,IAAI;CAOd"}

package/dist/quote-status-manager/quote-status-entry-store.d.mts

@@ -0,0 +1,144 @@
+import { QuoteStatusEntryStoreOptions, QuoteStatusPersistEntry, QuoteStatusRuntimeEntry } from "./types.mjs";
+/**
+ * In-memory store for quote status update entries.
+ *
+ * The store deduplicates entries by key, tracks timestamps used for retries and
+ * TTL eviction, and persists a cloned snapshot on each mutating operation.
+ */
+export declare class QuoteStatusEntryStore {
+    #private;
+    /**
+     * Creates a deterministic key for persisted quote status entries.
+     *
+     * @param entry - Entry identity fields.
+     * @param entry.quoteId - Quote identifier.
+     * @param entry.srcTxHash - Source transaction hash.
+     * @returns Stable key in `${quoteId}:${srcTxHash}` format.
+     */
+    static hash(entry: Pick<QuoteStatusPersistEntry, 'quoteId' | 'srcTxHash'>): string;
+    /**
+     * Creates a quote status entry store.
+     *
+     * @param options - Store dependencies and retention configuration.
+     * @param options.onPersistUpdates - Callback invoked with cloned snapshot updates.
+     * @param options.entryTtlMs - Entry time-to-live in milliseconds.
+     * @param options.initial - Optional initial persisted entries used to seed the store.
+     */
+    constructor({ onPersistUpdates, entryTtlMs, initial, }: QuoteStatusEntryStoreOptions);
+    /**
+     * Adds a new entry when the key is not already present.
+     *
+     * If an entry already exists, only a missing `txMetaId` is backfilled to avoid
+     * resetting timestamps and creating duplicate submission updates.
+     *
+     * @param key - Unique map key for the entry.
+     * @param value - Entry payload without internal timestamps.
+     * @param value.quoteId - Quote identifier.
+     * @param value.srcTxHash - Source transaction hash.
+     * @param value.status - Latest quote status.
+     * @param value.txMetaId - Optional transaction metadata identifier.
+     * @returns The tracked entry (the existing one when the key is already
+     * present, otherwise the newly created entry).
+     */
+    put(key: string, value: Omit<QuoteStatusRuntimeEntry, 'createdAt' | 'lastAttemptAt'>): QuoteStatusRuntimeEntry;
+    /**
+     * Returns an iterator over all tracked entries.
+     *
+     * Stale entries are transitioned to {@link QuoteStatusState.Expired} first (but
+     * kept in the store), so the iterator reflects their up-to-date terminal state.
+     *
+     * @returns An iterator over the currently tracked entries.
+     */
+    values(): IterableIterator<QuoteStatusRuntimeEntry>;
+    /**
+     * Returns every tracked entry matching the provided quote identifier.
+     *
+     * Stale entries are transitioned to {@link QuoteStatusState.Expired} first so
+     * callers observe their up-to-date terminal state.
+     *
+     * @param quoteId - Quote identifier to match.
+     * @returns The matching entries (empty when none exist).
+     */
+    getByQuoteId(quoteId: string): QuoteStatusRuntimeEntry[];
+    /**
+     * Number of entries currently tracked by the store.
+     *
+     * Note that this includes terminal entries (`Completed`/`Expired`), which are
+     * retained rather than evicted; call {@link expireStaleEntries} (or
+     * {@link values}) first when an up-to-date view of entry states is required.
+     *
+     * @returns The count of tracked entries.
+     */
+    get size(): number;
+    /**
+     * Looks up an entry by its transaction metadata identifier.
+     *
+     * If the matching entry has exceeded its TTL it is transitioned to
+     * {@link QuoteStatusState.Expired} (but kept) before being returned.
+     *
+     * @param txMetaId - Transaction metadata identifier to search for.
+     * @returns The matching entry, or `null` if none exists.
+     */
+    getByTxMetaId(txMetaId: string): QuoteStatusRuntimeEntry | null;
+    /**
+     * Retrieves an entry by key.
+     *
+     * If the entry has exceeded its TTL it is transitioned to
+     * {@link QuoteStatusState.Expired} (but kept) before being returned.
+     *
+     * @param key - Unique map key for the entry.
+     * @returns The matching entry, or `null` if absent.
+     */
+    get(key: string): QuoteStatusRuntimeEntry | null;
+    /**
+     * Persists the current snapshot after an in-place mutation of a tracked entry.
+     *
+     * Used when fields such as `lastAttemptAt` are mutated directly on an entry
+     * the caller already holds. No-ops if the entry is no longer tracked (e.g. the
+     * store was cleared in the meantime), so persistence only reflects live entries.
+     *
+     * @param entry - The mutated entry to persist.
+     */
+    update(entry: QuoteStatusRuntimeEntry): void;
+    /**
+     * Transitions every stale entry to {@link QuoteStatusState.Expired}, keeping it
+     * in the store.
+     *
+     * Expired entries are retained so that later interactions with the same quote
+     * (e.g. a duplicate `reportSubmitted`) can be recognized and rejected. Each
+     * transition persists the updated snapshot via the entry's FSM subscription;
+     * already-terminal entries cannot transition and are left untouched.
+     */
+    expireStaleEntries(): void;
+    /**
+     * Determines whether an entry has outlived the configured TTL.
+     *
+     * Expiry is measured from the entry's `createdAt` timestamp, not its last
+     * attempt, so an entry's total lifetime is bounded regardless of retries.
+     *
+     * @param entry - Entry to check.
+     * @returns `true` if the entry's age exceeds the TTL.
+     */
+    entryHasExpired(entry: QuoteStatusRuntimeEntry): boolean;
+    /**
+     * Transitions an entry to {@link QuoteStatusState.Expired} (keeping it) if it
+     * has exceeded its TTL.
+     *
+     * The transition persists the updated snapshot via the entry's FSM
+     * subscription. Already-terminal entries cannot transition and are left
+     * untouched.
+     *
+     * @param entry - Entry to check and possibly expire.
+     * @returns `true` if the entry was stale, otherwise `false`.
+     */
+    expireEntryIfStale(entry: QuoteStatusRuntimeEntry): boolean;
+    /**
+     * Removes every entry from the store.
+     *
+     * Detaches each entry's FSM listeners before clearing to prevent leaks and
+     * stale persist callbacks. Does not emit a persistence update; callers are
+     * expected to use this during teardown.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=quote-status-entry-store.d.mts.map

package/dist/quote-status-manager/quote-status-entry-store.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote-status-entry-store.d.mts","sourceRoot":"","sources":["../../src/quote-status-manager/quote-status-entry-store.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,4BAA4B,EAC5B,uBAAuB,EACvB,uBAAuB,EACxB,oBAAgB;AAEjB;;;;;GAKG;AACH,qBAAa,qBAAqB;;IAKhC;;;;;;;OAOG;IACH,MAAM,CAAC,IAAI,CACT,KAAK,EAAE,IAAI,CAAC,uBAAuB,EAAE,SAAS,GAAG,WAAW,CAAC,GAC5D,MAAM;IAQT;;;;;;;OAOG;gBACS,EACV,gBAAgB,EAChB,UAAU,EACV,OAAO,GACR,EAAE,4BAA4B;IAqC/B;;;;;;;;;;;;;;OAcG;IACH,GAAG,CACD,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,IAAI,CAAC,uBAAuB,EAAE,WAAW,GAAG,eAAe,CAAC,GAClE,uBAAuB;IAyB1B;;;;;;;OAOG;IACH,MAAM,IAAI,gBAAgB,CAAC,uBAAuB,CAAC;IAKnD;;;;;;;;OAQG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,uBAAuB,EAAE;IAaxD;;;;;;;;OAQG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;;;;;OAQG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,uBAAuB,GAAG,IAAI;IAW/D;;;;;;;;OAQG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,uBAAuB,GAAG,IAAI;IAUhD;;;;;;;;OAQG;IACH,MAAM,CAAC,KAAK,EAAE,uBAAuB,GAAG,IAAI;IAuB5C;;;;;;;;OAQG;IACH,kBAAkB,IAAI,IAAI;IAQ1B;;;;;;;;OAQG;IACH,eAAe,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO;IAKxD;;;;;;;;;;OAUG;IACH,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO;IAS3D;;;;;;OAMG;IACH,KAAK,IAAI,IAAI;CAOd"}

package/dist/quote-status-manager/quote-status-entry-store.mjs

@@ -0,0 +1,267 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _QuoteStatusEntryStore_instances, _QuoteStatusEntryStore_items, _QuoteStatusEntryStore_entryTtlMs, _QuoteStatusEntryStore_onPersistUpdates, _QuoteStatusEntryStore_subscribeToStatusUpdates, _QuoteStatusEntryStore_persistToState;
+import { QuoteStatusState } from "./constants.mjs";
+import { QuoteStatusStateFsm } from "./quote-status-state-fsm.mjs";
+/**
+ * In-memory store for quote status update entries.
+ *
+ * The store deduplicates entries by key, tracks timestamps used for retries and
+ * TTL eviction, and persists a cloned snapshot on each mutating operation.
+ */
+export class QuoteStatusEntryStore {
+    /**
+     * Creates a deterministic key for persisted quote status entries.
+     *
+     * @param entry - Entry identity fields.
+     * @param entry.quoteId - Quote identifier.
+     * @param entry.srcTxHash - Source transaction hash.
+     * @returns Stable key in `${quoteId}:${srcTxHash}` format.
+     */
+    static hash(entry) {
+        return `${entry.quoteId}:${entry.srcTxHash}`;
+    }
+    /**
+     * Creates a quote status entry store.
+     *
+     * @param options - Store dependencies and retention configuration.
+     * @param options.onPersistUpdates - Callback invoked with cloned snapshot updates.
+     * @param options.entryTtlMs - Entry time-to-live in milliseconds.
+     * @param options.initial - Optional initial persisted entries used to seed the store.
+     */
+    constructor({ onPersistUpdates, entryTtlMs, initial, }) {
+        _QuoteStatusEntryStore_instances.add(this);
+        _QuoteStatusEntryStore_items.set(this, void 0);
+        _QuoteStatusEntryStore_entryTtlMs.set(this, void 0);
+        _QuoteStatusEntryStore_onPersistUpdates.set(this, void 0);
+        __classPrivateFieldSet(this, _QuoteStatusEntryStore_onPersistUpdates, onPersistUpdates, "f");
+        __classPrivateFieldSet(this, _QuoteStatusEntryStore_entryTtlMs, entryTtlMs, "f");
+        __classPrivateFieldSet(this, _QuoteStatusEntryStore_items, new Map(Object.entries(initial ?? {}).map(([key, entry]) => {
+            const quoteStatusStateFsm = new QuoteStatusStateFsm(entry.status);
+            return [
+                key,
+                // Entries from `initialDeferredUpdates` come from Immer-managed controller
+                // state, which deep-freezes all nested objects. Cloning each entry here
+                // ensures the in-memory queue holds mutable objects so that mutations
+                // (e.g. updating `status` or `lastAttemptAt`) work correctly without
+                // throwing a "read only property" error.
+                { ...entry, status: quoteStatusStateFsm },
+            ];
+        })), "f");
+        // Subscribe each seeded FSM after the map (and `#onPersistUpdates`) are set
+        // so that any later state transition persists the updated snapshot.
+        for (const entry of __classPrivateFieldGet(this, _QuoteStatusEntryStore_items, "f").values()) {
+            __classPrivateFieldGet(this, _QuoteStatusEntryStore_instances, "m", _QuoteStatusEntryStore_subscribeToStatusUpdates).call(this, entry);
+        }
+    }
+    /**
+     * Adds a new entry when the key is not already present.
+     *
+     * If an entry already exists, only a missing `txMetaId` is backfilled to avoid
+     * resetting timestamps and creating duplicate submission updates.
+     *
+     * @param key - Unique map key for the entry.
+     * @param value - Entry payload without internal timestamps.
+     * @param value.quoteId - Quote identifier.
+     * @param value.srcTxHash - Source transaction hash.
+     * @param value.status - Latest quote status.
+     * @param value.txMetaId - Optional transaction metadata identifier.
+     * @returns The tracked entry (the existing one when the key is already
+     * present, otherwise the newly created entry).
+     */
+    put(key, value) {
+        // If an entry for this key is already in the queue
+        // do not overwrite it. Re-enqueueing would reset state and
+        // could cause duplicate SUBMITTED events.
+        const existing = __classPrivateFieldGet(this, _QuoteStatusEntryStore_items, "f").get(key);
+        if (existing) {
+            if (!existing.txMetaId && value.txMetaId) {
+                existing.txMetaId = value.txMetaId;
+                __classPrivateFieldGet(this, _QuoteStatusEntryStore_instances, "m", _QuoteStatusEntryStore_persistToState).call(this);
+            }
+            return existing;
+        }
+        const now = Date.now();
+        const entry = {
+            ...value,
+            createdAt: now,
+            lastAttemptAt: now,
+        };
+        __classPrivateFieldGet(this, _QuoteStatusEntryStore_items, "f").set(key, entry);
+        __classPrivateFieldGet(this, _QuoteStatusEntryStore_instances, "m", _QuoteStatusEntryStore_subscribeToStatusUpdates).call(this, entry);
+        __classPrivateFieldGet(this, _QuoteStatusEntryStore_instances, "m", _QuoteStatusEntryStore_persistToState).call(this);
+        return entry;
+    }
+    /**
+     * Returns an iterator over all tracked entries.
+     *
+     * Stale entries are transitioned to {@link QuoteStatusState.Expired} first (but
+     * kept in the store), so the iterator reflects their up-to-date terminal state.
+     *
+     * @returns An iterator over the currently tracked entries.
+     */
+    values() {
+        this.expireStaleEntries();
+        return __classPrivateFieldGet(this, _QuoteStatusEntryStore_items, "f").values();
+    }
+    /**
+     * Returns every tracked entry matching the provided quote identifier.
+     *
+     * Stale entries are transitioned to {@link QuoteStatusState.Expired} first so
+     * callers observe their up-to-date terminal state.
+     *
+     * @param quoteId - Quote identifier to match.
+     * @returns The matching entries (empty when none exist).
+     */
+    getByQuoteId(quoteId) {
+        this.expireStaleEntries();
+        const matches = [];
+        for (const entry of __classPrivateFieldGet(this, _QuoteStatusEntryStore_items, "f").values()) {
+            if (entry.quoteId === quoteId) {
+                matches.push(entry);
+            }
+        }
+        return matches;
+    }
+    /**
+     * Number of entries currently tracked by the store.
+     *
+     * Note that this includes terminal entries (`Completed`/`Expired`), which are
+     * retained rather than evicted; call {@link expireStaleEntries} (or
+     * {@link values}) first when an up-to-date view of entry states is required.
+     *
+     * @returns The count of tracked entries.
+     */
+    get size() {
+        return __classPrivateFieldGet(this, _QuoteStatusEntryStore_items, "f").size;
+    }
+    /**
+     * Looks up an entry by its transaction metadata identifier.
+     *
+     * If the matching entry has exceeded its TTL it is transitioned to
+     * {@link QuoteStatusState.Expired} (but kept) before being returned.
+     *
+     * @param txMetaId - Transaction metadata identifier to search for.
+     * @returns The matching entry, or `null` if none exists.
+     */
+    getByTxMetaId(txMetaId) {
+        for (const entry of __classPrivateFieldGet(this, _QuoteStatusEntryStore_items, "f").values()) {
+            if (entry.txMetaId === txMetaId) {
+                this.expireEntryIfStale(entry);
+                return entry;
+            }
+        }
+        return null;
+    }
+    /**
+     * Retrieves an entry by key.
+     *
+     * If the entry has exceeded its TTL it is transitioned to
+     * {@link QuoteStatusState.Expired} (but kept) before being returned.
+     *
+     * @param key - Unique map key for the entry.
+     * @returns The matching entry, or `null` if absent.
+     */
+    get(key) {
+        const entry = __classPrivateFieldGet(this, _QuoteStatusEntryStore_items, "f").get(key);
+        if (!entry) {
+            return null;
+        }
+        this.expireEntryIfStale(entry);
+        return entry;
+    }
+    /**
+     * Persists the current snapshot after an in-place mutation of a tracked entry.
+     *
+     * Used when fields such as `lastAttemptAt` are mutated directly on an entry
+     * the caller already holds. No-ops if the entry is no longer tracked (e.g. the
+     * store was cleared in the meantime), so persistence only reflects live entries.
+     *
+     * @param entry - The mutated entry to persist.
+     */
+    update(entry) {
+        if (!__classPrivateFieldGet(this, _QuoteStatusEntryStore_items, "f").has(QuoteStatusEntryStore.hash(entry))) {
+            return;
+        }
+        __classPrivateFieldGet(this, _QuoteStatusEntryStore_instances, "m", _QuoteStatusEntryStore_persistToState).call(this);
+    }
+    /**
+     * Transitions every stale entry to {@link QuoteStatusState.Expired}, keeping it
+     * in the store.
+     *
+     * Expired entries are retained so that later interactions with the same quote
+     * (e.g. a duplicate `reportSubmitted`) can be recognized and rejected. Each
+     * transition persists the updated snapshot via the entry's FSM subscription;
+     * already-terminal entries cannot transition and are left untouched.
+     */
+    expireStaleEntries() {
+        for (const entry of __classPrivateFieldGet(this, _QuoteStatusEntryStore_items, "f").values()) {
+            if (this.entryHasExpired(entry)) {
+                entry.status.transitionTo(QuoteStatusState.Expired);
+            }
+        }
+    }
+    /**
+     * Determines whether an entry has outlived the configured TTL.
+     *
+     * Expiry is measured from the entry's `createdAt` timestamp, not its last
+     * attempt, so an entry's total lifetime is bounded regardless of retries.
+     *
+     * @param entry - Entry to check.
+     * @returns `true` if the entry's age exceeds the TTL.
+     */
+    entryHasExpired(entry) {
+        const now = Date.now();
+        return now - entry.createdAt > __classPrivateFieldGet(this, _QuoteStatusEntryStore_entryTtlMs, "f");
+    }
+    /**
+     * Transitions an entry to {@link QuoteStatusState.Expired} (keeping it) if it
+     * has exceeded its TTL.
+     *
+     * The transition persists the updated snapshot via the entry's FSM
+     * subscription. Already-terminal entries cannot transition and are left
+     * untouched.
+     *
+     * @param entry - Entry to check and possibly expire.
+     * @returns `true` if the entry was stale, otherwise `false`.
+     */
+    expireEntryIfStale(entry) {
+        if (this.entryHasExpired(entry)) {
+            entry.status.transitionTo(QuoteStatusState.Expired);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Removes every entry from the store.
+     *
+     * Detaches each entry's FSM listeners before clearing to prevent leaks and
+     * stale persist callbacks. Does not emit a persistence update; callers are
+     * expected to use this during teardown.
+     */
+    clear() {
+        for (const entry of __classPrivateFieldGet(this, _QuoteStatusEntryStore_items, "f").values()) {
+            entry.status.removeAllListeners();
+        }
+        __classPrivateFieldGet(this, _QuoteStatusEntryStore_items, "f").clear();
+    }
+}
+_QuoteStatusEntryStore_items = new WeakMap(), _QuoteStatusEntryStore_entryTtlMs = new WeakMap(), _QuoteStatusEntryStore_onPersistUpdates = new WeakMap(), _QuoteStatusEntryStore_instances = new WeakSet(), _QuoteStatusEntryStore_subscribeToStatusUpdates = function _QuoteStatusEntryStore_subscribeToStatusUpdates(entry) {
+    entry.status.onStateUpdate(() => __classPrivateFieldGet(this, _QuoteStatusEntryStore_instances, "m", _QuoteStatusEntryStore_persistToState).call(this));
+}, _QuoteStatusEntryStore_persistToState = function _QuoteStatusEntryStore_persistToState() {
+    const cloned = {};
+    for (const [key, entry] of __classPrivateFieldGet(this, _QuoteStatusEntryStore_items, "f")) {
+        cloned[key] = { ...entry, status: entry.status.state };
+    }
+    __classPrivateFieldGet(this, _QuoteStatusEntryStore_onPersistUpdates, "f").call(this, cloned);
+};
+//# sourceMappingURL=quote-status-entry-store.mjs.map

package/dist/quote-status-manager/quote-status-entry-store.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote-status-entry-store.mjs","sourceRoot":"","sources":["../../src/quote-status-manager/quote-status-entry-store.ts"],"names":[],"mappings":"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","sourcesContent":["import { QuoteStatusState } from './constants';\nimport { QuoteStatusStateFsm } from './quote-status-state-fsm';\nimport {\n  QuoteStatusEntryStoreOptions,\n  QuoteStatusPersistEntry,\n  QuoteStatusRuntimeEntry,\n} from './types';\n\n/**\n * In-memory store for quote status update entries.\n *\n * The store deduplicates entries by key, tracks timestamps used for retries and\n * TTL eviction, and persists a cloned snapshot on each mutating operation.\n */\nexport class QuoteStatusEntryStore {\n  readonly #items: Map<string, QuoteStatusRuntimeEntry>;\n\n  readonly #entryTtlMs: number;\n\n  /**\n   * Creates a deterministic key for persisted quote status entries.\n   *\n   * @param entry - Entry identity fields.\n   * @param entry.quoteId - Quote identifier.\n   * @param entry.srcTxHash - Source transaction hash.\n   * @returns Stable key in `${quoteId}:${srcTxHash}` format.\n   */\n  static hash(\n    entry: Pick<QuoteStatusPersistEntry, 'quoteId' | 'srcTxHash'>,\n  ): string {\n    return `${entry.quoteId}:${entry.srcTxHash}`;\n  }\n\n  readonly #onPersistUpdates: (\n    updates: Record<string, QuoteStatusPersistEntry>,\n  ) => void;\n\n  /**\n   * Creates a quote status entry store.\n   *\n   * @param options - Store dependencies and retention configuration.\n   * @param options.onPersistUpdates - Callback invoked with cloned snapshot updates.\n   * @param options.entryTtlMs - Entry time-to-live in milliseconds.\n   * @param options.initial - Optional initial persisted entries used to seed the store.\n   */\n  constructor({\n    onPersistUpdates,\n    entryTtlMs,\n    initial,\n  }: QuoteStatusEntryStoreOptions) {\n    this.#onPersistUpdates = onPersistUpdates;\n    this.#entryTtlMs = entryTtlMs;\n    this.#items = new Map(\n      Object.entries(initial ?? {}).map(([key, entry]) => {\n        const quoteStatusStateFsm = new QuoteStatusStateFsm(entry.status);\n\n        return [\n          key,\n          // Entries from `initialDeferredUpdates` come from Immer-managed controller\n          // state, which deep-freezes all nested objects. Cloning each entry here\n          // ensures the in-memory queue holds mutable objects so that mutations\n          // (e.g. updating `status` or `lastAttemptAt`) work correctly without\n          // throwing a \"read only property\" error.\n          { ...entry, status: quoteStatusStateFsm },\n        ];\n      }),\n    );\n\n    // Subscribe each seeded FSM after the map (and `#onPersistUpdates`) are set\n    // so that any later state transition persists the updated snapshot.\n    for (const entry of this.#items.values()) {\n      this.#subscribeToStatusUpdates(entry);\n    }\n  }\n\n  /**\n   * Subscribes the entry's FSM so that every state transition persists the\n   * current snapshot. Kept in one place so seeded and runtime-added entries\n   * behave identically.\n   *\n   * @param entry - Entry whose FSM should trigger persistence on transition.\n   */\n  #subscribeToStatusUpdates(entry: QuoteStatusRuntimeEntry): void {\n    entry.status.onStateUpdate(() => this.#persistToState());\n  }\n\n  /**\n   * Adds a new entry when the key is not already present.\n   *\n   * If an entry already exists, only a missing `txMetaId` is backfilled to avoid\n   * resetting timestamps and creating duplicate submission updates.\n   *\n   * @param key - Unique map key for the entry.\n   * @param value - Entry payload without internal timestamps.\n   * @param value.quoteId - Quote identifier.\n   * @param value.srcTxHash - Source transaction hash.\n   * @param value.status - Latest quote status.\n   * @param value.txMetaId - Optional transaction metadata identifier.\n   * @returns The tracked entry (the existing one when the key is already\n   * present, otherwise the newly created entry).\n   */\n  put(\n    key: string,\n    value: Omit<QuoteStatusRuntimeEntry, 'createdAt' | 'lastAttemptAt'>,\n  ): QuoteStatusRuntimeEntry {\n    // If an entry for this key is already in the queue\n    // do not overwrite it. Re-enqueueing would reset state and\n    // could cause duplicate SUBMITTED events.\n    const existing = this.#items.get(key);\n    if (existing) {\n      if (!existing.txMetaId && value.txMetaId) {\n        existing.txMetaId = value.txMetaId;\n        this.#persistToState();\n      }\n      return existing;\n    }\n\n    const now = Date.now();\n    const entry: QuoteStatusRuntimeEntry = {\n      ...value,\n      createdAt: now,\n      lastAttemptAt: now,\n    };\n    this.#items.set(key, entry);\n    this.#subscribeToStatusUpdates(entry);\n    this.#persistToState();\n    return entry;\n  }\n\n  /**\n   * Returns an iterator over all tracked entries.\n   *\n   * Stale entries are transitioned to {@link QuoteStatusState.Expired} first (but\n   * kept in the store), so the iterator reflects their up-to-date terminal state.\n   *\n   * @returns An iterator over the currently tracked entries.\n   */\n  values(): IterableIterator<QuoteStatusRuntimeEntry> {\n    this.expireStaleEntries();\n    return this.#items.values();\n  }\n\n  /**\n   * Returns every tracked entry matching the provided quote identifier.\n   *\n   * Stale entries are transitioned to {@link QuoteStatusState.Expired} first so\n   * callers observe their up-to-date terminal state.\n   *\n   * @param quoteId - Quote identifier to match.\n   * @returns The matching entries (empty when none exist).\n   */\n  getByQuoteId(quoteId: string): QuoteStatusRuntimeEntry[] {\n    this.expireStaleEntries();\n\n    const matches: QuoteStatusRuntimeEntry[] = [];\n    for (const entry of this.#items.values()) {\n      if (entry.quoteId === quoteId) {\n        matches.push(entry);\n      }\n    }\n\n    return matches;\n  }\n\n  /**\n   * Number of entries currently tracked by the store.\n   *\n   * Note that this includes terminal entries (`Completed`/`Expired`), which are\n   * retained rather than evicted; call {@link expireStaleEntries} (or\n   * {@link values}) first when an up-to-date view of entry states is required.\n   *\n   * @returns The count of tracked entries.\n   */\n  get size(): number {\n    return this.#items.size;\n  }\n\n  /**\n   * Looks up an entry by its transaction metadata identifier.\n   *\n   * If the matching entry has exceeded its TTL it is transitioned to\n   * {@link QuoteStatusState.Expired} (but kept) before being returned.\n   *\n   * @param txMetaId - Transaction metadata identifier to search for.\n   * @returns The matching entry, or `null` if none exists.\n   */\n  getByTxMetaId(txMetaId: string): QuoteStatusRuntimeEntry | null {\n    for (const entry of this.#items.values()) {\n      if (entry.txMetaId === txMetaId) {\n        this.expireEntryIfStale(entry);\n        return entry;\n      }\n    }\n\n    return null;\n  }\n\n  /**\n   * Retrieves an entry by key.\n   *\n   * If the entry has exceeded its TTL it is transitioned to\n   * {@link QuoteStatusState.Expired} (but kept) before being returned.\n   *\n   * @param key - Unique map key for the entry.\n   * @returns The matching entry, or `null` if absent.\n   */\n  get(key: string): QuoteStatusRuntimeEntry | null {\n    const entry = this.#items.get(key);\n    if (!entry) {\n      return null;\n    }\n\n    this.expireEntryIfStale(entry);\n    return entry;\n  }\n\n  /**\n   * Persists the current snapshot after an in-place mutation of a tracked entry.\n   *\n   * Used when fields such as `lastAttemptAt` are mutated directly on an entry\n   * the caller already holds. No-ops if the entry is no longer tracked (e.g. the\n   * store was cleared in the meantime), so persistence only reflects live entries.\n   *\n   * @param entry - The mutated entry to persist.\n   */\n  update(entry: QuoteStatusRuntimeEntry): void {\n    if (!this.#items.has(QuoteStatusEntryStore.hash(entry))) {\n      return;\n    }\n\n    this.#persistToState();\n  }\n\n  /**\n   * Emits a cloned, serializable snapshot of all tracked entries via the\n   * `onPersistUpdates` callback.\n   *\n   * Each entry's FSM is flattened to its plain `status` value so the snapshot\n   * contains no class instances and is safe to store in controller state.\n   */\n  #persistToState(): void {\n    const cloned: Record<string, QuoteStatusPersistEntry> = {};\n    for (const [key, entry] of this.#items) {\n      cloned[key] = { ...entry, status: entry.status.state };\n    }\n    this.#onPersistUpdates(cloned);\n  }\n\n  /**\n   * Transitions every stale entry to {@link QuoteStatusState.Expired}, keeping it\n   * in the store.\n   *\n   * Expired entries are retained so that later interactions with the same quote\n   * (e.g. a duplicate `reportSubmitted`) can be recognized and rejected. Each\n   * transition persists the updated snapshot via the entry's FSM subscription;\n   * already-terminal entries cannot transition and are left untouched.\n   */\n  expireStaleEntries(): void {\n    for (const entry of this.#items.values()) {\n      if (this.entryHasExpired(entry)) {\n        entry.status.transitionTo(QuoteStatusState.Expired);\n      }\n    }\n  }\n\n  /**\n   * Determines whether an entry has outlived the configured TTL.\n   *\n   * Expiry is measured from the entry's `createdAt` timestamp, not its last\n   * attempt, so an entry's total lifetime is bounded regardless of retries.\n   *\n   * @param entry - Entry to check.\n   * @returns `true` if the entry's age exceeds the TTL.\n   */\n  entryHasExpired(entry: QuoteStatusRuntimeEntry): boolean {\n    const now = Date.now();\n    return now - entry.createdAt > this.#entryTtlMs;\n  }\n\n  /**\n   * Transitions an entry to {@link QuoteStatusState.Expired} (keeping it) if it\n   * has exceeded its TTL.\n   *\n   * The transition persists the updated snapshot via the entry's FSM\n   * subscription. Already-terminal entries cannot transition and are left\n   * untouched.\n   *\n   * @param entry - Entry to check and possibly expire.\n   * @returns `true` if the entry was stale, otherwise `false`.\n   */\n  expireEntryIfStale(entry: QuoteStatusRuntimeEntry): boolean {\n    if (this.entryHasExpired(entry)) {\n      entry.status.transitionTo(QuoteStatusState.Expired);\n      return true;\n    }\n\n    return false;\n  }\n\n  /**\n   * Removes every entry from the store.\n   *\n   * Detaches each entry's FSM listeners before clearing to prevent leaks and\n   * stale persist callbacks. Does not emit a persistence update; callers are\n   * expected to use this during teardown.\n   */\n  clear(): void {\n    for (const entry of this.#items.values()) {\n      entry.status.removeAllListeners();\n    }\n\n    this.#items.clear();\n  }\n}\n"]}

package/dist/quote-status-manager/quote-status-get-with-retry-outcome.cjs

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QuoteStatusGetWithRetryOutcome = void 0;
+const constants_1 = require("./constants.cjs");
+const errors_1 = require("./errors.cjs");
+/**
+ * Result of a retrying quote status fetch
+ * ({@link QuoteStatusApiService.getQuoteStatusWithRetry}).
+ *
+ * Represents how a fetch attempt resolved so callers can branch on the
+ * outcome without having to re-interpret raw HTTP responses or thrown errors.
+ * The discriminating {@link type} indicates whether the fetch was accepted,
+ * was interrupted, or exhausted its retries. The optional {@link response}
+ * carries the backend quote status payload when the fetch succeeded.
+ */
+class QuoteStatusGetWithRetryOutcome {
+    /**
+     * @param outcome - The outcome type describing how the fetch resolved.
+     * @param response - Optional backend quote status payload when accepted.
+     * @param error - Optional quote status fetch error when the outcome is non-retryable.
+     */
+    constructor(outcome, response, error) {
+        this.type = outcome;
+        this.response = response;
+        this.error = error;
+    }
+}
+exports.QuoteStatusGetWithRetryOutcome = QuoteStatusGetWithRetryOutcome;
+//# sourceMappingURL=quote-status-get-with-retry-outcome.cjs.map

package/dist/quote-status-manager/quote-status-get-with-retry-outcome.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote-status-get-with-retry-outcome.cjs","sourceRoot":"","sources":["../../src/quote-status-manager/quote-status-get-with-retry-outcome.ts"],"names":[],"mappings":";;;AAAA,+CAAmE;AACnE,yCAA+C;AAG/C;;;;;;;;;GASG;AACH,MAAa,8BAA8B;IAczC;;;;OAIG;IACH,YACE,OAA6C,EAC7C,QAAiC,EACjC,KAA2B;QAE3B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC;QACpB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AA5BD,wEA4BC","sourcesContent":["import { QuoteStatusFetchWithRetryOutcomeType } from './constants';\nimport { QuoteStatusGetError } from './errors';\nimport { QuoteStatusGetResponse } from './types';\n\n/**\n * Result of a retrying quote status fetch\n * ({@link QuoteStatusApiService.getQuoteStatusWithRetry}).\n *\n * Represents how a fetch attempt resolved so callers can branch on the\n * outcome without having to re-interpret raw HTTP responses or thrown errors.\n * The discriminating {@link type} indicates whether the fetch was accepted,\n * was interrupted, or exhausted its retries. The optional {@link response}\n * carries the backend quote status payload when the fetch succeeded.\n */\nexport class QuoteStatusGetWithRetryOutcome {\n  /**\n   * Discriminant describing how the fetch attempt resolved.\n   */\n  readonly type: QuoteStatusFetchWithRetryOutcomeType;\n\n  /**\n   * Backend quote status payload when the fetch was accepted\n   * ({@link QuoteStatusFetchWithRetryOutcomeType.Accepted}).\n   */\n  readonly response?: QuoteStatusGetResponse;\n\n  readonly error?: QuoteStatusGetError;\n\n  /**\n   * @param outcome - The outcome type describing how the fetch resolved.\n   * @param response - Optional backend quote status payload when accepted.\n   * @param error - Optional quote status fetch error when the outcome is non-retryable.\n   */\n  constructor(\n    outcome: QuoteStatusFetchWithRetryOutcomeType,\n    response?: QuoteStatusGetResponse,\n    error?: QuoteStatusGetError,\n  ) {\n    this.type = outcome;\n    this.response = response;\n    this.error = error;\n  }\n}\n"]}