@copilotkit/aimock 1.45.1 → 1.46.0

package/dist/speech.cjs

@@ -1,3 +1,5 @@
+const require_errors = require('./response/errors.cjs');
+const require_policy = require('./response/policy.cjs');
 const require_helpers = require('./helpers.cjs');
 const require_sse_writer = require('./sse-writer.cjs');
 const require_chaos = require('./chaos.cjs');
@@ -24,11 +26,11 @@ async function handleSpeech(req, res, raw, fixtures, journal, defaults, setCorsH
 				fixture: null
 			}
 		});
-		require_sse_writer.writeErrorResponse(res, 400, JSON.stringify({ error: {
+		require_sse_writer.writeErrorResponse(res, 400, require_errors.renderError("openai", "validation", {
 			message: `Malformed JSON: ${detail}`,
 			type: "invalid_request_error",
 			code: "invalid_json"
-		} }));
+		}).body);
 		return;
 	}
 	if (!require_helpers.isJsonObject(speechReq)) {
@@ -42,10 +44,10 @@ async function handleSpeech(req, res, raw, fixtures, journal, defaults, setCorsH
 				fixture: null
 			}
 		});
-		require_sse_writer.writeErrorResponse(res, 400, JSON.stringify({ error: {
+		require_sse_writer.writeErrorResponse(res, 400, require_errors.renderError("openai", "validation", {
 			message: "Request body must be a JSON object",
 			type: "invalid_request_error"
-		} }));
+		}).body);
 		return;
 	}
 	const input = speechReq.input;
@@ -61,10 +63,10 @@ async function handleSpeech(req, res, raw, fixtures, journal, defaults, setCorsH
 				fixture: null
 			}
 		});
-		require_sse_writer.writeErrorResponse(res, 400, JSON.stringify({ error: {
+		require_sse_writer.writeErrorResponse(res, 400, require_errors.renderError("openai", "validation", {
 			message: !input ? "Missing required parameter: 'input'" : "Invalid parameter: 'input' must be a string or a nonempty array of content parts",
 			type: "invalid_request_error"
-		} }));
+		}).body);
 		return;
 	}
 	const syntheticReq = {
@@ -89,7 +91,7 @@ async function handleSpeech(req, res, raw, fixtures, journal, defaults, setCorsH
 		body: syntheticReq
 	}, fixture ? "fixture" : "proxy", defaults.registry, defaults.logger)) return;
 	if (!fixture) {
-		if (require_helpers.resolveStrictMode(defaults.strict, req.headers)) {
+		if (require_policy.resolveRequestDecisions(defaults.strict, req.headers).fixtureMiss) {
 			const strictMessage = require_helpers.strictNoMatchMessage(skippedBySequenceOrTurn);
 			defaults.logger.error(require_helpers.strictNoMatchLogLine(method, path, skippedBySequenceOrTurn));
 			journal.add({
@@ -100,14 +102,14 @@ async function handleSpeech(req, res, raw, fixtures, journal, defaults, setCorsH
 				response: {
 					status: 503,
 					fixture: null,
-					...require_helpers.strictOverrideField(defaults.strict, req.headers)
+					...require_policy.strictOverrideField(defaults.strict, req.headers)
 				}
 			});
-			require_sse_writer.writeErrorResponse(res, 503, JSON.stringify({ error: {
+			require_sse_writer.writeErrorResponse(res, 503, require_errors.renderError("openai", "strict-miss", {
 				message: strictMessage,
 				type: "invalid_request_error",
 				code: "no_fixture_match"
-			} }));
+			}).body);
 			return;
 		}
 		if (defaults.record) {
@@ -136,14 +138,14 @@ async function handleSpeech(req, res, raw, fixtures, journal, defaults, setCorsH
 			response: {
 				status: 404,
 				fixture: null,
-				...require_helpers.strictOverrideField(defaults.strict, req.headers)
+				...require_policy.strictOverrideField(defaults.strict, req.headers)
 			}
 		});
-		require_sse_writer.writeErrorResponse(res, 404, JSON.stringify({ error: {
+		require_sse_writer.writeErrorResponse(res, 404, require_errors.renderError("openai", "fixture-miss", {
 			message: "No fixture matched",
 			type: "invalid_request_error",
 			code: "no_fixture_match"
-		} }));
+		}).body);
 		return;
 	}
 	const response = await require_helpers.resolveResponse(fixture, syntheticReq);
@@ -159,7 +161,7 @@ async function handleSpeech(req, res, raw, fixtures, journal, defaults, setCorsH
 				fixture
 			}
 		});
-		require_sse_writer.writeErrorResponse(res, status, require_helpers.serializeErrorResponse(response), { retryAfter: response.retryAfter });
+		require_sse_writer.writeErrorResponse(res, status, require_errors.renderError("openai", "fixture", response.error).body, { retryAfter: response.retryAfter });
 		return;
 	}
 	if (!require_helpers.isAudioResponse(response)) {
@@ -173,10 +175,10 @@ async function handleSpeech(req, res, raw, fixtures, journal, defaults, setCorsH
 				fixture
 			}
 		});
-		require_sse_writer.writeErrorResponse(res, 500, JSON.stringify({ error: {
+		require_sse_writer.writeErrorResponse(res, 500, require_errors.renderError("openai", "unknown-response", {
 			message: "Fixture response is not an audio type",
 			type: "server_error"
-		} }));
+		}).body);
 		return;
 	}
 	if (typeof response.audio !== "string") {
@@ -190,10 +192,10 @@ async function handleSpeech(req, res, raw, fixtures, journal, defaults, setCorsH
 				fixture
 			}
 		});
-		require_sse_writer.writeErrorResponse(res, 500, JSON.stringify({ error: {
+		require_sse_writer.writeErrorResponse(res, 500, require_errors.renderError("openai", "unknown-response", {
 			message: "Object-form audio not supported for speech endpoint. Use string-form: { audio: '<base64>' }",
 			type: "server_error"
-		} }));
+		}).body);
 		return;
 	}
 	journal.add({

package/dist/speech.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"speech.cjs","names":["flattenHeaders","isJsonObject","getContext","getTestId","matchFixtureDiagnostic","applyChaosAsync","resolveStrictMode","strictNoMatchMessage","strictNoMatchLogLine","strictOverrideField","proxyAndRecord","resolveResponse","isErrorResponse","serializeErrorResponse","isAudioResponse","FORMAT_TO_CONTENT_TYPE"],"sources":["../src/speech.ts"],"sourcesContent":["import type * as http from \"node:http\";\nimport type { ChatCompletionRequest, Fixture, HandlerDefaults } from \"./types.js\";\nimport {\n  isAudioResponse,\n  isErrorResponse,\n  isJsonObject,\n  serializeErrorResponse,\n  flattenHeaders,\n  getTestId,\n  FORMAT_TO_CONTENT_TYPE,\n  resolveResponse,\n  resolveStrictMode,\n  strictOverrideField,\n  getContext,\n  strictNoMatchMessage,\n  strictNoMatchLogLine,\n} from \"./helpers.js\";\nimport { matchFixtureDiagnostic } 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\ninterface SpeechRequest {\n  model?: string;\n  input: string;\n  voice?: string;\n  response_format?: string;\n  speed?: number;\n  [key: string]: unknown;\n}\n\nexport async function handleSpeech(\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): Promise<void> {\n  setCorsHeaders(res);\n  const path = req.url ?? \"/v1/audio/speech\";\n  const method = req.method ?? \"POST\";\n\n  let speechReq: SpeechRequest;\n  try {\n    speechReq = JSON.parse(raw) as SpeechRequest;\n  } catch (parseErr) {\n    const detail = parseErr instanceof Error ? parseErr.message : \"unknown\";\n    journal.add({\n      method,\n      path,\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: ${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 `speechReq.input` throws a TypeError that\n  // surfaces as a 500 instead of a 400.\n  if (!isJsonObject(speechReq)) {\n    journal.add({\n      method,\n      path,\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  const input: unknown = speechReq.input;\n  const validInput =\n    typeof input === \"string\" ||\n    (Array.isArray(input) &&\n      input.length > 0 &&\n      input.every(\n        (part: unknown) =>\n          isJsonObject(part) &&\n          typeof part.type === \"string\" &&\n          (!(\"text\" in part) || typeof part.text === \"string\"),\n      ));\n  if (!input || !validInput) {\n    journal.add({\n      method,\n      path,\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: !input\n            ? \"Missing required parameter: 'input'\"\n            : \"Invalid parameter: 'input' must be a string or a nonempty array of content parts\",\n          type: \"invalid_request_error\",\n        },\n      }),\n    );\n    return;\n  }\n\n  const syntheticReq: ChatCompletionRequest = {\n    model: speechReq.model ?? \"tts-1\",\n    messages: [{ role: \"user\", content: speechReq.input }],\n    _endpointType: \"speech\",\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    defaults.logger.debug(`Fixture matched: ${JSON.stringify(fixture.match).slice(0, 120)}`);\n  } else {\n    defaults.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      { method, path, headers: flattenHeaders(req.headers), body: syntheticReq },\n      fixture ? \"fixture\" : \"proxy\",\n      defaults.registry,\n      defaults.logger,\n    )\n  )\n    return;\n\n  if (!fixture) {\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      journal.add({\n        method,\n        path,\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    if (defaults.record) {\n      const outcome = await proxyAndRecord(\n        req,\n        res,\n        syntheticReq,\n        \"openai\",\n        req.url ?? \"/v1/audio/speech\",\n        fixtures,\n        defaults,\n        raw,\n      );\n      if (outcome === \"handled_by_hook\") return;\n      if (outcome !== \"not_configured\") {\n        journal.add({\n          method,\n          path,\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    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      body: syntheticReq,\n      response: {\n        status: 404,\n        fixture: null,\n        ...strictOverrideField(defaults.strict, req.headers),\n      },\n    });\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    return;\n  }\n\n  const response = await resolveResponse(fixture, syntheticReq);\n\n  if (isErrorResponse(response)) {\n    const status = response.status ?? 500;\n    journal.add({\n      method,\n      path,\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  if (!isAudioResponse(response)) {\n    journal.add({\n      method,\n      path,\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: { message: \"Fixture response is not an audio type\", type: \"server_error\" },\n      }),\n    );\n    return;\n  }\n\n  // Object-form audio is not supported for the speech endpoint — reject early\n  if (typeof response.audio !== \"string\") {\n    journal.add({\n      method,\n      path,\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            \"Object-form audio not supported for speech endpoint. Use string-form: { audio: '<base64>' }\",\n          type: \"server_error\",\n        },\n      }),\n    );\n    return;\n  }\n\n  journal.add({\n    method,\n    path,\n    headers: flattenHeaders(req.headers),\n    body: syntheticReq,\n    response: { status: 200, fixture },\n  });\n\n  const format = response.format ?? \"mp3\";\n  const contentType = FORMAT_TO_CONTENT_TYPE[format] ?? \"audio/mpeg\";\n  const audioBytes = Buffer.from(response.audio, \"base64\");\n\n  res.writeHead(200, { \"Content-Type\": contentType });\n  res.end(audioBytes);\n}\n"],"mappings":"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"}
+{"version":3,"file":"speech.cjs","names":["flattenHeaders","renderError","isJsonObject","getContext","getTestId","matchFixtureDiagnostic","applyChaosAsync","resolveRequestDecisions","strictNoMatchMessage","strictNoMatchLogLine","strictOverrideField","proxyAndRecord","resolveResponse","isErrorResponse","isAudioResponse","FORMAT_TO_CONTENT_TYPE"],"sources":["../src/speech.ts"],"sourcesContent":["import { renderError } from \"./response/errors.js\";\nimport { resolveRequestDecisions, strictOverrideField } from \"./response/policy.js\";\nimport type * as http from \"node:http\";\nimport type { ChatCompletionRequest, Fixture, HandlerDefaults } from \"./types.js\";\nimport {\n  isAudioResponse,\n  isErrorResponse,\n  isJsonObject,\n  flattenHeaders,\n  getTestId,\n  FORMAT_TO_CONTENT_TYPE,\n  resolveResponse,\n  getContext,\n  strictNoMatchMessage,\n  strictNoMatchLogLine,\n} from \"./helpers.js\";\nimport { matchFixtureDiagnostic } 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\ninterface SpeechRequest {\n  model?: string;\n  input: string;\n  voice?: string;\n  response_format?: string;\n  speed?: number;\n  [key: string]: unknown;\n}\n\nexport async function handleSpeech(\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): Promise<void> {\n  setCorsHeaders(res);\n  const path = req.url ?? \"/v1/audio/speech\";\n  const method = req.method ?? \"POST\";\n\n  let speechReq: SpeechRequest;\n  try {\n    speechReq = JSON.parse(raw) as SpeechRequest;\n  } catch (parseErr) {\n    const detail = parseErr instanceof Error ? parseErr.message : \"unknown\";\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      renderError(\"openai\", \"validation\", {\n        message: `Malformed JSON: ${detail}`,\n        type: \"invalid_request_error\",\n        code: \"invalid_json\",\n      }).body,\n    );\n    return;\n  }\n\n  // Reject bodies that parsed but are not a JSON object (e.g. `null`) before\n  // touching fields — otherwise `speechReq.input` throws a TypeError that\n  // surfaces as a 500 instead of a 400.\n  if (!isJsonObject(speechReq)) {\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      renderError(\"openai\", \"validation\", {\n        message: \"Request body must be a JSON object\",\n        type: \"invalid_request_error\",\n      }).body,\n    );\n    return;\n  }\n\n  const input: unknown = speechReq.input;\n  const validInput =\n    typeof input === \"string\" ||\n    (Array.isArray(input) &&\n      input.length > 0 &&\n      input.every(\n        (part: unknown) =>\n          isJsonObject(part) &&\n          typeof part.type === \"string\" &&\n          (!(\"text\" in part) || typeof part.text === \"string\"),\n      ));\n  if (!input || !validInput) {\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      renderError(\"openai\", \"validation\", {\n        message: !input\n          ? \"Missing required parameter: 'input'\"\n          : \"Invalid parameter: 'input' must be a string or a nonempty array of content parts\",\n        type: \"invalid_request_error\",\n      }).body,\n    );\n    return;\n  }\n\n  const syntheticReq: ChatCompletionRequest = {\n    model: speechReq.model ?? \"tts-1\",\n    messages: [{ role: \"user\", content: speechReq.input }],\n    _endpointType: \"speech\",\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    defaults.logger.debug(`Fixture matched: ${JSON.stringify(fixture.match).slice(0, 120)}`);\n  } else {\n    defaults.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      { method, path, headers: flattenHeaders(req.headers), body: syntheticReq },\n      fixture ? \"fixture\" : \"proxy\",\n      defaults.registry,\n      defaults.logger,\n    )\n  )\n    return;\n\n  if (!fixture) {\n    const effectiveStrict = resolveRequestDecisions(defaults.strict, req.headers).fixtureMiss;\n    if (effectiveStrict) {\n      const strictMessage = strictNoMatchMessage(skippedBySequenceOrTurn);\n      defaults.logger.error(strictNoMatchLogLine(method, path, skippedBySequenceOrTurn));\n      journal.add({\n        method,\n        path,\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        renderError(\"openai\", \"strict-miss\", {\n          message: strictMessage,\n          type: \"invalid_request_error\",\n          code: \"no_fixture_match\",\n        }).body,\n      );\n      return;\n    }\n    if (defaults.record) {\n      const outcome = await proxyAndRecord(\n        req,\n        res,\n        syntheticReq,\n        \"openai\",\n        req.url ?? \"/v1/audio/speech\",\n        fixtures,\n        defaults,\n        raw,\n      );\n      if (outcome === \"handled_by_hook\") return;\n      if (outcome !== \"not_configured\") {\n        journal.add({\n          method,\n          path,\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    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      body: syntheticReq,\n      response: {\n        status: 404,\n        fixture: null,\n        ...strictOverrideField(defaults.strict, req.headers),\n      },\n    });\n    writeErrorResponse(\n      res,\n      404,\n      renderError(\"openai\", \"fixture-miss\", {\n        message: \"No fixture matched\",\n        type: \"invalid_request_error\",\n        code: \"no_fixture_match\",\n      }).body,\n    );\n    return;\n  }\n\n  const response = await resolveResponse(fixture, syntheticReq);\n\n  if (isErrorResponse(response)) {\n    const status = response.status ?? 500;\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      body: syntheticReq,\n      response: { status, fixture },\n    });\n    writeErrorResponse(res, status, renderError(\"openai\", \"fixture\", response.error).body, {\n      retryAfter: response.retryAfter,\n    });\n    return;\n  }\n\n  if (!isAudioResponse(response)) {\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      body: syntheticReq,\n      response: { status: 500, fixture },\n    });\n    writeErrorResponse(\n      res,\n      500,\n      renderError(\"openai\", \"unknown-response\", {\n        message: \"Fixture response is not an audio type\",\n        type: \"server_error\",\n      }).body,\n    );\n    return;\n  }\n\n  // Object-form audio is not supported for the speech endpoint — reject early\n  if (typeof response.audio !== \"string\") {\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      body: syntheticReq,\n      response: { status: 500, fixture },\n    });\n    writeErrorResponse(\n      res,\n      500,\n      renderError(\"openai\", \"unknown-response\", {\n        message:\n          \"Object-form audio not supported for speech endpoint. Use string-form: { audio: '<base64>' }\",\n        type: \"server_error\",\n      }).body,\n    );\n    return;\n  }\n\n  journal.add({\n    method,\n    path,\n    headers: flattenHeaders(req.headers),\n    body: syntheticReq,\n    response: { status: 200, fixture },\n  });\n\n  const format = response.format ?? \"mp3\";\n  const contentType = FORMAT_TO_CONTENT_TYPE[format] ?? \"audio/mpeg\";\n  const audioBytes = Buffer.from(response.audio, \"base64\");\n\n  res.writeHead(200, { \"Content-Type\": contentType });\n  res.end(audioBytes);\n}\n"],"mappings":"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"}

package/dist/speech.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"speech.d.cts","names":[],"sources":["../src/speech.ts"],"sourcesContent":[],"mappings":";;;;;iBAgCsB,YAAA,MACf,MAAA,CAAK,sBACL,MAAA,CAAK,uCAEA,oBACD,mBACC,uCACY,MAAA,CAAK,0BAC1B"}
+{"version":3,"file":"speech.d.cts","names":[],"sources":["../src/speech.ts"],"sourcesContent":[],"mappings":";;;;;iBA+BsB,YAAA,MACf,MAAA,CAAK,sBACL,MAAA,CAAK,uCAEA,oBACD,mBACC,uCACY,MAAA,CAAK,0BAC1B"}

package/dist/speech.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"speech.d.ts","names":[],"sources":["../src/speech.ts"],"sourcesContent":[],"mappings":";;;;;iBAgCsB,YAAA,MACf,MAAA,CAAK,sBACL,MAAA,CAAK,uCAEA,oBACD,mBACC,uCACY,MAAA,CAAK,0BAC1B"}
+{"version":3,"file":"speech.d.ts","names":[],"sources":["../src/speech.ts"],"sourcesContent":[],"mappings":";;;;;iBA+BsB,YAAA,MACf,MAAA,CAAK,sBACL,MAAA,CAAK,uCAEA,oBACD,mBACC,uCACY,MAAA,CAAK,0BAC1B"}

package/dist/speech.js

@@ -1,4 +1,6 @@
-import { FORMAT_TO_CONTENT_TYPE, flattenHeaders, getContext, getTestId, isAudioResponse, isErrorResponse, isJsonObject, resolveResponse, resolveStrictMode, serializeErrorResponse, strictNoMatchLogLine, strictNoMatchMessage, strictOverrideField } from "./helpers.js";
+import { renderError } from "./response/errors.js";
+import { resolveRequestDecisions, strictOverrideField } from "./response/policy.js";
+import { FORMAT_TO_CONTENT_TYPE, flattenHeaders, getContext, getTestId, isAudioResponse, isErrorResponse, isJsonObject, resolveResponse, strictNoMatchLogLine, strictNoMatchMessage } from "./helpers.js";
 import { writeErrorResponse } from "./sse-writer.js";
 import { applyChaosAsync } from "./chaos.js";
 import { matchFixtureDiagnostic } from "./router.js";
@@ -24,11 +26,11 @@ async function handleSpeech(req, res, raw, fixtures, journal, defaults, setCorsH
 				fixture: null
 			}
 		});
-		writeErrorResponse(res, 400, JSON.stringify({ error: {
+		writeErrorResponse(res, 400, renderError("openai", "validation", {
 			message: `Malformed JSON: ${detail}`,
 			type: "invalid_request_error",
 			code: "invalid_json"
-		} }));
+		}).body);
 		return;
 	}
 	if (!isJsonObject(speechReq)) {
@@ -42,10 +44,10 @@ async function handleSpeech(req, res, raw, fixtures, journal, defaults, setCorsH
 				fixture: null
 			}
 		});
-		writeErrorResponse(res, 400, JSON.stringify({ error: {
+		writeErrorResponse(res, 400, renderError("openai", "validation", {
 			message: "Request body must be a JSON object",
 			type: "invalid_request_error"
-		} }));
+		}).body);
 		return;
 	}
 	const input = speechReq.input;
@@ -61,10 +63,10 @@ async function handleSpeech(req, res, raw, fixtures, journal, defaults, setCorsH
 				fixture: null
 			}
 		});
-		writeErrorResponse(res, 400, JSON.stringify({ error: {
+		writeErrorResponse(res, 400, renderError("openai", "validation", {
 			message: !input ? "Missing required parameter: 'input'" : "Invalid parameter: 'input' must be a string or a nonempty array of content parts",
 			type: "invalid_request_error"
-		} }));
+		}).body);
 		return;
 	}
 	const syntheticReq = {
@@ -89,7 +91,7 @@ async function handleSpeech(req, res, raw, fixtures, journal, defaults, setCorsH
 		body: syntheticReq
 	}, fixture ? "fixture" : "proxy", defaults.registry, defaults.logger)) return;
 	if (!fixture) {
-		if (resolveStrictMode(defaults.strict, req.headers)) {
+		if (resolveRequestDecisions(defaults.strict, req.headers).fixtureMiss) {
 			const strictMessage = strictNoMatchMessage(skippedBySequenceOrTurn);
 			defaults.logger.error(strictNoMatchLogLine(method, path, skippedBySequenceOrTurn));
 			journal.add({
@@ -103,11 +105,11 @@ async function handleSpeech(req, res, raw, fixtures, journal, defaults, setCorsH
 					...strictOverrideField(defaults.strict, req.headers)
 				}
 			});
-			writeErrorResponse(res, 503, JSON.stringify({ error: {
+			writeErrorResponse(res, 503, renderError("openai", "strict-miss", {
 				message: strictMessage,
 				type: "invalid_request_error",
 				code: "no_fixture_match"
-			} }));
+			}).body);
 			return;
 		}
 		if (defaults.record) {
@@ -139,11 +141,11 @@ async function handleSpeech(req, res, raw, fixtures, journal, defaults, setCorsH
 				...strictOverrideField(defaults.strict, req.headers)
 			}
 		});
-		writeErrorResponse(res, 404, JSON.stringify({ error: {
+		writeErrorResponse(res, 404, renderError("openai", "fixture-miss", {
 			message: "No fixture matched",
 			type: "invalid_request_error",
 			code: "no_fixture_match"
-		} }));
+		}).body);
 		return;
 	}
 	const response = await resolveResponse(fixture, syntheticReq);
@@ -159,7 +161,7 @@ async function handleSpeech(req, res, raw, fixtures, journal, defaults, setCorsH
 				fixture
 			}
 		});
-		writeErrorResponse(res, status, serializeErrorResponse(response), { retryAfter: response.retryAfter });
+		writeErrorResponse(res, status, renderError("openai", "fixture", response.error).body, { retryAfter: response.retryAfter });
 		return;
 	}
 	if (!isAudioResponse(response)) {
@@ -173,10 +175,10 @@ async function handleSpeech(req, res, raw, fixtures, journal, defaults, setCorsH
 				fixture
 			}
 		});
-		writeErrorResponse(res, 500, JSON.stringify({ error: {
+		writeErrorResponse(res, 500, renderError("openai", "unknown-response", {
 			message: "Fixture response is not an audio type",
 			type: "server_error"
-		} }));
+		}).body);
 		return;
 	}
 	if (typeof response.audio !== "string") {
@@ -190,10 +192,10 @@ async function handleSpeech(req, res, raw, fixtures, journal, defaults, setCorsH
 				fixture
 			}
 		});
-		writeErrorResponse(res, 500, JSON.stringify({ error: {
+		writeErrorResponse(res, 500, renderError("openai", "unknown-response", {
 			message: "Object-form audio not supported for speech endpoint. Use string-form: { audio: '<base64>' }",
 			type: "server_error"
-		} }));
+		}).body);
 		return;
 	}
 	journal.add({

package/dist/speech.js.map

@@ -1 +1 @@
-{"version":3,"file":"speech.js","names":[],"sources":["../src/speech.ts"],"sourcesContent":["import type * as http from \"node:http\";\nimport type { ChatCompletionRequest, Fixture, HandlerDefaults } from \"./types.js\";\nimport {\n  isAudioResponse,\n  isErrorResponse,\n  isJsonObject,\n  serializeErrorResponse,\n  flattenHeaders,\n  getTestId,\n  FORMAT_TO_CONTENT_TYPE,\n  resolveResponse,\n  resolveStrictMode,\n  strictOverrideField,\n  getContext,\n  strictNoMatchMessage,\n  strictNoMatchLogLine,\n} from \"./helpers.js\";\nimport { matchFixtureDiagnostic } 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\ninterface SpeechRequest {\n  model?: string;\n  input: string;\n  voice?: string;\n  response_format?: string;\n  speed?: number;\n  [key: string]: unknown;\n}\n\nexport async function handleSpeech(\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): Promise<void> {\n  setCorsHeaders(res);\n  const path = req.url ?? \"/v1/audio/speech\";\n  const method = req.method ?? \"POST\";\n\n  let speechReq: SpeechRequest;\n  try {\n    speechReq = JSON.parse(raw) as SpeechRequest;\n  } catch (parseErr) {\n    const detail = parseErr instanceof Error ? parseErr.message : \"unknown\";\n    journal.add({\n      method,\n      path,\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: ${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 `speechReq.input` throws a TypeError that\n  // surfaces as a 500 instead of a 400.\n  if (!isJsonObject(speechReq)) {\n    journal.add({\n      method,\n      path,\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  const input: unknown = speechReq.input;\n  const validInput =\n    typeof input === \"string\" ||\n    (Array.isArray(input) &&\n      input.length > 0 &&\n      input.every(\n        (part: unknown) =>\n          isJsonObject(part) &&\n          typeof part.type === \"string\" &&\n          (!(\"text\" in part) || typeof part.text === \"string\"),\n      ));\n  if (!input || !validInput) {\n    journal.add({\n      method,\n      path,\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: !input\n            ? \"Missing required parameter: 'input'\"\n            : \"Invalid parameter: 'input' must be a string or a nonempty array of content parts\",\n          type: \"invalid_request_error\",\n        },\n      }),\n    );\n    return;\n  }\n\n  const syntheticReq: ChatCompletionRequest = {\n    model: speechReq.model ?? \"tts-1\",\n    messages: [{ role: \"user\", content: speechReq.input }],\n    _endpointType: \"speech\",\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    defaults.logger.debug(`Fixture matched: ${JSON.stringify(fixture.match).slice(0, 120)}`);\n  } else {\n    defaults.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      { method, path, headers: flattenHeaders(req.headers), body: syntheticReq },\n      fixture ? \"fixture\" : \"proxy\",\n      defaults.registry,\n      defaults.logger,\n    )\n  )\n    return;\n\n  if (!fixture) {\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      journal.add({\n        method,\n        path,\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    if (defaults.record) {\n      const outcome = await proxyAndRecord(\n        req,\n        res,\n        syntheticReq,\n        \"openai\",\n        req.url ?? \"/v1/audio/speech\",\n        fixtures,\n        defaults,\n        raw,\n      );\n      if (outcome === \"handled_by_hook\") return;\n      if (outcome !== \"not_configured\") {\n        journal.add({\n          method,\n          path,\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    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      body: syntheticReq,\n      response: {\n        status: 404,\n        fixture: null,\n        ...strictOverrideField(defaults.strict, req.headers),\n      },\n    });\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    return;\n  }\n\n  const response = await resolveResponse(fixture, syntheticReq);\n\n  if (isErrorResponse(response)) {\n    const status = response.status ?? 500;\n    journal.add({\n      method,\n      path,\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  if (!isAudioResponse(response)) {\n    journal.add({\n      method,\n      path,\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: { message: \"Fixture response is not an audio type\", type: \"server_error\" },\n      }),\n    );\n    return;\n  }\n\n  // Object-form audio is not supported for the speech endpoint — reject early\n  if (typeof response.audio !== \"string\") {\n    journal.add({\n      method,\n      path,\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            \"Object-form audio not supported for speech endpoint. Use string-form: { audio: '<base64>' }\",\n          type: \"server_error\",\n        },\n      }),\n    );\n    return;\n  }\n\n  journal.add({\n    method,\n    path,\n    headers: flattenHeaders(req.headers),\n    body: syntheticReq,\n    response: { status: 200, fixture },\n  });\n\n  const format = response.format ?? \"mp3\";\n  const contentType = FORMAT_TO_CONTENT_TYPE[format] ?? \"audio/mpeg\";\n  const audioBytes = Buffer.from(response.audio, \"base64\");\n\n  res.writeHead(200, { \"Content-Type\": contentType });\n  res.end(audioBytes);\n}\n"],"mappings":"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"}
+{"version":3,"file":"speech.js","names":[],"sources":["../src/speech.ts"],"sourcesContent":["import { renderError } from \"./response/errors.js\";\nimport { resolveRequestDecisions, strictOverrideField } from \"./response/policy.js\";\nimport type * as http from \"node:http\";\nimport type { ChatCompletionRequest, Fixture, HandlerDefaults } from \"./types.js\";\nimport {\n  isAudioResponse,\n  isErrorResponse,\n  isJsonObject,\n  flattenHeaders,\n  getTestId,\n  FORMAT_TO_CONTENT_TYPE,\n  resolveResponse,\n  getContext,\n  strictNoMatchMessage,\n  strictNoMatchLogLine,\n} from \"./helpers.js\";\nimport { matchFixtureDiagnostic } 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\ninterface SpeechRequest {\n  model?: string;\n  input: string;\n  voice?: string;\n  response_format?: string;\n  speed?: number;\n  [key: string]: unknown;\n}\n\nexport async function handleSpeech(\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): Promise<void> {\n  setCorsHeaders(res);\n  const path = req.url ?? \"/v1/audio/speech\";\n  const method = req.method ?? \"POST\";\n\n  let speechReq: SpeechRequest;\n  try {\n    speechReq = JSON.parse(raw) as SpeechRequest;\n  } catch (parseErr) {\n    const detail = parseErr instanceof Error ? parseErr.message : \"unknown\";\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      renderError(\"openai\", \"validation\", {\n        message: `Malformed JSON: ${detail}`,\n        type: \"invalid_request_error\",\n        code: \"invalid_json\",\n      }).body,\n    );\n    return;\n  }\n\n  // Reject bodies that parsed but are not a JSON object (e.g. `null`) before\n  // touching fields — otherwise `speechReq.input` throws a TypeError that\n  // surfaces as a 500 instead of a 400.\n  if (!isJsonObject(speechReq)) {\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      renderError(\"openai\", \"validation\", {\n        message: \"Request body must be a JSON object\",\n        type: \"invalid_request_error\",\n      }).body,\n    );\n    return;\n  }\n\n  const input: unknown = speechReq.input;\n  const validInput =\n    typeof input === \"string\" ||\n    (Array.isArray(input) &&\n      input.length > 0 &&\n      input.every(\n        (part: unknown) =>\n          isJsonObject(part) &&\n          typeof part.type === \"string\" &&\n          (!(\"text\" in part) || typeof part.text === \"string\"),\n      ));\n  if (!input || !validInput) {\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      body: null,\n      response: { status: 400, fixture: null },\n    });\n    writeErrorResponse(\n      res,\n      400,\n      renderError(\"openai\", \"validation\", {\n        message: !input\n          ? \"Missing required parameter: 'input'\"\n          : \"Invalid parameter: 'input' must be a string or a nonempty array of content parts\",\n        type: \"invalid_request_error\",\n      }).body,\n    );\n    return;\n  }\n\n  const syntheticReq: ChatCompletionRequest = {\n    model: speechReq.model ?? \"tts-1\",\n    messages: [{ role: \"user\", content: speechReq.input }],\n    _endpointType: \"speech\",\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    defaults.logger.debug(`Fixture matched: ${JSON.stringify(fixture.match).slice(0, 120)}`);\n  } else {\n    defaults.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      { method, path, headers: flattenHeaders(req.headers), body: syntheticReq },\n      fixture ? \"fixture\" : \"proxy\",\n      defaults.registry,\n      defaults.logger,\n    )\n  )\n    return;\n\n  if (!fixture) {\n    const effectiveStrict = resolveRequestDecisions(defaults.strict, req.headers).fixtureMiss;\n    if (effectiveStrict) {\n      const strictMessage = strictNoMatchMessage(skippedBySequenceOrTurn);\n      defaults.logger.error(strictNoMatchLogLine(method, path, skippedBySequenceOrTurn));\n      journal.add({\n        method,\n        path,\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        renderError(\"openai\", \"strict-miss\", {\n          message: strictMessage,\n          type: \"invalid_request_error\",\n          code: \"no_fixture_match\",\n        }).body,\n      );\n      return;\n    }\n    if (defaults.record) {\n      const outcome = await proxyAndRecord(\n        req,\n        res,\n        syntheticReq,\n        \"openai\",\n        req.url ?? \"/v1/audio/speech\",\n        fixtures,\n        defaults,\n        raw,\n      );\n      if (outcome === \"handled_by_hook\") return;\n      if (outcome !== \"not_configured\") {\n        journal.add({\n          method,\n          path,\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    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      body: syntheticReq,\n      response: {\n        status: 404,\n        fixture: null,\n        ...strictOverrideField(defaults.strict, req.headers),\n      },\n    });\n    writeErrorResponse(\n      res,\n      404,\n      renderError(\"openai\", \"fixture-miss\", {\n        message: \"No fixture matched\",\n        type: \"invalid_request_error\",\n        code: \"no_fixture_match\",\n      }).body,\n    );\n    return;\n  }\n\n  const response = await resolveResponse(fixture, syntheticReq);\n\n  if (isErrorResponse(response)) {\n    const status = response.status ?? 500;\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      body: syntheticReq,\n      response: { status, fixture },\n    });\n    writeErrorResponse(res, status, renderError(\"openai\", \"fixture\", response.error).body, {\n      retryAfter: response.retryAfter,\n    });\n    return;\n  }\n\n  if (!isAudioResponse(response)) {\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      body: syntheticReq,\n      response: { status: 500, fixture },\n    });\n    writeErrorResponse(\n      res,\n      500,\n      renderError(\"openai\", \"unknown-response\", {\n        message: \"Fixture response is not an audio type\",\n        type: \"server_error\",\n      }).body,\n    );\n    return;\n  }\n\n  // Object-form audio is not supported for the speech endpoint — reject early\n  if (typeof response.audio !== \"string\") {\n    journal.add({\n      method,\n      path,\n      headers: flattenHeaders(req.headers),\n      body: syntheticReq,\n      response: { status: 500, fixture },\n    });\n    writeErrorResponse(\n      res,\n      500,\n      renderError(\"openai\", \"unknown-response\", {\n        message:\n          \"Object-form audio not supported for speech endpoint. Use string-form: { audio: '<base64>' }\",\n        type: \"server_error\",\n      }).body,\n    );\n    return;\n  }\n\n  journal.add({\n    method,\n    path,\n    headers: flattenHeaders(req.headers),\n    body: syntheticReq,\n    response: { status: 200, fixture },\n  });\n\n  const format = response.format ?? \"mp3\";\n  const contentType = FORMAT_TO_CONTENT_TYPE[format] ?? \"audio/mpeg\";\n  const audioBytes = Buffer.from(response.audio, \"base64\");\n\n  res.writeHead(200, { \"Content-Type\": contentType });\n  res.end(audioBytes);\n}\n"],"mappings":"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"}

package/dist/sse-writer.cjs

@@ -40,6 +40,12 @@ function calculateDelay(chunkIndex, profile, fallbackLatency, recordedTimings, r
 	delayMs = Math.max(0, delayMs);
 	return speed > 0 ? delayMs / speed : delayMs;
 }
+function calculateTotalDelay(contentLength, chunkSize, profile, recordedTimings, replaySpeed) {
+	const chunkCount = Math.max(1, Math.ceil(contentLength / chunkSize));
+	let total = 0;
+	for (let chunkIndex = 0; chunkIndex < chunkCount; chunkIndex++) total += calculateDelay(chunkIndex, profile, void 0, recordedTimings, replaySpeed);
+	return total;
+}
 async function writeSSEStream(res, chunks, optionsOrLatency) {
 	const opts = typeof optionsOrLatency === "number" ? { latency: optionsOrLatency } : optionsOrLatency ?? {};
 	const latency = opts.latency ?? 0;
@@ -94,6 +100,7 @@ function writeErrorResponse(res, status, body, options) {
 
 //#endregion
 exports.calculateDelay = calculateDelay;
+exports.calculateTotalDelay = calculateTotalDelay;
 exports.delay = delay;
 exports.writeErrorResponse = writeErrorResponse;
 exports.writeSSEStream = writeSSEStream;

package/dist/sse-writer.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"sse-writer.cjs","names":[],"sources":["../src/sse-writer.ts"],"sourcesContent":["import type * as http from \"node:http\";\nimport type { SSEChunk, StreamingProfile, RecordedTimings } from \"./types.js\";\n\nexport function delay(ms: number, signal?: AbortSignal): Promise<void> {\n  if (ms <= 0 || signal?.aborted) return Promise.resolve();\n  return new Promise((resolve) => {\n    const timer = setTimeout(resolve, ms);\n    signal?.addEventListener(\n      \"abort\",\n      () => {\n        clearTimeout(timer);\n        resolve();\n      },\n      { once: true },\n    );\n  });\n}\n\nexport interface StreamOptions {\n  latency?: number;\n  streamingProfile?: StreamingProfile;\n  recordedTimings?: RecordedTimings;\n  replaySpeed?: number;\n  signal?: AbortSignal;\n  onChunkSent?: () => void;\n  /** When set, emitted as the final chunk before [DONE] (OpenAI stream_options.include_usage). */\n  usageChunk?: SSEChunk;\n  /**\n   * When true, a single OpenRouter `: OPENROUTER PROCESSING` SSE comment\n   * (keepalive) line is emitted FIRST — before the first data chunk — matching\n   * real OpenRouter bytes (or-capture/chat-stream.sse). A faithful client skips\n   * `:`-prefixed lines; opt-in, default off (so strict OpenAI parsers aren't\n   * surprised). Used only by the OpenRouter chat surface.\n   */\n  openRouterProcessing?: boolean;\n}\n\n/** OpenRouter's SSE keepalive comment line (colon-prefixed, per SSE syntax). */\nconst OPENROUTER_PROCESSING_COMMENT = \": OPENROUTER PROCESSING\\n\\n\";\n\nexport function calculateDelay(\n  chunkIndex: number,\n  profile?: StreamingProfile,\n  fallbackLatency?: number,\n  recordedTimings?: RecordedTimings,\n  replaySpeed?: number,\n): number {\n  const speed = replaySpeed ?? 1.0;\n  let delayMs: number;\n\n  if (profile) {\n    // StreamingProfile has highest precedence\n    let fromProfile = true;\n    if (chunkIndex === 0 && profile.ttft !== undefined) {\n      delayMs = profile.ttft;\n    } else if (profile.tps !== undefined && profile.tps > 0) {\n      delayMs = 1000 / profile.tps;\n    } else {\n      delayMs = fallbackLatency ?? 0;\n      fromProfile = false;\n    }\n    // Jitter only applies when the delay came from ttft/tps, not fallback\n    if (fromProfile && profile.jitter && profile.jitter > 0) {\n      delayMs *= 1 + (Math.random() * 2 - 1) * profile.jitter;\n      if (delayMs < 0) delayMs = 0;\n    }\n  } else if (recordedTimings) {\n    // Recorded timings (second precedence)\n    if (chunkIndex === 0) {\n      delayMs = recordedTimings.ttftMs;\n    } else {\n      const idx = chunkIndex - 1;\n      if (idx < recordedTimings.interChunkDelaysMs.length) {\n        delayMs = recordedTimings.interChunkDelaysMs[idx];\n      } else {\n        // Excess chunks: derive average from recorded inter-chunk delays\n        const totalInterChunk = recordedTimings.interChunkDelaysMs.reduce((a, b) => a + b, 0);\n        delayMs =\n          recordedTimings.interChunkDelaysMs.length > 0\n            ? totalInterChunk / recordedTimings.interChunkDelaysMs.length\n            : 0;\n      }\n    }\n  } else {\n    delayMs = fallbackLatency ?? 0;\n  }\n\n  delayMs = Math.max(0, delayMs);\n  return speed > 0 ? delayMs / speed : delayMs;\n}\n\nexport async function writeSSEStream(\n  res: http.ServerResponse,\n  chunks: SSEChunk[],\n  optionsOrLatency?: number | StreamOptions,\n): Promise<boolean> {\n  const opts: StreamOptions =\n    typeof optionsOrLatency === \"number\" ? { latency: optionsOrLatency } : (optionsOrLatency ?? {});\n  const latency = opts.latency ?? 0;\n  const profile = opts.streamingProfile;\n  const { recordedTimings, replaySpeed } = opts;\n  const signal = opts.signal;\n  const onChunkSent = opts.onChunkSent;\n\n  if (res.writableEnded) return true;\n  res.setHeader(\"Content-Type\", \"text/event-stream\");\n  res.setHeader(\"Cache-Control\", \"no-cache\");\n  res.setHeader(\"Connection\", \"keep-alive\");\n\n  // OpenRouter emits exactly ONE `: OPENROUTER PROCESSING` keepalive comment\n  // first — before any data frame (opt-in; see or-capture/chat-stream.sse). A\n  // faithful client discards `:`-prefixed lines before JSON-parsing a `data:`.\n  if (opts.openRouterProcessing && !res.writableEnded) {\n    res.write(OPENROUTER_PROCESSING_COMMENT);\n  }\n\n  let chunkIndex = 0;\n  for (const chunk of chunks) {\n    const chunkDelay = calculateDelay(chunkIndex, profile, latency, recordedTimings, replaySpeed);\n    if (chunkDelay > 0) {\n      await delay(chunkDelay, signal);\n    }\n    if (signal?.aborted) return false;\n    if (res.writableEnded) return true;\n    res.write(`data: ${JSON.stringify(chunk)}\\n\\n`);\n    onChunkSent?.();\n    if (signal?.aborted) return false;\n    chunkIndex++;\n  }\n\n  if (!res.writableEnded) {\n    if (opts.usageChunk) {\n      res.write(`data: ${JSON.stringify(opts.usageChunk)}\\n\\n`);\n    }\n    res.write(\"data: [DONE]\\n\\n\");\n    res.end();\n  }\n  return true;\n}\n\n/**\n * Default rate-limit response headers matching OpenAI's format.\n * Values are static — aimock doesn't track actual request counts.\n */\nconst RATE_LIMIT_HEADERS: Record<string, string> = {\n  \"x-ratelimit-limit-requests\": \"60\",\n  \"x-ratelimit-limit-tokens\": \"150000\",\n  \"x-ratelimit-remaining-requests\": \"0\",\n  \"x-ratelimit-remaining-tokens\": \"0\",\n  \"x-ratelimit-reset-requests\": \"1s\",\n  \"x-ratelimit-reset-tokens\": \"6m0s\",\n};\n\nexport interface ErrorResponseOptions {\n  /** Override the Retry-After header value (seconds). Default: 1. Only applied on 429. */\n  retryAfter?: number;\n}\n\nexport function writeErrorResponse(\n  res: http.ServerResponse,\n  status: number,\n  body: string,\n  options?: ErrorResponseOptions,\n): void {\n  const headers: Record<string, string> = { \"Content-Type\": \"application/json\" };\n  if (status === 429) {\n    headers[\"Retry-After\"] = String(options?.retryAfter ?? 1);\n    Object.assign(headers, RATE_LIMIT_HEADERS);\n  }\n  res.writeHead(status, headers);\n  res.end(body);\n}\n"],"mappings":";;AAGA,SAAgB,MAAM,IAAY,QAAqC;AACrE,KAAI,MAAM,KAAK,QAAQ,QAAS,QAAO,QAAQ,SAAS;AACxD,QAAO,IAAI,SAAS,YAAY;EAC9B,MAAM,QAAQ,WAAW,SAAS,GAAG;AACrC,UAAQ,iBACN,eACM;AACJ,gBAAa,MAAM;AACnB,YAAS;KAEX,EAAE,MAAM,MAAM,CACf;GACD;;;AAuBJ,MAAM,gCAAgC;AAEtC,SAAgB,eACd,YACA,SACA,iBACA,iBACA,aACQ;CACR,MAAM,QAAQ,eAAe;CAC7B,IAAI;AAEJ,KAAI,SAAS;EAEX,IAAI,cAAc;AAClB,MAAI,eAAe,KAAK,QAAQ,SAAS,OACvC,WAAU,QAAQ;WACT,QAAQ,QAAQ,UAAa,QAAQ,MAAM,EACpD,WAAU,MAAO,QAAQ;OACpB;AACL,aAAU,mBAAmB;AAC7B,iBAAc;;AAGhB,MAAI,eAAe,QAAQ,UAAU,QAAQ,SAAS,GAAG;AACvD,cAAW,KAAK,KAAK,QAAQ,GAAG,IAAI,KAAK,QAAQ;AACjD,OAAI,UAAU,EAAG,WAAU;;YAEpB,gBAET,KAAI,eAAe,EACjB,WAAU,gBAAgB;MACrB;EACL,MAAM,MAAM,aAAa;AACzB,MAAI,MAAM,gBAAgB,mBAAmB,OAC3C,WAAU,gBAAgB,mBAAmB;OACxC;GAEL,MAAM,kBAAkB,gBAAgB,mBAAmB,QAAQ,GAAG,MAAM,IAAI,GAAG,EAAE;AACrF,aACE,gBAAgB,mBAAmB,SAAS,IACxC,kBAAkB,gBAAgB,mBAAmB,SACrD;;;KAIV,WAAU,mBAAmB;AAG/B,WAAU,KAAK,IAAI,GAAG,QAAQ;AAC9B,QAAO,QAAQ,IAAI,UAAU,QAAQ;;AAGvC,eAAsB,eACpB,KACA,QACA,kBACkB;CAClB,MAAM,OACJ,OAAO,qBAAqB,WAAW,EAAE,SAAS,kBAAkB,GAAI,oBAAoB,EAAE;CAChG,MAAM,UAAU,KAAK,WAAW;CAChC,MAAM,UAAU,KAAK;CACrB,MAAM,EAAE,iBAAiB,gBAAgB;CACzC,MAAM,SAAS,KAAK;CACpB,MAAM,cAAc,KAAK;AAEzB,KAAI,IAAI,cAAe,QAAO;AAC9B,KAAI,UAAU,gBAAgB,oBAAoB;AAClD,KAAI,UAAU,iBAAiB,WAAW;AAC1C,KAAI,UAAU,cAAc,aAAa;AAKzC,KAAI,KAAK,wBAAwB,CAAC,IAAI,cACpC,KAAI,MAAM,8BAA8B;CAG1C,IAAI,aAAa;AACjB,MAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,aAAa,eAAe,YAAY,SAAS,SAAS,iBAAiB,YAAY;AAC7F,MAAI,aAAa,EACf,OAAM,MAAM,YAAY,OAAO;AAEjC,MAAI,QAAQ,QAAS,QAAO;AAC5B,MAAI,IAAI,cAAe,QAAO;AAC9B,MAAI,MAAM,SAAS,KAAK,UAAU,MAAM,CAAC,MAAM;AAC/C,iBAAe;AACf,MAAI,QAAQ,QAAS,QAAO;AAC5B;;AAGF,KAAI,CAAC,IAAI,eAAe;AACtB,MAAI,KAAK,WACP,KAAI,MAAM,SAAS,KAAK,UAAU,KAAK,WAAW,CAAC,MAAM;AAE3D,MAAI,MAAM,mBAAmB;AAC7B,MAAI,KAAK;;AAEX,QAAO;;;;;;AAOT,MAAM,qBAA6C;CACjD,8BAA8B;CAC9B,4BAA4B;CAC5B,kCAAkC;CAClC,gCAAgC;CAChC,8BAA8B;CAC9B,4BAA4B;CAC7B;AAOD,SAAgB,mBACd,KACA,QACA,MACA,SACM;CACN,MAAM,UAAkC,EAAE,gBAAgB,oBAAoB;AAC9E,KAAI,WAAW,KAAK;AAClB,UAAQ,iBAAiB,OAAO,SAAS,cAAc,EAAE;AACzD,SAAO,OAAO,SAAS,mBAAmB;;AAE5C,KAAI,UAAU,QAAQ,QAAQ;AAC9B,KAAI,IAAI,KAAK"}
+{"version":3,"file":"sse-writer.cjs","names":[],"sources":["../src/sse-writer.ts"],"sourcesContent":["import type * as http from \"node:http\";\nimport type { SSEChunk, StreamingProfile, RecordedTimings } from \"./types.js\";\n\nexport function delay(ms: number, signal?: AbortSignal): Promise<void> {\n  if (ms <= 0 || signal?.aborted) return Promise.resolve();\n  return new Promise((resolve) => {\n    const timer = setTimeout(resolve, ms);\n    signal?.addEventListener(\n      \"abort\",\n      () => {\n        clearTimeout(timer);\n        resolve();\n      },\n      { once: true },\n    );\n  });\n}\n\nexport interface StreamOptions {\n  latency?: number;\n  streamingProfile?: StreamingProfile;\n  recordedTimings?: RecordedTimings;\n  replaySpeed?: number;\n  signal?: AbortSignal;\n  onChunkSent?: () => void;\n  /** When set, emitted as the final chunk before [DONE] (OpenAI stream_options.include_usage). */\n  usageChunk?: SSEChunk;\n  /**\n   * When true, a single OpenRouter `: OPENROUTER PROCESSING` SSE comment\n   * (keepalive) line is emitted FIRST — before the first data chunk — matching\n   * real OpenRouter bytes (or-capture/chat-stream.sse). A faithful client skips\n   * `:`-prefixed lines; opt-in, default off (so strict OpenAI parsers aren't\n   * surprised). Used only by the OpenRouter chat surface.\n   */\n  openRouterProcessing?: boolean;\n}\n\n/** OpenRouter's SSE keepalive comment line (colon-prefixed, per SSE syntax). */\nconst OPENROUTER_PROCESSING_COMMENT = \": OPENROUTER PROCESSING\\n\\n\";\n\nexport function calculateDelay(\n  chunkIndex: number,\n  profile?: StreamingProfile,\n  fallbackLatency?: number,\n  recordedTimings?: RecordedTimings,\n  replaySpeed?: number,\n): number {\n  const speed = replaySpeed ?? 1.0;\n  let delayMs: number;\n\n  if (profile) {\n    // StreamingProfile has highest precedence\n    let fromProfile = true;\n    if (chunkIndex === 0 && profile.ttft !== undefined) {\n      delayMs = profile.ttft;\n    } else if (profile.tps !== undefined && profile.tps > 0) {\n      delayMs = 1000 / profile.tps;\n    } else {\n      delayMs = fallbackLatency ?? 0;\n      fromProfile = false;\n    }\n    // Jitter only applies when the delay came from ttft/tps, not fallback\n    if (fromProfile && profile.jitter && profile.jitter > 0) {\n      delayMs *= 1 + (Math.random() * 2 - 1) * profile.jitter;\n      if (delayMs < 0) delayMs = 0;\n    }\n  } else if (recordedTimings) {\n    // Recorded timings (second precedence)\n    if (chunkIndex === 0) {\n      delayMs = recordedTimings.ttftMs;\n    } else {\n      const idx = chunkIndex - 1;\n      if (idx < recordedTimings.interChunkDelaysMs.length) {\n        delayMs = recordedTimings.interChunkDelaysMs[idx];\n      } else {\n        // Excess chunks: derive average from recorded inter-chunk delays\n        const totalInterChunk = recordedTimings.interChunkDelaysMs.reduce((a, b) => a + b, 0);\n        delayMs =\n          recordedTimings.interChunkDelaysMs.length > 0\n            ? totalInterChunk / recordedTimings.interChunkDelaysMs.length\n            : 0;\n      }\n    }\n  } else {\n    delayMs = fallbackLatency ?? 0;\n  }\n\n  delayMs = Math.max(0, delayMs);\n  return speed > 0 ? delayMs / speed : delayMs;\n}\n\n// Internal (not part of the public API): the total wait before a non-streaming\n// (`stream: false`) JSON response is written. Sums calculateDelay over the\n// content chunk count that `contentLength` at `chunkSize` would produce, so a\n// fixture with an explicit `streamingProfile` or `recordedTimings` pays roughly\n// the same ttft/tps cost as its streamed content chunks. It is an\n// approximation, not an exact match: a streamed reply also pays delays for its\n// role and finish chunks. There is deliberately no fallback-latency parameter:\n// bare `latency` / `--latency` is an inter-SSE-chunk gap and never delays a\n// non-streaming response. With neither a profile nor recorded timings, this\n// returns 0.\n// Kept as a line comment, not JSDoc: the bundled .d.ts drops this non-public\n// declaration but keeps a JSDoc block, which would then attach to writeSSEStream.\nexport function calculateTotalDelay(\n  contentLength: number,\n  chunkSize: number,\n  profile?: StreamingProfile,\n  recordedTimings?: RecordedTimings,\n  replaySpeed?: number,\n): number {\n  const chunkCount = Math.max(1, Math.ceil(contentLength / chunkSize));\n  let total = 0;\n  for (let chunkIndex = 0; chunkIndex < chunkCount; chunkIndex++) {\n    total += calculateDelay(chunkIndex, profile, undefined, recordedTimings, replaySpeed);\n  }\n  return total;\n}\n\nexport async function writeSSEStream(\n  res: http.ServerResponse,\n  chunks: SSEChunk[],\n  optionsOrLatency?: number | StreamOptions,\n): Promise<boolean> {\n  const opts: StreamOptions =\n    typeof optionsOrLatency === \"number\" ? { latency: optionsOrLatency } : (optionsOrLatency ?? {});\n  const latency = opts.latency ?? 0;\n  const profile = opts.streamingProfile;\n  const { recordedTimings, replaySpeed } = opts;\n  const signal = opts.signal;\n  const onChunkSent = opts.onChunkSent;\n\n  if (res.writableEnded) return true;\n  res.setHeader(\"Content-Type\", \"text/event-stream\");\n  res.setHeader(\"Cache-Control\", \"no-cache\");\n  res.setHeader(\"Connection\", \"keep-alive\");\n\n  // OpenRouter emits exactly ONE `: OPENROUTER PROCESSING` keepalive comment\n  // first — before any data frame (opt-in; see or-capture/chat-stream.sse). A\n  // faithful client discards `:`-prefixed lines before JSON-parsing a `data:`.\n  if (opts.openRouterProcessing && !res.writableEnded) {\n    res.write(OPENROUTER_PROCESSING_COMMENT);\n  }\n\n  let chunkIndex = 0;\n  for (const chunk of chunks) {\n    const chunkDelay = calculateDelay(chunkIndex, profile, latency, recordedTimings, replaySpeed);\n    if (chunkDelay > 0) {\n      await delay(chunkDelay, signal);\n    }\n    if (signal?.aborted) return false;\n    if (res.writableEnded) return true;\n    res.write(`data: ${JSON.stringify(chunk)}\\n\\n`);\n    onChunkSent?.();\n    if (signal?.aborted) return false;\n    chunkIndex++;\n  }\n\n  if (!res.writableEnded) {\n    if (opts.usageChunk) {\n      res.write(`data: ${JSON.stringify(opts.usageChunk)}\\n\\n`);\n    }\n    res.write(\"data: [DONE]\\n\\n\");\n    res.end();\n  }\n  return true;\n}\n\n/**\n * Default rate-limit response headers matching OpenAI's format.\n * Values are static — aimock doesn't track actual request counts.\n */\nconst RATE_LIMIT_HEADERS: Record<string, string> = {\n  \"x-ratelimit-limit-requests\": \"60\",\n  \"x-ratelimit-limit-tokens\": \"150000\",\n  \"x-ratelimit-remaining-requests\": \"0\",\n  \"x-ratelimit-remaining-tokens\": \"0\",\n  \"x-ratelimit-reset-requests\": \"1s\",\n  \"x-ratelimit-reset-tokens\": \"6m0s\",\n};\n\nexport interface ErrorResponseOptions {\n  /** Override the Retry-After header value (seconds). Default: 1. Only applied on 429. */\n  retryAfter?: number;\n}\n\nexport function writeErrorResponse(\n  res: http.ServerResponse,\n  status: number,\n  body: string,\n  options?: ErrorResponseOptions,\n): void {\n  const headers: Record<string, string> = { \"Content-Type\": \"application/json\" };\n  if (status === 429) {\n    headers[\"Retry-After\"] = String(options?.retryAfter ?? 1);\n    Object.assign(headers, RATE_LIMIT_HEADERS);\n  }\n  res.writeHead(status, headers);\n  res.end(body);\n}\n"],"mappings":"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"}

package/dist/sse-writer.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"sse-writer.d.cts","names":[],"sources":["../src/sse-writer.ts"],"sourcesContent":[],"mappings":";;;;iBAGgB,KAAA,sBAA2B,cAAc;UAexC,aAAA;EAfD,OAAA,CAAK,EAAA,MAAA;EAAA,gBAAA,CAAA,EAiBA,gBAjBA;iBAAsB,CAAA,EAkBvB,eAlBuB;aAAc,CAAA,EAAA,MAAA;EAAO,MAAA,CAAA,EAoBrD,WApBqD;EAe/C,WAAA,CAAA,EAAA,GAAa,GAAA,IAAA;EAAA;YAET,CAAA,EAMN,QANM;;;;;AAoBrB;;;sBAIoB,CAAA,EAAA,OAAA;;AA+CE,iBAnDN,cAAA,CAmDoB,UAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EAjDxB,gBAiDwB,EAAA,eAAA,CAAA,EAAA,MAAA,EAAA,eAAA,CAAA,EA/ChB,eA+CgB,EAAA,WAAA,CAAA,EAAA,MAAA,CAAA,EAAA,MAAA;AAAA,iBAAd,cAAA,CAAc,GAAA,EAC7B,MAAA,CAAK,cADwB,EAAA,MAAA,EAE1B,QAF0B,EAAA,EAAA,gBAAA,CAAA,EAAA,MAAA,GAGN,aAHM,CAAA,EAIjC,OAJiC,CAAA,OAAA,CAAA;AAC7B,UA6DU,oBAAA,CA7DL;;YAEkB,CAAA,EAAA,MAAA;;AACpB,iBA+DM,kBAAA,CA/DN,GAAA,EAgEH,MAAA,CAAK,cAhEF,EAAA,MAAA,EAAA,MAAA,EAAA,IAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EAmEE,oBAnEF,CAAA,EAAA,IAAA;AA0DV"}
+{"version":3,"file":"sse-writer.d.cts","names":[],"sources":["../src/sse-writer.ts"],"sourcesContent":[],"mappings":";;;;iBAGgB,KAAA,sBAA2B,cAAc;UAexC,aAAA;EAfD,OAAA,CAAK,EAAA,MAAA;EAAA,gBAAA,CAAA,EAiBA,gBAjBA;iBAAsB,CAAA,EAkBvB,eAlBuB;aAAc,CAAA,EAAA,MAAA;EAAO,MAAA,CAAA,EAoBrD,WApBqD;EAe/C,WAAA,CAAA,EAAA,GAAa,GAAA,IAAA;EAAA;YAET,CAAA,EAMN,QANM;;;;;AAoBrB;;;sBAIoB,CAAA,EAAA,OAAA;;AA0EE,iBA9EN,cAAA,CA8EoB,UAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EA5ExB,gBA4EwB,EAAA,eAAA,CAAA,EAAA,MAAA,EAAA,eAAA,CAAA,EA1EhB,eA0EgB,EAAA,WAAA,CAAA,EAAA,MAAA,CAAA,EAAA,MAAA;AAC7B,iBADe,cAAA,CACV,GAAA,EAAL,MAAA,CAAK,cAAA,EAAA,MAAA,EACF,QADE,EAAA,EAAA,gBAAA,CAAA,EAAA,MAAA,GAEkB,aAFlB,CAAA,EAGT,OAHS,CAAA,OAAA,CAAA;AACF,UA4DO,oBAAA,CA5DP;;YAEP,CAAA,EAAA,MAAA;;AA0Dc,iBAKD,kBAAA,CALqB,GAAA,EAM9B,MAAA,CAAK,cANyB,EAAA,MAAA,EAAA,MAAA,EAAA,IAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EASzB,oBATyB,CAAA,EAAA,IAAA;AAKrC"}

package/dist/sse-writer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sse-writer.d.ts","names":[],"sources":["../src/sse-writer.ts"],"sourcesContent":[],"mappings":";;;;iBAGgB,KAAA,sBAA2B,cAAc;UAexC,aAAA;EAfD,OAAA,CAAK,EAAA,MAAA;EAAA,gBAAA,CAAA,EAiBA,gBAjBA;iBAAsB,CAAA,EAkBvB,eAlBuB;aAAc,CAAA,EAAA,MAAA;EAAO,MAAA,CAAA,EAoBrD,WApBqD;EAe/C,WAAA,CAAA,EAAA,GAAa,GAAA,IAAA;EAAA;YAET,CAAA,EAMN,QANM;;;;;AAoBrB;;;sBAIoB,CAAA,EAAA,OAAA;;AA+CE,iBAnDN,cAAA,CAmDoB,UAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EAjDxB,gBAiDwB,EAAA,eAAA,CAAA,EAAA,MAAA,EAAA,eAAA,CAAA,EA/ChB,eA+CgB,EAAA,WAAA,CAAA,EAAA,MAAA,CAAA,EAAA,MAAA;AAAA,iBAAd,cAAA,CAAc,GAAA,EAC7B,MAAA,CAAK,cADwB,EAAA,MAAA,EAE1B,QAF0B,EAAA,EAAA,gBAAA,CAAA,EAAA,MAAA,GAGN,aAHM,CAAA,EAIjC,OAJiC,CAAA,OAAA,CAAA;AAC7B,UA6DU,oBAAA,CA7DL;;YAEkB,CAAA,EAAA,MAAA;;AACpB,iBA+DM,kBAAA,CA/DN,GAAA,EAgEH,MAAA,CAAK,cAhEF,EAAA,MAAA,EAAA,MAAA,EAAA,IAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EAmEE,oBAnEF,CAAA,EAAA,IAAA;AA0DV"}
+{"version":3,"file":"sse-writer.d.ts","names":[],"sources":["../src/sse-writer.ts"],"sourcesContent":[],"mappings":";;;;iBAGgB,KAAA,sBAA2B,cAAc;UAexC,aAAA;EAfD,OAAA,CAAK,EAAA,MAAA;EAAA,gBAAA,CAAA,EAiBA,gBAjBA;iBAAsB,CAAA,EAkBvB,eAlBuB;aAAc,CAAA,EAAA,MAAA;EAAO,MAAA,CAAA,EAoBrD,WApBqD;EAe/C,WAAA,CAAA,EAAA,GAAa,GAAA,IAAA;EAAA;YAET,CAAA,EAMN,QANM;;;;;AAoBrB;;;sBAIoB,CAAA,EAAA,OAAA;;AA0EE,iBA9EN,cAAA,CA8EoB,UAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EA5ExB,gBA4EwB,EAAA,eAAA,CAAA,EAAA,MAAA,EAAA,eAAA,CAAA,EA1EhB,eA0EgB,EAAA,WAAA,CAAA,EAAA,MAAA,CAAA,EAAA,MAAA;AAC7B,iBADe,cAAA,CACV,GAAA,EAAL,MAAA,CAAK,cAAA,EAAA,MAAA,EACF,QADE,EAAA,EAAA,gBAAA,CAAA,EAAA,MAAA,GAEkB,aAFlB,CAAA,EAGT,OAHS,CAAA,OAAA,CAAA;AACF,UA4DO,oBAAA,CA5DP;;YAEP,CAAA,EAAA,MAAA;;AA0Dc,iBAKD,kBAAA,CALqB,GAAA,EAM9B,MAAA,CAAK,cANyB,EAAA,MAAA,EAAA,MAAA,EAAA,IAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EASzB,oBATyB,CAAA,EAAA,IAAA;AAKrC"}

package/dist/sse-writer.js

@@ -39,6 +39,12 @@ function calculateDelay(chunkIndex, profile, fallbackLatency, recordedTimings, r
 	delayMs = Math.max(0, delayMs);
 	return speed > 0 ? delayMs / speed : delayMs;
 }
+function calculateTotalDelay(contentLength, chunkSize, profile, recordedTimings, replaySpeed) {
+	const chunkCount = Math.max(1, Math.ceil(contentLength / chunkSize));
+	let total = 0;
+	for (let chunkIndex = 0; chunkIndex < chunkCount; chunkIndex++) total += calculateDelay(chunkIndex, profile, void 0, recordedTimings, replaySpeed);
+	return total;
+}
 async function writeSSEStream(res, chunks, optionsOrLatency) {
 	const opts = typeof optionsOrLatency === "number" ? { latency: optionsOrLatency } : optionsOrLatency ?? {};
 	const latency = opts.latency ?? 0;
@@ -92,5 +98,5 @@ function writeErrorResponse(res, status, body, options) {
 }
 
 //#endregion
-export { calculateDelay, delay, writeErrorResponse, writeSSEStream };
+export { calculateDelay, calculateTotalDelay, delay, writeErrorResponse, writeSSEStream };
 //# sourceMappingURL=sse-writer.js.map

package/dist/sse-writer.js.map

@@ -1 +1 @@
-{"version":3,"file":"sse-writer.js","names":[],"sources":["../src/sse-writer.ts"],"sourcesContent":["import type * as http from \"node:http\";\nimport type { SSEChunk, StreamingProfile, RecordedTimings } from \"./types.js\";\n\nexport function delay(ms: number, signal?: AbortSignal): Promise<void> {\n  if (ms <= 0 || signal?.aborted) return Promise.resolve();\n  return new Promise((resolve) => {\n    const timer = setTimeout(resolve, ms);\n    signal?.addEventListener(\n      \"abort\",\n      () => {\n        clearTimeout(timer);\n        resolve();\n      },\n      { once: true },\n    );\n  });\n}\n\nexport interface StreamOptions {\n  latency?: number;\n  streamingProfile?: StreamingProfile;\n  recordedTimings?: RecordedTimings;\n  replaySpeed?: number;\n  signal?: AbortSignal;\n  onChunkSent?: () => void;\n  /** When set, emitted as the final chunk before [DONE] (OpenAI stream_options.include_usage). */\n  usageChunk?: SSEChunk;\n  /**\n   * When true, a single OpenRouter `: OPENROUTER PROCESSING` SSE comment\n   * (keepalive) line is emitted FIRST — before the first data chunk — matching\n   * real OpenRouter bytes (or-capture/chat-stream.sse). A faithful client skips\n   * `:`-prefixed lines; opt-in, default off (so strict OpenAI parsers aren't\n   * surprised). Used only by the OpenRouter chat surface.\n   */\n  openRouterProcessing?: boolean;\n}\n\n/** OpenRouter's SSE keepalive comment line (colon-prefixed, per SSE syntax). */\nconst OPENROUTER_PROCESSING_COMMENT = \": OPENROUTER PROCESSING\\n\\n\";\n\nexport function calculateDelay(\n  chunkIndex: number,\n  profile?: StreamingProfile,\n  fallbackLatency?: number,\n  recordedTimings?: RecordedTimings,\n  replaySpeed?: number,\n): number {\n  const speed = replaySpeed ?? 1.0;\n  let delayMs: number;\n\n  if (profile) {\n    // StreamingProfile has highest precedence\n    let fromProfile = true;\n    if (chunkIndex === 0 && profile.ttft !== undefined) {\n      delayMs = profile.ttft;\n    } else if (profile.tps !== undefined && profile.tps > 0) {\n      delayMs = 1000 / profile.tps;\n    } else {\n      delayMs = fallbackLatency ?? 0;\n      fromProfile = false;\n    }\n    // Jitter only applies when the delay came from ttft/tps, not fallback\n    if (fromProfile && profile.jitter && profile.jitter > 0) {\n      delayMs *= 1 + (Math.random() * 2 - 1) * profile.jitter;\n      if (delayMs < 0) delayMs = 0;\n    }\n  } else if (recordedTimings) {\n    // Recorded timings (second precedence)\n    if (chunkIndex === 0) {\n      delayMs = recordedTimings.ttftMs;\n    } else {\n      const idx = chunkIndex - 1;\n      if (idx < recordedTimings.interChunkDelaysMs.length) {\n        delayMs = recordedTimings.interChunkDelaysMs[idx];\n      } else {\n        // Excess chunks: derive average from recorded inter-chunk delays\n        const totalInterChunk = recordedTimings.interChunkDelaysMs.reduce((a, b) => a + b, 0);\n        delayMs =\n          recordedTimings.interChunkDelaysMs.length > 0\n            ? totalInterChunk / recordedTimings.interChunkDelaysMs.length\n            : 0;\n      }\n    }\n  } else {\n    delayMs = fallbackLatency ?? 0;\n  }\n\n  delayMs = Math.max(0, delayMs);\n  return speed > 0 ? delayMs / speed : delayMs;\n}\n\nexport async function writeSSEStream(\n  res: http.ServerResponse,\n  chunks: SSEChunk[],\n  optionsOrLatency?: number | StreamOptions,\n): Promise<boolean> {\n  const opts: StreamOptions =\n    typeof optionsOrLatency === \"number\" ? { latency: optionsOrLatency } : (optionsOrLatency ?? {});\n  const latency = opts.latency ?? 0;\n  const profile = opts.streamingProfile;\n  const { recordedTimings, replaySpeed } = opts;\n  const signal = opts.signal;\n  const onChunkSent = opts.onChunkSent;\n\n  if (res.writableEnded) return true;\n  res.setHeader(\"Content-Type\", \"text/event-stream\");\n  res.setHeader(\"Cache-Control\", \"no-cache\");\n  res.setHeader(\"Connection\", \"keep-alive\");\n\n  // OpenRouter emits exactly ONE `: OPENROUTER PROCESSING` keepalive comment\n  // first — before any data frame (opt-in; see or-capture/chat-stream.sse). A\n  // faithful client discards `:`-prefixed lines before JSON-parsing a `data:`.\n  if (opts.openRouterProcessing && !res.writableEnded) {\n    res.write(OPENROUTER_PROCESSING_COMMENT);\n  }\n\n  let chunkIndex = 0;\n  for (const chunk of chunks) {\n    const chunkDelay = calculateDelay(chunkIndex, profile, latency, recordedTimings, replaySpeed);\n    if (chunkDelay > 0) {\n      await delay(chunkDelay, signal);\n    }\n    if (signal?.aborted) return false;\n    if (res.writableEnded) return true;\n    res.write(`data: ${JSON.stringify(chunk)}\\n\\n`);\n    onChunkSent?.();\n    if (signal?.aborted) return false;\n    chunkIndex++;\n  }\n\n  if (!res.writableEnded) {\n    if (opts.usageChunk) {\n      res.write(`data: ${JSON.stringify(opts.usageChunk)}\\n\\n`);\n    }\n    res.write(\"data: [DONE]\\n\\n\");\n    res.end();\n  }\n  return true;\n}\n\n/**\n * Default rate-limit response headers matching OpenAI's format.\n * Values are static — aimock doesn't track actual request counts.\n */\nconst RATE_LIMIT_HEADERS: Record<string, string> = {\n  \"x-ratelimit-limit-requests\": \"60\",\n  \"x-ratelimit-limit-tokens\": \"150000\",\n  \"x-ratelimit-remaining-requests\": \"0\",\n  \"x-ratelimit-remaining-tokens\": \"0\",\n  \"x-ratelimit-reset-requests\": \"1s\",\n  \"x-ratelimit-reset-tokens\": \"6m0s\",\n};\n\nexport interface ErrorResponseOptions {\n  /** Override the Retry-After header value (seconds). Default: 1. Only applied on 429. */\n  retryAfter?: number;\n}\n\nexport function writeErrorResponse(\n  res: http.ServerResponse,\n  status: number,\n  body: string,\n  options?: ErrorResponseOptions,\n): void {\n  const headers: Record<string, string> = { \"Content-Type\": \"application/json\" };\n  if (status === 429) {\n    headers[\"Retry-After\"] = String(options?.retryAfter ?? 1);\n    Object.assign(headers, RATE_LIMIT_HEADERS);\n  }\n  res.writeHead(status, headers);\n  res.end(body);\n}\n"],"mappings":"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"}
+{"version":3,"file":"sse-writer.js","names":[],"sources":["../src/sse-writer.ts"],"sourcesContent":["import type * as http from \"node:http\";\nimport type { SSEChunk, StreamingProfile, RecordedTimings } from \"./types.js\";\n\nexport function delay(ms: number, signal?: AbortSignal): Promise<void> {\n  if (ms <= 0 || signal?.aborted) return Promise.resolve();\n  return new Promise((resolve) => {\n    const timer = setTimeout(resolve, ms);\n    signal?.addEventListener(\n      \"abort\",\n      () => {\n        clearTimeout(timer);\n        resolve();\n      },\n      { once: true },\n    );\n  });\n}\n\nexport interface StreamOptions {\n  latency?: number;\n  streamingProfile?: StreamingProfile;\n  recordedTimings?: RecordedTimings;\n  replaySpeed?: number;\n  signal?: AbortSignal;\n  onChunkSent?: () => void;\n  /** When set, emitted as the final chunk before [DONE] (OpenAI stream_options.include_usage). */\n  usageChunk?: SSEChunk;\n  /**\n   * When true, a single OpenRouter `: OPENROUTER PROCESSING` SSE comment\n   * (keepalive) line is emitted FIRST — before the first data chunk — matching\n   * real OpenRouter bytes (or-capture/chat-stream.sse). A faithful client skips\n   * `:`-prefixed lines; opt-in, default off (so strict OpenAI parsers aren't\n   * surprised). Used only by the OpenRouter chat surface.\n   */\n  openRouterProcessing?: boolean;\n}\n\n/** OpenRouter's SSE keepalive comment line (colon-prefixed, per SSE syntax). */\nconst OPENROUTER_PROCESSING_COMMENT = \": OPENROUTER PROCESSING\\n\\n\";\n\nexport function calculateDelay(\n  chunkIndex: number,\n  profile?: StreamingProfile,\n  fallbackLatency?: number,\n  recordedTimings?: RecordedTimings,\n  replaySpeed?: number,\n): number {\n  const speed = replaySpeed ?? 1.0;\n  let delayMs: number;\n\n  if (profile) {\n    // StreamingProfile has highest precedence\n    let fromProfile = true;\n    if (chunkIndex === 0 && profile.ttft !== undefined) {\n      delayMs = profile.ttft;\n    } else if (profile.tps !== undefined && profile.tps > 0) {\n      delayMs = 1000 / profile.tps;\n    } else {\n      delayMs = fallbackLatency ?? 0;\n      fromProfile = false;\n    }\n    // Jitter only applies when the delay came from ttft/tps, not fallback\n    if (fromProfile && profile.jitter && profile.jitter > 0) {\n      delayMs *= 1 + (Math.random() * 2 - 1) * profile.jitter;\n      if (delayMs < 0) delayMs = 0;\n    }\n  } else if (recordedTimings) {\n    // Recorded timings (second precedence)\n    if (chunkIndex === 0) {\n      delayMs = recordedTimings.ttftMs;\n    } else {\n      const idx = chunkIndex - 1;\n      if (idx < recordedTimings.interChunkDelaysMs.length) {\n        delayMs = recordedTimings.interChunkDelaysMs[idx];\n      } else {\n        // Excess chunks: derive average from recorded inter-chunk delays\n        const totalInterChunk = recordedTimings.interChunkDelaysMs.reduce((a, b) => a + b, 0);\n        delayMs =\n          recordedTimings.interChunkDelaysMs.length > 0\n            ? totalInterChunk / recordedTimings.interChunkDelaysMs.length\n            : 0;\n      }\n    }\n  } else {\n    delayMs = fallbackLatency ?? 0;\n  }\n\n  delayMs = Math.max(0, delayMs);\n  return speed > 0 ? delayMs / speed : delayMs;\n}\n\n// Internal (not part of the public API): the total wait before a non-streaming\n// (`stream: false`) JSON response is written. Sums calculateDelay over the\n// content chunk count that `contentLength` at `chunkSize` would produce, so a\n// fixture with an explicit `streamingProfile` or `recordedTimings` pays roughly\n// the same ttft/tps cost as its streamed content chunks. It is an\n// approximation, not an exact match: a streamed reply also pays delays for its\n// role and finish chunks. There is deliberately no fallback-latency parameter:\n// bare `latency` / `--latency` is an inter-SSE-chunk gap and never delays a\n// non-streaming response. With neither a profile nor recorded timings, this\n// returns 0.\n// Kept as a line comment, not JSDoc: the bundled .d.ts drops this non-public\n// declaration but keeps a JSDoc block, which would then attach to writeSSEStream.\nexport function calculateTotalDelay(\n  contentLength: number,\n  chunkSize: number,\n  profile?: StreamingProfile,\n  recordedTimings?: RecordedTimings,\n  replaySpeed?: number,\n): number {\n  const chunkCount = Math.max(1, Math.ceil(contentLength / chunkSize));\n  let total = 0;\n  for (let chunkIndex = 0; chunkIndex < chunkCount; chunkIndex++) {\n    total += calculateDelay(chunkIndex, profile, undefined, recordedTimings, replaySpeed);\n  }\n  return total;\n}\n\nexport async function writeSSEStream(\n  res: http.ServerResponse,\n  chunks: SSEChunk[],\n  optionsOrLatency?: number | StreamOptions,\n): Promise<boolean> {\n  const opts: StreamOptions =\n    typeof optionsOrLatency === \"number\" ? { latency: optionsOrLatency } : (optionsOrLatency ?? {});\n  const latency = opts.latency ?? 0;\n  const profile = opts.streamingProfile;\n  const { recordedTimings, replaySpeed } = opts;\n  const signal = opts.signal;\n  const onChunkSent = opts.onChunkSent;\n\n  if (res.writableEnded) return true;\n  res.setHeader(\"Content-Type\", \"text/event-stream\");\n  res.setHeader(\"Cache-Control\", \"no-cache\");\n  res.setHeader(\"Connection\", \"keep-alive\");\n\n  // OpenRouter emits exactly ONE `: OPENROUTER PROCESSING` keepalive comment\n  // first — before any data frame (opt-in; see or-capture/chat-stream.sse). A\n  // faithful client discards `:`-prefixed lines before JSON-parsing a `data:`.\n  if (opts.openRouterProcessing && !res.writableEnded) {\n    res.write(OPENROUTER_PROCESSING_COMMENT);\n  }\n\n  let chunkIndex = 0;\n  for (const chunk of chunks) {\n    const chunkDelay = calculateDelay(chunkIndex, profile, latency, recordedTimings, replaySpeed);\n    if (chunkDelay > 0) {\n      await delay(chunkDelay, signal);\n    }\n    if (signal?.aborted) return false;\n    if (res.writableEnded) return true;\n    res.write(`data: ${JSON.stringify(chunk)}\\n\\n`);\n    onChunkSent?.();\n    if (signal?.aborted) return false;\n    chunkIndex++;\n  }\n\n  if (!res.writableEnded) {\n    if (opts.usageChunk) {\n      res.write(`data: ${JSON.stringify(opts.usageChunk)}\\n\\n`);\n    }\n    res.write(\"data: [DONE]\\n\\n\");\n    res.end();\n  }\n  return true;\n}\n\n/**\n * Default rate-limit response headers matching OpenAI's format.\n * Values are static — aimock doesn't track actual request counts.\n */\nconst RATE_LIMIT_HEADERS: Record<string, string> = {\n  \"x-ratelimit-limit-requests\": \"60\",\n  \"x-ratelimit-limit-tokens\": \"150000\",\n  \"x-ratelimit-remaining-requests\": \"0\",\n  \"x-ratelimit-remaining-tokens\": \"0\",\n  \"x-ratelimit-reset-requests\": \"1s\",\n  \"x-ratelimit-reset-tokens\": \"6m0s\",\n};\n\nexport interface ErrorResponseOptions {\n  /** Override the Retry-After header value (seconds). Default: 1. Only applied on 429. */\n  retryAfter?: number;\n}\n\nexport function writeErrorResponse(\n  res: http.ServerResponse,\n  status: number,\n  body: string,\n  options?: ErrorResponseOptions,\n): void {\n  const headers: Record<string, string> = { \"Content-Type\": \"application/json\" };\n  if (status === 429) {\n    headers[\"Retry-After\"] = String(options?.retryAfter ?? 1);\n    Object.assign(headers, RATE_LIMIT_HEADERS);\n  }\n  res.writeHead(status, headers);\n  res.end(body);\n}\n"],"mappings":";AAGA,SAAgB,MAAM,IAAY,QAAqC;AACrE,KAAI,MAAM,KAAK,QAAQ,QAAS,QAAO,QAAQ,SAAS;AACxD,QAAO,IAAI,SAAS,YAAY;EAC9B,MAAM,QAAQ,WAAW,SAAS,GAAG;AACrC,UAAQ,iBACN,eACM;AACJ,gBAAa,MAAM;AACnB,YAAS;KAEX,EAAE,MAAM,MAAM,CACf;GACD;;;AAuBJ,MAAM,gCAAgC;AAEtC,SAAgB,eACd,YACA,SACA,iBACA,iBACA,aACQ;CACR,MAAM,QAAQ,eAAe;CAC7B,IAAI;AAEJ,KAAI,SAAS;EAEX,IAAI,cAAc;AAClB,MAAI,eAAe,KAAK,QAAQ,SAAS,OACvC,WAAU,QAAQ;WACT,QAAQ,QAAQ,UAAa,QAAQ,MAAM,EACpD,WAAU,MAAO,QAAQ;OACpB;AACL,aAAU,mBAAmB;AAC7B,iBAAc;;AAGhB,MAAI,eAAe,QAAQ,UAAU,QAAQ,SAAS,GAAG;AACvD,cAAW,KAAK,KAAK,QAAQ,GAAG,IAAI,KAAK,QAAQ;AACjD,OAAI,UAAU,EAAG,WAAU;;YAEpB,gBAET,KAAI,eAAe,EACjB,WAAU,gBAAgB;MACrB;EACL,MAAM,MAAM,aAAa;AACzB,MAAI,MAAM,gBAAgB,mBAAmB,OAC3C,WAAU,gBAAgB,mBAAmB;OACxC;GAEL,MAAM,kBAAkB,gBAAgB,mBAAmB,QAAQ,GAAG,MAAM,IAAI,GAAG,EAAE;AACrF,aACE,gBAAgB,mBAAmB,SAAS,IACxC,kBAAkB,gBAAgB,mBAAmB,SACrD;;;KAIV,WAAU,mBAAmB;AAG/B,WAAU,KAAK,IAAI,GAAG,QAAQ;AAC9B,QAAO,QAAQ,IAAI,UAAU,QAAQ;;AAevC,SAAgB,oBACd,eACA,WACA,SACA,iBACA,aACQ;CACR,MAAM,aAAa,KAAK,IAAI,GAAG,KAAK,KAAK,gBAAgB,UAAU,CAAC;CACpE,IAAI,QAAQ;AACZ,MAAK,IAAI,aAAa,GAAG,aAAa,YAAY,aAChD,UAAS,eAAe,YAAY,SAAS,QAAW,iBAAiB,YAAY;AAEvF,QAAO;;AAGT,eAAsB,eACpB,KACA,QACA,kBACkB;CAClB,MAAM,OACJ,OAAO,qBAAqB,WAAW,EAAE,SAAS,kBAAkB,GAAI,oBAAoB,EAAE;CAChG,MAAM,UAAU,KAAK,WAAW;CAChC,MAAM,UAAU,KAAK;CACrB,MAAM,EAAE,iBAAiB,gBAAgB;CACzC,MAAM,SAAS,KAAK;CACpB,MAAM,cAAc,KAAK;AAEzB,KAAI,IAAI,cAAe,QAAO;AAC9B,KAAI,UAAU,gBAAgB,oBAAoB;AAClD,KAAI,UAAU,iBAAiB,WAAW;AAC1C,KAAI,UAAU,cAAc,aAAa;AAKzC,KAAI,KAAK,wBAAwB,CAAC,IAAI,cACpC,KAAI,MAAM,8BAA8B;CAG1C,IAAI,aAAa;AACjB,MAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,aAAa,eAAe,YAAY,SAAS,SAAS,iBAAiB,YAAY;AAC7F,MAAI,aAAa,EACf,OAAM,MAAM,YAAY,OAAO;AAEjC,MAAI,QAAQ,QAAS,QAAO;AAC5B,MAAI,IAAI,cAAe,QAAO;AAC9B,MAAI,MAAM,SAAS,KAAK,UAAU,MAAM,CAAC,MAAM;AAC/C,iBAAe;AACf,MAAI,QAAQ,QAAS,QAAO;AAC5B;;AAGF,KAAI,CAAC,IAAI,eAAe;AACtB,MAAI,KAAK,WACP,KAAI,MAAM,SAAS,KAAK,UAAU,KAAK,WAAW,CAAC,MAAM;AAE3D,MAAI,MAAM,mBAAmB;AAC7B,MAAI,KAAK;;AAEX,QAAO;;;;;;AAOT,MAAM,qBAA6C;CACjD,8BAA8B;CAC9B,4BAA4B;CAC5B,kCAAkC;CAClC,gCAAgC;CAChC,8BAA8B;CAC9B,4BAA4B;CAC7B;AAOD,SAAgB,mBACd,KACA,QACA,MACA,SACM;CACN,MAAM,UAAkC,EAAE,gBAAgB,oBAAoB;AAC9E,KAAI,WAAW,KAAK;AAClB,UAAQ,iBAAiB,OAAO,SAAS,cAAc,EAAE;AACzD,SAAO,OAAO,SAAS,mBAAmB;;AAE5C,KAAI,UAAU,QAAQ,QAAQ;AAC9B,KAAI,IAAI,KAAK"}