@futdevpro/nts-dynamo 1.15.13 → 1.15.14

package/src/_modules/local-vector-search/_services/lvs-vector-pool.control-service.ts

@@ -1,220 +1,220 @@
-import { LVS_Search_Mode } from '../_enums/lvs-search-mode.enum';
-import { LVS_SearchResult } from '../_models/lvs-search-result.interface';
-
-/**
- * Vektor pool kezelő utility class
- * Instance-based class, amely in-memory vektor pool-t kezel és vektor hasonlósági számításokat végez
- * Minden instance saját vektor pool-t tart fenn
- */
-export class LVS_VectorPool_ControlService {
-  /**
-   * In-memory vektor pool tárolás
-   * Key: vektor ID, Value: vektor értékek
-   */
-  private vectorPool: Map<string, number[]> = new Map<string, number[]>();
-
-  /**
-   * Normalizált vektor pool tárolás (L2 normalizált másolatok)
-   * Key: vektor ID, Value: L2 normalizált vektor értékek
-   */
-  private normalizedVectorPool: Map<string, number[]> = new Map<string, number[]>();
-
-  /**
-   * Hozzáad egy vektort a pool-hoz
-   * Opcionálisan L2 normalizált másolatot is tárol
-   */
-  addVector(id: string, vector: number[]): void {
-    if (!id) {
-      throw new Error('Vector ID is required');
-    }
-
-    if (!Array.isArray(vector) || vector.length === 0) {
-      throw new Error('Vector must be a non-empty array');
-    }
-
-    // Validáljuk, hogy a vektor számokból áll
-    for (let i: number = 0; i < vector.length; i++) {
-      if (typeof vector[i] !== 'number' || !isFinite(vector[i])) {
-        throw new Error(`Vector must contain only finite numbers at index ${i}`);
-      }
-    }
-
-    // Tároljuk az eredeti vektort
-    this.vectorPool.set(id, vector);
-
-    // L2 normalizált másolatot is tárolunk a cosine similarity számításokhoz
-    const normalized: number[] = LVS_VectorPool_ControlService.l2Normalize(vector);
-    this.normalizedVectorPool.set(id, normalized);
-  }
-
-  /**
-   * Eltávolít egy vektort a pool-ból
-   */
-  removeVector(id: string): void {
-    this.vectorPool.delete(id);
-    this.normalizedVectorPool.delete(id);
-  }
-
-  /**
-   * Frissít egy vektort a pool-ban
-   */
-  updateVector(id: string, vector: number[]): void {
-    if (!this.vectorPool.has(id)) {
-      throw new Error(`Vector with ID "${id}" does not exist`);
-    }
-
-    this.addVector(id, vector);
-  }
-
-  /**
-   * Törli az összes vektort a pool-ból
-   */
-  clearPool(): void {
-    this.vectorPool.clear();
-    this.normalizedVectorPool.clear();
-  }
-
-  /**
-   * Visszaadja az összes vektort a pool-ból
-   * Debugging és export céljára
-   */
-  getAll(): Map<string, number[]> {
-    return new Map<string, number[]>(this.vectorPool);
-  }
-
-  /**
-   * L2 normalizálás egy vektorra
-   * A vektor hosszát 1-re normalizálja
-   * Statikus metódus, mivel nincs szüksége instance state-re
-   */
-  private static l2Normalize(vector: number[]): number[] {
-    const magnitude: number = Math.sqrt(
-      vector.reduce((sum: number, value: number) => sum + value * value, 0)
-    );
-
-    if (magnitude === 0) {
-      // Ha a vektor nullvektor, akkor nullvektort adunk vissza
-      return new Array<number>(vector.length).fill(0);
-    }
-
-    return vector.map((value: number) => value / magnitude);
-  }
-
-  /**
-   * Cosine similarity számítás két vektor között
-   * Normalizált vektorokat használ a számításhoz
-   * Eredmény: 0 és 1 közötti érték, ahol 1 a legnagyobb hasonlóság
-   * Statikus metódus, mivel nincs szüksége instance state-re
-   */
-  static cosineSimilarity(a: number[], b: number[]): number {
-    if (a.length !== b.length) {
-      throw new Error(
-        `Vectors must have the same dimension. Got ${a.length} and ${b.length}`
-      );
-    }
-
-    // Normalizáljuk a vektorokat
-    const normalizedA: number[] = this.l2Normalize(a);
-    const normalizedB: number[] = this.l2Normalize(b);
-
-    // Dot product számítása
-    let dotProduct: number = 0;
-    for (let i: number = 0; i < normalizedA.length; i++) {
-      dotProduct += normalizedA[i] * normalizedB[i];
-    }
-
-    // Cosine similarity = dot product of normalized vectors
-    // Mivel a vektorok normalizáltak, ez egyenlő a cosine similarity-vel
-    return dotProduct;
-  }
-
-  /**
-   * L2 distance (Euklideszi távolság) számítás két vektor között
-   * Eredmény: 0 vagy pozitív érték, ahol 0 a legkisebb távolság
-   * Statikus metódus, mivel nincs szüksége instance state-re
-   */
-  static l2Distance(a: number[], b: number[]): number {
-    if (a.length !== b.length) {
-      throw new Error(
-        `Vectors must have the same dimension. Got ${a.length} and ${b.length}`
-      );
-    }
-
-    // L2 distance = sqrt(sum((a[i] - b[i])^2))
-    let sumSquaredDiff: number = 0;
-    for (let i: number = 0; i < a.length; i++) {
-      const diff: number = a[i] - b[i];
-      sumSquaredDiff += diff * diff;
-    }
-
-    return Math.sqrt(sumSquaredDiff);
-  }
-
-  /**
-   * Vektor keresés a pool-ban
-   * Brute-force megközelítés (lineáris keresés)
-   * 
-   * @param query A keresési query vektor
-   * @param k A visszaadandó találatok száma (top-K)
-   * @param mode A keresési mód (cosine similarity vagy L2 distance)
-   * @returns A top-K találatok ID-val és score-rel, megfelelő sorrendben
-   */
-  search(
-    query: number[],
-    k: number,
-    mode: LVS_Search_Mode
-  ): LVS_SearchResult[] {
-    if (!Array.isArray(query) || query.length === 0) {
-      throw new Error('Query vector must be a non-empty array');
-    }
-
-    if (k <= 0) {
-      throw new Error('k must be a positive number');
-    }
-
-    if (this.vectorPool.size === 0) {
-      return [];
-    }
-
-    // Validáljuk, hogy minden vektor ugyanolyan dimenziójú-e
-    const firstVector: number[] | undefined = Array.from(this.vectorPool.values())[0];
-    if (firstVector && firstVector.length !== query.length) {
-      throw new Error(
-        `Query vector dimension (${query.length}) does not match pool vector ` +
-        `dimension (${firstVector.length})`
-      );
-    }
-
-    // Számoljuk ki a hasonlóságot/távolságot minden vektorra
-    const results: LVS_SearchResult[] = [];
-
-    for (const [id, vector] of this.vectorPool.entries()) {
-      let score: number;
-
-      if (mode === LVS_Search_Mode.cosineSimilarity) {
-        // Cosine similarity: nagyobb érték = jobb hasonlóság
-        score = LVS_VectorPool_ControlService.cosineSimilarity(query, vector);
-      } else if (mode === LVS_Search_Mode.l2Distance) {
-        // L2 distance: kisebb érték = jobb hasonlóság
-        score = LVS_VectorPool_ControlService.l2Distance(query, vector);
-      } else {
-        throw new Error(`Unknown search mode: ${mode}`);
-      }
-
-      results.push({ id, score });
-    }
-
-    // Rendezzük az eredményeket
-    if (mode === LVS_Search_Mode.cosineSimilarity) {
-      // Cosine similarity: csökkenő sorrend (legnagyobb hasonlóság először)
-      results.sort((a: LVS_SearchResult, b: LVS_SearchResult) => b.score - a.score);
-    } else {
-      // L2 distance: növekvő sorrend (legkisebb távolság először)
-      results.sort((a: LVS_SearchResult, b: LVS_SearchResult) => a.score - b.score);
-    }
-
-    // Visszaadjuk a top-K találatot
-    return results.slice(0, k);
-  }
-}
-
+import { LVS_Search_Mode } from '../_enums/lvs-search-mode.enum';
+import { LVS_SearchResult } from '../_models/lvs-search-result.interface';
+
+/**
+ * Vektor pool kezelő utility class
+ * Instance-based class, amely in-memory vektor pool-t kezel és vektor hasonlósági számításokat végez
+ * Minden instance saját vektor pool-t tart fenn
+ */
+export class LVS_VectorPool_ControlService {
+  /**
+   * In-memory vektor pool tárolás
+   * Key: vektor ID, Value: vektor értékek
+   */
+  private vectorPool: Map<string, number[]> = new Map<string, number[]>();
+
+  /**
+   * Normalizált vektor pool tárolás (L2 normalizált másolatok)
+   * Key: vektor ID, Value: L2 normalizált vektor értékek
+   */
+  private normalizedVectorPool: Map<string, number[]> = new Map<string, number[]>();
+
+  /**
+   * Hozzáad egy vektort a pool-hoz
+   * Opcionálisan L2 normalizált másolatot is tárol
+   */
+  addVector(id: string, vector: number[]): void {
+    if (!id) {
+      throw new Error('Vector ID is required');
+    }
+
+    if (!Array.isArray(vector) || vector.length === 0) {
+      throw new Error('Vector must be a non-empty array');
+    }
+
+    // Validáljuk, hogy a vektor számokból áll
+    for (let i: number = 0; i < vector.length; i++) {
+      if (typeof vector[i] !== 'number' || !isFinite(vector[i])) {
+        throw new Error(`Vector must contain only finite numbers at index ${i}`);
+      }
+    }
+
+    // Tároljuk az eredeti vektort
+    this.vectorPool.set(id, vector);
+
+    // L2 normalizált másolatot is tárolunk a cosine similarity számításokhoz
+    const normalized: number[] = LVS_VectorPool_ControlService.l2Normalize(vector);
+    this.normalizedVectorPool.set(id, normalized);
+  }
+
+  /**
+   * Eltávolít egy vektort a pool-ból
+   */
+  removeVector(id: string): void {
+    this.vectorPool.delete(id);
+    this.normalizedVectorPool.delete(id);
+  }
+
+  /**
+   * Frissít egy vektort a pool-ban
+   */
+  updateVector(id: string, vector: number[]): void {
+    if (!this.vectorPool.has(id)) {
+      throw new Error(`Vector with ID "${id}" does not exist`);
+    }
+
+    this.addVector(id, vector);
+  }
+
+  /**
+   * Törli az összes vektort a pool-ból
+   */
+  clearPool(): void {
+    this.vectorPool.clear();
+    this.normalizedVectorPool.clear();
+  }
+
+  /**
+   * Visszaadja az összes vektort a pool-ból
+   * Debugging és export céljára
+   */
+  getAll(): Map<string, number[]> {
+    return new Map<string, number[]>(this.vectorPool);
+  }
+
+  /**
+   * L2 normalizálás egy vektorra
+   * A vektor hosszát 1-re normalizálja
+   * Statikus metódus, mivel nincs szüksége instance state-re
+   */
+  private static l2Normalize(vector: number[]): number[] {
+    const magnitude: number = Math.sqrt(
+      vector.reduce((sum: number, value: number) => sum + value * value, 0)
+    );
+
+    if (magnitude === 0) {
+      // Ha a vektor nullvektor, akkor nullvektort adunk vissza
+      return new Array<number>(vector.length).fill(0);
+    }
+
+    return vector.map((value: number) => value / magnitude);
+  }
+
+  /**
+   * Cosine similarity számítás két vektor között
+   * Normalizált vektorokat használ a számításhoz
+   * Eredmény: 0 és 1 közötti érték, ahol 1 a legnagyobb hasonlóság
+   * Statikus metódus, mivel nincs szüksége instance state-re
+   */
+  static cosineSimilarity(a: number[], b: number[]): number {
+    if (a.length !== b.length) {
+      throw new Error(
+        `Vectors must have the same dimension. Got ${a.length} and ${b.length}`
+      );
+    }
+
+    // Normalizáljuk a vektorokat
+    const normalizedA: number[] = this.l2Normalize(a);
+    const normalizedB: number[] = this.l2Normalize(b);
+
+    // Dot product számítása
+    let dotProduct: number = 0;
+    for (let i: number = 0; i < normalizedA.length; i++) {
+      dotProduct += normalizedA[i] * normalizedB[i];
+    }
+
+    // Cosine similarity = dot product of normalized vectors
+    // Mivel a vektorok normalizáltak, ez egyenlő a cosine similarity-vel
+    return dotProduct;
+  }
+
+  /**
+   * L2 distance (Euklideszi távolság) számítás két vektor között
+   * Eredmény: 0 vagy pozitív érték, ahol 0 a legkisebb távolság
+   * Statikus metódus, mivel nincs szüksége instance state-re
+   */
+  static l2Distance(a: number[], b: number[]): number {
+    if (a.length !== b.length) {
+      throw new Error(
+        `Vectors must have the same dimension. Got ${a.length} and ${b.length}`
+      );
+    }
+
+    // L2 distance = sqrt(sum((a[i] - b[i])^2))
+    let sumSquaredDiff: number = 0;
+    for (let i: number = 0; i < a.length; i++) {
+      const diff: number = a[i] - b[i];
+      sumSquaredDiff += diff * diff;
+    }
+
+    return Math.sqrt(sumSquaredDiff);
+  }
+
+  /**
+   * Vektor keresés a pool-ban
+   * Brute-force megközelítés (lineáris keresés)
+   * 
+   * @param query A keresési query vektor
+   * @param k A visszaadandó találatok száma (top-K)
+   * @param mode A keresési mód (cosine similarity vagy L2 distance)
+   * @returns A top-K találatok ID-val és score-rel, megfelelő sorrendben
+   */
+  search(
+    query: number[],
+    k: number,
+    mode: LVS_Search_Mode
+  ): LVS_SearchResult[] {
+    if (!Array.isArray(query) || query.length === 0) {
+      throw new Error('Query vector must be a non-empty array');
+    }
+
+    if (k <= 0) {
+      throw new Error('k must be a positive number');
+    }
+
+    if (this.vectorPool.size === 0) {
+      return [];
+    }
+
+    // Validáljuk, hogy minden vektor ugyanolyan dimenziójú-e
+    const firstVector: number[] | undefined = Array.from(this.vectorPool.values())[0];
+    if (firstVector && firstVector.length !== query.length) {
+      throw new Error(
+        `Query vector dimension (${query.length}) does not match pool vector ` +
+        `dimension (${firstVector.length})`
+      );
+    }
+
+    // Számoljuk ki a hasonlóságot/távolságot minden vektorra
+    const results: LVS_SearchResult[] = [];
+
+    for (const [id, vector] of this.vectorPool.entries()) {
+      let score: number;
+
+      if (mode === LVS_Search_Mode.cosineSimilarity) {
+        // Cosine similarity: nagyobb érték = jobb hasonlóság
+        score = LVS_VectorPool_ControlService.cosineSimilarity(query, vector);
+      } else if (mode === LVS_Search_Mode.l2Distance) {
+        // L2 distance: kisebb érték = jobb hasonlóság
+        score = LVS_VectorPool_ControlService.l2Distance(query, vector);
+      } else {
+        throw new Error(`Unknown search mode: ${mode}`);
+      }
+
+      results.push({ id, score });
+    }
+
+    // Rendezzük az eredményeket
+    if (mode === LVS_Search_Mode.cosineSimilarity) {
+      // Cosine similarity: csökkenő sorrend (legnagyobb hasonlóság először)
+      results.sort((a: LVS_SearchResult, b: LVS_SearchResult) => b.score - a.score);
+    } else {
+      // L2 distance: növekvő sorrend (legkisebb távolság először)
+      results.sort((a: LVS_SearchResult, b: LVS_SearchResult) => a.score - b.score);
+    }
+
+    // Visszaadjuk a top-K találatot
+    return results.slice(0, k);
+  }
+}
+

package/src/_modules/local-vector-search/index.ts

@@ -1,12 +1,12 @@
-
-
-// ENUMS
-export * from './_enums/lvs-search-mode.enum';
-
-// INTERFACES
-export * from './_models/lvs-search-result.interface';
-
-// SERVICES
-export * from './_services/lvs-doc-chunk-data.service';
-export * from './_services/lvs-local-vector-search.data-service';
+
+
+// ENUMS
+export * from './_enums/lvs-search-mode.enum';
+
+// INTERFACES
+export * from './_models/lvs-search-result.interface';
+
+// SERVICES
+export * from './_services/lvs-doc-chunk-data.service';
+export * from './_services/lvs-local-vector-search.data-service';
 export * from './_services/lvs-vector-pool.control-service';

package/src/_modules/logs/get-logs-routing-module.util.ts

@@ -0,0 +1,36 @@
+import { Request, Response } from 'express';
+
+import { DyNTS_RoutingModule_Settings } from '../../_models/interfaces/routing-module-settings.interface';
+import { DyNTS_RoutingModule } from '../../_services/route/routing-module.service';
+import { DyNTS_Logs_Controller, DyNTS_LogsController_Config } from './logs.controller';
+
+/**
+ * Letrehoz egy /logs routing module-t a szerver logok lekeresehez.
+ *
+ * Hasznalat (auth NELKUL — barki elerheti):
+ *   DyNTS_getLogsRoutingModule()
+ *
+ * Hasznalat (auth-TAL — a megadott preProcess fut elotte):
+ *   DyNTS_getLogsRoutingModule({
+ *     authPreProcess: authService.authenticate_sercretKey
+ *   })
+ *
+ * FONTOS: A szerver indulasakor meg kell hivni:
+ *   DyNTS_Logs_Service.getInstance().install()
+ * es a log_settings.logs_endpoint.enabled = true kell legyen.
+ */
+export function DyNTS_getLogsRoutingModule(
+  config?: DyNTS_LogsController_Config
+): DyNTS_RoutingModule {
+  // Konfiguracio atadasa a controller-nek (static, mert a singleton elott kell)
+  if (config) {
+    DyNTS_Logs_Controller.configure(config);
+  }
+
+  const set: DyNTS_RoutingModule_Settings = {
+    route: '/logs',
+    controllers: [DyNTS_Logs_Controller.getInstance()],
+  };
+
+  return new DyNTS_RoutingModule(set);
+}

package/src/_modules/logs/index.ts

@@ -0,0 +1,3 @@
+export { DyNTS_Logs_Service } from './logs.service';
+export { DyNTS_Logs_Controller, DyNTS_LogsController_Config } from './logs.controller';
+export { DyNTS_getLogsRoutingModule } from './get-logs-routing-module.util';

package/src/_modules/logs/log-buffer.service.ts

@@ -0,0 +1,101 @@
+
+import { DyNTS_SingletonService } from '../../_services/base/singleton.service';
+
+/**
+ * In-memory ring buffer a szerver console kimenethez.
+ * Interceptalja a console.log/error/warn/info hivasokat es eltarolja az utolso N sort.
+ *
+ * Hasznalat:
+ *   DyNTS_LogBuffer_Service.getInstance().install();  // app startup-nal
+ *   DyNTS_LogBuffer_Service.getInstance().getLines(100);  // utolso 100 sor
+ */
+export class DyNTS_LogBuffer_Service extends DyNTS_SingletonService {
+
+  static getInstance(): DyNTS_LogBuffer_Service {
+    return DyNTS_LogBuffer_Service.getSingletonInstance();
+  }
+
+  private readonly maxLines: number = 2000;
+  private readonly buffer: string[] = [];
+  private installed: boolean = false;
+
+  /**
+   * Interceptalja a console.log/error/warn/info kimeneteket es a bufferbe irja.
+   * Egyszer kell hivni, a szerver indulasakor (lehetoleg a legelso muvelet).
+   */
+  install(): void {
+    if (this.installed) { return; }
+    this.installed = true;
+
+    const self: DyNTS_LogBuffer_Service = this;
+
+    const originalLog: typeof console.log = console.log.bind(console);
+    const originalError: typeof console.error = console.error.bind(console);
+    const originalWarn: typeof console.warn = console.warn.bind(console);
+    const originalInfo: typeof console.info = console.info.bind(console);
+
+    console.log = (...args: any[]): void => {
+      self.addLine('LOG', args);
+      originalLog(...args);
+    };
+
+    console.error = (...args: any[]): void => {
+      self.addLine('ERR', args);
+      originalError(...args);
+    };
+
+    console.warn = (...args: any[]): void => {
+      self.addLine('WRN', args);
+      originalWarn(...args);
+    };
+
+    console.info = (...args: any[]): void => {
+      self.addLine('INF', args);
+      originalInfo(...args);
+    };
+  }
+
+  /**
+   * A log buffer be van-e kapcsolva (install megtortent-e).
+   */
+  isInstalled(): boolean {
+    return this.installed;
+  }
+
+  /**
+   * Az utolso N sor lekerdezese.
+   */
+  getLines(count: number = 200): string[] {
+    const start: number = Math.max(0, this.buffer.length - count);
+    return this.buffer.slice(start);
+  }
+
+  /**
+   * Az osszes buffered sor szama.
+   */
+  getLineCount(): number {
+    return this.buffer.length;
+  }
+
+  /**
+   * Buffer uritese.
+   */
+  clear(): void {
+    this.buffer.length = 0;
+  }
+
+  private addLine(level: string, args: any[]): void {
+    const timestamp: string = new Date().toISOString();
+    const message: string = args.map(formatArg).join(' ');
+    this.buffer.push(`${timestamp} [${level}] ${message}`);
+
+    if (this.buffer.length > this.maxLines) {
+      this.buffer.shift();
+    }
+  }
+}
+
+function formatArg(arg: any): string {
+  if (typeof arg === 'string') { return arg; }
+  try { return JSON.stringify(arg); } catch { return String(arg); }
+}