@cratis/chronicle 6.71.2 → 6.72.1

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 (131) hide show
  1. package/dist/reactors/AsyncQueue.d.ts +10 -0
  2. package/dist/reactors/AsyncQueue.d.ts.map +1 -0
  3. package/dist/reactors/AsyncQueue.js +42 -0
  4. package/dist/reactors/AsyncQueue.js.map +1 -0
  5. package/dist/reactors/IReactorBuilder.d.ts +12 -0
  6. package/dist/reactors/IReactorBuilder.d.ts.map +1 -0
  7. package/dist/reactors/IReactorBuilder.js +4 -0
  8. package/dist/reactors/IReactorBuilder.js.map +1 -0
  9. package/dist/reactors/IReactorDefinition.d.ts +14 -0
  10. package/dist/reactors/IReactorDefinition.d.ts.map +1 -0
  11. package/dist/reactors/IReactorDefinition.js +4 -0
  12. package/dist/reactors/IReactorDefinition.js.map +1 -0
  13. package/dist/reactors/IReactorDefinitionBuilder.d.ts +9 -0
  14. package/dist/reactors/IReactorDefinitionBuilder.d.ts.map +1 -0
  15. package/dist/reactors/IReactorDefinitionBuilder.js +4 -0
  16. package/dist/reactors/IReactorDefinitionBuilder.js.map +1 -0
  17. package/dist/reactors/IReactors.d.ts +21 -10
  18. package/dist/reactors/IReactors.d.ts.map +1 -1
  19. package/dist/reactors/ReactorBuilder.d.ts +32 -0
  20. package/dist/reactors/ReactorBuilder.d.ts.map +1 -0
  21. package/dist/reactors/ReactorBuilder.js +91 -0
  22. package/dist/reactors/ReactorBuilder.js.map +1 -0
  23. package/dist/reactors/ReactorCallback.d.ts +4 -0
  24. package/dist/reactors/ReactorCallback.d.ts.map +1 -0
  25. package/dist/reactors/ReactorCallback.js +4 -0
  26. package/dist/reactors/ReactorCallback.js.map +1 -0
  27. package/dist/reactors/ReactorEvent.d.ts +7 -0
  28. package/dist/reactors/ReactorEvent.d.ts.map +1 -0
  29. package/dist/reactors/ReactorEvent.js +4 -0
  30. package/dist/reactors/ReactorEvent.js.map +1 -0
  31. package/dist/reactors/ReactorObservation.d.ts +21 -0
  32. package/dist/reactors/ReactorObservation.d.ts.map +1 -0
  33. package/dist/reactors/ReactorObservation.js +43 -0
  34. package/dist/reactors/ReactorObservation.js.map +1 -0
  35. package/dist/reactors/ReactorObservationTarget.d.ts +4 -1
  36. package/dist/reactors/ReactorObservationTarget.d.ts.map +1 -1
  37. package/dist/reactors/ReactorPageDispatcher.d.ts +6 -0
  38. package/dist/reactors/ReactorPageDispatcher.d.ts.map +1 -1
  39. package/dist/reactors/ReactorPageDispatcher.js +96 -51
  40. package/dist/reactors/ReactorPageDispatcher.js.map +1 -1
  41. package/dist/reactors/ReactorRegistration.d.ts +14 -0
  42. package/dist/reactors/ReactorRegistration.d.ts.map +1 -0
  43. package/dist/reactors/ReactorRegistration.js +4 -0
  44. package/dist/reactors/ReactorRegistration.js.map +1 -0
  45. package/dist/reactors/ReactorRegistrationKind.d.ts +7 -0
  46. package/dist/reactors/ReactorRegistrationKind.d.ts.map +1 -0
  47. package/dist/reactors/ReactorRegistrationKind.js +10 -0
  48. package/dist/reactors/ReactorRegistrationKind.js.map +1 -0
  49. package/dist/reactors/ReactorRegistrations.d.ts +17 -0
  50. package/dist/reactors/ReactorRegistrations.d.ts.map +1 -0
  51. package/dist/reactors/ReactorRegistrations.js +42 -0
  52. package/dist/reactors/ReactorRegistrations.js.map +1 -0
  53. package/dist/reactors/ReactorSubscription.d.ts +4 -0
  54. package/dist/reactors/ReactorSubscription.d.ts.map +1 -0
  55. package/dist/reactors/ReactorSubscription.js +4 -0
  56. package/dist/reactors/ReactorSubscription.js.map +1 -0
  57. package/dist/reactors/Reactors.d.ts +31 -38
  58. package/dist/reactors/Reactors.d.ts.map +1 -1
  59. package/dist/reactors/Reactors.js +143 -274
  60. package/dist/reactors/Reactors.js.map +1 -1
  61. package/dist/reactors/WaitTillSubscribedOptions.d.ts +7 -0
  62. package/dist/reactors/WaitTillSubscribedOptions.d.ts.map +1 -0
  63. package/dist/reactors/WaitTillSubscribedOptions.js +4 -0
  64. package/dist/reactors/WaitTillSubscribedOptions.js.map +1 -0
  65. package/dist/reactors/index.d.ts +5 -0
  66. package/dist/reactors/index.d.ts.map +1 -1
  67. package/dist/reactors/index.js.map +1 -1
  68. package/dist/reactors/prepareReactor.d.ts +34 -0
  69. package/dist/reactors/prepareReactor.d.ts.map +1 -0
  70. package/dist/reactors/prepareReactor.js +75 -0
  71. package/dist/reactors/prepareReactor.js.map +1 -0
  72. package/dist/reactors/waitTillSubscribed.d.ts +5 -0
  73. package/dist/reactors/waitTillSubscribed.d.ts.map +1 -0
  74. package/dist/reactors/waitTillSubscribed.js +29 -0
  75. package/dist/reactors/waitTillSubscribed.js.map +1 -0
  76. package/dist/testing/for_ReadModelScenario/when_subtracting_with_children/given/compiled_projection.d.ts +145 -0
  77. package/dist/testing/for_ReadModelScenario/when_subtracting_with_children/given/compiled_projection.d.ts.map +1 -0
  78. package/dist/testing/for_ReadModelScenario/when_subtracting_with_children/given/compiled_projection.js +142 -0
  79. package/dist/testing/for_ReadModelScenario/when_subtracting_with_children/given/compiled_projection.js.map +1 -0
  80. package/dist/testing/for_ReadModelScenario/when_subtracting_with_children/given/lifecycle.d.ts +24 -0
  81. package/dist/testing/for_ReadModelScenario/when_subtracting_with_children/given/lifecycle.d.ts.map +1 -0
  82. package/dist/testing/for_ReadModelScenario/when_subtracting_with_children/given/lifecycle.js +34 -0
  83. package/dist/testing/for_ReadModelScenario/when_subtracting_with_children/given/lifecycle.js.map +1 -0
  84. package/dist/testing/for_ReadModelScenario/when_subtracting_with_children/given/oracle_input.d.ts +7 -0
  85. package/dist/testing/for_ReadModelScenario/when_subtracting_with_children/given/oracle_input.d.ts.map +1 -0
  86. package/dist/testing/for_ReadModelScenario/when_subtracting_with_children/given/oracle_input.js +33 -0
  87. package/dist/testing/for_ReadModelScenario/when_subtracting_with_children/given/oracle_input.js.map +1 -0
  88. package/dist/testing/projections/ProjectionArithmeticChildrenCapabilities.js +1 -1
  89. package/dist/testing/projections/ProjectionArithmeticChildrenCapabilities.js.map +1 -1
  90. package/dist/tsconfig.tsbuildinfo +1 -1
  91. package/package.json +2 -2
  92. package/reactors/AsyncQueue.ts +41 -0
  93. package/reactors/IReactorBuilder.ts +15 -0
  94. package/reactors/IReactorDefinition.ts +17 -0
  95. package/reactors/IReactorDefinitionBuilder.ts +12 -0
  96. package/reactors/IReactors.ts +25 -10
  97. package/reactors/ReactorBuilder.ts +98 -0
  98. package/reactors/ReactorCallback.ts +7 -0
  99. package/reactors/ReactorEvent.ts +10 -0
  100. package/reactors/ReactorObservation.ts +45 -0
  101. package/reactors/ReactorObservationTarget.ts +4 -1
  102. package/reactors/ReactorPageDispatcher.ts +98 -54
  103. package/reactors/ReactorRegistration.ts +11 -0
  104. package/reactors/ReactorRegistrationKind.ts +9 -0
  105. package/reactors/ReactorRegistrations.ts +45 -0
  106. package/reactors/ReactorSubscription.ts +7 -0
  107. package/reactors/Reactors.ts +156 -310
  108. package/reactors/WaitTillSubscribedOptions.ts +9 -0
  109. package/reactors/for_Reactors/given/runtime_reactors.fixture.ts +50 -0
  110. package/reactors/for_Reactors/when_a_class_reactor_fails_to_restart.spec.ts +67 -0
  111. package/reactors/for_Reactors/when_a_class_reactor_fails_to_start.spec.ts +80 -0
  112. package/reactors/for_Reactors/when_class_delivery_is_unregistered.spec.ts +62 -0
  113. package/reactors/for_Reactors/when_defining_runtime_reactors.spec.ts +77 -0
  114. package/reactors/for_Reactors/when_dispatching_runtime_reactors.spec.ts +94 -0
  115. package/reactors/for_Reactors/when_registering_runtime_reactors.spec.ts +102 -0
  116. package/reactors/for_Reactors/when_stopping_runtime_reactors.spec.ts +160 -0
  117. package/reactors/for_Reactors/when_using_the_default_artifacts_provider.spec.ts +80 -0
  118. package/reactors/for_Reactors/when_waiting_till_subscribed.spec.ts +65 -0
  119. package/reactors/index.ts +5 -0
  120. package/reactors/prepareReactor.ts +79 -0
  121. package/reactors/waitTillSubscribed.ts +29 -0
  122. package/testing/for_ReadModelScenario/when_subtracting_with_children/given/compiled_projection.ts +71 -0
  123. package/testing/for_ReadModelScenario/when_subtracting_with_children/given/lifecycle.ts +38 -0
  124. package/testing/for_ReadModelScenario/when_subtracting_with_children/given/oracle_input.ts +36 -0
  125. package/testing/for_ReadModelScenario/when_subtracting_with_children/with_a_fluent_projection.spec.ts +40 -0
  126. package/testing/for_ReadModelScenario/when_subtracting_with_children/with_legacy_decorators.legacy.spec.ts +50 -0
  127. package/testing/for_ReadModelScenario/when_subtracting_with_children/with_standard_decorators.standard.spec.ts +51 -0
  128. package/testing/projections/ProjectionArithmeticChildrenCapabilities.ts +1 -1
  129. package/testing/projections/for_ProjectionCapabilities/when_validating_add_with_children.spec.ts +1 -1
  130. package/testing/projections/for_ProjectionCapabilities/when_validating_count_with_children.spec.ts +11 -9
  131. package/testing/projections/for_ProjectionCapabilities/when_validating_subtract_with_children.spec.ts +105 -0
@@ -0,0 +1,10 @@
1
+ /** A push-based queue for one bidirectional observation attempt. */
2
+ export declare class AsyncQueue<T> implements AsyncIterable<T> {
3
+ private readonly _queue;
4
+ private _resolve;
5
+ private _done;
6
+ send(value: T): void;
7
+ complete(): void;
8
+ [Symbol.asyncIterator](): AsyncIterator<T, undefined>;
9
+ }
10
+ //# sourceMappingURL=AsyncQueue.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"AsyncQueue.d.ts","sourceRoot":"","sources":["../../reactors/AsyncQueue.ts"],"names":[],"mappings":"AAGA,oEAAoE;AACpE,qBAAa,UAAU,CAAC,CAAC,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,QAAQ,CAA+D;IAC/E,OAAO,CAAC,KAAK,CAAS;IAEtB,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CASnB;IAED,QAAQ,IAAI,IAAI,CAKf;IAED,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,CAAC,EAAE,SAAS,CAAC,CAYpD;CACJ"}
@@ -0,0 +1,42 @@
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
+ /** A push-based queue for one bidirectional observation attempt. */
4
+ export class AsyncQueue {
5
+ _queue = [];
6
+ _resolve;
7
+ _done = false;
8
+ send(value) {
9
+ if (this._done)
10
+ return;
11
+ if (this._resolve) {
12
+ const resolve = this._resolve;
13
+ this._resolve = undefined;
14
+ resolve({ value, done: false });
15
+ }
16
+ else {
17
+ this._queue.push(value);
18
+ }
19
+ }
20
+ complete() {
21
+ this._done = true;
22
+ this._queue.length = 0;
23
+ this._resolve?.({ value: undefined, done: true });
24
+ this._resolve = undefined;
25
+ }
26
+ [Symbol.asyncIterator]() {
27
+ return {
28
+ next: () => {
29
+ if (this._queue.length > 0)
30
+ return Promise.resolve({ value: this._queue.shift(), done: false });
31
+ if (this._done)
32
+ return Promise.resolve({ value: undefined, done: true });
33
+ return new Promise(resolve => { this._resolve = resolve; });
34
+ },
35
+ return: () => {
36
+ this.complete();
37
+ return Promise.resolve({ value: undefined, done: true });
38
+ }
39
+ };
40
+ }
41
+ }
42
+ //# sourceMappingURL=AsyncQueue.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"AsyncQueue.js","sourceRoot":"","sources":["../../reactors/AsyncQueue.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,oEAAoE;AACpE,MAAM,OAAO,UAAU;IACF,MAAM,GAAQ,EAAE,CAAC;IAC1B,QAAQ,CAA+D;IACvE,KAAK,GAAG,KAAK,CAAC;IAEtB,IAAI,CAAC,KAAQ;QACT,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO;QACvB,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC9B,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;YAC1B,OAAO,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACpC,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACL,CAAC;IAED,QAAQ;QACJ,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QACvB,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;IAC9B,CAAC;IAED,CAAC,MAAM,CAAC,aAAa,CAAC;QAClB,OAAO;YACH,IAAI,EAAE,GAAG,EAAE;gBACP,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;oBAAE,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;gBACjG,IAAI,IAAI,CAAC,KAAK;oBAAE,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;gBACzE,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;YAChE,CAAC;YACD,MAAM,EAAE,GAAG,EAAE;gBACT,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAChB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7D,CAAC;SACJ,CAAC;IACN,CAAC;CACJ"}
@@ -0,0 +1,12 @@
1
+ import type { Constructor } from '@cratis/fundamentals';
2
+ import type { EventContext } from '../events/EventContext.js';
3
+ import type { EventSequenceId } from '../eventSequences/EventSequenceId.js';
4
+ /** Defines local callbacks without opening a stream. */
5
+ export interface IReactorBuilder {
6
+ on<T>(eventType: Constructor<T>, handler: (event: T, context: EventContext) => void | Promise<void>): this;
7
+ /** Subscribes to the event types known when this definition is built, not future types. */
8
+ subscribe(handler: (event: unknown, context: EventContext) => void | Promise<void>): this;
9
+ onEventSequence(eventSequenceId: EventSequenceId | string): this;
10
+ notReplayable(): this;
11
+ }
12
+ //# sourceMappingURL=IReactorBuilder.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"IReactorBuilder.d.ts","sourceRoot":"","sources":["../../reactors/IReactorBuilder.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAE5E,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC5B,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC3G,2FAA2F;IAC3F,SAAS,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1F,eAAe,CAAC,eAAe,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CAAC;IACjE,aAAa,IAAI,IAAI,CAAC;CACzB"}
@@ -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=IReactorBuilder.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"IReactorBuilder.js","sourceRoot":"","sources":["../../reactors/IReactorBuilder.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG"}
@@ -0,0 +1,14 @@
1
+ import type { EventSequenceId } from '../eventSequences/EventSequenceId.js';
2
+ import type { EventType } from '../events/EventType.js';
3
+ import type { ReactorEvent } from './ReactorEvent.js';
4
+ import type { ReactorId } from './ReactorId.js';
5
+ /** An immutable runtime reactor definition. Defining it does not start observation. */
6
+ export interface IReactorDefinition {
7
+ readonly id: ReactorId;
8
+ readonly eventSequenceId: EventSequenceId;
9
+ readonly eventTypes: readonly EventType[];
10
+ readonly isReplayable: boolean;
11
+ /** Dispatches an event locally, awaiting callbacks before event-processing acknowledgment. */
12
+ readonly handle: (event: ReactorEvent, signal: AbortSignal) => void | Promise<void>;
13
+ }
14
+ //# sourceMappingURL=IReactorDefinition.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"IReactorDefinition.d.ts","sourceRoot":"","sources":["../../reactors/IReactorDefinition.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,uFAAuF;AACvF,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC;IACvB,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,CAAC;IAC1C,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,8FAA8F;IAC9F,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvF"}
@@ -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=IReactorDefinition.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"IReactorDefinition.js","sourceRoot":"","sources":["../../reactors/IReactorDefinition.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG"}
@@ -0,0 +1,9 @@
1
+ import type { Constructor } from '@cratis/fundamentals';
2
+ import type { EventSequenceId } from '../eventSequences/EventSequenceId.js';
3
+ /** Configures the subscriptions of a delegate reactor. */
4
+ export interface IReactorDefinitionBuilder {
5
+ withEventType<T>(eventType: Constructor<T>): this;
6
+ onEventSequence(eventSequenceId: EventSequenceId | string): this;
7
+ notReplayable(): this;
8
+ }
9
+ //# sourceMappingURL=IReactorDefinitionBuilder.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"IReactorDefinitionBuilder.d.ts","sourceRoot":"","sources":["../../reactors/IReactorDefinitionBuilder.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAE5E,0DAA0D;AAC1D,MAAM,WAAW,yBAAyB;IACtC,aAAa,CAAC,CAAC,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAClD,eAAe,CAAC,eAAe,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CAAC;IACjE,aAAa,IAAI,IAAI,CAAC;CACzB"}
@@ -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=IReactorDefinitionBuilder.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"IReactorDefinitionBuilder.js","sourceRoot":"","sources":["../../reactors/IReactorDefinitionBuilder.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG"}
@@ -1,16 +1,27 @@
1
- /**
2
- * Defines a system to work with reactors, including discovery and registration with the Kernel.
3
- */
1
+ import type { IReactorBuilder } from './IReactorBuilder.js';
2
+ import type { IReactorDefinitionBuilder } from './IReactorDefinitionBuilder.js';
3
+ import type { IReactorDefinition } from './IReactorDefinition.js';
4
+ import type { ReactorId } from './ReactorId.js';
5
+ import type { WaitTillSubscribedOptions } from './WaitTillSubscribedOptions.js';
6
+ /** Manages reactor identities and their local observations for one event store and namespace. */
4
7
  export interface IReactors {
5
- /**
6
- * Discovers all reactors from the registered client artifacts.
7
- * @returns A promise that resolves when discovery is complete.
8
- */
8
+ /** Discovers artifacts, rejecting duplicate IDs before any stream is opened. */
9
9
  discover(): Promise<void>;
10
+ /** Creates an immutable definition without registering or observing it. */
11
+ define(id: ReactorId | string, define: (builder: IReactorBuilder) => void): IReactorDefinition;
12
+ /** Starts local observation for discovered and retained runtime definitions. Idempotent while active. */
13
+ register(): Promise<void>;
14
+ /** Resolves after local validation, reservation and observation start, not a kernel acknowledgment. */
15
+ register(definition: IReactorDefinition): Promise<void>;
16
+ register(id: ReactorId | string, define: (builder: IReactorBuilder) => void): Promise<void>;
17
+ /** The callback receives the envelope and the observation's cancellation signal. */
18
+ register(id: ReactorId | string, configure: (builder: IReactorDefinitionBuilder) => void, handle: IReactorDefinition['handle']): Promise<void>;
19
+ /** Removes local restoration eligibility and cancels observation; does not wait for in-flight callbacks. */
20
+ unregister(id: ReactorId | string): Promise<void>;
10
21
  /**
11
- * Registers all discovered reactors with the Chronicle Kernel and starts observation.
12
- * @returns A promise that resolves when registration is complete.
22
+ * Polls observer information until IsSubscribed, independently of registration.
23
+ * This is not a causal acknowledgment of a particular register call and may observe an existing subscription.
13
24
  */
14
- register(): Promise<void>;
25
+ waitTillSubscribed(id: ReactorId | string, options?: WaitTillSubscribedOptions): Promise<void>;
15
26
  }
16
27
  //# sourceMappingURL=IReactors.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"IReactors.d.ts","sourceRoot":"","sources":["../../reactors/IReactors.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB;;;OAGG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B;;;OAGG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B"}
1
+ {"version":3,"file":"IReactors.d.ts","sourceRoot":"","sources":["../../reactors/IReactors.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAEhF,iGAAiG;AACjG,MAAM,WAAW,SAAS;IACtB,gFAAgF;IAChF,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B,2EAA2E;IAC3E,MAAM,CAAC,EAAE,EAAE,SAAS,GAAG,MAAM,EAAE,MAAM,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,GAAG,kBAAkB,CAAC;IAE/F,yGAAyG;IACzG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,uGAAuG;IACvG,QAAQ,CAAC,UAAU,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,QAAQ,CAAC,EAAE,EAAE,SAAS,GAAG,MAAM,EAAE,MAAM,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5F,oFAAoF;IACpF,QAAQ,CAAC,EAAE,EAAE,SAAS,GAAG,MAAM,EAAE,SAAS,EAAE,CAAC,OAAO,EAAE,yBAAyB,KAAK,IAAI,EAAE,MAAM,EAAE,kBAAkB,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/I,4GAA4G;IAC5G,UAAU,CAAC,EAAE,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElD;;;OAGG;IACH,kBAAkB,CAAC,EAAE,EAAE,SAAS,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClG"}
@@ -0,0 +1,32 @@
1
+ import type { Constructor } from '@cratis/fundamentals';
2
+ import { EventSequenceId } from '../eventSequences/EventSequenceId.js';
3
+ import type { EventContext } from '../events/EventContext.js';
4
+ import type { IReactorBuilder } from './IReactorBuilder.js';
5
+ import type { IReactorDefinitionBuilder } from './IReactorDefinitionBuilder.js';
6
+ import type { IReactorDefinition } from './IReactorDefinition.js';
7
+ import { ReactorId } from './ReactorId.js';
8
+ import type { ReactorCallback } from './ReactorCallback.js';
9
+ /** Builds a snapshot of subscriptions and callbacks; never registers an artifact globally. */
10
+ export declare class ReactorBuilder implements IReactorBuilder, IReactorDefinitionBuilder {
11
+ private readonly _id;
12
+ private readonly _knownTypes;
13
+ private readonly _subscriptions;
14
+ private readonly _handlers;
15
+ private readonly _catchAll;
16
+ private _eventSequenceId;
17
+ private _isReplayable;
18
+ constructor(_id: ReactorId | string, knownTypes: readonly Constructor[]);
19
+ /** @inheritdoc */
20
+ withEventType<T>(eventType: Constructor<T>): this;
21
+ /** @inheritdoc */
22
+ on<T>(eventType: Constructor<T>, handler: (event: T, context: EventContext) => void | Promise<void>): this;
23
+ /** @inheritdoc */
24
+ subscribe(handler: ReactorCallback): this;
25
+ /** @inheritdoc */
26
+ onEventSequence(eventSequenceId: EventSequenceId | string): this;
27
+ /** @inheritdoc */
28
+ notReplayable(): this;
29
+ /** Creates an immutable definition, independent of subsequent builder changes. */
30
+ build(delegate?: IReactorDefinition['handle']): IReactorDefinition;
31
+ }
32
+ //# sourceMappingURL=ReactorBuilder.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ReactorBuilder.d.ts","sourceRoot":"","sources":["../../reactors/ReactorBuilder.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAK9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,8FAA8F;AAC9F,qBAAa,cAAe,YAAW,eAAe,EAAE,yBAAyB;IAQjE,OAAO,CAAC,QAAQ,CAAC,GAAG;IAPhC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyB;IACrD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgC;IAC/D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwC;IAClE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,gBAAgB,CAAkC;IAC1D,OAAO,CAAC,aAAa,CAAQ;IAE7B,YAA6B,GAAG,EAAE,SAAS,GAAG,MAAM,EAAE,UAAU,EAAE,SAAS,WAAW,EAAE,EAGvF;IAED,kBAAkB;IAClB,aAAa,CAAC,CAAC,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAShD;IAED,kBAAkB;IAClB,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAOzG;IAED,kBAAkB;IAClB,SAAS,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAIxC;IAED,kBAAkB;IAClB,eAAe,CAAC,eAAe,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CAG/D;IAED,kBAAkB;IAClB,aAAa,IAAI,IAAI,CAGpB;IAED,kFAAkF;IAClF,KAAK,CAAC,QAAQ,CAAC,EAAE,kBAAkB,CAAC,QAAQ,CAAC,GAAG,kBAAkB,CAuBjE;CACJ"}
@@ -0,0 +1,91 @@
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 { EventSequenceId } from '../eventSequences/EventSequenceId.js';
4
+ import { EventType } from '../events/EventType.js';
5
+ import { EventTypeId } from '../events/EventTypeId.js';
6
+ import { EventTypeGeneration } from '../events/EventTypeGeneration.js';
7
+ import { getEventTypeMetadata } from '../events/eventTypeDecorator.js';
8
+ import { ReactorId } from './ReactorId.js';
9
+ /** Builds a snapshot of subscriptions and callbacks; never registers an artifact globally. */
10
+ export class ReactorBuilder {
11
+ _id;
12
+ _knownTypes;
13
+ _subscriptions = new Map();
14
+ _handlers = new Map();
15
+ _catchAll = [];
16
+ _eventSequenceId = EventSequenceId.eventLog.value;
17
+ _isReplayable = true;
18
+ constructor(_id, knownTypes) {
19
+ this._id = _id;
20
+ if (!(typeof _id === 'string' ? _id : _id.value).trim())
21
+ throw new Error('Reactor id must not be empty.');
22
+ this._knownTypes = [...knownTypes];
23
+ }
24
+ /** @inheritdoc */
25
+ withEventType(eventType) {
26
+ const metadata = getEventTypeMetadata(eventType);
27
+ if (!this._knownTypes.includes(eventType) || !metadata) {
28
+ throw new Error(`Reactor event type '${eventType.name}' has no registered event type.`);
29
+ }
30
+ const type = metadata.eventType;
31
+ const previous = this._subscriptions.get(type.id.value);
32
+ if (!previous || previous.generation.value < type.generation.value)
33
+ this._subscriptions.set(type.id.value, type);
34
+ return this;
35
+ }
36
+ /** @inheritdoc */
37
+ on(eventType, handler) {
38
+ this.withEventType(eventType);
39
+ const id = getEventTypeMetadata(eventType).eventType.id.value;
40
+ const callbacks = this._handlers.get(id) ?? [];
41
+ callbacks.push((content, context) => handler(Object.assign(Object.create(eventType.prototype), content), context));
42
+ this._handlers.set(id, callbacks);
43
+ return this;
44
+ }
45
+ /** @inheritdoc */
46
+ subscribe(handler) {
47
+ for (const type of this._knownTypes)
48
+ this.withEventType(type);
49
+ this._catchAll.push(handler);
50
+ return this;
51
+ }
52
+ /** @inheritdoc */
53
+ onEventSequence(eventSequenceId) {
54
+ this._eventSequenceId = typeof eventSequenceId === 'string' ? eventSequenceId : eventSequenceId.value;
55
+ return this;
56
+ }
57
+ /** @inheritdoc */
58
+ notReplayable() {
59
+ this._isReplayable = false;
60
+ return this;
61
+ }
62
+ /** Creates an immutable definition, independent of subsequent builder changes. */
63
+ build(delegate) {
64
+ if (this._subscriptions.size === 0)
65
+ throw new Error('Reactor must subscribe to at least one event type.');
66
+ const handlers = new Map([...this._handlers].map(([id, callbacks]) => [id, [...callbacks]]));
67
+ const catchAll = [...this._catchAll];
68
+ const eventTypes = Object.freeze([...this._subscriptions.values()].map(type => Object.freeze(new EventType(Object.freeze(new EventTypeId(type.id.value)), Object.freeze(new EventTypeGeneration(type.generation.value)), type.tombstone))));
69
+ const ids = new Set(eventTypes.map(type => type.id.value));
70
+ const handle = async (event, signal) => {
71
+ if (!ids.has(event.context.eventType.id.value))
72
+ return;
73
+ if (delegate) {
74
+ if (!signal.aborted)
75
+ await delegate(event, signal);
76
+ return;
77
+ }
78
+ for (const callback of [...(handlers.get(event.context.eventType.id.value) ?? []), ...catchAll]) {
79
+ if (signal.aborted)
80
+ return;
81
+ await callback(event.content, event.context);
82
+ }
83
+ };
84
+ return Object.freeze({
85
+ id: Object.freeze(new ReactorId(typeof this._id === 'string' ? this._id : this._id.value)),
86
+ eventSequenceId: Object.freeze(new EventSequenceId(this._eventSequenceId)),
87
+ eventTypes, isReplayable: this._isReplayable, handle
88
+ });
89
+ }
90
+ }
91
+ //# sourceMappingURL=ReactorBuilder.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ReactorBuilder.js","sourceRoot":"","sources":["../../reactors/ReactorBuilder.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import type { EventContext } from '../events/EventContext.js';
2
+ /** An untyped callback retained by a fluent definition. */
3
+ export type ReactorCallback = (event: unknown, context: EventContext) => void | Promise<void>;
4
+ //# sourceMappingURL=ReactorCallback.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ReactorCallback.d.ts","sourceRoot":"","sources":["../../reactors/ReactorCallback.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D,2DAA2D;AAC3D,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC"}
@@ -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=ReactorCallback.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ReactorCallback.js","sourceRoot":"","sources":["../../reactors/ReactorCallback.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG"}
@@ -0,0 +1,7 @@
1
+ import type { EventContext } from '../events/EventContext.js';
2
+ /** An event delivered to a delegate reactor. */
3
+ export interface ReactorEvent {
4
+ readonly content: unknown;
5
+ readonly context: EventContext;
6
+ }
7
+ //# sourceMappingURL=ReactorEvent.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ReactorEvent.d.ts","sourceRoot":"","sources":["../../reactors/ReactorEvent.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D,gDAAgD;AAChD,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,YAAY,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=ReactorEvent.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ReactorEvent.js","sourceRoot":"","sources":["../../reactors/ReactorEvent.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG"}
@@ -0,0 +1,21 @@
1
+ import type { EventsToObserve, ReactorMessage } from '@cratis/chronicle.contracts';
2
+ import { AsyncQueue } from './AsyncQueue.js';
3
+ import type { ReactorRegistration } from './ReactorRegistration.js';
4
+ import type { ReactorPageDispatcher } from './ReactorPageDispatcher.js';
5
+ /** One stream attempt, whose identity is never reused by reconnect or same-ID replacement. */
6
+ export declare class ReactorObservation {
7
+ readonly registration: ReactorRegistration;
8
+ readonly connectionId: string;
9
+ readonly queue: AsyncQueue<ReactorMessage>;
10
+ readonly controller: AbortController;
11
+ private _iterator?;
12
+ constructor(registration: ReactorRegistration, connectionId: string);
13
+ /** Local teardown does not wait for a server response or an uncooperative callback. */
14
+ stop(): void;
15
+ /** Only transport failures escape through the supplied classifier. */
16
+ observe(stream: AsyncIterable<EventsToObserve>, dispatcher: ReactorPageDispatcher, callbacks: {
17
+ delivered: () => void;
18
+ failed: (error: unknown) => import('../observation/ObservationStreamOutcome.js').ObservationStreamOutcome;
19
+ }): Promise<import('../observation/ObservationStreamOutcome.js').ObservationStreamOutcome>;
20
+ }
21
+ //# sourceMappingURL=ReactorObservation.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ReactorObservation.d.ts","sourceRoot":"","sources":["../../reactors/ReactorObservation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAExE,8FAA8F;AAC9F,qBAAa,kBAAkB;IAKf,QAAQ,CAAC,YAAY,EAAE,mBAAmB;IAAE,QAAQ,CAAC,YAAY,EAAE,MAAM;IAJrF,QAAQ,CAAC,KAAK,6BAAoC;IAClD,QAAQ,CAAC,UAAU,kBAAyB;IAC5C,OAAO,CAAC,SAAS,CAAC,CAAiC;IAEnD,YAAqB,YAAY,EAAE,mBAAmB,EAAW,YAAY,EAAE,MAAM,EAAI;IAEzF,uFAAuF;IACvF,IAAI,IAAI,IAAI,CAIX;IAED,sEAAsE;IAChE,OAAO,CAAC,MAAM,EAAE,aAAa,CAAC,eAAe,CAAC,EAAE,UAAU,EAAE,qBAAqB,EAAE,SAAS,EAAE;QAChG,SAAS,EAAE,MAAM,IAAI,CAAC;QACtB,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,4CAA4C,EAAE,wBAAwB,CAAC;KAC7G,GAAG,OAAO,CAAC,OAAO,4CAA4C,EAAE,wBAAwB,CAAC,CAgBzF;CACJ"}
@@ -0,0 +1,43 @@
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 { AsyncQueue } from './AsyncQueue.js';
4
+ /** One stream attempt, whose identity is never reused by reconnect or same-ID replacement. */
5
+ export class ReactorObservation {
6
+ registration;
7
+ connectionId;
8
+ queue = new AsyncQueue();
9
+ controller = new AbortController();
10
+ _iterator;
11
+ constructor(registration, connectionId) {
12
+ this.registration = registration;
13
+ this.connectionId = connectionId;
14
+ }
15
+ /** Local teardown does not wait for a server response or an uncooperative callback. */
16
+ stop() {
17
+ this.controller.abort();
18
+ this.queue.complete();
19
+ void this._iterator?.return?.()?.catch(() => undefined);
20
+ }
21
+ /** Only transport failures escape through the supplied classifier. */
22
+ async observe(stream, dispatcher, callbacks) {
23
+ this._iterator = stream[Symbol.asyncIterator]();
24
+ while (!this.controller.signal.aborted) {
25
+ let next;
26
+ try {
27
+ next = await this._iterator.next();
28
+ }
29
+ catch (error) {
30
+ return callbacks.failed(error);
31
+ }
32
+ if (next.done)
33
+ return 'ended';
34
+ if (this.controller.signal.aborted)
35
+ return 'stopped';
36
+ callbacks.delivered();
37
+ const result = await dispatcher.dispatch(next.value);
38
+ this.queue.send({ Content: { Value0: undefined, Value1: result } });
39
+ }
40
+ return 'stopped';
41
+ }
42
+ }
43
+ //# sourceMappingURL=ReactorObservation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ReactorObservation.js","sourceRoot":"","sources":["../../reactors/ReactorObservation.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAGrG,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAI7C,8FAA8F;AAC9F,MAAM,OAAO,kBAAkB;IAKN,YAAY;IAAgC,YAAY;IAJpE,KAAK,GAAG,IAAI,UAAU,EAAkB,CAAC;IACzC,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACpC,SAAS,CAAkC;IAEnD,YAAqB,YAAiC,EAAW,YAAoB;4BAAhE,YAAY;4BAAgC,YAAY;IAAW,CAAC;IAEzF,uFAAuF;IACvF,IAAI;QACA,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QACtB,KAAK,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC5D,CAAC;IAED,sEAAsE;IACtE,KAAK,CAAC,OAAO,CAAC,MAAsC,EAAE,UAAiC,EAAE,SAGxF;QACG,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACrC,IAAI,IAAqC,CAAC;YAC1C,IAAI,CAAC;gBACD,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YACvC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,OAAO,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACnC,CAAC;YACD,IAAI,IAAI,CAAC,IAAI;gBAAE,OAAO,OAAO,CAAC;YAC9B,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO;gBAAE,OAAO,SAAS,CAAC;YACrD,SAAS,CAAC,SAAS,EAAE,CAAC;YACtB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,SAAS,CAAC;IACrB,CAAC;CACJ"}
@@ -1,4 +1,5 @@
1
1
  import type { Constructor } from '@cratis/fundamentals';
2
+ import type { IReactorDefinition } from './IReactorDefinition.js';
2
3
  import type { ClientArtifactsActivator } from '../artifacts/ClientArtifactsActivator.js';
3
4
  import type { IEventLog } from '../eventSequences/IEventLog.js';
4
5
  import type { createLogger } from '../logging/createLogger.js';
@@ -12,7 +13,9 @@ export interface ReactorObservationTarget {
12
13
  /** The reactor identifier. */
13
14
  readonly id: string;
14
15
  /** The reactor class. */
15
- readonly reactorType: Constructor;
16
+ readonly reactorType: Constructor | undefined;
17
+ /** The runtime callback, absent for discovered class reactors. */
18
+ readonly runtime?: IReactorDefinition;
16
19
  /** The event sequence the reactor observes. */
17
20
  readonly eventSequenceId: string;
18
21
  /** The event store the reactor is registered with. */
@@ -1 +1 @@
1
- {"version":3,"file":"ReactorObservationTarget.d.ts","sourceRoot":"","sources":["../../reactors/ReactorObservationTarget.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AACzF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,8FAA8F;AAC9F,MAAM,WAAW,wBAAwB;IACrC,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,+CAA+C;IAC/C,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,sDAAsD;IACtD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,kDAAkD;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,yBAAyB;IACzB,QAAQ,CAAC,YAAY,EAAE,SAAS,WAAW,EAAE,CAAC;IAC9C,6DAA6D;IAC7D,QAAQ,CAAC,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACtD,+FAA+F;IAC/F,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,SAAS,CAAC;IAC/D,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,SAAS,CAAC;IAC/C,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,+CAA+C;IAC/C,QAAQ,CAAC,aAAa,CAAC,EAAE,oBAAoB,CAAC;IAC9C,uCAAuC;IACvC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;IACtD,0BAA0B;IAC1B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;IACjD,yDAAyD;IACzD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CAChD"}
1
+ {"version":3,"file":"ReactorObservationTarget.d.ts","sourceRoot":"","sources":["../../reactors/ReactorObservationTarget.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AACzF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uCAAuC,CAAC;AACzE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,8FAA8F;AAC9F,MAAM,WAAW,wBAAwB;IACrC,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,QAAQ,CAAC,WAAW,EAAE,WAAW,GAAG,SAAS,CAAC;IAC9C,kEAAkE;IAClE,QAAQ,CAAC,OAAO,CAAC,EAAE,kBAAkB,CAAC;IACtC,+CAA+C;IAC/C,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,sDAAsD;IACtD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,kDAAkD;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,yBAAyB;IACzB,QAAQ,CAAC,YAAY,EAAE,SAAS,WAAW,EAAE,CAAC;IAC9C,6DAA6D;IAC7D,QAAQ,CAAC,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACtD,+FAA+F;IAC/F,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,SAAS,CAAC;IAC/D,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,SAAS,CAAC;IAC/C,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,+CAA+C;IAC/C,QAAQ,CAAC,aAAa,CAAC,EAAE,oBAAoB,CAAC;IAC9C,uCAAuC;IACvC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;IACtD,0BAA0B;IAC1B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;IACjD,yDAAyD;IACzD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CAChD"}
@@ -19,13 +19,19 @@ export declare class ReactorPageDispatcher {
19
19
  */
20
20
  dispatch(message: EventsToObserve): Promise<ReactorResult>;
21
21
  private notifyReplayTransition;
22
+ private replayFailures;
22
23
  private observe;
23
24
  private firstInvocableEvent;
25
+ private isInvocable;
24
26
  private select;
25
27
  private observeWith;
26
28
  private observeBatches;
29
+ private collectBatchEvents;
27
30
  private invokeBatchMethod;
31
+ private observeRuntimePartition;
28
32
  private observePartition;
33
+ private observeClassEvent;
34
+ private logSkippedHandler;
29
35
  private toEventAndContext;
30
36
  private deliveryFor;
31
37
  private createBatchContext;
@@ -1 +1 @@
1
- {"version":3,"file":"ReactorPageDispatcher.d.ts","sourceRoot":"","sources":["../../reactors/ReactorPageDispatcher.ts"],"names":[],"mappings":"AAIA,OAAO,EAAqD,KAAK,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAwB1I,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAU9E;;;GAGG;AACH,qBAAa,qBAAqB;IAOlB,OAAO,CAAC,QAAQ,CAAC,OAAO;IANpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkE;IAEnG;;;OAGG;IACH,YAA6B,OAAO,EAAE,wBAAwB,EAG7D;IAED;;;;OAIG;IACG,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC,CAc/D;YAEa,sBAAsB;YA8BtB,OAAO;IAyBrB,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,MAAM;YAKA,WAAW;YAYX,cAAc;YA0Bd,iBAAiB;YA0BjB,gBAAgB;IAqC9B,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,kBAAkB;CAI7B"}
1
+ {"version":3,"file":"ReactorPageDispatcher.d.ts","sourceRoot":"","sources":["../../reactors/ReactorPageDispatcher.ts"],"names":[],"mappings":"AAIA,OAAO,EAAqD,KAAK,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAwB1I,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAU9E;;;GAGG;AACH,qBAAa,qBAAqB;IAOlB,OAAO,CAAC,QAAQ,CAAC,OAAO;IANpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkE;IAEnG;;;OAGG;IACH,YAA6B,OAAO,EAAE,wBAAwB,EAG7D;IAED;;;;OAIG;IACG,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC,CAc/D;YAEa,sBAAsB;IAyBpC,OAAO,CAAC,cAAc;YAQR,OAAO;IAyBrB,OAAO,CAAC,mBAAmB;IAS3B,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,MAAM;YAKA,WAAW;YAYX,cAAc;IAgB5B,OAAO,CAAC,kBAAkB;YAYZ,iBAAiB;YA0BjB,uBAAuB;YAgBvB,gBAAgB;YAUhB,iBAAiB;IA+B/B,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,kBAAkB;CAI7B"}