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

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

@@ -104,30 +104,25 @@ impl<'a> From<&'a NormalizedJson> for NormalizedJsonRef<'a> {
 }
 
 #[derive(Debug, Clone, Copy, PartialEq, Eq)]
-pub(crate) enum JsonWritePlacementRef<'a> {
-    CommitPack { commit_id: &'a str, pack_id: u32 },
+pub(crate) enum JsonWritePlacementRef {
     OutOfBand,
 }
 
 #[derive(Debug, Clone, Copy, PartialEq, Eq)]
-pub(crate) enum JsonReadScopeRef<'a> {
+pub(crate) enum JsonReadScopeRef {
     OutOfBand,
-    CommitPacks {
-        commit_id: &'a str,
-        pack_ids: &'a [u32],
-    },
 }
 
 #[derive(Debug, Clone, Copy, PartialEq, Eq)]
 pub(crate) struct JsonLoadRequestRef<'a> {
     pub(crate) refs: &'a [JsonRef],
-    pub(crate) scope: JsonReadScopeRef<'a>,
+    pub(crate) scope: JsonReadScopeRef,
 }
 
 #[derive(Debug, Clone, Copy, PartialEq, Eq)]
 pub(crate) struct JsonProjectionLoadRequestRef<'a> {
     pub(crate) refs: &'a [JsonRef],
-    pub(crate) scope: JsonReadScopeRef<'a>,
+    pub(crate) scope: JsonReadScopeRef,
     pub(crate) paths: &'a [JsonProjectionPath],
 }
 

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

@@ -1,14 +1,32 @@
-mod backend;
+//! Lix engine runtime.
+//!
+//! MVP transaction boundary:
+//! - Engine/session APIs provide one process-local durable write lane per
+//!   backend durable target.
+//! - Explicit transactions serialize with implicit session writes on the same
+//!   handle and durable target. The MVP does not promise multi-branch snapshot
+//!   isolation across concurrent sessions beyond each backend read snapshot.
+//! - `SessionContext::close()` is a lifecycle boundary. It waits for in-flight
+//!   reads, rejects live explicit transactions, cancels queued or pre-boundary
+//!   writes, and waits once a commit has entered the durable point-of-no-return.
+//! - Crash durability is delegated to the backend. The MVP does not add an
+//!   engine WAL, fsync policy, or recovery protocol above backend commits.
+//! - `backend` and `storage` are low-level surfaces. Code that bypasses
+//!   `Engine`/`SessionContext` also bypasses session lifecycle accounting and
+//!   must provide its own serialization.
+
+pub mod backend;
 mod binary_cas;
+pub(crate) mod branch;
 pub(crate) mod catalog;
 pub(crate) mod cel;
-pub(crate) mod commit_graph;
 #[allow(dead_code, unused_imports)]
-pub(crate) mod commit_store;
+pub mod changelog;
+pub(crate) mod commit_graph;
 mod common;
 pub(crate) mod domain;
 pub mod engine;
-pub(crate) mod entity_identity;
+pub(crate) mod entity_pk;
 pub(crate) mod functions;
 pub(crate) mod init;
 #[allow(dead_code)]
@@ -18,16 +36,21 @@ mod schema;
 pub mod session;
 pub(crate) mod sql2;
 #[allow(dead_code, unused_imports)]
-pub(crate) mod storage;
+pub mod storage;
 #[cfg(feature = "storage-benches")]
 pub mod storage_bench;
 #[cfg_attr(feature = "storage-benches", allow(dead_code))]
 #[cfg(any(test, feature = "storage-benches"))]
 pub(crate) mod test_support;
+#[cfg(feature = "storage-benches")]
+pub mod tracked_state;
+#[cfg(not(feature = "storage-benches"))]
 pub(crate) mod tracked_state;
+#[cfg(feature = "storage-benches")]
 pub mod transaction;
+#[cfg(not(feature = "storage-benches"))]
+pub(crate) mod transaction;
 pub(crate) mod untracked_state;
-pub(crate) mod version;
 pub mod wasm;
 
 pub use schema::{
@@ -35,28 +58,35 @@ pub use schema::{
     validate_lix_schema_definition,
 };
 
+pub use backend::conformance::{
+    run_backend_conformance, BackendFactory, BackendFixture, BackendTestConfig,
+    ConformanceReport as BackendConformanceReport, ConformanceResult as BackendConformanceResult,
+    ConformanceStatus as BackendConformanceStatus, ConformanceTest as BackendConformanceTest,
+};
 pub use backend::{
-    Backend, BackendKvEntryPage, BackendKvExistsBatch, BackendKvExistsGroup, BackendKvGetGroup,
-    BackendKvGetRequest, BackendKvKeyPage, BackendKvScanRange, BackendKvScanRequest,
-    BackendKvValueBatch, BackendKvValueGroup, BackendKvValuePage, BackendKvWriteBatch,
-    BackendKvWriteGroup, BackendKvWriteStats, BackendReadTransaction, BackendWriteTransaction,
-    BytePage, BytePageBuilder,
+    get_many as backend_get_many, visit_range as backend_visit_range, Backend, BackendCapabilities,
+    BackendError, BackendRangeScan, BackendRead, BackendWrite, BufferedRangeScan, CommitResult,
+    CoreProjection, Durability, DurableWriteGuard, DurableWriteLock, GetManyResult, GetOptions,
+    InMemoryBackend, InMemoryBackendFactory, InMemoryBackendFixture, InMemoryRangeScan,
+    InMemoryRead, InMemoryScanVisitResult, InMemoryWrite, Key, Key as BackendKey, KeyRange,
+    KeyRef as BackendKeyRef, PointVisitor, Prefix as BackendPrefix, ProjectedValue,
+    ProjectedValueRef, PutBatch, PutEntry, ReadConsistency, ReadEntry, ReadOptions, ScanChunk,
+    ScanOptions, ScanResult, ScanVisitor, SnapshotRef, SpaceId, StoredValue, Value as BackendValue,
+    WriteConcurrency, WriteOptions, WriteStats,
 };
 pub use common::LixError;
 pub(crate) use common::{parse_row_metadata, parse_row_metadata_value, serialize_row_metadata};
-pub use common::{CanonicalPluginKey, CanonicalSchemaKey, EntityId, FileId, VersionId};
+pub use common::{BranchId, CanonicalPluginKey, CanonicalSchemaKey, EntityPk, FileId};
 pub use common::{LixNotice, NullableKeyFilter, SqlQueryResult, Value, WriteReceipt};
 pub use common::{WireQueryResult, WireValue};
 pub use engine::Engine;
 pub use init::InitReceipt;
-#[cfg(feature = "storage-benches")]
-pub use session::optimization9_sql2_bench;
 pub use session::{
-    CreateVersionOptions, CreateVersionReceipt, MergeChangeStats, MergeConflict,
-    MergeConflictChangeKind, MergeConflictKind, MergeConflictSide, MergeVersionOptions,
-    MergeVersionOutcome, MergeVersionPreview, MergeVersionPreviewOptions, MergeVersionReceipt,
-    SessionContext, SwitchVersionOptions, SwitchVersionReceipt,
+    CreateBranchOptions, CreateBranchReceipt, MergeBranchOptions, MergeBranchOutcome,
+    MergeBranchPreview, MergeBranchPreviewOptions, MergeBranchReceipt, MergeChangeStats,
+    MergeConflict, MergeConflictChangeKind, MergeConflictKind, MergeConflictSide, SessionContext,
+    SessionTransaction, SwitchBranchOptions, SwitchBranchReceipt,
 };
 pub use session::{ExecuteResult, Row, RowRef, TryFromValue};
 
-pub(crate) const GLOBAL_VERSION_ID: &str = "global";
+pub(crate) const GLOBAL_BRANCH_ID: &str = "global";