@cqrs-ddd/pipeline-deadletter 0.5.0

package/dist/helpers/build-record.js.map

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

package/dist/helpers/dead-letter.intent.d.ts

@@ -0,0 +1,18 @@
+import type { PipelineBehaviorTuple } from '@cqrs-ddd/pipeline';
+import { DeadLetterBehavior } from '../dead-letter.behavior.js';
+import type { DeadLetterBehaviorOptions } from '../interfaces/dead-letter-options.interface.js';
+export type DeadLetterIntentOptions = DeadLetterBehaviorOptions;
+/**
+ * Returns a dead-letter behavior entry for `pipeline.wrap()` or `createPipeline({ globalBehaviors })`.
+ * @param options Per-handler dead-letter options; omitted fields use behavior defaults.
+ * @returns The behavior class and options tuple.
+ * @example
+ * ```ts
+ * export const onUserCreated = pipeline.wrap(
+ *   { name: 'onUserCreated', kind: 'event' },
+ *   deadLetter({ redactKeys: ['refreshToken'], rethrow: false }),
+ * )(sendWelcomeEmail);
+ * ```
+ */
+export declare function deadLetter(options?: DeadLetterIntentOptions): PipelineBehaviorTuple<DeadLetterBehavior, DeadLetterBehaviorOptions>;
+//# sourceMappingURL=dead-letter.intent.d.ts.map

package/dist/helpers/dead-letter.intent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dead-letter.intent.d.ts","sourceRoot":"","sources":["../../src/helpers/dead-letter.intent.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gDAAgD,CAAC;AAEhG,MAAM,MAAM,uBAAuB,GAAG,yBAAyB,CAAC;AAEhE;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CACxB,OAAO,GAAE,uBAA4B,GACpC,qBAAqB,CAAC,kBAAkB,EAAE,yBAAyB,CAAC,CAEtE"}

package/dist/helpers/dead-letter.intent.js

@@ -0,0 +1,18 @@
+/* Copyright (C) 2026-present Aristotelis — see repository license. */
+import { DeadLetterBehavior } from '../dead-letter.behavior.js';
+/**
+ * Returns a dead-letter behavior entry for `pipeline.wrap()` or `createPipeline({ globalBehaviors })`.
+ * @param options Per-handler dead-letter options; omitted fields use behavior defaults.
+ * @returns The behavior class and options tuple.
+ * @example
+ * ```ts
+ * export const onUserCreated = pipeline.wrap(
+ *   { name: 'onUserCreated', kind: 'event' },
+ *   deadLetter({ redactKeys: ['refreshToken'], rethrow: false }),
+ * )(sendWelcomeEmail);
+ * ```
+ */
+export function deadLetter(options = {}) {
+    return [DeadLetterBehavior, options];
+}
+//# sourceMappingURL=dead-letter.intent.js.map

package/dist/helpers/dead-letter.intent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dead-letter.intent.js","sourceRoot":"","sources":["../../src/helpers/dead-letter.intent.ts"],"names":[],"mappings":"AAAA,sEAAsE;AAGtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAKhE;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CACxB,OAAO,GAA4B,EAAE;IAErC,OAAO,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC"}

package/dist/helpers/redrive-scope.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Runs `fn` as the redrive of dead letter `id`. Inside it, `DeadLetterBehavior`
+ * neither captures a failure again nor swallows it: the redriver records the
+ * attempt on the existing record instead.
+ */
+export declare function runAsRedrive<T>(id: string, fn: () => T): T;
+/** The id of the dead letter being redriven, if the current execution is a redrive. */
+export declare function currentRedriveId(): string | undefined;
+//# sourceMappingURL=redrive-scope.d.ts.map

package/dist/helpers/redrive-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redrive-scope.d.ts","sourceRoot":"","sources":["../../src/helpers/redrive-scope.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAE1D;AAED,uFAAuF;AACvF,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,SAAS,CAErD"}

package/dist/helpers/redrive-scope.js

@@ -0,0 +1,16 @@
+/* Copyright (C) 2026-present Aristotelis — see repository license. */
+import { AsyncLocalStorage } from 'node:async_hooks';
+const redriving = new AsyncLocalStorage();
+/**
+ * Runs `fn` as the redrive of dead letter `id`. Inside it, `DeadLetterBehavior`
+ * neither captures a failure again nor swallows it: the redriver records the
+ * attempt on the existing record instead.
+ */
+export function runAsRedrive(id, fn) {
+    return redriving.run(id, fn);
+}
+/** The id of the dead letter being redriven, if the current execution is a redrive. */
+export function currentRedriveId() {
+    return redriving.getStore();
+}
+//# sourceMappingURL=redrive-scope.js.map

package/dist/helpers/redrive-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redrive-scope.js","sourceRoot":"","sources":["../../src/helpers/redrive-scope.ts"],"names":[],"mappings":"AAAA,sEAAsE;AAEtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,SAAS,GAAG,IAAI,iBAAiB,EAAU,CAAC;AAElD;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAI,EAAU,EAAE,EAAW;IACrD,OAAO,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;AAC/B,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,gBAAgB;IAC9B,OAAO,SAAS,CAAC,QAAQ,EAAE,CAAC;AAC9B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export { DEFAULT_REDACT_KEYS, REDACTED, redactValue, } from '@cqrs-ddd/safe-stringify';
+export { DEAD_LETTER_ITEM, DEAD_LETTER_ITEM_TOKEN, DeadLetterBehavior, } from './dead-letter.behavior.js';
+export { type DeadLetterDispatch, type DeadLetterRedriveResult, DeadLetterRedriver, type DeadLetterRedriverOptions, } from './dead-letter.redriver.js';
+export { DeadLetterRedriveError } from './errors/dead-letter-redrive.error.js';
+export { buildDeadLetterAttributes } from './helpers/build-attributes.js';
+export { buildDeadLetterRecord } from './helpers/build-record.js';
+export { type DeadLetterIntentOptions, deadLetter, } from './helpers/dead-letter.intent.js';
+export type { DeadLetterBehaviorOptions, DeadLetterMetadataFactory, } from './interfaces/dead-letter-options.interface.js';
+export type { DeadLetterError, DeadLetterListFilter, DeadLetterRecord, DeadLetterRequestKind, DeadLetterStatus, DeadLetterStore, DeadLetterTransport, } from './interfaces/dead-letter-transport.interface.js';
+export { BullMqDeadLetterTransport, type BullMqDeadLetterTransportOptions, type BullMqQueueLike, } from './transports/bullmq.transport.js';
+export { createDeadLetterTableSql, PostgresDeadLetterTransport, type PostgresDeadLetterTransportOptions, type PostgresQueryableLike, } from './transports/postgres.transport.js';
+export { type RabbitMqConfirmChannelLike, RabbitMqDeadLetterTransport, type RabbitMqDeadLetterTransportOptions, } from './transports/rabbitmq.transport.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,mBAAmB,EACnB,QAAQ,EACR,WAAW,GACZ,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,kBAAkB,EAClB,KAAK,yBAAyB,GAC/B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EACL,KAAK,uBAAuB,EAC5B,UAAU,GACX,MAAM,iCAAiC,CAAC;AACzC,YAAY,EACV,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,+CAA+C,CAAC;AACvD,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,GACpB,MAAM,iDAAiD,CAAC;AACzD,OAAO,EACL,yBAAyB,EACzB,KAAK,gCAAgC,EACrC,KAAK,eAAe,GACrB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,KAAK,kCAAkC,EACvC,KAAK,qBAAqB,GAC3B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,KAAK,0BAA0B,EAC/B,2BAA2B,EAC3B,KAAK,kCAAkC,GACxC,MAAM,oCAAoC,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+/* Copyright (C) 2026-present Aristotelis — see repository license. */
+export { DEFAULT_REDACT_KEYS, REDACTED, redactValue, } from '@cqrs-ddd/safe-stringify';
+export { DEAD_LETTER_ITEM, DEAD_LETTER_ITEM_TOKEN, DeadLetterBehavior, } from './dead-letter.behavior.js';
+export { DeadLetterRedriver, } from './dead-letter.redriver.js';
+export { DeadLetterRedriveError } from './errors/dead-letter-redrive.error.js';
+export { buildDeadLetterAttributes } from './helpers/build-attributes.js';
+export { buildDeadLetterRecord } from './helpers/build-record.js';
+export { deadLetter, } from './helpers/dead-letter.intent.js';
+export { BullMqDeadLetterTransport, } from './transports/bullmq.transport.js';
+export { createDeadLetterTableSql, PostgresDeadLetterTransport, } from './transports/postgres.transport.js';
+export { RabbitMqDeadLetterTransport, } from './transports/rabbitmq.transport.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sEAAsE;AAEtE,OAAO,EACL,mBAAmB,EACnB,QAAQ,EACR,WAAW,GACZ,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAGL,kBAAkB,GAEnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAEL,UAAU,GACX,MAAM,iCAAiC,CAAC;AAczC,OAAO,EACL,yBAAyB,GAG1B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,wBAAwB,EACxB,2BAA2B,GAG5B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAEL,2BAA2B,GAE5B,MAAM,oCAAoC,CAAC"}

package/dist/interfaces/dead-letter-options.interface.d.ts

@@ -0,0 +1,70 @@
+import type { Constructor, IPipelineContext } from '@cqrs-ddd/pipeline';
+import type { DeadLetterRequestKind } from './dead-letter-transport.interface.js';
+/**
+ * Factory producing extra, request-aware metadata to attach to a dead letter
+ * (e.g. tenant id, user id, attempt count read from `context.items`).
+ */
+export type DeadLetterMetadataFactory = (context: IPipelineContext) => Record<string, unknown>;
+/**
+ * Per-handler (and constructor-default) options for {@link DeadLetterBehavior}.
+ *
+ * Supplied per handler via
+ * `pipeline.wrap(options, [DeadLetterBehavior, { ... }])`, shallow-merged over
+ * the constructor defaults (handler keys win), except that `ignoreErrors` and
+ * `redactKeys` set at both levels are combined.
+ *
+ * @example Fire-and-forget event capture
+ * ```ts
+ * class UserCreatedHandler {
+ *   @pipeline.wrap({ kind: 'event' }, [DeadLetterBehavior, {
+ *     captureKinds: ['event'],
+ *     rethrow: false,
+ *     redactKeys: ['token'],
+ *   }])
+ *   async handle(event: UserCreatedEvent) {}
+ * }
+ * ```
+ */
+export interface DeadLetterBehaviorOptions {
+    /**
+     * Whether to re-throw the original error after dead-lettering.
+     *
+     * - `true` (default) — propagate after the capture decision; the caller sees the
+     *   failure (HTTP 5xx, command rejection, …). Use for commands/queries.
+     * - `false` — on an **event** handler only, swallow the error when it is
+     *   captured and the transport delivers it; the pipeline then resolves to
+     *   `undefined` and the swallow is logged at `error` level with the record id.
+     *   On a command or query handler it is a contract diagnostic and is ignored.
+     */
+    rethrow?: boolean;
+    /**
+     * Include the error stack trace in the record. Default `true`.
+     * Set `false` to keep records lean or avoid leaking internals downstream.
+     */
+    includeStack?: boolean;
+    /**
+     * Request kinds to capture. Default `['event']`: a command's or query's
+     * caller already receives the error. Example: `['command', 'event']` to also
+     * keep failed commands.
+     */
+    captureKinds?: DeadLetterRequestKind[];
+    /**
+     * Filter predicate or error types to ignore.
+     * Matching errors are re-thrown without being sent to the dead-letter transport.
+     * Useful for ignoring expected client validation errors (e.g. ZodValidationError).
+     */
+    ignoreErrors?: Array<Constructor<unknown> | (abstract new (...args: never[]) => unknown)> | ((error: unknown, context: IPipelineContext) => boolean);
+    /** Produce extra metadata to merge into the dead-letter record. */
+    metadata?: DeadLetterMetadataFactory;
+    /**
+     * Custom redactor function for the captured request payload.
+     * When supplied, takes precedence over {@link redactKeys}.
+     */
+    redact?: (payload: unknown) => unknown;
+    /**
+     * Field names to mask with `[REDACTED]` in the captured request payload.
+     * Case-insensitive matching. Merged on top of {@link DEFAULT_REDACT_KEYS}.
+     */
+    redactKeys?: string[];
+}
+//# sourceMappingURL=dead-letter-options.interface.d.ts.map

package/dist/interfaces/dead-letter-options.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dead-letter-options.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/dead-letter-options.interface.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAElF;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAAG,CACtC,OAAO,EAAE,gBAAgB,KACtB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE7B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;;OAIG;IACH,YAAY,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAEvC;;;;OAIG;IACH,YAAY,CAAC,EACT,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC,CAAC,GAC1E,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,CAAC;IAE7D,mEAAmE;IACnE,QAAQ,CAAC,EAAE,yBAAyB,CAAC;IAErC;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC;IAEvC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB"}

package/dist/interfaces/dead-letter-options.interface.js

@@ -0,0 +1,3 @@
+/* Copyright (C) 2026-present Aristotelis — see repository license. */
+export {};
+//# sourceMappingURL=dead-letter-options.interface.js.map

package/dist/interfaces/dead-letter-options.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dead-letter-options.interface.js","sourceRoot":"","sources":["../../src/interfaces/dead-letter-options.interface.ts"],"names":[],"mappings":"AAAA,sEAAsE"}

package/dist/interfaces/dead-letter-transport.interface.d.ts

@@ -0,0 +1,103 @@
+/** Request kinds as classified by the pipeline. */
+export type DeadLetterRequestKind = 'command' | 'query' | 'event' | 'unknown';
+/** Lifecycle of a dead letter. */
+export type DeadLetterStatus = 'open' | 'resolved';
+/** Serializable description of the failure that produced a dead letter. */
+export interface DeadLetterError {
+    /** Error class name (e.g. `TimeoutError`), or `'unknown'` for non-Error throws. */
+    name: string;
+    /** Error message. */
+    message: string;
+    /** Stack trace, unless suppressed via `includeStack: false`. */
+    stack?: string;
+}
+/**
+ * A single dead-letter record for a pipeline request that failed (after any
+ * retries) and was forwarded to a
+ * {@link DeadLetterTransport} for inspection / replay.
+ *
+ * The shape is transport-neutral, but `payload` and `metadata` are supplied by
+ * the application and must satisfy the configured transport's serialization
+ * requirements.
+ */
+export interface DeadLetterRecord {
+    /**
+     * Unique id of this dead letter (UUIDv7, so ids sort in capture order), used
+     * to redrive or resolve it.
+     */
+    id: string;
+    /** Correlation ID of the failed pipeline run (for cross-system tracing). */
+    correlationId: string;
+    /** Active tenant identifier if execution occurred within a multi-tenant context. */
+    tenantId?: string;
+    /** Whether the failed request was a command, query, event, or unknown. */
+    requestKind: DeadLetterRequestKind;
+    /** Request class name, e.g. `CreateUserCommand`. */
+    requestName: string;
+    /** Handler class name, e.g. `CreateUserHandler`. */
+    handlerName: string;
+    /** The original request payload (the command/query/event instance). */
+    payload: unknown;
+    /** Details of the error that caused the failure. */
+    error: DeadLetterError;
+    /** ISO-8601 timestamp of when the dead letter was produced. */
+    failedAt: string;
+    /** Metadata from the `metadata` factory, plus `tenantId` when present. */
+    metadata?: Record<string, unknown>;
+    /** Redrive attempts made so far; `0` when captured. */
+    attempts: number;
+    /** `'open'` until a redrive succeeds or it is resolved by hand. */
+    status: DeadLetterStatus;
+    /**
+     * `true` when redaction changed the payload (or a custom `redact` ran): the
+     * stored payload is not the original request, so it is not redriven as is.
+     */
+    payloadRedacted: boolean;
+    /** Error of the last failed redrive attempt, if any. */
+    lastError?: DeadLetterError;
+    /** ISO-8601 timestamp of when the record was resolved. */
+    resolvedAt?: string;
+}
+/**
+ * Transport-agnostic sink for dead letters.
+ *
+ * Implement this once per backend; the bundled implementations are
+ * {@link BullMqDeadLetterTransport}, {@link RabbitMqDeadLetterTransport},
+ * and {@link PostgresDeadLetterTransport}. Because the {@link DeadLetterBehavior}
+ * depends only on this interface, swapping the backend is a one-line change:
+ * the transport passed to its constructor.
+ */
+export interface DeadLetterTransport {
+    /**
+     * Persist / publish a single dead-letter record.
+     *
+     * Implementations should be resilient and fast; a throw here is caught by the
+     * behavior and logged, but never masks the original handler error.
+     *
+     * @param record - The failed request snapshot to forward.
+     */
+    send(record: DeadLetterRecord): Promise<void>;
+}
+/** Filter for {@link DeadLetterStore.list}. */
+export interface DeadLetterListFilter {
+    status?: DeadLetterStatus;
+    requestName?: string;
+    /** Most records to return, oldest first. Default `100`. */
+    limit?: number;
+}
+/**
+ * A transport that also keeps its records, so they can be listed, redriven
+ * with {@link DeadLetterRedriver}, and resolved. `PostgresDeadLetterTransport`
+ * implements it; queue transports rely on their broker's own dead-letter tooling.
+ */
+export interface DeadLetterStore extends DeadLetterTransport {
+    /** The record with this id, or `undefined`. */
+    get(id: string): Promise<DeadLetterRecord | undefined>;
+    /** Records matching the filter, oldest first. */
+    list(filter?: DeadLetterListFilter): Promise<DeadLetterRecord[]>;
+    /** Counts one failed redrive attempt and keeps its error. */
+    recordAttempt(id: string, error: DeadLetterError): Promise<void>;
+    /** Closes the record. */
+    markResolved(id: string): Promise<void>;
+}
+//# sourceMappingURL=dead-letter-transport.interface.d.ts.map

package/dist/interfaces/dead-letter-transport.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dead-letter-transport.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/dead-letter-transport.interface.ts"],"names":[],"mappings":"AAEA,mDAAmD;AACnD,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;AAE9E,kCAAkC;AAClC,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,UAAU,CAAC;AAEnD,2EAA2E;AAC3E,MAAM,WAAW,eAAe;IAC9B,mFAAmF;IACnF,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,EAAE,EAAE,MAAM,CAAC;IACX,4EAA4E;IAC5E,aAAa,EAAE,MAAM,CAAC;IACtB,oFAAoF;IACpF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,WAAW,EAAE,qBAAqB,CAAC;IACnC,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,OAAO,EAAE,OAAO,CAAC;IACjB,oDAAoD;IACpD,KAAK,EAAE,eAAe,CAAC;IACvB,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,MAAM,EAAE,gBAAgB,CAAC;IACzB;;;OAGG;IACH,eAAe,EAAE,OAAO,CAAC;IACzB,wDAAwD;IACxD,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;;OAOG;IACH,IAAI,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED,+CAA+C;AAC/C,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAgB,SAAQ,mBAAmB;IAC1D,+CAA+C;IAC/C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAC;IACvD,iDAAiD;IACjD,IAAI,CAAC,MAAM,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IACjE,6DAA6D;IAC7D,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,yBAAyB;IACzB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC"}

package/dist/interfaces/dead-letter-transport.interface.js

@@ -0,0 +1,3 @@
+/* Copyright (C) 2026-present Aristotelis — see repository license. */
+export {};
+//# sourceMappingURL=dead-letter-transport.interface.js.map

package/dist/interfaces/dead-letter-transport.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dead-letter-transport.interface.js","sourceRoot":"","sources":["../../src/interfaces/dead-letter-transport.interface.ts"],"names":[],"mappings":"AAAA,sEAAsE"}

package/dist/transports/bullmq.transport.d.ts

@@ -0,0 +1,43 @@
+import type { DeadLetterRecord, DeadLetterTransport } from '../interfaces/dead-letter-transport.interface.js';
+/**
+ * Minimal structural shape of a BullMQ `Queue`. Declared locally so this package
+ * does not hard-depend on `bullmq` — a real `Queue` satisfies it. Add the queue
+ * as a peer in your app: `pnpm add bullmq`.
+ */
+export interface BullMqQueueLike {
+    add(name: string, data: unknown, opts?: unknown): Promise<unknown>;
+}
+/** Options for {@link BullMqDeadLetterTransport}. */
+export interface BullMqDeadLetterTransportOptions {
+    /** Job name added to the queue for each dead letter. Default `'dead-letter'`. */
+    jobName?: string;
+    /**
+     * BullMQ `JobsOptions` for the dead-letter job. Defaults keep failures
+     * inspectable: `{ removeOnComplete: false, removeOnFail: false, attempts: 1 }`.
+     */
+    jobOptions?: unknown;
+}
+/**
+ * Bundled {@link DeadLetterTransport} backed by a **BullMQ** queue.
+ *
+ * Each dead letter is added as a job; a worker (or Bull Board) can then inspect,
+ * alert on, or replay it. The constructor takes any object matching
+ * {@link BullMqQueueLike}, so a real `bullmq` `Queue` works directly. Nothing
+ * selects this transport implicitly; pass an instance to the
+ * {@link DeadLetterBehavior} constructor.
+ *
+ * @example
+ * ```ts
+ * import { Queue } from 'bullmq';
+ * const queue = new Queue('dead-letters', { connection: { host, port } });
+ * const transport = new BullMqDeadLetterTransport(queue);
+ * ```
+ */
+export declare class BullMqDeadLetterTransport implements DeadLetterTransport {
+    private readonly queue;
+    private readonly jobName;
+    private readonly jobOptions;
+    constructor(queue: BullMqQueueLike, options?: BullMqDeadLetterTransportOptions);
+    send(record: DeadLetterRecord): Promise<void>;
+}
+//# sourceMappingURL=bullmq.transport.d.ts.map

package/dist/transports/bullmq.transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bullmq.transport.d.ts","sourceRoot":"","sources":["../../src/transports/bullmq.transport.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,kDAAkD,CAAC;AAE1D;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpE;AAED,qDAAqD;AACrD,MAAM,WAAW,gCAAgC;IAC/C,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAQD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,yBAA0B,YAAW,mBAAmB;IAKjE,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IAErC,YACmB,KAAK,EAAE,eAAe,EACvC,OAAO,GAAE,gCAAqC,EAI/C;IAEK,IAAI,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAElD;CACF"}

package/dist/transports/bullmq.transport.js

@@ -0,0 +1,36 @@
+/* Copyright (C) 2026-present Aristotelis — see repository license. */
+const DEFAULT_JOB_OPTIONS = {
+    removeOnComplete: false,
+    removeOnFail: false,
+    attempts: 1,
+};
+/**
+ * Bundled {@link DeadLetterTransport} backed by a **BullMQ** queue.
+ *
+ * Each dead letter is added as a job; a worker (or Bull Board) can then inspect,
+ * alert on, or replay it. The constructor takes any object matching
+ * {@link BullMqQueueLike}, so a real `bullmq` `Queue` works directly. Nothing
+ * selects this transport implicitly; pass an instance to the
+ * {@link DeadLetterBehavior} constructor.
+ *
+ * @example
+ * ```ts
+ * import { Queue } from 'bullmq';
+ * const queue = new Queue('dead-letters', { connection: { host, port } });
+ * const transport = new BullMqDeadLetterTransport(queue);
+ * ```
+ */
+export class BullMqDeadLetterTransport {
+    queue;
+    jobName;
+    jobOptions;
+    constructor(queue, options = {}) {
+        this.queue = queue;
+        this.jobName = options.jobName ?? 'dead-letter';
+        this.jobOptions = options.jobOptions ?? DEFAULT_JOB_OPTIONS;
+    }
+    async send(record) {
+        await this.queue.add(this.jobName, record, this.jobOptions);
+    }
+}
+//# sourceMappingURL=bullmq.transport.js.map

package/dist/transports/bullmq.transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bullmq.transport.js","sourceRoot":"","sources":["../../src/transports/bullmq.transport.ts"],"names":[],"mappings":"AAAA,sEAAsE;AA2BtE,MAAM,mBAAmB,GAAG;IAC1B,gBAAgB,EAAE,KAAK;IACvB,YAAY,EAAE,KAAK;IACnB,QAAQ,EAAE,CAAC;CACZ,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,yBAAyB;IAKjB,KAAK;IAJP,OAAO,CAAS;IAChB,UAAU,CAAU;IAErC,YACmB,KAAsB,EACvC,OAAO,GAAqC,EAAE;qBAD7B,KAAK;QAGtB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,aAAa,CAAC;QAChD,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,mBAAmB,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAwB;QACjC,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9D,CAAC;CACF"}

package/dist/transports/postgres.transport.d.ts

@@ -0,0 +1,51 @@
+import type { DeadLetterError, DeadLetterListFilter, DeadLetterRecord, DeadLetterStore } from '../interfaces/dead-letter-transport.interface.js';
+/**
+ * Minimal structural shape of a `pg` `Pool` / `Client`. Declared locally so this
+ * package does not hard-depend on `pg` — a real `Pool` or `Client` satisfies it.
+ * Add it in your app: `pnpm add pg`.
+ */
+export interface PostgresQueryableLike {
+    query(text: string, values?: unknown[]): Promise<unknown>;
+}
+/** Options for {@link PostgresDeadLetterTransport}. */
+export interface PostgresDeadLetterTransportOptions {
+    /**
+     * Destination table, optionally schema-qualified (e.g. `audit.dead_letters`).
+     * Default `'dead_letters'`. Validated as a safe SQL identifier.
+     */
+    table?: string;
+}
+/**
+ * SQL to create the dead-letter table. Run once in a migration.
+ *
+ * @param table - Table name (validated). Default `'dead_letters'`.
+ */
+export declare function createDeadLetterTableSql(table?: string): string;
+/**
+ * {@link DeadLetterStore} backed by **Postgres** (`pg`): inserts each dead
+ * letter as a row and keeps it, so it can be listed, redriven with
+ * `DeadLetterRedriver`, and resolved. Create the table once with
+ * {@link createDeadLetterTableSql}.
+ *
+ * The table name is validated as a plain SQL identifier (it is interpolated,
+ * not parameterized); all values are bound parameters.
+ *
+ * @example
+ * ```ts
+ * await pool.query(createDeadLetterTableSql());
+ * const store = new PostgresDeadLetterTransport(pool);
+ * const open = await store.list({ status: 'open' });
+ * ```
+ */
+export declare class PostgresDeadLetterTransport implements DeadLetterStore {
+    private readonly db;
+    private readonly table;
+    constructor(db: PostgresQueryableLike, options?: PostgresDeadLetterTransportOptions);
+    send(record: DeadLetterRecord): Promise<void>;
+    get(id: string): Promise<DeadLetterRecord | undefined>;
+    list(filter?: DeadLetterListFilter): Promise<DeadLetterRecord[]>;
+    recordAttempt(id: string, error: DeadLetterError): Promise<void>;
+    markResolved(id: string): Promise<void>;
+    private rows;
+}
+//# sourceMappingURL=postgres.transport.d.ts.map

package/dist/transports/postgres.transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.transport.d.ts","sourceRoot":"","sources":["../../src/transports/postgres.transport.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EAChB,MAAM,kDAAkD,CAAC;AAE1D;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3D;AAED,uDAAuD;AACvD,MAAM,WAAW,kCAAkC;IACjD;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAeD;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,SAAiB,GAAG,MAAM,CAkBvE;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,2BAA4B,YAAW,eAAe;IAI/D,OAAO,CAAC,QAAQ,CAAC,EAAE;IAHrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B,YACmB,EAAE,EAAE,qBAAqB,EAC1C,OAAO,GAAE,kCAAuC,EAGjD;IAEK,IAAI,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBlD;IAEK,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAK3D;IAEK,IAAI,CAAC,MAAM,GAAE,oBAAyB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CASzE;IAEK,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAKrE;IAEK,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAK5C;YAEa,IAAI;CASnB"}

package/dist/transports/postgres.transport.js

@@ -0,0 +1,125 @@
+/* Copyright (C) 2026-present Aristotelis — see repository license. */
+import { toPostgresJson } from '@cqrs-ddd/pipeline';
+/** Allows `table` or `schema.table` made of unquoted SQL identifiers only. */
+const SAFE_IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*(\.[A-Za-z_][A-Za-z0-9_]*)?$/;
+function assertSafeTable(table) {
+    if (!SAFE_IDENTIFIER.test(table)) {
+        throw new Error(`Invalid dead-letter table name "${table}". ` +
+            'Use an unquoted identifier like "dead_letters" or "schema.dead_letters".');
+    }
+    return table;
+}
+/**
+ * SQL to create the dead-letter table. Run once in a migration.
+ *
+ * @param table - Table name (validated). Default `'dead_letters'`.
+ */
+export function createDeadLetterTableSql(table = 'dead_letters') {
+    const name = assertSafeTable(table);
+    return `CREATE TABLE IF NOT EXISTS ${name} (
+  id              UUID        PRIMARY KEY,
+  correlation_id  TEXT        NOT NULL,
+  request_kind    TEXT        NOT NULL,
+  request_name    TEXT        NOT NULL,
+  handler_name    TEXT        NOT NULL,
+  payload         JSONB       NOT NULL,
+  error           JSONB       NOT NULL,
+  metadata        JSONB,
+  failed_at       TIMESTAMPTZ NOT NULL,
+  attempts        INTEGER     NOT NULL DEFAULT 0,
+  status          TEXT        NOT NULL DEFAULT 'open',
+  payload_redacted BOOLEAN    NOT NULL DEFAULT false,
+  last_error      JSONB,
+  resolved_at     TIMESTAMPTZ
+);`;
+}
+/**
+ * {@link DeadLetterStore} backed by **Postgres** (`pg`): inserts each dead
+ * letter as a row and keeps it, so it can be listed, redriven with
+ * `DeadLetterRedriver`, and resolved. Create the table once with
+ * {@link createDeadLetterTableSql}.
+ *
+ * The table name is validated as a plain SQL identifier (it is interpolated,
+ * not parameterized); all values are bound parameters.
+ *
+ * @example
+ * ```ts
+ * await pool.query(createDeadLetterTableSql());
+ * const store = new PostgresDeadLetterTransport(pool);
+ * const open = await store.list({ status: 'open' });
+ * ```
+ */
+export class PostgresDeadLetterTransport {
+    db;
+    table;
+    constructor(db, options = {}) {
+        this.db = db;
+        this.table = assertSafeTable(options.table ?? 'dead_letters');
+    }
+    async send(record) {
+        await this.db.query(`INSERT INTO ${this.table}
+        (id, correlation_id, request_kind, request_name, handler_name, payload,
+         error, metadata, failed_at, attempts, status, payload_redacted)
+        VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12)`, [
+            record.id,
+            record.correlationId,
+            record.requestKind,
+            record.requestName,
+            record.handlerName,
+            json(record.payload ?? null),
+            json(record.error),
+            record.metadata ? json(record.metadata) : null,
+            record.failedAt,
+            record.attempts,
+            record.status,
+            record.payloadRedacted,
+        ]);
+    }
+    async get(id) {
+        const rows = await this.rows(`SELECT * FROM ${this.table} WHERE id = $1`, [
+            id,
+        ]);
+        return rows[0];
+    }
+    async list(filter = {}) {
+        return this.rows(`SELECT * FROM ${this.table}
+        WHERE ($1::text IS NULL OR status = $1)
+          AND ($2::text IS NULL OR request_name = $2)
+        ORDER BY id
+        LIMIT $3`, [filter.status ?? null, filter.requestName ?? null, filter.limit ?? 100]);
+    }
+    async recordAttempt(id, error) {
+        await this.db.query(`UPDATE ${this.table} SET attempts = attempts + 1, last_error = $2 WHERE id = $1`, [id, json(error)]);
+    }
+    async markResolved(id) {
+        await this.db.query(`UPDATE ${this.table} SET status = 'resolved', resolved_at = now() WHERE id = $1`, [id]);
+    }
+    async rows(sql, values) {
+        const result = (await this.db.query(sql, values));
+        return (result.rows ?? []).map(toRecord);
+    }
+}
+function json(value) {
+    return toPostgresJson(JSON.stringify(value));
+}
+function toRecord(row) {
+    const tenantId = row.metadata?.tenantId;
+    return {
+        id: row.id,
+        correlationId: row.correlation_id,
+        ...(typeof tenantId === 'string' ? { tenantId } : {}),
+        requestKind: row.request_kind,
+        requestName: row.request_name,
+        handlerName: row.handler_name,
+        payload: row.payload,
+        error: row.error,
+        failedAt: row.failed_at.toISOString(),
+        ...(row.metadata ? { metadata: row.metadata } : {}),
+        attempts: row.attempts,
+        status: row.status,
+        payloadRedacted: row.payload_redacted,
+        ...(row.last_error ? { lastError: row.last_error } : {}),
+        ...(row.resolved_at ? { resolvedAt: row.resolved_at.toISOString() } : {}),
+    };
+}
+//# sourceMappingURL=postgres.transport.js.map

package/dist/transports/postgres.transport.js.map

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