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

package/dist/entity-views/entity-state.test.js

@@ -0,0 +1,497 @@
+import { test, expect, describe } from "vitest";
+import { openLix } from "../lix/open-lix.js";
+import { createEntityStateView } from "./entity-state.js";
+describe("createEntityViewIfNotExists", () => {
+    const testSchema = {
+        "x-lix-key": "test_entity",
+        "x-lix-version": "1.0",
+        "x-lix-primary-key": ["id"],
+        type: "object",
+        properties: {
+            id: { type: "string" },
+            name: { type: "string" },
+            value: { type: "number" },
+        },
+        required: ["id", "name"],
+    };
+    const compositeKeySchema = {
+        "x-lix-key": "composite_entity",
+        "x-lix-version": "1.0",
+        "x-lix-primary-key": ["category", "id"],
+        type: "object",
+        properties: {
+            category: { type: "string" },
+            id: { type: "string" },
+            data: { type: "string" },
+        },
+        required: ["category", "id"],
+    };
+    test("should throw error if schema has no primary key", async () => {
+        const lix = await openLix({});
+        const invalidSchema = {
+            "x-lix-key": "invalid_schema",
+            "x-lix-version": "1.0",
+            type: "object",
+            properties: {
+                name: { type: "string" },
+            },
+        };
+        expect(() => {
+            createEntityStateView({
+                lix,
+                schema: invalidSchema,
+                pluginKey: "test_plugin",
+            });
+        }).toThrow("Schema must define 'x-lix-primary-key' for entity view generation");
+    });
+    test("should create view with correct columns (no lixcol_version_id)", async () => {
+        const lix = await openLix({});
+        createEntityStateView({
+            lix,
+            schema: testSchema,
+            overrideName: "test_view",
+            pluginKey: "test_plugin",
+            hardcodedFileId: "test_file",
+        });
+        // Insert test data and verify all expected columns exist
+        await lix.db
+            .insertInto("test_view")
+            .values({
+            id: "test_id",
+            name: "test_name",
+            value: 42,
+        })
+            .execute();
+        // Query the view and check all columns are present
+        const result = await lix.db
+            .selectFrom("test_view")
+            .selectAll()
+            .execute();
+        expect(result).toHaveLength(1);
+        const entity = result[0];
+        // Business logic columns
+        expect(entity).toHaveProperty("id", "test_id");
+        expect(entity).toHaveProperty("name", "test_name");
+        expect(entity).toHaveProperty("value", 42);
+        // Operational columns (regular view doesn't expose lixcol_version_id)
+        expect(entity).not.toHaveProperty("lixcol_version_id");
+        expect(entity).toHaveProperty("lixcol_inherited_from_version_id");
+        expect(entity).toHaveProperty("lixcol_created_at");
+        expect(entity).toHaveProperty("lixcol_updated_at");
+        expect(entity).toHaveProperty("lixcol_file_id", "test_file");
+        expect(entity).toHaveProperty("lixcol_untracked");
+        expect(entity?.lixcol_untracked).toBe(0); // Default value is false (0)
+    });
+    test("should create CRUD triggers", async () => {
+        const lix = await openLix({});
+        createEntityStateView({
+            lix,
+            schema: testSchema,
+            overrideName: "test_view",
+            pluginKey: "test_plugin",
+            hardcodedFileId: "test_file",
+        });
+        // Test that CRUD operations work (which proves triggers exist and function)
+        // INSERT trigger test
+        await lix.db
+            .insertInto("test_view")
+            .values({ id: "test_id", name: "test_name", value: 42 })
+            .execute();
+        let result = await lix.db
+            .selectFrom("test_view")
+            .selectAll()
+            .execute();
+        expect(result).toHaveLength(1);
+        // UPDATE trigger test
+        await lix.db
+            .updateTable("test_view")
+            .where("id", "=", "test_id")
+            .set({ name: "updated_name" })
+            .execute();
+        result = await lix.db
+            .selectFrom("test_view")
+            .selectAll()
+            .execute();
+        expect(result[0]).toMatchObject({ name: "updated_name" });
+        // DELETE trigger test
+        await lix.db
+            .deleteFrom("test_view")
+            .where("id", "=", "test_id")
+            .execute();
+        result = await lix.db
+            .selectFrom("test_view")
+            .selectAll()
+            .execute();
+        expect(result).toHaveLength(0);
+    });
+    test("should handle insert operations without defaults", async () => {
+        const lix = await openLix({});
+        createEntityStateView({
+            lix,
+            schema: testSchema,
+            overrideName: "test_view",
+            pluginKey: "test_plugin",
+            hardcodedFileId: "test_file",
+        });
+        // Insert data through the view
+        await lix.db
+            .insertInto("test_view")
+            .values({
+            id: "test_id",
+            name: "test_name",
+            value: 42,
+        })
+            .execute();
+        // Verify data was inserted into state table
+        const stateData = await lix.db
+            .selectFrom("state_all")
+            .selectAll()
+            .where("schema_key", "=", "test_entity")
+            .execute();
+        expect(stateData).toHaveLength(1);
+        expect(stateData[0]).toMatchObject({
+            entity_id: "test_id",
+            schema_key: "test_entity",
+            file_id: "test_file",
+            plugin_key: "test_plugin",
+            snapshot_content: {
+                id: "test_id",
+                name: "test_name",
+                value: 42,
+            },
+        });
+        // Verify data can be read through the view
+        const viewData = await lix.db
+            .selectFrom("test_view")
+            .selectAll()
+            .execute();
+        expect(viewData).toHaveLength(1);
+        expect(viewData[0]).toMatchObject({
+            id: "test_id",
+            name: "test_name",
+            value: 42,
+        });
+    });
+    test("should handle update operations", async () => {
+        const lix = await openLix({});
+        createEntityStateView({
+            lix,
+            schema: testSchema,
+            overrideName: "test_view",
+            pluginKey: "test_plugin",
+            hardcodedFileId: "test_file",
+        });
+        // Insert initial data
+        await lix.db
+            .insertInto("test_view")
+            .values({
+            id: "test_id",
+            name: "original_name",
+            value: 42,
+        })
+            .execute();
+        // Update through the view
+        await lix.db
+            .updateTable("test_view")
+            .where("id", "=", "test_id")
+            .set({
+            name: "updated_name",
+            value: 100,
+        })
+            .execute();
+        // Verify update in view
+        const viewData = await lix.db
+            .selectFrom("test_view")
+            .selectAll()
+            .execute();
+        expect(viewData).toHaveLength(1);
+        expect(viewData[0]).toMatchObject({
+            id: "test_id",
+            name: "updated_name",
+            value: 100,
+        });
+        // Verify update in state table
+        const stateData = await lix.db
+            .selectFrom("state_all")
+            .selectAll()
+            .where("entity_id", "=", "test_id")
+            .execute();
+        expect(stateData[0]?.snapshot_content).toMatchObject({
+            id: "test_id",
+            name: "updated_name",
+            value: 100,
+        });
+    });
+    test("should handle delete operations", async () => {
+        const lix = await openLix({});
+        createEntityStateView({
+            lix,
+            schema: testSchema,
+            overrideName: "test_view",
+            pluginKey: "test_plugin",
+            hardcodedFileId: "test_file",
+        });
+        // Insert data
+        await lix.db
+            .insertInto("test_view")
+            .values({
+            id: "test_id",
+            name: "test_name",
+            value: 42,
+        })
+            .execute();
+        // Delete through the view
+        await lix.db
+            .deleteFrom("test_view")
+            .where("id", "=", "test_id")
+            .execute();
+        // Verify deletion in view
+        const viewData = await lix.db
+            .selectFrom("test_view")
+            .selectAll()
+            .execute();
+        expect(viewData).toHaveLength(0);
+        // Verify deletion in state table
+        const stateData = await lix.db
+            .selectFrom("state_all")
+            .selectAll()
+            .where("entity_id", "=", "test_id")
+            .execute();
+        expect(stateData).toHaveLength(0);
+    });
+    test("should handle composite primary keys", async () => {
+        const lix = await openLix({});
+        createEntityStateView({
+            lix,
+            schema: compositeKeySchema,
+            overrideName: "composite_view",
+            pluginKey: "test_plugin",
+            hardcodedFileId: "test_file",
+        });
+        // Insert data with composite key
+        await lix.db
+            .insertInto("composite_view")
+            .values({
+            category: "cat1",
+            id: "id1",
+            data: "test_data",
+        })
+            .execute();
+        // Verify data was inserted with composite entity_id
+        const stateData = await lix.db
+            .selectFrom("state_all")
+            .selectAll()
+            .where("schema_key", "=", "composite_entity")
+            .execute();
+        expect(stateData).toHaveLength(1);
+        expect(stateData[0]?.entity_id).toBe("cat1::id1"); // Composite key joined with ::
+        // Update with composite key
+        await lix.db
+            .updateTable("composite_view")
+            .where("category", "=", "cat1")
+            .where("id", "=", "id1")
+            .set({ data: "updated_data" })
+            .execute();
+        // Verify update
+        const updatedData = await lix.db
+            .selectFrom("composite_view")
+            .selectAll()
+            .execute();
+        expect(updatedData[0]).toMatchObject({
+            category: "cat1",
+            id: "id1",
+            data: "updated_data",
+        });
+        // Delete with composite key
+        await lix.db
+            .deleteFrom("composite_view")
+            .where("category", "=", "cat1")
+            .where("id", "=", "id1")
+            .execute();
+        const afterDelete = await lix.db
+            .selectFrom("composite_view")
+            .selectAll()
+            .execute();
+        expect(afterDelete).toHaveLength(0);
+    });
+    test("should handle default values", async () => {
+        const lix = await openLix({});
+        let defaultIdCalled = false;
+        let defaultValueCalled = false;
+        createEntityStateView({
+            lix,
+            schema: testSchema,
+            overrideName: "test_view",
+            pluginKey: "test_plugin",
+            hardcodedFileId: "test_file",
+            defaultValues: {
+                id: () => {
+                    defaultIdCalled = true;
+                    return "generated_id";
+                },
+                value: () => {
+                    defaultValueCalled = true;
+                    return "999";
+                },
+            },
+        });
+        // Insert without providing default values
+        await lix.db
+            .insertInto("test_view")
+            .values({
+            name: "test_name",
+            // id and value should use defaults
+        })
+            .execute();
+        expect(defaultIdCalled).toBe(true);
+        expect(defaultValueCalled).toBe(true);
+        // Verify defaults were applied
+        const viewData = await lix.db
+            .selectFrom("test_view")
+            .selectAll()
+            .execute();
+        expect(viewData).toHaveLength(1);
+        expect(viewData[0]).toMatchObject({
+            id: "generated_id",
+            name: "test_name",
+            value: 999, // Should be converted to number
+        });
+        // Insert with explicit values (should override defaults)
+        await lix.db
+            .insertInto("test_view")
+            .values({
+            id: "explicit_id",
+            name: "test_name_2",
+            value: 500,
+        })
+            .execute();
+        const allData = await lix.db
+            .selectFrom("test_view")
+            .selectAll()
+            .orderBy("id")
+            .execute();
+        expect(allData).toHaveLength(2);
+        // Find the explicit entry (ordering might vary)
+        const explicitEntry = allData.find((item) => item.id === "explicit_id");
+        expect(explicitEntry).toMatchObject({
+            id: "explicit_id",
+            name: "test_name_2",
+            value: 500,
+        });
+    });
+    test("should use dynamic file_id when not hardcoded", async () => {
+        const lix = await openLix({});
+        createEntityStateView({
+            lix,
+            schema: testSchema,
+            overrideName: "test_view",
+            pluginKey: "test_plugin",
+            // No hardcodedFileId - should use lixcol_file_id from mutations
+        });
+        // Insert with explicit file_id
+        await lix.db
+            .insertInto("test_view")
+            .values({
+            id: "test_id",
+            name: "test_name",
+            value: 42,
+            lixcol_file_id: "dynamic_file",
+        })
+            .execute();
+        // Verify file_id was used from the mutation
+        const stateData = await lix.db
+            .selectFrom("state_all")
+            .selectAll()
+            .where("entity_id", "=", "test_id")
+            .execute();
+        expect(stateData[0]).toMatchObject({
+            file_id: "dynamic_file",
+        });
+    });
+    test("should use schema key as default view name", async () => {
+        const lix = await openLix({});
+        createEntityStateView({
+            lix,
+            schema: testSchema,
+            // No overrideName - should use schema["x-lix-key"]
+            pluginKey: "test_plugin",
+            hardcodedFileId: "test_file",
+        });
+        // Test that we can query the view using the schema key name
+        await lix.db
+            .insertInto("test_entity")
+            .values({ id: "test_id", name: "test_name", value: 42 })
+            .execute();
+        const result = await lix.db
+            .selectFrom("test_entity")
+            .selectAll()
+            .execute();
+        expect(result).toHaveLength(1);
+        expect(result[0]).toMatchObject({
+            id: "test_id",
+            name: "test_name",
+            value: 42,
+        });
+    });
+    test("should expose lixcol_untracked column for untracked state operations", async () => {
+        const lix = await openLix({});
+        createEntityStateView({
+            lix,
+            schema: testSchema,
+            overrideName: "test_view",
+            pluginKey: "test_plugin",
+            hardcodedFileId: "test_file",
+        });
+        // Insert tracked entity (default)
+        await lix.db
+            .insertInto("test_view")
+            .values({
+            id: "tracked_entity",
+            name: "tracked",
+            value: 100,
+        })
+            .execute();
+        // Insert untracked entity
+        await lix.db
+            .insertInto("test_view")
+            .values({
+            id: "untracked_entity",
+            name: "untracked",
+            value: 200,
+            lixcol_untracked: true,
+        })
+            .execute();
+        // Query all entities
+        const allEntities = await lix.db
+            .selectFrom("test_view")
+            .selectAll()
+            .orderBy("id")
+            .execute();
+        expect(allEntities).toHaveLength(2);
+        // Verify tracked entity
+        const trackedEntity = allEntities.find((e) => e.id === "tracked_entity");
+        expect(trackedEntity).toBeDefined();
+        expect(trackedEntity.lixcol_untracked).toBe(0); // false
+        // Verify untracked entity
+        const untrackedEntity = allEntities.find((e) => e.id === "untracked_entity");
+        expect(untrackedEntity).toBeDefined();
+        expect(untrackedEntity.lixcol_untracked).toBe(1); // true
+        // Query only untracked entities
+        const onlyUntracked = await lix.db
+            .selectFrom("test_view")
+            .where("lixcol_untracked", "=", true)
+            .selectAll()
+            .execute();
+        expect(onlyUntracked).toHaveLength(1);
+        expect(onlyUntracked[0]?.id).toBe("untracked_entity");
+        // Query only tracked entities
+        const onlyTracked = await lix.db
+            .selectFrom("test_view")
+            .where("lixcol_untracked", "=", false)
+            .selectAll()
+            .execute();
+        expect(onlyTracked).toHaveLength(1);
+        expect(onlyTracked[0]?.id).toBe("tracked_entity");
+    });
+});
+//# sourceMappingURL=entity-state.test.js.map

package/dist/entity-views/entity-state.test.js.map

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

package/dist/entity-views/entity-state_history.d.ts

@@ -0,0 +1,67 @@
+import type { Generated } from "kysely";
+import type { Lix } from "../lix/open-lix.js";
+import type { LixSchemaDefinition } from "../schema-definition/definition.js";
+/**
+ * Base type for entity history views that include historical data from the state_history table.
+ * These views provide access to entity states at different points in change set history.
+ *
+ * @example
+ * ```typescript
+ * // Define an entity history view type
+ * export type AccountHistoryView = {
+ *   id: Generated<string>;
+ *   name: string;
+ * } & StateEntityHistoryView;
+ * ```
+ */
+export type StateEntityHistoryView = {
+    /** File identifier where this entity is stored */
+    lixcol_file_id: Generated<string>;
+    /** Plugin identifier that manages this entity type */
+    lixcol_plugin_key: Generated<string>;
+    /** Version of the schema used for this entity */
+    lixcol_schema_version: Generated<string>;
+    /** ID of the change that created this entity state */
+    lixcol_change_id: Generated<string>;
+    /** Change set ID that serves as the root/starting point for depth calculation */
+    lixcol_change_set_id: Generated<string>;
+    /** Depth of this entity state relative to the queried change_set_id */
+    lixcol_depth: Generated<number>;
+};
+/**
+ * Creates SQL view for entity history based on its schema definition.
+ *
+ * This function generates a read-only view that extracts JSON properties from the state_history table,
+ * providing access to historical entity states at different points in change set history.
+ *
+ * The view supports:
+ * - Querying entity states at specific change sets
+ * - Traversing entity history by depth (blame functionality)
+ * - Filtering by change set ancestry relationships
+ *
+ * @throws Error if schema type is not "object" or x-lix-primary-key is not defined
+ *
+ * @example
+ * ```typescript
+ * // Basic usage for key-value entities
+ * createEntityHistoryViewIfNotExists({
+ *   lix,
+ *   schema: LixKeyValueSchema,
+ *   overrideName: "key_value_history",
+ * });
+ *
+ * // Usage for account entities
+ * createEntityHistoryViewIfNotExists({
+ *   lix,
+ *   schema: LixAccountSchema,
+ *   overrideName: "account_history",
+ * });
+ * ```
+ */
+export declare function createEntityStateHistoryView(args: {
+    lix: Pick<Lix, "sqlite">;
+    schema: LixSchemaDefinition;
+    /** Overrides the view name which defaults to schema["x-lix-key"] + "_history" */
+    overrideName?: string;
+}): void;
+//# sourceMappingURL=entity-state_history.d.ts.map

package/dist/entity-views/entity-state_history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-state_history.d.ts","sourceRoot":"","sources":["../../src/entity-views/entity-state_history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAE9E;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACpC,kDAAkD;IAClD,cAAc,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAClC,sDAAsD;IACtD,iBAAiB,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACrC,iDAAiD;IACjD,qBAAqB,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACzC,sDAAsD;IACtD,gBAAgB,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACpC,iFAAiF;IACjF,oBAAoB,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACxC,uEAAuE;IACvE,YAAY,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;CAChC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE;IAClD,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACzB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,iFAAiF;IACjF,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,IAAI,CAiCP"}

package/dist/entity-views/entity-state_history.js

@@ -0,0 +1,58 @@
+/**
+ * Creates SQL view for entity history based on its schema definition.
+ *
+ * This function generates a read-only view that extracts JSON properties from the state_history table,
+ * providing access to historical entity states at different points in change set history.
+ *
+ * The view supports:
+ * - Querying entity states at specific change sets
+ * - Traversing entity history by depth (blame functionality)
+ * - Filtering by change set ancestry relationships
+ *
+ * @throws Error if schema type is not "object" or x-lix-primary-key is not defined
+ *
+ * @example
+ * ```typescript
+ * // Basic usage for key-value entities
+ * createEntityHistoryViewIfNotExists({
+ *   lix,
+ *   schema: LixKeyValueSchema,
+ *   overrideName: "key_value_history",
+ * });
+ *
+ * // Usage for account entities
+ * createEntityHistoryViewIfNotExists({
+ *   lix,
+ *   schema: LixAccountSchema,
+ *   overrideName: "account_history",
+ * });
+ * ```
+ */
+export function createEntityStateHistoryView(args) {
+    if (!args.schema["x-lix-primary-key"]) {
+        throw new Error(`Schema must define 'x-lix-primary-key' for entity history view generation`);
+    }
+    const view_name = args.overrideName ?? args.schema["x-lix-key"] + "_history";
+    const schema_key = args.schema["x-lix-key"];
+    const properties = Object.keys(args.schema.properties);
+    // Generated SQL query for history view
+    const sqlQuery = `
+    CREATE VIEW IF NOT EXISTS ${view_name} AS
+      SELECT
+        ${properties
+        .map((prop) => `json_extract(snapshot_content, '$.${prop}') AS ${prop}`)
+        .join(",\n        ")},
+        entity_id,
+        schema_key,
+        file_id AS lixcol_file_id,
+        plugin_key AS lixcol_plugin_key,
+        schema_version AS lixcol_schema_version,
+        change_id AS lixcol_change_id,
+        change_set_id AS lixcol_change_set_id,
+        depth AS lixcol_depth
+      FROM state_history
+      WHERE schema_key = '${schema_key}';
+    `;
+    args.lix.sqlite.exec(sqlQuery);
+}
+//# sourceMappingURL=entity-state_history.js.map

package/dist/entity-views/entity-state_history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-state_history.js","sourceRoot":"","sources":["../../src/entity-views/entity-state_history.ts"],"names":[],"mappings":"AAgCA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,4BAA4B,CAAC,IAK5C;IACA,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CACd,2EAA2E,CAC3E,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,UAAU,CAAC;IAC7E,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC5C,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAE,IAAI,CAAC,MAAc,CAAC,UAAU,CAAC,CAAC;IAEhE,uCAAuC;IACvC,MAAM,QAAQ,GAAG;gCACc,SAAS;;UAE/B,UAAU;SACd,GAAG,CACH,CAAC,IAAI,EAAE,EAAE,CAAC,qCAAqC,IAAI,SAAS,IAAI,EAAE,CAClE;SACA,IAAI,CAAC,aAAa,CAAC;;;;;;;;;;4BAUG,UAAU;KACjC,CAAC;IAEL,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC"}