Struct DomainState 

pub struct DomainState {
    pub host: String,
    pub last_outcome: Option<Outcome>,
    pub last_proxy: Option<String>,
    pub successes: u32,
    pub failures: u32,
    pub cooldown_until: Option<u64>,
    pub updated_at: u64,
}

Accumulated knowledge about a single host.

Fields

host: String

The host this state describes (e.g. example.com).

last_outcome: Option<Outcome>

The most recently recorded outcome, if any.

last_proxy: Option<String>

The egress proxy URL used on the most recent recorded attempt.

successes: u32

Count of successful attempts.

failures: u32

Count of failed attempts (challenged/blocked/rate-limited).

cooldown_until: Option<u64>

Unix timestamp (secs) before which the host should not be hit again.

updated_at: u64

Unix timestamp (secs) of the last update.

Implementations

impl DomainState

pub fn new(host: impl Into<String>) -> Self

Create a fresh, empty state for host.

pub fn record( &self, outcome: Outcome, proxy: Option<String>, now: u64, rate_limit_cooldown: Duration, ) -> Self

Returns a new state reflecting outcome recorded at now (Unix secs).

proxy is the egress in play (kept if None). Counting:

• Outcome::Success and Outcome::Challenged increment successes — in both cases the page was ultimately obtained (a challenge that cleared is a success, not a failure).
• Outcome::Blocked and Outcome::RateLimited increment failures.

cooldown_until models the rate-limit back-off window: it is set only by Outcome::RateLimited and cleared by every other outcome, so it always reflects the most recent outcome. The receiver is left untouched (immutable update).

pub fn in_cooldown(&self, now: u64) -> bool

Whether the host is still within its cooldown window at now.

pub fn cooldown_remaining(&self, now: u64) -> Option<Duration>

Remaining cooldown at now, if any.

Trait Implementations

impl Clone for DomainState

fn clone(&self) -> DomainState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DomainState

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for DomainState

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for DomainState

impl PartialEq for DomainState

fn eq(&self, other: &DomainState) -> 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 DomainState

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 DomainState