@meticoeus/ddd-es 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Justin Bailey
+
+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,43 @@
+# **@meticoeus/ddd-es**
+
+[![npm version](https://badge.fury.io/js/%40meticoeus%2Fddd-es.svg)](https://badge.fury.io/js/%40meticoeus%2Fddd-es)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+
+*A TypeScript library for using Event Sourcing and Domain-Driven Design.*
+
+## **Overview**
+
+`@meticoeus/ddd-es` is a TypeScript library that simplifies the implementation of Event Sourcing and Domain-Driven Design (DDD) patterns.
+
+## **Installation**
+
+```bash
+npm install @meticoeus/ddd-es
+```
+
+## **Usage**
+
+TODO
+
+* * *
+
+## **Exports**
+
+This library provides the following exports:
+
+- **Core** (`import '@meticoeus/ddd-es'`): The main event-sourcing and DDD components.
+- **Mocks** (`import '@meticoeus/ddd-es/mocks'`): Tools for testing and mocking events and the repositories.
+- **OpenTelemetry** (`import '@meticoeus/ddd-es/otel'`): Optional OpenTelemetry integration for tracing events and commands.
+
+## **License**
+
+This project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details.
+
+## **Contributing**
+
+Contributions are welcome! Please open an issue or submit a pull request if you have improvements or bug fixes.
+
+## **Issues**
+
+If you encounter any issues, please report them [here](https://github.com/yourusername/your-repo-name/issues).

package/dist/package.json

@@ -0,0 +1,81 @@
+{
+    "name": "@meticoeus/ddd-es",
+    "version": "0.2.0",
+    "description": "A Typescript library for using Event Sourcing and Domain Driven Design.",
+    "keywords": [
+        "DDD",
+        "Domain Driven Design",
+        "Event Sourcing"
+    ],
+    "author": "meticoeus",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/meticoeus/ddd-es.git"
+    },
+    "bugs": {
+        "url": "https://github.com/meticoeus/ddd-es/issues"
+    },
+    "homepage": "https://github.com/meticoeus/ddd-es#readme",
+    "license": "MIT",
+    "type": "module",
+    "main": "./dist/src/index.js",
+    "types": "./dist/src/index.d.ts",
+    "exports": {
+        "./package.json": "./package.json",
+        ".": {
+            "types": "./dist/src/index.d.ts",
+            "import": "./dist/src/index.js"
+        },
+        "./mocks": {
+            "types": "./dist/src/mocks.d.ts",
+            "import": "./dist/src/mocks.js"
+        },
+        "./otel": {
+            "types": "./dist/src/otel/index.d.ts",
+            "import": "./dist/src/otel/index.js"
+        }
+    },
+    "files": [
+        "dist/",
+        "README.md",
+        "LICENSE"
+    ],
+    "engines": {
+        "node": ">=20.12.0"
+    },
+    "scripts": {
+        "test": "vitest",
+        "build": "tsc",
+        "format": "prettier --write .",
+        "postinstall": "husky install",
+        "prepare": "npm run build",
+        "prepublishOnly": "npm test -- --run"
+    },
+    "lint-staged": {
+        "**/*.ts": [
+            "npx prettier --write"
+        ]
+    },
+    "peerDependencies": {
+        "@opentelemetry/api": "^1.8.0"
+    },
+    "peerDependenciesMeta": {
+        "@opentelemetry/api": {
+            "optional": true
+        }
+    },
+    "dependencies": {
+        "zod": "^3.23.8"
+    },
+    "devDependencies": {
+        "@types/node": "^20.12.12",
+        "husky": "^8.0.0",
+        "lint-staged": "^15.2.5",
+        "pino": "^9.1.0",
+        "pino-pretty": "^11.0.0",
+        "prettier": "^3.2.5",
+        "prettier-plugin-organize-imports": "^3.2.4",
+        "typescript": "^5.4.5",
+        "vitest": "^1.6.0"
+    }
+}

package/dist/src/AbstractEventProcessManager.d.ts

@@ -0,0 +1,32 @@
+import { EventProcessor } from './EventProcessor.js';
+import { IPersistedEvent } from './types.js';
+export interface Subscribable<E> {
+    [Symbol.asyncIterator](): AsyncIterableIterator<E>;
+}
+export interface EventProcessManagerConfig {
+    /** max exponential backoff in milliseconds */
+    maxWaitTime: number;
+}
+export declare const DefaultEventProcessManagerConfig: EventProcessManagerConfig;
+export declare abstract class AbstractEventProcessManager<DBEvent, ReadPosition, Subscription extends Subscribable<DBEvent>> {
+    protected readonly _processors: EventProcessor[];
+    protected _config: EventProcessManagerConfig;
+    protected _subscription: Subscription | undefined;
+    protected _processed: bigint;
+    protected _processorMap: Map<string, EventProcessor[]>;
+    protected _currentProcess: Promise<void> | undefined;
+    protected _checkpoint: ReadPosition;
+    constructor(_processors: EventProcessor[], initialCheckpoint: ReadPosition, config?: Partial<EventProcessManagerConfig>);
+    protected abstract startSubscription(checkpoint: ReadPosition): Subscription;
+    protected abstract endSubscription(sub: Subscription): void;
+    protected abstract getEventPosition(rawEvent: DBEvent): ReadPosition | undefined;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    protected handleDataEvent(event: IPersistedEvent, position?: ReadPosition): Promise<void>;
+    protected processEvent(event: IPersistedEvent, processor: EventProcessor, retryDelay: number): Promise<void>;
+    protected abstract extractEvent(rawEvent: DBEvent): IPersistedEvent | undefined;
+    protected getProcessors(event: IPersistedEvent): EventProcessor[] | undefined;
+    protected abstract getCheckpoint(): Promise<ReadPosition>;
+    protected abstract setCheckpoint(checkpoint: ReadPosition, processed: bigint): Promise<void>;
+}
+//# sourceMappingURL=AbstractEventProcessManager.d.ts.map

package/dist/src/AbstractEventProcessManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbstractEventProcessManager.d.ts","sourceRoot":"","sources":["../../src/AbstractEventProcessManager.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,cAAc,EAA2B,MAAM,qBAAqB,CAAA;AAE7E,OAAO,EAAwB,eAAe,EAAE,MAAM,YAAY,CAAA;AAGlE,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,qBAAqB,CAAC,CAAC,CAAC,CAAA;CACnD;AAED,MAAM,WAAW,yBAAyB;IACxC,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,eAAO,MAAM,gCAAgC,EAAE,yBAE9C,CAAA;AAED,8BAAsB,2BAA2B,CAC/C,OAAO,EACP,YAAY,EACZ,YAAY,SAAS,YAAY,CAAC,OAAO,CAAC;IAUxC,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,cAAc,EAAE;IARlD,SAAS,CAAC,OAAO,EAAE,yBAAyB,CAAA;IAC5C,SAAS,CAAC,aAAa,EAAE,YAAY,GAAG,SAAS,CAAA;IACjD,SAAS,CAAC,UAAU,EAAE,MAAM,CAAK;IACjC,SAAS,CAAC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,CAAY;IAClE,SAAS,CAAC,eAAe,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAAA;IACpD,SAAS,CAAC,WAAW,EAAE,YAAY,CAAA;gBAGd,WAAW,EAAE,cAAc,EAAE,EAChD,iBAAiB,EAAE,YAAY,EAC/B,MAAM,GAAE,OAAO,CAAC,yBAAyB,CAAoC;IAU/E,SAAS,CAAC,QAAQ,CAAC,iBAAiB,CAAC,UAAU,EAAE,YAAY,GAAG,YAAY;IAC5E,SAAS,CAAC,QAAQ,CAAC,eAAe,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI;IAC3D,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS;IAEnE,KAAK;IAsBL,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;cAMlB,eAAe,CAAC,KAAK,EAAE,eAAe,EAAE,QAAQ,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;cA2B/E,YAAY,CAC1B,KAAK,EAAE,eAAe,EACtB,SAAS,EAAE,cAAc,EACzB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IAkChB,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,GAAG,eAAe,GAAG,SAAS;IAE/E,SAAS,CAAC,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,cAAc,EAAE,GAAG,SAAS;IAoB7E,SAAS,CAAC,QAAQ,CAAC,aAAa,IAAI,OAAO,CAAC,YAAY,CAAC;IAEzD,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAC7F"}

package/dist/src/AbstractEventProcessManager.js

@@ -0,0 +1,142 @@
+/*
+MIT License
+
+Copyright (c) 2024 Justin Bailey
+
+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.
+*/
+import { EventProcessorException } from './EventProcessor.js';
+import { logProvider } from './logger.js';
+import { ConcurrencyException } from './types.js';
+import { serializeBigIntJson } from './utils.js';
+export const DefaultEventProcessManagerConfig = {
+    maxWaitTime: 5 * 60_1000, // 5 minutes
+};
+export class AbstractEventProcessManager {
+    _processors;
+    _config;
+    _subscription;
+    _processed = 0n;
+    _processorMap = new Map();
+    _currentProcess;
+    _checkpoint;
+    constructor(_processors, initialCheckpoint, config = DefaultEventProcessManagerConfig) {
+        this._processors = _processors;
+        this._checkpoint = initialCheckpoint;
+        this._config = config;
+        if (!this._config.maxWaitTime || this._config.maxWaitTime < 1000) {
+            this._config.maxWaitTime = DefaultEventProcessManagerConfig.maxWaitTime;
+        }
+    }
+    async start() {
+        const checkpoint = await this.getCheckpoint();
+        logProvider.log.debug(`Subscribing at checkpoint ${serializeBigIntJson(checkpoint)}`);
+        const subscription = this.startSubscription(checkpoint);
+        this._subscription = subscription;
+        for await (const rawEvent of subscription) {
+            try {
+                const event = this.extractEvent(rawEvent);
+                if (event) {
+                    const position = this.getEventPosition(rawEvent);
+                    this._currentProcess = this.handleDataEvent(event, position);
+                    await this._currentProcess;
+                }
+            }
+            catch (err) {
+                throw err;
+            }
+            await this._currentProcess;
+        }
+    }
+    async stop() {
+        if (!this._subscription)
+            return;
+        this.endSubscription(this._subscription);
+        if (this._currentProcess)
+            await this._currentProcess;
+    }
+    async handleDataEvent(event, position) {
+        const processors = this.getProcessors(event) ?? [];
+        // const id = `${event?.revision}::${event?.streamId}`
+        // const msg = processors.length ? 'P' : 'F'
+        // const type = event?.type ?? 'no-type'
+        // logProvider.log.info(
+        //   `[${msg}] Received event ${id}.${type} at ${event?.position?.commit}`,
+        // )
+        // track if we processed this event
+        let processed = false;
+        if (processors.length) {
+            for (const processor of processors) {
+                await this.processEvent(event, processor, 20);
+            }
+            processed = true;
+        }
+        // keep a running tally of number of events processed
+        this._processed++;
+        // if we have a position and either directly processed this event or have seen 32 new events, save the checkpoint
+        if (typeof position !== 'undefined' && (processed || this._processed % 32n === 0n)) {
+            await this.setCheckpoint(position, this._processed);
+        }
+    }
+    async processEvent(event, processor, retryDelay) {
+        const res = await processor.handle(event);
+        if (!res.ok) {
+            switch (true) {
+                case res.error instanceof ConcurrencyException:
+                    // TODO: what can we do here? Should this actually happen?
+                    break;
+                case res.error instanceof EventProcessorException:
+                    switch (res.error.es.strategy) {
+                        case 'retry':
+                            await new Promise((resolve) => setTimeout(resolve, retryDelay));
+                            const delay = Math.min(retryDelay + 20, this._config.maxWaitTime);
+                            return this.processEvent(event, processor, 
+                            // vary the delay by a random +/- 10% to prevent synchronized requests against remote servers
+                            delay * (Math.random() * 0.2 + 0.9));
+                        case 'skip':
+                            // ignore error and continue processing.
+                            return;
+                        case 'panic':
+                            logProvider.log.fatal(`Unhandled exception processing ${event.id}: ${event.type}`, res.error);
+                            throw res.error;
+                    }
+            }
+        }
+    }
+    getProcessors(event) {
+        const type = event.type;
+        const list = this._processorMap.get(type);
+        if (list)
+            return list;
+        // lookup and cache the event processors
+        for (const processor of this._processors) {
+            if (processor.handlesEvent(type)) {
+                const list = this._processorMap.get(type);
+                if (list) {
+                    list.push(processor);
+                }
+                else {
+                    this._processorMap.set(type, [processor]);
+                }
+            }
+        }
+        return this._processorMap.get(type);
+    }
+}
+//# sourceMappingURL=AbstractEventProcessManager.js.map

package/dist/src/AbstractEventProcessManager.js.map

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

package/dist/src/AbstractEventProcessManager.mocks.d.ts

@@ -0,0 +1,27 @@
+import { AbstractEventProcessManager, Subscribable } from './AbstractEventProcessManager.js';
+import { EventProcessor } from './EventProcessor.js';
+import { IPersistedEvent } from './types.js';
+export type MockReadPosition = 'Start' | 'End' | bigint;
+export declare class MockSubscribable<E> implements Subscribable<E> {
+    private items;
+    private position;
+    private stopSignal;
+    constructor(items: E[], position?: MockReadPosition);
+    [Symbol.asyncIterator](): AsyncIterableIterator<E>;
+    stop(): void;
+}
+export declare class TestEventProcessManager extends AbstractEventProcessManager<IPersistedEvent, MockReadPosition, MockSubscribable<IPersistedEvent>> {
+    /** Events that will be processed by the mock when {@link AbstractEventProcessManager#start()} is called */
+    events: IPersistedEvent[];
+    mockCheckpoint: MockReadPosition;
+    constructor(
+    /** Events that will be processed by the mock when {@link AbstractEventProcessManager#start()} is called */
+    events: IPersistedEvent[], processors: EventProcessor[], initialCheckpoint: MockReadPosition);
+    protected extractEvent(rawEvent: IPersistedEvent): IPersistedEvent | undefined;
+    protected startSubscription(): MockSubscribable<IPersistedEvent>;
+    protected endSubscription(sub: MockSubscribable<IPersistedEvent>): void;
+    protected getEventPosition(rawEvent: IPersistedEvent): MockReadPosition | undefined;
+    protected getCheckpoint(): Promise<MockReadPosition>;
+    protected setCheckpoint(checkpoint: MockReadPosition): Promise<void>;
+}
+//# sourceMappingURL=AbstractEventProcessManager.mocks.d.ts.map

package/dist/src/AbstractEventProcessManager.mocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbstractEventProcessManager.mocks.d.ts","sourceRoot":"","sources":["../../src/AbstractEventProcessManager.mocks.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,2BAA2B,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AAC5F,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAE5C,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAA;AAEvD,qBAAa,gBAAgB,CAAC,CAAC,CAAE,YAAW,YAAY,CAAC,CAAC,CAAC;IAIvD,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,QAAQ;IAJlB,OAAO,CAAC,UAAU,CAAiB;gBAGzB,KAAK,EAAE,CAAC,EAAE,EACV,QAAQ,GAAE,gBAA0B;IAG9C,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,qBAAqB,CAAC,CAAC,CAAC;IAwBlD,IAAI;CAGL;AAED,qBAAa,uBAAwB,SAAQ,2BAA2B,CACtE,eAAe,EACf,gBAAgB,EAChB,gBAAgB,CAAC,eAAe,CAAC,CAClC;IAIG,2GAA2G;IACpG,MAAM,EAAE,eAAe,EAAE;IAJ3B,cAAc,EAAE,gBAAgB,CAAA;;IAGrC,2GAA2G;IACpG,MAAM,EAAE,eAAe,EAAE,EAChC,UAAU,EAAE,cAAc,EAAE,EAC5B,iBAAiB,EAAE,gBAAgB;cAOlB,YAAY,CAAC,QAAQ,EAAE,eAAe,GAAG,eAAe,GAAG,SAAS;cAIpE,iBAAiB,IAAI,gBAAgB,CAAC,eAAe,CAAC;cAItD,eAAe,CAAC,GAAG,EAAE,gBAAgB,CAAC,eAAe,CAAC,GAAG,IAAI;cAI7D,gBAAgB,CAAC,QAAQ,EAAE,eAAe,GAAG,gBAAgB,GAAG,SAAS;cAInE,aAAa,IAAI,OAAO,CAAC,gBAAgB,CAAC;cAI1C,aAAa,CAAC,UAAU,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;CAGpF"}

package/dist/src/AbstractEventProcessManager.mocks.js

@@ -0,0 +1,86 @@
+/*
+MIT License
+
+Copyright (c) 2024 Justin Bailey
+
+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.
+*/
+import { AbstractEventProcessManager } from './AbstractEventProcessManager.js';
+export class MockSubscribable {
+    items;
+    position;
+    stopSignal = false;
+    constructor(items, position = 'Start') {
+        this.items = items;
+        this.position = position;
+    }
+    [Symbol.asyncIterator]() {
+        const ctx = this;
+        let index = 0;
+        if (this.position === 'End') {
+            this.items.reverse();
+        }
+        if (typeof this.position === 'bigint') {
+            index = Number(this.position);
+        }
+        // Create an async generator function
+        async function* asyncGenerator() {
+            while (index < ctx.items.length) {
+                if (ctx.stopSignal)
+                    return;
+                await new Promise((resolve) => setImmediate(resolve));
+                yield ctx.items[index++];
+            }
+        }
+        return asyncGenerator();
+    }
+    stop() {
+        this.stopSignal = true;
+    }
+}
+export class TestEventProcessManager extends AbstractEventProcessManager {
+    events;
+    mockCheckpoint;
+    constructor(
+    /** Events that will be processed by the mock when {@link AbstractEventProcessManager#start()} is called */
+    events, processors, initialCheckpoint) {
+        super(processors, initialCheckpoint);
+        this.events = events;
+        this.mockCheckpoint = initialCheckpoint;
+    }
+    extractEvent(rawEvent) {
+        return rawEvent;
+    }
+    startSubscription() {
+        return new MockSubscribable(this.events, this.mockCheckpoint);
+    }
+    endSubscription(sub) {
+        sub.stop();
+    }
+    getEventPosition(rawEvent) {
+        return rawEvent.revision;
+    }
+    async getCheckpoint() {
+        return this.mockCheckpoint;
+    }
+    async setCheckpoint(checkpoint) {
+        this.mockCheckpoint = checkpoint;
+    }
+}
+//# sourceMappingURL=AbstractEventProcessManager.mocks.js.map

package/dist/src/AbstractEventProcessManager.mocks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbstractEventProcessManager.mocks.js","sourceRoot":"","sources":["../../src/AbstractEventProcessManager.mocks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;EAsBE;AAEF,OAAO,EAAE,2BAA2B,EAAgB,MAAM,kCAAkC,CAAA;AAM5F,MAAM,OAAO,gBAAgB;IAIjB;IACA;IAJF,UAAU,GAAY,KAAK,CAAA;IAEnC,YACU,KAAU,EACV,WAA6B,OAAO;QADpC,UAAK,GAAL,KAAK,CAAK;QACV,aAAQ,GAAR,QAAQ,CAA4B;IAC3C,CAAC;IAEJ,CAAC,MAAM,CAAC,aAAa,CAAC;QACpB,MAAM,GAAG,GAAG,IAAI,CAAA;QAChB,IAAI,KAAK,GAAG,CAAC,CAAA;QAEb,IAAI,IAAI,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAA;QACtB,CAAC;QACD,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACtC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAC/B,CAAC;QAED,qCAAqC;QACrC,KAAK,SAAS,CAAC,CAAC,cAAc;YAC5B,OAAO,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;gBAChC,IAAI,GAAG,CAAC,UAAU;oBAAE,OAAM;gBAE1B,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAA;gBACrD,MAAM,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,CAAM,CAAA;YAC/B,CAAC;QACH,CAAC;QAED,OAAO,cAAc,EAAE,CAAA;IACzB,CAAC;IAED,IAAI;QACF,IAAI,CAAC,UAAU,GAAG,IAAI,CAAA;IACxB,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,2BAI5C;IAKU;IAJF,cAAc,CAAkB;IAEvC;IACE,2GAA2G;IACpG,MAAyB,EAChC,UAA4B,EAC5B,iBAAmC;QAEnC,KAAK,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAA;QAJ7B,WAAM,GAAN,MAAM,CAAmB;QAMhC,IAAI,CAAC,cAAc,GAAG,iBAAiB,CAAA;IACzC,CAAC;IAEkB,YAAY,CAAC,QAAyB;QACvD,OAAO,QAAQ,CAAA;IACjB,CAAC;IAEkB,iBAAiB;QAClC,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,cAAc,CAAC,CAAA;IAC/D,CAAC;IAEkB,eAAe,CAAC,GAAsC;QACvE,GAAG,CAAC,IAAI,EAAE,CAAA;IACZ,CAAC;IAEkB,gBAAgB,CAAC,QAAyB;QAC3D,OAAO,QAAQ,CAAC,QAAQ,CAAA;IAC1B,CAAC;IAEkB,KAAK,CAAC,aAAa;QACpC,OAAO,IAAI,CAAC,cAAc,CAAA;IAC5B,CAAC;IAEkB,KAAK,CAAC,aAAa,CAAC,UAA4B;QACjE,IAAI,CAAC,cAAc,GAAG,UAAU,CAAA;IAClC,CAAC;CACF"}

package/dist/src/AbstractEventProcessManager.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=AbstractEventProcessManager.test.d.ts.map

package/dist/src/AbstractEventProcessManager.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbstractEventProcessManager.test.d.ts","sourceRoot":"","sources":["../../src/AbstractEventProcessManager.test.ts"],"names":[],"mappings":""}

package/dist/src/AbstractEventProcessManager.test.js

@@ -0,0 +1,109 @@
+/*
+MIT License
+
+Copyright (c) 2024 Justin Bailey
+
+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.
+*/
+import { describe, expect, test, vi } from 'vitest';
+import { TestEventProcessManager } from './AbstractEventProcessManager.mocks.js';
+import { testCreated, testDeleted, testRenamed } from './AggregateRoot.fixtures.js';
+import { TestEventProcessor, getEventStoreMock } from './EventProcessor.mocks.js';
+describe('AbstractEventProcessManager', () => {
+    test.each([
+        {
+            msg: 'a single event',
+            end: 1n,
+            events: [testCreated],
+        },
+        {
+            msg: 'multiple events sequentially',
+            end: 3n,
+            events: [testCreated, testRenamed, testDeleted],
+        },
+    ])('processes multiple events sequentially', async ({ events, end }) => {
+        const eventStoreMock = getEventStoreMock();
+        const ep = new TestEventProcessor(eventStoreMock);
+        const epm = new TestEventProcessManager(events, [ep], 'Start');
+        await epm.start();
+        expect(epm.mockCheckpoint).toEqual(end);
+    });
+    test.each([
+        {
+            msg: 'for a single event',
+            end: 2n,
+            events: [testRenamed],
+        },
+        {
+            msg: 'and continue processing other events normally',
+            end: 3n,
+            events: [testCreated, testRenamed, testDeleted],
+        },
+    ])('retries on retryable process failure $msg', async ({ events, end }) => {
+        let called = 0;
+        const eventStoreMock = getEventStoreMock();
+        const ep = new TestEventProcessor(eventStoreMock);
+        const epm = new TestEventProcessManager(events, [ep], 'Start');
+        const handleTestRenamed = vi.fn(() => {
+            if (called < 3) {
+                called++;
+                const e = new Error('Connection failed');
+                e.code = 'ECONNRESET';
+                throw e;
+            }
+        });
+        ep._handlers.set('TestRenamed', handleTestRenamed);
+        await epm.start();
+        expect(epm.mockCheckpoint).toEqual(end);
+        expect(handleTestRenamed).toHaveBeenCalled();
+        expect(handleTestRenamed).toHaveBeenCalledTimes(4);
+    });
+    test('throws on unhandled process failure', async () => {
+        const events = [testCreated, testRenamed, testDeleted];
+        const eventStoreMock = getEventStoreMock();
+        const ep = new TestEventProcessor(eventStoreMock);
+        const epm = new TestEventProcessManager(events, [ep], 'Start');
+        const error = new Error('Something went wrong');
+        const handleTestCreated = vi.fn(() => undefined);
+        const handleTestRenamed = vi.fn(() => {
+            throw error;
+        });
+        const handleTestDeleted = vi.fn(() => undefined);
+        const mock = ep;
+        mock._handlers.set('TestCreated', handleTestCreated);
+        mock._handlers.set('TestRenamed', handleTestRenamed);
+        mock._handlers.set('TestDeleted', handleTestDeleted);
+        try {
+            await epm.start();
+            throw new Error('TestEventProcessManager#start() did not throw an error');
+        }
+        catch (e) {
+            const err = e;
+            expect(err.name).toEqual('EventProcessorException');
+            expect(err.type).toEqual(testRenamed.type);
+            expect(err.es.strategy).toEqual('panic');
+            expect(err.cause).toEqual(error);
+            expect(epm.mockCheckpoint).toEqual(1n);
+            expect(handleTestCreated).toHaveBeenCalled();
+            expect(handleTestRenamed).toHaveBeenCalled();
+            expect(handleTestDeleted).not.toHaveBeenCalled();
+        }
+    });
+});
+//# sourceMappingURL=AbstractEventProcessManager.test.js.map

package/dist/src/AbstractEventProcessManager.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbstractEventProcessManager.test.js","sourceRoot":"","sources":["../../src/AbstractEventProcessManager.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;EAsBE;AAEF,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAA;AAChF,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAEnF,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAGjF,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;IAC3C,IAAI,CAAC,IAAI,CAAC;QACR;YACE,GAAG,EAAE,gBAAgB;YACrB,GAAG,EAAE,EAAE;YACP,MAAM,EAAE,CAAC,WAAW,CAAC;SACtB;QACD;YACE,GAAG,EAAE,8BAA8B;YACnC,GAAG,EAAE,EAAE;YACP,MAAM,EAAE,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,CAAC;SAChD;KACF,CAAC,CACA,wCAAwC,EACxC,KAAK,EAAE,EAAE,MAAM,EAAE,GAAG,EAA2D,EAAE,EAAE;QACjF,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAA;QAC1C,MAAM,EAAE,GAAG,IAAI,kBAAkB,CAAC,cAAc,CAAC,CAAA;QACjD,MAAM,GAAG,GAAG,IAAI,uBAAuB,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAA;QAC9D,MAAM,GAAG,CAAC,KAAK,EAAE,CAAA;QACjB,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IACzC,CAAC,CACF,CAAA;IAED,IAAI,CAAC,IAAI,CAAC;QACR;YACE,GAAG,EAAE,oBAAoB;YACzB,GAAG,EAAE,EAAE;YACP,MAAM,EAAE,CAAC,WAAW,CAAC;SACtB;QACD;YACE,GAAG,EAAE,+CAA+C;YACpD,GAAG,EAAE,EAAE;YACP,MAAM,EAAE,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,CAAC;SAChD;KACF,CAAC,CACA,2CAA2C,EAC3C,KAAK,EAAE,EAAE,MAAM,EAAE,GAAG,EAA2D,EAAE,EAAE;QACjF,IAAI,MAAM,GAAG,CAAC,CAAA;QACd,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAA;QAC1C,MAAM,EAAE,GAAG,IAAI,kBAAkB,CAAC,cAAc,CAAC,CAAA;QACjD,MAAM,GAAG,GAAG,IAAI,uBAAuB,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAA;QAE9D,MAAM,iBAAiB,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE;YACnC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;gBACf,MAAM,EAAE,CAAA;gBACR,MAAM,CAAC,GAAG,IAAI,KAAK,CAAC,mBAAmB,CAAC,CACvC;gBAAC,CAAS,CAAC,IAAI,GAAG,YAAY,CAAA;gBAC/B,MAAM,CAAC,CAAA;YACT,CAAC;QACH,CAAC,CAAC,CACD;QAAC,EAAU,CAAC,SAAS,CAAC,GAAG,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAA;QAE5D,MAAM,GAAG,CAAC,KAAK,EAAE,CAAA;QACjB,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAEvC,MAAM,CAAC,iBAAiB,CAAC,CAAC,gBAAgB,EAAE,CAAA;QAC5C,MAAM,CAAC,iBAAiB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;IACpD,CAAC,CACF,CAAA;IAED,IAAI,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACrD,MAAM,MAAM,GAAsB,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,CAAC,CAAA;QACzE,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAA;QAC1C,MAAM,EAAE,GAAG,IAAI,kBAAkB,CAAC,cAAc,CAAC,CAAA;QACjD,MAAM,GAAG,GAAG,IAAI,uBAAuB,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAA;QAE9D,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAA;QAE/C,MAAM,iBAAiB,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;QAChD,MAAM,iBAAiB,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE;YACnC,MAAM,KAAK,CAAA;QACb,CAAC,CAAC,CAAA;QACF,MAAM,iBAAiB,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;QAEhD,MAAM,IAAI,GAAG,EAAS,CAAA;QACtB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAA;QACpD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAA;QACpD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAA;QAEpD,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,KAAK,EAAE,CAAA;YACjB,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAA;QAC3E,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,CAA4B,CAAA;YACxC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAA;YACnD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;YAC1C,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;YACxC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;YAEhC,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;YACtC,MAAM,CAAC,iBAAiB,CAAC,CAAC,gBAAgB,EAAE,CAAA;YAC5C,MAAM,CAAC,iBAAiB,CAAC,CAAC,gBAAgB,EAAE,CAAA;YAC5C,MAAM,CAAC,iBAAiB,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAA;QAClD,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/src/AggregateRoot.d.ts

@@ -0,0 +1,52 @@
+import { Exception, IEvent, IPersistedEvent, Persisted, Result } from './types.js';
+export interface AggregateConfig {
+    /**
+     * Whether to cache the list of event the aggregate is loaded from.
+     * Required for Repository.save revision conflict management.
+     * Not required for read-only purposes.
+     * Defaults to true.
+     */
+    storeHistory?: boolean;
+}
+export type PersistedAggregate<DomainEvent extends IEvent, T extends AggregateRoot<DomainEvent>> = T & {
+    revision: bigint;
+};
+export interface AggregateRootClass<DomainEvent extends IEvent, T extends AggregateRoot<DomainEvent>> {
+    new (config?: AggregateConfig): T;
+    getStreamName(id: string): string;
+    eventsConflict(pending: IEvent, committed: IPersistedEvent): boolean;
+}
+export declare abstract class AggregateRoot<DomainEvent extends IEvent = IEvent> {
+    private __storeHistory;
+    private __history;
+    private __changes;
+    private readonly _appliers;
+    protected constructor(config?: AggregateConfig);
+    protected _id: string;
+    get id(): string;
+    protected _revision: bigint | undefined;
+    get revision(): bigint | undefined;
+    /** package scope. do not access externally */
+    get history(): Persisted<DomainEvent>[];
+    protected _deleted: boolean;
+    get deleted(): boolean;
+    static eventsConflict(pending: IEvent, committed: IPersistedEvent): boolean;
+    getUncommittedChanges(): DomainEvent[];
+    markChangesAsCommitted(): void;
+    loadFromHistory(history: Iterable<Persisted<DomainEvent>>): void;
+    protected applyChange(event: DomainEvent, isNew?: boolean): void;
+    /**
+     * Either return Ok() or return an error result representing the conflict.
+     */
+    hasConflict(_event: IEvent): Result<void, Exception>;
+    /**
+     * Get events that happened between after (exclusive) and to (inclusive).
+     * Set notation: (after, to]
+     * Requires config.storeHistory to be true or history will not be available.
+     *
+     * @param after The revision to start after.
+     * @param to Optional revision to end at (inclusive). Defaults to current revision.
+     */
+    getEventsDiff(after: bigint, to?: bigint): Persisted<DomainEvent>[];
+}
+//# sourceMappingURL=AggregateRoot.d.ts.map

package/dist/src/AggregateRoot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AggregateRoot.d.ts","sourceRoot":"","sources":["../../src/AggregateRoot.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,EAAM,SAAS,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAItF,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED,MAAM,MAAM,kBAAkB,CAC5B,WAAW,SAAS,MAAM,EAC1B,CAAC,SAAS,aAAa,CAAC,WAAW,CAAC,IAClC,CAAC,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAA;AAE5B,MAAM,WAAW,kBAAkB,CACjC,WAAW,SAAS,MAAM,EAC1B,CAAC,SAAS,aAAa,CAAC,WAAW,CAAC;IAEpC,KAAK,MAAM,CAAC,EAAE,eAAe,GAAG,CAAC,CAAA;IAEjC,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;IAEjC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,GAAG,OAAO,CAAA;CACrE;AAED,8BAAsB,aAAa,CAAC,WAAW,SAAS,MAAM,GAAG,MAAM;IACrE,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmD;IAE7E,SAAS,aAAa,MAAM,CAAC,EAAE,eAAe;IAa9C,SAAS,CAAC,GAAG,EAAE,MAAM,CAAA;IAErB,IAAW,EAAE,IAAI,MAAM,CAEtB;IAED,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IAEvC,IAAW,QAAQ,IAAI,MAAM,GAAG,SAAS,CAExC;IAED,8CAA8C;IAC9C,IAAW,OAAO,IAAI,SAAS,CAAC,WAAW,CAAC,EAAE,CAE7C;IAED,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAQ;IAEnC,IAAW,OAAO,IAAI,OAAO,CAE5B;WAEa,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,GAAG,OAAO;IAM3E,qBAAqB,IAAI,WAAW,EAAE;IAItC,sBAAsB,IAAI,IAAI;IAI9B,eAAe,CAAC,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,GAAG,IAAI;IAYvE,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,GAAE,OAAc,GAAG,IAAI;IAiBtE;;OAEG;IACI,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC;IAK3D;;;;;;;OAOG;IACI,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC,WAAW,CAAC,EAAE;CAiB3E"}

package/dist/src/AggregateRoot.fixtures.d.ts

@@ -0,0 +1,4 @@
+export declare const testCreated: import("./types.js").Persisted<import("./types.js").IEvent<string, import("./types.js").DataType, import("./types.js").EventMetadata>>;
+export declare const testRenamed: import("./types.js").Persisted<import("./types.js").IEvent<string, import("./types.js").DataType, import("./types.js").EventMetadata>>;
+export declare const testDeleted: import("./types.js").Persisted<import("./types.js").IEvent<string, import("./types.js").DataType, import("./types.js").EventMetadata>>;
+//# sourceMappingURL=AggregateRoot.fixtures.d.ts.map