"""Валидация тел запросов и параметров вручную, без pydantic-моделей контракта.""" import base64 import re import uuid from typing import Any from .errors import ApiError USERNAME_RE = re.compile(r"\A[a-z0-9_]{3,32}\Z") def _is_blank(value: str) -> bool: return value.strip() == "" def require_object(body: Any) -> dict[str, Any]: if not isinstance(body, dict): raise ApiError(400, "invalid_request", "Тело запроса должно быть JSON-объектом") return body def reject_extra(body: dict[str, Any], allowed: set[str]) -> None: if set(body) - allowed: raise ApiError(400, "invalid_request", "Неизвестные поля в теле запроса") def validate_create_user(body: Any) -> tuple[str, str, str]: body = require_object(body) reject_extra(body, {"username", "display_name", "password"}) username = body.get("username") display_name = body.get("display_name") password = body.get("password") if not isinstance(username, str) or not USERNAME_RE.match(username): raise ApiError(400, "invalid_request", "Некорректный username") if not isinstance(display_name, str) or not (1 <= len(display_name) <= 100) or _is_blank(display_name): raise ApiError(400, "invalid_request", "Некорректный display_name") if not isinstance(password, str) or not (12 <= len(password) <= 128): raise ApiError(400, "invalid_request", "Пароль должен быть 12..128 символов") return username, display_name, password def validate_create_chat(body: Any, caller_id: str) -> tuple[str, list[str]]: body = require_object(body) reject_extra(body, {"title", "member_ids"}) title = body.get("title") member_ids = body.get("member_ids") if not isinstance(title, str) or not (1 <= len(title) <= 100) or _is_blank(title): raise ApiError(400, "invalid_request", "Некорректный title") if not isinstance(member_ids, list) or not (1 <= len(member_ids) <= 100): raise ApiError(400, "invalid_request", "member_ids должен быть непустым массивом") seen: set[str] = set() for mid in member_ids: if not isinstance(mid, str): raise ApiError(400, "invalid_request", "member_ids содержит не строку") try: uuid.UUID(mid) except ValueError: raise ApiError(400, "invalid_request", "member_ids содержит не UUID") if mid in seen: raise ApiError(400, "invalid_request", "member_ids содержит дубликаты") seen.add(mid) if caller_id not in seen: raise ApiError(400, "invalid_request", "Вызывающий должен входить в member_ids") return title, list(member_ids) def validate_create_message(body: Any) -> str: body = require_object(body) reject_extra(body, {"text"}) text = body.get("text") if not isinstance(text, str) or not (1 <= len(text) <= 4000) or _is_blank(text): raise ApiError(400, "invalid_request", "Некорректный text") return text def validate_chat_id(raw: str) -> str: """chat_id в пути должен быть UUID, иначе 400 invalid_request.""" try: uuid.UUID(raw) except (ValueError, TypeError): raise ApiError(400, "invalid_request", "Некорректный chat_id") return raw def parse_limit(raw: str | None, default: int = 50) -> int: if raw is None: return default try: value = int(raw) except (TypeError, ValueError): raise ApiError(400, "invalid_request", "limit должен быть целым числом") if not (1 <= value <= 100): raise ApiError(400, "invalid_request", "limit вне диапазона 1..100") return value def parse_cursor(raw: str | None, scope: str) -> tuple[str, str] | None: """Cursor — непрозрачная строка base64url от 'scope|created_at|id'. Cursor привязан к ресурсу (scope). Значения created_at/id — из БД, поэтому cursor переживает рестарт процесса. """ if raw is None: return None try: decoded = base64.urlsafe_b64decode(raw.encode("ascii")).decode("utf-8") except Exception: raise ApiError(400, "invalid_request", "Некорректный cursor") parts = decoded.split("|") if len(parts) != 3: raise ApiError(400, "invalid_request", "Некорректный cursor") cursor_scope, created_at, item_id = parts if cursor_scope != scope: raise ApiError(400, "invalid_request", "Некорректный cursor") if not created_at or not item_id: raise ApiError(400, "invalid_request", "Некорректный cursor") return created_at, item_id def encode_cursor(created_at: str, item_id: str, scope: str) -> str: raw = "|".join([scope, created_at, item_id]).encode("utf-8") return base64.urlsafe_b64encode(raw).decode("ascii")