hikoutei 0.2.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 (535) hide show
  1. package/LICENSE +21 -0
  2. package/README.ja.md +135 -0
  3. package/README.ko.md +138 -0
  4. package/README.md +143 -0
  5. package/apps-script/gateway/Code.gs +412 -0
  6. package/dist/adapter/persistence/contracts/index.d.ts +3 -0
  7. package/dist/adapter/persistence/contracts/index.d.ts.map +1 -0
  8. package/dist/adapter/persistence/contracts/index.js +3 -0
  9. package/dist/adapter/persistence/contracts/index.js.map +1 -0
  10. package/dist/adapter/persistence/contracts/sql.d.ts +50 -0
  11. package/dist/adapter/persistence/contracts/sql.d.ts.map +1 -0
  12. package/dist/adapter/persistence/contracts/sql.js +9 -0
  13. package/dist/adapter/persistence/contracts/sql.js.map +1 -0
  14. package/dist/adapter/persistence/index.d.ts +2 -0
  15. package/dist/adapter/persistence/index.d.ts.map +1 -0
  16. package/dist/adapter/persistence/index.js +2 -0
  17. package/dist/adapter/persistence/index.js.map +1 -0
  18. package/dist/adapter/persistence/providers/mikro-orm/api/MikroOrmTypedSheetsEntityManager.d.ts +53 -0
  19. package/dist/adapter/persistence/providers/mikro-orm/api/MikroOrmTypedSheetsEntityManager.d.ts.map +1 -0
  20. package/dist/adapter/persistence/providers/mikro-orm/api/MikroOrmTypedSheetsEntityManager.js +105 -0
  21. package/dist/adapter/persistence/providers/mikro-orm/api/MikroOrmTypedSheetsEntityManager.js.map +1 -0
  22. package/dist/adapter/persistence/providers/mikro-orm/engine/MikroOrmMappedTypedSheets.d.ts +39 -0
  23. package/dist/adapter/persistence/providers/mikro-orm/engine/MikroOrmMappedTypedSheets.d.ts.map +1 -0
  24. package/dist/adapter/persistence/providers/mikro-orm/engine/MikroOrmMappedTypedSheets.js +54 -0
  25. package/dist/adapter/persistence/providers/mikro-orm/engine/MikroOrmMappedTypedSheets.js.map +1 -0
  26. package/dist/adapter/persistence/providers/mikro-orm/engine/MikroOrmTypedSheetsEngine.d.ts +38 -0
  27. package/dist/adapter/persistence/providers/mikro-orm/engine/MikroOrmTypedSheetsEngine.d.ts.map +1 -0
  28. package/dist/adapter/persistence/providers/mikro-orm/engine/MikroOrmTypedSheetsEngine.js +55 -0
  29. package/dist/adapter/persistence/providers/mikro-orm/engine/MikroOrmTypedSheetsEngine.js.map +1 -0
  30. package/dist/adapter/persistence/providers/mikro-orm/index.d.ts +16 -0
  31. package/dist/adapter/persistence/providers/mikro-orm/index.d.ts.map +1 -0
  32. package/dist/adapter/persistence/providers/mikro-orm/index.js +9 -0
  33. package/dist/adapter/persistence/providers/mikro-orm/index.js.map +1 -0
  34. package/dist/adapter/persistence/providers/mikro-orm/observation/MikroOrmMappedObservation.d.ts +27 -0
  35. package/dist/adapter/persistence/providers/mikro-orm/observation/MikroOrmMappedObservation.d.ts.map +1 -0
  36. package/dist/adapter/persistence/providers/mikro-orm/observation/MikroOrmMappedObservation.js +67 -0
  37. package/dist/adapter/persistence/providers/mikro-orm/observation/MikroOrmMappedObservation.js.map +1 -0
  38. package/dist/adapter/persistence/providers/mikro-orm/storage/MikroOrmFlushChanges.d.ts +19 -0
  39. package/dist/adapter/persistence/providers/mikro-orm/storage/MikroOrmFlushChanges.d.ts.map +1 -0
  40. package/dist/adapter/persistence/providers/mikro-orm/storage/MikroOrmFlushChanges.js +67 -0
  41. package/dist/adapter/persistence/providers/mikro-orm/storage/MikroOrmFlushChanges.js.map +1 -0
  42. package/dist/adapter/persistence/providers/mikro-orm/storage/MikroOrmSqliteAdapter.d.ts +78 -0
  43. package/dist/adapter/persistence/providers/mikro-orm/storage/MikroOrmSqliteAdapter.d.ts.map +1 -0
  44. package/dist/adapter/persistence/providers/mikro-orm/storage/MikroOrmSqliteAdapter.js +121 -0
  45. package/dist/adapter/persistence/providers/mikro-orm/storage/MikroOrmSqliteAdapter.js.map +1 -0
  46. package/dist/adapter/persistence/providers/mikro-orm/storage/MikroOrmSqliteSchema.d.ts +20 -0
  47. package/dist/adapter/persistence/providers/mikro-orm/storage/MikroOrmSqliteSchema.d.ts.map +1 -0
  48. package/dist/adapter/persistence/providers/mikro-orm/storage/MikroOrmSqliteSchema.js +125 -0
  49. package/dist/adapter/persistence/providers/mikro-orm/storage/MikroOrmSqliteSchema.js.map +1 -0
  50. package/dist/adapter/sheets/providers/apps-script-gateway/errors.d.ts +42 -0
  51. package/dist/adapter/sheets/providers/apps-script-gateway/errors.d.ts.map +1 -0
  52. package/dist/adapter/sheets/providers/apps-script-gateway/errors.js +51 -0
  53. package/dist/adapter/sheets/providers/apps-script-gateway/errors.js.map +1 -0
  54. package/dist/adapter/sheets/providers/apps-script-gateway/index.d.ts +22 -0
  55. package/dist/adapter/sheets/providers/apps-script-gateway/index.d.ts.map +1 -0
  56. package/dist/adapter/sheets/providers/apps-script-gateway/index.js +12 -0
  57. package/dist/adapter/sheets/providers/apps-script-gateway/index.js.map +1 -0
  58. package/dist/adapter/sheets/providers/apps-script-gateway/operations/effect/effectOperation.d.ts +42 -0
  59. package/dist/adapter/sheets/providers/apps-script-gateway/operations/effect/effectOperation.d.ts.map +1 -0
  60. package/dist/adapter/sheets/providers/apps-script-gateway/operations/effect/effectOperation.js +161 -0
  61. package/dist/adapter/sheets/providers/apps-script-gateway/operations/effect/effectOperation.js.map +1 -0
  62. package/dist/adapter/sheets/providers/apps-script-gateway/operations/effect/effectOperationScript.d.ts +3 -0
  63. package/dist/adapter/sheets/providers/apps-script-gateway/operations/effect/effectOperationScript.d.ts.map +1 -0
  64. package/dist/adapter/sheets/providers/apps-script-gateway/operations/effect/effectOperationScript.js +692 -0
  65. package/dist/adapter/sheets/providers/apps-script-gateway/operations/effect/effectOperationScript.js.map +1 -0
  66. package/dist/adapter/sheets/providers/apps-script-gateway/operations/observation/observationOperation.d.ts +29 -0
  67. package/dist/adapter/sheets/providers/apps-script-gateway/operations/observation/observationOperation.d.ts.map +1 -0
  68. package/dist/adapter/sheets/providers/apps-script-gateway/operations/observation/observationOperation.js +538 -0
  69. package/dist/adapter/sheets/providers/apps-script-gateway/operations/observation/observationOperation.js.map +1 -0
  70. package/dist/adapter/sheets/providers/apps-script-gateway/operations/read/tableReadOperation.d.ts +12 -0
  71. package/dist/adapter/sheets/providers/apps-script-gateway/operations/read/tableReadOperation.d.ts.map +1 -0
  72. package/dist/adapter/sheets/providers/apps-script-gateway/operations/read/tableReadOperation.js +190 -0
  73. package/dist/adapter/sheets/providers/apps-script-gateway/operations/read/tableReadOperation.js.map +1 -0
  74. package/dist/adapter/sheets/providers/apps-script-gateway/operations/write/fastAppendOperation.d.ts +23 -0
  75. package/dist/adapter/sheets/providers/apps-script-gateway/operations/write/fastAppendOperation.d.ts.map +1 -0
  76. package/dist/adapter/sheets/providers/apps-script-gateway/operations/write/fastAppendOperation.js +166 -0
  77. package/dist/adapter/sheets/providers/apps-script-gateway/operations/write/fastAppendOperation.js.map +1 -0
  78. package/dist/adapter/sheets/providers/apps-script-gateway/protocol/codeGsProtocol.d.ts +50 -0
  79. package/dist/adapter/sheets/providers/apps-script-gateway/protocol/codeGsProtocol.d.ts.map +1 -0
  80. package/dist/adapter/sheets/providers/apps-script-gateway/protocol/codeGsProtocol.js +60 -0
  81. package/dist/adapter/sheets/providers/apps-script-gateway/protocol/codeGsProtocol.js.map +1 -0
  82. package/dist/adapter/sheets/providers/apps-script-gateway/protocol/constants.d.ts +44 -0
  83. package/dist/adapter/sheets/providers/apps-script-gateway/protocol/constants.d.ts.map +1 -0
  84. package/dist/adapter/sheets/providers/apps-script-gateway/protocol/constants.js +40 -0
  85. package/dist/adapter/sheets/providers/apps-script-gateway/protocol/constants.js.map +1 -0
  86. package/dist/adapter/sheets/providers/apps-script-gateway/protocol/syncProtocol.d.ts +7 -0
  87. package/dist/adapter/sheets/providers/apps-script-gateway/protocol/syncProtocol.d.ts.map +1 -0
  88. package/dist/adapter/sheets/providers/apps-script-gateway/protocol/syncProtocol.js +47 -0
  89. package/dist/adapter/sheets/providers/apps-script-gateway/protocol/syncProtocol.js.map +1 -0
  90. package/dist/adapter/sheets/providers/apps-script-gateway/protocol/timing.d.ts +5 -0
  91. package/dist/adapter/sheets/providers/apps-script-gateway/protocol/timing.d.ts.map +1 -0
  92. package/dist/adapter/sheets/providers/apps-script-gateway/protocol/timing.js +54 -0
  93. package/dist/adapter/sheets/providers/apps-script-gateway/protocol/timing.js.map +1 -0
  94. package/dist/adapter/sheets/providers/apps-script-gateway/protocol/types.d.ts +5 -0
  95. package/dist/adapter/sheets/providers/apps-script-gateway/protocol/types.d.ts.map +1 -0
  96. package/dist/adapter/sheets/providers/apps-script-gateway/protocol/types.js +2 -0
  97. package/dist/adapter/sheets/providers/apps-script-gateway/protocol/types.js.map +1 -0
  98. package/dist/adapter/sheets/providers/apps-script-gateway/protocol/validation.d.ts +10 -0
  99. package/dist/adapter/sheets/providers/apps-script-gateway/protocol/validation.d.ts.map +1 -0
  100. package/dist/adapter/sheets/providers/apps-script-gateway/protocol/validation.js +35 -0
  101. package/dist/adapter/sheets/providers/apps-script-gateway/protocol/validation.js.map +1 -0
  102. package/dist/adapter/sheets/providers/apps-script-gateway/transport/operationClient.d.ts +67 -0
  103. package/dist/adapter/sheets/providers/apps-script-gateway/transport/operationClient.d.ts.map +1 -0
  104. package/dist/adapter/sheets/providers/apps-script-gateway/transport/operationClient.js +204 -0
  105. package/dist/adapter/sheets/providers/apps-script-gateway/transport/operationClient.js.map +1 -0
  106. package/dist/adapter/sheets/providers/apps-script-gateway/transport/operationSyncGateway.d.ts +78 -0
  107. package/dist/adapter/sheets/providers/apps-script-gateway/transport/operationSyncGateway.d.ts.map +1 -0
  108. package/dist/adapter/sheets/providers/apps-script-gateway/transport/operationSyncGateway.js +343 -0
  109. package/dist/adapter/sheets/providers/apps-script-gateway/transport/operationSyncGateway.js.map +1 -0
  110. package/dist/application/index.d.ts +4 -0
  111. package/dist/application/index.d.ts.map +1 -0
  112. package/dist/application/index.js +4 -0
  113. package/dist/application/index.js.map +1 -0
  114. package/dist/application/orm/api/TypedSheetsOrm.d.ts +71 -0
  115. package/dist/application/orm/api/TypedSheetsOrm.d.ts.map +1 -0
  116. package/dist/application/orm/api/TypedSheetsOrm.js +116 -0
  117. package/dist/application/orm/api/TypedSheetsOrm.js.map +1 -0
  118. package/dist/application/orm/api/contracts.d.ts +118 -0
  119. package/dist/application/orm/api/contracts.d.ts.map +1 -0
  120. package/dist/application/orm/api/contracts.js +21 -0
  121. package/dist/application/orm/api/contracts.js.map +1 -0
  122. package/dist/application/orm/errors.d.ts +35 -0
  123. package/dist/application/orm/errors.d.ts.map +1 -0
  124. package/dist/application/orm/errors.js +35 -0
  125. package/dist/application/orm/errors.js.map +1 -0
  126. package/dist/application/orm/index.d.ts +13 -0
  127. package/dist/application/orm/index.d.ts.map +1 -0
  128. package/dist/application/orm/index.js +7 -0
  129. package/dist/application/orm/index.js.map +1 -0
  130. package/dist/application/orm/mapping/contracts.d.ts +113 -0
  131. package/dist/application/orm/mapping/contracts.d.ts.map +1 -0
  132. package/dist/application/orm/mapping/contracts.js +8 -0
  133. package/dist/application/orm/mapping/contracts.js.map +1 -0
  134. package/dist/application/orm/mapping/definition.d.ts +16 -0
  135. package/dist/application/orm/mapping/definition.d.ts.map +1 -0
  136. package/dist/application/orm/mapping/definition.js +145 -0
  137. package/dist/application/orm/mapping/definition.js.map +1 -0
  138. package/dist/application/orm/mapping/entityMapping.d.ts +13 -0
  139. package/dist/application/orm/mapping/entityMapping.d.ts.map +1 -0
  140. package/dist/application/orm/mapping/entityMapping.js +13 -0
  141. package/dist/application/orm/mapping/entityMapping.js.map +1 -0
  142. package/dist/application/orm/mapping/identity.d.ts +14 -0
  143. package/dist/application/orm/mapping/identity.d.ts.map +1 -0
  144. package/dist/application/orm/mapping/identity.js +37 -0
  145. package/dist/application/orm/mapping/identity.js.map +1 -0
  146. package/dist/application/orm/mapping/observationMapping.d.ts +42 -0
  147. package/dist/application/orm/mapping/observationMapping.d.ts.map +1 -0
  148. package/dist/application/orm/mapping/observationMapping.js +65 -0
  149. package/dist/application/orm/mapping/observationMapping.js.map +1 -0
  150. package/dist/application/orm/mapping/projection.d.ts +22 -0
  151. package/dist/application/orm/mapping/projection.d.ts.map +1 -0
  152. package/dist/application/orm/mapping/projection.js +74 -0
  153. package/dist/application/orm/mapping/projection.js.map +1 -0
  154. package/dist/application/orm/mapping/registry.d.ts +15 -0
  155. package/dist/application/orm/mapping/registry.d.ts.map +1 -0
  156. package/dist/application/orm/mapping/registry.js +38 -0
  157. package/dist/application/orm/mapping/registry.js.map +1 -0
  158. package/dist/application/orm/mapping/values.d.ts +17 -0
  159. package/dist/application/orm/mapping/values.d.ts.map +1 -0
  160. package/dist/application/orm/mapping/values.js +141 -0
  161. package/dist/application/orm/mapping/values.js.map +1 -0
  162. package/dist/application/orm/persistence/flush/flushCoordinator.d.ts +28 -0
  163. package/dist/application/orm/persistence/flush/flushCoordinator.d.ts.map +1 -0
  164. package/dist/application/orm/persistence/flush/flushCoordinator.js +170 -0
  165. package/dist/application/orm/persistence/flush/flushCoordinator.js.map +1 -0
  166. package/dist/application/orm/persistence/flush/mappedFlushCoordinator.d.ts +9 -0
  167. package/dist/application/orm/persistence/flush/mappedFlushCoordinator.d.ts.map +1 -0
  168. package/dist/application/orm/persistence/flush/mappedFlushCoordinator.js +8 -0
  169. package/dist/application/orm/persistence/flush/mappedFlushCoordinator.js.map +1 -0
  170. package/dist/application/orm/persistence/lifecycle/entityLifecycle.d.ts +12 -0
  171. package/dist/application/orm/persistence/lifecycle/entityLifecycle.d.ts.map +1 -0
  172. package/dist/application/orm/persistence/lifecycle/entityLifecycle.js +134 -0
  173. package/dist/application/orm/persistence/lifecycle/entityLifecycle.js.map +1 -0
  174. package/dist/application/orm/persistence/projection/projectionEffects.d.ts +21 -0
  175. package/dist/application/orm/persistence/projection/projectionEffects.d.ts.map +1 -0
  176. package/dist/application/orm/persistence/projection/projectionEffects.js +203 -0
  177. package/dist/application/orm/persistence/projection/projectionEffects.js.map +1 -0
  178. package/dist/application/orm/persistence/support/businessKeys.d.ts +17 -0
  179. package/dist/application/orm/persistence/support/businessKeys.d.ts.map +1 -0
  180. package/dist/application/orm/persistence/support/businessKeys.js +72 -0
  181. package/dist/application/orm/persistence/support/businessKeys.js.map +1 -0
  182. package/dist/application/orm/persistence/support/canonicalState.d.ts +22 -0
  183. package/dist/application/orm/persistence/support/canonicalState.d.ts.map +1 -0
  184. package/dist/application/orm/persistence/support/canonicalState.js +88 -0
  185. package/dist/application/orm/persistence/support/canonicalState.js.map +1 -0
  186. package/dist/application/orm/persistence/support/contracts.d.ts +139 -0
  187. package/dist/application/orm/persistence/support/contracts.d.ts.map +1 -0
  188. package/dist/application/orm/persistence/support/contracts.js +93 -0
  189. package/dist/application/orm/persistence/support/contracts.js.map +1 -0
  190. package/dist/application/orm/persistence/support/helpers.d.ts +32 -0
  191. package/dist/application/orm/persistence/support/helpers.d.ts.map +1 -0
  192. package/dist/application/orm/persistence/support/helpers.js +66 -0
  193. package/dist/application/orm/persistence/support/helpers.js.map +1 -0
  194. package/dist/application/orm/persistence/support/timing.d.ts +20 -0
  195. package/dist/application/orm/persistence/support/timing.d.ts.map +1 -0
  196. package/dist/application/orm/persistence/support/timing.js +55 -0
  197. package/dist/application/orm/persistence/support/timing.js.map +1 -0
  198. package/dist/application/sync/gateway/SyncGatewayBootstrap.d.ts +46 -0
  199. package/dist/application/sync/gateway/SyncGatewayBootstrap.d.ts.map +1 -0
  200. package/dist/application/sync/gateway/SyncGatewayBootstrap.js +93 -0
  201. package/dist/application/sync/gateway/SyncGatewayBootstrap.js.map +1 -0
  202. package/dist/application/sync/gateway/constants.d.ts +65 -0
  203. package/dist/application/sync/gateway/constants.d.ts.map +1 -0
  204. package/dist/application/sync/gateway/constants.js +57 -0
  205. package/dist/application/sync/gateway/constants.js.map +1 -0
  206. package/dist/application/sync/gateway/errors.d.ts +15 -0
  207. package/dist/application/sync/gateway/errors.d.ts.map +1 -0
  208. package/dist/application/sync/gateway/errors.js +16 -0
  209. package/dist/application/sync/gateway/errors.js.map +1 -0
  210. package/dist/application/sync/gateway/syncGateway.d.ts +313 -0
  211. package/dist/application/sync/gateway/syncGateway.d.ts.map +1 -0
  212. package/dist/application/sync/gateway/syncGateway.js +202 -0
  213. package/dist/application/sync/gateway/syncGateway.js.map +1 -0
  214. package/dist/application/sync/gateway/validation.d.ts +17 -0
  215. package/dist/application/sync/gateway/validation.d.ts.map +1 -0
  216. package/dist/application/sync/gateway/validation.js +60 -0
  217. package/dist/application/sync/gateway/validation.js.map +1 -0
  218. package/dist/application/sync/inbound/polling/SimpleSheetPolling.d.ts +72 -0
  219. package/dist/application/sync/inbound/polling/SimpleSheetPolling.d.ts.map +1 -0
  220. package/dist/application/sync/inbound/polling/SimpleSheetPolling.js +272 -0
  221. package/dist/application/sync/inbound/polling/SimpleSheetPolling.js.map +1 -0
  222. package/dist/application/sync/index.d.ts +16 -0
  223. package/dist/application/sync/index.d.ts.map +1 -0
  224. package/dist/application/sync/index.js +9 -0
  225. package/dist/application/sync/index.js.map +1 -0
  226. package/dist/application/sync/outbound/effects/SyncEffectSupervisor.d.ts +106 -0
  227. package/dist/application/sync/outbound/effects/SyncEffectSupervisor.d.ts.map +1 -0
  228. package/dist/application/sync/outbound/effects/SyncEffectSupervisor.js +297 -0
  229. package/dist/application/sync/outbound/effects/SyncEffectSupervisor.js.map +1 -0
  230. package/dist/application/sync/outbound/effects/SyncEffectWorker.d.ts +100 -0
  231. package/dist/application/sync/outbound/effects/SyncEffectWorker.d.ts.map +1 -0
  232. package/dist/application/sync/outbound/effects/SyncEffectWorker.js +345 -0
  233. package/dist/application/sync/outbound/effects/SyncEffectWorker.js.map +1 -0
  234. package/dist/application/sync/outbound/effects/SyncEffectWorkerConstants.d.ts +46 -0
  235. package/dist/application/sync/outbound/effects/SyncEffectWorkerConstants.d.ts.map +1 -0
  236. package/dist/application/sync/outbound/effects/SyncEffectWorkerConstants.js +63 -0
  237. package/dist/application/sync/outbound/effects/SyncEffectWorkerConstants.js.map +1 -0
  238. package/dist/application/sync/outbound/effects/SyncEffectWorkerDispatch.d.ts +20 -0
  239. package/dist/application/sync/outbound/effects/SyncEffectWorkerDispatch.d.ts.map +1 -0
  240. package/dist/application/sync/outbound/effects/SyncEffectWorkerDispatch.js +102 -0
  241. package/dist/application/sync/outbound/effects/SyncEffectWorkerDispatch.js.map +1 -0
  242. package/dist/application/sync/outbound/effects/SyncEffectWorkerHelpers.d.ts +19 -0
  243. package/dist/application/sync/outbound/effects/SyncEffectWorkerHelpers.d.ts.map +1 -0
  244. package/dist/application/sync/outbound/effects/SyncEffectWorkerHelpers.js +32 -0
  245. package/dist/application/sync/outbound/effects/SyncEffectWorkerHelpers.js.map +1 -0
  246. package/dist/application/sync/outbound/effects/SyncEffectWorkerRouting.d.ts +30 -0
  247. package/dist/application/sync/outbound/effects/SyncEffectWorkerRouting.d.ts.map +1 -0
  248. package/dist/application/sync/outbound/effects/SyncEffectWorkerRouting.js +202 -0
  249. package/dist/application/sync/outbound/effects/SyncEffectWorkerRouting.js.map +1 -0
  250. package/dist/application/sync/outbound/effects/SyncEffectWorkerTiming.d.ts +17 -0
  251. package/dist/application/sync/outbound/effects/SyncEffectWorkerTiming.d.ts.map +1 -0
  252. package/dist/application/sync/outbound/effects/SyncEffectWorkerTiming.js +80 -0
  253. package/dist/application/sync/outbound/effects/SyncEffectWorkerTiming.js.map +1 -0
  254. package/dist/application/sync/outbound/effects/SyncEffectWorkerTransitions.d.ts +13 -0
  255. package/dist/application/sync/outbound/effects/SyncEffectWorkerTransitions.d.ts.map +1 -0
  256. package/dist/application/sync/outbound/effects/SyncEffectWorkerTransitions.js +205 -0
  257. package/dist/application/sync/outbound/effects/SyncEffectWorkerTransitions.js.map +1 -0
  258. package/dist/application/sync/outbound/projection/ProjectionEffectFactory.d.ts +81 -0
  259. package/dist/application/sync/outbound/projection/ProjectionEffectFactory.d.ts.map +1 -0
  260. package/dist/application/sync/outbound/projection/ProjectionEffectFactory.js +245 -0
  261. package/dist/application/sync/outbound/projection/ProjectionEffectFactory.js.map +1 -0
  262. package/dist/application/sync/outbound/reconciliation/ReconciliationScanner.d.ts +77 -0
  263. package/dist/application/sync/outbound/reconciliation/ReconciliationScanner.d.ts.map +1 -0
  264. package/dist/application/sync/outbound/reconciliation/ReconciliationScanner.js +518 -0
  265. package/dist/application/sync/outbound/reconciliation/ReconciliationScanner.js.map +1 -0
  266. package/dist/application/sync/telemetry/syncTiming.d.ts +50 -0
  267. package/dist/application/sync/telemetry/syncTiming.d.ts.map +1 -0
  268. package/dist/application/sync/telemetry/syncTiming.js +22 -0
  269. package/dist/application/sync/telemetry/syncTiming.js.map +1 -0
  270. package/dist/domain/conflict/errors.d.ts +42 -0
  271. package/dist/domain/conflict/errors.d.ts.map +1 -0
  272. package/dist/domain/conflict/errors.js +36 -0
  273. package/dist/domain/conflict/errors.js.map +1 -0
  274. package/dist/domain/conflict/index.d.ts +5 -0
  275. package/dist/domain/conflict/index.d.ts.map +1 -0
  276. package/dist/domain/conflict/index.js +3 -0
  277. package/dist/domain/conflict/index.js.map +1 -0
  278. package/dist/domain/conflict/transitions.d.ts +52 -0
  279. package/dist/domain/conflict/transitions.d.ts.map +1 -0
  280. package/dist/domain/conflict/transitions.js +115 -0
  281. package/dist/domain/conflict/transitions.js.map +1 -0
  282. package/dist/domain/errors/evaluation.d.ts +13 -0
  283. package/dist/domain/errors/evaluation.d.ts.map +1 -0
  284. package/dist/domain/errors/evaluation.js +14 -0
  285. package/dist/domain/errors/evaluation.js.map +1 -0
  286. package/dist/domain/errors/identity.d.ts +12 -0
  287. package/dist/domain/errors/identity.d.ts.map +1 -0
  288. package/dist/domain/errors/identity.js +15 -0
  289. package/dist/domain/errors/identity.js.map +1 -0
  290. package/dist/domain/errors/index.d.ts +7 -0
  291. package/dist/domain/errors/index.d.ts.map +1 -0
  292. package/dist/domain/errors/index.js +5 -0
  293. package/dist/domain/errors/index.js.map +1 -0
  294. package/dist/domain/errors/stableEncoding.d.ts +7 -0
  295. package/dist/domain/errors/stableEncoding.d.ts.map +1 -0
  296. package/dist/domain/errors/stableEncoding.js +8 -0
  297. package/dist/domain/errors/stableEncoding.js.map +1 -0
  298. package/dist/domain/errors/types.d.ts +20 -0
  299. package/dist/domain/errors/types.d.ts.map +1 -0
  300. package/dist/domain/errors/types.js +18 -0
  301. package/dist/domain/errors/types.js.map +1 -0
  302. package/dist/domain/evaluate/constants.d.ts +55 -0
  303. package/dist/domain/evaluate/constants.d.ts.map +1 -0
  304. package/dist/domain/evaluate/constants.js +41 -0
  305. package/dist/domain/evaluate/constants.js.map +1 -0
  306. package/dist/domain/evaluate/contracts.d.ts +125 -0
  307. package/dist/domain/evaluate/contracts.d.ts.map +1 -0
  308. package/dist/domain/evaluate/contracts.js +8 -0
  309. package/dist/domain/evaluate/contracts.js.map +1 -0
  310. package/dist/domain/evaluate/evaluateBatch.d.ts +11 -0
  311. package/dist/domain/evaluate/evaluateBatch.d.ts.map +1 -0
  312. package/dist/domain/evaluate/evaluateBatch.js +91 -0
  313. package/dist/domain/evaluate/evaluateBatch.js.map +1 -0
  314. package/dist/domain/evaluate/fieldEvaluation.d.ts +14 -0
  315. package/dist/domain/evaluate/fieldEvaluation.d.ts.map +1 -0
  316. package/dist/domain/evaluate/fieldEvaluation.js +133 -0
  317. package/dist/domain/evaluate/fieldEvaluation.js.map +1 -0
  318. package/dist/domain/evaluate/identity.d.ts +21 -0
  319. package/dist/domain/evaluate/identity.d.ts.map +1 -0
  320. package/dist/domain/evaluate/identity.js +72 -0
  321. package/dist/domain/evaluate/identity.js.map +1 -0
  322. package/dist/domain/evaluate/index.d.ts +4 -0
  323. package/dist/domain/evaluate/index.d.ts.map +1 -0
  324. package/dist/domain/evaluate/index.js +3 -0
  325. package/dist/domain/evaluate/index.js.map +1 -0
  326. package/dist/domain/evaluate/preconditions.d.ts +30 -0
  327. package/dist/domain/evaluate/preconditions.d.ts.map +1 -0
  328. package/dist/domain/evaluate/preconditions.js +389 -0
  329. package/dist/domain/evaluate/preconditions.js.map +1 -0
  330. package/dist/domain/evaluate/quarantine.d.ts +15 -0
  331. package/dist/domain/evaluate/quarantine.d.ts.map +1 -0
  332. package/dist/domain/evaluate/quarantine.js +185 -0
  333. package/dist/domain/evaluate/quarantine.js.map +1 -0
  334. package/dist/domain/index.d.ts +7 -0
  335. package/dist/domain/index.d.ts.map +1 -0
  336. package/dist/domain/index.js +7 -0
  337. package/dist/domain/index.js.map +1 -0
  338. package/dist/domain/model/constants.d.ts +73 -0
  339. package/dist/domain/model/constants.d.ts.map +1 -0
  340. package/dist/domain/model/constants.js +59 -0
  341. package/dist/domain/model/constants.js.map +1 -0
  342. package/dist/domain/model/index.d.ts +3 -0
  343. package/dist/domain/model/index.d.ts.map +1 -0
  344. package/dist/domain/model/index.js +2 -0
  345. package/dist/domain/model/index.js.map +1 -0
  346. package/dist/domain/model/types.d.ts +330 -0
  347. package/dist/domain/model/types.d.ts.map +1 -0
  348. package/dist/domain/model/types.js +8 -0
  349. package/dist/domain/model/types.js.map +1 -0
  350. package/dist/index.d.ts +17 -0
  351. package/dist/index.d.ts.map +1 -0
  352. package/dist/index.js +11 -0
  353. package/dist/index.js.map +1 -0
  354. package/dist/infrastructure/index.d.ts +3 -0
  355. package/dist/infrastructure/index.d.ts.map +1 -0
  356. package/dist/infrastructure/index.js +3 -0
  357. package/dist/infrastructure/index.js.map +1 -0
  358. package/dist/infrastructure/storage/constants.d.ts +4 -0
  359. package/dist/infrastructure/storage/constants.d.ts.map +1 -0
  360. package/dist/infrastructure/storage/constants.js +4 -0
  361. package/dist/infrastructure/storage/constants.js.map +1 -0
  362. package/dist/infrastructure/storage/errors.d.ts +55 -0
  363. package/dist/infrastructure/storage/errors.d.ts.map +1 -0
  364. package/dist/infrastructure/storage/errors.js +58 -0
  365. package/dist/infrastructure/storage/errors.js.map +1 -0
  366. package/dist/infrastructure/storage/index.d.ts +23 -0
  367. package/dist/infrastructure/storage/index.d.ts.map +1 -0
  368. package/dist/infrastructure/storage/index.js +13 -0
  369. package/dist/infrastructure/storage/index.js.map +1 -0
  370. package/dist/infrastructure/storage/recovery/restoreRecovery.d.ts +64 -0
  371. package/dist/infrastructure/storage/recovery/restoreRecovery.d.ts.map +1 -0
  372. package/dist/infrastructure/storage/recovery/restoreRecovery.js +148 -0
  373. package/dist/infrastructure/storage/recovery/restoreRecovery.js.map +1 -0
  374. package/dist/infrastructure/storage/sqlite/schema.d.ts +49 -0
  375. package/dist/infrastructure/storage/sqlite/schema.d.ts.map +1 -0
  376. package/dist/infrastructure/storage/sqlite/schema.js +529 -0
  377. package/dist/infrastructure/storage/sqlite/schema.js.map +1 -0
  378. package/dist/infrastructure/storage/sqlite/schemaTypes.d.ts +5 -0
  379. package/dist/infrastructure/storage/sqlite/schemaTypes.d.ts.map +1 -0
  380. package/dist/infrastructure/storage/sqlite/schemaTypes.js +2 -0
  381. package/dist/infrastructure/storage/sqlite/schemaTypes.js.map +1 -0
  382. package/dist/infrastructure/storage/sqlite/sqlScript.d.ts +9 -0
  383. package/dist/infrastructure/storage/sqlite/sqlScript.d.ts.map +1 -0
  384. package/dist/infrastructure/storage/sqlite/sqlScript.js +122 -0
  385. package/dist/infrastructure/storage/sqlite/sqlScript.js.map +1 -0
  386. package/dist/infrastructure/storage/sqlite/sqlState.d.ts +6 -0
  387. package/dist/infrastructure/storage/sqlite/sqlState.d.ts.map +1 -0
  388. package/dist/infrastructure/storage/sqlite/sqlState.js +14 -0
  389. package/dist/infrastructure/storage/sqlite/sqlState.js.map +1 -0
  390. package/dist/infrastructure/storage/sqlite/sqlTransaction.d.ts +6 -0
  391. package/dist/infrastructure/storage/sqlite/sqlTransaction.d.ts.map +1 -0
  392. package/dist/infrastructure/storage/sqlite/sqlTransaction.js +24 -0
  393. package/dist/infrastructure/storage/sqlite/sqlTransaction.js.map +1 -0
  394. package/dist/infrastructure/storage/sqlite/sqliteBridge.d.ts +44 -0
  395. package/dist/infrastructure/storage/sqlite/sqliteBridge.d.ts.map +1 -0
  396. package/dist/infrastructure/storage/sqlite/sqliteBridge.js +66 -0
  397. package/dist/infrastructure/storage/sqlite/sqliteBridge.js.map +1 -0
  398. package/dist/infrastructure/storage/state/canonical/canonicalCommit.d.ts +101 -0
  399. package/dist/infrastructure/storage/state/canonical/canonicalCommit.d.ts.map +1 -0
  400. package/dist/infrastructure/storage/state/canonical/canonicalCommit.js +417 -0
  401. package/dist/infrastructure/storage/state/canonical/canonicalCommit.js.map +1 -0
  402. package/dist/infrastructure/storage/state/observation/observationAudit.d.ts +16 -0
  403. package/dist/infrastructure/storage/state/observation/observationAudit.d.ts.map +1 -0
  404. package/dist/infrastructure/storage/state/observation/observationAudit.js +85 -0
  405. package/dist/infrastructure/storage/state/observation/observationAudit.js.map +1 -0
  406. package/dist/infrastructure/storage/state/observation/observationCanonical.d.ts +31 -0
  407. package/dist/infrastructure/storage/state/observation/observationCanonical.d.ts.map +1 -0
  408. package/dist/infrastructure/storage/state/observation/observationCanonical.js +439 -0
  409. package/dist/infrastructure/storage/state/observation/observationCanonical.js.map +1 -0
  410. package/dist/infrastructure/storage/state/observation/observationConstants.d.ts +53 -0
  411. package/dist/infrastructure/storage/state/observation/observationConstants.d.ts.map +1 -0
  412. package/dist/infrastructure/storage/state/observation/observationConstants.js +41 -0
  413. package/dist/infrastructure/storage/state/observation/observationConstants.js.map +1 -0
  414. package/dist/infrastructure/storage/state/observation/observationLedger.d.ts +49 -0
  415. package/dist/infrastructure/storage/state/observation/observationLedger.d.ts.map +1 -0
  416. package/dist/infrastructure/storage/state/observation/observationLedger.js +537 -0
  417. package/dist/infrastructure/storage/state/observation/observationLedger.js.map +1 -0
  418. package/dist/infrastructure/storage/state/observation/observationQuarantine.d.ts +15 -0
  419. package/dist/infrastructure/storage/state/observation/observationQuarantine.d.ts.map +1 -0
  420. package/dist/infrastructure/storage/state/observation/observationQuarantine.js +100 -0
  421. package/dist/infrastructure/storage/state/observation/observationQuarantine.js.map +1 -0
  422. package/dist/infrastructure/storage/state/observation/observationTypes.d.ts +124 -0
  423. package/dist/infrastructure/storage/state/observation/observationTypes.d.ts.map +1 -0
  424. package/dist/infrastructure/storage/state/observation/observationTypes.js +13 -0
  425. package/dist/infrastructure/storage/state/observation/observationTypes.js.map +1 -0
  426. package/dist/infrastructure/storage/state/observation/observationValidation.d.ts +28 -0
  427. package/dist/infrastructure/storage/state/observation/observationValidation.d.ts.map +1 -0
  428. package/dist/infrastructure/storage/state/observation/observationValidation.js +223 -0
  429. package/dist/infrastructure/storage/state/observation/observationValidation.js.map +1 -0
  430. package/dist/infrastructure/storage/state/observation/observationWriter.d.ts +28 -0
  431. package/dist/infrastructure/storage/state/observation/observationWriter.d.ts.map +1 -0
  432. package/dist/infrastructure/storage/state/observation/observationWriter.js +293 -0
  433. package/dist/infrastructure/storage/state/observation/observationWriter.js.map +1 -0
  434. package/dist/infrastructure/storage/state/readonly/readOnlyObservation.d.ts +58 -0
  435. package/dist/infrastructure/storage/state/readonly/readOnlyObservation.d.ts.map +1 -0
  436. package/dist/infrastructure/storage/state/readonly/readOnlyObservation.js +195 -0
  437. package/dist/infrastructure/storage/state/readonly/readOnlyObservation.js.map +1 -0
  438. package/dist/infrastructure/storage/state/resolution/resolutionWriter.d.ts +31 -0
  439. package/dist/infrastructure/storage/state/resolution/resolutionWriter.d.ts.map +1 -0
  440. package/dist/infrastructure/storage/state/resolution/resolutionWriter.js +563 -0
  441. package/dist/infrastructure/storage/state/resolution/resolutionWriter.js.map +1 -0
  442. package/dist/infrastructure/storage/state/resolution/resolutionWriterContracts.d.ts +118 -0
  443. package/dist/infrastructure/storage/state/resolution/resolutionWriterContracts.d.ts.map +1 -0
  444. package/dist/infrastructure/storage/state/resolution/resolutionWriterContracts.js +18 -0
  445. package/dist/infrastructure/storage/state/resolution/resolutionWriterContracts.js.map +1 -0
  446. package/dist/infrastructure/storage/state/resolution/resolutionWriterHelpers.d.ts +23 -0
  447. package/dist/infrastructure/storage/state/resolution/resolutionWriterHelpers.d.ts.map +1 -0
  448. package/dist/infrastructure/storage/state/resolution/resolutionWriterHelpers.js +84 -0
  449. package/dist/infrastructure/storage/state/resolution/resolutionWriterHelpers.js.map +1 -0
  450. package/dist/infrastructure/storage/state/resolution/resolutionWriterSql.d.ts +16 -0
  451. package/dist/infrastructure/storage/state/resolution/resolutionWriterSql.d.ts.map +1 -0
  452. package/dist/infrastructure/storage/state/resolution/resolutionWriterSql.js +97 -0
  453. package/dist/infrastructure/storage/state/resolution/resolutionWriterSql.js.map +1 -0
  454. package/dist/infrastructure/storage/sync/outbound/effectOutbox.d.ts +137 -0
  455. package/dist/infrastructure/storage/sync/outbound/effectOutbox.d.ts.map +1 -0
  456. package/dist/infrastructure/storage/sync/outbound/effectOutbox.js +396 -0
  457. package/dist/infrastructure/storage/sync/outbound/effectOutbox.js.map +1 -0
  458. package/dist/infrastructure/storage/sync/outbound/effectOutboxContracts.d.ts +101 -0
  459. package/dist/infrastructure/storage/sync/outbound/effectOutboxContracts.d.ts.map +1 -0
  460. package/dist/infrastructure/storage/sync/outbound/effectOutboxContracts.js +9 -0
  461. package/dist/infrastructure/storage/sync/outbound/effectOutboxContracts.js.map +1 -0
  462. package/dist/infrastructure/storage/sync/outbound/effectOutboxSql.d.ts +21 -0
  463. package/dist/infrastructure/storage/sync/outbound/effectOutboxSql.d.ts.map +1 -0
  464. package/dist/infrastructure/storage/sync/outbound/effectOutboxSql.js +184 -0
  465. package/dist/infrastructure/storage/sync/outbound/effectOutboxSql.js.map +1 -0
  466. package/dist/infrastructure/storage/sync/outbound/effectOutboxSupport.d.ts +25 -0
  467. package/dist/infrastructure/storage/sync/outbound/effectOutboxSupport.d.ts.map +1 -0
  468. package/dist/infrastructure/storage/sync/outbound/effectOutboxSupport.js +158 -0
  469. package/dist/infrastructure/storage/sync/outbound/effectOutboxSupport.js.map +1 -0
  470. package/dist/infrastructure/storage/sync/shared/syncRegistry.d.ts +69 -0
  471. package/dist/infrastructure/storage/sync/shared/syncRegistry.d.ts.map +1 -0
  472. package/dist/infrastructure/storage/sync/shared/syncRegistry.js +272 -0
  473. package/dist/infrastructure/storage/sync/shared/syncRegistry.js.map +1 -0
  474. package/dist/infrastructure/storage/sync/shared/writerLease.d.ts +90 -0
  475. package/dist/infrastructure/storage/sync/shared/writerLease.d.ts.map +1 -0
  476. package/dist/infrastructure/storage/sync/shared/writerLease.js +282 -0
  477. package/dist/infrastructure/storage/sync/shared/writerLease.js.map +1 -0
  478. package/dist/shared/constants.d.ts +8 -0
  479. package/dist/shared/constants.d.ts.map +1 -0
  480. package/dist/shared/constants.js +8 -0
  481. package/dist/shared/constants.js.map +1 -0
  482. package/dist/shared/encoding/constants.d.ts +45 -0
  483. package/dist/shared/encoding/constants.d.ts.map +1 -0
  484. package/dist/shared/encoding/constants.js +37 -0
  485. package/dist/shared/encoding/constants.js.map +1 -0
  486. package/dist/shared/encoding/index.d.ts +6 -0
  487. package/dist/shared/encoding/index.d.ts.map +1 -0
  488. package/dist/shared/encoding/index.js +4 -0
  489. package/dist/shared/encoding/index.js.map +1 -0
  490. package/dist/shared/encoding/stableEncode.d.ts +34 -0
  491. package/dist/shared/encoding/stableEncode.d.ts.map +1 -0
  492. package/dist/shared/encoding/stableEncode.js +210 -0
  493. package/dist/shared/encoding/stableEncode.js.map +1 -0
  494. package/dist/shared/encoding/typeGuards.d.ts +15 -0
  495. package/dist/shared/encoding/typeGuards.d.ts.map +1 -0
  496. package/dist/shared/encoding/typeGuards.js +11 -0
  497. package/dist/shared/encoding/typeGuards.js.map +1 -0
  498. package/dist/shared/encoding/types.d.ts +52 -0
  499. package/dist/shared/encoding/types.d.ts.map +1 -0
  500. package/dist/shared/encoding/types.js +8 -0
  501. package/dist/shared/encoding/types.js.map +1 -0
  502. package/dist/shared/index.d.ts +6 -0
  503. package/dist/shared/index.d.ts.map +1 -0
  504. package/dist/shared/index.js +6 -0
  505. package/dist/shared/index.js.map +1 -0
  506. package/dist/shared/state/constants.d.ts +16 -0
  507. package/dist/shared/state/constants.d.ts.map +1 -0
  508. package/dist/shared/state/constants.js +16 -0
  509. package/dist/shared/state/constants.js.map +1 -0
  510. package/dist/shared/state/index.d.ts +3 -0
  511. package/dist/shared/state/index.d.ts.map +1 -0
  512. package/dist/shared/state/index.js +2 -0
  513. package/dist/shared/state/index.js.map +1 -0
  514. package/dist/shared/state/types.d.ts +23 -0
  515. package/dist/shared/state/types.d.ts.map +1 -0
  516. package/dist/shared/state/types.js +2 -0
  517. package/dist/shared/state/types.js.map +1 -0
  518. package/dist/shared/validation.d.ts +9 -0
  519. package/dist/shared/validation.d.ts.map +1 -0
  520. package/dist/shared/validation.js +25 -0
  521. package/dist/shared/validation.js.map +1 -0
  522. package/docs/architecture.md +72 -0
  523. package/docs/code-guidelines.md +256 -0
  524. package/docs/development.md +48 -0
  525. package/docs/git-workflow.md +224 -0
  526. package/docs/mikro-orm-adapter-spike.md +248 -0
  527. package/docs/quick-start.md +102 -0
  528. package/docs/sql-layer-plan.md +59 -0
  529. package/docs/sync-bulk-write-benchmark.md +1036 -0
  530. package/docs/sync-observability.md +71 -0
  531. package/docs/task-queue-write-model.md +640 -0
  532. package/docs/typed-sheets-mvp-scope-2026-06-29.md +490 -0
  533. package/docs/typed-sheets-plan.md +417 -0
  534. package/docs/write-and-synchronization-flow.md +71 -0
  535. package/package.json +68 -0
@@ -0,0 +1,537 @@
1
+ /**
2
+ * Append-only observation and event ledger operations.
3
+ *
4
+ * These helpers run within the observation writer's already-fenced immediate
5
+ * transaction. They do not perform canonical or conflict mutation themselves.
6
+ */
7
+ import { randomUUID } from "node:crypto";
8
+ import { stableHash, LOOKUP_RESULT_KINDS, } from "../../../../domain/index.js";
9
+ import { ROW_OUTCOMES } from "../../../../domain/evaluate/constants.js";
10
+ import { PRESENCE_KINDS } from "../../../../shared/state/constants.js";
11
+ import { CONFLICT_STATUSES, ROW_BINDING_STATES, ROW_OPERATIONS, } from "../../../../domain/model/constants.js";
12
+ import { STORAGE_ERROR_CODES, StorageError } from "../../errors.js";
13
+ import { EMPTY_ARRAY_LENGTH_ZERO } from "../../constants.js";
14
+ import { fromSqlNullable, toSqlNullable } from "../../sqlite/sqlState.js";
15
+ import { OBSERVATION_APPEND_RESULT_KINDS, OBSERVATION_RECEIPT_STATES, } from "./observationConstants.js";
16
+ import { auditJson, rowHash } from "./observationAudit.js";
17
+ /** Returns the before snapshot, using SQL null only for insert rows. */
18
+ function observedBeforeRow(row) {
19
+ switch (row.operation) {
20
+ case ROW_OPERATIONS.INSERT:
21
+ return null;
22
+ case ROW_OPERATIONS.UPDATE:
23
+ case ROW_OPERATIONS.RENAME:
24
+ case ROW_OPERATIONS.DELETE:
25
+ return row.beforeRow;
26
+ }
27
+ }
28
+ /** Returns the after snapshot, using SQL null only for delete rows. */
29
+ function observedAfterRow(row) {
30
+ switch (row.operation) {
31
+ case ROW_OPERATIONS.INSERT:
32
+ case ROW_OPERATIONS.UPDATE:
33
+ case ROW_OPERATIONS.RENAME:
34
+ return row.afterRow;
35
+ case ROW_OPERATIONS.DELETE:
36
+ return null;
37
+ }
38
+ }
39
+ /** Appends an observation occurrence and classifies receipt replay semantics. */
40
+ export function appendObservation(db, batch, physicalSheetId, observation) {
41
+ const receipt = db.prepare(READ_OBSERVATION_RECEIPT_SQL)
42
+ .get(batch.sheetId, observation.observationKey);
43
+ const samePayload = receipt !== undefined &&
44
+ receipt.representative_payload_hash === observation.payloadHash;
45
+ const linkedEventId = samePayload ? receipt.event_id : null;
46
+ db.prepare(INSERT_EVENT_OBSERVATION_SQL).run(observation.observationId, batch.sheetId, physicalSheetId, observation.observationKey, linkedEventId, batch.source, observation.payloadJson, observation.payloadHash, observation.detectedAt, observation.receivedAt, observation.ingressActorId, toSqlNullable(observation.editorActorId), observation.editorActorSource);
47
+ if (receipt === undefined) {
48
+ db.prepare(INSERT_OBSERVATION_RECEIPT_SQL).run(batch.sheetId, observation.observationKey, observation.payloadHash, observation.observationId, observation.observationId, observation.receivedAt, observation.receivedAt);
49
+ return {
50
+ kind: OBSERVATION_APPEND_RESULT_KINDS.NEW,
51
+ eventId: fromSqlNullable(null),
52
+ };
53
+ }
54
+ const nextState = !samePayload
55
+ ? receipt.state
56
+ : receipt.state === OBSERVATION_RECEIPT_STATES.PENDING
57
+ ? OBSERVATION_RECEIPT_STATES.PENDING
58
+ : receipt.state === OBSERVATION_RECEIPT_STATES.QUARANTINED
59
+ ? OBSERVATION_RECEIPT_STATES.QUARANTINED
60
+ : OBSERVATION_RECEIPT_STATES.DUPLICATE;
61
+ db.prepare(UPDATE_OBSERVATION_RECEIPT_REPLAY_SQL).run(observation.observationId, observation.receivedAt, nextState, batch.sheetId, observation.observationKey);
62
+ if (!samePayload) {
63
+ return {
64
+ kind: OBSERVATION_APPEND_RESULT_KINDS.INTEGRITY_COLLISION,
65
+ eventId: fromSqlNullable(null),
66
+ };
67
+ }
68
+ if (receipt.state === OBSERVATION_RECEIPT_STATES.PENDING && receipt.event_id === null) {
69
+ return {
70
+ kind: OBSERVATION_APPEND_RESULT_KINDS.PENDING_REPLAY,
71
+ eventId: fromSqlNullable(null),
72
+ };
73
+ }
74
+ return {
75
+ kind: OBSERVATION_APPEND_RESULT_KINDS.DUPLICATE,
76
+ eventId: fromSqlNullable(receipt.event_id),
77
+ };
78
+ }
79
+ /**
80
+ * Appends an observation occurrence through the active async SQL transaction
81
+ * and classifies receipt replay semantics without leaking SQL nullability.
82
+ */
83
+ export async function appendObservationWithSql(sql, batch, physicalSheetId, observation) {
84
+ const receipt = await sql.get(READ_OBSERVATION_RECEIPT_SQL, [
85
+ batch.sheetId,
86
+ observation.observationKey,
87
+ ]);
88
+ const samePayload = receipt !== undefined &&
89
+ receipt.representative_payload_hash === observation.payloadHash;
90
+ const linkedEventId = samePayload ? receipt.event_id : null;
91
+ await sql.run(INSERT_EVENT_OBSERVATION_SQL, [
92
+ observation.observationId,
93
+ batch.sheetId,
94
+ physicalSheetId,
95
+ observation.observationKey,
96
+ linkedEventId,
97
+ batch.source,
98
+ observation.payloadJson,
99
+ observation.payloadHash,
100
+ observation.detectedAt,
101
+ observation.receivedAt,
102
+ observation.ingressActorId,
103
+ toSqlNullable(observation.editorActorId),
104
+ observation.editorActorSource,
105
+ ]);
106
+ if (receipt === undefined) {
107
+ await sql.run(INSERT_OBSERVATION_RECEIPT_SQL, [
108
+ batch.sheetId,
109
+ observation.observationKey,
110
+ observation.payloadHash,
111
+ observation.observationId,
112
+ observation.observationId,
113
+ observation.receivedAt,
114
+ observation.receivedAt,
115
+ ]);
116
+ return {
117
+ kind: OBSERVATION_APPEND_RESULT_KINDS.NEW,
118
+ eventId: fromSqlNullable(null),
119
+ };
120
+ }
121
+ const nextState = !samePayload
122
+ ? receipt.state
123
+ : receipt.state === OBSERVATION_RECEIPT_STATES.PENDING
124
+ ? OBSERVATION_RECEIPT_STATES.PENDING
125
+ : receipt.state === OBSERVATION_RECEIPT_STATES.QUARANTINED
126
+ ? OBSERVATION_RECEIPT_STATES.QUARANTINED
127
+ : OBSERVATION_RECEIPT_STATES.DUPLICATE;
128
+ await sql.run(UPDATE_OBSERVATION_RECEIPT_REPLAY_SQL, [
129
+ observation.observationId,
130
+ observation.receivedAt,
131
+ nextState,
132
+ batch.sheetId,
133
+ observation.observationKey,
134
+ ]);
135
+ if (!samePayload) {
136
+ return {
137
+ kind: OBSERVATION_APPEND_RESULT_KINDS.INTEGRITY_COLLISION,
138
+ eventId: fromSqlNullable(null),
139
+ };
140
+ }
141
+ if (receipt.state === OBSERVATION_RECEIPT_STATES.PENDING && receipt.event_id === null) {
142
+ return {
143
+ kind: OBSERVATION_APPEND_RESULT_KINDS.PENDING_REPLAY,
144
+ eventId: fromSqlNullable(null),
145
+ };
146
+ }
147
+ return {
148
+ kind: OBSERVATION_APPEND_RESULT_KINDS.DUPLICATE,
149
+ eventId: fromSqlNullable(receipt.event_id),
150
+ };
151
+ }
152
+ /** Completes the receipt after an event, duplicate, or quarantine outcome. */
153
+ export function completeObservation(db, logicalSheetId, observation, eventId, state) {
154
+ db.prepare(UPDATE_EVENT_OBSERVATION_EVENT_SQL)
155
+ .run(toSqlNullable(eventId), observation.observationId);
156
+ db.prepare(COMPLETE_OBSERVATION_RECEIPT_SQL)
157
+ .run(toSqlNullable(eventId), state, logicalSheetId, observation.observationKey);
158
+ }
159
+ /** Completes one observation receipt through the active async SQL transaction. */
160
+ export async function completeObservationWithSql(sql, logicalSheetId, observation, eventId, state) {
161
+ await sql.run(UPDATE_EVENT_OBSERVATION_EVENT_SQL, [
162
+ toSqlNullable(eventId),
163
+ observation.observationId,
164
+ ]);
165
+ await sql.run(COMPLETE_OBSERVATION_RECEIPT_SQL, [
166
+ toSqlNullable(eventId),
167
+ state,
168
+ logicalSheetId,
169
+ observation.observationKey,
170
+ ]);
171
+ }
172
+ /** Requires the binding identity that makes an event-bearing observation safe. */
173
+ export function requireKnownBinding(db, logicalSheetId, rowBindingId) {
174
+ const binding = db.prepare(READ_ROW_BINDING_SQL)
175
+ .get(rowBindingId, logicalSheetId);
176
+ if (binding === undefined) {
177
+ throw new StorageError(STORAGE_ERROR_CODES.OBSERVATION_STORAGE_INCONSISTENT, "event-bearing observations require a known row binding");
178
+ }
179
+ return {
180
+ entity_id: fromSqlNullable(binding.entity_id),
181
+ state: binding.state,
182
+ };
183
+ }
184
+ /** Requires a row binding through the active async SQL transaction. */
185
+ export async function requireKnownBindingWithSql(sql, logicalSheetId, rowBindingId) {
186
+ const binding = await sql.get(READ_ROW_BINDING_SQL, [
187
+ rowBindingId,
188
+ logicalSheetId,
189
+ ]);
190
+ if (binding === undefined) {
191
+ throw new StorageError(STORAGE_ERROR_CODES.OBSERVATION_STORAGE_INCONSISTENT, "event-bearing observations require a known row binding");
192
+ }
193
+ return {
194
+ entity_id: fromSqlNullable(binding.entity_id),
195
+ state: binding.state,
196
+ };
197
+ }
198
+ /** Finds a duplicate event represented by an unchanged active conflict candidate. */
199
+ export function findMatchingCandidateEventId(db, input, row, binding) {
200
+ if (input.evaluation.outcome === ROW_OUTCOMES.QUARANTINE ||
201
+ input.evaluation.acceptedFields.length > 0 ||
202
+ input.evaluation.conflicts.length === EMPTY_ARRAY_LENGTH_ZERO ||
203
+ binding.state !== ROW_BINDING_STATES.ACTIVE ||
204
+ binding.entity_id.kind === PRESENCE_KINDS.ABSENT) {
205
+ return { kind: LOOKUP_RESULT_KINDS.NOT_FOUND };
206
+ }
207
+ const eventIds = new Set();
208
+ for (const conflict of input.evaluation.conflicts) {
209
+ const active = readActiveCandidate(db, input.physicalSheetId, input.batch.projection, row.rowBindingId, conflict.fieldName);
210
+ if (active.kind === LOOKUP_RESULT_KINDS.NOT_FOUND ||
211
+ (active.value.status !== CONFLICT_STATUSES.OPEN &&
212
+ active.value.status !== CONFLICT_STATUSES.NEEDS_REBASE) ||
213
+ active.value.active_candidate_hash !== candidateHash(conflict)) {
214
+ return { kind: LOOKUP_RESULT_KINDS.NOT_FOUND };
215
+ }
216
+ eventIds.add(active.value.event_id);
217
+ }
218
+ if (eventIds.size !== 1)
219
+ return { kind: LOOKUP_RESULT_KINDS.NOT_FOUND };
220
+ const eventId = [...eventIds][0];
221
+ return eventId === undefined
222
+ ? { kind: LOOKUP_RESULT_KINDS.NOT_FOUND }
223
+ : { kind: LOOKUP_RESULT_KINDS.FOUND, value: eventId };
224
+ }
225
+ /** Finds an unchanged active conflict candidate through the active async SQL transaction. */
226
+ export async function findMatchingCandidateEventIdWithSql(sql, input, row, binding) {
227
+ if (input.evaluation.outcome === ROW_OUTCOMES.QUARANTINE ||
228
+ input.evaluation.acceptedFields.length > 0 ||
229
+ input.evaluation.conflicts.length === EMPTY_ARRAY_LENGTH_ZERO ||
230
+ binding.state !== ROW_BINDING_STATES.ACTIVE ||
231
+ binding.entity_id.kind === PRESENCE_KINDS.ABSENT) {
232
+ return { kind: LOOKUP_RESULT_KINDS.NOT_FOUND };
233
+ }
234
+ const eventIds = new Set();
235
+ for (const conflict of input.evaluation.conflicts) {
236
+ const active = await readActiveCandidateWithSql(sql, input.physicalSheetId, input.batch.projection, row.rowBindingId, conflict.fieldName);
237
+ if (active.kind === LOOKUP_RESULT_KINDS.NOT_FOUND ||
238
+ (active.value.status !== CONFLICT_STATUSES.OPEN &&
239
+ active.value.status !== CONFLICT_STATUSES.NEEDS_REBASE) ||
240
+ active.value.active_candidate_hash !== candidateHash(conflict)) {
241
+ return { kind: LOOKUP_RESULT_KINDS.NOT_FOUND };
242
+ }
243
+ eventIds.add(active.value.event_id);
244
+ }
245
+ if (eventIds.size !== 1)
246
+ return { kind: LOOKUP_RESULT_KINDS.NOT_FOUND };
247
+ const eventId = [...eventIds][0];
248
+ return eventId === undefined
249
+ ? { kind: LOOKUP_RESULT_KINDS.NOT_FOUND }
250
+ : { kind: LOOKUP_RESULT_KINDS.FOUND, value: eventId };
251
+ }
252
+ /** Reads the currently visible unresolved candidate for one row field. */
253
+ export function readActiveCandidate(db, physicalSheetId, projection, rowBindingId, fieldName) {
254
+ const candidate = db.prepare(READ_ACTIVE_CANDIDATE_SQL)
255
+ .get(physicalSheetId, projection, rowBindingId, fieldName);
256
+ return candidate === undefined
257
+ ? { kind: LOOKUP_RESULT_KINDS.NOT_FOUND }
258
+ : { kind: LOOKUP_RESULT_KINDS.FOUND, value: candidate };
259
+ }
260
+ /** Reads the active candidate through the active async SQL transaction. */
261
+ export async function readActiveCandidateWithSql(sql, physicalSheetId, projection, rowBindingId, fieldName) {
262
+ const candidate = await sql.get(READ_ACTIVE_CANDIDATE_SQL, [
263
+ physicalSheetId,
264
+ projection,
265
+ rowBindingId,
266
+ fieldName,
267
+ ]);
268
+ return candidate === undefined
269
+ ? { kind: LOOKUP_RESULT_KINDS.NOT_FOUND }
270
+ : { kind: LOOKUP_RESULT_KINDS.FOUND, value: candidate };
271
+ }
272
+ /** Finds a prior event with the caller-supplied idempotency key. */
273
+ export function findEventByKey(db, logicalSheetId, eventKey) {
274
+ const event = db.prepare(READ_EVENT_BY_KEY_SQL)
275
+ .get(logicalSheetId, eventKey);
276
+ return event === undefined
277
+ ? { kind: LOOKUP_RESULT_KINDS.NOT_FOUND }
278
+ : { kind: LOOKUP_RESULT_KINDS.FOUND, value: event };
279
+ }
280
+ /** Finds an idempotent event key through the active async SQL transaction. */
281
+ export async function findEventByKeyWithSql(sql, logicalSheetId, eventKey) {
282
+ const event = await sql.get(READ_EVENT_BY_KEY_SQL, [logicalSheetId, eventKey]);
283
+ return event === undefined
284
+ ? { kind: LOOKUP_RESULT_KINDS.NOT_FOUND }
285
+ : { kind: LOOKUP_RESULT_KINDS.FOUND, value: event };
286
+ }
287
+ /** Creates the event log, row evidence, and field evidence for one new observation. */
288
+ export function createEvent(db, input, row) {
289
+ const eventIdentity = input.event;
290
+ if (eventIdentity.kind === PRESENCE_KINDS.ABSENT) {
291
+ throw new StorageError(STORAGE_ERROR_CODES.INVALID_OBSERVATION_INPUT, "cannot create an event without an identity");
292
+ }
293
+ const event = eventIdentity.value;
294
+ ensureEventBatch(db, input);
295
+ const sequenceRow = db.prepare(READ_NEXT_EVENT_SEQUENCE_SQL)
296
+ .get(input.batch.sheetId);
297
+ const eventSequence = sequenceRow?.next_sequence;
298
+ if (eventSequence === undefined || !Number.isSafeInteger(eventSequence)) {
299
+ throw new StorageError(STORAGE_ERROR_CODES.OBSERVATION_STORAGE_INCONSISTENT, "could not allocate the next event sequence");
300
+ }
301
+ const eventId = `event:${randomUUID()}`;
302
+ const status = input.evaluation.outcome === ROW_OUTCOMES.QUARANTINE
303
+ ? "quarantined"
304
+ : input.evaluation.conflicts.length > 0
305
+ ? ROW_OUTCOMES.CONFLICT
306
+ : ROW_OUTCOMES.ACCEPTED;
307
+ db.prepare(INSERT_EVENT_LOG_SQL).run(eventId, input.batch.sheetId, input.physicalSheetId, event.eventKey, event.payloadHash, eventSequence, input.batch.batchId, row.rowBindingId, row.operation, status, input.observation.receivedAt);
308
+ const beforeRow = observedBeforeRow(row);
309
+ const afterRow = observedAfterRow(row);
310
+ db.prepare(INSERT_EVENT_ROW_SQL).run(eventId, auditJson(beforeRow), auditJson(afterRow), rowHash(beforeRow, row.rowBindingId), rowHash(afterRow, row.rowBindingId));
311
+ for (const field of row.fields) {
312
+ db.prepare(INSERT_EVENT_FIELD_SQL).run(eventId, field.fieldName, auditJson(field.previousValue), auditJson(field.nextValue), field.baseFieldRevision);
313
+ }
314
+ return { eventId, eventSequence };
315
+ }
316
+ /** Creates the event and its evidence through the active async SQL transaction. */
317
+ export async function createEventWithSql(sql, input, row) {
318
+ const eventIdentity = input.event;
319
+ if (eventIdentity.kind === PRESENCE_KINDS.ABSENT) {
320
+ throw new StorageError(STORAGE_ERROR_CODES.INVALID_OBSERVATION_INPUT, "cannot create an event without an identity");
321
+ }
322
+ const event = eventIdentity.value;
323
+ await ensureEventBatchWithSql(sql, input);
324
+ const sequenceRow = await sql.get(READ_NEXT_EVENT_SEQUENCE_SQL, [
325
+ input.batch.sheetId,
326
+ ]);
327
+ const eventSequence = sequenceRow?.next_sequence;
328
+ if (eventSequence === undefined || !Number.isSafeInteger(eventSequence)) {
329
+ throw new StorageError(STORAGE_ERROR_CODES.OBSERVATION_STORAGE_INCONSISTENT, "could not allocate the next event sequence");
330
+ }
331
+ const eventId = `event:${randomUUID()}`;
332
+ const status = input.evaluation.outcome === ROW_OUTCOMES.QUARANTINE
333
+ ? "quarantined"
334
+ : input.evaluation.conflicts.length > 0
335
+ ? ROW_OUTCOMES.CONFLICT
336
+ : ROW_OUTCOMES.ACCEPTED;
337
+ await sql.run(INSERT_EVENT_LOG_SQL, [
338
+ eventId,
339
+ input.batch.sheetId,
340
+ input.physicalSheetId,
341
+ event.eventKey,
342
+ event.payloadHash,
343
+ eventSequence,
344
+ input.batch.batchId,
345
+ row.rowBindingId,
346
+ row.operation,
347
+ status,
348
+ input.observation.receivedAt,
349
+ ]);
350
+ const beforeRow = observedBeforeRow(row);
351
+ const afterRow = observedAfterRow(row);
352
+ await sql.run(INSERT_EVENT_ROW_SQL, [
353
+ eventId,
354
+ auditJson(beforeRow),
355
+ auditJson(afterRow),
356
+ rowHash(beforeRow, row.rowBindingId),
357
+ rowHash(afterRow, row.rowBindingId),
358
+ ]);
359
+ for (const field of row.fields) {
360
+ await sql.run(INSERT_EVENT_FIELD_SQL, [
361
+ eventId,
362
+ field.fieldName,
363
+ auditJson(field.previousValue),
364
+ auditJson(field.nextValue),
365
+ field.baseFieldRevision === undefined ? null : field.baseFieldRevision,
366
+ ]);
367
+ }
368
+ return { eventId, eventSequence };
369
+ }
370
+ /** Updates visible hashes after a new event has recorded its observed evidence. */
371
+ export function persistObservedHashes(db, input, row) {
372
+ db.prepare(UPDATE_VISIBLE_ROW_OBSERVED_HASH_SQL).run(rowHash(observedAfterRow(row), row.rowBindingId), input.physicalSheetId, input.batch.projection, row.rowBindingId);
373
+ for (const field of row.fields) {
374
+ db.prepare(UPDATE_VISIBLE_FIELD_OBSERVED_HASH_SQL).run(stableHash(field.nextValue), input.physicalSheetId, input.batch.projection, row.rowBindingId, field.fieldName);
375
+ }
376
+ }
377
+ /** Updates observed row and field hashes through the active async SQL transaction. */
378
+ export async function persistObservedHashesWithSql(sql, input, row) {
379
+ await sql.run(UPDATE_VISIBLE_ROW_OBSERVED_HASH_SQL, [
380
+ rowHash(observedAfterRow(row), row.rowBindingId),
381
+ input.physicalSheetId,
382
+ input.batch.projection,
383
+ row.rowBindingId,
384
+ ]);
385
+ for (const field of row.fields) {
386
+ await sql.run(UPDATE_VISIBLE_FIELD_OBSERVED_HASH_SQL, [
387
+ stableHash(field.nextValue),
388
+ input.physicalSheetId,
389
+ input.batch.projection,
390
+ row.rowBindingId,
391
+ field.fieldName,
392
+ ]);
393
+ }
394
+ }
395
+ /** Produces the idempotency hash for a visible unresolved field candidate. */
396
+ export function candidateHash(conflict) {
397
+ return stableHash({ value: conflict.userValue, revision: conflict.userBaseRevision });
398
+ }
399
+ function ensureEventBatch(db, input) {
400
+ const existing = db.prepare(READ_EVENT_BATCH_SQL)
401
+ .get(input.batch.batchId);
402
+ if (existing !== undefined) {
403
+ const matches = existing.logical_sheet_id === input.batch.sheetId &&
404
+ existing.physical_sheet_id === input.physicalSheetId &&
405
+ existing.source === input.batch.source &&
406
+ existing.projection === input.batch.projection &&
407
+ existing.atomicity === input.batch.atomicity &&
408
+ existing.base_snapshot_hash === input.batch.baseSnapshotHash;
409
+ if (!matches) {
410
+ throw new StorageError(STORAGE_ERROR_CODES.OBSERVATION_STORAGE_INCONSISTENT, "batch ID was replayed with different batch identity");
411
+ }
412
+ return;
413
+ }
414
+ db.prepare(INSERT_EVENT_BATCH_SQL).run(input.batch.batchId, input.batch.sheetId, input.physicalSheetId, input.batch.source, input.batch.projection, input.batch.atomicity, input.batch.baseSnapshotHash);
415
+ }
416
+ /** Creates or verifies the idempotent batch identity through active async SQL. */
417
+ async function ensureEventBatchWithSql(sql, input) {
418
+ const existing = await sql.get(READ_EVENT_BATCH_SQL, [input.batch.batchId]);
419
+ if (existing !== undefined) {
420
+ const matches = existing.logical_sheet_id === input.batch.sheetId &&
421
+ existing.physical_sheet_id === input.physicalSheetId &&
422
+ existing.source === input.batch.source &&
423
+ existing.projection === input.batch.projection &&
424
+ existing.atomicity === input.batch.atomicity &&
425
+ existing.base_snapshot_hash === input.batch.baseSnapshotHash;
426
+ if (!matches) {
427
+ throw new StorageError(STORAGE_ERROR_CODES.OBSERVATION_STORAGE_INCONSISTENT, "batch ID was replayed with different batch identity");
428
+ }
429
+ return;
430
+ }
431
+ await sql.run(INSERT_EVENT_BATCH_SQL, [
432
+ input.batch.batchId,
433
+ input.batch.sheetId,
434
+ input.physicalSheetId,
435
+ input.batch.source,
436
+ input.batch.projection,
437
+ input.batch.atomicity,
438
+ input.batch.baseSnapshotHash,
439
+ ]);
440
+ }
441
+ const READ_OBSERVATION_RECEIPT_SQL = `
442
+ SELECT representative_payload_hash, event_id, state
443
+ FROM observation_receipt
444
+ WHERE logical_sheet_id = ? AND observation_key = ?
445
+ `;
446
+ const INSERT_EVENT_OBSERVATION_SQL = `
447
+ INSERT INTO event_observation (
448
+ observation_id, logical_sheet_id, physical_sheet_id, observation_key, event_id,
449
+ source, payload_json, payload_hash, detected_at, received_at, ingress_actor_id,
450
+ editor_actor_id, editor_actor_source
451
+ ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
452
+ `;
453
+ const INSERT_OBSERVATION_RECEIPT_SQL = `
454
+ INSERT INTO observation_receipt (
455
+ logical_sheet_id, observation_key, representative_payload_hash,
456
+ first_observation_id, last_observation_id, event_id, state,
457
+ first_seen_at, last_seen_at
458
+ ) VALUES (?, ?, ?, ?, ?, NULL, '${OBSERVATION_RECEIPT_STATES.PENDING}', ?, ?)
459
+ `;
460
+ const UPDATE_OBSERVATION_RECEIPT_REPLAY_SQL = `
461
+ UPDATE observation_receipt
462
+ SET last_observation_id = ?, last_seen_at = ?, state = ?
463
+ WHERE logical_sheet_id = ? AND observation_key = ?
464
+ `;
465
+ const UPDATE_EVENT_OBSERVATION_EVENT_SQL = `
466
+ UPDATE event_observation
467
+ SET event_id = ?
468
+ WHERE observation_id = ?
469
+ `;
470
+ const COMPLETE_OBSERVATION_RECEIPT_SQL = `
471
+ UPDATE observation_receipt
472
+ SET event_id = ?, state = ?
473
+ WHERE logical_sheet_id = ? AND observation_key = ?
474
+ `;
475
+ const READ_ROW_BINDING_SQL = `
476
+ SELECT entity_id, state
477
+ FROM row_binding
478
+ WHERE row_binding_id = ? AND logical_sheet_id = ?
479
+ `;
480
+ const READ_ACTIVE_CANDIDATE_SQL = `
481
+ SELECT visible.active_candidate_conflict_id, visible.active_candidate_hash,
482
+ visible.candidate_epoch, conflict.event_id, conflict.status
483
+ FROM sheet_visible_field_state AS visible
484
+ JOIN sync_conflict AS conflict
485
+ ON conflict.conflict_id = visible.active_candidate_conflict_id
486
+ WHERE visible.physical_sheet_id = ? AND visible.projection = ?
487
+ AND visible.row_binding_id = ? AND visible.field_name = ?
488
+ AND visible.active_candidate_conflict_id IS NOT NULL
489
+ AND visible.active_candidate_hash IS NOT NULL
490
+ `;
491
+ const READ_EVENT_BY_KEY_SQL = `
492
+ SELECT event_id, payload_hash, event_sequence
493
+ FROM event_log
494
+ WHERE logical_sheet_id = ? AND event_key = ?
495
+ `;
496
+ const READ_NEXT_EVENT_SEQUENCE_SQL = `
497
+ SELECT COALESCE(MAX(event_sequence), 0) + 1 AS next_sequence
498
+ FROM event_log
499
+ WHERE logical_sheet_id = ?
500
+ `;
501
+ const INSERT_EVENT_LOG_SQL = `
502
+ INSERT INTO event_log (
503
+ event_id, logical_sheet_id, physical_sheet_id, event_key, payload_hash,
504
+ event_sequence, batch_id, row_binding_id, operation, status, received_at
505
+ ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
506
+ `;
507
+ const INSERT_EVENT_ROW_SQL = `
508
+ INSERT INTO event_row (event_id, before_row_json, after_row_json, before_hash, after_hash)
509
+ VALUES (?, ?, ?, ?, ?)
510
+ `;
511
+ const INSERT_EVENT_FIELD_SQL = `
512
+ INSERT INTO event_field (
513
+ event_id, field_name, previous_value, next_value, base_field_revision
514
+ ) VALUES (?, ?, ?, ?, ?)
515
+ `;
516
+ const UPDATE_VISIBLE_ROW_OBSERVED_HASH_SQL = `
517
+ UPDATE sheet_visible_state
518
+ SET last_observed_hash = ?
519
+ WHERE physical_sheet_id = ? AND projection = ? AND row_binding_id = ?
520
+ `;
521
+ const UPDATE_VISIBLE_FIELD_OBSERVED_HASH_SQL = `
522
+ UPDATE sheet_visible_field_state
523
+ SET last_observed_field_hash = ?
524
+ WHERE physical_sheet_id = ? AND projection = ?
525
+ AND row_binding_id = ? AND field_name = ?
526
+ `;
527
+ const READ_EVENT_BATCH_SQL = `
528
+ SELECT logical_sheet_id, physical_sheet_id, source, projection, atomicity, base_snapshot_hash
529
+ FROM event_batch
530
+ WHERE batch_id = ?
531
+ `;
532
+ const INSERT_EVENT_BATCH_SQL = `
533
+ INSERT INTO event_batch (
534
+ batch_id, logical_sheet_id, physical_sheet_id, source, projection, atomicity, base_snapshot_hash
535
+ ) VALUES (?, ?, ?, ?, ?, ?, ?)
536
+ `;
537
+ //# sourceMappingURL=observationLedger.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"observationLedger.js","sourceRoot":"","sources":["../../../../../src/infrastructure/storage/state/observation/observationLedger.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,15 @@
1
+ /** Quarantine persistence for invalid or unresolvable observed rows. */
2
+ import { type ObservedRowChange, type Presence, type QuarantinePlan } from "../../../../domain/index.js";
3
+ import type { DatabaseSyncLike } from "../../sqlite/sqliteBridge.js";
4
+ import type { SqlExecutor } from "../../../../adapter/persistence/contracts/sql.js";
5
+ import type { ObservationIntegrityDiscriminator } from "./observationConstants.js";
6
+ import type { PersistObservedRowInput } from "./observationTypes.js";
7
+ /** Persists a deterministic quarantine for incompatible receipt or event identity. */
8
+ export declare function persistIntegrityQuarantine(db: DatabaseSyncLike, input: PersistObservedRowInput, row: ObservedRowChange, eventId: Presence<string>, discriminator: ObservationIntegrityDiscriminator): string;
9
+ /** Persists an integrity quarantine through the active async SQL transaction. */
10
+ export declare function persistIntegrityQuarantineWithSql(sql: SqlExecutor, input: PersistObservedRowInput, row: ObservedRowChange, eventId: Presence<string>, discriminator: ObservationIntegrityDiscriminator): Promise<string>;
11
+ /** Inserts a core-provided quarantine plan once and retains its raw evidence. */
12
+ export declare function persistQuarantine(db: DatabaseSyncLike, input: PersistObservedRowInput, quarantine: QuarantinePlan, eventId: Presence<string>): string;
13
+ /** Inserts a core-provided quarantine plan through the active async SQL transaction. */
14
+ export declare function persistQuarantineWithSql(sql: SqlExecutor, input: PersistObservedRowInput, quarantine: QuarantinePlan, eventId: Presence<string>): Promise<string>;
15
+ //# sourceMappingURL=observationQuarantine.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"observationQuarantine.d.ts","sourceRoot":"","sources":["../../../../../src/infrastructure/storage/state/observation/observationQuarantine.ts"],"names":[],"mappings":"AAAA,wEAAwE;AAExE,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,QAAQ,EACb,KAAK,cAAc,EACpB,MAAM,6BAA6B,CAAC;AAOrC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kDAAkD,CAAC;AAEpF,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,2BAA2B,CAAC;AACnF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAWrE,sFAAsF;AACtF,wBAAgB,0BAA0B,CACxC,EAAE,EAAE,gBAAgB,EACpB,KAAK,EAAE,uBAAuB,EAC9B,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,EACzB,aAAa,EAAE,iCAAiC,GAC/C,MAAM,CAGR;AAED,iFAAiF;AACjF,wBAAsB,iCAAiC,CACrD,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,uBAAuB,EAC9B,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,EACzB,aAAa,EAAE,iCAAiC,GAC/C,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,gBAAgB,EACpB,KAAK,EAAE,uBAAuB,EAC9B,UAAU,EAAE,cAAc,EAC1B,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,GACxB,MAAM,CA4BR;AAED,wFAAwF;AACxF,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,uBAAuB,EAC9B,UAAU,EAAE,cAAc,EAC1B,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,GACxB,OAAO,CAAC,MAAM,CAAC,CA4BjB"}