@umituz/react-native-ai-generation-content 1.73.0 → 1.74.1

package/package.json

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

package/src/domain/constants/queue-status.constants.ts

@@ -1,6 +1,6 @@
 /**
  * Queue Status Constants
- * FAL queue job status values - shared across all polling hooks
+ * Generic queue job status values - shared across all polling hooks
  */
 
 export const QUEUE_STATUS = {

package/src/domains/creations/domain/entities/Creation.ts

@@ -35,7 +35,7 @@ export interface Creation {
   // Extended fields for job-based creations
   readonly status?: CreationStatus;
   readonly output?: CreationOutput;
-  // Background job tracking - FAL queue requestId and model
+  // Background job tracking
   readonly requestId?: string;
   readonly model?: string;
   // Soft delete - if set, the creation is considered deleted
@@ -61,7 +61,7 @@ export interface CreationDocument {
   readonly createdAt: FirebaseTimestamp | Date;
   readonly completedAt?: FirebaseTimestamp | Date | null;
   readonly deletedAt?: FirebaseTimestamp | Date | null;
-  // Background job tracking - FAL queue requestId and model
+  // Background job tracking
   readonly requestId?: string;
   readonly model?: string;
 }

package/src/domains/creations/presentation/hooks/useProcessingJobsPoller.ts

@@ -1,8 +1,8 @@
 /**
  * useProcessingJobsPoller Hook
- * Polls FAL queue status for "processing" creations and updates Firestore when complete
+ * Polls queue status for "processing" creations and updates Firestore when complete
  * Enables true background generation - works even after wizard is dismissed
- * Uses provider registry internally - no need to pass FAL functions
+ * Uses provider registry internally - no need to pass provider functions
  */
 
 import { useEffect, useRef, useMemo } from "react";

package/src/domains/generation/index.ts

@@ -78,7 +78,7 @@ export {
 } from "./wizard";
 
 // Flow Infrastructure
-export { createFlowStore, useFlow, resetFlowStore } from "./infrastructure/flow";
+export { createFlowStore, useFlow } from "./infrastructure/flow";
 export type { FlowStoreType } from "./infrastructure/flow";
 
 // Flow config types from domain

package/src/domains/generation/infrastructure/flow/index.ts

@@ -4,4 +4,4 @@
  */
 
 export { createFlowStore, type FlowStoreType } from "./useFlowStore";
-export { useFlow, resetFlowStore } from "./useFlow";
+export { useFlow } from "./useFlow";

package/src/domains/generation/infrastructure/flow/useFlow.ts

@@ -105,9 +105,3 @@ export const useFlow = (config: UseFlowConfig): UseFlowReturn => {
 };
 
 declare const __DEV__: boolean;
-
-export const resetFlowStore = () => {
-  if (typeof __DEV__ !== "undefined" && __DEV__) {
-    console.warn('resetFlowStore is deprecated. Each component now maintains its own flow store instance.');
-  }
-};

package/src/domains/generation/wizard/domain/types/credit-calculation.types.ts

@@ -0,0 +1,23 @@
+/**
+ * Credit Calculation Types
+ * Domain types for credit calculation system
+ * Single Source of Truth for credit-related type definitions
+ */
+
+/**
+ * Credit Calculator Function Type
+ * Apps provide implementation, package calls it
+ *
+ * @param params - Calculation parameters
+ * @param params.duration - Video duration in seconds
+ * @param params.resolution - Video resolution ("480p" | "720p")
+ * @param params.outputType - Output type ("video" | "image")
+ * @param params.hasImageInput - Whether input includes image (image-to-video)
+ * @returns Calculated credit cost
+ */
+export type CreditCalculatorFn = (params: {
+  duration?: number;
+  resolution?: string;
+  outputType: "video" | "image";
+  hasImageInput: boolean;
+}) => number;

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

@@ -32,6 +32,22 @@ export {
   quickBuildWizard,
 } from "./infrastructure/builders/dynamic-step-builder";
 
+// Infrastructure - Generic Credit Calculator (USD to Credits conversion ONLY)
+export {
+  convertCostToCredits,
+  getCreditConfig,
+} from "./infrastructure/utils/credit-calculator";
+
+// Infrastructure - Data Validators
+export {
+  validateDuration,
+  validateResolution,
+} from "./infrastructure/utils/wizard-data-validators";
+export type { ValidationResult } from "./infrastructure/utils/wizard-data-validators";
+
+// Credit Calculator Function Type (for apps to implement)
+export type { CreditCalculatorFn } from "./domain/types/credit-calculation.types";
+
 // Presentation - Hooks
 export { usePhotoUploadState } from "./presentation/hooks/usePhotoUploadState";
 export type {

package/src/domains/generation/wizard/infrastructure/utils/creation-persistence.types.ts

@@ -13,6 +13,9 @@ export interface ProcessingCreationData {
   readonly prompt: string;
   readonly requestId?: string;
   readonly model?: string;
+  readonly duration?: number;
+  readonly resolution?: string;
+  readonly creditCost?: number;
 }
 
 export interface CompletedCreationData {

package/src/domains/generation/wizard/infrastructure/utils/creation-save-operations.ts

@@ -33,6 +33,9 @@ export async function saveAsProcessing(
     metadata: {
       scenarioId: data.scenarioId,
       scenarioTitle: data.scenarioTitle,
+      ...(data.duration && { duration: data.duration }),
+      ...(data.resolution && { resolution: data.resolution }),
+      ...(data.creditCost && { creditCost: data.creditCost }),
     },
   });
 

package/src/domains/generation/wizard/infrastructure/utils/creation-update-operations.ts

@@ -52,7 +52,7 @@ export async function updateToFailed(
 }
 
 /**
- * Update creation with FAL queue requestId and model after job submission
+ * Update creation with queue requestId after job submission
  */
 export async function updateRequestId(
   repository: ICreationsRepository,

package/src/domains/generation/wizard/infrastructure/utils/credit-calculator.ts

@@ -0,0 +1,48 @@
+/**
+ * Generic Credit Calculator
+ * Package is GENERIC - knows nothing about specific pricing
+ * All costs are determined by the APP
+ *
+ * This package ONLY converts USD cost to credits using app-provided formula
+ */
+
+/**
+ * Credit pricing configuration
+ * These are the ONLY constants the package knows about
+ */
+const CREDIT_CONFIG = {
+  CUSTOMER_PRICE_PER_CREDIT: 0.10,
+  MARKUP_MULTIPLIER: 1.67,
+} as const;
+
+/**
+ * Convert USD cost to credits
+ * This is the ONLY calculation the package does
+ * Formula: credits = ceil((cost * markup) / credit_price)
+ *
+ * @param costInUSD - The cost in USD (provided by app)
+ * @throws {Error} If cost is invalid
+ */
+export function convertCostToCredits(costInUSD: number): number {
+  if (!costInUSD || typeof costInUSD !== "number" || costInUSD < 0) {
+    throw new Error(
+      `[convertCostToCredits] Invalid cost: ${costInUSD}. Must be a non-negative number.`
+    );
+  }
+
+  const { CUSTOMER_PRICE_PER_CREDIT, MARKUP_MULTIPLIER } = CREDIT_CONFIG;
+  const credits = (costInUSD * MARKUP_MULTIPLIER) / CUSTOMER_PRICE_PER_CREDIT;
+
+  return Math.ceil(credits);
+}
+
+/**
+ * Get credit configuration
+ * Exposes config for app to use if needed
+ */
+export function getCreditConfig() {
+  return {
+    customerPricePerCredit: CREDIT_CONFIG.CUSTOMER_PRICE_PER_CREDIT,
+    markupMultiplier: CREDIT_CONFIG.MARKUP_MULTIPLIER,
+  };
+}

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

@@ -0,0 +1,44 @@
+/**
+ * Credit Value Extractors
+ * Pure utility functions to extract and normalize values from customData
+ * Single Responsibility: Data transformation for credit calculation
+ */
+
+/**
+ * Extract duration value from customData
+ * Handles both number and string formats ("4s", "5s", "6s")
+ *
+ * @param value - Raw value from customData
+ * @returns Normalized duration number, or undefined if invalid
+ */
+export function extractDuration(value: unknown): number | undefined {
+  // Already a number
+  if (typeof value === "number" && value > 0) {
+    return value;
+  }
+
+  // String format: "4s", "5s", "6s" → parse to number
+  if (typeof value === "string") {
+    const match = value.match(/^(\d+)s?$/);
+    if (match) {
+      const parsed = parseInt(match[1], 10);
+      return parsed > 0 ? parsed : undefined;
+    }
+  }
+
+  return undefined;
+}
+
+/**
+ * Extract resolution value from customData
+ * Validates against allowed values
+ *
+ * @param value - Raw value from customData
+ * @returns Normalized resolution string, or undefined if invalid
+ */
+export function extractResolution(value: unknown): "480p" | "720p" | undefined {
+  if (value === "480p" || value === "720p") {
+    return value;
+  }
+  return undefined;
+}

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

@@ -0,0 +1,61 @@
+/**
+ * Wizard Data Validators
+ * Centralized validation utilities for wizard generation data
+ * DRY: Used across AIGenerateScreen, TextToVideoWizardScreen, ImageToVideoWizardScreen
+ */
+
+export interface ValidationResult<T> {
+  value?: T;
+  error?: string;
+}
+
+/**
+ * Validate and extract duration from wizard data
+ *
+ * @param data - Wizard generation data
+ * @returns Validation result with value or error
+ */
+export function validateDuration(
+  data: Record<string, unknown>,
+): ValidationResult<number> {
+  const duration = data.duration as number;
+
+  if (!duration || typeof duration !== "number" || duration <= 0) {
+    return {
+      error: `Invalid duration: ${duration}. Must be a positive number.`,
+    };
+  }
+
+  return { value: duration };
+}
+
+/**
+ * Validate and extract resolution from wizard data
+ *
+ * @param data - Wizard generation data
+ * @returns Validation result with resolution or error
+ */
+export function validateResolution(
+  data: Record<string, unknown>,
+): ValidationResult<"480p" | "720p"> {
+  const resolutionValue = data.resolution as string;
+
+  if (!resolutionValue || typeof resolutionValue !== "string") {
+    return {
+      error: `Invalid resolution: ${resolutionValue}. Must be a string.`,
+    };
+  }
+
+  // Map resolution - EXACT MATCH ONLY
+  if (resolutionValue === "480p") {
+    return { value: "480p" };
+  }
+
+  if (resolutionValue === "720p") {
+    return { value: "720p" };
+  }
+
+  return {
+    error: `Invalid resolution value: "${resolutionValue}". Must be "480p" or "720p".`,
+  };
+}

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

@@ -10,6 +10,7 @@ import type { WizardFeatureConfig } from "../../domain/entities/wizard-feature.t
 import type { WizardScenarioData } from "../hooks/useWizardGeneration";
 import type { AlertMessages } from "../../../../../presentation/hooks/generation/types";
 import type { GenerationErrorInfo } from "./WizardFlow.types";
+import type { CreditCalculatorFn } from "../../domain/types/credit-calculation.types";
 import { validateScenario } from "../utilities/validateScenario";
 import { WizardFlowContent } from "./WizardFlowContent";
 import {
@@ -27,6 +28,8 @@ export interface GenericWizardFlowProps {
   readonly alertMessages: AlertMessages;
   /** Credit cost for this generation - REQUIRED, determined by the app */
   readonly creditCost: number;
+  /** Calculator function provided by APP - package calls this to get dynamic cost */
+  readonly calculateCredits?: CreditCalculatorFn;
   readonly skipResultStep?: boolean;
   readonly onStepChange?: (stepId: string, stepType: StepType | string) => void;
   readonly onGenerationStart?: (
@@ -53,6 +56,7 @@ export const GenericWizardFlow: React.FC<GenericWizardFlowProps> = (props) => {
     userId,
     alertMessages,
     creditCost,
+    calculateCredits,
     skipResultStep = false,
     onStepChange,
     onGenerationStart,
@@ -109,6 +113,7 @@ export const GenericWizardFlow: React.FC<GenericWizardFlowProps> = (props) => {
       userId={userId}
       alertMessages={alertMessages}
       creditCost={creditCost}
+      calculateCredits={calculateCredits}
       skipResultStep={skipResultStep}
       onStepChange={onStepChange}
       onGenerationStart={onGenerationStart}

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

@@ -19,6 +19,7 @@ export interface WizardContinueButtonProps {
   readonly onPress: () => void;
   readonly label: string;
   readonly icon?: IconName;
+  readonly creditCost?: number;
 }
 
 export function WizardContinueButton({
@@ -26,6 +27,7 @@ export function WizardContinueButton({
   onPress,
   label,
   icon = "chevron-forward-outline",
+  creditCost,
 }: WizardContinueButtonProps) {
   const tokens = useAppDesignTokens();
   const { isTabletDevice, minTouchTarget } = useResponsive();
@@ -34,6 +36,12 @@ export function WizardContinueButton({
   const buttonMinHeight = Math.max(minTouchTarget, 44);
   const buttonMinWidth = isTabletDevice ? 120 : 100;
 
+  // If creditCost is provided, append it to the label
+  const displayLabel =
+    creditCost !== undefined && creditCost > 0
+      ? `${label} (${creditCost} credits)`
+      : label;
+
   return (
     <TouchableOpacity
       onPress={onPress}
@@ -60,7 +68,7 @@ export function WizardContinueButton({
           { color: canContinue ? tokens.colors.onPrimary : tokens.colors.textSecondary },
         ]}
       >
-        {label}
+        {displayLabel}
       </AtomicText>
       <AtomicIcon
         name={icon}

package/src/domains/generation/wizard/presentation/components/WizardFlow.types.ts

@@ -3,6 +3,7 @@
  */
 
 import type { AlertMessages } from "../../../../../presentation/hooks/generation/types";
+import type { CreditCalculatorFn } from "../../domain/types/credit-calculation.types";
 
 /**
  * Error information with refund eligibility
@@ -23,6 +24,8 @@ export interface BaseWizardFlowProps {
   readonly userId?: string;
   /** Credit cost for this generation - REQUIRED, determined by the app */
   readonly creditCost: number;
+  /** Calculator function provided by APP - package calls this to get dynamic cost */
+  readonly calculateCredits?: CreditCalculatorFn;
   /** Called when network is unavailable and generation is blocked */
   readonly onNetworkError?: () => void;
   /** Called when generation completes */

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

@@ -16,8 +16,10 @@ import type { Creation } from "../../../../creations/domain/entities/Creation";
 import { createCreationsRepository } from "../../../../creations";
 import { useResultActions } from "../../../../result-preview/presentation/hooks/useResultActions";
 import { useWizardFlowHandlers } from "../hooks/useWizardFlowHandlers";
+import { extractDuration, extractResolution } from "../../infrastructure/utils/credit-value-extractors";
 import { WizardStepRenderer } from "./WizardStepRenderer";
 import { StarRatingPicker } from "../../../../result-preview/presentation/components/StarRatingPicker";
+import type { CreditCalculatorFn } from "../../domain/types/credit-calculation.types";
 
 export interface WizardFlowContentProps {
   readonly featureConfig: WizardFeatureConfig;
@@ -27,6 +29,8 @@ export interface WizardFlowContentProps {
   readonly alertMessages: AlertMessages;
   /** Credit cost for this generation - REQUIRED, determined by the app */
   readonly creditCost: number;
+  /** Calculator function provided by APP - package calls this to get dynamic cost */
+  readonly calculateCredits?: CreditCalculatorFn;
   readonly skipResultStep?: boolean;
   readonly onStepChange?: (stepId: string, stepType: StepType | string) => void;
   readonly onGenerationStart?: (
@@ -51,7 +55,8 @@ export const WizardFlowContent: React.FC<WizardFlowContentProps> = (props) => {
     validatedScenario,
     userId,
     alertMessages,
-    creditCost,
+    creditCost, // Still needed for initial feature gate in parent
+    calculateCredits, // Calculator function from APP
     skipResultStep = false,
     onStepChange,
     onGenerationStart,
@@ -103,6 +108,40 @@ export const WizardFlowContent: React.FC<WizardFlowContentProps> = (props) => {
     videoUrl: resultVideoUrl,
   });
 
+  /**
+   * Calculate credit cost - CENTRALIZED CALCULATION
+   * React Best Practice: Calculate derived state during render (not in useEffect)
+   *
+   * Flow:
+   * 1. Extract values from customData using utility functions
+   * 2. Call app's calculator function with normalized values
+   * 3. Fallback to static creditCost if calculation incomplete
+   */
+  const calculatedCreditCost = useMemo(() => {
+    // If no calculator provided, use static creditCost
+    if (!calculateCredits) {
+      return creditCost;
+    }
+
+    const outputType = validatedScenario.outputType as "video" | "image";
+    const hasImageInput = validatedScenario.inputType !== "text";
+
+    // Extract and normalize values from customData
+    const duration = extractDuration(customData.duration);
+    const resolution = extractResolution(customData.resolution);
+
+    // Call app's calculator
+    const result = calculateCredits({
+      duration,
+      resolution,
+      outputType,
+      hasImageInput,
+    });
+
+    // If result is 0 (incomplete selections), use static initial cost
+    return result > 0 ? result : creditCost;
+  }, [customData, validatedScenario.outputType, validatedScenario.inputType, calculateCredits, creditCost]);
+
   const handlers = useWizardFlowHandlers({
     currentStepIndex,
     flowSteps,
@@ -131,7 +170,7 @@ export const WizardFlowContent: React.FC<WizardFlowContentProps> = (props) => {
     userId,
     isGeneratingStep: currentStep?.type === StepType.GENERATING,
     alertMessages,
-    creditCost,
+    creditCost: calculatedCreditCost,
     onSuccess: handlers.handleGenerationComplete,
     onError: handlers.handleGenerationError,
     onCreditsExhausted,
@@ -155,6 +194,7 @@ export const WizardFlowContent: React.FC<WizardFlowContentProps> = (props) => {
         isSaving={isSaving}
         isSharing={isSharing}
         showRating={Boolean(userId) && !hasRated}
+        creditCost={calculatedCreditCost}
         onNext={handlers.handleNextStep}
         onBack={handlers.handleBack}
         onPhotoContinue={handlers.handlePhotoContinue}

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

@@ -25,6 +25,7 @@ export const WizardStepRenderer: React.FC<WizardStepRendererProps> = ({
   isSaving,
   isSharing,
   showRating = true,
+  creditCost,
   onNext,
   onBack,
   onPhotoContinue,
@@ -89,13 +90,13 @@ export const WizardStepRenderer: React.FC<WizardStepRendererProps> = ({
     }
 
     case StepType.PARTNER_UPLOAD:
-      return renderPhotoUploadStep({ key: step.id, step, customData, onBack, onPhotoContinue, t });
+      return renderPhotoUploadStep({ key: step.id, step, customData, onBack, onPhotoContinue, t, creditCost });
 
     case StepType.TEXT_INPUT:
       return renderTextInputStep({ key: step.id, step, customData, onBack, onPhotoContinue, t, alertMessages });
 
     case StepType.FEATURE_SELECTION:
-      return renderSelectionStep({ key: step.id, step, customData, onBack, onPhotoContinue, t });
+      return renderSelectionStep({ key: step.id, step, customData, onBack, onPhotoContinue, t, creditCost });
 
     default:
       if (typeof __DEV__ !== "undefined" && __DEV__) {

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

@@ -12,6 +12,8 @@ export interface WizardStepRendererProps {
   readonly isSaving: boolean;
   readonly isSharing: boolean;
   readonly showRating?: boolean;
+  /** Calculated credit cost - passed from parent */
+  readonly creditCost?: number;
   readonly onNext: () => void;
   readonly onBack: () => void;
   readonly onPhotoContinue: (stepId: string, image: UploadedImage) => void;

package/src/domains/generation/wizard/presentation/components/step-renderers/renderPhotoUploadStep.tsx

@@ -15,6 +15,7 @@ export interface PhotoUploadStepProps {
   readonly onBack: () => void;
   readonly onPhotoContinue: (stepId: string, image: UploadedImage) => void;
   readonly t: (key: string) => string;
+  readonly creditCost?: number;
 }
 
 export function renderPhotoUploadStep({
@@ -23,6 +24,7 @@ export function renderPhotoUploadStep({
   onBack,
   onPhotoContinue,
   t,
+  creditCost,
 }: PhotoUploadStepProps): React.ReactElement {
   const wizardConfig = getWizardStepConfig(step.config);
   const titleKey = wizardConfig?.titleKey ?? `wizard.steps.${step.id}.title`;
@@ -46,6 +48,7 @@ export function renderPhotoUploadStep({
         uploadFailed: t("common.errors.upload_failed"),
       }}
       t={t}
+      creditCost={creditCost}
       onBack={onBack}
       onContinue={(image) => onPhotoContinue(step.id, image)}
       existingImage={existingPhoto}

package/src/domains/generation/wizard/presentation/components/step-renderers/renderSelectionStep.tsx

@@ -15,6 +15,8 @@ export interface SelectionStepProps {
   readonly onBack: () => void;
   readonly onPhotoContinue: (stepId: string, image: UploadedImage) => void;
   readonly t: (key: string) => string;
+  /** Calculated credit cost from parent */
+  readonly creditCost?: number;
 }
 
 declare const __DEV__: boolean;
@@ -25,6 +27,7 @@ export function renderSelectionStep({
   onBack,
   onPhotoContinue,
   t,
+  creditCost,
 }: SelectionStepProps): React.ReactElement {
   const selectionConfig = getSelectionConfig(step.config);
   const titleKey = selectionConfig?.titleKey ?? `wizard.steps.${step.id}.title`;
@@ -76,6 +79,7 @@ export function renderSelectionStep({
         layout: selectionConfig?.layout,
       }}
       initialValue={initialValue}
+      creditCost={creditCost}
       onBack={onBack}
       onContinue={(value) => {
         onPhotoContinue(step.id, { uri: String(value), selection: value, previewUrl: "" } as UploadedImage);

package/src/domains/generation/wizard/presentation/components/step-renderers/renderTextInputStep.tsx

@@ -48,9 +48,9 @@ export function renderTextInputStep({
         contentNotAllowedMessage: alertMessages?.policyViolation || "This type of content is not supported. Please try a different prompt.",
       }}
       config={{
-        minLength: textConfig?.minLength ?? 3,
-        maxLength: textConfig?.maxLength ?? 1000,
-        multiline: textConfig?.multiline ?? true,
+        minLength: textConfig?.minLength !== undefined ? textConfig.minLength : 3,
+        maxLength: textConfig?.maxLength !== undefined ? textConfig.maxLength : 1000,
+        multiline: textConfig?.multiline !== undefined ? textConfig.multiline : true,
       }}
       initialValue={existingText}
       onBack={onBack}

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

@@ -11,6 +11,7 @@ export interface UseVideoQueueGenerationProps {
   readonly scenario: WizardScenarioData;
   readonly persistence: CreationPersistence;
   readonly strategy: WizardStrategy;
+  readonly creditCost?: number;
   readonly onSuccess?: (result: unknown) => void;
   readonly onError?: (error: string) => void;
 }

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

@@ -2,7 +2,7 @@
  * useGenerationPhase Hook
  * Derives generation phase from elapsed time for UX feedback
  *
- * Best Practice: Since actual API progress is unknown (FAL only returns IN_QUEUE/IN_PROGRESS),
+ * Best Practice: Since actual API progress is unknown (queue systems only return IN_QUEUE/IN_PROGRESS),
  * we use time-based phases to provide meaningful feedback to users.
  */
 

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

@@ -20,6 +20,7 @@ export interface UsePhotoBlockingGenerationProps {
   readonly scenario: WizardScenarioData;
   readonly persistence: CreationPersistence;
   readonly strategy: WizardStrategy;
+  readonly creditCost?: number;
   readonly alertMessages: AlertMessages;
   readonly onSuccess?: (result: unknown) => void;
   readonly onError?: (error: string) => void;
@@ -38,6 +39,7 @@ export function usePhotoBlockingGeneration(
     userId,
     scenario,
     persistence,
+    creditCost,
     strategy,
     alertMessages,
     onSuccess,
@@ -105,10 +107,18 @@ export function usePhotoBlockingGeneration(
       // Save to Firestore first
       if (userId && prompt) {
         try {
+          // Extract generation parameters from input (for image generation, no duration/resolution)
+          const inputData = input as Record<string, unknown>;
+          const duration = typeof inputData?.duration === "number" ? inputData.duration : undefined;
+          const resolution = typeof inputData?.resolution === "string" ? inputData.resolution : undefined;
+
           const creationId = await persistence.saveAsProcessing(userId, {
             scenarioId: scenario.id,
             scenarioTitle: scenario.title || scenario.id,
             prompt,
+            duration,
+            resolution,
+            creditCost,
           });
           creationIdRef.current = creationId;
 

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

@@ -14,7 +14,7 @@ import type {
 } from "./use-video-queue-generation.types";
 
 export function useVideoQueueGeneration(props: UseVideoQueueGenerationProps): UseVideoQueueGenerationReturn {
-  const { userId, scenario, persistence, strategy, onSuccess, onError } = props;
+  const { userId, scenario, persistence, strategy, creditCost, onSuccess, onError } = props;
 
   const creationIdRef = useRef<string | null>(null);
   const requestIdRef = useRef<string | null>(null);
@@ -153,10 +153,18 @@ export function useVideoQueueGeneration(props: UseVideoQueueGenerationProps): Us
       let creationId: string | null = null;
       if (userId && prompt) {
         try {
+          // Extract generation parameters from input
+          const inputData = input as Record<string, unknown>;
+          const duration = typeof inputData?.duration === "number" ? inputData.duration : undefined;
+          const resolution = typeof inputData?.resolution === "string" ? inputData.resolution : undefined;
+
           creationId = await persistence.saveAsProcessing(userId, {
             scenarioId: scenario.id,
             scenarioTitle: scenario.title || scenario.id,
             prompt,
+            duration,
+            resolution,
+            creditCost,
           });
           creationIdRef.current = creationId;
         } catch (error) {

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

@@ -51,6 +51,7 @@ export const useWizardGeneration = (props: UseWizardGenerationProps): UseWizardG
     scenario,
     persistence,
     strategy,
+    creditCost,
     onSuccess,
     onError,
   });
@@ -60,6 +61,7 @@ export const useWizardGeneration = (props: UseWizardGenerationProps): UseWizardG
     scenario,
     persistence,
     strategy,
+    creditCost,
     alertMessages,
     onSuccess,
     onError,

package/src/domains/generation/wizard/presentation/screens/GenericPhotoUploadScreen.tsx

@@ -46,6 +46,7 @@ export interface PhotoUploadScreenProps {
   readonly translations: PhotoUploadScreenTranslations;
   readonly t: (key: string) => string;
   readonly config?: PhotoUploadScreenConfig;
+  readonly creditCost?: number;
   readonly onBack: () => void;
   readonly onContinue: (image: UploadedImage) => void;
   readonly existingImage?: UploadedImage | null;
@@ -58,6 +59,7 @@ export const GenericPhotoUploadScreen: React.FC<PhotoUploadScreenProps> = ({
   translations,
   t,
   config = DEFAULT_CONFIG,
+  creditCost,
   onBack,
   onContinue,
   existingImage,
@@ -114,6 +116,7 @@ export const GenericPhotoUploadScreen: React.FC<PhotoUploadScreenProps> = ({
             canContinue={canContinue && !!image}
             onPress={handleContinuePress}
             label={translations.continue}
+            creditCost={creditCost}
           />
         }
       />

package/src/domains/generation/wizard/presentation/screens/SelectionScreen.tsx

@@ -31,6 +31,7 @@ export const SelectionScreen: React.FC<SelectionScreenProps> = ({
   options,
   config,
   initialValue,
+  creditCost,
   onBack,
   onContinue,
 }) => {
@@ -128,7 +129,7 @@ export const SelectionScreen: React.FC<SelectionScreenProps> = ({
         title=""
         onBackPress={onBack}
         rightElement={
-          <WizardContinueButton canContinue={canContinue} onPress={handleContinue} label={translations.continueButton} icon="arrow-forward" />
+          <WizardContinueButton canContinue={canContinue} onPress={handleContinue} label={translations.continueButton} icon="arrow-forward" creditCost={creditCost} />
         }
       />
       <ScreenLayout scrollable={true} edges={["left", "right"]} hideScrollIndicator={true} contentContainerStyle={styles.scrollContent}>

package/src/domains/generation/wizard/presentation/screens/SelectionScreen.types.ts

@@ -28,6 +28,8 @@ export interface SelectionScreenProps {
   readonly options: readonly SelectionOption[];
   readonly config?: SelectionScreenConfig;
   readonly initialValue?: string | string[];
+  /** Calculated credit cost - passed from parent */
+  readonly creditCost?: number;
   readonly onBack: () => void;
   readonly onContinue: (selectedValue: string | string[]) => void;
 }

package/src/domains/generation/wizard/presentation/screens/TextInputScreen.tsx

@@ -40,8 +40,27 @@ export const TextInputScreen: React.FC<TextInputScreenProps> = ({
   const alert = useAlert();
   const [text, setText] = useState(initialValue);
 
-  const minLength = config?.minLength ?? 3;
-  const maxLength = config?.maxLength ?? 1000;
+  // Validate config - REQUIRED, NO DEFAULTS
+  if (!config) {
+    throw new Error("[TextInputScreen] Config is required but was not provided.");
+  }
+  if (typeof config.minLength !== "number" || config.minLength < 0) {
+    throw new Error(
+      `[TextInputScreen] Invalid minLength: ${config.minLength}. Must be a non-negative number.`
+    );
+  }
+  if (typeof config.maxLength !== "number" || config.maxLength <= 0) {
+    throw new Error(
+      `[TextInputScreen] Invalid maxLength: ${config.maxLength}. Must be a positive number.`
+    );
+  }
+  if (config.minLength > config.maxLength) {
+    throw new Error(
+      `[TextInputScreen] Invalid config: minLength (${config.minLength}) > maxLength (${config.maxLength}).`
+    );
+  }
+
+  const { minLength, maxLength } = config;
   const canContinue = text.trim().length >= minLength;
 
   const handleContinue = useCallback(async () => {

package/src/domains/image-to-video/presentation/screens/ImageToVideoWizardFlow.tsx

@@ -24,6 +24,7 @@ export const ImageToVideoWizardFlow: React.FC<ImageToVideoWizardFlowProps> = (pr
     model,
     userId,
     creditCost,
+    calculateCredits,
     onNetworkError,
     onGenerationComplete,
     onGenerationError,
@@ -70,6 +71,7 @@ export const ImageToVideoWizardFlow: React.FC<ImageToVideoWizardFlowProps> = (pr
         userId={userId}
         alertMessages={alertMessages ?? defaultAlerts}
         creditCost={creditCost}
+        calculateCredits={calculateCredits}
         skipResultStep={true}
         onGenerationStart={handleGenerationStart}
         onGenerationComplete={handleGenerationComplete}

package/src/domains/scenarios/README.md

@@ -38,7 +38,7 @@ export const APP_SCENARIOS: ScenarioData[] = [
     prompt: 'A powerful warrior in fantasy armor, epic lighting...',
     inputType: 'single',
     outputType: 'image',
-    model: 'fal-ai/flux/dev',
+    model: 'your-provider/text-to-image',
   },
   // ... more scenarios
 ];
@@ -121,7 +121,7 @@ const VIDEO_SCENARIOS: ScenarioData[] = [
     category: ScenarioCategory.SOLO_CINEMATIC,
     inputType: 'single',
     outputType: 'video',
-    model: 'fal-ai/kling-video/v1.5/pro/image-to-video',
+    model: 'your-provider/image-to-video',
     // ... data
   }
 ];
@@ -135,7 +135,7 @@ const SOLO_SCENARIOS: ScenarioData[] = [
     category: ScenarioCategory.SOLO_FANTASY,
     inputType: 'single',
     outputType: 'image',
-    model: 'fal-ai/flux/dev',
+    model: 'your-provider/text-to-image',
     // ... data
   }
 ];

package/src/domains/text-to-image/presentation/screens/TextToImageWizardFlow.tsx

@@ -23,6 +23,7 @@ export const TextToImageWizardFlow: React.FC<TextToImageWizardFlowProps> = (prop
     model,
     userId,
     creditCost,
+    calculateCredits,
     onNetworkError,
     onGenerationComplete,
     onGenerationError,
@@ -71,6 +72,7 @@ export const TextToImageWizardFlow: React.FC<TextToImageWizardFlowProps> = (prop
         userId={userId}
         alertMessages={alertMessages}
         creditCost={creditCost}
+        calculateCredits={calculateCredits}
         skipResultStep={true}
         onGenerationStart={handleGenerationStart}
         onGenerationComplete={handleGenerationComplete}

package/src/domains/text-to-video/presentation/screens/TextToVideoWizardFlow.tsx

@@ -24,6 +24,7 @@ export const TextToVideoWizardFlow: React.FC<TextToVideoWizardFlowProps> = (prop
     model,
     userId,
     creditCost,
+    calculateCredits,
     onNetworkError,
     onGenerationComplete,
     onGenerationError,
@@ -70,6 +71,7 @@ export const TextToVideoWizardFlow: React.FC<TextToVideoWizardFlowProps> = (prop
         userId={userId}
         alertMessages={alertMessages ?? defaultAlerts}
         creditCost={creditCost}
+        calculateCredits={calculateCredits}
         skipResultStep={true}
         onGenerationStart={handleGenerationStart}
         onGenerationComplete={handleGenerationComplete}

package/src/index.ts

@@ -31,3 +31,12 @@ export {
   IMAGE_TO_VIDEO_WIZARD_CONFIG,
 } from "./domains/generation/wizard";
 export type { WizardScenarioData } from "./domains/generation/wizard";
+
+// Wizard Validators and Credit Utilities
+export {
+  validateDuration,
+  validateResolution,
+  convertCostToCredits,
+  getCreditConfig,
+} from "./domains/generation/wizard";
+export type { ValidationResult, CreditCalculatorFn } from "./domains/generation/wizard";

package/src/infrastructure/services/multi-image-generation.executor.ts

@@ -1,7 +1,6 @@
 /**
  * Multi-Image Generation Executor
- * Handles image generation with multiple input images (e.g., baby prediction)
- * Sends image_urls array as required by FAL AI nano-banana/edit model
+ * Handles image generation with multiple input images
  */
 
 import { validateProvider } from "../utils/provider-validator.util";
@@ -43,7 +42,6 @@ export interface MultiImageGenerationResult {
 
 /**
  * Execute image generation with multiple input images
- * Sends image_urls array as required by FAL AI API
  */
 export async function executeMultiImageGeneration(
   input: MultiImageGenerationInput,

package/src/infrastructure/utils/error-classification.ts

@@ -50,7 +50,7 @@ export function classifyError(error: unknown): AIErrorInfo {
     });
   }
 
-  // 422 = Content Policy Violation (Fal AI and other providers)
+  // 422 = Content Policy Violation
   if (statusCode === 422 || matchesPatterns(message, CONTENT_POLICY_PATTERNS)) {
     return logClassification({
       type: AIErrorType.CONTENT_POLICY,

package/src/infrastructure/utils/message-extractor.ts

@@ -38,8 +38,8 @@ export function getErrorTranslationKey(error: unknown): string | null {
 }
 
 /**
- * Extract error message from FAL API and other error formats
- * Supports: Error instances, FAL API errors, generic objects
+ * Extract error message from API responses
+ * Supports: Error instances, API errors, generic objects
  * Returns translation key if available, otherwise original message
  */
 export function extractErrorMessage(
@@ -63,10 +63,10 @@ export function extractErrorMessage(
   } else if (typeof error === "object" && error !== null) {
     const errObj = error as Record<string, unknown>;
 
-    // FAL API error format: {detail: [{msg, type, loc}]}
+    // API error format: {detail: [{msg, type, loc}]}
     if (Array.isArray(errObj.detail) && errObj.detail[0]?.msg) {
       const detailType = errObj.detail[0]?.type;
-      // Check for content policy in FAL API response
+      // Check for content policy in API response
       if (detailType === "content_policy_violation") {
         return `error.generation.${GenerationErrorType.CONTENT_POLICY}`;
       }

package/src/infrastructure/utils/url-extractor/extraction-rules.ts

@@ -16,15 +16,15 @@ export interface ExtractionRule {
 
 /**
  * Image extraction rules - checked in order, first success wins
- * Supports: FAL.ai wrapper, birefnet, rembg, flux, and direct formats
+ * Supports various response wrapper formats and direct formats
  */
 export const IMAGE_EXTRACTION_RULES: readonly ExtractionRule[] = [
-  // FAL.ai data wrapper formats
+  // Data wrapper formats
   { path: ["data", "image"], description: "data.image (string)" },
   { path: ["data", "imageUrl"], description: "data.imageUrl" },
   { path: ["data", "output"], description: "data.output" },
-  { path: ["data", "image", "url"], description: "data.image.url (birefnet/rembg)" },
-  { path: ["data", "images", "0", "url"], description: "data.images[0].url (flux)" },
+  { path: ["data", "image", "url"], description: "data.image.url" },
+  { path: ["data", "images", "0", "url"], description: "data.images[0].url" },
   // Direct formats (no wrapper)
   { path: ["image"], description: "image (string)" },
   { path: ["imageUrl"], description: "imageUrl" },
@@ -35,10 +35,10 @@ export const IMAGE_EXTRACTION_RULES: readonly ExtractionRule[] = [
 
 /**
  * Video extraction rules - checked in order, first success wins
- * Supports: FAL.ai wrapper, direct formats, nested objects, arrays
+ * Supports various response wrapper formats and direct formats
  */
 export const VIDEO_EXTRACTION_RULES: readonly ExtractionRule[] = [
-  // FAL.ai data wrapper formats
+  // Data wrapper formats
   { path: ["data", "video"], description: "data.video (string)" },
   { path: ["data", "videoUrl"], description: "data.videoUrl" },
   { path: ["data", "video_url"], description: "data.video_url" },

package/src/infrastructure/utils/url-extractor/image-result-extractor.ts

@@ -14,7 +14,6 @@ export type ImageResultExtractor = (result: unknown) => string | undefined;
 /**
  * Extract image URL from AI generation result
  * Uses Chain of Responsibility pattern with declarative rules
- * Supports: FAL.ai wrapper, birefnet, rembg, flux, and direct formats
  */
 export const extractImageResult: ImageResultExtractor = (result) => {
   return executeRules(result, IMAGE_EXTRACTION_RULES, "ImageExtractor");

package/src/infrastructure/utils/url-extractor/video-result-extractor.ts

@@ -14,7 +14,6 @@ export type VideoResultExtractor = (result: unknown) => string | undefined;
 /**
  * Extract video URL from AI generation result
  * Uses Chain of Responsibility pattern with declarative rules
- * Supports: FAL.ai wrapper, direct formats, nested objects, arrays
  */
 export const extractVideoResult: VideoResultExtractor = (result) => {
   return executeRules(result, VIDEO_EXTRACTION_RULES, "VideoExtractor");

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

@@ -1,7 +1,6 @@
 /**
  * useDualImageGeneration Hook
  * Generic hook for dual-image AI generation workflows
- * Sends image_urls array as required by FAL AI multi-image models
  */
 
 import { useState, useCallback, useMemo } from "react";