@umituz/react-native-ai-fal-provider 1.0.87 → 1.0.88

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-ai-fal-provider",
-  "version": "1.0.87",
+  "version": "1.0.88",
   "description": "FAL AI provider for React Native - implements IAIProvider interface for unified AI generation",
   "main": "./src/index.ts",
   "types": "./src/index.ts",

package/src/domain/constants/feature-models.constants.ts

@@ -1,22 +1,15 @@
 /**
  * FAL Feature Models Catalog
- * Provider-specific model IDs for image and video processing features
+ * Default model IDs for image processing features
+ * Video models are provided by the app via config
  */
 
-import type {
-  ImageFeatureType,
-  VideoFeatureType,
-} from "@umituz/react-native-ai-generation-content";
-
-export interface FeatureModelConfig {
-  readonly id: string;
-  readonly feature: ImageFeatureType | VideoFeatureType;
-}
+import type { ImageFeatureType } from "@umituz/react-native-ai-generation-content";
 
 /**
  * FAL model IDs for IMAGE processing features
  */
-export const FAL_IMAGE_FEATURE_MODELS = {
+export const FAL_IMAGE_FEATURE_MODELS: Record<ImageFeatureType, string> = {
   "upscale": "fal-ai/clarity-upscaler",
   "photo-restore": "fal-ai/aura-sr",
   "face-swap": "fal-ai/face-swap",
@@ -25,35 +18,4 @@ export const FAL_IMAGE_FEATURE_MODELS = {
   "remove-object": "fal-ai/fooocus/inpaint",
   "hd-touch-up": "fal-ai/clarity-upscaler",
   "replace-background": "fal-ai/bria/background/replace",
-} as const satisfies Record<ImageFeatureType, string>;
-
-/**
- * FAL model IDs for VIDEO processing features
- * Vidu Q1 Reference-to-Video supports up to 7 reference images
- * Perfect for multi-person scenarios like kiss/hug with two different people
- */
-export const FAL_VIDEO_FEATURE_MODELS = {
-  "ai-hug": "fal-ai/vidu/q1/reference-to-video",
-  "ai-kiss": "fal-ai/vidu/q1/reference-to-video",
-} as const satisfies Record<VideoFeatureType, string>;
-
-/**
- * Get all feature model configs
- */
-export function getAllFeatureModels(): readonly FeatureModelConfig[] {
-  const imageModels = Object.entries(FAL_IMAGE_FEATURE_MODELS).map(
-    ([feature, id]) => ({
-      id,
-      feature: feature as ImageFeatureType,
-    } satisfies FeatureModelConfig)
-  );
-
-  const videoModels = Object.entries(FAL_VIDEO_FEATURE_MODELS).map(
-    ([feature, id]) => ({
-      id,
-      feature: feature as VideoFeatureType,
-    } satisfies FeatureModelConfig)
-  );
-
-  return [...imageModels, ...videoModels];
-}
+} as const;

package/src/domain/types/input-builders.types.ts

@@ -33,15 +33,13 @@ export interface ReplaceBackgroundOptions {
 }
 
 export interface VideoFromImageOptions {
-  readonly target_image?: string;
   readonly prompt?: string;
   /** @deprecated Use prompt instead */
   readonly motion_prompt?: string;
-  readonly duration?: number;
-  /** Vidu Q1: Video aspect ratio - "16:9", "9:16", or "1:1" */
-  readonly aspect_ratio?: "16:9" | "9:16" | "1:1";
-  /** Vidu Q1: Movement intensity - "auto", "small", "medium", or "large" */
-  readonly movement_amplitude?: "auto" | "small" | "medium" | "large";
+  /** Video duration in seconds (5 or 10 for Wan 2.5) */
+  readonly duration?: 5 | 10;
+  /** Video resolution (480p, 720p, or 1080p) */
+  readonly resolution?: "480p" | "720p" | "1080p";
 }
 
 export interface FaceSwapOptions {

package/src/index.ts

@@ -41,19 +41,12 @@ export {
 } from "./domain/constants/default-models.constants";
 export type { FalModelConfig } from "./domain/constants/default-models.constants";
 
-export {
-  FAL_IMAGE_FEATURE_MODELS,
-  FAL_VIDEO_FEATURE_MODELS,
-  getAllFeatureModels,
-} from "./domain/constants/feature-models.constants";
-export type { FeatureModelConfig } from "./domain/constants/feature-models.constants";
+export { FAL_IMAGE_FEATURE_MODELS } from "./domain/constants/feature-models.constants";
 
 export {
   FalProvider,
   falProvider,
   falModelsService,
-  getImageFeatureModel,
-  getVideoFeatureModel,
   NSFWContentError,
   cancelCurrentFalRequest,
   hasRunningFalRequest,

package/src/infrastructure/builders/video-feature-builder.ts

@@ -1,6 +1,6 @@
 /**
  * Video Feature Input Builder
- * Builds inputs for video-based AI features
+ * Builds inputs for video-based AI features (Wan 2.5)
  */
 
 import type {
@@ -9,23 +9,24 @@ import type {
 } from "@umituz/react-native-ai-generation-content";
 import { buildVideoFromImageInput } from "../utils/video-feature-builders.util";
 
-const DEFAULT_VIDEO_PROMPTS: Record<VideoFeatureType, string> = {
-  "ai-kiss": "A romantic couple kissing tenderly, the two reference people sharing an intimate kiss moment, smooth natural movement, cinematic lighting, high quality video",
-  "ai-hug": "A heartwarming embrace between two people, the reference characters hugging warmly with genuine emotion, gentle natural movement, cinematic quality, touching moment",
+const DEFAULT_VIDEO_PROMPTS: Partial<Record<VideoFeatureType, string>> = {
+  "ai-kiss": "A romantic couple kissing tenderly, smooth natural movement, cinematic lighting",
+  "ai-hug": "A heartwarming embrace between two people, gentle natural movement, cinematic quality",
+  "image-to-video": "Animate this image with natural, smooth motion while preserving all details",
+  "text-to-video": "Generate a high-quality video based on the description, smooth motion",
 } as const;
 
 export function buildVideoFeatureInput(
   feature: VideoFeatureType,
   data: VideoFeatureInputData,
 ): Record<string, unknown> {
-  const { sourceImageBase64, targetImageBase64, prompt, options } = data;
+  const { sourceImageBase64, prompt, options } = data;
 
   const effectivePrompt = prompt || DEFAULT_VIDEO_PROMPTS[feature] || "Generate video with natural motion";
 
   return buildVideoFromImageInput(sourceImageBase64, {
     prompt: effectivePrompt,
-    target_image: targetImageBase64,
-    aspect_ratio: (options?.aspect_ratio as "16:9" | "9:16" | "1:1") || "9:16",
-    movement_amplitude: (options?.movement_amplitude as "auto" | "small" | "medium" | "large") || "medium",
+    duration: (options?.duration as 5 | 10) || 5,
+    resolution: (options?.resolution as "480p" | "720p" | "1080p") || "720p",
   });
 }

package/src/infrastructure/services/fal-provider.ts

@@ -21,10 +21,6 @@ import type { FalQueueStatus } from "../../domain/entities/fal.types";
 import type { CostTrackerConfig } from "../../domain/entities/cost-tracking.types";
 import { DEFAULT_FAL_CONFIG, FAL_CAPABILITIES } from "./fal-provider.constants";
 import { mapFalStatusToJobStatus } from "./fal-status-mapper";
-import {
-  FAL_IMAGE_FEATURE_MODELS,
-  FAL_VIDEO_FEATURE_MODELS,
-} from "../../domain/constants/feature-models.constants";
 import {
   buildImageFeatureInput as buildImageFeatureInputImpl,
   buildVideoFeatureInput as buildVideoFeatureInputImpl,
@@ -45,9 +41,13 @@ export class FalProvider implements IAIProvider {
   private initialized = false;
   private currentAbortController: AbortController | null = null;
   private costTracker: CostTracker | null = null;
+  private videoFeatureModels: Record<string, string> = {};
+  private imageFeatureModels: Record<string, string> = {};
 
   initialize(configData: AIProviderConfig): void {
     this.apiKey = configData.apiKey;
+    this.videoFeatureModels = configData.videoFeatureModels ?? {};
+    this.imageFeatureModels = configData.imageFeatureModels ?? {};
 
     fal.config({
       credentials: configData.apiKey,
@@ -218,7 +218,11 @@ export class FalProvider implements IAIProvider {
   }
 
   getImageFeatureModel(feature: ImageFeatureType): string {
-    return FAL_IMAGE_FEATURE_MODELS[feature];
+    const model = this.imageFeatureModels[feature];
+    if (!model) {
+      throw new Error(`No model configured for image feature: ${feature}`);
+    }
+    return model;
   }
 
   buildImageFeatureInput(
@@ -229,7 +233,11 @@ export class FalProvider implements IAIProvider {
   }
 
   getVideoFeatureModel(feature: VideoFeatureType): string {
-    return FAL_VIDEO_FEATURE_MODELS[feature];
+    const model = this.videoFeatureModels[feature];
+    if (!model) {
+      throw new Error(`No model configured for video feature: ${feature}`);
+    }
+    return model;
   }
 
   buildVideoFeatureInput(

package/src/infrastructure/services/index.ts

@@ -2,8 +2,6 @@
  * Services Index
  */
 
-import { FAL_IMAGE_FEATURE_MODELS, FAL_VIDEO_FEATURE_MODELS } from "../../domain/constants/feature-models.constants";
-import type { ImageFeatureType, VideoFeatureType } from "@umituz/react-native-ai-generation-content";
 import { falProvider } from "./fal-provider";
 
 export { FalProvider, falProvider } from "./fal-provider";
@@ -11,14 +9,6 @@ export type { FalProvider as FalProviderType } from "./fal-provider";
 export { falModelsService, type FalModelConfig } from "./fal-models.service";
 export { NSFWContentError } from "./nsfw-content-error";
 
-export function getImageFeatureModel(feature: ImageFeatureType): string {
-  return FAL_IMAGE_FEATURE_MODELS[feature];
-}
-
-export function getVideoFeatureModel(feature: VideoFeatureType): string {
-  return FAL_VIDEO_FEATURE_MODELS[feature];
-}
-
 /**
  * Cancel the current running FAL request
  */

package/src/infrastructure/utils/video-feature-builders.util.ts

@@ -29,15 +29,10 @@ export function buildVideoFromImageInput(
   const formatImage = (b64: string) =>
     b64.startsWith("data:") ? b64 : `data:image/jpeg;base64,${b64}`;
 
-  const referenceImages: string[] = [formatImage(base64)];
-  if (options?.target_image) {
-    referenceImages.push(formatImage(options.target_image));
-  }
-
   return {
     prompt: options?.prompt || options?.motion_prompt || "Generate natural motion video",
-    reference_image_urls: referenceImages,
-    aspect_ratio: options?.aspect_ratio || "9:16",
-    movement_amplitude: options?.movement_amplitude || "auto",
+    image_url: formatImage(base64),
+    duration: options?.duration || 5,
+    resolution: options?.resolution || "720p",
   };
 }