"""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("profile_id"), ColumnSpec("workflow_id"), ColumnSpec("node_id"), ColumnSpec("task_type", nullable=False), ColumnSpec("status", nullable=False), ColumnSpec("model_route"), ColumnSpec("progress", nullable=False), ColumnSpec("idempotency_key"), ColumnSpec("request_json"), ColumnSpec("result_json"), ColumnSpec("error_message"), ColumnSpec("metadata_json"), ), ), TableSpec( "generation_images", "image_id", ( ColumnSpec("image_id", nullable=False), ColumnSpec("profile_id"), ColumnSpec("workflow_id"), ColumnSpec("node_id"), ColumnSpec("task_id"), ColumnSpec("batch_id"), ColumnSpec("image_uri", nullable=False), ColumnSpec("thumbnail_uri"), ColumnSpec("positive_prompt"), ColumnSpec("negative_prompt"), ColumnSpec("model_used"), ColumnSpec("model_route"), ColumnSpec("is_selected", nullable=False), ColumnSpec("is_archived", nullable=False), ColumnSpec("metadata_json"), ), ), TableSpec( "workflow_history", "history_id", ( ColumnSpec("history_id", nullable=False), ColumnSpec("profile_id"), ColumnSpec("workflow_id", nullable=False), ColumnSpec("node_id"), ColumnSpec("image_id"), ColumnSpec("branch_name", nullable=False), ColumnSpec("action", nullable=False), ColumnSpec("title"), ColumnSpec("prompt"), ColumnSpec("metadata_json"), ), ), TableSpec( "workflow_branches", "branch_id", ( ColumnSpec("branch_id", nullable=False), ColumnSpec("workflow_id", nullable=False), ColumnSpec("branch_name", nullable=False), ColumnSpec("base_branch_name"), ColumnSpec("base_node_id"), ColumnSpec("status", nullable=False), ColumnSpec("metadata_json"), ), ), TableSpec( "workflow_generation_rounds", "round_id", ( ColumnSpec("round_id", nullable=False), ColumnSpec("workflow_id", nullable=False), ColumnSpec("node_id", nullable=False), ColumnSpec("branch_name", nullable=False), ColumnSpec("round_kind", nullable=False), ColumnSpec("round_number", nullable=False), ColumnSpec("display_code", nullable=False), ColumnSpec("parent_round_id"), ColumnSpec("status", nullable=False), ColumnSpec("requested_count", nullable=False), ColumnSpec("idempotency_key"), ColumnSpec("prompt_snapshot_json"), ColumnSpec("reference_snapshot_json"), ColumnSpec("feedback_snapshot_json"), ColumnSpec("metadata_json"), ), ), TableSpec( "workflow_generation_candidates", "candidate_id", ( ColumnSpec("candidate_id", nullable=False), ColumnSpec("origin_round_id", nullable=False), ColumnSpec("candidate_index", nullable=False), ColumnSpec("generation_status", nullable=False), ColumnSpec("image_id"), ColumnSpec("current_task_id"), ColumnSpec("source_candidate_id"), ColumnSpec("model_route"), ColumnSpec("provider_id"), ColumnSpec("provider_model"), ColumnSpec("prompt_snapshot_json"), ColumnSpec("failure_json"), ColumnSpec("metadata_json"), ), ), TableSpec( "workflow_round_candidate_pool", "round_id,candidate_id", ( ColumnSpec("round_id", nullable=False), ColumnSpec("candidate_id", nullable=False), ColumnSpec("display_index", nullable=False), ColumnSpec("display_code", nullable=False), ColumnSpec("pool_state", nullable=False), ColumnSpec("preference_status", nullable=False), ColumnSpec("preference_reason"), ColumnSpec("is_final", nullable=False), ColumnSpec("metadata_json"), ), ), TableSpec( "character_profile_cards", "card_id", ( ColumnSpec("card_id", nullable=False), ColumnSpec("profile_id", nullable=False), ColumnSpec("workflow_id", nullable=False), ColumnSpec("branch_name", nullable=False), ColumnSpec("version", nullable=False), ColumnSpec("status", nullable=False), ColumnSpec("persona_document", nullable=False), ColumnSpec("idempotency_key"), ColumnSpec("metadata_json"), ), ), TableSpec( "character_profile_card_assets", "asset_id", ( ColumnSpec("asset_id", nullable=False), ColumnSpec("card_id", nullable=False), ColumnSpec("asset_role", nullable=False), ColumnSpec("image_id", nullable=False), ColumnSpec("image_uri", nullable=False), ColumnSpec("metadata_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( "wardrobe_items", "wardrobe_item_id", ( ColumnSpec("wardrobe_item_id", nullable=False), ColumnSpec("profile_id", nullable=False), ColumnSpec("material_id", nullable=False), ColumnSpec("wardrobe_category", nullable=False), ColumnSpec("tags_json"), ColumnSpec("season"), ColumnSpec("style"), ColumnSpec("is_favorite", nullable=False), ColumnSpec("usage_count", nullable=False), ColumnSpec("last_used_at"), ), ), TableSpec( "integration_logs", "integration_log_id", ( ColumnSpec("integration_log_id", nullable=False), ColumnSpec("integration_name", nullable=False), ColumnSpec("action", nullable=False), ColumnSpec("status", nullable=False), ColumnSpec("request_json"), ColumnSpec("response_json"), ColumnSpec("error_message"), ), ), TableSpec( "backend_capability_profiles", "capability_profile_id", ( ColumnSpec("capability_profile_id", nullable=False), ColumnSpec("provider_id", nullable=False), ColumnSpec("model_id", nullable=False), ColumnSpec("dialect", nullable=False), ColumnSpec("status", nullable=False), ColumnSpec("capabilities_json"), ColumnSpec("probe_result_json"), ), ), 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_env_var", sensitive=True), ColumnSpec("api_key_secret_ref", sensitive=True), ColumnSpec("extra_headers_json", 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)