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

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

@@ -1,105 +0,0 @@
-/**
- * State-committed row emitted to `onStateCommit` subscribers.
- *
- * These are state-shaped (not low-level change rows) and include operational columns such as
- * `version_id`, `commit_id`, optional `untracked`, and `writer_key`.
- *
- * Untracked rows (like derived change-set elements or log-style inserts) surface with
- * `untracked: 1` and a sentinel `commit_id: "untracked"` because they do not belong to a
- * materialized commit yet. Observers should treat the pair `(untracked === 1, commit_id === "untracked")`
- * as “ephemeral” data and avoid dereferencing the commit.
- *
- * The `writer_key` identifies the writer responsible for the materialized state row and enables
- * echo suppression in UIs (filter out your own writes while reacting to external ones). When no
- * explicit writer is provided (the default), the value is `null`.
- *
- * See the writer key guide for patterns and pitfalls.
- */
-export type StateCommitChange = {
-    id: string;
-    entity_id: string;
-    schema_key: string;
-    schema_version: string;
-    file_id: string;
-    plugin_key: string;
-    created_at: string;
-    snapshot_content: Record<string, any> | null;
-    version_id: string;
-    commit_id: string;
-    /** 0 for tracked, 1 for untracked */
-    untracked?: number;
-    /** Arbitrary metadata attached to the originating change, if any. */
-    metadata?: Record<string, any> | null;
-    /**
-     * Writer identity that produced this state row, if known.
-     *
-     * Used for echo suppression (ignore my own writes; react to external ones).
-     * See docs: https://lix.dev/guide/writer-key
-     */
-    writer_key: string | null;
-};
-/**
- * Change data passed to state commit hooks.
- * Extends the standard Change type with tracking information.
- */
-/**
- * Lix hooks system for listening to database lifecycle events.
- *
- * Hooks allow you to register callbacks that fire at specific points
- * in Lix's execution, such as when state changes are committed.
- */
-type HookEvents = {
-    state_commit: {
-        changes: StateCommitChange[];
-    };
-};
-type HookEventType = keyof HookEvents;
-export type LixHooks = {
-    /**
-     * Listen to state commit events.
-     *
-     * Fires after any state mutation is committed to the database.
-     * Useful for auto-saving, cache invalidation, sync operations, etc.
-     *
-     * Payload carries `changes: StateCommitChange[]`, including `writer_key` for each state row
-     * (when applicable). For UIs, filter by writer to suppress echoes, e.g.:
-     *
-     * ```ts
-     * const writer_key = 'app_component_<session_id>'
-     * lix.hooks.onStateCommit(({ changes }) => {
-     *   const external = changes.some(c =>
-     *     c.file_id === activeFileId && (c.writer_key == null || c.writer_key !== writer_key)
-     *   )
-     *   if (external) refresh()
-     * })
-     * ```
-     *
-     * @param handler - Function to call when state is committed
-     * @returns Unsubscribe function to remove the listener
-     *
-     * @example
-     * ```typescript
-     * const unsubscribe = lix.hooks.onStateCommit(() => {
-     *   console.log('State was committed!');
-     *   storage.save();
-     * });
-     *
-     * // Later, remove the listener
-     * unsubscribe();
-     * ```
-     */
-    onStateCommit: (handler: (data: {
-        changes: StateCommitChange[];
-    }) => void) => () => void;
-    /**
-     * Internal method for emitting events.
-     *
-     * @internal
-     * This method is for internal use only and should not be called directly.
-     * Use this to emit events from state mutation functions.
-     */
-    _emit: <T extends HookEventType>(eventType: T, data: HookEvents[T]) => void;
-};
-export declare function createHooks(): LixHooks;
-export {};
-//# sourceMappingURL=create-hooks.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"create-hooks.d.ts","sourceRoot":"","sources":["../../src/hooks/create-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IACtC;;;;;OAKG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF;;;GAGG;AAGH;;;;;GAKG;AACH,KAAK,UAAU,GAAG;IACjB,YAAY,EAAE;QAAE,OAAO,EAAE,iBAAiB,EAAE,CAAA;KAAE,CAAC;CAC/C,CAAC;AAEF,KAAK,aAAa,GAAG,MAAM,UAAU,CAAC;AAEtC,MAAM,MAAM,QAAQ,GAAG;IACtB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACH,aAAa,EAAE,CACd,OAAO,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,iBAAiB,EAAE,CAAA;KAAE,KAAK,IAAI,KACrD,MAAM,IAAI,CAAC;IAEhB;;;;;;OAMG;IACH,KAAK,EAAE,CAAC,CAAC,SAAS,aAAa,EAAE,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;CAC5E,CAAC;AA2BF,wBAAgB,WAAW,IAAI,QAAQ,CAsBtC"}

package/dist/hooks/create-hooks.js

@@ -1,40 +0,0 @@
-/**
- * Creates a new hooks system for a Lix instance.
- *
- * Uses the native EventTarget API under the hood for efficient
- * event handling and automatic memory management.
- *
- * @returns LixHooks instance with event subscription methods
- */
-function ensureCustomEventPolyfill() {
-    if (typeof globalThis.CustomEvent === "function") {
-        return;
-    }
-    class NodeCustomEvent extends Event {
-        detail;
-        constructor(type, params) {
-            super(type, params);
-            this.detail = (params?.detail ?? null);
-        }
-    }
-    globalThis.CustomEvent =
-        NodeCustomEvent;
-}
-export function createHooks() {
-    ensureCustomEventPolyfill();
-    const eventTarget = new EventTarget();
-    return {
-        onStateCommit(handler) {
-            const wrappedHandler = (event) => {
-                const customEvent = event;
-                handler(customEvent.detail);
-            };
-            eventTarget.addEventListener("state_commit", wrappedHandler);
-            return () => eventTarget.removeEventListener("state_commit", wrappedHandler);
-        },
-        _emit(eventType, data) {
-            eventTarget.dispatchEvent(new CustomEvent(eventType, { detail: data }));
-        },
-    };
-}
-//# sourceMappingURL=create-hooks.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"create-hooks.js","sourceRoot":"","sources":["../../src/hooks/create-hooks.ts"],"names":[],"mappings":"AA2GA;;;;;;;GAOG;AACH,SAAS,yBAAyB;IACjC,IAAI,OAAO,UAAU,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;QAClD,OAAO;IACR,CAAC;IAED,MAAM,eAA6B,SAAQ,KAAK;QACtC,MAAM,CAAI;QACnB,YAAY,IAAY,EAAE,MAA2B;YACpD,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACpB,IAAI,CAAC,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,IAAI,IAAI,CAAM,CAAC;QAC7C,CAAC;KACD;IAEA,UAA6D,CAAC,WAAW;QACzE,eAAgD,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,WAAW;IAC1B,yBAAyB,EAAE,CAAC;IAE5B,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;IAEtC,OAAO;QACN,aAAa,CACZ,OAAyD;YAEzD,MAAM,cAAc,GAAG,CAAC,KAAY,EAAE,EAAE;gBACvC,MAAM,WAAW,GAAG,KAAoB,CAAC;gBACzC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAC7B,CAAC,CAAC;YACF,WAAW,CAAC,gBAAgB,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;YAC7D,OAAO,GAAG,EAAE,CACX,WAAW,CAAC,mBAAmB,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;QAClE,CAAC;QAED,KAAK,CAA0B,SAAY,EAAE,IAAmB;YAC/D,WAAW,CAAC,aAAa,CAAC,IAAI,WAAW,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACzE,CAAC;KACD,CAAC;AACH,CAAC"}

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

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

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

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

package/dist/hooks/create-hooks.test.js

@@ -1,195 +0,0 @@
-import { expect, test, vi } from "vitest";
-import { createHooks } from "./create-hooks.js";
-import { openLix } from "../lix/open-lix.js";
-import { createVersion } from "../version/create-version.js";
-import { withWriterKey } from "../state/writer.js";
-const testHooksSchema = {
-    "x-lix-key": "test_entity",
-    "x-lix-version": "1.0",
-    type: "object",
-    additionalProperties: false,
-    properties: {
-        id: { type: "string" },
-        name: { type: "string" },
-    },
-    required: ["id"],
-};
-const emptyChangesPayload = { changes: [] };
-test("should create hooks with onStateCommit method", () => {
-    const hooks = createHooks();
-    expect(hooks.onStateCommit).toBeDefined();
-    expect(typeof hooks.onStateCommit).toBe("function");
-    expect(hooks._emit).toBeDefined();
-    expect(typeof hooks._emit).toBe("function");
-});
-test("should call handler when state_commit event is emitted", () => {
-    const hooks = createHooks();
-    const handler = vi.fn();
-    hooks.onStateCommit(handler);
-    hooks._emit("state_commit", emptyChangesPayload);
-    expect(handler).toHaveBeenCalledTimes(1);
-});
-test("should call multiple handlers when state_commit event is emitted", () => {
-    const hooks = createHooks();
-    const handler1 = vi.fn();
-    const handler2 = vi.fn();
-    hooks.onStateCommit(handler1);
-    hooks.onStateCommit(handler2);
-    hooks._emit("state_commit", emptyChangesPayload);
-    expect(handler1).toHaveBeenCalledTimes(1);
-    expect(handler2).toHaveBeenCalledTimes(1);
-});
-test("should return unsubscribe function that removes the handler", () => {
-    const hooks = createHooks();
-    const handler = vi.fn();
-    const unsubscribe = hooks.onStateCommit(handler);
-    // Emit event - handler should be called
-    hooks._emit("state_commit", emptyChangesPayload);
-    expect(handler).toHaveBeenCalledTimes(1);
-    // Unsubscribe and emit again - handler should not be called
-    unsubscribe();
-    hooks._emit("state_commit", emptyChangesPayload);
-    expect(handler).toHaveBeenCalledTimes(1);
-});
-test("should handle multiple subscriptions and unsubscriptions correctly", () => {
-    const hooks = createHooks();
-    const handler1 = vi.fn();
-    const handler2 = vi.fn();
-    const handler3 = vi.fn();
-    const unsubscribe1 = hooks.onStateCommit(handler1);
-    const unsubscribe2 = hooks.onStateCommit(handler2);
-    const unsubscribe3 = hooks.onStateCommit(handler3);
-    // All handlers should be called
-    hooks._emit("state_commit", emptyChangesPayload);
-    expect(handler1).toHaveBeenCalledTimes(1);
-    expect(handler2).toHaveBeenCalledTimes(1);
-    expect(handler3).toHaveBeenCalledTimes(1);
-    // Remove handler2
-    unsubscribe2();
-    hooks._emit("state_commit", emptyChangesPayload);
-    expect(handler1).toHaveBeenCalledTimes(2);
-    expect(handler2).toHaveBeenCalledTimes(1); // Still 1
-    expect(handler3).toHaveBeenCalledTimes(2);
-    // Remove handler1 and handler3
-    unsubscribe1();
-    unsubscribe3();
-    hooks._emit("state_commit", emptyChangesPayload);
-    expect(handler1).toHaveBeenCalledTimes(2); // Still 2
-    expect(handler2).toHaveBeenCalledTimes(1); // Still 1
-    expect(handler3).toHaveBeenCalledTimes(2); // Still 2
-});
-test("should handle async handlers without issues", async () => {
-    const hooks = createHooks();
-    const handler = vi.fn().mockResolvedValue(undefined);
-    hooks.onStateCommit(handler);
-    hooks._emit("state_commit", emptyChangesPayload);
-    // Wait a bit to ensure async handler has time to run
-    await new Promise((resolve) => setTimeout(resolve, 0));
-    expect(handler).toHaveBeenCalledTimes(1);
-});
-test("should create independent hook instances", () => {
-    const hooks1 = createHooks();
-    const hooks2 = createHooks();
-    const handler1 = vi.fn();
-    const handler2 = vi.fn();
-    hooks1.onStateCommit(handler1);
-    hooks2.onStateCommit(handler2);
-    // Emit on hooks1 - only handler1 should be called
-    hooks1._emit("state_commit", emptyChangesPayload);
-    expect(handler1).toHaveBeenCalledTimes(1);
-    expect(handler2).not.toHaveBeenCalled();
-    // Emit on hooks2 - only handler2 should be called
-    hooks2._emit("state_commit", emptyChangesPayload);
-    expect(handler1).toHaveBeenCalledTimes(1);
-    expect(handler2).toHaveBeenCalledTimes(1);
-});
-test("onStateCommit emits state-shaped changes with version_id and commit_id", async () => {
-    const lix = await openLix({
-        keyValues: [
-            {
-                key: "lix_deterministic_mode",
-                value: { enabled: true },
-                lixcol_version_id: "global",
-            },
-        ],
-    });
-    await lix.db
-        .insertInto("stored_schema")
-        .values({ value: testHooksSchema })
-        .execute();
-    const v = await createVersion({ lix, name: "hook-test" });
-    const events = [];
-    const unsubscribe = lix.hooks.onStateCommit(({ changes }) => {
-        events.push(changes);
-    });
-    await lix.db
-        .insertInto("state_by_version")
-        .values({
-        entity_id: "hook-entity",
-        schema_key: "test_entity",
-        schema_version: "1.0",
-        file_id: "hook-file",
-        version_id: v.id,
-        plugin_key: "test_plugin",
-        snapshot_content: { id: "hook-entity", name: "Hello" },
-    })
-        .execute();
-    await new Promise((r) => setTimeout(r, 0));
-    expect(events.length).toBeGreaterThan(0);
-    const flat = events.flat();
-    const domain = flat.find((c) => c.schema_key === "test_entity" && c.entity_id === "hook-entity");
-    expect(domain).toBeDefined();
-    expect(domain.version_id).toBe(v.id);
-    expect(typeof domain.commit_id).toBe("string");
-    expect((domain.commit_id ?? "").length).toBeGreaterThan(0);
-    expect(domain.untracked ?? 0).toBe(0);
-    unsubscribe();
-    await lix.close();
-});
-test("onStateCommit exposes writer_key for state changes", async () => {
-    const lix = await openLix({
-        keyValues: [
-            {
-                key: "lix_deterministic_mode",
-                value: { enabled: true },
-                lixcol_version_id: "global",
-            },
-        ],
-    });
-    const mockSchema = {
-        "x-lix-key": "test_schema_writer_hook",
-        "x-lix-version": "1.0",
-        type: "object",
-        additionalProperties: false,
-        properties: { value: { type: "string" } },
-    };
-    await lix.db
-        .insertInto("stored_schema")
-        .values({ value: mockSchema })
-        .execute();
-    const WRITER = "testapp:hooks#writer";
-    const events = [];
-    const unsubscribe = lix.hooks.onStateCommit(({ changes }) => {
-        events.push(changes);
-    });
-    await withWriterKey(lix.db, WRITER, async (trx) => {
-        await trx
-            .insertInto("state")
-            .values({
-            entity_id: "w1",
-            file_id: "f1",
-            schema_key: mockSchema["x-lix-key"],
-            schema_version: mockSchema["x-lix-version"],
-            plugin_key: "test_plugin",
-            snapshot_content: { value: "A" },
-        })
-            .execute();
-    });
-    const flat = events.flat();
-    const change = flat.find((c) => c?.entity_id === "w1" && c?.schema_key === mockSchema["x-lix-key"]);
-    expect(change).toBeDefined();
-    expect(change.writer_key).toBe(WRITER);
-    unsubscribe();
-    await lix.close();
-});
-//# sourceMappingURL=create-hooks.test.js.map

package/dist/hooks/create-hooks.test.js.map

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

package/dist/hooks/index.d.ts

@@ -1,2 +0,0 @@
-export type { LixHooks } from "./create-hooks.js";
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/hooks/index.js

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

package/dist/hooks/index.js.map

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

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mBAAmB,CAAC;AAClC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oCAAoC,CAAC;AACnD,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC"}

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mBAAmB,CAAC;AAClC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oCAAoC,CAAC;AACnD,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC"}

package/dist/key-value/index.d.ts

@@ -1,2 +0,0 @@
-export { LixKeyValueSchema, type LixKeyValue } from "./schema-definition.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/key-value/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/key-value/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/key-value/index.js

@@ -1,2 +0,0 @@
-export { LixKeyValueSchema } from "./schema-definition.js";
-//# sourceMappingURL=index.js.map

package/dist/key-value/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/key-value/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAoB,MAAM,wBAAwB,CAAC"}

package/dist/key-value/schema-definition.d.ts

@@ -1,74 +0,0 @@
-import type { FromLixSchemaDefinition } from "../schema-definition/definition.js";
-/**
- * Represents a key-value pair in Lix.
- *
- * The value can be any JSON-serializable type (string, number, boolean, object, array, null).
- *
- * **Important SQLite Limitation with Boolean Values:**
- * SQLite does not have a native boolean type. When storing JSON values:
- * - `true` is stored as `1`
- * - `false` is stored as `0`
- *
- * This is a fundamental limitation of SQLite's JSON implementation. There is no way
- * to distinguish between a boolean `true` and the number `1` after retrieval.
- *
- * When querying boolean values, use loose equality (`==`) or handle the numeric representation.
- *
- * @example
- * ```typescript
- * await lix.db.insertInto("key_value").values({
- *   key: "lix_sync_enabled",
- *   value: true // Will be stored as 1 in SQLite
- * }).execute();
- *
- * await lix.db.insertInto("key_value").values({
- *   key: "lix_server_url",
- *   value: "https://api.example.com"
- * }).execute();
- * ```
- *
- * @example
- * ```typescript
- * const result = await lix.db
- *   .selectFrom("key_value")
- *   .where("key", "=", "lix_sync_enabled")
- *   .select("value")
- *   .executeTakeFirst();
- *
- * // result.value will be 1 (not true)
- * const isEnabled = result?.value == true; // Use loose equality
- * const isEnabled = result?.value === 1; // Or compare numeric value
- * ```
- *
- * @example
- * ```typescript
- * // Common Lix system keys
- * // "lix_id" - Unique identifier for the Lix instance
- * // "lix_name" - Human-readable name for the Lix instance
- * // "lix_server_url" - URL of the sync server
- * // "lix_deterministic_mode" - Boolean flag for deterministic ID generation
- * // "lix_telemetry" - Telemetry setting ("on" or "off")
- * ```
- */
-export type LixKeyValue = FromLixSchemaDefinition<typeof LixKeyValueSchema> & {
-    value: any;
-};
-export declare const LixKeyValueSchema: {
-    readonly "x-lix-key": "lix_key_value";
-    readonly "x-lix-version": "1.0";
-    readonly "x-lix-primary-key": readonly ["/key"];
-    readonly "x-lix-override-lixcols": {
-        readonly lixcol_file_id: "\"lix\"";
-        readonly lixcol_plugin_key: "\"lix_sdk\"";
-    };
-    readonly type: "object";
-    readonly properties: {
-        readonly key: {
-            readonly type: "string";
-        };
-        readonly value: any;
-    };
-    readonly required: readonly ["key", "value"];
-    readonly additionalProperties: false;
-};
-//# sourceMappingURL=schema-definition.d.ts.map

package/dist/key-value/schema-definition.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"schema-definition.d.ts","sourceRoot":"","sources":["../../src/key-value/schema-definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,uBAAuB,EAEvB,MAAM,oCAAoC,CAAC;AAG5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,MAAM,MAAM,WAAW,GAAG,uBAAuB,CAAC,OAAO,iBAAiB,CAAC,GAAG;IAC7E,KAAK,EAAE,GAAG,CAAC;CACX,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;wBAWH,GAAG;;;;CAIpB,CAAC"}

package/dist/key-value/schema-definition.js

@@ -1,19 +0,0 @@
-import { JSONTypeSchema } from "../schema-definition/json-type.js";
-export const LixKeyValueSchema = {
-    "x-lix-key": "lix_key_value",
-    "x-lix-version": "1.0",
-    "x-lix-primary-key": ["/key"],
-    "x-lix-override-lixcols": {
-        lixcol_file_id: '"lix"',
-        lixcol_plugin_key: '"lix_sdk"',
-    },
-    type: "object",
-    properties: {
-        key: { type: "string" },
-        value: JSONTypeSchema,
-    },
-    required: ["key", "value"],
-    additionalProperties: false,
-};
-LixKeyValueSchema;
-//# sourceMappingURL=schema-definition.js.map

package/dist/key-value/schema-definition.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"schema-definition.js","sourceRoot":"","sources":["../../src/key-value/schema-definition.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAyDnE,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAChC,WAAW,EAAE,eAAe;IAC5B,eAAe,EAAE,KAAK;IACtB,mBAAmB,EAAE,CAAC,MAAM,CAAC;IAC7B,wBAAwB,EAAE;QACzB,cAAc,EAAE,OAAO;QACvB,iBAAiB,EAAE,WAAW;KAC9B;IACD,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACX,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACvB,KAAK,EAAE,cAAqB;KAC5B;IACD,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC;IAC1B,oBAAoB,EAAE,KAAK;CAClB,CAAC;AACX,iBAA+C,CAAC"}

package/dist/key-value/schema.test.d.ts

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

package/dist/key-value/schema.test.d.ts.map

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