@lix-js/sdk 0.5.0-preview.0 → 0.5.0

package/dist/environment/opfs-sah.browser.test.js

@@ -0,0 +1,309 @@
+import { openLix } from "../lix/open-lix.js";
+import { test, expect, describe } from "vitest";
+import { OpfsSahEnvironment } from "./opfs-sah.js";
+import { newLixFile } from "../lix/new-lix.js";
+describe.sequential("OPFS SAH Environment (browser)", () => {
+    test("inserting a file", async () => {
+        const lix = await openLix({
+            environment: new OpfsSahEnvironment({}),
+            providePlugins: [],
+        });
+        await lix.db
+            .insertInto("file")
+            .values({
+            path: "/a.txt",
+            data: new TextEncoder().encode("Hello, world!"),
+        })
+            .execute();
+        const row = await lix.db
+            .selectFrom("file")
+            .where("path", "=", "/a.txt")
+            .selectAll()
+            .executeTakeFirst();
+        expect(row).toBeDefined();
+        expect(row?.data).toBeInstanceOf(Uint8Array);
+        expect(new TextDecoder().decode(row?.data)).toBe("Hello, world!");
+        await lix.close();
+    });
+    test("open() does not expose engine on main thread", async () => {
+        const env = new OpfsSahEnvironment({ key: `vitest-opfs-no-engine` });
+        const res = await env.open({
+            boot: { args: { providePlugins: [] } },
+            emit: () => { },
+        });
+        // Worker environment cannot expose an in-process engine; engine must be undefined
+        expect(res.engine).toBeUndefined();
+        await env.close();
+    });
+    test("rejects providePlugins in worker environment", async () => {
+        const env = new OpfsSahEnvironment({ key: "vitest-opfs-reject-provide" });
+        const mockPlugin = { key: "mock-plugin" };
+        await expect(env.open({
+            boot: { args: { providePlugins: [mockPlugin] } },
+            emit: () => { },
+        })).rejects.toThrow(/providePluginsRaw/);
+        await env.close();
+    });
+    test("spawnActor echoes messages", async () => {
+        const env = new OpfsSahEnvironment({ key: `vitest-opfs-actor` });
+        await env.open({ boot: { args: { providePlugins: [] } }, emit: () => { } });
+        const entryModule = new URL("./test-actors/echo.actor.js", import.meta.url)
+            .href;
+        const actor = await env.spawnActor?.({
+            entryModule,
+            name: "echo",
+            initialMessage: { type: "init" },
+        });
+        expect(actor).toBeDefined();
+        const received = [];
+        const unsubscribe = actor?.subscribe((event) => received.push(event));
+        actor?.post({ type: "ping", payload: 1 });
+        await new Promise((resolve) => setTimeout(resolve, 50));
+        expect(received.length).toBeGreaterThan(0);
+        expect(received[0]).toMatchObject({ received: { type: "init" } });
+        const pingEvent = received.find((msg) => msg.received?.type === "ping");
+        expect(pingEvent).toBeDefined();
+        unsubscribe?.();
+        await actor?.terminate();
+        await env.close();
+    });
+    test("open() rejects when another environment uses the same key", async () => {
+        const key = `vitest-opfs-key-lock-${Math.random().toString(16).slice(2)}`;
+        const env1 = new OpfsSahEnvironment({ key });
+        await env1.open({ boot: { args: { providePlugins: [] } }, emit: () => { } });
+        const env2 = new OpfsSahEnvironment({ key });
+        await expect(env2.open({ boot: { args: { providePlugins: [] } }, emit: () => { } })).rejects.toMatchObject({ code: "ENV_OPFS_ALREADY_OPEN" });
+        await env1.close();
+        await env2.close();
+        await new Promise((r) => setTimeout(r, 50));
+        await OpfsSahEnvironment.clear();
+    });
+    test("persists across reopen with same name", async () => {
+        const name = `vitest-opfs-persist`;
+        const lix1 = await openLix({
+            environment: new OpfsSahEnvironment({ key: name }),
+            providePlugins: [],
+        });
+        try {
+            await lix1.db
+                .insertInto("file")
+                .values({
+                path: "/persist.txt",
+                data: new TextEncoder().encode("keep me"),
+            })
+                .execute();
+        }
+        finally {
+            await lix1.close();
+        }
+        // Second open: read the previously written row
+        const lix2 = await openLix({
+            environment: new OpfsSahEnvironment({ key: name }),
+            providePlugins: [],
+        });
+        try {
+            const row = await lix2.db
+                .selectFrom("file")
+                .where("path", "=", "/persist.txt")
+                .selectAll()
+                .executeTakeFirst();
+            expect(row).toBeDefined();
+            expect(new TextDecoder().decode(row?.data)).toBe("keep me");
+        }
+        finally {
+            await lix2.close();
+        }
+    });
+    test("throws when attempting to seed an existing name", async () => {
+        const name = `vitest-opfs-overwrite`;
+        // First open (seeds a new DB)
+        const lix1 = await openLix({
+            environment: new OpfsSahEnvironment({ key: name }),
+            providePlugins: [],
+        });
+        await lix1.close();
+        // Prepare a fresh blob to seed with
+        const fresh = await newLixFile();
+        const blob = await fresh.arrayBuffer();
+        // Use environment.create directly so we can properly close the worker even on error
+        const env = new OpfsSahEnvironment({ key: name });
+        try {
+            await expect(env.create({ blob })).rejects.toThrow(/already exists|refusing to import/i);
+        }
+        finally {
+            await env.close();
+        }
+    });
+    test("clear wipes OPFS contents (browser)", async () => {
+        const name = `vitest-opfs-clear`;
+        // 1) Create a DB and write a row
+        const lix1 = await openLix({
+            environment: new OpfsSahEnvironment({ key: name }),
+            providePlugins: [],
+        });
+        try {
+            await lix1.db
+                .insertInto("file")
+                .values({
+                path: "/temp.txt",
+                data: new TextEncoder().encode("to be wiped"),
+            })
+                .execute();
+        }
+        finally {
+            await lix1.close();
+        }
+        // Give the environment a moment to release any AccessHandles
+        await new Promise((r) => setTimeout(r, 250));
+        // 2) Enumerate OPFS to confirm content exists
+        const rootBefore = await navigator.storage.getDirectory();
+        const entriesBefore = [];
+        // @ts-expect-error - values() exists in modern browsers
+        for await (const entry of rootBefore.values())
+            entriesBefore.push(entry);
+        expect(entriesBefore.length).toBeGreaterThan(0);
+        // 3) Wipe all OPFS data for this origin
+        await OpfsSahEnvironment.clear();
+        // Ensure OPFS has settled
+        await new Promise((r) => setTimeout(r, 100));
+        // 4) Enumerate OPFS again – should be empty
+        const rootAfter = await navigator.storage.getDirectory();
+        const entriesAfter = [];
+        // @ts-expect-error - values() exists in modern browsers
+        for await (const entry of rootAfter.values())
+            entriesAfter.push(entry);
+        expect(entriesAfter.length).toBe(0);
+    });
+    test("clear() throws when an environment is open", async () => {
+        const name = `vitest-opfs-clear-open`;
+        const lix = await openLix({
+            environment: new OpfsSahEnvironment({ key: name }),
+            providePlugins: [],
+        });
+        await lix.db
+            .insertInto("file")
+            .values({ path: "/hold.txt", data: new TextEncoder().encode("x") })
+            .execute();
+        await expect(OpfsSahEnvironment.clear()).rejects.toMatchObject({
+            code: "ENV_OPFS_BUSY",
+        });
+        await lix.close();
+    });
+    test("lix.toBlob exports current database image", async () => {
+        const key = `vitest-opfs-export-${Math.random().toString(16).slice(2)}`;
+        const lix = await openLix({
+            environment: new OpfsSahEnvironment({ key }),
+            providePlugins: [],
+        });
+        try {
+            await lix.db
+                .insertInto("file")
+                .values({
+                path: "/export.txt",
+                data: new TextEncoder().encode("export me"),
+            })
+                .execute();
+            const blob = await lix.toBlob();
+            expect(blob.size).toBeGreaterThan(0);
+            const reopened = await openLix({ blob });
+            try {
+                const row = await reopened.db
+                    .selectFrom("file")
+                    .where("path", "=", "/export.txt")
+                    .selectAll()
+                    .executeTakeFirst();
+                expect(row).toBeDefined();
+                expect(new TextDecoder().decode(row?.data)).toBe("export me");
+            }
+            finally {
+                await reopened.close();
+            }
+        }
+        finally {
+            await lix.close();
+            await OpfsSahEnvironment.clear();
+        }
+    });
+    test("loads plugin from string and processes *.json", async () => {
+        // Minimal mock plugin: matches *.json and emits one change with a simple schema
+        const mockPlugin = `
+export const plugin = {
+  key: 'mock_json',
+  detectChangesGlob: '*.json',
+  detectChanges: ({ after }) => {
+    const schema = { "x-lix-key": "mock_schema", "x-lix-version": "1.0", type: "object", properties: { name: { type: "string" } }, additionalProperties: false };
+    return [{ entity_id: after.id + ':mock', schema, snapshot_content: { name: 'hello' } }];
+  }
+};
+export default plugin;
+`;
+        const lix = await openLix({
+            environment: new OpfsSahEnvironment({ key: `vitest-opfs-plugin` }),
+            providePluginsRaw: [mockPlugin],
+        });
+        try {
+            // Insert a JSON file which should trigger the mock plugin
+            await lix.db
+                .insertInto("file")
+                .values({
+                path: "/foo.json",
+                data: new TextEncoder().encode('{"name":"x"}'),
+            })
+                .execute();
+            // Plugin should have inserted a state row with our mock schema key
+            const row = await lix.db
+                .selectFrom("state_by_version")
+                .selectAll()
+                .where("schema_key", "=", "mock_schema")
+                .executeTakeFirst();
+            expect(row).toBeTruthy();
+            expect(row?.plugin_key).toBe("mock_json");
+        }
+        finally {
+            await lix.close();
+        }
+    });
+    test("persists provided account", async () => {
+        const name = `vitest-opfs-account-persist`;
+        const account = { id: "test-account", name: "Test User" };
+        // Open with initial account
+        const lix1 = await openLix({
+            environment: new OpfsSahEnvironment({ key: name }),
+            providePlugins: [],
+            account,
+        });
+        try {
+            // Verify current active account with details
+            const active1 = await lix1.db
+                .selectFrom("active_account as aa")
+                .innerJoin("account_by_version as a", "a.id", "aa.account_id")
+                .where("a.lixcol_version_id", "=", "global")
+                .select(["aa.account_id", "a.id", "a.name"])
+                .executeTakeFirstOrThrow();
+            expect(active1.account_id).toBe(account.id);
+            expect(active1.name).toBe(account.name);
+        }
+        finally {
+            await lix1.close();
+        }
+        // Reopen the same environment key and verify persistence
+        const lix2 = await openLix({
+            environment: new OpfsSahEnvironment({ key: name }),
+            providePlugins: [],
+        });
+        try {
+            const active2 = await lix2.db
+                .selectFrom("active_account as aa")
+                .innerJoin("account_by_version as a", "a.id", "aa.account_id")
+                .where("a.lixcol_version_id", "=", "global")
+                .select(["aa.account_id", "a.id", "a.name"])
+                .executeTakeFirstOrThrow();
+            expect(active2.account_id).toBe(account.id);
+            expect(active2.name).toBe(account.name);
+        }
+        finally {
+            await lix2.close();
+        }
+    });
+});
+//# sourceMappingURL=opfs-sah.browser.test.js.map

package/dist/environment/opfs-sah.browser.test.js.map

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

package/dist/environment/opfs-sah.d.ts

@@ -0,0 +1,63 @@
+import type { EnvironmentActorHandle, LixEnvironment, SpawnActorOptions } from "./api.js";
+/**
+ * OPFS SAH‑pool environment implemented with a Dedicated Worker.
+ *
+ * Spawns a Worker and forwards calls via a minimal RPC while keeping the
+ * environment async surface. Use one instance per logical database key.
+ * @example
+ * // Static helper: clear all OPFS data for this origin (destructive)
+ * await OpfsSahEnvironment.clear()
+ */
+export declare class OpfsSahEnvironment implements LixEnvironment {
+    private static _instances;
+    private static _openByKey;
+    private worker;
+    private nextId;
+    private inflight;
+    private eventHandler;
+    private readonly dbKey;
+    private isOpen;
+    private actorWorkers;
+    constructor(opts?: {
+        key?: string;
+    });
+    private send;
+    open(initOpts: Parameters<LixEnvironment["open"]>[0]): Promise<{
+        engine?: import("../engine/boot.js").LixEngine;
+    }>;
+    /**
+     * Invoke a named engine function inside the worker engine.
+     */
+    call(name: string, args?: unknown): Promise<unknown>;
+    create(createOpts: Parameters<LixEnvironment["create"]>[0]): Promise<void>;
+    /**
+     * Export the SQLite database image as raw bytes.
+     *
+     * Worker returns one of two shapes for performance:
+     * - Fast path: `{ blob: ArrayBuffer }` (zero‑copy transfer)
+     * - Fallback: `{ buffer, offset, length }` (single copy on host)
+     */
+    export(): Promise<ArrayBuffer>;
+    exists(): Promise<boolean>;
+    close(): Promise<void>;
+    /**
+     * Spawn a dedicated worker-based actor.
+     *
+     * Messages emitted by the worker before any subscribers attach are buffered
+     * and replayed to the first subscriber so initialization events are never lost.
+     *
+     * @example
+     * const actor = await env.spawnActor({ entryModule, name: "echo" });
+     * const unsubscribe = actor.subscribe((message) => console.log(message));
+     * actor.post({ type: "ping" });
+     */
+    spawnActor(opts: SpawnActorOptions): Promise<EnvironmentActorHandle>;
+    /**
+     * Cleans the entire OPFS by removing all files.
+     * Useful for debugging and testing.
+     *
+     * WARNING! This will delete ALL files in OPFS, not just Lix files!
+     */
+    static clear(): Promise<void>;
+}
+//# sourceMappingURL=opfs-sah.d.ts.map

package/dist/environment/opfs-sah.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opfs-sah.d.ts","sourceRoot":"","sources":["../../src/environment/opfs-sah.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,sBAAsB,EACtB,cAAc,EACd,iBAAiB,EACjB,MAAM,UAAU,CAAC;AAElB;;;;;;;;GAQG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IACxD,OAAO,CAAC,MAAM,CAAC,UAAU,CAAiC;IAC1D,OAAO,CAAC,MAAM,CAAC,UAAU,CAAyC;IAClE,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAuC;IACvD,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAAqB;gBAE7B,IAAI,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE;IAoBnC,OAAO,CAAC,IAAI;IAqBN,IAAI,CACT,QAAQ,EAAE,UAAU,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAC7C,OAAO,CAAC;QAAE,MAAM,CAAC,EAAE,OAAO,mBAAmB,EAAE,SAAS,CAAA;KAAE,CAAC;IA0B9D;;OAEG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpD,MAAM,CACX,UAAU,EAAE,UAAU,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GACjD,OAAO,CAAC,IAAI,CAAC;IAQhB;;;;;;OAMG;IACG,MAAM,IAAI,OAAO,CAAC,WAAW,CAAC;IAW9B,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAI1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB5B;;;;;;;;;;OAUG;IACG,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IA6D1E;;;;;OAKG;WACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CA8CnC"}

package/dist/environment/opfs-sah.js

@@ -0,0 +1,240 @@
+/**
+ * OPFS SAH‑pool environment implemented with a Dedicated Worker.
+ *
+ * Spawns a Worker and forwards calls via a minimal RPC while keeping the
+ * environment async surface. Use one instance per logical database key.
+ * @example
+ * // Static helper: clear all OPFS data for this origin (destructive)
+ * await OpfsSahEnvironment.clear()
+ */
+export class OpfsSahEnvironment {
+    static _instances = new Set();
+    static _openByKey = new Map();
+    worker;
+    nextId = 0;
+    inflight = new Map();
+    eventHandler;
+    dbKey;
+    isOpen = false;
+    actorWorkers = new Set();
+    constructor(opts) {
+        this.dbKey = opts?.key || "default";
+        this.worker = new Worker(new URL("./opfs-sah.worker.js", import.meta.url), {
+            type: "module",
+        });
+        OpfsSahEnvironment._instances.add(this);
+        this.worker.onmessage = (ev) => {
+            const msg = ev.data;
+            if (msg && msg.type === "event" && msg.event) {
+                this.eventHandler?.(msg.event);
+                return;
+            }
+            const cb = this.inflight.get(msg?.id);
+            if (cb) {
+                this.inflight.delete(msg.id);
+                cb(msg);
+            }
+        };
+    }
+    send(op, payload, transfer) {
+        const id = String(++this.nextId);
+        return new Promise((resolve, reject) => {
+            this.inflight.set(id, (msg) => {
+                if (msg.ok)
+                    resolve(msg.result);
+                else
+                    reject(Object.assign(new Error(msg.error?.message ?? "Worker error"), msg.error));
+            });
+            this.worker.postMessage({ id, op, payload }, transfer ?? []);
+        });
+    }
+    async open(initOpts) {
+        if (this.isOpen)
+            return {};
+        const existing = OpfsSahEnvironment._openByKey.get(this.dbKey);
+        if (existing && existing !== this) {
+            const err = new Error(`OPFS environment for key "${this.dbKey}" is already open. Close the existing connection before opening a new one.`);
+            err.code = "ENV_OPFS_ALREADY_OPEN";
+            throw err;
+        }
+        this.eventHandler = initOpts.emit;
+        const bootArgs = initOpts.boot.args;
+        if (bootArgs.providePlugins && bootArgs.providePlugins.length > 0) {
+            throw new Error("OpfsSahEnvironment runs in a Worker and cannot receive plugins via providePlugins. Import the plugin source (e.g. with ?raw) and pass it through providePluginsRaw instead.");
+        }
+        const payload = { name: this.dbKey, bootArgs: initOpts.boot.args };
+        await this.send("open", payload);
+        this.isOpen = true;
+        OpfsSahEnvironment._openByKey.set(this.dbKey, this);
+        return {};
+    }
+    /**
+     * Invoke a named engine function inside the worker engine.
+     */
+    async call(name, args) {
+        return this.send("call", { route: name, payload: args });
+    }
+    async create(createOpts) {
+        const payload = {
+            name: this.dbKey,
+            blob: createOpts.blob,
+        };
+        await this.send("create", payload, [createOpts.blob]);
+    }
+    /**
+     * Export the SQLite database image as raw bytes.
+     *
+     * Worker returns one of two shapes for performance:
+     * - Fast path: `{ blob: ArrayBuffer }` (zero‑copy transfer)
+     * - Fallback: `{ buffer, offset, length }` (single copy on host)
+     */
+    async export() {
+        const res = await this.send("export", {});
+        if ("blob" in res)
+            return res.blob;
+        const { buffer, offset, length } = res;
+        if (offset === 0 && length === buffer.byteLength)
+            return buffer;
+        return buffer.slice(offset, offset + length);
+    }
+    async exists() {
+        return this.send("exists", { name: this.dbKey });
+    }
+    async close() {
+        if (this.isOpen) {
+            try {
+                await this.send("close", {});
+            }
+            finally {
+                this.isOpen = false;
+                if (OpfsSahEnvironment._openByKey.get(this.dbKey) === this) {
+                    OpfsSahEnvironment._openByKey.delete(this.dbKey);
+                }
+            }
+        }
+        for (const worker of this.actorWorkers) {
+            worker.terminate();
+        }
+        this.actorWorkers.clear();
+        this.worker.terminate();
+        OpfsSahEnvironment._instances.delete(this);
+        this.eventHandler = undefined;
+    }
+    /**
+     * Spawn a dedicated worker-based actor.
+     *
+     * Messages emitted by the worker before any subscribers attach are buffered
+     * and replayed to the first subscriber so initialization events are never lost.
+     *
+     * @example
+     * const actor = await env.spawnActor({ entryModule, name: "echo" });
+     * const unsubscribe = actor.subscribe((message) => console.log(message));
+     * actor.post({ type: "ping" });
+     */
+    async spawnActor(opts) {
+        const workerUrl = new URL(opts.entryModule, import.meta.url);
+        const actor = new Worker(workerUrl, {
+            type: "module",
+            name: opts.name,
+        });
+        this.actorWorkers.add(actor);
+        const listeners = new Set();
+        const pending = [];
+        const dispatch = (message) => {
+            if (listeners.size === 0) {
+                pending.push(message);
+                return;
+            }
+            for (const listener of listeners)
+                listener(message);
+        };
+        const onMessage = (event) => {
+            dispatch(event.data);
+        };
+        actor.addEventListener("message", onMessage);
+        const handle = {
+            post: (message, transfer) => {
+                if (transfer && transfer.length > 0) {
+                    actor.postMessage(message, transfer);
+                    return;
+                }
+                actor.postMessage(message);
+            },
+            subscribe: (listener) => {
+                listeners.add(listener);
+                if (pending.length > 0) {
+                    const buffered = pending.splice(0, pending.length);
+                    for (const message of buffered) {
+                        listener(message);
+                    }
+                }
+                return () => {
+                    listeners.delete(listener);
+                };
+            },
+            terminate: async () => {
+                this.actorWorkers.delete(actor);
+                actor.removeEventListener("message", onMessage);
+                listeners.clear();
+                pending.length = 0;
+                actor.terminate();
+            },
+        };
+        if (opts.initialMessage !== undefined || (opts.transfer?.length ?? 0) > 0) {
+            if (opts.transfer && opts.transfer.length > 0) {
+                actor.postMessage(opts.initialMessage, opts.transfer);
+            }
+            else {
+                actor.postMessage(opts.initialMessage);
+            }
+        }
+        return handle;
+    }
+    /**
+     * Cleans the entire OPFS by removing all files.
+     * Useful for debugging and testing.
+     *
+     * WARNING! This will delete ALL files in OPFS, not just Lix files!
+     */
+    static async clear() {
+        // Refuse to clear if any environment instances are still open to avoid races
+        if (OpfsSahEnvironment._instances.size > 0) {
+            const err = new Error(`Cannot clear OPFS: ${OpfsSahEnvironment._instances.size} database connection(s) are open. Close all connections before clearing.`);
+            err.code = "ENV_OPFS_BUSY";
+            throw err;
+        }
+        if (typeof navigator === "undefined" || !navigator.storage?.getDirectory) {
+            throw new Error("OPFS not available: navigator.storage.getDirectory() is missing");
+        }
+        const root = await navigator.storage.getDirectory();
+        // Prefer DirectoryHandle.values() if present (not always typed in libdom)
+        const hasValues = typeof root.values === "function";
+        const hasEntries = typeof root.entries === "function";
+        const remove = async (name, kind) => {
+            try {
+                if (kind === "directory") {
+                    await root.removeEntry(name, { recursive: true });
+                }
+                else {
+                    await root.removeEntry(name);
+                }
+            }
+            catch (e) {
+                // Best effort: ignore failures on already-removed entries
+            }
+        };
+        if (hasValues) {
+            for await (const handle of root.values()) {
+                await remove(handle.name, handle.kind);
+            }
+            return;
+        }
+        if (hasEntries) {
+            for await (const [name, handle] of root.entries()) {
+                await remove(name, handle.kind);
+            }
+            return;
+        }
+    }
+}
+//# sourceMappingURL=opfs-sah.js.map

package/dist/environment/opfs-sah.js.map

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

package/dist/environment/opfs-sah.worker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=opfs-sah.worker.d.ts.map

package/dist/environment/opfs-sah.worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opfs-sah.worker.d.ts","sourceRoot":"","sources":["../../src/environment/opfs-sah.worker.ts"],"names":[],"mappings":""}