@copilotkit/aimock 1.42.1 → 1.44.0

package/dist/elevenlabs-voice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elevenlabs-voice.js","names":[],"sources":["../src/elevenlabs-voice.ts"],"sourcesContent":["import type http from \"node:http\";\nimport type {\n  ChatCompletionRequest,\n  Fixture,\n  HandlerDefaults,\n  RawJSONResponse,\n  VoiceDesignResponse,\n} from \"./types.js\";\nimport {\n  isErrorResponse,\n  isJSONResponse,\n  isJsonObject,\n  serializeErrorResponse,\n  flattenHeaders,\n  getContext,\n  getTestId,\n  resolveResponse,\n  resolveStrictMode,\n  strictOverrideField,\n  strictNoMatchMessage,\n  strictNoMatchLogLine,\n  wouldProxyMiss,\n} from \"./helpers.js\";\nimport { releaseOneShotError } from \"./fixture-loader.js\";\nimport { selectFixtureForServing } from \"./router.js\";\nimport { writeErrorResponse } from \"./sse-writer.js\";\nimport { proxyAndRecord } from \"./recorder.js\";\nimport type { ProxyCapturedResponse, ProxyOptions } from \"./recorder.js\";\nimport type { Journal } from \"./journal.js\";\nimport type { Logger } from \"./logger.js\";\nimport { applyChaosAsync, type ChaosAsyncOutcome } from \"./chaos.js\";\n\n/**\n * ElevenLabs Voice Design record + replay: `POST /v1/text-to-voice/design`\n * (previews), `POST /v1/text-to-voice` (create a voice from a preview),\n * `GET /v1/voices/{voice_id}`, `DELETE /v1/voices/{voice_id}`.\n *\n * PROVENANCE OF EVERY WIRE FACT IN THIS FILE. Read this before changing a\n * field name, a status code, or a literal below.\n *\n * FIRSTHAND — observed by this repo against live `api.elevenlabs.io` on\n * 2026-09-15, with NO api key and with a deliberately invalid one. No\n * ElevenLabs api key is reachable from this machine (1Password holds an\n * `elevenlabs.io` web login, not a key), so only the pre-auth and auth layers\n * were ever exercised:\n *   - `POST /v1/text-to-voice/design` with a >=20-char `voice_description` and\n *     no credential -> 401\n *     `{\"detail\":{\"type\":\"authentication_error\",\"code\":\"unauthorized\",\n *      \"message\":\"Neither authorization header nor xi-api-key received, please\n *      provide one.\",\"status\":\"needs_authorization\",\"request_id\":\"<hex>\"}}`.\n *     Same envelope from `GET /v1/voices/{id}`; with a bogus `xi-api-key` the\n *     message/status become `\"Invalid API key\"` / `\"invalid_api_key\"`.\n *   - `voice_description` shorter than 20 chars -> 422 with a pydantic-style\n *     `{\"detail\":[{\"type\":\"string_too_short\",\"loc\":[\"body\",\n *     \"voice_description\"],...}]}`; `POST /v1/text-to-voice` reports missing\n *     `voice_name` / `generated_voice_id` the same way. So the real service\n *     validates the body BEFORE it authenticates. THIS HANDLER NOW ENFORCES\n *     THAT 20-CODE-POINT MINIMUM on `POST /v1/text-to-voice/design`\n *     (`VOICE_DESCRIPTION_MIN_LENGTH`) and answers with that same `422\n *     {\"detail\":[...]}` envelope rather than aimock's house error shape — the\n *     one response on this surface whose real shape was observed. The `msg`\n *     STRING it fills in (\"String should have at least 20 characters\") is\n *     AUTHORED: the observed body was recorded with `msg` elided, so only the\n *     status, the `detail` array and the `loc`/`type` values are firsthand.\n *     ORDER ON `POST /v1/text-to-voice/design`: missing-parameter 400 ->\n *     fixture match (a registered short-description fixture still serves) ->\n *     chaos -> strict refusal / record-mode proxy (so the REAL 422 is recorded\n *     verbatim instead of pre-empted) -> this local 20-code-point 422 ->\n *     no-match 404. `POST /v1/text-to-voice` follows the same order, with its\n *     empty-string 422 in the same slot ahead of the synthesized voice.\n *     The minimum is NOT enforced on `POST /v1/text-to-voice`, whose\n *     `voice_description` bound has never been probed; that route rejects only\n *     an EMPTY description, which is short under any `min_length >= 1`.\n *   - `GET /v1/voices/aimock-nonexistent-voice` -> 400\n *     `{\"detail\":{\"type\":\"invalid_request\",\"code\":\"bad_request\",\"message\":\"An\n *     invalid ID has been received: ...\",\"status\":\"invalid_uid\",...}}`.\n *   KNOWN DIVERGENCE, recorded rather than papered over: every real envelope\n *   above is keyed `detail`, while this handler still emits aimock's house\n *   `{ error: { message, type, code } }` shape — and aimock's own 400/404/503\n *   codes — for EVERY failure except the `voice_description` minimum. That is\n *   deliberate consistency with every other surface here, but it means those\n *   ERROR envelopes are NOT wire-faithful to ElevenLabs. Making the whole\n *   module speak `detail` is a FOLLOW-UP: it is a breaking change for every\n *   existing consumer of this surface, and the shapes of the OTHER failures\n *   (missing parameter, unknown voice, strict-mode refusal) have not been\n *   observed, so they cannot be authored from the one case that has. A\n *   RECORDED fixture is a second exception: it replays the upstream `detail`\n *   body verbatim under the upstream status, so it is faithful by\n *   construction.\n *\n * SECONDARY — the official client `@elevenlabs/elevenlabs-js`, pinned to the\n * exact published version `2.68.0` (`node_modules/@elevenlabs/elevenlabs-js/\n * package.json` -> `\"version\": \"2.68.0\"`). Every claim below was read out of\n * these files, at that version, and nowhere else:\n *   - `api/resources/textToVoice/client/Client.d.ts` /`.js` — the routes, and\n *     the `@throws` list for each (`UnprocessableEntityError` only);\n *   - `api/resources/textToVoice/client/requests/VoiceDesignRequestModel.d.ts`\n *     and `.../BodyCreateANewVoiceFromVoicePreviewV1TextToVoicePost.d.ts` —\n *     the request bodies;\n *   - `api/types/VoiceDesignPreviewResponse.d.ts`,\n *     `api/types/VoicePreviewResponseModel.d.ts`, `api/types/Voice.d.ts`,\n *     `api/types/HttpValidationError.d.ts`, `api/types/ValidationError.d.ts`,\n *     `api/types/ValidationErrorLocItem.d.ts` — the response models;\n *   - the matching `serialization/types/*.d.ts` `Raw` interfaces and\n *     `serialization/types/*.js` schemas — the on-wire snake_case names and\n *     each field's optional/nullable treatment;\n *   - `api/errors/UnprocessableEntityError.js` (422) and\n *     `api/errors/ConflictError.js` (409, never declared for these routes).\n * It pins:\n *   - the four routes above, and that create-from-preview is `POST\n *     /v1/text-to-voice` taking `voice_name`, `voice_description`,\n *     `generated_voice_id`, optional `labels`;\n *   - the design SUCCESS body `{ previews: [...], text }` where each preview is\n *     `{ audio_base_64, generated_voice_id, media_type, duration_secs,\n *     language? }` — `language` optional, the rest required;\n *   - `model_id` values `eleven_multilingual_ttv_v2` / `eleven_ttv_v3`;\n *   - the `Voice` object's wire fields. Every key `buildSyntheticVoice()`\n *     emits (`voice_id`, `name`, `category`, `description`, `labels`,\n *     `preview_url`, `available_for_tiers`, `settings`, `sharing`,\n *     `high_quality_base_model_ids`, `samples`, `safety_control`,\n *     `voice_verification` with its four inner keys, `permission_on_resource`,\n *     `is_owner`, `is_legacy`, `is_mixed`) appears in `Voice.Raw` /\n *     `VoiceVerificationResponse.Raw`, and `\"generated\"` is one of that SDK's\n *     six `VoiceCategory` tokens;\n *   - `DELETE /v1/voices/{id}` answering `{ status: \"ok\" }`.\n *   ElevenLabs' own documentation site is a client-rendered SPA and was NOT\n *   read; the SDK is the only document behind these shapes.\n *\n * UNVERIFIED / HAND-AUTHORED — name it, do not soften it:\n *   - NO successful response from ElevenLabs has ever been observed by this\n *     repo, for any of these four routes. There is no recorded fixture or tape\n *     for this surface anywhere in the tree; the drift test in\n *     `src/__tests__/drift/elevenlabs-voice.drift.ts` restates the same\n *     hand-authored shape it checks, so it detects mock-vs-fixture divergence\n *     only and can\n *     never detect divergence from the real API.\n *   - The VALUES `buildSyntheticVoice()` fills those fields with (`null`s, `[]`,\n *     `is_owner: true`, `is_legacy`/`is_mixed` false, the zeroed\n *     `voice_verification`) are aimock's choices for a just-created voice, not\n *     anything observed. The SDK marks all of them optional and nullable, so\n *     they are plausible, not confirmed.\n *   - `voice_id === generated_voice_id` for a created voice. AUTHORED — see\n *     `buildSyntheticVoice()`. The SDK relates the two nowhere; aimock picks\n *     the alias so a caller can GET back what it just created. No code should\n *     depend on it as a wire fact.\n *   - Re-creating an already-created `generated_voice_id` overwrites and\n *     answers 200. AUTHORED — see `rememberElevenLabsVoice()`. The real\n *     behaviour is unknown and the SDK declares no `ConflictError` for the\n *     route, so aimock warns through the module logger instead of inventing a\n *     rejection.\n *   - `Voice.Raw` carries further fields this handler never emits\n *     (`fine_tuning`, `verified_languages`, `collection_ids`,\n *     `created_at_unix`, `favorited_at_unix`, `is_bookmarked`,\n *     `recording_quality`, `labelling_status`, `recording_quality_reason`). A\n *     consumer reading them off a replayed voice gets `undefined`.\n *   The standing rule still holds: THE MOCK NEVER AUTHORS A WIRE VALUE IT DID\n *   NOT OBSERVE. This surface currently does, and this block is where that debt\n *   is declared. Recording one real design + create round-trip against a funded\n *   key would retire most of it.\n */\n\nconst VOICE_STORE_MAX = 10_000;\n\n/**\n * `POST /v1/text-to-voice/design` rejects a `voice_description` shorter than\n * this. FIRSTHAND: observed against live `api.elevenlabs.io` on 2026-09-15 (see\n * the PROVENANCE block above) — a sub-20-character description comes back 422\n * with a pydantic `string_too_short` entry, BEFORE the request is even\n * authenticated, so the bound is observable without a key.\n *\n * THE UNIT IS CODE POINTS, NOT UTF-16 CODE UNITS. The bound is pydantic's\n * `min_length`, which is `len(str)` in Python — a count of code points. A\n * JavaScript `String.length` counts UTF-16 code units instead, so it\n * DOUBLE-COUNTS every non-BMP character: a 19-emoji description is 19 code\n * points to the real service (422) and 38 `.length` to JavaScript (would have\n * passed here and then failed on the wire, which is the exact class of\n * divergence this mock exists to prevent). Measure with `[...s].length`, whose\n * string iterator yields code points. Grapheme clusters are deliberately NOT\n * the unit: Python does not count those either, so `Intl.Segmenter` would\n * re-introduce the same disagreement from the other side.\n */\nconst VOICE_DESCRIPTION_MIN_LENGTH = 20;\n\n/**\n * The real service answers body-validation failures with FastAPI/pydantic's\n * envelope: HTTP 422 and `{\"detail\":[{\"loc\":[...],\"msg\":...,\"type\":...}]}`.\n * The key set is pinned by `@elevenlabs/elevenlabs-js@2.68.0`\n * (`api/types/HttpValidationError.d.ts` -> `detail?: ValidationError[]`,\n * `api/types/ValidationError.d.ts` -> `{ loc, msg, type }`,\n * `serialization/types/ValidationError.d.ts` for the identical on-wire Raw),\n * and the status by `api/errors/UnprocessableEntityError.js`\n * (`statusCode: 422`), which is what that SDK throws for these routes.\n *\n * DELIBERATE DIVERGENCE FROM ITS SIBLINGS: every other validation failure in\n * this file answers aimock's house `400 {\"error\":{...}}`. This one does not,\n * because this is the only body-validation response on this surface whose real\n * shape this repo has actually observed. Aligning the rest is a follow-up, not\n * a licence to author the others' shapes from this one.\n */\nfunction writeValidationError(\n  res: http.ServerResponse,\n  loc: Array<string | number>,\n  msg: string,\n  type: string,\n): void {\n  writeErrorResponse(res, 422, JSON.stringify({ detail: [{ loc, msg, type }] }));\n}\n\n/**\n * Voices created via POST /v1/text-to-voice, keyed by voice_id.\n *\n * MODULE-GLOBAL, deliberately: it is the same shape every other bounded store\n * here uses (`FalJobMap` in `./fal-audio.ts`, `FalQueueStateMap` in `./fal.ts`,\n * and the four video job maps), so one process shares one voice store across\n * every `LLMock` instance. `performFullReset` (`./server.ts`) clears it\n * alongside those siblings, which is what `POST /__aimock/reset` and\n * `LLMock.reset()` both route through. `stop()` does NOT clear it — no sibling\n * store is cleared on `stop()` either; reset is the isolation barrier, not\n * server teardown. A test file that creates voices must therefore reset (or\n * call `clearElevenLabsVoices()`) between tests, or a voice saved by one test\n * is still visible to the next.\n */\nconst elevenLabsVoices = new Map<string, Record<string, unknown>>();\n\nexport function clearElevenLabsVoices(): void {\n  elevenLabsVoices.clear();\n}\n\n/**\n * Store a created voice under its own `voice_id` — the id the client sees in\n * the body we are about to write, so a follow-up `GET /v1/voices/{id}` by that\n * id hits.\n *\n * Returns `false` when the body carries no string `voice_id` and nothing was\n * stored, so the caller can say so instead of dropping the voice silently.\n *\n * AUTHORED: a second create for a `voice_id` already in the store OVERWRITES\n * the first, and still answers 200. Whether the real\n * `POST /v1/text-to-voice` accepts an already-consumed `generated_voice_id` is\n * UNKNOWN to this repo — no successful create has ever been observed, and\n * `@elevenlabs/elevenlabs-js@2.68.0` gives no signal either way: its\n * `api/resources/textToVoice/client/Client.d.ts` declares only\n * `@throws UnprocessableEntityError` for `create`, and never `ConflictError`\n * (`api/errors/ConflictError.js`), so authoring a 409 here would be inventing a\n * status nothing supports. Overwrite-and-200 is aimock's choice; it is made\n * AUDIBLE via `logger.warn` rather than silent, so a test that overwrites a\n * voice by accident can see it.\n *\n * EVICTION IS FIFO AND SILENT, by insertion order — the same rule every\n * sibling store applies (see `FalJobMap.set`, `src/fal-audio.ts:107-116`, and\n * the identical block in `fal.ts` / `openrouter-video.ts` / `grok-video.ts` /\n * `byteplus-video.ts`). Once the map exceeds `VOICE_STORE_MAX`, the\n * oldest-inserted entries are deleted with no log line and no error: a later\n * `GET /v1/voices/{id}` for an evicted voice is indistinguishable from one for\n * a voice that never existed (404, or 503 under strict). It is NOT LRU —\n * reading a voice does not refresh it, and re-saving an existing `voice_id`\n * keeps its ORIGINAL insertion slot, because `Map.set` on a present key does\n * not reorder. The cap exists to bound a long-lived mock process, not to model\n * anything ElevenLabs does; at 10k voices per process no test approaches it.\n */\nexport function rememberElevenLabsVoice(voice: Record<string, unknown>, logger?: Logger): boolean {\n  const voiceId = typeof voice.voice_id === \"string\" ? voice.voice_id : undefined;\n  if (!voiceId) return false;\n  if (elevenLabsVoices.has(voiceId)) {\n    logger?.warn(\n      `ElevenLabs voice '${voiceId}' already existed and was overwritten; aimock does not know whether the real API rejects a reused generated_voice_id`,\n    );\n  }\n  elevenLabsVoices.set(voiceId, voice);\n  if (elevenLabsVoices.size > VOICE_STORE_MAX) {\n    const excess = elevenLabsVoices.size - VOICE_STORE_MAX;\n    const iter = elevenLabsVoices.keys();\n    for (let i = 0; i < excess; i++) {\n      const next = iter.next();\n      if (!next.done) elevenLabsVoices.delete(next.value);\n    }\n  }\n  return true;\n}\n\n/**\n * The status a recorded `{ json, status }` replay must answer with.\n *\n * `proxyAndRecord` persists the upstream status alongside the verbatim body for\n * this surface (`src/recorder.ts:901` — `{ json: parsedResponse, status:\n * upstreamStatus }`), and `RawJSONResponse.status` (`src/types.ts:476`) is the\n * field it lands in. Replaying every such fixture as 200 turns every recorded\n * ElevenLabs error — all of which carry a `detail` body, not aimock's house\n * error envelope, so `isErrorResponse()` never claims them — into a fabricated\n * success. `src/fal-audio.ts:1061` reads the same field the same way.\n *\n * Only `status` round-trips: that recorder branch stores no headers for a\n * verbatim-JSON recording, so there is no recorded header to honour here.\n */\nfunction replayStatus(response: RawJSONResponse): number {\n  return response.status ?? 200;\n}\n\nexport function voiceDesignToJson(response: VoiceDesignResponse): RawJSONResponse {\n  const previews = response.previews.map((preview, index) => {\n    const entry: Record<string, unknown> = {\n      generated_voice_id: preview.generated_voice_id || `aimock-preview-${index}`,\n      audio_base_64: preview.audio_base_64 ?? \"\",\n      media_type: preview.media_type ?? \"audio/mpeg\",\n      duration_secs: preview.duration_secs ?? 0,\n    };\n    // `language` is OMITTED, never null, when the caller did not supply one:\n    // the SDK models it `language?: string` (absent-or-string, never null) in\n    // `api/types/VoicePreviewResponseModel.d.ts`, and its runtime schema\n    // (`serialization/types/VoicePreviewResponseModel.js`,\n    // `core.serialization.string().optional()`) parses an incoming `null` away\n    // to `undefined`. A `null` here is therefore a value no SDK consumer can\n    // ever observe from the real API.\n    if (typeof preview.language === \"string\") entry.language = preview.language;\n    return entry;\n  });\n  return {\n    json: {\n      previews,\n      text: response.text ?? \"\",\n    },\n  };\n}\n\nfunction writeJson(res: http.ServerResponse, status: number, payload: unknown): void {\n  res.writeHead(status, { \"Content-Type\": \"application/json\" });\n  res.end(JSON.stringify(payload));\n}\n\n/**\n * The journal `source` for a chaos fault on a request no fixture answers — the\n * same rule `src/server.ts` applies, via the shared {@link wouldProxyMiss}:\n * the miss is aimock's own answer, \"internal\", unless record mode has an\n * ElevenLabs upstream to forward it to AND strict mode (server default or the\n * per-request `X-AIMock-Strict` header) is not refusing it first. Both halves\n * used to be hardcoded — design/create said \"proxy\" with no record config at\n * all, and the slot routes said \"internal\" while record mode was about to\n * proxy the very same miss.\n */\nfunction noFixtureSource(\n  defaults: HandlerDefaults,\n  headers: http.IncomingHttpHeaders,\n): \"proxy\" | \"internal\" {\n  return wouldProxyMiss(resolveStrictMode(defaults.strict, headers), defaults.record, \"elevenlabs\")\n    ? \"proxy\"\n    : \"internal\";\n}\n\nfunction parseJsonObject(\n  body: string,\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  journal: Journal,\n  path: string,\n  method: string,\n): Record<string, unknown> | null {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(body);\n  } catch (parseErr) {\n    const detail = parseErr instanceof Error ? parseErr.message : \"unknown\";\n    writeErrorResponse(\n      res,\n      400,\n      JSON.stringify({\n        error: {\n          message: `Malformed JSON: ${detail}`,\n          type: \"invalid_request_error\",\n          code: \"invalid_json\",\n        },\n      }),\n    );\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      service: \"elevenlabs-voice\",\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    return null;\n  }\n\n  if (!isJsonObject(parsed)) {\n    writeErrorResponse(\n      res,\n      400,\n      JSON.stringify({\n        error: {\n          message: \"Request body must be a JSON object\",\n          type: \"invalid_request_error\",\n        },\n      }),\n    );\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      service: \"elevenlabs-voice\",\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    return null;\n  }\n\n  return parsed;\n}\n\nfunction buildSyntheticReq(\n  parsed: Record<string, unknown>,\n  matchText: string,\n  endpoint: \"elevenlabs-voice-design\" | \"elevenlabs-voice\",\n  modelFallback: string,\n  req: http.IncomingMessage,\n): ChatCompletionRequest {\n  return {\n    model: typeof parsed.model_id === \"string\" ? parsed.model_id : modelFallback,\n    messages: [{ role: \"user\", content: matchText }],\n    _endpointType: endpoint,\n    _context: getContext(req),\n  };\n}\n\nasync function missPath(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  syntheticReq: ChatCompletionRequest,\n  fixtures: Fixture[],\n  defaults: HandlerDefaults,\n  journal: Journal,\n  path: string,\n  method: string,\n  body: string,\n  skippedBySequenceOrTurn: number,\n  proxyOptions?: ProxyOptions,\n): Promise<\"handled\" | \"miss\"> {\n  const effectiveStrict = resolveStrictMode(defaults.strict, req.headers);\n  if (effectiveStrict) {\n    const strictMessage = strictNoMatchMessage(skippedBySequenceOrTurn);\n    defaults.logger.error(strictNoMatchLogLine(method, path, skippedBySequenceOrTurn));\n    writeErrorResponse(\n      res,\n      503,\n      JSON.stringify({\n        error: {\n          message: strictMessage,\n          type: \"invalid_request_error\",\n          code: \"no_fixture_match\",\n        },\n      }),\n    );\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      service: \"elevenlabs-voice\",\n      body: syntheticReq,\n      response: {\n        status: 503,\n        fixture: null,\n        ...strictOverrideField(defaults.strict, req.headers),\n      },\n    });\n    return \"handled\";\n  }\n\n  if (defaults.record) {\n    const outcome = await proxyAndRecord(\n      req,\n      res,\n      syntheticReq,\n      \"elevenlabs\",\n      req.url ?? path,\n      fixtures,\n      defaults,\n      body,\n      proxyOptions,\n    );\n    if (outcome === \"handled_by_hook\") return \"handled\";\n    if (outcome !== \"not_configured\") {\n      journal.add({\n        method,\n        path,\n        headers: flattenHeaders(req.headers),\n        service: \"elevenlabs-voice\",\n        body: syntheticReq,\n        response: { status: res.statusCode ?? 200, fixture: null, source: \"proxy\" },\n      });\n      return \"handled\";\n    }\n  }\n\n  return \"miss\";\n}\n\nfunction writeNoMatch(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  syntheticReq: ChatCompletionRequest,\n  defaults: HandlerDefaults,\n  journal: Journal,\n  path: string,\n  method: string,\n): void {\n  writeErrorResponse(\n    res,\n    404,\n    JSON.stringify({\n      error: {\n        message: \"No fixture matched\",\n        type: \"invalid_request_error\",\n        code: \"no_fixture_match\",\n      },\n    }),\n  );\n  journal.add({\n    method,\n    path,\n    headers: flattenHeaders(req.headers),\n    service: \"elevenlabs-voice\",\n    body: syntheticReq,\n    response: {\n      status: 404,\n      fixture: null,\n      ...strictOverrideField(defaults.strict, req.headers),\n    },\n  });\n}\n\n/**\n * Builds the `beforeWriteResponse` observer for the voice routes. It NEVER\n * handles the response — it returns `false` so `proxyAndRecord` relays the\n * upstream bytes and the caller still journals the `\"relayed\"` outcome — it\n * only copies a successfully proxied voice object into the in-process store, so\n * a follow-up `GET /v1/voices/{id}` answers from memory exactly as it does\n * after an in-process create instead of hitting upstream a second time.\n *\n * It is a FACTORY OVER THE LOGGER, not a bare function, because the store has\n * exactly two things worth saying and neither can be said without one: the\n * AUTHORED overwrite of an already-stored `voice_id`, which\n * `rememberElevenLabsVoice` documents as made AUDIBLE rather than silent, and a\n * 2xx voice body carrying no string `voice_id`, which it reports by returning\n * `false`. Both are already reported on the in-process and fixture-replay paths\n * (see the `create` handler's `defaults.logger` calls); passing the observer a\n * bare function dropped both on EVERY proxy path, which is the one path where\n * the body came from somewhere aimock does not control.\n */\nfunction rememberProxiedVoice(logger: Logger): (captured: ProxyCapturedResponse) => false {\n  return (captured: ProxyCapturedResponse): false => {\n    if (captured.status < 200 || captured.status >= 300) return false;\n\n    let parsed: unknown;\n    try {\n      parsed = JSON.parse(captured.body.toString(\"utf-8\"));\n    } catch (err) {\n      // ONLY a malformed upstream body is swallowed: a non-JSON 2xx carries no\n      // voice to remember and the relay is unaffected. `JSON.parse` throws\n      // `SyntaxError` and nothing else, so ANY other error came from a genuine\n      // defect in this hook and must propagate — `proxyAndRecord` turns a\n      // rejected hook into `beforeWriteResponse hook failed for <provider>`\n      // (`src/recorder.ts`), which is a visible failure instead of a voice that\n      // vanished under the label \"upstream sent HTML\".\n      if (err instanceof SyntaxError) return false;\n      throw err;\n    }\n\n    if (!isJsonObject(parsed)) return false;\n    if (!rememberElevenLabsVoice(parsed, logger)) {\n      logger.warn(\n        `ElevenLabs relayed a ${captured.status} voice body from upstream that carries no ` +\n          `string \\`voice_id\\` — the voice was NOT stored, so a follow-up ` +\n          `GET /v1/voices/{id} will miss and re-hit upstream instead of replaying from ` +\n          `memory. Upstream body: ${captured.body.toString(\"utf-8\").slice(0, 200)}`,\n      );\n    }\n    return false;\n  };\n}\n\nfunction buildSyntheticVoice(parsed: Record<string, unknown>): Record<string, unknown> {\n  // AUTHORED: `voice_id === generated_voice_id`. Nothing in\n  // `@elevenlabs/elevenlabs-js@2.68.0` says the created voice keeps the\n  // preview's id — `api/resources/textToVoice/client/requests/\n  // BodyCreateANewVoiceFromVoicePreviewV1TextToVoicePost.d.ts` documents\n  // `generatedVoiceId` only as \"the generated_voice_id to create\", and the\n  // returned `api/types/Voice.d.ts` relates `voiceId` to it nowhere. This is\n  // aimock's choice so that a caller can GET the voice it just created; treat\n  // it as a mock convention, not a wire fact, and do not build logic on it.\n  const generatedVoiceId = String(parsed.generated_voice_id);\n  const labels =\n    parsed.labels && typeof parsed.labels === \"object\" && !Array.isArray(parsed.labels)\n      ? (parsed.labels as Record<string, unknown>)\n      : {};\n  return {\n    voice_id: generatedVoiceId,\n    name: String(parsed.voice_name),\n    category: \"generated\",\n    description: String(parsed.voice_description),\n    labels,\n    preview_url: null,\n    available_for_tiers: [],\n    settings: null,\n    sharing: null,\n    high_quality_base_model_ids: [],\n    samples: null,\n    safety_control: null,\n    voice_verification: {\n      requires_verification: false,\n      is_verified: false,\n      verification_failures: [],\n      verification_attempts_count: 0,\n    },\n    permission_on_resource: null,\n    is_owner: true,\n    is_legacy: false,\n    is_mixed: false,\n  };\n}\n\nexport async function handleElevenLabsVoiceDesign(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  body: string,\n  fixtures: Fixture[],\n  defaults: HandlerDefaults,\n  journal: Journal,\n): Promise<void> {\n  const path = req.url ?? \"/v1/text-to-voice/design\";\n  const method = req.method ?? \"POST\";\n\n  const parsed = parseJsonObject(body, req, res, journal, path, method);\n  if (!parsed) return;\n\n  // ONLY a non-string (or absent) `voice_description` is MISSING. An empty\n  // string is PRESENT AND TOO SHORT: a truthiness test here folded `\"\"` into\n  // the missing case and answered aimock's house 400, while the real service\n  // answers the same firsthand-observed 422 `string_too_short` it answers for\n  // every other sub-minimum description (PROVENANCE block above). `\"\"` is the\n  // shortest such description there is, so it is the one case where the house\n  // 400 and the observed 422 disagree most visibly.\n  const description =\n    typeof parsed.voice_description === \"string\" ? parsed.voice_description : undefined;\n\n  const syntheticReq = buildSyntheticReq(\n    parsed,\n    description ?? \"\",\n    \"elevenlabs-voice-design\",\n    \"eleven_multilingual_ttv_v2\",\n    req,\n  );\n\n  if (description === undefined) {\n    writeErrorResponse(\n      res,\n      400,\n      JSON.stringify({\n        error: {\n          message: \"Missing required parameter: 'voice_description'\",\n          type: \"invalid_request_error\",\n        },\n      }),\n    );\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      service: \"elevenlabs-voice\",\n      body: syntheticReq,\n      response: { status: 400, fixture: null },\n    });\n    return;\n  }\n\n  const testId = getTestId(req);\n  const matchCounts = journal.getFixtureMatchCountsForTest(testId);\n  const { fixture, skippedBySequenceOrTurn } = selectFixtureForServing(\n    fixtures,\n    syntheticReq,\n    matchCounts,\n    defaults.requestTransform,\n  );\n\n  if (fixture) {\n    journal.incrementFixtureMatchCount(fixture, fixtures, testId);\n  }\n\n  if (\n    await applyChaosAsync(\n      res,\n      fixture,\n      defaults.chaos,\n      req.headers,\n      req.url,\n      journal,\n      {\n        method,\n        path,\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n        service: \"elevenlabs-voice\",\n      },\n      fixture ? \"fixture\" : noFixtureSource(defaults, req.headers),\n      defaults.registry,\n      defaults.logger,\n    )\n  ) {\n    releaseOneShotError(fixtures, fixture);\n    return;\n  }\n\n  if (!fixture) {\n    const outcome = await missPath(\n      req,\n      res,\n      syntheticReq,\n      fixtures,\n      defaults,\n      journal,\n      path,\n      method,\n      body,\n      skippedBySequenceOrTurn,\n    );\n    if (outcome === \"handled\") return;\n\n    // THE LOCAL MINIMUM IS THE LAST RESORT, NOT THE FIRST GATE. It used to run\n    // ahead of fixture matching and ahead of `missPath`, which meant a\n    // registered short-description fixture could never be served and — worse —\n    // record mode answered aimock's own AUTHORED `msg` instead of forwarding,\n    // so the one response on this surface whose real shape was observed could\n    // never be recorded. `missPath` has already refused (strict) or proxied and\n    // recorded (record) by the time we get here, so this only fires when\n    // nothing else can answer.\n    // Code points, not `.length`: see `VOICE_DESCRIPTION_MIN_LENGTH`.\n    if ([...description].length < VOICE_DESCRIPTION_MIN_LENGTH) {\n      writeValidationError(\n        res,\n        [\"body\", \"voice_description\"],\n        `String should have at least ${VOICE_DESCRIPTION_MIN_LENGTH} characters`,\n        \"string_too_short\",\n      );\n      journal.add({\n        method,\n        path,\n        headers: flattenHeaders(req.headers),\n        service: \"elevenlabs-voice\",\n        body: syntheticReq,\n        response: { status: 422, fixture: null },\n      });\n      return;\n    }\n\n    writeNoMatch(req, res, syntheticReq, defaults, journal, path, method);\n    return;\n  }\n\n  const response = await resolveResponse(fixture, syntheticReq);\n\n  if (isErrorResponse(response)) {\n    const status = response.status ?? 500;\n    writeErrorResponse(res, status, serializeErrorResponse(response), {\n      retryAfter: response.retryAfter,\n    });\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      service: \"elevenlabs-voice\",\n      body: syntheticReq,\n      response: { status, fixture },\n    });\n    return;\n  }\n\n  if (!isJSONResponse(response)) {\n    writeErrorResponse(\n      res,\n      500,\n      JSON.stringify({\n        error: {\n          message: \"Fixture response is not a JSON type for voice design\",\n          type: \"server_error\",\n        },\n      }),\n    );\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      service: \"elevenlabs-voice\",\n      body: syntheticReq,\n      response: { status: 500, fixture },\n    });\n    return;\n  }\n\n  const status = replayStatus(response);\n  writeJson(res, status, response.json);\n  journal.add({\n    method,\n    path,\n    headers: flattenHeaders(req.headers),\n    service: \"elevenlabs-voice\",\n    body: syntheticReq,\n    response: { status, fixture },\n  });\n}\n\nexport async function handleElevenLabsVoiceCreate(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  body: string,\n  fixtures: Fixture[],\n  defaults: HandlerDefaults,\n  journal: Journal,\n): Promise<void> {\n  const path = req.url ?? \"/v1/text-to-voice\";\n  const method = req.method ?? \"POST\";\n\n  const parsed = parseJsonObject(body, req, res, journal, path, method);\n  if (!parsed) return;\n\n  // ONLY a non-string (or absent) field is MISSING here, for the same reason\n  // the design handler stopped folding `\"\"` into the missing case: an empty\n  // string is PRESENT AND TOO SHORT, and the house 400 said the caller had\n  // omitted a field it had actually sent. `voice_name` and `generated_voice_id`\n  // follow the same rule as `voice_description`.\n  const missing =\n    typeof parsed.voice_name !== \"string\"\n      ? \"voice_name\"\n      : typeof parsed.voice_description !== \"string\"\n        ? \"voice_description\"\n        : typeof parsed.generated_voice_id !== \"string\"\n          ? \"generated_voice_id\"\n          : null;\n  const tooShort =\n    parsed.voice_name === \"\"\n      ? \"voice_name\"\n      : parsed.voice_description === \"\"\n        ? \"voice_description\"\n        : parsed.generated_voice_id === \"\"\n          ? \"generated_voice_id\"\n          : null;\n\n  const syntheticReq = buildSyntheticReq(\n    parsed,\n    typeof parsed.generated_voice_id === \"string\" ? parsed.generated_voice_id : \"\",\n    \"elevenlabs-voice\",\n    \"eleven_multilingual_ttv_v2\",\n    req,\n  );\n\n  if (missing) {\n    writeErrorResponse(\n      res,\n      400,\n      JSON.stringify({\n        error: {\n          message: `Missing required parameter: '${missing}'`,\n          type: \"invalid_request_error\",\n        },\n      }),\n    );\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      service: \"elevenlabs-voice\",\n      body: syntheticReq,\n      response: { status: 400, fixture: null },\n    });\n    return;\n  }\n\n  const testId = getTestId(req);\n  const matchCounts = journal.getFixtureMatchCountsForTest(testId);\n  const { fixture, skippedBySequenceOrTurn } = selectFixtureForServing(\n    fixtures,\n    syntheticReq,\n    matchCounts,\n    defaults.requestTransform,\n  );\n\n  if (fixture) {\n    journal.incrementFixtureMatchCount(fixture, fixtures, testId);\n  }\n\n  if (\n    await applyChaosAsync(\n      res,\n      fixture,\n      defaults.chaos,\n      req.headers,\n      req.url,\n      journal,\n      {\n        method,\n        path,\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n        service: \"elevenlabs-voice\",\n      },\n      fixture ? \"fixture\" : noFixtureSource(defaults, req.headers),\n      defaults.registry,\n      defaults.logger,\n    )\n  ) {\n    releaseOneShotError(fixtures, fixture);\n    return;\n  }\n\n  if (!fixture) {\n    const outcome = await missPath(\n      req,\n      res,\n      syntheticReq,\n      fixtures,\n      defaults,\n      journal,\n      path,\n      method,\n      body,\n      skippedBySequenceOrTurn,\n      { beforeWriteResponse: rememberProxiedVoice(defaults.logger) },\n    );\n    if (outcome === \"handled\") return;\n\n    // THE LOCAL MINIMUM IS THE LAST RESORT, NOT THE FIRST GATE — same position\n    // as the design handler's, for the same reasons: a registered fixture,\n    // chaos, strict and the record proxy all get their turn first, so record\n    // mode forwards and records the REAL 422 instead of authoring one.\n    // An EMPTY string is the one length this route can answer without\n    // authoring an unobserved bound: it is under ANY `min_length >= 1`, so\n    // `string_too_short` holds whatever the real minimum on\n    // `POST /v1/text-to-voice` turns out to be. THE 20-CODE-POINT BOUND IS\n    // DELIBERATELY NOT ENFORCED HERE — that minimum was observed on\n    // `/v1/text-to-voice/design` only (PROVENANCE block), and this route's\n    // bounds have never been probed. The `msg` string is AUTHORED, like its\n    // design sibling's.\n    if (tooShort) {\n      writeValidationError(\n        res,\n        [\"body\", tooShort],\n        \"String should have at least 1 character\",\n        \"string_too_short\",\n      );\n      journal.add({\n        method,\n        path,\n        headers: flattenHeaders(req.headers),\n        service: \"elevenlabs-voice\",\n        body: syntheticReq,\n        response: { status: 422, fixture: null },\n      });\n      return;\n    }\n\n    const voice = buildSyntheticVoice(parsed);\n    rememberElevenLabsVoice(voice, defaults.logger);\n    writeJson(res, 200, voice);\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      service: \"elevenlabs-voice\",\n      body: syntheticReq,\n      response: { status: 200, fixture: null },\n    });\n    return;\n  }\n\n  const response = await resolveResponse(fixture, syntheticReq);\n\n  if (isErrorResponse(response)) {\n    const status = response.status ?? 500;\n    writeErrorResponse(res, status, serializeErrorResponse(response), {\n      retryAfter: response.retryAfter,\n    });\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      service: \"elevenlabs-voice\",\n      body: syntheticReq,\n      response: { status, fixture },\n    });\n    return;\n  }\n\n  if (!isJSONResponse(response)) {\n    writeErrorResponse(\n      res,\n      500,\n      JSON.stringify({\n        error: {\n          message: \"Fixture response is not a JSON type for voice create\",\n          type: \"server_error\",\n        },\n      }),\n    );\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      service: \"elevenlabs-voice\",\n      body: syntheticReq,\n      response: { status: 500, fixture },\n    });\n    return;\n  }\n\n  const status = replayStatus(response);\n\n  // Store the voice under the `voice_id` the CLIENT is about to see (this same\n  // body), so its follow-up `GET /v1/voices/{id}` by the id it received hits.\n  // Only a 2xx replay creates a voice: a recorded 4xx/5xx `detail` body carries\n  // no voice, and remembering it would resurrect the fabricated-success bug\n  // from the other side.\n  //\n  // A 2xx body with no string `voice_id` is an AUTHORING error, not an\n  // unservable fixture: the body is still what the recording says the client\n  // gets, so serve it and name the defect, the way `src/byteplus-video.ts:469`\n  // and `:479` name an envelope that is servable but will strand the client\n  // later. (The 500 `server_error` treatment a few lines above — and in\n  // `src/fal-audio.ts:1071` — is reserved for a response that CANNOT be served\n  // at all, which this one can.)\n  if (status >= 200 && status < 300) {\n    const remembered =\n      isJsonObject(response.json) && rememberElevenLabsVoice(response.json, defaults.logger);\n    if (!remembered) {\n      defaults.logger.warn(\n        `ElevenLabs voice create fixture matched generated_voice_id ` +\n          `\"${String(parsed.generated_voice_id)}\" but its json carries no string \\`voice_id\\` — ` +\n          `the voice was NOT stored, so a follow-up GET /v1/voices/{id} will 404 with a ` +\n          `\"voice not found\" message that points at the id instead of at the fixture. Add a ` +\n          `string voice_id to the fixture's json`,\n      );\n    }\n  }\n\n  writeJson(res, status, response.json);\n  journal.add({\n    method,\n    path,\n    headers: flattenHeaders(req.headers),\n    service: \"elevenlabs-voice\",\n    body: syntheticReq,\n    response: { status, fixture },\n  });\n}\n\n/**\n * The synthetic request the slot routes (GET/DELETE /v1/voices/{id}) match and\n * journal on. The voice id stands in for the user message so the entry carries\n * the one thing that identifies the request.\n *\n * The endpoint type is the CALLER's, not a constant: ONE ROUTE, ONE ENDPOINT\n * TYPE. GET declares \"elevenlabs-voice-get\" and DELETE declares\n * \"elevenlabs-voice-delete\", so neither route's fixtures can ever be confused\n * with the create route's (\"elevenlabs-voice\") — all three would otherwise\n * carry the same voice id as their match text and answer for one another.\n */\nfunction buildVoiceSlotReq(\n  req: http.IncomingMessage,\n  voiceId: string,\n  endpointType: \"elevenlabs-voice-get\" | \"elevenlabs-voice-delete\",\n): ChatCompletionRequest {\n  return {\n    model: \"eleven_multilingual_ttv_v2\",\n    messages: [{ role: \"user\", content: voiceId }],\n    _endpointType: endpointType,\n    _context: getContext(req),\n  };\n}\n\n/**\n * Gate a slot route on chaos exactly as {@link handleElevenLabsVoiceDesign} and\n * {@link handleElevenLabsVoiceCreate} gate theirs: the same `applyChaosAsync`\n * call, awaited BEFORE anything is served, so a configured latency/drop/429\n * applies to a store hit as well as to a miss. It is called AFTER the fixture\n * match and is handed the fixture that matched, because chaos can be authored\n * ON a fixture (`Fixture.chaos`, folded in by `chaos.ts`): passing null here\n * dropped a fixture-level `chaos` block on the floor for these two routes\n * while design/create honoured the identical block. The journal source follows\n * the same fixture/no-fixture split design/create use, via the same\n * {@link noFixtureSource}: \"internal\" when this process answers the miss,\n * \"proxy\" when record mode has an ElevenLabs upstream and would forward it.\n *\n * `applyChaosAsync` reads the per-testId chaos scope off `req.url`, which is\n * why the raw url — not the fallback `path` — is what it is handed, matching\n * design/create. The context carries `service: \"elevenlabs-voice\"` like every\n * other journal write in this module, so a faulted request stays selectable by\n * `GET /__aimock/journal?service=elevenlabs-voice`.\n */\nasync function gateVoiceSlotChaos(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  syntheticReq: ChatCompletionRequest,\n  fixture: Fixture | null,\n  defaults: HandlerDefaults,\n  journal: Journal,\n  path: string,\n  method: string,\n): Promise<ChaosAsyncOutcome> {\n  return await applyChaosAsync(\n    res,\n    fixture,\n    defaults.chaos,\n    req.headers,\n    req.url,\n    journal,\n    {\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      body: syntheticReq,\n      service: \"elevenlabs-voice\",\n    },\n    fixture ? \"fixture\" : noFixtureSource(defaults, req.headers),\n    defaults.registry,\n    defaults.logger,\n  );\n}\n\n/**\n * Refuse a slot-route miss under strict mode, mirroring {@link missPath}: the\n * refusal is LOGGED through the shared `strictNoMatchLogLine` and the client\n * message names strict mode, so a strict 503 is never mistaken for the route's\n * own 404.\n *\n * `skippedBySequenceOrTurn` is the count `selectFixtureForServing` handed the\n * caller. Both slot routes are fixture routes now, so a candidate fixture CAN\n * be skipped by sequence/turn state here exactly as on create — hardcoding 0\n * told every such refusal \"no fixture matched\" when the truth was \"a fixture\n * matched the content and was held back by its sequenceIndex\". When the count\n * is non-zero the client message switches to the shared\n * {@link strictNoMatchMessage} wording that names it; otherwise the\n * voice-specific message is kept, since naming the id is the more useful thing\n * to say when nothing matched at all.\n */\nfunction writeVoiceSlotStrictRefusal(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  syntheticReq: ChatCompletionRequest,\n  defaults: HandlerDefaults,\n  journal: Journal,\n  path: string,\n  method: string,\n  voiceId: string,\n  skippedBySequenceOrTurn: number,\n): void {\n  defaults.logger.error(strictNoMatchLogLine(method, path, skippedBySequenceOrTurn));\n  writeErrorResponse(\n    res,\n    503,\n    JSON.stringify({\n      error: {\n        message:\n          skippedBySequenceOrTurn > 0\n            ? strictNoMatchMessage(skippedBySequenceOrTurn)\n            : `Strict mode: voice '${voiceId}' not found`,\n        type: \"invalid_request_error\",\n        code: \"no_fixture_match\",\n      },\n    }),\n  );\n  journal.add({\n    method,\n    path,\n    headers: flattenHeaders(req.headers),\n    service: \"elevenlabs-voice\",\n    body: syntheticReq,\n    response: {\n      status: 503,\n      fixture: null,\n      ...strictOverrideField(defaults.strict, req.headers),\n    },\n  });\n}\n\n/**\n * Proxy a slot-route miss upstream in record mode. Returns \"handled\" when the\n * upstream answer was relayed (or a hook took over), \"miss\" when no upstream is\n * configured for the provider — `proxyAndRecord` already warns on that path, so\n * the caller falls through to its own miss answer.\n */\nasync function proxyVoiceSlotMiss(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  syntheticReq: ChatCompletionRequest,\n  defaults: HandlerDefaults,\n  journal: Journal,\n  path: string,\n  method: string,\n  fixtures: Fixture[] = [],\n  proxyOptions?: ProxyOptions,\n): Promise<\"handled\" | \"miss\"> {\n  const outcome = await proxyAndRecord(\n    req,\n    res,\n    syntheticReq,\n    \"elevenlabs\",\n    req.url ?? path,\n    fixtures,\n    defaults,\n    \"\",\n    proxyOptions,\n  );\n  if (outcome === \"handled_by_hook\") return \"handled\";\n  if (outcome === \"not_configured\") return \"miss\";\n  journal.add({\n    method,\n    path,\n    headers: flattenHeaders(req.headers),\n    service: \"elevenlabs-voice\",\n    body: syntheticReq,\n    response: { status: res.statusCode ?? 200, fixture: null, source: \"proxy\" },\n  });\n  return \"handled\";\n}\n\n/**\n * Replay a fixture that matched on a slot route (`GET`/`DELETE /v1/voices/{id}`).\n *\n * Both slot routes replay identically, so the body lives here once: resolve,\n * relay an error envelope under its own status, refuse a non-JSON response,\n * and otherwise write the recorded JSON under {@link replayStatus} — the\n * UPSTREAM status the recorder persisted, not a hardcoded 200. GET used to\n * hardcode 200, which turned every recorded ElevenLabs failure (a `detail`\n * body that `isErrorResponse()` never claims) into a fabricated success.\n *\n * Returns the status actually written, or `null` when the fixture could not be\n * served as a success (an error envelope was relayed, or the response was not\n * JSON at all). DELETE uses that to decide whether the local store entry is\n * gone.\n */\nasync function replayVoiceSlotFixture(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  syntheticReq: ChatCompletionRequest,\n  fixture: Fixture,\n  journal: Journal,\n  path: string,\n  method: string,\n  routeLabel: string,\n): Promise<number | null> {\n  const response = await resolveResponse(fixture, syntheticReq);\n\n  if (isErrorResponse(response)) {\n    const status = response.status ?? 500;\n    writeErrorResponse(res, status, serializeErrorResponse(response), {\n      retryAfter: response.retryAfter,\n    });\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      service: \"elevenlabs-voice\",\n      body: syntheticReq,\n      response: { status, fixture },\n    });\n    return null;\n  }\n\n  if (!isJSONResponse(response)) {\n    writeErrorResponse(\n      res,\n      500,\n      JSON.stringify({\n        error: {\n          message: `Fixture response is not a JSON type for ${routeLabel}`,\n          type: \"server_error\",\n        },\n      }),\n    );\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      service: \"elevenlabs-voice\",\n      body: syntheticReq,\n      response: { status: 500, fixture },\n    });\n    return null;\n  }\n\n  const status = replayStatus(response);\n  writeJson(res, status, response.json);\n  journal.add({\n    method,\n    path,\n    headers: flattenHeaders(req.headers),\n    service: \"elevenlabs-voice\",\n    body: syntheticReq,\n    response: { status, fixture },\n  });\n  return status;\n}\n\n/**\n * FIXTURE BEFORE STORE, on both slot routes.\n *\n * A registered or recorded fixture is explicit authoring intent and wins over\n * the in-process voice store, which is a replay CONVENIENCE populated as a\n * side effect of create. That is the order every other replay route in this\n * repo uses — fixture match first, internal state only on a miss — and without\n * it a fixture authored specifically for `GET /v1/voices/{id}` (a recorded 401,\n * say) was silently unreachable for any id that create had already stored.\n *\n * The shadowing is AUDIBLE rather than silent: when a fixture wins over a\n * present store entry this logs at debug, so a test whose store entry stopped\n * being served can see why.\n */\nfunction logVoiceSlotShadow(\n  defaults: HandlerDefaults,\n  method: string,\n  path: string,\n  voiceId: string,\n): void {\n  defaults.logger.debug(\n    `ElevenLabs ${method} ${path}: a matching fixture shadows the in-process voice ` +\n      `store entry for '${voiceId}' — the fixture is being served`,\n  );\n}\n\nexport async function handleElevenLabsVoiceGet(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  voiceId: string,\n  fixtures: Fixture[],\n  defaults: HandlerDefaults,\n  journal: Journal,\n): Promise<void> {\n  const path = req.url ?? `/v1/voices/${voiceId}`;\n  const method = req.method ?? \"GET\";\n\n  // DISTINCT endpoint type from the create route on purpose. GET used to\n  // declare \"elevenlabs-voice\", the same type `POST /v1/text-to-voice`\n  // declares, with the voice_id as the match text on both sides — so a fixture\n  // recorded on GET became a first-class candidate for create (and hijacked\n  // it), while create's own fixtures could be handed to GET. One route, one\n  // endpoint type; `src/router.ts` and `src/recorder.ts` both know this name.\n  const syntheticReq = buildVoiceSlotReq(req, voiceId, \"elevenlabs-voice-get\");\n\n  // GET is a first-class replay route, exactly like design and create: a\n  // registered or previously recorded fixture serves it. Without this the\n  // route could only ever answer from the in-process store, so nothing\n  // recorded to disk was reachable on a later run. See\n  // {@link logVoiceSlotShadow} for why the fixture is consulted BEFORE the\n  // store. The match runs BEFORE the chaos gate — and the count is incremented\n  // before it, as design/create do — so a fixture-level `chaos` block reaches\n  // the gate; see {@link gateVoiceSlotChaos}.\n  const testId = getTestId(req);\n  const matchCounts = journal.getFixtureMatchCountsForTest(testId);\n  const { fixture, skippedBySequenceOrTurn } = selectFixtureForServing(\n    fixtures,\n    syntheticReq,\n    matchCounts,\n    defaults.requestTransform,\n  );\n\n  if (fixture) {\n    journal.incrementFixtureMatchCount(fixture, fixtures, testId);\n  }\n\n  if (await gateVoiceSlotChaos(req, res, syntheticReq, fixture, defaults, journal, path, method)) {\n    releaseOneShotError(fixtures, fixture);\n    return;\n  }\n\n  const stored = elevenLabsVoices.get(voiceId);\n\n  if (fixture) {\n    if (stored) logVoiceSlotShadow(defaults, method, path, voiceId);\n    await replayVoiceSlotFixture(\n      req,\n      res,\n      syntheticReq,\n      fixture,\n      journal,\n      path,\n      method,\n      \"voice get\",\n    );\n    return;\n  }\n\n  const serveStored = (voice: Record<string, unknown>): void => {\n    writeJson(res, 200, voice);\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      service: \"elevenlabs-voice\",\n      body: syntheticReq,\n      response: { status: 200, fixture: null },\n    });\n  };\n\n  // IN RECORD MODE THE LOCAL STORE IS NOT AUTHORITATIVE, the same guard DELETE\n  // carries. Answering a locally-known voice from memory kept the GET out of\n  // the tape entirely — a proxied create left the voice in the store, so no\n  // `elevenlabs-voice-get` fixture was ever recorded and the replay run, which\n  // has only the tape, 404'd on the GET that \"worked\" while recording.\n  if (stored && !defaults.record) {\n    serveStored(stored);\n    return;\n  }\n\n  // STRICT BEFORE RECORD, the precedence missPath() uses. A strict server\n  // refuses the miss outright; it must not silently proxy it upstream.\n  if (resolveStrictMode(defaults.strict, req.headers)) {\n    writeVoiceSlotStrictRefusal(\n      req,\n      res,\n      syntheticReq,\n      defaults,\n      journal,\n      path,\n      method,\n      voiceId,\n      skippedBySequenceOrTurn,\n    );\n    return;\n  }\n\n  if (defaults.record) {\n    // The REAL fixtures array, not a throwaway `[]`: `persistFixture`\n    // (`src/recorder.ts`) pushes the freshly recorded fixture into whatever\n    // array it is handed, so passing a discarded literal made the live server\n    // forget what it had just recorded and re-hit upstream on every\n    // subsequent GET.\n    const outcome = await proxyVoiceSlotMiss(\n      req,\n      res,\n      syntheticReq,\n      defaults,\n      journal,\n      path,\n      method,\n      fixtures,\n      { beforeWriteResponse: rememberProxiedVoice(defaults.logger) },\n    );\n    if (outcome === \"handled\") return;\n    // Record mode is on but NO ElevenLabs upstream is configured (`--record`\n    // aimed at another provider): the proxy cannot forward, and the create\n    // that handed this id out was synthesized locally on that same path. The\n    // store is the only thing that knows the voice, so it answers.\n    if (stored) {\n      serveStored(stored);\n      return;\n    }\n  }\n\n  writeErrorResponse(\n    res,\n    404,\n    JSON.stringify({\n      error: {\n        message: `Voice '${voiceId}' not found`,\n        type: \"invalid_request_error\",\n        code: \"voice_not_found\",\n      },\n    }),\n  );\n  journal.add({\n    method,\n    path,\n    headers: flattenHeaders(req.headers),\n    service: \"elevenlabs-voice\",\n    body: syntheticReq,\n    response: { status: 404, fixture: null, ...strictOverrideField(defaults.strict, req.headers) },\n  });\n}\n\n/**\n * DELETE /v1/voices/{voice_id}. A first-class record/replay route, exactly\n * like GET: chaos, then a fixture match, then the in-process store, then\n * strict, then record, then the lenient answer.\n *\n * The success body is `{ status: \"ok\" }` — SECONDARY, from\n * `@elevenlabs/elevenlabs-js@2.68.0`: `voices.delete()` parses the response as\n * `DeleteVoiceResponseModel`, whose only wire field is `status: string`, and\n * whose doc comment reads \"The status of the voice deletion request. If the\n * request was successful, the status will be 'ok'.\" In record mode nothing is\n * authored at all — the upstream's own response is relayed AND recorded.\n *\n * IN RECORD MODE THE LOCAL STORE IS NOT AUTHORITATIVE. A locally-known voice\n * used to be deleted from the map and answered 200 without the request ever\n * leaving the process, so the real voice leaked upstream and the tape got a\n * hole exactly where the delete belonged. Record mode forwards regardless of\n * what the store knows; the store is a replay convenience, not a claim about\n * what exists upstream. It still evicts ONLY on a 2xx from upstream, the same\n * rule the fixture-replay branch applies: a refused delete must not lose the\n * local voice.\n *\n * A miss on a LENIENT server stays an idempotent 200: deleting an id that was\n * never saved is not an error on this surface.\n */\nexport async function handleElevenLabsVoiceDelete(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  voiceId: string,\n  fixtures: Fixture[],\n  defaults: HandlerDefaults,\n  journal: Journal,\n): Promise<void> {\n  const path = req.url ?? `/v1/voices/${voiceId}`;\n  const method = req.method ?? \"DELETE\";\n\n  // Its OWN endpoint type, for the same reason GET has one: DELETE used to\n  // declare \"elevenlabs-voice\" with the voice id as its match text — byte for\n  // byte what `POST /v1/text-to-voice` declares — so a recorded DELETE\n  // (`{\"status\":\"ok\"}`) was a first-class candidate for create and hijacked it\n  // on the next run.\n  const syntheticReq = buildVoiceSlotReq(req, voiceId, \"elevenlabs-voice-delete\");\n\n  // Match (and count) BEFORE the chaos gate, exactly as GET and design/create\n  // do, so a fixture-level `chaos` block reaches the gate.\n  const testId = getTestId(req);\n  const matchCounts = journal.getFixtureMatchCountsForTest(testId);\n  const { fixture, skippedBySequenceOrTurn } = selectFixtureForServing(\n    fixtures,\n    syntheticReq,\n    matchCounts,\n    defaults.requestTransform,\n  );\n\n  if (fixture) {\n    journal.incrementFixtureMatchCount(fixture, fixtures, testId);\n  }\n\n  if (await gateVoiceSlotChaos(req, res, syntheticReq, fixture, defaults, journal, path, method)) {\n    releaseOneShotError(fixtures, fixture);\n    return;\n  }\n\n  const stored = elevenLabsVoices.has(voiceId);\n\n  if (fixture) {\n    if (stored) logVoiceSlotShadow(defaults, method, path, voiceId);\n    const status = await replayVoiceSlotFixture(\n      req,\n      res,\n      syntheticReq,\n      fixture,\n      journal,\n      path,\n      method,\n      \"voice delete\",\n    );\n    // Only a 2xx replay says the voice is gone. A replayed 4xx/5xx is the\n    // recording saying the delete did NOT happen, so the local entry stays.\n    if (status !== null && status >= 200 && status < 300) elevenLabsVoices.delete(voiceId);\n    return;\n  }\n\n  if (stored && !defaults.record) {\n    elevenLabsVoices.delete(voiceId);\n    writeJson(res, 200, { status: \"ok\" });\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      service: \"elevenlabs-voice\",\n      body: syntheticReq,\n      response: {\n        status: 200,\n        fixture: null,\n        ...strictOverrideField(defaults.strict, req.headers),\n      },\n    });\n    return;\n  }\n\n  // STRICT BEFORE RECORD, the precedence missPath() and GET both use.\n  if (resolveStrictMode(defaults.strict, req.headers)) {\n    writeVoiceSlotStrictRefusal(\n      req,\n      res,\n      syntheticReq,\n      defaults,\n      journal,\n      path,\n      method,\n      voiceId,\n      skippedBySequenceOrTurn,\n    );\n    return;\n  }\n\n  if (defaults.record) {\n    // Evict ONLY on a 2xx from upstream, the same rule the fixture-replay\n    // branch above applies: an upstream 4xx/5xx is upstream saying the delete\n    // did NOT happen, and dropping the entry anyway lost a local voice to a\n    // refusal. `beforeWriteResponse` observes the captured upstream status and\n    // returns `false`, so `proxyAndRecord` still relays the bytes and the\n    // caller still journals the `\"relayed\"` outcome.\n    // The REAL fixtures array, for the same reason GET passes it: the\n    // throwaway `[]` this used to pass meant every recorded DELETE was\n    // discarded on the spot, never replayed, and every repeat re-hit upstream.\n    const outcome = await proxyVoiceSlotMiss(\n      req,\n      res,\n      syntheticReq,\n      defaults,\n      journal,\n      path,\n      method,\n      fixtures,\n      {\n        beforeWriteResponse: (captured): false => {\n          if (captured.status >= 200 && captured.status < 300) {\n            elevenLabsVoices.delete(voiceId);\n          }\n          return false;\n        },\n      },\n    );\n    if (outcome === \"handled\") return;\n  }\n\n  elevenLabsVoices.delete(voiceId);\n  writeJson(res, 200, { status: \"ok\" });\n  journal.add({\n    method,\n    path,\n    headers: flattenHeaders(req.headers),\n    service: \"elevenlabs-voice\",\n    body: syntheticReq,\n    response: { status: 200, fixture: null, ...strictOverrideField(defaults.strict, req.headers) },\n  });\n}\n"],"mappings":"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"}

package/dist/embeddings.cjs

@@ -1,11 +1,12 @@
 const require_helpers = require('./helpers.cjs');
-const require_router = require('./router.cjs');
 const require_sse_writer = require('./sse-writer.cjs');
 const require_chaos = require('./chaos.cjs');
+const require_fixture_loader = require('./fixture-loader.cjs');
+const require_router = require('./router.cjs');
 const require_recorder = require('./recorder.cjs');
 
 //#region src/embeddings.ts
-async function handleEmbeddings(req, res, raw, fixtures, journal, defaults, setCorsHeaders, providerKey = "openai") {
+async function handleEmbeddings(req, res, raw, fixtures, journal, defaults, setCorsHeaders, providerKey = "openai", requireModel = false) {
 	const { logger } = defaults;
 	setCorsHeaders(res);
 	let embeddingReq;
@@ -64,6 +65,23 @@ async function handleEmbeddings(req, res, raw, fixtures, journal, defaults, setC
 		} }));
 		return;
 	}
+	if (requireModel && embeddingReq.model === void 0) {
+		journal.add({
+			method: req.method ?? "POST",
+			path: req.url ?? "/v1/embeddings",
+			headers: require_helpers.flattenHeaders(req.headers),
+			body: null,
+			response: {
+				status: 400,
+				fixture: null
+			}
+		});
+		require_sse_writer.writeErrorResponse(res, 400, JSON.stringify({ error: {
+			message: "Missing required parameter: 'model'",
+			type: "invalid_request_error"
+		} }));
+		return;
+	}
 	const inputs = require_helpers.normalizeEmbeddingInput(embeddingReq.input);
 	if (inputs === null) {
 		journal.add({
@@ -93,17 +111,20 @@ async function handleEmbeddings(req, res, raw, fixtures, journal, defaults, setC
 		_context: require_helpers.getContext(req)
 	};
 	const testId = require_helpers.getTestId(req);
-	const { fixture, skippedBySequenceOrTurn } = require_router.matchFixtureDiagnostic(fixtures, syntheticReq, journal.getFixtureMatchCountsForTest(testId), defaults.requestTransform);
+	const { fixture, skippedBySequenceOrTurn } = require_router.selectFixtureForServing(fixtures, syntheticReq, journal.getFixtureMatchCountsForTest(testId), defaults.requestTransform);
 	if (fixture) {
 		journal.incrementFixtureMatchCount(fixture, fixtures, testId);
 		logger.debug(`Fixture matched: ${JSON.stringify(fixture.match).slice(0, 120)}`);
 	} else logger.debug(`No fixture matched for request`);
-	if (require_chaos.applyChaos(res, fixture, defaults.chaos, req.headers, req.url, journal, {
+	if (await require_chaos.applyChaosAsync(res, fixture, defaults.chaos, req.headers, req.url, journal, {
 		method: req.method ?? "POST",
 		path: req.url ?? "/v1/embeddings",
 		headers: require_helpers.flattenHeaders(req.headers),
 		body: syntheticReq
-	}, fixture ? "fixture" : "proxy", defaults.registry, defaults.logger)) return;
+	}, fixture ? "fixture" : "proxy", defaults.registry, defaults.logger)) {
+		require_fixture_loader.releaseOneShotError(fixtures, fixture);
+		return;
+	}
 	if (fixture) {
 		const response = await require_helpers.resolveResponse(fixture, syntheticReq);
 		if (require_helpers.isErrorResponse(response)) {

package/dist/embeddings.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"embeddings.cjs","names":["flattenHeaders","isJsonObject","normalizeEmbeddingInput","getContext","getTestId","matchFixtureDiagnostic","applyChaos","resolveResponse","isErrorResponse","serializeErrorResponse","isEmbeddingResponse","buildEmbeddingResponse","resolveStrictMode","strictNoMatchMessage","strictNoMatchLogLine","strictOverrideField","proxyAndRecord","validateEmbeddingDimensions","MAX_EMBEDDING_DIMENSIONS","generateDeterministicEmbedding"],"sources":["../src/embeddings.ts"],"sourcesContent":["/**\n * OpenAI Embeddings API support for aimock.\n *\n * Handles POST /v1/embeddings requests. Matches fixtures using the `inputText`\n * field, and falls back to generating a deterministic embedding from the input\n * text hash when no fixture matches.\n */\n\nimport type * as http from \"node:http\";\nimport type {\n  ChatCompletionRequest,\n  Fixture,\n  HandlerDefaults,\n  RecordProviderKey,\n} from \"./types.js\";\nimport {\n  isEmbeddingResponse,\n  isErrorResponse,\n  serializeErrorResponse,\n  generateDeterministicEmbedding,\n  buildEmbeddingResponse,\n  flattenHeaders,\n  getTestId,\n  resolveResponse,\n  resolveStrictMode,\n  strictOverrideField,\n  getContext,\n  strictNoMatchMessage,\n  strictNoMatchLogLine,\n  validateEmbeddingDimensions,\n  isJsonObject,\n  normalizeEmbeddingInput,\n  MAX_EMBEDDING_DIMENSIONS,\n} from \"./helpers.js\";\nimport { matchFixtureDiagnostic } from \"./router.js\";\nimport { writeErrorResponse } from \"./sse-writer.js\";\nimport type { Journal } from \"./journal.js\";\nimport { applyChaos } from \"./chaos.js\";\nimport { proxyAndRecord } from \"./recorder.js\";\n\n// ─── Embeddings API request types ──────────────────────────────────────────\n\ninterface EmbeddingRequest {\n  // Validated at runtime — these arrive as arbitrary JSON, so the declared\n  // type must not claim a shape the parser cannot guarantee.\n  input: unknown;\n  model: string;\n  encoding_format?: \"float\" | \"base64\";\n  dimensions?: unknown;\n  [key: string]: unknown;\n}\n\n// ─── Request handler ───────────────────────────────────────────────────────\n\nexport async function handleEmbeddings(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  raw: string,\n  fixtures: Fixture[],\n  journal: Journal,\n  defaults: HandlerDefaults,\n  setCorsHeaders: (res: http.ServerResponse) => void,\n  providerKey: RecordProviderKey = \"openai\",\n): Promise<void> {\n  const { logger } = defaults;\n  setCorsHeaders(res);\n\n  let embeddingReq: EmbeddingRequest;\n  try {\n    embeddingReq = JSON.parse(raw) as EmbeddingRequest;\n  } catch (parseErr) {\n    const detail = parseErr instanceof Error ? parseErr.message : \"unknown\";\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\n      headers: flattenHeaders(req.headers),\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      JSON.stringify({\n        error: {\n          message: `Malformed JSON body: ${detail}`,\n          type: \"invalid_request_error\",\n          code: \"invalid_json\",\n        },\n      }),\n    );\n    return;\n  }\n\n  // Reject bodies that parsed but are not a JSON object (e.g. `null`) before\n  // touching fields — otherwise `embeddingReq.input` throws a TypeError that\n  // surfaces as a 500 instead of a 400.\n  if (!isJsonObject(embeddingReq)) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\n      headers: flattenHeaders(req.headers),\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      JSON.stringify({\n        error: {\n          message: \"Request body must be a JSON object\",\n          type: \"invalid_request_error\",\n        },\n      }),\n    );\n    return;\n  }\n\n  // Validate required input parameter\n  if (embeddingReq.input === undefined || embeddingReq.input === null) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\n      headers: flattenHeaders(req.headers),\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      JSON.stringify({\n        error: {\n          message: \"Missing required parameter: 'input'\",\n          type: \"invalid_request_error\",\n        },\n      }),\n    );\n    return;\n  }\n\n  // Normalize input to array of strings — reject non-string inputs with 400\n  // instead of crashing downstream in createHash().update() (500).\n  const inputs = normalizeEmbeddingInput(embeddingReq.input);\n  if (inputs === null) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\n      headers: flattenHeaders(req.headers),\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      JSON.stringify({\n        error: {\n          message:\n            \"Invalid parameter: 'input' must be a string, an array of strings, or an array of tokens\",\n          type: \"invalid_request_error\",\n          param: null,\n          code: null,\n        },\n      }),\n    );\n    return;\n  }\n\n  // Concatenate all inputs for matching purposes\n  const combinedInput = inputs.join(\" \");\n\n  // Build a synthetic ChatCompletionRequest for the fixture router.\n  // We attach `embeddingInput` so the router's inputText matching can use it.\n  const syntheticReq: ChatCompletionRequest = {\n    model: embeddingReq.model,\n    messages: [],\n    embeddingInput: combinedInput,\n    _endpointType: \"embedding\",\n    _context: getContext(req),\n  };\n\n  const testId = getTestId(req);\n  const { fixture, skippedBySequenceOrTurn } = matchFixtureDiagnostic(\n    fixtures,\n    syntheticReq,\n    journal.getFixtureMatchCountsForTest(testId),\n    defaults.requestTransform,\n  );\n\n  if (fixture) {\n    journal.incrementFixtureMatchCount(fixture, fixtures, testId);\n    logger.debug(`Fixture matched: ${JSON.stringify(fixture.match).slice(0, 120)}`);\n  } else {\n    logger.debug(`No fixture matched for request`);\n  }\n\n  if (\n    applyChaos(\n      res,\n      fixture,\n      defaults.chaos,\n      req.headers,\n      req.url,\n      journal,\n      {\n        method: req.method ?? \"POST\",\n        path: req.url ?? \"/v1/embeddings\",\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n      },\n      fixture ? \"fixture\" : \"proxy\",\n      defaults.registry,\n      defaults.logger,\n    )\n  )\n    return;\n\n  if (fixture) {\n    const response = await resolveResponse(fixture, syntheticReq);\n\n    // Error response\n    if (isErrorResponse(response)) {\n      const status = response.status ?? 500;\n      journal.add({\n        method: req.method ?? \"POST\",\n        path: req.url ?? \"/v1/embeddings\",\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n        response: { status, fixture },\n      });\n      writeErrorResponse(res, status, serializeErrorResponse(response), {\n        retryAfter: response.retryAfter,\n      });\n      return;\n    }\n\n    // Embedding response — use the fixture's embedding for each input\n    if (isEmbeddingResponse(response)) {\n      journal.add({\n        method: req.method ?? \"POST\",\n        path: req.url ?? \"/v1/embeddings\",\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n        response: { status: 200, fixture },\n      });\n      const embeddings = inputs.map(() => [...response.embedding]);\n      const body = buildEmbeddingResponse(embeddings, embeddingReq.model);\n      res.writeHead(200, { \"Content-Type\": \"application/json\" });\n      res.end(JSON.stringify(body));\n      return;\n    }\n\n    // Fixture matched but response type is not compatible with embeddings\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\n      headers: flattenHeaders(req.headers),\n      body: syntheticReq,\n      response: { status: 500, fixture },\n    });\n    writeErrorResponse(\n      res,\n      500,\n      JSON.stringify({\n        error: {\n          message:\n            \"Fixture response did not match any known embedding type (must have embedding or error)\",\n          type: \"server_error\",\n        },\n      }),\n    );\n    return;\n  }\n\n  // No fixture match — check strict mode first, then try proxy\n  if (resolveStrictMode(defaults.strict, req.headers)) {\n    const strictMessage = strictNoMatchMessage(skippedBySequenceOrTurn);\n    logger.error(\n      strictNoMatchLogLine(\n        req.method ?? \"POST\",\n        req.url ?? \"/v1/embeddings\",\n        skippedBySequenceOrTurn,\n      ),\n    );\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\n      headers: flattenHeaders(req.headers),\n      body: syntheticReq,\n      response: {\n        status: 503,\n        fixture: null,\n        ...strictOverrideField(defaults.strict, req.headers),\n      },\n    });\n    writeErrorResponse(\n      res,\n      503,\n      JSON.stringify({\n        error: {\n          message: strictMessage,\n          type: \"invalid_request_error\",\n          code: \"no_fixture_match\",\n        },\n      }),\n    );\n    return;\n  }\n\n  if (defaults.record) {\n    const outcome = await proxyAndRecord(\n      req,\n      res,\n      syntheticReq,\n      providerKey,\n      req.url ?? \"/v1/embeddings\",\n      fixtures,\n      defaults,\n      raw,\n    );\n    if (outcome === \"handled_by_hook\") return;\n    if (outcome !== \"not_configured\") {\n      journal.add({\n        method: req.method ?? \"POST\",\n        path: req.url ?? \"/v1/embeddings\",\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n        response: { status: res.statusCode ?? 200, fixture: null, source: \"proxy\" },\n      });\n      return;\n    }\n  }\n\n  // No fixture match — generate deterministic embeddings from input text\n  logger.warn(\n    `No embedding fixture matched for \"${combinedInput.slice(0, 80)}\" — returning deterministic fallback`,\n  );\n  // Validate dimensions here, on the only path that reads it: a bad value\n  // either throws RangeError in `new Array()` below or, past the serialization\n  // budget MAX_EMBEDDING_DIMENSIONS encodes, kills the process outright. The\n  // fixture-replay, chaos, strict and record/proxy branches above never touch\n  // it, so they must not be gated.\n  const dimensions = validateEmbeddingDimensions(embeddingReq.dimensions);\n  if (dimensions === null) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\n      headers: flattenHeaders(req.headers),\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      JSON.stringify({\n        error: {\n          message: `Invalid parameter: 'dimensions' must be an integer between 1 and ${MAX_EMBEDDING_DIMENSIONS}`,\n          type: \"invalid_request_error\",\n          param: null,\n          code: null,\n        },\n      }),\n    );\n    return;\n  }\n\n  const embeddings = inputs.map((input) => generateDeterministicEmbedding(input, dimensions));\n\n  journal.add({\n    method: req.method ?? \"POST\",\n    path: req.url ?? \"/v1/embeddings\",\n    headers: flattenHeaders(req.headers),\n    body: syntheticReq,\n    response: { status: 200, fixture: null },\n  });\n\n  const body = buildEmbeddingResponse(embeddings, embeddingReq.model);\n  res.writeHead(200, { \"Content-Type\": \"application/json\" });\n  res.end(JSON.stringify(body));\n}\n"],"mappings":"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"}
+{"version":3,"file":"embeddings.cjs","names":["flattenHeaders","isJsonObject","normalizeEmbeddingInput","getContext","getTestId","selectFixtureForServing","applyChaosAsync","resolveResponse","isErrorResponse","serializeErrorResponse","isEmbeddingResponse","buildEmbeddingResponse","resolveStrictMode","strictNoMatchMessage","strictNoMatchLogLine","strictOverrideField","proxyAndRecord","validateEmbeddingDimensions","MAX_EMBEDDING_DIMENSIONS","generateDeterministicEmbedding"],"sources":["../src/embeddings.ts"],"sourcesContent":["/**\n * OpenAI Embeddings API support for aimock.\n *\n * Handles POST /v1/embeddings requests. Matches fixtures using the `inputText`\n * field, and falls back to generating a deterministic embedding from the input\n * text hash when no fixture matches.\n */\n\nimport type * as http from \"node:http\";\nimport type {\n  ChatCompletionRequest,\n  Fixture,\n  HandlerDefaults,\n  RecordProviderKey,\n} from \"./types.js\";\nimport {\n  isEmbeddingResponse,\n  isErrorResponse,\n  serializeErrorResponse,\n  generateDeterministicEmbedding,\n  buildEmbeddingResponse,\n  flattenHeaders,\n  getTestId,\n  resolveResponse,\n  resolveStrictMode,\n  strictOverrideField,\n  getContext,\n  strictNoMatchMessage,\n  strictNoMatchLogLine,\n  validateEmbeddingDimensions,\n  isJsonObject,\n  normalizeEmbeddingInput,\n  MAX_EMBEDDING_DIMENSIONS,\n} from \"./helpers.js\";\nimport { releaseOneShotError } from \"./fixture-loader.js\";\nimport { selectFixtureForServing } from \"./router.js\";\nimport { writeErrorResponse } from \"./sse-writer.js\";\nimport type { Journal } from \"./journal.js\";\nimport { applyChaosAsync } from \"./chaos.js\";\nimport { proxyAndRecord } from \"./recorder.js\";\n\n// ─── Embeddings API request types ──────────────────────────────────────────\n\ninterface EmbeddingRequest {\n  // Validated at runtime — these arrive as arbitrary JSON, so the declared\n  // type must not claim a shape the parser cannot guarantee.\n  input: unknown;\n  model: string;\n  encoding_format?: \"float\" | \"base64\";\n  dimensions?: unknown;\n  [key: string]: unknown;\n}\n\n// ─── Request handler ───────────────────────────────────────────────────────\n\nexport async function handleEmbeddings(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  raw: string,\n  fixtures: Fixture[],\n  journal: Journal,\n  defaults: HandlerDefaults,\n  setCorsHeaders: (res: http.ServerResponse) => void,\n  providerKey: RecordProviderKey = \"openai\",\n  // Native HTTP dispatch opts in; direct callers and compatible routes retain defaults.\n  requireModel = false,\n): Promise<void> {\n  const { logger } = defaults;\n  setCorsHeaders(res);\n\n  let embeddingReq: EmbeddingRequest;\n  try {\n    embeddingReq = JSON.parse(raw) as EmbeddingRequest;\n  } catch (parseErr) {\n    const detail = parseErr instanceof Error ? parseErr.message : \"unknown\";\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\n      headers: flattenHeaders(req.headers),\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      JSON.stringify({\n        error: {\n          message: `Malformed JSON body: ${detail}`,\n          type: \"invalid_request_error\",\n          code: \"invalid_json\",\n        },\n      }),\n    );\n    return;\n  }\n\n  // Reject bodies that parsed but are not a JSON object (e.g. `null`) before\n  // touching fields — otherwise `embeddingReq.input` throws a TypeError that\n  // surfaces as a 500 instead of a 400.\n  if (!isJsonObject(embeddingReq)) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\n      headers: flattenHeaders(req.headers),\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      JSON.stringify({\n        error: {\n          message: \"Request body must be a JSON object\",\n          type: \"invalid_request_error\",\n        },\n      }),\n    );\n    return;\n  }\n\n  // Validate required input parameter\n  if (embeddingReq.input === undefined || embeddingReq.input === null) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\n      headers: flattenHeaders(req.headers),\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      JSON.stringify({\n        error: {\n          message: \"Missing required parameter: 'input'\",\n          type: \"invalid_request_error\",\n        },\n      }),\n    );\n    return;\n  }\n\n  if (requireModel && embeddingReq.model === undefined) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\n      headers: flattenHeaders(req.headers),\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      JSON.stringify({\n        error: {\n          message: \"Missing required parameter: 'model'\",\n          type: \"invalid_request_error\",\n        },\n      }),\n    );\n    return;\n  }\n\n  // Normalize input to array of strings — reject non-string inputs with 400\n  // instead of crashing downstream in createHash().update() (500).\n  const inputs = normalizeEmbeddingInput(embeddingReq.input);\n  if (inputs === null) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\n      headers: flattenHeaders(req.headers),\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      JSON.stringify({\n        error: {\n          message:\n            \"Invalid parameter: 'input' must be a string, an array of strings, or an array of tokens\",\n          type: \"invalid_request_error\",\n          param: null,\n          code: null,\n        },\n      }),\n    );\n    return;\n  }\n\n  // Concatenate all inputs for matching purposes\n  const combinedInput = inputs.join(\" \");\n\n  // Build a synthetic ChatCompletionRequest for the fixture router.\n  // We attach `embeddingInput` so the router's inputText matching can use it.\n  const syntheticReq: ChatCompletionRequest = {\n    model: embeddingReq.model,\n    messages: [],\n    embeddingInput: combinedInput,\n    _endpointType: \"embedding\",\n    _context: getContext(req),\n  };\n\n  const testId = getTestId(req);\n  const { fixture, skippedBySequenceOrTurn } = selectFixtureForServing(\n    fixtures,\n    syntheticReq,\n    journal.getFixtureMatchCountsForTest(testId),\n    defaults.requestTransform,\n  );\n\n  if (fixture) {\n    journal.incrementFixtureMatchCount(fixture, fixtures, testId);\n    logger.debug(`Fixture matched: ${JSON.stringify(fixture.match).slice(0, 120)}`);\n  } else {\n    logger.debug(`No fixture matched for request`);\n  }\n\n  if (\n    await applyChaosAsync(\n      res,\n      fixture,\n      defaults.chaos,\n      req.headers,\n      req.url,\n      journal,\n      {\n        method: req.method ?? \"POST\",\n        path: req.url ?? \"/v1/embeddings\",\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n      },\n      fixture ? \"fixture\" : \"proxy\",\n      defaults.registry,\n      defaults.logger,\n    )\n  ) {\n    releaseOneShotError(fixtures, fixture);\n    return;\n  }\n\n  if (fixture) {\n    const response = await resolveResponse(fixture, syntheticReq);\n\n    // Error response\n    if (isErrorResponse(response)) {\n      const status = response.status ?? 500;\n      journal.add({\n        method: req.method ?? \"POST\",\n        path: req.url ?? \"/v1/embeddings\",\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n        response: { status, fixture },\n      });\n      writeErrorResponse(res, status, serializeErrorResponse(response), {\n        retryAfter: response.retryAfter,\n      });\n      return;\n    }\n\n    // Embedding response — use the fixture's embedding for each input\n    if (isEmbeddingResponse(response)) {\n      journal.add({\n        method: req.method ?? \"POST\",\n        path: req.url ?? \"/v1/embeddings\",\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n        response: { status: 200, fixture },\n      });\n      const embeddings = inputs.map(() => [...response.embedding]);\n      const body = buildEmbeddingResponse(embeddings, embeddingReq.model);\n      res.writeHead(200, { \"Content-Type\": \"application/json\" });\n      res.end(JSON.stringify(body));\n      return;\n    }\n\n    // Fixture matched but response type is not compatible with embeddings\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\n      headers: flattenHeaders(req.headers),\n      body: syntheticReq,\n      response: { status: 500, fixture },\n    });\n    writeErrorResponse(\n      res,\n      500,\n      JSON.stringify({\n        error: {\n          message:\n            \"Fixture response did not match any known embedding type (must have embedding or error)\",\n          type: \"server_error\",\n        },\n      }),\n    );\n    return;\n  }\n\n  // No fixture match — check strict mode first, then try proxy\n  if (resolveStrictMode(defaults.strict, req.headers)) {\n    const strictMessage = strictNoMatchMessage(skippedBySequenceOrTurn);\n    logger.error(\n      strictNoMatchLogLine(\n        req.method ?? \"POST\",\n        req.url ?? \"/v1/embeddings\",\n        skippedBySequenceOrTurn,\n      ),\n    );\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\n      headers: flattenHeaders(req.headers),\n      body: syntheticReq,\n      response: {\n        status: 503,\n        fixture: null,\n        ...strictOverrideField(defaults.strict, req.headers),\n      },\n    });\n    writeErrorResponse(\n      res,\n      503,\n      JSON.stringify({\n        error: {\n          message: strictMessage,\n          type: \"invalid_request_error\",\n          code: \"no_fixture_match\",\n        },\n      }),\n    );\n    return;\n  }\n\n  if (defaults.record) {\n    const outcome = await proxyAndRecord(\n      req,\n      res,\n      syntheticReq,\n      providerKey,\n      req.url ?? \"/v1/embeddings\",\n      fixtures,\n      defaults,\n      raw,\n    );\n    if (outcome === \"handled_by_hook\") return;\n    if (outcome !== \"not_configured\") {\n      journal.add({\n        method: req.method ?? \"POST\",\n        path: req.url ?? \"/v1/embeddings\",\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n        response: { status: res.statusCode ?? 200, fixture: null, source: \"proxy\" },\n      });\n      return;\n    }\n  }\n\n  // No fixture match — generate deterministic embeddings from input text\n  logger.warn(\n    `No embedding fixture matched for \"${combinedInput.slice(0, 80)}\" — returning deterministic fallback`,\n  );\n  // Validate dimensions here, on the only path that reads it: a bad value\n  // either throws RangeError in `new Array()` below or, past the serialization\n  // budget MAX_EMBEDDING_DIMENSIONS encodes, kills the process outright. The\n  // fixture-replay, chaos, strict and record/proxy branches above never touch\n  // it, so they must not be gated.\n  const dimensions = validateEmbeddingDimensions(embeddingReq.dimensions);\n  if (dimensions === null) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\n      headers: flattenHeaders(req.headers),\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      JSON.stringify({\n        error: {\n          message: `Invalid parameter: 'dimensions' must be an integer between 1 and ${MAX_EMBEDDING_DIMENSIONS}`,\n          type: \"invalid_request_error\",\n          param: null,\n          code: null,\n        },\n      }),\n    );\n    return;\n  }\n\n  const embeddings = inputs.map((input) => generateDeterministicEmbedding(input, dimensions));\n\n  journal.add({\n    method: req.method ?? \"POST\",\n    path: req.url ?? \"/v1/embeddings\",\n    headers: flattenHeaders(req.headers),\n    body: syntheticReq,\n    response: { status: 200, fixture: null },\n  });\n\n  const body = buildEmbeddingResponse(embeddings, embeddingReq.model);\n  res.writeHead(200, { \"Content-Type\": \"application/json\" });\n  res.end(JSON.stringify(body));\n}\n"],"mappings":"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"}

package/dist/embeddings.d.cts

@@ -4,7 +4,7 @@ import * as http$1 from "node:http";
 
 //#region src/embeddings.d.ts
 
-declare function handleEmbeddings(req: http$1.IncomingMessage, res: http$1.ServerResponse, raw: string, fixtures: Fixture[], journal: Journal, defaults: HandlerDefaults, setCorsHeaders: (res: http$1.ServerResponse) => void, providerKey?: RecordProviderKey): Promise<void>;
+declare function handleEmbeddings(req: http$1.IncomingMessage, res: http$1.ServerResponse, raw: string, fixtures: Fixture[], journal: Journal, defaults: HandlerDefaults, setCorsHeaders: (res: http$1.ServerResponse) => void, providerKey?: RecordProviderKey, requireModel?: boolean): Promise<void>;
 //# sourceMappingURL=embeddings.d.ts.map
 
 //#endregion

package/dist/embeddings.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"embeddings.d.cts","names":[],"sources":["../src/embeddings.ts"],"sourcesContent":[],"mappings":";;;;;;AA2DW,iBALW,gBAAA,CAKX,GAAA,EAJJ,MAAA,CAAK,eAID,EAAA,GAAA,EAHJ,MAAA,CAAK,cAGD,EAAA,GAAA,EAAA,MAAA,EAAA,QAAA,EADC,OACD,EAAA,EAAA,OAAA,EAAA,OAAA,EAAA,QAAA,EACC,eADD,EAAA,cAAA,EAAA,CAAA,GAAA,EAEa,MAAA,CAAK,cAFlB,EAAA,GAAA,IAAA,EAAA,WAAA,CAAA,EAGI,iBAHJ,CAAA,EAIR,OAJQ,CAAA,IAAA,CAAA"}
+{"version":3,"file":"embeddings.d.cts","names":[],"sources":["../src/embeddings.ts"],"sourcesContent":[],"mappings":";;;;;;AA4DW,iBALW,gBAAA,CAKX,GAAA,EAJJ,MAAA,CAAK,eAID,EAAA,GAAA,EAHJ,MAAA,CAAK,cAGD,EAAA,GAAA,EAAA,MAAA,EAAA,QAAA,EADC,OACD,EAAA,EAAA,OAAA,EAAA,OAAA,EAAA,QAAA,EACC,eADD,EAAA,cAAA,EAAA,CAAA,GAAA,EAEa,MAAA,CAAK,cAFlB,EAAA,GAAA,IAAA,EAAA,WAAA,CAAA,EAGI,iBAHJ,EAAA,YAAA,CAAA,EAAA,OAAA,CAAA,EAMR,OANQ,CAAA,IAAA,CAAA"}

package/dist/embeddings.d.ts

@@ -4,7 +4,7 @@ import * as http$1 from "node:http";
 
 //#region src/embeddings.d.ts
 
-declare function handleEmbeddings(req: http$1.IncomingMessage, res: http$1.ServerResponse, raw: string, fixtures: Fixture[], journal: Journal, defaults: HandlerDefaults, setCorsHeaders: (res: http$1.ServerResponse) => void, providerKey?: RecordProviderKey): Promise<void>;
+declare function handleEmbeddings(req: http$1.IncomingMessage, res: http$1.ServerResponse, raw: string, fixtures: Fixture[], journal: Journal, defaults: HandlerDefaults, setCorsHeaders: (res: http$1.ServerResponse) => void, providerKey?: RecordProviderKey, requireModel?: boolean): Promise<void>;
 //# sourceMappingURL=embeddings.d.ts.map
 
 //#endregion

package/dist/embeddings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"embeddings.d.ts","names":[],"sources":["../src/embeddings.ts"],"sourcesContent":[],"mappings":";;;;;;AA2DW,iBALW,gBAAA,CAKX,GAAA,EAJJ,MAAA,CAAK,eAID,EAAA,GAAA,EAHJ,MAAA,CAAK,cAGD,EAAA,GAAA,EAAA,MAAA,EAAA,QAAA,EADC,OACD,EAAA,EAAA,OAAA,EAAA,OAAA,EAAA,QAAA,EACC,eADD,EAAA,cAAA,EAAA,CAAA,GAAA,EAEa,MAAA,CAAK,cAFlB,EAAA,GAAA,IAAA,EAAA,WAAA,CAAA,EAGI,iBAHJ,CAAA,EAIR,OAJQ,CAAA,IAAA,CAAA"}
+{"version":3,"file":"embeddings.d.ts","names":[],"sources":["../src/embeddings.ts"],"sourcesContent":[],"mappings":";;;;;;AA4DW,iBALW,gBAAA,CAKX,GAAA,EAJJ,MAAA,CAAK,eAID,EAAA,GAAA,EAHJ,MAAA,CAAK,cAGD,EAAA,GAAA,EAAA,MAAA,EAAA,QAAA,EADC,OACD,EAAA,EAAA,OAAA,EAAA,OAAA,EAAA,QAAA,EACC,eADD,EAAA,cAAA,EAAA,CAAA,GAAA,EAEa,MAAA,CAAK,cAFlB,EAAA,GAAA,IAAA,EAAA,WAAA,CAAA,EAGI,iBAHJ,EAAA,YAAA,CAAA,EAAA,OAAA,CAAA,EAMR,OANQ,CAAA,IAAA,CAAA"}

package/dist/embeddings.js

@@ -1,11 +1,12 @@
 import { MAX_EMBEDDING_DIMENSIONS, buildEmbeddingResponse, flattenHeaders, generateDeterministicEmbedding, getContext, getTestId, isEmbeddingResponse, isErrorResponse, isJsonObject, normalizeEmbeddingInput, resolveResponse, resolveStrictMode, serializeErrorResponse, strictNoMatchLogLine, strictNoMatchMessage, strictOverrideField, validateEmbeddingDimensions } from "./helpers.js";
-import { matchFixtureDiagnostic } from "./router.js";
 import { writeErrorResponse } from "./sse-writer.js";
-import { applyChaos } from "./chaos.js";
+import { applyChaosAsync } from "./chaos.js";
+import { releaseOneShotError } from "./fixture-loader.js";
+import { selectFixtureForServing } from "./router.js";
 import { proxyAndRecord } from "./recorder.js";
 
 //#region src/embeddings.ts
-async function handleEmbeddings(req, res, raw, fixtures, journal, defaults, setCorsHeaders, providerKey = "openai") {
+async function handleEmbeddings(req, res, raw, fixtures, journal, defaults, setCorsHeaders, providerKey = "openai", requireModel = false) {
 	const { logger } = defaults;
 	setCorsHeaders(res);
 	let embeddingReq;
@@ -64,6 +65,23 @@ async function handleEmbeddings(req, res, raw, fixtures, journal, defaults, setC
 		} }));
 		return;
 	}
+	if (requireModel && embeddingReq.model === void 0) {
+		journal.add({
+			method: req.method ?? "POST",
+			path: req.url ?? "/v1/embeddings",
+			headers: flattenHeaders(req.headers),
+			body: null,
+			response: {
+				status: 400,
+				fixture: null
+			}
+		});
+		writeErrorResponse(res, 400, JSON.stringify({ error: {
+			message: "Missing required parameter: 'model'",
+			type: "invalid_request_error"
+		} }));
+		return;
+	}
 	const inputs = normalizeEmbeddingInput(embeddingReq.input);
 	if (inputs === null) {
 		journal.add({
@@ -93,17 +111,20 @@ async function handleEmbeddings(req, res, raw, fixtures, journal, defaults, setC
 		_context: getContext(req)
 	};
 	const testId = getTestId(req);
-	const { fixture, skippedBySequenceOrTurn } = matchFixtureDiagnostic(fixtures, syntheticReq, journal.getFixtureMatchCountsForTest(testId), defaults.requestTransform);
+	const { fixture, skippedBySequenceOrTurn } = selectFixtureForServing(fixtures, syntheticReq, journal.getFixtureMatchCountsForTest(testId), defaults.requestTransform);
 	if (fixture) {
 		journal.incrementFixtureMatchCount(fixture, fixtures, testId);
 		logger.debug(`Fixture matched: ${JSON.stringify(fixture.match).slice(0, 120)}`);
 	} else logger.debug(`No fixture matched for request`);
-	if (applyChaos(res, fixture, defaults.chaos, req.headers, req.url, journal, {
+	if (await applyChaosAsync(res, fixture, defaults.chaos, req.headers, req.url, journal, {
 		method: req.method ?? "POST",
 		path: req.url ?? "/v1/embeddings",
 		headers: flattenHeaders(req.headers),
 		body: syntheticReq
-	}, fixture ? "fixture" : "proxy", defaults.registry, defaults.logger)) return;
+	}, fixture ? "fixture" : "proxy", defaults.registry, defaults.logger)) {
+		releaseOneShotError(fixtures, fixture);
+		return;
+	}
 	if (fixture) {
 		const response = await resolveResponse(fixture, syntheticReq);
 		if (isErrorResponse(response)) {

package/dist/embeddings.js.map

@@ -1 +1 @@
-{"version":3,"file":"embeddings.js","names":[],"sources":["../src/embeddings.ts"],"sourcesContent":["/**\n * OpenAI Embeddings API support for aimock.\n *\n * Handles POST /v1/embeddings requests. Matches fixtures using the `inputText`\n * field, and falls back to generating a deterministic embedding from the input\n * text hash when no fixture matches.\n */\n\nimport type * as http from \"node:http\";\nimport type {\n  ChatCompletionRequest,\n  Fixture,\n  HandlerDefaults,\n  RecordProviderKey,\n} from \"./types.js\";\nimport {\n  isEmbeddingResponse,\n  isErrorResponse,\n  serializeErrorResponse,\n  generateDeterministicEmbedding,\n  buildEmbeddingResponse,\n  flattenHeaders,\n  getTestId,\n  resolveResponse,\n  resolveStrictMode,\n  strictOverrideField,\n  getContext,\n  strictNoMatchMessage,\n  strictNoMatchLogLine,\n  validateEmbeddingDimensions,\n  isJsonObject,\n  normalizeEmbeddingInput,\n  MAX_EMBEDDING_DIMENSIONS,\n} from \"./helpers.js\";\nimport { matchFixtureDiagnostic } from \"./router.js\";\nimport { writeErrorResponse } from \"./sse-writer.js\";\nimport type { Journal } from \"./journal.js\";\nimport { applyChaos } from \"./chaos.js\";\nimport { proxyAndRecord } from \"./recorder.js\";\n\n// ─── Embeddings API request types ──────────────────────────────────────────\n\ninterface EmbeddingRequest {\n  // Validated at runtime — these arrive as arbitrary JSON, so the declared\n  // type must not claim a shape the parser cannot guarantee.\n  input: unknown;\n  model: string;\n  encoding_format?: \"float\" | \"base64\";\n  dimensions?: unknown;\n  [key: string]: unknown;\n}\n\n// ─── Request handler ───────────────────────────────────────────────────────\n\nexport async function handleEmbeddings(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  raw: string,\n  fixtures: Fixture[],\n  journal: Journal,\n  defaults: HandlerDefaults,\n  setCorsHeaders: (res: http.ServerResponse) => void,\n  providerKey: RecordProviderKey = \"openai\",\n): Promise<void> {\n  const { logger } = defaults;\n  setCorsHeaders(res);\n\n  let embeddingReq: EmbeddingRequest;\n  try {\n    embeddingReq = JSON.parse(raw) as EmbeddingRequest;\n  } catch (parseErr) {\n    const detail = parseErr instanceof Error ? parseErr.message : \"unknown\";\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\n      headers: flattenHeaders(req.headers),\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      JSON.stringify({\n        error: {\n          message: `Malformed JSON body: ${detail}`,\n          type: \"invalid_request_error\",\n          code: \"invalid_json\",\n        },\n      }),\n    );\n    return;\n  }\n\n  // Reject bodies that parsed but are not a JSON object (e.g. `null`) before\n  // touching fields — otherwise `embeddingReq.input` throws a TypeError that\n  // surfaces as a 500 instead of a 400.\n  if (!isJsonObject(embeddingReq)) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\n      headers: flattenHeaders(req.headers),\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      JSON.stringify({\n        error: {\n          message: \"Request body must be a JSON object\",\n          type: \"invalid_request_error\",\n        },\n      }),\n    );\n    return;\n  }\n\n  // Validate required input parameter\n  if (embeddingReq.input === undefined || embeddingReq.input === null) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\n      headers: flattenHeaders(req.headers),\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      JSON.stringify({\n        error: {\n          message: \"Missing required parameter: 'input'\",\n          type: \"invalid_request_error\",\n        },\n      }),\n    );\n    return;\n  }\n\n  // Normalize input to array of strings — reject non-string inputs with 400\n  // instead of crashing downstream in createHash().update() (500).\n  const inputs = normalizeEmbeddingInput(embeddingReq.input);\n  if (inputs === null) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\n      headers: flattenHeaders(req.headers),\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      JSON.stringify({\n        error: {\n          message:\n            \"Invalid parameter: 'input' must be a string, an array of strings, or an array of tokens\",\n          type: \"invalid_request_error\",\n          param: null,\n          code: null,\n        },\n      }),\n    );\n    return;\n  }\n\n  // Concatenate all inputs for matching purposes\n  const combinedInput = inputs.join(\" \");\n\n  // Build a synthetic ChatCompletionRequest for the fixture router.\n  // We attach `embeddingInput` so the router's inputText matching can use it.\n  const syntheticReq: ChatCompletionRequest = {\n    model: embeddingReq.model,\n    messages: [],\n    embeddingInput: combinedInput,\n    _endpointType: \"embedding\",\n    _context: getContext(req),\n  };\n\n  const testId = getTestId(req);\n  const { fixture, skippedBySequenceOrTurn } = matchFixtureDiagnostic(\n    fixtures,\n    syntheticReq,\n    journal.getFixtureMatchCountsForTest(testId),\n    defaults.requestTransform,\n  );\n\n  if (fixture) {\n    journal.incrementFixtureMatchCount(fixture, fixtures, testId);\n    logger.debug(`Fixture matched: ${JSON.stringify(fixture.match).slice(0, 120)}`);\n  } else {\n    logger.debug(`No fixture matched for request`);\n  }\n\n  if (\n    applyChaos(\n      res,\n      fixture,\n      defaults.chaos,\n      req.headers,\n      req.url,\n      journal,\n      {\n        method: req.method ?? \"POST\",\n        path: req.url ?? \"/v1/embeddings\",\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n      },\n      fixture ? \"fixture\" : \"proxy\",\n      defaults.registry,\n      defaults.logger,\n    )\n  )\n    return;\n\n  if (fixture) {\n    const response = await resolveResponse(fixture, syntheticReq);\n\n    // Error response\n    if (isErrorResponse(response)) {\n      const status = response.status ?? 500;\n      journal.add({\n        method: req.method ?? \"POST\",\n        path: req.url ?? \"/v1/embeddings\",\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n        response: { status, fixture },\n      });\n      writeErrorResponse(res, status, serializeErrorResponse(response), {\n        retryAfter: response.retryAfter,\n      });\n      return;\n    }\n\n    // Embedding response — use the fixture's embedding for each input\n    if (isEmbeddingResponse(response)) {\n      journal.add({\n        method: req.method ?? \"POST\",\n        path: req.url ?? \"/v1/embeddings\",\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n        response: { status: 200, fixture },\n      });\n      const embeddings = inputs.map(() => [...response.embedding]);\n      const body = buildEmbeddingResponse(embeddings, embeddingReq.model);\n      res.writeHead(200, { \"Content-Type\": \"application/json\" });\n      res.end(JSON.stringify(body));\n      return;\n    }\n\n    // Fixture matched but response type is not compatible with embeddings\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\n      headers: flattenHeaders(req.headers),\n      body: syntheticReq,\n      response: { status: 500, fixture },\n    });\n    writeErrorResponse(\n      res,\n      500,\n      JSON.stringify({\n        error: {\n          message:\n            \"Fixture response did not match any known embedding type (must have embedding or error)\",\n          type: \"server_error\",\n        },\n      }),\n    );\n    return;\n  }\n\n  // No fixture match — check strict mode first, then try proxy\n  if (resolveStrictMode(defaults.strict, req.headers)) {\n    const strictMessage = strictNoMatchMessage(skippedBySequenceOrTurn);\n    logger.error(\n      strictNoMatchLogLine(\n        req.method ?? \"POST\",\n        req.url ?? \"/v1/embeddings\",\n        skippedBySequenceOrTurn,\n      ),\n    );\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\n      headers: flattenHeaders(req.headers),\n      body: syntheticReq,\n      response: {\n        status: 503,\n        fixture: null,\n        ...strictOverrideField(defaults.strict, req.headers),\n      },\n    });\n    writeErrorResponse(\n      res,\n      503,\n      JSON.stringify({\n        error: {\n          message: strictMessage,\n          type: \"invalid_request_error\",\n          code: \"no_fixture_match\",\n        },\n      }),\n    );\n    return;\n  }\n\n  if (defaults.record) {\n    const outcome = await proxyAndRecord(\n      req,\n      res,\n      syntheticReq,\n      providerKey,\n      req.url ?? \"/v1/embeddings\",\n      fixtures,\n      defaults,\n      raw,\n    );\n    if (outcome === \"handled_by_hook\") return;\n    if (outcome !== \"not_configured\") {\n      journal.add({\n        method: req.method ?? \"POST\",\n        path: req.url ?? \"/v1/embeddings\",\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n        response: { status: res.statusCode ?? 200, fixture: null, source: \"proxy\" },\n      });\n      return;\n    }\n  }\n\n  // No fixture match — generate deterministic embeddings from input text\n  logger.warn(\n    `No embedding fixture matched for \"${combinedInput.slice(0, 80)}\" — returning deterministic fallback`,\n  );\n  // Validate dimensions here, on the only path that reads it: a bad value\n  // either throws RangeError in `new Array()` below or, past the serialization\n  // budget MAX_EMBEDDING_DIMENSIONS encodes, kills the process outright. The\n  // fixture-replay, chaos, strict and record/proxy branches above never touch\n  // it, so they must not be gated.\n  const dimensions = validateEmbeddingDimensions(embeddingReq.dimensions);\n  if (dimensions === null) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\n      headers: flattenHeaders(req.headers),\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      JSON.stringify({\n        error: {\n          message: `Invalid parameter: 'dimensions' must be an integer between 1 and ${MAX_EMBEDDING_DIMENSIONS}`,\n          type: \"invalid_request_error\",\n          param: null,\n          code: null,\n        },\n      }),\n    );\n    return;\n  }\n\n  const embeddings = inputs.map((input) => generateDeterministicEmbedding(input, dimensions));\n\n  journal.add({\n    method: req.method ?? \"POST\",\n    path: req.url ?? \"/v1/embeddings\",\n    headers: flattenHeaders(req.headers),\n    body: syntheticReq,\n    response: { status: 200, fixture: null },\n  });\n\n  const body = buildEmbeddingResponse(embeddings, embeddingReq.model);\n  res.writeHead(200, { \"Content-Type\": \"application/json\" });\n  res.end(JSON.stringify(body));\n}\n"],"mappings":"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"}
+{"version":3,"file":"embeddings.js","names":[],"sources":["../src/embeddings.ts"],"sourcesContent":["/**\n * OpenAI Embeddings API support for aimock.\n *\n * Handles POST /v1/embeddings requests. Matches fixtures using the `inputText`\n * field, and falls back to generating a deterministic embedding from the input\n * text hash when no fixture matches.\n */\n\nimport type * as http from \"node:http\";\nimport type {\n  ChatCompletionRequest,\n  Fixture,\n  HandlerDefaults,\n  RecordProviderKey,\n} from \"./types.js\";\nimport {\n  isEmbeddingResponse,\n  isErrorResponse,\n  serializeErrorResponse,\n  generateDeterministicEmbedding,\n  buildEmbeddingResponse,\n  flattenHeaders,\n  getTestId,\n  resolveResponse,\n  resolveStrictMode,\n  strictOverrideField,\n  getContext,\n  strictNoMatchMessage,\n  strictNoMatchLogLine,\n  validateEmbeddingDimensions,\n  isJsonObject,\n  normalizeEmbeddingInput,\n  MAX_EMBEDDING_DIMENSIONS,\n} from \"./helpers.js\";\nimport { releaseOneShotError } from \"./fixture-loader.js\";\nimport { selectFixtureForServing } from \"./router.js\";\nimport { writeErrorResponse } from \"./sse-writer.js\";\nimport type { Journal } from \"./journal.js\";\nimport { applyChaosAsync } from \"./chaos.js\";\nimport { proxyAndRecord } from \"./recorder.js\";\n\n// ─── Embeddings API request types ──────────────────────────────────────────\n\ninterface EmbeddingRequest {\n  // Validated at runtime — these arrive as arbitrary JSON, so the declared\n  // type must not claim a shape the parser cannot guarantee.\n  input: unknown;\n  model: string;\n  encoding_format?: \"float\" | \"base64\";\n  dimensions?: unknown;\n  [key: string]: unknown;\n}\n\n// ─── Request handler ───────────────────────────────────────────────────────\n\nexport async function handleEmbeddings(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  raw: string,\n  fixtures: Fixture[],\n  journal: Journal,\n  defaults: HandlerDefaults,\n  setCorsHeaders: (res: http.ServerResponse) => void,\n  providerKey: RecordProviderKey = \"openai\",\n  // Native HTTP dispatch opts in; direct callers and compatible routes retain defaults.\n  requireModel = false,\n): Promise<void> {\n  const { logger } = defaults;\n  setCorsHeaders(res);\n\n  let embeddingReq: EmbeddingRequest;\n  try {\n    embeddingReq = JSON.parse(raw) as EmbeddingRequest;\n  } catch (parseErr) {\n    const detail = parseErr instanceof Error ? parseErr.message : \"unknown\";\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\n      headers: flattenHeaders(req.headers),\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      JSON.stringify({\n        error: {\n          message: `Malformed JSON body: ${detail}`,\n          type: \"invalid_request_error\",\n          code: \"invalid_json\",\n        },\n      }),\n    );\n    return;\n  }\n\n  // Reject bodies that parsed but are not a JSON object (e.g. `null`) before\n  // touching fields — otherwise `embeddingReq.input` throws a TypeError that\n  // surfaces as a 500 instead of a 400.\n  if (!isJsonObject(embeddingReq)) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\n      headers: flattenHeaders(req.headers),\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      JSON.stringify({\n        error: {\n          message: \"Request body must be a JSON object\",\n          type: \"invalid_request_error\",\n        },\n      }),\n    );\n    return;\n  }\n\n  // Validate required input parameter\n  if (embeddingReq.input === undefined || embeddingReq.input === null) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\n      headers: flattenHeaders(req.headers),\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      JSON.stringify({\n        error: {\n          message: \"Missing required parameter: 'input'\",\n          type: \"invalid_request_error\",\n        },\n      }),\n    );\n    return;\n  }\n\n  if (requireModel && embeddingReq.model === undefined) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\n      headers: flattenHeaders(req.headers),\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      JSON.stringify({\n        error: {\n          message: \"Missing required parameter: 'model'\",\n          type: \"invalid_request_error\",\n        },\n      }),\n    );\n    return;\n  }\n\n  // Normalize input to array of strings — reject non-string inputs with 400\n  // instead of crashing downstream in createHash().update() (500).\n  const inputs = normalizeEmbeddingInput(embeddingReq.input);\n  if (inputs === null) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\n      headers: flattenHeaders(req.headers),\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      JSON.stringify({\n        error: {\n          message:\n            \"Invalid parameter: 'input' must be a string, an array of strings, or an array of tokens\",\n          type: \"invalid_request_error\",\n          param: null,\n          code: null,\n        },\n      }),\n    );\n    return;\n  }\n\n  // Concatenate all inputs for matching purposes\n  const combinedInput = inputs.join(\" \");\n\n  // Build a synthetic ChatCompletionRequest for the fixture router.\n  // We attach `embeddingInput` so the router's inputText matching can use it.\n  const syntheticReq: ChatCompletionRequest = {\n    model: embeddingReq.model,\n    messages: [],\n    embeddingInput: combinedInput,\n    _endpointType: \"embedding\",\n    _context: getContext(req),\n  };\n\n  const testId = getTestId(req);\n  const { fixture, skippedBySequenceOrTurn } = selectFixtureForServing(\n    fixtures,\n    syntheticReq,\n    journal.getFixtureMatchCountsForTest(testId),\n    defaults.requestTransform,\n  );\n\n  if (fixture) {\n    journal.incrementFixtureMatchCount(fixture, fixtures, testId);\n    logger.debug(`Fixture matched: ${JSON.stringify(fixture.match).slice(0, 120)}`);\n  } else {\n    logger.debug(`No fixture matched for request`);\n  }\n\n  if (\n    await applyChaosAsync(\n      res,\n      fixture,\n      defaults.chaos,\n      req.headers,\n      req.url,\n      journal,\n      {\n        method: req.method ?? \"POST\",\n        path: req.url ?? \"/v1/embeddings\",\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n      },\n      fixture ? \"fixture\" : \"proxy\",\n      defaults.registry,\n      defaults.logger,\n    )\n  ) {\n    releaseOneShotError(fixtures, fixture);\n    return;\n  }\n\n  if (fixture) {\n    const response = await resolveResponse(fixture, syntheticReq);\n\n    // Error response\n    if (isErrorResponse(response)) {\n      const status = response.status ?? 500;\n      journal.add({\n        method: req.method ?? \"POST\",\n        path: req.url ?? \"/v1/embeddings\",\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n        response: { status, fixture },\n      });\n      writeErrorResponse(res, status, serializeErrorResponse(response), {\n        retryAfter: response.retryAfter,\n      });\n      return;\n    }\n\n    // Embedding response — use the fixture's embedding for each input\n    if (isEmbeddingResponse(response)) {\n      journal.add({\n        method: req.method ?? \"POST\",\n        path: req.url ?? \"/v1/embeddings\",\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n        response: { status: 200, fixture },\n      });\n      const embeddings = inputs.map(() => [...response.embedding]);\n      const body = buildEmbeddingResponse(embeddings, embeddingReq.model);\n      res.writeHead(200, { \"Content-Type\": \"application/json\" });\n      res.end(JSON.stringify(body));\n      return;\n    }\n\n    // Fixture matched but response type is not compatible with embeddings\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\n      headers: flattenHeaders(req.headers),\n      body: syntheticReq,\n      response: { status: 500, fixture },\n    });\n    writeErrorResponse(\n      res,\n      500,\n      JSON.stringify({\n        error: {\n          message:\n            \"Fixture response did not match any known embedding type (must have embedding or error)\",\n          type: \"server_error\",\n        },\n      }),\n    );\n    return;\n  }\n\n  // No fixture match — check strict mode first, then try proxy\n  if (resolveStrictMode(defaults.strict, req.headers)) {\n    const strictMessage = strictNoMatchMessage(skippedBySequenceOrTurn);\n    logger.error(\n      strictNoMatchLogLine(\n        req.method ?? \"POST\",\n        req.url ?? \"/v1/embeddings\",\n        skippedBySequenceOrTurn,\n      ),\n    );\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\n      headers: flattenHeaders(req.headers),\n      body: syntheticReq,\n      response: {\n        status: 503,\n        fixture: null,\n        ...strictOverrideField(defaults.strict, req.headers),\n      },\n    });\n    writeErrorResponse(\n      res,\n      503,\n      JSON.stringify({\n        error: {\n          message: strictMessage,\n          type: \"invalid_request_error\",\n          code: \"no_fixture_match\",\n        },\n      }),\n    );\n    return;\n  }\n\n  if (defaults.record) {\n    const outcome = await proxyAndRecord(\n      req,\n      res,\n      syntheticReq,\n      providerKey,\n      req.url ?? \"/v1/embeddings\",\n      fixtures,\n      defaults,\n      raw,\n    );\n    if (outcome === \"handled_by_hook\") return;\n    if (outcome !== \"not_configured\") {\n      journal.add({\n        method: req.method ?? \"POST\",\n        path: req.url ?? \"/v1/embeddings\",\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n        response: { status: res.statusCode ?? 200, fixture: null, source: \"proxy\" },\n      });\n      return;\n    }\n  }\n\n  // No fixture match — generate deterministic embeddings from input text\n  logger.warn(\n    `No embedding fixture matched for \"${combinedInput.slice(0, 80)}\" — returning deterministic fallback`,\n  );\n  // Validate dimensions here, on the only path that reads it: a bad value\n  // either throws RangeError in `new Array()` below or, past the serialization\n  // budget MAX_EMBEDDING_DIMENSIONS encodes, kills the process outright. The\n  // fixture-replay, chaos, strict and record/proxy branches above never touch\n  // it, so they must not be gated.\n  const dimensions = validateEmbeddingDimensions(embeddingReq.dimensions);\n  if (dimensions === null) {\n    journal.add({\n      method: req.method ?? \"POST\",\n      path: req.url ?? \"/v1/embeddings\",\n      headers: flattenHeaders(req.headers),\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      JSON.stringify({\n        error: {\n          message: `Invalid parameter: 'dimensions' must be an integer between 1 and ${MAX_EMBEDDING_DIMENSIONS}`,\n          type: \"invalid_request_error\",\n          param: null,\n          code: null,\n        },\n      }),\n    );\n    return;\n  }\n\n  const embeddings = inputs.map((input) => generateDeterministicEmbedding(input, dimensions));\n\n  journal.add({\n    method: req.method ?? \"POST\",\n    path: req.url ?? \"/v1/embeddings\",\n    headers: flattenHeaders(req.headers),\n    body: syntheticReq,\n    response: { status: 200, fixture: null },\n  });\n\n  const body = buildEmbeddingResponse(embeddings, embeddingReq.model);\n  res.writeHead(200, { \"Content-Type\": \"application/json\" });\n  res.end(JSON.stringify(body));\n}\n"],"mappings":"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"}

package/dist/fal-audio.cjs

@@ -1,9 +1,9 @@
 const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
 const require_api_key_auth = require('./api-key-auth.cjs');
 const require_helpers = require('./helpers.cjs');
-const require_router = require('./router.cjs');
 const require_sse_writer = require('./sse-writer.cjs');
 const require_chaos = require('./chaos.cjs');
+const require_router = require('./router.cjs');
 const require_recorder = require('./recorder.cjs');
 const require_fal = require('./fal.cjs');
 let node_crypto = require("node:crypto");
@@ -200,7 +200,7 @@ async function handleQueueSubmit(req, res, body, pathname, modelId, testId, fixt
 	};
 	const { fixture, skippedBySequenceOrTurn } = require_router.matchFixtureDiagnostic(fixtures, syntheticReq, matchCounts, defaults.requestTransform);
 	if (fixture) journal.incrementFixtureMatchCount(fixture, fixtures, testId);
-	if (require_chaos.applyChaos(res, fixture, defaults.chaos, req.headers, req.url, journal, {
+	if (await require_chaos.applyChaosAsync(res, fixture, defaults.chaos, req.headers, req.url, journal, {
 		method: req.method ?? "POST",
 		path: pathname,
 		headers: require_helpers.flattenHeaders(req.headers),
@@ -659,7 +659,7 @@ async function handleSyncRun(req, res, body, pathname, modelId, fixtures, defaul
 	};
 	const { fixture, skippedBySequenceOrTurn } = require_router.matchFixtureDiagnostic(fixtures, syntheticReq, matchCounts, defaults.requestTransform);
 	if (fixture) journal.incrementFixtureMatchCount(fixture, fixtures, require_helpers.getTestId(req));
-	if (require_chaos.applyChaos(res, fixture, defaults.chaos, req.headers, req.url, journal, {
+	if (await require_chaos.applyChaosAsync(res, fixture, defaults.chaos, req.headers, req.url, journal, {
 		method: req.method ?? "POST",
 		path: pathname,
 		headers: require_helpers.flattenHeaders(req.headers),