@copilotkit/aimock 1.16.4 → 1.18.0

package/dist/fal.cjs

@@ -0,0 +1,424 @@
+const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
+const require_helpers = require('./helpers.cjs');
+const require_router = require('./router.cjs');
+const require_recorder = require('./recorder.cjs');
+const require_fal_audio = require('./fal-audio.cjs');
+let node_crypto = require("node:crypto");
+node_crypto = require_runtime.__toESM(node_crypto);
+
+//#region src/fal.ts
+const FAL_QUEUE_MAX_ENTRIES = 1e4;
+const FAL_QUEUE_TTL_MS = 36e5;
+/**
+* Per-testId queue state for the general fal handler. Mirrors FalJobMap from
+* fal-audio.ts but stores arbitrary JSON payloads instead of audio file
+* objects, so it can serve any fal model (image, video, motion, music, etc.).
+*/
+var FalQueueStateMap = class {
+	entries = /* @__PURE__ */ new Map();
+	get(key) {
+		const entry = this.entries.get(key);
+		if (!entry) return void 0;
+		if (Date.now() - entry.createdAt > FAL_QUEUE_TTL_MS) {
+			this.entries.delete(key);
+			return;
+		}
+		return entry.job;
+	}
+	set(key, job) {
+		this.entries.set(key, {
+			job,
+			createdAt: Date.now()
+		});
+		if (this.entries.size > FAL_QUEUE_MAX_ENTRIES) {
+			const excess = this.entries.size - FAL_QUEUE_MAX_ENTRIES;
+			const iter = this.entries.keys();
+			for (let i = 0; i < excess; i++) {
+				const next = iter.next();
+				if (!next.done) this.entries.delete(next.value);
+			}
+		}
+	}
+	delete(key) {
+		return this.entries.delete(key);
+	}
+	clear() {
+		this.entries.clear();
+	}
+	get size() {
+		return this.entries.size;
+	}
+};
+const falQueueStates = new FalQueueStateMap();
+const FAL_HOSTS = {
+	queue: "queue.fal.run",
+	sync: "fal.run",
+	storage: "rest.fal.ai",
+	storageAlpha: "rest.alpha.fal.ai",
+	gateway: "gateway.fal.ai"
+};
+const QUEUE_REQUESTS_RE = /^(.+)\/requests\/([^/]+)(\/status|\/cancel)?$/;
+const STORAGE_INITIATE_PATH = "/storage/upload/initiate";
+function stripFalPrefix(pathname) {
+	const stripped = pathname.replace(/^\/fal/, "");
+	return stripped.length > 0 ? stripped : "/";
+}
+function extractPromptFromBody(body) {
+	if (!body || typeof body !== "object") return "";
+	const obj = body;
+	if (typeof obj.prompt === "string") return obj.prompt;
+	if (typeof obj.text === "string") return obj.text;
+	const input = obj.input;
+	if (input && typeof input === "object") {
+		const inputObj = input;
+		if (typeof inputObj.prompt === "string") return inputObj.prompt;
+		if (typeof inputObj.text === "string") return inputObj.text;
+	}
+	return "";
+}
+function parseFalPath(stripped) {
+	if (!stripped.startsWith("/")) return null;
+	const trimmed = stripped.replace(/^\/+/, "");
+	if (!trimmed) return null;
+	const m = QUEUE_REQUESTS_RE.exec(`/${trimmed}`);
+	if (m) {
+		const modelId = m[1].replace(/^\/+/, "");
+		const action = m[3] === "/status" ? "status" : m[3] === "/cancel" ? "cancel" : "result";
+		return {
+			modelId,
+			requestId: m[2],
+			action
+		};
+	}
+	return { modelId: trimmed };
+}
+function classifyRoute(req, pathname, targetHost) {
+	const stripped = stripFalPrefix(pathname);
+	if (targetHost === FAL_HOSTS.storage || targetHost === FAL_HOSTS.storageAlpha) {
+		if (req.method === "POST" && stripped === STORAGE_INITIATE_PATH) return {
+			kind: "storage",
+			targetHost
+		};
+		return null;
+	}
+	const parsed = parseFalPath(stripped);
+	if (!parsed) return null;
+	if (targetHost === FAL_HOSTS.queue) {
+		if (parsed.requestId) {
+			if (parsed.action === "status" && req.method === "GET") return {
+				kind: "queue-status",
+				modelId: parsed.modelId,
+				requestId: parsed.requestId,
+				targetHost
+			};
+			if (parsed.action === "cancel" && req.method === "PUT") return {
+				kind: "queue-cancel",
+				modelId: parsed.modelId,
+				requestId: parsed.requestId,
+				targetHost
+			};
+			if (parsed.action === "result" && req.method === "GET") return {
+				kind: "queue-result",
+				modelId: parsed.modelId,
+				requestId: parsed.requestId,
+				targetHost
+			};
+			return null;
+		}
+		if (req.method === "POST") return {
+			kind: "queue-submit",
+			modelId: parsed.modelId,
+			targetHost
+		};
+		return null;
+	}
+	if (targetHost === FAL_HOSTS.sync) {
+		if (req.method === "POST" && parsed.modelId) return {
+			kind: "sync-run",
+			modelId: parsed.modelId,
+			targetHost
+		};
+		return null;
+	}
+	return null;
+}
+/**
+* General fal.ai handler. Routes by `x-fal-target-host` header (the convention
+* used by `@fal-ai/client`'s server-side requestMiddleware workaround for the
+* fact that `proxyUrl` is browser-only).
+*
+* Returns `"passthrough"` when the request does not look like a host-mirrored
+* fal call, so the caller can fall back to the legacy `/fal/queue/...` and
+* `/fal/run/...` audio routes.
+*/
+async function handleFal(req, res, body, pathname, fixtures, defaults, journal) {
+	const targetHostHeader = req.headers["x-fal-target-host"];
+	const targetHost = Array.isArray(targetHostHeader) ? targetHostHeader[0] : targetHostHeader;
+	if (!targetHost) return "passthrough";
+	const route = classifyRoute(req, pathname, targetHost);
+	if (!route) return "passthrough";
+	const testId = require_helpers.getTestId(req);
+	const stateKey = (id) => `${testId}:${id}`;
+	switch (route.kind) {
+		case "queue-status": {
+			const job = falQueueStates.get(stateKey(route.requestId));
+			if (!job) {
+				respondNotFound(req, res, pathname, journal, route.requestId);
+				return "handled";
+			}
+			writeJson(req, res, 200, {
+				status: job.status,
+				request_id: job.requestId,
+				response_url: `https://${FAL_HOSTS.queue}/${job.modelId}/requests/${job.requestId}`
+			}, pathname, journal);
+			return "handled";
+		}
+		case "queue-result": {
+			const job = falQueueStates.get(stateKey(route.requestId));
+			if (!job) {
+				respondNotFound(req, res, pathname, journal, route.requestId);
+				return "handled";
+			}
+			writeJson(req, res, 200, job.result, pathname, journal);
+			return "handled";
+		}
+		case "queue-cancel":
+			if (!falQueueStates.get(stateKey(route.requestId))) {
+				journal.add({
+					method: req.method ?? "PUT",
+					path: pathname,
+					headers: require_helpers.flattenHeaders(req.headers),
+					body: null,
+					response: {
+						status: 404,
+						fixture: null
+					}
+				});
+				res.writeHead(404, { "Content-Type": "application/json" });
+				res.end(JSON.stringify({ status: "NOT_FOUND" }));
+				return "handled";
+			}
+			journal.add({
+				method: req.method ?? "PUT",
+				path: pathname,
+				headers: require_helpers.flattenHeaders(req.headers),
+				body: null,
+				response: {
+					status: 400,
+					fixture: null
+				}
+			});
+			res.writeHead(400, { "Content-Type": "application/json" });
+			res.end(JSON.stringify({ status: "ALREADY_COMPLETED" }));
+			return "handled";
+		case "storage": {
+			let filename = "upload.bin";
+			try {
+				const parsed = body ? JSON.parse(body) : {};
+				if (typeof parsed.filename === "string") filename = parsed.filename;
+				if (typeof parsed.file_name === "string") filename = parsed.file_name;
+			} catch {}
+			const fileId = node_crypto.default.randomUUID();
+			writeJson(req, res, 200, {
+				upload_url: `https://${route.targetHost}/storage/upload/${fileId}`,
+				file_url: `https://${route.targetHost}/files/${fileId}/${filename}`
+			}, pathname, journal);
+			return "handled";
+		}
+		case "queue-submit":
+		case "sync-run": {
+			const modelId = route.modelId;
+			const parsedBody = parseBody(body);
+			const syntheticReq = {
+				model: modelId,
+				messages: [{
+					role: "user",
+					content: extractPromptFromBody(parsedBody) || JSON.stringify(parsedBody ?? {})
+				}],
+				_endpointType: "fal"
+			};
+			const fixture = require_router.matchFixture(fixtures, syntheticReq, journal.getFixtureMatchCountsForTest(testId), defaults.requestTransform);
+			if (!fixture) {
+				if (defaults.record) {
+					const effectiveDefaults = withFalUpstream(defaults, route.targetHost);
+					const outcome = await require_recorder.proxyAndRecord(req, res, syntheticReq, "fal", stripFalPrefix(pathname), fixtures, effectiveDefaults, body);
+					if (outcome === "handled_by_hook") return "handled";
+					if (outcome === "relayed") {
+						journal.add({
+							method: req.method ?? "POST",
+							path: pathname,
+							headers: require_helpers.flattenHeaders(req.headers),
+							body: syntheticReq,
+							response: {
+								status: res.statusCode ?? 200,
+								fixture: null,
+								source: "proxy"
+							}
+						});
+						return "handled";
+					}
+				}
+				const strictStatus = defaults.strict ? 503 : 404;
+				const strictMessage = defaults.strict ? "Strict mode: no fixture matched" : "No fixture matched";
+				journal.add({
+					method: req.method ?? "POST",
+					path: pathname,
+					headers: require_helpers.flattenHeaders(req.headers),
+					body: syntheticReq,
+					response: {
+						status: strictStatus,
+						fixture: null
+					}
+				});
+				res.writeHead(strictStatus, { "Content-Type": "application/json" });
+				res.end(JSON.stringify({ error: {
+					message: strictMessage,
+					type: "invalid_request_error",
+					code: "no_fixture_match"
+				} }));
+				return "handled";
+			}
+			journal.incrementFixtureMatchCount(fixture, fixtures, testId);
+			const response = fixture.response;
+			if (require_helpers.isErrorResponse(response)) {
+				const status = response.status ?? 500;
+				journal.add({
+					method: req.method ?? "POST",
+					path: pathname,
+					headers: require_helpers.flattenHeaders(req.headers),
+					body: syntheticReq,
+					response: {
+						status,
+						fixture
+					}
+				});
+				res.writeHead(status, { "Content-Type": "application/json" });
+				res.end(JSON.stringify(response));
+				return "handled";
+			}
+			let payload;
+			if (require_helpers.isJSONResponse(response)) payload = response.json;
+			else if (require_helpers.isAudioResponse(response)) payload = require_fal_audio.audioToFalFile(response);
+			else {
+				journal.add({
+					method: req.method ?? "POST",
+					path: pathname,
+					headers: require_helpers.flattenHeaders(req.headers),
+					body: syntheticReq,
+					response: {
+						status: 500,
+						fixture
+					}
+				});
+				res.writeHead(500, { "Content-Type": "application/json" });
+				res.end(JSON.stringify({ error: {
+					message: "Fixture response is not JSON or audio for fal endpoint",
+					type: "server_error"
+				} }));
+				return "handled";
+			}
+			if (route.kind === "sync-run") {
+				journal.add({
+					method: req.method ?? "POST",
+					path: pathname,
+					headers: require_helpers.flattenHeaders(req.headers),
+					body: syntheticReq,
+					response: {
+						status: 200,
+						fixture
+					}
+				});
+				res.writeHead(200, { "Content-Type": "application/json" });
+				res.end(JSON.stringify(payload));
+				return "handled";
+			}
+			const requestId = node_crypto.default.randomUUID();
+			falQueueStates.set(stateKey(requestId), {
+				requestId,
+				modelId,
+				status: "COMPLETED",
+				result: payload,
+				createdAt: Date.now()
+			});
+			const envelope = {
+				request_id: requestId,
+				response_url: `https://${FAL_HOSTS.queue}/${modelId}/requests/${requestId}`,
+				status_url: `https://${FAL_HOSTS.queue}/${modelId}/requests/${requestId}/status`,
+				cancel_url: `https://${FAL_HOSTS.queue}/${modelId}/requests/${requestId}/cancel`,
+				queue_position: 0
+			};
+			journal.add({
+				method: req.method ?? "POST",
+				path: pathname,
+				headers: require_helpers.flattenHeaders(req.headers),
+				body: syntheticReq,
+				response: {
+					status: 200,
+					fixture
+				}
+			});
+			res.writeHead(200, { "Content-Type": "application/json" });
+			res.end(JSON.stringify(envelope));
+			return "handled";
+		}
+	}
+}
+function parseBody(raw) {
+	if (!raw.trim()) return null;
+	try {
+		return JSON.parse(raw);
+	} catch {
+		return null;
+	}
+}
+function withFalUpstream(defaults, targetHost) {
+	if (!defaults.record) return defaults;
+	if (defaults.record.providers.fal) return defaults;
+	return {
+		...defaults,
+		record: {
+			...defaults.record,
+			providers: {
+				...defaults.record.providers,
+				fal: `https://${targetHost}`
+			}
+		}
+	};
+}
+function writeJson(req, res, status, payload, pathname, journal) {
+	journal.add({
+		method: req.method ?? "GET",
+		path: pathname,
+		headers: require_helpers.flattenHeaders(req.headers),
+		body: null,
+		response: {
+			status,
+			fixture: null
+		}
+	});
+	res.writeHead(status, { "Content-Type": "application/json" });
+	res.end(JSON.stringify(payload));
+}
+function respondNotFound(req, res, pathname, journal, requestId) {
+	journal.add({
+		method: req.method ?? "GET",
+		path: pathname,
+		headers: require_helpers.flattenHeaders(req.headers),
+		body: null,
+		response: {
+			status: 404,
+			fixture: null
+		}
+	});
+	res.writeHead(404, { "Content-Type": "application/json" });
+	res.end(JSON.stringify({ error: {
+		message: `Request ${requestId} not found`,
+		type: "not_found"
+	} }));
+}
+
+//#endregion
+exports.FalQueueStateMap = FalQueueStateMap;
+exports.falQueueStates = falQueueStates;
+exports.handleFal = handleFal;
+//# sourceMappingURL=fal.cjs.map

package/dist/fal.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fal.cjs","names":["getTestId","flattenHeaders","crypto","matchFixture","proxyAndRecord","isErrorResponse","isJSONResponse","isAudioResponse","audioToFalFile"],"sources":["../src/fal.ts"],"sourcesContent":["import type http from \"node:http\";\nimport crypto from \"node:crypto\";\nimport type { ChatCompletionRequest, Fixture, HandlerDefaults, RawJSONResponse } from \"./types.js\";\nimport {\n  isAudioResponse,\n  isErrorResponse,\n  isJSONResponse,\n  flattenHeaders,\n  getTestId,\n} from \"./helpers.js\";\nimport { matchFixture } from \"./router.js\";\nimport { proxyAndRecord } from \"./recorder.js\";\nimport type { Journal } from \"./journal.js\";\nimport { audioToFalFile } from \"./fal-audio.js\";\n\n// ─── FalQueueState (TTL + bounded) ───────────────────────────────────────\n\nconst FAL_QUEUE_MAX_ENTRIES = 10_000;\nconst FAL_QUEUE_TTL_MS = 3_600_000; // 1 hour\n\ninterface FalQueueJob {\n  requestId: string;\n  modelId: string;\n  status: \"IN_QUEUE\" | \"IN_PROGRESS\" | \"COMPLETED\";\n  result: unknown;\n  createdAt: number;\n}\n\ninterface FalQueueEntry {\n  job: FalQueueJob;\n  createdAt: number;\n}\n\n/**\n * Per-testId queue state for the general fal handler. Mirrors FalJobMap from\n * fal-audio.ts but stores arbitrary JSON payloads instead of audio file\n * objects, so it can serve any fal model (image, video, motion, music, etc.).\n */\nexport class FalQueueStateMap {\n  private readonly entries = new Map<string, FalQueueEntry>();\n\n  get(key: string): FalQueueJob | undefined {\n    const entry = this.entries.get(key);\n    if (!entry) return undefined;\n    if (Date.now() - entry.createdAt > FAL_QUEUE_TTL_MS) {\n      this.entries.delete(key);\n      return undefined;\n    }\n    return entry.job;\n  }\n\n  set(key: string, job: FalQueueJob): void {\n    this.entries.set(key, { job, createdAt: Date.now() });\n    if (this.entries.size > FAL_QUEUE_MAX_ENTRIES) {\n      const excess = this.entries.size - FAL_QUEUE_MAX_ENTRIES;\n      const iter = this.entries.keys();\n      for (let i = 0; i < excess; i++) {\n        const next = iter.next();\n        if (!next.done) this.entries.delete(next.value);\n      }\n    }\n  }\n\n  delete(key: string): boolean {\n    return this.entries.delete(key);\n  }\n\n  clear(): void {\n    this.entries.clear();\n  }\n\n  get size(): number {\n    return this.entries.size;\n  }\n}\n\nexport const falQueueStates = new FalQueueStateMap();\n\n// ─── Hosts and routing ──────────────────────────────────────────────────\n\nconst FAL_HOSTS = {\n  queue: \"queue.fal.run\",\n  sync: \"fal.run\",\n  storage: \"rest.fal.ai\",\n  storageAlpha: \"rest.alpha.fal.ai\",\n  gateway: \"gateway.fal.ai\",\n} as const;\n\nconst QUEUE_REQUESTS_RE = /^(.+)\\/requests\\/([^/]+)(\\/status|\\/cancel)?$/;\nconst STORAGE_INITIATE_PATH = \"/storage/upload/initiate\";\n\nfunction stripFalPrefix(pathname: string): string {\n  const stripped = pathname.replace(/^\\/fal/, \"\");\n  return stripped.length > 0 ? stripped : \"/\";\n}\n\nfunction extractPromptFromBody(body: unknown): string {\n  if (!body || typeof body !== \"object\") return \"\";\n  const obj = body as Record<string, unknown>;\n  if (typeof obj.prompt === \"string\") return obj.prompt;\n  if (typeof obj.text === \"string\") return obj.text;\n  const input = obj.input;\n  if (input && typeof input === \"object\") {\n    const inputObj = input as Record<string, unknown>;\n    if (typeof inputObj.prompt === \"string\") return inputObj.prompt;\n    if (typeof inputObj.text === \"string\") return inputObj.text;\n  }\n  return \"\";\n}\n\ninterface ParsedFalPath {\n  modelId: string;\n  requestId?: string;\n  action?: \"status\" | \"cancel\" | \"result\";\n}\n\nfunction parseFalPath(stripped: string): ParsedFalPath | null {\n  if (!stripped.startsWith(\"/\")) return null;\n  const trimmed = stripped.replace(/^\\/+/, \"\");\n  if (!trimmed) return null;\n\n  const m = QUEUE_REQUESTS_RE.exec(`/${trimmed}`);\n  if (m) {\n    const modelId = m[1].replace(/^\\/+/, \"\");\n    const action = m[3] === \"/status\" ? \"status\" : m[3] === \"/cancel\" ? \"cancel\" : \"result\";\n    return { modelId, requestId: m[2], action };\n  }\n  return { modelId: trimmed };\n}\n\nexport type HandleFalOutcome = \"handled\" | \"passthrough\";\n\ninterface FalRouteInfo {\n  kind: \"queue-submit\" | \"queue-status\" | \"queue-result\" | \"queue-cancel\" | \"sync-run\" | \"storage\";\n  modelId?: string;\n  requestId?: string;\n  targetHost: string;\n}\n\nfunction classifyRoute(\n  req: http.IncomingMessage,\n  pathname: string,\n  targetHost: string,\n): FalRouteInfo | null {\n  const stripped = stripFalPrefix(pathname);\n\n  if (targetHost === FAL_HOSTS.storage || targetHost === FAL_HOSTS.storageAlpha) {\n    if (req.method === \"POST\" && stripped === STORAGE_INITIATE_PATH) {\n      return { kind: \"storage\", targetHost };\n    }\n    return null;\n  }\n\n  const parsed = parseFalPath(stripped);\n  if (!parsed) return null;\n\n  if (targetHost === FAL_HOSTS.queue) {\n    if (parsed.requestId) {\n      if (parsed.action === \"status\" && req.method === \"GET\") {\n        return {\n          kind: \"queue-status\",\n          modelId: parsed.modelId,\n          requestId: parsed.requestId,\n          targetHost,\n        };\n      }\n      if (parsed.action === \"cancel\" && req.method === \"PUT\") {\n        return {\n          kind: \"queue-cancel\",\n          modelId: parsed.modelId,\n          requestId: parsed.requestId,\n          targetHost,\n        };\n      }\n      if (parsed.action === \"result\" && req.method === \"GET\") {\n        return {\n          kind: \"queue-result\",\n          modelId: parsed.modelId,\n          requestId: parsed.requestId,\n          targetHost,\n        };\n      }\n      return null;\n    }\n    if (req.method === \"POST\") {\n      return { kind: \"queue-submit\", modelId: parsed.modelId, targetHost };\n    }\n    return null;\n  }\n\n  if (targetHost === FAL_HOSTS.sync) {\n    if (req.method === \"POST\" && parsed.modelId) {\n      return { kind: \"sync-run\", modelId: parsed.modelId, targetHost };\n    }\n    return null;\n  }\n\n  return null;\n}\n\n/**\n * General fal.ai handler. Routes by `x-fal-target-host` header (the convention\n * used by `@fal-ai/client`'s server-side requestMiddleware workaround for the\n * fact that `proxyUrl` is browser-only).\n *\n * Returns `\"passthrough\"` when the request does not look like a host-mirrored\n * fal call, so the caller can fall back to the legacy `/fal/queue/...` and\n * `/fal/run/...` audio routes.\n */\nexport async function handleFal(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  body: string,\n  pathname: string,\n  fixtures: Fixture[],\n  defaults: HandlerDefaults,\n  journal: Journal,\n): Promise<HandleFalOutcome> {\n  const targetHostHeader = req.headers[\"x-fal-target-host\"];\n  const targetHost = Array.isArray(targetHostHeader) ? targetHostHeader[0] : targetHostHeader;\n  if (!targetHost) return \"passthrough\";\n\n  const route = classifyRoute(req, pathname, targetHost);\n  if (!route) return \"passthrough\";\n\n  const testId = getTestId(req);\n  const stateKey = (id: string) => `${testId}:${id}`;\n\n  switch (route.kind) {\n    case \"queue-status\": {\n      const job = falQueueStates.get(stateKey(route.requestId!));\n      if (!job) {\n        respondNotFound(req, res, pathname, journal, route.requestId!);\n        return \"handled\";\n      }\n      const responseBody = {\n        status: job.status,\n        request_id: job.requestId,\n        response_url: `https://${FAL_HOSTS.queue}/${job.modelId}/requests/${job.requestId}`,\n      };\n      writeJson(req, res, 200, responseBody, pathname, journal);\n      return \"handled\";\n    }\n\n    case \"queue-result\": {\n      const job = falQueueStates.get(stateKey(route.requestId!));\n      if (!job) {\n        respondNotFound(req, res, pathname, journal, route.requestId!);\n        return \"handled\";\n      }\n      writeJson(req, res, 200, job.result, pathname, journal);\n      return \"handled\";\n    }\n\n    case \"queue-cancel\": {\n      const job = falQueueStates.get(stateKey(route.requestId!));\n      if (!job) {\n        journal.add({\n          method: req.method ?? \"PUT\",\n          path: pathname,\n          headers: flattenHeaders(req.headers),\n          body: null,\n          response: { status: 404, fixture: null },\n        });\n        res.writeHead(404, { \"Content-Type\": \"application/json\" });\n        res.end(JSON.stringify({ status: \"NOT_FOUND\" }));\n        return \"handled\";\n      }\n      journal.add({\n        method: req.method ?? \"PUT\",\n        path: pathname,\n        headers: flattenHeaders(req.headers),\n        body: null,\n        response: { status: 400, fixture: null },\n      });\n      res.writeHead(400, { \"Content-Type\": \"application/json\" });\n      res.end(JSON.stringify({ status: \"ALREADY_COMPLETED\" }));\n      return \"handled\";\n    }\n\n    case \"storage\": {\n      let filename = \"upload.bin\";\n      try {\n        const parsed = body ? (JSON.parse(body) as Record<string, unknown>) : {};\n        if (typeof parsed.filename === \"string\") filename = parsed.filename;\n        if (typeof parsed.file_name === \"string\") filename = parsed.file_name;\n      } catch {\n        // ignore — stub doesn't require a structured body\n      }\n      const fileId = crypto.randomUUID();\n      const responseBody = {\n        upload_url: `https://${route.targetHost}/storage/upload/${fileId}`,\n        file_url: `https://${route.targetHost}/files/${fileId}/${filename}`,\n      };\n      writeJson(req, res, 200, responseBody, pathname, journal);\n      return \"handled\";\n    }\n\n    case \"queue-submit\":\n    case \"sync-run\": {\n      const modelId = route.modelId!;\n      const parsedBody = parseBody(body);\n      const prompt = extractPromptFromBody(parsedBody);\n      const syntheticReq: ChatCompletionRequest = {\n        model: modelId,\n        messages: [{ role: \"user\", content: prompt || JSON.stringify(parsedBody ?? {}) }],\n        _endpointType: \"fal\",\n      };\n\n      const matchCounts = journal.getFixtureMatchCountsForTest(testId);\n      const fixture = matchFixture(fixtures, syntheticReq, matchCounts, defaults.requestTransform);\n\n      if (!fixture) {\n        if (defaults.record) {\n          const effectiveDefaults = withFalUpstream(defaults, route.targetHost);\n          const outcome = await proxyAndRecord(\n            req,\n            res,\n            syntheticReq,\n            \"fal\",\n            stripFalPrefix(pathname),\n            fixtures,\n            effectiveDefaults,\n            body,\n          );\n          if (outcome === \"handled_by_hook\") return \"handled\";\n          if (outcome === \"relayed\") {\n            journal.add({\n              method: req.method ?? \"POST\",\n              path: pathname,\n              headers: flattenHeaders(req.headers),\n              body: syntheticReq,\n              response: { status: res.statusCode ?? 200, fixture: null, source: \"proxy\" },\n            });\n            return \"handled\";\n          }\n        }\n\n        const strictStatus = defaults.strict ? 503 : 404;\n        const strictMessage = defaults.strict\n          ? \"Strict mode: no fixture matched\"\n          : \"No fixture matched\";\n        journal.add({\n          method: req.method ?? \"POST\",\n          path: pathname,\n          headers: flattenHeaders(req.headers),\n          body: syntheticReq,\n          response: { status: strictStatus, fixture: null },\n        });\n        res.writeHead(strictStatus, { \"Content-Type\": \"application/json\" });\n        res.end(\n          JSON.stringify({\n            error: {\n              message: strictMessage,\n              type: \"invalid_request_error\",\n              code: \"no_fixture_match\",\n            },\n          }),\n        );\n        return \"handled\";\n      }\n\n      journal.incrementFixtureMatchCount(fixture, fixtures, testId);\n      const response = fixture.response;\n\n      if (isErrorResponse(response)) {\n        const status = response.status ?? 500;\n        journal.add({\n          method: req.method ?? \"POST\",\n          path: pathname,\n          headers: flattenHeaders(req.headers),\n          body: syntheticReq,\n          response: { status, fixture },\n        });\n        res.writeHead(status, { \"Content-Type\": \"application/json\" });\n        res.end(JSON.stringify(response));\n        return \"handled\";\n      }\n\n      let payload: unknown;\n      if (isJSONResponse(response)) {\n        payload = (response as RawJSONResponse).json;\n      } else if (isAudioResponse(response)) {\n        payload = audioToFalFile(response);\n      } else {\n        journal.add({\n          method: req.method ?? \"POST\",\n          path: pathname,\n          headers: flattenHeaders(req.headers),\n          body: syntheticReq,\n          response: { status: 500, fixture },\n        });\n        res.writeHead(500, { \"Content-Type\": \"application/json\" });\n        res.end(\n          JSON.stringify({\n            error: {\n              message: \"Fixture response is not JSON or audio for fal endpoint\",\n              type: \"server_error\",\n            },\n          }),\n        );\n        return \"handled\";\n      }\n\n      if (route.kind === \"sync-run\") {\n        journal.add({\n          method: req.method ?? \"POST\",\n          path: pathname,\n          headers: flattenHeaders(req.headers),\n          body: syntheticReq,\n          response: { status: 200, fixture },\n        });\n        res.writeHead(200, { \"Content-Type\": \"application/json\" });\n        res.end(JSON.stringify(payload));\n        return \"handled\";\n      }\n\n      const requestId = crypto.randomUUID();\n      falQueueStates.set(stateKey(requestId), {\n        requestId,\n        modelId,\n        status: \"COMPLETED\",\n        result: payload,\n        createdAt: Date.now(),\n      });\n      const envelope = {\n        request_id: requestId,\n        response_url: `https://${FAL_HOSTS.queue}/${modelId}/requests/${requestId}`,\n        status_url: `https://${FAL_HOSTS.queue}/${modelId}/requests/${requestId}/status`,\n        cancel_url: `https://${FAL_HOSTS.queue}/${modelId}/requests/${requestId}/cancel`,\n        queue_position: 0,\n      };\n      journal.add({\n        method: req.method ?? \"POST\",\n        path: pathname,\n        headers: flattenHeaders(req.headers),\n        body: syntheticReq,\n        response: { status: 200, fixture },\n      });\n      res.writeHead(200, { \"Content-Type\": \"application/json\" });\n      res.end(JSON.stringify(envelope));\n      return \"handled\";\n    }\n  }\n}\n\nfunction parseBody(raw: string): Record<string, unknown> | null {\n  if (!raw.trim()) return null;\n  try {\n    return JSON.parse(raw) as Record<string, unknown>;\n  } catch {\n    return null;\n  }\n}\n\nfunction withFalUpstream(defaults: HandlerDefaults, targetHost: string): HandlerDefaults {\n  if (!defaults.record) return defaults;\n  // Respect an explicit record.providers.fal — tests and dev configs need to\n  // point at a stub upstream. Only synthesise from the header when the user\n  // didn't configure one (the \"or omit upstream URL — it's in the request\n  // hostname\" mode from the issue).\n  if (defaults.record.providers.fal) return defaults;\n  return {\n    ...defaults,\n    record: {\n      ...defaults.record,\n      providers: {\n        ...defaults.record.providers,\n        fal: `https://${targetHost}`,\n      },\n    },\n  };\n}\n\nfunction writeJson(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  status: number,\n  payload: unknown,\n  pathname: string,\n  journal: Journal,\n): void {\n  journal.add({\n    method: req.method ?? \"GET\",\n    path: pathname,\n    headers: flattenHeaders(req.headers),\n    body: null,\n    response: { status, fixture: null },\n  });\n  res.writeHead(status, { \"Content-Type\": \"application/json\" });\n  res.end(JSON.stringify(payload));\n}\n\nfunction respondNotFound(\n  req: http.IncomingMessage,\n  res: http.ServerResponse,\n  pathname: string,\n  journal: Journal,\n  requestId: string,\n): void {\n  journal.add({\n    method: req.method ?? \"GET\",\n    path: pathname,\n    headers: flattenHeaders(req.headers),\n    body: null,\n    response: { status: 404, fixture: null },\n  });\n  res.writeHead(404, { \"Content-Type\": \"application/json\" });\n  res.end(\n    JSON.stringify({\n      error: { message: `Request ${requestId} not found`, type: \"not_found\" },\n    }),\n  );\n}\n"],"mappings":"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"}

package/dist/fal.d.cts

@@ -0,0 +1,39 @@
+import { Journal } from "./journal.cjs";
+import { Fixture, HandlerDefaults } from "./types.cjs";
+import http from "node:http";
+
+//#region src/fal.d.ts
+interface FalQueueJob {
+  requestId: string;
+  modelId: string;
+  status: "IN_QUEUE" | "IN_PROGRESS" | "COMPLETED";
+  result: unknown;
+  createdAt: number;
+}
+/**
+ * Per-testId queue state for the general fal handler. Mirrors FalJobMap from
+ * fal-audio.ts but stores arbitrary JSON payloads instead of audio file
+ * objects, so it can serve any fal model (image, video, motion, music, etc.).
+ */
+declare class FalQueueStateMap {
+  private readonly entries;
+  get(key: string): FalQueueJob | undefined;
+  set(key: string, job: FalQueueJob): void;
+  delete(key: string): boolean;
+  clear(): void;
+  get size(): number;
+}
+type HandleFalOutcome = "handled" | "passthrough";
+/**
+ * General fal.ai handler. Routes by `x-fal-target-host` header (the convention
+ * used by `@fal-ai/client`'s server-side requestMiddleware workaround for the
+ * fact that `proxyUrl` is browser-only).
+ *
+ * Returns `"passthrough"` when the request does not look like a host-mirrored
+ * fal call, so the caller can fall back to the legacy `/fal/queue/...` and
+ * `/fal/run/...` audio routes.
+ */
+declare function handleFal(req: http.IncomingMessage, res: http.ServerResponse, body: string, pathname: string, fixtures: Fixture[], defaults: HandlerDefaults, journal: Journal): Promise<HandleFalOutcome>;
+//#endregion
+export { FalQueueStateMap, handleFal };
+//# sourceMappingURL=fal.d.cts.map

package/dist/fal.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fal.d.cts","names":[],"sources":["../src/fal.ts"],"sourcesContent":[],"mappings":";;;;;UAoBU,WAAA;;EAAA,OAAA,EAAA,MAAW;EAkBR,MAAA,EAAA,UAAA,GAAgB,aAAA,GAAA,WAAA;EAAA,MAAA,EAAA,OAAA;WAGT,EAAA,MAAA;;;AAyFpB;AA+EA;;;AAEO,cA7KM,gBAAA,CA6KD;mBAGA,OAAA;KACA,CAAA,GAAA,EAAA,MAAA,CAAA,EA9KQ,WA8KR,GAAA,SAAA;KACD,CAAA,GAAA,EAAA,MAAA,EAAA,GAAA,EArKa,WAqKb,CAAA,EAAA,IAAA;QACA,CAAA,GAAA,EAAA,MAAA,CAAA,EAAA,OAAA;OAAR,CAAA,CAAA,EAAA,IAAA;EAAO,IAAA,IAAA,CAAA,CAAA,EAAA,MAAA;;KAvFE,gBAAA;;;;;;;;;;iBA+EU,SAAA,MACf,IAAA,CAAK,sBACL,IAAA,CAAK,0DAGA,qBACA,0BACD,UACR,QAAQ"}

package/dist/fal.d.ts

@@ -0,0 +1,39 @@
+import { Journal } from "./journal.js";
+import { Fixture, HandlerDefaults } from "./types.js";
+import http from "node:http";
+
+//#region src/fal.d.ts
+interface FalQueueJob {
+  requestId: string;
+  modelId: string;
+  status: "IN_QUEUE" | "IN_PROGRESS" | "COMPLETED";
+  result: unknown;
+  createdAt: number;
+}
+/**
+ * Per-testId queue state for the general fal handler. Mirrors FalJobMap from
+ * fal-audio.ts but stores arbitrary JSON payloads instead of audio file
+ * objects, so it can serve any fal model (image, video, motion, music, etc.).
+ */
+declare class FalQueueStateMap {
+  private readonly entries;
+  get(key: string): FalQueueJob | undefined;
+  set(key: string, job: FalQueueJob): void;
+  delete(key: string): boolean;
+  clear(): void;
+  get size(): number;
+}
+type HandleFalOutcome = "handled" | "passthrough";
+/**
+ * General fal.ai handler. Routes by `x-fal-target-host` header (the convention
+ * used by `@fal-ai/client`'s server-side requestMiddleware workaround for the
+ * fact that `proxyUrl` is browser-only).
+ *
+ * Returns `"passthrough"` when the request does not look like a host-mirrored
+ * fal call, so the caller can fall back to the legacy `/fal/queue/...` and
+ * `/fal/run/...` audio routes.
+ */
+declare function handleFal(req: http.IncomingMessage, res: http.ServerResponse, body: string, pathname: string, fixtures: Fixture[], defaults: HandlerDefaults, journal: Journal): Promise<HandleFalOutcome>;
+//#endregion
+export { FalQueueStateMap, handleFal };
+//# sourceMappingURL=fal.d.ts.map

package/dist/fal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fal.d.ts","names":[],"sources":["../src/fal.ts"],"sourcesContent":[],"mappings":";;;;;UAoBU,WAAA;;EAAA,OAAA,EAAA,MAAW;EAkBR,MAAA,EAAA,UAAA,GAAgB,aAAA,GAAA,WAAA;EAAA,MAAA,EAAA,OAAA;WAGT,EAAA,MAAA;;;AAyFpB;AA+EA;;;AAEO,cA7KM,gBAAA,CA6KD;mBAGA,OAAA;KACA,CAAA,GAAA,EAAA,MAAA,CAAA,EA9KQ,WA8KR,GAAA,SAAA;KACD,CAAA,GAAA,EAAA,MAAA,EAAA,GAAA,EArKa,WAqKb,CAAA,EAAA,IAAA;QACA,CAAA,GAAA,EAAA,MAAA,CAAA,EAAA,OAAA;OAAR,CAAA,CAAA,EAAA,IAAA;EAAO,IAAA,IAAA,CAAA,CAAA,EAAA,MAAA;;KAvFE,gBAAA;;;;;;;;;;iBA+EU,SAAA,MACf,IAAA,CAAK,sBACL,IAAA,CAAK,0DAGA,qBACA,0BACD,UACR,QAAQ"}