@pocket-architect/core 0.1.19 → 0.1.23

package/build/helpers.spec.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+var tslib_1 = require("tslib");
+var helpers_1 = require("./helpers");
+var EntityId_1 = require("./EntityId");
+var Entity_1 = require("./Entity");
+var TestEntity = /** @class */ (function (_super) {
+    tslib_1.__extends(TestEntity, _super);
+    function TestEntity() {
+        return _super !== null && _super.apply(this, arguments) || this;
+    }
+    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
+    });
+    TestEntity.prototype.toSnapshot = function () {
+        return tslib_1.__assign(tslib_1.__assign({}, this.props), { testId: undefined });
+    };
+    return TestEntity;
+}(Entity_1.Entity));
+describe('helpers', function () {
+    test('createSnapshot', function () { return tslib_1.__awaiter(void 0, void 0, void 0, function () {
+        var original, snapshot, item, itemSnapshot;
+        return tslib_1.__generator(this, function (_a) {
+            original = {
+                a: 1,
+                b: 'test',
+                c: {
+                    d: 2,
+                    e: 'nested',
+                    f: {
+                        g: 3
+                    }
+                },
+                id: new EntityId_1.EntityId('1'),
+            };
+            snapshot = (0, helpers_1.createSnapshot)(original);
+            expect(snapshot).toEqual(tslib_1.__assign(tslib_1.__assign({}, original), { id: '3D4WX' }));
+            expect(snapshot).not.toBe(original);
+            expect(snapshot.c).not.toBe(original.c);
+            expect(snapshot.c.f).not.toBe(original.c.f);
+            expect(snapshot.id).not.toBe(original.id);
+            expect(snapshot.id).toEqual('3D4WX');
+            item = TestEntity.create({
+                name: 'test',
+                testId: new EntityId_1.EntityId('2')
+            }, '2');
+            itemSnapshot = (0, helpers_1.createSnapshot)(item);
+            expect(itemSnapshot).toEqual({
+                name: 'test',
+                testId: undefined
+            });
+            return [2 /*return*/];
+        });
+    }); });
+});
+//# sourceMappingURL=helpers.spec.js.map

package/build/helpers.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.spec.js","sourceRoot":"","sources":["../src/helpers.spec.ts"],"names":[],"mappings":";;;AAAA,qCAAyC;AACzC,uCAAoC;AACpC,mCAAgC;AAMhC;IAAyB,sCAA2C;IAApE;;IAmBA,CAAC;IAlBQ,iBAAM,GAAb,UAAc,KAAgB,EAAE,EAA2B;QACzD,OAAO,IAAI,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,sBAAI,4BAAI;aAAR,UAAS,IAAY;YACnB,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;QACzB,CAAC;;;OAAA;IAED,sBAAI,8BAAM;aAAV,UAAW,GAAqB;YAC9B,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC;QAC1B,CAAC;;;OAAA;IAED,+BAAU,GAAV;QACE,OAAO,sCACF,IAAI,CAAC,KAAK,KACb,MAAM,EAAE,SAAS,GACT,CAAC;IACb,CAAC;IACH,iBAAC;AAAD,CAAC,AAnBD,CAAyB,eAAM,GAmB9B;AAED,QAAQ,CAAC,SAAS,EAAE;IAClB,IAAI,CAAC,gBAAgB,EAAE;;;YACf,QAAQ,GAAG;gBACf,CAAC,EAAE,CAAC;gBACJ,CAAC,EAAE,MAAM;gBACT,CAAC,EAAE;oBACD,CAAC,EAAE,CAAC;oBACJ,CAAC,EAAE,QAAQ;oBACX,CAAC,EAAE;wBACD,CAAC,EAAE,CAAC;qBACL;iBACF;gBACD,EAAE,EAAE,IAAI,mBAAQ,CAAS,GAAG,CAAC;aAC9B,CAAC;YACI,QAAQ,GAAG,IAAA,wBAAc,EAAC,QAAQ,CAAC,CAAC;YAC1C,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,uCACnB,QAAQ,KACX,EAAE,EAAE,OAAO,IACX,CAAC;YACH,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACpC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YACxC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5C,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC1C,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAE/B,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC;gBAC7B,IAAI,EAAE,MAAM;gBACZ,MAAM,EAAE,IAAI,mBAAQ,CAAC,GAAG,CAAC;aAC1B,EAAE,GAAG,CAAC,CAAC;YACF,YAAY,GAAG,IAAA,wBAAc,EAAC,IAAI,CAAC,CAAC;YAC1C,MAAM,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC;gBAC3B,IAAI,EAAE,MAAM;gBACZ,MAAM,EAAE,SAAS;aAClB,CAAC,CAAC;;;SACJ,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/build/index.d.ts

@@ -3,4 +3,11 @@ import { EntityId } from './EntityId';
 import { ValueObject } from './ValueObject';
 import { AggregateRoot } from './AggregateRoot';
 import { HashError } from './error/HashError';
-export { Entity, EntityId, ValueObject, AggregateRoot, HashError };
+import { DomainEvent } from './DomainEvent';
+import { DomainEventSubscriber } from './DomainEventSubscriber';
+import { EventBus } from './EventBus';
+import { Eventable } from './mixins/Eventable';
+import { Application } from './application/Application';
+import { ApplicationModule } from './application/ApplicationModule';
+import { bootstrap } from './bootstrap';
+export { Entity, EntityId, ValueObject, AggregateRoot, HashError, DomainEvent, DomainEventSubscriber, EventBus, Eventable, Application, ApplicationModule, bootstrap };

package/build/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HashError = exports.AggregateRoot = exports.ValueObject = exports.EntityId = exports.Entity = void 0;
+exports.bootstrap = exports.ApplicationModule = exports.Application = exports.Eventable = exports.DomainEvent = exports.HashError = exports.AggregateRoot = exports.ValueObject = exports.EntityId = exports.Entity = void 0;
 var Entity_1 = require("./Entity");
 Object.defineProperty(exports, "Entity", { enumerable: true, get: function () { return Entity_1.Entity; } });
 var EntityId_1 = require("./EntityId");
@@ -11,4 +11,14 @@ var AggregateRoot_1 = require("./AggregateRoot");
 Object.defineProperty(exports, "AggregateRoot", { enumerable: true, get: function () { return AggregateRoot_1.AggregateRoot; } });
 var HashError_1 = require("./error/HashError");
 Object.defineProperty(exports, "HashError", { enumerable: true, get: function () { return HashError_1.HashError; } });
+var DomainEvent_1 = require("./DomainEvent");
+Object.defineProperty(exports, "DomainEvent", { enumerable: true, get: function () { return DomainEvent_1.DomainEvent; } });
+var Eventable_1 = require("./mixins/Eventable");
+Object.defineProperty(exports, "Eventable", { enumerable: true, get: function () { return Eventable_1.Eventable; } });
+var Application_1 = require("./application/Application");
+Object.defineProperty(exports, "Application", { enumerable: true, get: function () { return Application_1.Application; } });
+var ApplicationModule_1 = require("./application/ApplicationModule");
+Object.defineProperty(exports, "ApplicationModule", { enumerable: true, get: function () { return ApplicationModule_1.ApplicationModule; } });
+var bootstrap_1 = require("./bootstrap");
+Object.defineProperty(exports, "bootstrap", { enumerable: true, get: function () { return bootstrap_1.bootstrap; } });
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAAkC;AAOhC,uFAPO,eAAM,OAOP;AANR,uCAAsC;AAOpC,yFAPO,mBAAQ,OAOP;AANV,6CAA4C;AAO1C,4FAPO,yBAAW,OAOP;AANb,iDAAgD;AAO9C,8FAPO,6BAAa,OAOP;AANf,+CAA8C;AAO5C,0FAPO,qBAAS,OAOP"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAAkC;AAchC,uFAdO,eAAM,OAcP;AAbR,uCAAsC;AAcpC,yFAdO,mBAAQ,OAcP;AAbV,6CAA4C;AAc1C,4FAdO,yBAAW,OAcP;AAbb,iDAAgD;AAc9C,8FAdO,6BAAa,OAcP;AAbf,+CAA8C;AAc5C,0FAdO,qBAAS,OAcP;AAbX,6CAA4C;AAc1C,4FAdO,yBAAW,OAcP;AAXb,gDAA+C;AAc7C,0FAdO,qBAAS,OAcP;AAbX,yDAAwD;AAetD,4FAfO,yBAAW,OAeP;AAdb,qEAAoE;AAelE,kGAfO,qCAAiB,OAeP;AAdnB,yCAAwC;AAgBtC,0FAhBO,qBAAS,OAgBP"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pocket-architect/core",
-  "version": "0.1.19",
+  "version": "0.1.23",
   "description": "",
   "main": "build/index.js",
   "scripts": {
@@ -17,6 +17,7 @@
   },
   "dependencies": {
     "@paralleldrive/cuid2": "^2.2.2",
+    "awilix": "^10.0.2",
     "hashids": "^2.3.0",
     "shallow-equal-object": "^1.1.1",
     "uuid-by-string": "^4.0.0"

package/src/Entity.spec.ts

@@ -3,6 +3,7 @@ import { EntityId } from './EntityId';
 
 interface TestProps {
   name: string;
+  testId?: EntityId<string>;
 }
 class TestEntity extends Entity<TestProps, string, EntityId<string>> {
   static create(props: TestProps, id?:EntityId<string>|string): TestEntity {
@@ -12,13 +13,17 @@ class TestEntity extends Entity<TestProps, string, EntityId<string>> {
   set name(name: string) {
     this.props.name = name;
   }
+
+  set testId(val: EntityId<string>) {
+    this.props.testId = val;
+  }
 }
 
 describe('Entity', () => {
   let entity: TestEntity;
 
   beforeAll(() => {
-    entity = TestEntity.create({ name: 'test' }, '1');
+    entity = TestEntity.create({ name: 'test', testId: new EntityId('1') }, '1');
   });
 
   test('base', async () => {
@@ -41,7 +46,7 @@ describe('Entity', () => {
 
   test('snapshot', async () => {
     const snapshot = entity.snapshot();
-    expect(snapshot).toEqual({ name: 'test' });
+    expect(snapshot).toEqual({ name: 'test', testId: '3D4WX' });
 
     expect(() => {
       snapshot.name = 'changed';

package/src/Entity.ts

@@ -1,4 +1,5 @@
 import { EntityId } from './EntityId';
+import {createSnapshot} from "./helpers";
 
 const isEntity = <T, E, M extends EntityId<E>>(v: Entity<T, E, M>): v is Entity<T, E, M> => {
   return v instanceof Entity
@@ -22,8 +23,9 @@ export abstract class Entity<T, E, H extends EntityId<E>> {
     }
     const diffs: Partial<T> = {};
     const copy = JSON.parse(this._snapshot);
+    const snapshotObj = createSnapshot(this.props);
     for (const key in this.props) {
-      if (JSON.stringify(this.props[key]) !== JSON.stringify(copy[key])) {
+      if (JSON.stringify(snapshotObj[key]) !== JSON.stringify(copy[key])) {
         diffs[key] = this.props[key];
       }
     }
@@ -34,7 +36,7 @@ export abstract class Entity<T, E, H extends EntityId<E>> {
     if (!this._snapshot) {
       return false;
     }
-    return this._snapshot !== JSON.stringify(this.props);
+    return this._snapshot !== JSON.stringify(createSnapshot(this.props));
   }
 
   protected constructor(props: T, id?: H|E) {
@@ -70,7 +72,13 @@ export abstract class Entity<T, E, H extends EntityId<E>> {
     return this.props
   }
 
-  toJSON(): T {
-    return this.toPrimitive()
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  toJSON(): any {
+    return this.toPrimitive();
+  }
+
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  toSnapshot(): any {
+    return this.toPrimitive();
   }
 }

package/src/EntityId.ts

@@ -55,6 +55,10 @@ export class EntityId<T> {
     return this._uuid;
   }
 
+  toJSON(): string {
+    return this.toHash();
+  }
+
   equals(id: EntityId<T>): boolean {
     return this._uuid === id._uuid;
   }

package/src/application/Application.ts

@@ -0,0 +1,24 @@
+import {BaseBootstrapEnv} from "../bootstrap";
+import type {ApplicationModule} from "./ApplicationModule";
+
+export
+abstract class Application {
+  protected _modules: ApplicationModule[] = [];
+
+  abstract initApplication(scope: BaseBootstrapEnv):Promise<void>;
+
+  prepareApplication?(scope: BaseBootstrapEnv): Promise<void>;
+
+  postInitApplication?(scope: BaseBootstrapEnv): Promise<void>;
+
+  async initModules(modules: ApplicationModule[], scope: BaseBootstrapEnv): Promise<void> {
+    for (const module of modules) {
+      await module.initModule(this, scope);
+      this._modules.push(module);
+    }
+  }
+
+  get modules(): ApplicationModule[] {
+    return this._modules;
+  }
+}

package/src/application/ApplicationModule.ts

@@ -0,0 +1,7 @@
+import {BaseBootstrapEnv} from "../bootstrap";
+import {Application} from "./Application";
+
+export
+abstract class ApplicationModule {
+  abstract initModule(app: Application, scope: BaseBootstrapEnv):Promise<void>;
+}

package/src/bootstrap.spec.ts

@@ -0,0 +1,100 @@
+import {bootstrap, BaseBootstrapEnv} from "./bootstrap";
+import {Application} from "./application/Application";
+import {asValue} from "awilix";
+import {ApplicationModule} from "./application/ApplicationModule";
+import {InMemoryEventBus} from "./eventBus/InMemoryEventBus";
+import {DomainEventSubscriber} from "./DomainEventSubscriber";
+import {DomainEventClass, DomainEvent} from "./DomainEvent";
+
+class TestApplication extends Application {
+  result: number[] = [];
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  scope: any;
+
+  eventBus: InMemoryEventBus;
+
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  async initApplication({DIContainer: scope}: BaseBootstrapEnv) {
+    this.eventBus = new InMemoryEventBus();
+
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let provider: any = scope.resolve('TestProvider');
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let service: any = scope.resolve('TestService');
+    provider.inc();
+    service.inc();
+
+    let newScope = scope.createScope();
+    provider = newScope.resolve('TestProvider')
+    service = newScope.resolve('TestService');
+    provider.inc();
+    service.inc();
+
+    newScope = scope.createScope();
+    provider = newScope.resolve('TestProvider')
+    service = newScope.resolve('TestService');
+    provider.inc();
+    service.inc();
+
+    this.result = [provider.value, service.value];
+
+    scope.register({
+      // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+      // @ts-ignore
+      context: asValue({userId: '1'}),
+      TestModule: asValue(new TestModule())
+    });
+    this.scope = scope;
+
+    await this.initModules([
+      scope.resolve('TestModule')
+    ], scope.cradle);
+  }
+}
+
+class TestModule extends ApplicationModule implements DomainEventSubscriber {
+  events:string[] = [];
+
+  subscribedTo(): DomainEventClass[] {
+    return [TestDomainEvent];
+  }
+
+  async on(domainEvent: TestDomainEvent): Promise<void> {
+    this.events.push(domainEvent.test);
+  }
+
+  async initModule(app: TestApplication) {
+    app.eventBus.addSubscribers(this);
+  }
+}
+
+class TestDomainEvent extends DomainEvent<{ test: string }> {
+  get test() {
+    return this.props.test;
+  }
+}
+
+describe('bootstrap', () => {
+  test('bootstrap', async () => {
+    const app = new TestApplication();
+    await bootstrap(app, {
+      appFolder: `${__dirname}/../tests/testapp/app`,
+      domainsFolder: `${__dirname}/../tests/testapp/domain`,
+      infraFolder: `${__dirname}/../tests/testapp/infra`,
+    });
+
+    // провайдер в інфрі синглтон, сервіс - ні
+    expect(app.result).toEqual([3, 1]);
+
+    await app.eventBus.push(new TestDomainEvent({test: 'data'}));
+    expect(app.eventBus.listenerCount('TestDomainEvent')).toBe(1);
+    await app.eventBus.publish();
+
+    expect((app.modules[0] as TestModule).events).toEqual(['data']);
+  });
+
+  test('bootstrap error', async () => {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    await expect(() => bootstrap(new TestApplication(), <any>{})).rejects.toThrow('`appFolder` is required');
+  });
+});

package/src/bootstrap.ts

@@ -0,0 +1,87 @@
+import {createContainer, InjectionMode, asValue, Lifetime, AwilixContainer} from 'awilix';
+import {Application} from "./application/Application";
+
+export interface BootstrapOptions {
+  appFolder: string;
+  domainsFolder: string;
+  infraFolder: string;
+  scanFolders?: string[]
+}
+
+export interface BaseBootstrapEnv {
+  app: Application;
+  env: string;
+  DIContainer: AwilixContainer<BaseBootstrapEnv>;
+}
+
+export
+async function bootstrap(app: Application, { appFolder, domainsFolder, infraFolder, scanFolders }: BootstrapOptions, env: string = 'dev'):Promise<void> {
+  try {
+    if (!appFolder) {
+      throw new Error('`appFolder` is required')
+    }
+    if (!domainsFolder) {
+      throw new Error('`domainsFolder` is required')
+    }
+    if (!infraFolder) {
+      throw new Error('`infraFolder` is required')
+    }
+
+    const rootContainer = createContainer({
+      injectionMode: InjectionMode.PROXY
+    });
+    rootContainer.register({
+      app: asValue(app),
+      env: asValue(env),
+    });
+    const scope = rootContainer.createScope();
+    scope.register({
+      DIContainer: asValue(scope)
+    });
+    const folders = [];
+
+    // app folder
+    // folders.push(`${appFolder}/**/!(*.spec|*.d|index).{ts,js}`);
+
+    // domains folder
+    folders.push(`${domainsFolder}/**/!(*.spec|*.d).{ts,js}`);
+    folders.push(`${domainsFolder}/**/service/**/!(*.spec|*.d).{ts,js}`);
+
+    // infra folder
+    folders.push(`${infraFolder}/**/repository/**/!(*.spec|*.d).{ts,js}`);
+
+    // провайдери реєструються у глобальному контейнері як синглтони і потім через warmupSingletons створюються одразу
+    // щоб перевірити чи не використовують вони залежності з transient lifetime
+    rootContainer.loadModules([
+      [`${infraFolder}/**/providers/**/!(*.spec|*.d).{ts,js}`, { lifetime: Lifetime.SINGLETON }]
+    ], { resolverOptions: {} });
+    scope.loadModules([...folders, ...(scanFolders ?? [])], { resolverOptions: {} });
+
+    warmupSingletons(scope);
+    if (app.prepareApplication) {
+      await app.prepareApplication(scope.cradle);
+    }
+    await app.initApplication(scope.cradle);
+
+    if (app.postInitApplication) {
+      await app.postInitApplication(scope.cradle);
+    }
+  } catch (err) {
+    console.info(err);
+    throw err;
+  }
+
+  function warmupSingletons(container: AwilixContainer) {
+    const regs = container.registrations ?? {};
+    const names = Object.keys(regs);
+
+    for (const name of names) {
+      const r = regs[name];
+      // Awilix зберігає lifetime всередині resolver'а (зазвичай r.lifetime)
+      if (r?.lifetime === Lifetime.SINGLETON) {
+        // важливо: резолвимо саме з ROOT
+        container.resolve(name);
+      }
+    }
+  }
+}

package/src/eventBus/InMemoryEventBus.ts

@@ -3,8 +3,13 @@ import { AnyDomainEvent } from '../DomainEvent';
 import { EventBus } from '../EventBus';
 import {DomainEventSubscriber} from "../DomainEventSubscriber";
 
-export class InMemoryEventBus extends EventEmitter implements EventBus {
+export class InMemoryEventBus implements EventBus {
   protected _events: AnyDomainEvent[] = [];
+  protected _emitter: EventEmitter;
+
+  constructor() {
+    this._emitter = new EventEmitter();
+  }
 
   async push(event: AnyDomainEvent): Promise<void> {
     this._events.push(event);
@@ -17,16 +22,25 @@ export class InMemoryEventBus extends EventEmitter implements EventBus {
   async publish(events: AnyDomainEvent[] = []): Promise<void> {
     const allEvents = (this._events || []).concat(events ?? []);
     for (const event of allEvents) {
-      this.emit(event.eventName, event);
+      this._emitter.emit(event.eventName, event);
     }
     await this.clear();
   }
 
-  addSubscribers(subscribers: DomainEventSubscriber[]): void {
-    for (const subscriber of subscribers) {
+  on(event: string, listener: (...args: never[]) => void): void {
+    this._emitter.on(event, listener);
+  }
+
+  listenerCount(event: string): number {
+    return this._emitter.listenerCount(event);
+  }
+
+  addSubscribers(subscribers: DomainEventSubscriber[] | DomainEventSubscriber): void {
+    const subsArray = Array.isArray(subscribers) ? subscribers : [subscribers];
+    for (const subscriber of subsArray) {
       const events = subscriber.subscribedTo();
       for (const event of events) {
-        this.on(event.EVENT_NAME ?? event.name, subscriber.on.bind(subscriber));
+        this._emitter.on(event.EVENT_NAME ?? event.name, subscriber.on.bind(subscriber));
       }
     }
   }

package/src/helpers.spec.ts

@@ -0,0 +1,65 @@
+import {createSnapshot} from "./helpers";
+import {EntityId} from "./EntityId";
+import {Entity} from "./Entity";
+
+interface TestProps {
+  name: string;
+  testId?: EntityId<string>;
+}
+class TestEntity extends Entity<TestProps, string, EntityId<string>> {
+  static create(props: TestProps, id?:EntityId<string>|string): TestEntity {
+    return new TestEntity(props, id);
+  }
+
+  set name(name: string) {
+    this.props.name = name;
+  }
+
+  set testId(val: EntityId<string>) {
+    this.props.testId = val;
+  }
+
+  toSnapshot():never {
+    return {
+      ...this.props,
+      testId: undefined
+    } as never;
+  }
+}
+
+describe('helpers', () => {
+  test('createSnapshot', async () => {
+    const original = {
+      a: 1,
+      b: 'test',
+      c: {
+        d: 2,
+        e: 'nested',
+        f: {
+          g: 3
+        }
+      },
+      id: new EntityId<string>('1'),
+    };
+    const snapshot = createSnapshot(original);
+    expect(snapshot).toEqual({
+      ...original,
+      id: '3D4WX'
+    });
+    expect(snapshot).not.toBe(original);
+    expect(snapshot.c).not.toBe(original.c);
+    expect(snapshot.c.f).not.toBe(original.c.f);
+    expect(snapshot.id).not.toBe(original.id);
+    expect(snapshot.id).toEqual('3D4WX');
+
+    const item = TestEntity.create({
+      name: 'test',
+      testId: new EntityId('2')
+    }, '2');
+    const itemSnapshot = createSnapshot(item);
+    expect(itemSnapshot).toEqual({
+      name: 'test',
+      testId: undefined
+    });
+  });
+});

package/src/helpers.ts

@@ -0,0 +1,32 @@
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function createSnapshot<T>(obj: T): T {
+  if (!obj) {
+    return obj;
+  }
+  // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+  // @ts-ignore
+  if (typeof obj.toSnapshot === 'function') {
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore
+    return obj.toSnapshot() as T;
+  }
+  // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+  // @ts-ignore
+  if (typeof obj.toJSON === 'function') {
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore
+    return obj.toJSON() as T;
+  }
+  const copy:T = {} as T;
+  for (const key in obj) {
+    if (!Object.prototype.hasOwnProperty.call(obj, key)) {
+      continue;
+    }
+    if (typeof obj[key] !== 'object') {
+      copy[key] = obj[key];
+      continue;
+    }
+    copy[key] = createSnapshot(obj[key]);
+  }
+  return copy;
+}

package/src/index.ts

@@ -3,11 +3,27 @@ import { EntityId } from './EntityId';
 import { ValueObject } from './ValueObject';
 import { AggregateRoot } from './AggregateRoot';
 import { HashError } from './error/HashError';
+import { DomainEvent } from './DomainEvent';
+import { DomainEventSubscriber } from './DomainEventSubscriber';
+import { EventBus } from './EventBus';
+import { Eventable } from './mixins/Eventable';
+import { Application } from './application/Application';
+import { ApplicationModule } from './application/ApplicationModule';
+import { bootstrap } from './bootstrap';
 
 export {
   Entity,
   EntityId,
   ValueObject,
   AggregateRoot,
-  HashError
+  HashError,
+  DomainEvent,
+  DomainEventSubscriber,
+  EventBus,
+  Eventable,
+
+  Application,
+  ApplicationModule,
+
+  bootstrap
 }

package/tests/testapp/domain/test/service/TestService.d.ts

@@ -0,0 +1,4 @@
+export default class TestService {
+    value: number;
+    inc(): void;
+}

package/tests/testapp/domain/test/service/TestService.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+var TestService = /** @class */ (function () {
+    function TestService() {
+        this.value = 0;
+    }
+    TestService.prototype.inc = function () {
+        this.value += 1;
+    };
+    return TestService;
+}());
+exports.default = TestService;
+//# sourceMappingURL=TestService.js.map

package/tests/testapp/domain/test/service/TestService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestService.js","sourceRoot":"","sources":["TestService.ts"],"names":[],"mappings":";;AAAA;IAAA;QAES,UAAK,GAAG,CAAC,CAAC;IAKnB,CAAC;IAHC,yBAAG,GAAH;QACE,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;IAClB,CAAC;IACH,kBAAC;AAAD,CAAC,AAPD,IAOC"}

package/tests/testapp/domain/test/service/TestService.ts

@@ -0,0 +1,8 @@
+export default
+class TestService {
+  public value = 0;
+
+  inc() {
+    this.value += 1;
+  }
+}

package/tests/testapp/infra/test/providers/TestProvider.d.ts

@@ -0,0 +1,4 @@
+export default class TestProvider {
+    value: number;
+    inc(): void;
+}