pp-command-bus 1.4.0 → 2.0.0

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":";;;;;;;;;;;AAAA,2DAAuD;AAGvD,+CAA2C;AAU3C;;GAEG;AACH,SAAS,gBAAgB;IACvB,OAAO;QACL,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE;QACd,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE;QAChB,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE;QACf,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE;KACjB,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB;IAC3B,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,IAAa,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QACxE,WAAW,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;KAClE,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB;IAC3B,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC;QACpC,QAAQ,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC;YAClC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,cAAc,EAAE;YAChC,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,cAAc,EAAE;YACjC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;gBAChC,CAAC,IAAI,EAAE,CAAC,CAAC;gBACT,CAAC,IAAI,EAAE,CAAC,CAAC;aACV,CAAC;SACH,CAAC;KACH,CAAC;AACJ,CAAC;AAED,SAAS,cAAc;IAIrB,MAAM,IAAI,GAAG,oBAAoB,EAAE,CAAC;IACpC,OAAO;QACL,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE;QAC/C,IAAI;KACL,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,IAAI,SAA2B,CAAC;IAChC,IAAI,MAAe,CAAC;IACpB,IAAI,UAAuB,CAAC;IAC5B,IAAI,QAAwB,CAAC;IAC7B,IAAI,QAA6B,CAAC;IAClC,MAAM,UAAU,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAE1D,UAAU,CAAC,GAAG,EAAE;QACd,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,MAAM,GAAG,gBAAgB,EAAE,CAAC;QAC5B,UAAU,GAAG,oBAAoB,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC;QAClC,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC;QACzB,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC;QAEzB,SAAS,GAAG,IAAI,oCAAgB,CAAC;YAC/B,IAAI,EAAE,QAAiB;YACvB,UAAU;YACV,MAAM;YACN,SAAS,EAAE,EAAE;YACb,WAAW,EAAE,KAAK;YAClB,UAAU;SACX,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;QACzB,EAAE,CAAC,kDAAkD,EAAE,GAAS,EAAE;YAChE,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;YAClD,MAAM,WAAW,GAAG,wBAAU,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;YAChE,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;YAErC,MAAM,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YAEzE,MAAM,CAAC,OAAO,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;YACzC,MAAM,CAAC,OAAO,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3D,CAAC,CAAA,CAAC,CAAC;QAEH,EAAE,CAAC,0CAA0C,EAAE,GAAS,EAAE;YACxD,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;YAClD,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,wBAAU,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAEhE,MAAM,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YAEzE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,oBAAoB,CAAC,UAAU,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAC7E,CAAC,CAAA,CAAC,CAAC;QAEH,EAAE,CAAC,wDAAwD,EAAE,GAAS,EAAE;YACtE,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;YAE1B,MAAM,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;YAEzE,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;YACvC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,oBAAoB,CACtC,uCAAuC,EACvC,MAAM,CAAC,gBAAgB,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CACpD,CAAC;YACF,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,oBAAoB,CAAC,UAAU,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;QACjF,CAAC,CAAA,CAAC,CAAC;QAEH,EAAE,CAAC,qDAAqD,EAAE,GAAS,EAAE;YACnE,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;YAE1B,MAAM,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC;YAEjF,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;YACvC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,oBAAoB,CACtC,uCAAuC,EACvC,MAAM,CAAC,gBAAgB,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAClD,CAAC;QACJ,CAAC,CAAA,CAAC,CAAC;QAEH,EAAE,CAAC,gDAAgD,EAAE,GAAS,EAAE;YAC9D,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;YAE1B,MAAM,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;YAE1F,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;YACvC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,oBAAoB,CACtC,yBAAyB,EACzB,MAAM,CAAC,gBAAgB,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CACrD,CAAC;QACJ,CAAC,CAAA,CAAC,CAAC;QAEH,EAAE,CAAC,qDAAqD,EAAE,GAAS,EAAE;YACnE,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;YAClD,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,wBAAU,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;YAE7E,MAAM,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YAElF,MAAM,CAAC,OAAO,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAC3C,CAAC,CAAA,CAAC,CAAC;QAEH,EAAE,CAAC,8CAA8C,EAAE,GAAS,EAAE;YAC5D,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC;YACxE,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,wBAAU,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAEhE,MAAM,MAAM,CACV,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,CACrE,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QACrC,CAAC,CAAA,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;QAC7B,EAAE,CAAC,2DAA2D,EAAE,GAAS,EAAE;YACzE,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;YAEzD,MAAM,QAAQ,GAAG;gBACf,WAAW,EAAE,wBAAU,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBACvD,GAAG,EAAE,EAAE,aAAa,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE;aAChE,CAAC;YACF,MAAM,eAAe,GAAG,wBAAU,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YACjF,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;YAErD,MAAM,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YAE3E,MAAM,CAAC,OAAO,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;YACzC,MAAM,CAAC,UAAU,CAAC,CAAC,oBAAoB,CAAC,gBAAgB,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QACpF,CAAC,CAAA,CAAC,CAAC;QAEH,EAAE,CAAC,0DAA0D,EAAE,GAAS,EAAE;YACxE,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;YAClD,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,wBAAU,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;YAEvE,MAAM,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YAE9E,MAAM,CAAC,OAAO,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;YACzC,MAAM,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QAC5C,CAAC,CAAA,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;QACrC,EAAE,CAAC,iDAAiD,EAAE,GAAS,EAAE;YAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;YAClD,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,wBAAU,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAEhE,0EAA0E;YAC1E,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC3B,MAAM,SAAS,CAAC,OAAO,CAAC,aAAa,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YAC/E,CAAC;YAED,0BAA0B;YAC1B,MAAM,SAAS,CAAC,OAAO,CAAC,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YAE1E,2EAA2E;YAC3E,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;YAC3C,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAElC,wDAAwD;YACxD,MAAM,SAAS,CAAC,OAAO,CAAC,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YAE1E,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,gBAAgB,EAAE,CAAC;QAC/C,CAAC,CAAA,CAAC,CAAC;QAEH,EAAE,CAAC,mDAAmD,EAAE,GAAS,EAAE;YACjE,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;YAClD,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,wBAAU,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAEhE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC5B,MAAM,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YAC9E,CAAC;YAED,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QACrD,CAAC,CAAA,CAAC,CAAC;QAEH,EAAE,CAAC,sCAAsC,EAAE,GAAS,EAAE;YACpD,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;YAClD,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,wBAAU,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAEhE,8BAA8B;YAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC5B,MAAM,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YACjF,CAAC;YACD,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;YAEnD,2BAA2B;YAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC3B,MAAM,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YACjF,CAAC;YACD,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;YAEnD,yCAAyC;YACzC,MAAM,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YAC5E,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QACrD,CAAC,CAAA,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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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"}

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

@@ -0,0 +1,176 @@
+"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 pending_recovery_1 = require("./pending-recovery");
+/**
+ * Mock helpers
+ */
+function createMockLogger() {
+    return {
+        log: jest.fn(),
+        error: jest.fn(),
+        warn: jest.fn(),
+        debug: jest.fn(),
+    };
+}
+function createMockConnection() {
+    return {
+        xpending: jest.fn().mockResolvedValue([]),
+        xclaim: jest.fn().mockResolvedValue([]),
+        xack: jest.fn().mockResolvedValue(1),
+        xadd: jest.fn().mockResolvedValue('1700000000000-0'),
+    };
+}
+function createMockPool() {
+    const conn = createMockConnection();
+    return {
+        pool: { next: jest.fn().mockReturnValue(conn) },
+        conn,
+    };
+}
+function createMockConsumer() {
+    return {
+        processMessage: jest.fn().mockResolvedValue(undefined),
+        processing: new Map(),
+    };
+}
+describe('PendingRecovery', () => {
+    let recovery;
+    let logger;
+    let mockConn;
+    let mockPool;
+    let mockConsumer;
+    beforeEach(() => {
+        jest.clearAllMocks();
+        jest.useFakeTimers();
+        logger = createMockLogger();
+        const poolMock = createMockPool();
+        mockPool = poolMock.pool;
+        mockConn = poolMock.conn;
+        mockConsumer = createMockConsumer();
+        recovery = new pending_recovery_1.PendingRecovery({
+            pool: mockPool,
+            logger,
+            consumerId: 'test-consumer',
+            maxAttempts: 3,
+            claimTimeout: 30000,
+        });
+    });
+    afterEach(() => {
+        recovery.stop();
+        jest.useRealTimers();
+    });
+    describe('start/stop', () => {
+        it('powinien uruchomić periodyczny recovery', () => {
+            const handler = jest.fn();
+            recovery.start('cmd:Test', 'workers', handler, mockConsumer);
+            expect(recovery['recoveryIntervals'].length).toBe(1);
+        });
+        it('powinien zatrzymać recovery intervals', () => {
+            const handler = jest.fn();
+            recovery.start('cmd:Test', 'workers', handler, mockConsumer);
+            recovery.start('cmd:Other', 'workers', handler, mockConsumer);
+            expect(recovery['recoveryIntervals'].length).toBe(2);
+            recovery.stop();
+            expect(recovery['recoveryIntervals'].length).toBe(0);
+        });
+        it('powinien wywołać recoverPending co claimTimeout', () => {
+            const handler = jest.fn();
+            recovery.start('cmd:Test', 'workers', handler, mockConsumer);
+            // Advance timer o 3 interwały
+            jest.advanceTimersByTime(90000); // 3 * 30000
+            // XPENDING powinien być wywołany 3 razy
+            expect(mockConn.xpending).toHaveBeenCalledTimes(3);
+        });
+    });
+    describe('recoverPending()', () => {
+        /**
+         * Dostęp do prywatnej metody recoverPending przez casting
+         */
+        const callRecoverPending = () => __awaiter(void 0, void 0, void 0, function* () {
+            const any = recovery;
+            yield any['recoverPending']('cmd:Test', 'workers', jest.fn(), mockConsumer);
+        });
+        it('powinien nie robić nic gdy brak pending wiadomości', () => __awaiter(void 0, void 0, void 0, function* () {
+            mockConn.xpending.mockResolvedValue([]);
+            yield callRecoverPending();
+            expect(mockConn.xclaim).not.toHaveBeenCalled();
+            expect(mockConn.xack).not.toHaveBeenCalled();
+        }));
+        it('powinien przejąć stalled wiadomość przez XCLAIM', () => __awaiter(void 0, void 0, void 0, function* () {
+            const testPayload = Buffer.from('recovered-data').toString('base64');
+            mockConn.xpending.mockResolvedValue([
+                ['msg-1', 'consumer-old', 60000, 1], // idleTime > claimTimeout, deliveryCount < maxAttempts
+            ]);
+            mockConn.xclaim.mockResolvedValue([['msg-1', ['data', testPayload]]]);
+            yield callRecoverPending();
+            expect(mockConn.xclaim).toHaveBeenCalledWith('cmd:Test', 'workers', 'test-consumer', 30000, 'msg-1');
+            expect(mockConsumer.processMessage).toHaveBeenCalledWith('cmd:Test', 'workers', 'msg-1', ['data', testPayload], expect.any(Function));
+        }));
+        it('powinien przenieść do DLQ po maxAttempts (D3)', () => __awaiter(void 0, void 0, void 0, function* () {
+            const testPayload = Buffer.from('dead-data').toString('base64');
+            mockConn.xpending.mockResolvedValue([
+                ['msg-dead', 'consumer-old', 60000, 3], // deliveryCount >= maxAttempts
+            ]);
+            // XCLAIM zwraca dane wiadomości do przeniesienia do DLQ
+            mockConn.xclaim.mockResolvedValue([['msg-dead', ['data', testPayload]]]);
+            yield callRecoverPending();
+            // XCLAIM powinien być wywołany (żeby pobrać dane do DLQ)
+            expect(mockConn.xclaim).toHaveBeenCalled();
+            // XADD do dlq: strumienia
+            expect(mockConn.xadd).toHaveBeenCalledWith('dlq:cmd:Test', '*', 'data', testPayload, 'original_stream', 'cmd:Test', 'delivery_count', '3');
+            // XACK po przeniesieniu do DLQ
+            expect(mockConn.xack).toHaveBeenCalledWith('cmd:Test', 'workers', 'msg-dead');
+            expect(logger.error).toHaveBeenCalledWith('Wiadomość przeniesiona do Dead Letter Queue', expect.objectContaining({
+                messageId: 'msg-dead',
+                dlqStream: 'dlq:cmd:Test',
+                deliveryCount: 3,
+            }));
+        }));
+        it('nie powinien przejmować wiadomości z idleTime < claimTimeout', () => __awaiter(void 0, void 0, void 0, function* () {
+            mockConn.xpending.mockResolvedValue([
+                ['msg-young', 'consumer-other', 5000, 1], // idleTime (5s) < claimTimeout (30s)
+            ]);
+            yield callRecoverPending();
+            expect(mockConn.xclaim).not.toHaveBeenCalled();
+            expect(mockConn.xack).not.toHaveBeenCalled();
+        }));
+        it('powinien zalogować błąd przy wyjątku', () => __awaiter(void 0, void 0, void 0, function* () {
+            mockConn.xpending.mockRejectedValue(new Error('Redis connection error'));
+            yield callRecoverPending();
+            expect(logger.error).toHaveBeenCalledWith('Błąd recovery pending wiadomości', expect.objectContaining({ error: 'Redis connection error' }));
+        }));
+        it('powinien obsłużyć pusty wynik XCLAIM', () => __awaiter(void 0, void 0, void 0, function* () {
+            mockConn.xpending.mockResolvedValue([['msg-1', 'consumer-old', 60000, 1]]);
+            mockConn.xclaim.mockResolvedValue([]);
+            yield callRecoverPending();
+            // processMessage NIE powinien być wywołany (brak danych w XCLAIM)
+            expect(mockConsumer.processMessage).not.toHaveBeenCalled();
+        }));
+        it('powinien obsłużyć wiele pending wiadomości', () => __awaiter(void 0, void 0, void 0, function* () {
+            const testPayload = Buffer.from('data').toString('base64');
+            mockConn.xpending.mockResolvedValue([
+                ['msg-1', 'consumer-old', 60000, 1],
+                ['msg-2', 'consumer-old', 60000, 2],
+                ['msg-dead', 'consumer-old', 60000, 5], // Dead letter
+            ]);
+            mockConn.xclaim.mockResolvedValue([['msg-claimed', ['data', testPayload]]]);
+            yield callRecoverPending();
+            // XCLAIM: msg-1, msg-2 (recovery) + msg-dead (DLQ pobieranie danych) = 3
+            expect(mockConn.xclaim).toHaveBeenCalledTimes(3);
+            // XADD do DLQ
+            expect(mockConn.xadd).toHaveBeenCalledWith('dlq:cmd:Test', '*', expect.anything(), expect.anything(), 'original_stream', 'cmd:Test', 'delivery_count', '5');
+            // XACK dla dead letter
+            expect(mockConn.xack).toHaveBeenCalledWith('cmd:Test', 'workers', 'msg-dead');
+        }));
+    });
+});
+//# sourceMappingURL=pending-recovery.spec.js.map

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

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

package/dist/command-bus/transport/redis-codec.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Kodek Redis — enkapsulacja kodowania/dekodowania binarnych danych
+ *
+ * ioredis dekoduje string responses jako UTF-8, co korumpuje surowe bajty msgpack.
+ * Base64 zapewnia bezpieczne przechowywanie binarnych danych w Redis Streams.
+ *
+ * Warianty *Buffer() (np. xreadgroupBuffer) nie są praktyczne — zwracają Buffer
+ * dla WSZYSTKICH pól (nazwy strumieni, messageId, klucze), co komplikuje parsowanie
+ * zagnieżdżonej struktury XREADGROUP.
+ */
+export declare class RedisCodec {
+    /**
+     * Koduje dane binarne do bezpiecznego formatu dla Redis
+     * @param data - Surowe dane binarne
+     * @returns Zakodowany string (base64)
+     */
+    static encode(data: Buffer): string;
+    /**
+     * Dekoduje dane z Redis do formatu binarnego
+     * @param encoded - Zakodowany string (base64)
+     * @returns Surowe dane binarne
+     */
+    static decode(encoded: string): Buffer;
+}

package/dist/command-bus/transport/redis-codec.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisCodec = void 0;
+/**
+ * Kodek Redis — enkapsulacja kodowania/dekodowania binarnych danych
+ *
+ * ioredis dekoduje string responses jako UTF-8, co korumpuje surowe bajty msgpack.
+ * Base64 zapewnia bezpieczne przechowywanie binarnych danych w Redis Streams.
+ *
+ * Warianty *Buffer() (np. xreadgroupBuffer) nie są praktyczne — zwracają Buffer
+ * dla WSZYSTKICH pól (nazwy strumieni, messageId, klucze), co komplikuje parsowanie
+ * zagnieżdżonej struktury XREADGROUP.
+ */
+class RedisCodec {
+    /**
+     * Koduje dane binarne do bezpiecznego formatu dla Redis
+     * @param data - Surowe dane binarne
+     * @returns Zakodowany string (base64)
+     */
+    static encode(data) {
+        return data.toString('base64');
+    }
+    /**
+     * Dekoduje dane z Redis do formatu binarnego
+     * @param encoded - Zakodowany string (base64)
+     * @returns Surowe dane binarne
+     */
+    static decode(encoded) {
+        return Buffer.from(encoded, 'base64');
+    }
+}
+exports.RedisCodec = RedisCodec;
+//# sourceMappingURL=redis-codec.js.map

package/dist/command-bus/transport/redis-codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-codec.js","sourceRoot":"","sources":["../../../src/command-bus/transport/redis-codec.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;GASG;AACH,MAAa,UAAU;IACrB;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAAC,IAAY;QACxB,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACjC,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAAC,OAAe;QAC3B,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;CACF;AAlBD,gCAkBC"}

package/dist/command-bus/transport/redis-codec.spec.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const redis_codec_1 = require("./redis-codec");
+describe('RedisCodec', () => {
+    describe('encode/decode roundtrip', () => {
+        it('powinien zakodować i zdekodować dane binarne bez utraty', () => {
+            const original = Buffer.from('Jan Kowalski, ul. Długa 15, Warszawa');
+            const encoded = redis_codec_1.RedisCodec.encode(original);
+            const decoded = redis_codec_1.RedisCodec.decode(encoded);
+            expect(decoded).toEqual(original);
+        });
+        it('powinien obsłużyć pusty Buffer', () => {
+            const original = Buffer.alloc(0);
+            const encoded = redis_codec_1.RedisCodec.encode(original);
+            const decoded = redis_codec_1.RedisCodec.decode(encoded);
+            expect(decoded).toEqual(original);
+            expect(decoded.length).toBe(0);
+        });
+        it('powinien obsłużyć dane binarne z null bytes', () => {
+            const original = Buffer.from([0x00, 0x01, 0xff, 0x00, 0xab]);
+            const encoded = redis_codec_1.RedisCodec.encode(original);
+            const decoded = redis_codec_1.RedisCodec.decode(encoded);
+            expect(decoded).toEqual(original);
+        });
+        it('powinien obsłużyć duże dane (1MB)', () => {
+            const original = Buffer.alloc(1024 * 1024, 0xab);
+            const encoded = redis_codec_1.RedisCodec.encode(original);
+            const decoded = redis_codec_1.RedisCodec.decode(encoded);
+            expect(decoded).toEqual(original);
+        });
+    });
+    describe('encode()', () => {
+        it('powinien zwrócić string base64', () => {
+            const data = Buffer.from('test');
+            const encoded = redis_codec_1.RedisCodec.encode(data);
+            expect(typeof encoded).toBe('string');
+            // Walidacja formatu base64
+            expect(encoded).toMatch(/^[A-Za-z0-9+/]*={0,2}$/);
+        });
+    });
+    describe('decode()', () => {
+        it('powinien zdekodować prawidłowy base64 string', () => {
+            const base64 = Buffer.from('Anna Nowak').toString('base64');
+            const decoded = redis_codec_1.RedisCodec.decode(base64);
+            expect(decoded.toString()).toBe('Anna Nowak');
+        });
+        it('powinien zwrócić pusty Buffer dla pustego stringa', () => {
+            const decoded = redis_codec_1.RedisCodec.decode('');
+            expect(decoded.length).toBe(0);
+        });
+    });
+});
+//# sourceMappingURL=redis-codec.spec.js.map

package/dist/command-bus/transport/redis-codec.spec.js.map

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

package/dist/command-bus/transport/redis-streams-transport.d.ts

@@ -0,0 +1,91 @@
+import type { ILogger } from '../../shared/types';
+import type { ISerializer } from '../serialization/serializer.interface';
+import type { ITransport, ConsumerHandler } from './transport.interface';
+import type RedisConnectionPool from '../../shared/redis/connection-pool';
+import type RpcConnectionPool from '../../shared/redis/rpc-connection-pool';
+/**
+ * Opcje konfiguracji RedisStreamsTransport
+ */
+export interface RedisStreamsTransportOptions {
+    /** Pula połączeń Redis (round-robin, non-blocking ops) */
+    pool: RedisConnectionPool;
+    /** Pula połączeń RPC (bounded, lazy, blocking BRPOP) */
+    rpcPool: RpcConnectionPool;
+    /** Serializer do konwersji RPC metadata */
+    serializer: ISerializer;
+    /** Logger */
+    logger: ILogger;
+    /** Maksymalna liczba wiadomości w strumieniu (XTRIM ~) */
+    maxRetained: number;
+    /** Maksymalna liczba prób przetworzenia wiadomości */
+    maxAttempts: number;
+    /** Czas po którym stalled wiadomość jest przejmowana (ms) */
+    claimTimeout: number;
+    /** Liczba wiadomości pobieranych w jednym XREADGROUP */
+    batchSize: number;
+    /** Maksymalna liczba wiadomości przetwarzanych równolegle per konsument */
+    concurrency: number;
+}
+/**
+ * Fasada transportu Redis Streams dla CommandBus
+ *
+ * Kompozycja 4 komponentów z jasno rozdzielonymi odpowiedzialnościami:
+ * - StreamProducer: enqueue / enqueueBatch (XADD)
+ * - StreamConsumer: consume / consumerLoop / processMessage
+ * - RpcHandler: rpcCall / rpcRespond (LPUSH/BRPOP)
+ * - PendingRecovery: XPENDING / XCLAIM / dead letter
+ *
+ * Zachowuje publiczne API ITransport — zero zmian dla CommandBus
+ */
+export default class RedisStreamsTransport implements ITransport {
+    private readonly pool;
+    private readonly rpcPool;
+    private readonly logger;
+    /** Komponenty fasady */
+    private readonly producer;
+    private readonly consumer;
+    private readonly rpc;
+    private readonly recovery;
+    /** Identyfikator procesu (dla consumer name) */
+    private readonly consumerId;
+    constructor(options: RedisStreamsTransportOptions);
+    /**
+     * Dodaje komendę do strumienia (fire-and-forget)
+     * Deleguje do StreamProducer
+     */
+    enqueue(streamName: string, data: Buffer): Promise<string>;
+    /**
+     * Dodaje wiele komend w jednym pipeline
+     * Deleguje do StreamProducer
+     */
+    enqueueBatch(entries: Array<{
+        streamName: string;
+        data: Buffer;
+    }>): Promise<string[]>;
+    /**
+     * Rejestruje konsumenta dla strumienia z consumer group
+     * Deleguje do StreamConsumer + uruchamia PendingRecovery
+     */
+    consume(streamName: string, groupName: string, handler: ConsumerHandler): Promise<void>;
+    /**
+     * RPC: wysyła request do strumienia i czeka na odpowiedź via BRPOP
+     * Deleguje do RpcHandler
+     */
+    rpcCall(commandName: string, data: Buffer, timeout: number): Promise<Buffer>;
+    /**
+     * RPC: odpowiada na request przez LPUSH + EXPIRE
+     * Deleguje do RpcHandler
+     */
+    rpcRespond(responseKey: string, data: Buffer, ttl: number): Promise<void>;
+    /**
+     * Zamyka transport gracefully
+     *
+     * Kolejność:
+     * 1. Zatrzymaj consumer.running (przerywa consumer loops)
+     * 2. Zatrzymaj recovery intervals
+     * 3. Zamknij dedykowane połączenia konsumentów (przerywa XREADGROUP BLOCK)
+     * 4. Czekaj na zakończenie consumer loops (active tasks kończą processMessage)
+     * 5. Zamknij pule połączeń
+     */
+    close(): Promise<void>;
+}