@cratis/chronicle 0.0.1

package/dist/ReadModels/index.d.ts

@@ -0,0 +1,4 @@
+export { ReadModelId } from './ReadModelId';
+export { readModel, getReadModelMetadata, isReadModel } from './readModel';
+export type { ReadModelMetadata } from './readModel';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../ReadModels/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC3E,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/ReadModels/index.js

@@ -0,0 +1,5 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+export { ReadModelId } from './ReadModelId';
+export { readModel, getReadModelMetadata, isReadModel } from './readModel';
+//# sourceMappingURL=index.js.map

package/dist/ReadModels/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../ReadModels/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/ReadModels/readModel.d.ts

@@ -0,0 +1,33 @@
+import 'reflect-metadata';
+import { ReadModelId } from './ReadModelId';
+import { JsonSchema } from '../Schemas';
+/**
+ * Metadata stored on a read model class.
+ */
+export interface ReadModelMetadata {
+    /** The unique identifier for the read model. */
+    readonly id: ReadModelId;
+    /** The reflected members and their runtime types. */
+    readonly members: ReadonlyMap<string, Function | undefined>;
+    /** The generated JSON schema for the read model. */
+    readonly schema: JsonSchema;
+}
+/**
+ * TypeScript decorator that marks a class as a read model and captures reflection metadata.
+ * @param id - The unique identifier for the read model. Defaults to the class name if omitted.
+ * @returns A class decorator.
+ */
+export declare function readModel(id?: string): ClassDecorator;
+/**
+ * Gets the {@link ReadModelMetadata} associated with a class decorated with {@link readModel}.
+ * @param target - The class constructor to retrieve metadata for.
+ * @returns The associated metadata, or undefined if not decorated.
+ */
+export declare function getReadModelMetadata(target: Function): ReadModelMetadata | undefined;
+/**
+ * Checks whether a class has been decorated with {@link readModel}.
+ * @param target - The class constructor to check.
+ * @returns True if the class has a read model decorator; false otherwise.
+ */
+export declare function isReadModel(target: Function): boolean;
+//# sourceMappingURL=readModel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"readModel.d.ts","sourceRoot":"","sources":["../../ReadModels/readModel.ts"],"names":[],"mappings":"AAGA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,UAAU,EAAuB,MAAM,YAAY,CAAC;AAK7D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,gDAAgD;IAChD,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC;IAEzB,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC;IAE5D,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,EAAE,GAAE,MAAW,GAAG,cAAc,CAkBzD;AAuBD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,QAAQ,GAAG,iBAAiB,GAAG,SAAS,CAEpF;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAErD"}

package/dist/ReadModels/readModel.js

@@ -0,0 +1,64 @@
+// 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 { ReadModelId } from './ReadModelId';
+import { DecoratorType, TypeDiscoverer, TypeIntrospector } from '../types';
+import { JsonSchemaGenerator } from '../Schemas';
+/** Metadata key used to store read model information on a class. */
+const READ_MODEL_METADATA_KEY = 'chronicle:readModel';
+/**
+ * TypeScript decorator that marks a class as a read model and captures reflection metadata.
+ * @param id - The unique identifier for the read model. Defaults to the class name if omitted.
+ * @returns A class decorator.
+ */
+export function readModel(id = '') {
+    return (target) => {
+        const constructor = target;
+        const readModelId = new ReadModelId(id || constructor.name);
+        trackInstanceProperties(constructor);
+        const members = TypeIntrospector.getMembers(constructor);
+        const metadata = {
+            id: readModelId,
+            members,
+            schema: JsonSchemaGenerator.generate(constructor, members)
+        };
+        Reflect.defineMetadata(READ_MODEL_METADATA_KEY, metadata, target);
+        TypeDiscoverer.default.register(DecoratorType.ReadModel, constructor, readModelId.value);
+    };
+}
+function trackInstanceProperties(constructor) {
+    const instance = tryCreateInstance(constructor);
+    if (!instance || typeof instance !== 'object') {
+        return;
+    }
+    for (const propertyName of Object.keys(instance)) {
+        TypeIntrospector.trackProperty(constructor, propertyName);
+    }
+}
+function tryCreateInstance(constructor) {
+    try {
+        const parameterCount = constructor.length;
+        const parameters = Array.from({ length: parameterCount }, () => undefined);
+        return Reflect.construct(constructor, parameters);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Gets the {@link ReadModelMetadata} associated with a class decorated with {@link readModel}.
+ * @param target - The class constructor to retrieve metadata for.
+ * @returns The associated metadata, or undefined if not decorated.
+ */
+export function getReadModelMetadata(target) {
+    return Reflect.getMetadata(READ_MODEL_METADATA_KEY, target);
+}
+/**
+ * Checks whether a class has been decorated with {@link readModel}.
+ * @param target - The class constructor to check.
+ * @returns True if the class has a read model decorator; false otherwise.
+ */
+export function isReadModel(target) {
+    return Reflect.hasMetadata(READ_MODEL_METADATA_KEY, target);
+}
+//# sourceMappingURL=readModel.js.map

package/dist/ReadModels/readModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readModel.js","sourceRoot":"","sources":["../../ReadModels/readModel.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAO,EAAc,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAE7D,oEAAoE;AACpE,MAAM,uBAAuB,GAAG,qBAAqB,CAAC;AAgBtD;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa,EAAE;IACrC,OAAO,CAAC,MAAc,EAAE,EAAE;QACtB,MAAM,WAAW,GAAG,MAAkB,CAAC;QACvC,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,EAAE,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;QAC5D,uBAAuB,CAAC,WAAW,CAAC,CAAC;QACrC,MAAM,OAAO,GAAG,gBAAgB,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QACzD,MAAM,QAAQ,GAAsB;YAChC,EAAE,EAAE,WAAW;YACf,OAAO;YACP,MAAM,EAAE,mBAAmB,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;SAC7D,CAAC;QACF,OAAO,CAAC,cAAc,CAAC,uBAAuB,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAClE,cAAc,CAAC,OAAO,CAAC,QAAQ,CAC3B,aAAa,CAAC,SAAS,EACvB,WAA0B,EAC1B,WAAW,CAAC,KAAK,CACpB,CAAC;IACN,CAAC,CAAC;AACN,CAAC;AAED,SAAS,uBAAuB,CAAC,WAAqB;IAClD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAChD,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC5C,OAAO;IACX,CAAC;IAED,KAAK,MAAM,YAAY,IAAI,MAAM,CAAC,IAAI,CAAC,QAAmC,CAAC,EAAE,CAAC;QAC1E,gBAAgB,CAAC,aAAa,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAC9D,CAAC;AACL,CAAC;AAED,SAAS,iBAAiB,CAAC,WAAqB;IAC5C,IAAI,CAAC;QACD,MAAM,cAAc,GAAG,WAAW,CAAC,MAAM,CAAC;QAC1C,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC3E,OAAO,OAAO,CAAC,SAAS,CAAC,WAAkD,EAAE,UAAU,CAAC,CAAC;IAC7F,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,SAAS,CAAC;IACrB,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAgB;IACjD,OAAO,OAAO,CAAC,WAAW,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAAC;AAChE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,MAAgB;IACxC,OAAO,OAAO,CAAC,WAAW,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAAC;AAChE,CAAC"}

package/dist/Reducers/IReducers.d.ts

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

package/dist/Reducers/IReducers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IReducers.d.ts","sourceRoot":"","sources":["../../Reducers/IReducers.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/Reducers/IReducers.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=IReducers.js.map

package/dist/Reducers/IReducers.js.map

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

package/dist/Reducers/ReducerId.d.ts

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

package/dist/Reducers/ReducerId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReducerId.d.ts","sourceRoot":"","sources":["../../Reducers/ReducerId.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/Reducers/ReducerId.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 reducer.
+ */
+export class ReducerId {
+    value;
+    constructor(value) {
+        this.value = value;
+    }
+    /** @inheritdoc */
+    toString() {
+        return this.value;
+    }
+}
+//# sourceMappingURL=ReducerId.js.map

package/dist/Reducers/ReducerId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReducerId.js","sourceRoot":"","sources":["../../Reducers/ReducerId.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/Reducers/Reducers.d.ts

@@ -0,0 +1,38 @@
+import 'reflect-metadata';
+import { IClientArtifactsProvider } from '../artifacts';
+import { ChronicleConnection } from '../connection';
+import { ConnectionLifecycle } from '../connection/ConnectionLifecycle';
+import { IReducers } from './IReducers';
+/**
+ * Implements {@link IReducers}, managing discovery and registration of reducers
+ * with the Chronicle Kernel via bidirectional gRPC streaming.
+ */
+export declare class Reducers implements IReducers {
+    private readonly _clientArtifacts;
+    private readonly _connection;
+    private readonly _eventStoreName;
+    private readonly _namespace;
+    private readonly _logger;
+    private readonly _lifecycle;
+    private readonly _reducers;
+    private readonly _queues;
+    private _registered;
+    /**
+     * Creates a new {@link Reducers} 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 observeReducer;
+    private getEventTypesFor;
+    private disconnectAll;
+}
+//# sourceMappingURL=Reducers.d.ts.map

package/dist/Reducers/Reducers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Reducers.d.ts","sourceRoot":"","sources":["../../Reducers/Reducers.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;AAGxE,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;YAmBV,cAAc;IA4H5B,OAAO,CAAC,gBAAgB;IAuBxB,OAAO,CAAC,aAAa;CAMxB"}

package/dist/Reducers/Reducers.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 { EventSequenceId } from '../EventSequences/EventSequenceId';
+import { getReducerMetadata } from './reducer';
+/** Expression used to partition reducer 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 IReducers}, managing discovery and registration of reducers
+ * with the Chronicle Kernel via bidirectional gRPC streaming.
+ */
+export class Reducers {
+    _clientArtifacts;
+    _connection;
+    _eventStoreName;
+    _namespace;
+    _logger = diag.createComponentLogger({ namespace: '@cratis/chronicle/Reducers' });
+    _lifecycle;
+    _reducers = new Map();
+    _queues = new Map();
+    _registered = false;
+    /**
+     * Creates a new {@link Reducers} 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 reducer observations');
+            this._registered = false;
+            this.disconnectAll();
+        });
+    }
+    /** @inheritdoc */
+    async discover() {
+        this._reducers.clear();
+        for (const type of this._clientArtifacts.reducers) {
+            const metadata = getReducerMetadata(type);
+            if (metadata) {
+                this._reducers.set(metadata.id.value, type);
+                this._logger.debug('Discovered reducer', { reducerId: metadata.id.value, type: type.name });
+            }
+        }
+    }
+    /** @inheritdoc */
+    async register() {
+        if (this._registered) {
+            return;
+        }
+        if (this._reducers.size === 0) {
+            await this.discover();
+        }
+        this._logger.info('Registering reducers', { count: this._reducers.size });
+        for (const [id, reducerType] of this._reducers) {
+            this.startObservation(id, reducerType);
+        }
+        this._registered = true;
+    }
+    startObservation(id, reducerType) {
+        const metadata = getReducerMetadata(reducerType);
+        const eventSequenceId = metadata.eventSequenceId ?? EventSequenceId.eventLog.value;
+        const eventTypes = this.getEventTypesFor(reducerType);
+        const readModelName = reducerType.name;
+        this._logger.info('Starting reducer observation', {
+            reducerId: id,
+            eventSequenceId,
+            readModel: readModelName,
+            handlerCount: eventTypes.length,
+            handlers: eventTypes.map(e => e.methodName)
+        });
+        this.observeReducer(id, reducerType, eventSequenceId, eventTypes, readModelName).catch(err => {
+            this._logger.error('Reducer observation loop exited with error', { reducerId: id, error: String(err) });
+        });
+    }
+    async observeReducer(id, reducerType, eventSequenceId, eventTypes, readModelName) {
+        const queue = new AsyncQueue();
+        this._queues.set(id, queue);
+        queue.send({
+            Content: {
+                Value0: {
+                    ConnectionId: this._lifecycle.connectionId,
+                    EventStore: this._eventStoreName,
+                    Namespace: this._namespace,
+                    Reducer: {
+                        ReducerId: id,
+                        EventSequenceId: eventSequenceId,
+                        EventTypes: eventTypes.map(et => ({
+                            EventType: { Id: et.id, Generation: et.generation, Tombstone: false },
+                            Key: EVENT_SOURCE_ID_KEY
+                        })),
+                        ReadModel: readModelName,
+                        IsActive: true,
+                        Sink: { TypeId: { lo: 0, hi: 0 }, ConfigurationId: undefined },
+                        Tags: [],
+                        Filters: {
+                            FilterTags: [],
+                            EventSourceType: '',
+                            EventStreamType: 'All'
+                        }
+                    }
+                },
+                Value1: undefined
+            }
+        });
+        try {
+            const reducerInstance = new reducerType();
+            for await (const operation of this._connection.reducers.observe(queue)) {
+                let lastSuccessfullyObservedEvent = SEQUENCE_NUMBER_UNAVAILABLE;
+                let state = ObservationState.Success;
+                const exceptionMessages = [];
+                let exceptionStackTrace = '';
+                let readModelState;
+                this._logger.debug('Received reduce operation', {
+                    reducerId: id,
+                    partition: operation.Partition,
+                    count: operation.Events.length,
+                    hasInitialState: operation.InitialState !== ''
+                });
+                let currentState = operation.InitialState
+                    ? JSON.parse(operation.InitialState)
+                    : undefined;
+                for (const event of operation.Events) {
+                    try {
+                        const eventTypeId = event.Context?.EventType?.Id;
+                        if (!eventTypeId) {
+                            this._logger.warn('Event missing event type context', { reducerId: id });
+                            continue;
+                        }
+                        const entry = eventTypes.find(et => et.id === eventTypeId);
+                        if (!entry) {
+                            this._logger.debug('No handler registered for event type — skipping', { reducerId: id, eventTypeId });
+                            lastSuccessfullyObservedEvent = event.Context.SequenceNumber;
+                            continue;
+                        }
+                        const content = JSON.parse(event.Content);
+                        this._logger.info('Invoking reducer handler', {
+                            reducerId: id,
+                            method: entry.methodName,
+                            sequenceNumber: event.Context.SequenceNumber,
+                            eventTypeId,
+                            hasState: currentState !== undefined
+                        });
+                        currentState = await reducerInstance[entry.methodName](content, currentState);
+                        lastSuccessfullyObservedEvent = event.Context.SequenceNumber;
+                    }
+                    catch (err) {
+                        this._logger.error('Error handling event in reducer', { reducerId: id, error: String(err) });
+                        exceptionMessages.push(String(err));
+                        exceptionStackTrace = err instanceof Error ? (err.stack ?? '') : '';
+                        state = ObservationState.Failed;
+                        break;
+                    }
+                }
+                if (state === ObservationState.Success && currentState !== undefined) {
+                    readModelState = JSON.stringify(currentState);
+                }
+                queue.send({
+                    Content: {
+                        Value0: undefined,
+                        Value1: {
+                            Partition: operation.Partition,
+                            State: state,
+                            LastSuccessfulObservation: lastSuccessfullyObservedEvent,
+                            ExceptionMessages: exceptionMessages,
+                            ExceptionStackTrace: exceptionStackTrace,
+                            ReadModelState: readModelState ?? ''
+                        }
+                    }
+                });
+            }
+        }
+        catch (err) {
+            if (!this._queues.has(id)) {
+                this._logger.debug('Reducer observation stream closed cleanly', { reducerId: id });
+            }
+            else {
+                this._logger.error('Reducer observation stream ended unexpectedly', { reducerId: id, error: String(err) });
+            }
+        }
+        finally {
+            this._queues.delete(id);
+        }
+    }
+    getEventTypesFor(reducerType) {
+        const proto = reducerType.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=Reducers.js.map

package/dist/Reducers/Reducers.js.map

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

package/dist/Reducers/index.d.ts

@@ -0,0 +1,6 @@
+export { ReducerId } from './ReducerId';
+export { reducer, getReducerMetadata, isReducer } from './reducer';
+export type { ReducerMetadata } from './reducer';
+export type { IReducers } from './IReducers';
+export { Reducers } from './Reducers';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../Reducers/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/Reducers/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 { ReducerId } from './ReducerId';
+export { reducer, getReducerMetadata, isReducer } from './reducer';
+export { Reducers } from './Reducers';
+//# sourceMappingURL=index.js.map

package/dist/Reducers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../Reducers/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/Reducers/reducer.d.ts

@@ -0,0 +1,51 @@
+import 'reflect-metadata';
+import { Constructor } from '@cratis/fundamentals';
+import { ReducerId } from './ReducerId';
+/**
+ * Metadata stored on a reducer class.
+ */
+export interface ReducerMetadata {
+    /** The unique identifier for the reducer. */
+    readonly id: ReducerId;
+    /** The optional explicit event sequence identifier. */
+    readonly eventSequenceId: string | undefined;
+    /** The optional read model type produced by the reducer. */
+    readonly readModel: Constructor | undefined;
+}
+/**
+ * TypeScript decorator that marks a class as a reducer and associates it with a unique
+ * identifier. This is the TypeScript equivalent of the C# `[Reducer]` attribute.
+ *
+ * Reducers observe events from an event sequence and fold them into a read model.
+ * Each handler method receives the event, the current state (or undefined), and an
+ * optional context, and returns the new state.
+ *
+ * @param id - The unique identifier for the reducer. Defaults to the class name if omitted.
+ * @param eventSequenceId - Optional explicit event sequence identifier.
+ * @param readModel - Optional read model type produced by the reducer.
+ * @returns A class decorator.
+ *
+ * @example
+ * ```typescript
+ * @reducer()
+ * class EmployeeReducer {
+ *     async employeeHired(event: EmployeeHired, state?: EmployeeState): Promise<EmployeeState> {
+ *         return { ...state, name: `${event.firstName} ${event.lastName}` };
+ *     }
+ * }
+ * ```
+ */
+export declare function reducer(id?: string, eventSequenceId?: string, readModel?: Constructor): ClassDecorator;
+/**
+ * Gets the {@link ReducerMetadata} associated with a class decorated with {@link reducer}.
+ * @param target - The class constructor to retrieve the metadata for.
+ * @returns The associated ReducerMetadata, or undefined if not decorated.
+ */
+export declare function getReducerMetadata(target: Function): ReducerMetadata | undefined;
+/**
+ * Checks whether a class has been decorated with {@link reducer}.
+ * @param target - The class constructor to check.
+ * @returns True if the class has a reducer decorator; false otherwise.
+ */
+export declare function isReducer(target: Function): boolean;
+//# sourceMappingURL=reducer.d.ts.map

package/dist/Reducers/reducer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reducer.d.ts","sourceRoot":"","sources":["../../Reducers/reducer.ts"],"names":[],"mappings":"AAGA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,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;IAE7C,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,EAAE,WAAW,GAAG,SAAS,CAAC;CAC/C;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,OAAO,CAAC,EAAE,GAAE,MAAW,EAAE,eAAe,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,WAAW,GAAG,cAAc,CAoB1G;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"}