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

package/dist/test-utilities/simulation-test/simulation-test.js

@@ -0,0 +1,89 @@
+import { test, expect, vi } from "vitest";
+import { openLix } from "../../lix/open-lix.js";
+import { cacheMissSimulation } from "./cache-miss-simulation.js";
+import { outOfOrderSequenceSimulation } from "./out-of-order-sequence-simulation.js";
+import { engineBoundarySimulation } from "./engine-boundary-simulation.js";
+/**
+ * Normal simulation - Standard test execution without any modifications.
+ */
+const normalSimulation = {
+    name: "normal",
+    setup: async (lix) => lix,
+};
+// Default simulations available
+export const defaultSimulations = [
+    normalSimulation,
+    // disabledQueryPreprocessorSimulation,
+    cacheMissSimulation,
+    engineBoundarySimulation,
+];
+// Export individual simulations for custom use
+export { engineBoundarySimulation, normalSimulation, cacheMissSimulation, outOfOrderSequenceSimulation, };
+export function simulationTest(name, fn, options) {
+    // Use provided simulations or default ones
+    const simulationsToRun = options?.simulations || defaultSimulations;
+    const expectedValues = new Map();
+    test.each(simulationsToRun)(`${name} > $name`, async (simulation) => {
+        vi.restoreAllMocks();
+        let callIndex = 0;
+        const isFirstSimulation = simulation === simulationsToRun[0];
+        const deterministicExpect = (actual, diffCallback) => {
+            const key = `expect-${callIndex++}`;
+            if (isFirstSimulation) {
+                // Store expected values in first simulation
+                expectedValues.set(key, actual);
+            }
+            else {
+                // Verify values match first simulation in subsequent simulations
+                const expected = expectedValues.get(key);
+                if (expected !== undefined) {
+                    // Check if values differ before invoking callback
+                    let valuesMatch = false;
+                    try {
+                        expect(actual).toEqual(expected);
+                        valuesMatch = true;
+                    }
+                    catch {
+                        // Values don't match
+                    }
+                    // Only call diff callback if values actually differ
+                    if (!valuesMatch && diffCallback) {
+                        diffCallback({
+                            actual,
+                            expected,
+                        });
+                    }
+                    // Always perform the assertion (will throw if values differ)
+                    const errorMessage = `
+SIMULATION DETERMINISM VIOLATION
+
+expectDeterministic() failed: Values differ between simulations
+
+Location: Call #${callIndex - 1}
+Simulation: ${simulation.name} vs ${simulationsToRun[0]?.name || "normal"}
+
+Use expectDeterministic() for values that must be identical across simulations.
+Use regular expect() for simulation-specific assertions.
+
+`;
+                    expect(actual, errorMessage).toEqual(expected);
+                }
+            }
+            return expect(actual);
+        };
+        // Create openSimulatedLix function
+        const openSimulatedLix = async (args) => {
+            // Open lix with the provided arguments
+            const lix = await openLix(args);
+            // Apply simulation setup
+            return await simulation.setup(lix);
+        };
+        await fn({
+            simulation: simulation,
+            openSimulatedLix,
+            expectDeterministic: deterministicExpect,
+        });
+        vi.restoreAllMocks(); // Restore original implementations, not just reset
+    }, options?.timeout);
+}
+//# sourceMappingURL=simulation-test.js.map

package/dist/test-utilities/simulation-test/simulation-test.js.map

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

package/dist/test-utilities/simulation-test/simulation-test.test.d.ts

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

package/dist/test-utilities/simulation-test/simulation-test.test.d.ts.map

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

package/dist/test-utilities/simulation-test/simulation-test.test.js

@@ -0,0 +1,308 @@
+import { describe, expect, test } from "vitest";
+import { simulationTest, normalSimulation, } from "./simulation-test.js";
+import { commit } from "../../state/vtable/commit.js";
+test("simulation test discovery", () => { });
+describe("expectDeterministic validates values across simulations", () => {
+    const customSimulation = {
+        name: "custom",
+        setup: async (lix) => lix,
+    };
+    simulationTest("", async ({ expectDeterministic }) => {
+        // These should be consistent across all simulations
+        expect(() => {
+            expectDeterministic("same-string").toBe("same-string");
+            expectDeterministic(42).toBe(42);
+            expectDeterministic({ foo: "bar" }).toEqual({ foo: "bar" });
+            expectDeterministic([1, 2, 3]).toEqual([1, 2, 3]);
+        }).not.toThrow();
+    }, {
+        simulations: [normalSimulation, customSimulation],
+    });
+});
+describe("expectDeterministic catches simulation differences", () => {
+    const customSimulation = {
+        name: "custom",
+        setup: async (lix) => lix,
+    };
+    simulationTest("", async ({ simulation, expectDeterministic }) => {
+        // This will store different values in different simulations
+        const simulationSpecificValue = simulation.name === "normal" ? "normal-value" : "other-value";
+        if (simulation.name === "normal") {
+            // This will fail in the second simulation
+            expect(() => expectDeterministic(simulationSpecificValue).toBe("normal-value")).not.toThrow();
+        }
+        else {
+            expect(() => expectDeterministic(simulationSpecificValue).toBe("normal-value")).toThrow(/SIMULATION DETERMINISM VIOLATION/);
+        }
+    }, {
+        simulations: [normalSimulation, customSimulation],
+    });
+});
+describe("deterministic state validation", () => {
+    // Testing this with materialized state and the changes the lix has
+    // Both need to be exactly the same for all simulations
+    let previousState = null;
+    let previousChanges = null;
+    const mockSimulation = {
+        name: "mock-simulation",
+        setup: async (lix) => lix,
+    };
+    simulationTest("", async ({ openSimulatedLix }) => {
+        const lix = await openSimulatedLix({
+            keyValues: [
+                {
+                    key: "lix_deterministic_mode",
+                    value: { enabled: true, bootstrap: true },
+                    lixcol_version_id: "global",
+                },
+            ],
+        });
+        const allState = await lix.db
+            .selectFrom("state_by_version")
+            .selectAll()
+            .execute();
+        const changes = await lix.db.selectFrom("change").selectAll().execute();
+        if (previousState === null) {
+            previousState = allState;
+            previousChanges = changes;
+        }
+        else {
+            expect(previousState).toEqual(allState);
+            expect(previousChanges).toEqual(changes);
+        }
+        expect(allState).toBeDefined();
+    }, {
+        simulations: [normalSimulation, mockSimulation],
+    });
+});
+describe("database operations are deterministic", async () => {
+    const mockSimulation = {
+        name: "mock-simulation",
+        setup: async (lix) => lix,
+    };
+    simulationTest("", async ({ expectDeterministic, openSimulatedLix }) => {
+        const lix = await openSimulatedLix({
+            keyValues: [
+                {
+                    key: "lix_deterministic_mode",
+                    value: { enabled: true },
+                    lixcol_version_id: "global",
+                },
+            ],
+        });
+        // Testing two types of entity views that exist:
+        // 1. Regular entity view (on key_value table)
+        // 2. File entity view (whish is a special case because it aggregates multiple entities into one)
+        // regular entity view
+        await lix.db
+            .insertInto("key_value")
+            .values({
+            key: "test_key",
+            value: "test_value",
+        })
+            .execute();
+        // special entity view
+        await lix.db
+            .insertInto("file")
+            .values({
+            path: "/test.txt",
+            data: new TextEncoder().encode("test content"),
+        })
+            .execute();
+        // Get all tables and views from the database
+        const { rows: tableRows } = lix.engine.executeSync({
+            sql: `SELECT name FROM sqlite_master 
+				WHERE type IN ('table', 'view') 
+				AND name NOT LIKE 'sqlite_%'
+				ORDER BY name`,
+            parameters: [],
+        });
+        const tablesAndViews = tableRows.map((row) => String(row.name));
+        // Query each table/view and check determinism
+        for (const tableName of tablesAndViews) {
+            const { rows } = lix.engine.executeSync({
+                sql: `SELECT * FROM "${tableName}"`,
+                parameters: [],
+            });
+            try {
+                expectDeterministic(rows).toBeDefined();
+            }
+            catch (error) {
+                throw new Error(`Determinism check failed for table/view "${tableName}": ${error}`);
+            }
+        }
+    }, {
+        simulations: [normalSimulation, mockSimulation],
+    });
+});
+describe("providing key values", async () => {
+    simulationTest("", async ({ openSimulatedLix }) => {
+        const lix = await openSimulatedLix({
+            keyValues: [
+                {
+                    key: "lix_deterministic_mode",
+                    value: { enabled: true, bootstrap: true },
+                    lixcol_version_id: "global",
+                },
+                { key: "test_key_1", value: ["*"], lixcol_version_id: "global" },
+            ],
+        });
+        commit({ engine: lix.engine });
+        const logLevels = await lix.db
+            .selectFrom("key_value")
+            .where("key", "=", "test_key_1")
+            .selectAll()
+            .execute();
+        expect(logLevels).toMatchObject([
+            {
+                key: "test_key_1",
+                value: ["*"],
+            },
+        ]);
+    }, { simulations: [normalSimulation] });
+});
+describe("expectDeterministic diff callback receives correct values", () => {
+    // Use a global store that persists across test runs
+    const globalStore = globalThis;
+    if (!globalStore.__testCallback1) {
+        globalStore.__testCallback1 = {};
+    }
+    // Reset before this test suite
+    globalStore.__testCallback1 = {
+        invoked: false,
+        actual: undefined,
+        expected: undefined,
+    };
+    const testSimulation = {
+        name: "test-diff-callback",
+        setup: async (lix) => lix,
+    };
+    simulationTest("", async ({ expectDeterministic, simulation }) => {
+        const store = globalStore.__testCallback1;
+        if (simulation.name === "normal") {
+            // First simulation - set the expected value
+            const testValue = { foo: "bar", count: 42 };
+            expectDeterministic(testValue).toBeDefined();
+        }
+        else {
+            // Second simulation - use different value to trigger callback and error
+            const differentValue = { foo: "baz", count: 100 };
+            try {
+                expectDeterministic(differentValue, ({ actual, expected }) => {
+                    store.invoked = true;
+                    store.actual = actual;
+                    store.expected = expected;
+                }).toBeDefined();
+            }
+            catch {
+                // Expected to throw after callback
+            }
+        }
+    }, {
+        simulations: [normalSimulation, testSimulation],
+    });
+    test("callback was invoked with correct values", () => {
+        const { invoked, actual, expected } = globalStore.__testCallback1;
+        // Verify callback was invoked before the error
+        expect(invoked).toBe(true);
+        // Verify actual value matches what was passed in second simulation
+        expect(actual).toEqual({ foo: "baz", count: 100 });
+        // Verify expected value matches what was passed in first simulation
+        expect(expected).toEqual({ foo: "bar", count: 42 });
+    });
+});
+describe("expectDeterministic diff callback is not invoked when values match", () => {
+    // Use a global store that persists across test runs
+    const globalStore = globalThis;
+    if (!globalStore.__testCallback2) {
+        globalStore.__testCallback2 = {};
+    }
+    // Reset before this test suite
+    globalStore.__testCallback2 = { invoked: false };
+    const testSimulation = {
+        name: "test-no-diff",
+        setup: async (lix) => lix,
+    };
+    simulationTest("", async ({ expectDeterministic }) => {
+        const store = globalStore.__testCallback2;
+        const sameValue = { consistent: true, data: [1, 2, 3] };
+        expectDeterministic(sameValue, () => {
+            store.invoked = true;
+        }).toBeDefined();
+    }, {
+        simulations: [normalSimulation, testSimulation],
+    });
+    test("callback should not be invoked", () => {
+        expect(globalStore.__testCallback2.invoked).toBe(false);
+    });
+});
+describe("skip option filters out specified simulations", () => {
+    const globalStore = globalThis;
+    if (!globalStore.__skipTest) {
+        globalStore.__skipTest = {};
+    }
+    // Reset before this test suite
+    globalStore.__skipTest = {
+        normalRan: false,
+        cacheMissRan: false,
+        customRan: false,
+    };
+    const customSimulation = {
+        name: "custom-for-skip-test",
+        setup: async (lix) => lix,
+    };
+    simulationTest("", async ({ simulation }) => {
+        const store = globalStore.__skipTest;
+        // Track which simulations actually ran
+        if (simulation.name === "normal") {
+            store.normalRan = true;
+        }
+        else if (simulation.name === "cache-miss") {
+            store.cacheMissRan = true;
+        }
+        else if (simulation.name === "custom-for-skip-test") {
+            store.customRan = true;
+        }
+    }, {
+        simulations: [normalSimulation, customSimulation], // Skip cache-miss by not including it
+    });
+    test("should run normal simulation", () => {
+        expect(globalStore.__skipTest.normalRan).toBe(true);
+    });
+    test("should skip cache-miss simulation", () => {
+        expect(globalStore.__skipTest.cacheMissRan).toBe(false);
+    });
+    test("should run custom simulation (not affected by skip)", () => {
+        expect(globalStore.__skipTest.customRan).toBe(true);
+    });
+});
+describe("skip option combined with onlyRun", () => {
+    const globalStore = globalThis;
+    if (!globalStore.__skipOnlyRunTest) {
+        globalStore.__skipOnlyRunTest = {};
+    }
+    // Reset before this test suite
+    globalStore.__skipOnlyRunTest = {
+        normalRan: false,
+        cacheMissRan: false,
+    };
+    simulationTest("", async ({ simulation }) => {
+        const store = globalStore.__skipOnlyRunTest;
+        // Track which simulations actually ran
+        if (simulation.name === "normal") {
+            store.normalRan = true;
+        }
+        else if (simulation.name === "cache-miss") {
+            store.cacheMissRan = true;
+        }
+    }, {
+        simulations: [normalSimulation], // Only run normal (equivalent to including both but skipping cache-miss)
+    });
+    test("should run normal simulation (included and not skipped)", () => {
+        expect(globalStore.__skipOnlyRunTest.normalRan).toBe(true);
+    });
+    test("should skip cache-miss simulation (included but then skipped)", () => {
+        expect(globalStore.__skipOnlyRunTest.cacheMissRan).toBe(false);
+    });
+});
+//# sourceMappingURL=simulation-test.test.js.map

package/dist/test-utilities/simulation-test/simulation-test.test.js.map

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

package/dist/version/create-version-from-commit.d.ts

@@ -0,0 +1,44 @@
+import type { Lix } from "../lix/open-lix.js";
+import type { LixCommit } from "../commit/schema-definition.js";
+import type { LixVersion } from "./schema-definition.js";
+/**
+ * Creates a new version that starts at a specific commit.
+ *
+ * - Points the new version's `commit_id` to the provided commit.
+ * - Generates a fresh `working_commit_id` that references an empty change set (global scope).
+ * - Does not modify the active version or any other versions.
+ * - Inheritance lineage is controlled via `inheritsFrom` and defaults to `"global"`.
+ *
+ * @param args.lix - The Lix instance.
+ * @param args.commit - The commit to branch from (only `id` is required).
+ * @param args.id - Optional explicit version id.
+ * @param args.name - Optional version name.
+ * @param args.inheritsFrom - Optional lineage: a parent version to inherit from, or `null` to disable; defaults to `"global"`.
+ *
+ * @example
+ * // Branch from a commit
+ * const v = await createVersionFromCommit({ lix, commit });
+ *
+ * @example
+ * // Custom id and name
+ * const v = await createVersionFromCommit({ lix, commit, id: "my-id", name: "My Branch" });
+ *
+ * @example
+ * // Inherit from a specific version
+ * const parent = await createVersion({ lix, name: "base" });
+ * const v = await createVersionFromCommit({ lix, commit, inheritsFrom: parent });
+ *
+ * @example
+ * // Opt-out of inheritance
+ * const v = await createVersionFromCommit({ lix, commit, inheritsFrom: null });
+ *
+ * @throws If the provided commit id does not exist.
+ */
+export declare function createVersionFromCommit(args: {
+    lix: Lix;
+    commit: Pick<LixCommit, "id">;
+    id?: LixVersion["id"];
+    name?: LixVersion["name"];
+    inheritsFrom?: LixVersion | Pick<LixVersion, "id"> | null;
+}): Promise<LixVersion>;
+//# sourceMappingURL=create-version-from-commit.d.ts.map

package/dist/version/create-version-from-commit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-version-from-commit.d.ts","sourceRoot":"","sources":["../../src/version/create-version-from-commit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,KAAK,EACX,UAAU,EAGV,MAAM,wBAAwB,CAAC;AAMhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IACnD,GAAG,EAAE,GAAG,CAAC;IACT,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC9B,EAAE,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IACtB,IAAI,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAC1B,YAAY,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC;CAC1D,GAAG,OAAO,CAAC,UAAU,CAAC,CAyFtB"}

package/dist/version/create-version-from-commit.js

@@ -0,0 +1,119 @@
+import { createChangeSet } from "../change-set/create-change-set.js";
+import { uuidV7 } from "../engine/functions/uuid-v7.js";
+import { humanId } from "../engine/functions/generate-human-id.js";
+// Use state_by_version to write descriptor + tip; vtable commit handles persistence + cache
+/**
+ * Creates a new version that starts at a specific commit.
+ *
+ * - Points the new version's `commit_id` to the provided commit.
+ * - Generates a fresh `working_commit_id` that references an empty change set (global scope).
+ * - Does not modify the active version or any other versions.
+ * - Inheritance lineage is controlled via `inheritsFrom` and defaults to `"global"`.
+ *
+ * @param args.lix - The Lix instance.
+ * @param args.commit - The commit to branch from (only `id` is required).
+ * @param args.id - Optional explicit version id.
+ * @param args.name - Optional version name.
+ * @param args.inheritsFrom - Optional lineage: a parent version to inherit from, or `null` to disable; defaults to `"global"`.
+ *
+ * @example
+ * // Branch from a commit
+ * const v = await createVersionFromCommit({ lix, commit });
+ *
+ * @example
+ * // Custom id and name
+ * const v = await createVersionFromCommit({ lix, commit, id: "my-id", name: "My Branch" });
+ *
+ * @example
+ * // Inherit from a specific version
+ * const parent = await createVersion({ lix, name: "base" });
+ * const v = await createVersionFromCommit({ lix, commit, inheritsFrom: parent });
+ *
+ * @example
+ * // Opt-out of inheritance
+ * const v = await createVersionFromCommit({ lix, commit, inheritsFrom: null });
+ *
+ * @throws If the provided commit id does not exist.
+ */
+export async function createVersionFromCommit(args) {
+    const executeInTransaction = async (trx) => {
+        // Ensure the referenced commit exists (global scope)
+        const commitRow = await trx
+            .selectFrom("commit_by_version")
+            .where("id", "=", args.commit.id)
+            .where("lixcol_version_id", "=", "global")
+            .select(["id"])
+            .executeTakeFirst();
+        if (!commitRow) {
+            throw new Error(`Commit with id '${args.commit.id}' does not exist`);
+        }
+        // Create a working (empty) change set for the new version
+        const workingCs = await createChangeSet({
+            lix: { ...args.lix, db: trx },
+            lixcol_version_id: "global",
+        });
+        const workingCommitId = await uuidV7({ lix: args.lix });
+        await trx
+            .insertInto("commit_by_version")
+            .values({
+            id: workingCommitId,
+            change_set_id: workingCs.id,
+            lixcol_version_id: "global",
+        })
+            .execute();
+        // Determine inheritance
+        const inherits_from_version_id = args.inheritsFrom === undefined
+            ? "global"
+            : args.inheritsFrom === null
+                ? null
+                : args.inheritsFrom.id;
+        const versionId = args.id ?? (await uuidV7({ lix: { ...args.lix } }));
+        const versionName = args.name ?? (await humanId({ lix: { ...args.lix, db: trx } }));
+        // Insert descriptor and tip via state_by_version; vtable commit will persist+materialize
+        await trx
+            .insertInto("state_by_version")
+            .values([
+            {
+                entity_id: versionId,
+                schema_key: "lix_version_descriptor",
+                file_id: "lix",
+                version_id: "global",
+                plugin_key: "lix_sdk",
+                snapshot_content: {
+                    id: versionId,
+                    name: versionName,
+                    inherits_from_version_id,
+                    hidden: false,
+                },
+                schema_version: "1.0",
+            },
+            {
+                entity_id: versionId,
+                schema_key: "lix_version_tip",
+                file_id: "lix",
+                version_id: "global",
+                plugin_key: "lix_sdk",
+                snapshot_content: {
+                    id: versionId,
+                    commit_id: args.commit.id,
+                    working_commit_id: workingCommitId,
+                },
+                schema_version: "1.0",
+            },
+        ])
+            .execute();
+        // Return the new merged version (descriptor + tip)
+        return {
+            id: versionId,
+            name: versionName,
+            commit_id: args.commit.id,
+            working_commit_id: workingCommitId,
+            inherits_from_version_id,
+            hidden: false,
+        };
+    };
+    return args.lix.db.isTransaction
+        ? executeInTransaction(args.lix.db)
+        : args.lix.db.transaction().execute(executeInTransaction);
+}
+//# sourceMappingURL=create-version-from-commit.js.map

package/dist/version/create-version-from-commit.js.map

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

package/dist/version/create-version-from-commit.test.d.ts

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

package/dist/version/create-version-from-commit.test.d.ts.map

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