hf-data-engine/backend/services/websocket_service.py

"""
WebSocket Service
Handles real-time data updates to connected clients
"""
import asyncio
import json
import logging
from typing import Dict, Set, Any, List, Optional
from datetime import datetime
from fastapi import WebSocket, WebSocketDisconnect
from collections import defaultdict

logger = logging.getLogger(__name__)


class ConnectionManager:
    """Manages WebSocket connections and broadcasts"""

    def __init__(self):
        # Active connections by client ID
        self.active_connections: Dict[str, WebSocket] = {}

        # Subscriptions: {api_id: set(client_ids)}
        self.subscriptions: Dict[str, Set[str]] = defaultdict(set)

        # Reverse subscriptions: {client_id: set(api_ids)}
        self.client_subscriptions: Dict[str, Set[str]] = defaultdict(set)

        # Connection metadata
        self.connection_metadata: Dict[str, Dict[str, Any]] = {}

    async def connect(self, websocket: WebSocket, client_id: str, metadata: Optional[Dict] = None):
        """
        Connect a new WebSocket client

        Args:
            websocket: WebSocket connection
            client_id: Unique client identifier
            metadata: Optional metadata about the connection
        """
        await websocket.accept()
        self.active_connections[client_id] = websocket
        self.connection_metadata[client_id] = metadata or {}

        logger.info(f"Client {client_id} connected. Total connections: {len(self.active_connections)}")

    def disconnect(self, client_id: str):
        """
        Disconnect a WebSocket client

        Args:
            client_id: Client identifier
        """
        if client_id in self.active_connections:
            del self.active_connections[client_id]

        # Remove all subscriptions for this client
        for api_id in self.client_subscriptions.get(client_id, set()).copy():
            self.unsubscribe(client_id, api_id)

        if client_id in self.client_subscriptions:
            del self.client_subscriptions[client_id]

        if client_id in self.connection_metadata:
            del self.connection_metadata[client_id]

        logger.info(f"Client {client_id} disconnected. Total connections: {len(self.active_connections)}")

    def subscribe(self, client_id: str, api_id: str):
        """
        Subscribe a client to API updates

        Args:
            client_id: Client identifier
            api_id: API identifier to subscribe to
        """
        self.subscriptions[api_id].add(client_id)
        self.client_subscriptions[client_id].add(api_id)

        logger.debug(f"Client {client_id} subscribed to {api_id}")

    def unsubscribe(self, client_id: str, api_id: str):
        """
        Unsubscribe a client from API updates

        Args:
            client_id: Client identifier
            api_id: API identifier to unsubscribe from
        """
        if api_id in self.subscriptions:
            self.subscriptions[api_id].discard(client_id)

            # Clean up empty subscription sets
            if not self.subscriptions[api_id]:
                del self.subscriptions[api_id]

        if client_id in self.client_subscriptions:
            self.client_subscriptions[client_id].discard(api_id)

        logger.debug(f"Client {client_id} unsubscribed from {api_id}")

    def subscribe_all(self, client_id: str):
        """
        Subscribe a client to all API updates

        Args:
            client_id: Client identifier
        """
        self.client_subscriptions[client_id].add('*')
        logger.debug(f"Client {client_id} subscribed to all updates")

    async def send_personal_message(self, message: Dict[str, Any], client_id: str):
        """
        Send a message to a specific client

        Args:
            message: Message data
            client_id: Target client identifier
        """
        if client_id in self.active_connections:
            websocket = self.active_connections[client_id]
            try:
                await websocket.send_json(message)
            except Exception as e:
                logger.error(f"Error sending message to {client_id}: {e}")
                self.disconnect(client_id)

    async def broadcast(self, message: Dict[str, Any], api_id: Optional[str] = None):
        """
        Broadcast a message to subscribed clients

        Args:
            message: Message data
            api_id: Optional API ID (broadcasts to all if None)
        """
        if api_id:
            # Send to clients subscribed to this specific API
            target_clients = self.subscriptions.get(api_id, set())

            # Also include clients subscribed to all updates
            target_clients = target_clients.union(
                {cid for cid, subs in self.client_subscriptions.items() if '*' in subs}
            )
        else:
            # Broadcast to all connected clients
            target_clients = set(self.active_connections.keys())

        # Send to all target clients
        disconnected_clients = []

        for client_id in target_clients:
            if client_id in self.active_connections:
                websocket = self.active_connections[client_id]
                try:
                    await websocket.send_json(message)
                except Exception as e:
                    logger.error(f"Error broadcasting to {client_id}: {e}")
                    disconnected_clients.append(client_id)

        # Clean up disconnected clients
        for client_id in disconnected_clients:
            self.disconnect(client_id)

    async def broadcast_api_update(self, api_id: str, data: Dict[str, Any], metadata: Optional[Dict] = None):
        """
        Broadcast an API data update

        Args:
            api_id: API identifier
            data: Updated data
            metadata: Optional metadata about the update
        """
        message = {
            'type': 'api_update',
            'api_id': api_id,
            'data': data,
            'metadata': metadata or {},
            'timestamp': datetime.now().isoformat()
        }

        await self.broadcast(message, api_id)

    async def broadcast_status_update(self, status: Dict[str, Any]):
        """
        Broadcast a system status update

        Args:
            status: Status data
        """
        message = {
            'type': 'status_update',
            'status': status,
            'timestamp': datetime.now().isoformat()
        }

        await self.broadcast(message)

    async def broadcast_schedule_update(self, schedule_info: Dict[str, Any]):
        """
        Broadcast a schedule update

        Args:
            schedule_info: Schedule information
        """
        message = {
            'type': 'schedule_update',
            'schedule': schedule_info,
            'timestamp': datetime.now().isoformat()
        }

        await self.broadcast(message)

    def get_connection_stats(self) -> Dict[str, Any]:
        """
        Get connection statistics

        Returns:
            Statistics about connections and subscriptions
        """
        return {
            'total_connections': len(self.active_connections),
            'total_subscriptions': sum(len(subs) for subs in self.subscriptions.values()),
            'apis_with_subscribers': len(self.subscriptions),
            'clients': {
                client_id: {
                    'subscriptions': list(self.client_subscriptions.get(client_id, set())),
                    'metadata': self.connection_metadata.get(client_id, {})
                }
                for client_id in self.active_connections.keys()
            }
        }


class WebSocketService:
    """WebSocket service for real-time updates"""

    def __init__(self, scheduler_service=None, persistence_service=None):
        self.connection_manager = ConnectionManager()
        self.scheduler_service = scheduler_service
        self.persistence_service = persistence_service
        self.running = False

        # Register callbacks with scheduler if available
        if self.scheduler_service:
            self._register_scheduler_callbacks()

    def _register_scheduler_callbacks(self):
        """Register callbacks with the scheduler service"""
        # This would be called after scheduler is initialized
        # For now, we'll use a different approach where scheduler calls websocket service
        pass

    async def handle_client_message(self, websocket: WebSocket, client_id: str, message: Dict[str, Any]):
        """
        Handle incoming messages from clients

        Args:
            websocket: WebSocket connection
            client_id: Client identifier
            message: Message from client
        """
        try:
            message_type = message.get('type')

            if message_type == 'subscribe':
                # Subscribe to specific API
                api_id = message.get('api_id')
                if api_id:
                    self.connection_manager.subscribe(client_id, api_id)
                    await self.connection_manager.send_personal_message({
                        'type': 'subscribed',
                        'api_id': api_id,
                        'status': 'success'
                    }, client_id)

            elif message_type == 'subscribe_all':
                # Subscribe to all updates
                self.connection_manager.subscribe_all(client_id)
                await self.connection_manager.send_personal_message({
                    'type': 'subscribed',
                    'api_id': '*',
                    'status': 'success'
                }, client_id)

            elif message_type == 'unsubscribe':
                # Unsubscribe from specific API
                api_id = message.get('api_id')
                if api_id:
                    self.connection_manager.unsubscribe(client_id, api_id)
                    await self.connection_manager.send_personal_message({
                        'type': 'unsubscribed',
                        'api_id': api_id,
                        'status': 'success'
                    }, client_id)

            elif message_type == 'get_data':
                # Request current cached data
                api_id = message.get('api_id')
                if api_id and self.persistence_service:
                    data = self.persistence_service.get_cached_data(api_id)
                    await self.connection_manager.send_personal_message({
                        'type': 'data_response',
                        'api_id': api_id,
                        'data': data
                    }, client_id)

            elif message_type == 'get_all_data':
                # Request all cached data
                if self.persistence_service:
                    data = self.persistence_service.get_all_cached_data()
                    await self.connection_manager.send_personal_message({
                        'type': 'data_response',
                        'data': data
                    }, client_id)

            elif message_type == 'get_schedule':
                # Request schedule information
                if self.scheduler_service:
                    schedules = self.scheduler_service.get_all_task_statuses()
                    await self.connection_manager.send_personal_message({
                        'type': 'schedule_response',
                        'schedules': schedules
                    }, client_id)

            elif message_type == 'update_schedule':
                # Update schedule for an API
                api_id = message.get('api_id')
                interval = message.get('interval')
                enabled = message.get('enabled')

                if api_id and self.scheduler_service:
                    self.scheduler_service.update_task_schedule(api_id, interval, enabled)
                    await self.connection_manager.send_personal_message({
                        'type': 'schedule_updated',
                        'api_id': api_id,
                        'status': 'success'
                    }, client_id)

            elif message_type == 'force_update':
                # Force immediate update for an API
                api_id = message.get('api_id')
                if api_id and self.scheduler_service:
                    success = await self.scheduler_service.force_update(api_id)
                    await self.connection_manager.send_personal_message({
                        'type': 'update_result',
                        'api_id': api_id,
                        'status': 'success' if success else 'failed'
                    }, client_id)

            elif message_type == 'ping':
                # Heartbeat
                await self.connection_manager.send_personal_message({
                    'type': 'pong',
                    'timestamp': datetime.now().isoformat()
                }, client_id)

            else:
                logger.warning(f"Unknown message type from {client_id}: {message_type}")

        except Exception as e:
            logger.error(f"Error handling client message: {e}")
            await self.connection_manager.send_personal_message({
                'type': 'error',
                'message': str(e)
            }, client_id)

    async def notify_data_update(self, api_id: str, data: Dict[str, Any], metadata: Optional[Dict] = None):
        """
        Notify clients about data updates

        Args:
            api_id: API identifier
            data: Updated data
            metadata: Optional metadata
        """
        await self.connection_manager.broadcast_api_update(api_id, data, metadata)

    async def notify_status_update(self, status: Dict[str, Any]):
        """
        Notify clients about status updates

        Args:
            status: Status information
        """
        await self.connection_manager.broadcast_status_update(status)

    async def notify_schedule_update(self, schedule_info: Dict[str, Any]):
        """
        Notify clients about schedule updates

        Args:
            schedule_info: Schedule information
        """
        await self.connection_manager.broadcast_schedule_update(schedule_info)

    def get_stats(self) -> Dict[str, Any]:
        """Get WebSocket service statistics"""
        return self.connection_manager.get_connection_stats()


# Global instance
websocket_service = WebSocketService()