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

package/dist-engine-src/src/commit_store/materialization.rs

@@ -1,84 +0,0 @@
-use crate::commit_store::{LocatedChange, MaterializedChange};
-use crate::json_store::{JsonLoadRequestRef, JsonReadScopeRef, JsonRef, JsonStoreReader};
-use crate::storage::StorageReader;
-use crate::{parse_row_metadata, LixError};
-
-pub(crate) async fn materialize_change<S>(
-    json_reader: &mut JsonStoreReader<S>,
-    located: LocatedChange,
-) -> Result<MaterializedChange, LixError>
-where
-    S: StorageReader,
-{
-    let change = located.record;
-    let pack_ids = [located.source_pack_id];
-    let scope = JsonReadScopeRef::CommitPacks {
-        commit_id: &located.source_commit_id,
-        pack_ids: &pack_ids,
-    };
-    let snapshot_content = load_optional_json_text(
-        json_reader,
-        change.snapshot_ref.as_ref(),
-        scope,
-        "snapshot_ref",
-    )
-    .await?;
-    let metadata = match load_optional_json_text(
-        json_reader,
-        change.metadata_ref.as_ref(),
-        scope,
-        "metadata_ref",
-    )
-    .await?
-    {
-        Some(value) => Some(parse_row_metadata(
-            &value,
-            "commit_store change metadata_ref",
-        )?),
-        None => None,
-    };
-    Ok(MaterializedChange {
-        id: change.id,
-        entity_id: change.entity_id,
-        schema_key: change.schema_key,
-        file_id: change.file_id,
-        snapshot_content,
-        metadata,
-        created_at: change.created_at,
-    })
-}
-
-async fn load_optional_json_text<S>(
-    json_reader: &mut JsonStoreReader<S>,
-    json_ref: Option<&JsonRef>,
-    scope: JsonReadScopeRef<'_>,
-    field: &str,
-) -> Result<Option<String>, LixError>
-where
-    S: StorageReader,
-{
-    let Some(json_ref) = json_ref else {
-        return Ok(None);
-    };
-    let batch = json_reader
-        .load_bytes_many(JsonLoadRequestRef {
-            refs: std::slice::from_ref(json_ref),
-            scope,
-        })
-        .await?;
-    let Some(bytes) = batch.into_values().into_iter().next().flatten() else {
-        return Err(LixError::new(
-            LixError::CODE_INTERNAL_ERROR,
-            format!(
-                "commit_store change {field} '{}' is missing",
-                json_ref.to_hex()
-            ),
-        ));
-    };
-    String::from_utf8(bytes).map(Some).map_err(|error| {
-        LixError::new(
-            LixError::CODE_INTERNAL_ERROR,
-            format!("commit_store change {field} is not UTF-8 JSON: {error}"),
-        )
-    })
-}

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

@@ -1,16 +0,0 @@
-pub(crate) mod codec;
-mod context;
-mod materialization;
-pub(crate) mod storage;
-mod types;
-
-#[allow(unused_imports)]
-pub(crate) use context::{CommitStoreContext, CommitStoreReader, CommitStoreWriter};
-#[allow(unused_imports)]
-pub(crate) use materialization::materialize_change;
-#[allow(unused_imports)]
-pub(crate) use types::{
-    Change, ChangeIndexEntry, ChangeLocator, ChangeLocatorRef, ChangePack, ChangePackView,
-    ChangeRef, ChangeScanRequest, Commit, CommitDraftRef, LocatedChange, MaterializedChange,
-    MembershipPack, MembershipPackView, StagedCommitStoreCommit, StoredCommitRef,
-};

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

@@ -1,600 +0,0 @@
-use crate::commit_store::{
-    Change, ChangeIndexEntry, ChangeLocator, ChangeRef, Commit, CommitDraftRef,
-    StagedCommitStoreCommit, StoredCommitRef,
-};
-use crate::storage::{
-    KvGetGroup, KvGetRequest, KvScanRange, KvScanRequest, StorageReader, StorageWriteSet,
-};
-use crate::LixError;
-use std::collections::{BTreeMap, BTreeSet};
-
-pub(crate) const COMMIT_NAMESPACE: &str = "commit_store.commit";
-pub(crate) const CHANGE_PACK_NAMESPACE: &str = "commit_store.change_pack";
-pub(crate) const MEMBERSHIP_PACK_NAMESPACE: &str = "commit_store.membership_pack";
-
-const SINGLE_PACK_ID: u32 = 0;
-
-pub(crate) fn stage_commit(
-    writes: &mut StorageWriteSet,
-    commit: CommitDraftRef<'_>,
-    authored_changes: Vec<ChangeRef<'_>>,
-    adopted_changes: Vec<ChangeLocator>,
-) -> Result<StagedCommitStoreCommit, LixError> {
-    stage_commit_with_authored_pack(writes, commit, authored_changes, adopted_changes, true)
-}
-
-pub(crate) fn stage_commit_with_external_authored_pack(
-    writes: &mut StorageWriteSet,
-    commit: CommitDraftRef<'_>,
-    authored_changes: Vec<ChangeRef<'_>>,
-    adopted_changes: Vec<ChangeLocator>,
-) -> Result<StagedCommitStoreCommit, LixError> {
-    stage_commit_with_authored_pack(writes, commit, authored_changes, adopted_changes, false)
-}
-
-fn stage_commit_with_authored_pack(
-    writes: &mut StorageWriteSet,
-    commit: CommitDraftRef<'_>,
-    authored_changes: Vec<ChangeRef<'_>>,
-    adopted_changes: Vec<ChangeLocator>,
-    write_authored_change_pack: bool,
-) -> Result<StagedCommitStoreCommit, LixError> {
-    let stored_commit = StoredCommitRef {
-        id: commit.id,
-        change_id: commit.change_id,
-        parent_ids: commit.parent_ids,
-        author_account_ids: commit.author_account_ids,
-        created_at: commit.created_at,
-        change_pack_count: if authored_changes.is_empty() { 0 } else { 1 },
-        membership_pack_count: if adopted_changes.is_empty() { 0 } else { 1 },
-    };
-
-    writes.put(
-        COMMIT_NAMESPACE,
-        commit_key(commit.id),
-        crate::commit_store::codec::encode_commit_ref(stored_commit)?,
-    );
-
-    let mut authored_locators = Vec::with_capacity(authored_changes.len());
-    if !authored_changes.is_empty() {
-        if write_authored_change_pack {
-            writes.put(
-                CHANGE_PACK_NAMESPACE,
-                pack_key(commit.id, SINGLE_PACK_ID)?,
-                crate::commit_store::codec::encode_change_pack(
-                    commit.id,
-                    SINGLE_PACK_ID,
-                    &authored_changes,
-                )?,
-            );
-        }
-        for (source_ordinal, change) in authored_changes.iter().enumerate() {
-            authored_locators.push(ChangeLocator {
-                source_commit_id: commit.id.to_string(),
-                source_pack_id: SINGLE_PACK_ID,
-                source_ordinal: u32::try_from(source_ordinal).map_err(|_| {
-                    LixError::new(
-                        LixError::CODE_INTERNAL_ERROR,
-                        "commit-store change pack ordinal exceeds u32",
-                    )
-                })?,
-                change_id: change.id.to_string(),
-            });
-        }
-    }
-
-    if !adopted_changes.is_empty() {
-        writes.put(
-            MEMBERSHIP_PACK_NAMESPACE,
-            pack_key(commit.id, SINGLE_PACK_ID)?,
-            crate::commit_store::codec::encode_membership_pack(
-                commit.id,
-                SINGLE_PACK_ID,
-                adopted_changes.iter().map(ChangeLocator::as_ref),
-            )?,
-        );
-    }
-
-    Ok(StagedCommitStoreCommit {
-        authored_locators,
-        adopted_locators: adopted_changes,
-    })
-}
-
-pub(crate) async fn load_commit(
-    store: &mut (impl StorageReader + ?Sized),
-    commit_id: &str,
-) -> Result<Option<Commit>, LixError> {
-    let Some(bytes) = get_one(store, COMMIT_NAMESPACE, commit_key(commit_id)).await? else {
-        return Ok(None);
-    };
-    crate::commit_store::codec::decode_commit(&bytes).map(Some)
-}
-
-pub(crate) async fn scan_commits(
-    store: &mut (impl StorageReader + ?Sized),
-) -> Result<Vec<Commit>, LixError> {
-    let page = store
-        .scan_values(KvScanRequest {
-            namespace: COMMIT_NAMESPACE.to_string(),
-            range: KvScanRange::prefix(Vec::new()),
-            after: None,
-            limit: usize::MAX,
-        })
-        .await?;
-    page.values
-        .iter()
-        .map(|bytes| crate::commit_store::codec::decode_commit(bytes))
-        .collect()
-}
-
-pub(crate) async fn load_change_pack(
-    store: &mut (impl StorageReader + ?Sized),
-    commit_id: &str,
-    pack_id: u32,
-) -> Result<Option<Vec<Change>>, LixError> {
-    let Some(bytes) = get_one(store, CHANGE_PACK_NAMESPACE, pack_key(commit_id, pack_id)?).await?
-    else {
-        return load_tracked_authored_change_pack(store, commit_id, pack_id).await;
-    };
-    let (stored_commit_id, stored_pack_id, changes) =
-        crate::commit_store::codec::decode_change_pack(&bytes)?;
-    ensure_pack_identity(
-        "change pack",
-        commit_id,
-        pack_id,
-        &stored_commit_id,
-        stored_pack_id,
-    )?;
-    Ok(Some(changes))
-}
-
-pub(crate) async fn load_tracked_authored_change_pack(
-    store: &mut (impl StorageReader + ?Sized),
-    commit_id: &str,
-    pack_id: u32,
-) -> Result<Option<Vec<Change>>, LixError> {
-    let Some(delta_entries) = crate::tracked_state::load_delta_pack(store, commit_id).await? else {
-        return Ok(None);
-    };
-    let mut changes_by_ordinal = BTreeMap::<u32, Change>::new();
-    for delta in delta_entries {
-        let locator = &delta.value.change_locator;
-        if locator.source_commit_id != commit_id || locator.source_pack_id != pack_id {
-            continue;
-        }
-        let ordinal = locator.source_ordinal;
-        let change = Change {
-            id: locator.change_id.clone(),
-            entity_id: delta.key.entity_id,
-            schema_key: delta.key.schema_key,
-            file_id: delta.key.file_id,
-            snapshot_ref: delta.value.snapshot_ref,
-            metadata_ref: delta.value.metadata_ref,
-            created_at: delta.value.updated_at,
-        };
-        if changes_by_ordinal.insert(ordinal, change).is_some() {
-            return Err(LixError::new(
-                LixError::CODE_INTERNAL_ERROR,
-                format!(
-                    "tracked authored change pack ({commit_id}, {pack_id}) has duplicate ordinal {ordinal}"
-                ),
-            ));
-        }
-    }
-    if changes_by_ordinal.is_empty() {
-        return Ok(None);
-    }
-    let mut changes = Vec::with_capacity(changes_by_ordinal.len());
-    for (expected_ordinal, (ordinal, change)) in (0u32..).zip(changes_by_ordinal) {
-        if ordinal != expected_ordinal {
-            return Err(LixError::new(
-                LixError::CODE_INTERNAL_ERROR,
-                format!(
-                    "tracked authored change pack ({commit_id}, {pack_id}) is missing ordinal {expected_ordinal}"
-                ),
-            ));
-        }
-        changes.push(change);
-    }
-    Ok(Some(changes))
-}
-
-pub(crate) async fn load_membership_pack(
-    store: &mut (impl StorageReader + ?Sized),
-    commit_id: &str,
-    pack_id: u32,
-) -> Result<Option<Vec<ChangeLocator>>, LixError> {
-    let Some(bytes) = get_one(
-        store,
-        MEMBERSHIP_PACK_NAMESPACE,
-        pack_key(commit_id, pack_id)?,
-    )
-    .await?
-    else {
-        return Ok(None);
-    };
-    let (stored_commit_id, stored_pack_id, members) =
-        crate::commit_store::codec::decode_membership_pack(&bytes)?;
-    ensure_pack_identity(
-        "membership pack",
-        commit_id,
-        pack_id,
-        &stored_commit_id,
-        stored_pack_id,
-    )?;
-    Ok(Some(members))
-}
-
-pub(crate) async fn load_change_index_entries(
-    store: &mut (impl StorageReader + ?Sized),
-    change_ids: &[String],
-) -> Result<Vec<Option<ChangeIndexEntry>>, LixError> {
-    if change_ids.is_empty() {
-        return Ok(Vec::new());
-    }
-
-    let mut unresolved = change_ids.iter().cloned().collect::<BTreeSet<_>>();
-    let mut entries_by_change_id = BTreeMap::new();
-    let commits = scan_commits(store).await?;
-    for commit in commits {
-        if unresolved.remove(&commit.change_id) {
-            entries_by_change_id.insert(
-                commit.change_id.clone(),
-                ChangeIndexEntry::CommitHeader {
-                    commit_id: commit.id.clone(),
-                    change_id: commit.change_id.clone(),
-                },
-            );
-        }
-        if unresolved.is_empty() {
-            break;
-        }
-
-        for pack_id in 0..commit.change_pack_count {
-            let Some(changes) = load_change_pack(store, &commit.id, pack_id).await? else {
-                return Err(LixError::new(
-                    LixError::CODE_INTERNAL_ERROR,
-                    format!(
-                        "commit-store missing change pack ({}, {pack_id})",
-                        commit.id
-                    ),
-                ));
-            };
-            for (source_ordinal, change) in changes.iter().enumerate() {
-                if !unresolved.remove(&change.id) {
-                    continue;
-                }
-                entries_by_change_id.insert(
-                    change.id.clone(),
-                    ChangeIndexEntry::PackedChange {
-                        locator: ChangeLocator {
-                            source_commit_id: commit.id.clone(),
-                            source_pack_id: pack_id,
-                            source_ordinal: u32::try_from(source_ordinal).map_err(|_| {
-                                LixError::new(
-                                    LixError::CODE_INTERNAL_ERROR,
-                                    "commit-store change pack ordinal exceeds u32",
-                                )
-                            })?,
-                            change_id: change.id.clone(),
-                        },
-                    },
-                );
-                if unresolved.is_empty() {
-                    break;
-                }
-            }
-            if unresolved.is_empty() {
-                break;
-            }
-        }
-        if unresolved.is_empty() {
-            break;
-        }
-    }
-
-    Ok(change_ids
-        .iter()
-        .map(|change_id| entries_by_change_id.get(change_id).cloned())
-        .collect())
-}
-
-async fn get_one(
-    store: &mut (impl StorageReader + ?Sized),
-    namespace: &str,
-    key: Vec<u8>,
-) -> Result<Option<Vec<u8>>, LixError> {
-    Ok(store
-        .get_values(KvGetRequest {
-            groups: vec![KvGetGroup {
-                namespace: namespace.to_string(),
-                keys: vec![key],
-            }],
-        })
-        .await?
-        .groups
-        .into_iter()
-        .next()
-        .and_then(|group| group.single_value_owned()))
-}
-
-fn ensure_pack_identity(
-    label: &str,
-    expected_commit_id: &str,
-    expected_pack_id: u32,
-    actual_commit_id: &str,
-    actual_pack_id: u32,
-) -> Result<(), LixError> {
-    if actual_commit_id != expected_commit_id || actual_pack_id != expected_pack_id {
-        return Err(LixError::new(
-            LixError::CODE_INTERNAL_ERROR,
-            format!(
-                "commit-store {label} identity mismatch: expected ({expected_commit_id}, {expected_pack_id}), got ({actual_commit_id}, {actual_pack_id})"
-            ),
-        ));
-    }
-    Ok(())
-}
-
-fn commit_key(commit_id: &str) -> Vec<u8> {
-    commit_id.as_bytes().to_vec()
-}
-
-fn pack_key(commit_id: &str, pack_id: u32) -> Result<Vec<u8>, LixError> {
-    let commit_id_len = u32::try_from(commit_id.len()).map_err(|_| {
-        LixError::new(
-            LixError::CODE_INTERNAL_ERROR,
-            "commit-store pack key commit id exceeds u32 length",
-        )
-    })?;
-    let mut key = Vec::with_capacity(8 + commit_id.len());
-    key.extend_from_slice(&commit_id_len.to_be_bytes());
-    key.extend_from_slice(commit_id.as_bytes());
-    key.extend_from_slice(&pack_id.to_be_bytes());
-    Ok(key)
-}
-
-#[cfg(test)]
-mod tests {
-    use std::sync::Arc;
-
-    use crate::backend::testing::UnitTestBackend;
-    use crate::commit_store::CommitDraftRef;
-    use crate::entity_identity::EntityIdentity;
-    use crate::json_store::JsonRef;
-    use crate::storage::{StorageContext, StorageWriteTransaction};
-    use crate::tracked_state::{TrackedStateContext, TrackedStateDeltaRef};
-
-    use super::*;
-
-    #[tokio::test]
-    async fn stage_commit_writes_all_commit_store_namespaces() {
-        let storage = StorageContext::new(Arc::new(UnitTestBackend::new()));
-        let mut tx = storage
-            .begin_write_transaction()
-            .await
-            .expect("transaction should open");
-        let mut writes = StorageWriteSet::new();
-        let commit = test_commit();
-        let change = test_change("change-1");
-        let adopted = ChangeLocator {
-            source_commit_id: "source-commit".to_string(),
-            source_pack_id: 3,
-            source_ordinal: 7,
-            change_id: "adopted-change".to_string(),
-        };
-
-        let staged = stage_commit(
-            &mut writes,
-            CommitDraftRef {
-                id: &commit.id,
-                change_id: &commit.change_id,
-                parent_ids: &commit.parent_ids,
-                author_account_ids: &commit.author_account_ids,
-                created_at: &commit.created_at,
-            },
-            vec![change.as_ref()],
-            vec![adopted.clone()],
-        )
-        .expect("commit should stage");
-        writes
-            .apply(&mut tx.as_mut())
-            .await
-            .expect("writes should apply");
-        tx.commit().await.expect("commit should succeed");
-
-        assert_eq!(
-            staged.authored_locators,
-            vec![ChangeLocator {
-                source_commit_id: "commit-1".to_string(),
-                source_pack_id: 0,
-                source_ordinal: 0,
-                change_id: "change-1".to_string(),
-            }]
-        );
-        assert_eq!(staged.adopted_locators, vec![adopted.clone()]);
-
-        let mut reader = storage.clone();
-        assert_eq!(
-            load_commit(&mut reader, "commit-1")
-                .await
-                .expect("commit should load"),
-            Some(commit)
-        );
-        assert_eq!(
-            load_change_pack(&mut reader, "commit-1", 0)
-                .await
-                .expect("change pack should load"),
-            Some(vec![change])
-        );
-        assert_eq!(
-            load_membership_pack(&mut reader, "commit-1", 0)
-                .await
-                .expect("membership pack should load"),
-            Some(vec![adopted])
-        );
-
-        let index_entries = load_change_index_entries(
-            &mut reader,
-            &["commit-change-1".to_string(), "change-1".to_string()],
-        )
-        .await
-        .expect("index entries should load");
-        assert_eq!(
-            index_entries,
-            vec![
-                Some(ChangeIndexEntry::CommitHeader {
-                    commit_id: "commit-1".to_string(),
-                    change_id: "commit-change-1".to_string(),
-                }),
-                Some(ChangeIndexEntry::PackedChange {
-                    locator: ChangeLocator {
-                        source_commit_id: "commit-1".to_string(),
-                        source_pack_id: 0,
-                        source_ordinal: 0,
-                        change_id: "change-1".to_string(),
-                    },
-                }),
-            ]
-        );
-    }
-
-    #[tokio::test]
-    async fn tracked_commit_change_pack_loads_from_delta_pack() {
-        let storage = StorageContext::new(Arc::new(UnitTestBackend::new()));
-        let mut tx = storage
-            .begin_write_transaction()
-            .await
-            .expect("transaction should open");
-        let mut writes = StorageWriteSet::new();
-        let commit = test_commit();
-        let change = test_change("change-1");
-
-        let staged = stage_commit_with_external_authored_pack(
-            &mut writes,
-            CommitDraftRef {
-                id: &commit.id,
-                change_id: &commit.change_id,
-                parent_ids: &commit.parent_ids,
-                author_account_ids: &commit.author_account_ids,
-                created_at: &commit.created_at,
-            },
-            vec![change.as_ref()],
-            Vec::new(),
-        )
-        .expect("tracked commit should stage");
-        let deltas = [TrackedStateDeltaRef {
-            change: change.as_ref(),
-            locator: staged.authored_locators[0].as_ref(),
-            created_at: "2026-01-01T00:00:00Z",
-            updated_at: "2026-01-02T00:00:00Z",
-        }];
-        TrackedStateContext::new()
-            .writer(&mut tx.as_mut(), &mut writes)
-            .stage_delta(&commit.id, None, &deltas)
-            .await
-            .expect("tracked delta should stage");
-        writes
-            .apply(&mut tx.as_mut())
-            .await
-            .expect("writes should apply");
-        tx.commit().await.expect("commit should succeed");
-
-        let mut reader = storage.clone();
-        assert_eq!(
-            get_one(
-                &mut reader,
-                CHANGE_PACK_NAMESPACE,
-                pack_key("commit-1", 0).unwrap()
-            )
-            .await
-            .expect("direct change pack lookup should succeed"),
-            None
-        );
-        assert_eq!(
-            load_change_pack(&mut reader, "commit-1", 0)
-                .await
-                .expect("tracked change pack should load"),
-            Some(vec![Change {
-                created_at: "2026-01-02T00:00:00Z".to_string(),
-                ..change.clone()
-            }])
-        );
-        assert_eq!(
-            load_change_index_entries(&mut reader, &["change-1".to_string()])
-                .await
-                .expect("index entries should load"),
-            vec![Some(ChangeIndexEntry::PackedChange {
-                locator: staged.authored_locators[0].clone(),
-            })]
-        );
-    }
-
-    #[tokio::test]
-    async fn tracked_commit_change_pack_rejects_sparse_delta_ordinals() {
-        let storage = StorageContext::new(Arc::new(UnitTestBackend::new()));
-        let mut tx = storage
-            .begin_write_transaction()
-            .await
-            .expect("transaction should open");
-        let mut writes = StorageWriteSet::new();
-        let commit = test_commit();
-        let change = test_change("change-1");
-        let sparse_locator = ChangeLocator {
-            source_commit_id: commit.id.clone(),
-            source_pack_id: 0,
-            source_ordinal: 1,
-            change_id: change.id.clone(),
-        };
-        let deltas = [TrackedStateDeltaRef {
-            change: change.as_ref(),
-            locator: sparse_locator.as_ref(),
-            created_at: "2026-01-01T00:00:00Z",
-            updated_at: "2026-01-02T00:00:00Z",
-        }];
-        TrackedStateContext::new()
-            .writer(&mut tx.as_mut(), &mut writes)
-            .stage_delta(&commit.id, None, &deltas)
-            .await
-            .expect("tracked delta should stage");
-        writes
-            .apply(&mut tx.as_mut())
-            .await
-            .expect("writes should apply");
-        tx.commit().await.expect("commit should succeed");
-
-        let mut reader = storage.clone();
-        let error = load_change_pack(&mut reader, "commit-1", 0)
-            .await
-            .expect_err("sparse tracked authored ordinals should reject");
-        assert!(
-            error.to_string().contains("missing ordinal 0"),
-            "error should mention missing ordinal: {error}"
-        );
-    }
-
-    fn test_commit() -> Commit {
-        Commit {
-            id: "commit-1".to_string(),
-            change_id: "commit-change-1".to_string(),
-            parent_ids: vec!["parent-1".to_string()],
-            author_account_ids: Vec::new(),
-            created_at: "2026-01-01T00:00:00Z".to_string(),
-            change_pack_count: 1,
-            membership_pack_count: 1,
-        }
-    }
-
-    fn test_change(id: &str) -> Change {
-        Change {
-            id: id.to_string(),
-            entity_id: EntityIdentity::single("entity-1"),
-            schema_key: "test_schema".to_string(),
-            file_id: None,
-            snapshot_ref: Some(JsonRef::from_hash_bytes([1; 32])),
-            metadata_ref: None,
-            created_at: "2026-01-01T00:00:00Z".to_string(),
-        }
-    }
-}