forked from mtusi2026/mtusi2026lab2
47 lines
1.7 KiB
Python
47 lines
1.7 KiB
Python
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")
|