@umituz/react-native-ai-generation-content 1.26.2 → 1.26.5

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

@@ -1,88 +0,0 @@
-/**
- * Dual Image Video Feature Types
- * Shared types for video features that take two images (ai-hug, ai-kiss, etc.)
- * DRY: Consolidates common types from ai-hug and ai-kiss features
- */
-
-import type { VideoFeatureType } from "../../../../../domain/interfaces/ai-provider.interface";
-
-export interface DualImageVideoFeatureState {
-  sourceImageUri: string | null;
-  targetImageUri: string | null;
-  processedVideoUrl: string | null;
-  isProcessing: boolean;
-  progress: number;
-  error: string | null;
-}
-
-export interface DualImageVideoResult {
-  success: boolean;
-  videoUrl?: string;
-  error?: string;
-  requestId?: string;
-  creationId?: string;
-}
-
-export interface DualImageVideoProcessingStartData {
-  creationId: string;
-  featureType: string;
-  sourceImageUri: string;
-  targetImageUri: string;
-}
-
-export type DualImageVideoResultExtractor = (result: unknown) => string | undefined;
-
-export interface DualImageVideoFeatureConfig {
-  creditCost?: number;
-  extractResult?: DualImageVideoResultExtractor;
-  prepareImage: (imageUri: string) => Promise<string>;
-  onSourceImageSelect?: (uri: string) => void;
-  onTargetImageSelect?: (uri: string) => void;
-  /** Called when processing starts - use to create Firestore doc with "processing" status */
-  onProcessingStart?: (data: DualImageVideoProcessingStartData) => void;
-  /** Called when processing completes - use to update Firestore doc with result */
-  onProcessingComplete?: (result: DualImageVideoResult) => void;
-  /** Called on error - use to update Firestore doc with "failed" status */
-  onError?: (error: string, creationId?: string) => void;
-}
-
-export interface DualImageVideoTranslations {
-  sourceUploadTitle: string;
-  sourceUploadSubtitle: string;
-  targetUploadTitle: string;
-  targetUploadSubtitle: string;
-  uploadChange: string;
-  uploadAnalyzing: string;
-  description: string;
-  processingText: string;
-  processButtonText: string;
-  successText: string;
-  saveButtonText: string;
-  tryAnotherText: string;
-  /** Modal title shown during processing */
-  modalTitle?: string;
-  /** Modal message shown during processing */
-  modalMessage?: string;
-  /** Modal hint/tip shown during processing */
-  modalHint?: string;
-  /** "Continue in background" text */
-  modalBackgroundHint?: string;
-}
-
-export interface UseDualImageVideoFeatureProps {
-  featureType: VideoFeatureType;
-  config: DualImageVideoFeatureConfig;
-  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 {
-  selectSourceImage: () => Promise<void>;
-  selectTargetImage: () => Promise<void>;
-  process: () => Promise<void>;
-  save: () => Promise<void>;
-  reset: () => void;
-}

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

@@ -1,14 +0,0 @@
-/**
- * Dual Image Video Domain Types
- */
-
-export type {
-  DualImageVideoFeatureState,
-  DualImageVideoResult,
-  DualImageVideoProcessingStartData,
-  DualImageVideoResultExtractor,
-  DualImageVideoFeatureConfig,
-  DualImageVideoTranslations,
-  UseDualImageVideoFeatureProps,
-  UseDualImageVideoFeatureReturn,
-} from "./dual-image-video.types";

package/src/features/shared/dual-image-video/index.ts

@@ -1,17 +0,0 @@
-/**
- * Dual Image Video Feature (Shared)
- * Base infrastructure for video features using two source images
- */
-
-export type {
-  DualImageVideoFeatureState,
-  DualImageVideoResult,
-  DualImageVideoProcessingStartData,
-  DualImageVideoResultExtractor,
-  DualImageVideoFeatureConfig,
-  DualImageVideoTranslations,
-  UseDualImageVideoFeatureProps,
-  UseDualImageVideoFeatureReturn,
-} from "./domain/types";
-
-export { useDualImageVideoFeature } from "./presentation/hooks";

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

@@ -1,5 +0,0 @@
-/**
- * Dual Image Video Presentation Hooks
- */
-
-export { useDualImageVideoFeature } from "./useDualImageVideoFeature";

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

@@ -1,185 +0,0 @@
-/**
- * useDualImageVideoFeature Hook
- * Base hook for video features that take two images (ai-hug, ai-kiss, etc.)
- * DRY: Consolidates common logic from useAIHugFeature and useAIKissFeature
- * Uses centralized orchestrator for credit/error handling
- */
-
-import { useState, useCallback, useRef, useMemo } from "react";
-import { executeVideoFeature } from "../../../../../infrastructure/services";
-import { generateCreationId } from "../../../../../domains/creations/domain/utils";
-import {
-  useGenerationOrchestrator,
-  type GenerationStrategy,
-  type AlertMessages,
-} from "../../../../../presentation/hooks/generation";
-import type {
-  UseDualImageVideoFeatureProps,
-  UseDualImageVideoFeatureReturn,
-} from "../../domain/types/dual-image-video.types";
-
-export interface DualImageVideoFeatureOptions {
-  /** Alert messages for error handling */
-  alertMessages?: AlertMessages;
-  /** User ID for credit operations */
-  userId?: string;
-  /** Callback when credits are exhausted */
-  onCreditsExhausted?: () => void;
-}
-
-const DEFAULT_ALERT_MESSAGES: AlertMessages = {
-  networkError: "No internet connection. Please check your network.",
-  policyViolation: "Content not allowed. Please try different images.",
-  saveFailed: "Failed to save result. Please try again.",
-  creditFailed: "Credit operation failed. Please try again.",
-  unknown: "An error occurred. Please try again.",
-};
-
-interface DualImageVideoInput {
-  sourceImageBase64: string;
-  targetImageBase64: string;
-}
-
-export function useDualImageVideoFeature(
-  props: UseDualImageVideoFeatureProps,
-  options?: DualImageVideoFeatureOptions,
-): UseDualImageVideoFeatureReturn {
-  const { featureType, config, onSelectSourceImage, onSelectTargetImage, onSaveVideo, onBeforeProcess } = props;
-
-  // Image selection state (separate from orchestrator state)
-  const [sourceImageUri, setSourceImageUri] = useState<string | null>(null);
-  const [targetImageUri, setTargetImageUri] = useState<string | null>(null);
-  const [imageError, setImageError] = useState<string | null>(null);
-  const currentCreationIdRef = useRef<string | null>(null);
-
-  // Create strategy for orchestrator
-  const strategy: GenerationStrategy<DualImageVideoInput, string> = useMemo(
-    () => ({
-      execute: async (input, onProgress) => {
-        const result = await executeVideoFeature(
-          featureType,
-          { sourceImageBase64: input.sourceImageBase64, targetImageBase64: input.targetImageBase64 },
-          { extractResult: config.extractResult, onProgress },
-        );
-
-        if (!result.success || !result.videoUrl) {
-          throw new Error(result.error || "Processing failed");
-        }
-
-        // Notify completion with creationId
-        const creationId = currentCreationIdRef.current;
-        if (creationId) {
-          config.onProcessingComplete?.({ success: true, videoUrl: result.videoUrl, creationId });
-        }
-
-        return result.videoUrl;
-      },
-      getCreditCost: () => config.creditCost || 1,
-    }),
-    [featureType, config],
-  );
-
-  // Use orchestrator for generation
-  const orchestrator = useGenerationOrchestrator(strategy, {
-    userId: options?.userId,
-    alertMessages: options?.alertMessages || DEFAULT_ALERT_MESSAGES,
-    onCreditsExhausted: options?.onCreditsExhausted,
-    onError: (error) => {
-      config.onError?.(error.message, currentCreationIdRef.current ?? undefined);
-    },
-  });
-
-  const selectSourceImage = useCallback(async () => {
-    try {
-      const uri = await onSelectSourceImage();
-      if (uri) {
-        setSourceImageUri(uri);
-        setImageError(null);
-        config.onSourceImageSelect?.(uri);
-      }
-    } catch (error) {
-      const message = error instanceof Error ? error.message : String(error);
-      setImageError(message);
-    }
-  }, [onSelectSourceImage, config]);
-
-  const selectTargetImage = useCallback(async () => {
-    try {
-      const uri = await onSelectTargetImage();
-      if (uri) {
-        setTargetImageUri(uri);
-        setImageError(null);
-        config.onTargetImageSelect?.(uri);
-      }
-    } catch (error) {
-      const message = error instanceof Error ? error.message : String(error);
-      setImageError(message);
-    }
-  }, [onSelectTargetImage, config]);
-
-  const process = useCallback(async () => {
-    if (!sourceImageUri || !targetImageUri) return;
-
-    if (onBeforeProcess) {
-      const canProceed = await onBeforeProcess();
-      if (!canProceed) return;
-    }
-
-    // Generate creationId for this processing session
-    const creationId = generateCreationId();
-    currentCreationIdRef.current = creationId;
-
-    // Notify start with creationId for Firestore creation
-    config.onProcessingStart?.({
-      creationId,
-      featureType,
-      sourceImageUri,
-      targetImageUri,
-    });
-
-    try {
-      const [sourceImageBase64, targetImageBase64] = await Promise.all([
-        config.prepareImage(sourceImageUri),
-        config.prepareImage(targetImageUri),
-      ]);
-
-      await orchestrator.generate({ sourceImageBase64, targetImageBase64 });
-    } catch {
-      // Error already handled by orchestrator
-    }
-  }, [sourceImageUri, targetImageUri, featureType, config, onBeforeProcess, orchestrator]);
-
-  const save = useCallback(async () => {
-    if (!orchestrator.result) return;
-
-    try {
-      await onSaveVideo(orchestrator.result);
-    } catch (error) {
-      const message = error instanceof Error ? error.message : String(error);
-      setImageError(message);
-    }
-  }, [orchestrator.result, onSaveVideo]);
-
-  const reset = useCallback(() => {
-    setSourceImageUri(null);
-    setTargetImageUri(null);
-    setImageError(null);
-    currentCreationIdRef.current = null;
-    orchestrator.reset();
-  }, [orchestrator]);
-
-  // Combine states for backward compatibility
-  return {
-    sourceImageUri,
-    targetImageUri,
-    processedVideoUrl: orchestrator.result,
-    isProcessing: orchestrator.isGenerating,
-    progress: orchestrator.progress,
-    error: orchestrator.error?.message || imageError,
-    selectSourceImage,
-    selectTargetImage,
-    process,
-    save,
-    reset,
-  };
-}

package/src/features/shared/index.ts

@@ -1,6 +0,0 @@
-/**
- * Shared Features
- * Common infrastructure for multiple feature types
- */
-
-export * from "./dual-image-video";

package/src/features/text-to-image/README.md

@@ -1,394 +0,0 @@
-# Text to Image Feature
-
-Generate images from text prompts using AI models.
-
-## 📍 Import Path
-
-```typescript
-import { useTextToImageFeature } from '@umituz/react-native-ai-generation-content';
-```
-
-**Location**: `src/features/text-to-image/`
-
-## 🎯 Feature Purpose
-
-Convert natural language text descriptions into AI-generated images. Supports various aspect ratios, styles, and quality settings.
-
----
-
-## 📋 Usage Strategy
-
-### When to Use This Feature
-
-✅ **Use Cases:**
-- Generating original images from text descriptions
-- Creating visual content for marketing materials
-- Generating concept art and prototypes
-- Creating social media visuals
-- Product visualization from descriptions
-- Storyboarding and creative planning
-
-❌ **When NOT to Use:**
-- Image manipulation of existing photos (use Image-to-Image)
-- Photo restoration (use Photo Restoration)
-- Style transfer on existing images (use Style Transfer)
-- Face swapping (use Face Swap)
-
-### Implementation Strategy
-
-1. **Use the feature hook** at component level
-2. **Initialize with config** before first render
-3. **Handle all states** - loading, success, error
-4. **Implement progress tracking** for better UX
-5. **Store generated images** for later use
-
----
-
-## ⚠️ Critical Rules (MUST FOLLOW)
-
-### 1. Prompt Engineering
-- **MUST** use descriptive, specific prompts
-- **MUST** include subject, action, and context
-- **MUST** specify art style if important
-- **MUST** use English for best results
-- **MUST NOT** exceed character limits (check model limits)
-
-### 2. Configuration
-- **MUST** provide valid `userId` for tracking
-- **MUST** implement `onError` callback
-- **MUST** handle `isProcessing` state to prevent duplicate requests
-- **MUST** validate prompts before generation
-- **MUST NOT** call `generate()` when `isReady` is false
-
-### 3. State Management
-- **MUST** check `isReady` before enabling generate button
-- **MUST** handle `isProcessing` state with loading indicators
-- **MUST** display `error` state to users
-- **MUST** handle `result.imageUrl` existence check
-- **MUST** implement proper cleanup on unmount
-
-### 4. Performance
-- **MUST** implement debouncing for prompt inputs (>500ms)
-- **MUST** limit concurrent requests (max 1 per user)
-- **MUST** cache generated images locally
-- **MUST** implement retry logic (max 3 attempts)
-- **MUST NOT** generate multiple images simultaneously
-
-### 5. Security & Privacy
-- **MUST** validate and sanitize user prompts
-- **MUST** implement content moderation
-- **MUST** check for inappropriate content
-- **MUST** store userId securely
-- **MUST NOT** expose API keys in client code
-
----
-
-## 🚫 Prohibitions (MUST AVOID)
-
-### Strictly Forbidden
-
-❌ **NEVER** do the following:
-
-1. **No Empty Prompts**
-   - Always validate prompt has meaningful content
-   - Minimum 10 characters recommended
-
-2. **No Concurrent Generation**
-   - Never call `generate()` while `isProcessing === true`
-   - Always disable generate button during processing
-
-3. **No Hardcoded Credentials**
-   - Never store API keys in component files
-   - Use environment variables or secure storage
-
-4. **No Unhandled Errors**
-   - Never ignore error states
-   - Always implement error boundaries
-
-5. **No Memory Leaks**
-   - Never forget cleanup on unmount
-   - Always cancel pending requests
-
-6. **No Excessive Re-renders**
-   - Never pass new config objects on each render
-   - Always memoize configuration objects
-
-7. **No Blocked Main Thread**
-   - Never perform heavy operations in render
-   - Use web workers or background tasks for processing
-
----
-
-## 🤖 AI Agent Directions
-
-### For AI Code Generation Tools
-
-When using this feature with AI code generation tools, follow these guidelines:
-
-#### Prompt Template for AI Agents
-
-```
-You are implementing a text-to-image generation feature using @umituz/react-native-ai-generation-content.
-
-REQUIREMENTS:
-1. Import from: @umituz/react-native-ai-generation-content
-2. Use the useTextToImageFeature hook
-3. Implement all state handlers (loading, success, error)
-4. Add debouncing for prompt input
-5. Validate prompts before generation
-6. Handle isReady and isProcessing states correctly
-7. Implement proper error handling with user feedback
-8. Add loading indicators during generation
-9. Display results safely with null checks
-10. Implement cleanup on unmount
-
-CRITICAL RULES:
-- NEVER call generate() when isProcessing is true
-- ALWAYS validate prompt before calling generate()
-- MUST handle error state with user-friendly message
-- MUST disable generate button during processing
-- MUST implement debouncing (500ms minimum)
-
-CONFIGURATION:
-- Provide valid userId (string)
-- Set model (default: 'imagen-3')
-- Configure callbacks: onProcessingStart, onProcessingComplete, onError
-
-GENERATION OPTIONS:
-- aspectRatio: '1:1' | '16:9' | '9:16' | '4:3' | '3:4'
-- numberOfImages: 1-4
-- style: 'realistic' | 'artistic' | 'anime' | '3d' | 'painting'
-- negativePrompt: string (optional)
-
-STRICTLY FORBIDDEN:
-- No empty prompts
-- No concurrent generation calls
-- No hardcoded API keys
-- No unhandled errors
-- No memory leaks
-```
-
-#### AI Implementation Checklist
-
-Use this checklist when generating code:
-
-- [ ] Feature imported from correct path
-- [ ] Hook initialized with proper config
-- [ ] All state handlers implemented
-- [ ] Debouncing added to input
-- [ ] Validation before generate()
-- [ ] Loading indicator during processing
-- [ ] Error display with user-friendly message
-- [ ] Button disabled when processing
-- [ ] Cleanup on unmount
-- [ ] Null checks on result
-- [ ] Retry logic implemented
-- [ ] Image caching configured
-
----
-
-## 🛠️ Configuration Strategy
-
-### Essential Configuration
-
-```typescript
-// Required fields
-{
-  userId: string  // User identifier for tracking
-}
-
-// Optional callbacks
-{
-  onProcessingStart?: () => void
-  onProcessingComplete?: (result) => void
-  onError?: (error: string) => void
-}
-```
-
-### Recommended Settings
-
-1. **Model Selection**
-   - Default: `imagen-3`
-   - Fastest: `imagen-2-fast`
-   - Highest quality: `imagen-3`
-
-2. **Generation Options**
-   - Aspect Ratio: Match your UI layout
-   - Number of Images: 1-2 for speed, 3-4 for variety
-   - Style: Choose based on use case
-
-3. **Performance Settings**
-   - Enable image caching
-   - Set reasonable timeouts (30s default)
-   - Implement retry with backoff
-
----
-
-## 📊 State Management
-
-### Feature States
-
-**isReady**: boolean
-- Feature initialized and ready to use
-- Check before enabling generate button
-
-**isProcessing**: boolean
-- Generation in progress
-- Show loading indicator
-- Disable generate button
-
-**progress**: number (0-100)
-- Generation progress percentage
-- Update progress bar
-
-**error**: string | null
-- Error message if generation failed
-- Display to user with clear message
-
-**result**: {
-  imageUrl: string
-  imageUrls?: string[]
-  metadata?: any
-}
-
----
-
-## 🔐 Security Considerations
-
-### Content Moderation
-
-- **MUST** implement prompt content filtering
-- **MUST** check for inappropriate content
-- **MUST** block harmful or illegal prompts
-- **MUST** log moderation actions
-
-### API Security
-
-- **MUST** use environment variables for API keys
-- **MUST** implement rate limiting
-- **MUST** validate all user inputs
-- **MUST** use HTTPS for all API calls
-
-### Data Privacy
-
-- **MUST** comply with data protection regulations
-- **MUST** obtain user consent for generation
-- **MUST** provide privacy policy
-- **MUST** allow data deletion requests
-
----
-
-## 🎨 Best Practices
-
-### Prompt Engineering
-
-1. **Be Specific**
-   - Good: "A majestic lion standing on a rock at sunset, detailed fur, dramatic lighting"
-   - Bad: "A lion"
-
-2. **Include Style**
-   - Specify art style, mood, atmosphere
-   - Example: "in the style of oil painting, romantic mood"
-
-3. **Add Technical Details**
-   - Lighting, camera angle, composition
-   - Example: "golden hour lighting, wide angle shot"
-
-4. **Use Negative Prompts**
-   - Specify what to avoid
-   - Example: "blurry, low quality, distorted"
-
-### Performance Optimization
-
-1. **Debounce Input**
-   - Wait 500ms after user stops typing
-   - Prevents unnecessary validations
-
-2. **Lazy Loading**
-   - Load images on demand
-   - Use pagination for multiple results
-
-3. **Cache Results**
-   - Store generated images locally
-   - Implement cache invalidation strategy
-
-4. **Progressive Enhancement**
-   - Show placeholder while loading
-   - Display low-res first, then high-res
-
----
-
-## 🐛 Common Pitfalls
-
-### Memory Issues
-
-❌ **Problem**: Storing all generated images in state
-✅ **Solution**: Implement pagination or virtualized lists
-
-### Performance Issues
-
-❌ **Problem**: Re-generating on every prompt change
-✅ **Solution**: Require explicit user action to generate
-
-### UX Issues
-
-❌ **Problem**: No feedback during generation
-✅ **Solution**: Always show progress indicator
-
-### Error Handling
-
-❌ **Problem**: Generic error messages
-✅ **Solution**: Provide specific, actionable error messages
-
----
-
-## 📦 Related Components
-
-Use these components from the library:
-
-- **GenerationProgressModal**: Progress display
-- **StyleSelector**: Style selection UI
-- **AspectRatioSelector**: Aspect ratio picker
-- **ImageGallery**: Display multiple results
-- **PromptInput**: Enhanced text input
-
-Located at: `src/presentation/components/`
-
----
-
-## 🔄 Migration Strategy
-
-If migrating from previous implementation:
-
-1. **Update imports** to new path
-2. **Replace old config** with new structure
-3. **Update state handling** to match new interface
-4. **Test all error cases**
-5. **Update UI components** for new state structure
-
----
-
-## 📚 Additional Resources
-
-- Main documentation: `/docs/`
-- API reference: `/docs/api/`
-- Examples: `/docs/examples/basic/text-to-image/`
-- Architecture: `/ARCHITECTURE.md`
-
----
-
-**Last Updated**: 2025-01-08
-**Version**: 2.0.0 (Strategy-based Documentation)
-
----
-
-## 📝 Changelog
-
-### v2.0.0 - 2025-01-08
-- **BREAKING**: Documentation format changed to strategy-based
-- Removed extensive code examples
-- Added rules, prohibitions, and AI agent directions
-- Focus on best practices and implementation guidance
-
-### v1.0.0 - Initial Release
-- Initial feature documentation