@kronos-ts/typeorm 0.1.3 → 0.2.0

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 export { typeormTransactionManager, type TypeOrmDataSourceLike, type TypeOrmTransaction, } from "./typeorm-transaction-manager.js";
 export { typeormTokenStore, type TypeOrmManagerLike, } from "./typeorm-token-store.js";
+export { typeormDeadLetterQueue, type TypeOrmDeadLetterQueueConfig, } from "./typeorm-dead-letter-queue.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,GACxB,MAAM,kCAAkC,CAAA;AAEzC,OAAO,EACL,iBAAiB,EACjB,KAAK,kBAAkB,GACxB,MAAM,0BAA0B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,GACxB,MAAM,kCAAkC,CAAA;AAEzC,OAAO,EACL,iBAAiB,EACjB,KAAK,kBAAkB,GACxB,MAAM,0BAA0B,CAAA;AAEjC,OAAO,EACL,sBAAsB,EACtB,KAAK,4BAA4B,GAClC,MAAM,gCAAgC,CAAA"}

package/dist/index.js

@@ -1,3 +1,4 @@
 export { typeormTransactionManager, } from "./typeorm-transaction-manager.js";
 export { typeormTokenStore, } from "./typeorm-token-store.js";
+export { typeormDeadLetterQueue, } from "./typeorm-dead-letter-queue.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,GAG1B,MAAM,kCAAkC,CAAA;AAEzC,OAAO,EACL,iBAAiB,GAElB,MAAM,0BAA0B,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,GAG1B,MAAM,kCAAkC,CAAA;AAEzC,OAAO,EACL,iBAAiB,GAElB,MAAM,0BAA0B,CAAA;AAEjC,OAAO,EACL,sBAAsB,GAEvB,MAAM,gCAAgC,CAAA"}

package/dist/typeorm-dead-letter-queue.d.ts

@@ -0,0 +1,77 @@
+import type { SequencedDeadLetterQueue } from "@kronos-ts/messaging";
+import type { TypeOrmManagerLike } from "./typeorm-token-store.js";
+/**
+ * Persistent {@link SequencedDeadLetterQueue} backed by TypeORM — a faithful
+ * translation of the Drizzle reference implementation to TypeORM's raw-SQL
+ * query style (`manager.query(sql, params)`), mirroring {@link typeormTokenStore}.
+ *
+ * Like {@link typeormTokenStore} it reads the active transaction via
+ * `getActiveTransaction()`, so enqueue/evict/requeue commit in the **same
+ * transaction as the token update** — a crash cannot advance the processor's
+ * token while losing the parked letter.
+ *
+ * The table is shared across processors and partitioned by `processingGroup`.
+ * Per-sequence FIFO order is held by a monotonic `sequence_index`; a
+ * `processing_started` lease column makes `process()` safe across multiple
+ * nodes (Axon parity).
+ *
+ * Expected table (`kronos_dead_letters`). Users may define this entity:
+ *
+ * ```typescript
+ * @Entity("kronos_dead_letters")
+ * export class KronosDeadLetterEntry {
+ *   @PrimaryColumn({ name: "dead_letter_id" }) deadLetterId: string
+ *   @Column({ name: "processing_group" }) processingGroup: string
+ *   @Column({ name: "sequence_identifier" }) sequenceIdentifier: string
+ *   @Column({ name: "sequence_index" }) sequenceIndex: number
+ *   @Column({ type: "text" }) message: string
+ *   @Column({ name: "cause_type", nullable: true }) causeType: string | null
+ *   @Column({ name: "cause_message", type: "text", nullable: true }) causeMessage: string | null
+ *   @Column({ type: "text" }) diagnostics: string
+ *   @Column({ name: "enqueued_at" }) enqueuedAt: string
+ *   @Column({ name: "last_touched" }) lastTouched: string
+ *   @Column({ name: "processing_started", nullable: true }) processingStarted: string | null
+ * }
+ * ```
+ *
+ * Column set:
+ * - `dead_letter_id`     (PK)        — opaque persistent row id.
+ * - `processing_group`               — the processor name; partitions the table.
+ * - `sequence_identifier`            — the per-sequence FIFO key.
+ * - `sequence_index`     (int)       — monotonic ordering within a sequence.
+ * - `message`            (text)      — the {@link EventMessage} serialized as JSON.
+ * - `cause_type`         (nullable)  — `Error.name` of the failure cause.
+ * - `cause_message`      (text, null)— `Error.message` of the failure cause.
+ * - `diagnostics`        (text)      — diagnostics map serialized as JSON.
+ * - `enqueued_at`                    — epoch-ms timestamp as a string.
+ * - `last_touched`                   — epoch-ms timestamp as a string.
+ * - `processing_started` (nullable)  — epoch-ms lease timestamp as a string.
+ */
+export interface TypeOrmDeadLetterQueueConfig {
+    /** Processing group (the processor name) this queue serves. */
+    processingGroup: string;
+    /** Table name. Default: "kronos_dead_letters". */
+    tableName?: string;
+    /** Maximum number of sequences. Default: 1024 (Axon parity). */
+    maxSequences?: number;
+    /** Maximum letters per sequence. Default: 1024 (Axon parity). */
+    maxSequenceSize?: number;
+    /** Lease duration for in-flight processing, ms. Default: 30000 (Axon parity). */
+    claimDurationMs?: number;
+}
+/**
+ * Creates a {@link SequencedDeadLetterQueue} backed by TypeORM.
+ *
+ * Uses raw SQL queries via the EntityManager for maximum compatibility.
+ * Participates in the active transaction via `getActiveTransaction()`.
+ *
+ * ```typescript
+ * import { typeormDeadLetterQueue } from "@kronos-ts/typeorm"
+ *
+ * const dlq = typeormDeadLetterQueue(dataSource.manager, {
+ *   processingGroup: "my-processor",
+ * })
+ * ```
+ */
+export declare function typeormDeadLetterQueue(manager: TypeOrmManagerLike, config: TypeOrmDeadLetterQueueConfig): SequencedDeadLetterQueue;
+//# sourceMappingURL=typeorm-dead-letter-queue.d.ts.map

package/dist/typeorm-dead-letter-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeorm-dead-letter-queue.d.ts","sourceRoot":"","sources":["../src/typeorm-dead-letter-queue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA+B,wBAAwB,EAAE,MAAM,sBAAsB,CAAA;AAGjG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAElE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,MAAM,WAAW,4BAA4B;IAC3C,+DAA+D;IAC/D,eAAe,EAAE,MAAM,CAAA;IACvB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,iEAAiE;IACjE,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,iFAAiF;IACjF,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAYD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE,4BAA4B,GACnC,wBAAwB,CA2O1B"}

package/dist/typeorm-dead-letter-queue.js

@@ -0,0 +1,215 @@
+import { getActiveTransaction, DeadLetterQueueOverflowError } from "@kronos-ts/messaging";
+/** Reserved diagnostics key carrying the persistent row id across read → evict/requeue. */
+const DL_ID = "__dlqId";
+let idCounter = 0;
+function newId(group) {
+    // Unique within the table: time + per-process counter + group.
+    idCounter += 1;
+    return `${group}:${Date.now()}:${idCounter}`;
+}
+/**
+ * Creates a {@link SequencedDeadLetterQueue} backed by TypeORM.
+ *
+ * Uses raw SQL queries via the EntityManager for maximum compatibility.
+ * Participates in the active transaction via `getActiveTransaction()`.
+ *
+ * ```typescript
+ * import { typeormDeadLetterQueue } from "@kronos-ts/typeorm"
+ *
+ * const dlq = typeormDeadLetterQueue(dataSource.manager, {
+ *   processingGroup: "my-processor",
+ * })
+ * ```
+ */
+export function typeormDeadLetterQueue(manager, config) {
+    const { processingGroup } = config;
+    const table = config.tableName ?? "kronos_dead_letters";
+    const maxSequences = config.maxSequences ?? 1024;
+    const maxSequenceSize = config.maxSequenceSize ?? 1024;
+    const claimDurationMs = config.claimDurationMs ?? 30000;
+    function getManager() {
+        return getActiveTransaction() ?? manager;
+    }
+    function rowToLetter(row) {
+        const cause = new Error(row.cause_message ?? "");
+        if (row.cause_type)
+            cause.name = row.cause_type;
+        return {
+            message: JSON.parse(row.message),
+            cause,
+            enqueuedAt: Number(row.enqueued_at),
+            lastTouched: Number(row.last_touched),
+            diagnostics: { ...JSON.parse(row.diagnostics), [DL_ID]: row.dead_letter_id },
+            sequenceIdentifier: row.sequence_identifier,
+        };
+    }
+    async function sequenceRows(m, seqId) {
+        return m.query(`SELECT dead_letter_id, processing_group, sequence_identifier, sequence_index,
+              message, cause_type, cause_message, diagnostics,
+              enqueued_at, last_touched, processing_started
+       FROM ${table}
+       WHERE processing_group = $1 AND sequence_identifier = $2
+       ORDER BY sequence_index ASC`, [processingGroup, seqId]);
+    }
+    async function distinctSequences(m) {
+        const rows = await m.query(`SELECT DISTINCT sequence_identifier FROM ${table} WHERE processing_group = $1`, [processingGroup]);
+        return rows.map((r) => r.sequence_identifier);
+    }
+    async function insertLetter(m, letter, sequenceIndex, deadLetterId) {
+        const { [DL_ID]: _omit, ...diagnostics } = letter.diagnostics;
+        await m.query(`INSERT INTO ${table}
+         (dead_letter_id, processing_group, sequence_identifier, sequence_index,
+          message, cause_type, cause_message, diagnostics,
+          enqueued_at, last_touched, processing_started)
+       VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, NULL)`, [
+            deadLetterId,
+            processingGroup,
+            letter.sequenceIdentifier,
+            sequenceIndex,
+            JSON.stringify(letter.message),
+            letter.cause.name,
+            letter.cause.message,
+            JSON.stringify(diagnostics),
+            String(letter.enqueuedAt),
+            String(letter.lastTouched),
+        ]);
+    }
+    return {
+        async enqueue(letter) {
+            const m = getManager();
+            const existing = await sequenceRows(m, letter.sequenceIdentifier);
+            if (existing.length === 0) {
+                if ((await distinctSequences(m)).length >= maxSequences) {
+                    throw new DeadLetterQueueOverflowError(`max sequences ${maxSequences} reached`);
+                }
+            }
+            else if (existing.length >= maxSequenceSize) {
+                throw new DeadLetterQueueOverflowError(`sequence "${letter.sequenceIdentifier}" has reached max size ${maxSequenceSize}`);
+            }
+            const idx = existing.length === 0 ? 0 : Number(existing[existing.length - 1].sequence_index) + 1;
+            await insertLetter(m, letter, idx, newId(processingGroup));
+        },
+        async enqueueIfPresent(sequenceIdentifier, letterSupplier) {
+            const m = getManager();
+            const existing = await sequenceRows(m, sequenceIdentifier);
+            if (existing.length === 0)
+                return false;
+            if (existing.length >= maxSequenceSize) {
+                throw new DeadLetterQueueOverflowError(`sequence "${sequenceIdentifier}" has reached max size ${maxSequenceSize}`);
+            }
+            const idx = Number(existing[existing.length - 1].sequence_index) + 1;
+            await insertLetter(m, letterSupplier(), idx, newId(processingGroup));
+            return true;
+        },
+        async evict(_sequenceIdentifier, letter) {
+            const m = getManager();
+            const id = letter.diagnostics[DL_ID];
+            if (typeof id !== "string")
+                return;
+            await m.query(`DELETE FROM ${table} WHERE processing_group = $1 AND dead_letter_id = $2`, [processingGroup, id]);
+        },
+        async requeue(letter, update) {
+            const m = getManager();
+            const id = letter.diagnostics[DL_ID];
+            if (typeof id !== "string")
+                return;
+            const { [DL_ID]: _omit, ...baseDiag } = letter.diagnostics;
+            const cause = update?.cause ?? letter.cause;
+            const diagnostics = update?.diagnostics ? { ...baseDiag, ...update.diagnostics } : baseDiag;
+            await m.query(`UPDATE ${table}
+         SET cause_type = $3, cause_message = $4, diagnostics = $5, last_touched = $6
+         WHERE processing_group = $1 AND dead_letter_id = $2`, [
+                processingGroup,
+                id,
+                cause.name,
+                cause.message,
+                JSON.stringify(diagnostics),
+                String(Date.now()),
+            ]);
+        },
+        async contains(sequenceIdentifier) {
+            const m = getManager();
+            const rows = await m.query(`SELECT dead_letter_id FROM ${table}
+         WHERE processing_group = $1 AND sequence_identifier = $2
+         LIMIT 1`, [processingGroup, sequenceIdentifier]);
+            return rows.length > 0;
+        },
+        async deadLetterSequence(sequenceIdentifier) {
+            const m = getManager();
+            return (await sequenceRows(m, sequenceIdentifier)).map(rowToLetter);
+        },
+        async sequenceIdentifiers() {
+            return distinctSequences(getManager());
+        },
+        async process(sequenceFilter, processingTask) {
+            const m = getManager();
+            const candidates = (await distinctSequences(m)).filter(sequenceFilter);
+            if (candidates.length === 0)
+                return false;
+            // Pick the oldest sequence by its head letter's lastTouched, skipping
+            // sequences under an unexpired processing lease (multi-node safety).
+            const cutoff = Date.now() - claimDurationMs;
+            let chosen;
+            let oldest = Infinity;
+            for (const seqId of candidates) {
+                const rows = await sequenceRows(m, seqId);
+                if (rows.length === 0)
+                    continue;
+                const head = rows[0];
+                const leased = head.processing_started != null && Number(head.processing_started) > cutoff;
+                if (leased)
+                    continue;
+                if (Number(head.last_touched) < oldest) {
+                    oldest = Number(head.last_touched);
+                    chosen = seqId;
+                }
+            }
+            if (!chosen)
+                return false;
+            // Claim the sequence head's lease for the duration of this pass.
+            const headRows = await sequenceRows(m, chosen);
+            await m.query(`UPDATE ${table} SET processing_started = $3
+         WHERE processing_group = $1 AND dead_letter_id = $2`, [processingGroup, headRows[0].dead_letter_id, String(Date.now())]);
+            try {
+                for (const row of headRows) {
+                    const letter = rowToLetter(row);
+                    const decision = await processingTask(letter);
+                    if (decision.shouldEnqueue) {
+                        await this.requeue(letter, { cause: decision.cause, diagnostics: decision.diagnostics });
+                        return true;
+                    }
+                    await this.evict(chosen, letter);
+                }
+                return true;
+            }
+            finally {
+                // Release any lease still set on a surviving head.
+                const remaining = await sequenceRows(m, chosen);
+                if (remaining.length > 0 && remaining[0].processing_started != null) {
+                    await m.query(`UPDATE ${table} SET processing_started = NULL
+             WHERE processing_group = $1 AND dead_letter_id = $2`, [processingGroup, remaining[0].dead_letter_id]);
+                }
+            }
+        },
+        async size() {
+            const m = getManager();
+            const rows = await m.query(`SELECT dead_letter_id FROM ${table} WHERE processing_group = $1`, [processingGroup]);
+            return rows.length;
+        },
+        async amountOfSequences() {
+            return (await distinctSequences(getManager())).length;
+        },
+        async clear() {
+            const m = getManager();
+            await m.query(`DELETE FROM ${table} WHERE processing_group = $1`, [processingGroup]);
+        },
+        async isFull(sequenceIdentifier) {
+            const m = getManager();
+            const rows = await sequenceRows(m, sequenceIdentifier);
+            if (rows.length > 0)
+                return rows.length >= maxSequenceSize;
+            return (await distinctSequences(m)).length >= maxSequences;
+        },
+    };
+}
+//# sourceMappingURL=typeorm-dead-letter-queue.js.map

package/dist/typeorm-dead-letter-queue.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kronos-ts/typeorm",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "description": "TypeORM extension for Kronos.",
   "license": "Apache-2.0",
   "type": "module",
@@ -49,8 +49,8 @@
     }
   },
   "dependencies": {
-    "@kronos-ts/common": "0.1.0",
-    "@kronos-ts/messaging": "0.1.0"
+    "@kronos-ts/common": "0.1.1",
+    "@kronos-ts/messaging": "0.4.0"
   },
   "peerDependencies": {
     "typeorm": ">=0.3.0"

package/src/index.ts

@@ -8,3 +8,8 @@ export {
   typeormTokenStore,
   type TypeOrmManagerLike,
 } from "./typeorm-token-store.js"
+
+export {
+  typeormDeadLetterQueue,
+  type TypeOrmDeadLetterQueueConfig,
+} from "./typeorm-dead-letter-queue.js"

package/src/typeorm-dead-letter-queue.ts

@@ -0,0 +1,328 @@
+import type { DeadLetter, EnqueueDecision, SequencedDeadLetterQueue } from "@kronos-ts/messaging"
+import { getActiveTransaction, DeadLetterQueueOverflowError } from "@kronos-ts/messaging"
+import type { TypeOrmTransaction } from "./typeorm-transaction-manager.js"
+import type { TypeOrmManagerLike } from "./typeorm-token-store.js"
+
+/**
+ * Persistent {@link SequencedDeadLetterQueue} backed by TypeORM — a faithful
+ * translation of the Drizzle reference implementation to TypeORM's raw-SQL
+ * query style (`manager.query(sql, params)`), mirroring {@link typeormTokenStore}.
+ *
+ * Like {@link typeormTokenStore} it reads the active transaction via
+ * `getActiveTransaction()`, so enqueue/evict/requeue commit in the **same
+ * transaction as the token update** — a crash cannot advance the processor's
+ * token while losing the parked letter.
+ *
+ * The table is shared across processors and partitioned by `processingGroup`.
+ * Per-sequence FIFO order is held by a monotonic `sequence_index`; a
+ * `processing_started` lease column makes `process()` safe across multiple
+ * nodes (Axon parity).
+ *
+ * Expected table (`kronos_dead_letters`). Users may define this entity:
+ *
+ * ```typescript
+ * @Entity("kronos_dead_letters")
+ * export class KronosDeadLetterEntry {
+ *   @PrimaryColumn({ name: "dead_letter_id" }) deadLetterId: string
+ *   @Column({ name: "processing_group" }) processingGroup: string
+ *   @Column({ name: "sequence_identifier" }) sequenceIdentifier: string
+ *   @Column({ name: "sequence_index" }) sequenceIndex: number
+ *   @Column({ type: "text" }) message: string
+ *   @Column({ name: "cause_type", nullable: true }) causeType: string | null
+ *   @Column({ name: "cause_message", type: "text", nullable: true }) causeMessage: string | null
+ *   @Column({ type: "text" }) diagnostics: string
+ *   @Column({ name: "enqueued_at" }) enqueuedAt: string
+ *   @Column({ name: "last_touched" }) lastTouched: string
+ *   @Column({ name: "processing_started", nullable: true }) processingStarted: string | null
+ * }
+ * ```
+ *
+ * Column set:
+ * - `dead_letter_id`     (PK)        — opaque persistent row id.
+ * - `processing_group`               — the processor name; partitions the table.
+ * - `sequence_identifier`            — the per-sequence FIFO key.
+ * - `sequence_index`     (int)       — monotonic ordering within a sequence.
+ * - `message`            (text)      — the {@link EventMessage} serialized as JSON.
+ * - `cause_type`         (nullable)  — `Error.name` of the failure cause.
+ * - `cause_message`      (text, null)— `Error.message` of the failure cause.
+ * - `diagnostics`        (text)      — diagnostics map serialized as JSON.
+ * - `enqueued_at`                    — epoch-ms timestamp as a string.
+ * - `last_touched`                   — epoch-ms timestamp as a string.
+ * - `processing_started` (nullable)  — epoch-ms lease timestamp as a string.
+ */
+export interface TypeOrmDeadLetterQueueConfig {
+  /** Processing group (the processor name) this queue serves. */
+  processingGroup: string
+  /** Table name. Default: "kronos_dead_letters". */
+  tableName?: string
+  /** Maximum number of sequences. Default: 1024 (Axon parity). */
+  maxSequences?: number
+  /** Maximum letters per sequence. Default: 1024 (Axon parity). */
+  maxSequenceSize?: number
+  /** Lease duration for in-flight processing, ms. Default: 30000 (Axon parity). */
+  claimDurationMs?: number
+}
+
+/** Reserved diagnostics key carrying the persistent row id across read → evict/requeue. */
+const DL_ID = "__dlqId"
+
+let idCounter = 0
+function newId(group: string): string {
+  // Unique within the table: time + per-process counter + group.
+  idCounter += 1
+  return `${group}:${Date.now()}:${idCounter}`
+}
+
+/**
+ * Creates a {@link SequencedDeadLetterQueue} backed by TypeORM.
+ *
+ * Uses raw SQL queries via the EntityManager for maximum compatibility.
+ * Participates in the active transaction via `getActiveTransaction()`.
+ *
+ * ```typescript
+ * import { typeormDeadLetterQueue } from "@kronos-ts/typeorm"
+ *
+ * const dlq = typeormDeadLetterQueue(dataSource.manager, {
+ *   processingGroup: "my-processor",
+ * })
+ * ```
+ */
+export function typeormDeadLetterQueue(
+  manager: TypeOrmManagerLike,
+  config: TypeOrmDeadLetterQueueConfig,
+): SequencedDeadLetterQueue {
+  const { processingGroup } = config
+  const table = config.tableName ?? "kronos_dead_letters"
+  const maxSequences = config.maxSequences ?? 1024
+  const maxSequenceSize = config.maxSequenceSize ?? 1024
+  const claimDurationMs = config.claimDurationMs ?? 30000
+
+  function getManager(): TypeOrmManagerLike {
+    return getActiveTransaction<TypeOrmTransaction>() ?? manager
+  }
+
+  function rowToLetter(row: any): DeadLetter {
+    const cause = new Error(row.cause_message ?? "")
+    if (row.cause_type) cause.name = row.cause_type
+    return {
+      message: JSON.parse(row.message),
+      cause,
+      enqueuedAt: Number(row.enqueued_at),
+      lastTouched: Number(row.last_touched),
+      diagnostics: { ...JSON.parse(row.diagnostics), [DL_ID]: row.dead_letter_id },
+      sequenceIdentifier: row.sequence_identifier,
+    }
+  }
+
+  async function sequenceRows(m: TypeOrmManagerLike, seqId: string): Promise<any[]> {
+    return m.query(
+      `SELECT dead_letter_id, processing_group, sequence_identifier, sequence_index,
+              message, cause_type, cause_message, diagnostics,
+              enqueued_at, last_touched, processing_started
+       FROM ${table}
+       WHERE processing_group = $1 AND sequence_identifier = $2
+       ORDER BY sequence_index ASC`,
+      [processingGroup, seqId],
+    )
+  }
+
+  async function distinctSequences(m: TypeOrmManagerLike): Promise<string[]> {
+    const rows = await m.query(
+      `SELECT DISTINCT sequence_identifier FROM ${table} WHERE processing_group = $1`,
+      [processingGroup],
+    )
+    return rows.map((r: any) => r.sequence_identifier)
+  }
+
+  async function insertLetter(
+    m: TypeOrmManagerLike,
+    letter: DeadLetter,
+    sequenceIndex: number,
+    deadLetterId: string,
+  ): Promise<void> {
+    const { [DL_ID]: _omit, ...diagnostics } = letter.diagnostics as Record<string, unknown>
+    await m.query(
+      `INSERT INTO ${table}
+         (dead_letter_id, processing_group, sequence_identifier, sequence_index,
+          message, cause_type, cause_message, diagnostics,
+          enqueued_at, last_touched, processing_started)
+       VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, NULL)`,
+      [
+        deadLetterId,
+        processingGroup,
+        letter.sequenceIdentifier,
+        sequenceIndex,
+        JSON.stringify(letter.message),
+        letter.cause.name,
+        letter.cause.message,
+        JSON.stringify(diagnostics),
+        String(letter.enqueuedAt),
+        String(letter.lastTouched),
+      ],
+    )
+  }
+
+  return {
+    async enqueue(letter) {
+      const m = getManager()
+      const existing = await sequenceRows(m, letter.sequenceIdentifier)
+      if (existing.length === 0) {
+        if ((await distinctSequences(m)).length >= maxSequences) {
+          throw new DeadLetterQueueOverflowError(`max sequences ${maxSequences} reached`)
+        }
+      } else if (existing.length >= maxSequenceSize) {
+        throw new DeadLetterQueueOverflowError(
+          `sequence "${letter.sequenceIdentifier}" has reached max size ${maxSequenceSize}`,
+        )
+      }
+      const idx = existing.length === 0 ? 0 : Number(existing[existing.length - 1].sequence_index) + 1
+      await insertLetter(m, letter, idx, newId(processingGroup))
+    },
+
+    async enqueueIfPresent(sequenceIdentifier, letterSupplier) {
+      const m = getManager()
+      const existing = await sequenceRows(m, sequenceIdentifier)
+      if (existing.length === 0) return false
+      if (existing.length >= maxSequenceSize) {
+        throw new DeadLetterQueueOverflowError(
+          `sequence "${sequenceIdentifier}" has reached max size ${maxSequenceSize}`,
+        )
+      }
+      const idx = Number(existing[existing.length - 1].sequence_index) + 1
+      await insertLetter(m, letterSupplier(), idx, newId(processingGroup))
+      return true
+    },
+
+    async evict(_sequenceIdentifier, letter) {
+      const m = getManager()
+      const id = (letter.diagnostics as Record<string, unknown>)[DL_ID]
+      if (typeof id !== "string") return
+      await m.query(
+        `DELETE FROM ${table} WHERE processing_group = $1 AND dead_letter_id = $2`,
+        [processingGroup, id],
+      )
+    },
+
+    async requeue(letter, update) {
+      const m = getManager()
+      const id = (letter.diagnostics as Record<string, unknown>)[DL_ID]
+      if (typeof id !== "string") return
+      const { [DL_ID]: _omit, ...baseDiag } = letter.diagnostics as Record<string, unknown>
+      const cause = update?.cause ?? letter.cause
+      const diagnostics = update?.diagnostics ? { ...baseDiag, ...update.diagnostics } : baseDiag
+      await m.query(
+        `UPDATE ${table}
+         SET cause_type = $3, cause_message = $4, diagnostics = $5, last_touched = $6
+         WHERE processing_group = $1 AND dead_letter_id = $2`,
+        [
+          processingGroup,
+          id,
+          cause.name,
+          cause.message,
+          JSON.stringify(diagnostics),
+          String(Date.now()),
+        ],
+      )
+    },
+
+    async contains(sequenceIdentifier) {
+      const m = getManager()
+      const rows = await m.query(
+        `SELECT dead_letter_id FROM ${table}
+         WHERE processing_group = $1 AND sequence_identifier = $2
+         LIMIT 1`,
+        [processingGroup, sequenceIdentifier],
+      )
+      return rows.length > 0
+    },
+
+    async deadLetterSequence(sequenceIdentifier) {
+      const m = getManager()
+      return (await sequenceRows(m, sequenceIdentifier)).map(rowToLetter)
+    },
+
+    async sequenceIdentifiers() {
+      return distinctSequences(getManager())
+    },
+
+    async process(sequenceFilter, processingTask) {
+      const m = getManager()
+      const candidates = (await distinctSequences(m)).filter(sequenceFilter)
+      if (candidates.length === 0) return false
+
+      // Pick the oldest sequence by its head letter's lastTouched, skipping
+      // sequences under an unexpired processing lease (multi-node safety).
+      const cutoff = Date.now() - claimDurationMs
+      let chosen: string | undefined
+      let oldest = Infinity
+      for (const seqId of candidates) {
+        const rows = await sequenceRows(m, seqId)
+        if (rows.length === 0) continue
+        const head = rows[0]
+        const leased = head.processing_started != null && Number(head.processing_started) > cutoff
+        if (leased) continue
+        if (Number(head.last_touched) < oldest) {
+          oldest = Number(head.last_touched)
+          chosen = seqId
+        }
+      }
+      if (!chosen) return false
+
+      // Claim the sequence head's lease for the duration of this pass.
+      const headRows = await sequenceRows(m, chosen)
+      await m.query(
+        `UPDATE ${table} SET processing_started = $3
+         WHERE processing_group = $1 AND dead_letter_id = $2`,
+        [processingGroup, headRows[0].dead_letter_id, String(Date.now())],
+      )
+
+      try {
+        for (const row of headRows) {
+          const letter = rowToLetter(row)
+          const decision: EnqueueDecision = await processingTask(letter)
+          if (decision.shouldEnqueue) {
+            await this.requeue(letter, { cause: decision.cause, diagnostics: decision.diagnostics })
+            return true
+          }
+          await this.evict(chosen, letter)
+        }
+        return true
+      } finally {
+        // Release any lease still set on a surviving head.
+        const remaining = await sequenceRows(m, chosen)
+        if (remaining.length > 0 && remaining[0].processing_started != null) {
+          await m.query(
+            `UPDATE ${table} SET processing_started = NULL
+             WHERE processing_group = $1 AND dead_letter_id = $2`,
+            [processingGroup, remaining[0].dead_letter_id],
+          )
+        }
+      }
+    },
+
+    async size() {
+      const m = getManager()
+      const rows = await m.query(
+        `SELECT dead_letter_id FROM ${table} WHERE processing_group = $1`,
+        [processingGroup],
+      )
+      return rows.length
+    },
+
+    async amountOfSequences() {
+      return (await distinctSequences(getManager())).length
+    },
+
+    async clear() {
+      const m = getManager()
+      await m.query(`DELETE FROM ${table} WHERE processing_group = $1`, [processingGroup])
+    },
+
+    async isFull(sequenceIdentifier) {
+      const m = getManager()
+      const rows = await sequenceRows(m, sequenceIdentifier)
+      if (rows.length > 0) return rows.length >= maxSequenceSize
+      return (await distinctSequences(m)).length >= maxSequences
+    },
+  }
+}