"""Material library route handlers.""" from __future__ import annotations from typing import Any from backend.dto.common import ApiError, ErrorCode from backend.dto.material_dto import Material, MaterialListResult from backend.routes.common import handle_request from backend.routes.params import int_or_default, optional_str from backend.services.material_service import MaterialService from backend.services.material_analytics_service import MaterialAnalyticsService from backend.services.media_service import MediaService from backend.services.model_provider_bootstrap import sync_vision_provider_from_config 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_config_payload, 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), color=optional_str(params.get("color")), material_type=optional_str(params.get("material_type")), body_slot=optional_str(params.get("body_slot")), wear_layer=optional_str(params.get("wear_layer")), min_confidence=_optional_float(params.get("min_confidence")), confirmation_state=optional_str(params.get("confirmation_state")), ) return _serialize_material_list(result, signer) return handle_request(ctx, action) def material_analytics(ctx: RequestContext, service: MaterialAnalyticsService | None = None) -> dict: analytics = service or MaterialAnalyticsService(Database(load_database_settings())) return handle_request(ctx, lambda: (require_authenticated(ctx), analytics.summarize())[1]) 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 renormalize_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.renormalize_material(material_id, ctx), signer) return handle_request(ctx, action) def renormalize_materials_batch( ctx: RequestContext, payload: dict[str, Any] | None = None, 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.renormalize_batch(payload or {}, ctx) 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) config = load_config_payload() sync_vision_provider_from_config(model_provider_service, config) vision = config.get("vision") if isinstance(config.get("vision"), dict) else {} provider = vision.get("provider") if isinstance(vision.get("provider"), dict) else {} assignments = config.get("model_assignments") if isinstance(config.get("model_assignments"), dict) else {} recognition_prompts = config.get("recognition_prompts") if isinstance(config.get("recognition_prompts"), dict) else {} default_route = str(assignments.get("material_recognition") or provider.get("route_name") or vision.get("default_route") or "material_vlm").strip() return MaterialService( repository=MaterialRepository(database), audit_service=AuditService(database), vision_provider_factory=model_provider_runtime.vision_provider_for_route, default_recognition_route=default_route, recognition_prompt_config=recognition_prompts, ) 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 _optional_float(value: Any) -> float | None: if value in (None, ""): return None try: return float(value) except (TypeError, ValueError): raise ApiError(ErrorCode.VALIDATION_FAILED, "min_confidence must be a number", {"field": "min_confidence"}) from None 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