"""API error type and the JSON error envelope (TZ 2.8.2)."""

from __future__ import annotations

from typing import Any


class ApiError(Exception):
    def __init__(
        self,
        status: int,
        code: str,
        message: str = "",
        details: list[dict[str, Any]] | None = None,
        headers: dict[str, str] | None = None,
    ) -> None:
        super().__init__(f"{status} {code}: {message}")
        self.status = status
        self.code = code
        self.message = message or code.replace("_", " ").capitalize()
        self.details = details or []
        self.headers = headers or {}


def not_found(code: str = "NOT_FOUND", message: str = "Not found") -> ApiError:
    return ApiError(404, code, message)


def forbidden(code: str = "FORBIDDEN", message: str = "Forbidden") -> ApiError:
    return ApiError(403, code, message)


def error_body(
    code: str, message: str, details: list[dict[str, Any]] | None = None, request_id: str | None = None
) -> dict[str, Any]:
    return {"error": {"code": code, "message": message, "details": details or [], "request_id": request_id}}
