import re from uuid import UUID class ApiError(Exception): def __init__(self, status, code, message, headers=None): super().__init__(message) self.status = status self.code = code self.headers = headers or {} def invalid(message): return ApiError(400, "invalid_request", message) def not_found(): return ApiError(404, "not_found", "Resource not found") def canonical_id(value): if not isinstance(value, str) or not re.fullmatch( r"[0-9a-fA-F]{8}(?:-[0-9a-fA-F]{4}){3}-[0-9a-fA-F]{12}", value ): raise invalid("Invalid UUID") return UUID(value) def require_fields(body, *fields): if not isinstance(body, dict) or body.keys() != set(fields): raise invalid("Invalid request fields") def require_text(value, maximum): if ( not isinstance(value, str) or not value.strip() or len(value) > maximum or "\x00" in value or re.search(r"[\ud800-\udfff]", value) ): raise invalid("Invalid text field") return value