@event-nest/core 4.0.1 → 5.0.0

package/README.md

@@ -25,6 +25,11 @@ What Event Nest is Not:
 - [Concepts](#concepts)
     - [Event](#event)
     - [Aggregate Root](#aggregate-root)
+    - [Snapshots](#snapshots)
+        - [Making an aggregate root snapshot-aware](#making-an-aggregate-root-snapshot-aware)
+        - [Snapshot strategies](#snapshot-strategies)
+        - [Loading an aggregate root with a snapshot](#loading-an-aggregate-root-with-a-snapshot)
+        - [Snapshot revision](#snapshot-revision)
     - [Domain Event Subscription](#domain-event-subscription)
         - [Order of execution in subscriptions](#order-of-execution-in-subscriptions)
         - [Waiting for subscriptions to complete](#waiting-for-subscriptions-to-complete)
@@ -71,6 +76,26 @@ export class AppModule {}
 ```
 The collections specified in the configuration will store the aggregates and events.
 
+If you want to enable [snapshots](#snapshots), you will also need to provide a `snapshotCollection` and a `snapshotStrategy` :
+```typescript
+import { ForCountSnapshotStrategy } from "@event-nest/core";
+import { EventNestMongoDbModule } from "@event-nest/mongodb";
+import { Module } from "@nestjs/common";
+
+@Module({
+    imports: [
+        EventNestMongoDbModule.forRoot({
+            connectionUri: "mongodb://localhost:27017/example",
+            aggregatesCollection: "aggregates-collection",
+            eventsCollection: "events-collection",
+            snapshotCollection: "snapshots-collection",
+            snapshotStrategy: new ForCountSnapshotStrategy({ count: 10 })
+        }),
+    ],
+})
+export class AppModule {}
+```
+
 
 ### PostgreSQL setup
 
@@ -99,6 +124,28 @@ export class AppModule {}
 
 If the database user has privileges to create tables, set the `ensureTablesExist` option to true to automatically create the necessary tables during bootstrap. Otherwise, refer to the manual table creation instructions below.
 
+If you want to enable [snapshots](#snapshots), you will also need to provide a `snapshotTableName` and a `snapshotStrategy` :
+```typescript
+import { ForCountSnapshotStrategy } from "@event-nest/core";
+import { EventNestPostgreSQLModule } from "@event-nest/postgresql";
+import { Module } from "@nestjs/common";
+
+@Module({
+    imports: [
+        EventNestPostgreSQLModule.forRoot({
+            aggregatesTableName: "aggregates",
+            connectionUri: "postgresql://postgres:password@localhost:5432/event_nest",
+            eventsTableName: "events",
+            schemaName: "event_nest_schema",
+            ensureTablesExist: true,
+            snapshotTableName: "snapshots",
+            snapshotStrategy: new ForCountSnapshotStrategy({ count: 10 })
+        })
+    ]
+})
+export class AppModule {}
+```
+
 
 #### Manual creation of PostgreSQL tables
 If you prefer to create the tables manually, the following guidelines describe the structure of the tables that need to be created.
@@ -122,6 +169,16 @@ If you prefer to create the tables manually, the following guidelines describe t
 | payload                | jsonb                    | A JSON representation of the event's additional data.                                                                         |
 | created_at             | timestamp with time zone | The timestamp when the event was produced. <br/>Must be set as NOT NULL                                                       |
 
+**Snapshots Table (optional) :**
+
+| Column Name            | Type    | Description                                                                                                                    |
+|------------------------|---------|--------------------------------------------------------------------------------------------------------------------------------|
+| id                     | uuid    | The unique identifier of the snapshot. <br/>Must be set as NOT NULL and it is the table's primary key                          |
+| aggregate_root_id      | uuid    | The id of the aggregate that the snapshot belongs to.<br/> Must be set as NOT NULL and it is a foreign key to the aggregates table |
+| aggregate_root_version | integer | The version of the aggregate root when the snapshot was created. <br/>Must be set as NOT NULL                                  |
+| payload                | jsonb   | A JSON representation of the snapshot data. <br/>Must be set as NOT NULL                                                       |
+| revision               | integer | The snapshot revision number. <br/>Must be set as NOT NULL                                                                     |
+
 
 ## Concepts
 ### Event
@@ -180,9 +237,11 @@ export class UserUpdatedEvent {
 
 Next, we will define the aggregate root for the user. Let's break down what this class should do and how.
 
-First of all, the class has to extend the `AggregateRoot` class, and it has to be decorated with the `@AggregateRootName` decorator.
+First of all, the class has to extend the `AggregateRoot` class, and it has to be decorated with the `@AggregateRootConfig` decorator.
 The name is required to associate persisted events with the correct aggregate root when retrieving them from storage.
 
+> **Note:** The `@AggregateRootName` decorator is deprecated and will be removed in version 7.x. Use `@AggregateRootConfig` instead.
+
 Now let's talk about constructors. TypeScript doesn't allow us to define multiple constructors. Therefore, if we have two ways of creating an object, we could use static methods as factories.
 In our case, we have the following creation cases :
 * The user is new, and we need to create it from scratch. In that case, we create a new `UserCreatedEvent` event, and we `append` it to the aggregate root's event stream.
@@ -198,9 +257,9 @@ It's important to note that the append method will not save the event. All the a
 
 
 ```typescript
-import { AggregateRoot, AggregateRootName, ApplyEvent, StoredEvent } from "@event-nest/core";
+import { AggregateRoot, AggregateRootConfig, ApplyEvent, StoredEvent } from "@event-nest/core";
 
-@AggregateRootName("User")
+@AggregateRootConfig({ name: "User" })
 export class User extends AggregateRoot {
     private name: string;
     private email: string;
@@ -276,6 +335,192 @@ export class UserService {
 }
 ```
 
+### Snapshots
+As the number of events for an aggregate root grows, replaying the full event stream to reconstruct its state can become increasingly slow. Snapshots address this by periodically capturing the aggregate's state, so that reconstitution can start from a recent snapshot instead of replaying every event from the beginning.
+
+Snapshots are entirely optional. When enabled, the library will automatically create snapshots based on a configurable strategy and use them during reconstitution. The complete event history is always preserved in storage regardless of whether snapshots are used.
+
+To use snapshots, you need to :
+* Configure a snapshot strategy and a snapshot storage location in your module setup (see [MongoDB setup](#mongodb-setup) or [PostgreSQL setup](#postgresql-setup))
+* Have your aggregate root classes implement the `SnapshotAware` interface
+
+#### Making an aggregate root snapshot-aware
+
+An aggregate root needs two things to support snapshots :
+
+1. The `@AggregateRootConfig` decorator must include a `snapshotRevision` number.
+2. The class must implement the `SnapshotAware` interface, which requires two methods: `toSnapshot()` and `applySnapshot()`.
+
+Let's extend the `User` example from above to support snapshots :
+
+```typescript
+import { AggregateRoot, AggregateRootConfig, ApplyEvent, SnapshotAware, StoredEvent } from "@event-nest/core";
+
+interface UserSnapshot {
+    name: string;
+    email: string;
+}
+
+@AggregateRootConfig({ name: "User", snapshotRevision: 1 })
+export class User extends AggregateRoot implements SnapshotAware<UserSnapshot> {
+    private name: string;
+    private email: string;
+
+    private constructor(id: string) {
+        super(id);
+    }
+
+    public static createNew(id: string, name: string, email: string): User {
+        const user = new User(id);
+        const event = new UserCreatedEvent(name, email);
+        user.applyUserCreatedEvent(event);
+        user.append(event);
+        return user;
+    }
+
+    public static fromEvents(id: string, events: Array<StoredEvent>, snapshot?: UserSnapshot): User {
+        const user = new User(id);
+        user.reconstitute(events, snapshot);
+        return user;
+    }
+
+    toSnapshot(): UserSnapshot {
+        return { name: this.name, email: this.email };
+    }
+
+    applySnapshot(snapshot: UserSnapshot) {
+        this.name = snapshot.name;
+        this.email = snapshot.email;
+    }
+
+    public update(newName: string) {
+        const event = new UserUpdatedEvent(newName);
+        this.applyUserUpdatedEvent(event);
+        this.append(event);
+    }
+
+    @ApplyEvent(UserCreatedEvent)
+    private applyUserCreatedEvent(event: UserCreatedEvent) {
+        this.name = event.name;
+        this.email = event.email;
+    }
+
+    @ApplyEvent(UserUpdatedEvent)
+    private applyUserUpdatedEvent(event: UserUpdatedEvent) {
+        this.name = event.newName;
+    }
+}
+```
+
+The `toSnapshot()` method returns a plain representation of the aggregate's current state. The `applySnapshot()` method restores that state when a snapshot is loaded from storage. The `reconstitute` method accepts an optional snapshot parameter. When a snapshot is provided, it will be applied first, and then any remaining events will be replayed on top of it.
+
+Note that when calling `commit`, the library will automatically evaluate the configured snapshot strategy to determine whether a new snapshot should be created. If the strategy says yes, it will call `toSnapshot()` and persist the result. You don't need to manage snapshot creation manually.
+
+
+#### Snapshot strategies
+
+Snapshot strategies determine when the library should create a snapshot for an aggregate root. You configure the strategy once in your module setup, and it applies globally. Several built-in strategies are available, and they can be composed to build more complex rules.
+
+**ForCountSnapshotStrategy**
+
+Creates a snapshot when the aggregate root crosses a version threshold. For example, with a count of 10, a snapshot will be created when the version goes from 9 to 10, from 19 to 20, and so on.
+
+```typescript
+import { ForCountSnapshotStrategy } from "@event-nest/core";
+
+new ForCountSnapshotStrategy({ count: 10 })
+```
+
+**ForEventsSnapshotStrategy**
+
+Creates a snapshot when specific event types are present in the uncommitted events. This is useful when certain events represent significant state changes that are worth snapshotting.
+
+```typescript
+import { ForEventsSnapshotStrategy } from "@event-nest/core";
+
+new ForEventsSnapshotStrategy({ eventClasses: [UserCreatedEvent, UserUpdatedEvent] })
+```
+
+**ForAggregateRootsStrategy**
+
+Creates snapshots only for specific aggregate root classes. This is useful when only some of your aggregates have enough events to benefit from snapshots.
+
+```typescript
+import { ForAggregateRootsStrategy } from "@event-nest/core";
+
+new ForAggregateRootsStrategy({ aggregates: [User, Order] })
+```
+
+**AllOfSnapshotStrategy**
+
+A composite strategy that creates a snapshot only when **all** of the provided strategies agree. This acts as a logical AND.
+
+```typescript
+import { AllOfSnapshotStrategy, ForAggregateRootsStrategy, ForCountSnapshotStrategy } from "@event-nest/core";
+
+new AllOfSnapshotStrategy([
+    new ForAggregateRootsStrategy({ aggregates: [User] }),
+    new ForCountSnapshotStrategy({ count: 10 })
+])
+```
+In this example, snapshots will only be created for `User` aggregates and only when they cross a version threshold of 10.
+
+**AnyOfSnapshotStrategy**
+
+A composite strategy that creates a snapshot when **any** of the provided strategies agrees. This acts as a logical OR.
+
+```typescript
+import { AnyOfSnapshotStrategy, ForCountSnapshotStrategy, ForEventsSnapshotStrategy } from "@event-nest/core";
+
+new AnyOfSnapshotStrategy([
+    new ForCountSnapshotStrategy({ count: 10 }),
+    new ForEventsSnapshotStrategy({ eventClasses: [UserCreatedEvent] })
+])
+```
+In this example, a snapshot will be created either when the version crosses a threshold of 10 or when a `UserCreatedEvent` is committed.
+
+The composite strategies can be nested to express more complex rules. For example, you could use an `AnyOfSnapshotStrategy` that contains an `AllOfSnapshotStrategy` alongside a `ForEventsSnapshotStrategy`.
+
+
+#### Loading an aggregate root with a snapshot
+
+The `EventStore` provides a `findWithSnapshot` method that retrieves the latest snapshot for an aggregate root along with any events that occurred after that snapshot. If no snapshot is found, all events are returned.
+
+```typescript
+import { EVENT_STORE, EventStore } from "@event-nest/core";
+
+@Injectable()
+export class UserService {
+    constructor(@Inject(EVENT_STORE) private eventStore: EventStore) {}
+
+    async updateUser(id: string, newName: string) {
+        const { events, snapshot } = await this.eventStore.findWithSnapshot(User, id);
+        const user = User.fromEvents(id, events, snapshot);
+        const userWithPublisher = this.eventStore.addPublisher(user);
+        user.update(newName);
+        await userWithPublisher.commit();
+    }
+}
+```
+
+If the snapshot cannot be loaded for any reason (for example, a revision mismatch), you can fall back to loading all events with `findByAggregateRootId` as shown in the [Aggregate Root](#aggregate-root) example.
+
+
+#### Snapshot revision
+
+The `snapshotRevision` number in `@AggregateRootConfig` is a compatibility version for the snapshot format. When loading a snapshot from storage, the library compares the stored revision with the one defined on the class. If they don't match, a `SnapshotRevisionMismatchException` is thrown.
+
+This mechanism exists to protect against applying outdated snapshots when the structure of your snapshot changes. For example, if you add a new field to a `User` aggregate and update `toSnapshot()` to include it, the old snapshots in the database no longer match the new format. By incrementing the `snapshotRevision`, the library will reject old snapshots and the aggregate will be reconstituted from the full event stream instead. New snapshots created from that point on will use the updated format and revision number.
+
+```typescript
+// Before: snapshot only includes name and email
+@AggregateRootConfig({ name: "User", snapshotRevision: 1 })
+
+// After: snapshot now includes name, email, and role
+@AggregateRootConfig({ name: "User", snapshotRevision: 2 })
+```
+
+
 ### Domain Event Subscription
 When working with event sourcing, you will often need to update other parts of your system after an event has been persisted. For example, you may have a read model for users that needs to be updated when a user is created or updated. Or, perhaps you need to send an email notification when a specific event occurs.
 
@@ -338,7 +583,7 @@ The `DomainEventSubscription` decorator supports an alternative syntax for those
 When your subscription is defined like this, the `commit` method will not return until the `onDomainEvent` method is completed for all the events that the service is subscribed to.
 
 If your subscription throws an exception, the exception will be wrapped in a `SubscriptionException` which will be thrown by the `commit` method.
-It's important to note that when the `commit` method throws such an exception, it doesn't mean that the events were not saved to the storage. Since the subscriptions run after the events are saved, an exception from a subscription doesn't roll back the events.
+> **Note:** When the `commit` method throws such a `SubscriptionException`, it doesn't mean that the events were not saved to the storage. Since the subscriptions run after the events are saved, an exception from a subscription doesn't roll back the events.
 
 
 ## License

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@event-nest/core",
-  "version": "4.0.1",
+  "version": "5.0.0",
   "license": "MIT",
   "author": "Nick Tsitlakidis",
   "description": "Event sourcing module for NestJS. It provides a set of decorators and classes to build an application based on event sourcing.",
@@ -22,7 +22,7 @@
   },
   "type": "commonjs",
   "peerDependencies": {
-    "@nestjs/common": "^^10.0.0 || ^11.0.0",
+    "@nestjs/common": "^10.0.0 || ^11.0.0",
     "@nestjs/core": "^10.0.0 || ^11.0.0",
     "reflect-metadata": "^0.1.12 || ^0.2.0",
     "rxjs": "^7.2.0",
@@ -32,6 +32,7 @@
     "class-transformer": "^0.5.1",
     "es-toolkit": "^1.32.0"
   },
+  "packageManager": "pnpm@10.29.2",
   "types": "./src/index.d.ts",
   "main": "./src/index.js"
 }

package/src/index.d.ts

@@ -1,19 +1,35 @@
 export * from "./lib/aggregate-root/aggregate-root";
+export * from "./lib/aggregate-root/aggregate-root-config";
 export * from "./lib/aggregate-root/aggregate-root-name";
 export * from "./lib/aggregate-root/apply-event.decorator";
+export * from "./lib/aggregate-root/snapshot-aware";
 export * from "./lib/core-module-options";
 export * from "./lib/domain-event";
 export * from "./lib/domain-event-emitter";
 export * from "./lib/domain-event-subscription";
+export * from "./lib/exceptions/aggregate-class-not-snapshot-aware-exception";
+export * from "./lib/exceptions/aggregate-instance-not-snapshot-aware-exception";
 export * from "./lib/exceptions/event-concurrency-exception";
 export * from "./lib/exceptions/event-name-conflict-exception";
 export * from "./lib/exceptions/missing-aggregate-root-name-exception";
+export * from "./lib/exceptions/snapshot-revision-mismatch-exception";
 export * from "./lib/exceptions/subscription-exception";
 export * from "./lib/exceptions/unknown-event-exception";
 export * from "./lib/on-domain-event";
 export * from "./lib/published-domain-event";
+export * from "./lib/snapshot-strategy/all-of-snapshot-strategy";
+export * from "./lib/snapshot-strategy/any-of-snapshot-strategy";
+export * from "./lib/snapshot-strategy/for-aggregate-roots-strategy";
+export * from "./lib/snapshot-strategy/for-count-snapshot-strategy";
+export * from "./lib/snapshot-strategy/for-events-snapshot-strategy";
+export * from "./lib/snapshot-strategy/no-snapshot-strategy";
+export * from "./lib/snapshot-strategy/snapshot-strategy";
 export * from "./lib/storage/abstract-event-store";
 export * from "./lib/storage/event-store";
+export * from "./lib/storage/snapshot/abstract-snapshot-store";
+export * from "./lib/storage/snapshot/no-op-snapshot-store";
+export * from "./lib/storage/snapshot/snapshot-store";
+export * from "./lib/storage/snapshot/stored-snapshot";
 export * from "./lib/storage/stored-aggregate-root";
 export * from "./lib/storage/stored-event";
 export * from "./lib/utils/type-utils";

package/src/index.js

@@ -2,21 +2,37 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./lib/aggregate-root/aggregate-root"), exports);
+tslib_1.__exportStar(require("./lib/aggregate-root/aggregate-root-config"), exports);
 tslib_1.__exportStar(require("./lib/aggregate-root/aggregate-root-name"), exports);
 tslib_1.__exportStar(require("./lib/aggregate-root/apply-event.decorator"), exports);
+tslib_1.__exportStar(require("./lib/aggregate-root/snapshot-aware"), exports);
 tslib_1.__exportStar(require("./lib/core-module-options"), exports);
 tslib_1.__exportStar(require("./lib/domain-event"), exports);
 tslib_1.__exportStar(require("./lib/domain-event-emitter"), exports);
 tslib_1.__exportStar(require("./lib/domain-event-subscription"), exports);
+tslib_1.__exportStar(require("./lib/exceptions/aggregate-class-not-snapshot-aware-exception"), exports);
+tslib_1.__exportStar(require("./lib/exceptions/aggregate-instance-not-snapshot-aware-exception"), exports);
 tslib_1.__exportStar(require("./lib/exceptions/event-concurrency-exception"), exports);
 tslib_1.__exportStar(require("./lib/exceptions/event-name-conflict-exception"), exports);
 tslib_1.__exportStar(require("./lib/exceptions/missing-aggregate-root-name-exception"), exports);
+tslib_1.__exportStar(require("./lib/exceptions/snapshot-revision-mismatch-exception"), exports);
 tslib_1.__exportStar(require("./lib/exceptions/subscription-exception"), exports);
 tslib_1.__exportStar(require("./lib/exceptions/unknown-event-exception"), exports);
 tslib_1.__exportStar(require("./lib/on-domain-event"), exports);
 tslib_1.__exportStar(require("./lib/published-domain-event"), exports);
+tslib_1.__exportStar(require("./lib/snapshot-strategy/all-of-snapshot-strategy"), exports);
+tslib_1.__exportStar(require("./lib/snapshot-strategy/any-of-snapshot-strategy"), exports);
+tslib_1.__exportStar(require("./lib/snapshot-strategy/for-aggregate-roots-strategy"), exports);
+tslib_1.__exportStar(require("./lib/snapshot-strategy/for-count-snapshot-strategy"), exports);
+tslib_1.__exportStar(require("./lib/snapshot-strategy/for-events-snapshot-strategy"), exports);
+tslib_1.__exportStar(require("./lib/snapshot-strategy/no-snapshot-strategy"), exports);
+tslib_1.__exportStar(require("./lib/snapshot-strategy/snapshot-strategy"), exports);
 tslib_1.__exportStar(require("./lib/storage/abstract-event-store"), exports);
 tslib_1.__exportStar(require("./lib/storage/event-store"), exports);
+tslib_1.__exportStar(require("./lib/storage/snapshot/abstract-snapshot-store"), exports);
+tslib_1.__exportStar(require("./lib/storage/snapshot/no-op-snapshot-store"), exports);
+tslib_1.__exportStar(require("./lib/storage/snapshot/snapshot-store"), exports);
+tslib_1.__exportStar(require("./lib/storage/snapshot/stored-snapshot"), exports);
 tslib_1.__exportStar(require("./lib/storage/stored-aggregate-root"), exports);
 tslib_1.__exportStar(require("./lib/storage/stored-event"), exports);
 tslib_1.__exportStar(require("./lib/utils/type-utils"), exports);

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/core/src/index.ts"],"names":[],"mappings":";;;AAAA,8EAAoD;AACpD,mFAAyD;AACzD,qFAA2D;AAE3D,oEAA0C;AAC1C,6DAAmC;AACnC,qEAA2C;AAC3C,0EAAgD;AAEhD,uFAA6D;AAC7D,yFAA+D;AAC/D,iGAAuE;AACvE,kFAAwD;AAExD,mFAAyD;AACzD,gEAAsC;AACtC,uEAA6C;AAE7C,6EAAmD;AACnD,oEAA0C;AAC1C,8EAAoD;AACpD,qEAA2C;AAE3C,iEAAuC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/core/src/index.ts"],"names":[],"mappings":";;;AAAA,8EAAoD;AACpD,qFAA2D;AAC3D,mFAAyD;AACzD,qFAA2D;AAC3D,8EAAoD;AAEpD,oEAA0C;AAC1C,6DAAmC;AACnC,qEAA2C;AAC3C,0EAAgD;AAEhD,wGAA8E;AAC9E,2GAAiF;AACjF,uFAA6D;AAC7D,yFAA+D;AAC/D,iGAAuE;AACvE,gGAAsE;AACtE,kFAAwD;AACxD,mFAAyD;AAEzD,gEAAsC;AAEtC,uEAA6C;AAE7C,2FAAiE;AACjE,2FAAiE;AACjE,+FAAqE;AACrE,8FAAoE;AACpE,+FAAqE;AACrE,uFAA6D;AAC7D,oFAA0D;AAE1D,6EAAmD;AACnD,oEAA0C;AAC1C,yFAA+D;AAC/D,sFAA4D;AAC5D,gFAAsD;AACtD,iFAAuD;AACvD,8EAAoD;AACpD,qEAA2C;AAE3C,iEAAuC"}

package/src/lib/aggregate-root/aggregate-root-config.d.ts

@@ -0,0 +1,37 @@
+import { AggregateRootClass, SnapshotAwareAggregateRoot } from "../storage/event-store";
+export interface AggregateRootConfigParameters {
+    /**
+     * Will be saved with each event in the database and used during event retrieval to ensure
+     * the correct events are retrieved
+     */
+    name: string;
+    /**
+     * Optinal snapshot revision number that's used for snapshot optimization.
+     */
+    snapshotRevision?: number;
+}
+/**
+ * A decorator to configure an aggregate root class with a unique name and optional snapshot revision.
+ *
+ * @param params - Configuration parameters including the aggregate root name and optional snapshot revision
+ */
+export declare const AggregateRootConfig: ({ name, snapshotRevision }: AggregateRootConfigParameters) => ClassDecorator;
+/**
+ * Used to obtain the name attached to AggregateRoot class by getting it's metadata
+ * Works with both @see {@link AggregateRootConfig} and @see {@link AggregateRootName}
+ * Uses function overloading, because it's already known that SnapshotAwareAggregateRoot has name defined
+ *
+ * @param targetClass - the AggregateRoot class
+ * @returns snapshotRevision from provided {@link AggregateRootConfigParameters} or undefined if not present
+ */
+export declare function getAggregateRootName(targetClass: AggregateRootClass<SnapshotAwareAggregateRoot>): string;
+export declare function getAggregateRootName(targetClass: AggregateRootClass<unknown>): string | undefined;
+/**
+ * Used to obtain the snapshotRevision number attached to AggregateRoot class by getting it's metadata
+ * Uses function overloading, because it's already known that SnapshotAwareAggregateRoot has snasphotRevision defined
+ *
+ * @param aggregateRootClass - the AggregateRootClass
+ * @returns snapshotRevision from provided {@link AggregateRootConfigParameters} or undefined if not present
+ */
+export declare function getAggregateRootSnapshotRevision(targetClass: AggregateRootClass<SnapshotAwareAggregateRoot>): number;
+export declare function getAggregateRootSnapshotRevision(targetClass: AggregateRootClass<unknown>): number | undefined;

package/src/lib/aggregate-root/aggregate-root-config.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AggregateRootConfig = void 0;
+exports.getAggregateRootName = getAggregateRootName;
+exports.getAggregateRootSnapshotRevision = getAggregateRootSnapshotRevision;
+const metadata_keys_1 = require("../metadata-keys");
+/**
+ * A decorator to configure an aggregate root class with a unique name and optional snapshot revision.
+ *
+ * @param params - Configuration parameters including the aggregate root name and optional snapshot revision
+ */
+const AggregateRootConfig = ({ name, snapshotRevision }) => {
+    return (target) => {
+        Reflect.defineMetadata(metadata_keys_1.AGGREGATE_ROOT_NAME_KEY, { aggregateRootName: name }, target);
+        Reflect.defineMetadata(metadata_keys_1.AGGREGATE_ROOT_SNAPSHOT_REVISION_KEY, { aggregateRootSnapshotRevision: snapshotRevision }, target);
+    };
+};
+exports.AggregateRootConfig = AggregateRootConfig;
+function getAggregateRootName(targetClass) {
+    return Reflect.getMetadata(metadata_keys_1.AGGREGATE_ROOT_NAME_KEY, targetClass)?.aggregateRootName;
+}
+function getAggregateRootSnapshotRevision(targetClass) {
+    return Reflect.getMetadata(metadata_keys_1.AGGREGATE_ROOT_SNAPSHOT_REVISION_KEY, targetClass)?.aggregateRootSnapshotRevision;
+}
+//# sourceMappingURL=aggregate-root-config.js.map

package/src/lib/aggregate-root/aggregate-root-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate-root-config.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/aggregate-root/aggregate-root-config.ts"],"names":[],"mappings":";;;AAyCA,oDAEC;AAWD,4EAEC;AAxDD,oDAAiG;AAejG;;;;GAIG;AACI,MAAM,mBAAmB,GAAG,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAiC,EAAkB,EAAE;IAC7G,OAAO,CAAC,MAAc,EAAE,EAAE;QACtB,OAAO,CAAC,cAAc,CAAC,uCAAuB,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;QACrF,OAAO,CAAC,cAAc,CAClB,oDAAoC,EACpC,EAAE,6BAA6B,EAAE,gBAAgB,EAAE,EACnD,MAAM,CACT,CAAC;IACN,CAAC,CAAC;AACN,CAAC,CAAC;AATW,QAAA,mBAAmB,uBAS9B;AAYF,SAAgB,oBAAoB,CAAC,WAAwC;IACzE,OAAO,OAAO,CAAC,WAAW,CAAC,uCAAuB,EAAE,WAAW,CAAC,EAAE,iBAAiB,CAAC;AACxF,CAAC;AAWD,SAAgB,gCAAgC,CAAC,WAAwC;IACrF,OAAO,OAAO,CAAC,WAAW,CAAC,oDAAoC,EAAE,WAAW,CAAC,EAAE,6BAA6B,CAAC;AACjH,CAAC"}

package/src/lib/aggregate-root/aggregate-root-name.d.ts

@@ -5,8 +5,8 @@ import "reflect-metadata";
  *
  * It will also be used during the retrieval process of the events to make sure that
  * the correct events are retrieved.
+ * @deprecated Use {@link AggregateRootConfig} decorator instead. It will be removed in version 7.x
  * @param name The name of the aggregate root
  * @constructor
  */
 export declare const AggregateRootName: (name: string) => ClassDecorator;
-export declare function getAggregateRootName(targetClass: Function): string | undefined;

package/src/lib/aggregate-root/aggregate-root-name.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AggregateRootName = void 0;
-exports.getAggregateRootName = getAggregateRootName;
 require("reflect-metadata");
 const metadata_keys_1 = require("../metadata-keys");
 /**
@@ -10,6 +9,7 @@ const metadata_keys_1 = require("../metadata-keys");
  *
  * It will also be used during the retrieval process of the events to make sure that
  * the correct events are retrieved.
+ * @deprecated Use {@link AggregateRootConfig} decorator instead. It will be removed in version 7.x
  * @param name The name of the aggregate root
  * @constructor
  */
@@ -19,8 +19,4 @@ const AggregateRootName = (name) => {
     };
 };
 exports.AggregateRootName = AggregateRootName;
-// eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
-function getAggregateRootName(targetClass) {
-    return Reflect.getMetadata(metadata_keys_1.AGGREGATE_ROOT_NAME_KEY, targetClass)?.aggregateRootName;
-}
 //# sourceMappingURL=aggregate-root-name.js.map

package/src/lib/aggregate-root/aggregate-root-name.js.map

@@ -1 +1 @@
-{"version":3,"file":"aggregate-root-name.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/aggregate-root/aggregate-root-name.ts"],"names":[],"mappings":";;;AAoBA,oDAEC;AAtBD,4BAA0B;AAE1B,oDAA2D;AAE3D;;;;;;;;GAQG;AACI,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAAkB,EAAE;IAC9D,OAAO,CAAC,MAAc,EAAE,EAAE;QACtB,OAAO,CAAC,cAAc,CAAC,uCAAuB,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;IACzF,CAAC,CAAC;AACN,CAAC,CAAC;AAJW,QAAA,iBAAiB,qBAI5B;AAEF,sEAAsE;AACtE,SAAgB,oBAAoB,CAAC,WAAqB;IACtD,OAAO,OAAO,CAAC,WAAW,CAAC,uCAAuB,EAAE,WAAW,CAAC,EAAE,iBAAiB,CAAC;AACxF,CAAC"}
+{"version":3,"file":"aggregate-root-name.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/aggregate-root/aggregate-root-name.ts"],"names":[],"mappings":";;;AAAA,4BAA0B;AAE1B,oDAA2D;AAE3D;;;;;;;;;GASG;AACI,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAAkB,EAAE;IAC9D,OAAO,CAAC,MAAc,EAAE,EAAE;QACtB,OAAO,CAAC,cAAc,CAAC,uCAAuB,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;IACzF,CAAC,CAAC;AACN,CAAC,CAAC;AAJW,QAAA,iBAAiB,qBAI5B"}

package/src/lib/aggregate-root/aggregate-root.d.ts

@@ -7,10 +7,6 @@ export declare abstract class AggregateRoot {
     private _uncommittedEvents;
     private _version;
     protected constructor(_id: string, logger?: Logger);
-    /**
-     * @deprecated Use {@link uncommittedEvents} instead. It will be removed in version 5.x
-     */
-    get appendedEvents(): Array<AggregateRootEvent<object>>;
     get id(): string;
     get logger(): Logger;
     /**
@@ -51,9 +47,11 @@ export declare abstract class AggregateRoot {
      * method will trigger all the matching {@link ApplyEvent} functions of the entity to populate the object based on
      * application logic.
      * @param events The events that will be sent to {@link ApplyEvent} functions
+     * @param snapshot Optional snapshot to apply before replaying events
+     * @throws AggregateInstanceNotSnapshotAwareException if a snapshot is provided but the aggregate is not snapshot-aware
      * @throws UnknownEventException if an event is not known
      */
-    reconstitute(events: Array<StoredEvent>): void;
+    reconstitute<Snapshot = unknown>(events: Array<StoredEvent>, snapshot?: Snapshot): void;
     resolveVersion(events: Array<StoredEvent>): void;
     protected sortEvents(events: Array<StoredEvent>): Array<StoredEvent>;
     private splitEvents;

package/src/lib/aggregate-root/aggregate-root.js

@@ -8,6 +8,7 @@ const subscription_exception_1 = require("../exceptions/subscription-exception")
 const unknown_event_exception_1 = require("../exceptions/unknown-event-exception");
 const unregistered_event_exception_1 = require("../exceptions/unregistered-event-exception");
 const reflection_1 = require("./reflection");
+const snapshot_aware_1 = require("./snapshot-aware");
 class AggregateRoot {
     constructor(_id, logger) {
         this._id = _id;
@@ -15,12 +16,6 @@ class AggregateRoot {
         this._version = 0;
         this._logger = (0, es_toolkit_1.isNil)(logger) ? new common_1.Logger(AggregateRoot.name) : logger;
     }
-    /**
-     * @deprecated Use {@link uncommittedEvents} instead. It will be removed in version 5.x
-     */
-    get appendedEvents() {
-        return [...this._uncommittedEvents];
-    }
     get id() {
         return this._id;
     }
@@ -98,10 +93,16 @@ class AggregateRoot {
      * method will trigger all the matching {@link ApplyEvent} functions of the entity to populate the object based on
      * application logic.
      * @param events The events that will be sent to {@link ApplyEvent} functions
+     * @param snapshot Optional snapshot to apply before replaying events
+     * @throws AggregateInstanceNotSnapshotAwareException if a snapshot is provided but the aggregate is not snapshot-aware
      * @throws UnknownEventException if an event is not known
      */
-    reconstitute(events) {
+    reconstitute(events, snapshot) {
         const startedAt = Date.now();
+        if (!(0, es_toolkit_1.isNil)(snapshot)) {
+            (0, snapshot_aware_1.assertIsSnapshotAwareAggregateRoot)(this);
+            this.applySnapshot(snapshot);
+        }
         if (events.length > 0) {
             const [unregistered, missingProcessor, known] = this.splitEvents(this.sortEvents(events));
             if (unregistered.length > 0 || missingProcessor.length > 0) {
@@ -124,12 +125,12 @@ class AggregateRoot {
         this._logger.debug(`Reconstitution of ${this.constructor.name} took ${duration}ms`);
     }
     resolveVersion(events) {
-        const sorted = events.sort((event1, event2) => event1.aggregateRootVersion - event2.aggregateRootVersion);
+        const sorted = events.toSorted((event1, event2) => event1.aggregateRootVersion - event2.aggregateRootVersion);
         const lastElement = sorted.at(-1);
         this._version = (0, es_toolkit_1.isNil)(lastElement) ? 0 : lastElement.aggregateRootVersion;
     }
     sortEvents(events) {
-        return events.sort((event1, event2) => event1.aggregateRootVersion - event2.aggregateRootVersion);
+        return events.toSorted((event1, event2) => event1.aggregateRootVersion - event2.aggregateRootVersion);
     }
     splitEvents(events) {
         const known = [];

package/src/lib/aggregate-root/aggregate-root.js.map

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

package/src/lib/aggregate-root/apply-event.decorator.d.ts

@@ -1,5 +1,5 @@
 import "reflect-metadata";
-import { Class } from "type-fest";
+import { Class } from "../utils/type-utils";
 /**
  * A decorator to mark that a method is used to apply a specific event to an aggregate root.
  * When an aggregate root has to be reconstituted based on persisted events, these methods

package/src/lib/aggregate-root/apply-event.decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"apply-event.decorator.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/aggregate-root/apply-event.decorator.ts"],"names":[],"mappings":";;AAgBA,gCAWC;AA3BD,4BAA0B;AAC1B,2CAAmC;AAGnC,+FAAyF;AACzF,oDAA6D;AAE7D;;;;;;;;GAQG;AACH,SAAgB,UAAU,CAAC,UAA0B;IACjD,IAAI,IAAA,kBAAK,EAAC,UAAU,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,0DAA0B,EAAE,CAAC;IAC3C,CAAC;IACD,OAAO,CAAC,cAAc,EAAE,WAAW,EAAE,EAAE;QACnC,OAAO,CAAC,cAAc,CAClB,yCAAyB,GAAG,GAAG,GAAG,WAAW,CAAC,QAAQ,EAAE,EACxD,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW,EAAE,EAC5C,cAAc,CACjB,CAAC;IACN,CAAC,CAAC;AACN,CAAC"}
+{"version":3,"file":"apply-event.decorator.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/aggregate-root/apply-event.decorator.ts"],"names":[],"mappings":";;AAgBA,gCAWC;AA3BD,4BAA0B;AAC1B,2CAAmC;AAEnC,+FAAyF;AACzF,oDAA6D;AAG7D;;;;;;;;GAQG;AACH,SAAgB,UAAU,CAAC,UAA0B;IACjD,IAAI,IAAA,kBAAK,EAAC,UAAU,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,0DAA0B,EAAE,CAAC;IAC3C,CAAC;IACD,OAAO,CAAC,cAAc,EAAE,WAAW,EAAE,EAAE;QACnC,OAAO,CAAC,cAAc,CAClB,yCAAyB,GAAG,GAAG,GAAG,WAAW,CAAC,QAAQ,EAAE,EACxD,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW,EAAE,EAC5C,cAAc,CACjB,CAAC;IACN,CAAC,CAAC;AACN,CAAC"}