"""The signed ITP PDF. Phase 7 builds it; until then the hook files nothing.

`file_signed_itp_pdf` is called inside the sign-off transaction, after the ITP row is set complete. When it returns an
asset id, the sign-off stores it as `signoff_asset_id` and files an automatic ITP document in the unit's Q.C. folder.
"""

from __future__ import annotations

import uuid
from collections.abc import Mapping
from typing import Any


def file_signed_itp_pdf(conn: Any, itp_row: Mapping[str, Any], actor: Any) -> uuid.UUID | None:
    """Build and store the signed ITP PDF, and return its asset id. Phase 7 implements it; today it returns None."""
    del conn, itp_row, actor
    return None