Skip to content

LLM-Driven Extraction of Unstructured Data — Built for API Deployments & ETL Pipeline Workflows

2.7 KB
Raw Blame
"""WebSocket emission views for internal API.

This module provides endpoints for workers to trigger WebSocket events
through the backend's SocketIO server.

Security Note:
- CSRF protection is disabled for internal service-to-service communication
- Authentication is handled by InternalAPIAuthMiddleware using Bearer tokens
- This endpoint is for worker → backend WebSocket event triggering only
"""

import json
import logging

from django.http import JsonResponse
from django.views.decorators.csrf import csrf_exempt
from django.views.decorators.http import require_http_methods

from utils.log_events import _emit_websocket_event

logger = logging.getLogger(__name__)


# CSRF exemption is safe here because:
# 1. Internal service-to-service communication (workers → backend)
# 2. Protected by InternalAPIAuthMiddleware Bearer token authentication
# 3. No browser sessions or cookies involved
# 4. Used for WebSocket event triggering, not state modification
@csrf_exempt
@require_http_methods(["POST"])
def emit_websocket(request):
    """Internal API endpoint for workers to emit WebSocket events.

    Expected payload:
    {
        "room": "session_id",
        "event": "logs:session_id",
        "data": {...}
    }

    Returns:
        JSON response with success/error status
    """
    try:
        # Parse request data (standard Django view)
        data = json.loads(request.body.decode("utf-8"))

        # Extract required fields
        room = data.get("room")
        event = data.get("event")
        message_data = data.get("data", {})

        # Validate required fields
        if not room or not event:
            return JsonResponse(
                {
                    "status": "error",
                    "message": "Missing required fields: room and event are required",
                },
                status=400,
            )

        # Emit the WebSocket event
        _emit_websocket_event(room=room, event=event, data=message_data)

        logger.debug(f"WebSocket event emitted: room={room}, event={event}")

        return JsonResponse(
            {
                "status": "success",
                "message": "WebSocket event emitted successfully",
                "room": room,
                "event": event,
            }
        )

    except json.JSONDecodeError as e:
        logger.error(f"Invalid JSON in WebSocket emission request: {e}")
        return JsonResponse(
            {"status": "error", "message": "Invalid JSON payload"}, status=400
        )
    except Exception as e:
        logger.error(f"Error emitting WebSocket event: {e}")
        return JsonResponse(
            {"status": "error", "message": f"Failed to emit WebSocket event: {str(e)}"},
            status=500,
        )