"""Short-lived confirmation requests for side-effecting operations.""" from __future__ import annotations import secrets import time from dataclasses import asdict, dataclass from typing import Any, Callable @dataclass(frozen=True, slots=True) class ConfirmationRequest: code: str session_origin: str user_id: str operation: str target: dict[str, Any] created_at: float expires_at: float class ConfirmationStore: """In-memory confirmation store bound to the originating session and user.""" def __init__( self, *, ttl: int = 120, clock: Callable[[], float] = time.time, ) -> None: self.ttl = max(int(ttl), 1) self._clock = clock self._requests: dict[str, ConfirmationRequest] = {} def _purge_expired(self) -> None: now = self._clock() expired = [ code for code, request in self._requests.items() if request.expires_at <= now ] for code in expired: self._requests.pop(code, None) def create( self, *, session_origin: str, user_id: str, operation: str, target: dict[str, Any], ) -> ConfirmationRequest: self._purge_expired() now = self._clock() code = secrets.token_hex(3) while code in self._requests: code = secrets.token_hex(3) request = ConfirmationRequest( code=code, session_origin=session_origin, user_id=user_id, operation=operation, target=target, created_at=now, expires_at=now + self.ttl, ) self._requests[code] = request return request def get( self, code: str, *, session_origin: str, user_id: str, ) -> ConfirmationRequest | None: self._purge_expired() request = self._requests.get(code.strip().lower()) if request is None: return None if request.session_origin != session_origin or request.user_id != user_id: return None return request def consume( self, code: str, *, session_origin: str, user_id: str, ) -> ConfirmationRequest | None: request = self.get(code, session_origin=session_origin, user_id=user_id) if request is None: return None self._requests.pop(request.code, None) return request def cancel(self, code: str) -> bool: self._purge_expired() return self._requests.pop(code.strip().lower(), None) is not None def snapshot(self) -> list[dict[str, Any]]: self._purge_expired() return [asdict(request) for request in self._requests.values()]