atagen

macltok

public
Star0
Watch0
411bc1c78b65ac2d29c0a44b166993a7e76f1663
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
d5d8097c3afdatagen2026-09-26 09:33 UTC3
use imbl::Vector;
96fdf90aacd6atagen2026-09-08 08:24 UTC4
use ruma::{
5d2974de5826atagen2026-10-08 11:29 UTC5
    MxcUri, OwnedDeviceId, OwnedEventId, OwnedMxcUri, OwnedRoomAliasId, OwnedRoomId,
17e042fbc331atagen2026-10-08 12:39 UTC6
    OwnedRoomOrAliasId, OwnedServerName, OwnedTransactionId, OwnedUserId, RoomId,
31ce2453c82fatagen2026-09-24 13:07 UTC7
    events::{
31ce2453c82fatagen2026-09-24 13:07 UTC8
        AnyGlobalAccountDataEventContent, AnyRoomAccountDataEventContent, AnySyncTimelineEvent,
31ce2453c82fatagen2026-09-24 13:07 UTC9
        GlobalAccountDataEventType, RoomAccountDataEventType,
31ce2453c82fatagen2026-09-24 13:07 UTC10
        room::member::StrippedRoomMemberEvent,
31ce2453c82fatagen2026-09-24 13:07 UTC11
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC12
    serde::Raw,
96fdf90aacd6atagen2026-09-08 08:24 UTC13
};
96fdf90aacd6atagen2026-09-08 08:24 UTC14
#[cfg(feature = "serde")]
96fdf90aacd6atagen2026-09-08 08:24 UTC15
use serde::{Deserialize, Serialize};
96fdf90aacd6atagen2026-09-08 08:24 UTC16
31ce2453c82fatagen2026-09-24 13:07 UTC17
/// every command answers exactly once through `ClientHandle::send` or `execute`.
31ce2453c82fatagen2026-09-24 13:07 UTC18
/// the event stream only ever carries state
31ce2453c82fatagen2026-09-24 13:07 UTC19
#[derive(Debug)]
96fdf90aacd6atagen2026-09-08 08:24 UTC20
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC21
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC22
pub enum Command {
96fdf90aacd6atagen2026-09-08 08:24 UTC23
    Account(AccountCommand),
96fdf90aacd6atagen2026-09-08 08:24 UTC24
    Room(RoomCommand),
96fdf90aacd6atagen2026-09-08 08:24 UTC25
    Timeline(TimelineCommand),
96fdf90aacd6atagen2026-09-08 08:24 UTC26
    Media(MediaCommand),
96fdf90aacd6atagen2026-09-08 08:24 UTC27
    Encryption(EncryptionCommand),
96fdf90aacd6atagen2026-09-08 08:24 UTC28
    Notification(NotificationCommand),
96fdf90aacd6atagen2026-09-08 08:24 UTC29
    Lifecycle(LifecycleCommand),
96fdf90aacd6atagen2026-09-08 08:24 UTC30
}
96fdf90aacd6atagen2026-09-08 08:24 UTC31
31ce2453c82fatagen2026-09-24 13:07 UTC32
#[derive(Debug)]
96fdf90aacd6atagen2026-09-08 08:24 UTC33
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC34
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC35
pub enum AccountCommand {
96fdf90aacd6atagen2026-09-08 08:24 UTC36
    Logout,
31ce2453c82fatagen2026-09-24 13:07 UTC37
    SetAccountData {
31ce2453c82fatagen2026-09-24 13:07 UTC38
        event_type: GlobalAccountDataEventType,
31ce2453c82fatagen2026-09-24 13:07 UTC39
        content: Raw<AnyGlobalAccountDataEventContent>,
31ce2453c82fatagen2026-09-24 13:07 UTC40
    },
31ce2453c82fatagen2026-09-24 13:07 UTC41
    SetDisplayName(Option<String>),
31ce2453c82fatagen2026-09-24 13:07 UTC42
    SetAvatar(Option<OwnedMxcUri>),
31ce2453c82fatagen2026-09-24 13:07 UTC43
    /// uploads the image and points the profile at it, same byte cap as any upload
31ce2453c82fatagen2026-09-24 13:07 UTC44
    UploadAvatar {
31ce2453c82fatagen2026-09-24 13:07 UTC45
        mimetype: String,
31ce2453c82fatagen2026-09-24 13:07 UTC46
        bytes: Vec<u8>,
31ce2453c82fatagen2026-09-24 13:07 UTC47
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC48
    RenameDevice {
96fdf90aacd6atagen2026-09-08 08:24 UTC49
        device_id: OwnedDeviceId,
96fdf90aacd6atagen2026-09-08 08:24 UTC50
        display_name: String,
96fdf90aacd6atagen2026-09-08 08:24 UTC51
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC52
    DeleteDevices {
96fdf90aacd6atagen2026-09-08 08:24 UTC53
        device_ids: Vec<OwnedDeviceId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC54
        auth: Option<crate::InteractiveAuth>,
96fdf90aacd6atagen2026-09-08 08:24 UTC55
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC56
}
96fdf90aacd6atagen2026-09-08 08:24 UTC57
31ce2453c82fatagen2026-09-24 13:07 UTC58
#[derive(Clone, Debug)]
96fdf90aacd6atagen2026-09-08 08:24 UTC59
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC60
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC61
pub enum RoomCommand {
31ce2453c82fatagen2026-09-24 13:07 UTC62
    /// the snapshot turns up as `Event::TimelineReset`. opening an open room sends a fresh one
96fdf90aacd6atagen2026-09-08 08:24 UTC63
    Open(OwnedRoomId),
96fdf90aacd6atagen2026-09-08 08:24 UTC64
    Close(OwnedRoomId),
96fdf90aacd6atagen2026-09-08 08:24 UTC65
    Join {
96fdf90aacd6atagen2026-09-08 08:24 UTC66
        room: OwnedRoomOrAliasId,
96fdf90aacd6atagen2026-09-08 08:24 UTC67
        via: Vec<OwnedServerName>,
96fdf90aacd6atagen2026-09-08 08:24 UTC68
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC69
    Leave(OwnedRoomId),
96fdf90aacd6atagen2026-09-08 08:24 UTC70
    Forget(OwnedRoomId),
96fdf90aacd6atagen2026-09-08 08:24 UTC71
    AcceptInvite(OwnedRoomId),
96fdf90aacd6atagen2026-09-08 08:24 UTC72
    RejectInvite(OwnedRoomId),
96fdf90aacd6atagen2026-09-08 08:24 UTC73
    InviteUser {
96fdf90aacd6atagen2026-09-08 08:24 UTC74
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC75
        user_id: OwnedUserId,
96fdf90aacd6atagen2026-09-08 08:24 UTC76
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC77
    KickUser {
96fdf90aacd6atagen2026-09-08 08:24 UTC78
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC79
        user_id: OwnedUserId,
96fdf90aacd6atagen2026-09-08 08:24 UTC80
        reason: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC81
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC82
    BanUser {
96fdf90aacd6atagen2026-09-08 08:24 UTC83
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC84
        user_id: OwnedUserId,
96fdf90aacd6atagen2026-09-08 08:24 UTC85
        reason: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC86
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC87
    UnbanUser {
96fdf90aacd6atagen2026-09-08 08:24 UTC88
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC89
        user_id: OwnedUserId,
96fdf90aacd6atagen2026-09-08 08:24 UTC90
        reason: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC91
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC92
    SetPowerLevels {
96fdf90aacd6atagen2026-09-08 08:24 UTC93
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC94
        changes: PowerLevelChanges,
96fdf90aacd6atagen2026-09-08 08:24 UTC95
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC96
    SetUserPowerLevel {
96fdf90aacd6atagen2026-09-08 08:24 UTC97
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC98
        user_id: OwnedUserId,
96fdf90aacd6atagen2026-09-08 08:24 UTC99
        level: i64,
96fdf90aacd6atagen2026-09-08 08:24 UTC100
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC101
    Create(CreateRoomOptions),
fa9114fcf75fatagen2026-09-24 12:51 UTC102
    /// hands back the existing dm if there is one
96fdf90aacd6atagen2026-09-08 08:24 UTC103
    CreateDirect(OwnedUserId),
96fdf90aacd6atagen2026-09-08 08:24 UTC104
    CancelSend {
96fdf90aacd6atagen2026-09-08 08:24 UTC105
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC106
        transaction_id: OwnedTransactionId,
96fdf90aacd6atagen2026-09-08 08:24 UTC107
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC108
    RetrySend {
96fdf90aacd6atagen2026-09-08 08:24 UTC109
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC110
        transaction_id: OwnedTransactionId,
96fdf90aacd6atagen2026-09-08 08:24 UTC111
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC112
    SetTyping {
96fdf90aacd6atagen2026-09-08 08:24 UTC113
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC114
        typing: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC115
    },
38c4caecdb3datagen2026-09-26 13:35 UTC116
    /// the key work a send into an encrypted room would otherwise start with, done now.
38c4caecdb3datagen2026-09-26 13:35 UTC117
    /// nothing in a plain room, and a second ask joins the first
38c4caecdb3datagen2026-09-26 13:35 UTC118
    PrepareToSend(OwnedRoomId),
31ce2453c82fatagen2026-09-24 13:07 UTC119
    SetAccountData {
31ce2453c82fatagen2026-09-24 13:07 UTC120
        room_id: OwnedRoomId,
31ce2453c82fatagen2026-09-24 13:07 UTC121
        event_type: RoomAccountDataEventType,
31ce2453c82fatagen2026-09-24 13:07 UTC122
        content: Raw<AnyRoomAccountDataEventContent>,
31ce2453c82fatagen2026-09-24 13:07 UTC123
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC124
}
96fdf90aacd6atagen2026-09-08 08:24 UTC125
96fdf90aacd6atagen2026-09-08 08:24 UTC126
#[derive(Clone, Debug, Default, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC127
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC128
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC129
pub struct CreateRoomOptions {
96fdf90aacd6atagen2026-09-08 08:24 UTC130
    pub name: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC131
    pub topic: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC132
    pub alias_localpart: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC133
    pub invite: Vec<OwnedUserId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC134
    pub direct: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC135
    pub visibility: RoomVisibility,
96fdf90aacd6atagen2026-09-08 08:24 UTC136
    pub preset: Option<RoomPreset>,
96fdf90aacd6atagen2026-09-08 08:24 UTC137
}
96fdf90aacd6atagen2026-09-08 08:24 UTC138
31ce2453c82fatagen2026-09-24 13:07 UTC139
impl CreateRoomOptions {
31ce2453c82fatagen2026-09-24 13:07 UTC140
    #[must_use]
31ce2453c82fatagen2026-09-24 13:07 UTC141
    pub fn with_name(mut self, name: impl Into<String>) -> Self {
31ce2453c82fatagen2026-09-24 13:07 UTC142
        self.name = Some(name.into());
31ce2453c82fatagen2026-09-24 13:07 UTC143
        self
31ce2453c82fatagen2026-09-24 13:07 UTC144
    }
31ce2453c82fatagen2026-09-24 13:07 UTC145
31ce2453c82fatagen2026-09-24 13:07 UTC146
    #[must_use]
31ce2453c82fatagen2026-09-24 13:07 UTC147
    pub fn with_topic(mut self, topic: impl Into<String>) -> Self {
31ce2453c82fatagen2026-09-24 13:07 UTC148
        self.topic = Some(topic.into());
31ce2453c82fatagen2026-09-24 13:07 UTC149
        self
31ce2453c82fatagen2026-09-24 13:07 UTC150
    }
31ce2453c82fatagen2026-09-24 13:07 UTC151
31ce2453c82fatagen2026-09-24 13:07 UTC152
    #[must_use]
31ce2453c82fatagen2026-09-24 13:07 UTC153
    pub fn with_alias_localpart(mut self, localpart: impl Into<String>) -> Self {
31ce2453c82fatagen2026-09-24 13:07 UTC154
        self.alias_localpart = Some(localpart.into());
31ce2453c82fatagen2026-09-24 13:07 UTC155
        self
31ce2453c82fatagen2026-09-24 13:07 UTC156
    }
31ce2453c82fatagen2026-09-24 13:07 UTC157
31ce2453c82fatagen2026-09-24 13:07 UTC158
    #[must_use]
31ce2453c82fatagen2026-09-24 13:07 UTC159
    pub fn with_invite(mut self, invite: impl IntoIterator<Item = OwnedUserId>) -> Self {
31ce2453c82fatagen2026-09-24 13:07 UTC160
        self.invite = invite.into_iter().collect();
31ce2453c82fatagen2026-09-24 13:07 UTC161
        self
31ce2453c82fatagen2026-09-24 13:07 UTC162
    }
31ce2453c82fatagen2026-09-24 13:07 UTC163
31ce2453c82fatagen2026-09-24 13:07 UTC164
    #[must_use]
31ce2453c82fatagen2026-09-24 13:07 UTC165
    pub const fn with_direct(mut self, direct: bool) -> Self {
31ce2453c82fatagen2026-09-24 13:07 UTC166
        self.direct = direct;
31ce2453c82fatagen2026-09-24 13:07 UTC167
        self
31ce2453c82fatagen2026-09-24 13:07 UTC168
    }
31ce2453c82fatagen2026-09-24 13:07 UTC169
31ce2453c82fatagen2026-09-24 13:07 UTC170
    #[must_use]
31ce2453c82fatagen2026-09-24 13:07 UTC171
    pub const fn with_visibility(mut self, visibility: RoomVisibility) -> Self {
31ce2453c82fatagen2026-09-24 13:07 UTC172
        self.visibility = visibility;
31ce2453c82fatagen2026-09-24 13:07 UTC173
        self
31ce2453c82fatagen2026-09-24 13:07 UTC174
    }
31ce2453c82fatagen2026-09-24 13:07 UTC175
31ce2453c82fatagen2026-09-24 13:07 UTC176
    #[must_use]
31ce2453c82fatagen2026-09-24 13:07 UTC177
    pub const fn with_preset(mut self, preset: RoomPreset) -> Self {
31ce2453c82fatagen2026-09-24 13:07 UTC178
        self.preset = Some(preset);
31ce2453c82fatagen2026-09-24 13:07 UTC179
        self
31ce2453c82fatagen2026-09-24 13:07 UTC180
    }
31ce2453c82fatagen2026-09-24 13:07 UTC181
}
31ce2453c82fatagen2026-09-24 13:07 UTC182
96fdf90aacd6atagen2026-09-08 08:24 UTC183
#[derive(Clone, Copy, Debug, Default, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC184
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC185
pub enum RoomVisibility {
96fdf90aacd6atagen2026-09-08 08:24 UTC186
    #[default]
96fdf90aacd6atagen2026-09-08 08:24 UTC187
    Private,
96fdf90aacd6atagen2026-09-08 08:24 UTC188
    Public,
96fdf90aacd6atagen2026-09-08 08:24 UTC189
}
96fdf90aacd6atagen2026-09-08 08:24 UTC190
96fdf90aacd6atagen2026-09-08 08:24 UTC191
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC192
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC193
pub enum RoomPreset {
96fdf90aacd6atagen2026-09-08 08:24 UTC194
    PrivateChat,
96fdf90aacd6atagen2026-09-08 08:24 UTC195
    TrustedPrivateChat,
96fdf90aacd6atagen2026-09-08 08:24 UTC196
    PublicChat,
96fdf90aacd6atagen2026-09-08 08:24 UTC197
}
96fdf90aacd6atagen2026-09-08 08:24 UTC198
96fdf90aacd6atagen2026-09-08 08:24 UTC199
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC200
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC201
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC202
pub enum TimelineCommand {
96fdf90aacd6atagen2026-09-08 08:24 UTC203
    OpenThread {
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
    CloseThread {
96fdf90aacd6atagen2026-09-08 08:24 UTC208
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC209
        root_event_id: OwnedEventId,
96fdf90aacd6atagen2026-09-08 08:24 UTC210
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC211
    /// Re-emit an authoritative reset for an open room or thread without
96fdf90aacd6atagen2026-09-08 08:24 UTC212
    /// closing it. The reset arrives before this command's terminal result.
96fdf90aacd6atagen2026-09-08 08:24 UTC213
    Resync {
96fdf90aacd6atagen2026-09-08 08:24 UTC214
        timeline_id: TimelineId,
96fdf90aacd6atagen2026-09-08 08:24 UTC215
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC216
    Paginate {
96fdf90aacd6atagen2026-09-08 08:24 UTC217
        timeline_id: TimelineId,
96fdf90aacd6atagen2026-09-08 08:24 UTC218
        limit: u16,
96fdf90aacd6atagen2026-09-08 08:24 UTC219
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC220
    Send {
96fdf90aacd6atagen2026-09-08 08:24 UTC221
        timeline_id: TimelineId,
96fdf90aacd6atagen2026-09-08 08:24 UTC222
        content: MessageContent,
96fdf90aacd6atagen2026-09-08 08:24 UTC223
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC224
    Edit {
96fdf90aacd6atagen2026-09-08 08:24 UTC225
        timeline_id: TimelineId,
960ac0721079atagen2026-09-25 00:24 UTC226
        target: EventRef,
96fdf90aacd6atagen2026-09-08 08:24 UTC227
        content: MessageEditContent,
96fdf90aacd6atagen2026-09-08 08:24 UTC228
    },
960ac0721079atagen2026-09-25 00:24 UTC229
    /// redacting your own unsent message just cancels it
96fdf90aacd6atagen2026-09-08 08:24 UTC230
    Redact {
96fdf90aacd6atagen2026-09-08 08:24 UTC231
        timeline_id: TimelineId,
960ac0721079atagen2026-09-25 00:24 UTC232
        target: EventRef,
96fdf90aacd6atagen2026-09-08 08:24 UTC233
        reason: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC234
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC235
    ToggleReaction {
96fdf90aacd6atagen2026-09-08 08:24 UTC236
        timeline_id: TimelineId,
960ac0721079atagen2026-09-25 00:24 UTC237
        target: EventRef,
96fdf90aacd6atagen2026-09-08 08:24 UTC238
        key: String,
8fa8a7cde89catagen2026-10-08 12:39 UTC239
        /// a custom emote's shortcode, sent along so clients without the pack can label it
8fa8a7cde89catagen2026-10-08 12:39 UTC240
        shortcode: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC241
    },
fa9114fcf75fatagen2026-09-24 12:51 UTC242
    /// works on a closed room too, it just can't refuse to move the marker backwards
fa9114fcf75fatagen2026-09-24 12:51 UTC243
    MarkRead {
fa9114fcf75fatagen2026-09-24 12:51 UTC244
        timeline_id: TimelineId,
fa9114fcf75fatagen2026-09-24 12:51 UTC245
        event_id: OwnedEventId,
fa9114fcf75fatagen2026-09-24 12:51 UTC246
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC247
}
96fdf90aacd6atagen2026-09-08 08:24 UTC248
96fdf90aacd6atagen2026-09-08 08:24 UTC249
impl TimelineCommand {
96fdf90aacd6atagen2026-09-08 08:24 UTC250
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC251
    pub const fn room_id(&self) -> &OwnedRoomId {
96fdf90aacd6atagen2026-09-08 08:24 UTC252
        match self {
96fdf90aacd6atagen2026-09-08 08:24 UTC253
            Self::OpenThread { room_id, .. } | Self::CloseThread { room_id, .. } => room_id,
96fdf90aacd6atagen2026-09-08 08:24 UTC254
            Self::Resync { timeline_id }
96fdf90aacd6atagen2026-09-08 08:24 UTC255
            | Self::Paginate { timeline_id, .. }
96fdf90aacd6atagen2026-09-08 08:24 UTC256
            | Self::Send { timeline_id, .. }
96fdf90aacd6atagen2026-09-08 08:24 UTC257
            | Self::Edit { timeline_id, .. }
96fdf90aacd6atagen2026-09-08 08:24 UTC258
            | Self::Redact { timeline_id, .. }
fa9114fcf75fatagen2026-09-24 12:51 UTC259
            | Self::ToggleReaction { timeline_id, .. }
fa9114fcf75fatagen2026-09-24 12:51 UTC260
            | Self::MarkRead { timeline_id, .. } => timeline_id.room_id(),
96fdf90aacd6atagen2026-09-08 08:24 UTC261
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC262
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC263
96fdf90aacd6atagen2026-09-08 08:24 UTC264
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC265
    pub const fn timeline_id(&self) -> Option<&TimelineId> {
96fdf90aacd6atagen2026-09-08 08:24 UTC266
        match self {
96fdf90aacd6atagen2026-09-08 08:24 UTC267
            Self::OpenThread { .. } | Self::CloseThread { .. } => None,
96fdf90aacd6atagen2026-09-08 08:24 UTC268
            Self::Resync { timeline_id }
96fdf90aacd6atagen2026-09-08 08:24 UTC269
            | Self::Paginate { timeline_id, .. }
96fdf90aacd6atagen2026-09-08 08:24 UTC270
            | Self::Send { timeline_id, .. }
96fdf90aacd6atagen2026-09-08 08:24 UTC271
            | Self::Edit { timeline_id, .. }
96fdf90aacd6atagen2026-09-08 08:24 UTC272
            | Self::Redact { timeline_id, .. }
fa9114fcf75fatagen2026-09-24 12:51 UTC273
            | Self::ToggleReaction { timeline_id, .. }
fa9114fcf75fatagen2026-09-24 12:51 UTC274
            | Self::MarkRead { timeline_id, .. } => Some(timeline_id),
96fdf90aacd6atagen2026-09-08 08:24 UTC275
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC276
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC277
}
96fdf90aacd6atagen2026-09-08 08:24 UTC278
96fdf90aacd6atagen2026-09-08 08:24 UTC279
#[derive(Clone, Debug, Eq, Hash, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC280
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC281
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC282
pub enum TimelineId {
96fdf90aacd6atagen2026-09-08 08:24 UTC283
    Room(OwnedRoomId),
96fdf90aacd6atagen2026-09-08 08:24 UTC284
    Thread {
96fdf90aacd6atagen2026-09-08 08:24 UTC285
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC286
        root_event_id: OwnedEventId,
96fdf90aacd6atagen2026-09-08 08:24 UTC287
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC288
}
96fdf90aacd6atagen2026-09-08 08:24 UTC289
96fdf90aacd6atagen2026-09-08 08:24 UTC290
impl TimelineId {
96fdf90aacd6atagen2026-09-08 08:24 UTC291
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC292
    pub const fn room_id(&self) -> &OwnedRoomId {
96fdf90aacd6atagen2026-09-08 08:24 UTC293
        match self {
96fdf90aacd6atagen2026-09-08 08:24 UTC294
            Self::Room(room_id) | Self::Thread { room_id, .. } => room_id,
96fdf90aacd6atagen2026-09-08 08:24 UTC295
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC296
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC297
96fdf90aacd6atagen2026-09-08 08:24 UTC298
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC299
    pub fn thread(room_id: OwnedRoomId, root_event_id: OwnedEventId) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC300
        Self::Thread {
96fdf90aacd6atagen2026-09-08 08:24 UTC301
            room_id,
96fdf90aacd6atagen2026-09-08 08:24 UTC302
            root_event_id,
96fdf90aacd6atagen2026-09-08 08:24 UTC303
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC304
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC305
96fdf90aacd6atagen2026-09-08 08:24 UTC306
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC307
    pub fn thread_root(&self) -> Option<&OwnedEventId> {
96fdf90aacd6atagen2026-09-08 08:24 UTC308
        match self {
96fdf90aacd6atagen2026-09-08 08:24 UTC309
            Self::Room(_) => None,
96fdf90aacd6atagen2026-09-08 08:24 UTC310
            Self::Thread { root_event_id, .. } => Some(root_event_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
96fdf90aacd6atagen2026-09-08 08:24 UTC315
impl From<OwnedRoomId> for TimelineId {
96fdf90aacd6atagen2026-09-08 08:24 UTC316
    fn from(room_id: OwnedRoomId) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC317
        Self::Room(room_id)
96fdf90aacd6atagen2026-09-08 08:24 UTC318
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC319
}
96fdf90aacd6atagen2026-09-08 08:24 UTC320
96fdf90aacd6atagen2026-09-08 08:24 UTC321
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC322
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC323
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC324
pub enum MediaCommand {
31ce2453c82fatagen2026-09-24 13:07 UTC325
    /// succeeds once the send queue has it. progress and failure arrive as events
31ce2453c82fatagen2026-09-24 13:07 UTC326
    Upload(AttachmentUpload),
96fdf90aacd6atagen2026-09-08 08:24 UTC327
}
96fdf90aacd6atagen2026-09-08 08:24 UTC328
96fdf90aacd6atagen2026-09-08 08:24 UTC329
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC330
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
5a52012c9b1datagen2026-09-24 23:45 UTC331
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC332
pub struct AttachmentUpload {
96fdf90aacd6atagen2026-09-08 08:24 UTC333
    pub timeline_id: TimelineId,
96fdf90aacd6atagen2026-09-08 08:24 UTC334
    pub filename: String,
96fdf90aacd6atagen2026-09-08 08:24 UTC335
    pub mimetype: String,
96fdf90aacd6atagen2026-09-08 08:24 UTC336
    pub bytes: Vec<u8>,
96fdf90aacd6atagen2026-09-08 08:24 UTC337
    pub caption: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC338
    pub details: Option<UploadDetails>,
96fdf90aacd6atagen2026-09-08 08:24 UTC339
    pub thumbnail: Option<UploadThumbnail>,
96fdf90aacd6atagen2026-09-08 08:24 UTC340
}
96fdf90aacd6atagen2026-09-08 08:24 UTC341
96fdf90aacd6atagen2026-09-08 08:24 UTC342
impl AttachmentUpload {
96fdf90aacd6atagen2026-09-08 08:24 UTC343
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC344
    pub fn new(
96fdf90aacd6atagen2026-09-08 08:24 UTC345
        timeline_id: impl Into<TimelineId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC346
        filename: impl Into<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC347
        mimetype: impl Into<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC348
        bytes: Vec<u8>,
96fdf90aacd6atagen2026-09-08 08:24 UTC349
    ) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC350
        Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC351
            timeline_id: timeline_id.into(),
96fdf90aacd6atagen2026-09-08 08:24 UTC352
            filename: filename.into(),
96fdf90aacd6atagen2026-09-08 08:24 UTC353
            mimetype: mimetype.into(),
96fdf90aacd6atagen2026-09-08 08:24 UTC354
            bytes,
96fdf90aacd6atagen2026-09-08 08:24 UTC355
            caption: None,
96fdf90aacd6atagen2026-09-08 08:24 UTC356
            details: None,
96fdf90aacd6atagen2026-09-08 08:24 UTC357
            thumbnail: None,
96fdf90aacd6atagen2026-09-08 08:24 UTC358
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC359
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC360
}
96fdf90aacd6atagen2026-09-08 08:24 UTC361
96fdf90aacd6atagen2026-09-08 08:24 UTC362
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC363
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC364
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC365
pub enum UploadDetails {
96fdf90aacd6atagen2026-09-08 08:24 UTC366
    Image {
96fdf90aacd6atagen2026-09-08 08:24 UTC367
        width: Option<u32>,
96fdf90aacd6atagen2026-09-08 08:24 UTC368
        height: Option<u32>,
96fdf90aacd6atagen2026-09-08 08:24 UTC369
        blurhash: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC370
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC371
    Video {
96fdf90aacd6atagen2026-09-08 08:24 UTC372
        width: Option<u32>,
96fdf90aacd6atagen2026-09-08 08:24 UTC373
        height: Option<u32>,
96fdf90aacd6atagen2026-09-08 08:24 UTC374
        duration_ms: Option<u64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC375
        blurhash: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC376
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC377
    Audio {
96fdf90aacd6atagen2026-09-08 08:24 UTC378
        duration_ms: Option<u64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC379
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC380
    Voice {
96fdf90aacd6atagen2026-09-08 08:24 UTC381
        duration_ms: u64,
96fdf90aacd6atagen2026-09-08 08:24 UTC382
        waveform: Vec<u16>,
96fdf90aacd6atagen2026-09-08 08:24 UTC383
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC384
    File,
96fdf90aacd6atagen2026-09-08 08:24 UTC385
}
96fdf90aacd6atagen2026-09-08 08:24 UTC386
96fdf90aacd6atagen2026-09-08 08:24 UTC387
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC388
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC389
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC390
pub struct UploadThumbnail {
96fdf90aacd6atagen2026-09-08 08:24 UTC391
    pub bytes: Vec<u8>,
96fdf90aacd6atagen2026-09-08 08:24 UTC392
    pub mimetype: String,
96fdf90aacd6atagen2026-09-08 08:24 UTC393
    pub width: u32,
96fdf90aacd6atagen2026-09-08 08:24 UTC394
    pub height: u32,
96fdf90aacd6atagen2026-09-08 08:24 UTC395
}
96fdf90aacd6atagen2026-09-08 08:24 UTC396
31ce2453c82fatagen2026-09-24 13:07 UTC397
impl UploadThumbnail {
31ce2453c82fatagen2026-09-24 13:07 UTC398
    #[must_use]
31ce2453c82fatagen2026-09-24 13:07 UTC399
    pub fn new(bytes: Vec<u8>, mimetype: impl Into<String>, width: u32, height: u32) -> Self {
31ce2453c82fatagen2026-09-24 13:07 UTC400
        Self {
31ce2453c82fatagen2026-09-24 13:07 UTC401
            bytes,
31ce2453c82fatagen2026-09-24 13:07 UTC402
            mimetype: mimetype.into(),
31ce2453c82fatagen2026-09-24 13:07 UTC403
            width,
31ce2453c82fatagen2026-09-24 13:07 UTC404
            height,
31ce2453c82fatagen2026-09-24 13:07 UTC405
        }
31ce2453c82fatagen2026-09-24 13:07 UTC406
    }
31ce2453c82fatagen2026-09-24 13:07 UTC407
}
31ce2453c82fatagen2026-09-24 13:07 UTC408
96fdf90aacd6atagen2026-09-08 08:24 UTC409
#[derive(Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC410
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC411
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC412
pub enum EncryptionCommand {
96fdf90aacd6atagen2026-09-08 08:24 UTC413
    Recover(String),
96fdf90aacd6atagen2026-09-08 08:24 UTC414
    CreateKeyBackup,
96fdf90aacd6atagen2026-09-08 08:24 UTC415
    EnableKeyBackup,
96fdf90aacd6atagen2026-09-08 08:24 UTC416
    DisableKeyBackup { delete_from_server: bool },
96fdf90aacd6atagen2026-09-08 08:24 UTC417
    RecoverKeyBackup(String),
96fdf90aacd6atagen2026-09-08 08:24 UTC418
    StartVerification(VerificationTarget),
96fdf90aacd6atagen2026-09-08 08:24 UTC419
    Verify(VerificationAction),
96fdf90aacd6atagen2026-09-08 08:24 UTC420
}
96fdf90aacd6atagen2026-09-08 08:24 UTC421
96fdf90aacd6atagen2026-09-08 08:24 UTC422
impl fmt::Debug for EncryptionCommand {
96fdf90aacd6atagen2026-09-08 08:24 UTC423
    fn fmt(&self, formatter: &mut fmt::Formatter<'_>) -> fmt::Result {
96fdf90aacd6atagen2026-09-08 08:24 UTC424
        match self {
96fdf90aacd6atagen2026-09-08 08:24 UTC425
            Self::Recover(_) => formatter.debug_tuple("Recover").field(&"...").finish(),
96fdf90aacd6atagen2026-09-08 08:24 UTC426
            Self::CreateKeyBackup => formatter.write_str("CreateKeyBackup"),
96fdf90aacd6atagen2026-09-08 08:24 UTC427
            Self::EnableKeyBackup => formatter.write_str("EnableKeyBackup"),
96fdf90aacd6atagen2026-09-08 08:24 UTC428
            Self::DisableKeyBackup { delete_from_server } => formatter
96fdf90aacd6atagen2026-09-08 08:24 UTC429
                .debug_struct("DisableKeyBackup")
96fdf90aacd6atagen2026-09-08 08:24 UTC430
                .field("delete_from_server", delete_from_server)
96fdf90aacd6atagen2026-09-08 08:24 UTC431
                .finish(),
96fdf90aacd6atagen2026-09-08 08:24 UTC432
            Self::RecoverKeyBackup(_) => formatter
96fdf90aacd6atagen2026-09-08 08:24 UTC433
                .debug_tuple("RecoverKeyBackup")
96fdf90aacd6atagen2026-09-08 08:24 UTC434
                .field(&"...")
96fdf90aacd6atagen2026-09-08 08:24 UTC435
                .finish(),
96fdf90aacd6atagen2026-09-08 08:24 UTC436
            Self::StartVerification(target) => formatter
96fdf90aacd6atagen2026-09-08 08:24 UTC437
                .debug_tuple("StartVerification")
96fdf90aacd6atagen2026-09-08 08:24 UTC438
                .field(target)
96fdf90aacd6atagen2026-09-08 08:24 UTC439
                .finish(),
96fdf90aacd6atagen2026-09-08 08:24 UTC440
            Self::Verify(action) => formatter.debug_tuple("Verify").field(action).finish(),
96fdf90aacd6atagen2026-09-08 08:24 UTC441
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC442
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC443
}
96fdf90aacd6atagen2026-09-08 08:24 UTC444
96fdf90aacd6atagen2026-09-08 08:24 UTC445
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC446
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC447
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC448
pub enum NotificationCommand {
96fdf90aacd6atagen2026-09-08 08:24 UTC449
    SetRoomMode {
96fdf90aacd6atagen2026-09-08 08:24 UTC450
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC451
        mode: RoomNotificationMode,
96fdf90aacd6atagen2026-09-08 08:24 UTC452
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC453
    ResetRoomMode(OwnedRoomId),
96fdf90aacd6atagen2026-09-08 08:24 UTC454
    SetDefaultMode {
96fdf90aacd6atagen2026-09-08 08:24 UTC455
        encrypted: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC456
        one_to_one: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC457
        mode: RoomNotificationMode,
96fdf90aacd6atagen2026-09-08 08:24 UTC458
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC459
    AddKeyword(String),
96fdf90aacd6atagen2026-09-08 08:24 UTC460
    RemoveKeyword(String),
96fdf90aacd6atagen2026-09-08 08:24 UTC461
}
96fdf90aacd6atagen2026-09-08 08:24 UTC462
96fdf90aacd6atagen2026-09-08 08:24 UTC463
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC464
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC465
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC466
pub enum LifecycleCommand {
96fdf90aacd6atagen2026-09-08 08:24 UTC467
    Shutdown,
96fdf90aacd6atagen2026-09-08 08:24 UTC468
}
96fdf90aacd6atagen2026-09-08 08:24 UTC469
31ce2453c82fatagen2026-09-24 13:07 UTC470
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC471
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC472
#[non_exhaustive]
31ce2453c82fatagen2026-09-24 13:07 UTC473
pub enum CommandOutput {
31ce2453c82fatagen2026-09-24 13:07 UTC474
    Done,
31ce2453c82fatagen2026-09-24 13:07 UTC475
    Room(OwnedRoomId),
96fdf90aacd6atagen2026-09-08 08:24 UTC476
}
96fdf90aacd6atagen2026-09-08 08:24 UTC477
96fdf90aacd6atagen2026-09-08 08:24 UTC478
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC479
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC480
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC481
pub enum MessageContent {
96fdf90aacd6atagen2026-09-08 08:24 UTC482
    Text {
96fdf90aacd6atagen2026-09-08 08:24 UTC483
        content: RichText,
96fdf90aacd6atagen2026-09-08 08:24 UTC484
        mentions: MessageMentions,
96fdf90aacd6atagen2026-09-08 08:24 UTC485
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC486
    Emote {
96fdf90aacd6atagen2026-09-08 08:24 UTC487
        content: RichText,
96fdf90aacd6atagen2026-09-08 08:24 UTC488
        mentions: MessageMentions,
96fdf90aacd6atagen2026-09-08 08:24 UTC489
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC490
    Reply {
96fdf90aacd6atagen2026-09-08 08:24 UTC491
        event_id: OwnedEventId,
96fdf90aacd6atagen2026-09-08 08:24 UTC492
        content: RichText,
96fdf90aacd6atagen2026-09-08 08:24 UTC493
        mentions: MessageMentions,
96fdf90aacd6atagen2026-09-08 08:24 UTC494
        notify_replied_to: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC495
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC496
}
96fdf90aacd6atagen2026-09-08 08:24 UTC497
96fdf90aacd6atagen2026-09-08 08:24 UTC498
impl MessageContent {
96fdf90aacd6atagen2026-09-08 08:24 UTC499
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC500
    pub fn text(body: impl Into<String>) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC501
        Self::Text {
96fdf90aacd6atagen2026-09-08 08:24 UTC502
            content: RichText::plain(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 html(body: impl Into<String>, formatted_body: impl Into<String>) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC509
        Self::Text {
96fdf90aacd6atagen2026-09-08 08:24 UTC510
            content: RichText::html(body, formatted_body),
96fdf90aacd6atagen2026-09-08 08:24 UTC511
            mentions: MessageMentions::default(),
96fdf90aacd6atagen2026-09-08 08:24 UTC512
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC513
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC514
96fdf90aacd6atagen2026-09-08 08:24 UTC515
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC516
    pub fn emote(content: RichText, mentions: MessageMentions) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC517
        Self::Emote { content, mentions }
96fdf90aacd6atagen2026-09-08 08:24 UTC518
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC519
96fdf90aacd6atagen2026-09-08 08:24 UTC520
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC521
    pub fn reply(event_id: OwnedEventId, content: RichText, mentions: MessageMentions) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC522
        Self::Reply {
96fdf90aacd6atagen2026-09-08 08:24 UTC523
            event_id,
96fdf90aacd6atagen2026-09-08 08:24 UTC524
            content,
96fdf90aacd6atagen2026-09-08 08:24 UTC525
            mentions,
96fdf90aacd6atagen2026-09-08 08:24 UTC526
            notify_replied_to: true,
96fdf90aacd6atagen2026-09-08 08:24 UTC527
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC528
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC529
96fdf90aacd6atagen2026-09-08 08:24 UTC530
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC531
    pub fn reply_without_notification(
96fdf90aacd6atagen2026-09-08 08:24 UTC532
        event_id: OwnedEventId,
96fdf90aacd6atagen2026-09-08 08:24 UTC533
        content: RichText,
96fdf90aacd6atagen2026-09-08 08:24 UTC534
        mentions: MessageMentions,
96fdf90aacd6atagen2026-09-08 08:24 UTC535
    ) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC536
        Self::Reply {
96fdf90aacd6atagen2026-09-08 08:24 UTC537
            event_id,
96fdf90aacd6atagen2026-09-08 08:24 UTC538
            content,
96fdf90aacd6atagen2026-09-08 08:24 UTC539
            mentions,
96fdf90aacd6atagen2026-09-08 08:24 UTC540
            notify_replied_to: false,
96fdf90aacd6atagen2026-09-08 08:24 UTC541
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC542
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC543
}
96fdf90aacd6atagen2026-09-08 08:24 UTC544
96fdf90aacd6atagen2026-09-08 08:24 UTC545
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC546
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC547
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC548
pub enum MessageEditContent {
96fdf90aacd6atagen2026-09-08 08:24 UTC549
    Text {
96fdf90aacd6atagen2026-09-08 08:24 UTC550
        content: RichText,
96fdf90aacd6atagen2026-09-08 08:24 UTC551
        mentions: MessageMentions,
96fdf90aacd6atagen2026-09-08 08:24 UTC552
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC553
    Emote {
96fdf90aacd6atagen2026-09-08 08:24 UTC554
        content: RichText,
96fdf90aacd6atagen2026-09-08 08:24 UTC555
        mentions: MessageMentions,
96fdf90aacd6atagen2026-09-08 08:24 UTC556
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC557
}
96fdf90aacd6atagen2026-09-08 08:24 UTC558
96fdf90aacd6atagen2026-09-08 08:24 UTC559
impl MessageEditContent {
96fdf90aacd6atagen2026-09-08 08:24 UTC560
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC561
    pub fn text(body: impl Into<String>) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC562
        Self::Text {
96fdf90aacd6atagen2026-09-08 08:24 UTC563
            content: RichText::plain(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 html(body: impl Into<String>, formatted_body: impl Into<String>) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC570
        Self::Text {
96fdf90aacd6atagen2026-09-08 08:24 UTC571
            content: RichText::html(body, formatted_body),
96fdf90aacd6atagen2026-09-08 08:24 UTC572
            mentions: MessageMentions::default(),
96fdf90aacd6atagen2026-09-08 08:24 UTC573
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC574
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC575
96fdf90aacd6atagen2026-09-08 08:24 UTC576
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC577
    pub fn emote(content: RichText, mentions: MessageMentions) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC578
        Self::Emote { content, mentions }
96fdf90aacd6atagen2026-09-08 08:24 UTC579
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC580
}
96fdf90aacd6atagen2026-09-08 08:24 UTC581
96fdf90aacd6atagen2026-09-08 08:24 UTC582
#[derive(Clone, Debug, Default, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC583
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC584
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC585
pub struct RichText {
96fdf90aacd6atagen2026-09-08 08:24 UTC586
    pub body: String,
96fdf90aacd6atagen2026-09-08 08:24 UTC587
    pub formatted_body: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC588
}
96fdf90aacd6atagen2026-09-08 08:24 UTC589
96fdf90aacd6atagen2026-09-08 08:24 UTC590
impl RichText {
96fdf90aacd6atagen2026-09-08 08:24 UTC591
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC592
    pub fn plain(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: None,
96fdf90aacd6atagen2026-09-08 08:24 UTC596
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC597
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC598
96fdf90aacd6atagen2026-09-08 08:24 UTC599
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC600
    pub fn html(body: impl Into<String>, formatted_body: impl Into<String>) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC601
        Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC602
            body: body.into(),
96fdf90aacd6atagen2026-09-08 08:24 UTC603
            formatted_body: Some(formatted_body.into()),
96fdf90aacd6atagen2026-09-08 08:24 UTC604
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC605
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC606
}
96fdf90aacd6atagen2026-09-08 08:24 UTC607
96fdf90aacd6atagen2026-09-08 08:24 UTC608
#[derive(Clone, Debug, Default, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC609
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC610
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC611
pub struct MessageMentions {
96fdf90aacd6atagen2026-09-08 08:24 UTC612
    pub user_ids: Vec<OwnedUserId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC613
    pub room: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC614
}
96fdf90aacd6atagen2026-09-08 08:24 UTC615
96fdf90aacd6atagen2026-09-08 08:24 UTC616
impl MessageMentions {
96fdf90aacd6atagen2026-09-08 08:24 UTC617
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC618
    pub fn with_user_ids(user_ids: impl IntoIterator<Item = OwnedUserId>) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC619
        Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC620
            user_ids: user_ids.into_iter().collect(),
96fdf90aacd6atagen2026-09-08 08:24 UTC621
            room: false,
96fdf90aacd6atagen2026-09-08 08:24 UTC622
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC623
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC624
96fdf90aacd6atagen2026-09-08 08:24 UTC625
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC626
    pub fn room() -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC627
        Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC628
            user_ids: Vec::new(),
96fdf90aacd6atagen2026-09-08 08:24 UTC629
            room: true,
96fdf90aacd6atagen2026-09-08 08:24 UTC630
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC631
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC632
}
96fdf90aacd6atagen2026-09-08 08:24 UTC633
96fdf90aacd6atagen2026-09-08 08:24 UTC634
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC635
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC636
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC637
pub enum Event {
96fdf90aacd6atagen2026-09-08 08:24 UTC638
    ConnectionChanged(ConnectionState),
96fdf90aacd6atagen2026-09-08 08:24 UTC639
    Authenticated {
96fdf90aacd6atagen2026-09-08 08:24 UTC640
        user_id: OwnedUserId,
96fdf90aacd6atagen2026-09-08 08:24 UTC641
    },
f12377bce9b9atagen2026-09-26 12:32 UTC642
    /// the tokens rotated. with a `SessionStore` the record is already saved by now,
f12377bce9b9atagen2026-09-26 12:32 UTC643
    /// without one persist a fresh `ClientHandle::session_record()` atomically
96fdf90aacd6atagen2026-09-08 08:24 UTC644
    SessionTokensChanged,
f12377bce9b9atagen2026-09-26 12:32 UTC645
    /// the rotated tokens didn't reach the `SessionStore`, so the saved record may not
f12377bce9b9atagen2026-09-26 12:32 UTC646
    /// restore. the engine tries again on the next rotation
f12377bce9b9atagen2026-09-26 12:32 UTC647
    SessionSaveFailed {
f12377bce9b9atagen2026-09-26 12:32 UTC648
        message: String,
f12377bce9b9atagen2026-09-26 12:32 UTC649
    },
7c26fad34822atagen2026-09-26 09:41 UTC650
    /// the server stopped honouring our token and the engine stops. a soft logout
7c26fad34822atagen2026-09-26 09:41 UTC651
    /// names the device to log in again as, keeping the store. otherwise the record
7c26fad34822atagen2026-09-26 09:41 UTC652
    /// and the store are both dead
fa9114fcf75fatagen2026-09-24 12:51 UTC653
    SessionAccessRejected {
7c26fad34822atagen2026-09-26 09:41 UTC654
        soft_logout: Option<OwnedDeviceId>,
fa9114fcf75fatagen2026-09-24 12:51 UTC655
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC656
    NotificationSettingsChanged,
96fdf90aacd6atagen2026-09-08 08:24 UTC657
    VerificationTargetChanged(VerificationTarget),
96fdf90aacd6atagen2026-09-08 08:24 UTC658
    RoomsChanged,
17e042fbc331atagen2026-10-08 12:39 UTC659
    /// an image pack came, went or changed somewhere. ask `image_packs` again
17e042fbc331atagen2026-10-08 12:39 UTC660
    ImagePacksChanged,
31ce2453c82fatagen2026-09-24 13:07 UTC661
    /// replaces whatever you had for this timeline. every diff after it applies to it
96fdf90aacd6atagen2026-09-08 08:24 UTC662
    TimelineReset {
96fdf90aacd6atagen2026-09-08 08:24 UTC663
        timeline_id: TimelineId,
d5d8097c3afdatagen2026-09-26 09:33 UTC664
        items: Vector<TimelineItem>,
96fdf90aacd6atagen2026-09-08 08:24 UTC665
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC666
    TimelineChanged {
96fdf90aacd6atagen2026-09-08 08:24 UTC667
        timeline_id: TimelineId,
96fdf90aacd6atagen2026-09-08 08:24 UTC668
        diffs: Vec<TimelineDiff>,
96fdf90aacd6atagen2026-09-08 08:24 UTC669
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC670
    HistoryChanged {
96fdf90aacd6atagen2026-09-08 08:24 UTC671
        timeline_id: TimelineId,
96fdf90aacd6atagen2026-09-08 08:24 UTC672
        state: HistoryState,
96fdf90aacd6atagen2026-09-08 08:24 UTC673
    },
0bfa3f46f0beatagen2026-09-26 09:12 UTC674
    /// the timeline was closed, or its room was left, and nothing more comes for it
0bfa3f46f0beatagen2026-09-26 09:12 UTC675
    /// until another `TimelineReset`
0bfa3f46f0beatagen2026-09-26 09:12 UTC676
    TimelineClosed {
0bfa3f46f0beatagen2026-09-26 09:12 UTC677
        timeline_id: TimelineId,
0bfa3f46f0beatagen2026-09-26 09:12 UTC678
    },
0bfa3f46f0beatagen2026-09-26 09:12 UTC679
    /// a room that stops being watched says so with an empty `users`
96fdf90aacd6atagen2026-09-08 08:24 UTC680
    TypingChanged(TypingState),
96fdf90aacd6atagen2026-09-08 08:24 UTC681
    MediaUploadProgress {
96fdf90aacd6atagen2026-09-08 08:24 UTC682
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC683
        transaction_id: OwnedTransactionId,
96fdf90aacd6atagen2026-09-08 08:24 UTC684
        uploaded_bytes: u64,
96fdf90aacd6atagen2026-09-08 08:24 UTC685
        total_bytes: u64,
96fdf90aacd6atagen2026-09-08 08:24 UTC686
        complete: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC687
    },
0bfa3f46f0beatagen2026-09-26 09:12 UTC688
    /// not the end of it. `will_retry` means the send queue has another go by itself,
0bfa3f46f0beatagen2026-09-26 09:12 UTC689
    /// otherwise it waits for `retry_send` or `cancel_send`
96fdf90aacd6atagen2026-09-08 08:24 UTC690
    MediaUploadFailed {
96fdf90aacd6atagen2026-09-08 08:24 UTC691
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC692
        transaction_id: OwnedTransactionId,
31ce2453c82fatagen2026-09-24 13:07 UTC693
        kind: crate::ErrorKind,
0bfa3f46f0beatagen2026-09-26 09:12 UTC694
        will_retry: bool,
0bfa3f46f0beatagen2026-09-26 09:12 UTC695
    },
7cf348521204atagen2026-09-26 12:28 UTC696
    /// an upload that turned up in a progress or failure event gets exactly one of
7cf348521204atagen2026-09-26 12:28 UTC697
    /// these while the engine runs, and nothing about it after. stopping ends
7cf348521204atagen2026-09-26 12:28 UTC698
    /// nothing, `Stopped` covers whatever is still going and the sdk resumes it next run
0bfa3f46f0beatagen2026-09-26 09:12 UTC699
    MediaUploadFinished {
0bfa3f46f0beatagen2026-09-26 09:12 UTC700
        room_id: OwnedRoomId,
0bfa3f46f0beatagen2026-09-26 09:12 UTC701
        transaction_id: OwnedTransactionId,
0bfa3f46f0beatagen2026-09-26 09:12 UTC702
        outcome: UploadOutcome,
96fdf90aacd6atagen2026-09-08 08:24 UTC703
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC704
    EncryptionChanged(EncryptionState),
96fdf90aacd6atagen2026-09-08 08:24 UTC705
    VerificationChanged(VerificationState),
fa9114fcf75fatagen2026-09-24 12:51 UTC706
    /// logout went through and the engine stops. delete the record and the store
96fdf90aacd6atagen2026-09-08 08:24 UTC707
    LoggedOut,
96fdf90aacd6atagen2026-09-08 08:24 UTC708
    Failed(EngineFailure),
fa9114fcf75fatagen2026-09-24 12:51 UTC709
    /// always the last event. keep the saved record unless `LoggedOut` or a
5a52012c9b1datagen2026-09-24 23:45 UTC710
    /// hard `SessionAccessRejected` came first. commands still in flight answer `Interrupted`
96fdf90aacd6atagen2026-09-08 08:24 UTC711
    Stopped,
96fdf90aacd6atagen2026-09-08 08:24 UTC712
}
96fdf90aacd6atagen2026-09-08 08:24 UTC713
0bfa3f46f0beatagen2026-09-26 09:12 UTC714
#[derive(Clone, Debug, Eq, PartialEq)]
0bfa3f46f0beatagen2026-09-26 09:12 UTC715
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
0bfa3f46f0beatagen2026-09-26 09:12 UTC716
#[non_exhaustive]
0bfa3f46f0beatagen2026-09-26 09:12 UTC717
pub enum UploadOutcome {
0bfa3f46f0beatagen2026-09-26 09:12 UTC718
    Sent {
0bfa3f46f0beatagen2026-09-26 09:12 UTC719
        event_id: OwnedEventId,
0bfa3f46f0beatagen2026-09-26 09:12 UTC720
    },
0bfa3f46f0beatagen2026-09-26 09:12 UTC721
    Cancelled,
0bfa3f46f0beatagen2026-09-26 09:12 UTC722
    /// its room was forgotten, and the queue with it
0bfa3f46f0beatagen2026-09-26 09:12 UTC723
    RoomForgotten,
0bfa3f46f0beatagen2026-09-26 09:12 UTC724
    /// the sdk's update channel overflowed while it ended, so whether it was sent is unknown
0bfa3f46f0beatagen2026-09-26 09:12 UTC725
    Missed,
0bfa3f46f0beatagen2026-09-26 09:12 UTC726
}
0bfa3f46f0beatagen2026-09-26 09:12 UTC727
fe4133dbcd47atagen2026-09-26 09:05 UTC728
/// why `Engine::run` came back, when nothing went wrong
fe4133dbcd47atagen2026-09-26 09:05 UTC729
#[derive(Clone, Debug, Eq, PartialEq)]
fe4133dbcd47atagen2026-09-26 09:05 UTC730
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
fe4133dbcd47atagen2026-09-26 09:05 UTC731
#[non_exhaustive]
fe4133dbcd47atagen2026-09-26 09:05 UTC732
pub enum Termination {
fe4133dbcd47atagen2026-09-26 09:05 UTC733
    ShutDown,
fe4133dbcd47atagen2026-09-26 09:05 UTC734
    /// every `ClientHandle` was dropped, so nobody could have asked for anything else
fe4133dbcd47atagen2026-09-26 09:05 UTC735
    HandlesDropped,
fe4133dbcd47atagen2026-09-26 09:05 UTC736
    LoggedOut,
fe4133dbcd47atagen2026-09-26 09:05 UTC737
    /// the server rejected our token for good
fe4133dbcd47atagen2026-09-26 09:05 UTC738
    AccessRevoked,
fe4133dbcd47atagen2026-09-26 09:05 UTC739
    /// the server wants this device to log in again, and its e2ee keys live in the store
fe4133dbcd47atagen2026-09-26 09:05 UTC740
    SoftLoggedOut {
fe4133dbcd47atagen2026-09-26 09:05 UTC741
        device_id: OwnedDeviceId,
fe4133dbcd47atagen2026-09-26 09:05 UTC742
    },
fe4133dbcd47atagen2026-09-26 09:05 UTC743
}
fe4133dbcd47atagen2026-09-26 09:05 UTC744
fe4133dbcd47atagen2026-09-26 09:05 UTC745
impl Termination {
fe4133dbcd47atagen2026-09-26 09:05 UTC746
    #[must_use]
fe4133dbcd47atagen2026-09-26 09:05 UTC747
    pub const fn retain(&self) -> Retain {
fe4133dbcd47atagen2026-09-26 09:05 UTC748
        match self {
fe4133dbcd47atagen2026-09-26 09:05 UTC749
            Self::ShutDown | Self::HandlesDropped => Retain::RecordAndStore,
fe4133dbcd47atagen2026-09-26 09:05 UTC750
            Self::SoftLoggedOut { .. } => Retain::Store,
fe4133dbcd47atagen2026-09-26 09:05 UTC751
            Self::LoggedOut | Self::AccessRevoked => Retain::Nothing,
fe4133dbcd47atagen2026-09-26 09:05 UTC752
        }
fe4133dbcd47atagen2026-09-26 09:05 UTC753
    }
fe4133dbcd47atagen2026-09-26 09:05 UTC754
}
fe4133dbcd47atagen2026-09-26 09:05 UTC755
fe4133dbcd47atagen2026-09-26 09:05 UTC756
/// what's still worth keeping of the saved record and the store
fe4133dbcd47atagen2026-09-26 09:05 UTC757
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
fe4133dbcd47atagen2026-09-26 09:05 UTC758
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
fe4133dbcd47atagen2026-09-26 09:05 UTC759
pub enum Retain {
fe4133dbcd47atagen2026-09-26 09:05 UTC760
    RecordAndStore,
6f1d6591c10datagen2026-09-26 09:52 UTC761
    /// keep the store and a record naming the device to log in again as
fe4133dbcd47atagen2026-09-26 09:05 UTC762
    Store,
fe4133dbcd47atagen2026-09-26 09:05 UTC763
    Nothing,
fe4133dbcd47atagen2026-09-26 09:05 UTC764
}
fe4133dbcd47atagen2026-09-26 09:05 UTC765
96fdf90aacd6atagen2026-09-08 08:24 UTC766
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC767
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC768
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC769
pub enum ConnectionState {
96fdf90aacd6atagen2026-09-08 08:24 UTC770
    Idle,
96fdf90aacd6atagen2026-09-08 08:24 UTC771
    Connecting,
96fdf90aacd6atagen2026-09-08 08:24 UTC772
    Online,
96fdf90aacd6atagen2026-09-08 08:24 UTC773
    Offline,
96fdf90aacd6atagen2026-09-08 08:24 UTC774
    Stopped,
96fdf90aacd6atagen2026-09-08 08:24 UTC775
}
96fdf90aacd6atagen2026-09-08 08:24 UTC776
96fdf90aacd6atagen2026-09-08 08:24 UTC777
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC778
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC779
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC780
pub struct RoomSummary {
96fdf90aacd6atagen2026-09-08 08:24 UTC781
    pub room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC782
    pub name: String,
96fdf90aacd6atagen2026-09-08 08:24 UTC783
    pub membership: RoomMembership,
96fdf90aacd6atagen2026-09-08 08:24 UTC784
    pub unread_messages: u64,
96fdf90aacd6atagen2026-09-08 08:24 UTC785
    pub unread_mentions: u64,
5a52012c9b1datagen2026-09-24 23:45 UTC786
    /// unread events the push rules said to notify about, which is neither of the above
5a52012c9b1datagen2026-09-24 23:45 UTC787
    pub unread_notifications: u64,
96fdf90aacd6atagen2026-09-08 08:24 UTC788
    pub encrypted: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC789
    pub space: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC790
    pub direct: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC791
    pub favourite: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC792
    pub low_priority: bool,
5d2974de5826atagen2026-10-08 11:29 UTC793
    pub avatar: Option<MediaId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC794
    pub latest_event_timestamp_ms: Option<u64>,
31ce2453c82fatagen2026-09-24 13:07 UTC795
    pub latest_event: Option<LatestEvent>,
96fdf90aacd6atagen2026-09-08 08:24 UTC796
    pub notification_mode: Option<RoomNotificationMode>,
96fdf90aacd6atagen2026-09-08 08:24 UTC797
    pub notification_mode_custom: bool,
31ce2453c82fatagen2026-09-24 13:07 UTC798
    pub topic: Option<String>,
31ce2453c82fatagen2026-09-24 13:07 UTC799
    pub canonical_alias: Option<OwnedRoomAliasId>,
31ce2453c82fatagen2026-09-24 13:07 UTC800
    pub joined_members: u64,
31ce2453c82fatagen2026-09-24 13:07 UTC801
    pub invited_members: u64,
31ce2453c82fatagen2026-09-24 13:07 UTC802
    /// who a nameless room gets named after
31ce2453c82fatagen2026-09-24 13:07 UTC803
    pub heroes: Vec<RoomHero>,
31ce2453c82fatagen2026-09-24 13:07 UTC804
    /// set once the room has been upgraded, this is where everyone went
31ce2453c82fatagen2026-09-24 13:07 UTC805
    pub successor: Option<OwnedRoomId>,
31ce2453c82fatagen2026-09-24 13:07 UTC806
    pub inviter: Option<OwnedUserId>,
31ce2453c82fatagen2026-09-24 13:07 UTC807
    /// joined spaces that list this room as a child
31ce2453c82fatagen2026-09-24 13:07 UTC808
    pub parent_spaces: Vec<OwnedRoomId>,
31ce2453c82fatagen2026-09-24 13:07 UTC809
    /// for a space, the children it lists, joined or not
31ce2453c82fatagen2026-09-24 13:07 UTC810
    pub children: Vec<OwnedRoomId>,
31ce2453c82fatagen2026-09-24 13:07 UTC811
}
31ce2453c82fatagen2026-09-24 13:07 UTC812
31ce2453c82fatagen2026-09-24 13:07 UTC813
#[derive(Clone, Debug, Eq, PartialEq)]
31ce2453c82fatagen2026-09-24 13:07 UTC814
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC815
#[non_exhaustive]
31ce2453c82fatagen2026-09-24 13:07 UTC816
pub struct RoomHero {
31ce2453c82fatagen2026-09-24 13:07 UTC817
    pub user_id: OwnedUserId,
31ce2453c82fatagen2026-09-24 13:07 UTC818
    pub display_name: Option<String>,
5d2974de5826atagen2026-10-08 11:29 UTC819
    pub avatar: Option<MediaId>,
31ce2453c82fatagen2026-09-24 13:07 UTC820
}
31ce2453c82fatagen2026-09-24 13:07 UTC821
5a52012c9b1datagen2026-09-24 23:45 UTC822
/// enough for a room list preview line. `kind` and `body` are only set for messages,
5a52012c9b1datagen2026-09-24 23:45 UTC823
/// and an edit shows its new text
31ce2453c82fatagen2026-09-24 13:07 UTC824
#[derive(Clone, Debug, Eq, PartialEq)]
31ce2453c82fatagen2026-09-24 13:07 UTC825
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC826
#[non_exhaustive]
31ce2453c82fatagen2026-09-24 13:07 UTC827
pub struct LatestEvent {
31ce2453c82fatagen2026-09-24 13:07 UTC828
    pub sender: Option<OwnedUserId>,
5a52012c9b1datagen2026-09-24 23:45 UTC829
    pub kind: Option<MessageKind>,
31ce2453c82fatagen2026-09-24 13:07 UTC830
    pub body: Option<String>,
31ce2453c82fatagen2026-09-24 13:07 UTC831
    pub timestamp_ms: Option<u64>,
31ce2453c82fatagen2026-09-24 13:07 UTC832
    pub send_state: SendState,
31ce2453c82fatagen2026-09-24 13:07 UTC833
}
31ce2453c82fatagen2026-09-24 13:07 UTC834
31ce2453c82fatagen2026-09-24 13:07 UTC835
#[derive(Clone, Debug, Eq, PartialEq)]
31ce2453c82fatagen2026-09-24 13:07 UTC836
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC837
#[non_exhaustive]
31ce2453c82fatagen2026-09-24 13:07 UTC838
pub struct Profile {
31ce2453c82fatagen2026-09-24 13:07 UTC839
    pub user_id: OwnedUserId,
31ce2453c82fatagen2026-09-24 13:07 UTC840
    pub display_name: Option<String>,
5d2974de5826atagen2026-10-08 11:29 UTC841
    pub avatar: Option<MediaId>,
31ce2453c82fatagen2026-09-24 13:07 UTC842
}
31ce2453c82fatagen2026-09-24 13:07 UTC843
31ce2453c82fatagen2026-09-24 13:07 UTC844
/// 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 UTC845
#[derive(Clone, Debug, Eq, PartialEq)]
31ce2453c82fatagen2026-09-24 13:07 UTC846
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC847
#[non_exhaustive]
31ce2453c82fatagen2026-09-24 13:07 UTC848
pub struct SpaceChild {
31ce2453c82fatagen2026-09-24 13:07 UTC849
    pub room_id: OwnedRoomId,
31ce2453c82fatagen2026-09-24 13:07 UTC850
    pub name: String,
31ce2453c82fatagen2026-09-24 13:07 UTC851
    pub topic: Option<String>,
5d2974de5826atagen2026-10-08 11:29 UTC852
    pub avatar: Option<MediaId>,
31ce2453c82fatagen2026-09-24 13:07 UTC853
    pub canonical_alias: Option<OwnedRoomAliasId>,
31ce2453c82fatagen2026-09-24 13:07 UTC854
    pub joined_members: u64,
31ce2453c82fatagen2026-09-24 13:07 UTC855
    pub space: bool,
31ce2453c82fatagen2026-09-24 13:07 UTC856
    pub children_count: u64,
31ce2453c82fatagen2026-09-24 13:07 UTC857
    pub membership: Option<RoomMembership>,
31ce2453c82fatagen2026-09-24 13:07 UTC858
    pub via: Vec<OwnedServerName>,
31ce2453c82fatagen2026-09-24 13:07 UTC859
    pub suggested: bool,
31ce2453c82fatagen2026-09-24 13:07 UTC860
    pub world_readable: Option<bool>,
31ce2453c82fatagen2026-09-24 13:07 UTC861
    pub guest_can_join: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC862
}
96fdf90aacd6atagen2026-09-08 08:24 UTC863
96fdf90aacd6atagen2026-09-08 08:24 UTC864
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC865
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC866
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC867
pub enum RoomNotificationMode {
96fdf90aacd6atagen2026-09-08 08:24 UTC868
    AllMessages,
96fdf90aacd6atagen2026-09-08 08:24 UTC869
    MentionsAndKeywordsOnly,
96fdf90aacd6atagen2026-09-08 08:24 UTC870
    Mute,
96fdf90aacd6atagen2026-09-08 08:24 UTC871
}
96fdf90aacd6atagen2026-09-08 08:24 UTC872
96fdf90aacd6atagen2026-09-08 08:24 UTC873
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC874
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC875
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC876
pub struct RoomNotificationSettings {
96fdf90aacd6atagen2026-09-08 08:24 UTC877
    pub mode: RoomNotificationMode,
96fdf90aacd6atagen2026-09-08 08:24 UTC878
    pub custom: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC879
}
96fdf90aacd6atagen2026-09-08 08:24 UTC880
96fdf90aacd6atagen2026-09-08 08:24 UTC881
#[derive(Clone, Debug)]
96fdf90aacd6atagen2026-09-08 08:24 UTC882
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC883
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC884
pub enum PushNotificationStatus {
96fdf90aacd6atagen2026-09-08 08:24 UTC885
    Event(Box<PushNotification>),
96fdf90aacd6atagen2026-09-08 08:24 UTC886
    NotFound,
96fdf90aacd6atagen2026-09-08 08:24 UTC887
    FilteredOut,
96fdf90aacd6atagen2026-09-08 08:24 UTC888
    Redacted,
96fdf90aacd6atagen2026-09-08 08:24 UTC889
}
96fdf90aacd6atagen2026-09-08 08:24 UTC890
96fdf90aacd6atagen2026-09-08 08:24 UTC891
#[derive(Clone, Debug)]
96fdf90aacd6atagen2026-09-08 08:24 UTC892
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC893
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC894
pub struct PushNotification {
96fdf90aacd6atagen2026-09-08 08:24 UTC895
    pub event_id: OwnedEventId,
96fdf90aacd6atagen2026-09-08 08:24 UTC896
    pub event: PushNotificationEvent,
96fdf90aacd6atagen2026-09-08 08:24 UTC897
    pub sender: PushNotificationSender,
96fdf90aacd6atagen2026-09-08 08:24 UTC898
    pub room: PushNotificationRoom,
96fdf90aacd6atagen2026-09-08 08:24 UTC899
    pub noisy: Option<bool>,
96fdf90aacd6atagen2026-09-08 08:24 UTC900
    pub has_mention: Option<bool>,
96fdf90aacd6atagen2026-09-08 08:24 UTC901
    pub thread_id: Option<OwnedEventId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC902
}
96fdf90aacd6atagen2026-09-08 08:24 UTC903
96fdf90aacd6atagen2026-09-08 08:24 UTC904
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC905
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC906
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC907
pub struct PushNotificationSender {
96fdf90aacd6atagen2026-09-08 08:24 UTC908
    pub user_id: OwnedUserId,
96fdf90aacd6atagen2026-09-08 08:24 UTC909
    pub display_name: Option<String>,
5d2974de5826atagen2026-10-08 11:29 UTC910
    pub avatar_url: Option<MediaId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC911
    pub name_ambiguous: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC912
}
96fdf90aacd6atagen2026-09-08 08:24 UTC913
96fdf90aacd6atagen2026-09-08 08:24 UTC914
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC915
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC916
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC917
pub struct PushNotificationRoom {
96fdf90aacd6atagen2026-09-08 08:24 UTC918
    pub room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC919
    pub name: String,
5d2974de5826atagen2026-10-08 11:29 UTC920
    pub avatar_url: Option<MediaId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC921
    pub canonical_alias: Option<OwnedRoomAliasId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC922
    pub topic: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC923
    pub encrypted: Option<bool>,
96fdf90aacd6atagen2026-09-08 08:24 UTC924
    pub direct: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC925
    pub joined_members_count: u64,
96fdf90aacd6atagen2026-09-08 08:24 UTC926
    pub service_members: Vec<OwnedUserId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC927
    pub active_service_members_count: u64,
96fdf90aacd6atagen2026-09-08 08:24 UTC928
    pub space: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC929
}
96fdf90aacd6atagen2026-09-08 08:24 UTC930
96fdf90aacd6atagen2026-09-08 08:24 UTC931
#[derive(Clone, Debug)]
96fdf90aacd6atagen2026-09-08 08:24 UTC932
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC933
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC934
pub enum PushNotificationEvent {
96fdf90aacd6atagen2026-09-08 08:24 UTC935
    Timeline(Raw<AnySyncTimelineEvent>),
96fdf90aacd6atagen2026-09-08 08:24 UTC936
    Invite(Raw<StrippedRoomMemberEvent>),
96fdf90aacd6atagen2026-09-08 08:24 UTC937
}
96fdf90aacd6atagen2026-09-08 08:24 UTC938
96fdf90aacd6atagen2026-09-08 08:24 UTC939
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC940
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC941
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC942
pub struct RoomPowerLevels {
96fdf90aacd6atagen2026-09-08 08:24 UTC943
    pub ban: i64,
96fdf90aacd6atagen2026-09-08 08:24 UTC944
    pub invite: i64,
96fdf90aacd6atagen2026-09-08 08:24 UTC945
    pub kick: i64,
96fdf90aacd6atagen2026-09-08 08:24 UTC946
    pub redact: i64,
96fdf90aacd6atagen2026-09-08 08:24 UTC947
    pub events_default: i64,
96fdf90aacd6atagen2026-09-08 08:24 UTC948
    pub state_default: i64,
96fdf90aacd6atagen2026-09-08 08:24 UTC949
    pub users_default: i64,
96fdf90aacd6atagen2026-09-08 08:24 UTC950
    pub room_notification: i64,
96fdf90aacd6atagen2026-09-08 08:24 UTC951
    pub users: Vec<(OwnedUserId, i64)>,
96fdf90aacd6atagen2026-09-08 08:24 UTC952
    pub events: Vec<(String, i64)>,
5a52012c9b1datagen2026-09-24 23:45 UTC953
    /// in rooms from version 12 the creators outrank everyone and aren't listed in `users`
5a52012c9b1datagen2026-09-24 23:45 UTC954
    pub creators: Vec<OwnedUserId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC955
}
96fdf90aacd6atagen2026-09-08 08:24 UTC956
96fdf90aacd6atagen2026-09-08 08:24 UTC957
#[derive(Clone, Debug, Default, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC958
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC959
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC960
pub struct PowerLevelChanges {
96fdf90aacd6atagen2026-09-08 08:24 UTC961
    pub ban: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC962
    pub invite: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC963
    pub kick: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC964
    pub redact: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC965
    pub events_default: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC966
    pub state_default: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC967
    pub users_default: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC968
    pub room_notification: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC969
    pub room_name: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC970
    pub room_avatar: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC971
    pub room_topic: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC972
    pub space_child: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC973
    pub beacon: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC974
    pub beacon_info: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC975
}
96fdf90aacd6atagen2026-09-08 08:24 UTC976
96fdf90aacd6atagen2026-09-08 08:24 UTC977
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC978
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC979
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC980
pub enum RoomMembership {
96fdf90aacd6atagen2026-09-08 08:24 UTC981
    Joined,
96fdf90aacd6atagen2026-09-08 08:24 UTC982
    Invited,
96fdf90aacd6atagen2026-09-08 08:24 UTC983
    Left,
96fdf90aacd6atagen2026-09-08 08:24 UTC984
    Knocked,
96fdf90aacd6atagen2026-09-08 08:24 UTC985
    Banned,
96fdf90aacd6atagen2026-09-08 08:24 UTC986
}
96fdf90aacd6atagen2026-09-08 08:24 UTC987
96fdf90aacd6atagen2026-09-08 08:24 UTC988
#[derive(Clone, Debug, Default, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC989
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC990
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC991
pub struct RoomListFilter {
96fdf90aacd6atagen2026-09-08 08:24 UTC992
    pub membership: Option<RoomMembership>,
96fdf90aacd6atagen2026-09-08 08:24 UTC993
    pub category: Option<RoomCategory>,
96fdf90aacd6atagen2026-09-08 08:24 UTC994
    pub favourite: Option<bool>,
96fdf90aacd6atagen2026-09-08 08:24 UTC995
    pub unread_only: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC996
    pub search: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC997
}
96fdf90aacd6atagen2026-09-08 08:24 UTC998
96fdf90aacd6atagen2026-09-08 08:24 UTC999
impl RoomListFilter {
96fdf90aacd6atagen2026-09-08 08:24 UTC1000
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC1001
    pub fn with_membership(mut self, membership: RoomMembership) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC1002
        self.membership = Some(membership);
96fdf90aacd6atagen2026-09-08 08:24 UTC1003
        self
96fdf90aacd6atagen2026-09-08 08:24 UTC1004
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC1005
96fdf90aacd6atagen2026-09-08 08:24 UTC1006
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC1007
    pub fn with_category(mut self, category: RoomCategory) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC1008
        self.category = Some(category);
96fdf90aacd6atagen2026-09-08 08:24 UTC1009
        self
96fdf90aacd6atagen2026-09-08 08:24 UTC1010
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC1011
96fdf90aacd6atagen2026-09-08 08:24 UTC1012
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC1013
    pub fn with_favourite(mut self, favourite: bool) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC1014
        self.favourite = Some(favourite);
96fdf90aacd6atagen2026-09-08 08:24 UTC1015
        self
96fdf90aacd6atagen2026-09-08 08:24 UTC1016
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC1017
96fdf90aacd6atagen2026-09-08 08:24 UTC1018
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC1019
    pub const fn with_unread_only(mut self, unread_only: bool) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC1020
        self.unread_only = unread_only;
96fdf90aacd6atagen2026-09-08 08:24 UTC1021
        self
96fdf90aacd6atagen2026-09-08 08:24 UTC1022
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC1023
96fdf90aacd6atagen2026-09-08 08:24 UTC1024
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC1025
    pub fn with_search(mut self, search: impl Into<String>) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC1026
        self.search = Some(search.into());
96fdf90aacd6atagen2026-09-08 08:24 UTC1027
        self
96fdf90aacd6atagen2026-09-08 08:24 UTC1028
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC1029
96fdf90aacd6atagen2026-09-08 08:24 UTC1030
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC1031
    pub fn matches(&self, room: &RoomSummary) -> bool {
31ce2453c82fatagen2026-09-24 13:07 UTC1032
        self.matcher().matches(room)
31ce2453c82fatagen2026-09-24 13:07 UTC1033
    }
31ce2453c82fatagen2026-09-24 13:07 UTC1034
31ce2453c82fatagen2026-09-24 13:07 UTC1035
    /// lowercases the search once, for filtering a whole list
31ce2453c82fatagen2026-09-24 13:07 UTC1036
    #[must_use]
31ce2453c82fatagen2026-09-24 13:07 UTC1037
    pub fn matcher(&self) -> RoomMatcher<'_> {
31ce2453c82fatagen2026-09-24 13:07 UTC1038
        RoomMatcher {
31ce2453c82fatagen2026-09-24 13:07 UTC1039
            filter: self,
31ce2453c82fatagen2026-09-24 13:07 UTC1040
            search: self.search.as_deref().map(str::to_lowercase),
31ce2453c82fatagen2026-09-24 13:07 UTC1041
        }
31ce2453c82fatagen2026-09-24 13:07 UTC1042
    }
31ce2453c82fatagen2026-09-24 13:07 UTC1043
}
31ce2453c82fatagen2026-09-24 13:07 UTC1044
31ce2453c82fatagen2026-09-24 13:07 UTC1045
#[derive(Debug)]
31ce2453c82fatagen2026-09-24 13:07 UTC1046
pub struct RoomMatcher<'a> {
31ce2453c82fatagen2026-09-24 13:07 UTC1047
    filter: &'a RoomListFilter,
31ce2453c82fatagen2026-09-24 13:07 UTC1048
    search: Option<String>,
31ce2453c82fatagen2026-09-24 13:07 UTC1049
}
31ce2453c82fatagen2026-09-24 13:07 UTC1050
31ce2453c82fatagen2026-09-24 13:07 UTC1051
impl RoomMatcher<'_> {
31ce2453c82fatagen2026-09-24 13:07 UTC1052
    #[must_use]
31ce2453c82fatagen2026-09-24 13:07 UTC1053
    pub fn matches(&self, room: &RoomSummary) -> bool {
31ce2453c82fatagen2026-09-24 13:07 UTC1054
        let filter = self.filter;
31ce2453c82fatagen2026-09-24 13:07 UTC1055
        filter
31ce2453c82fatagen2026-09-24 13:07 UTC1056
            .membership
96fdf90aacd6atagen2026-09-08 08:24 UTC1057
            .is_none_or(|membership| room.membership == membership)
31ce2453c82fatagen2026-09-24 13:07 UTC1058
            && filter.category.is_none_or(|category| match category {
96fdf90aacd6atagen2026-09-08 08:24 UTC1059
                RoomCategory::People => room.direct && !room.space,
96fdf90aacd6atagen2026-09-08 08:24 UTC1060
                RoomCategory::Rooms => !room.direct && !room.space,
96fdf90aacd6atagen2026-09-08 08:24 UTC1061
                RoomCategory::Spaces => room.space,
96fdf90aacd6atagen2026-09-08 08:24 UTC1062
            })
31ce2453c82fatagen2026-09-24 13:07 UTC1063
            && filter
96fdf90aacd6atagen2026-09-08 08:24 UTC1064
                .favourite
96fdf90aacd6atagen2026-09-08 08:24 UTC1065
                .is_none_or(|favourite| room.favourite == favourite)
31ce2453c82fatagen2026-09-24 13:07 UTC1066
            && (!filter.unread_only || room.unread_messages > 0 || room.unread_mentions > 0)
96fdf90aacd6atagen2026-09-08 08:24 UTC1067
            && self.search.as_ref().is_none_or(|search| {
31ce2453c82fatagen2026-09-24 13:07 UTC1068
                room.name.to_lowercase().contains(search)
31ce2453c82fatagen2026-09-24 13:07 UTC1069
                    || room.room_id.as_str().to_lowercase().contains(search)
96fdf90aacd6atagen2026-09-08 08:24 UTC1070
            })
96fdf90aacd6atagen2026-09-08 08:24 UTC1071
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC1072
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1073
96fdf90aacd6atagen2026-09-08 08:24 UTC1074
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1075
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
5a52012c9b1datagen2026-09-24 23:45 UTC1076
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1077
pub enum RoomCategory {
96fdf90aacd6atagen2026-09-08 08:24 UTC1078
    People,
96fdf90aacd6atagen2026-09-08 08:24 UTC1079
    Rooms,
96fdf90aacd6atagen2026-09-08 08:24 UTC1080
    Spaces,
96fdf90aacd6atagen2026-09-08 08:24 UTC1081
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1082
96fdf90aacd6atagen2026-09-08 08:24 UTC1083
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1084
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
5a52012c9b1datagen2026-09-24 23:45 UTC1085
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1086
pub enum MemberFilter {
96fdf90aacd6atagen2026-09-08 08:24 UTC1087
    Active,
96fdf90aacd6atagen2026-09-08 08:24 UTC1088
    Joined,
96fdf90aacd6atagen2026-09-08 08:24 UTC1089
    Invited,
5a52012c9b1datagen2026-09-24 23:45 UTC1090
    Banned,
5a52012c9b1datagen2026-09-24 23:45 UTC1091
    Left,
96fdf90aacd6atagen2026-09-08 08:24 UTC1092
    All,
96fdf90aacd6atagen2026-09-08 08:24 UTC1093
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1094
96fdf90aacd6atagen2026-09-08 08:24 UTC1095
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1096
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1097
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1098
pub enum MemberMembership {
96fdf90aacd6atagen2026-09-08 08:24 UTC1099
    Joined,
96fdf90aacd6atagen2026-09-08 08:24 UTC1100
    Invited,
96fdf90aacd6atagen2026-09-08 08:24 UTC1101
    Left,
96fdf90aacd6atagen2026-09-08 08:24 UTC1102
    Knocked,
96fdf90aacd6atagen2026-09-08 08:24 UTC1103
    Banned,
96fdf90aacd6atagen2026-09-08 08:24 UTC1104
    Custom(String),
96fdf90aacd6atagen2026-09-08 08:24 UTC1105
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1106
96fdf90aacd6atagen2026-09-08 08:24 UTC1107
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1108
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1109
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1110
pub struct MemberSummary {
96fdf90aacd6atagen2026-09-08 08:24 UTC1111
    pub user_id: OwnedUserId,
96fdf90aacd6atagen2026-09-08 08:24 UTC1112
    pub name: String,
96fdf90aacd6atagen2026-09-08 08:24 UTC1113
    pub display_name: Option<String>,
5d2974de5826atagen2026-10-08 11:29 UTC1114
    pub avatar: Option<MediaId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1115
    pub membership: MemberMembership,
96fdf90aacd6atagen2026-09-08 08:24 UTC1116
    pub own: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC1117
    pub name_ambiguous: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC1118
    pub ignored: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC1119
    pub service: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC1120
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1121
96fdf90aacd6atagen2026-09-08 08:24 UTC1122
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1123
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1124
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1125
pub struct OwnDevice {
96fdf90aacd6atagen2026-09-08 08:24 UTC1126
    pub device_id: OwnedDeviceId,
96fdf90aacd6atagen2026-09-08 08:24 UTC1127
    pub display_name: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1128
    pub last_seen_ip: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1129
    pub last_seen_timestamp_ms: Option<u64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1130
    pub current: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC1131
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1132
96fdf90aacd6atagen2026-09-08 08:24 UTC1133
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1134
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC1135
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1136
pub enum TimelineItem {
960ac0721079atagen2026-09-25 00:24 UTC1137
    Event(Box<TimelineEvent>),
96fdf90aacd6atagen2026-09-08 08:24 UTC1138
    DayDivider { timestamp_ms: u64 },
96fdf90aacd6atagen2026-09-08 08:24 UTC1139
    ReadMarker,
96fdf90aacd6atagen2026-09-08 08:24 UTC1140
    TimelineStart,
96fdf90aacd6atagen2026-09-08 08:24 UTC1141
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1142
96fdf90aacd6atagen2026-09-08 08:24 UTC1143
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1144
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1145
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1146
pub enum TimelineDiff {
96fdf90aacd6atagen2026-09-08 08:24 UTC1147
    Append { values: Vec<TimelineItem> },
96fdf90aacd6atagen2026-09-08 08:24 UTC1148
    Clear,
96fdf90aacd6atagen2026-09-08 08:24 UTC1149
    PushFront { value: TimelineItem },
96fdf90aacd6atagen2026-09-08 08:24 UTC1150
    PushBack { value: TimelineItem },
96fdf90aacd6atagen2026-09-08 08:24 UTC1151
    PopFront,
96fdf90aacd6atagen2026-09-08 08:24 UTC1152
    PopBack,
96fdf90aacd6atagen2026-09-08 08:24 UTC1153
    Insert { index: usize, value: TimelineItem },
96fdf90aacd6atagen2026-09-08 08:24 UTC1154
    Set { index: usize, value: TimelineItem },
96fdf90aacd6atagen2026-09-08 08:24 UTC1155
    Remove { index: usize },
96fdf90aacd6atagen2026-09-08 08:24 UTC1156
    Truncate { length: usize },
96fdf90aacd6atagen2026-09-08 08:24 UTC1157
    Reset { values: Vec<TimelineItem> },
96fdf90aacd6atagen2026-09-08 08:24 UTC1158
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1159
96fdf90aacd6atagen2026-09-08 08:24 UTC1160
#[derive(Clone, Copy, Debug, Eq, PartialEq, thiserror::Error)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1161
#[error("timeline diff is incompatible with the current {length}-item snapshot")]
96fdf90aacd6atagen2026-09-08 08:24 UTC1162
pub struct TimelineDiffError {
96fdf90aacd6atagen2026-09-08 08:24 UTC1163
    pub length: usize,
96fdf90aacd6atagen2026-09-08 08:24 UTC1164
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1165
96fdf90aacd6atagen2026-09-08 08:24 UTC1166
impl TimelineDiff {
96fdf90aacd6atagen2026-09-08 08:24 UTC1167
    /// Apply a diff only when its indices match the current snapshot.
96fdf90aacd6atagen2026-09-08 08:24 UTC1168
    /// On error the snapshot is unchanged; request `TimelineCommand::Resync`
96fdf90aacd6atagen2026-09-08 08:24 UTC1169
    /// and ignore further diffs until the corresponding `TimelineReset`.
d5d8097c3afdatagen2026-09-26 09:33 UTC1170
    pub fn try_apply(self, items: &mut Vector<TimelineItem>) -> Result<(), TimelineDiffError> {
96fdf90aacd6atagen2026-09-08 08:24 UTC1171
        let length = items.len();
d5d8097c3afdatagen2026-09-26 09:33 UTC1172
        if self.length_after(length).is_none() {
d5d8097c3afdatagen2026-09-26 09:33 UTC1173
            return Err(TimelineDiffError { length });
d5d8097c3afdatagen2026-09-26 09:33 UTC1174
        }
d5d8097c3afdatagen2026-09-26 09:33 UTC1175
        self.apply(items);
d5d8097c3afdatagen2026-09-26 09:33 UTC1176
        Ok(())
d5d8097c3afdatagen2026-09-26 09:33 UTC1177
    }
d5d8097c3afdatagen2026-09-26 09:33 UTC1178
d5d8097c3afdatagen2026-09-26 09:33 UTC1179
    /// a whole `TimelineChanged` or none of it. whether a diff fits depends only on the
d5d8097c3afdatagen2026-09-26 09:33 UTC1180
    /// length before it, so the batch is checked against lengths alone before anything
d5d8097c3afdatagen2026-09-26 09:33 UTC1181
    /// moves. the error carries the length the snapshot would have had at the misfit
d5d8097c3afdatagen2026-09-26 09:33 UTC1182
    pub fn try_apply_all(
d5d8097c3afdatagen2026-09-26 09:33 UTC1183
        diffs: Vec<Self>,
d5d8097c3afdatagen2026-09-26 09:33 UTC1184
        items: &mut Vector<TimelineItem>,
d5d8097c3afdatagen2026-09-26 09:33 UTC1185
    ) -> Result<(), TimelineDiffError> {
d5d8097c3afdatagen2026-09-26 09:33 UTC1186
        diffs.iter().try_fold(items.len(), |length, diff| {
d5d8097c3afdatagen2026-09-26 09:33 UTC1187
            diff.length_after(length)
d5d8097c3afdatagen2026-09-26 09:33 UTC1188
                .ok_or(TimelineDiffError { length })
d5d8097c3afdatagen2026-09-26 09:33 UTC1189
        })?;
d5d8097c3afdatagen2026-09-26 09:33 UTC1190
        for diff in diffs {
d5d8097c3afdatagen2026-09-26 09:33 UTC1191
            diff.apply(items);
d5d8097c3afdatagen2026-09-26 09:33 UTC1192
        }
d5d8097c3afdatagen2026-09-26 09:33 UTC1193
        Ok(())
d5d8097c3afdatagen2026-09-26 09:33 UTC1194
    }
d5d8097c3afdatagen2026-09-26 09:33 UTC1195
d5d8097c3afdatagen2026-09-26 09:33 UTC1196
    fn length_after(&self, length: usize) -> Option<usize> {
d5d8097c3afdatagen2026-09-26 09:33 UTC1197
        match self {
d5d8097c3afdatagen2026-09-26 09:33 UTC1198
            Self::Append { values } => Some(length + values.len()),
d5d8097c3afdatagen2026-09-26 09:33 UTC1199
            Self::Clear => Some(0),
d5d8097c3afdatagen2026-09-26 09:33 UTC1200
            Self::PushFront { .. } | Self::PushBack { .. } => Some(length + 1),
d5d8097c3afdatagen2026-09-26 09:33 UTC1201
            Self::PopFront | Self::PopBack => length.checked_sub(1),
d5d8097c3afdatagen2026-09-26 09:33 UTC1202
            Self::Insert { index, .. } => (*index <= length).then_some(length + 1),
d5d8097c3afdatagen2026-09-26 09:33 UTC1203
            Self::Set { index, .. } => (*index < length).then_some(length),
d5d8097c3afdatagen2026-09-26 09:33 UTC1204
            Self::Remove { index } => (*index < length).then(|| length - 1),
d5d8097c3afdatagen2026-09-26 09:33 UTC1205
            Self::Truncate { length: target } => (*target <= length).then_some(*target),
d5d8097c3afdatagen2026-09-26 09:33 UTC1206
            Self::Reset { values } => Some(values.len()),
d5d8097c3afdatagen2026-09-26 09:33 UTC1207
        }
d5d8097c3afdatagen2026-09-26 09:33 UTC1208
    }
d5d8097c3afdatagen2026-09-26 09:33 UTC1209
d5d8097c3afdatagen2026-09-26 09:33 UTC1210
    fn apply(self, items: &mut Vector<TimelineItem>) {
96fdf90aacd6atagen2026-09-08 08:24 UTC1211
        match self {
96fdf90aacd6atagen2026-09-08 08:24 UTC1212
            Self::Append { values } => items.extend(values),
96fdf90aacd6atagen2026-09-08 08:24 UTC1213
            Self::Clear => items.clear(),
d5d8097c3afdatagen2026-09-26 09:33 UTC1214
            Self::PushFront { value } => items.push_front(value),
d5d8097c3afdatagen2026-09-26 09:33 UTC1215
            Self::PushBack { value } => items.push_back(value),
96fdf90aacd6atagen2026-09-08 08:24 UTC1216
            Self::PopFront => {
d5d8097c3afdatagen2026-09-26 09:33 UTC1217
                items.pop_front();
96fdf90aacd6atagen2026-09-08 08:24 UTC1218
            }
96fdf90aacd6atagen2026-09-08 08:24 UTC1219
            Self::PopBack => {
d5d8097c3afdatagen2026-09-26 09:33 UTC1220
                items.pop_back();
96fdf90aacd6atagen2026-09-08 08:24 UTC1221
            }
96fdf90aacd6atagen2026-09-08 08:24 UTC1222
            Self::Insert { index, value } => items.insert(index, value),
d5d8097c3afdatagen2026-09-26 09:33 UTC1223
            Self::Set { index, value } => {
d5d8097c3afdatagen2026-09-26 09:33 UTC1224
                items.set(index, value);
d5d8097c3afdatagen2026-09-26 09:33 UTC1225
            }
96fdf90aacd6atagen2026-09-08 08:24 UTC1226
            Self::Remove { index } => {
96fdf90aacd6atagen2026-09-08 08:24 UTC1227
                items.remove(index);
96fdf90aacd6atagen2026-09-08 08:24 UTC1228
            }
96fdf90aacd6atagen2026-09-08 08:24 UTC1229
            Self::Truncate { length } => items.truncate(length),
d5d8097c3afdatagen2026-09-26 09:33 UTC1230
            Self::Reset { values } => *items = values.into_iter().collect(),
96fdf90aacd6atagen2026-09-08 08:24 UTC1231
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC1232
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC1233
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1234
96fdf90aacd6atagen2026-09-08 08:24 UTC1235
#[cfg(test)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1236
mod tests {
d5d8097c3afdatagen2026-09-26 09:33 UTC1237
    use imbl::{Vector, vector};
d5d8097c3afdatagen2026-09-26 09:33 UTC1238
96fdf90aacd6atagen2026-09-08 08:24 UTC1239
    use super::{TimelineDiff, TimelineItem};
96fdf90aacd6atagen2026-09-08 08:24 UTC1240
96fdf90aacd6atagen2026-09-08 08:24 UTC1241
    fn item(timestamp_ms: u64) -> TimelineItem {
96fdf90aacd6atagen2026-09-08 08:24 UTC1242
        TimelineItem::DayDivider { timestamp_ms }
96fdf90aacd6atagen2026-09-08 08:24 UTC1243
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC1244
96fdf90aacd6atagen2026-09-08 08:24 UTC1245
    #[test]
96fdf90aacd6atagen2026-09-08 08:24 UTC1246
    fn timeline_diff_try_apply_handles_every_variant() {
d5d8097c3afdatagen2026-09-26 09:33 UTC1247
        let mut items = vector![item(1), item(2)];
96fdf90aacd6atagen2026-09-08 08:24 UTC1248
96fdf90aacd6atagen2026-09-08 08:24 UTC1249
        TimelineDiff::Append {
96fdf90aacd6atagen2026-09-08 08:24 UTC1250
            values: vec![item(3)],
96fdf90aacd6atagen2026-09-08 08:24 UTC1251
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC1252
        .try_apply(&mut items)
96fdf90aacd6atagen2026-09-08 08:24 UTC1253
        .unwrap();
d5d8097c3afdatagen2026-09-26 09:33 UTC1254
        assert_eq!(items, vector![item(1), item(2), item(3)]);
96fdf90aacd6atagen2026-09-08 08:24 UTC1255
96fdf90aacd6atagen2026-09-08 08:24 UTC1256
        TimelineDiff::Clear.try_apply(&mut items).unwrap();
96fdf90aacd6atagen2026-09-08 08:24 UTC1257
        assert!(items.is_empty());
96fdf90aacd6atagen2026-09-08 08:24 UTC1258
96fdf90aacd6atagen2026-09-08 08:24 UTC1259
        TimelineDiff::PushFront { value: item(2) }
96fdf90aacd6atagen2026-09-08 08:24 UTC1260
            .try_apply(&mut items)
96fdf90aacd6atagen2026-09-08 08:24 UTC1261
            .unwrap();
96fdf90aacd6atagen2026-09-08 08:24 UTC1262
        TimelineDiff::PushBack { value: item(3) }
96fdf90aacd6atagen2026-09-08 08:24 UTC1263
            .try_apply(&mut items)
96fdf90aacd6atagen2026-09-08 08:24 UTC1264
            .unwrap();
d5d8097c3afdatagen2026-09-26 09:33 UTC1265
        assert_eq!(items, vector![item(2), item(3)]);
96fdf90aacd6atagen2026-09-08 08:24 UTC1266
96fdf90aacd6atagen2026-09-08 08:24 UTC1267
        TimelineDiff::PopFront.try_apply(&mut items).unwrap();
96fdf90aacd6atagen2026-09-08 08:24 UTC1268
        TimelineDiff::PopBack.try_apply(&mut items).unwrap();
96fdf90aacd6atagen2026-09-08 08:24 UTC1269
        assert!(items.is_empty());
96fdf90aacd6atagen2026-09-08 08:24 UTC1270
96fdf90aacd6atagen2026-09-08 08:24 UTC1271
        TimelineDiff::Reset {
96fdf90aacd6atagen2026-09-08 08:24 UTC1272
            values: vec![item(1), item(3)],
96fdf90aacd6atagen2026-09-08 08:24 UTC1273
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC1274
        .try_apply(&mut items)
96fdf90aacd6atagen2026-09-08 08:24 UTC1275
        .unwrap();
96fdf90aacd6atagen2026-09-08 08:24 UTC1276
        TimelineDiff::Insert {
96fdf90aacd6atagen2026-09-08 08:24 UTC1277
            index: 1,
96fdf90aacd6atagen2026-09-08 08:24 UTC1278
            value: item(2),
96fdf90aacd6atagen2026-09-08 08:24 UTC1279
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC1280
        .try_apply(&mut items)
96fdf90aacd6atagen2026-09-08 08:24 UTC1281
        .unwrap();
d5d8097c3afdatagen2026-09-26 09:33 UTC1282
        assert_eq!(items, vector![item(1), item(2), item(3)]);
96fdf90aacd6atagen2026-09-08 08:24 UTC1283
96fdf90aacd6atagen2026-09-08 08:24 UTC1284
        TimelineDiff::Set {
96fdf90aacd6atagen2026-09-08 08:24 UTC1285
            index: 1,
96fdf90aacd6atagen2026-09-08 08:24 UTC1286
            value: item(4),
96fdf90aacd6atagen2026-09-08 08:24 UTC1287
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC1288
        .try_apply(&mut items)
96fdf90aacd6atagen2026-09-08 08:24 UTC1289
        .unwrap();
d5d8097c3afdatagen2026-09-26 09:33 UTC1290
        assert_eq!(items, vector![item(1), item(4), item(3)]);
96fdf90aacd6atagen2026-09-08 08:24 UTC1291
96fdf90aacd6atagen2026-09-08 08:24 UTC1292
        TimelineDiff::Remove { index: 1 }
96fdf90aacd6atagen2026-09-08 08:24 UTC1293
            .try_apply(&mut items)
96fdf90aacd6atagen2026-09-08 08:24 UTC1294
            .unwrap();
d5d8097c3afdatagen2026-09-26 09:33 UTC1295
        assert_eq!(items, vector![item(1), item(3)]);
96fdf90aacd6atagen2026-09-08 08:24 UTC1296
96fdf90aacd6atagen2026-09-08 08:24 UTC1297
        TimelineDiff::Truncate { length: 1 }
96fdf90aacd6atagen2026-09-08 08:24 UTC1298
            .try_apply(&mut items)
96fdf90aacd6atagen2026-09-08 08:24 UTC1299
            .unwrap();
d5d8097c3afdatagen2026-09-26 09:33 UTC1300
        assert_eq!(items, vector![item(1)]);
96fdf90aacd6atagen2026-09-08 08:24 UTC1301
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC1302
96fdf90aacd6atagen2026-09-08 08:24 UTC1303
    #[test]
96fdf90aacd6atagen2026-09-08 08:24 UTC1304
    fn invalid_timeline_diff_leaves_snapshot_unchanged() {
96fdf90aacd6atagen2026-09-08 08:24 UTC1305
        let invalid = [
96fdf90aacd6atagen2026-09-08 08:24 UTC1306
            TimelineDiff::Insert {
96fdf90aacd6atagen2026-09-08 08:24 UTC1307
                index: 3,
96fdf90aacd6atagen2026-09-08 08:24 UTC1308
                value: item(3),
96fdf90aacd6atagen2026-09-08 08:24 UTC1309
            },
96fdf90aacd6atagen2026-09-08 08:24 UTC1310
            TimelineDiff::Set {
96fdf90aacd6atagen2026-09-08 08:24 UTC1311
                index: 2,
96fdf90aacd6atagen2026-09-08 08:24 UTC1312
                value: item(3),
96fdf90aacd6atagen2026-09-08 08:24 UTC1313
            },
96fdf90aacd6atagen2026-09-08 08:24 UTC1314
            TimelineDiff::Remove { index: 2 },
96fdf90aacd6atagen2026-09-08 08:24 UTC1315
            TimelineDiff::Truncate { length: 3 },
96fdf90aacd6atagen2026-09-08 08:24 UTC1316
        ];
96fdf90aacd6atagen2026-09-08 08:24 UTC1317
        for diff in invalid {
d5d8097c3afdatagen2026-09-26 09:33 UTC1318
            let mut items = vector![item(1), item(2)];
96fdf90aacd6atagen2026-09-08 08:24 UTC1319
            assert_eq!(diff.try_apply(&mut items).unwrap_err().length, 2);
d5d8097c3afdatagen2026-09-26 09:33 UTC1320
            assert_eq!(items, vector![item(1), item(2)]);
96fdf90aacd6atagen2026-09-08 08:24 UTC1321
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC1322
        for diff in [TimelineDiff::PopFront, TimelineDiff::PopBack] {
d5d8097c3afdatagen2026-09-26 09:33 UTC1323
            let mut items = Vector::new();
96fdf90aacd6atagen2026-09-08 08:24 UTC1324
            assert_eq!(diff.try_apply(&mut items).unwrap_err().length, 0);
96fdf90aacd6atagen2026-09-08 08:24 UTC1325
            assert!(items.is_empty());
96fdf90aacd6atagen2026-09-08 08:24 UTC1326
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC1327
    }
d5d8097c3afdatagen2026-09-26 09:33 UTC1328
d5d8097c3afdatagen2026-09-26 09:33 UTC1329
    #[test]
d5d8097c3afdatagen2026-09-26 09:33 UTC1330
    fn a_batch_that_goes_wrong_halfway_changes_nothing() {
d5d8097c3afdatagen2026-09-26 09:33 UTC1331
        let mut items = vector![item(1), item(2)];
d5d8097c3afdatagen2026-09-26 09:33 UTC1332
        let batch = vec![
d5d8097c3afdatagen2026-09-26 09:33 UTC1333
            TimelineDiff::PushBack { value: item(3) },
0b8ce8dc9a1catagen2026-09-26 12:30 UTC1334
            TimelineDiff::PushBack { value: item(4) },
d5d8097c3afdatagen2026-09-26 09:33 UTC1335
            TimelineDiff::Remove { index: 0 },
d5d8097c3afdatagen2026-09-26 09:33 UTC1336
            TimelineDiff::Set {
0b8ce8dc9a1catagen2026-09-26 12:30 UTC1337
                index: 3,
0b8ce8dc9a1catagen2026-09-26 12:30 UTC1338
                value: item(5),
d5d8097c3afdatagen2026-09-26 09:33 UTC1339
            },
d5d8097c3afdatagen2026-09-26 09:33 UTC1340
        ];
d5d8097c3afdatagen2026-09-26 09:33 UTC1341
        assert_eq!(
d5d8097c3afdatagen2026-09-26 09:33 UTC1342
            TimelineDiff::try_apply_all(batch, &mut items)
d5d8097c3afdatagen2026-09-26 09:33 UTC1343
                .unwrap_err()
d5d8097c3afdatagen2026-09-26 09:33 UTC1344
                .length,
0b8ce8dc9a1catagen2026-09-26 12:30 UTC1345
            3
d5d8097c3afdatagen2026-09-26 09:33 UTC1346
        );
d5d8097c3afdatagen2026-09-26 09:33 UTC1347
        assert_eq!(items, vector![item(1), item(2)]);
d5d8097c3afdatagen2026-09-26 09:33 UTC1348
d5d8097c3afdatagen2026-09-26 09:33 UTC1349
        let batch = vec![
d5d8097c3afdatagen2026-09-26 09:33 UTC1350
            TimelineDiff::PushBack { value: item(3) },
d5d8097c3afdatagen2026-09-26 09:33 UTC1351
            TimelineDiff::Remove { index: 0 },
d5d8097c3afdatagen2026-09-26 09:33 UTC1352
            TimelineDiff::Set {
d5d8097c3afdatagen2026-09-26 09:33 UTC1353
                index: 1,
d5d8097c3afdatagen2026-09-26 09:33 UTC1354
                value: item(4),
d5d8097c3afdatagen2026-09-26 09:33 UTC1355
            },
d5d8097c3afdatagen2026-09-26 09:33 UTC1356
        ];
d5d8097c3afdatagen2026-09-26 09:33 UTC1357
        TimelineDiff::try_apply_all(batch, &mut items).unwrap();
d5d8097c3afdatagen2026-09-26 09:33 UTC1358
        assert_eq!(items, vector![item(2), item(4)]);
d5d8097c3afdatagen2026-09-26 09:33 UTC1359
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC1360
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1361
96fdf90aacd6atagen2026-09-08 08:24 UTC1362
#[derive(Clone, Debug, Eq, Hash, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1363
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1364
pub struct TimelineItemId(String);
96fdf90aacd6atagen2026-09-08 08:24 UTC1365
96fdf90aacd6atagen2026-09-08 08:24 UTC1366
impl TimelineItemId {
96fdf90aacd6atagen2026-09-08 08:24 UTC1367
    pub(crate) fn new(value: String) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC1368
        Self(value)
96fdf90aacd6atagen2026-09-08 08:24 UTC1369
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC1370
96fdf90aacd6atagen2026-09-08 08:24 UTC1371
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC1372
    pub fn as_str(&self) -> &str {
96fdf90aacd6atagen2026-09-08 08:24 UTC1373
        &self.0
96fdf90aacd6atagen2026-09-08 08:24 UTC1374
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC1375
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1376
96fdf90aacd6atagen2026-09-08 08:24 UTC1377
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1378
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1379
#[non_exhaustive]
960ac0721079atagen2026-09-25 00:24 UTC1380
pub struct TimelineEvent {
96fdf90aacd6atagen2026-09-08 08:24 UTC1381
    pub item_id: TimelineItemId,
96fdf90aacd6atagen2026-09-08 08:24 UTC1382
    pub event_id: Option<OwnedEventId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1383
    pub transaction_id: Option<OwnedTransactionId>,
960ac0721079atagen2026-09-25 00:24 UTC1384
    pub sender: Sender,
96fdf90aacd6atagen2026-09-08 08:24 UTC1385
    pub timestamp_ms: u64,
96fdf90aacd6atagen2026-09-08 08:24 UTC1386
    pub own: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC1387
    pub send_state: SendState,
960ac0721079atagen2026-09-25 00:24 UTC1388
    pub content: TimelineContent,
96fdf90aacd6atagen2026-09-08 08:24 UTC1389
    pub reply_to: Option<ReplyReference>,
960ac0721079atagen2026-09-25 00:24 UTC1390
    pub thread_root: Option<OwnedEventId>,
960ac0721079atagen2026-09-25 00:24 UTC1391
    pub thread_summary: Option<ThreadSummary>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1392
    pub reactions: Vec<Reaction>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1393
    pub read_by: Vec<OwnedUserId>,
960ac0721079atagen2026-09-25 00:24 UTC1394
    pub editable: bool,
960ac0721079atagen2026-09-25 00:24 UTC1395
}
960ac0721079atagen2026-09-25 00:24 UTC1396
960ac0721079atagen2026-09-25 00:24 UTC1397
impl TimelineEvent {
960ac0721079atagen2026-09-25 00:24 UTC1398
    /// what to hand edit, redact and react. works before the server has echoed it back
960ac0721079atagen2026-09-25 00:24 UTC1399
    #[must_use]
960ac0721079atagen2026-09-25 00:24 UTC1400
    pub fn target(&self) -> Option<EventRef> {
960ac0721079atagen2026-09-25 00:24 UTC1401
        self.event_id
960ac0721079atagen2026-09-25 00:24 UTC1402
            .clone()
960ac0721079atagen2026-09-25 00:24 UTC1403
            .map(EventRef::Remote)
960ac0721079atagen2026-09-25 00:24 UTC1404
            .or_else(|| self.transaction_id.clone().map(EventRef::Local))
960ac0721079atagen2026-09-25 00:24 UTC1405
    }
960ac0721079atagen2026-09-25 00:24 UTC1406
}
960ac0721079atagen2026-09-25 00:24 UTC1407
960ac0721079atagen2026-09-25 00:24 UTC1408
#[derive(Clone, Debug, Eq, Hash, PartialEq)]
960ac0721079atagen2026-09-25 00:24 UTC1409
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
960ac0721079atagen2026-09-25 00:24 UTC1410
#[non_exhaustive]
960ac0721079atagen2026-09-25 00:24 UTC1411
pub enum EventRef {
960ac0721079atagen2026-09-25 00:24 UTC1412
    Remote(OwnedEventId),
960ac0721079atagen2026-09-25 00:24 UTC1413
    /// a local echo, by the transaction id it was queued under
960ac0721079atagen2026-09-25 00:24 UTC1414
    Local(OwnedTransactionId),
960ac0721079atagen2026-09-25 00:24 UTC1415
}
960ac0721079atagen2026-09-25 00:24 UTC1416
960ac0721079atagen2026-09-25 00:24 UTC1417
impl From<OwnedEventId> for EventRef {
960ac0721079atagen2026-09-25 00:24 UTC1418
    fn from(event_id: OwnedEventId) -> Self {
960ac0721079atagen2026-09-25 00:24 UTC1419
        Self::Remote(event_id)
960ac0721079atagen2026-09-25 00:24 UTC1420
    }
960ac0721079atagen2026-09-25 00:24 UTC1421
}
960ac0721079atagen2026-09-25 00:24 UTC1422
960ac0721079atagen2026-09-25 00:24 UTC1423
#[derive(Clone, Debug, Eq, PartialEq)]
960ac0721079atagen2026-09-25 00:24 UTC1424
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
960ac0721079atagen2026-09-25 00:24 UTC1425
#[non_exhaustive]
960ac0721079atagen2026-09-25 00:24 UTC1426
pub struct Sender {
960ac0721079atagen2026-09-25 00:24 UTC1427
    pub user_id: OwnedUserId,
960ac0721079atagen2026-09-25 00:24 UTC1428
    pub display_name: Option<String>,
5d2974de5826atagen2026-10-08 11:29 UTC1429
    pub avatar: Option<MediaId>,
960ac0721079atagen2026-09-25 00:24 UTC1430
    /// someone else in the room goes by the same name, so show the user id too
960ac0721079atagen2026-09-25 00:24 UTC1431
    pub name_ambiguous: bool,
960ac0721079atagen2026-09-25 00:24 UTC1432
}
960ac0721079atagen2026-09-25 00:24 UTC1433
960ac0721079atagen2026-09-25 00:24 UTC1434
impl Sender {
960ac0721079atagen2026-09-25 00:24 UTC1435
    #[must_use]
960ac0721079atagen2026-09-25 00:24 UTC1436
    pub fn name(&self) -> &str {
960ac0721079atagen2026-09-25 00:24 UTC1437
        self.display_name
960ac0721079atagen2026-09-25 00:24 UTC1438
            .as_deref()
960ac0721079atagen2026-09-25 00:24 UTC1439
            .unwrap_or_else(|| self.user_id.as_str())
960ac0721079atagen2026-09-25 00:24 UTC1440
    }
960ac0721079atagen2026-09-25 00:24 UTC1441
}
960ac0721079atagen2026-09-25 00:24 UTC1442
960ac0721079atagen2026-09-25 00:24 UTC1443
#[derive(Clone, Debug, Eq, PartialEq)]
960ac0721079atagen2026-09-25 00:24 UTC1444
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
960ac0721079atagen2026-09-25 00:24 UTC1445
#[non_exhaustive]
960ac0721079atagen2026-09-25 00:24 UTC1446
pub enum TimelineContent {
960ac0721079atagen2026-09-25 00:24 UTC1447
    Message(Message),
960ac0721079atagen2026-09-25 00:24 UTC1448
    Sticker {
960ac0721079atagen2026-09-25 00:24 UTC1449
        body: String,
960ac0721079atagen2026-09-25 00:24 UTC1450
        media: MediaDescriptor,
960ac0721079atagen2026-09-25 00:24 UTC1451
    },
960ac0721079atagen2026-09-25 00:24 UTC1452
    Poll {
960ac0721079atagen2026-09-25 00:24 UTC1453
        question: String,
960ac0721079atagen2026-09-25 00:24 UTC1454
    },
960ac0721079atagen2026-09-25 00:24 UTC1455
    Redacted,
960ac0721079atagen2026-09-25 00:24 UTC1456
    UnableToDecrypt(UtdCause),
960ac0721079atagen2026-09-25 00:24 UTC1457
    Membership {
960ac0721079atagen2026-09-25 00:24 UTC1458
        user_id: OwnedUserId,
960ac0721079atagen2026-09-25 00:24 UTC1459
        display_name: Option<String>,
960ac0721079atagen2026-09-25 00:24 UTC1460
        change: MembershipChange,
960ac0721079atagen2026-09-25 00:24 UTC1461
    },
960ac0721079atagen2026-09-25 00:24 UTC1462
    Profile {
960ac0721079atagen2026-09-25 00:24 UTC1463
        user_id: OwnedUserId,
960ac0721079atagen2026-09-25 00:24 UTC1464
        display_name: Option<Change<Option<String>>>,
5d2974de5826atagen2026-10-08 11:29 UTC1465
        avatar: Option<Change<Option<MediaId>>>,
960ac0721079atagen2026-09-25 00:24 UTC1466
    },
5a52012c9b1datagen2026-09-24 23:45 UTC1467
    /// `None` means it was cleared, or the event was redacted
960ac0721079atagen2026-09-25 00:24 UTC1468
    RoomName(Option<String>),
960ac0721079atagen2026-09-25 00:24 UTC1469
    RoomTopic(Option<String>),
5d2974de5826atagen2026-10-08 11:29 UTC1470
    RoomAvatar(Option<MediaId>),
960ac0721079atagen2026-09-25 00:24 UTC1471
    EncryptionEnabled,
960ac0721079atagen2026-09-25 00:24 UTC1472
    RoomCreated,
960ac0721079atagen2026-09-25 00:24 UTC1473
    RoomUpgraded {
960ac0721079atagen2026-09-25 00:24 UTC1474
        successor: OwnedRoomId,
960ac0721079atagen2026-09-25 00:24 UTC1475
    },
960ac0721079atagen2026-09-25 00:24 UTC1476
    OtherState {
960ac0721079atagen2026-09-25 00:24 UTC1477
        event_type: String,
960ac0721079atagen2026-09-25 00:24 UTC1478
        state_key: String,
960ac0721079atagen2026-09-25 00:24 UTC1479
    },
960ac0721079atagen2026-09-25 00:24 UTC1480
    Other {
960ac0721079atagen2026-09-25 00:24 UTC1481
        event_type: String,
960ac0721079atagen2026-09-25 00:24 UTC1482
    },
960ac0721079atagen2026-09-25 00:24 UTC1483
}
960ac0721079atagen2026-09-25 00:24 UTC1484
960ac0721079atagen2026-09-25 00:24 UTC1485
#[derive(Clone, Debug, Eq, PartialEq)]
960ac0721079atagen2026-09-25 00:24 UTC1486
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
960ac0721079atagen2026-09-25 00:24 UTC1487
#[non_exhaustive]
960ac0721079atagen2026-09-25 00:24 UTC1488
pub struct Message {
960ac0721079atagen2026-09-25 00:24 UTC1489
    pub kind: MessageKind,
960ac0721079atagen2026-09-25 00:24 UTC1490
    pub body: String,
5a52012c9b1datagen2026-09-24 23:45 UTC1491
    /// only for `MessageKind::Location`
5a52012c9b1datagen2026-09-24 23:45 UTC1492
    pub geo_uri: Option<String>,
960ac0721079atagen2026-09-25 00:24 UTC1493
    pub formatted_body: Option<String>,
960ac0721079atagen2026-09-25 00:24 UTC1494
    pub mentions: Option<MessageMentions>,
960ac0721079atagen2026-09-25 00:24 UTC1495
    pub edited: bool,
960ac0721079atagen2026-09-25 00:24 UTC1496
    pub media: Option<MediaDescriptor>,
960ac0721079atagen2026-09-25 00:24 UTC1497
}
960ac0721079atagen2026-09-25 00:24 UTC1498
960ac0721079atagen2026-09-25 00:24 UTC1499
#[derive(Clone, Debug, Eq, PartialEq)]
960ac0721079atagen2026-09-25 00:24 UTC1500
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
960ac0721079atagen2026-09-25 00:24 UTC1501
#[non_exhaustive]
960ac0721079atagen2026-09-25 00:24 UTC1502
pub enum MessageKind {
960ac0721079atagen2026-09-25 00:24 UTC1503
    Text,
960ac0721079atagen2026-09-25 00:24 UTC1504
    Emote,
960ac0721079atagen2026-09-25 00:24 UTC1505
    Notice,
960ac0721079atagen2026-09-25 00:24 UTC1506
    ServerNotice,
960ac0721079atagen2026-09-25 00:24 UTC1507
    Image,
960ac0721079atagen2026-09-25 00:24 UTC1508
    Video,
960ac0721079atagen2026-09-25 00:24 UTC1509
    Audio,
960ac0721079atagen2026-09-25 00:24 UTC1510
    File,
960ac0721079atagen2026-09-25 00:24 UTC1511
    Location,
960ac0721079atagen2026-09-25 00:24 UTC1512
    VerificationRequest,
960ac0721079atagen2026-09-25 00:24 UTC1513
    Other(String),
960ac0721079atagen2026-09-25 00:24 UTC1514
}
960ac0721079atagen2026-09-25 00:24 UTC1515
960ac0721079atagen2026-09-25 00:24 UTC1516
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
960ac0721079atagen2026-09-25 00:24 UTC1517
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
960ac0721079atagen2026-09-25 00:24 UTC1518
#[non_exhaustive]
960ac0721079atagen2026-09-25 00:24 UTC1519
pub enum MembershipChange {
960ac0721079atagen2026-09-25 00:24 UTC1520
    Joined,
960ac0721079atagen2026-09-25 00:24 UTC1521
    Left,
960ac0721079atagen2026-09-25 00:24 UTC1522
    Banned,
960ac0721079atagen2026-09-25 00:24 UTC1523
    Unbanned,
960ac0721079atagen2026-09-25 00:24 UTC1524
    Kicked,
960ac0721079atagen2026-09-25 00:24 UTC1525
    KickedAndBanned,
960ac0721079atagen2026-09-25 00:24 UTC1526
    Invited,
960ac0721079atagen2026-09-25 00:24 UTC1527
    InvitationAccepted,
960ac0721079atagen2026-09-25 00:24 UTC1528
    InvitationRejected,
960ac0721079atagen2026-09-25 00:24 UTC1529
    InvitationRevoked,
960ac0721079atagen2026-09-25 00:24 UTC1530
    Knocked,
960ac0721079atagen2026-09-25 00:24 UTC1531
    KnockAccepted,
960ac0721079atagen2026-09-25 00:24 UTC1532
    KnockRetracted,
960ac0721079atagen2026-09-25 00:24 UTC1533
    KnockDenied,
960ac0721079atagen2026-09-25 00:24 UTC1534
    /// nothing a person would call a change, or something the sdk couldn't make sense of
960ac0721079atagen2026-09-25 00:24 UTC1535
    Other,
960ac0721079atagen2026-09-25 00:24 UTC1536
}
960ac0721079atagen2026-09-25 00:24 UTC1537
960ac0721079atagen2026-09-25 00:24 UTC1538
#[derive(Clone, Debug, Eq, PartialEq)]
960ac0721079atagen2026-09-25 00:24 UTC1539
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
960ac0721079atagen2026-09-25 00:24 UTC1540
pub struct Change<T> {
960ac0721079atagen2026-09-25 00:24 UTC1541
    pub old: T,
960ac0721079atagen2026-09-25 00:24 UTC1542
    pub new: T,
960ac0721079atagen2026-09-25 00:24 UTC1543
}
960ac0721079atagen2026-09-25 00:24 UTC1544
960ac0721079atagen2026-09-25 00:24 UTC1545
/// why a message couldn't be read, worth telling the user since some of these they can fix
960ac0721079atagen2026-09-25 00:24 UTC1546
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
960ac0721079atagen2026-09-25 00:24 UTC1547
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
960ac0721079atagen2026-09-25 00:24 UTC1548
#[non_exhaustive]
960ac0721079atagen2026-09-25 00:24 UTC1549
pub enum UtdCause {
960ac0721079atagen2026-09-25 00:24 UTC1550
    Unknown,
960ac0721079atagen2026-09-25 00:24 UTC1551
    SentBeforeWeJoined,
960ac0721079atagen2026-09-25 00:24 UTC1552
    VerificationViolation,
960ac0721079atagen2026-09-25 00:24 UTC1553
    UnsignedDevice,
960ac0721079atagen2026-09-25 00:24 UTC1554
    UnknownDevice,
960ac0721079atagen2026-09-25 00:24 UTC1555
    HistoricalMessageAndBackupIsDisabled,
960ac0721079atagen2026-09-25 00:24 UTC1556
    WithheldForUnverifiedOrInsecureDevice,
960ac0721079atagen2026-09-25 00:24 UTC1557
    WithheldBySender,
960ac0721079atagen2026-09-25 00:24 UTC1558
    HistoricalMessageAndDeviceIsUnverified,
96fdf90aacd6atagen2026-09-08 08:24 UTC1559
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1560
96fdf90aacd6atagen2026-09-08 08:24 UTC1561
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1562
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1563
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1564
pub struct ThreadSummary {
96fdf90aacd6atagen2026-09-08 08:24 UTC1565
    pub reply_count: u32,
96fdf90aacd6atagen2026-09-08 08:24 UTC1566
    pub latest_event_id: Option<OwnedEventId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1567
    pub latest_event_timestamp_ms: Option<u64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1568
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1569
96fdf90aacd6atagen2026-09-08 08:24 UTC1570
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1571
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1572
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1573
pub enum SendState {
96fdf90aacd6atagen2026-09-08 08:24 UTC1574
    Sent,
96fdf90aacd6atagen2026-09-08 08:24 UTC1575
    Sending,
5a52012c9b1datagen2026-09-24 23:45 UTC1576
    /// `will_retry` means macltok has it in hand. otherwise it's wedged until you
5a52012c9b1datagen2026-09-24 23:45 UTC1577
    /// `retry_send` or `cancel_send`, so that's when to show a retry button
5a52012c9b1datagen2026-09-24 23:45 UTC1578
    Failed {
5a52012c9b1datagen2026-09-24 23:45 UTC1579
        will_retry: bool,
5a52012c9b1datagen2026-09-24 23:45 UTC1580
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC1581
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1582
96fdf90aacd6atagen2026-09-08 08:24 UTC1583
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1584
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC1585
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1586
pub struct ReplyReference {
96fdf90aacd6atagen2026-09-08 08:24 UTC1587
    pub event_id: OwnedEventId,
960ac0721079atagen2026-09-25 00:24 UTC1588
    pub details: ReplyDetails,
960ac0721079atagen2026-09-25 00:24 UTC1589
}
960ac0721079atagen2026-09-25 00:24 UTC1590
960ac0721079atagen2026-09-25 00:24 UTC1591
/// the replied-to event. macltok asks for it when it isn't loaded, `Pending` then turns into one of the others
960ac0721079atagen2026-09-25 00:24 UTC1592
#[derive(Clone, Debug, Eq, PartialEq)]
960ac0721079atagen2026-09-25 00:24 UTC1593
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
960ac0721079atagen2026-09-25 00:24 UTC1594
#[non_exhaustive]
960ac0721079atagen2026-09-25 00:24 UTC1595
pub enum ReplyDetails {
960ac0721079atagen2026-09-25 00:24 UTC1596
    Pending,
960ac0721079atagen2026-09-25 00:24 UTC1597
    Ready {
960ac0721079atagen2026-09-25 00:24 UTC1598
        sender: Sender,
960ac0721079atagen2026-09-25 00:24 UTC1599
        content: Box<TimelineContent>,
960ac0721079atagen2026-09-25 00:24 UTC1600
        timestamp_ms: u64,
960ac0721079atagen2026-09-25 00:24 UTC1601
    },
960ac0721079atagen2026-09-25 00:24 UTC1602
    Unavailable,
96fdf90aacd6atagen2026-09-08 08:24 UTC1603
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1604
96fdf90aacd6atagen2026-09-08 08:24 UTC1605
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1606
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1607
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1608
pub struct Reaction {
96fdf90aacd6atagen2026-09-08 08:24 UTC1609
    pub key: String,
8fa8a7cde89catagen2026-10-08 12:39 UTC1610
    /// a custom emote's shortcode, from whichever sender gave one
8fa8a7cde89catagen2026-10-08 12:39 UTC1611
    pub shortcode: Option<String>,
8fa8a7cde89catagen2026-10-08 12:39 UTC1612
    /// the custom emote itself, when the key is an image
8fa8a7cde89catagen2026-10-08 12:39 UTC1613
    pub image: Option<MediaId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1614
    pub count: usize,
96fdf90aacd6atagen2026-09-08 08:24 UTC1615
    pub own: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC1616
    pub senders: Vec<OwnedUserId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1617
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1618
17e042fbc331atagen2026-10-08 12:39 UTC1619
/// every custom emote and sticker pack the account can reach, from the user's own
17e042fbc331atagen2026-10-08 12:39 UTC1620
/// pack, each joined room's packs, and the rooms the user enabled everywhere
17e042fbc331atagen2026-10-08 12:39 UTC1621
#[derive(Clone, Debug, Default, Eq, PartialEq)]
17e042fbc331atagen2026-10-08 12:39 UTC1622
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
17e042fbc331atagen2026-10-08 12:39 UTC1623
#[non_exhaustive]
17e042fbc331atagen2026-10-08 12:39 UTC1624
pub struct ImagePacks {
17e042fbc331atagen2026-10-08 12:39 UTC1625
    /// the user's own pack, then the packs of rooms enabled everywhere
17e042fbc331atagen2026-10-08 12:39 UTC1626
    pub global: Vec<ImagePack>,
17e042fbc331atagen2026-10-08 12:39 UTC1627
    /// each joined room's own packs, rooms without any left out
17e042fbc331atagen2026-10-08 12:39 UTC1628
    pub rooms: imbl::HashMap<OwnedRoomId, Vec<ImagePack>>,
17e042fbc331atagen2026-10-08 12:39 UTC1629
}
17e042fbc331atagen2026-10-08 12:39 UTC1630
17e042fbc331atagen2026-10-08 12:39 UTC1631
impl ImagePacks {
17e042fbc331atagen2026-10-08 12:39 UTC1632
    /// what a picker in this room offers. the user's pack, the room's own, then the
17e042fbc331atagen2026-10-08 12:39 UTC1633
    /// rest of the enabled ones, each pack once
17e042fbc331atagen2026-10-08 12:39 UTC1634
    #[must_use]
17e042fbc331atagen2026-10-08 12:39 UTC1635
    pub fn for_room(&self, room_id: Option<&RoomId>) -> Vec<&ImagePack> {
17e042fbc331atagen2026-10-08 12:39 UTC1636
        let is_user = |pack: &&ImagePack| pack.source == ImagePackSource::User;
17e042fbc331atagen2026-10-08 12:39 UTC1637
        let own = room_id.and_then(|room_id| self.rooms.get(room_id));
17e042fbc331atagen2026-10-08 12:39 UTC1638
        let mut packs: Vec<&ImagePack> = self.global.iter().filter(is_user).collect();
17e042fbc331atagen2026-10-08 12:39 UTC1639
        packs.extend(own.into_iter().flatten());
17e042fbc331atagen2026-10-08 12:39 UTC1640
        for pack in self.global.iter().filter(|pack| !is_user(pack)) {
17e042fbc331atagen2026-10-08 12:39 UTC1641
            if !packs.iter().any(|seen| seen.id == pack.id) {
17e042fbc331atagen2026-10-08 12:39 UTC1642
                packs.push(pack);
17e042fbc331atagen2026-10-08 12:39 UTC1643
            }
17e042fbc331atagen2026-10-08 12:39 UTC1644
        }
17e042fbc331atagen2026-10-08 12:39 UTC1645
        packs
17e042fbc331atagen2026-10-08 12:39 UTC1646
    }
17e042fbc331atagen2026-10-08 12:39 UTC1647
}
17e042fbc331atagen2026-10-08 12:39 UTC1648
17e042fbc331atagen2026-10-08 12:39 UTC1649
#[derive(Clone, Debug, Eq, PartialEq)]
17e042fbc331atagen2026-10-08 12:39 UTC1650
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
17e042fbc331atagen2026-10-08 12:39 UTC1651
#[non_exhaustive]
17e042fbc331atagen2026-10-08 12:39 UTC1652
pub struct ImagePack {
17e042fbc331atagen2026-10-08 12:39 UTC1653
    /// `user`, or `room:<room id>:<state key>`, the same across calls
17e042fbc331atagen2026-10-08 12:39 UTC1654
    pub id: String,
17e042fbc331atagen2026-10-08 12:39 UTC1655
    pub display_name: Option<String>,
17e042fbc331atagen2026-10-08 12:39 UTC1656
    pub avatar: Option<MediaId>,
17e042fbc331atagen2026-10-08 12:39 UTC1657
    pub attribution: Option<String>,
17e042fbc331atagen2026-10-08 12:39 UTC1658
    pub source: ImagePackSource,
17e042fbc331atagen2026-10-08 12:39 UTC1659
    pub images: Vec<PackImage>,
17e042fbc331atagen2026-10-08 12:39 UTC1660
}
17e042fbc331atagen2026-10-08 12:39 UTC1661
17e042fbc331atagen2026-10-08 12:39 UTC1662
#[derive(Clone, Debug, Eq, PartialEq)]
17e042fbc331atagen2026-10-08 12:39 UTC1663
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
17e042fbc331atagen2026-10-08 12:39 UTC1664
#[non_exhaustive]
17e042fbc331atagen2026-10-08 12:39 UTC1665
pub enum ImagePackSource {
17e042fbc331atagen2026-10-08 12:39 UTC1666
    User,
17e042fbc331atagen2026-10-08 12:39 UTC1667
    Room {
17e042fbc331atagen2026-10-08 12:39 UTC1668
        room_id: OwnedRoomId,
17e042fbc331atagen2026-10-08 12:39 UTC1669
        state_key: String,
17e042fbc331atagen2026-10-08 12:39 UTC1670
    },
17e042fbc331atagen2026-10-08 12:39 UTC1671
}
17e042fbc331atagen2026-10-08 12:39 UTC1672
17e042fbc331atagen2026-10-08 12:39 UTC1673
#[derive(Clone, Debug, Eq, PartialEq)]
17e042fbc331atagen2026-10-08 12:39 UTC1674
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
17e042fbc331atagen2026-10-08 12:39 UTC1675
#[non_exhaustive]
17e042fbc331atagen2026-10-08 12:39 UTC1676
pub struct PackImage {
17e042fbc331atagen2026-10-08 12:39 UTC1677
    pub shortcode: String,
17e042fbc331atagen2026-10-08 12:39 UTC1678
    pub media_id: MediaId,
17e042fbc331atagen2026-10-08 12:39 UTC1679
    /// what `toggle_reaction` takes to react with this image
17e042fbc331atagen2026-10-08 12:39 UTC1680
    pub reaction_key: String,
17e042fbc331atagen2026-10-08 12:39 UTC1681
    pub body: Option<String>,
17e042fbc331atagen2026-10-08 12:39 UTC1682
    pub mimetype: Option<String>,
17e042fbc331atagen2026-10-08 12:39 UTC1683
    pub width: Option<u64>,
17e042fbc331atagen2026-10-08 12:39 UTC1684
    pub height: Option<u64>,
17e042fbc331atagen2026-10-08 12:39 UTC1685
    /// the image's own, else its pack's, else both
17e042fbc331atagen2026-10-08 12:39 UTC1686
    pub usage: Vec<PackUsage>,
17e042fbc331atagen2026-10-08 12:39 UTC1687
}
17e042fbc331atagen2026-10-08 12:39 UTC1688
17e042fbc331atagen2026-10-08 12:39 UTC1689
#[derive(Clone, Copy, Debug, Eq, Hash, Ord, PartialEq, PartialOrd)]
17e042fbc331atagen2026-10-08 12:39 UTC1690
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
17e042fbc331atagen2026-10-08 12:39 UTC1691
#[non_exhaustive]
17e042fbc331atagen2026-10-08 12:39 UTC1692
pub enum PackUsage {
17e042fbc331atagen2026-10-08 12:39 UTC1693
    Emoticon,
17e042fbc331atagen2026-10-08 12:39 UTC1694
    Sticker,
17e042fbc331atagen2026-10-08 12:39 UTC1695
}
17e042fbc331atagen2026-10-08 12:39 UTC1696
96fdf90aacd6atagen2026-09-08 08:24 UTC1697
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1698
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1699
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1700
pub struct MediaDescriptor {
96fdf90aacd6atagen2026-09-08 08:24 UTC1701
    pub id: MediaId,
96fdf90aacd6atagen2026-09-08 08:24 UTC1702
    pub kind: MediaKind,
96fdf90aacd6atagen2026-09-08 08:24 UTC1703
    pub filename: String,
96fdf90aacd6atagen2026-09-08 08:24 UTC1704
    pub caption: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1705
    pub mimetype: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1706
    pub size_bytes: Option<u64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1707
    pub width: Option<u64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1708
    pub height: Option<u64>,
5a52012c9b1datagen2026-09-24 23:45 UTC1709
    pub duration_ms: Option<u64>,
5a52012c9b1datagen2026-09-24 23:45 UTC1710
    pub blurhash: Option<String>,
5a52012c9b1datagen2026-09-24 23:45 UTC1711
    /// the uploader sent a thumbnail, so `MediaSize::Thumbnail` won't need the server to resize
5a52012c9b1datagen2026-09-24 23:45 UTC1712
    pub has_thumbnail: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC1713
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1714
96fdf90aacd6atagen2026-09-08 08:24 UTC1715
#[derive(Clone, Debug, Eq, Hash, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1716
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1717
pub struct MediaId(String);
96fdf90aacd6atagen2026-09-08 08:24 UTC1718
96fdf90aacd6atagen2026-09-08 08:24 UTC1719
impl MediaId {
96fdf90aacd6atagen2026-09-08 08:24 UTC1720
    pub(crate) fn new(value: String) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC1721
        Self(value)
96fdf90aacd6atagen2026-09-08 08:24 UTC1722
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC1723
5d2974de5826atagen2026-10-08 11:29 UTC1724
    /// plain media carries no keys, so it needs no registering and never expires
5d2974de5826atagen2026-10-08 11:29 UTC1725
    pub(crate) fn plain<U: AsRef<str> + ?Sized>(uri: &U) -> Self {
5d2974de5826atagen2026-10-08 11:29 UTC1726
        Self(uri.as_ref().to_owned())
5d2974de5826atagen2026-10-08 11:29 UTC1727
    }
5d2974de5826atagen2026-10-08 11:29 UTC1728
5d2974de5826atagen2026-10-08 11:29 UTC1729
    pub(crate) fn as_plain(&self) -> Option<&MxcUri> {
5d2974de5826atagen2026-10-08 11:29 UTC1730
        self.0.starts_with("mxc://").then(|| self.0.as_str().into())
5d2974de5826atagen2026-10-08 11:29 UTC1731
    }
5d2974de5826atagen2026-10-08 11:29 UTC1732
96fdf90aacd6atagen2026-09-08 08:24 UTC1733
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC1734
    pub fn as_str(&self) -> &str {
96fdf90aacd6atagen2026-09-08 08:24 UTC1735
        &self.0
96fdf90aacd6atagen2026-09-08 08:24 UTC1736
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC1737
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1738
5a52012c9b1datagen2026-09-24 23:45 UTC1739
/// media ids are opaque but they do have to survive a trip through a browser. a made up one just fails `MediaUnknown`
5a52012c9b1datagen2026-09-24 23:45 UTC1740
impl std::str::FromStr for MediaId {
5a52012c9b1datagen2026-09-24 23:45 UTC1741
    type Err = std::convert::Infallible;
5a52012c9b1datagen2026-09-24 23:45 UTC1742
5a52012c9b1datagen2026-09-24 23:45 UTC1743
    fn from_str(value: &str) -> Result<Self, Self::Err> {
5a52012c9b1datagen2026-09-24 23:45 UTC1744
        Ok(Self(value.to_owned()))
5a52012c9b1datagen2026-09-24 23:45 UTC1745
    }
5a52012c9b1datagen2026-09-24 23:45 UTC1746
}
5a52012c9b1datagen2026-09-24 23:45 UTC1747
5a52012c9b1datagen2026-09-24 23:45 UTC1748
impl From<String> for MediaId {
5a52012c9b1datagen2026-09-24 23:45 UTC1749
    fn from(value: String) -> Self {
5a52012c9b1datagen2026-09-24 23:45 UTC1750
        Self(value)
5a52012c9b1datagen2026-09-24 23:45 UTC1751
    }
5a52012c9b1datagen2026-09-24 23:45 UTC1752
}
5a52012c9b1datagen2026-09-24 23:45 UTC1753
96fdf90aacd6atagen2026-09-08 08:24 UTC1754
impl std::fmt::Display for MediaId {
96fdf90aacd6atagen2026-09-08 08:24 UTC1755
    fn fmt(&self, formatter: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
96fdf90aacd6atagen2026-09-08 08:24 UTC1756
        self.0.fmt(formatter)
96fdf90aacd6atagen2026-09-08 08:24 UTC1757
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC1758
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1759
96fdf90aacd6atagen2026-09-08 08:24 UTC1760
#[derive(Clone, Copy, Debug, Eq, Hash, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1761
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
5a52012c9b1datagen2026-09-24 23:45 UTC1762
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1763
pub enum MediaSize {
96fdf90aacd6atagen2026-09-08 08:24 UTC1764
    Full,
31ce2453c82fatagen2026-09-24 13:07 UTC1765
    /// a hint. an uploader's own thumbnail wins over the server resizing anything
31ce2453c82fatagen2026-09-24 13:07 UTC1766
    Thumbnail {
31ce2453c82fatagen2026-09-24 13:07 UTC1767
        width: u32,
31ce2453c82fatagen2026-09-24 13:07 UTC1768
        height: u32,
31ce2453c82fatagen2026-09-24 13:07 UTC1769
    },
31ce2453c82fatagen2026-09-24 13:07 UTC1770
}
31ce2453c82fatagen2026-09-24 13:07 UTC1771
31ce2453c82fatagen2026-09-24 13:07 UTC1772
#[derive(Clone, Debug, Eq, PartialEq)]
31ce2453c82fatagen2026-09-24 13:07 UTC1773
#[non_exhaustive]
31ce2453c82fatagen2026-09-24 13:07 UTC1774
pub struct Media {
31ce2453c82fatagen2026-09-24 13:07 UTC1775
    pub bytes: Arc<[u8]>,
31ce2453c82fatagen2026-09-24 13:07 UTC1776
    pub mimetype: String,
96fdf90aacd6atagen2026-09-08 08:24 UTC1777
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1778
5b21b919d1e6atagen2026-09-27 11:47 UTC1779
/// where media lives, for a host that fetches and decrypts it itself
5b21b919d1e6atagen2026-09-27 11:47 UTC1780
#[derive(Clone, Debug, Eq, PartialEq)]
5b21b919d1e6atagen2026-09-27 11:47 UTC1781
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
5b21b919d1e6atagen2026-09-27 11:47 UTC1782
#[non_exhaustive]
5b21b919d1e6atagen2026-09-27 11:47 UTC1783
pub enum MediaLocation {
5b21b919d1e6atagen2026-09-27 11:47 UTC1784
    File(MediaFile),
5b21b919d1e6atagen2026-09-27 11:47 UTC1785
    /// a resize of plaintext, so never encrypted. plenty of servers refuse some, and `media`
5b21b919d1e6atagen2026-09-27 11:47 UTC1786
    /// then fetches `fallback` instead, so should you
5b21b919d1e6atagen2026-09-27 11:47 UTC1787
    ServerThumbnail {
5b21b919d1e6atagen2026-09-27 11:47 UTC1788
        url: String,
5b21b919d1e6atagen2026-09-27 11:47 UTC1789
        fallback: MediaFile,
5b21b919d1e6atagen2026-09-27 11:47 UTC1790
    },
5b21b919d1e6atagen2026-09-27 11:47 UTC1791
    /// still in the send queue with no url yet. `media` has the bytes
5b21b919d1e6atagen2026-09-27 11:47 UTC1792
    Local,
5b21b919d1e6atagen2026-09-27 11:47 UTC1793
}
5b21b919d1e6atagen2026-09-27 11:47 UTC1794
5b21b919d1e6atagen2026-09-27 11:47 UTC1795
#[derive(Clone, Debug, Eq, PartialEq)]
5b21b919d1e6atagen2026-09-27 11:47 UTC1796
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
5b21b919d1e6atagen2026-09-27 11:47 UTC1797
#[non_exhaustive]
5b21b919d1e6atagen2026-09-27 11:47 UTC1798
pub struct MediaFile {
5b21b919d1e6atagen2026-09-27 11:47 UTC1799
    pub url: String,
5b21b919d1e6atagen2026-09-27 11:47 UTC1800
    pub mimetype: Option<String>,
5b21b919d1e6atagen2026-09-27 11:47 UTC1801
    pub declared_size: Option<u64>,
5b21b919d1e6atagen2026-09-27 11:47 UTC1802
    pub encryption: Option<AttachmentEncryption>,
5b21b919d1e6atagen2026-09-27 11:47 UTC1803
}
5b21b919d1e6atagen2026-09-27 11:47 UTC1804
5b21b919d1e6atagen2026-09-27 11:47 UTC1805
/// AES-256-CTR, the only attachment cipher matrix has
5b21b919d1e6atagen2026-09-27 11:47 UTC1806
#[derive(Clone, Debug, Eq, PartialEq)]
5b21b919d1e6atagen2026-09-27 11:47 UTC1807
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
5b21b919d1e6atagen2026-09-27 11:47 UTC1808
#[non_exhaustive]
5b21b919d1e6atagen2026-09-27 11:47 UTC1809
pub struct AttachmentEncryption {
5b21b919d1e6atagen2026-09-27 11:47 UTC1810
    /// the JWK `k`, unpadded url-safe base64
5b21b919d1e6atagen2026-09-27 11:47 UTC1811
    pub key: String,
5b21b919d1e6atagen2026-09-27 11:47 UTC1812
    /// unpadded base64, the initial counter block
5b21b919d1e6atagen2026-09-27 11:47 UTC1813
    pub iv: String,
5b21b919d1e6atagen2026-09-27 11:47 UTC1814
    /// unpadded base64 SHA-256 of the whole ciphertext, so a partial read goes unchecked
5b21b919d1e6atagen2026-09-27 11:47 UTC1815
    pub sha256: String,
5b21b919d1e6atagen2026-09-27 11:47 UTC1816
}
5b21b919d1e6atagen2026-09-27 11:47 UTC1817
96fdf90aacd6atagen2026-09-08 08:24 UTC1818
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1819
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1820
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1821
pub enum MediaKind {
96fdf90aacd6atagen2026-09-08 08:24 UTC1822
    Image,
96fdf90aacd6atagen2026-09-08 08:24 UTC1823
    Video,
96fdf90aacd6atagen2026-09-08 08:24 UTC1824
    Audio,
96fdf90aacd6atagen2026-09-08 08:24 UTC1825
    File,
96fdf90aacd6atagen2026-09-08 08:24 UTC1826
    Sticker,
96fdf90aacd6atagen2026-09-08 08:24 UTC1827
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1828
96fdf90aacd6atagen2026-09-08 08:24 UTC1829
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1830
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC1831
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1832
pub struct TypingState {
96fdf90aacd6atagen2026-09-08 08:24 UTC1833
    pub room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC1834
    pub users: Vec<OwnedUserId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1835
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1836
96fdf90aacd6atagen2026-09-08 08:24 UTC1837
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1838
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC1839
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1840
pub enum HistoryState {
96fdf90aacd6atagen2026-09-08 08:24 UTC1841
    Idle,
96fdf90aacd6atagen2026-09-08 08:24 UTC1842
    Loading,
96fdf90aacd6atagen2026-09-08 08:24 UTC1843
    StartReached,
96fdf90aacd6atagen2026-09-08 08:24 UTC1844
    Failed(String),
96fdf90aacd6atagen2026-09-08 08:24 UTC1845
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1846
96fdf90aacd6atagen2026-09-08 08:24 UTC1847
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1848
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1849
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1850
pub struct EncryptionState {
96fdf90aacd6atagen2026-09-08 08:24 UTC1851
    pub device_id: OwnedDeviceId,
96fdf90aacd6atagen2026-09-08 08:24 UTC1852
    pub device_verified: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC1853
    pub recovery: RecoveryState,
96fdf90aacd6atagen2026-09-08 08:24 UTC1854
    pub key_backup: KeyBackupState,
96fdf90aacd6atagen2026-09-08 08:24 UTC1855
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1856
96fdf90aacd6atagen2026-09-08 08:24 UTC1857
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1858
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC1859
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1860
pub enum KeyBackupState {
96fdf90aacd6atagen2026-09-08 08:24 UTC1861
    Unknown,
96fdf90aacd6atagen2026-09-08 08:24 UTC1862
    Creating,
96fdf90aacd6atagen2026-09-08 08:24 UTC1863
    Enabling,
96fdf90aacd6atagen2026-09-08 08:24 UTC1864
    Resuming,
96fdf90aacd6atagen2026-09-08 08:24 UTC1865
    Downloading,
96fdf90aacd6atagen2026-09-08 08:24 UTC1866
    Enabled,
96fdf90aacd6atagen2026-09-08 08:24 UTC1867
    Disabling,
96fdf90aacd6atagen2026-09-08 08:24 UTC1868
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1869
96fdf90aacd6atagen2026-09-08 08:24 UTC1870
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1871
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC1872
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1873
pub enum RecoveryState {
96fdf90aacd6atagen2026-09-08 08:24 UTC1874
    Unknown,
96fdf90aacd6atagen2026-09-08 08:24 UTC1875
    Disabled,
96fdf90aacd6atagen2026-09-08 08:24 UTC1876
    Incomplete,
96fdf90aacd6atagen2026-09-08 08:24 UTC1877
    Enabled,
96fdf90aacd6atagen2026-09-08 08:24 UTC1878
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1879
96fdf90aacd6atagen2026-09-08 08:24 UTC1880
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1881
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
5a52012c9b1datagen2026-09-24 23:45 UTC1882
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1883
pub enum VerificationAction {
5a52012c9b1datagen2026-09-24 23:45 UTC1884
    /// take up a request another device sent, which arrives as `VerificationState::Incoming`
5a52012c9b1datagen2026-09-24 23:45 UTC1885
    Accept,
96fdf90aacd6atagen2026-09-08 08:24 UTC1886
    Confirm,
96fdf90aacd6atagen2026-09-08 08:24 UTC1887
    Reject,
96fdf90aacd6atagen2026-09-08 08:24 UTC1888
    Cancel,
96fdf90aacd6atagen2026-09-08 08:24 UTC1889
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1890
96fdf90aacd6atagen2026-09-08 08:24 UTC1891
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1892
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1893
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1894
pub enum VerificationTarget {
96fdf90aacd6atagen2026-09-08 08:24 UTC1895
    OwnIdentity,
96fdf90aacd6atagen2026-09-08 08:24 UTC1896
    User(OwnedUserId),
96fdf90aacd6atagen2026-09-08 08:24 UTC1897
    Device {
96fdf90aacd6atagen2026-09-08 08:24 UTC1898
        user_id: OwnedUserId,
96fdf90aacd6atagen2026-09-08 08:24 UTC1899
        device_id: OwnedDeviceId,
96fdf90aacd6atagen2026-09-08 08:24 UTC1900
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC1901
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1902
96fdf90aacd6atagen2026-09-08 08:24 UTC1903
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1904
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC1905
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1906
pub enum VerificationState {
96fdf90aacd6atagen2026-09-08 08:24 UTC1907
    Waiting,
5a52012c9b1datagen2026-09-24 23:45 UTC1908
    /// someone else asked. `Accept` to go ahead, `Cancel` to turn them down
5a52012c9b1datagen2026-09-24 23:45 UTC1909
    Incoming {
5a52012c9b1datagen2026-09-24 23:45 UTC1910
        user_id: OwnedUserId,
5a52012c9b1datagen2026-09-24 23:45 UTC1911
        device_id: Option<OwnedDeviceId>,
5a52012c9b1datagen2026-09-24 23:45 UTC1912
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC1913
    Comparison {
96fdf90aacd6atagen2026-09-08 08:24 UTC1914
        emojis: Vec<(String, String)>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1915
        decimals: (u16, u16, u16),
96fdf90aacd6atagen2026-09-08 08:24 UTC1916
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC1917
    Confirmed,
96fdf90aacd6atagen2026-09-08 08:24 UTC1918
    Done,
96fdf90aacd6atagen2026-09-08 08:24 UTC1919
    Cancelled(String),
96fdf90aacd6atagen2026-09-08 08:24 UTC1920
    Failed(VerificationFailure),
96fdf90aacd6atagen2026-09-08 08:24 UTC1921
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1922
96fdf90aacd6atagen2026-09-08 08:24 UTC1923
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1924
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1925
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1926
pub enum VerificationFailure {
96fdf90aacd6atagen2026-09-08 08:24 UTC1927
    RequestAcceptance(String),
96fdf90aacd6atagen2026-09-08 08:24 UTC1928
    SasStartup(String),
96fdf90aacd6atagen2026-09-08 08:24 UTC1929
    SasAcceptance(String),
96fdf90aacd6atagen2026-09-08 08:24 UTC1930
    RequestStreamEnded,
96fdf90aacd6atagen2026-09-08 08:24 UTC1931
    SasStreamEnded,
96fdf90aacd6atagen2026-09-08 08:24 UTC1932
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1933
96fdf90aacd6atagen2026-09-08 08:24 UTC1934
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1935
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1936
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1937
pub struct EngineFailure {
96fdf90aacd6atagen2026-09-08 08:24 UTC1938
    pub kind: EngineErrorKind,
96fdf90aacd6atagen2026-09-08 08:24 UTC1939
    pub message: String,
96fdf90aacd6atagen2026-09-08 08:24 UTC1940
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1941
96fdf90aacd6atagen2026-09-08 08:24 UTC1942
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1943
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1944
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1945
pub enum EngineErrorKind {
96fdf90aacd6atagen2026-09-08 08:24 UTC1946
    EventReceiverClosed,
96fdf90aacd6atagen2026-09-08 08:24 UTC1947
    Watcher,
96fdf90aacd6atagen2026-09-08 08:24 UTC1948
    Other,
96fdf90aacd6atagen2026-09-08 08:24 UTC1949
}