@umituz/react-native-ai-generation-content 1.37.9 → 1.37.11

package/src/domains/generation/wizard/infrastructure/utils/primitive-extractors.ts

@@ -0,0 +1,119 @@
+/**
+ * Primitive Data Extractors
+ * Type-safe utilities for extracting primitive values from unknown data
+ */
+
+// ============================================================================
+// Type Guards
+// ============================================================================
+
+/**
+ * Check if value is a non-null object
+ */
+export function isObject(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+/**
+ * Check if object has a specific property
+ */
+export function hasProperty<K extends string>(
+  obj: Record<string, unknown>,
+  key: K,
+): obj is Record<K, unknown> {
+  return key in obj;
+}
+
+// ============================================================================
+// String Extractors
+// ============================================================================
+
+/**
+ * Extracts string from various input formats:
+ * - Direct string: "my text"
+ * - Object with text field: { text: "my text" }
+ * - Object with uri field (fallback): { uri: "my text" }
+ */
+export function extractString(value: unknown): string | undefined {
+  if (typeof value === "string") {
+    return value;
+  }
+
+  if (isObject(value)) {
+    if (hasProperty(value, "text") && typeof value.text === "string") {
+      return value.text;
+    }
+    if (hasProperty(value, "uri") && typeof value.uri === "string") {
+      return value.uri;
+    }
+  }
+
+  return undefined;
+}
+
+/**
+ * Extracts and trims string, returning undefined if empty
+ */
+export function extractTrimmedString(value: unknown): string | undefined {
+  const str = extractString(value);
+  const trimmed = str?.trim();
+  return trimmed && trimmed.length > 0 ? trimmed : undefined;
+}
+
+// ============================================================================
+// Number Extractors
+// ============================================================================
+
+/**
+ * Extracts number from various input formats:
+ * - Direct number: 5
+ * - Object with value field: { value: 5 }
+ * - Object with selection field: { selection: 5 }
+ */
+export function extractNumber(value: unknown): number | undefined {
+  if (typeof value === "number" && !Number.isNaN(value)) {
+    return value;
+  }
+
+  if (isObject(value)) {
+    if (hasProperty(value, "value") && typeof value.value === "number") {
+      return value.value;
+    }
+    if (hasProperty(value, "selection") && typeof value.selection === "number") {
+      return value.selection;
+    }
+  }
+
+  return undefined;
+}
+
+// ============================================================================
+// Selection Extractors
+// ============================================================================
+
+/**
+ * Extracts selection value (string or string array) from wizard data
+ */
+export function extractSelection(value: unknown): string | string[] | undefined {
+  if (typeof value === "string") {
+    return value;
+  }
+
+  if (Array.isArray(value) && value.every((v) => typeof v === "string")) {
+    return value as string[];
+  }
+
+  if (isObject(value)) {
+    if (hasProperty(value, "selection")) {
+      const selection = value.selection;
+      if (typeof selection === "string") {
+        return selection;
+      }
+      if (Array.isArray(selection) && selection.every((v) => typeof v === "string")) {
+        return selection as string[];
+      }
+    }
+  }
+
+  return undefined;
+}

package/src/domains/generation/wizard/infrastructure/utils/wizard-field-extractors.ts

@@ -0,0 +1,65 @@
+/**
+ * Wizard Field Extractors
+ * Specialized extractors for wizard-specific data fields
+ */
+
+import { extractTrimmedString, extractNumber } from "./primitive-extractors";
+
+/**
+ * Extracts prompt from wizard data with fallback chain
+ * Checks multiple keys in order: prompt, motion_prompt, text, userPrompt
+ */
+export function extractPrompt(
+  wizardData: Record<string, unknown>,
+  fallback?: string,
+): string | undefined {
+  const promptKeys = ["prompt", "motion_prompt", "text", "userPrompt"];
+
+  for (const key of promptKeys) {
+    if (key in wizardData) {
+      const extracted = extractTrimmedString(wizardData[key]);
+      if (extracted) {
+        return extracted;
+      }
+    }
+  }
+
+  return fallback?.trim() || undefined;
+}
+
+/**
+ * Extracts duration from wizard data
+ * Handles both direct number and object with value field
+ */
+export function extractDuration(
+  wizardData: Record<string, unknown>,
+): number | undefined {
+  const durationData = wizardData.duration;
+  const extracted = extractNumber(durationData);
+  if (extracted !== undefined && extracted > 0) {
+    return extracted;
+  }
+  return undefined;
+}
+
+/**
+ * Extracts aspect ratio from wizard data
+ * Common values: "16:9", "9:16", "1:1", "4:3"
+ */
+export function extractAspectRatio(
+  wizardData: Record<string, unknown>,
+): string | undefined {
+  const aspectRatioData = wizardData.aspect_ratio;
+  return extractTrimmedString(aspectRatioData);
+}
+
+/**
+ * Extracts resolution from wizard data
+ * Common values: "720p", "1080p", "default"
+ */
+export function extractResolution(
+  wizardData: Record<string, unknown>,
+): string | undefined {
+  const resolutionData = wizardData.resolution;
+  return extractTrimmedString(resolutionData);
+}

package/src/domains/generation/wizard/presentation/components/GenericWizardFlow.tsx

@@ -6,7 +6,7 @@
 
 import React, { useMemo } from "react";
 import type { StepType } from "../../../../../domain/entities/flow-config.types";
-import type { WizardFeatureConfig } from "../../domain/entities/wizard-config.types";
+import type { WizardFeatureConfig } from "../../domain/entities/wizard-feature.types";
 import type { WizardScenarioData } from "../hooks/useWizardGeneration";
 import type { AlertMessages } from "../../../../../presentation/hooks/generation/types";
 import { validateScenario } from "../utilities/validateScenario";

package/src/domains/generation/wizard/presentation/components/WizardFlowContent.tsx

@@ -8,7 +8,7 @@ import { View, StyleSheet } from "react-native";
 import { useAppDesignTokens } from "@umituz/react-native-design-system";
 import { useFlow } from "../../../infrastructure/flow/useFlow";
 import { StepType, type StepDefinition } from "../../../../../domain/entities/flow-config.types";
-import type { WizardFeatureConfig } from "../../domain/entities/wizard-config.types";
+import type { WizardFeatureConfig } from "../../domain/entities/wizard-feature.types";
 import { buildFlowStepsFromWizard } from "../../infrastructure/builders/dynamic-step-builder";
 import { useWizardGeneration, type WizardScenarioData } from "../hooks/useWizardGeneration";
 import type { AlertMessages } from "../../../../../presentation/hooks/generation/types";

package/src/domains/generation/wizard/presentation/components/WizardStepRenderer.utils.ts

@@ -3,7 +3,7 @@ import type {
   TextInputStepConfig,
   PhotoUploadStepConfig,
   SelectionStepConfig,
-} from "../../domain/entities/wizard-config.types";
+} from "../../domain/entities/wizard-step.types";
 import type { UploadedImage } from "../../../../../presentation/hooks/generation/useAIGenerateState";
 
 function isRecord(value: unknown): value is Record<string, unknown> {

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

@@ -6,45 +6,21 @@
 
 import { useEffect, useRef, useMemo, useCallback } from "react";
 import { useGenerationOrchestrator } from "../../../../../presentation/hooks/generation";
-import type { AlertMessages } from "../../../../../presentation/hooks/generation/types";
 import { usePendingJobs } from "../../../../../presentation/hooks/use-pending-jobs";
 import { createWizardStrategy, buildWizardInput } from "../../infrastructure/strategies";
+import type {
+  UseWizardGenerationProps,
+  UseWizardGenerationReturn,
+} from "./wizard-generation.types";
 
 declare const __DEV__: boolean;
 
-import type { ScenarioInputType } from "../../../../scenarios/domain/Scenario";
-
-export type WizardOutputType = "image" | "video";
-
-export interface WizardScenarioData {
-  readonly id: string;
-  readonly aiPrompt?: string;
-  readonly outputType?: WizardOutputType;
-  /** Input type - determines required photo count. Default: "single" */
-  readonly inputType?: ScenarioInputType;
-  readonly model?: string;
-  readonly title?: string;
-  readonly description?: string;
-  [key: string]: unknown;
-}
-
-export interface UseWizardGenerationProps {
-  readonly scenario: WizardScenarioData;
-  readonly wizardData: Record<string, unknown>;
-  readonly userId?: string;
-  readonly isGeneratingStep: boolean;
-  /** Required - alert messages for error states */
-  readonly alertMessages: AlertMessages;
-  readonly onSuccess?: (result: unknown) => void;
-  readonly onError?: (error: string) => void;
-  readonly onCreditsExhausted?: () => void;
-  /** Enable background job tracking for CreationsGallery display */
-  readonly trackAsBackgroundJob?: boolean;
-}
-
-export interface UseWizardGenerationReturn {
-  readonly isGenerating: boolean;
-}
+export type {
+  WizardOutputType,
+  WizardScenarioData,
+  UseWizardGenerationProps,
+  UseWizardGenerationReturn,
+} from "./wizard-generation.types";
 
 export const useWizardGeneration = (
   props: UseWizardGenerationProps,
@@ -64,7 +40,6 @@ export const useWizardGeneration = (
   const hasStarted = useRef(false);
   const currentJobIdRef = useRef<string | null>(null);
 
-  // Background job tracking
   const { addJob, updateJob, removeJob } = usePendingJobs();
 
   useEffect(() => {
@@ -84,14 +59,12 @@ export const useWizardGeneration = (
     });
   }, [scenario]);
 
-  // Handle generation success - remove job from queue
   const handleSuccess = useCallback(
     (result: unknown) => {
       if (typeof __DEV__ !== "undefined" && __DEV__) {
         console.log("[useWizardGeneration] Success");
       }
 
-      // Remove job from pending queue (creation is saved)
       if (trackAsBackgroundJob && currentJobIdRef.current) {
         removeJob(currentJobIdRef.current);
         currentJobIdRef.current = null;
@@ -102,14 +75,12 @@ export const useWizardGeneration = (
     [trackAsBackgroundJob, removeJob, onSuccess],
   );
 
-  // Handle generation error - update job status
   const handleError = useCallback(
     (err: { message: string }) => {
       if (typeof __DEV__ !== "undefined" && __DEV__) {
         console.log("[useWizardGeneration] Error:", err.message);
       }
 
-      // Update job to failed status
       if (trackAsBackgroundJob && currentJobIdRef.current) {
         updateJob({
           id: currentJobIdRef.current,
@@ -122,16 +93,13 @@ export const useWizardGeneration = (
     [trackAsBackgroundJob, updateJob, onError],
   );
 
-  const { generate, isGenerating } = useGenerationOrchestrator(
-    strategy,
-    {
-      userId,
-      alertMessages,
-      onCreditsExhausted,
-      onSuccess: handleSuccess,
-      onError: handleError,
-    },
-  );
+  const { generate, isGenerating } = useGenerationOrchestrator(strategy, {
+    userId,
+    alertMessages,
+    onCreditsExhausted,
+    onSuccess: handleSuccess,
+    onError: handleError,
+  });
 
   useEffect(() => {
     if (isGeneratingStep && !hasStarted.current && !isGenerating) {
@@ -152,7 +120,6 @@ export const useWizardGeneration = (
             return;
           }
 
-          // Create background job for tracking
           if (trackAsBackgroundJob && scenario.outputType) {
             const jobId = `wizard-${scenario.id}-${Date.now()}`;
             currentJobIdRef.current = jobId;

package/src/domains/generation/wizard/presentation/hooks/wizard-generation.types.ts

@@ -0,0 +1,39 @@
+/**
+ * Wizard Generation Types
+ * Types and interfaces for useWizardGeneration hook
+ */
+
+import type { AlertMessages } from "../../../../../presentation/hooks/generation/types";
+import type { ScenarioInputType } from "../../../../scenarios/domain/Scenario";
+
+export type WizardOutputType = "image" | "video";
+
+export interface WizardScenarioData {
+  readonly id: string;
+  readonly aiPrompt?: string;
+  readonly outputType?: WizardOutputType;
+  /** Input type - determines required photo count. Default: "single" */
+  readonly inputType?: ScenarioInputType;
+  readonly model?: string;
+  readonly title?: string;
+  readonly description?: string;
+  [key: string]: unknown;
+}
+
+export interface UseWizardGenerationProps {
+  readonly scenario: WizardScenarioData;
+  readonly wizardData: Record<string, unknown>;
+  readonly userId?: string;
+  readonly isGeneratingStep: boolean;
+  /** Required - alert messages for error states */
+  readonly alertMessages: AlertMessages;
+  readonly onSuccess?: (result: unknown) => void;
+  readonly onError?: (error: string) => void;
+  readonly onCreditsExhausted?: () => void;
+  /** Enable background job tracking for CreationsGallery display */
+  readonly trackAsBackgroundJob?: boolean;
+}
+
+export interface UseWizardGenerationReturn {
+  readonly isGenerating: boolean;
+}

package/src/domains/scenarios/configs/wizard-config-resolver.ts

@@ -3,7 +3,7 @@
  * Main resolver for getting wizard configurations
  */
 
-import type { WizardFeatureConfig } from "../../generation/wizard/domain/entities/wizard-config.types";
+import type { WizardFeatureConfig } from "../../generation/wizard/domain/entities/wizard-feature.types";
 import { getConfiguredScenario } from "../infrastructure/scenario-registry";
 import { WizardInputType, type WizardConfigOptions } from "./wizard-input.types";
 import { detectWizardInputType, SCENARIO_TO_WIZARD_INPUT_MAP } from "./wizard-input-detector";

package/src/domains/scenarios/configs/wizard-input.types.ts

@@ -3,7 +3,7 @@
  * Type definitions for wizard input classification
  */
 
-import type { WizardFeatureConfig } from "../../generation/wizard/domain/entities/wizard-config.types";
+import type { WizardFeatureConfig } from "../../generation/wizard/domain/entities/wizard-feature.types";
 
 /**
  * Input Type Classification

package/src/domains/scenarios/configs/wizard-step-factories.ts

@@ -3,7 +3,7 @@
  * Factory functions for creating wizard step configurations
  */
 
-import type { WizardFeatureConfig } from "../../generation/wizard/domain/entities/wizard-config.types";
+import type { WizardFeatureConfig } from "../../generation/wizard/domain/entities/wizard-feature.types";
 import { WizardInputType, type WizardConfigFactory } from "./wizard-input.types";
 
 function createDualImageConfig(scenarioId: string): WizardFeatureConfig {

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

@@ -0,0 +1,59 @@
+/**
+ * Image-to-Video Feature Types
+ * Types, interfaces, and constants for the image-to-video feature hook
+ */
+
+import type {
+  ImageToVideoFeatureState,
+  ImageToVideoFeatureConfig,
+  ImageToVideoResult,
+  ImageToVideoFeatureCallbacks,
+  ImageToVideoGenerateParams,
+} from "../../domain/types";
+import type { AlertMessages } from "../../../../presentation/hooks/generation";
+
+export const INITIAL_STATE: ImageToVideoFeatureState = {
+  imageUri: null,
+  motionPrompt: "",
+  videoUrl: null,
+  thumbnailUrl: null,
+  isProcessing: false,
+  progress: 0,
+  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;
+  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 interface VideoGenerationInput {
+  imageUri: string;
+  imageBase64: string;
+  motionPrompt: string;
+  options?: Omit<ImageToVideoGenerateParams, "imageUri" | "motionPrompt">;
+  creationId: string;
+}
+
+export function generateCreationId(): string {
+  return `image-to-video_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+}

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

@@ -7,68 +7,28 @@ import { useState, useCallback, useMemo } from "react";
 import {
   useGenerationOrchestrator,
   type GenerationStrategy,
-  type AlertMessages,
 } from "../../../../presentation/hooks/generation";
 import { executeImageToVideo } from "../../infrastructure/services";
-import type {
-  ImageToVideoFeatureState,
-  ImageToVideoFeatureConfig,
-  ImageToVideoResult,
-  ImageToVideoFeatureCallbacks,
-  ImageToVideoGenerateParams,
-} from "../../domain/types";
+import type { ImageToVideoResult } from "../../domain/types";
+import {
+  INITIAL_STATE,
+  DEFAULT_ALERT_MESSAGES,
+  generateCreationId,
+  type UseImageToVideoFeatureProps,
+  type UseImageToVideoFeatureReturn,
+  type VideoGenerationInput,
+} from "./image-to-video-feature.types";
 
 declare const __DEV__: boolean;
 
-const INITIAL_STATE: ImageToVideoFeatureState = {
-  imageUri: null,
-  motionPrompt: "",
-  videoUrl: null,
-  thumbnailUrl: null,
-  isProcessing: 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.",
-};
-
-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;
-}
-
-interface VideoGenerationInput {
-  imageUri: string;
-  imageBase64: string;
-  motionPrompt: string;
-  options?: Omit<ImageToVideoGenerateParams, "imageUri" | "motionPrompt">;
-  creationId: string;
-}
-
-function generateCreationId(): string {
-  return `image-to-video_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
-}
+export type {
+  UseImageToVideoFeatureProps,
+  UseImageToVideoFeatureReturn,
+} from "./image-to-video-feature.types";
 
 export function useImageToVideoFeature(props: UseImageToVideoFeatureProps): UseImageToVideoFeatureReturn {
   const { config, callbacks, userId } = props;
-  const [state, setState] = useState<ImageToVideoFeatureState>(INITIAL_STATE);
+  const [state, setState] = useState(INITIAL_STATE);
 
   const strategy: GenerationStrategy<VideoGenerationInput, ImageToVideoResult> = useMemo(
     () => ({
@@ -157,7 +117,7 @@ export function useImageToVideoFeature(props: UseImageToVideoFeatureProps): UseI
   }, []);
 
   const generate = useCallback(
-    async (params?: ImageToVideoGenerateParams): Promise<ImageToVideoResult> => {
+    async (params?: Parameters<UseImageToVideoFeatureReturn["generate"]>[0]): Promise<ImageToVideoResult> => {
       const { imageUri: paramImageUri, motionPrompt: paramMotionPrompt, ...options } = params || {};
       const effectiveImageUri = paramImageUri || state.imageUri;
       const effectiveMotionPrompt = paramMotionPrompt ?? state.motionPrompt;