node-cqrs 0.16.4 → 0.17.0

package/CHANGELOG.md

@@ -1,3 +1,48 @@
+# [0.17.0](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.5...v0.17.0) (2025-08-12)
+
+
+
+# [1.0.0-rc.5](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.4...v1.0.0-rc.5) (2024-10-27)
+
+
+### Changes
+
+* Add `InMemoryView.prototype.getSync` method ([5d4adb9](https://github.com/snatalenko/node-cqrs/commit/5d4adb9109c4c85edae2b0f3dfd995e8c51aef06))
+
+
+# [1.0.0-rc.4](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.3...v1.0.0-rc.4) (2024-10-02)
+
+
+
+# [1.0.0-rc.3](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.2...v1.0.0-rc.3) (2024-09-23)
+
+
+
+# [1.0.0-rc.2](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.1...v1.0.0-rc.2) (2024-08-03)
+
+
+
+# [1.0.0-rc.1](https://github.com/snatalenko/node-cqrs/compare/v1.0.0-rc.0...v1.0.0-rc.1) (2024-08-03)
+
+
+### Build System
+
+* Add NPM publishing script ([3372990](https://github.com/snatalenko/node-cqrs/commit/3372990ba2549695398e0949e35009396e660005))
+* Suppress audit and test for tags ([574a00c](https://github.com/snatalenko/node-cqrs/commit/574a00cc53af009994ca4dd3278cb764743b4ad6))
+
+
+# [1.0.0-rc.0](https://github.com/snatalenko/node-cqrs/compare/v0.16.4...v1.0.0-rc.0) (2024-08-02)
+
+
+### Fixes
+
+* Vulnerability in minimist dependency ([07b8c68](https://github.com/snatalenko/node-cqrs/commit/07b8c682fae4278965aa13a06caa994c037934e9))
+
+### Refactoring
+
+* Migrate to TS and Jest ([6737d55](https://github.com/snatalenko/node-cqrs/commit/6737d5566a9dc6314df0b20a65d32414fc503e54))
+
+
 ## [0.16.4](https://github.com/snatalenko/node-cqrs/compare/v0.16.3...v0.16.4) (2022-08-28)
 
 

package/README.md

@@ -2,7 +2,8 @@ node-cqrs
 =========
 
 [![NPM Version](https://img.shields.io/npm/v/node-cqrs.svg)](https://www.npmjs.com/package/node-cqrs)
-[![Build Status](https://secure.travis-ci.org/snatalenko/node-cqrs.svg?branch=master)](http://travis-ci.org/snatalenko/node-cqrs)
+[![Audit Status](https://github.com/snatalenko/node-cqrs/actions/workflows/audit.yml/badge.svg)](https://github.com/snatalenko/node-cqrs/actions/workflows/audit.yml)
+[![Tests Status](https://github.com/snatalenko/node-cqrs/actions/workflows/tests.yml/badge.svg)](https://github.com/snatalenko/node-cqrs/actions/workflows/tests.yml)
 [![Coverage Status](https://coveralls.io/repos/github/snatalenko/node-cqrs/badge.svg?branch=master)](https://coveralls.io/github/snatalenko/node-cqrs?branch=master)
 [![NPM Downloads](https://img.shields.io/npm/dm/node-cqrs.svg)](https://www.npmjs.com/package/node-cqrs)
 

package/dist/AbstractAggregate.js

@@ -0,0 +1,178 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractAggregate = void 0;
+const utils_1 = require("./utils");
+/**
+ * Deep-clone simple JS object
+ */
+function clone(obj) {
+    return JSON.parse(JSON.stringify(obj));
+}
+const SNAPSHOT_EVENT_TYPE = 'snapshot';
+/**
+ * Base class for Aggregate definition
+ */
+class AbstractAggregate {
+    /**
+     * Optional list of commands handled by Aggregate.
+     *
+     * If not overridden in Aggregate implementation,
+     * `AggregateCommandHandler` will treat all public methods as command handlers
+     *
+     * @example
+     * 	return ['createUser', 'changePassword'];
+     */
+    static get handles() {
+        return undefined;
+    }
+    #id;
+    #changes = [];
+    #version = 0;
+    #snapshotVersion;
+    /** Internal aggregate state */
+    state;
+    /** Command being handled by aggregate */
+    command;
+    /** Unique aggregate instance identifier */
+    get id() {
+        return this.#id;
+    }
+    /** Aggregate instance version */
+    get version() {
+        return this.#version;
+    }
+    /** Restored snapshot version */
+    get snapshotVersion() {
+        return this.#snapshotVersion;
+    }
+    /** Events emitted by Aggregate */
+    get changes() {
+        return [...this.#changes];
+    }
+    /**
+     * Override to define whether an aggregate state snapshot should be taken
+     *
+     * @example
+     * 	// create snapshot every 50 events
+     * 	return this.version % 50 === 0;
+     */
+    get shouldTakeSnapshot() {
+        return false;
+    }
+    constructor(options) {
+        const { id, state, events } = options;
+        if (!id)
+            throw new TypeError('id argument required');
+        if (state && typeof state !== 'object')
+            throw new TypeError('state argument, when provided, must be an Object');
+        if (events && !Array.isArray(events))
+            throw new TypeError('events argument, when provided, must be an Array');
+        this.#id = id;
+        (0, utils_1.validateHandlers)(this);
+        if (state)
+            this.state = state;
+        if (events)
+            events.forEach(event => this.mutate(event));
+    }
+    /** Pass command to command handler */
+    handle(command) {
+        if (!command)
+            throw new TypeError('command argument required');
+        if (!command.type)
+            throw new TypeError('command.type argument required');
+        const handler = (0, utils_1.getHandler)(this, command.type);
+        if (!handler)
+            throw new Error(`'${command.type}' handler is not defined or not a function`);
+        this.command = command;
+        return handler.call(this, command.payload, command.context);
+    }
+    /** Mutate aggregate state and increment aggregate version */
+    mutate(event) {
+        if (event.aggregateVersion !== undefined)
+            this.#version = event.aggregateVersion;
+        if (event.type === SNAPSHOT_EVENT_TYPE) {
+            this.#snapshotVersion = event.aggregateVersion;
+            this.restoreSnapshot(event);
+        }
+        else if (this.state) {
+            const handler = 'mutate' in this.state ?
+                this.state.mutate :
+                (0, utils_1.getHandler)(this.state, event.type);
+            if (handler)
+                handler.call(this.state, event);
+        }
+        this.#version += 1;
+    }
+    /** Format and register aggregate event and mutate aggregate state */
+    emit(type, payload) {
+        if (typeof type !== 'string' || !type.length)
+            throw new TypeError('type argument must be a non-empty string');
+        const event = this.makeEvent(type, payload, this.command);
+        this.emitRaw(event);
+    }
+    /** Format event based on a current aggregate state and a command being executed */
+    makeEvent(type, payload, sourceCommand) {
+        const event = {
+            aggregateId: this.id,
+            aggregateVersion: this.version,
+            type,
+            payload
+        };
+        if (sourceCommand) {
+            // augment event with command context
+            const { context, sagaId, sagaVersion } = sourceCommand;
+            if (context !== undefined)
+                event.context = context;
+            if (sagaId !== undefined)
+                event.sagaId = sagaId;
+            if (sagaVersion !== undefined)
+                event.sagaVersion = sagaVersion;
+        }
+        return event;
+    }
+    /** Register aggregate event and mutate aggregate state */
+    emitRaw(event) {
+        if (!event)
+            throw new TypeError('event argument required');
+        if (!event.aggregateId)
+            throw new TypeError('event.aggregateId argument required');
+        if (typeof event.aggregateVersion !== 'number')
+            throw new TypeError('event.aggregateVersion argument must be a Number');
+        if (typeof event.type !== 'string' || !event.type.length)
+            throw new TypeError('event.type argument must be a non-empty String');
+        this.mutate(event);
+        this.#changes.push(event);
+    }
+    /**
+     * Take an aggregate state snapshot and add it to the changes queue
+     */
+    takeSnapshot() {
+        this.emit(SNAPSHOT_EVENT_TYPE, this.makeSnapshot());
+    }
+    /** Create an aggregate state snapshot */
+    makeSnapshot() {
+        if (!this.state)
+            throw new Error('state property is empty, either define state or override makeSnapshot method');
+        return clone(this.state);
+    }
+    /** Restore aggregate state from a snapshot */
+    restoreSnapshot(snapshotEvent) {
+        if (!snapshotEvent)
+            throw new TypeError('snapshotEvent argument required');
+        if (!snapshotEvent.type)
+            throw new TypeError('snapshotEvent.type argument required');
+        if (!snapshotEvent.payload)
+            throw new TypeError('snapshotEvent.payload argument required');
+        if (snapshotEvent.type !== SNAPSHOT_EVENT_TYPE)
+            throw new Error(`${SNAPSHOT_EVENT_TYPE} event type expected`);
+        if (!this.state)
+            throw new Error('state property is empty, either defined state or override restoreSnapshot method');
+        Object.assign(this.state, clone(snapshotEvent.payload));
+    }
+    /** Get human-readable aggregate identifier */
+    toString() {
+        return `${(0, utils_1.getClassName)(this)} ${this.id} (v${this.version})`;
+    }
+}
+exports.AbstractAggregate = AbstractAggregate;
+//# sourceMappingURL=AbstractAggregate.js.map

package/dist/AbstractAggregate.js.map

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

package/dist/AbstractProjection.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractProjection = void 0;
+const InMemoryView_1 = require("./infrastructure/InMemoryView");
+const utils_1 = require("./utils");
+const isProjectionView = (view) => 'ready' in view &&
+    'lock' in view &&
+    'unlock' in view &&
+    'once' in view;
+const asProjectionView = (view) => (isProjectionView(view) ? view : undefined);
+/**
+ * Base class for Projection definition
+ */
+class AbstractProjection {
+    /**
+     * Optional list of event types being handled by projection.
+     * Can be overridden in projection implementation.
+     * If not overridden, will detect event types from event handlers declared on the Projection class
+     */
+    static get handles() {
+        return undefined;
+    }
+    /**
+     * Default view associated with projection
+     */
+    get view() {
+        if (!this.#view)
+            this.#view = this.#viewFactory();
+        return this.#view;
+    }
+    #viewFactory;
+    #view;
+    _logger;
+    get collectionName() {
+        return (0, utils_1.getClassName)(this);
+    }
+    /**
+     * Indicates if view should be restored from EventStore on start.
+     * Override for custom behavior.
+     */
+    get shouldRestoreView() {
+        return (this.view instanceof Map)
+            || (this.view instanceof InMemoryView_1.InMemoryView);
+    }
+    constructor({ view, viewFactory = InMemoryView_1.InMemoryView.factory, logger } = {}) {
+        (0, utils_1.validateHandlers)(this);
+        this.#viewFactory = view ?
+            () => view :
+            viewFactory;
+        this._logger = logger && 'child' in logger ?
+            logger.child({ service: (0, utils_1.getClassName)(this) }) :
+            logger;
+    }
+    /** Subscribe to event store */
+    async subscribe(eventStore) {
+        (0, utils_1.subscribe)(eventStore, this, {
+            masterHandler: (e) => this.project(e)
+        });
+        await this.restore(eventStore);
+    }
+    /** Pass event to projection event handler */
+    async project(event) {
+        const concurrentView = asProjectionView(this.view);
+        if (concurrentView && !concurrentView.ready)
+            await concurrentView.once('ready');
+        return this._project(event);
+    }
+    /** Pass event to projection event handler, without awaiting for restore operation to complete */
+    async _project(event) {
+        const handler = (0, utils_1.getHandler)(this, event.type);
+        if (!handler)
+            throw new Error(`'${event.type}' handler is not defined or not a function`);
+        return handler.call(this, event);
+    }
+    /** Restore projection view from event store */
+    async restore(eventStore) {
+        // lock the view to ensure same restoring procedure
+        // won't be performed by another projection instance
+        const concurrentView = asProjectionView(this.view);
+        if (concurrentView)
+            await concurrentView.lock();
+        const shouldRestore = await this.shouldRestoreView;
+        if (shouldRestore)
+            await this._restore(eventStore);
+        if (concurrentView)
+            concurrentView.unlock();
+    }
+    /** Restore projection view from event store */
+    async _restore(eventStore) {
+        if (!eventStore)
+            throw new TypeError('eventStore argument required');
+        if (typeof eventStore.getAllEvents !== 'function')
+            throw new TypeError('eventStore.getAllEvents must be a Function');
+        this._logger?.debug('retrieving events and restoring projection...');
+        const messageTypes = (0, utils_1.getHandledMessageTypes)(this);
+        const eventsIterable = eventStore.getAllEvents(messageTypes);
+        let eventsCount = 0;
+        const startTs = Date.now();
+        for await (const event of eventsIterable) {
+            try {
+                await this._project(event);
+                eventsCount += 1;
+            }
+            catch (err) {
+                this._onRestoringError(err, event);
+            }
+        }
+        this._logger?.info(`view restored (${this.view}) from ${eventsCount} event(s) in ${Date.now() - startTs} ms`);
+    }
+    /** Handle error on restoring. Logs and throws error by default */
+    _onRestoringError(error, event) {
+        this._logger?.error(`view restoring has failed (view will remain locked): ${error.message}`, {
+            service: (0, utils_1.getClassName)(this),
+            event,
+            stack: error.stack
+        });
+        throw error;
+    }
+}
+exports.AbstractProjection = AbstractProjection;
+//# sourceMappingURL=AbstractProjection.js.map

package/dist/AbstractProjection.js.map

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

package/dist/AbstractSaga.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractSaga = void 0;
+const utils_1 = require("./utils");
+/**
+ * Base class for Saga definition
+ */
+class AbstractSaga {
+    /** List of events that start new saga, must be overridden in Saga implementation */
+    static get startsWith() {
+        throw new Error('startsWith must be overridden to return a list of event types that start saga');
+    }
+    /** List of event types being handled by Saga, must be overridden in Saga implementation */
+    static get handles() {
+        return [];
+    }
+    /** Saga ID */
+    get id() {
+        return this.#id;
+    }
+    /** Saga version */
+    get version() {
+        return this.#version;
+    }
+    /** Command execution queue */
+    get uncommittedMessages() {
+        return Array.from(this.#messages);
+    }
+    #id;
+    #version = 0;
+    #messages = [];
+    /**
+     * Creates an instance of AbstractSaga
+     */
+    constructor(options) {
+        if (!options)
+            throw new TypeError('options argument required');
+        if (!options.id)
+            throw new TypeError('options.id argument required');
+        this.#id = options.id;
+        (0, utils_1.validateHandlers)(this, 'startsWith');
+        (0, utils_1.validateHandlers)(this, 'handles');
+        if (options.events) {
+            options.events.forEach(e => this.apply(e));
+            this.resetUncommittedMessages();
+        }
+        Object.defineProperty(this, 'restored', { value: true });
+    }
+    /** Modify saga state by applying an event */
+    apply(event) {
+        if (!event)
+            throw new TypeError('event argument required');
+        if (!event.type)
+            throw new TypeError('event.type argument required');
+        const handler = (0, utils_1.getHandler)(this, event.type);
+        if (!handler)
+            throw new Error(`'${event.type}' handler is not defined or not a function`);
+        const r = handler.call(this, event);
+        if (r instanceof Promise) {
+            return r.then(() => {
+                this.#version += 1;
+            });
+        }
+        this.#version += 1;
+        return undefined;
+    }
+    /** Format a command and put it to the execution queue */
+    enqueue(commandType, aggregateId, payload) {
+        if (typeof commandType !== 'string' || !commandType.length)
+            throw new TypeError('commandType argument must be a non-empty String');
+        if (!['string', 'number', 'undefined'].includes(typeof aggregateId))
+            throw new TypeError('aggregateId argument must be either string, number or undefined');
+        this.enqueueRaw({
+            aggregateId,
+            sagaId: this.id,
+            sagaVersion: this.version,
+            type: commandType,
+            payload
+        });
+    }
+    /** Put a command to the execution queue */
+    enqueueRaw(command) {
+        if (typeof command !== 'object' || !command)
+            throw new TypeError('command argument must be an Object');
+        if (typeof command.type !== 'string' || !command.type.length)
+            throw new TypeError('command.type argument must be a non-empty String');
+        this.#messages.push(command);
+    }
+    /** Clear the execution queue */
+    resetUncommittedMessages() {
+        this.#messages.length = 0;
+    }
+    /** Get human-readable Saga name */
+    toString() {
+        return `${(0, utils_1.getClassName)(this)} ${this.id} (v${this.version})`;
+    }
+}
+exports.AbstractSaga = AbstractSaga;
+//# sourceMappingURL=AbstractSaga.js.map

package/dist/AbstractSaga.js.map

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

package/dist/AggregateCommandHandler.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AggregateCommandHandler = void 0;
+const utils_1 = require("./utils");
+/**
+ * Aggregate command handler.
+ *
+ * Subscribes to event store and awaits aggregate commands.
+ * Upon command receiving creates an instance of aggregate,
+ * restores its state, passes command and commits emitted events to event store.
+ */
+class AggregateCommandHandler {
+    #eventStore;
+    #logger;
+    #aggregateFactory;
+    #handles;
+    constructor({ eventStore, aggregateType, aggregateFactory, handles, logger }) {
+        if (!eventStore)
+            throw new TypeError('eventStore argument required');
+        this.#eventStore = eventStore;
+        this.#logger = logger && 'child' in logger ?
+            logger.child({ service: (0, utils_1.getClassName)(this) }) :
+            logger;
+        if (aggregateType) {
+            const AggregateType = aggregateType;
+            this.#aggregateFactory = params => new AggregateType(params);
+            this.#handles = (0, utils_1.getHandledMessageTypes)(AggregateType);
+        }
+        else if (aggregateFactory) {
+            if (!Array.isArray(handles) || !handles.length)
+                throw new TypeError('handles argument must be an non-empty Array');
+            this.#aggregateFactory = aggregateFactory;
+            this.#handles = handles;
+        }
+        else {
+            throw new TypeError('either aggregateType or aggregateFactory is required');
+        }
+    }
+    /** Subscribe to all command types handled by aggregateType */
+    subscribe(commandBus) {
+        (0, utils_1.subscribe)(commandBus, this, {
+            messageTypes: this.#handles,
+            masterHandler: (c) => this.execute(c)
+        });
+    }
+    /** Restore aggregate from event store events */
+    async #restoreAggregate(id) {
+        if (!id)
+            throw new TypeError('id argument required');
+        const events = await this.#eventStore.getAggregateEvents(id);
+        const aggregate = this.#aggregateFactory({ id, events });
+        this.#logger?.info(`${aggregate} state restored from ${events.length} event(s)`);
+        return aggregate;
+    }
+    /** Create new aggregate with new Id generated by event store */
+    async #createAggregate() {
+        const id = await this.#eventStore.getNewId();
+        const aggregate = this.#aggregateFactory({ id });
+        this.#logger?.info(`${aggregate} created`);
+        return aggregate;
+    }
+    /** Pass a command to corresponding aggregate */
+    async execute(cmd) {
+        if (!cmd)
+            throw new TypeError('cmd argument required');
+        if (!cmd.type)
+            throw new TypeError('cmd.type argument required');
+        const aggregate = cmd.aggregateId ?
+            await this.#restoreAggregate(cmd.aggregateId) :
+            await this.#createAggregate();
+        await aggregate.handle(cmd);
+        let events = aggregate.changes;
+        this.#logger?.info(`${aggregate} "${cmd.type}" command processed, ${events.length} event(s) produced`);
+        if (!events.length)
+            return events;
+        if (aggregate.shouldTakeSnapshot && this.#eventStore.snapshotsSupported) {
+            aggregate.takeSnapshot();
+            events = aggregate.changes;
+        }
+        await this.#eventStore.commit(events);
+        return events;
+    }
+}
+exports.AggregateCommandHandler = AggregateCommandHandler;
+//# sourceMappingURL=AggregateCommandHandler.js.map

package/dist/AggregateCommandHandler.js.map

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

package/dist/CommandBus.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommandBus = void 0;
+const InMemoryMessageBus_1 = require("./infrastructure/InMemoryMessageBus");
+class CommandBus {
+    #logger;
+    #bus;
+    /**
+     * Creates an instance of CommandBus.
+     */
+    constructor({ messageBus, logger }) {
+        this.#bus = messageBus ?? new InMemoryMessageBus_1.InMemoryMessageBus();
+        this.#logger = logger && 'child' in logger ?
+            logger.child({ service: 'CommandBus' }) :
+            logger;
+    }
+    /**
+     * Set up a command handler
+     */
+    on(commandType, handler) {
+        if (typeof commandType !== 'string' || !commandType.length)
+            throw new TypeError('commandType argument must be a non-empty String');
+        if (typeof handler !== 'function')
+            throw new TypeError('handler argument must be a Function');
+        return this.#bus.on(commandType, handler);
+    }
+    /**
+     * Remove previously installed command handler
+     */
+    off(commandType, handler) {
+        if (typeof commandType !== 'string' || !commandType.length)
+            throw new TypeError('commandType argument must be a non-empty String');
+        if (typeof handler !== 'function')
+            throw new TypeError('handler argument must be a Function');
+        return this.#bus.off(commandType, handler);
+    }
+    /**
+     * Format and send a command for execution
+     */
+    send(type, aggregateId, options, ...otherArgs) {
+        if (typeof type !== 'string' || !type.length)
+            throw new TypeError('type argument must be a non-empty String');
+        if (options && typeof options !== 'object')
+            throw new TypeError('options argument, when defined, must be an Object');
+        if (otherArgs.length > 1)
+            throw new TypeError('more than expected arguments supplied');
+        // obsolete. left for backward compatibility
+        const optionsContainContext = options && !('context' in options) && !('payload' in options);
+        if (otherArgs.length || optionsContainContext) {
+            const context = options;
+            const payload = otherArgs.length ? otherArgs[0] : undefined;
+            return this.sendRaw({ type, aggregateId, context, payload });
+        }
+        return this.sendRaw({ type, aggregateId, ...options });
+    }
+    /**
+     * Send a command for execution
+     */
+    sendRaw(command) {
+        if (!command)
+            throw new TypeError('command argument required');
+        if (!command.type)
+            throw new TypeError('command.type argument required');
+        this.#logger?.debug(`sending '${command.type}' command${command.aggregateId ? ` to ${command.aggregateId}` : ''}...`);
+        return this.#bus.send(command).then(r => {
+            this.#logger?.debug(`'${command.type}' ${command.aggregateId ? `on ${command.aggregateId}` : ''} processed`);
+            return r;
+        }, error => {
+            this.#logger?.warn(`'${command.type}' ${command.aggregateId ? `on ${command.aggregateId}` : ''} processing has failed: ${error.message}`, {
+                stack: error.stack
+            });
+            throw error;
+        });
+    }
+}
+exports.CommandBus = CommandBus;
+//# sourceMappingURL=CommandBus.js.map

package/dist/CommandBus.js.map

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