Enum InterstitialRoute 

pub enum InterstitialRoute {
    WaitAndRetry {
        interval: Duration,
        max_retries: u32,
        queue_position: Option<u32>,
    },
    ChallengeSolve {
        vendor_hint: Option<String>,
        allowed_strategies: Vec<StrategyUsed>,
        solve_budget: Duration,
    },
    HardBlock {
        escalate_to: StrategyUsed,
        rotate_session: bool,
        refresh_sticky: bool,
    },
    Transient {
        follow_redirect: bool,
        max_hops: u32,
    },
}

Dedicated acquisition route per InterstitialKind.

Each variant carries the per-kind tunables. The route is purely declarative — the actual acquisition ladder adjustment is done by the calling layer (or by the runner, when InterstitialPolicy::short_circuit_on_classified is true).

Variants

WaitAndRetry

Wait interval for up to max_retries attempts. Carries the optional queue_position (e.g. “you are #5 in line”) so the caller can scale the wait by the position.

Fields

interval: Duration

Wait interval between retries.

max_retries: u32

Maximum retry attempts.

queue_position: Option<u32>

Optional queue position hint extracted from the page (1-based, where 1 = first in line).

ChallengeSolve

Escalate to a challenge-solving strategy with the given solve_budget. The optional vendor_hint narrows the strategy (e.g. cloudflare, perimeterx).

Fields

vendor_hint: Option<String>

Optional vendor hint extracted from the page markers (e.g. cloudflare, akamai).

allowed_strategies: Vec<StrategyUsed>

Strategies the caller may attempt.

solve_budget: Duration

Maximum wall-clock budget for the solve.

HardBlock

Terminal vendor block. Escalate to escalate_to, optionally rotate the proxy session, and optionally invalidate the sticky pool context.

Fields

escalate_to: StrategyUsed

Strategy to escalate to.

rotate_session: bool

Whether to rotate the proxy session.

refresh_sticky: bool

Whether to invalidate the sticky pool context.

Transient

Follow up to max_hops redirect hops and then re-classify the result.

Fields

follow_redirect: bool

Whether to follow the redirect.

max_hops: u32

Maximum redirect hops to follow.

Implementations

impl InterstitialRoute

pub const fn label(&self) -> &'static str

Stable snake_case route name.

Trait Implementations

impl Clone for InterstitialRoute

fn clone(&self) -> InterstitialRoute

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for InterstitialRoute

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for InterstitialRoute

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for InterstitialRoute

impl PartialEq for InterstitialRoute

fn eq(&self, other: &InterstitialRoute) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for InterstitialRoute

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for InterstitialRoute