@futdevpro/nts-dynamo 1.15.157 → 1.15.163

package/src/_modules/ai/_modules/open-ai/_services/oai-embedding.control-service.spec.ts

@@ -1,332 +0,0 @@
-
-import { DyNTS_AI_CostEvent } from '../../../_models/interfaces/dynts-ai-cost-event.interface';
-import { DyNTS_OAI_Embedding_ControlService } from './oai-embedding.control-service';
-import { DyFM_OAI_Settings, DyFM_OAI_Model } from '@futdevpro/fsm-dynamo/ai/open-ai';
-import { DyFM_Error } from '@futdevpro/fsm-dynamo';
-import { CreateEmbeddingResponse } from 'openai/resources';
-
-describe('| DyNTS_OAI_Embedding_ControlService', () => {
-  let service: DyNTS_OAI_Embedding_ControlService;
-  let mockOpenAI: any;
-  let mockEmbeddingsCreate: jasmine.Spy;
-
-  const mockSettings: DyFM_OAI_Settings = {
-    config: {
-      apiKey: 'test-api-key',
-      organization: 'test-org',
-    },
-    defaultSettings: {
-      useModel: DyFM_OAI_Model.textEmbedding_3Small,
-    },
-  };
-
-  beforeEach(() => {
-    mockEmbeddingsCreate = jasmine.createSpy('embeddings.create').and.returnValue({
-      data: [
-        {
-          embedding: [0.1, 0.2, 0.3],
-          index: 0,
-          object: 'embedding',
-        },
-      ],
-      model: 'text-embedding-3-small',
-      object: 'list',
-      usage: {
-        prompt_tokens: 5,
-        total_tokens: 5,
-      },
-    });
-
-    mockOpenAI = {
-      embeddings: {
-        create: mockEmbeddingsCreate,
-      },
-    };
-
-    service = new DyNTS_OAI_Embedding_ControlService(mockSettings);
-    (service as any).openai = mockOpenAI;
-  });
-
-  describe('| createEmbedding', () => {
-    it('| should create embedding for single text', async () => {
-      const result = await service.createEmbedding({
-        text: 'Test text',
-        model: DyFM_OAI_Model.textEmbedding_3Small,
-        issuer: 'test-issuer',
-      });
-
-      expect(result).toEqual([0.1, 0.2, 0.3]);
-      expect(mockEmbeddingsCreate).toHaveBeenCalledWith({
-        model: DyFM_OAI_Model.textEmbedding_3Small,
-        input: 'Test text',
-      });
-    });
-
-    it('| should return full response when fullResponse is true', async () => {
-      const mockResponse: CreateEmbeddingResponse = {
-        data: [
-          {
-            embedding: [0.1, 0.2, 0.3],
-            index: 0,
-            object: 'embedding',
-          },
-        ],
-        model: 'text-embedding-3-small',
-        object: 'list',
-        usage: {
-          prompt_tokens: 5,
-          total_tokens: 5,
-        },
-      };
-
-      mockEmbeddingsCreate.and.returnValue(mockResponse);
-
-      const result = await service.createEmbedding({
-        text: 'Test text',
-        model: DyFM_OAI_Model.textEmbedding_3Small,
-        fullResponse: true,
-        issuer: 'test-issuer',
-      });
-
-      expect(result).toEqual(mockResponse);
-    });
-
-    it('| should throw error when text is missing', async () => {
-      try {
-        await service.createEmbedding({
-          text: '',
-          model: DyFM_OAI_Model.textEmbedding_3Small,
-          issuer: 'test-issuer',
-        });
-        fail('Should have thrown an error');
-      } catch (error) {
-        expect(error).toBeInstanceOf(DyFM_Error);
-        expect((error as DyFM_Error)._errorCode).toContain('DyNTS-ECS-CE1');
-      }
-    });
-
-    it('| should handle API errors', async () => {
-      const apiError = new Error('API Error');
-      mockEmbeddingsCreate.and.throwError(apiError);
-
-      try {
-        await service.createEmbedding({
-          text: 'Test text',
-          model: DyFM_OAI_Model.textEmbedding_3Small,
-          issuer: 'test-issuer',
-        });
-        fail('Should have thrown an error');
-      } catch (error) {
-        expect(error).toBeInstanceOf(DyFM_Error);
-        expect((error as DyFM_Error)._errorCode).toContain('DyNTS-ECS-CE0');
-      }
-    });
-  });
-
-  describe('| createEmbeddings', () => {
-    beforeEach(() => {
-      mockEmbeddingsCreate.and.returnValue({
-        data: [
-          {
-            embedding: [0.1, 0.2, 0.3],
-            index: 0,
-            object: 'embedding',
-          },
-          {
-            embedding: [0.4, 0.5, 0.6],
-            index: 1,
-            object: 'embedding',
-          },
-        ],
-        model: 'text-embedding-3-small',
-        object: 'list',
-        usage: {
-          prompt_tokens: 10,
-          total_tokens: 10,
-        },
-      });
-    });
-
-    it('| should create embeddings for multiple texts', async () => {
-      const result = await service.createEmbeddings({
-        texts: ['Text 1', 'Text 2'],
-        model: DyFM_OAI_Model.textEmbedding_3Small,
-        issuer: 'test-issuer',
-      });
-
-      expect(result).toEqual([[0.1, 0.2, 0.3], [0.4, 0.5, 0.6]]);
-      expect(mockEmbeddingsCreate).toHaveBeenCalledWith({
-        model: DyFM_OAI_Model.textEmbedding_3Small,
-        input: ['Text 1', 'Text 2'],
-      });
-    });
-
-    it('| should return full response when fullResponse is true', async () => {
-      const mockResponse: CreateEmbeddingResponse = {
-        data: [
-          {
-            embedding: [0.1, 0.2, 0.3],
-            index: 0,
-            object: 'embedding',
-          },
-        ],
-        model: 'text-embedding-3-small',
-        object: 'list',
-        usage: {
-          prompt_tokens: 5,
-          total_tokens: 5,
-        },
-      };
-
-      mockEmbeddingsCreate.and.returnValue(mockResponse);
-
-      const result = await service.createEmbeddings({
-        texts: ['Text 1'],
-        model: DyFM_OAI_Model.textEmbedding_3Small,
-        fullResponse: true,
-        issuer: 'test-issuer',
-      });
-
-      expect(result).toEqual(mockResponse);
-    });
-
-    it('| should throw error when texts is missing', async () => {
-      try {
-        await service.createEmbeddings({
-          texts: null as any,
-          model: DyFM_OAI_Model.textEmbedding_3Small,
-          issuer: 'test-issuer',
-        });
-        fail('Should have thrown an error');
-      } catch (error) {
-        expect(error).toBeInstanceOf(DyFM_Error);
-        expect((error as DyFM_Error)._errorCode).toContain('DyNTS-ECS-CES1');
-      }
-    });
-
-    it('| should handle API errors', async () => {
-      const apiError = new Error('API Error');
-      mockEmbeddingsCreate.and.throwError(apiError);
-
-      try {
-        await service.createEmbeddings({
-          texts: ['Text 1'],
-          model: DyFM_OAI_Model.textEmbedding_3Small,
-          issuer: 'test-issuer',
-        });
-        fail('Should have thrown an error');
-      } catch (error) {
-        expect(error).toBeInstanceOf(DyFM_Error);
-        expect((error as DyFM_Error)._errorCode).toContain('DyNTS-ECS-CES0');
-      }
-    });
-  });
-
-  describe('| getEmbeddingInfo', () => {
-    it('| should return embedding info for model', () => {
-      const result = service.getEmbeddingInfo('text-embedding-3-small');
-
-      expect(result.provider).toBeDefined();
-      expect(result.model).toBe('text-embedding-3-small');
-    });
-
-    it('| should return embedding info for different models', () => {
-      const result = service.getEmbeddingInfo('text-embedding-3-large');
-
-      expect(result.provider).toBeDefined();
-      expect(result.model).toBe('text-embedding-3-large');
-    });
-  });
-
-  describe('| FR-002 cost-event emit', () => {
-
-    /** Helper: lecseréli a service onCostEvent callback-jét spy-jal. */
-    function withCostEventCapture(): DyNTS_AI_CostEvent[] {
-      const received: DyNTS_AI_CostEvent[] = [];
-      (service as any).onCostEvent = (e: DyNTS_AI_CostEvent) => { received.push(e); };
-      return received;
-    }
-
-    it('| createEmbedding emits 1 cost-event with embedding-single callType', async () => {
-      const received: DyNTS_AI_CostEvent[] = withCostEventCapture();
-
-      await service.createEmbedding({
-        text: 'hello',
-        model: DyFM_OAI_Model.textEmbedding_3Small,
-        issuer: 'test-issuer',
-      });
-
-      expect(received.length).toBe(1);
-      expect(received[0].callType).toBe('embedding-single');
-      expect(received[0].provider).toBe('open-ai');
-      expect(received[0].model).toBe(DyFM_OAI_Model.textEmbedding_3Small);
-      expect(received[0].tokensUsed.input).toBe(5);
-      expect(received[0].tokensUsed.total).toBe(5);
-      expect(received[0].tokensUsed.output).toBeUndefined();
-      expect(received[0].issuer).toBe('test-issuer');
-      expect(received[0].timestamp).toBeInstanceOf(Date);
-      expect(received[0].durationMs).toBeGreaterThanOrEqual(0);
-      expect(received[0].estimatedCostUsd).toBeUndefined();
-    });
-
-    it('| createEmbeddings emits 1 cost-event with embedding-batch callType', async () => {
-      const received: DyNTS_AI_CostEvent[] = withCostEventCapture();
-
-      // Override-oljuk a top-level beforeEach mockját (prompt_tokens:5) hogy a batch
-      // szándékát tükrözze (2 input → magasabb token-count). A korábbi 10/10 expect
-      // assert-eket a default mock 5-tel cáfolta (BL-20260518-001).
-      mockEmbeddingsCreate.and.returnValue({
-        data: [
-          { embedding: [0.1, 0.2, 0.3], index: 0, object: 'embedding' },
-          { embedding: [0.4, 0.5, 0.6], index: 1, object: 'embedding' },
-        ],
-        model: 'text-embedding-3-small',
-        object: 'list',
-        usage: { prompt_tokens: 10, total_tokens: 10 },
-      });
-
-      await service.createEmbeddings({
-        texts: ['a', 'b'],
-        model: DyFM_OAI_Model.textEmbedding_3Small,
-        issuer: 'batch-issuer',
-      });
-
-      expect(received.length).toBe(1);
-      expect(received[0].callType).toBe('embedding-batch');
-      expect(received[0].issuer).toBe('batch-issuer');
-      expect(received[0].tokensUsed.input).toBe(10);
-      expect(received[0].tokensUsed.total).toBe(10);
-    });
-
-    it('| does NOT emit when the API call throws (emit only after success)', async () => {
-      const received: DyNTS_AI_CostEvent[] = withCostEventCapture();
-      mockEmbeddingsCreate.and.throwError(new Error('upstream API failed'));
-
-      try {
-        await service.createEmbedding({
-          text: 'hello',
-          model: DyFM_OAI_Model.textEmbedding_3Small,
-          issuer: 'test-issuer',
-        });
-        fail('Should have thrown');
-      } catch {
-        // expected
-      }
-
-      expect(received.length).toBe(0);
-    });
-
-    it('| stays non-breaking: with no onCostEvent the call still succeeds', async () => {
-      (service as any).onCostEvent = undefined;
-
-      const result = await service.createEmbedding({
-        text: 'hello',
-        model: DyFM_OAI_Model.textEmbedding_3Small,
-        issuer: 'test-issuer',
-      });
-
-      expect(result).toEqual([0.1, 0.2, 0.3]);
-    });
-  });
-});
-

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

@@ -1,132 +0,0 @@
-import { DyFM_OAI_Model, DyFM_OAI_EmbeddingModelDimensions } from '@futdevpro/fsm-dynamo/ai/open-ai';
-import { DyFM_Error } from '@futdevpro/fsm-dynamo';
-import { DyFM_AI_Provider } from '@futdevpro/fsm-dynamo/ai';
-import { DyFM_DAI_EmbeddingInfo } from '@futdevpro/fsm-dynamo/ai/document-ai';
-
-import { DyNTS_OAI_LLM_ServiceBase } from './oai-llm.service-base';
-import { DyNTS_global_settings } from '../../../../../_collections/global-settings.const';
-import { DyNTS_AI_Embedding_ServiceBase } from '../../../_services/ai-embedding.service-base';
-import { CreateEmbeddingResponse } from 'openai/resources';
-
-export class DyNTS_OAI_Embedding_ControlService extends DyNTS_OAI_LLM_ServiceBase implements DyNTS_AI_Embedding_ServiceBase {
-
-  async createEmbedding(
-    set: {
-      text: string;
-      model: DyFM_OAI_Model | string;
-      fullResponse?: boolean;
-      issuer: string;
-    }
-  ): Promise<number[] | CreateEmbeddingResponse> {
-    try {
-      if (!set.text) {
-        throw new DyFM_Error({
-          ...this.getDefaultErrorSettings('createEmbedding', new Error('text is required'), set.issuer),
-
-          errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-ECS-CE1`,
-        });
-      }
-
-      // FR-002 — per-call cost-event timing: a tényleges API-call latency mérve
-      const start: number = Date.now();
-      const response: CreateEmbeddingResponse = await this.openai.embeddings.create({
-        model: set.model,
-        input: set.text,
-      });
-      const durationMs: number = Date.now() - start;
-
-      // FR-002 — cost-event emit (safe, no-op ha nincs onCostEvent callback)
-      this.emitCostEvent({
-        callType: 'embedding-single',
-        provider: this.aiProvider,
-        model: String(set.model),
-        tokensUsed: {
-          input: response.usage?.prompt_tokens ?? 0,
-          total: response.usage?.total_tokens ?? 0,
-        },
-        durationMs: durationMs,
-        issuer: set.issuer,
-        timestamp: new Date(),
-      });
-
-      if (set.fullResponse) {
-        return response;
-      }
-
-      return response.data[0].embedding;
-    } catch (error) {
-      throw new DyFM_Error({
-        ...this.getDefaultErrorSettings('createEmbedding', error, set.issuer),
-
-        errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-ECS-CE0`,
-      });
-    }
-  }
-
-  async createEmbeddings(
-    set: {
-      texts: string[];
-      model: DyFM_OAI_Model | string;
-      fullResponse?: boolean;
-      issuer: string;
-    }
-  ): Promise<number[][] | CreateEmbeddingResponse> {
-    try {
-      if (!set.texts) {
-        throw new DyFM_Error({
-          ...this.getDefaultErrorSettings('createEmbeddings', new Error('texts is required'), set.issuer),
-
-          errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-ECS-CES1`,
-        });
-      }
-
-      // FR-002 — per-call cost-event timing
-      const start: number = Date.now();
-      const response: CreateEmbeddingResponse = await this.openai.embeddings.create({
-        model: set.model,
-        input: set.texts,
-      });
-      const durationMs: number = Date.now() - start;
-
-      // FR-002 — cost-event emit (batch-call → 'embedding-batch')
-      this.emitCostEvent({
-        callType: 'embedding-batch',
-        provider: this.aiProvider,
-        model: String(set.model),
-        tokensUsed: {
-          input: response.usage?.prompt_tokens ?? 0,
-          total: response.usage?.total_tokens ?? 0,
-        },
-        durationMs: durationMs,
-        issuer: set.issuer,
-        timestamp: new Date(),
-      });
-
-      if (set.fullResponse) {
-        return response;
-      }
-
-      return response.data.map(item => item.embedding);
-    } catch (error) {
-      throw new DyFM_Error({
-        ...this.getDefaultErrorSettings('createEmbeddings', error, set.issuer),
-
-        errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-ECS-CES0`,
-      });
-    }
-  }
-
-  /**
-   * Visszaadja az embedding model információkat
-   *
-   * Returns embedding model information
-   */
-  getEmbeddingInfo(model: string): DyFM_DAI_EmbeddingInfo {
-    const dimensions = DyFM_OAI_EmbeddingModelDimensions[model as keyof typeof DyFM_OAI_EmbeddingModelDimensions];
-
-    return {
-      provider: DyFM_AI_Provider.OpenAI,
-      model: model
-    };
-  }
-}