@ddd-ts-kit/kernel 0.0.0-stage → 0.1.0

package/dist/application/logging/credential-keys.js

@@ -0,0 +1,17 @@
+/** The field names whose value a redacting logger never writes, at the top of an entry and one level below. */
+export const CREDENTIAL_KEYS = [
+    'password',
+    'authorization',
+    'cookie',
+    'set-cookie',
+    'token',
+    'secret',
+    'apiKey',
+    'api_key',
+    'access_token',
+    'refresh_token',
+    'accessToken',
+    'refreshToken',
+    'client_secret',
+];
+//# sourceMappingURL=credential-keys.js.map

package/dist/application/logging/credential-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credential-keys.js","sourceRoot":"","sources":["../../../src/application/logging/credential-keys.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAC/G,MAAM,CAAC,MAAM,eAAe,GAAsB;IAChD,UAAU;IACV,eAAe;IACf,QAAQ;IACR,YAAY;IACZ,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,cAAc;IACd,eAAe;IACf,aAAa;IACb,cAAc;IACd,eAAe;CAChB,CAAC"}

package/dist/application/logging/describe-error-fields.d.ts

@@ -0,0 +1,9 @@
+import { type DescribeErrorOptions } from './describe-error.js';
+import type { LogFields } from './log-fields.js';
+import type { LogValue } from './log-value.js';
+/**
+ * The fields as a logger writes them: a copy it may change, where every `Error` directly under
+ * a key is described. Reads each field once, so it throws what a getter of the fields throws.
+ */
+export declare function describeErrorFields(fields: LogFields, options?: DescribeErrorOptions): Record<string, LogValue>;
+//# sourceMappingURL=describe-error-fields.d.ts.map

package/dist/application/logging/describe-error-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-error-fields.d.ts","sourceRoot":"","sources":["../../../src/application/logging/describe-error-fields.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,GAAE,oBAAyB,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAQnH"}

package/dist/application/logging/describe-error-fields.js

@@ -0,0 +1,13 @@
+import { describeError } from './describe-error.js';
+/**
+ * The fields as a logger writes them: a copy it may change, where every `Error` directly under
+ * a key is described. Reads each field once, so it throws what a getter of the fields throws.
+ */
+export function describeErrorFields(fields, options = {}) {
+    const written = {};
+    for (const [key, value] of Object.entries(fields)) {
+        written[key] = value instanceof Error ? describeError(value, options) : value;
+    }
+    return written;
+}
+//# sourceMappingURL=describe-error-fields.js.map

package/dist/application/logging/describe-error-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-error-fields.js","sourceRoot":"","sources":["../../../src/application/logging/describe-error-fields.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAA6B,MAAM,qBAAqB,CAAC;AAI/E;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,OAAO,GAAyB,EAAE;IACvF,MAAM,OAAO,GAA6B,EAAE,CAAC;IAE7C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAChF,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/application/logging/describe-error.d.ts

@@ -0,0 +1,16 @@
+import type { ErrorDescription } from './error-description.js';
+export interface DescribeErrorOptions {
+    /**
+     * Replaces the message of every unexpected error, anything but a `DomainError`, by
+     * `SCRUBBED_MESSAGE`. Default `false`. The option every logger of the kit takes under this name.
+     */
+    readonly scrubMessages?: boolean;
+}
+/**
+ * An error as every logger of the port writes it: its class, its code when it is a
+ * `DomainError`, its message and its own stack, then its cause the same way, eight errors deep
+ * at most. Each error of the chain is written once: the stack of an error never quotes its
+ * cause, and the message of the cause stays out of the message.
+ */
+export declare function describeError(error: Error, options?: DescribeErrorOptions): ErrorDescription;
+//# sourceMappingURL=describe-error.d.ts.map

package/dist/application/logging/describe-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-error.d.ts","sourceRoot":"","sources":["../../../src/application/logging/describe-error.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG/D,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC;AAKD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,GAAE,oBAAyB,GAAG,gBAAgB,CAEhG"}

package/dist/application/logging/describe-error.js

@@ -0,0 +1,34 @@
+import { DomainError } from '../../domain/errors/domain-error.js';
+import { isUnexpectedError } from '../error-reporting/is-unexpected-error.js';
+import { SCRUBBED_MESSAGE } from './scrubbed-message.js';
+const DEEPEST_CAUSE = 8;
+const FIRST_FRAME = /^\s+at /m;
+/**
+ * An error as every logger of the port writes it: its class, its code when it is a
+ * `DomainError`, its message and its own stack, then its cause the same way, eight errors deep
+ * at most. Each error of the chain is written once: the stack of an error never quotes its
+ * cause, and the message of the cause stays out of the message.
+ */
+export function describeError(error, options = {}) {
+    return described(error, options.scrubMessages === true, DEEPEST_CAUSE);
+}
+function described(error, scrubbing, depth) {
+    const scrubbed = scrubbing && isUnexpectedError(error);
+    const stack = stackOf(error, scrubbed);
+    return {
+        type: error.constructor.name,
+        ...(error instanceof DomainError ? { code: error.code } : {}),
+        message: scrubbed ? SCRUBBED_MESSAGE : error.message,
+        ...(stack === undefined ? {} : { stack }),
+        ...(error.cause instanceof Error && depth > 1 ? { cause: described(error.cause, scrubbing, depth - 1) } : {}),
+    };
+}
+/** The first line of a stack repeats the message: a scrubbed error keeps its frames only. */
+function stackOf(error, scrubbed) {
+    if (error.stack === undefined || !scrubbed) {
+        return error.stack;
+    }
+    const firstFrame = error.stack.search(FIRST_FRAME);
+    return firstFrame === -1 ? undefined : error.stack.slice(firstFrame);
+}
+//# sourceMappingURL=describe-error.js.map

package/dist/application/logging/describe-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-error.js","sourceRoot":"","sources":["../../../src/application/logging/describe-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AAE9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAUzD,MAAM,aAAa,GAAG,CAAC,CAAC;AACxB,MAAM,WAAW,GAAG,UAAU,CAAC;AAE/B;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,KAAY,EAAE,OAAO,GAAyB,EAAE;IAC5E,OAAO,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,aAAa,KAAK,IAAI,EAAE,aAAa,CAAC,CAAC;AACzE,CAAC;AAED,SAAS,SAAS,CAAC,KAAY,EAAE,SAAkB,EAAE,KAAa;IAChE,MAAM,QAAQ,GAAG,SAAS,IAAI,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAEvC,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,WAAW,CAAC,IAAI;QAC5B,GAAG,CAAC,KAAK,YAAY,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO;QACpD,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;QACzC,GAAG,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9G,CAAC;AACJ,CAAC;AAED,6FAA6F;AAC7F,SAAS,OAAO,CAAC,KAAY,EAAE,QAAiB;IAC9C,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC3C,OAAO,KAAK,CAAC,KAAK,CAAC;IACrB,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAEnD,OAAO,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;AACvE,CAAC"}

package/dist/application/logging/error-description.d.ts

@@ -0,0 +1,13 @@
+/** What a log entry keeps of an error: plain data, the same from every logger of the port. */
+export type ErrorDescription = {
+    /** The class name of the error. */
+    readonly type: string;
+    /** The stable `code` of a `DomainError`. */
+    readonly code?: string;
+    /** `SCRUBBED_MESSAGE` when the logger scrubs and the error is unexpected. */
+    readonly message: string;
+    /** The stack of this error alone: its cause carries its own. */
+    readonly stack?: string;
+    readonly cause?: ErrorDescription;
+};
+//# sourceMappingURL=error-description.d.ts.map

package/dist/application/logging/error-description.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-description.d.ts","sourceRoot":"","sources":["../../../src/application/logging/error-description.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,MAAM,MAAM,gBAAgB,GAAG;IAC7B,mCAAmC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,gEAAgE;IAChE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;CACnC,CAAC"}

package/dist/application/logging/error-description.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=error-description.js.map

package/dist/application/logging/error-description.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-description.js","sourceRoot":"","sources":["../../../src/application/logging/error-description.ts"],"names":[],"mappings":""}

package/dist/application/logging/error-identity.d.ts

@@ -0,0 +1,8 @@
+/** The two fields the kit itself logs and measures about a caught error. */
+export interface ErrorIdentity {
+    /** The class name of the error. */
+    readonly errorType: string;
+    /** The `code` of a `DomainError`, or of a fault that carries a short one (`TIMEOUT`, `ECONNRESET`). */
+    readonly errorCode?: string;
+}
+//# sourceMappingURL=error-identity.d.ts.map

package/dist/application/logging/error-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-identity.d.ts","sourceRoot":"","sources":["../../../src/application/logging/error-identity.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,uGAAuG;IACvG,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B"}

package/dist/application/logging/error-identity.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=error-identity.js.map

package/dist/application/logging/error-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-identity.js","sourceRoot":"","sources":["../../../src/application/logging/error-identity.ts"],"names":[],"mappings":""}

package/dist/application/logging/identify-error.d.ts

@@ -0,0 +1,8 @@
+import type { ErrorIdentity } from './error-identity.js';
+/**
+ * What the kit records about an error it caught on its own: its class and its code. Never its
+ * message, which quotes data, and never the error itself: `describeError` is for the error a
+ * project decides to log.
+ */
+export declare function identifyError(error: unknown): ErrorIdentity;
+//# sourceMappingURL=identify-error.d.ts.map

package/dist/application/logging/identify-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identify-error.d.ts","sourceRoot":"","sources":["../../../src/application/logging/identify-error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIzD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAO3D"}

package/dist/application/logging/identify-error.js

@@ -0,0 +1,21 @@
+const SHORT_CODE = /^[A-Za-z0-9_.:-]{1,64}$/;
+/**
+ * What the kit records about an error it caught on its own: its class and its code. Never its
+ * message, which quotes data, and never the error itself: `describeError` is for the error a
+ * project decides to log.
+ */
+export function identifyError(error) {
+    const errorCode = codeOf(error);
+    return {
+        errorType: error instanceof Error ? error.constructor.name : typeof error,
+        ...(errorCode === undefined ? {} : { errorCode }),
+    };
+}
+function codeOf(error) {
+    if (typeof error !== 'object' || error === null || !('code' in error)) {
+        return undefined;
+    }
+    const { code } = error;
+    return typeof code === 'string' && SHORT_CODE.test(code) ? code : undefined;
+}
+//# sourceMappingURL=identify-error.js.map

package/dist/application/logging/identify-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identify-error.js","sourceRoot":"","sources":["../../../src/application/logging/identify-error.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAG,yBAAyB,CAAC;AAE7C;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAEhC,OAAO;QACL,SAAS,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,KAAK;QACzE,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC;KAClD,CAAC;AACJ,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC,EAAE,CAAC;QACtE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;IAEvB,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9E,CAAC"}

package/dist/application/logging/log-fields.d.ts

@@ -0,0 +1,24 @@
+import type { LogValue } from './log-value.js';
+/**
+ * Structured fields of a log entry. The well-known keys are spelled once here so that every
+ * adapter and every dashboard agrees on them; a project adds its own by declaration merging:
+ *
+ *     declare module '@ddd-ts-kit/kernel' {
+ *       interface LogFields { orderId?: string; error?: Error }
+ *     }
+ */
+export interface LogFields {
+    correlationId?: string;
+    causationId?: string;
+    /** Bounded context the entry is about. */
+    context?: string;
+    actorId?: string;
+    tenantId?: string;
+    /** Class name of a caught error, as `identifyError` gives it: what the kit logs of an error, never its message. */
+    errorType?: string;
+    /** The stable `code` of a `DomainError`. */
+    errorCode?: string;
+    durationMs?: number;
+    [key: string]: LogValue;
+}
+//# sourceMappingURL=log-fields.d.ts.map

package/dist/application/logging/log-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-fields.d.ts","sourceRoot":"","sources":["../../../src/application/logging/log-fields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mHAAmH;IACnH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAC;CACzB"}

package/dist/application/logging/log-fields.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=log-fields.js.map

package/dist/application/logging/log-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-fields.js","sourceRoot":"","sources":["../../../src/application/logging/log-fields.ts"],"names":[],"mappings":""}

package/dist/application/logging/log-level.d.ts

@@ -0,0 +1,3 @@
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export declare const LOG_LEVELS: readonly LogLevel[];
+//# sourceMappingURL=log-level.d.ts.map

package/dist/application/logging/log-level.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-level.d.ts","sourceRoot":"","sources":["../../../src/application/logging/log-level.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,eAAO,MAAM,UAAU,EAAE,SAAS,QAAQ,EAAuC,CAAC"}

package/dist/application/logging/log-level.js

@@ -0,0 +1,2 @@
+export const LOG_LEVELS = ['debug', 'info', 'warn', 'error'];
+//# sourceMappingURL=log-level.js.map

package/dist/application/logging/log-level.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-level.js","sourceRoot":"","sources":["../../../src/application/logging/log-level.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,UAAU,GAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC"}

package/dist/application/logging/log-value.d.ts

@@ -0,0 +1,5 @@
+/** What a field of a log entry holds. An `Error` is written as `describeError` describes it. */
+export type LogValue = string | number | boolean | null | undefined | Date | Error | readonly LogValue[] | {
+    readonly [key: string]: LogValue;
+};
+//# sourceMappingURL=log-value.d.ts.map

package/dist/application/logging/log-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-value.d.ts","sourceRoot":"","sources":["../../../src/application/logging/log-value.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,MAAM,MAAM,QAAQ,GAChB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,GACT,IAAI,GACJ,KAAK,GACL,SAAS,QAAQ,EAAE,GACnB;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAA;CAAE,CAAC"}

package/dist/application/logging/log-value.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=log-value.js.map

package/dist/application/logging/log-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-value.js","sourceRoot":"","sources":["../../../src/application/logging/log-value.ts"],"names":[],"mappings":""}

package/dist/application/logging/redacted.d.ts

@@ -0,0 +1,3 @@
+/** What stands in a log entry for the value of a credential. */
+export declare const REDACTED = "[redacted]";
+//# sourceMappingURL=redacted.d.ts.map

package/dist/application/logging/redacted.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redacted.d.ts","sourceRoot":"","sources":["../../../src/application/logging/redacted.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,eAAO,MAAM,QAAQ,eAAe,CAAC"}

package/dist/application/logging/redacted.js

@@ -0,0 +1,3 @@
+/** What stands in a log entry for the value of a credential. */
+export const REDACTED = '[redacted]';
+//# sourceMappingURL=redacted.js.map

package/dist/application/logging/redacted.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redacted.js","sourceRoot":"","sources":["../../../src/application/logging/redacted.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,MAAM,CAAC,MAAM,QAAQ,GAAG,YAAY,CAAC"}

package/dist/application/logging/scrubbed-message.d.ts

@@ -0,0 +1,3 @@
+/** What stands for an error message that was removed, in a log entry and in an error report. */
+export declare const SCRUBBED_MESSAGE = "[message removed]";
+//# sourceMappingURL=scrubbed-message.d.ts.map

package/dist/application/logging/scrubbed-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrubbed-message.d.ts","sourceRoot":"","sources":["../../../src/application/logging/scrubbed-message.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,eAAO,MAAM,gBAAgB,sBAAsB,CAAC"}

package/dist/application/logging/scrubbed-message.js

@@ -0,0 +1,3 @@
+/** What stands for an error message that was removed, in a log entry and in an error report. */
+export const SCRUBBED_MESSAGE = '[message removed]';
+//# sourceMappingURL=scrubbed-message.js.map

package/dist/application/logging/scrubbed-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrubbed-message.js","sourceRoot":"","sources":["../../../src/application/logging/scrubbed-message.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,MAAM,CAAC,MAAM,gBAAgB,GAAG,mBAAmB,CAAC"}

package/dist/application/logging/unwritable-fields.d.ts

@@ -0,0 +1,5 @@
+/** What an entry carries in place of fields that could not be read or serialized. */
+export declare const UNWRITABLE_FIELDS: {
+    readonly logError: string;
+};
+//# sourceMappingURL=unwritable-fields.d.ts.map

package/dist/application/logging/unwritable-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unwritable-fields.d.ts","sourceRoot":"","sources":["../../../src/application/logging/unwritable-fields.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,eAAO,MAAM,iBAAiB,EAAE;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAA0C,CAAC"}

package/dist/application/logging/unwritable-fields.js

@@ -0,0 +1,3 @@
+/** What an entry carries in place of fields that could not be read or serialized. */
+export const UNWRITABLE_FIELDS = { logError: 'unserializable fields' };
+//# sourceMappingURL=unwritable-fields.js.map

package/dist/application/logging/unwritable-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unwritable-fields.js","sourceRoot":"","sources":["../../../src/application/logging/unwritable-fields.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,MAAM,CAAC,MAAM,iBAAiB,GAAkC,EAAE,QAAQ,EAAE,uBAAuB,EAAE,CAAC"}

package/dist/application/messaging/bus-middleware.d.ts

@@ -0,0 +1,5 @@
+import type { MessageInfo } from './message-info.js';
+import type { Message } from './message.js';
+/** Cross-cutting behaviour (unit of work, logging, authorization) around every handler. */
+export type BusMiddleware = (message: Message, next: () => Promise<unknown>, info: MessageInfo) => Promise<unknown>;
+//# sourceMappingURL=bus-middleware.d.ts.map

package/dist/application/messaging/bus-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus-middleware.d.ts","sourceRoot":"","sources":["../../../src/application/messaging/bus-middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,2FAA2F;AAC3F,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC"}

package/dist/application/messaging/bus-middleware.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=bus-middleware.js.map

package/dist/application/messaging/bus-middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus-middleware.js","sourceRoot":"","sources":["../../../src/application/messaging/bus-middleware.ts"],"names":[],"mappings":""}

package/dist/application/messaging/command-handler.d.ts

@@ -0,0 +1,6 @@
+import type { Command } from './command.js';
+import type { ResultOf } from './result-of.js';
+export interface CommandHandler<C extends Command<unknown>> {
+    execute(command: C): Promise<ResultOf<C>>;
+}
+//# sourceMappingURL=command-handler.d.ts.map

package/dist/application/messaging/command-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-handler.d.ts","sourceRoot":"","sources":["../../../src/application/messaging/command-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,OAAO,CAAC,OAAO,CAAC;IACxD,OAAO,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;CAC3C"}

package/dist/application/messaging/command-handler.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=command-handler.js.map

package/dist/application/messaging/command-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-handler.js","sourceRoot":"","sources":["../../../src/application/messaging/command-handler.ts"],"names":[],"mappings":""}

package/dist/application/messaging/command.d.ts

@@ -0,0 +1,7 @@
+import type { KIND, RESULT } from './message-brands.js';
+/** An intention to change state. `R` is what the handler answers: nothing or an identifier. */
+export declare abstract class Command<R = void> {
+    readonly [RESULT]?: R;
+    readonly [KIND]?: 'command';
+}
+//# sourceMappingURL=command.d.ts.map

package/dist/application/messaging/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../src/application/messaging/command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAExD,+FAA+F;AAE/F,8BAAsB,OAAO,CAAC,CAAC,GAAG,IAAI;IACpC,SAAiB,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IAE9B,SAAiB,CAAC,IAAI,CAAC,CAAC,EAAE,SAAS,CAAC;CACrC"}

package/dist/application/messaging/command.js

@@ -0,0 +1,5 @@
+/** An intention to change state. `R` is what the handler answers: nothing or an identifier. */
+// eslint-disable-next-line @typescript-eslint/no-unnecessary-type-parameters -- R is a phantom type: it only exists so that ResultOf<C> can infer what the handler answers
+export class Command {
+}
+//# sourceMappingURL=command.js.map

package/dist/application/messaging/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../../src/application/messaging/command.ts"],"names":[],"mappings":"AAEA,+FAA+F;AAC/F,2KAA2K;AAC3K,MAAM,OAAgB,OAAO;CAI5B"}

package/dist/application/messaging/duplicate-handler-error.d.ts

@@ -0,0 +1,5 @@
+import type { MessageInfo } from './message-info.js';
+export declare class DuplicateHandlerError extends Error {
+    constructor(info: MessageInfo);
+}
+//# sourceMappingURL=duplicate-handler-error.d.ts.map

package/dist/application/messaging/duplicate-handler-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicate-handler-error.d.ts","sourceRoot":"","sources":["../../../src/application/messaging/duplicate-handler-error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,IAAI,EAAE,WAAW,EAG5B;CACF"}

package/dist/application/messaging/duplicate-handler-error.js

@@ -0,0 +1,7 @@
+export class DuplicateHandlerError extends Error {
+    constructor(info) {
+        super(`A handler is already registered for ${info.kind} ${info.name}`);
+        this.name = 'DuplicateHandlerError';
+    }
+}
+//# sourceMappingURL=duplicate-handler-error.js.map

package/dist/application/messaging/duplicate-handler-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicate-handler-error.js","sourceRoot":"","sources":["../../../src/application/messaging/duplicate-handler-error.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,IAAiB;QAC3B,KAAK,CAAC,uCAAuC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACvE,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF"}

package/dist/application/messaging/handler-not-found-error.d.ts

@@ -0,0 +1,5 @@
+import type { MessageInfo } from './message-info.js';
+export declare class HandlerNotFoundError extends Error {
+    constructor(info: MessageInfo);
+}
+//# sourceMappingURL=handler-not-found-error.d.ts.map

package/dist/application/messaging/handler-not-found-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-not-found-error.d.ts","sourceRoot":"","sources":["../../../src/application/messaging/handler-not-found-error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,IAAI,EAAE,WAAW,EAG5B;CACF"}

package/dist/application/messaging/handler-not-found-error.js

@@ -0,0 +1,7 @@
+export class HandlerNotFoundError extends Error {
+    constructor(info) {
+        super(`No handler registered for ${info.kind} ${info.name}`);
+        this.name = 'HandlerNotFoundError';
+    }
+}
+//# sourceMappingURL=handler-not-found-error.js.map

package/dist/application/messaging/handler-not-found-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-not-found-error.js","sourceRoot":"","sources":["../../../src/application/messaging/handler-not-found-error.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,IAAiB;QAC3B,KAAK,CAAC,6BAA6B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF"}

package/dist/application/messaging/handler-registration.d.ts

@@ -0,0 +1,6 @@
+/** What a bus is told of a handler when it is registered, for its middlewares to read in `MessageInfo`. */
+export interface HandlerRegistration {
+    /** Bounded context the handler belongs to. */
+    readonly context?: string;
+}
+//# sourceMappingURL=handler-registration.d.ts.map

package/dist/application/messaging/handler-registration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-registration.d.ts","sourceRoot":"","sources":["../../../src/application/messaging/handler-registration.ts"],"names":[],"mappings":"AAAA,2GAA2G;AAC3G,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B"}

package/dist/application/messaging/handler-registration.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=handler-registration.js.map

package/dist/application/messaging/handler-registration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-registration.js","sourceRoot":"","sources":["../../../src/application/messaging/handler-registration.ts"],"names":[],"mappings":""}

package/dist/application/messaging/message-brands.d.ts

@@ -0,0 +1,3 @@
+export declare const RESULT: unique symbol;
+export declare const KIND: unique symbol;
+//# sourceMappingURL=message-brands.d.ts.map

package/dist/application/messaging/message-brands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-brands.d.ts","sourceRoot":"","sources":["../../../src/application/messaging/message-brands.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,CAAC,MAAM,MAAM,EAAE,OAAO,MAAM,CAAC;AAE3C,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,OAAO,MAAM,CAAC"}

package/dist/application/messaging/message-brands.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=message-brands.js.map

package/dist/application/messaging/message-brands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-brands.js","sourceRoot":"","sources":["../../../src/application/messaging/message-brands.ts"],"names":[],"mappings":""}

package/dist/application/messaging/message-info.d.ts

@@ -0,0 +1,7 @@
+export interface MessageInfo {
+    readonly kind: 'command' | 'query';
+    readonly name: string;
+    /** Bounded context of the handler, when the bus was told it at registration. */
+    readonly context?: string;
+}
+//# sourceMappingURL=message-info.d.ts.map

package/dist/application/messaging/message-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-info.d.ts","sourceRoot":"","sources":["../../../src/application/messaging/message-info.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gFAAgF;IAChF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B"}

package/dist/application/messaging/message-info.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=message-info.js.map

package/dist/application/messaging/message-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-info.js","sourceRoot":"","sources":["../../../src/application/messaging/message-info.ts"],"names":[],"mappings":""}

package/dist/application/messaging/message-type.d.ts

@@ -0,0 +1,3 @@
+import type { Message } from './message.js';
+export type MessageType<M extends Message> = abstract new (...args: never[]) => M;
+//# sourceMappingURL=message-type.d.ts.map

package/dist/application/messaging/message-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-type.d.ts","sourceRoot":"","sources":["../../../src/application/messaging/message-type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,OAAO,IAAI,QAAQ,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC"}

package/dist/application/messaging/message-type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=message-type.js.map

package/dist/application/messaging/message-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-type.js","sourceRoot":"","sources":["../../../src/application/messaging/message-type.ts"],"names":[],"mappings":""}

package/dist/application/messaging/message.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from './command.js';
+import type { Query } from './query.js';
+export type Message = Command<unknown> | Query<unknown>;
+//# sourceMappingURL=message.d.ts.map

package/dist/application/messaging/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../../src/application/messaging/message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC"}

package/dist/application/messaging/message.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=message.js.map

package/dist/application/messaging/message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../../../src/application/messaging/message.ts"],"names":[],"mappings":""}

package/dist/application/messaging/query-handler.d.ts

@@ -0,0 +1,6 @@
+import type { Query } from './query.js';
+import type { ResultOf } from './result-of.js';
+export interface QueryHandler<Q extends Query<unknown>> {
+    execute(query: Q): Promise<ResultOf<Q>>;
+}
+//# sourceMappingURL=query-handler.d.ts.map

package/dist/application/messaging/query-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-handler.d.ts","sourceRoot":"","sources":["../../../src/application/messaging/query-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,KAAK,CAAC,OAAO,CAAC;IACpD,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;CACzC"}

package/dist/application/messaging/query-handler.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=query-handler.js.map

package/dist/application/messaging/query-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-handler.js","sourceRoot":"","sources":["../../../src/application/messaging/query-handler.ts"],"names":[],"mappings":""}

package/dist/application/messaging/query.d.ts

@@ -0,0 +1,7 @@
+import type { KIND, RESULT } from './message-brands.js';
+/** A question. Answering it never changes state. */
+export declare abstract class Query<R> {
+    readonly [RESULT]?: R;
+    readonly [KIND]?: 'query';
+}
+//# sourceMappingURL=query.d.ts.map

package/dist/application/messaging/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/application/messaging/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAExD,oDAAoD;AAEpD,8BAAsB,KAAK,CAAC,CAAC;IAC3B,SAAiB,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IAE9B,SAAiB,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC;CACnC"}

package/dist/application/messaging/query.js

@@ -0,0 +1,5 @@
+/** A question. Answering it never changes state. */
+// eslint-disable-next-line @typescript-eslint/no-unnecessary-type-parameters -- R is a phantom type: it only exists so that ResultOf<Q> can infer what the handler answers
+export class Query {
+}
+//# sourceMappingURL=query.js.map

package/dist/application/messaging/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../src/application/messaging/query.ts"],"names":[],"mappings":"AAEA,oDAAoD;AACpD,2KAA2K;AAC3K,MAAM,OAAgB,KAAK;CAI1B"}