@tanstack/ai-fal 0.7.3 → 0.7.4

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

@@ -1 +1 @@
-{"version":3,"file":"image.js","sources":["../../../src/adapters/image.ts"],"sourcesContent":["import { fal } from '@fal-ai/client'\nimport { BaseImageAdapter } from '@tanstack/ai/adapters'\nimport { configureFalClient, generateId as utilGenerateId } from '../utils'\nimport { mapSizeToFalFormat } from '../image/image-provider-options'\nimport type { OutputType, Result } from '@fal-ai/client'\nimport type { FalClientConfig } from '../utils'\nimport type {\n  GeneratedImage,\n  ImageGenerationOptions,\n  ImageGenerationResult,\n} from '@tanstack/ai'\nimport type {\n  FalImageProviderOptions,\n  FalModel,\n  FalModelImageSize,\n  FalModelInput,\n} from '../model-meta'\n\n/**\n * fal.ai image generation adapter with full type inference.\n *\n * Uses fal.ai's comprehensive type system to provide autocomplete\n *\n * and type safety for all 600+ supported models.\n *\n * @example\n * ```typescript\n * const adapter = falImage('fal-ai/flux/dev')\n * const result = await adapter.generateImages({\n *   model: 'fal-ai/flux/dev',\n *   prompt: 'a cat',\n *   modelOptions: {\n *     num_inference_steps: 28, // Type-safe! Autocomplete works\n *     guidance_scale: 3.5,\n *   },\n * })\n * ```\n */\nexport class FalImageAdapter<TModel extends FalModel> extends BaseImageAdapter<\n  TModel,\n  FalImageProviderOptions<TModel>,\n  Record<TModel, FalImageProviderOptions<TModel>>,\n  Record<TModel, FalModelImageSize<TModel>>\n> {\n  readonly kind = 'image' 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 generateImages(\n    options: ImageGenerationOptions<\n      FalImageProviderOptions<TModel>,\n      FalModelImageSize<TModel>\n    >,\n  ): Promise<ImageGenerationResult> {\n    const { logger } = options\n\n    logger.request(`activity=generateImage provider=fal model=${this.model}`, {\n      provider: 'fal',\n      model: this.model,\n    })\n\n    try {\n      const input = this.buildInput(options)\n      const result = await fal.subscribe(this.model, { input })\n      return this.transformResponse(result)\n    } catch (error) {\n      logger.errors('fal.generateImage fatal', {\n        error,\n        source: 'fal.generateImage',\n      })\n      throw error\n    }\n  }\n\n  private buildInput(\n    options: ImageGenerationOptions<FalImageProviderOptions<TModel>, string>,\n  ): FalModelInput<TModel> {\n    const sizeParams = mapSizeToFalFormat(options.size)\n    const input = {\n      ...options.modelOptions,\n      ...sizeParams,\n      prompt: options.prompt,\n      num_images: options.numberOfImages,\n    } as FalModelInput<TModel>\n    return input\n  }\n\n  protected override generateId(): string {\n    return utilGenerateId(this.name)\n  }\n\n  private transformResponse(\n    response: Result<OutputType<TModel>>,\n  ): ImageGenerationResult {\n    const images: Array<GeneratedImage> = []\n    const data = response.data\n\n    // Handle array of images (most models return { images: [...] })\n    if ('images' in data && Array.isArray(data.images)) {\n      for (const img of data.images) {\n        images.push(this.parseImage(img))\n      }\n    }\n    // Handle single image response (some models return { image: {...} })\n    else if ('image' in data && data.image && typeof data.image === 'object') {\n      images.push(this.parseImage(data.image))\n    }\n\n    if (images.length === 0) {\n      throw new Error(\n        'Unexpected fal image response shape. Expected images[] or image{}. Got keys: ' +\n          Object.keys(data).join(','),\n      )\n    }\n\n    return {\n      id: response.requestId || this.generateId(),\n      model: this.model,\n      images,\n    }\n  }\n\n  private parseImage(img: unknown): GeneratedImage {\n    let url: string\n    if (typeof img === 'string') {\n      url = img\n    } else if (\n      img &&\n      typeof img === 'object' &&\n      'url' in img &&\n      typeof (img as { url: unknown }).url === 'string'\n    ) {\n      url = (img as { url: string }).url\n    } else {\n      throw new Error(\n        `Invalid image payload from fal response: expected string or { url: string }, received ${\n          img === null ? 'null' : typeof img\n        }`,\n      )\n    }\n\n    if (url.startsWith('data:')) {\n      const base64Match = url.match(/^data:image\\/[^;]+;base64,(.+)$/)\n      if (base64Match && base64Match[1]) {\n        return { b64Json: base64Match[1] }\n      }\n    }\n    return { url }\n  }\n}\n\nexport function createFalImage<TModel extends FalModel>(\n  model: TModel,\n  config?: FalClientConfig,\n): FalImageAdapter<TModel> {\n  return new FalImageAdapter(model, config)\n}\n\nexport function falImage<TModel extends FalModel>(\n  model: TModel,\n  config?: FalClientConfig,\n): FalImageAdapter<TModel> {\n  return createFalImage(model, config)\n}\n"],"names":["utilGenerateId"],"mappings":";;;;AAsCO,MAAM,wBAAiD,iBAK5D;AAAA,EAIA,YAAY,OAAe,QAA0B;AACnD,UAAM,OAAO,EAAE;AAJjB,SAAS,OAAO;AAChB,SAAS,OAAO;AAId,uBAAmB,MAAM;AAAA,EAC3B;AAAA,EAEA,MAAM,eACJ,SAIgC;AAChC,UAAM,EAAE,WAAW;AAEnB,WAAO,QAAQ,6CAA6C,KAAK,KAAK,IAAI;AAAA,MACxE,UAAU;AAAA,MACV,OAAO,KAAK;AAAA,IAAA,CACb;AAED,QAAI;AACF,YAAM,QAAQ,KAAK,WAAW,OAAO;AACrC,YAAM,SAAS,MAAM,IAAI,UAAU,KAAK,OAAO,EAAE,OAAO;AACxD,aAAO,KAAK,kBAAkB,MAAM;AAAA,IACtC,SAAS,OAAO;AACd,aAAO,OAAO,2BAA2B;AAAA,QACvC;AAAA,QACA,QAAQ;AAAA,MAAA,CACT;AACD,YAAM;AAAA,IACR;AAAA,EACF;AAAA,EAEQ,WACN,SACuB;AACvB,UAAM,aAAa,mBAAmB,QAAQ,IAAI;AAClD,UAAM,QAAQ;AAAA,MACZ,GAAG,QAAQ;AAAA,MACX,GAAG;AAAA,MACH,QAAQ,QAAQ;AAAA,MAChB,YAAY,QAAQ;AAAA,IAAA;AAEtB,WAAO;AAAA,EACT;AAAA,EAEmB,aAAqB;AACtC,WAAOA,WAAe,KAAK,IAAI;AAAA,EACjC;AAAA,EAEQ,kBACN,UACuB;AACvB,UAAM,SAAgC,CAAA;AACtC,UAAM,OAAO,SAAS;AAGtB,QAAI,YAAY,QAAQ,MAAM,QAAQ,KAAK,MAAM,GAAG;AAClD,iBAAW,OAAO,KAAK,QAAQ;AAC7B,eAAO,KAAK,KAAK,WAAW,GAAG,CAAC;AAAA,MAClC;AAAA,IACF,WAES,WAAW,QAAQ,KAAK,SAAS,OAAO,KAAK,UAAU,UAAU;AACxE,aAAO,KAAK,KAAK,WAAW,KAAK,KAAK,CAAC;AAAA,IACzC;AAEA,QAAI,OAAO,WAAW,GAAG;AACvB,YAAM,IAAI;AAAA,QACR,kFACE,OAAO,KAAK,IAAI,EAAE,KAAK,GAAG;AAAA,MAAA;AAAA,IAEhC;AAEA,WAAO;AAAA,MACL,IAAI,SAAS,aAAa,KAAK,WAAA;AAAA,MAC/B,OAAO,KAAK;AAAA,MACZ;AAAA,IAAA;AAAA,EAEJ;AAAA,EAEQ,WAAW,KAA8B;AAC/C,QAAI;AACJ,QAAI,OAAO,QAAQ,UAAU;AAC3B,YAAM;AAAA,IACR,WACE,OACA,OAAO,QAAQ,YACf,SAAS,OACT,OAAQ,IAAyB,QAAQ,UACzC;AACA,YAAO,IAAwB;AAAA,IACjC,OAAO;AACL,YAAM,IAAI;AAAA,QACR,yFACE,QAAQ,OAAO,SAAS,OAAO,GACjC;AAAA,MAAA;AAAA,IAEJ;AAEA,QAAI,IAAI,WAAW,OAAO,GAAG;AAC3B,YAAM,cAAc,IAAI,MAAM,iCAAiC;AAC/D,UAAI,eAAe,YAAY,CAAC,GAAG;AACjC,eAAO,EAAE,SAAS,YAAY,CAAC,EAAA;AAAA,MACjC;AAAA,IACF;AACA,WAAO,EAAE,IAAA;AAAA,EACX;AACF;AAEO,SAAS,eACd,OACA,QACyB;AACzB,SAAO,IAAI,gBAAgB,OAAO,MAAM;AAC1C;AAEO,SAAS,SACd,OACA,QACyB;AACzB,SAAO,eAAe,OAAO,MAAM;AACrC;"}
+{"version":3,"file":"image.js","sources":["../../../src/adapters/image.ts"],"sourcesContent":["import { fal } from '@fal-ai/client'\nimport { BaseImageAdapter } from '@tanstack/ai/adapters'\nimport { configureFalClient, generateId as utilGenerateId } from '../utils'\nimport { mapSizeToFalFormat } from '../image/image-provider-options'\nimport type { OutputType, Result } from '@fal-ai/client'\nimport type { FalClientConfig } from '../utils'\nimport type {\n  GeneratedImage,\n  ImageGenerationOptions,\n  ImageGenerationResult,\n} from '@tanstack/ai'\nimport type {\n  FalImageProviderOptions,\n  FalModel,\n  FalModelImageSize,\n  FalModelInput,\n} from '../model-meta'\n\n/**\n * fal.ai image generation adapter with full type inference.\n *\n * Uses fal.ai's comprehensive type system to provide autocomplete\n *\n * and type safety for all 600+ supported models.\n *\n * @example\n * ```typescript\n * const adapter = falImage('fal-ai/flux/dev')\n * const result = await adapter.generateImages({\n *   model: 'fal-ai/flux/dev',\n *   prompt: 'a cat',\n *   modelOptions: {\n *     num_inference_steps: 28, // Type-safe! Autocomplete works\n *     guidance_scale: 3.5,\n *   },\n * })\n * ```\n */\nexport class FalImageAdapter<TModel extends FalModel> extends BaseImageAdapter<\n  TModel,\n  FalImageProviderOptions<TModel>,\n  Record<TModel, FalImageProviderOptions<TModel>>,\n  Record<TModel, FalModelImageSize<TModel>>\n> {\n  readonly kind = 'image' 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 generateImages(\n    options: ImageGenerationOptions<\n      FalImageProviderOptions<TModel>,\n      FalModelImageSize<TModel>\n    >,\n  ): Promise<ImageGenerationResult> {\n    const { logger } = options\n\n    logger.request(`activity=generateImage provider=fal model=${this.model}`, {\n      provider: 'fal',\n      model: this.model,\n    })\n\n    try {\n      const input = this.buildInput(options)\n      const result = await fal.subscribe(this.model, { input })\n      return this.transformResponse(result)\n    } catch (error) {\n      logger.errors('fal.generateImage fatal', {\n        error,\n        source: 'fal.generateImage',\n      })\n      throw error\n    }\n  }\n\n  private buildInput(\n    options: ImageGenerationOptions<\n      FalImageProviderOptions<TModel>,\n      FalModelImageSize<TModel>\n    >,\n  ): FalModelInput<TModel> {\n    const sizeParams = mapSizeToFalFormat(options.size)\n    const input = {\n      ...options.modelOptions,\n      ...sizeParams,\n      prompt: options.prompt,\n      num_images: options.numberOfImages,\n    } as FalModelInput<TModel>\n    return input\n  }\n\n  protected override generateId(): string {\n    return utilGenerateId(this.name)\n  }\n\n  private transformResponse(\n    response: Result<OutputType<TModel>>,\n  ): ImageGenerationResult {\n    const images: Array<GeneratedImage> = []\n    const data = response.data\n\n    // Handle array of images (most models return { images: [...] })\n    if ('images' in data && Array.isArray(data.images)) {\n      for (const img of data.images) {\n        images.push(this.parseImage(img))\n      }\n    }\n    // Handle single image response (some models return { image: {...} })\n    else if ('image' in data && data.image && typeof data.image === 'object') {\n      images.push(this.parseImage(data.image))\n    }\n\n    if (images.length === 0) {\n      throw new Error(\n        'Unexpected fal image response shape. Expected images[] or image{}. Got keys: ' +\n          Object.keys(data).join(','),\n      )\n    }\n\n    return {\n      id: response.requestId || this.generateId(),\n      model: this.model,\n      images,\n    }\n  }\n\n  private parseImage(img: unknown): GeneratedImage {\n    let url: string\n    if (typeof img === 'string') {\n      url = img\n    } else if (\n      img &&\n      typeof img === 'object' &&\n      'url' in img &&\n      typeof (img as { url: unknown }).url === 'string'\n    ) {\n      url = (img as { url: string }).url\n    } else {\n      throw new Error(\n        `Invalid image payload from fal response: expected string or { url: string }, received ${\n          img === null ? 'null' : typeof img\n        }`,\n      )\n    }\n\n    if (url.startsWith('data:')) {\n      const base64Match = url.match(/^data:image\\/[^;]+;base64,(.+)$/)\n      if (base64Match && base64Match[1]) {\n        return { b64Json: base64Match[1] }\n      }\n    }\n    return { url }\n  }\n}\n\nexport function createFalImage<TModel extends FalModel>(\n  model: TModel,\n  config?: FalClientConfig,\n): FalImageAdapter<TModel> {\n  return new FalImageAdapter(model, config)\n}\n\nexport function falImage<TModel extends FalModel>(\n  model: TModel,\n  config?: FalClientConfig,\n): FalImageAdapter<TModel> {\n  return createFalImage(model, config)\n}\n"],"names":["utilGenerateId"],"mappings":";;;;AAsCO,MAAM,wBAAiD,iBAK5D;AAAA,EAIA,YAAY,OAAe,QAA0B;AACnD,UAAM,OAAO,EAAE;AAJjB,SAAS,OAAO;AAChB,SAAS,OAAO;AAId,uBAAmB,MAAM;AAAA,EAC3B;AAAA,EAEA,MAAM,eACJ,SAIgC;AAChC,UAAM,EAAE,WAAW;AAEnB,WAAO,QAAQ,6CAA6C,KAAK,KAAK,IAAI;AAAA,MACxE,UAAU;AAAA,MACV,OAAO,KAAK;AAAA,IAAA,CACb;AAED,QAAI;AACF,YAAM,QAAQ,KAAK,WAAW,OAAO;AACrC,YAAM,SAAS,MAAM,IAAI,UAAU,KAAK,OAAO,EAAE,OAAO;AACxD,aAAO,KAAK,kBAAkB,MAAM;AAAA,IACtC,SAAS,OAAO;AACd,aAAO,OAAO,2BAA2B;AAAA,QACvC;AAAA,QACA,QAAQ;AAAA,MAAA,CACT;AACD,YAAM;AAAA,IACR;AAAA,EACF;AAAA,EAEQ,WACN,SAIuB;AACvB,UAAM,aAAa,mBAAmB,QAAQ,IAAI;AAClD,UAAM,QAAQ;AAAA,MACZ,GAAG,QAAQ;AAAA,MACX,GAAG;AAAA,MACH,QAAQ,QAAQ;AAAA,MAChB,YAAY,QAAQ;AAAA,IAAA;AAEtB,WAAO;AAAA,EACT;AAAA,EAEmB,aAAqB;AACtC,WAAOA,WAAe,KAAK,IAAI;AAAA,EACjC;AAAA,EAEQ,kBACN,UACuB;AACvB,UAAM,SAAgC,CAAA;AACtC,UAAM,OAAO,SAAS;AAGtB,QAAI,YAAY,QAAQ,MAAM,QAAQ,KAAK,MAAM,GAAG;AAClD,iBAAW,OAAO,KAAK,QAAQ;AAC7B,eAAO,KAAK,KAAK,WAAW,GAAG,CAAC;AAAA,MAClC;AAAA,IACF,WAES,WAAW,QAAQ,KAAK,SAAS,OAAO,KAAK,UAAU,UAAU;AACxE,aAAO,KAAK,KAAK,WAAW,KAAK,KAAK,CAAC;AAAA,IACzC;AAEA,QAAI,OAAO,WAAW,GAAG;AACvB,YAAM,IAAI;AAAA,QACR,kFACE,OAAO,KAAK,IAAI,EAAE,KAAK,GAAG;AAAA,MAAA;AAAA,IAEhC;AAEA,WAAO;AAAA,MACL,IAAI,SAAS,aAAa,KAAK,WAAA;AAAA,MAC/B,OAAO,KAAK;AAAA,MACZ;AAAA,IAAA;AAAA,EAEJ;AAAA,EAEQ,WAAW,KAA8B;AAC/C,QAAI;AACJ,QAAI,OAAO,QAAQ,UAAU;AAC3B,YAAM;AAAA,IACR,WACE,OACA,OAAO,QAAQ,YACf,SAAS,OACT,OAAQ,IAAyB,QAAQ,UACzC;AACA,YAAO,IAAwB;AAAA,IACjC,OAAO;AACL,YAAM,IAAI;AAAA,QACR,yFACE,QAAQ,OAAO,SAAS,OAAO,GACjC;AAAA,MAAA;AAAA,IAEJ;AAEA,QAAI,IAAI,WAAW,OAAO,GAAG;AAC3B,YAAM,cAAc,IAAI,MAAM,iCAAiC;AAC/D,UAAI,eAAe,YAAY,CAAC,GAAG;AACjC,eAAO,EAAE,SAAS,YAAY,CAAC,EAAA;AAAA,MACjC;AAAA,IACF;AACA,WAAO,EAAE,IAAA;AAAA,EACX;AACF;AAEO,SAAS,eACd,OACA,QACyB;AACzB,SAAO,IAAI,gBAAgB,OAAO,MAAM;AAC1C;AAEO,SAAS,SACd,OACA,QACyB;AACzB,SAAO,eAAe,OAAO,MAAM;AACrC;"}

package/dist/esm/image/image-provider-options.js

@@ -1,12 +1,16 @@
 function mapSizeToFalFormat(size) {
   if (!size) return void 0;
   if (typeof size === "string") {
-    const match = size.match(/^(\d+:\d+)(?:_(.+))?$/);
-    if (match) {
-      return {
-        aspect_ratio: match[1],
-        ...match[2] ? { resolution: match[2] } : {}
-      };
+    if (size.includes("_")) {
+      const [first, second] = size.split("_");
+      if (first && first.includes(":")) {
+        return {
+          aspect_ratio: first,
+          resolution: second
+        };
+      }
+    } else if (size.includes(":")) {
+      return { aspect_ratio: size };
     }
   }
   return {

package/dist/esm/image/image-provider-options.js.map

@@ -1 +1 @@
-{"version":3,"file":"image-provider-options.js","sources":["../../../src/image/image-provider-options.ts"],"sourcesContent":["import type { FalModelImageSize, FalModelImageSizeInput } from '../model-meta'\n\nexport function mapSizeToFalFormat<TModel extends string>(\n  size: FalModelImageSize<TModel> | undefined,\n): FalModelImageSizeInput<TModel> | undefined {\n  if (!size) return undefined\n\n  // \"16:9_4K\" → { aspect_ratio, resolution }\n  // \"16:9\"    → { aspect_ratio }\n  // no match  → { image_size }\n  if (typeof size === 'string') {\n    const match = size.match(/^(\\d+:\\d+)(?:_(.+))?$/)\n    if (match) {\n      return {\n        aspect_ratio: match[1],\n        ...(match[2] ? { resolution: match[2] } : {}),\n      } as FalModelImageSizeInput<TModel>\n    }\n  }\n\n  return {\n    image_size: size,\n  } as FalModelImageSizeInput<TModel>\n}\n"],"names":[],"mappings":"AAEO,SAAS,mBACd,MAC4C;AAC5C,MAAI,CAAC,KAAM,QAAO;AAKlB,MAAI,OAAO,SAAS,UAAU;AAC5B,UAAM,QAAQ,KAAK,MAAM,uBAAuB;AAChD,QAAI,OAAO;AACT,aAAO;AAAA,QACL,cAAc,MAAM,CAAC;AAAA,QACrB,GAAI,MAAM,CAAC,IAAI,EAAE,YAAY,MAAM,CAAC,MAAM,CAAA;AAAA,MAAC;AAAA,IAE/C;AAAA,EACF;AAEA,SAAO;AAAA,IACL,YAAY;AAAA,EAAA;AAEhB;"}
+{"version":3,"file":"image-provider-options.js","sources":["../../../src/image/image-provider-options.ts"],"sourcesContent":["import type { FalModelImageSize, FalModelImageSizeInput } from '../model-meta'\n\nexport function mapSizeToFalFormat<TModel extends string>(\n  size: FalModelImageSize<TModel> | undefined,\n): FalModelImageSizeInput<TModel> | undefined {\n  if (!size) return undefined\n\n  // \"16:9_4K\"     → { aspect_ratio, resolution }\n  // \"16:9\"        → { aspect_ratio }\n  // \"4K\"          → { resolution }    (no colon, no underscore, model has `resolution`)\n  // \"square_hd\"   → { image_size }    (no colon, no resolution field on model)\n  if (typeof size === 'string') {\n    if (size.includes('_')) {\n      const [first, second] = size.split('_')\n      if (first && first.includes(':')) {\n        return {\n          aspect_ratio: first,\n          resolution: second,\n        } as FalModelImageSizeInput<TModel>\n      }\n    } else if (size.includes(':')) {\n      return { aspect_ratio: size } as FalModelImageSizeInput<TModel>\n    }\n  }\n\n  return {\n    image_size: size,\n  } as FalModelImageSizeInput<TModel>\n}\n"],"names":[],"mappings":"AAEO,SAAS,mBACd,MAC4C;AAC5C,MAAI,CAAC,KAAM,QAAO;AAMlB,MAAI,OAAO,SAAS,UAAU;AAC5B,QAAI,KAAK,SAAS,GAAG,GAAG;AACtB,YAAM,CAAC,OAAO,MAAM,IAAI,KAAK,MAAM,GAAG;AACtC,UAAI,SAAS,MAAM,SAAS,GAAG,GAAG;AAChC,eAAO;AAAA,UACL,cAAc;AAAA,UACd,YAAY;AAAA,QAAA;AAAA,MAEhB;AAAA,IACF,WAAW,KAAK,SAAS,GAAG,GAAG;AAC7B,aAAO,EAAE,cAAc,KAAA;AAAA,IACzB;AAAA,EACF;AAEA,SAAO;AAAA,IACL,YAAY;AAAA,EAAA;AAEhB;"}

package/dist/esm/model-meta.d.ts

@@ -29,15 +29,15 @@ export type FalModelOutput<TModel extends string> = TModel extends keyof Endpoin
  * type FluxSize = FalModelImageSize<'fal-ai/flux/dev'>
  * // "square_hd" | "square" | "portrait_4_3" | "portrait_16_9" | ...
  */
-export type FalModelImageSize<TModel extends string> = TModel extends keyof EndpointTypeMap ? 'image_size' extends keyof EndpointTypeMap[TModel]['input'] ? NonNullable<Exclude<FalModelInput<TModel>['image_size'], object>> : 'aspect_ratio' extends keyof EndpointTypeMap[TModel]['input'] ? 'resolution' extends keyof EndpointTypeMap[TModel]['input'] ? `${NonNullable<FalModelInput<TModel>['aspect_ratio']>}_${NonNullable<FalModelInput<TModel>['resolution']>}` : NonNullable<FalModelInput<TModel>['aspect_ratio']> : never : string;
+export type FalModelImageSize<TModel extends string> = TModel extends keyof EndpointTypeMap ? 'image_size' extends keyof EndpointTypeMap[TModel]['input'] ? NonNullable<Exclude<FalModelInput<TModel>['image_size'], object>> : 'aspect_ratio' extends keyof EndpointTypeMap[TModel]['input'] ? 'resolution' extends keyof EndpointTypeMap[TModel]['input'] ? `${Extract<NonNullable<FalModelInput<TModel>['aspect_ratio']>, string>}_${Extract<NonNullable<FalModelInput<TModel>['resolution']>, string>}` : Extract<NonNullable<FalModelInput<TModel>['aspect_ratio']>, string> : undefined : string;
 export type FalModelImageSizeInput<TModel extends string> = TModel extends keyof EndpointTypeMap ? 'aspect_ratio' extends keyof EndpointTypeMap[TModel]['input'] ? 'resolution' extends keyof EndpointTypeMap[TModel]['input'] ? {
     aspect_ratio: FalModelInput<TModel>['aspect_ratio'];
     resolution: FalModelInput<TModel>['resolution'];
 } : {
     aspect_ratio: NonNullable<FalModelInput<TModel>['aspect_ratio']>;
-} : {
+} : 'image_size' extends keyof EndpointTypeMap[TModel]['input'] ? {
     image_size: FalModelImageSize<TModel>;
-} : {
+} : never : {
     image_size: string;
 };
 /**
@@ -53,21 +53,23 @@ export type FalImageProviderOptions<TModel extends string> = Omit<FalModelInput<
  * Extract the video size type supported by a specific fal model.
  * Video models typically use aspect_ratio and/or resolution fields.
  *
- * Follows the same pattern as FalModelImageSize:
  * - aspect_ratio + resolution → "16:9_720p"
  * - aspect_ratio only → "16:9"
+ * - resolution only → "720p"
+ * - neither → undefined (the model takes no size param)
  * - unknown models → string
  */
-export type FalModelVideoSize<TModel extends string> = TModel extends keyof EndpointTypeMap ? 'aspect_ratio' extends keyof EndpointTypeMap[TModel]['input'] ? 'resolution' extends keyof EndpointTypeMap[TModel]['input'] ? `${NonNullable<FalModelInput<TModel>['aspect_ratio']>}_${NonNullable<FalModelInput<TModel>['resolution']>}` : NonNullable<FalModelInput<TModel>['aspect_ratio']> : never : string;
+export type FalModelVideoSize<TModel extends string> = TModel extends keyof EndpointTypeMap ? 'aspect_ratio' extends keyof EndpointTypeMap[TModel]['input'] ? 'resolution' extends keyof EndpointTypeMap[TModel]['input'] ? `${Extract<NonNullable<FalModelInput<TModel>['aspect_ratio']>, string>}_${Extract<NonNullable<FalModelInput<TModel>['resolution']>, string>}` : Extract<NonNullable<FalModelInput<TModel>['aspect_ratio']>, string> : 'resolution' extends keyof EndpointTypeMap[TModel]['input'] ? Extract<NonNullable<FalModelInput<TModel>['resolution']>, string> : undefined : string;
 export type FalModelVideoSizeInput<TModel extends string> = TModel extends keyof EndpointTypeMap ? 'aspect_ratio' extends keyof EndpointTypeMap[TModel]['input'] ? 'resolution' extends keyof EndpointTypeMap[TModel]['input'] ? {
     aspect_ratio: FalModelInput<TModel>['aspect_ratio'];
     resolution: FalModelInput<TModel>['resolution'];
 } : {
     aspect_ratio: NonNullable<FalModelInput<TModel>['aspect_ratio']>;
-} : {
-    aspect_ratio: string;
-} : {
-    aspect_ratio: string;
+} : 'resolution' extends keyof EndpointTypeMap[TModel]['input'] ? {
+    resolution: NonNullable<FalModelInput<TModel>['resolution']>;
+} : never : {
+    aspect_ratio?: string;
+    resolution?: string;
 };
 /**
  * Provider options for video generation, excluding fields TanStack AI handles.

package/dist/esm/video/video-provider-options.js

@@ -1,12 +1,16 @@
 function mapVideoSizeToFalFormat(size) {
   if (!size) return void 0;
-  const match = size.match(/^(\d+:\d+)(?:_(.+))?$/);
-  return {
-    aspect_ratio: match?.[1],
-    ...match?.[2] && {
-      resolution: match[2]
-    }
-  };
+  if (size.includes("_")) {
+    const [aspect_ratio, resolution] = size.split("_");
+    return {
+      aspect_ratio,
+      resolution
+    };
+  }
+  if (size.includes(":")) {
+    return { aspect_ratio: size };
+  }
+  return { resolution: size };
 }
 export {
   mapVideoSizeToFalFormat

package/dist/esm/video/video-provider-options.js.map

@@ -1 +1 @@
-{"version":3,"file":"video-provider-options.js","sources":["../../../src/video/video-provider-options.ts"],"sourcesContent":["import type {\n  FalModelInput,\n  FalModelVideoSize,\n  FalModelVideoSizeInput,\n} from '../model-meta'\n\nexport function mapVideoSizeToFalFormat<TModel extends string>(\n  size: FalModelVideoSize<TModel> | undefined,\n): FalModelVideoSizeInput<TModel> | undefined {\n  if (!size) return undefined\n\n  // \"16:9_720p\" → { aspect_ratio, resolution }\n  // \"16:9\"      → { aspect_ratio }\n  const match = size.match(/^(\\d+:\\d+)(?:_(.+))?$/)\n\n  return {\n    aspect_ratio: match?.[1] as NonNullable<\n      FalModelInput<TModel>['aspect_ratio']\n    >,\n    ...(match?.[2] && {\n      resolution: match[2] as NonNullable<FalModelInput<TModel>['resolution']>,\n    }),\n  } as FalModelVideoSizeInput<TModel>\n}\n"],"names":[],"mappings":"AAMO,SAAS,wBACd,MAC4C;AAC5C,MAAI,CAAC,KAAM,QAAO;AAIlB,QAAM,QAAQ,KAAK,MAAM,uBAAuB;AAEhD,SAAO;AAAA,IACL,cAAc,QAAQ,CAAC;AAAA,IAGvB,GAAI,QAAQ,CAAC,KAAK;AAAA,MAChB,YAAY,MAAM,CAAC;AAAA,IAAA;AAAA,EACrB;AAEJ;"}
+{"version":3,"file":"video-provider-options.js","sources":["../../../src/video/video-provider-options.ts"],"sourcesContent":["import type { FalModelVideoSize, FalModelVideoSizeInput } from '../model-meta'\n\nexport function mapVideoSizeToFalFormat<TModel extends string>(\n  size: FalModelVideoSize<TModel> | undefined,\n): FalModelVideoSizeInput<TModel> | undefined {\n  if (!size) return undefined\n\n  // \"16:9_720p\" → { aspect_ratio, resolution }\n  // \"16:9\"      → { aspect_ratio }\n  // \"720p\"      → { resolution }\n  if (size.includes('_')) {\n    const [aspect_ratio, resolution] = size.split('_')\n    return {\n      aspect_ratio,\n      resolution,\n    } as unknown as FalModelVideoSizeInput<TModel>\n  }\n\n  if (size.includes(':')) {\n    return { aspect_ratio: size } as unknown as FalModelVideoSizeInput<TModel>\n  }\n\n  return { resolution: size } as unknown as FalModelVideoSizeInput<TModel>\n}\n"],"names":[],"mappings":"AAEO,SAAS,wBACd,MAC4C;AAC5C,MAAI,CAAC,KAAM,QAAO;AAKlB,MAAI,KAAK,SAAS,GAAG,GAAG;AACtB,UAAM,CAAC,cAAc,UAAU,IAAI,KAAK,MAAM,GAAG;AACjD,WAAO;AAAA,MACL;AAAA,MACA;AAAA,IAAA;AAAA,EAEJ;AAEA,MAAI,KAAK,SAAS,GAAG,GAAG;AACtB,WAAO,EAAE,cAAc,KAAA;AAAA,EACzB;AAEA,SAAO,EAAE,YAAY,KAAA;AACvB;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-fal",
-  "version": "0.7.3",
+  "version": "0.7.4",
   "description": "fal.ai adapter for TanStack AI",
   "author": "",
   "license": "MIT",
@@ -36,16 +36,16 @@
     "transcription"
   ],
   "dependencies": {
-    "@fal-ai/client": "^1.9.4",
+    "@fal-ai/client": "^1.10.1",
     "@tanstack/ai-utils": "0.2.0"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "4.0.14",
     "vite": "^7.2.7",
-    "@tanstack/ai": "0.16.0"
+    "@tanstack/ai": "0.17.0"
   },
   "peerDependencies": {
-    "@tanstack/ai": "0.16.0"
+    "@tanstack/ai": "0.17.0"
   },
   "scripts": {
     "build": "vite build",

package/src/adapters/image.ts

@@ -77,7 +77,10 @@ export class FalImageAdapter<TModel extends FalModel> extends BaseImageAdapter<
   }
 
   private buildInput(
-    options: ImageGenerationOptions<FalImageProviderOptions<TModel>, string>,
+    options: ImageGenerationOptions<
+      FalImageProviderOptions<TModel>,
+      FalModelImageSize<TModel>
+    >,
   ): FalModelInput<TModel> {
     const sizeParams = mapSizeToFalFormat(options.size)
     const input = {

package/src/image/image-provider-options.ts

@@ -5,16 +5,21 @@ export function mapSizeToFalFormat<TModel extends string>(
 ): FalModelImageSizeInput<TModel> | undefined {
   if (!size) return undefined
 
-  // "16:9_4K" → { aspect_ratio, resolution }
-  // "16:9"    → { aspect_ratio }
-  // no match  → { image_size }
+  // "16:9_4K"     → { aspect_ratio, resolution }
+  // "16:9"        → { aspect_ratio }
+  // "4K"          → { resolution }    (no colon, no underscore, model has `resolution`)
+  // "square_hd"   → { image_size }    (no colon, no resolution field on model)
   if (typeof size === 'string') {
-    const match = size.match(/^(\d+:\d+)(?:_(.+))?$/)
-    if (match) {
-      return {
-        aspect_ratio: match[1],
-        ...(match[2] ? { resolution: match[2] } : {}),
-      } as FalModelImageSizeInput<TModel>
+    if (size.includes('_')) {
+      const [first, second] = size.split('_')
+      if (first && first.includes(':')) {
+        return {
+          aspect_ratio: first,
+          resolution: second,
+        } as FalModelImageSizeInput<TModel>
+      }
+    } else if (size.includes(':')) {
+      return { aspect_ratio: size } as FalModelImageSizeInput<TModel>
     }
   }
 

package/src/model-meta.ts

@@ -51,9 +51,9 @@ export type FalModelImageSize<TModel extends string> =
       ? NonNullable<Exclude<FalModelInput<TModel>['image_size'], object>>
       : 'aspect_ratio' extends keyof EndpointTypeMap[TModel]['input']
         ? 'resolution' extends keyof EndpointTypeMap[TModel]['input']
-          ? `${NonNullable<FalModelInput<TModel>['aspect_ratio']>}_${NonNullable<FalModelInput<TModel>['resolution']>}`
-          : NonNullable<FalModelInput<TModel>['aspect_ratio']>
-        : never
+          ? `${Extract<NonNullable<FalModelInput<TModel>['aspect_ratio']>, string>}_${Extract<NonNullable<FalModelInput<TModel>['resolution']>, string>}`
+          : Extract<NonNullable<FalModelInput<TModel>['aspect_ratio']>, string>
+        : undefined
     : string
 
 export type FalModelImageSizeInput<TModel extends string> =
@@ -65,7 +65,9 @@ export type FalModelImageSizeInput<TModel extends string> =
             resolution: FalModelInput<TModel>['resolution']
           }
         : { aspect_ratio: NonNullable<FalModelInput<TModel>['aspect_ratio']> }
-      : { image_size: FalModelImageSize<TModel> }
+      : 'image_size' extends keyof EndpointTypeMap[TModel]['input']
+        ? { image_size: FalModelImageSize<TModel> }
+        : never
     : { image_size: string }
 
 /**
@@ -85,18 +87,21 @@ export type FalImageProviderOptions<TModel extends string> = Omit<
  * Extract the video size type supported by a specific fal model.
  * Video models typically use aspect_ratio and/or resolution fields.
  *
- * Follows the same pattern as FalModelImageSize:
  * - aspect_ratio + resolution → "16:9_720p"
  * - aspect_ratio only → "16:9"
+ * - resolution only → "720p"
+ * - neither → undefined (the model takes no size param)
  * - unknown models → string
  */
 export type FalModelVideoSize<TModel extends string> =
   TModel extends keyof EndpointTypeMap
     ? 'aspect_ratio' extends keyof EndpointTypeMap[TModel]['input']
       ? 'resolution' extends keyof EndpointTypeMap[TModel]['input']
-        ? `${NonNullable<FalModelInput<TModel>['aspect_ratio']>}_${NonNullable<FalModelInput<TModel>['resolution']>}`
-        : NonNullable<FalModelInput<TModel>['aspect_ratio']>
-      : never
+        ? `${Extract<NonNullable<FalModelInput<TModel>['aspect_ratio']>, string>}_${Extract<NonNullable<FalModelInput<TModel>['resolution']>, string>}`
+        : Extract<NonNullable<FalModelInput<TModel>['aspect_ratio']>, string>
+      : 'resolution' extends keyof EndpointTypeMap[TModel]['input']
+        ? Extract<NonNullable<FalModelInput<TModel>['resolution']>, string>
+        : undefined
     : string
 
 export type FalModelVideoSizeInput<TModel extends string> =
@@ -108,8 +113,10 @@ export type FalModelVideoSizeInput<TModel extends string> =
             resolution: FalModelInput<TModel>['resolution']
           }
         : { aspect_ratio: NonNullable<FalModelInput<TModel>['aspect_ratio']> }
-      : { aspect_ratio: string }
-    : { aspect_ratio: string }
+      : 'resolution' extends keyof EndpointTypeMap[TModel]['input']
+        ? { resolution: NonNullable<FalModelInput<TModel>['resolution']> }
+        : never
+    : { aspect_ratio?: string; resolution?: string }
 
 /**
  * Provider options for video generation, excluding fields TanStack AI handles.

package/src/video/video-provider-options.ts

@@ -1,8 +1,4 @@
-import type {
-  FalModelInput,
-  FalModelVideoSize,
-  FalModelVideoSizeInput,
-} from '../model-meta'
+import type { FalModelVideoSize, FalModelVideoSizeInput } from '../model-meta'
 
 export function mapVideoSizeToFalFormat<TModel extends string>(
   size: FalModelVideoSize<TModel> | undefined,
@@ -11,14 +7,18 @@ export function mapVideoSizeToFalFormat<TModel extends string>(
 
   // "16:9_720p" → { aspect_ratio, resolution }
   // "16:9"      → { aspect_ratio }
-  const match = size.match(/^(\d+:\d+)(?:_(.+))?$/)
+  // "720p"      → { resolution }
+  if (size.includes('_')) {
+    const [aspect_ratio, resolution] = size.split('_')
+    return {
+      aspect_ratio,
+      resolution,
+    } as unknown as FalModelVideoSizeInput<TModel>
+  }
 
-  return {
-    aspect_ratio: match?.[1] as NonNullable<
-      FalModelInput<TModel>['aspect_ratio']
-    >,
-    ...(match?.[2] && {
-      resolution: match[2] as NonNullable<FalModelInput<TModel>['resolution']>,
-    }),
-  } as FalModelVideoSizeInput<TModel>
+  if (size.includes(':')) {
+    return { aspect_ratio: size } as unknown as FalModelVideoSizeInput<TModel>
+  }
+
+  return { resolution: size } as unknown as FalModelVideoSizeInput<TModel>
 }