@futdevpro/nts-dynamo 1.15.151 → 1.15.153

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

@@ -1,112 +1,112 @@
-import { DyFM_Error } from '@futdevpro/fsm-dynamo';
-import { DyFM_AI_ModelInfo, DyFM_AI_ModelType, 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_FixtureMatch_Util } from '../_collections/aim-fixture-match.util';
-import { DyNTS_AIMock_FixtureStore_Service } from './aim-fixture-store.service';
-import { DyNTS_AIMock_Service } from './aim-mock.service';
-
-describe('DyNTS_AIMock_Service', () => {
-
-  const okFixture: DyNTS_AIMock_Fixture = {
-    provider: 'open-ai',
-    model: 'gpt-4o-mini',
-    modality: DyNTS_AIMock_Modality.text,
-    config: { temperature: 0 },
-    input: 'ping',
-    inputHash: DyNTS_AIMock_FixtureMatch_Util.buildInputHash('ping'),
-    output: 'pong',
-    capturedAt: '2026-07-21T00:00:00.000Z',
-  };
-
-  const errFixture: DyNTS_AIMock_Fixture = {
-    provider: 'open-ai',
-    model: 'gpt-4o-mini',
-    modality: DyNTS_AIMock_Modality.text,
-    config: { temperature: 0.5 },
-    input: 'bad',
-    inputHash: DyNTS_AIMock_FixtureMatch_Util.buildInputHash('bad'),
-    error: {
-      httpStatus: 400,
-      providerErrorBody: { error: { type: 'invalid_request_error', param: 'temperature', code: 'unsupported_parameter' } },
-      reason: 'unsupported_parameter:temperature',
-    },
-    capturedAt: '2026-07-21T00:00:00.000Z',
-  };
-
-  function makeService(fixtures: DyNTS_AIMock_Fixture[]): DyNTS_AIMock_Service {
-    return new DyNTS_AIMock_Service(new DyNTS_AIMock_FixtureStore_Service(fixtures));
-  }
-
-  it('replay hit → a beégetett output', async () => {
-    const service: DyNTS_AIMock_Service = makeService([okFixture]);
-
-    await expectAsync(
-      service.chatCompletion({ provider: 'open-ai', model: 'gpt-4o-mini', config: { temperature: 0 }, input: 'ping' })
-    ).toBeResolvedTo('pong');
-  });
-
-  it('miss → reject-on-unknown (DyNTS-AIMOCK-NOFIX), NEM silent', async () => {
-    const service: DyNTS_AIMock_Service = makeService([okFixture]);
-
-    try {
-      await service.chatCompletion({ provider: 'open-ai', model: 'gpt-4o-mini', input: 'unknown' });
-      fail('reject-on-unknown vártunk');
-    } catch (error) {
-      expect(error instanceof DyFM_Error).toBe(true);
-      if (error instanceof DyFM_Error) {
-        expect(error.message).toContain('no fixture');
-      }
-    }
-  });
-
-  it('FR-048 config-check: NEM támogatott param → provider-faithful 400, MÉG fixture-lookup előtt', async () => {
-    const registry: DyFM_AI_ModelInfo[] = [
-      {
-        id: 'gpt-4o-mini',
-        provider: DyFM_AI_Provider.OpenAI,
-        modelType: DyFM_AI_ModelType.Chat,
-        capabilities: {} as any,
-        settingsSchema: { unsupported: ['temperature'] },
-      },
-    ];
-    // A store URES → ha a config-check NEM futna, 'no fixture' jonne; igy bizonyitjuk a sorrendet.
-    const service: DyNTS_AIMock_Service = new DyNTS_AIMock_Service(
-      new DyNTS_AIMock_FixtureStore_Service([]),
-      registry
-    );
-
-    try {
-      await service.chatCompletion({ provider: 'open-ai', model: 'gpt-4o-mini', config: { temperature: 0.5 }, input: 'x' });
-      fail('provider-faithful 400-at vártunk');
-    } catch (error) {
-      expect(error instanceof DyFM_Error).toBe(true);
-      if (error instanceof DyFM_Error) {
-        expect(error.message).toContain('unsupported_parameter:temperature');
-      }
-    }
-  });
-
-  it('FR-048 config-check: registry nélkül permisszív (nem találgat) → a fixture-replay dönt', async () => {
-    const service: DyNTS_AIMock_Service = makeService([okFixture]);
-
-    await expectAsync(
-      service.chatCompletion({ provider: 'open-ai', model: 'gpt-4o-mini', config: { temperature: 0 }, input: 'ping' })
-    ).toBeResolvedTo('pong');
-  });
-
-  it('beégetett error → provider-faithful hiba (DyNTS-AIMOCK-PERR)', async () => {
-    const service: DyNTS_AIMock_Service = makeService([errFixture]);
-
-    try {
-      await service.chatCompletion({ provider: 'open-ai', model: 'gpt-4o-mini', config: { temperature: 0.5 }, input: 'bad' });
-      fail('provider-faithful hibát vártunk');
-    } catch (error) {
-      expect(error instanceof DyFM_Error).toBe(true);
-      if (error instanceof DyFM_Error) {
-        expect(error.message).toContain('provider-faithful error');
-      }
-    }
-  });
-});
+import { DyFM_Error } from '@futdevpro/fsm-dynamo';
+import { DyFM_AI_ModelInfo, DyFM_AI_ModelType, 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_FixtureMatch_Util } from '../_collections/aim-fixture-match.util';
+import { DyNTS_AIMock_FixtureStore_Service } from './aim-fixture-store.service';
+import { DyNTS_AIMock_Service } from './aim-mock.service';
+
+describe('DyNTS_AIMock_Service', () => {
+
+  const okFixture: DyNTS_AIMock_Fixture = {
+    provider: 'open-ai',
+    model: 'gpt-4o-mini',
+    modality: DyNTS_AIMock_Modality.text,
+    config: { temperature: 0 },
+    input: 'ping',
+    inputHash: DyNTS_AIMock_FixtureMatch_Util.buildInputHash('ping'),
+    output: 'pong',
+    capturedAt: '2026-07-21T00:00:00.000Z',
+  };
+
+  const errFixture: DyNTS_AIMock_Fixture = {
+    provider: 'open-ai',
+    model: 'gpt-4o-mini',
+    modality: DyNTS_AIMock_Modality.text,
+    config: { temperature: 0.5 },
+    input: 'bad',
+    inputHash: DyNTS_AIMock_FixtureMatch_Util.buildInputHash('bad'),
+    error: {
+      httpStatus: 400,
+      providerErrorBody: { error: { type: 'invalid_request_error', param: 'temperature', code: 'unsupported_parameter' } },
+      reason: 'unsupported_parameter:temperature',
+    },
+    capturedAt: '2026-07-21T00:00:00.000Z',
+  };
+
+  function makeService(fixtures: DyNTS_AIMock_Fixture[]): DyNTS_AIMock_Service {
+    return new DyNTS_AIMock_Service(new DyNTS_AIMock_FixtureStore_Service(fixtures));
+  }
+
+  it('replay hit → a beégetett output', async () => {
+    const service: DyNTS_AIMock_Service = makeService([okFixture]);
+
+    await expectAsync(
+      service.chatCompletion({ provider: 'open-ai', model: 'gpt-4o-mini', config: { temperature: 0 }, input: 'ping' })
+    ).toBeResolvedTo('pong');
+  });
+
+  it('miss → reject-on-unknown (DyNTS-AIMOCK-NOFIX), NEM silent', async () => {
+    const service: DyNTS_AIMock_Service = makeService([okFixture]);
+
+    try {
+      await service.chatCompletion({ provider: 'open-ai', model: 'gpt-4o-mini', input: 'unknown' });
+      fail('reject-on-unknown vártunk');
+    } catch (error) {
+      expect(error instanceof DyFM_Error).toBe(true);
+      if (error instanceof DyFM_Error) {
+        expect(error.message).toContain('no fixture');
+      }
+    }
+  });
+
+  it('FR-048 config-check: NEM támogatott param → provider-faithful 400, MÉG fixture-lookup előtt', async () => {
+    const registry: DyFM_AI_ModelInfo[] = [
+      {
+        id: 'gpt-4o-mini',
+        provider: DyFM_AI_Provider.OpenAI,
+        modelType: DyFM_AI_ModelType.Chat,
+        capabilities: {} as any,
+        settingsSchema: { unsupported: ['temperature'] },
+      },
+    ];
+    // A store URES → ha a config-check NEM futna, 'no fixture' jonne; igy bizonyitjuk a sorrendet.
+    const service: DyNTS_AIMock_Service = new DyNTS_AIMock_Service(
+      new DyNTS_AIMock_FixtureStore_Service([]),
+      registry
+    );
+
+    try {
+      await service.chatCompletion({ provider: 'open-ai', model: 'gpt-4o-mini', config: { temperature: 0.5 }, input: 'x' });
+      fail('provider-faithful 400-at vártunk');
+    } catch (error) {
+      expect(error instanceof DyFM_Error).toBe(true);
+      if (error instanceof DyFM_Error) {
+        expect(error.message).toContain('unsupported_parameter:temperature');
+      }
+    }
+  });
+
+  it('FR-048 config-check: registry nélkül permisszív (nem találgat) → a fixture-replay dönt', async () => {
+    const service: DyNTS_AIMock_Service = makeService([okFixture]);
+
+    await expectAsync(
+      service.chatCompletion({ provider: 'open-ai', model: 'gpt-4o-mini', config: { temperature: 0 }, input: 'ping' })
+    ).toBeResolvedTo('pong');
+  });
+
+  it('beégetett error → provider-faithful hiba (DyNTS-AIMOCK-PERR)', async () => {
+    const service: DyNTS_AIMock_Service = makeService([errFixture]);
+
+    try {
+      await service.chatCompletion({ provider: 'open-ai', model: 'gpt-4o-mini', config: { temperature: 0.5 }, input: 'bad' });
+      fail('provider-faithful hibát vártunk');
+    } catch (error) {
+      expect(error instanceof DyFM_Error).toBe(true);
+      if (error instanceof DyFM_Error) {
+        expect(error.message).toContain('provider-faithful error');
+      }
+    }
+  });
+});

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

@@ -1,155 +1,155 @@
-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',
-    });
-  }
-}
+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',
+    });
+  }
+}