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

package/dist/test-utilities/simulation-test/out-of-order-sequence-simulation.d.ts

@@ -1,10 +0,0 @@
-import type { SimulationTestDef } from "./simulation-test.js";
-/**
- * Out-of-order sequence simulation - Returns shuffled sequence numbers
- * to ensure queries don't rely on ordered IDs or timestamps.
- *
- * This simulation shuffles sequence numbers to catch any code that incorrectly
- * assumes monotonic ordering of IDs, timestamps, or other sequence-based values.
- */
-export declare const outOfOrderSequenceSimulation: SimulationTestDef;
-//# sourceMappingURL=out-of-order-sequence-simulation.d.ts.map

package/dist/test-utilities/simulation-test/out-of-order-sequence-simulation.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"out-of-order-sequence-simulation.d.ts","sourceRoot":"","sources":["../../../src/test-utilities/simulation-test/out-of-order-sequence-simulation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,EAAE,iBAiD1C,CAAC"}

package/dist/test-utilities/simulation-test/out-of-order-sequence-simulation.js

@@ -1,50 +0,0 @@
-import { vi } from "vitest";
-import * as tsModule from "../../engine/functions/timestamp.js";
-/**
- * Out-of-order sequence simulation - Returns shuffled sequence numbers
- * to ensure queries don't rely on ordered IDs or timestamps.
- *
- * This simulation shuffles sequence numbers to catch any code that incorrectly
- * assumes monotonic ordering of IDs, timestamps, or other sequence-based values.
- */
-export const outOfOrderSequenceSimulation = {
-    name: "out-of-order-sequence",
-    setup: async (lix) => {
-        // Simple deterministic shuffle function using fixed seed
-        const createShuffledMapping = (maxSequences) => {
-            const normalSequence = Array.from({ length: maxSequences }, (_, i) => i);
-            const shuffledSequence = [...normalSequence];
-            // Deterministic shuffle with fixed seed
-            let seed = 12345;
-            const random = () => {
-                seed = (seed * 9301 + 49297) % 233280;
-                return seed / 233280;
-            };
-            for (let i = shuffledSequence.length - 1; i > 0; i--) {
-                const j = Math.floor(random() * (i + 1));
-                const temp = shuffledSequence[i];
-                shuffledSequence[i] = shuffledSequence[j];
-                shuffledSequence[j] = temp;
-            }
-            // Create mapping from normal to shuffled
-            const mapping = new Map();
-            for (let i = 0; i < normalSequence.length; i++) {
-                mapping.set(normalSequence[i], shuffledSequence[i]);
-            }
-            return mapping;
-        };
-        // Pre-generate mapping for first 1000 sequence numbers
-        const shuffleMapping = createShuffledMapping(1000);
-        // Internal counter to track what the "normal" sequence would be
-        // This avoids calling the real sequence function which would change database state
-        let internalCounter = 0;
-        // Mock the async getTimestamp to return shuffled timestamps
-        vi.spyOn(tsModule, "getTimestamp").mockImplementation(async () => {
-            const normal = internalCounter++;
-            const shuffled = shuffleMapping.get(normal) ?? normal;
-            return new Date(shuffled).toISOString();
-        });
-        return lix;
-    },
-};
-//# sourceMappingURL=out-of-order-sequence-simulation.js.map

package/dist/test-utilities/simulation-test/out-of-order-sequence-simulation.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"out-of-order-sequence-simulation.js","sourceRoot":"","sources":["../../../src/test-utilities/simulation-test/out-of-order-sequence-simulation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,QAAQ,MAAM,qCAAqC,CAAC;AAGhE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAsB;IAC9D,IAAI,EAAE,uBAAuB;IAC7B,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACpB,yDAAyD;QACzD,MAAM,qBAAqB,GAAG,CAC7B,YAAoB,EACE,EAAE;YACxB,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;YACzE,MAAM,gBAAgB,GAAG,CAAC,GAAG,cAAc,CAAC,CAAC;YAE7C,wCAAwC;YACxC,IAAI,IAAI,GAAG,KAAK,CAAC;YACjB,MAAM,MAAM,GAAG,GAAG,EAAE;gBACnB,IAAI,GAAG,CAAC,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC,GAAG,MAAM,CAAC;gBACtC,OAAO,IAAI,GAAG,MAAM,CAAC;YACtB,CAAC,CAAC;YAEF,KAAK,IAAI,CAAC,GAAG,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtD,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBACzC,MAAM,IAAI,GAAG,gBAAgB,CAAC,CAAC,CAAE,CAAC;gBAClC,gBAAgB,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAE,CAAC;gBAC3C,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;YAC5B,CAAC;YAED,yCAAyC;YACzC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;YAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,cAAc,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAChD,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAE,EAAE,gBAAgB,CAAC,CAAC,CAAE,CAAC,CAAC;YACvD,CAAC;YAED,OAAO,OAAO,CAAC;QAChB,CAAC,CAAC;QAEF,uDAAuD;QACvD,MAAM,cAAc,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;QAEnD,gEAAgE;QAChE,mFAAmF;QACnF,IAAI,eAAe,GAAG,CAAC,CAAC;QAExB,4DAA4D;QAC5D,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,kBAAkB,CAAC,KAAK,IAAI,EAAE;YAChE,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;YACjC,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC;YACtD,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,OAAO,GAAG,CAAC;IACZ,CAAC;CACD,CAAC"}

package/dist/test-utilities/simulation-test/out-of-order-sequence-simulation.test.d.ts

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

package/dist/test-utilities/simulation-test/out-of-order-sequence-simulation.test.d.ts.map

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

package/dist/test-utilities/simulation-test/out-of-order-sequence-simulation.test.js

@@ -1,71 +0,0 @@
-import { expect, test } from "vitest";
-import { simulationTest } from "./simulation-test.js";
-import { getTimestamp } from "../../engine/functions/timestamp.js";
-import { outOfOrderSequenceSimulation } from "./out-of-order-sequence-simulation.js";
-test("out-of-order sequence simulation test discovery", () => { });
-simulationTest("out-of-order sequence simulation returns non-monotonic sequence numbers", async ({ openSimulatedLix }) => {
-    const lix = await openSimulatedLix({
-        keyValues: [
-            {
-                key: "lix_deterministic_mode",
-                value: { enabled: true },
-                lixcol_version_id: "global",
-                lixcol_untracked: true,
-            },
-        ],
-    });
-    // Get several logical timestamps
-    const sequences = [];
-    for (let i = 0; i < 10; i++) {
-        sequences.push(Date.parse(await getTimestamp({ lix })));
-    }
-    // In out-of-order simulation, sequences should not be monotonic
-    // We'll check if any sequence is smaller than a previous one
-    let foundOutOfOrder = false;
-    for (let i = 1; i < sequences.length; i++) {
-        if (sequences[i] < sequences[i - 1]) {
-            foundOutOfOrder = true;
-            break;
-        }
-    }
-    expect(foundOutOfOrder).toBe(true);
-    expect(sequences).toHaveLength(10);
-}, {
-    simulations: [outOfOrderSequenceSimulation],
-});
-simulationTest("out-of-order sequence simulation produces correct query results despite shuffled sequences", async ({ openSimulatedLix, expectDeterministic }) => {
-    const lix = await openSimulatedLix({
-        keyValues: [
-            {
-                key: "lix_deterministic_mode",
-                value: { enabled: true, bootstrap: true },
-                lixcol_version_id: "global",
-                lixcol_untracked: true,
-            },
-        ],
-    });
-    // Insert data - this creates changes and change sets
-    await lix.db
-        .insertInto("key_value")
-        .values([
-        { key: "config_a", value: "a" },
-        { key: "config_b", value: "b" },
-        { key: "config_c", value: "c" },
-    ])
-        .execute();
-    // Query state_by_version - results should be consistent within the out-of-order group
-    const stateAll = await lix.db
-        .selectFrom("state_by_version")
-        .where("schema_key", "=", "lix_key_value")
-        .where("entity_id", "!=", "lix_state_cache_stale")
-        .orderBy("entity_id")
-        .selectAll()
-        .execute();
-    const allChanges = await lix.db.selectFrom("change").selectAll().execute();
-    // Results should be deterministic within the out-of-order group
-    expectDeterministic(stateAll).toBeDefined();
-    expectDeterministic(allChanges).toBeDefined();
-}, {
-    simulations: [outOfOrderSequenceSimulation],
-});
-//# sourceMappingURL=out-of-order-sequence-simulation.test.js.map

package/dist/test-utilities/simulation-test/out-of-order-sequence-simulation.test.js.map

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

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

@@ -1,87 +0,0 @@
-import { type Assertion } from "vitest";
-import { type Lix, 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";
-export type SimulationTestDef = {
-    name: string;
-    setup: (lix: Lix, baseline?: Lix) => Promise<Lix>;
-};
-/**
- * Normal simulation - Standard test execution without any modifications.
- */
-declare const normalSimulation: SimulationTestDef;
-/**
- * Options for configuring simulation tests
- */
-type SimulationTestOptions = {
-    /**
-     * Array of simulations to run. If not specified, runs default simulations (normal, cache-miss, engine-boundary).
-     */
-    simulations?: SimulationTestDef[];
-    /**
-     * Optional timeout passed to each generated Vitest test case.
-     */
-    timeout?: number;
-};
-export declare const defaultSimulations: SimulationTestDef[];
-export { engineBoundarySimulation, normalSimulation, cacheMissSimulation, outOfOrderSequenceSimulation, };
-/**
- * Test utility that runs the same test in different simulations.
- *
- * @param name - Test name
- * @param fn - Test function that receives simulation context
- * @param options - Optional configuration:
- *   - simulations: Array of simulations to run (defaults to normal + cache-miss)
- *
- * @example
- * // Run default simulations (normal, cache-miss)
- * simulationTest("my test", async ({ openSimulatedLix, expectDeterministic }) => {
- *   const lix = await openSimulatedLix({});
- *   // test code - expectDeterministic ensures values match across simulations
- * });
- *
- * @example
- * // Run only normal simulation
- * simulationTest("my test", async ({ openSimulatedLix, expectDeterministic }) => {
- *   const lix = await openSimulatedLix({});
- *   // test code
- * }, { simulations: [normalSimulation] });
- *
- * @example
- * // Run custom simulations including out-of-order
- * simulationTest("my test", async ({ openSimulatedLix, expectDeterministic }) => {
- *   const lix = await openSimulatedLix({});
- *   // test code - but be careful with expectDeterministic if using out-of-order!
- * }, { simulations: [cacheMissSimulation, outOfOrderSequenceSimulation] });
- */
-/**
- * Enhanced expect function for simulation tests that verifies values are identical across simulations.
- *
- * @param actual - The value to test
- * @param diffCallback - Optional callback that receives both actual and expected values when they differ.
- *                       This is useful for debugging simulation differences by allowing you to inspect
- *                       and log detailed differences between simulation results before the test fails.
- *                       The callback is only invoked when values actually differ between simulations,
- *                       allowing you to leave debugging code in place without cluttering output when
- *                       tests are passing.
- * @returns Standard expect assertion object
- *
- * @example
- * expectDeterministic(cacheContents, ({ actual, expected }) => {
- *   console.log(`Cache has ${actual.length} vs ${expected.length} entries`);
- *   // Custom diff logic to help debug why simulations differ
- * });
- */
-interface ExpectDeterministic {
-    <T>(actual: T, diffCallback?: (args: {
-        actual: T;
-        expected: T;
-    }) => void): Assertion<T>;
-}
-export declare function simulationTest(name: string, fn: (args: {
-    simulation: SimulationTestDef;
-    openSimulatedLix: typeof openLix;
-    expectDeterministic: ExpectDeterministic;
-}) => Promise<void>, options?: SimulationTestOptions): void;
-//# sourceMappingURL=simulation-test.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"simulation-test.d.ts","sourceRoot":"","sources":["../../../src/test-utilities/simulation-test/simulation-test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,SAAS,EAAM,MAAM,QAAQ,CAAC;AAC1D,OAAO,EAAE,KAAK,GAAG,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,4BAA4B,EAAE,MAAM,uCAAuC,CAAC;AACrF,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAE3E,MAAM,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;CAClD,CAAC;AAEF;;GAEG;AACH,QAAA,MAAM,gBAAgB,EAAE,iBAGvB,CAAC;AAEF;;GAEG;AACH,KAAK,qBAAqB,GAAG;IAC5B;;OAEG;IACH,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAClC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAGF,eAAO,MAAM,kBAAkB,EAAE,iBAAiB,EAKjD,CAAC;AAGF,OAAO,EACN,wBAAwB,EACxB,gBAAgB,EAChB,mBAAmB,EACnB,4BAA4B,GAC5B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH;;;;;;;;;;;;;;;;;GAiBG;AACH,UAAU,mBAAmB;IAC5B,CAAC,CAAC,EACD,MAAM,EAAE,CAAC,EACT,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,CAAC,CAAC;QAAC,QAAQ,EAAE,CAAC,CAAA;KAAE,KAAK,IAAI,GACvD,SAAS,CAAC,CAAC,CAAC,CAAC;CAChB;AAED,wBAAgB,cAAc,CAC7B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,IAAI,EAAE;IACV,UAAU,EAAE,iBAAiB,CAAC;IAC9B,gBAAgB,EAAE,OAAO,OAAO,CAAC;IACjC,mBAAmB,EAAE,mBAAmB,CAAC;CACzC,KAAK,OAAO,CAAC,IAAI,CAAC,EACnB,OAAO,CAAC,EAAE,qBAAqB,GAC7B,IAAI,CAkFN"}

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

@@ -1,89 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

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

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

@@ -1 +0,0 @@
-{"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

@@ -1,308 +0,0 @@
-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