@tanstack/ai-fal 0.15.3 → 0.15.4

package/dist/esm/adapters/video.d.ts

@@ -18,7 +18,6 @@ export declare class FalVideoAdapter<TModel extends FalModel> extends BaseVideoA
     constructor(model: TModel, config?: FalClientConfig);
     createVideoJob(options: VideoGenerationOptions<FalVideoProviderOptions<TModel>, FalModelVideoSize<TModel>, FalModelVideoDuration<TModel>>): Promise<VideoJobResult>;
     availableDurations(): DurationOptions<FalModelVideoDuration<TModel>>;
-    snapDuration(seconds: number): FalModelVideoDuration<TModel> | undefined;
     getVideoStatus(jobId: string): Promise<VideoStatusResult>;
     getVideoUrl(jobId: string): Promise<VideoUrlResult>;
     protected generateId(): string;

package/dist/esm/adapters/video.js

@@ -4,7 +4,7 @@ import { contentSourceToFalUrl, mapImageInputsToFalVideoFields } from "../image/
 import { getFalVideoDurationOptions, mapVideoSizeToFalFormat } from "../video/video-provider-options.js";
 import { fal } from "@fal-ai/client";
 import { resolveMediaPrompt } from "@tanstack/ai";
-import { BaseVideoAdapter, snapToDurationOption } from "@tanstack/ai/adapters";
+import { BaseVideoAdapter } from "@tanstack/ai/adapters";
 //#region src/adapters/video.ts
 /**
 * Map video conditioning inputs onto fal field names.
@@ -108,9 +108,6 @@ var FalVideoAdapter = class extends BaseVideoAdapter {
 	availableDurations() {
 		return getFalVideoDurationOptions(this.model);
 	}
-	snapDuration(seconds) {
-		return snapToDurationOption(seconds, this.availableDurations());
-	}
 	async getVideoStatus(jobId) {
 		const statusResponse = await fal.queue.status(this.model, {
 			requestId: jobId,

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

@@ -1 +1 @@
-{"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, snapToDurationOption } from '@tanstack/ai/adapters'\nimport {\n  configureFalClient,\n  generateId as utilGenerateId,\n} from '../utils/client'\nimport { buildFalUsage, takeBillableUnits } from '../utils/billing'\nimport {\n  getFalVideoDurationOptions,\n  mapVideoSizeToFalFormat,\n} from '../video/video-provider-options'\nimport {\n  contentSourceToFalUrl,\n  mapImageInputsToFalVideoFields,\n} from '../image/image-inputs'\nimport type { DurationOptions } from '@tanstack/ai/adapters'\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  FalModelVideoDuration,\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: contentSourceToFalUrl(part.source),\n  }\n}\n\nfunction videoPartToUrl(part: VideoPart<MediaInputMetadata>): string {\n  return contentSourceToFalUrl(part.source)\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  Record<TModel, FalModelVideoDuration<TModel>>\n> {\n  override readonly kind = 'video' as const\n  readonly name = 'fal' as const\n  // Consumes fal storage URLs uploaded via falFiles().\n  override readonly supportsFileSources = true\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      FalModelVideoDuration<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 !== undefined ? { duration } : {}),\n      } as FalModelInput<TModel>\n\n      // Submit to queue and get request ID. Request-specific abortSignal only —\n      // never via fal.config() (global; would cancel concurrent jobs).\n      const { request_id } = await fal.queue.submit(this.model, {\n        input,\n        ...(options.abortSignal ? { abortSignal: options.abortSignal } : {}),\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  override availableDurations(): DurationOptions<\n    FalModelVideoDuration<TModel>\n  > {\n    return getFalVideoDurationOptions(this.model)\n  }\n\n  override snapDuration(\n    seconds: number,\n  ): FalModelVideoDuration<TModel> | undefined {\n    return snapToDurationOption(seconds, this.availableDurations())\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":";;;;;;;;;;;;;;AA0CA,SAAS,0BACP,aACyB;CACzB,IAAI,CAAC,eAAe,YAAY,WAAW,GAAG,OAAO,CAAC;CACtD,MAAM,aAA4B,CAAC;CACnC,MAAM,UAAyB,CAAC;CAChC,KAAK,MAAM,QAAQ,aAAa;EAC9B,MAAM,MAAM,eAAe,IAAI;EAC/B,IACE,KAAK,UAAU,SAAS,eACxB,KAAK,UAAU,SAAS,aAExB,WAAW,KAAK,GAAG;OAEnB,QAAQ,KAAK,GAAG;CAEpB;CACA,MAAM,MAA+B,CAAC;CACtC,IAAI,WAAW,SAAS,GAAG,IAAI,uBAAuB;CACtD,IAAI,QAAQ,WAAW,GACrB,IAAI,YAAY,QAAQ;MACnB,IAAI,QAAQ,SAAS,GAC1B,IAAI,aAAa;CAEnB,OAAO;AACT;AAEA,SAAS,0BACP,aACyB;CACzB,IAAI,CAAC,eAAe,YAAY,WAAW,GAAG,OAAO,CAAC;CACtD,MAAM,CAAC,MAAM,GAAG,QAAQ;CACxB,IAAI,CAAC,QAAQ,KAAK,SAAS,GACzB,MAAM,IAAI,MACR,6DAA6D,YAAY,OAAO,GAClF;CAEF,OAAO,EACL,WAAW,sBAAsB,KAAK,MAAM,EAC9C;AACF;AAEA,SAAS,eAAe,MAA6C;CACnE,OAAO,sBAAsB,KAAK,MAAM;AAC1C;;;;;;;;AAsBA,SAAS,0BACP,WAC6B;CAC7B,QAAQ,WAAR;EACE,KAAK,YACH,OAAO;EACT,KAAK,eACH,OAAO;EACT,KAAK,aACH,OAAO;EACT,SACE,OAAO;CACX;AACF;;;;;;;;;;AAWA,IAAa,kBAAb,cAA8D,iBAO5D;CACA,OAAyB;CACzB,OAAgB;CAEhB,sBAAwC;CAExC,YAAY,OAAe,QAA0B;EACnD,MAAM,CAAC,GAAG,KAAK;EACf,mBAAmB,MAAM;CAC3B;CAEA,MAAM,eACJ,SAKyB;EACzB,MAAM,EAAE,MAAM,UAAU,cAAc,WAAW;EAEjD,OAAO,QAAQ,6CAA6C,KAAK,SAAS;GACxE,UAAU;GACV,OAAO,KAAK;EACd,CAAC;EAED,IAAI;GACF,MAAM,WAAW,mBAAmB,QAAQ,MAAM;GAClD,MAAM,aAAa,wBAAwB,IAAI;GAC/C,MAAM,mBAAmB,+BACvB,KAAK,OACL,SAAS,MACX;GACA,MAAM,cAAc,0BAA0B,SAAS,MAAM;GAC7D,MAAM,cAAc,0BAA0B,SAAS,MAAM;GAE7D,MAAM,QAAQ;IACZ,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IAGH,GAAG;IAGH,GAAI,SAAS,OAAO,EAAE,QAAQ,SAAS,KAAK,IAAI,CAAC;IACjD,GAAI,aAAa,KAAA,IAAY,EAAE,SAAS,IAAI,CAAC;GAC/C;GAIA,MAAM,EAAE,eAAe,MAAM,IAAI,MAAM,OAAO,KAAK,OAAO;IACxD;IACA,GAAI,QAAQ,cAAc,EAAE,aAAa,QAAQ,YAAY,IAAI,CAAC;GACpE,CAAC;GAED,OAAO;IACL,OAAO;IACP,OAAO,KAAK;GACd;EACF,SAAS,OAAO;GACd,OAAO,OAAO,4BAA4B;IACxC;IACA,QAAQ;GACV,CAAC;GACD,MAAM;EACR;CACF;CAEA,qBAEE;EACA,OAAO,2BAA2B,KAAK,KAAK;CAC9C;CAEA,aACE,SAC2C;EAC3C,OAAO,qBAAqB,SAAS,KAAK,mBAAmB,CAAC;CAChE;CAEA,MAAM,eAAe,OAA2C;EAC9D,MAAM,iBAAkB,MAAM,IAAI,MAAM,OAAO,KAAK,OAAO;GACzD,WAAW;GACX,MAAM;EACR,CAAC;EAED,OAAO;GACL;GACA,QAAQ,0BAA0B,eAAe,MAAM;GACvD,GAAI,eAAe,kBAAkB,OACjC,EACE,UAAU,KAAK,IAAI,GAAG,MAAM,eAAe,iBAAiB,EAAE,EAChE,IACA,CAAC;EACP;CACF;CAEA,MAAM,YAAY,OAAwC;EACxD,IAAI;EACJ,IAAI;GACF,SAAS,MAAM,IAAI,MAAM,OAAO,KAAK,OAAO,EAC1C,WAAW,MACb,CAAC;EACH,SAAS,OAAgB;GAGvB,MAAM,MAAM;GACZ,MAAM,SAAS,IAAI,MAAM;GACzB,IAAI,MAAM,QAAQ,MAAM,GAAG;IACzB,MAAM,WAAW,OAAO,KACrB,MACC,EAAE,MAAM,GAAG,EAAE,IAAI,KAAK,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,GAC/C;IACA,MAAM,IAAI,MAAM,4BAA4B,SAAS,KAAK,IAAI,GAAG;GACnE;GACA,MAAM,IAAI,MACR,oCAAoC,IAAI,WAAW,OAAO,KAAK,GACjE;EACF;EAEA,MAAM,OAAO,OAAO;EAGpB,MAAM,MAAM,KAAK,OAAO,OAAO,KAAK;EACpC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,iCAAiC;EAGnD,MAAM,QAAQ,cAAc,kBAAkB,OAAO,SAAS,CAAC;EAE/D,OAAO;GACL;GACA;GACA,GAAI,QAAQ,EAAE,MAAM,IAAI,CAAC;EAC3B;CACF;CAEA,aAAwC;EACtC,OAAO,WAAe,KAAK,IAAI;CACjC;AACF;;;;;;AAOA,SAAgB,eACd,OACA,QACyB;CACzB,OAAO,IAAI,gBAAgB,OAAO,MAAM;AAC1C;;;;;;AAOA,SAAgB,SACd,OACA,QACyB;CACzB,OAAO,eAAe,OAAO,MAAM;AACrC"}
+{"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 {\n  getFalVideoDurationOptions,\n  mapVideoSizeToFalFormat,\n} from '../video/video-provider-options'\nimport {\n  contentSourceToFalUrl,\n  mapImageInputsToFalVideoFields,\n} from '../image/image-inputs'\nimport type { DurationOptions } from '@tanstack/ai/adapters'\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  FalModelVideoDuration,\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: contentSourceToFalUrl(part.source),\n  }\n}\n\nfunction videoPartToUrl(part: VideoPart<MediaInputMetadata>): string {\n  return contentSourceToFalUrl(part.source)\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  Record<TModel, FalModelVideoDuration<TModel>>\n> {\n  override readonly kind = 'video' as const\n  readonly name = 'fal' as const\n  // Consumes fal storage URLs uploaded via falFiles().\n  override readonly supportsFileSources = true\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      FalModelVideoDuration<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 !== undefined ? { duration } : {}),\n      } as FalModelInput<TModel>\n\n      // Submit to queue and get request ID. Request-specific abortSignal only —\n      // never via fal.config() (global; would cancel concurrent jobs).\n      const { request_id } = await fal.queue.submit(this.model, {\n        input,\n        ...(options.abortSignal ? { abortSignal: options.abortSignal } : {}),\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  override availableDurations(): DurationOptions<\n    FalModelVideoDuration<TModel>\n  > {\n    return getFalVideoDurationOptions(this.model)\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":";;;;;;;;;;;;;;AA0CA,SAAS,0BACP,aACyB;CACzB,IAAI,CAAC,eAAe,YAAY,WAAW,GAAG,OAAO,CAAC;CACtD,MAAM,aAA4B,CAAC;CACnC,MAAM,UAAyB,CAAC;CAChC,KAAK,MAAM,QAAQ,aAAa;EAC9B,MAAM,MAAM,eAAe,IAAI;EAC/B,IACE,KAAK,UAAU,SAAS,eACxB,KAAK,UAAU,SAAS,aAExB,WAAW,KAAK,GAAG;OAEnB,QAAQ,KAAK,GAAG;CAEpB;CACA,MAAM,MAA+B,CAAC;CACtC,IAAI,WAAW,SAAS,GAAG,IAAI,uBAAuB;CACtD,IAAI,QAAQ,WAAW,GACrB,IAAI,YAAY,QAAQ;MACnB,IAAI,QAAQ,SAAS,GAC1B,IAAI,aAAa;CAEnB,OAAO;AACT;AAEA,SAAS,0BACP,aACyB;CACzB,IAAI,CAAC,eAAe,YAAY,WAAW,GAAG,OAAO,CAAC;CACtD,MAAM,CAAC,MAAM,GAAG,QAAQ;CACxB,IAAI,CAAC,QAAQ,KAAK,SAAS,GACzB,MAAM,IAAI,MACR,6DAA6D,YAAY,OAAO,GAClF;CAEF,OAAO,EACL,WAAW,sBAAsB,KAAK,MAAM,EAC9C;AACF;AAEA,SAAS,eAAe,MAA6C;CACnE,OAAO,sBAAsB,KAAK,MAAM;AAC1C;;;;;;;;AAsBA,SAAS,0BACP,WAC6B;CAC7B,QAAQ,WAAR;EACE,KAAK,YACH,OAAO;EACT,KAAK,eACH,OAAO;EACT,KAAK,aACH,OAAO;EACT,SACE,OAAO;CACX;AACF;;;;;;;;;;AAWA,IAAa,kBAAb,cAA8D,iBAO5D;CACA,OAAyB;CACzB,OAAgB;CAEhB,sBAAwC;CAExC,YAAY,OAAe,QAA0B;EACnD,MAAM,CAAC,GAAG,KAAK;EACf,mBAAmB,MAAM;CAC3B;CAEA,MAAM,eACJ,SAKyB;EACzB,MAAM,EAAE,MAAM,UAAU,cAAc,WAAW;EAEjD,OAAO,QAAQ,6CAA6C,KAAK,SAAS;GACxE,UAAU;GACV,OAAO,KAAK;EACd,CAAC;EAED,IAAI;GACF,MAAM,WAAW,mBAAmB,QAAQ,MAAM;GAClD,MAAM,aAAa,wBAAwB,IAAI;GAC/C,MAAM,mBAAmB,+BACvB,KAAK,OACL,SAAS,MACX;GACA,MAAM,cAAc,0BAA0B,SAAS,MAAM;GAC7D,MAAM,cAAc,0BAA0B,SAAS,MAAM;GAE7D,MAAM,QAAQ;IACZ,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IAGH,GAAG;IAGH,GAAI,SAAS,OAAO,EAAE,QAAQ,SAAS,KAAK,IAAI,CAAC;IACjD,GAAI,aAAa,KAAA,IAAY,EAAE,SAAS,IAAI,CAAC;GAC/C;GAIA,MAAM,EAAE,eAAe,MAAM,IAAI,MAAM,OAAO,KAAK,OAAO;IACxD;IACA,GAAI,QAAQ,cAAc,EAAE,aAAa,QAAQ,YAAY,IAAI,CAAC;GACpE,CAAC;GAED,OAAO;IACL,OAAO;IACP,OAAO,KAAK;GACd;EACF,SAAS,OAAO;GACd,OAAO,OAAO,4BAA4B;IACxC;IACA,QAAQ;GACV,CAAC;GACD,MAAM;EACR;CACF;CAEA,qBAEE;EACA,OAAO,2BAA2B,KAAK,KAAK;CAC9C;CAEA,MAAM,eAAe,OAA2C;EAC9D,MAAM,iBAAkB,MAAM,IAAI,MAAM,OAAO,KAAK,OAAO;GACzD,WAAW;GACX,MAAM;EACR,CAAC;EAED,OAAO;GACL;GACA,QAAQ,0BAA0B,eAAe,MAAM;GACvD,GAAI,eAAe,kBAAkB,OACjC,EACE,UAAU,KAAK,IAAI,GAAG,MAAM,eAAe,iBAAiB,EAAE,EAChE,IACA,CAAC;EACP;CACF;CAEA,MAAM,YAAY,OAAwC;EACxD,IAAI;EACJ,IAAI;GACF,SAAS,MAAM,IAAI,MAAM,OAAO,KAAK,OAAO,EAC1C,WAAW,MACb,CAAC;EACH,SAAS,OAAgB;GAGvB,MAAM,MAAM;GACZ,MAAM,SAAS,IAAI,MAAM;GACzB,IAAI,MAAM,QAAQ,MAAM,GAAG;IACzB,MAAM,WAAW,OAAO,KACrB,MACC,EAAE,MAAM,GAAG,EAAE,IAAI,KAAK,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,GAC/C;IACA,MAAM,IAAI,MAAM,4BAA4B,SAAS,KAAK,IAAI,GAAG;GACnE;GACA,MAAM,IAAI,MACR,oCAAoC,IAAI,WAAW,OAAO,KAAK,GACjE;EACF;EAEA,MAAM,OAAO,OAAO;EAGpB,MAAM,MAAM,KAAK,OAAO,OAAO,KAAK;EACpC,IAAI,CAAC,KACH,MAAM,IAAI,MAAM,iCAAiC;EAGnD,MAAM,QAAQ,cAAc,kBAAkB,OAAO,SAAS,CAAC;EAE/D,OAAO;GACL;GACA;GACA,GAAI,QAAQ,EAAE,MAAM,IAAI,CAAC;EAC3B;CACF;CAEA,aAAwC;EACtC,OAAO,WAAe,KAAK,IAAI;CACjC;AACF;;;;;;AAOA,SAAgB,eACd,OACA,QACyB;CACzB,OAAO,IAAI,gBAAgB,OAAO,MAAM;AAC1C;;;;;;AAOA,SAAgB,SACd,OACA,QACyB;CACzB,OAAO,eAAe,OAAO,MAAM;AACrC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-fal",
-  "version": "0.15.3",
+  "version": "0.15.4",
   "description": "fal.ai adapter for TanStack AI image, video, live, audio, speech, and transcription generation.",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -59,10 +59,10 @@
   "devDependencies": {
     "@vitest/coverage-v8": "4.1.10",
     "vite": "^8.2.1",
-    "@tanstack/ai": "0.63.0"
+    "@tanstack/ai": "0.64.0"
   },
   "peerDependencies": {
-    "@tanstack/ai": "^0.63.0"
+    "@tanstack/ai": "^0.64.0"
   },
   "scripts": {
     "build": "vite build",

package/src/adapters/video.ts

@@ -1,6 +1,6 @@
 import { fal } from '@fal-ai/client'
 import { resolveMediaPrompt } from '@tanstack/ai'
-import { BaseVideoAdapter, snapToDurationOption } from '@tanstack/ai/adapters'
+import { BaseVideoAdapter } from '@tanstack/ai/adapters'
 import {
   configureFalClient,
   generateId as utilGenerateId,
@@ -212,12 +212,6 @@ export class FalVideoAdapter<TModel extends FalModel> extends BaseVideoAdapter<
     return getFalVideoDurationOptions(this.model)
   }
 
-  override snapDuration(
-    seconds: number,
-  ): FalModelVideoDuration<TModel> | undefined {
-    return snapToDurationOption(seconds, this.availableDurations())
-  }
-
   async getVideoStatus(jobId: string): Promise<VideoStatusResult> {
     const statusResponse = (await fal.queue.status(this.model, {
       requestId: jobId,