@umituz/react-native-ai-fal-provider 1.0.32 → 1.0.34

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-ai-fal-provider",
-  "version": "1.0.32",
+  "version": "1.0.34",
   "description": "FAL AI provider for React Native - implements IAIProvider interface for unified AI generation",
   "main": "./src/index.ts",
   "types": "./src/index.ts",
@@ -28,7 +28,7 @@
   },
   "peerDependencies": {
     "@fal-ai/client": ">=0.6.0",
-    "@umituz/react-native-ai-generation-content": ">=1.16.0",
+    "@umituz/react-native-ai-generation-content": ">=1.17.0",
     "react": ">=18.2.0",
     "react-native": ">=0.74.0"
   },

package/src/domain/types/index.ts

@@ -9,3 +9,14 @@ export type {
   ModelSelectionActions,
   UseModelsReturn,
 } from "./model-selection.types";
+
+export type {
+  UpscaleOptions,
+  PhotoRestoreOptions,
+  ImageToImagePromptConfig,
+  RemoveBackgroundOptions,
+  RemoveObjectOptions,
+  ReplaceBackgroundOptions,
+  VideoFromImageOptions,
+  FaceSwapOptions,
+} from "./input-builders.types";

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

@@ -0,0 +1,43 @@
+/**
+ * FAL Input Builder Types
+ */
+
+export interface UpscaleOptions {
+  scaleFactor?: number;
+  enhanceFaces?: boolean;
+}
+
+export interface PhotoRestoreOptions {
+  enhanceFaces?: boolean;
+}
+
+export interface ImageToImagePromptConfig {
+  prompt: string;
+  negativePrompt: string;
+  strength?: number;
+  guidance_scale?: number;
+  num_inference_steps?: number;
+}
+
+export interface RemoveBackgroundOptions {
+  // No additional options
+}
+
+export interface RemoveObjectOptions {
+  mask?: string;
+  prompt?: string;
+}
+
+export interface ReplaceBackgroundOptions {
+  prompt: string;
+}
+
+export interface VideoFromImageOptions {
+  target_image?: string;
+  motion_prompt?: string;
+  duration?: number;
+}
+
+export interface FaceSwapOptions {
+  // No additional options
+}

package/src/index.ts

@@ -1,154 +1,48 @@
 /**
  * @umituz/react-native-ai-fal-provider
  * FAL AI provider for React Native - implements IAIProvider interface
- *
- * Usage:
- *   import {
- *     FalProvider,
- *     falProvider,
- *     providerRegistry,
- *   } from '@umituz/react-native-ai-fal-provider';
- *   import { providerRegistry } from '@umituz/react-native-ai-generation-content';
- *
- *   // Register provider at app startup
- *   falProvider.initialize({ apiKey: 'your-api-key' });
- *   providerRegistry.register(falProvider);
- *   providerRegistry.setActiveProvider('fal');
  */
 
-// =============================================================================
-// DOMAIN LAYER - Types
-// =============================================================================
-
 export type {
-  FalConfig,
-  FalModel,
-  FalModelType,
-  FalModelPricing,
-  FalJobInput,
-  FalJobResult,
-  FalLogEntry,
-  FalQueueStatus,
-  FalSubscribeOptions,
+  FalConfig, FalModel, FalModelType, FalModelPricing, FalJobInput,
+  FalJobResult, FalLogEntry, FalQueueStatus, FalSubscribeOptions,
 } from "./domain/entities/fal.types";
 
-export {
-  FalErrorType,
-} from "./domain/entities/error.types";
-
-export type {
-  FalErrorCategory,
-  FalErrorInfo,
-  FalErrorMessages,
-} from "./domain/entities/error.types";
-
-// =============================================================================
-// DOMAIN LAYER - Default Models
-// =============================================================================
+export { FalErrorType } from "./domain/entities/error.types";
+export type { FalErrorCategory, FalErrorInfo, FalErrorMessages } from "./domain/entities/error.types";
 
 export {
-  DEFAULT_TEXT_TO_IMAGE_MODELS,
-  DEFAULT_TEXT_TO_VOICE_MODELS,
-  DEFAULT_TEXT_TO_VIDEO_MODELS,
-  DEFAULT_IMAGE_TO_VIDEO_MODELS,
-  getAllDefaultModels,
-  getDefaultModelsByType,
-  getDefaultModel,
-  findModelById,
+  DEFAULT_TEXT_TO_IMAGE_MODELS, DEFAULT_TEXT_TO_VOICE_MODELS,
+  DEFAULT_TEXT_TO_VIDEO_MODELS, DEFAULT_IMAGE_TO_VIDEO_MODELS,
+  getAllDefaultModels, getDefaultModelsByType, getDefaultModel, findModelById,
 } from "./domain/constants/default-models.constants";
-
 export type { FalModelConfig } from "./domain/constants/default-models.constants";
 
-// =============================================================================
-// DOMAIN LAYER - Feature Models
-// =============================================================================
-
 export {
-  FAL_IMAGE_FEATURE_MODELS,
-  FAL_VIDEO_FEATURE_MODELS,
-  getAllFeatureModels,
+  FAL_IMAGE_FEATURE_MODELS, FAL_VIDEO_FEATURE_MODELS, getAllFeatureModels,
 } from "./domain/constants/feature-models.constants";
+export type { FeatureModelConfig } from "./domain/constants/feature-models.constants";
 
-// Feature model getters (use these instead of deprecated getFal* functions)
 export {
-  getImageFeatureModel,
-  getVideoFeatureModel,
+  FalProvider, falProvider, falModelsService,
+  getImageFeatureModel, getVideoFeatureModel,
 } from "./infrastructure/services";
-
-export type {
-  FeatureModelConfig,
-} from "./domain/constants/feature-models.constants";
-
-// =============================================================================
-// INFRASTRUCTURE LAYER - Provider (IAIProvider Implementation)
-// =============================================================================
-
-export { FalProvider, falProvider } from "./infrastructure/services";
-
-// =============================================================================
-// INFRASTRUCTURE LAYER - Services
-// =============================================================================
-
-export { falModelsService } from "./infrastructure/services";
 export type { ModelFetcher } from "./infrastructure/services";
 
-// =============================================================================
-// INFRASTRUCTURE LAYER - Utils
-// =============================================================================
-
 export {
-  categorizeFalError,
-  falErrorMapper,
-  mapFalError,
-  isFalErrorRetryable,
-  // Input builders
-  buildSingleImageInput,
-  buildDualImageInput,
-  buildUpscaleInput,
-  buildPhotoRestoreInput,
-  buildVideoFromImageInput,
-  buildFaceSwapInput,
-  buildAnimeSelfieInput,
-  buildRemoveBackgroundInput,
-  buildRemoveObjectInput,
-  buildReplaceBackgroundInput,
-  buildHDTouchUpInput,
+  categorizeFalError, falErrorMapper, mapFalError, isFalErrorRetryable,
+  buildSingleImageInput, buildDualImageInput, buildUpscaleInput,
+  buildPhotoRestoreInput, buildVideoFromImageInput, buildFaceSwapInput,
+  buildImageToImageInput, buildRemoveBackgroundInput, buildRemoveObjectInput,
+  buildReplaceBackgroundInput, buildHDTouchUpInput,
 } from "./infrastructure/utils";
 
 export type {
-  UpscaleOptions,
-  PhotoRestoreOptions,
-  FaceSwapOptions,
-  AnimeSelfieOptions,
-  RemoveBackgroundOptions,
-  RemoveObjectOptions,
-  ReplaceBackgroundOptions,
-  VideoFromImageOptions,
-} from "./infrastructure/utils";
-
-// =============================================================================
-// DOMAIN LAYER - Model Selection Types
-// =============================================================================
-
-export type {
-  ModelType,
-  ModelSelectionConfig,
-  ModelSelectionState,
-  ModelSelectionActions,
-  UseModelsReturn,
+  UpscaleOptions, PhotoRestoreOptions, FaceSwapOptions, ImageToImagePromptConfig,
+  RemoveBackgroundOptions, RemoveObjectOptions, ReplaceBackgroundOptions,
+  VideoFromImageOptions, ModelType, ModelSelectionConfig, ModelSelectionState,
+  ModelSelectionActions, UseModelsReturn,
 } from "./domain/types";
 
-// =============================================================================
-// PRESENTATION LAYER - Hooks
-// =============================================================================
-
-export {
-  useFalGeneration,
-  useModels,
-} from "./presentation/hooks";
-
-export type {
-  UseFalGenerationOptions,
-  UseFalGenerationResult,
-  UseModelsProps,
-} from "./presentation/hooks";
+export { useFalGeneration, useModels } from "./presentation/hooks";
+export type { UseFalGenerationOptions, UseFalGenerationResult, UseModelsProps } from "./presentation/hooks";

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

@@ -20,12 +20,7 @@ import type {
 import type { FalQueueStatus } from "../../domain/entities/fal.types";
 import { DEFAULT_FAL_CONFIG, FAL_CAPABILITIES } from "./fal-provider.constants";
 import { mapFalStatusToJobStatus } from "./fal-status-mapper";
-import {
-  getImageFeatureModel,
-  getVideoFeatureModel,
-  buildImageFeatureInput,
-  buildVideoFeatureInput,
-} from "./fal-feature-builder.service";
+import { FAL_IMAGE_FEATURE_MODELS, FAL_VIDEO_FEATURE_MODELS } from "../../domain/constants/feature-models.constants";
 
 declare const __DEV__: boolean;
 
@@ -178,19 +173,19 @@ export class FalProvider implements IAIProvider {
   }
 
   getImageFeatureModel(feature: ImageFeatureType): string {
-    return getImageFeatureModel(feature);
+    return FAL_IMAGE_FEATURE_MODELS[feature];
   }
 
-  buildImageFeatureInput(feature: ImageFeatureType, data: ImageFeatureInputData): Record<string, unknown> {
-    return buildImageFeatureInput(feature, data);
+  buildImageFeatureInput(_feature: ImageFeatureType, _data: ImageFeatureInputData): Record<string, unknown> {
+    throw new Error("Use input builders directly: buildUpscaleInput, buildFaceSwapInput, etc.");
   }
 
   getVideoFeatureModel(feature: VideoFeatureType): string {
-    return getVideoFeatureModel(feature);
+    return FAL_VIDEO_FEATURE_MODELS[feature];
   }
 
-  buildVideoFeatureInput(feature: VideoFeatureType, data: VideoFeatureInputData): Record<string, unknown> {
-    return buildVideoFeatureInput(feature, data);
+  buildVideoFeatureInput(_feature: VideoFeatureType, _data: VideoFeatureInputData): Record<string, unknown> {
+    throw new Error("Use buildVideoFromImageInput directly");
   }
 }
 

package/src/infrastructure/services/index.ts

@@ -1,13 +1,17 @@
 /**
  * Services Index
- * Exports all infrastructure services
  */
 
+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";
+
 export { FalProvider, falProvider } from "./fal-provider";
 export { falModelsService, type FalModelConfig, type ModelFetcher } from "./fal-models.service";
-export {
-  getImageFeatureModel,
-  getVideoFeatureModel,
-  buildImageFeatureInput,
-  buildVideoFeatureInput,
-} from "./fal-feature-builder.service";
+
+export function getImageFeatureModel(feature: ImageFeatureType): string {
+  return FAL_IMAGE_FEATURE_MODELS[feature];
+}
+
+export function getVideoFeatureModel(feature: VideoFeatureType): string {
+  return FAL_VIDEO_FEATURE_MODELS[feature];
+}

package/src/infrastructure/utils/index.ts

@@ -1,12 +1,10 @@
 /**
  * Utils Index
- * Exports all utility functions
  */
 
 export { categorizeFalError } from "./error-categorizer";
 export { falErrorMapper, mapFalError, isFalErrorRetryable } from "./error-mapper";
 
-// Input builders
 export {
   buildSingleImageInput,
   buildDualImageInput,
@@ -14,20 +12,9 @@ export {
   buildPhotoRestoreInput,
   buildVideoFromImageInput,
   buildFaceSwapInput,
-  buildAnimeSelfieInput,
+  buildImageToImageInput,
   buildRemoveBackgroundInput,
   buildRemoveObjectInput,
   buildReplaceBackgroundInput,
   buildHDTouchUpInput,
 } from "./input-builders.util";
-
-export type {
-  UpscaleOptions,
-  PhotoRestoreOptions,
-  FaceSwapOptions,
-  AnimeSelfieOptions,
-  RemoveBackgroundOptions,
-  RemoveObjectOptions,
-  ReplaceBackgroundOptions,
-  VideoFromImageOptions,
-} from "./input-builders.util";

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

@@ -1,106 +1,18 @@
 /**
- * FAL Input Builders
- * Constructs FAL API input from normalized data
- *
- * NOTE: Once @umituz/react-native-ai-generation-content is published with
- * ImagePromptBuilder, replace buildAnimeSelfiePrompt with:
- *
- *   import { createAnimeSelfiePrompt, createStyleTransferPrompt }
- *     from "@umituz/react-native-ai-generation-content";
+ * FAL Input Builders - Constructs FAL API input from normalized data
+ * Provider-agnostic: accepts prompt config as parameter, not imported
  */
 
-// =============================================================================
-// INTERNAL PROMPT BUILDING (temporary - will use ImagePromptBuilder after publish)
-// =============================================================================
-
-const ANIME_SELFIE_PROMPT = [
-  // Anime style FIRST - highest priority
-  "anime style portrait",
-  "2D anime illustration",
-  "japanese anime art style",
-  "cel-shaded anime character",
-  "large sparkling anime eyes with detailed iris",
-  "smooth cel-shaded skin with subtle anime blush",
-  "stylized anime hair with highlights",
-  "Studio Ghibli inspired",
-  "vibrant anime colors",
-  "clean anime lineart",
-  "professional anime portrait",
-  "hand drawn anime",
-  "manga style",
-  // Identity preservation - secondary
-  "same person",
-  "preserve original gender",
-  "same facial features",
-].join(", ");
-
-const ANIME_SELFIE_NEGATIVE_PROMPT = [
-  // Identity negative
-  "gender swap",
-  "different person",
-  "wrong gender",
-  "changed identity",
-  // Anti-realism
-  "photorealistic",
-  "realistic photo",
-  "3D render",
-  "hyperrealistic",
-  "real person",
-  "natural skin texture",
-  "pores",
-  "wrinkles",
-  // Anatomy negative
-  "deformed face",
-  "bad anatomy",
-  "extra limbs",
-  "mutated hands",
-  "extra fingers",
-  "missing fingers",
-].join(", ");
-
-// =============================================================================
-// TYPES
-// =============================================================================
-
-export interface UpscaleOptions {
-  scaleFactor?: number;
-  enhanceFaces?: boolean;
-}
-
-export interface PhotoRestoreOptions {
-  enhanceFaces?: boolean;
-}
-
-export interface FaceSwapOptions {
-  // No additional options
-}
-
-export interface AnimeSelfieOptions {
-  style?: string;
-}
-
-export interface RemoveBackgroundOptions {
-  // No additional options
-}
-
-export interface RemoveObjectOptions {
-  mask?: string;
-  prompt?: string;
-}
-
-export interface ReplaceBackgroundOptions {
-  prompt: string;
-}
-
-export interface VideoFromImageOptions {
-  target_image?: string;
-  motion_prompt?: string;
-  duration?: number;
-}
-
-// =============================================================================
-// BASE BUILDERS
-// =============================================================================
+import type {
+  UpscaleOptions,
+  PhotoRestoreOptions,
+  ImageToImagePromptConfig,
+  RemoveBackgroundOptions,
+  RemoveObjectOptions,
+  ReplaceBackgroundOptions,
+  VideoFromImageOptions,
+  FaceSwapOptions,
+} from "../../domain/types";
 
 /**
  * Build FAL single image input format
@@ -197,26 +109,19 @@ export function buildFaceSwapInput(
 }
 
 /**
- * Build anime selfie input for FAL flux/dev/image-to-image
- * Transforms person's photo to anime style while preserving facial features
- *
- * Uses comprehensive identity preservation + anime style prompts
- * After @umituz/react-native-ai-generation-content publish, will use ImagePromptBuilder
+ * Build image-to-image input for FAL flux/dev/image-to-image
+ * Accepts prompt config as parameter for provider-agnostic usage
  */
-export function buildAnimeSelfieInput(
+export function buildImageToImageInput(
   base64: string,
-  options?: AnimeSelfieOptions,
+  promptConfig: ImageToImagePromptConfig,
 ): Record<string, unknown> {
-  const prompt = options?.style
-    ? `${options.style} style, ${ANIME_SELFIE_PROMPT}`
-    : ANIME_SELFIE_PROMPT;
-
   return buildSingleImageInput(base64, {
-    prompt,
-    negative_prompt: ANIME_SELFIE_NEGATIVE_PROMPT,
-    strength: 0.92,
-    num_inference_steps: 50,
-    guidance_scale: 8.5,
+    prompt: promptConfig.prompt,
+    negative_prompt: promptConfig.negativePrompt,
+    strength: promptConfig.strength ?? 0.85,
+    num_inference_steps: promptConfig.num_inference_steps ?? 50,
+    guidance_scale: promptConfig.guidance_scale ?? 7.5,
   });
 }
 

package/src/infrastructure/services/fal-feature-builder.service.ts

@@ -1,87 +0,0 @@
-/**
- * FAL Feature Builder Service
- * Handles building input data for different AI features
- */
-
-import type {
-  ImageFeatureType,
-  VideoFeatureType,
-  ImageFeatureInputData,
-  VideoFeatureInputData,
-} from "@umituz/react-native-ai-generation-content";
-import {
-  FAL_IMAGE_FEATURE_MODELS,
-  FAL_VIDEO_FEATURE_MODELS,
-} from "../../domain/constants/feature-models.constants";
-import {
-  buildUpscaleInput,
-  buildPhotoRestoreInput,
-  buildVideoFromImageInput,
-  buildFaceSwapInput,
-  buildAnimeSelfieInput,
-  buildRemoveBackgroundInput,
-  buildRemoveObjectInput,
-  buildReplaceBackgroundInput,
-  buildHDTouchUpInput,
-} from "../utils/input-builders.util";
-
-export function getImageFeatureModel(feature: ImageFeatureType): string {
-  return FAL_IMAGE_FEATURE_MODELS[feature];
-}
-
-export function getVideoFeatureModel(feature: VideoFeatureType): string {
-  return FAL_VIDEO_FEATURE_MODELS[feature];
-}
-
-export function buildImageFeatureInput(
-  feature: ImageFeatureType,
-  data: ImageFeatureInputData,
-): Record<string, unknown> {
-  const { imageBase64, targetImageBase64, prompt, options } = data;
-
-  switch (feature) {
-    case "upscale":
-      return buildUpscaleInput(imageBase64, options);
-    case "photo-restore":
-      return buildPhotoRestoreInput(imageBase64, options);
-    case "face-swap":
-      if (!targetImageBase64) {
-        throw new Error("Face swap requires target image");
-      }
-      return buildFaceSwapInput(imageBase64, targetImageBase64, options);
-    case "anime-selfie":
-      return buildAnimeSelfieInput(imageBase64, options);
-    case "remove-background":
-      return buildRemoveBackgroundInput(imageBase64, options);
-    case "remove-object":
-      return buildRemoveObjectInput(imageBase64, { prompt, ...options });
-    case "hd-touch-up":
-      return buildHDTouchUpInput(imageBase64, options);
-    case "replace-background":
-      if (!prompt) {
-        throw new Error("Replace background requires prompt");
-      }
-      return buildReplaceBackgroundInput(imageBase64, { prompt });
-    default:
-      throw new Error(`Unknown image feature: ${String(feature)}`);
-  }
-}
-
-export function buildVideoFeatureInput(
-  feature: VideoFeatureType,
-  data: VideoFeatureInputData,
-): Record<string, unknown> {
-  const { sourceImageBase64, targetImageBase64, prompt, options } = data;
-
-  switch (feature) {
-    case "ai-hug":
-    case "ai-kiss":
-      return buildVideoFromImageInput(sourceImageBase64, {
-        target_image: targetImageBase64,
-        motion_prompt: prompt,
-        ...options,
-      });
-    default:
-      throw new Error(`Unknown video feature: ${String(feature)}`);
-  }
-}