"""Phase V: WebSocket endpoint for real-time multi-client sync.""" import logging from collections import defaultdict from typing import Dict, List from fastapi import APIRouter, WebSocket, WebSocketDisconnect logger = logging.getLogger(__name__) router = APIRouter(tags=["WebSocket"]) class ConnectionManager: def __init__(self): self._connections: Dict[str, List[WebSocket]] = defaultdict(list) async def connect(self, user_id: str, websocket: WebSocket): await websocket.accept() self._connections[user_id].append(websocket) logger.info("WS connected: user=%s total=%d", user_id, len(self._connections[user_id])) def disconnect(self, user_id: str, websocket: WebSocket): try: self._connections[user_id].remove(websocket) except ValueError: pass if not self._connections[user_id]: del self._connections[user_id] logger.info("WS disconnected: user=%s", user_id) async def send_to_user(self, user_id: str, message: dict): dead = [] for ws in self._connections.get(user_id, []): try: await ws.send_json(message) except Exception: dead.append(ws) for ws in dead: self.disconnect(user_id, ws) manager = ConnectionManager() @router.websocket("/ws/{user_id}") async def websocket_endpoint(websocket: WebSocket, user_id: str): await manager.connect(user_id, websocket) try: while True: # Keep alive — client sends pings await websocket.receive_text() except WebSocketDisconnect: manager.disconnect(user_id, websocket)