@futdevpro/nts-dynamo 1.15.136 → 1.15.139

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

@@ -1,559 +1,559 @@
-
-import { Request, Response } from 'express';
-
-import { DyFM_Array, DyFM_Error, DyFM_HttpCallType, DyFM_Errors, DyFM_RelativeDate } 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';
-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: lasd `ALL_ENDPOINT_NAMES` (logError, newError, markErrorDone,
-   * markAllErrorDone, recordFixAttempt, resolveError, getErrors, getErrorsPaged,
-   * getErrorsByCategoryPaged, getErrorsByStatusPaged, getLastErrors, searchErrors).
-   */
-  protectedEndpoints?: string[];
-
-  /**
-   * OPCIONALIS gyengebb-credential kapu az OLVASO endpointokra
-   * (`DyNTS_ERRORS_READ_ENDPOINTS`).
-   *
-   * MIERT (2026-08-07): a `configure()` eddig EGYETLEN `authPreProcess`-t engedett az OSSZES
-   * vedett endpointra — olvasokra ES irokra egyarant. Emiatt a host-app nem tudott kulon,
-   * gyengebb (pl. read-scope-u) credentialt elfogadni a hibalista OLVASASAHOZ anelkul, hogy
-   * ugyanaz a credential a TORLO endpointokat (`markErrorDone` / `markAllErrorDone` /
-   * `resolveError`) is megnyitna => jogosultsag-eszkalacio.
-   *
-   * A korabbi kerulout az volt, hogy a host-app URL-UTVONALRA illesztve ujra-szarmaztatta,
-   * melyik endpoint olvas — ami DUPLIKALTA az itteni endpoint-listat es a read/ir szemantikat
-   * (SSOT-sertes: az endpointjait a controller ismeri, nem a hivo). Ezert a szetvalasztas
-   * ITT, a tulajdonosnal el.
-   *
-   * Ha meg van adva, az OLVASO endpointok EZT hasznaljak az `authPreProcess` helyett; minden
-   * mas vedett endpoint valtozatlanul az `authPreProcess`-t. Ha hianyzik, a viselkedes
-   * PONTOSAN a regi (minden vedett endpoint az `authPreProcess`-t kapja) — backward-compatible.
-   */
-  readAuthPreProcess?: (req: Request, res: Response) => Promise<void>;
-}
-
-
-/**
- * IRO (allapot-valtoztato) built-in endpointok.
- *
- * A read/ir szetvalasztas SSOT-ja: a controller sajat maga deklaralja az endpointjait, ezert
- * o tudja, melyik melyik. A hivo host-app SOHA ne szarmaztassa ujra (pl. URL-mintabol).
- */
-export const DyNTS_ERRORS_WRITE_ENDPOINTS: string[] = [
-  'logError', 'newError',
-  'markErrorDone', 'markAllErrorDone',
-  'recordFixAttempt', 'resolveError',
-];
-
-/** OLVASO (csak lekerdezo) built-in endpointok. Lasd `DyNTS_ERRORS_WRITE_ENDPOINTS`. */
-export const DyNTS_ERRORS_READ_ENDPOINTS: string[] = [
-  'getErrors', 'getErrorsPaged', 'getErrorsByCategoryPaged', 'getErrorsByStatusPaged', 'getLastErrors',
-  'searchErrors',
-];
-
-/**
- * Az osszes built-in endpoint neve — a `configure({ protectedEndpoints })`
- * default-jat es a config validacio-t segiti.
- *
- * SZARMAZTATOTT, NEM kezzel karbantartott: a ket fenti lista osszege. Igy egy uj endpoint
- * felvetelekor nem lehet elfelejteni beirni ide (a ket lista az egyetlen igazsag-forras).
- */
-const ALL_ENDPOINT_NAMES: string[] = [...DyNTS_ERRORS_WRITE_ENDPOINTS, ...DyNTS_ERRORS_READ_ENDPOINTS];
-
-/**
- * Endpoints:
- * 
- * logError
- * POST /error/log
- * 
- * markErrorDone  
- * GET /error/mark-done/:errorId
- * 
- * markAllErrorDone
- * GET /error/mark-all-done
- * 
- * getErrors  
- * GET /error/get-range/:range
- * 
- * getErrorsPaged
- * GET /error/get-paged/:range/:pageSize/:pageIndex
- * 
- * getLastErrors
- * GET /error/get-last-paged/:range/:pageSize/:pageIndex
- * 
- *  
- */
-// Documentation: 
-// Local: [MD](./errors.md)
-// 
-export abstract class DyNTS_Errors_Controller<
-  T_Error extends DyFM_Error,
-  T_Errors extends DyFM_Errors<T_Error>,
-  T_Error_ControlService extends DyNTS_Errors_ControlService<T_Error, T_Errors>
-> extends DyNTS_Controller {
-
-  /* static getInstance(): DyNTS_Error_Controller {
-    return DyNTS_Error_Controller.getSingletonInstance();
-  } */
-
-  /* protected abstract errorDataService: DyNTS_Error_DataService<T_Error>; */
-  protected abstract getError_ControlService(
-    set: { data?: T_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 {
-    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;
-    if (!protectedNames.includes(endpointName)) { return []; }
-
-    // 2026-08-07 — opcionalis read/ir szetvalasztas. A dontes ENDPOINT-NEV alapjan tortenik (a
-    // controller sajat SSOT-ja), NEM URL-mintabol. Ha a host-app nem ad `readAuthPreProcess`-t,
-    // a viselkedes valtozatlan: minden vedett endpoint az `authPreProcess`-t kapja.
-    if (cfg.readAuthPreProcess && DyNTS_ERRORS_READ_ENDPOINTS.includes(endpointName)) {
-      return [cfg.readAuthPreProcess];
-    }
-    return [cfg.authPreProcess];
-  }
-
-  /**
-   * FR-263 (2026-06-26) — LAZY, REQUEST-IDŐBEN kiértékelt guard-wrapper.
-   *
-   * GYÖKÉR-OK: a `setupEndpoints()` a controller ELSŐ konstrukciójakor fut, ami a built-in
-   * error-controllernél a host-app `configure()`-ja ELŐTT történhet (a framework korán példányosítja
-   * a singletont). Ilyenkor a `getPreProcessesFor()` még az ÜRES configot olvasta → a guard SOHA nem
-   * kötődött → az admin error-read endpoint-ok (`get-range`, `get-paged`, …) token nélkül **200**-at
-   * adtak vissza, kiszivárogtatva a belső error-logot (info-disclosure). A 39 másik (controller-szinten
-   * HARDCODE-olt) guard azért működött, mert nem függ a `configure()` időzítésétől.
-   *
-   * FIX: a `preProcesses` egy wrapper, ami a configot KÉRÉS-IDŐBEN olvassa (`getPreProcessesFor`), így
-   * a `configure()` SORREND-FÜGGETLEN — bármikor hívható az első kérés előtt. A 401-et a VALÓDI guard
-   * küldi; `res.headersSent`-re leállunk (nincs dupla-send), és nem-védett endpointnál no-op (átenged).
-   */
-  protected lazyPreProcessesFor(endpointName: string): ((req: Request, res: Response) => Promise<void>)[] {
-    return [
-      async (req: Request, res: Response): Promise<void> => {
-        const guards: ((req: Request, res: Response) => Promise<void>)[] = this.getPreProcessesFor(endpointName);
-        for (const guard of guards) {
-          if (res.headersSent) { return; }
-          await guard(req, res);
-        }
-      },
-    ];
-  }
-
-  setupEndpoints(): void {
-    /* if (!this.getErrorDataService) {
-      throw new DyFM_Error({
-        message: 'getUserDataService() method not implemented in Error_Controller.',
-        errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-ERC-001`,
-      });
-    } */
-
-    if (!this.additionalEndpoints) {
-      throw new DyFM_Error({
-        message: 'additionalEndpoints must be defined in Error_Controller.',
-        errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-ERC-002`,
-      });
-    }
-
-    this.endpoints = [
-      new DyNTS_Endpoint_Params({
-        name: 'logError',
-        type: DyFM_HttpCallType.post,
-        endpoint: '/error/log',
-        preProcesses: this.lazyPreProcessesFor('logError'),
-        tasks: [
-          async (req: Request, res: Response, issuer: string = 'unknown-issuer'): Promise<void> => {
-            const error_CS: T_Error_ControlService = this.getError_ControlService({
-              issuer,
-            });
-
-            await error_CS.recordError(req.body, issuer);
-
-            res.send({
-              result: 'error logged',
-            });
-          },
-        ],
-      }),
-      new DyNTS_Endpoint_Params({
-        name: 'newError',
-        type: DyFM_HttpCallType.post,
-        endpoint: '/error/new',
-        preProcesses: this.lazyPreProcessesFor('newError'),
-        tasks: [
-          async (req: Request, res: Response, issuer: string = 'unknown-issuer'): Promise<void> => {
-            const error_CS: T_Error_ControlService = this.getError_ControlService({
-              issuer,
-            });
-
-            await error_CS.recordError(req.body, issuer);
-
-            res.send({
-              result: 'error logged',
-            });
-          },
-        ],
-      }),
-
-      new DyNTS_Endpoint_Params({
-        name: 'markErrorDone',
-        type: DyFM_HttpCallType.get,
-        endpoint: '/error/mark-done/:errorId',
-        preProcesses: this.lazyPreProcessesFor('markErrorDone'),
-        tasks: [
-          async (req: Request, res: Response, issuer: string = 'unknown-issuer'): Promise<void> => {
-            const error_CS: T_Error_ControlService = this.getError_ControlService({
-              issuer,
-            });
-  
-            await error_CS.deleteError(req.params.errorId, issuer, true);
-  
-            res.send({
-              result: 'error deleted',
-            });
-          },
-        ],
-      }),
-      
-      new DyNTS_Endpoint_Params({
-        name: 'markAllErrorDone',
-        type: DyFM_HttpCallType.get,
-        endpoint: '/error/mark-all-done',
-        preProcesses: this.lazyPreProcessesFor('markAllErrorDone'),
-        tasks: [
-          async (req: Request, res: Response, issuer: string = 'unknown-issuer'): Promise<void> => {
-            const error_CS: T_Error_ControlService = this.getError_ControlService({
-              issuer,
-            });
-
-            await error_CS.deleteAllErrors(issuer, true);
-
-            res.send({
-              result: 'all error deleted',
-            });
-          },
-        ],
-      }),
-
-      new DyNTS_Endpoint_Params({
-        name: 'recordFixAttempt',
-        type: DyFM_HttpCallType.post,
-        endpoint: '/error/:errorId/fix-attempt',
-        preProcesses: this.lazyPreProcessesFor('recordFixAttempt'),
-        tasks: [
-          async (req: Request, res: Response, issuer: string = 'unknown-issuer'): Promise<void> => {
-            const errorId: string = req.params.errorId;
-            const version: string = req.body?.version;
-            const hypothesis: string = req.body?.hypothesis;
-            const notes: string = req.body?.notes;
-
-            if (!errorId || !version || !hypothesis) {
-              res.status(400).send({
-                error: 'missing required field(s): errorId / version / hypothesis',
-              });
-              return;
-            }
-
-            const error_CS: T_Error_ControlService = this.getError_ControlService({ issuer });
-            const attempt = await error_CS.recordFixAttempt(errorId, version, hypothesis, issuer, notes);
-
-            res.send({
-              result: 'fix attempt recorded',
-              attempt,
-            });
-          },
-        ],
-      }),
-
-      new DyNTS_Endpoint_Params({
-        name: 'resolveError',
-        type: DyFM_HttpCallType.post,
-        endpoint: '/error/:errorId/resolve',
-        preProcesses: this.lazyPreProcessesFor('resolveError'),
-        tasks: [
-          async (req: Request, res: Response, issuer: string = 'unknown-issuer'): Promise<void> => {
-            const errorId: string = req.params.errorId;
-            const notes: string = req.body?.notes;
-
-            if (!errorId) {
-              res.status(400).send({
-                error: 'missing required field: errorId',
-              });
-              return;
-            }
-
-            const error_CS: T_Error_ControlService = this.getError_ControlService({ issuer });
-            await error_CS.resolveError(errorId, issuer, notes);
-
-            res.send({
-              result: 'error resolved',
-            });
-          },
-        ],
-      }),
-
-      /* new DyNTS_Endpoint_Params({
-        name: 'markErrorDone',
-        type: DyFM_HttpCallType.get,
-        endpoint: '/mark-error-done/:errorId',
-        tasks: [
-          async (req: Request, res: Response, issuer?: string): Promise<void> => {
-            const errorDataService: DyNTS_Error_DataService<Error_T> = this.getErrorDataService({
-              data: { _id: req.params.errorId },
-              issuer: issuer,
-            });
-
-            await errorDataService.deleteData();
-
-            res.send({
-              result: 'error deleted',
-            });
-          },
-        ],
-      }), */
-
-      new DyNTS_Endpoint_Params({
-        name: 'getErrors',
-        type: DyFM_HttpCallType.get,
-        endpoint: '/error/get-range/:range',
-        preProcesses: this.lazyPreProcessesFor('getErrors'),
-        tasks: [
-          async (req: Request, res: Response, issuer: string = 'unknown-issuer') : Promise<void> => {
-            const error_CS: T_Error_ControlService = this.getError_ControlService({
-              issuer,
-            });
-
-            res.send(
-              await error_CS.getErrorsInRange(
-                req.params.range as DyFM_RelativeDate, 
-                issuer
-              )
-            );
-          },
-        ],
-      }),
-
-      new DyNTS_Endpoint_Params({
-        name: 'getErrorsPaged',
-        type: DyFM_HttpCallType.get,
-        endpoint: '/error/get-paged/:range/:pageSize/:pageIndex',
-        preProcesses: this.lazyPreProcessesFor('getErrorsPaged'),
-        tasks: [
-          async (req: Request, res: Response, issuer: string = 'unknown-issuer') : Promise<void> => {
-            const error_CS: T_Error_ControlService = this.getError_ControlService({
-              issuer,
-            });
-
-            let pageSize: number = req.params.pageSize ? +req.params.pageSize : 30;
-            let pageIndex: number = req.params.pageIndex ? +req.params.pageIndex : 0;
-
-            // TODO: temporary fix for too big error list loads
-            if (30 < pageSize) {
-              pageSize = 30;
-              pageIndex = 0;
-            }
-
-            res.send(
-              await error_CS.getErrorsPaged(
-                req.params.range as DyFM_RelativeDate, 
-                pageSize, 
-                pageIndex,
-                issuer
-              )
-            );
-          },
-        ],
-      }),
-
-      new DyNTS_Endpoint_Params({
-        name: 'getErrorsByCategoryPaged',
-        type: DyFM_HttpCallType.get,
-        endpoint: '/error/get-by-category/:category/:range/:pageSize/:pageIndex',
-        preProcesses: this.lazyPreProcessesFor('getErrorsByCategoryPaged'),
-        tasks: [
-          async (req: Request, res: Response, issuer: string = 'unknown-issuer'): Promise<void> => {
-            const error_CS: T_Error_ControlService = this.getError_ControlService({ issuer });
-
-            let pageSize: number = req.params.pageSize ? +req.params.pageSize : 30;
-            let pageIndex: number = req.params.pageIndex ? +req.params.pageIndex : 0;
-            if (30 < pageSize) {
-              pageSize = 30;
-              pageIndex = 0;
-            }
-
-            res.send(
-              await error_CS.getErrorsByCategoryPaged(
-                req.params.category,
-                req.params.range as DyFM_RelativeDate,
-                pageSize,
-                pageIndex,
-                issuer
-              )
-            );
-          },
-        ],
-      }),
-
-      new DyNTS_Endpoint_Params({
-        name: 'getErrorsByStatusPaged',
-        type: DyFM_HttpCallType.get,
-        endpoint: '/error/get-by-status/:status/:range/:pageSize/:pageIndex',
-        preProcesses: this.lazyPreProcessesFor('getErrorsByStatusPaged'),
-        tasks: [
-          async (req: Request, res: Response, issuer: string = 'unknown-issuer'): Promise<void> => {
-            const error_CS: T_Error_ControlService = this.getError_ControlService({ issuer });
-
-            let pageSize: number = req.params.pageSize ? +req.params.pageSize : 30;
-            let pageIndex: number = req.params.pageIndex ? +req.params.pageIndex : 0;
-            if (30 < pageSize) {
-              pageSize = 30;
-              pageIndex = 0;
-            }
-
-            res.send(
-              await error_CS.getErrorsByStatusPaged(
-                req.params.status,
-                req.params.range as DyFM_RelativeDate,
-                pageSize,
-                pageIndex,
-                issuer
-              )
-            );
-          },
-        ],
-      }),
-
-      new DyNTS_Endpoint_Params({
-        name: 'getLastErrors',
-        type: DyFM_HttpCallType.get,
-        endpoint: '/error/get-last-paged/:range/:pageSize/:pageIndex',
-        preProcesses: this.lazyPreProcessesFor('getLastErrors'),
-        tasks: [
-          async (req: Request, res: Response, issuer: string = 'unknown-issuer') : Promise<void> => {
-            const error_CS: T_Error_ControlService = this.getError_ControlService({
-              issuer,
-            });
-
-            let pageSize: number = req.params.pageSize ? +req.params.pageSize : 30;
-            let pageIndex: number = req.params.pageIndex ? +req.params.pageIndex : 0;
-
-            // TODO: temporary fix for too big error list loads
-            if (30 < pageSize) {
-              pageSize = 30;
-              pageIndex = 0;
-            }
-
-            res.send(
-              await error_CS.getLastErrors(
-                req.params.range as DyFM_RelativeDate, 
-                pageSize, 
-                pageIndex,
-                issuer
-              )
-            );
-          },
-        ],
-      }),
-
-      new DyNTS_Endpoint_Params({
-        name: 'searchErrors',
-        type: DyFM_HttpCallType.get,
-        endpoint: '/error/search',
-        preProcesses: this.lazyPreProcessesFor('searchErrors'),
-        tasks: [
-          async (req: Request, res: Response, issuer: string = 'unknown-issuer') : Promise<void> => {
-            const error_CS: T_Error_ControlService = this.getError_ControlService({
-              issuer,
-            });
-
-            res.send(
-              await error_CS.searchErrors(req.body, issuer)
-            );
-          },
-        ],
-      }),
-
-      ...this.additionalEndpoints,
-    ];
-  }
-}
-
-
-
-
-
+
+import { Request, Response } from 'express';
+
+import { DyFM_Array, DyFM_Error, DyFM_HttpCallType, DyFM_Errors, DyFM_RelativeDate } 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';
+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: lasd `ALL_ENDPOINT_NAMES` (logError, newError, markErrorDone,
+   * markAllErrorDone, recordFixAttempt, resolveError, getErrors, getErrorsPaged,
+   * getErrorsByCategoryPaged, getErrorsByStatusPaged, getLastErrors, searchErrors).
+   */
+  protectedEndpoints?: string[];
+
+  /**
+   * OPCIONALIS gyengebb-credential kapu az OLVASO endpointokra
+   * (`DyNTS_ERRORS_READ_ENDPOINTS`).
+   *
+   * MIERT (2026-08-07): a `configure()` eddig EGYETLEN `authPreProcess`-t engedett az OSSZES
+   * vedett endpointra — olvasokra ES irokra egyarant. Emiatt a host-app nem tudott kulon,
+   * gyengebb (pl. read-scope-u) credentialt elfogadni a hibalista OLVASASAHOZ anelkul, hogy
+   * ugyanaz a credential a TORLO endpointokat (`markErrorDone` / `markAllErrorDone` /
+   * `resolveError`) is megnyitna => jogosultsag-eszkalacio.
+   *
+   * A korabbi kerulout az volt, hogy a host-app URL-UTVONALRA illesztve ujra-szarmaztatta,
+   * melyik endpoint olvas — ami DUPLIKALTA az itteni endpoint-listat es a read/ir szemantikat
+   * (SSOT-sertes: az endpointjait a controller ismeri, nem a hivo). Ezert a szetvalasztas
+   * ITT, a tulajdonosnal el.
+   *
+   * Ha meg van adva, az OLVASO endpointok EZT hasznaljak az `authPreProcess` helyett; minden
+   * mas vedett endpoint valtozatlanul az `authPreProcess`-t. Ha hianyzik, a viselkedes
+   * PONTOSAN a regi (minden vedett endpoint az `authPreProcess`-t kapja) — backward-compatible.
+   */
+  readAuthPreProcess?: (req: Request, res: Response) => Promise<void>;
+}
+
+
+/**
+ * IRO (allapot-valtoztato) built-in endpointok.
+ *
+ * A read/ir szetvalasztas SSOT-ja: a controller sajat maga deklaralja az endpointjait, ezert
+ * o tudja, melyik melyik. A hivo host-app SOHA ne szarmaztassa ujra (pl. URL-mintabol).
+ */
+export const DyNTS_ERRORS_WRITE_ENDPOINTS: string[] = [
+  'logError', 'newError',
+  'markErrorDone', 'markAllErrorDone',
+  'recordFixAttempt', 'resolveError',
+];
+
+/** OLVASO (csak lekerdezo) built-in endpointok. Lasd `DyNTS_ERRORS_WRITE_ENDPOINTS`. */
+export const DyNTS_ERRORS_READ_ENDPOINTS: string[] = [
+  'getErrors', 'getErrorsPaged', 'getErrorsByCategoryPaged', 'getErrorsByStatusPaged', 'getLastErrors',
+  'searchErrors',
+];
+
+/**
+ * Az osszes built-in endpoint neve — a `configure({ protectedEndpoints })`
+ * default-jat es a config validacio-t segiti.
+ *
+ * SZARMAZTATOTT, NEM kezzel karbantartott: a ket fenti lista osszege. Igy egy uj endpoint
+ * felvetelekor nem lehet elfelejteni beirni ide (a ket lista az egyetlen igazsag-forras).
+ */
+const ALL_ENDPOINT_NAMES: string[] = [...DyNTS_ERRORS_WRITE_ENDPOINTS, ...DyNTS_ERRORS_READ_ENDPOINTS];
+
+/**
+ * Endpoints:
+ * 
+ * logError
+ * POST /error/log
+ * 
+ * markErrorDone  
+ * GET /error/mark-done/:errorId
+ * 
+ * markAllErrorDone
+ * GET /error/mark-all-done
+ * 
+ * getErrors  
+ * GET /error/get-range/:range
+ * 
+ * getErrorsPaged
+ * GET /error/get-paged/:range/:pageSize/:pageIndex
+ * 
+ * getLastErrors
+ * GET /error/get-last-paged/:range/:pageSize/:pageIndex
+ * 
+ *  
+ */
+// Documentation: 
+// Local: [MD](./errors.md)
+// 
+export abstract class DyNTS_Errors_Controller<
+  T_Error extends DyFM_Error,
+  T_Errors extends DyFM_Errors<T_Error>,
+  T_Error_ControlService extends DyNTS_Errors_ControlService<T_Error, T_Errors>
+> extends DyNTS_Controller {
+
+  /* static getInstance(): DyNTS_Error_Controller {
+    return DyNTS_Error_Controller.getSingletonInstance();
+  } */
+
+  /* protected abstract errorDataService: DyNTS_Error_DataService<T_Error>; */
+  protected abstract getError_ControlService(
+    set: { data?: T_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 {
+    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;
+    if (!protectedNames.includes(endpointName)) { return []; }
+
+    // 2026-08-07 — opcionalis read/ir szetvalasztas. A dontes ENDPOINT-NEV alapjan tortenik (a
+    // controller sajat SSOT-ja), NEM URL-mintabol. Ha a host-app nem ad `readAuthPreProcess`-t,
+    // a viselkedes valtozatlan: minden vedett endpoint az `authPreProcess`-t kapja.
+    if (cfg.readAuthPreProcess && DyNTS_ERRORS_READ_ENDPOINTS.includes(endpointName)) {
+      return [cfg.readAuthPreProcess];
+    }
+    return [cfg.authPreProcess];
+  }
+
+  /**
+   * FR-263 (2026-06-26) — LAZY, REQUEST-IDŐBEN kiértékelt guard-wrapper.
+   *
+   * GYÖKÉR-OK: a `setupEndpoints()` a controller ELSŐ konstrukciójakor fut, ami a built-in
+   * error-controllernél a host-app `configure()`-ja ELŐTT történhet (a framework korán példányosítja
+   * a singletont). Ilyenkor a `getPreProcessesFor()` még az ÜRES configot olvasta → a guard SOHA nem
+   * kötődött → az admin error-read endpoint-ok (`get-range`, `get-paged`, …) token nélkül **200**-at
+   * adtak vissza, kiszivárogtatva a belső error-logot (info-disclosure). A 39 másik (controller-szinten
+   * HARDCODE-olt) guard azért működött, mert nem függ a `configure()` időzítésétől.
+   *
+   * FIX: a `preProcesses` egy wrapper, ami a configot KÉRÉS-IDŐBEN olvassa (`getPreProcessesFor`), így
+   * a `configure()` SORREND-FÜGGETLEN — bármikor hívható az első kérés előtt. A 401-et a VALÓDI guard
+   * küldi; `res.headersSent`-re leállunk (nincs dupla-send), és nem-védett endpointnál no-op (átenged).
+   */
+  protected lazyPreProcessesFor(endpointName: string): ((req: Request, res: Response) => Promise<void>)[] {
+    return [
+      async (req: Request, res: Response): Promise<void> => {
+        const guards: ((req: Request, res: Response) => Promise<void>)[] = this.getPreProcessesFor(endpointName);
+        for (const guard of guards) {
+          if (res.headersSent) { return; }
+          await guard(req, res);
+        }
+      },
+    ];
+  }
+
+  setupEndpoints(): void {
+    /* if (!this.getErrorDataService) {
+      throw new DyFM_Error({
+        message: 'getUserDataService() method not implemented in Error_Controller.',
+        errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-ERC-001`,
+      });
+    } */
+
+    if (!this.additionalEndpoints) {
+      throw new DyFM_Error({
+        message: 'additionalEndpoints must be defined in Error_Controller.',
+        errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-ERC-002`,
+      });
+    }
+
+    this.endpoints = [
+      new DyNTS_Endpoint_Params({
+        name: 'logError',
+        type: DyFM_HttpCallType.post,
+        endpoint: '/error/log',
+        preProcesses: this.lazyPreProcessesFor('logError'),
+        tasks: [
+          async (req: Request, res: Response, issuer: string = 'unknown-issuer'): Promise<void> => {
+            const error_CS: T_Error_ControlService = this.getError_ControlService({
+              issuer,
+            });
+
+            await error_CS.recordError(req.body, issuer);
+
+            res.send({
+              result: 'error logged',
+            });
+          },
+        ],
+      }),
+      new DyNTS_Endpoint_Params({
+        name: 'newError',
+        type: DyFM_HttpCallType.post,
+        endpoint: '/error/new',
+        preProcesses: this.lazyPreProcessesFor('newError'),
+        tasks: [
+          async (req: Request, res: Response, issuer: string = 'unknown-issuer'): Promise<void> => {
+            const error_CS: T_Error_ControlService = this.getError_ControlService({
+              issuer,
+            });
+
+            await error_CS.recordError(req.body, issuer);
+
+            res.send({
+              result: 'error logged',
+            });
+          },
+        ],
+      }),
+
+      new DyNTS_Endpoint_Params({
+        name: 'markErrorDone',
+        type: DyFM_HttpCallType.get,
+        endpoint: '/error/mark-done/:errorId',
+        preProcesses: this.lazyPreProcessesFor('markErrorDone'),
+        tasks: [
+          async (req: Request, res: Response, issuer: string = 'unknown-issuer'): Promise<void> => {
+            const error_CS: T_Error_ControlService = this.getError_ControlService({
+              issuer,
+            });
+  
+            await error_CS.deleteError(req.params.errorId, issuer, true);
+  
+            res.send({
+              result: 'error deleted',
+            });
+          },
+        ],
+      }),
+      
+      new DyNTS_Endpoint_Params({
+        name: 'markAllErrorDone',
+        type: DyFM_HttpCallType.get,
+        endpoint: '/error/mark-all-done',
+        preProcesses: this.lazyPreProcessesFor('markAllErrorDone'),
+        tasks: [
+          async (req: Request, res: Response, issuer: string = 'unknown-issuer'): Promise<void> => {
+            const error_CS: T_Error_ControlService = this.getError_ControlService({
+              issuer,
+            });
+
+            await error_CS.deleteAllErrors(issuer, true);
+
+            res.send({
+              result: 'all error deleted',
+            });
+          },
+        ],
+      }),
+
+      new DyNTS_Endpoint_Params({
+        name: 'recordFixAttempt',
+        type: DyFM_HttpCallType.post,
+        endpoint: '/error/:errorId/fix-attempt',
+        preProcesses: this.lazyPreProcessesFor('recordFixAttempt'),
+        tasks: [
+          async (req: Request, res: Response, issuer: string = 'unknown-issuer'): Promise<void> => {
+            const errorId: string = req.params.errorId;
+            const version: string = req.body?.version;
+            const hypothesis: string = req.body?.hypothesis;
+            const notes: string = req.body?.notes;
+
+            if (!errorId || !version || !hypothesis) {
+              res.status(400).send({
+                error: 'missing required field(s): errorId / version / hypothesis',
+              });
+              return;
+            }
+
+            const error_CS: T_Error_ControlService = this.getError_ControlService({ issuer });
+            const attempt = await error_CS.recordFixAttempt(errorId, version, hypothesis, issuer, notes);
+
+            res.send({
+              result: 'fix attempt recorded',
+              attempt,
+            });
+          },
+        ],
+      }),
+
+      new DyNTS_Endpoint_Params({
+        name: 'resolveError',
+        type: DyFM_HttpCallType.post,
+        endpoint: '/error/:errorId/resolve',
+        preProcesses: this.lazyPreProcessesFor('resolveError'),
+        tasks: [
+          async (req: Request, res: Response, issuer: string = 'unknown-issuer'): Promise<void> => {
+            const errorId: string = req.params.errorId;
+            const notes: string = req.body?.notes;
+
+            if (!errorId) {
+              res.status(400).send({
+                error: 'missing required field: errorId',
+              });
+              return;
+            }
+
+            const error_CS: T_Error_ControlService = this.getError_ControlService({ issuer });
+            await error_CS.resolveError(errorId, issuer, notes);
+
+            res.send({
+              result: 'error resolved',
+            });
+          },
+        ],
+      }),
+
+      /* new DyNTS_Endpoint_Params({
+        name: 'markErrorDone',
+        type: DyFM_HttpCallType.get,
+        endpoint: '/mark-error-done/:errorId',
+        tasks: [
+          async (req: Request, res: Response, issuer?: string): Promise<void> => {
+            const errorDataService: DyNTS_Error_DataService<Error_T> = this.getErrorDataService({
+              data: { _id: req.params.errorId },
+              issuer: issuer,
+            });
+
+            await errorDataService.deleteData();
+
+            res.send({
+              result: 'error deleted',
+            });
+          },
+        ],
+      }), */
+
+      new DyNTS_Endpoint_Params({
+        name: 'getErrors',
+        type: DyFM_HttpCallType.get,
+        endpoint: '/error/get-range/:range',
+        preProcesses: this.lazyPreProcessesFor('getErrors'),
+        tasks: [
+          async (req: Request, res: Response, issuer: string = 'unknown-issuer') : Promise<void> => {
+            const error_CS: T_Error_ControlService = this.getError_ControlService({
+              issuer,
+            });
+
+            res.send(
+              await error_CS.getErrorsInRange(
+                req.params.range as DyFM_RelativeDate, 
+                issuer
+              )
+            );
+          },
+        ],
+      }),
+
+      new DyNTS_Endpoint_Params({
+        name: 'getErrorsPaged',
+        type: DyFM_HttpCallType.get,
+        endpoint: '/error/get-paged/:range/:pageSize/:pageIndex',
+        preProcesses: this.lazyPreProcessesFor('getErrorsPaged'),
+        tasks: [
+          async (req: Request, res: Response, issuer: string = 'unknown-issuer') : Promise<void> => {
+            const error_CS: T_Error_ControlService = this.getError_ControlService({
+              issuer,
+            });
+
+            let pageSize: number = req.params.pageSize ? +req.params.pageSize : 30;
+            let pageIndex: number = req.params.pageIndex ? +req.params.pageIndex : 0;
+
+            // TODO: temporary fix for too big error list loads
+            if (30 < pageSize) {
+              pageSize = 30;
+              pageIndex = 0;
+            }
+
+            res.send(
+              await error_CS.getErrorsPaged(
+                req.params.range as DyFM_RelativeDate, 
+                pageSize, 
+                pageIndex,
+                issuer
+              )
+            );
+          },
+        ],
+      }),
+
+      new DyNTS_Endpoint_Params({
+        name: 'getErrorsByCategoryPaged',
+        type: DyFM_HttpCallType.get,
+        endpoint: '/error/get-by-category/:category/:range/:pageSize/:pageIndex',
+        preProcesses: this.lazyPreProcessesFor('getErrorsByCategoryPaged'),
+        tasks: [
+          async (req: Request, res: Response, issuer: string = 'unknown-issuer'): Promise<void> => {
+            const error_CS: T_Error_ControlService = this.getError_ControlService({ issuer });
+
+            let pageSize: number = req.params.pageSize ? +req.params.pageSize : 30;
+            let pageIndex: number = req.params.pageIndex ? +req.params.pageIndex : 0;
+            if (30 < pageSize) {
+              pageSize = 30;
+              pageIndex = 0;
+            }
+
+            res.send(
+              await error_CS.getErrorsByCategoryPaged(
+                req.params.category,
+                req.params.range as DyFM_RelativeDate,
+                pageSize,
+                pageIndex,
+                issuer
+              )
+            );
+          },
+        ],
+      }),
+
+      new DyNTS_Endpoint_Params({
+        name: 'getErrorsByStatusPaged',
+        type: DyFM_HttpCallType.get,
+        endpoint: '/error/get-by-status/:status/:range/:pageSize/:pageIndex',
+        preProcesses: this.lazyPreProcessesFor('getErrorsByStatusPaged'),
+        tasks: [
+          async (req: Request, res: Response, issuer: string = 'unknown-issuer'): Promise<void> => {
+            const error_CS: T_Error_ControlService = this.getError_ControlService({ issuer });
+
+            let pageSize: number = req.params.pageSize ? +req.params.pageSize : 30;
+            let pageIndex: number = req.params.pageIndex ? +req.params.pageIndex : 0;
+            if (30 < pageSize) {
+              pageSize = 30;
+              pageIndex = 0;
+            }
+
+            res.send(
+              await error_CS.getErrorsByStatusPaged(
+                req.params.status,
+                req.params.range as DyFM_RelativeDate,
+                pageSize,
+                pageIndex,
+                issuer
+              )
+            );
+          },
+        ],
+      }),
+
+      new DyNTS_Endpoint_Params({
+        name: 'getLastErrors',
+        type: DyFM_HttpCallType.get,
+        endpoint: '/error/get-last-paged/:range/:pageSize/:pageIndex',
+        preProcesses: this.lazyPreProcessesFor('getLastErrors'),
+        tasks: [
+          async (req: Request, res: Response, issuer: string = 'unknown-issuer') : Promise<void> => {
+            const error_CS: T_Error_ControlService = this.getError_ControlService({
+              issuer,
+            });
+
+            let pageSize: number = req.params.pageSize ? +req.params.pageSize : 30;
+            let pageIndex: number = req.params.pageIndex ? +req.params.pageIndex : 0;
+
+            // TODO: temporary fix for too big error list loads
+            if (30 < pageSize) {
+              pageSize = 30;
+              pageIndex = 0;
+            }
+
+            res.send(
+              await error_CS.getLastErrors(
+                req.params.range as DyFM_RelativeDate, 
+                pageSize, 
+                pageIndex,
+                issuer
+              )
+            );
+          },
+        ],
+      }),
+
+      new DyNTS_Endpoint_Params({
+        name: 'searchErrors',
+        type: DyFM_HttpCallType.get,
+        endpoint: '/error/search',
+        preProcesses: this.lazyPreProcessesFor('searchErrors'),
+        tasks: [
+          async (req: Request, res: Response, issuer: string = 'unknown-issuer') : Promise<void> => {
+            const error_CS: T_Error_ControlService = this.getError_ControlService({
+              issuer,
+            });
+
+            res.send(
+              await error_CS.searchErrors(req.body, issuer)
+            );
+          },
+        ],
+      }),
+
+      ...this.additionalEndpoints,
+    ];
+  }
+}
+
+
+
+
+