@futdevpro/nts-dynamo 1.15.154 → 1.15.156

package/build/_modules/server/server-status/server-status.control-service.js

@@ -1,303 +1,303 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyNTS_ServerStatus_ControlService = void 0;
-const tslib_1 = require("tslib");
-const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
-const rxjs_1 = require("rxjs");
-const mongoose = tslib_1.__importStar(require("mongoose"));
-const package_json_1 = require("../../../../package.json");
-const singleton_service_1 = require("../../../_services/base/singleton.service");
-const db_stats_service_1 = require("../../../_services/core/db-stats.service");
-const diagnostics_service_1 = require("../../../_services/core/diagnostics.service");
-const global_settings_const_1 = require("../../../_collections/global-settings.const");
-const global_service_1 = require("../../../_services/core/global.service");
-class DyNTS_ServerStatus_ControlService extends singleton_service_1.DyNTS_SingletonService {
-    up = new Date();
-    _serverVersionNumeric = this.getVersionNumeric(package_json_1.version);
-    /**
-     * A BEDROCK (nts-dynamo) verzioja — a package.json-bol importalva.
-     * FIGYELEM: ez NEM az app sajat verzioja! (Lasd `appVersion`.)
-     */
-    get serverVersion() { return package_json_1.version; }
-    get serverVersionNumeric() { return this._serverVersionNumeric; }
-    /**
-     * AZ APP sajat verzioja (2026-07-20) — a `DyNTS_App_Params.version`-bol, amit az
-     * app-params a `DyNTS_global_settings.systemVersion`-be tolt (app-params.control-model).
-     *
-     * MIERT KELLETT: a `serverVersion` az nts-dynamo package.json-jabol jon, ezert a TELJES
-     * flottan UGYANAZT az erteket adja (pl. 01.15.104), fuggetlenul attol, hogy az app melyik
-     * verzioja fut. Emiatt minden verzio-alapu deploy-ellenorzes vak volt:
-     *   - a CI/CD `deploy-verify` polling SOHA nem egyezne (app 01.15.142 vs serverVersion 01.15.104),
-     *   - az Overseer verzio-drift monitorozasa nem latja az ELAVULT app-deployt,
-     *   - a `fdp deploy-service --skip-if-version` gate mindig eltérést lát → sosem skippel.
-     *
-     * ADDITIV mezo: a `serverVersion` szemantikaja VALTOZATLAN marad (nulla regresszio a
-     * meglevo fogyasztoknal / e2e-knel); az uj fogyasztok az `appVersion`-t olvassak.
-     */
-    get appVersion() { return global_settings_const_1.DyNTS_global_settings.systemVersion; }
-    _latestClientVersion;
-    _latestClientVersionNumeric;
-    get latestClientVersion() { return this._latestClientVersion; }
-    get latestClientVersionNumeric() { return this._latestClientVersionNumeric; }
-    connectionMaxCheckFrequency = 15 * fsm_dynamo_1.minute;
-    defaultErrorUserMsg = 'Something went wrong';
-    overseerTickTime = 6 * fsm_dynamo_1.hour;
-    overseer;
-    constructor() {
-        super();
-        /* if (DyNTS_global_settings.log_settings.setup) {
-          DyFM_Log.log(
-            'Required server connections:', JSON.stringify(this.requiredServerConnections.map(
-              (connection: DyNTS_ServerConnection): { name: string, baseUrl: string, testEndpoint: string } => ({
-                name: connection.name,
-                baseUrl: connection.apiService.baseUrl,
-                testEndpoint: connection.apiService.testEndpoint ?? '',
-              })
-            ), null, 2)
-          );
-        } */
-        this.overseer = (0, rxjs_1.timer)(this.overseerTickTime, this.overseerTickTime).subscribe(async () => {
-            try {
-                await this.triggerCreateSnapshot('overseer-system-tick');
-            }
-            catch (error) {
-                fsm_dynamo_1.DyFM_Error.logSimple(' ! Error in overseer (server status):', error);
-                global_service_1.DyNTS_GlobalService.globalErrorHandler(new fsm_dynamo_1.DyFM_Error({
-                    ...this.getDefaultErrorSettings('overseer tick', error, 'overseer-system-tick'),
-                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSCS-OT0`,
-                })).catch();
-            }
-        });
-    }
-    async getServerStatus(issuer, clientVersion) {
-        try {
-            return {
-                status: 'ready',
-                systemName: global_settings_const_1.DyNTS_global_settings.systemName,
-                systemShortCode: global_settings_const_1.DyNTS_global_settings.systemShortCodeName,
-                clientVersionOk: clientVersion ? this.clientVersionIsLatest(clientVersion) : false,
-                latestClientVersion: this.latestClientVersion,
-                latestClientVersionNumeric: this.latestClientVersionNumeric,
-                serverVersion: this.serverVersion,
-                serverNumericVersion: this.serverVersionNumeric,
-                // Az APP sajat verzioja (a serverVersion a bedrock-e) — deploy-verifikaciohoz.
-                appVersion: this.appVersion,
-                uptime: +new Date() - +this.up,
-                memoryUsage: process.memoryUsage(),
-                cpuUsage: process.cpuUsage(),
-                serverConnections: await this.checkServerConnections(issuer),
-            };
-        }
-        catch (error) {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this.getDefaultErrorSettings('getServerStatus', error, issuer),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSCS-GSS0`,
-            });
-        }
-    }
-    async checkServerConnections(issuer) {
-        try {
-            const connections = {};
-            await fsm_dynamo_1.DyFM_Array.asyncForEachAllAtOnce(this.requiredServerConnections, async (connection) => {
-                if (!connection.accessible || Date.now() - connection.lastCheck.getTime() > this.connectionMaxCheckFrequency) {
-                    await connection.apiService.checkServerAvailability(issuer).catch((error) => {
-                        fsm_dynamo_1.DyFM_Error.logSimple(`(checkServerConnections) "${connection.name}" server is not available` +
-                            `\n    baseUrl: ${connection.apiService.baseUrl}` +
-                            `\n    testEndpoint: ${connection.apiService.testEndpoint ?? ''}`, error);
-                        connection.accessible = false;
-                    }).then(() => {
-                        connection.accessible = true;
-                    });
-                    connection.accessible = true;
-                    connection.lastCheck = new Date();
-                }
-                connections[connection.name] = connection.accessible ? fsm_dynamo_1.DyFM_ServerConnection_Status.accessible : fsm_dynamo_1.DyFM_ServerConnection_Status.unaccessible;
-            });
-            return connections;
-        }
-        catch (error) {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this.getDefaultErrorSettings('checkServerConnections', error, issuer),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSCS-CC0`,
-            });
-        }
-    }
-    /**
-     * A mongoose default-connection. Külön metódus = teszt-seam (spy-jal felülírható, hogy a
-     * {@link checkDbReadiness} DB nélkül is tesztelhető legyen).
-     */
-    /** BFR-OVERSEER-004 — stats-only DB-diagnosztika a `/server/db-stats` endpointnak (metaadat-only). */
-    async getDbStats() {
-        return db_stats_service_1.DyNTS_DbStats_Util.collect(this.getMongooseConnection());
-    }
-    /** BFR-AM-015 — aggregált doctor-riport a `/server/doctor` endpointnak (sosem dob). */
-    async runDoctor() {
-        return diagnostics_service_1.DyNTS_Diagnostics.runDoctor({ connection: this.getMongooseConnection() });
-    }
-    getMongooseConnection() {
-        // FIX (2026-07-22) — a `mongoose.connection` NEM feltetlenul az a handle, amit a data-layer hasznal.
-        //
-        // ELESBEN MERVE (adventor, a diagnosztikai mezokkel): `dbConnectionCount: 1`, `dbModelCount: 0`,
-        // `dbOtherReadyStates: [1]` — azaz letezik EGY KAPCSOLODOTT (readyState=1) connection, de a
-        // `mongoose.connection` **nem az**: az disconnected (0), NULLA modellel, `host`/`name` nelkul
-        // (sosem csatlakozott). Emiatt a readiness flotta-szinten **hamis 503**-at adott (adventor,
-        // token-service, master-prompter), mikozben a DB vegig egeszseges volt es az appok kiszolgaltak.
-        //
-        // Ezert a valos, KAPCSOLODOTT connectiont keressuk meg a `mongoose.connections`-bol, es csak
-        // fallbackkent hasznaljuk a `mongoose.connection`-t. Ez minden esetben helyes:
-        //  - ha van elo connection -> azt merjuk (readyState=1 + valos ping) -> a readiness igazat mond,
-        //  - ha a DB tenyleg halott -> egyik sem 1 -> fallback -> tovabbra is helyesen NEM-ready.
-        // Vagyis a valodi DB-kiesest NEM maszkolja el, csak a hamis-negativot szunteti meg.
-        const all = mongoose.connections ?? [];
-        const live = all.find((c) => c?.readyState === 1);
-        return live ?? mongoose.connection;
-    }
-    /**
-     * Readiness-probe: a `/health` (liveness — "a process fut + kiszolgál") MELLETT a DB-elérhetőséget
-     * ellenőrzi. A readyState (mongoose driver-állapot) + egy valós `ping` round-trip → így a "connected
-     * de a DB nem válaszol" eset is kibukik. **Sosem dob** (a probe-nak determinisztikusan kell válaszolnia);
-     * hiba esetén `ready=false`. Az endpoint 503-at adjon, ha nem ready → az orchestrátor (k8s/docker/LB)
-     * ne irányítson forgalmat a DB-vesztett instance-ra.
-     */
-    async checkDbReadiness() {
-        let dbReadyState = 0;
-        let dbPingOk = false;
-        try {
-            const connection = this.getMongooseConnection();
-            // readyState: 0=disconnected, 1=connected, 2=connecting, 3=disconnecting
-            dbReadyState = connection?.readyState ?? 0;
-            if (dbReadyState === 1) {
-                await connection.db?.admin().ping();
-                dbPingOk = true;
-            }
-        }
-        catch (error) {
-            fsm_dynamo_1.DyFM_Log.warn('(checkDbReadiness) DB readiness check failed', error);
-            dbPingOk = false;
-        }
-        // DIAGNOSZTIKA (2026-07-22): sosem dobhat — a probe-nak determinisztikusan kell válaszolnia,
-        // ezért a diag-gyűjtés SAJÁT try-ban van (ha bármelyik mező kiolvasása elszáll, a readiness
-        // válasz attól még ép marad).
-        let diagnostics = {};
-        try {
-            const conn = this.getMongooseConnection();
-            const all = mongoose.connections ?? [];
-            diagnostics = {
-                dbConnectionCount: all.length,
-                dbHost: conn?.host,
-                dbName: conn?.name,
-                dbModelCount: Object.keys(conn?.models ?? {}).length,
-                // a default connectiont kihagyjuk — csak a "van-e MÁSIK, élő handle" kérdés érdekes
-                dbOtherReadyStates: all.filter((c) => c !== conn)
-                    .map((c) => c?.readyState ?? -1),
-            };
-        }
-        catch (error) {
-            fsm_dynamo_1.DyFM_Log.warn('(checkDbReadiness) diagnostics collection failed (non-fatal)', error);
-        }
-        return {
-            ready: dbReadyState === 1 && dbPingOk,
-            dbReadyState: dbReadyState,
-            dbPingOk: dbPingOk,
-            uptime: +new Date() - +this.up,
-            serverVersion: this.serverVersion,
-            appVersion: this.appVersion,
-            ...diagnostics,
-        };
-    }
-    async getErrorStatistics(range, issuer) {
-        try {
-            const error_DS = this.getErrorControlService({ issuer: issuer });
-            /* new DyNTS_Error_DataService({ issuer: issuer }); */
-            const from = fsm_dynamo_1.DyFM_Time.getDateByRelativeDate(range);
-            const errorsPaged = await error_DS.getErrorsFromDate(from, issuer);
-            const errors = errorsPaged.items;
-            return {
-                range: range,
-                allErrors: errors.length,
-                allAllErrors: errors.reduce((sum, error) => sum + error.count, 0),
-                serverErrors: errors.filter((error) => error.source.includes('SERVER')).length,
-                clientErrors: errors.filter((error) => !error.source.includes('SERVER')).length,
-                allServerErrors: errors.filter((error) => error.source.includes('SERVER')).reduce((sum, error) => sum + error.count, 0),
-                allClientErrors: errors.filter((error) => !error.source.includes('SERVER')).reduce((sum, error) => sum + error.count, 0),
-                infoErrors: errors.filter((error) => error.level === fsm_dynamo_1.DyFM_ErrorLevel.info).length,
-                warningErrors: errors.filter((error) => error.level === fsm_dynamo_1.DyFM_ErrorLevel.warning).length,
-                errorErrors: errors.filter((error) => error.level === fsm_dynamo_1.DyFM_ErrorLevel.error).length,
-                criticalErrors: errors.filter((error) => error.level === fsm_dynamo_1.DyFM_ErrorLevel.critical).length,
-                allInfoErrors: errors.filter((error) => error.level === fsm_dynamo_1.DyFM_ErrorLevel.info).reduce((sum, error) => sum + error.count, 0),
-                allWarningErrors: errors.filter((error) => error.level === fsm_dynamo_1.DyFM_ErrorLevel.warning).reduce((sum, error) => sum + error.count, 0),
-                allErrorErrors: errors.filter((error) => error.level === fsm_dynamo_1.DyFM_ErrorLevel.error).reduce((sum, error) => sum + error.count, 0),
-                allCriticalErrors: errors.filter((error) => error.level === fsm_dynamo_1.DyFM_ErrorLevel.critical).reduce((sum, error) => sum + error.count, 0),
-            };
-        }
-        catch (error) {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this.getDefaultErrorSettings('getMatchStatistics', error?.response?.data ?? error, issuer),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-GES0`,
-            });
-        }
-    }
-    getVersionNumeric(version) {
-        return +version.replace('v', '')
-            .replace('.', '')
-            .replace('.', '')
-            .replace('-alpha', '')
-            .replace('-beta', '')
-            .replace('-test', '')
-            .replace('-dev', '');
-    }
-    clientVersionIsLatest(clientVersion) {
-        const thisClientVersionNumeric = this.getVersionNumeric(clientVersion);
-        if (!this._latestClientVersionNumeric) {
-            this.setLatestClientVersion(clientVersion, thisClientVersionNumeric);
-            return true;
-        }
-        else if (thisClientVersionNumeric === this._latestClientVersionNumeric) {
-            return true;
-        }
-        else if (thisClientVersionNumeric < this._latestClientVersionNumeric) {
-            return false;
-        }
-        else if (this._latestClientVersionNumeric < thisClientVersionNumeric) {
-            this.setLatestClientVersion(clientVersion, thisClientVersionNumeric);
-            return true;
-        }
-        fsm_dynamo_1.DyFM_Log.error('Something went wrong, invalid version:', clientVersion, thisClientVersionNumeric, package_json_1.version, this.serverVersionNumeric);
-        return false;
-    }
-    setLatestClientVersion(clientVersion, clientVersionNumeric) {
-        if (!clientVersion.includes('test') && !clientVersion.includes('dev')) {
-            this._latestClientVersion = clientVersion;
-            this._latestClientVersionNumeric = clientVersionNumeric;
-        }
-    }
-    async triggerCreateSnapshot(issuer) {
-        try {
-            const snapshot = await this.getServerStatusSnapshot(issuer);
-            const serverStatusSnapshot_CS = this.getServerStatusSnapshotControlService({ issuer: issuer });
-            await serverStatusSnapshot_CS.saveSnapshot(snapshot, issuer);
-            fsm_dynamo_1.DyFM_Log.info('ServerStatus snapshot created');
-        }
-        catch (error) {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this.getDefaultErrorSettings('triggerCreateSnapshot', error, 'system-tick'),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSCS-TCS0`,
-            });
-        }
-    }
-    async getServerStatusSnapshot(issuer) {
-        try {
-            return ({
-                ...(await this.getServerStatus(issuer)),
-            });
-        }
-        catch (error) {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this.getDefaultErrorSettings('getServerStatusSnapshot', error?.response?.data ?? error, issuer),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSCS-GSS0`,
-            });
-        }
-    }
-}
-exports.DyNTS_ServerStatus_ControlService = DyNTS_ServerStatus_ControlService;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_ServerStatus_ControlService = void 0;
+const tslib_1 = require("tslib");
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const rxjs_1 = require("rxjs");
+const mongoose = tslib_1.__importStar(require("mongoose"));
+const package_json_1 = require("../../../../package.json");
+const singleton_service_1 = require("../../../_services/base/singleton.service");
+const db_stats_service_1 = require("../../../_services/core/db-stats.service");
+const diagnostics_service_1 = require("../../../_services/core/diagnostics.service");
+const global_settings_const_1 = require("../../../_collections/global-settings.const");
+const global_service_1 = require("../../../_services/core/global.service");
+class DyNTS_ServerStatus_ControlService extends singleton_service_1.DyNTS_SingletonService {
+    up = new Date();
+    _serverVersionNumeric = this.getVersionNumeric(package_json_1.version);
+    /**
+     * A BEDROCK (nts-dynamo) verzioja — a package.json-bol importalva.
+     * FIGYELEM: ez NEM az app sajat verzioja! (Lasd `appVersion`.)
+     */
+    get serverVersion() { return package_json_1.version; }
+    get serverVersionNumeric() { return this._serverVersionNumeric; }
+    /**
+     * AZ APP sajat verzioja (2026-07-20) — a `DyNTS_App_Params.version`-bol, amit az
+     * app-params a `DyNTS_global_settings.systemVersion`-be tolt (app-params.control-model).
+     *
+     * MIERT KELLETT: a `serverVersion` az nts-dynamo package.json-jabol jon, ezert a TELJES
+     * flottan UGYANAZT az erteket adja (pl. 01.15.104), fuggetlenul attol, hogy az app melyik
+     * verzioja fut. Emiatt minden verzio-alapu deploy-ellenorzes vak volt:
+     *   - a CI/CD `deploy-verify` polling SOHA nem egyezne (app 01.15.142 vs serverVersion 01.15.104),
+     *   - az Overseer verzio-drift monitorozasa nem latja az ELAVULT app-deployt,
+     *   - a `fdp deploy-service --skip-if-version` gate mindig eltérést lát → sosem skippel.
+     *
+     * ADDITIV mezo: a `serverVersion` szemantikaja VALTOZATLAN marad (nulla regresszio a
+     * meglevo fogyasztoknal / e2e-knel); az uj fogyasztok az `appVersion`-t olvassak.
+     */
+    get appVersion() { return global_settings_const_1.DyNTS_global_settings.systemVersion; }
+    _latestClientVersion;
+    _latestClientVersionNumeric;
+    get latestClientVersion() { return this._latestClientVersion; }
+    get latestClientVersionNumeric() { return this._latestClientVersionNumeric; }
+    connectionMaxCheckFrequency = 15 * fsm_dynamo_1.minute;
+    defaultErrorUserMsg = 'Something went wrong';
+    overseerTickTime = 6 * fsm_dynamo_1.hour;
+    overseer;
+    constructor() {
+        super();
+        /* if (DyNTS_global_settings.log_settings.setup) {
+          DyFM_Log.log(
+            'Required server connections:', JSON.stringify(this.requiredServerConnections.map(
+              (connection: DyNTS_ServerConnection): { name: string, baseUrl: string, testEndpoint: string } => ({
+                name: connection.name,
+                baseUrl: connection.apiService.baseUrl,
+                testEndpoint: connection.apiService.testEndpoint ?? '',
+              })
+            ), null, 2)
+          );
+        } */
+        this.overseer = (0, rxjs_1.timer)(this.overseerTickTime, this.overseerTickTime).subscribe(async () => {
+            try {
+                await this.triggerCreateSnapshot('overseer-system-tick');
+            }
+            catch (error) {
+                fsm_dynamo_1.DyFM_Error.logSimple(' ! Error in overseer (server status):', error);
+                global_service_1.DyNTS_GlobalService.globalErrorHandler(new fsm_dynamo_1.DyFM_Error({
+                    ...this.getDefaultErrorSettings('overseer tick', error, 'overseer-system-tick'),
+                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSCS-OT0`,
+                })).catch();
+            }
+        });
+    }
+    async getServerStatus(issuer, clientVersion) {
+        try {
+            return {
+                status: 'ready',
+                systemName: global_settings_const_1.DyNTS_global_settings.systemName,
+                systemShortCode: global_settings_const_1.DyNTS_global_settings.systemShortCodeName,
+                clientVersionOk: clientVersion ? this.clientVersionIsLatest(clientVersion) : false,
+                latestClientVersion: this.latestClientVersion,
+                latestClientVersionNumeric: this.latestClientVersionNumeric,
+                serverVersion: this.serverVersion,
+                serverNumericVersion: this.serverVersionNumeric,
+                // Az APP sajat verzioja (a serverVersion a bedrock-e) — deploy-verifikaciohoz.
+                appVersion: this.appVersion,
+                uptime: +new Date() - +this.up,
+                memoryUsage: process.memoryUsage(),
+                cpuUsage: process.cpuUsage(),
+                serverConnections: await this.checkServerConnections(issuer),
+            };
+        }
+        catch (error) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this.getDefaultErrorSettings('getServerStatus', error, issuer),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSCS-GSS0`,
+            });
+        }
+    }
+    async checkServerConnections(issuer) {
+        try {
+            const connections = {};
+            await fsm_dynamo_1.DyFM_Array.asyncForEachAllAtOnce(this.requiredServerConnections, async (connection) => {
+                if (!connection.accessible || Date.now() - connection.lastCheck.getTime() > this.connectionMaxCheckFrequency) {
+                    await connection.apiService.checkServerAvailability(issuer).catch((error) => {
+                        fsm_dynamo_1.DyFM_Error.logSimple(`(checkServerConnections) "${connection.name}" server is not available` +
+                            `\n    baseUrl: ${connection.apiService.baseUrl}` +
+                            `\n    testEndpoint: ${connection.apiService.testEndpoint ?? ''}`, error);
+                        connection.accessible = false;
+                    }).then(() => {
+                        connection.accessible = true;
+                    });
+                    connection.accessible = true;
+                    connection.lastCheck = new Date();
+                }
+                connections[connection.name] = connection.accessible ? fsm_dynamo_1.DyFM_ServerConnection_Status.accessible : fsm_dynamo_1.DyFM_ServerConnection_Status.unaccessible;
+            });
+            return connections;
+        }
+        catch (error) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this.getDefaultErrorSettings('checkServerConnections', error, issuer),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSCS-CC0`,
+            });
+        }
+    }
+    /**
+     * A mongoose default-connection. Külön metódus = teszt-seam (spy-jal felülírható, hogy a
+     * {@link checkDbReadiness} DB nélkül is tesztelhető legyen).
+     */
+    /** BFR-OVERSEER-004 — stats-only DB-diagnosztika a `/server/db-stats` endpointnak (metaadat-only). */
+    async getDbStats() {
+        return db_stats_service_1.DyNTS_DbStats_Util.collect(this.getMongooseConnection());
+    }
+    /** BFR-AM-015 — aggregált doctor-riport a `/server/doctor` endpointnak (sosem dob). */
+    async runDoctor() {
+        return diagnostics_service_1.DyNTS_Diagnostics.runDoctor({ connection: this.getMongooseConnection() });
+    }
+    getMongooseConnection() {
+        // FIX (2026-07-22) — a `mongoose.connection` NEM feltetlenul az a handle, amit a data-layer hasznal.
+        //
+        // ELESBEN MERVE (adventor, a diagnosztikai mezokkel): `dbConnectionCount: 1`, `dbModelCount: 0`,
+        // `dbOtherReadyStates: [1]` — azaz letezik EGY KAPCSOLODOTT (readyState=1) connection, de a
+        // `mongoose.connection` **nem az**: az disconnected (0), NULLA modellel, `host`/`name` nelkul
+        // (sosem csatlakozott). Emiatt a readiness flotta-szinten **hamis 503**-at adott (adventor,
+        // token-service, master-prompter), mikozben a DB vegig egeszseges volt es az appok kiszolgaltak.
+        //
+        // Ezert a valos, KAPCSOLODOTT connectiont keressuk meg a `mongoose.connections`-bol, es csak
+        // fallbackkent hasznaljuk a `mongoose.connection`-t. Ez minden esetben helyes:
+        //  - ha van elo connection -> azt merjuk (readyState=1 + valos ping) -> a readiness igazat mond,
+        //  - ha a DB tenyleg halott -> egyik sem 1 -> fallback -> tovabbra is helyesen NEM-ready.
+        // Vagyis a valodi DB-kiesest NEM maszkolja el, csak a hamis-negativot szunteti meg.
+        const all = mongoose.connections ?? [];
+        const live = all.find((c) => c?.readyState === 1);
+        return live ?? mongoose.connection;
+    }
+    /**
+     * Readiness-probe: a `/health` (liveness — "a process fut + kiszolgál") MELLETT a DB-elérhetőséget
+     * ellenőrzi. A readyState (mongoose driver-állapot) + egy valós `ping` round-trip → így a "connected
+     * de a DB nem válaszol" eset is kibukik. **Sosem dob** (a probe-nak determinisztikusan kell válaszolnia);
+     * hiba esetén `ready=false`. Az endpoint 503-at adjon, ha nem ready → az orchestrátor (k8s/docker/LB)
+     * ne irányítson forgalmat a DB-vesztett instance-ra.
+     */
+    async checkDbReadiness() {
+        let dbReadyState = 0;
+        let dbPingOk = false;
+        try {
+            const connection = this.getMongooseConnection();
+            // readyState: 0=disconnected, 1=connected, 2=connecting, 3=disconnecting
+            dbReadyState = connection?.readyState ?? 0;
+            if (dbReadyState === 1) {
+                await connection.db?.admin().ping();
+                dbPingOk = true;
+            }
+        }
+        catch (error) {
+            fsm_dynamo_1.DyFM_Log.warn('(checkDbReadiness) DB readiness check failed', error);
+            dbPingOk = false;
+        }
+        // DIAGNOSZTIKA (2026-07-22): sosem dobhat — a probe-nak determinisztikusan kell válaszolnia,
+        // ezért a diag-gyűjtés SAJÁT try-ban van (ha bármelyik mező kiolvasása elszáll, a readiness
+        // válasz attól még ép marad).
+        let diagnostics = {};
+        try {
+            const conn = this.getMongooseConnection();
+            const all = mongoose.connections ?? [];
+            diagnostics = {
+                dbConnectionCount: all.length,
+                dbHost: conn?.host,
+                dbName: conn?.name,
+                dbModelCount: Object.keys(conn?.models ?? {}).length,
+                // a default connectiont kihagyjuk — csak a "van-e MÁSIK, élő handle" kérdés érdekes
+                dbOtherReadyStates: all.filter((c) => c !== conn)
+                    .map((c) => c?.readyState ?? -1),
+            };
+        }
+        catch (error) {
+            fsm_dynamo_1.DyFM_Log.warn('(checkDbReadiness) diagnostics collection failed (non-fatal)', error);
+        }
+        return {
+            ready: dbReadyState === 1 && dbPingOk,
+            dbReadyState: dbReadyState,
+            dbPingOk: dbPingOk,
+            uptime: +new Date() - +this.up,
+            serverVersion: this.serverVersion,
+            appVersion: this.appVersion,
+            ...diagnostics,
+        };
+    }
+    async getErrorStatistics(range, issuer) {
+        try {
+            const error_DS = this.getErrorControlService({ issuer: issuer });
+            /* new DyNTS_Error_DataService({ issuer: issuer }); */
+            const from = fsm_dynamo_1.DyFM_Time.getDateByRelativeDate(range);
+            const errorsPaged = await error_DS.getErrorsFromDate(from, issuer);
+            const errors = errorsPaged.items;
+            return {
+                range: range,
+                allErrors: errors.length,
+                allAllErrors: errors.reduce((sum, error) => sum + error.count, 0),
+                serverErrors: errors.filter((error) => error.source.includes('SERVER')).length,
+                clientErrors: errors.filter((error) => !error.source.includes('SERVER')).length,
+                allServerErrors: errors.filter((error) => error.source.includes('SERVER')).reduce((sum, error) => sum + error.count, 0),
+                allClientErrors: errors.filter((error) => !error.source.includes('SERVER')).reduce((sum, error) => sum + error.count, 0),
+                infoErrors: errors.filter((error) => error.level === fsm_dynamo_1.DyFM_ErrorLevel.info).length,
+                warningErrors: errors.filter((error) => error.level === fsm_dynamo_1.DyFM_ErrorLevel.warning).length,
+                errorErrors: errors.filter((error) => error.level === fsm_dynamo_1.DyFM_ErrorLevel.error).length,
+                criticalErrors: errors.filter((error) => error.level === fsm_dynamo_1.DyFM_ErrorLevel.critical).length,
+                allInfoErrors: errors.filter((error) => error.level === fsm_dynamo_1.DyFM_ErrorLevel.info).reduce((sum, error) => sum + error.count, 0),
+                allWarningErrors: errors.filter((error) => error.level === fsm_dynamo_1.DyFM_ErrorLevel.warning).reduce((sum, error) => sum + error.count, 0),
+                allErrorErrors: errors.filter((error) => error.level === fsm_dynamo_1.DyFM_ErrorLevel.error).reduce((sum, error) => sum + error.count, 0),
+                allCriticalErrors: errors.filter((error) => error.level === fsm_dynamo_1.DyFM_ErrorLevel.critical).reduce((sum, error) => sum + error.count, 0),
+            };
+        }
+        catch (error) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this.getDefaultErrorSettings('getMatchStatistics', error?.response?.data ?? error, issuer),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-GES0`,
+            });
+        }
+    }
+    getVersionNumeric(version) {
+        return +version.replace('v', '')
+            .replace('.', '')
+            .replace('.', '')
+            .replace('-alpha', '')
+            .replace('-beta', '')
+            .replace('-test', '')
+            .replace('-dev', '');
+    }
+    clientVersionIsLatest(clientVersion) {
+        const thisClientVersionNumeric = this.getVersionNumeric(clientVersion);
+        if (!this._latestClientVersionNumeric) {
+            this.setLatestClientVersion(clientVersion, thisClientVersionNumeric);
+            return true;
+        }
+        else if (thisClientVersionNumeric === this._latestClientVersionNumeric) {
+            return true;
+        }
+        else if (thisClientVersionNumeric < this._latestClientVersionNumeric) {
+            return false;
+        }
+        else if (this._latestClientVersionNumeric < thisClientVersionNumeric) {
+            this.setLatestClientVersion(clientVersion, thisClientVersionNumeric);
+            return true;
+        }
+        fsm_dynamo_1.DyFM_Log.error('Something went wrong, invalid version:', clientVersion, thisClientVersionNumeric, package_json_1.version, this.serverVersionNumeric);
+        return false;
+    }
+    setLatestClientVersion(clientVersion, clientVersionNumeric) {
+        if (!clientVersion.includes('test') && !clientVersion.includes('dev')) {
+            this._latestClientVersion = clientVersion;
+            this._latestClientVersionNumeric = clientVersionNumeric;
+        }
+    }
+    async triggerCreateSnapshot(issuer) {
+        try {
+            const snapshot = await this.getServerStatusSnapshot(issuer);
+            const serverStatusSnapshot_CS = this.getServerStatusSnapshotControlService({ issuer: issuer });
+            await serverStatusSnapshot_CS.saveSnapshot(snapshot, issuer);
+            fsm_dynamo_1.DyFM_Log.info('ServerStatus snapshot created');
+        }
+        catch (error) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this.getDefaultErrorSettings('triggerCreateSnapshot', error, 'system-tick'),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSCS-TCS0`,
+            });
+        }
+    }
+    async getServerStatusSnapshot(issuer) {
+        try {
+            return ({
+                ...(await this.getServerStatus(issuer)),
+            });
+        }
+        catch (error) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this.getDefaultErrorSettings('getServerStatusSnapshot', error?.response?.data ?? error, issuer),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSCS-GSS0`,
+            });
+        }
+    }
+}
+exports.DyNTS_ServerStatus_ControlService = DyNTS_ServerStatus_ControlService;
 //# sourceMappingURL=server-status.control-service.js.map