atagen

macltok

public
Star0
Watch0
31ce2453c82f470aa8b5d3861ab0eec4273afc5d
3
ssh://brewery@pls.lobotomise.me:33/atagen/macltok.git

Blame: src/model.rs

96fdf90aacd6atagen2026-09-08 08:24 UTC1
use std::{fmt, sync::Arc};
96fdf90aacd6atagen2026-09-08 08:24 UTC2
96fdf90aacd6atagen2026-09-08 08:24 UTC3
use ruma::{
96fdf90aacd6atagen2026-09-08 08:24 UTC4
    OwnedDeviceId, OwnedEventId, OwnedMxcUri, OwnedRoomAliasId, OwnedRoomId, OwnedRoomOrAliasId,
96fdf90aacd6atagen2026-09-08 08:24 UTC5
    OwnedServerName, OwnedTransactionId, OwnedUserId,
31ce2453c82fatagen2026-09-24 13:07 UTC6
    events::{
31ce2453c82fatagen2026-09-24 13:07 UTC7
        AnyGlobalAccountDataEventContent, AnyRoomAccountDataEventContent, AnySyncTimelineEvent,
31ce2453c82fatagen2026-09-24 13:07 UTC8
        GlobalAccountDataEventType, RoomAccountDataEventType,
31ce2453c82fatagen2026-09-24 13:07 UTC9
        room::member::StrippedRoomMemberEvent,
31ce2453c82fatagen2026-09-24 13:07 UTC10
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC11
    serde::Raw,
96fdf90aacd6atagen2026-09-08 08:24 UTC12
};
96fdf90aacd6atagen2026-09-08 08:24 UTC13
#[cfg(feature = "serde")]
96fdf90aacd6atagen2026-09-08 08:24 UTC14
use serde::{Deserialize, Serialize};
96fdf90aacd6atagen2026-09-08 08:24 UTC15
31ce2453c82fatagen2026-09-24 13:07 UTC16
/// every command answers exactly once through `ClientHandle::send` or `execute`.
31ce2453c82fatagen2026-09-24 13:07 UTC17
/// the event stream only ever carries state
31ce2453c82fatagen2026-09-24 13:07 UTC18
#[derive(Debug)]
96fdf90aacd6atagen2026-09-08 08:24 UTC19
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC20
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC21
pub enum Command {
96fdf90aacd6atagen2026-09-08 08:24 UTC22
    Account(AccountCommand),
96fdf90aacd6atagen2026-09-08 08:24 UTC23
    Room(RoomCommand),
96fdf90aacd6atagen2026-09-08 08:24 UTC24
    Timeline(TimelineCommand),
96fdf90aacd6atagen2026-09-08 08:24 UTC25
    Media(MediaCommand),
96fdf90aacd6atagen2026-09-08 08:24 UTC26
    Encryption(EncryptionCommand),
96fdf90aacd6atagen2026-09-08 08:24 UTC27
    Notification(NotificationCommand),
96fdf90aacd6atagen2026-09-08 08:24 UTC28
    Lifecycle(LifecycleCommand),
96fdf90aacd6atagen2026-09-08 08:24 UTC29
}
96fdf90aacd6atagen2026-09-08 08:24 UTC30
31ce2453c82fatagen2026-09-24 13:07 UTC31
#[derive(Debug)]
96fdf90aacd6atagen2026-09-08 08:24 UTC32
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC33
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC34
pub enum AccountCommand {
96fdf90aacd6atagen2026-09-08 08:24 UTC35
    Logout,
31ce2453c82fatagen2026-09-24 13:07 UTC36
    SetAccountData {
31ce2453c82fatagen2026-09-24 13:07 UTC37
        event_type: GlobalAccountDataEventType,
31ce2453c82fatagen2026-09-24 13:07 UTC38
        content: Raw<AnyGlobalAccountDataEventContent>,
31ce2453c82fatagen2026-09-24 13:07 UTC39
    },
31ce2453c82fatagen2026-09-24 13:07 UTC40
    SetDisplayName(Option<String>),
31ce2453c82fatagen2026-09-24 13:07 UTC41
    SetAvatar(Option<OwnedMxcUri>),
31ce2453c82fatagen2026-09-24 13:07 UTC42
    /// uploads the image and points the profile at it, same byte cap as any upload
31ce2453c82fatagen2026-09-24 13:07 UTC43
    UploadAvatar {
31ce2453c82fatagen2026-09-24 13:07 UTC44
        mimetype: String,
31ce2453c82fatagen2026-09-24 13:07 UTC45
        bytes: Vec<u8>,
31ce2453c82fatagen2026-09-24 13:07 UTC46
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC47
    RenameDevice {
96fdf90aacd6atagen2026-09-08 08:24 UTC48
        device_id: OwnedDeviceId,
96fdf90aacd6atagen2026-09-08 08:24 UTC49
        display_name: String,
96fdf90aacd6atagen2026-09-08 08:24 UTC50
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC51
    DeleteDevices {
96fdf90aacd6atagen2026-09-08 08:24 UTC52
        device_ids: Vec<OwnedDeviceId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC53
        auth: Option<crate::InteractiveAuth>,
96fdf90aacd6atagen2026-09-08 08:24 UTC54
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC55
}
96fdf90aacd6atagen2026-09-08 08:24 UTC56
31ce2453c82fatagen2026-09-24 13:07 UTC57
#[derive(Clone, Debug)]
96fdf90aacd6atagen2026-09-08 08:24 UTC58
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC59
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC60
pub enum RoomCommand {
31ce2453c82fatagen2026-09-24 13:07 UTC61
    /// the snapshot turns up as `Event::TimelineReset`. opening an open room sends a fresh one
96fdf90aacd6atagen2026-09-08 08:24 UTC62
    Open(OwnedRoomId),
96fdf90aacd6atagen2026-09-08 08:24 UTC63
    Close(OwnedRoomId),
96fdf90aacd6atagen2026-09-08 08:24 UTC64
    Join {
96fdf90aacd6atagen2026-09-08 08:24 UTC65
        room: OwnedRoomOrAliasId,
96fdf90aacd6atagen2026-09-08 08:24 UTC66
        via: Vec<OwnedServerName>,
96fdf90aacd6atagen2026-09-08 08:24 UTC67
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC68
    Leave(OwnedRoomId),
96fdf90aacd6atagen2026-09-08 08:24 UTC69
    Forget(OwnedRoomId),
96fdf90aacd6atagen2026-09-08 08:24 UTC70
    AcceptInvite(OwnedRoomId),
96fdf90aacd6atagen2026-09-08 08:24 UTC71
    RejectInvite(OwnedRoomId),
96fdf90aacd6atagen2026-09-08 08:24 UTC72
    InviteUser {
96fdf90aacd6atagen2026-09-08 08:24 UTC73
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC74
        user_id: OwnedUserId,
96fdf90aacd6atagen2026-09-08 08:24 UTC75
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC76
    KickUser {
96fdf90aacd6atagen2026-09-08 08:24 UTC77
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC78
        user_id: OwnedUserId,
96fdf90aacd6atagen2026-09-08 08:24 UTC79
        reason: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC80
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC81
    BanUser {
96fdf90aacd6atagen2026-09-08 08:24 UTC82
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC83
        user_id: OwnedUserId,
96fdf90aacd6atagen2026-09-08 08:24 UTC84
        reason: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC85
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC86
    UnbanUser {
96fdf90aacd6atagen2026-09-08 08:24 UTC87
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC88
        user_id: OwnedUserId,
96fdf90aacd6atagen2026-09-08 08:24 UTC89
        reason: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC90
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC91
    SetPowerLevels {
96fdf90aacd6atagen2026-09-08 08:24 UTC92
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC93
        changes: PowerLevelChanges,
96fdf90aacd6atagen2026-09-08 08:24 UTC94
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC95
    SetUserPowerLevel {
96fdf90aacd6atagen2026-09-08 08:24 UTC96
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC97
        user_id: OwnedUserId,
96fdf90aacd6atagen2026-09-08 08:24 UTC98
        level: i64,
96fdf90aacd6atagen2026-09-08 08:24 UTC99
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC100
    Create(CreateRoomOptions),
fa9114fcf75fatagen2026-09-24 12:51 UTC101
    /// hands back the existing dm if there is one
96fdf90aacd6atagen2026-09-08 08:24 UTC102
    CreateDirect(OwnedUserId),
96fdf90aacd6atagen2026-09-08 08:24 UTC103
    CancelSend {
96fdf90aacd6atagen2026-09-08 08:24 UTC104
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC105
        transaction_id: OwnedTransactionId,
96fdf90aacd6atagen2026-09-08 08:24 UTC106
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC107
    RetrySend {
96fdf90aacd6atagen2026-09-08 08:24 UTC108
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC109
        transaction_id: OwnedTransactionId,
96fdf90aacd6atagen2026-09-08 08:24 UTC110
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC111
    SetTyping {
96fdf90aacd6atagen2026-09-08 08:24 UTC112
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC113
        typing: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC114
    },
31ce2453c82fatagen2026-09-24 13:07 UTC115
    SetAccountData {
31ce2453c82fatagen2026-09-24 13:07 UTC116
        room_id: OwnedRoomId,
31ce2453c82fatagen2026-09-24 13:07 UTC117
        event_type: RoomAccountDataEventType,
31ce2453c82fatagen2026-09-24 13:07 UTC118
        content: Raw<AnyRoomAccountDataEventContent>,
31ce2453c82fatagen2026-09-24 13:07 UTC119
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC120
}
96fdf90aacd6atagen2026-09-08 08:24 UTC121
96fdf90aacd6atagen2026-09-08 08:24 UTC122
#[derive(Clone, Debug, Default, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC123
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC124
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC125
pub struct CreateRoomOptions {
96fdf90aacd6atagen2026-09-08 08:24 UTC126
    pub name: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC127
    pub topic: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC128
    pub alias_localpart: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC129
    pub invite: Vec<OwnedUserId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC130
    pub direct: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC131
    pub visibility: RoomVisibility,
96fdf90aacd6atagen2026-09-08 08:24 UTC132
    pub preset: Option<RoomPreset>,
96fdf90aacd6atagen2026-09-08 08:24 UTC133
}
96fdf90aacd6atagen2026-09-08 08:24 UTC134
31ce2453c82fatagen2026-09-24 13:07 UTC135
impl CreateRoomOptions {
31ce2453c82fatagen2026-09-24 13:07 UTC136
    #[must_use]
31ce2453c82fatagen2026-09-24 13:07 UTC137
    pub fn with_name(mut self, name: impl Into<String>) -> Self {
31ce2453c82fatagen2026-09-24 13:07 UTC138
        self.name = Some(name.into());
31ce2453c82fatagen2026-09-24 13:07 UTC139
        self
31ce2453c82fatagen2026-09-24 13:07 UTC140
    }
31ce2453c82fatagen2026-09-24 13:07 UTC141
31ce2453c82fatagen2026-09-24 13:07 UTC142
    #[must_use]
31ce2453c82fatagen2026-09-24 13:07 UTC143
    pub fn with_topic(mut self, topic: impl Into<String>) -> Self {
31ce2453c82fatagen2026-09-24 13:07 UTC144
        self.topic = Some(topic.into());
31ce2453c82fatagen2026-09-24 13:07 UTC145
        self
31ce2453c82fatagen2026-09-24 13:07 UTC146
    }
31ce2453c82fatagen2026-09-24 13:07 UTC147
31ce2453c82fatagen2026-09-24 13:07 UTC148
    #[must_use]
31ce2453c82fatagen2026-09-24 13:07 UTC149
    pub fn with_alias_localpart(mut self, localpart: impl Into<String>) -> Self {
31ce2453c82fatagen2026-09-24 13:07 UTC150
        self.alias_localpart = Some(localpart.into());
31ce2453c82fatagen2026-09-24 13:07 UTC151
        self
31ce2453c82fatagen2026-09-24 13:07 UTC152
    }
31ce2453c82fatagen2026-09-24 13:07 UTC153
31ce2453c82fatagen2026-09-24 13:07 UTC154
    #[must_use]
31ce2453c82fatagen2026-09-24 13:07 UTC155
    pub fn with_invite(mut self, invite: impl IntoIterator<Item = OwnedUserId>) -> Self {
31ce2453c82fatagen2026-09-24 13:07 UTC156
        self.invite = invite.into_iter().collect();
31ce2453c82fatagen2026-09-24 13:07 UTC157
        self
31ce2453c82fatagen2026-09-24 13:07 UTC158
    }
31ce2453c82fatagen2026-09-24 13:07 UTC159
31ce2453c82fatagen2026-09-24 13:07 UTC160
    #[must_use]
31ce2453c82fatagen2026-09-24 13:07 UTC161
    pub const fn with_direct(mut self, direct: bool) -> Self {
31ce2453c82fatagen2026-09-24 13:07 UTC162
        self.direct = direct;
31ce2453c82fatagen2026-09-24 13:07 UTC163
        self
31ce2453c82fatagen2026-09-24 13:07 UTC164
    }
31ce2453c82fatagen2026-09-24 13:07 UTC165
31ce2453c82fatagen2026-09-24 13:07 UTC166
    #[must_use]
31ce2453c82fatagen2026-09-24 13:07 UTC167
    pub const fn with_visibility(mut self, visibility: RoomVisibility) -> Self {
31ce2453c82fatagen2026-09-24 13:07 UTC168
        self.visibility = visibility;
31ce2453c82fatagen2026-09-24 13:07 UTC169
        self
31ce2453c82fatagen2026-09-24 13:07 UTC170
    }
31ce2453c82fatagen2026-09-24 13:07 UTC171
31ce2453c82fatagen2026-09-24 13:07 UTC172
    #[must_use]
31ce2453c82fatagen2026-09-24 13:07 UTC173
    pub const fn with_preset(mut self, preset: RoomPreset) -> Self {
31ce2453c82fatagen2026-09-24 13:07 UTC174
        self.preset = Some(preset);
31ce2453c82fatagen2026-09-24 13:07 UTC175
        self
31ce2453c82fatagen2026-09-24 13:07 UTC176
    }
31ce2453c82fatagen2026-09-24 13:07 UTC177
}
31ce2453c82fatagen2026-09-24 13:07 UTC178
96fdf90aacd6atagen2026-09-08 08:24 UTC179
#[derive(Clone, Copy, Debug, Default, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC180
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC181
pub enum RoomVisibility {
96fdf90aacd6atagen2026-09-08 08:24 UTC182
    #[default]
96fdf90aacd6atagen2026-09-08 08:24 UTC183
    Private,
96fdf90aacd6atagen2026-09-08 08:24 UTC184
    Public,
96fdf90aacd6atagen2026-09-08 08:24 UTC185
}
96fdf90aacd6atagen2026-09-08 08:24 UTC186
96fdf90aacd6atagen2026-09-08 08:24 UTC187
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC188
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC189
pub enum RoomPreset {
96fdf90aacd6atagen2026-09-08 08:24 UTC190
    PrivateChat,
96fdf90aacd6atagen2026-09-08 08:24 UTC191
    TrustedPrivateChat,
96fdf90aacd6atagen2026-09-08 08:24 UTC192
    PublicChat,
96fdf90aacd6atagen2026-09-08 08:24 UTC193
}
96fdf90aacd6atagen2026-09-08 08:24 UTC194
96fdf90aacd6atagen2026-09-08 08:24 UTC195
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC196
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC197
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC198
pub enum TimelineCommand {
96fdf90aacd6atagen2026-09-08 08:24 UTC199
    OpenThread {
96fdf90aacd6atagen2026-09-08 08:24 UTC200
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC201
        root_event_id: OwnedEventId,
96fdf90aacd6atagen2026-09-08 08:24 UTC202
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC203
    CloseThread {
96fdf90aacd6atagen2026-09-08 08:24 UTC204
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC205
        root_event_id: OwnedEventId,
96fdf90aacd6atagen2026-09-08 08:24 UTC206
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC207
    /// Re-emit an authoritative reset for an open room or thread without
96fdf90aacd6atagen2026-09-08 08:24 UTC208
    /// closing it. The reset arrives before this command's terminal result.
96fdf90aacd6atagen2026-09-08 08:24 UTC209
    Resync {
96fdf90aacd6atagen2026-09-08 08:24 UTC210
        timeline_id: TimelineId,
96fdf90aacd6atagen2026-09-08 08:24 UTC211
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC212
    Paginate {
96fdf90aacd6atagen2026-09-08 08:24 UTC213
        timeline_id: TimelineId,
96fdf90aacd6atagen2026-09-08 08:24 UTC214
        limit: u16,
96fdf90aacd6atagen2026-09-08 08:24 UTC215
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC216
    Send {
96fdf90aacd6atagen2026-09-08 08:24 UTC217
        timeline_id: TimelineId,
96fdf90aacd6atagen2026-09-08 08:24 UTC218
        content: MessageContent,
96fdf90aacd6atagen2026-09-08 08:24 UTC219
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC220
    Edit {
96fdf90aacd6atagen2026-09-08 08:24 UTC221
        timeline_id: TimelineId,
96fdf90aacd6atagen2026-09-08 08:24 UTC222
        event_id: OwnedEventId,
96fdf90aacd6atagen2026-09-08 08:24 UTC223
        content: MessageEditContent,
96fdf90aacd6atagen2026-09-08 08:24 UTC224
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC225
    Redact {
96fdf90aacd6atagen2026-09-08 08:24 UTC226
        timeline_id: TimelineId,
96fdf90aacd6atagen2026-09-08 08:24 UTC227
        event_id: OwnedEventId,
96fdf90aacd6atagen2026-09-08 08:24 UTC228
        reason: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC229
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC230
    ToggleReaction {
96fdf90aacd6atagen2026-09-08 08:24 UTC231
        timeline_id: TimelineId,
96fdf90aacd6atagen2026-09-08 08:24 UTC232
        event_id: OwnedEventId,
96fdf90aacd6atagen2026-09-08 08:24 UTC233
        key: String,
96fdf90aacd6atagen2026-09-08 08:24 UTC234
    },
fa9114fcf75fatagen2026-09-24 12:51 UTC235
    /// works on a closed room too, it just can't refuse to move the marker backwards
fa9114fcf75fatagen2026-09-24 12:51 UTC236
    MarkRead {
fa9114fcf75fatagen2026-09-24 12:51 UTC237
        timeline_id: TimelineId,
fa9114fcf75fatagen2026-09-24 12:51 UTC238
        event_id: OwnedEventId,
fa9114fcf75fatagen2026-09-24 12:51 UTC239
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC240
}
96fdf90aacd6atagen2026-09-08 08:24 UTC241
96fdf90aacd6atagen2026-09-08 08:24 UTC242
impl TimelineCommand {
96fdf90aacd6atagen2026-09-08 08:24 UTC243
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC244
    pub const fn room_id(&self) -> &OwnedRoomId {
96fdf90aacd6atagen2026-09-08 08:24 UTC245
        match self {
96fdf90aacd6atagen2026-09-08 08:24 UTC246
            Self::OpenThread { room_id, .. } | Self::CloseThread { room_id, .. } => room_id,
96fdf90aacd6atagen2026-09-08 08:24 UTC247
            Self::Resync { timeline_id }
96fdf90aacd6atagen2026-09-08 08:24 UTC248
            | Self::Paginate { timeline_id, .. }
96fdf90aacd6atagen2026-09-08 08:24 UTC249
            | Self::Send { timeline_id, .. }
96fdf90aacd6atagen2026-09-08 08:24 UTC250
            | Self::Edit { timeline_id, .. }
96fdf90aacd6atagen2026-09-08 08:24 UTC251
            | Self::Redact { timeline_id, .. }
fa9114fcf75fatagen2026-09-24 12:51 UTC252
            | Self::ToggleReaction { timeline_id, .. }
fa9114fcf75fatagen2026-09-24 12:51 UTC253
            | Self::MarkRead { timeline_id, .. } => timeline_id.room_id(),
96fdf90aacd6atagen2026-09-08 08:24 UTC254
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC255
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC256
96fdf90aacd6atagen2026-09-08 08:24 UTC257
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC258
    pub const fn timeline_id(&self) -> Option<&TimelineId> {
96fdf90aacd6atagen2026-09-08 08:24 UTC259
        match self {
96fdf90aacd6atagen2026-09-08 08:24 UTC260
            Self::OpenThread { .. } | Self::CloseThread { .. } => None,
96fdf90aacd6atagen2026-09-08 08:24 UTC261
            Self::Resync { timeline_id }
96fdf90aacd6atagen2026-09-08 08:24 UTC262
            | Self::Paginate { timeline_id, .. }
96fdf90aacd6atagen2026-09-08 08:24 UTC263
            | Self::Send { timeline_id, .. }
96fdf90aacd6atagen2026-09-08 08:24 UTC264
            | Self::Edit { timeline_id, .. }
96fdf90aacd6atagen2026-09-08 08:24 UTC265
            | Self::Redact { timeline_id, .. }
fa9114fcf75fatagen2026-09-24 12:51 UTC266
            | Self::ToggleReaction { timeline_id, .. }
fa9114fcf75fatagen2026-09-24 12:51 UTC267
            | Self::MarkRead { timeline_id, .. } => Some(timeline_id),
96fdf90aacd6atagen2026-09-08 08:24 UTC268
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC269
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC270
}
96fdf90aacd6atagen2026-09-08 08:24 UTC271
96fdf90aacd6atagen2026-09-08 08:24 UTC272
#[derive(Clone, Debug, Eq, Hash, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC273
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC274
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC275
pub enum TimelineId {
96fdf90aacd6atagen2026-09-08 08:24 UTC276
    Room(OwnedRoomId),
96fdf90aacd6atagen2026-09-08 08:24 UTC277
    Thread {
96fdf90aacd6atagen2026-09-08 08:24 UTC278
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC279
        root_event_id: OwnedEventId,
96fdf90aacd6atagen2026-09-08 08:24 UTC280
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC281
}
96fdf90aacd6atagen2026-09-08 08:24 UTC282
96fdf90aacd6atagen2026-09-08 08:24 UTC283
impl TimelineId {
96fdf90aacd6atagen2026-09-08 08:24 UTC284
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC285
    pub const fn room_id(&self) -> &OwnedRoomId {
96fdf90aacd6atagen2026-09-08 08:24 UTC286
        match self {
96fdf90aacd6atagen2026-09-08 08:24 UTC287
            Self::Room(room_id) | Self::Thread { room_id, .. } => room_id,
96fdf90aacd6atagen2026-09-08 08:24 UTC288
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC289
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC290
96fdf90aacd6atagen2026-09-08 08:24 UTC291
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC292
    pub fn thread(room_id: OwnedRoomId, root_event_id: OwnedEventId) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC293
        Self::Thread {
96fdf90aacd6atagen2026-09-08 08:24 UTC294
            room_id,
96fdf90aacd6atagen2026-09-08 08:24 UTC295
            root_event_id,
96fdf90aacd6atagen2026-09-08 08:24 UTC296
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC297
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC298
96fdf90aacd6atagen2026-09-08 08:24 UTC299
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC300
    pub fn thread_root(&self) -> Option<&OwnedEventId> {
96fdf90aacd6atagen2026-09-08 08:24 UTC301
        match self {
96fdf90aacd6atagen2026-09-08 08:24 UTC302
            Self::Room(_) => None,
96fdf90aacd6atagen2026-09-08 08:24 UTC303
            Self::Thread { root_event_id, .. } => Some(root_event_id),
96fdf90aacd6atagen2026-09-08 08:24 UTC304
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC305
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC306
}
96fdf90aacd6atagen2026-09-08 08:24 UTC307
96fdf90aacd6atagen2026-09-08 08:24 UTC308
impl From<OwnedRoomId> for TimelineId {
96fdf90aacd6atagen2026-09-08 08:24 UTC309
    fn from(room_id: OwnedRoomId) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC310
        Self::Room(room_id)
96fdf90aacd6atagen2026-09-08 08:24 UTC311
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC312
}
96fdf90aacd6atagen2026-09-08 08:24 UTC313
96fdf90aacd6atagen2026-09-08 08:24 UTC314
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC315
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC316
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC317
pub enum MediaCommand {
31ce2453c82fatagen2026-09-24 13:07 UTC318
    /// succeeds once the send queue has it. progress and failure arrive as events
31ce2453c82fatagen2026-09-24 13:07 UTC319
    Upload(AttachmentUpload),
96fdf90aacd6atagen2026-09-08 08:24 UTC320
}
96fdf90aacd6atagen2026-09-08 08:24 UTC321
96fdf90aacd6atagen2026-09-08 08:24 UTC322
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC323
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC324
pub struct AttachmentUpload {
96fdf90aacd6atagen2026-09-08 08:24 UTC325
    pub timeline_id: TimelineId,
96fdf90aacd6atagen2026-09-08 08:24 UTC326
    pub filename: String,
96fdf90aacd6atagen2026-09-08 08:24 UTC327
    pub mimetype: String,
96fdf90aacd6atagen2026-09-08 08:24 UTC328
    pub bytes: Vec<u8>,
96fdf90aacd6atagen2026-09-08 08:24 UTC329
    pub caption: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC330
    pub details: Option<UploadDetails>,
96fdf90aacd6atagen2026-09-08 08:24 UTC331
    pub thumbnail: Option<UploadThumbnail>,
96fdf90aacd6atagen2026-09-08 08:24 UTC332
}
96fdf90aacd6atagen2026-09-08 08:24 UTC333
96fdf90aacd6atagen2026-09-08 08:24 UTC334
impl AttachmentUpload {
96fdf90aacd6atagen2026-09-08 08:24 UTC335
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC336
    pub fn new(
96fdf90aacd6atagen2026-09-08 08:24 UTC337
        timeline_id: impl Into<TimelineId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC338
        filename: impl Into<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC339
        mimetype: impl Into<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC340
        bytes: Vec<u8>,
96fdf90aacd6atagen2026-09-08 08:24 UTC341
    ) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC342
        Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC343
            timeline_id: timeline_id.into(),
96fdf90aacd6atagen2026-09-08 08:24 UTC344
            filename: filename.into(),
96fdf90aacd6atagen2026-09-08 08:24 UTC345
            mimetype: mimetype.into(),
96fdf90aacd6atagen2026-09-08 08:24 UTC346
            bytes,
96fdf90aacd6atagen2026-09-08 08:24 UTC347
            caption: None,
96fdf90aacd6atagen2026-09-08 08:24 UTC348
            details: None,
96fdf90aacd6atagen2026-09-08 08:24 UTC349
            thumbnail: None,
96fdf90aacd6atagen2026-09-08 08:24 UTC350
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC351
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC352
}
96fdf90aacd6atagen2026-09-08 08:24 UTC353
96fdf90aacd6atagen2026-09-08 08:24 UTC354
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC355
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC356
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC357
pub enum UploadDetails {
96fdf90aacd6atagen2026-09-08 08:24 UTC358
    Image {
96fdf90aacd6atagen2026-09-08 08:24 UTC359
        width: Option<u32>,
96fdf90aacd6atagen2026-09-08 08:24 UTC360
        height: Option<u32>,
96fdf90aacd6atagen2026-09-08 08:24 UTC361
        blurhash: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC362
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC363
    Video {
96fdf90aacd6atagen2026-09-08 08:24 UTC364
        width: Option<u32>,
96fdf90aacd6atagen2026-09-08 08:24 UTC365
        height: Option<u32>,
96fdf90aacd6atagen2026-09-08 08:24 UTC366
        duration_ms: Option<u64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC367
        blurhash: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC368
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC369
    Audio {
96fdf90aacd6atagen2026-09-08 08:24 UTC370
        duration_ms: Option<u64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC371
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC372
    Voice {
96fdf90aacd6atagen2026-09-08 08:24 UTC373
        duration_ms: u64,
96fdf90aacd6atagen2026-09-08 08:24 UTC374
        waveform: Vec<u16>,
96fdf90aacd6atagen2026-09-08 08:24 UTC375
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC376
    File,
96fdf90aacd6atagen2026-09-08 08:24 UTC377
}
96fdf90aacd6atagen2026-09-08 08:24 UTC378
96fdf90aacd6atagen2026-09-08 08:24 UTC379
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC380
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC381
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC382
pub struct UploadThumbnail {
96fdf90aacd6atagen2026-09-08 08:24 UTC383
    pub bytes: Vec<u8>,
96fdf90aacd6atagen2026-09-08 08:24 UTC384
    pub mimetype: String,
96fdf90aacd6atagen2026-09-08 08:24 UTC385
    pub width: u32,
96fdf90aacd6atagen2026-09-08 08:24 UTC386
    pub height: u32,
96fdf90aacd6atagen2026-09-08 08:24 UTC387
}
96fdf90aacd6atagen2026-09-08 08:24 UTC388
31ce2453c82fatagen2026-09-24 13:07 UTC389
impl UploadThumbnail {
31ce2453c82fatagen2026-09-24 13:07 UTC390
    #[must_use]
31ce2453c82fatagen2026-09-24 13:07 UTC391
    pub fn new(bytes: Vec<u8>, mimetype: impl Into<String>, width: u32, height: u32) -> Self {
31ce2453c82fatagen2026-09-24 13:07 UTC392
        Self {
31ce2453c82fatagen2026-09-24 13:07 UTC393
            bytes,
31ce2453c82fatagen2026-09-24 13:07 UTC394
            mimetype: mimetype.into(),
31ce2453c82fatagen2026-09-24 13:07 UTC395
            width,
31ce2453c82fatagen2026-09-24 13:07 UTC396
            height,
31ce2453c82fatagen2026-09-24 13:07 UTC397
        }
31ce2453c82fatagen2026-09-24 13:07 UTC398
    }
31ce2453c82fatagen2026-09-24 13:07 UTC399
}
31ce2453c82fatagen2026-09-24 13:07 UTC400
96fdf90aacd6atagen2026-09-08 08:24 UTC401
#[derive(Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC402
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC403
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC404
pub enum EncryptionCommand {
96fdf90aacd6atagen2026-09-08 08:24 UTC405
    Recover(String),
96fdf90aacd6atagen2026-09-08 08:24 UTC406
    CreateKeyBackup,
96fdf90aacd6atagen2026-09-08 08:24 UTC407
    EnableKeyBackup,
96fdf90aacd6atagen2026-09-08 08:24 UTC408
    DisableKeyBackup { delete_from_server: bool },
96fdf90aacd6atagen2026-09-08 08:24 UTC409
    RecoverKeyBackup(String),
96fdf90aacd6atagen2026-09-08 08:24 UTC410
    StartVerification(VerificationTarget),
96fdf90aacd6atagen2026-09-08 08:24 UTC411
    Verify(VerificationAction),
96fdf90aacd6atagen2026-09-08 08:24 UTC412
}
96fdf90aacd6atagen2026-09-08 08:24 UTC413
96fdf90aacd6atagen2026-09-08 08:24 UTC414
impl fmt::Debug for EncryptionCommand {
96fdf90aacd6atagen2026-09-08 08:24 UTC415
    fn fmt(&self, formatter: &mut fmt::Formatter<'_>) -> fmt::Result {
96fdf90aacd6atagen2026-09-08 08:24 UTC416
        match self {
96fdf90aacd6atagen2026-09-08 08:24 UTC417
            Self::Recover(_) => formatter.debug_tuple("Recover").field(&"...").finish(),
96fdf90aacd6atagen2026-09-08 08:24 UTC418
            Self::CreateKeyBackup => formatter.write_str("CreateKeyBackup"),
96fdf90aacd6atagen2026-09-08 08:24 UTC419
            Self::EnableKeyBackup => formatter.write_str("EnableKeyBackup"),
96fdf90aacd6atagen2026-09-08 08:24 UTC420
            Self::DisableKeyBackup { delete_from_server } => formatter
96fdf90aacd6atagen2026-09-08 08:24 UTC421
                .debug_struct("DisableKeyBackup")
96fdf90aacd6atagen2026-09-08 08:24 UTC422
                .field("delete_from_server", delete_from_server)
96fdf90aacd6atagen2026-09-08 08:24 UTC423
                .finish(),
96fdf90aacd6atagen2026-09-08 08:24 UTC424
            Self::RecoverKeyBackup(_) => formatter
96fdf90aacd6atagen2026-09-08 08:24 UTC425
                .debug_tuple("RecoverKeyBackup")
96fdf90aacd6atagen2026-09-08 08:24 UTC426
                .field(&"...")
96fdf90aacd6atagen2026-09-08 08:24 UTC427
                .finish(),
96fdf90aacd6atagen2026-09-08 08:24 UTC428
            Self::StartVerification(target) => formatter
96fdf90aacd6atagen2026-09-08 08:24 UTC429
                .debug_tuple("StartVerification")
96fdf90aacd6atagen2026-09-08 08:24 UTC430
                .field(target)
96fdf90aacd6atagen2026-09-08 08:24 UTC431
                .finish(),
96fdf90aacd6atagen2026-09-08 08:24 UTC432
            Self::Verify(action) => formatter.debug_tuple("Verify").field(action).finish(),
96fdf90aacd6atagen2026-09-08 08:24 UTC433
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC434
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC435
}
96fdf90aacd6atagen2026-09-08 08:24 UTC436
96fdf90aacd6atagen2026-09-08 08:24 UTC437
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC438
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC439
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC440
pub enum NotificationCommand {
96fdf90aacd6atagen2026-09-08 08:24 UTC441
    SetRoomMode {
96fdf90aacd6atagen2026-09-08 08:24 UTC442
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC443
        mode: RoomNotificationMode,
96fdf90aacd6atagen2026-09-08 08:24 UTC444
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC445
    ResetRoomMode(OwnedRoomId),
96fdf90aacd6atagen2026-09-08 08:24 UTC446
    SetDefaultMode {
96fdf90aacd6atagen2026-09-08 08:24 UTC447
        encrypted: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC448
        one_to_one: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC449
        mode: RoomNotificationMode,
96fdf90aacd6atagen2026-09-08 08:24 UTC450
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC451
    AddKeyword(String),
96fdf90aacd6atagen2026-09-08 08:24 UTC452
    RemoveKeyword(String),
96fdf90aacd6atagen2026-09-08 08:24 UTC453
}
96fdf90aacd6atagen2026-09-08 08:24 UTC454
96fdf90aacd6atagen2026-09-08 08:24 UTC455
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC456
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC457
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC458
pub enum LifecycleCommand {
96fdf90aacd6atagen2026-09-08 08:24 UTC459
    Shutdown,
96fdf90aacd6atagen2026-09-08 08:24 UTC460
}
96fdf90aacd6atagen2026-09-08 08:24 UTC461
31ce2453c82fatagen2026-09-24 13:07 UTC462
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC463
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC464
#[non_exhaustive]
31ce2453c82fatagen2026-09-24 13:07 UTC465
pub enum CommandOutput {
31ce2453c82fatagen2026-09-24 13:07 UTC466
    Done,
31ce2453c82fatagen2026-09-24 13:07 UTC467
    Room(OwnedRoomId),
96fdf90aacd6atagen2026-09-08 08:24 UTC468
}
96fdf90aacd6atagen2026-09-08 08:24 UTC469
96fdf90aacd6atagen2026-09-08 08:24 UTC470
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC471
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC472
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC473
pub enum MessageContent {
96fdf90aacd6atagen2026-09-08 08:24 UTC474
    Text {
96fdf90aacd6atagen2026-09-08 08:24 UTC475
        content: RichText,
96fdf90aacd6atagen2026-09-08 08:24 UTC476
        mentions: MessageMentions,
96fdf90aacd6atagen2026-09-08 08:24 UTC477
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC478
    Emote {
96fdf90aacd6atagen2026-09-08 08:24 UTC479
        content: RichText,
96fdf90aacd6atagen2026-09-08 08:24 UTC480
        mentions: MessageMentions,
96fdf90aacd6atagen2026-09-08 08:24 UTC481
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC482
    Reply {
96fdf90aacd6atagen2026-09-08 08:24 UTC483
        event_id: OwnedEventId,
96fdf90aacd6atagen2026-09-08 08:24 UTC484
        content: RichText,
96fdf90aacd6atagen2026-09-08 08:24 UTC485
        mentions: MessageMentions,
96fdf90aacd6atagen2026-09-08 08:24 UTC486
        notify_replied_to: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC487
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC488
}
96fdf90aacd6atagen2026-09-08 08:24 UTC489
96fdf90aacd6atagen2026-09-08 08:24 UTC490
impl MessageContent {
96fdf90aacd6atagen2026-09-08 08:24 UTC491
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC492
    pub fn text(body: impl Into<String>) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC493
        Self::Text {
96fdf90aacd6atagen2026-09-08 08:24 UTC494
            content: RichText::plain(body),
96fdf90aacd6atagen2026-09-08 08:24 UTC495
            mentions: MessageMentions::default(),
96fdf90aacd6atagen2026-09-08 08:24 UTC496
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC497
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC498
96fdf90aacd6atagen2026-09-08 08:24 UTC499
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC500
    pub fn html(body: impl Into<String>, formatted_body: impl Into<String>) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC501
        Self::Text {
96fdf90aacd6atagen2026-09-08 08:24 UTC502
            content: RichText::html(body, formatted_body),
96fdf90aacd6atagen2026-09-08 08:24 UTC503
            mentions: MessageMentions::default(),
96fdf90aacd6atagen2026-09-08 08:24 UTC504
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC505
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC506
96fdf90aacd6atagen2026-09-08 08:24 UTC507
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC508
    pub fn emote(content: RichText, mentions: MessageMentions) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC509
        Self::Emote { content, mentions }
96fdf90aacd6atagen2026-09-08 08:24 UTC510
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC511
96fdf90aacd6atagen2026-09-08 08:24 UTC512
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC513
    pub fn reply(event_id: OwnedEventId, content: RichText, mentions: MessageMentions) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC514
        Self::Reply {
96fdf90aacd6atagen2026-09-08 08:24 UTC515
            event_id,
96fdf90aacd6atagen2026-09-08 08:24 UTC516
            content,
96fdf90aacd6atagen2026-09-08 08:24 UTC517
            mentions,
96fdf90aacd6atagen2026-09-08 08:24 UTC518
            notify_replied_to: true,
96fdf90aacd6atagen2026-09-08 08:24 UTC519
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC520
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC521
96fdf90aacd6atagen2026-09-08 08:24 UTC522
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC523
    pub fn reply_without_notification(
96fdf90aacd6atagen2026-09-08 08:24 UTC524
        event_id: OwnedEventId,
96fdf90aacd6atagen2026-09-08 08:24 UTC525
        content: RichText,
96fdf90aacd6atagen2026-09-08 08:24 UTC526
        mentions: MessageMentions,
96fdf90aacd6atagen2026-09-08 08:24 UTC527
    ) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC528
        Self::Reply {
96fdf90aacd6atagen2026-09-08 08:24 UTC529
            event_id,
96fdf90aacd6atagen2026-09-08 08:24 UTC530
            content,
96fdf90aacd6atagen2026-09-08 08:24 UTC531
            mentions,
96fdf90aacd6atagen2026-09-08 08:24 UTC532
            notify_replied_to: false,
96fdf90aacd6atagen2026-09-08 08:24 UTC533
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC534
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC535
}
96fdf90aacd6atagen2026-09-08 08:24 UTC536
96fdf90aacd6atagen2026-09-08 08:24 UTC537
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC538
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC539
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC540
pub enum MessageEditContent {
96fdf90aacd6atagen2026-09-08 08:24 UTC541
    Text {
96fdf90aacd6atagen2026-09-08 08:24 UTC542
        content: RichText,
96fdf90aacd6atagen2026-09-08 08:24 UTC543
        mentions: MessageMentions,
96fdf90aacd6atagen2026-09-08 08:24 UTC544
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC545
    Emote {
96fdf90aacd6atagen2026-09-08 08:24 UTC546
        content: RichText,
96fdf90aacd6atagen2026-09-08 08:24 UTC547
        mentions: MessageMentions,
96fdf90aacd6atagen2026-09-08 08:24 UTC548
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC549
}
96fdf90aacd6atagen2026-09-08 08:24 UTC550
96fdf90aacd6atagen2026-09-08 08:24 UTC551
impl MessageEditContent {
96fdf90aacd6atagen2026-09-08 08:24 UTC552
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC553
    pub fn text(body: impl Into<String>) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC554
        Self::Text {
96fdf90aacd6atagen2026-09-08 08:24 UTC555
            content: RichText::plain(body),
96fdf90aacd6atagen2026-09-08 08:24 UTC556
            mentions: MessageMentions::default(),
96fdf90aacd6atagen2026-09-08 08:24 UTC557
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC558
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC559
96fdf90aacd6atagen2026-09-08 08:24 UTC560
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC561
    pub fn html(body: impl Into<String>, formatted_body: impl Into<String>) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC562
        Self::Text {
96fdf90aacd6atagen2026-09-08 08:24 UTC563
            content: RichText::html(body, formatted_body),
96fdf90aacd6atagen2026-09-08 08:24 UTC564
            mentions: MessageMentions::default(),
96fdf90aacd6atagen2026-09-08 08:24 UTC565
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC566
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC567
96fdf90aacd6atagen2026-09-08 08:24 UTC568
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC569
    pub fn emote(content: RichText, mentions: MessageMentions) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC570
        Self::Emote { content, mentions }
96fdf90aacd6atagen2026-09-08 08:24 UTC571
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC572
}
96fdf90aacd6atagen2026-09-08 08:24 UTC573
96fdf90aacd6atagen2026-09-08 08:24 UTC574
#[derive(Clone, Debug, Default, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC575
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC576
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC577
pub struct RichText {
96fdf90aacd6atagen2026-09-08 08:24 UTC578
    pub body: String,
96fdf90aacd6atagen2026-09-08 08:24 UTC579
    pub formatted_body: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC580
}
96fdf90aacd6atagen2026-09-08 08:24 UTC581
96fdf90aacd6atagen2026-09-08 08:24 UTC582
impl RichText {
96fdf90aacd6atagen2026-09-08 08:24 UTC583
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC584
    pub fn plain(body: impl Into<String>) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC585
        Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC586
            body: body.into(),
96fdf90aacd6atagen2026-09-08 08:24 UTC587
            formatted_body: None,
96fdf90aacd6atagen2026-09-08 08:24 UTC588
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC589
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC590
96fdf90aacd6atagen2026-09-08 08:24 UTC591
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC592
    pub fn html(body: impl Into<String>, formatted_body: impl Into<String>) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC593
        Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC594
            body: body.into(),
96fdf90aacd6atagen2026-09-08 08:24 UTC595
            formatted_body: Some(formatted_body.into()),
96fdf90aacd6atagen2026-09-08 08:24 UTC596
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC597
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC598
}
96fdf90aacd6atagen2026-09-08 08:24 UTC599
96fdf90aacd6atagen2026-09-08 08:24 UTC600
#[derive(Clone, Debug, Default, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC601
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC602
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC603
pub struct MessageMentions {
96fdf90aacd6atagen2026-09-08 08:24 UTC604
    pub user_ids: Vec<OwnedUserId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC605
    pub room: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC606
}
96fdf90aacd6atagen2026-09-08 08:24 UTC607
96fdf90aacd6atagen2026-09-08 08:24 UTC608
impl MessageMentions {
96fdf90aacd6atagen2026-09-08 08:24 UTC609
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC610
    pub fn with_user_ids(user_ids: impl IntoIterator<Item = OwnedUserId>) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC611
        Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC612
            user_ids: user_ids.into_iter().collect(),
96fdf90aacd6atagen2026-09-08 08:24 UTC613
            room: false,
96fdf90aacd6atagen2026-09-08 08:24 UTC614
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC615
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC616
96fdf90aacd6atagen2026-09-08 08:24 UTC617
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC618
    pub fn room() -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC619
        Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC620
            user_ids: Vec::new(),
96fdf90aacd6atagen2026-09-08 08:24 UTC621
            room: true,
96fdf90aacd6atagen2026-09-08 08:24 UTC622
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC623
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC624
}
96fdf90aacd6atagen2026-09-08 08:24 UTC625
96fdf90aacd6atagen2026-09-08 08:24 UTC626
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC627
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC628
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC629
pub enum Event {
96fdf90aacd6atagen2026-09-08 08:24 UTC630
    ConnectionChanged(ConnectionState),
96fdf90aacd6atagen2026-09-08 08:24 UTC631
    Authenticated {
96fdf90aacd6atagen2026-09-08 08:24 UTC632
        user_id: OwnedUserId,
96fdf90aacd6atagen2026-09-08 08:24 UTC633
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC634
    /// Refresh tokens changed. Persist a fresh `ClientHandle::session_record()`
96fdf90aacd6atagen2026-09-08 08:24 UTC635
    /// atomically; a record captured before this event may no longer restore.
96fdf90aacd6atagen2026-09-08 08:24 UTC636
    SessionTokensChanged,
fa9114fcf75fatagen2026-09-24 12:51 UTC637
    /// the server stopped honouring our token and the engine stops. on a soft
fa9114fcf75fatagen2026-09-24 12:51 UTC638
    /// logout keep the store and log in again with the same device, otherwise
fa9114fcf75fatagen2026-09-24 12:51 UTC639
    /// the record and the store are both dead
fa9114fcf75fatagen2026-09-24 12:51 UTC640
    SessionAccessRejected {
fa9114fcf75fatagen2026-09-24 12:51 UTC641
        soft_logout: bool,
fa9114fcf75fatagen2026-09-24 12:51 UTC642
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC643
    NotificationSettingsChanged,
96fdf90aacd6atagen2026-09-08 08:24 UTC644
    VerificationTargetChanged(VerificationTarget),
96fdf90aacd6atagen2026-09-08 08:24 UTC645
    RoomsChanged,
31ce2453c82fatagen2026-09-24 13:07 UTC646
    /// replaces whatever you had for this timeline. every diff after it applies to it
96fdf90aacd6atagen2026-09-08 08:24 UTC647
    TimelineReset {
96fdf90aacd6atagen2026-09-08 08:24 UTC648
        timeline_id: TimelineId,
96fdf90aacd6atagen2026-09-08 08:24 UTC649
        items: Vec<TimelineItem>,
96fdf90aacd6atagen2026-09-08 08:24 UTC650
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC651
    TimelineChanged {
96fdf90aacd6atagen2026-09-08 08:24 UTC652
        timeline_id: TimelineId,
96fdf90aacd6atagen2026-09-08 08:24 UTC653
        diffs: Vec<TimelineDiff>,
96fdf90aacd6atagen2026-09-08 08:24 UTC654
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC655
    HistoryChanged {
96fdf90aacd6atagen2026-09-08 08:24 UTC656
        timeline_id: TimelineId,
96fdf90aacd6atagen2026-09-08 08:24 UTC657
        state: HistoryState,
96fdf90aacd6atagen2026-09-08 08:24 UTC658
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC659
    TypingChanged(TypingState),
96fdf90aacd6atagen2026-09-08 08:24 UTC660
    MediaUploadProgress {
96fdf90aacd6atagen2026-09-08 08:24 UTC661
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC662
        transaction_id: OwnedTransactionId,
96fdf90aacd6atagen2026-09-08 08:24 UTC663
        uploaded_bytes: u64,
96fdf90aacd6atagen2026-09-08 08:24 UTC664
        total_bytes: u64,
96fdf90aacd6atagen2026-09-08 08:24 UTC665
        complete: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC666
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC667
    MediaUploadFailed {
96fdf90aacd6atagen2026-09-08 08:24 UTC668
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC669
        transaction_id: OwnedTransactionId,
31ce2453c82fatagen2026-09-24 13:07 UTC670
        kind: crate::ErrorKind,
96fdf90aacd6atagen2026-09-08 08:24 UTC671
        recoverable: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC672
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC673
    EncryptionChanged(EncryptionState),
96fdf90aacd6atagen2026-09-08 08:24 UTC674
    VerificationChanged(VerificationState),
fa9114fcf75fatagen2026-09-24 12:51 UTC675
    /// logout went through and the engine stops. delete the record and the store
96fdf90aacd6atagen2026-09-08 08:24 UTC676
    LoggedOut,
96fdf90aacd6atagen2026-09-08 08:24 UTC677
    Failed(EngineFailure),
fa9114fcf75fatagen2026-09-24 12:51 UTC678
    /// always the last event. keep the saved record unless `LoggedOut` or a
fa9114fcf75fatagen2026-09-24 12:51 UTC679
    /// hard `SessionAccessRejected` came first. commands still in flight get no result
96fdf90aacd6atagen2026-09-08 08:24 UTC680
    Stopped,
96fdf90aacd6atagen2026-09-08 08:24 UTC681
}
96fdf90aacd6atagen2026-09-08 08:24 UTC682
96fdf90aacd6atagen2026-09-08 08:24 UTC683
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC684
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC685
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC686
pub enum ConnectionState {
96fdf90aacd6atagen2026-09-08 08:24 UTC687
    Idle,
96fdf90aacd6atagen2026-09-08 08:24 UTC688
    Connecting,
96fdf90aacd6atagen2026-09-08 08:24 UTC689
    Online,
96fdf90aacd6atagen2026-09-08 08:24 UTC690
    Offline,
96fdf90aacd6atagen2026-09-08 08:24 UTC691
    Stopped,
96fdf90aacd6atagen2026-09-08 08:24 UTC692
}
96fdf90aacd6atagen2026-09-08 08:24 UTC693
96fdf90aacd6atagen2026-09-08 08:24 UTC694
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC695
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC696
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC697
pub struct RoomSummary {
96fdf90aacd6atagen2026-09-08 08:24 UTC698
    pub room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC699
    pub name: String,
96fdf90aacd6atagen2026-09-08 08:24 UTC700
    pub membership: RoomMembership,
96fdf90aacd6atagen2026-09-08 08:24 UTC701
    pub unread_messages: u64,
96fdf90aacd6atagen2026-09-08 08:24 UTC702
    pub unread_mentions: u64,
96fdf90aacd6atagen2026-09-08 08:24 UTC703
    pub encrypted: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC704
    pub space: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC705
    pub direct: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC706
    pub favourite: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC707
    pub low_priority: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC708
    pub avatar: Option<OwnedMxcUri>,
96fdf90aacd6atagen2026-09-08 08:24 UTC709
    pub latest_event_timestamp_ms: Option<u64>,
31ce2453c82fatagen2026-09-24 13:07 UTC710
    pub latest_event: Option<LatestEvent>,
96fdf90aacd6atagen2026-09-08 08:24 UTC711
    pub notification_mode: Option<RoomNotificationMode>,
96fdf90aacd6atagen2026-09-08 08:24 UTC712
    pub notification_mode_custom: bool,
31ce2453c82fatagen2026-09-24 13:07 UTC713
    pub topic: Option<String>,
31ce2453c82fatagen2026-09-24 13:07 UTC714
    pub canonical_alias: Option<OwnedRoomAliasId>,
31ce2453c82fatagen2026-09-24 13:07 UTC715
    pub joined_members: u64,
31ce2453c82fatagen2026-09-24 13:07 UTC716
    pub invited_members: u64,
31ce2453c82fatagen2026-09-24 13:07 UTC717
    /// who a nameless room gets named after
31ce2453c82fatagen2026-09-24 13:07 UTC718
    pub heroes: Vec<RoomHero>,
31ce2453c82fatagen2026-09-24 13:07 UTC719
    /// set once the room has been upgraded, this is where everyone went
31ce2453c82fatagen2026-09-24 13:07 UTC720
    pub successor: Option<OwnedRoomId>,
31ce2453c82fatagen2026-09-24 13:07 UTC721
    pub inviter: Option<OwnedUserId>,
31ce2453c82fatagen2026-09-24 13:07 UTC722
    /// joined spaces that list this room as a child
31ce2453c82fatagen2026-09-24 13:07 UTC723
    pub parent_spaces: Vec<OwnedRoomId>,
31ce2453c82fatagen2026-09-24 13:07 UTC724
    /// for a space, the children it lists, joined or not
31ce2453c82fatagen2026-09-24 13:07 UTC725
    pub children: Vec<OwnedRoomId>,
31ce2453c82fatagen2026-09-24 13:07 UTC726
}
31ce2453c82fatagen2026-09-24 13:07 UTC727
31ce2453c82fatagen2026-09-24 13:07 UTC728
#[derive(Clone, Debug, Eq, PartialEq)]
31ce2453c82fatagen2026-09-24 13:07 UTC729
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC730
#[non_exhaustive]
31ce2453c82fatagen2026-09-24 13:07 UTC731
pub struct RoomHero {
31ce2453c82fatagen2026-09-24 13:07 UTC732
    pub user_id: OwnedUserId,
31ce2453c82fatagen2026-09-24 13:07 UTC733
    pub display_name: Option<String>,
31ce2453c82fatagen2026-09-24 13:07 UTC734
    pub avatar: Option<OwnedMxcUri>,
31ce2453c82fatagen2026-09-24 13:07 UTC735
}
31ce2453c82fatagen2026-09-24 13:07 UTC736
31ce2453c82fatagen2026-09-24 13:07 UTC737
/// enough for a room list preview line. `body` is empty for anything that isn't a plain message
31ce2453c82fatagen2026-09-24 13:07 UTC738
#[derive(Clone, Debug, Eq, PartialEq)]
31ce2453c82fatagen2026-09-24 13:07 UTC739
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC740
#[non_exhaustive]
31ce2453c82fatagen2026-09-24 13:07 UTC741
pub struct LatestEvent {
31ce2453c82fatagen2026-09-24 13:07 UTC742
    pub sender: Option<OwnedUserId>,
31ce2453c82fatagen2026-09-24 13:07 UTC743
    pub body: Option<String>,
31ce2453c82fatagen2026-09-24 13:07 UTC744
    pub timestamp_ms: Option<u64>,
31ce2453c82fatagen2026-09-24 13:07 UTC745
    pub send_state: SendState,
31ce2453c82fatagen2026-09-24 13:07 UTC746
}
31ce2453c82fatagen2026-09-24 13:07 UTC747
31ce2453c82fatagen2026-09-24 13:07 UTC748
#[derive(Clone, Debug, Eq, PartialEq)]
31ce2453c82fatagen2026-09-24 13:07 UTC749
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC750
#[non_exhaustive]
31ce2453c82fatagen2026-09-24 13:07 UTC751
pub struct Profile {
31ce2453c82fatagen2026-09-24 13:07 UTC752
    pub user_id: OwnedUserId,
31ce2453c82fatagen2026-09-24 13:07 UTC753
    pub display_name: Option<String>,
31ce2453c82fatagen2026-09-24 13:07 UTC754
    pub avatar: Option<OwnedMxcUri>,
31ce2453c82fatagen2026-09-24 13:07 UTC755
}
31ce2453c82fatagen2026-09-24 13:07 UTC756
31ce2453c82fatagen2026-09-24 13:07 UTC757
/// one room in a space's hierarchy, as the server describes it, which may be a room you're not in
31ce2453c82fatagen2026-09-24 13:07 UTC758
#[derive(Clone, Debug, Eq, PartialEq)]
31ce2453c82fatagen2026-09-24 13:07 UTC759
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC760
#[non_exhaustive]
31ce2453c82fatagen2026-09-24 13:07 UTC761
pub struct SpaceChild {
31ce2453c82fatagen2026-09-24 13:07 UTC762
    pub room_id: OwnedRoomId,
31ce2453c82fatagen2026-09-24 13:07 UTC763
    pub name: String,
31ce2453c82fatagen2026-09-24 13:07 UTC764
    pub topic: Option<String>,
31ce2453c82fatagen2026-09-24 13:07 UTC765
    pub avatar: Option<OwnedMxcUri>,
31ce2453c82fatagen2026-09-24 13:07 UTC766
    pub canonical_alias: Option<OwnedRoomAliasId>,
31ce2453c82fatagen2026-09-24 13:07 UTC767
    pub joined_members: u64,
31ce2453c82fatagen2026-09-24 13:07 UTC768
    pub space: bool,
31ce2453c82fatagen2026-09-24 13:07 UTC769
    pub children_count: u64,
31ce2453c82fatagen2026-09-24 13:07 UTC770
    pub membership: Option<RoomMembership>,
31ce2453c82fatagen2026-09-24 13:07 UTC771
    pub via: Vec<OwnedServerName>,
31ce2453c82fatagen2026-09-24 13:07 UTC772
    pub suggested: bool,
31ce2453c82fatagen2026-09-24 13:07 UTC773
    pub world_readable: Option<bool>,
31ce2453c82fatagen2026-09-24 13:07 UTC774
    pub guest_can_join: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC775
}
96fdf90aacd6atagen2026-09-08 08:24 UTC776
96fdf90aacd6atagen2026-09-08 08:24 UTC777
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC778
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC779
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC780
pub enum RoomNotificationMode {
96fdf90aacd6atagen2026-09-08 08:24 UTC781
    AllMessages,
96fdf90aacd6atagen2026-09-08 08:24 UTC782
    MentionsAndKeywordsOnly,
96fdf90aacd6atagen2026-09-08 08:24 UTC783
    Mute,
96fdf90aacd6atagen2026-09-08 08:24 UTC784
}
96fdf90aacd6atagen2026-09-08 08:24 UTC785
96fdf90aacd6atagen2026-09-08 08:24 UTC786
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC787
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC788
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC789
pub struct RoomNotificationSettings {
96fdf90aacd6atagen2026-09-08 08:24 UTC790
    pub mode: RoomNotificationMode,
96fdf90aacd6atagen2026-09-08 08:24 UTC791
    pub custom: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC792
}
96fdf90aacd6atagen2026-09-08 08:24 UTC793
96fdf90aacd6atagen2026-09-08 08:24 UTC794
#[derive(Clone, Debug)]
96fdf90aacd6atagen2026-09-08 08:24 UTC795
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC796
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC797
pub enum PushNotificationStatus {
96fdf90aacd6atagen2026-09-08 08:24 UTC798
    Event(Box<PushNotification>),
96fdf90aacd6atagen2026-09-08 08:24 UTC799
    NotFound,
96fdf90aacd6atagen2026-09-08 08:24 UTC800
    FilteredOut,
96fdf90aacd6atagen2026-09-08 08:24 UTC801
    Redacted,
96fdf90aacd6atagen2026-09-08 08:24 UTC802
}
96fdf90aacd6atagen2026-09-08 08:24 UTC803
96fdf90aacd6atagen2026-09-08 08:24 UTC804
#[derive(Clone, Debug)]
96fdf90aacd6atagen2026-09-08 08:24 UTC805
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC806
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC807
pub struct PushNotification {
96fdf90aacd6atagen2026-09-08 08:24 UTC808
    pub event_id: OwnedEventId,
96fdf90aacd6atagen2026-09-08 08:24 UTC809
    pub event: PushNotificationEvent,
96fdf90aacd6atagen2026-09-08 08:24 UTC810
    pub sender: PushNotificationSender,
96fdf90aacd6atagen2026-09-08 08:24 UTC811
    pub room: PushNotificationRoom,
96fdf90aacd6atagen2026-09-08 08:24 UTC812
    pub noisy: Option<bool>,
96fdf90aacd6atagen2026-09-08 08:24 UTC813
    pub has_mention: Option<bool>,
96fdf90aacd6atagen2026-09-08 08:24 UTC814
    pub thread_id: Option<OwnedEventId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC815
}
96fdf90aacd6atagen2026-09-08 08:24 UTC816
96fdf90aacd6atagen2026-09-08 08:24 UTC817
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC818
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC819
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC820
pub struct PushNotificationSender {
96fdf90aacd6atagen2026-09-08 08:24 UTC821
    pub user_id: OwnedUserId,
96fdf90aacd6atagen2026-09-08 08:24 UTC822
    pub display_name: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC823
    pub avatar_url: Option<OwnedMxcUri>,
96fdf90aacd6atagen2026-09-08 08:24 UTC824
    pub name_ambiguous: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC825
}
96fdf90aacd6atagen2026-09-08 08:24 UTC826
96fdf90aacd6atagen2026-09-08 08:24 UTC827
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC828
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC829
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC830
pub struct PushNotificationRoom {
96fdf90aacd6atagen2026-09-08 08:24 UTC831
    pub room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC832
    pub name: String,
96fdf90aacd6atagen2026-09-08 08:24 UTC833
    pub avatar_url: Option<OwnedMxcUri>,
96fdf90aacd6atagen2026-09-08 08:24 UTC834
    pub canonical_alias: Option<OwnedRoomAliasId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC835
    pub topic: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC836
    pub encrypted: Option<bool>,
96fdf90aacd6atagen2026-09-08 08:24 UTC837
    pub direct: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC838
    pub joined_members_count: u64,
96fdf90aacd6atagen2026-09-08 08:24 UTC839
    pub service_members: Vec<OwnedUserId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC840
    pub active_service_members_count: u64,
96fdf90aacd6atagen2026-09-08 08:24 UTC841
    pub space: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC842
}
96fdf90aacd6atagen2026-09-08 08:24 UTC843
96fdf90aacd6atagen2026-09-08 08:24 UTC844
#[derive(Clone, Debug)]
96fdf90aacd6atagen2026-09-08 08:24 UTC845
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC846
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC847
pub enum PushNotificationEvent {
96fdf90aacd6atagen2026-09-08 08:24 UTC848
    Timeline(Raw<AnySyncTimelineEvent>),
96fdf90aacd6atagen2026-09-08 08:24 UTC849
    Invite(Raw<StrippedRoomMemberEvent>),
96fdf90aacd6atagen2026-09-08 08:24 UTC850
}
96fdf90aacd6atagen2026-09-08 08:24 UTC851
96fdf90aacd6atagen2026-09-08 08:24 UTC852
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC853
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC854
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC855
pub struct RoomPowerLevels {
96fdf90aacd6atagen2026-09-08 08:24 UTC856
    pub ban: i64,
96fdf90aacd6atagen2026-09-08 08:24 UTC857
    pub invite: i64,
96fdf90aacd6atagen2026-09-08 08:24 UTC858
    pub kick: i64,
96fdf90aacd6atagen2026-09-08 08:24 UTC859
    pub redact: i64,
96fdf90aacd6atagen2026-09-08 08:24 UTC860
    pub events_default: i64,
96fdf90aacd6atagen2026-09-08 08:24 UTC861
    pub state_default: i64,
96fdf90aacd6atagen2026-09-08 08:24 UTC862
    pub users_default: i64,
96fdf90aacd6atagen2026-09-08 08:24 UTC863
    pub room_notification: i64,
96fdf90aacd6atagen2026-09-08 08:24 UTC864
    pub users: Vec<(OwnedUserId, i64)>,
96fdf90aacd6atagen2026-09-08 08:24 UTC865
    pub events: Vec<(String, i64)>,
96fdf90aacd6atagen2026-09-08 08:24 UTC866
}
96fdf90aacd6atagen2026-09-08 08:24 UTC867
96fdf90aacd6atagen2026-09-08 08:24 UTC868
#[derive(Clone, Debug, Default, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC869
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC870
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC871
pub struct PowerLevelChanges {
96fdf90aacd6atagen2026-09-08 08:24 UTC872
    pub ban: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC873
    pub invite: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC874
    pub kick: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC875
    pub redact: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC876
    pub events_default: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC877
    pub state_default: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC878
    pub users_default: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC879
    pub room_notification: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC880
    pub room_name: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC881
    pub room_avatar: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC882
    pub room_topic: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC883
    pub space_child: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC884
    pub beacon: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC885
    pub beacon_info: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC886
}
96fdf90aacd6atagen2026-09-08 08:24 UTC887
96fdf90aacd6atagen2026-09-08 08:24 UTC888
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC889
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC890
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC891
pub enum RoomMembership {
96fdf90aacd6atagen2026-09-08 08:24 UTC892
    Joined,
96fdf90aacd6atagen2026-09-08 08:24 UTC893
    Invited,
96fdf90aacd6atagen2026-09-08 08:24 UTC894
    Left,
96fdf90aacd6atagen2026-09-08 08:24 UTC895
    Knocked,
96fdf90aacd6atagen2026-09-08 08:24 UTC896
    Banned,
96fdf90aacd6atagen2026-09-08 08:24 UTC897
}
96fdf90aacd6atagen2026-09-08 08:24 UTC898
96fdf90aacd6atagen2026-09-08 08:24 UTC899
#[derive(Clone, Debug, Default, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC900
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC901
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC902
pub struct RoomListFilter {
96fdf90aacd6atagen2026-09-08 08:24 UTC903
    pub membership: Option<RoomMembership>,
96fdf90aacd6atagen2026-09-08 08:24 UTC904
    pub category: Option<RoomCategory>,
96fdf90aacd6atagen2026-09-08 08:24 UTC905
    pub favourite: Option<bool>,
96fdf90aacd6atagen2026-09-08 08:24 UTC906
    pub unread_only: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC907
    pub search: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC908
}
96fdf90aacd6atagen2026-09-08 08:24 UTC909
96fdf90aacd6atagen2026-09-08 08:24 UTC910
impl RoomListFilter {
96fdf90aacd6atagen2026-09-08 08:24 UTC911
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC912
    pub fn with_membership(mut self, membership: RoomMembership) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC913
        self.membership = Some(membership);
96fdf90aacd6atagen2026-09-08 08:24 UTC914
        self
96fdf90aacd6atagen2026-09-08 08:24 UTC915
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC916
96fdf90aacd6atagen2026-09-08 08:24 UTC917
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC918
    pub fn with_category(mut self, category: RoomCategory) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC919
        self.category = Some(category);
96fdf90aacd6atagen2026-09-08 08:24 UTC920
        self
96fdf90aacd6atagen2026-09-08 08:24 UTC921
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC922
96fdf90aacd6atagen2026-09-08 08:24 UTC923
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC924
    pub fn with_favourite(mut self, favourite: bool) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC925
        self.favourite = Some(favourite);
96fdf90aacd6atagen2026-09-08 08:24 UTC926
        self
96fdf90aacd6atagen2026-09-08 08:24 UTC927
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC928
96fdf90aacd6atagen2026-09-08 08:24 UTC929
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC930
    pub const fn with_unread_only(mut self, unread_only: bool) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC931
        self.unread_only = unread_only;
96fdf90aacd6atagen2026-09-08 08:24 UTC932
        self
96fdf90aacd6atagen2026-09-08 08:24 UTC933
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC934
96fdf90aacd6atagen2026-09-08 08:24 UTC935
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC936
    pub fn with_search(mut self, search: impl Into<String>) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC937
        self.search = Some(search.into());
96fdf90aacd6atagen2026-09-08 08:24 UTC938
        self
96fdf90aacd6atagen2026-09-08 08:24 UTC939
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC940
96fdf90aacd6atagen2026-09-08 08:24 UTC941
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC942
    pub fn matches(&self, room: &RoomSummary) -> bool {
31ce2453c82fatagen2026-09-24 13:07 UTC943
        self.matcher().matches(room)
31ce2453c82fatagen2026-09-24 13:07 UTC944
    }
31ce2453c82fatagen2026-09-24 13:07 UTC945
31ce2453c82fatagen2026-09-24 13:07 UTC946
    /// lowercases the search once, for filtering a whole list
31ce2453c82fatagen2026-09-24 13:07 UTC947
    #[must_use]
31ce2453c82fatagen2026-09-24 13:07 UTC948
    pub fn matcher(&self) -> RoomMatcher<'_> {
31ce2453c82fatagen2026-09-24 13:07 UTC949
        RoomMatcher {
31ce2453c82fatagen2026-09-24 13:07 UTC950
            filter: self,
31ce2453c82fatagen2026-09-24 13:07 UTC951
            search: self.search.as_deref().map(str::to_lowercase),
31ce2453c82fatagen2026-09-24 13:07 UTC952
        }
31ce2453c82fatagen2026-09-24 13:07 UTC953
    }
31ce2453c82fatagen2026-09-24 13:07 UTC954
}
31ce2453c82fatagen2026-09-24 13:07 UTC955
31ce2453c82fatagen2026-09-24 13:07 UTC956
#[derive(Debug)]
31ce2453c82fatagen2026-09-24 13:07 UTC957
pub struct RoomMatcher<'a> {
31ce2453c82fatagen2026-09-24 13:07 UTC958
    filter: &'a RoomListFilter,
31ce2453c82fatagen2026-09-24 13:07 UTC959
    search: Option<String>,
31ce2453c82fatagen2026-09-24 13:07 UTC960
}
31ce2453c82fatagen2026-09-24 13:07 UTC961
31ce2453c82fatagen2026-09-24 13:07 UTC962
impl RoomMatcher<'_> {
31ce2453c82fatagen2026-09-24 13:07 UTC963
    #[must_use]
31ce2453c82fatagen2026-09-24 13:07 UTC964
    pub fn matches(&self, room: &RoomSummary) -> bool {
31ce2453c82fatagen2026-09-24 13:07 UTC965
        let filter = self.filter;
31ce2453c82fatagen2026-09-24 13:07 UTC966
        filter
31ce2453c82fatagen2026-09-24 13:07 UTC967
            .membership
96fdf90aacd6atagen2026-09-08 08:24 UTC968
            .is_none_or(|membership| room.membership == membership)
31ce2453c82fatagen2026-09-24 13:07 UTC969
            && filter.category.is_none_or(|category| match category {
96fdf90aacd6atagen2026-09-08 08:24 UTC970
                RoomCategory::People => room.direct && !room.space,
96fdf90aacd6atagen2026-09-08 08:24 UTC971
                RoomCategory::Rooms => !room.direct && !room.space,
96fdf90aacd6atagen2026-09-08 08:24 UTC972
                RoomCategory::Spaces => room.space,
96fdf90aacd6atagen2026-09-08 08:24 UTC973
            })
31ce2453c82fatagen2026-09-24 13:07 UTC974
            && filter
96fdf90aacd6atagen2026-09-08 08:24 UTC975
                .favourite
96fdf90aacd6atagen2026-09-08 08:24 UTC976
                .is_none_or(|favourite| room.favourite == favourite)
31ce2453c82fatagen2026-09-24 13:07 UTC977
            && (!filter.unread_only || room.unread_messages > 0 || room.unread_mentions > 0)
96fdf90aacd6atagen2026-09-08 08:24 UTC978
            && self.search.as_ref().is_none_or(|search| {
31ce2453c82fatagen2026-09-24 13:07 UTC979
                room.name.to_lowercase().contains(search)
31ce2453c82fatagen2026-09-24 13:07 UTC980
                    || room.room_id.as_str().to_lowercase().contains(search)
96fdf90aacd6atagen2026-09-08 08:24 UTC981
            })
96fdf90aacd6atagen2026-09-08 08:24 UTC982
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC983
}
96fdf90aacd6atagen2026-09-08 08:24 UTC984
96fdf90aacd6atagen2026-09-08 08:24 UTC985
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC986
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC987
pub enum RoomCategory {
96fdf90aacd6atagen2026-09-08 08:24 UTC988
    People,
96fdf90aacd6atagen2026-09-08 08:24 UTC989
    Rooms,
96fdf90aacd6atagen2026-09-08 08:24 UTC990
    Spaces,
96fdf90aacd6atagen2026-09-08 08:24 UTC991
}
96fdf90aacd6atagen2026-09-08 08:24 UTC992
96fdf90aacd6atagen2026-09-08 08:24 UTC993
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC994
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC995
pub enum MemberFilter {
96fdf90aacd6atagen2026-09-08 08:24 UTC996
    Active,
96fdf90aacd6atagen2026-09-08 08:24 UTC997
    Joined,
96fdf90aacd6atagen2026-09-08 08:24 UTC998
    Invited,
96fdf90aacd6atagen2026-09-08 08:24 UTC999
    All,
96fdf90aacd6atagen2026-09-08 08:24 UTC1000
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1001
96fdf90aacd6atagen2026-09-08 08:24 UTC1002
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1003
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1004
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1005
pub enum MemberMembership {
96fdf90aacd6atagen2026-09-08 08:24 UTC1006
    Joined,
96fdf90aacd6atagen2026-09-08 08:24 UTC1007
    Invited,
96fdf90aacd6atagen2026-09-08 08:24 UTC1008
    Left,
96fdf90aacd6atagen2026-09-08 08:24 UTC1009
    Knocked,
96fdf90aacd6atagen2026-09-08 08:24 UTC1010
    Banned,
96fdf90aacd6atagen2026-09-08 08:24 UTC1011
    Custom(String),
96fdf90aacd6atagen2026-09-08 08:24 UTC1012
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1013
96fdf90aacd6atagen2026-09-08 08:24 UTC1014
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1015
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1016
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1017
pub struct MemberSummary {
96fdf90aacd6atagen2026-09-08 08:24 UTC1018
    pub user_id: OwnedUserId,
96fdf90aacd6atagen2026-09-08 08:24 UTC1019
    pub name: String,
96fdf90aacd6atagen2026-09-08 08:24 UTC1020
    pub display_name: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1021
    pub avatar: Option<OwnedMxcUri>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1022
    pub membership: MemberMembership,
96fdf90aacd6atagen2026-09-08 08:24 UTC1023
    pub own: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC1024
    pub name_ambiguous: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC1025
    pub ignored: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC1026
    pub service: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC1027
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1028
96fdf90aacd6atagen2026-09-08 08:24 UTC1029
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1030
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1031
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1032
pub struct OwnDevice {
96fdf90aacd6atagen2026-09-08 08:24 UTC1033
    pub device_id: OwnedDeviceId,
96fdf90aacd6atagen2026-09-08 08:24 UTC1034
    pub display_name: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1035
    pub last_seen_ip: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1036
    pub last_seen_timestamp_ms: Option<u64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1037
    pub current: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC1038
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1039
96fdf90aacd6atagen2026-09-08 08:24 UTC1040
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1041
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC1042
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1043
pub enum TimelineItem {
96fdf90aacd6atagen2026-09-08 08:24 UTC1044
    Message(Box<TimelineMessage>),
96fdf90aacd6atagen2026-09-08 08:24 UTC1045
    DayDivider { timestamp_ms: u64 },
96fdf90aacd6atagen2026-09-08 08:24 UTC1046
    ReadMarker,
96fdf90aacd6atagen2026-09-08 08:24 UTC1047
    TimelineStart,
96fdf90aacd6atagen2026-09-08 08:24 UTC1048
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1049
96fdf90aacd6atagen2026-09-08 08:24 UTC1050
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1051
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1052
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1053
pub enum TimelineDiff {
96fdf90aacd6atagen2026-09-08 08:24 UTC1054
    Append { values: Vec<TimelineItem> },
96fdf90aacd6atagen2026-09-08 08:24 UTC1055
    Clear,
96fdf90aacd6atagen2026-09-08 08:24 UTC1056
    PushFront { value: TimelineItem },
96fdf90aacd6atagen2026-09-08 08:24 UTC1057
    PushBack { value: TimelineItem },
96fdf90aacd6atagen2026-09-08 08:24 UTC1058
    PopFront,
96fdf90aacd6atagen2026-09-08 08:24 UTC1059
    PopBack,
96fdf90aacd6atagen2026-09-08 08:24 UTC1060
    Insert { index: usize, value: TimelineItem },
96fdf90aacd6atagen2026-09-08 08:24 UTC1061
    Set { index: usize, value: TimelineItem },
96fdf90aacd6atagen2026-09-08 08:24 UTC1062
    Remove { index: usize },
96fdf90aacd6atagen2026-09-08 08:24 UTC1063
    Truncate { length: usize },
96fdf90aacd6atagen2026-09-08 08:24 UTC1064
    Reset { values: Vec<TimelineItem> },
96fdf90aacd6atagen2026-09-08 08:24 UTC1065
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1066
96fdf90aacd6atagen2026-09-08 08:24 UTC1067
#[derive(Clone, Copy, Debug, Eq, PartialEq, thiserror::Error)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1068
#[error("timeline diff is incompatible with the current {length}-item snapshot")]
96fdf90aacd6atagen2026-09-08 08:24 UTC1069
pub struct TimelineDiffError {
96fdf90aacd6atagen2026-09-08 08:24 UTC1070
    pub length: usize,
96fdf90aacd6atagen2026-09-08 08:24 UTC1071
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1072
96fdf90aacd6atagen2026-09-08 08:24 UTC1073
impl TimelineDiff {
96fdf90aacd6atagen2026-09-08 08:24 UTC1074
    /// Apply a diff only when its indices match the current snapshot.
96fdf90aacd6atagen2026-09-08 08:24 UTC1075
    /// On error the snapshot is unchanged; request `TimelineCommand::Resync`
96fdf90aacd6atagen2026-09-08 08:24 UTC1076
    /// and ignore further diffs until the corresponding `TimelineReset`.
96fdf90aacd6atagen2026-09-08 08:24 UTC1077
    pub fn try_apply(self, items: &mut Vec<TimelineItem>) -> Result<(), TimelineDiffError> {
96fdf90aacd6atagen2026-09-08 08:24 UTC1078
        let length = items.len();
96fdf90aacd6atagen2026-09-08 08:24 UTC1079
        match self {
96fdf90aacd6atagen2026-09-08 08:24 UTC1080
            Self::Append { values } => items.extend(values),
96fdf90aacd6atagen2026-09-08 08:24 UTC1081
            Self::Clear => items.clear(),
96fdf90aacd6atagen2026-09-08 08:24 UTC1082
            Self::PushFront { value } => items.insert(0, value),
96fdf90aacd6atagen2026-09-08 08:24 UTC1083
            Self::PushBack { value } => items.push(value),
96fdf90aacd6atagen2026-09-08 08:24 UTC1084
            Self::PopFront if length == 0 => return Err(TimelineDiffError { length }),
96fdf90aacd6atagen2026-09-08 08:24 UTC1085
            Self::PopFront => {
96fdf90aacd6atagen2026-09-08 08:24 UTC1086
                items.remove(0);
96fdf90aacd6atagen2026-09-08 08:24 UTC1087
            }
96fdf90aacd6atagen2026-09-08 08:24 UTC1088
            Self::PopBack if length == 0 => return Err(TimelineDiffError { length }),
96fdf90aacd6atagen2026-09-08 08:24 UTC1089
            Self::PopBack => {
96fdf90aacd6atagen2026-09-08 08:24 UTC1090
                items.pop();
96fdf90aacd6atagen2026-09-08 08:24 UTC1091
            }
96fdf90aacd6atagen2026-09-08 08:24 UTC1092
            Self::Insert { index, .. } if index > length => {
96fdf90aacd6atagen2026-09-08 08:24 UTC1093
                return Err(TimelineDiffError { length });
96fdf90aacd6atagen2026-09-08 08:24 UTC1094
            }
96fdf90aacd6atagen2026-09-08 08:24 UTC1095
            Self::Insert { index, value } => items.insert(index, value),
96fdf90aacd6atagen2026-09-08 08:24 UTC1096
            Self::Set { index, .. } if index >= length => return Err(TimelineDiffError { length }),
96fdf90aacd6atagen2026-09-08 08:24 UTC1097
            Self::Set { index, value } => items[index] = value,
96fdf90aacd6atagen2026-09-08 08:24 UTC1098
            Self::Remove { index } if index >= length => return Err(TimelineDiffError { length }),
96fdf90aacd6atagen2026-09-08 08:24 UTC1099
            Self::Remove { index } => {
96fdf90aacd6atagen2026-09-08 08:24 UTC1100
                items.remove(index);
96fdf90aacd6atagen2026-09-08 08:24 UTC1101
            }
96fdf90aacd6atagen2026-09-08 08:24 UTC1102
            Self::Truncate { length: target } if target > length => {
96fdf90aacd6atagen2026-09-08 08:24 UTC1103
                return Err(TimelineDiffError { length });
96fdf90aacd6atagen2026-09-08 08:24 UTC1104
            }
96fdf90aacd6atagen2026-09-08 08:24 UTC1105
            Self::Truncate { length } => items.truncate(length),
96fdf90aacd6atagen2026-09-08 08:24 UTC1106
            Self::Reset { values } => *items = values,
96fdf90aacd6atagen2026-09-08 08:24 UTC1107
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC1108
        Ok(())
96fdf90aacd6atagen2026-09-08 08:24 UTC1109
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC1110
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1111
96fdf90aacd6atagen2026-09-08 08:24 UTC1112
#[cfg(test)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1113
mod tests {
96fdf90aacd6atagen2026-09-08 08:24 UTC1114
    use super::{TimelineDiff, TimelineItem};
96fdf90aacd6atagen2026-09-08 08:24 UTC1115
96fdf90aacd6atagen2026-09-08 08:24 UTC1116
    fn item(timestamp_ms: u64) -> TimelineItem {
96fdf90aacd6atagen2026-09-08 08:24 UTC1117
        TimelineItem::DayDivider { timestamp_ms }
96fdf90aacd6atagen2026-09-08 08:24 UTC1118
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC1119
96fdf90aacd6atagen2026-09-08 08:24 UTC1120
    #[test]
96fdf90aacd6atagen2026-09-08 08:24 UTC1121
    fn timeline_diff_try_apply_handles_every_variant() {
96fdf90aacd6atagen2026-09-08 08:24 UTC1122
        let mut items = vec![item(1), item(2)];
96fdf90aacd6atagen2026-09-08 08:24 UTC1123
96fdf90aacd6atagen2026-09-08 08:24 UTC1124
        TimelineDiff::Append {
96fdf90aacd6atagen2026-09-08 08:24 UTC1125
            values: vec![item(3)],
96fdf90aacd6atagen2026-09-08 08:24 UTC1126
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC1127
        .try_apply(&mut items)
96fdf90aacd6atagen2026-09-08 08:24 UTC1128
        .unwrap();
96fdf90aacd6atagen2026-09-08 08:24 UTC1129
        assert_eq!(items, vec![item(1), item(2), item(3)]);
96fdf90aacd6atagen2026-09-08 08:24 UTC1130
96fdf90aacd6atagen2026-09-08 08:24 UTC1131
        TimelineDiff::Clear.try_apply(&mut items).unwrap();
96fdf90aacd6atagen2026-09-08 08:24 UTC1132
        assert!(items.is_empty());
96fdf90aacd6atagen2026-09-08 08:24 UTC1133
96fdf90aacd6atagen2026-09-08 08:24 UTC1134
        TimelineDiff::PushFront { value: item(2) }
96fdf90aacd6atagen2026-09-08 08:24 UTC1135
            .try_apply(&mut items)
96fdf90aacd6atagen2026-09-08 08:24 UTC1136
            .unwrap();
96fdf90aacd6atagen2026-09-08 08:24 UTC1137
        TimelineDiff::PushBack { value: item(3) }
96fdf90aacd6atagen2026-09-08 08:24 UTC1138
            .try_apply(&mut items)
96fdf90aacd6atagen2026-09-08 08:24 UTC1139
            .unwrap();
96fdf90aacd6atagen2026-09-08 08:24 UTC1140
        assert_eq!(items, vec![item(2), item(3)]);
96fdf90aacd6atagen2026-09-08 08:24 UTC1141
96fdf90aacd6atagen2026-09-08 08:24 UTC1142
        TimelineDiff::PopFront.try_apply(&mut items).unwrap();
96fdf90aacd6atagen2026-09-08 08:24 UTC1143
        TimelineDiff::PopBack.try_apply(&mut items).unwrap();
96fdf90aacd6atagen2026-09-08 08:24 UTC1144
        assert!(items.is_empty());
96fdf90aacd6atagen2026-09-08 08:24 UTC1145
96fdf90aacd6atagen2026-09-08 08:24 UTC1146
        TimelineDiff::Reset {
96fdf90aacd6atagen2026-09-08 08:24 UTC1147
            values: vec![item(1), item(3)],
96fdf90aacd6atagen2026-09-08 08:24 UTC1148
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC1149
        .try_apply(&mut items)
96fdf90aacd6atagen2026-09-08 08:24 UTC1150
        .unwrap();
96fdf90aacd6atagen2026-09-08 08:24 UTC1151
        TimelineDiff::Insert {
96fdf90aacd6atagen2026-09-08 08:24 UTC1152
            index: 1,
96fdf90aacd6atagen2026-09-08 08:24 UTC1153
            value: item(2),
96fdf90aacd6atagen2026-09-08 08:24 UTC1154
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC1155
        .try_apply(&mut items)
96fdf90aacd6atagen2026-09-08 08:24 UTC1156
        .unwrap();
96fdf90aacd6atagen2026-09-08 08:24 UTC1157
        assert_eq!(items, vec![item(1), item(2), item(3)]);
96fdf90aacd6atagen2026-09-08 08:24 UTC1158
96fdf90aacd6atagen2026-09-08 08:24 UTC1159
        TimelineDiff::Set {
96fdf90aacd6atagen2026-09-08 08:24 UTC1160
            index: 1,
96fdf90aacd6atagen2026-09-08 08:24 UTC1161
            value: item(4),
96fdf90aacd6atagen2026-09-08 08:24 UTC1162
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC1163
        .try_apply(&mut items)
96fdf90aacd6atagen2026-09-08 08:24 UTC1164
        .unwrap();
96fdf90aacd6atagen2026-09-08 08:24 UTC1165
        assert_eq!(items, vec![item(1), item(4), item(3)]);
96fdf90aacd6atagen2026-09-08 08:24 UTC1166
96fdf90aacd6atagen2026-09-08 08:24 UTC1167
        TimelineDiff::Remove { index: 1 }
96fdf90aacd6atagen2026-09-08 08:24 UTC1168
            .try_apply(&mut items)
96fdf90aacd6atagen2026-09-08 08:24 UTC1169
            .unwrap();
96fdf90aacd6atagen2026-09-08 08:24 UTC1170
        assert_eq!(items, vec![item(1), item(3)]);
96fdf90aacd6atagen2026-09-08 08:24 UTC1171
96fdf90aacd6atagen2026-09-08 08:24 UTC1172
        TimelineDiff::Truncate { length: 1 }
96fdf90aacd6atagen2026-09-08 08:24 UTC1173
            .try_apply(&mut items)
96fdf90aacd6atagen2026-09-08 08:24 UTC1174
            .unwrap();
96fdf90aacd6atagen2026-09-08 08:24 UTC1175
        assert_eq!(items, vec![item(1)]);
96fdf90aacd6atagen2026-09-08 08:24 UTC1176
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC1177
96fdf90aacd6atagen2026-09-08 08:24 UTC1178
    #[test]
96fdf90aacd6atagen2026-09-08 08:24 UTC1179
    fn invalid_timeline_diff_leaves_snapshot_unchanged() {
96fdf90aacd6atagen2026-09-08 08:24 UTC1180
        let invalid = [
96fdf90aacd6atagen2026-09-08 08:24 UTC1181
            TimelineDiff::Insert {
96fdf90aacd6atagen2026-09-08 08:24 UTC1182
                index: 3,
96fdf90aacd6atagen2026-09-08 08:24 UTC1183
                value: item(3),
96fdf90aacd6atagen2026-09-08 08:24 UTC1184
            },
96fdf90aacd6atagen2026-09-08 08:24 UTC1185
            TimelineDiff::Set {
96fdf90aacd6atagen2026-09-08 08:24 UTC1186
                index: 2,
96fdf90aacd6atagen2026-09-08 08:24 UTC1187
                value: item(3),
96fdf90aacd6atagen2026-09-08 08:24 UTC1188
            },
96fdf90aacd6atagen2026-09-08 08:24 UTC1189
            TimelineDiff::Remove { index: 2 },
96fdf90aacd6atagen2026-09-08 08:24 UTC1190
            TimelineDiff::Truncate { length: 3 },
96fdf90aacd6atagen2026-09-08 08:24 UTC1191
        ];
96fdf90aacd6atagen2026-09-08 08:24 UTC1192
        for diff in invalid {
96fdf90aacd6atagen2026-09-08 08:24 UTC1193
            let mut items = vec![item(1), item(2)];
96fdf90aacd6atagen2026-09-08 08:24 UTC1194
            assert_eq!(diff.try_apply(&mut items).unwrap_err().length, 2);
96fdf90aacd6atagen2026-09-08 08:24 UTC1195
            assert_eq!(items, vec![item(1), item(2)]);
96fdf90aacd6atagen2026-09-08 08:24 UTC1196
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC1197
        for diff in [TimelineDiff::PopFront, TimelineDiff::PopBack] {
96fdf90aacd6atagen2026-09-08 08:24 UTC1198
            let mut items = Vec::new();
96fdf90aacd6atagen2026-09-08 08:24 UTC1199
            assert_eq!(diff.try_apply(&mut items).unwrap_err().length, 0);
96fdf90aacd6atagen2026-09-08 08:24 UTC1200
            assert!(items.is_empty());
96fdf90aacd6atagen2026-09-08 08:24 UTC1201
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC1202
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC1203
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1204
96fdf90aacd6atagen2026-09-08 08:24 UTC1205
#[derive(Clone, Debug, Eq, Hash, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1206
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1207
pub struct TimelineItemId(String);
96fdf90aacd6atagen2026-09-08 08:24 UTC1208
96fdf90aacd6atagen2026-09-08 08:24 UTC1209
impl TimelineItemId {
96fdf90aacd6atagen2026-09-08 08:24 UTC1210
    pub(crate) fn new(value: String) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC1211
        Self(value)
96fdf90aacd6atagen2026-09-08 08:24 UTC1212
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC1213
96fdf90aacd6atagen2026-09-08 08:24 UTC1214
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC1215
    pub fn as_str(&self) -> &str {
96fdf90aacd6atagen2026-09-08 08:24 UTC1216
        &self.0
96fdf90aacd6atagen2026-09-08 08:24 UTC1217
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC1218
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1219
96fdf90aacd6atagen2026-09-08 08:24 UTC1220
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1221
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1222
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1223
pub struct TimelineMessage {
96fdf90aacd6atagen2026-09-08 08:24 UTC1224
    pub item_id: TimelineItemId,
96fdf90aacd6atagen2026-09-08 08:24 UTC1225
    pub event_id: Option<OwnedEventId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1226
    pub transaction_id: Option<OwnedTransactionId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1227
    pub sender_id: OwnedUserId,
96fdf90aacd6atagen2026-09-08 08:24 UTC1228
    pub sender_name: String,
96fdf90aacd6atagen2026-09-08 08:24 UTC1229
    pub body: String,
96fdf90aacd6atagen2026-09-08 08:24 UTC1230
    pub formatted_body: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1231
    pub mentions: Option<MessageMentions>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1232
    pub thread_root: Option<OwnedEventId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1233
    pub thread_summary: Option<ThreadSummary>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1234
    pub timestamp_ms: u64,
96fdf90aacd6atagen2026-09-08 08:24 UTC1235
    pub own: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC1236
    pub send_state: SendState,
96fdf90aacd6atagen2026-09-08 08:24 UTC1237
    pub edited: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC1238
    pub unable_to_decrypt: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC1239
    pub media: Option<MediaDescriptor>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1240
    pub reply_to: Option<ReplyReference>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1241
    pub reactions: Vec<Reaction>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1242
    pub read_by: Vec<OwnedUserId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1243
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1244
96fdf90aacd6atagen2026-09-08 08:24 UTC1245
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1246
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1247
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1248
pub struct ThreadSummary {
96fdf90aacd6atagen2026-09-08 08:24 UTC1249
    pub reply_count: u32,
96fdf90aacd6atagen2026-09-08 08:24 UTC1250
    pub latest_event_id: Option<OwnedEventId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1251
    pub latest_event_timestamp_ms: Option<u64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1252
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1253
96fdf90aacd6atagen2026-09-08 08:24 UTC1254
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1255
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1256
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1257
pub enum SendState {
96fdf90aacd6atagen2026-09-08 08:24 UTC1258
    Sent,
96fdf90aacd6atagen2026-09-08 08:24 UTC1259
    Queued,
96fdf90aacd6atagen2026-09-08 08:24 UTC1260
    Sending,
96fdf90aacd6atagen2026-09-08 08:24 UTC1261
    Failed { retriable: bool },
96fdf90aacd6atagen2026-09-08 08:24 UTC1262
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1263
96fdf90aacd6atagen2026-09-08 08:24 UTC1264
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1265
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC1266
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1267
pub struct ReplyReference {
96fdf90aacd6atagen2026-09-08 08:24 UTC1268
    pub event_id: OwnedEventId,
96fdf90aacd6atagen2026-09-08 08:24 UTC1269
    pub sender_id: Option<OwnedUserId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1270
    pub sender_name: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1271
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1272
96fdf90aacd6atagen2026-09-08 08:24 UTC1273
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1274
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1275
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1276
pub struct Reaction {
96fdf90aacd6atagen2026-09-08 08:24 UTC1277
    pub key: String,
96fdf90aacd6atagen2026-09-08 08:24 UTC1278
    pub count: usize,
96fdf90aacd6atagen2026-09-08 08:24 UTC1279
    pub own: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC1280
    pub senders: Vec<OwnedUserId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1281
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1282
96fdf90aacd6atagen2026-09-08 08:24 UTC1283
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1284
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1285
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1286
pub struct MediaDescriptor {
96fdf90aacd6atagen2026-09-08 08:24 UTC1287
    pub id: MediaId,
96fdf90aacd6atagen2026-09-08 08:24 UTC1288
    pub kind: MediaKind,
96fdf90aacd6atagen2026-09-08 08:24 UTC1289
    pub filename: String,
96fdf90aacd6atagen2026-09-08 08:24 UTC1290
    pub caption: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1291
    pub mimetype: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1292
    pub size_bytes: Option<u64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1293
    pub width: Option<u64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1294
    pub height: Option<u64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1295
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1296
96fdf90aacd6atagen2026-09-08 08:24 UTC1297
#[derive(Clone, Debug, Eq, Hash, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1298
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1299
pub struct MediaId(String);
96fdf90aacd6atagen2026-09-08 08:24 UTC1300
96fdf90aacd6atagen2026-09-08 08:24 UTC1301
impl MediaId {
96fdf90aacd6atagen2026-09-08 08:24 UTC1302
    pub(crate) fn new(value: String) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC1303
        Self(value)
96fdf90aacd6atagen2026-09-08 08:24 UTC1304
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC1305
96fdf90aacd6atagen2026-09-08 08:24 UTC1306
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC1307
    pub fn as_str(&self) -> &str {
96fdf90aacd6atagen2026-09-08 08:24 UTC1308
        &self.0
96fdf90aacd6atagen2026-09-08 08:24 UTC1309
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC1310
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1311
96fdf90aacd6atagen2026-09-08 08:24 UTC1312
impl std::fmt::Display for MediaId {
96fdf90aacd6atagen2026-09-08 08:24 UTC1313
    fn fmt(&self, formatter: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
96fdf90aacd6atagen2026-09-08 08:24 UTC1314
        self.0.fmt(formatter)
96fdf90aacd6atagen2026-09-08 08:24 UTC1315
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC1316
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1317
96fdf90aacd6atagen2026-09-08 08:24 UTC1318
#[derive(Clone, Copy, Debug, Eq, Hash, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1319
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1320
pub enum MediaSize {
96fdf90aacd6atagen2026-09-08 08:24 UTC1321
    Full,
31ce2453c82fatagen2026-09-24 13:07 UTC1322
    /// a hint. an uploader's own thumbnail wins over the server resizing anything
31ce2453c82fatagen2026-09-24 13:07 UTC1323
    Thumbnail {
31ce2453c82fatagen2026-09-24 13:07 UTC1324
        width: u32,
31ce2453c82fatagen2026-09-24 13:07 UTC1325
        height: u32,
31ce2453c82fatagen2026-09-24 13:07 UTC1326
    },
31ce2453c82fatagen2026-09-24 13:07 UTC1327
}
31ce2453c82fatagen2026-09-24 13:07 UTC1328
31ce2453c82fatagen2026-09-24 13:07 UTC1329
#[derive(Clone, Debug, Eq, PartialEq)]
31ce2453c82fatagen2026-09-24 13:07 UTC1330
#[non_exhaustive]
31ce2453c82fatagen2026-09-24 13:07 UTC1331
pub struct Media {
31ce2453c82fatagen2026-09-24 13:07 UTC1332
    pub bytes: Arc<[u8]>,
31ce2453c82fatagen2026-09-24 13:07 UTC1333
    pub mimetype: String,
96fdf90aacd6atagen2026-09-08 08:24 UTC1334
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1335
96fdf90aacd6atagen2026-09-08 08:24 UTC1336
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1337
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1338
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1339
pub enum MediaKind {
96fdf90aacd6atagen2026-09-08 08:24 UTC1340
    Image,
96fdf90aacd6atagen2026-09-08 08:24 UTC1341
    Video,
96fdf90aacd6atagen2026-09-08 08:24 UTC1342
    Audio,
96fdf90aacd6atagen2026-09-08 08:24 UTC1343
    File,
96fdf90aacd6atagen2026-09-08 08:24 UTC1344
    Sticker,
96fdf90aacd6atagen2026-09-08 08:24 UTC1345
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1346
96fdf90aacd6atagen2026-09-08 08:24 UTC1347
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1348
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC1349
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1350
pub struct TypingState {
96fdf90aacd6atagen2026-09-08 08:24 UTC1351
    pub room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC1352
    pub users: Vec<OwnedUserId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1353
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1354
96fdf90aacd6atagen2026-09-08 08:24 UTC1355
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1356
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC1357
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1358
pub enum HistoryState {
96fdf90aacd6atagen2026-09-08 08:24 UTC1359
    Idle,
96fdf90aacd6atagen2026-09-08 08:24 UTC1360
    Loading,
96fdf90aacd6atagen2026-09-08 08:24 UTC1361
    StartReached,
96fdf90aacd6atagen2026-09-08 08:24 UTC1362
    Failed(String),
96fdf90aacd6atagen2026-09-08 08:24 UTC1363
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1364
96fdf90aacd6atagen2026-09-08 08:24 UTC1365
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1366
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1367
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1368
pub struct EncryptionState {
96fdf90aacd6atagen2026-09-08 08:24 UTC1369
    pub device_id: OwnedDeviceId,
96fdf90aacd6atagen2026-09-08 08:24 UTC1370
    pub device_verified: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC1371
    pub recovery: RecoveryState,
96fdf90aacd6atagen2026-09-08 08:24 UTC1372
    pub key_backup: KeyBackupState,
96fdf90aacd6atagen2026-09-08 08:24 UTC1373
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1374
96fdf90aacd6atagen2026-09-08 08:24 UTC1375
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1376
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC1377
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1378
pub enum KeyBackupState {
96fdf90aacd6atagen2026-09-08 08:24 UTC1379
    Unknown,
96fdf90aacd6atagen2026-09-08 08:24 UTC1380
    Creating,
96fdf90aacd6atagen2026-09-08 08:24 UTC1381
    Enabling,
96fdf90aacd6atagen2026-09-08 08:24 UTC1382
    Resuming,
96fdf90aacd6atagen2026-09-08 08:24 UTC1383
    Downloading,
96fdf90aacd6atagen2026-09-08 08:24 UTC1384
    Enabled,
96fdf90aacd6atagen2026-09-08 08:24 UTC1385
    Disabling,
96fdf90aacd6atagen2026-09-08 08:24 UTC1386
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1387
96fdf90aacd6atagen2026-09-08 08:24 UTC1388
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1389
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC1390
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1391
pub enum RecoveryState {
96fdf90aacd6atagen2026-09-08 08:24 UTC1392
    Unknown,
96fdf90aacd6atagen2026-09-08 08:24 UTC1393
    Disabled,
96fdf90aacd6atagen2026-09-08 08:24 UTC1394
    Incomplete,
96fdf90aacd6atagen2026-09-08 08:24 UTC1395
    Enabled,
96fdf90aacd6atagen2026-09-08 08:24 UTC1396
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1397
96fdf90aacd6atagen2026-09-08 08:24 UTC1398
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1399
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1400
pub enum VerificationAction {
96fdf90aacd6atagen2026-09-08 08:24 UTC1401
    Confirm,
96fdf90aacd6atagen2026-09-08 08:24 UTC1402
    Reject,
96fdf90aacd6atagen2026-09-08 08:24 UTC1403
    Cancel,
96fdf90aacd6atagen2026-09-08 08:24 UTC1404
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1405
96fdf90aacd6atagen2026-09-08 08:24 UTC1406
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1407
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1408
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1409
pub enum VerificationTarget {
96fdf90aacd6atagen2026-09-08 08:24 UTC1410
    OwnIdentity,
96fdf90aacd6atagen2026-09-08 08:24 UTC1411
    User(OwnedUserId),
96fdf90aacd6atagen2026-09-08 08:24 UTC1412
    Device {
96fdf90aacd6atagen2026-09-08 08:24 UTC1413
        user_id: OwnedUserId,
96fdf90aacd6atagen2026-09-08 08:24 UTC1414
        device_id: OwnedDeviceId,
96fdf90aacd6atagen2026-09-08 08:24 UTC1415
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC1416
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1417
96fdf90aacd6atagen2026-09-08 08:24 UTC1418
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1419
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC1420
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1421
pub enum VerificationState {
96fdf90aacd6atagen2026-09-08 08:24 UTC1422
    Waiting,
96fdf90aacd6atagen2026-09-08 08:24 UTC1423
    Comparison {
96fdf90aacd6atagen2026-09-08 08:24 UTC1424
        emojis: Vec<(String, String)>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1425
        decimals: (u16, u16, u16),
96fdf90aacd6atagen2026-09-08 08:24 UTC1426
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC1427
    Confirmed,
96fdf90aacd6atagen2026-09-08 08:24 UTC1428
    Done,
96fdf90aacd6atagen2026-09-08 08:24 UTC1429
    Cancelled(String),
96fdf90aacd6atagen2026-09-08 08:24 UTC1430
    Failed(VerificationFailure),
96fdf90aacd6atagen2026-09-08 08:24 UTC1431
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1432
96fdf90aacd6atagen2026-09-08 08:24 UTC1433
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1434
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1435
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1436
pub enum VerificationFailure {
96fdf90aacd6atagen2026-09-08 08:24 UTC1437
    RequestAcceptance(String),
96fdf90aacd6atagen2026-09-08 08:24 UTC1438
    SasStartup(String),
96fdf90aacd6atagen2026-09-08 08:24 UTC1439
    SasAcceptance(String),
96fdf90aacd6atagen2026-09-08 08:24 UTC1440
    RequestStreamEnded,
96fdf90aacd6atagen2026-09-08 08:24 UTC1441
    SasStreamEnded,
96fdf90aacd6atagen2026-09-08 08:24 UTC1442
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1443
96fdf90aacd6atagen2026-09-08 08:24 UTC1444
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1445
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1446
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1447
pub struct EngineFailure {
96fdf90aacd6atagen2026-09-08 08:24 UTC1448
    pub kind: EngineErrorKind,
96fdf90aacd6atagen2026-09-08 08:24 UTC1449
    pub message: String,
96fdf90aacd6atagen2026-09-08 08:24 UTC1450
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1451
96fdf90aacd6atagen2026-09-08 08:24 UTC1452
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1453
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1454
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1455
pub enum EngineErrorKind {
96fdf90aacd6atagen2026-09-08 08:24 UTC1456
    EventReceiverClosed,
96fdf90aacd6atagen2026-09-08 08:24 UTC1457
    Watcher,
96fdf90aacd6atagen2026-09-08 08:24 UTC1458
    Other,
96fdf90aacd6atagen2026-09-08 08:24 UTC1459
}