import base64 import binascii import hashlib import os import re import secrets from datetime import datetime, timedelta, timezone from argon2 import PasswordHasher from argon2.exceptions import InvalidHashError, VerifyMismatchError password_hasher = PasswordHasher( time_cost=3, memory_cost=65536, parallelism=4, ) def hash_password(password: str) -> str: return password_hasher.hash(password) def verify_password(password_hash: str, password: str) -> bool: try: return password_hasher.verify(password_hash, password) except (VerifyMismatchError, InvalidHashError): return False def parse_basic(authorization: str | None) -> tuple[str, str] | None: if not authorization: return None scheme, separator, credentials = authorization.partition(" ") if not separator or scheme.lower() != "basic": return None try: raw = base64.b64decode(credentials, validate=True) decoded = raw.decode("utf-8") username, password = decoded.split(":", 1) except (ValueError, UnicodeError, binascii.Error): return None if not re.fullmatch(r"[a-z0-9_]{3,32}", username): return None if not 12 <= len(password) <= 128: return None return username, password def parse_bearer(authorization: str | None) -> str | None: if not authorization: return None scheme, separator, token = authorization.partition(" ") if not separator or scheme.lower() != "bearer": return None if not re.fullmatch(r"[A-Za-z0-9._~+/-]+={0,2}", token) or len(token) > 512: return None return token def create_token() -> str: return secrets.token_urlsafe(32) def hash_token(token: str) -> str: return hashlib.sha256(token.encode("ascii")).hexdigest() def session_expiration() -> datetime: ttl = int(os.getenv("SESSION_TTL_SECONDS", "3600")) if ttl < 1: raise ValueError("SESSION_TTL_SECONDS must be positive") return datetime.now(timezone.utc) + timedelta(seconds=ttl) def format_datetime(value: datetime) -> str: return value.astimezone(timezone.utc).isoformat( timespec="microseconds" ).replace("+00:00", "Z")