@event-nest/core 0.0.1 → 0.0.3

package/src/lib/domain-event-emitter.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DomainEventEmitter = void 0;
+const domain_event_subscription_1 = require("./domain-event-subscription");
+const type_utils_1 = require("./utils/type-utils");
+const common_1 = require("@nestjs/common");
+const rxjs_1 = require("rxjs");
+class DomainEventEmitter {
+    constructor(_runParallelSubscriptions = false) {
+        this._runParallelSubscriptions = _runParallelSubscriptions;
+        this._handlers = new Map();
+        this._logger = new common_1.Logger(DomainEventEmitter.name);
+    }
+    onModuleDestroy() {
+        this._handlers.clear();
+    }
+    bindSubscriptions(injectorModules) {
+        injectorModules.forEach((module) => {
+            module.providers.forEach((provider) => {
+                if (!provider.instance || !provider.instance.constructor) {
+                    return;
+                }
+                if ((0, domain_event_subscription_1.isDomainEventSubscription)(provider.instance)) {
+                    const events = (0, domain_event_subscription_1.getEventsFromDomainEventSubscription)(provider.instance);
+                    events.forEach((event) => {
+                        const eventId = (0, domain_event_subscription_1.getEventId)(event);
+                        if (!this._handlers.has(eventId)) {
+                            this._handlers.set(eventId, []);
+                        }
+                        this._logger.debug(`Binding ${provider.instance?.constructor.name} to event ${eventId}`);
+                        this._handlers.get(eventId)?.push(provider.instance);
+                    });
+                }
+            });
+        });
+    }
+    emit(withAggregate) {
+        if (this._handlers.size === 0) {
+            this._logger.warn(`Event ${withAggregate.payload.constructor.name} can't be passed to subscriptions. Make sure you use the @DomainEventSubscription decorator`);
+            return Promise.resolve();
+        }
+        const eventId = (0, domain_event_subscription_1.getEventId)(withAggregate.payload.constructor);
+        if ((0, type_utils_1.isNil)(eventId) || !this._handlers.has(eventId)) {
+            this._logger.warn(`Event ${withAggregate.payload.constructor.name} can't be passed to subscriptions. Make sure you use the @DomainEventSubscription decorator`);
+            return Promise.resolve();
+        }
+        const promises = this._handlers.get(eventId).map((handler) => handler.onDomainEvent(withAggregate));
+        return Promise.all(promises);
+    }
+    emitMultiple(withAggregate) {
+        if (!this._runParallelSubscriptions) {
+            return Promise.all(withAggregate.map((aggregate) => this.emit(aggregate)));
+        }
+        const deferred = withAggregate.map((w) => (0, rxjs_1.defer)(() => (0, rxjs_1.from)(this.emit(w))));
+        return (0, rxjs_1.firstValueFrom)((0, rxjs_1.concat)(...deferred).pipe((0, rxjs_1.last)()));
+    }
+}
+exports.DomainEventEmitter = DomainEventEmitter;
+//# sourceMappingURL=domain-event-emitter.js.map

package/src/lib/domain-event-emitter.js.map

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

package/src/lib/domain-event-subscription.d.ts

@@ -0,0 +1,5 @@
+import { OnDomainEvent } from "./on-domain-event";
+export declare const DomainEventSubscription: (...events: any[]) => ClassDecorator;
+export declare function isDomainEventSubscription(targetInstance: object): boolean;
+export declare function getEventsFromDomainEventSubscription(subscriptionInstance: OnDomainEvent<unknown>): any[];
+export declare function getEventId(eventConstructor: Function): string | undefined;

package/src/lib/domain-event-subscription.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEventId = exports.getEventsFromDomainEventSubscription = exports.isDomainEventSubscription = exports.DomainEventSubscription = void 0;
+const metadata_keys_1 = require("./metadata-keys");
+const crypto_1 = require("crypto");
+const type_utils_1 = require("./utils/type-utils");
+const DomainEventSubscription = (...events) => {
+    return (target) => {
+        events.forEach((event) => {
+            if (!Reflect.hasOwnMetadata(metadata_keys_1.DOMAIN_EVENT_KEY, event)) {
+                Reflect.defineMetadata(metadata_keys_1.DOMAIN_EVENT_KEY, { eventSubscriptionId: (0, crypto_1.randomUUID)() }, event);
+            }
+        });
+        Reflect.defineMetadata(metadata_keys_1.DOMAIN_EVENT_SUBSCRIPTION_KEY, { events }, target);
+    };
+};
+exports.DomainEventSubscription = DomainEventSubscription;
+function isDomainEventSubscription(targetInstance) {
+    const hasMetadata = Reflect.hasOwnMetadata(metadata_keys_1.DOMAIN_EVENT_SUBSCRIPTION_KEY, targetInstance.constructor);
+    return hasMetadata && typeof targetInstance.onDomainEvent === "function";
+}
+exports.isDomainEventSubscription = isDomainEventSubscription;
+function getEventsFromDomainEventSubscription(subscriptionInstance) {
+    const metadata = Reflect.getMetadata(metadata_keys_1.DOMAIN_EVENT_SUBSCRIPTION_KEY, subscriptionInstance.constructor);
+    return (0, type_utils_1.isNil)(metadata) ? [] : metadata.events;
+}
+exports.getEventsFromDomainEventSubscription = getEventsFromDomainEventSubscription;
+// eslint-disable-next-line @typescript-eslint/ban-types
+function getEventId(eventConstructor) {
+    return Reflect.getMetadata(metadata_keys_1.DOMAIN_EVENT_KEY, eventConstructor)?.eventSubscriptionId;
+}
+exports.getEventId = getEventId;
+//# sourceMappingURL=domain-event-subscription.js.map

package/src/lib/domain-event-subscription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-event-subscription.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/domain-event-subscription.ts"],"names":[],"mappings":";;;AAAA,mDAAkF;AAClF,mCAAoC;AAEpC,mDAA2C;AAEpC,MAAM,uBAAuB,GAAG,CAAC,GAAG,MAAa,EAAkB,EAAE;IACxE,OAAO,CAAC,MAAc,EAAE,EAAE;QACtB,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YACrB,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,gCAAgB,EAAE,KAAK,CAAC,EAAE;gBAClD,OAAO,CAAC,cAAc,CAAC,gCAAgB,EAAE,EAAE,mBAAmB,EAAE,IAAA,mBAAU,GAAE,EAAE,EAAE,KAAK,CAAC,CAAC;aAC1F;QACL,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,cAAc,CAAC,6CAA6B,EAAE,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC;IAC9E,CAAC,CAAC;AACN,CAAC,CAAC;AAVW,QAAA,uBAAuB,2BAUlC;AAEF,SAAgB,yBAAyB,CAAC,cAAsB;IAC5D,MAAM,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,6CAA6B,EAAE,cAAc,CAAC,WAAW,CAAC,CAAC;IACtG,OAAO,WAAW,IAAI,OAAQ,cAAyC,CAAC,aAAa,KAAK,UAAU,CAAC;AACzG,CAAC;AAHD,8DAGC;AAED,SAAgB,oCAAoC,CAAC,oBAA4C;IAC7F,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,6CAA6B,EAAE,oBAAoB,CAAC,WAAW,CAAC,CAAC;IACtG,OAAO,IAAA,kBAAK,EAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;AAClD,CAAC;AAHD,oFAGC;AAED,wDAAwD;AACxD,SAAgB,UAAU,CAAC,gBAA0B;IACjD,OAAO,OAAO,CAAC,WAAW,CAAC,gCAAgB,EAAE,gBAAgB,CAAC,EAAE,mBAAmB,CAAC;AACxF,CAAC;AAFD,gCAEC"}

package/src/lib/event-processor.d.ts

@@ -0,0 +1,5 @@
+import "reflect-metadata";
+import { AggregateRoot } from "./aggregate-root";
+import { ClassConstructor } from "class-transformer";
+export declare function getDecoratedPropertyKey(entity: AggregateRoot, eventClass: ClassConstructor<unknown>): string | undefined;
+export declare function EventProcessor(eventClass: ClassConstructor<unknown>): PropertyDecorator;

package/src/lib/{decorators/event-processor.js → event-processor.js}

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EventProcessor = exports.getProcessFunctionKey = void 0;
+exports.EventProcessor = exports.getDecoratedPropertyKey = void 0;
 require("reflect-metadata");
-const METADATA_KEY = "process-event-meta";
-function getProcessFunctionKey(entity, eventClass) {
+const metadata_keys_1 = require("./metadata-keys");
+function getDecoratedPropertyKey(entity, eventClass) {
     const metadataKeys = Reflect.getMetadataKeys(entity);
     if (!metadataKeys || metadataKeys.length == 0) {
         return undefined;
@@ -17,10 +17,10 @@ function getProcessFunctionKey(entity, eventClass) {
     }
     return Reflect.getMetadata(matchingKey, entity).key;
 }
-exports.getProcessFunctionKey = getProcessFunctionKey;
+exports.getDecoratedPropertyKey = getDecoratedPropertyKey;
 function EventProcessor(eventClass) {
     return (propertyParent, propertyKey) => {
-        Reflect.defineMetadata(METADATA_KEY + "-" + propertyKey.toString(), { eventClass: eventClass, key: propertyKey }, propertyParent);
+        Reflect.defineMetadata(metadata_keys_1.EVENT_PROCESSOR_KEY + "-" + propertyKey.toString(), { eventClass: eventClass, key: propertyKey }, propertyParent);
     };
 }
 exports.EventProcessor = EventProcessor;

package/src/lib/event-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-processor.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/event-processor.ts"],"names":[],"mappings":";;;AAAA,4BAA0B;AAG1B,mDAAsD;AAEtD,SAAgB,uBAAuB,CACnC,MAAqB,EACrB,UAAqC;IAErC,MAAM,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IACrD,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,MAAM,IAAI,CAAC,EAAE;QAC3C,OAAO,SAAS,CAAC;KACpB;IAED,MAAM,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE;QAClD,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAC1D,OAAO,QAAQ,CAAC,UAAU,KAAK,UAAU,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,WAAW,EAAE;QACd,OAAO,SAAS,CAAC;KACpB;IAED,OAAO,OAAO,CAAC,WAAW,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC;AACxD,CAAC;AAnBD,0DAmBC;AAED,SAAgB,cAAc,CAAC,UAAqC;IAChE,OAAO,CAAC,cAAc,EAAE,WAAW,EAAE,EAAE;QACnC,OAAO,CAAC,cAAc,CAClB,mCAAmB,GAAG,GAAG,GAAG,WAAW,CAAC,QAAQ,EAAE,EAClD,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW,EAAE,EAC5C,cAAc,CACjB,CAAC;IACN,CAAC,CAAC;AACN,CAAC;AARD,wCAQC"}

package/src/lib/{decorators → exceptions}/event-name-conflict-exception.js.map

@@ -1 +1 @@
-{"version":3,"file":"event-name-conflict-exception.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/decorators/event-name-conflict-exception.ts"],"names":[],"mappings":";;;AAAA,MAAa,0BAA2B,SAAQ,KAAK;IACjD,YAAY,IAAY;QACpB,KAAK,CAAC,GAAG,IAAI,6DAA6D,CAAC,CAAC;IAChF,CAAC;CACJ;AAJD,gEAIC"}
+{"version":3,"file":"event-name-conflict-exception.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/exceptions/event-name-conflict-exception.ts"],"names":[],"mappings":";;;AAAA,MAAa,0BAA2B,SAAQ,KAAK;IACjD,YAAY,IAAY;QACpB,KAAK,CAAC,GAAG,IAAI,6DAA6D,CAAC,CAAC;IAChF,CAAC;CACJ;AAJD,gEAIC"}

package/src/lib/exceptions/id-generation-exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-generation-exception.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/exceptions/id-generation-exception.ts"],"names":[],"mappings":";;;AAAA,MAAa,qBAAsB,SAAQ,KAAK;IAC5C,YAAY,SAAiB,EAAE,cAAsB;QACjD,KAAK,CAAC,mDAAmD,SAAS,eAAe,cAAc,EAAE,CAAC,CAAC;IACvG,CAAC;CACJ;AAJD,sDAIC"}

package/src/lib/exceptions/missing-aggregate-root-name-exception.d.ts

@@ -0,0 +1,3 @@
+export declare class MissingAggregateRootNameException extends Error {
+    constructor(aggregateRootClassName: string);
+}

package/src/lib/exceptions/missing-aggregate-root-name-exception.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MissingAggregateRootNameException = void 0;
+class MissingAggregateRootNameException extends Error {
+    constructor(aggregateRootClassName) {
+        super(`${aggregateRootClassName} is not decorated with @AggregateRootName. Use the decorator to set the name of the aggregate root`);
+    }
+}
+exports.MissingAggregateRootNameException = MissingAggregateRootNameException;
+//# sourceMappingURL=missing-aggregate-root-name-exception.js.map

package/src/lib/exceptions/missing-aggregate-root-name-exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"missing-aggregate-root-name-exception.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/exceptions/missing-aggregate-root-name-exception.ts"],"names":[],"mappings":";;;AAAA,MAAa,iCAAkC,SAAQ,KAAK;IACxD,YAAY,sBAA8B;QACtC,KAAK,CACD,GAAG,sBAAsB,oGAAoG,CAChI,CAAC;IACN,CAAC;CACJ;AAND,8EAMC"}

package/src/lib/exceptions/unknown-event-exception.d.ts

@@ -0,0 +1,3 @@
+export declare class UnknownEventException extends Error {
+    constructor(unregisteredEventNames: Array<string>, missingProcessorEventNames: Array<string>, aggregateRootId: string);
+}

package/src/lib/exceptions/unknown-event-exception.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnknownEventException = void 0;
+class UnknownEventException extends Error {
+    constructor(unregisteredEventNames, missingProcessorEventNames, aggregateRootId) {
+        super(`Found unknown events for aggregate root ${aggregateRootId}. Unregistered : ${unregisteredEventNames.join(", ")}. Missing processor: ${missingProcessorEventNames.join(", ")}`);
+    }
+}
+exports.UnknownEventException = UnknownEventException;
+//# sourceMappingURL=unknown-event-exception.js.map

package/src/lib/exceptions/unknown-event-exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unknown-event-exception.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/exceptions/unknown-event-exception.ts"],"names":[],"mappings":";;;AAAA,MAAa,qBAAsB,SAAQ,KAAK;IAC5C,YACI,sBAAqC,EACrC,0BAAyC,EACzC,eAAuB;QAEvB,KAAK,CACD,2CAA2C,eAAe,oBAAoB,sBAAsB,CAAC,IAAI,CACrG,IAAI,CACP,wBAAwB,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACnE,CAAC;IACN,CAAC;CACJ;AAZD,sDAYC"}

package/src/lib/exceptions/unregistered-event-exception.d.ts

@@ -0,0 +1,3 @@
+export declare class UnregisteredEventException extends Error {
+    constructor(eventClassName: string);
+}

package/src/lib/exceptions/unregistered-event-exception.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnregisteredEventException = void 0;
+class UnregisteredEventException extends Error {
+    constructor(eventClassName) {
+        super(`${eventClassName} is not registered to be processed. Use @RegisteredEvent decorator to register it.`);
+    }
+}
+exports.UnregisteredEventException = UnregisteredEventException;
+//# sourceMappingURL=unregistered-event-exception.js.map

package/src/lib/exceptions/unregistered-event-exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unregistered-event-exception.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/exceptions/unregistered-event-exception.ts"],"names":[],"mappings":";;;AAAA,MAAa,0BAA2B,SAAQ,KAAK;IACjD,YAAY,cAAsB;QAC9B,KAAK,CAAC,GAAG,cAAc,oFAAoF,CAAC,CAAC;IACjH,CAAC;CACJ;AAJD,gEAIC"}

package/src/lib/metadata-keys.d.ts

@@ -0,0 +1,4 @@
+export declare const EVENT_PROCESSOR_KEY = "event-nest-process-event-meta";
+export declare const DOMAIN_EVENT_SUBSCRIPTION_KEY = "event-nest-domain-event-subscription-meta";
+export declare const DOMAIN_EVENT_KEY = "event-nest-domain-event-meta";
+export declare const AGGREGATE_ROOT_NAME_KEY = "event-nest-aggregate-root-name-meta";

package/src/lib/metadata-keys.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AGGREGATE_ROOT_NAME_KEY = exports.DOMAIN_EVENT_KEY = exports.DOMAIN_EVENT_SUBSCRIPTION_KEY = exports.EVENT_PROCESSOR_KEY = void 0;
+exports.EVENT_PROCESSOR_KEY = "event-nest-process-event-meta";
+exports.DOMAIN_EVENT_SUBSCRIPTION_KEY = "event-nest-domain-event-subscription-meta";
+exports.DOMAIN_EVENT_KEY = "event-nest-domain-event-meta";
+exports.AGGREGATE_ROOT_NAME_KEY = "event-nest-aggregate-root-name-meta";
+//# sourceMappingURL=metadata-keys.js.map

package/src/lib/metadata-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-keys.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/metadata-keys.ts"],"names":[],"mappings":";;;AAAa,QAAA,mBAAmB,GAAG,+BAA+B,CAAC;AACtD,QAAA,6BAA6B,GAAG,2CAA2C,CAAC;AAC5E,QAAA,gBAAgB,GAAG,8BAA8B,CAAC;AAClD,QAAA,uBAAuB,GAAG,qCAAqC,CAAC"}

package/src/lib/on-domain-event.d.ts

@@ -0,0 +1,4 @@
+import { AggregateRootAwareEvent } from "./aggregate-root-aware-event";
+export interface OnDomainEvent<T> {
+    onDomainEvent(event: AggregateRootAwareEvent<T>): Promise<unknown>;
+}

package/src/lib/{storage/event-payload.js → on-domain-event.js}

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=event-payload.js.map
+//# sourceMappingURL=on-domain-event.js.map

package/src/lib/on-domain-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"on-domain-event.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/on-domain-event.ts"],"names":[],"mappings":""}

package/src/lib/{decorators/registered-event.d.ts → registered-event.d.ts}

@@ -1,13 +1,13 @@
 import { ClassConstructor } from "class-transformer";
-import { EventPayload } from "../storage/event-payload";
 export declare function RegisteredEvent(eventName: string): ClassDecorator;
 /**
  * Returns the event name that matches the class of the provided object.
  * @param target
  */
-export declare function getEventName(target: EventPayload): string | undefined;
+export declare function getEventName(target: object): string | undefined;
 /**
  * Returns the class that matches the provided name. Or undefined.
  * @param name The event name to be checked.
  */
 export declare function getEventClass<T>(name: string): ClassConstructor<T> | undefined;
+export declare function isRegistered(event: object): boolean;

package/src/lib/{decorators/registered-event.js → registered-event.js}

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getEventClass = exports.getEventName = exports.RegisteredEvent = void 0;
-const event_name_conflict_exception_1 = require("./event-name-conflict-exception");
-const type_utils_1 = require("../utils/type-utils");
+exports.isRegistered = exports.getEventClass = exports.getEventName = exports.RegisteredEvent = void 0;
+const event_name_conflict_exception_1 = require("./exceptions/event-name-conflict-exception");
+const type_utils_1 = require("./utils/type-utils");
 const REGISTRATIONS = [];
 function RegisteredEvent(eventName) {
     return (target) => {
@@ -34,4 +34,8 @@ function getEventClass(name) {
     return (0, type_utils_1.isNil)(found) ? undefined : found.eventClass;
 }
 exports.getEventClass = getEventClass;
+function isRegistered(event) {
+    return !(0, type_utils_1.isNil)(getEventName(event));
+}
+exports.isRegistered = isRegistered;
 //# sourceMappingURL=registered-event.js.map

package/src/lib/registered-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registered-event.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/registered-event.ts"],"names":[],"mappings":";;;AACA,8FAAwF;AACxF,mDAA2C;AAO3C,MAAM,aAAa,GAA6B,EAAE,CAAC;AAEnD,SAAgB,eAAe,CAAC,SAAiB;IAC7C,OAAO,CAAC,MAAM,EAAE,EAAE;QACd,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,YAAY,CAAC,SAAS,KAAK,SAAS,CAAC,EAAE;YAC5E,MAAM,IAAI,0DAA0B,CAAC,SAAS,CAAC,CAAC;SACnD;QACD,aAAa,CAAC,IAAI,CAAC;YACf,SAAS,EAAE,SAAS;YACpB,UAAU,EAAE,MAAM;SACrB,CAAC,CAAC;IACP,CAAC,CAAC;AACN,CAAC;AAVD,0CAUC;AAED;;;GAGG;AACH,SAAgB,YAAY,CAAC,MAAc;IACvC,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,YAAY,CAAC,UAAU,KAAK,MAAM,CAAC,WAAW,CAAC,CAAC;IACnG,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/C,CAAC;AAHD,oCAGC;AAED;;;GAGG;AACH,SAAgB,aAAa,CAAI,IAAY;IACzC,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,YAAY,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC;IACpF,OAAO,IAAA,kBAAK,EAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAE,KAAK,CAAC,UAAkC,CAAC;AAChF,CAAC;AAHD,sCAGC;AAED,SAAgB,YAAY,CAAC,KAAa;IACtC,OAAO,CAAC,IAAA,kBAAK,EAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;AACvC,CAAC;AAFD,oCAEC"}

package/src/lib/storage/abstract-event-store.d.ts

@@ -1,10 +1,12 @@
-import { EventStore } from "./event-store";
+import { AggregateRootClass, EventStore } from "./event-store";
 import { StoredEvent } from "./stored-event";
-import { AggregateRoot } from "../domain/aggregate-root";
+import { AggregateRoot } from "../aggregate-root";
 import { StoredAggregateRoot } from "./stored-aggregate-root";
+import { DomainEventEmitter } from "../domain-event-emitter";
 export declare abstract class AbstractEventStore implements EventStore {
-    protected constructor();
-    abstract findByAggregateRootId(id: string): Promise<Array<StoredEvent>>;
+    private _eventBus;
+    protected constructor(_eventBus: DomainEventEmitter);
+    abstract findByAggregateRootId<T extends AggregateRoot>(aggregateRootClass: AggregateRootClass<T>, id: string): Promise<Array<StoredEvent>>;
     abstract save(events: Array<StoredEvent>, aggregate: StoredAggregateRoot): Promise<Array<StoredEvent>>;
     abstract generateEntityId(): Promise<string>;
     addPublisher<T extends AggregateRoot>(aggregateRoot: T): T;

package/src/lib/storage/abstract-event-store.js

@@ -3,26 +3,35 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AbstractEventStore = void 0;
 const stored_event_1 = require("./stored-event");
 const stored_aggregate_root_1 = require("./stored-aggregate-root");
-const id_generation_exception_1 = require("./id-generation-exception");
+const id_generation_exception_1 = require("../exceptions/id-generation-exception");
+const type_utils_1 = require("../utils/type-utils");
+const aggregate_root_name_1 = require("../aggregate-root-name");
+const missing_aggregate_root_name_exception_1 = require("../exceptions/missing-aggregate-root-name-exception");
 class AbstractEventStore {
     // eslint-disable-next-line @typescript-eslint/no-empty-function
-    constructor() { }
+    constructor(_eventBus) {
+        this._eventBus = _eventBus;
+    }
     addPublisher(aggregateRoot) {
         aggregateRoot.publish = async (events) => {
+            const aggregateRootName = (0, aggregate_root_name_1.getAggregateRootName)(aggregateRoot.constructor);
+            if ((0, type_utils_1.isNil)(aggregateRootName)) {
+                throw new missing_aggregate_root_name_exception_1.MissingAggregateRootNameException(aggregateRoot.constructor.name);
+            }
             if (events.length == 0) {
                 return Promise.resolve([]);
             }
             const ids = await Promise.all(events.map(() => this.generateEntityId()));
-            if (ids.length !== events.length) {
+            if (ids.length !== events.length || !(0, type_utils_1.hasAllValues)(ids)) {
                 throw new id_generation_exception_1.IdGenerationException(ids.length, events.length);
             }
             const storedEvents = events.map((serializable) => {
                 const id = ids.pop();
-                return stored_event_1.StoredEvent.fromPublishedEvent(id, aggregateRoot.id, serializable);
+                return stored_event_1.StoredEvent.fromPublishedEvent(id, aggregateRoot.id, aggregateRootName, serializable.payload);
             });
             const toStore = new stored_aggregate_root_1.StoredAggregateRoot(aggregateRoot.id, aggregateRoot.version);
             return this.save(storedEvents, toStore).then((savedEvents) => {
-                //this._eventBus.publishAll(events);
+                this._eventBus.emitMultiple(events);
                 return Promise.resolve(savedEvents);
             });
         };

package/src/lib/storage/abstract-event-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"abstract-event-store.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/storage/abstract-event-store.ts"],"names":[],"mappings":";;;AACA,iDAA6C;AAG7C,mEAA8D;AAC9D,uEAAkE;AAElE,MAAsB,kBAAkB;IACpC,gEAAgE;IAChE,gBAAyB,CAAC;IAQ1B,YAAY,CAA0B,aAAgB;QAClD,aAAa,CAAC,OAAO,GAAG,KAAK,EAAE,MAA2B,EAAE,EAAE;YAC1D,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,EAAE;gBACpB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;aAC9B;YAED,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC;YACzE,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE;gBAC9B,MAAM,IAAI,+CAAqB,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;aAC9D;YACD,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE;gBAC7C,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,EAAG,CAAC;gBACtB,OAAO,0BAAW,CAAC,kBAAkB,CAAC,EAAE,EAAE,aAAa,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;YAC9E,CAAC,CAAC,CAAC;YAEH,MAAM,OAAO,GAAG,IAAI,2CAAmB,CAAC,aAAa,CAAC,EAAE,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;YACjF,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE;gBACzD,oCAAoC;gBACpC,OAAO,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YACxC,CAAC,CAAC,CAAC;QACP,CAAC,CAAC;QACF,OAAO,aAAa,CAAC;IACzB,CAAC;CACJ;AAjCD,gDAiCC"}
+{"version":3,"file":"abstract-event-store.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/storage/abstract-event-store.ts"],"names":[],"mappings":";;;AACA,iDAA6C;AAE7C,mEAA8D;AAC9D,mFAA8E;AAE9E,oDAA0D;AAE1D,gEAA8D;AAC9D,+GAAwG;AAExG,MAAsB,kBAAkB;IACpC,gEAAgE;IAChE,YAA8B,SAA6B;QAA7B,cAAS,GAAT,SAAS,CAAoB;IAAG,CAAC;IAW/D,YAAY,CAA0B,aAAgB;QAClD,aAAa,CAAC,OAAO,GAAG,KAAK,EAAE,MAA8C,EAAE,EAAE;YAC7E,MAAM,iBAAiB,GAAG,IAAA,0CAAoB,EAAC,aAAa,CAAC,WAAW,CAAC,CAAC;YAC1E,IAAI,IAAA,kBAAK,EAAC,iBAAiB,CAAC,EAAE;gBAC1B,MAAM,IAAI,yEAAiC,CAAC,aAAa,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;aAC/E;YAED,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,EAAE;gBACpB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;aAC9B;YAED,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC;YACzE,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,IAAI,CAAC,IAAA,yBAAY,EAAC,GAAG,CAAC,EAAE;gBACpD,MAAM,IAAI,+CAAqB,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;aAC9D;YACD,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE;gBAC7C,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,EAAG,CAAC;gBACtB,OAAO,0BAAW,CAAC,kBAAkB,CAAC,EAAE,EAAE,aAAa,CAAC,EAAE,EAAE,iBAAiB,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;YACzG,CAAC,CAAC,CAAC;YAEH,MAAM,OAAO,GAAG,IAAI,2CAAmB,CAAC,aAAa,CAAC,EAAE,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;YACjF,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE;gBACzD,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;gBACpC,OAAO,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YACxC,CAAC,CAAC,CAAC;QACP,CAAC,CAAC;QACF,OAAO,aAAa,CAAC;IACzB,CAAC;CACJ;AAzCD,gDAyCC"}

package/src/lib/storage/event-store.d.ts

@@ -1,10 +1,44 @@
 import { StoredEvent } from "./stored-event";
 import { StoredAggregateRoot } from "./stored-aggregate-root";
-import { AggregateRoot } from "../domain/aggregate-root";
+import { AggregateRoot } from "../aggregate-root";
+export type AggregateRootClass<T> = Function & {
+    prototype: T;
+};
 export declare const EVENT_STORE: unique symbol;
+/**
+ * Defines the main EventStore interface that can be used to retrieve and save events. Each implementation of this interface
+ * is unique based on the storage solution that is used.
+ *
+ * To inject it in your NestJS classes, you can use the {@link EVENT_STORE} symbol.
+ */
 export interface EventStore {
+    /**
+     * Each aggregate root object needs some way of connecting to the event store in order to be able to store its events.
+     * Since these objects are not handled by NestJS dependency injection, we need to provide a way for them to get a reference to the event store and this is
+     * the method that does that. It takes an aggregate root object and returns the same object but with a publish method attached to it.
+     * @param aggregateRoot The aggregate root object to which we want to add a publish method.
+     */
     addPublisher<T extends AggregateRoot>(aggregateRoot: T): T;
-    findByAggregateRootId(id: string): Promise<Array<StoredEvent>>;
+    /**
+     * Finds all events that are associated with the provided aggregate root id and match the aggregate root name which
+     * is resolved from the aggregate root class. These events can later be used to recreate an aggregate root object.
+     * @param aggregateRootClass The class of the aggregate root for which the store will search for events
+     * @param id The unique id of the aggregate root object
+     */
+    findByAggregateRootId<T extends AggregateRoot>(aggregateRootClass: AggregateRootClass<T>, id: string): Promise<Array<StoredEvent>>;
+    /**
+     * Saves the provided event and aggregate root object. Before saving the aggregate root object, the method will check
+     * if the version of the aggregate root object is the same as the version of the aggregate root object in the database.
+     * If there's a version mismatch, the method will throw an exception. Otherwise, the method will increase the version
+     * of the aggregate root and then proceed to save the aggregate root and the event objects.
+     * @param events The events to save
+     * @param aggregate The aggregate root object that matches the events
+     */
     save(events: Array<StoredEvent>, aggregate: StoredAggregateRoot): Promise<Array<StoredEvent>>;
+    /**
+     * Each storage solution has its own way of dealing with unique ids. This method's implementation should reflect
+     * the way the storage solution generates unique ids. For example, in a MongoDB database this would usually return
+     * a String representation of a MongoDB ObjectId.
+     */
     generateEntityId(): Promise<string>;
 }

package/src/lib/storage/event-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"event-store.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/storage/event-store.ts"],"names":[],"mappings":";;;AAIa,QAAA,WAAW,GAAG,MAAM,CAAC,wBAAwB,CAAC,CAAC"}
+{"version":3,"file":"event-store.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/storage/event-store.ts"],"names":[],"mappings":";;;AAUM,QAAA,WAAW,GAAG,MAAM,CAAC,wBAAwB,CAAC,CAAC"}

package/src/lib/storage/stored-aggregate-root.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Defines a simple representation of an aggregate root that is persisted. This information needs to be persisted so
+ * that we can always have a way of knowing what is the current version of the aggregate root object.
+ */
 export declare class StoredAggregateRoot {
     id: string;
     version: number;

package/src/lib/storage/stored-aggregate-root.js

@@ -1,6 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StoredAggregateRoot = void 0;
+/**
+ * Defines a simple representation of an aggregate root that is persisted. This information needs to be persisted so
+ * that we can always have a way of knowing what is the current version of the aggregate root object.
+ */
 class StoredAggregateRoot {
     constructor(id, version) {
         this.id = id;

package/src/lib/storage/stored-aggregate-root.js.map

@@ -1 +1 @@
-{"version":3,"file":"stored-aggregate-root.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/storage/stored-aggregate-root.ts"],"names":[],"mappings":";;;AAAA,MAAa,mBAAmB;IAC5B,YAAmB,EAAU,EAAS,OAAe;QAAlC,OAAE,GAAF,EAAE,CAAQ;QAAS,YAAO,GAAP,OAAO,CAAQ;IAAG,CAAC;CAC5D;AAFD,kDAEC"}
+{"version":3,"file":"stored-aggregate-root.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/storage/stored-aggregate-root.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,MAAa,mBAAmB;IAC5B,YAAmB,EAAU,EAAS,OAAe;QAAlC,OAAE,GAAF,EAAE,CAAQ;QAAS,YAAO,GAAP,OAAO,CAAQ;IAAG,CAAC;CAC5D;AAFD,kDAEC"}

package/src/lib/storage/stored-event.d.ts

@@ -1,5 +1,14 @@
 import { ClassConstructor } from "class-transformer";
-import { EventPayload } from "./event-payload";
+/**
+ * Represents an event that will be persisted according to the storage solution that is used.
+ * The event is defined by metadata like aggregate root id, version and creation date, and it also includes its payload
+ * which can be any object based on the use case. Payload serialization is done using class-transformer
+ * (https://github.com/typestack/class-transformer) so the payload needs to follow the rules defined by that library.
+ *
+ * The class constructor is marked as private to force the use of the static factory methods which are implemented based
+ * on the use case to create the event.
+ *
+ */
 export declare class StoredEvent {
     aggregateRootVersion: number;
     private readonly _id;
@@ -7,13 +16,38 @@ export declare class StoredEvent {
     private _createdAt;
     private _payload;
     private _eventName;
+    private _aggregateRootName;
     private constructor();
-    static fromPublishedEvent(id: string, aggregateRootId: string, publishedEvent: EventPayload): StoredEvent;
-    static fromStorage(id: string, aggregateRootId: string, eventName: string, createdAt: Date, aggregateRootVersion: number, payload: unknown): StoredEvent;
+    /**
+     * Factory method that will create a new event based on the provided info. Typically, it should be used when
+     * creating a new event that will be persisted. In this case, the payload is serialized to a plain object using the
+     * class-transformer library.
+     * @param id The event id
+     * @param aggregateRootId The aggregate root id
+     * @param aggregateRootName The name of the aggregate root
+     * @param payload The event payload as an object.
+     */
+    static fromPublishedEvent(id: string, aggregateRootId: string, aggregateRootName: string, payload: object): StoredEvent;
+    /**
+     * Factory method that will create a new event based on the provided info. Typically, it should be used when creating
+     * an event that is already persisted, and we want to create a new instance of it to pass it to an aggregate root.
+     * In this case the payload is not mapped to a class instance. {@link getPayloadAs} should be later used for this
+     * kind of mapping.
+     *
+     * @param id The event id
+     * @param aggregateRootId The aggregate root id
+     * @param eventName The event name
+     * @param createdAt The event creation date
+     * @param aggregateRootVersion The aggregate root version
+     * @param aggregateRootName The aggregate root name
+     * @param payload The event payload as an object.
+     */
+    static fromStorage(id: string, aggregateRootId: string, eventName: string, createdAt: Date, aggregateRootVersion: number, aggregateRootName: string, payload: unknown): StoredEvent;
     getPayloadAs<T>(payloadClass: ClassConstructor<T>): T;
     get payload(): unknown;
     get id(): string;
     get aggregateRootId(): string;
     get createdAt(): Date;
     get eventName(): string;
+    get aggregateRootName(): string;
 }

package/src/lib/storage/stored-event.js

@@ -2,28 +2,63 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StoredEvent = void 0;
 const class_transformer_1 = require("class-transformer");
-const registered_event_1 = require("../decorators/registered-event");
+const registered_event_1 = require("../registered-event");
 const type_utils_1 = require("../utils/type-utils");
+/**
+ * Represents an event that will be persisted according to the storage solution that is used.
+ * The event is defined by metadata like aggregate root id, version and creation date, and it also includes its payload
+ * which can be any object based on the use case. Payload serialization is done using class-transformer
+ * (https://github.com/typestack/class-transformer) so the payload needs to follow the rules defined by that library.
+ *
+ * The class constructor is marked as private to force the use of the static factory methods which are implemented based
+ * on the use case to create the event.
+ *
+ */
 class StoredEvent {
     constructor(id, aggregateRootId) {
         this._aggregateRootId = aggregateRootId;
         this._id = id;
     }
-    static fromPublishedEvent(id, aggregateRootId, publishedEvent) {
+    /**
+     * Factory method that will create a new event based on the provided info. Typically, it should be used when
+     * creating a new event that will be persisted. In this case, the payload is serialized to a plain object using the
+     * class-transformer library.
+     * @param id The event id
+     * @param aggregateRootId The aggregate root id
+     * @param aggregateRootName The name of the aggregate root
+     * @param payload The event payload as an object.
+     */
+    static fromPublishedEvent(id, aggregateRootId, aggregateRootName, payload) {
         const newEvent = new StoredEvent(id, aggregateRootId);
         newEvent._createdAt = new Date(new Date().toUTCString());
-        const eventName = (0, registered_event_1.getEventName)(publishedEvent);
+        newEvent._aggregateRootName = aggregateRootName;
+        const eventName = (0, registered_event_1.getEventName)(payload);
         if (!(0, type_utils_1.isNil)(eventName)) {
-            newEvent._payload = (0, class_transformer_1.instanceToPlain)(publishedEvent);
+            newEvent._payload = (0, class_transformer_1.instanceToPlain)(payload);
             newEvent._eventName = eventName;
         }
         return newEvent;
     }
-    static fromStorage(id, aggregateRootId, eventName, createdAt, aggregateRootVersion, payload) {
+    /**
+     * Factory method that will create a new event based on the provided info. Typically, it should be used when creating
+     * an event that is already persisted, and we want to create a new instance of it to pass it to an aggregate root.
+     * In this case the payload is not mapped to a class instance. {@link getPayloadAs} should be later used for this
+     * kind of mapping.
+     *
+     * @param id The event id
+     * @param aggregateRootId The aggregate root id
+     * @param eventName The event name
+     * @param createdAt The event creation date
+     * @param aggregateRootVersion The aggregate root version
+     * @param aggregateRootName The aggregate root name
+     * @param payload The event payload as an object.
+     */
+    static fromStorage(id, aggregateRootId, eventName, createdAt, aggregateRootVersion, aggregateRootName, payload) {
         const newEvent = new StoredEvent(id, aggregateRootId);
         newEvent._eventName = eventName;
         newEvent._createdAt = createdAt;
         newEvent.aggregateRootVersion = aggregateRootVersion;
+        newEvent._aggregateRootName = aggregateRootName;
         newEvent._payload = payload;
         return newEvent;
     }
@@ -45,6 +80,9 @@ class StoredEvent {
     get eventName() {
         return this._eventName;
     }
+    get aggregateRootName() {
+        return this._aggregateRootName;
+    }
 }
 exports.StoredEvent = StoredEvent;
 //# sourceMappingURL=stored-event.js.map

package/src/lib/storage/stored-event.js.map

@@ -1 +1 @@
-{"version":3,"file":"stored-event.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/storage/stored-event.ts"],"names":[],"mappings":";;;AAAA,yDAAoF;AAEpF,qEAA8D;AAC9D,oDAA4C;AAE5C,MAAa,WAAW;IASpB,YAAoB,EAAU,EAAE,eAAuB;QACnD,IAAI,CAAC,gBAAgB,GAAG,eAAe,CAAC;QACxC,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;IAClB,CAAC;IAED,MAAM,CAAC,kBAAkB,CAAC,EAAU,EAAE,eAAuB,EAAE,cAA4B;QACvF,MAAM,QAAQ,GAAG,IAAI,WAAW,CAAC,EAAE,EAAE,eAAe,CAAC,CAAC;QACtD,QAAQ,CAAC,UAAU,GAAG,IAAI,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;QAEzD,MAAM,SAAS,GAAG,IAAA,+BAAY,EAAC,cAAc,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAA,kBAAK,EAAC,SAAS,CAAC,EAAE;YACnB,QAAQ,CAAC,QAAQ,GAAG,IAAA,mCAAe,EAAC,cAAc,CAAC,CAAC;YACpD,QAAQ,CAAC,UAAU,GAAG,SAAS,CAAC;SACnC;QACD,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED,MAAM,CAAC,WAAW,CACd,EAAU,EACV,eAAuB,EACvB,SAAiB,EACjB,SAAe,EACf,oBAA4B,EAC5B,OAAgB;QAEhB,MAAM,QAAQ,GAAG,IAAI,WAAW,CAAC,EAAE,EAAE,eAAe,CAAC,CAAC;QACtD,QAAQ,CAAC,UAAU,GAAG,SAAS,CAAC;QAChC,QAAQ,CAAC,UAAU,GAAG,SAAS,CAAC;QAChC,QAAQ,CAAC,oBAAoB,GAAG,oBAAoB,CAAC;QACrD,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC;QAC5B,OAAO,QAAQ,CAAC;IACpB,CAAC;IAEM,YAAY,CAAI,YAAiC;QACpD,OAAO,IAAA,gCAAY,EAAC,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrD,CAAC;IAED,IAAI,OAAO;QACP,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED,IAAI,EAAE;QACF,OAAO,IAAI,CAAC,GAAG,CAAC;IACpB,CAAC;IAED,IAAI,eAAe;QACf,OAAO,IAAI,CAAC,gBAAgB,CAAC;IACjC,CAAC;IAED,IAAI,SAAS;QACT,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IAED,IAAI,SAAS;QACT,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;CACJ;AAjED,kCAiEC"}
+{"version":3,"file":"stored-event.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/storage/stored-event.ts"],"names":[],"mappings":";;;AAAA,yDAAoF;AACpF,0DAAmD;AACnD,oDAA4C;AAE5C;;;;;;;;;GASG;AACH,MAAa,WAAW;IAUpB,YAAoB,EAAU,EAAE,eAAuB;QACnD,IAAI,CAAC,gBAAgB,GAAG,eAAe,CAAC;QACxC,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;IAClB,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,kBAAkB,CACrB,EAAU,EACV,eAAuB,EACvB,iBAAyB,EACzB,OAAe;QAEf,MAAM,QAAQ,GAAG,IAAI,WAAW,CAAC,EAAE,EAAE,eAAe,CAAC,CAAC;QACtD,QAAQ,CAAC,UAAU,GAAG,IAAI,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;QACzD,QAAQ,CAAC,kBAAkB,GAAG,iBAAiB,CAAC;QAEhD,MAAM,SAAS,GAAG,IAAA,+BAAY,EAAC,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,IAAA,kBAAK,EAAC,SAAS,CAAC,EAAE;YACnB,QAAQ,CAAC,QAAQ,GAAG,IAAA,mCAAe,EAAC,OAAO,CAAC,CAAC;YAC7C,QAAQ,CAAC,UAAU,GAAG,SAAS,CAAC;SACnC;QACD,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,WAAW,CACd,EAAU,EACV,eAAuB,EACvB,SAAiB,EACjB,SAAe,EACf,oBAA4B,EAC5B,iBAAyB,EACzB,OAAgB;QAEhB,MAAM,QAAQ,GAAG,IAAI,WAAW,CAAC,EAAE,EAAE,eAAe,CAAC,CAAC;QACtD,QAAQ,CAAC,UAAU,GAAG,SAAS,CAAC;QAChC,QAAQ,CAAC,UAAU,GAAG,SAAS,CAAC;QAChC,QAAQ,CAAC,oBAAoB,GAAG,oBAAoB,CAAC;QACrD,QAAQ,CAAC,kBAAkB,GAAG,iBAAiB,CAAC;QAChD,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC;QAC5B,OAAO,QAAQ,CAAC;IACpB,CAAC;IAEM,YAAY,CAAI,YAAiC;QACpD,OAAO,IAAA,gCAAY,EAAC,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrD,CAAC;IAED,IAAI,OAAO;QACP,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED,IAAI,EAAE;QACF,OAAO,IAAI,CAAC,GAAG,CAAC;IACpB,CAAC;IAED,IAAI,eAAe;QACf,OAAO,IAAI,CAAC,gBAAgB,CAAC;IACjC,CAAC;IAED,IAAI,SAAS;QACT,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IAED,IAAI,SAAS;QACT,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IAED,IAAI,iBAAiB;QACjB,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACnC,CAAC;CACJ;AArGD,kCAqGC"}

package/src/lib/decorators/event-processor.d.ts

@@ -1,5 +0,0 @@
-import "reflect-metadata";
-import { AggregateRoot } from "../domain/aggregate-root";
-import { ClassConstructor } from "class-transformer";
-export declare function getProcessFunctionKey(entity: AggregateRoot, eventClass: ClassConstructor<unknown>): string | undefined;
-export declare function EventProcessor(eventClass: ClassConstructor<unknown>): PropertyDecorator;

package/src/lib/decorators/event-processor.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"event-processor.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/decorators/event-processor.ts"],"names":[],"mappings":";;;AAAA,4BAA0B;AAI1B,MAAM,YAAY,GAAG,oBAAoB,CAAC;AAE1C,SAAgB,qBAAqB,CACjC,MAAqB,EACrB,UAAqC;IAErC,MAAM,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IACrD,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,MAAM,IAAI,CAAC,EAAE;QAC3C,OAAO,SAAS,CAAC;KACpB;IAED,MAAM,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE;QAClD,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAC1D,OAAO,QAAQ,CAAC,UAAU,KAAK,UAAU,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,WAAW,EAAE;QACd,OAAO,SAAS,CAAC;KACpB;IAED,OAAO,OAAO,CAAC,WAAW,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC;AACxD,CAAC;AAnBD,sDAmBC;AAED,SAAgB,cAAc,CAAC,UAAqC;IAChE,OAAO,CAAC,cAAc,EAAE,WAAW,EAAE,EAAE;QACnC,OAAO,CAAC,cAAc,CAClB,YAAY,GAAG,GAAG,GAAG,WAAW,CAAC,QAAQ,EAAE,EAC3C,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW,EAAE,EAC5C,cAAc,CACjB,CAAC;IACN,CAAC,CAAC;AACN,CAAC;AARD,wCAQC"}