@lix-js/sdk 0.5.0-preview.1 → 0.5.1

package/dist/diff/select-working-diff.bench.js

@@ -0,0 +1,82 @@
+import { afterAll, beforeAll, beforeEach, bench, describe } from "vitest";
+import { openLix } from "../lix/open-lix.js";
+import { createCheckpoint } from "../state/create-checkpoint.js";
+import { selectWorkingDiff } from "./select-working-diff.js";
+import { LixKeyValueSchema } from "../key-value/schema-definition.js";
+const FILE_ID = "lix";
+const KV_SCHEMA = LixKeyValueSchema["x-lix-key"];
+const ROWS = 10;
+const BASE_UNCHANGED = 10;
+async function createWorkingDiffCtx() {
+    return openLix({});
+}
+async function resetWorkingState(lix) {
+    await lix.db.deleteFrom("key_value").execute();
+    await createCheckpoint({ lix });
+    for (let i = 0; i < BASE_UNCHANGED; i++) {
+        await setKeyValue(lix, `base_${i}`, `A${i}`);
+    }
+    await createCheckpoint({ lix });
+    for (let i = 0; i < ROWS; i++) {
+        await setKeyValue(lix, `work_${i}`, i);
+    }
+}
+async function setKeyValue(lix, key, value) {
+    const existing = await lix.db
+        .selectFrom("key_value")
+        .where("key", "=", key)
+        .select("key")
+        .executeTakeFirst();
+    if (existing) {
+        await lix.db
+            .updateTable("key_value")
+            .set({ value })
+            .where("key", "=", key)
+            .execute();
+    }
+    else {
+        await lix.db.insertInto("key_value").values({ key, value }).execute();
+    }
+}
+describe("working diff: include unchanged", () => {
+    let lix;
+    beforeAll(async () => {
+        lix = await createWorkingDiffCtx();
+    });
+    afterAll(async () => {
+        await lix.close();
+    });
+    beforeEach(async () => {
+        await resetWorkingState(lix);
+    });
+    bench("working diff: include unchanged", async () => {
+        await selectWorkingDiff({ lix })
+            .where("file_id", "=", FILE_ID)
+            .where("schema_key", "=", KV_SCHEMA)
+            .orderBy("entity_id")
+            .select(["status"])
+            .execute();
+    });
+});
+describe("working diff: exclude unchanged", () => {
+    let lix;
+    beforeAll(async () => {
+        lix = await createWorkingDiffCtx();
+    });
+    afterAll(async () => {
+        await lix.close();
+    });
+    beforeEach(async () => {
+        await resetWorkingState(lix);
+    });
+    bench("working diff: exclude unchanged", async () => {
+        await selectWorkingDiff({ lix })
+            .where("file_id", "=", FILE_ID)
+            .where("schema_key", "=", KV_SCHEMA)
+            .where("status", "!=", "unchanged")
+            .orderBy("entity_id")
+            .select(["status"])
+            .execute();
+    });
+});
+//# sourceMappingURL=select-working-diff.bench.js.map

package/dist/diff/select-working-diff.bench.js.map

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

package/dist/diff/select-working-diff.d.ts

@@ -0,0 +1,105 @@
+import type { SelectQueryBuilder } from "kysely";
+import type { Lix } from "../lix/open-lix.js";
+import type { DiffRow } from "../version/select-version-diff.js";
+import type { LixDatabaseSchema } from "../database/schema.js";
+/**
+ * Returns the diff between the working state and the last checkpoint.
+ *
+ * The working state contains all changes made since the last checkpoint. This function
+ * compares these changes against the checkpoint to show what has been created, updated,
+ * or deleted. Optimized for real-time UI updates during active editing.
+ *
+ * Unlike {@link selectVersionDiff} which compares two complete versions, this operates
+ * directly on change sets for better performance.
+ *
+ * ## Diff Status Meanings
+ *
+ * | Status      | Description                                  | Before | After  |
+ * |-------------|----------------------------------------------|--------|--------|
+ * | `created`   | Entity added since checkpoint                | null   | exists |
+ * | `updated`   | Entity modified since checkpoint             | exists | exists |
+ * | `deleted`   | Entity removed since checkpoint (tombstone)  | exists | null   |
+ * | `unchanged` | Entity not modified in working state         | same   | same   |
+ *
+ * ## Performance
+ *
+ * - Queries only two change sets (working + latest checkpoint)
+ * - No graph traversal or recursion
+ * - Returns same shape as `selectVersionDiff` for compatibility
+ *
+ * @example
+ * // Get all changes since the last checkpoint
+ * const changes = await selectWorkingDiff({ lix })
+ *   .where('status', '!=', 'unchanged')
+ *   .execute();
+ *
+ * console.log(`${changes.length} changes since checkpoint`);
+ *
+ * @example
+ * // Monitor changes to a specific file
+ * const fileChanges = await selectWorkingDiff({ lix })
+ *   .where('file_id', '=', 'config.json')
+ *   .where('status', '!=', 'unchanged')
+ *   .orderBy('entity_id')
+ *   .execute();
+ *
+ * @example
+ * // Check if specific entities have changed since checkpoint
+ * const entityIds = ['user-1', 'user-2', 'user-3'];
+ * const entityChanges = await selectWorkingDiff({ lix })
+ *   .where('entity_id', 'in', entityIds)
+ *   .where('status', '!=', 'unchanged')
+ *   .execute();
+ *
+ * @example
+ * // Count changes by status
+ * const allChanges = await selectWorkingDiff({ lix })
+ *   .where('status', '!=', 'unchanged')
+ *   .execute();
+ *
+ * const stats = allChanges.reduce((acc, change) => {
+ *   acc[change.status] = (acc[change.status] || 0) + 1;
+ *   return acc;
+ * }, {} as Record<string, number>);
+ *
+ * console.log('Changes:', stats);
+ * // Output: { created: 5, updated: 3, deleted: 1 }
+ *
+ * @param args - Configuration object
+ * @param args.lix - Lix instance with database connection
+ *
+ * @returns A Kysely query builder for `DiffRow` results that can be further filtered,
+ * sorted, or executed.
+ *
+ * @see createCheckpoint - Convert working state into a checkpoint
+ * @see selectVersionDiff - Compare two complete version states
+ *
+ * @example
+ * // Fetch before/after snapshots by joining the `change` table
+ * // Tip: apply filters (file_id, schema_key, status) before joining to keep it fast.
+ * const rows = await selectWorkingDiff({ lix })
+ *   .where('file_id', '=', 'lix')
+ *   .where('schema_key', '=', 'lix_key_value')
+ *   .where('status', '!=', 'unchanged')
+ *   .leftJoin('change as before', 'before.id', 'before_change_id')
+ *   .leftJoin('change as after', 'after.id', 'after_change_id')
+ *   .select([
+ *     'entity_id',
+ *     'schema_key',
+ *     'file_id',
+ *     'status',
+ *     'before.snapshot_content',
+ *     'after.snapshot_content',
+ *   ])
+ *   .execute();
+ *
+ * // rows[i].before_snapshot_content / after_snapshot_content are JSON objects (or null)
+ */
+type DiffDB = {
+    diff: DiffRow;
+};
+export declare function selectWorkingDiff(args: {
+    lix: Lix;
+}): SelectQueryBuilder<LixDatabaseSchema & DiffDB, "diff", DiffRow>;
+export {};
+//# sourceMappingURL=select-working-diff.d.ts.map

package/dist/diff/select-working-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select-working-diff.d.ts","sourceRoot":"","sources":["../../src/diff/select-working-diff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AACjD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAC;AAEjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAI/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4FG;AACH,KAAK,MAAM,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAEhC,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACvC,GAAG,EAAE,GAAG,CAAC;CACT,GAAG,kBAAkB,CAAC,iBAAiB,GAAG,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CA+HlE"}

package/dist/diff/select-working-diff.js

@@ -0,0 +1,95 @@
+import { sql } from "kysely";
+export function selectWorkingDiff(args) {
+    const db = args.lix.db;
+    // Active version details
+    const workingCommitIdQ = db
+        .selectFrom("active_version")
+        .innerJoin("version", "active_version.version_id", "version.id")
+        .select((eb) => eb.ref("version.working_commit_id").as("id"));
+    // Optimize: previous checkpoint is the parent of the current working commit
+    const latestCheckpointCommitIdQ = db
+        .selectFrom("commit_edge as ce")
+        .innerJoin("commit as p", "p.id", "ce.parent_id")
+        .innerJoin("entity_label as el", (join) => join
+        .onRef("el.entity_id", "=", "p.id")
+        .on("el.schema_key", "=", "lix_commit"))
+        .innerJoin("label as l", "l.id", "el.label_id")
+        .whereRef("ce.child_id", "=", workingCommitIdQ)
+        .where("l.name", "=", "checkpoint")
+        .select("p.id")
+        .limit(1);
+    // Base SELECT: rows from the working change set
+    const base = db
+        .selectFrom("change as ch")
+        .innerJoin("change_set_element as cse", "cse.change_id", "ch.id")
+        .where("cse.change_set_id", "=", sql `(select change_set_id from wcs)`)
+        .where("ch.file_id", "!=", "lix_sdk")
+        .leftJoin("change_set_element as bcse", (join) => join
+        .onRef("bcse.entity_id", "=", "ch.entity_id")
+        .onRef("bcse.schema_key", "=", "ch.schema_key")
+        .onRef("bcse.file_id", "=", "ch.file_id")
+        .on("bcse.change_set_id", "=", sql `(select change_set_id from ccs)`))
+        // no join to `change bc` here — project ids only
+        .select((eb) => [
+        eb.ref("ch.entity_id").as("entity_id"),
+        eb.ref("ch.schema_key").as("schema_key"),
+        eb.ref("ch.file_id").as("file_id"),
+        sql `NULL`.as("before_version_id"),
+        eb.ref("bcse.change_id").as("before_change_id"),
+        sql `(select id from cc)`.as("before_commit_id"),
+        sql `NULL`.as("after_version_id"),
+        eb.ref("ch.id").as("after_change_id"),
+        sql `(select id from wc)`.as("after_commit_id"),
+        sql `CASE
+        WHEN bcse.change_id IS NOT NULL AND json(ch.snapshot_content) IS NULL THEN 'removed'
+        WHEN bcse.change_id IS NULL AND json(ch.snapshot_content) IS NOT NULL THEN 'added'
+        WHEN bcse.change_id IS NOT NULL AND json(ch.snapshot_content) IS NOT NULL AND bcse.change_id != ch.id THEN 'modified'
+        ELSE 'unchanged'
+      END`.as("status"),
+    ]);
+    // Unchanged rows = non-inherited, tracked state rows without a working CSE entry
+    const unchanged = db
+        .selectFrom("state_by_version as sa")
+        .whereRef("sa.version_id", "=", db.selectFrom("active_version").select("active_version.version_id"))
+        .where("sa.inherited_from_version_id", "is", null)
+        .where("sa.untracked", "=", false)
+        // Anti-join to ensure no working edit exists for this triple
+        .leftJoin("change_set_element as wcse", (join) => join
+        .onRef("wcse.entity_id", "=", "sa.entity_id")
+        .onRef("wcse.schema_key", "=", "sa.schema_key")
+        .onRef("wcse.file_id", "=", "sa.file_id")
+        .on("wcse.change_set_id", "=", sql `(select change_set_id from wcs)`))
+        .where("wcse.change_id", "is", null)
+        // For unchanged rows, before == after; reuse sa.* and avoid checkpoint joins
+        .select((eb) => [
+        eb.ref("sa.entity_id").as("entity_id"),
+        eb.ref("sa.schema_key").as("schema_key"),
+        eb.ref("sa.file_id").as("file_id"),
+        sql `NULL`.as("before_version_id"),
+        eb.ref("sa.change_id").as("before_change_id"),
+        sql `(select id from cc)`.as("before_commit_id"),
+        sql `NULL`.as("after_version_id"),
+        eb.ref("sa.change_id").as("after_change_id"),
+        sql `(select id from wc)`.as("after_commit_id"),
+        sql `'unchanged'`.as("status"),
+    ]);
+    // CTEs for constants used across both UNION arms
+    const union = sql `(
+        select * from (${base}) as w
+        union all
+        select * from (${unchanged}) as u
+    )`.as("diff");
+    return db
+        .with("wc", () => workingCommitIdQ)
+        .with("cc", () => latestCheckpointCommitIdQ)
+        .with("wcs", () => db
+        .selectFrom("commit")
+        .where("id", "=", sql `(select id from wc)`)
+        .select(["change_set_id"]))
+        .with("ccs", () => db
+        .selectFrom("commit")
+        .where("id", "=", sql `(select id from cc)`)
+        .select(["change_set_id"]))
+        .selectFrom(union);
+}
+//# sourceMappingURL=select-working-diff.js.map

package/dist/diff/select-working-diff.js.map

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

package/dist/diff/select-working-diff.test.d.ts

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

package/dist/diff/select-working-diff.test.d.ts.map

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

package/dist/diff/select-working-diff.test.js

@@ -0,0 +1,231 @@
+import { test, expect } from "vitest";
+import { openLix } from "../lix/open-lix.js";
+import { createCheckpoint } from "../state/create-checkpoint.js";
+import { selectWorkingDiff } from "./select-working-diff.js";
+import { LixKeyValueSchema } from "../key-value/schema-definition.js";
+const FILE_ID = "lix"; // key_value is stored under hardcoded file_id 'lix'
+const KV_SCHEMA = LixKeyValueSchema["x-lix-key"];
+// Manually select base diff columns from the aliased subquery "diff"
+const selectBaseDiffCols = [
+    "entity_id",
+    "schema_key",
+    "file_id",
+    "before_version_id",
+    "before_change_id",
+    "before_commit_id",
+    "after_version_id",
+    "after_change_id",
+    "after_commit_id",
+    "status",
+];
+async function setKeyValue(lix, key, value) {
+    // Safe upsert for vtable-backed entity: check existence first
+    const existing = await lix.db
+        .selectFrom("key_value")
+        .where("key", "=", key)
+        .select("key")
+        .executeTakeFirst();
+    if (existing) {
+        await lix.db
+            .updateTable("key_value")
+            .set({ value })
+            .where("key", "=", key)
+            .execute();
+    }
+    else {
+        await lix.db.insertInto("key_value").values({ key, value }).execute();
+    }
+}
+async function delKeyValue(lix, key) {
+    await lix.db.deleteFrom("key_value").where("key", "=", key).execute();
+}
+async function workingCommitId(lix) {
+    const row = await lix.db
+        .selectFrom("active_version")
+        .innerJoin("version", "active_version.version_id", "version.id")
+        .select("version.working_commit_id")
+        .executeTakeFirstOrThrow();
+    return row.working_commit_id;
+}
+test("added: new key after checkpoint", async () => {
+    const lix = await openLix({});
+    await createCheckpoint({ lix });
+    await setKeyValue(lix, "kv1", "A");
+    const wcid = await workingCommitId(lix);
+    const rows = await selectWorkingDiff({ lix })
+        .where("file_id", "=", FILE_ID)
+        .where("schema_key", "=", KV_SCHEMA)
+        .select(selectBaseDiffCols)
+        .execute();
+    expect(rows.length).toBeGreaterThan(0);
+    const created = rows.find((r) => r.status === "added" && r.entity_id === "kv1");
+    expect(created).toBeTruthy();
+    expect(created?.before_commit_id).toBeNull();
+    expect(created?.after_commit_id).toBe(wcid);
+    // Assert the value in the after change snapshot is 'A'
+    expect(created?.after_change_id).toBeTruthy();
+    const afterCreated = await lix.db
+        .selectFrom("change")
+        .where("id", "=", created.after_change_id)
+        .selectAll()
+        .executeTakeFirstOrThrow();
+    expect(afterCreated.snapshot_content?.value).toBe("A");
+});
+test("modified: key changed since last checkpoint", async () => {
+    const lix = await openLix({});
+    await createCheckpoint({ lix });
+    await setKeyValue(lix, "kv2", "A");
+    await createCheckpoint({ lix });
+    await setKeyValue(lix, "kv2", "B");
+    const rows = await selectWorkingDiff({ lix })
+        .where("file_id", "=", FILE_ID)
+        .where("schema_key", "=", KV_SCHEMA)
+        .select(selectBaseDiffCols)
+        .execute();
+    const updated = rows.find((r) => r.status === "modified" && r.entity_id === "kv2");
+    expect(updated).toBeTruthy();
+    expect(updated?.before_commit_id).toBeTruthy();
+    expect(updated?.after_commit_id).toBeTruthy();
+    expect(updated?.before_change_id).toBeTruthy();
+    expect(updated?.after_change_id).toBeTruthy();
+    // change ids must differ
+    expect(updated.before_change_id).not.toBe(updated.after_change_id);
+    // Assert before/after values are 'A' -> 'B'
+    const beforeUpdated = await lix.db
+        .selectFrom("change")
+        .where("id", "=", updated.before_change_id)
+        .selectAll()
+        .executeTakeFirstOrThrow();
+    const afterUpdated = await lix.db
+        .selectFrom("change")
+        .where("id", "=", updated.after_change_id)
+        .selectAll()
+        .executeTakeFirstOrThrow();
+    expect(beforeUpdated.snapshot_content?.value).toBe("A");
+    expect(afterUpdated.snapshot_content?.value).toBe("B");
+});
+test("removed: key removed since last checkpoint", async () => {
+    const lix = await openLix({});
+    await createCheckpoint({ lix });
+    await setKeyValue(lix, "kv3", "X");
+    await createCheckpoint({ lix });
+    await delKeyValue(lix, "kv3");
+    const rows = await selectWorkingDiff({ lix })
+        .where("file_id", "=", FILE_ID)
+        .where("schema_key", "=", KV_SCHEMA)
+        .select(selectBaseDiffCols)
+        .execute();
+    const deleted = rows.find((r) => r.status === "removed" && r.entity_id === "kv3");
+    expect(deleted).toBeTruthy();
+    expect(deleted?.before_commit_id).toBeTruthy();
+    expect(deleted?.after_commit_id).toBeTruthy();
+    // Assert before had 'X' and after is a tombstone (null)
+    expect(deleted?.before_change_id).toBeTruthy();
+    expect(deleted?.after_change_id).toBeTruthy();
+    const beforeDeleted = await lix.db
+        .selectFrom("change")
+        .where("id", "=", deleted.before_change_id)
+        .selectAll()
+        .executeTakeFirstOrThrow();
+    const afterDeleted = await lix.db
+        .selectFrom("change")
+        .where("id", "=", deleted.after_change_id)
+        .selectAll()
+        .executeTakeFirstOrThrow();
+    expect(beforeDeleted.snapshot_content?.value).toBe("X");
+    expect(afterDeleted.snapshot_content).toBeNull();
+});
+test("unchanged: no working changes returns no added/modified/removed", async () => {
+    const lix = await openLix({});
+    await createCheckpoint({ lix });
+    const rows = await selectWorkingDiff({ lix })
+        .where("file_id", "=", FILE_ID)
+        .where("schema_key", "=", KV_SCHEMA)
+        .select(selectBaseDiffCols)
+        .execute();
+    expect(rows.length).toBe(0);
+});
+test("latest checkpoint chosen as before", async () => {
+    const lix = await openLix({});
+    await createCheckpoint({ lix });
+    // A: create key t='A' and checkpoint
+    await setKeyValue(lix, "t", "A");
+    const A = await createCheckpoint({ lix });
+    // B: change t so it's included in the latest checkpoint
+    await setKeyValue(lix, "t", "A1");
+    await createCheckpoint({ lix });
+    // Working change: update t to new value
+    await setKeyValue(lix, "t", "B2");
+    const rows = await selectWorkingDiff({ lix })
+        .where("file_id", "=", FILE_ID)
+        .where("schema_key", "=", KV_SCHEMA)
+        .where("entity_id", "=", "t")
+        .select(selectBaseDiffCols)
+        .execute();
+    const row = rows[0];
+    expect(row).toBeTruthy();
+    expect(row?.status).toBe("modified");
+    expect(row?.before_commit_id).toBeTruthy();
+    expect(row?.before_commit_id).not.toBe(A.id);
+});
+test("after_commit_id equals active working commit id", async () => {
+    const lix = await openLix({});
+    await createCheckpoint({ lix });
+    await setKeyValue(lix, "wk1", "Z");
+    const wcid = await workingCommitId(lix);
+    const rows = await selectWorkingDiff({ lix })
+        .where("entity_id", "=", "wk1")
+        .select(selectBaseDiffCols)
+        .execute();
+    expect(rows.length).toBe(1);
+    expect(rows[0].after_commit_id).toBe(wcid);
+});
+test("before_* columns are null when no prior checkpoint", async () => {
+    const lix = await openLix({});
+    // NOTE: no checkpoint before first change
+    await setKeyValue(lix, "ncp", "A");
+    const rows = await selectWorkingDiff({ lix })
+        .where("entity_id", "=", "ncp")
+        .select(selectBaseDiffCols)
+        .execute();
+    expect(rows.length).toBe(1);
+    const r = rows[0];
+    expect(r.status).toBe("added");
+    expect(r.before_commit_id).toBeNull();
+    expect(r.before_change_id).toBeNull();
+    expect(r.before_version_id).toBeNull();
+});
+test("stable sorting by entity_id", async () => {
+    const lix = await openLix({});
+    await createCheckpoint({ lix });
+    await setKeyValue(lix, "b", 1);
+    await setKeyValue(lix, "a", 1);
+    await setKeyValue(lix, "c", 1);
+    const rows = await selectWorkingDiff({ lix })
+        .orderBy("entity_id", "asc")
+        .select(selectBaseDiffCols)
+        .execute();
+    const ids = rows.map((r) => r.entity_id);
+    expect(ids).toEqual([...ids].sort());
+});
+test("returns unchanged rows for non-inherited state when no working edits", async () => {
+    const lix = await openLix({});
+    // Create a non-inherited tracked key in the active version and checkpoint it
+    await setKeyValue(lix, "kvU", "X");
+    await createCheckpoint({ lix });
+    // No further edits; working diff should include 'unchanged' for kvU
+    const rows = await selectWorkingDiff({ lix })
+        .where("file_id", "=", FILE_ID)
+        .where("schema_key", "=", KV_SCHEMA)
+        .where("entity_id", "=", "kvU")
+        .select(selectBaseDiffCols)
+        .execute();
+    expect(rows.length).toBe(1);
+    const r = rows[0];
+    expect(r.status).toBe("unchanged");
+    // Optional: when unchanged, before/after change ids should match if present
+    if (r.before_change_id && r.after_change_id) {
+        expect(r.before_change_id).toBe(r.after_change_id);
+    }
+});
+//# sourceMappingURL=select-working-diff.test.js.map

package/dist/diff/select-working-diff.test.js.map

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

package/dist/engine/boot.d.ts

@@ -0,0 +1,90 @@
+import type { SqliteWasmDatabase } from "../database/sqlite/index.js";
+import { type StateCommitChange } from "../hooks/create-hooks.js";
+import type { LixPlugin } from "../plugin/lix-plugin.js";
+import type { Call } from "./functions/function-registry.js";
+import type { LixHooks } from "../hooks/create-hooks.js";
+import type { openLix } from "../lix/open-lix.js";
+import { type FunctionRegistry } from "./functions/function-registry.js";
+import type { PreprocessorFn } from "./preprocessor/types.js";
+export type EngineEvent = {
+    type: "state_commit";
+    payload: {
+        changes: StateCommitChange[];
+    };
+};
+export type BootArgs = {
+    providePlugins?: LixPlugin[];
+    providePluginsRaw?: string[];
+    account?: Parameters<typeof openLix>[0]["account"];
+    keyValues?: Parameters<typeof openLix>[0]["keyValues"];
+};
+export type BootEnv = {
+    sqlite: SqliteWasmDatabase;
+    emit: (ev: EngineEvent) => void;
+    args: BootArgs;
+};
+/**
+ * Engine context bound to a live SQLite connection.
+ *
+ * Internal to the engine: used by deterministic helpers and the engine
+ * function router. Not exposed as a value to app code, but the type is
+ * exported for internal module boundaries.
+ */
+export type LixEngine = {
+    sqlite: SqliteWasmDatabase;
+    hooks: LixHooks;
+    /** Return all loaded plugins synchronously */
+    getAllPluginsSync: () => LixPlugin[];
+    /** Query preprocessor shared across executeSync + explain flows */
+    preprocessQuery: PreprocessorFn;
+    /**
+     * Stable runtime-only cache token.
+     *
+     * Each engine instance gets a unique object that survives for the lifetime of
+     * the engine. Use it when you need to memoise values in a WeakMap without
+     * holding on to the whole engine:
+     *
+     * @example
+     * ```ts
+     * const rngState = new WeakMap<object, RngState>();
+     *
+     * function randomSync(engine: LixEngine) {
+     *   let state = rngState.get(engine.runtimeCacheRef);
+     *   if (!state) {
+     *     state = seedRng();
+     *     rngState.set(engine.runtimeCacheRef, state);
+     *   }
+     *   return state.next();
+     * }
+     * ```
+     */
+    runtimeCacheRef: object;
+    /** Execute raw SQL synchronously against the engine-controlled SQLite connection */
+    executeSync: (args: {
+        sql: string;
+        parameters?: Readonly<unknown[]>;
+        /**
+         * Selects the preprocessing pipeline to run before executing the query.
+         *
+         * - `full` (default): run the entire rewrite pipeline.
+         * - `vtable-select-only`: keep cache population and vtable rewrites.
+         * - `none`: bypass preprocessing entirely.
+         */
+        preprocessMode?: "full" | "vtable-select-only" | "none";
+    }) => {
+        rows: any[];
+    };
+    /** Invoke an engine function (router) */
+    call: Call;
+    /**
+     * Register a new engine helper function.
+     *
+     * Prefer registering helpers during engine boot so they are available to
+     * both SQL rewrites and application-level calls.
+     */
+    registerFunction: FunctionRegistry["register"];
+    /** Enumerate registered engine helper functions. */
+    listFunctions: FunctionRegistry["list"];
+};
+export declare function boot(env: BootEnv): Promise<LixEngine>;
+//# sourceMappingURL=boot.d.ts.map

package/dist/engine/boot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boot.d.ts","sourceRoot":"","sources":["../../src/engine/boot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEtE,OAAO,EAAe,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAG/E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kCAAkC,CAAC;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAIlD,OAAO,EAEN,KAAK,gBAAgB,EACrB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAG9D,MAAM,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE;QAAE,OAAO,EAAE,iBAAiB,EAAE,CAAA;KAAE,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACtB,cAAc,CAAC,EAAE,SAAS,EAAE,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACnD,SAAS,CAAC,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;CACvD,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG;IACrB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,IAAI,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,IAAI,CAAC;IAChC,IAAI,EAAE,QAAQ,CAAC;CACf,CAAC;AAEF;;;;;;GAMG;AAEH,MAAM,MAAM,SAAS,GAAG;IACvB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,KAAK,EAAE,QAAQ,CAAC;IAChB,8CAA8C;IAC9C,iBAAiB,EAAE,MAAM,SAAS,EAAE,CAAC;IACrC,mEAAmE;IACnE,eAAe,EAAE,cAAc,CAAC;IAChC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,eAAe,EAAE,MAAM,CAAC;IACxB,oFAAoF;IACpF,WAAW,EAAE,CAAC,IAAI,EAAE;QACnB,GAAG,EAAE,MAAM,CAAC;QACZ,UAAU,CAAC,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;QACjC;;;;;;WAMG;QACH,cAAc,CAAC,EAAE,MAAM,GAAG,oBAAoB,GAAG,MAAM,CAAC;KACxD,KAAK;QACL,IAAI,EAAE,GAAG,EAAE,CAAC;KACZ,CAAC;IACF,yCAAyC;IACzC,IAAI,EAAE,IAAI,CAAC;IACX;;;;;OAKG;IACH,gBAAgB,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAC/C,oDAAoD;IACpD,aAAa,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;CACxC,CAAC;AAEF,wBAAsB,IAAI,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAgL3D"}