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

package/dist/state/create-changeset-for-transaction.js

@@ -0,0 +1,237 @@
+import { sql } from "kysely";
+import { LixChangeSetEdgeSchema, LixChangeSetElementSchema, LixChangeSetSchema, } from "../change-set/schema.js";
+import { executeSync } from "../database/execute-sync.js";
+import { changeSetHasLabel } from "../query-filter/change-set-has-label.js";
+import { changeSetIsAncestorOf } from "../query-filter/change-set-is-ancestor-of.js";
+import { LixVersionSchema } from "../version/schema.js";
+import { createChangeWithSnapshot } from "./handle-state-mutation.js";
+import { nanoid } from "../database/nano-id.js";
+import { getVersionRecordByIdOrThrow } from "./get-version-record-by-id-or-throw.js";
+import { handleStateDelete } from "./schema.js";
+export function createChangesetForTransaction(sqlite, db, currentTime, version_id, changes) {
+    const versionRecord = getVersionRecordByIdOrThrow(sqlite, db, version_id);
+    if (!versionRecord) {
+        throw new Error(`Version with id '${version_id}' not found.`);
+    }
+    const mutatedVersion = versionRecord;
+    const nextChangeSetId = nanoid();
+    const changeSetChange = createChangeWithSnapshot({
+        sqlite,
+        db,
+        data: {
+            entity_id: nextChangeSetId,
+            schema_key: "lix_change_set",
+            file_id: "lix",
+            plugin_key: "lix_own_entity",
+            snapshot_content: JSON.stringify({
+                id: nextChangeSetId,
+                metadata: null,
+            }),
+            schema_version: LixChangeSetSchema["x-lix-version"],
+        },
+        timestamp: currentTime,
+        version_id: "global", // Always use 'global' for change sets
+    });
+    const changeSetEdgeChange = createChangeWithSnapshot({
+        sqlite,
+        db,
+        data: {
+            entity_id: `${mutatedVersion.change_set_id}::${nextChangeSetId}`,
+            schema_key: "lix_change_set_edge",
+            file_id: "lix",
+            plugin_key: "lix_own_entity",
+            snapshot_content: JSON.stringify({
+                parent_id: mutatedVersion.change_set_id,
+                child_id: nextChangeSetId,
+            }),
+            schema_version: LixChangeSetEdgeSchema["x-lix-version"],
+        },
+        timestamp: currentTime,
+        version_id: "global", // Always use 'global' for change set edges
+    });
+    // Only create separate version change if root change is not already a version change
+    const changesToProcess = [...changes, changeSetChange, changeSetEdgeChange];
+    const versionChange = createChangeWithSnapshot({
+        sqlite,
+        db,
+        data: {
+            entity_id: mutatedVersion.id,
+            schema_key: "lix_version",
+            file_id: "lix",
+            plugin_key: "lix_own_entity",
+            snapshot_content: JSON.stringify({
+                ...mutatedVersion,
+                change_set_id: nextChangeSetId,
+            }),
+            schema_version: LixVersionSchema["x-lix-version"],
+        },
+        timestamp: currentTime,
+        version_id: "global",
+    });
+    changesToProcess.push(versionChange);
+    for (const change of changesToProcess) {
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        const changeSetElementChange = createChangeWithSnapshot({
+            sqlite,
+            db,
+            data: {
+                entity_id: `${nextChangeSetId}::${change.id}`,
+                schema_key: "lix_change_set_element",
+                file_id: "lix",
+                plugin_key: "lix_own_entity",
+                snapshot_content: JSON.stringify({
+                    change_set_id: nextChangeSetId,
+                    change_id: change.id,
+                    schema_key: change.schema_key,
+                    file_id: change.file_id,
+                    entity_id: change.entity_id,
+                }),
+                schema_version: LixChangeSetElementSchema["x-lix-version"],
+            },
+            timestamp: currentTime,
+            version_id: "global",
+        });
+        // TODO investigate if needed as part of a change set itself
+        // seems to make queries slower
+        // creating a change set element for the change set element change
+        // this is meta but allows us to reconstruct and mutate a change set
+        // createChangeWithSnapshot({
+        // 	sqlite,
+        // 	db,
+        // 	data: {
+        // 		entity_id: changeSetElementChange.entity_id,
+        // 		schema_key: "lix_change_set_element",
+        // 		file_id: "lix",
+        // 		plugin_key: "lix_own_entity",
+        // 		snapshot_content: JSON.stringify({
+        // 			change_set_id: changeSetId,
+        // 			change_id: changeSetElementChange.id,
+        // 			schema_key: "lix_change_set_element",
+        // 			file_id: "lix",
+        // 			entity_id: changeSetElementChange.entity_id,
+        // 		} satisfies ChangeSetElement),
+        // 	},
+        // });
+    }
+    // Create/update working change set element for user data changes
+    // TODO skipping lix internal entities is likely undesired.
+    // Skip lix internal entities (change sets, edges, etc.)
+    for (const change of changes) {
+        if (change.schema_key !== "lix_change_set" &&
+            change.schema_key !== "lix_change_set_edge" &&
+            change.schema_key !== "lix_change_set_element" &&
+            change.schema_key !== "lix_version") {
+            const parsedSnapshot = change.snapshot_content
+                ? JSON.parse(change.snapshot_content)
+                : null;
+            const isDeletion = !parsedSnapshot || parsedSnapshot.snapshot_id === "no-content";
+            if (isDeletion) {
+                // Delete reconciliation: check if entity existed at last checkpoint using state_history
+                const entityAtCheckpoint = executeSync({
+                    lix: { sqlite },
+                    query: db
+                        .selectFrom("state_history")
+                        .where("entity_id", "=", change.entity_id)
+                        .where("schema_key", "=", change.schema_key)
+                        .where("file_id", "=", change.file_id)
+                        .where("depth", "=", 0)
+                        .where("change_set_id", "=", 
+                    // get the previous checkpoint change set
+                    db
+                        .selectFrom("change_set")
+                        .where(changeSetHasLabel({ name: "checkpoint" }))
+                        .where(changeSetIsAncestorOf({ id: mutatedVersion.change_set_id }, { includeSelf: true, depth: 1 }))
+                        .select("id"))
+                        .select("entity_id"),
+                });
+                const entityExistedAtCheckpoint = entityAtCheckpoint.length > 0;
+                // Always remove existing working change set element first
+                const toDelete = executeSync({
+                    lix: { sqlite },
+                    query: db
+                        .selectFrom("state_all")
+                        // @ts-expect-error - rowid is a valid SQLite column but not in Kysely types
+                        .select("rowid")
+                        .where("entity_id", "like", `${mutatedVersion.working_change_set_id}::%`)
+                        .where("schema_key", "=", "lix_change_set_element")
+                        .where("file_id", "=", "lix")
+                        .where("version_id", "=", "global")
+                        .where(sql `json_extract(snapshot_content, '$.entity_id')`, "=", change.entity_id)
+                        .where(sql `json_extract(snapshot_content, '$.schema_key')`, "=", change.schema_key)
+                        .where(sql `json_extract(snapshot_content, '$.file_id')`, "=", change.file_id),
+                });
+                if (toDelete.length > 0) {
+                    handleStateDelete(sqlite, toDelete[0].rowid, db);
+                }
+                // If entity existed at checkpoint, add deletion to working change set
+                if (entityExistedAtCheckpoint) {
+                    createChangeWithSnapshot({
+                        sqlite,
+                        db,
+                        data: {
+                            entity_id: `${mutatedVersion.working_change_set_id}::${change.id}`,
+                            schema_key: "lix_change_set_element",
+                            file_id: "lix",
+                            plugin_key: "lix_own_entity",
+                            snapshot_content: JSON.stringify({
+                                change_set_id: mutatedVersion.working_change_set_id,
+                                change_id: change.id,
+                                entity_id: change.entity_id,
+                                schema_key: change.schema_key,
+                                file_id: change.file_id,
+                            }),
+                            schema_version: LixChangeSetElementSchema["x-lix-version"],
+                        },
+                        timestamp: currentTime,
+                        version_id: "global",
+                    });
+                }
+                // If entity didn't exist at checkpoint, just remove from working change set (already done above)
+            }
+            else {
+                // Non-deletion: create/update working change set element (latest change wins)
+                // First, remove any existing working change set element for this entity
+                const toDelete = executeSync({
+                    lix: { sqlite },
+                    query: db
+                        .selectFrom("state_all")
+                        // @ts-expect-error - rowid is a valid SQLite column but not in Kysely types
+                        .select("rowid")
+                        .where("entity_id", "like", `${mutatedVersion.working_change_set_id}::%`)
+                        .where("schema_key", "=", "lix_change_set_element")
+                        .where("file_id", "=", "lix")
+                        .where("version_id", "=", "global")
+                        .where(sql `json_extract(snapshot_content, '$.entity_id')`, "=", change.entity_id)
+                        .where(sql `json_extract(snapshot_content, '$.schema_key')`, "=", change.schema_key)
+                        .where(sql `json_extract(snapshot_content, '$.file_id')`, "=", change.file_id),
+                });
+                if (toDelete.length > 0) {
+                    // throw new Error("not implement - us the delete function ");
+                    handleStateDelete(sqlite, toDelete[0].rowid, db);
+                }
+                // Then create new element with latest change
+                createChangeWithSnapshot({
+                    sqlite,
+                    db,
+                    data: {
+                        entity_id: `${mutatedVersion.working_change_set_id}::${change.id}`,
+                        schema_key: "lix_change_set_element",
+                        file_id: "lix",
+                        plugin_key: "lix_own_entity",
+                        snapshot_content: JSON.stringify({
+                            change_set_id: mutatedVersion.working_change_set_id,
+                            change_id: change.id,
+                            entity_id: change.entity_id,
+                            schema_key: change.schema_key,
+                            file_id: change.file_id,
+                        }),
+                        schema_version: LixChangeSetElementSchema["x-lix-version"],
+                    },
+                    timestamp: currentTime,
+                    version_id: "global",
+                });
+            }
+        }
+    }
+}
+//# sourceMappingURL=create-changeset-for-transaction.js.map

package/dist/state/create-changeset-for-transaction.js.map

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

package/dist/state/entity-view-builder.d.ts

@@ -0,0 +1,145 @@
+import type { Generated } from "kysely";
+import type { Lix } from "../lix/open-lix.js";
+import type { LixSchemaDefinition } from "../schema-definition/definition.js";
+/**
+ * Base type for regular entity views (active version only) that include operational columns from the state table.
+ * These views do NOT expose lixcol_version_id to prevent accidental version-specific operations.
+ *
+ * @example
+ * ```typescript
+ * // Define an entity view type for active version operations
+ * export type AccountView = {
+ *   id: Generated<string>;
+ *   name: string;
+ * } & StateEntityView;
+ * ```
+ */
+export type StateEntityView = {
+    /** File identifier where this entity is stored */
+    lixcol_file_id: Generated<string>;
+    /** Version identifier this entity was inherited from (for branching) */
+    lixcol_inherited_from_version_id: Generated<string | null>;
+    /** Timestamp when this entity was created */
+    lixcol_created_at: Generated<string>;
+    /** Timestamp when this entity was last updated */
+    lixcol_updated_at: Generated<string>;
+};
+/**
+ * Base type for _all entity views (cross-version) that include operational columns from the state table.
+ * These views expose lixcol_version_id for version-specific operations.
+ *
+ * @example
+ * ```typescript
+ * // Define an entity view type for cross-version operations
+ * export type AccountAllView = {
+ *   id: Generated<string>;
+ *   name: string;
+ * } & StateEntityAllView;
+ * ```
+ */
+export type StateEntityAllView = {
+    /** File identifier where this entity is stored */
+    lixcol_file_id: Generated<string>;
+    /** Version identifier when this entity was created/modified */
+    lixcol_version_id: Generated<string>;
+    /** Version identifier this entity was inherited from (for branching) */
+    lixcol_inherited_from_version_id: Generated<string | null>;
+    /** Timestamp when this entity was created */
+    lixcol_created_at: Generated<string>;
+    /** Timestamp when this entity was last updated */
+    lixcol_updated_at: Generated<string>;
+};
+/**
+ * Validation rule for SQL trigger generation.
+ */
+export type ValidationRule = {
+    /** SQL condition that must be true, or error will be raised */
+    condition: string;
+    /** Error message to display when validation fails */
+    errorMessage: string;
+};
+/**
+ * Validation callbacks for entity operations.
+ * These are converted to SQL validation triggers.
+ */
+export type ValidationCallbacks = {
+    /** Validation logic for INSERT operations */
+    onInsert?: ValidationRule[];
+    /** Validation logic for UPDATE operations */
+    onUpdate?: ValidationRule[];
+    /** Validation logic for DELETE operations */
+    onDelete?: ValidationRule[];
+};
+/**
+ * Creates SQL views and CRUD triggers for an entity based on its schema definition.
+ *
+ * This function automatically generates two views:
+ * - Primary view (e.g., "key_value") - uses state_active (active version only)
+ * - All view (e.g., "key_value_all") - uses state (all versions)
+ *
+ * Each view includes:
+ * - A view that extracts JSON properties from the state table
+ * - INSERT trigger that serializes entity data to JSON in the state table
+ * - UPDATE trigger that updates the corresponding state record
+ * - DELETE trigger that removes the state record
+ *
+ * @throws Error if schema type is not "object" or x-lix-primary-key is not defined
+ *
+ * @example
+ * ```typescript
+ * // Basic usage for key-value entities
+ * createEntityViewsIfNotExists({
+ *   lix,
+ *   schema: LixKeyValueSchema,
+ *   overrideName: "key_value",
+ *   pluginKey: "lix_key_value",
+ *   hardcodedFileId: "lix"
+ * });
+ * // Creates: key_value (active only) and key_value_all (all versions)
+ *
+ * // With default values for account entities
+ * createEntityViewsIfNotExists({
+ *   lix,
+ *   schema: LixAccountSchema,
+ *   overrideName: "account",
+ *   pluginKey: "lix_own_entity",
+ *   hardcodedFileId: "lix",
+ *   defaultValues: {
+ *     id: (row) => nanoid()
+ *   }
+ * });
+ * // Creates: account (active only) and account_all (all versions)
+ *
+ * // With custom validation
+ * createEntityViewsIfNotExists({
+ *   lix,
+ *   schema: LixStoredSchemaSchema,
+ *   overrideName: "stored_schema",
+ *   pluginKey: "lix_own_entity",
+ *   hardcodedFileId: "lix",
+ *   validation: {
+ *     onInsert: [{
+ *       condition: "NEW.key IS NULL OR NEW.key = json_extract(NEW.value, '$.x-lix-key')",
+ *       errorMessage: "Key must match value.x-lix-key"
+ *     }]
+ *   }
+ * });
+ * ```
+ */
+export declare function createEntityViewsIfNotExists(args: {
+    lix: Pick<Lix, "sqlite">;
+    schema: LixSchemaDefinition;
+    /** Overrides the view name which defaults to schema["x-lix-key"] */
+    overrideName?: string;
+    /** Plugin identifier for the entity */
+    pluginKey: string;
+    /** Optional hardcoded file_id (if not provided, uses lixcol_file_id from mutations) */
+    hardcodedFileId?: string;
+    /** Optional hardcoded version_id (if not provided, uses lixcol_version_id from mutations or active version) */
+    hardcodedVersionId?: string;
+    /** Object mapping property names to functions that generate default values */
+    defaultValues?: Record<string, (() => string) | ((row: Record<string, any>) => string)>;
+    /** Custom validation logic for entity operations */
+    validation?: ValidationCallbacks;
+}): void;
+//# sourceMappingURL=entity-view-builder.d.ts.map

package/dist/state/entity-view-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-view-builder.d.ts","sourceRoot":"","sources":["../../src/state/entity-view-builder.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,eAAe,GAAG;IAC7B,kDAAkD;IAClD,cAAc,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAClC,wEAAwE;IACxE,gCAAgC,EAAE,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC3D,6CAA6C;IAC7C,iBAAiB,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACrC,kDAAkD;IAClD,iBAAiB,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;CACrC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAChC,kDAAkD;IAClD,cAAc,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAClC,+DAA+D;IAC/D,iBAAiB,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACrC,wEAAwE;IACxE,gCAAgC,EAAE,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC3D,6CAA6C;IAC7C,iBAAiB,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACrC,kDAAkD;IAClD,iBAAiB,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;CACrC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC5B,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG;IACjC,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;IAC5B,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;IAC5B,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;CAC5B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE;IAClD,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACzB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,uFAAuF;IACvF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+GAA+G;IAC/G,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,CACrB,MAAM,EACN,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,MAAM,CAAC,CACvD,CAAC;IACF,oDAAoD;IACpD,UAAU,CAAC,EAAE,mBAAmB,CAAC;CACjC,GAAG,IAAI,CAcP"}