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

package/dist/change-set/create-transition-change-set.test.js

@@ -0,0 +1,211 @@
+import { expect, test } from "vitest";
+import { openLix } from "../lix/open-lix.js";
+import { mockJsonPlugin, MockJsonPropertySchema, } from "../plugin/mock-json-plugin.js";
+import { createChangeSet } from "./create-change-set.js";
+import { applyChangeSet } from "./apply-change-set.js";
+import { createTransitionChangeSet } from "./create-transition-change-set.js";
+// needs faster graph traversal. currently timing out.
+// related https://github.com/opral/lix-sdk/issues/311
+test.skip("it transitions state to a specific change set", async () => {
+    // Create a Lix instance with our plugin
+    const lix = await openLix({
+        providePlugins: [mockJsonPlugin],
+    });
+    const activeVersion = await lix.db
+        .selectFrom("active_version")
+        .innerJoin("version", "version.id", "active_version.version_id")
+        .selectAll("version")
+        .executeTakeFirstOrThrow();
+    // Insert the schema that the mockJsonPlugin uses
+    await lix.db
+        .insertInto("stored_schema")
+        .values({
+        value: MockJsonPropertySchema,
+    })
+        .execute();
+    // Create a file
+    await lix.db
+        .insertInto("file")
+        .values({
+        id: "file1",
+        data: new TextEncoder().encode(""),
+        path: "/test.json",
+    })
+        .execute();
+    const file = await lix.db
+        .selectFrom("file")
+        .selectAll()
+        .where("id", "=", "file1")
+        .executeTakeFirstOrThrow();
+    const changes = await lix.db
+        .insertInto("change")
+        .values([
+        {
+            id: "c0",
+            file_id: file.id,
+            plugin_key: mockJsonPlugin.key,
+            entity_id: "l0",
+            schema_key: "mock_json_property",
+            schema_version: "1.0",
+            snapshot_content: { value: "Value 0" },
+        },
+        {
+            id: "c1",
+            file_id: file.id,
+            plugin_key: mockJsonPlugin.key,
+            entity_id: "l1",
+            schema_key: "mock_json_property",
+            schema_version: "1.0",
+            snapshot_content: { value: "Value 1" },
+        },
+        {
+            id: "c2",
+            file_id: file.id,
+            plugin_key: mockJsonPlugin.key,
+            entity_id: "l2",
+            schema_key: "mock_json_property",
+            schema_version: "1.0",
+            snapshot_content: { value: "Value 2" },
+        },
+        {
+            id: "c3",
+            file_id: file.id,
+            plugin_key: mockJsonPlugin.key,
+            entity_id: "l2",
+            schema_key: "mock_json_property",
+            schema_version: "1.0",
+            snapshot_content: { value: "Value 2 Modified" },
+        },
+        {
+            id: "c4",
+            file_id: file.id,
+            plugin_key: mockJsonPlugin.key,
+            entity_id: "l3",
+            schema_key: "mock_json_property",
+            schema_version: "1.0",
+            snapshot_content: { value: "Value 3" },
+        },
+        {
+            id: "c5", // Add another change/entity for complexity
+            entity_id: "l4",
+            file_id: "file1",
+            schema_key: "mock_json_property",
+            schema_version: "1.0",
+            plugin_key: mockJsonPlugin.key,
+            snapshot_content: { value: "Value 4" },
+        },
+    ])
+        .returningAll()
+        .execute();
+    const cs0 = await createChangeSet({
+        lix,
+        id: "cs0",
+        elements: [changes[0], changes[1], changes[2]].map((change) => ({
+            change_id: change.id,
+            entity_id: change.entity_id,
+            schema_key: change.schema_key,
+            file_id: change.file_id,
+        })),
+    });
+    const cs1 = await createChangeSet({
+        lix,
+        id: "cs1",
+        elements: [changes[3]].map((change) => ({
+            change_id: change.id,
+            entity_id: change.entity_id,
+            schema_key: change.schema_key,
+            file_id: change.file_id,
+        })),
+        parents: [cs0],
+    });
+    const cs2 = await createChangeSet({
+        lix,
+        id: "cs2",
+        elements: [changes[4], changes[5]].map((change) => ({
+            change_id: change.id,
+            entity_id: change.entity_id,
+            schema_key: change.schema_key,
+            file_id: change.file_id,
+        })),
+        parents: [cs1],
+    });
+    // Apply change sets in order: cs0, then cs1, then cs2
+    // This demonstrates the explicit, predictable "direct" behavior
+    await applyChangeSet({
+        lix,
+        changeSet: cs0,
+    });
+    const fileCs0Before = await lix.db
+        .selectFrom("file")
+        .where("id", "=", file.id)
+        .selectAll()
+        .executeTakeFirstOrThrow();
+    // The file data should now be a JSON string representing the state at cs0
+    const expectedJsonStateCs0 = {
+        l0: "Value 0",
+        l1: "Value 1",
+        l2: "Value 2",
+    };
+    const actualJsonStateCs0 = JSON.parse(new TextDecoder().decode(fileCs0Before.data));
+    expect(actualJsonStateCs0).toEqual(expectedJsonStateCs0);
+    // Apply cs1 (which modifies l2 to "Value 2 Modified")
+    await applyChangeSet({
+        lix,
+        changeSet: cs1,
+    });
+    // Apply cs2 (which adds l3 and l4)
+    await applyChangeSet({
+        lix,
+        changeSet: cs2,
+    });
+    // Verify initial state
+    const fileAfterRestoreCs2 = await lix.db
+        .selectFrom("file")
+        .where("id", "=", file.id)
+        .selectAll()
+        .executeTakeFirstOrThrow();
+    // The file data should now be a JSON string representing the state at cs2
+    const expectedJsonStateCs2 = {
+        l0: "Value 0",
+        l1: "Value 1",
+        l2: "Value 2 Modified", // c3 replaced c2
+        l3: "Value 3", // c4 added
+        l4: "Value 4", // c5 added
+    };
+    const actualJsonStateCs2 = JSON.parse(new TextDecoder().decode(fileAfterRestoreCs2.data));
+    expect(actualJsonStateCs2).toEqual(expectedJsonStateCs2);
+    // Action: Create transition change set to restore to cs0
+    const transitionChangeSet = await createTransitionChangeSet({
+        lix,
+        sourceChangeSet: cs2,
+        targetChangeSet: cs0,
+    });
+    // Apply the transition change set
+    await applyChangeSet({
+        lix,
+        changeSet: transitionChangeSet,
+    });
+    // Verify final state
+    // 1. Check that versions change set parent is cs2
+    const finalVersion = await lix.db
+        .selectFrom("version")
+        .where("id", "=", activeVersion.id)
+        .select(["change_set_id"])
+        .executeTakeFirstOrThrow();
+    const parentCs = await lix.db
+        .selectFrom("change_set_edge")
+        .where("child_id", "=", finalVersion.change_set_id)
+        .select(["parent_id"])
+        .executeTakeFirstOrThrow();
+    expect(parentCs.parent_id).toBe(cs2.id);
+    // 2. Check if data is updated
+    const finalFile = await lix.db
+        .selectFrom("file")
+        .where("id", "=", file.id)
+        .selectAll()
+        .executeTakeFirstOrThrow();
+    // The file data should now be a JSON string representing the state at cs0
+    const actualJsonState = JSON.parse(new TextDecoder().decode(finalFile.data));
+    expect(actualJsonState).toEqual(expectedJsonStateCs0);
+});
+//# sourceMappingURL=create-transition-change-set.test.js.map

package/dist/change-set/create-transition-change-set.test.js.map

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

package/dist/change-set/create-undo-change-set.d.ts

@@ -0,0 +1,27 @@
+import type { Lix } from "../lix/index.js";
+import type { ChangeSet } from "./schema.js";
+import type { Label } from "../label/schema.js";
+/**
+ * Creates a "reverse" change set that undoes the changes made by the specified change set.
+ *
+ * @example
+ *   ```ts
+ *   const undoChangeSet = await createUndoChangeSet({
+ *     lix,
+ *     changeSet: targetChangeSet
+ *   });
+ *
+ *   await applyChangeSet({
+ *     lix,
+ *     changeSet: undoChangeSet
+ *   });
+ *   ```
+ *
+ * @returns The newly created change set that contains the undo operations
+ */
+export declare function createUndoChangeSet(args: {
+    lix: Lix;
+    changeSet: Pick<ChangeSet, "id">;
+    labels?: Pick<Label, "id">[];
+}): Promise<ChangeSet>;
+//# sourceMappingURL=create-undo-change-set.d.ts.map

package/dist/change-set/create-undo-change-set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-undo-change-set.d.ts","sourceRoot":"","sources":["../../src/change-set/create-undo-change-set.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAIhD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC/C,GAAG,EAAE,GAAG,CAAC;IACT,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;CAC7B,GAAG,OAAO,CAAC,SAAS,CAAC,CAqHrB"}

package/dist/change-set/create-undo-change-set.js

@@ -0,0 +1,121 @@
+import { createChangeSet } from "./create-change-set.js";
+import { v7 } from "uuid";
+/**
+ * Creates a "reverse" change set that undoes the changes made by the specified change set.
+ *
+ * @example
+ *   ```ts
+ *   const undoChangeSet = await createUndoChangeSet({
+ *     lix,
+ *     changeSet: targetChangeSet
+ *   });
+ *
+ *   await applyChangeSet({
+ *     lix,
+ *     changeSet: undoChangeSet
+ *   });
+ *   ```
+ *
+ * @returns The newly created change set that contains the undo operations
+ */
+export async function createUndoChangeSet(args) {
+    const executeInTransaction = async (trx) => {
+        // Check for multiple parents (not supported yet)
+        const parents = await trx
+            .selectFrom("change_set_edge_all")
+            .where("lixcol_version_id", "=", "global")
+            .where("child_id", "=", args.changeSet.id)
+            .select("parent_id")
+            .execute();
+        if (parents.length > 1) {
+            throw new Error("Cannot undo change sets with multiple parents (merge scenarios not yet supported)");
+        }
+        // Get all changes in the target change set (direct changes only, non-recursive)
+        const targetChanges = await trx
+            .selectFrom("change")
+            .innerJoin("change_set_element_all", "change_set_element_all.change_id", "change.id")
+            .where("change_set_element_all.lixcol_version_id", "=", "global")
+            .where("change_set_element_all.change_set_id", "=", args.changeSet.id)
+            .selectAll("change")
+            .execute();
+        const undoChanges = [];
+        for (const change of targetChanges) {
+            if (parents.length === 0) {
+                // No parent = this was the first change set, undo = delete everything
+                undoChanges.push({
+                    entity_id: change.entity_id,
+                    file_id: change.file_id,
+                    plugin_key: change.plugin_key,
+                    schema_key: change.schema_key,
+                    schema_version: change.schema_version,
+                    snapshot_content: null, // Mark as deletion
+                });
+            }
+            else {
+                // Find the previous state in the parent change set
+                const parentChangeSet = parents[0].parent_id;
+                const previousChange = await trx
+                    .selectFrom("change")
+                    .innerJoin("change_set_element", "change_set_element.change_id", "change.id")
+                    .where("change_set_element.change_set_id", "=", parentChangeSet)
+                    .where("change_set_element.entity_id", "=", change.entity_id)
+                    .where("change_set_element.file_id", "=", change.file_id)
+                    .where("change_set_element.schema_key", "=", change.schema_key)
+                    .selectAll("change")
+                    .executeTakeFirst();
+                if (previousChange) {
+                    // Restore to previous state
+                    undoChanges.push({
+                        id: v7(),
+                        entity_id: change.entity_id,
+                        file_id: change.file_id,
+                        plugin_key: change.plugin_key,
+                        schema_key: change.schema_key,
+                        schema_version: change.schema_version,
+                        snapshot_content: previousChange.snapshot_content, // Restore previous snapshot
+                    });
+                }
+                else {
+                    // Entity didn't exist before, so delete it
+                    undoChanges.push({
+                        id: v7(),
+                        entity_id: change.entity_id,
+                        file_id: change.file_id,
+                        plugin_key: change.plugin_key,
+                        schema_key: change.schema_key,
+                        schema_version: change.schema_version,
+                        snapshot_content: null, // Mark as deletion
+                    });
+                }
+            }
+        }
+        // Insert the undo changes
+        const createdUndoChanges = undoChanges.length > 0
+            ? await trx
+                .insertInto("change")
+                .values(undoChanges)
+                .returningAll()
+                .execute()
+            : [];
+        // Create the undo change set
+        const undoChangeSet = await createChangeSet({
+            lix: { ...args.lix, db: trx },
+            labels: args.labels,
+            lixcol_version_id: "global",
+            elements: createdUndoChanges.map((change) => ({
+                change_id: change.id,
+                entity_id: change.entity_id,
+                schema_key: change.schema_key,
+                file_id: change.file_id,
+            })),
+        });
+        return undoChangeSet;
+    };
+    if (args.lix.db.isTransaction) {
+        return executeInTransaction(args.lix.db);
+    }
+    else {
+        return args.lix.db.transaction().execute(executeInTransaction);
+    }
+}
+//# sourceMappingURL=create-undo-change-set.js.map

package/dist/change-set/create-undo-change-set.js.map

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

package/dist/change-set/create-undo-change-set.test.d.ts

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

package/dist/change-set/create-undo-change-set.test.d.ts.map

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

package/dist/change-set/create-undo-change-set.test.js

@@ -0,0 +1,273 @@
+import { expect, test } from "vitest";
+import { openLix } from "../lix/open-lix.js";
+import { createUndoChangeSet } from "./create-undo-change-set.js";
+import { createChangeSet } from "./create-change-set.js";
+import { applyChangeSet } from "./apply-change-set.js";
+import { mockJsonPlugin, MockJsonPropertySchema, } from "../plugin/mock-json-plugin.js";
+import { createCheckpoint } from "./create-checkpoint.js";
+test("it creates an undo change set that reverses the operations of the original change set", async () => {
+    // Create a Lix instance with the mockJsonPlugin
+    const lix = await openLix({
+        providePlugins: [mockJsonPlugin],
+    });
+    // Insert the schema that the mockJsonPlugin uses
+    await lix.db
+        .insertInto("stored_schema_all")
+        .values({
+        value: MockJsonPropertySchema,
+        lixcol_version_id: "global",
+    })
+        .execute();
+    // Create a file
+    await lix.db
+        .insertInto("file")
+        .values({
+        id: "file1",
+        data: new TextEncoder().encode("{}"),
+        path: "/test.json",
+    })
+        .execute();
+    const file = await lix.db
+        .selectFrom("file")
+        .where("id", "=", "file1")
+        .selectAll()
+        .executeTakeFirstOrThrow();
+    // Create changes for our initial change set
+    const changes = await lix.db
+        .insertInto("change")
+        .values([
+        {
+            id: "c1",
+            file_id: file.id,
+            plugin_key: mockJsonPlugin.key,
+            entity_id: "e1",
+            schema_key: "mock_json_property",
+            snapshot_content: { value: "Value 1" },
+            schema_version: "1.0",
+        },
+        {
+            id: "c2",
+            file_id: file.id,
+            plugin_key: mockJsonPlugin.key,
+            entity_id: "e2",
+            schema_key: "mock_json_property",
+            snapshot_content: { value: "Value 2" },
+            schema_version: "1.0",
+        },
+    ])
+        .returningAll()
+        .execute();
+    // Create a change set with these changes
+    const cs0 = await createChangeSet({
+        lix,
+        id: "cs0",
+        lixcol_version_id: "global",
+        elements: changes.map((change) => ({
+            lixcol_version_id: "global",
+            change_id: change.id,
+            entity_id: change.entity_id,
+            schema_key: change.schema_key,
+            file_id: change.file_id,
+        })),
+    });
+    await applyChangeSet({
+        lix,
+        changeSet: cs0,
+    });
+    // Verify the file has the expected state
+    const fileAfterOriginal = await lix.db
+        .selectFrom("file")
+        .where("id", "=", file.id)
+        .selectAll()
+        .executeTakeFirstOrThrow();
+    const expectedJsonStateOriginal = {
+        e1: "Value 1",
+        e2: "Value 2",
+    };
+    const actualJsonStateOriginal = JSON.parse(new TextDecoder().decode(fileAfterOriginal.data));
+    expect(actualJsonStateOriginal).toEqual(expectedJsonStateOriginal);
+    // Create the undo change set
+    const undoCs = await createUndoChangeSet({
+        lix,
+        changeSet: cs0,
+    });
+    // Verify the undo change set has no parents (the dev is reponsible or by calling applyChanges())
+    const edges = await lix.db
+        .selectFrom("change_set_edge")
+        .selectAll()
+        .where("child_id", "=", undoCs.id)
+        .execute();
+    expect(edges).toHaveLength(0);
+    await applyChangeSet({
+        lix,
+        changeSet: undoCs,
+    });
+    // Verify the file state after undo - should be empty again
+    const fileAfterUndo = await lix.db
+        .selectFrom("file")
+        .where("id", "=", file.id)
+        .selectAll()
+        .executeTakeFirstOrThrow();
+    const actualJsonStateAfterUndo = JSON.parse(new TextDecoder().decode(fileAfterUndo.data));
+    expect(actualJsonStateAfterUndo).toEqual({});
+});
+test("it correctly undoes delete operations by restoring previous state", async () => {
+    // Create a Lix instance with the mockJsonPlugin
+    const lix = await openLix({
+        providePlugins: [mockJsonPlugin],
+    });
+    // Insert the schema that the mockJsonPlugin uses
+    await lix.db
+        .insertInto("stored_schema_all")
+        .values({
+        value: MockJsonPropertySchema,
+        lixcol_version_id: "global",
+    })
+        .execute();
+    // Create a file
+    await lix.db
+        .insertInto("file")
+        .values({
+        id: "file1",
+        data: new TextEncoder().encode("{}"),
+        path: "/test.json",
+    })
+        .execute();
+    const file = await lix.db
+        .selectFrom("file")
+        .where("id", "=", "file1")
+        .selectAll()
+        .executeTakeFirstOrThrow();
+    // First change set - add an entity
+    const initialChanges = await lix.db
+        .insertInto("change")
+        .values([
+        {
+            id: "c1",
+            file_id: file.id,
+            plugin_key: mockJsonPlugin.key,
+            entity_id: "e1",
+            schema_key: "mock_json_property",
+            schema_version: "1.0",
+            snapshot_content: { value: "Initial Value" },
+        },
+    ])
+        .returningAll()
+        .execute();
+    const cs0 = await createChangeSet({
+        lix,
+        id: "cs0",
+        lixcol_version_id: "global",
+        elements: initialChanges.map((change) => ({
+            change_id: change.id,
+            lixcol_version_id: "global",
+            entity_id: change.entity_id,
+            schema_key: change.schema_key,
+            file_id: change.file_id,
+        })),
+    });
+    // Second change set - delete the entity
+    const deleteChanges = await lix.db
+        .insertInto("change")
+        .values([
+        {
+            id: "c2",
+            file_id: file.id,
+            plugin_key: mockJsonPlugin.key,
+            entity_id: "e1",
+            schema_key: "mock_json_property",
+            schema_version: "1.0",
+            snapshot_content: null, // This marks it as a delete operation
+        },
+    ])
+        .returningAll()
+        .execute();
+    // Create cs1 with cs0 as parent (don't apply yet)
+    const cs1 = await createChangeSet({
+        lix,
+        id: "cs1",
+        lixcol_version_id: "global",
+        elements: deleteChanges.map((change) => ({
+            change_id: change.id,
+            lixcol_version_id: "global",
+            entity_id: change.entity_id,
+            schema_key: change.schema_key,
+            file_id: change.file_id,
+        })),
+        parents: [cs0],
+    });
+    // Create undo change set for the delete operation
+    const undoDeleteCs = await createUndoChangeSet({
+        lix,
+        changeSet: cs1,
+    });
+    await applyChangeSet({
+        lix,
+        changeSet: undoDeleteCs,
+    });
+    // Verify the entity is restored to its previous state
+    const fileAfterUndo = await lix.db
+        .selectFrom("file")
+        .where("id", "=", file.id)
+        .selectAll()
+        .executeTakeFirstOrThrow();
+    const stateAfterUndo = JSON.parse(new TextDecoder().decode(fileAfterUndo.data));
+    expect(stateAfterUndo).toEqual({
+        e1: "Initial Value",
+    });
+});
+test.skip("does not naively create delete changes if a previous state existed", async () => {
+    const lix = await openLix({
+        providePlugins: [mockJsonPlugin],
+    });
+    const file = await lix.db
+        .insertInto("file")
+        .values({
+        id: "file1",
+        data: new TextEncoder().encode("{}"),
+        path: "/test.json",
+    })
+        .returningAll()
+        .executeTakeFirstOrThrow();
+    const checkpoints = [];
+    // simulating an undo of peter which should restore { name: "samuel", age: 20 }
+    for (const state of [
+        { name: "Samuel", age: 20 },
+        { name: "Peter", age: 20 },
+    ]) {
+        await lix.db
+            .updateTable("file")
+            .set({ data: new TextEncoder().encode(JSON.stringify(state)) })
+            .execute();
+        checkpoints.push(await createCheckpoint({ lix }));
+    }
+    const fileAfterEdits = await lix.db
+        .selectFrom("file")
+        .where("id", "=", file.id)
+        .selectAll()
+        .executeTakeFirstOrThrow();
+    const jsonStateAfterEdits = JSON.parse(new TextDecoder().decode(fileAfterEdits.data));
+    expect(jsonStateAfterEdits).toEqual({
+        name: "Peter",
+        age: 20,
+    });
+    const undoChangeSet = await createUndoChangeSet({
+        lix,
+        changeSet: checkpoints[1],
+    });
+    await applyChangeSet({
+        lix,
+        changeSet: undoChangeSet,
+    });
+    const fileAfterUndo = await lix.db
+        .selectFrom("file")
+        .where("id", "=", file.id)
+        .selectAll()
+        .executeTakeFirstOrThrow();
+    const jsonAfterUndo = JSON.parse(new TextDecoder().decode(fileAfterUndo.data));
+    expect(jsonAfterUndo).toEqual({
+        name: "Samuel",
+        age: 20,
+    });
+});
+//# sourceMappingURL=create-undo-change-set.test.js.map