@umituz/react-native-ai-generation-content 1.37.3 → 1.37.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-ai-generation-content",
-  "version": "1.37.3",
+  "version": "1.37.5",
   "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/video-generation.strategy.ts

@@ -6,6 +6,7 @@
 import { executeVideoFeature } from "../../../../../infrastructure/services/video-feature-executor.service";
 import { createCreationsRepository } from "../../../../creations/infrastructure/adapters";
 import type { WizardScenarioData } from "../../presentation/hooks/useWizardGeneration";
+import type { ScenarioInputType } from "../../../../scenarios/domain/Scenario";
 import type { WizardStrategy } from "./wizard-strategy.types";
 import { VIDEO_PROCESSING_PROMPTS } from "./wizard-strategy.constants";
 import { extractPrompt, extractDuration, extractAspectRatio, extractResolution } from "../utils";
@@ -15,12 +16,42 @@ import type { WizardVideoInput, CreateVideoStrategyOptions } from "./video-gener
 
 declare const __DEV__: boolean;
 
-// Re-export types for external use
 export type { WizardVideoInput, WizardVideoResult, CreateVideoStrategyOptions } from "./video-generation.types";
 
-// ============================================================================
-// Input Builder
-// ============================================================================
+interface PhotoValidationResult {
+  isValid: boolean;
+  errorKey?: string;
+}
+
+function validatePhotoCount(
+  photoCount: number,
+  inputType: ScenarioInputType | undefined,
+): PhotoValidationResult {
+  const effectiveInputType = inputType ?? "single";
+
+  switch (effectiveInputType) {
+    case "dual":
+      if (photoCount < 2) {
+        return {
+          isValid: false,
+          errorKey: "error.generation.dualPhotosRequired",
+        };
+      }
+      break;
+    case "single":
+      if (photoCount < 1) {
+        return {
+          isValid: false,
+          errorKey: "error.generation.photoRequired",
+        };
+      }
+      break;
+    case "text":
+      break;
+  }
+
+  return { isValid: true };
+}
 
 export async function buildVideoInput(
   wizardData: Record<string, unknown>,
@@ -32,7 +63,19 @@ export async function buildVideoInput(
 
   const photos = await extractPhotosAsBase64(wizardData, true);
 
-  // Extract prompt with fallback to default
+  const validation = validatePhotoCount(photos.length, scenario.inputType);
+  if (!validation.isValid) {
+    if (typeof __DEV__ !== "undefined" && __DEV__) {
+      console.log("[VideoStrategy] Validation failed", {
+        scenarioId: scenario.id,
+        inputType: scenario.inputType,
+        photoCount: photos.length,
+        errorKey: validation.errorKey,
+      });
+    }
+    throw new Error(validation.errorKey ?? "error.generation.invalidInput");
+  }
+
   let prompt = extractPrompt(wizardData, scenario.aiPrompt);
 
   if (!prompt) {
@@ -40,7 +83,7 @@ export async function buildVideoInput(
     if (defaultPrompt) {
       prompt = defaultPrompt;
     } else {
-      throw new Error("Prompt is required for video generation");
+      throw new Error("error.generation.promptRequired");
     }
   }
 

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

@@ -12,13 +12,16 @@ import { createWizardStrategy, buildWizardInput } from "../../infrastructure/str
 
 declare const __DEV__: boolean;
 
+import type { ScenarioInputType } from "../../../../scenarios/domain/Scenario";
+
 export type WizardOutputType = "image" | "video";
 
 export interface WizardScenarioData {
   readonly id: string;
-  /** AI prompt - optional if prompt comes from wizard data (text_input step) */
   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;

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

@@ -5,6 +5,8 @@
  */
 
 import type { WizardFeatureConfig } from "../../generation/wizard/domain/entities/wizard-config.types";
+import type { ScenarioInputType } from "../domain/Scenario";
+import { getConfiguredScenario } from "../infrastructure/scenario-registry";
 
 declare const __DEV__: boolean;
 
@@ -27,6 +29,16 @@ export enum WizardInputType {
 /** @deprecated Use WizardInputType instead */
 export const FeatureType = WizardInputType;
 
+/**
+ * Map ScenarioInputType to WizardInputType
+ * Enables scenarios to define input requirements via inputType field
+ */
+const SCENARIO_INPUT_TO_WIZARD_MAP: Record<ScenarioInputType, WizardInputType> = {
+  single: WizardInputType.SINGLE_IMAGE,
+  dual: WizardInputType.DUAL_IMAGE,
+  text: WizardInputType.TEXT_INPUT,
+};
+
 /**
  * Generic Input Detection Patterns
  * Only patterns that describe input/output, NOT app-specific scenarios
@@ -234,7 +246,8 @@ export interface WizardConfigOptions {
  * Priority:
  * 1. Explicit inputType in options (highest)
  * 2. Explicit config in SCENARIO_WIZARD_CONFIGS
- * 3. Auto-detect from scenario ID patterns
+ * 3. Scenario inputType from registry (if configured)
+ * 4. Auto-detect from scenario ID patterns
  *
  * @example
  * // Auto-detect from ID
@@ -279,11 +292,35 @@ export const getScenarioWizardConfig = (
     return config;
   }
 
-  // 3. Auto-detect from scenario ID
+  // 3. Check scenario's inputType from registry
+  const scenario = getConfiguredScenario(scenarioId);
+  if (scenario?.inputType) {
+    const wizardInputType = SCENARIO_INPUT_TO_WIZARD_MAP[scenario.inputType];
+
+    if (typeof __DEV__ !== "undefined" && __DEV__) {
+      console.log("[WizardConfig] Using scenario.inputType from registry", {
+        scenarioId,
+        scenarioInputType: scenario.inputType,
+        wizardInputType,
+      });
+    }
+
+    const factory = CONFIG_FACTORIES[wizardInputType];
+    let config = factory(scenarioId);
+    config = mergeConfigOverrides(config, options?.overrides);
+
+    if (options?.additionalSteps) {
+      config = { ...config, steps: [...config.steps, ...options.additionalSteps] };
+    }
+
+    return config;
+  }
+
+  // 4. Auto-detect from scenario ID patterns
   const inputType = detectWizardInputType(scenarioId);
 
   if (typeof __DEV__ !== "undefined" && __DEV__) {
-    console.log("[WizardConfig] Auto-detected inputType", {
+    console.log("[WizardConfig] Auto-detected inputType from patterns", {
       scenarioId,
       inputType,
     });

package/src/domains/scenarios/domain/Scenario.ts

@@ -569,6 +569,14 @@ export enum ScenarioId {
 
 export type ScenarioOutputType = "image" | "video";
 
+/**
+ * Scenario input type - determines required photo count
+ * single: Requires exactly 1 photo (solo transformations)
+ * dual: Requires exactly 2 photos (couple interactions)
+ * text: No photo required (text-only prompts)
+ */
+export type ScenarioInputType = "single" | "dual" | "text";
+
 export interface GeneratingMessages {
   title?: string;
   waitMessage?: string;
@@ -589,8 +597,9 @@ export interface Scenario {
   hidden?: boolean;
   /** Output type - optional, apps should configure via createScenariosForApp() */
   outputType?: ScenarioOutputType;
-  model?: string; // AI model from app config
+  /** Input type - determines required photo count. Default: "single" */
+  inputType?: ScenarioInputType;
+  model?: string;
   enabled?: boolean;
-  // Optional custom generating screen messages
   generatingMessages?: GeneratingMessages;
 }

package/src/domains/scenarios/domain/scenario.types.ts

@@ -8,6 +8,14 @@
  */
 export type ScenarioOutputType = "image" | "video";
 
+/**
+ * Input type for scenarios - determines required photo count
+ * single: Requires exactly 1 photo (solo transformations)
+ * dual: Requires exactly 2 photos (couple interactions)
+ * text: No photo required (text-only prompts)
+ */
+export type ScenarioInputType = "single" | "dual" | "text";
+
 /**
  * Scenario represents a pre-configured AI generation template
  * Used across all AI generation apps (image or video output)
@@ -26,6 +34,8 @@ export interface Scenario {
   readonly storyTemplate?: string;
   readonly requiresPhoto?: boolean;
   readonly outputType: ScenarioOutputType;
+  /** Input type - determines required photo count. Default: "single" */
+  readonly inputType?: ScenarioInputType;
   readonly enabled?: boolean;
   readonly metadata?: Record<string, unknown>;
 }
@@ -198,10 +208,11 @@ export interface ScenarioData {
   readonly icon?: string;
   readonly imageUrl?: string;
   readonly previewImageUrl?: string;
-  /** AI prompt - optional if prompt comes from wizard data */
   readonly aiPrompt?: string;
   readonly storyTemplate?: string;
   readonly requiresPhoto?: boolean;
   readonly hidden?: boolean;
+  /** Input type - determines required photo count. Default: "single" */
+  readonly inputType?: ScenarioInputType;
   readonly [key: string]: unknown;
 }

package/src/domains/scenarios/index.ts

@@ -4,7 +4,7 @@
  */
 
 // Types
-export type { ScenarioOutputType, GeneratingMessages } from "./domain/Scenario";
+export type { ScenarioOutputType, ScenarioInputType, GeneratingMessages } from "./domain/Scenario";
 export { ScenarioCategory, ScenarioId } from "./domain/Scenario";
 export type { Scenario } from "./domain/Scenario";
 

package/src/domains/scenarios/infrastructure/data/movie-legends-scenarios.ts

@@ -1,17 +1,17 @@
 import { Scenario, ScenarioId } from "../../domain/Scenario";
 import { createPhotorealisticPrompt, createStoryTemplate } from "../utils/scenario-utils";
 
-export const MOVIE_LEGENDS_SCENARIOS: Omit<Scenario, 'outputType' | 'category'>[] = [
+export const MOVIE_LEGENDS_SCENARIOS: Omit<Scenario, "outputType" | "category">[] = [
   {
     id: ScenarioId.TITANIC_BOW,
     title: "Titanic Bow",
     description: "I'm flying, Jack!",
     icon: "🚢",
-    imageUrl:
-      "https://images.unsplash.com/photo-1544551763-46a013bb70d5?w=800",
+    imageUrl: "https://images.unsplash.com/photo-1544551763-46a013bb70d5?w=800",
+    inputType: "dual",
     aiPrompt: createPhotorealisticPrompt(
       "a couple recreating iconic Titanic bow pose on grand ocean liner, man in period suspenders and white shirt holding woman from behind, woman with arms outstretched in flowing Edwardian dress with windswept hair, both facing camera with blissful romantic smiles, dramatic orange and pink sunset reflecting on endless ocean in background",
-      "warm golden sunset backlighting with ocean spray and wind effect"
+      "warm golden sunset backlighting with ocean spray and wind effect",
     ),
     storyTemplate: createStoryTemplate(
       "recreate the most romantic moment in cinema history",
@@ -23,11 +23,11 @@ export const MOVIE_LEGENDS_SCENARIOS: Omit<Scenario, 'outputType' | 'category'>[
     title: "Action Power Couple",
     description: "Back to back, guns ready",
     icon: "🔫",
-    imageUrl:
-      "https://images.unsplash.com/photo-1540324155974-7523202daa3f?w=800",
+    imageUrl: "https://images.unsplash.com/photo-1540324155974-7523202daa3f?w=800",
+    inputType: "dual",
     aiPrompt: createPhotorealisticPrompt(
       "a couple as action movie spies standing back-to-back, both facing camera with fierce confident expressions, man in tailored black suit with tactical vest, woman in sleek black dress with thigh holster, modern glass architecture with orange sunset light streaming through in background",
-      "dramatic cinematic lighting with warm orange tones and sharp shadows"
+      "dramatic cinematic lighting with warm orange tones and sharp shadows",
     ),
     storyTemplate: createStoryTemplate(
       "step into the shoes of the ultimate power duo",
@@ -40,9 +40,10 @@ export const MOVIE_LEGENDS_SCENARIOS: Omit<Scenario, 'outputType' | 'category'>[
     description: "Classic 50s diner dance",
     icon: "💃",
     imageUrl: "https://images.unsplash.com/photo-1506905925346-21bda4d32df4?w=800",
+    inputType: "dual",
     aiPrompt: createPhotorealisticPrompt(
       "a couple recreating Pulp Fiction twist contest in retro 50s diner, both facing camera with cool deadpan expressions doing classic hand-over-eyes dance move, man in thin black suit and bolo tie, woman in crisp white shirt and slim black pants with sleek dark bob haircut, red vinyl booths and checkered floor and glowing neon signs in background",
-      "warm retro diner lighting with neon glow and vintage atmosphere"
+      "warm retro diner lighting with neon glow and vintage atmosphere",
     ),
     storyTemplate: createStoryTemplate(
       "ignite the dance floor with iconic moves",
@@ -54,11 +55,11 @@ export const MOVIE_LEGENDS_SCENARIOS: Omit<Scenario, 'outputType' | 'category'>[
     title: "City of Stars",
     description: "Dancing under the twilight",
     icon: "✨",
-    imageUrl:
-      "https://images.unsplash.com/photo-1533174072545-7a4b6ad7a6c3?w=800",
+    imageUrl: "https://images.unsplash.com/photo-1533174072545-7a4b6ad7a6c3?w=800",
+    inputType: "dual",
     aiPrompt: createPhotorealisticPrompt(
       "a couple dancing on hilltop overlooking Los Angeles at magic hour, recreating La La Land bench scene, woman in flowing bright yellow sundress with skirt twirling, man in white button-down and slim navy tie, purple and orange gradient sunset sky with twinkling city lights of LA sprawling below in background",
-      "magical twilight lighting with warm golden and cool purple tones"
+      "magical twilight lighting with warm golden and cool purple tones",
     ),
     storyTemplate: createStoryTemplate(
       "dance through a dreamscape of stars",
@@ -70,11 +71,11 @@ export const MOVIE_LEGENDS_SCENARIOS: Omit<Scenario, 'outputType' | 'category'>[
     title: "The Gatsby Toast",
     description: "Old Sport!",
     icon: "🥂",
-    imageUrl:
-      "https://images.unsplash.com/photo-1516939884455-1445c8652f83?w=800",
+    imageUrl: "https://images.unsplash.com/photo-1516939884455-1445c8652f83?w=800",
+    inputType: "dual",
     aiPrompt: createPhotorealisticPrompt(
       "a couple as grand Gatsby party hosts in 1920s mansion, both facing camera with charismatic knowing smiles raising crystal champagne coupes, woman in extravagant gold sequined flapper dress with feathered headpiece and long pearls, man in impeccable white dinner jacket with slicked hair, spectacular fireworks and glamorous party guests and art deco mansion in background",
-      "lavish golden party lighting with firework sparkle and champagne glow"
+      "lavish golden party lighting with firework sparkle and champagne glow",
     ),
     storyTemplate: createStoryTemplate(
       "host the most legendary party of the century",
@@ -86,11 +87,11 @@ export const MOVIE_LEGENDS_SCENARIOS: Omit<Scenario, 'outputType' | 'category'>[
     title: "Aquarium Glance",
     description: "Love at first sight",
     icon: "🐠",
-    imageUrl:
-      "https://images.unsplash.com/photo-1544005313-94ddf0286df2?w=800",
+    imageUrl: "https://images.unsplash.com/photo-1544005313-94ddf0286df2?w=800",
+    inputType: "dual",
     aiPrompt: createPhotorealisticPrompt(
       "a couple gazing at each other through large aquarium tank, both visible through glass with mesmerized love-struck expressions, man in 90s silk shirt and chain, woman in sparkly party dress with 90s makeup, colorful tropical fish and blue water creating dreamy barrier between them, soft ethereal aquarium lighting",
-      "soft blue aquarium glow with dreamy underwater light ripples"
+      "soft blue aquarium glow with dreamy underwater light ripples",
     ),
     storyTemplate: createStoryTemplate(
       "relive the moment of first sight",
@@ -102,11 +103,11 @@ export const MOVIE_LEGENDS_SCENARIOS: Omit<Scenario, 'outputType' | 'category'>[
     title: "The Rain Kiss",
     description: "It wasn't over!",
     icon: "🌧️",
-    imageUrl:
-      "https://images.unsplash.com/photo-1515694346937-94d85e41e6f0?w=800",
+    imageUrl: "https://images.unsplash.com/photo-1515694346937-94d85e41e6f0?w=800",
+    inputType: "dual",
     aiPrompt: createPhotorealisticPrompt(
       "a couple in passionate embrace during heavy rainstorm recreating The Notebook, both facing camera with intense emotional smiles showing happy tears mixing with rain, completely soaked with clinging wet clothing, man in drenched white t-shirt woman in rain-soaked summer dress, rustic wooden dock and misty lake with moody gray sky in background",
-      "dramatic stormy lighting with rain streaks and emotional atmosphere"
+      "dramatic stormy lighting with rain streaks and emotional atmosphere",
     ),
     storyTemplate: createStoryTemplate(
       "promise to never let go",
@@ -118,11 +119,11 @@ export const MOVIE_LEGENDS_SCENARIOS: Omit<Scenario, 'outputType' | 'category'>[
     title: "Pottery Romance",
     description: "Unchained melody",
     icon: "🏺",
-    imageUrl:
-      "https://images.unsplash.com/photo-1501386761578-eac5c94b800a?w=800",
+    imageUrl: "https://images.unsplash.com/photo-1501386761578-eac5c94b800a?w=800",
+    inputType: "dual",
     aiPrompt: createPhotorealisticPrompt(
       "a couple at pottery wheel recreating Ghost scene, man sitting behind woman with his hands gently over hers shaping wet terracotta clay, both facing camera with intimate tender smiles, clay-covered fingers intertwined on spinning vase, soft warm indoor lighting from nearby lamp, rustic pottery studio with shelves of finished ceramics in background",
-      "warm intimate golden lamp light with soft romantic atmosphere"
+      "warm intimate golden lamp light with soft romantic atmosphere",
     ),
     storyTemplate: createStoryTemplate(
       "share a moment of artistic connection",
@@ -134,11 +135,11 @@ export const MOVIE_LEGENDS_SCENARIOS: Omit<Scenario, 'outputType' | 'category'>[
     title: "Upside-Down Kiss",
     description: "Hero in the rain",
     icon: "🕷️",
-    imageUrl:
-      "https://images.unsplash.com/photo-1511285560929-80b456fea0bc?w=800",
+    imageUrl: "https://images.unsplash.com/photo-1511285560929-80b456fea0bc?w=800",
+    inputType: "dual",
     aiPrompt: createPhotorealisticPrompt(
       "a couple recreating iconic Spider-Man upside-down kiss in rainy alley, man hanging inverted from fire escape with mask pulled up to nose, woman reaching up to kiss him, both with loving expressions from unique angles, heavy rain pouring down in dark city alley with neon signs reflecting on wet pavement in background",
-      "dramatic nighttime rain lighting with neon reflections and cinematic atmosphere"
+      "dramatic nighttime rain lighting with neon reflections and cinematic atmosphere",
     ),
     storyTemplate: createStoryTemplate(
       "reveal their secret hero love",
@@ -151,9 +152,10 @@ export const MOVIE_LEGENDS_SCENARIOS: Omit<Scenario, 'outputType' | 'category'>[
     description: "That legendary lift",
     icon: "🕺",
     imageUrl: "https://images.unsplash.com/photo-1506905925346-21bda4d32df4?w=800",
+    inputType: "dual",
     aiPrompt: createPhotorealisticPrompt(
       "a couple recreating iconic Dirty Dancing lift, man with strong arms holding woman high above his head, woman with gracefully arched back and arms spread wide in triumph, both facing camera with ecstatic joyful smiles, 1980s resort ballroom with cheering audience and string lights and stage in background",
-      "warm spotlight with 80s golden glow and crowd excitement"
+      "warm spotlight with 80s golden glow and crowd excitement",
     ),
     storyTemplate: createStoryTemplate(
       "have the time of their lives",
@@ -165,11 +167,11 @@ export const MOVIE_LEGENDS_SCENARIOS: Omit<Scenario, 'outputType' | 'category'>[
     title: "Modern Fairytale",
     description: "Rescue on the fire escape",
     icon: "🏢",
-    imageUrl:
-      "https://images.unsplash.com/photo-1540324155974-7523202daa3f?w=800",
+    imageUrl: "https://images.unsplash.com/photo-1540324155974-7523202daa3f?w=800",
+    inputType: "dual",
     aiPrompt: createPhotorealisticPrompt(
       "a couple recreating Pretty Woman fire escape scene, man climbing rusty iron ladder with red rose in mouth and charming grin, woman in silk robe leaning over balcony railing looking down with amazed ecstatic smile, both facing camera, urban LA sunset with palm trees and city buildings in background",
-      "warm golden sunset backlighting with romantic urban glow"
+      "warm golden sunset backlighting with romantic urban glow",
     ),
     storyTemplate: createStoryTemplate(
       "write their own modern fairytale",
@@ -181,11 +183,11 @@ export const MOVIE_LEGENDS_SCENARIOS: Omit<Scenario, 'outputType' | 'category'>[
     title: "The Meadow",
     description: "A thousand years",
     icon: "🌲",
-    imageUrl:
-      "https://images.unsplash.com/photo-1464822759023-fed622ff2c3b?w=800",
+    imageUrl: "https://images.unsplash.com/photo-1464822759023-fed622ff2c3b?w=800",
+    inputType: "dual",
     aiPrompt: createPhotorealisticPrompt(
       "a couple lying in lush meadow of purple and yellow wildflowers, heads together hair fanned out, both facing camera with intense devoted smiles, man in casual henley woman in simple cotton dress, golden sunlight filtering through ancient pine forest creating god rays in background",
-      "soft dreamy golden hour light with ethereal forest atmosphere"
+      "soft dreamy golden hour light with ethereal forest atmosphere",
     ),
     storyTemplate: createStoryTemplate(
       "promise a lifetime of devotion",
@@ -197,11 +199,11 @@ export const MOVIE_LEGENDS_SCENARIOS: Omit<Scenario, 'outputType' | 'category'>[
     title: "Dawn of Love",
     description: "A walk at sunrise",
     icon: "🚶‍♂️",
-    imageUrl:
-      "https://images.unsplash.com/photo-1500382017468-9049fed747ef?w=800",
+    imageUrl: "https://images.unsplash.com/photo-1500382017468-9049fed747ef?w=800",
+    inputType: "dual",
     aiPrompt: createPhotorealisticPrompt(
       "a couple walking toward each other through misty English field at dawn recreating Pride and Prejudice, man in long dark greatcoat with windswept hair, woman in flowing white nightdress with wool shawl, meeting as golden sun rises behind them casting long shadows through morning mist",
-      "magical golden dawn light with atmospheric mist and romantic haze"
+      "magical golden dawn light with atmospheric mist and romantic haze",
     ),
     storyTemplate: createStoryTemplate(
       "find their way to each other through the mist",
@@ -213,11 +215,11 @@ export const MOVIE_LEGENDS_SCENARIOS: Omit<Scenario, 'outputType' | 'category'>[
     title: "Casablanca Farewell",
     description: "Here's looking at you, kid",
     icon: "🛫",
-    imageUrl:
-      "https://images.unsplash.com/photo-1485686531765-ba63b07845a7?w=800",
+    imageUrl: "https://images.unsplash.com/photo-1485686531765-ba63b07845a7?w=800",
+    inputType: "dual",
     aiPrompt: createPhotorealisticPrompt(
       "a couple recreating Casablanca airport farewell at night, both facing camera with dramatic emotional expressions of bittersweet goodbye, man in tan trench coat and fedora, woman in elegant suit and wide-brimmed hat with tears in eyes, 1940s propeller plane and swirling fog on tarmac in background, high-contrast black and white film style",
-      "dramatic noir lighting with fog and high-contrast black and white aesthetic"
+      "dramatic noir lighting with fog and high-contrast black and white aesthetic",
     ),
     storyTemplate: createStoryTemplate(
       "share one last unforgettable look",