Struct VendorStickinessMap 

pub struct VendorStickinessMap(/* private fields */);

BTreeMap-backed stickiness policy keyed by anti-bot VendorId.

Use with_builtin_defaults to seed the map with the 2026 guide defaults, then chain with_override to customise individual vendors before installing the result on a ProxyManager.

Example

use std::time::Duration;
use stygian_proxy::stickiness::{StickinessPolicy, VendorStickinessMap};
use stygian_proxy::types::VendorId;

let map = VendorStickinessMap::with_builtin_defaults();
assert_eq!(
    map.for_vendor(VendorId::Akamai),
    StickinessPolicy::StickyForTtl { ttl: Duration::from_mins(30) }
);

Implementations

impl VendorStickinessMap

pub const fn new() -> Self

Empty map — every vendor falls back to StickinessPolicy::FreshPerRequest at lookup time.

Example

use stygian_proxy::stickiness::{StickinessPolicy, VendorStickinessMap};
use stygian_proxy::types::VendorId;
let map = VendorStickinessMap::new();
assert!(map.is_empty());
assert_eq!(map.for_vendor(VendorId::Akamai), StickinessPolicy::FreshPerRequest);

pub fn with_builtin_defaults() -> Self

Built-in defaults from the 2026 scraping guide:

• Akamai → StickyForTtl 30 min
• Cloudflare → StickyForTtl 5 min
• Imperva → StickyForTtl 15 min
• PerimeterX → FreshPerDomain
• Kasada → FreshPerDomain
• DataDome → FreshPerRequest
• everything else → FreshPerRequest (safest default for unknown vendors)

Example

use std::time::Duration;
use stygian_proxy::stickiness::{StickinessPolicy, VendorStickinessMap};
use stygian_proxy::types::VendorId;

let map = VendorStickinessMap::with_builtin_defaults();
assert_eq!(
    map.for_vendor(VendorId::Akamai),
    StickinessPolicy::StickyForTtl { ttl: Duration::from_mins(30) }
);
assert_eq!(map.for_vendor(VendorId::DataDome), StickinessPolicy::FreshPerRequest);
assert_eq!(
    map.for_vendor(VendorId::PerimeterX),
    StickinessPolicy::FreshPerDomain
);

pub fn for_vendor(&self, vendor: VendorId) -> StickinessPolicy

Look up the policy for vendor.

Unknown vendors (including VendorId::Unknown) fall back to StickinessPolicy::FreshPerRequest — the safest default.

Example

use stygian_proxy::stickiness::{StickinessPolicy, VendorStickinessMap};
use stygian_proxy::types::VendorId;
let map = VendorStickinessMap::with_builtin_defaults();
assert_eq!(map.for_vendor(VendorId::DataDome), StickinessPolicy::FreshPerRequest);
assert_eq!(map.for_vendor(VendorId::Unknown), StickinessPolicy::FreshPerRequest);

pub fn with_override(self, vendor: VendorId, policy: StickinessPolicy) -> Self

Insert or replace the policy for vendor. Builder-style: takes self by value and returns the updated map so calls can be chained.

Example

use stygian_proxy::stickiness::{StickinessPolicy, VendorStickinessMap};
use stygian_proxy::types::VendorId;

let map = VendorStickinessMap::with_builtin_defaults()
    .with_override(VendorId::Akamai, StickinessPolicy::StickyForever);
assert_eq!(map.for_vendor(VendorId::Akamai), StickinessPolicy::StickyForever);

pub fn is_empty(&self) -> bool

Returns true when no vendor policies have been registered.

Example

use stygian_proxy::stickiness::VendorStickinessMap;
assert!(VendorStickinessMap::new().is_empty());
assert!(!VendorStickinessMap::with_builtin_defaults().is_empty());

pub fn len(&self) -> usize

Returns the number of registered vendor policies.

Example

use stygian_proxy::stickiness::VendorStickinessMap;
use stygian_proxy::types::VendorId;
let map = VendorStickinessMap::with_builtin_defaults();
assert_eq!(map.len(), 6);
let map = VendorStickinessMap::new()
    .with_override(VendorId::Akamai, stygian_proxy::stickiness::StickinessPolicy::StickyForever);
assert_eq!(map.len(), 1);

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

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

Example

use stygian_proxy::stickiness::{StickinessPolicy, VendorStickinessMap};
use stygian_proxy::types::VendorId;

let map = VendorStickinessMap::with_builtin_defaults();
let entries: Vec<_> = map.iter().collect();
// Sorted by VendorId discriminant order — `Akamai` < `Cloudflare`.
assert_eq!(entries.first().map(|(v, _)| *v), Some(VendorId::Akamai));

Trait Implementations

impl Clone for VendorStickinessMap

fn clone(&self) -> VendorStickinessMap

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VendorStickinessMap

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

Formats the value using the given formatter.

impl Default for VendorStickinessMap

fn default() -> VendorStickinessMap

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for VendorStickinessMap

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for VendorStickinessMap

impl PartialEq for VendorStickinessMap

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

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 VendorStickinessMap