Struct PushSubscription 

#[non_exhaustive]
pub struct PushSubscription {
    pub id: Option<Id>,
    pub device_client_id: String,
    pub url: Option<String>,
    pub keys: Option<PushKeys>,
    pub verification_code: Option<String>,
    pub expires: Option<UTCDate>,
    pub types: Option<Vec<String>>,
    pub extra: Map<String, Value>,
}

A push subscription (RFC 8620 §7.2).

Every property other than deviceClientId is optional here because the same type carries a create request (no id, verificationCode or expires), a PushSubscription/get result (url and keys are never returned, RFC 8620 §7.2.1), and the server’s stored record. None fields are omitted on serialize; a JSON null deserializes to None.

Extension properties, such as chatPush from draft-atwood-jmap-chat-push-00, are carried in extra.

The Debug impl redacts url, keys.auth and verificationCode.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

id: Option<Id>

The id property: server-set and immutable.

device_client_id: String

The deviceClientId property: identifies the client and device.

url: Option<String>

The url property: absolute URL the server POSTs pushes to. The RFC requires it to begin with "https://"; this type does not check that.

keys: Option<PushKeys>

The keys property: RFC 8291 encryption keys, or None for none.

verification_code: Option<String>

The verificationCode property: None until the client echoes the code from the PushVerification.

expires: Option<UTCDate>

The expires property: the server sends nothing after this time.

types: Option<Vec<String>>

The types property: data types to push; None means all types.

extra: Map<String, Value>

Catch-all for extension properties (e.g. chatPush) and vendor / site / private fields not covered by the typed fields above, per workspace extras-preservation policy (see workspace AGENTS.md).

Trait Implementations

impl Clone for PushSubscription

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PushSubscription

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PushSubscription

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for PushSubscription

impl PartialEq for PushSubscription

fn eq(&self, other: &Self) -> bool

Equality operator ==.

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

Inequality operator !=.

impl Serialize for PushSubscription

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 PushSubscription