Struct CacheStore 

pub struct CacheStore { /* private fields */ }

Reader/writer for usage.json.

Implementations

impl CacheStore

pub fn new(root: PathBuf) -> Self

pub fn path(&self) -> PathBuf

pub fn read(&self) -> Result<Option<CachedUsage>, CacheError>

Return the cached entry or Ok(None) for any condition that should degrade to a cache miss: file not present, non-UTF-8 bytes, malformed JSON, schema_version mismatch, or cached_at in the future (clock skew). Only unexpected I/O errors (permission denied, etc.) surface as Err.

pub fn write(&self, entry: &CachedUsage) -> Result<(), CacheError>

Persist the entry via the atomic-rename helper. Creates the cache root on demand — no init step needed.

pub fn clear(&self) -> Result<(), CacheError>

Remove the cache file. Idempotent — Ok(()) on NotFound so callers don’t have to gate on existence first. Intended for invalidating cached data that’s tied to a no-longer-valid token: a still-fresh cache otherwise short-circuits the lock-active 401 guard for up to cache_duration.