backend/scripts/multimodal_chat_routes.py

from datetime import datetime
import logging
import os
from typing import Any, Dict, List, Optional
import uuid
from fastapi import APIRouter, File, Form, HTTPException, UploadFile
from fastapi.responses import JSONResponse
from pydantic import BaseModel, Field

# Configure logging
logger = logging.getLogger(__name__)

# Initialize router
router = APIRouter()

# Configuration
UPLOAD_DIR = "uploads"
MAX_FILE_SIZE = 50 * 1024 * 1024  # 50MB
ALLOWED_FILE_TYPES = {
    "image": ["jpg", "jpeg", "png", "gif", "bmp", "webp"],
    "document": ["pdf", "doc", "docx", "txt", "md"],
    "spreadsheet": ["xls", "xlsx", "csv"],
    "presentation": ["ppt", "pptx"],
    "audio": ["mp3", "wav", "m4a", "ogg"],
    "video": ["mp4", "mov", "avi", "mkv"],
}


# Pydantic models
class FileUploadResponse(BaseModel):
    file_id: str = Field(..., description="Unique file identifier")
    filename: str = Field(..., description="Original filename")
    file_type: str = Field(..., description="File type category")
    file_size: int = Field(..., description="File size in bytes")
    upload_url: Optional[str] = Field(None, description="URL to access the file")
    processing_status: str = Field(..., description="Current processing status")
    analysis_result: Optional[Dict[str, Any]] = Field(
        None, description="File analysis results"
    )


class MultiModalMessage(BaseModel):
    message: str = Field(..., description="Text message content")
    user_id: str = Field(..., description="User identifier")
    file_ids: List[str] = Field(
        default_factory=list, description="List of attached file IDs"
    )
    context_id: Optional[str] = Field(
        None, description="Conversation context identifier"
    )
    message_type: str = Field("multimodal", description="Type of message")


class FileAnalysisResult(BaseModel):
    file_id: str = Field(..., description="File identifier")
    analysis_type: str = Field(..., description="Type of analysis performed")
    results: Dict[str, Any] = Field(..., description="Analysis results")
    confidence: Optional[float] = Field(None, description="Analysis confidence score")


# Ensure upload directory exists
def ensure_upload_dir():
    """Create upload directory if it doesn't exist"""
    if not os.path.exists(UPLOAD_DIR):
        os.makedirs(UPLOAD_DIR)
        logger.info(f"Created upload directory: {UPLOAD_DIR}")


def get_file_extension(filename: str) -> str:
    """Extract file extension from filename"""
    return filename.lower().split(".")[-1] if "." in filename else ""


def is_file_type_allowed(filename: str) -> tuple[bool, str]:
    """Check if file type is allowed and return file category"""
    extension = get_file_extension(filename)

    for category, extensions in ALLOWED_FILE_TYPES.items():
        if extension in extensions:
            return True, category

    return False, ""


def scan_file_for_threats(file_path: str) -> bool:
    """
    Basic file security scanning
    In production, integrate with proper antivirus/security scanning service
    """
    try:
        # Check file size
        file_size = os.path.getsize(file_path)
        if file_size > MAX_FILE_SIZE:
            return False

        # Basic file header validation
        with open(file_path, "rb") as f:
            header = f.read(100)  # Read first 100 bytes

            # Check for common malicious file signatures
            malicious_signatures = [
                b"\x4d\x5a",  # EXE files
                b"\x7f\x45\x4c\x46",  # ELF files
                b"\xca\xfe\xba\xbe",  # Java class files
            ]

            for signature in malicious_signatures:
                if header.startswith(signature):
                    return False

        return True
    except Exception as e:
        logger.error(f"Error scanning file {file_path}: {e}")
        return False


def analyze_image_file(file_path: str) -> Dict[str, Any]:
    """Analyze image file and extract information"""
    try:
        # In production, integrate with image analysis service (OpenCV, PIL, etc.)
        from PIL import ExifTags, Image
        import PIL.Image

        with Image.open(file_path) as img:
            width, height = img.size
            format_type = img.format
            mode = img.mode

            # Extract basic metadata
            metadata = {
                "dimensions": f"{width}x{height}",
                "format": format_type,
                "color_mode": mode,
                "file_size": os.path.getsize(file_path),
            }

            # Try to extract EXIF data
            try:
                exif_data = img._getexif()
                if exif_data:
                    exif = {}
                    for tag, value in exif_data.items():
                        decoded = ExifTags.TAGS.get(tag, tag)
                        exif[decoded] = value
                    metadata["exif"] = exif
            except Exception:
                pass

            return {
                "analysis_type": "image",
                "metadata": metadata,
                "description": f"Image: {width}x{height} {format_type}",
                "confidence": 0.95,
            }
    except ImportError:
        # Fallback if PIL is not available
        return {
            "analysis_type": "image",
            "metadata": {"file_size": os.path.getsize(file_path)},
            "description": "Image file (detailed analysis requires PIL)",
            "confidence": 0.7,
        }
    except Exception as e:
        logger.error(f"Error analyzing image {file_path}: {e}")
        return {
            "analysis_type": "image",
            "metadata": {"file_size": os.path.getsize(file_path)},
            "description": "Image file (analysis failed)",
            "confidence": 0.5,
        }


def analyze_document_file(file_path: str, file_extension: str) -> Dict[str, Any]:
    """Analyze document file and extract information"""
    try:
        file_size = os.path.getsize(file_path)

        # Basic document analysis
        if file_extension == "pdf":
            return {
                "analysis_type": "document",
                "document_type": "PDF",
                "file_size": file_size,
                "page_count": "Unknown",  # Would require PDF parsing library
                "description": "PDF document",
                "confidence": 0.8,
            }
        elif file_extension in ["doc", "docx"]:
            return {
                "analysis_type": "document",
                "document_type": "Word Document",
                "file_size": file_size,
                "description": "Microsoft Word document",
                "confidence": 0.8,
            }
        elif file_extension == "txt":
            # Basic text file analysis
            with open(file_path, "r", encoding="utf-8", errors="ignore") as f:
                content = f.read(1000)  # Read first 1000 characters
                line_count = len(content.split("\n"))
                word_count = len(content.split())

            return {
                "analysis_type": "document",
                "document_type": "Text File",
                "file_size": file_size,
                "line_count": line_count,
                "word_count": word_count,
                "preview": content[:200] + "..." if len(content) > 200 else content,
                "description": f"Text document ({word_count} words)",
                "confidence": 0.9,
            }
        else:
            return {
                "analysis_type": "document",
                "document_type": "Document",
                "file_size": file_size,
                "description": f"{file_extension.upper()} document",
                "confidence": 0.7,
            }
    except Exception as e:
        logger.error(f"Error analyzing document {file_path}: {e}")
        return {
            "analysis_type": "document",
            "document_type": "Unknown",
            "file_size": os.path.getsize(file_path),
            "description": "Document file (analysis failed)",
            "confidence": 0.5,
        }


def analyze_audio_file(file_path: str) -> Dict[str, Any]:
    """Analyze audio file and extract information"""
    try:
        file_size = os.path.getsize(file_path)

        # In production, integrate with audio processing library
        return {
            "analysis_type": "audio",
            "file_size": file_size,
            "duration": "Unknown",  # Would require audio processing library
            "sample_rate": "Unknown",
            "description": "Audio file",
            "confidence": 0.7,
        }
    except Exception as e:
        logger.error(f"Error analyzing audio {file_path}: {e}")
        return {
            "analysis_type": "audio",
            "file_size": os.path.getsize(file_path),
            "description": "Audio file (analysis failed)",
            "confidence": 0.5,
        }


def analyze_file(file_path: str, filename: str, file_category: str) -> Dict[str, Any]:
    """Analyze file based on its category"""
    extension = get_file_extension(filename)

    if file_category == "image":
        return analyze_image_file(file_path)
    elif file_category in ["document", "spreadsheet", "presentation"]:
        return analyze_document_file(file_path, extension)
    elif file_category == "audio":
        return analyze_audio_file(file_path)
    elif file_category == "video":
        return {
            "analysis_type": "video",
            "file_size": os.path.getsize(file_path),
            "description": "Video file",
            "confidence": 0.7,
        }
    else:
        return {
            "analysis_type": "unknown",
            "file_size": os.path.getsize(file_path),
            "description": f"File type: {file_category}",
            "confidence": 0.5,
        }


# File storage for tracking uploaded files (in production, use database)
file_registry = {}


@router.post("/api/v1/chat/upload", response_model=FileUploadResponse)
async def upload_file(
    file: UploadFile = File(...),
    user_id: str = Form(...),
    context_id: Optional[str] = Form(None),
):
    """
    Upload a file for multi-modal chat
    """
    try:
        ensure_upload_dir()

        # Validate file type
        is_allowed, file_category = is_file_type_allowed(file.filename)
        if not is_allowed:
            raise HTTPException(
                status_code=400,
                detail=f"File type not allowed. Supported types: {ALLOWED_FILE_TYPES}",
            )

        # Generate unique file ID
        file_id = str(uuid.uuid4())
        safe_filename = f"{file_id}_{file.filename}"
        file_path = os.path.join(UPLOAD_DIR, safe_filename)

        # Read file content and save
        content = await file.read()

        # Check file size
        if len(content) > MAX_FILE_SIZE:
            raise HTTPException(
                status_code=413,
                detail=f"File too large. Maximum size: {MAX_FILE_SIZE // (1024 * 1024)}MB",
            )

        # Save file
        with open(file_path, "wb") as f:
            f.write(content)

        # Security scanning
        if not scan_file_for_threats(file_path):
            os.remove(file_path)  # Clean up potentially malicious file
            raise HTTPException(status_code=400, detail="File failed security scan")

        # Analyze file
        analysis_result = analyze_file(file_path, file.filename, file_category)

        # Store file metadata
        file_metadata = {
            "file_id": file_id,
            "filename": file.filename,
            "file_path": file_path,
            "file_size": len(content),
            "file_category": file_category,
            "user_id": user_id,
            "context_id": context_id,
            "uploaded_at": datetime.now().isoformat(),
            "analysis_result": analysis_result,
            "processing_status": "completed",
        }

        file_registry[file_id] = file_metadata

        logger.info(f"File uploaded successfully: {file.filename} (ID: {file_id})")

        return FileUploadResponse(
            file_id=file_id,
            filename=file.filename,
            file_type=file_category,
            file_size=len(content),
            upload_url=f"/api/v1/chat/files/{file_id}",
            processing_status="completed",
            analysis_result=analysis_result,
        )

    except HTTPException:
        raise
    except Exception as e:
        logger.error(f"Error uploading file: {e}")
        raise HTTPException(status_code=500, detail="File upload failed")


@router.post("/api/v1/chat/multimodal", response_model=Dict[str, Any])
async def send_multimodal_message(message: MultiModalMessage):
    """
    Send a multi-modal chat message with file attachments
    """
    try:
        # Validate file attachments
        valid_files = []
        invalid_files = []

        for file_id in message.file_ids:
            if file_id in file_registry:
                file_metadata = file_registry[file_id]

                # Check if user owns the file
                if file_metadata["user_id"] != message.user_id:
                    invalid_files.append(file_id)
                    continue

                valid_files.append(
                    {
                        "file_id": file_id,
                        "filename": file_metadata["filename"],
                        "file_type": file_metadata["file_category"],
                        "analysis": file_metadata["analysis_result"],
                    }
                )
            else:
                invalid_files.append(file_id)

        # Process the multi-modal message
        response_data = {
            "response": f"Received your message with {len(valid_files)} file(s)",
            "context_id": message.context_id
            or f"ctx_{message.user_id}_{datetime.now().isoformat()}",
            "user_id": message.user_id,
            "attachments": valid_files,
            "invalid_files": invalid_files,
            "message_analysis": {
                "text_length": len(message.message),
                "file_count": len(valid_files),
                "has_attachments": len(valid_files) > 0,
            },
            "timestamp": datetime.now().isoformat(),
        }

        # Add file-specific responses
        if valid_files:
            file_descriptions = []
            for file_info in valid_files:
                analysis = file_info["analysis"]
                description = analysis.get("description", "File attachment")
                file_descriptions.append(f"- {file_info['filename']}: {description}")

            response_data["file_summary"] = "\n".join(file_descriptions)

        logger.info(
            f"Multi-modal message processed for user {message.user_id} with {len(valid_files)} files"
        )

        return response_data

    except Exception as e:
        logger.error(f"Error processing multi-modal message: {e}")
        raise HTTPException(status_code=500, detail="Message processing failed")


@router.get("/api/v1/chat/files/{file_id}")
async def get_file(file_id: str):
    """
    Retrieve an uploaded file
    """
    if file_id not in file_registry:
        raise HTTPException(status_code=404, detail="File not found")

    file_metadata = file_registry[file_id]
    file_path = file_metadata["file_path"]

    if not os.path.exists(file_path):
        raise HTTPException(status_code=404, detail="File not found on server")

    # In production, serve file with proper content-type headers
    return JSONResponse(
        {
            "file_id": file_id,
            "filename": file_metadata["filename"],
            "file_size": file_metadata["file_size"],
            "file_type": file_metadata["file_category"],
            "uploaded_at": file_metadata["uploaded_at"],
            "analysis_result": file_metadata["analysis_result"],
        }
    )


@router.get("/api/v1/chat/files/{file_id}/download")
async def download_file(file_id: str):
    """
    Download an uploaded file
    """
    if file_id not in file_registry:
        raise HTTPException(status_code=404, detail="File not found")

    file_metadata = file_registry[file_id]
    file_path = file_metadata["file_path"]

    if not os.path.exists(file_path):
        raise HTTPException(status_code=404, detail="File not found on server")

    # In production, implement proper file serving with content-disposition
    from fastapi.responses import FileResponse

    return FileResponse(
        path=file_path,
        filename=file_metadata["filename"],
        media_type="application/octet-stream",
    )


@router.delete("/api/v1/chat/files/{file_id}")
async def delete_file(file_id: str, user_id: str):
    """
    Delete an uploaded file
    """
    if file_id not in file_registry:
        raise HTTPException(status_code=404, detail="File not found")

    file_metadata = file_registry[file_id]

    # Check ownership
    if file_metadata["user_id"] != user_id:
        raise HTTPException(
            status_code=403, detail="Not authorized to delete this file"
        )

    file_path = file_metadata["file_path"]

    try:
        # Delete physical file
        if os.path.exists(file_path):
            os.remove(file_path)

        # Remove from registry
        del file_registry[file_id]

        logger.info(f"File deleted: {file_id}")

        return {"success": True, "message": "File deleted successfully"}

    except Exception as e:
        logger.error(f"Error deleting file {file_id}: {e}")
        raise HTTPException(status_code=500, detail="File deletion failed")


@router.get("/api/v1/chat/files")
async def list_user_files(user_id: str, limit: int = 50, offset: int = 0):
    """
    List files uploaded by a user
    """
    user_files = []

    for file_id, metadata in file_registry.items():
        if metadata["user_id"] == user_id:
            user_files.append(
                {
                    "file_id": file_id,
                    "filename": metadata["filename"],
                    "file_size": metadata["file_size"],
                    "file_type": metadata["file_category"],
                    "uploaded_at": metadata["uploaded_at"],
                    "processing_status": metadata["processing_status"],
                }
            )

    # Apply pagination
    start_idx = offset
    end_idx = offset + limit
    paginated_files = user_files[start_idx:end_idx]

    return {
        "files": paginated_files,
        "total_count": len(user_files),
        "offset": offset,
        "limit": limit,
    }