ComfyUI/app/assets/api/upload.py

"""
Multipart upload parsing for asset uploads.

This module handles the HTTP-specific concerns of parsing multipart form data,
streaming file uploads to temp storage, and validating hash fields.
"""
import os
import uuid

from aiohttp import web

import folder_paths
from app.assets.api.schemas_in import ParsedUpload, UploadError


def validate_hash_format(s: str) -> str:
    """
    Validate and normalize a hash string.
    
    Returns canonical 'blake3:<hex>' or raises UploadError.
    """
    s = s.strip().lower()
    if not s:
        raise UploadError(400, "INVALID_HASH", "hash must be like 'blake3:<hex>'")
    if ":" not in s:
        raise UploadError(400, "INVALID_HASH", "hash must be like 'blake3:<hex>'")
    algo, digest = s.split(":", 1)
    if algo != "blake3" or not digest or any(c for c in digest if c not in "0123456789abcdef"):
        raise UploadError(400, "INVALID_HASH", "hash must be like 'blake3:<hex>'")
    return f"{algo}:{digest}"


async def parse_multipart_upload(
    request: web.Request,
    check_hash_exists: callable,
) -> ParsedUpload:
    """
    Parse a multipart/form-data upload request.

    Args:
        request: The aiohttp request
        check_hash_exists: Callable(hash_str) -> bool to check if a hash exists

    Returns:
        ParsedUpload with parsed fields and temp file path

    Raises:
        UploadError: On validation or I/O errors
    """
    if not (request.content_type or "").lower().startswith("multipart/"):
        raise UploadError(415, "UNSUPPORTED_MEDIA_TYPE", "Use multipart/form-data for uploads.")

    reader = await request.multipart()

    file_present = False
    file_client_name: str | None = None
    tags_raw: list[str] = []
    provided_name: str | None = None
    user_metadata_raw: str | None = None
    provided_hash: str | None = None
    provided_hash_exists: bool | None = None

    file_written = 0
    tmp_path: str | None = None

    while True:
        field = await reader.next()
        if field is None:
            break

        fname = getattr(field, "name", "") or ""

        if fname == "hash":
            try:
                s = ((await field.text()) or "").strip().lower()
            except Exception:
                raise UploadError(400, "INVALID_HASH", "hash must be like 'blake3:<hex>'")

            if s:
                provided_hash = validate_hash_format(s)
                try:
                    provided_hash_exists = check_hash_exists(provided_hash)
                except Exception:
                    provided_hash_exists = None  # do not fail the whole request here

        elif fname == "file":
            file_present = True
            file_client_name = (field.filename or "").strip()

            if provided_hash and provided_hash_exists is True:
                # If client supplied a hash that we know exists, drain but do not write to disk
                try:
                    while True:
                        chunk = await field.read_chunk(8 * 1024 * 1024)
                        if not chunk:
                            break
                        file_written += len(chunk)
                except Exception:
                    raise UploadError(500, "UPLOAD_IO_ERROR", "Failed to receive uploaded file.")
                continue  # Do not create temp file; we will create AssetInfo from the existing content

            # Otherwise, store to temp for hashing/ingest
            uploads_root = os.path.join(folder_paths.get_temp_directory(), "uploads")
            unique_dir = os.path.join(uploads_root, uuid.uuid4().hex)
            os.makedirs(unique_dir, exist_ok=True)
            tmp_path = os.path.join(unique_dir, ".upload.part")

            try:
                with open(tmp_path, "wb") as f:
                    while True:
                        chunk = await field.read_chunk(8 * 1024 * 1024)
                        if not chunk:
                            break
                        f.write(chunk)
                        file_written += len(chunk)
            except Exception:
                _cleanup_temp(tmp_path)
                raise UploadError(500, "UPLOAD_IO_ERROR", "Failed to receive and store uploaded file.")

        elif fname == "tags":
            tags_raw.append((await field.text()) or "")
        elif fname == "name":
            provided_name = (await field.text()) or None
        elif fname == "user_metadata":
            user_metadata_raw = (await field.text()) or None

    # Validate we have either a file or a known hash
    if not file_present and not (provided_hash and provided_hash_exists):
        raise UploadError(400, "MISSING_FILE", "Form must include a 'file' part or a known 'hash'.")

    if file_present and file_written == 0 and not (provided_hash and provided_hash_exists):
        _cleanup_temp(tmp_path)
        raise UploadError(400, "EMPTY_UPLOAD", "Uploaded file is empty.")

    return ParsedUpload(
        file_present=file_present,
        file_written=file_written,
        file_client_name=file_client_name,
        tmp_path=tmp_path,
        tags_raw=tags_raw,
        provided_name=provided_name,
        user_metadata_raw=user_metadata_raw,
        provided_hash=provided_hash,
        provided_hash_exists=provided_hash_exists,
    )


def _cleanup_temp(tmp_path: str | None) -> None:
    """Safely remove a temp file if it exists."""
    if tmp_path:
        try:
            if os.path.exists(tmp_path):
                os.remove(tmp_path)
        except Exception:
            pass