Struct Fetched 

pub struct Fetched<T> {
    pub data: T,
    pub cache_policy: Option<CachePolicy>,
    pub meta: Option<Value>,
}

Available on crate feature core only.

A fetcher success carrying an optional server-derived cache policy.

Return this from a *_with_policy fetcher to let the server override the caller’s CachePolicy for the resolved resource (“server wins”):

• Fetched::new — no policy override; the resource keeps the caller’s policy.
• Fetched::with_policy — override the resource’s policy with the server’s.
• Fetched::with_meta (persist feature) — attach opaque metadata that flows into PersistedEntry::meta so it can be rehydrated on a cold start (e.g. an HTTP CacheMeta for cheap 304 refetches after relaunch).

cache_policy: None (the default) keeps the caller’s per-query policy unchanged, matching the plain Result<T, E> fetcher behavior exactly.

Fields

data: T

The fetched data.

cache_policy: Option<CachePolicy>

Server-derived cache policy. None keeps the caller’s policy.

meta: Option<Value>

Available on crate feature persist only.

Opaque metadata carried through to persistence (e.g. HTTP CacheMeta). None unless set via Fetched::with_meta. Only present under the persist feature so the ungated core layer stays serde_json-free.

Implementations

impl<T> Fetched<T>

pub fn new(data: T) -> Self

Wrap fetched data with no policy override (keep the caller’s policy).

Equivalent to returning the bare T from a plain Result<T, E> fetcher.

pub fn with_policy(data: T, policy: CachePolicy) -> Self

Wrap fetched data and override the resource’s cache policy with the server’s.

pub fn with_meta(self, meta: JsonValue) -> Self

Available on crate feature persist only.

Attach opaque metadata (e.g. a serialized HTTP CacheMeta) to this fetched value. Requires the persist feature; the metadata flows into PersistedEntry::meta when the resource is persisted, enabling cold-start revalidation.

Trait Implementations

impl<T: Clone> Clone for Fetched<T>

fn clone(&self) -> Fetched<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for Fetched<T>

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

Formats the value using the given formatter.