@futdevpro/nts-dynamo 1.15.58 → 1.15.60

package/src/_modules/ai/_services/lmstudio-embedding.control-service.ts

@@ -1,11 +1,12 @@
 import { CreateEmbeddingResponse } from 'openai/resources';
+
+import { DyFM_Error, DyFM_Log } from '@futdevpro/fsm-dynamo';
 import { DyFM_AI_Provider, DyFM_AI_ProviderCapabilities, DyFM_AI_Config } from '@futdevpro/fsm-dynamo/ai';
 import { DyFM_DAI_EmbeddingInfo } from '@futdevpro/fsm-dynamo/ai/document-ai';
-import { DyFM_Error, DyFM_Log } from '@futdevpro/fsm-dynamo';
 
-import { DyNTS_AI_Embedding_ServiceBase } from './ai-embedding.service-base';
 import { DyNTS_AI_CostEventCallback } from '../_models/interfaces/dynts-ai-cost-event-callback.interface';
 import { DyNTS_global_settings } from '../../../_collections/global-settings.const';
+import { DyNTS_AI_Embedding_ServiceBase } from './ai-embedding.service-base';
 
 /**
  * Az LM Studio embedding control-service config-set-je. A `baseUrl` az OpenAI-kompatibilis
@@ -68,7 +69,8 @@ export class DyNTS_LMStudio_Embedding_ControlService extends DyNTS_AI_Embedding_
    */
   constructor(set: DyNTS_LMStudio_Embedding_Settings) {
     super();
-    if (!set?.baseUrl || !set.baseUrl.trim().length) {
+
+    if (!set?.baseUrl?.trim().length) {
       throw new DyFM_Error({
         ...this.getDefaultErrorSettings(
           'constructor',
@@ -80,6 +82,7 @@ export class DyNTS_LMStudio_Embedding_ControlService extends DyNTS_AI_Embedding_
     }
     this.baseUrl = this.trimTrailingSlashes(set.baseUrl.trim());
     this.apiKey = set.apiKey;
+
     if (set.onCostEvent) {
       this.onCostEvent = set.onCostEvent;
     }
@@ -93,6 +96,7 @@ export class DyNTS_LMStudio_Embedding_ControlService extends DyNTS_AI_Embedding_
     if (config?.baseURL) {
       this.baseUrl = this.trimTrailingSlashes(config.baseURL);
     }
+
     if (config?.apiKey) {
       this.apiKey = config.apiKey;
     }
@@ -122,16 +126,18 @@ export class DyNTS_LMStudio_Embedding_ControlService extends DyNTS_AI_Embedding_
       const response: CreateEmbeddingResponse = await this.callEmbeddingsEndpoint(set.model, set.text, set.issuer);
       const durationMs: number = Date.now() - start;
 
-      this.emitLmStudioCostEvent('embedding-single', set.model, [set.text], response, durationMs, set.issuer);
+      this.emitLmStudioCostEvent('embedding-single', set.model, [ set.text ], response, durationMs, set.issuer);
 
       if (set.fullResponse) {
         return response;
       }
+
       return response.data[0].embedding;
     } catch (error) {
       if (error instanceof DyFM_Error) {
         throw error;
       }
+
       throw new DyFM_Error({
         ...this.getDefaultErrorSettings('createEmbedding', error, set.issuer),
         errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-LMS-ECS-CE0`,
@@ -168,11 +174,13 @@ export class DyNTS_LMStudio_Embedding_ControlService extends DyNTS_AI_Embedding_
       if (set.fullResponse) {
         return response;
       }
+
       return response.data.map((item) => item.embedding);
     } catch (error) {
       if (error instanceof DyFM_Error) {
         throw error;
       }
+
       throw new DyFM_Error({
         ...this.getDefaultErrorSettings('createEmbeddings', error, set.issuer),
         errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-LMS-ECS-CES0`,
@@ -198,17 +206,19 @@ export class DyNTS_LMStudio_Embedding_ControlService extends DyNTS_AI_Embedding_
   async testConnection(issuer: string): Promise<boolean> {
     try {
       const vectors: number[][] | CreateEmbeddingResponse = await this.createEmbeddings({
-        texts: ['ping'],
+        texts: [ 'ping' ],
         model: this.defaultProbeModel(),
         fullResponse: false,
         issuer: issuer,
       });
+
       return Array.isArray(vectors) && vectors.length === 1 && vectors[0].length > 0;
     } catch (error) {
       DyFM_Log.error('DyNTS_LMStudio_Embedding_ControlService', 'testConnection', 'Connection test failed', {
         error: error,
         issuer: issuer,
       });
+
       return false;
     }
   }
@@ -229,6 +239,7 @@ export class DyNTS_LMStudio_Embedding_ControlService extends DyNTS_AI_Embedding_
   ): Promise<CreateEmbeddingResponse> {
     const url: string = `${this.baseUrl}/embeddings`;
     const headers: { [key: string]: string } = { 'Content-Type': 'application/json' };
+
     if (this.apiKey && this.apiKey.trim().length) {
       headers.Authorization = `Bearer ${this.apiKey.trim()}`;
     }
@@ -248,6 +259,7 @@ export class DyNTS_LMStudio_Embedding_ControlService extends DyNTS_AI_Embedding_
     }
 
     let parsed: unknown;
+
     try {
       parsed = JSON.parse(rawText);
     } catch {
@@ -257,6 +269,7 @@ export class DyNTS_LMStudio_Embedding_ControlService extends DyNTS_AI_Embedding_
     }
 
     const expectedCount: number = Array.isArray(input) ? input.length : 1;
+
     return this.normalizeResponse(parsed, expectedCount, url, model);
   }
 
@@ -270,21 +283,25 @@ export class DyNTS_LMStudio_Embedding_ControlService extends DyNTS_AI_Embedding_
       throw new Error(`LM Studio embeddings: invalid response object | url=${url} | model=${modelId}`);
     }
     const dataRaw: unknown = Reflect.get(json, 'data');
+
     if (!Array.isArray(dataRaw)) {
       throw new Error(`LM Studio embeddings: missing data array | url=${url} | model=${modelId}`);
     }
 
     const data: CreateEmbeddingResponse['data'] = [];
     let index: number = 0;
+
     for (const item of dataRaw) {
       if (item === null || typeof item !== 'object' || Array.isArray(item)) {
         continue;
       }
       const embRaw: unknown = Reflect.get(item, 'embedding');
+
       if (!Array.isArray(embRaw)) {
         continue;
       }
       const vec: number[] = embRaw.filter((x: unknown): x is number => typeof x === 'number' && Number.isFinite(x));
+
       if (vec.length) {
         data.push({ object: 'embedding', embedding: vec, index: index });
         index++;
@@ -345,9 +362,11 @@ export class DyNTS_LMStudio_Embedding_ControlService extends DyNTS_AI_Embedding_
   /** Becsült token-szám lokális endpoint-hoz (ha nincs `usage`): 4 char ≈ 1 token. */
   protected estimateTokens(texts: string[]): number {
     let chars: number = 0;
+
     for (const text of texts) {
       chars += (text ?? '').length;
     }
+
     return Math.max(1, Math.ceil(chars / 4));
   }
 
@@ -364,6 +383,7 @@ export class DyNTS_LMStudio_Embedding_ControlService extends DyNTS_AI_Embedding_
   /** Rövid, biztonságos válasz-snapshot a hiba-üzenethez (max 300 char). */
   protected snapshot(value: string): string {
     const trimmed: string = (value ?? '').slice(0, 300);
+
     return trimmed.length === 300 ? `${trimmed}…` : trimmed;
   }
 
@@ -373,6 +393,7 @@ export class DyNTS_LMStudio_Embedding_ControlService extends DyNTS_AI_Embedding_
       return 0;
     }
     const value: unknown = Reflect.get(obj, key);
+
     return typeof value === 'number' && Number.isFinite(value) ? value : 0;
   }
 }

package/src/_modules/ai/index.ts

@@ -5,6 +5,11 @@ export * from '@futdevpro/fsm-dynamo/ai';
 export * from './_models/ai-input-interfaces';
 export * from './_models/ai-test-generation-result.interface';
 
+// Cost-event interfaces (BFR-AM-007) — a consumer (CCAP / FAM) ezekkel típusozza az `onCostEvent`
+// callback-jét; ezért barrel-export kell (M3, FAM-REV bedrock-fix).
+export * from './_models/interfaces/dynts-ai-cost-event.interface';
+export * from './_models/interfaces/dynts-ai-cost-event-callback.interface';
+
 // Abstract Services
 export * from './_services/ai-provider.service-base';
 export * from './_services/ai-llm.service-base';

package/src/_modules/data-readers/_collections/dynts-sqlite-reader.util.spec.ts

@@ -9,6 +9,11 @@ import { DyFM_Error } from '@futdevpro/fsm-dynamo';
 import { DyNTS_Sqlite_Reader_Util } from './dynts-sqlite-reader.util';
 import { DyNTS_SqliteColumnInfo } from '../_models/interfaces/dynts-sqlite-reader.interface';
 
+interface NameInterface {
+  name: string;
+}
+
+
 /**
  * `DyNTS_Sqlite_Reader_Util` spec (BFR-AM-009). Egy temp `.db` fájlt hozunk létre (a reader path-szal
  * + `fileMustExist:true` nyit, ezért valódi fájl kell — a `:memory:` path-ön nem ad fájlt), feltöltjük,
@@ -20,142 +25,152 @@ import { DyNTS_SqliteColumnInfo } from '../_models/interfaces/dynts-sqlite-reade
  *   - `query` NEM-SELECT (INSERT/UPDATE/DELETE/DROP/multi-statement) → READONLY-hiba (elutasít),
  *   - hiányzó path / nem-létező fájl → strukturált hiba.
  */
-describe('DyNTS_Sqlite_Reader_Util (read-only SQLite reader, BFR-AM-009)', () => {
+describe('| DyNTS_Sqlite_Reader_Util (read-only SQLite reader, BFR-AM-009)', () => {
+
+  /** A temp DB-fájl útvonala (minden teszt-futáshoz egyedi). */
+  let dbPath: string;
 
-    /** A temp DB-fájl útvonala (minden teszt-futáshoz egyedi). */
-    let dbPath: string;
+  beforeAll(() => {
+    dbPath = path.join(os.tmpdir(), `dynts-sqlite-spec-${process.pid}-${Date.now()}.db`);
+    const db: Database.Database = new Database(dbPath);
 
-    beforeAll(() => {
-        dbPath = path.join(os.tmpdir(), `dynts-sqlite-spec-${process.pid}-${Date.now()}.db`);
-        const db: Database.Database = new Database(dbPath);
-        db.exec(`
+    db.exec(`
             CREATE TABLE users (id INTEGER PRIMARY KEY, name TEXT NOT NULL, age INTEGER);
             CREATE TABLE posts (id INTEGER PRIMARY KEY, title TEXT);
         `);
-        db.prepare('INSERT INTO users (id, name, age) VALUES (?, ?, ?)').run(1, 'Ada', 36);
-        db.prepare('INSERT INTO users (id, name, age) VALUES (?, ?, ?)').run(2, 'Grace', 40);
-        db.prepare('INSERT INTO posts (id, title) VALUES (?, ?)').run(1, 'Hello');
-        db.close();
-    });
-
-    afterAll(() => {
-        if (dbPath && fs.existsSync(dbPath)) {
-            fs.unlinkSync(dbPath);
-        }
-    });
-
-    /** Egy hívás, ami egy adott errorCode-dal kell hogy dobjon (strukturált, NEM néma). */
-    const expectErrorCode = (fn: () => unknown, expectedCode: string): void => {
-        let thrown: unknown;
-        try {
-            fn();
-        } catch (error) {
-            thrown = error;
-        }
-        expect(thrown).withContext(`dobnia kellett (${expectedCode})`).toBeDefined();
-        const code: string | undefined =
+    db.prepare('INSERT INTO users (id, name, age) VALUES (?, ?, ?)').run(1, 'Ada', 36);
+    db.prepare('INSERT INTO users (id, name, age) VALUES (?, ?, ?)').run(2, 'Grace', 40);
+    db.prepare('INSERT INTO posts (id, title) VALUES (?, ?)').run(1, 'Hello');
+    db.close();
+  });
+
+  afterAll(() => {
+    if (dbPath && fs.existsSync(dbPath)) {
+      fs.unlinkSync(dbPath);
+    }
+  });
+
+  /** Egy hívás, ami egy adott errorCode-dal kell hogy dobjon (strukturált, NEM néma). */
+  const expectErrorCode = (fn: () => unknown, expectedCode: string): void => {
+    let thrown: unknown;
+
+    try {
+      fn();
+    } catch (error) {
+      thrown = error;
+    }
+    expect(thrown).withContext(`dobnia kellett (${expectedCode})`).toBeDefined();
+    const code: string | undefined =
             thrown instanceof DyFM_Error ? DyFM_Error.getErrorCode(thrown) : undefined;
-        expect(code).withContext('a hibakód').toBe(expectedCode);
-    };
-
-    describe('listTables', () => {
-        it('a user-táblák ABC-sorrendben (a belső sqlite_% táblák kiszűrve)', () => {
-            expect(DyNTS_Sqlite_Reader_Util.listTables(dbPath)).toEqual(['posts', 'users']);
-        });
-    });
-
-    describe('getSchema', () => {
-        it('a users tábla oszlop-info-ja (name/type/notNull/primaryKey)', () => {
-            const schema: DyNTS_SqliteColumnInfo[] = DyNTS_Sqlite_Reader_Util.getSchema(dbPath, 'users');
-            expect(schema.map((column) => column.name)).toEqual(['id', 'name', 'age']);
-            const idColumn: DyNTS_SqliteColumnInfo = schema.find((column) => column.name === 'id')!;
-            expect(idColumn.primaryKey).toBe(true);
-            const nameColumn: DyNTS_SqliteColumnInfo = schema.find((column) => column.name === 'name')!;
-            expect(nameColumn.notNull).toBe(true);
-            expect(nameColumn.type).toBe('TEXT');
-        });
-
-        it('nem-létező tábla → DyNTS-SQLITE-READ-002 (NEM néma)', () => {
-            expectErrorCode(() => DyNTS_Sqlite_Reader_Util.getSchema(dbPath, 'no_such_table'), 'DyNTS-SQLITE-READ-002');
-        });
-    });
-
-    describe('readTable', () => {
-        it('a users tábla minden sora', () => {
-            const rows: { id: number; name: string }[] =
+
+    expect(code).withContext('a hibakód').toBe(expectedCode);
+  };
+
+  describe('| listTables', () => {
+    it('| a user-táblák ABC-sorrendben (a belső sqlite_% táblák kiszűrve)', () => {
+      expect(DyNTS_Sqlite_Reader_Util.listTables(dbPath)).toEqual([ 'posts', 'users' ]);
+    });
+  });
+
+  describe('| getSchema', () => {
+    it('| a users tábla oszlop-info-ja (name/type/notNull/primaryKey)', () => {
+      const schema: DyNTS_SqliteColumnInfo[] = DyNTS_Sqlite_Reader_Util.getSchema(dbPath, 'users');
+
+      expect(schema.map((column) => column.name)).toEqual([ 'id', 'name', 'age' ]);
+      const idColumn: DyNTS_SqliteColumnInfo = schema.find((column) => column.name === 'id');
+
+      expect(idColumn.primaryKey).toBe(true);
+      const nameColumn: DyNTS_SqliteColumnInfo = schema.find((column) => column.name === 'name');
+
+      expect(nameColumn.notNull).toBe(true);
+      expect(nameColumn.type).toBe('TEXT');
+    });
+
+    it('| nem-létező tábla → DyNTS-SQLITE-READ-002 (NEM néma)', () => {
+      expectErrorCode(() => DyNTS_Sqlite_Reader_Util.getSchema(dbPath, 'no_such_table'), 'DyNTS-SQLITE-READ-002');
+    });
+  });
+
+  describe('| readTable', () => {
+    it('| a users tábla minden sora', () => {
+      const rows: { id: number; name: string }[] =
                 DyNTS_Sqlite_Reader_Util.readTable(dbPath, 'users') as { id: number; name: string }[];
-            expect(rows.length).toBe(2);
-            expect(rows.map((row) => row.name).sort()).toEqual(['Ada', 'Grace']);
-        });
-
-        it('nem-létező tábla → DyNTS-SQLITE-READ-002 (NEM néma-[])', () => {
-            expectErrorCode(() => DyNTS_Sqlite_Reader_Util.readTable(dbPath, 'ghost'), 'DyNTS-SQLITE-READ-002');
-        });
-    });
-
-    describe('query (SELECT-only)', () => {
-        it('egy SELECT lekérdezés sorai', () => {
-            const rows: { name: string }[] =
-                DyNTS_Sqlite_Reader_Util.query(dbPath, 'SELECT name FROM users ORDER BY age DESC') as { name: string }[];
-            expect(rows.map((row) => row.name)).toEqual(['Grace', 'Ada']);
-        });
-
-        it('paraméteres SELECT (prepared-statement param)', () => {
-            const rows: { name: string }[] =
-                DyNTS_Sqlite_Reader_Util.query(dbPath, 'SELECT * FROM users WHERE age > ?', [37]) as { name: string }[];
-            expect(rows.map((row) => row.name)).toEqual(['Grace']);
-        });
-
-        it('WITH (CTE) is engedett (read-only)', () => {
-            const rows: { n: number }[] = DyNTS_Sqlite_Reader_Util.query(dbPath,
-                'WITH adults AS (SELECT * FROM users WHERE age >= 36) SELECT COUNT(*) AS n FROM adults') as { n: number }[];
-            expect(rows[0].n).toBe(2);
-        });
-
-        it('INSERT → DyNTS-SQLITE-READONLY-001 (elutasít a forrás-rétegben)', () => {
-            expectErrorCode(
-                () => DyNTS_Sqlite_Reader_Util.query(dbPath, "INSERT INTO users (id, name) VALUES (9, 'x')"),
-                'DyNTS-SQLITE-READONLY-001');
-        });
-
-        it('UPDATE → DyNTS-SQLITE-READONLY-001', () => {
-            expectErrorCode(
-                () => DyNTS_Sqlite_Reader_Util.query(dbPath, "UPDATE users SET name='x' WHERE id=1"),
-                'DyNTS-SQLITE-READONLY-001');
-        });
-
-        it('DELETE → DyNTS-SQLITE-READONLY-001', () => {
-            expectErrorCode(
-                () => DyNTS_Sqlite_Reader_Util.query(dbPath, 'DELETE FROM users'),
-                'DyNTS-SQLITE-READONLY-001');
-        });
-
-        it('DROP → DyNTS-SQLITE-READONLY-001', () => {
-            expectErrorCode(
-                () => DyNTS_Sqlite_Reader_Util.query(dbPath, 'DROP TABLE users'),
-                'DyNTS-SQLITE-READONLY-001');
-        });
-
-        it('multi-statement (SELECT; DELETE) → DyNTS-SQLITE-READONLY-001 (nem rejthető írás SELECT mögé)', () => {
-            expectErrorCode(
-                () => DyNTS_Sqlite_Reader_Util.query(dbPath, 'SELECT 1; DELETE FROM users'),
-                'DyNTS-SQLITE-READONLY-001');
-        });
-
-        it('üres SQL → DyNTS-SQLITE-READONLY-001', () => {
-            expectErrorCode(() => DyNTS_Sqlite_Reader_Util.query(dbPath, '   '), 'DyNTS-SQLITE-READONLY-001');
-        });
-    });
-
-    describe('path-validáció (fail-soft, NEM crash)', () => {
-        it('üres path → DyNTS-SQLITE-READ-001', () => {
-            expectErrorCode(() => DyNTS_Sqlite_Reader_Util.listTables(''), 'DyNTS-SQLITE-READ-001');
-        });
-
-        it('nem-létező fájl → DyNTS-SQLITE-READ-001', () => {
-            expectErrorCode(
-                () => DyNTS_Sqlite_Reader_Util.listTables(path.join(os.tmpdir(), 'no-such-db-file-xyz.db')),
-                'DyNTS-SQLITE-READ-001');
-        });
+
+      expect(rows.length).toBe(2);
+      expect(rows.map((row) => row.name).sort()).toEqual([ 'Ada', 'Grace' ]);
+    });
+
+    it('| nem-létező tábla → DyNTS-SQLITE-READ-002 (NEM néma-[])', () => {
+      expectErrorCode(() => DyNTS_Sqlite_Reader_Util.readTable(dbPath, 'ghost'), 'DyNTS-SQLITE-READ-002');
+    });
+  });
+
+  describe('| query (SELECT-only)', () => {
+    it('| egy SELECT lekérdezés sorai', () => {
+      const rows: NameInterface[] =
+                DyNTS_Sqlite_Reader_Util.query(dbPath, 'SELECT name FROM users ORDER BY age DESC') as NameInterface[];
+
+      expect(rows.map((row) => row.name)).toEqual([ 'Grace', 'Ada' ]);
+    });
+
+    it('| paraméteres SELECT (prepared-statement param)', () => {
+      const rows: NameInterface[] =
+                DyNTS_Sqlite_Reader_Util.query(dbPath, 'SELECT * FROM users WHERE age > ?', [ 37 ]) as NameInterface[];
+
+      expect(rows.map((row) => row.name)).toEqual([ 'Grace' ]);
+    });
+
+    it('| WITH (CTE) is engedett (read-only)', () => {
+      const rows: { n: number }[] = DyNTS_Sqlite_Reader_Util.query(dbPath,
+        'WITH adults AS (SELECT * FROM users WHERE age >= 36) SELECT COUNT(*) AS n FROM adults') as { n: number }[];
+
+      expect(rows[0].n).toBe(2);
+    });
+
+    it('| INSERT → DyNTS-SQLITE-READONLY-001 (elutasít a forrás-rétegben)', () => {
+      expectErrorCode(
+        () => DyNTS_Sqlite_Reader_Util.query(dbPath, 'INSERT INTO users (id, name) VALUES (9, \'x\')'),
+        'DyNTS-SQLITE-READONLY-001');
+    });
+
+    it('| UPDATE → DyNTS-SQLITE-READONLY-001', () => {
+      expectErrorCode(
+        () => DyNTS_Sqlite_Reader_Util.query(dbPath, 'UPDATE users SET name=\'x\' WHERE id=1'),
+        'DyNTS-SQLITE-READONLY-001');
+    });
+
+    it('| DELETE → DyNTS-SQLITE-READONLY-001', () => {
+      expectErrorCode(
+        () => DyNTS_Sqlite_Reader_Util.query(dbPath, 'DELETE FROM users'),
+        'DyNTS-SQLITE-READONLY-001');
+    });
+
+    it('| DROP → DyNTS-SQLITE-READONLY-001', () => {
+      expectErrorCode(
+        () => DyNTS_Sqlite_Reader_Util.query(dbPath, 'DROP TABLE users'),
+        'DyNTS-SQLITE-READONLY-001');
+    });
+
+    it('| multi-statement (SELECT; DELETE) → DyNTS-SQLITE-READONLY-001 (nem rejthető írás SELECT mögé)', () => {
+      expectErrorCode(
+        () => DyNTS_Sqlite_Reader_Util.query(dbPath, 'SELECT 1; DELETE FROM users'),
+        'DyNTS-SQLITE-READONLY-001');
+    });
+
+    it('| üres SQL → DyNTS-SQLITE-READONLY-001', () => {
+      expectErrorCode(() => DyNTS_Sqlite_Reader_Util.query(dbPath, '   '), 'DyNTS-SQLITE-READONLY-001');
+    });
+  });
+
+  describe('| path-validáció (fail-soft, NEM crash)', () => {
+    it('| üres path → DyNTS-SQLITE-READ-001', () => {
+      expectErrorCode(() => DyNTS_Sqlite_Reader_Util.listTables(''), 'DyNTS-SQLITE-READ-001');
+    });
+
+    it('| nem-létező fájl → DyNTS-SQLITE-READ-001', () => {
+      expectErrorCode(
+        () => DyNTS_Sqlite_Reader_Util.listTables(path.join(os.tmpdir(), 'no-such-db-file-xyz.db')),
+        'DyNTS-SQLITE-READ-001');
     });
+  });
 });