@tanstack/ai-fal 0.9.12 → 0.9.14

package/dist/esm/adapters/video.js

@@ -1,165 +1,161 @@
+import { buildFalUsage, takeBillableUnits } from "../utils/billing.js";
+import { configureFalClient, generateId } from "../utils/client.js";
+import { mapImageInputsToFalVideoFields } from "../image/image-inputs.js";
+import { mapVideoSizeToFalFormat } from "../video/video-provider-options.js";
 import { fal } from "@fal-ai/client";
 import { resolveMediaPrompt } from "@tanstack/ai";
 import { BaseVideoAdapter } from "@tanstack/ai/adapters";
-import { configureFalClient, generateId } from "../utils/client.js";
-import { buildFalUsage, takeBillableUnits } from "../utils/billing.js";
-import { mapVideoSizeToFalFormat } from "../video/video-provider-options.js";
-import { mapImageInputsToFalVideoFields } from "../image/image-inputs.js";
+//#region src/adapters/video.ts
+/**
+* Map video conditioning inputs onto fal field names.
+* Video-to-video endpoints on fal almost universally use `video_url`; the
+* occasional model takes `video_urls` (rare). Mirror the image-input logic
+* positionally with a `reference` role escape hatch via `reference_video_urls`.
+*/
 function mapVideoInputsToFalFields(videoInputs) {
-  if (!videoInputs || videoInputs.length === 0) return {};
-  const references = [];
-  const sources = [];
-  for (const part of videoInputs) {
-    const url = videoPartToUrl(part);
-    if (part.metadata?.role === "reference" || part.metadata?.role === "character") {
-      references.push(url);
-    } else {
-      sources.push(url);
-    }
-  }
-  const out = {};
-  if (references.length > 0) out.reference_video_urls = references;
-  if (sources.length === 1) {
-    out.video_url = sources[0];
-  } else if (sources.length > 1) {
-    out.video_urls = sources;
-  }
-  return out;
+	if (!videoInputs || videoInputs.length === 0) return {};
+	const references = [];
+	const sources = [];
+	for (const part of videoInputs) {
+		const url = videoPartToUrl(part);
+		if (part.metadata?.role === "reference" || part.metadata?.role === "character") references.push(url);
+		else sources.push(url);
+	}
+	const out = {};
+	if (references.length > 0) out.reference_video_urls = references;
+	if (sources.length === 1) out.video_url = sources[0];
+	else if (sources.length > 1) out.video_urls = sources;
+	return out;
 }
 function mapAudioInputsToFalFields(audioInputs) {
-  if (!audioInputs || audioInputs.length === 0) return {};
-  const [part, ...rest] = audioInputs;
-  if (!part || rest.length > 0) {
-    throw new Error(
-      `fal: exactly one audio prompt part is supported (received ${audioInputs.length}).`
-    );
-  }
-  return {
-    audio_url: part.source.type === "url" ? part.source.value : `data:${part.source.mimeType};base64,${part.source.value}`
-  };
+	if (!audioInputs || audioInputs.length === 0) return {};
+	const [part, ...rest] = audioInputs;
+	if (!part || rest.length > 0) throw new Error(`fal: exactly one audio prompt part is supported (received ${audioInputs.length}).`);
+	return { audio_url: part.source.type === "url" ? part.source.value : `data:${part.source.mimeType};base64,${part.source.value}` };
 }
 function videoPartToUrl(part) {
-  return part.source.type === "url" ? part.source.value : `data:${part.source.mimeType};base64,${part.source.value}`;
+	return part.source.type === "url" ? part.source.value : `data:${part.source.mimeType};base64,${part.source.value}`;
 }
+/**
+* Maps fal.ai queue status to TanStack AI video status.
+*
+* Note: fal.ai does not return a FAILED queue status. Errors surface
+* as exceptions when fetching results from a COMPLETED job (e.g. 422
+* validation errors). Those are handled in getVideoUrl().
+*/
 function mapFalStatusToVideoStatus(falStatus) {
-  switch (falStatus) {
-    case "IN_QUEUE":
-      return "pending";
-    case "IN_PROGRESS":
-      return "processing";
-    case "COMPLETED":
-      return "completed";
-    default:
-      return "processing";
-  }
-}
-class FalVideoAdapter extends BaseVideoAdapter {
-  kind = "video";
-  name = "fal";
-  constructor(model, config) {
-    super({}, model);
-    configureFalClient(config);
-  }
-  async createVideoJob(options) {
-    const { size, duration, modelOptions, logger } = options;
-    logger.request(`activity=generateVideo provider=fal model=${this.model}`, {
-      provider: "fal",
-      model: this.model
-    });
-    try {
-      const resolved = resolveMediaPrompt(options.prompt);
-      const sizeParams = mapVideoSizeToFalFormat(size);
-      const inputImageFields = mapImageInputsToFalVideoFields(
-        this.model,
-        resolved.images
-      );
-      const videoFields = mapVideoInputsToFalFields(resolved.videos);
-      const audioFields = mapAudioInputsToFalFields(resolved.audios);
-      const input = {
-        ...sizeParams,
-        ...inputImageFields,
-        ...videoFields,
-        ...audioFields,
-        // modelOptions applied after derived media fields so explicit user
-        // overrides (video_url, reference_video_urls, audio_url, ...) win.
-        ...modelOptions,
-        // Media-only prompts omit the prompt field rather than sending an
-        // empty string (e.g. pure image-to-video endpoints).
-        ...resolved.text ? { prompt: resolved.text } : {},
-        ...duration ? { duration } : {}
-      };
-      const { request_id } = await fal.queue.submit(this.model, {
-        input
-      });
-      return {
-        jobId: request_id,
-        model: this.model
-      };
-    } catch (error) {
-      logger.errors("fal.createVideoJob fatal", {
-        error,
-        source: "fal.createVideoJob"
-      });
-      throw error;
-    }
-  }
-  async getVideoStatus(jobId) {
-    const statusResponse = await fal.queue.status(this.model, {
-      requestId: jobId,
-      logs: true
-    });
-    return {
-      jobId,
-      status: mapFalStatusToVideoStatus(statusResponse.status),
-      ...statusResponse.queue_position != null ? {
-        progress: Math.max(0, 100 - statusResponse.queue_position * 10)
-      } : {}
-    };
-  }
-  async getVideoUrl(jobId) {
-    let result;
-    try {
-      result = await fal.queue.result(this.model, {
-        requestId: jobId
-      });
-    } catch (error) {
-      const err = error;
-      const detail = err.body?.detail;
-      if (Array.isArray(detail)) {
-        const messages = detail.map(
-          (d) => d.loc ? `${d.loc.join(".")}: ${d.msg}` : d.msg
-        );
-        throw new Error(`Video generation failed: ${messages.join("; ")}`);
-      }
-      throw new Error(
-        `Failed to retrieve video result: ${err.message || String(error)}`
-      );
-    }
-    const data = result.data;
-    const url = data.video?.url || data.video_url;
-    if (!url) {
-      throw new Error("Video URL not found in response");
-    }
-    const usage = buildFalUsage(takeBillableUnits(result.requestId));
-    return {
-      jobId,
-      url,
-      ...usage ? { usage } : {}
-    };
-  }
-  generateId() {
-    return generateId(this.name);
-  }
+	switch (falStatus) {
+		case "IN_QUEUE": return "pending";
+		case "IN_PROGRESS": return "processing";
+		case "COMPLETED": return "completed";
+		default: return "processing";
+	}
 }
+/**
+* fal.ai video generation adapter.
+* Supports MiniMax, Luma, Kling, Hunyuan, and other fal.ai video models.
+*
+* Uses fal.ai's comprehensive type system to provide autocomplete
+* and type safety for all supported video models.
+*
+* @experimental Video generation is an experimental feature and may change.
+*/
+var FalVideoAdapter = class extends BaseVideoAdapter {
+	kind = "video";
+	name = "fal";
+	constructor(model, config) {
+		super({}, model);
+		configureFalClient(config);
+	}
+	async createVideoJob(options) {
+		const { size, duration, modelOptions, logger } = options;
+		logger.request(`activity=generateVideo provider=fal model=${this.model}`, {
+			provider: "fal",
+			model: this.model
+		});
+		try {
+			const resolved = resolveMediaPrompt(options.prompt);
+			const sizeParams = mapVideoSizeToFalFormat(size);
+			const inputImageFields = mapImageInputsToFalVideoFields(this.model, resolved.images);
+			const videoFields = mapVideoInputsToFalFields(resolved.videos);
+			const audioFields = mapAudioInputsToFalFields(resolved.audios);
+			const input = {
+				...sizeParams,
+				...inputImageFields,
+				...videoFields,
+				...audioFields,
+				...modelOptions,
+				...resolved.text ? { prompt: resolved.text } : {},
+				...duration ? { duration } : {}
+			};
+			const { request_id } = await fal.queue.submit(this.model, { input });
+			return {
+				jobId: request_id,
+				model: this.model
+			};
+		} catch (error) {
+			logger.errors("fal.createVideoJob fatal", {
+				error,
+				source: "fal.createVideoJob"
+			});
+			throw error;
+		}
+	}
+	async getVideoStatus(jobId) {
+		const statusResponse = await fal.queue.status(this.model, {
+			requestId: jobId,
+			logs: true
+		});
+		return {
+			jobId,
+			status: mapFalStatusToVideoStatus(statusResponse.status),
+			...statusResponse.queue_position != null ? { progress: Math.max(0, 100 - statusResponse.queue_position * 10) } : {}
+		};
+	}
+	async getVideoUrl(jobId) {
+		let result;
+		try {
+			result = await fal.queue.result(this.model, { requestId: jobId });
+		} catch (error) {
+			const err = error;
+			const detail = err.body?.detail;
+			if (Array.isArray(detail)) {
+				const messages = detail.map((d) => d.loc ? `${d.loc.join(".")}: ${d.msg}` : d.msg);
+				throw new Error(`Video generation failed: ${messages.join("; ")}`);
+			}
+			throw new Error(`Failed to retrieve video result: ${err.message || String(error)}`);
+		}
+		const data = result.data;
+		const url = data.video?.url || data.video_url;
+		if (!url) throw new Error("Video URL not found in response");
+		const usage = buildFalUsage(takeBillableUnits(result.requestId));
+		return {
+			jobId,
+			url,
+			...usage ? { usage } : {}
+		};
+	}
+	generateId() {
+		return generateId(this.name);
+	}
+};
+/**
+* Create a fal.ai video adapter with an explicit API key.
+*
+* @experimental Video generation is an experimental feature and may change.
+*/
 function createFalVideo(model, config) {
-  return new FalVideoAdapter(model, config);
+	return new FalVideoAdapter(model, config);
 }
+/**
+* Create a fal.ai video adapter using config.apiKey or the FAL_KEY environment variable.
+*
+* @experimental Video generation is an experimental feature and may change.
+*/
 function falVideo(model, config) {
-  return createFalVideo(model, config);
+	return createFalVideo(model, config);
 }
-export {
-  FalVideoAdapter,
-  createFalVideo,
-  falVideo
-};
-//# sourceMappingURL=video.js.map
+//#endregion
+export { FalVideoAdapter, createFalVideo, falVideo };
+
+//# sourceMappingURL=video.js.map

package/dist/esm/adapters/video.js.map

@@ -1 +1 @@
-{"version":3,"file":"video.js","sources":["../../../src/adapters/video.ts"],"sourcesContent":["import { fal } from '@fal-ai/client'\nimport { resolveMediaPrompt } from '@tanstack/ai'\nimport { BaseVideoAdapter } from '@tanstack/ai/adapters'\nimport {\n  configureFalClient,\n  generateId as utilGenerateId,\n} from '../utils/client'\nimport { buildFalUsage, takeBillableUnits } from '../utils/billing'\nimport { mapVideoSizeToFalFormat } from '../video/video-provider-options'\nimport { mapImageInputsToFalVideoFields } from '../image/image-inputs'\nimport type {\n  AudioPart,\n  MediaInputMetadata,\n  VideoGenerationOptions,\n  VideoJobResult,\n  VideoPart,\n  VideoStatusResult,\n  VideoUrlResult,\n} from '@tanstack/ai'\nimport type {\n  FalModel,\n  FalModelInput,\n  FalModelVideoSize,\n  FalVideoPromptModalitiesFor,\n  FalVideoProviderOptions,\n} from '../model-meta'\nimport type { FalClientConfig } from '../utils/client'\n\n/**\n * Map video conditioning inputs onto fal field names.\n * Video-to-video endpoints on fal almost universally use `video_url`; the\n * occasional model takes `video_urls` (rare). Mirror the image-input logic\n * positionally with a `reference` role escape hatch via `reference_video_urls`.\n */\nfunction mapVideoInputsToFalFields(\n  videoInputs?: ReadonlyArray<VideoPart<MediaInputMetadata>>,\n): Record<string, unknown> {\n  if (!videoInputs || videoInputs.length === 0) return {}\n  const references: Array<string> = []\n  const sources: Array<string> = []\n  for (const part of videoInputs) {\n    const url = videoPartToUrl(part)\n    if (\n      part.metadata?.role === 'reference' ||\n      part.metadata?.role === 'character'\n    ) {\n      references.push(url)\n    } else {\n      sources.push(url)\n    }\n  }\n  const out: Record<string, unknown> = {}\n  if (references.length > 0) out.reference_video_urls = references\n  if (sources.length === 1) {\n    out.video_url = sources[0]\n  } else if (sources.length > 1) {\n    out.video_urls = sources\n  }\n  return out\n}\n\nfunction mapAudioInputsToFalFields(\n  audioInputs?: ReadonlyArray<AudioPart<MediaInputMetadata>>,\n): Record<string, unknown> {\n  if (!audioInputs || audioInputs.length === 0) return {}\n  const [part, ...rest] = audioInputs\n  if (!part || rest.length > 0) {\n    throw new Error(\n      `fal: exactly one audio prompt part is supported (received ${audioInputs.length}).`,\n    )\n  }\n  return {\n    audio_url:\n      part.source.type === 'url'\n        ? part.source.value\n        : `data:${part.source.mimeType};base64,${part.source.value}`,\n  }\n}\n\nfunction videoPartToUrl(part: VideoPart<MediaInputMetadata>): string {\n  return part.source.type === 'url'\n    ? part.source.value\n    : `data:${part.source.mimeType};base64,${part.source.value}`\n}\n\ntype FalQueueStatus = 'IN_QUEUE' | 'IN_PROGRESS' | 'COMPLETED'\n\ninterface FalStatusResponse {\n  status: FalQueueStatus\n  queue_position?: number\n  logs?: Array<{ message: string }>\n}\n\ninterface FalVideoResultData {\n  video?: { url: string }\n  video_url?: string\n}\n\n/**\n * Maps fal.ai queue status to TanStack AI video status.\n *\n * Note: fal.ai does not return a FAILED queue status. Errors surface\n * as exceptions when fetching results from a COMPLETED job (e.g. 422\n * validation errors). Those are handled in getVideoUrl().\n */\nfunction mapFalStatusToVideoStatus(\n  falStatus: FalQueueStatus,\n): VideoStatusResult['status'] {\n  switch (falStatus) {\n    case 'IN_QUEUE':\n      return 'pending'\n    case 'IN_PROGRESS':\n      return 'processing'\n    case 'COMPLETED':\n      return 'completed'\n    default:\n      return 'processing'\n  }\n}\n\n/**\n * fal.ai video generation adapter.\n * Supports MiniMax, Luma, Kling, Hunyuan, and other fal.ai video models.\n *\n * Uses fal.ai's comprehensive type system to provide autocomplete\n * and type safety for all supported video models.\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport class FalVideoAdapter<TModel extends FalModel> extends BaseVideoAdapter<\n  TModel,\n  FalVideoProviderOptions<TModel>,\n  Record<TModel, FalVideoProviderOptions<TModel>>,\n  Record<TModel, FalModelVideoSize<TModel>>,\n  Record<TModel, FalVideoPromptModalitiesFor<TModel>>\n> {\n  override readonly kind = 'video' as const\n  readonly name = 'fal' as const\n\n  constructor(model: TModel, config?: FalClientConfig) {\n    super({}, model)\n    configureFalClient(config)\n  }\n\n  async createVideoJob(\n    options: VideoGenerationOptions<\n      FalVideoProviderOptions<TModel>,\n      FalModelVideoSize<TModel>\n    >,\n  ): Promise<VideoJobResult> {\n    const { size, duration, modelOptions, logger } = options\n\n    logger.request(`activity=generateVideo provider=fal model=${this.model}`, {\n      provider: 'fal',\n      model: this.model,\n    })\n\n    try {\n      const resolved = resolveMediaPrompt(options.prompt)\n      const sizeParams = mapVideoSizeToFalFormat(size)\n      const inputImageFields = mapImageInputsToFalVideoFields(\n        this.model,\n        resolved.images,\n      )\n      const videoFields = mapVideoInputsToFalFields(resolved.videos)\n      const audioFields = mapAudioInputsToFalFields(resolved.audios)\n\n      const input = {\n        ...sizeParams,\n        ...inputImageFields,\n        ...videoFields,\n        ...audioFields,\n        // modelOptions applied after derived media fields so explicit user\n        // overrides (video_url, reference_video_urls, audio_url, ...) win.\n        ...modelOptions,\n        // Media-only prompts omit the prompt field rather than sending an\n        // empty string (e.g. pure image-to-video endpoints).\n        ...(resolved.text ? { prompt: resolved.text } : {}),\n        ...(duration ? { duration } : {}),\n      } as FalModelInput<TModel>\n\n      // Submit to queue and get request ID\n      const { request_id } = await fal.queue.submit(this.model, {\n        input,\n      })\n\n      return {\n        jobId: request_id,\n        model: this.model,\n      }\n    } catch (error) {\n      logger.errors('fal.createVideoJob fatal', {\n        error,\n        source: 'fal.createVideoJob',\n      })\n      throw error\n    }\n  }\n\n  async getVideoStatus(jobId: string): Promise<VideoStatusResult> {\n    const statusResponse = (await fal.queue.status(this.model, {\n      requestId: jobId,\n      logs: true,\n    })) as FalStatusResponse\n\n    return {\n      jobId,\n      status: mapFalStatusToVideoStatus(statusResponse.status),\n      ...(statusResponse.queue_position != null\n        ? {\n            progress: Math.max(0, 100 - statusResponse.queue_position * 10),\n          }\n        : {}),\n    }\n  }\n\n  async getVideoUrl(jobId: string): Promise<VideoUrlResult> {\n    let result\n    try {\n      result = await fal.queue.result(this.model, {\n        requestId: jobId,\n      })\n    } catch (error: unknown) {\n      // fal.ai may report COMPLETED status but throw on result fetch\n      // (e.g. 422 validation errors). Extract the detailed error info.\n      const err = error as { body?: { detail?: unknown }; message?: string }\n      const detail = err.body?.detail\n      if (Array.isArray(detail)) {\n        const messages = detail.map(\n          (d: { msg?: string; loc?: Array<string> }) =>\n            d.loc ? `${d.loc.join('.')}: ${d.msg}` : d.msg,\n        )\n        throw new Error(`Video generation failed: ${messages.join('; ')}`)\n      }\n      throw new Error(\n        `Failed to retrieve video result: ${err.message || String(error)}`,\n      )\n    }\n\n    const data = result.data as FalVideoResultData\n\n    // Different models return video URL in different formats\n    const url = data.video?.url || data.video_url\n    if (!url) {\n      throw new Error('Video URL not found in response')\n    }\n\n    const usage = buildFalUsage(takeBillableUnits(result.requestId))\n\n    return {\n      jobId,\n      url,\n      ...(usage ? { usage } : {}),\n    }\n  }\n\n  protected override generateId(): string {\n    return utilGenerateId(this.name)\n  }\n}\n\n/**\n * Create a fal.ai video adapter with an explicit API key.\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport function createFalVideo<TModel extends FalModel>(\n  model: TModel,\n  config?: FalClientConfig,\n): FalVideoAdapter<TModel> {\n  return new FalVideoAdapter(model, config)\n}\n\n/**\n * Create a fal.ai video adapter using config.apiKey or the FAL_KEY environment variable.\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport function falVideo<TModel extends FalModel>(\n  model: TModel,\n  config?: FalClientConfig,\n): FalVideoAdapter<TModel> {\n  return createFalVideo(model, config)\n}\n"],"names":["utilGenerateId"],"mappings":"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"}
+{"version":3,"file":"video.js","names":[],"sources":["../../../src/adapters/video.ts"],"sourcesContent":["import { fal } from '@fal-ai/client'\nimport { resolveMediaPrompt } from '@tanstack/ai'\nimport { BaseVideoAdapter } from '@tanstack/ai/adapters'\nimport {\n  configureFalClient,\n  generateId as utilGenerateId,\n} from '../utils/client'\nimport { buildFalUsage, takeBillableUnits } from '../utils/billing'\nimport { mapVideoSizeToFalFormat } from '../video/video-provider-options'\nimport { mapImageInputsToFalVideoFields } from '../image/image-inputs'\nimport type {\n  AudioPart,\n  MediaInputMetadata,\n  VideoGenerationOptions,\n  VideoJobResult,\n  VideoPart,\n  VideoStatusResult,\n  VideoUrlResult,\n} from '@tanstack/ai'\nimport type {\n  FalModel,\n  FalModelInput,\n  FalModelVideoSize,\n  FalVideoPromptModalitiesFor,\n  FalVideoProviderOptions,\n} from '../model-meta'\nimport type { FalClientConfig } from '../utils/client'\n\n/**\n * Map video conditioning inputs onto fal field names.\n * Video-to-video endpoints on fal almost universally use `video_url`; the\n * occasional model takes `video_urls` (rare). Mirror the image-input logic\n * positionally with a `reference` role escape hatch via `reference_video_urls`.\n */\nfunction mapVideoInputsToFalFields(\n  videoInputs?: ReadonlyArray<VideoPart<MediaInputMetadata>>,\n): Record<string, unknown> {\n  if (!videoInputs || videoInputs.length === 0) return {}\n  const references: Array<string> = []\n  const sources: Array<string> = []\n  for (const part of videoInputs) {\n    const url = videoPartToUrl(part)\n    if (\n      part.metadata?.role === 'reference' ||\n      part.metadata?.role === 'character'\n    ) {\n      references.push(url)\n    } else {\n      sources.push(url)\n    }\n  }\n  const out: Record<string, unknown> = {}\n  if (references.length > 0) out.reference_video_urls = references\n  if (sources.length === 1) {\n    out.video_url = sources[0]\n  } else if (sources.length > 1) {\n    out.video_urls = sources\n  }\n  return out\n}\n\nfunction mapAudioInputsToFalFields(\n  audioInputs?: ReadonlyArray<AudioPart<MediaInputMetadata>>,\n): Record<string, unknown> {\n  if (!audioInputs || audioInputs.length === 0) return {}\n  const [part, ...rest] = audioInputs\n  if (!part || rest.length > 0) {\n    throw new Error(\n      `fal: exactly one audio prompt part is supported (received ${audioInputs.length}).`,\n    )\n  }\n  return {\n    audio_url:\n      part.source.type === 'url'\n        ? part.source.value\n        : `data:${part.source.mimeType};base64,${part.source.value}`,\n  }\n}\n\nfunction videoPartToUrl(part: VideoPart<MediaInputMetadata>): string {\n  return part.source.type === 'url'\n    ? part.source.value\n    : `data:${part.source.mimeType};base64,${part.source.value}`\n}\n\ntype FalQueueStatus = 'IN_QUEUE' | 'IN_PROGRESS' | 'COMPLETED'\n\ninterface FalStatusResponse {\n  status: FalQueueStatus\n  queue_position?: number\n  logs?: Array<{ message: string }>\n}\n\ninterface FalVideoResultData {\n  video?: { url: string }\n  video_url?: string\n}\n\n/**\n * Maps fal.ai queue status to TanStack AI video status.\n *\n * Note: fal.ai does not return a FAILED queue status. Errors surface\n * as exceptions when fetching results from a COMPLETED job (e.g. 422\n * validation errors). Those are handled in getVideoUrl().\n */\nfunction mapFalStatusToVideoStatus(\n  falStatus: FalQueueStatus,\n): VideoStatusResult['status'] {\n  switch (falStatus) {\n    case 'IN_QUEUE':\n      return 'pending'\n    case 'IN_PROGRESS':\n      return 'processing'\n    case 'COMPLETED':\n      return 'completed'\n    default:\n      return 'processing'\n  }\n}\n\n/**\n * fal.ai video generation adapter.\n * Supports MiniMax, Luma, Kling, Hunyuan, and other fal.ai video models.\n *\n * Uses fal.ai's comprehensive type system to provide autocomplete\n * and type safety for all supported video models.\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport class FalVideoAdapter<TModel extends FalModel> extends BaseVideoAdapter<\n  TModel,\n  FalVideoProviderOptions<TModel>,\n  Record<TModel, FalVideoProviderOptions<TModel>>,\n  Record<TModel, FalModelVideoSize<TModel>>,\n  Record<TModel, FalVideoPromptModalitiesFor<TModel>>\n> {\n  override readonly kind = 'video' as const\n  readonly name = 'fal' as const\n\n  constructor(model: TModel, config?: FalClientConfig) {\n    super({}, model)\n    configureFalClient(config)\n  }\n\n  async createVideoJob(\n    options: VideoGenerationOptions<\n      FalVideoProviderOptions<TModel>,\n      FalModelVideoSize<TModel>\n    >,\n  ): Promise<VideoJobResult> {\n    const { size, duration, modelOptions, logger } = options\n\n    logger.request(`activity=generateVideo provider=fal model=${this.model}`, {\n      provider: 'fal',\n      model: this.model,\n    })\n\n    try {\n      const resolved = resolveMediaPrompt(options.prompt)\n      const sizeParams = mapVideoSizeToFalFormat(size)\n      const inputImageFields = mapImageInputsToFalVideoFields(\n        this.model,\n        resolved.images,\n      )\n      const videoFields = mapVideoInputsToFalFields(resolved.videos)\n      const audioFields = mapAudioInputsToFalFields(resolved.audios)\n\n      const input = {\n        ...sizeParams,\n        ...inputImageFields,\n        ...videoFields,\n        ...audioFields,\n        // modelOptions applied after derived media fields so explicit user\n        // overrides (video_url, reference_video_urls, audio_url, ...) win.\n        ...modelOptions,\n        // Media-only prompts omit the prompt field rather than sending an\n        // empty string (e.g. pure image-to-video endpoints).\n        ...(resolved.text ? { prompt: resolved.text } : {}),\n        ...(duration ? { duration } : {}),\n      } as FalModelInput<TModel>\n\n      // Submit to queue and get request ID\n      const { request_id } = await fal.queue.submit(this.model, {\n        input,\n      })\n\n      return {\n        jobId: request_id,\n        model: this.model,\n      }\n    } catch (error) {\n      logger.errors('fal.createVideoJob fatal', {\n        error,\n        source: 'fal.createVideoJob',\n      })\n      throw error\n    }\n  }\n\n  async getVideoStatus(jobId: string): Promise<VideoStatusResult> {\n    const statusResponse = (await fal.queue.status(this.model, {\n      requestId: jobId,\n      logs: true,\n    })) as FalStatusResponse\n\n    return {\n      jobId,\n      status: mapFalStatusToVideoStatus(statusResponse.status),\n      ...(statusResponse.queue_position != null\n        ? {\n            progress: Math.max(0, 100 - statusResponse.queue_position * 10),\n          }\n        : {}),\n    }\n  }\n\n  async getVideoUrl(jobId: string): Promise<VideoUrlResult> {\n    let result\n    try {\n      result = await fal.queue.result(this.model, {\n        requestId: jobId,\n      })\n    } catch (error: unknown) {\n      // fal.ai may report COMPLETED status but throw on result fetch\n      // (e.g. 422 validation errors). Extract the detailed error info.\n      const err = error as { body?: { detail?: unknown }; message?: string }\n      const detail = err.body?.detail\n      if (Array.isArray(detail)) {\n        const messages = detail.map(\n          (d: { msg?: string; loc?: Array<string> }) =>\n            d.loc ? `${d.loc.join('.')}: ${d.msg}` : d.msg,\n        )\n        throw new Error(`Video generation failed: ${messages.join('; ')}`)\n      }\n      throw new Error(\n        `Failed to retrieve video result: ${err.message || String(error)}`,\n      )\n    }\n\n    const data = result.data as FalVideoResultData\n\n    // Different models return video URL in different formats\n    const url = data.video?.url || data.video_url\n    if (!url) {\n      throw new Error('Video URL not found in response')\n    }\n\n    const usage = buildFalUsage(takeBillableUnits(result.requestId))\n\n    return {\n      jobId,\n      url,\n      ...(usage ? { usage } : {}),\n    }\n  }\n\n  protected override generateId(): string {\n    return utilGenerateId(this.name)\n  }\n}\n\n/**\n * Create a fal.ai video adapter with an explicit API key.\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport function createFalVideo<TModel extends FalModel>(\n  model: TModel,\n  config?: FalClientConfig,\n): FalVideoAdapter<TModel> {\n  return new FalVideoAdapter(model, config)\n}\n\n/**\n * Create a fal.ai video adapter using config.apiKey or the FAL_KEY environment variable.\n *\n * @experimental Video generation is an experimental feature and may change.\n */\nexport function falVideo<TModel extends FalModel>(\n  model: TModel,\n  config?: FalClientConfig,\n): FalVideoAdapter<TModel> {\n  return createFalVideo(model, config)\n}\n"],"mappings":"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"}