pp-command-bus 1.4.0 → 2.0.0

package/dist/shared/redis/connection-pool.d.ts

@@ -0,0 +1,54 @@
+import { Redis, type RedisOptions } from 'ioredis';
+import type { ILogger } from '../types';
+/**
+ * Opcje konfiguracji puli połączeń Redis
+ */
+export interface ConnectionPoolOptions {
+    /** Opcje połączenia ioredis */
+    redisOptions: RedisOptions;
+    /** Rozmiar puli (domyślnie 2 * CPU count) */
+    size: number;
+    /** Logger */
+    logger: ILogger;
+}
+/**
+ * Pula połączeń Redis z round-robin dla operacji nieblokujących
+ *
+ * Przeznaczona dla komend takich jak XADD, XACK, DEL, pipeline
+ * które nie blokują połączenia. Połączenia tworzone eagerly przy starcie.
+ *
+ * DragonflyDB przetwarza komendy z wielu połączeń równolegle
+ * na różnych wątkach, więc więcej połączeń = lepszy throughput.
+ */
+export default class RedisConnectionPool {
+    private readonly options;
+    private readonly connections;
+    private index;
+    private closed;
+    constructor(options: ConnectionPoolOptions);
+    /**
+     * Zwraca następne połączenie z puli (round-robin)
+     * Używaj wyłącznie do operacji nieblokujących (XADD, XACK, DEL, pipeline)
+     */
+    next(): Redis;
+    /**
+     * Tworzy nowe dedykowane połączenie (np. dla XREADGROUP BLOCK)
+     * Połączenie NIE jest częścią puli — caller odpowiada za zamknięcie
+     *
+     * @param name - Nazwa połączenia (do logów)
+     * @param overrideOptions - Opcje nadpisujące bazowe (np. maxRetriesPerRequest: null)
+     */
+    createDedicated(name: string, overrideOptions?: Partial<RedisOptions>): Redis;
+    /**
+     * Zwraca rozmiar puli
+     */
+    get size(): number;
+    /**
+     * Zamyka wszystkie połączenia w puli
+     */
+    close(): Promise<void>;
+    /**
+     * Konfiguruje handlery eventów dla połączenia
+     */
+    private setupEventHandlers;
+}

package/dist/shared/redis/connection-pool.js

@@ -0,0 +1,117 @@
+"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 ioredis_1 = require("ioredis");
+const redis_error_formatter_1 = require("./redis-error-formatter");
+/**
+ * Pula połączeń Redis z round-robin dla operacji nieblokujących
+ *
+ * Przeznaczona dla komend takich jak XADD, XACK, DEL, pipeline
+ * które nie blokują połączenia. Połączenia tworzone eagerly przy starcie.
+ *
+ * DragonflyDB przetwarza komendy z wielu połączeń równolegle
+ * na różnych wątkach, więc więcej połączeń = lepszy throughput.
+ */
+class RedisConnectionPool {
+    constructor(options) {
+        this.options = options;
+        this.index = 0;
+        this.closed = false;
+        const { size, redisOptions, logger } = options;
+        if (size < 1) {
+            throw new Error('Rozmiar puli połączeń musi wynosić co najmniej 1');
+        }
+        this.connections = Array.from({ length: size }, (_, i) => {
+            const conn = new ioredis_1.Redis(redisOptions);
+            this.setupEventHandlers(conn, `Pool[${i}]`, logger);
+            return conn;
+        });
+        logger.debug('Pula połączeń Redis utworzona', {
+            size,
+            timestamp: new Date().toISOString(),
+        });
+    }
+    /**
+     * Zwraca następne połączenie z puli (round-robin)
+     * Używaj wyłącznie do operacji nieblokujących (XADD, XACK, DEL, pipeline)
+     */
+    next() {
+        if (this.closed) {
+            throw new Error('Pula połączeń jest zamknięta');
+        }
+        const conn = this.connections[this.index];
+        this.index = (this.index + 1) % this.connections.length;
+        return conn;
+    }
+    /**
+     * Tworzy nowe dedykowane połączenie (np. dla XREADGROUP BLOCK)
+     * Połączenie NIE jest częścią puli — caller odpowiada za zamknięcie
+     *
+     * @param name - Nazwa połączenia (do logów)
+     * @param overrideOptions - Opcje nadpisujące bazowe (np. maxRetriesPerRequest: null)
+     */
+    createDedicated(name, overrideOptions) {
+        if (this.closed) {
+            throw new Error('Pula połączeń jest zamknięta');
+        }
+        const conn = new ioredis_1.Redis(Object.assign(Object.assign({}, this.options.redisOptions), overrideOptions));
+        this.setupEventHandlers(conn, `Dedicated[${name}]`, this.options.logger);
+        return conn;
+    }
+    /**
+     * Zwraca rozmiar puli
+     */
+    get size() {
+        return this.connections.length;
+    }
+    /**
+     * Zamyka wszystkie połączenia w puli
+     */
+    close() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.closed)
+                return;
+            this.closed = true;
+            this.options.logger.debug('Zamykanie puli połączeń Redis', {
+                size: this.connections.length,
+                timestamp: new Date().toISOString(),
+            });
+            yield Promise.all(this.connections.map((c) => c.quit()));
+        });
+    }
+    /**
+     * Konfiguruje handlery eventów dla połączenia
+     */
+    setupEventHandlers(connection, name, logger) {
+        connection.on('error', (error) => {
+            logger.error(`Błąd połączenia Redis (${name})`, {
+                connectionName: name,
+                error: (0, redis_error_formatter_1.formatRedisError)(error),
+                errorCode: (0, redis_error_formatter_1.getErrorCode)(error),
+                timestamp: new Date().toISOString(),
+            });
+        });
+        connection.on('close', () => {
+            logger.warn(`Połączenie Redis zamknięte (${name})`, {
+                connectionName: name,
+                timestamp: new Date().toISOString(),
+            });
+        });
+        connection.on('reconnecting', () => {
+            logger.log(`Ponowne łączenie z Redis (${name})`, {
+                connectionName: name,
+                timestamp: new Date().toISOString(),
+            });
+        });
+    }
+}
+exports.default = RedisConnectionPool;
+//# sourceMappingURL=connection-pool.js.map

package/dist/shared/redis/connection-pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-pool.js","sourceRoot":"","sources":["../../../src/shared/redis/connection-pool.ts"],"names":[],"mappings":"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"}

package/dist/shared/redis/connection-pool.spec.js

@@ -0,0 +1,114 @@
+"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());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const connection_pool_1 = __importDefault(require("./connection-pool"));
+// Mock ioredis
+jest.mock('ioredis', () => {
+    const mockRedis = jest.fn().mockImplementation(() => ({
+        on: jest.fn(),
+        quit: jest.fn().mockResolvedValue('OK'),
+        status: 'ready',
+    }));
+    return { Redis: mockRedis };
+});
+const createMockLogger = () => ({
+    log: jest.fn(),
+    error: jest.fn(),
+    warn: jest.fn(),
+    debug: jest.fn(),
+});
+describe('RedisConnectionPool', () => {
+    let logger;
+    beforeEach(() => {
+        logger = createMockLogger();
+        jest.clearAllMocks();
+    });
+    describe('konstruktor', () => {
+        it('powinien utworzyć pulę z określoną liczbą połączeń', () => {
+            const pool = new connection_pool_1.default({
+                size: 4,
+                redisOptions: { host: 'localhost', port: 6379 },
+                logger,
+            });
+            expect(pool.size).toBe(4);
+        });
+        it('powinien rzucić błąd gdy rozmiar puli < 1', () => {
+            expect(() => new connection_pool_1.default({
+                size: 0,
+                redisOptions: { host: 'localhost', port: 6379 },
+                logger,
+            })).toThrow('Rozmiar puli połączeń musi wynosić co najmniej 1');
+        });
+    });
+    describe('next()', () => {
+        it('powinien zwracać połączenia w trybie round-robin', () => {
+            const pool = new connection_pool_1.default({
+                size: 3,
+                redisOptions: { host: 'localhost', port: 6379 },
+                logger,
+            });
+            const first = pool.next();
+            const second = pool.next();
+            const third = pool.next();
+            const fourth = pool.next(); // Wraca do pierwszego
+            expect(first).not.toBe(second);
+            expect(second).not.toBe(third);
+            expect(fourth).toBe(first); // Round-robin wraca do początku
+        });
+        it('powinien rzucić błąd po zamknięciu puli', () => __awaiter(void 0, void 0, void 0, function* () {
+            const pool = new connection_pool_1.default({
+                size: 2,
+                redisOptions: { host: 'localhost', port: 6379 },
+                logger,
+            });
+            yield pool.close();
+            expect(() => pool.next()).toThrow('Pula połączeń jest zamknięta');
+        }));
+    });
+    describe('createDedicated()', () => {
+        it('powinien utworzyć nowe dedykowane połączenie', () => {
+            const pool = new connection_pool_1.default({
+                size: 2,
+                redisOptions: { host: 'localhost', port: 6379 },
+                logger,
+            });
+            const dedicated = pool.createDedicated('consumer-1');
+            expect(dedicated).toBeDefined();
+            // Dedykowane połączenie nie jest częścią puli
+            expect(dedicated).not.toBe(pool.next());
+        });
+        it('powinien rzucić błąd po zamknięciu puli', () => __awaiter(void 0, void 0, void 0, function* () {
+            const pool = new connection_pool_1.default({
+                size: 2,
+                redisOptions: { host: 'localhost', port: 6379 },
+                logger,
+            });
+            yield pool.close();
+            expect(() => pool.createDedicated('test')).toThrow('Pula połączeń jest zamknięta');
+        }));
+    });
+    describe('close()', () => {
+        it('powinien zamknąć wszystkie połączenia', () => __awaiter(void 0, void 0, void 0, function* () {
+            const pool = new connection_pool_1.default({
+                size: 3,
+                redisOptions: { host: 'localhost', port: 6379 },
+                logger,
+            });
+            yield pool.close();
+            // Drugie close nie powinno rzucić błędu (idempotentność)
+            yield pool.close();
+        }));
+    });
+});
+//# sourceMappingURL=connection-pool.spec.js.map

package/dist/shared/redis/connection-pool.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-pool.spec.js","sourceRoot":"","sources":["../../../src/shared/redis/connection-pool.spec.ts"],"names":[],"mappings":"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"}

package/dist/shared/redis/index.d.ts

@@ -1,6 +1,8 @@
 /**
- * Moduł Redis - eksporty publiczne
+ * Moduł Redis — eksporty publiczne
  */
-export { default as RedisConnectionFactory } from './redis-connection-factory';
-export type { RedisConnectionOptions } from './redis-connection-factory';
+export { default as RedisConnectionPool } from './connection-pool';
+export type { ConnectionPoolOptions } from './connection-pool';
+export { default as RpcConnectionPool } from './rpc-connection-pool';
+export type { RpcConnectionPoolOptions } from './rpc-connection-pool';
 export { formatRedisError, getErrorCode } from './redis-error-formatter';

package/dist/shared/redis/index.js

@@ -1,14 +1,16 @@
 "use strict";
 /**
- * Moduł Redis - eksporty publiczne
+ * Moduł Redis — eksporty publiczne
  */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getErrorCode = exports.formatRedisError = exports.RedisConnectionFactory = void 0;
-var redis_connection_factory_1 = require("./redis-connection-factory");
-Object.defineProperty(exports, "RedisConnectionFactory", { enumerable: true, get: function () { return __importDefault(redis_connection_factory_1).default; } });
+exports.getErrorCode = exports.formatRedisError = exports.RpcConnectionPool = exports.RedisConnectionPool = void 0;
+var connection_pool_1 = require("./connection-pool");
+Object.defineProperty(exports, "RedisConnectionPool", { enumerable: true, get: function () { return __importDefault(connection_pool_1).default; } });
+var rpc_connection_pool_1 = require("./rpc-connection-pool");
+Object.defineProperty(exports, "RpcConnectionPool", { enumerable: true, get: function () { return __importDefault(rpc_connection_pool_1).default; } });
 var redis_error_formatter_1 = require("./redis-error-formatter");
 Object.defineProperty(exports, "formatRedisError", { enumerable: true, get: function () { return redis_error_formatter_1.formatRedisError; } });
 Object.defineProperty(exports, "getErrorCode", { enumerable: true, get: function () { return redis_error_formatter_1.getErrorCode; } });

package/dist/shared/redis/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/redis/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;AAEH,uEAA+E;AAAtE,mJAAA,OAAO,OAA0B;AAE1C,iEAAyE;AAAhE,yHAAA,gBAAgB,OAAA;AAAE,qHAAA,YAAY,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/redis/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;AAEH,qDAAmE;AAA1D,uIAAA,OAAO,OAAuB;AAEvC,6DAAqE;AAA5D,yIAAA,OAAO,OAAqB;AAErC,iEAAyE;AAAhE,yHAAA,gBAAgB,OAAA;AAAE,qHAAA,YAAY,OAAA"}

package/dist/shared/redis/rpc-connection-pool.d.ts

@@ -0,0 +1,61 @@
+import { Redis, type RedisOptions } from 'ioredis';
+import type { ILogger } from '../types';
+/**
+ * Opcje konfiguracji puli RPC połączeń
+ */
+export interface RpcConnectionPoolOptions {
+    /** Opcje połączenia ioredis */
+    redisOptions: RedisOptions;
+    /** Maksymalna liczba równoległych połączeń (domyślnie 50) */
+    maxSize: number;
+    /** Logger */
+    logger: ILogger;
+}
+/**
+ * Bounded, lazy pula połączeń dla operacji blokujących (BRPOP)
+ *
+ * Każde aktywne wywołanie RPC potrzebuje dedykowanego połączenia,
+ * ponieważ BRPOP blokuje cały socket do momentu odpowiedzi lub timeout.
+ *
+ * Połączenia tworzone leniwie przy acquire() i reużywane po release().
+ * Jeśli limit osiągnięty — caller czeka na wolne połączenie.
+ *
+ * DragonflyDB obsługuje tysiące połączeń efektywnie (multi-threaded),
+ * więc 50 concurrent BRPOP = ~100KB pamięci + 50 TCP socketów.
+ */
+export default class RpcConnectionPool {
+    private readonly options;
+    private readonly available;
+    private active;
+    private readonly waiting;
+    /** Wypożyczone połączenia — śledzone do zamknięcia w close() */
+    private readonly borrowed;
+    private closed;
+    constructor(options: RpcConnectionPoolOptions);
+    /**
+     * Pobiera połączenie z puli (lazy init, czeka jeśli limit osiągnięty)
+     * Caller MUSI wywołać release() po zakończeniu BRPOP
+     */
+    acquire(): Promise<Redis>;
+    /**
+     * Zwraca połączenie do puli
+     * Jeśli ktoś czeka — oddaje mu połączenie bez odkładania do available
+     */
+    release(conn: Redis): void;
+    /**
+     * Zwraca liczbę aktywnych (wypożyczonych) połączeń
+     */
+    get activeCount(): number;
+    /**
+     * Zwraca liczbę czekających na połączenie
+     */
+    get waitingCount(): number;
+    /**
+     * Zamyka wszystkie połączenia w puli
+     */
+    close(): Promise<void>;
+    /**
+     * Konfiguruje handlery eventów dla połączenia
+     */
+    private setupEventHandlers;
+}

package/dist/shared/redis/rpc-connection-pool.js

@@ -0,0 +1,154 @@
+"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 ioredis_1 = require("ioredis");
+const redis_error_formatter_1 = require("./redis-error-formatter");
+/**
+ * Bounded, lazy pula połączeń dla operacji blokujących (BRPOP)
+ *
+ * Każde aktywne wywołanie RPC potrzebuje dedykowanego połączenia,
+ * ponieważ BRPOP blokuje cały socket do momentu odpowiedzi lub timeout.
+ *
+ * Połączenia tworzone leniwie przy acquire() i reużywane po release().
+ * Jeśli limit osiągnięty — caller czeka na wolne połączenie.
+ *
+ * DragonflyDB obsługuje tysiące połączeń efektywnie (multi-threaded),
+ * więc 50 concurrent BRPOP = ~100KB pamięci + 50 TCP socketów.
+ */
+class RpcConnectionPool {
+    constructor(options) {
+        this.options = options;
+        this.available = [];
+        this.active = 0;
+        this.waiting = [];
+        /** Wypożyczone połączenia — śledzone do zamknięcia w close() */
+        this.borrowed = new Set();
+        this.closed = false;
+        if (options.maxSize < 1) {
+            throw new Error('Maksymalny rozmiar puli RPC musi wynosić co najmniej 1');
+        }
+        options.logger.debug('Pula połączeń RPC utworzona', {
+            maxSize: options.maxSize,
+            timestamp: new Date().toISOString(),
+        });
+    }
+    /**
+     * Pobiera połączenie z puli (lazy init, czeka jeśli limit osiągnięty)
+     * Caller MUSI wywołać release() po zakończeniu BRPOP
+     */
+    acquire() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.closed) {
+                throw new Error('Pula połączeń RPC jest zamknięta');
+            }
+            // Spróbuj użyć wolnego połączenia
+            const free = this.available.pop();
+            if (free) {
+                this.active++;
+                this.borrowed.add(free);
+                return free;
+            }
+            // Stwórz nowe jeśli limit nie osiągnięty
+            if (this.active < this.options.maxSize) {
+                this.active++;
+                const conn = new ioredis_1.Redis(Object.assign(Object.assign({}, this.options.redisOptions), { maxRetriesPerRequest: null }));
+                this.setupEventHandlers(conn, `RpcPool[${this.active}]`);
+                this.borrowed.add(conn);
+                return conn;
+            }
+            // Limit osiągnięty — czekaj na release
+            return new Promise((resolve, reject) => {
+                this.waiting.push({ resolve, reject });
+            });
+        });
+    }
+    /**
+     * Zwraca połączenie do puli
+     * Jeśli ktoś czeka — oddaje mu połączenie bez odkładania do available
+     */
+    release(conn) {
+        this.active--;
+        this.borrowed.delete(conn);
+        // Jeśli pula zamknięta — zamknij zwrócone połączenie zamiast odkładać do available
+        if (this.closed) {
+            conn.disconnect();
+            return;
+        }
+        const next = this.waiting.shift();
+        if (next) {
+            this.active++;
+            this.borrowed.add(conn);
+            next.resolve(conn);
+            return;
+        }
+        this.available.push(conn);
+    }
+    /**
+     * Zwraca liczbę aktywnych (wypożyczonych) połączeń
+     */
+    get activeCount() {
+        return this.active;
+    }
+    /**
+     * Zwraca liczbę czekających na połączenie
+     */
+    get waitingCount() {
+        return this.waiting.length;
+    }
+    /**
+     * Zamyka wszystkie połączenia w puli
+     */
+    close() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.closed)
+                return;
+            this.closed = true;
+            // Odrzuć czekających — reject ich promises żeby nie wisieli w pamięci
+            const closeError = new Error('Pula połączeń RPC została zamknięta');
+            while (this.waiting.length > 0) {
+                const waiter = this.waiting.shift();
+                if (waiter) {
+                    waiter.reject(closeError);
+                }
+            }
+            this.options.logger.debug('Zamykanie puli połączeń RPC', {
+                available: this.available.length,
+                active: this.active,
+                borrowed: this.borrowed.size,
+                timestamp: new Date().toISOString(),
+            });
+            // Zamknij wolne połączenia gracefully
+            yield Promise.all(this.available.map((c) => c.quit()));
+            this.available.length = 0;
+            // Zamknij wypożyczone połączenia (mogą mieć blocking BRPOP) — disconnect przerywa natychmiast
+            for (const conn of this.borrowed) {
+                conn.disconnect();
+            }
+            this.borrowed.clear();
+        });
+    }
+    /**
+     * Konfiguruje handlery eventów dla połączenia
+     */
+    setupEventHandlers(connection, name) {
+        const logger = this.options.logger;
+        connection.on('error', (error) => {
+            logger.error(`Błąd połączenia Redis (${name})`, {
+                connectionName: name,
+                error: (0, redis_error_formatter_1.formatRedisError)(error),
+                errorCode: (0, redis_error_formatter_1.getErrorCode)(error),
+                timestamp: new Date().toISOString(),
+            });
+        });
+    }
+}
+exports.default = RpcConnectionPool;
+//# sourceMappingURL=rpc-connection-pool.js.map

package/dist/shared/redis/rpc-connection-pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-connection-pool.js","sourceRoot":"","sources":["../../../src/shared/redis/rpc-connection-pool.ts"],"names":[],"mappings":"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"}

package/dist/shared/redis/rpc-connection-pool.spec.d.ts

@@ -0,0 +1 @@
+export {};