@volontariapp/post-processors 1.0.0-snap-856af13 → 1.0.0-snap-fb20f49

package/dist/test/specs/helpers/retry-helper.int.spec.js

@@ -0,0 +1,101 @@
+import { describe, it, expect, beforeEach, afterAll, beforeAll } from '@jest/globals';
+import { Redis } from 'ioredis';
+import { testRedisOptions } from '../../redis-config.js';
+import { RetryHelper } from '../../../core/helpers/retry.helper.js';
+describe('RetryHelper — Integration', () => {
+    let redis;
+    let helper;
+    beforeAll(() => {
+        redis = new Redis(testRedisOptions);
+    });
+    afterAll(async () => {
+        await redis.quit();
+    });
+    beforeEach(async () => {
+        await redis.flushdb();
+        helper = new RetryHelper({
+            maxRetries: 3,
+            initialDelayMs: 50,
+            maxDelayMs: 200,
+            backoffMultiplier: 2,
+            enableDlq: true,
+        });
+    });
+    it('should record, fetch, and clear retry metadata in a real Redis database', async () => {
+        const groupName = 'test-group';
+        const messageId = '1-0';
+        const err = new Error('Connection timeout');
+        const initialMeta = await helper.getRetryMetadata(redis, groupName, messageId);
+        expect(initialMeta).toBeNull();
+        const firstAttempt = await helper.recordRetry(redis, groupName, messageId, err);
+        expect(firstAttempt).toBe(1);
+        const meta1 = await helper.getRetryMetadata(redis, groupName, messageId);
+        expect(meta1).not.toBeNull();
+        if (meta1) {
+            expect(meta1.attemptCount).toBe(1);
+            expect(meta1.lastError).toBe('Connection timeout');
+            expect(meta1.nextRetryTimestamp).toBeGreaterThan(Date.now());
+        }
+        const secondAttempt = await helper.recordRetry(redis, groupName, messageId, new Error('Auth failure'));
+        expect(secondAttempt).toBe(2);
+        const meta2 = await helper.getRetryMetadata(redis, groupName, messageId);
+        expect(meta2).not.toBeNull();
+        if (meta2) {
+            expect(meta2.attemptCount).toBe(2);
+            expect(meta2.lastError).toBe('Auth failure');
+        }
+        await helper.clearRetryData(redis, groupName, messageId);
+        const finalMeta = await helper.getRetryMetadata(redis, groupName, messageId);
+        expect(finalMeta).toBeNull();
+    });
+    it('should manage retry queue and fetch ready messages using real Redis sorted sets', async () => {
+        const groupName = 'test-group';
+        const messageId1 = '1-0';
+        const messageId2 = '2-0';
+        await helper.enqueueForRetry(redis, groupName, messageId1, 1);
+        await helper.enqueueForRetry(redis, groupName, messageId2, 2);
+        const ready1 = await helper.getReadyForRetry(redis, groupName);
+        expect(ready1).toHaveLength(0);
+        await new Promise((resolve) => {
+            setTimeout(resolve, 120);
+        });
+        const ready2 = await helper.getReadyForRetry(redis, groupName);
+        expect(ready2).toEqual([messageId1]);
+        const ready3 = await helper.getReadyForRetry(redis, groupName);
+        expect(ready3).toHaveLength(0);
+        await new Promise((resolve) => {
+            setTimeout(resolve, 100);
+        });
+        const ready4 = await helper.getReadyForRetry(redis, groupName);
+        expect(ready4).toEqual([messageId2]);
+    });
+    it('should push failed messages to DLQ stream in a real Redis instance', async () => {
+        const dlqStream = 'test-stream-dlq';
+        const messageId = '9-0';
+        const payload = {
+            success: true,
+            id: 'evt-10',
+            type: 'user.deleted',
+            payload: JSON.stringify({ userId: 42 }),
+        };
+        const errorMsg = 'Failed permanently';
+        const resultId = await helper.sendToDlq(redis, dlqStream, messageId, payload, errorMsg);
+        expect(resultId).not.toBeNull();
+        expect(typeof resultId).toBe('string');
+        const rawResult = await redis.xread('COUNT', 1, 'STREAMS', dlqStream, '0');
+        expect(rawResult).not.toBeNull();
+        if (rawResult) {
+            const streamInfo = rawResult[0];
+            expect(streamInfo[0]).toBe(dlqStream);
+            const entries = streamInfo[1];
+            expect(entries).toHaveLength(1);
+            const entry = entries[0];
+            expect(entry[0]).toBe(resultId);
+            const fields = entry[1];
+            expect(fields).toContain(messageId);
+            expect(fields).toContain(errorMsg);
+            expect(fields).toContain(JSON.stringify(payload));
+        }
+    });
+});
+//# sourceMappingURL=retry-helper.int.spec.js.map

package/dist/test/specs/helpers/retry-helper.int.spec.js.map

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

package/dist/test/specs/helpers/retry-helper.unit.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=retry-helper.unit.spec.d.ts.map

package/dist/test/specs/helpers/retry-helper.unit.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-helper.unit.spec.d.ts","sourceRoot":"","sources":["../../../../src/test/specs/helpers/retry-helper.unit.spec.ts"],"names":[],"mappings":""}

package/dist/test/specs/helpers/retry-helper.unit.spec.js

@@ -0,0 +1,202 @@
+import { describe, it, expect, beforeEach, jest } from '@jest/globals';
+import { createMock } from '@volontariapp/testing';
+import { RetryHelper } from '../../../core/helpers/retry.helper.js';
+describe('RetryHelper — Unit', () => {
+    let redisMock;
+    let helper;
+    beforeEach(() => {
+        redisMock = createMock();
+        helper = new RetryHelper({
+            maxRetries: 3,
+            initialDelayMs: 1000,
+            maxDelayMs: 5000,
+            backoffMultiplier: 2,
+            enableDlq: true,
+        });
+    });
+    describe('calculateDelay', () => {
+        it('should calculate exponential backoff delay correctly', () => {
+            expect(helper.calculateDelay(1)).toBe(2000);
+            expect(helper.calculateDelay(2)).toBe(4000);
+        });
+        it('should cap delay at maxDelayMs', () => {
+            expect(helper.calculateDelay(3)).toBe(5000);
+            expect(helper.calculateDelay(10)).toBe(5000);
+        });
+    });
+    describe('getDlqStreamName', () => {
+        it('should append -dlq suffix to stream name', () => {
+            expect(helper.getDlqStreamName('orders-stream')).toBe('orders-stream-dlq');
+        });
+    });
+    describe('recordRetry', () => {
+        it('should increment attempt count and set last error with TTL', async () => {
+            redisMock.incr.mockResolvedValue(2);
+            redisMock.set.mockResolvedValue('OK');
+            redisMock.expire.mockResolvedValue(1);
+            const incrSpy = jest.spyOn(redisMock, 'incr');
+            const setSpy = jest.spyOn(redisMock, 'set');
+            const expireSpy = jest.spyOn(redisMock, 'expire');
+            const err = new Error('Database connection failed');
+            const attempt = await helper.recordRetry(redisMock, 'group-a', 'msg-1', err, 3600);
+            expect(attempt).toBe(2);
+            expect(incrSpy.mock.calls[0]).toEqual(['retry:post-processor:group-a:msg-1:attempt']);
+            expect(setSpy.mock.calls[0]).toEqual([
+                'retry:post-processor:group-a:msg-1:lastError',
+                'Database connection failed',
+                'EX',
+                3600,
+            ]);
+            expect(expireSpy.mock.calls[0]).toEqual(['retry:post-processor:group-a:msg-1', 3600]);
+        });
+    });
+    describe('getRetryMetadata', () => {
+        it('should return null if no retry attempts recorded', async () => {
+            redisMock.get.mockResolvedValue(null);
+            const metadata = await helper.getRetryMetadata(redisMock, 'group-a', 'msg-1');
+            expect(metadata).toBeNull();
+        });
+        it('should return full metadata if attempts are found', async () => {
+            redisMock.get.mockResolvedValueOnce('2').mockResolvedValueOnce('Last connection error');
+            const before = Date.now();
+            const metadata = await helper.getRetryMetadata(redisMock, 'group-a', 'msg-1');
+            const after = Date.now();
+            expect(metadata).not.toBeNull();
+            if (metadata) {
+                expect(metadata.attemptCount).toBe(2);
+                expect(metadata.lastError).toBe('Last connection error');
+                expect(metadata.nextRetryTimestamp).toBeGreaterThanOrEqual(before + 4000);
+                expect(metadata.nextRetryTimestamp).toBeLessThanOrEqual(after + 4000);
+            }
+        });
+    });
+    describe('enqueueForRetry', () => {
+        it('should add message id to sorted set with calculated timestamp score', async () => {
+            redisMock.zadd.mockResolvedValue('1');
+            const zaddSpy = jest.spyOn(redisMock, 'zadd');
+            const before = Date.now();
+            await helper.enqueueForRetry(redisMock, 'group-a', 'msg-1', 1);
+            expect(zaddSpy).toHaveBeenCalled();
+            const calls = zaddSpy.mock.calls;
+            expect(calls[0]?.[0]).toBe('retry-queue:post-processor:group-a');
+            const score = Number(calls[0]?.[1]);
+            expect(score).toBeGreaterThanOrEqual(before + 2000);
+            expect(score).toBeLessThanOrEqual(Date.now() + 2000);
+            expect(calls[0]?.[2]).toBe('msg-1');
+        });
+    });
+    describe('getReadyForRetry', () => {
+        it('should fetch ready messages and remove them from sorted set', async () => {
+            redisMock.zrangebyscore.mockResolvedValue(['msg-1', 'msg-2']);
+            redisMock.zrem.mockResolvedValue(2);
+            const zrangeSpy = jest.spyOn(redisMock, 'zrangebyscore');
+            const zremSpy = jest.spyOn(redisMock, 'zrem');
+            const ready = await helper.getReadyForRetry(redisMock, 'group-a');
+            expect(ready).toEqual(['msg-1', 'msg-2']);
+            expect(zrangeSpy.mock.calls[0]).toEqual([
+                'retry-queue:post-processor:group-a',
+                '-inf',
+                expect.any(Number),
+            ]);
+            expect(zremSpy.mock.calls[0]).toEqual([
+                'retry-queue:post-processor:group-a',
+                'msg-1',
+                'msg-2',
+            ]);
+        });
+        it('should return empty array if no messages ready', async () => {
+            redisMock.zrangebyscore.mockResolvedValue([]);
+            const zremSpy = jest.spyOn(redisMock, 'zrem');
+            const ready = await helper.getReadyForRetry(redisMock, 'group-a');
+            expect(ready).toEqual([]);
+            expect(zremSpy).not.toHaveBeenCalled();
+        });
+    });
+    describe('shouldRetry', () => {
+        it('should return true if attemptCount is less than maxRetries', () => {
+            expect(helper.shouldRetry(1)).toBe(true);
+            expect(helper.shouldRetry(2)).toBe(true);
+            expect(helper.shouldRetry(3)).toBe(false);
+        });
+    });
+    describe('clearRetryData', () => {
+        it('should delete all related keys and remove from sorted set', async () => {
+            redisMock.del.mockResolvedValue(1);
+            redisMock.zrem.mockResolvedValue(1);
+            const delSpy = jest.spyOn(redisMock, 'del');
+            const zremSpy = jest.spyOn(redisMock, 'zrem');
+            await helper.clearRetryData(redisMock, 'group-a', 'msg-1');
+            const delCalls = delSpy.mock.calls;
+            expect(delCalls).toHaveLength(3);
+            expect(delCalls[0]).toEqual(['retry:post-processor:group-a:msg-1:attempt']);
+            expect(delCalls[1]).toEqual(['retry:post-processor:group-a:msg-1:lastError']);
+            expect(delCalls[2]).toEqual(['retry:post-processor:group-a:msg-1']);
+            expect(zremSpy.mock.calls[0]).toEqual(['retry-queue:post-processor:group-a', 'msg-1']);
+        });
+    });
+    describe('sendToDlq', () => {
+        const payload = {
+            success: true,
+            id: 'evt-1',
+            type: 'order.created',
+            payload: JSON.stringify({ data: { test: true } }),
+        };
+        it('should format payload and call xadd if DLQ is enabled', async () => {
+            redisMock.xadd.mockResolvedValue('dlq-id-123');
+            const xaddSpy = jest.spyOn(redisMock, 'xadd');
+            const resultId = await helper.sendToDlq(redisMock, 'orders-stream-dlq', 'msg-1', payload, 'Some test failure message');
+            expect(resultId).toBe('dlq-id-123');
+            expect(xaddSpy.mock.calls[0]).toEqual([
+                'orders-stream-dlq',
+                '*',
+                'messageId',
+                'msg-1',
+                'error',
+                'Some test failure message',
+                'payload',
+                JSON.stringify(payload),
+                'timestamp',
+                expect.any(String),
+            ]);
+        });
+        it('should return original messageId and skip call if DLQ is disabled', async () => {
+            const disabledHelper = new RetryHelper({
+                maxRetries: 3,
+                initialDelayMs: 1000,
+                maxDelayMs: 5000,
+                backoffMultiplier: 2,
+                enableDlq: false,
+            });
+            const xaddSpy = jest.spyOn(redisMock, 'xadd');
+            const resultId = await disabledHelper.sendToDlq(redisMock, 'orders-stream-dlq', 'msg-1', payload, 'Some test failure message');
+            expect(resultId).toBe('msg-1');
+            expect(xaddSpy).not.toHaveBeenCalled();
+        });
+    });
+    describe('normalizeRetryOptions', () => {
+        it('should return default values when options are undefined', () => {
+            const normalized = RetryHelper.normalizeRetryOptions();
+            expect(normalized).toEqual({
+                maxRetries: 5,
+                initialDelayMs: 1000,
+                maxDelayMs: 60000,
+                backoffMultiplier: 2,
+                enableDlq: true,
+            });
+        });
+        it('should preserve provided options and fill in defaults for missing values', () => {
+            const normalized = RetryHelper.normalizeRetryOptions({
+                maxRetries: 10,
+                enableDlq: false,
+            });
+            expect(normalized).toEqual({
+                maxRetries: 10,
+                initialDelayMs: 1000,
+                maxDelayMs: 60000,
+                backoffMultiplier: 2,
+                enableDlq: false,
+            });
+        });
+    });
+});
+//# sourceMappingURL=retry-helper.unit.spec.js.map

package/dist/test/specs/helpers/retry-helper.unit.spec.js.map

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

package/dist/test/specs/integration/circuit-breaker.integration.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=circuit-breaker.integration.spec.d.ts.map

package/dist/test/specs/integration/circuit-breaker.integration.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.integration.spec.d.ts","sourceRoot":"","sources":["../../../../src/test/specs/integration/circuit-breaker.integration.spec.ts"],"names":[],"mappings":""}

package/dist/test/specs/integration/circuit-breaker.integration.spec.js

@@ -0,0 +1,112 @@
+import { describe, it, expect, beforeEach, afterEach, jest } from '@jest/globals';
+import { createMock } from '@volontariapp/testing';
+import { TestPostProcessor } from '../../utils/classes/test-post-processor.class.js';
+import { mockRedisCall, mockRedisXreadgroup } from '../../utils/mocks/redis-call.mock.js';
+import { makeTestEvent } from '../../utils/factories/test-event.factory.js';
+import { CircuitBreakerState } from '../../../enums/circuit-breaker-state.enum.js';
+import { TestMessagingStream, TestMessagingGroup, TestMessagingConsumer, } from '../../utils/enums/test-messaging.enum.js';
+describe('CircuitBreaker Integration', () => {
+    let redisMock;
+    let callMock;
+    let processor;
+    beforeEach(() => {
+        redisMock = createMock();
+        callMock = mockRedisCall(redisMock);
+        processor = new TestPostProcessor(redisMock, {
+            streamName: TestMessagingStream.TEST_STREAM,
+            groupName: TestMessagingGroup.TEST_GROUP,
+            consumerName: TestMessagingConsumer.TEST_CONSUMER,
+            claimIntervalMs: 50,
+            claimMinIdleTimeMs: 100,
+            circuitBreaker: {
+                failureThreshold: 2,
+                resetTimeoutMs: 50,
+                successThreshold: 2,
+            },
+        });
+    });
+    afterEach(async () => {
+        await processor.stop();
+        jest.restoreAllMocks();
+    });
+    it('should start CLOSED and transition to OPEN when failure threshold is reached', async () => {
+        const cb = processor.getCircuitBreaker();
+        expect(cb.getState()).toBe(CircuitBreakerState.CLOSED);
+        const mockEvent = makeTestEvent('evt-1');
+        mockRedisXreadgroup(callMock, TestMessagingStream.TEST_STREAM, [
+            { messageId: '1-0', event: mockEvent },
+            { messageId: '2-0', event: mockEvent },
+            { messageId: '3-0', event: mockEvent },
+        ]);
+        processor.processError = new Error('Processor failed');
+        await processor.start();
+        await new Promise((resolve) => {
+            setTimeout(resolve, 30);
+        });
+        expect(cb.getState()).toBe(CircuitBreakerState.CLOSED);
+        expect(cb.getDiagnostics().failureCount).toBe(1);
+        await new Promise((resolve) => {
+            setTimeout(resolve, 35);
+        });
+        expect(cb.getState()).toBe(CircuitBreakerState.OPEN);
+    });
+    it('should suspend stream consumption and other loops when OPEN', async () => {
+        const cb = processor.getCircuitBreaker();
+        const mockEvent = makeTestEvent('evt-2');
+        mockRedisXreadgroup(callMock, TestMessagingStream.TEST_STREAM, [
+            { messageId: '1-0', event: mockEvent },
+        ]);
+        processor.processError = new Error('Processor failed');
+        await processor.start();
+        await new Promise((resolve) => {
+            const interval = setInterval(() => {
+                if (cb.getState() === CircuitBreakerState.OPEN) {
+                    clearInterval(interval);
+                    resolve();
+                }
+            }, 10);
+        });
+        expect(cb.getState()).toBe(CircuitBreakerState.OPEN);
+        callMock.mockClear();
+        mockRedisXreadgroup(callMock, TestMessagingStream.TEST_STREAM, [
+            { messageId: '2-0', event: mockEvent },
+        ]);
+        await new Promise((resolve) => {
+            setTimeout(resolve, 50);
+        });
+        const xreadCalls = callMock.mock.calls.filter((args) => args[0] === 'XREADGROUP');
+        expect(xreadCalls.length).toBe(0);
+    });
+    it('should transition to HALF_OPEN after reset timeout and CLOSE on success threshold met', async () => {
+        const cb = processor.getCircuitBreaker();
+        const mockEvent = makeTestEvent('evt-3');
+        mockRedisXreadgroup(callMock, TestMessagingStream.TEST_STREAM, [
+            { messageId: '1-0', event: mockEvent },
+        ]);
+        processor.processError = new Error('Processor failed');
+        await processor.start();
+        await new Promise((resolve) => {
+            const interval = setInterval(() => {
+                if (cb.getState() === CircuitBreakerState.OPEN) {
+                    clearInterval(interval);
+                    resolve();
+                }
+            }, 10);
+        });
+        expect(cb.getState()).toBe(CircuitBreakerState.OPEN);
+        processor.processError = null;
+        await new Promise((resolve) => {
+            setTimeout(resolve, 60);
+        });
+        mockRedisXreadgroup(callMock, TestMessagingStream.TEST_STREAM, [
+            { messageId: '2-0', event: mockEvent },
+            { messageId: '3-0', event: mockEvent },
+        ]);
+        await new Promise((resolve) => {
+            setTimeout(resolve, 60);
+        });
+        expect(cb.getState()).toBe(CircuitBreakerState.CLOSED);
+        expect(cb.getDiagnostics().failureCount).toBe(0);
+    });
+});
+//# sourceMappingURL=circuit-breaker.integration.spec.js.map

package/dist/test/specs/integration/circuit-breaker.integration.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.integration.spec.js","sourceRoot":"","sources":["../../../../src/test/specs/integration/circuit-breaker.integration.spec.ts"],"names":[],"mappings":"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"}

package/dist/test/specs/single-post-processor/single-post-processor-retry.int.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=single-post-processor-retry.int.spec.d.ts.map

package/dist/test/specs/single-post-processor/single-post-processor-retry.int.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"single-post-processor-retry.int.spec.d.ts","sourceRoot":"","sources":["../../../../src/test/specs/single-post-processor/single-post-processor-retry.int.spec.ts"],"names":[],"mappings":""}

package/dist/test/specs/single-post-processor/single-post-processor-retry.int.spec.js

@@ -0,0 +1,142 @@
+import { describe, it, expect, beforeEach, afterEach, beforeAll, afterAll, jest, } from '@jest/globals';
+import { Redis } from 'ioredis';
+import { testRedisOptions } from '../../redis-config.js';
+import { TestPostProcessor, makeTestEvent, pushTestEventToStream, TestMessagingStream, TestMessagingGroup, TestMessagingConsumer, waitFor, } from '../../utils/index.js';
+describe('SinglePostProcessor — Retry & Exponential Backoff', () => {
+    let redis;
+    let processor;
+    beforeAll(() => {
+        redis = new Redis(testRedisOptions);
+    });
+    afterAll(async () => {
+        await redis.quit();
+    });
+    beforeEach(async () => {
+        await redis.flushdb();
+        processor = new TestPostProcessor(redis, {
+            streamName: TestMessagingStream.TEST_STREAM,
+            groupName: TestMessagingGroup.TEST_GROUP,
+            consumerName: TestMessagingConsumer.TEST_CONSUMER,
+            claimIntervalMs: 100,
+            claimMinIdleTimeMs: 50,
+            blockMs: 50,
+            circuitBreaker: {
+                failureThreshold: 20,
+                resetTimeoutMs: 10000,
+                successThreshold: 1,
+            },
+            retry: {
+                maxRetries: 3,
+                initialDelayMs: 100,
+                maxDelayMs: 5000,
+                backoffMultiplier: 2,
+                enableDlq: true,
+            },
+        });
+    });
+    afterEach(async () => {
+        await processor.stop();
+    });
+    it('should retry a failed message with exponential backoff', async () => {
+        const eventPayload = makeTestEvent('evt-retry-1');
+        await pushTestEventToStream(redis, TestMessagingStream.TEST_STREAM, 'evt-retry-1', eventPayload);
+        processor.processError = new Error('Simulated processing error');
+        await processor.start();
+        const retryQueueKey = `retry-queue:post-processor:${TestMessagingGroup.TEST_GROUP}`;
+        await waitFor(async () => {
+            const retryCount = await redis.zcard(retryQueueKey);
+            return retryCount === 1;
+        });
+        expect(processor.processedEvents).toHaveLength(0);
+        processor.processError = null;
+        await waitFor(() => processor.processedEvents.length === 1);
+        expect(processor.processedEvents[0]?.id).toBe('evt-retry-1');
+        const finalRetryCount = await redis.zcard(retryQueueKey);
+        expect(finalRetryCount).toBe(0);
+    });
+    it('should respect exponential backoff delays', async () => {
+        const eventPayload = makeTestEvent('evt-backoff-1');
+        await pushTestEventToStream(redis, TestMessagingStream.TEST_STREAM, 'evt-backoff-1', eventPayload);
+        const retryHelper = processor['retryHelper'];
+        const calculateDelaySpy = jest.spyOn(retryHelper, 'calculateDelay');
+        processor.processError = new Error('Simulated processing error');
+        await processor.start();
+        await waitFor(() => calculateDelaySpy.mock.calls.length >= 4);
+        expect(calculateDelaySpy.mock.calls.length).toBeGreaterThanOrEqual(4);
+        expect(calculateDelaySpy).toHaveBeenNthCalledWith(1, 1);
+        expect(calculateDelaySpy.mock.results[0]?.value).toBe(200);
+        expect(calculateDelaySpy).toHaveBeenNthCalledWith(2, 1);
+        expect(calculateDelaySpy.mock.results[1]?.value).toBe(200);
+        expect(calculateDelaySpy).toHaveBeenNthCalledWith(3, 2);
+        expect(calculateDelaySpy.mock.results[2]?.value).toBe(400);
+        expect(calculateDelaySpy).toHaveBeenNthCalledWith(4, 2);
+        expect(calculateDelaySpy.mock.results[3]?.value).toBe(400);
+        calculateDelaySpy.mockRestore();
+    });
+    it('should send message to DLQ after max retries exceeded', async () => {
+        const eventPayload = makeTestEvent('evt-dlq-1');
+        const messageId = await pushTestEventToStream(redis, TestMessagingStream.TEST_STREAM, 'evt-dlq-1', eventPayload);
+        processor.processError = new Error('Persistent processing error');
+        await processor.start();
+        for (let i = 0; i < 5; i++) {
+            await new Promise((resolve) => setTimeout(resolve, 250));
+        }
+        processor.processError = null;
+        const dlqStreamName = `${TestMessagingStream.TEST_STREAM}-dlq`;
+        const dlqEntries = (await redis.xrange(dlqStreamName, '-', '+'));
+        expect(dlqEntries.length).toBeGreaterThan(0);
+        const dlqEntry = dlqEntries[0];
+        const dlqFields = dlqEntry[1];
+        const dlqObject = {};
+        for (let i = 0; i < dlqFields.length; i += 2) {
+            const key = dlqFields[i];
+            const val = dlqFields[i + 1];
+            dlqObject[key] = val;
+        }
+        expect(dlqObject.messageId).toBe(messageId);
+        const parsedPayload = JSON.parse(dlqObject.payload || '{}');
+        expect(parsedPayload.id).toBe('evt-dlq-1');
+        expect(dlqObject.error).toContain('Persistent processing error');
+    });
+    it('should clear retry data on successful processing', async () => {
+        const eventPayload = makeTestEvent('evt-retry-clear-1');
+        const messageId = await pushTestEventToStream(redis, TestMessagingStream.TEST_STREAM, 'evt-retry-clear-1', eventPayload);
+        processor.processError = new Error('Simulated error');
+        await processor.start();
+        const retryKey = `retry:post-processor:${TestMessagingGroup.TEST_GROUP}:${messageId}:attempt`;
+        await waitFor(async () => {
+            const attemptCount = await redis.get(retryKey);
+            return attemptCount === '1';
+        });
+        processor.processError = null;
+        await waitFor(() => processor.processedEvents.length === 1);
+        const attemptCount = await redis.get(retryKey);
+        expect(attemptCount).toBeNull();
+    });
+    it('should not retry when retry is disabled', async () => {
+        await processor.stop();
+        const noRetryProcessor = new TestPostProcessor(redis, {
+            streamName: TestMessagingStream.TEST_STREAM,
+            groupName: TestMessagingGroup.TEST_GROUP,
+            consumerName: TestMessagingConsumer.TEST_CONSUMER,
+            claimIntervalMs: 100,
+            blockMs: 50,
+            circuitBreaker: {
+                failureThreshold: 20,
+            },
+            retry: {
+                maxRetries: 0,
+            },
+        });
+        const eventPayload = makeTestEvent('evt-no-retry-1');
+        await pushTestEventToStream(redis, TestMessagingStream.TEST_STREAM, 'evt-no-retry-1', eventPayload);
+        noRetryProcessor.processError = new Error('Processing failed');
+        await noRetryProcessor.start();
+        await new Promise((resolve) => setTimeout(resolve, 300));
+        const dlqStreamName = `${TestMessagingStream.TEST_STREAM}-dlq`;
+        const dlqEntries = (await redis.xrange(dlqStreamName, '-', '+'));
+        expect(dlqEntries.length).toBeGreaterThan(0);
+        await noRetryProcessor.stop();
+    });
+});
+//# sourceMappingURL=single-post-processor-retry.int.spec.js.map

package/dist/test/specs/single-post-processor/single-post-processor-retry.int.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"single-post-processor-retry.int.spec.js","sourceRoot":"","sources":["../../../../src/test/specs/single-post-processor/single-post-processor-retry.int.spec.ts"],"names":[],"mappings":"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"}