import base64 import binascii import json import re from datetime import datetime from uuid import UUID from src.domain import Key, timestamp from src.errors import invalid def parse_uuid(value: str) -> UUID: 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() return UUID(value) def encode_cursor(*, scope: str, key: Key) -> str: payload = { "v": 1, "scope": scope, "at": timestamp(key[0]), "id": str(key[1]), } return ( base64.urlsafe_b64encode( json.dumps(payload, separators=(",", ":")).encode() ) .decode() .rstrip("=") ) def decode_cursor(*, value: str | None, scope: str) -> Key | None: if value is None: return None try: if ( not value or len(value) > 2048 or not re.fullmatch(r"[A-Za-z0-9_-]+", value) ): raise ValueError data = json.loads( base64.b64decode( value + "=" * (-len(value) % 4), altchars=b"-_", validate=True ) ) if ( not isinstance(data, dict) or type(data.get("v")) is not int or data["v"] != 1 or data.get("scope") != scope or not isinstance(data.get("at"), str) ): raise ValueError at = datetime.fromisoformat(data["at"]) if at.tzinfo is None or timestamp(at) != data["at"]: raise ValueError return at, parse_uuid(data["id"]) except ValueError, TypeError, KeyError, binascii.Error, RecursionError: raise invalid() from None