Files
mtusi2026lab2/app/storage/sessions.py
T

47 lines
1.7 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
from datetime import datetime
from uuid import UUID
from sqlalchemy.orm import Session
from app.models.session import UserSession
from app.models.user import User
def create_session(
session: Session,
*,
user_id: UUID,
token_hash: str,
expires_at: datetime,
) -> UserSession:
"""INSERT сессии (хранится только хеш токена) и flush()."""
raise NotImplementedError("TODO")
def get_user_by_active_token_hash(
session: Session,
token_hash: str,
now: datetime,
) -> User | None:
"""Пользователь по хешу токена, если сессия действует.
Действует: revoked_at IS NULL AND expires_at > now. Один запрос с JOIN users.
Истёкший, отозванный и неизвестный токен неразличимы для вызывающего (None).
`now` передаётся параметром (а не SQL now()), чтобы тесты могли управлять временем.
"""
raise NotImplementedError("TODO")
def revoke_session(session: Session, token_hash: str, now: datetime) -> bool:
"""Помечает действующую сессию отозванной (revoked_at = now).
True — отозвана, False — такой действующей сессии нет (повторный logout -> 401).
Рекомендуется один атомарный UPDATE ... WHERE ... AND revoked_at IS NULL.
"""
raise NotImplementedError("TODO")
def delete_expired_sessions(session: Session, now: datetime) -> int:
"""(Необязательно) удаляет просроченные сессии, возвращает их число."""
raise NotImplementedError("TODO")