node-cqrs 0.16.4 → 1.0.0-beta.0

package/dist/esm/AggregateCommandHandler.js.map

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

package/dist/esm/CommandBus.js

@@ -0,0 +1,5 @@
+import { InMemoryMessageBus } from "./in-memory/index.js";
+/** @deprecated Use {@link InMemoryMessageBus} directly or a transport-specific implementation. */
+export class CommandBus extends InMemoryMessageBus {
+}
+//# sourceMappingURL=CommandBus.js.map

package/dist/esm/CommandBus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandBus.js","sourceRoot":"","sources":["../../src/CommandBus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,kGAAkG;AAClG,MAAM,OAAO,UAAW,SAAQ,kBAAkB;CAAI"}

package/dist/esm/CqrsContainerBuilder.js

@@ -0,0 +1,93 @@
+import { ContainerBuilder } from 'di0';
+import { AggregateCommandHandler } from "./AggregateCommandHandler.js";
+import { EventStore } from "./EventStore.js";
+import { SagaEventHandler } from "./SagaEventHandler.js";
+import { EventDispatcher } from "./EventDispatcher.js";
+import { InMemoryMessageBus } from "./in-memory/index.js";
+import { isDispatchPipelineProcessor, isExecutionLocker, isAggregateSnapshotStorage, isIdentifierProvider, isEventStorageReader } from "./interfaces/index.js";
+import { assertClass, assertFunction } from "./utils/assert.js";
+export class CqrsContainerBuilder extends ContainerBuilder {
+    constructor(options) {
+        super(options);
+        super.addResolver(isIdentifierProvider, 'identifierProvider');
+        // Reader alias consumed by EventStore constructor
+        super.addResolver(isEventStorageReader, 'eventStorageReader');
+        // Storage alias used in dispatch pipelines (write/persist role)
+        super.addResolver(isEventStorageReader, 'eventStorage');
+        super.addResolver(isAggregateSnapshotStorage, 'snapshotStorage');
+        super.addResolver(isExecutionLocker, 'executionLocker');
+        super.register(InMemoryMessageBus).as('commandBus');
+        super.register(InMemoryMessageBus).as('eventBus');
+        super.register(EventStore).as('eventStore');
+        super.register(EventDispatcher).as('eventDispatcher');
+        super.register(c => [
+            // automatically add eventStorage and snapshotStorage to the default dispatch pipeline
+            // if they're registered in the DI container and implement IDispatchPipelineProcessor
+            ...isDispatchPipelineProcessor(c.eventIdAugmenter) ? [c.eventIdAugmenter] : [],
+            ...isDispatchPipelineProcessor(c.eventStorage) ? [c.eventStorage] : [],
+            ...isDispatchPipelineProcessor(c.snapshotStorage) ? [c.snapshotStorage] : []
+        ]).as('eventDispatchPipeline');
+    }
+    /** Register command handler, which will be subscribed to commandBus upon instance creation */
+    registerCommandHandler(typeOrFactory) {
+        return super.register((container) => {
+            const handler = container.createInstance(typeOrFactory);
+            handler.subscribe(container.commandBus);
+            return handler;
+        });
+    }
+    /** Register event receptor, which will be subscribed to eventStore upon instance creation */
+    registerEventReceptor(typeOrFactory) {
+        return super.register((container) => {
+            const receptor = container.createInstance(typeOrFactory);
+            receptor.subscribe(container.eventStore);
+            return receptor;
+        });
+    }
+    /**
+     * Register projection, which will expose view and will be subscribed
+     * to eventStore and will restore its state upon instance creation
+     */
+    registerProjection(typeOrFactory, exposedViewAlias) {
+        assertFunction(typeOrFactory, 'typeOrFactory');
+        const projectionFactory = (container) => {
+            const projection = container.createInstance(typeOrFactory);
+            projection.subscribe(container.eventStore);
+            // start async projection restoring
+            void projection.restore(container.eventStore);
+            if (exposedViewAlias)
+                return projection.view;
+            return projection;
+        };
+        const t = super.register(projectionFactory).asSingleInstance();
+        if (exposedViewAlias)
+            t.as(exposedViewAlias);
+        return t;
+    }
+    /** Register aggregate type in the container */
+    registerAggregate(AggregateType) {
+        assertClass(AggregateType, 'AggregateType');
+        const commandHandlerFactory = (container) => container.createInstance(AggregateCommandHandler, {
+            aggregateFactory: (options) => container.createInstance(AggregateType, options),
+            handles: AggregateType.handles,
+            restoresFrom: AggregateType.restoresFrom,
+            ...AggregateType.retryOnConcurrencyError !== undefined && {
+                retryOnConcurrencyError: AggregateType.retryOnConcurrencyError
+            }
+        });
+        return this.registerCommandHandler(commandHandlerFactory);
+    }
+    /** Register saga type in the container */
+    registerSaga(SagaType) {
+        assertClass(SagaType, 'SagaType');
+        const eventReceptorFactory = (container) => container.createInstance(SagaEventHandler, {
+            sagaFactory: (options) => container.createInstance(SagaType, options),
+            sagaDescriptor: SagaType.sagaDescriptor ?? SagaType.name,
+            handles: SagaType.handles,
+            startsWith: SagaType.startsWith,
+            queueName: SagaType.name
+        });
+        return this.registerEventReceptor(eventReceptorFactory);
+    }
+}
+//# sourceMappingURL=CqrsContainerBuilder.js.map

package/dist/esm/CqrsContainerBuilder.js.map

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

package/dist/esm/Event.js

@@ -0,0 +1,15 @@
+/**
+ * Get text description of an event for logging purposes
+ */
+export function describe(event) {
+    return `'${event.type}' of ${event.aggregateId} (v${event.aggregateVersion})`;
+}
+/**
+ * Get text description of a set of events for logging purposes
+ */
+export function describeMultiple(events) {
+    if (events.length === 1)
+        return describe(events[0]);
+    return `${events.length} events`;
+}
+//# sourceMappingURL=Event.js.map

package/dist/esm/Event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Event.js","sourceRoot":"","sources":["../../src/Event.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAa;IACrC,OAAO,IAAI,KAAK,CAAC,IAAI,QAAQ,KAAK,CAAC,WAAW,MAAM,KAAK,CAAC,gBAAgB,GAAG,CAAC;AAC/E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAA6B;IAC7D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QACtB,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAE5B,OAAO,GAAG,MAAM,CAAC,MAAM,SAAS,CAAC;AAClC,CAAC"}

package/dist/esm/EventDispatchPipeline.js

@@ -0,0 +1,79 @@
+import { isDispatchPipelineProcessor, isSnapshotEvent } from "./interfaces/index.js";
+import { parallelPipe } from 'async-parallel-pipe';
+import { AsyncIterableBuffer } from 'async-iterable-buffer';
+import { getClassName } from "./utils/index.js";
+export class EventDispatchPipeline {
+    #pipelineInput = new AsyncIterableBuffer();
+    #processors = [];
+    #pipeline = this.#pipelineInput;
+    #processing = false;
+    #eventBus;
+    #concurrentLimit;
+    constructor(eventBus, concurrentLimit) {
+        this.#eventBus = eventBus;
+        this.#concurrentLimit = concurrentLimit;
+    }
+    addProcessor(preprocessor) {
+        if (!isDispatchPipelineProcessor(preprocessor))
+            throw new TypeError(`preprocessor ${getClassName(preprocessor)} does not implement IDispatchPipelineProcessor`);
+        if (this.#processing)
+            throw new Error('pipeline processing already started');
+        this.#processors.push(preprocessor);
+        // Build a processing pipeline that runs preprocessors concurrently, preserving FIFO ordering
+        this.#pipeline = parallelPipe(this.#pipeline, this.#concurrentLimit, async (envelope) => {
+            if (envelope.error)
+                return envelope;
+            try {
+                return {
+                    ...envelope,
+                    data: await preprocessor.process(envelope.data)
+                };
+            }
+            catch (error) {
+                return {
+                    ...envelope,
+                    error
+                };
+            }
+        });
+    }
+    #ensureProcessingStarted() {
+        if (this.#processing)
+            return;
+        this.#processing = true;
+        (async () => {
+            for await (const { error, reject, data, resolve } of this.#pipeline) {
+                try {
+                    if (error) {
+                        await this.revert(data);
+                        reject(error);
+                        continue;
+                    }
+                    const events = [];
+                    for (const batch of data) {
+                        const { event, ...meta } = batch;
+                        if (!event)
+                            continue;
+                        if (isSnapshotEvent(event))
+                            continue;
+                        void this.#eventBus.publish(event, meta);
+                        events.push(event);
+                    }
+                    resolve(events);
+                }
+                catch (publishError) {
+                    reject(publishError);
+                }
+            }
+        })();
+    }
+    async revert(batch) {
+        for (const processor of this.#processors)
+            await processor.revert?.(batch);
+    }
+    push(envelope) {
+        this.#ensureProcessingStarted();
+        this.#pipelineInput.push(envelope);
+    }
+}
+//# sourceMappingURL=EventDispatchPipeline.js.map

package/dist/esm/EventDispatchPipeline.js.map

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

package/dist/esm/EventDispatcher.js

@@ -0,0 +1,89 @@
+import { isEventSet } from "./interfaces/index.js";
+import { InMemoryMessageBus } from "./in-memory/index.js";
+import { EventDispatchPipeline } from "./EventDispatchPipeline.js";
+import { assertDefined, assertArray } from "./utils/index.js";
+export class EventDispatcher {
+    /** Default pipeline name */
+    static DEFAULT_PIPELINE = 'default';
+    /** Default maximum number of parallel batches for newly created pipelines */
+    static DEFAULT_CONCURRENT_LIMIT = 100;
+    /** Default router that uses `meta.origin` as the pipeline name */
+    static DEFAULT_ROUTER = (_e, meta) => meta?.origin;
+    /**
+     * Event bus where dispatched messages are delivered after processing.
+     * If not provided in the constructor, defaults to an instance of `InMemoryMessageBus`.
+     */
+    eventBus;
+    /**
+     * Default maximum number of parallel batches for newly created pipelines.
+     */
+    concurrentLimit;
+    /** Router that selects a pipeline name given events and meta */
+    eventDispatchRouter;
+    #pipelines = new Map();
+    constructor(o) {
+        this.eventBus = o?.eventBus ?? new InMemoryMessageBus();
+        this.concurrentLimit = o?.eventDispatcherConfig?.concurrentLimit ?? EventDispatcher.DEFAULT_CONCURRENT_LIMIT;
+        this.eventDispatchRouter = o?.eventDispatchRouter ?? EventDispatcher.DEFAULT_ROUTER;
+        if (o?.eventDispatchPipelines) {
+            // Initialize pipelines if provided
+            for (const [name, processors] of Object.entries(o.eventDispatchPipelines))
+                this.addPipeline(name, processors);
+        }
+        else if (o?.eventDispatchPipeline) {
+            // Single pipeline provided becomes the default pipeline
+            this.addPipeline(EventDispatcher.DEFAULT_PIPELINE, o.eventDispatchPipeline);
+        }
+        else {
+            // Ensure default pipeline exists at minimum
+            this.addPipeline(EventDispatcher.DEFAULT_PIPELINE, []);
+        }
+    }
+    /** Add or create the default pipeline processors */
+    addPipelineProcessors(eventDispatchPipeline, pipelineName) {
+        assertArray(eventDispatchPipeline, 'eventDispatchPipeline');
+        for (const processor of eventDispatchPipeline)
+            this.addPipelineProcessor(processor, pipelineName);
+    }
+    /** Adds a single processor to the default pipeline */
+    addPipelineProcessor(preprocessor, pipelineName) {
+        const pipeline = this.#pipelines.get(pipelineName ?? EventDispatcher.DEFAULT_PIPELINE);
+        if (!pipeline)
+            throw new Error(`Pipeline "${pipelineName ?? EventDispatcher.DEFAULT_PIPELINE}" does not exist`);
+        pipeline.addProcessor(preprocessor);
+    }
+    /** Create a named pipeline with processors and optional concurrency limit */
+    addPipeline(name, processors = [], options) {
+        assertDefined(name, 'pipeline name');
+        if (this.#pipelines.has(name))
+            throw new Error(`pipeline "${name}" already exists`);
+        const pipeline = new EventDispatchPipeline(this.eventBus, options?.concurrentLimit ?? this.concurrentLimit);
+        for (const p of processors)
+            pipeline.addProcessor(p);
+        this.#pipelines.set(name, pipeline);
+        return pipeline;
+    }
+    /** Dispatch events through a routed pipeline and publish to the shared eventBus */
+    async dispatch(events, meta) {
+        if (!isEventSet(events) || events.length === 0)
+            throw new TypeError('dispatch requires a non-empty array of events');
+        let resolve;
+        let reject;
+        const promise = new Promise((res, rej) => {
+            resolve = res;
+            reject = rej;
+        });
+        const envelope = {
+            data: events.map(event => ({ event, ...meta })),
+            resolve,
+            reject
+        };
+        const desired = this.eventDispatchRouter?.(events, meta) ?? EventDispatcher.DEFAULT_PIPELINE;
+        const pipeline = this.#pipelines.get(desired) ?? this.#pipelines.get(EventDispatcher.DEFAULT_PIPELINE);
+        if (!pipeline)
+            throw new Error(`No "${desired}" pipeline configured`);
+        pipeline.push(envelope);
+        return promise;
+    }
+}
+//# sourceMappingURL=EventDispatcher.js.map

package/dist/esm/EventDispatcher.js.map

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

package/dist/esm/EventIdAugmentor.js

@@ -0,0 +1,26 @@
+import { assertDefined } from "./utils/assert.js";
+/**
+ * Dispatch-pipeline processor that ensures each event has an `id`.
+ *
+ * Some components (e.g. `SagaEventHandler`) require `event.id` to correlate saga instances.
+ * Put this processor early in the `eventDispatchPipeline` to auto-assign ids to events that don't have them.
+ */
+export class EventIdAugmentor {
+    #identifierProvider;
+    constructor({ identifierProvider }) {
+        assertDefined(identifierProvider, 'identifierProvider');
+        this.#identifierProvider = identifierProvider;
+    }
+    async process(batch) {
+        for (const envelope of batch) {
+            const event = envelope.event;
+            if (!event)
+                continue;
+            if (typeof event.id === 'string' && event.id.length)
+                continue;
+            event.id = String(await this.#identifierProvider.getNewId());
+        }
+        return batch;
+    }
+}
+//# sourceMappingURL=EventIdAugmentor.js.map

package/dist/esm/EventIdAugmentor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventIdAugmentor.js","sourceRoot":"","sources":["../../src/EventIdAugmentor.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD;;;;;GAKG;AACH,MAAM,OAAO,gBAAgB;IAE5B,mBAAmB,CAAsB;IAEzC,YAAY,EAAE,kBAAkB,EAA0C;QACzE,aAAa,CAAC,kBAAkB,EAAE,oBAAoB,CAAC,CAAC;QAExD,IAAI,CAAC,mBAAmB,GAAG,kBAAkB,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAsD;QACnE,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;YAC7B,IAAI,CAAC,KAAK;gBACT,SAAS;YACV,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,IAAI,KAAK,CAAC,EAAE,CAAC,MAAM;gBAClD,SAAS;YAEV,KAAK,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,mBAAmB,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC9D,CAAC;QAED,OAAO,KAAK,CAAC;IACd,CAAC;CACD"}

package/dist/esm/EventStore.js

@@ -0,0 +1,102 @@
+import { isIdentifierProvider, isObservableQueueProvider } from "./interfaces/index.js";
+import { assertArray, assertDefined, assertObservable, assertStringArray, parseSagaId, setupOneTimeEmitterSubscription } from "./utils/index.js";
+import { EventDispatcher } from "./EventDispatcher.js";
+export class EventStore {
+    #identifierProvider;
+    #eventStorageReader;
+    #snapshotStorage;
+    eventBus;
+    #eventDispatcher;
+    #logger;
+    constructor({ eventStorage, eventStorageReader = eventStorage, identifierProvider = isIdentifierProvider(eventStorageReader) ? eventStorageReader : undefined, snapshotStorage, eventBus, eventDispatcher, eventDispatchPipeline, eventDispatchPipelines, logger }) {
+        assertDefined(eventStorageReader, 'eventStorageReader or eventStorage');
+        assertDefined(identifierProvider, 'identifierProvider');
+        assertObservable(eventBus, 'eventBus');
+        this.#eventStorageReader = eventStorageReader;
+        this.#identifierProvider = identifierProvider;
+        this.#snapshotStorage = snapshotStorage;
+        this.#eventDispatcher = eventDispatcher ?? new EventDispatcher({
+            eventBus,
+            eventDispatchPipeline,
+            eventDispatchPipelines
+        });
+        this.eventBus = eventBus ?? this.#eventDispatcher.eventBus;
+        this.#logger = logger && 'child' in logger ?
+            logger.child({ service: new.target.name }) :
+            logger;
+    }
+    /**
+     * Generates and returns a new unique identifier using the configured identifier provider.
+     *
+     * @returns A promise resolving to a unique identifier suitable for aggregates, sagas, and events.
+     */
+    async getNewId() {
+        return this.#identifierProvider.getNewId();
+    }
+    async *getEventsByTypes(eventTypes, options) {
+        assertStringArray(eventTypes, 'eventTypes');
+        this.#logger?.debug(`retrieving ${eventTypes.join(', ')} events...`);
+        const eventsIterable = await this.#eventStorageReader.getEventsByTypes(eventTypes, options);
+        yield* eventsIterable;
+        this.#logger?.debug(`${eventTypes.join(', ')} events retrieved`);
+    }
+    /** Retrieve all events of specific Aggregate */
+    async *getAggregateEvents(aggregateId, options) {
+        assertDefined(aggregateId, 'aggregateId');
+        this.#logger?.debug(`retrieving event stream for aggregate ${aggregateId}...`);
+        // Get snapshot from snapshot storage if not provided in options
+        let snapshot = options?.snapshot;
+        if (!snapshot && this.#snapshotStorage)
+            snapshot = await this.#snapshotStorage.getAggregateSnapshot(aggregateId);
+        if (snapshot)
+            yield snapshot;
+        const eventsIterable = await this.#eventStorageReader.getAggregateEvents(aggregateId, {
+            ...options,
+            snapshot
+        });
+        yield* eventsIterable;
+        this.#logger?.debug(`all events for aggregate ${aggregateId} retrieved`);
+    }
+    /** Retrieve events of specific Saga */
+    async *getSagaEvents(sagaId, filter) {
+        assertDefined(sagaId, 'sagaId');
+        assertDefined(filter?.beforeEvent?.id, 'filter.beforeEvent.id');
+        const { sagaDescriptor, originEventId } = parseSagaId(sagaId);
+        if (filter.beforeEvent.sagaOrigins?.[sagaDescriptor] !== originEventId)
+            throw new TypeError('filter.beforeEvent.sagaOrigins does not match sagaId');
+        this.#logger?.debug(`retrieving event stream for saga ${sagaId} before event ${filter.beforeEvent.id}...`);
+        const eventsIterable = await this.#eventStorageReader.getSagaEvents(sagaId, filter);
+        yield* eventsIterable;
+        this.#logger?.debug(`all events for saga ${sagaId} retrieved`);
+    }
+    /**
+     * Validate events, commit to storage and publish to eventBus, if needed
+     *
+     * @param events - a set of events to commit
+     * @returns Signed and committed events
+     */
+    async dispatch(events, meta) {
+        assertArray(events, 'events');
+        return this.#eventDispatcher.dispatch(events, {
+            origin: 'internal',
+            ...meta
+        });
+    }
+    on(messageType, handler) {
+        this.eventBus.on(messageType, handler);
+    }
+    off(messageType, handler) {
+        this.eventBus.off(messageType, handler);
+    }
+    queue(name) {
+        if (!isObservableQueueProvider(this.eventBus))
+            throw new Error('Injected eventBus does not support named queues');
+        return this.eventBus.queue(name);
+    }
+    /** Creates one-time subscription for one or multiple events that match a filter */
+    once(messageTypes, handler, filter) {
+        const subscribeTo = Array.isArray(messageTypes) ? messageTypes : [messageTypes];
+        return setupOneTimeEmitterSubscription(this.eventBus, subscribeTo, filter, handler, this.#logger);
+    }
+}
+//# sourceMappingURL=EventStore.js.map

package/dist/esm/EventStore.js.map

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

package/dist/esm/SagaEventHandler.js

@@ -0,0 +1,116 @@
+import * as Event from "./Event.js";
+import { subscribe, Lock, makeSagaId, MapAssertable, assertDefined, assertString, assertOptionalArray } from "./utils/index.js";
+/**
+ * Listens to Saga events,
+ * creates new saga or restores it from event store,
+ * applies new events
+ * and passes command(s) to command bus
+ */
+export class SagaEventHandler {
+    #eventStore;
+    #commandBus;
+    #queueName;
+    #logger;
+    #sagaFactory;
+    #startsWith;
+    #handles;
+    #sagaDescriptor;
+    #executionLock;
+    #sagasCache = new MapAssertable();
+    constructor(options) {
+        assertDefined(options, 'options');
+        assertDefined(options.eventStore, 'options.eventStore');
+        assertDefined(options.commandBus, 'options.commandBus');
+        this.#eventStore = options.eventStore;
+        this.#commandBus = options.commandBus;
+        this.#queueName = options.queueName;
+        this.#executionLock = options.executionLocker ?? new Lock();
+        this.#logger = options.logger && 'child' in options.logger ?
+            options.logger.child({ service: new.target.name }) :
+            options.logger;
+        if (options.sagaType) {
+            const SagaType = options.sagaType;
+            this.#sagaFactory = params => new SagaType(params);
+            this.#startsWith = SagaType.startsWith;
+            this.#handles = SagaType.handles;
+            this.#sagaDescriptor = SagaType.sagaDescriptor ?? SagaType.name;
+        }
+        else if (options.sagaFactory) {
+            assertOptionalArray(options.handles, 'options.handles');
+            assertString(options.sagaDescriptor, 'options.sagaDescriptor');
+            this.#sagaFactory = options.sagaFactory;
+            this.#startsWith = options.startsWith;
+            this.#handles = options.handles;
+            this.#sagaDescriptor = options.sagaDescriptor;
+        }
+        else {
+            throw new Error('Either sagaType or sagaFactory is required');
+        }
+    }
+    /** Overrides observer subscribe method */
+    subscribe(eventStore) {
+        subscribe(eventStore, this, {
+            messageTypes: [...this.#startsWith ?? [], ...this.#handles],
+            masterHandler: this.handle,
+            queueName: this.#queueName
+        });
+    }
+    /** Handle saga event */
+    async handle(event) {
+        assertDefined(event, 'event');
+        assertDefined(event.type, 'event.type');
+        assertString(event.id, 'event.id');
+        const sagaOriginFromEvent = event.sagaOrigins?.[this.#sagaDescriptor];
+        const isStarterEvent = this.#startsWith?.includes(event.type) ?? !sagaOriginFromEvent;
+        if (isStarterEvent && sagaOriginFromEvent)
+            throw new Error(`Starter event "${event.type}" already contains saga origin for "${this.#sagaDescriptor}"`);
+        const sagaOrigin = isStarterEvent ? event.id : sagaOriginFromEvent;
+        if (!sagaOrigin)
+            throw new Error(`Event "${event.type}" does not contain saga origin for "${this.#sagaDescriptor}"`);
+        const sagaId = makeSagaId(this.#sagaDescriptor, sagaOrigin);
+        const saga = await this.#sagasCache.assert(sagaId, () => (isStarterEvent ?
+            this.#createSaga(sagaId) :
+            this.#restoreSaga(sagaId, event)));
+        // multiple events to a same saga ID will execute sequentially on a same saga instance
+        const lease = await this.#executionLock.acquire(sagaId);
+        try {
+            const commands = await saga.handle(event);
+            this.#logger?.debug(`"${Event.describe(event)}" processed, ${commands.map(c => c.type).join(',') || 'no commands'} produced`);
+            for (const command of commands) {
+                // attach event context to produced command
+                if (command.context === undefined && event.context !== undefined)
+                    command.context = event.context;
+                if (command.sagaOrigins === undefined) {
+                    command.sagaOrigins = {
+                        ...event.sagaOrigins,
+                        [this.#sagaDescriptor]: sagaOrigin
+                    };
+                }
+                await this.#commandBus.send(command);
+            }
+        }
+        finally {
+            lease.release();
+            this.#sagasCache.release(sagaId);
+        }
+    }
+    /** Start new saga */
+    async #createSaga(id) {
+        return this.#sagaFactory.call(null, { id });
+    }
+    /** Restore saga from event store */
+    async #restoreSaga(id, event) {
+        const saga = this.#sagaFactory.call(null, { id });
+        const eventsIterable = this.#eventStore.getSagaEvents(id, { beforeEvent: event });
+        let eventsCount = 0;
+        for await (const oldEvent of eventsIterable) {
+            const r = saga.mutate(oldEvent);
+            if (r instanceof Promise)
+                await r;
+            eventsCount += 1;
+        }
+        this.#logger?.info(`Saga state restored from ${eventsCount} event(s)`);
+        return saga;
+    }
+}
+//# sourceMappingURL=SagaEventHandler.js.map

package/dist/esm/SagaEventHandler.js.map

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

package/dist/esm/errors/ConcurrencyError.js

@@ -0,0 +1,17 @@
+/**
+ * Thrown by event storage implementations when a concurrency conflict is detected
+ * (e.g. duplicate aggregate version). When this error is thrown during event dispatch,
+ * AggregateCommandHandler can automatically retry the command by re-creating
+ * the aggregate from the event store.
+ */
+export class ConcurrencyError extends Error {
+    constructor(message, options) {
+        super(message ?? 'Concurrency conflict detected', options);
+    }
+}
+Object.defineProperty(ConcurrencyError.prototype, 'name', {
+    value: ConcurrencyError.name,
+    writable: true,
+    configurable: true
+});
+//# sourceMappingURL=ConcurrencyError.js.map

package/dist/esm/errors/ConcurrencyError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConcurrencyError.js","sourceRoot":"","sources":["../../../src/errors/ConcurrencyError.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAC1C,YAAY,OAAgB,EAAE,OAAsB;QACnD,KAAK,CAAC,OAAO,IAAI,+BAA+B,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;CACD;AAED,MAAM,CAAC,cAAc,CAAC,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE;IACzD,KAAK,EAAE,gBAAgB,CAAC,IAAI;IAC5B,QAAQ,EAAE,IAAI;IACd,YAAY,EAAE,IAAI;CAClB,CAAC,CAAC"}

package/dist/esm/errors/index.js

@@ -0,0 +1,2 @@
+export * from "./ConcurrencyError.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC"}