ddd-node 24.6.1 → 25.0.0

package/dist/core/aggregate/aggregate-base/aggregate.builder.d.ts

@@ -1,6 +1,6 @@
-import { EntityBuilderBase } from "../../entity";
+import { IdentifiableModelBuilder } from "../../identifiable-model";
 import { AnyAggregate } from "./aggregate";
-export declare abstract class AggregateBuilderBase<T extends AnyAggregate> extends EntityBuilderBase<T> {
+export declare abstract class AggregateBuilderBase<T extends AnyAggregate> extends IdentifiableModelBuilder<T> {
     protected version: number;
     withVersion(version: number): this;
 }

package/dist/core/aggregate/aggregate-base/aggregate.builder.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AggregateBuilderBase = void 0;
-const entity_1 = require("../../entity");
-class AggregateBuilderBase extends entity_1.EntityBuilderBase {
+const identifiable_model_1 = require("../../identifiable-model");
+class AggregateBuilderBase extends identifiable_model_1.IdentifiableModelBuilder {
     constructor() {
         super(...arguments);
         this.version = 0;

package/dist/core/aggregate/aggregate-base/aggregate.d.ts

@@ -1,11 +1,11 @@
 import { Props, PropsOf } from "../../../base";
-import { EntityBase, EntityMetadata } from "../../entity";
+import { IdentifiableModel, IdentifiableModelMetadata } from "../../identifiable-model";
 import { AnyEvent, EventClassWithTypedConstructor, EventSource } from "../../message";
 import { IAggregateEventDispatcher } from "./aggregate-event-dispatcher.interface";
-export interface AggregateMetadata extends EntityMetadata {
+export interface AggregateMetadata extends IdentifiableModelMetadata {
     version: number;
 }
-export declare abstract class AggregateBase<P extends Props> extends EntityBase<P> {
+export declare abstract class AggregateBase<P extends Props> extends IdentifiableModel<P> {
     protected readonly _version: number;
     constructor(metadata: AggregateMetadata, props?: P);
     abstract version(): number;

package/dist/core/aggregate/aggregate-base/aggregate.js

@@ -1,11 +1,22 @@
 "use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AggregateBase = void 0;
-const entity_1 = require("../../entity");
-const message_1 = require("../../message");
-class AggregateBase extends entity_1.EntityBase {
+const base_1 = require("../../../base");
+const identifiable_model_1 = require("../../identifiable-model");
+let AggregateBase = class AggregateBase extends identifiable_model_1.IdentifiableModel {
     constructor(metadata, props) {
-        super(metadata, props);
+        super(metadata);
+        if (props)
+            this.initializeProps(props);
         this._version = metadata.version;
     }
     metadata() {
@@ -21,11 +32,15 @@ class AggregateBase extends entity_1.EntityBase {
         };
     }
     newEvent(eventClass, props) {
-        const eventBuilder = new message_1.EventBuilder(eventClass);
-        return eventBuilder
+        return eventClass
+            .builder()
             .withSource(this.createEventSource())
             .withProps(props)
             .build();
     }
-}
+};
 exports.AggregateBase = AggregateBase;
+exports.AggregateBase = AggregateBase = __decorate([
+    (0, base_1.Mutable)(true),
+    __metadata("design:paramtypes", [Object, Object])
+], AggregateBase);

package/dist/core/aggregate/event-sourced-aggregate/event-sourced-aggregate.d.ts

@@ -6,9 +6,11 @@ import { AggregateBase, AggregateMetadata } from "../aggregate-base";
 import { IAggregateEventDispatcher } from "../aggregate-base";
 import { EventSourcedAggregateModelDescriptor } from "./event-sourced-aggregate-model-descriptor";
 import { Snapshot, SnapshotMetadata } from "./snapshot";
+import { EventSourcedAggregateBuilder } from ".";
 export interface EventSourceAggregateMetadata extends AggregateMetadata {
 }
 export declare class EventSourcedAggregateBase<P extends Props> extends AggregateBase<P> {
+    static builder<T extends AnyEventSourcedAggregate>(this: EventSourcedAggregateClass<T>): EventSourcedAggregateBuilder<T>;
     private _handledCommands;
     private _pastEvents;
     private _events;
@@ -23,7 +25,7 @@ export declare class EventSourcedAggregateBase<P extends Props> extends Aggregat
     events(): AnyEvent[];
     handledCommands(): AnyCommand[];
     hasNewEvent(): boolean;
-    getApplierForEvent<E extends AnyEvent>(event: E): EventApplier<E>;
+    getEventApplier<E extends AnyEvent>(event: E): EventApplier<E>;
     private validateEventBeforeApply;
     private _applyEvent;
     private applyPastEvent;
@@ -31,7 +33,7 @@ export declare class EventSourcedAggregateBase<P extends Props> extends Aggregat
     applyEvent<E extends AnyEvent>(event: E): void;
     applyEvents(events: AnyEvent[]): void;
     applyNewEvent<E extends AnyEvent>(eventClass: EventClassWithTypedConstructor<E>, props: PropsOf<E>): void;
-    getHandlerForCommand<C extends AnyCommand>(command: C): CommandHandler<C, AnyEvent | AnyEvent[]>;
+    getCommandHandler<C extends AnyCommand>(command: C): CommandHandler<C, AnyEvent | AnyEvent[]>;
     handleCommand<C extends AnyCommand>(command: C): AnyEvent[];
     snapMetadata(): SnapshotMetadata;
     snap(): Snapshot<this>;

package/dist/core/aggregate/event-sourced-aggregate/event-sourced-aggregate.js

@@ -4,7 +4,11 @@ exports.EventSourcedAggregateBase = void 0;
 const meta_1 = require("../../../meta");
 const utils_1 = require("../../../utils");
 const aggregate_base_1 = require("../aggregate-base");
+const _1 = require(".");
 class EventSourcedAggregateBase extends aggregate_base_1.AggregateBase {
+    static builder() {
+        return new _1.EventSourcedAggregateBuilder(this);
+    }
     constructor(metadata, props) {
         super(metadata, props);
         this._handledCommands = [];
@@ -48,7 +52,7 @@ class EventSourcedAggregateBase extends aggregate_base_1.AggregateBase {
     hasNewEvent() {
         return Boolean(this._events.length);
     }
-    getApplierForEvent(event) {
+    getEventApplier(event) {
         const { eventType } = event.modelDescriptor();
         const { eventApplierMap } = this.modelDescriptor();
         const applier = eventApplierMap.get(eventType);
@@ -64,13 +68,13 @@ class EventSourcedAggregateBase extends aggregate_base_1.AggregateBase {
             throw new Error("Invalid aggregate version");
     }
     _applyEvent(event) {
-        const applier = this.getApplierForEvent(event);
+        const applier = this.getEventApplier(event);
         this.validateEventBeforeApply(event);
         applier.call(this, event);
     }
     applyPastEvent(event) {
         if (this.hasNewEvent())
-            throw new Error();
+            throw new Error("Cannot apply a past event when new event is recorded");
         this._applyEvent(event);
         this._pastEvents.push(event);
     }
@@ -91,7 +95,7 @@ class EventSourcedAggregateBase extends aggregate_base_1.AggregateBase {
     applyNewEvent(eventClass, props) {
         this.applyEvent(this.newEvent(eventClass, props));
     }
-    getHandlerForCommand(command) {
+    getCommandHandler(command) {
         const { commandType } = command.modelDescriptor();
         const { commandHandlerMap } = this.modelDescriptor();
         const handler = commandHandlerMap.get(commandType);
@@ -100,7 +104,7 @@ class EventSourcedAggregateBase extends aggregate_base_1.AggregateBase {
         return handler;
     }
     handleCommand(command) {
-        const handler = this.getHandlerForCommand(command);
+        const handler = this.getCommandHandler(command);
         const events = (0, utils_1.toArray)(handler.call(this, command));
         events.forEach((event) => {
             event.setCausationId(command.id());

package/dist/core/aggregate/state-aggregate/state-aggregate.d.ts

@@ -3,9 +3,11 @@ import { Props, PropsOf } from "../../../base";
 import { ClassStatic } from "../../../types";
 import { AnyEvent, EventClassWithTypedConstructor } from "../../message";
 import { AggregateBase, AggregateMetadata, IAggregateEventDispatcher } from "../aggregate-base";
+import { StateAggregateBuilder } from ".";
 export interface StateAggregateMetadata extends AggregateMetadata {
 }
 export declare class StateAggregateBase<P extends Props> extends AggregateBase<P> {
+    static builder<T extends AnyStateAggregate>(this: StateAggregateClass<T>): StateAggregateBuilder<T>;
     private _events;
     constructor(metadata: StateAggregateMetadata, props: P);
     props(): P;

package/dist/core/aggregate/state-aggregate/state-aggregate.js

@@ -2,7 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StateAggregateBase = void 0;
 const aggregate_base_1 = require("../aggregate-base");
+const _1 = require(".");
 class StateAggregateBase extends aggregate_base_1.AggregateBase {
+    static builder() {
+        return new _1.StateAggregateBuilder(this);
+    }
     constructor(metadata, props) {
         super(metadata, props);
         this._events = [];

package/dist/core/entity/entity.builder.d.ts

@@ -1,8 +1,6 @@
 import { IdentifiableModelBuilder } from "../identifiable-model";
 import { AnyEntity, EntityClassWithTypedConstructor } from "./entity";
-export declare abstract class EntityBuilderBase<T extends AnyEntity> extends IdentifiableModelBuilder<T> {
-}
-export declare class EntityBuilder<T extends AnyEntity> extends EntityBuilderBase<T> {
+export declare class EntityBuilder<T extends AnyEntity> extends IdentifiableModelBuilder<T> {
     private entityClass;
     constructor(entityClass: EntityClassWithTypedConstructor<T>);
     build(): T;

package/dist/core/entity/entity.builder.js

@@ -1,16 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EntityBuilder = exports.EntityBuilderBase = void 0;
+exports.EntityBuilder = void 0;
 const identifiable_model_1 = require("../identifiable-model");
-class EntityBuilderBase extends identifiable_model_1.IdentifiableModelBuilder {
-}
-exports.EntityBuilderBase = EntityBuilderBase;
-class EntityBuilder extends EntityBuilderBase {
+class EntityBuilder extends identifiable_model_1.IdentifiableModelBuilder {
     constructor(entityClass) {
         super();
         this.entityClass = entityClass;
     }
     build() {
+        if (!this.props)
+            throw new Error("The props must be set before build");
         return new this.entityClass({ id: this.id }, this.props);
     }
 }

package/dist/core/entity/entity.d.ts

@@ -2,10 +2,12 @@ import { Class } from "type-fest";
 import { Props, PropsOf } from "../../base";
 import { ClassStatic } from "../../types";
 import { IdentifiableModel, IdentifiableModelMetadata } from "../identifiable-model";
+import { EntityBuilder } from ".";
 export interface EntityMetadata extends IdentifiableModelMetadata {
 }
 export declare class EntityBase<P extends Props> extends IdentifiableModel<P> {
-    constructor(metadata: EntityMetadata, props?: P);
+    static builder<T extends AnyEntity>(this: EntityClass<T>): EntityBuilder<T>;
+    constructor(metadata: EntityMetadata, props: P);
 }
 export type AnyEntity = EntityBase<Props>;
 export interface EntityClass<T extends AnyEntity = AnyEntity, Arguments extends unknown[] = any[]> extends Class<T, Arguments>, ClassStatic<typeof EntityBase<PropsOf<T>>> {

package/dist/core/entity/entity.js

@@ -12,11 +12,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.EntityBase = void 0;
 const base_1 = require("../../base");
 const identifiable_model_1 = require("../identifiable-model");
+const _1 = require(".");
 let EntityBase = class EntityBase extends identifiable_model_1.IdentifiableModel {
+    static builder() {
+        return new _1.EntityBuilder(this);
+    }
     constructor(metadata, props) {
         super(metadata);
-        if (props)
-            this.initializeProps(props);
+        this.initializeProps(props);
     }
 };
 exports.EntityBase = EntityBase;

package/dist/core/enum/enum.d.ts

@@ -1,12 +1,16 @@
 import { Class } from "type-fest";
 import { ModelBase } from "../../base";
 import { ClassStatic } from "../../types";
+import { EnumBuilder } from ".";
 export type EnumValue = string | number;
 export interface EnumProps {
     value: EnumValue;
 }
 export declare class EnumBase extends ModelBase<EnumProps> {
+    static builder<T extends AnyEnum>(this: EnumClass<T>): EnumBuilder<T>;
     static values(): EnumBase[];
+    static from<T extends AnyEnum>(this: EnumClass<T>, value: EnumValue): T;
+    static fromSafe<T extends AnyEnum>(this: EnumClass<T>, value: EnumValue): T | null;
     constructor(value: EnumValue);
     value: EnumValue;
     valueOf(): EnumValue;

package/dist/core/enum/enum.js

@@ -11,10 +11,20 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EnumBase = void 0;
 const base_1 = require("../../base");
+const _1 = require(".");
 let EnumBase = class EnumBase extends base_1.ModelBase {
+    static builder() {
+        return new _1.EnumBuilder(this);
+    }
     static values() {
         return Array.from(this.ownStaticValues().values()).map((staticValue) => staticValue.value);
     }
+    static from(value) {
+        return this.builder().withValue(value).build();
+    }
+    static fromSafe(value) {
+        return this.builder().withValue(value).buildSafe();
+    }
     constructor(value) {
         super();
         this.initializeProps({ value });

package/dist/core/message/command/command.d.ts

@@ -4,10 +4,12 @@ import { Props, PropsOf } from "../../../base";
 import { ClassStatic } from "../../../types";
 import { MessageBase, MessageMetadata } from "../message-base";
 import { CommandModelDescriptor } from "./command-model-descriptor";
+import { CommandBuilder } from ".";
 export interface CommandMetadata extends MessageMetadata {
     commandType: CommandType;
 }
 export declare class CommandBase<P extends Props> extends MessageBase<P> {
+    static builder<T extends AnyCommand>(this: CommandClass<T>): CommandBuilder<T>;
     protected readonly _commandType: CommandType;
     static commandType(): string;
     constructor(metadata: Omit<CommandMetadata, "commandType">, props: P);

package/dist/core/message/command/command.js

@@ -3,7 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CommandBase = void 0;
 const meta_1 = require("../../../meta");
 const message_base_1 = require("../message-base");
+const _1 = require(".");
 class CommandBase extends message_base_1.MessageBase {
+    static builder() {
+        return new _1.CommandBuilder(this);
+    }
     static commandType() {
         return (0, meta_1.getCommandType)(this);
     }

package/dist/core/message/event/event.d.ts

@@ -5,6 +5,7 @@ import { ClassStatic } from "../../../types";
 import { Id } from "../../identifiable-model";
 import { MessageBase, MessageMetadata } from "../message-base";
 import { EventModelDescriptor } from "./event-model-descriptor";
+import { EventBuilder } from ".";
 export type EventSource = Readonly<{
     aggregateId: Id;
     aggregateVersion: number;
@@ -14,6 +15,7 @@ export interface EventMetadata extends MessageMetadata {
     source: EventSource;
 }
 export declare class EventBase<P extends Props> extends MessageBase<P> {
+    static builder<T extends AnyEvent>(this: EventClass<T>): EventBuilder<T>;
     private readonly _eventType;
     private readonly _source;
     constructor(metadata: Omit<EventMetadata, "eventType">, props: P);

package/dist/core/message/event/event.js

@@ -3,7 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.EventBase = void 0;
 const meta_1 = require("../../../meta");
 const message_base_1 = require("../message-base");
+const _1 = require(".");
 class EventBase extends message_base_1.MessageBase {
+    static builder() {
+        return new _1.EventBuilder(this);
+    }
     constructor(metadata, props) {
         super(metadata, props);
         this._eventType = (0, meta_1.getEventType)(this.constructor);

package/dist/event-pubsub/event-publisher.js

@@ -7,7 +7,6 @@ class EventPublisher {
     }
     async publish(event) {
         const subscribers = this.subscriberRegistry.getAllSubscribersForEvent(event.constructor);
-        // TODO: should convert to for await (subscriber be called sequently) ?
         await Promise.all(subscribers.map((subscriber) => subscriber.handleEvent(event)));
     }
 }

package/dist/package.json

@@ -1 +1 @@
-{"name":"ddd-node","version":"24.6.1","description":"Domain Driven Design base for NodeJs","type":"commonjs","main":"index.js","types":"index.d.ts","files":["dist"],"repository":{"type":"git","url":"https://github.com/nqd881/ddd-node"},"keywords":["ddd","ddd-node","ddd-base","ddd-ts","ddd-js"],"author":"Quoc Dai","license":"ISC","devDependencies":{"@types/chai":"^4.3.16","@types/lodash":"^4.14.200","@types/mocha":"^10.0.6","@types/uuid":"^9.0.6","chai":"^5.1.1","chai-deep-match":"^1.2.1","ddd-node":"file:dist","mocha":"^10.4.0","ts-node":"^10.9.1","tsconfig-paths":"^4.2.0","typescript":"^5.2.2"},"dependencies":{"lodash":"^4.17.21","reflect-metadata":"^0.1.13","tsc-alias":"^1.8.8","type-fest":"^4.20.1","uuid":"^9.0.1"}}
+{"name":"ddd-node","version":"25.0.0","description":"Domain Driven Design base for NodeJs","type":"commonjs","main":"index.js","types":"index.d.ts","files":["dist"],"repository":{"type":"git","url":"https://github.com/nqd881/ddd-node"},"keywords":["ddd","ddd-node","ddd-base","ddd-ts","ddd-js"],"author":"Quoc Dai","license":"ISC","devDependencies":{"@types/chai":"^4.3.16","@types/lodash":"^4.14.200","@types/mocha":"^10.0.6","@types/uuid":"^9.0.6","chai":"^5.1.1","chai-deep-match":"^1.2.1","ddd-node":"file:dist","mocha":"^10.4.0","ts-node":"^10.9.1","tsconfig-paths":"^4.2.0","typescript":"^5.2.2"},"dependencies":{"lodash":"^4.17.21","reflect-metadata":"^0.1.13","tsc-alias":"^1.8.8","type-fest":"^4.20.1","uuid":"^9.0.1"}}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ddd-node",
-  "version": "24.6.1",
+  "version": "25.0.0",
   "description": "Domain Driven Design base for NodeJs",
   "type": "module",
   "main": "dist/index.js",