"""Непрозрачный keyset-курсор (created_at, id), привязанный к ресурсу.""" import base64 import json import uuid from datetime import datetime, timezone from .errors import bad_request def encode(kind, scope, created_at, row_id): payload = {"k": kind, "s": str(scope), "t": created_at.astimezone(timezone.utc).isoformat(), "i": str(row_id)} return base64.urlsafe_b64encode(json.dumps(payload, separators=(",", ":")).encode()).rstrip(b"=").decode() def decode(value, kind, scope): """Возвращает (created_at, id). Чужой чат/пользователь/вид курсора, пустая строка или мусор -> 400.""" if not value: # пустая строка -> 400 (minLength=1 в контракте) raise bad_request("Некорректный cursor") try: raw = base64.urlsafe_b64decode(value + "=" * (-len(value) % 4)) payload = json.loads(raw.decode("utf-8")) created_at = datetime.fromisoformat(payload["t"]) row_id = uuid.UUID(payload["i"]) if payload["k"] != kind or payload["s"] != str(scope) or created_at.tzinfo is None: raise ValueError("scope mismatch") return created_at, row_id except (ValueError, KeyError, TypeError, UnicodeDecodeError): raise bad_request("Некорректный cursor")