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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (274) hide show
  1. package/README.md +76 -4
  2. package/dist/errors.d.ts +7 -0
  3. package/dist/errors.js +19 -0
  4. package/dist/index.d.ts +4 -5
  5. package/dist/index.js +3 -3
  6. package/dist/native.d.ts +1 -0
  7. package/dist/native.js +47 -0
  8. package/dist/open-lix.d.ts +38 -207
  9. package/dist/open-lix.js +59 -284
  10. package/dist/result.d.ts +18 -0
  11. package/dist/result.js +48 -0
  12. package/dist/types.d.ts +114 -1
  13. package/dist/value.d.ts +28 -0
  14. package/dist/value.js +245 -0
  15. package/package.json +38 -71
  16. package/SKILL.md +0 -507
  17. package/dist/builtin-schemas.d.ts +0 -1
  18. package/dist/builtin-schemas.js +0 -1
  19. package/dist/engine-wasm/index.d.ts +0 -87
  20. package/dist/engine-wasm/index.js +0 -339
  21. package/dist/engine-wasm/wasm/lix_engine.d.ts +0 -79
  22. package/dist/engine-wasm/wasm/lix_engine.js +0 -833
  23. package/dist/engine-wasm/wasm/lix_engine.wasm +0 -0
  24. package/dist/engine-wasm/wasm/lix_engine.wasm.d.ts +0 -27
  25. package/dist/generated/builtin-schemas.d.ts +0 -427
  26. package/dist/generated/builtin-schemas.js +0 -643
  27. package/dist/sqlite/index.d.ts +0 -12
  28. package/dist/sqlite/index.js +0 -359
  29. package/dist-engine-src/README.md +0 -18
  30. package/dist-engine-src/src/backend/capabilities.rs +0 -67
  31. package/dist-engine-src/src/backend/conformance/baseline.rs +0 -1127
  32. package/dist-engine-src/src/backend/conformance/factory.rs +0 -93
  33. package/dist-engine-src/src/backend/conformance/failure_tests.rs +0 -608
  34. package/dist-engine-src/src/backend/conformance/fixtures.rs +0 -26
  35. package/dist-engine-src/src/backend/conformance/mod.rs +0 -75
  36. package/dist-engine-src/src/backend/conformance/model.rs +0 -28
  37. package/dist-engine-src/src/backend/conformance/model_based.rs +0 -257
  38. package/dist-engine-src/src/backend/conformance/persistence.rs +0 -204
  39. package/dist-engine-src/src/backend/conformance/projection.rs +0 -21
  40. package/dist-engine-src/src/backend/conformance/pushdown.rs +0 -24
  41. package/dist-engine-src/src/backend/conformance/runner.rs +0 -90
  42. package/dist-engine-src/src/backend/conformance/scan.rs +0 -24
  43. package/dist-engine-src/src/backend/conformance/write.rs +0 -16
  44. package/dist-engine-src/src/backend/error.rs +0 -94
  45. package/dist-engine-src/src/backend/in_memory.rs +0 -670
  46. package/dist-engine-src/src/backend/mod.rs +0 -39
  47. package/dist-engine-src/src/backend/predicate.rs +0 -80
  48. package/dist-engine-src/src/backend/traits.rs +0 -260
  49. package/dist-engine-src/src/backend/types.rs +0 -239
  50. package/dist-engine-src/src/binary_cas/chunking.rs +0 -31
  51. package/dist-engine-src/src/binary_cas/codec.rs +0 -346
  52. package/dist-engine-src/src/binary_cas/context.rs +0 -139
  53. package/dist-engine-src/src/binary_cas/kv.rs +0 -1038
  54. package/dist-engine-src/src/binary_cas/mod.rs +0 -11
  55. package/dist-engine-src/src/binary_cas/types.rs +0 -121
  56. package/dist-engine-src/src/branch/context.rs +0 -40
  57. package/dist-engine-src/src/branch/lifecycle.rs +0 -221
  58. package/dist-engine-src/src/branch/mod.rs +0 -13
  59. package/dist-engine-src/src/branch/refs.rs +0 -321
  60. package/dist-engine-src/src/branch/stage_rows.rs +0 -67
  61. package/dist-engine-src/src/branch/types.rs +0 -21
  62. package/dist-engine-src/src/catalog/context.rs +0 -412
  63. package/dist-engine-src/src/catalog/mod.rs +0 -10
  64. package/dist-engine-src/src/catalog/schema.rs +0 -4
  65. package/dist-engine-src/src/catalog/snapshot.rs +0 -1114
  66. package/dist-engine-src/src/cel/context.rs +0 -86
  67. package/dist-engine-src/src/cel/error.rs +0 -19
  68. package/dist-engine-src/src/cel/mod.rs +0 -8
  69. package/dist-engine-src/src/cel/provider.rs +0 -9
  70. package/dist-engine-src/src/cel/runtime.rs +0 -167
  71. package/dist-engine-src/src/cel/value.rs +0 -50
  72. package/dist-engine-src/src/changelog/bench_support.rs +0 -785
  73. package/dist-engine-src/src/changelog/change.rs +0 -1
  74. package/dist-engine-src/src/changelog/codec.rs +0 -497
  75. package/dist-engine-src/src/changelog/commit.rs +0 -1
  76. package/dist-engine-src/src/changelog/context.rs +0 -1614
  77. package/dist-engine-src/src/changelog/mod.rs +0 -29
  78. package/dist-engine-src/src/changelog/store.rs +0 -163
  79. package/dist-engine-src/src/changelog/test_support.rs +0 -54
  80. package/dist-engine-src/src/changelog/types.rs +0 -213
  81. package/dist-engine-src/src/commit_graph/context.rs +0 -944
  82. package/dist-engine-src/src/commit_graph/mod.rs +0 -9
  83. package/dist-engine-src/src/commit_graph/types.rs +0 -89
  84. package/dist-engine-src/src/commit_graph/walker.rs +0 -786
  85. package/dist-engine-src/src/common/error.rs +0 -347
  86. package/dist-engine-src/src/common/fingerprint.rs +0 -3
  87. package/dist-engine-src/src/common/fs_path.rs +0 -1336
  88. package/dist-engine-src/src/common/identity.rs +0 -145
  89. package/dist-engine-src/src/common/json_pointer.rs +0 -67
  90. package/dist-engine-src/src/common/metadata.rs +0 -40
  91. package/dist-engine-src/src/common/mod.rs +0 -23
  92. package/dist-engine-src/src/common/types.rs +0 -105
  93. package/dist-engine-src/src/common/wire.rs +0 -222
  94. package/dist-engine-src/src/domain.rs +0 -320
  95. package/dist-engine-src/src/engine.rs +0 -203
  96. package/dist-engine-src/src/entity_pk.rs +0 -402
  97. package/dist-engine-src/src/functions/context.rs +0 -296
  98. package/dist-engine-src/src/functions/deterministic.rs +0 -113
  99. package/dist-engine-src/src/functions/mod.rs +0 -18
  100. package/dist-engine-src/src/functions/provider.rs +0 -130
  101. package/dist-engine-src/src/functions/state.rs +0 -335
  102. package/dist-engine-src/src/functions/types.rs +0 -37
  103. package/dist-engine-src/src/init.rs +0 -692
  104. package/dist-engine-src/src/json_store/compression.rs +0 -77
  105. package/dist-engine-src/src/json_store/context.rs +0 -172
  106. package/dist-engine-src/src/json_store/encoded.rs +0 -15
  107. package/dist-engine-src/src/json_store/mod.rs +0 -38
  108. package/dist-engine-src/src/json_store/store.rs +0 -494
  109. package/dist-engine-src/src/json_store/types.rs +0 -212
  110. package/dist-engine-src/src/lib.rs +0 -92
  111. package/dist-engine-src/src/live_state/context.rs +0 -1883
  112. package/dist-engine-src/src/live_state/mod.rs +0 -21
  113. package/dist-engine-src/src/live_state/overlay.rs +0 -75
  114. package/dist-engine-src/src/live_state/reader.rs +0 -23
  115. package/dist-engine-src/src/live_state/types.rs +0 -231
  116. package/dist-engine-src/src/live_state/visibility.rs +0 -666
  117. package/dist-engine-src/src/plugin/archive.rs +0 -438
  118. package/dist-engine-src/src/plugin/component.rs +0 -183
  119. package/dist-engine-src/src/plugin/install.rs +0 -619
  120. package/dist-engine-src/src/plugin/manifest.rs +0 -516
  121. package/dist-engine-src/src/plugin/materializer.rs +0 -202
  122. package/dist-engine-src/src/plugin/mod.rs +0 -33
  123. package/dist-engine-src/src/plugin/plugin_manifest.json +0 -119
  124. package/dist-engine-src/src/plugin/storage.rs +0 -74
  125. package/dist-engine-src/src/schema/annotations/defaults.rs +0 -275
  126. package/dist-engine-src/src/schema/annotations/mod.rs +0 -1
  127. package/dist-engine-src/src/schema/builtin/lix_account.json +0 -21
  128. package/dist-engine-src/src/schema/builtin/lix_active_account.json +0 -29
  129. package/dist-engine-src/src/schema/builtin/lix_binary_blob_ref.json +0 -29
  130. package/dist-engine-src/src/schema/builtin/lix_branch_descriptor.json +0 -34
  131. package/dist-engine-src/src/schema/builtin/lix_branch_ref.json +0 -48
  132. package/dist-engine-src/src/schema/builtin/lix_change.json +0 -63
  133. package/dist-engine-src/src/schema/builtin/lix_change_author.json +0 -45
  134. package/dist-engine-src/src/schema/builtin/lix_commit.json +0 -24
  135. package/dist-engine-src/src/schema/builtin/lix_commit_edge.json +0 -53
  136. package/dist-engine-src/src/schema/builtin/lix_directory_descriptor.json +0 -52
  137. package/dist-engine-src/src/schema/builtin/lix_file_descriptor.json +0 -52
  138. package/dist-engine-src/src/schema/builtin/lix_key_value.json +0 -40
  139. package/dist-engine-src/src/schema/builtin/lix_label.json +0 -29
  140. package/dist-engine-src/src/schema/builtin/lix_label_assignment.json +0 -74
  141. package/dist-engine-src/src/schema/builtin/lix_registered_schema.json +0 -25
  142. package/dist-engine-src/src/schema/builtin/mod.rs +0 -220
  143. package/dist-engine-src/src/schema/compatibility.rs +0 -787
  144. package/dist-engine-src/src/schema/definition.json +0 -187
  145. package/dist-engine-src/src/schema/definition.rs +0 -742
  146. package/dist-engine-src/src/schema/key.rs +0 -138
  147. package/dist-engine-src/src/schema/mod.rs +0 -20
  148. package/dist-engine-src/src/schema/seed.rs +0 -14
  149. package/dist-engine-src/src/schema/tests.rs +0 -780
  150. package/dist-engine-src/src/session/context.rs +0 -1059
  151. package/dist-engine-src/src/session/create_branch.rs +0 -94
  152. package/dist-engine-src/src/session/execute.rs +0 -681
  153. package/dist-engine-src/src/session/merge/analysis.rs +0 -108
  154. package/dist-engine-src/src/session/merge/branch.rs +0 -417
  155. package/dist-engine-src/src/session/merge/conflicts.rs +0 -63
  156. package/dist-engine-src/src/session/merge/mod.rs +0 -10
  157. package/dist-engine-src/src/session/merge/stats.rs +0 -61
  158. package/dist-engine-src/src/session/mod.rs +0 -30
  159. package/dist-engine-src/src/session/switch_branch.rs +0 -113
  160. package/dist-engine-src/src/session/transaction.rs +0 -557
  161. package/dist-engine-src/src/sql2/bind/classify.rs +0 -102
  162. package/dist-engine-src/src/sql2/bind/error.rs +0 -5
  163. package/dist-engine-src/src/sql2/bind/expr.rs +0 -29
  164. package/dist-engine-src/src/sql2/bind/mod.rs +0 -12
  165. package/dist-engine-src/src/sql2/bind/public_udf.rs +0 -306
  166. package/dist-engine-src/src/sql2/bind/read.rs +0 -65
  167. package/dist-engine-src/src/sql2/bind/statement.rs +0 -2236
  168. package/dist-engine-src/src/sql2/bind/table.rs +0 -273
  169. package/dist-engine-src/src/sql2/bind/write.rs +0 -86
  170. package/dist-engine-src/src/sql2/branch_scope.rs +0 -436
  171. package/dist-engine-src/src/sql2/catalog/capability.rs +0 -20
  172. package/dist-engine-src/src/sql2/catalog/entity_surface.rs +0 -296
  173. package/dist-engine-src/src/sql2/catalog/mod.rs +0 -15
  174. package/dist-engine-src/src/sql2/catalog/registry.rs +0 -556
  175. package/dist-engine-src/src/sql2/catalog/schema.rs +0 -88
  176. package/dist-engine-src/src/sql2/catalog/surface.rs +0 -41
  177. package/dist-engine-src/src/sql2/change_materialization.rs +0 -122
  178. package/dist-engine-src/src/sql2/context.rs +0 -317
  179. package/dist-engine-src/src/sql2/dml.rs +0 -148
  180. package/dist-engine-src/src/sql2/error.rs +0 -215
  181. package/dist-engine-src/src/sql2/exec/bound_public_write.rs +0 -1593
  182. package/dist-engine-src/src/sql2/exec/datafusion.rs +0 -5266
  183. package/dist-engine-src/src/sql2/exec/fast_write.rs +0 -82
  184. package/dist-engine-src/src/sql2/exec/mod.rs +0 -24
  185. package/dist-engine-src/src/sql2/exec/write.rs +0 -661
  186. package/dist-engine-src/src/sql2/filesystem_planner.rs +0 -1485
  187. package/dist-engine-src/src/sql2/filesystem_predicates.rs +0 -159
  188. package/dist-engine-src/src/sql2/filesystem_visibility.rs +0 -383
  189. package/dist-engine-src/src/sql2/history_projection.rs +0 -56
  190. package/dist-engine-src/src/sql2/history_route.rs +0 -661
  191. package/dist-engine-src/src/sql2/mod.rs +0 -52
  192. package/dist-engine-src/src/sql2/optimize/datafusion.rs +0 -1
  193. package/dist-engine-src/src/sql2/optimize/mod.rs +0 -2
  194. package/dist-engine-src/src/sql2/optimize/simple_write.rs +0 -116
  195. package/dist-engine-src/src/sql2/parse/mod.rs +0 -69
  196. package/dist-engine-src/src/sql2/parse/normalize.rs +0 -1
  197. package/dist-engine-src/src/sql2/plan/branch_scope.rs +0 -24
  198. package/dist-engine-src/src/sql2/plan/mod.rs +0 -5
  199. package/dist-engine-src/src/sql2/plan/predicate.rs +0 -22
  200. package/dist-engine-src/src/sql2/plan/write.rs +0 -147
  201. package/dist-engine-src/src/sql2/predicate_typecheck.rs +0 -504
  202. package/dist-engine-src/src/sql2/providers/branch.rs +0 -1206
  203. package/dist-engine-src/src/sql2/providers/change.rs +0 -445
  204. package/dist-engine-src/src/sql2/providers/directory.rs +0 -2422
  205. package/dist-engine-src/src/sql2/providers/directory_history.rs +0 -645
  206. package/dist-engine-src/src/sql2/providers/entity.rs +0 -1484
  207. package/dist-engine-src/src/sql2/providers/entity_history.rs +0 -452
  208. package/dist-engine-src/src/sql2/providers/file.rs +0 -3686
  209. package/dist-engine-src/src/sql2/providers/file_history.rs +0 -924
  210. package/dist-engine-src/src/sql2/providers/history.rs +0 -426
  211. package/dist-engine-src/src/sql2/providers/lix_state.rs +0 -2542
  212. package/dist-engine-src/src/sql2/providers/mod.rs +0 -508
  213. package/dist-engine-src/src/sql2/read_only.rs +0 -63
  214. package/dist-engine-src/src/sql2/record_batch.rs +0 -17
  215. package/dist-engine-src/src/sql2/result_metadata.rs +0 -29
  216. package/dist-engine-src/src/sql2/runtime.rs +0 -60
  217. package/dist-engine-src/src/sql2/session.rs +0 -83
  218. package/dist-engine-src/src/sql2/storage/constraints.rs +0 -1
  219. package/dist-engine-src/src/sql2/storage/mod.rs +0 -1
  220. package/dist-engine-src/src/sql2/test_support/differential.rs +0 -712
  221. package/dist-engine-src/src/sql2/test_support/generators.rs +0 -354
  222. package/dist-engine-src/src/sql2/test_support/mod.rs +0 -2
  223. package/dist-engine-src/src/sql2/udfs/common.rs +0 -295
  224. package/dist-engine-src/src/sql2/udfs/lix_active_branch_commit_id.rs +0 -53
  225. package/dist-engine-src/src/sql2/udfs/lix_empty_blob.rs +0 -47
  226. package/dist-engine-src/src/sql2/udfs/lix_json.rs +0 -100
  227. package/dist-engine-src/src/sql2/udfs/lix_json_get.rs +0 -99
  228. package/dist-engine-src/src/sql2/udfs/lix_json_get_text.rs +0 -99
  229. package/dist-engine-src/src/sql2/udfs/lix_text_decode.rs +0 -82
  230. package/dist-engine-src/src/sql2/udfs/lix_text_encode.rs +0 -85
  231. package/dist-engine-src/src/sql2/udfs/lix_timestamp.rs +0 -76
  232. package/dist-engine-src/src/sql2/udfs/lix_uuid_v7.rs +0 -76
  233. package/dist-engine-src/src/sql2/udfs/mod.rs +0 -86
  234. package/dist-engine-src/src/sql2/write_normalization.rs +0 -368
  235. package/dist-engine-src/src/storage/conformance.rs +0 -399
  236. package/dist-engine-src/src/storage/context.rs +0 -620
  237. package/dist-engine-src/src/storage/mod.rs +0 -52
  238. package/dist-engine-src/src/storage/point.rs +0 -440
  239. package/dist-engine-src/src/storage/read_scope.rs +0 -67
  240. package/dist-engine-src/src/storage/reader.rs +0 -867
  241. package/dist-engine-src/src/storage/scan.rs +0 -784
  242. package/dist-engine-src/src/storage/spaces.rs +0 -236
  243. package/dist-engine-src/src/storage/stats.rs +0 -80
  244. package/dist-engine-src/src/storage/write_set.rs +0 -962
  245. package/dist-engine-src/src/storage_bench.rs +0 -171
  246. package/dist-engine-src/src/test_support.rs +0 -450
  247. package/dist-engine-src/src/tracked_state/bench_support.rs +0 -394
  248. package/dist-engine-src/src/tracked_state/codec.rs +0 -1183
  249. package/dist-engine-src/src/tracked_state/commit_root_rebuild.rs +0 -358
  250. package/dist-engine-src/src/tracked_state/context.rs +0 -2801
  251. package/dist-engine-src/src/tracked_state/diff.rs +0 -2140
  252. package/dist-engine-src/src/tracked_state/merge.rs +0 -478
  253. package/dist-engine-src/src/tracked_state/mod.rs +0 -35
  254. package/dist-engine-src/src/tracked_state/row_materialization.rs +0 -275
  255. package/dist-engine-src/src/tracked_state/storage.rs +0 -427
  256. package/dist-engine-src/src/tracked_state/tree.rs +0 -3063
  257. package/dist-engine-src/src/tracked_state/types.rs +0 -238
  258. package/dist-engine-src/src/transaction/bench_support.rs +0 -407
  259. package/dist-engine-src/src/transaction/commit.rs +0 -1592
  260. package/dist-engine-src/src/transaction/context.rs +0 -1653
  261. package/dist-engine-src/src/transaction/mod.rs +0 -24
  262. package/dist-engine-src/src/transaction/normalization.rs +0 -877
  263. package/dist-engine-src/src/transaction/prep.rs +0 -37
  264. package/dist-engine-src/src/transaction/schema_resolver.rs +0 -163
  265. package/dist-engine-src/src/transaction/staging.rs +0 -1525
  266. package/dist-engine-src/src/transaction/types.rs +0 -403
  267. package/dist-engine-src/src/transaction/validation.rs +0 -5766
  268. package/dist-engine-src/src/untracked_state/codec.rs +0 -615
  269. package/dist-engine-src/src/untracked_state/context.rs +0 -98
  270. package/dist-engine-src/src/untracked_state/materialization.rs +0 -63
  271. package/dist-engine-src/src/untracked_state/mod.rs +0 -15
  272. package/dist-engine-src/src/untracked_state/storage.rs +0 -898
  273. package/dist-engine-src/src/untracked_state/types.rs +0 -146
  274. package/dist-engine-src/src/wasm/mod.rs +0 -60
@@ -1,615 +0,0 @@
1
- use crate::entity_pk::EntityPk;
2
- use crate::untracked_state::{UntrackedStateIdentity, UntrackedStateRow, UntrackedStateRowRef};
3
- use crate::LixError;
4
-
5
- const UNTRACKED_STATE_FILE_IDENTIFIER: &str = "LXUS";
6
- // Durable payload bytes:
7
- // b"LXUP" | branch:u8 |
8
- // snapshot_content_tag:u8 | [snapshot_content_len:u32be | snapshot_content:utf8] |
9
- // metadata_tag:u8 | [metadata_len:u32be | metadata:utf8] |
10
- // created_at_len:u32be | created_at:utf8 |
11
- // updated_at_len:u32be | updated_at:utf8 |
12
- // global:u8
13
- const UNTRACKED_STATE_PAYLOAD_IDENTIFIER: &[u8; 4] = b"LXUP";
14
- const UNTRACKED_STATE_PAYLOAD_BRANCH_V1: u8 = 1;
15
-
16
- #[cfg_attr(not(feature = "storage-benches"), allow(dead_code))]
17
- pub(crate) fn encode_row_ref(row: UntrackedStateRowRef<'_>) -> Result<Vec<u8>, LixError> {
18
- let entity_pk = row.entity_pk.as_json_array_text().map_err(|error| {
19
- LixError::unknown(format!(
20
- "failed to encode untracked-state entity primary key: {error}"
21
- ))
22
- })?;
23
-
24
- let mut builder = flatbuffers::FlatBufferBuilder::with_capacity(256);
25
- let entity_pk = builder.create_string(&entity_pk);
26
- let schema_key = builder.create_string(row.schema_key);
27
- let file_id = row.file_id.map(|value| builder.create_string(value));
28
- let snapshot_content = row
29
- .snapshot_content
30
- .map(|value| builder.create_string(value));
31
- let metadata = row.metadata.map(|value| builder.create_string(value));
32
- let created_at = builder.create_string(row.created_at);
33
- let updated_at = builder.create_string(row.updated_at);
34
- let branch_id = builder.create_string(row.branch_id);
35
-
36
- let root = flatbuffer::create_untracked_state_row(
37
- &mut builder,
38
- &flatbuffer::UntrackedStateRowArgs {
39
- entity_pk,
40
- schema_key,
41
- file_id,
42
- snapshot_content,
43
- metadata,
44
- created_at,
45
- updated_at,
46
- global: row.global,
47
- branch_id,
48
- },
49
- );
50
- builder.finish(root, Some(UNTRACKED_STATE_FILE_IDENTIFIER));
51
- Ok(builder.finished_data().to_vec())
52
- }
53
-
54
- pub(crate) fn encode_payload_ref(row: UntrackedStateRowRef<'_>) -> Result<Vec<u8>, LixError> {
55
- let mut out = Vec::with_capacity(payload_capacity(row));
56
- out.extend_from_slice(UNTRACKED_STATE_PAYLOAD_IDENTIFIER);
57
- out.push(UNTRACKED_STATE_PAYLOAD_BRANCH_V1);
58
- push_optional_string(&mut out, row.snapshot_content)?;
59
- push_optional_string(&mut out, row.metadata)?;
60
- push_string(&mut out, row.created_at)?;
61
- push_string(&mut out, row.updated_at)?;
62
- out.push(u8::from(row.global));
63
- Ok(out)
64
- }
65
-
66
- pub(crate) fn decode_payload_with_identity(
67
- identity: UntrackedStateIdentity,
68
- bytes: &[u8],
69
- ) -> Result<UntrackedStateRow, LixError> {
70
- if !bytes.starts_with(UNTRACKED_STATE_PAYLOAD_IDENTIFIER) {
71
- return Err(LixError::new(
72
- "LIX_ERROR_UNKNOWN",
73
- "failed to decode untracked-state payload: invalid payload identifier",
74
- ));
75
- }
76
-
77
- let mut cursor = UNTRACKED_STATE_PAYLOAD_IDENTIFIER.len();
78
- let branch = read_u8(bytes, &mut cursor, "branch")?;
79
- if branch != UNTRACKED_STATE_PAYLOAD_BRANCH_V1 {
80
- return Err(LixError::new(
81
- "LIX_ERROR_UNKNOWN",
82
- format!("failed to decode untracked-state payload: unsupported branch {branch}"),
83
- ));
84
- }
85
- let snapshot_content = read_optional_string(bytes, &mut cursor, "snapshot_content")?;
86
- let metadata = read_optional_string(bytes, &mut cursor, "metadata")?;
87
- let created_at = read_string(bytes, &mut cursor, "created_at")?;
88
- let updated_at = read_string(bytes, &mut cursor, "updated_at")?;
89
- let global = read_bool(bytes, &mut cursor, "global")?;
90
- if cursor != bytes.len() {
91
- return Err(LixError::new(
92
- "LIX_ERROR_UNKNOWN",
93
- "failed to decode untracked-state payload: trailing bytes",
94
- ));
95
- }
96
-
97
- Ok(UntrackedStateRow {
98
- entity_pk: identity.entity_pk,
99
- schema_key: identity.schema_key,
100
- file_id: identity.file_id,
101
- snapshot_content,
102
- metadata,
103
- created_at,
104
- updated_at,
105
- global,
106
- branch_id: identity.branch_id,
107
- })
108
- }
109
-
110
- #[allow(dead_code)]
111
- pub(crate) fn decode_row(bytes: &[u8]) -> Result<UntrackedStateRow, LixError> {
112
- if bytes.len() < flatbuffers::SIZE_UOFFSET + flatbuffers::FILE_IDENTIFIER_LENGTH
113
- || !flatbuffers::buffer_has_identifier(bytes, UNTRACKED_STATE_FILE_IDENTIFIER, false)
114
- {
115
- return Err(LixError::new(
116
- "LIX_ERROR_UNKNOWN",
117
- "failed to decode untracked-state row: invalid FlatBuffers file identifier",
118
- ));
119
- }
120
-
121
- let row = flatbuffer::root_as_untracked_state_row(bytes).map_err(|error| {
122
- LixError::new(
123
- "LIX_ERROR_UNKNOWN",
124
- format!("failed to decode untracked-state row: {error}"),
125
- )
126
- })?;
127
-
128
- let entity_pk = required_str(row.entity_pk(), "entity_pk")?;
129
- let entity_pk = EntityPk::from_json_array_text(entity_pk).map_err(|error| {
130
- LixError::unknown(format!(
131
- "failed to decode untracked-state entity primary key: {error}"
132
- ))
133
- })?;
134
-
135
- Ok(UntrackedStateRow {
136
- entity_pk,
137
- schema_key: required_str(row.schema_key(), "schema_key")?.to_string(),
138
- file_id: row.file_id().map(ToString::to_string),
139
- snapshot_content: row.snapshot_content().map(ToString::to_string),
140
- metadata: row.metadata().map(ToString::to_string),
141
- created_at: required_str(row.created_at(), "created_at")?.to_string(),
142
- updated_at: required_str(row.updated_at(), "updated_at")?.to_string(),
143
- global: row.global(),
144
- branch_id: required_str(row.branch_id(), "branch_id")?.to_string(),
145
- })
146
- }
147
-
148
- fn payload_capacity(row: UntrackedStateRowRef<'_>) -> usize {
149
- UNTRACKED_STATE_PAYLOAD_IDENTIFIER.len()
150
- + 1
151
- + optional_string_capacity(row.snapshot_content)
152
- + optional_string_capacity(row.metadata)
153
- + string_capacity(row.created_at)
154
- + string_capacity(row.updated_at)
155
- + 1
156
- }
157
-
158
- fn optional_string_capacity(value: Option<&str>) -> usize {
159
- 1 + value.map_or(0, string_capacity)
160
- }
161
-
162
- fn string_capacity(value: &str) -> usize {
163
- 4 + value.len()
164
- }
165
-
166
- fn push_optional_string(out: &mut Vec<u8>, value: Option<&str>) -> Result<(), LixError> {
167
- match value {
168
- Some(value) => {
169
- out.push(1);
170
- push_string(out, value)?;
171
- }
172
- None => out.push(0),
173
- }
174
- Ok(())
175
- }
176
-
177
- fn push_string(out: &mut Vec<u8>, value: &str) -> Result<(), LixError> {
178
- let len = u32::try_from(value.len()).map_err(|_| {
179
- LixError::new(
180
- "LIX_ERROR_UNKNOWN",
181
- "failed to encode untracked-state payload: string length exceeds u32",
182
- )
183
- })?;
184
- out.extend_from_slice(&len.to_be_bytes());
185
- out.extend_from_slice(value.as_bytes());
186
- Ok(())
187
- }
188
-
189
- fn read_optional_string(
190
- bytes: &[u8],
191
- cursor: &mut usize,
192
- field: &str,
193
- ) -> Result<Option<String>, LixError> {
194
- let tag = read_u8(bytes, cursor, field)?;
195
- match tag {
196
- 0 => Ok(None),
197
- 1 => read_string(bytes, cursor, field).map(Some),
198
- _ => Err(LixError::new(
199
- "LIX_ERROR_UNKNOWN",
200
- format!("failed to decode untracked-state payload: invalid optional tag for `{field}`"),
201
- )),
202
- }
203
- }
204
-
205
- fn read_string(bytes: &[u8], cursor: &mut usize, field: &str) -> Result<String, LixError> {
206
- let len = read_u32(bytes, cursor, field)? as usize;
207
- let end = cursor.checked_add(len).ok_or_else(|| {
208
- LixError::new(
209
- "LIX_ERROR_UNKNOWN",
210
- format!("failed to decode untracked-state payload: `{field}` length overflow"),
211
- )
212
- })?;
213
- let value = bytes.get(*cursor..end).ok_or_else(|| {
214
- LixError::new(
215
- "LIX_ERROR_UNKNOWN",
216
- format!("failed to decode untracked-state payload: truncated `{field}`"),
217
- )
218
- })?;
219
- *cursor = end;
220
- std::str::from_utf8(value)
221
- .map(str::to_string)
222
- .map_err(|error| {
223
- LixError::new(
224
- "LIX_ERROR_UNKNOWN",
225
- format!("failed to decode untracked-state payload: invalid utf-8 for `{field}`: {error}"),
226
- )
227
- })
228
- }
229
-
230
- fn read_bool(bytes: &[u8], cursor: &mut usize, field: &str) -> Result<bool, LixError> {
231
- match read_u8(bytes, cursor, field)? {
232
- 0 => Ok(false),
233
- 1 => Ok(true),
234
- _ => Err(LixError::new(
235
- "LIX_ERROR_UNKNOWN",
236
- format!("failed to decode untracked-state payload: invalid boolean for `{field}`"),
237
- )),
238
- }
239
- }
240
-
241
- fn read_u32(bytes: &[u8], cursor: &mut usize, field: &str) -> Result<u32, LixError> {
242
- let end = cursor.checked_add(4).ok_or_else(|| {
243
- LixError::new(
244
- "LIX_ERROR_UNKNOWN",
245
- format!("failed to decode untracked-state payload: `{field}` cursor overflow"),
246
- )
247
- })?;
248
- let raw = bytes.get(*cursor..end).ok_or_else(|| {
249
- LixError::new(
250
- "LIX_ERROR_UNKNOWN",
251
- format!("failed to decode untracked-state payload: truncated `{field}` length"),
252
- )
253
- })?;
254
- *cursor = end;
255
- Ok(u32::from_be_bytes(
256
- raw.try_into().expect("slice length checked"),
257
- ))
258
- }
259
-
260
- fn read_u8(bytes: &[u8], cursor: &mut usize, field: &str) -> Result<u8, LixError> {
261
- let value = bytes.get(*cursor).copied().ok_or_else(|| {
262
- LixError::new(
263
- "LIX_ERROR_UNKNOWN",
264
- format!("failed to decode untracked-state payload: truncated `{field}`"),
265
- )
266
- })?;
267
- *cursor += 1;
268
- Ok(value)
269
- }
270
-
271
- #[allow(dead_code)]
272
- fn required_str<'a>(value: Option<&'a str>, field: &str) -> Result<&'a str, LixError> {
273
- value.ok_or_else(|| {
274
- LixError::new(
275
- "LIX_ERROR_UNKNOWN",
276
- format!("failed to decode untracked-state row: missing required field `{field}`"),
277
- )
278
- })
279
- }
280
-
281
- #[cfg(test)]
282
- mod tests {
283
- use super::*;
284
-
285
- fn row_ref<'a>(
286
- entity_pk: &'a EntityPk,
287
- snapshot_content: Option<&'a str>,
288
- metadata: Option<&'a str>,
289
- ) -> UntrackedStateRowRef<'a> {
290
- UntrackedStateRowRef {
291
- entity_pk,
292
- schema_key: "schema.unicode",
293
- file_id: Some("file-1"),
294
- snapshot_content,
295
- metadata,
296
- created_at: "2026-05-19T00:00:00.000Z",
297
- updated_at: "2026-05-19T00:00:01.000Z",
298
- global: false,
299
- branch_id: "branch-1",
300
- }
301
- }
302
-
303
- fn identity(entity_pk: EntityPk) -> UntrackedStateIdentity {
304
- UntrackedStateIdentity {
305
- branch_id: "branch-1".to_string(),
306
- schema_key: "schema.unicode".to_string(),
307
- entity_pk,
308
- file_id: Some("file-1".to_string()),
309
- }
310
- }
311
-
312
- #[test]
313
- fn payload_v1_roundtrips_with_key_identity() {
314
- let entity_pk = EntityPk::tuple(vec!["id-1".to_string(), "東京".to_string()])
315
- .expect("entity primary key should build");
316
- let bytes = encode_payload_ref(row_ref(
317
- &entity_pk,
318
- Some("{\"hello\":\"world\"}"),
319
- Some("{\"meta\":true}"),
320
- ))
321
- .expect("payload should encode");
322
-
323
- assert_eq!(&bytes[..4], b"LXUP");
324
- assert_eq!(bytes[4], 1);
325
-
326
- let decoded = decode_payload_with_identity(identity(entity_pk.clone()), &bytes)
327
- .expect("payload should decode");
328
- assert_eq!(decoded.entity_pk, entity_pk);
329
- assert_eq!(decoded.schema_key, "schema.unicode");
330
- assert_eq!(decoded.file_id.as_deref(), Some("file-1"));
331
- assert_eq!(
332
- decoded.snapshot_content.as_deref(),
333
- Some("{\"hello\":\"world\"}")
334
- );
335
- assert_eq!(decoded.metadata.as_deref(), Some("{\"meta\":true}"));
336
- assert_eq!(decoded.created_at, "2026-05-19T00:00:00.000Z");
337
- assert_eq!(decoded.updated_at, "2026-05-19T00:00:01.000Z");
338
- assert!(!decoded.global);
339
- assert_eq!(decoded.branch_id, "branch-1");
340
- }
341
-
342
- #[test]
343
- fn payload_v1_roundtrips_absent_optional_fields() {
344
- let entity_pk = EntityPk::single("id-1");
345
- let bytes =
346
- encode_payload_ref(row_ref(&entity_pk, None, None)).expect("payload should encode");
347
- let decoded = decode_payload_with_identity(identity(entity_pk), &bytes)
348
- .expect("payload should decode");
349
- assert_eq!(decoded.snapshot_content, None);
350
- assert_eq!(decoded.metadata, None);
351
- }
352
-
353
- #[test]
354
- fn payload_decode_rejects_invalid_identifier() {
355
- let entity_pk = EntityPk::single("id-1");
356
- let error = decode_payload_with_identity(identity(entity_pk), b"LXUSnot-payload")
357
- .expect_err("old full-row values are not accepted in v1 payload storage");
358
- assert!(error.to_string().contains("invalid payload identifier"));
359
- }
360
-
361
- #[test]
362
- fn payload_decode_rejects_unknown_branch() {
363
- let entity_pk = EntityPk::single("id-1");
364
- let mut bytes = encode_payload_ref(row_ref(&entity_pk, Some("{}"), None))
365
- .expect("payload should encode");
366
- bytes[4] = 2;
367
- let error = decode_payload_with_identity(identity(entity_pk), &bytes)
368
- .expect_err("unknown payload branch should fail");
369
- assert!(error.to_string().contains("unsupported branch 2"));
370
- }
371
-
372
- #[test]
373
- fn payload_decode_rejects_trailing_bytes() {
374
- let entity_pk = EntityPk::single("id-1");
375
- let mut bytes = encode_payload_ref(row_ref(&entity_pk, Some("{}"), None))
376
- .expect("payload should encode");
377
- bytes.push(0);
378
- let error = decode_payload_with_identity(identity(entity_pk), &bytes)
379
- .expect_err("trailing bytes should fail");
380
- assert!(error.to_string().contains("trailing bytes"));
381
- }
382
-
383
- #[test]
384
- fn payload_decode_rejects_truncated_string() {
385
- let entity_pk = EntityPk::single("id-1");
386
- let mut bytes = encode_payload_ref(row_ref(&entity_pk, Some("{}"), None))
387
- .expect("payload should encode");
388
- bytes.truncate(bytes.len() - 2);
389
- let error = decode_payload_with_identity(identity(entity_pk), &bytes)
390
- .expect_err("truncated payload should fail");
391
- assert!(error.to_string().contains("truncated"));
392
- }
393
- }
394
-
395
- #[allow(dead_code)]
396
- mod flatbuffer {
397
- #[derive(Copy, Clone, PartialEq)]
398
- pub(super) struct UntrackedStateRow<'a> {
399
- table: flatbuffers::Table<'a>,
400
- }
401
-
402
- impl<'a> flatbuffers::Follow<'a> for UntrackedStateRow<'a> {
403
- type Inner = UntrackedStateRow<'a>;
404
-
405
- #[inline]
406
- unsafe fn follow(buf: &'a [u8], loc: usize) -> Self::Inner {
407
- Self {
408
- table: unsafe { flatbuffers::Table::new(buf, loc) },
409
- }
410
- }
411
- }
412
-
413
- impl<'a> UntrackedStateRow<'a> {
414
- const VT_ENTITY_PK: flatbuffers::VOffsetT = 4;
415
- const VT_SCHEMA_KEY: flatbuffers::VOffsetT = 6;
416
- const VT_FILE_ID: flatbuffers::VOffsetT = 8;
417
- const VT_SNAPSHOT_CONTENT: flatbuffers::VOffsetT = 10;
418
- const VT_METADATA: flatbuffers::VOffsetT = 12;
419
- const VT_CREATED_AT: flatbuffers::VOffsetT = 14;
420
- const VT_UPDATED_AT: flatbuffers::VOffsetT = 16;
421
- const VT_GLOBAL: flatbuffers::VOffsetT = 18;
422
- const VT_BRANCH_ID: flatbuffers::VOffsetT = 20;
423
-
424
- #[inline]
425
- pub(super) fn entity_pk(&self) -> Option<&'a str> {
426
- unsafe {
427
- self.table
428
- .get::<flatbuffers::ForwardsUOffset<&str>>(Self::VT_ENTITY_PK, None)
429
- }
430
- }
431
-
432
- #[inline]
433
- pub(super) fn schema_key(&self) -> Option<&'a str> {
434
- unsafe {
435
- self.table
436
- .get::<flatbuffers::ForwardsUOffset<&str>>(Self::VT_SCHEMA_KEY, None)
437
- }
438
- }
439
-
440
- #[inline]
441
- pub(super) fn file_id(&self) -> Option<&'a str> {
442
- unsafe {
443
- self.table
444
- .get::<flatbuffers::ForwardsUOffset<&str>>(Self::VT_FILE_ID, None)
445
- }
446
- }
447
-
448
- #[inline]
449
- pub(super) fn snapshot_content(&self) -> Option<&'a str> {
450
- unsafe {
451
- self.table
452
- .get::<flatbuffers::ForwardsUOffset<&str>>(Self::VT_SNAPSHOT_CONTENT, None)
453
- }
454
- }
455
-
456
- #[inline]
457
- pub(super) fn metadata(&self) -> Option<&'a str> {
458
- unsafe {
459
- self.table
460
- .get::<flatbuffers::ForwardsUOffset<&str>>(Self::VT_METADATA, None)
461
- }
462
- }
463
-
464
- pub(super) fn created_at(&self) -> Option<&'a str> {
465
- unsafe {
466
- self.table
467
- .get::<flatbuffers::ForwardsUOffset<&str>>(Self::VT_CREATED_AT, None)
468
- }
469
- }
470
-
471
- #[inline]
472
- pub(super) fn updated_at(&self) -> Option<&'a str> {
473
- unsafe {
474
- self.table
475
- .get::<flatbuffers::ForwardsUOffset<&str>>(Self::VT_UPDATED_AT, None)
476
- }
477
- }
478
-
479
- #[inline]
480
- pub(super) fn global(&self) -> bool {
481
- unsafe { self.table.get::<bool>(Self::VT_GLOBAL, Some(false)) }.unwrap_or(false)
482
- }
483
-
484
- #[inline]
485
- pub(super) fn branch_id(&self) -> Option<&'a str> {
486
- unsafe {
487
- self.table
488
- .get::<flatbuffers::ForwardsUOffset<&str>>(Self::VT_BRANCH_ID, None)
489
- }
490
- }
491
- }
492
-
493
- impl flatbuffers::Verifiable for UntrackedStateRow<'_> {
494
- #[inline]
495
- fn run_verifier(
496
- verifier: &mut flatbuffers::Verifier,
497
- position: usize,
498
- ) -> Result<(), flatbuffers::InvalidFlatbuffer> {
499
- verifier
500
- .visit_table(position)?
501
- .visit_field::<flatbuffers::ForwardsUOffset<&str>>(
502
- "entity_pk",
503
- Self::VT_ENTITY_PK,
504
- true,
505
- )?
506
- .visit_field::<flatbuffers::ForwardsUOffset<&str>>(
507
- "schema_key",
508
- Self::VT_SCHEMA_KEY,
509
- true,
510
- )?
511
- .visit_field::<flatbuffers::ForwardsUOffset<&str>>(
512
- "file_id",
513
- Self::VT_FILE_ID,
514
- false,
515
- )?
516
- .visit_field::<flatbuffers::ForwardsUOffset<&str>>(
517
- "snapshot_content",
518
- Self::VT_SNAPSHOT_CONTENT,
519
- false,
520
- )?
521
- .visit_field::<flatbuffers::ForwardsUOffset<&str>>(
522
- "metadata",
523
- Self::VT_METADATA,
524
- false,
525
- )?
526
- .visit_field::<flatbuffers::ForwardsUOffset<&str>>(
527
- "created_at",
528
- Self::VT_CREATED_AT,
529
- true,
530
- )?
531
- .visit_field::<flatbuffers::ForwardsUOffset<&str>>(
532
- "updated_at",
533
- Self::VT_UPDATED_AT,
534
- true,
535
- )?
536
- .visit_field::<bool>("global", Self::VT_GLOBAL, false)?
537
- .visit_field::<flatbuffers::ForwardsUOffset<&str>>(
538
- "branch_id",
539
- Self::VT_BRANCH_ID,
540
- true,
541
- )?
542
- .finish();
543
- Ok(())
544
- }
545
- }
546
-
547
- #[cfg_attr(not(feature = "storage-benches"), allow(dead_code))]
548
- pub(super) struct UntrackedStateRowArgs<'a> {
549
- pub(super) entity_pk: flatbuffers::WIPOffset<&'a str>,
550
- pub(super) schema_key: flatbuffers::WIPOffset<&'a str>,
551
- pub(super) file_id: Option<flatbuffers::WIPOffset<&'a str>>,
552
- pub(super) snapshot_content: Option<flatbuffers::WIPOffset<&'a str>>,
553
- pub(super) metadata: Option<flatbuffers::WIPOffset<&'a str>>,
554
- pub(super) created_at: flatbuffers::WIPOffset<&'a str>,
555
- pub(super) updated_at: flatbuffers::WIPOffset<&'a str>,
556
- pub(super) global: bool,
557
- pub(super) branch_id: flatbuffers::WIPOffset<&'a str>,
558
- }
559
-
560
- #[cfg_attr(not(feature = "storage-benches"), allow(dead_code))]
561
- pub(super) fn create_untracked_state_row<'bldr: 'args, 'args: 'mut_bldr, 'mut_bldr>(
562
- builder: &'mut_bldr mut flatbuffers::FlatBufferBuilder<'bldr>,
563
- args: &'args UntrackedStateRowArgs<'args>,
564
- ) -> flatbuffers::WIPOffset<UntrackedStateRow<'bldr>> {
565
- let start = builder.start_table();
566
- builder.push_slot_always::<flatbuffers::WIPOffset<_>>(
567
- UntrackedStateRow::VT_BRANCH_ID,
568
- args.branch_id,
569
- );
570
- builder.push_slot::<bool>(UntrackedStateRow::VT_GLOBAL, args.global, false);
571
- builder.push_slot_always::<flatbuffers::WIPOffset<_>>(
572
- UntrackedStateRow::VT_UPDATED_AT,
573
- args.updated_at,
574
- );
575
- builder.push_slot_always::<flatbuffers::WIPOffset<_>>(
576
- UntrackedStateRow::VT_CREATED_AT,
577
- args.created_at,
578
- );
579
- if let Some(metadata) = args.metadata {
580
- builder.push_slot_always::<flatbuffers::WIPOffset<_>>(
581
- UntrackedStateRow::VT_METADATA,
582
- metadata,
583
- );
584
- }
585
- if let Some(snapshot_content) = args.snapshot_content {
586
- builder.push_slot_always::<flatbuffers::WIPOffset<_>>(
587
- UntrackedStateRow::VT_SNAPSHOT_CONTENT,
588
- snapshot_content,
589
- );
590
- }
591
- if let Some(file_id) = args.file_id {
592
- builder.push_slot_always::<flatbuffers::WIPOffset<_>>(
593
- UntrackedStateRow::VT_FILE_ID,
594
- file_id,
595
- );
596
- }
597
- builder.push_slot_always::<flatbuffers::WIPOffset<_>>(
598
- UntrackedStateRow::VT_SCHEMA_KEY,
599
- args.schema_key,
600
- );
601
- builder.push_slot_always::<flatbuffers::WIPOffset<_>>(
602
- UntrackedStateRow::VT_ENTITY_PK,
603
- args.entity_pk,
604
- );
605
- let offset = builder.end_table(start);
606
- flatbuffers::WIPOffset::new(offset.value())
607
- }
608
-
609
- #[inline]
610
- pub(super) fn root_as_untracked_state_row(
611
- bytes: &[u8],
612
- ) -> Result<UntrackedStateRow<'_>, flatbuffers::InvalidFlatbuffer> {
613
- flatbuffers::root::<UntrackedStateRow>(bytes)
614
- }
615
- }