@umituz/react-native-ai-generation-content 1.27.25 → 1.27.26

package/package.json

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

package/src/domains/generation/wizard/infrastructure/strategies/image-generation.strategy.ts

@@ -16,6 +16,7 @@ import {
 } from "./wizard-strategy.constants";
 import { buildFacePreservationPrompt } from "../../../../prompts/infrastructure/builders/face-preservation-builder";
 import { buildInteractionStylePrompt, type InteractionStyle } from "../../../../prompts/infrastructure/builders/interaction-style-builder";
+import { extractPrompt, extractSelection } from "../utils";
 
 declare const __DEV__: boolean;
 
@@ -165,9 +166,8 @@ export async function buildImageInput(
 ): Promise<ImageGenerationInput | null> {
   const photos = await extractPhotosFromWizardData(wizardData);
 
-  // Get prompt from wizardData (text_input step) OR scenario.aiPrompt
-  const userPrompt = wizardData.prompt as string | undefined;
-  const prompt = userPrompt?.trim() || scenario.aiPrompt?.trim();
+  // Extract prompt using type-safe extractor with fallback
+  const prompt = extractPrompt(wizardData, scenario.aiPrompt);
 
   if (!prompt) {
     throw new Error("Prompt is required for image generation");
@@ -178,18 +178,19 @@ export async function buildImageInput(
   if (photos.length > 0) {
     const styleEnhancements: string[] = [];
 
-    const romanticMoods = wizardData.selection_romantic_mood as string[] | undefined;
-    if (romanticMoods?.length) {
+    // Extract selections using type-safe extractor
+    const romanticMoods = extractSelection(wizardData.selection_romantic_mood);
+    if (Array.isArray(romanticMoods) && romanticMoods.length > 0) {
       styleEnhancements.push(`Mood: ${romanticMoods.join(", ")}`);
     }
 
-    const artStyle = wizardData.selection_art_style as string | undefined;
-    if (artStyle && artStyle !== DEFAULT_STYLE_VALUE) {
+    const artStyle = extractSelection(wizardData.selection_art_style);
+    if (typeof artStyle === "string" && artStyle !== DEFAULT_STYLE_VALUE) {
       styleEnhancements.push(`Art style: ${artStyle}`);
     }
 
-    const artist = wizardData.selection_artist_style as string | undefined;
-    if (artist && artist !== DEFAULT_STYLE_VALUE) {
+    const artist = extractSelection(wizardData.selection_artist_style);
+    if (typeof artist === "string" && artist !== DEFAULT_STYLE_VALUE) {
       styleEnhancements.push(`Artist style: ${artist}`);
     }
 
@@ -198,8 +199,9 @@ export async function buildImageInput(
     }
   }
 
-  // Get style from wizard selection (for text-to-image)
-  const style = wizardData.style as string | undefined;
+  // Extract style using type-safe extractor (for text-to-image)
+  const styleValue = extractSelection(wizardData.style);
+  const style = typeof styleValue === "string" ? styleValue : undefined;
 
   // Get interaction style from scenario (default: romantic for couple apps)
   const interactionStyle = (scenario.interactionStyle as InteractionStyle) ?? "romantic";

package/src/domains/generation/wizard/infrastructure/strategies/video-generation.strategy.ts

@@ -10,6 +10,7 @@ import { createCreationsRepository } from "../../../../creations/infrastructure/
 import type { WizardScenarioData } from "../../presentation/hooks/useWizardGeneration";
 import type { WizardStrategy } from "./wizard-strategy.types";
 import { PHOTO_KEY_PREFIX, VIDEO_FEATURE_PATTERNS } from "./wizard-strategy.constants";
+import { extractPrompt, extractDuration } from "../utils";
 
 // ============================================================================
 // Types
@@ -86,17 +87,15 @@ export async function buildVideoInput(
 ): Promise<VideoGenerationInput | null> {
   const photos = await extractPhotosFromWizardData(wizardData);
 
-  // Get prompt from wizardData or scenario
-  const userPrompt = wizardData.prompt as string | undefined;
-  const motionPrompt = wizardData.motion_prompt as string | undefined;
-  const prompt = userPrompt?.trim() || motionPrompt?.trim() || scenario.aiPrompt?.trim();
+  // Extract prompt using type-safe extractor with fallback
+  const prompt = extractPrompt(wizardData, scenario.aiPrompt);
 
   if (!prompt) {
     throw new Error("Prompt is required for video generation");
   }
 
-  // Get duration from wizardData
-  const duration = wizardData.duration as number | undefined;
+  // Extract duration using type-safe extractor (default: 5 seconds)
+  const duration = extractDuration(wizardData, 5);
 
   return {
     sourceImageBase64: photos[0],

package/src/domains/generation/wizard/infrastructure/utils/index.ts

@@ -0,0 +1,8 @@
+export {
+  extractString,
+  extractTrimmedString,
+  extractNumber,
+  extractSelection,
+  extractPrompt,
+  extractDuration,
+} from "./wizard-data-extractors";

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

@@ -0,0 +1,198 @@
+/**
+ * Wizard Data Extractors
+ * Type-safe utilities for extracting values from wizard data
+ *
+ * Pattern: Type Guards + Normalizers
+ * @see https://www.typescriptlang.org/docs/handbook/2/narrowing.html
+ * @see https://betterstack.com/community/guides/scaling-nodejs/typescript-type-guards/
+ */
+
+// ============================================================================
+// Type Guards
+// ============================================================================
+
+/**
+ * Check if value is a non-null object
+ */
+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
+ * Uses 'in' operator for safe property checking
+ */
+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" }
+ *
+ * @param value - The value to extract string from
+ * @returns The extracted string or undefined
+ */
+export function extractString(value: unknown): string | undefined {
+  // Direct string
+  if (typeof value === "string") {
+    return value;
+  }
+
+  // Object with text or uri field
+  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 }
+ *
+ * @param value - The value to extract number from
+ * @returns The extracted number or undefined
+ */
+export function extractNumber(value: unknown): number | undefined {
+  // Direct number
+  if (typeof value === "number" && !Number.isNaN(value)) {
+    return value;
+  }
+
+  // Object with value or selection field
+  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
+ *
+ * @param value - The value to extract selection from
+ * @returns The extracted selection or undefined
+ */
+export function extractSelection(value: unknown): string | string[] | undefined {
+  // Direct string
+  if (typeof value === "string") {
+    return value;
+  }
+
+  // Direct string array
+  if (Array.isArray(value) && value.every((v) => typeof v === "string")) {
+    return value as string[];
+  }
+
+  // Object with selection field
+  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;
+}
+
+// ============================================================================
+// Prompt Extractor (Specialized)
+// ============================================================================
+
+/**
+ * Extracts prompt from wizard data with fallback chain
+ * Checks multiple keys in order: prompt, motion_prompt, text
+ *
+ * @param wizardData - The wizard data object
+ * @param fallback - Optional fallback value (e.g., scenario.aiPrompt)
+ * @returns The extracted and trimmed prompt or undefined
+ */
+export function extractPrompt(
+  wizardData: Record<string, unknown>,
+  fallback?: string,
+): string | undefined {
+  // Priority chain for prompt keys
+  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;
+      }
+    }
+  }
+
+  // Use fallback if provided
+  return fallback?.trim() || undefined;
+}
+
+// ============================================================================
+// Duration Extractor (Specialized)
+// ============================================================================
+
+/**
+ * Extracts duration from wizard data
+ * Handles both direct number and object with value field
+ *
+ * @param wizardData - The wizard data object
+ * @param defaultValue - Default duration if not found
+ * @returns The extracted duration in seconds
+ */
+export function extractDuration(
+  wizardData: Record<string, unknown>,
+  defaultValue = 5,
+): number {
+  const durationData = wizardData.duration;
+
+  const extracted = extractNumber(durationData);
+  if (extracted !== undefined && extracted > 0) {
+    return extracted;
+  }
+
+  return defaultValue;
+}