From ec4ea4626ef9d97bbbab200778c9f78fc7389497 Mon Sep 17 00:00:00 2001
From: Paolo Insogna <paolo@cowtech.it>
Date: Wed, 18 Feb 2026 15:39:54 +0100
Subject: [PATCH] fix: Respect error serialization.

Signed-off-by: Paolo Insogna <paolo@cowtech.it>
---
 src/consumer.ts    | 18 ++++++++++++------
 test/queue.test.ts | 31 +++++++++++++++++++++++++++++++
 2 files changed, 43 insertions(+), 6 deletions(-)

diff --git a/src/consumer.ts b/src/consumer.ts
index 9f59c08..7d077b9 100644
--- a/src/consumer.ts
+++ b/src/consumer.ts
@@ -25,6 +25,8 @@ interface ConsumerEvents<TResult> {
   requeued: [id: string]
 }
 
+type ExtendedError = Error & { code?: string; toJSON?: () => Record<string, any> }
+
 /**
  * Consumer handles processing jobs from the queue
  */
@@ -209,7 +211,7 @@ export class Consumer<TPayload, TResult> extends EventEmitter<ConsumerEvents<TRe
       // Clear visibility timer
       clearTimeout(visibilityTimer)
 
-      const error = err as Error
+      const error = err as ExtendedError
       const currentAttempts = attempts + 1
 
       if (currentAttempts < maxAttempts) {
@@ -226,11 +228,15 @@ export class Consumer<TPayload, TResult> extends EventEmitter<ConsumerEvents<TRe
       } else {
         // Max retries exceeded - fail the job
         const maxRetriesError = new MaxRetriesError(id, currentAttempts, error)
-        const serializedError = Buffer.from(JSON.stringify({
-          message: error.message,
-          code: (error as Error & { code?: string }).code,
-          stack: error.stack
-        }))
+        const serializedError = Buffer.from(JSON.stringify(
+          typeof error.toJSON === 'function'
+            ? error.toJSON()
+            : {
+                message: error.message,
+                code: error.code,
+                stack: error.stack
+              }
+        ))
 
         await this.#storage.failJob(id, message, this.#workerId, serializedError, this.#resultTTL)
 
diff --git a/test/queue.test.ts b/test/queue.test.ts
index bd82d14..54aa06c 100644
--- a/test/queue.test.ts
+++ b/test/queue.test.ts
@@ -317,6 +317,37 @@ describe('Queue', () => {
       assert.strictEqual(status.state, 'completed')
       assert.deepStrictEqual(status.result, { result: 42 })
     })
+
+    it('should use error.toJSON() for failed job status when available', async () => {
+      class JsonError extends Error {
+        toJSON (): unknown {
+          return {
+            message: this.message,
+            code: 'CUSTOM_ERROR',
+            details: { source: 'toJSON' }
+          }
+        }
+      }
+
+      queue.execute(async () => {
+        throw new JsonError('Serialized by toJSON')
+      })
+
+      await queue.start()
+
+      const failedPromise = once(queue, 'failed')
+      await queue.enqueue('job-1', { value: 21 }, { maxAttempts: 1 })
+      await failedPromise
+
+      const status = await queue.getStatus('job-1')
+      assert.ok(status)
+      assert.strictEqual(status.state, 'failed')
+      assert.deepStrictEqual(status.error, {
+        message: 'Serialized by toJSON',
+        code: 'CUSTOM_ERROR',
+        details: { source: 'toJSON' }
+      })
+    })
   })
 
   describe('concurrency', () => {