nest-eventsource-kit 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alireza Aminzadeh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,40 @@
+# nest-eventsource-kit
+
+Event Sourcing and CQRS toolkit for NestJS applications.
+
+## Features
+
+- **Event Sourcing** - Store state as sequence of events
+- **CQRS** - Separate read and write models
+- **Saga Pattern** - Coordinate complex transactions
+- **Event Store** - Persist and replay events
+- **Domain-Driven Design** - DDD building blocks
+
+## Installation
+
+```bash
+npm install nest-eventsource-kit
+```
+
+## Quick Start
+
+```typescript
+import { EventSourcingModule } from 'nest-eventsource-kit';
+
+@Module({
+  imports: [
+    EventSourcingModule.forRoot({
+      eventStore: InMemoryEventStore,
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+## Author
+
+Alireza Aminzadeh - alireza.aminzadeh@hotmail.com
+
+## License
+
+MIT

package/dist/event-sourcing.module.d.ts

@@ -0,0 +1,4 @@
+import { DynamicModule } from '@nestjs/common';
+export declare class EventSourcingModule {
+    static forRoot(): DynamicModule;
+}

package/dist/event-sourcing.module.js

@@ -0,0 +1,69 @@
+"use strict";
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+var __setFunctionName = (this && this.__setFunctionName) || function (f, name, prefix) {
+    if (typeof name === "symbol") name = name.description ? "[".concat(name.description, "]") : "";
+    return Object.defineProperty(f, "name", { configurable: true, value: prefix ? "".concat(prefix, " ", name) : name });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventSourcingModule = void 0;
+const common_1 = require("@nestjs/common");
+const event_store_service_1 = require("./services/event-store.service");
+let EventSourcingModule = (() => {
+    let _classDecorators = [(0, common_1.Module)({})];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    var EventSourcingModule = _classThis = class {
+        static forRoot() {
+            return {
+                module: EventSourcingModule,
+                providers: [event_store_service_1.EventStoreService],
+                exports: [event_store_service_1.EventStoreService],
+                global: true,
+            };
+        }
+    };
+    __setFunctionName(_classThis, "EventSourcingModule");
+    (() => {
+        const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+        __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+        EventSourcingModule = _classThis = _classDescriptor.value;
+        if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        __runInitializers(_classThis, _classExtraInitializers);
+    })();
+    return EventSourcingModule = _classThis;
+})();
+exports.EventSourcingModule = EventSourcingModule;

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './event-sourcing.module';
+export * from './services/event-store.service';
+export * from './interfaces/event.interface';

package/dist/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("./event-sourcing.module"), exports);
+__exportStar(require("./services/event-store.service"), exports);
+__exportStar(require("./interfaces/event.interface"), exports);

package/dist/interfaces/event.interface.d.ts

@@ -0,0 +1,11 @@
+export interface DomainEvent {
+    aggregateId: string;
+    eventType: string;
+    data: any;
+    timestamp: Date;
+    version: number;
+}
+export interface EventStore {
+    append(event: DomainEvent): Promise<void>;
+    getEvents(aggregateId: string): Promise<DomainEvent[]>;
+}

package/dist/interfaces/event.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/services/event-store.service.d.ts

@@ -0,0 +1,6 @@
+import { DomainEvent, EventStore } from '../interfaces/event.interface';
+export declare class EventStoreService implements EventStore {
+    private events;
+    append(event: DomainEvent): Promise<void>;
+    getEvents(aggregateId: string): Promise<DomainEvent[]>;
+}

package/dist/services/event-store.service.js

@@ -0,0 +1,69 @@
+"use strict";
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+var __setFunctionName = (this && this.__setFunctionName) || function (f, name, prefix) {
+    if (typeof name === "symbol") name = name.description ? "[".concat(name.description, "]") : "";
+    return Object.defineProperty(f, "name", { configurable: true, value: prefix ? "".concat(prefix, " ", name) : name });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventStoreService = void 0;
+const common_1 = require("@nestjs/common");
+let EventStoreService = (() => {
+    let _classDecorators = [(0, common_1.Injectable)()];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    var EventStoreService = _classThis = class {
+        constructor() {
+            this.events = [];
+        }
+        async append(event) {
+            this.events.push(event);
+        }
+        async getEvents(aggregateId) {
+            return this.events.filter(e => e.aggregateId === aggregateId);
+        }
+    };
+    __setFunctionName(_classThis, "EventStoreService");
+    (() => {
+        const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+        __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+        EventStoreService = _classThis = _classDescriptor.value;
+        if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        __runInitializers(_classThis, _classExtraInitializers);
+    })();
+    return EventStoreService = _classThis;
+})();
+exports.EventStoreService = EventStoreService;

package/dist/services/event-store.service.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/services/event-store.service.spec.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const testing_1 = require("@nestjs/testing");
+const event_store_service_1 = require("./event-store.service");
+describe('EventStoreService', () => {
+    let service;
+    beforeEach(async () => {
+        const module = await testing_1.Test.createTestingModule({
+            providers: [event_store_service_1.EventStoreService],
+        }).compile();
+        service = module.get(event_store_service_1.EventStoreService);
+    });
+    it('should append and retrieve events', async () => {
+        const event = {
+            aggregateId: 'test-1',
+            eventType: 'TestEvent',
+            data: { value: 42 },
+            timestamp: new Date(),
+            version: 1,
+        };
+        await service.append(event);
+        const events = await service.getEvents('test-1');
+        expect(events).toHaveLength(1);
+        expect(events[0]).toEqual(event);
+    });
+});

package/jest.config.js

@@ -0,0 +1,7 @@
+module.exports = {
+  moduleFileExtensions: ['js', 'json', 'ts'],
+  rootDir: 'src',
+  testRegex: '.*\\.spec\\.ts$',
+  transform: { '^.+\\.(t|j)s$': 'ts-jest' },
+  testEnvironment: 'node',
+};

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "nest-eventsource-kit",
+  "version": "1.0.0",
+  "description": "Event Sourcing and CQRS toolkit for NestJS with support for event store, command/query separation, and saga patterns",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "nestjs",
+    "event-sourcing",
+    "cqrs",
+    "ddd",
+    "domain-driven-design",
+    "event-store",
+    "saga",
+    "command-query",
+    "typescript"
+  ],
+  "author": {
+    "name": "Alireza Aminzadeh",
+    "email": "syeedalireza@yahoo.com",
+    "url": "https://github.com/syeedalireza"
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "@nestjs/common": "^10.0.0",
+    "@nestjs/core": "^10.0.0"
+  },
+  "devDependencies": {
+    "@nestjs/common": "^10.3.0",
+    "@nestjs/core": "^10.3.0",
+    "@nestjs/testing": "^10.3.0",
+    "@types/jest": "^29.5.11",
+    "@types/node": "^20.11.0",
+    "jest": "^29.7.0",
+    "reflect-metadata": "^0.2.1",
+    "rxjs": "^7.8.1",
+    "ts-jest": "^29.1.1",
+    "typescript": "^5.3.3"
+  }
+}

package/src/event-sourcing.module.ts

@@ -0,0 +1,14 @@
+import { Module, DynamicModule } from '@nestjs/common';
+import { EventStoreService } from './services/event-store.service';
+
+@Module({})
+export class EventSourcingModule {
+  static forRoot(): DynamicModule {
+    return {
+      module: EventSourcingModule,
+      providers: [EventStoreService],
+      exports: [EventStoreService],
+      global: true,
+    };
+  }
+}

package/src/index.ts

@@ -0,0 +1,3 @@
+export * from './event-sourcing.module';
+export * from './services/event-store.service';
+export * from './interfaces/event.interface';

package/src/interfaces/event.interface.ts

@@ -0,0 +1,12 @@
+export interface DomainEvent {
+  aggregateId: string;
+  eventType: string;
+  data: any;
+  timestamp: Date;
+  version: number;
+}
+
+export interface EventStore {
+  append(event: DomainEvent): Promise<void>;
+  getEvents(aggregateId: string): Promise<DomainEvent[]>;
+}

package/src/services/event-store.service.spec.ts

@@ -0,0 +1,30 @@
+import { Test } from '@nestjs/testing';
+import { EventStoreService } from './event-store.service';
+
+describe('EventStoreService', () => {
+  let service: EventStoreService;
+
+  beforeEach(async () => {
+    const module = await Test.createTestingModule({
+      providers: [EventStoreService],
+    }).compile();
+
+    service = module.get<EventStoreService>(EventStoreService);
+  });
+
+  it('should append and retrieve events', async () => {
+    const event = {
+      aggregateId: 'test-1',
+      eventType: 'TestEvent',
+      data: { value: 42 },
+      timestamp: new Date(),
+      version: 1,
+    };
+
+    await service.append(event);
+    const events = await service.getEvents('test-1');
+
+    expect(events).toHaveLength(1);
+    expect(events[0]).toEqual(event);
+  });
+});

package/src/services/event-store.service.ts

@@ -0,0 +1,15 @@
+import { Injectable } from '@nestjs/common';
+import { DomainEvent, EventStore } from '../interfaces/event.interface';
+
+@Injectable()
+export class EventStoreService implements EventStore {
+  private events: DomainEvent[] = [];
+
+  async append(event: DomainEvent): Promise<void> {
+    this.events.push(event);
+  }
+
+  async getEvents(aggregateId: string): Promise<DomainEvent[]> {
+    return this.events.filter(e => e.aggregateId === aggregateId);
+  }
+}

package/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "compilerOptions": {
+    "module": "commonjs",
+    "declaration": true,
+    "target": "ES2021",
+    "outDir": "./dist",
+    "skipLibCheck": true
+  },
+  "include": ["src/**/*"]
+}