@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
@@ -0,0 +1,248 @@
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
+ import { toContractsGuid } from '../connection/Guid.js';
4
+ import { ensureCommandResponse, ensureQuerySuccess } from '../connection/callResults.js';
5
+ import { delay, readUntilAborted, untilAborted } from './abortable.js';
6
+ import { ImportChunkRefused } from './ImportChunkRefused.js';
7
+ import { ImportState } from './ImportState.js';
8
+ import { ImportWasAbandoned } from './ImportWasAbandoned.js';
9
+ import { isTransientImportFailure } from './isTransientImportFailure.js';
10
+ import { sizeOfImportEvent } from './sizeOfImportEvent.js';
11
+ import { toImportProgress } from './toImportProgress.js';
12
+ import { toImportResult } from './toImportResult.js';
13
+ const defaultMaxChunksInFlight = 4;
14
+ const defaultMaxChunkAttempts = 5;
15
+ const defaultPollInterval = 500;
16
+ const terminalStates = new Set([ImportState.Completed, ImportState.Failed, ImportState.Abandoned]);
17
+ /**
18
+ * Represents an implementation of {@link IEventImport} that cuts events into chunks within the kernel's limits and
19
+ * keeps a bounded number of them in flight.
20
+ */
21
+ export class EventImport {
22
+ importId;
23
+ eventsAcknowledged;
24
+ #settings;
25
+ #maxEventsPerChunk;
26
+ #maxBytesPerChunk;
27
+ #maxChunksInFlight;
28
+ #maxChunkAttempts;
29
+ #retryDelay;
30
+ #abandoning = new AbortController();
31
+ #sends = new Set();
32
+ #slotWaiters = [];
33
+ #buffer = [];
34
+ #bufferBytes = 0;
35
+ #nextChunkIndex;
36
+ #nextEventIndex;
37
+ #chunksInFlight = 0;
38
+ #exclusive = Promise.resolve();
39
+ #failure;
40
+ #abandoned = false;
41
+ /**
42
+ * Creates a new {@link EventImport}.
43
+ * @param settings - The {@link EventImportSettings}.
44
+ */
45
+ constructor(settings) {
46
+ this.#settings = settings;
47
+ this.importId = settings.importId;
48
+ this.eventsAcknowledged = settings.acknowledgedEvents ?? 0;
49
+ this.#nextChunkIndex = settings.acknowledgedChunks ?? 0;
50
+ this.#nextEventIndex = settings.acknowledgedEvents ?? 0;
51
+ const serverEvents = settings.maxChunkEvents > 0 ? settings.maxChunkEvents : Number.POSITIVE_INFINITY;
52
+ this.#maxEventsPerChunk = Math.max(1, Math.min(serverEvents, settings.options.maxEventsPerChunk ?? Number.POSITIVE_INFINITY));
53
+ this.#maxBytesPerChunk = settings.maxChunkBytes > 0 ? settings.maxChunkBytes : Number.POSITIVE_INFINITY;
54
+ this.#maxChunksInFlight = Math.max(1, settings.options.maxChunksInFlight ?? defaultMaxChunksInFlight);
55
+ this.#maxChunkAttempts = Math.max(1, settings.options.maxChunkAttempts ?? defaultMaxChunkAttempts);
56
+ this.#retryDelay = settings.retryDelay ?? (attempt => Math.min(5000, 200 * attempt * attempt));
57
+ }
58
+ /** @inheritdoc */
59
+ async *progress(signal) {
60
+ try {
61
+ for await (const result of this.#settings.imports.observeImport(this.#identity(), { signal })) {
62
+ if (result.Data)
63
+ yield toImportProgress(result.Data);
64
+ }
65
+ }
66
+ catch (error) {
67
+ if (signal?.aborted)
68
+ return;
69
+ throw error;
70
+ }
71
+ }
72
+ /** @inheritdoc */
73
+ add(events, signal) {
74
+ return this.#whileNotAbandoned(async (waiting) => {
75
+ for await (const event of readUntilAborted(events, waiting)) {
76
+ await this.#bufferEvent(event, waiting);
77
+ }
78
+ }, signal);
79
+ }
80
+ /** @inheritdoc */
81
+ async complete(signal) {
82
+ let result;
83
+ await this.#whileNotAbandoned(async (waiting) => {
84
+ await this.#flush(waiting);
85
+ await untilAborted(Promise.all([...this.#sends]), waiting);
86
+ this.#throwIfFailed();
87
+ this.#throwIfAbandoned();
88
+ const status = ensureCommandResponse('complete import', await this.#settings.imports.completeImport({
89
+ ...this.#identity(),
90
+ ExpectedChunks: this.#nextChunkIndex,
91
+ ExpectedEvents: BigInt(this.#nextEventIndex)
92
+ }, { signal: waiting }));
93
+ result = !status.Error && (this.#settings.options.waitForCommit ?? true)
94
+ ? await this.#waitForCommit(waiting)
95
+ : await this.#read(waiting) ?? this.#resultFrom(status.State, status.Error);
96
+ }, signal);
97
+ return result;
98
+ }
99
+ /** @inheritdoc */
100
+ async abandon(signal) {
101
+ // No chunk is sent once this is set, and an add in progress is stopped rather than waited for: it may be reading
102
+ // a source that never yields again.
103
+ this.#abandoned = true;
104
+ this.#abandoning.abort(new ImportWasAbandoned(this.importId));
105
+ // Chunks already handed to the kernel settle first, so none is staged after the import is abandoned.
106
+ await untilAborted(Promise.all([...this.#sends]), signal);
107
+ const status = ensureCommandResponse('abandon import', await this.#settings.imports.abandonImport(this.#identity(), { signal }));
108
+ return await this.#read(signal) ?? this.#resultFrom(status.State, status.Error);
109
+ }
110
+ #identity() {
111
+ return { EventStore: this.#settings.eventStore, Namespace: this.#settings.namespace, ImportId: toContractsGuid(this.importId) };
112
+ }
113
+ async #whileNotAbandoned(work, signal) {
114
+ this.#throwIfAbandoned();
115
+ const waiting = signal ? AbortSignal.any([signal, this.#abandoning.signal]) : this.#abandoning.signal;
116
+ // Adds and completion run one at a time, so chunks are cut from the events in the order they were added.
117
+ const run = this.#exclusive.then(() => {
118
+ waiting.throwIfAborted();
119
+ return work(waiting);
120
+ });
121
+ this.#exclusive = run.catch(() => undefined);
122
+ try {
123
+ await run;
124
+ }
125
+ catch (error) {
126
+ if (this.#abandoning.signal.aborted && !signal?.aborted)
127
+ throw new ImportWasAbandoned(this.importId);
128
+ throw error;
129
+ }
130
+ }
131
+ async #bufferEvent(event, waiting) {
132
+ this.#throwIfFailed();
133
+ this.#throwIfAbandoned();
134
+ const converted = this.#settings.convert(event);
135
+ const bytes = sizeOfImportEvent(converted);
136
+ if (this.#buffer.length > 0 &&
137
+ (this.#buffer.length >= this.#maxEventsPerChunk || this.#bufferBytes + bytes > this.#maxBytesPerChunk)) {
138
+ await this.#flush(waiting);
139
+ }
140
+ this.#buffer.push(converted);
141
+ this.#bufferBytes += bytes;
142
+ }
143
+ async #flush(waiting) {
144
+ if (this.#buffer.length === 0)
145
+ return;
146
+ await this.#acquireSlot(waiting);
147
+ // Checked after the wait, so an abandon sees every chunk sent before it and none is sent after it.
148
+ if (this.#abandoned) {
149
+ this.#releaseSlot();
150
+ throw new ImportWasAbandoned(this.importId);
151
+ }
152
+ const events = this.#buffer;
153
+ const chunkIndex = this.#nextChunkIndex++;
154
+ const firstEventIndex = this.#nextEventIndex;
155
+ this.#nextEventIndex += events.length;
156
+ this.#buffer = [];
157
+ this.#bufferBytes = 0;
158
+ const send = this.#send(chunkIndex, firstEventIndex, events).finally(() => this.#sends.delete(send));
159
+ this.#sends.add(send);
160
+ }
161
+ async #send(chunkIndex, firstEventIndex, events) {
162
+ try {
163
+ for (let attempt = 1;; attempt++) {
164
+ try {
165
+ const result = ensureCommandResponse('add import chunk', await this.#settings.imports.addImportChunk({
166
+ ...this.#identity(),
167
+ ChunkIndex: chunkIndex,
168
+ FirstEventIndex: BigInt(firstEventIndex),
169
+ Events: events
170
+ }));
171
+ if (result.Error)
172
+ throw new ImportChunkRefused(chunkIndex, result.Error);
173
+ return;
174
+ }
175
+ catch (error) {
176
+ if (!isTransientImportFailure(error) || attempt >= this.#maxChunkAttempts)
177
+ throw error;
178
+ // Sending the chunk again is safe: the kernel stages a chunk under its index once.
179
+ await delay(this.#retryDelay(attempt), this.#abandoning.signal);
180
+ }
181
+ }
182
+ }
183
+ catch (error) {
184
+ this.#failure ??= { error };
185
+ }
186
+ finally {
187
+ this.#releaseSlot();
188
+ }
189
+ }
190
+ #acquireSlot(waiting) {
191
+ if (this.#chunksInFlight < this.#maxChunksInFlight) {
192
+ this.#chunksInFlight++;
193
+ return Promise.resolve();
194
+ }
195
+ return new Promise((resolve, reject) => {
196
+ const granted = () => {
197
+ waiting.removeEventListener('abort', aborted);
198
+ resolve();
199
+ };
200
+ const aborted = () => {
201
+ const index = this.#slotWaiters.indexOf(granted);
202
+ if (index >= 0)
203
+ this.#slotWaiters.splice(index, 1);
204
+ reject(waiting.reason);
205
+ };
206
+ if (waiting.aborted)
207
+ return reject(waiting.reason);
208
+ waiting.addEventListener('abort', aborted, { once: true });
209
+ this.#slotWaiters.push(granted);
210
+ });
211
+ }
212
+ #releaseSlot() {
213
+ // A waiting chunk takes over the slot, so the number in flight never exceeds the bound.
214
+ const next = this.#slotWaiters.shift();
215
+ if (next)
216
+ next();
217
+ else
218
+ this.#chunksInFlight--;
219
+ }
220
+ #throwIfAbandoned() {
221
+ if (this.#abandoned)
222
+ throw new ImportWasAbandoned(this.importId);
223
+ }
224
+ #throwIfFailed() {
225
+ if (this.#failure)
226
+ throw this.#failure.error;
227
+ }
228
+ async #waitForCommit(waiting) {
229
+ const pollInterval = this.#settings.pollInterval ?? defaultPollInterval;
230
+ while (true) {
231
+ const result = await this.#read(waiting);
232
+ if (result && terminalStates.has(result.state))
233
+ return result;
234
+ await delay(pollInterval, waiting);
235
+ }
236
+ }
237
+ async #read(signal) {
238
+ const progress = ensureQuerySuccess('get import', await this.#settings.imports.getImport(this.#identity(), { signal }));
239
+ return progress ? toImportResult(progress) : undefined;
240
+ }
241
+ #resultFrom(state, reason) {
242
+ return {
243
+ importId: this.importId, state, eventsStaged: 0, eventsCommitted: 0, alreadyAppended: 0,
244
+ rejectedCount: 0, rejections: [], failureReason: reason ? reason : undefined, isSuccess: state === ImportState.Completed
245
+ };
246
+ }
247
+ }
248
+ //# sourceMappingURL=EventImport.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"EventImport.js","sourceRoot":"","sources":["../../imports/EventImport.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,32 @@
1
+ import type { Guid } from '@cratis/fundamentals';
2
+ import type { ImportEvent, ImportsClient } from '@cratis/chronicle.contracts';
3
+ import type { EventForEventSourceId } from '../eventSequences/EventForEventSourceId.js';
4
+ import type { ImportOptions } from './ImportOptions.js';
5
+ /** What an {@link EventImport} session is created with. */
6
+ export interface EventImportSettings {
7
+ /** The Imports service. */
8
+ readonly imports: ImportsClient;
9
+ /** The name of the event store. */
10
+ readonly eventStore: string;
11
+ /** The namespace. */
12
+ readonly namespace: string;
13
+ /** The identifier of the import. */
14
+ readonly importId: Guid;
15
+ /** The {@link ImportOptions}. */
16
+ readonly options: ImportOptions;
17
+ /** The most events the kernel accepts in one chunk; zero or less means no limit. */
18
+ readonly maxChunkEvents: number;
19
+ /** The most bytes of event content the kernel accepts in one chunk; zero or less means no limit. */
20
+ readonly maxChunkBytes: number;
21
+ /** Converts an event to its wire form. */
22
+ readonly convert: (event: EventForEventSourceId) => ImportEvent;
23
+ /** How many chunks the kernel already holds without a gap, when reattaching. */
24
+ readonly acknowledgedChunks?: number;
25
+ /** How many events those chunks carry, when reattaching. */
26
+ readonly acknowledgedEvents?: number;
27
+ /** The delay, in milliseconds, before an attempt to send a chunk again. */
28
+ readonly retryDelay?: (attempt: number) => number;
29
+ /** The interval, in milliseconds, between reads of the import while waiting for its commit. */
30
+ readonly pollInterval?: number;
31
+ }
32
+ //# sourceMappingURL=EventImportSettings.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"EventImportSettings.d.ts","sourceRoot":"","sources":["../../imports/EventImportSettings.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC9E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AACxF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,2DAA2D;AAC3D,MAAM,WAAW,mBAAmB;IAChC,2BAA2B;IAC3B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAEhC,mCAAmC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,qBAAqB;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,oCAAoC;IACpC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IAExB,iCAAiC;IACjC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAEhC,oFAAoF;IACpF,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAEhC,oGAAoG;IACpG,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAE/B,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,WAAW,CAAC;IAEhE,gFAAgF;IAChF,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAErC,4DAA4D;IAC5D,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAErC,2EAA2E;IAC3E,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IAElD,+FAA+F;IAC/F,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAClC"}
@@ -0,0 +1,4 @@
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
+ export {};
4
+ //# sourceMappingURL=EventImportSettings.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"EventImportSettings.js","sourceRoot":"","sources":["../../imports/EventImportSettings.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG"}
@@ -0,0 +1,50 @@
1
+ import type { Guid } from '@cratis/fundamentals';
2
+ import type { EventForEventSourceId } from '../eventSequences/EventForEventSourceId.js';
3
+ import type { ImportProgress } from './ImportProgress.js';
4
+ import type { ImportResult } from './ImportResult.js';
5
+ /**
6
+ * Defines an import session that events are added to in chunks, for producers that are not a single stream.
7
+ * @remarks
8
+ * Events are cut into chunks within the kernel's limits and a bounded number of chunks are sent at the same time.
9
+ * Nothing is committed before {@link IEventImport.complete}. A session that is not completed stays open on the kernel,
10
+ * so it can be reattached by its {@link IEventImport.importId}; the kernel abandons it once its staging retention runs out.
11
+ */
12
+ export interface IEventImport {
13
+ /** The identifier of the import. */
14
+ readonly importId: Guid;
15
+ /**
16
+ * How many events the kernel already held, in order and without a gap, when this session was attached. A producer
17
+ * that reattaches continues after this many events; a new session starts at zero.
18
+ */
19
+ readonly eventsAcknowledged: number;
20
+ /**
21
+ * Observes the progress of the import as the kernel reports it.
22
+ * @param signal - Ends the observation when aborted.
23
+ * @returns An async iterable of {@link ImportProgress}.
24
+ */
25
+ progress(signal?: AbortSignal): AsyncIterable<ImportProgress>;
26
+ /**
27
+ * Adds events to the import, reading them lazily.
28
+ * @param events - The events, in the order they are to be committed.
29
+ * @param signal - Stops adding when aborted.
30
+ * @returns A promise that resolves once the events are handed to the kernel within the in-flight bound.
31
+ */
32
+ add(events: AsyncIterable<EventForEventSourceId> | Iterable<EventForEventSourceId>, signal?: AbortSignal): Promise<void>;
33
+ /**
34
+ * Completes the import: waits for every chunk to be acknowledged, closes staging and starts the commit.
35
+ * @param signal - Stops waiting when aborted.
36
+ * @returns The {@link ImportResult}, once committed unless {@link ImportOptions.waitForCommit} is false.
37
+ */
38
+ complete(signal?: AbortSignal): Promise<ImportResult>;
39
+ /**
40
+ * Abandons the import, discarding everything staged. Nothing is committed.
41
+ * @param signal - Stops waiting for chunks already being sent; when it aborts first, the import is not abandoned on
42
+ * the kernel, which abandons it once its staging retention runs out.
43
+ * @returns The {@link ImportResult}.
44
+ * @remarks
45
+ * No chunk is sent once abandoning begins. An {@link IEventImport.add} in progress is stopped rather than waited for,
46
+ * and ends with {@link ImportWasAbandoned}. Adding to or completing the import afterwards throws {@link ImportWasAbandoned}.
47
+ */
48
+ abandon(signal?: AbortSignal): Promise<ImportResult>;
49
+ }
50
+ //# sourceMappingURL=IEventImport.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"IEventImport.d.ts","sourceRoot":"","sources":["../../imports/IEventImport.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IACzB,oCAAoC;IACpC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IAExB;;;OAGG;IACH,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IAEpC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,aAAa,CAAC,cAAc,CAAC,CAAC;IAE9D;;;;;OAKG;IACH,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,qBAAqB,CAAC,GAAG,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzH;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEtD;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACxD"}
@@ -0,0 +1,4 @@
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
+ export {};
4
+ //# sourceMappingURL=IEventImport.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"IEventImport.js","sourceRoot":"","sources":["../../imports/IEventImport.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG"}
@@ -0,0 +1,12 @@
1
+ /** The exception that is thrown when the kernel refuses a chunk of an import. */
2
+ export declare class ImportChunkRefused extends Error {
3
+ readonly chunkIndex: number;
4
+ readonly reason: string;
5
+ /**
6
+ * Creates a new {@link ImportChunkRefused}.
7
+ * @param chunkIndex - The index of the chunk.
8
+ * @param reason - Why the kernel refused it.
9
+ */
10
+ constructor(chunkIndex: number, reason: string);
11
+ }
12
+ //# sourceMappingURL=ImportChunkRefused.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ImportChunkRefused.d.ts","sourceRoot":"","sources":["../../imports/ImportChunkRefused.ts"],"names":[],"mappings":"AAGA,iFAAiF;AACjF,qBAAa,kBAAmB,SAAQ,KAAK;IAM7B,QAAQ,CAAC,UAAU,EAAE,MAAM;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM;IALhE;;;;OAIG;IACH,YAAqB,UAAU,EAAE,MAAM,EAAW,MAAM,EAAE,MAAM,EAG/D;CACJ"}
@@ -0,0 +1,19 @@
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
+ /** The exception that is thrown when the kernel refuses a chunk of an import. */
4
+ export class ImportChunkRefused extends Error {
5
+ chunkIndex;
6
+ reason;
7
+ /**
8
+ * Creates a new {@link ImportChunkRefused}.
9
+ * @param chunkIndex - The index of the chunk.
10
+ * @param reason - Why the kernel refused it.
11
+ */
12
+ constructor(chunkIndex, reason) {
13
+ super(`The kernel refused chunk ${chunkIndex} of the import: ${reason}`);
14
+ this.chunkIndex = chunkIndex;
15
+ this.reason = reason;
16
+ this.name = 'ImportChunkRefused';
17
+ }
18
+ }
19
+ //# sourceMappingURL=ImportChunkRefused.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ImportChunkRefused.js","sourceRoot":"","sources":["../../imports/ImportChunkRefused.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,iFAAiF;AACjF,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAMpB,UAAU;IAAmB,MAAM;IALxD;;;;OAIG;IACH,YAAqB,UAAkB,EAAW,MAAc;QAC5D,KAAK,CAAC,4BAA4B,UAAU,mBAAmB,MAAM,EAAE,CAAC,CAAC;0BADxD,UAAU;sBAAmB,MAAM;QAEpD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACrC,CAAC;CACJ"}
@@ -0,0 +1,10 @@
1
+ /** The exception that is thrown when an import could not begin or be reattached. */
2
+ export declare class ImportCouldNotBegin extends Error {
3
+ readonly reason: string;
4
+ /**
5
+ * Creates a new {@link ImportCouldNotBegin}.
6
+ * @param reason - Why the import could not begin.
7
+ */
8
+ constructor(reason: string);
9
+ }
10
+ //# sourceMappingURL=ImportCouldNotBegin.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ImportCouldNotBegin.d.ts","sourceRoot":"","sources":["../../imports/ImportCouldNotBegin.ts"],"names":[],"mappings":"AAGA,oFAAoF;AACpF,qBAAa,mBAAoB,SAAQ,KAAK;IAK9B,QAAQ,CAAC,MAAM,EAAE,MAAM;IAJnC;;;OAGG;IACH,YAAqB,MAAM,EAAE,MAAM,EAGlC;CACJ"}
@@ -0,0 +1,16 @@
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
+ /** The exception that is thrown when an import could not begin or be reattached. */
4
+ export class ImportCouldNotBegin extends Error {
5
+ reason;
6
+ /**
7
+ * Creates a new {@link ImportCouldNotBegin}.
8
+ * @param reason - Why the import could not begin.
9
+ */
10
+ constructor(reason) {
11
+ super(`The import could not begin: ${reason}`);
12
+ this.reason = reason;
13
+ this.name = 'ImportCouldNotBegin';
14
+ }
15
+ }
16
+ //# sourceMappingURL=ImportCouldNotBegin.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ImportCouldNotBegin.js","sourceRoot":"","sources":["../../imports/ImportCouldNotBegin.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,oFAAoF;AACpF,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAKrB,MAAM;IAJ3B;;;OAGG;IACH,YAAqB,MAAc;QAC/B,KAAK,CAAC,+BAA+B,MAAM,EAAE,CAAC,CAAC;sBAD9B,MAAM;QAEvB,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACtC,CAAC;CACJ"}
@@ -0,0 +1,26 @@
1
+ import type { Guid } from '@cratis/fundamentals';
2
+ import type { ImportProgress } from './ImportProgress.js';
3
+ import type { OnInvalidEvent } from './OnInvalidEvent.js';
4
+ /** Options for importing events into an event sequence. */
5
+ export interface ImportOptions {
6
+ /** What the import does when one of its events is invalid. Defaults to {@link OnInvalidEvent.Reject}: nothing is committed. */
7
+ readonly onInvalid?: OnInvalidEvent;
8
+ /** Whether completing the import waits until it is committed. Defaults to true. */
9
+ readonly waitForCommit?: boolean;
10
+ /** How many chunks are sent to the kernel at the same time. Defaults to 4. */
11
+ readonly maxChunksInFlight?: number;
12
+ /** The most events the client puts in one chunk; the kernel's own limit applies when it is lower. */
13
+ readonly maxEventsPerChunk?: number;
14
+ /**
15
+ * The identifier to give the import; a new one is created when not set. Beginning an import with an identifier
16
+ * that already exists returns that import.
17
+ */
18
+ readonly importId?: string | Guid;
19
+ /** How many times a chunk is sent after the connection fails. Resending is safe: the kernel stages a chunk once. Defaults to 5. */
20
+ readonly maxChunkAttempts?: number;
21
+ /** Cancels the import. Chunks the kernel already holds stay staged, so the import can be reattached by its identifier. */
22
+ readonly signal?: AbortSignal;
23
+ /** Called with the progress of the import as the kernel reports it, until the import call returns. */
24
+ readonly onProgress?: (progress: ImportProgress) => void;
25
+ }
26
+ //# sourceMappingURL=ImportOptions.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ImportOptions.d.ts","sourceRoot":"","sources":["../../imports/ImportOptions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,2DAA2D;AAC3D,MAAM,WAAW,aAAa;IAC1B,+HAA+H;IAC/H,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC;IAEpC,mFAAmF;IACnF,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IAEjC,8EAA8E;IAC9E,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAEpC,qGAAqG;IACrG,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAEpC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAElC,mIAAmI;IACnI,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAEnC,0HAA0H;IAC1H,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAE9B,sGAAsG;IACtG,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;CAC5D"}
@@ -0,0 +1,4 @@
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
+ export {};
4
+ //# sourceMappingURL=ImportOptions.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ImportOptions.js","sourceRoot":"","sources":["../../imports/ImportOptions.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG"}
@@ -0,0 +1,20 @@
1
+ import type { Guid } from '@cratis/fundamentals';
2
+ import type { ImportState } from './ImportState.js';
3
+ /** The progress of an import as the kernel reports it. */
4
+ export interface ImportProgress {
5
+ /** The identifier of the import. */
6
+ readonly importId: Guid;
7
+ /** The state the import is in. */
8
+ readonly state: ImportState;
9
+ /** How many events the kernel has received. */
10
+ readonly eventsReceived: number;
11
+ /** How many events are staged. */
12
+ readonly eventsStaged: number;
13
+ /** How many events are committed. */
14
+ readonly eventsCommitted: number;
15
+ /** How many events were already appended under their idempotency key, and so not appended again. */
16
+ readonly alreadyAppended: number;
17
+ /** How many events were rejected. */
18
+ readonly eventsRejected: number;
19
+ }
20
+ //# sourceMappingURL=ImportProgress.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ImportProgress.d.ts","sourceRoot":"","sources":["../../imports/ImportProgress.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,0DAA0D;AAC1D,MAAM,WAAW,cAAc;IAC3B,oCAAoC;IACpC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IAExB,kCAAkC;IAClC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAE5B,+CAA+C;IAC/C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAEhC,kCAAkC;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B,qCAAqC;IACrC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAEjC,oGAAoG;IACpG,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAEjC,qCAAqC;IACrC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACnC"}
@@ -0,0 +1,4 @@
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
+ export {};
4
+ //# sourceMappingURL=ImportProgress.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ImportProgress.js","sourceRoot":"","sources":["../../imports/ImportProgress.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG"}
@@ -0,0 +1,10 @@
1
+ /** An event an import rejected. */
2
+ export interface ImportRejection {
3
+ /** The position of the event in the import, counted from zero across every chunk. */
4
+ readonly index: number;
5
+ /** The identifier of the event's type. */
6
+ readonly eventType: string;
7
+ /** Why the event was rejected. */
8
+ readonly reasons: readonly string[];
9
+ }
10
+ //# sourceMappingURL=ImportRejection.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ImportRejection.d.ts","sourceRoot":"","sources":["../../imports/ImportRejection.ts"],"names":[],"mappings":"AAGA,mCAAmC;AACnC,MAAM,WAAW,eAAe;IAC5B,qFAAqF;IACrF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,0CAA0C;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,kCAAkC;IAClC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC"}
@@ -0,0 +1,4 @@
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
+ export {};
4
+ //# sourceMappingURL=ImportRejection.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ImportRejection.js","sourceRoot":"","sources":["../../imports/ImportRejection.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG"}
@@ -0,0 +1,30 @@
1
+ import type { Guid } from '@cratis/fundamentals';
2
+ import type { EventSequenceNumber } from '../eventSequences/EventSequenceNumber.js';
3
+ import type { ImportRejection } from './ImportRejection.js';
4
+ import type { ImportState } from './ImportState.js';
5
+ /** The outcome of an import. */
6
+ export interface ImportResult {
7
+ /** The identifier of the import. */
8
+ readonly importId: Guid;
9
+ /** The state the import reached. */
10
+ readonly state: ImportState;
11
+ /** How many events were staged. */
12
+ readonly eventsStaged: number;
13
+ /** How many events were committed. */
14
+ readonly eventsCommitted: number;
15
+ /** How many events were already appended under their idempotency key, and so not appended again. */
16
+ readonly alreadyAppended: number;
17
+ /** The first sequence number the import committed, if it committed any. */
18
+ readonly firstSequenceNumber?: EventSequenceNumber;
19
+ /** The last sequence number the import committed, if it committed any. */
20
+ readonly lastSequenceNumber?: EventSequenceNumber;
21
+ /** How many events were rejected, including any beyond the retained {@link ImportResult.rejections}. */
22
+ readonly rejectedCount: number;
23
+ /** The rejected events, each with its index in the import, its event type and the reasons. */
24
+ readonly rejections: readonly ImportRejection[];
25
+ /** Why the import failed or was abandoned, if it was. */
26
+ readonly failureReason?: string;
27
+ /** Whether the import completed. */
28
+ readonly isSuccess: boolean;
29
+ }
30
+ //# sourceMappingURL=ImportResult.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ImportResult.d.ts","sourceRoot":"","sources":["../../imports/ImportResult.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AACpF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,gCAAgC;AAChC,MAAM,WAAW,YAAY;IACzB,oCAAoC;IACpC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IAExB,oCAAoC;IACpC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAE5B,mCAAmC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B,sCAAsC;IACtC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAEjC,oGAAoG;IACpG,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAEjC,2EAA2E;IAC3E,QAAQ,CAAC,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAEnD,0EAA0E;IAC1E,QAAQ,CAAC,kBAAkB,CAAC,EAAE,mBAAmB,CAAC;IAElD,wGAAwG;IACxG,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAE/B,8FAA8F;IAC9F,QAAQ,CAAC,UAAU,EAAE,SAAS,eAAe,EAAE,CAAC;IAEhD,yDAAyD;IACzD,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEhC,oCAAoC;IACpC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC/B"}
@@ -0,0 +1,4 @@
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
+ export {};
4
+ //# sourceMappingURL=ImportResult.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ImportResult.js","sourceRoot":"","sources":["../../imports/ImportResult.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG"}
@@ -0,0 +1,18 @@
1
+ /** The state of an import session. */
2
+ export declare enum ImportState {
3
+ /** The import is open and has not received any chunk yet. */
4
+ Open = 0,
5
+ /** The import has received chunks and accepts more. */
6
+ Staging = 1,
7
+ /** Staging is closed and the whole import is being validated. */
8
+ Validating = 2,
9
+ /** The staged events are being committed to the event sequence. */
10
+ Committing = 3,
11
+ /** Every staged event was committed or reported. */
12
+ Completed = 4,
13
+ /** The import failed; when it failed before committing, nothing was committed. */
14
+ Failed = 5,
15
+ /** The import was abandoned before its commit started. */
16
+ Abandoned = 6
17
+ }
18
+ //# sourceMappingURL=ImportState.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ImportState.d.ts","sourceRoot":"","sources":["../../imports/ImportState.ts"],"names":[],"mappings":"AAGA,sCAAsC;AACtC,oBAAY,WAAW;IACnB,6DAA6D;IAC7D,IAAI,IAAI;IAER,uDAAuD;IACvD,OAAO,IAAI;IAEX,iEAAiE;IACjE,UAAU,IAAI;IAEd,mEAAmE;IACnE,UAAU,IAAI;IAEd,oDAAoD;IACpD,SAAS,IAAI;IAEb,kFAAkF;IAClF,MAAM,IAAI;IAEV,0DAA0D;IAC1D,SAAS,IAAI;CAChB"}