Struct ProviderCatalogCache 

pub struct ProviderCatalogCache {
    pub entries: BTreeMap<String, CachedProviderCatalog>,
}

A secret-free store of cached provider catalogs, keyed by provider + base-URL fingerprint.

Scoping rule (#3385): the SAME provider on DIFFERENT base URLs must not share rows, and DIFFERENT providers on the same base URL must not share rows.

Fields

entries: BTreeMap<String, CachedProviderCatalog>

Entries keyed by ProviderCatalogCache::cache_key.

Implementations

impl ProviderCatalogCache

pub fn new() -> Self

Construct an empty cache.

pub fn cache_key(provider: &str, base_url_fingerprint: &str) -> String

Compute the composite cache key for a provider + base-URL fingerprint.

pub fn get( &self, provider: &str, base_url_fingerprint: &str, ) -> Option<&CachedProviderCatalog>

Look up a cached entry by provider + base-URL fingerprint.

pub fn record_success(&mut self, delta: ProviderCatalogDelta, ttl_secs: u64)

Record a successful refresh, replacing any prior entry for this scope.

Offering sources are normalized to CatalogSource::Live with the delta’s fingerprint and fetched_at, so cached rows always carry honest provenance regardless of how the delta was assembled.

pub fn record_failure( &mut self, provider: &str, base_url_fingerprint: &str, reason: CatalogRefreshError, )

Record a refresh failure.

Previously cached rows for this scope are preserved (so the UI can still offer them with a visible “stale/failed” status); only the status is updated. When no prior entry exists, an empty Failed entry is created so the failure is observable.

pub fn status( &self, provider: &str, base_url_fingerprint: &str, now_unix: u64, ) -> CatalogStatus

The resolved status of an entry at now_unix.

A Fresh-recorded entry that has since aged past its TTL reports Stale; Failed/Unknown are returned as stored.

pub fn fresh_offerings( &self, provider: &str, base_url_fingerprint: &str, now_unix: u64, ) -> Vec<CatalogOffering>

Fresh (within-TTL) live offerings for one provider + base URL at now_unix. Stale or failed entries contribute nothing here; callers fall back to bundled/configured rows and surface the status separately.

pub fn all_fresh_offerings(&self, now_unix: u64) -> Vec<CatalogOffering>

All fresh live offerings across every cached provider + base URL.

pub fn all_visible_offerings(&self, _now_unix: u64) -> Vec<CatalogOffering>

Live offerings that pickers may still show: fresh rows plus stale / prior rows that survived a failed refresh (#4139).

Unlike Self::all_fresh_offerings, this keeps past-TTL and Failed-status entries as long as they still hold offering rows. Empty entries contribute nothing; callers fall back to the bundled snapshot. now_unix is accepted for API symmetry with the fresh helper (age chips live above this layer).

Trait Implementations

impl Clone for ProviderCatalogCache

fn clone(&self) -> ProviderCatalogCache

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProviderCatalogCache

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

Formats the value using the given formatter.

impl Default for ProviderCatalogCache

fn default() -> ProviderCatalogCache

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ProviderCatalogCache

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ProviderCatalogCache

fn eq(&self, other: &ProviderCatalogCache) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for ProviderCatalogCache

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 ProviderCatalogCache