pp-command-bus 1.5.0 → 2.0.1

package/dist/command-bus/serialization/serializer.interface.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Interfejs serializera dla CommandBus
+ * Odpowiada za konwersję danych do/z formatu binarnego (Buffer)
+ *
+ * Implementacje powinny obsługiwać natywne typy JS (Date, Buffer, nested objects)
+ * bez konieczności dodatkowej rekonstrukcji typów po deserializacji
+ */
+export interface ISerializer {
+    /**
+     * Serializuje dane do formatu binarnego
+     * @param data - Dane do serializacji
+     * @returns Buffer z serializowanymi danymi
+     */
+    serialize(data: unknown): Buffer;
+    /**
+     * Deserializuje dane z formatu binarnego
+     * @param buffer - Buffer z serializowanymi danymi
+     * @returns Zdeserializowane dane
+     */
+    deserialize<T>(buffer: Buffer): T;
+}

package/dist/command-bus/serialization/serializer.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=serializer.interface.js.map

package/dist/command-bus/serialization/serializer.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.interface.js","sourceRoot":"","sources":["../../../src/command-bus/serialization/serializer.interface.ts"],"names":[],"mappings":""}

package/dist/command-bus/transport/consumer-loop.d.ts

@@ -0,0 +1,45 @@
+import type { Redis } from 'ioredis';
+import type { ILogger } from '../../shared/types';
+/**
+ * Callback wywoływany dla każdej wiadomości odczytanej ze strumienia
+ */
+export type MessageCallback = (messageId: string, fields: string[]) => Promise<void>;
+/**
+ * Konfiguracja ConsumerLoop
+ */
+export interface ConsumerLoopOptions {
+    consumerId: string;
+    batchSize: number;
+    concurrency: number;
+    logger: ILogger;
+}
+/**
+ * Consumer loop — czyta wiadomości z Redis Streams i przekazuje do callbacka
+ *
+ * Odpowiedzialności:
+ * - while(running) loop z XREADGROUP BLOCK
+ * - Concurrency limiter (Promise.race + active Set)
+ * - Exponential backoff z jitter przy błędach
+ * - Czekanie na aktywne zadania przy shutdown
+ *
+ * NIE odpowiada za przetwarzanie wiadomości — to odpowiedzialność koordynatora/procesora
+ */
+export declare class ConsumerLoop {
+    private readonly consumerId;
+    private readonly batchSize;
+    private readonly concurrency;
+    private readonly logger;
+    /** Flaga zatrzymania consumer loop */
+    running: boolean;
+    constructor(options: ConsumerLoopOptions);
+    /**
+     * Uruchamia consumer loop — czyta wiadomości z strumienia i przetwarza
+     * Concurrency limiter: przetwarza N wiadomości równolegle, czyta gdy wolne sloty
+     *
+     * @param conn - Dedykowane połączenie Redis (XREADGROUP BLOCK blokuje socket)
+     * @param streamName - Nazwa strumienia Redis
+     * @param groupName - Nazwa grupy konsumentów
+     * @param onMessage - Callback wywoływany dla każdej wiadomości
+     */
+    run(conn: Redis, streamName: string, groupName: string, onMessage: MessageCallback): Promise<void>;
+}

package/dist/command-bus/transport/consumer-loop.js

@@ -0,0 +1,90 @@
+"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.ConsumerLoop = void 0;
+const error_utils_1 = require("../../shared/utils/error-utils");
+/**
+ * Consumer loop — czyta wiadomości z Redis Streams i przekazuje do callbacka
+ *
+ * Odpowiedzialności:
+ * - while(running) loop z XREADGROUP BLOCK
+ * - Concurrency limiter (Promise.race + active Set)
+ * - Exponential backoff z jitter przy błędach
+ * - Czekanie na aktywne zadania przy shutdown
+ *
+ * NIE odpowiada za przetwarzanie wiadomości — to odpowiedzialność koordynatora/procesora
+ */
+class ConsumerLoop {
+    constructor(options) {
+        /** Flaga zatrzymania consumer loop */
+        this.running = true;
+        this.consumerId = options.consumerId;
+        this.batchSize = options.batchSize;
+        this.concurrency = options.concurrency;
+        this.logger = options.logger;
+    }
+    /**
+     * Uruchamia consumer loop — czyta wiadomości z strumienia i przetwarza
+     * Concurrency limiter: przetwarza N wiadomości równolegle, czyta gdy wolne sloty
+     *
+     * @param conn - Dedykowane połączenie Redis (XREADGROUP BLOCK blokuje socket)
+     * @param streamName - Nazwa strumienia Redis
+     * @param groupName - Nazwa grupy konsumentów
+     * @param onMessage - Callback wywoływany dla każdej wiadomości
+     */
+    run(conn, streamName, groupName, onMessage) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const active = new Set();
+            let consecutiveErrors = 0;
+            while (this.running) {
+                try {
+                    while (active.size >= this.concurrency && this.running) {
+                        yield Promise.race(active);
+                    }
+                    if (!this.running)
+                        break;
+                    const availableSlots = this.concurrency - active.size;
+                    const count = Math.min(this.batchSize, availableSlots);
+                    const result = yield conn.xreadgroup('GROUP', groupName, this.consumerId, 'COUNT', count, 'BLOCK', 5000, 'STREAMS', streamName, '>');
+                    consecutiveErrors = 0;
+                    if (!result)
+                        continue;
+                    const messages = result;
+                    for (const [, streamMessages] of messages) {
+                        for (const [messageId, fields] of streamMessages) {
+                            const processing = onMessage(messageId, fields);
+                            active.add(processing);
+                            void processing.finally(() => active.delete(processing));
+                        }
+                    }
+                }
+                catch (error) {
+                    if (!this.running)
+                        break;
+                    consecutiveErrors++;
+                    this.logger.error('Błąd w consumer loop', {
+                        streamName,
+                        error: (0, error_utils_1.getErrorMessage)(error),
+                        consecutiveErrors,
+                        timestamp: new Date().toISOString(),
+                    });
+                    const backoff = Math.min(1000 * Math.pow(2, consecutiveErrors - 1), 30000) + Math.random() * 1000;
+                    yield new Promise((r) => setTimeout(r, backoff));
+                }
+            }
+            if (active.size > 0) {
+                yield Promise.allSettled(active);
+            }
+        });
+    }
+}
+exports.ConsumerLoop = ConsumerLoop;
+//# sourceMappingURL=consumer-loop.js.map

package/dist/command-bus/transport/consumer-loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumer-loop.js","sourceRoot":"","sources":["../../../src/command-bus/transport/consumer-loop.ts"],"names":[],"mappings":";;;;;;;;;;;;AAEA,gEAAiE;AAiBjE;;;;;;;;;;GAUG;AACH,MAAa,YAAY;IASvB,YAAY,OAA4B;QAHxC,sCAAsC;QACtC,YAAO,GAAG,IAAI,CAAC;QAGb,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC/B,CAAC;IAED;;;;;;;;OAQG;IACG,GAAG,CACP,IAAW,EACX,UAAkB,EAClB,SAAiB,EACjB,SAA0B;;YAE1B,MAAM,MAAM,GAAG,IAAI,GAAG,EAAiB,CAAC;YACxC,IAAI,iBAAiB,GAAG,CAAC,CAAC;YAE1B,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;gBACpB,IAAI,CAAC;oBACH,OAAO,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;wBACvD,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBAC7B,CAAC;oBAED,IAAI,CAAC,IAAI,CAAC,OAAO;wBAAE,MAAM;oBAEzB,MAAM,cAAc,GAAG,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC;oBACtD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;oBAEvD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAClC,OAAO,EACP,SAAS,EACT,IAAI,CAAC,UAAU,EACf,OAAO,EACP,KAAK,EACL,OAAO,EACP,IAAI,EACJ,SAAS,EACT,UAAU,EACV,GAAG,CACJ,CAAC;oBAEF,iBAAiB,GAAG,CAAC,CAAC;oBAEtB,IAAI,CAAC,MAAM;wBAAE,SAAS;oBAEtB,MAAM,QAAQ,GAAG,MAAoD,CAAC;oBACtE,KAAK,MAAM,CAAC,EAAE,cAAc,CAAC,IAAI,QAAQ,EAAE,CAAC;wBAC1C,KAAK,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,cAAc,EAAE,CAAC;4BACjD,MAAM,UAAU,GAAG,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;4BAChD,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;4BACvB,KAAK,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;wBAC3D,CAAC;oBACH,CAAC;gBACH,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,CAAC,IAAI,CAAC,OAAO;wBAAE,MAAM;oBACzB,iBAAiB,EAAE,CAAC;oBACpB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,EAAE;wBACxC,UAAU;wBACV,KAAK,EAAE,IAAA,6BAAe,EAAC,KAAK,CAAC;wBAC7B,iBAAiB;wBACjB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;qBACpC,CAAC,CAAC;oBACH,MAAM,OAAO,GACX,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,iBAAiB,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;oBACpF,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;gBACnD,CAAC;YACH,CAAC;YAED,IAAI,MAAM,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBACpB,MAAM,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;KAAA;CACF;AAzFD,oCAyFC"}

package/dist/command-bus/transport/consumer-loop.spec.js

@@ -0,0 +1,216 @@
+"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 consumer_loop_1 = require("./consumer-loop");
+/**
+ * Mock helpers
+ */
+function createMockLogger() {
+    return {
+        log: jest.fn(),
+        error: jest.fn(),
+        warn: jest.fn(),
+        debug: jest.fn(),
+    };
+}
+/**
+ * Tworzy mock Redis connection z disconnect() który przerywa blocking operations
+ */
+function createMockConnection() {
+    const pendingRejects = [];
+    return {
+        xreadgroup: jest.fn().mockImplementation(() => new Promise((_resolve, reject) => {
+            pendingRejects.push(reject);
+        })),
+        disconnect: jest.fn().mockImplementation(() => {
+            const disconnectError = new Error('Connection is closed.');
+            while (pendingRejects.length > 0) {
+                const reject = pendingRejects.shift();
+                if (reject)
+                    reject(disconnectError);
+            }
+        }),
+        _pendingRejects: pendingRejects,
+    };
+}
+describe('ConsumerLoop', () => {
+    let loop;
+    let logger;
+    beforeEach(() => {
+        jest.clearAllMocks();
+        logger = createMockLogger();
+        loop = new consumer_loop_1.ConsumerLoop({
+            consumerId: 'test-consumer',
+            batchSize: 10,
+            concurrency: 5,
+            logger,
+        });
+    });
+    afterEach(() => {
+        loop.running = false;
+    });
+    describe('run()', () => {
+        it('powinien wywołać XREADGROUP z prawidłowymi parametrami', () => __awaiter(void 0, void 0, void 0, function* () {
+            const conn = createMockConnection();
+            const onMessage = jest.fn().mockResolvedValue(undefined);
+            // XREADGROUP zwraca jedną wiadomość, potem blocking
+            conn.xreadgroup.mockResolvedValueOnce([['cmd:Test', [['msg-1', ['data', 'payload']]]]]);
+            const runPromise = loop.run(conn, 'cmd:Test', 'workers', onMessage);
+            // Poczekaj na przetworzenie pierwszej wiadomości
+            yield new Promise((r) => setTimeout(r, 10));
+            // Zatrzymaj loop
+            loop.running = false;
+            conn.disconnect();
+            yield runPromise;
+            expect(conn.xreadgroup).toHaveBeenCalledWith('GROUP', 'workers', 'test-consumer', 'COUNT', expect.any(Number), 'BLOCK', 5000, 'STREAMS', 'cmd:Test', '>');
+        }));
+        it('powinien wywołać onMessage dla każdej wiadomości', () => __awaiter(void 0, void 0, void 0, function* () {
+            const conn = createMockConnection();
+            const onMessage = jest.fn().mockResolvedValue(undefined);
+            conn.xreadgroup.mockResolvedValueOnce([
+                [
+                    'cmd:Test',
+                    [
+                        ['msg-1', ['data', 'payload1']],
+                        ['msg-2', ['data', 'payload2']],
+                    ],
+                ],
+            ]);
+            const runPromise = loop.run(conn, 'cmd:Test', 'workers', onMessage);
+            yield new Promise((r) => setTimeout(r, 10));
+            loop.running = false;
+            conn.disconnect();
+            yield runPromise;
+            expect(onMessage).toHaveBeenCalledTimes(2);
+            expect(onMessage).toHaveBeenCalledWith('msg-1', ['data', 'payload1']);
+            expect(onMessage).toHaveBeenCalledWith('msg-2', ['data', 'payload2']);
+        }));
+        it('powinien zakończyć gracefully gdy running = false', () => __awaiter(void 0, void 0, void 0, function* () {
+            const conn = createMockConnection();
+            const onMessage = jest.fn().mockResolvedValue(undefined);
+            loop.running = false;
+            const runPromise = loop.run(conn, 'cmd:Test', 'workers', onMessage);
+            yield runPromise;
+            expect(onMessage).not.toHaveBeenCalled();
+        }));
+        it('powinien czekać na aktywne zadania przy shutdown', () => __awaiter(void 0, void 0, void 0, function* () {
+            const conn = createMockConnection();
+            let handlerResolve;
+            const handlerPromise = new Promise((resolve) => {
+                handlerResolve = resolve;
+            });
+            const onMessage = jest.fn().mockReturnValueOnce(handlerPromise);
+            conn.xreadgroup.mockResolvedValueOnce([['cmd:Test', [['msg-1', ['data', 'payload']]]]]);
+            const runPromise = loop.run(conn, 'cmd:Test', 'workers', onMessage);
+            // Poczekaj na start przetwarzania
+            yield new Promise((r) => setTimeout(r, 10));
+            // Zatrzymaj loop (ale handler jeszcze pracuje)
+            loop.running = false;
+            conn.disconnect();
+            // Handler jeszcze nie zakończony — run() powinno czekać
+            const raceResult = yield Promise.race([
+                runPromise.then(() => 'finished'),
+                new Promise((r) => setTimeout(r, 50)).then(() => 'timeout'),
+            ]);
+            expect(raceResult).toBe('timeout');
+            // Zakończ handler
+            handlerResolve();
+            yield runPromise;
+        }));
+        it('powinien zalogować błąd i kontynuować po błędzie XREADGROUP', () => __awaiter(void 0, void 0, void 0, function* () {
+            jest.useFakeTimers();
+            const conn = createMockConnection();
+            const onMessage = jest.fn().mockResolvedValue(undefined);
+            // Pierwszy call — error, drugi — null (timeout), trzeci — zatrzymujemy
+            conn.xreadgroup.mockRejectedValueOnce(new Error('Redis error')).mockResolvedValueOnce(null);
+            const runPromise = loop.run(conn, 'cmd:Test', 'workers', onMessage);
+            // Advance timer past backoff
+            yield jest.advanceTimersByTimeAsync(2000);
+            // Zatrzymaj loop
+            loop.running = false;
+            conn.disconnect();
+            yield jest.advanceTimersByTimeAsync(1000);
+            yield runPromise;
+            expect(logger.error).toHaveBeenCalledWith('Błąd w consumer loop', expect.objectContaining({
+                error: 'Redis error',
+                consecutiveErrors: 1,
+            }));
+            jest.useRealTimers();
+        }));
+        it('powinien stosować exponential backoff przy kolejnych błędach', () => __awaiter(void 0, void 0, void 0, function* () {
+            jest.useFakeTimers();
+            const conn = createMockConnection();
+            const onMessage = jest.fn().mockResolvedValue(undefined);
+            // 3 kolejne błędy
+            conn.xreadgroup
+                .mockRejectedValueOnce(new Error('error 1'))
+                .mockRejectedValueOnce(new Error('error 2'))
+                .mockRejectedValueOnce(new Error('error 3'));
+            const runPromise = loop.run(conn, 'cmd:Test', 'workers', onMessage);
+            // Advance past first backoff (~1s + jitter)
+            yield jest.advanceTimersByTimeAsync(2500);
+            // Advance past second backoff (~2s + jitter)
+            yield jest.advanceTimersByTimeAsync(3500);
+            // Advance past third backoff (~4s + jitter)
+            yield jest.advanceTimersByTimeAsync(5500);
+            loop.running = false;
+            conn.disconnect();
+            yield jest.advanceTimersByTimeAsync(1000);
+            yield runPromise;
+            expect(logger.error).toHaveBeenCalledTimes(3);
+            jest.useRealTimers();
+        }));
+        it('powinien zakończyć od razu przy błędzie gdy running = false', () => __awaiter(void 0, void 0, void 0, function* () {
+            const conn = createMockConnection();
+            const onMessage = jest.fn().mockResolvedValue(undefined);
+            // Symuluj disconnect error
+            conn.xreadgroup.mockRejectedValueOnce(new Error('Connection is closed.'));
+            loop.running = false;
+            const runPromise = loop.run(conn, 'cmd:Test', 'workers', onMessage);
+            yield runPromise;
+            // Nie powinien logować błędu (running = false = graceful shutdown)
+            expect(logger.error).not.toHaveBeenCalled();
+        }));
+        it('powinien limitować concurrency do skonfigurowanego limitu', () => __awaiter(void 0, void 0, void 0, function* () {
+            const smallLoop = new consumer_loop_1.ConsumerLoop({
+                consumerId: 'test-consumer',
+                batchSize: 10,
+                concurrency: 2,
+                logger,
+            });
+            const conn = createMockConnection();
+            const handlerResolves = [];
+            const onMessage = jest.fn().mockImplementation(() => new Promise((resolve) => {
+                handlerResolves.push(resolve);
+            }));
+            // Zwróć 5 wiadomości naraz
+            conn.xreadgroup.mockResolvedValueOnce([
+                [
+                    'cmd:Test',
+                    [
+                        ['msg-1', ['data', 'p1']],
+                        ['msg-2', ['data', 'p2']],
+                    ],
+                ],
+            ]);
+            const runPromise = smallLoop.run(conn, 'cmd:Test', 'workers', onMessage);
+            yield new Promise((r) => setTimeout(r, 20));
+            // Callback powinien być wywołany 2 razy (concurrency = 2)
+            expect(onMessage).toHaveBeenCalledTimes(2);
+            // Cleanup
+            handlerResolves.forEach((r) => r());
+            smallLoop.running = false;
+            conn.disconnect();
+            yield runPromise;
+        }));
+    });
+});
+//# sourceMappingURL=consumer-loop.spec.js.map

package/dist/command-bus/transport/consumer-loop.spec.js.map

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

package/dist/command-bus/transport/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Moduł transportu dla CommandBus
+ *
+ * Eksportuje interfejsy segregowane (ISP) i fasadę RedisStreamsTransport
+ * oraz poszczególne komponenty dla zaawansowanego użycia
+ */
+export type { ITransport, IStreamProducer, IStreamConsumer, IRpcTransport, IClosable, ConsumerHandler, RpcMessageMetadata, } from './transport.interface';
+export { default as RedisStreamsTransport } from './redis-streams-transport';
+export type { RedisStreamsTransportOptions } from './redis-streams-transport';
+export { RedisCodec } from './redis-codec';
+export { StreamProducer } from './stream-producer';
+export { StreamConsumer } from './stream-consumer';
+export type { StreamConsumerOptions } from './stream-consumer';
+export { MessageProcessor } from './message-processor';
+export type { MessageProcessorOptions, RpcResponder } from './message-processor';
+export { ConsumerLoop } from './consumer-loop';
+export type { ConsumerLoopOptions, MessageCallback } from './consumer-loop';
+export { RpcHandler } from './rpc-handler';
+export type { RpcEnvelope } from './rpc-handler';
+export { PendingRecovery } from './pending-recovery';
+export type { PendingRecoveryOptions } from './pending-recovery';

package/dist/command-bus/transport/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PendingRecovery = exports.RpcHandler = exports.ConsumerLoop = exports.MessageProcessor = exports.StreamConsumer = exports.StreamProducer = exports.RedisCodec = exports.RedisStreamsTransport = void 0;
+var redis_streams_transport_1 = require("./redis-streams-transport");
+Object.defineProperty(exports, "RedisStreamsTransport", { enumerable: true, get: function () { return __importDefault(redis_streams_transport_1).default; } });
+var redis_codec_1 = require("./redis-codec");
+Object.defineProperty(exports, "RedisCodec", { enumerable: true, get: function () { return redis_codec_1.RedisCodec; } });
+var stream_producer_1 = require("./stream-producer");
+Object.defineProperty(exports, "StreamProducer", { enumerable: true, get: function () { return stream_producer_1.StreamProducer; } });
+var stream_consumer_1 = require("./stream-consumer");
+Object.defineProperty(exports, "StreamConsumer", { enumerable: true, get: function () { return stream_consumer_1.StreamConsumer; } });
+var message_processor_1 = require("./message-processor");
+Object.defineProperty(exports, "MessageProcessor", { enumerable: true, get: function () { return message_processor_1.MessageProcessor; } });
+var consumer_loop_1 = require("./consumer-loop");
+Object.defineProperty(exports, "ConsumerLoop", { enumerable: true, get: function () { return consumer_loop_1.ConsumerLoop; } });
+var rpc_handler_1 = require("./rpc-handler");
+Object.defineProperty(exports, "RpcHandler", { enumerable: true, get: function () { return rpc_handler_1.RpcHandler; } });
+var pending_recovery_1 = require("./pending-recovery");
+Object.defineProperty(exports, "PendingRecovery", { enumerable: true, get: function () { return pending_recovery_1.PendingRecovery; } });
+//# sourceMappingURL=index.js.map

package/dist/command-bus/transport/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/command-bus/transport/index.ts"],"names":[],"mappings":";;;;;;AAeA,qEAA6E;AAApE,iJAAA,OAAO,OAAyB;AAEzC,6CAA2C;AAAlC,yGAAA,UAAU,OAAA;AACnB,qDAAmD;AAA1C,iHAAA,cAAc,OAAA;AACvB,qDAAmD;AAA1C,iHAAA,cAAc,OAAA;AAEvB,yDAAuD;AAA9C,qHAAA,gBAAgB,OAAA;AAEzB,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AAErB,6CAA2C;AAAlC,yGAAA,UAAU,OAAA;AAEnB,uDAAqD;AAA5C,mHAAA,eAAe,OAAA"}

package/dist/command-bus/transport/message-processor.d.ts

@@ -0,0 +1,70 @@
+import type { ILogger } from '../../shared/types';
+import type { ISerializer } from '../serialization/serializer.interface';
+import type { ConsumerHandler } from './transport.interface';
+import type RedisConnectionPool from '../../shared/redis/connection-pool';
+import type { ICommandInterceptor } from '../interceptors';
+/**
+ * Typ callbacka do wysyłania odpowiedzi RPC
+ */
+export type RpcResponder = (responseKey: string, data: Buffer, ttl: number) => Promise<void>;
+/**
+ * Konfiguracja MessageProcessor
+ */
+export interface MessageProcessorOptions {
+    pool: RedisConnectionPool;
+    serializer: ISerializer;
+    logger: ILogger;
+    batchSize: number;
+    maxRetained: number;
+    rpcRespond: RpcResponder;
+    interceptor?: ICommandInterceptor;
+}
+/**
+ * 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)
+ */
+export declare class MessageProcessor {
+    private readonly pool;
+    private readonly serializer;
+    private readonly logger;
+    private readonly batchSize;
+    private readonly maxRetained;
+    private readonly rpcRespond;
+    private readonly interceptor?;
+    /** H2: Liczniki wiadomości od ostatniego XTRIM — per strumień */
+    private readonly xtrimCounters;
+    constructor(options: MessageProcessorOptions);
+    /**
+     * Czyści stan counters — wywoływane przy close()
+     */
+    reset(): void;
+    /**
+     * 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: string, groupName: string, messageId: string, fields: string[], handler: ConsumerHandler): Promise<void>;
+    /**
+     * Ekstrakcja commandId z commandData (deserializacja metadata)
+     */
+    private extractCommandId;
+    /**
+     * Ekstrakcja nazwy komendy ze streamName (usunięcie prefiksu 'cmd:')
+     */
+    private extractCommandName;
+}