@cratis/chronicle 0.0.1

package/dist/Projections/modelBound/subtractFrom.d.ts

@@ -0,0 +1,23 @@
+import 'reflect-metadata';
+/** Metadata stored by the subtractFrom property decorator. */
+export interface SubtractFromMetadata {
+    /** The event constructor associated with this annotation. */
+    readonly eventType: Function;
+    /** The event property name whose value is subtracted from the read model property. Defaults to the decorated property name. */
+    readonly eventPropertyName?: string;
+}
+/**
+ * Property decorator that subtracts an event property value from the decorated read model property.
+ * @param eventType - The event constructor.
+ * @param eventPropertyName - Optional event property name. Defaults to the property name.
+ * @returns A property decorator.
+ */
+export declare function subtractFrom(eventType: Function, eventPropertyName?: string): PropertyDecorator;
+/**
+ * Retrieves all subtractFrom metadata stored on the given property.
+ * @param target - The class prototype.
+ * @param propertyKey - The property name.
+ * @returns An array of subtractFrom metadata entries.
+ */
+export declare function getSubtractFromMetadata(target: object, propertyKey: string): SubtractFromMetadata[];
+//# sourceMappingURL=subtractFrom.d.ts.map

package/dist/Projections/modelBound/subtractFrom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subtractFrom.d.ts","sourceRoot":"","sources":["../../../Projections/modelBound/subtractFrom.ts"],"names":[],"mappings":"AAGA,OAAO,kBAAkB,CAAC;AAG1B,8DAA8D;AAC9D,MAAM,WAAW,oBAAoB;IACjC,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC;IAC7B,+HAA+H;IAC/H,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CACvC;AAID;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,QAAQ,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAQ/F;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,oBAAoB,EAAE,CAEnG"}

package/dist/Projections/modelBound/subtractFrom.js

@@ -0,0 +1,30 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+import 'reflect-metadata';
+import { TypeIntrospector } from '../../types';
+const METADATA_KEY = 'chronicle:projection:subtractFrom';
+/**
+ * Property decorator that subtracts an event property value from the decorated read model property.
+ * @param eventType - The event constructor.
+ * @param eventPropertyName - Optional event property name. Defaults to the property name.
+ * @returns A property decorator.
+ */
+export function subtractFrom(eventType, eventPropertyName) {
+    return (target, propertyKey) => {
+        const key = propertyKey.toString();
+        TypeIntrospector.trackProperty(target.constructor, key);
+        const existing = Reflect.getMetadata(METADATA_KEY, target, key) ?? [];
+        const metadata = { eventType, eventPropertyName };
+        Reflect.defineMetadata(METADATA_KEY, [...existing, metadata], target, key);
+    };
+}
+/**
+ * Retrieves all subtractFrom metadata stored on the given property.
+ * @param target - The class prototype.
+ * @param propertyKey - The property name.
+ * @returns An array of subtractFrom metadata entries.
+ */
+export function getSubtractFromMetadata(target, propertyKey) {
+    return Reflect.getMetadata(METADATA_KEY, target, propertyKey) ?? [];
+}
+//# sourceMappingURL=subtractFrom.js.map

package/dist/Projections/modelBound/subtractFrom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subtractFrom.js","sourceRoot":"","sources":["../../../Projections/modelBound/subtractFrom.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAU/C,MAAM,YAAY,GAAG,mCAAmC,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,SAAmB,EAAE,iBAA0B;IACxE,OAAO,CAAC,MAAc,EAAE,WAA4B,EAAE,EAAE;QACpD,MAAM,GAAG,GAAG,WAAW,CAAC,QAAQ,EAAE,CAAC;QACnC,gBAAgB,CAAC,aAAa,CAAE,MAAoC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;QACvF,MAAM,QAAQ,GAA2B,OAAO,CAAC,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9F,MAAM,QAAQ,GAAyB,EAAE,SAAS,EAAE,iBAAiB,EAAE,CAAC;QACxE,OAAO,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC,GAAG,QAAQ,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/E,CAAC,CAAC;AACN,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAc,EAAE,WAAmB;IACvE,OAAO,OAAO,CAAC,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;AACxE,CAAC"}

package/dist/Reactors/IReactors.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Defines a system to work with reactors, including discovery and registration with the Kernel.
+ */
+export interface IReactors {
+    /**
+     * Discovers all reactors from the registered client artifacts.
+     * @returns A promise that resolves when discovery is complete.
+     */
+    discover(): Promise<void>;
+    /**
+     * Registers all discovered reactors with the Chronicle Kernel and starts observation.
+     * @returns A promise that resolves when registration is complete.
+     */
+    register(): Promise<void>;
+}
+//# sourceMappingURL=IReactors.d.ts.map

package/dist/Reactors/IReactors.d.ts.map

@@ -0,0 +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"}

package/dist/Reactors/IReactors.js

@@ -0,0 +1,4 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+export {};
+//# sourceMappingURL=IReactors.js.map

package/dist/Reactors/IReactors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IReactors.js","sourceRoot":"","sources":["../../Reactors/IReactors.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG"}

package/dist/Reactors/ReactorId.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Unique identifier for a reactor.
+ */
+export declare class ReactorId {
+    readonly value: string;
+    constructor(value: string);
+    /** @inheritdoc */
+    toString(): string;
+}
+//# sourceMappingURL=ReactorId.d.ts.map

package/dist/Reactors/ReactorId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReactorId.d.ts","sourceRoot":"","sources":["../../Reactors/ReactorId.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,qBAAa,SAAS;IACN,QAAQ,CAAC,KAAK,EAAE,MAAM;gBAAb,KAAK,EAAE,MAAM;IAElC,kBAAkB;IAClB,QAAQ,IAAI,MAAM;CAGrB"}

package/dist/Reactors/ReactorId.js

@@ -0,0 +1,16 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Unique identifier for a reactor.
+ */
+export class ReactorId {
+    value;
+    constructor(value) {
+        this.value = value;
+    }
+    /** @inheritdoc */
+    toString() {
+        return this.value;
+    }
+}
+//# sourceMappingURL=ReactorId.js.map

package/dist/Reactors/ReactorId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReactorId.js","sourceRoot":"","sources":["../../Reactors/ReactorId.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG;;GAEG;AACH,MAAM,OAAO,SAAS;IACG;IAArB,YAAqB,KAAa;QAAb,UAAK,GAAL,KAAK,CAAQ;IAAG,CAAC;IAEtC,kBAAkB;IAClB,QAAQ;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;CACJ"}

package/dist/Reactors/Reactors.d.ts

@@ -0,0 +1,38 @@
+import 'reflect-metadata';
+import { IClientArtifactsProvider } from '../artifacts';
+import { ChronicleConnection } from '../connection';
+import { ConnectionLifecycle } from '../connection/ConnectionLifecycle';
+import { IReactors } from './IReactors';
+/**
+ * Implements {@link IReactors}, managing discovery and registration of reactors
+ * with the Chronicle Kernel via bidirectional gRPC streaming.
+ */
+export declare class Reactors implements IReactors {
+    private readonly _clientArtifacts;
+    private readonly _connection;
+    private readonly _eventStoreName;
+    private readonly _namespace;
+    private readonly _logger;
+    private readonly _lifecycle;
+    private readonly _reactors;
+    private readonly _queues;
+    private _registered;
+    /**
+     * Creates a new {@link Reactors} instance.
+     * @param _clientArtifacts - Provider for discovered client artifact types.
+     * @param _connection - The Chronicle gRPC connection.
+     * @param _eventStoreName - The name of the event store.
+     * @param _namespace - The namespace within the event store.
+     * @param lifecycle - The connection lifecycle used to react to disconnect events.
+     */
+    constructor(_clientArtifacts: IClientArtifactsProvider, _connection: ChronicleConnection, _eventStoreName: string, _namespace: string, lifecycle: ConnectionLifecycle);
+    /** @inheritdoc */
+    discover(): Promise<void>;
+    /** @inheritdoc */
+    register(): Promise<void>;
+    private startObservation;
+    private observeReactor;
+    private getEventTypesFor;
+    private disconnectAll;
+}
+//# sourceMappingURL=Reactors.d.ts.map

package/dist/Reactors/Reactors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Reactors.d.ts","sourceRoot":"","sources":["../../Reactors/Reactors.ts"],"names":[],"mappings":"AAGA,OAAO,kBAAkB,CAAC;AAI1B,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAMxE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAyExC;;;GAGG;AACH,qBAAa,QAAS,YAAW,SAAS;IAgBlC,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAlB/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2E;IACnG,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkC;IAC5D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiD;IACzE,OAAO,CAAC,WAAW,CAAS;IAE5B;;;;;;;OAOG;gBAEkB,gBAAgB,EAAE,wBAAwB,EAC1C,WAAW,EAAE,mBAAmB,EAChC,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,EACnC,SAAS,EAAE,mBAAmB;IAUlC,kBAAkB;IACZ,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAW/B,kBAAkB;IACZ,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB/B,OAAO,CAAC,gBAAgB;YAiBV,cAAc;IAyH5B,OAAO,CAAC,gBAAgB;IAuBxB,OAAO,CAAC,aAAa;CAMxB"}

package/dist/Reactors/Reactors.js

@@ -0,0 +1,279 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+import 'reflect-metadata';
+import { diag } from '@opentelemetry/api';
+import { ObservationState } from '@cratis/chronicle.contracts';
+import { getEventTypeMetadata } from '../Events/eventTypeDecorator';
+import { EventTypeId } from '../Events/EventTypeId';
+import { EventTypeGeneration } from '../Events/EventTypeGeneration';
+import { EventSequenceId } from '../EventSequences/EventSequenceId';
+import { getReactorMetadata } from './reactor';
+/** Expression used to partition reactor observations by event source ID. */
+const EVENT_SOURCE_ID_KEY = '$eventSourceId';
+/** Sentinel sequence number sent back when no event was successfully processed. */
+const SEQUENCE_NUMBER_UNAVAILABLE = 4294967295;
+/**
+ * A push-based async queue that implements {@link AsyncIterable} for use with nice-grpc
+ * bidirectional streaming. Values pushed via {@link send} are yielded in order to
+ * any consumer that iterates the queue.
+ */
+class AsyncQueue {
+    _queue = [];
+    _resolve = undefined;
+    _done = false;
+    /** Pushes a value into the queue. No-op if the queue has been completed. */
+    send(value) {
+        if (this._done)
+            return;
+        if (this._resolve) {
+            const resolve = this._resolve;
+            this._resolve = undefined;
+            resolve({ value, done: false });
+        }
+        else {
+            this._queue.push(value);
+        }
+    }
+    /** Signals that no more values will be pushed, causing consumers to finish iteration. */
+    complete() {
+        this._done = true;
+        if (this._resolve) {
+            this._resolve({ value: undefined, done: true });
+            this._resolve = undefined;
+        }
+    }
+    [Symbol.asyncIterator]() {
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        const self = this;
+        return {
+            next() {
+                if (self._queue.length > 0) {
+                    return Promise.resolve({ value: self._queue.shift(), done: false });
+                }
+                if (self._done) {
+                    return Promise.resolve({ value: undefined, done: true });
+                }
+                return new Promise(resolve => {
+                    self._resolve = resolve;
+                });
+            },
+            return() {
+                self._done = true;
+                if (self._resolve) {
+                    self._resolve({ value: undefined, done: true });
+                    self._resolve = undefined;
+                }
+                return Promise.resolve({ value: undefined, done: true });
+            }
+        };
+    }
+}
+/**
+ * Implements {@link IReactors}, managing discovery and registration of reactors
+ * with the Chronicle Kernel via bidirectional gRPC streaming.
+ */
+export class Reactors {
+    _clientArtifacts;
+    _connection;
+    _eventStoreName;
+    _namespace;
+    _logger = diag.createComponentLogger({ namespace: '@cratis/chronicle/Reactors' });
+    _lifecycle;
+    _reactors = new Map();
+    _queues = new Map();
+    _registered = false;
+    /**
+     * Creates a new {@link Reactors} instance.
+     * @param _clientArtifacts - Provider for discovered client artifact types.
+     * @param _connection - The Chronicle gRPC connection.
+     * @param _eventStoreName - The name of the event store.
+     * @param _namespace - The namespace within the event store.
+     * @param lifecycle - The connection lifecycle used to react to disconnect events.
+     */
+    constructor(_clientArtifacts, _connection, _eventStoreName, _namespace, lifecycle) {
+        this._clientArtifacts = _clientArtifacts;
+        this._connection = _connection;
+        this._eventStoreName = _eventStoreName;
+        this._namespace = _namespace;
+        this._lifecycle = lifecycle;
+        lifecycle.onDisconnected(async () => {
+            this._logger.info('Disconnected — stopping all reactor observations');
+            this._registered = false;
+            this.disconnectAll();
+        });
+    }
+    /** @inheritdoc */
+    async discover() {
+        this._reactors.clear();
+        for (const type of this._clientArtifacts.reactors) {
+            const metadata = getReactorMetadata(type);
+            if (metadata) {
+                this._reactors.set(metadata.id.value, type);
+                this._logger.debug('Discovered reactor', { reactorId: metadata.id.value, type: type.name });
+            }
+        }
+    }
+    /** @inheritdoc */
+    async register() {
+        if (this._registered) {
+            return;
+        }
+        if (this._reactors.size === 0) {
+            await this.discover();
+        }
+        this._logger.info('Registering reactors', { count: this._reactors.size });
+        for (const [id, reactorType] of this._reactors) {
+            this.startObservation(id, reactorType);
+        }
+        this._registered = true;
+    }
+    startObservation(id, reactorType) {
+        const metadata = getReactorMetadata(reactorType);
+        const eventSequenceId = metadata.eventSequenceId ?? EventSequenceId.eventLog.value;
+        const eventTypes = this.getEventTypesFor(reactorType);
+        this._logger.info('Starting reactor observation', {
+            reactorId: id,
+            eventSequenceId,
+            handlerCount: eventTypes.length,
+            handlers: eventTypes.map(e => e.methodName)
+        });
+        this.observeReactor(id, reactorType, eventSequenceId, eventTypes).catch(err => {
+            this._logger.error('Reactor observation loop exited with error', { reactorId: id, error: String(err) });
+        });
+    }
+    async observeReactor(id, reactorType, eventSequenceId, eventTypes) {
+        const queue = new AsyncQueue();
+        this._queues.set(id, queue);
+        queue.send({
+            Content: {
+                Value0: {
+                    ConnectionId: this._lifecycle.connectionId,
+                    EventStore: this._eventStoreName,
+                    Namespace: this._namespace,
+                    Reactor: {
+                        ReactorId: id,
+                        EventSequenceId: eventSequenceId,
+                        EventTypes: eventTypes.map(et => ({
+                            EventType: { Id: et.id, Generation: et.generation, Tombstone: false },
+                            Key: EVENT_SOURCE_ID_KEY
+                        })),
+                        IsReplayable: false,
+                        Tags: [],
+                        Filters: {
+                            FilterTags: [],
+                            EventSourceType: '',
+                            EventStreamType: 'All'
+                        }
+                    }
+                },
+                Value1: undefined
+            }
+        });
+        try {
+            const reactorInstance = new reactorType();
+            for await (const eventsToObserve of this._connection.reactors.observe(queue)) {
+                let lastSuccessfullyObservedEvent = SEQUENCE_NUMBER_UNAVAILABLE;
+                let state = ObservationState.Success;
+                const exceptionMessages = [];
+                let exceptionStackTrace = '';
+                this._logger.debug('Received events to observe', {
+                    reactorId: id,
+                    partition: eventsToObserve.Partition,
+                    count: eventsToObserve.Events.length
+                });
+                for (const event of eventsToObserve.Events) {
+                    try {
+                        const eventTypeId = event.Context?.EventType?.Id;
+                        if (!eventTypeId) {
+                            this._logger.warn('Event missing event type context', { reactorId: id });
+                            continue;
+                        }
+                        const entry = eventTypes.find(et => et.id === eventTypeId);
+                        if (!entry) {
+                            this._logger.debug('No handler registered for event type — skipping', { reactorId: id, eventTypeId });
+                            lastSuccessfullyObservedEvent = event.Context.SequenceNumber;
+                            continue;
+                        }
+                        const content = JSON.parse(event.Content);
+                        const context = {
+                            sequenceNumber: event.Context.SequenceNumber,
+                            eventSourceId: event.Context.EventSourceId,
+                            eventType: {
+                                id: new EventTypeId(event.Context.EventType.Id),
+                                generation: new EventTypeGeneration(event.Context.EventType.Generation),
+                                tombstone: event.Context.EventType.Tombstone
+                            },
+                            occurred: new Date(event.Context.Occurred?.Value ?? ''),
+                            correlationId: event.Context?.CorrelationId ? `${event.Context.CorrelationId.lo}-${event.Context.CorrelationId.hi}` : '',
+                            causation: []
+                        };
+                        this._logger.info('Invoking reactor handler', {
+                            reactorId: id,
+                            method: entry.methodName,
+                            sequenceNumber: event.Context.SequenceNumber,
+                            eventTypeId
+                        });
+                        await reactorInstance[entry.methodName](content, context);
+                        lastSuccessfullyObservedEvent = event.Context.SequenceNumber;
+                    }
+                    catch (err) {
+                        this._logger.error('Error handling event in reactor', { reactorId: id, error: String(err) });
+                        exceptionMessages.push(String(err));
+                        exceptionStackTrace = err instanceof Error ? (err.stack ?? '') : '';
+                        state = ObservationState.Failed;
+                        break;
+                    }
+                }
+                queue.send({
+                    Content: {
+                        Value0: undefined,
+                        Value1: {
+                            Partition: eventsToObserve.Partition,
+                            State: state,
+                            LastSuccessfulObservation: lastSuccessfullyObservedEvent,
+                            ExceptionMessages: exceptionMessages,
+                            ExceptionStackTrace: exceptionStackTrace
+                        }
+                    }
+                });
+            }
+        }
+        catch (err) {
+            if (!this._queues.has(id)) {
+                this._logger.debug('Reactor observation stream closed cleanly', { reactorId: id });
+            }
+            else {
+                this._logger.error('Reactor observation stream ended unexpectedly', { reactorId: id, error: String(err) });
+            }
+        }
+        finally {
+            this._queues.delete(id);
+        }
+    }
+    getEventTypesFor(reactorType) {
+        const proto = reactorType.prototype;
+        const entries = [];
+        for (const eventTypeClass of this._clientArtifacts.eventTypes) {
+            const eventTypeMeta = getEventTypeMetadata(eventTypeClass);
+            if (!eventTypeMeta)
+                continue;
+            const className = eventTypeClass.name;
+            const methodName = className.charAt(0).toLowerCase() + className.slice(1);
+            if (typeof proto[methodName] === 'function') {
+                entries.push({
+                    id: eventTypeMeta.eventType.id.value,
+                    generation: eventTypeMeta.eventType.generation.value,
+                    methodName
+                });
+            }
+        }
+        return entries;
+    }
+    disconnectAll() {
+        for (const queue of this._queues.values()) {
+            queue.complete();
+        }
+        this._queues.clear();
+    }
+}
+//# sourceMappingURL=Reactors.js.map

package/dist/Reactors/Reactors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Reactors.js","sourceRoot":"","sources":["../../Reactors/Reactors.ts"],"names":[],"mappings":"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"}

package/dist/Reactors/index.d.ts

@@ -0,0 +1,6 @@
+export { ReactorId } from './ReactorId';
+export { reactor, getReactorMetadata, isReactor } from './reactor';
+export type { ReactorMetadata } from './reactor';
+export type { IReactors } from './IReactors';
+export { Reactors } from './Reactors';
+//# sourceMappingURL=index.d.ts.map

package/dist/Reactors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../Reactors/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACnE,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/Reactors/index.js

@@ -0,0 +1,6 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+export { ReactorId } from './ReactorId';
+export { reactor, getReactorMetadata, isReactor } from './reactor';
+export { Reactors } from './Reactors';
+//# sourceMappingURL=index.js.map

package/dist/Reactors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../Reactors/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGnE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/Reactors/reactor.d.ts

@@ -0,0 +1,47 @@
+import 'reflect-metadata';
+import { ReactorId } from './ReactorId';
+/**
+ * Metadata stored on a reactor class.
+ */
+export interface ReactorMetadata {
+    /** The unique identifier for the reactor. */
+    readonly id: ReactorId;
+    /** The optional explicit event sequence identifier. */
+    readonly eventSequenceId: string | undefined;
+}
+/**
+ * TypeScript decorator that marks a class as a reactor and associates it with a unique
+ * identifier. This is the TypeScript equivalent of the C# `[Reactor]` attribute.
+ *
+ * Reactors observe events from an event sequence and produce side effects.
+ * Method dispatch is by convention: the type of the first parameter of each public method
+ * determines which events it handles.
+ *
+ * @param id - The unique identifier for the reactor. Defaults to the class name if omitted.
+ * @param eventSequenceId - Optional explicit event sequence identifier.
+ * @returns A class decorator.
+ *
+ * @example
+ * ```typescript
+ * @reactor()
+ * class ProjectRegisteredNotifier {
+ *     async projectRegistered(event: ProjectRegistered, context: EventContext): Promise<void> {
+ *         console.log(`Project '${event.name}' was registered.`);
+ *     }
+ * }
+ * ```
+ */
+export declare function reactor(id?: string, eventSequenceId?: string): ClassDecorator;
+/**
+ * Gets the {@link ReactorMetadata} associated with a class decorated with {@link reactor}.
+ * @param target - The class constructor to retrieve the metadata for.
+ * @returns The associated ReactorMetadata, or undefined if not decorated.
+ */
+export declare function getReactorMetadata(target: Function): ReactorMetadata | undefined;
+/**
+ * Checks whether a class has been decorated with {@link reactor}.
+ * @param target - The class constructor to check.
+ * @returns True if the class has a reactor decorator; false otherwise.
+ */
+export declare function isReactor(target: Function): boolean;
+//# sourceMappingURL=reactor.d.ts.map

package/dist/Reactors/reactor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactor.d.ts","sourceRoot":"","sources":["../../Reactors/reactor.ts"],"names":[],"mappings":"AAGA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAMxC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC;IAEvB,uDAAuD;IACvD,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;CAChD;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,OAAO,CAAC,EAAE,GAAE,MAAW,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,cAAc,CAYjF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,QAAQ,GAAG,eAAe,GAAG,SAAS,CAEhF;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAEnD"}

package/dist/Reactors/reactor.js

@@ -0,0 +1,55 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+import 'reflect-metadata';
+import { ReactorId } from './ReactorId';
+import { DecoratorType, TypeDiscoverer } from '../types';
+/** Metadata key used to store reactor information on a class. */
+const REACTOR_METADATA_KEY = 'chronicle:reactor';
+/**
+ * TypeScript decorator that marks a class as a reactor and associates it with a unique
+ * identifier. This is the TypeScript equivalent of the C# `[Reactor]` attribute.
+ *
+ * Reactors observe events from an event sequence and produce side effects.
+ * Method dispatch is by convention: the type of the first parameter of each public method
+ * determines which events it handles.
+ *
+ * @param id - The unique identifier for the reactor. Defaults to the class name if omitted.
+ * @param eventSequenceId - Optional explicit event sequence identifier.
+ * @returns A class decorator.
+ *
+ * @example
+ * ```typescript
+ * @reactor()
+ * class ProjectRegisteredNotifier {
+ *     async projectRegistered(event: ProjectRegistered, context: EventContext): Promise<void> {
+ *         console.log(`Project '${event.name}' was registered.`);
+ *     }
+ * }
+ * ```
+ */
+export function reactor(id = '', eventSequenceId) {
+    return (target) => {
+        const constructor = target;
+        const reactorId = new ReactorId(id || constructor.name);
+        const metadata = { id: reactorId, eventSequenceId };
+        Reflect.defineMetadata(REACTOR_METADATA_KEY, metadata, target);
+        TypeDiscoverer.default.register(DecoratorType.Reactor, constructor, reactorId.value);
+    };
+}
+/**
+ * Gets the {@link ReactorMetadata} associated with a class decorated with {@link reactor}.
+ * @param target - The class constructor to retrieve the metadata for.
+ * @returns The associated ReactorMetadata, or undefined if not decorated.
+ */
+export function getReactorMetadata(target) {
+    return Reflect.getMetadata(REACTOR_METADATA_KEY, target);
+}
+/**
+ * Checks whether a class has been decorated with {@link reactor}.
+ * @param target - The class constructor to check.
+ * @returns True if the class has a reactor decorator; false otherwise.
+ */
+export function isReactor(target) {
+    return Reflect.hasMetadata(REACTOR_METADATA_KEY, target);
+}
+//# sourceMappingURL=reactor.js.map

package/dist/Reactors/reactor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactor.js","sourceRoot":"","sources":["../../Reactors/reactor.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAEzD,iEAAiE;AACjE,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;AAajD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,OAAO,CAAC,KAAa,EAAE,EAAE,eAAwB;IAC7D,OAAO,CAAC,MAAc,EAAE,EAAE;QACtB,MAAM,WAAW,GAAG,MAAkB,CAAC;QACvC,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;QACxD,MAAM,QAAQ,GAAoB,EAAE,EAAE,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC;QACrE,OAAO,CAAC,cAAc,CAAC,oBAAoB,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC/D,cAAc,CAAC,OAAO,CAAC,QAAQ,CAC3B,aAAa,CAAC,OAAO,EACrB,WAA0B,EAC1B,SAAS,CAAC,KAAK,CAClB,CAAC;IACN,CAAC,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAgB;IAC/C,OAAO,OAAO,CAAC,WAAW,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;AAC7D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,MAAgB;IACtC,OAAO,OAAO,CAAC,WAAW,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;AAC7D,CAAC"}

package/dist/ReadModels/ReadModelId.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Unique identifier for a read model.
+ */
+export declare class ReadModelId {
+    readonly value: string;
+    constructor(value: string);
+    /** @inheritdoc */
+    toString(): string;
+}
+//# sourceMappingURL=ReadModelId.d.ts.map

package/dist/ReadModels/ReadModelId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReadModelId.d.ts","sourceRoot":"","sources":["../../ReadModels/ReadModelId.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,qBAAa,WAAW;IACR,QAAQ,CAAC,KAAK,EAAE,MAAM;gBAAb,KAAK,EAAE,MAAM;IAElC,kBAAkB;IAClB,QAAQ,IAAI,MAAM;CAGrB"}

package/dist/ReadModels/ReadModelId.js

@@ -0,0 +1,16 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/**
+ * Unique identifier for a read model.
+ */
+export class ReadModelId {
+    value;
+    constructor(value) {
+        this.value = value;
+    }
+    /** @inheritdoc */
+    toString() {
+        return this.value;
+    }
+}
+//# sourceMappingURL=ReadModelId.js.map

package/dist/ReadModels/ReadModelId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReadModelId.js","sourceRoot":"","sources":["../../ReadModels/ReadModelId.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG;;GAEG;AACH,MAAM,OAAO,WAAW;IACC;IAArB,YAAqB,KAAa;QAAb,UAAK,GAAL,KAAK,CAAQ;IAAG,CAAC;IAEtC,kBAAkB;IAClB,QAAQ;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;CACJ"}