Update storage/media_routers.py

storage/media_routers.py

@@ -1,963 +1,1015 @@
-import os
-import io
-import shutil
-
-import sqlite3
-
-from pathlib import Path
-
-from fastapi import APIRouter, UploadFile, File, Query, HTTPException
-from fastapi.responses import FileResponse, JSONResponse
-
-
-from storage.files.file_manager import FileManager
-from storage.common import validate_token
-
-router = APIRouter(prefix="/media", tags=["Media Manager"])
-MEDIA_ROOT = Path("/data/media")
-file_manager = FileManager(MEDIA_ROOT)
-HF_TOKEN = os.getenv("HF_TOKEN")
-VALID_VERSIONS = ("Salamandra", "MoE")
-VALID_SUBTYPES = ("Original", "HITL OK", "HITL Test")
-AUDIO_EXTENSIONS = ["*.mp3", "*.wav", "*.aac", "*.m4a", "*.ogg", "*.flac"]
-
-
-@router.delete("/clear_media", tags=["Media Manager"])
-def clear_media(token: str = Query(..., description="Token required for authorization")):
-    """
-    Delete all contents of the /data/media folder.
-
-    Steps:
-    - Validate the token.
-    - Ensure the folder exists.
-    - Delete all files and subfolders inside /data/media.
-    - Return a JSON response confirming the deletion.
-
-    Warning: This will remove all stored videos, clips, and cast CSV files.
-    """
-    validate_token(token)
-
-    if not MEDIA_ROOT.exists() or not MEDIA_ROOT.is_dir():
-        raise HTTPException(status_code=404, detail="/data/media folder does not exist")
-
-    # Delete contents
-    for item in MEDIA_ROOT.iterdir():
-        try:
-            if item.is_dir():
-                shutil.rmtree(item)
-            else:
-                item.unlink()
-        except Exception as e:
-            raise HTTPException(status_code=500, detail=f"Failed to delete {item}: {e}")
-
-    return {"status": "ok", "message": "All media files deleted successfully"}
-
-@router.post("/upload_cast_csv", tags=["Media Manager"])
-async def upload_cast_csv(
-    sha1: str,
-    cast_file: UploadFile = File(...),
-    token: str = Query(..., description="Token required for authorization")
-):
-    """
-    Upload a cast CSV file for a specific video identified by its SHA-1.
-
-    The CSV will be stored under:
-        /data/media/<sha1>/cast/cast.csv
-
-    Steps:
-    - Validate the token.
-    - Ensure /data/media/<sha1> exists.
-    - Create /cast folder if missing.
-    - Save the CSV file inside /cast.
-    """
-    validate_token(token)
-
-    base_folder = MEDIA_ROOT / sha1
-    if not base_folder.exists() or not base_folder.is_dir():
-        raise HTTPException(status_code=404, detail="SHA1 folder not found")
-
-    cast_folder = base_folder / "cast"
-    cast_folder.mkdir(parents=True, exist_ok=True)
-
-    final_path = cast_folder / "cast.csv"
-
-    file_bytes = await cast_file.read()
-    save_result = file_manager.upload_file(io.BytesIO(file_bytes), final_path)
-    if not save_result["operation_success"]:
-        raise HTTPException(status_code=500, detail=save_result["error"])
-
-    return JSONResponse(
-        status_code=200,
-        content={"status": "ok", "saved_to": str(final_path)}
-    )
-
-
-@router.get("/download_cast_csv", tags=["Media Manager"])
-def download_cast_csv(
-    sha1: str,
-    token: str = Query(..., description="Token required for authorization")
-):
-    """
-    Download the cast CSV for a specific video identified by its SHA-1.
-
-    The CSV is expected under:
-        /data/media/<sha1>/cast/cast.csv
-
-    Steps:
-    - Validate the token.
-    - Ensure /data/media/<sha1> and /cast exist.
-    - Return the CSV as a FileResponse.
-    - Raise 404 if any folder or file is missing.
-    """
-    MEDIA_ROOT = Path("/data/media")
-    file_manager = FileManager(MEDIA_ROOT)
-    HF_TOKEN = os.getenv("HF_TOKEN")
-    validate_token(token)
-
-    base_folder = MEDIA_ROOT / sha1
-    cast_folder = base_folder / "cast"
-    csv_path = cast_folder / "cast.csv"
-
-    if not base_folder.exists() or not base_folder.is_dir():
-        raise HTTPException(status_code=404, detail="SHA1 folder not found")
-    if not cast_folder.exists() or not cast_folder.is_dir():
-        raise HTTPException(status_code=404, detail="Cast folder not found")
-    if not csv_path.exists() or not csv_path.is_file():
-        raise HTTPException(status_code=404, detail="Cast CSV not found")
-
-    # Convert to relative path for FileManager
-    relative_path = csv_path.relative_to(MEDIA_ROOT)
-    handler = file_manager.get_file(relative_path)
-    if handler is None:
-        raise HTTPException(status_code=404, detail="Cast CSV not accessible")
-    handler.close()
-
-    return FileResponse(
-        path=csv_path,
-        media_type="text/csv",
-        filename="cast.csv"
-    )
-
-@router.post("/upload_original_video", tags=["Media Manager"])
-async def upload_video(
-    video: UploadFile = File(...),
-    token: str = Query(..., description="Token required for authorization")
-):
-    """
-    Saves an uploaded video by hashing it with SHA1 and placing it under:
-    /data/media/<sha1>/clip/<original_filename>
-
-    Behavior:
-    - Compute SHA1 of the uploaded video.
-    - Ensure folder structure exists.
-    - Delete any existing .mp4 files under /clip.
-    - Save the uploaded video in the clip folder.
-    """
-    MEDIA_ROOT = Path("/data/media")
-    file_manager = FileManager(MEDIA_ROOT)
-    HF_TOKEN = os.getenv("HF_TOKEN")
-    validate_token(token)
-
-    # Read content into memory (needed to compute hash twice)
-    file_bytes = await video.read()
-
-    # Create an in-memory file handler for hashing
-    file_handler = io.BytesIO(file_bytes)
-
-    # Compute SHA1
-    try:
-        sha1 = file_manager.compute_sha1(file_handler)
-    except Exception as exc:
-        raise HTTPException(status_code=500, detail=f"SHA1 computation failed: {exc}")
-
-    # Ensure /data/media exists
-    MEDIA_ROOT.mkdir(parents=True, exist_ok=True)
-
-    # Path: /data/media/<sha1>
-    video_root = MEDIA_ROOT / sha1
-    video_root.mkdir(parents=True, exist_ok=True)
-
-    # Path: /data/media/<sha1>/clip
-    clip_dir = video_root / "clip"
-    clip_dir.mkdir(parents=True, exist_ok=True)
-
-    # Delete old MP4 files
-    try:
-        for old_mp4 in clip_dir.glob("*.mp4"):
-            old_mp4.unlink()
-    except Exception as exc:
-        raise HTTPException(status_code=500, detail=f"Failed to delete old videos: {exc}")
-
-    # Save new video path
-    final_path = clip_dir / video.filename
-
-    # Save file
-    save_result = file_manager.upload_file(io.BytesIO(file_bytes), final_path)
-
-    if not save_result["operation_success"]:
-        raise HTTPException(status_code=500, detail=save_result["error"])
-
-    return JSONResponse(
-        status_code=200,
-        content={
-            "status": "ok",
-            "sha1": sha1,
-            "saved_to": str(final_path)
-        }
-    )
-
-
-@router.get("/download_original_video", tags=["Media Manager"])
-def download_video(
-    sha1: str,
-    token: str = Query(..., description="Token required for authorization")
-    ):
-    """
-    Download a stored video by its SHA-1 directory name.
-
-    This endpoint looks for a video stored under the path:
-        /data/media/<sha1>/clip/
-    and returns the first MP4 file found in that folder.
-
-    The method performs the following steps:
-    - Checks if the SHA-1 folder exists inside the media root.
-    - Validates that the "clip" subfolder exists.
-    - Searches for the first .mp4 file inside the clip folder.
-    - Uses the FileManager.get_file method to ensure the file is accessible.
-    - Returns the video directly as a FileResponse.
-
-    Parameters
-    ----------
-    sha1 : str
-        The SHA-1 hash corresponding to the directory where the video is stored.
-
-    Returns
-    -------
-    FileResponse
-        A streaming response containing the MP4 video.
-
-    Raises
-    ------
-    HTTPException
-        - 404 if the SHA-1 folder does not exist.
-        - 404 if the clip folder is missing.
-        - 404 if no MP4 files are found.
-        - 404 if the file cannot be retrieved using FileManager.
-    """
-    MEDIA_ROOT = Path("/data/media")
-    file_manager = FileManager(MEDIA_ROOT)
-    HF_TOKEN = os.getenv("HF_TOKEN")
-    validate_token(token)
-
-    sha1_folder = MEDIA_ROOT / sha1
-    clip_folder = sha1_folder / "clip"
-
-    if not sha1_folder.exists() or not sha1_folder.is_dir():
-        raise HTTPException(status_code=404, detail="SHA1 folder not found")
-
-    if not clip_folder.exists() or not clip_folder.is_dir():
-        raise HTTPException(status_code=404, detail="Clip folder not found")
-
-    # Find first MP4 file
-    mp4_files = list(clip_folder.glob("*.mp4"))
-    if not mp4_files:
-        raise HTTPException(status_code=404, detail="No MP4 files found")
-
-    video_path = mp4_files[0]
-
-    # Convert to relative path for FileManager
-    relative_path = video_path.relative_to(MEDIA_ROOT)
-
-    handler = file_manager.get_file(relative_path)
-    if handler is None:
-        raise HTTPException(status_code=404, detail="Video not accessible")
-
-    handler.close()
-
-    return FileResponse(
-        path=video_path,
-        media_type="video/mp4",
-        filename=video_path.name
-    )
-
-
-@router.post("/upload_video_ad", tags=["Media Manager"])
-async def upload_video_ad(
-    sha1: str = Query(..., description="SHA1 associated to the media folder"),
-    version: str = Query(..., description="Version: Salamandra or MoE"),
-    subtype: str = Query(..., description="Subtype: Original, HITL OK or HITL Test"),
-    video: UploadFile = File(...),
-    token: str = Query(..., description="Token required for authorization")
-):
-    validate_token(token)
-
-    if version not in VALID_VERSIONS:
-        raise HTTPException(status_code=400, detail="Invalid version")
-    if subtype not in VALID_SUBTYPES:
-        raise HTTPException(status_code=400, detail="Invalid subtype")
-
-    MEDIA_ROOT = Path("/data/media")
-    file_manager = FileManager(MEDIA_ROOT)
-
-    subtype_dir = MEDIA_ROOT / sha1 / version / subtype
-    subtype_dir.mkdir(parents=True, exist_ok=True)
-
-    for f in subtype_dir.glob("*.mp4"):
-        f.unlink()
-
-    file_bytes = await video.read()
-    final_path = subtype_dir / video.filename
-
-    save_result = file_manager.upload_file(io.BytesIO(file_bytes), final_path)
-    if not save_result["operation_success"]:
-        raise HTTPException(status_code=500, detail=save_result["error"])
-
-    return {
-        "status": "ok",
-        "sha1": sha1,
-        "version": version,
-        "subtype": subtype,
-        "saved_to": str(final_path)
-    }
-
-
-@router.get("/download_video_ad", tags=["Media Manager"])
-def download_video_ad(
-    sha1: str,
-    version: str,
-    subtype: str,
-    token: str = Query(..., description="Token required for authorization")
-):
-    validate_token(token)
-
-    if version not in VALID_VERSIONS:
-        raise HTTPException(status_code=400, detail="Invalid version")
-    if subtype not in VALID_SUBTYPES:
-        raise HTTPException(status_code=400, detail="Invalid subtype")
-
-    MEDIA_ROOT = Path("/data/media")
-    file_manager = FileManager(MEDIA_ROOT)
-
-    subtype_dir = MEDIA_ROOT / sha1 / version / subtype
-
-    if not subtype_dir.exists() or not subtype_dir.is_dir():
-        raise HTTPException(status_code=404, detail="Version/subtype folder not found")
-
-    mp4_files = list(subtype_dir.glob("*.mp4"))
-    if not mp4_files:
-        raise HTTPException(status_code=404, detail="No MP4 files found")
-
-    video_path = mp4_files[0]
-    relative_path = video_path.relative_to(MEDIA_ROOT)
-
-    handler = file_manager.get_file(relative_path)
-    if handler is None:
-        raise HTTPException(status_code=404, detail="Video not accessible")
-
-    handler.close()
-
-    return FileResponse(
-        path=video_path,
-        media_type="video/mp4",
-        filename=video_path.name
-    )
-
-@router.get("/list_original_videos", tags=["Media Manager"])
-def list_all_videos(
-    token: str = Query(..., description="Token required for authorization")
-):
-    """
-    List all videos stored under /data/media.
-
-    For each SHA1 folder, the endpoint returns:
-    - sha1: folder name
-    - video_files: list of mp4 files inside /clip
-    - latest_video: the most recently modified mp4
-    - video_count: total number of mp4 files
-
-    Notes:
-    - Videos may not have a /clip folder.
-    - SHA1 folders without mp4 files are still returned.
-    """
-    validate_token(token)
-
-    results = []
-
-    # If media root does not exist, return empty list
-    if not MEDIA_ROOT.exists():
-        return []
-
-    for sha1_dir in MEDIA_ROOT.iterdir():
-        if not sha1_dir.is_dir():
-            continue  # skip non-folders
-
-        clip_dir = sha1_dir / "clip"
-
-        videos = []
-        latest_video = None
-
-        if clip_dir.exists() and clip_dir.is_dir():
-            mp4_files = list(clip_dir.glob("*.mp4"))
-
-            # Sort by modification time (newest first)
-            mp4_files.sort(key=lambda f: f.stat().st_mtime, reverse=True)
-
-            videos = [f.name for f in mp4_files]
-
-            if mp4_files:
-                latest_video = mp4_files[0].name
-
-        results.append({
-            "sha1": sha1_dir.name,
-            "video_name": latest_video
-        })
-
-    return results
-
-@router.post("/upload_original_audio", tags=["Media Manager"])
-async def upload_audio(
-    audio: UploadFile = File(...),
-    token: str = Query(..., description="Token required for authorization")
-):
-    """
-    Saves an uploaded audio file by hashing it with SHA1 and placing it under:
-    /data/media/<sha1>/audio/<original_filename>
-
-    Behavior:
-    - Compute SHA1 of the uploaded audio.
-    - Ensure folder structure exists.
-    - Delete any existing audio files under /audio.
-    - Save the uploaded audio in the audio folder.
-    """
-    MEDIA_ROOT = Path("/data/media")
-    file_manager = FileManager(MEDIA_ROOT)
-    HF_TOKEN = os.getenv("HF_TOKEN")
-    validate_token(token)
-
-    # Read content into memory (needed to compute hash twice)
-    file_bytes = await audio.read()
-
-    # Create an in-memory file handler for hashing
-    file_handler = io.BytesIO(file_bytes)
-
-    # Compute SHA1
-    try:
-        sha1 = file_manager.compute_sha1(file_handler)
-    except Exception as exc:
-        raise HTTPException(status_code=500, detail=f"SHA1 computation failed: {exc}")
-
-    # Ensure /data/media exists
-    MEDIA_ROOT.mkdir(parents=True, exist_ok=True)
-
-    # Path: /data/media/<sha1>
-    audio_root = MEDIA_ROOT / sha1
-    audio_root.mkdir(parents=True, exist_ok=True)
-
-    # Path: /data/media/<sha1>/audio
-    audio_dir = audio_root / "audio"
-    audio_dir.mkdir(parents=True, exist_ok=True)
-
-    # Delete old audio files
-    AUDIO_EXTENSIONS = ("*.mp3", "*.wav", "*.m4a", "*.aac", "*.ogg", "*.flac")
-    try:
-        for pattern in AUDIO_EXTENSIONS:
-            for old_audio in audio_dir.glob(pattern):
-                old_audio.unlink()
-    except Exception as exc:
-        raise HTTPException(status_code=500, detail=f"Failed to delete old audio files: {exc}")
-
-    # Final save path
-    final_path = audio_dir / audio.filename
-
-    # Save file
-    save_result = file_manager.upload_file(io.BytesIO(file_bytes), final_path)
-
-    if not save_result["operation_success"]:
-        raise HTTPException(status_code=500, detail=save_result["error"])
-
-    return JSONResponse(
-        status_code=200,
-        content={
-            "status": "ok",
-            "sha1": sha1,
-            "saved_to": str(final_path)
-        }
-    )
-
-@router.get("/download_original_audio", tags=["Media Manager"])
-def download_audio(
-    sha1: str,
-    token: str = Query(..., description="Token required for authorization")
-    ):
-    """
-    Download a stored audio file by its SHA-1 directory name.
-
-    This endpoint looks for audio stored under the path:
-        /data/media/<sha1>/audio/
-    and returns the first audio file found in that folder.
-
-    The method performs the following steps:
-    - Checks if the SHA-1 folder exists inside the media root.
-    - Validates that the "audio" subfolder exists.
-    - Searches for the first supported audio file.
-    - Uses FileManager.get_file to ensure the file is accessible.
-    - Returns the audio file as a FileResponse.
-
-    Parameters
-    ----------
-    sha1 : str
-        The SHA-1 hash corresponding to the directory where the audio is stored.
-
-    Returns
-    -------
-    FileResponse
-        A streaming response containing the audio file.
-
-    Raises
-    ------
-    HTTPException
-        - 404 if the SHA-1 folder does not exist.
-        - 404 if the audio folder is missing.
-        - 404 if no audio files are found.
-        - 404 if the file cannot be retrieved using FileManager.
-    """
-    MEDIA_ROOT = Path("/data/media")
-    file_manager = FileManager(MEDIA_ROOT)
-    HF_TOKEN = os.getenv("HF_TOKEN")
-    validate_token(token)
-
-    sha1_folder = MEDIA_ROOT / sha1
-    audio_folder = sha1_folder / "audio"
-
-    if not sha1_folder.exists() or not sha1_folder.is_dir():
-        raise HTTPException(status_code=404, detail="SHA1 folder not found")
-
-    if not audio_folder.exists() or not audio_folder.is_dir():
-        raise HTTPException(status_code=404, detail="Audio folder not found")
-
-    # Supported audio extensions
-    AUDIO_EXTENSIONS = ["*.mp3", "*.wav", "*.aac", "*.m4a", "*.ogg", "*.flac"]
-
-    audio_files = []
-    for pattern in AUDIO_EXTENSIONS:
-        audio_files.extend(list(audio_folder.glob(pattern)))
-
-    if not audio_files:
-        raise HTTPException(status_code=404, detail="No audio files found")
-
-    audio_path = audio_files[0]
-
-    # Convert to relative path for FileManager
-    relative_path = audio_path.relative_to(MEDIA_ROOT)
-
-    handler = file_manager.get_file(relative_path)
-    if handler is None:
-        raise HTTPException(status_code=404, detail="Audio file not accessible")
-
-    handler.close()
-
-    # Guess media type based on extension (simple)
-    media_type = "audio/" + audio_path.suffix.lstrip(".")
-
-    return FileResponse(
-        path=audio_path,
-        media_type=media_type,
-        filename=audio_path.name
-    )
-
-@router.get("/list_original_audios", tags=["Media Manager"])
-def list_all_audios(
-    token: str = Query(..., description="Token required for authorization")
-):
-    """
-    List all audio files stored under /data/media.
-
-    For each SHA1 folder, the endpoint returns:
-    - sha1: folder name
-    - audio_files: list of audio files inside /audio
-    - latest_audio: the most recently modified audio file
-    - audio_count: total number of audio files
-
-    Notes:
-    - Folders may not have an /audio folder.
-    - SHA1 folders without audio files are still returned.
-    """
-    validate_token(token)
-
-    results = []
-
-    MEDIA_ROOT = Path("/data/media")
-    AUDIO_EXTENSIONS = ["*.mp3", "*.wav", "*.aac", "*.m4a", "*.ogg", "*.flac"]
-
-    # If media root does not exist, return empty list
-    if not MEDIA_ROOT.exists():
-        return []
-
-    for sha1_dir in MEDIA_ROOT.iterdir():
-        if not sha1_dir.is_dir():
-            continue  # skip non-folders
-
-        audio_dir = sha1_dir / "audio"
-
-        audio_files = []
-        latest_audio = None
-
-        if audio_dir.exists() and audio_dir.is_dir():
-            # Collect all audio files with supported extensions
-            files = []
-            for pattern in AUDIO_EXTENSIONS:
-                files.extend(list(audio_dir.glob(pattern)))
-
-            # Sort by modification time (newest first)
-            files.sort(key=lambda f: f.stat().st_mtime, reverse=True)
-
-            audio_files = [f.name for f in files]
-
-            if files:
-                latest_audio = files[0].name
-
-        results.append({
-            "sha1": sha1_dir.name,
-            "audio_name": latest_audio,
-        })
-
-    return results
-
-
-@router.post("/upload_audio_version", tags=["Media Manager"])
-async def upload_audio_version(
-    audio: UploadFile = File(...),
-    sha1: str = Query(..., description="SHA1 of the video folder"),
-    version: str = Query(..., description="Version: Salamandra or MoE"),
-    token: str = Query(..., description="Token required for authorization")
-):
-    """Upload audio for a given version (Salamandra, MoE).
-
-    This legacy endpoint keeps its path but now interprets the former
-    `subtype` path component as `version`:
-    - Target folder: /data/media/<sha1>/<version>/
-    - Deletes any previous audio files
-    - Saves the new audio
-    """
-    validate_token(token)
-
-    if version not in VALID_VERSIONS:
-        raise HTTPException(status_code=400, detail="Invalid version")
-
-    MEDIA_ROOT = Path("/data/media")
-    version_dir = MEDIA_ROOT / sha1 / version
-    version_dir.mkdir(parents=True, exist_ok=True)
-
-    # Delete old audio files
-    try:
-        for pattern in AUDIO_EXTENSIONS:
-            for old_audio in version_dir.glob(pattern):
-                old_audio.unlink()
-    except Exception as exc:
-        raise HTTPException(status_code=500, detail=f"Failed to delete old audio files: {exc}")
-
-    final_path = version_dir / audio.filename
-
-    try:
-        file_bytes = await audio.read()
-        with open(final_path, "wb") as f:
-            f.write(file_bytes)
-    except Exception as exc:
-        raise HTTPException(status_code=500, detail=f"Failed to save audio: {exc}")
-
-    return JSONResponse(
-        status_code=200,
-        content={
-            "status": "ok",
-            "sha1": sha1,
-            "version": version,
-            "saved_to": str(final_path)
-        }
-    )
-
-
-@router.get("/download_audio_version", tags=["Media Manager"])
-def download_audio_version(
-    sha1: str,
-    version: str,
-    token: str = Query(..., description="Token required for authorization")
-):
-    """Download the first audio file for a given version (Salamandra, MoE)."""
-    validate_token(token)
-
-    if version not in VALID_VERSIONS:
-        raise HTTPException(status_code=400, detail="Invalid version")
-
-    MEDIA_ROOT = Path("/data/media")
-    version_dir = MEDIA_ROOT / sha1 / version
-
-    if not version_dir.exists() or not version_dir.is_dir():
-        raise HTTPException(status_code=404, detail=f"{version} folder not found")
-
-    # Find audio files
-    audio_files = []
-    for pattern in AUDIO_EXTENSIONS:
-        audio_files.extend(list(version_dir.glob(pattern)))
-
-    if not audio_files:
-        raise HTTPException(status_code=404, detail="No audio files found")
-
-    audio_path = audio_files[0]
-
-    return FileResponse(
-        path=audio_path,
-        media_type="audio/" + audio_path.suffix.lstrip("."),
-        filename=audio_path.name
-    )
-
-
-@router.post("/upload_audio_ad", tags=["Media Manager"])
-async def upload_audio_ad(
-    audio: UploadFile = File(...),
-    sha1: str = Query(..., description="SHA1 of the video folder"),
-    version: str = Query(..., description="Version: Salamandra or MoE"),
-    subtype: str = Query(..., description="Subtype: Original, HITL OK or HITL Test"),
-    token: str = Query(..., description="Token required for authorization")
-):
-    validate_token(token)
-
-    if version not in VALID_VERSIONS:
-        raise HTTPException(status_code=400, detail="Invalid version")
-    if subtype not in VALID_SUBTYPES:
-        raise HTTPException(status_code=400, detail="Invalid subtype")
-
-    MEDIA_ROOT = Path("/data/media")
-    subtype_dir = MEDIA_ROOT / sha1 / version / subtype
-    subtype_dir.mkdir(parents=True, exist_ok=True)
-
-    try:
-        for pattern in AUDIO_EXTENSIONS:
-            for old_audio in subtype_dir.glob(pattern):
-                old_audio.unlink()
-    except Exception as exc:
-        raise HTTPException(status_code=500, detail=f"Failed to delete old audio files: {exc}")
-
-    final_path = subtype_dir / audio.filename
-
-    try:
-        file_bytes = await audio.read()
-        with open(final_path, "wb") as f:
-            f.write(file_bytes)
-    except Exception as exc:
-        raise HTTPException(status_code=500, detail=f"Failed to save audio: {exc}")
-
-    return JSONResponse(
-        status_code=200,
-        content={
-            "status": "ok",
-            "sha1": sha1,
-            "version": version,
-            "subtype": subtype,
-            "saved_to": str(final_path)
-        }
-    )
-
-
-@router.get("/download_audio_ad", tags=["Media Manager"])
-def download_audio_ad(
-    sha1: str,
-    version: str,
-    subtype: str,
-    token: str = Query(..., description="Token required for authorization")
-):
-    validate_token(token)
-
-    if version not in VALID_VERSIONS:
-        raise HTTPException(status_code=400, detail="Invalid version")
-    if subtype not in VALID_SUBTYPES:
-        raise HTTPException(status_code=400, detail="Invalid subtype")
-
-    MEDIA_ROOT = Path("/data/media")
-    subtype_dir = MEDIA_ROOT / sha1 / version / subtype
-
-    if not subtype_dir.exists() or not subtype_dir.is_dir():
-        raise HTTPException(status_code=404, detail="Version/subtype folder not found")
-
-    audio_files = []
-    for pattern in AUDIO_EXTENSIONS:
-        audio_files.extend(list(subtype_dir.glob(pattern)))
-
-    if not audio_files:
-        raise HTTPException(status_code=404, detail="No audio files found")
-
-    audio_path = audio_files[0]
-
-    return FileResponse(
-        path=audio_path,
-        media_type="audio/" + audio_path.suffix.lstrip("."),
-        filename=audio_path.name
-    )
-
-
-@router.get("/list_version_audios", tags=["Media Manager"])
-def list_version_audios(
-    sha1: str = Query(..., description="SHA1 of the video folder"),
-    token: str = Query(..., description="Token required for authorization")
-):
-    """List the most recent audio file for each version (Salamandra, MoE)
-    under /data/media/<sha1>.
-
-    Returns:
-    - sha1: folder name
-    - version: name of the version
-    - audio_name: latest audio file or None
-    """
-    validate_token(token)
-
-    results = []
-
-    for version in VALID_VERSIONS:
-        version_dir = MEDIA_ROOT / sha1 / version
-
-        latest_audio = None
-
-        if version_dir.exists() and version_dir.is_dir():
-            files = []
-            for pattern in AUDIO_EXTENSIONS:
-                files.extend(list(version_dir.glob(pattern)))
-
-            if files:
-                # Sort by modification time (newest first)
-                files.sort(key=lambda f: f.stat().st_mtime, reverse=True)
-                latest_audio = files[0].name
-
-        results.append({
-            "sha1": sha1,
-            "version": version,
-            "audio_name": latest_audio
-        })
-
-    return results
-
-
-@router.post("/upload_version_video", tags=["Media Manager"])
-async def upload_version_video(
-    sha1: str = Query(..., description="SHA1 associated to the media folder"),
-    version: str = Query(..., description="Version: Salamandra or MoE"),
-    video: UploadFile = File(...),
-    token: str = Query(..., description="Token required for authorization")
-):
-    """Upload a video to /data/media/<sha1>/<version>/.
-
-    This legacy endpoint keeps its path but now interprets the former
-    `subtype` path component as `version`.
-    Steps:
-    - Validate version.
-    - Create version folder if missing.
-    - Delete existing MP4 files.
-    - Save new MP4.
-    """
-    validate_token(token)
-
-    if version not in VALID_VERSIONS:
-        raise HTTPException(status_code=400, detail="Invalid version")
-
-    MEDIA_ROOT = Path("/data/media")
-    file_manager = FileManager(MEDIA_ROOT)
-
-    version_dir = MEDIA_ROOT / sha1 / version
-    version_dir.mkdir(parents=True, exist_ok=True)
-
-    # Remove old mp4 files
-    for f in version_dir.glob("*.mp4"):
-        f.unlink()
-
-    file_bytes = await video.read()
-    final_path = version_dir / video.filename
-
-    save_result = file_manager.upload_file(io.BytesIO(file_bytes), final_path)
-    if not save_result["operation_success"]:
-        raise HTTPException(status_code=500, detail=save_result["error"])
-
-    return {
-        "status": "ok",
-        "sha1": sha1,
-        "version": version,
-        "saved_to": str(final_path)
-    }
-
-
-@router.get("/download_version_video", tags=["Media Manager"])
-def download_version_video(
-    sha1: str,
-    version: str,
-    token: str = Query(..., description="Token required for authorization")
-):
-    """Download the video stored under /data/media/<sha1>/<version>.
-    Returns the first MP4 found.
-    """
-    validate_token(token)
-
-    if version not in VALID_VERSIONS:
-        raise HTTPException(status_code=400, detail="Invalid version")
-
-    MEDIA_ROOT = Path("/data/media")
-    file_manager = FileManager(MEDIA_ROOT)
-
-    version_dir = MEDIA_ROOT / sha1 / version
-
-    if not version_dir.exists() or not version_dir.is_dir():
-        raise HTTPException(status_code=404, detail="Version folder not found")
-
-    mp4_files = list(version_dir.glob("*.mp4"))
-    if not mp4_files:
-        raise HTTPException(status_code=404, detail="No MP4 files found")
-
-    video_path = mp4_files[0]
-    relative_path = video_path.relative_to(MEDIA_ROOT)
-
-    handler = file_manager.get_file(relative_path)
-    if handler is None:
-        raise HTTPException(status_code=404, detail="Video not accessible")
-
-    handler.close()
-
-    return FileResponse(
-        path=video_path,
-        media_type="video/mp4",
-        filename=video_path.name
-    )
-
-
-@router.get("/list_version_videos", tags=["Media Manager"])
-def list_version_videos(
-    sha1: str,
-    token: str = Query(..., description="Token required for authorization")
-):
-    """List the most recent .mp4 video for each version (Salamandra, MoE)
-    inside /data/media/<sha1>.
-
-    Returns:
-    - sha1
-    - version
-    - video_name (latest mp4 or None)
-    """
-    validate_token(token)
-
-    MEDIA_ROOT = Path("/data/media")
-
-    results = []
-
-    for version in VALID_VERSIONS:
-        version_dir = MEDIA_ROOT / sha1 / version
-
-        latest_video = None
-
-        if version_dir.exists() and version_dir.is_dir():
-            files = list(version_dir.glob("*.mp4"))
-            if files:
-                files.sort(key=lambda f: f.stat().st_mtime, reverse=True)
-                latest_video = files[0].name
-
-        results.append({
-            "sha1": sha1,
-            "version": version,
-            "video_name": latest_video
-        })
-
-    return results
+import os
+import io
+import shutil
+
+import sqlite3
+
+from pathlib import Path
+
+from fastapi import APIRouter, UploadFile, File, Query, HTTPException
+from fastapi.responses import FileResponse, JSONResponse
+
+
+from storage.files.file_manager import FileManager
+from storage.common import validate_token
+
+router = APIRouter(prefix="/media", tags=["Media Manager"])
+MEDIA_ROOT = Path("/data/media")
+file_manager = FileManager(MEDIA_ROOT)
+HF_TOKEN = os.getenv("HF_TOKEN")
+VALID_VERSIONS = ("Salamandra", "MoE")
+VALID_SUBTYPES = ("Original", "HITL OK", "HITL Test")
+AUDIO_EXTENSIONS = ["*.mp3", "*.wav", "*.aac", "*.m4a", "*.ogg", "*.flac"]
+
+
+@router.delete("/clear_media", tags=["Media Manager"])
+def clear_media(token: str = Query(..., description="Token required for authorization")):
+    """
+    Delete all contents of the /data/media folder.
+
+    Steps:
+    - Validate the token.
+    - Ensure the folder exists.
+    - Delete all files and subfolders inside /data/media.
+    - Return a JSON response confirming the deletion.
+
+    Warning: This will remove all stored videos, clips, and cast CSV files.
+    """
+    validate_token(token)
+
+    if not MEDIA_ROOT.exists() or not MEDIA_ROOT.is_dir():
+        raise HTTPException(status_code=404, detail="/data/media folder does not exist")
+
+    # Delete contents
+    for item in MEDIA_ROOT.iterdir():
+        try:
+            if item.is_dir():
+                shutil.rmtree(item)
+            else:
+                item.unlink()
+        except Exception as e:
+            raise HTTPException(status_code=500, detail=f"Failed to delete {item}: {e}")
+
+    return {"status": "ok", "message": "All media files deleted successfully"}
+
+@router.post("/upload_cast_csv", tags=["Media Manager"])
+async def upload_cast_csv(
+    sha1: str,
+    cast_file: UploadFile = File(...),
+    token: str = Query(..., description="Token required for authorization")
+):
+    """
+    Upload a cast CSV file for a specific video identified by its SHA-1.
+
+    The CSV will be stored under:
+        /data/media/<sha1>/cast/cast.csv
+
+    Steps:
+    - Validate the token.
+    - Ensure /data/media/<sha1> exists.
+    - Create /cast folder if missing.
+    - Save the CSV file inside /cast.
+    """
+    validate_token(token)
+
+    base_folder = MEDIA_ROOT / sha1
+    if not base_folder.exists() or not base_folder.is_dir():
+        raise HTTPException(status_code=404, detail="SHA1 folder not found")
+
+    cast_folder = base_folder / "cast"
+    cast_folder.mkdir(parents=True, exist_ok=True)
+
+    final_path = cast_folder / "cast.csv"
+
+    file_bytes = await cast_file.read()
+    save_result = file_manager.upload_file(io.BytesIO(file_bytes), final_path)
+    if not save_result["operation_success"]:
+        raise HTTPException(status_code=500, detail=save_result["error"])
+
+    return JSONResponse(
+        status_code=200,
+        content={"status": "ok", "saved_to": str(final_path)}
+    )
+
+
+@router.get("/download_cast_csv", tags=["Media Manager"])
+def download_cast_csv(
+    sha1: str,
+    token: str = Query(..., description="Token required for authorization")
+):
+    """
+    Download the cast CSV for a specific video identified by its SHA-1.
+
+    The CSV is expected under:
+        /data/media/<sha1>/cast/cast.csv
+
+    Steps:
+    - Validate the token.
+    - Ensure /data/media/<sha1> and /cast exist.
+    - Return the CSV as a FileResponse.
+    - Raise 404 if any folder or file is missing.
+    """
+    MEDIA_ROOT = Path("/data/media")
+    file_manager = FileManager(MEDIA_ROOT)
+    HF_TOKEN = os.getenv("HF_TOKEN")
+    validate_token(token)
+
+    base_folder = MEDIA_ROOT / sha1
+    cast_folder = base_folder / "cast"
+    csv_path = cast_folder / "cast.csv"
+
+    if not base_folder.exists() or not base_folder.is_dir():
+        raise HTTPException(status_code=404, detail="SHA1 folder not found")
+    if not cast_folder.exists() or not cast_folder.is_dir():
+        raise HTTPException(status_code=404, detail="Cast folder not found")
+    if not csv_path.exists() or not csv_path.is_file():
+        raise HTTPException(status_code=404, detail="Cast CSV not found")
+
+    # Convert to relative path for FileManager
+    relative_path = csv_path.relative_to(MEDIA_ROOT)
+    handler = file_manager.get_file(relative_path)
+    if handler is None:
+        raise HTTPException(status_code=404, detail="Cast CSV not accessible")
+    handler.close()
+
+    return FileResponse(
+        path=csv_path,
+        media_type="text/csv",
+        filename="cast.csv"
+    )
+
+@router.post("/upload_original_video", tags=["Media Manager"])
+async def upload_video(
+    video: UploadFile = File(...),
+    token: str = Query(..., description="Token required for authorization")
+):
+    """
+    Saves an uploaded video by hashing it with SHA1 and placing it under:
+    /data/media/<sha1>/clip/<original_filename>
+
+    Behavior:
+    - Compute SHA1 of the uploaded video.
+    - Ensure folder structure exists.
+    - Delete any existing .mp4 files under /clip.
+    - Save the uploaded video in the clip folder.
+    """
+    MEDIA_ROOT = Path("/data/media")
+    file_manager = FileManager(MEDIA_ROOT)
+    HF_TOKEN = os.getenv("HF_TOKEN")
+    validate_token(token)
+
+    # Read content into memory (needed to compute hash twice)
+    file_bytes = await video.read()
+
+    # Create an in-memory file handler for hashing
+    file_handler = io.BytesIO(file_bytes)
+
+    # Compute SHA1
+    try:
+        sha1 = file_manager.compute_sha1(file_handler)
+    except Exception as exc:
+        raise HTTPException(status_code=500, detail=f"SHA1 computation failed: {exc}")
+
+    # Ensure /data/media exists
+    MEDIA_ROOT.mkdir(parents=True, exist_ok=True)
+
+    # Path: /data/media/<sha1>
+    video_root = MEDIA_ROOT / sha1
+    video_root.mkdir(parents=True, exist_ok=True)
+
+    # Path: /data/media/<sha1>/clip
+    clip_dir = video_root / "clip"
+    clip_dir.mkdir(parents=True, exist_ok=True)
+
+    # Delete old MP4 files
+    try:
+        for old_mp4 in clip_dir.glob("*.mp4"):
+            old_mp4.unlink()
+    except Exception as exc:
+        raise HTTPException(status_code=500, detail=f"Failed to delete old videos: {exc}")
+
+    # Save new video path
+    final_path = clip_dir / video.filename
+
+    # Save file
+    save_result = file_manager.upload_file(io.BytesIO(file_bytes), final_path)
+
+    if not save_result["operation_success"]:
+        raise HTTPException(status_code=500, detail=save_result["error"])
+
+    return JSONResponse(
+        status_code=200,
+        content={
+            "status": "ok",
+            "sha1": sha1,
+            "saved_to": str(final_path)
+        }
+    )
+
+
+@router.get("/download_original_video", tags=["Media Manager"])
+def download_video(
+    sha1: str,
+    token: str = Query(..., description="Token required for authorization")
+    ):
+    """
+    Download a stored video by its SHA-1 directory name.
+
+    This endpoint looks for a video stored under the path:
+        /data/media/<sha1>/clip/
+    and returns the first MP4 file found in that folder.
+
+    The method performs the following steps:
+    - Checks if the SHA-1 folder exists inside the media root.
+    - Validates that the "clip" subfolder exists.
+    - Searches for the first .mp4 file inside the clip folder.
+    - Uses the FileManager.get_file method to ensure the file is accessible.
+    - Returns the video directly as a FileResponse.
+
+    Parameters
+    ----------
+    sha1 : str
+        The SHA-1 hash corresponding to the directory where the video is stored.
+
+    Returns
+    -------
+    FileResponse
+        A streaming response containing the MP4 video.
+
+    Raises
+    ------
+    HTTPException
+        - 404 if the SHA-1 folder does not exist.
+        - 404 if the clip folder is missing.
+        - 404 if no MP4 files are found.
+        - 404 if the file cannot be retrieved using FileManager.
+    """
+    MEDIA_ROOT = Path("/data/media")
+    file_manager = FileManager(MEDIA_ROOT)
+    HF_TOKEN = os.getenv("HF_TOKEN")
+    validate_token(token)
+
+    sha1_folder = MEDIA_ROOT / sha1
+    clip_folder = sha1_folder / "clip"
+
+    if not sha1_folder.exists() or not sha1_folder.is_dir():
+        raise HTTPException(status_code=404, detail="SHA1 folder not found")
+
+    if not clip_folder.exists() or not clip_folder.is_dir():
+        raise HTTPException(status_code=404, detail="Clip folder not found")
+
+    # Find first MP4 file
+    mp4_files = list(clip_folder.glob("*.mp4"))
+    if not mp4_files:
+        raise HTTPException(status_code=404, detail="No MP4 files found")
+
+    video_path = mp4_files[0]
+
+    # Convert to relative path for FileManager
+    relative_path = video_path.relative_to(MEDIA_ROOT)
+
+    handler = file_manager.get_file(relative_path)
+    if handler is None:
+        raise HTTPException(status_code=404, detail="Video not accessible")
+
+    handler.close()
+
+    return FileResponse(
+        path=video_path,
+        media_type="video/mp4",
+        filename=video_path.name
+    )
+
+@router.delete("/delete_video", tags=["Media Manager"])
+def delete_media(
+    hash: str,
+    token: str = Query(..., description="Token required for authorization")
+):
+    """
+    Delete a stored media directory by its hash.
+
+    This endpoint removes the folder located at:
+        /data/media/<hash>
+
+    The method performs the following steps:
+    - Validates the authorization token.
+    - Checks if the hash folder exists inside the media root.
+    - Deletes the entire directory recursively.
+
+    Parameters
+    ----------
+    hash : str
+        The hash corresponding to the directory to be deleted.
+
+    Returns
+    -------
+    dict
+        A confirmation message indicating successful deletion.
+
+    Raises
+    ------
+    HTTPException
+        - 404 if the hash folder does not exist.
+        - 500 if the folder cannot be deleted.
+    """
+    MEDIA_ROOT = Path("/data/media")
+    validate_token(token)
+
+    hash_folder = MEDIA_ROOT / hash
+
+    if not hash_folder.exists() or not hash_folder.is_dir():
+        raise HTTPException(status_code=404, detail="Media folder not found")
+
+    try:
+        shutil.rmtree(hash_folder)
+    except Exception as e:
+        raise HTTPException(
+            status_code=500,
+            detail=f"Failed to delete media folder: {str(e)}"
+        )
+
+    return {
+        "status": "ok",
+        "message": f"Media folder '{hash}' deleted successfully"
+    }
+
+@router.post("/upload_video_ad", tags=["Media Manager"])
+async def upload_video_ad(
+    sha1: str = Query(..., description="SHA1 associated to the media folder"),
+    version: str = Query(..., description="Version: Salamandra or MoE"),
+    subtype: str = Query(..., description="Subtype: Original, HITL OK or HITL Test"),
+    video: UploadFile = File(...),
+    token: str = Query(..., description="Token required for authorization")
+):
+    validate_token(token)
+
+    if version not in VALID_VERSIONS:
+        raise HTTPException(status_code=400, detail="Invalid version")
+    if subtype not in VALID_SUBTYPES:
+        raise HTTPException(status_code=400, detail="Invalid subtype")
+
+    MEDIA_ROOT = Path("/data/media")
+    file_manager = FileManager(MEDIA_ROOT)
+
+    subtype_dir = MEDIA_ROOT / sha1 / version / subtype
+    subtype_dir.mkdir(parents=True, exist_ok=True)
+
+    for f in subtype_dir.glob("*.mp4"):
+        f.unlink()
+
+    file_bytes = await video.read()
+    final_path = subtype_dir / video.filename
+
+    save_result = file_manager.upload_file(io.BytesIO(file_bytes), final_path)
+    if not save_result["operation_success"]:
+        raise HTTPException(status_code=500, detail=save_result["error"])
+
+    return {
+        "status": "ok",
+        "sha1": sha1,
+        "version": version,
+        "subtype": subtype,
+        "saved_to": str(final_path)
+    }
+
+
+@router.get("/download_video_ad", tags=["Media Manager"])
+def download_video_ad(
+    sha1: str,
+    version: str,
+    subtype: str,
+    token: str = Query(..., description="Token required for authorization")
+):
+    validate_token(token)
+
+    if version not in VALID_VERSIONS:
+        raise HTTPException(status_code=400, detail="Invalid version")
+    if subtype not in VALID_SUBTYPES:
+        raise HTTPException(status_code=400, detail="Invalid subtype")
+
+    MEDIA_ROOT = Path("/data/media")
+    file_manager = FileManager(MEDIA_ROOT)
+
+    subtype_dir = MEDIA_ROOT / sha1 / version / subtype
+
+    if not subtype_dir.exists() or not subtype_dir.is_dir():
+        raise HTTPException(status_code=404, detail="Version/subtype folder not found")
+
+    mp4_files = list(subtype_dir.glob("*.mp4"))
+    if not mp4_files:
+        raise HTTPException(status_code=404, detail="No MP4 files found")
+
+    video_path = mp4_files[0]
+    relative_path = video_path.relative_to(MEDIA_ROOT)
+
+    handler = file_manager.get_file(relative_path)
+    if handler is None:
+        raise HTTPException(status_code=404, detail="Video not accessible")
+
+    handler.close()
+
+    return FileResponse(
+        path=video_path,
+        media_type="video/mp4",
+        filename=video_path.name
+    )
+
+@router.get("/list_original_videos", tags=["Media Manager"])
+def list_all_videos(
+    token: str = Query(..., description="Token required for authorization")
+):
+    """
+    List all videos stored under /data/media.
+
+    For each SHA1 folder, the endpoint returns:
+    - sha1: folder name
+    - video_files: list of mp4 files inside /clip
+    - latest_video: the most recently modified mp4
+    - video_count: total number of mp4 files
+
+    Notes:
+    - Videos may not have a /clip folder.
+    - SHA1 folders without mp4 files are still returned.
+    """
+    validate_token(token)
+
+    results = []
+
+    # If media root does not exist, return empty list
+    if not MEDIA_ROOT.exists():
+        return []
+
+    for sha1_dir in MEDIA_ROOT.iterdir():
+        if not sha1_dir.is_dir():
+            continue  # skip non-folders
+
+        clip_dir = sha1_dir / "clip"
+
+        videos = []
+        latest_video = None
+
+        if clip_dir.exists() and clip_dir.is_dir():
+            mp4_files = list(clip_dir.glob("*.mp4"))
+
+            # Sort by modification time (newest first)
+            mp4_files.sort(key=lambda f: f.stat().st_mtime, reverse=True)
+
+            videos = [f.name for f in mp4_files]
+
+            if mp4_files:
+                latest_video = mp4_files[0].name
+
+        results.append({
+            "sha1": sha1_dir.name,
+            "video_name": latest_video
+        })
+
+    return results
+
+@router.post("/upload_original_audio", tags=["Media Manager"])
+async def upload_audio(
+    audio: UploadFile = File(...),
+    token: str = Query(..., description="Token required for authorization")
+):
+    """
+    Saves an uploaded audio file by hashing it with SHA1 and placing it under:
+    /data/media/<sha1>/audio/<original_filename>
+
+    Behavior:
+    - Compute SHA1 of the uploaded audio.
+    - Ensure folder structure exists.
+    - Delete any existing audio files under /audio.
+    - Save the uploaded audio in the audio folder.
+    """
+    MEDIA_ROOT = Path("/data/media")
+    file_manager = FileManager(MEDIA_ROOT)
+    HF_TOKEN = os.getenv("HF_TOKEN")
+    validate_token(token)
+
+    # Read content into memory (needed to compute hash twice)
+    file_bytes = await audio.read()
+
+    # Create an in-memory file handler for hashing
+    file_handler = io.BytesIO(file_bytes)
+
+    # Compute SHA1
+    try:
+        sha1 = file_manager.compute_sha1(file_handler)
+    except Exception as exc:
+        raise HTTPException(status_code=500, detail=f"SHA1 computation failed: {exc}")
+
+    # Ensure /data/media exists
+    MEDIA_ROOT.mkdir(parents=True, exist_ok=True)
+
+    # Path: /data/media/<sha1>
+    audio_root = MEDIA_ROOT / sha1
+    audio_root.mkdir(parents=True, exist_ok=True)
+
+    # Path: /data/media/<sha1>/audio
+    audio_dir = audio_root / "audio"
+    audio_dir.mkdir(parents=True, exist_ok=True)
+
+    # Delete old audio files
+    AUDIO_EXTENSIONS = ("*.mp3", "*.wav", "*.m4a", "*.aac", "*.ogg", "*.flac")
+    try:
+        for pattern in AUDIO_EXTENSIONS:
+            for old_audio in audio_dir.glob(pattern):
+                old_audio.unlink()
+    except Exception as exc:
+        raise HTTPException(status_code=500, detail=f"Failed to delete old audio files: {exc}")
+
+    # Final save path
+    final_path = audio_dir / audio.filename
+
+    # Save file
+    save_result = file_manager.upload_file(io.BytesIO(file_bytes), final_path)
+
+    if not save_result["operation_success"]:
+        raise HTTPException(status_code=500, detail=save_result["error"])
+
+    return JSONResponse(
+        status_code=200,
+        content={
+            "status": "ok",
+            "sha1": sha1,
+            "saved_to": str(final_path)
+        }
+    )
+
+@router.get("/download_original_audio", tags=["Media Manager"])
+def download_audio(
+    sha1: str,
+    token: str = Query(..., description="Token required for authorization")
+    ):
+    """
+    Download a stored audio file by its SHA-1 directory name.
+
+    This endpoint looks for audio stored under the path:
+        /data/media/<sha1>/audio/
+    and returns the first audio file found in that folder.
+
+    The method performs the following steps:
+    - Checks if the SHA-1 folder exists inside the media root.
+    - Validates that the "audio" subfolder exists.
+    - Searches for the first supported audio file.
+    - Uses FileManager.get_file to ensure the file is accessible.
+    - Returns the audio file as a FileResponse.
+
+    Parameters
+    ----------
+    sha1 : str
+        The SHA-1 hash corresponding to the directory where the audio is stored.
+
+    Returns
+    -------
+    FileResponse
+        A streaming response containing the audio file.
+
+    Raises
+    ------
+    HTTPException
+        - 404 if the SHA-1 folder does not exist.
+        - 404 if the audio folder is missing.
+        - 404 if no audio files are found.
+        - 404 if the file cannot be retrieved using FileManager.
+    """
+    MEDIA_ROOT = Path("/data/media")
+    file_manager = FileManager(MEDIA_ROOT)
+    HF_TOKEN = os.getenv("HF_TOKEN")
+    validate_token(token)
+
+    sha1_folder = MEDIA_ROOT / sha1
+    audio_folder = sha1_folder / "audio"
+
+    if not sha1_folder.exists() or not sha1_folder.is_dir():
+        raise HTTPException(status_code=404, detail="SHA1 folder not found")
+
+    if not audio_folder.exists() or not audio_folder.is_dir():
+        raise HTTPException(status_code=404, detail="Audio folder not found")
+
+    # Supported audio extensions
+    AUDIO_EXTENSIONS = ["*.mp3", "*.wav", "*.aac", "*.m4a", "*.ogg", "*.flac"]
+
+    audio_files = []
+    for pattern in AUDIO_EXTENSIONS:
+        audio_files.extend(list(audio_folder.glob(pattern)))
+
+    if not audio_files:
+        raise HTTPException(status_code=404, detail="No audio files found")
+
+    audio_path = audio_files[0]
+
+    # Convert to relative path for FileManager
+    relative_path = audio_path.relative_to(MEDIA_ROOT)
+
+    handler = file_manager.get_file(relative_path)
+    if handler is None:
+        raise HTTPException(status_code=404, detail="Audio file not accessible")
+
+    handler.close()
+
+    # Guess media type based on extension (simple)
+    media_type = "audio/" + audio_path.suffix.lstrip(".")
+
+    return FileResponse(
+        path=audio_path,
+        media_type=media_type,
+        filename=audio_path.name
+    )
+
+@router.get("/list_original_audios", tags=["Media Manager"])
+def list_all_audios(
+    token: str = Query(..., description="Token required for authorization")
+):
+    """
+    List all audio files stored under /data/media.
+
+    For each SHA1 folder, the endpoint returns:
+    - sha1: folder name
+    - audio_files: list of audio files inside /audio
+    - latest_audio: the most recently modified audio file
+    - audio_count: total number of audio files
+
+    Notes:
+    - Folders may not have an /audio folder.
+    - SHA1 folders without audio files are still returned.
+    """
+    validate_token(token)
+
+    results = []
+
+    MEDIA_ROOT = Path("/data/media")
+    AUDIO_EXTENSIONS = ["*.mp3", "*.wav", "*.aac", "*.m4a", "*.ogg", "*.flac"]
+
+    # If media root does not exist, return empty list
+    if not MEDIA_ROOT.exists():
+        return []
+
+    for sha1_dir in MEDIA_ROOT.iterdir():
+        if not sha1_dir.is_dir():
+            continue  # skip non-folders
+
+        audio_dir = sha1_dir / "audio"
+
+        audio_files = []
+        latest_audio = None
+
+        if audio_dir.exists() and audio_dir.is_dir():
+            # Collect all audio files with supported extensions
+            files = []
+            for pattern in AUDIO_EXTENSIONS:
+                files.extend(list(audio_dir.glob(pattern)))
+
+            # Sort by modification time (newest first)
+            files.sort(key=lambda f: f.stat().st_mtime, reverse=True)
+
+            audio_files = [f.name for f in files]
+
+            if files:
+                latest_audio = files[0].name
+
+        results.append({
+            "sha1": sha1_dir.name,
+            "audio_name": latest_audio,
+        })
+
+    return results
+
+
+@router.post("/upload_audio_version", tags=["Media Manager"])
+async def upload_audio_version(
+    audio: UploadFile = File(...),
+    sha1: str = Query(..., description="SHA1 of the video folder"),
+    version: str = Query(..., description="Version: Salamandra or MoE"),
+    token: str = Query(..., description="Token required for authorization")
+):
+    """Upload audio for a given version (Salamandra, MoE).
+
+    This legacy endpoint keeps its path but now interprets the former
+    `subtype` path component as `version`:
+    - Target folder: /data/media/<sha1>/<version>/
+    - Deletes any previous audio files
+    - Saves the new audio
+    """
+    validate_token(token)
+
+    if version not in VALID_VERSIONS:
+        raise HTTPException(status_code=400, detail="Invalid version")
+
+    MEDIA_ROOT = Path("/data/media")
+    version_dir = MEDIA_ROOT / sha1 / version
+    version_dir.mkdir(parents=True, exist_ok=True)
+
+    # Delete old audio files
+    try:
+        for pattern in AUDIO_EXTENSIONS:
+            for old_audio in version_dir.glob(pattern):
+                old_audio.unlink()
+    except Exception as exc:
+        raise HTTPException(status_code=500, detail=f"Failed to delete old audio files: {exc}")
+
+    final_path = version_dir / audio.filename
+
+    try:
+        file_bytes = await audio.read()
+        with open(final_path, "wb") as f:
+            f.write(file_bytes)
+    except Exception as exc:
+        raise HTTPException(status_code=500, detail=f"Failed to save audio: {exc}")
+
+    return JSONResponse(
+        status_code=200,
+        content={
+            "status": "ok",
+            "sha1": sha1,
+            "version": version,
+            "saved_to": str(final_path)
+        }
+    )
+
+
+@router.get("/download_audio_version", tags=["Media Manager"])
+def download_audio_version(
+    sha1: str,
+    version: str,
+    token: str = Query(..., description="Token required for authorization")
+):
+    """Download the first audio file for a given version (Salamandra, MoE)."""
+    validate_token(token)
+
+    if version not in VALID_VERSIONS:
+        raise HTTPException(status_code=400, detail="Invalid version")
+
+    MEDIA_ROOT = Path("/data/media")
+    version_dir = MEDIA_ROOT / sha1 / version
+
+    if not version_dir.exists() or not version_dir.is_dir():
+        raise HTTPException(status_code=404, detail=f"{version} folder not found")
+
+    # Find audio files
+    audio_files = []
+    for pattern in AUDIO_EXTENSIONS:
+        audio_files.extend(list(version_dir.glob(pattern)))
+
+    if not audio_files:
+        raise HTTPException(status_code=404, detail="No audio files found")
+
+    audio_path = audio_files[0]
+
+    return FileResponse(
+        path=audio_path,
+        media_type="audio/" + audio_path.suffix.lstrip("."),
+        filename=audio_path.name
+    )
+
+
+@router.post("/upload_audio_ad", tags=["Media Manager"])
+async def upload_audio_ad(
+    audio: UploadFile = File(...),
+    sha1: str = Query(..., description="SHA1 of the video folder"),
+    version: str = Query(..., description="Version: Salamandra or MoE"),
+    subtype: str = Query(..., description="Subtype: Original, HITL OK or HITL Test"),
+    token: str = Query(..., description="Token required for authorization")
+):
+    validate_token(token)
+
+    if version not in VALID_VERSIONS:
+        raise HTTPException(status_code=400, detail="Invalid version")
+    if subtype not in VALID_SUBTYPES:
+        raise HTTPException(status_code=400, detail="Invalid subtype")
+
+    MEDIA_ROOT = Path("/data/media")
+    subtype_dir = MEDIA_ROOT / sha1 / version / subtype
+    subtype_dir.mkdir(parents=True, exist_ok=True)
+
+    try:
+        for pattern in AUDIO_EXTENSIONS:
+            for old_audio in subtype_dir.glob(pattern):
+                old_audio.unlink()
+    except Exception as exc:
+        raise HTTPException(status_code=500, detail=f"Failed to delete old audio files: {exc}")
+
+    final_path = subtype_dir / audio.filename
+
+    try:
+        file_bytes = await audio.read()
+        with open(final_path, "wb") as f:
+            f.write(file_bytes)
+    except Exception as exc:
+        raise HTTPException(status_code=500, detail=f"Failed to save audio: {exc}")
+
+    return JSONResponse(
+        status_code=200,
+        content={
+            "status": "ok",
+            "sha1": sha1,
+            "version": version,
+            "subtype": subtype,
+            "saved_to": str(final_path)
+        }
+    )
+
+
+@router.get("/download_audio_ad", tags=["Media Manager"])
+def download_audio_ad(
+    sha1: str,
+    version: str,
+    subtype: str,
+    token: str = Query(..., description="Token required for authorization")
+):
+    validate_token(token)
+
+    if version not in VALID_VERSIONS:
+        raise HTTPException(status_code=400, detail="Invalid version")
+    if subtype not in VALID_SUBTYPES:
+        raise HTTPException(status_code=400, detail="Invalid subtype")
+
+    MEDIA_ROOT = Path("/data/media")
+    subtype_dir = MEDIA_ROOT / sha1 / version / subtype
+
+    if not subtype_dir.exists() or not subtype_dir.is_dir():
+        raise HTTPException(status_code=404, detail="Version/subtype folder not found")
+
+    audio_files = []
+    for pattern in AUDIO_EXTENSIONS:
+        audio_files.extend(list(subtype_dir.glob(pattern)))
+
+    if not audio_files:
+        raise HTTPException(status_code=404, detail="No audio files found")
+
+    audio_path = audio_files[0]
+
+    return FileResponse(
+        path=audio_path,
+        media_type="audio/" + audio_path.suffix.lstrip("."),
+        filename=audio_path.name
+    )
+
+
+@router.get("/list_version_audios", tags=["Media Manager"])
+def list_version_audios(
+    sha1: str = Query(..., description="SHA1 of the video folder"),
+    token: str = Query(..., description="Token required for authorization")
+):
+    """List the most recent audio file for each version (Salamandra, MoE)
+    under /data/media/<sha1>.
+
+    Returns:
+    - sha1: folder name
+    - version: name of the version
+    - audio_name: latest audio file or None
+    """
+    validate_token(token)
+
+    results = []
+
+    for version in VALID_VERSIONS:
+        version_dir = MEDIA_ROOT / sha1 / version
+
+        latest_audio = None
+
+        if version_dir.exists() and version_dir.is_dir():
+            files = []
+            for pattern in AUDIO_EXTENSIONS:
+                files.extend(list(version_dir.glob(pattern)))
+
+            if files:
+                # Sort by modification time (newest first)
+                files.sort(key=lambda f: f.stat().st_mtime, reverse=True)
+                latest_audio = files[0].name
+
+        results.append({
+            "sha1": sha1,
+            "version": version,
+            "audio_name": latest_audio
+        })
+
+    return results
+
+
+@router.post("/upload_version_video", tags=["Media Manager"])
+async def upload_version_video(
+    sha1: str = Query(..., description="SHA1 associated to the media folder"),
+    version: str = Query(..., description="Version: Salamandra or MoE"),
+    video: UploadFile = File(...),
+    token: str = Query(..., description="Token required for authorization")
+):
+    """Upload a video to /data/media/<sha1>/<version>/.
+
+    This legacy endpoint keeps its path but now interprets the former
+    `subtype` path component as `version`.
+    Steps:
+    - Validate version.
+    - Create version folder if missing.
+    - Delete existing MP4 files.
+    - Save new MP4.
+    """
+    validate_token(token)
+
+    if version not in VALID_VERSIONS:
+        raise HTTPException(status_code=400, detail="Invalid version")
+
+    MEDIA_ROOT = Path("/data/media")
+    file_manager = FileManager(MEDIA_ROOT)
+
+    version_dir = MEDIA_ROOT / sha1 / version
+    version_dir.mkdir(parents=True, exist_ok=True)
+
+    # Remove old mp4 files
+    for f in version_dir.glob("*.mp4"):
+        f.unlink()
+
+    file_bytes = await video.read()
+    final_path = version_dir / video.filename
+
+    save_result = file_manager.upload_file(io.BytesIO(file_bytes), final_path)
+    if not save_result["operation_success"]:
+        raise HTTPException(status_code=500, detail=save_result["error"])
+
+    return {
+        "status": "ok",
+        "sha1": sha1,
+        "version": version,
+        "saved_to": str(final_path)
+    }
+
+
+@router.get("/download_version_video", tags=["Media Manager"])
+def download_version_video(
+    sha1: str,
+    version: str,
+    token: str = Query(..., description="Token required for authorization")
+):
+    """Download the video stored under /data/media/<sha1>/<version>.
+    Returns the first MP4 found.
+    """
+    validate_token(token)
+
+    if version not in VALID_VERSIONS:
+        raise HTTPException(status_code=400, detail="Invalid version")
+
+    MEDIA_ROOT = Path("/data/media")
+    file_manager = FileManager(MEDIA_ROOT)
+
+    version_dir = MEDIA_ROOT / sha1 / version
+
+    if not version_dir.exists() or not version_dir.is_dir():
+        raise HTTPException(status_code=404, detail="Version folder not found")
+
+    mp4_files = list(version_dir.glob("*.mp4"))
+    if not mp4_files:
+        raise HTTPException(status_code=404, detail="No MP4 files found")
+
+    video_path = mp4_files[0]
+    relative_path = video_path.relative_to(MEDIA_ROOT)
+
+    handler = file_manager.get_file(relative_path)
+    if handler is None:
+        raise HTTPException(status_code=404, detail="Video not accessible")
+
+    handler.close()
+
+    return FileResponse(
+        path=video_path,
+        media_type="video/mp4",
+        filename=video_path.name
+    )
+
+
+@router.get("/list_version_videos", tags=["Media Manager"])
+def list_version_videos(
+    sha1: str,
+    token: str = Query(..., description="Token required for authorization")
+):
+    """List the most recent .mp4 video for each version (Salamandra, MoE)
+    inside /data/media/<sha1>.
+
+    Returns:
+    - sha1
+    - version
+    - video_name (latest mp4 or None)
+    """
+    validate_token(token)
+
+    MEDIA_ROOT = Path("/data/media")
+
+    results = []
+
+    for version in VALID_VERSIONS:
+        version_dir = MEDIA_ROOT / sha1 / version
+
+        latest_video = None
+
+        if version_dir.exists() and version_dir.is_dir():
+            files = list(version_dir.glob("*.mp4"))
+            if files:
+                files.sort(key=lambda f: f.stat().st_mtime, reverse=True)
+                latest_video = files[0].name
+
+        results.append({
+            "sha1": sha1,
+            "version": version,
+            "video_name": latest_video
+        })
+
+    return results