@futdevpro/nts-dynamo 1.15.157 → 1.15.163

package/src/_services/core/event-loop-diag.service.spec.ts

@@ -1,22 +0,0 @@
-import { DyNTS_EventLoopDiag, DyNTS_EventLoopSample } from './event-loop-diag.service';
-
-// Az event-loop-diag (BFR-OVERSEER-007) alap-tesztjei: snapshot-shape + install-idempotencia.
-// A tényleges lag-értékeket nem asszertáljuk (env-függő) — a mérő-plumbing működését igen.
-describe('| DyNTS_EventLoopDiag', (): void => {
-
-  it('| getSnapshot install előtt is biztonságos (üres kép)', (): void => {
-    const snapshot: { installed: boolean; current: DyNTS_EventLoopSample | null; history: DyNTS_EventLoopSample[] } =
-      DyNTS_EventLoopDiag.getInstance().getSnapshot();
-
-    expect(Array.isArray(snapshot.history)).toBeTrue();
-  });
-
-  it('| install idempotens és a snapshot installed-et jelez', (): void => {
-    const diag: DyNTS_EventLoopDiag = DyNTS_EventLoopDiag.getInstance();
-
-    diag.install();
-    diag.install();
-
-    expect(diag.getSnapshot().installed).toBeTrue();
-  });
-});

package/src/_services/core/event-loop-diag.service.ts

@@ -1,144 +0,0 @@
-import { monitorEventLoopDelay, IntervalHistogram } from 'perf_hooks';
-
-import { DyFM_Log } from '@futdevpro/fsm-dynamo';
-
-import { DyNTS_global_settings } from '../../_collections/global-settings.const';
-import { DyNTS_RequestHunter } from './request-hunter.service';
-
-/** Egy event-loop-lag mintavétel (a gördülő history eleme). */
-export interface DyNTS_EventLoopSample {
-  at: number;
-  /** p50 lag ms-ben (a poll-ablakban). */
-  p50Ms: number;
-  /** p95 lag ms-ben. */
-  p95Ms: number;
-  /** max lag ms-ben — a „process él, HTTP néma" wedge fő jele. */
-  maxMs: number;
-  /** Aktív handle-k száma (socket/timer/fd) — connection-leak jel. */
-  activeHandles: number;
-}
-
-/**
- * Event-loop-lag + connection diagnosztika (BFR-OVERSEER-007) — a „process él, de a HTTP néma"
- * jelenség (event-loop blokk / wedge) eddig LÁTHATATLAN volt: a MemoryGuard a heap-et figyeli,
- * a healthcheck kívülről néz — a loop-lag magát a tünetet méri, belülről.
- *
- * A `perf_hooks.monitorEventLoopDelay` NATÍV histogramjára épül (elhanyagolható overhead),
- * poll-onként mintát tesz egy ring-bufferbe; a `getSnapshot()` a `/server/diag` endpoint (és
- * bármely fogyasztó) számára adja vissza az aktuális + közelmúlt-képet. A MemoryGuard MELLÉ
- * illeszkedik (nem duplikálja): memória-nyomás = MemoryGuard.pressure(); loop-lag = ez.
- *
- * Install: a base App startup (a MemoryGuard-install mintájára), `eventLoopDiag.enabled` gate-tel
- * (default: true — a mérés olcsó; opt-out lehetséges).
- */
-export class DyNTS_EventLoopDiag {
-
-  /**
-   * E fölött a lag fölött írunk ki issue-hunter attribúciót (`[EL-STALL]`).
-   * 1000ms: egy másodperces loop-megállás már valódi tünet (a normál érték 20-50ms),
-   * de elég magas ahhoz, hogy a szokásos GC-tüskék ne spam-eljenek.
-   */
-  static readonly STALL_ATTRIBUTION_MS: number = 1000;
-
-  private static instance: DyNTS_EventLoopDiag;
-
-  static getInstance(): DyNTS_EventLoopDiag {
-    if (!DyNTS_EventLoopDiag.instance) {
-      DyNTS_EventLoopDiag.instance = new DyNTS_EventLoopDiag();
-    }
-
-    return DyNTS_EventLoopDiag.instance;
-  }
-
-  private monitor: IntervalHistogram | null = null;
-  private pollTimer: NodeJS.Timeout | null = null;
-  private history: DyNTS_EventLoopSample[] = [];
-  private installed: boolean = false;
-
-  /** A diag-mérés telepítése (idempotens; a settings-gate itt érvényesül). */
-  install(): void {
-    if (this.installed) {
-      return;
-    }
-
-    const settings: { enabled?: boolean; pollIntervalMs?: number; maxHistoryCount?: number } =
-      DyNTS_global_settings.eventLoopDiag ?? {};
-
-    if (settings.enabled === false) {
-      return;
-    }
-
-    const pollIntervalMs: number = settings.pollIntervalMs ?? 5000;
-    const maxHistoryCount: number = settings.maxHistoryCount ?? 120;
-
-    // natív histogram — 10ms felbontás bőven elég a wedge-detektáláshoz (a jel: 100ms+ lag)
-    this.monitor = monitorEventLoopDelay({ resolution: 10 });
-    this.monitor.enable();
-
-    this.pollTimer = setInterval((): void => {
-      if (!this.monitor) {
-        return;
-      }
-
-      // a histogram ns-ben mér → ms-re váltunk; poll után reset (ablakonkénti kép)
-      const maxMs: number = Math.round(this.monitor.max / 1e6);
-      this.history.push({
-        at: Date.now(),
-        p50Ms: Math.round(this.monitor.percentile(50) / 1e6),
-        p95Ms: Math.round(this.monitor.percentile(95) / 1e6),
-        maxMs: maxMs,
-        activeHandles: this.getActiveHandleCount(),
-      });
-      this.monitor.reset();
-
-      // ISSUE-HUNTER ATTRIBÚCIÓ (2026-08-05) — a mérés eddig csak azt mondta meg, HOGY megállt
-      // a loop, azt NEM, hogy MITŐL. Stall esetén kiírjuk az ÉPPEN futó kéréseket.
-      //
-      // ⚠️ Fontos korlát, amit a szöveg is kimond: a fagyás ALATT ez a poll NEM fut, ezért ha a
-      // blokkoló kérés időközben befejeződött, az in-flight lista ÜRES lesz. Ezért a `describeInFlight()`
-      // ilyenkor expliciten a `[REQ-HUNTER] SLOW` sorokra irányít — az a FŐ jel, ez a másodlagos.
-      if (maxMs >= DyNTS_EventLoopDiag.STALL_ATTRIBUTION_MS) {
-        DyFM_Log.warn(
-          `[EL-STALL] event-loop megallas ${maxMs}ms — futo keresek: `
-          + DyNTS_RequestHunter.getInstance().describeInFlight(),
-        );
-      }
-
-      if (this.history.length > maxHistoryCount) {
-        this.history = this.history.slice(-maxHistoryCount);
-      }
-    }, pollIntervalMs);
-
-    // a poll-timer NE tartsa életben a processzt
-    this.pollTimer.unref?.();
-
-    this.installed = true;
-    DyFM_Log.log(`Event-loop diag installed (poll: ${pollIntervalMs}ms, history: ${maxHistoryCount})`);
-  }
-
-  /** A diag-pillanatkép — a `/server/diag` endpoint (és bármely fogyasztó) forrása. */
-  getSnapshot(): {
-    installed: boolean;
-    current: DyNTS_EventLoopSample | null;
-    history: DyNTS_EventLoopSample[];
-  } {
-    return {
-      installed: this.installed,
-      current: this.history.length ? this.history[this.history.length - 1] : null,
-      history: this.history,
-    };
-  }
-
-  /** Aktív handle-k száma — best-effort (a nem-publikus API hiányát 0-val toleráljuk). */
-  private getActiveHandleCount(): number {
-    // a _getActiveHandles nem publikus API — best-effort diag-jel (connection/timer-leak trend)
-    const getHandles: (() => unknown[]) | undefined =
-      (process as unknown as { _getActiveHandles?: () => unknown[] })._getActiveHandles;
-
-    try {
-      return getHandles ? getHandles().length : 0;
-    } catch {
-      return 0;
-    }
-  }
-}

package/src/_services/core/global.service.spec.ts

@@ -1,292 +0,0 @@
-
-import { DyNTS_GlobalService } from './global.service';
-import { DyNTS_AuthService } from './auth.service';
-import { DyNTS_EmailService } from './email.service';
-import { DyNTS_DBService } from '../base/db.service';
-import { DyNTS_Service_Collection } from './service-collection.service';
-import { DyNTS_App_Params } from '../../_models/control-models/app-params.control-model';
-import { DyFM_DataModel_Params, DyFM_Error, DyFM_Metadata, DyFM_EnvironmentFlag } from '@futdevpro/fsm-dynamo';
-import { DyNTS_GlobalService_Settings } from '../../_models/interfaces/global-service-settings.interface';
-import { DyNTS_global_settings } from '../../_collections/global-settings.const';
-
-class TestMetadata extends DyFM_Metadata {
-  name: string;
-}
-
-class TestAuthService extends DyNTS_AuthService {
-  static getInstance(): TestAuthService {
-    return TestAuthService.getSingletonInstance();
-  }
-
-  authenticate_token = async (req: any, res: any): Promise<void> => {};
-  authenticate_tokenSelf = async (req: any, res: any): Promise<void> => {};
-  authenticate_tokenPerm_accUsageData = async (req: any, res: any): Promise<void> => {};
-  getIssuerFromRequest(req: any): string { return 'test'; }
-  getUsernameFromRequest(req: any): string { return 'test'; }
-}
-
-describe('| DyNTS_GlobalService', () => {
-  // Ensure env_settings exists before tests
-  beforeAll(() => {
-    if (!DyNTS_global_settings.env_settings) {
-      (DyNTS_global_settings as any).env_settings = {
-        environment: DyFM_EnvironmentFlag.local,
-        discord: {},
-        mongoUri: undefined,
-        openAi: {},
-      };
-    } else if (!DyNTS_global_settings.env_settings.environment) {
-      DyNTS_global_settings.env_settings.environment = DyFM_EnvironmentFlag.local;
-    }
-  });
-
-  beforeEach(() => {
-    // Reset singleton instance
-    (DyNTS_GlobalService as any).instance = undefined;
-  });
-
-  it('| should be a singleton instance', () => {
-    const instance1 = DyNTS_GlobalService.getInstance();
-    const instance2 = DyNTS_GlobalService.getInstance();
-
-    expect(instance1).toBe(instance2);
-    expect(instance1).toBeInstanceOf(DyNTS_GlobalService);
-  });
-
-  describe('| params', () => {
-    it('| should return undefined when not set', () => {
-      // Reset params before test
-      (DyNTS_GlobalService as any)._params = undefined;
-      expect(DyNTS_GlobalService.params).toBeUndefined();
-    });
-
-    it('| should return set params', () => {
-      const params = new DyNTS_App_Params({
-        name: 'Test App',
-        version: '1.0.0',
-        dbName: 'test_db',
-      });
-
-      DyNTS_GlobalService.setParams(params);
-
-      expect(DyNTS_GlobalService.params).toBe(params);
-      expect(DyNTS_GlobalService.params.name).toBe('Test App');
-    });
-  });
-
-  describe('| upSince', () => {
-    it('| should return a Date object', () => {
-      expect(DyNTS_GlobalService.upSince).toBeInstanceOf(Date);
-    });
-
-    it('| should return the same date on multiple calls', () => {
-      const date1 = DyNTS_GlobalService.upSince;
-      const date2 = DyNTS_GlobalService.upSince;
-
-      expect(date1).toBe(date2);
-    });
-  });
-
-  describe('| upTime', () => {
-    it('| should return a number', () => {
-      expect(typeof DyNTS_GlobalService.upTime).toBe('number');
-    });
-
-    it('| should return positive value', () => {
-      expect(DyNTS_GlobalService.upTime).toBeGreaterThanOrEqual(0);
-    });
-  });
-
-  describe('| setParams', () => {
-    it('| should set params', () => {
-      const params = new DyNTS_App_Params({
-        name: 'Test App',
-        version: '1.0.0',
-        dbName: 'test_db',
-      });
-
-      DyNTS_GlobalService.setParams(params);
-
-      expect(DyNTS_GlobalService.params).toBe(params);
-    });
-  });
-
-  describe('| getAuthService', () => {
-    it('| should throw error when auth service not set', () => {
-      expect(() => {
-        DyNTS_GlobalService.getAuthService();
-      }).toThrow();
-    });
-
-    it('| should return auth service when set', async () => {
-      const authService = TestAuthService.getInstance();
-      await DyNTS_GlobalService.setServices({
-        authService: authService,
-      });
-
-      const result = DyNTS_GlobalService.getAuthService();
-
-      expect(result).toBe(authService);
-    });
-
-    it('| should NOT throw and return undefined when auth_settings.optional is true', () => {
-      // Suppress: public / no-auth szerver — a beállítás elnyomja a
-      // "Unique Authentication Service missing!" dobást. A flag-et finally-ben
-      // visszaállítjuk, hogy a randomizált futásban ne szivárogjon más tesztbe.
-      const prev = DyNTS_global_settings.auth_settings?.optional;
-      try {
-        DyNTS_global_settings.auth_settings = { optional: true };
-        let result: DyNTS_AuthService;
-        expect(() => {
-          result = DyNTS_GlobalService.getAuthService();
-        }).not.toThrow();
-        expect(result).toBeUndefined();
-      } finally {
-        DyNTS_global_settings.auth_settings = { optional: prev ?? false };
-      }
-    });
-  });
-
-  describe('| getDBServiceCollection', () => {
-    it('| should throw error when db service collection not set', () => {
-      expect(() => {
-        DyNTS_GlobalService.getDBServiceCollection();
-      }).toThrow();
-    });
-
-    it('| should return db service collection when set', async () => {
-      const dbModel = new DyFM_DataModel_Params<TestMetadata>({
-        dataName: 'test_data',
-        properties: { name: { key: 'name', type: 'string' } },
-      });
-
-      await DyNTS_GlobalService.setServices({
-        dbModels: [dbModel],
-      });
-
-      const result = DyNTS_GlobalService.getDBServiceCollection();
-
-      expect(result).toBeDefined();
-      expect(result['test_data']).toBeDefined();
-    });
-  });
-
-  describe('| getDBService', () => {
-    it('| should return db service by data params', async () => {
-      const dbModel = new DyFM_DataModel_Params<TestMetadata>({
-        dataName: 'test_data',
-        properties: { name: { key: 'name', type: 'string' } },
-      });
-
-      await DyNTS_GlobalService.setServices({
-        dbModels: [dbModel],
-      });
-
-      const result = DyNTS_GlobalService.getDBService(dbModel);
-
-      expect(result).toBeDefined();
-      expect(result).toBeInstanceOf(DyNTS_DBService);
-    });
-
-    it('| should throw error when db service not found', async () => {
-      const dbModel = new DyFM_DataModel_Params<TestMetadata>({
-        dataName: 'non_existent',
-        properties: { name: { key: 'name', type: 'string' } },
-      });
-
-      await DyNTS_GlobalService.setServices({
-        dbModels: [],
-      });
-
-      expect(() => {
-        DyNTS_GlobalService.getDBService(dbModel);
-      }).toThrow();
-    });
-  });
-
-  describe('| getDBServiceByKey', () => {
-    it('| should return db service by key', async () => {
-      const dbModel = new DyFM_DataModel_Params<TestMetadata>({
-        dataName: 'test_data',
-        properties: { name: { key: 'name', type: 'string' } },
-      });
-
-      await DyNTS_GlobalService.setServices({
-        dbModels: [dbModel],
-      });
-
-      const result = DyNTS_GlobalService.getDBServiceByKey<TestMetadata>('test_data');
-
-      expect(result).toBeDefined();
-      expect(result).toBeInstanceOf(DyNTS_DBService);
-    });
-
-    it('| should throw error when key not found', async () => {
-      await DyNTS_GlobalService.setServices({
-        dbModels: [],
-      });
-
-      expect(() => {
-        DyNTS_GlobalService.getDBServiceByKey('non_existent');
-      }).toThrow();
-    });
-  });
-
-  describe('| getEmailServiceCollection', () => {
-    it('| should throw error when email service collection not set', () => {
-      expect(() => {
-        DyNTS_GlobalService.getEmailServiceCollection();
-      }).toThrow();
-    });
-
-    it('| should return email service collection when set', async () => {
-      const emailServiceCollection = {} as DyNTS_Service_Collection<DyNTS_EmailService>;
-
-      await DyNTS_GlobalService.setServices({
-        emailServiceCollection: emailServiceCollection,
-      });
-
-      const result = DyNTS_GlobalService.getEmailServiceCollection();
-
-      expect(result).toBe(emailServiceCollection);
-    });
-  });
-
-  describe('| setServices', () => {
-    it('| should setup all services', async () => {
-      const authService = TestAuthService.getInstance();
-      const dbModel = new DyFM_DataModel_Params<TestMetadata>({
-        dataName: 'test_data',
-        properties: { name: { key: 'name', type: 'string' } },
-      });
-      const emailServiceCollection = {} as DyNTS_Service_Collection<DyNTS_EmailService>;
-
-      await DyNTS_GlobalService.setServices({
-        authService: authService,
-        dbModels: [dbModel],
-        emailServiceCollection: emailServiceCollection,
-      });
-
-      expect(DyNTS_GlobalService.getAuthService()).toBe(authService);
-      expect(DyNTS_GlobalService.getDBServiceCollection()).toBeDefined();
-      expect(DyNTS_GlobalService.getEmailServiceCollection()).toBe(emailServiceCollection);
-    });
-
-    it('| should handle empty settings', async () => {
-      await expectAsync(
-        DyNTS_GlobalService.setServices({})
-      ).toBeResolved();
-    });
-
-    it('| should throw error on setup failure', async () => {
-      const invalidDbModel = null as any;
-
-      await expectAsync(
-        DyNTS_GlobalService.setServices({
-          dbModels: [invalidDbModel],
-        })
-      ).toBeRejected();
-    });
-  });
-});
-