@futdevpro/nts-dynamo 1.15.156 → 1.15.157

package/build/_services/core/event-loop-diag.service.d.ts

@@ -1,50 +1,50 @@
-/** Egy event-loop-lag mintavétel (a gördülő history eleme). */
-export interface DyNTS_EventLoopSample {
-    at: number;
-    /** p50 lag ms-ben (a poll-ablakban). */
-    p50Ms: number;
-    /** p95 lag ms-ben. */
-    p95Ms: number;
-    /** max lag ms-ben — a „process él, HTTP néma" wedge fő jele. */
-    maxMs: number;
-    /** Aktív handle-k száma (socket/timer/fd) — connection-leak jel. */
-    activeHandles: number;
-}
-/**
- * Event-loop-lag + connection diagnosztika (BFR-OVERSEER-007) — a „process él, de a HTTP néma"
- * jelenség (event-loop blokk / wedge) eddig LÁTHATATLAN volt: a MemoryGuard a heap-et figyeli,
- * a healthcheck kívülről néz — a loop-lag magát a tünetet méri, belülről.
- *
- * A `perf_hooks.monitorEventLoopDelay` NATÍV histogramjára épül (elhanyagolható overhead),
- * poll-onként mintát tesz egy ring-bufferbe; a `getSnapshot()` a `/server/diag` endpoint (és
- * bármely fogyasztó) számára adja vissza az aktuális + közelmúlt-képet. A MemoryGuard MELLÉ
- * illeszkedik (nem duplikálja): memória-nyomás = MemoryGuard.pressure(); loop-lag = ez.
- *
- * Install: a base App startup (a MemoryGuard-install mintájára), `eventLoopDiag.enabled` gate-tel
- * (default: true — a mérés olcsó; opt-out lehetséges).
- */
-export declare class DyNTS_EventLoopDiag {
-    /**
-     * E fölött a lag fölött írunk ki issue-hunter attribúciót (`[EL-STALL]`).
-     * 1000ms: egy másodperces loop-megállás már valódi tünet (a normál érték 20-50ms),
-     * de elég magas ahhoz, hogy a szokásos GC-tüskék ne spam-eljenek.
-     */
-    static readonly STALL_ATTRIBUTION_MS: number;
-    private static instance;
-    static getInstance(): DyNTS_EventLoopDiag;
-    private monitor;
-    private pollTimer;
-    private history;
-    private installed;
-    /** A diag-mérés telepítése (idempotens; a settings-gate itt érvényesül). */
-    install(): void;
-    /** A diag-pillanatkép — a `/server/diag` endpoint (és bármely fogyasztó) forrása. */
-    getSnapshot(): {
-        installed: boolean;
-        current: DyNTS_EventLoopSample | null;
-        history: DyNTS_EventLoopSample[];
-    };
-    /** Aktív handle-k száma — best-effort (a nem-publikus API hiányát 0-val toleráljuk). */
-    private getActiveHandleCount;
-}
+/** Egy event-loop-lag mintavétel (a gördülő history eleme). */
+export interface DyNTS_EventLoopSample {
+    at: number;
+    /** p50 lag ms-ben (a poll-ablakban). */
+    p50Ms: number;
+    /** p95 lag ms-ben. */
+    p95Ms: number;
+    /** max lag ms-ben — a „process él, HTTP néma" wedge fő jele. */
+    maxMs: number;
+    /** Aktív handle-k száma (socket/timer/fd) — connection-leak jel. */
+    activeHandles: number;
+}
+/**
+ * Event-loop-lag + connection diagnosztika (BFR-OVERSEER-007) — a „process él, de a HTTP néma"
+ * jelenség (event-loop blokk / wedge) eddig LÁTHATATLAN volt: a MemoryGuard a heap-et figyeli,
+ * a healthcheck kívülről néz — a loop-lag magát a tünetet méri, belülről.
+ *
+ * A `perf_hooks.monitorEventLoopDelay` NATÍV histogramjára épül (elhanyagolható overhead),
+ * poll-onként mintát tesz egy ring-bufferbe; a `getSnapshot()` a `/server/diag` endpoint (és
+ * bármely fogyasztó) számára adja vissza az aktuális + közelmúlt-képet. A MemoryGuard MELLÉ
+ * illeszkedik (nem duplikálja): memória-nyomás = MemoryGuard.pressure(); loop-lag = ez.
+ *
+ * Install: a base App startup (a MemoryGuard-install mintájára), `eventLoopDiag.enabled` gate-tel
+ * (default: true — a mérés olcsó; opt-out lehetséges).
+ */
+export declare class DyNTS_EventLoopDiag {
+    /**
+     * E fölött a lag fölött írunk ki issue-hunter attribúciót (`[EL-STALL]`).
+     * 1000ms: egy másodperces loop-megállás már valódi tünet (a normál érték 20-50ms),
+     * de elég magas ahhoz, hogy a szokásos GC-tüskék ne spam-eljenek.
+     */
+    static readonly STALL_ATTRIBUTION_MS: number;
+    private static instance;
+    static getInstance(): DyNTS_EventLoopDiag;
+    private monitor;
+    private pollTimer;
+    private history;
+    private installed;
+    /** A diag-mérés telepítése (idempotens; a settings-gate itt érvényesül). */
+    install(): void;
+    /** A diag-pillanatkép — a `/server/diag` endpoint (és bármely fogyasztó) forrása. */
+    getSnapshot(): {
+        installed: boolean;
+        current: DyNTS_EventLoopSample | null;
+        history: DyNTS_EventLoopSample[];
+    };
+    /** Aktív handle-k száma — best-effort (a nem-publikus API hiányát 0-val toleráljuk). */
+    private getActiveHandleCount;
+}
 //# sourceMappingURL=event-loop-diag.service.d.ts.map

package/build/_services/core/event-loop-diag.service.js

@@ -1,107 +1,107 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyNTS_EventLoopDiag = void 0;
-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 request_hunter_service_1 = require("./request-hunter.service");
-/**
- * Event-loop-lag + connection diagnosztika (BFR-OVERSEER-007) — a „process él, de a HTTP néma"
- * jelenség (event-loop blokk / wedge) eddig LÁTHATATLAN volt: a MemoryGuard a heap-et figyeli,
- * a healthcheck kívülről néz — a loop-lag magát a tünetet méri, belülről.
- *
- * A `perf_hooks.monitorEventLoopDelay` NATÍV histogramjára épül (elhanyagolható overhead),
- * poll-onként mintát tesz egy ring-bufferbe; a `getSnapshot()` a `/server/diag` endpoint (és
- * bármely fogyasztó) számára adja vissza az aktuális + közelmúlt-képet. A MemoryGuard MELLÉ
- * illeszkedik (nem duplikálja): memória-nyomás = MemoryGuard.pressure(); loop-lag = ez.
- *
- * Install: a base App startup (a MemoryGuard-install mintájára), `eventLoopDiag.enabled` gate-tel
- * (default: true — a mérés olcsó; opt-out lehetséges).
- */
-class DyNTS_EventLoopDiag {
-    /**
-     * E fölött a lag fölött írunk ki issue-hunter attribúciót (`[EL-STALL]`).
-     * 1000ms: egy másodperces loop-megállás már valódi tünet (a normál érték 20-50ms),
-     * de elég magas ahhoz, hogy a szokásos GC-tüskék ne spam-eljenek.
-     */
-    static STALL_ATTRIBUTION_MS = 1000;
-    static instance;
-    static getInstance() {
-        if (!DyNTS_EventLoopDiag.instance) {
-            DyNTS_EventLoopDiag.instance = new DyNTS_EventLoopDiag();
-        }
-        return DyNTS_EventLoopDiag.instance;
-    }
-    monitor = null;
-    pollTimer = null;
-    history = [];
-    installed = false;
-    /** A diag-mérés telepítése (idempotens; a settings-gate itt érvényesül). */
-    install() {
-        if (this.installed) {
-            return;
-        }
-        const settings = global_settings_const_1.DyNTS_global_settings.eventLoopDiag ?? {};
-        if (settings.enabled === false) {
-            return;
-        }
-        const pollIntervalMs = settings.pollIntervalMs ?? 5000;
-        const maxHistoryCount = settings.maxHistoryCount ?? 120;
-        // natív histogram — 10ms felbontás bőven elég a wedge-detektáláshoz (a jel: 100ms+ lag)
-        this.monitor = (0, perf_hooks_1.monitorEventLoopDelay)({ resolution: 10 });
-        this.monitor.enable();
-        this.pollTimer = setInterval(() => {
-            if (!this.monitor) {
-                return;
-            }
-            // a histogram ns-ben mér → ms-re váltunk; poll után reset (ablakonkénti kép)
-            const maxMs = Math.round(this.monitor.max / 1e6);
-            this.history.push({
-                at: Date.now(),
-                p50Ms: Math.round(this.monitor.percentile(50) / 1e6),
-                p95Ms: Math.round(this.monitor.percentile(95) / 1e6),
-                maxMs: maxMs,
-                activeHandles: this.getActiveHandleCount(),
-            });
-            this.monitor.reset();
-            // ISSUE-HUNTER ATTRIBÚCIÓ (2026-08-05) — a mérés eddig csak azt mondta meg, HOGY megállt
-            // a loop, azt NEM, hogy MITŐL. Stall esetén kiírjuk az ÉPPEN futó kéréseket.
-            //
-            // ⚠️ Fontos korlát, amit a szöveg is kimond: a fagyás ALATT ez a poll NEM fut, ezért ha a
-            // blokkoló kérés időközben befejeződött, az in-flight lista ÜRES lesz. Ezért a `describeInFlight()`
-            // ilyenkor expliciten a `[REQ-HUNTER] SLOW` sorokra irányít — az a FŐ jel, ez a másodlagos.
-            if (maxMs >= DyNTS_EventLoopDiag.STALL_ATTRIBUTION_MS) {
-                fsm_dynamo_1.DyFM_Log.warn(`[EL-STALL] event-loop megallas ${maxMs}ms — futo keresek: `
-                    + request_hunter_service_1.DyNTS_RequestHunter.getInstance().describeInFlight());
-            }
-            if (this.history.length > maxHistoryCount) {
-                this.history = this.history.slice(-maxHistoryCount);
-            }
-        }, pollIntervalMs);
-        // a poll-timer NE tartsa életben a processzt
-        this.pollTimer.unref?.();
-        this.installed = true;
-        fsm_dynamo_1.DyFM_Log.log(`Event-loop diag installed (poll: ${pollIntervalMs}ms, history: ${maxHistoryCount})`);
-    }
-    /** A diag-pillanatkép — a `/server/diag` endpoint (és bármely fogyasztó) forrása. */
-    getSnapshot() {
-        return {
-            installed: this.installed,
-            current: this.history.length ? this.history[this.history.length - 1] : null,
-            history: this.history,
-        };
-    }
-    /** Aktív handle-k száma — best-effort (a nem-publikus API hiányát 0-val toleráljuk). */
-    getActiveHandleCount() {
-        // a _getActiveHandles nem publikus API — best-effort diag-jel (connection/timer-leak trend)
-        const getHandles = process._getActiveHandles;
-        try {
-            return getHandles ? getHandles().length : 0;
-        }
-        catch {
-            return 0;
-        }
-    }
-}
-exports.DyNTS_EventLoopDiag = DyNTS_EventLoopDiag;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_EventLoopDiag = void 0;
+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 request_hunter_service_1 = require("./request-hunter.service");
+/**
+ * Event-loop-lag + connection diagnosztika (BFR-OVERSEER-007) — a „process él, de a HTTP néma"
+ * jelenség (event-loop blokk / wedge) eddig LÁTHATATLAN volt: a MemoryGuard a heap-et figyeli,
+ * a healthcheck kívülről néz — a loop-lag magát a tünetet méri, belülről.
+ *
+ * A `perf_hooks.monitorEventLoopDelay` NATÍV histogramjára épül (elhanyagolható overhead),
+ * poll-onként mintát tesz egy ring-bufferbe; a `getSnapshot()` a `/server/diag` endpoint (és
+ * bármely fogyasztó) számára adja vissza az aktuális + közelmúlt-képet. A MemoryGuard MELLÉ
+ * illeszkedik (nem duplikálja): memória-nyomás = MemoryGuard.pressure(); loop-lag = ez.
+ *
+ * Install: a base App startup (a MemoryGuard-install mintájára), `eventLoopDiag.enabled` gate-tel
+ * (default: true — a mérés olcsó; opt-out lehetséges).
+ */
+class DyNTS_EventLoopDiag {
+    /**
+     * E fölött a lag fölött írunk ki issue-hunter attribúciót (`[EL-STALL]`).
+     * 1000ms: egy másodperces loop-megállás már valódi tünet (a normál érték 20-50ms),
+     * de elég magas ahhoz, hogy a szokásos GC-tüskék ne spam-eljenek.
+     */
+    static STALL_ATTRIBUTION_MS = 1000;
+    static instance;
+    static getInstance() {
+        if (!DyNTS_EventLoopDiag.instance) {
+            DyNTS_EventLoopDiag.instance = new DyNTS_EventLoopDiag();
+        }
+        return DyNTS_EventLoopDiag.instance;
+    }
+    monitor = null;
+    pollTimer = null;
+    history = [];
+    installed = false;
+    /** A diag-mérés telepítése (idempotens; a settings-gate itt érvényesül). */
+    install() {
+        if (this.installed) {
+            return;
+        }
+        const settings = global_settings_const_1.DyNTS_global_settings.eventLoopDiag ?? {};
+        if (settings.enabled === false) {
+            return;
+        }
+        const pollIntervalMs = settings.pollIntervalMs ?? 5000;
+        const maxHistoryCount = settings.maxHistoryCount ?? 120;
+        // natív histogram — 10ms felbontás bőven elég a wedge-detektáláshoz (a jel: 100ms+ lag)
+        this.monitor = (0, perf_hooks_1.monitorEventLoopDelay)({ resolution: 10 });
+        this.monitor.enable();
+        this.pollTimer = setInterval(() => {
+            if (!this.monitor) {
+                return;
+            }
+            // a histogram ns-ben mér → ms-re váltunk; poll után reset (ablakonkénti kép)
+            const maxMs = Math.round(this.monitor.max / 1e6);
+            this.history.push({
+                at: Date.now(),
+                p50Ms: Math.round(this.monitor.percentile(50) / 1e6),
+                p95Ms: Math.round(this.monitor.percentile(95) / 1e6),
+                maxMs: maxMs,
+                activeHandles: this.getActiveHandleCount(),
+            });
+            this.monitor.reset();
+            // ISSUE-HUNTER ATTRIBÚCIÓ (2026-08-05) — a mérés eddig csak azt mondta meg, HOGY megállt
+            // a loop, azt NEM, hogy MITŐL. Stall esetén kiírjuk az ÉPPEN futó kéréseket.
+            //
+            // ⚠️ Fontos korlát, amit a szöveg is kimond: a fagyás ALATT ez a poll NEM fut, ezért ha a
+            // blokkoló kérés időközben befejeződött, az in-flight lista ÜRES lesz. Ezért a `describeInFlight()`
+            // ilyenkor expliciten a `[REQ-HUNTER] SLOW` sorokra irányít — az a FŐ jel, ez a másodlagos.
+            if (maxMs >= DyNTS_EventLoopDiag.STALL_ATTRIBUTION_MS) {
+                fsm_dynamo_1.DyFM_Log.warn(`[EL-STALL] event-loop megallas ${maxMs}ms — futo keresek: `
+                    + request_hunter_service_1.DyNTS_RequestHunter.getInstance().describeInFlight());
+            }
+            if (this.history.length > maxHistoryCount) {
+                this.history = this.history.slice(-maxHistoryCount);
+            }
+        }, pollIntervalMs);
+        // a poll-timer NE tartsa életben a processzt
+        this.pollTimer.unref?.();
+        this.installed = true;
+        fsm_dynamo_1.DyFM_Log.log(`Event-loop diag installed (poll: ${pollIntervalMs}ms, history: ${maxHistoryCount})`);
+    }
+    /** A diag-pillanatkép — a `/server/diag` endpoint (és bármely fogyasztó) forrása. */
+    getSnapshot() {
+        return {
+            installed: this.installed,
+            current: this.history.length ? this.history[this.history.length - 1] : null,
+            history: this.history,
+        };
+    }
+    /** Aktív handle-k száma — best-effort (a nem-publikus API hiányát 0-val toleráljuk). */
+    getActiveHandleCount() {
+        // a _getActiveHandles nem publikus API — best-effort diag-jel (connection/timer-leak trend)
+        const getHandles = process._getActiveHandles;
+        try {
+            return getHandles ? getHandles().length : 0;
+        }
+        catch {
+            return 0;
+        }
+    }
+}
+exports.DyNTS_EventLoopDiag = DyNTS_EventLoopDiag;
 //# sourceMappingURL=event-loop-diag.service.js.map

package/build/_services/core/global.service.d.ts

@@ -1,84 +1,84 @@
-import { DyFM_AnyError, DyFM_DataModel_Params, DyFM_Error_Settings, DyFM_Metadata } from '@futdevpro/fsm-dynamo';
-import { DyNTS_AuthService } from './auth.service';
-import { DyNTS_EmailService } from './email.service';
-import { DyNTS_Service_Collection } from './service-collection.service';
-import { DyNTS_DBService } from '../base/db.service';
-import { DyNTS_SingletonService } from '../base/singleton.service';
-import { DyNTS_App_Params } from '../../_models/control-models/app-params.control-model';
-import { DyNTS_GlobalErrorHandlerFn, DyNTS_GlobalService_Settings } from '../../_models/interfaces/global-service-settings.interface';
-/**
- * This is the main Global/Core Service Collection used by DynamoNTS,
- * you also can use this to access main services as
- * dbServices, emailServices, or authService
- */
-export declare class DyNTS_GlobalService extends DyNTS_SingletonService {
-    static getInstance(): DyNTS_GlobalService;
-    private static _params;
-    static get params(): DyNTS_App_Params;
-    private static readonly _upSince;
-    static get upSince(): Date;
-    static get upTime(): number;
-    /**
-     * FR-258 / SR-2 — enumerate every registered DB service (one per data-model, including the
-     * auto-created `_archived` siblings). Used by the DyNTS_App startup TTL-installer to find the
-     * models that declared `retention` and create their MongoDB TTL index. Returns an empty array
-     * if services aren't set up yet (safe to call early).
-     */
-    static getAllDBServices(): DyNTS_DBService<any>[];
-    authService: DyNTS_AuthService;
-    dbServiceCollection: DyNTS_Service_Collection<DyNTS_DBService<any>>;
-    emailServiceCollection: DyNTS_Service_Collection<DyNTS_EmailService>;
-    static readonly defaultErrorUserMsg: string;
-    static globalErrorHandler: DyNTS_GlobalErrorHandlerFn;
-    /**
-     * You need to setup global Services through this function
-     */
-    static setServices(set: DyNTS_GlobalService_Settings): Promise<void>;
-    private static setDBServices;
-    static createDBService(dbModel: DyFM_DataModel_Params<any>): void;
-    static unmountDBService(dbModel: DyFM_DataModel_Params<any>): void;
-    private static setAuthService;
-    private static setEmailServices;
-    private static setErrorHandler;
-    static setParams(params: DyNTS_App_Params): void;
-    /**
-     *
-     * @returns
-     */
-    static getAuthService(): DyNTS_AuthService;
-    /**
-     *
-     * @returns
-     */
-    static getDBServiceCollection(): DyNTS_Service_Collection<DyNTS_DBService<any>>;
-    /**
-     *
-     * @param dataParams
-     * @returns
-     */
-    static getDBService<T extends DyFM_Metadata>(dataParams: DyFM_DataModel_Params<T>): DyNTS_DBService<T>;
-    /**
-     *
-     * @param key
-     * @returns
-     */
-    static getDBServiceByKey<T extends DyFM_Metadata>(key: string): DyNTS_DBService<T>;
-    /**
-     *
-     * @returns
-     */
-    static getEmailServiceCollection(): DyNTS_Service_Collection<DyNTS_EmailService>;
-    /**
-     *
-     * @returns
-     */
-    /**
-     *
-     * @param name
-     * @returns
-     */
-    protected static getDefaultErrorSettings(fnName: string, error: DyFM_AnyError, issuer: string, 
-    /** @deprecated we wont support the separate user message in the future, use the message instead */
-    useMessageAsUserMessage?: boolean): DyFM_Error_Settings;
-}
+import { DyFM_AnyError, DyFM_DataModel_Params, DyFM_Error_Settings, DyFM_Metadata } from '@futdevpro/fsm-dynamo';
+import { DyNTS_AuthService } from './auth.service';
+import { DyNTS_EmailService } from './email.service';
+import { DyNTS_Service_Collection } from './service-collection.service';
+import { DyNTS_DBService } from '../base/db.service';
+import { DyNTS_SingletonService } from '../base/singleton.service';
+import { DyNTS_App_Params } from '../../_models/control-models/app-params.control-model';
+import { DyNTS_GlobalErrorHandlerFn, DyNTS_GlobalService_Settings } from '../../_models/interfaces/global-service-settings.interface';
+/**
+ * This is the main Global/Core Service Collection used by DynamoNTS,
+ * you also can use this to access main services as
+ * dbServices, emailServices, or authService
+ */
+export declare class DyNTS_GlobalService extends DyNTS_SingletonService {
+    static getInstance(): DyNTS_GlobalService;
+    private static _params;
+    static get params(): DyNTS_App_Params;
+    private static readonly _upSince;
+    static get upSince(): Date;
+    static get upTime(): number;
+    /**
+     * FR-258 / SR-2 — enumerate every registered DB service (one per data-model, including the
+     * auto-created `_archived` siblings). Used by the DyNTS_App startup TTL-installer to find the
+     * models that declared `retention` and create their MongoDB TTL index. Returns an empty array
+     * if services aren't set up yet (safe to call early).
+     */
+    static getAllDBServices(): DyNTS_DBService<any>[];
+    authService: DyNTS_AuthService;
+    dbServiceCollection: DyNTS_Service_Collection<DyNTS_DBService<any>>;
+    emailServiceCollection: DyNTS_Service_Collection<DyNTS_EmailService>;
+    static readonly defaultErrorUserMsg: string;
+    static globalErrorHandler: DyNTS_GlobalErrorHandlerFn;
+    /**
+     * You need to setup global Services through this function
+     */
+    static setServices(set: DyNTS_GlobalService_Settings): Promise<void>;
+    private static setDBServices;
+    static createDBService(dbModel: DyFM_DataModel_Params<any>): void;
+    static unmountDBService(dbModel: DyFM_DataModel_Params<any>): void;
+    private static setAuthService;
+    private static setEmailServices;
+    private static setErrorHandler;
+    static setParams(params: DyNTS_App_Params): void;
+    /**
+     *
+     * @returns
+     */
+    static getAuthService(): DyNTS_AuthService;
+    /**
+     *
+     * @returns
+     */
+    static getDBServiceCollection(): DyNTS_Service_Collection<DyNTS_DBService<any>>;
+    /**
+     *
+     * @param dataParams
+     * @returns
+     */
+    static getDBService<T extends DyFM_Metadata>(dataParams: DyFM_DataModel_Params<T>): DyNTS_DBService<T>;
+    /**
+     *
+     * @param key
+     * @returns
+     */
+    static getDBServiceByKey<T extends DyFM_Metadata>(key: string): DyNTS_DBService<T>;
+    /**
+     *
+     * @returns
+     */
+    static getEmailServiceCollection(): DyNTS_Service_Collection<DyNTS_EmailService>;
+    /**
+     *
+     * @returns
+     */
+    /**
+     *
+     * @param name
+     * @returns
+     */
+    protected static getDefaultErrorSettings(fnName: string, error: DyFM_AnyError, issuer: string, 
+    /** @deprecated we wont support the separate user message in the future, use the message instead */
+    useMessageAsUserMessage?: boolean): DyFM_Error_Settings;
+}
 //# sourceMappingURL=global.service.d.ts.map