Module proxy 

Proxy list + rotation primitives shared across the HTTP, crawl, and CDP paths.

A ProxyRotator holds a set of validated ProxyEntry and selects one per request according to a ProxyRotation strategy. The rotator is built once (from config) or per request (BYOP) and is cheap to share behind an Arc.

Safety

Proxy URLs are validated up front via ProxyEntry::parse. A malformed entry is a hard error — we never silently fall back to a direct (no-proxy) connection, which would leak the host’s real IP. Callers map the returned error string to the appropriate crate::CrwError variant (ConfigError at startup, InvalidRequest for per-request BYOP).

Structs

ProxyEntry

A single validated proxy endpoint.

ProxyRotator

A pool of validated proxies plus a selection strategy.

Enums

ProxyRotation

Strategy for selecting a proxy from a ProxyRotator’s pool.