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

package/dist/engine/deterministic-mode/options.d.ts

@@ -0,0 +1,48 @@
+import type { FromLixSchemaDefinition, LixInsertable } from "../../schema-definition/index.js";
+/**
+ * Schema definition for deterministic mode options.
+ *
+ * @example
+ * const options = {
+ *   enabled: true,
+ *   randomLixId: false,
+ *   timestamp: true,
+ *   random_seed: "default-seed",
+ *   nano_id: true,
+ *   uuid_v7: true
+ * };
+ */
+export declare const LixDeterministicModeOptionsSchema: {
+    readonly "x-lix-key": "lix_deterministic_mode";
+    readonly "x-lix-version": "1.0";
+    readonly type: "object";
+    readonly properties: {
+        readonly enabled: {
+            readonly type: "boolean";
+        };
+        readonly randomLixId: {
+            readonly type: "boolean";
+            readonly "x-lix-default": "false";
+        };
+        readonly timestamp: {
+            readonly type: "boolean";
+            readonly "x-lix-default": "true";
+        };
+        readonly random_seed: {
+            readonly type: "string";
+            readonly "x-lix-default": "'lix-deterministic-seed'";
+        };
+        readonly nano_id: {
+            readonly type: "boolean";
+            readonly "x-lix-default": "true";
+        };
+        readonly uuid_v7: {
+            readonly type: "boolean";
+            readonly "x-lix-default": "true";
+        };
+    };
+    readonly required: readonly ["enabled"];
+    readonly additionalProperties: false;
+};
+export type DeterministicModeOptions = LixInsertable<FromLixSchemaDefinition<typeof LixDeterministicModeOptionsSchema>>;
+//# sourceMappingURL=options.d.ts.map

package/dist/engine/deterministic-mode/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../src/engine/deterministic-mode/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,uBAAuB,EACvB,aAAa,EAEb,MAAM,kCAAkC,CAAC;AAE1C;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BpC,CAAC;AAEX,MAAM,MAAM,wBAAwB,GAAG,aAAa,CACnD,uBAAuB,CAAC,OAAO,iCAAiC,CAAC,CACjE,CAAC"}

package/dist/engine/deterministic-mode/options.js

@@ -0,0 +1,47 @@
+/**
+ * Schema definition for deterministic mode options.
+ *
+ * @example
+ * const options = {
+ *   enabled: true,
+ *   randomLixId: false,
+ *   timestamp: true,
+ *   random_seed: "default-seed",
+ *   nano_id: true,
+ *   uuid_v7: true
+ * };
+ */
+export const LixDeterministicModeOptionsSchema = {
+    "x-lix-key": "lix_deterministic_mode",
+    "x-lix-version": "1.0",
+    type: "object",
+    properties: {
+        enabled: {
+            type: "boolean",
+        },
+        randomLixId: {
+            type: "boolean",
+            "x-lix-default": "false",
+        },
+        timestamp: {
+            type: "boolean",
+            "x-lix-default": "true",
+        },
+        random_seed: {
+            type: "string",
+            "x-lix-default": "'lix-deterministic-seed'",
+        },
+        nano_id: {
+            type: "boolean",
+            "x-lix-default": "true",
+        },
+        uuid_v7: {
+            type: "boolean",
+            "x-lix-default": "true",
+        },
+    },
+    required: ["enabled"],
+    additionalProperties: false,
+};
+LixDeterministicModeOptionsSchema;
+//# sourceMappingURL=options.js.map

package/dist/engine/deterministic-mode/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../src/engine/deterministic-mode/options.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG;IAChD,WAAW,EAAE,wBAAwB;IACrC,eAAe,EAAE,KAAK;IACtB,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACX,OAAO,EAAE;YACR,IAAI,EAAE,SAAS;SACf;QACD,WAAW,EAAE;YACZ,IAAI,EAAE,SAAS;YACf,eAAe,EAAE,OAAO;SACxB;QACD,SAAS,EAAE;YACV,IAAI,EAAE,SAAS;YACf,eAAe,EAAE,MAAM;SACvB;QACD,WAAW,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,eAAe,EAAE,0BAA0B;SAC3C;QACD,OAAO,EAAE;YACR,IAAI,EAAE,SAAS;YACf,eAAe,EAAE,MAAM;SACvB;QACD,OAAO,EAAE;YACR,IAAI,EAAE,SAAS;YACf,eAAe,EAAE,MAAM;SACvB;KACD;IACD,QAAQ,EAAE,CAAC,SAAS,CAAC;IACrB,oBAAoB,EAAE,KAAK;CAClB,CAAC;AAMX,iCAA+D,CAAC"}

package/dist/engine/deterministic-mode/options.test.d.ts

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

package/dist/engine/deterministic-mode/options.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.test.d.ts","sourceRoot":"","sources":["../../../src/engine/deterministic-mode/options.test.ts"],"names":[],"mappings":""}

package/dist/engine/deterministic-mode/options.test.js

@@ -0,0 +1,111 @@
+import { test, expect } from "vitest";
+import { LixDeterministicModeOptionsSchema, } from "./options.js";
+import { validateLixSchema, validateLixSchemaDefinition, } from "../../schema-definition/validate-lix-schema.js";
+test("deterministic mode options schema is a valid LixSchemaDefinition", () => {
+    expect(() => validateLixSchemaDefinition(LixDeterministicModeOptionsSchema)).not.toThrow();
+});
+test("validates correct deterministic mode options", () => {
+    const validOptions = {
+        enabled: true,
+        randomLixId: false,
+        timestamp: true,
+        random_seed: "test-seed",
+        nano_id: true,
+        uuid_v7: true,
+    };
+    expect(() => validateLixSchema(LixDeterministicModeOptionsSchema, validOptions)).not.toThrow();
+});
+test("validates minimal deterministic mode options with only required fields", () => {
+    const minimalOptions = {
+        enabled: true,
+    };
+    expect(() => validateLixSchema(LixDeterministicModeOptionsSchema, minimalOptions)).not.toThrow();
+});
+test("fails validation when enabled is missing", () => {
+    // @ts-expect-error - Testing missing required field
+    const invalidOptions = {
+        randomLixId: false,
+        timestamp: true,
+    };
+    expect(() => validateLixSchema(LixDeterministicModeOptionsSchema, invalidOptions)).toThrow(/Data validation failed/);
+});
+test("fails validation when enabled is not a boolean", () => {
+    const invalidOptions = {
+        // @ts-expect-error - Testing invalid type for enabled field
+        enabled: "true", // string instead of boolean
+        randomLixId: false,
+    };
+    expect(() => validateLixSchema(LixDeterministicModeOptionsSchema, invalidOptions)).toThrow(/Data validation failed/);
+});
+test("fails validation with additional properties", () => {
+    const invalidOptions = {
+        enabled: true,
+        // @ts-expect-error - Testing additional properties
+        unknown_property: "value",
+    };
+    expect(() => validateLixSchema(LixDeterministicModeOptionsSchema, invalidOptions)).toThrow(/Data validation failed/);
+});
+test("validates all boolean fields correctly", () => {
+    const options = {
+        enabled: false,
+        randomLixId: true,
+        timestamp: false,
+        random_seed: "custom-seed",
+        nano_id: false,
+        uuid_v7: true,
+    };
+    expect(() => validateLixSchema(LixDeterministicModeOptionsSchema, options)).not.toThrow();
+});
+test("fails validation when boolean fields have wrong types", () => {
+    const testCases = [
+        {
+            enabled: true,
+            // @ts-expect-error - Testing invalid type for randomLixId
+            randomLixId: "true",
+        },
+        {
+            enabled: true,
+            // @ts-expect-error - Testing invalid type for timestamp
+            timestamp: 1,
+        },
+        {
+            enabled: true,
+            // @ts-expect-error - Testing invalid type for nano_id
+            nano_id: null,
+        },
+        {
+            enabled: true,
+            // @ts-expect-error - Testing invalid type for uuid_v7
+            uuid_v7: {},
+        },
+    ];
+    for (const testCase of testCases) {
+        expect(() => validateLixSchema(LixDeterministicModeOptionsSchema, testCase)).toThrow(/Data validation failed/);
+    }
+});
+test("fails validation when random_seed is not a string", () => {
+    const invalidOptions = {
+        enabled: true,
+        // @ts-expect-error - Testing invalid type for random_seed
+        random_seed: 12345, // number instead of string
+    };
+    expect(() => validateLixSchema(LixDeterministicModeOptionsSchema, invalidOptions)).toThrow(/Data validation failed/);
+});
+test("schema has correct metadata", () => {
+    expect(LixDeterministicModeOptionsSchema["x-lix-key"]).toBe("lix_deterministic_mode");
+    expect(LixDeterministicModeOptionsSchema["x-lix-version"]).toBe("1.0");
+    expect(LixDeterministicModeOptionsSchema.type).toBe("object");
+    expect(LixDeterministicModeOptionsSchema.required).toEqual(["enabled"]);
+    expect(LixDeterministicModeOptionsSchema.additionalProperties).toBe(false);
+});
+test("schema has correct default values", () => {
+    const properties = LixDeterministicModeOptionsSchema.properties;
+    expect(properties.randomLixId["x-lix-default"]).toBe("false");
+    expect(properties.timestamp["x-lix-default"]).toBe("true");
+    expect(properties.random_seed["x-lix-default"]).toBe("'lix-deterministic-seed'");
+    expect(properties.nano_id["x-lix-default"]).toBe("true");
+    expect(properties.uuid_v7["x-lix-default"]).toBe("true");
+    // enabled should not have a default
+    expect(properties.enabled).not.toHaveProperty("x-lix-default");
+});
+//# sourceMappingURL=options.test.js.map

package/dist/engine/deterministic-mode/options.test.js.map

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

package/dist/engine/entity-views/build-json-object-entries.d.ts

@@ -0,0 +1,12 @@
+import type { LixSchemaDefinition } from "../../schema-definition/definition.js";
+/**
+ * Builds a json_object entries list for snapshot_content serialization that respects schema types.
+ * - For JSON-like props (object/array): accept raw JSON when valid, otherwise quote
+ * - For string props: always json_quote to avoid coercion (e.g. "1.0" -> 1)
+ * - For others (number/boolean/null): generic JSON handling
+ */
+export declare function buildJsonObjectEntries(args: {
+    schema: LixSchemaDefinition;
+    ref: (prop: string) => string;
+}): string;
+//# sourceMappingURL=build-json-object-entries.d.ts.map

package/dist/engine/entity-views/build-json-object-entries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-json-object-entries.d.ts","sourceRoot":"","sources":["../../../src/engine/entity-views/build-json-object-entries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AAGjF;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC5C,MAAM,EAAE,mBAAmB,CAAC;IAC5B,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CAC9B,GAAG,MAAM,CA8BT"}

package/dist/engine/entity-views/build-json-object-entries.js

@@ -0,0 +1,37 @@
+import { isJsonType } from "../../schema-definition/json-type.js";
+/**
+ * Builds a json_object entries list for snapshot_content serialization that respects schema types.
+ * - For JSON-like props (object/array): accept raw JSON when valid, otherwise quote
+ * - For string props: always json_quote to avoid coercion (e.g. "1.0" -> 1)
+ * - For others (number/boolean/null): generic JSON handling
+ */
+export function buildJsonObjectEntries(args) {
+    const properties = Object.keys(args.schema.properties);
+    return properties
+        .map((prop) => {
+        const def = args.schema.properties[prop];
+        const ref = () => args.ref(prop);
+        const jsonLike = isJsonType(def);
+        const types = def?.type
+            ? Array.isArray(def.type)
+                ? def.type
+                : [def.type]
+            : [];
+        const isString = !jsonLike && types.includes("string");
+        if (jsonLike) {
+            const first = ref();
+            const second = ref();
+            const third = ref();
+            return `'${prop}', CASE WHEN json_valid(${first}) THEN json(${second}) ELSE json_quote(${third}) END`;
+        }
+        if (isString) {
+            return `'${prop}', json_quote(${ref()})`;
+        }
+        const first = ref();
+        const second = ref();
+        const third = ref();
+        return `'${prop}', CASE WHEN json_valid(${first}) THEN json(${second}) ELSE json_quote(${third}) END`;
+    })
+        .join(", ");
+}
+//# sourceMappingURL=build-json-object-entries.js.map

package/dist/engine/entity-views/build-json-object-entries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-json-object-entries.js","sourceRoot":"","sources":["../../../src/engine/entity-views/build-json-object-entries.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAC;AAElE;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAGtC;IACA,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAE,IAAI,CAAC,MAAc,CAAC,UAAU,CAAC,CAAC;IAEhE,OAAO,UAAU;SACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACb,MAAM,GAAG,GAAS,IAAI,CAAC,MAAc,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACvD,MAAM,GAAG,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,KAAK,GAAG,GAAG,EAAE,IAAI;YACtB,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;gBACxB,CAAC,CAAC,GAAG,CAAC,IAAI;gBACV,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;YACb,CAAC,CAAC,EAAE,CAAC;QACN,MAAM,QAAQ,GAAG,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAEvD,IAAI,QAAQ,EAAE,CAAC;YACd,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC;YACpB,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC;YACrB,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC;YACpB,OAAO,IAAI,IAAI,2BAA2B,KAAK,eAAe,MAAM,qBAAqB,KAAK,OAAO,CAAC;QACvG,CAAC;QACD,IAAI,QAAQ,EAAE,CAAC;YACd,OAAO,IAAI,IAAI,iBAAiB,GAAG,EAAE,GAAG,CAAC;QAC1C,CAAC;QACD,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC;QACpB,OAAO,IAAI,IAAI,2BAA2B,KAAK,eAAe,MAAM,qBAAqB,KAAK,OAAO,CAAC;IACvG,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC"}

package/dist/engine/entity-views/build-json-object-entries.test.d.ts

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

package/dist/engine/entity-views/build-json-object-entries.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-json-object-entries.test.d.ts","sourceRoot":"","sources":["../../../src/engine/entity-views/build-json-object-entries.test.ts"],"names":[],"mappings":""}

package/dist/engine/entity-views/build-json-object-entries.test.js

@@ -0,0 +1,35 @@
+import { expect, test } from "vitest";
+import { buildJsonObjectEntries } from "./build-json-object-entries.js";
+const TestSchema = {
+    "x-lix-key": "test_schema",
+    "x-lix-version": "1.0",
+    "x-lix-primary-key": ["/id"],
+    type: "object",
+    properties: {
+        id: { type: "string" },
+        name: { type: "string" },
+        version: { type: "string" },
+        count: { type: "number" },
+        flag: { type: "boolean" },
+        data: { type: "object" },
+        arr: { type: "array" },
+    },
+    additionalProperties: false,
+};
+test("uses json_quote for string fields to prevent coercion", () => {
+    const sql = buildJsonObjectEntries({
+        schema: TestSchema,
+        ref: (p) => `NEW.${p}`,
+    });
+    expect(sql).toContain("'name', json_quote(NEW.name)");
+    expect(sql).toContain("'version', json_quote(NEW.version)");
+});
+test("uses json/json_quote combo for object/array fields", () => {
+    const sql = buildJsonObjectEntries({
+        schema: TestSchema,
+        ref: (p) => `NEW.${p}`,
+    });
+    expect(sql).toContain("'data', CASE WHEN json_valid(NEW.data) THEN json(NEW.data) ELSE json_quote(NEW.data) END");
+    expect(sql).toContain("'arr', CASE WHEN json_valid(NEW.arr) THEN json(NEW.arr) ELSE json_quote(NEW.arr) END");
+});
+//# sourceMappingURL=build-json-object-entries.test.js.map

package/dist/engine/entity-views/build-json-object-entries.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-json-object-entries.test.js","sourceRoot":"","sources":["../../../src/engine/entity-views/build-json-object-entries.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAGxE,MAAM,UAAU,GAAG;IAClB,WAAW,EAAE,aAAa;IAC1B,eAAe,EAAE,KAAK;IACtB,mBAAmB,EAAE,CAAC,KAAK,CAAC;IAC5B,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACX,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACtB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACxB,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC3B,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;QACzB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACxB,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;KACtB;IACD,oBAAoB,EAAE,KAAK;CACY,CAAC;AAEzC,IAAI,CAAC,uDAAuD,EAAE,GAAG,EAAE;IAClE,MAAM,GAAG,GAAG,sBAAsB,CAAC;QAClC,MAAM,EAAE,UAAU;QAClB,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE;KACtB,CAAC,CAAC;IACH,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,8BAA8B,CAAC,CAAC;IACtD,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,oCAAoC,CAAC,CAAC;AAC7D,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,oDAAoD,EAAE,GAAG,EAAE;IAC/D,MAAM,GAAG,GAAG,sBAAsB,CAAC;QAClC,MAAM,EAAE,UAAU;QAClB,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE;KACtB,CAAC,CAAC;IACH,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CACpB,0FAA0F,CAC1F,CAAC;IACF,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CACpB,sFAAsF,CACtF,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/engine/entity-views/entity-state-by-version.d.ts

@@ -0,0 +1,238 @@
+import type { Generated } from "kysely";
+import type { LixGenerated } from "../../schema-definition/definition.js";
+/**
+ * Base type for cross-version entity views that include operational columns from the state table.
+ * These views expose lixcol_version_id for version-specific operations and allow querying entities
+ * across all versions in the database.
+ *
+ * @example
+ * ```typescript
+ * // Define an entity view type for cross-version operations
+ * export type AccountByVersionView = {
+ *   id: Generated<string>;
+ *   name: string;
+ * } & StateEntityByVersionView;
+ *
+ * // Query entities across versions
+ * const accounts = await lix.db
+ *   .selectFrom("account_by_version")
+ *   .where("lixcol_version_id", "=", "v1")
+ *   .selectAll()
+ *   .execute();
+ * ```
+ */
+export type StateEntityByVersionView = {
+    /**
+     * The unique identifier for this entity within its schema and file.
+     *
+     * This is the primary identifier used to reference this specific entity.
+     */
+    lixcol_entity_id: Generated<string>;
+    /**
+     * The schema key that defines the structure and type of this entity.
+     *
+     * This references the schema definition that validates and types this entity.
+     */
+    lixcol_schema_key: Generated<string>;
+    /**
+     * File identifier where this entity is stored.
+     *
+     * This references the file_id in the state table and links the entity
+     * to a specific file in the Lix file system.
+     */
+    lixcol_file_id: Generated<string>;
+    /**
+     * The plugin key that manages this entity type.
+     *
+     * This identifies which plugin is responsible for handling this entity.
+     */
+    lixcol_plugin_key: Generated<string>;
+    /**
+     * Version identifier for this specific state of the entity.
+     *
+     * This column allows you to query and modify entities in specific versions.
+     * Each version may have its own state for the same entity.
+     */
+    lixcol_version_id: Generated<string>;
+    /**
+     * Version identifier this entity was inherited from during branching.
+     *
+     * - `null` if the entity was created in this version
+     * - Contains the source version_id if the entity was inherited from another version
+     *
+     * This is useful for tracking entity lineage across version branches.
+     */
+    lixcol_inherited_from_version_id: Generated<string | null>;
+    /**
+     * Timestamp when this entity was created in this version.
+     *
+     * **Important**: This timestamp is relative to the version specified by lixcol_version_id.
+     * - When an entity is first created, this is the actual creation time
+     * - When an entity is inherited from another version, this is the time it was inherited
+     *
+     * Format: ISO 8601 string (e.g., "2024-03-20T10:30:00.000Z")
+     */
+    lixcol_created_at: Generated<string>;
+    /**
+     * Timestamp when this entity was last updated in this version.
+     *
+     * **Important**: This timestamp is relative to the version specified by lixcol_version_id.
+     * - Updates only when the entity is modified within this specific version
+     * - When first inherited, this equals lixcol_created_at
+     *
+     * Format: ISO 8601 string (e.g., "2024-03-20T10:30:00.000Z")
+     */
+    lixcol_updated_at: Generated<string>;
+    /**
+     * Change identifier for the last modification to this entity.
+     *
+     * This references the change.id that last modified this entity, enabling
+     * blame and diff functionality. Useful for tracking who made changes
+     * and when they were made.
+     */
+    lixcol_change_id: Generated<string>;
+    /**
+     * Whether this entity is stored as untracked state.
+     *
+     * - `false` (default): Entity follows normal change control and versioning
+     * - `true`: Entity bypasses change control for UI state, temporary data, etc.
+     *
+     * Untracked entities don't create change records and have highest priority
+     * in the state resolution order: untracked > tracked > inherited.
+     */
+    lixcol_untracked: Generated<boolean>;
+    /**
+     * Commit identifier that contains this entity's last change.
+     *
+     * This references the commit.id that contains the last change to this entity.
+     * Useful for understanding which commit a particular entity state belongs to,
+     * enabling history queries and version comparison.
+     */
+    lixcol_commit_id: Generated<string>;
+    /**
+     * Writer key associated with the last mutation that produced this entity state.
+     *
+     * Used to attribute writes to individual clients/sessions for echo suppression.
+     * Null when no writer key was set for the mutation.
+     */
+    lixcol_writer_key: Generated<string | null>;
+    /**
+     * Arbitrary metadata attached to the change that produced this entity state.
+     */
+    lixcol_metadata: Generated<Record<string, any> | null>;
+};
+/**
+ * Base type for cross-version cross-version entity views using LixGenerated markers instead of Kysely's Generated type.
+ * This type is compatible with the Lix SDK's type transformation system and allows
+ * cross-version entity operations.
+ *
+ * @example
+ * ```typescript
+ * // Define an entity type for cross-version operations
+ * export type Account = {
+ *   id: LixGenerated<string>;
+ *   name: string;
+ * } & EntityStateByVersionColumns;
+ * ```
+ */
+export type EntityStateByVersionColumns = {
+    /**
+     * The unique identifier for this entity within its schema and file.
+     *
+     * This is the primary identifier used to reference this specific entity.
+     */
+    lixcol_entity_id: LixGenerated<string>;
+    /**
+     * The schema key that defines the structure and type of this entity.
+     *
+     * This references the schema definition that validates and types this entity.
+     */
+    lixcol_schema_key: LixGenerated<string>;
+    /**
+     * File identifier where this entity is stored.
+     *
+     * This references the file_id in the state table and links the entity
+     * to a specific file in the Lix file system.
+     */
+    lixcol_file_id: LixGenerated<string>;
+    /**
+     * The plugin key that manages this entity type.
+     *
+     * This identifies which plugin is responsible for handling this entity.
+     */
+    lixcol_plugin_key: LixGenerated<string>;
+    /**
+     * Version identifier for this specific state of the entity.
+     *
+     * This column allows you to query and modify entities in specific versions.
+     * Each version may have its own state for the same entity.
+     */
+    lixcol_version_id: LixGenerated<string>;
+    /**
+     * Timestamp when this entity was created in this version.
+     *
+     * **Important**: This timestamp is relative to the version specified by lixcol_version_id.
+     * - When an entity is first created, this is the actual creation time
+     * - When an entity is inherited from another version, this is the time it was inherited
+     *
+     * Format: ISO 8601 string (e.g., "2024-03-20T10:30:00.000Z")
+     */
+    lixcol_created_at: LixGenerated<string>;
+    /**
+     * Timestamp when this entity was last updated in this version.
+     *
+     * **Important**: This timestamp is relative to the version specified by lixcol_version_id.
+     * - Updates only when the entity is modified within this specific version
+     * - When first inherited, this equals lixcol_created_at
+     *
+     * Format: ISO 8601 string (e.g., "2024-03-20T10:30:00.000Z")
+     */
+    lixcol_updated_at: LixGenerated<string>;
+    /**
+     * Version identifier this entity was inherited from during branching.
+     *
+     * - `null` if the entity was created in this version
+     * - Contains the source version_id if the entity was inherited from another version
+     *
+     * This is useful for tracking entity lineage across version branches.
+     */
+    lixcol_inherited_from_version_id: LixGenerated<string | null>;
+    /**
+     * Change identifier for the last modification to this entity.
+     *
+     * This references the change.id that last modified this entity, enabling
+     * blame and diff functionality. Useful for tracking who made changes
+     * and when they were made.
+     */
+    lixcol_change_id: LixGenerated<string>;
+    /**
+     * Whether this entity is stored as untracked state.
+     *
+     * - `false` (default): Entity follows normal change control and versioning
+     * - `true`: Entity bypasses change control for UI state, temporary data, etc.
+     *
+     * Untracked entities don't create change records and have highest priority
+     * in the state resolution order: untracked > tracked > inherited.
+     */
+    lixcol_untracked: LixGenerated<boolean>;
+    /**
+     * Commit identifier that contains this entity's last change.
+     *
+     * This references the commit.id that contains the last change to this entity.
+     * Useful for understanding which commit a particular entity state belongs to,
+     * enabling history queries and version comparison.
+     */
+    lixcol_commit_id: LixGenerated<string>;
+    /**
+     * Writer key associated with the last mutation that produced this entity state.
+     *
+     * Used to attribute writes to individual clients/sessions for echo suppression.
+     * Null when no writer key was set for the mutation.
+     */
+    lixcol_writer_key: LixGenerated<string | null>;
+    /**
+     * Arbitrary metadata attached to the change that produced this entity state.
+     */
+    lixcol_metadata: LixGenerated<Record<string, any> | null>;
+};
+//# sourceMappingURL=entity-state-by-version.d.ts.map

package/dist/engine/entity-views/entity-state-by-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-state-by-version.d.ts","sourceRoot":"","sources":["../../../src/engine/entity-views/entity-state-by-version.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAE1E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACtC;;;;OAIG;IACH,gBAAgB,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAEpC;;;;OAIG;IACH,iBAAiB,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAErC;;;;;OAKG;IACH,cAAc,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAElC;;;;OAIG;IACH,iBAAiB,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAErC;;;;;OAKG;IACH,iBAAiB,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAErC;;;;;;;OAOG;IACH,gCAAgC,EAAE,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE3D;;;;;;;;OAQG;IACH,iBAAiB,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAErC;;;;;;;;OAQG;IACH,iBAAiB,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAErC;;;;;;OAMG;IACH,gBAAgB,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAEpC;;;;;;;;OAQG;IACH,gBAAgB,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IAErC;;;;;;OAMG;IACH,gBAAgB,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAEpC;;;;;OAKG;IACH,iBAAiB,EAAE,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE5C;;OAEG;IACH,eAAe,EAAE,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;CACvD,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACzC;;;;OAIG;IACH,gBAAgB,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAEvC;;;;OAIG;IACH,iBAAiB,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAExC;;;;;OAKG;IACH,cAAc,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAErC;;;;OAIG;IACH,iBAAiB,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAExC;;;;;OAKG;IACH,iBAAiB,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAExC;;;;;;;;OAQG;IACH,iBAAiB,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAExC;;;;;;;;OAQG;IACH,iBAAiB,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAExC;;;;;;;OAOG;IACH,gCAAgC,EAAE,YAAY,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE9D;;;;;;OAMG;IACH,gBAAgB,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAEvC;;;;;;;;OAQG;IACH,gBAAgB,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;IAExC;;;;;;OAMG;IACH,gBAAgB,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAEvC;;;;;OAKG;IACH,iBAAiB,EAAE,YAAY,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE/C;;OAEG;IACH,eAAe,EAAE,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;CAC1D,CAAC"}

package/dist/engine/entity-views/entity-state-by-version.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=entity-state-by-version.js.map

package/dist/engine/entity-views/entity-state-by-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-state-by-version.js","sourceRoot":"","sources":["../../../src/engine/entity-views/entity-state-by-version.ts"],"names":[],"mappings":""}