import re from fastapi import Request from fastapi.responses import JSONResponse from uuid import uuid4 from app.config import settings from app.lifecycle import draining class ApiError(Exception): def __init__( self, status_code: int, code: str, message: str, headers: dict[str, str] | None = None, ) -> None: self.status_code = status_code self.code = code self.message = message self.headers = headers or {} class InvalidRequest(ApiError): def __init__(self, message: str = "Invalid request.") -> None: super().__init__(400, "invalid_request", message) class Unauthorized(ApiError): def __init__(self, scheme: str = "Bearer") -> None: if scheme == "Basic": challenge = 'Basic realm="messenger", charset="UTF-8"' else: challenge = 'Bearer realm="messenger"' super().__init__( 401, "unauthorized", "Authentication is required.", {"WWW-Authenticate": challenge}, ) class NotFound(ApiError): def __init__(self, message: str = "Object not found.") -> None: super().__init__(404, "not_found", message) class Conflict(ApiError): def __init__(self, message: str = "Conflict.") -> None: super().__init__(409, "conflict", message) class Unavailable(ApiError): def __init__(self) -> None: super().__init__(503, "unavailable", "Service is unavailable.") class PayloadTooLarge(ApiError): def __init__(self, message: str = "Payload is too large.") -> None: super().__init__(413, "payload_too_large", message) class UnsupportedMediaType(ApiError): def __init__( self, message: str = "Only PNG and JPEG images are accepted.", ) -> None: super().__init__(415, "unsupported_media_type", message) class RateLimited(ApiError): def __init__(self, message: str, retry_after_seconds: int = 1) -> None: super().__init__( 429, "rate_limited", message, {"Retry-After": str(retry_after_seconds)}, ) # X-Request-Id from HAProxy (or the client) is reused only if it is short and # printable; anything else is replaced, so it cannot inject into logs. REQUEST_ID_PATTERN = re.compile(r"[A-Za-z0-9._:-]{1,128}") def incoming_request_id(request: Request) -> str: value = request.headers.get("X-Request-Id", "") if REQUEST_ID_PATTERN.fullmatch(value): return value return str(uuid4()) def request_id(request: Request) -> str: return getattr(request.state, "request_id", str(uuid4())) def common_headers(request: Request) -> dict[str, str]: """Headers of every API response, including errors (lab3: X-Instance-Id).""" headers = { "X-Request-Id": request_id(request), "X-Instance-Id": settings.instance_id, } if draining.is_set(): # Ask HAProxy not to reuse the connection to a replica that is stopping. headers["Connection"] = "close" return headers async def api_error_handler( request: Request, exc: ApiError, ) -> JSONResponse: rid = request_id(request) headers = { **common_headers(request), **exc.headers, } return JSONResponse( status_code=exc.status_code, content={ "error": { "code": exc.code, "message": exc.message, "request_id": rid, } }, headers=headers, )