Enum ClientEvent 

#[non_exhaustive]
pub enum ClientEvent {
    StatusChanged {
        status: ClientStatus,
        failure: Option<ClientFailure>,
    },
    TransactionChanged(TransactionEvent),
    ChatUpserted {
        chat_id: InlineId,
    },
    ChatDeleted {
        chat_id: InlineId,
    },
    ChatParticipantsChanged {
        chat_id: InlineId,
    },
    UserUpserted {
        user_id: InlineId,
    },
    SpaceUpserted {
        space_id: InlineId,
    },
    SpaceMemberChanged {
        space_id: InlineId,
        user_id: InlineId,
        removed: bool,
    },
    UserSettingsChanged {},
    MessageActionInvoked {
        interaction_id: InlineId,
        chat_id: InlineId,
        message_id: InlineId,
        actor_user_id: InlineId,
        action_id: String,
        data: Vec<u8>,
    },
    MessageActionAnswered {
        interaction_id: InlineId,
        toast: Option<String>,
    },
    MessageUpserted {
        chat_id: InlineId,
        message_id: InlineId,
    },
    MessageStored {
        message: MessageRecord,
    },
    MessageDeleted {
        chat_id: InlineId,
        message_id: InlineId,
    },
    ChatHistoryCleared {
        chat_id: InlineId,
        before_date: Option<i64>,
    },
    ReactionChanged {
        chat_id: InlineId,
        message_id: InlineId,
        user_id: InlineId,
        reaction: String,
        removed: bool,
    },
    ReadStateChanged {
        chat_id: InlineId,
    },
    Typing {
        chat_id: InlineId,
        user_id: InlineId,
        is_typing: bool,
    },
    UserStatusChanged {
        user_id: InlineId,
        is_online: Option<bool>,
        last_online: Option<i64>,
    },
    BotPresenceChanged {
        bot_user_id: InlineId,
        chat_id: Option<InlineId>,
        kind: String,
        comment: Option<String>,
        avatar_changed: bool,
    },
    NewMessageNotification {
        message: MessageRecord,
        reason: String,
    },
}

Committed client event for apps, bridges, agents, and hosts.

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.

StatusChanged

Connection/auth status changed.

Fields

status: ClientStatus

New client status.

failure: Option<ClientFailure>

Optional redacted failure details.

TransactionChanged(TransactionEvent)

A durable transaction changed state.

ChatUpserted

A chat was inserted or updated in the local store.

Fields

chat_id: InlineId

Inline chat ID.

ChatDeleted

A chat was deleted from durable client state.

Fields

chat_id: InlineId

Inline chat ID.

ChatParticipantsChanged

The participant snapshot for a chat changed.

Fields

chat_id: InlineId

Inline chat ID.

UserUpserted

A user was inserted or updated in the local store.

Fields

user_id: InlineId

Inline user ID.

SpaceUpserted

A space was inserted or updated in durable client state.

Fields

space_id: InlineId

Inline space ID.

SpaceMemberChanged

Durable membership for a space changed.

Fields

space_id: InlineId

Inline space ID.

user_id: InlineId

Inline user ID.

removed: bool

Whether the member was removed.

UserSettingsChanged

Durable global user settings changed.

MessageActionInvoked

A bot message action was invoked and requires lossless host handling.

Fields

interaction_id: InlineId

Server interaction ID.

chat_id: InlineId

Chat containing the action.

message_id: InlineId

Message containing the action.

actor_user_id: InlineId

User who invoked the action.

action_id: String

Bot-defined action ID.

data: Vec<u8>

Opaque bot-defined payload.

MessageActionAnswered

A previously invoked message action received a UI response.

Fields

interaction_id: InlineId

Server interaction ID.

toast: Option<String>

Optional toast text supplied by the bot.

MessageUpserted

A message was inserted or updated in the local store.

Fields

chat_id: InlineId

Inline chat ID.

message_id: InlineId

Inline message ID.

MessageStored

A message was inserted or updated and the committed record is available.

Fields

message: MessageRecord

Committed message record.

MessageDeleted

A message was deleted or unsent.

Fields

chat_id: InlineId

Inline chat ID.

message_id: InlineId

Inline message ID.

ChatHistoryCleared

Stored history was cleared for a chat, optionally before a timestamp.

Fields

chat_id: InlineId

Inline chat ID.

before_date: Option<i64>

Unix timestamp cutoff; None means all history.

ReactionChanged

Reactions for a message changed.

Fields

chat_id: InlineId

Inline chat ID.

message_id: InlineId

Inline message ID.

user_id: InlineId

Inline user ID that changed the reaction.

reaction: String

Reaction emoji.

removed: bool

Whether the reaction was removed.

ReadStateChanged

Read state changed for a chat.

Fields

chat_id: InlineId

Inline chat ID.

Typing

Typing state changed.

Fields

chat_id: InlineId

Inline chat ID.

user_id: InlineId

Inline user ID.

is_typing: bool

Whether the user is typing.

UserStatusChanged

Transient user presence changed.

Fields

user_id: InlineId

Inline user ID.

is_online: Option<bool>

Some(true) for online, Some(false) for offline, or None when hidden/unknown.

last_online: Option<i64>

Last-online Unix timestamp, when disclosed.

BotPresenceChanged

Transient bot activity/presence changed for a peer.

Fields

bot_user_id: InlineId

Inline bot user ID.

chat_id: Option<InlineId>

Resolved chat ID, when available.

kind: String

Stable protobuf presence kind name.

comment: Option<String>

Optional bot-supplied status comment.

avatar_changed: bool

Whether the bot avatar changed.

NewMessageNotification

A notification-class message update was received.

Fields

message: MessageRecord

Message referenced by the notification.

reason: String

Stable protobuf notification reason name.

Implementations

impl ClientEvent

pub const fn reliability(&self) -> EventReliability

Returns the event delivery reliability class.

Trait Implementations

impl Clone for ClientEvent

fn clone(&self) -> ClientEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ClientEvent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ClientEvent

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ClientEvent

impl PartialEq for ClientEvent

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ClientEvent

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 ClientEvent