Struct MessageExtras 

pub struct MessageExtras {
    pub headers: Option<HashMap<String, ExtrasValue>>,
    pub ephemeral: Option<bool>,
    pub idempotency_key: Option<String>,
    pub echo: Option<bool>,
}

Structured metadata envelope for V2-specific message features.

Present on the wire for V2 connections only. V1 connections receive messages with extras stripped entirely. Pusher SDKs ignore unknown fields so the field is safe to carry through internal pipelines even when the publisher is V1.

Fields

headers: Option<HashMap<String, ExtrasValue>>

Flat metadata for server-side event name filtering. Must be a flat object — no nested objects, no arrays.

ephemeral: Option<bool>

If true: skip connection recovery buffer and webhook forwarding. Deliver to currently connected V2 subscribers only.

idempotency_key: Option<String>

Server-side deduplication key. If the same key arrives again within the app’s idempotency TTL window, the message is silently dropped.

echo: Option<bool>

Per-message echo control. Overrides the connection-level echo setting when explicitly set.

Implementations

impl MessageExtras

pub fn validate_headers_from_json(raw: &Value) -> Result<(), String>

Validate that headers (if present) contain only flat scalar values. This is structurally guaranteed by ExtrasValue having no Object/Array variants, but this method provides an explicit check with a clear error when validating raw JSON before deserialization.

Trait Implementations

impl Clone for MessageExtras

fn clone(&self) -> MessageExtras

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MessageExtras

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

Formats the value using the given formatter.

impl Default for MessageExtras

fn default() -> MessageExtras

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for MessageExtras

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for MessageExtras

fn eq(&self, other: &MessageExtras) -> 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 Serialize for MessageExtras

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 MessageExtras