pp-command-bus 1.5.0 → 2.0.1

package/dist/command-bus/transport/rpc-handler.spec.js

@@ -0,0 +1,157 @@
+"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 rpc_handler_1 = require("./rpc-handler");
+const redis_codec_1 = require("./redis-codec");
+/**
+ * Mock serializera — JSON roundtrip
+ */
+function createMockSerializer() {
+    return {
+        serialize: jest.fn((data) => Buffer.from(JSON.stringify(data))),
+        deserialize: jest.fn((buf) => JSON.parse(buf.toString())),
+    };
+}
+/**
+ * Mock połączenia Redis
+ */
+function createMockConnection() {
+    return {
+        xadd: jest.fn().mockResolvedValue('1700000000000-0'),
+        del: jest.fn().mockResolvedValue(1),
+        expire: jest.fn().mockResolvedValue(1),
+        brpop: jest.fn().mockResolvedValue(null),
+        lpush: jest.fn().mockResolvedValue(1),
+        pipeline: jest.fn().mockReturnValue({
+            lpush: jest.fn().mockReturnThis(),
+            expire: jest.fn().mockReturnThis(),
+            exec: jest.fn().mockResolvedValue([
+                [null, 1],
+                [null, 1],
+            ]),
+        }),
+    };
+}
+function createMockPool() {
+    const conn = createMockConnection();
+    return {
+        pool: { next: jest.fn().mockReturnValue(conn) },
+        conn,
+    };
+}
+function createMockRpcPool() {
+    const rpcConn = createMockConnection();
+    return {
+        rpcPool: {
+            acquire: jest.fn().mockResolvedValue(rpcConn),
+            release: jest.fn(),
+        },
+        rpcConn,
+    };
+}
+describe('RpcHandler', () => {
+    let handler;
+    let mockConn;
+    let rpcConn;
+    let mockPool;
+    let mockRpcPool;
+    let serializer;
+    beforeEach(() => {
+        jest.clearAllMocks();
+        const poolMock = createMockPool();
+        const rpcPoolMock = createMockRpcPool();
+        mockPool = poolMock.pool;
+        mockConn = poolMock.conn;
+        mockRpcPool = rpcPoolMock.rpcPool;
+        rpcConn = rpcPoolMock.rpcConn;
+        serializer = createMockSerializer();
+        handler = new rpc_handler_1.RpcHandler(mockPool, mockRpcPool, serializer);
+    });
+    describe('rpcCall()', () => {
+        it('powinien wysłać komendę do strumienia i czekać na odpowiedź', () => __awaiter(void 0, void 0, void 0, function* () {
+            const responseData = Buffer.from(JSON.stringify({ result: 42 }));
+            rpcConn.brpop.mockResolvedValue(['rpc:res:test', redis_codec_1.RedisCodec.encode(responseData)]);
+            const result = yield handler.rpcCall('TestCommand', Buffer.from('request'), 5000);
+            // Powinien wysłać XADD z markerem rpc
+            expect(mockConn.xadd).toHaveBeenCalledWith('cmd:TestCommand', '*', 'data', expect.any(String), 'rpc', '1');
+            // Powinien pobrać i zwolnić połączenie RPC
+            expect(mockRpcPool.acquire).toHaveBeenCalled();
+            expect(mockRpcPool.release).toHaveBeenCalled();
+            expect(result).toBeInstanceOf(Buffer);
+        }));
+        it('powinien rzucić timeout gdy BRPOP zwraca null', () => __awaiter(void 0, void 0, void 0, function* () {
+            rpcConn.brpop.mockResolvedValue(null);
+            yield expect(handler.rpcCall('TestCommand', Buffer.from('data'), 1000)).rejects.toThrow('RPC timeout dla komendy TestCommand (1000ms)');
+        }));
+        it('powinien zwolnić połączenie RPC nawet przy timeout', () => __awaiter(void 0, void 0, void 0, function* () {
+            rpcConn.brpop.mockResolvedValue(null);
+            yield expect(handler.rpcCall('TestCommand', Buffer.from('data'), 1000)).rejects.toThrow();
+            expect(mockRpcPool.release).toHaveBeenCalledWith(rpcConn);
+        }));
+        it('powinien await DEL na timeout (C2)', () => __awaiter(void 0, void 0, void 0, function* () {
+            rpcConn.brpop.mockResolvedValue(null);
+            mockConn.del.mockResolvedValue(1);
+            yield expect(handler.rpcCall('TestCommand', Buffer.from('data'), 1000)).rejects.toThrow();
+            expect(mockConn.del).toHaveBeenCalled();
+        }));
+        it('powinien ustawić EXPIRE jako fallback gdy DEL failuje (C2)', () => __awaiter(void 0, void 0, void 0, function* () {
+            rpcConn.brpop.mockResolvedValue(null);
+            mockConn.del.mockRejectedValue(new Error('Connection lost'));
+            yield expect(handler.rpcCall('TestCommand', Buffer.from('data'), 1000)).rejects.toThrow('RPC timeout');
+            expect(mockConn.del).toHaveBeenCalled();
+            expect(mockConn.expire).toHaveBeenCalledWith(expect.stringContaining('rpc:res:'), 120);
+        }));
+        it('nie powinien rzucać gdy zarówno DEL jak i EXPIRE failują (C2)', () => __awaiter(void 0, void 0, void 0, function* () {
+            rpcConn.brpop.mockResolvedValue(null);
+            mockConn.del.mockRejectedValue(new Error('Connection lost'));
+            mockConn.expire.mockRejectedValue(new Error('Connection lost'));
+            // Powinien rzucić TYLKO RPC timeout, nie błąd z DEL/EXPIRE
+            yield expect(handler.rpcCall('TestCommand', Buffer.from('data'), 1000)).rejects.toThrow('RPC timeout');
+        }));
+        it('nie powinien zawierać correlationId w error message (M2)', () => __awaiter(void 0, void 0, void 0, function* () {
+            rpcConn.brpop.mockResolvedValue(null);
+            try {
+                yield handler.rpcCall('TestCommand', Buffer.from('data'), 1000);
+            }
+            catch (error) {
+                const message = error.message;
+                expect(message).not.toContain('correlationId');
+            }
+        }));
+        it('powinien rzucić błąd przy timeout 0 (M1)', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield expect(handler.rpcCall('TestCommand', Buffer.from('data'), 0)).rejects.toThrow('Nieprawidłowy timeout RPC: 0ms');
+        }));
+        it('powinien rzucić błąd przy negatywnym timeout (M1)', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield expect(handler.rpcCall('TestCommand', Buffer.from('data'), -100)).rejects.toThrow('Nieprawidłowy timeout RPC: -100ms');
+        }));
+        it('powinien rzucić błąd przy Infinity timeout (M1)', () => __awaiter(void 0, void 0, void 0, function* () {
+            yield expect(handler.rpcCall('TestCommand', Buffer.from('data'), Infinity)).rejects.toThrow('Nieprawidłowy timeout RPC: Infinityms');
+        }));
+        it('powinien użyć minimum 1 sekundy dla BRPOP timeout', () => __awaiter(void 0, void 0, void 0, function* () {
+            const responseData = Buffer.from(JSON.stringify({ result: 'ok' }));
+            rpcConn.brpop.mockResolvedValue(['rpc:res:test', redis_codec_1.RedisCodec.encode(responseData)]);
+            yield handler.rpcCall('TestCommand', Buffer.from('data'), 100); // 100ms < 1s
+            // BRPOP powinien mieć timeout = 1 (minimalna wartość)
+            expect(rpcConn.brpop).toHaveBeenCalledWith(expect.stringContaining('rpc:res:'), 1);
+        }));
+    });
+    describe('rpcRespond()', () => {
+        it('powinien wysłać odpowiedź przez pipeline LPUSH + EXPIRE', () => __awaiter(void 0, void 0, void 0, function* () {
+            const responseData = Buffer.from('response');
+            yield handler.rpcRespond('rpc:res:test-id', responseData, 60);
+            const pipeline = mockConn.pipeline();
+            expect(mockConn.pipeline).toHaveBeenCalled();
+            expect(pipeline.lpush).toHaveBeenCalledWith('rpc:res:test-id', redis_codec_1.RedisCodec.encode(responseData));
+            expect(pipeline.expire).toHaveBeenCalledWith('rpc:res:test-id', 60);
+        }));
+    });
+});
+//# sourceMappingURL=rpc-handler.spec.js.map

package/dist/command-bus/transport/rpc-handler.spec.js.map

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

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

@@ -0,0 +1,91 @@
+import type { ILogger } from '../../shared/types';
+import type { ISerializer } from '../serialization/serializer.interface';
+import type { IStreamConsumer, ConsumerHandler } from './transport.interface';
+import type RedisConnectionPool from '../../shared/redis/connection-pool';
+import type { ICommandInterceptor } from '../interceptors';
+import type { RpcResponder } from './message-processor';
+/**
+ * Konfiguracja StreamConsumer
+ */
+export interface StreamConsumerOptions {
+    pool: RedisConnectionPool;
+    serializer: ISerializer;
+    logger: ILogger;
+    consumerId: string;
+    batchSize: number;
+    concurrency: number;
+    maxRetained: number;
+    rpcRespond: RpcResponder;
+    interceptor?: ICommandInterceptor;
+    /** Próg czasu (ms) po którym wpis w processing Map jest uznawany za stale (domyślnie 300_000 = 5min) */
+    staleThreshold?: number;
+    /** Minimalny interwał (ms) między sweepami stale wpisów (domyślnie 10_000 = 10s) */
+    sweepInterval?: number;
+}
+/**
+ * Koordynator konsumenta strumienia Redis — komponuje MessageProcessor i ConsumerLoop
+ *
+ * Odpowiedzialności:
+ * - Zarządzanie cyklem życia: tworzenie połączeń, consumer groups, uruchamianie loops
+ * - Deduplicacja (processing Map z TTL sweep) (H1)
+ * - Koordynacja komponentów: MessageProcessor i ConsumerLoop
+ *
+ * NIE odpowiada za:
+ * - Przetwarzanie wiadomości (MessageProcessor)
+ * - Consumer loop z concurrency limiter (ConsumerLoop)
+ */
+export declare class StreamConsumer implements IStreamConsumer {
+    private readonly pool;
+    private readonly logger;
+    private readonly consumerId;
+    private readonly batchSize;
+    private readonly concurrency;
+    /** H1: Próg czasu (ms) po którym wpis w processing Map jest uznawany za stale */
+    private readonly staleThreshold;
+    /** Timestamp ostatniego sweep — throttle co sweepInterval */
+    private lastSweepTime;
+    /** Minimalny interwał między sweep (ms) */
+    private readonly sweepInterval;
+    /** Procesor wiadomości — parsuje, waliduje, przetwarza */
+    private readonly messageProcessor;
+    /** Instancje consumer loops — do propagacji flagi running */
+    private readonly loops;
+    /** Dedykowane połączenia konsumentów (XREADGROUP BLOCK) */
+    private readonly consumerConnections;
+    /** Promises consumer loops — do graceful shutdown */
+    private readonly consumerLoopPromises;
+    /** H1: Wiadomości aktualnie przetwarzane — Map<messageId, timestamp> z TTL sweep */
+    private readonly processing;
+    /** Flaga zatrzymania — propaguje do wszystkich consumer loops */
+    private _running;
+    get running(): boolean;
+    set running(value: boolean);
+    /** Zwraca liczbę aktywnych konsumentów (do logów) */
+    get consumerCount(): number;
+    /**
+     * Zamyka dedykowane połączenia konsumentów (przerywa XREADGROUP BLOCK)
+     */
+    closeConnections(): void;
+    /**
+     * Czeka na zakończenie consumer loops
+     */
+    awaitLoops(): Promise<void>;
+    constructor(options: StreamConsumerOptions);
+    /**
+     * Rejestruje konsumenta dla strumienia z consumer group
+     * Tworzy dedykowane połączenie (XREADGROUP BLOCK blokuje socket)
+     */
+    consume(streamName: string, groupName: string, handler: ConsumerHandler): Promise<void>;
+    /**
+     * Przetwarza pojedynczą wiadomość ze strumienia
+     * Deduplicacja + delegacja do MessageProcessor
+     *
+     * Wywoływane zarówno przez ConsumerLoop (nowe wiadomości) jak i PendingRecovery (XCLAIM)
+     */
+    processMessage(streamName: string, groupName: string, messageId: string, fields: string[], handler: ConsumerHandler): Promise<void>;
+    /**
+     * H1: Usuwa stale wpisy z processing Map — zapobiega permanentnej blokadzie recovery
+     * Wpis uznawany za stale gdy trwa dłużej niż staleThreshold
+     */
+    private sweepStaleProcessing;
+}

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

@@ -0,0 +1,182 @@
+"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.StreamConsumer = void 0;
+const message_processor_1 = require("./message-processor");
+const consumer_loop_1 = require("./consumer-loop");
+const error_utils_1 = require("../../shared/utils/error-utils");
+/**
+ * Koordynator konsumenta strumienia Redis — komponuje MessageProcessor i ConsumerLoop
+ *
+ * Odpowiedzialności:
+ * - Zarządzanie cyklem życia: tworzenie połączeń, consumer groups, uruchamianie loops
+ * - Deduplicacja (processing Map z TTL sweep) (H1)
+ * - Koordynacja komponentów: MessageProcessor i ConsumerLoop
+ *
+ * NIE odpowiada za:
+ * - Przetwarzanie wiadomości (MessageProcessor)
+ * - Consumer loop z concurrency limiter (ConsumerLoop)
+ */
+class StreamConsumer {
+    get running() {
+        return this._running;
+    }
+    set running(value) {
+        this._running = value;
+        for (const loop of this.loops) {
+            loop.running = value;
+        }
+    }
+    /** Zwraca liczbę aktywnych konsumentów (do logów) */
+    get consumerCount() {
+        return this.consumerConnections.length;
+    }
+    /**
+     * Zamyka dedykowane połączenia konsumentów (przerywa XREADGROUP BLOCK)
+     */
+    closeConnections() {
+        for (const conn of this.consumerConnections) {
+            conn.disconnect();
+        }
+        this.consumerConnections.length = 0;
+    }
+    /**
+     * Czeka na zakończenie consumer loops
+     */
+    awaitLoops() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.consumerLoopPromises.length > 0) {
+                yield Promise.allSettled(this.consumerLoopPromises);
+                this.consumerLoopPromises.length = 0;
+            }
+        });
+    }
+    constructor(options) {
+        var _a, _b;
+        /** Timestamp ostatniego sweep — throttle co sweepInterval */
+        this.lastSweepTime = 0;
+        /** Instancje consumer loops — do propagacji flagi running */
+        this.loops = [];
+        /** Dedykowane połączenia konsumentów (XREADGROUP BLOCK) */
+        this.consumerConnections = [];
+        /** Promises consumer loops — do graceful shutdown */
+        this.consumerLoopPromises = [];
+        /** H1: Wiadomości aktualnie przetwarzane — Map<messageId, timestamp> z TTL sweep */
+        this.processing = new Map();
+        /** Flaga zatrzymania — propaguje do wszystkich consumer loops */
+        this._running = true;
+        this.pool = options.pool;
+        this.logger = options.logger;
+        this.consumerId = options.consumerId;
+        this.batchSize = options.batchSize;
+        this.concurrency = options.concurrency;
+        this.staleThreshold = (_a = options.staleThreshold) !== null && _a !== void 0 ? _a : 300000;
+        this.sweepInterval = (_b = options.sweepInterval) !== null && _b !== void 0 ? _b : 10000;
+        this.messageProcessor = new message_processor_1.MessageProcessor({
+            pool: options.pool,
+            serializer: options.serializer,
+            logger: options.logger,
+            batchSize: options.batchSize,
+            maxRetained: options.maxRetained,
+            rpcRespond: options.rpcRespond,
+            interceptor: options.interceptor,
+        });
+    }
+    /**
+     * Rejestruje konsumenta dla strumienia z consumer group
+     * Tworzy dedykowane połączenie (XREADGROUP BLOCK blokuje socket)
+     */
+    consume(streamName, groupName, handler) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const conn = this.pool.createDedicated(streamName);
+            this.consumerConnections.push(conn);
+            // Utwórz consumer group (ignoruj jeśli już istnieje)
+            try {
+                yield conn.xgroup('CREATE', streamName, groupName, '0', 'MKSTREAM');
+            }
+            catch (error) {
+                const msg = (0, error_utils_1.getErrorMessage)(error);
+                if (!msg.includes('BUSYGROUP')) {
+                    throw error;
+                }
+            }
+            // Utwórz consumer loop i uruchom w tle
+            const loop = new consumer_loop_1.ConsumerLoop({
+                consumerId: this.consumerId,
+                batchSize: this.batchSize,
+                concurrency: this.concurrency,
+                logger: this.logger,
+            });
+            this.loops.push(loop);
+            const loopPromise = loop.run(conn, streamName, groupName, (messageId, fields) => this.processMessage(streamName, groupName, messageId, fields, handler));
+            this.consumerLoopPromises.push(loopPromise);
+            this.logger.debug('Konsument zarejestrowany', {
+                streamName,
+                groupName,
+                consumerId: this.consumerId,
+                timestamp: new Date().toISOString(),
+            });
+        });
+    }
+    /**
+     * Przetwarza pojedynczą wiadomość ze strumienia
+     * Deduplicacja + delegacja do MessageProcessor
+     *
+     * Wywoływane zarówno przez ConsumerLoop (nowe wiadomości) jak i PendingRecovery (XCLAIM)
+     */
+    processMessage(streamName, groupName, messageId, fields, handler) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // H1: Throttled sweep stale wpisów — co sweepInterval zamiast na każdą wiadomość
+            const now = Date.now();
+            if (now - this.lastSweepTime > this.sweepInterval) {
+                this.sweepStaleProcessing();
+                this.lastSweepTime = now;
+            }
+            if (this.processing.has(messageId)) {
+                return;
+            }
+            this.processing.set(messageId, Date.now());
+            try {
+                yield this.messageProcessor.process(streamName, groupName, messageId, fields, handler);
+            }
+            catch (error) {
+                this.logger.error('Błąd przetwarzania wiadomości', {
+                    streamName,
+                    messageId,
+                    error: (0, error_utils_1.getErrorMessage)(error),
+                    timestamp: new Date().toISOString(),
+                });
+            }
+            finally {
+                this.processing.delete(messageId);
+            }
+        });
+    }
+    /**
+     * H1: Usuwa stale wpisy z processing Map — zapobiega permanentnej blokadzie recovery
+     * Wpis uznawany za stale gdy trwa dłużej niż staleThreshold
+     */
+    sweepStaleProcessing() {
+        const now = Date.now();
+        for (const [id, timestamp] of this.processing) {
+            if (now - timestamp > this.staleThreshold) {
+                this.processing.delete(id);
+                this.logger.warn('Usunięto stale wpis z processing Map', {
+                    messageId: id,
+                    age: now - timestamp,
+                    threshold: this.staleThreshold,
+                });
+            }
+        }
+    }
+}
+exports.StreamConsumer = StreamConsumer;
+//# sourceMappingURL=stream-consumer.js.map

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

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