@futdevpro/nts-dynamo 1.15.154 → 1.15.156

package/build/_services/core/memory-guard.service.js

@@ -1,370 +1,370 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyNTS_MemoryGuard = void 0;
-const tslib_1 = require("tslib");
-const v8 = tslib_1.__importStar(require("v8"));
-const perf_hooks_1 = require("perf_hooks");
-const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
-const global_settings_const_1 = require("../../_collections/global-settings.const");
-const singleton_service_base_1 = require("../base/singleton.service-base");
-const global_service_1 = require("./global.service");
-const BYTES_PER_MB = 1024 * 1024;
-class DyNTS_MemoryGuard extends singleton_service_base_1.DyNTS_SingletonServiceBase {
-    static getInstance() {
-        return DyNTS_MemoryGuard.getSingletonInstance();
-    }
-    timer = null;
-    installed = false;
-    state = 'normal';
-    // Feloldott (effektív) konfiguráció — install()-kor töltjük.
-    pollIntervalMs = 10000;
-    warnPct = 85;
-    critPct = 95;
-    recoveryMargin = 10;
-    maxHistoryCount = 100;
-    gcWarnFraction = 0.40;
-    gcCritFraction = 0.60;
-    exitOnSustainedCritical = false;
-    sustainedCriticalPolls = 3;
-    exitCode = 137;
-    bootGraceMs = 60000;
-    /** A guard-install időbélyege (a boot-grace számításához; 0 = még nem telepített). */
-    installedAt = 0;
-    onCritical;
-    history = [];
-    peakHeapPct = 0;
-    peakRssMb = 0;
-    // GC-thrash követés (perf_hooks 'gc') — a GC-ben töltött ms gördülő ablaka + a critical-streak számláló.
-    gcObserver = null;
-    gcEvents = [];
-    criticalStreak = 0;
-    // A telepített crash-handler ref-ek (a teardown eltávolításához).
-    crashHandler = null;
-    constructor() {
-        super();
-    }
-    /**
-     * Elindítja a heap-watchdogot. Idempotens (többszöri hívás no-op). A `config`
-     * felülírja a `DyNTS_global_settings.memoryGuard` értékeit, ami a beépített
-     * defaultokat írja felül. SOHA nem dob — egy figyelő-réteg nem dönthet be egy
-     * szervert (minden hiba try/catch-elt + descriptive-en logolt).
-     */
-    install(config) {
-        if (this.installed) {
-            return;
-        }
-        try {
-            const g = global_settings_const_1.DyNTS_global_settings.memoryGuard ?? { enabled: true };
-            this.pollIntervalMs = config?.pollIntervalMs ?? g.pollIntervalMs ?? 10000;
-            this.warnPct = config?.heapWarningThreshold ?? g.heapWarningThreshold ?? 85;
-            this.critPct = config?.heapCriticalThreshold ?? g.heapCriticalThreshold ?? 95;
-            this.recoveryMargin = config?.recoveryMargin ?? g.recoveryMargin ?? 10;
-            this.maxHistoryCount = config?.maxHistoryCount ?? g.maxHistoryCount ?? 100;
-            this.gcWarnFraction = config?.gcWarningFraction ?? g.gcWarningFraction ?? 0.40;
-            this.gcCritFraction = config?.gcCriticalFraction ?? g.gcCriticalFraction ?? 0.60;
-            this.exitOnSustainedCritical = config?.exitOnSustainedCritical ?? g.exitOnSustainedCritical ?? false;
-            this.sustainedCriticalPolls = config?.sustainedCriticalPolls ?? g.sustainedCriticalPolls ?? 3;
-            this.exitCode = config?.exitCode ?? g.exitCode ?? 137;
-            this.bootGraceMs = config?.bootGraceMs ?? g.bootGraceMs ?? 60000;
-            this.installedAt = Date.now();
-            this.onCritical = config?.onCritical;
-            this.installed = true;
-            this.installGcObserver();
-            // Crash-handler (uncaughtException) — teljes-részletű error-entry a crash ELŐTT, majd tiszta exit.
-            if (config?.installCrashHandlers ?? g.installCrashHandlers ?? true) {
-                this.installCrashHandlers();
-            }
-            this.timer = setInterval(() => { this.poll(); }, this.pollIntervalMs);
-            // unref(): a watchdog-timer NE tartsa életben a process-t önmagában (graceful
-            // exit-kor a Node ki tud lépni a függő interval ellenére is).
-            if (typeof this.timer.unref === 'function') {
-                this.timer.unref();
-            }
-            fsm_dynamo_1.DyFM_Log.info(`[DyNTS_MemoryGuard] installed — poll ${this.pollIntervalMs}ms, ` +
-                `warn ${this.warnPct}%/${Math.round(this.gcWarnFraction * 100)}%GC, ` +
-                `crit ${this.critPct}%/${Math.round(this.gcCritFraction * 100)}%GC (heap limit ` +
-                `${Math.round(this.getHeapLimitBytes() / BYTES_PER_MB)}MB)` +
-                (this.exitOnSustainedCritical ? `, graceful-exit@${this.sustainedCriticalPolls} critical polls (boot-grace ${this.bootGraceMs}ms)` : ''));
-        }
-        catch (err) {
-            // Telepítési hiba SEM lehet fatal — a guard hiánya nem ér annyit, hogy a
-            // szerver-indulást megakassza.
-            fsm_dynamo_1.DyFM_Log.warn('[DyNTS_MemoryGuard] install failed (non-fatal):', err);
-        }
-    }
-    /** A heap-plafon byte-ban (`--max-old-space-size`). Külön metódus a spec-mockoláshoz. */
-    getHeapLimitBytes() {
-        return v8.getHeapStatistics().heap_size_limit;
-    }
-    /**
-     * Egy poll-ciklus: kiolvassa a heap-kihasználtságot, frissíti a csúcsokat, és a
-     * hiszterézis-állapotgép szerint esemény-átlépéskor rögzít + logol. SOHA nem dob.
-     */
-    poll() {
-        try {
-            const limitBytes = this.getHeapLimitBytes();
-            if (!limitBytes || limitBytes <= 0) {
-                return;
-            }
-            const mu = process.memoryUsage();
-            const pct = (mu.heapUsed / limitBytes) * 100;
-            const gcFraction = this.recentGcFraction();
-            const rssMb = mu.rss / BYTES_PER_MB;
-            if (pct > this.peakHeapPct) {
-                this.peakHeapPct = pct;
-            }
-            if (rssMb > this.peakRssMb) {
-                this.peakRssMb = rssMb;
-            }
-            // A szintet a heap-% ÉS a GC-hányad közül a ROSSZABB dönti el (a GC-thrash a %-küszöb ALATT is OOM-ot jelez).
-            const heapCrit = pct >= this.critPct;
-            const gcCrit = gcFraction >= this.gcCritFraction;
-            const heapWarn = pct >= this.warnPct;
-            const gcWarn = gcFraction >= this.gcWarnFraction;
-            // Hiszterézis-állapotgép — esemény CSAK állapot-váltáskor.
-            const prev = this.state;
-            let next = prev;
-            if (heapCrit || gcCrit) {
-                next = 'critical';
-            }
-            else if ((heapWarn || gcWarn) && prev === 'normal') {
-                next = 'warning';
-            }
-            else if (pct <= this.warnPct - this.recoveryMargin && gcFraction < this.gcWarnFraction) {
-                next = 'normal';
-            }
-            // Egyébként marad a jelenlegi állapot (hiszterézis-sáv) — nincs re-emit.
-            // Sustained-critical streak + opcionális graceful-exit (állapot-váltástól FÜGGETLENÜL számolva). A boot-grace
-            // alatt (install + bootGraceMs) NEM lép ki — a nehéz-boot (pool-hidratáló) appok eleve GC-thrash-elnek a boot
-            // alatt, így a sustained-exit boot-loop-ot okozna; a grace UTÁN a tartós critical a VALÓDI runtime-OOM-ot kezeli.
-            if (next === 'critical') {
-                this.criticalStreak += 1;
-                const pastBootGrace = (Date.now() - this.installedAt) >= this.bootGraceMs;
-                if (this.exitOnSustainedCritical && pastBootGrace && this.criticalStreak >= this.sustainedCriticalPolls) {
-                    this.gracefulExit({ pct: pct, gcFraction: gcFraction, limitBytes: limitBytes, mu: mu });
-                    return;
-                }
-            }
-            else {
-                this.criticalStreak = 0;
-            }
-            if (next === prev) {
-                return;
-            }
-            this.state = next;
-            const trigger = next === 'normal' ? 'recovery'
-                : (heapCrit || heapWarn) && (gcCrit || gcWarn) ? 'heap+gc'
-                    : (gcCrit || gcWarn) ? 'gc' : 'heap';
-            const event = {
-                level: next === 'normal' ? 'recovered' : next,
-                heapUsedMb: Math.round(mu.heapUsed / BYTES_PER_MB),
-                heapLimitMb: Math.round(limitBytes / BYTES_PER_MB),
-                heapPct: Math.round(pct),
-                rssMb: Math.round(rssMb),
-                externalMb: Math.round((mu.external ?? 0) / BYTES_PER_MB),
-                gcFraction: Math.round(gcFraction * 100) / 100,
-                trigger: trigger,
-                at: new Date().toISOString(),
-            };
-            this.recordEvent(event);
-        }
-        catch (err) {
-            // Poll-hiba sosem fatal — a következő tick újrapróbálja.
-            fsm_dynamo_1.DyFM_Log.warn('[DyNTS_MemoryGuard] poll error (non-fatal):', err);
-        }
-    }
-    /** Esemény ring-bufferbe + log + (warning/critical esetén) tartós error-sink. */
-    recordEvent(event) {
-        this.history.push(event);
-        while (this.history.length > this.maxHistoryCount) {
-            this.history.shift();
-        }
-        const summary = `heap ${event.heapPct}% (${event.heapUsedMb}/${event.heapLimitMb}MB), rss ${event.rssMb}MB, ` +
-            `GC ${Math.round(event.gcFraction * 100)}% [${event.trigger}]`;
-        if (event.level === 'recovered') {
-            fsm_dynamo_1.DyFM_Log.success(`[DyNTS_MemoryGuard] RECOVERED — ${summary}`);
-            return;
-        }
-        if (event.level === 'critical') {
-            fsm_dynamo_1.DyFM_Log.H_error(`[DyNTS_MemoryGuard] CRITICAL heap pressure — ${summary} — OOM imminent`);
-        }
-        else {
-            fsm_dynamo_1.DyFM_Log.warn(`[DyNTS_MemoryGuard] WARNING heap pressure — ${summary}`);
-        }
-        // Tartós rögzítés a központi error-sinkbe (Errors-rendszer + Discord, ha bekötve).
-        try {
-            global_service_1.DyNTS_GlobalService.globalErrorHandler?.(new fsm_dynamo_1.DyFM_Error({
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName ?? 'DyNTS'}|DyNTS-MG0-HEAP-${event.level.toUpperCase()}`,
-                message: `Heap pressure ${event.level.toUpperCase()}: ${summary}. ` +
-                    `Process approaching the --max-old-space-size ceiling — OOM crash risk.`,
-                additionalContent: { memoryGuardEvent: event, peakHeapPct: Math.round(this.peakHeapPct) },
-                systemVersion: global_settings_const_1.DyNTS_global_settings.systemVersion,
-                level: event.level === 'critical' ? fsm_dynamo_1.DyFM_ErrorLevel.critical : fsm_dynamo_1.DyFM_ErrorLevel.warning,
-            }));
-        }
-        catch (sinkErr) {
-            fsm_dynamo_1.DyFM_Log.warn('[DyNTS_MemoryGuard] error-sink record failed (non-fatal):', sinkErr);
-        }
-        if (event.level === 'critical' && this.onCritical) {
-            try {
-                this.onCritical(event);
-            }
-            catch (hookErr) {
-                fsm_dynamo_1.DyFM_Log.warn('[DyNTS_MemoryGuard] onCritical hook threw (non-fatal):', hookErr);
-            }
-        }
-    }
-    /**
-     * A pillanatnyi heap-nyomás (heap-% + GC-hányad → szint) — a FOGYASZTÓK (pl. egy API-controller) ezzel
-     * gate-elhetik a nehéz műveleteket (load-shed). Olvasás-only, mellékhatás nélkül; nem igényli az install-t.
-     */
-    pressure() {
-        const limitBytes = this.getHeapLimitBytes();
-        const mu = process.memoryUsage();
-        const pct = limitBytes > 0 ? (mu.heapUsed / limitBytes) * 100 : 0;
-        const gcFraction = this.recentGcFraction();
-        const level = (pct >= this.critPct || gcFraction >= this.gcCritFraction) ? 'critical'
-            : (pct >= this.warnPct || gcFraction >= this.gcWarnFraction) ? 'warning' : 'ok';
-        return {
-            level: level,
-            heapUsedMb: Math.round(mu.heapUsed / BYTES_PER_MB),
-            heapLimitMb: Math.round(limitBytes / BYTES_PER_MB),
-            heapPct: Math.round(pct),
-            rssMb: Math.round(mu.rss / BYTES_PER_MB),
-            gcFraction: Math.round(gcFraction * 100) / 100,
-        };
-    }
-    /** `true`, ha a NEHÉZ műveleteket le kell shed-elni (critical nyomás) — a fogyasztó load-shed gate-jének. */
-    shouldShedLoad() {
-        return this.installed && this.pressure().level === 'critical';
-    }
-    /** A GC-hányad az utolsó `pollIntervalMs` ablakban (GC-ms / ablak-ms; clamp [0..1]). Nincs GC-observer → 0. */
-    recentGcFraction() {
-        const windowMs = this.pollIntervalMs > 0 ? this.pollIntervalMs : 10000;
-        const cutoff = Date.now() - windowMs;
-        this.gcEvents = this.gcEvents.filter((event) => event.at >= cutoff);
-        const gcMs = this.gcEvents.reduce((sum, event) => sum + event.ms, 0);
-        return Math.min(gcMs / windowMs, 1);
-    }
-    /** A 'gc' perf-entry-k figyelője — a GC-ben töltött időt gyűjti a gördülő ablakhoz. Best-effort (nem kritikus). */
-    installGcObserver() {
-        try {
-            this.gcObserver = new perf_hooks_1.PerformanceObserver((list) => {
-                const now = Date.now();
-                for (const entry of list.getEntries()) {
-                    this.gcEvents.push({ at: now, ms: entry.duration });
-                }
-            });
-            this.gcObserver.observe({ entryTypes: ['gc'] });
-        }
-        catch (err) {
-            // A GC-observer hiánya nem kritikus — a heap-%-jel marad. Best-effort.
-            fsm_dynamo_1.DyFM_Log.warn('[DyNTS_MemoryGuard] gc-observer install failed (non-fatal):', err);
-        }
-    }
-    /**
-     * Process-szintű `uncaughtException` crash-handler: a (különben néma) crash ELŐTT TELJES-RÉSZLETŰ error-entry
-     * (message + stack + memória-snapshot) az error-sinkbe, majd tiszta exit (a wrapper/restart-policy újraindít).
-     * Az `unhandledRejection`-t a base App már rögzíti; ez az eddig-fedetlen `uncaughtException`-t fedi le.
-     */
-    installCrashHandlers() {
-        this.crashHandler = (error) => {
-            try {
-                const mu = process.memoryUsage();
-                fsm_dynamo_1.DyFM_Log.H_error('[DyNTS_MemoryGuard] FATAL uncaughtException:', error?.stack ?? error);
-                global_service_1.DyNTS_GlobalService.globalErrorHandler?.(new fsm_dynamo_1.DyFM_Error({
-                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName ?? 'DyNTS'}|DyNTS-MG0-UNCAUGHT`,
-                    message: `Uncaught Exception (process-fatal): ${error?.message ?? String(error)}`,
-                    error: error,
-                    additionalContent: {
-                        stack: error?.stack,
-                        heapUsedMb: Math.round(mu.heapUsed / BYTES_PER_MB),
-                        rssMb: Math.round(mu.rss / BYTES_PER_MB),
-                        peakHeapPct: Math.round(this.peakHeapPct),
-                        recentMemoryGuardEvents: this.history.slice(-5),
-                    },
-                    systemVersion: global_settings_const_1.DyNTS_global_settings.systemVersion,
-                    level: fsm_dynamo_1.DyFM_ErrorLevel.critical,
-                }));
-            }
-            catch {
-                // a rögzítés se buktasson — best-effort.
-            }
-            // uncaughtException → a process undefined állapotban van: rögzítés UTÁN tiszta exit (a log/sink flush-re haladék).
-            setTimeout(() => { process.exit(1); }, 250).unref?.();
-        };
-        process.on('uncaughtException', this.crashHandler);
-    }
-    /** Tartós-critical graceful-exit: végső error-entry + tiszta exit (a wrapper újraindít a kriptikus 134 helyett). */
-    gracefulExit(set) {
-        const summary = `heap ${Math.round(set.pct)}% (${Math.round(set.mu.heapUsed / BYTES_PER_MB)}/` +
-            `${Math.round(set.limitBytes / BYTES_PER_MB)}MB), GC ${Math.round(set.gcFraction * 100)}%`;
-        fsm_dynamo_1.DyFM_Log.H_error(`[DyNTS_MemoryGuard] SUSTAINED CRITICAL — ${summary} — graceful exit(${this.exitCode}) a kriptikus OOM (exit 134) helyett.`);
-        try {
-            global_service_1.DyNTS_GlobalService.globalErrorHandler?.(new fsm_dynamo_1.DyFM_Error({
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName ?? 'DyNTS'}|DyNTS-MG0-GRACEFUL-EXIT`,
-                message: `Sustained critical heap pressure (${this.criticalStreak} polls) — graceful exit to let the wrapper/restart-policy recover. ${summary}.`,
-                additionalContent: { peakHeapPct: Math.round(this.peakHeapPct), peakRssMb: Math.round(this.peakRssMb), recentEvents: this.history.slice(-5) },
-                systemVersion: global_settings_const_1.DyNTS_global_settings.systemVersion,
-                level: fsm_dynamo_1.DyFM_ErrorLevel.critical,
-            }));
-        }
-        catch {
-            // best-effort
-        }
-        setTimeout(() => { process.exit(this.exitCode); }, 250).unref?.();
-    }
-    /** A megőrzött események (legrégebbi → legújabb). Csak olvasásra. */
-    getHistory() {
-        return this.history.slice();
-    }
-    /** Pillanatnyi állapot + csúcsok diagnosztikához (pl. egy status-endpoint). */
-    getStatus() {
-        return {
-            installed: this.installed,
-            state: this.state,
-            peakHeapPct: Math.round(this.peakHeapPct),
-            peakRssMb: Math.round(this.peakRssMb),
-            eventCount: this.history.length,
-        };
-    }
-    /** Telepítve van-e a watchdog. */
-    isInstalled() {
-        return this.installed;
-    }
-    /**
-     * Leállítja a watchdogot + visszaállítja az állapotot. Graceful shutdown-hoz ÉS a
-     * spec-ek `afterEach`-éhez (a singleton-state ne szivárogjon a tesztek közt).
-     */
-    _teardownForTesting() {
-        if (this.timer) {
-            clearInterval(this.timer);
-            this.timer = null;
-        }
-        if (this.gcObserver) {
-            try {
-                this.gcObserver.disconnect();
-            }
-            catch { /* best-effort */ }
-            this.gcObserver = null;
-        }
-        if (this.crashHandler) {
-            try {
-                process.removeListener('uncaughtException', this.crashHandler);
-            }
-            catch { /* best-effort */ }
-            this.crashHandler = null;
-        }
-        this.installed = false;
-        this.state = 'normal';
-        this.history.length = 0;
-        this.peakHeapPct = 0;
-        this.peakRssMb = 0;
-        this.gcEvents = [];
-        this.criticalStreak = 0;
-        this.installedAt = 0;
-        this.onCritical = undefined;
-    }
-}
-exports.DyNTS_MemoryGuard = DyNTS_MemoryGuard;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_MemoryGuard = void 0;
+const tslib_1 = require("tslib");
+const v8 = tslib_1.__importStar(require("v8"));
+const perf_hooks_1 = require("perf_hooks");
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const global_settings_const_1 = require("../../_collections/global-settings.const");
+const singleton_service_base_1 = require("../base/singleton.service-base");
+const global_service_1 = require("./global.service");
+const BYTES_PER_MB = 1024 * 1024;
+class DyNTS_MemoryGuard extends singleton_service_base_1.DyNTS_SingletonServiceBase {
+    static getInstance() {
+        return DyNTS_MemoryGuard.getSingletonInstance();
+    }
+    timer = null;
+    installed = false;
+    state = 'normal';
+    // Feloldott (effektív) konfiguráció — install()-kor töltjük.
+    pollIntervalMs = 10000;
+    warnPct = 85;
+    critPct = 95;
+    recoveryMargin = 10;
+    maxHistoryCount = 100;
+    gcWarnFraction = 0.40;
+    gcCritFraction = 0.60;
+    exitOnSustainedCritical = false;
+    sustainedCriticalPolls = 3;
+    exitCode = 137;
+    bootGraceMs = 60000;
+    /** A guard-install időbélyege (a boot-grace számításához; 0 = még nem telepített). */
+    installedAt = 0;
+    onCritical;
+    history = [];
+    peakHeapPct = 0;
+    peakRssMb = 0;
+    // GC-thrash követés (perf_hooks 'gc') — a GC-ben töltött ms gördülő ablaka + a critical-streak számláló.
+    gcObserver = null;
+    gcEvents = [];
+    criticalStreak = 0;
+    // A telepített crash-handler ref-ek (a teardown eltávolításához).
+    crashHandler = null;
+    constructor() {
+        super();
+    }
+    /**
+     * Elindítja a heap-watchdogot. Idempotens (többszöri hívás no-op). A `config`
+     * felülírja a `DyNTS_global_settings.memoryGuard` értékeit, ami a beépített
+     * defaultokat írja felül. SOHA nem dob — egy figyelő-réteg nem dönthet be egy
+     * szervert (minden hiba try/catch-elt + descriptive-en logolt).
+     */
+    install(config) {
+        if (this.installed) {
+            return;
+        }
+        try {
+            const g = global_settings_const_1.DyNTS_global_settings.memoryGuard ?? { enabled: true };
+            this.pollIntervalMs = config?.pollIntervalMs ?? g.pollIntervalMs ?? 10000;
+            this.warnPct = config?.heapWarningThreshold ?? g.heapWarningThreshold ?? 85;
+            this.critPct = config?.heapCriticalThreshold ?? g.heapCriticalThreshold ?? 95;
+            this.recoveryMargin = config?.recoveryMargin ?? g.recoveryMargin ?? 10;
+            this.maxHistoryCount = config?.maxHistoryCount ?? g.maxHistoryCount ?? 100;
+            this.gcWarnFraction = config?.gcWarningFraction ?? g.gcWarningFraction ?? 0.40;
+            this.gcCritFraction = config?.gcCriticalFraction ?? g.gcCriticalFraction ?? 0.60;
+            this.exitOnSustainedCritical = config?.exitOnSustainedCritical ?? g.exitOnSustainedCritical ?? false;
+            this.sustainedCriticalPolls = config?.sustainedCriticalPolls ?? g.sustainedCriticalPolls ?? 3;
+            this.exitCode = config?.exitCode ?? g.exitCode ?? 137;
+            this.bootGraceMs = config?.bootGraceMs ?? g.bootGraceMs ?? 60000;
+            this.installedAt = Date.now();
+            this.onCritical = config?.onCritical;
+            this.installed = true;
+            this.installGcObserver();
+            // Crash-handler (uncaughtException) — teljes-részletű error-entry a crash ELŐTT, majd tiszta exit.
+            if (config?.installCrashHandlers ?? g.installCrashHandlers ?? true) {
+                this.installCrashHandlers();
+            }
+            this.timer = setInterval(() => { this.poll(); }, this.pollIntervalMs);
+            // unref(): a watchdog-timer NE tartsa életben a process-t önmagában (graceful
+            // exit-kor a Node ki tud lépni a függő interval ellenére is).
+            if (typeof this.timer.unref === 'function') {
+                this.timer.unref();
+            }
+            fsm_dynamo_1.DyFM_Log.info(`[DyNTS_MemoryGuard] installed — poll ${this.pollIntervalMs}ms, ` +
+                `warn ${this.warnPct}%/${Math.round(this.gcWarnFraction * 100)}%GC, ` +
+                `crit ${this.critPct}%/${Math.round(this.gcCritFraction * 100)}%GC (heap limit ` +
+                `${Math.round(this.getHeapLimitBytes() / BYTES_PER_MB)}MB)` +
+                (this.exitOnSustainedCritical ? `, graceful-exit@${this.sustainedCriticalPolls} critical polls (boot-grace ${this.bootGraceMs}ms)` : ''));
+        }
+        catch (err) {
+            // Telepítési hiba SEM lehet fatal — a guard hiánya nem ér annyit, hogy a
+            // szerver-indulást megakassza.
+            fsm_dynamo_1.DyFM_Log.warn('[DyNTS_MemoryGuard] install failed (non-fatal):', err);
+        }
+    }
+    /** A heap-plafon byte-ban (`--max-old-space-size`). Külön metódus a spec-mockoláshoz. */
+    getHeapLimitBytes() {
+        return v8.getHeapStatistics().heap_size_limit;
+    }
+    /**
+     * Egy poll-ciklus: kiolvassa a heap-kihasználtságot, frissíti a csúcsokat, és a
+     * hiszterézis-állapotgép szerint esemény-átlépéskor rögzít + logol. SOHA nem dob.
+     */
+    poll() {
+        try {
+            const limitBytes = this.getHeapLimitBytes();
+            if (!limitBytes || limitBytes <= 0) {
+                return;
+            }
+            const mu = process.memoryUsage();
+            const pct = (mu.heapUsed / limitBytes) * 100;
+            const gcFraction = this.recentGcFraction();
+            const rssMb = mu.rss / BYTES_PER_MB;
+            if (pct > this.peakHeapPct) {
+                this.peakHeapPct = pct;
+            }
+            if (rssMb > this.peakRssMb) {
+                this.peakRssMb = rssMb;
+            }
+            // A szintet a heap-% ÉS a GC-hányad közül a ROSSZABB dönti el (a GC-thrash a %-küszöb ALATT is OOM-ot jelez).
+            const heapCrit = pct >= this.critPct;
+            const gcCrit = gcFraction >= this.gcCritFraction;
+            const heapWarn = pct >= this.warnPct;
+            const gcWarn = gcFraction >= this.gcWarnFraction;
+            // Hiszterézis-állapotgép — esemény CSAK állapot-váltáskor.
+            const prev = this.state;
+            let next = prev;
+            if (heapCrit || gcCrit) {
+                next = 'critical';
+            }
+            else if ((heapWarn || gcWarn) && prev === 'normal') {
+                next = 'warning';
+            }
+            else if (pct <= this.warnPct - this.recoveryMargin && gcFraction < this.gcWarnFraction) {
+                next = 'normal';
+            }
+            // Egyébként marad a jelenlegi állapot (hiszterézis-sáv) — nincs re-emit.
+            // Sustained-critical streak + opcionális graceful-exit (állapot-váltástól FÜGGETLENÜL számolva). A boot-grace
+            // alatt (install + bootGraceMs) NEM lép ki — a nehéz-boot (pool-hidratáló) appok eleve GC-thrash-elnek a boot
+            // alatt, így a sustained-exit boot-loop-ot okozna; a grace UTÁN a tartós critical a VALÓDI runtime-OOM-ot kezeli.
+            if (next === 'critical') {
+                this.criticalStreak += 1;
+                const pastBootGrace = (Date.now() - this.installedAt) >= this.bootGraceMs;
+                if (this.exitOnSustainedCritical && pastBootGrace && this.criticalStreak >= this.sustainedCriticalPolls) {
+                    this.gracefulExit({ pct: pct, gcFraction: gcFraction, limitBytes: limitBytes, mu: mu });
+                    return;
+                }
+            }
+            else {
+                this.criticalStreak = 0;
+            }
+            if (next === prev) {
+                return;
+            }
+            this.state = next;
+            const trigger = next === 'normal' ? 'recovery'
+                : (heapCrit || heapWarn) && (gcCrit || gcWarn) ? 'heap+gc'
+                    : (gcCrit || gcWarn) ? 'gc' : 'heap';
+            const event = {
+                level: next === 'normal' ? 'recovered' : next,
+                heapUsedMb: Math.round(mu.heapUsed / BYTES_PER_MB),
+                heapLimitMb: Math.round(limitBytes / BYTES_PER_MB),
+                heapPct: Math.round(pct),
+                rssMb: Math.round(rssMb),
+                externalMb: Math.round((mu.external ?? 0) / BYTES_PER_MB),
+                gcFraction: Math.round(gcFraction * 100) / 100,
+                trigger: trigger,
+                at: new Date().toISOString(),
+            };
+            this.recordEvent(event);
+        }
+        catch (err) {
+            // Poll-hiba sosem fatal — a következő tick újrapróbálja.
+            fsm_dynamo_1.DyFM_Log.warn('[DyNTS_MemoryGuard] poll error (non-fatal):', err);
+        }
+    }
+    /** Esemény ring-bufferbe + log + (warning/critical esetén) tartós error-sink. */
+    recordEvent(event) {
+        this.history.push(event);
+        while (this.history.length > this.maxHistoryCount) {
+            this.history.shift();
+        }
+        const summary = `heap ${event.heapPct}% (${event.heapUsedMb}/${event.heapLimitMb}MB), rss ${event.rssMb}MB, ` +
+            `GC ${Math.round(event.gcFraction * 100)}% [${event.trigger}]`;
+        if (event.level === 'recovered') {
+            fsm_dynamo_1.DyFM_Log.success(`[DyNTS_MemoryGuard] RECOVERED — ${summary}`);
+            return;
+        }
+        if (event.level === 'critical') {
+            fsm_dynamo_1.DyFM_Log.H_error(`[DyNTS_MemoryGuard] CRITICAL heap pressure — ${summary} — OOM imminent`);
+        }
+        else {
+            fsm_dynamo_1.DyFM_Log.warn(`[DyNTS_MemoryGuard] WARNING heap pressure — ${summary}`);
+        }
+        // Tartós rögzítés a központi error-sinkbe (Errors-rendszer + Discord, ha bekötve).
+        try {
+            global_service_1.DyNTS_GlobalService.globalErrorHandler?.(new fsm_dynamo_1.DyFM_Error({
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName ?? 'DyNTS'}|DyNTS-MG0-HEAP-${event.level.toUpperCase()}`,
+                message: `Heap pressure ${event.level.toUpperCase()}: ${summary}. ` +
+                    `Process approaching the --max-old-space-size ceiling — OOM crash risk.`,
+                additionalContent: { memoryGuardEvent: event, peakHeapPct: Math.round(this.peakHeapPct) },
+                systemVersion: global_settings_const_1.DyNTS_global_settings.systemVersion,
+                level: event.level === 'critical' ? fsm_dynamo_1.DyFM_ErrorLevel.critical : fsm_dynamo_1.DyFM_ErrorLevel.warning,
+            }));
+        }
+        catch (sinkErr) {
+            fsm_dynamo_1.DyFM_Log.warn('[DyNTS_MemoryGuard] error-sink record failed (non-fatal):', sinkErr);
+        }
+        if (event.level === 'critical' && this.onCritical) {
+            try {
+                this.onCritical(event);
+            }
+            catch (hookErr) {
+                fsm_dynamo_1.DyFM_Log.warn('[DyNTS_MemoryGuard] onCritical hook threw (non-fatal):', hookErr);
+            }
+        }
+    }
+    /**
+     * A pillanatnyi heap-nyomás (heap-% + GC-hányad → szint) — a FOGYASZTÓK (pl. egy API-controller) ezzel
+     * gate-elhetik a nehéz műveleteket (load-shed). Olvasás-only, mellékhatás nélkül; nem igényli az install-t.
+     */
+    pressure() {
+        const limitBytes = this.getHeapLimitBytes();
+        const mu = process.memoryUsage();
+        const pct = limitBytes > 0 ? (mu.heapUsed / limitBytes) * 100 : 0;
+        const gcFraction = this.recentGcFraction();
+        const level = (pct >= this.critPct || gcFraction >= this.gcCritFraction) ? 'critical'
+            : (pct >= this.warnPct || gcFraction >= this.gcWarnFraction) ? 'warning' : 'ok';
+        return {
+            level: level,
+            heapUsedMb: Math.round(mu.heapUsed / BYTES_PER_MB),
+            heapLimitMb: Math.round(limitBytes / BYTES_PER_MB),
+            heapPct: Math.round(pct),
+            rssMb: Math.round(mu.rss / BYTES_PER_MB),
+            gcFraction: Math.round(gcFraction * 100) / 100,
+        };
+    }
+    /** `true`, ha a NEHÉZ műveleteket le kell shed-elni (critical nyomás) — a fogyasztó load-shed gate-jének. */
+    shouldShedLoad() {
+        return this.installed && this.pressure().level === 'critical';
+    }
+    /** A GC-hányad az utolsó `pollIntervalMs` ablakban (GC-ms / ablak-ms; clamp [0..1]). Nincs GC-observer → 0. */
+    recentGcFraction() {
+        const windowMs = this.pollIntervalMs > 0 ? this.pollIntervalMs : 10000;
+        const cutoff = Date.now() - windowMs;
+        this.gcEvents = this.gcEvents.filter((event) => event.at >= cutoff);
+        const gcMs = this.gcEvents.reduce((sum, event) => sum + event.ms, 0);
+        return Math.min(gcMs / windowMs, 1);
+    }
+    /** A 'gc' perf-entry-k figyelője — a GC-ben töltött időt gyűjti a gördülő ablakhoz. Best-effort (nem kritikus). */
+    installGcObserver() {
+        try {
+            this.gcObserver = new perf_hooks_1.PerformanceObserver((list) => {
+                const now = Date.now();
+                for (const entry of list.getEntries()) {
+                    this.gcEvents.push({ at: now, ms: entry.duration });
+                }
+            });
+            this.gcObserver.observe({ entryTypes: ['gc'] });
+        }
+        catch (err) {
+            // A GC-observer hiánya nem kritikus — a heap-%-jel marad. Best-effort.
+            fsm_dynamo_1.DyFM_Log.warn('[DyNTS_MemoryGuard] gc-observer install failed (non-fatal):', err);
+        }
+    }
+    /**
+     * Process-szintű `uncaughtException` crash-handler: a (különben néma) crash ELŐTT TELJES-RÉSZLETŰ error-entry
+     * (message + stack + memória-snapshot) az error-sinkbe, majd tiszta exit (a wrapper/restart-policy újraindít).
+     * Az `unhandledRejection`-t a base App már rögzíti; ez az eddig-fedetlen `uncaughtException`-t fedi le.
+     */
+    installCrashHandlers() {
+        this.crashHandler = (error) => {
+            try {
+                const mu = process.memoryUsage();
+                fsm_dynamo_1.DyFM_Log.H_error('[DyNTS_MemoryGuard] FATAL uncaughtException:', error?.stack ?? error);
+                global_service_1.DyNTS_GlobalService.globalErrorHandler?.(new fsm_dynamo_1.DyFM_Error({
+                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName ?? 'DyNTS'}|DyNTS-MG0-UNCAUGHT`,
+                    message: `Uncaught Exception (process-fatal): ${error?.message ?? String(error)}`,
+                    error: error,
+                    additionalContent: {
+                        stack: error?.stack,
+                        heapUsedMb: Math.round(mu.heapUsed / BYTES_PER_MB),
+                        rssMb: Math.round(mu.rss / BYTES_PER_MB),
+                        peakHeapPct: Math.round(this.peakHeapPct),
+                        recentMemoryGuardEvents: this.history.slice(-5),
+                    },
+                    systemVersion: global_settings_const_1.DyNTS_global_settings.systemVersion,
+                    level: fsm_dynamo_1.DyFM_ErrorLevel.critical,
+                }));
+            }
+            catch {
+                // a rögzítés se buktasson — best-effort.
+            }
+            // uncaughtException → a process undefined állapotban van: rögzítés UTÁN tiszta exit (a log/sink flush-re haladék).
+            setTimeout(() => { process.exit(1); }, 250).unref?.();
+        };
+        process.on('uncaughtException', this.crashHandler);
+    }
+    /** Tartós-critical graceful-exit: végső error-entry + tiszta exit (a wrapper újraindít a kriptikus 134 helyett). */
+    gracefulExit(set) {
+        const summary = `heap ${Math.round(set.pct)}% (${Math.round(set.mu.heapUsed / BYTES_PER_MB)}/` +
+            `${Math.round(set.limitBytes / BYTES_PER_MB)}MB), GC ${Math.round(set.gcFraction * 100)}%`;
+        fsm_dynamo_1.DyFM_Log.H_error(`[DyNTS_MemoryGuard] SUSTAINED CRITICAL — ${summary} — graceful exit(${this.exitCode}) a kriptikus OOM (exit 134) helyett.`);
+        try {
+            global_service_1.DyNTS_GlobalService.globalErrorHandler?.(new fsm_dynamo_1.DyFM_Error({
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName ?? 'DyNTS'}|DyNTS-MG0-GRACEFUL-EXIT`,
+                message: `Sustained critical heap pressure (${this.criticalStreak} polls) — graceful exit to let the wrapper/restart-policy recover. ${summary}.`,
+                additionalContent: { peakHeapPct: Math.round(this.peakHeapPct), peakRssMb: Math.round(this.peakRssMb), recentEvents: this.history.slice(-5) },
+                systemVersion: global_settings_const_1.DyNTS_global_settings.systemVersion,
+                level: fsm_dynamo_1.DyFM_ErrorLevel.critical,
+            }));
+        }
+        catch {
+            // best-effort
+        }
+        setTimeout(() => { process.exit(this.exitCode); }, 250).unref?.();
+    }
+    /** A megőrzött események (legrégebbi → legújabb). Csak olvasásra. */
+    getHistory() {
+        return this.history.slice();
+    }
+    /** Pillanatnyi állapot + csúcsok diagnosztikához (pl. egy status-endpoint). */
+    getStatus() {
+        return {
+            installed: this.installed,
+            state: this.state,
+            peakHeapPct: Math.round(this.peakHeapPct),
+            peakRssMb: Math.round(this.peakRssMb),
+            eventCount: this.history.length,
+        };
+    }
+    /** Telepítve van-e a watchdog. */
+    isInstalled() {
+        return this.installed;
+    }
+    /**
+     * Leállítja a watchdogot + visszaállítja az állapotot. Graceful shutdown-hoz ÉS a
+     * spec-ek `afterEach`-éhez (a singleton-state ne szivárogjon a tesztek közt).
+     */
+    _teardownForTesting() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        if (this.gcObserver) {
+            try {
+                this.gcObserver.disconnect();
+            }
+            catch { /* best-effort */ }
+            this.gcObserver = null;
+        }
+        if (this.crashHandler) {
+            try {
+                process.removeListener('uncaughtException', this.crashHandler);
+            }
+            catch { /* best-effort */ }
+            this.crashHandler = null;
+        }
+        this.installed = false;
+        this.state = 'normal';
+        this.history.length = 0;
+        this.peakHeapPct = 0;
+        this.peakRssMb = 0;
+        this.gcEvents = [];
+        this.criticalStreak = 0;
+        this.installedAt = 0;
+        this.onCritical = undefined;
+    }
+}
+exports.DyNTS_MemoryGuard = DyNTS_MemoryGuard;
 //# sourceMappingURL=memory-guard.service.js.map