@umituz/react-native-ai-generation-content 1.17.148 → 1.17.150

package/package.json

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

package/src/features/ai-hug/presentation/components/AIHugFeature.tsx

@@ -29,6 +29,8 @@ export interface AIHugFeatureProps {
   onSaveVideo: (videoUrl: string) => Promise<void>;
   /** Custom video player renderer - required for video playback */
   renderVideoPlayer: (props: { videoUrl: string; size: number }) => React.ReactNode;
+  /** Called before processing starts. Return false to cancel. */
+  onBeforeProcess?: () => Promise<boolean>;
   /** Optional custom processing modal renderer */
   renderProcessingModal?: (props: {
     visible: boolean;
@@ -43,6 +45,7 @@ export const AIHugFeature: React.FC<AIHugFeatureProps> = ({
   onSelectTargetImage,
   onSaveVideo,
   renderVideoPlayer,
+  onBeforeProcess,
   renderProcessingModal,
 }) => {
   const tokens = useAppDesignTokens();
@@ -54,6 +57,7 @@ export const AIHugFeature: React.FC<AIHugFeatureProps> = ({
     onSelectSourceImage,
     onSelectTargetImage,
     onSaveVideo,
+    onBeforeProcess,
   });
 
   const handleProcess = useCallback(() => {

package/src/features/ai-hug/presentation/hooks/useAIHugFeature.ts

@@ -15,6 +15,7 @@ export interface UseAIHugFeatureProps {
   onSelectSourceImage: () => Promise<string | null>;
   onSelectTargetImage: () => Promise<string | null>;
   onSaveVideo: (videoUrl: string) => Promise<void>;
+  onBeforeProcess?: () => Promise<boolean>;
 }
 
 export interface UseAIHugFeatureReturn extends AIHugFeatureState {

package/src/features/ai-kiss/presentation/components/AIKissFeature.tsx

@@ -24,6 +24,8 @@ export interface AIKissFeatureProps {
   onSaveVideo: (videoUrl: string) => Promise<void>;
   /** Custom video player renderer - required for video playback */
   renderVideoPlayer: (props: { videoUrl: string; size: number }) => React.ReactNode;
+  /** Called before processing starts. Return false to cancel. */
+  onBeforeProcess?: () => Promise<boolean>;
   renderProcessingModal?: (props: {
     visible: boolean;
     progress: number;
@@ -37,6 +39,7 @@ export const AIKissFeature: React.FC<AIKissFeatureProps> = ({
   onSelectTargetImage,
   onSaveVideo,
   renderVideoPlayer,
+  onBeforeProcess,
   renderProcessingModal,
 }) => {
   const tokens = useAppDesignTokens();
@@ -48,6 +51,7 @@ export const AIKissFeature: React.FC<AIKissFeatureProps> = ({
     onSelectSourceImage,
     onSelectTargetImage,
     onSaveVideo,
+    onBeforeProcess,
   });
 
   const handleProcess = useCallback(() => {

package/src/features/ai-kiss/presentation/hooks/useAIKissFeature.ts

@@ -15,6 +15,7 @@ export interface UseAIKissFeatureProps {
   onSelectSourceImage: () => Promise<string | null>;
   onSelectTargetImage: () => Promise<string | null>;
   onSaveVideo: (videoUrl: string) => Promise<void>;
+  onBeforeProcess?: () => Promise<boolean>;
 }
 
 export interface UseAIKissFeatureReturn extends AIKissFeatureState {

package/src/features/anime-selfie/presentation/components/AnimeSelfieFeature.tsx

@@ -21,6 +21,8 @@ export interface AnimeSelfieFeatureProps {
   translations: AnimeSelfieTranslations;
   onSelectImage: () => Promise<string | null>;
   onSaveImage: (imageUrl: string) => Promise<void>;
+  /** Called before processing starts. Return false to cancel. */
+  onBeforeProcess?: () => Promise<boolean>;
   renderProcessingModal?: (props: {
     visible: boolean;
     progress: number;
@@ -32,6 +34,7 @@ export const AnimeSelfieFeature: React.FC<AnimeSelfieFeatureProps> = ({
   translations,
   onSelectImage,
   onSaveImage,
+  onBeforeProcess,
   renderProcessingModal,
 }) => {
   const tokens = useAppDesignTokens();
@@ -42,6 +45,7 @@ export const AnimeSelfieFeature: React.FC<AnimeSelfieFeatureProps> = ({
     config,
     onSelectImage,
     onSaveImage,
+    onBeforeProcess,
   });
 
   const photoTranslations = useMemo(

package/src/features/anime-selfie/presentation/hooks/useAnimeSelfieFeature.ts

@@ -15,6 +15,7 @@ export interface UseAnimeSelfieFeatureProps {
   config: AnimeSelfieFeatureConfig;
   onSelectImage: () => Promise<string | null>;
   onSaveImage: (imageUrl: string) => Promise<void>;
+  onBeforeProcess?: () => Promise<boolean>;
 }
 
 export interface UseAnimeSelfieFeatureReturn extends AnimeSelfieFeatureState {
@@ -35,7 +36,7 @@ const initialState: AnimeSelfieFeatureState = {
 export function useAnimeSelfieFeature(
   props: UseAnimeSelfieFeatureProps,
 ): UseAnimeSelfieFeatureReturn {
-  const { config, onSelectImage, onSaveImage } = props;
+  const { config, onSelectImage, onSaveImage, onBeforeProcess } = props;
   const [state, setState] = useState<AnimeSelfieFeatureState>(initialState);
 
   const selectImage = useCallback(async () => {
@@ -58,6 +59,11 @@ export function useAnimeSelfieFeature(
   const process = useCallback(async () => {
     if (!state.imageUri) return;
 
+    if (onBeforeProcess) {
+      const canProceed = await onBeforeProcess();
+      if (!canProceed) return;
+    }
+
     setState((prev) => ({
       ...prev,
       isProcessing: true,
@@ -93,7 +99,7 @@ export function useAnimeSelfieFeature(
       }));
       config.onError?.(errorMessage);
     }
-  }, [state.imageUri, config, handleProgress]);
+  }, [state.imageUri, config, handleProgress, onBeforeProcess]);
 
   const save = useCallback(async () => {
     if (!state.processedUrl) return;

package/src/features/face-swap/presentation/components/FaceSwapFeature.tsx

@@ -22,6 +22,8 @@ export interface FaceSwapFeatureProps {
   onSelectSourceImage: () => Promise<string | null>;
   onSelectTargetImage: () => Promise<string | null>;
   onSaveImage: (imageUrl: string) => Promise<void>;
+  /** Called before processing starts. Return false to cancel. */
+  onBeforeProcess?: () => Promise<boolean>;
   renderProcessingModal?: (props: {
     visible: boolean;
     progress: number;
@@ -34,6 +36,7 @@ export const FaceSwapFeature: React.FC<FaceSwapFeatureProps> = ({
   onSelectSourceImage,
   onSelectTargetImage,
   onSaveImage,
+  onBeforeProcess,
   renderProcessingModal,
 }) => {
   const tokens = useAppDesignTokens();
@@ -45,6 +48,7 @@ export const FaceSwapFeature: React.FC<FaceSwapFeatureProps> = ({
     onSelectSourceImage,
     onSelectTargetImage,
     onSaveImage,
+    onBeforeProcess,
   });
 
   const handleProcess = useCallback(() => {

package/src/features/face-swap/presentation/hooks/useFaceSwapFeature.ts

@@ -14,15 +14,16 @@ export interface UseFaceSwapFeatureProps {
   onSelectSourceImage: () => Promise<string | null>;
   onSelectTargetImage: () => Promise<string | null>;
   onSaveImage: (imageUrl: string) => Promise<void>;
+  onBeforeProcess?: () => Promise<boolean>;
 }
 
 export function useFaceSwapFeature(
   props: UseFaceSwapFeatureProps,
 ): BaseDualImageHookReturn {
-  const { config, onSelectSourceImage, onSelectTargetImage, onSaveImage } = props;
+  const { config, onSelectSourceImage, onSelectTargetImage, onSaveImage, onBeforeProcess } = props;
 
   return useDualImageFeature<FaceSwapFeatureConfig, FaceSwapResult>(
-    { config, onSelectSourceImage, onSelectTargetImage, onSaveImage },
+    { config, onSelectSourceImage, onSelectTargetImage, onSaveImage, onBeforeProcess },
     {
       buildInput: (sourceBase64, targetBase64, cfg) => ({
         imageBase64: sourceBase64,

package/src/features/hd-touch-up/presentation/components/HDTouchUpFeature.tsx

@@ -21,6 +21,8 @@ export interface HDTouchUpFeatureProps {
   translations: HDTouchUpTranslations;
   onSelectImage: () => Promise<string | null>;
   onSaveImage: (imageUrl: string) => Promise<void>;
+  /** Called before processing starts. Return false to cancel. */
+  onBeforeProcess?: () => Promise<boolean>;
   renderProcessingModal?: (props: {
     visible: boolean;
     progress: number;
@@ -32,6 +34,7 @@ export const HDTouchUpFeature: React.FC<HDTouchUpFeatureProps> = ({
   translations,
   onSelectImage,
   onSaveImage,
+  onBeforeProcess,
   renderProcessingModal,
 }) => {
   const tokens = useAppDesignTokens();
@@ -42,6 +45,7 @@ export const HDTouchUpFeature: React.FC<HDTouchUpFeatureProps> = ({
     config,
     onSelectImage,
     onSaveImage,
+    onBeforeProcess,
   });
 
   const photoTranslations = useMemo(

package/src/features/hd-touch-up/presentation/hooks/useHDTouchUpFeature.ts

@@ -15,6 +15,7 @@ export interface UseHDTouchUpFeatureProps {
   config: HDTouchUpFeatureConfig;
   onSelectImage: () => Promise<string | null>;
   onSaveImage: (imageUrl: string) => Promise<void>;
+  onBeforeProcess?: () => Promise<boolean>;
 }
 
 export interface UseHDTouchUpFeatureReturn extends HDTouchUpFeatureState {
@@ -35,7 +36,7 @@ const initialState: HDTouchUpFeatureState = {
 export function useHDTouchUpFeature(
   props: UseHDTouchUpFeatureProps,
 ): UseHDTouchUpFeatureReturn {
-  const { config, onSelectImage, onSaveImage } = props;
+  const { config, onSelectImage, onSaveImage, onBeforeProcess } = props;
   const [state, setState] = useState<HDTouchUpFeatureState>(initialState);
 
   const selectImage = useCallback(async () => {
@@ -58,6 +59,11 @@ export function useHDTouchUpFeature(
   const process = useCallback(async () => {
     if (!state.imageUri) return;
 
+    if (onBeforeProcess) {
+      const canProceed = await onBeforeProcess();
+      if (!canProceed) return;
+    }
+
     setState((prev) => ({
       ...prev,
       isProcessing: true,
@@ -93,7 +99,7 @@ export function useHDTouchUpFeature(
       }));
       config.onError?.(errorMessage);
     }
-  }, [state.imageUri, config, handleProgress]);
+  }, [state.imageUri, config, handleProgress, onBeforeProcess]);
 
   const save = useCallback(async () => {
     if (!state.processedUrl) return;

package/src/features/image-to-image/domain/types/base.types.ts

@@ -141,6 +141,8 @@ export interface BaseSingleImageHookProps<
   config: TConfig;
   onSelectImage: () => Promise<string | null>;
   onSaveImage: (imageUrl: string) => Promise<void>;
+  /** Called before processing starts. Return false to cancel. */
+  onBeforeProcess?: () => Promise<boolean>;
 }
 
 /**
@@ -153,6 +155,8 @@ export interface BaseDualImageHookProps<
   onSelectSourceImage: () => Promise<string | null>;
   onSelectTargetImage: () => Promise<string | null>;
   onSaveImage: (imageUrl: string) => Promise<void>;
+  /** Called before processing starts. Return false to cancel. */
+  onBeforeProcess?: () => Promise<boolean>;
 }
 
 /**

package/src/features/image-to-image/presentation/hooks/useDualImageFeature.ts

@@ -37,7 +37,7 @@ export function useDualImageFeature<
   props: BaseDualImageHookProps<TConfig>,
   options?: DualImageFeatureOptions<TConfig>,
 ): BaseDualImageHookReturn {
-  const { config, onSelectSourceImage, onSelectTargetImage, onSaveImage } = props;
+  const { config, onSelectSourceImage, onSelectTargetImage, onSaveImage, onBeforeProcess } = props;
   const [state, setState] = useState<BaseDualImageState>(INITIAL_STATE);
 
   const selectSourceImage = useCallback(async () => {
@@ -73,6 +73,12 @@ export function useDualImageFeature<
   const process = useCallback(async () => {
     if (!state.sourceImageUri || !state.targetImageUri) return;
 
+    // Check if processing is allowed (credit check, etc.)
+    if (onBeforeProcess) {
+      const canProceed = await onBeforeProcess();
+      if (!canProceed) return;
+    }
+
     setState((prev) => ({
       ...prev,
       isProcessing: true,
@@ -126,7 +132,7 @@ export function useDualImageFeature<
       }));
       config.onError?.(message);
     }
-  }, [state.sourceImageUri, state.targetImageUri, config, options, handleProgress]);
+  }, [state.sourceImageUri, state.targetImageUri, config, options, handleProgress, onBeforeProcess]);
 
   const save = useCallback(async () => {
     if (!state.processedUrl) return;

package/src/features/image-to-image/presentation/hooks/useImageWithPromptFeature.ts

@@ -32,6 +32,8 @@ export interface ImageWithPromptHookProps<
   config: TConfig;
   onSelectImage: () => Promise<string | null>;
   onSaveImage: (imageUrl: string) => Promise<void>;
+  /** Called before processing starts. Return false to cancel. */
+  onBeforeProcess?: () => Promise<boolean>;
 }
 
 export interface ImageWithPromptHookReturn extends BaseImageWithPromptState {
@@ -58,7 +60,7 @@ export function useImageWithPromptFeature<
   props: ImageWithPromptHookProps<TConfig>,
   options?: ImageWithPromptOptions,
 ): ImageWithPromptHookReturn {
-  const { config, onSelectImage, onSaveImage } = props;
+  const { config, onSelectImage, onSaveImage, onBeforeProcess } = props;
   const [state, setState] = useState<BaseImageWithPromptState>({
     ...INITIAL_STATE,
     prompt: config.defaultPrompt || "",
@@ -92,6 +94,12 @@ export function useImageWithPromptFeature<
   const process = useCallback(async () => {
     if (!state.imageUri) return;
 
+    // Check if processing is allowed (credit check, etc.)
+    if (onBeforeProcess) {
+      const canProceed = await onBeforeProcess();
+      if (!canProceed) return;
+    }
+
     if (options?.promptRequired && !state.prompt.trim()) {
       const error = "Prompt is required";
       setState((prev) => ({ ...prev, error }));
@@ -149,7 +157,7 @@ export function useImageWithPromptFeature<
       }));
       config.onError?.(message);
     }
-  }, [state.imageUri, state.prompt, config, options, handleProgress]);
+  }, [state.imageUri, state.prompt, config, options, handleProgress, onBeforeProcess]);
 
   const save = useCallback(async () => {
     if (!state.processedUrl) return;

package/src/features/image-to-image/presentation/hooks/useSingleImageFeature.ts

@@ -32,7 +32,7 @@ export function useSingleImageFeature<
   props: BaseSingleImageHookProps<TConfig>,
   options?: SingleImageFeatureOptions<TConfig>,
 ): BaseSingleImageHookReturn {
-  const { config, onSelectImage, onSaveImage } = props;
+  const { config, onSelectImage, onSaveImage, onBeforeProcess } = props;
   const [state, setState] = useState<BaseSingleImageState>(INITIAL_STATE);
 
   const selectImage = useCallback(async () => {
@@ -55,6 +55,12 @@ export function useSingleImageFeature<
   const process = useCallback(async () => {
     if (!state.imageUri) return;
 
+    // Check if processing is allowed (credit check, etc.)
+    if (onBeforeProcess) {
+      const canProceed = await onBeforeProcess();
+      if (!canProceed) return;
+    }
+
     setState((prev) => ({
       ...prev,
       isProcessing: true,
@@ -105,7 +111,7 @@ export function useSingleImageFeature<
       }));
       config.onError?.(message);
     }
-  }, [state.imageUri, config, options, handleProgress]);
+  }, [state.imageUri, config, options, handleProgress, onBeforeProcess]);
 
   const save = useCallback(async () => {
     if (!state.processedUrl) return;

package/src/features/photo-restoration/presentation/components/PhotoRestoreFeature.tsx

@@ -25,6 +25,8 @@ export interface PhotoRestoreFeatureProps {
   onSelectImage: () => Promise<string | null>;
   /** Save image callback */
   onSaveImage: (imageUrl: string) => Promise<void>;
+  /** Called before processing starts. Return false to cancel. */
+  onBeforeProcess?: () => Promise<boolean>;
   /** Optional custom processing modal renderer */
   renderProcessingModal?: (props: {
     visible: boolean;
@@ -37,6 +39,7 @@ export const PhotoRestoreFeature: React.FC<PhotoRestoreFeatureProps> = ({
   translations,
   onSelectImage,
   onSaveImage,
+  onBeforeProcess,
   renderProcessingModal,
 }) => {
   const tokens = useAppDesignTokens();
@@ -45,6 +48,7 @@ export const PhotoRestoreFeature: React.FC<PhotoRestoreFeatureProps> = ({
     config,
     onSelectImage,
     onSaveImage,
+    onBeforeProcess,
   });
 
   const photoTranslations = useMemo(

package/src/features/photo-restoration/presentation/hooks/usePhotoRestoreFeature.ts

@@ -15,6 +15,7 @@ export interface UsePhotoRestoreFeatureProps {
   config: PhotoRestoreFeatureConfig;
   onSelectImage: () => Promise<string | null>;
   onSaveImage: (imageUrl: string) => Promise<void>;
+  onBeforeProcess?: () => Promise<boolean>;
 }
 
 export interface UsePhotoRestoreFeatureReturn extends PhotoRestoreFeatureState {
@@ -35,7 +36,7 @@ const initialState: PhotoRestoreFeatureState = {
 export function usePhotoRestoreFeature(
   props: UsePhotoRestoreFeatureProps,
 ): UsePhotoRestoreFeatureReturn {
-  const { config, onSelectImage, onSaveImage } = props;
+  const { config, onSelectImage, onSaveImage, onBeforeProcess } = props;
   const [state, setState] = useState<PhotoRestoreFeatureState>(initialState);
 
   const selectImage = useCallback(async () => {
@@ -58,6 +59,11 @@ export function usePhotoRestoreFeature(
   const process = useCallback(async () => {
     if (!state.imageUri) return;
 
+    if (onBeforeProcess) {
+      const canProceed = await onBeforeProcess();
+      if (!canProceed) return;
+    }
+
     setState((prev) => ({
       ...prev,
       isProcessing: true,
@@ -93,7 +99,7 @@ export function usePhotoRestoreFeature(
       }));
       config.onError?.(errorMessage);
     }
-  }, [state.imageUri, config, handleProgress]);
+  }, [state.imageUri, config, handleProgress, onBeforeProcess]);
 
   const save = useCallback(async () => {
     if (!state.processedUrl) return;

package/src/features/remove-background/presentation/components/RemoveBackgroundFeature.tsx

@@ -21,6 +21,8 @@ export interface RemoveBackgroundFeatureProps {
   translations: RemoveBackgroundTranslations;
   onSelectImage: () => Promise<string | null>;
   onSaveImage: (imageUrl: string) => Promise<void>;
+  /** Called before processing starts. Return false to cancel. */
+  onBeforeProcess?: () => Promise<boolean>;
   renderProcessingModal?: (props: {
     visible: boolean;
     progress: number;
@@ -32,6 +34,7 @@ export const RemoveBackgroundFeature: React.FC<RemoveBackgroundFeatureProps> = (
   translations,
   onSelectImage,
   onSaveImage,
+  onBeforeProcess,
   renderProcessingModal,
 }) => {
   const tokens = useAppDesignTokens();
@@ -42,6 +45,7 @@ export const RemoveBackgroundFeature: React.FC<RemoveBackgroundFeatureProps> = (
     config,
     onSelectImage,
     onSaveImage,
+    onBeforeProcess,
   });
 
   const photoTranslations = useMemo(

package/src/features/remove-background/presentation/hooks/useRemoveBackgroundFeature.ts

@@ -16,15 +16,16 @@ export interface UseRemoveBackgroundFeatureProps {
   config: RemoveBackgroundFeatureConfig;
   onSelectImage: () => Promise<string | null>;
   onSaveImage: (imageUrl: string) => Promise<void>;
+  onBeforeProcess?: () => Promise<boolean>;
 }
 
 export function useRemoveBackgroundFeature(
   props: UseRemoveBackgroundFeatureProps,
 ): BaseSingleImageHookReturn {
-  const { config, onSelectImage, onSaveImage } = props;
+  const { config, onSelectImage, onSaveImage, onBeforeProcess } = props;
 
   return useSingleImageFeature<RemoveBackgroundFeatureConfig, RemoveBackgroundResult>(
-    { config, onSelectImage, onSaveImage },
+    { config, onSelectImage, onSaveImage, onBeforeProcess },
     {
       buildInput: (imageBase64, cfg) => ({
         imageBase64,

package/src/features/remove-object/presentation/components/RemoveObjectFeature.tsx

@@ -25,6 +25,8 @@ export interface RemoveObjectFeatureProps {
   translations: RemoveObjectTranslations;
   onSelectImage: () => Promise<string | null>;
   onSaveImage: (imageUrl: string) => Promise<void>;
+  /** Called before processing starts. Return false to cancel. */
+  onBeforeProcess?: () => Promise<boolean>;
   renderProcessingModal?: (props: {
     visible: boolean;
     progress: number;
@@ -36,6 +38,7 @@ export const RemoveObjectFeature: React.FC<RemoveObjectFeatureProps> = ({
   translations,
   onSelectImage,
   onSaveImage,
+  onBeforeProcess,
   renderProcessingModal,
 }) => {
   const tokens = useAppDesignTokens();
@@ -46,6 +49,7 @@ export const RemoveObjectFeature: React.FC<RemoveObjectFeatureProps> = ({
     config,
     onSelectImage,
     onSaveImage,
+    onBeforeProcess,
   });
 
   const photoTranslations = useMemo(

package/src/features/remove-object/presentation/hooks/useRemoveObjectFeature.ts

@@ -16,6 +16,7 @@ export interface UseRemoveObjectFeatureProps {
   onSelectImage: () => Promise<string | null>;
   onSelectMask?: () => Promise<string | null>;
   onSaveImage: (imageUrl: string) => Promise<void>;
+  onBeforeProcess?: () => Promise<boolean>;
 }
 
 export interface UseRemoveObjectFeatureReturn extends RemoveObjectFeatureState {
@@ -40,7 +41,7 @@ const initialState: RemoveObjectFeatureState = {
 export function useRemoveObjectFeature(
   props: UseRemoveObjectFeatureProps,
 ): UseRemoveObjectFeatureReturn {
-  const { config, onSelectImage, onSelectMask, onSaveImage } = props;
+  const { config, onSelectImage, onSelectMask, onSaveImage, onBeforeProcess } = props;
   const [state, setState] = useState<RemoveObjectFeatureState>(initialState);
 
   const selectImage = useCallback(async () => {
@@ -82,6 +83,11 @@ export function useRemoveObjectFeature(
   const process = useCallback(async () => {
     if (!state.imageUri) return;
 
+    if (onBeforeProcess) {
+      const canProceed = await onBeforeProcess();
+      if (!canProceed) return;
+    }
+
     setState((prev) => ({
       ...prev,
       isProcessing: true,
@@ -124,7 +130,7 @@ export function useRemoveObjectFeature(
       }));
       config.onError?.(errorMessage);
     }
-  }, [state.imageUri, state.maskUri, state.prompt, config, handleProgress]);
+  }, [state.imageUri, state.maskUri, state.prompt, config, handleProgress, onBeforeProcess]);
 
   const save = useCallback(async () => {
     if (!state.processedUrl) return;

package/src/features/replace-background/presentation/components/ReplaceBackgroundFeature.tsx

@@ -25,6 +25,8 @@ export interface ReplaceBackgroundFeatureProps {
   translations: ReplaceBackgroundTranslations;
   onSelectImage: () => Promise<string | null>;
   onSaveImage: (imageUrl: string) => Promise<void>;
+  /** Called before processing starts. Return false to cancel. */
+  onBeforeProcess?: () => Promise<boolean>;
   renderProcessingModal?: (props: {
     visible: boolean;
     progress: number;
@@ -36,6 +38,7 @@ export const ReplaceBackgroundFeature: React.FC<ReplaceBackgroundFeatureProps> =
   translations,
   onSelectImage,
   onSaveImage,
+  onBeforeProcess,
   renderProcessingModal,
 }) => {
   const tokens = useAppDesignTokens();
@@ -46,6 +49,7 @@ export const ReplaceBackgroundFeature: React.FC<ReplaceBackgroundFeatureProps> =
     config,
     onSelectImage,
     onSaveImage,
+    onBeforeProcess,
   });
 
   const photoTranslations = useMemo(

package/src/features/replace-background/presentation/hooks/useReplaceBackgroundFeature.ts

@@ -18,6 +18,7 @@ export interface UseReplaceBackgroundFeatureProps {
   config: ReplaceBackgroundFeatureConfig;
   onSelectImage: () => Promise<string | null>;
   onSaveImage: (imageUrl: string) => Promise<void>;
+  onBeforeProcess?: () => Promise<boolean>;
 }
 
 export interface UseReplaceBackgroundFeatureReturn extends ImageWithPromptHookReturn {
@@ -28,11 +29,11 @@ export interface UseReplaceBackgroundFeatureReturn extends ImageWithPromptHookRe
 export function useReplaceBackgroundFeature(
   props: UseReplaceBackgroundFeatureProps,
 ): UseReplaceBackgroundFeatureReturn {
-  const { config, onSelectImage, onSaveImage } = props;
+  const { config, onSelectImage, onSaveImage, onBeforeProcess } = props;
   const [mode, setMode] = useState<ReplaceBackgroundMode>(config.defaultMode || "replace");
 
   const baseHook = useImageWithPromptFeature<ReplaceBackgroundFeatureConfig, ReplaceBackgroundResult>(
-    { config, onSelectImage, onSaveImage },
+    { config, onSelectImage, onSaveImage, onBeforeProcess },
     {
       buildInput: (imageBase64, prompt) => ({
         imageBase64,

package/src/features/shared/dual-image-video/domain/types/dual-image-video.types.ts

@@ -56,6 +56,8 @@ export interface UseDualImageVideoFeatureProps {
   onSelectSourceImage: () => Promise<string | null>;
   onSelectTargetImage: () => Promise<string | null>;
   onSaveVideo: (videoUrl: string) => Promise<void>;
+  /** Called before processing starts. Return false to cancel. */
+  onBeforeProcess?: () => Promise<boolean>;
 }
 
 export interface UseDualImageVideoFeatureReturn extends DualImageVideoFeatureState {

package/src/features/shared/dual-image-video/presentation/hooks/useDualImageVideoFeature.ts

@@ -24,7 +24,7 @@ const initialState: DualImageVideoFeatureState = {
 export function useDualImageVideoFeature(
   props: UseDualImageVideoFeatureProps,
 ): UseDualImageVideoFeatureReturn {
-  const { featureType, config, onSelectSourceImage, onSelectTargetImage, onSaveVideo } = props;
+  const { featureType, config, onSelectSourceImage, onSelectTargetImage, onSaveVideo, onBeforeProcess } = props;
   const [state, setState] = useState<DualImageVideoFeatureState>(initialState);
 
   const selectSourceImage = useCallback(async () => {
@@ -60,6 +60,11 @@ export function useDualImageVideoFeature(
   const process = useCallback(async () => {
     if (!state.sourceImageUri || !state.targetImageUri) return;
 
+    if (onBeforeProcess) {
+      const canProceed = await onBeforeProcess();
+      if (!canProceed) return;
+    }
+
     setState((prev) => ({
       ...prev,
       isProcessing: true,
@@ -96,7 +101,7 @@ export function useDualImageVideoFeature(
       }));
       config.onError?.(errorMessage);
     }
-  }, [state.sourceImageUri, state.targetImageUri, featureType, config, handleProgress]);
+  }, [state.sourceImageUri, state.targetImageUri, featureType, config, handleProgress, onBeforeProcess]);
 
   const save = useCallback(async () => {
     if (!state.processedVideoUrl) return;

package/src/features/upscaling/presentation/components/UpscaleFeature.tsx

@@ -28,6 +28,8 @@ export interface UpscaleFeatureProps {
   onSelectImage: () => Promise<string | null>;
   /** Save image callback */
   onSaveImage: (imageUrl: string) => Promise<void>;
+  /** Called before processing starts. Return false to cancel. */
+  onBeforeProcess?: () => Promise<boolean>;
   /** Optional custom processing modal renderer */
   renderProcessingModal?: (props: {
     visible: boolean;
@@ -40,6 +42,7 @@ export const UpscaleFeature: React.FC<UpscaleFeatureProps> = ({
   translations,
   onSelectImage,
   onSaveImage,
+  onBeforeProcess,
   renderProcessingModal,
 }) => {
   const tokens = useAppDesignTokens();
@@ -48,6 +51,7 @@ export const UpscaleFeature: React.FC<UpscaleFeatureProps> = ({
     config,
     onSelectImage,
     onSaveImage,
+    onBeforeProcess,
   });
 
   const photoTranslations = useMemo(

package/src/features/upscaling/presentation/hooks/useUpscaleFeature.ts

@@ -13,15 +13,16 @@ export interface UseUpscaleFeatureProps {
   config: UpscaleFeatureConfig;
   onSelectImage: () => Promise<string | null>;
   onSaveImage: (imageUrl: string) => Promise<void>;
+  onBeforeProcess?: () => Promise<boolean>;
 }
 
 export function useUpscaleFeature(
   props: UseUpscaleFeatureProps,
 ): BaseSingleImageHookReturn {
-  const { config, onSelectImage, onSaveImage } = props;
+  const { config, onSelectImage, onSaveImage, onBeforeProcess } = props;
 
   return useSingleImageFeature<UpscaleFeatureConfig, UpscaleResult>(
-    { config, onSelectImage, onSaveImage },
+    { config, onSelectImage, onSaveImage, onBeforeProcess },
     {
       buildInput: (imageBase64, cfg) => ({
         imageBase64,