Struct PageSignature 

pub struct PageSignature {
    pub url: String,
    pub status_code: Option<u16>,
    pub body_markers: Vec<String>,
    pub header_set: Vec<String>,
    pub redirect_url: Option<String>,
    pub queue_position_hint: Option<u32>,
    pub vendor_hint: Option<String>,
}

Page signature consumed by the InterstitialClassifier.

The signature is the observation that a previous acquisition attempt produced. Callers attach the signature to an AcquisitionRequest via the AcquisitionRequest::interstitial field (see mod.rs for the runner integration).

Example

use stygian_browser::interstitial_router::PageSignature;

let signature = PageSignature::new(
    "https://example.com/cdn-cgi/challenge-platform/h/b",
    Some(403),
)
.with_body_marker("cf-chl-bypass")
.with_header("cf-mitigated");
assert_eq!(signature.body_markers.len(), 1);
assert_eq!(signature.header_set.len(), 1);

Fields

url: String

Target URL of the page.

status_code: Option<u16>

HTTP status code, when known.

body_markers: Vec<String>

Body substrings (case-insensitive) observed in the page. Markers are normalised to lower-case ASCII.

header_set: Vec<String>

Lower-case ASCII header names observed in the response.

redirect_url: Option<String>

Optional redirect target for a 3xx response.

queue_position_hint: Option<u32>

Optional queue position hint (1-based).

vendor_hint: Option<String>

Optional vendor hint (e.g. cloudflare, akamai).

Implementations

impl PageSignature

pub fn new(url: impl Into<String>, status_code: Option<u16>) -> Self

Build a signature with the supplied url and status_code and no other fields set.

pub fn with_body_marker(self, marker: impl Into<String>) -> Self

Builder: add a body marker (case-insensitive). The marker is trimmed and lower-cased; empty markers are ignored.

pub fn with_header(self, header: impl Into<String>) -> Self

Builder: add a header name (case-insensitive). The name is trimmed and lower-cased; empty names are ignored.

pub fn with_redirect_url(self, redirect_url: impl Into<String>) -> Self

Builder: set the redirect target.

pub const fn with_queue_position(self, position: u32) -> Self

Builder: set the queue position hint.

pub fn with_vendor_hint(self, vendor: impl Into<String>) -> Self

Builder: set the vendor hint.

pub fn with_body_markers(self, markers: Vec<String>) -> Self

Builder: replace the body marker set.

pub fn with_header_set(self, headers: Vec<String>) -> Self

Builder: replace the header set.

pub fn host(&self) -> Option<String>

Lower-case ASCII view of the URL host, when parseable. Returns None when the URL is empty or malformed.

pub fn url_contains(&self, needle_lower: &str) -> bool

true when the URL path (or query) contains the given lower-case substring.

pub fn body_contains(&self, needle_lower: &str) -> bool

true when any of the body markers contain the given lower-case substring.

pub fn has_header(&self, name_lower: &str) -> bool

true when the header set contains the given lower-case header name.

pub fn unique_headers(&self) -> BTreeSet<String>

Lower-case unique header set (for diagnostics).

Trait Implementations

impl Clone for PageSignature

fn clone(&self) -> PageSignature

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PageSignature

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

Formats the value using the given formatter.

impl Default for PageSignature

fn default() -> PageSignature

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for PageSignature

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for PageSignature

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for PageSignature

impl StructuralPartialEq for PageSignature