@umituz/react-native-ai-fal-provider 2.0.8 → 2.0.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-ai-fal-provider",
-  "version": "2.0.8",
+  "version": "2.0.10",
   "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/entities/error.types.ts

@@ -36,6 +36,7 @@ export interface FalErrorMessages {
   timeout?: string;
   api_error?: string;
   validation?: string;
+  image_too_small?: string;
   content_policy?: string;
   rate_limit?: string;
   authentication?: string;

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

@@ -34,8 +34,6 @@ export interface ReplaceBackgroundOptions {
 
 export interface VideoFromImageOptions {
   readonly prompt?: string;
-  /** @deprecated Use prompt instead */
-  readonly motion_prompt?: string;
   /** Video duration in seconds (model-specific, e.g., 4, 8, 12 for Sora 2) */
   readonly duration?: number;
   /** Video resolution */

package/src/exports/domain.ts

@@ -33,6 +33,9 @@ export {
   DEFAULT_TEXT_TO_VOICE_MODELS,
   DEFAULT_TEXT_TO_VIDEO_MODELS,
   DEFAULT_IMAGE_TO_VIDEO_MODELS,
+  DEFAULT_TEXT_TO_TEXT_MODELS,
+  DEFAULT_CREDIT_COSTS,
+  DEFAULT_MODEL_IDS,
   getAllDefaultModels,
   getDefaultModelsByType,
   getDefaultModel,
@@ -51,9 +54,24 @@ export type {
   RemoveObjectOptions,
   ReplaceBackgroundOptions,
   VideoFromImageOptions,
+  TextToVideoOptions,
   ModelType,
   ModelSelectionConfig,
   ModelSelectionState,
   ModelSelectionActions,
   UseModelsReturn,
+  ImageFeatureType,
+  VideoFeatureType,
+  AIProviderConfig,
+  AIJobStatusType,
+  AILogEntry,
+  JobSubmission,
+  JobStatus,
+  ProviderProgressInfo,
+  SubscribeOptions,
+  RunOptions,
+  ProviderCapabilities,
+  ImageFeatureInputData,
+  VideoFeatureInputData,
+  IAIProvider,
 } from "../domain/types";

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

@@ -55,7 +55,7 @@ export function buildImageFeatureInput(
     case "anime-selfie":
       return buildKontextStyleTransferInput(imageBase64, {
         prompt: prompt || (options?.prompt as string) || DEFAULT_ANIME_SELFIE_PROMPT,
-        guidance_scale: (options?.guidance_scale as number) ?? 4.0,
+        guidance_scale: options?.guidance_scale as number | undefined,
       });
 
     default:

package/src/infrastructure/utils/base-builders.util.ts

@@ -3,14 +3,14 @@
  * Core builder functions for FAL API
  */
 
+import { formatImageDataUri } from "./image-helpers.util";
+
 export function buildSingleImageInput(
   base64: string,
   extraParams?: Record<string, unknown>,
 ): Record<string, unknown> {
   return {
-    image_url: base64.startsWith("data:")
-      ? base64
-      : `data:image/jpeg;base64,${base64}`,
+    image_url: formatImageDataUri(base64),
     ...extraParams,
   };
 }
@@ -20,12 +20,9 @@ export function buildDualImageInput(
   targetBase64: string,
   extraParams?: Record<string, unknown>,
 ): Record<string, unknown> {
-  const formatImage = (b64: string) =>
-    b64.startsWith("data:") ? b64 : `data:image/jpeg;base64,${b64}`;
-
   return {
-    image_url: formatImage(sourceBase64),
-    second_image_url: formatImage(targetBase64),
+    image_url: formatImageDataUri(sourceBase64),
+    second_image_url: formatImageDataUri(targetBase64),
     ...extraParams,
   };
 }

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

@@ -12,14 +12,15 @@ import type {
   FaceSwapOptions,
 } from "../../domain/types";
 import { buildSingleImageInput } from "./base-builders.util";
+import { formatImageDataUri } from "./image-helpers.util";
 
 export function buildUpscaleInput(
   base64: string,
   options?: UpscaleOptions,
 ): Record<string, unknown> {
   return buildSingleImageInput(base64, {
-    scale: options?.scaleFactor || 2,
-    face_enhance: options?.enhanceFaces || false,
+    scale: options?.scaleFactor ?? 2,
+    face_enhance: options?.enhanceFaces ?? false,
   });
 }
 
@@ -28,7 +29,7 @@ export function buildPhotoRestoreInput(
   options?: PhotoRestoreOptions,
 ): Record<string, unknown> {
   return buildSingleImageInput(base64, {
-    face_enhance: options?.enhanceFaces || true,
+    face_enhance: options?.enhanceFaces ?? true,
   });
 }
 
@@ -37,12 +38,9 @@ export function buildFaceSwapInput(
   targetBase64: string,
   _options?: FaceSwapOptions,
 ): Record<string, unknown> {
-  const formatImage = (b64: string) =>
-    b64.startsWith("data:") ? b64 : `data:image/jpeg;base64,${b64}`;
-
   return {
-    base_image_url: formatImage(sourceBase64),
-    swap_image_url: formatImage(targetBase64),
+    base_image_url: formatImageDataUri(sourceBase64),
+    swap_image_url: formatImageDataUri(targetBase64),
   };
 }
 

package/src/infrastructure/utils/index.ts

@@ -40,18 +40,30 @@ export {
   extractBase64,
   getDataUriExtension,
   isImageDataUri,
+} from "./image-helpers.util";
+
+export {
   uploadToFalStorage,
   uploadMultipleToFalStorage,
-  calculateTimeoutWithJitter,
-  formatCreditCost,
+} from "./fal-storage.util";
+
+export {
   truncatePrompt,
   sanitizePrompt,
+} from "./prompt-helpers.util";
+
+export {
+  calculateTimeoutWithJitter,
+  debounce,
+  throttle,
+} from "./timing-helpers.util";
+
+export {
+  formatCreditCost,
   buildErrorMessage,
   isDefined,
   removeNullish,
-  debounce,
-  throttle,
-} from "./helpers.util";
+} from "./general-helpers.util";
 
 export {
   createJobMetadata,

package/src/infrastructure/utils/job-storage/job-storage-crud.util.ts

@@ -4,6 +4,7 @@
  */
 
 import type { FalJobMetadata } from "../job-metadata";
+import { updateJobMetadata } from "../job-metadata";
 import type { IJobStorage } from "./job-storage-interface";
 
 /**
@@ -61,13 +62,6 @@ export async function updateJobStatus(
     throw new Error(`Job not found: ${requestId}`);
   }
 
-  const updated: FalJobMetadata = {
-    ...metadata,
-    status,
-    updatedAt: new Date().toISOString(),
-    ...(status === "COMPLETED" || status === "FAILED" ? { completedAt: new Date().toISOString() } : {}),
-    ...(error ? { error } : {}),
-  };
-
+  const updated = updateJobMetadata(metadata, status, error);
   await saveJobMetadata(storage, updated);
 }

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

@@ -9,6 +9,7 @@ import type {
   TextToVideoOptions,
 } from "../../domain/types";
 import { buildSingleImageInput } from "./base-builders.util";
+import { formatImageDataUri } from "./image-helpers.util";
 
 export function buildImageToImageInput(
   base64: string,
@@ -27,12 +28,9 @@ export function buildVideoFromImageInput(
   base64: string,
   options?: VideoFromImageOptions,
 ): Record<string, unknown> {
-  const formatImage = (b64: string) =>
-    b64.startsWith("data:") ? b64 : `data:image/jpeg;base64,${b64}`;
-
   return {
-    prompt: options?.prompt || options?.motion_prompt || "Generate natural motion video",
-    image_url: formatImage(base64),
+    prompt: options?.prompt || "Generate natural motion video",
+    image_url: formatImageDataUri(base64),
     enable_safety_checker: false,
     ...(options?.duration && { duration: options.duration }),
     ...(options?.resolution && { resolution: options.resolution }),

package/src/presentation/hooks/use-fal-generation.ts

@@ -5,7 +5,7 @@
 
 import { useState, useCallback, useRef } from "react";
 import { falProvider } from "../../infrastructure/services/fal-provider";
-import { mapFalError, isFalErrorRetryable } from "../../infrastructure/utils/error-mapper";
+import { mapFalError } from "../../infrastructure/utils/error-mapper";
 import type { FalJobInput, FalQueueStatus, FalLogEntry } from "../../domain/entities/fal.types";
 import type { FalErrorInfo } from "../../domain/entities/error.types";
 
@@ -38,7 +38,6 @@ export function useFalGeneration<T = unknown>(
 
   const lastRequestRef = useRef<{ endpoint: string; input: FalJobInput } | null>(null);
   const currentRequestIdRef = useRef<string | null>(null);
-  const abortControllerRef = useRef<AbortController | null>(null);
 
   const generate = useCallback(
     async (modelEndpoint: string, input: FalJobInput): Promise<T | null> => {
@@ -49,9 +48,6 @@ export function useFalGeneration<T = unknown>(
       currentRequestIdRef.current = null;
       setIsCancelling(false);
 
-      // Create abort controller for this request
-      abortControllerRef.current = new AbortController();
-
       try {
         const result = await falProvider.subscribe<T>(modelEndpoint, input, {
           timeoutMs: options?.timeoutMs,
@@ -83,7 +79,6 @@ export function useFalGeneration<T = unknown>(
       } finally {
         setIsLoading(false);
         setIsCancelling(false);
-        abortControllerRef.current = null;
       }
     },
     [options]
@@ -96,10 +91,9 @@ export function useFalGeneration<T = unknown>(
   }, [generate]);
 
   const cancel = useCallback(() => {
-    if (abortControllerRef.current) {
+    if (falProvider.hasRunningRequest()) {
       setIsCancelling(true);
-      abortControllerRef.current.abort();
-      abortControllerRef.current = null;
+      falProvider.cancelCurrentRequest();
       if (typeof __DEV__ !== "undefined" && __DEV__) {
         console.log("[useFalGeneration] Request cancelled");
       }
@@ -111,6 +105,7 @@ export function useFalGeneration<T = unknown>(
     setData(null);
     setError(null);
     setIsLoading(false);
+    setIsCancelling(false);
     lastRequestRef.current = null;
     currentRequestIdRef.current = null;
   }, [cancel]);
@@ -119,7 +114,7 @@ export function useFalGeneration<T = unknown>(
     data,
     error,
     isLoading,
-    isRetryable: error ? isFalErrorRetryable(error.originalError) : false,
+    isRetryable: error?.retryable ?? false,
     requestId: currentRequestIdRef.current,
     isCancelling,
     generate,

package/src/infrastructure/utils/helpers.util.ts

@@ -1,34 +0,0 @@
-/**
- * Helper Utilities - Re-exports
- * Backward compatibility barrel file
- */
-
-export {
-  formatImageDataUri,
-  extractBase64,
-  getDataUriExtension,
-  isImageDataUri,
-} from "./image-helpers.util";
-
-export {
-  uploadToFalStorage,
-  uploadMultipleToFalStorage,
-} from "./fal-storage.util";
-
-export {
-  truncatePrompt,
-  sanitizePrompt,
-} from "./prompt-helpers.util";
-
-export {
-  calculateTimeoutWithJitter,
-  debounce,
-  throttle,
-} from "./timing-helpers.util";
-
-export {
-  formatCreditCost,
-  buildErrorMessage,
-  isDefined,
-  removeNullish,
-} from "./general-helpers.util";