@pocket-architect/core 0.1.18 → 0.1.20

package/README.md

@@ -0,0 +1,102 @@
+## Entity
+
+### Snapshots
+
+```typescript
+// Створює копію властивостей сутності у вигляді простого об'єкта.
+// Також зберігає початковий стан для відстеження змін (dirty checking).
+const snapshot = entity.snapshot();
+
+entity.isDirty(); // Повертає true, якщо сутність була змінена після створення знімка.
+entity.snapshotDiff(); // Повертає об'єкт з відмінностями між поточним станом сутності та знімком. Або null, якщо змін немає.
+```
+
+## Events
+
+### EventBus
+
+Сутність для керування подіями в системі.
+В монолітних застосунках зазвичай використовується один глобальний EventBus і його можна описати за допомогою InMemoryEventBus, не потрібно залучати чергу, бо всі обробники працюють в одному процесі.
+
+```typescript
+// Спершу треба описати події, які є в домені. Для цього є клас DomainEvent, який треба наслідувати.
+class UserCreatedEvent extends DomainEvent<{ userId: string; username: string }> {
+  readonly eventName = 'UserCreatedEvent'; // без цього не буде працювати статична типізація
+}
+class UserUpdatedEvent extends DomainEvent<{ userId: string; username: string }> {
+  readonly eventName = 'UserUpdatedEvent';
+}
+
+// Далі створюємо підписника на події, реалізуючи інтерфейс DomainEventSubscriber
+class NewUserSubscriber implements DomainEventSubscriber {
+  // Підписуємося на події, які нас цікавлять
+  subscribedTo() {
+    return [UserCreatedEvent, UserUpdatedEvent];
+  }
+  
+  // Реалізуємо логіку обробки подій
+  async on(domainEvent: UserCreatedEvent|UserUpdatedEvent) {
+    console.log('Event received:', domainEvent);
+  }
+}
+
+// Далі створюємо EventBus і реєструємо підписника
+const eventBus = new InMemoryEventBus();
+const subscriber = new NewUserSubscriber();
+eventBus.addSubscribers([subscriber]);
+const event = new UserCreatedEvent({ userId: '1', username: 'john_doe' });
+const event2 = new UserUpdatedEvent({ userId: '1', username: 'john_doe_updated' });
+// Публікуємо події
+await eventBus.publish([event, event2]);
+```
+
+У поєднанні snapshot та EventBus можна реалізувати відстеження змін в сутностях і публікації відповідних подій.
+
+```typescript
+class UserId extends EntityId<string> {}
+
+interface IUser {
+  id: UserId;
+  username: string;
+}
+
+class User extends Entity<IUser, string, UserId> {
+}
+
+class UserCreatedEvent extends DomainEvent<Partial<IUser>> {
+  readonly eventName = 'UserCreatedEvent'; // без цього не буде працювати статична типізація
+}
+
+class ChangeLoggerSubscriber implements DomainEventSubscriber {
+  // Підписуємося на події, які нас цікавлять
+  subscribedTo() {
+    return [UserCreatedEvent];
+  }
+
+  // Реалізуємо логіку обробки подій
+  async on(domainEvent: UserCreatedEvent) {
+    console.log('Username changed:', domainEvent.username);
+  }
+}
+
+// Далі створюємо EventBus і реєструємо підписника
+const eventBus = new InMemoryEventBus();
+const subscriber = new NewUserSubscriber();
+eventBus.addSubscribers([subscriber]);
+
+const user = User.create({ id: new UserId('1'), username: 'john_doe' });
+// Створюємо знімок початкового стану
+user.snapshot();
+// Змінюємо ім'я користувача
+user.username = 'john_doe_updated';
+// Перевіряємо, чи є зміни
+if (user.isDirty()) {
+  const diff = user.snapshotDiff();
+  if (diff) {
+    // записуємо подію в чергу (не publish). Бо якщо в циклі може бути багато подій і їх треба назбирати, а потім виконати, тому збираємо через push
+    eventBus.push(new UserCreatedEvent(diff));
+  }
+}
+// Публікуємо всі події в черзі
+await eventBus.publish();
+```

package/build/AggregateRoot.d.ts

@@ -1,9 +1,4 @@
 import { Entity } from './Entity';
 import { EntityId } from './EntityId';
-import { DomainEvent } from "./DomainEvent";
 export declare abstract class AggregateRoot<T, E, H extends EntityId<E>> extends Entity<T, E, H> {
-    private _domainEvents;
-    pullDomainEvents(): DomainEvent<E>[];
-    pushDomainEvent(event: DomainEvent<E>): void;
 }
-export type AnyAggregateRoot<T> = AggregateRoot<any, T, any>;

package/build/AggregateRoot.js

@@ -6,18 +6,8 @@ var Entity_1 = require("./Entity");
 var AggregateRoot = /** @class */ (function (_super) {
     tslib_1.__extends(AggregateRoot, _super);
     function AggregateRoot() {
-        var _this = _super !== null && _super.apply(this, arguments) || this;
-        _this._domainEvents = [];
-        return _this;
+        return _super !== null && _super.apply(this, arguments) || this;
     }
-    AggregateRoot.prototype.pullDomainEvents = function () {
-        var domainEvents = this._domainEvents.slice();
-        this._domainEvents = [];
-        return domainEvents;
-    };
-    AggregateRoot.prototype.pushDomainEvent = function (event) {
-        this._domainEvents.push(event);
-    };
     return AggregateRoot;
 }(Entity_1.Entity));
 exports.AggregateRoot = AggregateRoot;

package/build/AggregateRoot.js.map

@@ -1 +1 @@
-{"version":3,"file":"AggregateRoot.js","sourceRoot":"","sources":["../src/AggregateRoot.ts"],"names":[],"mappings":";;;;AAAA,mCAAkC;AAIlC;IAAyE,yCAAe;IAAxF;;QACU,mBAAa,GAAqB,EAAE,CAAC;;IAW/C,CAAC;IATC,wCAAgB,GAAhB;QACE,IAAM,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;QAChD,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC;QACxB,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,uCAAe,GAAf,UAAgB,KAAqB;QACnC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IACH,oBAAC;AAAD,CAAC,AAZD,CAAyE,eAAM,GAY9E;AAZqB,sCAAa"}
+{"version":3,"file":"AggregateRoot.js","sourceRoot":"","sources":["../src/AggregateRoot.ts"],"names":[],"mappings":";;;;AAAA,mCAAkC;AAGlC;IAAyE,yCAAe;IAAxF;;IACA,CAAC;IAAD,oBAAC;AAAD,CAAC,AADD,CAAyE,eAAM,GAC9E;AADqB,sCAAa"}

package/build/DomainEvent.d.ts

@@ -1,16 +1,12 @@
 import { EntityId } from "./EntityId";
-import { AnyAggregateRoot } from "./AggregateRoot";
 export declare abstract class DomainEvent<H> {
     static EVENT_NAME: string;
-    readonly aggregate: AnyAggregateRoot<H>;
-    readonly aggregateId: H;
-    readonly eventId: EntityId<H>;
+    readonly props: H;
+    readonly eventId: EntityId<never>;
     readonly occurredOn: Date;
     readonly eventName: string;
-    constructor(aggregate: AnyAggregateRoot<H>, eventId?: EntityId<H>, occurredOn?: Date);
-    abstract toPrimitives(): DomainEventAttributes;
+    constructor(props: H, eventId?: EntityId<never>, occurredOn?: Date);
+    toPrimitives(): H;
 }
 export type AnyDomainEvent = DomainEvent<any>;
 export type DomainEventClass = typeof DomainEvent<any>;
-type DomainEventAttributes = any;
-export {};

package/build/DomainEvent.js

@@ -3,14 +3,18 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DomainEvent = void 0;
 var EntityId_1 = require("./EntityId");
 var DomainEvent = /** @class */ (function () {
-    function DomainEvent(aggregate, eventId, occurredOn) {
+    function DomainEvent(props, eventId, occurredOn) {
+        var _a;
+        this.props = props;
         var event = this.constructor;
-        this.eventName = event.EVENT_NAME;
+        this.eventName = (_a = event.EVENT_NAME) !== null && _a !== void 0 ? _a : this.constructor.name;
         this.eventId = eventId || new EntityId_1.EntityId();
-        this.aggregate = aggregate;
-        this.aggregateId = aggregate.id;
         this.occurredOn = occurredOn || new Date();
     }
+    DomainEvent.prototype.toPrimitives = function () {
+        return this.props;
+    };
+    ;
     return DomainEvent;
 }());
 exports.DomainEvent = DomainEvent;

package/build/DomainEvent.js.map

@@ -1 +1 @@
-{"version":3,"file":"DomainEvent.js","sourceRoot":"","sources":["../src/DomainEvent.ts"],"names":[],"mappings":";;;AAAA,uCAAoC;AAGpC;IASE,qBAAY,SAA8B,EAAE,OAAqB,EAAE,UAAiB;QAClF,IAAM,KAAK,GAAuB,IAAI,CAAC,WAAW,CAAC;QACnD,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,UAAU,CAAC;QAClC,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,IAAI,mBAAQ,EAAK,CAAC;QAC5C,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC,EAAE,CAAC;QAChC,IAAI,CAAC,UAAU,GAAG,UAAU,IAAI,IAAI,IAAI,EAAE,CAAC;IAC7C,CAAC;IAGH,kBAAC;AAAD,CAAC,AAnBD,IAmBC;AAnBqB,kCAAW"}
+{"version":3,"file":"DomainEvent.js","sourceRoot":"","sources":["../src/DomainEvent.ts"],"names":[],"mappings":";;;AAAA,uCAAoC;AAEpC;IAQE,qBAAY,KAAQ,EAAE,OAAyB,EAAE,UAAiB;;QAChE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QAEnB,IAAM,KAAK,GAAuB,IAAI,CAAC,WAAW,CAAC;QACnD,IAAI,CAAC,SAAS,GAAG,MAAA,KAAK,CAAC,UAAU,mCAAI,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAC3D,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,IAAI,mBAAQ,EAAS,CAAC;QAChD,IAAI,CAAC,UAAU,GAAG,UAAU,IAAI,IAAI,IAAI,EAAE,CAAC;IAC7C,CAAC;IAED,kCAAY,GAAZ;QACE,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAAA,CAAC;IACJ,kBAAC;AAAD,CAAC,AApBD,IAoBC;AApBqB,kCAAW"}

package/build/Entity.d.ts

@@ -2,9 +2,14 @@ import { EntityId } from './EntityId';
 export declare abstract class Entity<T, E, H extends EntityId<E>> {
     protected readonly _id: H;
     protected props: T;
+    protected _snapshot: string;
+    snapshot(): T;
+    snapshotDiff(): Partial<T> | null;
+    isDirty(): boolean;
     protected constructor(props: T, id?: H | E);
     equals(object?: Entity<T, E, H>): boolean;
     get id(): H;
     toPrimitive(): T;
-    toJSON(): T;
+    toJSON(): any;
+    toSnapshot(): any;
 }

package/build/Entity.js

@@ -15,6 +15,31 @@ var Entity = /** @class */ (function () {
         }
         this.props = props;
     }
+    Entity.prototype.snapshot = function () {
+        this._snapshot = JSON.stringify(this.props);
+        var copy = JSON.parse(this._snapshot);
+        Object.freeze(copy);
+        return copy;
+    };
+    Entity.prototype.snapshotDiff = function () {
+        if (!this._snapshot) {
+            return null;
+        }
+        var diffs = {};
+        var copy = JSON.parse(this._snapshot);
+        for (var key in this.props) {
+            if (JSON.stringify(this.props[key]) !== JSON.stringify(copy[key])) {
+                diffs[key] = this.props[key];
+            }
+        }
+        return Object.keys(diffs).length > 0 ? diffs : null;
+    };
+    Entity.prototype.isDirty = function () {
+        if (!this._snapshot) {
+            return false;
+        }
+        return this._snapshot !== JSON.stringify(this.props);
+    };
     Entity.prototype.equals = function (object) {
         if (object === null || object === undefined) {
             return false;
@@ -37,9 +62,14 @@ var Entity = /** @class */ (function () {
     Entity.prototype.toPrimitive = function () {
         return this.props;
     };
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     Entity.prototype.toJSON = function () {
         return this.toPrimitive();
     };
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    Entity.prototype.toSnapshot = function () {
+        return this.toPrimitive();
+    };
     return Entity;
 }());
 exports.Entity = Entity;

package/build/Entity.js.map

@@ -1 +1 @@
-{"version":3,"file":"Entity.js","sourceRoot":"","sources":["../src/Entity.ts"],"names":[],"mappings":";;;AAAA,uCAAsC;AAEtC,IAAM,QAAQ,GAAG,UAA8B,CAAkB;IAC/D,OAAO,CAAC,YAAY,MAAM,CAAA;AAC5B,CAAC,CAAA;AAED;IAIE,gBAAsB,KAAQ,EAAE,EAAQ;QACtC,IAAI,EAAE,EAAE,CAAC;YACP,IAAI,CAAC,GAAG,GAAM,CAAC,OAAO,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,mBAAQ,CAAI,EAAE,CAAC,CAAC,CAAC;QACpE,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,GAAG,GAAM,CAAC,IAAI,mBAAQ,EAAE,CAAC,CAAC;QACjC,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;IAEM,uBAAM,GAAb,UAAc,MAAwB;QACpC,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YAC5C,OAAO,KAAK,CAAA;QACd,CAAC;QAED,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACpB,OAAO,IAAI,CAAA;QACb,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACtB,OAAO,KAAK,CAAA;QACd,CAAC;QAED,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;IAED,sBAAI,sBAAE;aAAN;YACE,OAAO,IAAI,CAAC,GAAG,CAAA;QACjB,CAAC;;;OAAA;IAED,4BAAW,GAAX;QACE,OAAO,IAAI,CAAC,KAAK,CAAA;IACnB,CAAC;IAED,uBAAM,GAAN;QACE,OAAO,IAAI,CAAC,WAAW,EAAE,CAAA;IAC3B,CAAC;IACH,aAAC;AAAD,CAAC,AAxCD,IAwCC;AAxCqB,wBAAM"}
+{"version":3,"file":"Entity.js","sourceRoot":"","sources":["../src/Entity.ts"],"names":[],"mappings":"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"}

package/build/Entity.spec.js

@@ -11,23 +11,37 @@ var TestEntity = /** @class */ (function (_super) {
     TestEntity.create = function (props, id) {
         return new TestEntity(props, id);
     };
+    Object.defineProperty(TestEntity.prototype, "name", {
+        set: function (name) {
+            this.props.name = name;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(TestEntity.prototype, "testId", {
+        set: function (val) {
+            this.props.testId = val;
+        },
+        enumerable: false,
+        configurable: true
+    });
     return TestEntity;
 }(Entity_1.Entity));
 describe('Entity', function () {
     var entity;
     beforeAll(function () {
-        entity = TestEntity.create({ name: 'test' }, 1);
+        entity = TestEntity.create({ name: 'test', testId: new EntityId_1.EntityId('1') }, '1');
     });
     test('base', function () { return tslib_1.__awaiter(void 0, void 0, void 0, function () {
         var entityNew, entity2, entity3;
         return tslib_1.__generator(this, function (_a) {
             entityNew = TestEntity.create({ name: 'test2' });
             expect(entityNew.id.toString().length).toEqual(36); // random id
-            entity2 = TestEntity.create({ name: 'test2' }, 1);
+            entity2 = TestEntity.create({ name: 'test2' }, '1');
             expect(entity.equals(entity2)).toBeTruthy(); // same id
             expect(entity.equals(entity)).toBeTruthy(); // same instance
             expect(entity.equals(null)).toBeFalsy(); // null
-            expect(entity.equals({ id: new EntityId_1.EntityId(1) })).toBeFalsy(); // not Entity
+            expect(entity.equals({ id: new EntityId_1.EntityId('1') })).toBeFalsy(); // not Entity
             expect(entity.id.toPrimitive()).toEqual('1');
             expect(entity.id.toString()).toEqual('6061cf31-edcb-5d22-9adc-927af7c186fa');
             entity3 = TestEntity.create({ name: 'test2' }, entity.id);
@@ -37,5 +51,21 @@ describe('Entity', function () {
             return [2 /*return*/];
         });
     }); });
+    test('snapshot', function () { return tslib_1.__awaiter(void 0, void 0, void 0, function () {
+        var snapshot;
+        return tslib_1.__generator(this, function (_a) {
+            snapshot = entity.snapshot();
+            expect(snapshot).toEqual({ name: 'test', testId: new EntityId_1.EntityId('1') });
+            expect(function () {
+                snapshot.name = 'changed';
+            }).toThrow();
+            expect(entity.isDirty()).toEqual(false);
+            expect(entity.snapshotDiff()).toEqual(null);
+            entity.name = 'test changed';
+            expect(entity.isDirty()).toEqual(true);
+            expect(entity.snapshotDiff()).toEqual({ "name": "test changed" });
+            return [2 /*return*/];
+        });
+    }); });
 });
 //# sourceMappingURL=Entity.spec.js.map

package/build/Entity.spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"Entity.spec.js","sourceRoot":"","sources":["../src/Entity.spec.ts"],"names":[],"mappings":";;;AAAA,mCAAkC;AAClC,uCAAsC;AAKtC;IAAyB,sCAA2C;IAApE;;IAIA,CAAC;IAHQ,iBAAM,GAAb,UAAc,KAAgB,EAAE,EAA2B;QACzD,OAAO,IAAI,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACnC,CAAC;IACH,iBAAC;AAAD,CAAC,AAJD,CAAyB,eAAM,GAI9B;AAED,QAAQ,CAAC,QAAQ,EAAE;IACjB,IAAI,MAAkB,CAAC;IAEvB,SAAS,CAAC;QACR,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,MAAM,EAAE;;;YACL,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;YACvD,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY;YAE1D,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;YACxD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,UAAU;YACvD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,gBAAgB;YAC5D,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,OAAO;YAChD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAa,EAAE,EAAE,EAAE,IAAI,mBAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,aAAa;YACrF,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC7C,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,sCAAsC,CAAC,CAAC;YAEvE,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;YAChE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,UAAU;YACvD,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC9C,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,sCAAsC,CAAC,CAAC;;;SAC/E,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"Entity.spec.js","sourceRoot":"","sources":["../src/Entity.spec.ts"],"names":[],"mappings":"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"}

package/build/EntityId.d.ts

@@ -1,11 +1,11 @@
 export declare class EntityId<T> {
     protected _recordId: T | null;
     protected _uuid: string;
-    constructor(recordId?: T, isHash?: boolean, uuid?: string);
+    constructor(recordId?: T | string, isHash?: boolean, uuid?: string);
     private createUUID;
     get hashOptions(): [string, number];
     toHash(): string;
-    fromHash(hash: string): EntityId<T>;
+    protected fromHash(hash: string): EntityId<T>;
     toPrimitive(): T;
     toString(): string;
     equals(id: EntityId<T>): boolean;

package/build/EntityId.js.map

@@ -1 +1 @@
-{"version":3,"file":"EntityId.js","sourceRoot":"","sources":["../src/EntityId.ts"],"names":[],"mappings":";;;;AAAA,0EAAuC;AACvC,8CAA+C;AAC/C,4DAA8B;AAC9B,+CAA4C;AAE5C;IAIE,kBAAY,QAAkB,EAAE,MAAsB,EAAE,IAAmB;QAA/D,yBAAA,EAAA,eAAkB;QAAE,uBAAA,EAAA,cAAsB;QAAE,qBAAA,EAAA,WAAmB;QAHjE,cAAS,GAAW,IAAI,CAAC;QACzB,UAAK,GAAW,IAAI,CAAC;QAG7B,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;QAC5C,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,QAAQ,CAAC,QAAkB,CAAC,CAAC;QACpC,CAAC;QACD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,CAAC;IACH,CAAC;IAEO,6BAAU,GAAlB;QACE,IAAI,CAAC,KAAK,GAAG,IAAA,wBAAU,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAA,gBAAQ,GAAE,EAAE,IAAA,wBAAU,EAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;IACtH,CAAC;IAED,sBAAI,iCAAW;aAAf;YACE,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACpC,CAAC;;;OAAA;IAED,yBAAM,GAAN;QACE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACnD,CAAC;QACD,IAAM,OAAO,QAAO,iBAAO,YAAP,iBAAO,kCAAI,IAAI,CAAC,WAAW,YAAC,CAAC;QACjD,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,2BAAQ,GAAR,UAAS,IAAY;QACnB,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAM,OAAO,QAAO,iBAAO,YAAP,iBAAO,kCAAI,IAAI,CAAC,WAAW,YAAC,CAAC;QACjD,IAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,qBAAS,CAAC,uBAAgB,IAAI,CAAE,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,CAAC,SAAS,GAAM,CAAC,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAChF,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,8BAAW,GAAX;QACE,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,2BAAQ,GAAR;QACE,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,yBAAM,GAAN,UAAO,EAAe;QACpB,OAAO,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC,KAAK,CAAC;IACjC,CAAC;IACH,eAAC;AAAD,CAAC,AAvDD,IAuDC;AAvDY,4BAAQ"}
+{"version":3,"file":"EntityId.js","sourceRoot":"","sources":["../src/EntityId.ts"],"names":[],"mappings":";;;;AAAA,0EAAuC;AACvC,8CAA+C;AAC/C,4DAA8B;AAC9B,+CAA4C;AAE5C;IAIE,kBAAY,QAAyB,EAAE,MAAsB,EAAE,IAAmB;QAAtE,yBAAA,EAAA,eAAyB;QAAE,uBAAA,EAAA,cAAsB;QAAE,qBAAA,EAAA,WAAmB;QAHxE,cAAS,GAAW,IAAI,CAAC;QACzB,UAAK,GAAW,IAAI,CAAC;QAG7B,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAa,CAAC,CAAC,CAAC,IAAI,CAAC;QACjD,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,QAAQ,CAAC,QAAkB,CAAC,CAAC;QACpC,CAAC;QACD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,CAAC;IACH,CAAC;IAEO,6BAAU,GAAlB;QACE,IAAI,CAAC,KAAK,GAAG,IAAA,wBAAU,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAA,gBAAQ,GAAE,EAAE,IAAA,wBAAU,EAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;IACtH,CAAC;IAED,sBAAI,iCAAW;aAAf;YACE,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACpC,CAAC;;;OAAA;IAED,yBAAM,GAAN;QACE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACnD,CAAC;QACD,IAAM,OAAO,QAAO,iBAAO,YAAP,iBAAO,kCAAI,IAAI,CAAC,WAAW,YAAC,CAAC;QACjD,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;IACvD,CAAC;IAES,2BAAQ,GAAlB,UAAmB,IAAY;QAC7B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAM,OAAO,QAAO,iBAAO,YAAP,iBAAO,kCAAI,IAAI,CAAC,WAAW,YAAC,CAAC;QACjD,IAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,qBAAS,CAAC,uBAAgB,IAAI,CAAE,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,CAAC,SAAS,GAAM,CAAC,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAChF,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,8BAAW,GAAX;QACE,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,2BAAQ,GAAR;QACE,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,yBAAM,GAAN,UAAO,EAAe;QACpB,OAAO,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC,KAAK,CAAC;IACjC,CAAC;IACH,eAAC;AAAD,CAAC,AAvDD,IAuDC;AAvDY,4BAAQ"}

package/build/EntityId.spec.js

@@ -49,16 +49,17 @@ describe('ValueObject', function () {
         });
     }); });
     test('toHash', function () { return tslib_1.__awaiter(void 0, void 0, void 0, function () {
-        var id, id2, id3;
+        var id, idFromHash, id2, id3;
         return tslib_1.__generator(this, function (_a) {
             id = new Test2Id('123');
             expect(id.toHash()).toEqual('9KdMR');
-            expect(id.fromHash('VLoxm').toPrimitive()).toEqual('1');
-            expect(id.toPrimitive()).toEqual('1');
-            expect(id.toString()).toEqual('090bb5d1-267b-5967-84c8-95bc1bda380f');
+            idFromHash = new Test2Id('VLoxm', true);
+            expect(idFromHash.toPrimitive()).toEqual('1');
+            expect(idFromHash.toPrimitive()).toEqual('1');
+            expect(idFromHash.toString()).toEqual('090bb5d1-267b-5967-84c8-95bc1bda380f');
             id2 = new TestId(123);
             expect(id2.toHash()).toEqual('BJejP');
-            expect(id2.fromHash('BJejP').toPrimitive()).toEqual(123);
+            expect(new TestId('BJejP', true).toPrimitive()).toEqual('123');
             id3 = new Test2Id();
             expect(function () { return id3.toHash(); }).toThrow('Cannot hash an empty recordId');
             return [2 /*return*/];

package/build/EntityId.spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"EntityId.spec.js","sourceRoot":"","sources":["../src/EntityId.spec.ts"],"names":[],"mappings":";;;AAAA,uCAAsC;AACtC,+CAA4C;AAE5C;IAAqB,kCAAgB;IAArC;;IACA,CAAC;IAAD,aAAC;AAAD,CAAC,AADD,CAAqB,mBAAQ,GAC5B;AAED;IAAsB,mCAAgB;IAAtC;;IACA,CAAC;IAAD,cAAC;AAAD,CAAC,AADD,CAAsB,mBAAQ,GAC7B;AAED,QAAQ,CAAC,aAAa,EAAE;IACtB,IAAI,CAAC,MAAM,EAAE;;;YACL,EAAE,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC;YACnB,GAAG,GAAG,IAAI,mBAAQ,CAAC,GAAG,CAAC,CAAC;YACxB,GAAG,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC;YAC1B,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACxB,MAAM,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAEtB,GAAG,GAAG,IAAI,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YACvC,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;;;SACzC,CAAC,CAAC;IACH,IAAI,CAAC,UAAU,EAAE;;YACf,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAErB,MAAM,CAAC,CAAC,IAAI,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACnE,MAAM,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAE9D,IAAI,CAAC;gBACH,IAAI,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;YAC1B,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,sDAAsD;gBACtD,MAAM,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,qBAAS,CAAC,CAAC;gBACtC,sDAAsD;gBACtD,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;YAClD,CAAC;;;SACF,CAAC,CAAC;IACH,IAAI,CAAC,QAAQ,EAAE;;;YACP,EAAE,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC;YAC9B,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACrC,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACxD,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACtC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,sCAAsC,CAAC,CAAC;YAEhE,GAAG,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC;YAC5B,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACtC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAEnD,GAAG,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,MAAM,CAAC,cAAM,OAAA,GAAG,CAAC,MAAM,EAAE,EAAZ,CAAY,CAAC,CAAC,OAAO,CAAC,+BAA+B,CAAC,CAAC;;;SACrE,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"EntityId.spec.js","sourceRoot":"","sources":["../src/EntityId.spec.ts"],"names":[],"mappings":"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"}

package/build/EventBus.d.ts

@@ -1,6 +1,8 @@
 import { AnyDomainEvent } from './DomainEvent';
 import { DomainEventSubscriber } from "./DomainEventSubscriber";
 export interface EventBus {
+    push(event: AnyDomainEvent): Promise<void>;
+    clear(): Promise<void>;
     publish(events: AnyDomainEvent[]): Promise<void>;
     addSubscribers(subscribers: DomainEventSubscriber[]): void;
 }

package/build/EventBus.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/build/EventBus.spec.js

@@ -0,0 +1,157 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+var tslib_1 = require("tslib");
+var InMemoryEventBus_1 = require("./eventBus/InMemoryEventBus");
+var DomainEvent_1 = require("./DomainEvent");
+var EntityId_1 = require("./EntityId");
+var Entity_1 = require("./Entity");
+describe('EventBus', function () {
+    var NewUserCreated = /** @class */ (function (_super) {
+        tslib_1.__extends(NewUserCreated, _super);
+        function NewUserCreated() {
+            return _super !== null && _super.apply(this, arguments) || this;
+        }
+        return NewUserCreated;
+    }(DomainEvent_1.DomainEvent));
+    var NewUserCreated2 = /** @class */ (function (_super) {
+        tslib_1.__extends(NewUserCreated2, _super);
+        function NewUserCreated2() {
+            return _super !== null && _super.apply(this, arguments) || this;
+        }
+        NewUserCreated2.EVENT_NAME = 'Event2';
+        return NewUserCreated2;
+    }(DomainEvent_1.DomainEvent));
+    var NewUserSubscriber = /** @class */ (function () {
+        function NewUserSubscriber() {
+        }
+        NewUserSubscriber.prototype.subscribedTo = function () {
+            return [NewUserCreated, NewUserCreated2];
+        };
+        NewUserSubscriber.prototype.on = function (domainEvent) {
+            return tslib_1.__awaiter(this, void 0, void 0, function () {
+                return tslib_1.__generator(this, function (_a) {
+                    console.log('Event received:', domainEvent);
+                    return [2 /*return*/];
+                });
+            });
+        };
+        return NewUserSubscriber;
+    }());
+    test('lifecycle', function () { return tslib_1.__awaiter(void 0, void 0, void 0, function () {
+        var newUserSubscriber, hub, event, event2;
+        return tslib_1.__generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    newUserSubscriber = new NewUserSubscriber();
+                    newUserSubscriber.on = jest.fn();
+                    hub = new InMemoryEventBus_1.InMemoryEventBus();
+                    hub.addSubscribers([newUserSubscriber]);
+                    event = new NewUserCreated({ username: 'test' });
+                    event2 = new NewUserCreated2({ username: 'test2' });
+                    expect(event.eventName).toEqual('NewUserCreated');
+                    expect(event2.eventName).toEqual('Event2');
+                    return [4 /*yield*/, hub.publish([event, event2])];
+                case 1:
+                    _a.sent();
+                    expect(newUserSubscriber.on).toHaveBeenCalledTimes(2);
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+    test('user example', function () { return tslib_1.__awaiter(void 0, void 0, void 0, function () {
+        var UserId, User, UserCreatedEvent, ChangeLoggerSubscriber, eventBus, subscriber, mockOn, user, event, diff;
+        return tslib_1.__generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    UserId = /** @class */ (function (_super) {
+                        tslib_1.__extends(UserId, _super);
+                        function UserId() {
+                            return _super !== null && _super.apply(this, arguments) || this;
+                        }
+                        return UserId;
+                    }(EntityId_1.EntityId));
+                    User = /** @class */ (function (_super) {
+                        tslib_1.__extends(User, _super);
+                        function User() {
+                            return _super !== null && _super.apply(this, arguments) || this;
+                        }
+                        User.create = function (props) {
+                            return new User(props, props.id);
+                        };
+                        Object.defineProperty(User.prototype, "username", {
+                            get: function () {
+                                return this.props.username;
+                            },
+                            set: function (username) {
+                                this.props.username = username;
+                            },
+                            enumerable: false,
+                            configurable: true
+                        });
+                        return User;
+                    }(Entity_1.Entity));
+                    UserCreatedEvent = /** @class */ (function (_super) {
+                        tslib_1.__extends(UserCreatedEvent, _super);
+                        function UserCreatedEvent() {
+                            var _this = _super !== null && _super.apply(this, arguments) || this;
+                            _this.eventName = 'UserCreatedEvent'; // без цього не буде працювати статична типізація
+                            return _this;
+                        }
+                        Object.defineProperty(UserCreatedEvent.prototype, "username", {
+                            get: function () {
+                                return this.props.username;
+                            },
+                            enumerable: false,
+                            configurable: true
+                        });
+                        return UserCreatedEvent;
+                    }(DomainEvent_1.DomainEvent));
+                    ChangeLoggerSubscriber = /** @class */ (function () {
+                        function ChangeLoggerSubscriber() {
+                        }
+                        // Підписуємося на події, які нас цікавлять
+                        ChangeLoggerSubscriber.prototype.subscribedTo = function () {
+                            return [UserCreatedEvent];
+                        };
+                        // Реалізуємо логіку обробки подій
+                        ChangeLoggerSubscriber.prototype.on = function (domainEvent) {
+                            return tslib_1.__awaiter(this, void 0, void 0, function () {
+                                return tslib_1.__generator(this, function (_a) {
+                                    console.log('Username changed:', domainEvent.username);
+                                    return [2 /*return*/];
+                                });
+                            });
+                        };
+                        return ChangeLoggerSubscriber;
+                    }());
+                    eventBus = new InMemoryEventBus_1.InMemoryEventBus();
+                    subscriber = new ChangeLoggerSubscriber();
+                    mockOn = jest.spyOn(subscriber, 'on');
+                    eventBus.addSubscribers([subscriber]);
+                    user = User.create({ id: new UserId('1'), username: 'john_doe' });
+                    // Створюємо знімок початкового стану
+                    user.snapshot();
+                    // Змінюємо ім'я користувача
+                    user.username = 'john_doe_updated';
+                    // Перевіряємо, чи є зміни
+                    if (user.isDirty()) {
+                        diff = user.snapshotDiff();
+                        if (diff) {
+                            event = new UserCreatedEvent(diff);
+                            // записуємо подію в чергу (не publish). Бо якщо в циклі може бути багато подій і їх треба назбирати, а потім виконати, тому збираємо через push
+                            eventBus.push(event);
+                        }
+                    }
+                    expect(mockOn).not.toHaveBeenCalled();
+                    // Публікуємо всі події в черзі
+                    return [4 /*yield*/, eventBus.publish()];
+                case 1:
+                    // Публікуємо всі події в черзі
+                    _a.sent();
+                    expect(mockOn).toHaveBeenCalledWith(event);
+                    return [2 /*return*/];
+            }
+        });
+    }); });
+});
+//# sourceMappingURL=EventBus.spec.js.map

package/build/EventBus.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventBus.spec.js","sourceRoot":"","sources":["../src/EventBus.spec.ts"],"names":[],"mappings":";;;AAAA,gEAA6D;AAE7D,6CAA4D;AAC5D,uCAAoC;AACpC,mCAAgC;AAEhC,QAAQ,CAAC,UAAU,EAAE;IACnB;QAA6B,0CAAiC;QAA9D;;QACA,CAAC;QAAD,qBAAC;IAAD,CAAC,AADD,CAA6B,yBAAW,GACvC;IACD;QAA8B,2CAAiC;QAA/D;;QAEA,CAAC;QADQ,0BAAU,GAAG,QAAQ,CAAC;QAC/B,sBAAC;KAAA,AAFD,CAA8B,yBAAW,GAExC;IAED;QAAA;QAOA,CAAC;QANC,wCAAY,GAAZ;YACE,OAAO,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;QAC3C,CAAC;QACK,8BAAE,GAAR,UAAS,WAA2C;;;oBAClD,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,WAAW,CAAC,CAAC;;;;SAC7C;QACH,wBAAC;IAAD,CAAC,AAPD,IAOC;IAED,IAAI,CAAC,WAAW,EAAE;;;;;oBACV,iBAAiB,GAAG,IAAI,iBAAiB,EAAE,CAAC;oBAClD,iBAAiB,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;oBAC3B,GAAG,GAAG,IAAI,mCAAgB,EAAE,CAAC;oBACnC,GAAG,CAAC,cAAc,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC;oBAElC,KAAK,GAAG,IAAI,cAAc,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;oBACjD,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;oBAE1D,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;oBAClD,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;oBAE3C,qBAAM,GAAG,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,EAAA;;oBAAlC,SAAkC,CAAC;oBAEnC,MAAM,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;;;;SACvD,CAAC,CAAC;IAEH,IAAI,CAAC,cAAc,EAAE;;;;;oBACnB;wBAAqB,kCAAgB;wBAArC;;wBAAuC,CAAC;wBAAD,aAAC;oBAAD,CAAC,AAAxC,CAAqB,mBAAQ,GAAW;oBAOxC;wBAAmB,gCAA6B;wBAAhD;;wBAYA,CAAC;wBAXQ,WAAM,GAAb,UAAc,KAAY;4BACxB,OAAO,IAAI,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;wBACnC,CAAC;wBAED,sBAAI,0BAAQ;iCAIZ;gCACE,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;4BAC7B,CAAC;iCAND,UAAa,QAAgB;gCAC3B,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC;4BACjC,CAAC;;;2BAAA;wBAKH,WAAC;oBAAD,CAAC,AAZD,CAAmB,eAAM,GAYxB;oBAED;wBAA+B,4CAA2B;wBAA1D;;4BACW,eAAS,GAAG,kBAAkB,CAAC,CAAC,iDAAiD;;wBAK5F,CAAC;wBAHC,sBAAI,sCAAQ;iCAAZ;gCACE,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;4BAC7B,CAAC;;;2BAAA;wBACH,uBAAC;oBAAD,CAAC,AAND,CAA+B,yBAAW,GAMzC;oBAED;wBAAA;wBAUA,CAAC;wBATC,2CAA2C;wBAC3C,6CAAY,GAAZ;4BACE,OAAO,CAAC,gBAAgB,CAAC,CAAC;wBAC5B,CAAC;wBAED,kCAAkC;wBAC5B,mCAAE,GAAR,UAAS,WAA6B;;;oCACpC,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;;;;yBACxD;wBACH,6BAAC;oBAAD,CAAC,AAVD,IAUC;oBAGK,QAAQ,GAAG,IAAI,mCAAgB,EAAE,CAAC;oBAClC,UAAU,GAAG,IAAI,sBAAsB,EAAE,CAAC;oBAC1C,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;oBAC5C,QAAQ,CAAC,cAAc,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;oBAEhC,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC;oBACxE,qCAAqC;oBACrC,IAAI,CAAC,QAAQ,EAAE,CAAC;oBAChB,4BAA4B;oBAC5B,IAAI,CAAC,QAAQ,GAAG,kBAAkB,CAAC;oBAEnC,0BAA0B;oBAC1B,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;wBACb,IAAI,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;wBACjC,IAAI,IAAI,EAAE,CAAC;4BACT,KAAK,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;4BACnC,gJAAgJ;4BAChJ,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;wBACvB,CAAC;oBACH,CAAC;oBACD,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;oBACtC,+BAA+B;oBAC/B,qBAAM,QAAQ,CAAC,OAAO,EAAE,EAAA;;oBADxB,+BAA+B;oBAC/B,SAAwB,CAAC;oBACzB,MAAM,CAAC,MAAM,CAAC,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;;;;SAC5C,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/build/eventBus/InMemoryEventBus.d.ts

@@ -3,7 +3,14 @@ import { EventEmitter } from 'events';
 import { AnyDomainEvent } from '../DomainEvent';
 import { EventBus } from '../EventBus';
 import { DomainEventSubscriber } from "../DomainEventSubscriber";
-export declare class InMemoryEventBus extends EventEmitter implements EventBus {
-    publish(events: AnyDomainEvent[]): Promise<void>;
+export declare class InMemoryEventBus implements EventBus {
+    protected _events: AnyDomainEvent[];
+    protected _emitter: EventEmitter;
+    constructor();
+    push(event: AnyDomainEvent): Promise<void>;
+    clear(): Promise<void>;
+    publish(events?: AnyDomainEvent[]): Promise<void>;
+    on(event: string, listener: (...args: never[]) => void): void;
+    listenerCount(event: string): number;
     addSubscribers(subscribers: DomainEventSubscriber[]): void;
 }