@lix-js/sdk 0.6.0-preview.5 → 0.6.0

package/dist-engine-src/src/plugin/mod.rs

@@ -1,33 +0,0 @@
-//! Plugin subsystem root.
-//!
-//! Phase 1 establishes `crate::plugin::*` as the owner path for plugin-domain
-//! code under concrete plugin-owned modules instead of legacy ownership-neutral
-//! buckets.
-
-mod archive;
-pub(crate) mod component;
-mod manifest;
-mod materializer;
-mod storage;
-
-pub(crate) use archive::{
-    load_installed_plugin_from_archive_bytes, parse_plugin_archive_for_install, ParsedPluginArchive,
-};
-#[allow(unused_imports)]
-pub(crate) use manifest::{
-    glob_matches_path, parse_plugin_manifest_json, select_best_glob_match, DetectChangesConfig,
-    DetectStateContextConfig, PluginContentType, PluginManifest, PluginMatch, PluginRuntime,
-    StateContextColumn, ValidatedPluginManifest,
-};
-#[allow(unused_imports)]
-pub(crate) use materializer::{
-    installed_plugin_manifest_key_exists, invalidate_installed_plugins_cache,
-    list_installed_plugin_manifest_keys, load_installed_plugins_from_backend_state,
-    load_installed_plugins_with_runtime_cache, FilesystemPluginMaterializer, InstalledPlugin,
-    PluginMaterializationHost,
-};
-#[allow(unused_imports)]
-pub(crate) use storage::{
-    plugin_key_from_archive_path, plugin_storage_archive_file_id, plugin_storage_archive_path,
-    PLUGIN_ARCHIVE_FILE_EXTENSION, PLUGIN_STORAGE_ROOT_DIRECTORY_PATH,
-};

package/dist-engine-src/src/plugin/plugin_manifest.json

@@ -1,119 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "type": "object",
-  "additionalProperties": false,
-  "required": [
-    "key",
-    "runtime",
-    "api_version",
-    "match",
-    "entry",
-    "schemas"
-  ],
-  "properties": {
-    "key": {
-      "type": "string",
-      "minLength": 1,
-      "maxLength": 128,
-      "pattern": "^[a-z][a-z0-9_-]*$"
-    },
-    "runtime": {
-      "type": "string",
-      "enum": [
-        "wasm-component-v1"
-      ]
-    },
-    "api_version": {
-      "type": "string",
-      "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$"
-    },
-    "match": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["path_glob"],
-      "properties": {
-        "path_glob": {
-          "type": "string",
-          "minLength": 1
-        },
-        "content_type": {
-          "type": "string",
-          "enum": ["text", "binary"]
-        }
-      }
-    },
-    "detect_changes": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "state_context": {
-          "type": "object",
-          "additionalProperties": false,
-          "properties": {
-            "include_active_state": {
-              "type": "boolean"
-            },
-            "columns": {
-              "type": "array",
-              "minItems": 1,
-              "uniqueItems": true,
-              "items": {
-                "type": "string",
-                "enum": [
-                  "entity_pk",
-                  "schema_key",
-                  "schema_version",
-                  "snapshot_content",
-                  "file_id",
-                  "plugin_key",
-                  "branch_id",
-                  "change_id",
-                  "metadata",
-                  "created_at",
-                  "updated_at"
-                ]
-              },
-              "contains": {
-                "const": "entity_pk"
-              }
-            }
-          },
-          "allOf": [
-            {
-              "if": {
-                "properties": {
-                  "include_active_state": {
-                    "const": true
-                  }
-                },
-                "required": [
-                  "include_active_state"
-                ]
-              },
-              "then": {},
-              "else": {
-                "not": {
-                  "required": [
-                    "columns"
-                  ]
-                }
-              }
-            }
-          ]
-        }
-      }
-    },
-    "entry": {
-      "type": "string",
-      "minLength": 1
-    },
-    "schemas": {
-      "type": "array",
-      "minItems": 1,
-      "items": {
-        "type": "string",
-        "minLength": 1
-      }
-    }
-  }
-}

package/dist-engine-src/src/plugin/storage.rs

@@ -1,74 +0,0 @@
-use crate::LixError;
-
-pub const PLUGIN_STORAGE_ROOT_DIRECTORY_PATH: &str = "/.lix/plugins/";
-pub const PLUGIN_ARCHIVE_FILE_EXTENSION: &str = ".lixplugin";
-
-pub fn plugin_storage_archive_file_id(plugin_key: &str) -> String {
-    format!("lix_plugin_archive::{plugin_key}")
-}
-
-pub fn plugin_storage_archive_path(plugin_key: &str) -> Result<String, LixError> {
-    validate_plugin_key_segment(plugin_key)?;
-    Ok(format!(
-        "{PLUGIN_STORAGE_ROOT_DIRECTORY_PATH}{plugin_key}{PLUGIN_ARCHIVE_FILE_EXTENSION}"
-    ))
-}
-
-pub fn plugin_key_from_archive_path(path: &str) -> Option<String> {
-    let file_name = path.strip_prefix(PLUGIN_STORAGE_ROOT_DIRECTORY_PATH)?;
-    let plugin_key = file_name.strip_suffix(PLUGIN_ARCHIVE_FILE_EXTENSION)?;
-    if plugin_key.is_empty()
-        || plugin_key == "."
-        || plugin_key == ".."
-        || plugin_key.contains('/')
-        || plugin_key.contains('\\')
-    {
-        return None;
-    }
-    Some(plugin_key.to_string())
-}
-
-fn validate_plugin_key_segment(plugin_key: &str) -> Result<(), LixError> {
-    if plugin_key.is_empty()
-        || plugin_key == "."
-        || plugin_key == ".."
-        || plugin_key.contains('/')
-        || plugin_key.contains('\\')
-    {
-        return Err(LixError {
-            code: "LIX_ERROR_UNKNOWN".to_string(),
-            message: format!(
-                "plugin key '{}' must be a single relative path segment",
-                plugin_key
-            ),
-            hint: None,
-            details: None,
-        });
-    }
-    Ok(())
-}
-
-#[cfg(test)]
-mod tests {
-    use super::{plugin_key_from_archive_path, plugin_storage_archive_path};
-
-    #[test]
-    fn computes_storage_archive_paths() {
-        assert_eq!(
-            plugin_storage_archive_path("plugin_json").expect("path should build"),
-            "/.lix/plugins/plugin_json.lixplugin"
-        );
-    }
-
-    #[test]
-    fn extracts_plugin_key_from_storage_path() {
-        assert_eq!(
-            plugin_key_from_archive_path("/.lix/plugins/plugin_json.lixplugin"),
-            Some("plugin_json".to_string())
-        );
-        assert_eq!(
-            plugin_key_from_archive_path("/.lix/plugins/nested/plugin.lixplugin"),
-            None
-        );
-    }
-}

package/dist-engine-src/src/schema/annotations/defaults.rs

@@ -1,275 +0,0 @@
-use serde_json::{Map as JsonMap, Value as JsonValue};
-
-use crate::cel::{CelEvaluator, CelFunctionProvider};
-use crate::LixError;
-
-pub(crate) fn apply_schema_defaults<P>(
-    snapshot: &mut JsonMap<String, JsonValue>,
-    schema: &JsonValue,
-    evaluator: &CelEvaluator,
-    functions: P,
-    schema_key: &str,
-) -> Result<bool, LixError>
-where
-    P: CelFunctionProvider,
-{
-    apply_schema_defaults_with_context(
-        snapshot,
-        schema,
-        &snapshot.clone(),
-        evaluator,
-        functions,
-        schema_key,
-    )
-}
-
-pub(crate) fn apply_schema_defaults_with_shared_runtime<P>(
-    snapshot: &mut JsonMap<String, JsonValue>,
-    schema: &JsonValue,
-    functions: P,
-    schema_key: &str,
-) -> Result<bool, LixError>
-where
-    P: CelFunctionProvider,
-{
-    apply_schema_defaults(
-        snapshot,
-        schema,
-        crate::cel::shared_runtime(),
-        functions,
-        schema_key,
-    )
-}
-
-pub(crate) fn apply_schema_defaults_with_context<P>(
-    snapshot: &mut JsonMap<String, JsonValue>,
-    schema: &JsonValue,
-    context: &JsonMap<String, JsonValue>,
-    evaluator: &CelEvaluator,
-    functions: P,
-    schema_key: &str,
-) -> Result<bool, LixError>
-where
-    P: CelFunctionProvider,
-{
-    let Some(properties) = schema.get("properties").and_then(|value| value.as_object()) else {
-        return Ok(false);
-    };
-    let mut ordered_properties: Vec<(&String, &JsonValue)> = properties.iter().collect();
-    ordered_properties.sort_by(|(left_name, _), (right_name, _)| left_name.cmp(right_name));
-
-    let mut changed = false;
-    for (field_name, field_schema) in ordered_properties {
-        if snapshot.contains_key(field_name) {
-            continue;
-        }
-
-        if let Some(expression) = field_schema
-            .get("x-lix-default")
-            .and_then(|value| value.as_str())
-        {
-            let value = evaluator
-                .evaluate_with_functions(expression, context, functions.clone())
-                .map_err(|err| LixError {
-                    code: "LIX_ERROR_UNKNOWN".to_string(),
-                    message: format!(
-                        "failed to evaluate x-lix-default for '{}.{}': {}",
-                        schema_key, field_name, err.message
-                    ),
-                    hint: None,
-                    details: None,
-                })?;
-            snapshot.insert(field_name.clone(), value);
-            changed = true;
-            continue;
-        }
-
-        if let Some(default_value) = field_schema.get("default") {
-            snapshot.insert(field_name.clone(), default_value.clone());
-            changed = true;
-        }
-    }
-
-    Ok(changed)
-}
-
-#[cfg(test)]
-mod tests {
-    use serde_json::{json, Map as JsonMap, Value as JsonValue};
-
-    use crate::cel::{CelEvaluator, CelFunctionProvider};
-
-    use super::apply_schema_defaults_with_context;
-
-    #[test]
-    fn applies_x_lix_default_for_missing_fields() {
-        let evaluator = CelEvaluator::new();
-        let schema = json!({
-            "properties": {
-                "slug": {
-                    "type": "string",
-                    "x-lix-default": "name + '-slug'"
-                }
-            }
-        });
-        let mut snapshot = JsonMap::new();
-        snapshot.insert("name".to_string(), JsonValue::String("sample".to_string()));
-        let context = snapshot.clone();
-
-        let changed = apply_schema_defaults_with_context(
-            &mut snapshot,
-            &schema,
-            &context,
-            &evaluator,
-            fixed_functions(),
-            "test_schema",
-            "1",
-        )
-        .expect("apply defaults");
-
-        assert!(changed);
-        assert_eq!(
-            snapshot.get("slug"),
-            Some(&JsonValue::String("sample-slug".to_string()))
-        );
-    }
-
-    #[test]
-    fn x_lix_default_overrides_json_default() {
-        let evaluator = CelEvaluator::new();
-        let schema = json!({
-            "properties": {
-                "status": {
-                    "type": "string",
-                    "default": "literal",
-                    "x-lix-default": "'computed'"
-                }
-            }
-        });
-        let mut snapshot = JsonMap::new();
-        let context = snapshot.clone();
-
-        let changed = apply_schema_defaults_with_context(
-            &mut snapshot,
-            &schema,
-            &context,
-            &evaluator,
-            fixed_functions(),
-            "test_schema",
-            "1",
-        )
-        .expect("apply defaults");
-
-        assert!(changed);
-        assert_eq!(
-            snapshot.get("status"),
-            Some(&JsonValue::String("computed".to_string()))
-        );
-    }
-
-    #[test]
-    fn does_not_default_explicit_null_values() {
-        let evaluator = CelEvaluator::new();
-        let schema = json!({
-            "properties": {
-                "status": {
-                    "type": "string",
-                    "x-lix-default": "'computed'"
-                }
-            }
-        });
-        let mut snapshot = JsonMap::new();
-        snapshot.insert("status".to_string(), JsonValue::Null);
-        let context = snapshot.clone();
-
-        let changed = apply_schema_defaults_with_context(
-            &mut snapshot,
-            &schema,
-            &context,
-            &evaluator,
-            fixed_functions(),
-            "test_schema",
-            "1",
-        )
-        .expect("apply defaults");
-
-        assert!(!changed);
-        assert_eq!(snapshot.get("status"), Some(&JsonValue::Null));
-    }
-
-    #[test]
-    fn applies_cel_defaults_in_stable_sorted_field_order() {
-        #[derive(Clone)]
-        struct CountingFunctions {
-            next: std::sync::Arc<std::sync::atomic::AtomicI64>,
-        }
-
-        impl CelFunctionProvider for CountingFunctions {
-            fn call_uuid_v7(&self) -> String {
-                let current = self.next.fetch_add(1, std::sync::atomic::Ordering::SeqCst);
-                format!("uuid-{current}")
-            }
-
-            fn call_timestamp(&self) -> String {
-                let current = self.next.fetch_add(1, std::sync::atomic::Ordering::SeqCst);
-                format!("ts-{current}")
-            }
-        }
-
-        let evaluator = CelEvaluator::new();
-        let schema = json!({
-            "properties": {
-                "z_uuid": {
-                    "type": "string",
-                    "x-lix-default": "lix_uuid_v7()"
-                },
-                "a_timestamp": {
-                    "type": "string",
-                    "x-lix-default": "lix_timestamp()"
-                }
-            }
-        });
-        let mut snapshot = JsonMap::new();
-        let context = snapshot.clone();
-
-        let changed = apply_schema_defaults_with_context(
-            &mut snapshot,
-            &schema,
-            &context,
-            &evaluator,
-            CountingFunctions {
-                next: std::sync::Arc::new(std::sync::atomic::AtomicI64::new(0)),
-            },
-            "test_schema",
-            "1",
-        )
-        .expect("apply defaults");
-
-        assert!(changed);
-        assert_eq!(
-            snapshot.get("a_timestamp"),
-            Some(&JsonValue::String("ts-0".to_string()))
-        );
-        assert_eq!(
-            snapshot.get("z_uuid"),
-            Some(&JsonValue::String("uuid-1".to_string()))
-        );
-    }
-
-    #[derive(Clone)]
-    struct FixedFunctions;
-
-    impl CelFunctionProvider for FixedFunctions {
-        fn call_uuid_v7(&self) -> String {
-            "uuid-fixed".to_string()
-        }
-
-        fn call_timestamp(&self) -> String {
-            "1970-01-01T00:00:00.000Z".to_string()
-        }
-    }
-
-    fn fixed_functions() -> FixedFunctions {
-        FixedFunctions
-    }
-}

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

@@ -1 +0,0 @@
-pub(crate) mod defaults;

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

@@ -1,21 +0,0 @@
-{
-  "x-lix-key": "lix_account",
-  "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_active_account.json

@@ -1,29 +0,0 @@
-{
-  "x-lix-key": "lix_active_account",
-  "x-lix-primary-key": [
-    "/account_id"
-  ],
-  "x-lix-foreign-keys": [
-    {
-      "properties": [
-        "/account_id"
-      ],
-      "references": {
-        "schemaKey": "lix_account",
-        "properties": [
-          "/id"
-        ]
-      }
-    }
-  ],
-  "type": "object",
-  "properties": {
-    "account_id": {
-      "type": "string"
-    }
-  },
-  "required": [
-    "account_id"
-  ],
-  "additionalProperties": false
-}

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

@@ -1,29 +0,0 @@
-{
-  "x-lix-key": "lix_binary_blob_ref",
-  "description": "Metadata pointer from a file row to its binary payload in internal CAS storage.",
-  "x-lix-primary-key": [
-    "/id"
-  ],
-  "type": "object",
-  "properties": {
-    "id": {
-      "type": "string",
-      "description": "File primary-key value (matches lix_file.id) for this binary reference row."
-    },
-    "blob_hash": {
-      "type": "string",
-      "description": "BLAKE3 content hash used as the canonical CAS key for the binary payload."
-    },
-    "size_bytes": {
-      "type": "integer",
-      "minimum": 0,
-      "description": "Logical uncompressed file size in bytes for the referenced binary payload."
-    }
-  },
-  "required": [
-    "id",
-    "blob_hash",
-    "size_bytes"
-  ],
-  "additionalProperties": false
-}

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

@@ -1,34 +0,0 @@
-{
-  "x-lix-key": "lix_branch_descriptor",
-  "description": "User-facing branch metadata (name and visibility). The stable identity of a branch; the matching `lix_branch_ref` carries the moving head pointer. The catalog's `lix_branch` surface joins this descriptor with its ref to present a single user-visible branch row.",
-  "x-lix-primary-key": [
-    "/id"
-  ],
-  "x-lix-unique": [
-    [
-      "/name"
-    ]
-  ],
-  "type": "object",
-  "properties": {
-    "id": {
-      "type": "string",
-      "x-lix-default": "lix_uuid_v7()",
-      "description": "Stable branch identifier (UUIDv7). Referenced by `lix_branch_ref.id`."
-    },
-    "name": {
-      "type": "string",
-      "description": "Human-readable branch name (e.g. `main`, `feature-x`) shown in branch listings and CLI output."
-    },
-    "hidden": {
-      "type": "boolean",
-      "default": false,
-      "description": "When true, the branch 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_branch_ref.json

@@ -1,48 +0,0 @@
-{
-  "x-lix-key": "lix_branch_ref",
-  "description": "Branch head pointer. Records which commit a branch 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_branch_descriptor.id` has exactly one `lix_branch_ref` row.",
-  "x-lix-primary-key": [
-    "/id"
-  ],
-  "x-lix-foreign-keys": [
-    {
-      "properties": [
-        "/id"
-      ],
-      "references": {
-        "schemaKey": "lix_branch_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": "Branch identifier whose head pointer is being stored; matches `lix_branch_descriptor.id`."
-    },
-    "commit_id": {
-      "type": "string",
-      "description": "Commit the branch should currently resolve to in the local runtime (references `lix_commit.id`)."
-    }
-  },
-  "required": [
-    "id",
-    "commit_id"
-  ],
-  "additionalProperties": false
-}