@futdevpro/nts-dynamo 1.15.157 → 1.15.160

package/src/_models/control-models/system-control.control-model.spec.ts

@@ -1,27 +0,0 @@
-
-import { DyNTS_SystemControl } from './system-control.control-model';
-
-describe('| DyNTS_SystemControl', () => {
-  let systemControl: DyNTS_SystemControl;
-
-  beforeEach(() => {
-    systemControl = new DyNTS_SystemControl();
-  });
-
-  it('| should return true when init is false', () => {
-    systemControl.init = false;
-    expect(systemControl.getIsReady()).toBeTrue();
-  });
-
-  it('| should return true when init is true and started is true', () => {
-    systemControl.init = true;
-    systemControl.started = true;
-    expect(systemControl.getIsReady()).toBeTrue();
-  });
-
-  it('| should return false when init is true and started is false', () => {
-    systemControl.init = true;
-    systemControl.started = false;
-    expect(systemControl.getIsReady()).toBeFalse();
-  });
-});

package/src/_models/control-models/system-control.control-model.ts

@@ -1,12 +0,0 @@
-
-
-
-export class DyNTS_SystemControl {
-  init: boolean = false;
-  started: boolean = false;
-
-  getIsReady(): boolean {
-    return this.init ? this.started : true;
-  }
-}
-

package/src/_models/data-models/schema-migration.data-model.ts

@@ -1,50 +0,0 @@
-import { DyFM_DataModel_Params, DyFM_Metadata } from '@futdevpro/fsm-dynamo';
-
-/**
- * **Migráció-nyilvántartó ("server info") LEDGER** — bedrock, újrahasználható az egész flottának.
- * (A token-service app-lokál `SchemaMigration` mintájából emelve bedrock nts-be.)
- *
- * Egy-egy `migrationId` **PONTOSAN EGYSZER** fut le rendszerenként: a `DyNTS_Migration_Runner.runPending()`
- * boot-on (az app `app.server.postProcess()`-éből) lekéri a már-alkalmazott ID-kat, a pending
- * migrációkat lefuttatja, majd egy sort rögzít ide. A `migrationId` **unique index** → race-safe
- * (két párhuzamos instance esetén az egyik `save`-je duplicate-key-re bukik → skip).
- *
- * A ledger a KÖTELEZŐ kanon-adatokat tartja: **mely migrációk futottak** (id + idő) + **mely app-verzió**
- * alkalmazta (a `appliedVersion`-ökből a "mely verziók futottak" levezethető).
- *
- * Az app a saját DB-jében regisztrálja a `dyNTS_schemaMigration_dataParams`-t (`getGlobalServiceCollection
- * ().dbModels`), így per-app saját `dynts_schema_migrations` collection-t kap.
- */
-export class DyNTS_SchemaMigration extends DyFM_Metadata {
-
-  /** A migráció egyedi azonosítója (konvenció: `YYYY-MM-DD-NNN-descriptor`). */
-  migrationId?: string;
-
-  /** Alkalmazás időbélyege. */
-  appliedAt?: Date;
-
-  /** Az alkalmazó app-verzió (a `package.json` version-je — audit-trail + "mely verziók futottak"). */
-  appliedVersion?: string;
-
-  /** Diag — pl. `touched=<n>` vagy hiba-részletek. */
-  notes?: string;
-
-  constructor(set?: DyNTS_SchemaMigration) {
-    super(set);
-    if (set) {
-      Object.assign(this, set);
-    }
-  }
-}
-
-export const dyNTS_schemaMigration_dataParams: DyFM_DataModel_Params<DyNTS_SchemaMigration> =
-  new DyFM_DataModel_Params<DyNTS_SchemaMigration>({
-    dataName: 'dynts_schema_migrations',
-    addArchive: false,
-    properties: {
-      migrationId:    { type: 'string', required: true, unique: true, index: true },
-      appliedAt:      { type: 'date',   required: true },
-      appliedVersion: { type: 'string' },
-      notes:          { type: 'string' },
-    },
-  });

package/src/_models/interfaces/app-version-header-settings.interface.ts

@@ -1,17 +0,0 @@
-/**
- * FR-292 (2026-08-08) — a deployolt app-verziót hordozó response-header beállításai.
- *
- * A szerver minden válaszra ráteszi a saját app-verzióját, a kliens (ngx oldalon a
- * `DyNX_AppVersion_Interceptor`) pedig ebből veszi észre, hogy a betöltött bundle elavult.
- * Nulla extra kérés: a jelzés a már meglévő API-forgalmon utazik.
- */
-export interface DyNTS_AppVersionHeader_Settings {
-  /**
-   * Ki-/bekapcsolja a header-middleware-t. **Default: `true`** — informatív header, se PII,
-   * se belső részlet nincs benne, viszont nélküle minden app külön építené ugyanezt.
-   */
-  enabled?: boolean;
-
-  /** Felülírható header-név. Default: `X-App-Version`. */
-  headerName?: string;
-}

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

@@ -1,7 +0,0 @@
-
-import * as FileSystem from 'fs';
-
-export interface DyNTS_Certification_Settings {
-  keyPath: FileSystem.PathLike,
-  certPath: FileSystem.PathLike,
-}

package/src/_models/interfaces/compare-data-options.interface.ts

@@ -1,27 +0,0 @@
-/**
- * Options a `DyNTS_DataService<T>.compareData()` method-hoz.
- *
- * - Ha `fields` is undefined, a method auto-discover-elt fielden iter
- *   (mindket objektum kulcs-unioja minus a `DyFM_Metadata` skip-list).
- * - Ha `fields` adott, KIZAROLAG a felsorolt fielden iter (a skip-list
- *   IGNORALODIK — explicit fields override).
- * - `customComparators` per-field override a default deep-equal-en kivul.
- */
-export interface DyNTS_CompareData_Options<T> {
-  /**
-   * Specifikus fields-szubset osszehasonlitasra.
-   *
-   * Megadasaval az auto-discovery is ki van iktatva (a metadata skip-list
-   * NEM ervenyes — ha kifejezetten `_id`-t kerunk, azt is osszehasonlitja).
-   */
-  fields?: (keyof T)[];
-
-  /**
-   * Per-field custom comparator. Ha a field nincs jelen a map-ben, a default
-   * deep-equal hasznalt. A custom function `true`-val signal-ozza az equality-t.
-   *
-   * Hasznos pl. set-equality array-ekre (`arraySetEqual`), case-insensitive
-   * string compare-re, vagy normalizalt date-compare-re.
-   */
-  customComparators?: Partial<Record<keyof T, (a: any, b: any) => boolean>>;
-}

package/src/_models/interfaces/compare-data-result.interface.ts

@@ -1,12 +0,0 @@
-/**
- * `DyNTS_DataService<T>.compareData()` return-objektum.
- *
- * - `result: 'equal'` ha minden vizsgalt field egyezik
- * - `result: 'modified'` ha legalabb egy field eltert
- * - `changedFields` CSAK modified eseten populated (ures array nem fordulhat elo)
- */
-export interface DyNTS_CompareData_Result<T> {
-  result: 'equal' | 'modified';
-  /** Csak `result: 'modified'` eseten van — a teljes mismatch-lista a vizsgalt fields koreben. */
-  changedFields?: (keyof T)[];
-}

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

@@ -1,52 +0,0 @@
-import { DyNTS_Cors_Settings } from './cors-settings.interface';
-
-describe('| DyNTS_Cors_Settings', () => {
-
-  it('| accepts an explicit array allowlist', () => {
-    const s: DyNTS_Cors_Settings = {
-      allowedOrigins: ['https://organizer.futdevpro.hu', 'https://test.organizer.futdevpro.hu'],
-    };
-    expect(Array.isArray(s.allowedOrigins)).toBe(true);
-    expect((s.allowedOrigins as string[]).length).toBe(2);
-  });
-
-  it('| accepts a predicate function', () => {
-    const s: DyNTS_Cors_Settings = {
-      allowedOrigins: (origin: string): boolean => /\.futdevpro\.hu$/.test(origin),
-    };
-    const fn: (o: string) => boolean = s.allowedOrigins as (o: string) => boolean;
-    expect(fn('https://organizer.futdevpro.hu')).toBe(true);
-    expect(fn('https://attacker.com')).toBe(false);
-  });
-
-  it('| accepts wildcard with allowCredentials=false', () => {
-    const s: DyNTS_Cors_Settings = {
-      allowedOrigins: '*',
-      allowCredentials: false,
-    };
-    expect(s.allowedOrigins).toBe('*');
-    expect(s.allowCredentials).toBe(false);
-  });
-
-  it('| defaults to allowCredentials=true when omitted', () => {
-    // Type-level: omitted is allowed; runtime middleware reads `!== false` and treats as true.
-    const s: DyNTS_Cors_Settings = {
-      allowedOrigins: ['https://example.com'],
-    };
-    expect(s.allowCredentials).toBeUndefined();
-  });
-
-  it('| supports custom methods + headers + exposed + maxAge', () => {
-    const s: DyNTS_Cors_Settings = {
-      allowedOrigins: ['https://example.com'],
-      allowedMethods: ['GET', 'POST'],
-      allowedHeaders: ['Authorization', 'X-Trace-Id'],
-      exposedHeaders: ['X-Total-Count'],
-      maxAgeSeconds: 3600,
-    };
-    expect(s.allowedMethods).toEqual(['GET', 'POST']);
-    expect(s.allowedHeaders).toContain('X-Trace-Id');
-    expect(s.exposedHeaders).toEqual(['X-Total-Count']);
-    expect(s.maxAgeSeconds).toBe(3600);
-  });
-});

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

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

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

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

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

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

package/src/_models/interfaces/global-log-settings.interface.ts

@@ -1,171 +0,0 @@
-
-import { Request, Response } from 'express';
-
-export interface DyNTS_GlobalLog_Settings {
-  /**
-   * this setting will set which logs will be shown
-   */
-  highDetailedLogs?: boolean;
-
-  deep?: boolean;
-
-  /**
-   * this setting will enable debug logs for setting up the application
-   */
-  setup?: boolean;
-
-  /**
-   * this setting will enable debug logs for setting up the database
-   */
-  dbSetup?: boolean;
-
-  /**
-   * this is an application wide default setting for route debug logs
-   */
-  request?: boolean;
-
-  /**
-   * this is an application wide default setting for route debug logs
-   */
-  requestsParams?: boolean;
-
-  /**
-   * this is an application wide default setting for route debug logs
-   */
-  requestsContent?: boolean;
-
-  /**
-   * this is an application wide default setting for route debug logs
-   */
-  responseContent?: boolean;
-
-  /**
-   * this is an application wide default setting for route debug logs
-   */
-  requestStackLocation?: boolean;
-  
-
-  /**
-   * this is an application wide default setting for socket debug logs
-   */
-  socket_allEvents?: boolean;
-
-  /**
-   * this is an application wide default setting for socket debug logs
-   */
-  socket_mainEvents?: boolean;
-
-  /**
-   * this is an application wide default setting for socket debug logs
-   */
-  socket_eventContent?: boolean;
-
-
-  /**
-   * this is an application wide default setting for api debug logs
-   */
-  api_events?: boolean;
-
-  /**
-   * this is an application wide default setting for api debug logs
-   */
-  api_requestContents?: boolean;
-
-  /**
-   * this is an application wide default setting for api debug logs
-   */
-  api_requestSettings?: boolean;
-
-  /**
-   * this is an application wide default setting for api debug logs
-   */
-  api_responseContents?: boolean;
-
-  /**
-   * this is an application wide default setting for api debug logs
-   */
-  api_errors?: boolean;
-
-
-  /**
-   * this is an application wide default setting for detailed error logs
-   */
-  detailedErrors?: boolean;
-
-  server_debug?: boolean;
-
-  functions?: boolean;
-
-  /**
-   * Logs endpoint konfiguracio.
-   * Ha enabled: true, a DyNTS_getLogsRoutingModule() hozzaadja a /logs endpoint-ot.
-   * A log buffer in-memory ring buffer-kent mukodik (maxEntries sor).
-   */
-  logs_endpoint?: {
-    /** Engedelyezve van-e a /logs endpoint. Default: false. */
-    enabled: boolean;
-    /** Max sorok szama a bufferben. Default: 2000. */
-    maxEntries?: number;
-    /**
-     * Engedelyezi-e a szerver-bootstrap automatikus, env-tudatos /logs
-     * mount-jat. Default: true.
-     *
-     * - TEST env: a `DYNTS_ADMIN_API_KEY` env var-os admin-key auth-tal mount-ol
-     *   (ha a kulcs nincs beallitva → skip + warn).
-     * - PROD env: csak akkor mount-ol, ha a `prodAuthPreProcess` (FDP RBAC) be
-     *   van allitva (kulonben skip + warn — SOHA nem mount-ol vedetlenul prod-on).
-     *
-     * Ha false → a bootstrap nem mount-ol semmit (az app sajat kezuleg
-     * regisztralhatja a DyNTS_getLogsRoutingModule()-t).
-     *
-     * Megj.: a tenyleges auto-mount WIRING a logs-endpoint-auto-mount feature-ben
-     * landol; ez itt a TIPUS-deklaracio (additive), hogy a consumer-ek (FDP
-     * Templates NTS logs-RBAC) tudjak allitani a `prodAuthPreProcess`-t.
-     */
-    autoMount?: boolean;
-    /**
-     * PROD env-en hasznalt auth pre-process (FDP RBAC). A bootstrap auto-mount
-     * EZT hasznalja prod-on; ha nincs beallitva, prod-on NEM mount-ol.
-     *
-     * Tipusa megegyezik a DyNTS_getLogsRoutingModule({ authPreProcess })
-     * altal varttal (DyNTS_LogsController_Config.authPreProcess).
-     */
-    prodAuthPreProcess?: (req: Request, res: Response) => Promise<void>;
-  };
-
-  /**
-   * File-based log kiiras konfiguracio (DyNTS_FileLog_Service).
-   *
-   * Az in-memory ring buffer (DyNTS_Logs_Service) mellett mukodik — NEM
-   * helyette. A szerver stdout/stderr kimeneteket egy per-session log
-   * fajlba duplikalja (`{logDir}/{filenamePrefix}YYYY-MM-DD_HH-MM-SS.log`).
-   *
-   * Rotation: ha az aktiv fajl meghaladja a `maxFileSizeMb`-t, uj fajl jon
-   * letre. Retention: az `install()` + minden rotation utan a
-   * `maxFiles`-nel regebbi vagy a `retentionDays`-nel idosebb fajlok
-   * torlodnek (ami elobb teljesul).
-   *
-   * Hasznalat:
-   *   DyNTS_FileLog_Service.getInstance().install();  // szerver startup
-   */
-  file_log?: {
-    /** Engedelyezve van-e a file-based logolás. Default: false. */
-    enabled: boolean;
-    /** Log mappa abszolut vagy relativ path-ja. Default: './logs/server'. */
-    logDir?: string;
-    /** Per-session fajlnev prefix. Default: 'server-'. */
-    filenamePrefix?: string;
-    /** Rotation trigger MB-ban. Default: 50. */
-    maxFileSizeMb?: number;
-    /** Retention by count — max ennyi log fajl marad meg. Default: 10. */
-    maxFiles?: number;
-    /** Retention by age — ennyi napnal regebbi fajl torlodik. Default: 30. */
-    retentionDays?: number;
-    /** ANSI escape kodok strippelese a fajl-irasnal. Default: true. */
-    stripAnsi?: boolean;
-    /** stdout interceptalasa. Default: true. */
-    includeStdout?: boolean;
-    /** stderr interceptalasa. Default: true. */
-    includeStderr?: boolean;
-  };
-}

package/src/_models/interfaces/global-service-settings.interface.ts

@@ -1,47 +0,0 @@
-
-
-
-
-import { Request, Response } from 'express';
-
-import { DyFM_DataModel_Params } from '@futdevpro/fsm-dynamo';
-
-import { DyNTS_AuthService } from '../../_services/core/auth.service';
-import { DyNTS_EmailService } from '../../_services/core/email.service';
-import { DyNTS_Service_Collection } from '../../_services/core/service-collection.service';
-
-
-export interface DyNTS_GlobalService_Settings {
-  /**
-   * You need to setup your Own Auth Service extending the DyNTS_AuthService class
-   */
-  authService?: DyNTS_AuthService,
-
-  /**
-   * You can setup your Own Email Service extending the DyNTS_EmailServiceCollection class
-   */
-  emailServiceCollection?: DyNTS_Service_Collection<DyNTS_EmailService>,
-
-  /**
-   * you can setup data tables by passing a DyFM_DataModel_Params list at this point 
-   */
-  dbModels?: DyFM_DataModel_Params<any>[],
-
-  /**
-   * you can setup other services by passing a DyNTS_SingletonService list at this point
-   */
-  /* simpleServicesCollection?: DyNTS_SimpleServiceCollection, */
-
-  /**
-   * you can setup socket services by passing a DyNTS_SocketServiceCollection list at this point
-   */
-  /* socketServiceCollection?: DyNTS_SocketServiceCollection, */
-
-  /**
-   * you can setup global error handler by passing a function at this point
-   */
-  errorHandler?: DyNTS_GlobalErrorHandlerFn,
-}
-
-export type DyNTS_GlobalErrorHandlerFn = 
-  (err: any, req?: Request, res?: Response, issuer?: string) => Promise<void>;