@meticoeus/ddd-es 0.2.0

package/dist/src/schemas.test.js

@@ -0,0 +1,110 @@
+/*
+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 { buildLinkSchema, buildVersionedLinkSchema, optionalVersionedFixedLinkSchema, revisionSchema, versionedFixedLinkSchema, } from './schemas.js';
+describe('schemas', () => {
+    describe('revisionSchema', () => {
+        test('latest', () => {
+            const actual = revisionSchema.parse('latest');
+            expect(actual).toEqual('latest');
+        });
+        test('1n', () => {
+            const actual = revisionSchema.parse('1');
+            expect(actual).toEqual(1n);
+        });
+        test('BigInt(1)', () => {
+            const actual = revisionSchema.parse(1n);
+            expect(actual).toEqual(1n);
+        });
+    });
+    describe('versionedFixedLinkSchema', () => {
+        test.each([
+            { msg: 'latest', value: 'latest', expected: 'latest' },
+            { msg: 'String(1)', value: '1', expected: 1n },
+            { msg: 'BigInt(1)', value: 1n, expected: 1n },
+        ])('$msg', ({ value, expected }) => {
+            const actual = versionedFixedLinkSchema.parse({
+                id: 'foo',
+                revision: value,
+            });
+            expect(actual).toEqual({
+                id: 'foo',
+                revision: expected,
+            });
+        });
+    });
+    describe('optionalVersionedFixedLinkSchema', () => {
+        test('undefined', () => {
+            const actual = optionalVersionedFixedLinkSchema.parse(undefined);
+            expect(actual).toEqual(undefined);
+        });
+        test.each([
+            { msg: 'latest', value: 'latest', expected: 'latest' },
+            { msg: 'String(1)', value: '1', expected: 1n },
+            { msg: 'BigInt(1)', value: 1n, expected: 1n },
+        ])('$msg', ({ value, expected }) => {
+            const actual = optionalVersionedFixedLinkSchema.parse({
+                id: 'foo',
+                revision: value,
+            });
+            expect(actual).toEqual({
+                id: 'foo',
+                revision: expected,
+            });
+        });
+    });
+    describe('buildLinkSchema', () => {
+        const schema = buildLinkSchema(['Foo', 'Bar']);
+        test.each(['Foo', 'Bar'])(`matches a listed type %s`, (type) => {
+            const actual = schema.parse({
+                type,
+                id: 'foo',
+            });
+            expect(actual).toEqual({
+                type,
+                id: 'foo',
+            });
+        });
+    });
+    describe('buildVersionedLinkSchema', () => {
+        const schema = buildVersionedLinkSchema(['Foo', 'Bar']);
+        test.each(['Foo', 'Bar'].flatMap((type) => [
+            { type, msg: 'latest', value: 'latest', expected: 'latest' },
+            { type, msg: 'String(1)', value: '1', expected: 1n },
+            { type, msg: 'BigInt(1)', value: 1n, expected: 1n },
+        ]))('matches a listed type $type with revision $expected', ({ type, value, expected }) => {
+            const actual = schema.parse({
+                type,
+                id: 'foo',
+                revision: value,
+            });
+            expect(actual).toEqual({
+                type,
+                id: 'foo',
+                revision: expected,
+            });
+        });
+    });
+});
+//# sourceMappingURL=schemas.test.js.map

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

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

package/dist/src/types.d.ts

@@ -0,0 +1,124 @@
+import { ZodError } from 'zod';
+export interface IException extends Error {
+    readonly name: string;
+    readonly message: string;
+    readonly stack?: string;
+    readonly code?: number | undefined;
+    readonly zod?: ZodError;
+}
+export declare class Exception implements IException {
+    readonly name: string;
+    readonly message: string;
+    readonly code?: number | undefined;
+    protected _userMessage: string | undefined;
+    protected _zod: ZodError | undefined;
+    constructor(name: string, message: string, code?: number | undefined);
+    get userMessage(): string;
+    get zod(): ZodError | undefined;
+}
+export interface OkResult<T> {
+    ok: true;
+    value: T;
+}
+export interface ErrResult<E = IException> {
+    ok: false;
+    error: E;
+}
+export type Result<T, E = IException> = OkResult<T> | ErrResult<E>;
+export declare function Ok<T extends void, E = IException>(): Result<void, E>;
+export declare function Ok<T, E = IException>(value: T): Result<T, E>;
+export declare function Ok<T, E = IException>(value?: T): Result<T | undefined, E>;
+export declare function Err<T, E = IException>(error: E): Result<T, E>;
+export declare class ConcurrencyException extends Exception {
+    readonly streamName: string;
+    readonly expectedRevision: EventRevision | undefined;
+    readonly nextExpectedRevision?: bigint | undefined;
+    constructor(streamName: string, expectedRevision: EventRevision | undefined, nextExpectedRevision?: bigint | undefined, code?: number | undefined);
+}
+export declare class EventConflictException extends Exception {
+    readonly entityName: string;
+    readonly entityId: string;
+    readonly committedEvent: string;
+    readonly conflictingEvent: string;
+    constructor(entityName: string, entityId: string, committedEvent: string, conflictingEvent: string);
+}
+export declare class AggregateDNEException extends Exception {
+    readonly entityName: string;
+    readonly entityId: string;
+    constructor(entityName: string, entityId: string, code?: number | undefined);
+}
+export declare class EntityDNEException extends Exception {
+    readonly aggregateName: string;
+    readonly aggregateId: string;
+    readonly entityName: string;
+    readonly entityId: string;
+    constructor(aggregateName: string, aggregateId: string, entityName: string, entityId: string, code?: number | undefined);
+}
+export declare class AuthorizationException extends Exception {
+    readonly entityName: string;
+    readonly entityId: string;
+    readonly userId: string;
+    readonly permission: string;
+    constructor(entityName: string, entityId: string, userId: string, permission: string, code?: number | undefined);
+}
+export declare class EmailSendException extends Exception {
+    readonly type: string;
+    readonly to: string;
+    readonly email: string;
+    readonly entityId: string;
+    constructor(type: string, to: string, email: string, entityId: string, code?: number | undefined);
+}
+export type IdGenerator<T extends string> = () => T;
+export interface AggregateEventData {
+    /** Unique Aggregate ID. Required in all aggregate events */
+    readonly id: string;
+    /**
+     * Version of the event schema.
+     * When undefined or 0 it means the event isn't ready for production.
+     * Once launched to production schema changes should have a matching version for the event.
+     */
+    readonly v?: number;
+}
+export type JSONType = Record<string | number, unknown>;
+export type DataType = AggregateEventData & JSONType;
+export type MetadataType = JSONType;
+export interface EventMetadata extends MetadataType {
+    correlationId: string;
+    causationId?: string;
+    traceId?: string;
+    spanId?: string;
+}
+export interface IEvent<Type extends string = string, Data extends DataType = DataType, Metadata extends EventMetadata = EventMetadata> {
+    type: Type;
+    data: Data;
+    metadata: Metadata;
+}
+export type IPersistedEvent<Type extends string = string, Data extends DataType = DataType, Metadata extends EventMetadata = EventMetadata> = IEvent<Type, Data, Metadata> & {
+    id: string;
+    revision?: bigint;
+};
+export type Persisted<E extends IEvent> = E & {
+    id: string;
+    revision: bigint;
+};
+export declare function createEvent<E extends IEvent>(data: E): E;
+export declare enum EventExistenceRevision {
+    Any = "any",
+    StreamExists = "stream_exists",
+    NoStream = "no_stream"
+}
+export type EventRevision = EventExistenceRevision | bigint;
+export interface SaveEventSuccess {
+    /**
+     * The current revision of the stream, to be passed as the `expectedRevision` in the next call.
+     */
+    nextExpectedRevision: bigint;
+}
+export type SaveEventResult = Result<SaveEventSuccess, ConcurrencyException>;
+export interface IEventStore {
+    saveEvents(streamName: string, events: IEvent[], expectedRevision: EventRevision): Promise<SaveEventResult>;
+    deleteStream(streamName: string, expectedRevision?: EventRevision): Promise<Result<void, ConcurrencyException>>;
+    getEventsForAggregate<Event extends IEvent = IEvent>(streamName: string, expectedRevision?: bigint): Promise<Persisted<Event>[]>;
+    getEventsForAggregateFromRevision<Event extends IEvent = IEvent>(streamName: string, fromRevision: bigint): Promise<Persisted<Event>[]>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

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

@@ -0,0 +1,3 @@
+import { EventMetadata } from './types.js';
+export declare const mockMetadata: EventMetadata;
+//# sourceMappingURL=types.fixtures.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.fixtures.d.ts","sourceRoot":"","sources":["../../src/types.fixtures.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE1C,eAAO,MAAM,YAAY,EAAE,aAG1B,CAAA"}

package/dist/src/types.fixtures.js

@@ -0,0 +1,28 @@
+/*
+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 const mockMetadata = {
+    causationId: 'causationId',
+    correlationId: 'correlationId',
+};
+//# sourceMappingURL=types.fixtures.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.fixtures.js","sourceRoot":"","sources":["../../src/types.fixtures.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;EAsBE;AAIF,MAAM,CAAC,MAAM,YAAY,GAAkB;IACzC,WAAW,EAAE,aAAa;IAC1B,aAAa,EAAE,eAAe;CAC/B,CAAA"}

package/dist/src/types.js

@@ -0,0 +1,130 @@
+/*
+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 class Exception {
+    name;
+    message;
+    code;
+    _userMessage;
+    _zod;
+    constructor(name, message, code) {
+        this.name = name;
+        this.message = message;
+        this.code = code;
+        Error.captureStackTrace(this);
+    }
+    get userMessage() {
+        return this._userMessage ?? this.message;
+    }
+    get zod() {
+        return this._zod;
+    }
+}
+export function Ok(value) {
+    return { ok: true, value };
+}
+export function Err(error) {
+    return { ok: false, error };
+}
+export class ConcurrencyException extends Exception {
+    streamName;
+    expectedRevision;
+    nextExpectedRevision;
+    constructor(streamName, expectedRevision, nextExpectedRevision, code) {
+        super(`ConcurrencyException`, `${streamName} expected revision "${nextExpectedRevision}" but received ${expectedRevision}.`, code ?? 409);
+        this.streamName = streamName;
+        this.expectedRevision = expectedRevision;
+        this.nextExpectedRevision = nextExpectedRevision;
+    }
+}
+export class EventConflictException extends Exception {
+    entityName;
+    entityId;
+    committedEvent;
+    conflictingEvent;
+    constructor(entityName, entityId, committedEvent, conflictingEvent) {
+        super(`EventConflictException`, `${entityName}:${entityId} new event ${conflictingEvent} conflicts with existing event ${committedEvent}.`, 409);
+        this.entityName = entityName;
+        this.entityId = entityId;
+        this.committedEvent = committedEvent;
+        this.conflictingEvent = conflictingEvent;
+    }
+}
+export class AggregateDNEException extends Exception {
+    entityName;
+    entityId;
+    constructor(entityName, entityId, code) {
+        super(`${entityName}DNEException`, `No ${entityName} with id "${entityId}" exists.`, code ?? 404);
+        this.entityName = entityName;
+        this.entityId = entityId;
+    }
+}
+export class EntityDNEException extends Exception {
+    aggregateName;
+    aggregateId;
+    entityName;
+    entityId;
+    constructor(aggregateName, aggregateId, entityName, entityId, code) {
+        super(`${aggregateName}::${entityName}DNEException`, `No ${entityName} with id "${entityId}" exists in ${aggregateName} with id "${aggregateId}" .`, code ?? 404);
+        this.aggregateName = aggregateName;
+        this.aggregateId = aggregateId;
+        this.entityName = entityName;
+        this.entityId = entityId;
+    }
+}
+export class AuthorizationException extends Exception {
+    entityName;
+    entityId;
+    userId;
+    permission;
+    constructor(entityName, entityId, userId, permission, code) {
+        super('AuthorizationException', `User "${userId}" missing authorization for ${entityName}:"${entityId}" for permission "${permission}".`, code ?? 401);
+        this.entityName = entityName;
+        this.entityId = entityId;
+        this.userId = userId;
+        this.permission = permission;
+    }
+}
+export class EmailSendException extends Exception {
+    type;
+    to;
+    email;
+    entityId;
+    constructor(type, to, email, entityId, code) {
+        super('EmailSendException', `Failed to send email "${type}" to "${to}" with address "${email}" for entity "${entityId}".`, code ?? 500);
+        this.type = type;
+        this.to = to;
+        this.email = email;
+        this.entityId = entityId;
+    }
+}
+export function createEvent(data) {
+    return data;
+}
+export var EventExistenceRevision;
+(function (EventExistenceRevision) {
+    EventExistenceRevision["Any"] = "any";
+    EventExistenceRevision["StreamExists"] = "stream_exists";
+    EventExistenceRevision["NoStream"] = "no_stream";
+})(EventExistenceRevision || (EventExistenceRevision = {}));
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

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

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

@@ -0,0 +1,14 @@
+import { ConcurrencyException, EventRevision, IEvent, IEventStore, IPersistedEvent, Persisted, Result, SaveEventResult } from './types.js';
+export declare function mockEvent<E extends IEvent>(data: Omit<E, 'metadata'>): E;
+export declare function mockPersistedEvent<E extends IEvent>(data: Omit<E, 'metadata'>, revision: bigint): Persisted<E>;
+export declare function mockPersistedEvents<E extends IEvent>(events: Omit<E, 'metadata'>[], revision: bigint): Persisted<E>[];
+export declare class MockEventStore implements IEventStore {
+    protected _events: Map<string, IPersistedEvent[]>;
+    constructor(events?: Map<string, IEvent[]>);
+    saveEvents(streamName: string, events: IEvent[], eventRevision: EventRevision): Promise<SaveEventResult>;
+    deleteStream(streamName: string, eventRevision?: EventRevision): Promise<Result<void, ConcurrencyException>>;
+    getEventsForAggregate<Event extends IEvent = IEvent>(streamName: string, expectedRevision?: bigint): Promise<Persisted<Event>[]>;
+    getEventsForAggregateFromRevision<Event extends IEvent = IEvent>(streamName: string, fromRevision: bigint): Promise<Persisted<Event>[]>;
+    getAllIds(): string[];
+}
+//# sourceMappingURL=types.mocks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.mocks.d.ts","sourceRoot":"","sources":["../../src/types.mocks.ts"],"names":[],"mappings":"AAyBA,OAAO,EACL,oBAAoB,EAGpB,aAAa,EACb,MAAM,EACN,WAAW,EACX,eAAe,EAEf,SAAS,EACT,MAAM,EACN,eAAe,EAChB,MAAM,YAAY,CAAA;AAEnB,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC,CAKxE;AAED,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,EACjD,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,UAAU,CAAC,EACzB,QAAQ,EAAE,MAAM,GACf,SAAS,CAAC,CAAC,CAAC,CAMd;AAED,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,EAClD,MAAM,EAAE,IAAI,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,EAC7B,QAAQ,EAAE,MAAM,GACf,SAAS,CAAC,CAAC,CAAC,EAAE,CAQhB;AAED,qBAAa,cAAe,YAAW,WAAW;IAChD,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAAA;gBAErC,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAoBpC,UAAU,CACd,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EAAE,EAChB,aAAa,EAAE,aAAa,GAC3B,OAAO,CAAC,eAAe,CAAC;IA+BrB,YAAY,CAChB,UAAU,EAAE,MAAM,EAClB,aAAa,CAAC,EAAE,aAAa,GAC5B,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC;IAwBxC,qBAAqB,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,EACvD,UAAU,EAAE,MAAM,EAClB,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;IAgBxB,iCAAiC,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,EACnE,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;IAY9B,SAAS,IAAI,MAAM,EAAE;CAGtB"}