@umituz/react-native-ai-generation-content 1.19.9 → 1.20.2

package/package.json

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

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

@@ -6,24 +6,47 @@
 import { useState, useCallback, useMemo } from "react";
 import { useGenerationExecution } from "./useGenerationExecution";
 import { validateImageToVideoGeneration } from "./useImageToVideoValidation";
-import { INITIAL_IMAGE_TO_VIDEO_STATE } from "./useImageToVideoFeature.constants";
-import type {
-  UseImageToVideoFeatureProps,
-  UseImageToVideoFeatureReturn,
-} from "./useImageToVideoFeature.types";
 import type {
   ImageToVideoFeatureState,
-  ImageToVideoGenerateParams,
+  ImageToVideoFeatureConfig,
   ImageToVideoResult,
+  ImageToVideoFeatureCallbacks,
+  ImageToVideoGenerateParams,
 } from "../../domain/types";
 
 declare const __DEV__: boolean;
 
-export function useImageToVideoFeature(
-  props: UseImageToVideoFeatureProps,
-): UseImageToVideoFeatureReturn {
+// Initial state (inlined from constants file)
+const INITIAL_STATE: ImageToVideoFeatureState = {
+  imageUri: null,
+  motionPrompt: "",
+  videoUrl: null,
+  thumbnailUrl: null,
+  isProcessing: false,
+  progress: 0,
+  error: null,
+};
+
+// Types (inlined from types file)
+export interface UseImageToVideoFeatureProps {
+  config: ImageToVideoFeatureConfig;
+  callbacks?: ImageToVideoFeatureCallbacks;
+  userId: string;
+}
+
+export interface UseImageToVideoFeatureReturn {
+  state: ImageToVideoFeatureState;
+  setImageUri: (uri: string) => void;
+  setMotionPrompt: (prompt: string) => void;
+  generate: (params?: ImageToVideoGenerateParams) => Promise<ImageToVideoResult>;
+  reset: () => void;
+  isReady: boolean;
+  canGenerate: boolean;
+}
+
+export function useImageToVideoFeature(props: UseImageToVideoFeatureProps): UseImageToVideoFeatureReturn {
   const { config, callbacks, userId } = props;
-  const [state, setState] = useState<ImageToVideoFeatureState>(INITIAL_IMAGE_TO_VIDEO_STATE);
+  const [state, setState] = useState<ImageToVideoFeatureState>(INITIAL_STATE);
 
   const executeGeneration = useGenerationExecution({
     userId,
@@ -68,30 +91,17 @@ export function useImageToVideoFeature(
         return validation;
       }
 
-      return executeGeneration(
-        effectiveImageUri!,
-        effectiveMotionPrompt,
-        options
-      );
+      return executeGeneration(effectiveImageUri!, effectiveMotionPrompt, options);
     },
     [state.imageUri, state.motionPrompt, callbacks, config.creditCost, executeGeneration],
   );
 
   const reset = useCallback(() => {
-    setState(INITIAL_IMAGE_TO_VIDEO_STATE);
+    setState(INITIAL_STATE);
   }, []);
 
-  const isReady = useMemo(
-    () => state.imageUri !== null && !state.isProcessing,
-    [state.imageUri, state.isProcessing],
-  );
-
-  const canGenerate = useMemo(
-    () => isReady && !state.error,
-    [isReady, state.error],
-  );
+  const isReady = useMemo(() => state.imageUri !== null && !state.isProcessing, [state.imageUri, state.isProcessing]);
+  const canGenerate = useMemo(() => isReady && !state.error, [isReady, state.error]);
 
   return { state, setImageUri, setMotionPrompt, generate, reset, isReady, canGenerate };
 }
-
-export type { UseImageToVideoFeatureProps, UseImageToVideoFeatureReturn } from "./useImageToVideoFeature.types";

package/src/features/text-to-image/presentation/hooks/useGeneration.ts

@@ -1,9 +1,14 @@
 /**
  * Text-to-Image Generation Hook
- * Orchestrates generation with app-provided callbacks
+ * Uses centralized orchestrator for auth, credits, and error handling
  */
 
-import { useState, useCallback } from "react";
+import { useCallback, useMemo } from "react";
+import {
+  useGenerationOrchestrator,
+  type GenerationStrategy,
+  type AlertMessages,
+} from "../../../../presentation/hooks/generation";
 import type {
   TextToImageFormState,
   TextToImageCallbacks,
@@ -11,91 +16,95 @@ import type {
   TextToImageGenerationRequest,
 } from "../../domain/types";
 
-export interface GenerationState {
-  isGenerating: boolean;
-  progress: number;
-  error: string | null;
-}
+declare const __DEV__: boolean;
 
 export interface UseGenerationOptions {
   formState: TextToImageFormState;
   callbacks: TextToImageCallbacks;
+  userId?: string;
   onPromptCleared?: () => void;
 }
 
+export interface GenerationState {
+  isGenerating: boolean;
+  progress: number;
+  error: string | null;
+}
+
 export interface UseGenerationReturn {
   generationState: GenerationState;
   totalCost: number;
   handleGenerate: () => Promise<TextToImageGenerationResult | null>;
 }
 
-const initialState: GenerationState = {
-  isGenerating: false,
-  progress: 0,
-  error: null,
+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.",
+  authRequired: "Please sign in to continue.",
 };
 
-declare const __DEV__: boolean;
-
 export function useGeneration(options: UseGenerationOptions): UseGenerationReturn {
-  const { formState, callbacks, onPromptCleared } = options;
-  const [generationState, setGenerationState] = useState<GenerationState>(initialState);
+  const { formState, callbacks, userId, onPromptCleared } = options;
 
   const totalCost = callbacks.calculateCost(formState.numImages, formState.selectedModel);
 
-  const handleGenerate = useCallback(async (): Promise<TextToImageGenerationResult | null> => {
-    if (typeof __DEV__ !== "undefined" && __DEV__) {
-       
-      console.log("[TextToImage] handleGenerate called");
-    }
-
-    const trimmedPrompt = formState.prompt.trim();
-
-    if (!trimmedPrompt) {
+  // Build strategy for orchestrator
+  const strategy: GenerationStrategy<TextToImageGenerationRequest, string[]> = useMemo(
+    () => ({
+      execute: async (request) => {
+        if (typeof __DEV__ !== "undefined" && __DEV__) {
+          console.log("[TextToImage] Executing generation:", JSON.stringify(request, null, 2));
+        }
+        const result = await callbacks.executeGeneration(request);
+        if (result.success === false) {
+          throw new Error(result.error);
+        }
+        return result.imageUrls;
+      },
+      getCreditCost: () => totalCost,
+    }),
+    [callbacks, totalCost],
+  );
+
+  // Use orchestrator with auth support
+  const { generate, isGenerating, progress, error } = useGenerationOrchestrator(strategy, {
+    userId,
+    alertMessages: DEFAULT_ALERT_MESSAGES,
+    onCreditsExhausted: () => callbacks.onCreditsRequired?.(totalCost),
+    auth: {
+      isAuthenticated: callbacks.isAuthenticated,
+      onAuthRequired: callbacks.onAuthRequired,
+    },
+    onSuccess: (result) => {
+      const imageUrls = result as string[];
       if (typeof __DEV__ !== "undefined" && __DEV__) {
-         
-        console.log("[TextToImage] No prompt provided");
+        console.log("[TextToImage] Success! Generated", imageUrls.length, "image(s)");
       }
-      setGenerationState((prev) => ({ ...prev, error: "Prompt is required" }));
-      return null;
-    }
-
-    const isAuth = callbacks.isAuthenticated();
-    if (typeof __DEV__ !== "undefined" && __DEV__) {
-       
-      console.log("[TextToImage] isAuthenticated:", isAuth);
-    }
-
-    if (!isAuth) {
+      callbacks.onSuccess?.(imageUrls);
+      onPromptCleared?.();
+    },
+    onError: (err) => {
       if (typeof __DEV__ !== "undefined" && __DEV__) {
-         
-        console.log("[TextToImage] Auth required - calling onAuthRequired");
+        console.log("[TextToImage] Error:", err.message);
       }
-      callbacks.onAuthRequired?.();
-      return null;
-    }
+      callbacks.onError?.(err.message);
+    },
+  });
 
-    const affordable = callbacks.canAfford(totalCost);
-    if (typeof __DEV__ !== "undefined" && __DEV__) {
-       
-      console.log("[TextToImage] canAfford:", affordable, "totalCost:", totalCost);
-    }
+  const handleGenerate = useCallback(async (): Promise<TextToImageGenerationResult | null> => {
+    const trimmedPrompt = formState.prompt.trim();
 
-    if (!affordable) {
+    if (!trimmedPrompt) {
       if (typeof __DEV__ !== "undefined" && __DEV__) {
-         
-        console.log("[TextToImage] Credits required - calling onCreditsRequired");
+        console.log("[TextToImage] No prompt provided");
       }
-      callbacks.onCreditsRequired?.(totalCost);
-      return null;
+      callbacks.onError?.("Prompt is required");
+      return { success: false, error: "Prompt is required" };
     }
 
-    if (typeof __DEV__ !== "undefined" && __DEV__) {
-       
-      console.log("[TextToImage] Starting generation...");
-    }
-    setGenerationState({ isGenerating: true, progress: 0, error: null });
-
     const request: TextToImageGenerationRequest = {
       prompt: trimmedPrompt,
       model: formState.selectedModel ?? undefined,
@@ -109,51 +118,22 @@ export function useGeneration(options: UseGenerationOptions): UseGenerationRetur
     };
 
     if (typeof __DEV__ !== "undefined" && __DEV__) {
-       
-      console.log("[TextToImage] Request:", JSON.stringify(request, null, 2));
-    }
-
-    try {
-      const result = await callbacks.executeGeneration(request);
-      if (typeof __DEV__ !== "undefined" && __DEV__) {
-        const logResult = {
-          success: result.success,
-          imageCount: result.success ? result.imageUrls?.length : 0,
-          error: result.success === false ? result.error : undefined,
-        };
-         
-        console.log("[TextToImage] Result:", JSON.stringify(logResult));
-      }
-
-      if (result.success === true) {
-        if (typeof __DEV__ !== "undefined" && __DEV__) {
-           
-          console.log("[TextToImage] Success! Generated", result.imageUrls?.length, "image(s)");
-        }
-        callbacks.onSuccess?.(result.imageUrls);
-        onPromptCleared?.();
-        setGenerationState({ isGenerating: false, progress: 100, error: null });
-      } else {
-        if (typeof __DEV__ !== "undefined" && __DEV__) {
-           
-          console.log("[TextToImage] Generation failed:", result.error);
-        }
-        setGenerationState({ isGenerating: false, progress: 0, error: result.error });
-        callbacks.onError?.(result.error);
-      }
-
-      return result;
-    } catch (error) {
-      const message = error instanceof Error ? error.message : String(error);
-      if (typeof __DEV__ !== "undefined" && __DEV__) {
-         
-        console.error("[TextToImage] Exception:", message);
-      }
-      setGenerationState({ isGenerating: false, progress: 0, error: message });
-      callbacks.onError?.(message);
-      return null;
+      console.log("[TextToImage] Starting generation...");
     }
-  }, [formState, callbacks, totalCost, onPromptCleared]);
 
-  return { generationState, totalCost, handleGenerate };
+    await generate(request);
+
+    // Return result based on orchestrator state
+    return null; // Result handled via callbacks
+  }, [formState, generate, callbacks]);
+
+  return {
+    generationState: {
+      isGenerating,
+      progress,
+      error: error?.message || null,
+    },
+    totalCost,
+    handleGenerate,
+  };
 }

package/src/features/text-to-video/presentation/hooks/useTextToVideoFeature.ts

@@ -1,9 +1,15 @@
 /**
  * useTextToVideoFeature Hook
- * Single Responsibility: Orchestrate text-to-video generation with callbacks
+ * Uses centralized orchestrator for auth, credits, moderation, and error handling
  */
 
 import { useState, useCallback, useMemo } from "react";
+import {
+  useGenerationOrchestrator,
+  type GenerationStrategy,
+  type AlertMessages,
+} from "../../../../presentation/hooks/generation";
+import { executeTextToVideo } from "../../infrastructure/services";
 import type {
   TextToVideoFeatureState,
   TextToVideoConfig,
@@ -13,7 +19,6 @@ import type {
   TextToVideoInputBuilder,
   TextToVideoResultExtractor,
 } from "../../domain/types";
-import { executeVideoGeneration } from "./textToVideoExecution";
 
 declare const __DEV__: boolean;
 
@@ -47,12 +52,126 @@ const INITIAL_STATE: TextToVideoFeatureState = {
   error: null,
 };
 
-export function useTextToVideoFeature(
-  props: UseTextToVideoFeatureProps,
-): UseTextToVideoFeatureReturn {
+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.",
+};
+
+interface VideoGenerationInput {
+  prompt: string;
+  options?: TextToVideoOptions;
+  creationId: string;
+}
+
+function generateCreationId(): string {
+  return `text-to-video_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+}
+
+export function useTextToVideoFeature(props: UseTextToVideoFeatureProps): UseTextToVideoFeatureReturn {
   const { config, callbacks, userId, buildInput, extractResult } = props;
   const [state, setState] = useState<TextToVideoFeatureState>(INITIAL_STATE);
 
+  // Strategy for orchestrator
+  const strategy: GenerationStrategy<VideoGenerationInput, TextToVideoResult> = useMemo(
+    () => ({
+      execute: async (input, onProgress) => {
+        if (typeof __DEV__ !== "undefined" && __DEV__) {
+          console.log("[TextToVideo] Executing generation:", input.prompt.slice(0, 100));
+        }
+
+        // Notify generation start
+        callbacks.onGenerationStart?.({
+          creationId: input.creationId,
+          type: "text-to-video",
+          prompt: input.prompt,
+          metadata: input.options as Record<string, unknown> | undefined,
+        }).catch(() => {});
+
+        const result = await executeTextToVideo(
+          { prompt: input.prompt, userId, options: input.options },
+          {
+            model: config.model,
+            buildInput,
+            extractResult,
+            onProgress: (progress) => {
+              setState((prev) => ({ ...prev, progress }));
+              onProgress?.(progress);
+              callbacks.onProgress?.(progress);
+            },
+          },
+        );
+
+        if (!result.success || !result.videoUrl) {
+          throw new Error(result.error || "Generation failed");
+        }
+
+        // Update state with result
+        setState((prev) => ({
+          ...prev,
+          videoUrl: result.videoUrl ?? null,
+          thumbnailUrl: result.thumbnailUrl ?? null,
+        }));
+
+        return result;
+      },
+      getCreditCost: () => config.creditCost,
+      save: async (result, uid) => {
+        if (result.success && result.videoUrl) {
+          await callbacks.onCreationSave?.({
+            creationId: generateCreationId(),
+            type: "text-to-video",
+            videoUrl: result.videoUrl,
+            thumbnailUrl: result.thumbnailUrl,
+            prompt: state.prompt,
+          });
+        }
+      },
+    }),
+    [config, callbacks, buildInput, extractResult, userId, state.prompt],
+  );
+
+  // Use orchestrator with optional callbacks for credits
+  const orchestrator = useGenerationOrchestrator(strategy, {
+    userId,
+    alertMessages: DEFAULT_ALERT_MESSAGES,
+    auth: callbacks.onAuthCheck
+      ? { isAuthenticated: callbacks.onAuthCheck, onAuthRequired: () => {} }
+      : undefined,
+    credits: callbacks.onCreditCheck
+      ? {
+          checkCredits: async (cost) => (await callbacks.onCreditCheck?.(cost)) ?? true,
+          deductCredits: async (cost) => { await callbacks.onCreditDeduct?.(cost); },
+          onCreditsExhausted: () => callbacks.onShowPaywall?.(config.creditCost),
+        }
+      : undefined,
+    moderation: callbacks.onModeration
+      ? {
+          checkContent: async (input) => {
+            const result = await callbacks.onModeration!((input as VideoGenerationInput).prompt);
+            return result;
+          },
+          onShowWarning: callbacks.onShowModerationWarning,
+        }
+      : undefined,
+    onSuccess: (result) => {
+      const videoResult = result as TextToVideoResult;
+      if (typeof __DEV__ !== "undefined" && __DEV__) {
+        console.log("[TextToVideo] Success!", videoResult.videoUrl?.slice(0, 50));
+      }
+      callbacks.onGenerate?.(videoResult);
+    },
+    onError: (err) => {
+      if (typeof __DEV__ !== "undefined" && __DEV__) {
+        console.log("[TextToVideo] Error:", err.message);
+      }
+      setState((prev) => ({ ...prev, error: err.message }));
+      callbacks.onError?.(err.message);
+    },
+  });
+
   const setPrompt = useCallback(
     (prompt: string) => {
       setState((prev) => ({ ...prev, prompt, error: null }));
@@ -70,9 +189,6 @@ export function useTextToVideoFeature(
         const error = "Prompt is required";
         setState((prev) => ({ ...prev, error }));
         callbacks.onError?.(error);
-        if (__DEV__) {
-          console.log("[TextToVideoFeature] Generate failed: Prompt is required");
-        }
         return { success: false, error };
       }
 
@@ -80,74 +196,30 @@ export function useTextToVideoFeature(
         setState((prev) => ({ ...prev, prompt: effectivePrompt }));
       }
 
-      if (callbacks.onAuthCheck && !callbacks.onAuthCheck()) {
-        if (__DEV__) {
-          console.log("[TextToVideoFeature] Generate failed: Authentication required");
-        }
-        return { success: false, error: "Authentication required" };
-      }
+      setState((prev) => ({ ...prev, isProcessing: true, progress: 0, error: null }));
 
-      if (
-        callbacks.onCreditCheck &&
-        !(await callbacks.onCreditCheck(config.creditCost))
-      ) {
-        callbacks.onShowPaywall?.(config.creditCost);
-        if (__DEV__) {
-          console.log("[TextToVideoFeature] Generate failed: Insufficient credits");
-        }
-        return { success: false, error: "Insufficient credits" };
-      }
+      const creationId = generateCreationId();
+      await orchestrator.generate({ prompt: effectivePrompt, options, creationId });
 
-      if (callbacks.onModeration) {
-        const moderationResult = await callbacks.onModeration(effectivePrompt);
-        if (!moderationResult.allowed && moderationResult.warnings.length > 0) {
-          return new Promise((resolve) => {
-            callbacks.onShowModerationWarning?.(
-              moderationResult.warnings,
-              () => {
-                setState((prev) => ({ ...prev, isProcessing: false }));
-                resolve({ success: false, error: "Content policy violation" });
-              },
-              async () => {
-                const result = await executeVideoGeneration(
-                  effectivePrompt,
-                  options,
-                  { userId, config, callbacks, buildInput, extractResult },
-                  {
-                    onStateUpdate: (update) =>
-                      setState((prev) => ({ ...prev, ...update })),
-                  },
-                );
-                resolve(result);
-              },
-            );
-          });
-        }
+      setState((prev) => ({ ...prev, isProcessing: false }));
+
+      // Return result based on state
+      if (orchestrator.error) {
+        return { success: false, error: orchestrator.error.message };
       }
 
-      return executeVideoGeneration(
-        effectivePrompt,
-        options,
-        { userId, config, callbacks, buildInput, extractResult },
-        { onStateUpdate: (update) => setState((prev) => ({ ...prev, ...update })) },
-      );
+      return orchestrator.result || { success: false, error: "No result" };
     },
-    [state.prompt, callbacks, config, userId, buildInput, extractResult],
+    [state.prompt, callbacks, orchestrator],
   );
 
   const reset = useCallback(() => {
     setState(INITIAL_STATE);
-  }, []);
-
-  const isReady = useMemo(
-    () => state.prompt.trim().length > 0 && !state.isProcessing,
-    [state.prompt, state.isProcessing],
-  );
+    orchestrator.reset();
+  }, [orchestrator]);
 
-  const canGenerate = useMemo(
-    () => isReady && !state.error,
-    [isReady, state.error],
-  );
+  const isReady = useMemo(() => state.prompt.trim().length > 0 && !state.isProcessing, [state.prompt, state.isProcessing]);
+  const canGenerate = useMemo(() => isReady && !state.error, [isReady, state.error]);
 
   return { state, setPrompt, generate, reset, isReady, canGenerate };
 }

package/src/presentation/hooks/generation/index.ts

@@ -20,6 +20,10 @@ export type {
   GenerationErrorType,
   AlertMessages,
   UseGenerationOrchestratorReturn,
+  AuthCallbacks,
+  ModerationCallbacks,
+  ModerationResult,
+  CreditCallbacks,
 } from "./types";
 
 export type {

package/src/presentation/hooks/generation/orchestrator.ts

@@ -1,6 +1,8 @@
 /**
  * Generation Orchestrator
  * Feature-agnostic hook for AI generation with centralized:
+ * - Auth checking (optional)
+ * - Content moderation (optional)
  * - Credit management
  * - Error handling
  * - Alert display
@@ -32,24 +34,100 @@ export const useGenerationOrchestrator = <TInput, TResult>(
   strategy: GenerationStrategy<TInput, TResult>,
   config: GenerationConfig,
 ): UseGenerationOrchestratorReturn<TInput, TResult> => {
-  const { userId, alertMessages, onCreditsExhausted, onSuccess, onError } = config;
+  const { userId, alertMessages, onCreditsExhausted, onSuccess, onError, auth, moderation, credits } = config;
 
   if (typeof __DEV__ !== "undefined" && __DEV__) {
-    console.log("[Orchestrator] Hook initialized:", { userId, hasAlertMessages: !!alertMessages });
+    console.log("[Orchestrator] Hook initialized:", {
+      userId,
+      hasAuth: !!auth,
+      hasModeration: !!moderation,
+      hasCreditsCallbacks: !!credits,
+    });
   }
 
   const [state, setState] = useState<GenerationState<TResult>>(INITIAL_STATE);
   const isGeneratingRef = useRef(false);
+  const pendingInputRef = useRef<TInput | null>(null);
   const offlineStore = useOfflineStore();
   const { showError, showSuccess } = useAlert();
-  const { checkCredits, deductCredit } = useDeductCredit({ userId, onCreditsExhausted });
+  const defaultCredits = useDeductCredit({ userId, onCreditsExhausted });
+
+  // Use provided credit callbacks or default to useDeductCredit hook
+  const checkCredits = credits?.checkCredits ?? defaultCredits.checkCredits;
+  const deductCredit = credits?.deductCredits ?? defaultCredits.deductCredit;
+  const handleCreditsExhausted = credits?.onCreditsExhausted ?? onCreditsExhausted;
+
+  // Core execution logic (after all checks pass)
+  const executeGeneration = useCallback(
+    async (input: TInput) => {
+      const creditCost = strategy.getCreditCost();
+
+      setState((prev) => ({ ...prev, status: "generating", progress: 10 }));
+      if (typeof __DEV__ !== "undefined" && __DEV__) {
+        console.log("[Orchestrator] 🎨 Starting strategy.execute()");
+      }
+
+      const result = await strategy.execute(input, (progress) => {
+        if (typeof __DEV__ !== "undefined" && __DEV__) {
+          console.log("[Orchestrator] 📊 Progress update:", progress);
+        }
+        setState((prev) => ({ ...prev, progress }));
+      });
+
+      if (typeof __DEV__ !== "undefined" && __DEV__) {
+        console.log("[Orchestrator] ✅ strategy.execute() completed");
+      }
+
+      setState((prev) => ({ ...prev, progress: 70 }));
+
+      // Save result
+      if (strategy.save && userId) {
+        setState((prev) => ({ ...prev, status: "saving" }));
+        if (typeof __DEV__ !== "undefined" && __DEV__) {
+          console.log("[Orchestrator] 💾 Saving result...");
+        }
+        try {
+          await strategy.save(result, userId);
+          if (typeof __DEV__ !== "undefined" && __DEV__) {
+            console.log("[Orchestrator] ✅ Save completed");
+          }
+        } catch (saveErr) {
+          if (typeof __DEV__ !== "undefined" && __DEV__) {
+            console.log("[Orchestrator] ❌ Save failed:", saveErr);
+          }
+          throw createGenerationError("save", "Failed to save", saveErr instanceof Error ? saveErr : undefined);
+        }
+      }
+
+      setState((prev) => ({ ...prev, progress: 90 }));
+
+      // Deduct credit
+      if (typeof __DEV__ !== "undefined" && __DEV__) {
+        console.log("[Orchestrator] 💳 Deducting credit:", creditCost);
+      }
+      await deductCredit(creditCost);
+
+      // Success
+      setState({ status: "success", isGenerating: false, progress: 100, result, error: null });
+
+      if (typeof __DEV__ !== "undefined" && __DEV__) {
+        console.log("[Orchestrator] 🎉 Generation SUCCESS");
+      }
+
+      if (alertMessages.success) {
+        void showSuccess("Success", alertMessages.success);
+      }
+
+      onSuccess?.(result);
+    },
+    [strategy, userId, alertMessages, deductCredit, showSuccess, onSuccess],
+  );
 
   const generate = useCallback(
     async (input: TInput) => {
       if (typeof __DEV__ !== "undefined" && __DEV__) {
         console.log("[Orchestrator] 🚀 generate() called");
         console.log("[Orchestrator] Input:", JSON.stringify(input, null, 2).slice(0, 500));
-        console.log("[Orchestrator] isGeneratingRef:", isGeneratingRef.current);
       }
 
       if (isGeneratingRef.current) {
@@ -60,149 +138,141 @@ export const useGenerationOrchestrator = <TInput, TResult>(
       }
 
       isGeneratingRef.current = true;
+      pendingInputRef.current = input;
       setState({ ...INITIAL_STATE, status: "checking", isGenerating: true });
 
-      if (typeof __DEV__ !== "undefined" && __DEV__) {
-        console.log("[Orchestrator] State set to: checking, isGenerating: true");
-      }
-
       try {
-        // Network check
+        // 1. Auth check (optional)
+        if (auth) {
+          setState((prev) => ({ ...prev, status: "authenticating" }));
+          if (typeof __DEV__ !== "undefined" && __DEV__) {
+            console.log("[Orchestrator] 🔐 Checking authentication...");
+          }
+
+          if (!auth.isAuthenticated()) {
+            if (typeof __DEV__ !== "undefined" && __DEV__) {
+              console.log("[Orchestrator] ❌ Not authenticated");
+            }
+            isGeneratingRef.current = false;
+            setState(INITIAL_STATE);
+            auth.onAuthRequired?.();
+            return;
+          }
+          if (typeof __DEV__ !== "undefined" && __DEV__) {
+            console.log("[Orchestrator] ✅ Authentication passed");
+          }
+        }
+
+        // 2. Network check
         if (!offlineStore.isOnline) {
           if (typeof __DEV__ !== "undefined" && __DEV__) {
             console.log("[Orchestrator] ❌ Network check failed - offline");
           }
           throw createGenerationError("network", "No internet connection");
         }
-
         if (typeof __DEV__ !== "undefined" && __DEV__) {
           console.log("[Orchestrator] ✅ Network check passed");
         }
 
-        // Credit check
+        // 3. Credit check
         const creditCost = strategy.getCreditCost();
         if (typeof __DEV__ !== "undefined" && __DEV__) {
           console.log("[Orchestrator] 💳 Credit cost:", creditCost);
         }
 
         const hasCredits = await checkCredits(creditCost);
-        if (typeof __DEV__ !== "undefined" && __DEV__) {
-          console.log("[Orchestrator] 💳 Has credits:", hasCredits);
-        }
-
         if (!hasCredits) {
           if (typeof __DEV__ !== "undefined" && __DEV__) {
             console.log("[Orchestrator] ❌ No credits, opening paywall");
           }
           isGeneratingRef.current = false;
           setState(INITIAL_STATE);
-          onCreditsExhausted?.();
+          handleCreditsExhausted?.();
           return;
         }
-
-        // Start generation
-        setState((prev) => ({ ...prev, status: "generating", progress: 10 }));
         if (typeof __DEV__ !== "undefined" && __DEV__) {
-          console.log("[Orchestrator] 🎨 Starting strategy.execute()");
+          console.log("[Orchestrator] ✅ Credit check passed");
         }
 
-        const result = await strategy.execute(input, (progress) => {
+        // 4. Content moderation (optional)
+        if (moderation) {
+          setState((prev) => ({ ...prev, status: "moderating" }));
           if (typeof __DEV__ !== "undefined" && __DEV__) {
-            console.log("[Orchestrator] 📊 Progress update:", progress);
+            console.log("[Orchestrator] 🛡️ Checking content moderation...");
           }
-          setState((prev) => ({ ...prev, progress }));
-        });
 
-        if (typeof __DEV__ !== "undefined" && __DEV__) {
-          console.log("[Orchestrator] ✅ strategy.execute() completed");
-          console.log("[Orchestrator] Result type:", typeof result);
-        }
-
-        setState((prev) => ({ ...prev, progress: 70 }));
-
-        // Save result
-        if (strategy.save && userId) {
-          setState((prev) => ({ ...prev, status: "saving" }));
-          if (typeof __DEV__ !== "undefined" && __DEV__) {
-            console.log("[Orchestrator] 💾 Saving result...");
-          }
-          try {
-            await strategy.save(result, userId);
+          const moderationResult = await moderation.checkContent(input);
+          if (!moderationResult.allowed && moderationResult.warnings.length > 0) {
             if (typeof __DEV__ !== "undefined" && __DEV__) {
-              console.log("[Orchestrator] ✅ Save completed");
+              console.log("[Orchestrator] ⚠️ Moderation warnings:", moderationResult.warnings);
             }
-          } catch (saveErr) {
-            if (typeof __DEV__ !== "undefined" && __DEV__) {
-              console.log("[Orchestrator] ❌ Save failed:", saveErr);
+
+            if (moderation.onShowWarning) {
+              // Show warning and let user decide
+              moderation.onShowWarning(
+                moderationResult.warnings,
+                () => {
+                  // User cancelled
+                  if (typeof __DEV__ !== "undefined" && __DEV__) {
+                    console.log("[Orchestrator] User cancelled after moderation warning");
+                  }
+                  isGeneratingRef.current = false;
+                  setState(INITIAL_STATE);
+                },
+                async () => {
+                  // User continued - execute generation
+                  if (typeof __DEV__ !== "undefined" && __DEV__) {
+                    console.log("[Orchestrator] User continued after moderation warning");
+                  }
+                  try {
+                    await executeGeneration(input);
+                  } catch (err) {
+                    const error = parseError(err);
+                    setState({ status: "error", isGenerating: false, progress: 0, result: null, error });
+                    void showError("Error", getAlertMessage(error, alertMessages));
+                    onError?.(error);
+                  } finally {
+                    isGeneratingRef.current = false;
+                  }
+                },
+              );
+              return; // Exit here - callback will handle the rest
             }
-            throw createGenerationError(
-              "save",
-              "Failed to save",
-              saveErr instanceof Error ? saveErr : undefined,
-            );
+            // No warning handler - block the request
+            throw createGenerationError("policy", "Content policy violation");
+          }
+          if (typeof __DEV__ !== "undefined" && __DEV__) {
+            console.log("[Orchestrator] ✅ Moderation passed");
           }
         }
 
-        setState((prev) => ({ ...prev, progress: 90 }));
-
-        // Deduct credit
-        if (typeof __DEV__ !== "undefined" && __DEV__) {
-          console.log("[Orchestrator] 💳 Deducting credit:", creditCost);
-        }
-        await deductCredit(creditCost);
-
-        // Success
-        setState({
-          status: "success",
-          isGenerating: false,
-          progress: 100,
-          result,
-          error: null,
-        });
-
-        if (typeof __DEV__ !== "undefined" && __DEV__) {
-          console.log("[Orchestrator] 🎉 Generation SUCCESS");
-        }
-
-        if (alertMessages.success) {
-          void showSuccess("Success", alertMessages.success);
-        }
-
-        onSuccess?.(result);
+        // 5. Execute generation
+        await executeGeneration(input);
       } catch (err) {
         const error = parseError(err);
-
         if (typeof __DEV__ !== "undefined" && __DEV__) {
           console.log("[Orchestrator] ❌ Generation ERROR:", error);
         }
-
-        setState({
-          status: "error",
-          isGenerating: false,
-          progress: 0,
-          result: null,
-          error,
-        });
-
+        setState({ status: "error", isGenerating: false, progress: 0, result: null, error });
         void showError("Error", getAlertMessage(error, alertMessages));
         onError?.(error);
       } finally {
         isGeneratingRef.current = false;
         if (typeof __DEV__ !== "undefined" && __DEV__) {
-          console.log("[Orchestrator] 🏁 generate() finished, isGeneratingRef reset to false");
+          console.log("[Orchestrator] 🏁 generate() finished");
         }
       }
     },
     [
+      auth,
+      moderation,
       strategy,
-      userId,
       alertMessages,
       offlineStore.isOnline,
       checkCredits,
-      deductCredit,
+      handleCreditsExhausted,
+      executeGeneration,
       showError,
-      showSuccess,
-      onSuccess,
       onError,
     ],
   );

package/src/presentation/hooks/generation/types.ts

@@ -6,6 +6,8 @@
 export type OrchestratorStatus =
   | "idle"
   | "checking"
+  | "authenticating"
+  | "moderating"
   | "generating"
   | "saving"
   | "success"
@@ -30,6 +32,43 @@ export interface AlertMessages {
   creditFailed: string;
   unknown: string;
   success?: string;
+  authRequired?: string;
+}
+
+/** Content moderation result */
+export interface ModerationResult {
+  allowed: boolean;
+  warnings: string[];
+}
+
+/** Auth callbacks for features that need authentication */
+export interface AuthCallbacks {
+  /** Check if user is authenticated */
+  isAuthenticated: () => boolean;
+  /** Called when auth is required */
+  onAuthRequired?: () => void;
+}
+
+/** Moderation callbacks for content filtering */
+export interface ModerationCallbacks {
+  /** Check content for policy violations */
+  checkContent: (input: unknown) => Promise<ModerationResult>;
+  /** Show moderation warning with continue/cancel options */
+  onShowWarning?: (
+    warnings: string[],
+    onCancel: () => void,
+    onContinue: () => void,
+  ) => void;
+}
+
+/** Credit callbacks for features that manage credits via callbacks */
+export interface CreditCallbacks {
+  /** Check if user can afford the cost */
+  checkCredits: (cost: number) => Promise<boolean>;
+  /** Deduct credits after successful generation */
+  deductCredits: (cost: number) => Promise<void>;
+  /** Called when credits are exhausted */
+  onCreditsExhausted?: () => void;
 }
 
 export interface GenerationConfig {
@@ -38,6 +77,12 @@ export interface GenerationConfig {
   onCreditsExhausted?: () => void;
   onSuccess?: (result: unknown) => void;
   onError?: (error: GenerationError) => void;
+  /** Optional auth callbacks - if not provided, auth is skipped */
+  auth?: AuthCallbacks;
+  /** Optional moderation callbacks - if not provided, moderation is skipped */
+  moderation?: ModerationCallbacks;
+  /** Optional credit callbacks - if provided, overrides default useDeductCredit */
+  credits?: CreditCallbacks;
 }
 
 export interface GenerationState<TResult> {

package/src/features/image-to-video/presentation/hooks/useImageToVideoFeature.constants.ts

@@ -1,15 +0,0 @@
-/**
- * useImageToVideoFeature Constants
- */
-
-import type { ImageToVideoFeatureState } from "../../domain/types";
-
-export const INITIAL_IMAGE_TO_VIDEO_STATE: ImageToVideoFeatureState = {
-  imageUri: null,
-  motionPrompt: "",
-  videoUrl: null,
-  thumbnailUrl: null,
-  isProcessing: false,
-  progress: 0,
-  error: null,
-};

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

@@ -1,27 +0,0 @@
-/**
- * useImageToVideoFeature Type Definitions
- */
-
-import type {
-  ImageToVideoFeatureState,
-  ImageToVideoFeatureConfig,
-  ImageToVideoResult,
-  ImageToVideoFeatureCallbacks,
-  ImageToVideoGenerateParams,
-} from "../../domain/types";
-
-export interface UseImageToVideoFeatureProps {
-  config: ImageToVideoFeatureConfig;
-  callbacks?: ImageToVideoFeatureCallbacks;
-  userId: string;
-}
-
-export interface UseImageToVideoFeatureReturn {
-  state: ImageToVideoFeatureState;
-  setImageUri: (uri: string) => void;
-  setMotionPrompt: (prompt: string) => void;
-  generate: (params?: ImageToVideoGenerateParams) => Promise<ImageToVideoResult>;
-  reset: () => void;
-  isReady: boolean;
-  canGenerate: boolean;
-}

package/src/features/text-to-video/presentation/hooks/textToVideoExecution.ts

@@ -1,134 +0,0 @@
-/**
- * Text-to-Video Execution
- * Core execution logic for text-to-video generation
- */
-
-import { executeTextToVideo } from "../../infrastructure/services";
-import type {
-  TextToVideoConfig,
-  TextToVideoCallbacks,
-  TextToVideoResult,
-  TextToVideoOptions,
-  TextToVideoInputBuilder,
-  TextToVideoResultExtractor,
-} from "../../domain/types";
-
-declare const __DEV__: boolean;
-
-export interface ExecutionContext {
-  userId: string;
-  config: TextToVideoConfig;
-  callbacks: TextToVideoCallbacks;
-  buildInput: TextToVideoInputBuilder;
-  extractResult?: TextToVideoResultExtractor;
-}
-
-export interface ExecutionCallbacks {
-  onStateUpdate: (update: {
-    isProcessing?: boolean;
-    progress?: number;
-    videoUrl?: string | null;
-    thumbnailUrl?: string | null;
-    error?: string | null;
-  }) => void;
-}
-
-function generateCreationId(): string {
-  return `text-to-video_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
-}
-
-export async function executeVideoGeneration(
-  prompt: string,
-  options: TextToVideoOptions | undefined,
-  context: ExecutionContext,
-  executionCallbacks: ExecutionCallbacks,
-): Promise<TextToVideoResult> {
-  const { userId, config, callbacks, buildInput, extractResult } = context;
-  const { onStateUpdate } = executionCallbacks;
-  const creationId = generateCreationId();
-
-  onStateUpdate({ isProcessing: true, progress: 0, error: null });
-
-  if (__DEV__) {
-    console.log(
-      "[TextToVideoFeature] Starting generation with prompt:",
-      prompt,
-      "creationId:",
-      creationId,
-    );
-  }
-
-  if (callbacks.onGenerationStart) {
-    callbacks
-      .onGenerationStart({
-        creationId,
-        type: "text-to-video",
-        prompt,
-        metadata: options as Record<string, unknown> | undefined,
-      })
-      .catch((err) => {
-        if (__DEV__) {
-          console.warn("[TextToVideoFeature] onGenerationStart failed:", err);
-        }
-      });
-  }
-
-  if (__DEV__) {
-    console.log("[TextToVideoFeature] Starting executeTextToVideo...");
-  }
-
-  try {
-    const result = await executeTextToVideo(
-      { prompt, userId, options },
-      {
-        model: config.model,
-        buildInput,
-        extractResult,
-        onProgress: (progress) => {
-          onStateUpdate({ progress });
-          callbacks.onProgress?.(progress);
-        },
-      },
-    );
-
-    if (result.success && result.videoUrl) {
-      onStateUpdate({
-        videoUrl: result.videoUrl,
-        thumbnailUrl: result.thumbnailUrl ?? null,
-        isProcessing: false,
-        progress: 100,
-      });
-
-      if (callbacks.onCreditDeduct) {
-        await callbacks.onCreditDeduct(config.creditCost);
-      }
-
-      if (callbacks.onCreationSave) {
-        await callbacks.onCreationSave({
-          creationId,
-          type: "text-to-video",
-          videoUrl: result.videoUrl,
-          thumbnailUrl: result.thumbnailUrl,
-          prompt,
-          metadata: options as Record<string, unknown> | undefined,
-        });
-      }
-
-      callbacks.onGenerate?.(result);
-    } else {
-      const error = result.error || "Generation failed";
-      onStateUpdate({ isProcessing: false, error });
-      callbacks.onError?.(error);
-    }
-
-    return result;
-  } catch (err) {
-    const errorMessage = err instanceof Error ? err.message : String(err);
-    if (__DEV__) {
-      console.error("[TextToVideoFeature] Generation error:", errorMessage);
-    }
-    onStateUpdate({ isProcessing: false, error: errorMessage });
-    callbacks.onError?.(errorMessage);
-    return { success: false, error: errorMessage };
-  }
-}