@futdevpro/nts-dynamo 1.15.156 → 1.15.157

package/build/_collections/global-settings.const.js

@@ -1,105 +1,105 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyNTS_global_settings = void 0;
-const route_security_enum_1 = require("../_enums/route-security.enum");
-const socket_security_enum_1 = require("../_modules/socket/_enums/socket-security.enum");
-const get_environment_settings_util_1 = require("./get-environment-settings.util");
-/**
- * Default configuration used across the NodeTS framework.
- * These values can be overridden when bootstrapping the server.
- */
-exports.DyNTS_global_settings = {
-    baseUrl: '/api',
-    systemVersion: 'unknown-version',
-    defaultRouteSecurity: route_security_enum_1.DyNTS_RouteSecurity.open,
-    defaultSocketSecurity: socket_security_enum_1.DyNTS_SocketSecurity.open,
-    defaultPageSize: 10,
-    archiveListAfter: 100,
-    env_settings: (0, get_environment_settings_util_1.DyNTS_getEnvironment_settings)(),
-    autoResolveEndpointCirculationErrors: true,
-    compactErrorResponse: true,
-    log_settings: {
-        highDetailedLogs: false,
-        setup: false,
-        request: true,
-        requestsContent: false,
-        responseContent: false,
-        requestStackLocation: false,
-        socket_allEvents: true,
-        socket_mainEvents: true,
-        socket_eventContent: false,
-        api_events: true,
-        api_requestContents: false,
-        api_requestSettings: false,
-        api_responseContents: false,
-        api_errors: true,
-        detailedErrors: false,
-        server_debug: false,
-        logs_endpoint: {
-            enabled: false,
-            maxEntries: 2000,
-        },
-    },
-    autoResearchIssues: true,
-    // Auth-service kötelező alapból (régi viselkedés). Public / no-auth szervereknél
-    // `auth_settings.optional = true` → getAuthService() undefined-ot ad dobás helyett,
-    // és a startup 'Authentication Service missing!' warn is elmarad.
-    auth_settings: {
-        optional: false,
-    },
-    bot_settings: null,
-    openAi_settings: null,
-    dias_settings: null,
-    assistant_settings: null,
-    docChunking: {
-        maxChunkSize: 1000,
-        maxChunkCount: 1000,
-    },
-    // BFR-MASTERPROMPTER-011 / SEC-R2-8 — security response-headerek default-ON (safe-by-default
-    // készlet: x-powered-by removal + SAMEORIGIN + nosniff + strict-origin-when-cross-origin;
-    // HSTS AUTO csak prod-on; CSP opt-in). Per-app tweak az overrideDynamoNTSGlobalSettings()-ben.
-    securityHeaders: {
-        enabled: true,
-        removePoweredBy: true,
-    },
-    // FR-193 — bedrock OOM korai-figyelmeztető heap-watchdog. Default-on: minden nts-szerver
-    // megkapja a heap-nyomás-figyelést a base App startup-ban (lásd DyNTS_MemoryGuard). Csak
-    // MEGFIGYELÉS + tartós rögzítés a near-OOM küszöböknél — nem változtat a viselkedésen.
-    memoryGuard: {
-        enabled: true,
-        pollIntervalMs: 10000,
-        heapWarningThreshold: 85,
-        heapCriticalThreshold: 95,
-        recoveryMargin: 10,
-        maxHistoryCount: 100,
-        // GC-thrash precursor (a %-küszöb által gyakran KÉSŐN/sosem fogott OOM) + crash-entry + opcionális graceful-exit.
-        gcWarningFraction: 0.40,
-        gcCriticalFraction: 0.60,
-        installCrashHandlers: true,
-        exitOnSustainedCritical: false,
-        sustainedCriticalPolls: 3,
-        exitCode: 137,
-        bootGraceMs: 60000,
-        // Auto-load-shed 503 (BFR-OVERSEER-009 maradék) — opt-in; esszenciális útvonalak kivételével.
-        loadShedEnabled: false,
-        loadShedExemptPathParts: ['/health', '/readiness', '/status', '/diag'],
-    },
-    // Event-loop-lag diag (BFR-OVERSEER-007) — olcsó natív mérés, default ON (opt-out lehetséges).
-    eventLoopDiag: {
-        enabled: true,
-        pollIntervalMs: 5000,
-        maxHistoryCount: 120,
-    },
-    // FR-258 / SR-4 — proactive collection-growth monitor (companion to memoryGuard). Periodically
-    // samples each collection's document count (scan-free estimatedDocumentCount) and warns into the
-    // Errors-sink BEFORE an unbounded collection can be loaded into heap and OOM. Observation only —
-    // never deletes (retention SR-1/SR-2 does the deleting). Slow cadence (5 min) — growth is slow.
-    collectionGrowthMonitor: {
-        enabled: true,
-        pollIntervalMs: 300000,
-        sizeThresholdDocCount: 250000,
-        growthRateThresholdPct: 50,
-        reAlertCooldownMs: 3600000,
-    },
-};
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_global_settings = void 0;
+const route_security_enum_1 = require("../_enums/route-security.enum");
+const socket_security_enum_1 = require("../_modules/socket/_enums/socket-security.enum");
+const get_environment_settings_util_1 = require("./get-environment-settings.util");
+/**
+ * Default configuration used across the NodeTS framework.
+ * These values can be overridden when bootstrapping the server.
+ */
+exports.DyNTS_global_settings = {
+    baseUrl: '/api',
+    systemVersion: 'unknown-version',
+    defaultRouteSecurity: route_security_enum_1.DyNTS_RouteSecurity.open,
+    defaultSocketSecurity: socket_security_enum_1.DyNTS_SocketSecurity.open,
+    defaultPageSize: 10,
+    archiveListAfter: 100,
+    env_settings: (0, get_environment_settings_util_1.DyNTS_getEnvironment_settings)(),
+    autoResolveEndpointCirculationErrors: true,
+    compactErrorResponse: true,
+    log_settings: {
+        highDetailedLogs: false,
+        setup: false,
+        request: true,
+        requestsContent: false,
+        responseContent: false,
+        requestStackLocation: false,
+        socket_allEvents: true,
+        socket_mainEvents: true,
+        socket_eventContent: false,
+        api_events: true,
+        api_requestContents: false,
+        api_requestSettings: false,
+        api_responseContents: false,
+        api_errors: true,
+        detailedErrors: false,
+        server_debug: false,
+        logs_endpoint: {
+            enabled: false,
+            maxEntries: 2000,
+        },
+    },
+    autoResearchIssues: true,
+    // Auth-service kötelező alapból (régi viselkedés). Public / no-auth szervereknél
+    // `auth_settings.optional = true` → getAuthService() undefined-ot ad dobás helyett,
+    // és a startup 'Authentication Service missing!' warn is elmarad.
+    auth_settings: {
+        optional: false,
+    },
+    bot_settings: null,
+    openAi_settings: null,
+    dias_settings: null,
+    assistant_settings: null,
+    docChunking: {
+        maxChunkSize: 1000,
+        maxChunkCount: 1000,
+    },
+    // BFR-MASTERPROMPTER-011 / SEC-R2-8 — security response-headerek default-ON (safe-by-default
+    // készlet: x-powered-by removal + SAMEORIGIN + nosniff + strict-origin-when-cross-origin;
+    // HSTS AUTO csak prod-on; CSP opt-in). Per-app tweak az overrideDynamoNTSGlobalSettings()-ben.
+    securityHeaders: {
+        enabled: true,
+        removePoweredBy: true,
+    },
+    // FR-193 — bedrock OOM korai-figyelmeztető heap-watchdog. Default-on: minden nts-szerver
+    // megkapja a heap-nyomás-figyelést a base App startup-ban (lásd DyNTS_MemoryGuard). Csak
+    // MEGFIGYELÉS + tartós rögzítés a near-OOM küszöböknél — nem változtat a viselkedésen.
+    memoryGuard: {
+        enabled: true,
+        pollIntervalMs: 10000,
+        heapWarningThreshold: 85,
+        heapCriticalThreshold: 95,
+        recoveryMargin: 10,
+        maxHistoryCount: 100,
+        // GC-thrash precursor (a %-küszöb által gyakran KÉSŐN/sosem fogott OOM) + crash-entry + opcionális graceful-exit.
+        gcWarningFraction: 0.40,
+        gcCriticalFraction: 0.60,
+        installCrashHandlers: true,
+        exitOnSustainedCritical: false,
+        sustainedCriticalPolls: 3,
+        exitCode: 137,
+        bootGraceMs: 60000,
+        // Auto-load-shed 503 (BFR-OVERSEER-009 maradék) — opt-in; esszenciális útvonalak kivételével.
+        loadShedEnabled: false,
+        loadShedExemptPathParts: ['/health', '/readiness', '/status', '/diag'],
+    },
+    // Event-loop-lag diag (BFR-OVERSEER-007) — olcsó natív mérés, default ON (opt-out lehetséges).
+    eventLoopDiag: {
+        enabled: true,
+        pollIntervalMs: 5000,
+        maxHistoryCount: 120,
+    },
+    // FR-258 / SR-4 — proactive collection-growth monitor (companion to memoryGuard). Periodically
+    // samples each collection's document count (scan-free estimatedDocumentCount) and warns into the
+    // Errors-sink BEFORE an unbounded collection can be loaded into heap and OOM. Observation only —
+    // never deletes (retention SR-1/SR-2 does the deleting). Slow cadence (5 min) — growth is slow.
+    collectionGrowthMonitor: {
+        enabled: true,
+        pollIntervalMs: 300000,
+        sizeThresholdDocCount: 250000,
+        growthRateThresholdPct: 50,
+        reAlertCooldownMs: 3600000,
+    },
+};
 //# sourceMappingURL=global-settings.const.js.map

package/build/_collections/load-shed.util.d.ts

@@ -1,16 +1,16 @@
-import * as Express from 'express';
-/**
- * Auto-load-shed Express-middleware (BFR-OVERSEER-009 maradék — a MemoryGuard self-heal rétege).
- *
- * CRITICAL memória-nyomásnál (`DyNTS_MemoryGuard.shouldShedLoad()` — heap-% VAGY GC-thrash küszöb
- * felett) az új, NEM-esszenciális kéréseket gyors **503 + Retry-After**-rel ejti, mielőtt azok
- * tovább terhelnék a heap-et — a GC levegőhöz jut, a death-spiral (2026-07-05 Overseer-eset:
- * GC 100%, event-loop blokk, restart-immún wedge) megelőzhető.
- *
- * - **Opt-in:** csak `memoryGuard.loadShedEnabled: true` esetén mountolódik (ops-döntés).
- * - **Esszenciális-kivétel:** a `loadShedExemptPathParts` path-részekre (healthcheck/readiness/
- *   status/diag) SOSEM shed-el — különben a restart-policy health-probe-ját ölné meg (öngól).
- * - A shed-döntés kérésenként olcsó (in-memory pressure-olvasás, nincs I/O).
- */
-export declare function DyNTS_createLoadShedMiddleware(): Express.Handler;
+import * as Express from 'express';
+/**
+ * Auto-load-shed Express-middleware (BFR-OVERSEER-009 maradék — a MemoryGuard self-heal rétege).
+ *
+ * CRITICAL memória-nyomásnál (`DyNTS_MemoryGuard.shouldShedLoad()` — heap-% VAGY GC-thrash küszöb
+ * felett) az új, NEM-esszenciális kéréseket gyors **503 + Retry-After**-rel ejti, mielőtt azok
+ * tovább terhelnék a heap-et — a GC levegőhöz jut, a death-spiral (2026-07-05 Overseer-eset:
+ * GC 100%, event-loop blokk, restart-immún wedge) megelőzhető.
+ *
+ * - **Opt-in:** csak `memoryGuard.loadShedEnabled: true` esetén mountolódik (ops-döntés).
+ * - **Esszenciális-kivétel:** a `loadShedExemptPathParts` path-részekre (healthcheck/readiness/
+ *   status/diag) SOSEM shed-el — különben a restart-policy health-probe-ját ölné meg (öngól).
+ * - A shed-döntés kérésenként olcsó (in-memory pressure-olvasás, nincs I/O).
+ */
+export declare function DyNTS_createLoadShedMiddleware(): Express.Handler;
 //# sourceMappingURL=load-shed.util.d.ts.map

package/build/_collections/load-shed.util.js

@@ -1,43 +1,43 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyNTS_createLoadShedMiddleware = DyNTS_createLoadShedMiddleware;
-const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
-const global_settings_const_1 = require("./global-settings.const");
-const memory_guard_service_1 = require("../_services/core/memory-guard.service");
-/**
- * Auto-load-shed Express-middleware (BFR-OVERSEER-009 maradék — a MemoryGuard self-heal rétege).
- *
- * CRITICAL memória-nyomásnál (`DyNTS_MemoryGuard.shouldShedLoad()` — heap-% VAGY GC-thrash küszöb
- * felett) az új, NEM-esszenciális kéréseket gyors **503 + Retry-After**-rel ejti, mielőtt azok
- * tovább terhelnék a heap-et — a GC levegőhöz jut, a death-spiral (2026-07-05 Overseer-eset:
- * GC 100%, event-loop blokk, restart-immún wedge) megelőzhető.
- *
- * - **Opt-in:** csak `memoryGuard.loadShedEnabled: true` esetén mountolódik (ops-döntés).
- * - **Esszenciális-kivétel:** a `loadShedExemptPathParts` path-részekre (healthcheck/readiness/
- *   status/diag) SOSEM shed-el — különben a restart-policy health-probe-ját ölné meg (öngól).
- * - A shed-döntés kérésenként olcsó (in-memory pressure-olvasás, nincs I/O).
- */
-function DyNTS_createLoadShedMiddleware() {
-    const exemptParts = global_settings_const_1.DyNTS_global_settings.memoryGuard?.loadShedExemptPathParts ?? ['/health', '/readiness', '/status', '/diag'];
-    let lastShedLogAt = 0;
-    return (req, res, next) => {
-        // esszenciális útvonal → soha nem shed-elünk
-        if (exemptParts.some((part) => req.path.includes(part))) {
-            next();
-            return;
-        }
-        if (memory_guard_service_1.DyNTS_MemoryGuard.getInstance().shouldShedLoad()) {
-            // log-throttle: shed-viharban sem árasztjuk el a logot (10s-enként egy jelzés)
-            const now = Date.now();
-            if (now - lastShedLogAt > 10000) {
-                lastShedLogAt = now;
-                fsm_dynamo_1.DyFM_Log.warn(`[load-shed] CRITICAL memory pressure — shedding non-essential requests (503). path: ${req.path}`);
-            }
-            res.status(503).setHeader('Retry-After', '10');
-            res.send({ message: 'Server is under critical memory pressure. Retry shortly.' });
-            return;
-        }
-        next();
-    };
-}
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_createLoadShedMiddleware = DyNTS_createLoadShedMiddleware;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const global_settings_const_1 = require("./global-settings.const");
+const memory_guard_service_1 = require("../_services/core/memory-guard.service");
+/**
+ * Auto-load-shed Express-middleware (BFR-OVERSEER-009 maradék — a MemoryGuard self-heal rétege).
+ *
+ * CRITICAL memória-nyomásnál (`DyNTS_MemoryGuard.shouldShedLoad()` — heap-% VAGY GC-thrash küszöb
+ * felett) az új, NEM-esszenciális kéréseket gyors **503 + Retry-After**-rel ejti, mielőtt azok
+ * tovább terhelnék a heap-et — a GC levegőhöz jut, a death-spiral (2026-07-05 Overseer-eset:
+ * GC 100%, event-loop blokk, restart-immún wedge) megelőzhető.
+ *
+ * - **Opt-in:** csak `memoryGuard.loadShedEnabled: true` esetén mountolódik (ops-döntés).
+ * - **Esszenciális-kivétel:** a `loadShedExemptPathParts` path-részekre (healthcheck/readiness/
+ *   status/diag) SOSEM shed-el — különben a restart-policy health-probe-ját ölné meg (öngól).
+ * - A shed-döntés kérésenként olcsó (in-memory pressure-olvasás, nincs I/O).
+ */
+function DyNTS_createLoadShedMiddleware() {
+    const exemptParts = global_settings_const_1.DyNTS_global_settings.memoryGuard?.loadShedExemptPathParts ?? ['/health', '/readiness', '/status', '/diag'];
+    let lastShedLogAt = 0;
+    return (req, res, next) => {
+        // esszenciális útvonal → soha nem shed-elünk
+        if (exemptParts.some((part) => req.path.includes(part))) {
+            next();
+            return;
+        }
+        if (memory_guard_service_1.DyNTS_MemoryGuard.getInstance().shouldShedLoad()) {
+            // log-throttle: shed-viharban sem árasztjuk el a logot (10s-enként egy jelzés)
+            const now = Date.now();
+            if (now - lastShedLogAt > 10000) {
+                lastShedLogAt = now;
+                fsm_dynamo_1.DyFM_Log.warn(`[load-shed] CRITICAL memory pressure — shedding non-essential requests (503). path: ${req.path}`);
+            }
+            res.status(503).setHeader('Retry-After', '10');
+            res.send({ message: 'Server is under critical memory pressure. Retry shortly.' });
+            return;
+        }
+        next();
+    };
+}
 //# sourceMappingURL=load-shed.util.js.map

package/build/_collections/mongo-reconnect-guard.util.d.ts

@@ -1,74 +1,74 @@
-/**
- * DyNTS Mongo reconnect-guard (2026-06-20) — TÚLÉLI a Mongo-konténer IP-VÁLTÁSÁT.
- *
- * PROBLÉMA (élőben, 2026-06-19): a MongoDB-driver a hostnevet (`mongodb`) connect-kor EGYSZER
- * resolválja és cache-eli az IP-t (pl. 172.18.0.20); standalone-nál disconnect után UGYANAZT az
- * IP-t pingeli, NEM re-resolve-ol. Ha a Mongo-konténert recreate-elik (új docker-network IP), a
- * driver örökre a HALOTT IP-n lóg → `connect ECONNREFUSED <oldIp>:29017` + `buffering timed out`,
- * és a service magától SOHA nem áll vissza (csak külső restart-tal). Ez a 2026-06-19 incidens fél
- * test-stacket levitt (auth/ftp/helocia/futdevpro/… mind a régi Mongo-IP-n ragadt).
- *
- * MEGOLDÁS: a guard figyeli a `mongoose.connection.readyState`-et; ha TARTÓSAN nem-connected
- * (a driver saját reconnect-grace-e UTÁN is), **TELJES `disconnect()` + `connect()`-et** csinál
- * → ÚJ MongoClient → ÚJ DNS-resolve → új IP → reconnect. Így minden DyNTS_App-service magától
- * túléli a Mongo IP-váltását, KÜLSŐ beavatkozás nélkül. Best-effort, sose dob; csak konténer-IP-
- * frissítés, NEM törli/írja az adatot.
- *
- * SAFE always-on: egy app újracsatlakozása a SAJÁT DB-jéhez korrekt, nem-destruktív viselkedés
- * (nincs az infra-restart-érzékenység, ami a külső watchdog-oknál — FR-229/237). Csak akkor
- * avatkozik be, ha readyState !== 1 a grace + cooldown letelte UTÁN is; healthy connection-t (===1)
- * SOHA nem bánt.
- *
- * A döntés-mag (`shouldForceMongoReconnect`) PURE + unit-tesztelt; a futtató injektált dep-ekkel
- * dolgozik (readyState-olvasás / reconnect / log) a tesztelhetőségért.
- */
-/** A pure döntés inputja (minden numerikus → determinisztikus + tesztelhető). */
-export interface MongoReconnectState {
-    /** mongoose.connection.readyState: 0=disconnected, 1=connected, 2=connecting, 3=disconnecting. */
-    readyState: number;
-    /** Mióta (ms) nem-connected a readyState (0, ha épp connected). */
-    msSinceUnhealthy: number;
-    /** Grace: ennyi ideig hagyjuk a drivert SAJÁT magát visszahozni, mielőtt force-reconnectolnánk. */
-    unhealthyGraceMs: number;
-    /** Épp folyamatban van-e már egy force-reconnect (ne torlódjon). */
-    reconnectInFlight: boolean;
-    /** Mióta (ms) volt az utolsó force-reconnect (Infinity, ha még nem volt). */
-    msSinceLastReconnect: number;
-    /** Két force-reconnect közti minimum (anti-thrash). */
-    reconnectCooldownMs: number;
-}
-/** A pure döntés eredménye. */
-export interface MongoReconnectDecision {
-    reconnect: boolean;
-    reason: string;
-}
-/**
- * PURE döntés: kell-e force-reconnect. Healthy (===1) / connecting (===2) / in-flight / grace-en
- * vagy cooldown-on belül → NEM. Csak tartós nem-connected (disconnected/disconnecting) + grace és
- * cooldown letelt + nincs in-flight → IGEN.
- */
-export declare function shouldForceMongoReconnect(s: MongoReconnectState): MongoReconnectDecision;
-/** Injektált függőségek a futtatóhoz (best-effort; a futtató sose dob). */
-export interface MongoReconnectGuardDeps {
-    /** A jelenlegi `mongoose.connection.readyState`. */
-    getReadyState: () => number;
-    /**
-     * Force-reconnect: `disconnect()` majd `connect(uri, opts)` — ÚJ MongoClient → ÚJ DNS-resolve.
-     * Dobhat (a connect elbukhat, ha a Mongo épp tényleg down) — a futtató elkapja.
-     */
-    reconnect: () => Promise<void>;
-    /** Log. */
-    log: (msg: string) => void;
-    /** Tick-intervallum (ms). Default 10s. */
-    intervalMs?: number;
-    /** Grace, amíg a driver saját reconnect-jét várjuk (ms). Default 30s. */
-    unhealthyGraceMs?: number;
-    /** Cooldown két force-reconnect közt (ms). Default 20s. */
-    reconnectCooldownMs?: number;
-}
-/**
- * Elindítja a periodikus reconnect-guard-ot. A visszaadott függvény leállítja (teszt/teardown).
- * `.unref()` — nem tartja életben az event-loop-ot.
- */
-export declare function startMongoReconnectGuard(deps: MongoReconnectGuardDeps): () => void;
+/**
+ * DyNTS Mongo reconnect-guard (2026-06-20) — TÚLÉLI a Mongo-konténer IP-VÁLTÁSÁT.
+ *
+ * PROBLÉMA (élőben, 2026-06-19): a MongoDB-driver a hostnevet (`mongodb`) connect-kor EGYSZER
+ * resolválja és cache-eli az IP-t (pl. 172.18.0.20); standalone-nál disconnect után UGYANAZT az
+ * IP-t pingeli, NEM re-resolve-ol. Ha a Mongo-konténert recreate-elik (új docker-network IP), a
+ * driver örökre a HALOTT IP-n lóg → `connect ECONNREFUSED <oldIp>:29017` + `buffering timed out`,
+ * és a service magától SOHA nem áll vissza (csak külső restart-tal). Ez a 2026-06-19 incidens fél
+ * test-stacket levitt (auth/ftp/helocia/futdevpro/… mind a régi Mongo-IP-n ragadt).
+ *
+ * MEGOLDÁS: a guard figyeli a `mongoose.connection.readyState`-et; ha TARTÓSAN nem-connected
+ * (a driver saját reconnect-grace-e UTÁN is), **TELJES `disconnect()` + `connect()`-et** csinál
+ * → ÚJ MongoClient → ÚJ DNS-resolve → új IP → reconnect. Így minden DyNTS_App-service magától
+ * túléli a Mongo IP-váltását, KÜLSŐ beavatkozás nélkül. Best-effort, sose dob; csak konténer-IP-
+ * frissítés, NEM törli/írja az adatot.
+ *
+ * SAFE always-on: egy app újracsatlakozása a SAJÁT DB-jéhez korrekt, nem-destruktív viselkedés
+ * (nincs az infra-restart-érzékenység, ami a külső watchdog-oknál — FR-229/237). Csak akkor
+ * avatkozik be, ha readyState !== 1 a grace + cooldown letelte UTÁN is; healthy connection-t (===1)
+ * SOHA nem bánt.
+ *
+ * A döntés-mag (`shouldForceMongoReconnect`) PURE + unit-tesztelt; a futtató injektált dep-ekkel
+ * dolgozik (readyState-olvasás / reconnect / log) a tesztelhetőségért.
+ */
+/** A pure döntés inputja (minden numerikus → determinisztikus + tesztelhető). */
+export interface MongoReconnectState {
+    /** mongoose.connection.readyState: 0=disconnected, 1=connected, 2=connecting, 3=disconnecting. */
+    readyState: number;
+    /** Mióta (ms) nem-connected a readyState (0, ha épp connected). */
+    msSinceUnhealthy: number;
+    /** Grace: ennyi ideig hagyjuk a drivert SAJÁT magát visszahozni, mielőtt force-reconnectolnánk. */
+    unhealthyGraceMs: number;
+    /** Épp folyamatban van-e már egy force-reconnect (ne torlódjon). */
+    reconnectInFlight: boolean;
+    /** Mióta (ms) volt az utolsó force-reconnect (Infinity, ha még nem volt). */
+    msSinceLastReconnect: number;
+    /** Két force-reconnect közti minimum (anti-thrash). */
+    reconnectCooldownMs: number;
+}
+/** A pure döntés eredménye. */
+export interface MongoReconnectDecision {
+    reconnect: boolean;
+    reason: string;
+}
+/**
+ * PURE döntés: kell-e force-reconnect. Healthy (===1) / connecting (===2) / in-flight / grace-en
+ * vagy cooldown-on belül → NEM. Csak tartós nem-connected (disconnected/disconnecting) + grace és
+ * cooldown letelt + nincs in-flight → IGEN.
+ */
+export declare function shouldForceMongoReconnect(s: MongoReconnectState): MongoReconnectDecision;
+/** Injektált függőségek a futtatóhoz (best-effort; a futtató sose dob). */
+export interface MongoReconnectGuardDeps {
+    /** A jelenlegi `mongoose.connection.readyState`. */
+    getReadyState: () => number;
+    /**
+     * Force-reconnect: `disconnect()` majd `connect(uri, opts)` — ÚJ MongoClient → ÚJ DNS-resolve.
+     * Dobhat (a connect elbukhat, ha a Mongo épp tényleg down) — a futtató elkapja.
+     */
+    reconnect: () => Promise<void>;
+    /** Log. */
+    log: (msg: string) => void;
+    /** Tick-intervallum (ms). Default 10s. */
+    intervalMs?: number;
+    /** Grace, amíg a driver saját reconnect-jét várjuk (ms). Default 30s. */
+    unhealthyGraceMs?: number;
+    /** Cooldown két force-reconnect közt (ms). Default 20s. */
+    reconnectCooldownMs?: number;
+}
+/**
+ * Elindítja a periodikus reconnect-guard-ot. A visszaadott függvény leállítja (teszt/teardown).
+ * `.unref()` — nem tartja életben az event-loop-ot.
+ */
+export declare function startMongoReconnectGuard(deps: MongoReconnectGuardDeps): () => void;
 //# sourceMappingURL=mongo-reconnect-guard.util.d.ts.map