feat: local storage logic & endpoints

app/api/errors.py

@@ -12,6 +12,8 @@ from app.domain.errors import (
     DomainError,
     NotFoundError,
     PermissionDeniedError,
+    RangeNotSatisfiableError,
+    StorageError,
     ValidationError,
 )
 
@@ -25,6 +27,7 @@ _STATUS_BY_ERROR: dict[type[DomainError], int] = {
     AuthenticationError: status.HTTP_401_UNAUTHORIZED,
     PermissionDeniedError: status.HTTP_403_FORBIDDEN,
     DependencyUnavailableError: status.HTTP_503_SERVICE_UNAVAILABLE,
+    StorageError: status.HTTP_500_INTERNAL_SERVER_ERROR,
 }
 
 
@@ -33,6 +36,14 @@ def _error_body(code: str, message: str) -> dict[str, dict[str, str]]:
 
 
 def register_exception_handlers(app: FastAPI) -> None:
+    @app.exception_handler(RangeNotSatisfiableError)
+    async def _handle_range_error(_request: Request, exc: RangeNotSatisfiableError) -> JSONResponse:
+        return JSONResponse(
+            status_code=status.HTTP_416_REQUESTED_RANGE_NOT_SATISFIABLE,
+            content=_error_body(exc.code, exc.message),
+            headers={"Content-Range": f"bytes */{exc.total_size}"},
+        )
+
     @app.exception_handler(DomainError)
     async def _handle_domain_error(_request: Request, exc: DomainError) -> JSONResponse:
         http_status = _STATUS_BY_ERROR.get(type(exc), status.HTTP_400_BAD_REQUEST)