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

package/dist-engine-src/src/schema_registry.rs

@@ -1,294 +0,0 @@
-use std::collections::BTreeMap;
-
-use serde_json::Value as JsonValue;
-
-use crate::live_state::LiveStateRow;
-use crate::live_state::{LiveStateFilter, LiveStateReader, LiveStateScanRequest};
-use crate::schema::schema_key_from_definition;
-use crate::{LixError, NullableKeyFilter, GLOBAL_VERSION_ID};
-
-const REGISTERED_SCHEMA_KEY: &str = "lix_registered_schema";
-
-/// Engine2 schema visibility boundary.
-///
-/// SQL planning receives a schema snapshot from live state. System schemas are
-/// seeded as ordinary `lix_registered_schema` rows during initialization, so
-/// runtime schema visibility has one source of truth.
-pub(crate) struct SchemaRegistry;
-
-impl SchemaRegistry {
-    pub(crate) fn new() -> Self {
-        Self
-    }
-
-    /// Loads schema definitions visible for SQL planning at `version_id`.
-    pub(crate) async fn visible_schemas<R>(
-        &self,
-        live_state: &R,
-        version_id: &str,
-    ) -> Result<Vec<JsonValue>, LixError>
-    where
-        R: LiveStateReader + ?Sized,
-    {
-        let mut schemas = BTreeMap::new();
-        for row in live_state
-            .scan_rows(&LiveStateScanRequest {
-                filter: LiveStateFilter {
-                    schema_keys: vec![REGISTERED_SCHEMA_KEY.to_string()],
-                    version_ids: vec![version_id.to_string()],
-                    file_ids: vec![NullableKeyFilter::Null],
-                    include_tombstones: false,
-                    ..LiveStateFilter::default()
-                },
-                ..LiveStateScanRequest::default()
-            })
-            .await?
-            .into_iter()
-            .filter(|row| version_scoped_schema_row_is_visible(row, version_id))
-        {
-            let Some((key, schema)) = decode_registered_schema_row(&row)? else {
-                continue;
-            };
-            upsert_latest_schema(&mut schemas, key, schema);
-        }
-        Ok(schemas.into_values().map(|(_, schema)| schema).collect())
-    }
-}
-
-fn version_scoped_schema_row_is_visible(row: &LiveStateRow, requested_version_id: &str) -> bool {
-    requested_version_id == GLOBAL_VERSION_ID || !row.global
-}
-
-fn upsert_latest_schema(
-    schemas: &mut BTreeMap<String, (crate::schema::SchemaKey, JsonValue)>,
-    key: crate::schema::SchemaKey,
-    schema: JsonValue,
-) {
-    let should_replace = schemas
-        .get(&key.schema_key)
-        .is_none_or(|(existing, _)| !schema_key_is_older(&key, existing));
-    if should_replace {
-        schemas.insert(key.schema_key.clone(), (key, schema));
-    }
-}
-
-fn schema_key_is_older(
-    candidate: &crate::schema::SchemaKey,
-    existing: &crate::schema::SchemaKey,
-) -> bool {
-    match (candidate.version_number(), existing.version_number()) {
-        (Some(candidate_version), Some(existing_version)) => candidate_version < existing_version,
-        _ => candidate.schema_version < existing.schema_version,
-    }
-}
-
-fn decode_registered_schema_row(
-    row: &LiveStateRow,
-) -> Result<Option<(crate::schema::SchemaKey, JsonValue)>, LixError> {
-    if row.schema_key != REGISTERED_SCHEMA_KEY {
-        return Err(LixError::new(
-            "LIX_ERROR_UNKNOWN",
-            format!(
-                "expected lix_registered_schema row, got schema_key={}",
-                row.schema_key
-            ),
-        ));
-    }
-
-    let Some(snapshot_content) = row.snapshot_content.as_deref() else {
-        return Ok(None);
-    };
-
-    let snapshot: JsonValue = serde_json::from_str(snapshot_content).map_err(|err| {
-        LixError::new(
-            "LIX_ERROR_UNKNOWN",
-            format!("invalid registered schema snapshot JSON: {err}"),
-        )
-    })?;
-    let schema = snapshot.get("value").cloned().ok_or_else(|| {
-        LixError::new(
-            "LIX_ERROR_UNKNOWN",
-            "registered schema snapshot missing value",
-        )
-    })?;
-    let key = schema_key_from_definition(&schema)?;
-    Ok(Some((key, schema)))
-}
-
-#[cfg(test)]
-mod tests {
-    use async_trait::async_trait;
-    use serde_json::json;
-
-    use super::*;
-    use crate::live_state::LiveStateRowRequest;
-    use crate::GLOBAL_VERSION_ID;
-
-    #[tokio::test]
-    async fn visible_schemas_are_loaded_from_registered_schema_rows() {
-        let registry = SchemaRegistry::new();
-
-        let schemas = registry
-            .visible_schemas(
-                &RowsLiveStateReader::new(vec![
-                    registered_schema_row("lix_registered_schema", "1"),
-                    registered_schema_row("lix_key_value", "1"),
-                ]),
-                "global",
-            )
-            .await
-            .expect("schema visibility should load");
-
-        assert!(schemas.iter().any(|schema| {
-            schema.get("x-lix-key").and_then(JsonValue::as_str) == Some("lix_registered_schema")
-        }));
-        assert!(schemas.iter().any(|schema| {
-            schema.get("x-lix-key").and_then(JsonValue::as_str) == Some("lix_key_value")
-        }));
-    }
-
-    #[tokio::test]
-    async fn visible_schemas_include_registered_schema_rows() {
-        let registry = SchemaRegistry::new();
-
-        let schemas = registry
-            .visible_schemas(
-                &RowsLiveStateReader::new(vec![registered_schema_row(
-                    "engine2_dynamic_schema",
-                    "1",
-                )]),
-                "global",
-            )
-            .await
-            .expect("schema visibility should load");
-
-        assert!(schemas.iter().any(|schema| {
-            schema.get("x-lix-key").and_then(JsonValue::as_str) == Some("engine2_dynamic_schema")
-        }));
-    }
-
-    #[tokio::test]
-    async fn visible_schemas_ignore_projected_global_schema_rows_for_version_scope() {
-        let registry = SchemaRegistry::new();
-        let mut global_only = registered_schema_row("global_only_schema", "1");
-        global_only.global = true;
-        global_only.version_id = "main".to_string();
-
-        let schemas = registry
-            .visible_schemas(&RowsLiveStateReader::new(vec![global_only]), "main")
-            .await
-            .expect("schema visibility should load");
-
-        assert!(schemas.is_empty());
-    }
-
-    #[tokio::test]
-    async fn visible_schemas_are_empty_when_no_schema_rows_are_visible() {
-        let registry = SchemaRegistry::new();
-
-        let schemas = registry
-            .visible_schemas(&RowsLiveStateReader::new(Vec::new()), "global")
-            .await
-            .expect("schema visibility should load");
-
-        assert!(schemas.is_empty());
-    }
-
-    struct RowsLiveStateReader {
-        rows: Vec<LiveStateRow>,
-    }
-
-    impl RowsLiveStateReader {
-        fn new(rows: Vec<LiveStateRow>) -> Self {
-            Self { rows }
-        }
-    }
-
-    #[async_trait]
-    impl LiveStateReader for RowsLiveStateReader {
-        async fn scan_rows(
-            &self,
-            request: &LiveStateScanRequest,
-        ) -> Result<Vec<LiveStateRow>, LixError> {
-            Ok(self
-                .rows
-                .iter()
-                .filter(|row| {
-                    request.filter.schema_keys.is_empty()
-                        || request.filter.schema_keys.contains(&row.schema_key)
-                })
-                .filter(|row| {
-                    request.filter.version_ids.is_empty()
-                        || request.filter.version_ids.contains(&row.version_id)
-                })
-                .cloned()
-                .collect())
-        }
-
-        async fn load_row(
-            &self,
-            request: &LiveStateRowRequest,
-        ) -> Result<Option<LiveStateRow>, LixError> {
-            Ok(self
-                .rows
-                .iter()
-                .find(|row| {
-                    row.schema_key == request.schema_key
-                        && row.version_id == request.version_id
-                        && row.entity_id == request.entity_id
-                })
-                .cloned())
-        }
-    }
-
-    fn registered_schema_row(schema_key: &str, schema_version: &str) -> LiveStateRow {
-        LiveStateRow {
-            entity_id: registered_schema_entity_id(schema_key, schema_version),
-            file_id: None,
-            schema_key: REGISTERED_SCHEMA_KEY.to_string(),
-            schema_version: "1".to_string(),
-            version_id: GLOBAL_VERSION_ID.to_string(),
-            metadata: None,
-            change_id: Some("change-registered-schema".to_string()),
-            commit_id: None,
-            global: true,
-            untracked: true,
-            created_at: "2026-04-23T00:00:00Z".to_string(),
-            updated_at: "2026-04-23T01:00:00Z".to_string(),
-            snapshot_content: Some(
-                json!({
-                    "value": {
-                        "x-lix-key": schema_key,
-                        "x-lix-version": schema_version,
-                        "type": "object",
-                        "properties": {
-                            "id": { "type": "string" }
-                        },
-                        "required": ["id"],
-                        "additionalProperties": false
-                    }
-                })
-                .to_string(),
-            ),
-        }
-    }
-
-    fn registered_schema_entity_id(
-        schema_key: &str,
-        schema_version: &str,
-    ) -> crate::entity_identity::EntityIdentity {
-        crate::entity_identity::EntityIdentity::from_primary_key_paths(
-            &json!({
-                "value": {
-                    "x-lix-key": schema_key,
-                    "x-lix-version": schema_version,
-                }
-            }),
-            &[
-                vec!["value".to_string(), "x-lix-key".to_string()],
-                vec!["value".to_string(), "x-lix-version".to_string()],
-            ],
-        )
-        .expect("registered schema identity should derive")
-    }
-}