@umituz/react-native-ai-generation-content 1.61.25 → 1.61.26

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-ai-generation-content",
-  "version": "1.61.25",
+  "version": "1.61.26",
   "description": "Provider-agnostic AI generation orchestration for React Native with result preview components",
   "main": "src/index.ts",
   "types": "src/index.ts",

package/src/core/types/error.types.ts

@@ -1,36 +1,9 @@
 /**
  * AI Generation Error Types
- * Provider-agnostic error classification
+ * Re-exports from canonical domain source
  *
  * @module @umituz/react-native-ai-generation-content/core
  */
 
-export enum AIErrorType {
-  NETWORK = "NETWORK",
-  RATE_LIMIT = "RATE_LIMIT",
-  AUTHENTICATION = "AUTHENTICATION",
-  VALIDATION = "VALIDATION",
-  CONTENT_POLICY = "CONTENT_POLICY",
-  SERVER = "SERVER",
-  TIMEOUT = "TIMEOUT",
-  UNKNOWN = "UNKNOWN",
-}
-
-export interface AIErrorInfo {
-  type: AIErrorType;
-  messageKey: string;
-  retryable: boolean;
-  originalError?: unknown;
-  statusCode?: number;
-}
-
-export interface AIErrorMessages {
-  [AIErrorType.NETWORK]: string;
-  [AIErrorType.RATE_LIMIT]: string;
-  [AIErrorType.AUTHENTICATION]: string;
-  [AIErrorType.VALIDATION]: string;
-  [AIErrorType.CONTENT_POLICY]: string;
-  [AIErrorType.SERVER]: string;
-  [AIErrorType.TIMEOUT]: string;
-  [AIErrorType.UNKNOWN]: string;
-}
+export { AIErrorType } from "../../domain/entities/error.types";
+export type { AIErrorInfo, AIErrorMessages } from "../../domain/entities/error.types";

package/src/core/types/provider.types.ts

@@ -1,192 +1,39 @@
 /**
  * AI Provider Types - Core interfaces for AI generation providers
+ * Re-exports from canonical domain sources
+ *
+ * @module @umituz/react-native-ai-generation-content/core
  */
 
-// Feature Types
-export type ImageFeatureType =
-  | "upscale"
-  | "photo-restore"
-  | "face-swap"
-  | "anime-selfie"
-  | "remove-background"
-  | "remove-object"
-  | "hd-touch-up"
-  | "replace-background";
-
-/**
- * Feature types for video generation (output: video)
- */
-export type VideoFeatureType = "image-to-video" | "text-to-video";
-
-// =============================================================================
-// Provider Configuration
-// =============================================================================
-
-export interface AIProviderConfig {
-  apiKey: string;
-  maxRetries?: number;
-  baseDelay?: number;
-  maxDelay?: number;
-  defaultTimeoutMs?: number;
-  textModel?: string;
-  textToImageModel?: string;
-  imageEditModel?: string;
-  videoGenerationModel?: string;
-  videoFeatureModels?: Partial<Record<VideoFeatureType, string>>;
-  imageFeatureModels?: Partial<Record<ImageFeatureType, string>>;
-}
-
-// =============================================================================
-// Status Types
-// =============================================================================
-
-export type AIJobStatusType =
-  | "IN_QUEUE"
-  | "IN_PROGRESS"
-  | "COMPLETED"
-  | "FAILED";
-
-export interface AILogEntry {
-  message: string;
-  level: "info" | "warn" | "error";
-  timestamp?: string;
-}
-
-export interface JobSubmission {
-  requestId: string;
-  statusUrl?: string;
-  responseUrl?: string;
-}
-
-export interface JobStatus {
-  status: AIJobStatusType;
-  logs?: AILogEntry[];
-  queuePosition?: number;
-  eta?: number;
-}
-
-// =============================================================================
-// Progress & Options
-// =============================================================================
-
-export interface ProviderProgressInfo {
-  progress: number;
-  status?: AIJobStatusType;
-  message?: string;
-  estimatedTimeRemaining?: number;
-}
-
-export interface SubscribeOptions<T = unknown> {
-  timeoutMs?: number;
-  onQueueUpdate?: (status: JobStatus) => void;
-  onProgress?: (progress: ProviderProgressInfo) => void;
-  onResult?: (result: T) => void;
-}
-
-export interface RunOptions {
-  onProgress?: (progress: ProviderProgressInfo) => void;
-}
-
-// =============================================================================
-// Capabilities
-// =============================================================================
-
-export interface ProviderCapabilities {
-  imageFeatures: readonly ImageFeatureType[];
-  videoFeatures: readonly VideoFeatureType[];
-  textToImage: boolean;
-  textToVideo: boolean;
-  imageToVideo: boolean;
-  textToVoice: boolean;
-  textToText: boolean;
-}
-
-// =============================================================================
-// Feature Input Data
-// =============================================================================
-
-export interface ImageFeatureInputData {
-  imageBase64: string;
-  targetImageBase64?: string;
-  prompt?: string;
-  options?: Record<string, unknown>;
-}
-
-export interface VideoFeatureInputData {
-  sourceImageBase64?: string;
-  targetImageBase64?: string;
-  prompt?: string;
-  options?: Record<string, unknown>;
-}
-
-// =============================================================================
-// Provider Sub-Interfaces (Interface Segregation Principle)
-// =============================================================================
-
-export interface IAIProviderLifecycle {
-  initialize(config: AIProviderConfig): void;
-  isInitialized(): boolean;
-  reset(): void;
-}
-
-export interface IAIProviderCapabilities {
-  getCapabilities(): ProviderCapabilities;
-  isFeatureSupported(feature: ImageFeatureType | VideoFeatureType): boolean;
-}
-
-export interface IAIProviderJobManager {
-  submitJob(
-    model: string,
-    input: Record<string, unknown>,
-  ): Promise<JobSubmission>;
-  getJobStatus(model: string, requestId: string): Promise<JobStatus>;
-  getJobResult<T = unknown>(model: string, requestId: string): Promise<T>;
-}
-
-export interface IAIProviderExecutor {
-  subscribe<T = unknown>(
-    model: string,
-    input: Record<string, unknown>,
-    options?: SubscribeOptions<T>,
-  ): Promise<T>;
-  run<T = unknown>(
-    model: string,
-    input: Record<string, unknown>,
-    options?: RunOptions,
-  ): Promise<T>;
-}
-
-export interface IAIProviderImageFeatures {
-  getImageFeatureModel(feature: ImageFeatureType): string;
-  buildImageFeatureInput(
-    feature: ImageFeatureType,
-    data: ImageFeatureInputData,
-  ): Record<string, unknown>;
-}
-
-export interface IAIProviderVideoFeatures {
-  getVideoFeatureModel(feature: VideoFeatureType): string;
-  buildVideoFeatureInput(
-    feature: VideoFeatureType,
-    data: VideoFeatureInputData,
-  ): Record<string, unknown>;
-}
-
-// =============================================================================
-// Main Provider Interface
-// =============================================================================
-
-/**
- * Main AI Provider Interface
- * Composition of segregated interfaces following SOLID principles
- */
-export interface IAIProvider
-  extends IAIProviderLifecycle,
-    IAIProviderCapabilities,
-    IAIProviderJobManager,
-    IAIProviderExecutor,
-    IAIProviderImageFeatures,
-    IAIProviderVideoFeatures {
-  readonly providerId: string;
-  readonly providerName: string;
-}
+// Main provider types from ai-provider.interface
+export type {
+  // Feature Types
+  ImageFeatureType,
+  VideoFeatureType,
+  // Config
+  AIProviderConfig,
+  // Status
+  AIJobStatusType,
+  AILogEntry,
+  JobSubmission,
+  JobStatus,
+  // Progress
+  ProviderProgressInfo,
+  SubscribeOptions,
+  RunOptions,
+  // Capabilities
+  ProviderCapabilities,
+  // Input Data
+  ImageFeatureInputData,
+  VideoFeatureInputData,
+  // Main Provider Interface
+  IAIProvider,
+} from "../../domain/interfaces/ai-provider.interface";
+
+// Segregated provider sub-interfaces
+export type { IAIProviderLifecycle } from "../../domain/interfaces/provider-lifecycle.interface";
+export type { IAIProviderCapabilities } from "../../domain/interfaces/provider-capabilities.interface";
+export type { IAIProviderJobManager } from "../../domain/interfaces/provider-job-manager.interface";
+export type { IAIProviderExecutor } from "../../domain/interfaces/provider-executor.interface";
+export type { IAIProviderImageFeatures } from "../../domain/interfaces/provider-image-features.interface";
+export type { IAIProviderVideoFeatures } from "../../domain/interfaces/provider-video-features.interface";

package/src/core/types/result.types.ts

@@ -1,102 +1,18 @@
 /**
  * Result Type Pattern for Functional Error Handling
- * Inspired by Rust's Result<T, E> type
+ * Re-exports from canonical domain source
  *
  * @module @umituz/react-native-ai-generation-content/core
  */
 
-/**
- * Success result containing a value of type T
- */
-export interface Success<T> {
-  success: true;
-  value: T;
-}
-
-/**
- * Failure result containing an error of type E
- */
-export interface Failure<E> {
-  success: false;
-  error: E;
-}
-
-/**
- * Result type that can be either Success or Failure
- * Forces explicit error handling at compile time
- */
-export type Result<T, E = string> = Success<T> | Failure<E>;
-
-/**
- * Create a successful result
- */
-export function success<T>(value: T): Success<T> {
-  return { success: true, value };
-}
-
-/**
- * Create a failed result
- */
-export function failure<E>(error: E): Failure<E> {
-  return { success: false, error };
-}
-
-/**
- * Type guard to check if result is successful
- */
-export function isSuccess<T, E>(result: Result<T, E>): result is Success<T> {
-  return result.success === true;
-}
-
-/**
- * Type guard to check if result is a failure
- */
-export function isFailure<T, E>(result: Result<T, E>): result is Failure<E> {
-  return result.success === false;
-}
-
-/**
- * Map a successful result to a new value
- */
-export function mapResult<T, U, E>(
-  result: Result<T, E>,
-  fn: (value: T) => U,
-): Result<U, E> {
-  if (isSuccess(result)) {
-    return success(fn(result.value));
-  }
-  return result;
-}
-
-/**
- * Chain async operations on Result types
- */
-export async function andThen<T, U, E>(
-  result: Result<T, E>,
-  fn: (value: T) => Promise<Result<U, E>>,
-): Promise<Result<U, E>> {
-  if (isSuccess(result)) {
-    return fn(result.value);
-  }
-  return result;
-}
-
-/**
- * Unwrap a result, throwing if it's a failure
- */
-export function unwrap<T, E>(result: Result<T, E>): T {
-  if (isSuccess(result)) {
-    return result.value;
-  }
-  throw new Error(`Called unwrap on a failure: ${String(result.error)}`);
-}
-
-/**
- * Unwrap a result or return a default value
- */
-export function unwrapOr<T, E>(result: Result<T, E>, defaultValue: T): T {
-  if (isSuccess(result)) {
-    return result.value;
-  }
-  return defaultValue;
-}
+export type { Result, Success, Failure } from "../../domain/types/result.types";
+export {
+  success,
+  failure,
+  isSuccess,
+  isFailure,
+  mapResult,
+  andThen,
+  unwrap,
+  unwrapOr,
+} from "../../domain/types/result.types";

package/src/domain/entities/flow-config.types.ts

@@ -79,8 +79,8 @@ export interface StepDefinition<TConfig = unknown> {
   readonly component?: React.ComponentType<StepComponentProps>;
 }
 
-/** Flow Generation Status */
-export type FlowGenerationStatus = "idle" | "preparing" | "generating" | "completed" | "failed";
+/** Flow Generation Status - subset of GenerationStatus */
+export type FlowGenerationStatus = Extract<import("./generation.types").GenerationStatus, "idle" | "preparing" | "generating" | "completed" | "failed">;
 
 /** Flow State */
 export interface FlowState {

package/src/domains/generation/domain/generation.types.ts

@@ -13,14 +13,11 @@ export interface GenerationOptions {
 }
 
 // ============================================================================
-// Generation Result
+// Generation Result (re-exported from canonical source)
 // ============================================================================
 
-export interface GenerationResult<T> {
-  success: boolean;
-  data?: T;
-  error?: string;
-}
+import type { GenerationResult as _GenerationResult } from "../../../domain/entities/generation.types";
+export type { GenerationResult } from "../../../domain/entities/generation.types";
 
 // ============================================================================
 // Input Types (by generation type)
@@ -86,5 +83,5 @@ export interface GenerationExecutor<TInput, TOutput> {
     model: string,
     input: TInput,
     options?: GenerationOptions,
-  ): Promise<GenerationResult<TOutput>>;
+  ): Promise<_GenerationResult<TOutput>>;
 }

package/src/domains/generation/index.ts

@@ -2,8 +2,8 @@ export {
   useAIGeneration,
   type UseAIGenerationProps,
   type UseAIGenerationReturn,
-  type AlertMessages,
 } from "./presentation/useAIGeneration.hook";
+export type { AlertMessages } from "../../presentation/hooks/generation/types";
 
 export { featureRegistry } from "./application/feature-registry";
 export { createGenerationStrategy } from "./application/generation-strategy.factory";

package/src/domains/generation/presentation/useAIGeneration.hook.ts

@@ -5,6 +5,8 @@
  */
 
 import { useGenerationOrchestrator } from "../../../presentation/hooks/generation/orchestrator";
+import type { AlertMessages } from "../../../presentation/hooks/generation/types";
+import { DEFAULT_ALERT_MESSAGES } from "../../../presentation/constants/alert-messages";
 import { createGenerationStrategy } from "../application/generation-strategy.factory";
 
 declare const __DEV__: boolean;
@@ -13,14 +15,6 @@ declare const __DEV__: boolean;
 // Types
 // ============================================================================
 
-export interface AlertMessages {
-  networkError: string;
-  policyViolation: string;
-  saveFailed: string;
-  creditFailed: string;
-  unknown: string;
-}
-
 export interface UseAIGenerationProps {
   /** Feature ID from feature registry */
   featureId: string;
@@ -89,13 +83,7 @@ export function useAIGeneration(
   // Use orchestrator for lifecycle management
   const orchestrator = useGenerationOrchestrator(strategy, {
     userId,
-    alertMessages: alertMessages || {
-      networkError: "No internet connection",
-      policyViolation: "Content policy violation",
-      saveFailed: "Failed to save",
-      creditFailed: "Failed to deduct credits",
-      unknown: "An error occurred",
-    },
+    alertMessages: alertMessages || DEFAULT_ALERT_MESSAGES,
     onSuccess,
     onError: onError ? (error) => onError(error.message) : undefined,
     onCreditsExhausted,

package/src/domains/generation/wizard/presentation/hooks/usePhotoBlockingGeneration.ts

@@ -123,7 +123,7 @@ export function usePhotoBlockingGeneration(
       }
 
       // Start blocking generation
-      generate(input);
+      await generate(input);
     },
     [userId, scenario, persistence, generate],
   );

package/src/features/image-to-video/infrastructure/services/image-to-video-executor.ts

@@ -5,6 +5,11 @@
 
 import { BaseExecutor } from "../../../../infrastructure/executors/base-executor";
 import { isSuccess, type Result } from "../../../../domain/types/result.types";
+import { checkFalApiError } from "../../../../infrastructure/utils";
+import {
+  defaultExtractVideoResult,
+  type ExtractedVideoResult,
+} from "../../../../infrastructure/utils/video-result-extractor.util";
 import type { IAIProvider } from "../../../../domain/interfaces";
 import type {
   ImageToVideoRequest,
@@ -23,14 +28,6 @@ export interface ExecuteImageToVideoOptions {
   onProgress?: (progress: number) => void;
 }
 
-/**
- * Extracted result structure from provider response
- */
-interface ExtractedVideoResult {
-  videoUrl?: string;
-  thumbnailUrl?: string;
-}
-
 /**
  * Map job status to progress percentage
  */
@@ -51,34 +48,6 @@ const getProgressFromJobStatus = (status: string): number => {
   }
 };
 
-/**
- * Default extractor for image-to-video results
- */
-function defaultExtractResult(
-  result: unknown,
-): ExtractedVideoResult | undefined {
-  if (typeof result !== "object" || result === null) return undefined;
-
-  const r = result as Record<string, unknown>;
-
-  if (typeof r.video === "string") {
-    return { videoUrl: r.video };
-  }
-
-  if (r.video && typeof r.video === "object") {
-    const video = r.video as Record<string, unknown>;
-    if (typeof video.url === "string") {
-      return {
-        videoUrl: video.url,
-        thumbnailUrl:
-          typeof r.thumbnail === "string" ? r.thumbnail : undefined,
-      };
-    }
-  }
-
-  return undefined;
-}
-
 /**
  * Image-to-Video Executor using Template Method pattern
  * Eliminates code duplication through BaseExecutor
@@ -126,6 +95,10 @@ class ImageToVideoExecutor extends BaseExecutor<
     this.logInfo(
       `Subscribe resolved, result keys: ${result ? Object.keys(result as object) : "null"}`,
     );
+
+    // FAL can return errors with COMPLETED status - check for this
+    checkFalApiError(result);
+
     return result;
   }
 
@@ -151,7 +124,7 @@ class ImageToVideoExecutor extends BaseExecutor<
   protected getDefaultExtractor(): (
     result: unknown,
   ) => ExtractedVideoResult | undefined {
-    return defaultExtractResult;
+    return defaultExtractVideoResult;
   }
 }
 

package/src/features/image-to-video/presentation/hooks/image-to-video-feature.types.ts

@@ -10,7 +10,8 @@ import type {
   ImageToVideoFeatureCallbacks,
   ImageToVideoGenerateParams,
 } from "../../domain/types";
-import type { AlertMessages } from "../../../../presentation/hooks/generation";
+export { DEFAULT_ALERT_MESSAGES } from "../../../../presentation/constants/alert-messages";
+export { generateCreationId } from "../../../../infrastructure/utils/id-generator.util";
 
 export const INITIAL_STATE: ImageToVideoFeatureState = {
   imageUri: null,
@@ -22,14 +23,6 @@ export const INITIAL_STATE: ImageToVideoFeatureState = {
   error: null,
 };
 
-export const DEFAULT_ALERT_MESSAGES: AlertMessages = {
-  networkError: "No internet connection. Please check your network.",
-  policyViolation: "Content not allowed. Please try again.",
-  saveFailed: "Failed to save. Please try again.",
-  creditFailed: "Credit operation failed. Please try again.",
-  unknown: "An error occurred. Please try again.",
-};
-
 export interface UseImageToVideoFeatureProps {
   config: ImageToVideoFeatureConfig;
   callbacks?: ImageToVideoFeatureCallbacks;
@@ -54,6 +47,3 @@ export interface VideoGenerationInput {
   creationId: string;
 }
 
-export function generateCreationId(): string {
-  return `image-to-video_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
-}