@umituz/react-native-design-system 4.23.97 → 4.23.101

package/src/media/presentation/hooks/card-multimedia.types.ts

@@ -1,53 +0,0 @@
-/**
- * Card Multimedia Flashcard Hook Types
- * Type definitions for card multimedia hooks
- */
-
-import type {
-  CardMediaAttachment,
-  CardMediaFile,
-  CardMediaGenerationRequest,
-  CardMediaGenerationResult,
-  CardMediaCompressionOptions,
-  CardMediaValidation,
-  CardMediaUploadProgress,
-  CardMultimediaFlashcard,
-  CreateCardMultimediaData,
-} from "../../domain/entities/CardMultimedia.types";
-
-export interface UseCardMediaUploadResult {
-  uploadMedia: (
-    file: CardMediaFile,
-    options?: CardMediaCompressionOptions,
-  ) => Promise<CardMediaAttachment>;
-  isUploading: boolean;
-  uploadProgress: CardMediaUploadProgress | null;
-  error: string | null;
-}
-
-export interface UseCardMediaGenerationResult {
-  generateMedia: (
-    request: CardMediaGenerationRequest,
-  ) => Promise<CardMediaGenerationResult>;
-  isGenerating: boolean;
-  generationResult: CardMediaGenerationResult | null;
-  error: string | null;
-}
-
-export interface UseCardMediaValidationResult {
-  validateMedia: (file: CardMediaFile) => Promise<CardMediaValidation>;
-  isValidating: boolean;
-  validation: CardMediaValidation | null;
-  error: string | null;
-}
-
-export interface UseCardMultimediaFlashcardResult {
-  createCardMultimedia: (cardData: CreateCardMultimediaData) => Promise<CardMultimediaFlashcard>;
-  updateCardMedia: (
-    cardId: string,
-    media: CardMediaAttachment[],
-  ) => Promise<CardMultimediaFlashcard>;
-  deleteCardMedia: (attachmentId: string) => Promise<void>;
-  isProcessing: boolean;
-  error: string | null;
-}

package/src/media/presentation/hooks/multimedia.types.README.md

@@ -1,201 +0,0 @@
-# Multimedia Hook Types
-
-## Purpose
-TypeScript return type interfaces for general multimedia hooks in the presentation layer.
-
-## File Location
-`src/presentation/hooks/multimedia.types.ts`
-
-## Strategy
-- Define contracts for general multimedia hook implementations
-- Ensure type safety across media operations
-- Provide consistent return types for upload, generation, and validation
-- Support general-purpose media operations
-- Enable proper error handling and loading states
-- Maintain separation from card-specific multimedia types
-
-## Forbidden
-- **DO NOT** import implementation details or hooks in type files
-- **DO NOT** mix MediaAttachment and CardMediaAttachment types
-- **DO NOT** add business logic to type definitions
-- **DO NOT** use `any` type for function parameters or returns
-- **DO NOT** create circular dependencies with domain types
-- **DO NOT** export implementation-specific types
-- **DO NOT** modify these types without updating all hook implementations
-
-## Rules
-1. All hook returns must include loading state, error state, and operation function
-2. Async operations must return Promise with appropriate type
-3. Error states must be string | null (not Error objects)
-4. Progress/results must be null when not active
-5. Boolean states must clearly indicate operation in progress
-6. All interfaces must be exported and public
-7. Type names must follow Use*Result pattern
-8. Functions must accept domain types, not external types
-9. Optional parameters must be clearly marked
-10. Return types must match hook implementations exactly
-
-## AI Agent Guidelines
-
-When working with multimedia hook types:
-
-1. **Type Imports**: Always import types from this file for general multimedia hooks
-2. **Hook Implementation**: Implement hooks that return these exact interfaces
-3. **General vs Card**: Use Media* types for general operations, Card* for card-specific
-4. **Error Handling**: Always check error state before using results
-5. **Loading States**: Respect loading states to prevent race conditions
-6. **Progress Tracking**: Use progress objects for upload operations
-7. **Type Safety**: Use these types for all general multimedia hook return values
-8. **Testing**: Mock these interfaces when testing media operations
-
-### Hook Return Type Structure
-
-All multimedia hook returns follow this consistent pattern:
-
-**Core Components**:
-- **operationFunction**: An async function that accepts parameters and returns a Promise with the result type
-- **isOperationInProgress**: A boolean flag indicating whether the operation is currently running
-- **operationResult**: The result object or null when no operation is active
-- **error**: A string containing error messages or null when no error exists
-
-### UseMediaUploadResult
-
-**Purpose**: General media upload operations with compression options
-
-**Key Features**:
-- Upload function accepts file and compression options
-- Tracks upload progress
-- Returns MediaAttachment
-- Handles upload errors
-
-**Usage Pattern**:
-1. Check `isUploading` before calling
-2. Call `uploadMedia()` with file and optional compression
-3. Monitor `uploadProgress` during upload
-4. Check `error` state on completion
-5. Use returned MediaAttachment on success
-
-### UseMediaGenerationResult
-
-**Purpose**: General media generation (AI-based generation without image search)
-
-**Key Features**:
-- Generation function accepts request parameters
-- Tracks generation status
-- Returns MediaGenerationResult
-- Supports core generation methods
-
-**Usage Pattern**:
-1. Prepare MediaGenerationRequest
-2. Check `isGenerating` before calling
-3. Call `generateMedia()` with request
-4. Access `generationResult` when complete
-5. Handle `error` if generation fails
-
-### UseMediaValidationResult
-
-**Purpose**: General media validation before upload or processing
-
-**Key Features**:
-- Validation function accepts file
-- Tracks validation status
-- Returns MediaValidation result
-- Provides detailed validation errors
-
-**Usage Pattern**:
-1. Check `isValidating` before calling
-2. Call `validateMedia()` with file
-3. Access `validation` result for validity check
-4. Use `validation.errors` array for error details
-5. Check `error` state for validation failures
-
-### UseMultimediaFlashcardResult
-
-**Purpose**: General flashcard CRUD operations
-
-**Key Features**:
-- Create flashcard with multimedia
-- Update flashcard media
-- Delete specific media attachment
-- Tracks processing state
-- Returns MultimediaFlashcard
-
-**Usage Pattern**:
-1. Create: Call `createMultimediaCard()` with card data
-2. Update: Call `updateMedia()` with cardId and media array
-3. Delete: Call `deleteMedia()` with attachmentId
-4. Check `isProcessing` before operations
-5. Handle `error` state for failures
-
-### General vs Card Multimedia Types
-
-| Operation | General Types | Card Types | Key Difference |
-|-----------|--------------|------------|----------------|
-| Upload | MediaAttachment | CardMediaAttachment | Different entity structures |
-| Generation | MediaGenerationRequest | CardMediaGenerationRequest | Cards include image search |
-| Validation | MediaValidation | CardMediaValidation | Different validation rules |
-| Flashcard | MultimediaFlashcard | CardMultimediaFlashcard | Different entity types |
-| Features | Core operations | Core + image search | Card has extended features |
-
-### When to Use Which Types
-
-**Use Media* Types (General)**:
-- Generic media handling
-- Non-card-specific operations
-- Reusable media components
-- General-purpose flashcards
-
-**Use Card* Types (Card-Specific)**:
-- Card-specific operations
-- Image search functionality
-- Card entity management
-- Card-specific validation rules
-
-### Type Guards and Validation
-
-1. **Upload Hook**: Check for `uploadMedia` function and `isUploading` boolean
-2. **Generation Hook**: Check for `generateMedia` function and `isGenerating` boolean
-3. **Validation Hook**: Check for `validateMedia` function and `isValidating` boolean
-4. **Flashcard Hook**: Check for all three CRUD functions and `isProcessing` boolean
-
-### Error Handling Patterns
-
-1. Always check if `error !== null` before using results
-2. Errors are strings, not Error objects
-3. Clear error before starting new operation
-4. Show user-friendly error messages
-5. Handle null states for progress/results
-
-### Async Operation Patterns
-
-1. **Before Call**: Check loading state to prevent concurrent calls
-2. **During Call**: Show loading indicator based on boolean state
-3. **After Call**: Check error state, then use result
-4. **Error Case**: Display error, reset loading state
-5. **Success Case**: Use result, clear error
-
-### Composable Hooks Pattern
-
-Combine multiple hook types for complex workflows:
-
-1. **Validate Then Upload**: Use validation result before calling upload
-2. **Generate Then Upload**: Chain generation and upload operations
-3. **Upload Then Create Card**: Use upload result to create flashcard
-4. **Parallel Operations**: Use multiple hooks independently
-
-### Related Domain Types
-
-These interfaces use domain types:
-- MediaAttachment
-- MediaGenerationRequest
-- MediaGenerationResult
-- MediaCompressionOptions
-- MediaValidation
-- MediaUploadProgress
-- MultimediaFlashcard
-
-## Dependencies
-
-- Domain layer types (Media* entities)
-- Presentation layer hooks
-- No external dependencies

package/src/media/presentation/hooks/useCardMediaGeneration.README.md

@@ -1,164 +0,0 @@
-# useCardMediaGeneration
-
-## Purpose
-Card-specific React hook for AI-powered media generation (text-to-image, text-to-audio, image-search) for flashcards.
-
-## File Location
-`src/presentation/hooks/useCardMediaGeneration.ts`
-
-## Strategy
-- Provide card-specific interface for AI media generation
-- Support text-to-image, text-to-audio, and image-search operations
-- Return CardMediaAttachment with position property
-- Track generation status and metadata
-- Manage credit costs for card media generation
-- Handle generation errors with proper feedback
-- Support card-specific generation options
-
-## Forbidden
-- **DO NOT** start generation while previous is in progress
-- **DO NOT** ignore credit costs before generation
-- **DO NOT** mock generation in production without AI API
-- **DO NOT** assume generation will succeed - check result.success
-- **DO NOT** expose API keys or AI implementation details
-- **DO NOT** allow unlimited concurrent generations
-- **DO NOT** bypass timeout handling for long generations
-- **DO NOT** store large results permanently in hook state
-- **DO NOT** use empty or invalid prompts
-- **DO NOT** mix with MediaAttachment (must use CardMediaAttachment)
-
-## Rules
-1. Always validate prompt text before generation
-2. Check credit availability before operations
-3. Track processing time for each request
-4. Return CardMediaAttachment with position property
-5. Return unique requestId for tracking
-6. Include creditsUsed in result metadata
-7. Support maxResults for multiple outputs
-8. Clear generation state on new operations
-9. Handle both success and failure gracefully
-10. Support language, voice, speed options for audio
-
-## AI Agent Guidelines
-
-When working with useCardMediaGeneration hook:
-
-1. **Type Specificity**: Use CardMediaAttachment (not MediaAttachment)
-2. **Position Awareness**: Generated media has position property
-3. **Prompt Quality**: Use descriptive prompts for better results
-4. **Credit Tracking**: Monitor credit costs and balance
-5. **Error Handling**: Always check result.success field
-
-### Generation Types
-
-**Text-to-Image** (type: 'text_to_image')
-- Generates images from text descriptions
-- Credit cost: 5 per generation
-- Default maxResults: 1
-- Returns CardMediaAttachment with position: 'both'
-- Supports style customization
-
-**Text-to-Audio** (type: 'text_to_audio')
-- Generates audio from text (TTS)
-- Credit cost: 3 per generation
-- Default duration: 10 seconds
-- Returns CardMediaAttachment with position: 'back'
-- Supports voice, language, speed options
-
-**Image Search** (type: 'image_search')
-- Searches for existing images
-- Credit cost: 2 per search
-- Default maxResults: 5
-- Returns CardMediaAttachment with position: 'both'
-- Finds relevant images from database
-
-### Generation Workflow
-
-1. Validate prompt text quality
-2. Check credit balance
-3. Select generation type
-4. Configure options (maxResults, voice, language, etc.)
-5. Call generateMedia with request
-6. Monitor isGenerating state
-7. Process CardMediaGenerationResult
-8. Handle success or error
-
-### Result Structure
-
-CardMediaGenerationResult includes:
-- success: Boolean success/failure
-- attachments: Array of CardMediaAttachment (with position)
-- creditsUsed: Credits consumed
-- processingTime: Duration in milliseconds
-- requestId: Unique identifier
-- error: Error message if failed
-
-### CardMediaAttachment Features
-
-Generated attachments include:
-- id: Unique ID with card_media_ prefix
-- type: CardMediaType (IMAGE, VIDEO, AUDIO)
-- position: CardMediaPosition (front, back, or both)
-- url: Generated media URL
-- filename: Generated filename
-- fileSize: Size in bytes
-- mimeType: MIME type
-- duration: Audio/video duration
-- thumbnailUrl: Thumbnail for visual media
-- isDownloaded: Download status
-- createdAt: ISO timestamp
-
-### Generation Options
-
-**Image Options:**
-- maxResults: Number of images (default: 1)
-- style: Image style preset
-
-**Audio Options:**
-- voice: Voice type (male/female)
-- language: Language code ('tr-TR', 'en-US')
-- speed: Playback speed (default: 1.0)
-
-**Image Search Options:**
-- maxResults: Number of results (default: 5)
-
-### Integration with Card Creation
-
-Typical workflow:
-1. Generate media with useCardMediaGeneration
-2. Receive CardMediaAttachment objects
-3. Use in createCardMultimedia call
-4. Position is automatically assigned by generation type
-5. Complete card with generated media
-
-### Credit Costs
-
-| Operation | Credits |
-|-----------|---------|
-| Text-to-Image | 5 |
-| Text-to-Audio | 3 |
-| Image Search | 2 |
-
-### Error Scenarios
-
-- Insufficient credits: Check balance before generation
-- Invalid prompt: Validate text quality
-- API timeout: Implement retry logic
-- Content policy: Filter prompts appropriately
-- Service unavailable: Graceful error handling
-
-### Integration Requirements
-
-- Configure AI service endpoints
-- Implement authentication for AI APIs
-- Handle rate limiting and quotas
-- Implement retry logic for failures
-- Cache results when appropriate
-- Monitor credit usage
-
-## Dependencies
-
-- CardMediaGenerationService (infrastructure layer)
-- Domain types: CardMediaGenerationRequest, CardMediaGenerationResult, CardMediaAttachment
-- Credit tracking system
-- AI service APIs (text-to-image, TTS, image search)

package/src/media/presentation/hooks/useCardMediaUpload.README.md

@@ -1,153 +0,0 @@
-# useCardMediaUpload
-
-## Purpose
-Card-specific React hook for uploading flashcard media files to server with progress tracking and compression support.
-
-## File Location
-`src/presentation/hooks/useCardMediaUpload.ts`
-
-## Strategy
-- Provide card-specific media upload interface
-- Support compression options for optimization
-- Track upload progress with percentage and status
-- Return CardMediaAttachment with position property
-- Handle upload errors gracefully
-- Generate thumbnails for visual media
-- Support various media types for cards
-
-## Forbidden
-- **DO NOT** start upload while previous is in progress
-- **DO NOT** ignore compression options
-- **DO NOT** upload without validation (use useCardMediaValidation)
-- **DO NOT** mock upload in production without backend integration
-- **DO NOT** modify file during upload (compress before)
-- **DO NOT** assume upload will succeed
-- **DO NOT** use hardcoded API endpoints
-- **DO NOT** bypass progress tracking
-- **DO NOT** store upload results permanently in state
-- **DO NOT** use incorrect ID prefixes (must use card_media_)
-
-## Rules
-1. Always validate before uploading (use useCardMediaValidation)
-2. Compression quality must be in 0-1 range
-3. Dimensions must be in pixels
-4. Progress updates every 10% or on status change
-5. Clear upload state on error or completion
-6. Return CardMediaAttachment with position property
-7. Generate thumbnail URL automatically
-8. Calculate duration for audio/video
-9. Update progress status: uploading -> completed/error
-10. Include unique fileId in progress tracking
-
-## AI Agent Guidelines
-
-When working with useCardMediaUpload hook:
-
-1. **Type Correctness**: Returns CardMediaAttachment (not MediaAttachment)
-2. **Position Property**: Uploaded media includes position field
-3. **Pre-upload Validation**: Always use useCardMediaValidation first
-4. **Progress Tracking**: Monitor uploadProgress for real-time updates
-5. **Compression**: Apply appropriate compression settings
-
-### Upload Workflow
-
-1. Validate file with useCardMediaValidation
-2. Select compression options based on type and size
-3. Call uploadMedia with file and options
-4. Monitor uploadProgress state
-5. Handle completion (success or error)
-6. Process returned CardMediaAttachment
-
-### CardMediaAttachment Structure
-
-Returned object includes:
-- id: Unique ID with card_media_ prefix
-- type: CardMediaType (IMAGE, VIDEO, AUDIO)
-- position: CardMediaPosition (defaults to 'both')
-- url: Uploaded file URL
-- filename: Original filename
-- fileSize: Size in bytes
-- mimeType: MIME type string
-- duration: Audio/video duration
-- thumbnailUrl: Thumbnail for visual media
-- caption: Optional caption text
-- isDownloaded: Download status
-- createdAt: ISO timestamp
-
-### Compression Guidelines
-
-**High Quality** (quality: 0.9, maxWidth: 4096)
-- Use for detailed card images
-- Larger file size, best quality
-
-**Medium Quality** (quality: 0.7, maxWidth: 1920) - RECOMMENDED
-- Balanced quality and size
-- Good for most card media
-
-**Low Quality** (quality: 0.5, maxWidth: 1280)
-- Use for card thumbnails
-- Smallest size, reduced quality
-
-### Upload Progress States
-
-- **uploading**: Upload in progress (0-99%)
-- **completed**: Upload finished successfully (100%)
-- **error**: Upload failed with error message
-
-### CardMediaUploadProgress
-
-Progress object includes:
-- fileId: Unique file identifier
-- progress: Percentage (0-100)
-- status: Current state (uploading/completed/error)
-- url: Final URL when completed
-
-### Integration with Card Creation
-
-Typical workflow:
-1. Select or generate media
-2. Validate with useCardMediaValidation
-3. Upload with useCardMediaUpload
-4. Receive CardMediaAttachment with position
-5. Add to card media array
-6. Create card with useCardMultimediaFlashcard
-
-### Position Assignment
-
-Uploaded media gets position property:
-- Default: 'both' (shown on both sides)
-- Can be overridden: 'front' or 'back'
-- Used to control media display on card sides
-
-### Multiple File Upload
-
-For multiple media files:
-1. Upload files sequentially or in parallel
-2. Collect CardMediaAttachment objects
-3. Assign positions appropriately
-4. Add to card media array
-5. Track individual upload progress
-
-### Integration Requirements
-
-- Configure API endpoint for card media upload
-- Implement authentication for uploads
-- Handle file size limits
-- Support retry logic for failures
-- Generate thumbnails automatically
-- Calculate media duration for audio/video
-
-### Error Handling
-
-Common error scenarios:
-- File too large: Validate before upload
-- Unsupported type: Check MIME type
-- Network timeout: Implement retry with backoff
-- Server error: Display user-friendly message
-- Authentication failure: Check token validity
-
-## Dependencies
-
-- CardMediaUploadService (infrastructure layer)
-- Domain types: CardMediaAttachment, CardMediaCompressionOptions, CardMediaUploadProgress
-- useCardMediaValidation (for pre-upload validation)

package/src/media/presentation/hooks/useCardMediaUpload.ts

@@ -1,84 +0,0 @@
-/**
- * Card Media Upload Hook
- * Hook for uploading card media files
- */
-
-import { useState, useCallback } from "react";
-import { generateThumbnail, getMediaDuration } from "../../infrastructure/utils/file-media-utils";
-import { getMediaTypeFromMime } from "../../infrastructure/utils/mime-type-detector";
-import type { UseCardMediaUploadResult } from "./card-multimedia.types";
-import type {
-  CardMediaAttachment,
-  CardMediaCompressionOptions,
-  CardMediaFile,
-  CardMediaUploadProgress,
-} from "../../domain/entities/CardMultimedia.types";
-
-export const useCardMediaUpload = (): UseCardMediaUploadResult => {
-  const [isUploading, setIsUploading] = useState(false);
-  const [uploadProgress, setUploadProgress] =
-    useState<CardMediaUploadProgress | null>(null);
-  const [error, setError] = useState<string | null>(null);
-
-  const uploadMedia = useCallback(
-    async (file: CardMediaFile, _options?: CardMediaCompressionOptions) => {
-      try {
-        setIsUploading(true);
-        setError(null);
-
-        // Simulate upload progress
-        setUploadProgress({
-          fileId: `upload_${Date.now()}`,
-          progress: 0,
-          status: "uploading",
-        });
-
-        // Simulate progress updates
-        for (let i = 1; i <= 100; i += 10) {
-          await new Promise((resolve) => setTimeout(resolve, 50));
-          setUploadProgress((prev) => (prev ? { ...prev, progress: i } : null));
-        }
-
-        const attachment: CardMediaAttachment = {
-          id: `card_media_${Date.now()}`,
-          type: getMediaTypeFromMime(file.type),
-          position: "both",
-          url: `https://storage.example.com/media/${Date.now()}_${file.name}`,
-          filename: file.name,
-          fileSize: file.size || 100000,
-          mimeType: file.type,
-          duration: await getMediaDuration(file),
-          thumbnailUrl: generateThumbnail(file),
-          caption: "",
-          isDownloaded: true,
-          createdAt: new Date().toISOString(),
-        };
-
-        setUploadProgress({
-          fileId: `upload_${Date.now()}`,
-          progress: 100,
-          status: "completed",
-          url: attachment.url,
-        });
-
-        return attachment;
-      } catch (err) {
-        const errorMessage =
-          err instanceof Error ? err.message : "Upload failed";
-        setError(errorMessage);
-        setIsUploading(false);
-        throw err;
-      } finally {
-        setIsUploading(false);
-      }
-    },
-    [],
-  );
-
-  return {
-    uploadMedia,
-    isUploading,
-    uploadProgress,
-    error,
-  };
-};