@invinite-org/chartlang-host-worker 1.0.1

package/dist/createWorkerHost.js

@@ -0,0 +1,167 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+import { defaultWorkerFactory } from "./defaultWorkerFactory.js";
+import { DEFAULT_LIMITS } from "./limits.js";
+function hasTerminate(w) {
+    return typeof w.terminate === "function";
+}
+function describeWorkerError(ev) {
+    if (typeof ev.message === "string" && ev.message.length > 0)
+        return ev.message;
+    if (ev.error instanceof Error && ev.error.message.length > 0)
+        return ev.error.message;
+    if (typeof ev.error === "string" && ev.error.length > 0)
+        return ev.error;
+    return "unknown worker error";
+}
+/**
+ * Build a browser-default `ScriptHost` around a Web Worker. The host
+ * round-trips `load` / `push` / `drain` / `dispose` calls across the worker
+ * boundary via structured-clone-safe postMessage frames defined in
+ * {@link HostToWorker} / {@link WorkerToHost}.
+ *
+ * The host owns the `nonce` counter for `drain` correlation, the in-flight
+ * `load` promise, and the in-flight drain registry. `dispose` posts the
+ * tear-down message, calls `terminate()` when the underlying `WorkerLike`
+ * supports it, and clears the pending-drain map.
+ *
+ * @since 0.1
+ * @stable
+ * @example
+ *     import { createWorkerHost } from "@invinite-org/chartlang-host-worker";
+ *     // const host = createWorkerHost({ capabilities });
+ *     const fn: typeof createWorkerHost = createWorkerHost;
+ *     void fn;
+ */
+export function createWorkerHost(opts) {
+    const limits = Object.freeze({ ...DEFAULT_LIMITS, ...opts.limits });
+    // The `defaultWorkerFactory` branch is browser-only — tests always inject
+    // `workerLike`. Excluded from coverage to keep the production-only
+    // `new Worker(...)` path uncounted, consistent with the file-level
+    // exclusion of `defaultWorkerFactory.ts` itself.
+    /* v8 ignore next */
+    const worker = opts.workerLike ?? defaultWorkerFactory();
+    let nonceCounter = 0;
+    const pendingDrains = new Map();
+    let loadedResolve = null;
+    let loadedReject = null;
+    let loadTimeoutHandle = null;
+    // Latches the first worker-level error so a subsequent `load()` call
+    // refuses to wait on a dead worker (no `loaded` reply will ever arrive).
+    let fatalError = null;
+    function clearLoadTimeout() {
+        if (loadTimeoutHandle !== null) {
+            clearTimeout(loadTimeoutHandle);
+            loadTimeoutHandle = null;
+        }
+    }
+    function failLoad(err) {
+        clearLoadTimeout();
+        loadedReject?.(err);
+        loadedResolve = null;
+        loadedReject = null;
+    }
+    worker.addEventListener("message", (ev) => {
+        const msg = ev.data;
+        switch (msg.kind) {
+            case "loaded": {
+                clearLoadTimeout();
+                loadedResolve?.();
+                loadedResolve = null;
+                loadedReject = null;
+                break;
+            }
+            case "loadError": {
+                failLoad(new Error(msg.message));
+                break;
+            }
+            case "emissions": {
+                const resolve = pendingDrains.get(msg.nonce);
+                if (resolve !== undefined) {
+                    pendingDrains.delete(msg.nonce);
+                    resolve(msg.emissions);
+                }
+                break;
+            }
+            case "step-overshoot": {
+                opts.onWorkerError?.(`step overshoot ${msg.observedMs.toFixed(2)}ms`);
+                break;
+            }
+            case "fatal": {
+                opts.onWorkerError?.(msg.message);
+                break;
+            }
+        }
+    });
+    // The error channel is fed by browser `Worker`'s `onerror` event.
+    // `MessagePort`-backed fakes accept the subscription silently and never
+    // fire it, which is the right behaviour: a port doesn't have its own
+    // boot/error channel. The cast narrows `addEventListener`'s overload
+    // signature to the error variant.
+    const addErrorListener = worker.addEventListener;
+    addErrorListener("error", (ev) => {
+        const description = describeWorkerError(ev);
+        fatalError = description;
+        const message = `worker failed to boot: ${description}`;
+        failLoad(new Error(message));
+        opts.onWorkerError?.(message);
+    });
+    return Object.freeze({
+        load(compiled) {
+            return new Promise((resolve, reject) => {
+                if (fatalError !== null) {
+                    reject(new Error(`worker failed to boot: ${fatalError}`));
+                    return;
+                }
+                if (loadedResolve !== null) {
+                    reject(new Error("load() already in flight"));
+                    return;
+                }
+                loadedResolve = resolve;
+                loadedReject = reject;
+                loadTimeoutHandle = setTimeout(() => {
+                    failLoad(new Error(`worker load() timed out after ${limits.maxLoadTimeoutMs}ms — worker never replied with 'loaded'`));
+                }, limits.maxLoadTimeoutMs);
+                const frame = {
+                    kind: "load",
+                    compiled: {
+                        moduleSource: compiled.moduleSource,
+                        manifest: compiled.manifest,
+                    },
+                    capabilities: opts.capabilities,
+                    ...(opts.symInfo !== undefined ? { symInfo: opts.symInfo } : {}),
+                    ...(opts.resolveInputs !== undefined
+                        ? { inputOverrides: opts.resolveInputs(compiled.manifest.name) }
+                        : {}),
+                    limits,
+                };
+                worker.postMessage(frame);
+            });
+        },
+        push(event) {
+            const frame = { kind: "candleEvent", event };
+            worker.postMessage(frame);
+            return Promise.resolve();
+        },
+        drain() {
+            const n = nonceCounter;
+            nonceCounter += 1;
+            return new Promise((resolve) => {
+                pendingDrains.set(n, resolve);
+                const frame = { kind: "drain", nonce: n };
+                worker.postMessage(frame);
+            });
+        },
+        dispose() {
+            const frame = { kind: "dispose" };
+            worker.postMessage(frame);
+            if (hasTerminate(worker)) {
+                worker.terminate();
+            }
+            clearLoadTimeout();
+            pendingDrains.clear();
+        },
+        limits,
+    });
+}
+//# sourceMappingURL=createWorkerHost.js.map

package/dist/createWorkerHost.js.map

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

package/dist/defaultWorkerFactory.d.ts

@@ -0,0 +1,19 @@
+import type { WorkerLike } from "./types.js";
+/**
+ * Browser-only fallback when `createWorkerHost` is called without an
+ * explicit `workerLike`. Constructs a real `Worker` against the bundled
+ * `dist/worker-boot.js` sibling. In a real Node test runner `Worker` is not
+ * a global so calling this throws a `ReferenceError`; tests always inject a
+ * `MessageChannel`-backed `WorkerLike` instead, and the coverage test in
+ * `defaultWorkerFactory.test.ts` stubs `globalThis.Worker` to exercise the
+ * construction path.
+ *
+ * @since 0.1
+ * @stable
+ * @example
+ *     // const worker = defaultWorkerFactory();  // browser only
+ *     const fn: typeof defaultWorkerFactory = defaultWorkerFactory;
+ *     void fn;
+ */
+export declare function defaultWorkerFactory(): WorkerLike;
+//# sourceMappingURL=defaultWorkerFactory.d.ts.map

package/dist/defaultWorkerFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultWorkerFactory.d.ts","sourceRoot":"","sources":["../src/defaultWorkerFactory.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,IAAI,UAAU,CAGjD"}

package/dist/defaultWorkerFactory.js

@@ -0,0 +1,23 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+/**
+ * Browser-only fallback when `createWorkerHost` is called without an
+ * explicit `workerLike`. Constructs a real `Worker` against the bundled
+ * `dist/worker-boot.js` sibling. In a real Node test runner `Worker` is not
+ * a global so calling this throws a `ReferenceError`; tests always inject a
+ * `MessageChannel`-backed `WorkerLike` instead, and the coverage test in
+ * `defaultWorkerFactory.test.ts` stubs `globalThis.Worker` to exercise the
+ * construction path.
+ *
+ * @since 0.1
+ * @stable
+ * @example
+ *     // const worker = defaultWorkerFactory();  // browser only
+ *     const fn: typeof defaultWorkerFactory = defaultWorkerFactory;
+ *     void fn;
+ */
+export function defaultWorkerFactory() {
+    const url = new URL("./worker-boot.js", import.meta.url);
+    return new Worker(url, { type: "module" });
+}
+//# sourceMappingURL=defaultWorkerFactory.js.map

package/dist/defaultWorkerFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultWorkerFactory.js","sourceRoot":"","sources":["../src/defaultWorkerFactory.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAI/D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,oBAAoB;IAChC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,kBAAkB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzD,OAAO,IAAI,MAAM,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC/C,CAAC"}

package/dist/filterEmissions.d.ts

@@ -0,0 +1,21 @@
+import { type RunnerEmissions } from "@invinite-org/chartlang-adapter-kit";
+/**
+ * Walk a `RunnerEmissions` snapshot and replace any plot / alert that fails
+ * adapter-kit's `validateEmission` with a `malformed-emission` diagnostic.
+ * Drawings pass through unchanged in Phase 1 (no `draw.*` primitives ship
+ * yet); diagnostics are appended to (never validated against — recursive
+ * validation would loop).
+ *
+ * The boot calls this on every `drain()` before posting `emissions` back to
+ * the host; the trust boundary for the postMessage wire format is here.
+ *
+ * @since 0.1
+ * @stable
+ * @example
+ *     // const out = filterEmissions(runner.drain());
+ *     // postMessage({ kind: "emissions", nonce, emissions: out });
+ *     const fn: typeof filterEmissions = filterEmissions;
+ *     void fn;
+ */
+export declare function filterEmissions(raw: RunnerEmissions): RunnerEmissions;
+//# sourceMappingURL=filterEmissions.d.ts.map

package/dist/filterEmissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterEmissions.d.ts","sourceRoot":"","sources":["../src/filterEmissions.ts"],"names":[],"mappings":"AAGA,OAAO,EAMH,KAAK,eAAe,EAGvB,MAAM,qCAAqC,CAAC;AAE7C;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,eAAe,GAAG,eAAe,CAiFrE"}

package/dist/filterEmissions.js

@@ -0,0 +1,107 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+import { validateEmission, } from "@invinite-org/chartlang-adapter-kit";
+/**
+ * Walk a `RunnerEmissions` snapshot and replace any plot / alert that fails
+ * adapter-kit's `validateEmission` with a `malformed-emission` diagnostic.
+ * Drawings pass through unchanged in Phase 1 (no `draw.*` primitives ship
+ * yet); diagnostics are appended to (never validated against — recursive
+ * validation would loop).
+ *
+ * The boot calls this on every `drain()` before posting `emissions` back to
+ * the host; the trust boundary for the postMessage wire format is here.
+ *
+ * @since 0.1
+ * @stable
+ * @example
+ *     // const out = filterEmissions(runner.drain());
+ *     // postMessage({ kind: "emissions", nonce, emissions: out });
+ *     const fn: typeof filterEmissions = filterEmissions;
+ *     void fn;
+ */
+export function filterEmissions(raw) {
+    const plots = [];
+    const drawings = [];
+    const alerts = [];
+    const alertConditions = [];
+    const logs = [];
+    const diagnostics = [...raw.diagnostics];
+    for (const p of raw.plots) {
+        const r = validateEmission(p);
+        if (r.ok) {
+            plots.push(p);
+        }
+        else {
+            diagnostics.push({
+                kind: "diagnostic",
+                severity: "warning",
+                code: r.code,
+                message: r.message,
+                slotId: p.slotId,
+                bar: p.bar,
+            });
+        }
+    }
+    for (const a of raw.alerts) {
+        const r = validateEmission(a);
+        if (r.ok) {
+            alerts.push(a);
+        }
+        else {
+            diagnostics.push({
+                kind: "diagnostic",
+                severity: "warning",
+                code: r.code,
+                message: r.message,
+                slotId: a.slotId,
+                bar: a.bar,
+            });
+        }
+    }
+    for (const condition of raw.alertConditions) {
+        const r = validateEmission(condition);
+        if (r.ok) {
+            alertConditions.push(condition);
+        }
+        else {
+            diagnostics.push({
+                kind: "diagnostic",
+                severity: "warning",
+                code: r.code,
+                message: r.message,
+                slotId: null,
+                bar: condition.bar,
+            });
+        }
+    }
+    for (const log of raw.logs) {
+        const r = validateEmission(log);
+        if (r.ok) {
+            logs.push(log);
+        }
+        else {
+            diagnostics.push({
+                kind: "diagnostic",
+                severity: "warning",
+                code: r.code,
+                message: r.message,
+                slotId: null,
+                bar: log.bar,
+            });
+        }
+    }
+    for (const d of raw.drawings) {
+        drawings.push(d);
+    }
+    return {
+        plots,
+        drawings,
+        alerts,
+        alertConditions,
+        logs,
+        diagnostics,
+        fromBar: raw.fromBar,
+        toBar: raw.toBar,
+    };
+}
+//# sourceMappingURL=filterEmissions.js.map

package/dist/filterEmissions.js.map

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

package/dist/idb.d.ts

@@ -0,0 +1,2 @@
+export { idbStateStore } from "./idbStateStore.js";
+//# sourceMappingURL=idb.d.ts.map

package/dist/idb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idb.d.ts","sourceRoot":"","sources":["../src/idb.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/idb.js

@@ -0,0 +1,4 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+export { idbStateStore } from "./idbStateStore.js";
+//# sourceMappingURL=idb.js.map

package/dist/idb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idb.js","sourceRoot":"","sources":["../src/idb.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+DAA+D;AAE/D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/idbStateStore.d.ts

@@ -0,0 +1,22 @@
+import type { StateStoreKey } from "@invinite-org/chartlang-core";
+import type { PersistentStateStore } from "@invinite-org/chartlang-runtime";
+/**
+ * IDB-backed {@link PersistentStateStore}. One record per `StateStoreKey`,
+ * capped at `capBytes` total with oldest-first eviction by `snapshot.savedAt`.
+ * Reads on mount, writes on dispose + 60s cadence; the cadence is enforced by
+ * the runtime, not the store. Identity-safe: `load()` returns `null` for any
+ * non-matching key, and `clear()` deletes only this key's record.
+ *
+ * @since 0.5
+ * @stable
+ * @example
+ *     // import { idbStateStore } from "@invinite-org/chartlang-host-worker/idb";
+ *     // const store = idbStateStore({ dbName: "chartlang", key });
+ *     // await store.save(snapshot);
+ */
+export declare function idbStateStore(opts: Readonly<{
+    key: StateStoreKey;
+    dbName?: string;
+    capBytes?: number;
+}>): PersistentStateStore;
+//# sourceMappingURL=idbStateStore.d.ts.map

package/dist/idbStateStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idbStateStore.d.ts","sourceRoot":"","sources":["../src/idbStateStore.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAiB,aAAa,EAAE,MAAM,8BAA8B,CAAC;AACjF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAgB5E;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CACzB,IAAI,EAAE,QAAQ,CAAC;IACX,GAAG,EAAE,aAAa,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC,GACH,oBAAoB,CA2CtB"}

package/dist/idbStateStore.js

@@ -0,0 +1,255 @@
+// Copyright (c) 2026 Invinite. Licensed under the MIT License.
+// See the LICENSE file in the repo root for full license text.
+const DEFAULT_DB_NAME = "chartlang";
+const DEFAULT_CAP_BYTES = 50 * 1024 * 1024;
+const OBJECT_STORE = "chartlangSnapshots";
+const SAVED_AT_INDEX = "savedAt";
+const dbPromises = new Map();
+/**
+ * IDB-backed {@link PersistentStateStore}. One record per `StateStoreKey`,
+ * capped at `capBytes` total with oldest-first eviction by `snapshot.savedAt`.
+ * Reads on mount, writes on dispose + 60s cadence; the cadence is enforced by
+ * the runtime, not the store. Identity-safe: `load()` returns `null` for any
+ * non-matching key, and `clear()` deletes only this key's record.
+ *
+ * @since 0.5
+ * @stable
+ * @example
+ *     // import { idbStateStore } from "@invinite-org/chartlang-host-worker/idb";
+ *     // const store = idbStateStore({ dbName: "chartlang", key });
+ *     // await store.save(snapshot);
+ */
+export function idbStateStore(opts) {
+    const dbName = opts.dbName ?? DEFAULT_DB_NAME;
+    const capBytes = opts.capBytes ?? DEFAULT_CAP_BYTES;
+    const keyString = stringifyKey(opts.key);
+    return Object.freeze({
+        key: opts.key,
+        async load() {
+            const db = await openDb(dbName);
+            const tx = db.transaction(OBJECT_STORE, "readonly");
+            const done = transactionDone(tx);
+            const value = await requestToPromise(tx.objectStore(OBJECT_STORE).get(keyString));
+            await done;
+            return isStoredRecord(value) ? value.snapshot : null;
+        },
+        async save(snapshot) {
+            const db = await openDb(dbName);
+            const tx = db.transaction(OBJECT_STORE, "readwrite");
+            const done = transactionDone(tx);
+            const store = tx.objectStore(OBJECT_STORE);
+            const records = await readAllRecords(store);
+            const nextBytes = estimateSnapshotBytes(snapshot);
+            await evictUntilUnderCap(store, records, keyString, nextBytes, capBytes);
+            await requestToPromise(store.put({
+                keyString,
+                snapshot,
+                bytesEstimate: nextBytes,
+                savedAt: snapshot.savedAt,
+            }));
+            await done;
+        },
+        async clear() {
+            const db = await openDb(dbName);
+            const tx = db.transaction(OBJECT_STORE, "readwrite");
+            const done = transactionDone(tx);
+            await requestToPromise(tx.objectStore(OBJECT_STORE).delete(keyString));
+            await done;
+        },
+    });
+}
+/**
+ * Stable cache-key serialisation for PLAN.md §6.9 `StateStoreKey`.
+ *
+ * @internal
+ */
+function stringifyKey(key) {
+    return JSON.stringify({
+        scriptHash: key.scriptHash,
+        compilerVersion: key.compilerVersion,
+        apiVersion: key.apiVersion,
+        capabilitiesHash: key.capabilitiesHash,
+        symbol: key.symbol,
+        mainInterval: key.mainInterval,
+        requestedIntervals: key.requestedIntervals.join(","),
+    });
+}
+/**
+ * Lazy singleton IDB connection per database name.
+ *
+ * @internal
+ */
+function openDb(dbName) {
+    const existing = dbPromises.get(dbName);
+    if (existing !== undefined)
+        return existing;
+    const promise = new Promise((resolve, reject) => {
+        if (globalThis.indexedDB === undefined) {
+            reject(new Error("indexedDB is not available"));
+            return;
+        }
+        let request;
+        try {
+            request = globalThis.indexedDB.open(dbName, 1);
+        }
+        catch (error) {
+            reject(toError(error, "indexedDB.open failed"));
+            return;
+        }
+        request.onupgradeneeded = () => {
+            const db = request.result;
+            if (!db.objectStoreNames.contains(OBJECT_STORE)) {
+                const store = db.createObjectStore(OBJECT_STORE, { keyPath: "keyString" });
+                store.createIndex(SAVED_AT_INDEX, "savedAt");
+            }
+        };
+        request.onerror = () => {
+            reject(toError(request.error, "indexedDB.open failed"));
+        };
+        request.onblocked = () => {
+            reject(new Error(`indexedDB.open blocked for database "${dbName}"`));
+        };
+        request.onsuccess = () => {
+            const db = request.result;
+            // Drop the cached promise if the connection is closed or another
+            // tab requests a version upgrade, so the next openDb() reopens a
+            // valid connection instead of reusing a dead IDBDatabase.
+            const evict = () => {
+                if (dbPromises.get(dbName) === promise)
+                    dbPromises.delete(dbName);
+            };
+            db.onclose = evict;
+            db.onversionchange = () => {
+                db.close();
+                evict();
+            };
+            resolve(db);
+        };
+    });
+    promise.catch(() => {
+        if (dbPromises.get(dbName) === promise)
+            dbPromises.delete(dbName);
+    });
+    dbPromises.set(dbName, promise);
+    return promise;
+}
+/**
+ * Promise wrapper for one IDB request.
+ *
+ * @internal
+ */
+function requestToPromise(request) {
+    return new Promise((resolve, reject) => {
+        request.onerror = () => {
+            reject(toError(request.error, "IndexedDB request failed"));
+        };
+        request.onsuccess = () => {
+            resolve(request.result);
+        };
+    });
+}
+/**
+ * Resolves only when the whole IDB transaction completes.
+ *
+ * @internal
+ */
+function transactionDone(tx) {
+    return new Promise((resolve, reject) => {
+        tx.onabort = () => {
+            reject(toError(tx.error, "IndexedDB transaction aborted"));
+        };
+        tx.onerror = () => {
+            reject(toError(tx.error, "IndexedDB transaction failed"));
+        };
+        tx.oncomplete = () => {
+            resolve();
+        };
+    });
+}
+/**
+ * Reads all well-formed snapshot records from the store.
+ *
+ * @internal
+ */
+function readAllRecords(store) {
+    return new Promise((resolve, reject) => {
+        const records = [];
+        const request = store.index(SAVED_AT_INDEX).openCursor();
+        request.onerror = () => {
+            reject(toError(request.error, "IndexedDB cursor failed"));
+        };
+        request.onsuccess = () => {
+            const cursor = request.result;
+            if (cursor === null) {
+                resolve(records);
+                return;
+            }
+            if (isStoredRecord(cursor.value))
+                records.push(cursor.value);
+            cursor.continue();
+        };
+    });
+}
+/**
+ * Evicts savedAt-ascending records until the pending write fits the cap.
+ *
+ * @internal
+ */
+async function evictUntilUnderCap(store, records, keyString, nextBytes, capBytes) {
+    let total = 0;
+    const candidates = [];
+    for (const record of records) {
+        if (record.keyString === keyString)
+            continue;
+        total += record.bytesEstimate;
+        candidates.push(record);
+    }
+    candidates.sort((a, b) => a.savedAt - b.savedAt);
+    for (const record of candidates) {
+        if (total + nextBytes <= capBytes)
+            return;
+        await requestToPromise(store.delete(record.keyString));
+        total -= record.bytesEstimate;
+    }
+}
+/**
+ * UTF-16 byte estimate used for best-effort cap accounting.
+ *
+ * @internal
+ */
+function estimateSnapshotBytes(snapshot) {
+    return JSON.stringify(snapshot).length * 2;
+}
+/**
+ * Narrows records read from IDB's untyped structured-clone surface.
+ *
+ * @internal
+ */
+function isStoredRecord(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    if (!("keyString" in value) || typeof value.keyString !== "string")
+        return false;
+    if (!("bytesEstimate" in value) || typeof value.bytesEstimate !== "number")
+        return false;
+    if (!("savedAt" in value) || typeof value.savedAt !== "number")
+        return false;
+    if (!("snapshot" in value))
+        return false;
+    return true;
+}
+/**
+ * Preserves underlying IDB messages on rejection paths.
+ *
+ * @internal
+ */
+function toError(value, fallback) {
+    if (value instanceof DOMException)
+        return new Error(value.message);
+    if (value instanceof Error)
+        return value;
+    if (typeof value === "string")
+        return new Error(value);
+    return new Error(fallback);
+}
+//# sourceMappingURL=idbStateStore.js.map