Struct SyncEnvelope 

pub struct SyncEnvelope {
    pub schema_version: Option<u32>,
    pub extras: Option<Value>,
}

Wire-level envelope that every sync record carries.

Embedded in each SyncEndpoint::Record via #[serde(flatten)] so the two fields end up at the top of the JSON object alongside the resource-specific columns. Lets the version-skew story live in one place — not duplicated on every resource type.

schema_version: which wire shape the daemon wrote this row with. None on the wire means “I’m not declaring one; treat as 1.” Client::sync fills this in from SyncEndpoint::CURRENT_SCHEMA_VERSION when a consumer leaves it None.

extras: free-form JSON map for fields the consumer’s schema version recognises but the platform’s doesn’t yet. The platform persists extras verbatim so a future deploy can promote a field out of it into a typed column without data loss. The platform deliberately does not echo extras back on GET — it’s an internal-storage construct, not a public field.

Both fields are optional in serialization so a row that ships neither stays on the small/fast path.

Fields

schema_version: Option<u32>

extras: Option<Value>

Implementations

impl SyncEnvelope

pub fn for_endpoint<E: SyncEndpoint + ?Sized>() -> Self

Build an envelope stamped with the endpoint’s CURRENT_SCHEMA_VERSION. Useful for daemon-side code that wants to construct a record with the version already filled in — Client::sync will also fill it in lazily, but doing it at construction time keeps tests and logs honest.

Trait Implementations

impl Clone for SyncEnvelope

fn clone(&self) -> SyncEnvelope

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SyncEnvelope

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

Formats the value using the given formatter.

impl Default for SyncEnvelope

fn default() -> SyncEnvelope

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SyncEnvelope

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SyncEnvelope

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

where __S: Serializer,

Serialize this value into the given Serde serializer.