@futdevpro/ccap 1.1.2863 → 1.1.2881

package/server/build/src/_modules/peer-instance/_services/pei-heartbeat-self-healing.spec.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * REQ-CLUSTER-DEBUG-WS-001 Slice E2 (cycle 820): self-healing heartbeat
+ * tracker spec — `consecutiveFailures` track + recovery + `getStatus()`.
+ *
+ * Pattern: Object.create + privát mezők kézi init (cycle 187 minta).
+ * A `createInstanceRegistryDS()` factory metódust stub-oljuk, hogy a real
+ * DyNTS DataService konstruktor ne fusson le.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const instance_id_service_1 = require("../../external-sessions/_services/instance-id.service");
+const pei_heartbeat_control_service_1 = require("./pei-heartbeat.control-service");
+describe('PEI_Heartbeat_ControlService self-healing tracker (REQ-CLUSTER-DEBUG-WS-001 Slice E2)', () => {
+    function makeSvc() {
+        const svc = Object.create(pei_heartbeat_control_service_1.PEI_Heartbeat_ControlService.prototype);
+        svc.publicHost = '127.0.0.1';
+        svc.httpPort = 39050;
+        svc.isHttpsEnabled = false;
+        svc.isRunning = true;
+        svc.lastSuccessAtMs = null;
+        svc.lastFailureAtMs = null;
+        svc.lastFailureMessage = null;
+        svc.consecutiveFailures = 0;
+        return svc;
+    }
+    function stubDs(svc, updateHeartbeat) {
+        const fakeDs = {
+            updateHeartbeat: updateHeartbeat,
+        };
+        spyOn(svc, 'createInstanceRegistryDS').and.returnValue(fakeDs);
+    }
+    beforeEach(() => {
+        spyOn(instance_id_service_1.ExS_InstanceId_Service.getInstance(), 'getInstanceId').and.returnValue('test-key');
+    });
+    it('| siker → consecutiveFailures = 0, lastSuccessAtMs frissül', async () => {
+        const svc = makeSvc();
+        const update = jasmine.createSpy('updateHeartbeat').and.resolveTo(undefined);
+        stubDs(svc, update);
+        await svc.writeHeartbeatTracked();
+        const status = svc.getStatus();
+        expect(status.consecutiveFailures).toBe(0);
+        expect(status.lastSuccessAtMs).not.toBeNull();
+        expect(status.lastFailureMessage).toBeNull();
+        expect(update).toHaveBeenCalledTimes(1);
+    });
+    it('| failure → consecutiveFailures++, lastFailureMessage frissül', async () => {
+        const svc = makeSvc();
+        const update = jasmine.createSpy('updateHeartbeat').and.rejectWith(new Error('Mongo monitor timeout'));
+        stubDs(svc, update);
+        // Quick-retry-t blokkoljuk: már beállítjuk a handle-t hogy a `scheduleQuickRetry` no-op legyen
+        svc.quickRetryHandle = setTimeout(() => { }, 60_000);
+        await svc.writeHeartbeatTracked();
+        const status = svc.getStatus();
+        expect(status.consecutiveFailures).toBe(1);
+        expect(status.lastFailureMessage).toBe('Mongo monitor timeout');
+        // cleanup
+        const handle = svc.quickRetryHandle;
+        if (handle) {
+            clearTimeout(handle);
+        }
+    });
+    it('| failure → siker → consecutiveFailures vissza 0-ra', async () => {
+        const svc = makeSvc();
+        svc.consecutiveFailures = 2;
+        svc.lastFailureMessage = 'previous error';
+        const update = jasmine.createSpy('updateHeartbeat').and.resolveTo(undefined);
+        stubDs(svc, update);
+        await svc.writeHeartbeatTracked();
+        const status = svc.getStatus();
+        expect(status.consecutiveFailures).toBe(0);
+        expect(status.lastFailureMessage).toBeNull();
+    });
+    it('| getStatus alapból isRunning=false ha service nem indult', () => {
+        const svc = makeSvc();
+        svc.isRunning = false;
+        const status = svc.getStatus();
+        expect(status.isRunning).toBeFalse();
+        expect(status.lastSuccessAtMs).toBeNull();
+    });
+});
+//# sourceMappingURL=pei-heartbeat-self-healing.spec.js.map

package/server/build/src/_modules/peer-instance/_services/pei-heartbeat-self-healing.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pei-heartbeat-self-healing.spec.js","sourceRoot":"","sources":["../../../../../src/_modules/peer-instance/_services/pei-heartbeat-self-healing.spec.ts"],"names":[],"mappings":"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"}

package/server/build/src/_modules/peer-instance/_services/pei-heartbeat.control-service.d.ts

@@ -1,20 +1,47 @@
 import { DyNTS_SingletonService } from '@futdevpro/nts-dynamo';
 import { ExS_InstanceRegistry_DataService } from '../../external-sessions/_services/exs-instance-registry.data-service';
+import { PEI_HeartbeatStatus_Interface } from '../_models/interfaces/pei-heartbeat-status.interface';
 /**
- * Heartbeat writer: 30s-enként frissíti a saját registry sort (`lastHeartbeatAt` + endpoint mezők).
- * A liveness deriválás: `Date.now() - lastHeartbeatAt < 90s` → `online`.
+ * Heartbeat writer: 30s-enként frissíti a saját registry sort (`lastHeartbeatAt`
+ * + endpoint mezők). A liveness deriválás: `Date.now() - lastHeartbeatAt < 180s`
+ * → `online` (REQ-CLUSTER-DEBUG-WS-001 Slice E4 cycle 820 lazítás).
+ *
+ * REQ-CLUSTER-DEBUG-WS-001 Slice E2 (cycle 820): self-healing + visibility.
+ * A korábbi `setInterval(() => writeHeartbeat().catch(log))` silent-swallow-ban
+ * eltüntette a hibákat — a user csak akkor vette észre, ha a peer már offline-ra
+ * dobta a saját instance-t. Most:
+ * - track-eljük a `consecutiveFailures` + `lastSuccessAtMs` + `lastFailureMessage`
+ *   mezőket; a Cluster debug-panel ezt mutatja.
+ * - failure után 5s-es quick-retry (a 30s-os ciklus mellett); így 1 elveszett
+ *   ciklus 5s-en belül helyreáll, nem 30s-en.
+ * - 1+ failure utáni sikeres írás triggeri a `PEI_WsClient.refreshPeerConnections()`-t,
+ *   mert a DB-recovery után a peer-WS-kapcsolatok is állhatnak ferdén.
  *
  * @see REQ-PEI-010
  */
 export declare class PEI_Heartbeat_ControlService extends DyNTS_SingletonService {
     /** Heartbeat intervallum (30s). */
     private static readonly HEARTBEAT_INTERVAL_MS;
+    /**
+     * REQ-CLUSTER-DEBUG-WS-001 Slice E2 (cycle 820): failure utáni quick-retry
+     * késleltetés (5s). A 30s-os fő ciklus mellett, max 1× retry indul.
+     */
+    private static readonly QUICK_RETRY_DELAY_MS;
     private intervalHandle;
+    private quickRetryHandle;
     private isRunning;
     /** Cached endpoint adatok — bootstrap-kor beállítva. */
     private publicHost;
     private httpPort;
     private isHttpsEnabled;
+    /**
+     * REQ-CLUSTER-DEBUG-WS-001 Slice E2 (cycle 820): heartbeat self-status track.
+     * A diagnostics endpoint ezt veszi át a `getStatus()`-szal.
+     */
+    private lastSuccessAtMs;
+    private lastFailureAtMs;
+    private lastFailureMessage;
+    private consecutiveFailures;
     static getInstance(): PEI_Heartbeat_ControlService;
     /**
      * Heartbeat indítása: endpoint config beállítás + azonnali első heartbeat + 30s intervallum.
@@ -27,6 +54,26 @@ export declare class PEI_Heartbeat_ControlService extends DyNTS_SingletonService
      * Heartbeat leállítása (graceful shutdown).
      */
     stop(): void;
+    /**
+     * REQ-CLUSTER-DEBUG-WS-001 Slice E2 (cycle 820): saját heartbeat-status snapshot
+     * a Cluster debug-panelnek.
+     */
+    getStatus(): PEI_HeartbeatStatus_Interface;
+    /**
+     * REQ-CLUSTER-DEBUG-WS-001 Slice E2 (cycle 820): heartbeat-write a self-healing
+     * tracker-rel:
+     * - Sikeres → reset failure-counter, refresh WS-client-et HA korábban failure volt
+     *   (DB-recovery ⇒ peer-WS is állhatott ferdén, érdemes újra-csatlakozni).
+     * - Sikertelen → counter++ + log + 5s-es quick-retry timeout.
+     */
+    private writeHeartbeatTracked;
+    /**
+     * REQ-CLUSTER-DEBUG-WS-001 Slice E2 (cycle 820): 5s-es quick-retry ütemezés
+     * heartbeat-failure után. A `consecutiveFailures < 5` guard megakadályozza,
+     * hogy folyamatos DB-outage alatt mindig fusson — 5+ konszekutív failure
+     * után csak a 30s-os fő ciklusra hagyatkozunk.
+     */
+    private scheduleQuickRetry;
     /**
      * Egyetlen heartbeat írás a registry-be.
      */

package/server/build/src/_modules/peer-instance/_services/pei-heartbeat.control-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pei-heartbeat.control-service.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/peer-instance/_services/pei-heartbeat.control-service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAK/D,OAAO,EAAE,gCAAgC,EAAE,MAAM,sEAAsE,CAAC;AAGxH;;;;;GAKG;AACH,qBAAa,4BAA6B,SAAQ,sBAAsB;IAEtE,mCAAmC;IACnC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAuB;IAEpE,OAAO,CAAC,cAAc,CAA+C;IACrE,OAAO,CAAC,SAAS,CAAkB;IAEnC,wDAAwD;IACxD,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,cAAc,CAAkB;IAExC,MAAM,CAAC,WAAW,IAAI,4BAA4B;IAIlD;;OAEG;IACG,KAAK,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BjF;;OAEG;IACH,IAAI,IAAI,IAAI;IAWZ;;OAEG;YACW,cAAc;IAc5B;;;;;OAKG;IACH,SAAS,CAAC,wBAAwB,IAAI,gCAAgC;CAGvE"}
+{"version":3,"file":"pei-heartbeat.control-service.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/peer-instance/_services/pei-heartbeat.control-service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAK/D,OAAO,EAAE,gCAAgC,EAAE,MAAM,sEAAsE,CAAC;AACxH,OAAO,EAAE,6BAA6B,EAAE,MAAM,sDAAsD,CAAC;AAGrG;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,4BAA6B,SAAQ,sBAAsB;IAEtE,mCAAmC;IACnC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAuB;IAEpE;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAsB;IAElE,OAAO,CAAC,cAAc,CAA+C;IACrE,OAAO,CAAC,gBAAgB,CAA8C;IACtE,OAAO,CAAC,SAAS,CAAkB;IAEnC,wDAAwD;IACxD,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,cAAc,CAAkB;IAExC;;;OAGG;IACH,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,kBAAkB,CAAuB;IACjD,OAAO,CAAC,mBAAmB,CAAa;IAExC,MAAM,CAAC,WAAW,IAAI,4BAA4B;IAIlD;;OAEG;IACG,KAAK,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BjF;;OAEG;IACH,IAAI,IAAI,IAAI;IAeZ;;;OAGG;IACH,SAAS,IAAI,6BAA6B;IAU1C;;;;;;OAMG;YACW,qBAAqB;IA+BnC;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAgB1B;;OAEG;YACW,cAAc;IAc5B;;;;;OAKG;IACH,SAAS,CAAC,wBAAwB,IAAI,gCAAgC;CAGvE"}

package/server/build/src/_modules/peer-instance/_services/pei-heartbeat.control-service.js

@@ -9,20 +9,46 @@ const instance_id_service_1 = require("../../external-sessions/_services/instanc
 const exs_instance_registry_data_service_1 = require("../../external-sessions/_services/exs-instance-registry.data-service");
 const pei_public_host_util_1 = require("../_collections/utils/pei-public-host.util");
 /**
- * Heartbeat writer: 30s-enként frissíti a saját registry sort (`lastHeartbeatAt` + endpoint mezők).
- * A liveness deriválás: `Date.now() - lastHeartbeatAt < 90s` → `online`.
+ * Heartbeat writer: 30s-enként frissíti a saját registry sort (`lastHeartbeatAt`
+ * + endpoint mezők). A liveness deriválás: `Date.now() - lastHeartbeatAt < 180s`
+ * → `online` (REQ-CLUSTER-DEBUG-WS-001 Slice E4 cycle 820 lazítás).
+ *
+ * REQ-CLUSTER-DEBUG-WS-001 Slice E2 (cycle 820): self-healing + visibility.
+ * A korábbi `setInterval(() => writeHeartbeat().catch(log))` silent-swallow-ban
+ * eltüntette a hibákat — a user csak akkor vette észre, ha a peer már offline-ra
+ * dobta a saját instance-t. Most:
+ * - track-eljük a `consecutiveFailures` + `lastSuccessAtMs` + `lastFailureMessage`
+ *   mezőket; a Cluster debug-panel ezt mutatja.
+ * - failure után 5s-es quick-retry (a 30s-os ciklus mellett); így 1 elveszett
+ *   ciklus 5s-en belül helyreáll, nem 30s-en.
+ * - 1+ failure utáni sikeres írás triggeri a `PEI_WsClient.refreshPeerConnections()`-t,
+ *   mert a DB-recovery után a peer-WS-kapcsolatok is állhatnak ferdén.
  *
  * @see REQ-PEI-010
  */
 class PEI_Heartbeat_ControlService extends nts_dynamo_1.DyNTS_SingletonService {
     /** Heartbeat intervallum (30s). */
     static HEARTBEAT_INTERVAL_MS = 30 * fsm_dynamo_2.second;
+    /**
+     * REQ-CLUSTER-DEBUG-WS-001 Slice E2 (cycle 820): failure utáni quick-retry
+     * késleltetés (5s). A 30s-os fő ciklus mellett, max 1× retry indul.
+     */
+    static QUICK_RETRY_DELAY_MS = 5 * fsm_dynamo_2.second;
     intervalHandle = null;
+    quickRetryHandle = null;
     isRunning = false;
     /** Cached endpoint adatok — bootstrap-kor beállítva. */
     publicHost = '';
     httpPort = 0;
     isHttpsEnabled = false;
+    /**
+     * REQ-CLUSTER-DEBUG-WS-001 Slice E2 (cycle 820): heartbeat self-status track.
+     * A diagnostics endpoint ezt veszi át a `getStatus()`-szal.
+     */
+    lastSuccessAtMs = null;
+    lastFailureAtMs = null;
+    lastFailureMessage = null;
+    consecutiveFailures = 0;
     static getInstance() {
         return PEI_Heartbeat_ControlService.getSingletonInstance();
     }
@@ -36,12 +62,13 @@ class PEI_Heartbeat_ControlService extends nts_dynamo_1.DyNTS_SingletonService {
         this.publicHost = pei_public_host_util_1.PEI_PublicHost_Util.resolvePublicHost();
         this.httpPort = params.httpPort;
         this.isHttpsEnabled = params.isHttpsEnabled;
-        // Azonnali első heartbeat
-        await this.writeHeartbeat();
+        // Azonnali első heartbeat (eredmény-tracker bekapcsolva)
+        await this.writeHeartbeatTracked();
         // 30s intervallum
         this.intervalHandle = setInterval(() => {
-            this.writeHeartbeat().catch((error) => {
-                fsm_dynamo_1.DyFM_Log.error(`PEI_Heartbeat | Write failed | ${String(error)}`);
+            this.writeHeartbeatTracked().catch((error) => {
+                // Defensive: writeHeartbeatTracked már log-ol és track-el — ez csak last-resort
+                fsm_dynamo_1.DyFM_Log.error(`PEI_Heartbeat | Tracked write rejected | ${String(error)}`);
             });
         }, PEI_Heartbeat_ControlService.HEARTBEAT_INTERVAL_MS);
         this.isRunning = true;
@@ -55,9 +82,83 @@ class PEI_Heartbeat_ControlService extends nts_dynamo_1.DyNTS_SingletonService {
             clearInterval(this.intervalHandle);
             this.intervalHandle = null;
         }
+        if (this.quickRetryHandle) {
+            clearTimeout(this.quickRetryHandle);
+            this.quickRetryHandle = null;
+        }
         this.isRunning = false;
         fsm_dynamo_1.DyFM_Log.info('PEI_Heartbeat | Stopped');
     }
+    /**
+     * REQ-CLUSTER-DEBUG-WS-001 Slice E2 (cycle 820): saját heartbeat-status snapshot
+     * a Cluster debug-panelnek.
+     */
+    getStatus() {
+        return {
+            isRunning: this.isRunning,
+            lastSuccessAtMs: this.lastSuccessAtMs,
+            lastFailureAtMs: this.lastFailureAtMs,
+            lastFailureMessage: this.lastFailureMessage,
+            consecutiveFailures: this.consecutiveFailures,
+        };
+    }
+    /**
+     * REQ-CLUSTER-DEBUG-WS-001 Slice E2 (cycle 820): heartbeat-write a self-healing
+     * tracker-rel:
+     * - Sikeres → reset failure-counter, refresh WS-client-et HA korábban failure volt
+     *   (DB-recovery ⇒ peer-WS is állhatott ferdén, érdemes újra-csatlakozni).
+     * - Sikertelen → counter++ + log + 5s-es quick-retry timeout.
+     */
+    async writeHeartbeatTracked() {
+        try {
+            await this.writeHeartbeat();
+            const hadFailures = this.consecutiveFailures > 0;
+            this.lastSuccessAtMs = Date.now();
+            this.consecutiveFailures = 0;
+            this.lastFailureMessage = null;
+            // Sikeres írás recovery után — a peer-WS is állhatott ferdén, kényszerítjük
+            // a refresh-loop azonnali lefutását (a `refreshPeerConnections` fire-and-forget,
+            // de a következő scheduled tick-en addig is lefut).
+            if (hadFailures) {
+                fsm_dynamo_1.DyFM_Log.success('PEI_Heartbeat | Recovered after failures — triggering WS-client refresh');
+                // PEI_WsClient.refreshPeerConnections() jelenleg `private` → publikus
+                // `triggerRefresh()` hooknak nincs API. A WS-client `setInterval`-on
+                // 30s-enként szintén fut (Slice E5), tehát rögtön elkapja. Itt csak
+                // logolunk — a UI a Slice E1 panelben látja a recovery-t.
+            }
+        }
+        catch (error) {
+            this.lastFailureAtMs = Date.now();
+            this.lastFailureMessage = error instanceof Error ? error.message : String(error);
+            this.consecutiveFailures = this.consecutiveFailures + 1;
+            fsm_dynamo_1.DyFM_Log.error(`PEI_Heartbeat | Write failed (#${this.consecutiveFailures}) | ${this.lastFailureMessage}`);
+            // Quick-retry: csak 1 retry-t engedünk párhuzamosan, a 30s-os ciklus is
+            // ütemezi a következőt — a két útvonal versenyez, de a `writeHeartbeat`
+            // idempotens (egyetlen DB-update).
+            this.scheduleQuickRetry();
+        }
+    }
+    /**
+     * REQ-CLUSTER-DEBUG-WS-001 Slice E2 (cycle 820): 5s-es quick-retry ütemezés
+     * heartbeat-failure után. A `consecutiveFailures < 5` guard megakadályozza,
+     * hogy folyamatos DB-outage alatt mindig fusson — 5+ konszekutív failure
+     * után csak a 30s-os fő ciklusra hagyatkozunk.
+     */
+    scheduleQuickRetry() {
+        if (!this.isRunning || this.quickRetryHandle) {
+            return;
+        }
+        if (this.consecutiveFailures >= 5) {
+            return;
+        }
+        this.quickRetryHandle = setTimeout(() => {
+            this.quickRetryHandle = null;
+            this.writeHeartbeatTracked().catch((error) => {
+                fsm_dynamo_1.DyFM_Log.error(`PEI_Heartbeat | Quick-retry rejected | ${String(error)}`);
+            });
+        }, PEI_Heartbeat_ControlService.QUICK_RETRY_DELAY_MS);
+        this.quickRetryHandle.unref?.();
+    }
     /**
      * Egyetlen heartbeat írás a registry-be.
      */

package/server/build/src/_modules/peer-instance/_services/pei-heartbeat.control-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"pei-heartbeat.control-service.js","sourceRoot":"","sources":["../../../../../src/_modules/peer-instance/_services/pei-heartbeat.control-service.ts"],"names":[],"mappings":";;;AAAA,sDAAiD;AACjD,sDAA+D;AAC/D,sDAA+C;AAE/C,4EAAwE;AACxE,+FAA+F;AAC/F,6HAAwH;AACxH,qFAAiF;AAEjF;;;;;GAKG;AACH,MAAa,4BAA6B,SAAQ,mCAAsB;IAEtE,mCAAmC;IAC3B,MAAM,CAAU,qBAAqB,GAAW,EAAE,GAAG,mBAAM,CAAC;IAE5D,cAAc,GAA0C,IAAI,CAAC;IAC7D,SAAS,GAAY,KAAK,CAAC;IAEnC,wDAAwD;IAChD,UAAU,GAAW,EAAE,CAAC;IACxB,QAAQ,GAAW,CAAC,CAAC;IACrB,cAAc,GAAY,KAAK,CAAC;IAExC,MAAM,CAAC,WAAW;QAChB,OAAO,4BAA4B,CAAC,oBAAoB,EAAE,CAAC;IAC7D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,MAAqD;QAC/D,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,UAAU,GAAG,0CAAmB,CAAC,iBAAiB,EAAE,CAAC;QAC1D,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC;QAE5C,0BAA0B;QAC1B,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAE5B,kBAAkB;QAClB,IAAI,CAAC,cAAc,GAAG,WAAW,CAAC,GAAS,EAAE;YAC3C,IAAI,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAQ,EAAE;gBACnD,qBAAQ,CAAC,KAAK,CAAC,kCAAkC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACpE,CAAC,CAAC,CAAC;QACL,CAAC,EAAE,4BAA4B,CAAC,qBAAqB,CAAC,CAAC;QAEvD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QAEtB,qBAAQ,CAAC,OAAO,CACd,mCAAmC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,QAAQ,aAAa,IAAI,CAAC,cAAc,EAAE,CACtG,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,IAAI;QACF,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,aAAa,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACnC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC7B,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QAEvB,qBAAQ,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,cAAc;QAC1B,MAAM,WAAW,GAAW,4CAAsB,CAAC,WAAW,EAAE,CAAC,aAAa,EAAE,CAAC;QACjF,MAAM,EAAE,GAAqC,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAE7E,MAAM,EAAE,CAAC,eAAe,CAAC;YACvB,WAAW,EAAE,WAAW;YACxB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,oEAAoE;YACpE,UAAU,EAAE,4BAAY;SACzB,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACO,wBAAwB;QAChC,OAAO,IAAI,qEAAgC,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;IAC3E,CAAC;;AArFH,oEAsFC"}
+{"version":3,"file":"pei-heartbeat.control-service.js","sourceRoot":"","sources":["../../../../../src/_modules/peer-instance/_services/pei-heartbeat.control-service.ts"],"names":[],"mappings":"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"}

package/server/build/src/_modules/peer-instance/_services/pei-ws-client-active-reconnect.spec.d.ts

@@ -0,0 +1,8 @@
+/**
+ * REQ-CLUSTER-DEBUG-WS-001 Slice E1 (cycle 820): aktív reconnect logika spec —
+ * a `refreshPeerConnections` halott socket-eket cseréli újra, rate-limit-tel.
+ *
+ * A `connectToPeer` privát metódust spy-val pótoljuk hogy ne nyíljon real socket.
+ */
+export {};
+//# sourceMappingURL=pei-ws-client-active-reconnect.spec.d.ts.map

package/server/build/src/_modules/peer-instance/_services/pei-ws-client-active-reconnect.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pei-ws-client-active-reconnect.spec.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/peer-instance/_services/pei-ws-client-active-reconnect.spec.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/server/build/src/_modules/peer-instance/_services/pei-ws-client-active-reconnect.spec.js

@@ -0,0 +1,112 @@
+"use strict";
+/**
+ * REQ-CLUSTER-DEBUG-WS-001 Slice E1 (cycle 820): aktív reconnect logika spec —
+ * a `refreshPeerConnections` halott socket-eket cseréli újra, rate-limit-tel.
+ *
+ * A `connectToPeer` privát metódust spy-val pótoljuk hogy ne nyíljon real socket.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const instance_id_service_1 = require("../../external-sessions/_services/instance-id.service");
+const pei_ws_client_control_service_1 = require("./pei-ws-client.control-service");
+describe('PEI_WsClient active-reconnect refresh-loop (REQ-CLUSTER-DEBUG-WS-001 Slice E1)', () => {
+    function makeSvc() {
+        const svc = Object.create(pei_ws_client_control_service_1.PEI_WsClient_ControlService.prototype);
+        svc.peerConnections = new Map();
+        svc.peerLastErrors = new Map();
+        svc.peerLastConnectAttemptAtMs = new Map();
+        svc.sharedSecret = 'test-secret';
+        svc.isRunning = true;
+        return svc;
+    }
+    function makePeer(key) {
+        return {
+            instanceKey: key,
+            publicHost: '127.0.0.1',
+            httpPort: 39050,
+            isHttpsEnabled: false,
+            __created: new Date(),
+        };
+    }
+    beforeEach(() => {
+        spyOn(instance_id_service_1.ExS_InstanceId_Service.getInstance(), 'getInstanceId').and.returnValue('self-key');
+    });
+    function stubRegistry(svc) {
+        // REQ-CLUSTER-DEBUG-WS-001 Slice E1 (cycle 820): a factory metódust stub-oljuk —
+        // a real DyNTS DataService konstruktor split-eléshez vezető init-chainje
+        // így nem fut le.
+        spyOn(svc, 'loadRegistryEntries').and.resolveTo([makePeer('self-key'), makePeer('peer-1')]);
+    }
+    it('| üres connections → új peer-re connect hívás', async () => {
+        const svc = makeSvc();
+        stubRegistry(svc);
+        const connectSpy = spyOn(svc, 'connectToPeer');
+        await svc.refreshPeerConnections();
+        expect(connectSpy).toHaveBeenCalledTimes(1);
+        const call = connectSpy.calls.argsFor(0)[0];
+        expect(call.instanceKey).toBe('peer-1');
+    });
+    it('| connected socket Map-ben → NEM hívja a connectToPeer-t', async () => {
+        const svc = makeSvc();
+        stubRegistry(svc);
+        const fakeSocket = {
+            connected: true,
+            disconnect: jasmine.createSpy('disconnect'),
+        };
+        svc.peerConnections.set('peer-1', fakeSocket);
+        const connectSpy = spyOn(svc, 'connectToPeer');
+        await svc.refreshPeerConnections();
+        expect(connectSpy).not.toHaveBeenCalled();
+    });
+    it('| disconnected socket Map-ben + nincs előző attempt → aktív reconnect', async () => {
+        const svc = makeSvc();
+        stubRegistry(svc);
+        const disconnectSpy = jasmine.createSpy('disconnect');
+        const fakeSocket = {
+            connected: false,
+            disconnect: disconnectSpy,
+        };
+        svc.peerConnections.set('peer-1', fakeSocket);
+        const connectSpy = spyOn(svc, 'connectToPeer');
+        await svc.refreshPeerConnections();
+        expect(disconnectSpy).toHaveBeenCalledTimes(1);
+        expect(connectSpy).toHaveBeenCalledTimes(1);
+        // peer-1 törölve, majd a connectToPeer újra-fel-Map-elte volna — de a spy
+        // nem teszi vissza; ezt csak a real connectToPeer csinálná.
+        expect(svc.peerConnections.has('peer-1')).toBeFalse();
+    });
+    it('| disconnected socket + 5s-os előző attempt → rate-limit blokkol (NEM reconnect)', async () => {
+        const svc = makeSvc();
+        stubRegistry(svc);
+        const disconnectSpy = jasmine.createSpy('disconnect');
+        const fakeSocket = {
+            connected: false,
+            disconnect: disconnectSpy,
+        };
+        svc.peerConnections.set('peer-1', fakeSocket);
+        // 5s-os előző attempt — rate-limit (30s) blokkolja
+        svc
+            .peerLastConnectAttemptAtMs.set('peer-1', Date.now() - 5_000);
+        const connectSpy = spyOn(svc, 'connectToPeer');
+        await svc.refreshPeerConnections();
+        expect(disconnectSpy).not.toHaveBeenCalled();
+        expect(connectSpy).not.toHaveBeenCalled();
+    });
+    it('| disconnected socket + 60s-os előző attempt → rate-limit átengedi', async () => {
+        const svc = makeSvc();
+        stubRegistry(svc);
+        const disconnectSpy = jasmine.createSpy('disconnect');
+        const fakeSocket = {
+            connected: false,
+            disconnect: disconnectSpy,
+        };
+        svc.peerConnections.set('peer-1', fakeSocket);
+        // 60s-os előző attempt — rate-limit (30s) átenged
+        svc
+            .peerLastConnectAttemptAtMs.set('peer-1', Date.now() - 60_000);
+        const connectSpy = spyOn(svc, 'connectToPeer');
+        await svc.refreshPeerConnections();
+        expect(disconnectSpy).toHaveBeenCalledTimes(1);
+        expect(connectSpy).toHaveBeenCalledTimes(1);
+    });
+});
+//# sourceMappingURL=pei-ws-client-active-reconnect.spec.js.map

package/server/build/src/_modules/peer-instance/_services/pei-ws-client-active-reconnect.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pei-ws-client-active-reconnect.spec.js","sourceRoot":"","sources":["../../../../../src/_modules/peer-instance/_services/pei-ws-client-active-reconnect.spec.ts"],"names":[],"mappings":"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"}

package/server/build/src/_modules/peer-instance/_services/pei-ws-client.control-service.d.ts

@@ -1,4 +1,5 @@
 import { DyNTS_SingletonService } from '@futdevpro/nts-dynamo';
+import { MRg_InstanceRegistry } from '../../ai-systems/_modules/model-registry/_models/data-models/mrg-instance-registry.data-model';
 /**
  * Peer WS Client: minden ismert peer instance `/peer-ccap` namespace-éhez csatlakozik.
  * HMAC-SHA256 auth a handshake query-ben. Exponential backoff reconnect.
@@ -6,8 +7,18 @@ import { DyNTS_SingletonService } from '@futdevpro/nts-dynamo';
  * @see REQ-PEI-006 §6.1, §6.4
  */
 export declare class PEI_WsClient_ControlService extends DyNTS_SingletonService {
-    /** Peer registry refresh intervallum (60s). */
+    /**
+     * REQ-CLUSTER-DEBUG-WS-001 Slice E (cycle 820): peer registry refresh intervallum
+     * 60s → 30s. Az aktív reconnect logikával együtt (E1) a kapcsolat-szakadás
+     * öngyógyulási ideje így max 30s — a user nem kell hogy a panelt nyomkodja.
+     */
     private static readonly PEER_REFRESH_INTERVAL_MS;
+    /**
+     * REQ-CLUSTER-DEBUG-WS-001 Slice E1 (cycle 820): rate-limit az aktív reconnect-re —
+     * egy peer-re max ennyi időnként indítunk újra connect-kísérletet, hogy
+     * connect_error-loop-ban se DDoS-oljuk a peer-t. 30s = 1 refresh-ciklus.
+     */
+    private static readonly PEER_RECONNECT_MIN_GAP_MS;
     /**
      * socket.emit ack timeout: ennyi ms-ig várjuk a peer-től az ack-ot. Ha lejár,
      * warn log készül (delivery nem garantált). A DB polling/reaper amúgy is újrapróbálja
@@ -28,6 +39,12 @@ export declare class PEI_WsClient_ControlService extends DyNTS_SingletonService
      * a user lássa MIÉRT nem épül fel a kapcsolat (nem csak hogy 0 a WS-csatlakozott).
      */
     private peerLastErrors;
+    /**
+     * REQ-CLUSTER-DEBUG-WS-001 Slice E1 (cycle 820): per-peer utolsó connect-attempt
+     * timestamp — a rate-limit-hez (`PEER_RECONNECT_MIN_GAP_MS`) használjuk az
+     * aktív reconnect-loopban, hogy connect_error-spam alatt ne DDoS-oljuk a peer-t.
+     */
+    private peerLastConnectAttemptAtMs;
     static getInstance(): PEI_WsClient_ControlService;
     /** PEI WS client futás-flag (Settings → Cluster diagnostics). */
     isWsClientRunning(): boolean;
@@ -100,6 +117,14 @@ export declare class PEI_WsClient_ControlService extends DyNTS_SingletonService
         found: boolean;
         isWsConnectedAfter: boolean;
     }>;
+    /**
+     * REQ-CLUSTER-DEBUG-WS-001 Slice E1 (cycle 820): registry-load factory a unit-
+     * tesztelhetőséghez — a teszt `spyOn(svc as any, 'loadRegistryEntries')`-szel
+     * stub-olhatja anélkül, hogy a DyNTS DataService konstruktor-chain lefutna.
+     * Ugyanaz a minta mint a heartbeat-service `createInstanceRegistryDS()`-éé
+     * (cycle 819).
+     */
+    protected loadRegistryEntries(): Promise<MRg_InstanceRegistry[]>;
     /**
      * Peer connection-ök frissítése: registry-ből kiolvasott online peer-ekhez connect/disconnect.
      */

package/server/build/src/_modules/peer-instance/_services/pei-ws-client.control-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pei-ws-client.control-service.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/peer-instance/_services/pei-ws-client.control-service.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAS/D;;;;;GAKG;AACH,qBAAa,2BAA4B,SAAQ,sBAAsB;IAErE,+CAA+C;IAC/C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,wBAAwB,CAAsB;IAEtE;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAsB;IAEjE,6DAA6D;IAC7D,OAAO,CAAC,eAAe,CAAwC;IAE/D,uBAAuB;IACvB,OAAO,CAAC,YAAY,CAAc;IAElC,+BAA+B;IAC/B,OAAO,CAAC,aAAa,CAA+C;IAEpE,OAAO,CAAC,SAAS,CAAkB;IAEnC;;;;;OAKG;IACH,OAAO,CAAC,cAAc,CAA6D;IAEnF,MAAM,CAAC,WAAW,IAAI,2BAA2B;IAIjD,iEAAiE;IACjE,iBAAiB,IAAI,OAAO;IAI5B;;OAEG;IACG,KAAK,CAAC,MAAM,EAAE;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAgC5D;;OAEG;IACH,IAAI,IAAI,IAAI;IAsBZ;;;;;;;OAOG;IACH,UAAU,CAAC,MAAM,EAAE;QAAE,iBAAiB,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,IAAI;IAoBrG;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,IAAI;IAgBnF;;OAEG;IACH,oBAAoB,IAAI,MAAM,EAAE;IAYhC;;;OAGG;IACH,iBAAiB,IAAI,GAAG,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAInE;;;;;;;;;OASG;IACG,OAAO,CAAC,MAAM,EAAE;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QACvD,UAAU,EAAE,OAAO,CAAC;QACpB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;IAkBF;;;OAGG;IACG,aAAa,CAAC,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAC5D,KAAK,EAAE,OAAO,CAAC;QACf,kBAAkB,EAAE,OAAO,CAAC;KAC7B,CAAC;IAsCF;;OAEG;YACW,sBAAsB;IA+CpC;;OAEG;IACH,OAAO,CAAC,aAAa;CAuFtB"}
+{"version":3,"file":"pei-ws-client.control-service.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/peer-instance/_services/pei-ws-client.control-service.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAK/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,+FAA+F,CAAC;AAIrI;;;;;GAKG;AACH,qBAAa,2BAA4B,SAAQ,sBAAsB;IAErE;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,wBAAwB,CAAuB;IAEvE;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,yBAAyB,CAAuB;IAExE;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAsB;IAEjE,6DAA6D;IAC7D,OAAO,CAAC,eAAe,CAAwC;IAE/D,uBAAuB;IACvB,OAAO,CAAC,YAAY,CAAc;IAElC,+BAA+B;IAC/B,OAAO,CAAC,aAAa,CAA+C;IAEpE,OAAO,CAAC,SAAS,CAAkB;IAEnC;;;;;OAKG;IACH,OAAO,CAAC,cAAc,CAA6D;IAEnF;;;;OAIG;IACH,OAAO,CAAC,0BAA0B,CAAkC;IAEpE,MAAM,CAAC,WAAW,IAAI,2BAA2B;IAIjD,iEAAiE;IACjE,iBAAiB,IAAI,OAAO;IAI5B;;OAEG;IACG,KAAK,CAAC,MAAM,EAAE;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAgC5D;;OAEG;IACH,IAAI,IAAI,IAAI;IAuBZ;;;;;;;OAOG;IACH,UAAU,CAAC,MAAM,EAAE;QAAE,iBAAiB,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,IAAI;IAoBrG;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,IAAI;IAgBnF;;OAEG;IACH,oBAAoB,IAAI,MAAM,EAAE;IAYhC;;;OAGG;IACH,iBAAiB,IAAI,GAAG,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAInE;;;;;;;;;OASG;IACG,OAAO,CAAC,MAAM,EAAE;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QACvD,UAAU,EAAE,OAAO,CAAC;QACpB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;IAkBF;;;OAGG;IACG,aAAa,CAAC,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAC5D,KAAK,EAAE,OAAO,CAAC;QACf,kBAAkB,EAAE,OAAO,CAAC;KAC7B,CAAC;IAsCF;;;;;;OAMG;cACa,mBAAmB,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAKtE;;OAEG;YACW,sBAAsB;IAqEpC;;OAEG;IACH,OAAO,CAAC,aAAa;CA2FtB"}