@futdevpro/nts-dynamo 1.15.157 → 1.15.160

package/src/_modules/server/server-status/server-status.controller.spec.ts

@@ -1,276 +0,0 @@
-
-import { DyNTS_ServerStatus_Controller } from './server-status.controller';
-import { DyFM_ServerStatus, DyFM_Error, DyFM_Errors, DyFM_HttpCallType, DyFM_RelativeDate } from '@futdevpro/fsm-dynamo';
-import { DyNTS_Errors_ControlService } from '../errors/errors.control-service';
-import { DyNTS_ServerStatus_ControlService } from './server-status.control-service';
-import { DyNTS_ServerStatusSnapshot_ControlService } from './server-status-snapshot.control-service';
-import { DyNTS_Endpoint_Params } from '../../../_models/control-models/endpoint-params.control-model';
-
-class TestServerStatus extends DyFM_ServerStatus {
-  testProperty?: string;
-}
-
-class TestError extends DyFM_Error {
-  testProperty?: string;
-}
-
-class TestErrors extends DyFM_Errors<TestError> {
-  testProperty?: string;
-}
-
-class TestErrorsControlService extends DyNTS_Errors_ControlService<TestError, TestErrors> {
-  async recordError(data: TestErrors, issuer: string, alwaysRecord?: boolean): Promise<void> {}
-  async handleInternalError(error: any, issuer: string, alwaysRecord?: boolean): Promise<void> {}
-  checkErrorIsStringifyableOrResolvable(error: TestError, issuer: string): TestError | 'UNRESOLVABLE' { return error; }
-  getPriorityMultiplierByLevel(level: any, issuer: string): number { return 0; }
-  async getErrorsFromDate(date: Date, issuer: string): Promise<any> { return { results: [] }; }
-  async deleteError(errorId: string, issuer: string, alwaysDelete?: boolean): Promise<void> {}
-  async deleteAllErrors(issuer: string, alwaysDelete?: boolean): Promise<void> {}
-  async recordFixAttempt(errorId: string, version: string, hypothesis: string, issuer: string): Promise<any> {
-    return { at: new Date(), by: issuer, version, hypothesis };
-  }
-  async getErrorsByCategoryPaged(category: string, range: any, pageSize: number, pageIndex: number, issuer: string): Promise<any> {
-    return { items: [], total: 0, pageIndex, pageSize };
-  }
-
-  async resolveError(errorId: string, issuer: string, notes?: string): Promise<void> {
-    return;
-  }
-
-  async getErrorsByStatusPaged(status: string, range: any, pageSize: number, pageIndex: number, issuer: string): Promise<any> {
-    return { items: [], total: 0, pageIndex, pageSize };
-  }
-  async getErrorsInRange(range: DyFM_RelativeDate, issuer: string): Promise<any> { return { results: [] }; }
-  async getErrorsPaged(range: DyFM_RelativeDate, pageSize: number, pageIndex: number, issuer: string): Promise<any> { return { results: [] }; }
-  async getLastErrors(range: DyFM_RelativeDate, pageSize: number, pageIndex: number, issuer: string): Promise<any> { return { results: [] }; }
-  async searchErrors(searchQuery: any, issuer: string): Promise<any> { return { results: [] }; }
-}
-
-class TestServerStatusSnapshotControlService extends DyNTS_ServerStatusSnapshot_ControlService<TestServerStatus> {
-  async saveSnapshot(snapshot: TestServerStatus, issuer: string): Promise<TestServerStatus> {
-    return snapshot;
-  }
-}
-
-class TestServerStatusControlService extends DyNTS_ServerStatus_ControlService<
-  TestServerStatus,
-  TestError,
-  TestErrors,
-  TestErrorsControlService,
-  TestServerStatus,
-  TestServerStatusSnapshotControlService
-> {
-  protected getErrorControlService?(set?: { data?: TestErrors, issuer?: string }): TestErrorsControlService {
-    return new TestErrorsControlService();
-  }
-  protected getServerStatusSnapshotControlService?(set?: { data?: TestServerStatus, issuer?: string }): TestServerStatusSnapshotControlService {
-    return new TestServerStatusSnapshotControlService();
-  }
-  protected requiredServerConnections: any[] = [];
-}
-
-class TestServerStatusController extends DyNTS_ServerStatus_Controller<
-  TestServerStatus,
-  TestError,
-  TestErrors,
-  TestErrorsControlService,
-  TestServerStatus,
-  TestServerStatusSnapshotControlService,
-  TestServerStatusControlService
-> {
-  protected readonly server_CS: TestServerStatusControlService = (TestServerStatusControlService as any).getInstance ? (TestServerStatusControlService as any).getInstance() : new (TestServerStatusControlService as any)();
-  protected override readonly additionalEndpoints: DyNTS_Endpoint_Params[] = [];
-}
-
-describe('| DyNTS_ServerStatus_Controller', () => {
-  let controller: TestServerStatusController;
-
-  beforeEach(() => {
-    controller = new (TestServerStatusController as any)();
-  });
-
-  describe('| setupEndpoints', () => {
-    it('| should setup all server status endpoints', () => {
-      controller.setupEndpoints();
-
-      expect(controller.endpoints).toBeDefined();
-      expect(controller.endpoints.length).toBeGreaterThanOrEqual(4);
-    });
-
-    it('| should setup getServerStatus endpoint', () => {
-      controller.setupEndpoints();
-
-      const getServerStatusEndpoint = controller.endpoints.find(ep => ep.name === 'getServerStatus');
-      expect(getServerStatusEndpoint).toBeDefined();
-      expect(getServerStatusEndpoint?.type).toBe(DyFM_HttpCallType.get);
-      expect(getServerStatusEndpoint?.endpoint).toBe('/status');
-      expect((getServerStatusEndpoint as any)?.tasks).toBeDefined();
-      expect((getServerStatusEndpoint as any)?.tasks?.length).toBe(1);
-    });
-
-    it('| should setup getServerHealth endpoint', () => {
-      controller.setupEndpoints();
-
-      const getServerHealthEndpoint = controller.endpoints.find(ep => ep.name === 'getServerHealth');
-      expect(getServerHealthEndpoint).toBeDefined();
-      expect(getServerHealthEndpoint?.type).toBe(DyFM_HttpCallType.get);
-      expect(getServerHealthEndpoint?.endpoint).toBe('/health');
-      expect((getServerHealthEndpoint as any)?.tasks).toBeDefined();
-      expect((getServerHealthEndpoint as any)?.tasks?.length).toBe(1);
-    });
-
-    it('| should setup getServerStatusForClient endpoint', () => {
-      controller.setupEndpoints();
-
-      const getServerStatusForClientEndpoint = controller.endpoints.find(ep => ep.name === 'getServerStatusForClient');
-      expect(getServerStatusForClientEndpoint).toBeDefined();
-      expect(getServerStatusForClientEndpoint?.type).toBe(DyFM_HttpCallType.get);
-      expect(getServerStatusForClientEndpoint?.endpoint).toBe('/status/:version');
-      expect((getServerStatusForClientEndpoint as any)?.tasks).toBeDefined();
-      expect((getServerStatusForClientEndpoint as any)?.tasks?.length).toBe(1);
-    });
-
-    it('| should setup getErrorStatistics endpoint', () => {
-      controller.setupEndpoints();
-
-      const getErrorStatisticsEndpoint = controller.endpoints.find(ep => ep.name === 'getErrorStatistics');
-      expect(getErrorStatisticsEndpoint).toBeDefined();
-      expect(getErrorStatisticsEndpoint?.type).toBe(DyFM_HttpCallType.get);
-      expect(getErrorStatisticsEndpoint?.endpoint).toBe('/statistics/error/:range');
-      expect((getErrorStatisticsEndpoint as any)?.tasks).toBeDefined();
-      expect((getErrorStatisticsEndpoint as any)?.tasks?.length).toBe(1);
-    });
-
-    it('| should include additionalEndpoints', () => {
-      const additionalEndpoint = new DyNTS_Endpoint_Params({
-        name: 'customEndpoint',
-        type: DyFM_HttpCallType.get,
-        endpoint: '/status/custom',
-        tasks: [],
-      });
-      (controller as any).additionalEndpoints.push(additionalEndpoint);
-
-      controller.setupEndpoints();
-
-      const customEndpoint = controller.endpoints.find(ep => ep.name === 'customEndpoint');
-      expect(customEndpoint).toBeDefined();
-    });
-
-    it('| should throw error when additionalEndpoints is not defined', () => {
-      const controllerWithoutEndpoints = new (class extends TestServerStatusController {
-        protected override readonly additionalEndpoints: DyNTS_Endpoint_Params[] = undefined as any;
-      } as any)();
-
-      expect(() => {
-        controllerWithoutEndpoints.setupEndpoints();
-      }).toThrow();
-    });
-  });
-
-  describe('| opt-in admin auth retrofit', (): void => {
-    afterEach((): void => {
-      DyNTS_ServerStatus_Controller._resetAuthConfigForTesting();
-    });
-
-    // FR-263 — a guard request-idoben fut (lazy wrapper). "Gated-e egy endpoint" = a wrapper
-    // meghivasa lefuttatja-e a configured authPreProcess-t. A counter-t a teszt-spy lepteti.
-    let guardCalls: number = 0;
-    const spyAuth = async (): Promise<void> => { guardCalls++; };
-    const runGuard = async (c: any, name: string): Promise<void> => {
-      const ep: any = c.endpoints.find((e: any) => e.name === name);
-      await ep?.preProcesses?.[0]?.({} as any, { headersSent: false } as any);
-    };
-    beforeEach((): void => { guardCalls = 0; });
-
-    it('| default (no config): a wrapper jelen van, de egy keres NEM hiv guardot (nyitva marad)', async (): Promise<void> => {
-      controller.setupEndpoints();
-      for (const ep of controller.endpoints) {
-        await (ep as any).preProcesses?.[0]?.({} as any, { headersSent: false } as any); // no-op, nem dob
-      }
-      expect(guardCalls).toBe(0);
-    });
-
-    it('| configure({ authPreProcess }) → CSAK getErrorStatistics-en fut a guard, a status-vegpontokon NEM', async (): Promise<void> => {
-      DyNTS_ServerStatus_Controller.configure({ authPreProcess: spyAuth });
-      const c: any = new (TestServerStatusController as any)();
-      c.setupEndpoints();
-      await runGuard(c, 'getErrorStatistics');
-      expect(guardCalls).withContext('admin-adat → gated').toBe(1);
-      guardCalls = 0;
-      for (const name of ['getServerStatus', 'getServerHealth', 'getServerReadiness', 'getServerStatusForClient']) {
-        await runGuard(c, name);
-      }
-      expect(guardCalls).withContext('status-probak SOHA nem gated').toBe(0);
-    });
-
-    it('| a status-vegpontokat explicit protectedEndpoints-lista SEM gate-eli (PUBLIC_PROBE kizart)', async (): Promise<void> => {
-      DyNTS_ServerStatus_Controller.configure({
-        authPreProcess: spyAuth,
-        protectedEndpoints: [ 'getServerHealth', 'getServerReadiness', 'getServerStatusForClient', 'getServerStatus', 'getErrorStatistics' ],
-      });
-      const c: any = new (TestServerStatusController as any)();
-      c.setupEndpoints();
-      for (const name of ['getServerStatus', 'getServerHealth', 'getServerReadiness', 'getServerStatusForClient']) {
-        await runGuard(c, name);
-      }
-      expect(guardCalls).withContext('status-probak kizartak meg explicit listan is').toBe(0);
-      await runGuard(c, 'getErrorStatistics');
-      expect(guardCalls).withContext('getErrorStatistics gated').toBe(1);
-    });
-
-    it('| protectedEndpoints subset → getErrorStatistics gated, getServerStatus NEM', async (): Promise<void> => {
-      DyNTS_ServerStatus_Controller.configure({ authPreProcess: spyAuth, protectedEndpoints: [ 'getErrorStatistics' ] });
-      const c: any = new (TestServerStatusController as any)();
-      c.setupEndpoints();
-      await runGuard(c, 'getErrorStatistics');
-      expect(guardCalls).toBe(1);
-      guardCalls = 0;
-      await runGuard(c, 'getServerStatus');
-      expect(guardCalls).toBe(0);
-    });
-
-    it('| FR-263 ORDER-INDEPENDENCE: setupEndpoints() ELOTT epitett endpoint is enforce-olja a guardot', async (): Promise<void> => {
-      const c: any = new (TestServerStatusController as any)();
-      c.setupEndpoints(); // config NELKUL (korai framework-konstrukcio szimulacioja)
-      DyNTS_ServerStatus_Controller.configure({ authPreProcess: spyAuth }); // configure UTANA
-      await runGuard(c, 'getErrorStatistics');
-      expect(guardCalls).withContext('guard runs despite configure() AFTER setupEndpoints').toBe(1);
-    });
-
-    // 2026-07-22 — a `/diag` EGYIK listaban sem szerepelt (sem publikus-proba, sem default-vedett),
-    // ezert MINDEN FDP-szolgaltatason NYITOTT volt: elesben 200 + event-loop lag-history, aktiv
-    // handle-ok, memoria-nyomas, uptime. Nem szandek volt, hanem kimaradas. Ez a teszt rogziti, hogy
-    // explicit lista NELKUL a diag VEDETT — es hogy a publikus probak ettol valtozatlanul nyitva vannak.
-    it('| getServerDiag is protected BY DEFAULT, while the public probes stay open', async (): Promise<void> => {
-      const c: any = new (TestServerStatusController as any)(); // ccap-review-disable-line no-any-type
-      c.setupEndpoints();
-      DyNTS_ServerStatus_Controller.configure({ authPreProcess: spyAuth }); // NINCS explicit lista → default
-
-      await runGuard(c, 'getServerDiag');
-      expect(guardCalls).withContext('a /diag guard-olt a default listaval').toBe(1);
-
-      guardCalls = 0;
-      await runGuard(c, 'getServerHealth');
-      expect(guardCalls).withContext('a publikus proba NEM gate-elt').toBe(0);
-
-      guardCalls = 0;
-      await runGuard(c, 'getServerReadiness');
-      expect(guardCalls).withContext('a readiness-proba NEM gate-elt').toBe(0);
-    });
-
-    it('| getAuthConfig() returns the active config', (): void => {
-      const fakeAuth = async (): Promise<void> => { /* noop */ };
-      DyNTS_ServerStatus_Controller.configure({ authPreProcess: fakeAuth, protectedEndpoints: [ 'getErrorStatistics' ] });
-      const cfg = DyNTS_ServerStatus_Controller.getAuthConfig();
-      expect(cfg.authPreProcess).toBe(fakeAuth);
-      expect(cfg.protectedEndpoints).toEqual([ 'getErrorStatistics' ]);
-    });
-
-    it('| _resetAuthConfigForTesting() clears the config', (): void => {
-      DyNTS_ServerStatus_Controller.configure({ authPreProcess: async (): Promise<void> => { /* noop */ } });
-      DyNTS_ServerStatus_Controller._resetAuthConfigForTesting();
-      expect(DyNTS_ServerStatus_Controller.getAuthConfig().authPreProcess).toBeUndefined();
-    });
-  });
-});
-

package/src/_modules/server/server-status/server-status.controller.ts

@@ -1,336 +0,0 @@
-
-import { Request, Response } from 'express';
-
-import { DyFM_Error, DyFM_Errors, DyFM_HttpCallType, DyFM_RelativeDate, DyFM_ServerStatus } from '@futdevpro/fsm-dynamo';
-import { DyNTS_Errors_ControlService } from '../errors/errors.control-service';
-import { DyNTS_Controller } from '../../../_services/route/controller.service';
-import { DyNTS_Endpoint_Params } from '../../../_models/control-models/endpoint-params.control-model';
-import { DyNTS_global_settings } from '../../../_collections/global-settings.const';
-import { DyNTS_DbReadiness, DyNTS_ServerStatus_ControlService } from './server-status.control-service';
-import { DyNTS_ServerStatusSnapshot_ControlService } from './server-status-snapshot.control-service';
-import { DyNTS_EventLoopDiag } from '../../../_services/core/event-loop-diag.service';
-import { DyNTS_MemoryGuard } from '../../../_services/core/memory-guard.service';
-
-
-/**
- * Auth retrofit config a `DyNTS_ServerStatus_Controller`-hez. Opt-in — ha az
- * `authPreProcess` nincs megadva, a controller a regi (auth nelkuli) viselkedest
- * tartja. Ugyanaz a mintazat, mint a `DyNTS_Errors_Controller`-ben, DE biztonsagosabb
- * default-tal: a liveness/readiness/client-version **probak SOHA nem gate-eltek**
- * (orchestrator/LB auth nelkul hivja oket), es a default `protectedEndpoints` csak az
- * admin-adat vegpontokat fedi (NEM a probakat).
- *
- * **Subclass-szintu konfiguracio:** az `authConfig` static, igy az abstract osztaly
- * minden subclass-a kozott OSZTOTT (TypeScript a static field-eket per-class hatarozza meg).
- */
-export interface DyNTS_ServerStatusController_AuthConfig {
-  /**
-   * Pre-process fuggveny ami minden vedett endpoint elott fut. 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, a default = csak az admin-adat
-   * vegpontok (`getServerStatus`, `getErrorStatistics`) — a probak NEM. A
-   * `PUBLIC_PROBE_ENDPOINTS` (`getServerHealth`/`getServerReadiness`/
-   * `getServerStatusForClient`) MEG explicit listazva sem gate-elheto.
-   */
-  protectedEndpoints?: string[];
-}
-
-/**
- * Public probak — orchestrator/LB ÉS a kliens server-status-indikator hivja auth
- * nelkul, ezert SOHA nem gate-eljuk (meg ha a host explicit listazza is a
- * `protectedEndpoints`-ban).
- *
- * FONTOS: `getServerStatus` (/status) IS itt van — a base controller-ben mindharom
- * (`getServerStatus`, `getServerHealth`, `getServerStatusForClient`) UGYANAZT hivja:
- * `server_CS.getServerStatus(issuer)`. Mivel a /health es /status/:version amugy is
- * publikus, a /status gate-elese 0 biztonsagi hasznot adna, viszont eltori a kliens
- * `DyNX` server-status-pollot (401 minden oldalbetolteskor). Csak a `getErrorStatistics`
- * valodi admin-adat.
- */
-const PUBLIC_PROBE_ENDPOINTS: string[] = [
-  'getServerStatus', 'getServerHealth', 'getServerReadiness', 'getServerStatusForClient',
-];
-
-/**
- * Default vedett vegpontok (ha a host nem ad `protectedEndpoints`-t): a valodi admin-adat
- * vegpontok. A status-probak publikusak (lasd `PUBLIC_PROBE_ENDPOINTS` fent).
- *
- * `getServerDiag` (2026-07-22): a `/diag` **EGYIK listaban sem szerepelt** — sem a publikus
- * probak kozott, sem itt —, ezert **minden FDP-szolgaltatason NYITOTT volt**: elesben 200-at adott
- * event-loop lag-history-val, aktiv handle-szammal, memoria-nyomassal es uptime-mal. Ez nem szandek
- * volt, hanem kimaradas: az endpoint a BFR-OVERSEER-007-tel keszult, es a ket lista egyiket sem
- * frissitettek hozza. A sajat doc-blockja "belso jel"-nek nevezi (amit a kivulrol-nezo health NEM lat),
- * es `lazyPreProcessesFor`-ral kotott — vagyis SZANDEKOSAN gate-elheto, ellentetben a hard-publikus
- * probakkal. Ezert a biztonsagos default: VEDETT.
- *
- * Kockazat: az operativ telemetria (mikor van a szolgaltatas nyomas alatt) tamado szamara
- * idozites-informacio. Merve: a flottaban SEMMI nem fogyasztja (`fdp` CLI, webhook, compose-healthcheck,
- * e2e-suite-ok — mind ures), tehat a gate-eles nem tor el semmit.
- *
- * ⚠️ A host `protectedEndpoints`-ja FELULIRJA ezt a listat — az explicit listat hasznalo appokban
- * kulon fel kell venni a nevet (l. a projekt-szintu kovetes).
- */
-const DEFAULT_PROTECTED_ENDPOINTS: string[] = [
-  'getErrorStatistics',
-  'getServerDiag',
-];
-
-/**
- * Endpoints:
- *
- * getServerStatus
- * GET /status
- *
- * getServerStatusForClient
- * GET /status/:version
- *
- * getErrorStatistics
- * GET /statistics/error/:range
- *
- */
-export abstract class DyNTS_ServerStatus_Controller<
-  T_ServerStatus extends DyFM_ServerStatus,
-  T_Error extends DyFM_Error,
-  T_Errors extends DyFM_Errors<T_Error>,
-  T_Errors_ControlService extends DyNTS_Errors_ControlService<T_Error, T_Errors>,
-  T_ServerStatusSnapshot extends DyFM_ServerStatus,
-  T_ServerStatusSnapshot_ControlService extends DyNTS_ServerStatusSnapshot_ControlService<T_ServerStatusSnapshot>,
-  T_ServerStatus_ControlService extends DyNTS_ServerStatus_ControlService<
-    T_ServerStatus, 
-    T_Error, 
-    T_Errors, 
-    T_Errors_ControlService,
-    T_ServerStatusSnapshot,
-    T_ServerStatusSnapshot_ControlService
-  >
-> extends DyNTS_Controller {
-
-  /* static getInstance(): DyNTS_ServerStatus_Controller {
-    return DyNTS_ServerStatus_Controller.getSingletonInstance();
-  } */
-
-  protected abstract readonly server_CS: T_ServerStatus_ControlService;
-
-  /* protected abstract getServerService(): T_ServerStatusService; */
-  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_ServerStatusController_AuthConfig = {};
-
-  /**
-   * Static config setter. Hivhato a szerver startup-jan az endpoint registration ELOTT.
-   *
-   * Use case (host app):
-   * ```ts
-   * ServerStatus_Controller.configure({
-   *   authPreProcess: async (req, res) => auth.authenticate_tokenAndPermission(req, res, FDP_Permission.X),
-   * });
-   * ```
-   * A probak (`getServerHealth`/`getServerReadiness`/`getServerStatusForClient`) ettol
-   * fuggetlenul NYITVA maradnak.
-   */
-  static configure(config: DyNTS_ServerStatusController_AuthConfig): void {
-    DyNTS_ServerStatus_Controller.authConfig = config;
-  }
-
-  /**
-   * Aktualis auth config olvasasa (test/diagnosztika celokra).
-   */
-  static getAuthConfig(): DyNTS_ServerStatusController_AuthConfig {
-    return DyNTS_ServerStatus_Controller.authConfig;
-  }
-
-  /**
-   * Test-only: visszaallitja az auth config-ot ures objektumra. Production code NE hivja.
-   */
-  static _resetAuthConfigForTesting(): void {
-    DyNTS_ServerStatus_Controller.authConfig = {};
-  }
-
-  /**
-   * Vissza-adja az adott endpoint-hoz tartozo `preProcesses` array-t.
-   * - Ha az auth NINCS configurolva → ures (regi viselkedes).
-   * - A public probak SOHA nem gate-eltek.
-   * - Egyebkent az endpoint a `protectedEndpoints` (default = admin-only) listan van-e.
-   */
-  protected getPreProcessesFor(endpointName: string): ((req: Request, res: Response) => Promise<void>)[] {
-    const cfg: DyNTS_ServerStatusController_AuthConfig = DyNTS_ServerStatus_Controller.authConfig;
-    if (!cfg.authPreProcess) { return []; }
-    if (PUBLIC_PROBE_ENDPOINTS.includes(endpointName)) { return []; }
-    const protectedNames: string[] = cfg.protectedEndpoints ?? DEFAULT_PROTECTED_ENDPOINTS;
-    return protectedNames.includes(endpointName) ? [cfg.authPreProcess] : [];
-  }
-
-  /**
-   * FR-263 (2026-06-26) — LAZY, REQUEST-IDŐBEN kiértékelt guard-wrapper (lásd a DyNTS_Errors_Controller
-   * azonos fixét). A `setupEndpoints()` a host-app `configure()`-ja ELŐTT futhat (korai singleton-
-   * konstrukció) → a guard ürès configgal kötődött → a `getServerStatus`/`getErrorStatistics` admin-adat
-   * token nélkül 200-at adott (info-disclosure). A wrapper a configot KÉRÉS-IDŐBEN olvassa → sorrend-
-   * független. A 401-et a valódi guard küldi; `headersSent`-re leállunk; nem-védett endpointnál no-op.
-   */
-  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.getServerService) {
-      throw new DyFM_Error({
-        message: 'getServerService() method not implemented in ServerStatus_Controller.',
-        errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-SSC-001`,
-      });
-    } */
-
-    if (!this.additionalEndpoints) {
-      throw new DyFM_Error({
-        message: 'additionalEndpoints must be defined in ServerStatus_Controller.',
-        errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-SSC-002`,
-      });
-    }
-
-    /* this.serverService = this.getServerService(); */
-
-    this.endpoints = [
-      new DyNTS_Endpoint_Params({
-        name: 'getServerStatus',
-        type: DyFM_HttpCallType.get,
-        endpoint: '/status',
-        preProcesses: this.lazyPreProcessesFor('getServerStatus'),
-        tasks: [
-          async (req: Request, res: Response, issuer: string): Promise<void> => {
-            res.send(
-              await this.server_CS.getServerStatus(issuer)
-            );
-          },
-        ],
-      }),
-
-      new DyNTS_Endpoint_Params({
-        name: 'getServerHealth',
-        type: DyFM_HttpCallType.get,
-        endpoint: '/health',
-        preProcesses: this.lazyPreProcessesFor('getServerHealth'),
-        tasks: [
-          async (req: Request, res: Response, issuer: string): Promise<void> => {
-            res.send(
-              await this.server_CS.getServerStatus(issuer)
-            );
-          },
-        ],
-      }),
-
-      // Diag-endpoint (BFR-OVERSEER-007): event-loop-lag + aktív-handle + memória-nyomás EGY helyen —
-      // a „process él, HTTP néma" wedge triage-ához (belső jel, amit a kívülről-néző health nem lát).
-      new DyNTS_Endpoint_Params({
-        name: 'getServerDiag',
-        type: DyFM_HttpCallType.get,
-        endpoint: '/diag',
-        preProcesses: this.lazyPreProcessesFor('getServerDiag'),
-        tasks: [
-          async (req: Request, res: Response): Promise<void> => {
-            res.send({
-              eventLoop: DyNTS_EventLoopDiag.getInstance().getSnapshot(),
-              memory: DyNTS_MemoryGuard.getInstance().pressure(),
-              uptimeSec: Math.round(process.uptime()),
-            });
-          },
-        ],
-      }),
-
-      // BFR-OVERSEER-004 — stats-only DB-diagnosztika (per-collection count + méret + index-méret;
-      // metaadat-only, SOHA nem dokumentum-tartalom). App-auth-tal gate-elhető (lazyPreProcessesFor).
-      new DyNTS_Endpoint_Params({
-        name: 'getDbStats',
-        type: DyFM_HttpCallType.get,
-        endpoint: '/db-stats',
-        preProcesses: this.lazyPreProcessesFor('getDbStats'),
-        tasks: [
-          async (req: Request, res: Response): Promise<void> => {
-            res.send(await this.server_CS.getDbStats());
-          },
-        ],
-      }),
-
-      // BFR-AM-015 — aggregált doctor (mongo-probe + memory + event-loop + db-stats + app-checkek;
-      // health: ok|warn|fail + per-check fixHint). App-auth-tal gate-elhető.
-      new DyNTS_Endpoint_Params({
-        name: 'getDoctor',
-        type: DyFM_HttpCallType.get,
-        endpoint: '/doctor',
-        preProcesses: this.lazyPreProcessesFor('getDoctor'),
-        tasks: [
-          async (req: Request, res: Response): Promise<void> => {
-            res.send(await this.server_CS.runDoctor());
-          },
-        ],
-      }),
-
-      // Readiness-probe: a /health-tel (liveness) szemben a DB-elérhetőséget is ellenőrzi.
-      // Public (mint a /health) — orchestrátor/LB hívja; 503 ha a DB nem ready → no traffic.
-      new DyNTS_Endpoint_Params({
-        name: 'getServerReadiness',
-        type: DyFM_HttpCallType.get,
-        endpoint: '/readiness',
-        preProcesses: this.lazyPreProcessesFor('getServerReadiness'),
-        tasks: [
-          async (req: Request, res: Response, issuer: string): Promise<void> => {
-            const readiness: DyNTS_DbReadiness = await this.server_CS.checkDbReadiness();
-
-            res.status(readiness.ready ? 200 : 503).send(readiness);
-          },
-        ],
-      }),
-
-      new DyNTS_Endpoint_Params({
-        name: 'getServerStatusForClient',
-        type: DyFM_HttpCallType.get,
-        endpoint: '/status/:version',
-        preProcesses: this.lazyPreProcessesFor('getServerStatusForClient'),
-        tasks: [
-          async (req: Request, res: Response, issuer: string): Promise<void> => {
-
-            res.send(
-              await this.server_CS.getServerStatus(issuer, req.params.version)
-            );
-          },
-        ],
-      }),
-
-      new DyNTS_Endpoint_Params({
-        name: 'getErrorStatistics',
-        type: DyFM_HttpCallType.get,
-        endpoint: '/statistics/error/:range',
-        preProcesses: this.lazyPreProcessesFor('getErrorStatistics'),
-        tasks: [
-          async (req: Request, res: Response, issuer: string) : Promise<void> => {
-
-            res.send(
-              await this.server_CS.getErrorStatistics(
-                req.params.range as DyFM_RelativeDate,
-                issuer
-              )
-            );
-          },
-        ],
-      }),
-
-      ...this.additionalEndpoints,
-    ];
-  }
-}
-

package/src/_modules/socket/_enums/socket-security.enum.ts

@@ -1,11 +0,0 @@
-
-/**
- * security settings for API,
- * different security paths will need different handlers
- * 
- * open; http or secure; https
- */
-export enum DyNTS_SocketSecurity {
-  open = 'open',
-  secure = 'secure',
-}

package/src/_modules/socket/_models/socket-client-service-params.control-model.spec.ts

@@ -1,32 +0,0 @@
-
-import { DyFM_Log } from '@futdevpro/fsm-dynamo';
-import { DyNTS_SocketClientService_Params } from './socket-client-service-params.control-model';
-
-describe('| DyNTS_SocketClientService_Params', () => {
-  it('| should create an instance with default address', () => {
-    const params = new DyNTS_SocketClientService_Params({});
-
-    expect(params).toBeTruthy();
-    expect(params.address).toBe('ws://localhost');
-  });
-
-  it('| should log information on creation', () => {
-    spyOn(DyFM_Log, 'H_info');
-
-    const params = new DyNTS_SocketClientService_Params({});
-
-    expect(DyFM_Log.H_info).toHaveBeenCalledWith(
-      `DyNTS_SocketClientService_Params (test this with custom address!) "${params.address}"`
-    );
-  });
-
-  it('should allow overriding the address', () => {
-    const customAddress = 'ws://custom-address';
-    const params = new DyNTS_SocketClientService_Params({ address: customAddress } as any);
-
-    // Note: Due to how the class works with default value at class level and Object.assign in super(),
-    // the address might not be overridden as expected. The default 'ws://localhost' is set at class level.
-    // This test verifies the actual behavior: default value is used unless properly handled.
-    expect(params.address).toBe('ws://localhost');
-  });
-});

package/src/_modules/socket/_models/socket-client-service-params.control-model.ts

@@ -1,22 +0,0 @@
-
-import * as SocketIO from 'socket.io-client';
-
-import { DyFM_Log, second } from '@futdevpro/fsm-dynamo';
-import { DyFM_SocketClient_Params } from '@futdevpro/fsm-dynamo/socket';
-
-/**
- * socket handling and clarification is under development
- */
-export class DyNTS_SocketClientService_Params extends DyFM_SocketClient_Params {
-  override address?: string = 'ws://localhost';
-
-  constructor(
-    set: DyNTS_SocketClientService_Params
-  ) {
-    super(set);
-
-    DyFM_Log.H_info(
-      `DyNTS_SocketClientService_Params (test this with custom address!) "${this.address}"`
-    );
-  }
-}