from datetime import datetime from sqlalchemy import JSON, Boolean, DateTime, String, func from sqlalchemy.orm import Mapped, mapped_column from backend.app.core.database import Base class APIKey(Base): """API key for external webhook access.""" __tablename__ = "api_keys" id: Mapped[int] = mapped_column(primary_key=True) name: Mapped[str] = mapped_column(String(100)) # User-friendly name key_hash: Mapped[str] = mapped_column(String(64)) # SHA256 hash of the key key_prefix: Mapped[str] = mapped_column(String(8)) # First 8 chars for identification # Permissions can_queue: Mapped[bool] = mapped_column(Boolean, default=True) # Add to queue can_control_printer: Mapped[bool] = mapped_column(Boolean, default=False) # Start/stop/cancel can_read_status: Mapped[bool] = mapped_column(Boolean, default=True) # Query status # Optional scope limits printer_ids: Mapped[list | None] = mapped_column(JSON, nullable=True) # null = all printers enabled: Mapped[bool] = mapped_column(Boolean, default=True) last_used: Mapped[datetime | None] = mapped_column(DateTime, nullable=True) created_at: Mapped[datetime] = mapped_column(DateTime, server_default=func.now()) expires_at: Mapped[datetime | None] = mapped_column(DateTime, nullable=True) # Optional expiry