"""
Внешний контур: то, что нужно приложению, когда к нему придут снаружи.

Решение от 23.09.2026: «приложение со временем может начать работать с
доступом извне, важно, чтобы когда мы к этому придём, логика была вшита».

Здесь четыре вещи, и каждая включена так, чтобы не мешать работе в сети
депо уже сегодня:

* **заголовки безопасности** — всегда. Они ничего не ломают: запрещают
  встраивать страницы в чужой сайт и угадывать тип файла;
* **проверка источника запроса** — всегда. Форма, отправленная с чужого
  сайта от имени вошедшего пользователя, получает отказ. Браузер сам
  сообщает, с какой страницы отправлена форма, — сверяем это с адресом
  приложения;
* **ограничение частоты** входа и заявок «Забыли пароль?» — всегда. Без него
  снаружи можно перебирать пароли по многим учёткам сразу;
* **флаг Secure у cookie и HSTS** — только по настройке `COOKIE_SECURE=1`,
  когда приложение стоит за HTTPS. Включить их без HTTPS значит сломать
  вход: браузер перестанет отдавать cookie.

Ограничение частоты живёт в памяти процесса. При нескольких рабочих
процессах у каждого свой счёт — порог фактически умножается на их число.
Для защиты от перебора этого достаточно; общий счёт понадобится, если
процессов станет много.
"""

from __future__ import annotations

import os
import threading
import time
from collections import deque
from urllib.parse import urlsplit

from starlette.middleware.base import BaseHTTPMiddleware
from starlette.requests import Request
from starlette.responses import PlainTextResponse, Response


def env_on(name: str) -> bool:
    return os.environ.get(name, "").strip().lower() in ("1", "true", "yes", "да")


#  HTTPS включён — cookie только по защищённому каналу, браузеру велено
#  ходить сюда только по HTTPS
COOKIE_SECURE = env_on("COOKIE_SECURE")

#  Дополнительные адреса, с которых разрешено отправлять формы: например,
#  внешнее имя, под которым приложение опубликует прокси. Через запятую
TRUSTED_ORIGINS = {
    o.strip().rstrip("/").lower()
    for o in os.environ.get("TRUSTED_ORIGINS", "").split(",") if o.strip()
}

#  Выключатель проверки источника — на крайний случай, если какой-то прокси
#  подменяет адрес. По умолчанию включена
ORIGIN_CHECK = not env_on("ORIGIN_CHECK_OFF")

UNSAFE_METHODS = {"POST", "PUT", "PATCH", "DELETE"}


def _origin_of(url: str) -> str:
    parts = urlsplit(url)
    if not parts.scheme or not parts.netloc:
        return ""
    return f"{parts.scheme}://{parts.netloc}".lower()


def same_site(request: Request) -> bool:
    """
    Отправлен ли запрос со страниц самого приложения.

    Браузер при отправке формы кладёт заголовок Origin (а старые — Referer).
    Сравниваем его с адресом, по которому пришёл запрос. Запрос без обоих
    заголовков пропускаем: так приходят обращения не из браузера (проверки,
    сценарии), а у них нет чужой cookie, которую можно было бы подставить.
    """
    sent = request.headers.get("origin") or ""
    if not sent or sent == "null":
        referer = request.headers.get("referer") or ""
        sent = _origin_of(referer) if referer else ""
    if not sent:
        return True
    sent = sent.rstrip("/").lower()

    host = (request.headers.get("x-forwarded-host")
            or request.headers.get("host") or "").split(",")[0].strip().lower()
    scheme = (request.headers.get("x-forwarded-proto")
              or request.url.scheme).split(",")[0].strip().lower()
    own = {f"{scheme}://{host}", f"http://{host}", f"https://{host}"}
    return sent in own or sent in TRUSTED_ORIGINS


def safe_back(url: str | None, default: str) -> str:
    """
    Адрес возврата — только внутри приложения.

    Иначе ссылка вида «…?back=https://чужой-сайт» после нажатия кнопки
    уводила бы человека с нашей страницы туда, куда захотел автор ссылки.
    """
    if not url or not url.startswith("/") or url.startswith("//") or "\\" in url:
        return default
    return url


class SecurityHeaders(BaseHTTPMiddleware):
    """Заголовки безопасности и проверка источника для изменяющих запросов."""

    async def dispatch(self, request: Request, call_next) -> Response:
        if ORIGIN_CHECK and request.method in UNSAFE_METHODS \
                and not same_site(request):
            return PlainTextResponse(
                "Запрос отправлен не со страницы приложения и отклонён. "
                "Обновите страницу и повторите действие.", status_code=403)

        response = await call_next(request)
        h = response.headers
        h.setdefault("X-Content-Type-Options", "nosniff")
        #  Карточка открывается во всплывающем окне приложения через iframe,
        #  поэтому встраивание разрешено только самому себе
        h.setdefault("X-Frame-Options", "SAMEORIGIN")
        h.setdefault("Content-Security-Policy", "frame-ancestors 'self'")
        h.setdefault("Referrer-Policy", "same-origin")
        if COOKIE_SECURE:
            h.setdefault("Strict-Transport-Security",
                         "max-age=31536000; includeSubDomains")
        return response


class RateLimiter:
    """
    Не больше `limit` попыток за `window` секунд с одного адреса.

    Считаем попытки, а не неудачи: иначе перебор по разным учёткам с одного
    адреса упирался бы только в блокировку каждой учётки по отдельности — а
    ею, наоборот, можно нарочно заблокировать чужую.
    """

    def __init__(self, limit: int, window: int):
        self.limit = limit
        self.window = window
        self._hits: dict[str, deque] = {}
        self._lock = threading.Lock()

    def allow(self, key: str) -> bool:
        now = time.monotonic()
        with self._lock:
            q = self._hits.setdefault(key, deque())
            while q and now - q[0] > self.window:
                q.popleft()
            if len(q) >= self.limit:
                return False
            q.append(now)
            #  Старые адреса не копим бесконечно
            if len(self._hits) > 10000:
                self._hits = {k: v for k, v in self._hits.items() if v}
            return True


#  Вход: 20 попыток за 10 минут с адреса — человеку, забывшему пароль, этого
#  хватит с избытком, перебору — нет. «Забыли пароль?»: 5 заявок в час
LOGIN_LIMIT = RateLimiter(limit=20, window=600)
RESET_LIMIT = RateLimiter(limit=5, window=3600)


def client_ip(request: Request) -> str:
    """
    Адрес клиента. За прокси настоящий адрес отдаёт uvicorn, запущенный с
    `--proxy-headers`; без прокси — адрес соединения.
    """
    return (request.client.host if request.client else "") or "unknown"
