@abloatai/ablo 0.35.0 → 0.37.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 (622) hide show
  1. package/AGENTS.md +2 -2
  2. package/CHANGELOG.md +71 -1929
  3. package/NOTICE +2 -2
  4. package/README.md +23 -532
  5. package/assets/banner.png +0 -0
  6. package/dist/auth.d.ts +2 -0
  7. package/dist/auth.d.ts.map +1 -0
  8. package/dist/auth.js +2 -0
  9. package/dist/auth.js.map +1 -0
  10. package/dist/client.d.ts +3 -0
  11. package/dist/client.d.ts.map +1 -0
  12. package/dist/client.js +3 -0
  13. package/dist/client.js.map +1 -0
  14. package/dist/coordination.d.ts +2 -0
  15. package/dist/coordination.d.ts.map +1 -0
  16. package/dist/coordination.js +2 -0
  17. package/dist/coordination.js.map +1 -0
  18. package/dist/index.d.ts +3 -112
  19. package/dist/index.d.ts.map +1 -0
  20. package/dist/index.js +3 -161
  21. package/dist/index.js.map +1 -0
  22. package/dist/react.d.ts +4 -0
  23. package/dist/react.d.ts.map +1 -0
  24. package/dist/react.js +3 -0
  25. package/dist/react.js.map +1 -0
  26. package/dist/schema.d.ts +2 -0
  27. package/dist/schema.d.ts.map +1 -0
  28. package/dist/schema.js +2 -0
  29. package/dist/schema.js.map +1 -0
  30. package/dist/server.d.ts +2 -0
  31. package/dist/server.d.ts.map +1 -0
  32. package/dist/server.js +2 -0
  33. package/dist/server.js.map +1 -0
  34. package/dist/source-conformance.d.ts +2 -0
  35. package/dist/source-conformance.d.ts.map +1 -0
  36. package/dist/source-conformance.js +2 -0
  37. package/dist/source-conformance.js.map +1 -0
  38. package/dist/source-drizzle.d.ts +2 -0
  39. package/dist/source-drizzle.d.ts.map +1 -0
  40. package/dist/source-drizzle.js +2 -0
  41. package/dist/source-drizzle.js.map +1 -0
  42. package/dist/source-kysely.d.ts +2 -0
  43. package/dist/source-kysely.d.ts.map +1 -0
  44. package/dist/source-kysely.js +2 -0
  45. package/dist/source-kysely.js.map +1 -0
  46. package/dist/source-next.d.ts +2 -0
  47. package/dist/source-next.d.ts.map +1 -0
  48. package/dist/source-next.js +2 -0
  49. package/dist/source-next.js.map +1 -0
  50. package/dist/source.d.ts +2 -0
  51. package/dist/source.d.ts.map +1 -0
  52. package/dist/source.js +2 -0
  53. package/dist/source.js.map +1 -0
  54. package/dist/wire.d.ts +2 -0
  55. package/dist/wire.d.ts.map +1 -0
  56. package/dist/wire.js +2 -0
  57. package/dist/wire.js.map +1 -0
  58. package/docs/agents.md +2 -2
  59. package/docs/api-keys.md +13 -12
  60. package/docs/api.md +15 -53
  61. package/docs/audit.md +4 -3
  62. package/docs/cli.md +11 -11
  63. package/docs/client-behavior.md +9 -9
  64. package/docs/concurrency-convention.md +28 -42
  65. package/docs/coordination.md +228 -86
  66. package/docs/data-sources.md +5 -5
  67. package/docs/debugging.md +34 -12
  68. package/docs/deployment.md +8 -8
  69. package/docs/examples/agent-human.md +4 -4
  70. package/docs/examples/ai-sdk-tool.md +1 -1
  71. package/docs/examples/existing-python-backend.md +15 -4
  72. package/docs/examples/nextjs.md +27 -6
  73. package/docs/examples/scoped-agent.md +3 -3
  74. package/docs/examples/server-agent.md +2 -2
  75. package/docs/groups.md +57 -3
  76. package/docs/guarantees.md +37 -10
  77. package/docs/how-it-works.md +32 -8
  78. package/docs/idempotency.md +6 -6
  79. package/docs/identity.md +24 -24
  80. package/docs/index.md +8 -8
  81. package/docs/integration-guide.md +38 -16
  82. package/docs/internal/README.md +18 -0
  83. package/docs/internal/agent-fleet-coordination-design.md +171 -0
  84. package/docs/internal/agent-orchestration.md +58 -0
  85. package/docs/internal/commit-identifiers.md +91 -0
  86. package/docs/internal/concurrency-open-decisions.md +37 -0
  87. package/docs/internal/data-source-reverse-channel.md +150 -0
  88. package/docs/internal/per-field-conflict-detection.md +165 -0
  89. package/docs/internal/postgres-replication.md +64 -0
  90. package/docs/internal/serializable-schema.md +119 -0
  91. package/docs/internal/structure.md +32 -0
  92. package/docs/mcp.md +9 -9
  93. package/docs/migration.md +37 -18
  94. package/docs/projects.md +1 -1
  95. package/docs/quickstart.md +2 -2
  96. package/docs/react.md +24 -13
  97. package/docs/schema-contract.md +3 -3
  98. package/docs/sessions.md +91 -37
  99. package/docs/webhooks.md +9 -9
  100. package/examples/README.md +2 -2
  101. package/examples/data-source/README.md +1 -1
  102. package/examples/data-source/ablo-driver.ts +1 -1
  103. package/examples/data-source/customer-server.ts +1 -1
  104. package/examples/data-source/run.ts +1 -1
  105. package/examples/data-source/schema.ts +1 -1
  106. package/examples/quickstart.ts +2 -2
  107. package/llms.txt +12 -12
  108. package/package.json +64 -174
  109. package/dist/BaseSyncedStore.d.ts +0 -823
  110. package/dist/BaseSyncedStore.js +0 -1955
  111. package/dist/Database.d.ts +0 -335
  112. package/dist/Database.js +0 -1500
  113. package/dist/InstanceCache.d.ts +0 -233
  114. package/dist/InstanceCache.js +0 -1164
  115. package/dist/LazyReferenceCollection.d.ts +0 -177
  116. package/dist/LazyReferenceCollection.js +0 -461
  117. package/dist/Model.d.ts +0 -444
  118. package/dist/Model.js +0 -909
  119. package/dist/ModelRegistry.d.ts +0 -221
  120. package/dist/ModelRegistry.js +0 -537
  121. package/dist/NetworkMonitor.d.ts +0 -26
  122. package/dist/NetworkMonitor.js +0 -77
  123. package/dist/RuntimeContext.d.ts +0 -52
  124. package/dist/RuntimeContext.js +0 -80
  125. package/dist/SyncClient.d.ts +0 -551
  126. package/dist/SyncClient.js +0 -2199
  127. package/dist/adapters/alwaysOnline.d.ts +0 -14
  128. package/dist/adapters/alwaysOnline.js +0 -17
  129. package/dist/adapters/inMemoryStorage.d.ts +0 -31
  130. package/dist/adapters/inMemoryStorage.js +0 -110
  131. package/dist/ai-sdk/coordinatedTool.d.ts +0 -120
  132. package/dist/ai-sdk/coordinatedTool.js +0 -134
  133. package/dist/ai-sdk/coordinationContext.d.ts +0 -46
  134. package/dist/ai-sdk/coordinationContext.js +0 -106
  135. package/dist/ai-sdk/index.d.ts +0 -121
  136. package/dist/ai-sdk/index.js +0 -121
  137. package/dist/ai-sdk/wrap.d.ts +0 -65
  138. package/dist/ai-sdk/wrap.js +0 -39
  139. package/dist/auth/index.d.ts +0 -1
  140. package/dist/auth/index.js +0 -8
  141. package/dist/batching/index.d.ts +0 -55
  142. package/dist/batching/index.js +0 -147
  143. package/dist/cli.cjs +0 -288600
  144. package/dist/client/Ablo.d.ts +0 -231
  145. package/dist/client/Ablo.js +0 -149
  146. package/dist/client/abloClient.d.ts +0 -309
  147. package/dist/client/abloClient.js +0 -13
  148. package/dist/client/clientPrelude.d.ts +0 -52
  149. package/dist/client/clientPrelude.js +0 -60
  150. package/dist/client/consoleLogger.d.ts +0 -35
  151. package/dist/client/consoleLogger.js +0 -44
  152. package/dist/client/coreClient.d.ts +0 -60
  153. package/dist/client/coreClient.js +0 -118
  154. package/dist/client/createInternalComponents.d.ts +0 -46
  155. package/dist/client/createInternalComponents.js +0 -92
  156. package/dist/client/createModelProxy.d.ts +0 -228
  157. package/dist/client/createModelProxy.js +0 -818
  158. package/dist/client/humans.d.ts +0 -48
  159. package/dist/client/humans.js +0 -52
  160. package/dist/client/modelRegistration.d.ts +0 -10
  161. package/dist/client/modelRegistration.js +0 -312
  162. package/dist/client/options.d.ts +0 -461
  163. package/dist/client/options.js +0 -7
  164. package/dist/client/reactiveEngine.d.ts +0 -48
  165. package/dist/client/reactiveEngine.js +0 -910
  166. package/dist/client/resourceTypes.d.ts +0 -12
  167. package/dist/client/resourceTypes.js +0 -10
  168. package/dist/client/schemaConfig.d.ts +0 -44
  169. package/dist/client/schemaConfig.js +0 -185
  170. package/dist/client/validateAbloOptions.d.ts +0 -42
  171. package/dist/client/validateAbloOptions.js +0 -43
  172. package/dist/client/wsMutationExecutor.d.ts +0 -27
  173. package/dist/client/wsMutationExecutor.js +0 -72
  174. package/dist/context.d.ts +0 -29
  175. package/dist/context.js +0 -58
  176. package/dist/coordination/ClaimLog.d.ts +0 -26
  177. package/dist/coordination/ClaimLog.js +0 -32
  178. package/dist/coordination/index.d.ts +0 -1
  179. package/dist/coordination/index.js +0 -8
  180. package/dist/core/DatabaseManager.d.ts +0 -105
  181. package/dist/core/DatabaseManager.js +0 -387
  182. package/dist/core/QueryProcessor.d.ts +0 -75
  183. package/dist/core/QueryProcessor.js +0 -255
  184. package/dist/core/QueryView.d.ts +0 -79
  185. package/dist/core/QueryView.js +0 -218
  186. package/dist/core/StoreManager.d.ts +0 -112
  187. package/dist/core/StoreManager.js +0 -302
  188. package/dist/core/ViewRegistry.d.ts +0 -20
  189. package/dist/core/ViewRegistry.js +0 -55
  190. package/dist/core/index.d.ts +0 -33
  191. package/dist/core/index.js +0 -48
  192. package/dist/core/openIDBWithTimeout.d.ts +0 -65
  193. package/dist/core/openIDBWithTimeout.js +0 -153
  194. package/dist/core/queryUtils.d.ts +0 -45
  195. package/dist/core/queryUtils.js +0 -69
  196. package/dist/core/storeContract.d.ts +0 -145
  197. package/dist/core/storeContract.js +0 -12
  198. package/dist/docs/catalog.d.ts +0 -72
  199. package/dist/docs/catalog.js +0 -227
  200. package/dist/docs/index.d.ts +0 -10
  201. package/dist/docs/index.js +0 -10
  202. package/dist/environment.d.ts +0 -1
  203. package/dist/environment.js +0 -8
  204. package/dist/interfaces/index.d.ts +0 -311
  205. package/dist/interfaces/index.js +0 -9
  206. package/dist/keys/index.d.ts +0 -1
  207. package/dist/keys/index.js +0 -8
  208. package/dist/mutators/RecordingMutation.d.ts +0 -36
  209. package/dist/mutators/RecordingMutation.js +0 -182
  210. package/dist/mutators/Transaction.d.ts +0 -40
  211. package/dist/mutators/Transaction.js +0 -58
  212. package/dist/mutators/UndoManager.d.ts +0 -258
  213. package/dist/mutators/UndoManager.js +0 -658
  214. package/dist/mutators/defineMutators.d.ts +0 -60
  215. package/dist/mutators/defineMutators.js +0 -18
  216. package/dist/mutators/inverseOp.d.ts +0 -126
  217. package/dist/mutators/inverseOp.js +0 -71
  218. package/dist/mutators/mutateActions.d.ts +0 -45
  219. package/dist/mutators/mutateActions.js +0 -105
  220. package/dist/mutators/readerActions.d.ts +0 -33
  221. package/dist/mutators/readerActions.js +0 -57
  222. package/dist/mutators/undoApply.d.ts +0 -51
  223. package/dist/mutators/undoApply.js +0 -117
  224. package/dist/policy/index.d.ts +0 -21
  225. package/dist/policy/index.js +0 -20
  226. package/dist/query/client.d.ts +0 -61
  227. package/dist/query/client.js +0 -137
  228. package/dist/query/types.d.ts +0 -85
  229. package/dist/query/types.js +0 -16
  230. package/dist/react/AbloProvider.d.ts +0 -230
  231. package/dist/react/AbloProvider.js +0 -455
  232. package/dist/react/ClientSideSuspense.d.ts +0 -36
  233. package/dist/react/ClientSideSuspense.js +0 -17
  234. package/dist/react/DefaultFallback.d.ts +0 -24
  235. package/dist/react/DefaultFallback.js +0 -43
  236. package/dist/react/context.d.ts +0 -55
  237. package/dist/react/context.js +0 -29
  238. package/dist/react/index.d.ts +0 -61
  239. package/dist/react/index.js +0 -66
  240. package/dist/react/internalContext.d.ts +0 -33
  241. package/dist/react/internalContext.js +0 -3
  242. package/dist/react/useAblo.d.ts +0 -75
  243. package/dist/react/useAblo.js +0 -102
  244. package/dist/react/useCurrentUserId.d.ts +0 -22
  245. package/dist/react/useCurrentUserId.js +0 -34
  246. package/dist/react/useErrorListener.d.ts +0 -20
  247. package/dist/react/useErrorListener.js +0 -38
  248. package/dist/react/useMutationFailureListener.d.ts +0 -26
  249. package/dist/react/useMutationFailureListener.js +0 -38
  250. package/dist/react/useMutators.d.ts +0 -56
  251. package/dist/react/useMutators.js +0 -84
  252. package/dist/react/useReactive.d.ts +0 -35
  253. package/dist/react/useReactive.js +0 -123
  254. package/dist/react/useSyncStatus.d.ts +0 -59
  255. package/dist/react/useSyncStatus.js +0 -76
  256. package/dist/react/useUndoScope.d.ts +0 -34
  257. package/dist/react/useUndoScope.js +0 -81
  258. package/dist/schema/coordination.d.ts +0 -112
  259. package/dist/schema/coordination.js +0 -129
  260. package/dist/schema/ddl.d.ts +0 -97
  261. package/dist/schema/ddl.js +0 -491
  262. package/dist/schema/ddlLock.d.ts +0 -35
  263. package/dist/schema/ddlLock.js +0 -46
  264. package/dist/schema/diff.d.ts +0 -225
  265. package/dist/schema/diff.js +0 -289
  266. package/dist/schema/generate.d.ts +0 -19
  267. package/dist/schema/generate.js +0 -86
  268. package/dist/schema/index.d.ts +0 -41
  269. package/dist/schema/index.js +0 -76
  270. package/dist/schema/queries.d.ts +0 -201
  271. package/dist/schema/queries.js +0 -144
  272. package/dist/schema/select.d.ts +0 -40
  273. package/dist/schema/select.js +0 -87
  274. package/dist/schema/serialize.d.ts +0 -115
  275. package/dist/schema/serialize.js +0 -262
  276. package/dist/schema/sugar.d.ts +0 -109
  277. package/dist/schema/sugar.js +0 -83
  278. package/dist/schema/syncDeltaRow.d.ts +0 -6
  279. package/dist/schema/syncDeltaRow.js +0 -6
  280. package/dist/server/adapter.d.ts +0 -173
  281. package/dist/server/adapter.js +0 -18
  282. package/dist/server/commit.d.ts +0 -107
  283. package/dist/server/commit.js +0 -1
  284. package/dist/server/index.d.ts +0 -14
  285. package/dist/server/index.js +0 -2
  286. package/dist/server/readConfig.d.ts +0 -80
  287. package/dist/server/readConfig.js +0 -8
  288. package/dist/server/storageMode.d.ts +0 -23
  289. package/dist/server/storageMode.js +0 -17
  290. package/dist/source/adapter.d.ts +0 -81
  291. package/dist/source/adapter.js +0 -22
  292. package/dist/source/adapters/drizzle.d.ts +0 -48
  293. package/dist/source/adapters/drizzle.js +0 -219
  294. package/dist/source/adapters/kysely.d.ts +0 -42
  295. package/dist/source/adapters/kysely.js +0 -205
  296. package/dist/source/adapters/kyselyMutationCore.d.ts +0 -76
  297. package/dist/source/adapters/kyselyMutationCore.js +0 -125
  298. package/dist/source/adapters/memory.d.ts +0 -13
  299. package/dist/source/adapters/memory.js +0 -130
  300. package/dist/source/adapters/prisma.d.ts +0 -63
  301. package/dist/source/adapters/prisma.js +0 -202
  302. package/dist/source/conformance.d.ts +0 -37
  303. package/dist/source/conformance.js +0 -215
  304. package/dist/source/connector.d.ts +0 -95
  305. package/dist/source/connector.js +0 -266
  306. package/dist/source/connectorProtocol.d.ts +0 -154
  307. package/dist/source/connectorProtocol.js +0 -163
  308. package/dist/source/contract.d.ts +0 -195
  309. package/dist/source/contract.js +0 -164
  310. package/dist/source/factory.d.ts +0 -92
  311. package/dist/source/factory.js +0 -286
  312. package/dist/source/footprint.d.ts +0 -111
  313. package/dist/source/footprint.js +0 -0
  314. package/dist/source/idempotency.d.ts +0 -61
  315. package/dist/source/idempotency.js +0 -144
  316. package/dist/source/index.d.ts +0 -23
  317. package/dist/source/index.js +0 -30
  318. package/dist/source/migrations.d.ts +0 -21
  319. package/dist/source/migrations.js +0 -103
  320. package/dist/source/next.d.ts +0 -32
  321. package/dist/source/next.js +0 -25
  322. package/dist/source/pushQueue.d.ts +0 -134
  323. package/dist/source/pushQueue.js +0 -256
  324. package/dist/source/signing.d.ts +0 -92
  325. package/dist/source/signing.js +0 -162
  326. package/dist/source/types.d.ts +0 -401
  327. package/dist/source/types.js +0 -59
  328. package/dist/stores/ObjectStore.d.ts +0 -115
  329. package/dist/stores/ObjectStore.js +0 -393
  330. package/dist/stores/ObjectStoreContract.d.ts +0 -38
  331. package/dist/stores/ObjectStoreContract.js +0 -1
  332. package/dist/stores/SyncActionStore.d.ts +0 -97
  333. package/dist/stores/SyncActionStore.js +0 -504
  334. package/dist/stores/syncAction.d.ts +0 -26
  335. package/dist/stores/syncAction.js +0 -16
  336. package/dist/surface.d.ts +0 -36
  337. package/dist/surface.js +0 -75
  338. package/dist/sync/BootstrapFetcher.d.ts +0 -280
  339. package/dist/sync/BootstrapFetcher.js +0 -962
  340. package/dist/sync/ConnectionManager.d.ts +0 -8
  341. package/dist/sync/ConnectionManager.js +0 -8
  342. package/dist/sync/OnDemandLoader.d.ts +0 -228
  343. package/dist/sync/OnDemandLoader.js +0 -742
  344. package/dist/sync/SubscriptionManager.d.ts +0 -159
  345. package/dist/sync/SubscriptionManager.js +0 -243
  346. package/dist/sync/SyncWebSocket.d.ts +0 -173
  347. package/dist/sync/SyncWebSocket.js +0 -438
  348. package/dist/sync/awaitClaimGrant.d.ts +0 -6
  349. package/dist/sync/awaitClaimGrant.js +0 -6
  350. package/dist/sync/bootstrapApply.d.ts +0 -70
  351. package/dist/sync/bootstrapApply.js +0 -73
  352. package/dist/sync/commitFrames.d.ts +0 -8
  353. package/dist/sync/commitFrames.js +0 -8
  354. package/dist/sync/contextPorts.d.ts +0 -18
  355. package/dist/sync/contextPorts.js +0 -31
  356. package/dist/sync/createClaimStream.d.ts +0 -7
  357. package/dist/sync/createClaimStream.js +0 -7
  358. package/dist/sync/createPresenceStream.d.ts +0 -69
  359. package/dist/sync/createPresenceStream.js +0 -200
  360. package/dist/sync/createSnapshot.d.ts +0 -29
  361. package/dist/sync/createSnapshot.js +0 -118
  362. package/dist/sync/credentialLifecycle.d.ts +0 -7
  363. package/dist/sync/credentialLifecycle.js +0 -7
  364. package/dist/sync/deltaPipeline.d.ts +0 -113
  365. package/dist/sync/deltaPipeline.js +0 -261
  366. package/dist/sync/groupChange.d.ts +0 -113
  367. package/dist/sync/groupChange.js +0 -242
  368. package/dist/sync/participants.d.ts +0 -115
  369. package/dist/sync/participants.js +0 -344
  370. package/dist/sync/persistedPrefix.d.ts +0 -12
  371. package/dist/sync/persistedPrefix.js +0 -22
  372. package/dist/sync/schemaDrift.d.ts +0 -55
  373. package/dist/sync/schemaDrift.js +0 -53
  374. package/dist/sync/schemas.d.ts +0 -70
  375. package/dist/sync/schemas.js +0 -94
  376. package/dist/sync/syncCursor.d.ts +0 -40
  377. package/dist/sync/syncCursor.js +0 -55
  378. package/dist/sync/syncPlan.d.ts +0 -54
  379. package/dist/sync/syncPlan.js +0 -50
  380. package/dist/sync/wsFrameHandlers.d.ts +0 -8
  381. package/dist/sync/wsFrameHandlers.js +0 -8
  382. package/dist/testing/fixtures/bootstrap.d.ts +0 -49
  383. package/dist/testing/fixtures/bootstrap.js +0 -59
  384. package/dist/testing/fixtures/deltas.d.ts +0 -83
  385. package/dist/testing/fixtures/deltas.js +0 -136
  386. package/dist/testing/fixtures/httpResponses.d.ts +0 -70
  387. package/dist/testing/fixtures/httpResponses.js +0 -90
  388. package/dist/testing/fixtures/models.d.ts +0 -83
  389. package/dist/testing/fixtures/models.js +0 -272
  390. package/dist/testing/helpers/reactWrapper.d.ts +0 -69
  391. package/dist/testing/helpers/reactWrapper.js +0 -67
  392. package/dist/testing/helpers/syncEngineHarness.d.ts +0 -54
  393. package/dist/testing/helpers/syncEngineHarness.js +0 -73
  394. package/dist/testing/helpers/wait.d.ts +0 -30
  395. package/dist/testing/helpers/wait.js +0 -49
  396. package/dist/testing/index.d.ts +0 -23
  397. package/dist/testing/index.js +0 -33
  398. package/dist/testing/mocks/FakeDatabase.d.ts +0 -18
  399. package/dist/testing/mocks/FakeDatabase.js +0 -10
  400. package/dist/testing/mocks/MockMutationExecutor.d.ts +0 -87
  401. package/dist/testing/mocks/MockMutationExecutor.js +0 -186
  402. package/dist/testing/mocks/MockNetworkMonitor.d.ts +0 -20
  403. package/dist/testing/mocks/MockNetworkMonitor.js +0 -46
  404. package/dist/testing/mocks/MockSyncContext.d.ts +0 -51
  405. package/dist/testing/mocks/MockSyncContext.js +0 -72
  406. package/dist/testing/mocks/MockSyncStore.d.ts +0 -88
  407. package/dist/testing/mocks/MockSyncStore.js +0 -171
  408. package/dist/testing/mocks/MockWebSocket.d.ts +0 -71
  409. package/dist/testing/mocks/MockWebSocket.js +0 -118
  410. package/dist/transaction/ablo.d.ts +0 -88
  411. package/dist/transaction/ablo.js +0 -33
  412. package/dist/transaction/auth/apiKey.d.ts +0 -152
  413. package/dist/transaction/auth/apiKey.js +0 -419
  414. package/dist/transaction/auth/bootstrapScope.d.ts +0 -15
  415. package/dist/transaction/auth/bootstrapScope.js +0 -1
  416. package/dist/transaction/auth/capability.d.ts +0 -177
  417. package/dist/transaction/auth/capability.js +0 -199
  418. package/dist/transaction/auth/credentialEndpoint.d.ts +0 -61
  419. package/dist/transaction/auth/credentialEndpoint.js +0 -86
  420. package/dist/transaction/auth/credentialPolicy.d.ts +0 -148
  421. package/dist/transaction/auth/credentialPolicy.js +0 -125
  422. package/dist/transaction/auth/credentialSource.d.ts +0 -30
  423. package/dist/transaction/auth/credentialSource.js +0 -55
  424. package/dist/transaction/auth/hostedEndpoints.d.ts +0 -21
  425. package/dist/transaction/auth/hostedEndpoints.js +0 -21
  426. package/dist/transaction/auth/identity.d.ts +0 -55
  427. package/dist/transaction/auth/identity.js +0 -210
  428. package/dist/transaction/auth/index.d.ts +0 -162
  429. package/dist/transaction/auth/index.js +0 -304
  430. package/dist/transaction/auth/schemas.d.ts +0 -59
  431. package/dist/transaction/auth/schemas.js +0 -85
  432. package/dist/transaction/auth/sessionMint.d.ts +0 -28
  433. package/dist/transaction/auth/sessionMint.js +0 -85
  434. package/dist/transaction/coordination/awaitClaimGrant.d.ts +0 -49
  435. package/dist/transaction/coordination/awaitClaimGrant.js +0 -112
  436. package/dist/transaction/coordination/claimHeartbeatLoop.d.ts +0 -50
  437. package/dist/transaction/coordination/claimHeartbeatLoop.js +0 -88
  438. package/dist/transaction/coordination/claimMeta.d.ts +0 -49
  439. package/dist/transaction/coordination/claimMeta.js +0 -52
  440. package/dist/transaction/coordination/createClaimStream.d.ts +0 -64
  441. package/dist/transaction/coordination/createClaimStream.js +0 -475
  442. package/dist/transaction/coordination/events.d.ts +0 -74
  443. package/dist/transaction/coordination/events.js +0 -7
  444. package/dist/transaction/coordination/index.d.ts +0 -19
  445. package/dist/transaction/coordination/index.js +0 -44
  446. package/dist/transaction/coordination/locator.d.ts +0 -83
  447. package/dist/transaction/coordination/locator.js +0 -82
  448. package/dist/transaction/coordination/schema.d.ts +0 -1473
  449. package/dist/transaction/coordination/schema.js +0 -1013
  450. package/dist/transaction/coordination/targetConflict.d.ts +0 -2
  451. package/dist/transaction/coordination/targetConflict.js +0 -103
  452. package/dist/transaction/coordination/trace.d.ts +0 -78
  453. package/dist/transaction/coordination/trace.js +0 -138
  454. package/dist/transaction/durableWrites.d.ts +0 -62
  455. package/dist/transaction/durableWrites.js +0 -71
  456. package/dist/transaction/environment.d.ts +0 -105
  457. package/dist/transaction/environment.js +0 -108
  458. package/dist/transaction/errorCodes.d.ts +0 -403
  459. package/dist/transaction/errorCodes.js +0 -480
  460. package/dist/transaction/errors.d.ts +0 -428
  461. package/dist/transaction/errors.js +0 -686
  462. package/dist/transaction/index.d.ts +0 -20
  463. package/dist/transaction/index.js +0 -20
  464. package/dist/transaction/keys/index.d.ts +0 -87
  465. package/dist/transaction/keys/index.js +0 -207
  466. package/dist/transaction/log/syncDeltaRow.d.ts +0 -158
  467. package/dist/transaction/log/syncDeltaRow.js +0 -95
  468. package/dist/transaction/logPosition.d.ts +0 -97
  469. package/dist/transaction/logPosition.js +0 -125
  470. package/dist/transaction/logger.d.ts +0 -16
  471. package/dist/transaction/logger.js +0 -7
  472. package/dist/transaction/observability.d.ts +0 -53
  473. package/dist/transaction/observability.js +0 -19
  474. package/dist/transaction/persistence.d.ts +0 -12
  475. package/dist/transaction/persistence.js +0 -11
  476. package/dist/transaction/plugin.d.ts +0 -192
  477. package/dist/transaction/plugin.js +0 -87
  478. package/dist/transaction/policy/types.d.ts +0 -217
  479. package/dist/transaction/policy/types.js +0 -126
  480. package/dist/transaction/resources/functionalUpdate.d.ts +0 -79
  481. package/dist/transaction/resources/functionalUpdate.js +0 -87
  482. package/dist/transaction/resources/httpResources.d.ts +0 -266
  483. package/dist/transaction/resources/httpResources.js +0 -7
  484. package/dist/transaction/resources/modelOperations.d.ts +0 -319
  485. package/dist/transaction/resources/modelOperations.js +0 -12
  486. package/dist/transaction/resources/mutationOptions.d.ts +0 -66
  487. package/dist/transaction/resources/mutationOptions.js +0 -9
  488. package/dist/transaction/resources/where.d.ts +0 -85
  489. package/dist/transaction/resources/where.js +0 -70
  490. package/dist/transaction/resources/writeOptionsSchema.d.ts +0 -47
  491. package/dist/transaction/resources/writeOptionsSchema.js +0 -73
  492. package/dist/transaction/schema/field.d.ts +0 -126
  493. package/dist/transaction/schema/field.js +0 -265
  494. package/dist/transaction/schema/loadStrategy.d.ts +0 -45
  495. package/dist/transaction/schema/loadStrategy.js +0 -46
  496. package/dist/transaction/schema/model.d.ts +0 -379
  497. package/dist/transaction/schema/model.js +0 -123
  498. package/dist/transaction/schema/openapi.d.ts +0 -57
  499. package/dist/transaction/schema/openapi.js +0 -340
  500. package/dist/transaction/schema/relation.d.ts +0 -199
  501. package/dist/transaction/schema/relation.js +0 -104
  502. package/dist/transaction/schema/residency.d.ts +0 -29
  503. package/dist/transaction/schema/residency.js +0 -25
  504. package/dist/transaction/schema/roles.d.ts +0 -249
  505. package/dist/transaction/schema/roles.js +0 -230
  506. package/dist/transaction/schema/schema.d.ts +0 -324
  507. package/dist/transaction/schema/schema.js +0 -305
  508. package/dist/transaction/schema/tenancy.d.ts +0 -139
  509. package/dist/transaction/schema/tenancy.js +0 -190
  510. package/dist/transaction/transactionLayer.d.ts +0 -82
  511. package/dist/transaction/transactionLayer.js +0 -24
  512. package/dist/transaction/transactions/settlement/commitEnvelope.d.ts +0 -143
  513. package/dist/transaction/transactions/settlement/commitEnvelope.js +0 -161
  514. package/dist/transaction/transactions/settlement/httpCommitEnvelope.d.ts +0 -53
  515. package/dist/transaction/transactions/settlement/httpCommitEnvelope.js +0 -207
  516. package/dist/transaction/transactions/settlement/idempotencyKey.d.ts +0 -10
  517. package/dist/transaction/transactions/settlement/idempotencyKey.js +0 -9
  518. package/dist/transaction/transactions/settlement/pendingWrite.d.ts +0 -112
  519. package/dist/transaction/transactions/settlement/pendingWrite.js +0 -20
  520. package/dist/transaction/transport/commitFrames.d.ts +0 -90
  521. package/dist/transaction/transport/commitFrames.js +0 -134
  522. package/dist/transaction/transport/connectionManager.d.ts +0 -215
  523. package/dist/transaction/transport/connectionManager.js +0 -673
  524. package/dist/transaction/transport/credentialLifecycle.d.ts +0 -177
  525. package/dist/transaction/transport/credentialLifecycle.js +0 -324
  526. package/dist/transaction/transport/heartbeat.d.ts +0 -65
  527. package/dist/transaction/transport/heartbeat.js +0 -93
  528. package/dist/transaction/transport/httpClient.d.ts +0 -123
  529. package/dist/transaction/transport/httpClient.js +0 -145
  530. package/dist/transaction/transport/httpOptions.d.ts +0 -33
  531. package/dist/transaction/transport/httpOptions.js +0 -12
  532. package/dist/transaction/transport/httpTransport.d.ts +0 -8
  533. package/dist/transaction/transport/httpTransport.js +0 -1276
  534. package/dist/transaction/transport/networkProbe.d.ts +0 -84
  535. package/dist/transaction/transport/networkProbe.js +0 -207
  536. package/dist/transaction/transport/wsFrameHandlers.d.ts +0 -128
  537. package/dist/transaction/transport/wsFrameHandlers.js +0 -429
  538. package/dist/transaction/transport/wsTransport.d.ts +0 -576
  539. package/dist/transaction/transport/wsTransport.js +0 -1017
  540. package/dist/transaction/types/assertExact.d.ts +0 -17
  541. package/dist/transaction/types/assertExact.js +0 -1
  542. package/dist/transaction/types/global.d.ts +0 -107
  543. package/dist/transaction/types/global.js +0 -40
  544. package/dist/transaction/types/index.d.ts +0 -205
  545. package/dist/transaction/types/index.js +0 -56
  546. package/dist/transaction/types/modelData.d.ts +0 -10
  547. package/dist/transaction/types/modelData.js +0 -9
  548. package/dist/transaction/types/participant.d.ts +0 -20
  549. package/dist/transaction/types/participant.js +0 -10
  550. package/dist/transaction/types/streams.d.ts +0 -540
  551. package/dist/transaction/types/streams.js +0 -11
  552. package/dist/transaction/utils/asyncIterator.d.ts +0 -34
  553. package/dist/transaction/utils/asyncIterator.js +0 -135
  554. package/dist/transaction/utils/duration.d.ts +0 -25
  555. package/dist/transaction/utils/duration.js +0 -45
  556. package/dist/transaction/utils/json.d.ts +0 -57
  557. package/dist/transaction/utils/json.js +0 -276
  558. package/dist/transaction/wire/accountResponses.d.ts +0 -351
  559. package/dist/transaction/wire/accountResponses.js +0 -255
  560. package/dist/transaction/wire/auth.d.ts +0 -49
  561. package/dist/transaction/wire/auth.js +0 -57
  562. package/dist/transaction/wire/bootstrapReason.d.ts +0 -9
  563. package/dist/transaction/wire/bootstrapReason.js +0 -8
  564. package/dist/transaction/wire/claimEvent.d.ts +0 -76
  565. package/dist/transaction/wire/claimEvent.js +0 -73
  566. package/dist/transaction/wire/claims.d.ts +0 -463
  567. package/dist/transaction/wire/claims.js +0 -229
  568. package/dist/transaction/wire/commit.d.ts +0 -603
  569. package/dist/transaction/wire/commit.js +0 -321
  570. package/dist/transaction/wire/delta.d.ts +0 -250
  571. package/dist/transaction/wire/delta.js +0 -147
  572. package/dist/transaction/wire/errorEnvelope.d.ts +0 -72
  573. package/dist/transaction/wire/errorEnvelope.js +0 -123
  574. package/dist/transaction/wire/feedCursor.d.ts +0 -60
  575. package/dist/transaction/wire/feedCursor.js +0 -82
  576. package/dist/transaction/wire/feedEvent.d.ts +0 -177
  577. package/dist/transaction/wire/feedEvent.js +0 -39
  578. package/dist/transaction/wire/frames.d.ts +0 -194
  579. package/dist/transaction/wire/frames.js +0 -50
  580. package/dist/transaction/wire/inboundFrames.d.ts +0 -552
  581. package/dist/transaction/wire/inboundFrames.js +0 -116
  582. package/dist/transaction/wire/index.d.ts +0 -50
  583. package/dist/transaction/wire/index.js +0 -74
  584. package/dist/transaction/wire/listEnvelope.d.ts +0 -37
  585. package/dist/transaction/wire/listEnvelope.js +0 -42
  586. package/dist/transaction/wire/modelResponses.d.ts +0 -85
  587. package/dist/transaction/wire/modelResponses.js +0 -43
  588. package/dist/transaction/wire/protocol.d.ts +0 -38
  589. package/dist/transaction/wire/protocol.js +0 -38
  590. package/dist/transaction/wire/protocolVersion.d.ts +0 -73
  591. package/dist/transaction/wire/protocolVersion.js +0 -83
  592. package/dist/transactions/mutations/MutationQueue.d.ts +0 -655
  593. package/dist/transactions/mutations/MutationQueue.js +0 -2797
  594. package/dist/transactions/mutations/MutationStore.d.ts +0 -20
  595. package/dist/transactions/mutations/MutationStore.js +0 -53
  596. package/dist/transactions/mutations/UnconfirmedWrites.d.ts +0 -82
  597. package/dist/transactions/mutations/UnconfirmedWrites.js +0 -104
  598. package/dist/transactions/mutations/coalesceRules.d.ts +0 -58
  599. package/dist/transactions/mutations/coalesceRules.js +0 -140
  600. package/dist/transactions/mutations/commitLatency.d.ts +0 -52
  601. package/dist/transactions/mutations/commitLatency.js +0 -130
  602. package/dist/transactions/mutations/commitOutboxStore.d.ts +0 -28
  603. package/dist/transactions/mutations/commitOutboxStore.js +0 -26
  604. package/dist/transactions/mutations/commitPayload.d.ts +0 -164
  605. package/dist/transactions/mutations/commitPayload.js +0 -152
  606. package/dist/transactions/mutations/deltaConfirmation.d.ts +0 -59
  607. package/dist/transactions/mutations/deltaConfirmation.js +0 -233
  608. package/dist/transactions/mutations/durableWriteStore.d.ts +0 -14
  609. package/dist/transactions/mutations/durableWriteStore.js +0 -12
  610. package/dist/transactions/mutations/optimisticApply.d.ts +0 -49
  611. package/dist/transactions/mutations/optimisticApply.js +0 -65
  612. package/dist/transactions/mutations/replayValidation.d.ts +0 -186
  613. package/dist/transactions/mutations/replayValidation.js +0 -163
  614. package/dist/utils/mobxSetup.d.ts +0 -53
  615. package/dist/utils/mobxSetup.js +0 -330
  616. package/dist/webhooks/events.d.ts +0 -43
  617. package/dist/webhooks/events.js +0 -42
  618. package/dist/webhooks/index.d.ts +0 -8
  619. package/dist/webhooks/index.js +0 -8
  620. package/dist/wire/index.d.ts +0 -1
  621. package/dist/wire/index.js +0 -8
  622. package/docs/interaction-model.md +0 -99
@@ -1,603 +0,0 @@
1
- /**
2
- * Canonical runtime contracts for commit settlement.
3
- *
4
- * A commit crosses several boundaries during its lifetime: the server's
5
- * execution cache, the HTTP/WS receipt, and the client's acknowledgement
6
- * tracker. Those boundaries intentionally have different envelopes, but they
7
- * all compose the same settlement vocabulary from this module:
8
- *
9
- * - `confirmed` — the authoritative change is visible at a sync watermark.
10
- * - `queued` — a connected source durably accepted the write and only its
11
- * correlated authoritative source delta (WAL for direct, endpoint event
12
- * for endpoint-only), identified by `correlationId`, may promote it.
13
- *
14
- * Keeping the variants discriminated here makes an impossible receipt (most
15
- * importantly, `queued` without a correlation) unrepresentable at every
16
- * untrusted boundary without collapsing the distinct lifecycle envelopes into
17
- * one giant object.
18
- */
19
- import { z } from 'zod';
20
- import type { ErrorCode } from '../errorCodes.js';
21
- /** Matches the permanent source/idempotency-key ceiling. */
22
- export declare const COMMIT_CORRELATION_ID_MAX_LENGTH = 255;
23
- /** Opaque server-authored identity shared by a queued receipt and its authoritative source delta. */
24
- export declare const correlationIdSchema: z.ZodString;
25
- export type CorrelationId = z.infer<typeof correlationIdSchema>;
26
- export declare const commitStatusSchema: z.ZodEnum<{
27
- queued: "queued";
28
- confirmed: "confirmed";
29
- }>;
30
- export type CommitStatus = z.infer<typeof commitStatusSchema>;
31
- /**
32
- * The settlement states a write may block on — extracted from the reported
33
- * vocabulary above, never restated beside it. `commitStatusSchema` is every
34
- * state a server can report; this is the subset a caller can usefully wait for,
35
- * and the two are not the same question: one describes an outcome, the other a
36
- * request.
37
- *
38
- * `.extract` keeps the relationship mechanical in both directions. Renaming a
39
- * settlement state breaks this line at build time, and adding one that nobody
40
- * can block on — a commit parked for a human, say — does not become a legal
41
- * `wait` merely by being added above. Both the `wait` option's runtime
42
- * validator and its interface derive from here, so they cannot disagree.
43
- */
44
- export declare const commitWaitSchema: z.ZodEnum<{
45
- queued: "queued";
46
- confirmed: "confirmed";
47
- }>;
48
- export type CommitWait = z.infer<typeof commitWaitSchema>;
49
- /** The one settlement discriminant shared by every commit boundary. */
50
- export declare const commitSettlementSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
51
- status: z.ZodLiteral<"queued">;
52
- correlationId: z.ZodString;
53
- }, z.core.$strict>, z.ZodObject<{
54
- status: z.ZodLiteral<"confirmed">;
55
- correlationId: z.ZodOptional<z.ZodString>;
56
- }, z.core.$strict>], "status">;
57
- export type CommitSettlement = z.infer<typeof commitSettlementSchema>;
58
- /**
59
- * Successful HTTP/WS receipt. This schema is deliberately strict about the
60
- * settlement discriminant. Zod's default object behavior strips additive
61
- * fields, which is forward compatible without allowing server-internal
62
- * recovery evidence to leak through a parsed wire receipt.
63
- */
64
- export declare const commitReceiptSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
65
- status: z.ZodLiteral<"queued">;
66
- correlationId: z.ZodString;
67
- object: z.ZodLiteral<"commit_receipt">;
68
- id: z.ZodOptional<z.ZodString>;
69
- clientTxId: z.ZodString;
70
- serverTxId: z.ZodString;
71
- success: z.ZodLiteral<true>;
72
- lastSyncId: z.ZodNumber;
73
- ops: z.ZodNumber;
74
- notifications: z.ZodOptional<z.ZodArray<z.ZodObject<{
75
- object: z.ZodOptional<z.ZodLiteral<"stale_notification">>;
76
- model: z.ZodString;
77
- id: z.ZodString;
78
- readAt: z.ZodNumber;
79
- observedSyncId: z.ZodNumber;
80
- conflictingFields: z.ZodArray<z.ZodString>;
81
- currentValues: z.ZodRecord<z.ZodString, z.ZodUnknown>;
82
- writtenBy: z.ZodObject<{
83
- kind: z.ZodEnum<{
84
- user: "user";
85
- agent: "agent";
86
- system: "system";
87
- }>;
88
- id: z.ZodString;
89
- }, z.core.$strip>;
90
- group: z.ZodOptional<z.ZodString>;
91
- }, z.core.$strip>>>;
92
- missingIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
93
- }, z.core.$strip>, z.ZodObject<{
94
- status: z.ZodLiteral<"confirmed">;
95
- correlationId: z.ZodOptional<z.ZodString>;
96
- object: z.ZodLiteral<"commit_receipt">;
97
- id: z.ZodOptional<z.ZodString>;
98
- clientTxId: z.ZodString;
99
- serverTxId: z.ZodString;
100
- success: z.ZodLiteral<true>;
101
- lastSyncId: z.ZodNumber;
102
- ops: z.ZodNumber;
103
- notifications: z.ZodOptional<z.ZodArray<z.ZodObject<{
104
- object: z.ZodOptional<z.ZodLiteral<"stale_notification">>;
105
- model: z.ZodString;
106
- id: z.ZodString;
107
- readAt: z.ZodNumber;
108
- observedSyncId: z.ZodNumber;
109
- conflictingFields: z.ZodArray<z.ZodString>;
110
- currentValues: z.ZodRecord<z.ZodString, z.ZodUnknown>;
111
- writtenBy: z.ZodObject<{
112
- kind: z.ZodEnum<{
113
- user: "user";
114
- agent: "agent";
115
- system: "system";
116
- }>;
117
- id: z.ZodString;
118
- }, z.core.$strip>;
119
- group: z.ZodOptional<z.ZodString>;
120
- }, z.core.$strip>>>;
121
- missingIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
122
- }, z.core.$strip>], "status">;
123
- export type CommitReceiptWire = z.infer<typeof commitReceiptSchema>;
124
- /** The failure arm is separate: queued/confirmed always imply `success:true`. */
125
- export declare const rejectedCommitReceiptSchema: z.ZodObject<{
126
- object: z.ZodLiteral<"commit_receipt">;
127
- clientTxId: z.ZodString;
128
- serverTxId: z.ZodString;
129
- success: z.ZodLiteral<false>;
130
- status: z.ZodLiteral<"rejected">;
131
- lastSyncId: z.ZodOptional<z.ZodNumber>;
132
- ops: z.ZodOptional<z.ZodNumber>;
133
- error: z.ZodObject<{
134
- code: z.ZodCustom<ErrorCode, ErrorCode>;
135
- message: z.ZodString;
136
- field: z.ZodOptional<z.ZodString>;
137
- requiredCapability: z.ZodOptional<z.ZodObject<{
138
- scope: z.ZodString;
139
- constraints: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodString]>>>;
140
- issuer: z.ZodPreprocess<z.ZodOptional<z.ZodString>>;
141
- ttlSeconds: z.ZodPreprocess<z.ZodOptional<z.ZodNumber>>;
142
- nonce: z.ZodPreprocess<z.ZodOptional<z.ZodString>>;
143
- }, z.core.$loose>>;
144
- }, z.core.$strip>;
145
- }, z.core.$strip>;
146
- export type RejectedCommitReceiptWire = z.infer<typeof rejectedCommitReceiptSchema>;
147
- export declare const mutationResultPayloadSchema: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
148
- status: z.ZodLiteral<"queued">;
149
- correlationId: z.ZodString;
150
- object: z.ZodLiteral<"commit_receipt">;
151
- id: z.ZodOptional<z.ZodString>;
152
- clientTxId: z.ZodString;
153
- serverTxId: z.ZodString;
154
- success: z.ZodLiteral<true>;
155
- lastSyncId: z.ZodNumber;
156
- ops: z.ZodNumber;
157
- notifications: z.ZodOptional<z.ZodArray<z.ZodObject<{
158
- object: z.ZodOptional<z.ZodLiteral<"stale_notification">>;
159
- model: z.ZodString;
160
- id: z.ZodString;
161
- readAt: z.ZodNumber;
162
- observedSyncId: z.ZodNumber;
163
- conflictingFields: z.ZodArray<z.ZodString>;
164
- currentValues: z.ZodRecord<z.ZodString, z.ZodUnknown>;
165
- writtenBy: z.ZodObject<{
166
- kind: z.ZodEnum<{
167
- user: "user";
168
- agent: "agent";
169
- system: "system";
170
- }>;
171
- id: z.ZodString;
172
- }, z.core.$strip>;
173
- group: z.ZodOptional<z.ZodString>;
174
- }, z.core.$strip>>>;
175
- missingIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
176
- }, z.core.$strip>, z.ZodObject<{
177
- status: z.ZodLiteral<"confirmed">;
178
- correlationId: z.ZodOptional<z.ZodString>;
179
- object: z.ZodLiteral<"commit_receipt">;
180
- id: z.ZodOptional<z.ZodString>;
181
- clientTxId: z.ZodString;
182
- serverTxId: z.ZodString;
183
- success: z.ZodLiteral<true>;
184
- lastSyncId: z.ZodNumber;
185
- ops: z.ZodNumber;
186
- notifications: z.ZodOptional<z.ZodArray<z.ZodObject<{
187
- object: z.ZodOptional<z.ZodLiteral<"stale_notification">>;
188
- model: z.ZodString;
189
- id: z.ZodString;
190
- readAt: z.ZodNumber;
191
- observedSyncId: z.ZodNumber;
192
- conflictingFields: z.ZodArray<z.ZodString>;
193
- currentValues: z.ZodRecord<z.ZodString, z.ZodUnknown>;
194
- writtenBy: z.ZodObject<{
195
- kind: z.ZodEnum<{
196
- user: "user";
197
- agent: "agent";
198
- system: "system";
199
- }>;
200
- id: z.ZodString;
201
- }, z.core.$strip>;
202
- group: z.ZodOptional<z.ZodString>;
203
- }, z.core.$strip>>>;
204
- missingIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
205
- }, z.core.$strip>], "status">, z.ZodObject<{
206
- object: z.ZodLiteral<"commit_receipt">;
207
- clientTxId: z.ZodString;
208
- serverTxId: z.ZodString;
209
- success: z.ZodLiteral<false>;
210
- status: z.ZodLiteral<"rejected">;
211
- lastSyncId: z.ZodOptional<z.ZodNumber>;
212
- ops: z.ZodOptional<z.ZodNumber>;
213
- error: z.ZodObject<{
214
- code: z.ZodCustom<ErrorCode, ErrorCode>;
215
- message: z.ZodString;
216
- field: z.ZodOptional<z.ZodString>;
217
- requiredCapability: z.ZodOptional<z.ZodObject<{
218
- scope: z.ZodString;
219
- constraints: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodString]>>>;
220
- issuer: z.ZodPreprocess<z.ZodOptional<z.ZodString>>;
221
- ttlSeconds: z.ZodPreprocess<z.ZodOptional<z.ZodNumber>>;
222
- nonce: z.ZodPreprocess<z.ZodOptional<z.ZodString>>;
223
- }, z.core.$loose>>;
224
- }, z.core.$strip>;
225
- }, z.core.$strip>]>;
226
- export type MutationResultPayload = z.infer<typeof mutationResultPayloadSchema>;
227
- export declare const mutationResultMessageSchema: z.ZodObject<{
228
- type: z.ZodLiteral<"mutation_result">;
229
- payload: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
230
- status: z.ZodLiteral<"queued">;
231
- correlationId: z.ZodString;
232
- object: z.ZodLiteral<"commit_receipt">;
233
- id: z.ZodOptional<z.ZodString>;
234
- clientTxId: z.ZodString;
235
- serverTxId: z.ZodString;
236
- success: z.ZodLiteral<true>;
237
- lastSyncId: z.ZodNumber;
238
- ops: z.ZodNumber;
239
- notifications: z.ZodOptional<z.ZodArray<z.ZodObject<{
240
- object: z.ZodOptional<z.ZodLiteral<"stale_notification">>;
241
- model: z.ZodString;
242
- id: z.ZodString;
243
- readAt: z.ZodNumber;
244
- observedSyncId: z.ZodNumber;
245
- conflictingFields: z.ZodArray<z.ZodString>;
246
- currentValues: z.ZodRecord<z.ZodString, z.ZodUnknown>;
247
- writtenBy: z.ZodObject<{
248
- kind: z.ZodEnum<{
249
- user: "user";
250
- agent: "agent";
251
- system: "system";
252
- }>;
253
- id: z.ZodString;
254
- }, z.core.$strip>;
255
- group: z.ZodOptional<z.ZodString>;
256
- }, z.core.$strip>>>;
257
- missingIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
258
- }, z.core.$strip>, z.ZodObject<{
259
- status: z.ZodLiteral<"confirmed">;
260
- correlationId: z.ZodOptional<z.ZodString>;
261
- object: z.ZodLiteral<"commit_receipt">;
262
- id: z.ZodOptional<z.ZodString>;
263
- clientTxId: z.ZodString;
264
- serverTxId: z.ZodString;
265
- success: z.ZodLiteral<true>;
266
- lastSyncId: z.ZodNumber;
267
- ops: z.ZodNumber;
268
- notifications: z.ZodOptional<z.ZodArray<z.ZodObject<{
269
- object: z.ZodOptional<z.ZodLiteral<"stale_notification">>;
270
- model: z.ZodString;
271
- id: z.ZodString;
272
- readAt: z.ZodNumber;
273
- observedSyncId: z.ZodNumber;
274
- conflictingFields: z.ZodArray<z.ZodString>;
275
- currentValues: z.ZodRecord<z.ZodString, z.ZodUnknown>;
276
- writtenBy: z.ZodObject<{
277
- kind: z.ZodEnum<{
278
- user: "user";
279
- agent: "agent";
280
- system: "system";
281
- }>;
282
- id: z.ZodString;
283
- }, z.core.$strip>;
284
- group: z.ZodOptional<z.ZodString>;
285
- }, z.core.$strip>>>;
286
- missingIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
287
- }, z.core.$strip>], "status">, z.ZodObject<{
288
- object: z.ZodLiteral<"commit_receipt">;
289
- clientTxId: z.ZodString;
290
- serverTxId: z.ZodString;
291
- success: z.ZodLiteral<false>;
292
- status: z.ZodLiteral<"rejected">;
293
- lastSyncId: z.ZodOptional<z.ZodNumber>;
294
- ops: z.ZodOptional<z.ZodNumber>;
295
- error: z.ZodObject<{
296
- code: z.ZodCustom<ErrorCode, ErrorCode>;
297
- message: z.ZodString;
298
- field: z.ZodOptional<z.ZodString>;
299
- requiredCapability: z.ZodOptional<z.ZodObject<{
300
- scope: z.ZodString;
301
- constraints: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodString]>>>;
302
- issuer: z.ZodPreprocess<z.ZodOptional<z.ZodString>>;
303
- ttlSeconds: z.ZodPreprocess<z.ZodOptional<z.ZodNumber>>;
304
- nonce: z.ZodPreprocess<z.ZodOptional<z.ZodString>>;
305
- }, z.core.$loose>>;
306
- }, z.core.$strip>;
307
- }, z.core.$strip>]>;
308
- }, z.core.$strip>;
309
- export type MutationResultMessageWire = z.infer<typeof mutationResultMessageSchema>;
310
- export declare const commitExecutionResultSchema: z.ZodPipe<z.ZodObject<{
311
- lastSyncId: z.ZodNumber;
312
- firstSyncId: z.ZodNumber;
313
- status: z.ZodOptional<z.ZodEnum<{
314
- queued: "queued";
315
- confirmed: "confirmed";
316
- }>>;
317
- correlationId: z.ZodOptional<z.ZodString>;
318
- confirmationTransactionIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
319
- notifications: z.ZodOptional<z.ZodArray<z.ZodObject<{
320
- object: z.ZodOptional<z.ZodLiteral<"stale_notification">>;
321
- model: z.ZodString;
322
- id: z.ZodString;
323
- readAt: z.ZodNumber;
324
- observedSyncId: z.ZodNumber;
325
- conflictingFields: z.ZodArray<z.ZodString>;
326
- currentValues: z.ZodRecord<z.ZodString, z.ZodUnknown>;
327
- writtenBy: z.ZodObject<{
328
- kind: z.ZodEnum<{
329
- user: "user";
330
- agent: "agent";
331
- system: "system";
332
- }>;
333
- id: z.ZodString;
334
- }, z.core.$strip>;
335
- group: z.ZodOptional<z.ZodString>;
336
- }, z.core.$strip>>>;
337
- missingIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
338
- }, z.core.$strict>, z.ZodTransform<{
339
- status: "queued" | "confirmed";
340
- lastSyncId: number;
341
- firstSyncId: number;
342
- correlationId?: string | undefined;
343
- confirmationTransactionIds?: string[] | undefined;
344
- notifications?: {
345
- model: string;
346
- id: string;
347
- readAt: number;
348
- observedSyncId: number;
349
- conflictingFields: string[];
350
- currentValues: Record<string, unknown>;
351
- writtenBy: {
352
- kind: "user" | "agent" | "system";
353
- id: string;
354
- };
355
- object?: "stale_notification" | undefined;
356
- group?: string | undefined;
357
- }[] | undefined;
358
- missingIds?: string[] | undefined;
359
- }, {
360
- lastSyncId: number;
361
- firstSyncId: number;
362
- status?: "queued" | "confirmed" | undefined;
363
- correlationId?: string | undefined;
364
- confirmationTransactionIds?: string[] | undefined;
365
- notifications?: {
366
- model: string;
367
- id: string;
368
- readAt: number;
369
- observedSyncId: number;
370
- conflictingFields: string[];
371
- currentValues: Record<string, unknown>;
372
- writtenBy: {
373
- kind: "user" | "agent" | "system";
374
- id: string;
375
- };
376
- object?: "stale_notification" | undefined;
377
- group?: string | undefined;
378
- }[] | undefined;
379
- missingIds?: string[] | undefined;
380
- }>>;
381
- export type CommitExecutionResultInput = z.input<typeof commitExecutionResultSchema>;
382
- export type CommitExecutionResult = z.infer<typeof commitExecutionResultSchema>;
383
- /** Normalized acknowledgement handed from a mutation transport to the queue. */
384
- export declare const commitAckSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
385
- status: z.ZodLiteral<"queued">;
386
- correlationId: z.ZodString;
387
- lastSyncId: z.ZodNumber;
388
- notifications: z.ZodOptional<z.ZodArray<z.ZodObject<{
389
- object: z.ZodOptional<z.ZodLiteral<"stale_notification">>;
390
- model: z.ZodString;
391
- id: z.ZodString;
392
- readAt: z.ZodNumber;
393
- observedSyncId: z.ZodNumber;
394
- conflictingFields: z.ZodArray<z.ZodString>;
395
- currentValues: z.ZodRecord<z.ZodString, z.ZodUnknown>;
396
- writtenBy: z.ZodObject<{
397
- kind: z.ZodEnum<{
398
- user: "user";
399
- agent: "agent";
400
- system: "system";
401
- }>;
402
- id: z.ZodString;
403
- }, z.core.$strip>;
404
- group: z.ZodOptional<z.ZodString>;
405
- }, z.core.$strip>>>;
406
- missingIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
407
- }, z.core.$strict>, z.ZodObject<{
408
- status: z.ZodLiteral<"confirmed">;
409
- correlationId: z.ZodOptional<z.ZodString>;
410
- lastSyncId: z.ZodNumber;
411
- notifications: z.ZodOptional<z.ZodArray<z.ZodObject<{
412
- object: z.ZodOptional<z.ZodLiteral<"stale_notification">>;
413
- model: z.ZodString;
414
- id: z.ZodString;
415
- readAt: z.ZodNumber;
416
- observedSyncId: z.ZodNumber;
417
- conflictingFields: z.ZodArray<z.ZodString>;
418
- currentValues: z.ZodRecord<z.ZodString, z.ZodUnknown>;
419
- writtenBy: z.ZodObject<{
420
- kind: z.ZodEnum<{
421
- user: "user";
422
- agent: "agent";
423
- system: "system";
424
- }>;
425
- id: z.ZodString;
426
- }, z.core.$strip>;
427
- group: z.ZodOptional<z.ZodString>;
428
- }, z.core.$strip>>>;
429
- missingIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
430
- }, z.core.$strict>], "status">;
431
- export type CommitAck = z.infer<typeof commitAckSchema>;
432
- /**
433
- * The boundary an injected mutation executor returns through. It is the
434
- * acknowledgement schema itself: settlement is declared, never inferred from
435
- * an omission, so a transport cannot report a write as landed by staying
436
- * silent about how it landed.
437
- */
438
- export declare const mutationCommitResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
439
- status: z.ZodLiteral<"queued">;
440
- correlationId: z.ZodString;
441
- lastSyncId: z.ZodNumber;
442
- notifications: z.ZodOptional<z.ZodArray<z.ZodObject<{
443
- object: z.ZodOptional<z.ZodLiteral<"stale_notification">>;
444
- model: z.ZodString;
445
- id: z.ZodString;
446
- readAt: z.ZodNumber;
447
- observedSyncId: z.ZodNumber;
448
- conflictingFields: z.ZodArray<z.ZodString>;
449
- currentValues: z.ZodRecord<z.ZodString, z.ZodUnknown>;
450
- writtenBy: z.ZodObject<{
451
- kind: z.ZodEnum<{
452
- user: "user";
453
- agent: "agent";
454
- system: "system";
455
- }>;
456
- id: z.ZodString;
457
- }, z.core.$strip>;
458
- group: z.ZodOptional<z.ZodString>;
459
- }, z.core.$strip>>>;
460
- missingIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
461
- }, z.core.$strict>, z.ZodObject<{
462
- status: z.ZodLiteral<"confirmed">;
463
- correlationId: z.ZodOptional<z.ZodString>;
464
- lastSyncId: z.ZodNumber;
465
- notifications: z.ZodOptional<z.ZodArray<z.ZodObject<{
466
- object: z.ZodOptional<z.ZodLiteral<"stale_notification">>;
467
- model: z.ZodString;
468
- id: z.ZodString;
469
- readAt: z.ZodNumber;
470
- observedSyncId: z.ZodNumber;
471
- conflictingFields: z.ZodArray<z.ZodString>;
472
- currentValues: z.ZodRecord<z.ZodString, z.ZodUnknown>;
473
- writtenBy: z.ZodObject<{
474
- kind: z.ZodEnum<{
475
- user: "user";
476
- agent: "agent";
477
- system: "system";
478
- }>;
479
- id: z.ZodString;
480
- }, z.core.$strip>;
481
- group: z.ZodOptional<z.ZodString>;
482
- }, z.core.$strip>>>;
483
- missingIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
484
- }, z.core.$strict>], "status">;
485
- export type MutationCommitResultInput = z.input<typeof mutationCommitResultSchema>;
486
- export type MutationCommitResult = z.infer<typeof mutationCommitResultSchema>;
487
- /**
488
- * Public SDK projection returned by `ablo.commits` and model mutations.
489
- *
490
- * This intentionally does not compose `commitSettlementSchema`: on the WS
491
- * facade, `wait:'queued'` currently means locally sealed/enqueued, before a
492
- * server has necessarily accepted the write. Renaming that public state to
493
- * `enqueued` is a separate protocol change; the authoritative settlement
494
- * union above is reserved for server acknowledgements.
495
- */
496
- export declare const clientCommitReceiptSchema: z.ZodObject<{
497
- id: z.ZodString;
498
- status: z.ZodEnum<{
499
- queued: "queued";
500
- confirmed: "confirmed";
501
- }>;
502
- lastSyncId: z.ZodOptional<z.ZodNumber>;
503
- notifications: z.ZodOptional<z.ZodArray<z.ZodObject<{
504
- object: z.ZodOptional<z.ZodLiteral<"stale_notification">>;
505
- model: z.ZodString;
506
- id: z.ZodString;
507
- readAt: z.ZodNumber;
508
- observedSyncId: z.ZodNumber;
509
- conflictingFields: z.ZodArray<z.ZodString>;
510
- currentValues: z.ZodRecord<z.ZodString, z.ZodUnknown>;
511
- writtenBy: z.ZodObject<{
512
- kind: z.ZodEnum<{
513
- user: "user";
514
- agent: "agent";
515
- system: "system";
516
- }>;
517
- id: z.ZodString;
518
- }, z.core.$strip>;
519
- group: z.ZodOptional<z.ZodString>;
520
- }, z.core.$strip>>>;
521
- missingIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
522
- }, z.core.$strict>;
523
- export type ClientCommitReceipt = z.infer<typeof clientCommitReceiptSchema>;
524
- /** Control fields any operation in a commit may carry. */
525
- export declare const commitOperationControlShape: {
526
- id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
527
- transactionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
528
- readAt: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
529
- onStale: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
530
- reject: "reject";
531
- overwrite: "overwrite";
532
- notify: "notify";
533
- }>>>;
534
- fenceToken: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
535
- };
536
- /** One write inside a commit, in the canonical spelling. */
537
- export declare const commitOperationBodySchema: z.ZodObject<{
538
- action: z.ZodString;
539
- model: z.ZodString;
540
- data: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
541
- id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
542
- transactionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
543
- readAt: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
544
- onStale: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
545
- reject: "reject";
546
- overwrite: "overwrite";
547
- notify: "notify";
548
- }>>>;
549
- fenceToken: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
550
- }, z.core.$strip>;
551
- export type CommitOperationBody = z.infer<typeof commitOperationBodySchema>;
552
- /**
553
- * The `POST /v1/commits` request body.
554
- *
555
- * `operations` carries the writes; `track` registers durable premises.
556
- * Neither is required on its own, because a body with `track` and no
557
- * `operations` is how a caller starts watching a row without writing to it.
558
- * Request identity travels in the `Idempotency-Key` header.
559
- */
560
- export declare const commitRequestSchema: z.ZodObject<{
561
- operations: z.ZodOptional<z.ZodArray<z.ZodObject<{
562
- action: z.ZodString;
563
- model: z.ZodString;
564
- data: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
565
- id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
566
- transactionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
567
- readAt: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
568
- onStale: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
569
- reject: "reject";
570
- overwrite: "overwrite";
571
- notify: "notify";
572
- }>>>;
573
- fenceToken: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
574
- }, z.core.$strip>>>;
575
- reads: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
576
- model: z.ZodString;
577
- id: z.ZodString;
578
- readAt: z.ZodNumber;
579
- fields: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
580
- onStale: z.ZodOptional<z.ZodEnum<{
581
- reject: "reject";
582
- overwrite: "overwrite";
583
- notify: "notify";
584
- }>>;
585
- }, z.core.$strip>, z.ZodObject<{
586
- group: z.ZodString;
587
- readAt: z.ZodNumber;
588
- onStale: z.ZodOptional<z.ZodEnum<{
589
- reject: "reject";
590
- overwrite: "overwrite";
591
- notify: "notify";
592
- }>>;
593
- }, z.core.$strip>]>>>>;
594
- track: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
595
- model: z.ZodString;
596
- id: z.ZodString;
597
- readAt: z.ZodOptional<z.ZodNumber>;
598
- }, z.core.$strip>, z.ZodObject<{
599
- group: z.ZodString;
600
- readAt: z.ZodOptional<z.ZodNumber>;
601
- }, z.core.$strip>]>>>>;
602
- }, z.core.$strip>;
603
- export type CommitRequest = z.infer<typeof commitRequestSchema>;