@futdevpro/nts-dynamo 1.15.157 → 1.15.163

package/src/_modules/ai/_modules/ai-mock/_services/aim-mock.service.ts

@@ -1,155 +0,0 @@
-import { DyFM_Error } from '@futdevpro/fsm-dynamo';
-import { DyFM_AI_ModelInfo } from '@futdevpro/fsm-dynamo/ai';
-
-import { DyNTS_AIMock_Modality } from '../_enums/aim-modality.enum';
-import { DyNTS_AI_ModelConfig_Validator } from '../../../_collections/ai-model-config-validator.util';
-import { DyNTS_AIMock_Request } from '../_models/interfaces/aim-request.interface';
-import { DyNTS_AIMock_Fixture } from '../_models/interfaces/aim-fixture.interface';
-import { DyNTS_AIMock_Error } from '../_models/interfaces/aim-error.interface';
-import { DyNTS_AIMock_CallInput } from '../_models/interfaces/aim-call-input.interface';
-import { DyNTS_AIMock_FixtureMatch_Util } from '../_collections/aim-fixture-match.util';
-import { DyNTS_AIMock_FixtureStore_Service } from './aim-fixture-store.service';
-
-/**
- * A mock provider-surface (MP-4 SP-4.1) — a valódi AI-hívás kiváltása beégetett fixture-ökkel, outbound
- * hívás NÉLKÜL. Négy modalitás-metódus (`chatCompletion`/`embed`/`generateImage`/`generateAudio`), mind a
- * `DyNTS_AIMock_FixtureStore`-ból replay-el: hit → a beégetett kimenet; miss → strukturált reject-on-unknown
- * (D3, NEM silent-fallback, NEM outbound); beégetett provider-faithful hiba → ugyanaz a hiba, mint a valódi
- * providernél. A config-validáció (FR-048 reconciler validate-mode) a `settingsSchema` populálása UTÁN
- * kötendő be (G4) — l. a `replay` TODO-ját; addig SZÁNDÉKOSAN nem validálunk (nem fake-elünk provider-error-t).
- */
-export class DyNTS_AIMock_Service {
-
-  /** A fixture-tár, amiből a replay megy. */
-  private readonly store: DyNTS_AIMock_FixtureStore_Service;
-
-  /**
-   * A modell-registry a config-validaciohoz (FR-048 `settingsSchema`). Ures registry → NINCS
-   * config-validacio (permisszi­v), csak fixture-replay — igy a mock a schema kikerulese elott is hasznalhato.
-   */
-  private readonly modelRegistry: DyFM_AI_ModelInfo[];
-
-  /**
-   * @param store a beégetett fixture-ök tára.
-   * @param modelRegistry opcionális modell-registry (pl. `DyFM_OAI_Models`) a FR-048 config-validációhoz.
-   */
-  constructor(store: DyNTS_AIMock_FixtureStore_Service, modelRegistry?: DyFM_AI_ModelInfo[]) {
-    this.store = store;
-    this.modelRegistry = modelRegistry ?? [];
-  }
-
-  /**
-   * Chat/completion replay a beégetett fixture-ből.
-   * @param set - provider + model + opcionális config + prompt-input
-   */
-  async chatCompletion(set: DyNTS_AIMock_CallInput): Promise<unknown> {
-    return this.replay(this.toRequest(set, DyNTS_AIMock_Modality.text));
-  }
-
-  /**
-   * Embedding replay a beégetett fixture-ből.
-   * @param set - provider + model + opcionális config + szöveg(ek)-input
-   */
-  async embed(set: DyNTS_AIMock_CallInput): Promise<unknown> {
-    return this.replay(this.toRequest(set, DyNTS_AIMock_Modality.embedding));
-  }
-
-  /**
-   * Kép-generálás replay a beégetett fixture-ből.
-   * @param set - provider + model + opcionális config + kép-prompt-input
-   */
-  async generateImage(set: DyNTS_AIMock_CallInput): Promise<unknown> {
-    return this.replay(this.toRequest(set, DyNTS_AIMock_Modality.image));
-  }
-
-  /**
-   * Hang (transcription / TTS) replay a beégetett fixture-ből.
-   * @param set - provider + model + opcionális config + audio/szöveg-input
-   */
-  async generateAudio(set: DyNTS_AIMock_CallInput): Promise<unknown> {
-    return this.replay(this.toRequest(set, DyNTS_AIMock_Modality.audio));
-  }
-
-  /** A modalitás-metódus bemenetéből teljes `DyNTS_AIMock_Request`. */
-  private toRequest(set: DyNTS_AIMock_CallInput, modality: DyNTS_AIMock_Modality): DyNTS_AIMock_Request {
-    return {
-      provider: set.provider,
-      model: set.model,
-      modality: modality,
-      config: set.config,
-      input: set.input,
-    };
-  }
-
-  /**
-   * A közös replay/reject-mag.
-   *
-   * **Sorrend: FIXTURE ELŐSZÖR, validátor csak fallbackként.** Ha van beégetett fixture erre a pontos
-   * kérésre, az a FÖLDIGAZSÁG — valódi providertől rögzített, byte-hű válasz vagy hiba —, ezért mindig
-   * az nyer a szintetizált validátor-hibával szemben.
-   *
-   * (Korábban fordítva volt, „ahogy a szerver is validál a generálás előtt". Csakhogy emiatt a
-   * byte-pontosan rögzített provider-hibák SOSEM jutottak érvényre: pl. `gpt-4o-mini` + `temperature: 3`
-   * esetén a sablonom „out of range" szövege jött a valódi „decimal above maximum value. Expected a
-   * value <= 2, but got 3 instead." helyett. A capture értelme épp az, hogy a valódit adjuk vissza.)
-   *
-   * Fixture hiányában a `settingsSchema`-alapú validáció fut — így a NEM rögzített szabálysértések is
-   * provider-hű hibát kapnak, nem pusztán „nincs ilyen fixture"-t.
-   */
-  private replay(request: DyNTS_AIMock_Request): unknown {
-    const fixture: DyNTS_AIMock_Fixture | undefined = this.store.resolve(request);
-
-    if (!fixture) {
-      // nincs rogzitett valasz → a schema-alapu validacio meg adhat provider-hu hibat
-      this.validateConfig(request);
-
-      throw this.rejectOnUnknown(request);
-    }
-
-    if (fixture.error) {
-      throw this.toProviderFaithfulError(fixture.error);
-    }
-
-    return fixture.output;
-  }
-
-  /**
-   * FR-048 config-validáció — **delegál** a modul-szintű `DyNTS_AI_ModelConfig_Validator`-ra, hogy EGY
-   * validációs út legyen (SSoT): ugyanaz a kód dönt a production pre-validációnál és a mockban.
-   * Üres registry / schema-mentes modell → permisszív (nem találgatunk).
-   */
-  private validateConfig(request: DyNTS_AIMock_Request): void {
-    const error: DyFM_Error = DyNTS_AI_ModelConfig_Validator.validate({
-      provider: request.provider,
-      model: request.model,
-      config: request.config,
-      registry: this.modelRegistry,
-    });
-
-    if (error) {
-      throw error;
-    }
-  }
-
-  /** Egy `DyNTS_AIMock_Error` leíróból a dobandó `DyFM_Error`. */
-  private toProviderFaithfulError(error: DyNTS_AIMock_Error): DyFM_Error {
-    return new DyFM_Error({
-      message: `[ai-mock] provider-faithful error (HTTP ${error.httpStatus}): ${error.reason}`,
-      userMessage: 'AI request rejected (mock).',
-      errorCode: 'DyNTS-AIMOCK-PERR',
-      additionalContent: { providerErrorBody: error.providerErrorBody },
-    });
-  }
-
-  /** Strukturált „no-fixture" hiba (D3) — beszédes, a hiányzó kulccsal + az extend-recepttel (MP-6). */
-  private rejectOnUnknown(request: DyNTS_AIMock_Request): DyFM_Error {
-    const matchKey: string = DyNTS_AIMock_FixtureMatch_Util.buildMatchKey(request);
-
-    return new DyFM_Error({
-      message: `[ai-mock] no fixture for '${request.provider}:${request.model}' (${request.modality}). ` +
-        `Match-key: ${matchKey}. Beégetés: 'dc ai-mock-extend' (MP-6).`,
-      userMessage: 'No mock fixture is registered for this AI request.',
-      errorCode: 'DyNTS-AIMOCK-NOFIX',
-    });
-  }
-}