"""Lightweight SQL table metadata for ImageStudio.""" from __future__ import annotations from dataclasses import dataclass, field @dataclass(frozen=True) class ColumnSpec: name: str nullable: bool = True sensitive: bool = False @dataclass(frozen=True) class TableSpec: name: str primary_key: str columns: tuple[ColumnSpec, ...] = field(default_factory=tuple) def column_names(self) -> list[str]: return [column.name for column in self.columns] def sensitive_columns(self) -> list[str]: return [column.name for column in self.columns if column.sensitive] TABLES: tuple[TableSpec, ...] = ( TableSpec( "character_profiles", "profile_id", ( ColumnSpec("profile_id", nullable=False), ColumnSpec("owner_user_id"), ColumnSpec("name", nullable=False), ColumnSpec("status", nullable=False), ColumnSpec("metadata_json"), ), ), TableSpec( "profile_workflows", "workflow_id", ( ColumnSpec("workflow_id", nullable=False), ColumnSpec("profile_id", nullable=False), ColumnSpec("workflow_type", nullable=False), ColumnSpec("status", nullable=False), ColumnSpec("current_node_id"), ), ), TableSpec( "workflow_nodes", "node_id", ( ColumnSpec("node_id", nullable=False), ColumnSpec("workflow_id", nullable=False), ColumnSpec("node_key", nullable=False), ColumnSpec("status", nullable=False), ColumnSpec("metadata_json"), ), ), TableSpec( "generation_tasks", "task_id", ( ColumnSpec("task_id", nullable=False), ColumnSpec("workflow_id"), ColumnSpec("node_id"), ColumnSpec("status", nullable=False), ColumnSpec("request_json"), ColumnSpec("result_json"), ), ), TableSpec( "material_categories", "category_id", ( ColumnSpec("category_id", nullable=False), ColumnSpec("name", nullable=False), ColumnSpec("parent_id"), ColumnSpec("category_type", nullable=False), ColumnSpec("sort_order", nullable=False), ), ), TableSpec( "materials", "material_id", ( ColumnSpec("material_id", nullable=False), ColumnSpec("category_id"), ColumnSpec("display_name", nullable=False), ColumnSpec("image_uri"), ColumnSpec("recognition_status", nullable=False), ), ), TableSpec( "audit_logs", "audit_id", ( ColumnSpec("audit_id", nullable=False), ColumnSpec("actor_id"), ColumnSpec("action", nullable=False), ColumnSpec("target_type", nullable=False), ColumnSpec("target_id"), ), ), TableSpec( "config_snapshots", "snapshot_id", ( ColumnSpec("snapshot_id", nullable=False), ColumnSpec("reason", nullable=False), ColumnSpec("actor_id"), ColumnSpec("config_json", nullable=False, sensitive=True), ), ), TableSpec( "model_providers", "provider_id", ( ColumnSpec("provider_id", nullable=False), ColumnSpec("display_name", nullable=False), ColumnSpec("provider_type", nullable=False), ColumnSpec("base_url", nullable=False), ColumnSpec("api_key_secret_ref", sensitive=True), ), ), TableSpec( "model_routes", "route_id", ( ColumnSpec("route_id", nullable=False), ColumnSpec("route_name", nullable=False), ColumnSpec("provider_id", nullable=False), ColumnSpec("model_id", nullable=False), ColumnSpec("modality", nullable=False), ), ), ) def table_spec(table_name: str) -> TableSpec | None: normalized = str(table_name or "").strip() return next((table for table in TABLES if table.name == normalized), None)