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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-ai-generation-content",
-  "version": "1.72.37",
+  "version": "1.73.0",
   "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/presentation/components/GenericWizardFlow.tsx

@@ -9,6 +9,7 @@ import type { StepType } from "../../../../../domain/entities/flow-config.types"
 import type { WizardFeatureConfig } from "../../domain/entities/wizard-feature.types";
 import type { WizardScenarioData } from "../hooks/useWizardGeneration";
 import type { AlertMessages } from "../../../../../presentation/hooks/generation/types";
+import type { GenerationErrorInfo } from "./WizardFlow.types";
 import { validateScenario } from "../utilities/validateScenario";
 import { WizardFlowContent } from "./WizardFlowContent";
 import {
@@ -33,7 +34,7 @@ export interface GenericWizardFlowProps {
     proceedToGenerating: () => void,
   ) => void;
   readonly onGenerationComplete?: (result: unknown) => void;
-  readonly onGenerationError?: (error: string) => void;
+  readonly onGenerationError?: (error: string, errorInfo?: GenerationErrorInfo) => void;
   readonly onCreditsExhausted?: () => void;
   readonly onBack?: () => void;
   readonly onTryAgain?: () => void;

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

@@ -4,6 +4,18 @@
 
 import type { AlertMessages } from "../../../../../presentation/hooks/generation/types";
 
+/**
+ * Error information with refund eligibility
+ */
+export interface GenerationErrorInfo {
+  /** Error message */
+  message: string;
+  /** Whether credits should be refunded for this error */
+  shouldRefund: boolean;
+  /** Human-readable error type for logging */
+  errorType?: string;
+}
+
 export interface BaseWizardFlowProps {
   /** Model ID for generation */
   readonly model: string;
@@ -15,8 +27,8 @@ export interface BaseWizardFlowProps {
   readonly onNetworkError?: () => void;
   /** Called when generation completes */
   readonly onGenerationComplete?: () => void;
-  /** Called on generation error */
-  readonly onGenerationError?: (error: string) => void;
+  /** Called on generation error with refund eligibility info */
+  readonly onGenerationError?: (error: string, errorInfo?: GenerationErrorInfo) => void;
   /** Called when back is pressed on first step */
   readonly onBack: () => void;
   /** Translation function */

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

@@ -4,6 +4,8 @@ import { StepType, type StepDefinition } from "../../../../../domain/entities/fl
 import type { UploadedImage } from "../../../../../presentation/hooks/generation/useAIGenerateState";
 import type { Creation } from "../../../../creations/domain/entities/Creation";
 import { isCreation } from "./typeGuards";
+import { classifyError } from "../../../../../infrastructure/utils/error-classification";
+import type { GenerationErrorInfo } from "../components/WizardFlow.types";
 
 export interface UseWizardFlowHandlersProps {
   readonly currentStepIndex: number;
@@ -23,7 +25,7 @@ export interface UseWizardFlowHandlersProps {
   readonly setShowRatingPicker: (show: boolean) => void;
   readonly onGenerationStart?: (data: Record<string, unknown>, proceed: () => void) => void;
   readonly onGenerationComplete?: (result: unknown) => void;
-  readonly onGenerationError?: (error: string) => void;
+  readonly onGenerationError?: (error: string, errorInfo?: GenerationErrorInfo) => void;
   readonly onBack?: () => void;
 }
 
@@ -66,8 +68,17 @@ export function useWizardFlowHandlers(props: UseWizardFlowHandlersProps) {
     (errorMessage: string) => {
       const safeErrorMessage = errorMessage?.trim() || "error.generation.unknown";
       const displayMessage = safeErrorMessage.startsWith("error.") ? t(safeErrorMessage) : safeErrorMessage;
+
+      // Classify error to determine refund eligibility
+      const errorClassification = classifyError(errorMessage);
+      const errorInfo: GenerationErrorInfo = {
+        message: safeErrorMessage,
+        shouldRefund: errorClassification.retryable ?? false,
+        errorType: errorClassification.type,
+      };
+
       alert.show(AlertType.ERROR, AlertMode.MODAL, t("common.error"), displayMessage);
-      onGenerationError?.(safeErrorMessage);
+      onGenerationError?.(safeErrorMessage, errorInfo);
       onBack?.();
     },
     [alert, t, onGenerationError, onBack],

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

@@ -3,6 +3,7 @@
  */
 
 import type { AlertMessages } from "../../../../presentation/hooks/generation/types";
+import type { GenerationErrorInfo } from "../../../generation/wizard/presentation/components/WizardFlow.types";
 
 export interface TextToImageWizardFlowProps {
   readonly model: string;
@@ -14,7 +15,7 @@ export interface TextToImageWizardFlowProps {
   readonly onShowAuthModal: (callback: () => void) => void;
   readonly onShowPaywall: () => void;
   readonly onGenerationComplete?: () => void;
-  readonly onGenerationError?: (error: string) => void;
+  readonly onGenerationError?: (error: string, errorInfo?: GenerationErrorInfo) => void;
   readonly onBack: () => void;
   readonly t: (key: string) => string;
   readonly alertMessages?: AlertMessages;

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

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

package/src/infrastructure/utils/error-patterns.constants.ts

@@ -34,6 +34,8 @@ export const CONTENT_POLICY_PATTERNS = [
   "content blocked",
   "blocked by",
   "flagged by a content checker",
+  " 422",
+  "422 ",
 ] as const;
 
 export const VALIDATION_ERROR_PATTERNS = [