@adobe/data-persistence 0.9.90

package/dist/browser/browser-worker-transport.browser.test.js

@@ -0,0 +1,156 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+//
+// Browser E2E for the worker transport. Uses a real DOM Worker
+// pointing at the bootstrap script, with the OPFS-backed router on
+// the worker side. Vite/Vitest's transformer compiles the .ts worker
+// entry on the fly via `new URL(...)`.
+import { Database } from "@adobe/data/ecs";
+import { F32, Vec3 } from "@adobe/data/math";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { createBrowserWorkerTransport } from "./browser-worker-transport.js";
+import { createWorkerPersistenceService } from "../service/create-worker-persistence-service.js";
+// Helper: build a transport over a freshly-spawned worker. Vite picks
+// up `new Worker(new URL(...), { type: "module" })` and bundles the
+// bootstrap as a separate worker chunk.
+const spawnWorker = () => new Worker(new URL("./browser-worker-bootstrap.ts", import.meta.url), { type: "module" });
+// Each test gets its own clean OPFS root by clearing every entry under
+// the per-origin OPFS directory before the test runs. Vitest browser
+// shares the origin across tests, so without this we'd leak state.
+const wipeOpfs = async () => {
+    if (typeof navigator === "undefined" || !navigator.storage?.getDirectory)
+        return;
+    const root = await navigator.storage.getDirectory();
+    const keys = [];
+    for await (const name of root.keys()) {
+        keys.push(name);
+    }
+    for (const name of keys) {
+        await root.removeEntry(name, { recursive: true });
+    }
+};
+const particlePlugin = Database.Plugin.create({
+    components: {
+        position: Vec3.schema,
+        velocity: Vec3.schema,
+        mass: F32.schema,
+    },
+    archetypes: {
+        Particle: ["position", "velocity", "mass"],
+    },
+    transactions: {
+        spawn(t, args) {
+            return t.archetypes.Particle.insert({
+                position: [args.x, args.y, args.z],
+                velocity: [0, 0, 0],
+                mass: args.mass,
+            });
+        },
+        move(t, args) {
+            t.update(args.entity, { position: [args.x, args.y, args.z] });
+        },
+    },
+});
+describe("createBrowserWorkerTransport (E2E, OPFS)", () => {
+    beforeEach(async () => {
+        await wipeOpfs();
+    });
+    afterEach(async () => {
+        await wipeOpfs();
+    });
+    it("round-trips entities through real Worker + OPFS", async () => {
+        const { createMemoryBackend } = await import("../backend/memory-backend.js");
+        let savedEntity;
+        // Saving phase.
+        {
+            const db = Database.create(particlePlugin);
+            const worker = spawnWorker();
+            const transport = createBrowserWorkerTransport({ worker });
+            // The backend on the main thread is unused at runtime when a
+            // transport is supplied — the worker owns the real OPFS backend.
+            // A memory backend satisfies the type seam.
+            const service = await createWorkerPersistenceService({
+                database: db,
+                backend: createMemoryBackend(),
+                transport,
+                checkpoint: { everyNTransactions: 0, idleMs: 0 },
+            });
+            savedEntity = db.transactions.spawn({ x: 1, y: 2, z: 3, mass: 10 });
+            db.transactions.move({ entity: savedEntity, x: 100, y: 200, z: 300 });
+            await service.flush();
+            await service.checkpoint();
+            await service.dispose();
+            // Caller-owned transport: must close explicitly so the
+            // worker shuts down and releases its OPFS access handles.
+            await transport.close();
+        }
+        // Loading phase: brand-new worker, brand-new database.
+        {
+            const db = Database.create(particlePlugin);
+            const worker = spawnWorker();
+            const transport = createBrowserWorkerTransport({ worker });
+            const service = await createWorkerPersistenceService({
+                database: db,
+                backend: createMemoryBackend(),
+                transport,
+                checkpoint: { everyNTransactions: 0, idleMs: 0 },
+            });
+            await service.load();
+            const view = db.read(savedEntity);
+            expect(view).not.toBeNull();
+            if (view !== null) {
+                expect(Array.from(view.position)).toEqual([100, 200, 300]);
+                expect(Array.from(view.velocity)).toEqual([0, 0, 0]);
+                expect(view.mass).toBe(10);
+            }
+            await service.dispose();
+            await transport.close();
+        }
+    });
+    it("survives multiple inserts and recovers all of them", async () => {
+        const { createMemoryBackend } = await import("../backend/memory-backend.js");
+        const ids = [];
+        {
+            const db = Database.create(particlePlugin);
+            const worker = spawnWorker();
+            const transport = createBrowserWorkerTransport({ worker });
+            const service = await createWorkerPersistenceService({
+                database: db,
+                backend: createMemoryBackend(),
+                transport,
+                checkpoint: { everyNTransactions: 0, idleMs: 0 },
+            });
+            for (let i = 0; i < 10; i++) {
+                const id = db.transactions.spawn({ x: i, y: i * 2, z: i * 3, mass: i * 0.5 });
+                if (id !== undefined)
+                    ids.push(id);
+            }
+            await service.flush();
+            await service.checkpoint();
+            await service.dispose();
+            await transport.close();
+        }
+        {
+            const db = Database.create(particlePlugin);
+            const worker = spawnWorker();
+            const transport = createBrowserWorkerTransport({ worker });
+            const service = await createWorkerPersistenceService({
+                database: db,
+                backend: createMemoryBackend(),
+                transport,
+                checkpoint: { everyNTransactions: 0, idleMs: 0 },
+            });
+            await service.load();
+            for (let i = 0; i < ids.length; i++) {
+                const view = db.read(ids[i]);
+                expect(view).not.toBeNull();
+                if (view !== null) {
+                    expect(Array.from(view.position)).toEqual([i, i * 2, i * 3]);
+                    expect(view.mass).toBe(i * 0.5);
+                }
+            }
+            await service.dispose();
+            await transport.close();
+        }
+    });
+});
+//# sourceMappingURL=browser-worker-transport.browser.test.js.map

package/dist/browser/browser-worker-transport.browser.test.js.map

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

package/dist/browser/browser-worker-transport.d.ts

@@ -0,0 +1,33 @@
+import type { Transport } from "../transport/transport.js";
+/**
+ * Configuration for {@link createBrowserWorkerTransport}. The worker
+ * is constructed by the caller — bundlers (Vite, webpack, esbuild,
+ * Rolldown) all support `new Worker(new URL("./entry.js", import.meta.url), ...)`
+ * and need that pattern present in user code to discover the worker
+ * entry. Passing the worker in keeps this transport bundler-agnostic.
+ *
+ * Example (Vite):
+ *
+ * ```ts
+ * import workerUrl from "@adobe/data-persistence/browser-worker?url";
+ * const worker = new Worker(workerUrl, { type: "module" });
+ * const transport = createBrowserWorkerTransport({ worker });
+ * ```
+ */
+export interface BrowserWorkerTransportOptions {
+    readonly worker: Worker;
+    /**
+     * If true, calling `transport.close()` also calls `worker.terminate()`.
+     * Defaults to true. Set to false when the same worker is shared
+     * across multiple consumers.
+     */
+    readonly terminateOnClose?: boolean;
+}
+/**
+ * Transport that frames the persistence protocol over a DOM Worker.
+ * The worker side must run the bootstrap from this package
+ * (`@adobe/data-persistence/browser-worker`). Bytes-bearing ops
+ * transfer their ArrayBuffer payloads via the postMessage transfer
+ * list for zero-copy hand-off.
+ */
+export declare const createBrowserWorkerTransport: (options: BrowserWorkerTransportOptions) => Transport;

package/dist/browser/browser-worker-transport.js

@@ -0,0 +1,120 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+/**
+ * Transport that frames the persistence protocol over a DOM Worker.
+ * The worker side must run the bootstrap from this package
+ * (`@adobe/data-persistence/browser-worker`). Bytes-bearing ops
+ * transfer their ArrayBuffer payloads via the postMessage transfer
+ * list for zero-copy hand-off.
+ */
+export const createBrowserWorkerTransport = (options) => {
+    const { worker, terminateOnClose = true } = options;
+    const handlers = new Set();
+    const pendingRequests = new Map();
+    let closed = false;
+    let nextSentinelId = 1;
+    worker.addEventListener("message", (ev) => {
+        const msg = ev.data;
+        if (msg.kind === "ack") {
+            const resolver = pendingRequests.get(msg.id);
+            if (resolver !== undefined) {
+                pendingRequests.delete(msg.id);
+                resolver(msg);
+            }
+        }
+        for (const h of handlers)
+            h(msg);
+    });
+    worker.addEventListener("error", (ev) => {
+        // Surface unexpected worker errors as unhandled rejections so they
+        // don't get silently swallowed.
+        queueMicrotask(() => {
+            throw ev.error ?? new Error(ev.message);
+        });
+    });
+    const transferListFor = (op) => {
+        if (op.kind === "writeColumnSlice" || op.kind === "appendJournal") {
+            return [op.bytes];
+        }
+        return [];
+    };
+    // The Transport interface accepts `readonly Transferable[]`, but
+    // Worker.postMessage requires a mutable `Transferable[]`. Copy
+    // (cheap; usually 0 or 1 element) instead of casting.
+    const toMutableTransfer = (list, op) => list === undefined ? transferListFor(op) : [...list];
+    return {
+        send(op, transfer) {
+            if (closed)
+                throw new Error("Transport is closed");
+            worker.postMessage(op, toMutableTransfer(transfer, op));
+        },
+        request(op, transfer) {
+            if (closed)
+                throw new Error("Transport is closed");
+            return new Promise((resolve, reject) => {
+                // The transport's request<T>() generic is a contract
+                // with the caller about the expected reply payload;
+                // there is no way to verify it at runtime, so the
+                // reply is `unknown` until the caller asserts.
+                pendingRequests.set(op.id, (msg) => {
+                    if (msg.error !== undefined)
+                        reject(new Error(msg.error));
+                    else
+                        resolve(msg.value);
+                });
+                worker.postMessage(op, toMutableTransfer(transfer, op));
+            });
+        },
+        onMessage(handler) {
+            handlers.add(handler);
+            return () => handlers.delete(handler);
+        },
+        async flush() {
+            // See node-worker-transport for the sentinel rationale: the
+            // worker processes messages in receive order, so an acked
+            // sentinel implies all earlier sends were also handled.
+            await new Promise((resolve, reject) => {
+                const id = -nextSentinelId;
+                nextSentinelId += 1;
+                pendingRequests.set(id, (msg) => {
+                    if (msg.error !== undefined)
+                        reject(new Error(msg.error));
+                    else
+                        resolve();
+                });
+                worker.postMessage({ id, kind: "listDir", path: "." });
+            });
+        },
+        async close() {
+            if (closed)
+                return;
+            closed = true;
+            // Graceful shutdown: ask the worker to close its router
+            // (which releases all OPFS sync access handles) and wait
+            // for its ack before terminating. Without this wait, OPFS
+            // can still report "Access Handles cannot be created" on
+            // the next test/run because file releases are not yet
+            // visible to the next worker.
+            const id = -nextSentinelId;
+            nextSentinelId += 1;
+            const ackPromise = new Promise((resolve) => {
+                pendingRequests.set(id, () => resolve());
+            });
+            try {
+                worker.postMessage({ kind: "shutdown", id });
+                // Cap the wait so a wedged worker can't hang close().
+                await Promise.race([
+                    ackPromise,
+                    new Promise((resolve) => setTimeout(resolve, 1000)),
+                ]);
+            }
+            catch {
+                // postMessage may throw if the worker is already gone.
+            }
+            handlers.clear();
+            pendingRequests.clear();
+            if (terminateOnClose)
+                worker.terminate();
+        },
+    };
+};
+//# sourceMappingURL=browser-worker-transport.js.map

package/dist/browser/browser-worker-transport.js.map

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

package/dist/browser/create-opfs-provider.d.ts

@@ -0,0 +1,23 @@
+import type { PersistenceProvider } from "../provider/persistence-provider.js";
+/**
+ * Creates a browser persistence provider backed by the Origin Private
+ * File System (OPFS). Always uses a dedicated `Worker` because
+ * `FileSystemSyncAccessHandle` requires a worker context.
+ *
+ * ```ts
+ * import { mount } from "@adobe/data-persistence";
+ * import { createOpfsProvider } from "@adobe/data-persistence/browser";
+ *
+ * const m = await mount(createOpfsProvider(), database);
+ * await m.service.load();
+ * // ...run app...
+ * await m.dispose();
+ * ```
+ *
+ * Pass an explicit `FileSystemDirectoryHandle` to use a subdirectory
+ * instead of the per-origin OPFS root.
+ *
+ * Must be called from the main thread or a shared worker — NOT from
+ * inside a dedicated worker.
+ */
+export declare const createOpfsProvider: (root?: FileSystemDirectoryHandle) => PersistenceProvider;

package/dist/browser/create-opfs-provider.js

@@ -0,0 +1,49 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { createIncrementalPersistenceService } from "../service/create-incremental-persistence-service.js";
+import { createBrowserWorkerTransport } from "./browser-worker-transport.js";
+import { createOpfsBackend } from "./opfs-backend.js";
+/**
+ * Creates a browser persistence provider backed by the Origin Private
+ * File System (OPFS). Always uses a dedicated `Worker` because
+ * `FileSystemSyncAccessHandle` requires a worker context.
+ *
+ * ```ts
+ * import { mount } from "@adobe/data-persistence";
+ * import { createOpfsProvider } from "@adobe/data-persistence/browser";
+ *
+ * const m = await mount(createOpfsProvider(), database);
+ * await m.service.load();
+ * // ...run app...
+ * await m.dispose();
+ * ```
+ *
+ * Pass an explicit `FileSystemDirectoryHandle` to use a subdirectory
+ * instead of the per-origin OPFS root.
+ *
+ * Must be called from the main thread or a shared worker — NOT from
+ * inside a dedicated worker.
+ */
+export const createOpfsProvider = (root) => ({
+    providerName: "OpfsProvider",
+    async mount(database, mountOptions) {
+        const resolvedRoot = root ?? await navigator.storage.getDirectory();
+        const worker = new Worker(new URL("./browser-worker-bootstrap.js", import.meta.url), { type: "module" });
+        const transport = createBrowserWorkerTransport({ worker });
+        const backend = await createOpfsBackend(resolvedRoot);
+        const service = await createIncrementalPersistenceService({
+            database,
+            backend,
+            transport,
+            autoPersist: mountOptions?.autoPersist,
+            checkpoint: mountOptions?.checkpoint,
+        });
+        return {
+            service,
+            async dispose() {
+                await service.dispose();
+                await transport.close();
+            },
+        };
+    },
+});
+//# sourceMappingURL=create-opfs-provider.js.map

package/dist/browser/create-opfs-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-opfs-provider.js","sourceRoot":"","sources":["../../src/browser/create-opfs-provider.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAGvD,OAAO,EAAE,mCAAmC,EAAE,MAAM,sDAAsD,CAAC;AAE3G,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAC9B,IAAgC,EACb,EAAE,CAAC,CAAC;IACvB,YAAY,EAAE,cAAc;IAE5B,KAAK,CAAC,KAAK,CACP,QAA0D,EAC1D,YAAmC;QAEnC,MAAM,YAAY,GAAG,IAAI,IAAI,MAAM,SAAS,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;QAEpE,MAAM,MAAM,GAAG,IAAI,MAAM,CACrB,IAAI,GAAG,CAAC,+BAA+B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EACzD,EAAE,IAAI,EAAE,QAAQ,EAAE,CACrB,CAAC;QAEF,MAAM,SAAS,GAAG,4BAA4B,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAC3D,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,YAAY,CAAC,CAAC;QACtD,MAAM,OAAO,GAAG,MAAM,mCAAmC,CAAC;YACtD,QAAQ;YACR,OAAO;YACP,SAAS;YACT,WAAW,EAAE,YAAY,EAAE,WAAW;YACtC,UAAU,EAAE,YAAY,EAAE,UAAU;SACvC,CAAC,CAAC;QAEH,OAAO;YACH,OAAO;YACP,KAAK,CAAC,OAAO;gBACT,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;gBACxB,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;YAC5B,CAAC;SACJ,CAAC;IACN,CAAC;CACJ,CAAC,CAAC"}

package/dist/browser/index.d.ts

@@ -0,0 +1,6 @@
+export { createOpfsSyncFile } from "./opfs-sync-file.js";
+export { createOpfsBackend } from "./opfs-backend.js";
+export { createBrowserWorkerTransport, type BrowserWorkerTransportOptions, } from "./browser-worker-transport.js";
+export { createOpfsProvider } from "./create-opfs-provider.js";
+/** @deprecated Use `mount(createOpfsProvider(root?), db, opts)` instead. */
+export { mountOpfs } from "./mount-opfs.js";

package/dist/browser/index.js

@@ -0,0 +1,12 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+// Browser-only entry point. Re-exports OPFS-based factories and the
+// browser worker transport. Note that the OPFS factories only function
+// inside a dedicated Worker — main-thread imports are allowed (the
+// factories will throw at call time, not at import).
+export { createOpfsSyncFile } from "./opfs-sync-file.js";
+export { createOpfsBackend } from "./opfs-backend.js";
+export { createBrowserWorkerTransport, } from "./browser-worker-transport.js";
+export { createOpfsProvider } from "./create-opfs-provider.js";
+/** @deprecated Use `mount(createOpfsProvider(root?), db, opts)` instead. */
+export { mountOpfs } from "./mount-opfs.js";
+//# sourceMappingURL=index.js.map

package/dist/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,oEAAoE;AACpE,uEAAuE;AACvE,mEAAmE;AACnE,qDAAqD;AAErD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EACH,4BAA4B,GAE/B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,4EAA4E;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/browser/mount-opfs.d.ts

@@ -0,0 +1,12 @@
+import type { MountOptions, PersistenceMount } from "../service/worker-persistence-service.js";
+/**
+ * @deprecated Use `mount(createOpfsProvider(root?), database, opts)` instead.
+ *
+ * ```ts
+ * import { mount } from "@adobe/data-persistence";
+ * import { createOpfsProvider } from "@adobe/data-persistence/browser";
+ *
+ * const m = await mount(createOpfsProvider(), database);
+ * ```
+ */
+export declare const mountOpfs: (options: Omit<MountOptions<FileSystemDirectoryHandle>, "root"> & Partial<Pick<MountOptions<FileSystemDirectoryHandle>, "root">>) => Promise<PersistenceMount>;

package/dist/browser/mount-opfs.js

@@ -0,0 +1,15 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { mount } from "../provider/mount.js";
+import { createOpfsProvider } from "./create-opfs-provider.js";
+/**
+ * @deprecated Use `mount(createOpfsProvider(root?), database, opts)` instead.
+ *
+ * ```ts
+ * import { mount } from "@adobe/data-persistence";
+ * import { createOpfsProvider } from "@adobe/data-persistence/browser";
+ *
+ * const m = await mount(createOpfsProvider(), database);
+ * ```
+ */
+export const mountOpfs = async (options) => mount(createOpfsProvider(options.root), options.database, { autoPersist: options.autoPersist, checkpoint: options.checkpoint });
+//# sourceMappingURL=mount-opfs.js.map

package/dist/browser/mount-opfs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount-opfs.js","sourceRoot":"","sources":["../../src/browser/mount-opfs.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAGvD,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAC1B,OACkE,EACzC,EAAE,CAC3B,KAAK,CACD,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC,EAChC,OAAO,CAAC,QAAQ,EAChB,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CACvE,CAAC"}

package/dist/browser/opfs-backend-lock.browser.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/browser/opfs-backend-lock.browser.test.js

@@ -0,0 +1,127 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+//
+// Single-writer lock behavior for the OPFS backend. Sync access
+// handles are exclusive per file by spec, so opening one on
+// `lock.json` and holding it gives us mutex semantics that the
+// user-agent automatically releases on worker termination.
+//
+// The OPFS backend can only be constructed inside a dedicated worker
+// (sync access handles are worker-only by spec), so this suite drives
+// a tiny test-only worker bootstrap that wraps acquire / release via
+// postMessage.
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+const spawnLockWorker = () => new Worker(new URL("./opfs-lock-test-worker.ts", import.meta.url), { type: "module" });
+const wrapWorker = (worker) => {
+    let nextId = 1;
+    const pending = new Map();
+    worker.addEventListener("message", (ev) => {
+        const data = ev.data;
+        const resolve = pending.get(data.id);
+        if (resolve !== undefined) {
+            pending.delete(data.id);
+            resolve(data);
+        }
+    });
+    const request = (payload) => {
+        const id = nextId++;
+        return new Promise(resolve => {
+            pending.set(id, resolve);
+            worker.postMessage({ ...payload, id });
+        });
+    };
+    return {
+        async acquire(dirName) {
+            const result = await request({
+                cmd: "acquire",
+                dirName,
+            });
+            return result.cmd === "acquired"
+                ? { ok: true }
+                : { ok: false, error: result.error ?? "unknown" };
+        },
+        async release() {
+            await request({ cmd: "release" });
+        },
+        terminate() {
+            worker.terminate();
+        },
+    };
+};
+const removeIfExists = async (parent, name) => {
+    try {
+        await parent.removeEntry(name, { recursive: true });
+    }
+    catch {
+        // best-effort
+    }
+};
+describe("opfs-backend single-writer lock (in-worker)", () => {
+    let parent;
+    let dirName;
+    const workers = [];
+    beforeEach(async () => {
+        parent = await navigator.storage.getDirectory();
+        dirName = `lock-test-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+    });
+    afterEach(async () => {
+        for (const w of workers) {
+            w.terminate();
+        }
+        workers.length = 0;
+        await removeIfExists(parent, dirName);
+    });
+    it("first worker acquires successfully", async () => {
+        const w = spawnLockWorker();
+        workers.push(w);
+        const wrapped = wrapWorker(w);
+        const r = await wrapped.acquire(dirName);
+        expect(r.ok).toBe(true);
+        await wrapped.release();
+    });
+    it("second worker on the same root fails to acquire while first holds", async () => {
+        const wA = spawnLockWorker();
+        const wB = spawnLockWorker();
+        workers.push(wA, wB);
+        const a = wrapWorker(wA);
+        const b = wrapWorker(wB);
+        const ra = await a.acquire(dirName);
+        expect(ra.ok).toBe(true);
+        const rb = await b.acquire(dirName);
+        expect(rb.ok).toBe(false);
+        if (!rb.ok) {
+            expect(rb.error).toMatch(/lock contended/);
+        }
+        await a.release();
+    });
+    it("a second worker can acquire after the first releases", async () => {
+        const wA = spawnLockWorker();
+        workers.push(wA);
+        const a = wrapWorker(wA);
+        expect((await a.acquire(dirName)).ok).toBe(true);
+        await a.release();
+        const wB = spawnLockWorker();
+        workers.push(wB);
+        const b = wrapWorker(wB);
+        expect((await b.acquire(dirName)).ok).toBe(true);
+        await b.release();
+    });
+    it("a second worker can acquire after the first is terminated (auto-release)", async () => {
+        const wA = spawnLockWorker();
+        workers.push(wA);
+        const a = wrapWorker(wA);
+        expect((await a.acquire(dirName)).ok).toBe(true);
+        // No release call. Just terminate. The OS / user-agent should
+        // tear down the sync access handle on worker shutdown.
+        wA.terminate();
+        // Give the agent a tick to actually release. Browsers do this
+        // synchronously in practice but a yield costs nothing.
+        await new Promise(r => setTimeout(r, 50));
+        const wB = spawnLockWorker();
+        workers.push(wB);
+        const b = wrapWorker(wB);
+        const rb = await b.acquire(dirName);
+        expect(rb.ok).toBe(true);
+        await b.release();
+    });
+});
+//# sourceMappingURL=opfs-backend-lock.browser.test.js.map

package/dist/browser/opfs-backend-lock.browser.test.js.map

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

package/dist/browser/opfs-backend.d.ts

@@ -0,0 +1,6 @@
+import type { PersistenceBackend } from "../backend/persistence-backend.js";
+/**
+ * OPFS backend. Must be constructed inside a dedicated worker because
+ * the underlying RandomAccessFile uses sync access handles.
+ */
+export declare const createOpfsBackend: (root: FileSystemDirectoryHandle) => Promise<PersistenceBackend>;