@futdevpro/nts-dynamo 1.15.151 → 1.15.153

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

@@ -1,56 +1,56 @@
-/**
- * CORS configuration for a DyNTS app's Express instance.
- *
- * Per FR-041 (subdomain-per-service architecture): each app whitelists which
- * client origins may call its API. The allowlist is per-environment (test list
- * differs from prod list). Without an explicit override, no CORS headers are
- * emitted (back-compat: existing apps without CORS keep their same-origin
- * behavior intact).
- *
- * Mounted by `DyNTS_AppServer.mountCors(express)` after BodyParser middleware,
- * before route mounting. Echoes a matching `Access-Control-Allow-Origin` (NOT
- * wildcard) because credentials (`Access-Control-Allow-Credentials: true`) is
- * required for the Bearer JWT cross-domain auth flow.
- */
-export interface DyNTS_Cors_Settings {
-  /**
-   * Allowed origins. Three forms accepted:
-   * - Explicit array of full origin URLs (`https://organizer.futdevpro.hu`).
-   * - Predicate function for regex/pattern matching (`(origin) => /\.futdevpro\.hu$/.test(origin)`).
-   * - `'*'` for wildcard — UNSAFE with `allowCredentials: true`. Use only on test or
-   *   open public endpoints that do NOT carry credentials.
-   */
-  allowedOrigins: string[] | ((origin: string) => boolean) | '*';
-
-  /**
-   * Allow credentials (cookies, Authorization headers). Default: `true`.
-   * Required for the Bearer JWT flow used cross-domain (auth.futdevpro.hu →
-   * organizer.futdevpro.hu etc.).
-   */
-  allowCredentials?: boolean;
-
-  /**
-   * HTTP methods allowed cross-origin. Default:
-   * `['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'OPTIONS']`.
-   */
-  allowedMethods?: string[];
-
-  /**
-   * Request headers the browser may send cross-origin. Default:
-   * `['Authorization', 'Content-Type', 'X-Admin-Key', 'X-Requested-With']`.
-   * Add app-specific headers (e.g. `X-Trace-Id`) by passing the full extended list.
-   */
-  allowedHeaders?: string[];
-
-  /**
-   * Headers the browser may read from cross-origin responses (beyond the
-   * CORS-safelisted ones). Default: `['Content-Length', 'Content-Type']`.
-   */
-  exposedHeaders?: string[];
-
-  /**
-   * Preflight cache duration in seconds. Default: `86400` (24h) — minimizes
-   * OPTIONS request overhead.
-   */
-  maxAgeSeconds?: number;
-}
+/**
+ * CORS configuration for a DyNTS app's Express instance.
+ *
+ * Per FR-041 (subdomain-per-service architecture): each app whitelists which
+ * client origins may call its API. The allowlist is per-environment (test list
+ * differs from prod list). Without an explicit override, no CORS headers are
+ * emitted (back-compat: existing apps without CORS keep their same-origin
+ * behavior intact).
+ *
+ * Mounted by `DyNTS_AppServer.mountCors(express)` after BodyParser middleware,
+ * before route mounting. Echoes a matching `Access-Control-Allow-Origin` (NOT
+ * wildcard) because credentials (`Access-Control-Allow-Credentials: true`) is
+ * required for the Bearer JWT cross-domain auth flow.
+ */
+export interface DyNTS_Cors_Settings {
+  /**
+   * Allowed origins. Three forms accepted:
+   * - Explicit array of full origin URLs (`https://organizer.futdevpro.hu`).
+   * - Predicate function for regex/pattern matching (`(origin) => /\.futdevpro\.hu$/.test(origin)`).
+   * - `'*'` for wildcard — UNSAFE with `allowCredentials: true`. Use only on test or
+   *   open public endpoints that do NOT carry credentials.
+   */
+  allowedOrigins: string[] | ((origin: string) => boolean) | '*';
+
+  /**
+   * Allow credentials (cookies, Authorization headers). Default: `true`.
+   * Required for the Bearer JWT flow used cross-domain (auth.futdevpro.hu →
+   * organizer.futdevpro.hu etc.).
+   */
+  allowCredentials?: boolean;
+
+  /**
+   * HTTP methods allowed cross-origin. Default:
+   * `['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'OPTIONS']`.
+   */
+  allowedMethods?: string[];
+
+  /**
+   * Request headers the browser may send cross-origin. Default:
+   * `['Authorization', 'Content-Type', 'X-Admin-Key', 'X-Requested-With']`.
+   * Add app-specific headers (e.g. `X-Trace-Id`) by passing the full extended list.
+   */
+  allowedHeaders?: string[];
+
+  /**
+   * Headers the browser may read from cross-origin responses (beyond the
+   * CORS-safelisted ones). Default: `['Content-Length', 'Content-Type']`.
+   */
+  exposedHeaders?: string[];
+
+  /**
+   * Preflight cache duration in seconds. Default: `86400` (24h) — minimizes
+   * OPTIONS request overhead.
+   */
+  maxAgeSeconds?: number;
+}

package/src/_models/interfaces/db-query-options.interface.ts

@@ -1,33 +1,33 @@
-import { DyFM_DBSort } from '@futdevpro/fsm-dynamo';
-
-/**
- * BFR-OVERSEER-008 — opcionalis query-szukites a list-lekerdezokhoz (projection / limit / sort).
- *
- * A `DyNTS_DBService.find()` es a `DyNTS_DataService.findDataList()` opcionalis 3. parametere.
- * A szukites DB-szinten tortenik (mongoose `.select()/.sort()/.limit()`), igy a nagy mezok
- * (pl. tobb-MB-s blob property-k) BE SEM toltodnek a heap-be — ez a mert Overseer
- * event-loop-block (nagy-archiv full-betoltes) gyoker-fixenek enablere.
- *
- * FONTOS viselkedesi reszlet: ha options van megadva es a hivo nem ker `findDeleted`-et,
- * a soft-delete szures QUERY-szintre kerul (`_deleted: { $ne: true }`) a memoriabeli
- * post-filter helyett — limit mellett a post-filter hibas darabszamot adna, projekcio
- * mellett (ha a `_deleted` nincs projektalva) hibasan atengedne a torolt dokumentumokat.
- */
-export interface DyNTS_DBQueryOptions<T> {
-  /**
-   * Mongoose select-projekcio — pl. `{ version: 1, timestamp: 1 }` (include-lista)
-   * vagy `'-cdpReport'` (exclude-string). Ha nincs megadva, a teljes dokumentum jon.
-   */
-  projection?: { [K in keyof T]?: 0 | 1 } | string;
-
-  /**
-   * Max visszaadott dokumentum-szam (mongoose `.limit()`). Sort-tal egyutt hasznald,
-   * kulonben a "melyik N" nem-determinisztikus.
-   */
-  limit?: number;
-
-  /**
-   * Rendezes (mongoose `.sort()`) — pl. `{ __created: -1 }` a legfrissebbek elore.
-   */
-  sort?: DyFM_DBSort<T>;
-}
+import { DyFM_DBSort } from '@futdevpro/fsm-dynamo';
+
+/**
+ * BFR-OVERSEER-008 — opcionalis query-szukites a list-lekerdezokhoz (projection / limit / sort).
+ *
+ * A `DyNTS_DBService.find()` es a `DyNTS_DataService.findDataList()` opcionalis 3. parametere.
+ * A szukites DB-szinten tortenik (mongoose `.select()/.sort()/.limit()`), igy a nagy mezok
+ * (pl. tobb-MB-s blob property-k) BE SEM toltodnek a heap-be — ez a mert Overseer
+ * event-loop-block (nagy-archiv full-betoltes) gyoker-fixenek enablere.
+ *
+ * FONTOS viselkedesi reszlet: ha options van megadva es a hivo nem ker `findDeleted`-et,
+ * a soft-delete szures QUERY-szintre kerul (`_deleted: { $ne: true }`) a memoriabeli
+ * post-filter helyett — limit mellett a post-filter hibas darabszamot adna, projekcio
+ * mellett (ha a `_deleted` nincs projektalva) hibasan atengedne a torolt dokumentumokat.
+ */
+export interface DyNTS_DBQueryOptions<T> {
+  /**
+   * Mongoose select-projekcio — pl. `{ version: 1, timestamp: 1 }` (include-lista)
+   * vagy `'-cdpReport'` (exclude-string). Ha nincs megadva, a teljes dokumentum jon.
+   */
+  projection?: { [K in keyof T]?: 0 | 1 } | string;
+
+  /**
+   * Max visszaadott dokumentum-szam (mongoose `.limit()`). Sort-tal egyutt hasznald,
+   * kulonben a "melyik N" nem-determinisztikus.
+   */
+  limit?: number;
+
+  /**
+   * Rendezes (mongoose `.sort()`) — pl. `{ __created: -1 }` a legfrissebbek elore.
+   */
+  sort?: DyFM_DBSort<T>;
+}

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

@@ -1,59 +1,59 @@
-import { DyFM_EnvironmentFlag } from '@futdevpro/fsm-dynamo';
-
-
-
-export interface DyNTS_Environment_Settings {
-  /**
-   * this is the environment flag of the system
-   * e.g. local, development, production
-   * 
-   * use ENV or ENVIRONMENT in the .env file to set the environment
-   * 
-   * use {@link DyFM_EnvironmentFlag} for consistent system processes
-   */
-  environment: DyFM_EnvironmentFlag;
-
-  /**
-   * this is the discord settings of the system
-   */
-  discord: {
-    token: string;
-    clientId: string;
-    guildId: string;
-    oauth2Url: string;
-  },
-
-  /**
-   * this is the mongo uri of the system
-   */
-  mongoUri: string;
-
-  /**
-   * this is the openai settings of the system
-   */
-  openAi: {
-    apiKey: string;
-    organization: string;
-    project: string;
-    ttsApiKey: string;
-  },
-
-  /**
-   * this is the elevenlabs settings of the system
-   */
-  /* elevenLabs: {
-    apiKey: string;
-  }, */
-
-  /**
-   * this is the clickup settings of the system
-   */
-  /* clickup: {
-    apiKey: string;
-    workspaceId: string;
-    spaceId: string;
-    listId: string;
-  }, */
-
-}
-
+import { DyFM_EnvironmentFlag } from '@futdevpro/fsm-dynamo';
+
+
+
+export interface DyNTS_Environment_Settings {
+  /**
+   * this is the environment flag of the system
+   * e.g. local, development, production
+   * 
+   * use ENV or ENVIRONMENT in the .env file to set the environment
+   * 
+   * use {@link DyFM_EnvironmentFlag} for consistent system processes
+   */
+  environment: DyFM_EnvironmentFlag;
+
+  /**
+   * this is the discord settings of the system
+   */
+  discord: {
+    token: string;
+    clientId: string;
+    guildId: string;
+    oauth2Url: string;
+  },
+
+  /**
+   * this is the mongo uri of the system
+   */
+  mongoUri: string;
+
+  /**
+   * this is the openai settings of the system
+   */
+  openAi: {
+    apiKey: string;
+    organization: string;
+    project: string;
+    ttsApiKey: string;
+  },
+
+  /**
+   * this is the elevenlabs settings of the system
+   */
+  /* elevenLabs: {
+    apiKey: string;
+  }, */
+
+  /**
+   * this is the clickup settings of the system
+   */
+  /* clickup: {
+    apiKey: string;
+    workspaceId: string;
+    spaceId: string;
+    listId: string;
+  }, */
+
+}
+

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;
+  };
+}