@futdevpro/nts-dynamo 1.15.98 → 1.15.100

package/src/_modules/ai/_modules/open-ai/_services/oai-user-key.control-service.ts

@@ -1,157 +1,157 @@
-import { OpenAI } from 'openai';
-
-import { DyFM_AI_Provider, DyFM_AI_Config } from '@futdevpro/fsm-dynamo/ai';
-import { DyFM_AI_UserProviderConfig } from '@futdevpro/fsm-dynamo/ai';
-import { DyFM_OAI_UserProviderConfig } from '@futdevpro/fsm-dynamo/ai/open-ai';
-import { DyFM_Log } from '@futdevpro/fsm-dynamo';
-
-import { DyNTS_AI_UserKey_ServiceBase } from '../../../_services/ai-user-key.service-base';
-import { DyNTS_AI_TestGeneration_Result } from '../../../_models/ai-test-generation-result.interface';
-
-/**
- * OpenAI-specifikus user API key kezelo service
- *
- * A visszafejtett API kulcsbol OpenAI-specifikus konfigot allit ossze,
- * es teszteli a kapcsolatot az OpenAI API-val.
- */
-export class DyNTS_OAI_UserKey_ControlService extends DyNTS_AI_UserKey_ServiceBase {
-
-  static getInstance(): DyNTS_OAI_UserKey_ControlService {
-    return DyNTS_OAI_UserKey_ControlService.getSingletonInstance();
-  }
-
-  readonly aiProvider: DyFM_AI_Provider = DyFM_AI_Provider.OpenAI;
-
-  /**
-   * OpenAI config osszeallitasa a visszafejtett kulcsbol
-   */
-  resolveConfig(
-    userProviderConfig: DyFM_AI_UserProviderConfig,
-    decryptedApiKey: string
-  ): DyFM_AI_Config {
-    const oaiConfig: DyFM_OAI_UserProviderConfig =
-      userProviderConfig as DyFM_OAI_UserProviderConfig;
-
-    return {
-      apiKey: decryptedApiKey,
-      organization: oaiConfig.organization,
-      project: oaiConfig.project,
-    };
-  }
-
-  /**
-   * OpenAI kapcsolat tesztelese a models.list() hivassal
-   */
-  async testConnection(
-    userProviderConfig: DyFM_AI_UserProviderConfig,
-    decryptedApiKey: string
-  ): Promise<boolean> {
-    try {
-      const config: DyFM_AI_Config = this.resolveConfig(userProviderConfig, decryptedApiKey);
-      const openai: OpenAI = new OpenAI({
-        apiKey: config.apiKey,
-        organization: config.organization,
-        project: config.project,
-      });
-
-      await openai.models.list();
-
-      return true;
-    } catch (error) {
-      DyFM_Log.error(
-        'DyNTS_OAI_UserKey_ControlService',
-        'testConnection',
-        'OpenAI connection test failed',
-        { error: error }
-      );
-
-      return false;
-    }
-  }
-
-  /**
-   * Elerheto OpenAI modellek lekerdezese
-   * Szuri a chat/LLM modelleket (nem embedding, nem whisper stb.)
-   */
-  async listAvailableModels(
-    userProviderConfig: DyFM_AI_UserProviderConfig,
-    decryptedApiKey: string
-  ): Promise<string[]> {
-    const config: DyFM_AI_Config = this.resolveConfig(userProviderConfig, decryptedApiKey);
-    const openai: OpenAI = new OpenAI({
-      apiKey: config.apiKey,
-      organization: config.organization,
-      project: config.project,
-    });
-
-    const models = await openai.models.list();
-
-    return models.data
-      .map((m) => m.id)
-      .filter((id: string) => this.isLLMModel(id))
-      .sort();
-  }
-
-  /**
-   * Teszt generalas az OpenAI API-val
-   */
-  async testGeneration(set: {
-    userProviderConfig: DyFM_AI_UserProviderConfig;
-    decryptedApiKey: string;
-    model: string;
-  }): Promise<DyNTS_AI_TestGeneration_Result> {
-    const startTime: number = Date.now();
-
-    try {
-      const config: DyFM_AI_Config = this.resolveConfig(
-        set.userProviderConfig,
-        set.decryptedApiKey
-      );
-      const openai: OpenAI = new OpenAI({
-        apiKey: config.apiKey,
-        organization: config.organization,
-        project: config.project,
-      });
-
-      const response = await openai.chat.completions.create({
-        model: set.model,
-        messages: [{ role: 'user', content: 'Hello, this is a test. Reply with "OK".' }],
-        max_tokens: 10,
-      });
-
-      return {
-        success: true,
-        response: response.choices[0]?.message?.content,
-        model: set.model,
-        latencyMs: Date.now() - startTime,
-      };
-    } catch (error) {
-      DyFM_Log.error(
-        'DyNTS_OAI_UserKey_ControlService',
-        'testGeneration',
-        'OpenAI test generation failed',
-        { error: error }
-      );
-
-      return {
-        success: false,
-        model: set.model,
-        latencyMs: Date.now() - startTime,
-      };
-    }
-  }
-
-  /**
-   * LLM/Chat modell szures -- kiszuri az embedding, whisper, tts stb. modelleket
-   */
-  private isLLMModel(modelId: string): boolean {
-    const excludePatterns: string[] = [
-      'embedding', 'whisper', 'tts', 'dall-e',
-      'moderation', 'davinci', 'babbage', 'ada',
-    ];
-
-    return !excludePatterns.some(
-      (pattern: string) => modelId.includes(pattern)
-    );
-  }
-}
+import { OpenAI } from 'openai';
+
+import { DyFM_AI_Provider, DyFM_AI_Config } from '@futdevpro/fsm-dynamo/ai';
+import { DyFM_AI_UserProviderConfig } from '@futdevpro/fsm-dynamo/ai';
+import { DyFM_OAI_UserProviderConfig } from '@futdevpro/fsm-dynamo/ai/open-ai';
+import { DyFM_Log } from '@futdevpro/fsm-dynamo';
+
+import { DyNTS_AI_UserKey_ServiceBase } from '../../../_services/ai-user-key.service-base';
+import { DyNTS_AI_TestGeneration_Result } from '../../../_models/ai-test-generation-result.interface';
+
+/**
+ * OpenAI-specifikus user API key kezelo service
+ *
+ * A visszafejtett API kulcsbol OpenAI-specifikus konfigot allit ossze,
+ * es teszteli a kapcsolatot az OpenAI API-val.
+ */
+export class DyNTS_OAI_UserKey_ControlService extends DyNTS_AI_UserKey_ServiceBase {
+
+  static getInstance(): DyNTS_OAI_UserKey_ControlService {
+    return DyNTS_OAI_UserKey_ControlService.getSingletonInstance();
+  }
+
+  readonly aiProvider: DyFM_AI_Provider = DyFM_AI_Provider.OpenAI;
+
+  /**
+   * OpenAI config osszeallitasa a visszafejtett kulcsbol
+   */
+  resolveConfig(
+    userProviderConfig: DyFM_AI_UserProviderConfig,
+    decryptedApiKey: string
+  ): DyFM_AI_Config {
+    const oaiConfig: DyFM_OAI_UserProviderConfig =
+      userProviderConfig as DyFM_OAI_UserProviderConfig;
+
+    return {
+      apiKey: decryptedApiKey,
+      organization: oaiConfig.organization,
+      project: oaiConfig.project,
+    };
+  }
+
+  /**
+   * OpenAI kapcsolat tesztelese a models.list() hivassal
+   */
+  async testConnection(
+    userProviderConfig: DyFM_AI_UserProviderConfig,
+    decryptedApiKey: string
+  ): Promise<boolean> {
+    try {
+      const config: DyFM_AI_Config = this.resolveConfig(userProviderConfig, decryptedApiKey);
+      const openai: OpenAI = new OpenAI({
+        apiKey: config.apiKey,
+        organization: config.organization,
+        project: config.project,
+      });
+
+      await openai.models.list();
+
+      return true;
+    } catch (error) {
+      DyFM_Log.error(
+        'DyNTS_OAI_UserKey_ControlService',
+        'testConnection',
+        'OpenAI connection test failed',
+        { error: error }
+      );
+
+      return false;
+    }
+  }
+
+  /**
+   * Elerheto OpenAI modellek lekerdezese
+   * Szuri a chat/LLM modelleket (nem embedding, nem whisper stb.)
+   */
+  async listAvailableModels(
+    userProviderConfig: DyFM_AI_UserProviderConfig,
+    decryptedApiKey: string
+  ): Promise<string[]> {
+    const config: DyFM_AI_Config = this.resolveConfig(userProviderConfig, decryptedApiKey);
+    const openai: OpenAI = new OpenAI({
+      apiKey: config.apiKey,
+      organization: config.organization,
+      project: config.project,
+    });
+
+    const models = await openai.models.list();
+
+    return models.data
+      .map((m) => m.id)
+      .filter((id: string) => this.isLLMModel(id))
+      .sort();
+  }
+
+  /**
+   * Teszt generalas az OpenAI API-val
+   */
+  async testGeneration(set: {
+    userProviderConfig: DyFM_AI_UserProviderConfig;
+    decryptedApiKey: string;
+    model: string;
+  }): Promise<DyNTS_AI_TestGeneration_Result> {
+    const startTime: number = Date.now();
+
+    try {
+      const config: DyFM_AI_Config = this.resolveConfig(
+        set.userProviderConfig,
+        set.decryptedApiKey
+      );
+      const openai: OpenAI = new OpenAI({
+        apiKey: config.apiKey,
+        organization: config.organization,
+        project: config.project,
+      });
+
+      const response = await openai.chat.completions.create({
+        model: set.model,
+        messages: [{ role: 'user', content: 'Hello, this is a test. Reply with "OK".' }],
+        max_tokens: 10,
+      });
+
+      return {
+        success: true,
+        response: response.choices[0]?.message?.content,
+        model: set.model,
+        latencyMs: Date.now() - startTime,
+      };
+    } catch (error) {
+      DyFM_Log.error(
+        'DyNTS_OAI_UserKey_ControlService',
+        'testGeneration',
+        'OpenAI test generation failed',
+        { error: error }
+      );
+
+      return {
+        success: false,
+        model: set.model,
+        latencyMs: Date.now() - startTime,
+      };
+    }
+  }
+
+  /**
+   * LLM/Chat modell szures -- kiszuri az embedding, whisper, tts stb. modelleket
+   */
+  private isLLMModel(modelId: string): boolean {
+    const excludePatterns: string[] = [
+      'embedding', 'whisper', 'tts', 'dall-e',
+      'moderation', 'davinci', 'babbage', 'ada',
+    ];
+
+    return !excludePatterns.some(
+      (pattern: string) => modelId.includes(pattern)
+    );
+  }
+}

package/src/_modules/ai/_services/ai-embedding-mock.service.spec.ts

@@ -1,115 +1,115 @@
-import { CreateEmbeddingResponse } from 'openai/resources';
-import { DyFM_AI_Provider } from '@futdevpro/fsm-dynamo/ai';
-
-import {
-  DyNTS_AI_Embedding_MockService,
-  DyNTS_AI_MOCK_EMBEDDING_DIMS,
-} from './ai-embedding-mock.service';
-import { DyNTS_AI_CostEvent } from '../_models/interfaces/dynts-ai-cost-event.interface';
-
-describe('| DyNTS_AI_Embedding_MockService', () => {
-
-  const issuer: string = 'test-issuer';
-
-  describe('| determinism', () => {
-    it('| should return the same vector for the same (model, text)', async () => {
-      const service: DyNTS_AI_Embedding_MockService = new DyNTS_AI_Embedding_MockService();
-      const first: number[][] = (await service.createEmbeddings({ texts: ['hello'], model: 'm', issuer: issuer })) as number[][];
-      const second: number[][] = (await service.createEmbeddings({ texts: ['hello'], model: 'm', issuer: issuer })) as number[][];
-      expect(first[0]).toEqual(second[0]);
-    });
-
-    it('| should return different vectors for different texts', async () => {
-      const service: DyNTS_AI_Embedding_MockService = new DyNTS_AI_Embedding_MockService();
-      const result: number[][] = (await service.createEmbeddings({ texts: ['hello', 'world'], model: 'm', issuer: issuer })) as number[][];
-      expect(result[0]).not.toEqual(result[1]);
-    });
-
-    it('| should return different vectors for different models (re-embed scenario)', async () => {
-      const service: DyNTS_AI_Embedding_MockService = new DyNTS_AI_Embedding_MockService();
-      const a: number[][] = (await service.createEmbeddings({ texts: ['hello'], model: 'model-a', issuer: issuer })) as number[][];
-      const b: number[][] = (await service.createEmbeddings({ texts: ['hello'], model: 'model-b', issuer: issuer })) as number[][];
-      expect(a[0]).not.toEqual(b[0]);
-    });
-  });
-
-  describe('| dimensions', () => {
-    it('| should default to DyNTS_AI_MOCK_EMBEDDING_DIMS', async () => {
-      const service: DyNTS_AI_Embedding_MockService = new DyNTS_AI_Embedding_MockService();
-      const result: number[][] = (await service.createEmbeddings({ texts: ['x'], model: 'm', issuer: issuer })) as number[][];
-      expect(result[0].length).toBe(DyNTS_AI_MOCK_EMBEDDING_DIMS);
-    });
-
-    it('| should honour a configured dims', async () => {
-      const service: DyNTS_AI_Embedding_MockService = new DyNTS_AI_Embedding_MockService({ dims: 16 });
-      const result: number[][] = (await service.createEmbeddings({ texts: ['x'], model: 'm', issuer: issuer })) as number[][];
-      expect(result[0].length).toBe(16);
-    });
-
-    it('| should produce an l2-normalized vector (unit length)', async () => {
-      const service: DyNTS_AI_Embedding_MockService = new DyNTS_AI_Embedding_MockService({ dims: 32 });
-      const result: number[][] = (await service.createEmbeddings({ texts: ['vector'], model: 'm', issuer: issuer })) as number[][];
-      const norm: number = Math.sqrt(result[0].reduce((sum: number, v: number) => sum + v * v, 0));
-      expect(norm).toBeCloseTo(1, 6);
-    });
-  });
-
-  describe('| createEmbedding (single)', () => {
-    it('| should match the batch vector for the same text', async () => {
-      const service: DyNTS_AI_Embedding_MockService = new DyNTS_AI_Embedding_MockService();
-      const single: number[] = (await service.createEmbedding({ text: 'hi', model: 'm', issuer: issuer })) as number[];
-      const batch: number[][] = (await service.createEmbeddings({ texts: ['hi'], model: 'm', issuer: issuer })) as number[][];
-      expect(single).toEqual(batch[0]);
-    });
-
-    it('| should return a full OpenAI-shaped response when fullResponse is true', async () => {
-      const service: DyNTS_AI_Embedding_MockService = new DyNTS_AI_Embedding_MockService({ dims: 8 });
-      const response: CreateEmbeddingResponse = (await service.createEmbedding({
-        text: 'hi',
-        model: 'm',
-        fullResponse: true,
-        issuer: issuer,
-      })) as CreateEmbeddingResponse;
-      expect(response.object).toBe('list');
-      expect(response.data[0].embedding.length).toBe(8);
-      expect(response.usage.total_tokens).toBeGreaterThan(0);
-    });
-  });
-
-  describe('| cost-event', () => {
-    it('| should emit an embedding-batch cost-event with provider mock', async () => {
-      const events: DyNTS_AI_CostEvent[] = [];
-      const service: DyNTS_AI_Embedding_MockService = new DyNTS_AI_Embedding_MockService({
-        onCostEvent: (event: DyNTS_AI_CostEvent) => events.push(event),
-      });
-      await service.createEmbeddings({ texts: ['abcd', 'efgh'], model: 'm', issuer: issuer });
-      expect(events.length).toBe(1);
-      expect(events[0].callType).toBe('embedding-batch');
-      expect(events[0].provider).toBe('mock');
-      expect(events[0].estimatedCostUsd).toBe(0);
-      expect(events[0].tokensUsed.input).toBeGreaterThan(0);
-    });
-
-    it('| should emit an embedding-single cost-event', async () => {
-      const events: DyNTS_AI_CostEvent[] = [];
-      const service: DyNTS_AI_Embedding_MockService = new DyNTS_AI_Embedding_MockService({
-        onCostEvent: (event: DyNTS_AI_CostEvent) => events.push(event),
-      });
-      await service.createEmbedding({ text: 'hi', model: 'm', issuer: issuer });
-      expect(events[0].callType).toBe('embedding-single');
-    });
-  });
-
-  describe('| provider info + availability', () => {
-    it('| should report the LocalAI provider', () => {
-      const service: DyNTS_AI_Embedding_MockService = new DyNTS_AI_Embedding_MockService();
-      expect(service.aiProvider).toBe(DyFM_AI_Provider.LocalAI);
-      expect(service.getEmbeddingInfo('m')).toEqual({ provider: DyFM_AI_Provider.LocalAI, model: 'm' });
-    });
-
-    it('| should always be available', async () => {
-      const service: DyNTS_AI_Embedding_MockService = new DyNTS_AI_Embedding_MockService();
-      expect(await service.testConnection(issuer)).toBe(true);
-    });
-  });
-});
+import { CreateEmbeddingResponse } from 'openai/resources';
+import { DyFM_AI_Provider } from '@futdevpro/fsm-dynamo/ai';
+
+import {
+  DyNTS_AI_Embedding_MockService,
+  DyNTS_AI_MOCK_EMBEDDING_DIMS,
+} from './ai-embedding-mock.service';
+import { DyNTS_AI_CostEvent } from '../_models/interfaces/dynts-ai-cost-event.interface';
+
+describe('| DyNTS_AI_Embedding_MockService', () => {
+
+  const issuer: string = 'test-issuer';
+
+  describe('| determinism', () => {
+    it('| should return the same vector for the same (model, text)', async () => {
+      const service: DyNTS_AI_Embedding_MockService = new DyNTS_AI_Embedding_MockService();
+      const first: number[][] = (await service.createEmbeddings({ texts: ['hello'], model: 'm', issuer: issuer })) as number[][];
+      const second: number[][] = (await service.createEmbeddings({ texts: ['hello'], model: 'm', issuer: issuer })) as number[][];
+      expect(first[0]).toEqual(second[0]);
+    });
+
+    it('| should return different vectors for different texts', async () => {
+      const service: DyNTS_AI_Embedding_MockService = new DyNTS_AI_Embedding_MockService();
+      const result: number[][] = (await service.createEmbeddings({ texts: ['hello', 'world'], model: 'm', issuer: issuer })) as number[][];
+      expect(result[0]).not.toEqual(result[1]);
+    });
+
+    it('| should return different vectors for different models (re-embed scenario)', async () => {
+      const service: DyNTS_AI_Embedding_MockService = new DyNTS_AI_Embedding_MockService();
+      const a: number[][] = (await service.createEmbeddings({ texts: ['hello'], model: 'model-a', issuer: issuer })) as number[][];
+      const b: number[][] = (await service.createEmbeddings({ texts: ['hello'], model: 'model-b', issuer: issuer })) as number[][];
+      expect(a[0]).not.toEqual(b[0]);
+    });
+  });
+
+  describe('| dimensions', () => {
+    it('| should default to DyNTS_AI_MOCK_EMBEDDING_DIMS', async () => {
+      const service: DyNTS_AI_Embedding_MockService = new DyNTS_AI_Embedding_MockService();
+      const result: number[][] = (await service.createEmbeddings({ texts: ['x'], model: 'm', issuer: issuer })) as number[][];
+      expect(result[0].length).toBe(DyNTS_AI_MOCK_EMBEDDING_DIMS);
+    });
+
+    it('| should honour a configured dims', async () => {
+      const service: DyNTS_AI_Embedding_MockService = new DyNTS_AI_Embedding_MockService({ dims: 16 });
+      const result: number[][] = (await service.createEmbeddings({ texts: ['x'], model: 'm', issuer: issuer })) as number[][];
+      expect(result[0].length).toBe(16);
+    });
+
+    it('| should produce an l2-normalized vector (unit length)', async () => {
+      const service: DyNTS_AI_Embedding_MockService = new DyNTS_AI_Embedding_MockService({ dims: 32 });
+      const result: number[][] = (await service.createEmbeddings({ texts: ['vector'], model: 'm', issuer: issuer })) as number[][];
+      const norm: number = Math.sqrt(result[0].reduce((sum: number, v: number) => sum + v * v, 0));
+      expect(norm).toBeCloseTo(1, 6);
+    });
+  });
+
+  describe('| createEmbedding (single)', () => {
+    it('| should match the batch vector for the same text', async () => {
+      const service: DyNTS_AI_Embedding_MockService = new DyNTS_AI_Embedding_MockService();
+      const single: number[] = (await service.createEmbedding({ text: 'hi', model: 'm', issuer: issuer })) as number[];
+      const batch: number[][] = (await service.createEmbeddings({ texts: ['hi'], model: 'm', issuer: issuer })) as number[][];
+      expect(single).toEqual(batch[0]);
+    });
+
+    it('| should return a full OpenAI-shaped response when fullResponse is true', async () => {
+      const service: DyNTS_AI_Embedding_MockService = new DyNTS_AI_Embedding_MockService({ dims: 8 });
+      const response: CreateEmbeddingResponse = (await service.createEmbedding({
+        text: 'hi',
+        model: 'm',
+        fullResponse: true,
+        issuer: issuer,
+      })) as CreateEmbeddingResponse;
+      expect(response.object).toBe('list');
+      expect(response.data[0].embedding.length).toBe(8);
+      expect(response.usage.total_tokens).toBeGreaterThan(0);
+    });
+  });
+
+  describe('| cost-event', () => {
+    it('| should emit an embedding-batch cost-event with provider mock', async () => {
+      const events: DyNTS_AI_CostEvent[] = [];
+      const service: DyNTS_AI_Embedding_MockService = new DyNTS_AI_Embedding_MockService({
+        onCostEvent: (event: DyNTS_AI_CostEvent) => events.push(event),
+      });
+      await service.createEmbeddings({ texts: ['abcd', 'efgh'], model: 'm', issuer: issuer });
+      expect(events.length).toBe(1);
+      expect(events[0].callType).toBe('embedding-batch');
+      expect(events[0].provider).toBe('mock');
+      expect(events[0].estimatedCostUsd).toBe(0);
+      expect(events[0].tokensUsed.input).toBeGreaterThan(0);
+    });
+
+    it('| should emit an embedding-single cost-event', async () => {
+      const events: DyNTS_AI_CostEvent[] = [];
+      const service: DyNTS_AI_Embedding_MockService = new DyNTS_AI_Embedding_MockService({
+        onCostEvent: (event: DyNTS_AI_CostEvent) => events.push(event),
+      });
+      await service.createEmbedding({ text: 'hi', model: 'm', issuer: issuer });
+      expect(events[0].callType).toBe('embedding-single');
+    });
+  });
+
+  describe('| provider info + availability', () => {
+    it('| should report the LocalAI provider', () => {
+      const service: DyNTS_AI_Embedding_MockService = new DyNTS_AI_Embedding_MockService();
+      expect(service.aiProvider).toBe(DyFM_AI_Provider.LocalAI);
+      expect(service.getEmbeddingInfo('m')).toEqual({ provider: DyFM_AI_Provider.LocalAI, model: 'm' });
+    });
+
+    it('| should always be available', async () => {
+      const service: DyNTS_AI_Embedding_MockService = new DyNTS_AI_Embedding_MockService();
+      expect(await service.testConnection(issuer)).toBe(true);
+    });
+  });
+});