@event-nest/core 4.0.2 → 5.0.0

package/src/lib/snapshot-strategy/for-events-snapshot-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"for-events-snapshot-strategy.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/snapshot-strategy/for-events-snapshot-strategy.ts"],"names":[],"mappings":";;;AAEA,2DAAuD;AAMvD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAa,yBAA0B,SAAQ,oCAAgB;IAC3D,YAA6B,MAAuC;QAChE,KAAK,EAAE,CAAC;QADiB,WAAM,GAAN,MAAM,CAAiC;IAEpE,CAAC;IAED,oBAAoB,CAAC,aAA4B;QAC7C,OAAO,aAAa,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CACnD,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,YAAY,MAAM,CAAC,CAC9E,CAAC;IACN,CAAC;CACJ;AAVD,8DAUC"}

package/src/lib/snapshot-strategy/no-snapshot-strategy.d.ts

@@ -0,0 +1,18 @@
+import { SnapshotStrategy } from "./snapshot-strategy";
+/**
+ * The default snapshot strategy used by the event-nest module when no snapshot strategy
+ * is explicitly configured. This strategy never creates snapshots, regardless of the
+ * aggregate root's state or events.
+ *
+ * If you want to enable snapshot creation, you should choose one of the other available
+ * snapshot strategies or build your own.
+ * Built-in strategies:
+ * - {@link ForCountSnapshotStrategy} - Create snapshots based on event count
+ * - {@link ForAggregateRootsStrategy} - Create snapshots for specific aggregate types
+ * - {@link ForEventsSnapshotStrategy} - Create snapshots when specific events occur
+ * - {@link AllOfSnapshotStrategy} - Combine multiple strategies with AND logic
+ * - {@link AnyOfSnapshotStrategy} - Combine multiple strategies with OR logic
+ */
+export declare class NoSnapshotStrategy extends SnapshotStrategy {
+    shouldCreateSnapshot(): boolean;
+}

package/src/lib/snapshot-strategy/no-snapshot-strategy.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NoSnapshotStrategy = void 0;
+const snapshot_strategy_1 = require("./snapshot-strategy");
+/**
+ * The default snapshot strategy used by the event-nest module when no snapshot strategy
+ * is explicitly configured. This strategy never creates snapshots, regardless of the
+ * aggregate root's state or events.
+ *
+ * If you want to enable snapshot creation, you should choose one of the other available
+ * snapshot strategies or build your own.
+ * Built-in strategies:
+ * - {@link ForCountSnapshotStrategy} - Create snapshots based on event count
+ * - {@link ForAggregateRootsStrategy} - Create snapshots for specific aggregate types
+ * - {@link ForEventsSnapshotStrategy} - Create snapshots when specific events occur
+ * - {@link AllOfSnapshotStrategy} - Combine multiple strategies with AND logic
+ * - {@link AnyOfSnapshotStrategy} - Combine multiple strategies with OR logic
+ */
+class NoSnapshotStrategy extends snapshot_strategy_1.SnapshotStrategy {
+    shouldCreateSnapshot() {
+        return false;
+    }
+}
+exports.NoSnapshotStrategy = NoSnapshotStrategy;
+//# sourceMappingURL=no-snapshot-strategy.js.map

package/src/lib/snapshot-strategy/no-snapshot-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-snapshot-strategy.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/snapshot-strategy/no-snapshot-strategy.ts"],"names":[],"mappings":";;;AAAA,2DAAuD;AAEvD;;;;;;;;;;;;;GAaG;AACH,MAAa,kBAAmB,SAAQ,oCAAgB;IACpD,oBAAoB;QAChB,OAAO,KAAK,CAAC;IACjB,CAAC;CACJ;AAJD,gDAIC"}

package/src/lib/snapshot-strategy/snapshot-strategy.d.ts

@@ -0,0 +1,26 @@
+import type { AggregateRoot } from "../aggregate-root/aggregate-root";
+/**
+ * Abstract base class for snapshot strategies. Snapshot strategies determine when snapshots
+ * should be created for aggregate roots.
+ *
+ * You can extend this class to create custom snapshot strategies that implement your own
+ * logic for determining when snapshots should be created. The built-in strategies include:
+ * - {@link NoSnapshotStrategy} - Never creates snapshots (default)
+ * - {@link ForCountSnapshotStrategy} - Creates snapshots based on event count
+ * - {@link ForAggregateRootsStrategy} - Creates snapshots for specific aggregate types
+ * - {@link ForEventsSnapshotStrategy} - Creates snapshots when specific events occur
+ * - {@link AllOfSnapshotStrategy} - Combines multiple strategies with AND logic
+ * - {@link AnyOfSnapshotStrategy} - Combines multiple strategies with OR logic
+ */
+export declare abstract class SnapshotStrategy {
+    /**
+     * Determines whether a snapshot should be created for the given aggregate root.
+     * This method is called before committing events to decide if a snapshot should be
+     * created at that point.
+     *
+     * @param aggregateRoot The aggregate root to evaluate
+     * @returns true if a snapshot should be created, false otherwise. Can return a Promise
+     *          for asynchronous evaluation.
+     */
+    abstract shouldCreateSnapshot(aggregateRoot: AggregateRoot): boolean | Promise<boolean>;
+}

package/src/lib/snapshot-strategy/snapshot-strategy.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SnapshotStrategy = void 0;
+/**
+ * Abstract base class for snapshot strategies. Snapshot strategies determine when snapshots
+ * should be created for aggregate roots.
+ *
+ * You can extend this class to create custom snapshot strategies that implement your own
+ * logic for determining when snapshots should be created. The built-in strategies include:
+ * - {@link NoSnapshotStrategy} - Never creates snapshots (default)
+ * - {@link ForCountSnapshotStrategy} - Creates snapshots based on event count
+ * - {@link ForAggregateRootsStrategy} - Creates snapshots for specific aggregate types
+ * - {@link ForEventsSnapshotStrategy} - Creates snapshots when specific events occur
+ * - {@link AllOfSnapshotStrategy} - Combines multiple strategies with AND logic
+ * - {@link AnyOfSnapshotStrategy} - Combines multiple strategies with OR logic
+ */
+class SnapshotStrategy {
+}
+exports.SnapshotStrategy = SnapshotStrategy;
+//# sourceMappingURL=snapshot-strategy.js.map

package/src/lib/snapshot-strategy/snapshot-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-strategy.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/snapshot-strategy/snapshot-strategy.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;GAYG;AACH,MAAsB,gBAAgB;CAWrC;AAXD,4CAWC"}

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

@@ -1,6 +1,7 @@
 import { AggregateRoot } from "../aggregate-root/aggregate-root";
 import { DomainEventEmitter } from "../domain-event-emitter";
-import { AggregateRootClass, EventStore } from "./event-store";
+import { AggregateRootClass, AggregateRootSnapshot, EventStore } from "./event-store";
+import { AbstractSnapshotStore } from "./snapshot/abstract-snapshot-store";
 import { StoredAggregateRoot } from "./stored-aggregate-root";
 import { StoredEvent } from "./stored-event";
 /**
@@ -10,11 +11,16 @@ import { StoredEvent } from "./stored-event";
  */
 export declare abstract class AbstractEventStore implements EventStore {
     private _eventEmitter;
-    protected constructor(_eventEmitter: DomainEventEmitter);
+    protected _snapshotStore: AbstractSnapshotStore;
+    protected constructor(_eventEmitter: DomainEventEmitter, _snapshotStore: AbstractSnapshotStore);
     addPublisher<T extends AggregateRoot>(aggregateRoot: T): T;
     abstract findAggregateRootVersion(id: string): Promise<number>;
     abstract findByAggregateRootId<T extends AggregateRoot>(aggregateRootClass: AggregateRootClass<T>, id: string): Promise<Array<StoredEvent>>;
     abstract findByAggregateRootIds<T extends AggregateRoot>(aggregateRootClass: AggregateRootClass<T>, ids: string[]): Promise<Record<string, Array<StoredEvent>>>;
+    abstract findWithSnapshot<T extends AggregateRoot>(aggregateRootClass: AggregateRootClass<T>, id: string): Promise<{
+        events: Array<StoredEvent>;
+        snapshot?: AggregateRootSnapshot<T>;
+    }>;
     abstract generateEntityId(): Promise<string>;
     abstract save(events: Array<StoredEvent>, aggregate: StoredAggregateRoot): Promise<Array<StoredEvent>>;
 }

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

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AbstractEventStore = void 0;
 const es_toolkit_1 = require("es-toolkit");
-const aggregate_root_name_1 = require("../aggregate-root/aggregate-root-name");
+const aggregate_root_config_1 = require("../aggregate-root/aggregate-root-config");
 const id_generation_exception_1 = require("../exceptions/id-generation-exception");
 const missing_aggregate_root_name_exception_1 = require("../exceptions/missing-aggregate-root-name-exception");
 const unknown_event_version_exception_1 = require("../exceptions/unknown-event-version-exception");
@@ -15,12 +15,13 @@ const stored_event_1 = require("./stored-event");
  * of the {@link EventStore:addPublisher} method and this is why this class exists.
  */
 class AbstractEventStore {
-    constructor(_eventEmitter) {
+    constructor(_eventEmitter, _snapshotStore) {
         this._eventEmitter = _eventEmitter;
+        this._snapshotStore = _snapshotStore;
     }
     addPublisher(aggregateRoot) {
         aggregateRoot.publish = async (events) => {
-            const aggregateRootName = (0, aggregate_root_name_1.getAggregateRootName)(aggregateRoot.constructor);
+            const aggregateRootName = (0, aggregate_root_config_1.getAggregateRootName)(aggregateRoot.constructor);
             if ((0, es_toolkit_1.isNil)(aggregateRootName)) {
                 throw new missing_aggregate_root_name_exception_1.MissingAggregateRootNameException(aggregateRoot.constructor.name);
             }
@@ -31,6 +32,7 @@ class AbstractEventStore {
             if (ids.length !== events.length || !(0, type_utils_1.hasAllValues)(ids)) {
                 throw new id_generation_exception_1.IdGenerationException(ids.length, events.length);
             }
+            const shouldCreateSnapshot = this._snapshotStore.shouldCreateSnapshot(aggregateRoot);
             const published = [];
             const storedEvents = [];
             for (const event of events) {
@@ -44,6 +46,9 @@ class AbstractEventStore {
             }
             const toStore = new stored_aggregate_root_1.StoredAggregateRoot(aggregateRoot.id, aggregateRoot.version);
             const saved = await this.save(storedEvents, toStore);
+            if (shouldCreateSnapshot) {
+                await this._snapshotStore.create(aggregateRoot);
+            }
             for (const publishedEvent of published) {
                 const found = saved.find((s) => s.id === publishedEvent.eventId);
                 if ((0, es_toolkit_1.isNil)(found)) {

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

@@ -1 +1 @@
-{"version":3,"file":"abstract-event-store.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/storage/abstract-event-store.ts"],"names":[],"mappings":";;;AAAA,2CAAmC;AAInC,+EAA6E;AAE7E,mFAA8E;AAC9E,+GAAwG;AACxG,mGAA6F;AAE7F,oDAAmD;AAEnD,mEAA8D;AAC9D,iDAA6C;AAE7C;;;;GAIG;AACH,MAAsB,kBAAkB;IACpC,YAA8B,aAAiC;QAAjC,kBAAa,GAAb,aAAa,CAAoB;IAAG,CAAC;IAEnE,YAAY,CAA0B,aAAgB;QAClD,aAAa,CAAC,OAAO,GAAG,KAAK,EAAE,MAAyC,EAAE,EAAE;YACxE,MAAM,iBAAiB,GAAG,IAAA,0CAAoB,EAAC,aAAa,CAAC,WAAW,CAAC,CAAC;YAC1E,IAAI,IAAA,kBAAK,EAAC,iBAAiB,CAAC,EAAE,CAAC;gBAC3B,MAAM,IAAI,yEAAiC,CAAC,aAAa,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YAChF,CAAC;YAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtB,OAAO,EAAE,CAAC;YACd,CAAC;YAED,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC;YACzE,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,IAAI,CAAC,IAAA,yBAAY,EAAC,GAAG,CAAC,EAAE,CAAC;gBACrD,MAAM,IAAI,+CAAqB,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;YAC/D,CAAC;YACD,MAAM,SAAS,GAAwC,EAAE,CAAC;YAC1D,MAAM,YAAY,GAAuB,EAAE,CAAC;YAE5C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBACzB,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,EAAY,CAAC;gBAC/B,YAAY,CAAC,IAAI,CACb,0BAAW,CAAC,kBAAkB,CAC1B,EAAE,EACF,aAAa,CAAC,EAAE,EAChB,iBAAiB,EACjB,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,UAAU,CACnB,CACJ,CAAC;gBACF,SAAS,CAAC,IAAI,CAAC;oBACX,GAAG,KAAK;oBACR,OAAO,EAAE,EAAE;oBACX,OAAO,EAAE,aAAa,CAAC,OAAO;iBACjC,CAAC,CAAC;YACP,CAAC;YAED,MAAM,OAAO,GAAG,IAAI,2CAAmB,CAAC,aAAa,CAAC,EAAE,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;YACjF,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACrD,KAAK,MAAM,cAAc,IAAI,SAAS,EAAE,CAAC;gBACrC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,cAAc,CAAC,OAAO,CAAC,CAAC;gBACjE,IAAI,IAAA,kBAAK,EAAC,KAAK,CAAC,EAAE,CAAC;oBACf,MAAM,IAAI,8DAA4B,CAAC,cAAc,CAAC,OAAO,EAAE,cAAc,CAAC,eAAe,CAAC,CAAC;gBACnG,CAAC;gBAED,cAAc,CAAC,OAAO,GAAG,KAAK,CAAC,oBAAoB,CAAC;YACxD,CAAC;YAED,aAAa,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;YACpC,MAAM,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;YACjD,OAAO,KAAK,CAAC;QACjB,CAAC,CAAC;QACF,OAAO,aAAa,CAAC;IACzB,CAAC;CAiBJ;AAxED,gDAwEC"}
+{"version":3,"file":"abstract-event-store.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/storage/abstract-event-store.ts"],"names":[],"mappings":"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"}

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

@@ -1,9 +1,19 @@
 import { AggregateRoot } from "../aggregate-root/aggregate-root";
+import { SnapshotAware } from "../aggregate-root/snapshot-aware";
 import { StoredAggregateRoot } from "./stored-aggregate-root";
 import { StoredEvent } from "./stored-event";
 export type AggregateRootClass<T> = Function & {
     prototype: T;
 };
+export type AggregateRootSnapshot<T extends AggregateRoot = AggregateRoot> = T extends SnapshotAware<infer Snapshot> ? Snapshot : unknown;
+/**
+ * Branded type to confirm that AggregateRoot instance correctly implements the SnapshotAware and AggregateRootClass has snapshotRevision attached.
+ * Should be created with caution @see {assertAggregateRootSnapshotAware}
+ */
+export type SnapshotAwareAggregateRoot<T extends AggregateRoot = AggregateRoot> = SnapshotAware<unknown> & T & {
+    readonly __snapshotAwareAggregateRootSymbol: unique symbol;
+    constructor: AggregateRootClass<SnapshotAwareAggregateRoot<T>>;
+};
 /**
  * A unique symbol that can be used to inject the event store into other classes.
  */
@@ -44,6 +54,25 @@ export interface EventStore {
      * @returns A map where the key is the aggregate root id and the value is an array of events that are associated with that id
      */
     findByAggregateRootIds<T extends AggregateRoot>(aggregateRootClass: AggregateRootClass<T>, ids: string[]): Promise<Record<string, Array<StoredEvent>>>;
+    /**
+     * Finds a snapshot and all events that occurred after that snapshot for the specified aggregate root.
+     * This method retrieves the most recent stored snapshot (obtained from the aggregate's `.toSnapshot()` method)
+     * and returns it along with all events that were stored after the snapshot was written to the database.
+     *
+     * @param aggregateRootClass The snapshot-aware aggregate root class.
+     * @param id The unique id of the aggregate root object
+     * @returns An object containing:
+     *   - `snapshot` (optional): the snapshot of the aggregate, if found
+     *   - `events`: an array of events that occurred after the snapshot;
+     *       if `snapshot` is undefined, this array contains **all events associated with the aggregate root**
+     * @throws {SnapshotRevisionMismatchException} If the current snapshotRevision does not match the snapshot revision in the stored snapshot record
+     * @throws {AggregateClassNotSnapshotAwareException} If the aggregate root class is missing the snapshot revision configuration
+     * @throws {MissingAggregateRootNameException} If the aggregate root name is missing
+     */
+    findWithSnapshot<T extends AggregateRoot>(aggregateRootClass: AggregateRootClass<T>, id: string): Promise<{
+        events: Array<StoredEvent>;
+        snapshot?: AggregateRootSnapshot<T>;
+    }>;
     /**
      * Each storage solution has its own way of dealing with unique ids. This method's implementation should reflect
      * the way the storage solution generates unique ids. For example, in a MongoDB database this would usually return

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

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

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

@@ -0,0 +1,14 @@
+import { AggregateRoot } from "../../aggregate-root/aggregate-root";
+import { SnapshotStrategy } from "../../snapshot-strategy/snapshot-strategy";
+import { SnapshotAwareAggregateRoot } from "../event-store";
+import { SnapshotStore } from "./snapshot-store";
+import { StoredSnapshot } from "./stored-snapshot";
+export declare abstract class AbstractSnapshotStore implements SnapshotStore {
+    private readonly snapshotStrategy;
+    constructor(snapshotStrategy: SnapshotStrategy);
+    create(aggregateRoot: SnapshotAwareAggregateRoot): Promise<StoredSnapshot | undefined>;
+    abstract findLatestSnapshotByAggregateId(id: string): Promise<StoredSnapshot | undefined>;
+    abstract generateEntityId(): Promise<string>;
+    abstract save(snapshot: StoredSnapshot): Promise<StoredSnapshot | undefined>;
+    shouldCreateSnapshot(aggregateRoot: AggregateRoot): aggregateRoot is SnapshotAwareAggregateRoot;
+}

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

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractSnapshotStore = void 0;
+const aggregate_root_config_1 = require("../../aggregate-root/aggregate-root-config");
+const snapshot_aware_1 = require("../../aggregate-root/snapshot-aware");
+const stored_snapshot_1 = require("./stored-snapshot");
+class AbstractSnapshotStore {
+    constructor(snapshotStrategy) {
+        this.snapshotStrategy = snapshotStrategy;
+    }
+    async create(aggregateRoot) {
+        const snapshotRevision = (0, aggregate_root_config_1.getAggregateRootSnapshotRevision)(aggregateRoot.constructor);
+        const snapshot = stored_snapshot_1.StoredSnapshot.create(await this.generateEntityId(), aggregateRoot.version, snapshotRevision, await aggregateRoot.toSnapshot(), aggregateRoot.id);
+        const saved = await this.save(snapshot);
+        return saved;
+    }
+    shouldCreateSnapshot(aggregateRoot) {
+        if (!this.snapshotStrategy.shouldCreateSnapshot(aggregateRoot)) {
+            return false;
+        }
+        (0, snapshot_aware_1.assertIsSnapshotAwareAggregateRoot)(aggregateRoot);
+        return true;
+    }
+}
+exports.AbstractSnapshotStore = AbstractSnapshotStore;
+//# sourceMappingURL=abstract-snapshot-store.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"abstract-snapshot-store.js","sourceRoot":"","sources":["../../../../../../../libs/core/src/lib/storage/snapshot/abstract-snapshot-store.ts"],"names":[],"mappings":";;;AACA,sFAA8F;AAC9F,wEAAyF;AAIzF,uDAAmD;AAEnD,MAAsB,qBAAqB;IACvC,YAA6B,gBAAkC;QAAlC,qBAAgB,GAAhB,gBAAgB,CAAkB;IAAG,CAAC;IAEnE,KAAK,CAAC,MAAM,CAAC,aAAyC;QAClD,MAAM,gBAAgB,GAAG,IAAA,wDAAgC,EAAC,aAAa,CAAC,WAAW,CAAC,CAAC;QAErF,MAAM,QAAQ,GAAG,gCAAc,CAAC,MAAM,CAClC,MAAM,IAAI,CAAC,gBAAgB,EAAE,EAC7B,aAAa,CAAC,OAAO,EACrB,gBAAgB,EAChB,MAAM,aAAa,CAAC,UAAU,EAAE,EAChC,aAAa,CAAC,EAAE,CACnB,CAAC;QAEF,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAExC,OAAO,KAAK,CAAC;IACjB,CAAC;IAOD,oBAAoB,CAAC,aAA4B;QAC7C,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,oBAAoB,CAAC,aAAa,CAAC,EAAE,CAAC;YAC7D,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,IAAA,mDAAkC,EAAC,aAAa,CAAC,CAAC;QAElD,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ;AAjCD,sDAiCC"}

package/src/lib/storage/snapshot/no-op-snapshot-store.d.ts

@@ -0,0 +1,11 @@
+import { AbstractSnapshotStore } from "./abstract-snapshot-store";
+/**
+ * This is a no-operation implementation of the snapshot store. It effectively disables snapshot functionality
+ * by providing methods that do not perform any actions or return any meaningful data.
+ */
+export declare class NoOpSnapshotStore extends AbstractSnapshotStore {
+    constructor();
+    findLatestSnapshotByAggregateId(): Promise<undefined>;
+    generateEntityId(): Promise<string>;
+    save(): Promise<undefined>;
+}

package/src/lib/storage/snapshot/no-op-snapshot-store.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NoOpSnapshotStore = void 0;
+const no_snapshot_strategy_1 = require("../../snapshot-strategy/no-snapshot-strategy");
+const abstract_snapshot_store_1 = require("./abstract-snapshot-store");
+/**
+ * This is a no-operation implementation of the snapshot store. It effectively disables snapshot functionality
+ * by providing methods that do not perform any actions or return any meaningful data.
+ */
+class NoOpSnapshotStore extends abstract_snapshot_store_1.AbstractSnapshotStore {
+    constructor() {
+        super(new no_snapshot_strategy_1.NoSnapshotStrategy());
+    }
+    findLatestSnapshotByAggregateId() {
+        return Promise.resolve(void 0);
+    }
+    generateEntityId() {
+        return Promise.resolve("");
+    }
+    save() {
+        return Promise.resolve(void 0);
+    }
+}
+exports.NoOpSnapshotStore = NoOpSnapshotStore;
+//# sourceMappingURL=no-op-snapshot-store.js.map

package/src/lib/storage/snapshot/no-op-snapshot-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-op-snapshot-store.js","sourceRoot":"","sources":["../../../../../../../libs/core/src/lib/storage/snapshot/no-op-snapshot-store.ts"],"names":[],"mappings":";;;AAAA,uFAAkF;AAClF,uEAAkE;AAElE;;;GAGG;AACH,MAAa,iBAAkB,SAAQ,+CAAqB;IACxD;QACI,KAAK,CAAC,IAAI,yCAAkB,EAAE,CAAC,CAAC;IACpC,CAAC;IAEQ,+BAA+B;QACpC,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IACnC,CAAC;IAEQ,gBAAgB;QACrB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IAEQ,IAAI;QACT,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IACnC,CAAC;CACJ;AAhBD,8CAgBC"}

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

@@ -0,0 +1,38 @@
+import { AggregateRoot } from "../../aggregate-root/aggregate-root";
+import { SnapshotAwareAggregateRoot } from "../event-store";
+import { StoredSnapshot } from "./stored-snapshot";
+export declare const SNAPSHOT_STORE: unique symbol;
+export interface SnapshotStore {
+    /**
+     * Creates a snapshot for the given aggregate root
+     * Accepts a SnapshotAwareAggregateRoot, meaning the snapshot-awareness check should already be done.
+     * @param aggregateRoot The aggregate root instance to create a snapshot for
+     * @returns Promise that resolves to the saved snapshot, or undefined if the save operation did not complete
+     */
+    create(aggregateRoot: SnapshotAwareAggregateRoot): Promise<StoredSnapshot | undefined>;
+    /**
+     * Finds the most recent snapshot for a given aggregate root by its ID.
+     * @param id The unique identifier of the aggregate root
+     * @returns Promise that resolves to the latest stored snapshot, or undefined if no snapshot exists
+     */
+    findLatestSnapshotByAggregateId(id: string): Promise<StoredSnapshot | undefined>;
+    /**
+     * Each storage solution has its own way of dealing with unique ids. This method's implementation should reflect
+     * the way the storage solution generates unique ids. For example, in a MongoDB database this would usually return
+     * a String representation of a MongoDB ObjectId.
+     */
+    generateEntityId(): Promise<string>;
+    /**
+     * Saves a snapshot to the storage
+     * @param snapshot The snapshot to be saved
+     * @returns Promise that resolves to the saved snapshot, or undefined if the save operation did not complete
+     */
+    save(snapshot: StoredSnapshot): Promise<StoredSnapshot | undefined>;
+    /**
+     * Asserts the snapshot should be created for an aggregate.
+     * The result assersion is used for .create() method of SnapshotStore
+     * @throws If the strategy matches, but the aggregate is not snapshot aware, an error will be thrown.
+     * @param aggregate The aggregate root instance to potentially create a snapshot for
+     */
+    shouldCreateSnapshot(aggregate: AggregateRoot): aggregate is SnapshotAwareAggregateRoot;
+}

package/src/lib/storage/snapshot/snapshot-store.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SNAPSHOT_STORE = void 0;
+exports.SNAPSHOT_STORE = Symbol("EVENT_NEST_SNAPSHOT_STORE");
+//# sourceMappingURL=snapshot-store.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-store.js","sourceRoot":"","sources":["../../../../../../../libs/core/src/lib/storage/snapshot/snapshot-store.ts"],"names":[],"mappings":";;;AAIa,QAAA,cAAc,GAAG,MAAM,CAAC,2BAA2B,CAAC,CAAC"}

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

@@ -0,0 +1,17 @@
+/**
+ * Represents a snapshot of an aggregate root's state at a specific point in time.
+ */
+export declare class StoredSnapshot<T = unknown> {
+    private _aggregateRootId;
+    private _aggregateRootVersion;
+    private readonly _id;
+    private _payload;
+    private _revision;
+    private constructor();
+    static create<T>(id: string, aggregateRootVersion: number, revision: number, payload: T, aggregateRootId: string): StoredSnapshot<T>;
+    get aggregateRootId(): string;
+    get aggregateRootVersion(): number;
+    get id(): string;
+    get payload(): T;
+    get revision(): number;
+}

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

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StoredSnapshot = void 0;
+/**
+ * Represents a snapshot of an aggregate root's state at a specific point in time.
+ */
+class StoredSnapshot {
+    constructor(id) {
+        this._id = id;
+    }
+    static create(id, aggregateRootVersion, revision, payload, aggregateRootId) {
+        const snapshot = new StoredSnapshot(id);
+        snapshot._aggregateRootVersion = aggregateRootVersion;
+        snapshot._payload = payload;
+        snapshot._revision = revision;
+        snapshot._aggregateRootId = aggregateRootId;
+        return snapshot;
+    }
+    get aggregateRootId() {
+        return this._aggregateRootId;
+    }
+    get aggregateRootVersion() {
+        return this._aggregateRootVersion;
+    }
+    get id() {
+        return this._id;
+    }
+    get payload() {
+        return this._payload;
+    }
+    get revision() {
+        return this._revision;
+    }
+}
+exports.StoredSnapshot = StoredSnapshot;
+//# sourceMappingURL=stored-snapshot.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stored-snapshot.js","sourceRoot":"","sources":["../../../../../../../libs/core/src/lib/storage/snapshot/stored-snapshot.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,MAAa,cAAc;IAOvB,YAAoB,EAAU;QAC1B,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;IAClB,CAAC;IAED,MAAM,CAAC,MAAM,CACT,EAAU,EACV,oBAA4B,EAC5B,QAAgB,EAChB,OAAU,EACV,eAAuB;QAEvB,MAAM,QAAQ,GAAsB,IAAI,cAAc,CAAC,EAAE,CAAC,CAAC;QAC3D,QAAQ,CAAC,qBAAqB,GAAG,oBAAoB,CAAC;QACtD,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC;QAC5B,QAAQ,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC9B,QAAQ,CAAC,gBAAgB,GAAG,eAAe,CAAC;QAE5C,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED,IAAI,eAAe;QACf,OAAO,IAAI,CAAC,gBAAgB,CAAC;IACjC,CAAC;IAED,IAAI,oBAAoB;QACpB,OAAO,IAAI,CAAC,qBAAqB,CAAC;IACtC,CAAC;IAED,IAAI,EAAE;QACF,OAAO,IAAI,CAAC,GAAG,CAAC;IACpB,CAAC;IAED,IAAI,OAAO;QACP,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED,IAAI,QAAQ;QACR,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;CACJ;AA9CD,wCA8CC"}

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

@@ -1,4 +1,4 @@
-import { Class } from "type-fest";
+import { Class } from "../utils/type-utils";
 /**
  * Represents an event that will be persisted according to the storage solution that is used.
  * The event is defined by metadata like aggregate root id, version and creation date, and it also includes its payload

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

@@ -1 +1 @@
-{"version":3,"file":"stored-event.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/storage/stored-event.ts"],"names":[],"mappings":";;;AAAA,yDAAkE;AAClE,2CAAmC;AAGnC,8EAA6D;AAE7D;;;;;;;;;GASG;AACH,MAAa,WAAW;IAUpB,YAAoB,EAAU,EAAE,eAAuB;QACnD,IAAI,CAAC,gBAAgB,GAAG,eAAe,CAAC;QACxC,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;IAClB,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,kBAAkB,CACrB,EAAU,EACV,eAAuB,EACvB,iBAAyB,EACzB,OAAe,EACf,UAAgB;QAEhB,MAAM,QAAQ,GAAG,IAAI,WAAW,CAAC,EAAE,EAAE,eAAe,CAAC,CAAC;QACtD,QAAQ,CAAC,UAAU,GAAG,UAAU,CAAC;QACjC,QAAQ,CAAC,kBAAkB,GAAG,iBAAiB,CAAC;QAEhD,MAAM,SAAS,GAAG,IAAA,yCAAY,EAAC,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,IAAA,kBAAK,EAAC,SAAS,CAAC,EAAE,CAAC;YACpB,QAAQ,CAAC,QAAQ,GAAG,IAAA,mCAAe,EAAC,OAAO,CAAC,CAAC;YAC7C,QAAQ,CAAC,UAAU,GAAG,SAAS,CAAC;QACpC,CAAC;QACD,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,WAAW,CACd,EAAU,EACV,eAAuB,EACvB,SAAiB,EACjB,SAAe,EACf,oBAA4B,EAC5B,iBAAyB,EACzB,OAAgB;QAEhB,MAAM,QAAQ,GAAG,IAAI,WAAW,CAAC,EAAE,EAAE,eAAe,CAAC,CAAC;QACtD,QAAQ,CAAC,UAAU,GAAG,SAAS,CAAC;QAChC,QAAQ,CAAC,UAAU,GAAG,SAAS,CAAC;QAChC,QAAQ,CAAC,oBAAoB,GAAG,oBAAoB,CAAC;QACrD,QAAQ,CAAC,kBAAkB,GAAG,iBAAiB,CAAC;QAChD,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC;QAC5B,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED,IAAI,eAAe;QACf,OAAO,IAAI,CAAC,gBAAgB,CAAC;IACjC,CAAC;IAED,IAAI,iBAAiB;QACjB,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACnC,CAAC;IAED,IAAI,SAAS;QACT,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IAED,IAAI,SAAS;QACT,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IAED,IAAI,EAAE;QACF,OAAO,IAAI,CAAC,GAAG,CAAC;IACpB,CAAC;IAED,IAAI,OAAO;QACP,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAEM,YAAY,CAAI,YAAsB;QACzC,OAAO,IAAA,gCAAY,EAAC,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrD,CAAC;CACJ;AAvGD,kCAuGC"}
+{"version":3,"file":"stored-event.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/storage/stored-event.ts"],"names":[],"mappings":";;;AAAA,yDAAkE;AAClE,2CAAmC;AAEnC,8EAA6D;AAG7D;;;;;;;;;GASG;AACH,MAAa,WAAW;IAUpB,YAAoB,EAAU,EAAE,eAAuB;QACnD,IAAI,CAAC,gBAAgB,GAAG,eAAe,CAAC;QACxC,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;IAClB,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,kBAAkB,CACrB,EAAU,EACV,eAAuB,EACvB,iBAAyB,EACzB,OAAe,EACf,UAAgB;QAEhB,MAAM,QAAQ,GAAG,IAAI,WAAW,CAAC,EAAE,EAAE,eAAe,CAAC,CAAC;QACtD,QAAQ,CAAC,UAAU,GAAG,UAAU,CAAC;QACjC,QAAQ,CAAC,kBAAkB,GAAG,iBAAiB,CAAC;QAEhD,MAAM,SAAS,GAAG,IAAA,yCAAY,EAAC,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,IAAA,kBAAK,EAAC,SAAS,CAAC,EAAE,CAAC;YACpB,QAAQ,CAAC,QAAQ,GAAG,IAAA,mCAAe,EAAC,OAAO,CAAC,CAAC;YAC7C,QAAQ,CAAC,UAAU,GAAG,SAAS,CAAC;QACpC,CAAC;QACD,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,WAAW,CACd,EAAU,EACV,eAAuB,EACvB,SAAiB,EACjB,SAAe,EACf,oBAA4B,EAC5B,iBAAyB,EACzB,OAAgB;QAEhB,MAAM,QAAQ,GAAG,IAAI,WAAW,CAAC,EAAE,EAAE,eAAe,CAAC,CAAC;QACtD,QAAQ,CAAC,UAAU,GAAG,SAAS,CAAC;QAChC,QAAQ,CAAC,UAAU,GAAG,SAAS,CAAC;QAChC,QAAQ,CAAC,oBAAoB,GAAG,oBAAoB,CAAC;QACrD,QAAQ,CAAC,kBAAkB,GAAG,iBAAiB,CAAC;QAChD,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC;QAC5B,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED,IAAI,eAAe;QACf,OAAO,IAAI,CAAC,gBAAgB,CAAC;IACjC,CAAC;IAED,IAAI,iBAAiB;QACjB,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACnC,CAAC;IAED,IAAI,SAAS;QACT,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IAED,IAAI,SAAS;QACT,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IAED,IAAI,EAAE;QACF,OAAO,IAAI,CAAC,GAAG,CAAC;IACpB,CAAC;IAED,IAAI,OAAO;QACP,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAEM,YAAY,CAAI,YAAsB;QACzC,OAAO,IAAA,gCAAY,EAAC,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrD,CAAC;CACJ;AAvGD,kCAuGC"}

package/src/lib/utils/type-utils.d.ts

@@ -1 +1,5 @@
+export type Class<T, Arguments extends unknown[] = any[]> = {
+    prototype: Pick<T, keyof T>;
+    new (...arguments_: Arguments): T;
+};
 export declare function hasAllValues<T>(toCheck: Array<null | T | undefined>): toCheck is Array<T>;

package/src/lib/utils/type-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"type-utils.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/utils/type-utils.ts"],"names":[],"mappings":";;AAEA,oCAEC;AAJD,2CAAmC;AAEnC,SAAgB,YAAY,CAAI,OAAoC;IAChE,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAA,kBAAK,EAAC,IAAI,CAAC,CAAC,CAAC;AACjD,CAAC"}
+{"version":3,"file":"type-utils.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/utils/type-utils.ts"],"names":[],"mappings":";;AAQA,oCAEC;AAVD,2CAAmC;AAQnC,SAAgB,YAAY,CAAI,OAAoC;IAChE,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAA,kBAAK,EAAC,IAAI,CAAC,CAAC,CAAC;AACjD,CAAC"}