class ApiError(Exception): """Expected failure: the message never contains internal details.""" def __init__(self, status: int, code: str, message: str, challenge: str | None = None) -> None: super().__init__(message) self.status = status self.code = code self.message = message self.challenge = challenge def invalid_request(message: str) -> ApiError: return ApiError(400, 'invalid_request', message) def unauthorized(message: str, challenge: str) -> ApiError: return ApiError(401, 'unauthorized', message, challenge) def not_found(message: str) -> ApiError: return ApiError(404, 'not_found', message) def conflict(message: str) -> ApiError: return ApiError(409, 'conflict', message) def payload_too_large(message: str) -> ApiError: return ApiError(413, 'payload_too_large', message) def unsupported_media_type(message: str) -> ApiError: return ApiError(415, 'unsupported_media_type', message) def unavailable(message: str) -> ApiError: return ApiError(503, 'unavailable', message)