@cratis/chronicle 6.61.0 → 6.63.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 (268) hide show
  1. package/ChronicleClient.ts +86 -3
  2. package/connection/ChronicleConnection.ts +7 -1
  3. package/connection/ChronicleServices.ts +2 -0
  4. package/connection/ConnectionLifecycle.ts +42 -1
  5. package/dist/ChronicleClient.d.ts +28 -1
  6. package/dist/ChronicleClient.d.ts.map +1 -1
  7. package/dist/ChronicleClient.js +71 -3
  8. package/dist/ChronicleClient.js.map +1 -1
  9. package/dist/connection/ChronicleConnection.d.ts +1 -0
  10. package/dist/connection/ChronicleConnection.d.ts.map +1 -1
  11. package/dist/connection/ChronicleConnection.js +6 -2
  12. package/dist/connection/ChronicleConnection.js.map +1 -1
  13. package/dist/connection/ChronicleServices.d.ts +2 -1
  14. package/dist/connection/ChronicleServices.d.ts.map +1 -1
  15. package/dist/connection/ConnectionLifecycle.d.ts +24 -0
  16. package/dist/connection/ConnectionLifecycle.d.ts.map +1 -1
  17. package/dist/connection/ConnectionLifecycle.js +40 -1
  18. package/dist/connection/ConnectionLifecycle.js.map +1 -1
  19. package/dist/eventSequences/EventForEventSourceId.d.ts +21 -1
  20. package/dist/eventSequences/EventForEventSourceId.d.ts.map +1 -1
  21. package/dist/eventSequences/EventSequence.d.ts +9 -0
  22. package/dist/eventSequences/EventSequence.d.ts.map +1 -1
  23. package/dist/eventSequences/EventSequence.js +18 -0
  24. package/dist/eventSequences/EventSequence.js.map +1 -1
  25. package/dist/eventSequences/IEventSequence.d.ts +30 -0
  26. package/dist/eventSequences/IEventSequence.d.ts.map +1 -1
  27. package/dist/imports/EventImport.d.ts +29 -0
  28. package/dist/imports/EventImport.d.ts.map +1 -0
  29. package/dist/imports/EventImport.js +248 -0
  30. package/dist/imports/EventImport.js.map +1 -0
  31. package/dist/imports/EventImportSettings.d.ts +32 -0
  32. package/dist/imports/EventImportSettings.d.ts.map +1 -0
  33. package/dist/imports/EventImportSettings.js +4 -0
  34. package/dist/imports/EventImportSettings.js.map +1 -0
  35. package/dist/imports/IEventImport.d.ts +50 -0
  36. package/dist/imports/IEventImport.d.ts.map +1 -0
  37. package/dist/imports/IEventImport.js +4 -0
  38. package/dist/imports/IEventImport.js.map +1 -0
  39. package/dist/imports/ImportChunkRefused.d.ts +12 -0
  40. package/dist/imports/ImportChunkRefused.d.ts.map +1 -0
  41. package/dist/imports/ImportChunkRefused.js +19 -0
  42. package/dist/imports/ImportChunkRefused.js.map +1 -0
  43. package/dist/imports/ImportCouldNotBegin.d.ts +10 -0
  44. package/dist/imports/ImportCouldNotBegin.d.ts.map +1 -0
  45. package/dist/imports/ImportCouldNotBegin.js +16 -0
  46. package/dist/imports/ImportCouldNotBegin.js.map +1 -0
  47. package/dist/imports/ImportOptions.d.ts +26 -0
  48. package/dist/imports/ImportOptions.d.ts.map +1 -0
  49. package/dist/imports/ImportOptions.js +4 -0
  50. package/dist/imports/ImportOptions.js.map +1 -0
  51. package/dist/imports/ImportProgress.d.ts +20 -0
  52. package/dist/imports/ImportProgress.d.ts.map +1 -0
  53. package/dist/imports/ImportProgress.js +4 -0
  54. package/dist/imports/ImportProgress.js.map +1 -0
  55. package/dist/imports/ImportRejection.d.ts +10 -0
  56. package/dist/imports/ImportRejection.d.ts.map +1 -0
  57. package/dist/imports/ImportRejection.js +4 -0
  58. package/dist/imports/ImportRejection.js.map +1 -0
  59. package/dist/imports/ImportResult.d.ts +30 -0
  60. package/dist/imports/ImportResult.d.ts.map +1 -0
  61. package/dist/imports/ImportResult.js +4 -0
  62. package/dist/imports/ImportResult.js.map +1 -0
  63. package/dist/imports/ImportState.d.ts +18 -0
  64. package/dist/imports/ImportState.d.ts.map +1 -0
  65. package/dist/imports/ImportState.js +21 -0
  66. package/dist/imports/ImportState.js.map +1 -0
  67. package/dist/imports/ImportTarget.d.ts +16 -0
  68. package/dist/imports/ImportTarget.d.ts.map +1 -0
  69. package/dist/imports/ImportTarget.js +4 -0
  70. package/dist/imports/ImportTarget.js.map +1 -0
  71. package/dist/imports/ImportWasAbandoned.d.ts +11 -0
  72. package/dist/imports/ImportWasAbandoned.d.ts.map +1 -0
  73. package/dist/imports/ImportWasAbandoned.js +16 -0
  74. package/dist/imports/ImportWasAbandoned.js.map +1 -0
  75. package/dist/imports/ImportsNotSupported.d.ts +5 -0
  76. package/dist/imports/ImportsNotSupported.d.ts.map +1 -0
  77. package/dist/imports/ImportsNotSupported.js +10 -0
  78. package/dist/imports/ImportsNotSupported.js.map +1 -0
  79. package/dist/imports/OnInvalidEvent.d.ts +8 -0
  80. package/dist/imports/OnInvalidEvent.d.ts.map +1 -0
  81. package/dist/imports/OnInvalidEvent.js +11 -0
  82. package/dist/imports/OnInvalidEvent.js.map +1 -0
  83. package/dist/imports/abortable.d.ts +23 -0
  84. package/dist/imports/abortable.d.ts.map +1 -0
  85. package/dist/imports/abortable.js +60 -0
  86. package/dist/imports/abortable.js.map +1 -0
  87. package/dist/imports/beginEventImport.d.ts +16 -0
  88. package/dist/imports/beginEventImport.d.ts.map +1 -0
  89. package/dist/imports/beginEventImport.js +74 -0
  90. package/dist/imports/beginEventImport.js.map +1 -0
  91. package/dist/imports/for_EventImport/given/a_kernel_import_session.d.ts +144 -0
  92. package/dist/imports/for_EventImport/given/a_kernel_import_session.d.ts.map +1 -0
  93. package/dist/imports/for_EventImport/given/a_kernel_import_session.js +132 -0
  94. package/dist/imports/for_EventImport/given/a_kernel_import_session.js.map +1 -0
  95. package/dist/imports/importEvents.d.ts +13 -0
  96. package/dist/imports/importEvents.d.ts.map +1 -0
  97. package/dist/imports/importEvents.js +35 -0
  98. package/dist/imports/importEvents.js.map +1 -0
  99. package/dist/imports/index.d.ts +12 -0
  100. package/dist/imports/index.d.ts.map +1 -0
  101. package/dist/imports/index.js +9 -0
  102. package/dist/imports/index.js.map +1 -0
  103. package/dist/imports/isTransientImportFailure.d.ts +7 -0
  104. package/dist/imports/isTransientImportFailure.d.ts.map +1 -0
  105. package/dist/imports/isTransientImportFailure.js +13 -0
  106. package/dist/imports/isTransientImportFailure.js.map +1 -0
  107. package/dist/imports/sizeOfImportEvent.d.ts +9 -0
  108. package/dist/imports/sizeOfImportEvent.d.ts.map +1 -0
  109. package/dist/imports/sizeOfImportEvent.js +25 -0
  110. package/dist/imports/sizeOfImportEvent.js.map +1 -0
  111. package/dist/imports/toImportEvent.d.ts +14 -0
  112. package/dist/imports/toImportEvent.d.ts.map +1 -0
  113. package/dist/imports/toImportEvent.js +54 -0
  114. package/dist/imports/toImportEvent.js.map +1 -0
  115. package/dist/imports/toImportProgress.d.ts +9 -0
  116. package/dist/imports/toImportProgress.d.ts.map +1 -0
  117. package/dist/imports/toImportProgress.js +20 -0
  118. package/dist/imports/toImportProgress.js.map +1 -0
  119. package/dist/imports/toImportResult.d.ts +9 -0
  120. package/dist/imports/toImportResult.d.ts.map +1 -0
  121. package/dist/imports/toImportResult.js +33 -0
  122. package/dist/imports/toImportResult.js.map +1 -0
  123. package/dist/index.d.ts +3 -1
  124. package/dist/index.d.ts.map +1 -1
  125. package/dist/index.js +3 -1
  126. package/dist/index.js.map +1 -1
  127. package/dist/observation/ObservationReconnectBackoff.d.ts +64 -0
  128. package/dist/observation/ObservationReconnectBackoff.d.ts.map +1 -0
  129. package/dist/observation/ObservationReconnectBackoff.js +75 -0
  130. package/dist/observation/ObservationReconnectBackoff.js.map +1 -0
  131. package/dist/observation/ObservationStreamOutcome.d.ts +10 -0
  132. package/dist/observation/ObservationStreamOutcome.d.ts.map +1 -0
  133. package/dist/observation/ObservationStreamOutcome.js +4 -0
  134. package/dist/observation/ObservationStreamOutcome.js.map +1 -0
  135. package/dist/observation/classifyStreamError.d.ts +25 -0
  136. package/dist/observation/classifyStreamError.d.ts.map +1 -0
  137. package/dist/observation/classifyStreamError.js +55 -0
  138. package/dist/observation/classifyStreamError.js.map +1 -0
  139. package/dist/observation/for_ObservationReconnectBackoff/given/a_backoff.d.ts +13 -0
  140. package/dist/observation/for_ObservationReconnectBackoff/given/a_backoff.d.ts.map +1 -0
  141. package/dist/observation/for_ObservationReconnectBackoff/given/a_backoff.js +25 -0
  142. package/dist/observation/for_ObservationReconnectBackoff/given/a_backoff.js.map +1 -0
  143. package/dist/observation/for_ObservationReconnectBackoff/given/a_scripted_stream.d.ts +27 -0
  144. package/dist/observation/for_ObservationReconnectBackoff/given/a_scripted_stream.d.ts.map +1 -0
  145. package/dist/observation/for_ObservationReconnectBackoff/given/a_scripted_stream.js +36 -0
  146. package/dist/observation/for_ObservationReconnectBackoff/given/a_scripted_stream.js.map +1 -0
  147. package/dist/observation/index.d.ts +2 -0
  148. package/dist/observation/index.d.ts.map +1 -1
  149. package/dist/observation/index.js +1 -0
  150. package/dist/observation/index.js.map +1 -1
  151. package/dist/reactors/Reactors.d.ts +15 -5
  152. package/dist/reactors/Reactors.d.ts.map +1 -1
  153. package/dist/reactors/Reactors.js +95 -18
  154. package/dist/reactors/Reactors.js.map +1 -1
  155. package/dist/reactors/for_Reactors/when_reconnecting_the_observation_stream/given/a_reactor_whose_stream_ends.d.ts +26 -0
  156. package/dist/reactors/for_Reactors/when_reconnecting_the_observation_stream/given/a_reactor_whose_stream_ends.d.ts.map +1 -0
  157. package/dist/reactors/for_Reactors/when_reconnecting_the_observation_stream/given/a_reactor_whose_stream_ends.js +64 -0
  158. package/dist/reactors/for_Reactors/when_reconnecting_the_observation_stream/given/a_reactor_whose_stream_ends.js.map +1 -0
  159. package/dist/reducers/Reducers.d.ts +11 -5
  160. package/dist/reducers/Reducers.d.ts.map +1 -1
  161. package/dist/reducers/Reducers.js +93 -19
  162. package/dist/reducers/Reducers.js.map +1 -1
  163. package/dist/reducers/for_Reducers/when_reconnecting_the_observation_stream/given/a_reducer_whose_stream_ends.d.ts +25 -0
  164. package/dist/reducers/for_Reducers/when_reconnecting_the_observation_stream/given/a_reducer_whose_stream_ends.d.ts.map +1 -0
  165. package/dist/reducers/for_Reducers/when_reconnecting_the_observation_stream/given/a_reducer_whose_stream_ends.js +70 -0
  166. package/dist/reducers/for_Reducers/when_reconnecting_the_observation_stream/given/a_reducer_whose_stream_ends.js.map +1 -0
  167. package/dist/testing/BatchPartitionOutcome.d.ts +7 -0
  168. package/dist/testing/BatchPartitionOutcome.d.ts.map +1 -0
  169. package/dist/testing/BatchPartitionOutcome.js +4 -0
  170. package/dist/testing/BatchPartitionOutcome.js.map +1 -0
  171. package/dist/testing/InProcessEventSequence.d.ts +4 -0
  172. package/dist/testing/InProcessEventSequence.d.ts.map +1 -1
  173. package/dist/testing/InProcessEventSequence.js +2 -0
  174. package/dist/testing/InProcessEventSequence.js.map +1 -1
  175. package/dist/testing/ReactorDeliveryResult.d.ts +2 -0
  176. package/dist/testing/ReactorDeliveryResult.d.ts.map +1 -1
  177. package/dist/testing/ReactorScenario.d.ts +46 -10
  178. package/dist/testing/ReactorScenario.d.ts.map +1 -1
  179. package/dist/testing/ReactorScenario.js +120 -29
  180. package/dist/testing/ReactorScenario.js.map +1 -1
  181. package/dist/testing/deliverToBatchMethods.d.ts +35 -0
  182. package/dist/testing/deliverToBatchMethods.d.ts.map +1 -0
  183. package/dist/testing/deliverToBatchMethods.js +55 -0
  184. package/dist/testing/deliverToBatchMethods.js.map +1 -0
  185. package/dist/tsconfig.tsbuildinfo +1 -1
  186. package/eventSequences/EventForEventSourceId.ts +25 -1
  187. package/eventSequences/EventSequence.ts +28 -0
  188. package/eventSequences/IEventSequence.ts +33 -0
  189. package/for_ChronicleClient/when_reconnecting/and_an_observation_stream_lost_its_session.spec.ts +212 -0
  190. package/imports/EventImport.ts +263 -0
  191. package/imports/EventImportSettings.ts +46 -0
  192. package/imports/IEventImport.ts +58 -0
  193. package/imports/ImportChunkRefused.ts +15 -0
  194. package/imports/ImportCouldNotBegin.ts +14 -0
  195. package/imports/ImportOptions.ts +36 -0
  196. package/imports/ImportProgress.ts +29 -0
  197. package/imports/ImportRejection.ts +14 -0
  198. package/imports/ImportResult.ts +43 -0
  199. package/imports/ImportState.ts +26 -0
  200. package/imports/ImportTarget.ts +23 -0
  201. package/imports/ImportWasAbandoned.ts +16 -0
  202. package/imports/ImportsNotSupported.ts +10 -0
  203. package/imports/OnInvalidEvent.ts +11 -0
  204. package/imports/abortable.ts +57 -0
  205. package/imports/beginEventImport.ts +85 -0
  206. package/imports/for_EventImport/given/a_kernel_import_session.ts +160 -0
  207. package/imports/for_EventImport/when_a_chunk_fails.spec.ts +65 -0
  208. package/imports/for_EventImport/when_abandoning.spec.ts +52 -0
  209. package/imports/for_EventImport/when_cancelling_with_an_abort_signal.spec.ts +59 -0
  210. package/imports/for_EventImport/when_completing.spec.ts +71 -0
  211. package/imports/for_EventImport/when_cutting_events_into_chunks.spec.ts +70 -0
  212. package/imports/for_EventImport/when_keeping_chunks_in_flight.spec.ts +49 -0
  213. package/imports/for_beginEventImport/when_reattaching.spec.ts +82 -0
  214. package/imports/for_beginEventImport/when_the_kernel_does_not_serve_imports.spec.ts +55 -0
  215. package/imports/for_importEvents/when_importing_in_one_call.spec.ts +99 -0
  216. package/imports/for_toImportEvent/when_converting_an_event.spec.ts +74 -0
  217. package/imports/importEvents.ts +44 -0
  218. package/imports/index.ts +14 -0
  219. package/imports/isTransientImportFailure.ts +15 -0
  220. package/imports/sizeOfImportEvent.ts +25 -0
  221. package/imports/toImportEvent.ts +60 -0
  222. package/imports/toImportProgress.ts +24 -0
  223. package/imports/toImportResult.ts +36 -0
  224. package/index.ts +3 -0
  225. package/observation/ObservationReconnectBackoff.ts +109 -0
  226. package/observation/ObservationStreamOutcome.ts +12 -0
  227. package/observation/classifyStreamError.ts +67 -0
  228. package/observation/for_ObservationReconnectBackoff/given/a_backoff.ts +29 -0
  229. package/observation/for_ObservationReconnectBackoff/given/a_scripted_stream.ts +52 -0
  230. package/observation/for_ObservationReconnectBackoff/when_a_stream_delivered_before_it_ended.spec.ts +23 -0
  231. package/observation/for_ObservationReconnectBackoff/when_a_stream_stayed_open_before_it_ended.spec.ts +25 -0
  232. package/observation/for_ObservationReconnectBackoff/when_jittering_the_delay.spec.ts +24 -0
  233. package/observation/for_ObservationReconnectBackoff/when_streams_keep_ending_without_working.spec.ts +24 -0
  234. package/observation/for_ObservationReconnectBackoff/when_the_base_delay_is_not_positive.spec.ts +18 -0
  235. package/observation/for_ObservationReconnectBackoff/when_the_settings_are_not_finite.spec.ts +32 -0
  236. package/observation/for_ObservationReconnectBackoff/when_using_the_defaults.spec.ts +29 -0
  237. package/observation/for_classifyStreamError/when_classifying_a_stream_error.spec.ts +36 -0
  238. package/observation/index.ts +2 -0
  239. package/package.json +7 -2
  240. package/projections/for_childrenOrderingSupport/when_detecting_support_in_the_pinned_contracts.spec.ts +1 -1
  241. package/reactors/Reactors.ts +101 -18
  242. package/reactors/for_Reactors/when_reconnecting_the_observation_stream/and_a_handler_failed_with_a_lost_session.spec.ts +32 -0
  243. package/reactors/for_Reactors/when_reconnecting_the_observation_stream/and_a_replaced_stream_fails_late.spec.ts +28 -0
  244. package/reactors/for_Reactors/when_reconnecting_the_observation_stream/and_a_stream_delivered_before_it_ended.spec.ts +24 -0
  245. package/reactors/for_Reactors/when_reconnecting_the_observation_stream/and_a_stream_stayed_open_before_it_ended.spec.ts +23 -0
  246. package/reactors/for_Reactors/when_reconnecting_the_observation_stream/and_it_is_disposed_while_waiting_to_reopen.spec.ts +27 -0
  247. package/reactors/for_Reactors/when_reconnecting_the_observation_stream/and_streams_keep_ending_without_working.spec.ts +24 -0
  248. package/reactors/for_Reactors/when_reconnecting_the_observation_stream/and_the_client_reconnected_after_streams_kept_ending.spec.ts +24 -0
  249. package/reactors/for_Reactors/when_reconnecting_the_observation_stream/and_the_client_reconnected_while_waiting_to_reopen.spec.ts +25 -0
  250. package/reactors/for_Reactors/when_reconnecting_the_observation_stream/and_the_kernel_lost_the_session.spec.ts +24 -0
  251. package/reactors/for_Reactors/when_reconnecting_the_observation_stream/given/a_reactor_whose_stream_ends.ts +69 -0
  252. package/reducers/Reducers.ts +99 -19
  253. package/reducers/for_Reducers/when_reconnecting_the_observation_stream/and_a_reducer_failed_with_a_lost_session.spec.ts +33 -0
  254. package/reducers/for_Reducers/when_reconnecting_the_observation_stream/and_a_replaced_stream_fails_late.spec.ts +28 -0
  255. package/reducers/for_Reducers/when_reconnecting_the_observation_stream/and_a_stream_delivered_before_it_ended.spec.ts +24 -0
  256. package/reducers/for_Reducers/when_reconnecting_the_observation_stream/and_a_stream_stayed_open_before_it_ended.spec.ts +23 -0
  257. package/reducers/for_Reducers/when_reconnecting_the_observation_stream/and_it_is_disposed_while_waiting_to_reopen.spec.ts +27 -0
  258. package/reducers/for_Reducers/when_reconnecting_the_observation_stream/and_streams_keep_ending_without_working.spec.ts +24 -0
  259. package/reducers/for_Reducers/when_reconnecting_the_observation_stream/and_the_client_reconnected_after_streams_kept_ending.spec.ts +24 -0
  260. package/reducers/for_Reducers/when_reconnecting_the_observation_stream/and_the_client_reconnected_while_waiting_to_reopen.spec.ts +25 -0
  261. package/reducers/for_Reducers/when_reconnecting_the_observation_stream/and_the_kernel_lost_the_session.spec.ts +24 -0
  262. package/reducers/for_Reducers/when_reconnecting_the_observation_stream/given/a_reducer_whose_stream_ends.ts +69 -0
  263. package/testing/BatchPartitionOutcome.ts +10 -0
  264. package/testing/InProcessEventSequence.ts +4 -0
  265. package/testing/ReactorDeliveryResult.ts +2 -0
  266. package/testing/ReactorScenario.ts +147 -39
  267. package/testing/deliverToBatchMethods.ts +90 -0
  268. package/testing/for_ReactorScenario/when_the_reactor_has_a_batch_method.spec.ts +143 -9
@@ -0,0 +1,71 @@
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 { ImportState as ContractsImportState } from '@cratis/chronicle.contracts';
5
+ import { beforeEach, chai, describe, it } from 'vitest';
6
+ import type { ImportResult } from '../ImportResult.js';
7
+ import { ImportState } from '../ImportState.js';
8
+ import { a_kernel_import_session, numberedEvents } from './given/a_kernel_import_session.js';
9
+
10
+ chai.should();
11
+
12
+ describe('when completing an import that commits', () => {
13
+ let kernel: a_kernel_import_session;
14
+ let result: ImportResult;
15
+ beforeEach(async () => {
16
+ kernel = new a_kernel_import_session();
17
+ kernel.reads = [
18
+ { State: ContractsImportState.Validating },
19
+ { State: ContractsImportState.Committing, EventsStaged: 3n, EventsCommitted: 1n },
20
+ { State: ContractsImportState.Completed, EventsStaged: 3n, EventsCommitted: 3n, FirstSequenceNumber: 10n, LastSequenceNumber: 12n }
21
+ ];
22
+ const session = kernel.session();
23
+ await session.add(numberedEvents(3));
24
+ result = await session.complete();
25
+ });
26
+
27
+ it('should wait until the commit is done', () => kernel.readCount.should.equal(3));
28
+ it('should be a success', () => result.isSuccess.should.be.true);
29
+ it('should report the events committed', () => result.eventsCommitted.should.equal(3));
30
+ it('should report the first sequence number', () => result.firstSequenceNumber!.value.should.equal(10n));
31
+ it('should report the last sequence number', () => result.lastSequenceNumber!.value.should.equal(12n));
32
+ it('should carry the identifier of the import', () => result.importId.toString().should.equal(kernel.importId.toString()));
33
+ });
34
+
35
+ describe('when completing an import with invalid events', () => {
36
+ let result: ImportResult;
37
+ beforeEach(async () => {
38
+ const kernel = new a_kernel_import_session();
39
+ kernel.reads = [{
40
+ State: ContractsImportState.Failed, EventsStaged: 2n, RejectedCount: 1n, FailureReason: 'One event was rejected',
41
+ Rejections: [{ Index: 1n, EventType: 'numbered', Reasons: ['number must be positive'] }]
42
+ }];
43
+ const session = kernel.session();
44
+ await session.add(numberedEvents(2));
45
+ result = await session.complete();
46
+ });
47
+
48
+ it('should not be a success', () => result.isSuccess.should.be.false);
49
+ it('should be failed', () => result.state.should.equal(ImportState.Failed));
50
+ it('should commit nothing', () => result.eventsCommitted.should.equal(0));
51
+ it('should report no sequence numbers', () => (result.firstSequenceNumber === undefined).should.be.true);
52
+ it('should report the rejected event by its index', () =>
53
+ result.rejections.should.deep.equal([{ index: 1, eventType: 'numbered', reasons: ['number must be positive'] }]));
54
+ it('should report how many were rejected', () => result.rejectedCount.should.equal(1));
55
+ it('should report why it failed', () => result.failureReason!.should.equal('One event was rejected'));
56
+ });
57
+
58
+ describe('when completing an import without waiting for the commit', () => {
59
+ let kernel: a_kernel_import_session;
60
+ let result: ImportResult;
61
+ beforeEach(async () => {
62
+ kernel = new a_kernel_import_session();
63
+ kernel.reads = [{ State: ContractsImportState.Committing }, { State: ContractsImportState.Completed }];
64
+ const session = kernel.session({ options: { waitForCommit: false } });
65
+ await session.add(numberedEvents(1));
66
+ result = await session.complete();
67
+ });
68
+
69
+ it('should read the import once', () => kernel.readCount.should.equal(1));
70
+ it('should report the state it read', () => result.state.should.equal(ImportState.Committing));
71
+ });
@@ -0,0 +1,70 @@
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 { beforeEach, chai, describe, it } from 'vitest';
5
+ import { sizeOfImportEvent } from '../sizeOfImportEvent.js';
6
+ import { a_kernel_import_session, contentsOf, numberedEvents, wireEventFor } from './given/a_kernel_import_session.js';
7
+
8
+ chai.should();
9
+
10
+ describe('when cutting events into chunks within the kernel event limit', () => {
11
+ let kernel: a_kernel_import_session;
12
+ beforeEach(async () => {
13
+ kernel = new a_kernel_import_session();
14
+ const session = kernel.session({ maxChunkEvents: 3 });
15
+ await session.add(numberedEvents(10));
16
+ await session.complete();
17
+ });
18
+
19
+ it('should send chunks of at most the limit', () => kernel.chunks.map(chunk => chunk.contents.length).sort().should.deep.equal([1, 3, 3, 3]));
20
+ it('should number the chunks in order', () => kernel.chunks.map(chunk => chunk.chunkIndex).sort().should.deep.equal([0, 1, 2, 3]));
21
+ it('should give each chunk the index of its first event', () =>
22
+ [...kernel.chunks].sort((left, right) => left.chunkIndex - right.chunkIndex).map(chunk => chunk.firstEventIndex)
23
+ .should.deep.equal([0n, 3n, 6n, 9n]));
24
+ it('should send every event once, in order', () => kernel.receivedContents.should.deep.equal(contentsOf(10)));
25
+ it('should complete with the chunks and events it sent', () =>
26
+ kernel.completions.should.deep.equal([{ ExpectedChunks: 4, ExpectedEvents: 10n }]));
27
+ });
28
+
29
+ describe('when cutting events into chunks within the kernel byte limit', () => {
30
+ let kernel: a_kernel_import_session;
31
+ let limit: number;
32
+ beforeEach(async () => {
33
+ kernel = new a_kernel_import_session();
34
+ limit = sizeOfImportEvent(wireEventFor(numberedEvents(1)[0])) * 2;
35
+ const session = kernel.session({ maxChunkBytes: limit });
36
+ await session.add(numberedEvents(5));
37
+ await session.complete();
38
+ });
39
+
40
+ it('should keep each chunk within the limit', () =>
41
+ kernel.chunks.every(chunk => chunk.contents.reduce((bytes, content) => bytes + Buffer.byteLength(content), 0) <= limit).should.be.true);
42
+ it('should send every event once, in order', () => kernel.receivedContents.should.deep.equal(contentsOf(5)));
43
+ });
44
+
45
+ describe('when cutting events into chunks with a client limit below the kernel limit', () => {
46
+ let kernel: a_kernel_import_session;
47
+ beforeEach(async () => {
48
+ kernel = new a_kernel_import_session();
49
+ const session = kernel.session({ maxChunkEvents: 100, options: { maxEventsPerChunk: 2 } });
50
+ await session.add(numberedEvents(5));
51
+ await session.complete();
52
+ });
53
+
54
+ it('should use the lower limit', () => kernel.chunks.map(chunk => chunk.contents.length).sort().should.deep.equal([1, 2, 2]));
55
+ });
56
+
57
+ describe('when adding events in several calls', () => {
58
+ let kernel: a_kernel_import_session;
59
+ beforeEach(async () => {
60
+ kernel = new a_kernel_import_session();
61
+ const session = kernel.session({ maxChunkEvents: 4 });
62
+ const events = numberedEvents(6);
63
+ await session.add(events.slice(0, 3));
64
+ await session.add((async function* () { yield* events.slice(3); })());
65
+ await session.complete();
66
+ });
67
+
68
+ it('should fill chunks across the calls', () => kernel.chunks.map(chunk => chunk.contents.length).sort().should.deep.equal([2, 4]));
69
+ it('should send every event once, in order', () => kernel.receivedContents.should.deep.equal(contentsOf(6)));
70
+ });
@@ -0,0 +1,49 @@
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 { beforeEach, chai, describe, it } from 'vitest';
5
+ import type { EventForEventSourceId } from '../../eventSequences/EventForEventSourceId.js';
6
+ import { a_kernel_import_session, contentsOf, gate, numbered } from './given/a_kernel_import_session.js';
7
+
8
+ chai.should();
9
+
10
+ describe('when keeping chunks in flight', () => {
11
+ let kernel: a_kernel_import_session;
12
+ let readWhileHeld: number;
13
+ beforeEach(async () => {
14
+ kernel = new a_kernel_import_session();
15
+ const held = gate();
16
+ kernel.answerChunk = async () => { await held.promise; return { Error: '' }; };
17
+ let read = 0;
18
+ async function* source(): AsyncGenerator<EventForEventSourceId> {
19
+ for (let index = 0; index < 40; index++) {
20
+ read++;
21
+ yield numbered(index);
22
+ }
23
+ }
24
+ const session = kernel.session({ maxChunkEvents: 2 });
25
+ const adding = session.add(source());
26
+ await new Promise(resolve => setTimeout(resolve, 20));
27
+ readWhileHeld = read;
28
+ held.open();
29
+ await adding;
30
+ await session.complete();
31
+ });
32
+
33
+ it('should have at most four chunks in flight', () => kernel.maxInFlight.should.equal(4));
34
+ it('should stop reading the source while the kernel holds the chunks', () => readWhileHeld.should.be.at.most(4 * 2 + 3));
35
+ it('should send every event once, in order', () => kernel.receivedContents.should.deep.equal(contentsOf(40)));
36
+ });
37
+
38
+ describe('when keeping chunks in flight with a configured bound', () => {
39
+ let kernel: a_kernel_import_session;
40
+ beforeEach(async () => {
41
+ kernel = new a_kernel_import_session();
42
+ kernel.answerChunk = async () => { await new Promise(resolve => setTimeout(resolve, 1)); return { Error: '' }; };
43
+ const session = kernel.session({ maxChunkEvents: 1, options: { maxChunksInFlight: 2 } });
44
+ await session.add(Array.from({ length: 12 }, (_, index) => numbered(index)));
45
+ await session.complete();
46
+ });
47
+
48
+ it('should have at most the configured number in flight', () => kernel.maxInFlight.should.equal(2));
49
+ });
@@ -0,0 +1,82 @@
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 { beforeEach, chai, describe, it } from 'vitest';
5
+ import { beginEventImport } from '../beginEventImport.js';
6
+ import type { IEventImport } from '../IEventImport.js';
7
+ import { ImportCouldNotBegin } from '../ImportCouldNotBegin.js';
8
+ import { OnInvalidEvent } from '../OnInvalidEvent.js';
9
+ import { a_kernel_import_session, numberedEvents } from '../for_EventImport/given/a_kernel_import_session.js';
10
+
11
+ chai.should();
12
+
13
+ describe('when reattaching to an import the kernel holds chunks for', () => {
14
+ let kernel: a_kernel_import_session;
15
+ let session: IEventImport;
16
+ beforeEach(async () => {
17
+ kernel = new a_kernel_import_session();
18
+ kernel.reads = [
19
+ { EventSequenceId: 'event-log', OnInvalid: 1, MaxChunkEvents: 3, AcknowledgedChunks: 2, AcknowledgedEvents: 6n },
20
+ { State: 4 }
21
+ ];
22
+ session = await beginEventImport({ imports: kernel.client, eventStore: 'store', namespace: 'default', eventSequenceId: 'event-log' },
23
+ kernel.importId.toString());
24
+ await session.add(numberedEvents(10).slice(session.eventsAcknowledged));
25
+ await session.complete();
26
+ });
27
+
28
+ it('should keep the identifier of the import', () => session.importId.toString().should.equal(kernel.importId.toString()));
29
+ it('should say how many events the kernel already holds', () => session.eventsAcknowledged.should.equal(6));
30
+ it('should continue numbering chunks after the acknowledged ones', () =>
31
+ kernel.chunks.map(chunk => chunk.chunkIndex).sort().should.deep.equal([2, 3]));
32
+ it('should continue numbering events after the acknowledged ones', () =>
33
+ [...kernel.chunks].sort((left, right) => left.chunkIndex - right.chunkIndex).map(chunk => chunk.firstEventIndex)
34
+ .should.deep.equal([6n, 9n]));
35
+ it('should complete with every chunk and event of the import', () =>
36
+ kernel.completions.should.deep.equal([{ ExpectedChunks: 4, ExpectedEvents: 10n }]));
37
+ });
38
+
39
+ describe('when reattaching to an import into another event sequence', () => {
40
+ let error: unknown;
41
+ beforeEach(async () => {
42
+ const kernel = new a_kernel_import_session();
43
+ kernel.reads = [{ EventSequenceId: 'outbox' }];
44
+ error = await beginEventImport({ imports: kernel.client, eventStore: 'store', namespace: 'default', eventSequenceId: 'event-log' },
45
+ kernel.importId).catch(caught => caught);
46
+ });
47
+
48
+ it('should refuse to reattach', () => error.should.be.instanceOf(ImportCouldNotBegin));
49
+ });
50
+
51
+ describe('when reattaching to an import that does not exist', () => {
52
+ let error: unknown;
53
+ beforeEach(async () => {
54
+ const kernel = new a_kernel_import_session();
55
+ kernel.imports.getImport = async () => ({ IsAuthorized: true, ValidationResults: [], ExceptionMessages: [], ExceptionStackTrace: '',
56
+ CorrelationId: undefined, Data: undefined as never });
57
+ error = await beginEventImport({ imports: kernel.client, eventStore: 'store', namespace: 'default', eventSequenceId: 'event-log' },
58
+ kernel.importId).catch(caught => caught);
59
+ });
60
+
61
+ it('should refuse to reattach', () => error.should.be.instanceOf(ImportCouldNotBegin));
62
+ });
63
+
64
+ describe('when beginning a new import', () => {
65
+ let request: Record<string, unknown>;
66
+ let session: IEventImport;
67
+ beforeEach(async () => {
68
+ const kernel = new a_kernel_import_session();
69
+ const imports = { ...kernel.imports, beginImport: async (given: Record<string, unknown>) => {
70
+ request = given;
71
+ return { IsAuthorized: true, ValidationResults: [], ExceptionMessages: [], ExceptionStackTrace: '', AuthorizationFailureReason: '',
72
+ CorrelationId: undefined, Response: { ImportId: given.ImportId, State: 0, MaxChunkEvents: 2, MaxChunkBytes: 0, Error: '' } };
73
+ } };
74
+ session = await beginEventImport({ imports: imports as never, eventStore: 'store', namespace: 'default', eventSequenceId: 'event-log' },
75
+ { onInvalid: OnInvalidEvent.Skip, importId: kernel.importId });
76
+ });
77
+
78
+ it('should begin it for the event sequence', () => request.EventSequenceId!.should.equal('event-log'));
79
+ it('should pass what to do with invalid events', () => request.OnInvalid!.should.equal(1));
80
+ it('should use the identifier the kernel gives back', () => session.importId.toString().length.should.equal(36));
81
+ it('should start from the beginning', () => session.eventsAcknowledged.should.equal(0));
82
+ });
@@ -0,0 +1,55 @@
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 { ClientError, Status } from 'nice-grpc-common';
5
+ import { beforeEach, chai, describe, it } from 'vitest';
6
+ import { beginEventImport } from '../beginEventImport.js';
7
+ import { ImportCouldNotBegin } from '../ImportCouldNotBegin.js';
8
+ import { ImportsNotSupported } from '../ImportsNotSupported.js';
9
+ import { a_kernel_import_session } from '../for_EventImport/given/a_kernel_import_session.js';
10
+
11
+ chai.should();
12
+
13
+ describe('when beginning an import on a kernel that does not serve imports', () => {
14
+ let error: unknown;
15
+ beforeEach(async () => {
16
+ const kernel = new a_kernel_import_session();
17
+ const imports = { ...kernel.imports, beginImport: async () => { throw new ClientError('/Imports/BeginImport', Status.UNIMPLEMENTED, ''); } };
18
+ error = await beginEventImport({ imports: imports as never, eventStore: 'store', namespace: 'default', eventSequenceId: 'event-log' })
19
+ .catch(caught => caught);
20
+ });
21
+
22
+ it('should say imports are not supported', () => error.should.be.instanceOf(ImportsNotSupported));
23
+ });
24
+
25
+ describe('when the kernel refuses to begin an import', () => {
26
+ let error: unknown;
27
+ beforeEach(async () => {
28
+ const kernel = new a_kernel_import_session();
29
+ const imports = { ...kernel.imports, beginImport: async () => ({ IsAuthorized: true, ValidationResults: [], ExceptionMessages: [],
30
+ ExceptionStackTrace: '', AuthorizationFailureReason: '', CorrelationId: undefined,
31
+ Response: { ImportId: undefined, State: 0, MaxChunkEvents: 0, MaxChunkBytes: 0, Error: 'Imports into the outbox are not supported' } }) };
32
+ error = await beginEventImport({ imports: imports as never, eventStore: 'store', namespace: 'default', eventSequenceId: 'outbox' })
33
+ .catch(caught => caught);
34
+ });
35
+
36
+ it('should say it could not begin', () => error.should.be.instanceOf(ImportCouldNotBegin));
37
+ it('should carry the reason', () => (error as ImportCouldNotBegin).reason.should.equal('Imports into the outbox are not supported'));
38
+ });
39
+
40
+ describe('when beginning an import with a signal that already aborted', () => {
41
+ let error: unknown;
42
+ let called: boolean;
43
+ beforeEach(async () => {
44
+ const kernel = new a_kernel_import_session();
45
+ called = false;
46
+ const imports = { ...kernel.imports, beginImport: async () => { called = true; throw new Error('should not be called'); } };
47
+ const controller = new AbortController();
48
+ controller.abort(new Error('cancelled before it began'));
49
+ error = await beginEventImport({ imports: imports as never, eventStore: 'store', namespace: 'default', eventSequenceId: 'event-log' },
50
+ { signal: controller.signal }).catch(caught => caught);
51
+ });
52
+
53
+ it('should not call the kernel', () => called.should.be.false);
54
+ it('should stop with the reason', () => (error as Error).message.should.equal('cancelled before it began'));
55
+ });
@@ -0,0 +1,99 @@
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 { ImportState as ContractsImportState } from '@cratis/chronicle.contracts';
5
+ import { field } from '@cratis/fundamentals';
6
+ import { beforeEach, chai, describe, it } from 'vitest';
7
+ import { eventType } from '../../events/eventTypeDecorator.js';
8
+ import type { EventForEventSourceId } from '../../eventSequences/EventForEventSourceId.js';
9
+ import { importEvents } from '../importEvents.js';
10
+ import type { ImportProgress } from '../ImportProgress.js';
11
+ import type { ImportResult } from '../ImportResult.js';
12
+ import { ImportState } from '../ImportState.js';
13
+ import type { ImportTarget } from '../ImportTarget.js';
14
+ import { a_kernel_import_session } from '../for_EventImport/given/a_kernel_import_session.js';
15
+
16
+ chai.should();
17
+
18
+ @eventType('import-spec-item-counted')
19
+ class ItemCounted {
20
+ @field(Number) number: number;
21
+ constructor(number = 0) { this.number = number; }
22
+ }
23
+
24
+ const numbered = (number: number): EventForEventSourceId => ({ eventSourceId: 'source', event: new ItemCounted(number) });
25
+ const range = (count: number) => Array.from({ length: count }, (_, index) => index);
26
+ const numbersReceivedBy = (kernel: a_kernel_import_session) => kernel.receivedContents.map(content => (JSON.parse(content) as ItemCounted).number);
27
+
28
+ function targetFor(kernel: a_kernel_import_session): ImportTarget {
29
+ return { imports: kernel.client, eventStore: 'store', namespace: 'default', eventSequenceId: 'event-log' };
30
+ }
31
+
32
+ describe('when importing events from an async iterable in one call', () => {
33
+ let kernel: a_kernel_import_session;
34
+ let result: ImportResult;
35
+ let progress: ImportProgress[];
36
+ beforeEach(async () => {
37
+ kernel = new a_kernel_import_session();
38
+ kernel.limits = { MaxChunkEvents: 5, MaxChunkBytes: 0 };
39
+ kernel.observed = [
40
+ { State: ContractsImportState.Staging, EventsReceived: 5n, EventsStaged: 5n },
41
+ { State: ContractsImportState.Committing, EventsReceived: 12n, EventsStaged: 12n, EventsCommitted: 4n, RejectedCount: 0n }
42
+ ];
43
+ kernel.reads = [{ State: ContractsImportState.Completed, EventsStaged: 12n, EventsCommitted: 12n, FirstSequenceNumber: 0n, LastSequenceNumber: 11n }];
44
+ progress = [];
45
+ async function* source(): AsyncGenerator<EventForEventSourceId> {
46
+ for (let index = 0; index < 12; index++) yield numbered(index);
47
+ }
48
+ result = await importEvents(targetFor(kernel), source(), { onProgress: report => progress.push(report) });
49
+ });
50
+
51
+ it('should send every event once, in order', () => numbersReceivedBy(kernel).should.deep.equal(range(12)));
52
+ it('should cut chunks within the kernel limit', () => kernel.chunks.length.should.equal(3));
53
+ it('should complete the import', () => kernel.completions.should.deep.equal([{ ExpectedChunks: 3, ExpectedEvents: 12n }]));
54
+ it('should report the result', () => result.isSuccess.should.be.true);
55
+ it('should report the committed range', () => result.lastSequenceNumber!.value.should.equal(11n));
56
+ it('should report progress as the kernel reports it', () => progress.map(report => report.state)
57
+ .should.deep.equal([ImportState.Staging, ImportState.Committing]));
58
+ it('should report the counts of the progress', () => progress[1].eventsCommitted.should.equal(4));
59
+ });
60
+
61
+ describe('when importing events from an iterable in one call', () => {
62
+ let kernel: a_kernel_import_session;
63
+ let result: ImportResult;
64
+ beforeEach(async () => {
65
+ kernel = new a_kernel_import_session();
66
+ function* source(): Generator<EventForEventSourceId> {
67
+ for (let index = 0; index < 3; index++) yield numbered(index);
68
+ }
69
+ result = await importEvents(targetFor(kernel), source());
70
+ });
71
+
72
+ it('should send every event', () => numbersReceivedBy(kernel).should.deep.equal(range(3)));
73
+ it('should report the result', () => result.isSuccess.should.be.true);
74
+ });
75
+
76
+ describe('when cancelling an import in one call with an abort signal', () => {
77
+ let kernel: a_kernel_import_session;
78
+ let error: unknown;
79
+ let reason: Error;
80
+ beforeEach(async () => {
81
+ kernel = new a_kernel_import_session();
82
+ kernel.limits = { MaxChunkEvents: 1, MaxChunkBytes: 0 };
83
+ const controller = new AbortController();
84
+ reason = new Error('cancelled by the caller');
85
+ async function* source(): AsyncGenerator<EventForEventSourceId> {
86
+ yield numbered(0);
87
+ yield numbered(1);
88
+ controller.abort(reason);
89
+ yield numbered(2);
90
+ yield numbered(3);
91
+ }
92
+ error = await importEvents(targetFor(kernel), source(), { signal: controller.signal }).catch(caught => caught);
93
+ });
94
+
95
+ it('should stop with the reason it was cancelled for', () => error!.should.equal(reason));
96
+ it('should not complete the import', () => kernel.completions.should.be.empty);
97
+ it('should stop reading the source', () => kernel.receivedContents.length.should.be.at.most(2));
98
+ it('should leave the import open on the kernel to be reattached', () => kernel.abandons.should.be.empty);
99
+ });
@@ -0,0 +1,74 @@
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 { field, Guid } from '@cratis/fundamentals';
5
+ import type { ImportEvent } from '@cratis/chronicle.contracts';
6
+ import { beforeEach, chai, describe, it } from 'vitest';
7
+ import { fromContractsGuid } from '../../connection/Guid.js';
8
+ import { eventType } from '../../events/eventTypeDecorator.js';
9
+ import { NamedTag } from '../../events/NamedTag.js';
10
+ import { tag } from '../../events/tagDecorator.js';
11
+ import { Identity } from '../../identity/Identity.js';
12
+ import { toImportEvent } from '../toImportEvent.js';
13
+
14
+ chai.should();
15
+
16
+ @eventType('import-spec-customer-registered', 2)
17
+ @tag('migrated')
18
+ class CustomerRegistered {
19
+ @field(String) name: string;
20
+ constructor(name = '') { this.name = name; }
21
+ }
22
+
23
+ describe('when converting an event that carries what its source said', () => {
24
+ const correlationId = Guid.create();
25
+ const occurred = new Date('2019-05-06T07:08:09.000Z');
26
+ let converted: ImportEvent;
27
+ beforeEach(() => {
28
+ converted = toImportEvent({
29
+ eventSourceId: 'customer-1',
30
+ event: new CustomerRegistered('Jane'),
31
+ eventStreamType: 'Onboarding',
32
+ eventStreamId: 'web',
33
+ eventSourceType: 'Customer',
34
+ occurred,
35
+ subject: 'person-1',
36
+ tags: ['legacy'],
37
+ namedTags: [new NamedTag('region', 'north')],
38
+ correlationId,
39
+ causedBy: new Identity('user-1', 'Jane Doe', 'jane', new Identity('system', 'Migrator')),
40
+ generation: 1,
41
+ sourceSequenceNumber: 41
42
+ });
43
+ });
44
+
45
+ it('should keep the event source', () => converted.EventSourceId.should.equal('customer-1'));
46
+ it('should keep the route', () => [converted.EventSourceType, converted.EventStreamType, converted.EventStreamId]
47
+ .should.deep.equal(['Customer', 'Onboarding', 'web']));
48
+ it('should keep the event type', () => converted.EventType!.Id.should.equal('import-spec-customer-registered'));
49
+ it('should keep the generation the event was written in', () => converted.EventType!.Generation.should.equal(1));
50
+ it('should carry the content', () => JSON.parse(converted.Content).name.should.equal('Jane'));
51
+ it('should keep when it occurred', () => converted.Occurred!.Value.should.equal(occurred.toISOString()));
52
+ it('should keep the subject', () => converted.Subject.should.equal('person-1'));
53
+ it('should combine its tags with the tags of its type', () => converted.Tags.should.have.members(['migrated', 'legacy']));
54
+ it('should keep the named tags', () => converted.NamedTags.should.deep.equal([{ Name: 'region', Value: 'north' }]));
55
+ it('should keep the correlation', () => fromContractsGuid(converted.CorrelationId).toString().should.equal(correlationId.toString()));
56
+ it('should keep who caused it', () => converted.CausedBy!.Subject.should.equal('user-1'));
57
+ it('should keep who it was caused on behalf of', () => converted.CausedBy!.OnBehalfOf!.Subject.should.equal('system'));
58
+ it('should keep the sequence number it had in its source', () => converted.SourceSequenceNumber.should.equal(41n));
59
+ });
60
+
61
+ describe('when converting an event that says nothing about its source', () => {
62
+ let converted: ImportEvent;
63
+ beforeEach(() => {
64
+ converted = toImportEvent({ eventSourceId: 'customer-2', event: new CustomerRegistered('John') });
65
+ });
66
+
67
+ it('should use the generation its type is registered with', () => converted.EventType!.Generation.should.equal(2));
68
+ it('should leave the occurrence time to the kernel', () => (converted.Occurred === undefined).should.be.true);
69
+ it('should leave the correlation to the kernel', () => (converted.CorrelationId === undefined).should.be.true);
70
+ it('should leave who caused it to the kernel', () => (converted.CausedBy === undefined).should.be.true);
71
+ it('should carry no source sequence number', () => converted.SourceSequenceNumber.should.equal(0n));
72
+ it('should leave the route to the kernel', () => [converted.EventSourceType, converted.EventStreamType, converted.EventStreamId]
73
+ .should.deep.equal(['', '', '']));
74
+ });
@@ -0,0 +1,44 @@
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 { EventForEventSourceId } from '../eventSequences/EventForEventSourceId.js';
5
+ import { beginEventImport } from './beginEventImport.js';
6
+ import type { IEventImport } from './IEventImport.js';
7
+ import type { ImportOptions } from './ImportOptions.js';
8
+ import type { ImportProgress } from './ImportProgress.js';
9
+ import type { ImportResult } from './ImportResult.js';
10
+ import type { ImportTarget } from './ImportTarget.js';
11
+
12
+ /**
13
+ * Imports events in one call: begins an import, adds the events as they are read, and completes it.
14
+ * @param target - The {@link ImportTarget}.
15
+ * @param events - The events, in the order they are to be committed. They are read lazily, as they are uploaded.
16
+ * @param options - The {@link ImportOptions}.
17
+ * @returns The {@link ImportResult}.
18
+ */
19
+ export async function importEvents(
20
+ target: ImportTarget,
21
+ events: AsyncIterable<EventForEventSourceId> | Iterable<EventForEventSourceId>,
22
+ options?: ImportOptions
23
+ ): Promise<ImportResult> {
24
+ const session = await beginEventImport(target, options);
25
+ const reporting = options?.onProgress ? report(session, options.onProgress) : undefined;
26
+ try {
27
+ await session.add(events, options?.signal);
28
+ return await session.complete(options?.signal);
29
+ } finally {
30
+ reporting?.abort();
31
+ }
32
+ }
33
+
34
+ function report(session: IEventImport, onProgress: (progress: ImportProgress) => void): AbortController {
35
+ const controller = new AbortController();
36
+ void (async () => {
37
+ try {
38
+ for await (const progress of session.progress(controller.signal)) onProgress(progress);
39
+ } catch {
40
+ // Progress is informational: a failed observation never fails the import.
41
+ }
42
+ })();
43
+ return controller;
44
+ }
@@ -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
+ export type { IEventImport } from './IEventImport.js';
5
+ export { ImportChunkRefused } from './ImportChunkRefused.js';
6
+ export { ImportCouldNotBegin } from './ImportCouldNotBegin.js';
7
+ export type { ImportOptions } from './ImportOptions.js';
8
+ export type { ImportProgress } from './ImportProgress.js';
9
+ export type { ImportRejection } from './ImportRejection.js';
10
+ export type { ImportResult } from './ImportResult.js';
11
+ export { ImportState } from './ImportState.js';
12
+ export { ImportWasAbandoned } from './ImportWasAbandoned.js';
13
+ export { ImportsNotSupported } from './ImportsNotSupported.js';
14
+ export { OnInvalidEvent } from './OnInvalidEvent.js';
@@ -0,0 +1,15 @@
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 { ClientError, Status } from 'nice-grpc-common';
5
+
6
+ const transientStatuses = new Set<Status>([Status.UNAVAILABLE, Status.DEADLINE_EXCEEDED, Status.RESOURCE_EXHAUSTED, Status.ABORTED, Status.INTERNAL]);
7
+
8
+ /**
9
+ * Determines whether a failed call is worth sending again: the connection failed rather than the kernel refusing it.
10
+ * @param error - What the call failed with.
11
+ * @returns True when the call can be sent again.
12
+ */
13
+ export function isTransientImportFailure(error: unknown): boolean {
14
+ return error instanceof ClientError && transientStatuses.has(error.code);
15
+ }
@@ -0,0 +1,25 @@
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 { ImportEvent } from '@cratis/chronicle.contracts';
5
+
6
+ /**
7
+ * Measures an event as the kernel counts it against its chunk byte limit: the content, tags, named tags, causation
8
+ * and idempotency key, as UTF-8.
9
+ * @param event - The {@link ImportEvent} in its wire form.
10
+ * @returns The bytes it carries.
11
+ */
12
+ export function sizeOfImportEvent(event: ImportEvent): number {
13
+ let bytes = utf8(event.Content) + utf8(event.IdempotencyKey);
14
+ for (const tag of event.Tags) bytes += utf8(tag);
15
+ for (const tag of event.NamedTags) bytes += utf8(tag.Name) + utf8(tag.Value);
16
+ for (const causation of event.Causation) {
17
+ bytes += utf8(causation.Type);
18
+ for (const [name, value] of Object.entries(causation.Properties)) bytes += utf8(name) + utf8(value);
19
+ }
20
+ return bytes;
21
+ }
22
+
23
+ function utf8(value: string | undefined): number {
24
+ return value ? Buffer.byteLength(value, 'utf8') : 0;
25
+ }