@rolandsall24/nest-mediator 0.7.0 → 1.0.0

package/dist/index.d.ts

@@ -3,5 +3,8 @@ export * from './lib/decorators/index.js';
 export * from './lib/services/index.js';
 export * from './lib/behaviors/index.js';
 export * from './lib/exceptions/index.js';
+export * from './lib/context/index.js';
+export * from './lib/aggregate/index.js';
+export * from './lib/event-store/index.js';
 export * from './lib/nest-mediator.module.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,2BAA2B,CAAC;AAG1C,cAAc,2BAA2B,CAAC;AAG1C,cAAc,yBAAyB,CAAC;AAGxC,cAAc,0BAA0B,CAAC;AAGzC,cAAc,2BAA2B,CAAC;AAG1C,cAAc,+BAA+B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,2BAA2B,CAAC;AAG1C,cAAc,2BAA2B,CAAC;AAG1C,cAAc,yBAAyB,CAAC;AAGxC,cAAc,0BAA0B,CAAC;AAGzC,cAAc,2BAA2B,CAAC;AAG1C,cAAc,wBAAwB,CAAC;AAGvC,cAAc,0BAA0B,CAAC;AAGzC,cAAc,4BAA4B,CAAC;AAG3C,cAAc,+BAA+B,CAAC"}

package/dist/index.js

@@ -24,6 +24,12 @@ __exportStar(require("./lib/services/index.js"), exports);
 __exportStar(require("./lib/behaviors/index.js"), exports);
 // Exceptions
 __exportStar(require("./lib/exceptions/index.js"), exports);
+// Context
+__exportStar(require("./lib/context/index.js"), exports);
+// Aggregate (Event Sourcing)
+__exportStar(require("./lib/aggregate/index.js"), exports);
+// Event Store
+__exportStar(require("./lib/event-store/index.js"), exports);
 // Module
 __exportStar(require("./lib/nest-mediator.module.js"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,aAAa;AACb,4DAA0C;AAE1C,aAAa;AACb,4DAA0C;AAE1C,WAAW;AACX,0DAAwC;AAExC,YAAY;AACZ,2DAAyC;AAEzC,aAAa;AACb,4DAA0C;AAE1C,SAAS;AACT,gEAA8C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,aAAa;AACb,4DAA0C;AAE1C,aAAa;AACb,4DAA0C;AAE1C,WAAW;AACX,0DAAwC;AAExC,YAAY;AACZ,2DAAyC;AAEzC,aAAa;AACb,4DAA0C;AAE1C,UAAU;AACV,yDAAuC;AAEvC,6BAA6B;AAC7B,2DAAyC;AAEzC,cAAc;AACd,6DAA2C;AAE3C,SAAS;AACT,gEAA8C"}

package/dist/lib/aggregate/aggregate-repository.base.d.ts

@@ -0,0 +1,90 @@
+import { IEvent, IEventBus, IEventStoreRepository } from '../interfaces/index.js';
+import { AggregateRoot } from './aggregate-root.base.js';
+/**
+ * Base class for aggregate repositories in event sourcing.
+ *
+ * Repositories handle loading and saving aggregates:
+ * - Loading: Replay events from event store to rebuild aggregate state
+ * - Saving: Publish uncommitted events via event bus (which persists + dispatches to consumers)
+ *
+ * Use the `@ForAggregate(AggregateClass)` decorator to eliminate all boilerplate.
+ * The decorator + global `@DomainEvent` registry provide:
+ * - `aggregateType` — derived from a temporary aggregate instance
+ * - `createEmptyAggregate()` — instantiates the aggregate class
+ * - `deserializeEvent()` — looks up event classes from the `@DomainEvent` registry
+ *
+ * @template TAggregate - The aggregate type
+ * @template TId - The aggregate's identifier type
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * @ForAggregate(OrderAggregate)
+ * export class OrderRepository extends AggregateRepository<OrderAggregate, string>
+ *   implements IOrderRepository {}
+ * ```
+ */
+export declare abstract class AggregateRepository<TAggregate extends AggregateRoot<TId>, TId = string> {
+    private readonly logger;
+    protected readonly eventStore: IEventStoreRepository;
+    protected readonly eventBus: IEventBus;
+    /**
+     * The aggregate type name, derived from the aggregate class metadata.
+     * Lazily resolved on first access.
+     */
+    private _aggregateType?;
+    protected get aggregateType(): string;
+    /**
+     * Create an empty aggregate instance for hydration.
+     * Derived from the `@ForAggregate` decorator metadata.
+     * Can be overridden for custom instantiation logic.
+     */
+    protected createEmptyAggregate(): TAggregate;
+    /**
+     * Deserialize a stored event back to an event instance.
+     * Uses the global `@DomainEvent` registry to find the event class.
+     * Can be overridden for custom deserialization logic.
+     *
+     * Returns `null` for event types not registered for this aggregate.
+     * This is expected — side-effect events (e.g. InventoryReservedEvent)
+     * may be stored under the same aggregate ID but are not part of
+     * the aggregate's state and should be skipped during hydration.
+     *
+     * @param eventType - The event class name
+     * @param payload - The serialized event data
+     * @returns The deserialized event, or null if the event type is not registered
+     */
+    protected deserializeEvent(eventType: string, payload: Record<string, unknown>): IEvent | null;
+    /**
+     * Find an aggregate by its ID.
+     * Returns null if the aggregate doesn't exist.
+     *
+     * @param id - The aggregate ID
+     * @returns The hydrated aggregate or null
+     */
+    findById(id: TId): Promise<TAggregate | null>;
+    /**
+     * Get an aggregate by its ID.
+     * Throws an error if the aggregate doesn't exist.
+     *
+     * @param id - The aggregate ID
+     * @returns The hydrated aggregate
+     * @throws Error if aggregate not found
+     */
+    getById(id: TId): Promise<TAggregate>;
+    /**
+     * Save an aggregate by publishing its uncommitted events.
+     *
+     * Each event is published via the event bus, which:
+     * 1. Persists the event to the event store (system phase)
+     * 2. Dispatches to critical consumers (sequential, with compensation)
+     * 3. Dispatches to non-critical consumers (parallel, fire-and-forget)
+     *
+     * After all events are successfully published, they are marked as committed.
+     *
+     * @param aggregate - The aggregate to save
+     * @throws Error if any event fails to publish (compensation will run for critical consumers)
+     */
+    save(aggregate: TAggregate): Promise<void>;
+}
+//# sourceMappingURL=aggregate-repository.base.d.ts.map

package/dist/lib/aggregate/aggregate-repository.base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate-repository.base.d.ts","sourceRoot":"","sources":["../../../src/lib/aggregate/aggregate-repository.base.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,qBAAqB,EAA0B,MAAM,wBAAwB,CAAC;AAC1G,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAKzD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,8BAAsB,mBAAmB,CACvC,UAAU,SAAS,aAAa,CAAC,GAAG,CAAC,EACrC,GAAG,GAAG,MAAM;IAEZ,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;IAG5D,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAG,qBAAqB,CAAC;IAGtD,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAG,SAAS,CAAC;IAExC;;;OAGG;IACH,OAAO,CAAC,cAAc,CAAC,CAAS;IAEhC,SAAS,KAAK,aAAa,IAAI,MAAM,CAKpC;IAED;;;;OAIG;IACH,SAAS,CAAC,oBAAoB,IAAI,UAAU;IAY5C;;;;;;;;;;;;;OAaG;IACH,SAAS,CAAC,gBAAgB,CACxB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM,GAAG,IAAI;IAchB;;;;;;OAMG;IACG,QAAQ,CAAC,EAAE,EAAE,GAAG,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAsBnD;;;;;;;OAOG;IACG,OAAO,CAAC,EAAE,EAAE,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC;IAU3C;;;;;;;;;;;;OAYG;IACG,IAAI,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CAgBjD"}

package/dist/lib/aggregate/aggregate-repository.base.js

@@ -0,0 +1,161 @@
+"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.AggregateRepository = void 0;
+const common_1 = require("@nestjs/common");
+const index_js_1 = require("../interfaces/index.js");
+const for_aggregate_decorator_js_1 = require("../decorators/for-aggregate.decorator.js");
+const domain_event_decorator_js_1 = require("../decorators/domain-event.decorator.js");
+const mediator_bus_js_1 = require("../services/mediator.bus.js");
+/**
+ * Base class for aggregate repositories in event sourcing.
+ *
+ * Repositories handle loading and saving aggregates:
+ * - Loading: Replay events from event store to rebuild aggregate state
+ * - Saving: Publish uncommitted events via event bus (which persists + dispatches to consumers)
+ *
+ * Use the `@ForAggregate(AggregateClass)` decorator to eliminate all boilerplate.
+ * The decorator + global `@DomainEvent` registry provide:
+ * - `aggregateType` — derived from a temporary aggregate instance
+ * - `createEmptyAggregate()` — instantiates the aggregate class
+ * - `deserializeEvent()` — looks up event classes from the `@DomainEvent` registry
+ *
+ * @template TAggregate - The aggregate type
+ * @template TId - The aggregate's identifier type
+ *
+ * @example
+ * ```typescript
+ * @Injectable()
+ * @ForAggregate(OrderAggregate)
+ * export class OrderRepository extends AggregateRepository<OrderAggregate, string>
+ *   implements IOrderRepository {}
+ * ```
+ */
+class AggregateRepository {
+    constructor() {
+        this.logger = new common_1.Logger(this.constructor.name);
+    }
+    get aggregateType() {
+        if (!this._aggregateType) {
+            this._aggregateType = this.createEmptyAggregate().aggregateType;
+        }
+        return this._aggregateType;
+    }
+    /**
+     * Create an empty aggregate instance for hydration.
+     * Derived from the `@ForAggregate` decorator metadata.
+     * Can be overridden for custom instantiation logic.
+     */
+    createEmptyAggregate() {
+        const aggregateClass = Reflect.getMetadata(for_aggregate_decorator_js_1.AGGREGATE_CLASS_METADATA, this.constructor);
+        if (!aggregateClass) {
+            throw new Error(`${this.constructor.name}: Missing @ForAggregate() decorator. ` +
+                `Add @ForAggregate(YourAggregate) to your repository class, ` +
+                `or override createEmptyAggregate().`);
+        }
+        return new aggregateClass();
+    }
+    /**
+     * Deserialize a stored event back to an event instance.
+     * Uses the global `@DomainEvent` registry to find the event class.
+     * Can be overridden for custom deserialization logic.
+     *
+     * Returns `null` for event types not registered for this aggregate.
+     * This is expected — side-effect events (e.g. InventoryReservedEvent)
+     * may be stored under the same aggregate ID but are not part of
+     * the aggregate's state and should be skipped during hydration.
+     *
+     * @param eventType - The event class name
+     * @param payload - The serialized event data
+     * @returns The deserialized event, or null if the event type is not registered
+     */
+    deserializeEvent(eventType, payload) {
+        const eventClasses = (0, domain_event_decorator_js_1.getEventClassesForAggregate)(this.aggregateType);
+        const EventClass = eventClasses.get(eventType);
+        if (!EventClass) {
+            this.logger.debug(`Skipping event type "${eventType}" — not registered for aggregate "${this.aggregateType}"`);
+            return null;
+        }
+        return Object.assign(Object.create(EventClass.prototype), payload);
+    }
+    /**
+     * Find an aggregate by its ID.
+     * Returns null if the aggregate doesn't exist.
+     *
+     * @param id - The aggregate ID
+     * @returns The hydrated aggregate or null
+     */
+    async findById(id) {
+        const storedEvents = await this.eventStore.getEventsForAggregate(this.aggregateType, String(id));
+        if (storedEvents.length === 0) {
+            return null;
+        }
+        // Deserialize events, filtering out side-effect events not owned by this aggregate
+        const events = storedEvents
+            .map((stored) => this.deserializeEvent(stored.eventType, stored.payload))
+            .filter((event) => event !== null);
+        // Create aggregate and replay events
+        const aggregate = this.createEmptyAggregate();
+        aggregate.loadFromHistory(events);
+        return aggregate;
+    }
+    /**
+     * Get an aggregate by its ID.
+     * Throws an error if the aggregate doesn't exist.
+     *
+     * @param id - The aggregate ID
+     * @returns The hydrated aggregate
+     * @throws Error if aggregate not found
+     */
+    async getById(id) {
+        const aggregate = await this.findById(id);
+        if (!aggregate) {
+            throw new Error(`${this.aggregateType} with id ${id} not found`);
+        }
+        return aggregate;
+    }
+    /**
+     * Save an aggregate by publishing its uncommitted events.
+     *
+     * Each event is published via the event bus, which:
+     * 1. Persists the event to the event store (system phase)
+     * 2. Dispatches to critical consumers (sequential, with compensation)
+     * 3. Dispatches to non-critical consumers (parallel, fire-and-forget)
+     *
+     * After all events are successfully published, they are marked as committed.
+     *
+     * @param aggregate - The aggregate to save
+     * @throws Error if any event fails to publish (compensation will run for critical consumers)
+     */
+    async save(aggregate) {
+        const events = aggregate.getUncommittedEvents();
+        if (events.length === 0) {
+            return; // Nothing to save
+        }
+        // Publish each event through the event bus
+        // This triggers: persistence → critical consumers → non-critical consumers
+        for (const event of events) {
+            await this.eventBus.publish(event);
+        }
+        // Mark events as committed after successful publish
+        aggregate.markEventsAsCommitted();
+    }
+}
+exports.AggregateRepository = AggregateRepository;
+__decorate([
+    (0, common_1.Inject)(index_js_1.EVENT_STORE_REPOSITORY),
+    __metadata("design:type", Object)
+], AggregateRepository.prototype, "eventStore", void 0);
+__decorate([
+    (0, common_1.Inject)(mediator_bus_js_1.MediatorBus),
+    __metadata("design:type", Object)
+], AggregateRepository.prototype, "eventBus", void 0);
+//# sourceMappingURL=aggregate-repository.base.js.map

package/dist/lib/aggregate/aggregate-repository.base.js.map

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

package/dist/lib/aggregate/aggregate-root.base.d.ts

@@ -0,0 +1,105 @@
+import { IEvent } from '../interfaces/index.js';
+/**
+ * Base class for aggregate roots in event sourcing.
+ *
+ * Aggregates encapsulate domain logic and track uncommitted events.
+ * Events are applied to update state and tracked for later persistence.
+ *
+ * @template TId - The type of the aggregate's identifier
+ *
+ * @example
+ * ```typescript
+ * class OrderAggregate extends AggregateRoot<string> {
+ *   private _id: string;
+ *   private _status: 'draft' | 'placed' = 'draft';
+ *
+ *   readonly aggregateType = 'Order';
+ *   get id() { return this._id; }
+ *
+ *   static create(orderId: string): OrderAggregate {
+ *     const order = new OrderAggregate();
+ *     order.apply(new OrderCreatedEvent(orderId));
+ *     return order;
+ *   }
+ *
+ *   place(): void {
+ *     if (this._status !== 'draft') throw new Error('Order already placed');
+ *     this.apply(new OrderPlacedEvent(this._id));
+ *   }
+ *
+ *   // Event handlers
+ *   applyOrderCreatedEvent(event: OrderCreatedEvent): void {
+ *     this._id = event.orderId;
+ *   }
+ *
+ *   applyOrderPlacedEvent(event: OrderPlacedEvent): void {
+ *     this._status = 'placed';
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class AggregateRoot<TId = string> {
+    private readonly logger;
+    /**
+     * Events that have been applied but not yet persisted
+     */
+    private _uncommittedEvents;
+    /**
+     * The current version (number of events applied from history)
+     */
+    private _version;
+    /**
+     * The aggregate's unique identifier.
+     * Must be implemented by concrete classes.
+     */
+    abstract readonly id: TId;
+    /**
+     * The aggregate type name (e.g., 'Order', 'User').
+     * Used for event store partitioning.
+     * Must be implemented by concrete classes.
+     */
+    abstract readonly aggregateType: string;
+    /**
+     * Get the current version of the aggregate.
+     * This is the number of events that have been loaded from history.
+     */
+    get version(): number;
+    /**
+     * Get all events that have been applied but not yet persisted.
+     * These should be published after saving the aggregate.
+     */
+    getUncommittedEvents(): IEvent[];
+    /**
+     * Clear uncommitted events after they have been persisted.
+     * Call this after successfully publishing all events.
+     */
+    markEventsAsCommitted(): void;
+    /**
+     * Rebuild the aggregate state from historical events.
+     * Used when loading an aggregate from the event store.
+     *
+     * @param events - The events to replay
+     */
+    loadFromHistory(events: IEvent[]): void;
+    /**
+     * Apply a new event to the aggregate.
+     * Call this from command methods to record state changes.
+     *
+     * This method does two things:
+     * 1. Calls the matching handler method on your aggregate to update state.
+     *    The handler is found by convention: `apply` + event class name.
+     *    Example: `apply(new OrderPlacedEvent(...))` calls `this.applyOrderPlacedEvent(event)`.
+     * 2. Tracks the event as uncommitted so `AggregateRepository.save()` can publish it.
+     *
+     * @param event - The event to apply
+     */
+    protected apply(event: IEvent): void;
+    /**
+     * Apply an event to update state and optionally track it.
+     *
+     * @param event - The event to apply
+     * @param isNew - Whether this is a new event (true) or from history (false)
+     */
+    private applyEvent;
+}
+//# sourceMappingURL=aggregate-root.base.d.ts.map

package/dist/lib/aggregate/aggregate-root.base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate-root.base.d.ts","sourceRoot":"","sources":["../../../src/lib/aggregate/aggregate-root.base.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,8BAAsB,aAAa,CAAC,GAAG,GAAG,MAAM;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;IAE5D;;OAEG;IACH,OAAO,CAAC,kBAAkB,CAAgB;IAE1C;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAa;IAE7B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC;IAE1B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAExC;;;OAGG;IACH,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED;;;OAGG;IACH,oBAAoB,IAAI,MAAM,EAAE;IAIhC;;;OAGG;IACH,qBAAqB,IAAI,IAAI;IAI7B;;;;;OAKG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI;IAOvC;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIpC;;;;;OAKG;IACH,OAAO,CAAC,UAAU;CAkBnB"}

package/dist/lib/aggregate/aggregate-root.base.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AggregateRoot = void 0;
+const common_1 = require("@nestjs/common");
+/**
+ * Base class for aggregate roots in event sourcing.
+ *
+ * Aggregates encapsulate domain logic and track uncommitted events.
+ * Events are applied to update state and tracked for later persistence.
+ *
+ * @template TId - The type of the aggregate's identifier
+ *
+ * @example
+ * ```typescript
+ * class OrderAggregate extends AggregateRoot<string> {
+ *   private _id: string;
+ *   private _status: 'draft' | 'placed' = 'draft';
+ *
+ *   readonly aggregateType = 'Order';
+ *   get id() { return this._id; }
+ *
+ *   static create(orderId: string): OrderAggregate {
+ *     const order = new OrderAggregate();
+ *     order.apply(new OrderCreatedEvent(orderId));
+ *     return order;
+ *   }
+ *
+ *   place(): void {
+ *     if (this._status !== 'draft') throw new Error('Order already placed');
+ *     this.apply(new OrderPlacedEvent(this._id));
+ *   }
+ *
+ *   // Event handlers
+ *   applyOrderCreatedEvent(event: OrderCreatedEvent): void {
+ *     this._id = event.orderId;
+ *   }
+ *
+ *   applyOrderPlacedEvent(event: OrderPlacedEvent): void {
+ *     this._status = 'placed';
+ *   }
+ * }
+ * ```
+ */
+class AggregateRoot {
+    constructor() {
+        this.logger = new common_1.Logger(this.constructor.name);
+        /**
+         * Events that have been applied but not yet persisted
+         */
+        this._uncommittedEvents = [];
+        /**
+         * The current version (number of events applied from history)
+         */
+        this._version = 0;
+    }
+    /**
+     * Get the current version of the aggregate.
+     * This is the number of events that have been loaded from history.
+     */
+    get version() {
+        return this._version;
+    }
+    /**
+     * Get all events that have been applied but not yet persisted.
+     * These should be published after saving the aggregate.
+     */
+    getUncommittedEvents() {
+        return [...this._uncommittedEvents];
+    }
+    /**
+     * Clear uncommitted events after they have been persisted.
+     * Call this after successfully publishing all events.
+     */
+    markEventsAsCommitted() {
+        this._uncommittedEvents = [];
+    }
+    /**
+     * Rebuild the aggregate state from historical events.
+     * Used when loading an aggregate from the event store.
+     *
+     * @param events - The events to replay
+     */
+    loadFromHistory(events) {
+        for (const event of events) {
+            this.applyEvent(event, false);
+            this._version++;
+        }
+    }
+    /**
+     * Apply a new event to the aggregate.
+     * Call this from command methods to record state changes.
+     *
+     * This method does two things:
+     * 1. Calls the matching handler method on your aggregate to update state.
+     *    The handler is found by convention: `apply` + event class name.
+     *    Example: `apply(new OrderPlacedEvent(...))` calls `this.applyOrderPlacedEvent(event)`.
+     * 2. Tracks the event as uncommitted so `AggregateRepository.save()` can publish it.
+     *
+     * @param event - The event to apply
+     */
+    apply(event) {
+        this.applyEvent(event, true);
+    }
+    /**
+     * Apply an event to update state and optionally track it.
+     *
+     * @param event - The event to apply
+     * @param isNew - Whether this is a new event (true) or from history (false)
+     */
+    applyEvent(event, isNew) {
+        // Build the handler method name: apply{EventClassName}
+        const handlerName = `apply${event.constructor.name}`;
+        const handler = this[handlerName];
+        if (typeof handler === 'function') {
+            handler.call(this, event);
+        }
+        else if (isNew) {
+            this.logger.warn(`${this.constructor.name} is missing "${handlerName}(event: ${event.constructor.name}): void" to apply state changes`);
+        }
+        if (isNew) {
+            this._uncommittedEvents.push(event);
+            this._version++;
+        }
+    }
+}
+exports.AggregateRoot = AggregateRoot;
+//# sourceMappingURL=aggregate-root.base.js.map

package/dist/lib/aggregate/aggregate-root.base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate-root.base.js","sourceRoot":"","sources":["../../../src/lib/aggregate/aggregate-root.base.ts"],"names":[],"mappings":";;;AAAA,2CAAwC;AAGxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAsB,aAAa;IAAnC;QACmB,WAAM,GAAG,IAAI,eAAM,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAE5D;;WAEG;QACK,uBAAkB,GAAa,EAAE,CAAC;QAE1C;;WAEG;QACK,aAAQ,GAAW,CAAC,CAAC;IA4F/B,CAAC;IA7EC;;;OAGG;IACH,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;;OAGG;IACH,oBAAoB;QAClB,OAAO,CAAC,GAAG,IAAI,CAAC,kBAAkB,CAAC,CAAC;IACtC,CAAC;IAED;;;OAGG;IACH,qBAAqB;QACnB,IAAI,CAAC,kBAAkB,GAAG,EAAE,CAAC;IAC/B,CAAC;IAED;;;;;OAKG;IACH,eAAe,CAAC,MAAgB;QAC9B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAC9B,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;IAED;;;;;;;;;;;OAWG;IACO,KAAK,CAAC,KAAa;QAC3B,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED;;;;;OAKG;IACK,UAAU,CAAC,KAAa,EAAE,KAAc;QAC9C,uDAAuD;QACvD,MAAM,WAAW,GAAG,QAAQ,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QACrD,MAAM,OAAO,GAAI,IAAgC,CAAC,WAAW,CAAC,CAAC;QAE/D,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC5B,CAAC;aAAM,IAAI,KAAK,EAAE,CAAC;YACjB,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,gBAAgB,WAAW,WAAW,KAAK,CAAC,WAAW,CAAC,IAAI,iCAAiC,CACtH,CAAC;QACJ,CAAC;QAED,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpC,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;CACF;AAvGD,sCAuGC"}

package/dist/lib/aggregate/index.d.ts

@@ -0,0 +1,3 @@
+export * from './aggregate-root.base.js';
+export * from './aggregate-repository.base.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/aggregate/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/aggregate/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC"}

package/dist/lib/aggregate/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./aggregate-root.base.js"), exports);
+__exportStar(require("./aggregate-repository.base.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/lib/aggregate/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/aggregate/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2DAAyC;AACzC,iEAA+C"}

package/dist/lib/context/index.d.ts

@@ -0,0 +1,2 @@
+export * from './mediator-context.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/context/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC"}

package/dist/lib/context/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./mediator-context.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/lib/context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/context/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC"}