@umituz/react-native-ai-fal-provider 1.1.8 → 1.1.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-ai-fal-provider",
-  "version": "1.1.8",
+  "version": "1.1.9",
   "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

@@ -8,6 +8,7 @@ export enum FalErrorType {
   TIMEOUT = "timeout",
   API_ERROR = "api_error",
   VALIDATION = "validation",
+  IMAGE_TOO_SMALL = "image_too_small",
   CONTENT_POLICY = "content_policy",
   RATE_LIMIT = "rate_limit",
   AUTHENTICATION = "authentication",

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

@@ -12,6 +12,42 @@ import { validateNSFWContent } from "../validators/nsfw-validator";
 
 declare const __DEV__: boolean | undefined;
 
+interface FalApiErrorDetail {
+  msg?: string;
+  type?: string;
+  loc?: string[];
+}
+
+interface FalApiError {
+  body?: { detail?: FalApiErrorDetail[] } | string;
+  message?: string;
+}
+
+/**
+ * Parse FAL API error and extract user-friendly message
+ */
+function parseFalError(error: unknown): string {
+  const fallback = error instanceof Error ? error.message : String(error);
+
+  const falError = error as FalApiError;
+  if (!falError?.body) return fallback;
+
+  const body = typeof falError.body === "string"
+    ? safeJsonParse(falError.body)
+    : falError.body;
+
+  const detail = body?.detail?.[0];
+  return detail?.msg ?? falError.message ?? fallback;
+}
+
+function safeJsonParse(str: string): { detail?: FalApiErrorDetail[] } | null {
+  try {
+    return JSON.parse(str);
+  } catch {
+    return null;
+  }
+}
+
 /**
  * Handle FAL subscription with timeout and cancellation
  */
@@ -91,6 +127,13 @@ export async function handleFalSubscription<T = unknown>(
 
     options?.onResult?.(result as T);
     return { result: result as T, requestId: currentRequestId };
+  } catch (error) {
+    // Parse FAL error and throw with user-friendly message
+    const userMessage = parseFalError(error);
+    if (typeof __DEV__ !== "undefined" && __DEV__) {
+      console.error("[FalProvider] Error:", userMessage);
+    }
+    throw new Error(userMessage);
   } finally {
     if (timeoutId) clearTimeout(timeoutId);
   }
@@ -110,16 +153,24 @@ export async function handleFalRun<T = unknown>(
     console.log("[FalProvider] run() model:", model, "inputKeys:", Object.keys(input));
   }
 
-  const result = await fal.run(model, { input });
+  try {
+    const result = await fal.run(model, { input });
 
-  if (typeof __DEV__ !== "undefined" && __DEV__) {
-    console.log("[FalProvider] run() raw result:", JSON.stringify(result, null, 2));
-    console.log("[FalProvider] run() result type:", typeof result);
-    console.log("[FalProvider] run() result keys:", result ? Object.keys(result as object) : "null");
-  }
+    if (typeof __DEV__ !== "undefined" && __DEV__) {
+      console.log("[FalProvider] run() raw result:", JSON.stringify(result, null, 2));
+      console.log("[FalProvider] run() result type:", typeof result);
+      console.log("[FalProvider] run() result keys:", result ? Object.keys(result as object) : "null");
+    }
 
-  validateNSFWContent(result as Record<string, unknown>);
+    validateNSFWContent(result as Record<string, unknown>);
 
-  options?.onProgress?.({ progress: 100, status: "COMPLETED" as const });
-  return result as T;
+    options?.onProgress?.({ progress: 100, status: "COMPLETED" as const });
+    return result as T;
+  } catch (error) {
+    const userMessage = parseFalError(error);
+    if (typeof __DEV__ !== "undefined" && __DEV__) {
+      console.error("[FalProvider] run() Error:", userMessage);
+    }
+    throw new Error(userMessage);
+  }
 }

package/src/infrastructure/utils/error-categorizer.ts

@@ -7,6 +7,7 @@ import { FalErrorType, type FalErrorCategory } from "../../domain/entities/error
 const PATTERNS: Record<FalErrorType, string[]> = {
   [FalErrorType.NETWORK]: ["network", "fetch", "connection", "econnrefused", "enotfound", "etimedout"],
   [FalErrorType.TIMEOUT]: ["timeout", "timed out"],
+  [FalErrorType.IMAGE_TOO_SMALL]: ["image_too_small", "image dimensions are too small", "minimum dimensions"],
   [FalErrorType.VALIDATION]: ["validation", "invalid", "unprocessable", "422", "bad request", "400"],
   [FalErrorType.CONTENT_POLICY]: ["content_policy", "content policy", "policy violation", "nsfw", "inappropriate"],
   [FalErrorType.RATE_LIMIT]: ["rate limit", "too many requests", "429", "quota"],

package/src/infrastructure/utils/fal-storage.util.ts

@@ -10,71 +10,17 @@ import {
   getFileSize,
   detectMimeType,
 } from "@umituz/react-native-design-system/filesystem";
-import { ImageTransformService } from "@umituz/react-native-design-system/image";
 
 declare const __DEV__: boolean | undefined;
 
-// FAL.ai minimum image dimensions
-const MIN_WIDTH = 300;
-const MIN_HEIGHT = 300;
-
-/**
- * Ensure image meets minimum dimension requirements
- * Upscales small images to 300x300 minimum
- */
-async function ensureMinimumDimensions(uri: string): Promise<string> {
-  try {
-    // Get image dimensions by reading the file
-    const { Image } = await import("react-native");
-
-    return new Promise((resolve) => {
-      Image.getSize(
-        uri,
-        async (width, height) => {
-          if (width >= MIN_WIDTH && height >= MIN_HEIGHT) {
-            resolve(uri);
-            return;
-          }
-
-          // Calculate new dimensions (maintain aspect ratio, ensure minimum)
-          const scale = Math.max(MIN_WIDTH / width, MIN_HEIGHT / height);
-          const newWidth = Math.ceil(width * scale);
-          const newHeight = Math.ceil(height * scale);
-
-          if (typeof __DEV__ !== "undefined" && __DEV__) {
-            console.log("[FalStorage] Upscaling image", {
-              original: `${width}x${height}`,
-              upscaled: `${newWidth}x${newHeight}`,
-            });
-          }
-
-          const result = await ImageTransformService.resize(uri, newWidth, newHeight);
-          resolve(result.uri);
-        },
-        () => {
-          // If getSize fails, return original URI
-          resolve(uri);
-        }
-      );
-    });
-  } catch {
-    return uri;
-  }
-}
-
 /**
  * Upload base64 image to FAL storage
  * Uses design system's filesystem utilities for React Native compatibility
- * Automatically upscales images below 300x300 minimum
  */
 export async function uploadToFalStorage(base64: string): Promise<string> {
-  let tempUri = await base64ToTempFile(base64);
-  const mimeType = detectMimeType(base64);
-
-  // Ensure minimum dimensions (FAL requires 300x300)
-  tempUri = await ensureMinimumDimensions(tempUri);
-
+  const tempUri = await base64ToTempFile(base64);
   const fileSize = getFileSize(tempUri);
+  const mimeType = detectMimeType(base64);
 
   if (typeof __DEV__ !== "undefined" && __DEV__) {
     console.log("[FalStorage] Uploading image", {