"""Request tracing: session_id (one visit) + trace_id (one operation) via contextvars. Middleware reads X-Session-ID (generated by the client per visit) and X-User-Id, mints a trace_id per request, and echoes both back as response headers so the frontend can correlate its own action log with the backend tracelog. """ from __future__ import annotations import time import uuid from starlette.middleware.base import BaseHTTPMiddleware from starlette.requests import Request from shared.logger import get_logger, session_var, trace_var, user_var log = get_logger("danagble.trace") SESSION_HEADER = "X-Session-ID" TRACE_HEADER = "X-Trace-ID" USER_HEADER = "X-User-Id" def new_id(n: int = 16) -> str: return uuid.uuid4().hex[:n] def get_trace_context() -> dict: return {"session_id": session_var.get(), "trace_id": trace_var.get(), "user_id": user_var.get()} def _user_from_token(request) -> str | None: """Attribute the trace to the JWT owner without a DB hit.""" try: from src.core.security import decode_token auth = request.headers.get("authorization", "") if not auth.lower().startswith("bearer "): return None payload = decode_token(auth.split(" ", 1)[1]) return (payload or {}).get("sub") except Exception: return None class TraceMiddleware(BaseHTTPMiddleware): async def dispatch(self, request: Request, call_next): session_id = request.headers.get(SESSION_HEADER, "") or new_id() trace_id = new_id() user_id = request.headers.get(USER_HEADER, "") or _user_from_token(request) or "anonymous" tok_s, tok_t, tok_u = (session_var.set(session_id), trace_var.set(trace_id), user_var.set(user_id)) start = time.perf_counter() response = None try: response = await call_next(request) response.headers[SESSION_HEADER] = session_id response.headers[TRACE_HEADER] = trace_id return response except Exception: log.error("request failed method=%s path=%s", request.method, request.url.path) raise finally: elapsed_ms = (time.perf_counter() - start) * 1000 log.info("request method=%s path=%s status=%s ms=%.1f", request.method, request.url.path, response.status_code if response is not None else "err", elapsed_ms) session_var.reset(tok_s) trace_var.reset(tok_t) user_var.reset(tok_u)