"""freshporno.org — KVS (kt_player) direct stream extractor. Patrz app/extractors/tubes/_kvs.py.

Flashvars `video_url`/`video_alt_url`/`video_alt_url2` = `function/0/...get_file/...` +
`license_code` (silnik identyczny z yespornvip/pornditt). Resolve server-side: decode +
follow 302 → `cdn4.freshporno.org/remote_control.php?time=&cv=...` (206 video/mp4).

2026-06-04 (DevTools + cross-IP re-test, naprawia błędny wniosek z #20): finalny CDN url
jest **portable cross-IP** (token time-bound, NIE IP-bound — VPS odtworzył token
wygenerowany z residential IP → 206) ale wymaga **browser-podobnego TLS** (curl_cffi
chrome / ExoPlayer/okhttp → 206; plain curl → connection 000). W #20 testowałem finalny
URL plain-curl-em poza sesją → 000 → błędnie uznałem „nieosiągalny z residential" i
zostawiłem na WebView. _kvs.resolve_kvs używa curl_cffi chrome impersonation, więc dociera
do cdn4; mobile (ExoPlayer) gra direct. Native, multi-quality, zero WebView/proxy/reklam.
"""
from __future__ import annotations

from app.extractors._models import StreamSource
from app.extractors.tubes import _kvs

_BASE = "https://freshporno.org"


def extract(page_url: str, *, timeout: float = 60.0) -> list[StreamSource] | None:
    return _kvs.resolve_kvs(page_url, base_url=_BASE, timeout=timeout)