Enum ChatWsFrame 

#[non_exhaustive]
pub enum ChatWsFrame {
    StateChange(StateChange),
    Response(JmapResponse),
    ChatTyping(ChatTypingEvent),
    ChatPresence(ChatPresenceEvent),
    Unknown {
        type_name: String,
    },
}

A parsed frame from the JMAP Chat WebSocket, including chat-specific variants.

Marked #[non_exhaustive] because the spec may define additional @type values in future revisions.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

StateChange(StateChange)

RFC 8620 §7.1 StateChange — one or more object types have changed state.

Response(JmapResponse)

RFC 8887 Response — reply to a JMAP request sent on this connection.

ChatTyping(ChatTypingEvent)

Ephemeral typing indicator (draft-atwood-jmap-chat-wss-00). Delivered only after a ChatStreamEnable subscription has been sent.

ChatPresence(ChatPresenceEvent)

Ephemeral presence update (draft-atwood-jmap-chat-wss-00). Delivered only after a ChatStreamEnable subscription has been sent.

Unknown

Unrecognized @type — ignored per forward-compatibility rules (clients SHOULD ignore unknown message types per RFC 8887 §4.3.1).

Also produced when a known chat type fails to deserialize — type_name will be "ChatTypingEvent" or "ChatPresenceEvent" in that case.

Fields

type_name: String

The unknown-frame discriminant value. Possible sources:

• The verbatim @type string from the underlying WsFrame::Unknown when the chat-side parser does not recognise it (typical: future chat-extension events).
• "<no @type>" (the literal string) when the underlying WsFrame::Unknown itself reported an absent @type field — that sentinel originates in jmap-base-client and propagates through unchanged.
• "ChatTypingEvent" or "ChatPresenceEvent" when a known chat-event type failed payload deserialization (see the parent variant’s doc comment above).
• "<unknown>" when the underlying WsFrame is a future non-Unknown variant added by jmap-base-client after parse_chat_ws_frame was last updated.

Callers wishing to distinguish “server sent JSON without @type” from “this parser doesn’t recognise the value” must match on the literal strings; the field intentionally flattens both cases into one String to keep the variant shape stable across future spec edits.

Trait Implementations

impl Clone for ChatWsFrame

fn clone(&self) -> ChatWsFrame

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ChatWsFrame

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

Formats the value using the given formatter.