from sqlalchemy import String, ForeignKey, func from sqlalchemy.orm import Mapped, mapped_column from datetime import datetime from typing import Optional from app.database import Base class BackupCode(Base): __tablename__ = "backup_codes" id: Mapped[int] = mapped_column(primary_key=True) user_id: Mapped[int] = mapped_column( ForeignKey("users.id", ondelete="CASCADE"), nullable=False, index=True ) # Argon2id hash of the plaintext recovery code — never store plaintext code_hash: Mapped[str] = mapped_column(String(255), nullable=False) # Null until redeemed; set to datetime.now() on successful use used_at: Mapped[Optional[datetime]] = mapped_column(nullable=True, default=None) created_at: Mapped[datetime] = mapped_column(default=func.now())