"""Material library route handlers.""" from __future__ import annotations from typing import Any from backend.dto.common import ApiError from backend.dto.material_dto import Material, MaterialListResult from backend.routes.common import handle_request from backend.services.material_service import MaterialService from backend.services.media_service import MediaService from backend.services.model_provider_runtime import ModelProviderRuntime from backend.services.model_provider_service import ModelProviderService from core.audit_service import AuditService from core.identity import RequestContext from core.security import require_authenticated, require_permission from database.db_helper import Database, load_database_settings from database.repositories.material_repository import MaterialRepository from database.repositories.model_provider_repository import ModelProviderRepository def list_material_categories( ctx: RequestContext, service: MaterialService | None = None, ) -> dict: material_service = service or _create_material_service() def action() -> list[dict[str, Any]]: require_authenticated(ctx) return [category.to_dict() for category in material_service.list_categories()] return handle_request(ctx, action) def create_material_category( ctx: RequestContext, payload: dict[str, Any], service: MaterialService | None = None, ) -> dict: material_service = service or _create_material_service() def action() -> dict[str, Any]: require_permission(ctx, "can_manage_materials") return material_service.create_category(payload, ctx).to_dict() return handle_request(ctx, action) def update_material_category( ctx: RequestContext, category_id: str, payload: dict[str, Any], service: MaterialService | None = None, ) -> dict: material_service = service or _create_material_service() def action() -> dict[str, Any]: require_permission(ctx, "can_manage_materials") return material_service.update_category(category_id, payload, ctx).to_dict() return handle_request(ctx, action) def delete_material_category( ctx: RequestContext, category_id: str, service: MaterialService | None = None, ) -> dict: material_service = service or _create_material_service() def action() -> dict[str, Any]: require_permission(ctx, "can_manage_materials") return material_service.delete_category(category_id, ctx).to_dict() return handle_request(ctx, action) def list_materials( ctx: RequestContext, query: dict[str, Any] | None = None, service: MaterialService | None = None, media_service: MediaService | None = None, ) -> dict: material_service = service or _create_material_service() signer = media_service or MediaService() params = query or {} def action() -> dict[str, Any]: require_authenticated(ctx) result = material_service.list_materials( category_id=_optional_str(params.get("category_id")), keyword=_optional_str(params.get("keyword")), page=_int_or_default(params.get("page"), 1), page_size=_int_or_default(params.get("page_size"), 30), ) return _serialize_material_list(result, signer) return handle_request(ctx, action) def create_material( ctx: RequestContext, payload: dict[str, Any], service: MaterialService | None = None, media_service: MediaService | None = None, ) -> dict: material_service = service or _create_material_service() signer = media_service or MediaService() def action() -> dict[str, Any]: require_permission(ctx, "can_manage_materials") return _serialize_material(material_service.create_material(payload, ctx), signer) return handle_request(ctx, action) def get_material( ctx: RequestContext, material_id: str, service: MaterialService | None = None, media_service: MediaService | None = None, ) -> dict: material_service = service or _create_material_service() signer = media_service or MediaService() def action() -> dict[str, Any]: require_authenticated(ctx) return _serialize_material(material_service.get_material(material_id), signer) return handle_request(ctx, action) def update_material( ctx: RequestContext, material_id: str, payload: dict[str, Any], service: MaterialService | None = None, media_service: MediaService | None = None, ) -> dict: material_service = service or _create_material_service() signer = media_service or MediaService() def action() -> dict[str, Any]: require_permission(ctx, "can_manage_materials") return _serialize_material(material_service.update_material(material_id, payload, ctx), signer) return handle_request(ctx, action) def delete_material( ctx: RequestContext, material_id: str, service: MaterialService | None = None, media_service: MediaService | None = None, ) -> dict: material_service = service or _create_material_service() signer = media_service or MediaService() def action() -> dict[str, Any]: require_permission(ctx, "can_manage_materials") return _serialize_material(material_service.delete_material(material_id, ctx), signer) return handle_request(ctx, action) def upload_material( ctx: RequestContext, payload: dict[str, Any], service: MaterialService | None = None, media_service: MediaService | None = None, ) -> dict: material_service = service or _create_material_service() signer = media_service or MediaService() def action() -> dict[str, Any]: require_permission(ctx, "can_manage_materials") return _serialize_material(material_service.upload_material(payload, ctx), signer) return handle_request(ctx, action) def recognize_material( ctx: RequestContext, material_id: str, service: MaterialService | None = None, media_service: MediaService | None = None, ) -> dict: material_service = service or _create_material_service() signer = media_service or MediaService() def action() -> dict[str, Any]: require_permission(ctx, "can_manage_materials") return _serialize_material(material_service.recognize_material(material_id, ctx), signer) return handle_request(ctx, action) def re_recognize_material( ctx: RequestContext, material_id: str, service: MaterialService | None = None, media_service: MediaService | None = None, ) -> dict: material_service = service or _create_material_service() signer = media_service or MediaService() def action() -> dict[str, Any]: require_permission(ctx, "can_manage_materials") return _serialize_material(material_service.re_recognize_material(material_id, ctx), signer) return handle_request(ctx, action) def confirm_material( ctx: RequestContext, material_id: str, payload: dict[str, Any], service: MaterialService | None = None, media_service: MediaService | None = None, ) -> dict: material_service = service or _create_material_service() signer = media_service or MediaService() def action() -> dict[str, Any]: require_permission(ctx, "can_manage_materials") return _serialize_material(material_service.confirm_material(material_id, payload, ctx), signer) return handle_request(ctx, action) def _create_material_service() -> MaterialService: database = Database(load_database_settings()) model_provider_service = ModelProviderService(ModelProviderRepository(database)) model_provider_runtime = ModelProviderRuntime(model_provider_service) return MaterialService( repository=MaterialRepository(database), audit_service=AuditService(database), vision_provider_factory=model_provider_runtime.vision_provider_for_route, ) def _serialize_material_list(result: MaterialListResult, media_service: MediaService) -> dict[str, Any]: payload = result.to_dict() payload["items"] = [_serialize_material(item, media_service) for item in result.items] return payload def _serialize_material(material: Material, media_service: MediaService) -> dict[str, Any]: payload = material.to_dict() payload["image_url"] = _signed_url(media_service, material.image_uri) payload["thumbnail_url"] = _signed_url(media_service, material.thumbnail_uri) return payload def _signed_url(media_service: MediaService, uri: str | None) -> str | None: if not uri: return None try: return media_service.sign_media(uri)["url"] except ApiError: return None def _optional_str(value: Any) -> str | None: if value is None: return None text = str(value).strip() return text or None def _int_or_default(value: Any, default: int) -> int: try: return int(value) except (TypeError, ValueError): return default