@futdevpro/nts-dynamo 1.15.126 → 1.15.127

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

@@ -1,332 +1,332 @@
-
-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]);
-    });
-  });
-});
-
+
+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]);
+    });
+  });
+});
+