pp-command-bus 1.5.0 → 2.0.1

package/dist/command-bus/transport/message-processor.js

@@ -0,0 +1,158 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MessageProcessor = void 0;
+const redis_codec_1 = require("./redis-codec");
+/**
+ * Procesor wiadomości — parsuje, waliduje, przetwarza i potwierdza wiadomości
+ *
+ * Odpowiedzialności:
+ * - Parsowanie fields → fieldMap
+ * - Walidacja danych wejściowych (H4)
+ * - Detekcja RPC via marker field
+ * - Wywołanie handlera
+ * - XACK + throttled XTRIM (H2: per-stream counters)
+ * - Wysyłanie odpowiedzi RPC
+ *
+ * NIE odpowiada za deduplicację — to odpowiedzialność koordynatora (StreamConsumer)
+ */
+class MessageProcessor {
+    constructor(options) {
+        /** H2: Liczniki wiadomości od ostatniego XTRIM — per strumień */
+        this.xtrimCounters = new Map();
+        this.pool = options.pool;
+        this.serializer = options.serializer;
+        this.logger = options.logger;
+        this.batchSize = options.batchSize;
+        this.maxRetained = options.maxRetained;
+        this.rpcRespond = options.rpcRespond;
+        this.interceptor = options.interceptor;
+    }
+    /**
+     * Czyści stan counters — wywoływane przy close()
+     */
+    reset() {
+        this.xtrimCounters.clear();
+    }
+    /**
+     * Przetwarza wiadomość — parsuje fields, wykrywa RPC, wywołuje handler, XACK/XTRIM
+     *
+     * Błędy propagują do callera (koordynatora) — nie łapie wewnętrznie
+     *
+     * @param streamName - Nazwa strumienia Redis
+     * @param groupName - Nazwa grupy konsumentów
+     * @param messageId - ID wiadomości
+     * @param fields - Tablica pól ze strumienia [key, value, key, value, ...]
+     * @param handler - Handler przetwarzający dane komendy
+     */
+    process(streamName, groupName, messageId, fields, handler) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            // H4: Walidacja fields array — zapobiega crash na pustych/nieparzystych danych
+            if (!fields || fields.length < 2) {
+                this.logger.warn('Nieprawidłowa wiadomość — brak danych', { streamName, messageId });
+                yield this.pool.next().xack(streamName, groupName, messageId);
+                return;
+            }
+            const fieldMap = new Map();
+            for (let i = 0; i < fields.length; i += 2) {
+                if (i + 1 < fields.length) {
+                    fieldMap.set(fields[i], fields[i + 1]);
+                }
+            }
+            const rawData = fieldMap.get('data');
+            // H4: Walidacja rawData przed decode
+            if (rawData === undefined || rawData === null) {
+                this.logger.warn('Wiadomość bez pola data', { streamName, messageId });
+                yield this.pool.next().xack(streamName, groupName, messageId);
+                return;
+            }
+            const dataBuffer = redis_codec_1.RedisCodec.decode(rawData);
+            let commandData;
+            let rpcMetadata;
+            if (fieldMap.has('rpc')) {
+                const envelope = this.serializer.deserialize(dataBuffer);
+                commandData = redis_codec_1.RedisCodec.decode(envelope.commandData);
+                rpcMetadata = envelope.rpc;
+            }
+            else {
+                commandData = dataBuffer;
+            }
+            // Extract commandId from commandData for correlation
+            const commandId = this.extractCommandId(commandData);
+            let result;
+            if (this.interceptor) {
+                // Wykonaj przez interceptor
+                const execResult = yield this.interceptor.intercept({
+                    commandId,
+                    commandName: this.extractCommandName(streamName),
+                    streamName,
+                    messageId,
+                    timestamp: Date.now(),
+                }, handler, commandData);
+                if (!execResult.success && execResult.error) {
+                    throw execResult.error;
+                }
+                result = execResult.result;
+            }
+            else {
+                // Wykonaj bezpośrednio (backwards compatible)
+                result = yield handler(commandData);
+            }
+            // Log success
+            this.logger.log('Komenda przetworzona', {
+                streamName,
+                messageId,
+                commandId,
+                timestamp: new Date().toISOString(),
+            });
+            // H2: XACK + throttled XTRIM per strumień
+            const count = ((_a = this.xtrimCounters.get(streamName)) !== null && _a !== void 0 ? _a : 0) + 1;
+            this.xtrimCounters.set(streamName, count);
+            const conn = this.pool.next();
+            if (count >= this.batchSize) {
+                const pipeline = conn.pipeline();
+                pipeline.xack(streamName, groupName, messageId);
+                pipeline.xtrim(streamName, 'MAXLEN', '~', this.maxRetained);
+                yield pipeline.exec();
+                this.xtrimCounters.set(streamName, 0);
+            }
+            else {
+                yield conn.xack(streamName, groupName, messageId);
+            }
+            if (rpcMetadata) {
+                const responseBuffer = this.serializer.serialize({ result, error: null });
+                yield this.rpcRespond(rpcMetadata.responseKey, responseBuffer, 60);
+            }
+        });
+    }
+    /**
+     * Ekstrakcja commandId z commandData (deserializacja metadata)
+     */
+    extractCommandId(data) {
+        var _a;
+        try {
+            const cmd = this.serializer.deserialize(data);
+            return (_a = cmd.__id) !== null && _a !== void 0 ? _a : 'unknown';
+        }
+        catch (_b) {
+            return 'unknown';
+        }
+    }
+    /**
+     * Ekstrakcja nazwy komendy ze streamName (usunięcie prefiksu 'cmd:')
+     */
+    extractCommandName(streamName) {
+        return streamName.replace('cmd:', '');
+    }
+}
+exports.MessageProcessor = MessageProcessor;
+//# sourceMappingURL=message-processor.js.map

package/dist/command-bus/transport/message-processor.js.map

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

package/dist/command-bus/transport/message-processor.spec.js

@@ -0,0 +1,185 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const message_processor_1 = require("./message-processor");
+const redis_codec_1 = require("./redis-codec");
+/**
+ * Mock helpers
+ */
+function createMockLogger() {
+    return {
+        log: jest.fn(),
+        error: jest.fn(),
+        warn: jest.fn(),
+        debug: jest.fn(),
+    };
+}
+function createMockSerializer() {
+    return {
+        serialize: jest.fn((data) => Buffer.from(JSON.stringify(data))),
+        deserialize: jest.fn((buf) => JSON.parse(buf.toString())),
+    };
+}
+function createMockConnection() {
+    return {
+        xack: jest.fn().mockResolvedValue(1),
+        pipeline: jest.fn().mockReturnValue({
+            xack: jest.fn().mockReturnThis(),
+            xtrim: jest.fn().mockReturnThis(),
+            exec: jest.fn().mockResolvedValue([
+                [null, 1],
+                [null, 0],
+            ]),
+        }),
+    };
+}
+function createMockPool() {
+    const conn = createMockConnection();
+    return {
+        pool: { next: jest.fn().mockReturnValue(conn) },
+        conn,
+    };
+}
+describe('MessageProcessor', () => {
+    let processor;
+    let logger;
+    let serializer;
+    let mockConn;
+    let mockPool;
+    const rpcRespond = jest.fn().mockResolvedValue(undefined);
+    beforeEach(() => {
+        jest.clearAllMocks();
+        logger = createMockLogger();
+        serializer = createMockSerializer();
+        const poolMock = createMockPool();
+        mockPool = poolMock.pool;
+        mockConn = poolMock.conn;
+        processor = new message_processor_1.MessageProcessor({
+            pool: mockPool,
+            serializer,
+            logger,
+            batchSize: 10,
+            maxRetained: 10000,
+            rpcRespond,
+        });
+    });
+    describe('process()', () => {
+        it('powinien przetworzyć wiadomość i wywołać handler', () => __awaiter(void 0, void 0, void 0, function* () {
+            const handler = jest.fn().mockResolvedValue('ok');
+            const testPayload = redis_codec_1.RedisCodec.encode(Buffer.from('test-data'));
+            const fields = ['data', testPayload];
+            yield processor.process('cmd:Test', 'workers', 'msg-1', fields, handler);
+            expect(handler).toHaveBeenCalledTimes(1);
+            expect(handler).toHaveBeenCalledWith(expect.any(Buffer));
+        }));
+        it('powinien XACK wiadomość po przetworzeniu', () => __awaiter(void 0, void 0, void 0, function* () {
+            const handler = jest.fn().mockResolvedValue('ok');
+            const fields = ['data', redis_codec_1.RedisCodec.encode(Buffer.from('data'))];
+            yield processor.process('cmd:Test', 'workers', 'msg-1', fields, handler);
+            expect(mockConn.xack).toHaveBeenCalledWith('cmd:Test', 'workers', 'msg-1');
+        }));
+        it('powinien odrzucić wiadomość z pustym fields array (H4)', () => __awaiter(void 0, void 0, void 0, function* () {
+            const handler = jest.fn();
+            yield processor.process('cmd:Test', 'workers', 'msg-empty', [], handler);
+            expect(handler).not.toHaveBeenCalled();
+            expect(logger.warn).toHaveBeenCalledWith('Nieprawidłowa wiadomość — brak danych', expect.objectContaining({ messageId: 'msg-empty' }));
+            expect(mockConn.xack).toHaveBeenCalledWith('cmd:Test', 'workers', 'msg-empty');
+        }));
+        it('powinien odrzucić wiadomość z jednym elementem (H4)', () => __awaiter(void 0, void 0, void 0, function* () {
+            const handler = jest.fn();
+            yield processor.process('cmd:Test', 'workers', 'msg-odd', ['key-only'], handler);
+            expect(handler).not.toHaveBeenCalled();
+            expect(logger.warn).toHaveBeenCalledWith('Nieprawidłowa wiadomość — brak danych', expect.objectContaining({ messageId: 'msg-odd' }));
+        }));
+        it('powinien odrzucić wiadomość bez pola data (H4)', () => __awaiter(void 0, void 0, void 0, function* () {
+            const handler = jest.fn();
+            yield processor.process('cmd:Test', 'workers', 'msg-nodata', ['other', 'value'], handler);
+            expect(handler).not.toHaveBeenCalled();
+            expect(logger.warn).toHaveBeenCalledWith('Wiadomość bez pola data', expect.objectContaining({ messageId: 'msg-nodata' }));
+        }));
+        it('powinien obsłużyć nieparzystą liczbę elementów (H4)', () => __awaiter(void 0, void 0, void 0, function* () {
+            const handler = jest.fn().mockResolvedValue('ok');
+            const fields = ['data', redis_codec_1.RedisCodec.encode(Buffer.from('data')), 'extra-key'];
+            yield processor.process('cmd:Test', 'workers', 'msg-odd-fields', fields, handler);
+            expect(handler).toHaveBeenCalledTimes(1);
+        }));
+        it('powinien propagować błąd handlera do callera', () => __awaiter(void 0, void 0, void 0, function* () {
+            const handler = jest.fn().mockRejectedValue(new Error('Handler error'));
+            const fields = ['data', redis_codec_1.RedisCodec.encode(Buffer.from('data'))];
+            yield expect(processor.process('cmd:Test', 'workers', 'msg-err', fields, handler)).rejects.toThrow('Handler error');
+        }));
+    });
+    describe('RPC detection', () => {
+        it('powinien wykryć RPC wiadomość przez marker i odpowiedzieć', () => __awaiter(void 0, void 0, void 0, function* () {
+            const handler = jest.fn().mockResolvedValue('result-42');
+            const envelope = {
+                commandData: redis_codec_1.RedisCodec.encode(Buffer.from('cmd-data')),
+                rpc: { correlationId: 'corr-1', responseKey: 'rpc:res:corr-1' },
+            };
+            const envelopePayload = redis_codec_1.RedisCodec.encode(Buffer.from(JSON.stringify(envelope)));
+            const fields = ['data', envelopePayload, 'rpc', '1'];
+            yield processor.process('cmd:Test', 'workers', 'msg-rpc', fields, handler);
+            expect(handler).toHaveBeenCalledTimes(1);
+            expect(rpcRespond).toHaveBeenCalledWith('rpc:res:corr-1', expect.any(Buffer), 60);
+        }));
+        it('powinien nie wywoływać rpcRespond dla zwykłej wiadomości', () => __awaiter(void 0, void 0, void 0, function* () {
+            const handler = jest.fn().mockResolvedValue('ok');
+            const fields = ['data', redis_codec_1.RedisCodec.encode(Buffer.from('normal-data'))];
+            yield processor.process('cmd:Test', 'workers', 'msg-normal', fields, handler);
+            expect(handler).toHaveBeenCalledTimes(1);
+            expect(rpcRespond).not.toHaveBeenCalled();
+        }));
+    });
+    describe('XTRIM per-stream (H2)', () => {
+        it('powinien zliczać XTRIM niezależnie per strumień', () => __awaiter(void 0, void 0, void 0, function* () {
+            const handler = jest.fn().mockResolvedValue('ok');
+            const fields = ['data', redis_codec_1.RedisCodec.encode(Buffer.from('data'))];
+            // 9 wiadomości na stream A — nie powinno triggerować XTRIM (batchSize=10)
+            for (let i = 0; i < 9; i++) {
+                yield processor.process('cmd:StreamA', 'workers', `a-${i}`, fields, handler);
+            }
+            // 1 wiadomość na stream B
+            yield processor.process('cmd:StreamB', 'workers', 'b-0', fields, handler);
+            // Pipeline NIE powinien być wywołany — żaden stream nie osiągnął batchSize
+            const xackCalls = mockConn.xack.mock.calls;
+            expect(xackCalls.length).toBe(10);
+            // 10. wiadomość na stream A — powinno triggerować XTRIM
+            yield processor.process('cmd:StreamA', 'workers', 'a-9', fields, handler);
+            expect(mockConn.pipeline).toHaveBeenCalled();
+        }));
+        it('powinien wykonać pipeline XACK+XTRIM co batchSize', () => __awaiter(void 0, void 0, void 0, function* () {
+            const handler = jest.fn().mockResolvedValue('ok');
+            const fields = ['data', redis_codec_1.RedisCodec.encode(Buffer.from('data'))];
+            for (let i = 0; i < 10; i++) {
+                yield processor.process('cmd:Test', 'workers', `msg-${i}`, fields, handler);
+            }
+            expect(mockConn.pipeline).toHaveBeenCalledTimes(1);
+        }));
+        it('powinien zresetować counter po XTRIM', () => __awaiter(void 0, void 0, void 0, function* () {
+            const handler = jest.fn().mockResolvedValue('ok');
+            const fields = ['data', redis_codec_1.RedisCodec.encode(Buffer.from('data'))];
+            // Pierwsze 10 — trigger XTRIM
+            for (let i = 0; i < 10; i++) {
+                yield processor.process('cmd:Test', 'workers', `batch1-${i}`, fields, handler);
+            }
+            expect(mockConn.pipeline).toHaveBeenCalledTimes(1);
+            // Następne 9 — NIE trigger
+            for (let i = 0; i < 9; i++) {
+                yield processor.process('cmd:Test', 'workers', `batch2-${i}`, fields, handler);
+            }
+            expect(mockConn.pipeline).toHaveBeenCalledTimes(1);
+            // 20. wiadomość — trigger XTRIM ponownie
+            yield processor.process('cmd:Test', 'workers', 'batch2-9', fields, handler);
+            expect(mockConn.pipeline).toHaveBeenCalledTimes(2);
+        }));
+    });
+});
+//# sourceMappingURL=message-processor.spec.js.map

package/dist/command-bus/transport/message-processor.spec.js.map

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

package/dist/command-bus/transport/pending-recovery.d.ts

@@ -0,0 +1,54 @@
+import type { ILogger } from '../../shared/types';
+import type { ConsumerHandler } from './transport.interface';
+import type RedisConnectionPool from '../../shared/redis/connection-pool';
+import type { StreamConsumer } from './stream-consumer';
+/**
+ * Konfiguracja PendingRecovery
+ */
+export interface PendingRecoveryOptions {
+    pool: RedisConnectionPool;
+    logger: ILogger;
+    consumerId: string;
+    maxAttempts: number;
+    claimTimeout: number;
+}
+/**
+ * Recovery pending wiadomości — XPENDING/XCLAIM natywny mechanizm retry
+ *
+ * Odpowiedzialności:
+ * - Periodyczne sprawdzanie stalled wiadomości (XPENDING)
+ * - Przejmowanie ich (XCLAIM) i przekazywanie do StreamConsumer.processMessage()
+ * - Dead letter dla wiadomości które przekroczyły maxAttempts
+ * - Scheduling (setInterval/clearInterval)
+ */
+export declare class PendingRecovery {
+    private readonly pool;
+    private readonly logger;
+    private readonly consumerId;
+    private readonly maxAttempts;
+    private readonly claimTimeout;
+    /** Intervaly recovery — do graceful shutdown */
+    private readonly recoveryIntervals;
+    constructor(options: PendingRecoveryOptions);
+    /**
+     * Uruchamia periodyczny recovery dla strumienia
+     * @param streamName - Nazwa strumienia Redis
+     * @param groupName - Nazwa grupy konsumentów
+     * @param handler - Handler przetwarzający wiadomości
+     * @param consumer - Referencja do StreamConsumer (processMessage)
+     */
+    start(streamName: string, groupName: string, handler: ConsumerHandler, consumer: StreamConsumer): void;
+    /**
+     * Zatrzymuje wszystkie recovery intervals
+     */
+    stop(): void;
+    /**
+     * Sprawdza i przejmuje stalled wiadomości
+     *
+     * XCLAIM zwraca dane wiadomości — recovery sam je przetwarza via consumer.processMessage()
+     * (consumer loop czyta '>' = tylko nowe, nie widzi XCLAIM'owanych)
+     *
+     * Używa pool connections (NIE dedykowane consumer conn — zajęte przez XREADGROUP BLOCK)
+     */
+    private recoverPending;
+}

package/dist/command-bus/transport/pending-recovery.js

@@ -0,0 +1,139 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PendingRecovery = void 0;
+const error_utils_1 = require("../../shared/utils/error-utils");
+/**
+ * Recovery pending wiadomości — XPENDING/XCLAIM natywny mechanizm retry
+ *
+ * Odpowiedzialności:
+ * - Periodyczne sprawdzanie stalled wiadomości (XPENDING)
+ * - Przejmowanie ich (XCLAIM) i przekazywanie do StreamConsumer.processMessage()
+ * - Dead letter dla wiadomości które przekroczyły maxAttempts
+ * - Scheduling (setInterval/clearInterval)
+ */
+class PendingRecovery {
+    constructor(options) {
+        /** Intervaly recovery — do graceful shutdown */
+        this.recoveryIntervals = [];
+        this.pool = options.pool;
+        this.logger = options.logger;
+        this.consumerId = options.consumerId;
+        this.maxAttempts = options.maxAttempts;
+        this.claimTimeout = options.claimTimeout;
+    }
+    /**
+     * Uruchamia periodyczny recovery dla strumienia
+     * @param streamName - Nazwa strumienia Redis
+     * @param groupName - Nazwa grupy konsumentów
+     * @param handler - Handler przetwarzający wiadomości
+     * @param consumer - Referencja do StreamConsumer (processMessage)
+     */
+    start(streamName, groupName, handler, consumer) {
+        const interval = setInterval(() => {
+            void this.recoverPending(streamName, groupName, handler, consumer);
+        }, this.claimTimeout);
+        this.recoveryIntervals.push(interval);
+    }
+    /**
+     * Zatrzymuje wszystkie recovery intervals
+     */
+    stop() {
+        for (const interval of this.recoveryIntervals) {
+            clearInterval(interval);
+        }
+        this.recoveryIntervals.length = 0;
+    }
+    /**
+     * Sprawdza i przejmuje stalled wiadomości
+     *
+     * XCLAIM zwraca dane wiadomości — recovery sam je przetwarza via consumer.processMessage()
+     * (consumer loop czyta '>' = tylko nowe, nie widzi XCLAIM'owanych)
+     *
+     * Używa pool connections (NIE dedykowane consumer conn — zajęte przez XREADGROUP BLOCK)
+     */
+    recoverPending(streamName, groupName, handler, consumer) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const conn = this.pool.next();
+                const pending = yield conn.xpending(streamName, groupName, '-', '+', 10);
+                if (!Array.isArray(pending) || pending.length === 0)
+                    return;
+                for (const entry of pending) {
+                    // entry = [messageId, consumer, idleTime, deliveryCount]
+                    const pendingEntry = entry;
+                    const [messageId, , idleTime, deliveryCount] = pendingEntry;
+                    if (idleTime > this.claimTimeout && deliveryCount < this.maxAttempts) {
+                        // Przejmij stalled wiadomość — XCLAIM zwraca dane wiadomości
+                        const claimed = (yield this.pool
+                            .next()
+                            .xclaim(streamName, groupName, this.consumerId, this.claimTimeout, messageId));
+                        this.logger.debug('Przejęto stalled wiadomość', {
+                            streamName,
+                            messageId,
+                            deliveryCount,
+                            idleTime,
+                            timestamp: new Date().toISOString(),
+                        });
+                        // XCLAIM zwraca [[messageId, [field, value, ...]]] — przetwórz i czekaj na wynik
+                        if (Array.isArray(claimed) && claimed.length > 0) {
+                            const recoveryPromises = [];
+                            for (const [claimedId, fields] of claimed) {
+                                if (fields && fields.length >= 2) {
+                                    recoveryPromises.push(consumer
+                                        .processMessage(streamName, groupName, claimedId, fields, handler)
+                                        .catch((err) => this.logger.error('Błąd recovery wiadomości', {
+                                        streamName,
+                                        messageId: claimedId,
+                                        error: (0, error_utils_1.getErrorMessage)(err),
+                                    })));
+                                }
+                            }
+                            yield Promise.allSettled(recoveryPromises);
+                        }
+                    }
+                    else if (deliveryCount >= this.maxAttempts) {
+                        // D3: Dead Letter Stream — XCLAIM + XADD do DLQ przed XACK
+                        const claimed = (yield this.pool
+                            .next()
+                            .xclaim(streamName, groupName, this.consumerId, 0, messageId));
+                        if (Array.isArray(claimed) && claimed.length > 0) {
+                            const [, fields] = claimed[0];
+                            if (fields && fields.length >= 2) {
+                                yield this.pool
+                                    .next()
+                                    .xadd(`dlq:${streamName}`, '*', ...fields, 'original_stream', streamName, 'delivery_count', String(deliveryCount));
+                            }
+                        }
+                        yield this.pool.next().xack(streamName, groupName, messageId);
+                        this.logger.error('Wiadomość przeniesiona do Dead Letter Queue', {
+                            streamName,
+                            dlqStream: `dlq:${streamName}`,
+                            messageId,
+                            deliveryCount,
+                            maxAttempts: this.maxAttempts,
+                            timestamp: new Date().toISOString(),
+                        });
+                    }
+                }
+            }
+            catch (error) {
+                this.logger.error('Błąd recovery pending wiadomości', {
+                    streamName,
+                    error: (0, error_utils_1.getErrorMessage)(error),
+                    timestamp: new Date().toISOString(),
+                });
+            }
+        });
+    }
+}
+exports.PendingRecovery = PendingRecovery;
+//# sourceMappingURL=pending-recovery.js.map

package/dist/command-bus/transport/pending-recovery.js.map

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