@copilotkit/aimock 1.42.1 → 1.43.0

package/dist/llmock.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"llmock.cjs","names":["loadFixtureFile","loadFixturesFromDir","entryToFixture","validateFixtures","normalizeResponse","imageResponseToFalJson","videoResponseToFalJson","isInjectableStatus","INJECTED_STATUS_RANGE","createServerWithResolvedAuth","createServer"],"sources":["../src/llmock.ts"],"sourcesContent":["import type {\n  AudioResponse,\n  ChaosConfig,\n  EmbeddingFixtureOpts,\n  FalQueueOpts,\n  Fixture,\n  FixtureFileEntry,\n  FixtureFileResponse,\n  FixtureMatch,\n  FixtureOpts,\n  FixtureResponse,\n  ImageResponse,\n  MockServerOptions,\n  Mountable,\n  RecordConfig,\n  ResponseFactory,\n  TranscriptionResponse,\n  VideoResponse,\n} from \"./types.js\";\nimport {\n  createServer,\n  createServerWithResolvedAuth,\n  performFullReset,\n  type ServerInstance,\n} from \"./server.js\";\nimport type { ResolvedInboundAuth } from \"./api-key-auth.js\";\nimport {\n  isInjectableStatus,\n  INJECTED_STATUS_RANGE,\n  loadFixtureFile,\n  loadFixturesFromDir,\n  entryToFixture,\n  normalizeResponse,\n  validateFixtures,\n} from \"./fixture-loader.js\";\nimport { Journal } from \"./journal.js\";\nimport type { SearchFixture, SearchResult } from \"./search.js\";\nimport type { RerankFixture, RerankResult } from \"./rerank.js\";\nimport type { ModerationFixture, ModerationResult } from \"./moderation.js\";\nimport { imageResponseToFalJson, videoResponseToFalJson } from \"./fal.js\";\n\nexport class LLMock {\n  private fixtures: Fixture[] = [];\n  private searchFixtures: SearchFixture[] = [];\n  private rerankFixtures: RerankFixture[] = [];\n  private moderationFixtures: ModerationFixture[] = [];\n  private mounts: Array<{ path: string; handler: Mountable }> = [];\n  private serverInstance: ServerInstance | null = null;\n  private options: MockServerOptions;\n  private readonly resolvedInboundAuth?: ResolvedInboundAuth;\n\n  constructor(options?: MockServerOptions, resolvedInboundAuth?: ResolvedInboundAuth) {\n    this.options = options ?? {};\n    this.resolvedInboundAuth = resolvedInboundAuth;\n  }\n\n  // ---- Fixture management ----\n\n  addFixture(fixture: Fixture): this {\n    this.fixtures.push(fixture);\n    return this;\n  }\n\n  addFixtures(fixtures: Fixture[]): this {\n    this.fixtures.push(...fixtures);\n    return this;\n  }\n\n  prependFixture(fixture: Fixture): this {\n    this.fixtures.unshift(fixture);\n    return this;\n  }\n\n  getFixtures(): readonly Fixture[] {\n    return this.fixtures;\n  }\n\n  loadFixtureFile(filePath: string): this {\n    this.fixtures.push(...loadFixtureFile(filePath));\n    return this;\n  }\n\n  loadFixtureDir(dirPath: string): this {\n    this.fixtures.push(...loadFixturesFromDir(dirPath));\n    return this;\n  }\n\n  /**\n   * Add fixtures from a JSON string or pre-parsed array of fixture entries.\n   * Validates all fixtures and throws if any have severity \"error\".\n   */\n  addFixturesFromJSON(input: string | FixtureFileEntry[]): this {\n    let entries: FixtureFileEntry[];\n    if (typeof input === \"string\") {\n      try {\n        entries = JSON.parse(input);\n      } catch (err) {\n        throw new Error(\n          `addFixturesFromJSON: invalid JSON — ${err instanceof Error ? err.message : String(err)}`,\n        );\n      }\n    } else {\n      entries = input;\n    }\n    const converted = entries.map((e) => entryToFixture(e));\n    const issues = validateFixtures(converted);\n    const errors = issues.filter((i) => i.severity === \"error\");\n    if (errors.length > 0) {\n      throw new Error(`Fixture validation failed: ${JSON.stringify(errors)}`);\n    }\n    this.fixtures.push(...converted);\n    return this;\n  }\n\n  // Uses length = 0 to preserve array reference identity — the running\n  // server reads this same array on every request.\n  clearFixtures(): this {\n    this.fixtures.length = 0;\n    return this;\n  }\n\n  // ---- Convenience ----\n\n  on(\n    match: FixtureMatch,\n    response: FixtureFileResponse | ResponseFactory,\n    opts?: FixtureOpts,\n  ): this {\n    return this.addFixture({\n      match,\n      response: typeof response === \"function\" ? response : normalizeResponse(response),\n      ...opts,\n    });\n  }\n\n  onMessage(\n    pattern: string | RegExp,\n    response: FixtureFileResponse | ResponseFactory,\n    opts?: FixtureOpts,\n  ): this {\n    return this.on({ userMessage: pattern }, response, opts);\n  }\n\n  onEmbedding(\n    pattern: string | RegExp,\n    response: FixtureFileResponse | ResponseFactory,\n    opts?: EmbeddingFixtureOpts,\n  ): this {\n    return this.on({ inputText: pattern }, response, opts);\n  }\n\n  onJsonOutput(pattern: string | RegExp, jsonContent: object | string, opts?: FixtureOpts): this {\n    const content = typeof jsonContent === \"string\" ? jsonContent : JSON.stringify(jsonContent);\n    return this.on({ userMessage: pattern, responseFormat: \"json_object\" }, { content }, opts);\n  }\n\n  onToolCall(\n    name: string,\n    response: FixtureFileResponse | ResponseFactory,\n    opts?: FixtureOpts,\n  ): this {\n    return this.on({ toolName: name }, response, opts);\n  }\n\n  onToolResult(\n    id: string,\n    response: FixtureFileResponse | ResponseFactory,\n    opts?: FixtureOpts,\n  ): this {\n    return this.on({ toolCallId: id }, response, opts);\n  }\n\n  onTurn(\n    turn: number,\n    pattern: string | RegExp,\n    response: FixtureFileResponse | ResponseFactory,\n    opts?: FixtureOpts,\n  ): this {\n    return this.on({ userMessage: pattern, turnIndex: turn }, response, opts);\n  }\n\n  onImage(prompt: string | RegExp, response: ImageResponse): this {\n    return this.addFixture({\n      match: { userMessage: prompt, endpoint: \"image\" },\n      response,\n    });\n  }\n\n  onSpeech(input: string | RegExp, response: AudioResponse): this {\n    return this.addFixture({\n      match: { userMessage: input, endpoint: \"speech\" },\n      response,\n    });\n  }\n\n  onTranscription(response: TranscriptionResponse): this {\n    return this.addFixture({\n      match: { endpoint: \"transcription\" },\n      response,\n    });\n  }\n\n  onTranslation(response: TranscriptionResponse): this {\n    return this.addFixture({\n      match: { endpoint: \"translation\" },\n      response,\n    });\n  }\n\n  onVideo(prompt: string | RegExp, response: VideoResponse): this {\n    return this.addFixture({\n      match: { userMessage: prompt, endpoint: \"video\" },\n      response,\n    });\n  }\n\n  onAudio(input: string | RegExp, response: AudioResponse): this {\n    return this.addFixture({ match: { userMessage: input }, response });\n  }\n\n  onSoundEffect(text: string | RegExp, response: AudioResponse): this {\n    return this.addFixture({\n      match: { userMessage: text, endpoint: \"audio-gen\" },\n      response,\n    });\n  }\n\n  onMusic(prompt: string | RegExp, response: AudioResponse): this {\n    return this.addFixture({\n      match: { userMessage: prompt, endpoint: \"audio-gen\" },\n      response,\n    });\n  }\n\n  onElevenLabsTTS(text: string | RegExp, response: AudioResponse): this {\n    return this.addFixture({\n      match: { userMessage: text, endpoint: \"elevenlabs-tts\" },\n      response,\n    });\n  }\n\n  onFalAudio(prompt: string | RegExp, response: AudioResponse, model?: string): this {\n    return this.addFixture({\n      match: { userMessage: prompt, endpoint: \"fal-audio\", ...(model ? { model } : {}) },\n      response,\n    });\n  }\n\n  // fal.queue.* is the dominant client API; onFalRun is a sync alias.\n  //\n  // `opts.billableUnits` rides through to the completed `queue-result`\n  // response's `x-fal-billable-units` header (emitted alongside\n  // `x-fal-request-id`), letting consumers like `@tanstack/ai-fal` surface a\n  // billed-units value on replay. Omit it to preserve the header-less default.\n  onFalQueue(modelOrPrompt: string | RegExp, response: unknown, opts?: FalQueueOpts): this {\n    const { billableUnits, ...fixtureOpts } = opts ?? {};\n    return this.addFixture({\n      match: { model: modelOrPrompt, endpoint: \"fal\" },\n      response: { json: response, ...(billableUnits != null ? { billableUnits } : {}) },\n      ...fixtureOpts,\n    });\n  }\n\n  onFalRun(modelOrPrompt: string | RegExp, response: unknown, opts?: FalQueueOpts): this {\n    return this.onFalQueue(modelOrPrompt, response, opts);\n  }\n\n  /**\n   * Register a fal.ai image fixture. Wraps an `ImageResponse` (the shape used\n   * by `onImage` and OpenAI/Azure image fixtures) into fal's image envelope\n   * before storing it as a `RawJSONResponse`. Defaults `width`/`height` to\n   * 1024 when the fixture's `ImageItem` doesn't carry them.\n   */\n  onFalImage(modelOrPrompt: string | RegExp, response: ImageResponse, opts?: FalQueueOpts): this {\n    return this.onFalQueue(modelOrPrompt, imageResponseToFalJson(response), opts);\n  }\n\n  /**\n   * Register a fal.ai video fixture. Wraps a `VideoResponse` into fal's video\n   * envelope (`{ video: { url, content_type, file_name, file_size }, seed }`)\n   * before storing it as a `RawJSONResponse`.\n   */\n  onFalVideo(modelOrPrompt: string | RegExp, response: VideoResponse, opts?: FalQueueOpts): this {\n    return this.onFalQueue(modelOrPrompt, videoResponseToFalJson(response), opts);\n  }\n\n  // ---- Service mock convenience methods ----\n\n  onSearch(pattern: string | RegExp, results: SearchResult[]): this {\n    this.searchFixtures.push({ match: pattern, results });\n    return this;\n  }\n\n  onRerank(pattern: string | RegExp, results: RerankResult[]): this {\n    this.rerankFixtures.push({ match: pattern, results });\n    return this;\n  }\n\n  onModerate(pattern: string | RegExp, result: ModerationResult): this {\n    this.moderationFixtures.push({ match: pattern, result });\n    return this;\n  }\n\n  /**\n   * Queue a one-shot error that will be returned for the next matching\n   * request, then automatically removed. Implemented as an internal fixture\n   * with a `predicate` that always matches (so it fires first) and spliced\n   * at the front of the fixture list.\n   */\n  nextRequestError(\n    status: number,\n    errorBody?: { message?: string; type?: string; code?: string },\n  ): this {\n    // Same gate as `POST /__aimock/error` and fixture validation — this is the\n    // form the docs use, and an unchecked status reaches `res.writeHead` on\n    // the next matched request: 99/1000 throw there (the injected error is\n    // lost and the caller sees a generic 500), and 1xx hangs the request until\n    // the client times out. Throwing HERE names the offending call instead.\n    if (!isInjectableStatus(status)) {\n      throw new RangeError(\n        `nextRequestError: invalid status ${String(status)} — must be ${INJECTED_STATUS_RANGE}`,\n      );\n    }\n    const errorResponse: FixtureResponse = {\n      error: {\n        message: errorBody?.message ?? \"Injected error\",\n        type: errorBody?.type ?? \"server_error\",\n        code: errorBody?.code,\n      },\n      status,\n    };\n    // An injected error is only a valid response for endpoints that can carry\n    // an error envelope. Mirror the router's endpoint-compat table\n    // (matchFixtureDiagnostic in router.ts): error responses are compatible\n    // with chat / embedding / realtime* / fal and with requests that carry no\n    // endpoint type, but NOT with multimedia endpoints (image, speech, video,\n    // transcription, …). Gating consumption on this prevents an incompatible\n    // request from matching the predicate and splicing — and thereby\n    // destroying — a one-shot error intended for a different endpoint before\n    // the router's own compat check would have skipped it.\n    const errorEndpointCompatible = (req: import(\"./types.js\").ChatCompletionRequest) => {\n      const reqEndpoint = req._endpointType as string | undefined;\n      if (\n        reqEndpoint === undefined ||\n        reqEndpoint === \"chat\" ||\n        reqEndpoint === \"embedding\" ||\n        reqEndpoint.startsWith(\"realtime\") ||\n        reqEndpoint === \"fal\"\n      ) {\n        return true;\n      }\n      return false;\n    };\n    const fixture: Fixture = {\n      match: { predicate: errorEndpointCompatible },\n      response: errorResponse,\n    };\n    // Insert at front so it matches before everything else\n    this.fixtures.unshift(fixture);\n    // Remove after first match — the journal records it so tests can assert.\n    // Only consume (and splice) when the request endpoint is compatible; an\n    // incompatible request returns false here, falls through to other\n    // fixtures, and leaves this error pending for its intended endpoint.\n    const original = fixture.match.predicate!;\n    fixture.match.predicate = (req) => {\n      const result = original(req);\n      if (result) {\n        // Remove synchronously on first match to prevent race conditions\n        const idx = this.fixtures.indexOf(fixture);\n        if (idx !== -1) this.fixtures.splice(idx, 1);\n      }\n      return result;\n    };\n    return this;\n  }\n\n  // ---- Mounts ----\n\n  mount(path: string, handler: Mountable): this {\n    this.mounts.push({ path, handler });\n\n    // If server is already running, wire up journal, registry, and baseUrl immediately\n    // so late mounts behave identically to pre-start mounts.\n    if (this.serverInstance) {\n      if (handler.setJournal) handler.setJournal(this.serverInstance.journal);\n      if (handler.setBaseUrl) handler.setBaseUrl(this.serverInstance.url + path);\n      const registry = this.serverInstance.defaults.registry;\n      if (registry && handler.setRegistry) handler.setRegistry(registry);\n    }\n\n    return this;\n  }\n\n  // ---- Journal proxies ----\n\n  getRequests(): import(\"./types.js\").JournalEntry[] {\n    return this.journal.getAll();\n  }\n\n  getLastRequest(): import(\"./types.js\").JournalEntry | null {\n    return this.journal.getLast();\n  }\n\n  clearRequests(): void {\n    this.journal.clear();\n  }\n\n  resetMatchCounts(testId?: string): this {\n    if (this.serverInstance) {\n      this.serverInstance.journal.clearMatchCounts(testId);\n    }\n    return this;\n  }\n\n  // ---- Chaos ----\n\n  /**\n   * Set the server-wide chaos baseline. Writes through to a RUNNING server as\n   * well as the construction options: an untagged `POST /__aimock/chaos`\n   * installs a baseline override that shadows `options.chaos`, and without this\n   * the call would silently do nothing until the next `reset()`. Per-testId\n   * overrides still win over the baseline.\n   */\n  setChaos(config: ChaosConfig): this {\n    this.options.chaos = config;\n    if (this.serverInstance) this.serverInstance.defaults.chaos = config;\n    return this;\n  }\n\n  /**\n   * Turn chaos off everywhere: the construction config, the runtime baseline,\n   * and every per-testId override (assigning `undefined` is the full-clear\n   * signal the `defaults.chaos` setter defines).\n   */\n  clearChaos(): this {\n    delete this.options.chaos;\n    if (this.serverInstance) this.serverInstance.defaults.chaos = undefined;\n    return this;\n  }\n\n  // ---- Recording ----\n\n  enableRecording(config: RecordConfig): this {\n    this.options.record = config;\n    return this;\n  }\n\n  disableRecording(): this {\n    delete this.options.record;\n    return this;\n  }\n\n  // ---- Reset ----\n\n  /**\n   * Full reset — the in-process equivalent of `POST /__aimock/reset`. Shares\n   * one implementation with the control-API route so the two cannot drift.\n   *\n   * The one deliberate difference: search / rerank / moderation fixtures are\n   * also cleared here. Those are registered through this class only — the\n   * control API has no route that creates them, so the HTTP reset can neither\n   * reach nor observe them.\n   *\n   * NOT ALL OF THIS IS PER-INSTANCE. `performFullReset` clears module-global\n   * state as well: the Gemini interaction and event-id counters\n   * (`resetInteractionCounter` / `resetEventIdCounter` in\n   * `./gemini-interactions.js`) and the fal.ai job/queue maps (`falJobs`,\n   * `falQueueStates`). With two `LLMock` instances live in one process,\n   * `a.reset()` rewinds the Gemini id sequence that `b` is mid-way through —\n   * `b` then re-emits `aimock-int-0` / `evt_1`, ids it has already handed\n   * out — and drops `b`'s in-flight fal jobs. Give each instance its own\n   * process (or its own vitest worker) if that matters.\n   *\n   * The global stores are cleared even before `start()`, when there is no\n   * server instance to reset.\n   */\n  reset(): this {\n    this.searchFixtures.length = 0;\n    this.rerankFixtures.length = 0;\n    this.moderationFixtures.length = 0;\n    performFullReset(this.fixtures, this.serverInstance);\n    return this;\n  }\n\n  // ---- Server lifecycle ----\n\n  async start(): Promise<string> {\n    if (this.serverInstance) {\n      throw new Error(\"Server already started\");\n    }\n    this.serverInstance = await (this.resolvedInboundAuth\n      ? createServerWithResolvedAuth(\n          this.fixtures,\n          this.options,\n          this.resolvedInboundAuth,\n          this.mounts,\n          {\n            search: this.searchFixtures,\n            rerank: this.rerankFixtures,\n            moderation: this.moderationFixtures,\n          },\n        )\n      : createServer(this.fixtures, this.options, this.mounts, {\n          search: this.searchFixtures,\n          rerank: this.rerankFixtures,\n          moderation: this.moderationFixtures,\n        }));\n    return this.serverInstance.url;\n  }\n\n  async stop(): Promise<void> {\n    if (!this.serverInstance) {\n      throw new Error(\"Server not started\");\n    }\n    const { server } = this.serverInstance;\n    await new Promise<void>((resolve, reject) => {\n      server.close((err: Error | undefined) => (err ? reject(err) : resolve()));\n    });\n    this.serverInstance = null;\n  }\n\n  // ---- Accessors ----\n\n  get journal(): Journal {\n    if (!this.serverInstance) {\n      throw new Error(\"Server not started\");\n    }\n    return this.serverInstance.journal;\n  }\n\n  get url(): string {\n    if (!this.serverInstance) {\n      throw new Error(\"Server not started\");\n    }\n    return this.serverInstance.url;\n  }\n\n  get baseUrl(): string {\n    return this.url;\n  }\n\n  get port(): number {\n    const parsed = new URL(this.url); // this.url throws if not started\n    if (!parsed.port) {\n      throw new Error(`Server URL has no explicit port: ${this.url}`);\n    }\n    return parseInt(parsed.port, 10);\n  }\n\n  // ---- Static factory ----\n\n  static async create(options?: MockServerOptions): Promise<LLMock> {\n    const instance = new LLMock(options);\n    await instance.start();\n    return instance;\n  }\n}\n\n/** @internal Configuration startup preserves a policy resolved from the selected source. */\nexport function createLLMockWithResolvedAuth(\n  options: MockServerOptions,\n  resolvedAuth: ResolvedInboundAuth,\n): LLMock {\n  return new LLMock(options, resolvedAuth);\n}\n"],"mappings":"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"}
+{"version":3,"file":"llmock.cjs","names":["isLiveResponse","normalizeLiveFixture","loadFixtureFile","loadFixturesFromDir","entryToFixture","validateFixtures","normalizeResponse","voiceDesignToJson","imageResponseToFalJson","videoResponseToFalJson","isInjectableStatus","INJECTED_STATUS_RANGE","createServerWithResolvedAuth","createServer"],"sources":["../src/llmock.ts"],"sourcesContent":["import type { LiveTranscript } from \"./live-types.js\";\nimport { normalizeLiveFixture, normalizeLiveOptions } from \"./live-fixture.js\";\nimport { isLiveResponse } from \"./helpers.js\";\nimport type {\n  AudioResponse,\n  ChaosConfig,\n  EmbeddingFixtureOpts,\n  FalQueueOpts,\n  Fixture,\n  FixtureFileEntry,\n  FixtureFileResponse,\n  FixtureMatch,\n  FixtureOpts,\n  ImageResponse,\n  MockServerOptions,\n  Mountable,\n  RecordConfig,\n  ResponseFactory,\n  TranscriptionResponse,\n  VideoResponse,\n  VoiceDesignResponse,\n} from \"./types.js\";\nimport {\n  createServer,\n  createServerWithResolvedAuth,\n  performFullReset,\n  type ServerInstance,\n} from \"./server.js\";\nimport type { ResolvedInboundAuth } from \"./api-key-auth.js\";\nimport {\n  isInjectableStatus,\n  INJECTED_STATUS_RANGE,\n  queueOneShotError,\n  clearFixtureQueue,\n  loadFixtureFile,\n  loadFixturesFromDir,\n  entryToFixture,\n  normalizeResponse,\n  validateFixtures,\n} from \"./fixture-loader.js\";\nimport { Journal } from \"./journal.js\";\nimport type { SearchFixture, SearchResult } from \"./search.js\";\nimport type { RerankFixture, RerankResult } from \"./rerank.js\";\nimport type { ModerationFixture, ModerationResult } from \"./moderation.js\";\nimport { imageResponseToFalJson, videoResponseToFalJson } from \"./fal.js\";\nimport { voiceDesignToJson } from \"./elevenlabs-voice.js\";\n\nexport class LLMock {\n  private fixtures: Fixture[] = [];\n  private searchFixtures: SearchFixture[] = [];\n  private rerankFixtures: RerankFixture[] = [];\n  private moderationFixtures: ModerationFixture[] = [];\n  private mounts: Array<{ path: string; handler: Mountable }> = [];\n  private serverInstance: ServerInstance | null = null;\n  private options: MockServerOptions;\n  private readonly resolvedInboundAuth?: ResolvedInboundAuth;\n\n  constructor(options?: MockServerOptions, resolvedInboundAuth?: ResolvedInboundAuth) {\n    this.options = options ?? {};\n    if (this.options.live !== undefined) normalizeLiveOptions(this.options.live);\n    this.resolvedInboundAuth = resolvedInboundAuth;\n  }\n\n  // ---- Fixture management ----\n\n  private normalizeFixture(fixture: Fixture): Fixture {\n    if (\n      isLiveResponse(fixture.response) ||\n      (fixture.match.endpoint === \"openai-live\" && typeof fixture.response !== \"function\")\n    ) {\n      return {\n        ...fixture,\n        match: { ...fixture.match },\n        response: normalizeLiveFixture(fixture.response, this.options.live),\n      };\n    }\n    return fixture;\n  }\n\n  addFixture(fixture: Fixture): this {\n    this.fixtures.push(this.normalizeFixture(fixture));\n    return this;\n  }\n\n  addFixtures(fixtures: Fixture[]): this {\n    this.fixtures.push(...fixtures.map((fixture) => this.normalizeFixture(fixture)));\n    return this;\n  }\n\n  prependFixture(fixture: Fixture): this {\n    this.fixtures.unshift(this.normalizeFixture(fixture));\n    return this;\n  }\n\n  getFixtures(): readonly Fixture[] {\n    return this.fixtures;\n  }\n\n  loadFixtureFile(filePath: string): this {\n    this.fixtures.push(...loadFixtureFile(filePath, undefined, this.options.live));\n    return this;\n  }\n\n  loadFixtureDir(dirPath: string): this {\n    this.fixtures.push(...loadFixturesFromDir(dirPath, undefined, this.options.live));\n    return this;\n  }\n\n  /**\n   * Add fixtures from a JSON string or pre-parsed array of fixture entries.\n   * Validates all fixtures and throws if any have severity \"error\".\n   */\n  addFixturesFromJSON(input: string | FixtureFileEntry[]): this {\n    let entries: FixtureFileEntry[];\n    if (typeof input === \"string\") {\n      try {\n        entries = JSON.parse(input);\n      } catch (err) {\n        throw new Error(\n          `addFixturesFromJSON: invalid JSON — ${err instanceof Error ? err.message : String(err)}`,\n        );\n      }\n    } else {\n      entries = input;\n    }\n    const converted = entries.map((e) => entryToFixture(e, undefined, this.options.live));\n    const issues = validateFixtures(converted, this.options.live);\n    const errors = issues.filter((i) => i.severity === \"error\");\n    if (errors.length > 0) {\n      throw new Error(`Fixture validation failed: ${JSON.stringify(errors)}`);\n    }\n    this.fixtures.push(...converted);\n    return this;\n  }\n\n  // Clears in place to preserve array reference identity — the running\n  // server reads this same array on every request — and invalidates any\n  // one-shot claim parked in flight so it cannot re-arm into the cleared queue.\n  clearFixtures(): this {\n    clearFixtureQueue(this.fixtures);\n    return this;\n  }\n\n  // ---- Convenience ----\n\n  on(\n    match: FixtureMatch,\n    response: FixtureFileResponse | ResponseFactory,\n    opts?: FixtureOpts,\n  ): this {\n    return this.addFixture({\n      match,\n      response:\n        typeof response === \"function\" ? response : normalizeResponse(response, this.options.live),\n      ...opts,\n    });\n  }\n\n  onLive(\n    match: Omit<FixtureMatch, \"endpoint\">,\n    transcript: LiveTranscript,\n    opts?: FixtureOpts,\n  ): this {\n    return this.on({ ...match, endpoint: \"openai-live\" }, { live: transcript }, opts);\n  }\n\n  onMessage(\n    pattern: string | RegExp,\n    response: FixtureFileResponse | ResponseFactory,\n    opts?: FixtureOpts,\n  ): this {\n    return this.on({ userMessage: pattern }, response, opts);\n  }\n\n  onEmbedding(\n    pattern: string | RegExp,\n    response: FixtureFileResponse | ResponseFactory,\n    opts?: EmbeddingFixtureOpts,\n  ): this {\n    return this.on({ inputText: pattern }, response, opts);\n  }\n\n  onJsonOutput(pattern: string | RegExp, jsonContent: object | string, opts?: FixtureOpts): this {\n    const content = typeof jsonContent === \"string\" ? jsonContent : JSON.stringify(jsonContent);\n    return this.on({ userMessage: pattern, responseFormat: \"json_object\" }, { content }, opts);\n  }\n\n  onToolCall(\n    name: string,\n    response: FixtureFileResponse | ResponseFactory,\n    opts?: FixtureOpts,\n  ): this {\n    return this.on({ toolName: name }, response, opts);\n  }\n\n  onToolResult(\n    id: string,\n    response: FixtureFileResponse | ResponseFactory,\n    opts?: FixtureOpts,\n  ): this {\n    return this.on({ toolCallId: id }, response, opts);\n  }\n\n  onTurn(\n    turn: number,\n    pattern: string | RegExp,\n    response: FixtureFileResponse | ResponseFactory,\n    opts?: FixtureOpts,\n  ): this {\n    return this.on({ userMessage: pattern, turnIndex: turn }, response, opts);\n  }\n\n  onImage(prompt: string | RegExp, response: ImageResponse): this {\n    return this.addFixture({\n      match: { userMessage: prompt, endpoint: \"image\" },\n      response,\n    });\n  }\n\n  onSpeech(input: string | RegExp, response: AudioResponse): this {\n    return this.addFixture({\n      match: { userMessage: input, endpoint: \"speech\" },\n      response,\n    });\n  }\n\n  onTranscription(response: TranscriptionResponse): this {\n    return this.addFixture({\n      match: { endpoint: \"transcription\" },\n      response,\n    });\n  }\n\n  onTranslation(response: TranscriptionResponse): this {\n    return this.addFixture({\n      match: { endpoint: \"translation\" },\n      response,\n    });\n  }\n\n  onVideo(prompt: string | RegExp, response: VideoResponse): this {\n    return this.addFixture({\n      match: { userMessage: prompt, endpoint: \"video\" },\n      response,\n    });\n  }\n\n  onAudio(input: string | RegExp, response: AudioResponse): this {\n    return this.addFixture({ match: { userMessage: input }, response });\n  }\n\n  onSoundEffect(text: string | RegExp, response: AudioResponse): this {\n    return this.addFixture({\n      match: { userMessage: text, endpoint: \"audio-gen\" },\n      response,\n    });\n  }\n\n  onMusic(prompt: string | RegExp, response: AudioResponse): this {\n    return this.addFixture({\n      match: { userMessage: prompt, endpoint: \"audio-gen\" },\n      response,\n    });\n  }\n\n  onElevenLabsTTS(text: string | RegExp, response: AudioResponse): this {\n    return this.addFixture({\n      match: { userMessage: text, endpoint: \"elevenlabs-tts\" },\n      response,\n    });\n  }\n\n  onElevenLabsVoiceDesign(description: string | RegExp, response: VoiceDesignResponse): this {\n    return this.addFixture({\n      match: { userMessage: description, endpoint: \"elevenlabs-voice-design\" },\n      response: voiceDesignToJson(response),\n    });\n  }\n\n  onFalAudio(prompt: string | RegExp, response: AudioResponse, model?: string): this {\n    return this.addFixture({\n      match: { userMessage: prompt, endpoint: \"fal-audio\", ...(model ? { model } : {}) },\n      response,\n    });\n  }\n\n  // fal.queue.* is the dominant client API; onFalRun is a sync alias.\n  //\n  // `opts.billableUnits` rides through to the completed `queue-result`\n  // response's `x-fal-billable-units` header (emitted alongside\n  // `x-fal-request-id`), letting consumers like `@tanstack/ai-fal` surface a\n  // billed-units value on replay. Omit it to preserve the header-less default.\n  onFalQueue(modelOrPrompt: string | RegExp, response: unknown, opts?: FalQueueOpts): this {\n    const { billableUnits, ...fixtureOpts } = opts ?? {};\n    return this.addFixture({\n      match: { model: modelOrPrompt, endpoint: \"fal\" },\n      response: { json: response, ...(billableUnits != null ? { billableUnits } : {}) },\n      ...fixtureOpts,\n    });\n  }\n\n  onFalRun(modelOrPrompt: string | RegExp, response: unknown, opts?: FalQueueOpts): this {\n    return this.onFalQueue(modelOrPrompt, response, opts);\n  }\n\n  /**\n   * Register a fal.ai image fixture. Wraps an `ImageResponse` (the shape used\n   * by `onImage` and OpenAI/Azure image fixtures) into fal's image envelope\n   * before storing it as a `RawJSONResponse`. Defaults `width`/`height` to\n   * 1024 when the fixture's `ImageItem` doesn't carry them.\n   */\n  onFalImage(modelOrPrompt: string | RegExp, response: ImageResponse, opts?: FalQueueOpts): this {\n    return this.onFalQueue(modelOrPrompt, imageResponseToFalJson(response), opts);\n  }\n\n  /**\n   * Register a fal.ai video fixture. Wraps a `VideoResponse` into fal's video\n   * envelope (`{ video: { url, content_type, file_name, file_size }, seed }`)\n   * before storing it as a `RawJSONResponse`.\n   */\n  onFalVideo(modelOrPrompt: string | RegExp, response: VideoResponse, opts?: FalQueueOpts): this {\n    return this.onFalQueue(modelOrPrompt, videoResponseToFalJson(response), opts);\n  }\n\n  // ---- Service mock convenience methods ----\n\n  onSearch(pattern: string | RegExp, results: SearchResult[]): this {\n    this.searchFixtures.push({ match: pattern, results });\n    return this;\n  }\n\n  onRerank(pattern: string | RegExp, results: RerankResult[]): this {\n    this.rerankFixtures.push({ match: pattern, results });\n    return this;\n  }\n\n  onModerate(pattern: string | RegExp, result: ModerationResult): this {\n    this.moderationFixtures.push({ match: pattern, result });\n    return this;\n  }\n\n  /**\n   * Queue a one-shot error that will be returned for the next matching\n   * request, then automatically removed. Implemented as an internal fixture\n   * inserted at the front of the fixture list; see `queueOneShotError` for\n   * the endpoint gate and the served-not-evaluated consumption rule.\n   */\n  nextRequestError(\n    status: number,\n    errorBody?: { message?: string; type?: string; code?: string },\n  ): this {\n    // Same gate as `POST /__aimock/error` and fixture validation — this is the\n    // form the docs use, and an unchecked status reaches `res.writeHead` on\n    // the next matched request: 99/1000 throw there (the injected error is\n    // lost and the caller sees a generic 500), and 1xx hangs the request until\n    // the client times out. Throwing HERE names the offending call instead.\n    if (!isInjectableStatus(status)) {\n      throw new RangeError(\n        `nextRequestError: invalid status ${String(status)} — must be ${INJECTED_STATUS_RANGE}`,\n      );\n    }\n    queueOneShotError(this.fixtures, status, errorBody);\n    return this;\n  }\n\n  // ---- Mounts ----\n\n  mount(path: string, handler: Mountable): this {\n    this.mounts.push({ path, handler });\n\n    // If server is already running, wire up journal, registry, and baseUrl immediately\n    // so late mounts behave identically to pre-start mounts.\n    if (this.serverInstance) {\n      if (handler.setJournal) handler.setJournal(this.serverInstance.journal);\n      if (handler.setBaseUrl) handler.setBaseUrl(this.serverInstance.url + path);\n      const registry = this.serverInstance.defaults.registry;\n      if (registry && handler.setRegistry) handler.setRegistry(registry);\n    }\n\n    return this;\n  }\n\n  // ---- Journal proxies ----\n\n  getRequests(): import(\"./types.js\").JournalEntry[] {\n    return this.journal.getAll();\n  }\n\n  getLastRequest(): import(\"./types.js\").JournalEntry | null {\n    return this.journal.getLast();\n  }\n\n  /**\n   * Clear the request journal. Fixture match-counts (sequencing state) are\n   * left intact — use `resetMatchCounts()` for those.\n   */\n  clearRequests(): void {\n    this.journal.clearEntries();\n  }\n\n  resetMatchCounts(testId?: string): this {\n    if (this.serverInstance) {\n      this.serverInstance.journal.clearMatchCounts(testId);\n    }\n    return this;\n  }\n\n  // ---- Chaos ----\n\n  /**\n   * Set the server-wide chaos baseline. Writes through to a RUNNING server as\n   * well as the construction options: an untagged `POST /__aimock/chaos`\n   * installs a baseline override that shadows `options.chaos`, and without this\n   * the call would silently do nothing until the next `reset()`. Per-testId\n   * overrides still win over the baseline.\n   */\n  setChaos(config: ChaosConfig): this {\n    this.options.chaos = config;\n    if (this.serverInstance) this.serverInstance.defaults.chaos = config;\n    return this;\n  }\n\n  /**\n   * Turn chaos off everywhere: the construction config, the runtime baseline,\n   * and every per-testId override (assigning `undefined` is the full-clear\n   * signal the `defaults.chaos` setter defines).\n   */\n  clearChaos(): this {\n    delete this.options.chaos;\n    if (this.serverInstance) this.serverInstance.defaults.chaos = undefined;\n    return this;\n  }\n\n  // ---- Recording ----\n\n  enableRecording(config: RecordConfig): this {\n    this.options.record = config;\n    return this;\n  }\n\n  disableRecording(): this {\n    delete this.options.record;\n    return this;\n  }\n\n  // ---- Reset ----\n\n  /**\n   * Full reset — the in-process equivalent of `POST /__aimock/reset`. Shares\n   * one implementation with the control-API route so the two cannot drift.\n   *\n   * The one deliberate difference: search / rerank / moderation fixtures are\n   * also cleared here. Those are registered through this class only — the\n   * control API has no route that creates them, so the HTTP reset can neither\n   * reach nor observe them.\n   *\n   * NOT ALL OF THIS IS PER-INSTANCE. `performFullReset` clears module-global\n   * state as well: the Gemini interaction and event-id counters\n   * (`resetInteractionCounter` / `resetEventIdCounter` in\n   * `./gemini-interactions.js`), the fal.ai job/queue maps (`falJobs`,\n   * `falQueueStates`), the fine-tuning job store (`clearFineTuningStore`),\n   * and the ElevenLabs Voice Design store (`clearElevenLabsVoices`). With two\n   * `LLMock` instances live in one process,\n   * `a.reset()` rewinds the Gemini id sequence that `b` is mid-way through —\n   * `b` then re-emits `aimock-int-0` / `evt_1`, ids it has already handed\n   * out — and drops `b`'s in-flight fal jobs. Give each instance its own\n   * process (or its own vitest worker) if that matters.\n   *\n   * The global stores are cleared even before `start()`, when there is no\n   * server instance to reset.\n   */\n  reset(): this {\n    this.searchFixtures.length = 0;\n    this.rerankFixtures.length = 0;\n    this.moderationFixtures.length = 0;\n    performFullReset(this.fixtures, this.serverInstance);\n    return this;\n  }\n\n  // ---- Server lifecycle ----\n\n  async start(): Promise<string> {\n    if (this.serverInstance) {\n      throw new Error(\"Server already started\");\n    }\n    this.serverInstance = await (this.resolvedInboundAuth\n      ? createServerWithResolvedAuth(\n          this.fixtures,\n          this.options,\n          this.resolvedInboundAuth,\n          this.mounts,\n          {\n            search: this.searchFixtures,\n            rerank: this.rerankFixtures,\n            moderation: this.moderationFixtures,\n          },\n        )\n      : createServer(this.fixtures, this.options, this.mounts, {\n          search: this.searchFixtures,\n          rerank: this.rerankFixtures,\n          moderation: this.moderationFixtures,\n        }));\n    return this.serverInstance.url;\n  }\n\n  closeLiveSessions(testId?: string): this {\n    this.serverInstance?.closeLiveSessions(testId);\n    return this;\n  }\n\n  async stop(): Promise<void> {\n    if (!this.serverInstance) {\n      throw new Error(\"Server not started\");\n    }\n    const { server } = this.serverInstance;\n    await new Promise<void>((resolve, reject) => {\n      server.close((err: Error | undefined) => (err ? reject(err) : resolve()));\n    });\n    this.serverInstance = null;\n  }\n\n  // ---- Accessors ----\n\n  get journal(): Journal {\n    if (!this.serverInstance) {\n      throw new Error(\"Server not started\");\n    }\n    return this.serverInstance.journal;\n  }\n\n  get url(): string {\n    if (!this.serverInstance) {\n      throw new Error(\"Server not started\");\n    }\n    return this.serverInstance.url;\n  }\n\n  get baseUrl(): string {\n    return this.url;\n  }\n\n  get port(): number {\n    const parsed = new URL(this.url); // this.url throws if not started\n    if (!parsed.port) {\n      throw new Error(`Server URL has no explicit port: ${this.url}`);\n    }\n    return parseInt(parsed.port, 10);\n  }\n\n  // ---- Static factory ----\n\n  static async create(options?: MockServerOptions): Promise<LLMock> {\n    const instance = new LLMock(options);\n    await instance.start();\n    return instance;\n  }\n}\n\n/** @internal Configuration startup preserves a policy resolved from the selected source. */\nexport function createLLMockWithResolvedAuth(\n  options: MockServerOptions,\n  resolvedAuth: ResolvedInboundAuth,\n): LLMock {\n  return new LLMock(options, resolvedAuth);\n}\n"],"mappings":"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"}

package/dist/llmock.d.cts

@@ -1,5 +1,6 @@
 import { Journal } from "./journal.cjs";
-import { AudioResponse, ChaosConfig, EmbeddingFixtureOpts, FalQueueOpts, Fixture, FixtureFileEntry, FixtureFileResponse, FixtureMatch, FixtureOpts, ImageResponse, JournalEntry, MockServerOptions, Mountable, RecordConfig, ResponseFactory, TranscriptionResponse, VideoResponse } from "./types.cjs";
+import { LiveTranscript } from "./live-types.cjs";
+import { AudioResponse, ChaosConfig, EmbeddingFixtureOpts, FalQueueOpts, Fixture, FixtureFileEntry, FixtureFileResponse, FixtureMatch, FixtureOpts, ImageResponse, JournalEntry, MockServerOptions, Mountable, RecordConfig, ResponseFactory, TranscriptionResponse, VideoResponse, VoiceDesignResponse } from "./types.cjs";
 import { ResolvedInboundAuth } from "./api-key-auth.cjs";
 import { SearchResult } from "./search.cjs";
 import { RerankResult } from "./rerank.cjs";
@@ -16,6 +17,7 @@ declare class LLMock {
   private options;
   private readonly resolvedInboundAuth?;
   constructor(options?: MockServerOptions, resolvedInboundAuth?: ResolvedInboundAuth);
+  private normalizeFixture;
   addFixture(fixture: Fixture): this;
   addFixtures(fixtures: Fixture[]): this;
   prependFixture(fixture: Fixture): this;
@@ -29,6 +31,7 @@ declare class LLMock {
   addFixturesFromJSON(input: string | FixtureFileEntry[]): this;
   clearFixtures(): this;
   on(match: FixtureMatch, response: FixtureFileResponse | ResponseFactory, opts?: FixtureOpts): this;
+  onLive(match: Omit<FixtureMatch, "endpoint">, transcript: LiveTranscript, opts?: FixtureOpts): this;
   onMessage(pattern: string | RegExp, response: FixtureFileResponse | ResponseFactory, opts?: FixtureOpts): this;
   onEmbedding(pattern: string | RegExp, response: FixtureFileResponse | ResponseFactory, opts?: EmbeddingFixtureOpts): this;
   onJsonOutput(pattern: string | RegExp, jsonContent: object | string, opts?: FixtureOpts): this;
@@ -44,6 +47,7 @@ declare class LLMock {
   onSoundEffect(text: string | RegExp, response: AudioResponse): this;
   onMusic(prompt: string | RegExp, response: AudioResponse): this;
   onElevenLabsTTS(text: string | RegExp, response: AudioResponse): this;
+  onElevenLabsVoiceDesign(description: string | RegExp, response: VoiceDesignResponse): this;
   onFalAudio(prompt: string | RegExp, response: AudioResponse, model?: string): this;
   onFalQueue(modelOrPrompt: string | RegExp, response: unknown, opts?: FalQueueOpts): this;
   onFalRun(modelOrPrompt: string | RegExp, response: unknown, opts?: FalQueueOpts): this;
@@ -66,8 +70,8 @@ declare class LLMock {
   /**
    * Queue a one-shot error that will be returned for the next matching
    * request, then automatically removed. Implemented as an internal fixture
-   * with a `predicate` that always matches (so it fires first) and spliced
-   * at the front of the fixture list.
+   * inserted at the front of the fixture list; see `queueOneShotError` for
+   * the endpoint gate and the served-not-evaluated consumption rule.
    */
   nextRequestError(status: number, errorBody?: {
     message?: string;
@@ -77,6 +81,10 @@ declare class LLMock {
   mount(path: string, handler: Mountable): this;
   getRequests(): JournalEntry[];
   getLastRequest(): JournalEntry | null;
+  /**
+   * Clear the request journal. Fixture match-counts (sequencing state) are
+   * left intact — use `resetMatchCounts()` for those.
+   */
   clearRequests(): void;
   resetMatchCounts(testId?: string): this;
   /**
@@ -107,8 +115,10 @@ declare class LLMock {
    * NOT ALL OF THIS IS PER-INSTANCE. `performFullReset` clears module-global
    * state as well: the Gemini interaction and event-id counters
    * (`resetInteractionCounter` / `resetEventIdCounter` in
-   * `./gemini-interactions.js`) and the fal.ai job/queue maps (`falJobs`,
-   * `falQueueStates`). With two `LLMock` instances live in one process,
+   * `./gemini-interactions.js`), the fal.ai job/queue maps (`falJobs`,
+   * `falQueueStates`), the fine-tuning job store (`clearFineTuningStore`),
+   * and the ElevenLabs Voice Design store (`clearElevenLabsVoices`). With two
+   * `LLMock` instances live in one process,
    * `a.reset()` rewinds the Gemini id sequence that `b` is mid-way through —
    * `b` then re-emits `aimock-int-0` / `evt_1`, ids it has already handed
    * out — and drops `b`'s in-flight fal jobs. Give each instance its own
@@ -119,6 +129,7 @@ declare class LLMock {
    */
   reset(): this;
   start(): Promise<string>;
+  closeLiveSessions(testId?: string): this;
   stop(): Promise<void>;
   get journal(): Journal;
   get url(): string;

package/dist/llmock.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"llmock.d.cts","names":[],"sources":["../src/llmock.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"llmock.d.cts","names":[],"sources":["../src/llmock.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/llmock.d.ts

@@ -1,5 +1,6 @@
 import { Journal } from "./journal.js";
-import { AudioResponse, ChaosConfig, EmbeddingFixtureOpts, FalQueueOpts, Fixture, FixtureFileEntry, FixtureFileResponse, FixtureMatch, FixtureOpts, ImageResponse, JournalEntry, MockServerOptions, Mountable, RecordConfig, ResponseFactory, TranscriptionResponse, VideoResponse } from "./types.js";
+import { LiveTranscript } from "./live-types.js";
+import { AudioResponse, ChaosConfig, EmbeddingFixtureOpts, FalQueueOpts, Fixture, FixtureFileEntry, FixtureFileResponse, FixtureMatch, FixtureOpts, ImageResponse, JournalEntry, MockServerOptions, Mountable, RecordConfig, ResponseFactory, TranscriptionResponse, VideoResponse, VoiceDesignResponse } from "./types.js";
 import { ResolvedInboundAuth } from "./api-key-auth.js";
 import { SearchResult } from "./search.js";
 import { RerankResult } from "./rerank.js";
@@ -16,6 +17,7 @@ declare class LLMock {
   private options;
   private readonly resolvedInboundAuth?;
   constructor(options?: MockServerOptions, resolvedInboundAuth?: ResolvedInboundAuth);
+  private normalizeFixture;
   addFixture(fixture: Fixture): this;
   addFixtures(fixtures: Fixture[]): this;
   prependFixture(fixture: Fixture): this;
@@ -29,6 +31,7 @@ declare class LLMock {
   addFixturesFromJSON(input: string | FixtureFileEntry[]): this;
   clearFixtures(): this;
   on(match: FixtureMatch, response: FixtureFileResponse | ResponseFactory, opts?: FixtureOpts): this;
+  onLive(match: Omit<FixtureMatch, "endpoint">, transcript: LiveTranscript, opts?: FixtureOpts): this;
   onMessage(pattern: string | RegExp, response: FixtureFileResponse | ResponseFactory, opts?: FixtureOpts): this;
   onEmbedding(pattern: string | RegExp, response: FixtureFileResponse | ResponseFactory, opts?: EmbeddingFixtureOpts): this;
   onJsonOutput(pattern: string | RegExp, jsonContent: object | string, opts?: FixtureOpts): this;
@@ -44,6 +47,7 @@ declare class LLMock {
   onSoundEffect(text: string | RegExp, response: AudioResponse): this;
   onMusic(prompt: string | RegExp, response: AudioResponse): this;
   onElevenLabsTTS(text: string | RegExp, response: AudioResponse): this;
+  onElevenLabsVoiceDesign(description: string | RegExp, response: VoiceDesignResponse): this;
   onFalAudio(prompt: string | RegExp, response: AudioResponse, model?: string): this;
   onFalQueue(modelOrPrompt: string | RegExp, response: unknown, opts?: FalQueueOpts): this;
   onFalRun(modelOrPrompt: string | RegExp, response: unknown, opts?: FalQueueOpts): this;
@@ -66,8 +70,8 @@ declare class LLMock {
   /**
    * Queue a one-shot error that will be returned for the next matching
    * request, then automatically removed. Implemented as an internal fixture
-   * with a `predicate` that always matches (so it fires first) and spliced
-   * at the front of the fixture list.
+   * inserted at the front of the fixture list; see `queueOneShotError` for
+   * the endpoint gate and the served-not-evaluated consumption rule.
    */
   nextRequestError(status: number, errorBody?: {
     message?: string;
@@ -77,6 +81,10 @@ declare class LLMock {
   mount(path: string, handler: Mountable): this;
   getRequests(): JournalEntry[];
   getLastRequest(): JournalEntry | null;
+  /**
+   * Clear the request journal. Fixture match-counts (sequencing state) are
+   * left intact — use `resetMatchCounts()` for those.
+   */
   clearRequests(): void;
   resetMatchCounts(testId?: string): this;
   /**
@@ -107,8 +115,10 @@ declare class LLMock {
    * NOT ALL OF THIS IS PER-INSTANCE. `performFullReset` clears module-global
    * state as well: the Gemini interaction and event-id counters
    * (`resetInteractionCounter` / `resetEventIdCounter` in
-   * `./gemini-interactions.js`) and the fal.ai job/queue maps (`falJobs`,
-   * `falQueueStates`). With two `LLMock` instances live in one process,
+   * `./gemini-interactions.js`), the fal.ai job/queue maps (`falJobs`,
+   * `falQueueStates`), the fine-tuning job store (`clearFineTuningStore`),
+   * and the ElevenLabs Voice Design store (`clearElevenLabsVoices`). With two
+   * `LLMock` instances live in one process,
    * `a.reset()` rewinds the Gemini id sequence that `b` is mid-way through —
    * `b` then re-emits `aimock-int-0` / `evt_1`, ids it has already handed
    * out — and drops `b`'s in-flight fal jobs. Give each instance its own
@@ -119,6 +129,7 @@ declare class LLMock {
    */
   reset(): this;
   start(): Promise<string>;
+  closeLiveSessions(testId?: string): this;
   stop(): Promise<void>;
   get journal(): Journal;
   get url(): string;

package/dist/llmock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"llmock.d.ts","names":[],"sources":["../src/llmock.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"llmock.d.ts","names":[],"sources":["../src/llmock.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/llmock.js

@@ -1,5 +1,8 @@
-import { INJECTED_STATUS_RANGE, entryToFixture, isInjectableStatus, loadFixtureFile, loadFixturesFromDir, normalizeResponse, validateFixtures } from "./fixture-loader.js";
+import { isLiveResponse } from "./helpers.js";
+import { normalizeLiveFixture, normalizeLiveOptions } from "./live-fixture.js";
+import { INJECTED_STATUS_RANGE, clearFixtureQueue, entryToFixture, isInjectableStatus, loadFixtureFile, loadFixturesFromDir, normalizeResponse, queueOneShotError, validateFixtures } from "./fixture-loader.js";
 import { imageResponseToFalJson, videoResponseToFalJson } from "./fal.js";
+import { voiceDesignToJson } from "./elevenlabs-voice.js";
 import { createServer, createServerWithResolvedAuth, performFullReset } from "./server.js";
 
 //#region src/llmock.ts
@@ -14,29 +17,38 @@ var LLMock = class LLMock {
 	resolvedInboundAuth;
 	constructor(options, resolvedInboundAuth) {
 		this.options = options ?? {};
+		if (this.options.live !== void 0) normalizeLiveOptions(this.options.live);
 		this.resolvedInboundAuth = resolvedInboundAuth;
 	}
+	normalizeFixture(fixture) {
+		if (isLiveResponse(fixture.response) || fixture.match.endpoint === "openai-live" && typeof fixture.response !== "function") return {
+			...fixture,
+			match: { ...fixture.match },
+			response: normalizeLiveFixture(fixture.response, this.options.live)
+		};
+		return fixture;
+	}
 	addFixture(fixture) {
-		this.fixtures.push(fixture);
+		this.fixtures.push(this.normalizeFixture(fixture));
 		return this;
 	}
 	addFixtures(fixtures) {
-		this.fixtures.push(...fixtures);
+		this.fixtures.push(...fixtures.map((fixture) => this.normalizeFixture(fixture)));
 		return this;
 	}
 	prependFixture(fixture) {
-		this.fixtures.unshift(fixture);
+		this.fixtures.unshift(this.normalizeFixture(fixture));
 		return this;
 	}
 	getFixtures() {
 		return this.fixtures;
 	}
 	loadFixtureFile(filePath) {
-		this.fixtures.push(...loadFixtureFile(filePath));
+		this.fixtures.push(...loadFixtureFile(filePath, void 0, this.options.live));
 		return this;
 	}
 	loadFixtureDir(dirPath) {
-		this.fixtures.push(...loadFixturesFromDir(dirPath));
+		this.fixtures.push(...loadFixturesFromDir(dirPath, void 0, this.options.live));
 		return this;
 	}
 	/**
@@ -51,23 +63,29 @@ var LLMock = class LLMock {
 			throw new Error(`addFixturesFromJSON: invalid JSON — ${err instanceof Error ? err.message : String(err)}`);
 		}
 		else entries = input;
-		const converted = entries.map((e) => entryToFixture(e));
-		const errors = validateFixtures(converted).filter((i) => i.severity === "error");
+		const converted = entries.map((e) => entryToFixture(e, void 0, this.options.live));
+		const errors = validateFixtures(converted, this.options.live).filter((i) => i.severity === "error");
 		if (errors.length > 0) throw new Error(`Fixture validation failed: ${JSON.stringify(errors)}`);
 		this.fixtures.push(...converted);
 		return this;
 	}
 	clearFixtures() {
-		this.fixtures.length = 0;
+		clearFixtureQueue(this.fixtures);
 		return this;
 	}
 	on(match, response, opts) {
 		return this.addFixture({
 			match,
-			response: typeof response === "function" ? response : normalizeResponse(response),
+			response: typeof response === "function" ? response : normalizeResponse(response, this.options.live),
 			...opts
 		});
 	}
+	onLive(match, transcript, opts) {
+		return this.on({
+			...match,
+			endpoint: "openai-live"
+		}, { live: transcript }, opts);
+	}
 	onMessage(pattern, response, opts) {
 		return this.on({ userMessage: pattern }, response, opts);
 	}
@@ -165,6 +183,15 @@ var LLMock = class LLMock {
 			response
 		});
 	}
+	onElevenLabsVoiceDesign(description, response) {
+		return this.addFixture({
+			match: {
+				userMessage: description,
+				endpoint: "elevenlabs-voice-design"
+			},
+			response: voiceDesignToJson(response)
+		});
+	}
 	onFalAudio(prompt, response, model) {
 		return this.addFixture({
 			match: {
@@ -233,38 +260,12 @@ var LLMock = class LLMock {
 	/**
 	* Queue a one-shot error that will be returned for the next matching
 	* request, then automatically removed. Implemented as an internal fixture
-	* with a `predicate` that always matches (so it fires first) and spliced
-	* at the front of the fixture list.
+	* inserted at the front of the fixture list; see `queueOneShotError` for
+	* the endpoint gate and the served-not-evaluated consumption rule.
 	*/
 	nextRequestError(status, errorBody) {
 		if (!isInjectableStatus(status)) throw new RangeError(`nextRequestError: invalid status ${String(status)} — must be ${INJECTED_STATUS_RANGE}`);
-		const errorResponse = {
-			error: {
-				message: errorBody?.message ?? "Injected error",
-				type: errorBody?.type ?? "server_error",
-				code: errorBody?.code
-			},
-			status
-		};
-		const errorEndpointCompatible = (req) => {
-			const reqEndpoint = req._endpointType;
-			if (reqEndpoint === void 0 || reqEndpoint === "chat" || reqEndpoint === "embedding" || reqEndpoint.startsWith("realtime") || reqEndpoint === "fal") return true;
-			return false;
-		};
-		const fixture = {
-			match: { predicate: errorEndpointCompatible },
-			response: errorResponse
-		};
-		this.fixtures.unshift(fixture);
-		const original = fixture.match.predicate;
-		fixture.match.predicate = (req) => {
-			const result = original(req);
-			if (result) {
-				const idx = this.fixtures.indexOf(fixture);
-				if (idx !== -1) this.fixtures.splice(idx, 1);
-			}
-			return result;
-		};
+		queueOneShotError(this.fixtures, status, errorBody);
 		return this;
 	}
 	mount(path, handler) {
@@ -286,8 +287,12 @@ var LLMock = class LLMock {
 	getLastRequest() {
 		return this.journal.getLast();
 	}
+	/**
+	* Clear the request journal. Fixture match-counts (sequencing state) are
+	* left intact — use `resetMatchCounts()` for those.
+	*/
 	clearRequests() {
-		this.journal.clear();
+		this.journal.clearEntries();
 	}
 	resetMatchCounts(testId) {
 		if (this.serverInstance) this.serverInstance.journal.clearMatchCounts(testId);
@@ -335,8 +340,10 @@ var LLMock = class LLMock {
 	* NOT ALL OF THIS IS PER-INSTANCE. `performFullReset` clears module-global
 	* state as well: the Gemini interaction and event-id counters
 	* (`resetInteractionCounter` / `resetEventIdCounter` in
-	* `./gemini-interactions.js`) and the fal.ai job/queue maps (`falJobs`,
-	* `falQueueStates`). With two `LLMock` instances live in one process,
+	* `./gemini-interactions.js`), the fal.ai job/queue maps (`falJobs`,
+	* `falQueueStates`), the fine-tuning job store (`clearFineTuningStore`),
+	* and the ElevenLabs Voice Design store (`clearElevenLabsVoices`). With two
+	* `LLMock` instances live in one process,
 	* `a.reset()` rewinds the Gemini id sequence that `b` is mid-way through —
 	* `b` then re-emits `aimock-int-0` / `evt_1`, ids it has already handed
 	* out — and drops `b`'s in-flight fal jobs. Give each instance its own
@@ -365,6 +372,10 @@ var LLMock = class LLMock {
 		}));
 		return this.serverInstance.url;
 	}
+	closeLiveSessions(testId) {
+		this.serverInstance?.closeLiveSessions(testId);
+		return this;
+	}
 	async stop() {
 		if (!this.serverInstance) throw new Error("Server not started");
 		const { server } = this.serverInstance;