@umituz/react-native-ai-generation-content 1.84.13 → 1.84.15

package/package.json

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

package/src/domains/access-control/hooks/useAIFeatureGate.ts

@@ -5,6 +5,10 @@
  * Uses `hasFirebaseUser` for auth check — anonymous users (autoAnonymousSignIn)
  * pass the gate and go straight to credit/subscription checks.
  * Auth modal is only shown if there is NO Firebase user at all.
+ *
+ * Paywall presentation:
+ * - Default: uses `openPaywall()` from `usePaywallVisibility` (React-based PaywallContainer)
+ * - Custom: accepts `onShowPaywall` option for native paywalls (e.g. RevenueCat `presentPaywall()`)
  */
 
 import { useCallback, useMemo } from "react";
@@ -38,7 +42,7 @@ const handlePromiseResult = (
 };
 
 export function useAIFeatureGate(options: AIFeatureGateOptions): AIFeatureGateReturn {
-  const { creditCost, onNetworkError, onSuccess, onError } = options;
+  const { creditCost, onNetworkError, onSuccess, onError, onShowPaywall: customShowPaywall } = options;
 
   const { isOffline } = useOffline();
   const { hasFirebaseUser } = useAuth();
@@ -55,7 +59,7 @@ export function useAIFeatureGate(options: AIFeatureGateOptions): AIFeatureGateRe
     hasSubscription: isPremium,
     creditBalance,
     requiredCredits: creditCost,
-    onShowPaywall: () => openPaywall(),
+    onShowPaywall: customShowPaywall ?? (() => openPaywall()),
     isCreditsLoaded,
   });
 

package/src/domains/access-control/types/access-control.types.ts

@@ -23,6 +23,15 @@ export interface AIFeatureGateOptions {
    * Callback fired when feature access fails or execution errors
    */
   onError?: (error: Error) => void;
+
+  /**
+   * Custom paywall presentation.
+   * When provided, this is called instead of the default `openPaywall()` from
+   * `usePaywallVisibility`. Use this for apps that present the native
+   * RevenueCat paywall (e.g. `presentPaywall()`) instead of rendering a
+   * React-based PaywallContainer.
+   */
+  onShowPaywall?: () => void;
 }
 
 export interface AIFeatureGateReturn {

package/src/domains/creations/presentation/components/GalleryResultPreview.tsx

@@ -56,7 +56,7 @@ export function GalleryResultPreview({
     onSaveError: () => alert.show(AlertType.ERROR, AlertMode.TOAST, t("common.error"), t("result.saveError")),
   });
 
-  const hasRating = selectedCreation.rating !== undefined && selectedCreation.rating !== null;
+  const hasRating = selectedCreation.rating !== undefined;
 
   return (
     <>

package/src/domains/creations/presentation/screens/creations-gallery.types.ts

@@ -22,7 +22,7 @@ export interface CreationsGalleryScreenProps {
   /** Function to get dynamic title from creation metadata */
   readonly getCreationTitle?: (creation: { type: string; metadata?: Record<string, unknown> }) => string;
   /** Custom handler when a creation card is pressed. When provided, overrides the built-in preview. */
-  readonly onCreationPress?: (creation: { id: string; uri: string; type: string; originalUri?: string; output?: { imageUrl?: string; videoUrl?: string }; metadata?: Record<string, unknown> }) => void;
+  readonly onCreationPress?: (creation: { id: string; uri: string; type: string; originalUri?: string; output?: { imageUrl?: string; videoUrl?: string; audioUrl?: string }; metadata?: Record<string, unknown> }) => void;
   /** Called when the user taps the Edit button in the creation detail view. Receives the image URL. Only shown for image creations. */
   readonly onEdit?: (imageUrl: string) => void;
   /** Called when the user taps the Edit button in the creation detail view. Receives the video URL. Only shown for video creations. */

package/src/domains/generation/wizard/infrastructure/strategies/audio-generation.executor.ts

@@ -63,14 +63,11 @@ export async function executeAudioGeneration(
       modelInput.cfg_weight = input.cfgWeight;
     }
 
-    let lastStatus = "";
     addGenerationLog(sid, TAG, "Calling provider.subscribe()...");
     const result = await provider.subscribe(model, modelInput, {
       timeoutMs: AUDIO_GENERATION_TIMEOUT_MS,
       onQueueUpdate: (status) => {
-        if (status.status !== lastStatus) {
-          lastStatus = status.status;
-        }
+        addGenerationLog(sid, TAG, `Queue: ${status.status}`);
       },
     });
 

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

@@ -12,10 +12,10 @@ import { executeAudioGeneration } from "./audio-generation.executor";
 // Input Builder
 // ============================================================================
 
-export async function buildAudioInput(
+export function buildAudioInput(
   wizardData: Record<string, unknown>,
   scenario: WizardScenarioData,
-): Promise<WizardAudioInput | null> {
+): WizardAudioInput {
   // Extract text from wizard data (TEXT_INPUT step stores as "text" or "prompt")
   const text =
     typeof wizardData.text === "string"
@@ -79,6 +79,9 @@ export function createAudioStrategy(options: CreateAudioStrategyOptions): Wizard
 
   return {
     execute: async (input: unknown) => {
+      if (!input || typeof input !== "object") {
+        throw new Error("Invalid input: expected WizardAudioInput object");
+      }
       const audioInput = input as WizardAudioInput;
       const result = await executeAudioGeneration(audioInput, model, undefined, providerId);
 

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

@@ -80,14 +80,11 @@ export async function executeImageGeneration(
       modelInput.image_urls = imageUrls;
     }
 
-    let lastStatus = "";
     addGenerationLog(sid, TAG, 'Calling provider.subscribe()...');
     const result = await provider.subscribe(model, modelInput, {
       timeoutMs: GENERATION_TIMEOUT_MS,
       onQueueUpdate: (status) => {
-        if (status.status !== lastStatus) {
-          lastStatus = status.status;
-        }
+        addGenerationLog(sid, TAG, `Queue: ${status.status}`);
       },
     });
 

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

@@ -88,6 +88,9 @@ export function createImageStrategy(options: CreateImageStrategyOptions): Wizard
 
   return {
     execute: async (input: unknown) => {
+      if (!input || typeof input !== "object") {
+        throw new Error("Invalid input: expected WizardImageInput object");
+      }
       const imageInput = input as WizardImageInput;
       const result = await executeImageGeneration(imageInput, model, undefined, providerId);
 

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

@@ -32,9 +32,7 @@ async function extractAudioAsBase64(wizardData: Record<string, unknown>): Promis
     }
     return base64;
   } catch (error) {
-    if (typeof __DEV__ !== "undefined" && __DEV__) {
-      console.warn("[VideoStrategy] Failed to read audio file:", error);
-    }
+    console.warn("[VideoStrategy] Failed to read audio file:", error);
     return undefined;
   }
 }

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

@@ -56,6 +56,14 @@ export function validatePhotoCount(
       break;
     case "text":
       break;
+    default: {
+      // Exhaustive check: log unexpected input types in development
+      const _exhaustive: never = effectiveInputType;
+      if (typeof __DEV__ !== "undefined" && __DEV__) {
+        console.warn(`[validatePhotoCount] Unknown inputType: ${_exhaustive}`);
+      }
+      break;
+    }
   }
 
   return { isValid: true };

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

@@ -52,7 +52,11 @@ export async function buildWizardInput(
   scenario: WizardScenarioData,
 ): Promise<unknown> {
   if (scenario.outputType === "image") {
-    return buildImageInput(wizardData, scenario);
+    const input = await buildImageInput(wizardData, scenario);
+    if (!input) {
+      throw new Error("Failed to build image input");
+    }
+    return input;
   }
 
   if (scenario.outputType === "audio") {
@@ -60,5 +64,9 @@ export async function buildWizardInput(
   }
 
   // Default to video input for video outputType or undefined
-  return buildVideoInput(wizardData, scenario);
+  const input = await buildVideoInput(wizardData, scenario);
+  if (!input) {
+    throw new Error("Failed to build video input");
+  }
+  return input;
 }

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

@@ -12,7 +12,7 @@ export interface QueueSubmissionResult {
 
 export interface WizardStrategy {
   /** Execute the generation - returns result with URLs (blocking) */
-  execute: (input: unknown) => Promise<{ imageUrl?: string; videoUrl?: string; audioUrl?: string }>;
+  execute: (input: unknown) => Promise<{ imageUrl?: string; videoUrl?: string; audioUrl?: string; logSessionId?: string }>;
   /** Submit to queue for background processing - returns immediately with requestId */
   submitToQueue?: (input: unknown) => Promise<QueueSubmissionResult>;
 }

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

@@ -58,15 +58,17 @@ export async function updateToCompleted(
   };
 
   const completedAt = new Date();
-  const durationMs =
+  const rawDuration =
     data.generationStartedAt !== undefined
       ? completedAt.getTime() - data.generationStartedAt
       : undefined;
+  const durationMs = rawDuration !== undefined && rawDuration >= 0 ? rawDuration : undefined;
+  const hasOutput = Object.keys(output).length > 0;
 
   await repository.update(userId, creationId, {
     uri: data.uri,
     status: "completed" as const,
-    output,
+    ...(hasOutput && { output }),
     completedAt,
     ...(durationMs !== undefined && { durationMs }),
   } as Partial<Creation>);

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

@@ -61,7 +61,7 @@ export const WizardStepRenderer: React.FC<WizardStepRendererProps> = ({
       const media = extractMediaUrl(generationResult);
       if (!media) return null;
       const isVideo = media.isVideo || getMediaTypeFromUrl(media.url) === "video";
-      const handleTryAgain = onTryAgain ?? onBack;
+      const handleTryAgain = onTryAgain ?? onBack ?? (() => {});
       return (
         <ResultPreviewScreen
           imageUrl={isVideo ? undefined : media.url}

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

@@ -11,7 +11,8 @@ function isRecord(value: unknown): value is Record<string, unknown> {
 }
 
 function isWizardStepConfig(value: unknown): value is WizardStepConfig {
-  return isRecord(value);
+  if (!isRecord(value)) return false;
+  return typeof value.id === "string" && typeof value.type === "string";
 }
 
 function isUploadedImage(value: unknown): value is UploadedImage {

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

@@ -26,7 +26,7 @@ export function renderAudioPickerStep({
 }: AudioPickerStepProps): React.ReactElement {
   const audioConfig = getAudioPickerConfig(step.config);
   const titleKey = audioConfig?.titleKey ?? `wizard.steps.${step.id}.title`;
-  const subtitleKey = audioConfig?.subtitleKey ?? `wizard.steps.${step.id}.subtitle`;
+  const subtitleKey = audioConfig?.subtitleKey;
   const isOptional = !(step.required ?? true);
 
   return (

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

@@ -45,6 +45,7 @@ export function usePhotoBlockingGeneration(
     alertMessages,
     onSuccess,
     onError,
+    onCreditsExhausted,
   } = props;
 
   const creationIdRef = useRef<string | null>(null);
@@ -53,11 +54,12 @@ export function usePhotoBlockingGeneration(
     async (result: unknown) => {
       const typedResult = result as { imageUrl?: string; videoUrl?: string; audioUrl?: string; logSessionId?: string };
       const creationId = creationIdRef.current;
+      const resultUri = typedResult.imageUrl || typedResult.videoUrl || typedResult.audioUrl;
 
-      if (creationId && userId) {
+      if (creationId && userId && resultUri) {
         try {
           await persistence.updateToCompleted(userId, creationId, {
-            uri: typedResult.imageUrl || typedResult.videoUrl || typedResult.audioUrl || "",
+            uri: resultUri,
             imageUrl: typedResult.imageUrl,
             videoUrl: typedResult.videoUrl,
             audioUrl: typedResult.audioUrl,
@@ -74,16 +76,21 @@ export function usePhotoBlockingGeneration(
 
       // Deduct credits after successful generation
       if (deductCredits && creditCost) {
-        await deductCredits(creditCost).catch((err) => {
+        try {
+          const deducted = await deductCredits(creditCost);
+          if (!deducted) {
+            onCreditsExhausted?.();
+          }
+        } catch (err) {
           if (typeof __DEV__ !== "undefined" && __DEV__) {
             console.error("[PhotoBlockingGeneration] deductCredits error:", err);
           }
-        });
+        }
       }
 
       onSuccess?.(result);
     },
-    [userId, persistence, deductCredits, creditCost, onSuccess],
+    [userId, persistence, deductCredits, creditCost, onSuccess, onCreditsExhausted],
   );
 
   const handleError = useCallback(
@@ -134,7 +141,7 @@ export function usePhotoBlockingGeneration(
             resolution,
             creditCost,
             aspectRatio,
-            provider: "fal",
+            provider: scenario.providerId ?? "fal",
             outputType: scenario.outputType,
           });
           creationIdRef.current = result.creationId;

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

@@ -91,7 +91,7 @@ export const AudioPickerScreen: React.FC<AudioPickerScreenProps> = ({
   }, [onContinue]);
 
   const formatFileSize = useCallback((bytes?: number) => {
-    if (!bytes) return "";
+    if (bytes === undefined || bytes === null) return "";
     if (bytes < 1024) return `${bytes} B`;
     if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
     return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
@@ -101,7 +101,7 @@ export const AudioPickerScreen: React.FC<AudioPickerScreenProps> = ({
   const styles = useMemo(() => createStyles(tokens), [tokens]);
 
   return (
-    <View style={{ flex: 1, backgroundColor: tokens.colors.backgroundPrimary }}>
+    <View style={[styles.root, { backgroundColor: tokens.colors.backgroundPrimary }]}>
       <NavigationHeader
         title=""
         onBackPress={onBack}
@@ -183,6 +183,9 @@ export const AudioPickerScreen: React.FC<AudioPickerScreenProps> = ({
 
 const createStyles = (tokens: DesignTokens) =>
   StyleSheet.create({
+    root: {
+      flex: 1,
+    },
     scrollContent: {
       paddingHorizontal: tokens.spacing.lg,
       paddingBottom: 40,

package/src/domains/result-preview/presentation/components/ResultPreviewScreen.tsx

@@ -85,13 +85,13 @@ export const ResultPreviewScreen: React.FC<ResultPreviewScreenProps> = ({
             showRating={showRating}
           />
         </View>
-        {showRecent && (
+        {showRecent && recentCreations && translations.recentCreations && translations.viewAll && (
           <RecentCreationsSection
-            recentCreations={recentCreations!}
+            recentCreations={recentCreations}
             onViewAll={onViewAll}
             onCreationPress={onCreationPress}
-            title={translations.recentCreations!}
-            viewAllLabel={translations.viewAll!}
+            title={translations.recentCreations}
+            viewAllLabel={translations.viewAll}
           />
         )}
       </View>

package/src/domains/result-preview/presentation/types/result-components.types.ts

@@ -29,7 +29,7 @@ export interface ResultActionBarProps {
   /** Share callback */
   onShare: () => void;
   /** Try again callback */
-  onTryAgain: () => void;
+  onTryAgain?: () => void;
   /** Rate callback */
   onRate?: () => void;
   /** Save button text */

package/src/domains/result-preview/presentation/types/result-screen.types.ts

@@ -19,8 +19,8 @@ export interface ResultPreviewScreenProps {
   /** Action callbacks */
   onDownload: () => void;
   onShare: () => void;
-  onTryAgain: () => void;
-  onNavigateBack: () => void;
+  onTryAgain?: () => void;
+  onNavigateBack?: () => void;
   onRate?: () => void;
   /** Edit callback — opens photo editor for the result image */
   onEdit?: () => void;

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

@@ -4,7 +4,7 @@
  * Note: ScenarioId and ScenarioCategory should be defined in the app, not here
  */
 
-export type ScenarioOutputType = "image" | "video";
+export type ScenarioOutputType = "image" | "video" | "audio";
 
 export type ScenarioInputType = "single" | "dual" | "text";
 

package/src/infrastructure/providers/generation-services.provider.tsx

@@ -12,7 +12,7 @@ import React, {
 } from "react";
 
 export interface GenerationServicesValue {
-  /** Current authenticated user ID (null = not authenticated) */
+  /** Current authenticated user ID (undefined = not authenticated) */
   readonly userId: string | undefined;
   /** Deduct credits. Returns true if successful, false if insufficient. */
   readonly deductCredits: (cost: number) => Promise<boolean>;

package/src/infrastructure/utils/couple-input.util.ts

@@ -1,7 +1,11 @@
-import type { GenerationTarget } from "../../presentation/hooks/generation/useImageGenerationExecutor";
+/** Target for generation: which model on which provider */
+interface GenerationTargetLike {
+  readonly model: string;
+  readonly providerId: string;
+}
 
 interface CoupleInputResult {
-  readonly target: GenerationTarget;
+  readonly target: GenerationTargetLike;
   readonly imageUrls: string[];
 }
 
@@ -13,8 +17,8 @@ export function resolveCoupleInput(
   partner1PhotoUri: string,
   partner2PhotoUri: string | null,
   isCoupleMode: boolean,
-  singleTarget: GenerationTarget,
-  coupleTarget: GenerationTarget,
+  singleTarget: GenerationTargetLike,
+  coupleTarget: GenerationTargetLike,
 ): CoupleInputResult {
   if (isCoupleMode && partner2PhotoUri) {
     return {

package/src/infrastructure/utils/image-input-preprocessor.util.ts

@@ -25,6 +25,10 @@ const IMAGE_FIELDS = [
   "images",
   "reference_image",
   "source_image",
+  "target_image",
+  "driver_image_url",
+  "face_image",
+  "mask_image",
 ] as const;
 
 /**

package/src/infrastructure/utils/intensity.util.ts

@@ -1,6 +1,9 @@
 /**
  * Maps a 0-100 intensity slider value to AI model strength parameter.
  * Range: 0→0.30, 50→0.61, 100→0.92
+ * Input is clamped to [0, 100].
  */
-export const intensityToStrength = (intensity: number): number =>
-  0.3 + (intensity / 100) * 0.62;
+export const intensityToStrength = (intensity: number): number => {
+  const clamped = Math.max(0, Math.min(100, intensity));
+  return 0.3 + (clamped / 100) * 0.62;
+};

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

@@ -68,7 +68,7 @@ export function useAudioGenerationExecutor<P>(
 
   const execute = useCallback(
     async (params: P): Promise<string | null> => {
-      if (!userId) return null;
+      if (!userId || isLoading) return null;
 
       setError(null);
       setIsLoading(true);
@@ -136,6 +136,7 @@ export function useAudioGenerationExecutor<P>(
     },
     [
       userId,
+      isLoading,
       config,
       deductCredits,
       refundCredits,

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

@@ -74,7 +74,7 @@ export function useImageGenerationExecutor<P>(
 
   const execute = useCallback(
     async (params: P): Promise<string | null> => {
-      if (!userId) return null;
+      if (!userId || isLoading) return null;
 
       setError(null);
       setIsLoading(true);
@@ -142,6 +142,7 @@ export function useImageGenerationExecutor<P>(
     },
     [
       userId,
+      isLoading,
       config,
       deductCredits,
       refundCredits,