Struct CachedProviderCatalog 

pub struct CachedProviderCatalog {
    pub provider: String,
    pub base_url_fingerprint: String,
    pub fetched_at: u64,
    pub ttl_secs: u64,
    pub offerings: Vec<CatalogOffering>,
    pub status: CatalogStatus,
}

A secret-free cached provider catalog for one provider + base-URL fingerprint.

Fields

provider: String

Provider id.

base_url_fingerprint: String

Base-URL fingerprint the rows were fetched from.

fetched_at: u64

Unix seconds of the last successful fetch (unchanged on failure).

ttl_secs: u64

Time-to-live, in seconds, after which rows are considered stale.

offerings: Vec<CatalogOffering>

Cached live offering rows (possibly empty after a failure with no prior).

status: CatalogStatus

Last known status of this entry.

Implementations

impl CachedProviderCatalog

pub fn age_secs(&self, now_unix: u64) -> u64

Age in seconds relative to now_unix, saturating at zero for clock skew.

pub fn is_stale(&self, now_unix: u64) -> bool

Whether the cached rows are past their TTL at now_unix.

A ttl_secs of zero means “always stale” (never serve as fresh).

pub fn is_fresh(&self, now_unix: u64) -> bool

Whether this entry may contribute live offerings at now_unix.

An entry is fresh only when it is within its TTL and its last recorded refresh succeeded. A Failed entry is never fresh even inside its TTL window — its rows survive a failed refresh for explicit fallback display via ProviderCatalogCache::get, but they are not served as current live data.

Trait Implementations

impl Clone for CachedProviderCatalog

fn clone(&self) -> CachedProviderCatalog

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CachedProviderCatalog

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CachedProviderCatalog

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for CachedProviderCatalog

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for CachedProviderCatalog

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 CachedProviderCatalog