Struct CachedUrlSafety 

pub struct CachedUrlSafety { /* private fields */ }

UrlSafety with a TTL cache in front of any implementation, honouring the provider’s own durations: an entry lives for the verdict’s UrlVerdict::cache_ttl where the provider gave one, and for Self::with_negative_ttl where it did not.

The map is bounded (the push-auth rule: no unbounded resource on an isolate) and the mutex is never held across an await — hits are served and misses staged in short critical sections around the one inner call.

Implementations

impl CachedUrlSafety

pub fn new(inner: Arc<dyn UrlSafety>, clock: Arc<dyn Clock>) -> Self

Wraps inner, holding at most DEFAULT_CACHE_CAPACITY URLs and serving a provider-silent verdict for DEFAULT_NEGATIVE_TTL.

pub fn with_capacity(self, capacity: usize) -> Self

Caps the cache at capacity URLs; 0 falls back to DEFAULT_CACHE_CAPACITY — a cache that holds nothing is not a cache, and a caller who wants no caching simply does not decorate.

Past the bound, the entry that expires first is evicted: it is the one closest to needing a re-check anyway, so eviction costs one extra provider call, never correctness.

pub fn with_negative_ttl(self, ttl: Duration) -> Self

Overrides the TTL applied when a verdict’s provider said nothing (UrlVerdict::cache_ttl is None).

Trait Implementations

impl Debug for CachedUrlSafety

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

Never prints a URL: the map’s contents are the checked URLs.

impl UrlSafety for CachedUrlSafety

fn check<'life0, 'life1, 'async_trait>( &'life0 self, url: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<UrlVerdict, UrlSafetyError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Checks one URL. The returned verdict’s url equals the input, verbatim.

fn check_many<'life0, 'life1, 'async_trait>( &'life0 self, urls: &'life1 [String], ) -> Pin<Box<dyn Future<Output = Result<Vec<UrlVerdict>, UrlSafetyError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Checks many URLs; the results are in input order, one verdict per input. The default runs check_batch locally, then Self::check in a loop; a batch-friendly adapter overrides this with one provider call.