@meticoeus/ddd-es 0.2.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"AggregateRoot.fixtures.d.ts","sourceRoot":"","sources":["../../src/AggregateRoot.fixtures.ts"],"names":[],"mappings":"AA0BA,eAAO,MAAM,WAAW,wIASvB,CAAA;AAED,eAAO,MAAM,WAAW,wIASvB,CAAA;AAED,eAAO,MAAM,WAAW,wIAQvB,CAAA"}

package/dist/src/AggregateRoot.fixtures.js

@@ -0,0 +1,45 @@
+/*
+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 { mockPersistedEvent } from './types.mocks.js';
+export const testCreated = mockPersistedEvent({
+    type: 'TestCreated',
+    data: {
+        id: 'Test:1',
+        name: 'new name',
+    },
+}, 1n);
+export const testRenamed = mockPersistedEvent({
+    type: 'TestRenamed',
+    data: {
+        id: 'Test:1',
+        name: 'new name',
+    },
+}, 2n);
+export const testDeleted = mockPersistedEvent({
+    type: 'TestDeleted',
+    data: {
+        id: 'Test:1',
+    },
+}, 3n);
+//# sourceMappingURL=AggregateRoot.fixtures.js.map

package/dist/src/AggregateRoot.fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AggregateRoot.fixtures.js","sourceRoot":"","sources":["../../src/AggregateRoot.fixtures.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;EAsBE;AAEF,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAErD,MAAM,CAAC,MAAM,WAAW,GAAG,kBAAkB,CAC3C;IACE,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE;QACJ,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,UAAU;KACjB;CACF,EACD,EAAE,CACH,CAAA;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,kBAAkB,CAC3C;IACE,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE;QACJ,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,UAAU;KACjB;CACF,EACD,EAAE,CACH,CAAA;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,kBAAkB,CAC3C;IACE,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE;QACJ,EAAE,EAAE,QAAQ;KACb;CACF,EACD,EAAE,CACH,CAAA"}

package/dist/src/AggregateRoot.js

@@ -0,0 +1,136 @@
+/*
+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 { logProvider } from './logger.js';
+import { Ok } from './types.js';
+const ApplyLength = 'apply'.length;
+export class AggregateRoot {
+    __storeHistory;
+    __history = [];
+    __changes = [];
+    _appliers = new Map();
+    constructor(config) {
+        this.__storeHistory = config?.storeHistory ?? true;
+        const props = Object.getOwnPropertyNames(Object.getPrototypeOf(this));
+        for (const prop of props) {
+            const fn = this[prop];
+            if (typeof fn === 'function' && prop.startsWith('apply') && prop.length > ApplyLength) {
+                this._appliers.set(prop.substring(ApplyLength), fn);
+            }
+        }
+    }
+    // @ts-ignore - will be defined after initializing or loading from history
+    _id;
+    get id() {
+        return this._id;
+    }
+    _revision;
+    get revision() {
+        return this._revision;
+    }
+    /** package scope. do not access externally */
+    get history() {
+        return this.__history;
+    }
+    _deleted = false;
+    get deleted() {
+        return this._deleted;
+    }
+    static eventsConflict(pending, committed) {
+        // override to handle specific conflicts
+        // provide a default impl since the same event type usually conflicts
+        return committed.type === pending.type;
+    }
+    getUncommittedChanges() {
+        return this.__changes;
+    }
+    markChangesAsCommitted() {
+        this.__changes = [];
+    }
+    loadFromHistory(history) {
+        for (const e of history) {
+            this.applyChange(e, false);
+            if (this.__storeHistory) {
+                this.__history.push(e);
+            }
+            if (typeof e.revision === 'bigint') {
+                this._revision = e.revision;
+            }
+        }
+    }
+    applyChange(event, isNew = true) {
+        const applier = this._appliers.get(event.type);
+        if (!applier) {
+            // Panic the unit test, log otherwise
+            if (import.meta.vitest || process.env.VITEST) {
+                throw new Error(`${this.constructor.name}:: No apply function found for "${event.type}"`);
+            }
+            else {
+                logProvider.log.warn(`${this.constructor.name}:: No apply function found for "${event.type}`);
+            }
+        }
+        else {
+            applier.call(this, event);
+        }
+        if (isNew)
+            this.__changes.push(event);
+    }
+    /**
+     * Either return Ok() or return an error result representing the conflict.
+     */
+    hasConflict(_event) {
+        // override to handle specific conflicts
+        return Ok();
+    }
+    /**
+     * 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, to) {
+        if (typeof this._revision === 'undefined') {
+            // TODO: Events are not persisted yet. Return error result?
+        }
+        to = (to ?? this._revision);
+        if (after >= to)
+            return [];
+        const results = [];
+        for (const e of this.__history) {
+            if (e.revision > after && e.revision <= to) {
+                results.push(e);
+            }
+        }
+        return results;
+    }
+}
+if (import.meta.vitest) {
+    const { test } = import.meta.vitest;
+    // in AggregateRoot::applyChange we need to know if we are in a test to throw errors or log
+    // this is here so that we have a test in the file so vitest doesn't fail.
+    // normally we want any test files to have tests rather than changing vitest's config
+    test('make vitest happy for AggregateRoot', () => { });
+}
+//# sourceMappingURL=AggregateRoot.js.map

package/dist/src/AggregateRoot.js.map

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

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

@@ -0,0 +1,26 @@
+import { AggregateRoot } from './AggregateRoot.js';
+import { IEvent, IPersistedEvent, Result } from './types.js';
+export interface TestData extends Record<string | number, unknown> {
+    readonly id: string;
+    readonly name: string;
+}
+export type TestEvent = TestCreatedEvent | TestRenamedEvent | TestDeletedEvent;
+export type TestCreatedEvent = IEvent<'TestCreated', TestData>;
+export type TestRenamedEvent = IEvent<'TestRenamed', TestData>;
+export type TestDeletedEvent = IEvent<'TestDeleted', {
+    readonly id: string;
+}>;
+export declare class Test extends AggregateRoot<TestEvent> {
+    constructor();
+    static create(id: string, name: string): Promise<Result<Test>>;
+    static getStreamName(id: string): string;
+    static eventsConflict(pending: IEvent, committed: IPersistedEvent): boolean;
+    rename(name: string): Promise<Result<void>>;
+    delete(): Promise<Result<void>>;
+    getStreamName(id: string): string;
+    eventsConflict(pending: IEvent, committed: IPersistedEvent): boolean;
+    private applyTestCreated;
+    private applyTestRenamed;
+    private applyTestDeleted;
+}
+//# sourceMappingURL=AggregateRoot.mocks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AggregateRoot.mocks.d.ts","sourceRoot":"","sources":["../../src/AggregateRoot.mocks.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,OAAO,EAAe,MAAM,EAAE,eAAe,EAAM,MAAM,EAAE,MAAM,YAAY,CAAA;AAE7E,MAAM,WAAW,QAAS,SAAQ,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC;IAChE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,MAAM,SAAS,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,gBAAgB,CAAA;AAE9E,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAA;AAC9D,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAA;AAC9D,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,aAAa,EAAE;IAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAE7E,qBAAa,IAAK,SAAQ,aAAa,CAAC,SAAS,CAAC;;WAKnC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAYpE,MAAM,CAAC,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;WAIxB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,GAAG,OAAO;IAU9E,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAW3C,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAWrC,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAIjC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,GAAG,OAAO;IAIpE,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,gBAAgB;IAExB,OAAO,CAAC,gBAAgB;CAGzB"}

package/dist/src/AggregateRoot.mocks.js

@@ -0,0 +1,82 @@
+/*
+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 { AggregateRoot } from './AggregateRoot.js';
+import { mockMetadata } from './types.fixtures.js';
+import { createEvent, Ok } from './types.js';
+export class Test extends AggregateRoot {
+    constructor() {
+        super();
+    }
+    static async create(id, name) {
+        const instance = new Test();
+        instance.applyChange(createEvent({
+            type: 'TestCreated',
+            data: { id, name },
+            metadata: mockMetadata,
+        }));
+        return Ok(instance);
+    }
+    static getStreamName(id) {
+        return `test-${id}`;
+    }
+    static eventsConflict(pending, committed) {
+        switch (true) {
+            case pending.type === committed.type:
+                return true;
+            case committed.type === 'TestDeleted':
+                return true;
+        }
+        return false;
+    }
+    async rename(name) {
+        this.applyChange(createEvent({
+            type: 'TestRenamed',
+            data: { id: this._id, name },
+            metadata: mockMetadata,
+        }));
+        return Ok();
+    }
+    async delete() {
+        this.applyChange(createEvent({
+            type: 'TestDeleted',
+            data: { id: this._id },
+            metadata: mockMetadata,
+        }));
+        return Ok();
+    }
+    getStreamName(id) {
+        return `test${id}`;
+    }
+    eventsConflict(pending, committed) {
+        return pending.type === committed.type;
+    }
+    applyTestCreated(event) {
+        this._id = event.data.id;
+    }
+    applyTestRenamed(_event) { }
+    applyTestDeleted(_event) {
+        this._deleted = true;
+    }
+}
+//# sourceMappingURL=AggregateRoot.mocks.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AggregateRoot.mocks.js","sourceRoot":"","sources":["../../src/AggregateRoot.mocks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;EAsBE;AAEF,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,WAAW,EAA2B,EAAE,EAAU,MAAM,YAAY,CAAA;AAa7E,MAAM,OAAO,IAAK,SAAQ,aAAwB;IAChD;QACE,KAAK,EAAE,CAAA;IACT,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,IAAY;QAC1C,MAAM,QAAQ,GAAG,IAAI,IAAI,EAAE,CAAA;QAC3B,QAAQ,CAAC,WAAW,CAClB,WAAW,CAAmB;YAC5B,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE;YAClB,QAAQ,EAAE,YAAY;SACvB,CAAC,CACH,CAAA;QACD,OAAO,EAAE,CAAC,QAAQ,CAAC,CAAA;IACrB,CAAC;IAED,MAAM,CAAC,aAAa,CAAC,EAAU;QAC7B,OAAO,QAAQ,EAAE,EAAE,CAAA;IACrB,CAAC;IAED,MAAM,CAAU,cAAc,CAAC,OAAe,EAAE,SAA0B;QACxE,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI;gBAClC,OAAO,IAAI,CAAA;YACb,KAAK,SAAS,CAAC,IAAI,KAAK,aAAa;gBACnC,OAAO,IAAI,CAAA;QACf,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,IAAI,CAAC,WAAW,CACd,WAAW,CAAmB;YAC5B,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE;YAC5B,QAAQ,EAAE,YAAY;SACvB,CAAC,CACH,CAAA;QACD,OAAO,EAAE,EAAE,CAAA;IACb,CAAC;IAED,KAAK,CAAC,MAAM;QACV,IAAI,CAAC,WAAW,CACd,WAAW,CAAmB;YAC5B,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;YACtB,QAAQ,EAAE,YAAY;SACvB,CAAC,CACH,CAAA;QACD,OAAO,EAAE,EAAE,CAAA;IACb,CAAC;IAED,aAAa,CAAC,EAAU;QACtB,OAAO,OAAO,EAAE,EAAE,CAAA;IACpB,CAAC;IAED,cAAc,CAAC,OAAe,EAAE,SAA0B;QACxD,OAAO,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI,CAAA;IACxC,CAAC;IAEO,gBAAgB,CAAC,KAAuB;QAC9C,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAA;IAC1B,CAAC;IAEO,gBAAgB,CAAC,MAAwB,IAAG,CAAC;IAE7C,gBAAgB,CAAC,MAAwB;QAC/C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;IACtB,CAAC;CACF"}

package/dist/src/EventProcessor.d.ts

@@ -0,0 +1,40 @@
+import { ConcurrencyException, EventRevision, Exception, IEvent, IEventStore, IPersistedEvent, Result } from './types.js';
+export declare class EventProcessorException extends Exception {
+    readonly type: string;
+    readonly es: EventProcessor.ErrorStrategy;
+    readonly cause: any;
+    constructor(type: string, es: EventProcessor.ErrorStrategy, cause: any);
+}
+export declare namespace EventProcessor {
+    type ErrorHandler = (e: IPersistedEvent, error: unknown) => EventProcessor.ErrorStrategy | undefined;
+    type ErrorStrategy = RetryStrategy | CompensateStrategy | PanicStrategy | SkipStrategy;
+    /** Fail, blocking the event processor until the event can be processed successfully */
+    interface RetryStrategy {
+        strategy: 'retry';
+    }
+    /** Dispatch compensation events then continue processing new events */
+    interface CompensateStrategy {
+        strategy: 'compensate';
+        stream: string;
+        events: IEvent[];
+        expectedRevision: EventRevision;
+    }
+    /** Fail, blocking the event processor until the event can be processed successfully */
+    interface PanicStrategy {
+        strategy: 'panic';
+    }
+    /** Skip the event and proceed to process other events */
+    interface SkipStrategy {
+        strategy: 'skip';
+    }
+}
+export declare abstract class EventProcessor {
+    protected _eventStore: IEventStore;
+    protected readonly _errorHandlers: EventProcessor.ErrorHandler[];
+    protected readonly _handlers: Map<string, (e: IPersistedEvent) => Promise<void>>;
+    constructor(_eventStore: IEventStore, _errorHandlers?: EventProcessor.ErrorHandler[]);
+    handlesEvent(type: string): boolean;
+    handle(e: IPersistedEvent): Promise<Result<void, ConcurrencyException | EventProcessorException>>;
+    protected getErrorStrategy(event: IPersistedEvent, error: unknown): Promise<EventProcessor.ErrorStrategy>;
+}
+//# sourceMappingURL=EventProcessor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EventProcessor.d.ts","sourceRoot":"","sources":["../../src/EventProcessor.ts"],"names":[],"mappings":"AAyBA,OAAO,EACL,oBAAoB,EAEpB,aAAa,EACb,SAAS,EACT,MAAM,EACN,WAAW,EACX,eAAe,EAEf,MAAM,EACP,MAAM,YAAY,CAAA;AAGnB,qBAAa,uBAAwB,SAAQ,SAAS;aAElC,IAAI,EAAE,MAAM;aACZ,EAAE,EAAE,cAAc,CAAC,aAAa;aAChC,KAAK,EAAE,GAAG;gBAFV,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,cAAc,CAAC,aAAa,EAChC,KAAK,EAAE,GAAG;CAQ7B;AAED,MAAM,CAAC,OAAO,WAAW,cAAc,CAAC;IACtC,KAAY,YAAY,GAAG,CACzB,CAAC,EAAE,eAAe,EAClB,KAAK,EAAE,OAAO,KACX,cAAc,CAAC,aAAa,GAAG,SAAS,CAAA;IAI7C,KAAY,aAAa,GACrB,aAAa,GACb,kBAAkB,GAClB,aAAa,GACb,YAAY,CAAA;IAEhB,uFAAuF;IACvF,UAAiB,aAAa;QAC5B,QAAQ,EAAE,OAAO,CAAA;KAClB;IAED,uEAAuE;IACvE,UAAiB,kBAAkB;QACjC,QAAQ,EAAE,YAAY,CAAA;QACtB,MAAM,EAAE,MAAM,CAAA;QACd,MAAM,EAAE,MAAM,EAAE,CAAA;QAChB,gBAAgB,EAAE,aAAa,CAAA;KAChC;IAED,uFAAuF;IACvF,UAAiB,aAAa;QAC5B,QAAQ,EAAE,OAAO,CAAA;KAClB;IAED,yDAAyD;IACzD,UAAiB,YAAY;QAC3B,QAAQ,EAAE,MAAM,CAAA;KACjB;CACF;AAID,8BAAsB,cAAc;IAIhC,SAAS,CAAC,WAAW,EAAE,WAAW;IAClC,SAAS,CAAC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC,YAAY,EAAE;IAJlE,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,CAAY;gBAGhF,WAAW,EAAE,WAAW,EACf,cAAc,GAAE,cAAc,CAAC,YAAY,EAAO;IAWhE,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI7B,MAAM,CACjB,CAAC,EAAE,eAAe,GACjB,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,oBAAoB,GAAG,uBAAuB,CAAC,CAAC;cA0CxD,gBAAgB,CAC9B,KAAK,EAAE,eAAe,EACtB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,cAAc,CAAC,aAAa,CAAC;CAgBzC"}

package/dist/src/EventProcessor.js

@@ -0,0 +1,112 @@
+/*
+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 { logProvider } from './logger.js';
+import { Err, Exception, Ok, } from './types.js';
+import { serializeBigIntJson } from './utils.js';
+export class EventProcessorException extends Exception {
+    type;
+    es;
+    cause;
+    constructor(type, es, cause) {
+        super('EventProcessorException', `Processing event "${type}" failed with type ${es.strategy}.`, 500);
+        this.type = type;
+        this.es = es;
+        this.cause = cause;
+    }
+}
+const HandleLength = 'handle'.length;
+export class EventProcessor {
+    _eventStore;
+    _errorHandlers;
+    _handlers = new Map();
+    constructor(_eventStore, _errorHandlers = []) {
+        this._eventStore = _eventStore;
+        this._errorHandlers = _errorHandlers;
+        const props = Object.getOwnPropertyNames(Object.getPrototypeOf(this));
+        for (const prop of props) {
+            const fn = this[prop];
+            if (typeof fn === 'function' && prop.startsWith('handle') && prop.length > HandleLength) {
+                this._handlers.set(prop.substring(HandleLength), fn);
+            }
+        }
+    }
+    handlesEvent(type) {
+        return this._handlers.has(type);
+    }
+    async handle(e) {
+        const handler = this._handlers.get(e.type);
+        if (!handler) {
+            logProvider.log.warn(`[${this.constructor.name}].handle called for "${e.type}" but no handler found`);
+            return Ok();
+        }
+        try {
+            await handler.call(this, e);
+            return Ok();
+        }
+        catch (err) {
+            // print the full error for investigation
+            console.log(JSON.stringify(err, null, 2));
+            logProvider.log.warn(`[${this.constructor.name}].handle failed for "${e.type}" with "${err?.message}" processing ${serializeBigIntJson(e, 2)}`);
+            const es = await this.getErrorStrategy(e, err);
+            switch (es.strategy) {
+                case 'compensate': {
+                    if (es.events.length) {
+                        // no concurrency check for this op
+                        const res = await this._eventStore.saveEvents(es.stream, es.events, es.expectedRevision);
+                        if (res.ok)
+                            return Ok();
+                        // TODO: what can we do here? when can this legitimately happen?
+                        else
+                            return Err(res.error);
+                    }
+                    break;
+                }
+                case 'retry':
+                case 'skip':
+                case 'panic':
+                    return Err(new EventProcessorException(e.type, es, err));
+                default:
+                    throw err;
+            }
+            // match the switch default case. TS is complaining without this for some reason.
+            throw err;
+        }
+    }
+    async getErrorStrategy(event, error) {
+        if (error?.code === 'ECONNRESET') {
+            return {
+                strategy: 'retry',
+            };
+        }
+        for (const errorHandler of this._errorHandlers) {
+            const es = errorHandler(event, error);
+            if (es)
+                return es;
+        }
+        return {
+            strategy: 'panic',
+        };
+    }
+}
+//# sourceMappingURL=EventProcessor.js.map

package/dist/src/EventProcessor.js.map

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

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

@@ -0,0 +1,11 @@
+import { TestCreatedEvent, TestDeletedEvent, TestRenamedEvent } from './AggregateRoot.mocks.js';
+import { EventProcessor } from './EventProcessor.js';
+import { IEventStore } from './types.js';
+export declare class TestEventProcessor extends EventProcessor {
+    constructor(eventStore: IEventStore);
+    handleTestCreated(_event: TestCreatedEvent): Promise<void>;
+    handleTestRenamed(_event: TestRenamedEvent): Promise<void>;
+    handleTestDeleted(_event: TestDeletedEvent): Promise<void>;
+}
+export declare function getEventStoreMock(): IEventStore;
+//# sourceMappingURL=EventProcessor.mocks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EventProcessor.mocks.d.ts","sourceRoot":"","sources":["../../src/EventProcessor.mocks.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAC/F,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAIL,WAAW,EAKZ,MAAM,YAAY,CAAA;AAEnB,qBAAa,kBAAmB,SAAQ,cAAc;gBACxC,UAAU,EAAE,WAAW;IAI7B,iBAAiB,CAAC,MAAM,EAAE,gBAAgB;IAE1C,iBAAiB,CAAC,MAAM,EAAE,gBAAgB;IAE1C,iBAAiB,CAAC,MAAM,EAAE,gBAAgB;CACjD;AAED,wBAAgB,iBAAiB,IAAI,WAAW,CA2B/C"}

package/dist/src/EventProcessor.mocks.js

@@ -0,0 +1,50 @@
+/*
+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 { EventProcessor } from './EventProcessor.js';
+import { Ok, } from './types.js';
+export class TestEventProcessor extends EventProcessor {
+    constructor(eventStore) {
+        super(eventStore);
+    }
+    async handleTestCreated(_event) { }
+    async handleTestRenamed(_event) { }
+    async handleTestDeleted(_event) { }
+}
+export function getEventStoreMock() {
+    return {
+        saveEvents(_aggregateId, _events, _expectedVersion) {
+            return Promise.resolve(Ok({ nextExpectedRevision: 0n }));
+        },
+        deleteStream(_streamName, _expectedRevision) {
+            return Promise.resolve(Ok());
+        },
+        getEventsForAggregate(_aggregateId) {
+            return Promise.resolve([]);
+        },
+        getEventsForAggregateFromRevision(_streamName, _fromRevision) {
+            return Promise.resolve([]);
+        },
+    };
+}
+//# sourceMappingURL=EventProcessor.mocks.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EventProcessor.mocks.js","sourceRoot":"","sources":["../../src/EventProcessor.mocks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;EAsBE;AAGF,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAKL,EAAE,GAIH,MAAM,YAAY,CAAA;AAEnB,MAAM,OAAO,kBAAmB,SAAQ,cAAc;IACpD,YAAY,UAAuB;QACjC,KAAK,CAAC,UAAU,CAAC,CAAA;IACnB,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,MAAwB,IAAG,CAAC;IAEpD,KAAK,CAAC,iBAAiB,CAAC,MAAwB,IAAG,CAAC;IAEpD,KAAK,CAAC,iBAAiB,CAAC,MAAwB,IAAG,CAAC;CACrD;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL,UAAU,CACR,YAAoB,EACpB,OAAiB,EACjB,gBAA+B;YAE/B,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,oBAAoB,EAAE,EAAE,EAAE,CAAC,CAAC,CAAA;QAC1D,CAAC;QACD,YAAY,CACV,WAAmB,EACnB,iBAAiC;YAEjC,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,CAAA;QAC9B,CAAC;QACD,qBAAqB,CACnB,YAAoB;YAEpB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;QAC5B,CAAC;QACD,iCAAiC,CAC/B,WAAmB,EACnB,aAAqB;YAErB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;QAC5B,CAAC;KACF,CAAA;AACH,CAAC"}

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

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

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

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

package/dist/src/EventProcessor.test.js

@@ -0,0 +1,37 @@
+/*
+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 } from 'vitest';
+import { TestEventProcessor, getEventStoreMock } from './EventProcessor.mocks.js';
+describe('EventProcessor', () => {
+    test('Should return an event processor', () => {
+        const eventStoreMock = getEventStoreMock();
+        const ep = new TestEventProcessor(eventStoreMock);
+        expect(ep.handlesEvent('TestCreated')).toBe(true);
+        expect(ep.handlesEvent('TestRenamed')).toBe(true);
+        expect(ep.handlesEvent('TestDeleted')).toBe(true);
+        expect(ep.handlesEvent('TeamCreated')).toBe(false);
+    });
+    test.todo('Should rollback a failed rename event with CompensateStrategy');
+});
+//# sourceMappingURL=EventProcessor.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EventProcessor.test.js","sourceRoot":"","sources":["../../src/EventProcessor.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;EAsBE;AAEF,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAC/C,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAEjF,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,IAAI,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC5C,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAA;QAC1C,MAAM,EAAE,GAAG,IAAI,kBAAkB,CAAC,cAAc,CAAC,CAAA;QAEjD,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACjD,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACjD,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACjD,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACpD,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAA;AAC5E,CAAC,CAAC,CAAA"}

package/dist/src/IRepository.d.ts

@@ -0,0 +1,14 @@
+import { AggregateRoot, PersistedAggregate } from './AggregateRoot.js';
+import { VersionedFixedLink } from './entities.js';
+import { ConcurrencyException, EventConflictException, EventRevision, Exception, IEvent, Result, SaveEventSuccess } from './types.js';
+export interface IRepository<DomainEvent extends IEvent, T extends AggregateRoot<DomainEvent>> {
+    /**
+     * The concurrency exception handling can currently return any kind of exception.
+     * API design may need some work to address this.
+     */
+    save(aggregate: T, expectedRevision: EventRevision): Promise<Result<SaveEventSuccess, ConcurrencyException | EventConflictException | Exception>>;
+    getById(id: string, includeDeleted?: boolean): Promise<PersistedAggregate<DomainEvent, T> | undefined>;
+    getRevisionById(id: string, revision: bigint, includeDeleted?: boolean): Promise<PersistedAggregate<DomainEvent, T> | undefined>;
+    getByLink<ID extends string>(link: VersionedFixedLink<ID>, includeDeleted?: boolean): Promise<PersistedAggregate<DomainEvent, T> | undefined>;
+}
+//# sourceMappingURL=IRepository.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IRepository.d.ts","sourceRoot":"","sources":["../../src/IRepository.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,aAAa,EACb,SAAS,EACT,MAAM,EACN,MAAM,EACN,gBAAgB,EACjB,MAAM,YAAY,CAAA;AAEnB,MAAM,WAAW,WAAW,CAAC,WAAW,SAAS,MAAM,EAAE,CAAC,SAAS,aAAa,CAAC,WAAW,CAAC;IAC3F;;;OAGG;IACH,IAAI,CACF,SAAS,EAAE,CAAC,EACZ,gBAAgB,EAAE,aAAa,GAC9B,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,oBAAoB,GAAG,sBAAsB,GAAG,SAAS,CAAC,CAAC,CAAA;IAE/F,OAAO,CACL,EAAE,EAAE,MAAM,EACV,cAAc,CAAC,EAAE,OAAO,GACvB,OAAO,CAAC,kBAAkB,CAAC,WAAW,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC,CAAA;IAE1D,eAAe,CACb,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,EAChB,cAAc,CAAC,EAAE,OAAO,GACvB,OAAO,CAAC,kBAAkB,CAAC,WAAW,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC,CAAA;IAE1D,SAAS,CAAC,EAAE,SAAS,MAAM,EACzB,IAAI,EAAE,kBAAkB,CAAC,EAAE,CAAC,EAC5B,cAAc,CAAC,EAAE,OAAO,GACvB,OAAO,CAAC,kBAAkB,CAAC,WAAW,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC,CAAA;CAC3D"}

package/dist/src/IRepository.js

@@ -0,0 +1,25 @@
+/*
+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.
+*/
+export {};
+//# sourceMappingURL=IRepository.js.map