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

package/dist/lix/open-lix.test.js

@@ -1,20 +1,18 @@
 import { expect, test } from "vitest";
-import { openLixInMemory } from "./open-lix-in-memory.js";
 import { newLixFile } from "./new-lix.js";
-import { toBlob } from "./to-blob.js";
-import { usedFileExtensions } from "./open-lix.js";
+import { openLix, usedFileExtensions } from "./open-lix.js";
 test("providing plugins should be possible", async () => {
     const mockPlugin = {
         key: "mock-plugin",
     };
-    const lix = await openLixInMemory({
+    const lix = await openLix({
         blob: await newLixFile(),
         providePlugins: [mockPlugin],
     });
     expect(await lix.plugin.getAll()).toContain(mockPlugin);
 });
 test("providing key values should be possible", async () => {
-    const lix = await openLixInMemory({
+    const lix = await openLix({
         blob: await newLixFile(),
         keyValues: [{ key: "mock_key", value: "value" }],
     });
@@ -25,8 +23,8 @@ test("providing key values should be possible", async () => {
         .executeTakeFirstOrThrow();
     expect(value).toMatchObject({ key: "mock_key", value: "value" });
     // testing overwriting key values
-    const lix1 = await openLixInMemory({
-        blob: await toBlob({ lix }),
+    const lix1 = await openLix({
+        blob: await lix.toBlob(),
         keyValues: [{ key: "mock_key", value: "value2" }],
     });
     const value1 = await lix1.db
@@ -41,7 +39,7 @@ test("providing an account should be possible", async () => {
         id: "mock-account",
         name: "peter",
     };
-    const lix = await openLixInMemory({
+    const lix = await openLix({
         account: mockAccount,
         blob: await newLixFile(),
     });
@@ -51,22 +49,9 @@ test("providing an account should be possible", async () => {
         .execute();
     expect(accounts, "to be the provided account").toContainEqual(mockAccount);
     expect(accounts, "no other active account is inserted").lengthOf(1);
-    await lix.db
-        .insertInto("key_value")
-        .values([{ key: "mock_key", value: "something" }])
-        .execute();
-    // lix automatically handles inserting the active account into the account table
-    const change = await lix.db
-        .selectFrom("change")
-        .innerJoin("change_author", "change_author.change_id", "change.id")
-        .where("schema_key", "=", "lix_key_value_table")
-        .where("entity_id", "=", "mock_key")
-        .select("change_author.account_id")
-        .executeTakeFirstOrThrow();
-    expect(change.account_id).toBe(mockAccount.id);
 });
 test("usedFileExtensions", async () => {
-    const lix = await openLixInMemory({
+    const lix = await openLix({
         blob: await newLixFile(),
     });
     await lix.db
@@ -89,4 +74,51 @@ test("usedFileExtensions", async () => {
     const extensions = await usedFileExtensions(lix.db);
     expect(new Set(extensions)).toEqual(new Set(["txt", "pdf"]));
 });
+test("it should open a lix in memory from a blob", async () => {
+    const lix1 = await openLix({});
+    await lix1.db
+        .insertInto("file")
+        .values({
+        id: "1",
+        path: "/a.txt",
+        data: new TextEncoder().encode("hello"),
+    })
+        .execute();
+    const lix2 = await openLix({ blob: await lix1.toBlob() });
+    const files = await lix2.db.selectFrom("file").selectAll().execute();
+    expect(files).toEqual([
+        expect.objectContaining({
+            id: "1",
+            path: "/a.txt",
+            data: new TextEncoder().encode("hello"),
+        }),
+    ]);
+});
+test("should default to InMemoryStorage when no storage is provided", async () => {
+    const lix = await openLix({});
+    // Should create a valid lix with new data
+    const lixId = await lix.db
+        .selectFrom("key_value")
+        .select("value")
+        .where("key", "=", "lix_id")
+        .executeTakeFirstOrThrow();
+    expect(lixId.value).toBeDefined();
+    expect(typeof lixId.value).toBe("string");
+    // Should be able to add and query data
+    await lix.db
+        .insertInto("file")
+        .values({
+        id: "test-file",
+        path: "/test.txt",
+        data: new TextEncoder().encode("test content"),
+    })
+        .execute();
+    const files = await lix.db.selectFrom("file").selectAll().execute();
+    expect(files).toHaveLength(1);
+    expect(files[0]).toMatchObject({
+        id: "test-file",
+        path: "/test.txt",
+        data: new TextEncoder().encode("test content"),
+    });
+});
 //# sourceMappingURL=open-lix.test.js.map

package/dist/lix/open-lix.test.js.map

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

package/dist/lix/storage/in-memory.d.ts

@@ -0,0 +1,34 @@
+import { type SqliteWasmDatabase } from "sqlite-wasm-kysely";
+import type { LixStorageAdapter } from "./lix-storage-adapter.js";
+/**
+ * In-memory storage adapter for Lix.
+ *
+ * Data is stored only for the lifetime of the JavaScript context.
+ * When the page is refreshed or the application is closed, all data is lost.
+ */
+export declare class InMemoryStorage implements LixStorageAdapter {
+    private database?;
+    /**
+     * Opens an in-memory SQLite database.
+     *
+     * Creates a new empty lix if this is the first time opening.
+     * Returns the same database instance on subsequent calls.
+     */
+    open(): Promise<SqliteWasmDatabase>;
+    /**
+     * Closes the database connection.
+     *
+     * Note: For in-memory databases, this just clears the reference.
+     * The data is lost when the database is no longer referenced.
+     */
+    close(): Promise<void>;
+    /**
+     * Imports data from a blob, replacing the current database content.
+     */
+    import(blob: Blob): Promise<void>;
+    /**
+     * Exports the current database state as a blob.
+     */
+    export(): Promise<Blob>;
+}
+//# sourceMappingURL=in-memory.d.ts.map

package/dist/lix/storage/in-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory.d.ts","sourceRoot":"","sources":["../../../src/lix/storage/in-memory.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,kBAAkB,EAIvB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE;;;;;GAKG;AACH,qBAAa,eAAgB,YAAW,iBAAiB;IACxD,OAAO,CAAC,QAAQ,CAAC,CAAqB;IAEtC;;;;;OAKG;IACG,IAAI,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAezC;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAQvC;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B"}

package/dist/lix/storage/in-memory.js

@@ -0,0 +1,57 @@
+import { createInMemoryDatabase, importDatabase, contentFromDatabase, } from "sqlite-wasm-kysely";
+import { newLixFile } from "../new-lix.js";
+/**
+ * In-memory storage adapter for Lix.
+ *
+ * Data is stored only for the lifetime of the JavaScript context.
+ * When the page is refreshed or the application is closed, all data is lost.
+ */
+export class InMemoryStorage {
+    database;
+    /**
+     * Opens an in-memory SQLite database.
+     *
+     * Creates a new empty lix if this is the first time opening.
+     * Returns the same database instance on subsequent calls.
+     */
+    async open() {
+        if (!this.database) {
+            this.database = await createInMemoryDatabase({ readOnly: false });
+            // Initialize with new empty lix
+            const blob = await newLixFile();
+            importDatabase({
+                db: this.database,
+                content: new Uint8Array(await blob.arrayBuffer()),
+            });
+        }
+        return this.database;
+    }
+    /**
+     * Closes the database connection.
+     *
+     * Note: For in-memory databases, this just clears the reference.
+     * The data is lost when the database is no longer referenced.
+     */
+    async close() {
+        this.database = undefined;
+    }
+    /**
+     * Imports data from a blob, replacing the current database content.
+     */
+    async import(blob) {
+        const database = await this.open();
+        importDatabase({
+            db: database,
+            content: new Uint8Array(await blob.arrayBuffer()),
+        });
+    }
+    /**
+     * Exports the current database state as a blob.
+     */
+    async export() {
+        const database = await this.open();
+        const content = contentFromDatabase(database);
+        return new Blob([content]);
+    }
+}
+//# sourceMappingURL=in-memory.js.map

package/dist/lix/storage/in-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory.js","sourceRoot":"","sources":["../../../src/lix/storage/in-memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,sBAAsB,EACtB,cAAc,EACd,mBAAmB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C;;;;;GAKG;AACH,MAAM,OAAO,eAAe;IACnB,QAAQ,CAAsB;IAEtC;;;;;OAKG;IACH,KAAK,CAAC,IAAI;QACT,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpB,IAAI,CAAC,QAAQ,GAAG,MAAM,sBAAsB,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;YAElE,gCAAgC;YAChC,MAAM,IAAI,GAAG,MAAM,UAAU,EAAE,CAAC;YAChC,cAAc,CAAC;gBACd,EAAE,EAAE,IAAI,CAAC,QAAQ;gBACjB,OAAO,EAAE,IAAI,UAAU,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;aACjD,CAAC,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC,QAAQ,CAAC;IACtB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,KAAK;QACV,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,IAAU;QACtB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACnC,cAAc,CAAC;YACd,EAAE,EAAE,QAAQ;YACZ,OAAO,EAAE,IAAI,UAAU,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;SACjD,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM;QACX,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QAC9C,OAAO,IAAI,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5B,CAAC;CACD"}

package/dist/lix/storage/in-memory.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=in-memory.test.d.ts.map

package/dist/lix/storage/in-memory.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory.test.d.ts","sourceRoot":"","sources":["../../../src/lix/storage/in-memory.test.ts"],"names":[],"mappings":""}

package/dist/lix/storage/in-memory.test.js

@@ -0,0 +1,146 @@
+import { expect, test } from "vitest";
+import { InMemoryStorage } from "./in-memory.js";
+import { openLix } from "../open-lix.js";
+test("should open a database with new lix on first call", async () => {
+    const storage = new InMemoryStorage();
+    const lix = await openLix({ storage });
+    const lixId = await lix.db
+        .selectFrom("key_value")
+        .select("value")
+        .where("key", "=", "lix_id")
+        .executeTakeFirstOrThrow();
+    expect(lixId.value).toBeDefined();
+    expect(typeof lixId.value).toBe("string");
+});
+test("should return same database instance on subsequent calls", async () => {
+    const storage = new InMemoryStorage();
+    const database1 = await storage.open();
+    const database2 = await storage.open();
+    expect(database1).toBe(database2);
+});
+test("should import blob data, replacing existing content", async () => {
+    const storage = new InMemoryStorage();
+    const lix = await openLix({ storage });
+    // Add some initial data
+    await lix.db
+        .insertInto("file")
+        .values({
+        id: "initial-file",
+        path: "/initial.txt",
+        data: new TextEncoder().encode("initial content"),
+    })
+        .execute();
+    // Create a new lix with different data
+    const originalStorage = new InMemoryStorage();
+    const originalLix = await openLix({ storage: originalStorage });
+    await originalLix.db
+        .insertInto("file")
+        .values({
+        id: "imported-file",
+        path: "/imported.txt",
+        data: new TextEncoder().encode("imported content"),
+    })
+        .execute();
+    const blob = await originalStorage.export();
+    // Import the blob
+    await storage.import(blob);
+    // Check that old data is gone and new data is present
+    const files = await lix.db.selectFrom("file").selectAll().execute();
+    expect(files).toHaveLength(1);
+    expect(files[0]).toMatchObject({
+        id: "imported-file",
+        path: "/imported.txt",
+        data: new TextEncoder().encode("imported content"),
+    });
+});
+test("should export current database state as blob", async () => {
+    const storage = new InMemoryStorage();
+    const lix = await openLix({ storage });
+    // Add some test data
+    await lix.db
+        .insertInto("file")
+        .values({
+        id: "test-file",
+        path: "/test.txt",
+        data: new TextEncoder().encode("test content"),
+    })
+        .execute();
+    const blob = await storage.export();
+    // Create new storage and import the blob
+    const newStorage = new InMemoryStorage();
+    const newLix = await openLix({ storage: newStorage, blob });
+    // Verify the data was exported and imported correctly
+    const files = await newLix.db.selectFrom("file").selectAll().execute();
+    expect(files).toHaveLength(1);
+    expect(files[0]).toMatchObject({
+        id: "test-file",
+        path: "/test.txt",
+        data: new TextEncoder().encode("test content"),
+    });
+});
+test("should close database connection", async () => {
+    const storage = new InMemoryStorage();
+    const database1 = await storage.open();
+    await storage.close();
+    // Opening again should create a new database
+    const database2 = await storage.open();
+    expect(database1).not.toBe(database2);
+});
+test("should handle import before open", async () => {
+    const storage = new InMemoryStorage();
+    // Create a blob with test data
+    const sourceStorage = new InMemoryStorage();
+    const sourceLix = await openLix({ storage: sourceStorage });
+    await sourceLix.db
+        .insertInto("file")
+        .values({
+        id: "test-file",
+        path: "/test.txt",
+        data: new TextEncoder().encode("test content"),
+    })
+        .execute();
+    const blob = await sourceStorage.export();
+    // Import before opening
+    await storage.import(blob);
+    // Now open and verify
+    const lix = await openLix({ storage });
+    const files = await lix.db.selectFrom("file").selectAll().execute();
+    expect(files).toHaveLength(1);
+    expect(files[0]).toMatchObject({
+        id: "test-file",
+        path: "/test.txt",
+    });
+});
+test("should handle export before open", async () => {
+    const storage = new InMemoryStorage();
+    // Export should work even if we haven't opened yet
+    const blob = await storage.export();
+    expect(blob).toBeInstanceOf(Blob);
+    expect(blob.size).toBeGreaterThan(0);
+});
+test("multiple storage instances should be independent", async () => {
+    const storage1 = new InMemoryStorage();
+    const storage2 = new InMemoryStorage();
+    const lix1 = await openLix({ storage: storage1 });
+    const lix2 = await openLix({ storage: storage2 });
+    // Add data to first instance
+    await lix1.db
+        .insertInto("file")
+        .values({
+        id: "file1",
+        path: "/test1.txt",
+        data: new TextEncoder().encode("data1"),
+    })
+        .execute();
+    // Second instance should not have the data
+    const files2 = await lix2.db.selectFrom("file").selectAll().execute();
+    expect(files2).toHaveLength(0);
+    // First instance should still have the data
+    const files1 = await lix1.db.selectFrom("file").selectAll().execute();
+    expect(files1).toHaveLength(1);
+    expect(files1[0]).toMatchObject({
+        id: "file1",
+        path: "/test1.txt",
+    });
+});
+//# sourceMappingURL=in-memory.test.js.map

package/dist/lix/storage/in-memory.test.js.map

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

package/dist/lix/storage/lix-storage-adapter.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Storage adapter interface for Lix.
+ */
+import type { SqliteWasmDatabase } from "sqlite-wasm-kysely";
+export interface LixStorageAdapter {
+    open(): Promise<SqliteWasmDatabase>;
+    close(): Promise<void>;
+    import(blob: Blob): Promise<void>;
+    export(): Promise<Blob>;
+    /**
+     * Called when state commits happen.
+     * Optional method for storage adapters that want to persist on state changes.
+     */
+    onStateCommit?(): void;
+}
+//# sourceMappingURL=lix-storage-adapter.d.ts.map

package/dist/lix/storage/lix-storage-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lix-storage-adapter.d.ts","sourceRoot":"","sources":["../../../src/lix/storage/lix-storage-adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,MAAM,WAAW,iBAAiB;IACjC,IAAI,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB;;;OAGG;IACH,aAAa,CAAC,IAAI,IAAI,CAAC;CACvB"}

package/dist/lix/storage/lix-storage-adapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=lix-storage-adapter.js.map

package/dist/lix/storage/lix-storage-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lix-storage-adapter.js","sourceRoot":"","sources":["../../../src/lix/storage/lix-storage-adapter.ts"],"names":[],"mappings":""}

package/dist/lix/storage/opfs.d.ts

@@ -0,0 +1,66 @@
+import { type SqliteWasmDatabase } from "sqlite-wasm-kysely";
+import type { LixStorageAdapter } from "./lix-storage-adapter.js";
+/**
+ * OPFS (Origin Private File System) storage adapter for Lix.
+ *
+ * Provides persistent storage in the browser using the Origin Private File System API.
+ * Data persists across browser sessions and page refreshes.
+ *
+ * Features auto-saving functionality when integrated with the hooks system.
+ */
+export declare class OpfsStorage implements LixStorageAdapter {
+    private database?;
+    private readonly path;
+    private opfsRoot?;
+    private savePromise?;
+    private pendingSave;
+    /**
+     * Creates a new OpfsStorage instance.
+     *
+     * @param args.path - Path/name of the file to store in OPFS
+     */
+    constructor(args: {
+        path: string;
+    });
+    /**
+     * Opens a database with OPFS persistence.
+     *
+     * Loads existing data from OPFS if available, otherwise creates a new lix.
+     * Returns the same database instance on subsequent calls.
+     */
+    open(): Promise<SqliteWasmDatabase>;
+    /**
+     * Closes the database connection.
+     *
+     * Performs a final save to OPFS before closing.
+     */
+    close(): Promise<void>;
+    /**
+     * Imports data from a blob, replacing the current database content.
+     *
+     * Also saves the imported data to OPFS.
+     */
+    import(blob: Blob): Promise<void>;
+    /**
+     * Exports the current database state as a blob.
+     */
+    export(): Promise<Blob>;
+    /**
+     * Saves the current database state to OPFS.
+     *
+     * This method is called automatically during import/close,
+     * and can be called manually or triggered by the hooks system.
+     */
+    private save;
+    /**
+     * Called when state commits happen.
+     * Automatically saves the current state to OPFS.
+     */
+    onStateCommit(): void;
+    /**
+     * Batches save operations to avoid multiple concurrent saves.
+     * Only one save operation will run at a time, with the latest state.
+     */
+    private batchedSave;
+}
+//# sourceMappingURL=opfs.d.ts.map

package/dist/lix/storage/opfs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opfs.d.ts","sourceRoot":"","sources":["../../../src/lix/storage/opfs.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,kBAAkB,EAIvB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE;;;;;;;GAOG;AACH,qBAAa,WAAY,YAAW,iBAAiB;IACpD,OAAO,CAAC,QAAQ,CAAC,CAAqB;IACtC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,CAA4B;IAC7C,OAAO,CAAC,WAAW,CAAC,CAAgB;IACpC,OAAO,CAAC,WAAW,CAAS;IAE5B;;;;OAIG;gBACS,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;IAalC;;;;;OAKG;IACG,IAAI,IAAI,OAAO,CAAC,kBAAkB,CAAC;IA+BzC;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B;;;;OAIG;IACG,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAWvC;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAM7B;;;;;OAKG;YACW,IAAI;IAelB;;;OAGG;IACH,aAAa,IAAI,IAAI;IAIrB;;;OAGG;IACH,OAAO,CAAC,WAAW;CAyBnB"}

package/dist/lix/storage/opfs.js

@@ -0,0 +1,152 @@
+import { createInMemoryDatabase, importDatabase, contentFromDatabase, } from "sqlite-wasm-kysely";
+import { newLixFile } from "../new-lix.js";
+/**
+ * OPFS (Origin Private File System) storage adapter for Lix.
+ *
+ * Provides persistent storage in the browser using the Origin Private File System API.
+ * Data persists across browser sessions and page refreshes.
+ *
+ * Features auto-saving functionality when integrated with the hooks system.
+ */
+export class OpfsStorage {
+    database;
+    path;
+    opfsRoot;
+    savePromise;
+    pendingSave = false;
+    /**
+     * Creates a new OpfsStorage instance.
+     *
+     * @param args.path - Path/name of the file to store in OPFS
+     */
+    constructor(args) {
+        // Check if OPFS is supported
+        if (!("navigator" in globalThis) ||
+            !("storage" in navigator) ||
+            !("getDirectory" in navigator.storage)) {
+            throw new Error("OPFS is not supported in this environment");
+        }
+        this.path = args.path;
+    }
+    /**
+     * Opens a database with OPFS persistence.
+     *
+     * Loads existing data from OPFS if available, otherwise creates a new lix.
+     * Returns the same database instance on subsequent calls.
+     */
+    async open() {
+        if (!this.database) {
+            this.database = await createInMemoryDatabase({ readOnly: false });
+            this.opfsRoot = await navigator.storage.getDirectory();
+            try {
+                // Try to load existing data from OPFS
+                const fileHandle = await this.opfsRoot.getFileHandle(this.path);
+                const file = await fileHandle.getFile();
+                const content = new Uint8Array(await file.arrayBuffer());
+                importDatabase({
+                    db: this.database,
+                    content,
+                });
+            }
+            catch {
+                // File doesn't exist, create new empty lix
+                const blob = await newLixFile();
+                importDatabase({
+                    db: this.database,
+                    content: new Uint8Array(await blob.arrayBuffer()),
+                });
+                // Save the initial state to OPFS
+                await this.save();
+            }
+        }
+        return this.database;
+    }
+    /**
+     * Closes the database connection.
+     *
+     * Performs a final save to OPFS before closing.
+     */
+    async close() {
+        if (this.database) {
+            await this.save();
+            this.database = undefined;
+        }
+    }
+    /**
+     * Imports data from a blob, replacing the current database content.
+     *
+     * Also saves the imported data to OPFS.
+     */
+    async import(blob) {
+        const database = await this.open();
+        importDatabase({
+            db: database,
+            content: new Uint8Array(await blob.arrayBuffer()),
+        });
+        // Save the imported data to OPFS
+        await this.save();
+    }
+    /**
+     * Exports the current database state as a blob.
+     */
+    async export() {
+        const database = await this.open();
+        const content = contentFromDatabase(database);
+        return new Blob([content]);
+    }
+    /**
+     * Saves the current database state to OPFS.
+     *
+     * This method is called automatically during import/close,
+     * and can be called manually or triggered by the hooks system.
+     */
+    async save() {
+        if (!this.database || !this.opfsRoot) {
+            return;
+        }
+        const content = contentFromDatabase(this.database);
+        const fileHandle = await this.opfsRoot.getFileHandle(this.path, {
+            create: true,
+        });
+        const writable = await fileHandle.createWritable();
+        await writable.write(content);
+        await writable.close();
+    }
+    /**
+     * Called when state commits happen.
+     * Automatically saves the current state to OPFS.
+     */
+    onStateCommit() {
+        this.batchedSave();
+    }
+    /**
+     * Batches save operations to avoid multiple concurrent saves.
+     * Only one save operation will run at a time, with the latest state.
+     */
+    batchedSave() {
+        if (this.savePromise) {
+            // Save is already in progress, mark that another save is needed
+            this.pendingSave = true;
+            return;
+        }
+        this.savePromise = this.save()
+            .then(() => {
+            // Check if another save was requested while this one was running
+            if (this.pendingSave) {
+                this.pendingSave = false;
+                this.savePromise = undefined;
+                // Recursively call to handle the pending save
+                this.batchedSave();
+            }
+            else {
+                this.savePromise = undefined;
+            }
+        })
+            .catch((error) => {
+            console.error("Error saving to OPFS:", error);
+            this.savePromise = undefined;
+            this.pendingSave = false;
+        });
+    }
+}
+//# sourceMappingURL=opfs.js.map