104 行
2.8 KiB
Python
104 行
2.8 KiB
Python
"""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()]
|