Struct ResolverChain 

pub struct ResolverChain { /* private fields */ }

The resolver chain itself.

Clone-cheap (everything sits behind Arcs) so callers can pass it to spawned tasks freely.

Implementations

impl ResolverChain

pub fn new(resolvers: Vec<Arc<dyn AgentResolver>>) -> Self

Construct a chain from a set of resolvers — one per scheme.

Two resolvers with the same scheme: the last one wins. That’s useful at test time but a logical error in production; callers should ensure scheme uniqueness when wiring providers.

pub fn with_capacity( resolvers: Vec<Arc<dyn AgentResolver>>, capacity: usize, ttl: Duration, ) -> Self

Like new but with caller-supplied capacity and TTL. Mostly for tests; production uses DEFAULT_TTL and DEFAULT_CAPACITY.

pub async fn resolve( &self, handle: &str, ) -> Result<ResolvedAgent, ResolverError>

Resolve a handle, returning a fresh-or-cached ResolvedAgent.

Steps:

1. Cache hit, fresh (age < ttl) → return immediately.
2. Cache hit, stale (age >= ttl) → conditional GET; on 304 extend TTL and serve cached record; on fresh fetch update.
3. Cache miss → single-flight: first caller fetches; other concurrent callers wait on a Notify then re-read the cache.

pub async fn invalidate(&self, handle: &str) -> Result<(), ResolverError>

Force eviction of a handle from the cache. Used when an external signal (rotation event, revoke) renders the cached record stale.

pub async fn cache_len(&self) -> usize

Number of entries currently cached. Test-friendly accessor.

Trait Implementations

impl Clone for ResolverChain

fn clone(&self) -> ResolverChain

Returns a duplicate of the value.

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

Performs copy-assignment from source.