@futdevpro/nts-dynamo 1.15.56 → 1.15.58

package/src/_modules/discord-bot/_services/dibo-routines.control-service.spec.ts

@@ -1,105 +1,105 @@
-
-import { DyNTS_DiBo_Routines_ControlService } from './dibo-routines.control-service';
-import { DyNTS_DiBo_Main_ControlService } from './dibo-main.control-service';
-import { Guild } from 'discord.js';
-import { DyFM_Error } from '@futdevpro/fsm-dynamo';
-
-class TestDiBoRoutinesService extends DyNTS_DiBo_Routines_ControlService {
-  protected getMainDiscordBotControlService(): DyNTS_DiBo_Main_ControlService {
-    return this.mainDiscordBot_CS;
-  }
-
-  async startRoutines(issuer: string): Promise<void> {
-    // Mock implementation
-  }
-
-  static getInstance(): TestDiBoRoutinesService {
-    return TestDiBoRoutinesService.getSingletonInstance();
-  }
-}
-
-xdescribe('| DyNTS_DiBo_Routines_ControlService', () => {
-  let service: TestDiBoRoutinesService;
-  let mockMain_CS: jasmine.SpyObj<DyNTS_DiBo_Main_ControlService>;
-  let mockGuild: jasmine.SpyObj<Guild>;
-
-  beforeEach(() => {
-    mockGuild = jasmine.createSpyObj('Guild', [], {
-      id: 'guild-123',
-    });
-
-    mockMain_CS = jasmine.createSpyObj('DyNTS_DiBo_Main_ControlService', [], {
-      discordServer: mockGuild,
-    });
-
-    service = new (TestDiBoRoutinesService as any)();
-    (service as any).mainDiscordBot_CS = mockMain_CS;
-  });
-
-  describe('| properties', () => {
-    it('| should return discordServer from main service', () => {
-      expect(service.discordServer).toBe(mockGuild);
-    });
-
-    it('| should return routinesStarted as false initially', () => {
-      expect(service.routinesStarted).toBeUndefined();
-    });
-  });
-
-  describe('| setup', () => {
-    it('| should setup service with main service', async () => {
-      await service.setup('test-issuer');
-
-      expect((service as any).mainDiscordBot_CS).toBe(mockMain_CS);
-    });
-
-    it('| should throw error if main service not found', async () => {
-      (service as any).getMainDiscordBotControlService = () => null;
-
-      try {
-        await service.setup('test-issuer');
-        fail('Should have thrown an error');
-      } catch (error) {
-        expect(error).toBeInstanceOf(DyFM_Error);
-        expect((error as DyFM_Error)._errorCode).toContain('DyNTS-DiBo-RCS-S01');
-      }
-    });
-  });
-
-  describe('| start', () => {
-    it('| should start routines and set routinesStarted to true', async () => {
-      spyOn(service, 'startRoutines').and.returnValue(Promise.resolve());
-
-      await service.start('test-issuer');
-
-      expect(service.startRoutines).toHaveBeenCalled();
-      expect(service.routinesStarted).toBe(true);
-    });
-
-    it('| should throw error if discordServer not found', async () => {
-      (service as any).mainDiscordBot_CS = null;
-
-      try {
-        await service.start('test-issuer');
-        fail('Should have thrown an error');
-      } catch (error) {
-        expect(error).toBeInstanceOf(DyFM_Error);
-        expect((error as DyFM_Error)._errorCode).toContain('DyNTS-DiBo-RCS-ST01');
-      }
-    });
-
-    it('| should handle start errors', async () => {
-      const error = new Error('Start routines error');
-      spyOn(service, 'startRoutines').and.returnValue(Promise.reject(error));
-
-      try {
-        await service.start('test-issuer');
-        fail('Should have thrown an error');
-      } catch (err) {
-        expect(err).toBeInstanceOf(DyFM_Error);
-        expect((err as DyFM_Error)._errorCode).toContain('DyNTS-DiBo-RCS-ST0');
-      }
-    });
-  });
-});
-
+
+import { DyNTS_DiBo_Routines_ControlService } from './dibo-routines.control-service';
+import { DyNTS_DiBo_Main_ControlService } from './dibo-main.control-service';
+import { Guild } from 'discord.js';
+import { DyFM_Error } from '@futdevpro/fsm-dynamo';
+
+class TestDiBoRoutinesService extends DyNTS_DiBo_Routines_ControlService {
+  protected getMainDiscordBotControlService(): DyNTS_DiBo_Main_ControlService {
+    return this.mainDiscordBot_CS;
+  }
+
+  async startRoutines(issuer: string): Promise<void> {
+    // Mock implementation
+  }
+
+  static getInstance(): TestDiBoRoutinesService {
+    return TestDiBoRoutinesService.getSingletonInstance();
+  }
+}
+
+xdescribe('| DyNTS_DiBo_Routines_ControlService', () => {
+  let service: TestDiBoRoutinesService;
+  let mockMain_CS: jasmine.SpyObj<DyNTS_DiBo_Main_ControlService>;
+  let mockGuild: jasmine.SpyObj<Guild>;
+
+  beforeEach(() => {
+    mockGuild = jasmine.createSpyObj('Guild', [], {
+      id: 'guild-123',
+    });
+
+    mockMain_CS = jasmine.createSpyObj('DyNTS_DiBo_Main_ControlService', [], {
+      discordServer: mockGuild,
+    });
+
+    service = new (TestDiBoRoutinesService as any)();
+    (service as any).mainDiscordBot_CS = mockMain_CS;
+  });
+
+  describe('| properties', () => {
+    it('| should return discordServer from main service', () => {
+      expect(service.discordServer).toBe(mockGuild);
+    });
+
+    it('| should return routinesStarted as false initially', () => {
+      expect(service.routinesStarted).toBeUndefined();
+    });
+  });
+
+  describe('| setup', () => {
+    it('| should setup service with main service', async () => {
+      await service.setup('test-issuer');
+
+      expect((service as any).mainDiscordBot_CS).toBe(mockMain_CS);
+    });
+
+    it('| should throw error if main service not found', async () => {
+      (service as any).getMainDiscordBotControlService = () => null;
+
+      try {
+        await service.setup('test-issuer');
+        fail('Should have thrown an error');
+      } catch (error) {
+        expect(error).toBeInstanceOf(DyFM_Error);
+        expect((error as DyFM_Error)._errorCode).toContain('DyNTS-DiBo-RCS-S01');
+      }
+    });
+  });
+
+  describe('| start', () => {
+    it('| should start routines and set routinesStarted to true', async () => {
+      spyOn(service, 'startRoutines').and.returnValue(Promise.resolve());
+
+      await service.start('test-issuer');
+
+      expect(service.startRoutines).toHaveBeenCalled();
+      expect(service.routinesStarted).toBe(true);
+    });
+
+    it('| should throw error if discordServer not found', async () => {
+      (service as any).mainDiscordBot_CS = null;
+
+      try {
+        await service.start('test-issuer');
+        fail('Should have thrown an error');
+      } catch (error) {
+        expect(error).toBeInstanceOf(DyFM_Error);
+        expect((error as DyFM_Error)._errorCode).toContain('DyNTS-DiBo-RCS-ST01');
+      }
+    });
+
+    it('| should handle start errors', async () => {
+      const error = new Error('Start routines error');
+      spyOn(service, 'startRoutines').and.returnValue(Promise.reject(error));
+
+      try {
+        await service.start('test-issuer');
+        fail('Should have thrown an error');
+      } catch (err) {
+        expect(err).toBeInstanceOf(DyFM_Error);
+        expect((err as DyFM_Error)._errorCode).toContain('DyNTS-DiBo-RCS-ST0');
+      }
+    });
+  });
+});
+

package/src/_modules/discord-bot/index.ts

@@ -1,36 +1,36 @@
-
-
-
-
-/* try {
-  require.resolve('discord.js');
-} catch (error) {
-  console.log(
-    '❌ Discord.js package not found, please install it with: pnpm add discord.js'
-  );
-} */
-
-//
-// Discord Bot module
-//
-// This module is created to simplify the usage of Discord Bot
-// It creates universal solutions for the most common use cases
-//
-
-
-// COLLECTIONS
-export * from './_collections/dibo-default-commands.const';
-export * from './_collections/dibo-global-settings.conts';
-export * from './_collections/dibo-operations.util';
-
-// MODELS
-export * from './_models/dibo-command.interface';
-export * from './_models/dibo-last-mention-date.inteface';
-export * from './_models/dibo-last-message-date.interface';
-export * from './_models/dibo-global-settings.interface';
-
-// SERVICES
-export * from './_services/dibo-commands.control-service';
-export * from './_services/dibo-io.control-service';
-export * from './_services/dibo-main.control-service';
-export * from './_services/dibo-routines.control-service';
+
+
+
+
+/* try {
+  require.resolve('discord.js');
+} catch (error) {
+  console.log(
+    '❌ Discord.js package not found, please install it with: pnpm add discord.js'
+  );
+} */
+
+//
+// Discord Bot module
+//
+// This module is created to simplify the usage of Discord Bot
+// It creates universal solutions for the most common use cases
+//
+
+
+// COLLECTIONS
+export * from './_collections/dibo-default-commands.const';
+export * from './_collections/dibo-global-settings.conts';
+export * from './_collections/dibo-operations.util';
+
+// MODELS
+export * from './_models/dibo-command.interface';
+export * from './_models/dibo-last-mention-date.inteface';
+export * from './_models/dibo-last-message-date.interface';
+export * from './_models/dibo-global-settings.interface';
+
+// SERVICES
+export * from './_services/dibo-commands.control-service';
+export * from './_services/dibo-io.control-service';
+export * from './_services/dibo-main.control-service';
+export * from './_services/dibo-routines.control-service';

package/src/_modules/local-vector-search/_enums/lvs-search-mode.enum.ts

@@ -1,35 +1,35 @@
-/**
- * Vektor keresési mód enum
- * Meghatározza, hogy milyen metrikát használunk a vektorok közötti hasonlóság számításához
- */
-export enum LVS_Search_Mode {
-  /**
-   * Cosine similarity (koszinusz hasonlóság)
-   * 0 és 1 közötti érték, ahol 1 a legnagyobb hasonlóság
-   * Eredmények csökkenő sorrendben (legnagyobb hasonlóság először)
-   */
-  cosineSimilarity = 'cosine-similarity',
-  /**
-   * L2 distance (Euklideszi távolság)
-   * 0 vagy pozitív érték, ahol 0 a legkisebb távolság (legnagyobb hasonlóság)
-   * Eredmények növekvő sorrendben (legkisebb távolság először)
-   */
-  l2Distance = 'l2-distance',
-  /**
-   * Hybrid search: cosine similarity (vektor-fele) + BM25 (text-fele) score-merge.
-   *
-   * Hasznalat:
-   *  - `searchMode: LVS_Search_Mode.hybrid`
-   *  - `textSearchKey: keyof T` — KOTELEZO; melyik string property-n fut a BM25
-   *  - `hybridWeight?: { vector: number; text: number }` — default { vector: 0.5, text: 0.5 }
-   *
-   * BM25 min-max normalizalva [0,1] a candidate-szettre (cosine mar 0..1), igy
-   * a `weight` direkt linearis kombinacio. Ha minden BM25 score 0 (egyetlen
-   * query term sem matchel), a hybrid effektivan cosine-only-re degradalodik.
-   *
-   * L2+hybrid kombinacio NEM tamogatott — a hybrid mindig cosine-alapu
-   * vector-half-fel mukodik.
-   */
-  hybrid = 'hybrid',
-}
-
+/**
+ * Vektor keresési mód enum
+ * Meghatározza, hogy milyen metrikát használunk a vektorok közötti hasonlóság számításához
+ */
+export enum LVS_Search_Mode {
+  /**
+   * Cosine similarity (koszinusz hasonlóság)
+   * 0 és 1 közötti érték, ahol 1 a legnagyobb hasonlóság
+   * Eredmények csökkenő sorrendben (legnagyobb hasonlóság először)
+   */
+  cosineSimilarity = 'cosine-similarity',
+  /**
+   * L2 distance (Euklideszi távolság)
+   * 0 vagy pozitív érték, ahol 0 a legkisebb távolság (legnagyobb hasonlóság)
+   * Eredmények növekvő sorrendben (legkisebb távolság először)
+   */
+  l2Distance = 'l2-distance',
+  /**
+   * Hybrid search: cosine similarity (vektor-fele) + BM25 (text-fele) score-merge.
+   *
+   * Hasznalat:
+   *  - `searchMode: LVS_Search_Mode.hybrid`
+   *  - `textSearchKey: keyof T` — KOTELEZO; melyik string property-n fut a BM25
+   *  - `hybridWeight?: { vector: number; text: number }` — default { vector: 0.5, text: 0.5 }
+   *
+   * BM25 min-max normalizalva [0,1] a candidate-szettre (cosine mar 0..1), igy
+   * a `weight` direkt linearis kombinacio. Ha minden BM25 score 0 (egyetlen
+   * query term sem matchel), a hybrid effektivan cosine-only-re degradalodik.
+   *
+   * L2+hybrid kombinacio NEM tamogatott — a hybrid mindig cosine-alapu
+   * vector-half-fel mukodik.
+   */
+  hybrid = 'hybrid',
+}
+

package/src/_modules/local-vector-search/_models/data-models/lvs-vector-persist.data-model.ts

@@ -0,0 +1,59 @@
+
+import { DyFM_DataModel_Params, DyFM_Metadata, DyFM_Object } from '@futdevpro/fsm-dynamo';
+
+/**
+ * `DyNTS_LVS_VectorPersist_DataModel` (BFR-AM-001) — egy MongoDB-ben perzistált vektor-rekord, ami a
+ * `LVS_VectorPool_ControlService` **in-memory** pool-jának tartós háttértára. A FAM (fdp-agent-memory)
+ * workaround-ját generalizálja: a vektorok a SAJÁT Mongo-ban élnek, boot-kor a memória-pool-ba
+ * hidratálódnak — **NEM** MongoDB Atlas Vector Search.
+ *
+ * Egy dokumentum = **egy vektor egy adott pool-ban**. A `collectionKey` particionálja a pool-okat
+ * (egy fogyasztó több, logikailag elkülönített pool-t tarthat — pl. táranként). A `vectorId` a pool-on
+ * belüli kulcs (a `pool.addVector(vectorId, embedding)` ezzel illeszt).
+ *
+ * `extends DyFM_Metadata`: az identitás/metadata (`_id`, `__created`, `__lastModified`, `_deleted`) az
+ * ősből jön. A `metadata` `unknown` (Mongoose `Mixed`) — a fogyasztó tetszőleges kísérő-adatot tárolhat
+ * (a séma NEM validál); az `embedding` `number[]` a perzistált nyers vektor.
+ */
+export class DyNTS_LVS_VectorPersist_DataModel extends DyFM_Metadata {
+
+  /** A pool-on belüli vektor-kulcs (a `pool.addVector(vectorId, ...)` ezzel illeszt). */
+  vectorId?: string;
+
+  /** Melyik (logikai) pool-hoz tartozik — a pool-particionálás kulcsa (hidratálás-szűrő). */
+  collectionKey?: string;
+
+  /** A perzistált NYERS vektor (a pool maga számolja a normalizált másolatot). */
+  embedding?: number[];
+
+  /** A vektor dimenziója (homogenitás-ellenőrzéshez + diagnosztikához tárolt). */
+  dimensions?: number;
+
+  /** Opcionális fogyasztó-specifikus kísérő-adat (Mongoose `Mixed`; a séma NEM validál). */
+  metadata?: unknown;
+
+  constructor(set?: Partial<DyNTS_LVS_VectorPersist_DataModel>) {
+    super(set);
+    if (set) {
+      DyFM_Object.cleanAssign(this, set);
+    }
+  }
+}
+
+/**
+ * MongoDB data-params a `dynts_lvs_vector` collection-höz (BFR-AM-001). Az `embedding` `number[]` a
+ * perzistált nyers vektor; a `metadata` `type:'object'` (Mongoose `Mixed`) — a séma NEM validál. A
+ * `vectorId` + `collectionKey` index-elt (a hidratálás `collectionKey`-re, az upsert/remove a
+ * `vectorId`+`collectionKey` párra szűr).
+ */
+export const dyNTS_lvsVectorPersist_dataParams: DyFM_DataModel_Params<DyNTS_LVS_VectorPersist_DataModel> =
+  new DyFM_DataModel_Params<DyNTS_LVS_VectorPersist_DataModel>({
+    dataName: 'dynts_lvs_vector',
+    properties: {
+      vectorId: { type: 'string', index: true, required: true },
+      collectionKey: { type: 'string', index: true, required: true },
+      embedding: { type: 'number[]' },
+      dimensions: { type: 'number' },
+      metadata: { type: 'object' },
+    },
+  });

package/src/_modules/local-vector-search/_models/lvs-search-result.interface.ts

@@ -1,17 +1,17 @@
-/**
- * Vektor keresési eredmény interface
- * Tartalmazza a találat ID-ját és a hasonlósági pontszámot
- */
-export interface LVS_SearchResult {
-  /**
-   * A találat egyedi azonosítója
-   */
-  id: string;
-  /**
-   * A hasonlósági pontszám
-   * Cosine similarity esetén: 0-1 közötti érték (1 = legnagyobb hasonlóság)
-   * L2 distance esetén: 0 vagy pozitív érték (0 = legkisebb távolság, legnagyobb hasonlóság)
-   */
-  score: number;
-}
-
+/**
+ * Vektor keresési eredmény interface
+ * Tartalmazza a találat ID-ját és a hasonlósági pontszámot
+ */
+export interface LVS_SearchResult {
+  /**
+   * A találat egyedi azonosítója
+   */
+  id: string;
+  /**
+   * A hasonlósági pontszám
+   * Cosine similarity esetén: 0-1 közötti érték (1 = legnagyobb hasonlóság)
+   * L2 distance esetén: 0 vagy pozitív érték (0 = legkisebb távolság, legnagyobb hasonlóság)
+   */
+  score: number;
+}
+