"""Safe deletion planners for media-backed records.""" from __future__ import annotations from typing import Any from backend.dto.common import ApiError, ErrorCode from backend.services.image_service import ImageService from backend.services.media_service import MediaService from core.identity import RequestContext class DeletionSafetyService: def __init__(self, image_service: ImageService, media_service: MediaService): self.image_service = image_service self.media_service = media_service def plan_image_delete(self, image_id: str, *, delete_files: bool = False) -> dict[str, Any]: image = self.image_service.get_image(image_id) files = [_file_entry(uri) for uri in (image.image_uri, image.thumbnail_uri) if uri] return { "target_type": "generation_image", "image_id": image.image_id, "metadata_delete": True, "delete_files": bool(delete_files), "requires_explicit_file_delete": not bool(delete_files), "files": [self._hydrate_entry(entry) for entry in files], } def delete_image( self, image_id: str, ctx: RequestContext, *, dry_run: bool = True, delete_files: bool = False, ) -> dict[str, Any]: plan = self.plan_image_delete(image_id, delete_files=delete_files) if dry_run: return {**plan, "dry_run": True, "status": "planned", "deleted_files": []} deleted_files = [] deleted = self.image_service.delete_image_metadata(image_id, ctx) if delete_files: for file_entry in plan["files"]: if self._delete_storage_file(str(file_entry["uri"])): deleted_files.append(file_entry["uri"]) return { **plan, "dry_run": False, "status": "completed", "deleted_image": deleted.to_dict(), "deleted_files": deleted_files, } def _hydrate_entry(self, entry: dict[str, Any]) -> dict[str, Any]: try: path = self.media_service.storage.resolve_uri(entry["uri"]) except ApiError: return {**entry, "exists": False, "bytes": 0} if path.exists() and not path.is_file(): raise ApiError(ErrorCode.FORBIDDEN, "refusing to delete non-file media path", {"uri": entry["uri"]}) return {**entry, "exists": path.exists(), "bytes": path.stat().st_size if path.exists() else 0} def _delete_storage_file(self, uri: str) -> bool: path = self.media_service.storage.resolve_uri(uri) if not path.exists(): return False if not path.is_file(): raise ApiError(ErrorCode.FORBIDDEN, "refusing to delete non-file media path", {"uri": uri}) path.unlink() return True def _file_entry(uri: str) -> dict[str, Any]: return {"uri": uri, "exists": False, "bytes": 0}