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

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

@@ -1,21 +0,0 @@
-mod context;
-mod overlay;
-mod reader;
-mod types;
-pub(crate) mod visibility;
-
-#[allow(unused_imports)]
-pub(crate) use context::{LiveStateContext, LiveStateStoreReader};
-#[allow(unused_imports)]
-pub(crate) use reader::LiveStateReader;
-#[allow(unused_imports)]
-pub(crate) use types::{
-    Bound, LiveStateFilter, LiveStateProjection, LiveStateRowFilter, LiveStateRowIdentity,
-    LiveStateRowRequest, LiveStateScanRequest, MaterializedLiveStateRow, ScanConstraint, ScanField,
-    ScanOperator,
-};
-#[allow(unused_imports)]
-pub(crate) use visibility::{
-    expanded_branch_ids, overlay_scan_rows, resolve_visible_rows, StagedLiveStateRows,
-    VisibilityBranchScope, VisibilityRequest,
-};

package/dist-engine-src/src/live_state/overlay.rs

@@ -1,75 +0,0 @@
-use std::collections::BTreeMap;
-
-use crate::live_state::{LiveStateRowIdentity, MaterializedLiveStateRow};
-
-/// Applies the local untracked overlay to tracked live-state rows.
-///
-/// The visible live-state contract is "latest local untracked row wins" for
-/// the same branch/schema/entity/file identity. This keeps SQL providers from
-/// knowing whether a visible row came from tracked changelog projection or from
-/// local untracked state.
-pub(crate) fn overlay_untracked_rows(
-    tracked_rows: Vec<MaterializedLiveStateRow>,
-    untracked_rows: Vec<MaterializedLiveStateRow>,
-) -> Vec<MaterializedLiveStateRow> {
-    let mut rows_by_identity = BTreeMap::new();
-
-    for row in tracked_rows {
-        rows_by_identity.insert(LiveStateRowIdentity::from_row(&row), row);
-    }
-    for row in untracked_rows {
-        rows_by_identity.insert(LiveStateRowIdentity::from_row(&row), row);
-    }
-
-    rows_by_identity.into_values().collect()
-}
-
-#[cfg(test)]
-mod tests {
-    use super::*;
-
-    #[test]
-    fn untracked_row_wins_for_same_identity() {
-        let tracked = live_row("tracked", false, Some("change-tracked"));
-        let untracked = live_row("untracked", true, None);
-
-        let rows = overlay_untracked_rows(vec![tracked], vec![untracked]);
-
-        assert_eq!(rows.len(), 1);
-        assert_eq!(
-            rows[0].snapshot_content.as_deref(),
-            Some("{\"value\":\"untracked\"}")
-        );
-        assert!(rows[0].untracked);
-        assert_eq!(rows[0].change_id, None);
-    }
-
-    #[test]
-    fn different_identities_are_preserved() {
-        let tracked = live_row("tracked", false, Some("change-tracked"));
-        let mut untracked = live_row("untracked", true, None);
-        untracked.entity_pk = crate::entity_pk::EntityPk::single("other");
-
-        let rows = overlay_untracked_rows(vec![tracked], vec![untracked]);
-
-        assert_eq!(rows.len(), 2);
-    }
-
-    fn live_row(value: &str, untracked: bool, change_id: Option<&str>) -> MaterializedLiveStateRow {
-        MaterializedLiveStateRow {
-            entity_pk: crate::entity_pk::EntityPk::single("entity"),
-            schema_key: "schema".to_string(),
-            file_id: None,
-            snapshot_content: Some(format!("{{\"value\":\"{value}\"}}")),
-            metadata: None,
-            deleted: false,
-            created_at: "2026-01-01T00:00:00Z".to_string(),
-            updated_at: "2026-01-01T00:00:00Z".to_string(),
-            global: true,
-            change_id: change_id.map(str::to_string),
-            commit_id: None,
-            untracked,
-            branch_id: "global".to_string(),
-        }
-    }
-}

package/dist-engine-src/src/live_state/reader.rs

@@ -1,23 +0,0 @@
-use async_trait::async_trait;
-
-use crate::live_state::MaterializedLiveStateRow;
-use crate::live_state::{LiveStateRowRequest, LiveStateScanRequest};
-use crate::LixError;
-
-/// Minimal engine read model for transaction planning and SQL providers.
-///
-/// Engine only needs visible state-row reads here. Changelog freshness/catch-up
-/// should be added at this boundary later instead of leaking projection internals
-/// into sessions or SQL providers.
-#[async_trait]
-pub(crate) trait LiveStateReader: Send + Sync {
-    async fn scan_rows(
-        &self,
-        request: &LiveStateScanRequest,
-    ) -> Result<Vec<MaterializedLiveStateRow>, LixError>;
-
-    async fn load_row(
-        &self,
-        request: &LiveStateRowRequest,
-    ) -> Result<Option<MaterializedLiveStateRow>, LixError>;
-}

package/dist-engine-src/src/live_state/types.rs

@@ -1,231 +0,0 @@
-use crate::entity_pk::EntityPk;
-use crate::tracked_state::MaterializedTrackedStateRow;
-use crate::untracked_state::{
-    MaterializedUntrackedStateRow, UntrackedStateFilter, UntrackedStateRowRequest,
-};
-use crate::{NullableKeyFilter, Value};
-
-/// Durable row visible through live_state reads.
-///
-/// Unlike provider write rows, live-state rows are fully hydrated facts. Missing
-/// generated fields should be caught before this type is constructed.
-#[derive(Debug, Clone, PartialEq, Eq, serde::Serialize, serde::Deserialize)]
-pub(crate) struct MaterializedLiveStateRow {
-    pub(crate) entity_pk: EntityPk,
-    pub(crate) schema_key: String,
-    pub(crate) file_id: Option<String>,
-    pub(crate) snapshot_content: Option<String>,
-    pub(crate) metadata: Option<String>,
-    pub(crate) deleted: bool,
-    pub(crate) created_at: String,
-    pub(crate) updated_at: String,
-    pub(crate) global: bool,
-    pub(crate) change_id: Option<String>,
-    pub(crate) commit_id: Option<String>,
-    pub(crate) untracked: bool,
-    pub(crate) branch_id: String,
-}
-
-impl From<MaterializedUntrackedStateRow> for MaterializedLiveStateRow {
-    fn from(row: MaterializedUntrackedStateRow) -> Self {
-        MaterializedLiveStateRow {
-            entity_pk: row.entity_pk,
-            schema_key: row.schema_key,
-            file_id: row.file_id,
-            snapshot_content: row.snapshot_content,
-            metadata: row.metadata,
-            deleted: row.deleted,
-            created_at: row.created_at,
-            updated_at: row.updated_at,
-            global: row.global,
-            change_id: None,
-            commit_id: None,
-            untracked: true,
-            branch_id: row.branch_id,
-        }
-    }
-}
-
-impl TryFrom<&MaterializedLiveStateRow> for MaterializedTrackedStateRow {
-    type Error = crate::LixError;
-
-    fn try_from(row: &MaterializedLiveStateRow) -> Result<Self, Self::Error> {
-        if row.untracked {
-            return Err(crate::LixError::new(
-                "LIX_ERROR_UNKNOWN",
-                "tracked_state cannot store untracked live-state rows",
-            ));
-        }
-        let Some(change_id) = row.change_id.clone() else {
-            return Err(crate::LixError::new(
-                "LIX_ERROR_UNKNOWN",
-                "tracked_state rows require change_id",
-            ));
-        };
-        let Some(commit_id) = row.commit_id.clone() else {
-            return Err(crate::LixError::new(
-                "LIX_ERROR_UNKNOWN",
-                "tracked_state rows require commit_id",
-            ));
-        };
-
-        Ok(MaterializedTrackedStateRow {
-            entity_pk: row.entity_pk.clone(),
-            schema_key: row.schema_key.clone(),
-            file_id: row.file_id.clone(),
-            snapshot_content: row.snapshot_content.clone(),
-            metadata: row.metadata.clone(),
-            deleted: row.deleted,
-            created_at: row.created_at.clone(),
-            updated_at: row.updated_at.clone(),
-            change_id,
-            commit_id,
-        })
-    }
-}
-
-impl From<&MaterializedLiveStateRow> for MaterializedUntrackedStateRow {
-    fn from(row: &MaterializedLiveStateRow) -> Self {
-        MaterializedUntrackedStateRow {
-            entity_pk: row.entity_pk.clone(),
-            schema_key: row.schema_key.clone(),
-            file_id: row.file_id.clone(),
-            snapshot_content: row.snapshot_content.clone(),
-            metadata: row.metadata.clone(),
-            deleted: row.deleted,
-            created_at: row.created_at.clone(),
-            updated_at: row.updated_at.clone(),
-            global: row.global,
-            branch_id: row.branch_id.clone(),
-        }
-    }
-}
-
-/// Which indexed field a live-state scan constraint applies to.
-#[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)]
-pub(crate) enum ScanField {
-    EntityPk,
-    FileId,
-}
-
-/// Inclusive or exclusive range bound.
-#[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)]
-pub(crate) struct Bound {
-    pub(crate) value: Value,
-    pub(crate) inclusive: bool,
-}
-
-/// SQL-free structured scan constraint.
-#[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)]
-pub(crate) struct ScanConstraint {
-    pub(crate) field: ScanField,
-    pub(crate) operator: ScanOperator,
-}
-
-/// Structured scan operator aligned with the current planner/storage split.
-#[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize)]
-pub(crate) enum ScanOperator {
-    Eq(Value),
-    In(Vec<Value>),
-    Range {
-        lower: Option<Bound>,
-        upper: Option<Bound>,
-    },
-}
-
-/// Identity-centered filter for visible live entities.
-#[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize, Default)]
-pub(crate) struct LiveStateFilter {
-    #[serde(default)]
-    pub(crate) rows: LiveStateRowFilter,
-    #[serde(default)]
-    pub(crate) schema_keys: Vec<String>,
-    #[serde(default)]
-    pub(crate) entity_pks: Vec<EntityPk>,
-    #[serde(default)]
-    pub(crate) branch_ids: Vec<String>,
-    #[serde(default)]
-    pub(crate) file_ids: Vec<NullableKeyFilter<String>>,
-    #[serde(default)]
-    pub(crate) untracked: Option<bool>,
-    #[serde(default)]
-    pub(crate) constraints: Vec<ScanConstraint>,
-    #[serde(default)]
-    pub(crate) include_tombstones: bool,
-}
-
-#[derive(Debug, Clone, PartialEq, Eq, serde::Serialize, serde::Deserialize, Default)]
-pub(crate) enum LiveStateRowFilter {
-    #[default]
-    All,
-    None,
-}
-
-impl From<LiveStateFilter> for UntrackedStateFilter {
-    fn from(filter: LiveStateFilter) -> Self {
-        Self {
-            schema_keys: filter.schema_keys,
-            entity_pks: filter.entity_pks,
-            branch_ids: filter.branch_ids,
-            file_ids: filter.file_ids,
-        }
-    }
-}
-
-/// Requested property set for a live-state scan.
-#[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize, Default)]
-pub(crate) struct LiveStateProjection {
-    #[serde(default)]
-    pub(crate) columns: Vec<String>,
-}
-
-/// First-principles scan request for engine-owned reads.
-#[derive(Debug, Clone, PartialEq, serde::Serialize, serde::Deserialize, Default)]
-pub(crate) struct LiveStateScanRequest {
-    #[serde(default)]
-    pub(crate) filter: LiveStateFilter,
-    #[serde(default)]
-    pub(crate) projection: LiveStateProjection,
-    #[serde(default)]
-    pub(crate) limit: Option<usize>,
-}
-
-/// Point lookup request for one visible live-state row.
-#[derive(Debug, Clone, PartialEq)]
-pub(crate) struct LiveStateRowRequest {
-    pub(crate) schema_key: String,
-    pub(crate) branch_id: String,
-    pub(crate) entity_pk: EntityPk,
-    pub(crate) file_id: NullableKeyFilter<String>,
-}
-
-impl From<&LiveStateRowRequest> for UntrackedStateRowRequest {
-    fn from(request: &LiveStateRowRequest) -> Self {
-        Self {
-            schema_key: request.schema_key.clone(),
-            branch_id: request.branch_id.clone(),
-            entity_pk: request.entity_pk.clone(),
-            file_id: request.file_id.clone(),
-        }
-    }
-}
-
-/// Stable visible-row identity used for overlay composition.
-#[derive(Debug, Clone, PartialEq, Eq, PartialOrd, Ord)]
-pub(crate) struct LiveStateRowIdentity {
-    pub(crate) branch_id: String,
-    pub(crate) schema_key: String,
-    pub(crate) entity_pk: EntityPk,
-    pub(crate) file_id: Option<String>,
-}
-
-impl LiveStateRowIdentity {
-    pub(crate) fn from_row(row: &MaterializedLiveStateRow) -> Self {
-        Self {
-            branch_id: row.branch_id.clone(),
-            schema_key: row.schema_key.clone(),
-            entity_pk: row.entity_pk.clone(),
-            file_id: row.file_id.clone(),
-        }
-    }
-}