Struct CacheEnvelope 

pub struct CacheEnvelope<T> {
    pub magic: [u8; 4],
    pub version: u32,
    pub payload: T,
}

Versioned envelope for cache entries.

Every cache entry is wrapped in this envelope to enable:

• Corruption detection: Invalid magic → reject entry
• Schema evolution: Version mismatch → evict and recompute
• Observability: Track version mismatches in metrics

Format

┌─────────────────┬─────────────────┬──────────────────────────┐
│  magic: [u8; 4] │ version: u32    │  payload: T              │
└─────────────────┴─────────────────┴──────────────────────────┘

Example

use cache_kit::serialization::CacheEnvelope;

let envelope = CacheEnvelope::new("data");
assert_eq!(envelope.magic, *b"CKIT");

Fields

magic: [u8; 4]

Magic header: must be b“CKIT“

version: u32

Schema version: must match CURRENT_SCHEMA_VERSION

payload: T

The actual cached data

Implementations

impl<T> CacheEnvelope<T>

pub fn new(payload: T) -> Self

Create a new envelope with current magic and version.

Example

use cache_kit::serialization::CacheEnvelope;

let envelope = CacheEnvelope::new(42);
assert_eq!(envelope.payload, 42);

Trait Implementations

impl<T: Clone> Clone for CacheEnvelope<T>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for CacheEnvelope<T>

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

Formats the value using the given formatter.

impl<'de, T> Deserialize<'de> for CacheEnvelope<T>

where T: Deserialize<'de>,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T: PartialEq> PartialEq for CacheEnvelope<T>

fn eq(&self, other: &CacheEnvelope<T>) -> bool

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<T> Serialize for CacheEnvelope<T>

where T: Serialize,

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<T> StructuralPartialEq for CacheEnvelope<T>