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

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

@@ -0,0 +1,71 @@
+import { expect, test } from "vitest";
+import { simulationTest } from "./simulation-test.js";
+import { nextDeterministicSequenceNumber } from "../../deterministic/sequence.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 sequence numbers
+    const sequences = [];
+    for (let i = 0; i < 10; i++) {
+        sequences.push(nextDeterministicSequenceNumber({ 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_all - results should be consistent within the out-of-order group
+    const stateAll = await lix.db
+        .selectFrom("state_all")
+        .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

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

@@ -0,0 +1,82 @@
+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";
+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).
+     */
+    simulations?: SimulationTestDef[];
+};
+export declare const defaultSimulations: SimulationTestDef[];
+export { 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

@@ -0,0 +1 @@
+{"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;AAErF,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;CAClC,CAAC;AAGF,eAAO,MAAM,kBAAkB,EAAE,iBAAiB,EAGjD,CAAC;AAGF,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,4BAA4B,EAAE,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;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,CA4EN"}

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

@@ -0,0 +1,85 @@
+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";
+/**
+ * Normal simulation - Standard test execution without any modifications.
+ */
+const normalSimulation = {
+    name: "normal",
+    setup: async (lix) => lix,
+};
+// Default simulations available
+export const defaultSimulations = [
+    normalSimulation,
+    cacheMissSimulation,
+];
+// Export individual simulations for custom use
+export { 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) => {
+        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.resetAllMocks();
+    });
+}
+//# 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":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAkB,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC1D,OAAO,EAAY,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,4BAA4B,EAAE,MAAM,uCAAuC,CAAC;AAOrF;;GAEG;AACH,MAAM,gBAAgB,GAAsB;IAC3C,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG;CACzB,CAAC;AAYF,gCAAgC;AAChC,MAAM,CAAC,MAAM,kBAAkB,GAAwB;IACtD,gBAAgB;IAChB,mBAAmB;CACnB,CAAC;AAEF,+CAA+C;AAC/C,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,4BAA4B,EAAE,CAAC;AAwD/E,MAAM,UAAU,cAAc,CAC7B,IAAY,EACZ,EAImB,EACnB,OAA+B;IAE/B,2CAA2C;IAC3C,MAAM,gBAAgB,GAAG,OAAO,EAAE,WAAW,IAAI,kBAAkB,CAAC;IAEpE,MAAM,cAAc,GAAG,IAAI,GAAG,EAAe,CAAC;IAE9C,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,GAAG,IAAI,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE;QACnE,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,MAAM,iBAAiB,GAAG,UAAU,KAAK,gBAAgB,CAAC,CAAC,CAAC,CAAC;QAE7D,MAAM,mBAAmB,GAAG,CAC3B,MAAW,EACX,YAA6D,EAC5D,EAAE;YACH,MAAM,GAAG,GAAG,UAAU,SAAS,EAAE,EAAE,CAAC;YAEpC,IAAI,iBAAiB,EAAE,CAAC;gBACvB,4CAA4C;gBAC5C,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YACjC,CAAC;iBAAM,CAAC;gBACP,iEAAiE;gBACjE,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACzC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;oBAC5B,kDAAkD;oBAClD,IAAI,WAAW,GAAG,KAAK,CAAC;oBACxB,IAAI,CAAC;wBACJ,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;wBACjC,WAAW,GAAG,IAAI,CAAC;oBACpB,CAAC;oBAAC,MAAM,CAAC;wBACR,qBAAqB;oBACtB,CAAC;oBAED,oDAAoD;oBACpD,IAAI,CAAC,WAAW,IAAI,YAAY,EAAE,CAAC;wBAClC,YAAY,CAAC;4BACZ,MAAM;4BACN,QAAQ;yBACR,CAAC,CAAC;oBACJ,CAAC;oBAED,6DAA6D;oBAC7D,MAAM,YAAY,GAAG;;;;;kBAKR,SAAS,GAAG,CAAC;cACjB,UAAU,CAAC,IAAI,OAAO,gBAAgB,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,QAAQ;;;;;CAKxE,CAAC;oBACG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAChD,CAAC;YACF,CAAC;YAED,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC,CAAC;QAEF,mCAAmC;QACnC,MAAM,gBAAgB,GAAG,KAAK,EAAE,IAAmC,EAAE,EAAE;YACtE,uCAAuC;YACvC,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;YAEhC,yBAAyB;YACzB,OAAO,MAAM,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACpC,CAAC,CAAC;QAEF,MAAM,EAAE,CAAC;YACR,UAAU,EAAE,UAAU;YACtB,gBAAgB;YAChB,mBAAmB,EAAE,mBAA0C;SAC/D,CAAC,CAAC;QACH,EAAE,CAAC,aAAa,EAAE,CAAC;IACpB,CAAC,CAAC,CAAC;AACJ,CAAC"}

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,310 @@
+import { describe, expect, test } from "vitest";
+import { simulationTest, normalSimulation, } from "./simulation-test.js";
+import { commit } from "../../state/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_all")
+            .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, bootstrap: 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 tablesAndViews = lix.sqlite
+            .exec({
+            sql: `SELECT name FROM sqlite_master 
+				WHERE type IN ('table', 'view') 
+				AND name NOT LIKE 'sqlite_%'
+				ORDER BY name`,
+            returnValue: "resultRows",
+        })
+            .map((row) => row[0]);
+        // Query each table/view and check determinism
+        for (const tableName of tablesAndViews) {
+            const data = lix.sqlite.exec({
+                sql: `SELECT * FROM "${tableName}"`,
+                returnValue: "resultRows",
+                columnNames: [],
+            });
+            try {
+                expectDeterministic(data).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({ lix });
+        const logLevels = await lix.db
+            .selectFrom("key_value")
+            .where("key", "=", "test_key_1")
+            .selectAll()
+            .execute();
+        expect(logLevels).toMatchObject([
+            {
+                key: "test_key_1",
+                value: ["*"],
+            },
+        ]);
+    });
+});
+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/thread/comment-utils.d.ts

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

package/dist/thread/comment-utils.d.ts.map

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

package/dist/thread/comment-utils.js

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

package/dist/thread/comment-utils.js.map

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

package/dist/thread/comment.d.ts

@@ -0,0 +1,24 @@
+import type { PortableTextBlock } from "@portabletext/types";
+/**
+ * Sanity schema for comment content using Portable Text.
+ * Minimal definition: an array of blocks.
+ */
+export declare const commentContentSchema: {
+    readonly name: "commentContent";
+    readonly title: "Comment Content";
+    readonly type: "array";
+    readonly of: readonly [{
+        readonly type: "block";
+    }];
+};
+/**
+ * Converts plain text to Portable Text blocks.
+ * Splits text by newline into separate blocks.
+ */
+export declare function textToPortableText(text: string): PortableTextBlock[];
+/**
+ * Converts Portable Text blocks to plain text.
+ * Joins spans within each block and blocks with newline.
+ */
+export declare function textFromPortableText(blocks: PortableTextBlock[]): string;
+//# sourceMappingURL=comment.d.ts.map

package/dist/thread/comment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment.d.ts","sourceRoot":"","sources":["../../src/thread/comment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;CAKvB,CAAC;AAEX;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAgBpE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAQxE"}