@cratis/chronicle 6.60.0 → 6.62.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 (379) hide show
  1. package/connection/ChronicleConnection.ts +7 -1
  2. package/connection/ChronicleServices.ts +2 -0
  3. package/dist/connection/ChronicleConnection.d.ts +1 -0
  4. package/dist/connection/ChronicleConnection.d.ts.map +1 -1
  5. package/dist/connection/ChronicleConnection.js +6 -2
  6. package/dist/connection/ChronicleConnection.js.map +1 -1
  7. package/dist/connection/ChronicleServices.d.ts +2 -1
  8. package/dist/connection/ChronicleServices.d.ts.map +1 -1
  9. package/dist/eventSequences/EventForEventSourceId.d.ts +21 -1
  10. package/dist/eventSequences/EventForEventSourceId.d.ts.map +1 -1
  11. package/dist/eventSequences/EventSequence.d.ts +9 -0
  12. package/dist/eventSequences/EventSequence.d.ts.map +1 -1
  13. package/dist/eventSequences/EventSequence.js +18 -0
  14. package/dist/eventSequences/EventSequence.js.map +1 -1
  15. package/dist/eventSequences/IEventSequence.d.ts +30 -0
  16. package/dist/eventSequences/IEventSequence.d.ts.map +1 -1
  17. package/dist/imports/EventImport.d.ts +29 -0
  18. package/dist/imports/EventImport.d.ts.map +1 -0
  19. package/dist/imports/EventImport.js +248 -0
  20. package/dist/imports/EventImport.js.map +1 -0
  21. package/dist/imports/EventImportSettings.d.ts +32 -0
  22. package/dist/imports/EventImportSettings.d.ts.map +1 -0
  23. package/dist/imports/EventImportSettings.js +4 -0
  24. package/dist/imports/EventImportSettings.js.map +1 -0
  25. package/dist/imports/IEventImport.d.ts +50 -0
  26. package/dist/imports/IEventImport.d.ts.map +1 -0
  27. package/dist/imports/IEventImport.js +4 -0
  28. package/dist/imports/IEventImport.js.map +1 -0
  29. package/dist/imports/ImportChunkRefused.d.ts +12 -0
  30. package/dist/imports/ImportChunkRefused.d.ts.map +1 -0
  31. package/dist/imports/ImportChunkRefused.js +19 -0
  32. package/dist/imports/ImportChunkRefused.js.map +1 -0
  33. package/dist/imports/ImportCouldNotBegin.d.ts +10 -0
  34. package/dist/imports/ImportCouldNotBegin.d.ts.map +1 -0
  35. package/dist/imports/ImportCouldNotBegin.js +16 -0
  36. package/dist/imports/ImportCouldNotBegin.js.map +1 -0
  37. package/dist/imports/ImportOptions.d.ts +26 -0
  38. package/dist/imports/ImportOptions.d.ts.map +1 -0
  39. package/dist/imports/ImportOptions.js +4 -0
  40. package/dist/imports/ImportOptions.js.map +1 -0
  41. package/dist/imports/ImportProgress.d.ts +20 -0
  42. package/dist/imports/ImportProgress.d.ts.map +1 -0
  43. package/dist/imports/ImportProgress.js +4 -0
  44. package/dist/imports/ImportProgress.js.map +1 -0
  45. package/dist/imports/ImportRejection.d.ts +10 -0
  46. package/dist/imports/ImportRejection.d.ts.map +1 -0
  47. package/dist/imports/ImportRejection.js +4 -0
  48. package/dist/imports/ImportRejection.js.map +1 -0
  49. package/dist/imports/ImportResult.d.ts +30 -0
  50. package/dist/imports/ImportResult.d.ts.map +1 -0
  51. package/dist/imports/ImportResult.js +4 -0
  52. package/dist/imports/ImportResult.js.map +1 -0
  53. package/dist/imports/ImportState.d.ts +18 -0
  54. package/dist/imports/ImportState.d.ts.map +1 -0
  55. package/dist/imports/ImportState.js +21 -0
  56. package/dist/imports/ImportState.js.map +1 -0
  57. package/dist/imports/ImportTarget.d.ts +16 -0
  58. package/dist/imports/ImportTarget.d.ts.map +1 -0
  59. package/dist/imports/ImportTarget.js +4 -0
  60. package/dist/imports/ImportTarget.js.map +1 -0
  61. package/dist/imports/ImportWasAbandoned.d.ts +11 -0
  62. package/dist/imports/ImportWasAbandoned.d.ts.map +1 -0
  63. package/dist/imports/ImportWasAbandoned.js +16 -0
  64. package/dist/imports/ImportWasAbandoned.js.map +1 -0
  65. package/dist/imports/ImportsNotSupported.d.ts +5 -0
  66. package/dist/imports/ImportsNotSupported.d.ts.map +1 -0
  67. package/dist/imports/ImportsNotSupported.js +10 -0
  68. package/dist/imports/ImportsNotSupported.js.map +1 -0
  69. package/dist/imports/OnInvalidEvent.d.ts +8 -0
  70. package/dist/imports/OnInvalidEvent.d.ts.map +1 -0
  71. package/dist/imports/OnInvalidEvent.js +11 -0
  72. package/dist/imports/OnInvalidEvent.js.map +1 -0
  73. package/dist/imports/abortable.d.ts +23 -0
  74. package/dist/imports/abortable.d.ts.map +1 -0
  75. package/dist/imports/abortable.js +60 -0
  76. package/dist/imports/abortable.js.map +1 -0
  77. package/dist/imports/beginEventImport.d.ts +16 -0
  78. package/dist/imports/beginEventImport.d.ts.map +1 -0
  79. package/dist/imports/beginEventImport.js +74 -0
  80. package/dist/imports/beginEventImport.js.map +1 -0
  81. package/dist/imports/for_EventImport/given/a_kernel_import_session.d.ts +144 -0
  82. package/dist/imports/for_EventImport/given/a_kernel_import_session.d.ts.map +1 -0
  83. package/dist/imports/for_EventImport/given/a_kernel_import_session.js +132 -0
  84. package/dist/imports/for_EventImport/given/a_kernel_import_session.js.map +1 -0
  85. package/dist/imports/importEvents.d.ts +13 -0
  86. package/dist/imports/importEvents.d.ts.map +1 -0
  87. package/dist/imports/importEvents.js +35 -0
  88. package/dist/imports/importEvents.js.map +1 -0
  89. package/dist/imports/index.d.ts +12 -0
  90. package/dist/imports/index.d.ts.map +1 -0
  91. package/dist/imports/index.js +9 -0
  92. package/dist/imports/index.js.map +1 -0
  93. package/dist/imports/isTransientImportFailure.d.ts +7 -0
  94. package/dist/imports/isTransientImportFailure.d.ts.map +1 -0
  95. package/dist/imports/isTransientImportFailure.js +13 -0
  96. package/dist/imports/isTransientImportFailure.js.map +1 -0
  97. package/dist/imports/sizeOfImportEvent.d.ts +9 -0
  98. package/dist/imports/sizeOfImportEvent.d.ts.map +1 -0
  99. package/dist/imports/sizeOfImportEvent.js +25 -0
  100. package/dist/imports/sizeOfImportEvent.js.map +1 -0
  101. package/dist/imports/toImportEvent.d.ts +14 -0
  102. package/dist/imports/toImportEvent.d.ts.map +1 -0
  103. package/dist/imports/toImportEvent.js +54 -0
  104. package/dist/imports/toImportEvent.js.map +1 -0
  105. package/dist/imports/toImportProgress.d.ts +9 -0
  106. package/dist/imports/toImportProgress.d.ts.map +1 -0
  107. package/dist/imports/toImportProgress.js +20 -0
  108. package/dist/imports/toImportProgress.js.map +1 -0
  109. package/dist/imports/toImportResult.d.ts +9 -0
  110. package/dist/imports/toImportResult.d.ts.map +1 -0
  111. package/dist/imports/toImportResult.js +33 -0
  112. package/dist/imports/toImportResult.js.map +1 -0
  113. package/dist/index.d.ts +3 -1
  114. package/dist/index.d.ts.map +1 -1
  115. package/dist/index.js +3 -1
  116. package/dist/index.js.map +1 -1
  117. package/dist/observation/index.d.ts +2 -0
  118. package/dist/observation/index.d.ts.map +1 -1
  119. package/dist/observation/index.js +1 -0
  120. package/dist/observation/index.js.map +1 -1
  121. package/dist/projections/ChildrenOrderingNotSupportedByContracts.d.ts +15 -0
  122. package/dist/projections/ChildrenOrderingNotSupportedByContracts.d.ts.map +1 -0
  123. package/dist/projections/ChildrenOrderingNotSupportedByContracts.js +22 -0
  124. package/dist/projections/ChildrenOrderingNotSupportedByContracts.js.map +1 -0
  125. package/dist/projections/InvalidCausedByProperty.d.ts +10 -0
  126. package/dist/projections/InvalidCausedByProperty.d.ts.map +1 -0
  127. package/dist/projections/InvalidCausedByProperty.js +16 -0
  128. package/dist/projections/InvalidCausedByProperty.js.map +1 -0
  129. package/dist/projections/Projections.d.ts.map +1 -1
  130. package/dist/projections/Projections.js +4 -0
  131. package/dist/projections/Projections.js.map +1 -1
  132. package/dist/projections/causedBy.d.ts +15 -0
  133. package/dist/projections/causedBy.d.ts.map +1 -0
  134. package/dist/projections/causedBy.js +24 -0
  135. package/dist/projections/causedBy.js.map +1 -0
  136. package/dist/projections/childrenOrdering.d.ts +38 -0
  137. package/dist/projections/childrenOrdering.d.ts.map +1 -0
  138. package/dist/projections/childrenOrdering.js +37 -0
  139. package/dist/projections/childrenOrdering.js.map +1 -0
  140. package/dist/projections/childrenOrderingSupport.d.ts +14 -0
  141. package/dist/projections/childrenOrderingSupport.d.ts.map +1 -0
  142. package/dist/projections/childrenOrderingSupport.js +37 -0
  143. package/dist/projections/childrenOrderingSupport.js.map +1 -0
  144. package/dist/projections/declarative/AllSetBuilder.d.ts +3 -0
  145. package/dist/projections/declarative/AllSetBuilder.d.ts.map +1 -1
  146. package/dist/projections/declarative/AllSetBuilder.js +6 -0
  147. package/dist/projections/declarative/AllSetBuilder.js.map +1 -1
  148. package/dist/projections/declarative/ChildrenBuilder.d.ts +9 -0
  149. package/dist/projections/declarative/ChildrenBuilder.d.ts.map +1 -1
  150. package/dist/projections/declarative/ChildrenBuilder.js +29 -1
  151. package/dist/projections/declarative/ChildrenBuilder.js.map +1 -1
  152. package/dist/projections/declarative/ChildrenOrderingAlreadyDefined.d.ts +6 -0
  153. package/dist/projections/declarative/ChildrenOrderingAlreadyDefined.d.ts.map +1 -0
  154. package/dist/projections/declarative/ChildrenOrderingAlreadyDefined.js +11 -0
  155. package/dist/projections/declarative/ChildrenOrderingAlreadyDefined.js.map +1 -0
  156. package/dist/projections/declarative/DictionaryKey.d.ts +48 -0
  157. package/dist/projections/declarative/DictionaryKey.d.ts.map +1 -0
  158. package/dist/projections/declarative/DictionaryKey.js +82 -0
  159. package/dist/projections/declarative/DictionaryKey.js.map +1 -0
  160. package/dist/projections/declarative/FromAllBuilder.d.ts +2 -0
  161. package/dist/projections/declarative/FromAllBuilder.d.ts.map +1 -1
  162. package/dist/projections/declarative/FromAllBuilder.js +5 -0
  163. package/dist/projections/declarative/FromAllBuilder.js.map +1 -1
  164. package/dist/projections/declarative/FromBuilder.d.ts +18 -6
  165. package/dist/projections/declarative/FromBuilder.d.ts.map +1 -1
  166. package/dist/projections/declarative/FromBuilder.js +34 -31
  167. package/dist/projections/declarative/FromBuilder.js.map +1 -1
  168. package/dist/projections/declarative/FromEveryBuilder.d.ts +2 -0
  169. package/dist/projections/declarative/FromEveryBuilder.d.ts.map +1 -1
  170. package/dist/projections/declarative/FromEveryBuilder.js +7 -0
  171. package/dist/projections/declarative/FromEveryBuilder.js.map +1 -1
  172. package/dist/projections/declarative/IAllSetBuilder.d.ts +7 -0
  173. package/dist/projections/declarative/IAllSetBuilder.d.ts.map +1 -1
  174. package/dist/projections/declarative/IChildrenBuilder.d.ts +19 -0
  175. package/dist/projections/declarative/IChildrenBuilder.d.ts.map +1 -1
  176. package/dist/projections/declarative/IFromAllBuilder.d.ts +6 -0
  177. package/dist/projections/declarative/IFromAllBuilder.d.ts.map +1 -1
  178. package/dist/projections/declarative/IFromEveryBuilder.d.ts +6 -0
  179. package/dist/projections/declarative/IFromEveryBuilder.d.ts.map +1 -1
  180. package/dist/projections/declarative/IReadModelPropertiesBuilder.d.ts +37 -6
  181. package/dist/projections/declarative/IReadModelPropertiesBuilder.d.ts.map +1 -1
  182. package/dist/projections/declarative/ISetBuilder.d.ts +7 -0
  183. package/dist/projections/declarative/ISetBuilder.d.ts.map +1 -1
  184. package/dist/projections/declarative/InvalidDictionaryKey.d.ts +10 -0
  185. package/dist/projections/declarative/InvalidDictionaryKey.d.ts.map +1 -0
  186. package/dist/projections/declarative/InvalidDictionaryKey.js +16 -0
  187. package/dist/projections/declarative/InvalidDictionaryKey.js.map +1 -0
  188. package/dist/projections/declarative/JoinBuilder.d.ts +18 -6
  189. package/dist/projections/declarative/JoinBuilder.d.ts.map +1 -1
  190. package/dist/projections/declarative/JoinBuilder.js +34 -31
  191. package/dist/projections/declarative/JoinBuilder.js.map +1 -1
  192. package/dist/projections/declarative/ProjectionBuilderCore.d.ts +2 -0
  193. package/dist/projections/declarative/ProjectionBuilderCore.d.ts.map +1 -1
  194. package/dist/projections/declarative/ProjectionBuilderCore.js.map +1 -1
  195. package/dist/projections/declarative/SetBuilder.d.ts +3 -0
  196. package/dist/projections/declarative/SetBuilder.d.ts.map +1 -1
  197. package/dist/projections/declarative/SetBuilder.js +6 -0
  198. package/dist/projections/declarative/SetBuilder.js.map +1 -1
  199. package/dist/projections/declarative/index.d.ts +4 -0
  200. package/dist/projections/declarative/index.d.ts.map +1 -1
  201. package/dist/projections/declarative/index.js +3 -0
  202. package/dist/projections/declarative/index.js.map +1 -1
  203. package/dist/projections/graphs/GraphDefinitionBuilder.d.ts.map +1 -1
  204. package/dist/projections/graphs/GraphDefinitionBuilder.js +7 -4
  205. package/dist/projections/graphs/GraphDefinitionBuilder.js.map +1 -1
  206. package/dist/projections/graphs/GraphMemberMappings.d.ts +1 -0
  207. package/dist/projections/graphs/GraphMemberMappings.d.ts.map +1 -1
  208. package/dist/projections/graphs/GraphMemberMappings.js +10 -5
  209. package/dist/projections/graphs/GraphMemberMappings.js.map +1 -1
  210. package/dist/projections/graphs/SetOnceNotSupportedInGraph.d.ts +13 -0
  211. package/dist/projections/graphs/SetOnceNotSupportedInGraph.d.ts.map +1 -0
  212. package/dist/projections/graphs/SetOnceNotSupportedInGraph.js +18 -0
  213. package/dist/projections/graphs/SetOnceNotSupportedInGraph.js.map +1 -0
  214. package/dist/projections/graphs/index.d.ts +1 -0
  215. package/dist/projections/graphs/index.d.ts.map +1 -1
  216. package/dist/projections/graphs/index.js +1 -0
  217. package/dist/projections/graphs/index.js.map +1 -1
  218. package/dist/projections/index.d.ts +5 -0
  219. package/dist/projections/index.d.ts.map +1 -1
  220. package/dist/projections/index.js +3 -0
  221. package/dist/projections/index.js.map +1 -1
  222. package/dist/projections/modelBound/ConflictingChildrenOrdering.d.ts +10 -0
  223. package/dist/projections/modelBound/ConflictingChildrenOrdering.d.ts.map +1 -0
  224. package/dist/projections/modelBound/ConflictingChildrenOrdering.js +16 -0
  225. package/dist/projections/modelBound/ConflictingChildrenOrdering.js.map +1 -0
  226. package/dist/projections/modelBound/childrenAndNestedBuilder.d.ts +2 -0
  227. package/dist/projections/modelBound/childrenAndNestedBuilder.d.ts.map +1 -1
  228. package/dist/projections/modelBound/childrenAndNestedBuilder.js +9 -5
  229. package/dist/projections/modelBound/childrenAndNestedBuilder.js.map +1 -1
  230. package/dist/projections/modelBound/childrenFrom.d.ts +39 -1
  231. package/dist/projections/modelBound/childrenFrom.d.ts.map +1 -1
  232. package/dist/projections/modelBound/childrenFrom.js +30 -1
  233. package/dist/projections/modelBound/childrenFrom.js.map +1 -1
  234. package/dist/projections/modelBound/index.d.ts +3 -2
  235. package/dist/projections/modelBound/index.d.ts.map +1 -1
  236. package/dist/projections/modelBound/index.js +1 -0
  237. package/dist/projections/modelBound/index.js.map +1 -1
  238. package/dist/projections/modelBound/setFrom.d.ts +26 -0
  239. package/dist/projections/modelBound/setFrom.d.ts.map +1 -1
  240. package/dist/projections/modelBound/setFrom.js +15 -8
  241. package/dist/projections/modelBound/setFrom.js.map +1 -1
  242. package/dist/projections/modelBound/setFromContext.d.ts +23 -1
  243. package/dist/projections/modelBound/setFromContext.d.ts.map +1 -1
  244. package/dist/projections/modelBound/setFromContext.js +20 -2
  245. package/dist/projections/modelBound/setFromContext.js.map +1 -1
  246. package/dist/projections/propertyExpressions.d.ts +9 -0
  247. package/dist/projections/propertyExpressions.d.ts.map +1 -0
  248. package/dist/projections/propertyExpressions.js +13 -0
  249. package/dist/projections/propertyExpressions.js.map +1 -0
  250. package/dist/reducers/Reducers.d.ts.map +1 -1
  251. package/dist/reducers/Reducers.js +2 -1
  252. package/dist/reducers/Reducers.js.map +1 -1
  253. package/dist/testing/BatchPartitionOutcome.d.ts +7 -0
  254. package/dist/testing/BatchPartitionOutcome.d.ts.map +1 -0
  255. package/dist/testing/BatchPartitionOutcome.js +4 -0
  256. package/dist/testing/BatchPartitionOutcome.js.map +1 -0
  257. package/dist/testing/InProcessEventSequence.d.ts +4 -0
  258. package/dist/testing/InProcessEventSequence.d.ts.map +1 -1
  259. package/dist/testing/InProcessEventSequence.js +2 -0
  260. package/dist/testing/InProcessEventSequence.js.map +1 -1
  261. package/dist/testing/ReactorDeliveryResult.d.ts +2 -0
  262. package/dist/testing/ReactorDeliveryResult.d.ts.map +1 -1
  263. package/dist/testing/ReactorScenario.d.ts +46 -10
  264. package/dist/testing/ReactorScenario.d.ts.map +1 -1
  265. package/dist/testing/ReactorScenario.js +120 -29
  266. package/dist/testing/ReactorScenario.js.map +1 -1
  267. package/dist/testing/deliverToBatchMethods.d.ts +35 -0
  268. package/dist/testing/deliverToBatchMethods.d.ts.map +1 -0
  269. package/dist/testing/deliverToBatchMethods.js +55 -0
  270. package/dist/testing/deliverToBatchMethods.js.map +1 -0
  271. package/dist/testing/projections/ProjectionCapabilities.d.ts.map +1 -1
  272. package/dist/testing/projections/ProjectionCapabilities.js +2 -0
  273. package/dist/testing/projections/ProjectionCapabilities.js.map +1 -1
  274. package/dist/testing/projections/ProjectionChildrenCapabilities.d.ts.map +1 -1
  275. package/dist/testing/projections/ProjectionChildrenCapabilities.js +2 -0
  276. package/dist/testing/projections/ProjectionChildrenCapabilities.js.map +1 -1
  277. package/dist/tsconfig.tsbuildinfo +1 -1
  278. package/eventSequences/EventForEventSourceId.ts +25 -1
  279. package/eventSequences/EventSequence.ts +28 -0
  280. package/eventSequences/IEventSequence.ts +33 -0
  281. package/imports/EventImport.ts +263 -0
  282. package/imports/EventImportSettings.ts +46 -0
  283. package/imports/IEventImport.ts +58 -0
  284. package/imports/ImportChunkRefused.ts +15 -0
  285. package/imports/ImportCouldNotBegin.ts +14 -0
  286. package/imports/ImportOptions.ts +36 -0
  287. package/imports/ImportProgress.ts +29 -0
  288. package/imports/ImportRejection.ts +14 -0
  289. package/imports/ImportResult.ts +43 -0
  290. package/imports/ImportState.ts +26 -0
  291. package/imports/ImportTarget.ts +23 -0
  292. package/imports/ImportWasAbandoned.ts +16 -0
  293. package/imports/ImportsNotSupported.ts +10 -0
  294. package/imports/OnInvalidEvent.ts +11 -0
  295. package/imports/abortable.ts +57 -0
  296. package/imports/beginEventImport.ts +85 -0
  297. package/imports/for_EventImport/given/a_kernel_import_session.ts +160 -0
  298. package/imports/for_EventImport/when_a_chunk_fails.spec.ts +65 -0
  299. package/imports/for_EventImport/when_abandoning.spec.ts +52 -0
  300. package/imports/for_EventImport/when_cancelling_with_an_abort_signal.spec.ts +59 -0
  301. package/imports/for_EventImport/when_completing.spec.ts +71 -0
  302. package/imports/for_EventImport/when_cutting_events_into_chunks.spec.ts +70 -0
  303. package/imports/for_EventImport/when_keeping_chunks_in_flight.spec.ts +49 -0
  304. package/imports/for_beginEventImport/when_reattaching.spec.ts +82 -0
  305. package/imports/for_beginEventImport/when_the_kernel_does_not_serve_imports.spec.ts +55 -0
  306. package/imports/for_importEvents/when_importing_in_one_call.spec.ts +99 -0
  307. package/imports/for_toImportEvent/when_converting_an_event.spec.ts +74 -0
  308. package/imports/importEvents.ts +44 -0
  309. package/imports/index.ts +14 -0
  310. package/imports/isTransientImportFailure.ts +15 -0
  311. package/imports/sizeOfImportEvent.ts +25 -0
  312. package/imports/toImportEvent.ts +60 -0
  313. package/imports/toImportProgress.ts +24 -0
  314. package/imports/toImportResult.ts +36 -0
  315. package/index.ts +3 -0
  316. package/observation/index.ts +2 -0
  317. package/package.json +7 -2
  318. package/projections/ChildrenOrderingNotSupportedByContracts.ts +18 -0
  319. package/projections/InvalidCausedByProperty.ts +14 -0
  320. package/projections/Projections.ts +4 -0
  321. package/projections/causedBy.ts +30 -0
  322. package/projections/childrenOrdering.ts +53 -0
  323. package/projections/childrenOrderingSupport.ts +40 -0
  324. package/projections/declarative/AllSetBuilder.ts +7 -0
  325. package/projections/declarative/ChildrenBuilder.ts +34 -1
  326. package/projections/declarative/ChildrenOrderingAlreadyDefined.ts +11 -0
  327. package/projections/declarative/DictionaryKey.ts +88 -0
  328. package/projections/declarative/FromAllBuilder.ts +10 -0
  329. package/projections/declarative/FromBuilder.ts +42 -32
  330. package/projections/declarative/FromEveryBuilder.ts +12 -0
  331. package/projections/declarative/IAllSetBuilder.ts +8 -0
  332. package/projections/declarative/IChildrenBuilder.ts +22 -0
  333. package/projections/declarative/IFromAllBuilder.ts +7 -0
  334. package/projections/declarative/IFromEveryBuilder.ts +7 -0
  335. package/projections/declarative/IReadModelPropertiesBuilder.ts +39 -6
  336. package/projections/declarative/ISetBuilder.ts +8 -0
  337. package/projections/declarative/InvalidDictionaryKey.ts +14 -0
  338. package/projections/declarative/JoinBuilder.ts +41 -32
  339. package/projections/declarative/ProjectionBuilderCore.ts +2 -0
  340. package/projections/declarative/SetBuilder.ts +7 -0
  341. package/projections/declarative/for_ChildrenBuilder/when_ordering_children.spec.ts +52 -0
  342. package/projections/declarative/for_FromAllBuilder/when_setting_once.spec.ts +29 -0
  343. package/projections/declarative/for_FromBuilder/when_setting_once.spec.ts +39 -0
  344. package/projections/declarative/for_FromBuilder/when_targeting_dictionary_entries.spec.ts +99 -0
  345. package/projections/declarative/for_JoinBuilder/when_setting_once_and_targeting_dictionary_entries.spec.ts +36 -0
  346. package/projections/declarative/for_SetBuilder/when_setting_to_the_causing_identity.spec.ts +37 -0
  347. package/projections/declarative/index.ts +4 -0
  348. package/projections/for_Graphs/when_building_a_fluent_graph.spec.ts +1 -1
  349. package/projections/for_Graphs/when_building_a_model_bound_graph.spec.ts +5 -4
  350. package/projections/for_Graphs/when_declaring_an_invalid_graph.spec.ts +28 -0
  351. package/projections/for_Graphs/when_declaring_with_standard_decorators.standard.spec.ts +4 -4
  352. package/projections/for_Graphs/when_mapping_properties.spec.ts +1 -1
  353. package/projections/for_Projections/when_registering_ordered_children.spec.ts +66 -0
  354. package/projections/for_childrenOrderingSupport/when_detecting_support_in_the_pinned_contracts.spec.ts +22 -0
  355. package/projections/for_childrenOrderingSupport/when_ensuring_children_ordering_is_supported.spec.ts +35 -0
  356. package/projections/graphs/GraphDefinitionBuilder.ts +7 -4
  357. package/projections/graphs/GraphMemberMappings.ts +8 -5
  358. package/projections/graphs/SetOnceNotSupportedInGraph.ts +18 -0
  359. package/projections/graphs/index.ts +1 -0
  360. package/projections/index.ts +5 -0
  361. package/projections/modelBound/ConflictingChildrenOrdering.ts +14 -0
  362. package/projections/modelBound/childrenAndNestedBuilder.ts +11 -5
  363. package/projections/modelBound/childrenFrom.ts +62 -2
  364. package/projections/modelBound/for_childrenFrom/when_ordering_children.spec.ts +91 -0
  365. package/projections/modelBound/for_setFrom/when_setting_once.spec.ts +52 -0
  366. package/projections/modelBound/index.ts +3 -2
  367. package/projections/modelBound/setFrom.ts +37 -2
  368. package/projections/modelBound/setFromContext.ts +38 -3
  369. package/projections/propertyExpressions.ts +14 -0
  370. package/reducers/Reducers.ts +2 -1
  371. package/testing/BatchPartitionOutcome.ts +10 -0
  372. package/testing/InProcessEventSequence.ts +4 -0
  373. package/testing/ReactorDeliveryResult.ts +2 -0
  374. package/testing/ReactorScenario.ts +147 -39
  375. package/testing/deliverToBatchMethods.ts +90 -0
  376. package/testing/for_ReactorScenario/when_the_reactor_has_a_batch_method.spec.ts +143 -9
  377. package/testing/projections/ProjectionCapabilities.ts +1 -0
  378. package/testing/projections/ProjectionChildrenCapabilities.ts +1 -0
  379. package/testing/projections/for_ProjectionCapabilities/when_rejecting_set_once_dictionary_entries_and_ordered_children.spec.ts +52 -0
@@ -5,9 +5,9 @@ export { fromEvent, getFromEventMetadata, hasFromEventMetadata } from './fromEve
5
5
  export type { FromEventOptions } from './FromEventOptions.js';
6
6
  export type { FromEventMetadata } from './FromEventMetadata.js';
7
7
  export { setFrom, getSetFromMetadata } from './setFrom.js';
8
- export type { SetFromMetadata } from './setFrom.js';
8
+ export type { SetFromMetadata, SetFromOptions } from './setFrom.js';
9
9
  export { setFromContext, getSetFromContextMetadata } from './setFromContext.js';
10
- export type { SetFromContextMetadata } from './setFromContext.js';
10
+ export type { SetFromContextMetadata, SetFromContextOptions } from './setFromContext.js';
11
11
  export { join, getJoinMetadata } from './join.js';
12
12
  export type { JoinMetadata } from './join.js';
13
13
  export { addFrom, getAddFromMetadata } from './addFrom.js';
@@ -22,6 +22,7 @@ export { count, getCountMetadata } from './count.js';
22
22
  export type { CountMetadata } from './count.js';
23
23
  export { childrenFrom, getChildrenFromMetadata } from './childrenFrom.js';
24
24
  export type { ChildrenFromMetadata, ChildrenFromOptions } from './childrenFrom.js';
25
+ export { ConflictingChildrenOrdering } from './ConflictingChildrenOrdering.js';
25
26
  export { nested, isNested } from './nested.js';
26
27
  export { clearWith, getClearWithClassMetadata, getClearWithPropertyMetadata } from './clearWith.js';
27
28
  export type { ClearWithMetadata } from './clearWith.js';
@@ -3,6 +3,7 @@
3
3
 
4
4
  import 'reflect-metadata';
5
5
  import { TypeIntrospector } from '../../types/index.js';
6
+ import { setOnceExpression } from '../propertyExpressions.js';
6
7
  import { decorateModelBoundProperty } from '../../types/modelBoundProperty.js';
7
8
  import { ChroniclePropertyDecorator, getPropertyMetadata } from '../../types/propertyDecoratorMetadata.js';
8
9
 
@@ -12,22 +13,45 @@ export interface SetFromMetadata {
12
13
  readonly eventType: Function;
13
14
  /** The event property name to read the value from. Defaults to the decorated property name. */
14
15
  readonly eventPropertyName?: string;
16
+ /** Whether the property is only assigned while it has no value yet. */
17
+ readonly setOnce?: boolean;
18
+ }
19
+
20
+ /** Options for the setFrom property decorator. */
21
+ export interface SetFromOptions {
22
+ /** The event property name to read the value from. Defaults to the decorated property name. */
23
+ readonly eventPropertyName?: string;
24
+ /**
25
+ * Only assign the property while it has no value yet: the first event that carries a value wins and later events
26
+ * leave the property as it is.
27
+ */
28
+ readonly setOnce?: boolean;
15
29
  }
16
30
 
17
31
  const METADATA_KEY = 'chronicle:projection:setFrom';
18
32
 
33
+ /**
34
+ * Property decorator that maps an event property value onto the decorated read model property.
35
+ * @param eventType - The event constructor.
36
+ * @param options - Options naming the event property and whether the property is only set once.
37
+ * @returns A property decorator.
38
+ */
39
+ export function setFrom(eventType: Function, options: SetFromOptions): ChroniclePropertyDecorator;
19
40
  /**
20
41
  * Property decorator that maps an event property value onto the decorated read model property.
21
42
  * @param eventType - The event constructor.
22
43
  * @param eventPropertyName - Optional event property name. Defaults to the property name.
23
44
  * @returns A property decorator.
24
45
  */
25
- export function setFrom(eventType: Function, eventPropertyName?: string): ChroniclePropertyDecorator {
46
+ export function setFrom(eventType: Function, eventPropertyName?: string): ChroniclePropertyDecorator;
47
+ export function setFrom(eventType: Function, eventPropertyNameOrOptions?: string | SetFromOptions): ChroniclePropertyDecorator {
48
+ const metadata: SetFromMetadata = typeof eventPropertyNameOrOptions === 'object' && eventPropertyNameOrOptions !== null
49
+ ? { eventType, eventPropertyName: eventPropertyNameOrOptions.eventPropertyName, ...(eventPropertyNameOrOptions.setOnce === true ? { setOnce: true } : {}) }
50
+ : { eventType, eventPropertyName: eventPropertyNameOrOptions };
26
51
  return decorateModelBoundProperty((target: object, propertyKey: string | symbol) => {
27
52
  const key = propertyKey.toString();
28
53
  TypeIntrospector.trackProperty((target as { constructor: Function }).constructor, key);
29
54
  const existing: SetFromMetadata[] = Reflect.getMetadata(METADATA_KEY, target, key) ?? [];
30
- const metadata: SetFromMetadata = { eventType, eventPropertyName };
31
55
  Reflect.defineMetadata(METADATA_KEY, [...existing, metadata], target, key);
32
56
  });
33
57
  }
@@ -41,3 +65,14 @@ export function setFrom(eventType: Function, eventPropertyName?: string): Chroni
41
65
  export function getSetFromMetadata(target: object, propertyKey: string): SetFromMetadata[] {
42
66
  return getPropertyMetadata<SetFromMetadata[]>(METADATA_KEY, target, propertyKey) ?? [];
43
67
  }
68
+
69
+ /**
70
+ * Builds the property expression for a setFrom mapping.
71
+ * @param mapping - The setFrom metadata.
72
+ * @param property - The decorated read model property.
73
+ * @returns The event property, wrapped in `$setOnce(...)` when the mapping only sets once.
74
+ */
75
+ export function setFromExpression(mapping: SetFromMetadata, property: string): string {
76
+ const expression = mapping.eventPropertyName ?? property;
77
+ return mapping.setOnce === true ? setOnceExpression(expression) : expression;
78
+ }
@@ -5,6 +5,8 @@ import 'reflect-metadata';
5
5
  import { PropertyAccessor, PropertyPathResolverProxyHandler } from '@cratis/fundamentals';
6
6
  import type { EventContext } from '../../events/index.js';
7
7
  import { TypeIntrospector } from '../../types/index.js';
8
+ import { eventContextPropertyExpression } from '../eventContextPropertyExpression.js';
9
+ import { setOnceExpression } from '../propertyExpressions.js';
8
10
  import { decorateModelBoundProperty } from '../../types/modelBoundProperty.js';
9
11
  import { ChroniclePropertyDecorator, getPropertyMetadata } from '../../types/propertyDecoratorMetadata.js';
10
12
 
@@ -14,6 +16,20 @@ export interface SetFromContextMetadata {
14
16
  readonly eventType: Function;
15
17
  /** The event context property name to read the value from. Defaults to the decorated property name. */
16
18
  readonly contextPropertyName?: string;
19
+ /** Whether the property is only assigned while it has no value yet. */
20
+ readonly setOnce?: boolean;
21
+ }
22
+
23
+ /** Options for the setFromContext property decorator. */
24
+ export interface SetFromContextOptions {
25
+ /** The event context property name or accessor to read the value from. Defaults to the decorated property name. */
26
+ readonly contextProperty?: string | PropertyAccessor<EventContext>;
27
+ /**
28
+ * Only assign the property while it has no value yet. Use it to capture a first occurrence - for instance
29
+ * `@setFromContext(ItemAdded, { contextProperty: 'occurred', setOnce: true })` for when something was created -
30
+ * without a dedicated creation event.
31
+ */
32
+ readonly setOnce?: boolean;
17
33
  }
18
34
 
19
35
  const METADATA_KEY = 'chronicle:projection:setFromContext';
@@ -21,15 +37,23 @@ const METADATA_KEY = 'chronicle:projection:setFromContext';
21
37
  /**
22
38
  * Property decorator that maps a value from an event context property onto the decorated read model property.
23
39
  * @param eventType - The event constructor.
24
- * @param contextPropertyOrAccessor - Optional event context property name or property accessor. Defaults to the property name.
40
+ * @param contextPropertyOrAccessorOrOptions - Optional event context property name, property accessor, or options naming the
41
+ * context property and whether the property is only set once. Defaults to the property name.
25
42
  * @returns A property decorator.
26
43
  */
27
44
  export function setFromContext(eventType: Function, contextPropertyName?: string): ChroniclePropertyDecorator;
28
45
  export function setFromContext(eventType: Function, contextPropertyAccessor?: PropertyAccessor<EventContext>): ChroniclePropertyDecorator;
46
+ export function setFromContext(eventType: Function, options: SetFromContextOptions): ChroniclePropertyDecorator;
29
47
  export function setFromContext(
30
48
  eventType: Function,
31
- contextPropertyOrAccessor?: string | PropertyAccessor<EventContext>
49
+ contextPropertyOrAccessorOrOptions?: string | PropertyAccessor<EventContext> | SetFromContextOptions
32
50
  ): ChroniclePropertyDecorator {
51
+ const options = typeof contextPropertyOrAccessorOrOptions === 'object' && contextPropertyOrAccessorOrOptions !== null
52
+ ? contextPropertyOrAccessorOrOptions
53
+ : undefined;
54
+ const contextPropertyOrAccessor = options === undefined
55
+ ? contextPropertyOrAccessorOrOptions as string | PropertyAccessor<EventContext> | undefined
56
+ : options.contextProperty;
33
57
  return decorateModelBoundProperty((target: object, propertyKey: string | symbol) => {
34
58
  const key = propertyKey.toString();
35
59
  TypeIntrospector.trackProperty((target as { constructor: Function }).constructor, key);
@@ -45,7 +69,7 @@ export function setFromContext(
45
69
  contextPropertyName = handler.property;
46
70
  }
47
71
 
48
- const metadata: SetFromContextMetadata = { eventType, contextPropertyName };
72
+ const metadata: SetFromContextMetadata = { eventType, contextPropertyName, ...(options?.setOnce === true ? { setOnce: true } : {}) };
49
73
  Reflect.defineMetadata(METADATA_KEY, [...existing, metadata], target, key);
50
74
  });
51
75
  }
@@ -59,3 +83,14 @@ export function setFromContext(
59
83
  export function getSetFromContextMetadata(target: object, propertyKey: string): SetFromContextMetadata[] {
60
84
  return getPropertyMetadata<SetFromContextMetadata[]>(METADATA_KEY, target, propertyKey) ?? [];
61
85
  }
86
+
87
+ /**
88
+ * Builds the property expression for a setFromContext mapping.
89
+ * @param mapping - The setFromContext metadata.
90
+ * @param property - The decorated read model property.
91
+ * @returns The `$eventContext(...)` expression, wrapped in `$setOnce(...)` when the mapping only sets once.
92
+ */
93
+ export function setFromContextExpression(mapping: SetFromContextMetadata, property: string): string {
94
+ const expression = eventContextPropertyExpression(mapping.contextPropertyName ?? property);
95
+ return mapping.setOnce === true ? setOnceExpression(expression) : expression;
96
+ }
@@ -0,0 +1,14 @@
1
+ // Copyright (c) Cratis. All rights reserved.
2
+ // Licensed under the MIT license. See LICENSE file in the project root for full license information.
3
+
4
+ /** The read model property expression that removes a dictionary entry; its target has to be a dynamic dictionary key. */
5
+ export const removeExpression = '$remove';
6
+
7
+ /**
8
+ * Wraps an event value expression so the kernel only assigns it while the target property has no value yet.
9
+ * @param expression - The event value expression, for example `name` or `$eventContext(Occurred)`.
10
+ * @returns The `$setOnce(<expression>)` expression.
11
+ */
12
+ export function setOnceExpression(expression: string): string {
13
+ return `$setOnce(${expression})`;
14
+ }
@@ -390,7 +390,8 @@ export class Reducers implements IReducers {
390
390
  EventStreamType: getEventStreamTypeFor(reducerType)
391
391
  }
392
392
  },
393
- PageDelivery: toPageDelivery(reducerType)
393
+ PageDelivery: toPageDelivery(reducerType),
394
+ StateCaching: undefined
394
395
  },
395
396
  Value1: undefined
396
397
  }
@@ -0,0 +1,10 @@
1
+ // Copyright (c) Cratis. All rights reserved.
2
+ // Licensed under the MIT license. See LICENSE file in the project root for full license information.
3
+
4
+ import type { BatchOutcome } from '../observation/batches/BatchOutcome.js';
5
+
6
+ /** A partition a batch method of a scenario reactor reported as failed or deferred. */
7
+ export interface BatchPartitionOutcome extends BatchOutcome {
8
+ /** The name of the batch method that reported it. */
9
+ readonly methodName: string;
10
+ }
@@ -26,6 +26,8 @@ import { EventSequenceNumber } from '../eventSequences/EventSequenceNumber.js';
26
26
  import type { IEventSequence } from '../eventSequences/IEventSequence.js';
27
27
  import type { ITransactionalEventSequence } from '../eventSequences/ITransactionalEventSequence.js';
28
28
  import type { CompleteStreamResult } from '../eventSequences/CompleteStreamResult.js';
29
+ import type { IEventImport } from '../imports/IEventImport.js';
30
+ import type { ImportResult } from '../imports/ImportResult.js';
29
31
  import { prepareSingleAppend } from '../eventSequences/prepareSingleAppend.js';
30
32
  import { toContractsGuid } from '../connection/Guid.js';
31
33
  import { getRemovedConstraintNames } from '../events/constraints/removeConstraint.js';
@@ -398,6 +400,8 @@ export class InProcessEventSequence implements IEventSequence {
398
400
  async redactForEventSource(): Promise<void> { throw this.unsupported('redactForEventSource', this.id.value, 'Redaction requires kernel storage.'); }
399
401
  async copy(): Promise<Guid> { throw this.unsupported('copy', this.id.value, 'Copying events requires kernel jobs.'); }
400
402
  async completeStream(): Promise<CompleteStreamResult> { throw this.unsupported('completeStream', this.id.value, 'Stream completion requires a kernel.'); }
403
+ async import(): Promise<ImportResult> { throw this.unsupported('import', this.id.value, 'Importing events requires kernel import sessions.'); }
404
+ async beginImport(): Promise<IEventImport> { throw this.unsupported('beginImport', this.id.value, 'Importing events requires kernel import sessions.'); }
401
405
 
402
406
  private filterIds(types?: Constructor[]): string[] {
403
407
  return (types ?? []).map(type => {
@@ -6,6 +6,8 @@ import type { EventContext } from '../events/EventContext.js';
6
6
  /** Observable outcome of one ordered source-partition delivery (not a kernel checkpoint). */
7
7
  export interface ReactorDeliveryResult {
8
8
  readonly sourceId: string;
9
+ /** The partitions (event source identifiers) the delivery carried, in the order their first event appears. */
10
+ readonly partitions: readonly string[];
9
11
  readonly handled: readonly EventContext[];
10
12
  readonly skipped: readonly EventContext[];
11
13
  readonly completed: boolean;
@@ -37,13 +37,20 @@ import type { RecordedReactorSideEffect } from './RecordedReactorSideEffect.js';
37
37
  import { observeUnsupportedOperations } from './InProcessEventSequence.js';
38
38
  import { UnsupportedEventSequenceOperation } from './UnsupportedEventSequenceOperation.js';
39
39
  import { UnsupportedReactorOperation } from './UnsupportedReactorOperation.js';
40
+ import type { BatchMethod } from '../observation/batches/BatchMethod.js';
41
+ import { BatchOutcomeKind } from '../observation/batches/BatchOutcomeKind.js';
42
+ import type { BatchPartitionOutcome } from './BatchPartitionOutcome.js';
43
+ import { deliverToBatchMethods } from './deliverToBatchMethods.js';
40
44
 
41
45
  /** Live, ordered reactor deliveries over the fixture-proven EventScenario event boundary. */
42
46
  export class ReactorScenario {
43
- readonly given: { forEventSource(id: string, options?: AppendOptions): { events(...events: object[]): Promise<void> } };
44
- readonly when: { forEventSource(id: string, options?: AppendOptions): { events(...events: object[]): Promise<void> } };
47
+ readonly given: ReactorScenarioPhase;
48
+ readonly when: ReactorScenarioPhase;
45
49
  private readonly _events: EventScenario;
46
50
  private readonly _entries: ReturnType<typeof getReactorEventTypes>;
51
+ private readonly _batchMethods: readonly BatchMethod[];
52
+ private readonly _batchEventTypeIds: ReadonlySet<string>;
53
+ private readonly _partitionOutcomes: BatchPartitionOutcome[] = [];
47
54
  private readonly _eventTypes: readonly Constructor[];
48
55
  private readonly _instance?: Record<string, Function>;
49
56
  private readonly _validateInstance: (instance: object) => void;
@@ -89,19 +96,20 @@ export class ReactorScenario {
89
96
  eventTypeMigrations: eventTypeMigrations === undefined ? undefined : [...eventTypeMigrations]
90
97
  } });
91
98
  this._entries = getReactorEventTypes(_reactor, this._eventTypes);
92
- if (getReactorBatchMethods(_reactor, this._eventTypes).length > 0) {
93
- throw new UnsupportedReactorOperation('reactor.batchMethod', _reactor.name,
94
- 'Batch methods (@observes) are not fixture-backed yet.');
95
- }
96
- this._validateInstance = createHandlerInstanceValidator(_reactor,
97
- this._entries.flatMap(entry => [entry.methodName, entry.replayMethodName].filter((name): name is string => !!name)));
99
+ this._batchMethods = getReactorBatchMethods(_reactor, this._eventTypes);
100
+ this._batchEventTypeIds = new Set(this._batchMethods.flatMap(method => [...method.eventTypes.keys()]));
101
+ this._validateInstance = createHandlerInstanceValidator(_reactor, [
102
+ ...this._entries.flatMap(entry => [entry.methodName, entry.replayMethodName].filter((name): name is string => !!name)),
103
+ ...this._batchMethods.map(method => method.methodName)]);
98
104
  // Every unsupported event-sequence operation is latched at its source, whichever result or stream carries it.
99
105
  observeUnsupportedOperations(this._events.eventSequence, error => { this.latch(error); });
100
106
  this._instance = _options.artifactActivator ? undefined : new (_reactor as new () => Record<string, Function>)();
101
107
  if (this._instance) this._validateInstance(this._instance);
102
108
  this._store = _options.servicesEventStore ?? this.scenarioStore();
103
- this.given = { forEventSource: (id, options) => ({ events: (...events) => this.deliver(id, events, true, options) }) };
104
- this.when = { forEventSource: (id, options) => ({ events: (...events) => this.deliver(id, events, false, options) }) };
109
+ this.given = { forEventSource: (id, options) => ({ events: (...events) => this.deliver(id, events, true, options) }),
110
+ page: (...events) => this.deliverPage(events, true) };
111
+ this.when = { forEventSource: (id, options) => ({ events: (...events) => this.deliver(id, events, false, options) }),
112
+ page: (...events) => this.deliverPage(events, false) };
105
113
  }
106
114
 
107
115
  private scenarioStore(): IEventStore {
@@ -120,7 +128,7 @@ export class ReactorScenario {
120
128
  const rejectSubscribed = (events: readonly object[]) => {
121
129
  if (events.some(event => {
122
130
  const id = getEventTypeMetadata(event.constructor)?.eventType.id.value;
123
- return this._entries.some(entry => entry.id === id);
131
+ return id !== undefined && (this._entries.some(entry => entry.id === id) || this._batchEventTypeIds.has(id));
124
132
  })) {
125
133
  throw this.violation('services.eventLog.append.subscribed',
126
134
  'Delivery of a reactor\'s own appended events is not supported.');
@@ -161,18 +169,39 @@ export class ReactorScenario {
161
169
  get produced(): readonly unknown[] { return Object.freeze(this._effects.map(effect => effect.value)); }
162
170
  get sideEffects(): readonly RecordedReactorSideEffect[] { return Object.freeze([...this._effects]); }
163
171
  get results(): readonly ReactorDeliveryResult[] { return Object.freeze([...this._results]); }
172
+ /**
173
+ * The partitions the reactor's batch methods reported as failed or deferred, in the order they were reported. A batch
174
+ * method that throws fails every partition in its batch instead, and the scenario rejects the call that delivered it.
175
+ */
176
+ get partitionOutcomes(): readonly BatchPartitionOutcome[] { return Object.freeze([...this._partitionOutcomes]); }
164
177
  /** Committed input and explicit service appends; recorded returned effects are not part of this history. */
165
178
  get appendedEvents(): readonly AppendedEvent[] { return this._events.appendedEvents; }
166
179
  /** Assertion view, deliberately not a callable Promise-like `then`. */
167
180
  get then(): { readonly produced: readonly unknown[]; readonly sideEffects: readonly RecordedReactorSideEffect[];
168
- readonly results: readonly ReactorDeliveryResult[] } {
169
- return { produced: this.produced, sideEffects: this.sideEffects, results: this.results };
181
+ readonly results: readonly ReactorDeliveryResult[]; readonly partitionOutcomes: readonly BatchPartitionOutcome[] } {
182
+ return { produced: this.produced, sideEffects: this.sideEffects, results: this.results, partitionOutcomes: this.partitionOutcomes };
170
183
  }
171
184
  shouldHaveProduced<T>(type: new (...args: never[]) => T, predicate: (value: T) => boolean = () => true): void {
172
185
  if (!this.produced.some(value => value instanceof type && predicate(value))) {
173
186
  throw new Error(`Expected reactor '${this._reactor.name}' to produce a matching '${type.name}'.`);
174
187
  }
175
188
  }
189
+ /**
190
+ * Asserts that a batch method failed a partition.
191
+ * @param partition - The event source identifier of the partition.
192
+ */
193
+ shouldHaveFailed(partition: string): void { this.assertOutcome(partition, BatchOutcomeKind.Failed); }
194
+ /**
195
+ * Asserts that a batch method deferred a partition.
196
+ * @param partition - The event source identifier of the partition.
197
+ */
198
+ shouldHaveDeferred(partition: string): void { this.assertOutcome(partition, BatchOutcomeKind.Deferred); }
199
+ private assertOutcome(partition: string, kind: BatchOutcomeKind): void {
200
+ if (this._partitionOutcomes.some(outcome => outcome.partition === partition && outcome.kind === kind)) return;
201
+ const reported = this._partitionOutcomes.length > 0
202
+ ? this._partitionOutcomes.map(outcome => `${outcome.kind} '${outcome.partition}'`).join(', ') : 'nothing';
203
+ throw new Error(`Expected a batch method of reactor '${this._reactor.name}' to report partition '${partition}' as ${kind}, but it reported: ${reported}.`);
204
+ }
176
205
  shouldNotHaveProduced(type: Function): void {
177
206
  if (this.produced.some(value => value instanceof type)) {
178
207
  throw new Error(`Expected reactor '${this._reactor.name}' to produce no '${type.name}'.`);
@@ -188,11 +217,7 @@ export class ReactorScenario {
188
217
  }
189
218
 
190
219
  private async deliver(sourceId: string, input: object[], setup: boolean, options?: AppendOptions): Promise<void> {
191
- if (this._failed) throw new UnsupportedReactorOperation('delivery.afterFailure', this._reactor.name,
192
- 'A previous delivery failed; failed-partition retries are not supported.');
193
- if (this._busy) throw new UnsupportedReactorOperation('delivery.overlap', this._reactor.name, 'Concurrent deliveries have unproven ordering.');
194
- this._busy = true;
195
- try {
220
+ await this.exclusively(async () => {
196
221
  if (!setup && !input.length) {
197
222
  throw new UnsupportedReactorOperation('when.events', this._reactor.name, 'Empty action batches are not fixture-backed.');
198
223
  }
@@ -200,13 +225,38 @@ export class ReactorScenario {
200
225
  if (setup) {
201
226
  await this._events.given.forEventSource(sourceId, options).events(...input);
202
227
  } else {
203
- const results = await this._events.when.forEventSource(sourceId, options).events(...input);
204
- const failures = results.filter(result => !result.isSuccess);
205
- if (failures.length) throw new Error(`ReactorScenario action append failed: ${JSON.stringify(failures, (_, value) =>
206
- typeof value === 'bigint' ? value.toString() : value)}`);
228
+ throwIfAppendFailed(await this._events.when.forEventSource(sourceId, options).events(...input));
229
+ }
230
+ const events = this._events.appendedEvents.slice(before);
231
+ if (events.length) await this.process(events);
232
+ });
233
+ }
234
+
235
+ private async deliverPage(entries: EventForEventSourceId[], setup: boolean): Promise<void> {
236
+ await this.exclusively(async () => {
237
+ if (!entries.length) {
238
+ throw new UnsupportedReactorOperation(setup ? 'given.page' : 'when.page', this._reactor.name, 'Empty pages are not fixture-backed.');
239
+ }
240
+ const before = this._events.appendedEvents.length;
241
+ if (setup) {
242
+ for (const entry of entries) {
243
+ await this._events.given.forEventSource(entry.eventSourceId, appendOptionsOf(entry)).events(entry.event);
244
+ }
245
+ } else {
246
+ throwIfAppendFailed(await this._events.appendMany(entries));
207
247
  }
208
248
  const events = this._events.appendedEvents.slice(before);
209
- if (events.length) await this.process(sourceId, events);
249
+ if (events.length) await this.process(events);
250
+ });
251
+ }
252
+
253
+ private async exclusively(deliver: () => Promise<void>): Promise<void> {
254
+ if (this._failed) throw new UnsupportedReactorOperation('delivery.afterFailure', this._reactor.name,
255
+ 'A previous delivery failed; failed-partition retries are not supported.');
256
+ if (this._busy) throw new UnsupportedReactorOperation('delivery.overlap', this._reactor.name, 'Concurrent deliveries have unproven ordering.');
257
+ this._busy = true;
258
+ try {
259
+ await deliver();
210
260
  } finally {
211
261
  this._busy = false;
212
262
  }
@@ -230,35 +280,37 @@ export class ReactorScenario {
230
280
  if (delivery.violation) throw delivery.violation;
231
281
  }
232
282
 
233
- private async process(sourceId: string, events: readonly AppendedEvent[]): Promise<void> {
283
+ private async process(events: readonly AppendedEvent[]): Promise<void> {
234
284
  const delivery: { violation?: Error } = {};
235
285
  this._delivery = delivery;
236
286
  const deliveryIndex = this._deliveryIndex++;
237
287
  const handled: EventContext[] = [];
238
288
  const skipped: EventContext[] = [];
239
- const outcome: { sourceId: string; handled: EventContext[]; skipped: EventContext[]; completed: boolean; error?: unknown } =
240
- { sourceId, handled, skipped, completed: false };
289
+ const sourceId = events[0].context.eventSourceId;
290
+ const partitions = [...new Set(events.map(event => event.context.eventSourceId))];
291
+ const outcome: { sourceId: string; partitions: readonly string[]; handled: EventContext[]; skipped: EventContext[];
292
+ completed: boolean; error?: unknown } = { sourceId, partitions, handled, skipped, completed: false };
241
293
  const services: ReactorServices = { eventStore: this._store, readModels: this._store.readModels, signal: this._controller.signal };
242
- const first = events.find(event => !!selectReactorHandler(this._entries, this._reactor, this._instance,
243
- event.eventType.id.value, event.context.observationState ?? 0)?.methodName);
294
+ const first = events.find(event => this._batchEventTypeIds.has(event.eventType.id.value) ||
295
+ !!selectReactorHandler(this._entries, this._reactor, this._instance, event.eventType.id.value, event.context.observationState ?? 0)?.methodName);
244
296
  const process = async (artifact: ActivatedArtifact<Record<string, Function>>) => {
297
+ // EventScenario's serialized history is the committed boundary, not the original input instance.
298
+ if (events.some(event => event.context.observationState !== 1)) {
299
+ throw new UnsupportedReactorOperation('delivery.observationState', this._reactor.name,
300
+ 'Only initial live delivery is fixture-backed.');
301
+ }
302
+ if (this._batchMethods.length > 0) await this.processBatches(artifact, events, handled, delivery);
245
303
  for (const event of events) {
246
- // EventScenario's serialized history is the committed boundary, not the original input instance.
247
- if (event.context.observationState !== 1) {
248
- throw new UnsupportedReactorOperation('delivery.observationState', this._reactor.name,
249
- 'Only initial live delivery is fixture-backed.');
250
- }
304
+ // The batch methods had these events, as one page.
305
+ if (this._batchEventTypeIds.has(event.eventType.id.value)) continue;
251
306
  const selection = selectReactorHandler(this._entries, this._reactor, artifact.instance,
252
- event.eventType.id.value, event.context.observationState);
307
+ event.eventType.id.value, event.context.observationState ?? 0);
253
308
  if (!selection?.methodName || selection.skipReplay) { skipped.push(event.context); continue; }
254
309
  await invokeReactorHandler(artifact, selection.methodName, event.content, event.context, services, result => {
255
310
  // A swallowed unsupported call fails this event like a throwing handler: nothing is recorded.
256
311
  this.throwIfViolated(delivery);
257
312
  return this.record(result, event.context, selection.methodName!, deliveryIndex);
258
- }, new ReactorDelivery(getReactorMetadata(this._reactor)!.id.value,
259
- event.context.eventStore ?? this._options.eventStore ?? 'test-event-store',
260
- event.context.namespace ?? this._options.namespace ?? 'default', 'event-log',
261
- event.context.eventSourceId, event.context.sequenceNumber));
313
+ }, this.deliveryFor(event.context));
262
314
  this.throwIfViolated(delivery);
263
315
  handled.push(event.context);
264
316
  }
@@ -287,10 +339,33 @@ export class ReactorScenario {
287
339
  throw error;
288
340
  } finally {
289
341
  if (this._delivery === delivery) this._delivery = undefined;
290
- this._results.push(Object.freeze({ ...outcome, handled: Object.freeze([...handled]), skipped: Object.freeze([...skipped]) }));
342
+ this._results.push(Object.freeze({ ...outcome, partitions: Object.freeze([...partitions]), handled: Object.freeze([...handled]), skipped: Object.freeze([...skipped]) }));
343
+ }
344
+ }
345
+
346
+ private async processBatches(artifact: ActivatedArtifact<Record<string, Function>>, events: readonly AppendedEvent[],
347
+ handled: EventContext[], delivery: { violation?: Error }): Promise<void> {
348
+ const outcomes = await deliverToBatchMethods(artifact, this._batchMethods, {
349
+ observerId: getReactorMetadata(this._reactor)!.id.value, observerName: this._reactor.name,
350
+ eventStore: this._options.eventStore ?? 'test-event-store', namespace: this._options.namespace ?? 'default',
351
+ events, signal: this._controller.signal, deliveryFor: context => this.deliveryFor(context)
352
+ });
353
+ this.throwIfViolated(delivery);
354
+ this._partitionOutcomes.push(...outcomes);
355
+ // An event is handled unless its partition was failed or deferred at or before it.
356
+ for (const event of events.filter(event => this._batchEventTypeIds.has(event.eventType.id.value))) {
357
+ if (!outcomes.some(reported => reported.partition === event.context.eventSourceId && reported.at <= event.context.sequenceNumber)) {
358
+ handled.push(event.context);
359
+ }
291
360
  }
292
361
  }
293
362
 
363
+ private deliveryFor(context: EventContext): ReactorDelivery {
364
+ return new ReactorDelivery(getReactorMetadata(this._reactor)!.id.value,
365
+ context.eventStore ?? this._options.eventStore ?? 'test-event-store',
366
+ context.namespace ?? this._options.namespace ?? 'default', 'event-log', context.eventSourceId, context.sequenceNumber);
367
+ }
368
+
294
369
  private async record(result: unknown, context: EventContext, handler: string, deliveryIndex: number): Promise<void> {
295
370
  if (await this._options.resultHandler?.(result, context, this._reactor,
296
371
  this._options.eventStore ?? 'test-event-store', this._options.namespace ?? 'default')) return;
@@ -313,3 +388,36 @@ export class ReactorScenario {
313
388
  }
314
389
  }
315
390
  }
391
+
392
+ /** The reactor scenario phase that delivers events for one event source, or a page of several. */
393
+ export interface ReactorScenarioPhase {
394
+ /**
395
+ * Selects the event source to deliver events for.
396
+ * @param id - The event source identifier.
397
+ * @param options - Optional append options.
398
+ * @returns The builder whose `events(...)` delivers its events as one page.
399
+ */
400
+ forEventSource(id: string, options?: AppendOptions): { events(...events: object[]): Promise<void> };
401
+
402
+ /**
403
+ * Delivers events of several event sources as one live page, as the kernel delivers a page to batch methods.
404
+ * @param events - The events and the event sources they are for, in the order they are appended.
405
+ * @returns A promise that resolves when every method has handled its events.
406
+ */
407
+ page(...events: EventForEventSourceId[]): Promise<void>;
408
+ }
409
+
410
+ function throwIfAppendFailed(results: readonly { isSuccess: boolean }[]): void {
411
+ const failures = results.filter(result => !result.isSuccess);
412
+ if (failures.length) throw new Error(`ReactorScenario action append failed: ${JSON.stringify(failures, (_, value) =>
413
+ typeof value === 'bigint' ? value.toString() : value)}`);
414
+ }
415
+
416
+ function appendOptionsOf(entry: EventForEventSourceId): AppendOptions | undefined {
417
+ // Only what the entry sets: the seeding path refuses options it cannot honor rather than dropping them.
418
+ const options = Object.fromEntries(Object.entries({
419
+ sourceType: entry.eventSourceType, streamType: entry.eventStreamType, streamId: entry.eventStreamId, subject: entry.subject,
420
+ occurred: entry.occurred, tags: entry.tags, namedTags: entry.namedTags, eventSource: entry.eventSource, eventStream: entry.eventStream
421
+ }).filter(([, value]) => value !== undefined)) as AppendOptions;
422
+ return Object.keys(options).length > 0 ? options : undefined;
423
+ }
@@ -0,0 +1,90 @@
1
+ // Copyright (c) Cratis. All rights reserved.
2
+ // Licensed under the MIT license. See LICENSE file in the project root for full license information.
3
+
4
+ import type { Constructor } from '@cratis/fundamentals';
5
+ import type { ActivatedArtifact } from '../artifacts/ActivatedArtifact.js';
6
+ import { ArtifactDelivery } from '../artifacts/ArtifactDelivery.js';
7
+ import { runActivated } from '../artifacts/withActivatedArtifact.js';
8
+ import type { AppendedEvent } from '../events/AppendedEvent.js';
9
+ import type { EventContext } from '../events/EventContext.js';
10
+ import { BatchContext } from '../observation/batches/BatchContext.js';
11
+ import type { BatchMethod } from '../observation/batches/BatchMethod.js';
12
+ import { BatchMethodReturnedAValue } from '../observation/batches/BatchMethodReturnedAValue.js';
13
+ import { EventAndContext } from '../observation/batches/EventAndContext.js';
14
+ import { EventBatch } from '../observation/batches/EventBatch.js';
15
+ import { ObservationOrigin } from '../observation/batches/ObservationOrigin.js';
16
+ import type { ReactorDelivery } from '../reactors/ReactorDelivery.js';
17
+ import type { BatchPartitionOutcome } from './BatchPartitionOutcome.js';
18
+
19
+ /** The page a scenario delivers to the batch methods of a reactor. */
20
+ export interface ScenarioPage {
21
+ /** The identifier of the reactor. */
22
+ readonly observerId: string;
23
+
24
+ /** The name of the reactor type, for errors. */
25
+ readonly observerName: string;
26
+
27
+ /** The event store the events come from. */
28
+ readonly eventStore: string;
29
+
30
+ /** The namespace the events come from. */
31
+ readonly namespace: string;
32
+
33
+ /** The events of the page, in sequence order. */
34
+ readonly events: readonly AppendedEvent[];
35
+
36
+ /** Aborted when the scenario is disposed. */
37
+ readonly signal: AbortSignal;
38
+
39
+ /** Creates the delivery identity of an event. */
40
+ readonly deliveryFor: (context: EventContext) => ReactorDelivery;
41
+ }
42
+
43
+ /**
44
+ * Delivers a page of events to the batch methods of a reactor as one live page, the way the kernel delivers a page: each
45
+ * batch method gets the events of the types it observes, in sequence order, as one {@link EventBatch}.
46
+ * @param artifact - The reactor instance, activated for the delivery.
47
+ * @param methods - The batch methods of the reactor.
48
+ * @param page - The {@link ScenarioPage}.
49
+ * @returns The partitions the batch methods reported as failed or deferred, in the order they were reported.
50
+ * @throws What a batch method throws, which fails every partition in its batch.
51
+ * @throws {@link BatchMethodReturnedAValue} when a batch method returns a value.
52
+ */
53
+ export async function deliverToBatchMethods(artifact: ActivatedArtifact<Record<string, Function>>, methods: readonly BatchMethod[],
54
+ page: ScenarioPage): Promise<BatchPartitionOutcome[]> {
55
+ const outcomes: BatchPartitionOutcome[] = [];
56
+ const sequenceNumbers = page.events.map(event => event.context.sequenceNumber);
57
+ const context = new BatchContext({
58
+ observerId: page.observerId,
59
+ eventStore: page.eventStore,
60
+ namespace: page.namespace,
61
+ eventSequenceId: 'event-log',
62
+ origin: ObservationOrigin.Live,
63
+ partitions: [...new Set(page.events.map(event => event.context.eventSourceId))],
64
+ eventCount: page.events.length,
65
+ firstSequenceNumber: sequenceNumbers[0],
66
+ lastSequenceNumber: sequenceNumbers[sequenceNumbers.length - 1],
67
+ deadline: undefined,
68
+ signal: page.signal,
69
+ canDefer: true
70
+ });
71
+
72
+ for (const method of methods) {
73
+ const observed = page.events.flatMap(event => {
74
+ const eventType = method.eventTypes.get(event.eventType.id.value);
75
+ return eventType ? [toEventAndContext(event, eventType.type, page)] : [];
76
+ });
77
+ if (observed.length === 0) continue;
78
+
79
+ const batch = new EventBatch(observed, context.canDefer);
80
+ const result: unknown = await runActivated(artifact, () => artifact.instance[method.methodName](batch, context),
81
+ { delivery: ArtifactDelivery.Events, eventContext: observed[0].context, methodName: method.methodName });
82
+ if (result !== undefined) throw new BatchMethodReturnedAValue(page.observerName, method.methodName);
83
+ outcomes.push(...batch.outcomes.map(outcome => ({ ...outcome, methodName: method.methodName })));
84
+ }
85
+ return outcomes;
86
+ }
87
+
88
+ function toEventAndContext(event: AppendedEvent, eventType: Constructor, page: ScenarioPage): EventAndContext {
89
+ return new EventAndContext(event.content, event.context, eventType, page.deliveryFor(event.context));
90
+ }