@futdevpro/nts-dynamo 1.15.151 → 1.15.153

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

@@ -1,60 +1,60 @@
-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');
-  }
-}
+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 +1,56 @@
-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[] = [');
-  });
-});
+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 +1,117 @@
-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)}`;
-  }
-}
+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)}`;
+  }
+}

package/src/_modules/ai/_modules/ai-mock/_enums/aim-modality.enum.ts

@@ -1,28 +1,28 @@
-/**
- * Az AI-mock által kezelt modalitások.
- *
- * **NEM `enum`, hanem const-objektum + azonos nevű string-literal union** (declaration merging).
- * Ok — a beégetett fixture-fájloknak EGYSZERRE kell két dolgot teljesíteniük:
- *  1. **JSON-érvényesnek** maradniuk (`"modality": "text"`), mert erre épül a `dc ai-mock-list` beolvasója
- *     és az end-to-end pipeline-bizonyíték (capture → szerializálás → visszaolvasás → replay);
- *  2. **típushelyesnek** lenniük a csomagon BELÜL is (`DyNTS_AIMock_Fixture[]`).
- *
- * Egy TS `enum` ezt kizárja: a `"text"` string nem értékadható enum-típusnak (`TS2322`), ezért a
- * szerializált fixture nem fordult. A const-objektum + union mindkettőt megadja, és a hívó oldalon a
- * megszokott `DyNTS_AIMock_Modality.text` írásmód VÁLTOZATLANUL működik.
- *
- * (A fájlnév `.enum.ts` marad: fogalmilag továbbra is felsorolás, csak a TS-megvalósítás más.)
- */
-export const DyNTS_AIMock_Modality = {
-  /** Szöveg-completion (chat / LLM). */
-  text: 'text',
-  /** Embedding-vektor kimenet. */
-  embedding: 'embedding',
-  /** Kép-generálás (base64 kimenet). */
-  image: 'image',
-  /** Hang: transcription (audio→szöveg) vagy TTS (szöveg→base64-audio). */
-  audio: 'audio',
-} as const;
-
-/** A modalitás-értékek uniója — string-literálok, ezért JSON-ból is közvetlenül értékadható. */
-export type DyNTS_AIMock_Modality = typeof DyNTS_AIMock_Modality[keyof typeof DyNTS_AIMock_Modality];
+/**
+ * Az AI-mock által kezelt modalitások.
+ *
+ * **NEM `enum`, hanem const-objektum + azonos nevű string-literal union** (declaration merging).
+ * Ok — a beégetett fixture-fájloknak EGYSZERRE kell két dolgot teljesíteniük:
+ *  1. **JSON-érvényesnek** maradniuk (`"modality": "text"`), mert erre épül a `dc ai-mock-list` beolvasója
+ *     és az end-to-end pipeline-bizonyíték (capture → szerializálás → visszaolvasás → replay);
+ *  2. **típushelyesnek** lenniük a csomagon BELÜL is (`DyNTS_AIMock_Fixture[]`).
+ *
+ * Egy TS `enum` ezt kizárja: a `"text"` string nem értékadható enum-típusnak (`TS2322`), ezért a
+ * szerializált fixture nem fordult. A const-objektum + union mindkettőt megadja, és a hívó oldalon a
+ * megszokott `DyNTS_AIMock_Modality.text` írásmód VÁLTOZATLANUL működik.
+ *
+ * (A fájlnév `.enum.ts` marad: fogalmilag továbbra is felsorolás, csak a TS-megvalósítás más.)
+ */
+export const DyNTS_AIMock_Modality = {
+  /** Szöveg-completion (chat / LLM). */
+  text: 'text',
+  /** Embedding-vektor kimenet. */
+  embedding: 'embedding',
+  /** Kép-generálás (base64 kimenet). */
+  image: 'image',
+  /** Hang: transcription (audio→szöveg) vagy TTS (szöveg→base64-audio). */
+  audio: 'audio',
+} as const;
+
+/** A modalitás-értékek uniója — string-literálok, ezért JSON-ból is közvetlenül értékadható. */
+export type DyNTS_AIMock_Modality = typeof DyNTS_AIMock_Modality[keyof typeof DyNTS_AIMock_Modality];

package/src/_modules/ai/_modules/ai-mock/_models/interfaces/aim-call-input.interface.ts

@@ -1,14 +1,14 @@
-/**
- * Egy mock modalitás-hívás bemenete — a modalitást a hívott metódus adja (`chatCompletion` → text stb.),
- * ezért itt NINCS `modality` mező (v.ö. `DyNTS_AIMock_Request`, ami a teljes match-kulcs bemenete).
- */
-export interface DyNTS_AIMock_CallInput {
-  /** Provider-azonosító (pl. 'open-ai'). */
-  provider: string;
-  /** Pontos API modell-azonosító (pl. 'gpt-4o-mini'). */
-  model: string;
-  /** Provider-specifikus config-paraméterek. */
-  config?: Record<string, unknown>;
-  /** Modalitás-függő bemenet. */
-  input: unknown;
-}
+/**
+ * Egy mock modalitás-hívás bemenete — a modalitást a hívott metódus adja (`chatCompletion` → text stb.),
+ * ezért itt NINCS `modality` mező (v.ö. `DyNTS_AIMock_Request`, ami a teljes match-kulcs bemenete).
+ */
+export interface DyNTS_AIMock_CallInput {
+  /** Provider-azonosító (pl. 'open-ai'). */
+  provider: string;
+  /** Pontos API modell-azonosító (pl. 'gpt-4o-mini'). */
+  model: string;
+  /** Provider-specifikus config-paraméterek. */
+  config?: Record<string, unknown>;
+  /** Modalitás-függő bemenet. */
+  input: unknown;
+}

package/src/_modules/ai/_modules/ai-mock/_models/interfaces/aim-error.interface.ts

@@ -1,11 +1,11 @@
-import { DyNTS_AI_ProviderError } from '../../../../_models/interfaces/dynts-ai-provider-error.interface';
-
-/**
- * Provider-faithful hiba egy fixture-höz — a mock UGYANEZT reprodukálja, mintha a valódi provider dobná
- * (pl. reasoning-modell + `temperature` → OpenAI HTTP 400 `unsupported_parameter`).
- *
- * **Alias** a modul-szintű `DyNTS_AI_ProviderError`-ra (SSoT): a Layer A validátor
- * (`DyNTS_AI_ModelConfig_Validator`) és a Layer B fixture-ök UGYANAZT a hiba-alakot használják — nincs
- * párhuzamos shape. A név megmarad, hogy az ai-mock oldali olvashatóság ne romoljon.
- */
-export type DyNTS_AIMock_Error = DyNTS_AI_ProviderError;
+import { DyNTS_AI_ProviderError } from '../../../../_models/interfaces/dynts-ai-provider-error.interface';
+
+/**
+ * Provider-faithful hiba egy fixture-höz — a mock UGYANEZT reprodukálja, mintha a valódi provider dobná
+ * (pl. reasoning-modell + `temperature` → OpenAI HTTP 400 `unsupported_parameter`).
+ *
+ * **Alias** a modul-szintű `DyNTS_AI_ProviderError`-ra (SSoT): a Layer A validátor
+ * (`DyNTS_AI_ModelConfig_Validator`) és a Layer B fixture-ök UGYANAZT a hiba-alakot használják — nincs
+ * párhuzamos shape. A név megmarad, hogy az ai-mock oldali olvashatóság ne romoljon.
+ */
+export type DyNTS_AIMock_Error = DyNTS_AI_ProviderError;

package/src/_modules/ai/_modules/ai-mock/_models/interfaces/aim-fixture.interface.ts

@@ -1,30 +1,30 @@
-import { DyNTS_AIMock_Modality } from '../../_enums/aim-modality.enum';
-import { DyNTS_AIMock_Error } from './aim-error.interface';
-
-/**
- * Egy beégetett fixture-rekord (git-tracked konstans, D6). Az `output` XOR `error` közül PONTOSAN egy van:
- * sikeres válasz VAGY provider-faithful hiba. Az `inputHash` a normalizált match-kulcs input-szegmense
- * (l. `DyNTS_AIMock_FixtureMatch_Util.buildInputHash`). A `capturedAt` / `sourceModel` audit-nyomvonal (D4).
- */
-export interface DyNTS_AIMock_Fixture {
-  /** Provider-azonosító. */
-  provider: string;
-  /** Pontos API modell-azonosító. */
-  model: string;
-  /** A fixture modalitása. */
-  modality: DyNTS_AIMock_Modality;
-  /** A rögzített config-paraméterek (a match-kulcs része). */
-  config?: Record<string, unknown>;
-  /** A normalizált input-hash (deterministic input→fixture feloldáshoz). */
-  inputHash: string;
-  /** A nyers bemenet (ember-olvasható referencia; a match az `inputHash`-en megy). */
-  input: unknown;
-  /** Sikeres kimenet (modalitás-függő). Az `error`-ral kölcsönösen kizáró. */
-  output?: unknown;
-  /** Provider-faithful hiba. Az `output`-tal kölcsönösen kizáró. */
-  error?: DyNTS_AIMock_Error;
-  /** A beégetés időbélyege (ISO). */
-  capturedAt: string;
-  /** A tényleges generáló modell (ha eltér a kért aliastól). */
-  sourceModel?: string;
-}
+import { DyNTS_AIMock_Modality } from '../../_enums/aim-modality.enum';
+import { DyNTS_AIMock_Error } from './aim-error.interface';
+
+/**
+ * Egy beégetett fixture-rekord (git-tracked konstans, D6). Az `output` XOR `error` közül PONTOSAN egy van:
+ * sikeres válasz VAGY provider-faithful hiba. Az `inputHash` a normalizált match-kulcs input-szegmense
+ * (l. `DyNTS_AIMock_FixtureMatch_Util.buildInputHash`). A `capturedAt` / `sourceModel` audit-nyomvonal (D4).
+ */
+export interface DyNTS_AIMock_Fixture {
+  /** Provider-azonosító. */
+  provider: string;
+  /** Pontos API modell-azonosító. */
+  model: string;
+  /** A fixture modalitása. */
+  modality: DyNTS_AIMock_Modality;
+  /** A rögzített config-paraméterek (a match-kulcs része). */
+  config?: Record<string, unknown>;
+  /** A normalizált input-hash (deterministic input→fixture feloldáshoz). */
+  inputHash: string;
+  /** A nyers bemenet (ember-olvasható referencia; a match az `inputHash`-en megy). */
+  input: unknown;
+  /** Sikeres kimenet (modalitás-függő). Az `error`-ral kölcsönösen kizáró. */
+  output?: unknown;
+  /** Provider-faithful hiba. Az `output`-tal kölcsönösen kizáró. */
+  error?: DyNTS_AIMock_Error;
+  /** A beégetés időbélyege (ISO). */
+  capturedAt: string;
+  /** A tényleges generáló modell (ha eltér a kért aliastól). */
+  sourceModel?: string;
+}