@lix-js/sdk 0.6.0-preview.0 → 0.6.0-preview.2

package/dist-engine-src/src/schema/builtin/lix_directory_descriptor.json

@@ -0,0 +1,53 @@
+{
+  "x-lix-key": "lix_directory_descriptor",
+  "x-lix-version": "1",
+  "x-lix-primary-key": [
+    "/id"
+  ],
+  "x-lix-unique": [
+    [
+      "/parent_id",
+      "/name"
+    ]
+  ],
+  "x-lix-foreign-keys": [
+    {
+      "properties": [
+        "/parent_id"
+      ],
+      "references": {
+        "schemaKey": "lix_directory_descriptor",
+        "properties": [
+          "/id"
+        ]
+      }
+    }
+  ],
+  "type": "object",
+  "properties": {
+    "id": {
+      "type": "string",
+      "x-lix-default": "lix_uuid_v7()"
+    },
+    "parent_id": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "name": {
+      "type": "string",
+      "pattern": "^(?!\\.{1,2}$)[^/\\\\]+$"
+    },
+    "hidden": {
+      "type": "boolean",
+      "x-lix-default": "false"
+    }
+  },
+  "required": [
+    "id",
+    "parent_id",
+    "name"
+  ],
+  "additionalProperties": false
+}

package/dist-engine-src/src/schema/builtin/lix_entity_label.json

@@ -0,0 +1,63 @@
+{
+  "x-lix-key": "lix_entity_label",
+  "x-lix-version": "1",
+  "x-lix-primary-key": [
+    "/entity_id",
+    "/schema_key",
+    "/file_id",
+    "/label_id"
+  ],
+  "x-lix-foreign-keys": [
+    {
+      "properties": [
+        "/entity_id",
+        "/schema_key",
+        "/file_id"
+      ],
+      "references": {
+        "schemaKey": "lix_state",
+        "properties": [
+          "/entity_id",
+          "/schema_key",
+          "/file_id"
+        ]
+      }
+    },
+    {
+      "properties": [
+        "/label_id"
+      ],
+      "references": {
+        "schemaKey": "lix_label",
+        "properties": [
+          "/id"
+        ]
+      }
+    }
+  ],
+  "type": "object",
+  "properties": {
+    "entity_id": {
+      "type": "string"
+    },
+    "schema_key": {
+      "type": "string"
+    },
+    "file_id": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "label_id": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "entity_id",
+    "schema_key",
+    "file_id",
+    "label_id"
+  ],
+  "additionalProperties": false
+}

package/dist-engine-src/src/schema/builtin/lix_file_descriptor.json

@@ -0,0 +1,53 @@
+{
+  "x-lix-key": "lix_file_descriptor",
+  "x-lix-version": "1",
+  "x-lix-primary-key": [
+    "/id"
+  ],
+  "x-lix-unique": [
+    [
+      "/directory_id",
+      "/name"
+    ]
+  ],
+  "x-lix-foreign-keys": [
+    {
+      "properties": [
+        "/directory_id"
+      ],
+      "references": {
+        "schemaKey": "lix_directory_descriptor",
+        "properties": [
+          "/id"
+        ]
+      }
+    }
+  ],
+  "type": "object",
+  "properties": {
+    "id": {
+      "type": "string",
+      "x-lix-default": "lix_uuid_v7()"
+    },
+    "directory_id": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "name": {
+      "type": "string",
+      "pattern": "^(?!\\.{1,2}$)[^/\\\\]+$"
+    },
+    "hidden": {
+      "type": "boolean",
+      "x-lix-default": "false"
+    }
+  },
+  "required": [
+    "id",
+    "directory_id",
+    "name"
+  ],
+  "additionalProperties": false
+}

package/dist-engine-src/src/schema/builtin/lix_key_value.json

@@ -0,0 +1,41 @@
+{
+  "x-lix-key": "lix_key_value",
+  "x-lix-version": "1",
+  "x-lix-primary-key": [
+    "/key"
+  ],
+  "type": "object",
+  "properties": {
+    "key": {
+      "type": "string"
+    },
+    "value": {
+      "description": "Arbitrary JSON value. This field stays in the JSON domain even when different rows hold different JSON kinds.",
+      "anyOf": [
+        {
+          "type": "object"
+        },
+        {
+          "type": "array"
+        },
+        {
+          "type": "string"
+        },
+        {
+          "type": "number"
+        },
+        {
+          "type": "boolean"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    }
+  },
+  "required": [
+    "key",
+    "value"
+  ],
+  "additionalProperties": false
+}

package/dist-engine-src/src/schema/builtin/lix_label.json

@@ -0,0 +1,22 @@
+{
+  "x-lix-key": "lix_label",
+  "x-lix-version": "1",
+  "x-lix-primary-key": [
+    "/id"
+  ],
+  "type": "object",
+  "properties": {
+    "id": {
+      "type": "string",
+      "x-lix-default": "lix_uuid_v7()"
+    },
+    "name": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "id",
+    "name"
+  ],
+  "additionalProperties": false
+}

package/dist-engine-src/src/schema/builtin/lix_registered_schema.json

@@ -0,0 +1,31 @@
+{
+  "x-lix-key": "lix_registered_schema",
+  "x-lix-version": "1",
+  "x-lix-primary-key": [
+    "/value/x-lix-key",
+    "/value/x-lix-version"
+  ],
+  "type": "object",
+  "properties": {
+    "value": {
+      "type": "object",
+      "properties": {
+        "x-lix-key": {
+          "type": "string"
+        },
+        "x-lix-version": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "x-lix-key",
+        "x-lix-version"
+      ],
+      "additionalProperties": true
+    }
+  },
+  "required": [
+    "value"
+  ],
+  "additionalProperties": false
+}

package/dist-engine-src/src/schema/builtin/lix_version_descriptor.json

@@ -0,0 +1,35 @@
+{
+  "x-lix-key": "lix_version_descriptor",
+  "x-lix-version": "1",
+  "description": "User-facing version metadata (name and visibility) for a branch-like version. The stable identity of a version; the matching `lix_version_ref` carries the moving head pointer. The catalog's `lix_version` surface joins this descriptor with its ref to present a single user-visible version row.",
+  "x-lix-primary-key": [
+    "/id"
+  ],
+  "x-lix-unique": [
+    [
+      "/name"
+    ]
+  ],
+  "type": "object",
+  "properties": {
+    "id": {
+      "type": "string",
+      "x-lix-default": "lix_uuid_v7()",
+      "description": "Stable version identifier (UUIDv7). Referenced by `lix_version_ref.id`."
+    },
+    "name": {
+      "type": "string",
+      "description": "Human-readable version name (e.g. `main`, `feature-x`) shown in version listings and CLI output."
+    },
+    "hidden": {
+      "type": "boolean",
+      "default": false,
+      "description": "When true, the version is filtered from default listings (CLI, catalog views); operations by explicit id still succeed."
+    }
+  },
+  "required": [
+    "id",
+    "name"
+  ],
+  "additionalProperties": false
+}

package/dist-engine-src/src/schema/builtin/lix_version_ref.json

@@ -0,0 +1,49 @@
+{
+  "x-lix-key": "lix_version_ref",
+  "x-lix-version": "1",
+  "description": "Version head pointer. Records which commit a version should currently resolve to in the local runtime. Intentionally not part of canonical commit membership: refs may be reset client-side after sync without introducing content conflicts. Each `lix_version_descriptor.id` has exactly one `lix_version_ref` row.",
+  "x-lix-primary-key": [
+    "/id"
+  ],
+  "x-lix-foreign-keys": [
+    {
+      "properties": [
+        "/id"
+      ],
+      "references": {
+        "schemaKey": "lix_version_descriptor",
+        "properties": [
+          "/id"
+        ]
+      }
+    },
+    {
+      "properties": [
+        "/commit_id"
+      ],
+      "references": {
+        "schemaKey": "lix_commit",
+        "properties": [
+          "/id"
+        ]
+      }
+    }
+  ],
+  "type": "object",
+  "properties": {
+    "id": {
+      "type": "string",
+      "x-lix-default": "lix_uuid_v7()",
+      "description": "Version identifier whose head pointer is being stored; matches `lix_version_descriptor.id`."
+    },
+    "commit_id": {
+      "type": "string",
+      "description": "Commit the version should currently resolve to in the local runtime (references `lix_commit.id`)."
+    }
+  },
+  "required": [
+    "id",
+    "commit_id"
+  ],
+  "additionalProperties": false
+}

package/dist-engine-src/src/schema/builtin/mod.rs

@@ -0,0 +1,271 @@
+use serde_json::Value as JsonValue;
+use std::sync::OnceLock;
+
+use crate::schema::lix_schema_definition;
+
+const LIX_REGISTERED_SCHEMA_KEY: &str = "lix_registered_schema";
+const LIX_KEY_VALUE_SCHEMA_KEY: &str = "lix_key_value";
+const LIX_ACCOUNT_SCHEMA_KEY: &str = "lix_account";
+const LIX_ACTIVE_ACCOUNT_SCHEMA_KEY: &str = "lix_active_account";
+const LIX_LABEL_SCHEMA_KEY: &str = "lix_label";
+const LIX_ENTITY_LABEL_SCHEMA_KEY: &str = "lix_entity_label";
+const LIX_CHANGE_SCHEMA_KEY: &str = "lix_change";
+const LIX_CHANGE_AUTHOR_SCHEMA_KEY: &str = "lix_change_author";
+const LIX_CHANGE_SET_SCHEMA_KEY: &str = "lix_change_set";
+const LIX_COMMIT_SCHEMA_KEY: &str = "lix_commit";
+const LIX_VERSION_DESCRIPTOR_SCHEMA_KEY: &str = "lix_version_descriptor";
+const LIX_VERSION_REF_SCHEMA_KEY: &str = "lix_version_ref";
+const LIX_CHANGE_SET_ELEMENT_SCHEMA_KEY: &str = "lix_change_set_element";
+const LIX_COMMIT_EDGE_SCHEMA_KEY: &str = "lix_commit_edge";
+const LIX_FILE_DESCRIPTOR_SCHEMA_KEY: &str = "lix_file_descriptor";
+const LIX_DIRECTORY_DESCRIPTOR_SCHEMA_KEY: &str = "lix_directory_descriptor";
+const LIX_BINARY_BLOB_REF_SCHEMA_KEY: &str = "lix_binary_blob_ref";
+const LIX_STATE_SURFACE_SCHEMA_KEY: &str = "lix_state";
+
+const LIX_REGISTERED_SCHEMA_JSON: &str = include_str!("lix_registered_schema.json");
+const LIX_KEY_VALUE_SCHEMA_JSON: &str = include_str!("lix_key_value.json");
+const LIX_ACCOUNT_SCHEMA_JSON: &str = include_str!("lix_account.json");
+const LIX_ACTIVE_ACCOUNT_SCHEMA_JSON: &str = include_str!("lix_active_account.json");
+const LIX_LABEL_SCHEMA_JSON: &str = include_str!("lix_label.json");
+const LIX_ENTITY_LABEL_SCHEMA_JSON: &str = include_str!("lix_entity_label.json");
+const LIX_CHANGE_SCHEMA_JSON: &str = include_str!("lix_change.json");
+const LIX_CHANGE_AUTHOR_SCHEMA_JSON: &str = include_str!("lix_change_author.json");
+const LIX_CHANGE_SET_SCHEMA_JSON: &str = include_str!("lix_change_set.json");
+const LIX_COMMIT_SCHEMA_JSON: &str = include_str!("lix_commit.json");
+const LIX_VERSION_DESCRIPTOR_SCHEMA_JSON: &str = include_str!("lix_version_descriptor.json");
+const LIX_VERSION_REF_SCHEMA_JSON: &str = include_str!("lix_version_ref.json");
+const LIX_CHANGE_SET_ELEMENT_SCHEMA_JSON: &str = include_str!("lix_change_set_element.json");
+const LIX_COMMIT_EDGE_SCHEMA_JSON: &str = include_str!("lix_commit_edge.json");
+const LIX_FILE_DESCRIPTOR_SCHEMA_JSON: &str = include_str!("lix_file_descriptor.json");
+const LIX_DIRECTORY_DESCRIPTOR_SCHEMA_JSON: &str = include_str!("lix_directory_descriptor.json");
+const LIX_BINARY_BLOB_REF_SCHEMA_JSON: &str = include_str!("lix_binary_blob_ref.json");
+
+static LIX_REGISTERED_SCHEMA: OnceLock<JsonValue> = OnceLock::new();
+static LIX_KEY_VALUE_SCHEMA: OnceLock<JsonValue> = OnceLock::new();
+static LIX_ACCOUNT_SCHEMA: OnceLock<JsonValue> = OnceLock::new();
+static LIX_ACTIVE_ACCOUNT_SCHEMA: OnceLock<JsonValue> = OnceLock::new();
+static LIX_LABEL_SCHEMA: OnceLock<JsonValue> = OnceLock::new();
+static LIX_ENTITY_LABEL_SCHEMA: OnceLock<JsonValue> = OnceLock::new();
+static LIX_CHANGE_SCHEMA: OnceLock<JsonValue> = OnceLock::new();
+static LIX_CHANGE_AUTHOR_SCHEMA: OnceLock<JsonValue> = OnceLock::new();
+static LIX_CHANGE_SET_SCHEMA: OnceLock<JsonValue> = OnceLock::new();
+static LIX_COMMIT_SCHEMA: OnceLock<JsonValue> = OnceLock::new();
+static LIX_VERSION_DESCRIPTOR_SCHEMA: OnceLock<JsonValue> = OnceLock::new();
+static LIX_VERSION_REF_SCHEMA: OnceLock<JsonValue> = OnceLock::new();
+static LIX_CHANGE_SET_ELEMENT_SCHEMA: OnceLock<JsonValue> = OnceLock::new();
+static LIX_COMMIT_EDGE_SCHEMA: OnceLock<JsonValue> = OnceLock::new();
+static LIX_FILE_DESCRIPTOR_SCHEMA: OnceLock<JsonValue> = OnceLock::new();
+static LIX_DIRECTORY_DESCRIPTOR_SCHEMA: OnceLock<JsonValue> = OnceLock::new();
+static LIX_BINARY_BLOB_REF_SCHEMA: OnceLock<JsonValue> = OnceLock::new();
+static LIX_STATE_SURFACE_SCHEMA: OnceLock<JsonValue> = OnceLock::new();
+
+const BUILTIN_SCHEMA_KEYS: &[&str] = &[
+    LIX_REGISTERED_SCHEMA_KEY,
+    LIX_KEY_VALUE_SCHEMA_KEY,
+    LIX_ACCOUNT_SCHEMA_KEY,
+    LIX_ACTIVE_ACCOUNT_SCHEMA_KEY,
+    LIX_LABEL_SCHEMA_KEY,
+    LIX_ENTITY_LABEL_SCHEMA_KEY,
+    LIX_CHANGE_SCHEMA_KEY,
+    LIX_CHANGE_AUTHOR_SCHEMA_KEY,
+    LIX_CHANGE_SET_SCHEMA_KEY,
+    LIX_COMMIT_SCHEMA_KEY,
+    LIX_VERSION_DESCRIPTOR_SCHEMA_KEY,
+    LIX_VERSION_REF_SCHEMA_KEY,
+    LIX_CHANGE_SET_ELEMENT_SCHEMA_KEY,
+    LIX_COMMIT_EDGE_SCHEMA_KEY,
+    LIX_FILE_DESCRIPTOR_SCHEMA_KEY,
+    LIX_DIRECTORY_DESCRIPTOR_SCHEMA_KEY,
+    LIX_BINARY_BLOB_REF_SCHEMA_KEY,
+];
+
+pub(super) fn is_seed_schema_key(schema_key: &str) -> bool {
+    BUILTIN_SCHEMA_KEYS.contains(&schema_key)
+}
+
+pub(super) fn seed_schema_definitions() -> Vec<&'static JsonValue> {
+    BUILTIN_SCHEMA_KEYS
+        .iter()
+        .map(|schema_key| {
+            seed_schema_definition(schema_key)
+                .unwrap_or_else(|| panic!("missing seed schema definition for '{schema_key}'"))
+        })
+        .collect()
+}
+
+// `lix_state` is a public SQL surface, not a stored builtin schema row, but
+// multiple owners still need a schema-shaped contract for validation and SQL
+// preparation. Keep that shared shape here so those callers do not drift.
+pub(crate) fn lix_state_surface_schema_definition() -> &'static JsonValue {
+    LIX_STATE_SURFACE_SCHEMA.get_or_init(|| {
+        serde_json::json!({
+            "x-lix-key": LIX_STATE_SURFACE_SCHEMA_KEY,
+            "x-lix-version": "1",
+            "x-lix-primary-key": [
+                "/entity_id",
+                "/schema_key",
+                "/file_id"
+            ],
+            "type": "object",
+            "properties": {
+                "entity_id": { "type": "string" },
+                "schema_key": { "type": "string" },
+                "file_id": { "type": "string" }
+            },
+            "required": [
+                "entity_id",
+                "schema_key",
+                "file_id"
+            ],
+            "additionalProperties": true
+        })
+    })
+}
+
+pub(super) fn seed_schema_definition(schema_key: &str) -> Option<&'static JsonValue> {
+    match schema_key {
+        LIX_REGISTERED_SCHEMA_KEY => Some(
+            LIX_REGISTERED_SCHEMA.get_or_init(|| parse_registered_schema_with_inlined_definition()),
+        ),
+        LIX_KEY_VALUE_SCHEMA_KEY => {
+            Some(LIX_KEY_VALUE_SCHEMA.get_or_init(|| {
+                parse_builtin_schema("lix_key_value.json", LIX_KEY_VALUE_SCHEMA_JSON)
+            }))
+        }
+        LIX_ACCOUNT_SCHEMA_KEY => Some(
+            LIX_ACCOUNT_SCHEMA
+                .get_or_init(|| parse_builtin_schema("lix_account.json", LIX_ACCOUNT_SCHEMA_JSON)),
+        ),
+        LIX_ACTIVE_ACCOUNT_SCHEMA_KEY => Some(LIX_ACTIVE_ACCOUNT_SCHEMA.get_or_init(|| {
+            parse_builtin_schema("lix_active_account.json", LIX_ACTIVE_ACCOUNT_SCHEMA_JSON)
+        })),
+        LIX_LABEL_SCHEMA_KEY => Some(
+            LIX_LABEL_SCHEMA
+                .get_or_init(|| parse_builtin_schema("lix_label.json", LIX_LABEL_SCHEMA_JSON)),
+        ),
+        LIX_ENTITY_LABEL_SCHEMA_KEY => Some(LIX_ENTITY_LABEL_SCHEMA.get_or_init(|| {
+            parse_builtin_schema("lix_entity_label.json", LIX_ENTITY_LABEL_SCHEMA_JSON)
+        })),
+        LIX_CHANGE_SCHEMA_KEY => Some(
+            LIX_CHANGE_SCHEMA
+                .get_or_init(|| parse_builtin_schema("lix_change.json", LIX_CHANGE_SCHEMA_JSON)),
+        ),
+        LIX_CHANGE_AUTHOR_SCHEMA_KEY => Some(LIX_CHANGE_AUTHOR_SCHEMA.get_or_init(|| {
+            parse_builtin_schema("lix_change_author.json", LIX_CHANGE_AUTHOR_SCHEMA_JSON)
+        })),
+        LIX_CHANGE_SET_SCHEMA_KEY => Some(LIX_CHANGE_SET_SCHEMA.get_or_init(|| {
+            parse_builtin_schema("lix_change_set.json", LIX_CHANGE_SET_SCHEMA_JSON)
+        })),
+        LIX_COMMIT_SCHEMA_KEY => Some(
+            LIX_COMMIT_SCHEMA
+                .get_or_init(|| parse_builtin_schema("lix_commit.json", LIX_COMMIT_SCHEMA_JSON)),
+        ),
+        LIX_VERSION_DESCRIPTOR_SCHEMA_KEY => {
+            Some(LIX_VERSION_DESCRIPTOR_SCHEMA.get_or_init(|| {
+                parse_builtin_schema(
+                    "lix_version_descriptor.json",
+                    LIX_VERSION_DESCRIPTOR_SCHEMA_JSON,
+                )
+            }))
+        }
+        LIX_VERSION_REF_SCHEMA_KEY => Some(LIX_VERSION_REF_SCHEMA.get_or_init(|| {
+            parse_builtin_schema("lix_version_ref.json", LIX_VERSION_REF_SCHEMA_JSON)
+        })),
+        LIX_CHANGE_SET_ELEMENT_SCHEMA_KEY => {
+            Some(LIX_CHANGE_SET_ELEMENT_SCHEMA.get_or_init(|| {
+                parse_builtin_schema(
+                    "lix_change_set_element.json",
+                    LIX_CHANGE_SET_ELEMENT_SCHEMA_JSON,
+                )
+            }))
+        }
+        LIX_COMMIT_EDGE_SCHEMA_KEY => Some(LIX_COMMIT_EDGE_SCHEMA.get_or_init(|| {
+            parse_builtin_schema("lix_commit_edge.json", LIX_COMMIT_EDGE_SCHEMA_JSON)
+        })),
+        LIX_FILE_DESCRIPTOR_SCHEMA_KEY => Some(LIX_FILE_DESCRIPTOR_SCHEMA.get_or_init(|| {
+            parse_builtin_schema("lix_file_descriptor.json", LIX_FILE_DESCRIPTOR_SCHEMA_JSON)
+        })),
+        LIX_DIRECTORY_DESCRIPTOR_SCHEMA_KEY => {
+            Some(LIX_DIRECTORY_DESCRIPTOR_SCHEMA.get_or_init(|| {
+                parse_builtin_schema(
+                    "lix_directory_descriptor.json",
+                    LIX_DIRECTORY_DESCRIPTOR_SCHEMA_JSON,
+                )
+            }))
+        }
+        LIX_BINARY_BLOB_REF_SCHEMA_KEY => Some(LIX_BINARY_BLOB_REF_SCHEMA.get_or_init(|| {
+            parse_builtin_schema("lix_binary_blob_ref.json", LIX_BINARY_BLOB_REF_SCHEMA_JSON)
+        })),
+        _ => None,
+    }
+}
+
+#[allow(dead_code)]
+pub(crate) fn builtin_schema_json(schema_key: &str) -> Option<&'static str> {
+    match schema_key {
+        LIX_REGISTERED_SCHEMA_KEY => Some(LIX_REGISTERED_SCHEMA_JSON),
+        LIX_KEY_VALUE_SCHEMA_KEY => Some(LIX_KEY_VALUE_SCHEMA_JSON),
+        LIX_ACCOUNT_SCHEMA_KEY => Some(LIX_ACCOUNT_SCHEMA_JSON),
+        LIX_ACTIVE_ACCOUNT_SCHEMA_KEY => Some(LIX_ACTIVE_ACCOUNT_SCHEMA_JSON),
+        LIX_LABEL_SCHEMA_KEY => Some(LIX_LABEL_SCHEMA_JSON),
+        LIX_ENTITY_LABEL_SCHEMA_KEY => Some(LIX_ENTITY_LABEL_SCHEMA_JSON),
+        LIX_CHANGE_SCHEMA_KEY => Some(LIX_CHANGE_SCHEMA_JSON),
+        LIX_CHANGE_AUTHOR_SCHEMA_KEY => Some(LIX_CHANGE_AUTHOR_SCHEMA_JSON),
+        LIX_CHANGE_SET_SCHEMA_KEY => Some(LIX_CHANGE_SET_SCHEMA_JSON),
+        LIX_COMMIT_SCHEMA_KEY => Some(LIX_COMMIT_SCHEMA_JSON),
+        LIX_VERSION_DESCRIPTOR_SCHEMA_KEY => Some(LIX_VERSION_DESCRIPTOR_SCHEMA_JSON),
+        LIX_VERSION_REF_SCHEMA_KEY => Some(LIX_VERSION_REF_SCHEMA_JSON),
+        LIX_CHANGE_SET_ELEMENT_SCHEMA_KEY => Some(LIX_CHANGE_SET_ELEMENT_SCHEMA_JSON),
+        LIX_COMMIT_EDGE_SCHEMA_KEY => Some(LIX_COMMIT_EDGE_SCHEMA_JSON),
+        LIX_FILE_DESCRIPTOR_SCHEMA_KEY => Some(LIX_FILE_DESCRIPTOR_SCHEMA_JSON),
+        LIX_DIRECTORY_DESCRIPTOR_SCHEMA_KEY => Some(LIX_DIRECTORY_DESCRIPTOR_SCHEMA_JSON),
+        LIX_BINARY_BLOB_REF_SCHEMA_KEY => Some(LIX_BINARY_BLOB_REF_SCHEMA_JSON),
+        _ => None,
+    }
+}
+
+fn parse_builtin_schema(file_name: &str, raw_json: &str) -> JsonValue {
+    serde_json::from_str(raw_json).unwrap_or_else(|error| {
+        panic!("builtin schema file '{file_name}' must contain valid JSON: {error}")
+    })
+}
+
+fn parse_registered_schema_with_inlined_definition() -> JsonValue {
+    let mut schema = parse_builtin_schema("lix_registered_schema.json", LIX_REGISTERED_SCHEMA_JSON);
+    let value_schema = schema
+        .pointer_mut("/properties/value")
+        .expect("lix_registered_schema.json must define /properties/value");
+    let value_schema_object = value_schema
+        .as_object_mut()
+        .expect("lix_registered_schema.json /properties/value must be an object");
+
+    value_schema_object.insert(
+        "allOf".to_string(),
+        JsonValue::Array(vec![lix_schema_definition().clone()]),
+    );
+
+    schema
+}
+
+#[cfg(test)]
+mod tests {
+    use super::{seed_schema_definition, BUILTIN_SCHEMA_KEYS};
+
+    #[test]
+    fn builtin_schemas_load_without_extra_override_metadata() {
+        for schema_key in BUILTIN_SCHEMA_KEYS {
+            seed_schema_definition(schema_key).expect("schema should exist");
+        }
+    }
+
+    #[test]
+    fn registered_schema_value_inlines_lix_schema_definition() {
+        let schema = seed_schema_definition("lix_registered_schema").expect("schema should exist");
+        let all_of = schema
+            .pointer("/properties/value/allOf")
+            .and_then(|value| value.as_array())
+            .expect("registered schema value must define allOf array");
+        assert_eq!(all_of.len(), 1);
+        assert_eq!(all_of[0], *crate::schema::lix_schema_definition());
+    }
+}