bmc_hub/app/services/email_activity_logger.py

"""
Email Activity Logger
Helper service for logging all email events
"""

import logging
from typing import Optional, Dict, Any
import json
from app.core.database import execute_query, execute_insert

logger = logging.getLogger(__name__)


class EmailActivityLogger:
    """Centralized email activity logging"""
    
    @staticmethod
    async def log(
        email_id: int,
        event_type: str,
        description: str,
        category: str = 'system',
        metadata: Optional[Dict[str, Any]] = None,
        user_id: Optional[int] = None,
        created_by: str = 'system'
    ) -> Optional[int]:
        """
        Log an email activity event
        
        Args:
            email_id: Email ID
            event_type: Type of event (fetched, classified, workflow_executed, etc.)
            description: Human-readable description
            category: Event category (system, user, workflow, rule, integration)
            metadata: Additional event data as dict
            user_id: User ID if user-triggered
            created_by: Who/what created this log entry
            
        Returns:
            Log ID or None on failure
        """
        try:
            metadata_json = json.dumps(metadata) if metadata else None
            
            log_id = execute_insert(
                """INSERT INTO email_activity_log 
                   (email_id, event_type, event_category, description, metadata, user_id, created_by)
                   VALUES (%s, %s, %s, %s, %s::jsonb, %s, %s)
                   RETURNING id""",
                (email_id, event_type, category, description, metadata_json, user_id, created_by)
            )
            
            logger.debug(f"📝 Logged email event: {event_type} for email {email_id}")
            return log_id
            
        except Exception as e:
            logger.error(f"❌ Failed to log email activity: {e}")
            return None
    
    @staticmethod
    async def log_fetched(email_id: int, source: str, message_id: str):
        """Log email fetch event"""
        return await EmailActivityLogger.log(
            email_id=email_id,
            event_type='fetched',
            category='system',
            description=f'Email fetched from {source}',
            metadata={'source': source, 'message_id': message_id}
        )
    
    @staticmethod
    async def log_classified(email_id: int, classification: str, confidence: float, method: str = 'ai'):
        """Log email classification"""
        return await EmailActivityLogger.log(
            email_id=email_id,
            event_type='classified',
            category='system',
            description=f'Classified as {classification} (confidence: {confidence:.2%})',
            metadata={
                'classification': classification,
                'confidence': confidence,
                'method': method
            }
        )
    
    @staticmethod
    async def log_workflow_executed(email_id: int, workflow_id: int, workflow_name: str, 
                                     status: str, steps_completed: int, execution_time_ms: int):
        """Log workflow execution"""
        return await EmailActivityLogger.log(
            email_id=email_id,
            event_type='workflow_executed',
            category='workflow',
            description=f'Workflow "{workflow_name}" {status} ({steps_completed} steps, {execution_time_ms}ms)',
            metadata={
                'workflow_id': workflow_id,
                'workflow_name': workflow_name,
                'status': status,
                'steps_completed': steps_completed,
                'execution_time_ms': execution_time_ms
            }
        )
    
    @staticmethod
    async def log_rule_matched(email_id: int, rule_id: int, rule_name: str, action_type: str):
        """Log rule match"""
        return await EmailActivityLogger.log(
            email_id=email_id,
            event_type='rule_matched',
            category='rule',
            description=f'Matched rule "{rule_name}" → action: {action_type}',
            metadata={
                'rule_id': rule_id,
                'rule_name': rule_name,
                'action_type': action_type
            }
        )
    
    @staticmethod
    async def log_status_changed(email_id: int, old_status: str, new_status: str, reason: Optional[str] = None):
        """Log status change"""
        desc = f'Status changed: {old_status} → {new_status}'
        if reason:
            desc += f' ({reason})'
        
        return await EmailActivityLogger.log(
            email_id=email_id,
            event_type='status_changed',
            category='system',
            description=desc,
            metadata={
                'old_status': old_status,
                'new_status': new_status,
                'reason': reason
            }
        )
    
    @staticmethod
    async def log_read(email_id: int, user_id: Optional[int] = None, username: Optional[str] = None):
        """Log email read"""
        return await EmailActivityLogger.log(
            email_id=email_id,
            event_type='read',
            category='user',
            description=f'Email read by {username or "user"}',
            metadata={'username': username},
            user_id=user_id,
            created_by=username or 'user'
        )
    
    @staticmethod
    async def log_attachment_action(email_id: int, filename: str, action: str = 'downloaded'):
        """Log attachment action"""
        return await EmailActivityLogger.log(
            email_id=email_id,
            event_type=f'attachment_{action}',
            category='user',
            description=f'Attachment {action}: {filename}',
            metadata={'filename': filename, 'action': action}
        )
    
    @staticmethod
    async def log_linked(email_id: int, entity_type: str, entity_id: int, entity_name: str):
        """Log entity linking"""
        return await EmailActivityLogger.log(
            email_id=email_id,
            event_type='linked',
            category='system',
            description=f'Linked to {entity_type}: {entity_name}',
            metadata={
                'entity_type': entity_type,
                'entity_id': entity_id,
                'entity_name': entity_name
            }
        )
    
    @staticmethod
    async def log_invoice_extracted(email_id: int, invoice_number: Optional[str], 
                                     amount: Optional[float], success: bool):
        """Log invoice data extraction"""
        desc = f'Invoice data extraction {"succeeded" if success else "failed"}'
        if success and invoice_number:
            desc += f' - #{invoice_number}'
        
        return await EmailActivityLogger.log(
            email_id=email_id,
            event_type='invoice_extracted',
            category='integration',
            description=desc,
            metadata={
                'success': success,
                'invoice_number': invoice_number,
                'amount': amount
            }
        )
    
    @staticmethod
    async def log_error(email_id: int, error_type: str, error_message: str, context: Optional[Dict] = None):
        """Log error event"""
        return await EmailActivityLogger.log(
            email_id=email_id,
            event_type='error',
            category='system',
            description=f'Error: {error_type} - {error_message}',
            metadata={
                'error_type': error_type,
                'error_message': error_message,
                'context': context
            }
        )


# Export singleton instance
email_activity_logger = EmailActivityLogger()