@futdevpro/nts-dynamo 1.15.154 → 1.15.156

package/build/_services/core/request-hunter.service.js

@@ -1,123 +1,123 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyNTS_RequestHunter = void 0;
-const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
-const global_settings_const_1 = require("../../_collections/global-settings.const");
-/**
- * ISSUE-HUNTER: **melyik keres blokkolta az event-loopot?**
- *
- * ⚠️ MIERT KELLETT (mert incidens, overseer 2026-08-05): az event-loop 10-15 masodpercre
- * megallt (`DyNTS_EventLoopDiag`: elLag max 10058-14839 ms), a `MemoryGuard` es a healthcheck
- * ONMAGABAN egyiket sem tudta MIHEZ kotni. A diagnozis igy a nyers log 4893 sorabol tortent,
- * orak alatt — holott a dontő jel MINDOSSZE 4 sor volt benne. A hianyzo kepesseg nem a MERES
- * volt (az megvolt), hanem az ATTRIBUCIO: *mi futott, amikor megallt?*
- *
- * Ez a service ezt potolja, KET fuggetlen jellel:
- *
- *  1. **Lassu-keres onjelentes (a fo jel).** Amikor egy keres BEFEJEZODIK, ha tovabb tartott a
- *     kuszobnel, azonnal WARN-t ir a nevevel es az idejevel. A mai incidenst EZ egyetlen sorban
- *     megadta volna: `[REQ-HUNTER] SLOW getCdpReportDetails 10240ms`.
- *     ⚠️ Miert EZ a fo jel: a fagyas ALATT a diag-poll NEM fut (a loop all), tehat mire lefutna,
- *     a bunos keres mar befejezodott — az "in-flight pillanatkep" onmagaban ELKESNE.
- *
- *  2. **In-flight pillanatkep (a masodik jel).** Azokra az esetekre, amikor a keres MEG MINDIG
- *     fut (beragadt / vegtelen varakozas): a stall-detektor le tudja kerdezni, mi van eppen
- *     folyamatban es mennyi ideje.
- *
- * KOLTSEG: egy `Map`-beszuras + `Date.now()` keresenkent. Elhanyagolhato; ezert
- * alapertelmezetten BE van kapcsolva (a mai incidens tanulsaga: ami nincs bekapcsolva, az pont
- * az incidens alatt nem all rendelkezesre).
- *
- * Settings (`DyNTS_global_settings.requestHunter`):
- *   - `enabled?: boolean`        default true
- *   - `slowRequestMs?: number`   default 1000 — e felett WARN a keres vegen
- *   - `maxHistoryCount?: number` default 50 — a lassu-keres history merete
- */
-class DyNTS_RequestHunter {
-    static instance;
-    static getInstance() {
-        if (!DyNTS_RequestHunter.instance) {
-            DyNTS_RequestHunter.instance = new DyNTS_RequestHunter();
-        }
-        return DyNTS_RequestHunter.instance;
-    }
-    nextId = 1;
-    inFlight = new Map();
-    slowHistory = [];
-    /** A settings-ertekek feloldasa (minden hivasnal, hogy a runtime-valtoztatas is hasson). */
-    getSettings() {
-        const s = global_settings_const_1.DyNTS_global_settings.requestHunter ?? {};
-        return {
-            enabled: s.enabled !== false,
-            slowRequestMs: typeof s.slowRequestMs === 'number' && s.slowRequestMs > 0 ? s.slowRequestMs : 1000,
-            maxHistoryCount: typeof s.maxHistoryCount === 'number' && s.maxHistoryCount > 0 ? s.maxHistoryCount : 50,
-        };
-    }
-    /**
-     * Keres kezdete. A visszaadott id-t az `end()`-nek kell atadni.
-     *
-     * @returns a keres id-ja, vagy 0 ha a hunter ki van kapcsolva (az `end(0)` no-op)
-     */
-    begin(label) {
-        if (!this.getSettings().enabled) {
-            return 0;
-        }
-        const id = this.nextId++;
-        this.inFlight.set(id, { label: label, startedAt: Date.now() });
-        return id;
-    }
-    /**
-     * Keres vege. Ha a kuszobnel tovabb tartott, WARN + bekerul a history-ba.
-     * Hibatur: ismeretlen / 0 id eseten no-op.
-     */
-    end(id) {
-        if (!id) {
-            return;
-        }
-        const entry = this.inFlight.get(id);
-        if (!entry) {
-            return;
-        }
-        this.inFlight.delete(id);
-        const settings = this.getSettings();
-        const durationMs = Date.now() - entry.startedAt;
-        if (durationMs < settings.slowRequestMs) {
-            return;
-        }
-        this.slowHistory.push({ at: Date.now(), label: entry.label, durationMs: durationMs });
-        if (this.slowHistory.length > settings.maxHistoryCount) {
-            this.slowHistory = this.slowHistory.slice(-settings.maxHistoryCount);
-        }
-        fsm_dynamo_1.DyFM_Log.warn(`[REQ-HUNTER] SLOW ${entry.label} ${durationMs}ms`
-            + (this.inFlight.size ? ` (kozben ${this.inFlight.size} masik keres is futott)` : ''));
-    }
-    /** Az EPPEN futo keresek — a stall-detektor ebbol tudja, mi ragadt be. */
-    getInFlight(now = Date.now()) {
-        const out = [];
-        for (const entry of this.inFlight.values()) {
-            out.push({ label: entry.label, ageMs: now - entry.startedAt });
-        }
-        return out.sort((a, b) => b.ageMs - a.ageMs);
-    }
-    /** A kozelmult lassu keresei (gorgo history) — `/server/diag`-ba is kitehető. */
-    getSlowHistory() {
-        return [...this.slowHistory];
-    }
-    /**
-     * Ember-olvashato in-flight osszefoglalo a stall-loghoz.
-     * Ures listanal expliciten ezt mondja — mert az IS informacio: a blokkolo mar befejezodott,
-     * tehat a lassu-keres onjelentest (1. jel) kell nezni.
-     */
-    describeInFlight(now = Date.now()) {
-        const list = this.getInFlight(now);
-        if (!list.length) {
-            return 'nincs futo keres (a blokkolo mar befejezodott — lasd a [REQ-HUNTER] SLOW sorokat)';
-        }
-        return list
-            .slice(0, 5)
-            .map((r) => `${r.label} (${r.ageMs}ms)`)
-            .join(', ');
-    }
-}
-exports.DyNTS_RequestHunter = DyNTS_RequestHunter;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_RequestHunter = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const global_settings_const_1 = require("../../_collections/global-settings.const");
+/**
+ * ISSUE-HUNTER: **melyik keres blokkolta az event-loopot?**
+ *
+ * ⚠️ MIERT KELLETT (mert incidens, overseer 2026-08-05): az event-loop 10-15 masodpercre
+ * megallt (`DyNTS_EventLoopDiag`: elLag max 10058-14839 ms), a `MemoryGuard` es a healthcheck
+ * ONMAGABAN egyiket sem tudta MIHEZ kotni. A diagnozis igy a nyers log 4893 sorabol tortent,
+ * orak alatt — holott a dontő jel MINDOSSZE 4 sor volt benne. A hianyzo kepesseg nem a MERES
+ * volt (az megvolt), hanem az ATTRIBUCIO: *mi futott, amikor megallt?*
+ *
+ * Ez a service ezt potolja, KET fuggetlen jellel:
+ *
+ *  1. **Lassu-keres onjelentes (a fo jel).** Amikor egy keres BEFEJEZODIK, ha tovabb tartott a
+ *     kuszobnel, azonnal WARN-t ir a nevevel es az idejevel. A mai incidenst EZ egyetlen sorban
+ *     megadta volna: `[REQ-HUNTER] SLOW getCdpReportDetails 10240ms`.
+ *     ⚠️ Miert EZ a fo jel: a fagyas ALATT a diag-poll NEM fut (a loop all), tehat mire lefutna,
+ *     a bunos keres mar befejezodott — az "in-flight pillanatkep" onmagaban ELKESNE.
+ *
+ *  2. **In-flight pillanatkep (a masodik jel).** Azokra az esetekre, amikor a keres MEG MINDIG
+ *     fut (beragadt / vegtelen varakozas): a stall-detektor le tudja kerdezni, mi van eppen
+ *     folyamatban es mennyi ideje.
+ *
+ * KOLTSEG: egy `Map`-beszuras + `Date.now()` keresenkent. Elhanyagolhato; ezert
+ * alapertelmezetten BE van kapcsolva (a mai incidens tanulsaga: ami nincs bekapcsolva, az pont
+ * az incidens alatt nem all rendelkezesre).
+ *
+ * Settings (`DyNTS_global_settings.requestHunter`):
+ *   - `enabled?: boolean`        default true
+ *   - `slowRequestMs?: number`   default 1000 — e felett WARN a keres vegen
+ *   - `maxHistoryCount?: number` default 50 — a lassu-keres history merete
+ */
+class DyNTS_RequestHunter {
+    static instance;
+    static getInstance() {
+        if (!DyNTS_RequestHunter.instance) {
+            DyNTS_RequestHunter.instance = new DyNTS_RequestHunter();
+        }
+        return DyNTS_RequestHunter.instance;
+    }
+    nextId = 1;
+    inFlight = new Map();
+    slowHistory = [];
+    /** A settings-ertekek feloldasa (minden hivasnal, hogy a runtime-valtoztatas is hasson). */
+    getSettings() {
+        const s = global_settings_const_1.DyNTS_global_settings.requestHunter ?? {};
+        return {
+            enabled: s.enabled !== false,
+            slowRequestMs: typeof s.slowRequestMs === 'number' && s.slowRequestMs > 0 ? s.slowRequestMs : 1000,
+            maxHistoryCount: typeof s.maxHistoryCount === 'number' && s.maxHistoryCount > 0 ? s.maxHistoryCount : 50,
+        };
+    }
+    /**
+     * Keres kezdete. A visszaadott id-t az `end()`-nek kell atadni.
+     *
+     * @returns a keres id-ja, vagy 0 ha a hunter ki van kapcsolva (az `end(0)` no-op)
+     */
+    begin(label) {
+        if (!this.getSettings().enabled) {
+            return 0;
+        }
+        const id = this.nextId++;
+        this.inFlight.set(id, { label: label, startedAt: Date.now() });
+        return id;
+    }
+    /**
+     * Keres vege. Ha a kuszobnel tovabb tartott, WARN + bekerul a history-ba.
+     * Hibatur: ismeretlen / 0 id eseten no-op.
+     */
+    end(id) {
+        if (!id) {
+            return;
+        }
+        const entry = this.inFlight.get(id);
+        if (!entry) {
+            return;
+        }
+        this.inFlight.delete(id);
+        const settings = this.getSettings();
+        const durationMs = Date.now() - entry.startedAt;
+        if (durationMs < settings.slowRequestMs) {
+            return;
+        }
+        this.slowHistory.push({ at: Date.now(), label: entry.label, durationMs: durationMs });
+        if (this.slowHistory.length > settings.maxHistoryCount) {
+            this.slowHistory = this.slowHistory.slice(-settings.maxHistoryCount);
+        }
+        fsm_dynamo_1.DyFM_Log.warn(`[REQ-HUNTER] SLOW ${entry.label} ${durationMs}ms`
+            + (this.inFlight.size ? ` (kozben ${this.inFlight.size} masik keres is futott)` : ''));
+    }
+    /** Az EPPEN futo keresek — a stall-detektor ebbol tudja, mi ragadt be. */
+    getInFlight(now = Date.now()) {
+        const out = [];
+        for (const entry of this.inFlight.values()) {
+            out.push({ label: entry.label, ageMs: now - entry.startedAt });
+        }
+        return out.sort((a, b) => b.ageMs - a.ageMs);
+    }
+    /** A kozelmult lassu keresei (gorgo history) — `/server/diag`-ba is kitehető. */
+    getSlowHistory() {
+        return [...this.slowHistory];
+    }
+    /**
+     * Ember-olvashato in-flight osszefoglalo a stall-loghoz.
+     * Ures listanal expliciten ezt mondja — mert az IS informacio: a blokkolo mar befejezodott,
+     * tehat a lassu-keres onjelentest (1. jel) kell nezni.
+     */
+    describeInFlight(now = Date.now()) {
+        const list = this.getInFlight(now);
+        if (!list.length) {
+            return 'nincs futo keres (a blokkolo mar befejezodott — lasd a [REQ-HUNTER] SLOW sorokat)';
+        }
+        return list
+            .slice(0, 5)
+            .map((r) => `${r.label} (${r.ageMs}ms)`)
+            .join(', ');
+    }
+}
+exports.DyNTS_RequestHunter = DyNTS_RequestHunter;
 //# sourceMappingURL=request-hunter.service.js.map

package/build/_services/core/service-collection.service.d.ts

@@ -1,5 +1,5 @@
-import { DyNTS_SingletonServiceBase } from '../base/singleton.service-base';
-export declare class DyNTS_Service_Collection<T> extends DyNTS_SingletonServiceBase {
-    [service: string]: T;
-}
+import { DyNTS_SingletonServiceBase } from '../base/singleton.service-base';
+export declare class DyNTS_Service_Collection<T> extends DyNTS_SingletonServiceBase {
+    [service: string]: T;
+}
 //# sourceMappingURL=service-collection.service.d.ts.map

package/build/_services/core/service-collection.service.js

@@ -1,8 +1,8 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyNTS_Service_Collection = void 0;
-const singleton_service_base_1 = require("../base/singleton.service-base");
-class DyNTS_Service_Collection extends singleton_service_base_1.DyNTS_SingletonServiceBase {
-}
-exports.DyNTS_Service_Collection = DyNTS_Service_Collection;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_Service_Collection = void 0;
+const singleton_service_base_1 = require("../base/singleton.service-base");
+class DyNTS_Service_Collection extends singleton_service_base_1.DyNTS_SingletonServiceBase {
+}
+exports.DyNTS_Service_Collection = DyNTS_Service_Collection;
 //# sourceMappingURL=service-collection.service.js.map

package/build/_services/route/controller.service.d.ts

@@ -1,125 +1,125 @@
-import { DyNTS_Endpoint_Params } from '../../_models/control-models/endpoint-params.control-model';
-import { DyNTS_SingletonService } from '../base/singleton.service';
-/**
- * Basic controller for endpoint handlings
- *
- * (You'll need to add them to a {@link DyNTS_RoutingModule} through it's constructor)
- *
- * You can add default endpoints to the controller by using the {@link DyNTS_DefaultEndpoints_Util} utility class
- *
- * @example
- * this.endpoints = [
- *   ...DyNTS_DefaultEndpoints_Util.getAllDefaultEndpoints({
- *     entityName: 'UserMatchStatistics',
- *     dataServiceClass: UserMatchStatistics_DataService,
- *     endpoints: {
- *       get: '/get/user-match-statistics/:userId',
- *       search: '/search/user-match-statistics',
- *       modify: '/modify/user-match-statistics',
- *       patch: '/patch/user-match-statistics/:userId',
- *       delete: '/delete/user-match-statistics/:userId',
- *     },
- *     authService: this.authService,
- *   }),
- * ];
- *
- * @example
- * export class UserMatchStatisticsController extends DyNTS_Controller {
- *
- * static getInstance(): UserMatchStatisticsController {
- *   return UserMatchStatisticsController.getSingletonInstance();
- * }
- *
- *   // SERVICES
- *   private authService: AuthService;
- *
- *   setupEndpoints(): void {
- *     this.authService = AuthService.getInstance();
- *
- *     this.endpoints = [
- *       new DyNTS_Endpoint_Params({
- *         name: 'getUserMatchStatistics',
- *         type: DyFM_HttpCallType.get,
- *         endpoint: '/get/user-match-statistics/:userId',
- *         preProcesses: [ this.authService.authenticate_tokenSelf ],
- *         tasks: [
- *           async (req: Request, res: Response) => {
- *             const userMatchStatistics = new UserMatchStatisticsService({
- *               data: { userId: req.params.userId }
- *             });
- *
- *             await userMatchStatistics.getDataByDependencyId();
- *
- *             res.send(
- *               userMatchStatistics.data
- *             );
- *           }
- *         ]
- *       }),
- *     ];
- *   }
- * }
- */
-export declare abstract class DyNTS_Controller extends DyNTS_SingletonService {
-    /**
-     * setup this in the setupEndpoints(), which will be called on the construcion
-     *
-     * @example
-     *
-     * this.endpoints = [
-     *   new DyNTS_Endpoint_Params({
-     *     name: 'getUserMatchStatistics',
-     *     type: DyFM_HttpCallType.get,
-     *     endpoint: '/get/user-match-statistics/:userId',
-     *     preProcesses: [ this.authService.authenticate_tokenSelf ],
-     *     tasks: [
-     *       async (req: Request, res: Response) => {
-     *         const userMatchStatistics = new UserMatchStatisticsService({
-     *           data: { userId: req.params.userId }
-     *         });
-     *
-     *         await userMatchStatistics.getDataByDependencyId();
-     *
-     *         res.send(
-     *           userMatchStatistics.data
-     *         );
-     *       }
-     *     ]
-     *   }),
-     * ];
-     */
-    endpoints: DyNTS_Endpoint_Params[];
-    /**
-     * You must setup endpoints and required services in this function
-     *
-     * @example
-     *
-     * setupEndpoints(): void {
-     *   this.authService = AuthService.getInstance();
-     *
-     *   this.endpoints = [
-     *     new DyNTS_Endpoint_Params({
-     *       name: 'getUserMatchStatistics',
-     *       type: DyFM_HttpCallType.get,
-     *       endpoint: '/get/user-match-statistics/:userId',
-     *       preProcesses: [ this.authService.authenticate_tokenSelf ],
-     *       tasks: [
-     *         async (req: Request, res: Response) => {
-     *           const userMatchStatistics = new UserMatchStatisticsService({
-     *             data: { userId: req.params.userId }
-     *           });
-     *
-     *           await userMatchStatistics.getDataByDependencyId();
-     *
-     *           res.send(
-     *             userMatchStatistics.data
-     *           );
-     *         }
-     *       ]
-     *     }),
-     *   ];
-     * }
-     */
-    abstract setupEndpoints(): void;
-}
+import { DyNTS_Endpoint_Params } from '../../_models/control-models/endpoint-params.control-model';
+import { DyNTS_SingletonService } from '../base/singleton.service';
+/**
+ * Basic controller for endpoint handlings
+ *
+ * (You'll need to add them to a {@link DyNTS_RoutingModule} through it's constructor)
+ *
+ * You can add default endpoints to the controller by using the {@link DyNTS_DefaultEndpoints_Util} utility class
+ *
+ * @example
+ * this.endpoints = [
+ *   ...DyNTS_DefaultEndpoints_Util.getAllDefaultEndpoints({
+ *     entityName: 'UserMatchStatistics',
+ *     dataServiceClass: UserMatchStatistics_DataService,
+ *     endpoints: {
+ *       get: '/get/user-match-statistics/:userId',
+ *       search: '/search/user-match-statistics',
+ *       modify: '/modify/user-match-statistics',
+ *       patch: '/patch/user-match-statistics/:userId',
+ *       delete: '/delete/user-match-statistics/:userId',
+ *     },
+ *     authService: this.authService,
+ *   }),
+ * ];
+ *
+ * @example
+ * export class UserMatchStatisticsController extends DyNTS_Controller {
+ *
+ * static getInstance(): UserMatchStatisticsController {
+ *   return UserMatchStatisticsController.getSingletonInstance();
+ * }
+ *
+ *   // SERVICES
+ *   private authService: AuthService;
+ *
+ *   setupEndpoints(): void {
+ *     this.authService = AuthService.getInstance();
+ *
+ *     this.endpoints = [
+ *       new DyNTS_Endpoint_Params({
+ *         name: 'getUserMatchStatistics',
+ *         type: DyFM_HttpCallType.get,
+ *         endpoint: '/get/user-match-statistics/:userId',
+ *         preProcesses: [ this.authService.authenticate_tokenSelf ],
+ *         tasks: [
+ *           async (req: Request, res: Response) => {
+ *             const userMatchStatistics = new UserMatchStatisticsService({
+ *               data: { userId: req.params.userId }
+ *             });
+ *
+ *             await userMatchStatistics.getDataByDependencyId();
+ *
+ *             res.send(
+ *               userMatchStatistics.data
+ *             );
+ *           }
+ *         ]
+ *       }),
+ *     ];
+ *   }
+ * }
+ */
+export declare abstract class DyNTS_Controller extends DyNTS_SingletonService {
+    /**
+     * setup this in the setupEndpoints(), which will be called on the construcion
+     *
+     * @example
+     *
+     * this.endpoints = [
+     *   new DyNTS_Endpoint_Params({
+     *     name: 'getUserMatchStatistics',
+     *     type: DyFM_HttpCallType.get,
+     *     endpoint: '/get/user-match-statistics/:userId',
+     *     preProcesses: [ this.authService.authenticate_tokenSelf ],
+     *     tasks: [
+     *       async (req: Request, res: Response) => {
+     *         const userMatchStatistics = new UserMatchStatisticsService({
+     *           data: { userId: req.params.userId }
+     *         });
+     *
+     *         await userMatchStatistics.getDataByDependencyId();
+     *
+     *         res.send(
+     *           userMatchStatistics.data
+     *         );
+     *       }
+     *     ]
+     *   }),
+     * ];
+     */
+    endpoints: DyNTS_Endpoint_Params[];
+    /**
+     * You must setup endpoints and required services in this function
+     *
+     * @example
+     *
+     * setupEndpoints(): void {
+     *   this.authService = AuthService.getInstance();
+     *
+     *   this.endpoints = [
+     *     new DyNTS_Endpoint_Params({
+     *       name: 'getUserMatchStatistics',
+     *       type: DyFM_HttpCallType.get,
+     *       endpoint: '/get/user-match-statistics/:userId',
+     *       preProcesses: [ this.authService.authenticate_tokenSelf ],
+     *       tasks: [
+     *         async (req: Request, res: Response) => {
+     *           const userMatchStatistics = new UserMatchStatisticsService({
+     *             data: { userId: req.params.userId }
+     *           });
+     *
+     *           await userMatchStatistics.getDataByDependencyId();
+     *
+     *           res.send(
+     *             userMatchStatistics.data
+     *           );
+     *         }
+     *       ]
+     *     }),
+     *   ];
+     * }
+     */
+    abstract setupEndpoints(): void;
+}
 //# sourceMappingURL=controller.service.d.ts.map