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

package/dist/lix/storage/opfs.js.map

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

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

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

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

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

package/dist/lix/storage/opfs.test.js

@@ -0,0 +1,171 @@
+import { test, expect, describe, beforeEach, vi } from "vitest";
+import { OpfsStorage } from "./opfs.js";
+import { openLix } from "../open-lix.js";
+import { InMemoryStorage } from "./in-memory.js";
+// Create a realistic in-memory OPFS mock
+class MockOPFS {
+    files = new Map();
+    createMockOpfsRoot() {
+        return {
+            getFileHandle: vi
+                .fn()
+                .mockImplementation((filename, options) => {
+                if (!this.files.has(filename) && !options?.create) {
+                    throw new Error("File not found");
+                }
+                return this.createMockFileHandle(filename);
+            }),
+        };
+    }
+    createMockFileHandle(filename) {
+        return {
+            getFile: vi.fn().mockImplementation(() => {
+                const data = this.files.get(filename) || new Uint8Array(0);
+                return Promise.resolve({
+                    arrayBuffer: vi.fn().mockResolvedValue(data.buffer),
+                });
+            }),
+            createWritable: vi.fn().mockImplementation(() => {
+                return Promise.resolve(this.createMockWritable(filename));
+            }),
+        };
+    }
+    createMockWritable(filename) {
+        let buffer = new Uint8Array(0);
+        return {
+            write: vi.fn().mockImplementation((data) => {
+                buffer = new Uint8Array(data);
+                return Promise.resolve();
+            }),
+            close: vi.fn().mockImplementation(() => {
+                this.files.set(filename, buffer);
+                return Promise.resolve();
+            }),
+        };
+    }
+}
+describe("OpfsStorage", () => {
+    let mockOpfs;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        mockOpfs = new MockOPFS();
+        // Setup OPFS mock
+        Object.defineProperty(globalThis, "navigator", {
+            value: {
+                storage: {
+                    getDirectory: vi
+                        .fn()
+                        .mockResolvedValue(mockOpfs.createMockOpfsRoot()),
+                },
+            },
+            writable: true,
+        });
+    });
+    test("constructor requires path argument", () => {
+        expect(() => new OpfsStorage({ path: "test.db" })).not.toThrow();
+    });
+    test("throws error if OPFS is not supported", () => {
+        // Remove navigator to simulate unsupported environment
+        const originalNavigator = globalThis.navigator;
+        delete globalThis.navigator;
+        expect(() => new OpfsStorage({ path: "test.db" })).toThrow("OPFS is not supported in this environment");
+        // Restore navigator
+        globalThis.navigator = originalNavigator;
+    });
+    test("creates new lix file when OPFS file doesn't exist", async () => {
+        const storage = new OpfsStorage({ path: "new.db" });
+        const lix = await openLix({ storage });
+        expect(lix.db).toBeDefined();
+        expect(lix.sqlite).toBeDefined();
+    });
+    test("returns same database instance on multiple open calls", async () => {
+        const storage = new OpfsStorage({ path: "test.db" });
+        const db1 = await storage.open();
+        const db2 = await storage.open();
+        expect(db1).toBe(db2);
+    });
+    test("saves database on close", async () => {
+        const storage = new OpfsStorage({ path: "test.db" });
+        await openLix({ storage });
+        // This should not throw
+        await expect(storage.close()).resolves.not.toThrow();
+    });
+    test("imports lix file blob and saves to OPFS", async () => {
+        const storage = new OpfsStorage({ path: "test.db" });
+        const sourceLix = await openLix({ storage: new InMemoryStorage() });
+        // Add some data to the source
+        await sourceLix.db
+            .insertInto("key_value")
+            .values({
+            key: "imported-key",
+            value: "imported-value",
+        })
+            .execute();
+        const lixBlob = await sourceLix.toBlob();
+        // This should not throw
+        await expect(storage.import(lixBlob)).resolves.not.toThrow();
+    });
+    test("integrates with openLix", async () => {
+        const storage = new OpfsStorage({ path: "integration.db" });
+        const lix = await openLix({ storage });
+        expect(lix.db).toBeDefined();
+        expect(lix.sqlite).toBeDefined();
+        expect(lix.hooks).toBeDefined();
+        // Should be able to query the database
+        const result = await lix.db.selectFrom("key_value").selectAll().execute();
+        expect(Array.isArray(result)).toBe(true);
+    });
+    test("persists data automatically on state mutations", async () => {
+        const path = "e2e-persist-test.db";
+        // Open lix with OPFS storage
+        const lix1 = await openLix({ storage: new OpfsStorage({ path }) });
+        // Insert some data
+        await lix1.db
+            .insertInto("key_value")
+            .values({
+            key: "e2e-test-key",
+            value: "e2e-test-value",
+        })
+            .execute();
+        // Wait for auto-save to complete
+        await new Promise((resolve) => setTimeout(resolve, 150));
+        await lix1.close();
+        // Open the persisted blob to verify the data
+        const lix2 = await openLix({ storage: new OpfsStorage({ path }) });
+        // Verify the data persisted correctly
+        const result = await lix2.db
+            .selectFrom("key_value")
+            .where("key", "=", "e2e-test-key")
+            .selectAll()
+            .execute();
+        expect(result).toHaveLength(1);
+        expect(result[0]?.value).toBe("e2e-test-value");
+    });
+    test("can save and load data persistence", async () => {
+        const path = "persistence-test.db";
+        // Create and populate database
+        const storage1 = new OpfsStorage({ path });
+        const lix1 = await openLix({ storage: storage1 });
+        await lix1.db
+            .insertInto("key_value")
+            .values({
+            key: "test-key",
+            value: "test-value",
+        })
+            .execute();
+        // Wait for auto-save to complete
+        await new Promise((resolve) => setTimeout(resolve, 150));
+        // Open new storage instance with same path
+        const storage2 = new OpfsStorage({ path });
+        const lix2 = await openLix({ storage: storage2 });
+        // Data should persist
+        const result = await lix2.db
+            .selectFrom("key_value")
+            .where("key", "=", "test-key")
+            .selectAll()
+            .execute();
+        expect(result).toHaveLength(1);
+        expect(result[0]?.value).toBe("test-value");
+    });
+});
+//# sourceMappingURL=opfs.test.js.map

package/dist/lix/storage/opfs.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opfs.test.js","sourceRoot":"","sources":["../../../src/lix/storage/opfs.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,yCAAyC;AACzC,MAAM,QAAQ;IACL,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;IAE9C,kBAAkB;QACjB,OAAO;YACN,aAAa,EAAE,EAAE;iBACf,EAAE,EAAE;iBACJ,kBAAkB,CAClB,CAAC,QAAgB,EAAE,OAA8B,EAAE,EAAE;gBACpD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;oBACnD,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;gBACnC,CAAC;gBACD,OAAO,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;YAC5C,CAAC,CACD;SACF,CAAC;IACH,CAAC;IAEO,oBAAoB,CAAC,QAAgB;QAC5C,OAAO;YACN,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,EAAE;gBACxC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;gBAC3D,OAAO,OAAO,CAAC,OAAO,CAAC;oBACtB,WAAW,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC;iBACnD,CAAC,CAAC;YACJ,CAAC,CAAC;YACF,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,EAAE;gBAC/C,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC3D,CAAC,CAAC;SACF,CAAC;IACH,CAAC;IAEO,kBAAkB,CAAC,QAAgB;QAC1C,IAAI,MAAM,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;QAE/B,OAAO;YACN,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,CAAC,IAAgB,EAAE,EAAE;gBACtD,MAAM,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;gBAC9B,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;YAC1B,CAAC,CAAC;YACF,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,EAAE;gBACtC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;gBACjC,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;YAC1B,CAAC,CAAC;SACF,CAAC;IACH,CAAC;CACD;AAED,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC5B,IAAI,QAAkB,CAAC;IAEvB,UAAU,CAAC,GAAG,EAAE;QACf,EAAE,CAAC,aAAa,EAAE,CAAC;QACnB,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;QAE1B,kBAAkB;QAClB,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,WAAW,EAAE;YAC9C,KAAK,EAAE;gBACN,OAAO,EAAE;oBACR,YAAY,EAAE,EAAE;yBACd,EAAE,EAAE;yBACJ,iBAAiB,CAAC,QAAQ,CAAC,kBAAkB,EAAE,CAAC;iBAClD;aACD;YACD,QAAQ,EAAE,IAAI;SACd,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC/C,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,WAAW,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAClD,uDAAuD;QACvD,MAAM,iBAAiB,GAAG,UAAU,CAAC,SAAS,CAAC;QAC/C,OAAQ,UAAkB,CAAC,SAAS,CAAC;QAErC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,WAAW,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,OAAO,CACzD,2CAA2C,CAC3C,CAAC;QAEF,oBAAoB;QACpB,UAAU,CAAC,SAAS,GAAG,iBAAiB,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QACpD,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QAEvC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACxE,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QACrD,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;QAEjC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,yBAAyB,EAAE,KAAK,IAAI,EAAE;QAC1C,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QACrD,MAAM,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QAE3B,wBAAwB;QACxB,MAAM,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QAErD,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,eAAe,EAAE,EAAE,CAAC,CAAC;QAEpE,8BAA8B;QAC9B,MAAM,SAAS,CAAC,EAAE;aAChB,UAAU,CAAC,WAAW,CAAC;aACvB,MAAM,CAAC;YACP,GAAG,EAAE,cAAc;YACnB,KAAK,EAAE,gBAAgB;SACvB,CAAC;aACD,OAAO,EAAE,CAAC;QAEZ,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,CAAC;QAEzC,wBAAwB;QACxB,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,yBAAyB,EAAE,KAAK,IAAI,EAAE;QAC1C,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,CAAC;QAC5D,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QAEvC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QACjC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QAEhC,uCAAuC;QACvC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,CAAC;QAC1E,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QACjE,MAAM,IAAI,GAAG,qBAAqB,CAAC;QAEnC,6BAA6B;QAC7B,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QAEnE,mBAAmB;QACnB,MAAM,IAAI,CAAC,EAAE;aACX,UAAU,CAAC,WAAW,CAAC;aACvB,MAAM,CAAC;YACP,GAAG,EAAE,cAAc;YACnB,KAAK,EAAE,gBAAgB;SACvB,CAAC;aACD,OAAO,EAAE,CAAC;QAEZ,iCAAiC;QACjC,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;QAEzD,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QAEnB,6CAA6C;QAC7C,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QAEnE,sCAAsC;QACtC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE;aAC1B,UAAU,CAAC,WAAW,CAAC;aACvB,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,cAAc,CAAC;aACjC,SAAS,EAAE;aACX,OAAO,EAAE,CAAC;QAEZ,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;QACrD,MAAM,IAAI,GAAG,qBAAqB,CAAC;QAEnC,+BAA+B;QAC/B,MAAM,QAAQ,GAAG,IAAI,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;QAElD,MAAM,IAAI,CAAC,EAAE;aACX,UAAU,CAAC,WAAW,CAAC;aACvB,MAAM,CAAC;YACP,GAAG,EAAE,UAAU;YACf,KAAK,EAAE,YAAY;SACnB,CAAC;aACD,OAAO,EAAE,CAAC;QAEZ,iCAAiC;QACjC,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;QAEzD,2CAA2C;QAC3C,MAAM,QAAQ,GAAG,IAAI,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;QAElD,sBAAsB;QACtB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE;aAC1B,UAAU,CAAC,WAAW,CAAC;aACvB,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,UAAU,CAAC;aAC7B,SAAS,EAAE;aACX,OAAO,EAAE,CAAC;QAEZ,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/lix/to-blob.d.ts

@@ -1,9 +1,16 @@
 import type { Lix } from "./open-lix.js";
 /**
- * Convert the lix to a blob.
+ * Serialises the Lix database into a {@link Blob}.
+ *
+ * Use this helper to persist the current state to disk or send it to a
+ * server. The blob contains the raw SQLite file representing the Lix
+ * project.
  *
  * @example
- *   const blob = await toBlob({ lix })
+ * ```ts
+ * const blob = await lix.toBlob()
+ * download(blob)
+ * ```
  */
 export declare function toBlob(args: {
     lix: Pick<Lix, "db" | "sqlite">;

package/dist/lix/to-blob.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"to-blob.d.ts","sourceRoot":"","sources":["../../src/lix/to-blob.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;;GAKG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE;IAClC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,GAAG,QAAQ,CAAC,CAAC;CAChC,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhB"}
+{"version":3,"file":"to-blob.d.ts","sourceRoot":"","sources":["../../src/lix/to-blob.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;;;;;;;;;GAYG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE;IAClC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,GAAG,QAAQ,CAAC,CAAC;CAChC,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhB"}

package/dist/lix/to-blob.js

@@ -1,9 +1,16 @@
 import { contentFromDatabase } from "sqlite-wasm-kysely";
 /**
- * Convert the lix to a blob.
+ * Serialises the Lix database into a {@link Blob}.
+ *
+ * Use this helper to persist the current state to disk or send it to a
+ * server. The blob contains the raw SQLite file representing the Lix
+ * project.
  *
  * @example
- *   const blob = await toBlob({ lix })
+ * ```ts
+ * const blob = await lix.toBlob()
+ * download(blob)
+ * ```
  */
 export async function toBlob(args) {
     return new Blob([contentFromDatabase(args.lix.sqlite)]);

package/dist/lix/to-blob.js.map

@@ -1 +1 @@
-{"version":3,"file":"to-blob.js","sourceRoot":"","sources":["../../src/lix/to-blob.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAGzD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAE5B;IACA,OAAO,IAAI,IAAI,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AACzD,CAAC"}
+{"version":3,"file":"to-blob.js","sourceRoot":"","sources":["../../src/lix/to-blob.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAGzD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAE5B;IACA,OAAO,IAAI,IAAI,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AACzD,CAAC"}

package/dist/lix/to-blob.test.d.ts

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

package/dist/lix/to-blob.test.d.ts.map

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

package/dist/lix/to-blob.test.js

@@ -0,0 +1,18 @@
+import { test, expect } from "vitest";
+import { openLix } from "./open-lix.js";
+import { newLixFile } from "./new-lix.js";
+test("it's possible to open the blob again", async () => {
+    const blob0 = await newLixFile();
+    const lix = await openLix({
+        blob: blob0,
+    });
+    const blob1 = await lix.toBlob();
+    const lix2 = await openLix({
+        blob: blob1,
+    });
+    expect(lix2).toBeDefined();
+    expect(lix2.db).toBeDefined();
+    expect(lix2.sqlite).toBeDefined();
+    expect(lix2.plugin).toBeDefined();
+});
+//# sourceMappingURL=to-blob.test.js.map

package/dist/lix/to-blob.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-blob.test.js","sourceRoot":"","sources":["../../src/lix/to-blob.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,IAAI,CAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;IACvD,MAAM,KAAK,GAAG,MAAM,UAAU,EAAE,CAAC;IAEjC,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC;QACzB,IAAI,EAAE,KAAK;KACX,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,MAAM,EAAE,CAAC;IAEjC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC;QAC1B,IAAI,EAAE,KAAK;KACX,CAAC,CAAC;IAEH,MAAM,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IAC3B,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;IAClC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;AACnC,CAAC,CAAC,CAAC"}

package/dist/log/create-lix-own-log.d.ts

@@ -0,0 +1,66 @@
+import type { Lix } from "../lix/open-lix.js";
+/**
+ * Creates a log entry in the Lix database, applying log level filtering.
+ *
+ * Reads the `lix_log_levels` key from the key-value store. This key is expected
+ * to contain a JSON string representation of an array of allowed log level strings
+ * (e.g., '["info", "warn", "error"]').
+ *
+ * Use '["*"]' to log all levels.
+ *
+ * If the key is missing, invalid JSON, or not an array, it defaults to
+ * `["info", "warn", "error"]`. The log entry is only created if the provided
+ * `level` is included in the determined list of allowed levels or if the list is '["*"]'.
+ *
+ * It is recommended to use dot notation for log keys (e.g., 'app.module.component').
+ *
+ * @example
+ * // Basic info log (will be logged if 'info' is allowed by lix_log_levels)
+ * createLixOwnLog({
+ *   lix,
+ *   key: 'app.init',
+ *   level: 'info',
+ *   message: 'Application started.'
+ * });
+ *
+ * @example
+ * // Log a warning (will be logged if 'warn' is allowed by lix_log_levels)
+ * createLixOwnLog({
+ *   lix,
+ *   key: 'user.login.failed',
+ *   level: 'warn',
+ *   message: `Login failed for user ${userId}`
+ * });
+ *
+ * @example
+ * // Configure to log everything (set lix_log_levels to '["*"]')
+ * await lix.db.insertInto('key_value').values({
+ *   key: 'lix_log_levels',
+ *   value: '["*"]',
+ *   skip_change_control: true
+ * }).onConflict(oc => oc.column('key').doUpdateSet({ value: '["*"]' })).execute();
+ *
+ * @example
+ * // Configure to log only custom levels (set lix_log_levels to '["audit", "critical"]')
+ * await lix.db.insertInto('key_value').values({
+ *   key: 'lix_log_levels',
+ *   value: '["audit", "critical"]',
+ *   skip_change_control: true
+ * }).onConflict(oc => oc.column('key').doUpdateSet({ value: '["audit", "critical"]' })).execute();
+ * // Only logs with level 'audit' or 'critical' will be stored
+ *
+ * @returns A promise that resolves with the created log entry, or undefined if filtered out.
+ */
+export declare function createLixOwnLogSync(args: {
+    lix: Pick<Lix, "sqlite" | "db">;
+    message: string;
+    level: string;
+    key: string;
+}): void;
+export declare function createLixOwnLog(args: {
+    lix: Pick<Lix, "db">;
+    message: string;
+    level: string;
+    key: string;
+}): Promise<void>;
+//# sourceMappingURL=create-lix-own-log.d.ts.map

package/dist/log/create-lix-own-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-lix-own-log.d.ts","sourceRoot":"","sources":["../../src/log/create-lix-own-log.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAI9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACzC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAC,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACZ,GAAG,IAAI,CA4BP;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC3C,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACZ,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BhB"}

package/dist/log/create-lix-own-log.js

@@ -0,0 +1,103 @@
+import { executeSync } from "../database/execute-sync.js";
+const DEFAULT_LOG_LEVELS = ["info", "warn", "error"];
+/**
+ * Creates a log entry in the Lix database, applying log level filtering.
+ *
+ * Reads the `lix_log_levels` key from the key-value store. This key is expected
+ * to contain a JSON string representation of an array of allowed log level strings
+ * (e.g., '["info", "warn", "error"]').
+ *
+ * Use '["*"]' to log all levels.
+ *
+ * If the key is missing, invalid JSON, or not an array, it defaults to
+ * `["info", "warn", "error"]`. The log entry is only created if the provided
+ * `level` is included in the determined list of allowed levels or if the list is '["*"]'.
+ *
+ * It is recommended to use dot notation for log keys (e.g., 'app.module.component').
+ *
+ * @example
+ * // Basic info log (will be logged if 'info' is allowed by lix_log_levels)
+ * createLixOwnLog({
+ *   lix,
+ *   key: 'app.init',
+ *   level: 'info',
+ *   message: 'Application started.'
+ * });
+ *
+ * @example
+ * // Log a warning (will be logged if 'warn' is allowed by lix_log_levels)
+ * createLixOwnLog({
+ *   lix,
+ *   key: 'user.login.failed',
+ *   level: 'warn',
+ *   message: `Login failed for user ${userId}`
+ * });
+ *
+ * @example
+ * // Configure to log everything (set lix_log_levels to '["*"]')
+ * await lix.db.insertInto('key_value').values({
+ *   key: 'lix_log_levels',
+ *   value: '["*"]',
+ *   skip_change_control: true
+ * }).onConflict(oc => oc.column('key').doUpdateSet({ value: '["*"]' })).execute();
+ *
+ * @example
+ * // Configure to log only custom levels (set lix_log_levels to '["audit", "critical"]')
+ * await lix.db.insertInto('key_value').values({
+ *   key: 'lix_log_levels',
+ *   value: '["audit", "critical"]',
+ *   skip_change_control: true
+ * }).onConflict(oc => oc.column('key').doUpdateSet({ value: '["audit", "critical"]' })).execute();
+ * // Only logs with level 'audit' or 'critical' will be stored
+ *
+ * @returns A promise that resolves with the created log entry, or undefined if filtered out.
+ */
+export function createLixOwnLogSync(args) {
+    const logLevels = executeSync({
+        lix: args.lix,
+        query: args.lix.db
+            .selectFrom("key_value")
+            .select("value")
+            .where("key", "=", "lix_log_levels"),
+    })[0];
+    // Check if the level is allowed
+    const shouldLog = (logLevels === undefined && DEFAULT_LOG_LEVELS.includes(args.level)) ||
+        (logLevels?.value && logLevels.value.includes("*")) ||
+        logLevels?.value.includes(args.level);
+    if (!shouldLog) {
+        return undefined; // Filtered out
+    }
+    // Insert the log
+    executeSync({
+        lix: args.lix,
+        query: args.lix.db.insertInto("log").values({
+            key: args.key,
+            message: args.message,
+            level: args.level,
+        }),
+    });
+}
+export async function createLixOwnLog(args) {
+    const logLevels = await args.lix.db
+        .selectFrom("key_value")
+        .select("value")
+        .where("key", "=", "lix_log_levels")
+        .executeTakeFirst();
+    // Check if the level is allowed
+    const shouldLog = (logLevels === undefined && DEFAULT_LOG_LEVELS.includes(args.level)) ||
+        (logLevels?.value && logLevels.value.includes("*")) ||
+        logLevels?.value?.includes(args.level);
+    if (!shouldLog) {
+        return undefined; // Filtered out
+    }
+    // Insert the log
+    await args.lix.db
+        .insertInto("log")
+        .values({
+        key: args.key,
+        message: args.message,
+        level: args.level,
+    })
+        .execute();
+}
+//# sourceMappingURL=create-lix-own-log.js.map

package/dist/log/create-lix-own-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-lix-own-log.js","sourceRoot":"","sources":["../../src/log/create-lix-own-log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAG1D,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAKnC;IACA,MAAM,SAAS,GAAG,WAAW,CAAC;QAC7B,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE;aAChB,UAAU,CAAC,WAAW,CAAC;aACvB,MAAM,CAAC,OAAO,CAAC;aACf,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,gBAAgB,CAAC;KACrC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEN,gCAAgC;IAChC,MAAM,SAAS,GACd,CAAC,SAAS,KAAK,SAAS,IAAI,kBAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpE,CAAC,SAAS,EAAE,KAAK,IAAI,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACnD,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAEvC,IAAI,CAAC,SAAS,EAAE,CAAC;QAChB,OAAO,SAAS,CAAC,CAAC,eAAe;IAClC,CAAC;IAED,iBAAiB;IACjB,WAAW,CAAC;QACX,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;YAC3C,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;SACjB,CAAC;KACF,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAKrC;IACA,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE;SACjC,UAAU,CAAC,WAAW,CAAC;SACvB,MAAM,CAAC,OAAO,CAAC;SACf,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,gBAAgB,CAAC;SACnC,gBAAgB,EAAE,CAAC;IAErB,gCAAgC;IAChC,MAAM,SAAS,GACd,CAAC,SAAS,KAAK,SAAS,IAAI,kBAAkB,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpE,CAAC,SAAS,EAAE,KAAK,IAAK,SAAS,CAAC,KAAkB,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAChE,SAAS,EAAE,KAA8B,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAElE,IAAI,CAAC,SAAS,EAAE,CAAC;QAChB,OAAO,SAAS,CAAC,CAAC,eAAe;IAClC,CAAC;IAED,iBAAiB;IACjB,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE;SACf,UAAU,CAAC,KAAK,CAAC;SACjB,MAAM,CAAC;QACP,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,KAAK,EAAE,IAAI,CAAC,KAAK;KACjB,CAAC;SACD,OAAO,EAAE,CAAC;AACb,CAAC"}

package/dist/log/create-lix-own-log.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=create-lix-own-log.test.d.ts.map

package/dist/log/create-lix-own-log.test.d.ts.map

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

package/dist/log/create-lix-own-log.test.js

@@ -0,0 +1,81 @@
+import { expect, test } from "vitest";
+import { openLix } from "../lix/open-lix.js";
+import { createLixOwnLog } from "./create-lix-own-log.js";
+test("should insert logs default log levels when lix_log_levels is not set)", async () => {
+    const lix = await openLix({
+        keyValues: [{ key: "lix_log_levels", value: ["info", "warn", "error"] }],
+    });
+    await createLogs(lix);
+    const logs = await getLogs(lix);
+    expect(logs).toHaveLength(3); // info, warn, error
+    expect(logs.find((log) => log.level === "debug")).toBeUndefined();
+    expect(logs.find((log) => log.level === "info")?.message).toBe("info message");
+    expect(logs.find((log) => log.level === "warn")?.message).toBe("warn message");
+    expect(logs.find((log) => log.level === "error")?.message).toBe("error message");
+});
+test("should insert only specified levels when lix_log_levels=['warn', 'error']", async () => {
+    const lix = await openLix({
+        keyValues: [{ key: "lix_log_levels", value: ["warn", "error"] }],
+    });
+    await createLogs(lix);
+    const logs = await getLogs(lix);
+    expect(logs).toHaveLength(2); // warn, error
+    expect(logs.find((log) => log.level === "debug")).toBeUndefined();
+    expect(logs.find((log) => log.level === "info")).toBeUndefined();
+    expect(logs.find((log) => log.level === "warn")?.message).toBe("warn message");
+    expect(logs.find((log) => log.level === "error")?.message).toBe("error message");
+});
+test("should insert only specified levels when lix_log_levels=['debug']", async () => {
+    const lix = await openLix({
+        keyValues: [{ key: "lix_log_levels", value: ["debug"] }],
+    });
+    await createLogs(lix);
+    const logs = await getLogs(lix);
+    expect(logs).toHaveLength(1); // debug
+    expect(logs.find((log) => log.level === "debug")?.message).toBe("debug message");
+    expect(logs.find((log) => log.level === "info")).toBeUndefined();
+    expect(logs.find((log) => log.level === "warn")).toBeUndefined();
+    expect(logs.find((log) => log.level === "error")).toBeUndefined();
+});
+test("should insert all levels contain wildcard '*'", async () => {
+    const lix = await openLix({
+        keyValues: [{ key: "lix_log_levels", value: ["*"] }],
+    });
+    await createLogs(lix);
+    const logs = await getLogs(lix);
+    expect(logs).toHaveLength(4); // debug, info, warn, error
+    expect(logs.find((log) => log.level === "debug")?.message).toBe("debug message");
+    expect(logs.find((log) => log.level === "info")?.message).toBe("info message");
+    expect(logs.find((log) => log.level === "warn")?.message).toBe("warn message");
+    expect(logs.find((log) => log.level === "error")?.message).toBe("error message");
+});
+async function createLogs(lix) {
+    await createLixOwnLog({
+        lix,
+        key: "lix.test.debug",
+        level: "debug",
+        message: "debug message",
+    });
+    await createLixOwnLog({
+        lix,
+        key: "lix.test.info",
+        level: "info",
+        message: "info message",
+    });
+    await createLixOwnLog({
+        lix,
+        key: "lix.test.warn",
+        level: "warn",
+        message: "warn message",
+    });
+    await createLixOwnLog({
+        lix,
+        key: "lix.test.error",
+        level: "error",
+        message: "error message",
+    });
+}
+async function getLogs(lix) {
+    return lix.db.selectFrom("log").selectAll().execute();
+}
+//# sourceMappingURL=create-lix-own-log.test.js.map

package/dist/log/create-lix-own-log.test.js.map

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

package/dist/log/create-log.d.ts

@@ -0,0 +1,32 @@
+import type { State } from "../entity-views/types.js";
+import type { Lix } from "../lix/open-lix.js";
+import type { Log } from "./schema.js";
+/**
+ * Directly creates a log entry in the Lix database without applying any filters.
+ *
+ * This function inserts the log entry regardless of the `lix_log_levels` setting
+ * in the key-value store. It is the responsibility of the calling application
+ * to implement any desired log level filtering before invoking this function.
+ *
+ * It is recommended to use dot notation for log keys (e.g., 'app.module.component').
+ *
+ * @example
+ * // Directly log an info message
+ *
+ * if (shouldLog) {
+ *   await createLog({
+ *     lix,
+ *     key: 'app.init',
+ *     level: 'info',
+ *     message: 'Application initialized'
+ * });
+ *
+ * @returns A promise that resolves with the created log entry.
+ */
+export declare function createLog(args: {
+    lix: Pick<Lix, "sqlite" | "db">;
+    message: string;
+    level: string;
+    key: string;
+}): Promise<State<Log>>;
+//# sourceMappingURL=create-log.d.ts.map

package/dist/log/create-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-log.d.ts","sourceRoot":"","sources":["../../src/log/create-log.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAEvC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACrC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAC,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACZ,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAmBtB"}

package/dist/log/create-log.js

@@ -0,0 +1,43 @@
+import { nanoid } from "../database/nano-id.js";
+/**
+ * Directly creates a log entry in the Lix database without applying any filters.
+ *
+ * This function inserts the log entry regardless of the `lix_log_levels` setting
+ * in the key-value store. It is the responsibility of the calling application
+ * to implement any desired log level filtering before invoking this function.
+ *
+ * It is recommended to use dot notation for log keys (e.g., 'app.module.component').
+ *
+ * @example
+ * // Directly log an info message
+ *
+ * if (shouldLog) {
+ *   await createLog({
+ *     lix,
+ *     key: 'app.init',
+ *     level: 'info',
+ *     message: 'Application initialized'
+ * });
+ *
+ * @returns A promise that resolves with the created log entry.
+ */
+export async function createLog(args) {
+    // Insert the log entry
+    const id = nanoid();
+    await args.lix.db
+        .insertInto("log")
+        .values({
+        id,
+        key: args.key,
+        message: args.message,
+        level: args.level,
+    })
+        .execute();
+    // Query to get the created log entry
+    return await args.lix.db
+        .selectFrom("log")
+        .where("id", "=", id)
+        .selectAll()
+        .executeTakeFirstOrThrow();
+}
+//# sourceMappingURL=create-log.js.map

package/dist/log/create-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-log.js","sourceRoot":"","sources":["../../src/log/create-log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAKhD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAK/B;IACA,uBAAuB;IACvB,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IACpB,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE;SACf,UAAU,CAAC,KAAK,CAAC;SACjB,MAAM,CAAC;QACP,EAAE;QACF,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,KAAK,EAAE,IAAI,CAAC,KAAK;KACjB,CAAC;SACD,OAAO,EAAE,CAAC;IAEZ,qCAAqC;IACrC,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE;SACtB,UAAU,CAAC,KAAK,CAAC;SACjB,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC;SACpB,SAAS,EAAE;SACX,uBAAuB,EAAE,CAAC;AAC7B,CAAC"}