Struct TargetVendorCompatibility

Source

pub struct TargetVendorCompatibility { /* private fields */ }

Expand description

Mapping from anti-bot VendorId to the proxy’s declared TrustTier against that vendor.

default_blocked() returns a populated map with every known vendor marked as TrustTier::Blocked, which is the safe choice for free-list ingest: callers must explicitly opt-in to trusting a free-list pool for premium vendors.

Implementations§

Source §

impl TargetVendorCompatibility

Source

pub fn new() -> Self

Empty compatibility — every vendor falls back to TrustTier::Blocked at the requirement gate.

§Example

use stygian_proxy::types::TargetVendorCompatibility;
let c = TargetVendorCompatibility::default();
assert!(c.is_empty());
assert_eq!(c.get(stygian_proxy::types::VendorId::DataDome), None);

Source

pub fn default_blocked() -> Self

Returns a compatibility map with every known vendor marked TrustTier::Blocked.

Used by free-list fetchers to fail-secure on ingest: a free-list proxy cannot satisfy a target_vendor capability requirement unless the operator explicitly upgrades the tier.

§Example

use stygian_proxy::types::{TargetVendorCompatibility, TrustTier, VendorId};
let c = TargetVendorCompatibility::default_blocked();
assert_eq!(c.get(VendorId::DataDome), Some(TrustTier::Blocked));
assert_eq!(c.get(VendorId::Cloudflare), Some(TrustTier::Blocked));
assert!(!c.is_empty());

Source

pub fn get(&self, vendor: VendorId) -> Option<TrustTier>

Returns the declared tier for vendor, or None when unknown.

§Example

use stygian_proxy::types::{TargetVendorCompatibility, TrustTier, VendorId};
let c = TargetVendorCompatibility::default().set(VendorId::Akamai, TrustTier::Preferred);
assert_eq!(c.get(VendorId::Akamai), Some(TrustTier::Preferred));
assert_eq!(c.get(VendorId::DataDome), None);

Source

pub fn set(self, vendor: VendorId, tier: TrustTier) -> Self

Set the declared tier for vendor, replacing any prior value.

Builder-style: takes self by value and returns the updated TargetVendorCompatibility so calls can be chained.

§Example

use stygian_proxy::types::{TargetVendorCompatibility, TrustTier, VendorId};
let c = TargetVendorCompatibility::default()
    .set(VendorId::Cloudflare, TrustTier::Acceptable)
    .set(VendorId::Akamai, TrustTier::Preferred);
assert_eq!(c.get(VendorId::Cloudflare), Some(TrustTier::Acceptable));
assert_eq!(c.get(VendorId::Akamai), Some(TrustTier::Preferred));

Source

pub fn is_empty(&self) -> bool

Returns true when no vendor tiers have been declared.

§Example

use stygian_proxy::types::{TargetVendorCompatibility, TrustTier, VendorId};
assert!(TargetVendorCompatibility::default().is_empty());
assert!(!TargetVendorCompatibility::default_blocked().is_empty());
let c = TargetVendorCompatibility::default().set(VendorId::Cloudflare, TrustTier::Preferred);
assert!(!c.is_empty());

Source

pub fn len(&self) -> usize

Returns the number of declared vendor tiers.

§Example

use stygian_proxy::types::{TargetVendorCompatibility, TrustTier, VendorId};
let c = TargetVendorCompatibility::default();
assert_eq!(c.len(), 0);
let c = TargetVendorCompatibility::default().set(VendorId::Cloudflare, TrustTier::Preferred);
assert_eq!(c.len(), 1);

Source

pub fn iter(&self) -> impl Iterator<Item = (VendorId, TrustTier)> + '_

Iterate (vendor, tier) pairs in deterministic (sorted) order.

§Example

use stygian_proxy::types::{TargetVendorCompatibility, TrustTier, VendorId};
let c = TargetVendorCompatibility::default()
    .set(VendorId::DataDome, TrustTier::Preferred)
    .set(VendorId::Akamai, TrustTier::Acceptable);
let entries: Vec<_> = c.iter().collect();
// Sorted by VendorId discriminant order (Akamai < DataDome).
assert_eq!(entries.first().map(|(v, _)| *v), Some(VendorId::Akamai));
assert_eq!(entries.get(1).map(|(v, _)| *v), Some(VendorId::DataDome));