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

package/dist/log/index.d.ts

@@ -0,0 +1,3 @@
+export { LixLogSchema, type Log } from "./schema.js";
+export { createLog } from "./create-log.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/log/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/log/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,GAAG,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/log/index.js

@@ -0,0 +1,3 @@
+export { LixLogSchema } from "./schema.js";
+export { createLog } from "./create-log.js";
+//# sourceMappingURL=index.js.map

package/dist/log/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/log/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAY,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/log/schema.d.ts

@@ -0,0 +1,32 @@
+import type { SqliteWasmDatabase } from "sqlite-wasm-kysely";
+import type { FromLixSchemaDefinition } from "../schema-definition/definition.js";
+export declare function applyLogDatabaseSchema(sqlite: SqliteWasmDatabase): SqliteWasmDatabase;
+export declare const LixLogSchema: {
+    readonly "x-lix-key": "lix_log";
+    readonly "x-lix-version": "1.0";
+    readonly "x-lix-primary-key": readonly ["id"];
+    readonly type: "object";
+    readonly properties: {
+        readonly id: {
+            readonly type: "string";
+            readonly description: "The unique identifier of the log entry";
+            readonly "x-lix-generated": true;
+        };
+        readonly key: {
+            readonly type: "string";
+            readonly description: "The key of the log entry";
+        };
+        readonly message: {
+            readonly type: "string";
+            readonly description: "The message of the log entry";
+        };
+        readonly level: {
+            readonly type: "string";
+            readonly description: "The level of the log entry";
+        };
+    };
+    readonly required: readonly ["id", "key", "message", "level"];
+    readonly additionalProperties: false;
+};
+export type Log = FromLixSchemaDefinition<typeof LixLogSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/log/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/log/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAEX,uBAAuB,EACvB,MAAM,oCAAoC,CAAC;AAI5C,wBAAgB,sBAAsB,CACrC,MAAM,EAAE,kBAAkB,GACxB,kBAAkB,CAYpB;AAED,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;CA0Bf,CAAC;AAIX,MAAM,MAAM,GAAG,GAAG,uBAAuB,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/dist/log/schema.js

@@ -0,0 +1,43 @@
+import { createEntityViewsIfNotExists } from "../entity-views/entity-view-builder.js";
+import { nanoid } from "../database/nano-id.js";
+export function applyLogDatabaseSchema(sqlite) {
+    // Create both primary and _all views for log
+    createEntityViewsIfNotExists({
+        lix: { sqlite },
+        schema: LixLogSchema,
+        overrideName: "log",
+        pluginKey: "lix_own_entity",
+        hardcodedFileId: "lix",
+        defaultValues: { id: () => nanoid() },
+    });
+    return sqlite;
+}
+export const LixLogSchema = {
+    "x-lix-key": "lix_log",
+    "x-lix-version": "1.0",
+    "x-lix-primary-key": ["id"],
+    type: "object",
+    properties: {
+        id: {
+            type: "string",
+            description: "The unique identifier of the log entry",
+            "x-lix-generated": true,
+        },
+        key: {
+            type: "string",
+            description: "The key of the log entry",
+        },
+        message: {
+            type: "string",
+            description: "The message of the log entry",
+        },
+        level: {
+            type: "string",
+            description: "The level of the log entry",
+        },
+    },
+    required: ["id", "key", "message", "level"],
+    additionalProperties: false,
+};
+LixLogSchema;
+//# sourceMappingURL=schema.js.map

package/dist/log/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/log/schema.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,4BAA4B,EAAE,MAAM,wCAAwC,CAAC;AACtF,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAEhD,MAAM,UAAU,sBAAsB,CACrC,MAA0B;IAE1B,6CAA6C;IAC7C,4BAA4B,CAAC;QAC5B,GAAG,EAAE,EAAE,MAAM,EAAE;QACf,MAAM,EAAE,YAAY;QACpB,YAAY,EAAE,KAAK;QACnB,SAAS,EAAE,gBAAgB;QAC3B,eAAe,EAAE,KAAK;QACtB,aAAa,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE;KACrC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AACf,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG;IAC3B,WAAW,EAAE,SAAS;IACtB,eAAe,EAAE,KAAK;IACtB,mBAAmB,EAAE,CAAC,IAAI,CAAC;IAC3B,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACX,EAAE,EAAE;YACH,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,wCAAwC;YACrD,iBAAiB,EAAE,IAAI;SACvB;QACD,GAAG,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,0BAA0B;SACvC;QACD,OAAO,EAAE;YACR,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,8BAA8B;SAC3C;QACD,KAAK,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,4BAA4B;SACzC;KACD;IACD,QAAQ,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC;IAC3C,oBAAoB,EAAE,KAAK;CAClB,CAAC;AACX,YAA0C,CAAC"}

package/dist/log/schema.test.d.ts

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

package/dist/log/schema.test.d.ts.map

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

package/dist/log/schema.test.js

@@ -0,0 +1,119 @@
+import { expect, test } from "vitest";
+import { openLix } from "../lix/open-lix.js";
+test("log insert creates entries in the view", async () => {
+    const lix = await openLix({});
+    // Insert a log entry
+    await lix.db
+        .insertInto("log")
+        .values({
+        key: "test.log",
+        message: "Test log message",
+        level: "info",
+    })
+        .execute();
+    // Verify the log appears in the view
+    const logs = await lix.db.selectFrom("log").selectAll().execute();
+    expect(logs).toHaveLength(1);
+    expect(logs[0]).toMatchObject({
+        key: "test.log",
+        message: "Test log message",
+        level: "info",
+    });
+});
+test("log insert with custom id", async () => {
+    const lix = await openLix({});
+    const customId = "custom-log-id";
+    await lix.db
+        .insertInto("log")
+        .values({
+        id: customId,
+        key: "custom.log",
+        message: "Custom ID log",
+        level: "debug",
+    })
+        .execute();
+    const logs = await lix.db
+        .selectFrom("log")
+        .where("id", "=", customId)
+        .selectAll()
+        .execute();
+    expect(logs).toHaveLength(1);
+    expect(logs[0]?.id).toBe(customId);
+    expect(logs[0]?.key).toBe("custom.log");
+    expect(logs[0]?.message).toBe("Custom ID log");
+    expect(logs[0]?.level).toBe("debug");
+});
+test("log delete removes entries from the view", async () => {
+    const lix = await openLix({});
+    // Insert multiple logs
+    await lix.db
+        .insertInto("log")
+        .values([
+        {
+            key: "log.to.keep",
+            message: "Keep this log",
+            level: "info",
+        },
+        {
+            key: "log.to.delete",
+            message: "Delete this log",
+            level: "error",
+        },
+    ])
+        .execute();
+    // Verify both logs exist
+    const allLogs = await lix.db.selectFrom("log").selectAll().execute();
+    expect(allLogs).toHaveLength(2);
+    // Get the ID of the log to delete
+    const logToDelete = allLogs.find((log) => log.key === "log.to.delete");
+    expect(logToDelete).toBeDefined();
+    // Delete one log by ID
+    await lix.db.deleteFrom("log").where("id", "=", logToDelete.id).execute();
+    // Verify only one log remains
+    const remainingLogs = await lix.db.selectFrom("log").selectAll().execute();
+    expect(remainingLogs).toHaveLength(1);
+    expect(remainingLogs[0]?.key).toBe("log.to.keep");
+    expect(remainingLogs[0]?.message).toBe("Keep this log");
+    // Verify the deleted log is gone
+    const deletedLogs = await lix.db
+        .selectFrom("log")
+        .where("id", "=", logToDelete.id)
+        .selectAll()
+        .execute();
+    expect(deletedLogs).toHaveLength(0);
+});
+test("multiple log inserts with unique ids", async () => {
+    const lix = await openLix({});
+    // Insert multiple logs
+    await lix.db
+        .insertInto("log")
+        .values([
+        {
+            key: "log1",
+            message: "First log",
+            level: "info",
+        },
+        {
+            key: "log2",
+            message: "Second log",
+            level: "warn",
+        },
+        {
+            key: "log3",
+            message: "Third log",
+            level: "error",
+        },
+    ])
+        .execute();
+    const logs = await lix.db.selectFrom("log").selectAll().execute();
+    expect(logs).toHaveLength(3);
+    // Verify all have unique IDs
+    const ids = logs.map((log) => log.id);
+    const uniqueIds = new Set(ids);
+    expect(uniqueIds.size).toBe(3);
+    // Verify content
+    expect(logs.find((log) => log.key === "log1")?.message).toBe("First log");
+    expect(logs.find((log) => log.key === "log2")?.message).toBe("Second log");
+    expect(logs.find((log) => log.key === "log3")?.message).toBe("Third log");
+});
+//# sourceMappingURL=schema.test.js.map

package/dist/log/schema.test.js.map

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

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

@@ -0,0 +1,17 @@
+import type { SelectQueryBuilder } from "kysely";
+import type { Lix } from "../lix/open-lix.js";
+import { LixObservable } from "./lix-observable.js";
+/**
+ * Options for the observe method.
+ */
+export interface ObserveOptions {
+    mode?: "array" | "first" | "firstOrThrow";
+}
+/**
+ * Creates the observe function for a Lix instance.
+ *
+ * @param lix - The Lix instance to add observables to
+ * @returns The observe function
+ */
+export declare function createObserve(lix: Pick<Lix, "hooks">): <T>(query: SelectQueryBuilder<any, any, T>, options?: ObserveOptions) => LixObservable<T>;
+//# sourceMappingURL=create-observe.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-observe.d.ts","sourceRoot":"","sources":["../../src/observe/create-observe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AACjD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,cAAc,CAAC;CAC1C;AAqBD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,IA4B5B,CAAC,EACxB,OAAO,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,EACtC,UAAS,cAAkC,KACzC,aAAa,CAAC,CAAC,CAAC,CA8EnB"}

package/dist/observe/create-observe.js

@@ -0,0 +1,118 @@
+import { LixObservable } from "./lix-observable.js";
+/**
+ * Deep equality check for query results.
+ * Compares arrays element by element using JSON.stringify for simplicity.
+ */
+function areResultsEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    // Simple deep equality using JSON.stringify
+    // This works well for database results which are typically JSON-serializable
+    return JSON.stringify(a) === JSON.stringify(b);
+}
+/**
+ * Creates the observe function for a Lix instance.
+ *
+ * @param lix - The Lix instance to add observables to
+ * @returns The observe function
+ */
+export function createObserve(lix) {
+    const activeObservables = new WeakMap();
+    /**
+     * Converts a **Kysely read-query** into a **LixObservable** – an implementation of
+     * the TC-39 Observable protocol that emits a fresh result-set every time the
+     * underlying state mutates.
+     *
+     * @example **Full table stream**
+     * ```ts
+     * observe(
+     *   lix.db.selectFrom('key_value').selectAll()
+     * ).subscribe({
+     *   next: rows => console.table(rows)
+     * })
+     * ```
+     *
+     * @example **Watch latest change-set (first row)**
+     * ```ts
+     * observe(
+     *   lix.db.selectFrom('change_set_all')
+     *         .selectAll()
+     *         .orderBy('created_at desc')
+     * ).subscribeTakeFirst({
+     *   next: cs => console.log('head →', cs)
+     * })
+     * ```
+     */
+    return function observe(query, options = { mode: "array" }) {
+        // Create the observable
+        const observable = new LixObservable((observer) => {
+            let isActive = true;
+            let previousResult;
+            // Helper to execute the query
+            const executeQuery = async () => {
+                if (!isActive)
+                    return;
+                try {
+                    // Optimize query for first/firstOrThrow modes
+                    let optimizedQuery = query;
+                    if (options.mode === "first" || options.mode === "firstOrThrow") {
+                        // Add limit(1) if we only need the first row
+                        optimizedQuery = query.limit(1);
+                    }
+                    // Execute the query
+                    const result = await optimizedQuery.execute();
+                    if (!isActive)
+                        return;
+                    // Check if results have changed
+                    const hasChanged = !previousResult || !areResultsEqual(previousResult, result);
+                    if (hasChanged) {
+                        previousResult = result;
+                        // Handle different modes
+                        if (options.mode === "first") {
+                            observer.next?.(result);
+                        }
+                        else if (options.mode === "firstOrThrow") {
+                            observer.next?.(result);
+                        }
+                        else {
+                            // Default: array mode
+                            observer.next?.(result);
+                        }
+                    }
+                }
+                catch (error) {
+                    if (!isActive)
+                        return;
+                    observer.error?.(error);
+                }
+            };
+            // Execute initial query
+            executeQuery();
+            // Subscribe to state commits for updates
+            const unsubscribeFromStateCommit = lix.hooks.onStateCommit(() => {
+                executeQuery();
+            });
+            // Store the cleanup function
+            activeObservables.set(observable, { unsubscribeFromStateCommit });
+            // Return cleanup function
+            return () => {
+                isActive = false;
+                unsubscribeFromStateCommit();
+                activeObservables.delete(observable);
+            };
+        });
+        // Handle mode-specific behavior by returning wrapped observables
+        if (options.mode === "first") {
+            // For compatibility, we still return the base observable
+            // The subscribeTakeFirst method handles the transformation
+            return observable;
+        }
+        else if (options.mode === "firstOrThrow") {
+            // For compatibility, we still return the base observable
+            // The subscribeTakeFirstOrThrow method handles the transformation
+            return observable;
+        }
+        return observable;
+    };
+}
+//# sourceMappingURL=create-observe.js.map

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

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

package/dist/observe/create-observe.test.d.ts

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

package/dist/observe/create-observe.test.d.ts.map

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