"""Small request helpers retained for legacy app compatibility."""

from __future__ import annotations

from flask import has_request_context, request


def get_request_hostname() -> str | None:
    """Return the first proxy-aware hostname for the current request."""
    if not has_request_context():
        return None

    forwarded = (request.headers.get("X-Forwarded-Host") or "").strip()
    host = forwarded or (request.headers.get("Host") or "").strip() or request.host
    if not host:
        return None
    return host.split(",", 1)[0].strip()