@futdevpro/nts-dynamo 1.15.21 → 1.15.23

package/__documentations/2026-05-17-static-client-serving-howto.md

@@ -0,0 +1,144 @@
+# Static client serving — how-to
+
+**Date:** 2026-05-17
+**Backlog:** [BL-20260417-001](../_specifications/BACKLOG.md) — DyNTS-kliens kiszolgálás képesség
+**Status:** ✅ done (audit + docs)
+
+## TL;DR
+
+A `DyNTS_App_Server` MÁR most ki tudja szolgálni a klienst (SPA-kat, statikus
+oldalakat) az API route-ok mellett ugyanazon a hoszton. Az implementáció
+2026-03-30 óta (commit `8ffe535`) része a frameworknek; a BL-20260417-001
+backlog entry post-dated a fejlesztést. Ez a how-to a meglévő capability-t
+dokumentálja.
+
+## Konfigurációs felület
+
+A static client serving akkor aktiválódik, ha a `DyNTS_App_Server`
+subclass-od `getStaticClientSettings()`-et override-olja és egy
+[`DyNTS_StaticClient_Settings`](../src/_models/interfaces/static-client-settings.interface.ts)
+objektumot ad vissza:
+
+```ts
+import { DyNTS_StaticClient_Settings } from '@futdevpro/nts-dynamo';
+
+export interface DyNTS_StaticClient_Settings {
+  root: string;                  // a static fájlok mappája (abszolút v. cwd-relatív)
+  fallbackPath?: string;          // SPA fallback (pl. 'index.html')
+  assetCacheMaxAge?: number;      // asset Cache-Control max-age (sec)
+  assetCacheImmutable?: boolean;  // 'immutable' direktíva (Angular hashed fájlokra)
+  fallbackCacheMaxAge?: number;   // fallback file Cache-Control max-age (sec)
+}
+```
+
+## Példa subclass (Angular SPA)
+
+```ts
+import path from 'path';
+import { DyNTS_App_Server, DyNTS_StaticClient_Settings } from '@futdevpro/nts-dynamo';
+
+export class MyApp_Server extends DyNTS_App_Server {
+  // ... egyéb override-ok (getAppParams, getPortSettings, getApiBasePath, stb.) ...
+
+  override getStaticClientSettings(): DyNTS_StaticClient_Settings | undefined {
+    return {
+      // Az Angular `dist/<app-name>` mappa abszolút path-ja
+      root: path.resolve(__dirname, '../../client/dist/my-app'),
+
+      // SPA — minden ismeretlen route a kliens-routerre megy
+      fallbackPath: 'index.html',
+
+      // Hashed assetek (Angular alapból ad nekik hash-et) — 1 év, immutable
+      assetCacheMaxAge: 31_536_000,
+      assetCacheImmutable: true,
+
+      // index.html-t SOHA ne cache-elje a böngésző (deploy után friss kell)
+      fallbackCacheMaxAge: 0,
+    };
+  }
+}
+```
+
+## Mit csinál a framework a háttérben
+
+A `DyNTS_App_Server.mountStaticClient()` ([app.server.ts ~1421-1484](../src/_services/server/app.server.ts))
+ezt automatikusan beállítja az API route-ok regisztrációja UTÁN:
+
+1. **`Express.static(root)` middleware** mount a `/` alatt. Ha `assetCacheMaxAge`
+   meg van adva, `setHeaders` callback-en keresztül beállítja a `Cache-Control:
+   max-age=<N>[, immutable]` header-t.
+2. **SPA fallback** (ha `fallbackPath` adott): minden ismeretlen GET kérésre
+   `res.sendFile(fallbackPath)` + `Cache-Control: max-age=<fallbackCacheMaxAge>`.
+3. **Default 404** (ha `fallbackPath` hiányzik): a beépített
+   [`DyNTS_defaultNotFoundPageHtml`](../src/_collections/default-not-found-page.const.ts)
+   kerül kiszolgálásra `status: 404` + `Content-Type: text/html`.
+4. **HTTP + HTTPS** mindkettő: a flow azonos a `this.openExpress` és
+   `this.secureExpress` instance-ekhez (ha mindkettő be van állítva).
+
+## Config matrix — mikor melyik mezőt használd
+
+| Use case | `root` | `fallbackPath` | `assetCacheMaxAge` | `assetCacheImmutable` | `fallbackCacheMaxAge` |
+|---|---|---|---|---|---|
+| **SPA** (Angular, React) hashed assetekkel | ✅ kötelező | `'index.html'` | `31_536_000` (1 év) | `true` | `0` (mindig friss) |
+| **SPA** dev mode (rebuild gyakori) | ✅ | `'index.html'` | `0` | `false` | `0` |
+| **Statikus oldal** (nincs SPA-router) | ✅ | hagyd ki | `3600` (1 óra) vagy ahogy jó | `false` | n/a |
+| **Csak API** (nincs frontend) | NE override-old a `getStaticClientSettings()`-et — akkor `undefined`-ot ad vissza és a `mountStaticClient` early-return-öl | | | | |
+
+## Asset + fallback cache stratégia (SPA)
+
+A két mező együttes használata az **alapja az Angular/React deploy-friendly caching**-nek:
+
+- **Hashed assetek** (`main.<hash>.js`, `styles.<hash>.css`, stb.) ÉLETBEN nem
+  változnak — biztonságosan `immutable` + 1 év max-age. A böngésző sose kérdezi
+  meg újra a szerverről, amíg a HTML egy új hash-elt nevet nem hivatkozik be.
+- **`index.html`** a "katalógus" ami a hashed assetekre mutat. Deploy után
+  AZONNAL friss kell legyen, különben a kliens régi assetekre hivatkozó régi
+  index.html-t kap → 404-ek a már nem létező hashed nevekre.
+  → `fallbackCacheMaxAge: 0` (no-cache).
+
+Az `assetCacheMaxAge` undefined-ja default (Express.static alapértelmezett) cache
+viselkedést hagy meg — production deploy-okra mindig explicit állítsd be.
+
+## Integration test minta
+
+A meglévő integration test fixture ([`DyNTS_AppIntegrationTest_Mock`](../src/_modules/mock/app-integration-test.mock.ts)) +
+spec ([app-extended.integration.spec.ts](../src/_modules/socket/app-extended.integration.spec.ts))
+mutatja a teljes flow-t:
+
+- A spec `beforeAll`-ban létrehoz egy temp dir-t, kitölti pár static fájllal,
+  beállítja a mock `integrationStaticRoot` static property-jét, majd elindítja
+  az appot.
+- A spec asszertálja:
+  - `started === true` (az app HTTP listenert kapott)
+  - GET nemlétező path → `404` + a default not-found HTML kiszolgálva
+  - GET `/index.html` → `200` + a temp dir-ben található static content
+  - GET `/api/test-0/test-base`, `/api/test-0/test-simple` → API kiszolgálva (az API
+    route-ok ELŐBB regisztráltak, mint a static fallback)
+- `afterAll`-ban leállítja az appot és kitakarítja a temp dir-t.
+
+## Edge case-ek + gotchák
+
+- **Mounting sorrend:** a `mountStaticClient` az `_routingModules` regisztráció
+  UTÁN fut, így az API route-ok prioritást élveznek. Tehát a `/api/...` mindig
+  az API-hoz megy, akkor is, ha a static root-ban véletlenül lenne `api/`
+  almappa.
+- **`fallbackPath` relatív** a `root`-hoz képest (`sendFile(fallbackPath, { root })`).
+- **Default 404 HTML:** szándékosan minimalista (`DyNTS_defaultNotFoundPageHtml`),
+  hogy ne ütközzön a kliens stílusával. Ha custom 404-et akarsz, add meg a
+  `fallbackPath`-t (az SPA-router majd kezelje belül a "page not found"-ot).
+- **CSP / security header-ek:** a `mountStaticClient` NEM állít be CSP-t —
+  ha kell, használj `helmet` middleware-t az API route-ok elé.
+
+## Releváns kód- és test-fájlok
+
+- [`src/_services/server/app.server.ts`](../src/_services/server/app.server.ts) — `mountStaticClient()` private + `getStaticClientSettings?()` opt-in override
+- [`src/_models/interfaces/static-client-settings.interface.ts`](../src/_models/interfaces/static-client-settings.interface.ts) — config interface
+- [`src/_collections/default-fallback-cache-max-age.const.ts`](../src/_collections/default-fallback-cache-max-age.const.ts) — default `0` (no-cache)
+- [`src/_collections/default-not-found-page.const.ts`](../src/_collections/default-not-found-page.const.ts) — default 404 HTML
+- [`src/_modules/mock/app-integration-test.mock.ts`](../src/_modules/mock/app-integration-test.mock.ts) — integration test fixture mintaként
+- [`__documentations/nts-integration-tests-2026-03-17.md`](./nts-integration-tests-2026-03-17.md) — első integration test bevezetése a unified host behavior-ra
+
+## Kapcsolódó backlog entry-k
+
+- **BL-20260420-001..004** (dynamo-nts) — `DyNTS_FileLog_Service` + admin endpoints. Mind ✅ done.
+- BL-20260417-001 (ez) — a kliens kiszolgálási képesség. ✅ done — implementáció már része a frameworknek; ez a doc a hivatkozás.

package/_specifications/BACKLOG.md

@@ -15,11 +15,11 @@
 > - IDs: unique, format BL-YYYYMMDD-### (increment ###).
 
 - [FEATURE] (BL-20260417-001) Dynamo NTS kliens kiszolgálás képesség
-  status: ⏳ pending
+  status: ✅ done
   priority: medium
   source: user
   area: backend
-  details: Alkalmassá kell tenni a Dynamo NTS-t, hogy kiszolgálja a klienst (frontend/client-side serving)
+  details: Alkalmassá kell tenni a Dynamo NTS-t, hogy kiszolgálja a klienst (frontend/client-side serving). Audit eredménye (2026-05-17): a capability MÁR implementálva van 2026-03-30 óta (commit 8ffe535) — DyNTS_App_Server.mountStaticClient() + getStaticClientSettings?() opt-in override + DyNTS_StaticClient_Settings interface (root, fallbackPath, assetCacheMaxAge, assetCacheImmutable, fallbackCacheMaxAge). Featureset: Express.static mount /-en az API route-ok után, SPA fallback sendFile-lal, asset+fallback Cache-Control (Angular hashed fájl optimalizálásra), default 404 HTML ha nincs fallbackPath, mindkét http/https express-en mount. Integration test megvan (app-extended.integration.spec.ts + app-integration-test.mock.ts). How-to doc: __documentations/2026-05-17-static-client-serving-howto.md (config matrix + example subclass + cache stratégia + edge case-ek).
 
 - [FEATURE] (BL-20260420-001) Átfogó file-based log kezelési rendszer
   status: ✅ done
@@ -43,8 +43,8 @@
   details: A BL-20260420-001 file-based log rendszerre épülve egy új endpoint, amin keresztül le lehet kérni a szerverről a kiírt log file-ok tartalmát (pl. paged / range / tail módon). Implementálva (2026-05-17): DyNTS_FileLogs_Controller (GET /list + GET /file/:filename) + DyNTS_getFileLogsRoutingModule() factory + DyNTS_FileLog_Service bővítés (listLogFiles, readLogFile, getCurrentLogFilename). Olvasási módok: tail / head / range (max 10000 sor). Safeguards: filename whitelist regex prefix-szel, path traversal védelem (resolvedPath + sep ellenőrzés), 503/404/400 helyes status code-ok. Auth opt-in: `DyNTS_getFileLogsRoutingModule({ authPreProcess: adminAuth.verify })`. Default route /file-logs. 38/38 FileLog spec (24 service + 14 controller) + 1175/0 full suite + smoke 4/4 verifikálva.
 
 - [IMPROVEMENT] (BL-20260420-004) Errors endpointok opcionális admin API key védelme
-  status: ⏳ pending
+  status: ✅ done
   priority: medium
   source: user
   area: backend
-  details: A BL-20260420-002 admin API key auth réteget opcionálisan rá kell tudni húzni a meglévő DyNTS_Errors_Controller endpointjaira (errors.controller.ts) is, hogy érzékeny error-listázó / kezelő endpointok admin auth mögé kerülhessenek. Opt-in legyen, ne törje a meglévő integrációkat
+  details: A BL-20260420-002 admin API key auth réteget opcionálisan rá kell tudni húzni a meglévő DyNTS_Errors_Controller endpointjaira (errors.controller.ts) is, hogy érzékeny error-listázó / kezelő endpointok admin auth mögé kerülhessenek. Implementálva (2026-05-17): static `DyNTS_Errors_Controller.configure({ authPreProcess?, protectedEndpoints? })` — opt-in, default = no auth (backwards compatible). `authPreProcess` jelenléte esetén default mind a 8 endpoint védett, vagy `protectedEndpoints` subset-tel fine-grained kontroll. `getAuthConfig()` + `_resetAuthConfigForTesting()` segéd-fnk-ek. Per-endpoint `preProcesses: this.getPreProcessesFor(name)` thread-elve mind a 8 endpoint-konstrukcióba. 16/16 errors controller spec (11 régi backwards-compat + 5 új retrofit) + 1180/0 full suite + smoke 3/3 (default, full, subset).

package/build/_modules/server/errors/errors.controller.d.ts

@@ -1,7 +1,36 @@
+import { Request, Response } from 'express';
 import { DyFM_Error, DyFM_Errors } from '@futdevpro/fsm-dynamo';
 import { DyNTS_Controller } from '../../../_services/route/controller.service';
 import { DyNTS_Endpoint_Params } from '../../../_models/control-models/endpoint-params.control-model';
 import { DyNTS_Errors_ControlService } from './errors.control-service';
+/**
+ * Auth retrofit config a `DyNTS_Errors_Controller`-hez. Opt-in — ha az
+ * `authPreProcess` nincs megadva, a controller a regi (auth nelkuli)
+ * viselkedest tartja.
+ *
+ * **Subclass-szintu konfiguracio:** az `authConfig` static, igy az abstract
+ * osztaly minden subclass-a kozott OSZTOTT. Ha tobb subclass-od van kulonbozo
+ * policy-val, hivd a `configure()`-t a megfelelo subclasson — TypeScript a
+ * static field-eket per-class hatarozza meg.
+ */
+export interface DyNTS_ErrorsController_AuthConfig {
+    /**
+     * Pre-process fuggveny ami minden vedett endpoint elott fut. Tipikusan:
+     * `DyNTS_AdminApiKey_AuthService.getInstance().verify`.
+     *
+     * Ha hianyzik vagy `undefined`, a controller NEM ad hozza auth-ot semelyik
+     * endpoint-hoz (regi viselkedes, opt-in safety).
+     */
+    authPreProcess?: (req: Request, res: Response) => Promise<void>;
+    /**
+     * Vedett endpoint nevek listaja. Ha hianyzik, az osszes 8 endpoint vedett
+     * (`authPreProcess` jelenleteben).
+     *
+     * Endpoint nevek: 'logError', 'newError', 'markErrorDone', 'markAllErrorDone',
+     * 'getErrors', 'getErrorsPaged', 'getLastErrors', 'searchErrors'.
+     */
+    protectedEndpoints?: string[];
+}
 /**
  * Endpoints:
  *
@@ -31,6 +60,41 @@ export declare abstract class DyNTS_Errors_Controller<T_Error extends DyFM_Error
         issuer: string;
     }): T_Error_ControlService;
     protected readonly additionalEndpoints: DyNTS_Endpoint_Params[];
+    /**
+     * Static auth config — opt-in retrofit. Default ures objektum → NO auth
+     * (a meglevo integraciok valtoznatlan viselkedessel folytatodnak).
+     */
+    protected static authConfig: DyNTS_ErrorsController_AuthConfig;
+    /**
+     * Static config setter. Hivhato barmikor a szerver startup-jan az endpoint
+     * registration ELOTT.
+     *
+     * Use case (host app):
+     * ```ts
+     * const adminAuth = DyNTS_AdminApiKey_AuthService.getInstance();
+     * DyNTS_Errors_Controller.configure({ authPreProcess: adminAuth.verify });
+     * // vagy fine-grained:
+     * DyNTS_Errors_Controller.configure({
+     *   authPreProcess: adminAuth.verify,
+     *   protectedEndpoints: ['markAllErrorDone', 'logError'],
+     * });
+     * ```
+     */
+    static configure(config: DyNTS_ErrorsController_AuthConfig): void;
+    /**
+     * Aktualis auth config olvasasa (test/diagnosztika celokra).
+     */
+    static getAuthConfig(): DyNTS_ErrorsController_AuthConfig;
+    /**
+     * Test-only: visszaallitja az auth config-ot ures objektumra. Production code NE hivja.
+     */
+    static _resetAuthConfigForTesting(): void;
+    /**
+     * Vissza-adja az adott endpoint-hoz tartozo `preProcesses` array-t.
+     * Ha az auth NINCS configurolva (default) vagy az endpoint nincs a
+     * `protectedEndpoints` listan, ures array-t ad vissza.
+     */
+    protected getPreProcessesFor(endpointName: string): ((req: Request, res: Response) => Promise<void>)[];
     setupEndpoints(): void;
 }
 //# sourceMappingURL=errors.controller.d.ts.map

package/build/_modules/server/errors/errors.controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.controller.d.ts","sourceRoot":"","sources":["../../../../src/_modules/server/errors/errors.controller.ts"],"names":[],"mappings":"AAGA,OAAO,EAAc,UAAU,EAAqB,WAAW,EAAqB,MAAM,uBAAuB,CAAC;AAClH,OAAO,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,+DAA+D,CAAC;AACtG,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAGvE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,8BAAsB,uBAAuB,CAC3C,OAAO,SAAS,UAAU,EAC1B,QAAQ,SAAS,WAAW,CAAC,OAAO,CAAC,EACrC,sBAAsB,SAAS,2BAA2B,CAAC,OAAO,EAAE,QAAQ,CAAC,CAC7E,SAAQ,gBAAgB;IAOxB,SAAS,CAAC,QAAQ,CAAC,uBAAuB,CACxC,GAAG,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GACtC,sBAAsB;IACzB,SAAS,CAAC,QAAQ,CAAC,mBAAmB,EAAE,qBAAqB,EAAE,CAAM;IAErE,cAAc,IAAI,IAAI;CAqNvB"}
+{"version":3,"file":"errors.controller.d.ts","sourceRoot":"","sources":["../../../../src/_modules/server/errors/errors.controller.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE5C,OAAO,EAAc,UAAU,EAAqB,WAAW,EAAqB,MAAM,uBAAuB,CAAC;AAClH,OAAO,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,+DAA+D,CAAC;AACtG,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAIvE;;;;;;;;;GASG;AACH,MAAM,WAAW,iCAAiC;IAChD;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhE;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAcD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,8BAAsB,uBAAuB,CAC3C,OAAO,SAAS,UAAU,EAC1B,QAAQ,SAAS,WAAW,CAAC,OAAO,CAAC,EACrC,sBAAsB,SAAS,2BAA2B,CAAC,OAAO,EAAE,QAAQ,CAAC,CAC7E,SAAQ,gBAAgB;IAOxB,SAAS,CAAC,QAAQ,CAAC,uBAAuB,CACxC,GAAG,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GACtC,sBAAsB;IACzB,SAAS,CAAC,QAAQ,CAAC,mBAAmB,EAAE,qBAAqB,EAAE,CAAM;IAErE;;;OAGG;IACH,SAAS,CAAC,MAAM,CAAC,UAAU,EAAE,iCAAiC,CAAM;IAEpE;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,iCAAiC,GAAG,IAAI;IAIjE;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,iCAAiC;IAIzD;;OAEG;IACH,MAAM,CAAC,0BAA0B,IAAI,IAAI;IAIzC;;;;OAIG;IACH,SAAS,CAAC,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE;IAOtG,cAAc,IAAI,IAAI;CA6NvB"}

package/build/_modules/server/errors/errors.controller.js

@@ -5,6 +5,16 @@ const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
 const controller_service_1 = require("../../../_services/route/controller.service");
 const endpoint_params_control_model_1 = require("../../../_models/control-models/endpoint-params.control-model");
 const global_settings_const_1 = require("../../../_collections/global-settings.const");
+/**
+ * Az osszes built-in endpoint neve — a `configure({ protectedEndpoints })`
+ * default-jat es a config validacio-t segiti.
+ */
+const ALL_ENDPOINT_NAMES = [
+    'logError', 'newError',
+    'markErrorDone', 'markAllErrorDone',
+    'getErrors', 'getErrorsPaged', 'getLastErrors',
+    'searchErrors',
+];
 /**
  * Endpoints:
  *
@@ -33,6 +43,54 @@ const global_settings_const_1 = require("../../../_collections/global-settings.c
 // 
 class DyNTS_Errors_Controller extends controller_service_1.DyNTS_Controller {
     additionalEndpoints = [];
+    /**
+     * Static auth config — opt-in retrofit. Default ures objektum → NO auth
+     * (a meglevo integraciok valtoznatlan viselkedessel folytatodnak).
+     */
+    static authConfig = {};
+    /**
+     * Static config setter. Hivhato barmikor a szerver startup-jan az endpoint
+     * registration ELOTT.
+     *
+     * Use case (host app):
+     * ```ts
+     * const adminAuth = DyNTS_AdminApiKey_AuthService.getInstance();
+     * DyNTS_Errors_Controller.configure({ authPreProcess: adminAuth.verify });
+     * // vagy fine-grained:
+     * DyNTS_Errors_Controller.configure({
+     *   authPreProcess: adminAuth.verify,
+     *   protectedEndpoints: ['markAllErrorDone', 'logError'],
+     * });
+     * ```
+     */
+    static configure(config) {
+        DyNTS_Errors_Controller.authConfig = config;
+    }
+    /**
+     * Aktualis auth config olvasasa (test/diagnosztika celokra).
+     */
+    static getAuthConfig() {
+        return DyNTS_Errors_Controller.authConfig;
+    }
+    /**
+     * Test-only: visszaallitja az auth config-ot ures objektumra. Production code NE hivja.
+     */
+    static _resetAuthConfigForTesting() {
+        DyNTS_Errors_Controller.authConfig = {};
+    }
+    /**
+     * Vissza-adja az adott endpoint-hoz tartozo `preProcesses` array-t.
+     * Ha az auth NINCS configurolva (default) vagy az endpoint nincs a
+     * `protectedEndpoints` listan, ures array-t ad vissza.
+     */
+    getPreProcessesFor(endpointName) {
+        const cfg = DyNTS_Errors_Controller.authConfig;
+        if (!cfg.authPreProcess) {
+            return [];
+        }
+        const protectedNames = cfg.protectedEndpoints ?? ALL_ENDPOINT_NAMES;
+        return protectedNames.includes(endpointName) ? [cfg.authPreProcess] : [];
+    }
     setupEndpoints() {
         /* if (!this.getErrorDataService) {
           throw new DyFM_Error({
@@ -51,6 +109,7 @@ class DyNTS_Errors_Controller extends controller_service_1.DyNTS_Controller {
                 name: 'logError',
                 type: fsm_dynamo_1.DyFM_HttpCallType.post,
                 endpoint: '/error/log',
+                preProcesses: this.getPreProcessesFor('logError'),
                 tasks: [
                     async (req, res, issuer = 'unknown-issuer') => {
                         const error_CS = this.getError_ControlService({
@@ -67,6 +126,7 @@ class DyNTS_Errors_Controller extends controller_service_1.DyNTS_Controller {
                 name: 'newError',
                 type: fsm_dynamo_1.DyFM_HttpCallType.post,
                 endpoint: '/error/new',
+                preProcesses: this.getPreProcessesFor('newError'),
                 tasks: [
                     async (req, res, issuer = 'unknown-issuer') => {
                         const error_CS = this.getError_ControlService({
@@ -83,6 +143,7 @@ class DyNTS_Errors_Controller extends controller_service_1.DyNTS_Controller {
                 name: 'markErrorDone',
                 type: fsm_dynamo_1.DyFM_HttpCallType.get,
                 endpoint: '/error/mark-done/:errorId',
+                preProcesses: this.getPreProcessesFor('markErrorDone'),
                 tasks: [
                     async (req, res, issuer = 'unknown-issuer') => {
                         const error_CS = this.getError_ControlService({
@@ -99,6 +160,7 @@ class DyNTS_Errors_Controller extends controller_service_1.DyNTS_Controller {
                 name: 'markAllErrorDone',
                 type: fsm_dynamo_1.DyFM_HttpCallType.get,
                 endpoint: '/error/mark-all-done',
+                preProcesses: this.getPreProcessesFor('markAllErrorDone'),
                 tasks: [
                     async (req, res, issuer = 'unknown-issuer') => {
                         const error_CS = this.getError_ControlService({
@@ -134,6 +196,7 @@ class DyNTS_Errors_Controller extends controller_service_1.DyNTS_Controller {
                 name: 'getErrors',
                 type: fsm_dynamo_1.DyFM_HttpCallType.get,
                 endpoint: '/error/get-range/:range',
+                preProcesses: this.getPreProcessesFor('getErrors'),
                 tasks: [
                     async (req, res, issuer = 'unknown-issuer') => {
                         const error_CS = this.getError_ControlService({
@@ -147,6 +210,7 @@ class DyNTS_Errors_Controller extends controller_service_1.DyNTS_Controller {
                 name: 'getErrorsPaged',
                 type: fsm_dynamo_1.DyFM_HttpCallType.get,
                 endpoint: '/error/get-paged/:range/:pageSize/:pageIndex',
+                preProcesses: this.getPreProcessesFor('getErrorsPaged'),
                 tasks: [
                     async (req, res, issuer = 'unknown-issuer') => {
                         const error_CS = this.getError_ControlService({
@@ -167,6 +231,7 @@ class DyNTS_Errors_Controller extends controller_service_1.DyNTS_Controller {
                 name: 'getLastErrors',
                 type: fsm_dynamo_1.DyFM_HttpCallType.get,
                 endpoint: '/error/get-last-paged/:range/:pageSize/:pageIndex',
+                preProcesses: this.getPreProcessesFor('getLastErrors'),
                 tasks: [
                     async (req, res, issuer = 'unknown-issuer') => {
                         const error_CS = this.getError_ControlService({
@@ -187,6 +252,7 @@ class DyNTS_Errors_Controller extends controller_service_1.DyNTS_Controller {
                 name: 'searchErrors',
                 type: fsm_dynamo_1.DyFM_HttpCallType.get,
                 endpoint: '/error/search',
+                preProcesses: this.getPreProcessesFor('searchErrors'),
                 tasks: [
                     async (req, res, issuer = 'unknown-issuer') => {
                         const error_CS = this.getError_ControlService({

package/build/_modules/server/errors/errors.controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.controller.js","sourceRoot":"","sources":["../../../../src/_modules/server/errors/errors.controller.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.controller.js","sourceRoot":"","sources":["../../../../src/_modules/server/errors/errors.controller.ts"],"names":[],"mappings":";;;AAGA,sDAAkH;AAClH,oFAA+E;AAC/E,iHAAsG;AAEtG,uFAAoF;AAkCpF;;;GAGG;AACH,MAAM,kBAAkB,GAAa;IACnC,UAAU,EAAE,UAAU;IACtB,eAAe,EAAE,kBAAkB;IACnC,WAAW,EAAE,gBAAgB,EAAE,eAAe;IAC9C,cAAc;CACf,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,kBAAkB;AAClB,2BAA2B;AAC3B,GAAG;AACH,MAAsB,uBAIpB,SAAQ,qCAAgB;IAUL,mBAAmB,GAA4B,EAAE,CAAC;IAErE;;;OAGG;IACO,MAAM,CAAC,UAAU,GAAsC,EAAE,CAAC;IAEpE;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,SAAS,CAAC,MAAyC;QACxD,uBAAuB,CAAC,UAAU,GAAG,MAAM,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,aAAa;QAClB,OAAO,uBAAuB,CAAC,UAAU,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,0BAA0B;QAC/B,uBAAuB,CAAC,UAAU,GAAG,EAAE,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACO,kBAAkB,CAAC,YAAoB;QAC/C,MAAM,GAAG,GAAsC,uBAAuB,CAAC,UAAU,CAAC;QAClF,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;YAAC,OAAO,EAAE,CAAC;QAAC,CAAC;QACvC,MAAM,cAAc,GAAa,GAAG,CAAC,kBAAkB,IAAI,kBAAkB,CAAC;QAC9E,OAAO,cAAc,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3E,CAAC;IAED,cAAc;QACZ;;;;;YAKI;QAEJ,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC9B,MAAM,IAAI,uBAAU,CAAC;gBACnB,OAAO,EAAE,0DAA0D;gBACnE,SAAS,EAAE,GAAG,6CAAqB,CAAC,mBAAmB,gBAAgB;aACxE,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,SAAS,GAAG;YACf,IAAI,qDAAqB,CAAC;gBACxB,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,8BAAiB,CAAC,IAAI;gBAC5B,QAAQ,EAAE,YAAY;gBACtB,YAAY,EAAE,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC;gBACjD,KAAK,EAAE;oBACL,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,SAAiB,gBAAgB,EAAiB,EAAE;wBACtF,MAAM,QAAQ,GAA2B,IAAI,CAAC,uBAAuB,CAAC;4BACpE,MAAM;yBACP,CAAC,CAAC;wBAEH,MAAM,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;wBAE7C,GAAG,CAAC,IAAI,CAAC;4BACP,MAAM,EAAE,cAAc;yBACvB,CAAC,CAAC;oBACL,CAAC;iBACF;aACF,CAAC;YACF,IAAI,qDAAqB,CAAC;gBACxB,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,8BAAiB,CAAC,IAAI;gBAC5B,QAAQ,EAAE,YAAY;gBACtB,YAAY,EAAE,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC;gBACjD,KAAK,EAAE;oBACL,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,SAAiB,gBAAgB,EAAiB,EAAE;wBACtF,MAAM,QAAQ,GAA2B,IAAI,CAAC,uBAAuB,CAAC;4BACpE,MAAM;yBACP,CAAC,CAAC;wBAEH,MAAM,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;wBAE7C,GAAG,CAAC,IAAI,CAAC;4BACP,MAAM,EAAE,cAAc;yBACvB,CAAC,CAAC;oBACL,CAAC;iBACF;aACF,CAAC;YAEF,IAAI,qDAAqB,CAAC;gBACxB,IAAI,EAAE,eAAe;gBACrB,IAAI,EAAE,8BAAiB,CAAC,GAAG;gBAC3B,QAAQ,EAAE,2BAA2B;gBACrC,YAAY,EAAE,IAAI,CAAC,kBAAkB,CAAC,eAAe,CAAC;gBACtD,KAAK,EAAE;oBACL,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,SAAiB,gBAAgB,EAAiB,EAAE;wBACtF,MAAM,QAAQ,GAA2B,IAAI,CAAC,uBAAuB,CAAC;4BACpE,MAAM;yBACP,CAAC,CAAC;wBAEH,MAAM,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;wBAE7D,GAAG,CAAC,IAAI,CAAC;4BACP,MAAM,EAAE,eAAe;yBACxB,CAAC,CAAC;oBACL,CAAC;iBACF;aACF,CAAC;YAEF,IAAI,qDAAqB,CAAC;gBACxB,IAAI,EAAE,kBAAkB;gBACxB,IAAI,EAAE,8BAAiB,CAAC,GAAG;gBAC3B,QAAQ,EAAE,sBAAsB;gBAChC,YAAY,EAAE,IAAI,CAAC,kBAAkB,CAAC,kBAAkB,CAAC;gBACzD,KAAK,EAAE;oBACL,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,SAAiB,gBAAgB,EAAiB,EAAE;wBACtF,MAAM,QAAQ,GAA2B,IAAI,CAAC,uBAAuB,CAAC;4BACpE,MAAM;yBACP,CAAC,CAAC;wBAEH,MAAM,QAAQ,CAAC,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;wBAE7C,GAAG,CAAC,IAAI,CAAC;4BACP,MAAM,EAAE,mBAAmB;yBAC5B,CAAC,CAAC;oBACL,CAAC;iBACF;aACF,CAAC;YAEF;;;;;;;;;;;;;;;;;;kBAkBM;YAEN,IAAI,qDAAqB,CAAC;gBACxB,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,8BAAiB,CAAC,GAAG;gBAC3B,QAAQ,EAAE,yBAAyB;gBACnC,YAAY,EAAE,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC;gBAClD,KAAK,EAAE;oBACL,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,SAAiB,gBAAgB,EAAkB,EAAE;wBACvF,MAAM,QAAQ,GAA2B,IAAI,CAAC,uBAAuB,CAAC;4BACpE,MAAM;yBACP,CAAC,CAAC;wBAEH,GAAG,CAAC,IAAI,CACN,MAAM,QAAQ,CAAC,gBAAgB,CAC7B,GAAG,CAAC,MAAM,CAAC,KAA0B,EACrC,MAAM,CACP,CACF,CAAC;oBACJ,CAAC;iBACF;aACF,CAAC;YAEF,IAAI,qDAAqB,CAAC;gBACxB,IAAI,EAAE,gBAAgB;gBACtB,IAAI,EAAE,8BAAiB,CAAC,GAAG;gBAC3B,QAAQ,EAAE,8CAA8C;gBACxD,YAAY,EAAE,IAAI,CAAC,kBAAkB,CAAC,gBAAgB,CAAC;gBACvD,KAAK,EAAE;oBACL,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,SAAiB,gBAAgB,EAAkB,EAAE;wBACvF,MAAM,QAAQ,GAA2B,IAAI,CAAC,uBAAuB,CAAC;4BACpE,MAAM;yBACP,CAAC,CAAC;wBAEH,IAAI,QAAQ,GAAW,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;wBACvE,IAAI,SAAS,GAAW,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;wBAEzE,mDAAmD;wBACnD,IAAI,EAAE,GAAG,QAAQ,EAAE,CAAC;4BAClB,QAAQ,GAAG,EAAE,CAAC;4BACd,SAAS,GAAG,CAAC,CAAC;wBAChB,CAAC;wBAED,GAAG,CAAC,IAAI,CACN,MAAM,QAAQ,CAAC,cAAc,CAC3B,GAAG,CAAC,MAAM,CAAC,KAA0B,EACrC,QAAQ,EACR,SAAS,EACT,MAAM,CACP,CACF,CAAC;oBACJ,CAAC;iBACF;aACF,CAAC;YAEF,IAAI,qDAAqB,CAAC;gBACxB,IAAI,EAAE,eAAe;gBACrB,IAAI,EAAE,8BAAiB,CAAC,GAAG;gBAC3B,QAAQ,EAAE,mDAAmD;gBAC7D,YAAY,EAAE,IAAI,CAAC,kBAAkB,CAAC,eAAe,CAAC;gBACtD,KAAK,EAAE;oBACL,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,SAAiB,gBAAgB,EAAkB,EAAE;wBACvF,MAAM,QAAQ,GAA2B,IAAI,CAAC,uBAAuB,CAAC;4BACpE,MAAM;yBACP,CAAC,CAAC;wBAEH,IAAI,QAAQ,GAAW,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;wBACvE,IAAI,SAAS,GAAW,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;wBAEzE,mDAAmD;wBACnD,IAAI,EAAE,GAAG,QAAQ,EAAE,CAAC;4BAClB,QAAQ,GAAG,EAAE,CAAC;4BACd,SAAS,GAAG,CAAC,CAAC;wBAChB,CAAC;wBAED,GAAG,CAAC,IAAI,CACN,MAAM,QAAQ,CAAC,aAAa,CAC1B,GAAG,CAAC,MAAM,CAAC,KAA0B,EACrC,QAAQ,EACR,SAAS,EACT,MAAM,CACP,CACF,CAAC;oBACJ,CAAC;iBACF;aACF,CAAC;YAEF,IAAI,qDAAqB,CAAC;gBACxB,IAAI,EAAE,cAAc;gBACpB,IAAI,EAAE,8BAAiB,CAAC,GAAG;gBAC3B,QAAQ,EAAE,eAAe;gBACzB,YAAY,EAAE,IAAI,CAAC,kBAAkB,CAAC,cAAc,CAAC;gBACrD,KAAK,EAAE;oBACL,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,SAAiB,gBAAgB,EAAkB,EAAE;wBACvF,MAAM,QAAQ,GAA2B,IAAI,CAAC,uBAAuB,CAAC;4BACpE,MAAM;yBACP,CAAC,CAAC;wBAEH,GAAG,CAAC,IAAI,CACN,MAAM,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAC9C,CAAC;oBACJ,CAAC;iBACF;aACF,CAAC;YAEF,GAAG,IAAI,CAAC,mBAAmB;SAC5B,CAAC;IACJ,CAAC;;AA/RH,0DAgSC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/nts-dynamo",
-  "version": "01.15.21",
+  "version": "01.15.23",
   "description": "Dynamic NodeTS (NodeJS-Typescript), MongoDB Backend System Framework by Future Development Program Ltd.",
   "DyBu_settings": {
     "packageType": "server-package",

package/src/_modules/server/errors/errors.controller.spec.ts

@@ -161,5 +161,75 @@ describe('| DyNTS_Errors_Controller', () => {
       }).toThrow();
     });
   });
+
+  describe('| opt-in admin auth retrofit (BL-20260420-004)', (): void => {
+    afterEach((): void => {
+      DyNTS_Errors_Controller._resetAuthConfigForTesting();
+    });
+
+    it('| default: NO preProcesses on any endpoint (backwards compatible)', (): void => {
+      controller.setupEndpoints();
+      for (const ep of controller.endpoints) {
+        const pre: any = (ep as any).preProcesses;
+        // Ures array vagy undefined elfogadhato — fontos hogy NE legyen auth
+        expect(pre === undefined || pre.length === 0).toBe(true);
+      }
+    });
+
+    it('| configure({ authPreProcess }) → mind a 8 endpoint kap preProcesses-t', (): void => {
+      const fakeAuth = async (): Promise<void> => { /* noop */ };
+      DyNTS_Errors_Controller.configure({ authPreProcess: fakeAuth });
+      // Uj controller instance kell — a setupEndpoints olvassa a static config-ot
+      const c = new (TestErrorsController as any)();
+      c.setupEndpoints();
+
+      const builtIn: string[] = [
+        'logError', 'newError',
+        'markErrorDone', 'markAllErrorDone',
+        'getErrors', 'getErrorsPaged', 'getLastErrors',
+        'searchErrors',
+      ];
+      for (const name of builtIn) {
+        const ep: any = c.endpoints.find((e: any) => e.name === name);
+        expect(ep).withContext(`endpoint ${name} missing`).toBeDefined();
+        const pre: any = (ep as any).preProcesses;
+        expect(pre.length).withContext(`endpoint ${name} preProcesses`).toBe(1);
+        expect(pre[0]).toBe(fakeAuth);
+      }
+    });
+
+    it('| configure({ authPreProcess, protectedEndpoints: subset }) → csak a megadott neveken aktiv', (): void => {
+      const fakeAuth = async (): Promise<void> => { /* noop */ };
+      DyNTS_Errors_Controller.configure({
+        authPreProcess: fakeAuth,
+        protectedEndpoints: ['markAllErrorDone', 'logError'],
+      });
+      const c = new (TestErrorsController as any)();
+      c.setupEndpoints();
+
+      const markAll: any = c.endpoints.find((e: any) => e.name === 'markAllErrorDone');
+      const log: any    = c.endpoints.find((e: any) => e.name === 'logError');
+      const getErrors: any = c.endpoints.find((e: any) => e.name === 'getErrors');
+
+      expect((markAll as any).preProcesses.length).toBe(1);
+      expect((log as any).preProcesses.length).toBe(1);
+      expect((getErrors as any).preProcesses?.length ?? 0).toBe(0);
+    });
+
+    it('| getAuthConfig() returns the active config', (): void => {
+      const fakeAuth = async (): Promise<void> => { /* noop */ };
+      DyNTS_Errors_Controller.configure({ authPreProcess: fakeAuth, protectedEndpoints: ['logError'] });
+      const cfg = DyNTS_Errors_Controller.getAuthConfig();
+      expect(cfg.authPreProcess).toBe(fakeAuth);
+      expect(cfg.protectedEndpoints).toEqual(['logError']);
+    });
+
+    it('| _resetAuthConfigForTesting() clears the config', (): void => {
+      DyNTS_Errors_Controller.configure({ authPreProcess: async (): Promise<void> => { /* noop */ } });
+      DyNTS_Errors_Controller._resetAuthConfigForTesting();
+      const cfg = DyNTS_Errors_Controller.getAuthConfig();
+      expect(cfg.authPreProcess).toBeUndefined();
+    });
+  });
 });
 

package/src/_modules/server/errors/errors.controller.ts

@@ -7,6 +7,49 @@ import { DyNTS_Endpoint_Params } from '../../../_models/control-models/endpoint-
 import { DyNTS_Errors_ControlService } from './errors.control-service';
 import { DyNTS_global_settings } from '../../../_collections/global-settings.const';
 
+
+/**
+ * Auth retrofit config a `DyNTS_Errors_Controller`-hez. Opt-in — ha az
+ * `authPreProcess` nincs megadva, a controller a regi (auth nelkuli)
+ * viselkedest tartja.
+ *
+ * **Subclass-szintu konfiguracio:** az `authConfig` static, igy az abstract
+ * osztaly minden subclass-a kozott OSZTOTT. Ha tobb subclass-od van kulonbozo
+ * policy-val, hivd a `configure()`-t a megfelelo subclasson — TypeScript a
+ * static field-eket per-class hatarozza meg.
+ */
+export interface DyNTS_ErrorsController_AuthConfig {
+  /**
+   * Pre-process fuggveny ami minden vedett endpoint elott fut. Tipikusan:
+   * `DyNTS_AdminApiKey_AuthService.getInstance().verify`.
+   *
+   * Ha hianyzik vagy `undefined`, a controller NEM ad hozza auth-ot semelyik
+   * endpoint-hoz (regi viselkedes, opt-in safety).
+   */
+  authPreProcess?: (req: Request, res: Response) => Promise<void>;
+
+  /**
+   * Vedett endpoint nevek listaja. Ha hianyzik, az osszes 8 endpoint vedett
+   * (`authPreProcess` jelenleteben).
+   *
+   * Endpoint nevek: 'logError', 'newError', 'markErrorDone', 'markAllErrorDone',
+   * 'getErrors', 'getErrorsPaged', 'getLastErrors', 'searchErrors'.
+   */
+  protectedEndpoints?: string[];
+}
+
+
+/**
+ * Az osszes built-in endpoint neve — a `configure({ protectedEndpoints })`
+ * default-jat es a config validacio-t segiti.
+ */
+const ALL_ENDPOINT_NAMES: string[] = [
+  'logError', 'newError',
+  'markErrorDone', 'markAllErrorDone',
+  'getErrors', 'getErrorsPaged', 'getLastErrors',
+  'searchErrors',
+];
+
 /**
  * Endpoints:
  * 
@@ -49,6 +92,57 @@ export abstract class DyNTS_Errors_Controller<
   ): T_Error_ControlService;
   protected readonly additionalEndpoints: DyNTS_Endpoint_Params[] = [];
 
+  /**
+   * Static auth config — opt-in retrofit. Default ures objektum → NO auth
+   * (a meglevo integraciok valtoznatlan viselkedessel folytatodnak).
+   */
+  protected static authConfig: DyNTS_ErrorsController_AuthConfig = {};
+
+  /**
+   * Static config setter. Hivhato barmikor a szerver startup-jan az endpoint
+   * registration ELOTT.
+   *
+   * Use case (host app):
+   * ```ts
+   * const adminAuth = DyNTS_AdminApiKey_AuthService.getInstance();
+   * DyNTS_Errors_Controller.configure({ authPreProcess: adminAuth.verify });
+   * // vagy fine-grained:
+   * DyNTS_Errors_Controller.configure({
+   *   authPreProcess: adminAuth.verify,
+   *   protectedEndpoints: ['markAllErrorDone', 'logError'],
+   * });
+   * ```
+   */
+  static configure(config: DyNTS_ErrorsController_AuthConfig): void {
+    DyNTS_Errors_Controller.authConfig = config;
+  }
+
+  /**
+   * Aktualis auth config olvasasa (test/diagnosztika celokra).
+   */
+  static getAuthConfig(): DyNTS_ErrorsController_AuthConfig {
+    return DyNTS_Errors_Controller.authConfig;
+  }
+
+  /**
+   * Test-only: visszaallitja az auth config-ot ures objektumra. Production code NE hivja.
+   */
+  static _resetAuthConfigForTesting(): void {
+    DyNTS_Errors_Controller.authConfig = {};
+  }
+
+  /**
+   * Vissza-adja az adott endpoint-hoz tartozo `preProcesses` array-t.
+   * Ha az auth NINCS configurolva (default) vagy az endpoint nincs a
+   * `protectedEndpoints` listan, ures array-t ad vissza.
+   */
+  protected getPreProcessesFor(endpointName: string): ((req: Request, res: Response) => Promise<void>)[] {
+    const cfg: DyNTS_ErrorsController_AuthConfig = DyNTS_Errors_Controller.authConfig;
+    if (!cfg.authPreProcess) { return []; }
+    const protectedNames: string[] = cfg.protectedEndpoints ?? ALL_ENDPOINT_NAMES;
+    return protectedNames.includes(endpointName) ? [cfg.authPreProcess] : [];
+  }
+
   setupEndpoints(): void {
     /* if (!this.getErrorDataService) {
       throw new DyFM_Error({
@@ -69,6 +163,7 @@ export abstract class DyNTS_Errors_Controller<
         name: 'logError',
         type: DyFM_HttpCallType.post,
         endpoint: '/error/log',
+        preProcesses: this.getPreProcessesFor('logError'),
         tasks: [
           async (req: Request, res: Response, issuer: string = 'unknown-issuer'): Promise<void> => {
             const error_CS: T_Error_ControlService = this.getError_ControlService({
@@ -87,6 +182,7 @@ export abstract class DyNTS_Errors_Controller<
         name: 'newError',
         type: DyFM_HttpCallType.post,
         endpoint: '/error/new',
+        preProcesses: this.getPreProcessesFor('newError'),
         tasks: [
           async (req: Request, res: Response, issuer: string = 'unknown-issuer'): Promise<void> => {
             const error_CS: T_Error_ControlService = this.getError_ControlService({
@@ -106,6 +202,7 @@ export abstract class DyNTS_Errors_Controller<
         name: 'markErrorDone',
         type: DyFM_HttpCallType.get,
         endpoint: '/error/mark-done/:errorId',
+        preProcesses: this.getPreProcessesFor('markErrorDone'),
         tasks: [
           async (req: Request, res: Response, issuer: string = 'unknown-issuer'): Promise<void> => {
             const error_CS: T_Error_ControlService = this.getError_ControlService({
@@ -125,6 +222,7 @@ export abstract class DyNTS_Errors_Controller<
         name: 'markAllErrorDone',
         type: DyFM_HttpCallType.get,
         endpoint: '/error/mark-all-done',
+        preProcesses: this.getPreProcessesFor('markAllErrorDone'),
         tasks: [
           async (req: Request, res: Response, issuer: string = 'unknown-issuer'): Promise<void> => {
             const error_CS: T_Error_ControlService = this.getError_ControlService({
@@ -164,6 +262,7 @@ export abstract class DyNTS_Errors_Controller<
         name: 'getErrors',
         type: DyFM_HttpCallType.get,
         endpoint: '/error/get-range/:range',
+        preProcesses: this.getPreProcessesFor('getErrors'),
         tasks: [
           async (req: Request, res: Response, issuer: string = 'unknown-issuer') : Promise<void> => {
             const error_CS: T_Error_ControlService = this.getError_ControlService({
@@ -184,6 +283,7 @@ export abstract class DyNTS_Errors_Controller<
         name: 'getErrorsPaged',
         type: DyFM_HttpCallType.get,
         endpoint: '/error/get-paged/:range/:pageSize/:pageIndex',
+        preProcesses: this.getPreProcessesFor('getErrorsPaged'),
         tasks: [
           async (req: Request, res: Response, issuer: string = 'unknown-issuer') : Promise<void> => {
             const error_CS: T_Error_ControlService = this.getError_ControlService({
@@ -215,6 +315,7 @@ export abstract class DyNTS_Errors_Controller<
         name: 'getLastErrors',
         type: DyFM_HttpCallType.get,
         endpoint: '/error/get-last-paged/:range/:pageSize/:pageIndex',
+        preProcesses: this.getPreProcessesFor('getLastErrors'),
         tasks: [
           async (req: Request, res: Response, issuer: string = 'unknown-issuer') : Promise<void> => {
             const error_CS: T_Error_ControlService = this.getError_ControlService({
@@ -246,6 +347,7 @@ export abstract class DyNTS_Errors_Controller<
         name: 'searchErrors',
         type: DyFM_HttpCallType.get,
         endpoint: '/error/search',
+        preProcesses: this.getPreProcessesFor('searchErrors'),
         tasks: [
           async (req: Request, res: Response, issuer: string = 'unknown-issuer') : Promise<void> => {
             const error_CS: T_Error_ControlService = this.getError_ControlService({