@futdevpro/nts-dynamo 1.15.156 → 1.15.160

package/build/_models/interfaces/global-settings.interface.d.ts

@@ -1,266 +1,266 @@
-import { DyNTS_RouteSecurity } from '../../_enums/route-security.enum';
-import { DyNTS_SecurityHeaders_Settings } from './security-headers-settings.interface';
-import { DyNTS_AppVersionHeader_Settings } from './app-version-header-settings.interface';
-import { DyNTS_SocketSecurity } from '../../_modules/socket/_enums/socket-security.enum';
-import { DyNTS_GlobalLog_Settings } from './global-log-settings.interface';
-import { DyNTS_Environment_Settings } from './environment-settings.interface';
-/**
- *
- *
- * @param logRequestsContent only will log if the specific logRequest is also true
- *
- * @param logEventContent only will log if the specific socket event is also set to log
- *
- */
-export interface DyNTS_Global_Settings {
-    env_settings: DyNTS_Environment_Settings;
-    /**
-     * this will be used as the main baseUrl for the application,
-     * this is not required, but we suggest to use at least a '/api' as base route
-     */
-    baseUrl: string;
-    /**
-     * this sets the default security for routes
-     */
-    defaultRouteSecurity: DyNTS_RouteSecurity;
-    /**
-     * this sets the default security for sockets
-     */
-    defaultSocketSecurity: DyNTS_SocketSecurity;
-    /**
-     * this is the name of the system, this will be used for the server status
-     */
-    systemName?: string;
-    /**
-     * this is the short code name of the system, this will be used for the logs and errors
-     */
-    systemShortCodeName?: string;
-    /**
-     * this is the version of the system, this will be used for the logs and errors
-     */
-    systemVersion: string;
-    /**
-     * this setting will set if the default route should be created
-     */
-    dontCreateDefaultRoute?: boolean;
-    /**
-     *
-     */
-    autoResolveEndpointCirculationErrors: boolean;
-    /**
-     * this setting will set the compact error response mode for the system
-     */
-    compactErrorResponse: boolean;
-    /**
-     * this is the default page size for pagination
-     */
-    defaultPageSize: number;
-    /**
-     * this is the number of items to archive in the list, this will be used to archive the list
-     */
-    archiveListAfter: number;
-    /**
-     * this is the environment of the system
-     */
-    /**
-     * this setting will set which logs will be shown
-     */
-    log_settings: DyNTS_GlobalLog_Settings;
-    /**
-     * this setting will set the research issues mode for the system
-     */
-    autoResearchIssues: boolean;
-    /**
-     * this setting will set the bot settings
-     * (this will be set in the {@link DyNTS_Bot_Main_ControlService} constructor)
-     *
-     * {@link DyNTS_GlobalBot_Settings}
-     * default settings: {@link DyNTS_Bot_Global_Settings}
-     */
-    bot_settings: any;
-    /**
-     * this setting will set the openai settings
-     * (this will be set in the {@link DyNTS_OAI_LLMChat_ServiceBase} constructor)
-     *
-     * {@link DyNTS_OpenAI_Settings}
-     * default settings: {@link DyNTS_OAI_global_settings}
-     */
-    openAi_settings: any;
-    /**
-     * this setting will set the dias settings
-     * (this will be set in the {@link DyNTS_OAI_LLM_ServiceBase} constructor, if not set already)
-     * ({@link DyNTS_OAI_VectorDataService} is not using this, but its own settings)
-     *
-     * {@link DyNTS_DiAs_Global_Settings}
-     * default settings: {@link DyNTS_DiAs_Global_Settings}
-     */
-    dias_settings: any;
-    /**
-     * this setting will set the assistant settings
-     * (this will be set in the {@link DyNTS_Ass_ServiceBase} constructor)
-     *
-     * {@link DyNTS_Ass_Global_Settings}
-     * default settings: {@link DyNTS_Ass_global_settings}
-     */
-    assistant_settings?: any;
-    /**
-     * Auth-service beállítások.
-     *
-     * Ha `optional: true`, a framework NEM követeli meg az egyedi Auth Service-t:
-     * a {@link DyNTS_GlobalService.getAuthService} hiányzó service esetén `undefined`-ot
-     * ad vissza a `"Unique Authentication Service missing!"` hiba DOBÁSA HELYETT, és
-     * a startup-warn ('Authentication Service missing!') is elmarad. Public / no-auth
-     * szervereknek (pl. nyílt RAG/MCP backend), ahol nincs saját auth-réteg.
-     *
-     * Default: `{ optional: false }` — az auth-service kötelező (visszafelé kompatibilis,
-     * a régi viselkedés: hiányzó service → dobott hiba).
-     */
-    auth_settings?: {
-        /**
-         * Ha `true`, az Auth Service opcionális: `getAuthService()` NEM dob hiányzó
-         * service esetén, hanem `undefined`-ot ad vissza (a hívók optional-chaining-gel
-         * kezelik), és a startup 'Authentication Service missing!' warn is elmarad.
-         * Default: `false`.
-         */
-        optional?: boolean;
-    };
-    /**
-     * this setting will set the doc chunking settings
-     */
-    docChunking: {
-        maxChunkSize: number;
-        maxChunkCount: number;
-    };
-    /**
-     * this setting will set the messaging settings
-     * (this will be set in the {@link DyNTS_Msg_Main_ControlService} constructor)
-     *
-     * {@link DyNTS_Msg_Global_Settings}
-     * default settings: {@link DyNTS_Msg_global_settings}
-     */
-    messaging_settings?: any;
-    /**
-     * BFR-MASTERPROMPTER-011 / SEC-R2-8 — security response-header middleware. Ha enabled
-     * (default: true), a base App az open+secure Express-en a CORS-mount ELŐTT minden válaszra
-     * ráteszi a biztonsági headereket (x-powered-by removal + X-Frame-Options + nosniff +
-     * Referrer-Policy; HSTS auto-prod-gated; CSP opt-in). Lásd {@link DyNTS_SecurityHeaders_Settings}.
-     */
-    securityHeaders?: DyNTS_SecurityHeaders_Settings;
-    /**
-     * FR-292 — a deployolt app-verzio kiirasa minden valasz headerebe (X-App-Version), hogy
-     * a bongeszoben NYITVA HAGYOTT SPA eszrevegye, ha kozben ujabb kliens-build ment ki.
-     * Default: enabled. Lasd {@link DyNTS_AppVersionHeader_Settings}.
-     */
-    appVersionHeader?: DyNTS_AppVersionHeader_Settings;
-    /**
-     * FR-193 — bedrock OOM korai-figyelmeztető heap-watchdog ({@link DyNTS_MemoryGuard}).
-     * Ha `enabled`, a base `App` startup automatikusan feltelepíti. Periodikusan figyeli a
-     * heap-kihasználtságot, és a `--max-old-space-size` plafonhoz közeledve TARTÓS rekordot
-     * hagy az error-sinkbe (Errors-rendszer + Discord) — mielőtt a fatal OOM megölné a
-     * process-t. Default: enabled, 10s poll, warn 85% / crit 95%.
-     */
-    memoryGuard?: {
-        /** Bekapcsolja a heap-watchdogot (a base App startup feltelepíti). Default: true. */
-        enabled: boolean;
-        /** Poll-intervallum ms-ben. Default: 10000. */
-        pollIntervalMs?: number;
-        /** Warning küszöb a heap-plafon %-ában. Default: 85. */
-        heapWarningThreshold?: number;
-        /** Critical küszöb a heap-plafon %-ában. Default: 95. */
-        heapCriticalThreshold?: number;
-        /** A warning küszöb ALATTI margó %-ban a 'recovered'-hez (hiszterézis). Default: 10. */
-        recoveryMargin?: number;
-        /** Megőrzött események max száma (ring-buffer). Default: 100. */
-        maxHistoryCount?: number;
-        /**
-         * GC-hányad (GC-ben töltött idő / poll-ablak) küszöb a `warning`-hoz, a %-küszöb MELLETT. 0..1. Default: 0.40.
-         * A „Ineffective mark-compacts near heap limit" OOM gyakran a heap-% kritikus küszöb ALATT üt be (a GC thrash-el,
-         * `mutator utilization` lezuhan) — ezt a jelet a puszta % későn/sosem fogja. Ez a GC-jel a valódi OOM-precursor.
-         */
-        gcWarningFraction?: number;
-        /** GC-hányad küszöb a `critical`-hoz (load-shed + graceful-exit zóna). 0..1. Default: 0.60. */
-        gcCriticalFraction?: number;
-        /**
-         * Process-szintű crash-handler (`uncaughtException`) telepítése — a crash ELŐTT TELJES-RÉSZLETŰ error-entry
-         * (message + stack + kód + issuer + memória-snapshot) az error-sinkbe, majd tiszta exit. Default: true.
-         * (Az `unhandledRejection`-t a base App már rögzíti; ez az eddig néma `uncaughtException`-t fedi le.)
-         */
-        installCrashHandlers?: boolean;
-        /**
-         * Tartós `critical` (a megadott poll-számon át, GC-vel sem csökkenő) esetén TISZTA kilépés → a wrapper/
-         * restart-policy PREDIKTÍVEN újraindít, a kriptikus fatal OOM (exit 134) helyett. Default: false
-         * (konténer-restart-policy-ra bízva; standalone/`serve`-wrapper-es app opt-in-olja).
-         */
-        exitOnSustainedCritical?: boolean;
-        /** Hány EGYMÁST KÖVETŐ `critical` poll után lépjen ki (`exitOnSustainedCritical`-hez). Default: 3. */
-        sustainedCriticalPolls?: number;
-        /** A graceful-exit kódja (a wrapper ezt látja restart-jelnek). Default: 137. */
-        exitCode?: number;
-        /**
-         * **Auto-load-shed middleware** (BFR-OVERSEER-009 maradék): ha true, a base App egy korai
-         * middleware-t mountol, ami CRITICAL memória-nyomásnál (`shouldShedLoad()`) az új, nem-esszenciális
-         * kéréseket gyors **503**-mal ejti — a GC levegőhöz jut, a death-spiral megelőzhető. Default: false
-         * (opt-in — a 503-viselkedés ops-döntés; a `shouldShedLoad()` primitív enélkül is hívható kézzel).
-         */
-        loadShedEnabled?: boolean;
-        /**
-         * Path-részek, amikre a load-shed SOSEM vonatkozik (`req.path.includes(part)` match) — az
-         * esszenciális útvonalak (healthcheck/readiness/diag) 503-a ÖNGÓL lenne (a restart-policy
-         * health-probe-ját ölné meg). Default: `['/health', '/readiness', '/status', '/diag']`.
-         */
-        loadShedExemptPathParts?: string[];
-        /**
-         * **Boot-grace ms** az `exitOnSustainedCritical`-hez: a guard-install UTÁNI első ennyi ms-ben a sustained-critical
-         * NEM lép ki (csak logol + load-shed). A nehéz-boot appok (nagy in-memory pool-hidratálás) ELEVE GC-thrash-elnek a
-         * boot alatt → e nélkül a sustained-exit boot-loop-ot okozna. A grace UTÁN a tartós critical normálisan kilép (a
-         * VALÓDI futásidejű OOM-ot kezeli). Default: 60000 (60s). 0 → nincs grace (azonnal élesedik).
-         */
-        bootGraceMs?: number;
-    };
-    /**
-     * Event-loop-lag + connection diagnosztika (BFR-OVERSEER-007) — a „process él, HTTP néma" wedge
-     * belső mérése (`perf_hooks.monitorEventLoopDelay` natív histogram + aktív-handle count, ring-buffer).
-     * A `GET /server/diag` endpoint innen olvas. A MemoryGuard MELLÉ illeszkedik (memória ↔ loop-lag).
-     */
-    eventLoopDiag?: {
-        /** Bekapcsolja a diag-mérést (a base App startup telepíti). Default: true (a mérés olcsó). */
-        enabled: boolean;
-        /** Mintavételi intervallum ms-ben. Default: 5000. */
-        pollIntervalMs?: number;
-        /** Megőrzött minták max száma (ring-buffer; 120 × 5s = 10 perc). Default: 120. */
-        maxHistoryCount?: number;
-    };
-    /**
-     * FR-258 / SR-4 — proactive collection-growth monitor (companion to {@link memoryGuard}). Samples
-     * each registered collection's document count (scan-free `estimatedDocumentCount`) on a slow
-     * cadence and raises a warning 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).
-     */
-    collectionGrowthMonitor?: {
-        /** Bekapcsolja a monitort (a base App startup feltelepíti). Default: true. */
-        enabled: boolean;
-        /** Poll-intervallum ms-ben. Default: 300000 (5 min). */
-        pollIntervalMs?: number;
-        /** Warning, ha egy collection doc-száma ezt meghaladja. Default: 250000. */
-        sizeThresholdDocCount?: number;
-        /** Warning, ha egy collection az előző poll óta ennél többel nőtt (%). Default: 50. */
-        growthRateThresholdPct?: number;
-        /** Re-alert cooldown collection-önként + alert-típusonként, ms (anti-flood). Default: 3600000 (1 h). */
-        reAlertCooldownMs?: number;
-    };
-    /**
-     * BFR-MASTERPROMPTER-015 (MP-19) — test-email SINK. Ha a környezet local/test ÉS a címzett(ek)
-     * a teszt-cím-mintára matchelnek, a `DyNTS_EmailService.sendEmail` a küldést SMTP helyett a
-     * `dynts_sent_test_mails` kollekcióba teríti (olvasás: `DyNTS_getSentMailRoutingModule`).
-     * Prod/dev környezetben a sink HARD-gate-elt: `enabled: true` sem kapcsolja be (fail-closed).
-     */
-    testEmailSink?: {
-        /** Kikapcsolás local/test-en (default: aktív local/test-en). Prod-on hatástalan. */
-        enabled?: boolean;
-        /** Cím-minta override (default: `DyNTS_testEmailPattern` = *@e2e.test.futdevpro.local). */
-        pattern?: RegExp;
-        /** A sink-elt emailek TTL-je órában (default: 24). */
-        ttlHours?: number;
-    };
-}
+import { DyNTS_RouteSecurity } from '../../_enums/route-security.enum';
+import { DyNTS_SecurityHeaders_Settings } from './security-headers-settings.interface';
+import { DyNTS_AppVersionHeader_Settings } from './app-version-header-settings.interface';
+import { DyNTS_SocketSecurity } from '../../_modules/socket/_enums/socket-security.enum';
+import { DyNTS_GlobalLog_Settings } from './global-log-settings.interface';
+import { DyNTS_Environment_Settings } from './environment-settings.interface';
+/**
+ *
+ *
+ * @param logRequestsContent only will log if the specific logRequest is also true
+ *
+ * @param logEventContent only will log if the specific socket event is also set to log
+ *
+ */
+export interface DyNTS_Global_Settings {
+    env_settings: DyNTS_Environment_Settings;
+    /**
+     * this will be used as the main baseUrl for the application,
+     * this is not required, but we suggest to use at least a '/api' as base route
+     */
+    baseUrl: string;
+    /**
+     * this sets the default security for routes
+     */
+    defaultRouteSecurity: DyNTS_RouteSecurity;
+    /**
+     * this sets the default security for sockets
+     */
+    defaultSocketSecurity: DyNTS_SocketSecurity;
+    /**
+     * this is the name of the system, this will be used for the server status
+     */
+    systemName?: string;
+    /**
+     * this is the short code name of the system, this will be used for the logs and errors
+     */
+    systemShortCodeName?: string;
+    /**
+     * this is the version of the system, this will be used for the logs and errors
+     */
+    systemVersion: string;
+    /**
+     * this setting will set if the default route should be created
+     */
+    dontCreateDefaultRoute?: boolean;
+    /**
+     *
+     */
+    autoResolveEndpointCirculationErrors: boolean;
+    /**
+     * this setting will set the compact error response mode for the system
+     */
+    compactErrorResponse: boolean;
+    /**
+     * this is the default page size for pagination
+     */
+    defaultPageSize: number;
+    /**
+     * this is the number of items to archive in the list, this will be used to archive the list
+     */
+    archiveListAfter: number;
+    /**
+     * this is the environment of the system
+     */
+    /**
+     * this setting will set which logs will be shown
+     */
+    log_settings: DyNTS_GlobalLog_Settings;
+    /**
+     * this setting will set the research issues mode for the system
+     */
+    autoResearchIssues: boolean;
+    /**
+     * this setting will set the bot settings
+     * (this will be set in the {@link DyNTS_Bot_Main_ControlService} constructor)
+     *
+     * {@link DyNTS_GlobalBot_Settings}
+     * default settings: {@link DyNTS_Bot_Global_Settings}
+     */
+    bot_settings: any;
+    /**
+     * this setting will set the openai settings
+     * (this will be set in the {@link DyNTS_OAI_LLMChat_ServiceBase} constructor)
+     *
+     * {@link DyNTS_OpenAI_Settings}
+     * default settings: {@link DyNTS_OAI_global_settings}
+     */
+    openAi_settings: any;
+    /**
+     * this setting will set the dias settings
+     * (this will be set in the {@link DyNTS_OAI_LLM_ServiceBase} constructor, if not set already)
+     * ({@link DyNTS_OAI_VectorDataService} is not using this, but its own settings)
+     *
+     * {@link DyNTS_DiAs_Global_Settings}
+     * default settings: {@link DyNTS_DiAs_Global_Settings}
+     */
+    dias_settings: any;
+    /**
+     * this setting will set the assistant settings
+     * (this will be set in the {@link DyNTS_Ass_ServiceBase} constructor)
+     *
+     * {@link DyNTS_Ass_Global_Settings}
+     * default settings: {@link DyNTS_Ass_global_settings}
+     */
+    assistant_settings?: any;
+    /**
+     * Auth-service beállítások.
+     *
+     * Ha `optional: true`, a framework NEM követeli meg az egyedi Auth Service-t:
+     * a {@link DyNTS_GlobalService.getAuthService} hiányzó service esetén `undefined`-ot
+     * ad vissza a `"Unique Authentication Service missing!"` hiba DOBÁSA HELYETT, és
+     * a startup-warn ('Authentication Service missing!') is elmarad. Public / no-auth
+     * szervereknek (pl. nyílt RAG/MCP backend), ahol nincs saját auth-réteg.
+     *
+     * Default: `{ optional: false }` — az auth-service kötelező (visszafelé kompatibilis,
+     * a régi viselkedés: hiányzó service → dobott hiba).
+     */
+    auth_settings?: {
+        /**
+         * Ha `true`, az Auth Service opcionális: `getAuthService()` NEM dob hiányzó
+         * service esetén, hanem `undefined`-ot ad vissza (a hívók optional-chaining-gel
+         * kezelik), és a startup 'Authentication Service missing!' warn is elmarad.
+         * Default: `false`.
+         */
+        optional?: boolean;
+    };
+    /**
+     * this setting will set the doc chunking settings
+     */
+    docChunking: {
+        maxChunkSize: number;
+        maxChunkCount: number;
+    };
+    /**
+     * this setting will set the messaging settings
+     * (this will be set in the {@link DyNTS_Msg_Main_ControlService} constructor)
+     *
+     * {@link DyNTS_Msg_Global_Settings}
+     * default settings: {@link DyNTS_Msg_global_settings}
+     */
+    messaging_settings?: any;
+    /**
+     * BFR-MASTERPROMPTER-011 / SEC-R2-8 — security response-header middleware. Ha enabled
+     * (default: true), a base App az open+secure Express-en a CORS-mount ELŐTT minden válaszra
+     * ráteszi a biztonsági headereket (x-powered-by removal + X-Frame-Options + nosniff +
+     * Referrer-Policy; HSTS auto-prod-gated; CSP opt-in). Lásd {@link DyNTS_SecurityHeaders_Settings}.
+     */
+    securityHeaders?: DyNTS_SecurityHeaders_Settings;
+    /**
+     * FR-292 — a deployolt app-verzio kiirasa minden valasz headerebe (X-App-Version), hogy
+     * a bongeszoben NYITVA HAGYOTT SPA eszrevegye, ha kozben ujabb kliens-build ment ki.
+     * Default: enabled. Lasd {@link DyNTS_AppVersionHeader_Settings}.
+     */
+    appVersionHeader?: DyNTS_AppVersionHeader_Settings;
+    /**
+     * FR-193 — bedrock OOM korai-figyelmeztető heap-watchdog ({@link DyNTS_MemoryGuard}).
+     * Ha `enabled`, a base `App` startup automatikusan feltelepíti. Periodikusan figyeli a
+     * heap-kihasználtságot, és a `--max-old-space-size` plafonhoz közeledve TARTÓS rekordot
+     * hagy az error-sinkbe (Errors-rendszer + Discord) — mielőtt a fatal OOM megölné a
+     * process-t. Default: enabled, 10s poll, warn 85% / crit 95%.
+     */
+    memoryGuard?: {
+        /** Bekapcsolja a heap-watchdogot (a base App startup feltelepíti). Default: true. */
+        enabled: boolean;
+        /** Poll-intervallum ms-ben. Default: 10000. */
+        pollIntervalMs?: number;
+        /** Warning küszöb a heap-plafon %-ában. Default: 85. */
+        heapWarningThreshold?: number;
+        /** Critical küszöb a heap-plafon %-ában. Default: 95. */
+        heapCriticalThreshold?: number;
+        /** A warning küszöb ALATTI margó %-ban a 'recovered'-hez (hiszterézis). Default: 10. */
+        recoveryMargin?: number;
+        /** Megőrzött események max száma (ring-buffer). Default: 100. */
+        maxHistoryCount?: number;
+        /**
+         * GC-hányad (GC-ben töltött idő / poll-ablak) küszöb a `warning`-hoz, a %-küszöb MELLETT. 0..1. Default: 0.40.
+         * A „Ineffective mark-compacts near heap limit" OOM gyakran a heap-% kritikus küszöb ALATT üt be (a GC thrash-el,
+         * `mutator utilization` lezuhan) — ezt a jelet a puszta % későn/sosem fogja. Ez a GC-jel a valódi OOM-precursor.
+         */
+        gcWarningFraction?: number;
+        /** GC-hányad küszöb a `critical`-hoz (load-shed + graceful-exit zóna). 0..1. Default: 0.60. */
+        gcCriticalFraction?: number;
+        /**
+         * Process-szintű crash-handler (`uncaughtException`) telepítése — a crash ELŐTT TELJES-RÉSZLETŰ error-entry
+         * (message + stack + kód + issuer + memória-snapshot) az error-sinkbe, majd tiszta exit. Default: true.
+         * (Az `unhandledRejection`-t a base App már rögzíti; ez az eddig néma `uncaughtException`-t fedi le.)
+         */
+        installCrashHandlers?: boolean;
+        /**
+         * Tartós `critical` (a megadott poll-számon át, GC-vel sem csökkenő) esetén TISZTA kilépés → a wrapper/
+         * restart-policy PREDIKTÍVEN újraindít, a kriptikus fatal OOM (exit 134) helyett. Default: false
+         * (konténer-restart-policy-ra bízva; standalone/`serve`-wrapper-es app opt-in-olja).
+         */
+        exitOnSustainedCritical?: boolean;
+        /** Hány EGYMÁST KÖVETŐ `critical` poll után lépjen ki (`exitOnSustainedCritical`-hez). Default: 3. */
+        sustainedCriticalPolls?: number;
+        /** A graceful-exit kódja (a wrapper ezt látja restart-jelnek). Default: 137. */
+        exitCode?: number;
+        /**
+         * **Auto-load-shed middleware** (BFR-OVERSEER-009 maradék): ha true, a base App egy korai
+         * middleware-t mountol, ami CRITICAL memória-nyomásnál (`shouldShedLoad()`) az új, nem-esszenciális
+         * kéréseket gyors **503**-mal ejti — a GC levegőhöz jut, a death-spiral megelőzhető. Default: false
+         * (opt-in — a 503-viselkedés ops-döntés; a `shouldShedLoad()` primitív enélkül is hívható kézzel).
+         */
+        loadShedEnabled?: boolean;
+        /**
+         * Path-részek, amikre a load-shed SOSEM vonatkozik (`req.path.includes(part)` match) — az
+         * esszenciális útvonalak (healthcheck/readiness/diag) 503-a ÖNGÓL lenne (a restart-policy
+         * health-probe-ját ölné meg). Default: `['/health', '/readiness', '/status', '/diag']`.
+         */
+        loadShedExemptPathParts?: string[];
+        /**
+         * **Boot-grace ms** az `exitOnSustainedCritical`-hez: a guard-install UTÁNI első ennyi ms-ben a sustained-critical
+         * NEM lép ki (csak logol + load-shed). A nehéz-boot appok (nagy in-memory pool-hidratálás) ELEVE GC-thrash-elnek a
+         * boot alatt → e nélkül a sustained-exit boot-loop-ot okozna. A grace UTÁN a tartós critical normálisan kilép (a
+         * VALÓDI futásidejű OOM-ot kezeli). Default: 60000 (60s). 0 → nincs grace (azonnal élesedik).
+         */
+        bootGraceMs?: number;
+    };
+    /**
+     * Event-loop-lag + connection diagnosztika (BFR-OVERSEER-007) — a „process él, HTTP néma" wedge
+     * belső mérése (`perf_hooks.monitorEventLoopDelay` natív histogram + aktív-handle count, ring-buffer).
+     * A `GET /server/diag` endpoint innen olvas. A MemoryGuard MELLÉ illeszkedik (memória ↔ loop-lag).
+     */
+    eventLoopDiag?: {
+        /** Bekapcsolja a diag-mérést (a base App startup telepíti). Default: true (a mérés olcsó). */
+        enabled: boolean;
+        /** Mintavételi intervallum ms-ben. Default: 5000. */
+        pollIntervalMs?: number;
+        /** Megőrzött minták max száma (ring-buffer; 120 × 5s = 10 perc). Default: 120. */
+        maxHistoryCount?: number;
+    };
+    /**
+     * FR-258 / SR-4 — proactive collection-growth monitor (companion to {@link memoryGuard}). Samples
+     * each registered collection's document count (scan-free `estimatedDocumentCount`) on a slow
+     * cadence and raises a warning 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).
+     */
+    collectionGrowthMonitor?: {
+        /** Bekapcsolja a monitort (a base App startup feltelepíti). Default: true. */
+        enabled: boolean;
+        /** Poll-intervallum ms-ben. Default: 300000 (5 min). */
+        pollIntervalMs?: number;
+        /** Warning, ha egy collection doc-száma ezt meghaladja. Default: 250000. */
+        sizeThresholdDocCount?: number;
+        /** Warning, ha egy collection az előző poll óta ennél többel nőtt (%). Default: 50. */
+        growthRateThresholdPct?: number;
+        /** Re-alert cooldown collection-önként + alert-típusonként, ms (anti-flood). Default: 3600000 (1 h). */
+        reAlertCooldownMs?: number;
+    };
+    /**
+     * BFR-MASTERPROMPTER-015 (MP-19) — test-email SINK. Ha a környezet local/test ÉS a címzett(ek)
+     * a teszt-cím-mintára matchelnek, a `DyNTS_EmailService.sendEmail` a küldést SMTP helyett a
+     * `dynts_sent_test_mails` kollekcióba teríti (olvasás: `DyNTS_getSentMailRoutingModule`).
+     * Prod/dev környezetben a sink HARD-gate-elt: `enabled: true` sem kapcsolja be (fail-closed).
+     */
+    testEmailSink?: {
+        /** Kikapcsolás local/test-en (default: aktív local/test-en). Prod-on hatástalan. */
+        enabled?: boolean;
+        /** Cím-minta override (default: `DyNTS_testEmailPattern` = *@e2e.test.futdevpro.local). */
+        pattern?: RegExp;
+        /** A sink-elt emailek TTL-je órában (default: 24). */
+        ttlHours?: number;
+    };
+}
 //# sourceMappingURL=global-settings.interface.d.ts.map

package/build/_models/interfaces/global-settings.interface.js

@@ -1,3 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=global-settings.interface.js.map

package/build/_models/interfaces/migration-entry.interface.d.ts

@@ -1,20 +1,20 @@
-/**
- * Egy regisztrált deploy-integrált migráció leírója. Az app egy `DyNTS_MigrationEntry[]` registry-t
- * ad át a `DyNTS_Migration_Runner.runPending(...)`-nek; a runner a pending (még nem alkalmazott)
- * entry-ket **egyszer** futtatja le, sorrendben, majd a `DyNTS_SchemaMigration` ledgerbe rögzíti.
- */
-export interface DyNTS_MigrationEntry {
-    /** Egyedi, monoton bővíthető ID (konvenció: `YYYY-MM-DD-NNN-descriptor`). A ledger ez alapján run-once-ol. */
-    id: string;
-    /** Rövid leíró (admin/debug/log). */
-    description: string;
-    /**
-     * A tényleges migráció-logika. Az app már-csatlakozott Mongo-kapcsolatát használja (a runner a
-     * `postProcess`-ből fut, ahol a DB már él). Hibára DOBHAT — a runner catch-eli, a `notes`-ba menti,
-     * és NEM állítja meg a boot-ot. Visszaad: `{ touched }` (a módosított dokumentumok száma — count/riport).
-     */
-    run: (issuer: string) => Promise<{
-        touched: number;
-    }>;
-}
+/**
+ * Egy regisztrált deploy-integrált migráció leírója. Az app egy `DyNTS_MigrationEntry[]` registry-t
+ * ad át a `DyNTS_Migration_Runner.runPending(...)`-nek; a runner a pending (még nem alkalmazott)
+ * entry-ket **egyszer** futtatja le, sorrendben, majd a `DyNTS_SchemaMigration` ledgerbe rögzíti.
+ */
+export interface DyNTS_MigrationEntry {
+    /** Egyedi, monoton bővíthető ID (konvenció: `YYYY-MM-DD-NNN-descriptor`). A ledger ez alapján run-once-ol. */
+    id: string;
+    /** Rövid leíró (admin/debug/log). */
+    description: string;
+    /**
+     * A tényleges migráció-logika. Az app már-csatlakozott Mongo-kapcsolatát használja (a runner a
+     * `postProcess`-ből fut, ahol a DB már él). Hibára DOBHAT — a runner catch-eli, a `notes`-ba menti,
+     * és NEM állítja meg a boot-ot. Visszaad: `{ touched }` (a módosított dokumentumok száma — count/riport).
+     */
+    run: (issuer: string) => Promise<{
+        touched: number;
+    }>;
+}
 //# sourceMappingURL=migration-entry.interface.d.ts.map

package/build/_models/interfaces/migration-entry.interface.js

@@ -1,3 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=migration-entry.interface.js.map

package/build/_models/interfaces/mongo-transaction-settings.interface.d.ts

@@ -1,9 +1,9 @@
-import { ClientSession } from 'mongoose';
-/** One atomic Mongo transaction request with content-free diagnostic identity. */
-export interface DyNTS_MongoTransaction_Settings<T> {
-    transactionName: string;
-    issuer: string;
-    maxCommitTimeMs?: number;
-    task: (session: ClientSession) => Promise<T>;
-}
+import { ClientSession } from 'mongoose';
+/** One atomic Mongo transaction request with content-free diagnostic identity. */
+export interface DyNTS_MongoTransaction_Settings<T> {
+    transactionName: string;
+    issuer: string;
+    maxCommitTimeMs?: number;
+    task: (session: ClientSession) => Promise<T>;
+}
 //# sourceMappingURL=mongo-transaction-settings.interface.d.ts.map

package/build/_models/interfaces/mongo-transaction-settings.interface.js

@@ -1,3 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=mongo-transaction-settings.interface.js.map

package/build/_models/interfaces/request-telemetry-settings.interface.d.ts

@@ -0,0 +1,10 @@
+/** Opt-in, content-free request telemetry settings for one Dynamo application. */
+export interface DyNTS_RequestTelemetry_Settings {
+    /** Enables correlation headers and event-driven aggregate metrics. Default: false. */
+    enabled?: boolean;
+    /** Maximum distinct declared route templates retained before overflow aggregation. Default: 128. */
+    maxRouteCardinality?: number;
+    /** Inclusive duration bucket upper bounds in milliseconds. Default: 25, 100, 250, 1000, 5000. */
+    durationBucketUpperBoundsMs?: number[];
+}
+//# sourceMappingURL=request-telemetry-settings.interface.d.ts.map

package/build/_models/interfaces/request-telemetry-settings.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-telemetry-settings.interface.d.ts","sourceRoot":"","sources":["../../../src/_models/interfaces/request-telemetry-settings.interface.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,MAAM,WAAW,+BAA+B;IAC9C,sFAAsF;IACtF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oGAAoG;IACpG,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iGAAiG;IACjG,2BAA2B,CAAC,EAAE,MAAM,EAAE,CAAC;CACxC"}

package/build/_models/interfaces/request-telemetry-settings.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=request-telemetry-settings.interface.js.map

package/build/_models/interfaces/request-telemetry-settings.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-telemetry-settings.interface.js","sourceRoot":"","sources":["../../../src/_models/interfaces/request-telemetry-settings.interface.ts"],"names":[],"mappings":""}