@futdevpro/nts-dynamo 1.15.55 → 1.15.57

package/src/_models/interfaces/global-log-settings.interface.ts

@@ -1,171 +1,171 @@
-
-import { Request, Response } from 'express';
-
-export interface DyNTS_GlobalLog_Settings {
-  /**
-   * this setting will set which logs will be shown
-   */
-  highDetailedLogs?: boolean;
-
-  deep?: boolean;
-
-  /**
-   * this setting will enable debug logs for setting up the application
-   */
-  setup?: boolean;
-
-  /**
-   * this setting will enable debug logs for setting up the database
-   */
-  dbSetup?: boolean;
-
-  /**
-   * this is an application wide default setting for route debug logs
-   */
-  request?: boolean;
-
-  /**
-   * this is an application wide default setting for route debug logs
-   */
-  requestsParams?: boolean;
-
-  /**
-   * this is an application wide default setting for route debug logs
-   */
-  requestsContent?: boolean;
-
-  /**
-   * this is an application wide default setting for route debug logs
-   */
-  responseContent?: boolean;
-
-  /**
-   * this is an application wide default setting for route debug logs
-   */
-  requestStackLocation?: boolean;
-  
-
-  /**
-   * this is an application wide default setting for socket debug logs
-   */
-  socket_allEvents?: boolean;
-
-  /**
-   * this is an application wide default setting for socket debug logs
-   */
-  socket_mainEvents?: boolean;
-
-  /**
-   * this is an application wide default setting for socket debug logs
-   */
-  socket_eventContent?: boolean;
-
-
-  /**
-   * this is an application wide default setting for api debug logs
-   */
-  api_events?: boolean;
-
-  /**
-   * this is an application wide default setting for api debug logs
-   */
-  api_requestContents?: boolean;
-
-  /**
-   * this is an application wide default setting for api debug logs
-   */
-  api_requestSettings?: boolean;
-
-  /**
-   * this is an application wide default setting for api debug logs
-   */
-  api_responseContents?: boolean;
-
-  /**
-   * this is an application wide default setting for api debug logs
-   */
-  api_errors?: boolean;
-
-
-  /**
-   * this is an application wide default setting for detailed error logs
-   */
-  detailedErrors?: boolean;
-
-  server_debug?: boolean;
-
-  functions?: boolean;
-
-  /**
-   * Logs endpoint konfiguracio.
-   * Ha enabled: true, a DyNTS_getLogsRoutingModule() hozzaadja a /logs endpoint-ot.
-   * A log buffer in-memory ring buffer-kent mukodik (maxEntries sor).
-   */
-  logs_endpoint?: {
-    /** Engedelyezve van-e a /logs endpoint. Default: false. */
-    enabled: boolean;
-    /** Max sorok szama a bufferben. Default: 2000. */
-    maxEntries?: number;
-    /**
-     * Engedelyezi-e a szerver-bootstrap automatikus, env-tudatos /logs
-     * mount-jat. Default: true.
-     *
-     * - TEST env: a `DYNTS_ADMIN_API_KEY` env var-os admin-key auth-tal mount-ol
-     *   (ha a kulcs nincs beallitva → skip + warn).
-     * - PROD env: csak akkor mount-ol, ha a `prodAuthPreProcess` (FDP RBAC) be
-     *   van allitva (kulonben skip + warn — SOHA nem mount-ol vedetlenul prod-on).
-     *
-     * Ha false → a bootstrap nem mount-ol semmit (az app sajat kezuleg
-     * regisztralhatja a DyNTS_getLogsRoutingModule()-t).
-     *
-     * Megj.: a tenyleges auto-mount WIRING a logs-endpoint-auto-mount feature-ben
-     * landol; ez itt a TIPUS-deklaracio (additive), hogy a consumer-ek (FDP
-     * Templates NTS logs-RBAC) tudjak allitani a `prodAuthPreProcess`-t.
-     */
-    autoMount?: boolean;
-    /**
-     * PROD env-en hasznalt auth pre-process (FDP RBAC). A bootstrap auto-mount
-     * EZT hasznalja prod-on; ha nincs beallitva, prod-on NEM mount-ol.
-     *
-     * Tipusa megegyezik a DyNTS_getLogsRoutingModule({ authPreProcess })
-     * altal varttal (DyNTS_LogsController_Config.authPreProcess).
-     */
-    prodAuthPreProcess?: (req: Request, res: Response) => Promise<void>;
-  };
-
-  /**
-   * File-based log kiiras konfiguracio (DyNTS_FileLog_Service).
-   *
-   * Az in-memory ring buffer (DyNTS_Logs_Service) mellett mukodik — NEM
-   * helyette. A szerver stdout/stderr kimeneteket egy per-session log
-   * fajlba duplikalja (`{logDir}/{filenamePrefix}YYYY-MM-DD_HH-MM-SS.log`).
-   *
-   * Rotation: ha az aktiv fajl meghaladja a `maxFileSizeMb`-t, uj fajl jon
-   * letre. Retention: az `install()` + minden rotation utan a
-   * `maxFiles`-nel regebbi vagy a `retentionDays`-nel idosebb fajlok
-   * torlodnek (ami elobb teljesul).
-   *
-   * Hasznalat:
-   *   DyNTS_FileLog_Service.getInstance().install();  // szerver startup
-   */
-  file_log?: {
-    /** Engedelyezve van-e a file-based logolás. Default: false. */
-    enabled: boolean;
-    /** Log mappa abszolut vagy relativ path-ja. Default: './logs/server'. */
-    logDir?: string;
-    /** Per-session fajlnev prefix. Default: 'server-'. */
-    filenamePrefix?: string;
-    /** Rotation trigger MB-ban. Default: 50. */
-    maxFileSizeMb?: number;
-    /** Retention by count — max ennyi log fajl marad meg. Default: 10. */
-    maxFiles?: number;
-    /** Retention by age — ennyi napnal regebbi fajl torlodik. Default: 30. */
-    retentionDays?: number;
-    /** ANSI escape kodok strippelese a fajl-irasnal. Default: true. */
-    stripAnsi?: boolean;
-    /** stdout interceptalasa. Default: true. */
-    includeStdout?: boolean;
-    /** stderr interceptalasa. Default: true. */
-    includeStderr?: boolean;
-  };
-}
+
+import { Request, Response } from 'express';
+
+export interface DyNTS_GlobalLog_Settings {
+  /**
+   * this setting will set which logs will be shown
+   */
+  highDetailedLogs?: boolean;
+
+  deep?: boolean;
+
+  /**
+   * this setting will enable debug logs for setting up the application
+   */
+  setup?: boolean;
+
+  /**
+   * this setting will enable debug logs for setting up the database
+   */
+  dbSetup?: boolean;
+
+  /**
+   * this is an application wide default setting for route debug logs
+   */
+  request?: boolean;
+
+  /**
+   * this is an application wide default setting for route debug logs
+   */
+  requestsParams?: boolean;
+
+  /**
+   * this is an application wide default setting for route debug logs
+   */
+  requestsContent?: boolean;
+
+  /**
+   * this is an application wide default setting for route debug logs
+   */
+  responseContent?: boolean;
+
+  /**
+   * this is an application wide default setting for route debug logs
+   */
+  requestStackLocation?: boolean;
+  
+
+  /**
+   * this is an application wide default setting for socket debug logs
+   */
+  socket_allEvents?: boolean;
+
+  /**
+   * this is an application wide default setting for socket debug logs
+   */
+  socket_mainEvents?: boolean;
+
+  /**
+   * this is an application wide default setting for socket debug logs
+   */
+  socket_eventContent?: boolean;
+
+
+  /**
+   * this is an application wide default setting for api debug logs
+   */
+  api_events?: boolean;
+
+  /**
+   * this is an application wide default setting for api debug logs
+   */
+  api_requestContents?: boolean;
+
+  /**
+   * this is an application wide default setting for api debug logs
+   */
+  api_requestSettings?: boolean;
+
+  /**
+   * this is an application wide default setting for api debug logs
+   */
+  api_responseContents?: boolean;
+
+  /**
+   * this is an application wide default setting for api debug logs
+   */
+  api_errors?: boolean;
+
+
+  /**
+   * this is an application wide default setting for detailed error logs
+   */
+  detailedErrors?: boolean;
+
+  server_debug?: boolean;
+
+  functions?: boolean;
+
+  /**
+   * Logs endpoint konfiguracio.
+   * Ha enabled: true, a DyNTS_getLogsRoutingModule() hozzaadja a /logs endpoint-ot.
+   * A log buffer in-memory ring buffer-kent mukodik (maxEntries sor).
+   */
+  logs_endpoint?: {
+    /** Engedelyezve van-e a /logs endpoint. Default: false. */
+    enabled: boolean;
+    /** Max sorok szama a bufferben. Default: 2000. */
+    maxEntries?: number;
+    /**
+     * Engedelyezi-e a szerver-bootstrap automatikus, env-tudatos /logs
+     * mount-jat. Default: true.
+     *
+     * - TEST env: a `DYNTS_ADMIN_API_KEY` env var-os admin-key auth-tal mount-ol
+     *   (ha a kulcs nincs beallitva → skip + warn).
+     * - PROD env: csak akkor mount-ol, ha a `prodAuthPreProcess` (FDP RBAC) be
+     *   van allitva (kulonben skip + warn — SOHA nem mount-ol vedetlenul prod-on).
+     *
+     * Ha false → a bootstrap nem mount-ol semmit (az app sajat kezuleg
+     * regisztralhatja a DyNTS_getLogsRoutingModule()-t).
+     *
+     * Megj.: a tenyleges auto-mount WIRING a logs-endpoint-auto-mount feature-ben
+     * landol; ez itt a TIPUS-deklaracio (additive), hogy a consumer-ek (FDP
+     * Templates NTS logs-RBAC) tudjak allitani a `prodAuthPreProcess`-t.
+     */
+    autoMount?: boolean;
+    /**
+     * PROD env-en hasznalt auth pre-process (FDP RBAC). A bootstrap auto-mount
+     * EZT hasznalja prod-on; ha nincs beallitva, prod-on NEM mount-ol.
+     *
+     * Tipusa megegyezik a DyNTS_getLogsRoutingModule({ authPreProcess })
+     * altal varttal (DyNTS_LogsController_Config.authPreProcess).
+     */
+    prodAuthPreProcess?: (req: Request, res: Response) => Promise<void>;
+  };
+
+  /**
+   * File-based log kiiras konfiguracio (DyNTS_FileLog_Service).
+   *
+   * Az in-memory ring buffer (DyNTS_Logs_Service) mellett mukodik — NEM
+   * helyette. A szerver stdout/stderr kimeneteket egy per-session log
+   * fajlba duplikalja (`{logDir}/{filenamePrefix}YYYY-MM-DD_HH-MM-SS.log`).
+   *
+   * Rotation: ha az aktiv fajl meghaladja a `maxFileSizeMb`-t, uj fajl jon
+   * letre. Retention: az `install()` + minden rotation utan a
+   * `maxFiles`-nel regebbi vagy a `retentionDays`-nel idosebb fajlok
+   * torlodnek (ami elobb teljesul).
+   *
+   * Hasznalat:
+   *   DyNTS_FileLog_Service.getInstance().install();  // szerver startup
+   */
+  file_log?: {
+    /** Engedelyezve van-e a file-based logolás. Default: false. */
+    enabled: boolean;
+    /** Log mappa abszolut vagy relativ path-ja. Default: './logs/server'. */
+    logDir?: string;
+    /** Per-session fajlnev prefix. Default: 'server-'. */
+    filenamePrefix?: string;
+    /** Rotation trigger MB-ban. Default: 50. */
+    maxFileSizeMb?: number;
+    /** Retention by count — max ennyi log fajl marad meg. Default: 10. */
+    maxFiles?: number;
+    /** Retention by age — ennyi napnal regebbi fajl torlodik. Default: 30. */
+    retentionDays?: number;
+    /** ANSI escape kodok strippelese a fajl-irasnal. Default: true. */
+    stripAnsi?: boolean;
+    /** stdout interceptalasa. Default: true. */
+    includeStdout?: boolean;
+    /** stderr interceptalasa. Default: true. */
+    includeStderr?: boolean;
+  };
+}

package/src/_models/interfaces/global-service-settings.interface.ts

@@ -1,47 +1,47 @@
-
-
-
-
-import { Request, Response } from 'express';
-
-import { DyFM_DataModel_Params } from '@futdevpro/fsm-dynamo';
-
-import { DyNTS_AuthService } from '../../_services/core/auth.service';
-import { DyNTS_EmailService } from '../../_services/core/email.service';
-import { DyNTS_Service_Collection } from '../../_services/core/service-collection.service';
-
-
-export interface DyNTS_GlobalService_Settings {
-  /**
-   * You need to setup your Own Auth Service extending the DyNTS_AuthService class
-   */
-  authService?: DyNTS_AuthService,
-
-  /**
-   * You can setup your Own Email Service extending the DyNTS_EmailServiceCollection class
-   */
-  emailServiceCollection?: DyNTS_Service_Collection<DyNTS_EmailService>,
-
-  /**
-   * you can setup data tables by passing a DyFM_DataModel_Params list at this point 
-   */
-  dbModels?: DyFM_DataModel_Params<any>[],
-
-  /**
-   * you can setup other services by passing a DyNTS_SingletonService list at this point
-   */
-  /* simpleServicesCollection?: DyNTS_SimpleServiceCollection, */
-
-  /**
-   * you can setup socket services by passing a DyNTS_SocketServiceCollection list at this point
-   */
-  /* socketServiceCollection?: DyNTS_SocketServiceCollection, */
-
-  /**
-   * you can setup global error handler by passing a function at this point
-   */
-  errorHandler?: DyNTS_GlobalErrorHandlerFn,
-}
-
-export type DyNTS_GlobalErrorHandlerFn = 
-  (err: any, req?: Request, res?: Response, issuer?: string) => Promise<void>;
+
+
+
+
+import { Request, Response } from 'express';
+
+import { DyFM_DataModel_Params } from '@futdevpro/fsm-dynamo';
+
+import { DyNTS_AuthService } from '../../_services/core/auth.service';
+import { DyNTS_EmailService } from '../../_services/core/email.service';
+import { DyNTS_Service_Collection } from '../../_services/core/service-collection.service';
+
+
+export interface DyNTS_GlobalService_Settings {
+  /**
+   * You need to setup your Own Auth Service extending the DyNTS_AuthService class
+   */
+  authService?: DyNTS_AuthService,
+
+  /**
+   * You can setup your Own Email Service extending the DyNTS_EmailServiceCollection class
+   */
+  emailServiceCollection?: DyNTS_Service_Collection<DyNTS_EmailService>,
+
+  /**
+   * you can setup data tables by passing a DyFM_DataModel_Params list at this point 
+   */
+  dbModels?: DyFM_DataModel_Params<any>[],
+
+  /**
+   * you can setup other services by passing a DyNTS_SingletonService list at this point
+   */
+  /* simpleServicesCollection?: DyNTS_SimpleServiceCollection, */
+
+  /**
+   * you can setup socket services by passing a DyNTS_SocketServiceCollection list at this point
+   */
+  /* socketServiceCollection?: DyNTS_SocketServiceCollection, */
+
+  /**
+   * you can setup global error handler by passing a function at this point
+   */
+  errorHandler?: DyNTS_GlobalErrorHandlerFn,
+}
+
+export type DyNTS_GlobalErrorHandlerFn = 
+  (err: any, req?: Request, res?: Response, issuer?: string) => Promise<void>;

package/src/_models/interfaces/global-settings.interface.ts

@@ -133,9 +133,31 @@ export interface DyNTS_Global_Settings {
   /**
    * 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;
+
+  /**
+   * 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;
+  };
 }

package/src/_models/interfaces/routing-module-settings.interface.ts

@@ -1,21 +1,21 @@
-import { DyNTS_RouteSecurity } from '../../_enums/route-security.enum';
-import { DyNTS_Controller } from '../../_services/route/controller.service';
-
-
-/**
- * This is a main route point handler, which collects a list of controllers for the API
- */
-export interface DyNTS_RoutingModule_Settings {
-  /**
-   * main route of the module
-   */
-  route: string;
-  /**
-   * the collection of controllers (sub-routes, with differentlogical parts, to different db elements)
-   */
-  controllers: DyNTS_Controller[];
-  /**
-   * securityOverride will be used to create different security for a single module without changing the default security (http/https/both)
-   */
-  securityOverride?: DyNTS_RouteSecurity;
-}
+import { DyNTS_RouteSecurity } from '../../_enums/route-security.enum';
+import { DyNTS_Controller } from '../../_services/route/controller.service';
+
+
+/**
+ * This is a main route point handler, which collects a list of controllers for the API
+ */
+export interface DyNTS_RoutingModule_Settings {
+  /**
+   * main route of the module
+   */
+  route: string;
+  /**
+   * the collection of controllers (sub-routes, with differentlogical parts, to different db elements)
+   */
+  controllers: DyNTS_Controller[];
+  /**
+   * securityOverride will be used to create different security for a single module without changing the default security (http/https/both)
+   */
+  securityOverride?: DyNTS_RouteSecurity;
+}

package/src/_models/interfaces/static-client-settings.interface.spec.ts

@@ -1,29 +1,29 @@
-import { DyNTS_StaticClient_Settings } from './static-client-settings.interface';
-
-describe('| DyNTS_StaticClient_Settings', () => {
-  it('| should allow minimal settings with only root', () => {
-    const s: DyNTS_StaticClient_Settings = { root: '/dist' };
-    expect(s.root).toBe('/dist');
-    expect(s.fallbackPath).toBeUndefined();
-  });
-
-  it('| should allow optional fallbackPath', () => {
-    const s: DyNTS_StaticClient_Settings = {
-      root: '/dist',
-      fallbackPath: 'index.html',
-    };
-    expect(s.fallbackPath).toBe('index.html');
-  });
-
-  it('| should allow SPA cache options', () => {
-    const s: DyNTS_StaticClient_Settings = {
-      root: '/dist',
-      assetCacheMaxAge: 31536000,
-      assetCacheImmutable: true,
-      fallbackCacheMaxAge: 0,
-    };
-    expect(s.assetCacheMaxAge).toBe(31536000);
-    expect(s.assetCacheImmutable).toBe(true);
-    expect(s.fallbackCacheMaxAge).toBe(0);
-  });
-});
+import { DyNTS_StaticClient_Settings } from './static-client-settings.interface';
+
+describe('| DyNTS_StaticClient_Settings', () => {
+  it('| should allow minimal settings with only root', () => {
+    const s: DyNTS_StaticClient_Settings = { root: '/dist' };
+    expect(s.root).toBe('/dist');
+    expect(s.fallbackPath).toBeUndefined();
+  });
+
+  it('| should allow optional fallbackPath', () => {
+    const s: DyNTS_StaticClient_Settings = {
+      root: '/dist',
+      fallbackPath: 'index.html',
+    };
+    expect(s.fallbackPath).toBe('index.html');
+  });
+
+  it('| should allow SPA cache options', () => {
+    const s: DyNTS_StaticClient_Settings = {
+      root: '/dist',
+      assetCacheMaxAge: 31536000,
+      assetCacheImmutable: true,
+      fallbackCacheMaxAge: 0,
+    };
+    expect(s.assetCacheMaxAge).toBe(31536000);
+    expect(s.assetCacheImmutable).toBe(true);
+    expect(s.fallbackCacheMaxAge).toBe(0);
+  });
+});

package/src/_models/interfaces/static-client-settings.interface.ts

@@ -1,28 +1,28 @@
-/**
- * Beállítások a client static fájlok kiszolgálásához (pl. SPA) a '/' path alatt.
- * Ha megadva, a getStaticClientSettings() által visszaadott értéket a base app
- * a mountStaticClient() során használja (API route-ok után).
- * A cache mezők SPA (pl. Angular) optimalizáláshoz opcionálisak; ha nincs kitöltve,
- * viselkedés változatlan (alkalmas nem-SPA kiszolgálásra is).
- */
-export interface DyNTS_StaticClient_Settings {
-  /** A static fájlok könyvtárának path-ja (abszolút vagy process.cwd()-hez képest). */
-  root: string;
-  /** SPA fallback: ha a kérés nem egy fájlra mutat, ezt a fájlt szolgáljuk ki (pl. 'index.html'). */
-  fallbackPath?: string;
-  /**
-   * Static asset-ek (pl. JS, CSS) Cache-Control max-age másodpercben.
-   * SPA (Angular) hashed fájloknál pl. 1 év (31536000).
-   */
-  assetCacheMaxAge?: number;
-  /**
-   * Ha true és assetCacheMaxAge is megadva, Cache-Control-hoz hozzáadódik az immutable direktíva
-   * (Angular hashed fájlokra ideális).
-   */
-  assetCacheImmutable?: boolean;
-  /**
-   * Fallback (pl. index.html) Cache-Control max-age másodpercben.
-   * SPA esetén ajánlott 0, hogy a böngésző ne cache-elje az index.html-t (deploy után friss).
-   */
-  fallbackCacheMaxAge?: number;
-}
+/**
+ * Beállítások a client static fájlok kiszolgálásához (pl. SPA) a '/' path alatt.
+ * Ha megadva, a getStaticClientSettings() által visszaadott értéket a base app
+ * a mountStaticClient() során használja (API route-ok után).
+ * A cache mezők SPA (pl. Angular) optimalizáláshoz opcionálisak; ha nincs kitöltve,
+ * viselkedés változatlan (alkalmas nem-SPA kiszolgálásra is).
+ */
+export interface DyNTS_StaticClient_Settings {
+  /** A static fájlok könyvtárának path-ja (abszolút vagy process.cwd()-hez képest). */
+  root: string;
+  /** SPA fallback: ha a kérés nem egy fájlra mutat, ezt a fájlt szolgáljuk ki (pl. 'index.html'). */
+  fallbackPath?: string;
+  /**
+   * Static asset-ek (pl. JS, CSS) Cache-Control max-age másodpercben.
+   * SPA (Angular) hashed fájloknál pl. 1 év (31536000).
+   */
+  assetCacheMaxAge?: number;
+  /**
+   * Ha true és assetCacheMaxAge is megadva, Cache-Control-hoz hozzáadódik az immutable direktíva
+   * (Angular hashed fájlokra ideális).
+   */
+  assetCacheImmutable?: boolean;
+  /**
+   * Fallback (pl. index.html) Cache-Control max-age másodpercben.
+   * SPA esetén ajánlott 0, hogy a böngésző ne cache-elje az index.html-t (deploy után friss).
+   */
+  fallbackCacheMaxAge?: number;
+}