@ddd-ts-kit/testing 0.0.0-stage → 0.1.1

package/dist/contracts/lock-contract.js

@@ -0,0 +1,90 @@
+import { ContractSuite } from './contract-suite.js';
+/** What every adapter of the kernel `Lock` port guarantees, the in-memory one included. */
+export function lockContract(runner, options) {
+    new LockSuite(runner, options).describe(`${options.name} (lock contract)`);
+}
+const HELD = { ttlMs: 30_000 };
+class LockSuite extends ContractSuite {
+    options;
+    constructor(runner, options) {
+        super(runner, () => options.createLock());
+        this.options = options;
+    }
+    tests() {
+        this.excludes();
+        this.frees();
+        this.fences();
+        this.waits();
+    }
+    excludes() {
+        this.it('gives a free key to the first who asks, and to nobody else meanwhile', async () => {
+            const first = await this.subject.acquire('report:2026-03', HELD);
+            this.expect(first?.key).toBe('report:2026-03');
+            this.expect(await this.subject.acquire('report:2026-03', HELD)).toBe(undefined);
+        });
+        this.it('keeps keys apart', async () => {
+            await this.subject.acquire('report:2026-03', HELD);
+            this.expect((await this.subject.acquire('report:2026-04', HELD)) !== undefined).toBe(true);
+        });
+        this.it('gives the key to exactly one of several who ask at the same time', async () => {
+            const handles = await Promise.all(Array.from({ length: 8 }, () => this.subject.acquire('report:2026-03', HELD)));
+            this.expect(handles.filter((handle) => handle !== undefined).length).toBe(1);
+        });
+    }
+    frees() {
+        this.it('frees the key when its holder releases it, once or twice', async () => {
+            const first = await this.held('report:2026-03');
+            await first.release();
+            await first.release();
+            this.expect((await this.subject.acquire('report:2026-03', HELD)) !== undefined).toBe(true);
+        });
+        this.it('frees the key by itself when the time to live has passed', async () => {
+            await this.subject.acquire('report:2026-03', { ttlMs: 300 });
+            this.expect(await this.subject.acquire('report:2026-03', HELD)).toBe(undefined);
+            await this.options.elapse(400);
+            this.expect((await this.subject.acquire('report:2026-03', HELD)) !== undefined).toBe(true);
+        });
+        this.it('ignores the release of a holder whose lock expired and was taken by another', async () => {
+            const late = await this.subject.acquire('report:2026-03', { ttlMs: 300 });
+            await this.options.elapse(400);
+            await this.subject.acquire('report:2026-03', HELD);
+            await late?.release();
+            this.expect(await this.subject.acquire('report:2026-03', HELD)).toBe(undefined);
+        });
+    }
+    fences() {
+        this.it('numbers the acquisitions of a key with a token that only grows', async () => {
+            const tokens = [];
+            for (let turn = 0; turn < 3; turn += 1) {
+                const handle = await this.held('report:2026-03');
+                tokens.push(handle.fencingToken);
+                await handle.release();
+            }
+            this.expect(tokens.every((token, index) => index === 0 || token > (tokens[index - 1] ?? token))).toBe(true);
+            this.expect(new Set(tokens).size).toBe(3);
+        });
+    }
+    waits() {
+        this.it('waits for a key that is released within the time it was told to wait', async () => {
+            const first = await this.held('report:2026-03');
+            const [, second] = await Promise.all([
+                first.release(),
+                this.subject.acquire('report:2026-03', { ...HELD, waitMs: 2_000 }),
+            ]);
+            this.expect(second !== undefined).toBe(true);
+            this.expect((second?.fencingToken ?? 0) > first.fencingToken).toBe(true);
+        });
+        this.it('gives up once it has waited that long for a key that stays held', async () => {
+            await this.subject.acquire('report:2026-03', HELD);
+            this.expect(await this.subject.acquire('report:2026-03', { ...HELD, waitMs: 120 })).toBe(undefined);
+        });
+    }
+    async held(key) {
+        const handle = await this.subject.acquire(key, HELD);
+        if (handle === undefined) {
+            throw new Error(`The lock ${key} was expected to be free`);
+        }
+        return handle;
+    }
+}
+//# sourceMappingURL=lock-contract.js.map

package/dist/contracts/lock-contract.js.map

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

package/dist/contracts/logger/create-logger.d.ts

@@ -0,0 +1,6 @@
+import type { Awaitable } from '../awaitable.js';
+import type { LoggerContractSetup } from './logger-contract-setup.js';
+import type { LoggerUnderContract } from './logger-under-contract.js';
+/** A logger on a fresh, empty sink. */
+export type CreateLogger = (setup: LoggerContractSetup) => Awaitable<LoggerUnderContract>;
+//# sourceMappingURL=create-logger.d.ts.map

package/dist/contracts/logger/create-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-logger.d.ts","sourceRoot":"","sources":["../../../src/contracts/logger/create-logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,uCAAuC;AACvC,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,mBAAmB,KAAK,SAAS,CAAC,mBAAmB,CAAC,CAAC"}

package/dist/contracts/logger/create-logger.js

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

package/dist/contracts/logger/create-logger.js.map

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

package/dist/contracts/logger/error-outline-of.d.ts

@@ -0,0 +1,12 @@
+/** What a contract compares of an error as a logger wrote it. */
+export interface ErrorOutline {
+    readonly type: unknown;
+    readonly code: unknown;
+    readonly message: unknown;
+    /** `titled`: starts with the class and the message; `frames`: frames only; `none`: no stack. */
+    readonly stack: 'titled' | 'frames' | 'none';
+    readonly cause: ErrorOutline | undefined;
+}
+/** The outline of a written field, or `undefined` when it is not the description of an error. */
+export declare function errorOutlineOf(written: unknown): ErrorOutline | undefined;
+//# sourceMappingURL=error-outline-of.d.ts.map

package/dist/contracts/logger/error-outline-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-outline-of.d.ts","sourceRoot":"","sources":["../../../src/contracts/logger/error-outline-of.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,gGAAgG;IAChG,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,CAAC;CAC1C;AAID,iGAAiG;AACjG,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,CAYzE"}

package/dist/contracts/logger/error-outline-of.js

@@ -0,0 +1,27 @@
+const FIRST_FRAME = /^\s+at /;
+/** The outline of a written field, or `undefined` when it is not the description of an error. */
+export function errorOutlineOf(written) {
+    if (!isRecord(written) || typeof written.type !== 'string') {
+        return undefined;
+    }
+    return {
+        type: written.type,
+        code: written.code,
+        message: written.message,
+        stack: stackKind(written),
+        cause: errorOutlineOf(written.cause),
+    };
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function stackKind({ type, message, stack }) {
+    if (typeof stack !== 'string') {
+        return 'none';
+    }
+    if (FIRST_FRAME.test(stack)) {
+        return 'frames';
+    }
+    return stack.startsWith(`${String(type)}: ${String(message)}\n`) ? 'titled' : 'none';
+}
+//# sourceMappingURL=error-outline-of.js.map

package/dist/contracts/logger/error-outline-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-outline-of.js","sourceRoot":"","sources":["../../../src/contracts/logger/error-outline-of.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,GAAG,SAAS,CAAC;AAE9B,iGAAiG;AACjG,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC3D,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC;QACzB,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK,CAAC;KACrC,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC;AAED,SAAS,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAqC;IAC5E,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO,KAAK,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;AACvF,CAAC"}

package/dist/contracts/logger/logged-line.d.ts

@@ -0,0 +1,9 @@
+import type { LogLevel } from '@ddd-ts-kit/kernel';
+/** One entry as the sink received it, whatever the format of the adapter. */
+export interface LoggedLine {
+    readonly level: LogLevel;
+    readonly message: string;
+    /** Everything else of the entry. Keys the adapter adds by itself (time, service) are ignored. */
+    readonly fields: Readonly<Record<string, unknown>>;
+}
+//# sourceMappingURL=logged-line.d.ts.map

package/dist/contracts/logger/logged-line.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logged-line.d.ts","sourceRoot":"","sources":["../../../src/contracts/logger/logged-line.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,6EAA6E;AAC7E,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,iGAAiG;IACjG,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACpD"}

package/dist/contracts/logger/logged-line.js

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

package/dist/contracts/logger/logged-line.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logged-line.js","sourceRoot":"","sources":["../../../src/contracts/logger/logged-line.ts"],"names":[],"mappings":""}

package/dist/contracts/logger/logger-contract-setup.d.ts

@@ -0,0 +1,11 @@
+import type { LogFields, LogLevel } from '@ddd-ts-kit/kernel';
+/** What the suite asks of the logger it is about to exercise. */
+export interface LoggerContractSetup {
+    /** Entries below it must not reach the sink. */
+    readonly level: LogLevel;
+    /** To be read at each entry that is written, and merged under the fields of the entry. */
+    readonly fields: () => LogFields;
+    /** Whether the message of an error that is not a `DomainError` must be replaced. */
+    readonly scrubMessages: boolean;
+}
+//# sourceMappingURL=logger-contract-setup.d.ts.map

package/dist/contracts/logger/logger-contract-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-contract-setup.d.ts","sourceRoot":"","sources":["../../../src/contracts/logger/logger-contract-setup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9D,iEAAiE;AACjE,MAAM,WAAW,mBAAmB;IAClC,gDAAgD;IAChD,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,0FAA0F;IAC1F,QAAQ,CAAC,MAAM,EAAE,MAAM,SAAS,CAAC;IACjC,oFAAoF;IACpF,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC"}

package/dist/contracts/logger/logger-contract-setup.js

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

package/dist/contracts/logger/logger-contract-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-contract-setup.js","sourceRoot":"","sources":["../../../src/contracts/logger/logger-contract-setup.ts"],"names":[],"mappings":""}

package/dist/contracts/logger/logger-entries-suite.d.ts

@@ -0,0 +1,19 @@
+import type { ContractRunner } from '../contract-runner.js';
+import { ContractSuite } from '../contract-suite.js';
+import type { CreateLogger } from './create-logger.js';
+import type { LoggerUnderContract } from './logger-under-contract.js';
+/** Levels, fields, children, the fields of the work in progress, and fields that cannot be written. */
+export declare class LoggerEntriesSuite extends ContractSuite<LoggerUnderContract> {
+    private readonly createLogger;
+    private readonly work;
+    constructor(runner: ContractRunner, createLogger: CreateLogger);
+    protected tests(): void;
+    private writes;
+    private binds;
+    private correlates;
+    private filters;
+    private saysItsLevels;
+    private survives;
+    private written;
+}
+//# sourceMappingURL=logger-entries-suite.d.ts.map

package/dist/contracts/logger/logger-entries-suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-entries-suite.d.ts","sourceRoot":"","sources":["../../../src/contracts/logger/logger-entries-suite.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAQtE,uGAAuG;AACvG,qBAAa,kBAAmB,SAAQ,aAAa,CAAC,mBAAmB,CAAC;IAKtE,OAAO,CAAC,QAAQ,CAAC,YAAY;IAJ/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiB;IAEtC,YACE,MAAM,EAAE,cAAc,EACL,YAAY,EAAE,YAAY,EAW5C;IAED,SAAS,CAAC,KAAK,IAAI,IAAI,CAOtB;IAED,OAAO,CAAC,MAAM;IA8Bd,OAAO,CAAC,KAAK;IA+Bb,OAAO,CAAC,UAAU;IAoClB,OAAO,CAAC,OAAO;IA4Bf,OAAO,CAAC,aAAa;IAmBrB,OAAO,CAAC,QAAQ;YAwBF,OAAO;CAKtB"}

package/dist/contracts/logger/logger-entries-suite.js

@@ -0,0 +1,177 @@
+import { LOG_LEVELS } from '@ddd-ts-kit/kernel';
+import { ContractSuite } from '../contract-suite.js';
+import { unreadableTotal } from './unreadable-total.js';
+/** Levels, fields, children, the fields of the work in progress, and fields that cannot be written. */
+export class LoggerEntriesSuite extends ContractSuite {
+    createLogger;
+    work;
+    constructor(runner, createLogger) {
+        const work = { fields: {} };
+        super(runner, () => {
+            work.fields = {};
+            return createLogger({ level: 'debug', scrubMessages: false, fields: () => work.fields });
+        });
+        this.createLogger = createLogger;
+        this.work = work;
+    }
+    tests() {
+        this.writes();
+        this.binds();
+        this.correlates();
+        this.filters();
+        this.saysItsLevels();
+        this.survives();
+    }
+    writes() {
+        this.it('writes an entry of every level with its message', async () => {
+            this.subject.logger.debug('cache missed');
+            this.subject.logger.info('order shipped');
+            this.subject.logger.warn('carrier slow');
+            this.subject.logger.error('carrier failed');
+            this.expect((await this.subject.lines()).map(({ level, message }) => ({ level, message }))).toEqual([
+                { level: 'debug', message: 'cache missed' },
+                { level: 'info', message: 'order shipped' },
+                { level: 'warn', message: 'carrier slow' },
+                { level: 'error', message: 'carrier failed' },
+            ]);
+        });
+        this.it('carries the fields of the entry, whatever their shape', async () => {
+            this.subject.logger.info('order shipped', SHIPMENT);
+            this.expect(await this.written(Object.keys(SHIPMENT))).toEqual([SHIPMENT]);
+        });
+        this.it('keeps its level and its message whatever the fields are named', async () => {
+            this.subject.logger.info('order shipped', { level: 'error', message: 'forged' });
+            const [line] = await this.subject.lines();
+            this.expect({ level: line?.level, message: line?.message }).toEqual({ level: 'info', message: 'order shipped' });
+        });
+    }
+    binds() {
+        this.it('adds the fields of a child to every entry of that child, and to no other', async () => {
+            const shipping = this.subject.logger.child({ context: 'shipping' });
+            shipping.info('order shipped', { orderId: 'order-1' });
+            shipping.warn('carrier slow');
+            this.subject.logger.info('order placed');
+            this.expect(await this.written(['context', 'orderId'])).toEqual([
+                { context: 'shipping', orderId: 'order-1' },
+                { context: 'shipping' },
+                {},
+            ]);
+        });
+        this.it('nests children: the closest binding of a key wins, and the entry wins over all', async () => {
+            const shipping = this.subject.logger.child({ context: 'shipping', carrier: 'post' });
+            const parcel = shipping.child({ carrier: 'express', parcelId: 'parcel-1' });
+            parcel.info('parcel handed over');
+            parcel.info('parcel rerouted', { carrier: 'bike' });
+            shipping.info('order shipped');
+            this.expect(await this.written(['context', 'carrier', 'parcelId'])).toEqual([
+                { context: 'shipping', carrier: 'express', parcelId: 'parcel-1' },
+                { context: 'shipping', carrier: 'bike', parcelId: 'parcel-1' },
+                { context: 'shipping', carrier: 'post' },
+            ]);
+        });
+    }
+    correlates() {
+        this.it('reads the fields of the work in progress at each entry, for a child too', async () => {
+            const shipping = this.subject.logger.child({ context: 'shipping' });
+            this.work.fields = { correlationId: 'request-1' };
+            this.subject.logger.info('order placed');
+            this.work.fields = { correlationId: 'request-2', tenantId: 'acme' };
+            shipping.info('order shipped');
+            this.expect(await this.written(['correlationId', 'tenantId', 'context'])).toEqual([
+                { correlationId: 'request-1' },
+                { correlationId: 'request-2', tenantId: 'acme', context: 'shipping' },
+            ]);
+        });
+        this.it('lets the fields of the entry win over those of the work in progress', async () => {
+            this.work.fields = { correlationId: 'request-1', tenantId: 'acme' };
+            this.subject.logger.info('replayed', { correlationId: 'replay-7' });
+            this.expect(await this.written(['correlationId', 'tenantId'])).toEqual([
+                { correlationId: 'replay-7', tenantId: 'acme' },
+            ]);
+        });
+        this.it('still writes the entry when the fields of the work in progress cannot be read', async () => {
+            const subject = await this.createLogger({ level: 'debug', scrubMessages: false, fields: unreadable });
+            subject.logger.info('order placed', { orderId: 'order-1' });
+            this.expect((await subject.lines()).map(({ message, fields }) => ({ message, orderId: fields.orderId }))).toEqual([{ message: 'order placed', orderId: 'order-1' }]);
+        });
+    }
+    filters() {
+        this.it('drops an entry below its level without reading any field for it', async () => {
+            let read = 0;
+            const subject = await this.createLogger({
+                level: 'warn',
+                scrubMessages: false,
+                fields: () => ({ read: (read += 1) }),
+            });
+            subject.logger.debug('cache missed');
+            subject.logger.info('order shipped');
+            subject.logger.child({ context: 'shipping' }).info('parcel handed over');
+            this.expect(read).toBe(0);
+            subject.logger.warn('carrier slow');
+            subject.logger.child({ context: 'shipping' }).error('carrier failed');
+            this.expect((await subject.lines()).map(({ level, message }) => ({ level, message }))).toEqual([
+                { level: 'warn', message: 'carrier slow' },
+                { level: 'error', message: 'carrier failed' },
+            ]);
+            this.expect(read).toBe(2);
+        });
+    }
+    saysItsLevels() {
+        this.it('says which levels it writes, for a child too, as it writes them', async () => {
+            const subject = await this.createLogger({ level: 'warn', scrubMessages: false, fields: () => ({}) });
+            const loggers = [this.subject.logger, subject.logger, subject.logger.child({ context: 'shipping' })];
+            for (const level of LOG_LEVELS) {
+                subject.logger[level]('carrier asked');
+            }
+            this.expect(loggers.map((logger) => LOG_LEVELS.filter((level) => logger.isLevelEnabled(level)))).toEqual([
+                LOG_LEVELS,
+                ['warn', 'error'],
+                ['warn', 'error'],
+            ]);
+            this.expect((await subject.lines()).map(({ level }) => level)).toEqual(['warn', 'error']);
+        });
+    }
+    survives() {
+        this.it('never throws on fields that cannot be written, and writes the entries that follow', async () => {
+            this.subject.logger.info('looped', circular());
+            this.subject.logger.child(circular()).warn('bound to a loop');
+            this.subject.logger.error('unreadable', { payload: unreadableTotal() });
+            this.subject.logger.error('unreadable at the top', unreadableTotal());
+            this.subject.logger.child(unreadableTotal()).warn('bound to the unreadable');
+            this.subject.logger.info('order shipped', { orderId: 'order-1' });
+            const lines = await this.subject.lines();
+            this.expect(lines.map(({ level, message }) => ({ level, message }))).toEqual([
+                { level: 'info', message: 'looped' },
+                { level: 'warn', message: 'bound to a loop' },
+                { level: 'error', message: 'unreadable' },
+                { level: 'error', message: 'unreadable at the top' },
+                { level: 'warn', message: 'bound to the unreadable' },
+                { level: 'info', message: 'order shipped' },
+            ]);
+            this.expect(lines[5]?.fields.orderId).toBe('order-1');
+        });
+    }
+    async written(keys) {
+        return (await this.subject.lines()).map(({ fields }) => Object.fromEntries(keys.filter((key) => fields[key] !== undefined).map((key) => [key, fields[key]])));
+    }
+}
+const SHIPMENT = {
+    context: 'shipping',
+    orderId: 'order-1',
+    durationMs: 12.5,
+    attempt: 0,
+    express: false,
+    note: '',
+    carrier: null,
+    parcels: ['parcel-1', 'parcel-2'],
+    destination: { country: 'FR', zone: 3 },
+};
+function circular() {
+    const loop = { name: 'loop' };
+    loop.self = loop;
+    return loop;
+}
+function unreadable() {
+    throw new Error('no active span');
+}
+//# sourceMappingURL=logger-entries-suite.js.map

package/dist/contracts/logger/logger-entries-suite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-entries-suite.js","sourceRoot":"","sources":["../../../src/contracts/logger/logger-entries-suite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiC,MAAM,oBAAoB,CAAC;AAE/E,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAOxD,uGAAuG;AACvG,MAAM,OAAO,kBAAmB,SAAQ,aAAkC;IAKrD,YAAY;IAJd,IAAI,CAAiB;IAEtC,YACE,MAAsB,EACL,YAA0B;QAE3C,MAAM,IAAI,GAAmB,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QAE5C,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE;YACjB,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;YAEjB,OAAO,YAAY,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3F,CAAC,CAAC,CAAC;4BARc,YAAY;QAU7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAES,KAAK;QACb,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,IAAI,CAAC,QAAQ,EAAE,CAAC;IAClB,CAAC;IAEO,MAAM;QACZ,IAAI,CAAC,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;YACpE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;YAC1C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAC1C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACzC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;YAE5C,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;gBAClG,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE;gBAC3C,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE;gBAC3C,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE;gBAC1C,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE;aAC9C,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;YAC1E,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;YAEpD,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC7E,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;YAClF,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;YAEjF,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAE1C,IAAI,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC,CAAC;QACnH,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK;QACX,IAAI,CAAC,EAAE,CAAC,0EAA0E,EAAE,KAAK,IAAI,EAAE;YAC7F,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;YAEpE,QAAQ,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;YACvD,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAC9B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAEzC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;gBAC9D,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE;gBAC3C,EAAE,OAAO,EAAE,UAAU,EAAE;gBACvB,EAAE;aACH,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,gFAAgF,EAAE,KAAK,IAAI,EAAE;YACnG,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;YACrF,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC;YAE5E,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;YAClC,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;YACpD,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAE/B,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;gBAC1E,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE;gBACjE,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE;gBAC9D,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE;aACzC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,UAAU;QAChB,IAAI,CAAC,EAAE,CAAC,yEAAyE,EAAE,KAAK,IAAI,EAAE;YAC5F,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;YAEpE,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,EAAE,aAAa,EAAE,WAAW,EAAE,CAAC;YAClD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACzC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,EAAE,aAAa,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;YACpE,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAE/B,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,eAAe,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;gBAChF,EAAE,aAAa,EAAE,WAAW,EAAE;gBAC9B,EAAE,aAAa,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE;aACtE,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;YACxF,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,EAAE,aAAa,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;YAEpE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC,CAAC;YAEpE,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;gBACrE,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE;aAChD,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,+EAA+E,EAAE,KAAK,IAAI,EAAE;YAClG,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;YAEtG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;YAE5D,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAC/G,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAClD,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,OAAO;QACb,IAAI,CAAC,EAAE,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;YACpF,IAAI,IAAI,GAAG,CAAC,CAAC;YAEb,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC;gBACtC,KAAK,EAAE,MAAM;gBACb,aAAa,EAAE,KAAK;gBACpB,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC;aACtC,CAAC,CAAC;YAEH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;YACrC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YACrC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;YAEzE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAE1B,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACpC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;YAEtE,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;gBAC7F,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE;gBAC1C,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE;aAC9C,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,aAAa;QACnB,IAAI,CAAC,EAAE,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;YACpF,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACrG,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;YAErG,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;gBAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,eAAe,CAAC,CAAC;YACzC,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;gBACvG,UAAU;gBACV,CAAC,MAAM,EAAE,OAAO,CAAC;gBACjB,CAAC,MAAM,EAAE,OAAO,CAAC;aAClB,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAC5F,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,QAAQ;QACd,IAAI,CAAC,EAAE,CAAC,mFAAmF,EAAE,KAAK,IAAI,EAAE;YACtG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC/C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YAC9D,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,EAAE,OAAO,EAAE,eAAe,EAAE,EAAE,CAAC,CAAC;YACxE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,eAAe,EAAE,CAAC,CAAC;YACtE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;YAC7E,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;YAElE,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAEzC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;gBAC3E,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE;gBACpC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE;gBAC7C,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE;gBACzC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,uBAAuB,EAAE;gBACpD,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,yBAAyB,EAAE;gBACrD,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE;aAC5C,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,IAAuB;QAC3C,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CACrD,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CACrG,CAAC;IACJ,CAAC;CACF;AAED,MAAM,QAAQ,GAAc;IAC1B,OAAO,EAAE,UAAU;IACnB,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,IAAI;IAChB,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,KAAK;IACd,IAAI,EAAE,EAAE;IACR,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC;IACjC,WAAW,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE;CACxC,CAAC;AAEF,SAAS,QAAQ;IACf,MAAM,IAAI,GAA6B,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAExD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IAEjB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,UAAU;IACjB,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;AACpC,CAAC"}

package/dist/contracts/logger/logger-shutdown-suite.d.ts

@@ -0,0 +1,15 @@
+import type { ContractRunner } from '../contract-runner.js';
+import { ContractSuite } from '../contract-suite.js';
+import type { CreateLogger } from './create-logger.js';
+import type { LoggerUnderContract } from './logger-under-contract.js';
+/** An error passed as a field, and the flush that ends the life of a logger. */
+export declare class LoggerShutdownSuite extends ContractSuite<LoggerUnderContract> {
+    private readonly createLogger;
+    constructor(runner: ContractRunner, createLogger: CreateLogger);
+    protected tests(): void;
+    private describes;
+    private boundsTheCauses;
+    private scrubs;
+    private flushes;
+}
+//# sourceMappingURL=logger-shutdown-suite.d.ts.map

package/dist/contracts/logger/logger-shutdown-suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-shutdown-suite.d.ts","sourceRoot":"","sources":["../../../src/contracts/logger/logger-shutdown-suite.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAStE,gFAAgF;AAChF,qBAAa,mBAAoB,SAAQ,aAAa,CAAC,mBAAmB,CAAC;IAGvE,OAAO,CAAC,QAAQ,CAAC,YAAY;IAF/B,YACE,MAAM,EAAE,cAAc,EACL,YAAY,EAAE,YAAY,EAG5C;IAED,SAAS,CAAC,KAAK,IAAI,IAAI,CAKtB;IAED,OAAO,CAAC,SAAS;IAiCjB,OAAO,CAAC,eAAe;IAmBvB,OAAO,CAAC,MAAM;IAyBd,OAAO,CAAC,OAAO;CA4BhB"}

package/dist/contracts/logger/logger-shutdown-suite.js

@@ -0,0 +1,98 @@
+import { DomainError, SCRUBBED_MESSAGE } from '@ddd-ts-kit/kernel';
+import { ContractSuite } from '../contract-suite.js';
+import { errorOutlineOf } from './error-outline-of.js';
+/** How many errors of a chain of causes a logger writes: the first and seven causes. */
+const DEEPEST_CAUSE = 8;
+class ParcelLost extends DomainError {
+    code = 'PARCEL_LOST';
+}
+/** An error passed as a field, and the flush that ends the life of a logger. */
+export class LoggerShutdownSuite extends ContractSuite {
+    createLogger;
+    constructor(runner, createLogger) {
+        super(runner, () => createLogger({ level: 'debug', scrubMessages: false, fields: () => ({}) }));
+        this.createLogger = createLogger;
+    }
+    tests() {
+        this.describes();
+        this.boundsTheCauses();
+        this.scrubs();
+        this.flushes();
+    }
+    describes() {
+        this.it('writes an error passed as a field as its class, its message and its own stack, then its cause', async () => {
+            const failure = new RangeError('weight out of range', { cause: new TypeError('socket closed') });
+            this.subject.logger.error('carrier failed', { error: failure });
+            this.subject.logger.child({ lastFailure: failure }).warn('retrying');
+            const [failed, retrying] = await this.subject.lines();
+            const cause = {
+                type: 'TypeError',
+                code: undefined,
+                message: 'socket closed',
+                stack: 'titled',
+                cause: undefined,
+            };
+            const described = {
+                type: 'RangeError',
+                code: undefined,
+                message: 'weight out of range',
+                stack: 'titled',
+                cause,
+            };
+            this.expect(errorOutlineOf(failed?.fields.error)).toEqual(described);
+            this.expect(errorOutlineOf(retrying?.fields.lastFailure)).toEqual(described);
+        });
+    }
+    boundsTheCauses() {
+        this.it('writes the code of a DomainError, and stops at a chain of causes that loops', async () => {
+            const refusal = new ParcelLost('Parcel parcel-1 is lost');
+            refusal.cause = refusal;
+            this.subject.logger.warn('delivery refused', { error: refusal });
+            const [line] = await this.subject.lines();
+            let depth = 0;
+            for (let one = errorOutlineOf(line?.fields.error); one !== undefined; one = one.cause) {
+                depth += 1;
+            }
+            this.expect(errorOutlineOf(line?.fields.error)?.code).toBe('PARCEL_LOST');
+            this.expect(depth).toBe(DEEPEST_CAUSE);
+        });
+    }
+    scrubs() {
+        this.it('replaces the message of an unexpected error when it scrubs, in its stack too, and keeps the one of a DomainError', async () => {
+            const subject = await this.createLogger({ level: 'debug', scrubMessages: true, fields: () => ({}) });
+            const refusal = new ParcelLost('Parcel parcel-1 is lost', {
+                cause: new Error('row (ada@example.org) refused'),
+            });
+            subject.logger.error('delivery failed', { error: refusal });
+            const [line] = await subject.lines();
+            this.expect(errorOutlineOf(line?.fields.error)).toEqual({
+                type: 'ParcelLost',
+                code: 'PARCEL_LOST',
+                message: 'Parcel parcel-1 is lost',
+                stack: 'titled',
+                cause: { type: 'Error', code: undefined, message: SCRUBBED_MESSAGE, stack: 'frames', cause: undefined },
+            });
+        });
+    }
+    flushes() {
+        this.it('has handed every entry to its sink once the flush resolves, and takes what follows without a throw', async () => {
+            const shipping = this.subject.logger.child({ context: 'shipping' });
+            this.subject.logger.info('order shipped');
+            shipping.warn('carrier slow');
+            await this.subject.logger.flush();
+            this.expect((await this.subject.lines()).map(({ message }) => message)).toEqual([
+                'order shipped',
+                'carrier slow',
+            ]);
+            this.subject.logger.error('logged after the flush');
+            shipping.info('logged after the flush');
+            shipping.isLevelEnabled('info');
+            await shipping.flush();
+            this.expect((await this.subject.lines()).slice(0, 2).map(({ message }) => message)).toEqual([
+                'order shipped',
+                'carrier slow',
+            ]);
+        });
+    }
+}
+//# sourceMappingURL=logger-shutdown-suite.js.map

package/dist/contracts/logger/logger-shutdown-suite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-shutdown-suite.js","sourceRoot":"","sources":["../../../src/contracts/logger/logger-shutdown-suite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEnE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,wFAAwF;AACxF,MAAM,aAAa,GAAG,CAAC,CAAC;AAExB,MAAM,UAAW,SAAQ,WAAW;IACzB,IAAI,GAAG,aAAa,CAAC;CAC/B;AAED,gFAAgF;AAChF,MAAM,OAAO,mBAAoB,SAAQ,aAAkC;IAGtD,YAAY;IAF/B,YACE,MAAsB,EACL,YAA0B;QAE3C,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;4BAF/E,YAAY;IAG/B,CAAC;IAES,KAAK;QACb,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,IAAI,CAAC,eAAe,EAAE,CAAC;QACvB,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAEO,SAAS;QACf,IAAI,CAAC,EAAE,CACL,+FAA+F,EAC/F,KAAK,IAAI,EAAE;YACT,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC,qBAAqB,EAAE,EAAE,KAAK,EAAE,IAAI,SAAS,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;YAEjG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YAChE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAErE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAEtD,MAAM,KAAK,GAAG;gBACZ,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,eAAe;gBACxB,KAAK,EAAE,QAAQ;gBACf,KAAK,EAAE,SAAS;aACjB,CAAC;YAEF,MAAM,SAAS,GAAG;gBAChB,IAAI,EAAE,YAAY;gBAClB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,qBAAqB;gBAC9B,KAAK,EAAE,QAAQ;gBACf,KAAK;aACN,CAAC;YAEF,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YACrE,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC/E,CAAC,CACF,CAAC;IACJ,CAAC;IAEO,eAAe;QACrB,IAAI,CAAC,EAAE,CAAC,6EAA6E,EAAE,KAAK,IAAI,EAAE;YAChG,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC,yBAAyB,CAAC,CAAC;YAE1D,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC;YACxB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YAEjE,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAC1C,IAAI,KAAK,GAAG,CAAC,CAAC;YAEd,KAAK,IAAI,GAAG,GAAG,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,KAAK,SAAS,EAAE,GAAG,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC;gBACtF,KAAK,IAAI,CAAC,CAAC;YACb,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAC1E,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,MAAM;QACZ,IAAI,CAAC,EAAE,CACL,kHAAkH,EAClH,KAAK,IAAI,EAAE;YACT,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YAErG,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC,yBAAyB,EAAE;gBACxD,KAAK,EAAE,IAAI,KAAK,CAAC,+BAA+B,CAAC;aAClD,CAAC,CAAC;YAEH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YAE5D,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;YAErC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;gBACtD,IAAI,EAAE,YAAY;gBAClB,IAAI,EAAE,aAAa;gBACnB,OAAO,EAAE,yBAAyB;gBAClC,KAAK,EAAE,QAAQ;gBACf,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE;aACxG,CAAC,CAAC;QACL,CAAC,CACF,CAAC;IACJ,CAAC;IAEO,OAAO;QACb,IAAI,CAAC,EAAE,CACL,oGAAoG,EACpG,KAAK,IAAI,EAAE;YACT,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;YAEpE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAC1C,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAE9B,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAElC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;gBAC9E,eAAe;gBACf,cAAc;aACf,CAAC,CAAC;YAEH,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;YACpD,QAAQ,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;YACxC,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;YAChC,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC;YAEvB,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;gBAC1F,eAAe;gBACf,cAAc;aACf,CAAC,CAAC;QACL,CAAC,CACF,CAAC;IACJ,CAAC;CACF"}

package/dist/contracts/logger/logger-under-contract.d.ts

@@ -0,0 +1,9 @@
+import type { Logger } from '@ddd-ts-kit/kernel';
+import type { Awaitable } from '../awaitable.js';
+import type { LoggedLine } from './logged-line.js';
+export interface LoggerUnderContract {
+    readonly logger: Logger;
+    /** What reached the sink so far, in order. The suite awaits `logger.flush()` before it reads what was written late. */
+    lines(): Awaitable<readonly LoggedLine[]>;
+}
+//# sourceMappingURL=logger-under-contract.d.ts.map

package/dist/contracts/logger/logger-under-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-under-contract.d.ts","sourceRoot":"","sources":["../../../src/contracts/logger/logger-under-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,uHAAuH;IACvH,KAAK,IAAI,SAAS,CAAC,SAAS,UAAU,EAAE,CAAC,CAAC;CAC3C"}

package/dist/contracts/logger/logger-under-contract.js

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

package/dist/contracts/logger/logger-under-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-under-contract.js","sourceRoot":"","sources":["../../../src/contracts/logger/logger-under-contract.ts"],"names":[],"mappings":""}

package/dist/contracts/logger/unreadable-total.d.ts

@@ -0,0 +1,5 @@
+/** An object whose only field throws when it is read. */
+export declare function unreadableTotal(): {
+    readonly total: number;
+};
+//# sourceMappingURL=unreadable-total.d.ts.map

package/dist/contracts/logger/unreadable-total.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unreadable-total.d.ts","sourceRoot":"","sources":["../../../src/contracts/logger/unreadable-total.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,wBAAgB,eAAe,IAAI;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAM5D"}

package/dist/contracts/logger/unreadable-total.js

@@ -0,0 +1,9 @@
+/** An object whose only field throws when it is read. */
+export function unreadableTotal() {
+    return {
+        get total() {
+            throw new Error('unreadable');
+        },
+    };
+}
+//# sourceMappingURL=unreadable-total.js.map

package/dist/contracts/logger/unreadable-total.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unreadable-total.js","sourceRoot":"","sources":["../../../src/contracts/logger/unreadable-total.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,MAAM,UAAU,eAAe;IAC7B,OAAO;QACL,IAAI,KAAK;YACP,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;QAChC,CAAC;KACF,CAAC;AACJ,CAAC"}