@futdevpro/nts-dynamo 1.15.157 → 1.15.163

package/src/_modules/ai/_models/ai-input-interfaces.ts

@@ -1,117 +0,0 @@
-import { DyFM_AI_MessageRole } from '@futdevpro/fsm-dynamo/ai';
-import { DyFM_AI_Message } from '@futdevpro/fsm-dynamo/ai';
-import { DyFM_AI_CallSettings } from '@futdevpro/fsm-dynamo/ai';
-
-export interface DyFM_AI_Base_Input<
-  T_AISettings extends DyFM_AI_CallSettings = DyFM_AI_CallSettings
-> {
-  /* message: string; */
-  issuer: string;
-  settings?: T_AISettings;
-  debugLog?: boolean;
-  replaceThisInLog?: string;
-  getFullResponse?: boolean;
-}
-
-export interface DyFM_AI_Message_Input<
-  T_AISettings extends DyFM_AI_CallSettings = DyFM_AI_CallSettings
-> extends DyFM_AI_Base_Input<T_AISettings> {
-  message: string;
-  conversation?: DyFM_AI_Message[];
-}
-
-export interface DyFM_AI_ListSelect_Input<
-  T_AISettings extends DyFM_AI_CallSettings = DyFM_AI_CallSettings,
-> extends DyFM_AI_Message_Input<T_AISettings> {
-  selectFrom: string[];
-}
-
-export interface DyFM_AI_GenericSelect_Input<
-  T, 
-  T_AISettings extends DyFM_AI_CallSettings = DyFM_AI_CallSettings
-> extends DyFM_AI_Message_Input<T_AISettings> {
-  selectFrom: T[];
-}
-
-export interface DyFM_AI_MultiSelect_Input<
-  T_AISettings extends DyFM_AI_CallSettings = DyFM_AI_CallSettings
-> extends DyFM_AI_Message_Input<T_AISettings> {
-  options: string[];
-}
-
-export interface DyFM_AI_GenericMultiSelect_Input<
-  T, 
-  T_AISettings extends DyFM_AI_CallSettings = DyFM_AI_CallSettings
-> extends DyFM_AI_Message_Input<T_AISettings> {
-  options: T[];
-}
-
-export interface DyFM_AI_JSONKeysDescription_Input<
-  T_AISettings extends DyFM_AI_CallSettings = DyFM_AI_CallSettings
-> extends DyFM_AI_Message_Input<T_AISettings> {
-  keysDescription: string;
-}
-
-export interface DyFM_AI_JSONExactKeys_Input<
-  T_AISettings extends DyFM_AI_CallSettings = DyFM_AI_CallSettings
-> extends DyFM_AI_Message_Input<T_AISettings> {
-  keys: string[];
-}
-
-/* export interface DyFM_AI_SimpleMessage_Input extends DyFM_AI_Base_Input {
-  message: string;
-} */
-
-export interface DyFM_AI_ConversationBase_Input<
-  T_AISettings extends DyFM_AI_CallSettings = DyFM_AI_CallSettings
-> extends DyFM_AI_Base_Input<T_AISettings> {
-  message?: string;
-  conversation: DyFM_AI_Message[];
-  /* replaceThisInLog?: string; */
-}
-
-/* export interface DyFM_AI_ConversationMessage_Input extends DyFM_AI_ConversationBase_Input {
-  message: string;
-} */
-
-export interface DyFM_AI_ConversationSelect_Input<
-  T_AISettings extends DyFM_AI_CallSettings = DyFM_AI_CallSettings
-> extends DyFM_AI_ConversationBase_Input<T_AISettings> {
-  selectFrom: string[];
-}
-
-export interface DyFM_AI_ConversationGenericSelect_Input<
-  T, 
-  T_AISettings extends DyFM_AI_CallSettings = DyFM_AI_CallSettings
-> extends DyFM_AI_ConversationBase_Input<T_AISettings> {
-  selectFrom: T[];
-}
-
-export interface DyFM_AI_ConversationMultiSelect_Input<
-  T_AISettings extends DyFM_AI_CallSettings = DyFM_AI_CallSettings
-> extends DyFM_AI_ConversationBase_Input<T_AISettings> {
-  options: string[];
-}
-
-export interface DyFM_AI_ConversationGenericMultiSelect_Input<
-  T, 
-  T_AISettings extends DyFM_AI_CallSettings = DyFM_AI_CallSettings
-> extends DyFM_AI_ConversationBase_Input<T_AISettings> {
-  options: T[];
-}
-
-export interface DyFM_AI_ConversationJSONKeysDescription_Input<
-  T_AISettings extends DyFM_AI_CallSettings = DyFM_AI_CallSettings
-> extends DyFM_AI_ConversationBase_Input<T_AISettings> {
-  keysDescription: string;
-}
-
-export interface DyFM_AI_ConversationJSONExactKeys_Input<
-  T_AISettings extends DyFM_AI_CallSettings = DyFM_AI_CallSettings
-> extends DyFM_AI_ConversationBase_Input<T_AISettings> {
-  keys: string[];
-}
-
-/* export interface DyFM_AI_ConversationGetAnswer_Input extends DyFM_AI_ConversationBase_Input {
-  newMessage?: string;
-} */

package/src/_modules/ai/_models/ai-test-generation-result.interface.ts

@@ -1,16 +0,0 @@
-/**
- * Teszt generalas eredmenye
- *
- * A provider-specifikus testGeneration() metodus ezt adja vissza,
- * tartalmazva a sikesseg flag-et, a valasz szoveget, a hasznalt modellt es a keses-idejet.
- */
-export interface DyNTS_AI_TestGeneration_Result {
-  /** sikeres volt-e a teszt generalas */
-  success: boolean;
-  /** a provider valasza (sikertelen eseten undefined) */
-  response?: string;
-  /** a hasznalt modell azonosito */
-  model: string;
-  /** a keres-valasz ido milliszekundumban */
-  latencyMs: number;
-}

package/src/_modules/ai/_models/interfaces/dynts-ai-cost-event-callback.interface.ts

@@ -1,14 +0,0 @@
-import { DyNTS_AI_CostEvent } from './dynts-ai-cost-event.interface';
-
-/**
- * AI service per-call cost-event callback signature.
- *
- * A `DyNTS_AI_Provider_ServiceBase` és leszármazottak constructor-jában
- * opcionálisan átadható callback, amit minden sikeres AI-call után
- * meghív a service. Lásd `DyNTS_AI_CostEvent` interface a payload-leírásért.
- *
- * A callback **NEM dobhat** — a service `emitCostEvent` helper-je try/catch-
- * csel hívja és warning-ot logol, de a callback hibája NEM akasztja meg az
- * AI-call-t (consumer responsibility hogy a hiba ne fault-oljon).
- */
-export type DyNTS_AI_CostEventCallback = (event: DyNTS_AI_CostEvent) => void;

package/src/_modules/ai/_models/interfaces/dynts-ai-cost-event.interface.ts

@@ -1,56 +0,0 @@
-/**
- * AI service per-call cost-event payload.
- *
- * `DyNTS_AI_Provider_ServiceBase`-leszármazott AI service-ek emit-elik minden
- * sikeres call után (embedding / LLM / chat / tool-use), feltéve hogy a constructor-
- * ban át lett adva egy `onCostEvent` callback. Cél: consumer-oldali per-call
- * cost-aggregáció (CCAP `CT_`, telemetry, debug, stb.) — instance-szintű
- * accumulator nélkül.
- *
- * Non-breaking: a callback opcionális, a meglévő AI-call flow változatlan
- * ha nincs hozzárendelve. A callback hibája NEM akasztja meg az AI-call-t —
- * a `emitCostEvent` helper try/catch-csel hívja és warning-ot logol.
- *
- * `estimatedCostUsd`: opcionális — a Dynamo-szintű AI-service-ek NEM számítják
- * (nincs model-pricing registry a Dynamo-ban). A consumer (pl. CCAP `CT_`) a
- * saját pricing-jával egészíti ki a record-ot.
- */
-export interface DyNTS_AI_CostEvent {
-  /** Az AI-call típusa — embedding (single/batch) vagy LLM (completion/chat/tool-use). */
-  callType: DyNTS_AI_CallType;
-  /** Provider azonosító (pl. 'openai', 'anthropic', 'lm-studio'). */
-  provider: string;
-  /** A használt model azonosítója (pl. 'gpt-4o-mini', 'text-embedding-3-small'). */
-  model: string;
-  /** Token-fogyasztás bontva (input/output/total). Output csak LLM-call esetén értelmes. */
-  tokensUsed: DyNTS_AI_CostEventTokens;
-  /** Az AI-call hívástól a response-igtart latency ms-ben. */
-  durationMs: number;
-  /** A hívó service / use-case azonosítója (service-class-name, sessionId, runId, stb.). */
-  issuer: string;
-  /** Az event-emisszió időpontja (a sikeres response UTÁNI időpont). */
-  timestamp: Date;
-  /**
-   * Becsült USD költség — opcionális. A Dynamo NEM számítja (model-pricing
-   * registry hiányában); a consumer (CCAP `CT_`) tölti ki ha kell.
-   */
-  estimatedCostUsd?: number;
-}
-
-/** Az AI-call típusa. String-union, NEM enum (a spec szerint). */
-export type DyNTS_AI_CallType =
-  | 'embedding-single'
-  | 'embedding-batch'
-  | 'llm-completion'
-  | 'llm-chat'
-  | 'llm-tool-use';
-
-/** Token-fogyasztás bontása. Output csak LLM-call esetén értelmes. */
-export interface DyNTS_AI_CostEventTokens {
-  /** Bemeneti (prompt) tokenek száma. */
-  input: number;
-  /** Kimeneti (completion) tokenek száma — embedding-call esetén undefined. */
-  output?: number;
-  /** Total = input + (output ?? 0). */
-  total: number;
-}

package/src/_modules/ai/_models/interfaces/dynts-ai-provider-error.interface.ts

@@ -1,16 +0,0 @@
-/**
- * Provider-faithful hiba-leiro — azt irja le, MILYEN hibat adna a valodi provider egy szabalytalan
- * hivasra (FR-048). A `providerErrorBody` a provider NATIV hiba-JSON-ja (OpenAI:
- * `{error:{message,type,param,code}}`, Anthropic: `{type:'error',error:{type,message}}`).
- *
- * Egy helyen definialva, hogy a Layer A validator (`DyNTS_AI_ModelConfig_Validator`) es a Layer B
- * mock-fixture-ok UGYANAZT az alakot hasznaljak — nincs parhuzamos hiba-shape (SSoT).
- */
-export interface DyNTS_AI_ProviderError {
-  /** A reprodukalando HTTP-statusz (pl. 400). */
-  httpStatus: number;
-  /** A provider nativ hiba-body-ja. */
-  providerErrorBody: unknown;
-  /** Rovid, gepi ok-jeloles (pl. 'unsupported_parameter:temperature'). */
-  reason: string;
-}

package/src/_modules/ai/_modules/ai-mock/_collections/aim-default-collection.util.spec.ts

@@ -1,72 +0,0 @@
-import { DyFM_AI_Provider } from '@futdevpro/fsm-dynamo/ai';
-
-import { DyNTS_AIMock_Modality } from '../_enums/aim-modality.enum';
-import { DyNTS_AIMock_Fixture } from '../_models/interfaces/aim-fixture.interface';
-import { DyNTS_AIMock_ServiceCollection } from '../_models/interfaces/aim-service-collection.interface';
-import { DyNTS_AIMock_FixtureMatch_Util } from './aim-fixture-match.util';
-import { getDefaultAiMockServiceCollection } from './aim-default-collection.util';
-
-describe('| getDefaultAiMockServiceCollection (MP-7 SP-7.1)', () => {
-
-  function fixture(modality: DyNTS_AIMock_Modality, input: string): DyNTS_AIMock_Fixture {
-    return {
-      provider: 'open-ai',
-      model: 'gpt-5.4-mini',
-      modality: modality,
-      input: input,
-      inputHash: DyNTS_AIMock_FixtureMatch_Util.buildInputHash(input),
-      output: 'out',
-      capturedAt: '2026-07-21T00:00:00.000Z',
-    };
-  }
-
-  it('| default: mindharom schema-s provider registry-je be van kotve', () => {
-    const collection: DyNTS_AIMock_ServiceCollection = getDefaultAiMockServiceCollection();
-
-    expect(collection.registry.length).toBeGreaterThan(0);
-    expect(collection.registry.some((model) => model.provider === DyFM_AI_Provider.OpenAI)).toBe(true);
-    expect(collection.registry.some((model) => model.provider === DyFM_AI_Provider.Anthropic)).toBe(true);
-    expect(collection.registry.some((model) => model.provider === DyFM_AI_Provider.Google)).toBe(true);
-  });
-
-  it('| providers szukites: csak a kert provider modelljei', () => {
-    const collection: DyNTS_AIMock_ServiceCollection = getDefaultAiMockServiceCollection({
-      providers: [DyFM_AI_Provider.OpenAI],
-    });
-
-    expect(collection.registry.length).toBeGreaterThan(0);
-    expect(collection.registry.every((model) => model.provider === DyFM_AI_Provider.OpenAI)).toBe(true);
-  });
-
-  it('| service + store ossze van drotozva (a store futas kozben bovitheto)', () => {
-    const collection: DyNTS_AIMock_ServiceCollection = getDefaultAiMockServiceCollection();
-
-    expect(collection.store.size).toBe(0);
-
-    collection.store.register([fixture(DyNTS_AIMock_Modality.text, 'ping')]);
-
-    expect(collection.store.size).toBe(1);
-  });
-
-  it('| modalities szukites: csak az adott modalitasu fixture-ok kerulnek a tarba', () => {
-    const collection: DyNTS_AIMock_ServiceCollection = getDefaultAiMockServiceCollection({
-      modalities: [DyNTS_AIMock_Modality.embedding],
-      fixtures: [
-        fixture(DyNTS_AIMock_Modality.text, 'a'),
-        fixture(DyNTS_AIMock_Modality.embedding, 'b'),
-      ],
-    });
-
-    expect(collection.store.size).toBe(1);
-  });
-
-  it('| a bekototett fixture azonnal replay-elheto a service-en at', async () => {
-    const collection: DyNTS_AIMock_ServiceCollection = getDefaultAiMockServiceCollection({
-      fixtures: [fixture(DyNTS_AIMock_Modality.text, 'ping')],
-    });
-
-    await expectAsync(
-      collection.service.chatCompletion({ provider: 'open-ai', model: 'gpt-5.4-mini', input: 'ping' })
-    ).toBeResolvedTo('out');
-  });
-});

package/src/_modules/ai/_modules/ai-mock/_collections/aim-default-collection.util.ts

@@ -1,71 +0,0 @@
-import { DyFM_AI_ModelInfo, DyFM_AI_Provider } from '@futdevpro/fsm-dynamo/ai';
-import { DyFM_OAI_Models } from '@futdevpro/fsm-dynamo/ai/open-ai';
-import { DyFM_AAI_Models } from '@futdevpro/fsm-dynamo/ai/anthropic';
-import { DyFM_GAI_Models } from '@futdevpro/fsm-dynamo/ai/google';
-
-import { DyNTS_AIMock_Modality } from '../_enums/aim-modality.enum';
-import { DyNTS_AIMock_Fixture } from '../_models/interfaces/aim-fixture.interface';
-import { DyNTS_AIMock_ServiceCollection } from '../_models/interfaces/aim-service-collection.interface';
-import { DyNTS_AIMock_FixtureStore_Service } from '../_services/aim-fixture-store.service';
-import { DyNTS_AIMock_Service } from '../_services/aim-mock.service';
-
-/**
- * Provider → modell-registry hozzarendeles.
- *
- * CSAK azok a providerek szerepelnek, amelyeknek van FR-048 `settingsSchema`-juk — a `local-ai` es az
- * `fdp-ai` szandekosan schema-mentes (runtime/gateway-fuggo), igy a registry-be emelesuk a validaciohoz
- * semmit nem adna hozza. L. a fsm registry-fejleceket + `FR-048-LAYER-A.md`.
- */
-const REGISTRY_BY_PROVIDER: Record<string, DyFM_AI_ModelInfo[]> = {
-  [DyFM_AI_Provider.OpenAI]: DyFM_OAI_Models,
-  [DyFM_AI_Provider.Anthropic]: DyFM_AAI_Models,
-  [DyFM_AI_Provider.Google]: DyFM_GAI_Models,
-};
-
-/** Provider-default: minden schema-val rendelkezo provider. */
-const DEFAULT_PROVIDERS: DyFM_AI_Provider[] = [
-  DyFM_AI_Provider.OpenAI,
-  DyFM_AI_Provider.Anthropic,
-  DyFM_AI_Provider.Google,
-];
-
-/**
- * **Default-bundle factory** (MP-7 SP-7.1) — egy hivassal osszeallit egy hasznalatra kesz AI-mock keszletet:
- * fixture-tar + mock-provider + a config-validaciohoz bekototott modell-registry.
- *
- * A `fdp-templates` `getApiDefaultSettings`-mintajat koveti: a consumer teszt-modul egyetlen sorral kap egy
- * mukodo mockot, es DI-vel a valodi provider helyere teheti.
- *
- * @param set - opcionalis szukites: mely providerek registry-je legyen bekotve, mely modalitasok
- *   fixture-oi keruljenek be, es a kezdo fixture-keszlet.
- */
-export function getDefaultAiMockServiceCollection(
-  set?: {
-    /** Mely providerek registry-je legyen bekotve a config-validaciohoz (default: mind a harom schema-s). */
-    providers?: DyFM_AI_Provider[],
-    /** Ha meg van adva, CSAK az itt felsorolt modalitasu fixture-ok kerulnek a tarba. */
-    modalities?: DyNTS_AIMock_Modality[],
-    /** A kezdo (beegetett) fixture-keszlet. */
-    fixtures?: DyNTS_AIMock_Fixture[],
-  }
-): DyNTS_AIMock_ServiceCollection {
-  const providers: DyFM_AI_Provider[] = set?.providers?.length ? set.providers : DEFAULT_PROVIDERS;
-
-  const registry: DyFM_AI_ModelInfo[] = providers.reduce(
-    (all: DyFM_AI_ModelInfo[], provider: DyFM_AI_Provider) => all.concat(REGISTRY_BY_PROVIDER[provider] ?? []),
-    []
-  );
-
-  const allFixtures: DyNTS_AIMock_Fixture[] = set?.fixtures ?? [];
-  const fixtures: DyNTS_AIMock_Fixture[] = set?.modalities?.length ?
-    allFixtures.filter((fixture: DyNTS_AIMock_Fixture) => set.modalities.includes(fixture.modality)) :
-    allFixtures;
-
-  const store: DyNTS_AIMock_FixtureStore_Service = new DyNTS_AIMock_FixtureStore_Service(fixtures);
-
-  return {
-    store: store,
-    service: new DyNTS_AIMock_Service(store, registry),
-    registry: registry,
-  };
-}

package/src/_modules/ai/_modules/ai-mock/_collections/aim-fixture-match.util.spec.ts

@@ -1,57 +0,0 @@
-import { DyNTS_AIMock_Modality } from '../_enums/aim-modality.enum';
-import { DyNTS_AIMock_Request } from '../_models/interfaces/aim-request.interface';
-import { DyNTS_AIMock_FixtureMatch_Util } from './aim-fixture-match.util';
-
-describe('DyNTS_AIMock_FixtureMatch_Util', () => {
-
-  function req(overrides: Partial<DyNTS_AIMock_Request>): DyNTS_AIMock_Request {
-    return {
-      provider: 'open-ai',
-      model: 'gpt-4o-mini',
-      modality: DyNTS_AIMock_Modality.text,
-      config: { temperature: 0 },
-      input: 'ping',
-      ...overrides,
-    };
-  }
-
-  it('determinisztikus — azonos request kétszer → azonos kulcs', () => {
-    expect(DyNTS_AIMock_FixtureMatch_Util.buildMatchKey(req({}))).toBe(
-      DyNTS_AIMock_FixtureMatch_Util.buildMatchKey(req({}))
-    );
-  });
-
-  it('config-kulcs-sorrend független', () => {
-    const a: string = DyNTS_AIMock_FixtureMatch_Util.buildMatchKey(req({ config: { temperature: 0, topP: 1 } }));
-    const b: string = DyNTS_AIMock_FixtureMatch_Util.buildMatchKey(req({ config: { topP: 1, temperature: 0 } }));
-
-    expect(a).toBe(b);
-  });
-
-  it('input-whitespace független', () => {
-    const a: string = DyNTS_AIMock_FixtureMatch_Util.buildMatchKey(req({ input: 'hello   world' }));
-    const b: string = DyNTS_AIMock_FixtureMatch_Util.buildMatchKey(req({ input: '  hello world  ' }));
-
-    expect(a).toBe(b);
-  });
-
-  it('eltérő input → eltérő kulcs', () => {
-    const a: string = DyNTS_AIMock_FixtureMatch_Util.buildMatchKey(req({ input: 'ping' }));
-    const b: string = DyNTS_AIMock_FixtureMatch_Util.buildMatchKey(req({ input: 'pong' }));
-
-    expect(a).not.toBe(b);
-  });
-
-  it('eltérő modalitás → eltérő kulcs (azonos input mellett is)', () => {
-    const a: string = DyNTS_AIMock_FixtureMatch_Util.buildMatchKey(req({ modality: DyNTS_AIMock_Modality.text }));
-    const b: string = DyNTS_AIMock_FixtureMatch_Util.buildMatchKey(req({ modality: DyNTS_AIMock_Modality.embedding }));
-
-    expect(a).not.toBe(b);
-  });
-
-  it('buildInputHash stabil ugyanarra a szövegre', () => {
-    expect(DyNTS_AIMock_FixtureMatch_Util.buildInputHash('alpha')).toBe(
-      DyNTS_AIMock_FixtureMatch_Util.buildInputHash('alpha')
-    );
-  });
-});

package/src/_modules/ai/_modules/ai-mock/_collections/aim-fixture-match.util.ts

@@ -1,60 +0,0 @@
-import * as crypto from 'crypto';
-
-import { DyNTS_AIMock_Request } from '../_models/interfaces/aim-request.interface';
-
-/**
- * A fixture-match kulcs DETERMINISZTIKUS képzése. Cél: azonos „jelentésű" request → azonos kulcs,
- * függetlenül a config-kulcsok sorrendjétől és az input whitespace-variánsaitól (különben false
- * reject-on-unknown, l. HYPERPLAN D3 + MP-3 SP-3.1). NEM végez generálást — tiszta, hálózat-mentes.
- */
-export class DyNTS_AIMock_FixtureMatch_Util {
-  /**
-   * A teljes match-kulcs: `provider|model|modality|<config-hash>|<input-hash>`.
-   * @param request - a mock-hívás bemenete
-   */
-  static buildMatchKey(request: DyNTS_AIMock_Request): string {
-    const configHash: string = this.hash(this.canonicalizeConfig(request.config ?? {}));
-    const inputHash: string = this.buildInputHash(request.input);
-
-    return `${request.provider}|${request.model}|${request.modality}|${configHash}|${inputHash}`;
-  }
-
-  /**
-   * Csak az input-hash (a `DyNTS_AIMock_Fixture.inputHash`-hez): a kanonizált input SHA-256-ja.
-   * @param input - a modalitás-függő bemenet
-   */
-  static buildInputHash(input: unknown): string {
-    return this.hash(this.canonicalizeInput(input));
-  }
-
-  /**
-   * Kulcs-rendezett, stabil szöveg egy config-objektumból (a config-kulcsok sorrend-függetlenségéhez).
-   * Megjegyzés: a nested-objektum mély-kanonizációja jövőbeli finomítás (a shallow key-sort a config-flat
-   * paramétereket — temperature/dimensions/size — fedi).
-   * @param config - a kanonizálandó config
-   */
-  private static canonicalizeConfig(config: Record<string, unknown>): string {
-    const sortedKeys: string[] = Object.keys(config).sort();
-    const parts: string[] = sortedKeys.map((key: string) => `${key}:${JSON.stringify(config[key])}`);
-
-    return parts.join('|');
-  }
-
-  /**
-   * Input-kanonizáció: string → trim + belső whitespace-összevonás; egyéb (pl. embedding-szöveg-tömb) →
-   * stabil JSON (a sorrend jelentős, pl. batch-embedding).
-   * @param input - a bemenet
-   */
-  private static canonicalizeInput(input: unknown): string {
-    if (typeof input === 'string') {
-      return input.trim().replace(/\s+/g, ' ');
-    }
-
-    return JSON.stringify(input);
-  }
-
-  /** SHA-256 hex az adott szövegből. */
-  private static hash(value: string): string {
-    return crypto.createHash('sha256').update(value).digest('hex');
-  }
-}

package/src/_modules/ai/_modules/ai-mock/_collections/aim-fixture-serializer.util.spec.ts

@@ -1,56 +0,0 @@
-import { DyNTS_AIMock_Modality } from '../_enums/aim-modality.enum';
-import { DyNTS_AIMock_Fixture } from '../_models/interfaces/aim-fixture.interface';
-import { DyNTS_AIMock_FixtureSerializer_Util } from './aim-fixture-serializer.util';
-
-describe('| DyNTS_AIMock_FixtureSerializer_Util', () => {
-
-  function fixture(model: string, inputHash: string): DyNTS_AIMock_Fixture {
-    return {
-      provider: 'open-ai',
-      model: model,
-      modality: DyNTS_AIMock_Modality.text,
-      input: 'ping',
-      inputHash: inputHash,
-      output: 'pong',
-      capturedAt: '2026-07-21T00:00:00.000Z',
-    };
-  }
-
-  it('| determinisztikus: a fixture-ok SORRENDJETOL fuggetlenul azonos kimenet', () => {
-    const a: DyNTS_AIMock_Fixture[] = [ fixture('m-b', 'h2'), fixture('m-a', 'h1') ];
-    const b: DyNTS_AIMock_Fixture[] = [ fixture('m-a', 'h1'), fixture('m-b', 'h2') ];
-
-    const first: string = DyNTS_AIMock_FixtureSerializer_Util.toConstantFile({ constName: 'X', fixtures: a });
-    const second: string = DyNTS_AIMock_FixtureSerializer_Util.toConstantFile({ constName: 'X', fixtures: b });
-
-    expect(first).toBe(second);
-  });
-
-  it('| az objektum-kulcsok abc-sorrendben jonnek ki (stabil diff)', () => {
-    const output: string = DyNTS_AIMock_FixtureSerializer_Util.toConstantFile({
-      constName: 'X',
-      fixtures: [ fixture('m-a', 'h1') ],
-    });
-
-    expect(output.indexOf('"capturedAt"')).toBeLessThan(output.indexOf('"input"'));
-    expect(output.indexOf('"input"')).toBeLessThan(output.indexOf('"model"'));
-    expect(output.indexOf('"model"')).toBeLessThan(output.indexOf('"provider"'));
-  });
-
-  it('| valid TS-konstans vazat ad (import + export const + tipus)', () => {
-    const output: string = DyNTS_AIMock_FixtureSerializer_Util.toConstantFile({
-      constName: 'DyNTS_AIMock_TestFixtures',
-      fixtures: [ fixture('m-a', 'h1') ],
-    });
-
-    expect(output).toContain(`from '@futdevpro/nts-dynamo/ai/ai-mock'`);
-    expect(output).toContain('export const DyNTS_AIMock_TestFixtures: DyNTS_AIMock_Fixture[] = [');
-    expect(output.trim().endsWith('];')).toBe(true);
-  });
-
-  it('| ures keszlet → ures tomb-literal', () => {
-    const output: string = DyNTS_AIMock_FixtureSerializer_Util.toConstantFile({ constName: 'X', fixtures: [] });
-
-    expect(output).toContain('export const X: DyNTS_AIMock_Fixture[] = [');
-  });
-});

package/src/_modules/ai/_modules/ai-mock/_collections/aim-fixture-serializer.util.ts

@@ -1,117 +0,0 @@
-import { DyNTS_AIMock_Fixture } from '../_models/interfaces/aim-fixture.interface';
-
-/**
- * Beegetett fixture-ok **determinisztikus** TS-konstans fajlla alakitasa (D6: git-tracked, NEM env-fuggo).
- *
- * A determinizmus itt nem kozmetika: a fixture-fajlok verziokezeltek, ezert ugyanaz a fixture-keszlet
- * MINDIG ugyanazt a fajl-tartalmat kell adja — kulonben minden ujra-generalas zajos diff-et okoz, es a
- * code-review hasznalhatatlanna valik. Ezert: a fixture-ok **match-kulcs szerint rendezve**, az objektum-
- * kulcsok pedig **rekurzivan abc-sorrendben** kerulnek ki.
- */
-export class DyNTS_AIMock_FixtureSerializer_Util {
-
-  /** Behuzas egy szintje. */
-  private static readonly indentUnit: string = '  ';
-
-  /**
-   * Fixture-tomb → teljes TS-konstans fajl tartalma (import + export const + JSDoc-fejlec).
-   * @param set - a konstans neve + a fixture-ok + opcionalis fejlec-megjegyzes
-   */
-  static toConstantFile(
-    set: {
-      constName: string,
-      fixtures: DyNTS_AIMock_Fixture[],
-      headerNote?: string,
-      /**
-       * A generalt fajl import-utvonala a `DyNTS_AIMock_Fixture` tipushoz.
-       *
-       * Default a publikus package-utvonal (KULSO consumer fixture-fajljaihoz). **A csomagon BELULRE**
-       * kerulo fixture-oknel relativ utat kell adni (pl. `'../_models/interfaces/aim-fixture.interface'`),
-       * kulonben a fajl onmagara hivatkozna a package-nevvel, ami build-kor nem oldodik fel.
-       */
-      importPath?: string,
-    }
-  ): string {
-    const sorted: DyNTS_AIMock_Fixture[] = this.sortFixtures(set.fixtures);
-    const body: string = sorted
-      .map((fixture: DyNTS_AIMock_Fixture) => this.stringify(fixture, this.indentUnit))
-      .join(',\n');
-
-    const note: string = set.headerNote ?? 'Auto-generalt fixture-keszlet — kezzel NE szerkeszd.';
-
-    const importPath: string = set.importPath ?? '@futdevpro/nts-dynamo/ai/ai-mock';
-
-    return [
-      `import { DyNTS_AIMock_Fixture } from '${importPath}';`,
-      '',
-      '/**',
-      ` * ${note}`,
-      ' *',
-      ' * Determinisztikus sorrend (match-kulcs szerint) + rendezett objektum-kulcsok, hogy az ujra-generalas',
-      ' * ne okozzon zajos diff-et. Forras: `DyNTS_AIMock_FixtureSerializer_Util`.',
-      ' */',
-      `export const ${set.constName}: DyNTS_AIMock_Fixture[] = [`,
-      body,
-      '];',
-      '',
-    ].join('\n');
-  }
-
-  /** Fixture-ok stabil rendezese (provider|model|modality|inputHash). */
-  private static sortFixtures(fixtures: DyNTS_AIMock_Fixture[]): DyNTS_AIMock_Fixture[] {
-    return [ ...fixtures ].sort((a: DyNTS_AIMock_Fixture, b: DyNTS_AIMock_Fixture) => {
-      return this.sortKeyOf(a).localeCompare(this.sortKeyOf(b));
-    });
-  }
-
-  /** A rendezesi kulcs egy fixture-hoz. */
-  private static sortKeyOf(fixture: DyNTS_AIMock_Fixture): string {
-    return `${fixture.provider}|${fixture.model}|${fixture.modality}|${fixture.inputHash}`;
-  }
-
-  /**
-   * Rekurziv, kulcs-rendezett stringify (a `JSON.stringify` a beszurasi sorrendet tartana meg — az nem stabil).
-   * @param value - a szerializalando ertek
-   * @param indent - az aktualis behuzas
-   */
-  private static stringify(value: unknown, indent: string): string {
-    if (value === null || value === undefined) {
-      return `${indent}null`;
-    }
-
-    if (Array.isArray(value)) {
-      if (!value.length) {
-        return `${indent}[]`;
-      }
-      const items: string = value
-        .map((item: unknown) => this.stringify(item, indent + this.indentUnit))
-        .join(',\n');
-
-      return `${indent}[\n${items}\n${indent}]`;
-    }
-
-    if (typeof value === 'object') {
-      // `Object.entries` a generikus `object`-en is mukodik → nincs szukseg `as`-castra.
-      const source: Map<string, unknown> = new Map(Object.entries(value));
-      const keys: string[] = [ ...source.keys() ]
-        .filter((key: string) => source.get(key) !== undefined)
-        .sort();
-
-      if (!keys.length) {
-        return `${indent}{}`;
-      }
-
-      const entries: string = keys
-        .map((key: string) => {
-          const rendered: string = this.stringify(source.get(key), indent + this.indentUnit).trimStart();
-
-          return `${indent}${this.indentUnit}${JSON.stringify(key)}: ${rendered}`;
-        })
-        .join(',\n');
-
-      return `${indent}{\n${entries}\n${indent}}`;
-    }
-
-    return `${indent}${JSON.stringify(value)}`;
-  }
-}