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

package/dist/schema-definition/definition.d.ts

@@ -1,4 +1,6 @@
 import type { FromSchema, JSONSchema } from "json-schema-to-ts";
+import type { JsonPointer } from "./json-pointer.js";
+export type LixForeignKeyScopeColumn = "version_id" | "file_id";
 /**
  * Foreign key constraint definition
  */
@@ -7,7 +9,7 @@ export type LixForeignKey = {
      * Local JSON-schema property names that participate in the FK.
      * Must have at least one property.
      */
-    properties: readonly string[] | string[];
+    properties: readonly JsonPointer[] | JsonPointer[];
     /**
      * Where they point to.
      */
@@ -19,12 +21,25 @@ export type LixForeignKey = {
         /**
          * Remote property names (must have same length as local properties)
          */
-        properties: readonly string[] | string[];
+        properties: readonly JsonPointer[] | JsonPointer[];
         /**
          * Optional version of the referenced schema
          */
         schemaVersion?: string;
     };
+    /**
+     * Validation mode for this foreign key.
+     * - "immediate" (default): validate referenced existence on insert/update; restrict deletion when referenced.
+     * - "materialized": skip insert/update existence checks (reference is derived/materialized later);
+     *   still restrict deletion when referenced.
+     */
+    mode?: "immediate" | "materialized";
+    /**
+     * Implicit columns that scope the foreign key relationship.
+     * When omitted, defaults to ["version_id", "file_id"] for state-backed schemas.
+     * Provide an empty array to disable implicit scoping entirely.
+     */
+    scope?: readonly LixForeignKeyScopeColumn[] | LixForeignKeyScopeColumn[];
 };
 export declare const LixSchemaDefinition: {
     readonly $schema: "http://json-schema.org/draft-07/schema#";
@@ -39,15 +54,28 @@ export declare const LixSchemaDefinition: {
                 readonly type: "array";
                 readonly items: {
                     readonly type: "array";
+                    readonly minItems: 1;
+                    readonly uniqueItems: true;
                     readonly items: {
                         readonly type: "string";
+                        readonly format: "json-pointer";
+                        readonly description: "JSON Pointer referencing a property";
                     };
                 };
             };
-            readonly "x-primary-key": {
+            readonly additionalProperties: {
+                readonly type: "boolean";
+                readonly const: false;
+                readonly description: "Objects describing Lix schemas must not allow arbitrary additional properties; set this explicitly to false.";
+            };
+            readonly "x-lix-primary-key": {
                 readonly type: "array";
+                readonly minItems: 1;
+                readonly uniqueItems: true;
                 readonly items: {
                     readonly type: "string";
+                    readonly format: "json-pointer";
+                    readonly description: "JSON Pointer referencing a property that participates in the primary key.";
                 };
             };
             readonly "x-lix-foreign-keys": {
@@ -61,7 +89,10 @@ export declare const LixSchemaDefinition: {
                             readonly minItems: 1;
                             readonly items: {
                                 readonly type: "string";
+                                readonly format: "json-pointer";
+                                readonly description: "JSON Pointer referencing the local field.";
                             };
+                            readonly uniqueItems: true;
                             readonly description: "Local JSON-schema property names that participate in the FK";
                         };
                         readonly references: {
@@ -77,7 +108,10 @@ export declare const LixSchemaDefinition: {
                                     readonly minItems: 1;
                                     readonly items: {
                                         readonly type: "string";
+                                        readonly format: "json-pointer";
+                                        readonly description: "JSON Pointer referencing the remote field.";
                                     };
+                                    readonly uniqueItems: true;
                                     readonly description: "Remote property names (same length as local properties)";
                                 };
                                 readonly schemaVersion: {
@@ -87,14 +121,50 @@ export declare const LixSchemaDefinition: {
                                 };
                             };
                         };
+                        readonly mode: {
+                            readonly type: "string";
+                            readonly enum: readonly ["immediate", "materialized"];
+                            readonly description: "Validation mode: immediate (default) or materialized (defer insert/update existence checks)";
+                        };
+                        readonly scope: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "string";
+                                readonly enum: readonly ["version_id", "file_id"];
+                            };
+                            readonly uniqueItems: true;
+                            readonly description: "Implicit columns (version_id and/or file_id) used to scope the foreign key relationship";
+                        };
                     };
                 };
             };
             readonly "x-lix-key": {
                 readonly type: "string";
-                readonly description: "The key of the schema. The key is used to identify the schema. You must use a unique key for each schema.";
+                readonly pattern: "^[a-z][a-z0-9_]*$";
+                readonly description: "The schema identifier. Must be snake_case (lowercase, underscores) to safely embed in SQL identifiers.";
                 readonly examples: readonly ["csv_plugin_cell"];
             };
+            readonly "x-lix-immutable": {
+                readonly type: "boolean";
+                readonly description: "When true, entities for this schema cannot be updated after creation.";
+            };
+            readonly "x-lix-override-lixcols": {
+                readonly type: "object";
+                readonly description: "Default metadata column values (such as lixcol_file_id). Does not affect JSON property defaults.";
+                readonly additionalProperties: {
+                    readonly type: "string";
+                    readonly format: "cel";
+                };
+            };
+            readonly "x-lix-entity-views": {
+                readonly type: "array";
+                readonly description: "Restricts which SQL entity views (state/state_by_version/state_history) are generated. When omitted, all views are created.";
+                readonly items: {
+                    readonly type: "string";
+                    readonly enum: readonly ["state", "state_by_version", "state_history"];
+                };
+                readonly uniqueItems: true;
+            };
             readonly "x-lix-version": {
                 readonly type: "string";
                 readonly description: "The version of the schema. Use the major version to signal breaking changes. Use the minor version to signal non-breaking changes.";
@@ -109,23 +179,24 @@ export declare const LixSchemaDefinition: {
                     }, {
                         readonly type: "object";
                         readonly properties: {
-                            readonly "x-lix-generated": {
-                                readonly type: "boolean";
-                                readonly description: "Whether this property is auto-generated by the database";
+                            readonly "x-lix-default": {
+                                readonly type: "string";
+                                readonly format: "cel";
+                                readonly description: "CEL expression evaluated to produce the default value when the property is omitted.";
                             };
                         };
                     }];
                 };
             };
         };
-        readonly required: readonly ["x-lix-key", "x-lix-version"];
+        readonly required: readonly ["x-lix-key", "x-lix-version", "additionalProperties"];
     }];
 };
 /**
  * Extended property schema that includes Lix-specific extensions
  */
 type LixPropertySchema = JSONSchema & {
-    "x-lix-generated"?: boolean;
+    "x-lix-default"?: string;
 };
 /**
  * LixSchema
@@ -146,6 +217,10 @@ export type LixSchemaDefinition = JSONSchema & {
      *   "csv_plugin_cell"
      */
     "x-lix-key": string;
+    /**
+     * Marks the schema as immutable. Immutable entities may be inserted but cannot be updated.
+     */
+    "x-lix-immutable"?: boolean;
     /**
      * The version of the schema.
      *
@@ -156,7 +231,31 @@ export type LixSchemaDefinition = JSONSchema & {
      *   "1.0"
      */
     "x-lix-version": string;
-    "x-lix-primary-key"?: string[] | readonly string[];
+    /**
+     * Override metadata column values applied by entity-view rewrites (e.g. `lixcol_file_id`).
+     * Does not provide defaults for JSON properties inside `properties`. Each entry is a CEL
+     * expression evaluated in the same context as property defaults.
+     *
+     * @example
+     *   {
+     *     "x-lix-override-lixcols": {
+     *       "lixcol_file_id": "\"lix\"",
+     *       "lixcol_untracked": "0"
+     *     }
+     *   }
+     */
+    "x-lix-override-lixcols"?: Record<string, string>;
+    /**
+     * Restricts which entity views are generated. When omitted, all default
+     * variants (state, state_by_version, state_history) are emitted.
+     *
+     * @example
+     *   {
+     *     "x-lix-entity-views": ["state"] // only generate the base view
+     *   }
+     */
+    "x-lix-entity-views"?: ("state" | "state_by_version" | "state_history")[] | readonly ("state" | "state_by_version" | "state_history")[];
+    "x-lix-primary-key"?: JsonPointer[] | readonly JsonPointer[];
     /**
      * Properties that must be unique per version.
      *
@@ -167,9 +266,9 @@ export type LixSchemaDefinition = JSONSchema & {
      *   {
      *     "x-lix-unique": [
      *       // the id must be unique
-     *       ["id"],
+     *       ["/id"],
      *       // the name and age must be unique as well
-     *       ["name", "age"],
+     *       ["/name", "/age"],
      *     ],
      *     properties: {
      *       id: { type: "string" },
@@ -178,30 +277,34 @@ export type LixSchemaDefinition = JSONSchema & {
      *     },
      *   }
      */
-    "x-lix-unique"?: string[][] | readonly (readonly string[])[];
+    "x-lix-unique"?: JsonPointer[][] | readonly (readonly JsonPointer[])[];
     /**
      * Foreign key constraints referencing other schemas.
      *
      * @example
      *   [
      *     {
-     *       "properties": ["author_id"],
+     *       "properties": ["/author_id"],
      *       "references": {
      *         "schemaKey": "user_profile",
-     *         "properties": ["id"]
+     *         "properties": ["/id"]
      *       }
      *     },
      *     {
-     *       "properties": ["entity_id", "schema_key", "file_id"],
+     *       "properties": ["/entity_id", "/schema_key", "/file_id"],
      *       "references": {
      *         "schemaKey": "state",
-     *         "properties": ["entity_id", "schema_key", "file_id"]
+     *         "properties": ["/entity_id", "/schema_key", "/file_id"]
      *       }
      *     }
      *   ]
      */
     "x-lix-foreign-keys"?: LixForeignKey[] | readonly LixForeignKey[];
     type: "object";
+    /**
+     * Has to be false to know the schema beforehand.
+     */
+    additionalProperties: false;
     properties?: {
         [key: string]: LixPropertySchema;
     };
@@ -344,7 +447,7 @@ export type LixUpdateable<T> = {
 /**
  * Transform a type for select/query operations.
  *
- * This type unwraps all LixGenerated markers, giving you the actual runtime
+ * This type unwraps all LixGenerated markers, giving you the actual engine
  * types that will be returned from database queries. All fields are required
  * and have their base types.
  *
@@ -375,12 +478,12 @@ export type LixUpdateable<T> = {
 export type LixSelectable<T> = {
     [K in keyof T]: SelectType<T[K]>;
 };
+type IsNever<T> = [T] extends [never] ? true : false;
+type IsAny<T> = 0 extends 1 & T ? true : false;
 /**
  * Transform object types with no properties from unknown to Record<string, any>
  */
-type TransformEmptyObject<T> = T extends {
-    [x: string]: unknown;
-} ? Record<string, any> : T;
+type TransformEmptyObject<T> = IsAny<T> extends true ? any : IsNever<T> extends true ? never : T extends object ? keyof T extends never ? Record<string, any> : T : T;
 /**
  * Check if a schema property is an empty object type (no properties defined)
  */
@@ -396,21 +499,24 @@ type GetNullablePart<P> = P extends {
     nullable: true;
 } ? null : never;
 /**
- * Internal type that applies LixGenerated markers to properties with x-lix-generated: true
+ * Internal type that applies LixGenerated markers to properties that provide defaults.
  */
+type PropertyHasDefault<P> = P extends {
+    "x-lix-default": any;
+} ? true : P extends {
+    default: any;
+} ? true : false;
 type ApplyLixGenerated<TSchema extends LixSchemaDefinition> = TSchema extends {
     properties: infer Props;
 } ? {
-    [K in keyof FromSchema<TSchema>]: K extends keyof Props ? Props[K] extends {
-        "x-lix-generated": true;
-    } ? LixGenerated<TransformEmptyObject<FromSchema<TSchema>[K]>> : IsEmptyObjectSchema<Props[K]> extends true ? Record<string, any> | GetNullablePart<Props[K]> : TransformEmptyObject<FromSchema<TSchema>[K]> : TransformEmptyObject<FromSchema<TSchema>[K]>;
+    [K in keyof FromSchema<TSchema>]: K extends keyof Props ? PropertyHasDefault<Props[K]> extends true ? LixGenerated<TransformEmptyObject<FromSchema<TSchema>[K]>> : IsEmptyObjectSchema<Props[K]> extends true ? Record<string, any> | GetNullablePart<Props[K]> : TransformEmptyObject<FromSchema<TSchema>[K]> : TransformEmptyObject<FromSchema<TSchema>[K]>;
 } : never;
 /**
  * Convert a LixSchemaDefinition to a TypeScript type.
  *
  * This type transformation:
  * 1. Converts JSON Schema properties to TypeScript types
- * 2. Wraps properties with `x-lix-generated: true` in LixGenerated markers
+ * 2. Wraps properties that declare defaults (`default` or `x-lix-default`) in LixGenerated markers
  * 3. Transforms `type: "object"` without properties to `Record<string, any>`
  *
  * The resulting type can be used with LixInsertable, LixUpdateable, and
@@ -421,14 +527,14 @@ type ApplyLixGenerated<TSchema extends LixSchemaDefinition> = TSchema extends {
  * const AccountSchema = {
  *   "x-lix-key": "account",
  *   "x-lix-version": "1.0",
- *   "x-lix-primary-key": ["id"],
+ *   "x-lix-primary-key": ["/id"],
  *   type: "object",
  *   properties: {
- *     id: { type: "string", "x-lix-generated": true },
+ *     id: { type: "string", default: "auto-generated" },
  *     name: { type: "string" },
  *     email: { type: "string" },
  *     metadata: { type: "object" },  // Becomes Record<string, any>
- *     created_at: { type: "string", "x-lix-generated": true }
+ *     created_at: { type: "string", "x-lix-default": "lix_now()" }
  *   },
  *   required: ["id", "name", "email"],
  *   additionalProperties: false

package/dist/schema-definition/definition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../src/schema-definition/definition.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../src/schema-definition/definition.ts"],"names":[],"mappings":"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"}

package/dist/schema-definition/definition.js

@@ -13,15 +13,28 @@ export const LixSchemaDefinition = {
                     type: "array",
                     items: {
                         type: "array",
+                        minItems: 1,
+                        uniqueItems: true,
                         items: {
                             type: "string",
+                            format: "json-pointer",
+                            description: "JSON Pointer referencing a property",
                         },
                     },
                 },
-                "x-primary-key": {
+                additionalProperties: {
+                    type: "boolean",
+                    const: false,
+                    description: "Objects describing Lix schemas must not allow arbitrary additional properties; set this explicitly to false.",
+                },
+                "x-lix-primary-key": {
                     type: "array",
+                    minItems: 1,
+                    uniqueItems: true,
                     items: {
                         type: "string",
+                        format: "json-pointer",
+                        description: "JSON Pointer referencing a property that participates in the primary key.",
                     },
                 },
                 "x-lix-foreign-keys": {
@@ -33,7 +46,12 @@ export const LixSchemaDefinition = {
                             properties: {
                                 type: "array",
                                 minItems: 1,
-                                items: { type: "string" },
+                                items: {
+                                    type: "string",
+                                    format: "json-pointer",
+                                    description: "JSON Pointer referencing the local field.",
+                                },
+                                uniqueItems: true,
                                 description: "Local JSON-schema property names that participate in the FK",
                             },
                             references: {
@@ -47,7 +65,12 @@ export const LixSchemaDefinition = {
                                     properties: {
                                         type: "array",
                                         minItems: 1,
-                                        items: { type: "string" },
+                                        items: {
+                                            type: "string",
+                                            format: "json-pointer",
+                                            description: "JSON Pointer referencing the remote field.",
+                                        },
+                                        uniqueItems: true,
                                         description: "Remote property names (same length as local properties)",
                                     },
                                     schemaVersion: {
@@ -57,6 +80,20 @@ export const LixSchemaDefinition = {
                                     },
                                 },
                             },
+                            mode: {
+                                type: "string",
+                                enum: ["immediate", "materialized"],
+                                description: "Validation mode: immediate (default) or materialized (defer insert/update existence checks)",
+                            },
+                            scope: {
+                                type: "array",
+                                items: {
+                                    type: "string",
+                                    enum: ["version_id", "file_id"],
+                                },
+                                uniqueItems: true,
+                                description: "Implicit columns (version_id and/or file_id) used to scope the foreign key relationship",
+                            },
                             // onDelete: {
                             //   type: "string",
                             //   enum: ["cascade", "restrict", "set null"],
@@ -72,9 +109,31 @@ export const LixSchemaDefinition = {
                 },
                 "x-lix-key": {
                     type: "string",
-                    description: "The key of the schema. The key is used to identify the schema. You must use a unique key for each schema.",
+                    pattern: "^[a-z][a-z0-9_]*$",
+                    description: "The schema identifier. Must be snake_case (lowercase, underscores) to safely embed in SQL identifiers.",
                     examples: ["csv_plugin_cell"],
                 },
+                "x-lix-immutable": {
+                    type: "boolean",
+                    description: "When true, entities for this schema cannot be updated after creation.",
+                },
+                "x-lix-override-lixcols": {
+                    type: "object",
+                    description: "Default metadata column values (such as lixcol_file_id). Does not affect JSON property defaults.",
+                    additionalProperties: {
+                        type: "string",
+                        format: "cel",
+                    },
+                },
+                "x-lix-entity-views": {
+                    type: "array",
+                    description: "Restricts which SQL entity views (state/state_by_version/state_history) are generated. When omitted, all views are created.",
+                    items: {
+                        type: "string",
+                        enum: ["state", "state_by_version", "state_history"],
+                    },
+                    uniqueItems: true,
+                },
                 "x-lix-version": {
                     type: "string",
                     description: "The version of the schema. Use the major version to signal breaking changes. Use the minor version to signal non-breaking changes.",
@@ -89,9 +148,10 @@ export const LixSchemaDefinition = {
                             {
                                 type: "object",
                                 properties: {
-                                    "x-lix-generated": {
-                                        type: "boolean",
-                                        description: "Whether this property is auto-generated by the database",
+                                    "x-lix-default": {
+                                        type: "string",
+                                        format: "cel",
+                                        description: "CEL expression evaluated to produce the default value when the property is omitted.",
                                     },
                                 },
                             },
@@ -99,7 +159,7 @@ export const LixSchemaDefinition = {
                     },
                 },
             },
-            required: ["x-lix-key", "x-lix-version"],
+            required: ["x-lix-key", "x-lix-version", "additionalProperties"],
         },
     ],
 };

package/dist/schema-definition/definition.js.map

@@ -1 +1 @@
-{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../src/schema-definition/definition.ts"],"names":[],"mappings":"AAmCA,MAAM,CAAC,MAAM,mBAAmB,GAAG;IAClC,OAAO,EAAE,yCAAyC;IAClD,KAAK,EAAE,mBAAmB;IAC1B,WAAW,EACV,oHAAoH;IACrH,KAAK,EAAE;QACN;YACC,IAAI,EAAE,yCAAyC;SAC/C;QACD;YACC,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACX,cAAc,EAAE;oBACf,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE;wBACN,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE;4BACN,IAAI,EAAE,QAAQ;yBACd;qBACD;iBACD;gBACD,eAAe,EAAE;oBAChB,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE;wBACN,IAAI,EAAE,QAAQ;qBACd;iBACD;gBACD,oBAAoB,EAAE;oBACrB,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE;wBACN,IAAI,EAAE,QAAQ;wBACd,QAAQ,EAAE,CAAC,YAAY,EAAE,YAAY,CAAC;wBACtC,UAAU,EAAE;4BACX,UAAU,EAAE;gCACX,IAAI,EAAE,OAAO;gCACb,QAAQ,EAAE,CAAC;gCACX,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gCACzB,WAAW,EACV,6DAA6D;6BAC9D;4BACD,UAAU,EAAE;gCACX,IAAI,EAAE,QAAQ;gCACd,QAAQ,EAAE,CAAC,WAAW,EAAE,YAAY,CAAC;gCACrC,UAAU,EAAE;oCACX,SAAS,EAAE;wCACV,IAAI,EAAE,QAAQ;wCACd,WAAW,EAAE,wCAAwC;qCACrD;oCACD,UAAU,EAAE;wCACX,IAAI,EAAE,OAAO;wCACb,QAAQ,EAAE,CAAC;wCACX,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;wCACzB,WAAW,EACV,yDAAyD;qCAC1D;oCACD,aAAa,EAAE;wCACd,IAAI,EAAE,QAAQ;wCACd,OAAO,EAAE,eAAe;wCACxB,WAAW,EAAE,2CAA2C;qCACxD;iCACD;6BACD;4BACD,cAAc;4BACd,oBAAoB;4BACpB,+CAA+C;4BAC/C,qFAAqF;4BACrF,KAAK;4BACL,cAAc;4BACd,oBAAoB;4BACpB,mCAAmC;4BACnC,qFAAqF;4BACrF,KAAK;yBACL;qBACD;iBACD;gBACD,WAAW,EAAE;oBACZ,IAAI,EAAE,QAAQ;oBACd,WAAW,EACV,2GAA2G;oBAC5G,QAAQ,EAAE,CAAC,iBAAiB,CAAC;iBAC7B;gBACD,eAAe,EAAE;oBAChB,IAAI,EAAE,QAAQ;oBACd,WAAW,EACV,oIAAoI;oBACrI,OAAO,EAAE,eAAe;oBACxB,QAAQ,EAAE,CAAC,KAAK,CAAC;iBACjB;gBACD,UAAU,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,oBAAoB,EAAE;wBACrB,KAAK,EAAE;4BACN,EAAE,IAAI,EAAE,yCAAyC,EAAE;4BACnD;gCACC,IAAI,EAAE,QAAQ;gCACd,UAAU,EAAE;oCACX,iBAAiB,EAAE;wCAClB,IAAI,EAAE,SAAS;wCACf,WAAW,EACV,yDAAyD;qCAC1D;iCACD;6BACD;yBACD;qBACD;iBACD;aACD;YACD,QAAQ,EAAE,CAAC,WAAW,EAAE,eAAe,CAAC;SACxC;KACD;CACQ,CAAC"}
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../src/schema-definition/definition.ts"],"names":[],"mappings":"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"}

package/dist/schema-definition/definition.test-d.js

@@ -22,6 +22,73 @@ test("a json change schema should be infer the properties", () => {
     };
     assertType(snapshot);
 });
+test("FromLixSchemaDefinition preserves nested object property types", () => {
+    const schema = {
+        "x-lix-version": "1.0",
+        "x-lix-key": "location_example",
+        type: "object",
+        properties: {
+            id: { type: "string" },
+            location: {
+                type: "object",
+                properties: {
+                    city: { type: "string" },
+                    country: { type: "string" },
+                },
+                required: ["city", "country"],
+            },
+            metadata: {
+                type: "object",
+            },
+        },
+        required: ["id", "location"],
+        additionalProperties: false,
+    };
+    const validSnapshot = {
+        id: "123",
+        location: { city: "Berlin", country: "DE" },
+        metadata: { extra: "value" },
+    };
+    assertType(validSnapshot);
+    // @ts-expect-error - city must remain a string
+    const invalidLocation = { city: 123, country: "DE" };
+    void invalidLocation;
+});
+test("x-lix-override-lixcols typing", () => {
+    const schema = {
+        "x-lix-key": "defaults",
+        "x-lix-version": "1.0",
+        type: "object",
+        properties: {
+            id: { type: "string" },
+        },
+        required: ["id"],
+        additionalProperties: false,
+        "x-lix-entity-views": ["state"],
+        "x-lix-override-lixcols": {
+            lixcol_file_id: '"lix"',
+            attempts: "3",
+        },
+    };
+    assertType(schema["x-lix-override-lixcols"]);
+    assertType(schema["x-lix-entity-views"]);
+});
+test("x-lix-default typing", () => {
+    const schema = {
+        "x-lix-key": "cel_default",
+        "x-lix-version": "1.0",
+        type: "object",
+        properties: {
+            id: {
+                type: "string",
+                "x-lix-default": "lix_uuid_v7()",
+            },
+        },
+        required: ["id"],
+        additionalProperties: false,
+    };
+    assertType(schema.properties.id?.["x-lix-default"]);
+});
 test("LixInsertable combined with LixGenerated makes columns optional", () => {
     // pass (all properties are provided)
     const z = {
@@ -116,17 +183,17 @@ test("LixUpdateable makes all fields optional and unwraps LixGenerated", () => {
         metadata: { bar: "wrong key" },
     };
 });
-test("FromLixSchemaDefinition transforms schema with x-lix-generated to LixGenerated types", () => {
-    // Define a test schema with x-lix-generated properties
+test("FromLixSchemaDefinition transforms schema with x-lix-default to LixGenerated types", () => {
+    // Define a test schema with x-lix-default properties
     const TestSchema = {
         "x-lix-key": "test_entity",
         "x-lix-version": "1.0",
-        "x-lix-primary-key": ["id"],
+        "x-lix-primary-key": ["/id"],
         type: "object",
         properties: {
             id: {
                 type: "string",
-                "x-lix-generated": true,
+                "x-lix-default": "lix_nano_id()",
             },
             name: {
                 type: "string",
@@ -150,20 +217,21 @@ test("FromLixSchemaDefinition transforms empty object types to Record<string, an
     const TestSchema = {
         "x-lix-key": "test_entity",
         "x-lix-version": "1.0",
-        "x-lix-primary-key": ["id"],
+        "x-lix-primary-key": ["/id"],
+        "x-lix-immutable": true,
         type: "object",
         properties: {
             id: { type: "string" },
-            metadata: { type: "object" },
+            payload: { type: "object" },
             config: { type: "object", nullable: true },
         },
-        required: ["id", "metadata"],
+        required: ["id", "payload"],
         additionalProperties: false,
     };
-    // Test that metadata is Record<string, any>
+    // Test that payload is Record<string, any>
     const entity = {
         id: "test",
-        metadata: {
+        payload: {
             author: "test-user",
             created_at: new Date().toISOString(),
             nested: { deep: { value: 123 } },
@@ -171,7 +239,7 @@ test("FromLixSchemaDefinition transforms empty object types to Record<string, an
         config: null,
     };
     // Verify types
-    assertType(entity.metadata);
+    assertType(entity.payload);
     assertType(entity.config);
 });
 //# sourceMappingURL=definition.test-d.js.map