atagen

macltok

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

Blame: src/model.rs

e5c6427adb35atagen2026-10-25 10:23 UTC1
use std::{collections::BTreeMap, 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),
89bc9f8d246datagen2026-10-24 13:40 UTC26
    EventContext(EventContextCommand),
cbb715e11963atagen2026-10-24 23:24 UTC27
    Mentions(crate::MentionsCommand),
c9effeac326aatagen2026-10-25 10:32 UTC28
    Search(crate::SearchCommand),
96fdf90aacd6atagen2026-09-08 08:24 UTC29
    Media(MediaCommand),
96fdf90aacd6atagen2026-09-08 08:24 UTC30
    Encryption(EncryptionCommand),
96fdf90aacd6atagen2026-09-08 08:24 UTC31
    Notification(NotificationCommand),
96fdf90aacd6atagen2026-09-08 08:24 UTC32
    Lifecycle(LifecycleCommand),
fa51490b6ae9atagen2026-10-24 08:41 UTC33
    Pack(PackCommand),
80381e06a573atagen2026-10-25 03:02 UTC34
    HistoryRepair(crate::HistoryRepairCommand),
66db1b3cd895atagen2026-10-25 10:28 UTC35
    ThreadList(ThreadListCommand),
96fdf90aacd6atagen2026-09-08 08:24 UTC36
}
96fdf90aacd6atagen2026-09-08 08:24 UTC37
89bc9f8d246datagen2026-10-24 13:40 UTC38
#[derive(Clone, Debug, Eq, PartialEq)]
89bc9f8d246datagen2026-10-24 13:40 UTC39
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
89bc9f8d246datagen2026-10-24 13:40 UTC40
#[non_exhaustive]
89bc9f8d246datagen2026-10-24 13:40 UTC41
pub enum EventContextCommand {
da8896938cf0atagen2026-10-25 10:04 UTC42
    /// opens a session that owns the media of everything it hands out. at most 32 stay
1f875b103b27atagen2026-10-25 10:44 UTC43
    /// open, opening another closes the oldest, and leaving the room closes its sessions,
1f875b103b27atagen2026-10-25 10:44 UTC44
    /// both told with `Event::EventContextClosed`
89bc9f8d246datagen2026-10-24 13:40 UTC45
    Fetch {
89bc9f8d246datagen2026-10-24 13:40 UTC46
        room_id: OwnedRoomId,
89bc9f8d246datagen2026-10-24 13:40 UTC47
        event_id: OwnedEventId,
89bc9f8d246datagen2026-10-24 13:40 UTC48
        before_limit: u16,
89bc9f8d246datagen2026-10-24 13:40 UTC49
        after_limit: u16,
89bc9f8d246datagen2026-10-24 13:40 UTC50
    },
89bc9f8d246datagen2026-10-24 13:40 UTC51
    Before {
da8896938cf0atagen2026-10-25 10:04 UTC52
        context_id: String,
89bc9f8d246datagen2026-10-24 13:40 UTC53
        limit: u16,
89bc9f8d246datagen2026-10-24 13:40 UTC54
        token: String,
89bc9f8d246datagen2026-10-24 13:40 UTC55
    },
89bc9f8d246datagen2026-10-24 13:40 UTC56
    After {
da8896938cf0atagen2026-10-25 10:04 UTC57
        context_id: String,
89bc9f8d246datagen2026-10-24 13:40 UTC58
        limit: u16,
89bc9f8d246datagen2026-10-24 13:40 UTC59
        token: String,
89bc9f8d246datagen2026-10-24 13:40 UTC60
    },
da8896938cf0atagen2026-10-25 10:04 UTC61
    /// frees the session's media. its rows' media ids stop resolving
da8896938cf0atagen2026-10-25 10:04 UTC62
    Close { context_id: String },
89bc9f8d246datagen2026-10-24 13:40 UTC63
}
89bc9f8d246datagen2026-10-24 13:40 UTC64
31ce2453c82fatagen2026-09-24 13:07 UTC65
#[derive(Debug)]
96fdf90aacd6atagen2026-09-08 08:24 UTC66
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC67
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC68
pub enum AccountCommand {
2006a11ce142atagen2026-10-26 04:02 UTC69
    /// removes `remove_pushers` first, best effort, while the token still works. pushers belong
2006a11ce142atagen2026-10-26 04:02 UTC70
    /// to the user rather than the device, so only the caller knows which are this browser's
2006a11ce142atagen2026-10-26 04:02 UTC71
    Logout {
2006a11ce142atagen2026-10-26 04:02 UTC72
        remove_pushers: Vec<PusherKey>,
2006a11ce142atagen2026-10-26 04:02 UTC73
    },
31ce2453c82fatagen2026-09-24 13:07 UTC74
    SetAccountData {
31ce2453c82fatagen2026-09-24 13:07 UTC75
        event_type: GlobalAccountDataEventType,
31ce2453c82fatagen2026-09-24 13:07 UTC76
        content: Raw<AnyGlobalAccountDataEventContent>,
31ce2453c82fatagen2026-09-24 13:07 UTC77
    },
31ce2453c82fatagen2026-09-24 13:07 UTC78
    SetDisplayName(Option<String>),
31ce2453c82fatagen2026-09-24 13:07 UTC79
    SetAvatar(Option<OwnedMxcUri>),
31ce2453c82fatagen2026-09-24 13:07 UTC80
    /// uploads the image and points the profile at it, same byte cap as any upload
31ce2453c82fatagen2026-09-24 13:07 UTC81
    UploadAvatar {
31ce2453c82fatagen2026-09-24 13:07 UTC82
        mimetype: String,
31ce2453c82fatagen2026-09-24 13:07 UTC83
        bytes: Vec<u8>,
31ce2453c82fatagen2026-09-24 13:07 UTC84
    },
9bd34e25bb86atagen2026-10-24 07:23 UTC85
    /// unencrypted, answers with `CommandOutput::Mxc`. same byte cap as any upload
9bd34e25bb86atagen2026-10-24 07:23 UTC86
    UploadMedia {
9bd34e25bb86atagen2026-10-24 07:23 UTC87
        mimetype: String,
9bd34e25bb86atagen2026-10-24 07:23 UTC88
        bytes: Vec<u8>,
9bd34e25bb86atagen2026-10-24 07:23 UTC89
    },
9bd34e25bb86atagen2026-10-24 07:23 UTC90
    IgnoreUser(OwnedUserId),
9bd34e25bb86atagen2026-10-24 07:23 UTC91
    UnignoreUser(OwnedUserId),
9bd34e25bb86atagen2026-10-24 07:23 UTC92
    /// writes msc3230 orders so these spaces sort in exactly this sequence, touching as few as it can
9bd34e25bb86atagen2026-10-24 07:23 UTC93
    ReorderSpaces(Vec<OwnedRoomId>),
96fdf90aacd6atagen2026-09-08 08:24 UTC94
    RenameDevice {
96fdf90aacd6atagen2026-09-08 08:24 UTC95
        device_id: OwnedDeviceId,
96fdf90aacd6atagen2026-09-08 08:24 UTC96
        display_name: String,
96fdf90aacd6atagen2026-09-08 08:24 UTC97
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC98
    DeleteDevices {
96fdf90aacd6atagen2026-09-08 08:24 UTC99
        device_ids: Vec<OwnedDeviceId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC100
        auth: Option<crate::InteractiveAuth>,
96fdf90aacd6atagen2026-09-08 08:24 UTC101
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC102
}
96fdf90aacd6atagen2026-09-08 08:24 UTC103
31ce2453c82fatagen2026-09-24 13:07 UTC104
#[derive(Clone, Debug)]
96fdf90aacd6atagen2026-09-08 08:24 UTC105
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC106
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC107
pub enum RoomCommand {
31ce2453c82fatagen2026-09-24 13:07 UTC108
    /// the snapshot turns up as `Event::TimelineReset`. opening an open room sends a fresh one
96fdf90aacd6atagen2026-09-08 08:24 UTC109
    Open(OwnedRoomId),
96fdf90aacd6atagen2026-09-08 08:24 UTC110
    Close(OwnedRoomId),
96fdf90aacd6atagen2026-09-08 08:24 UTC111
    Join {
96fdf90aacd6atagen2026-09-08 08:24 UTC112
        room: OwnedRoomOrAliasId,
96fdf90aacd6atagen2026-09-08 08:24 UTC113
        via: Vec<OwnedServerName>,
96fdf90aacd6atagen2026-09-08 08:24 UTC114
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC115
    Leave(OwnedRoomId),
96fdf90aacd6atagen2026-09-08 08:24 UTC116
    Forget(OwnedRoomId),
96fdf90aacd6atagen2026-09-08 08:24 UTC117
    AcceptInvite(OwnedRoomId),
96fdf90aacd6atagen2026-09-08 08:24 UTC118
    RejectInvite(OwnedRoomId),
96fdf90aacd6atagen2026-09-08 08:24 UTC119
    InviteUser {
96fdf90aacd6atagen2026-09-08 08:24 UTC120
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC121
        user_id: OwnedUserId,
96fdf90aacd6atagen2026-09-08 08:24 UTC122
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC123
    KickUser {
96fdf90aacd6atagen2026-09-08 08:24 UTC124
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC125
        user_id: OwnedUserId,
96fdf90aacd6atagen2026-09-08 08:24 UTC126
        reason: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC127
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC128
    BanUser {
96fdf90aacd6atagen2026-09-08 08:24 UTC129
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC130
        user_id: OwnedUserId,
96fdf90aacd6atagen2026-09-08 08:24 UTC131
        reason: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC132
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC133
    UnbanUser {
96fdf90aacd6atagen2026-09-08 08:24 UTC134
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC135
        user_id: OwnedUserId,
96fdf90aacd6atagen2026-09-08 08:24 UTC136
        reason: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC137
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC138
    SetPowerLevels {
96fdf90aacd6atagen2026-09-08 08:24 UTC139
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC140
        changes: PowerLevelChanges,
96fdf90aacd6atagen2026-09-08 08:24 UTC141
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC142
    SetUserPowerLevel {
96fdf90aacd6atagen2026-09-08 08:24 UTC143
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC144
        user_id: OwnedUserId,
96fdf90aacd6atagen2026-09-08 08:24 UTC145
        level: i64,
96fdf90aacd6atagen2026-09-08 08:24 UTC146
    },
9bd34e25bb86atagen2026-10-24 07:23 UTC147
    /// muting drops them below what sending a message takes, unmuting puts a muted user back
9bd34e25bb86atagen2026-10-24 07:23 UTC148
    /// at users_default and leaves anyone else alone
9bd34e25bb86atagen2026-10-24 07:23 UTC149
    MuteUser {
9bd34e25bb86atagen2026-10-24 07:23 UTC150
        room_id: OwnedRoomId,
9bd34e25bb86atagen2026-10-24 07:23 UTC151
        user_id: OwnedUserId,
9bd34e25bb86atagen2026-10-24 07:23 UTC152
        muted: bool,
9bd34e25bb86atagen2026-10-24 07:23 UTC153
    },
fa5b4e09943aatagen2026-10-24 09:33 UTC154
    /// pinning appends, so the newest pin is last like everywhere else
fa5b4e09943aatagen2026-10-24 09:33 UTC155
    SetPinned {
fa5b4e09943aatagen2026-10-24 09:33 UTC156
        room_id: OwnedRoomId,
fa5b4e09943aatagen2026-10-24 09:33 UTC157
        event_id: OwnedEventId,
fa5b4e09943aatagen2026-10-24 09:33 UTC158
        pinned: bool,
fa5b4e09943aatagen2026-10-24 09:33 UTC159
    },
9bd34e25bb86atagen2026-10-24 07:23 UTC160
    /// adding m.favourite drops m.lowpriority, the way Element does
9bd34e25bb86atagen2026-10-24 07:23 UTC161
    SetFavourite {
9bd34e25bb86atagen2026-10-24 07:23 UTC162
        room_id: OwnedRoomId,
9bd34e25bb86atagen2026-10-24 07:23 UTC163
        favourite: bool,
9bd34e25bb86atagen2026-10-24 07:23 UTC164
    },
9bd34e25bb86atagen2026-10-24 07:23 UTC165
    /// your name in one room. None goes back to your global name
9bd34e25bb86atagen2026-10-24 07:23 UTC166
    SetOwnDisplayName {
9bd34e25bb86atagen2026-10-24 07:23 UTC167
        room_id: OwnedRoomId,
9bd34e25bb86atagen2026-10-24 07:23 UTC168
        name: Option<String>,
9bd34e25bb86atagen2026-10-24 07:23 UTC169
    },
9bd34e25bb86atagen2026-10-24 07:23 UTC170
    /// your avatar in one room. None goes back to your global avatar
9bd34e25bb86atagen2026-10-24 07:23 UTC171
    SetOwnAvatar {
9bd34e25bb86atagen2026-10-24 07:23 UTC172
        room_id: OwnedRoomId,
9bd34e25bb86atagen2026-10-24 07:23 UTC173
        avatar: Option<OwnedMxcUri>,
9bd34e25bb86atagen2026-10-24 07:23 UTC174
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC175
    Create(CreateRoomOptions),
fa9114fcf75fatagen2026-09-24 12:51 UTC176
    /// hands back the existing dm if there is one
96fdf90aacd6atagen2026-09-08 08:24 UTC177
    CreateDirect(OwnedUserId),
96fdf90aacd6atagen2026-09-08 08:24 UTC178
    CancelSend {
96fdf90aacd6atagen2026-09-08 08:24 UTC179
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC180
        transaction_id: OwnedTransactionId,
96fdf90aacd6atagen2026-09-08 08:24 UTC181
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC182
    RetrySend {
96fdf90aacd6atagen2026-09-08 08:24 UTC183
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC184
        transaction_id: OwnedTransactionId,
96fdf90aacd6atagen2026-09-08 08:24 UTC185
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC186
    SetTyping {
96fdf90aacd6atagen2026-09-08 08:24 UTC187
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC188
        typing: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC189
    },
38c4caecdb3datagen2026-09-26 13:35 UTC190
    /// the key work a send into an encrypted room would otherwise start with, done now.
38c4caecdb3datagen2026-09-26 13:35 UTC191
    /// nothing in a plain room, and a second ask joins the first
38c4caecdb3datagen2026-09-26 13:35 UTC192
    PrepareToSend(OwnedRoomId),
31ce2453c82fatagen2026-09-24 13:07 UTC193
    SetAccountData {
31ce2453c82fatagen2026-09-24 13:07 UTC194
        room_id: OwnedRoomId,
31ce2453c82fatagen2026-09-24 13:07 UTC195
        event_type: RoomAccountDataEventType,
31ce2453c82fatagen2026-09-24 13:07 UTC196
        content: Raw<AnyRoomAccountDataEventContent>,
31ce2453c82fatagen2026-09-24 13:07 UTC197
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC198
}
96fdf90aacd6atagen2026-09-08 08:24 UTC199
96fdf90aacd6atagen2026-09-08 08:24 UTC200
#[derive(Clone, Debug, Default, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC201
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC202
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC203
pub struct CreateRoomOptions {
96fdf90aacd6atagen2026-09-08 08:24 UTC204
    pub name: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC205
    pub topic: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC206
    pub alias_localpart: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC207
    pub invite: Vec<OwnedUserId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC208
    pub direct: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC209
    pub visibility: RoomVisibility,
96fdf90aacd6atagen2026-09-08 08:24 UTC210
    pub preset: Option<RoomPreset>,
96fdf90aacd6atagen2026-09-08 08:24 UTC211
}
96fdf90aacd6atagen2026-09-08 08:24 UTC212
31ce2453c82fatagen2026-09-24 13:07 UTC213
impl CreateRoomOptions {
31ce2453c82fatagen2026-09-24 13:07 UTC214
    #[must_use]
31ce2453c82fatagen2026-09-24 13:07 UTC215
    pub fn with_name(mut self, name: impl Into<String>) -> Self {
31ce2453c82fatagen2026-09-24 13:07 UTC216
        self.name = Some(name.into());
31ce2453c82fatagen2026-09-24 13:07 UTC217
        self
31ce2453c82fatagen2026-09-24 13:07 UTC218
    }
31ce2453c82fatagen2026-09-24 13:07 UTC219
31ce2453c82fatagen2026-09-24 13:07 UTC220
    #[must_use]
31ce2453c82fatagen2026-09-24 13:07 UTC221
    pub fn with_topic(mut self, topic: impl Into<String>) -> Self {
31ce2453c82fatagen2026-09-24 13:07 UTC222
        self.topic = Some(topic.into());
31ce2453c82fatagen2026-09-24 13:07 UTC223
        self
31ce2453c82fatagen2026-09-24 13:07 UTC224
    }
31ce2453c82fatagen2026-09-24 13:07 UTC225
31ce2453c82fatagen2026-09-24 13:07 UTC226
    #[must_use]
31ce2453c82fatagen2026-09-24 13:07 UTC227
    pub fn with_alias_localpart(mut self, localpart: impl Into<String>) -> Self {
31ce2453c82fatagen2026-09-24 13:07 UTC228
        self.alias_localpart = Some(localpart.into());
31ce2453c82fatagen2026-09-24 13:07 UTC229
        self
31ce2453c82fatagen2026-09-24 13:07 UTC230
    }
31ce2453c82fatagen2026-09-24 13:07 UTC231
31ce2453c82fatagen2026-09-24 13:07 UTC232
    #[must_use]
31ce2453c82fatagen2026-09-24 13:07 UTC233
    pub fn with_invite(mut self, invite: impl IntoIterator<Item = OwnedUserId>) -> Self {
31ce2453c82fatagen2026-09-24 13:07 UTC234
        self.invite = invite.into_iter().collect();
31ce2453c82fatagen2026-09-24 13:07 UTC235
        self
31ce2453c82fatagen2026-09-24 13:07 UTC236
    }
31ce2453c82fatagen2026-09-24 13:07 UTC237
31ce2453c82fatagen2026-09-24 13:07 UTC238
    #[must_use]
31ce2453c82fatagen2026-09-24 13:07 UTC239
    pub const fn with_direct(mut self, direct: bool) -> Self {
31ce2453c82fatagen2026-09-24 13:07 UTC240
        self.direct = direct;
31ce2453c82fatagen2026-09-24 13:07 UTC241
        self
31ce2453c82fatagen2026-09-24 13:07 UTC242
    }
31ce2453c82fatagen2026-09-24 13:07 UTC243
31ce2453c82fatagen2026-09-24 13:07 UTC244
    #[must_use]
31ce2453c82fatagen2026-09-24 13:07 UTC245
    pub const fn with_visibility(mut self, visibility: RoomVisibility) -> Self {
31ce2453c82fatagen2026-09-24 13:07 UTC246
        self.visibility = visibility;
31ce2453c82fatagen2026-09-24 13:07 UTC247
        self
31ce2453c82fatagen2026-09-24 13:07 UTC248
    }
31ce2453c82fatagen2026-09-24 13:07 UTC249
31ce2453c82fatagen2026-09-24 13:07 UTC250
    #[must_use]
31ce2453c82fatagen2026-09-24 13:07 UTC251
    pub const fn with_preset(mut self, preset: RoomPreset) -> Self {
31ce2453c82fatagen2026-09-24 13:07 UTC252
        self.preset = Some(preset);
31ce2453c82fatagen2026-09-24 13:07 UTC253
        self
31ce2453c82fatagen2026-09-24 13:07 UTC254
    }
31ce2453c82fatagen2026-09-24 13:07 UTC255
}
31ce2453c82fatagen2026-09-24 13:07 UTC256
96fdf90aacd6atagen2026-09-08 08:24 UTC257
#[derive(Clone, Copy, Debug, Default, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC258
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC259
pub enum RoomVisibility {
96fdf90aacd6atagen2026-09-08 08:24 UTC260
    #[default]
96fdf90aacd6atagen2026-09-08 08:24 UTC261
    Private,
96fdf90aacd6atagen2026-09-08 08:24 UTC262
    Public,
96fdf90aacd6atagen2026-09-08 08:24 UTC263
}
96fdf90aacd6atagen2026-09-08 08:24 UTC264
96fdf90aacd6atagen2026-09-08 08:24 UTC265
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC266
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC267
pub enum RoomPreset {
96fdf90aacd6atagen2026-09-08 08:24 UTC268
    PrivateChat,
96fdf90aacd6atagen2026-09-08 08:24 UTC269
    TrustedPrivateChat,
96fdf90aacd6atagen2026-09-08 08:24 UTC270
    PublicChat,
96fdf90aacd6atagen2026-09-08 08:24 UTC271
}
96fdf90aacd6atagen2026-09-08 08:24 UTC272
96fdf90aacd6atagen2026-09-08 08:24 UTC273
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC274
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC275
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC276
pub enum TimelineCommand {
96fdf90aacd6atagen2026-09-08 08:24 UTC277
    OpenThread {
96fdf90aacd6atagen2026-09-08 08:24 UTC278
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC279
        root_event_id: OwnedEventId,
96fdf90aacd6atagen2026-09-08 08:24 UTC280
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC281
    CloseThread {
96fdf90aacd6atagen2026-09-08 08:24 UTC282
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC283
        root_event_id: OwnedEventId,
96fdf90aacd6atagen2026-09-08 08:24 UTC284
    },
fa5b4e09943aatagen2026-10-24 09:33 UTC285
    /// the room's pinned events as a timeline of their own, kept current as pins change.
fa5b4e09943aatagen2026-10-24 09:33 UTC286
    /// it can't send or paginate, the pins are all it holds
fa5b4e09943aatagen2026-10-24 09:33 UTC287
    OpenPinned(OwnedRoomId),
fa5b4e09943aatagen2026-10-24 09:33 UTC288
    ClosePinned(OwnedRoomId),
96fdf90aacd6atagen2026-09-08 08:24 UTC289
    /// Re-emit an authoritative reset for an open room or thread without
96fdf90aacd6atagen2026-09-08 08:24 UTC290
    /// closing it. The reset arrives before this command's terminal result.
96fdf90aacd6atagen2026-09-08 08:24 UTC291
    Resync {
96fdf90aacd6atagen2026-09-08 08:24 UTC292
        timeline_id: TimelineId,
96fdf90aacd6atagen2026-09-08 08:24 UTC293
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC294
    Paginate {
96fdf90aacd6atagen2026-09-08 08:24 UTC295
        timeline_id: TimelineId,
96fdf90aacd6atagen2026-09-08 08:24 UTC296
        limit: u16,
96fdf90aacd6atagen2026-09-08 08:24 UTC297
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC298
    Send {
96fdf90aacd6atagen2026-09-08 08:24 UTC299
        timeline_id: TimelineId,
96fdf90aacd6atagen2026-09-08 08:24 UTC300
        content: MessageContent,
96fdf90aacd6atagen2026-09-08 08:24 UTC301
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC302
    Edit {
96fdf90aacd6atagen2026-09-08 08:24 UTC303
        timeline_id: TimelineId,
960ac0721079atagen2026-09-25 00:24 UTC304
        target: EventRef,
96fdf90aacd6atagen2026-09-08 08:24 UTC305
        content: MessageEditContent,
96fdf90aacd6atagen2026-09-08 08:24 UTC306
    },
960ac0721079atagen2026-09-25 00:24 UTC307
    /// redacting your own unsent message just cancels it
96fdf90aacd6atagen2026-09-08 08:24 UTC308
    Redact {
96fdf90aacd6atagen2026-09-08 08:24 UTC309
        timeline_id: TimelineId,
960ac0721079atagen2026-09-25 00:24 UTC310
        target: EventRef,
96fdf90aacd6atagen2026-09-08 08:24 UTC311
        reason: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC312
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC313
    ToggleReaction {
96fdf90aacd6atagen2026-09-08 08:24 UTC314
        timeline_id: TimelineId,
960ac0721079atagen2026-09-25 00:24 UTC315
        target: EventRef,
96fdf90aacd6atagen2026-09-08 08:24 UTC316
        key: String,
8fa8a7cde89catagen2026-10-08 12:39 UTC317
        /// a custom emote's shortcode, sent along so clients without the pack can label it
8fa8a7cde89catagen2026-10-08 12:39 UTC318
        shortcode: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC319
    },
fa9114fcf75fatagen2026-09-24 12:51 UTC320
    /// works on a closed room too, it just can't refuse to move the marker backwards
fa9114fcf75fatagen2026-09-24 12:51 UTC321
    MarkRead {
fa9114fcf75fatagen2026-09-24 12:51 UTC322
        timeline_id: TimelineId,
fa9114fcf75fatagen2026-09-24 12:51 UTC323
        event_id: OwnedEventId,
fa9114fcf75fatagen2026-09-24 12:51 UTC324
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC325
}
96fdf90aacd6atagen2026-09-08 08:24 UTC326
96fdf90aacd6atagen2026-09-08 08:24 UTC327
impl TimelineCommand {
96fdf90aacd6atagen2026-09-08 08:24 UTC328
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC329
    pub const fn room_id(&self) -> &OwnedRoomId {
96fdf90aacd6atagen2026-09-08 08:24 UTC330
        match self {
fa5b4e09943aatagen2026-10-24 09:33 UTC331
            Self::OpenThread { room_id, .. }
fa5b4e09943aatagen2026-10-24 09:33 UTC332
            | Self::CloseThread { room_id, .. }
fa5b4e09943aatagen2026-10-24 09:33 UTC333
            | Self::OpenPinned(room_id)
fa5b4e09943aatagen2026-10-24 09:33 UTC334
            | Self::ClosePinned(room_id) => room_id,
96fdf90aacd6atagen2026-09-08 08:24 UTC335
            Self::Resync { timeline_id }
96fdf90aacd6atagen2026-09-08 08:24 UTC336
            | Self::Paginate { timeline_id, .. }
96fdf90aacd6atagen2026-09-08 08:24 UTC337
            | Self::Send { timeline_id, .. }
96fdf90aacd6atagen2026-09-08 08:24 UTC338
            | Self::Edit { timeline_id, .. }
96fdf90aacd6atagen2026-09-08 08:24 UTC339
            | Self::Redact { timeline_id, .. }
fa9114fcf75fatagen2026-09-24 12:51 UTC340
            | Self::ToggleReaction { timeline_id, .. }
fa9114fcf75fatagen2026-09-24 12:51 UTC341
            | Self::MarkRead { timeline_id, .. } => timeline_id.room_id(),
96fdf90aacd6atagen2026-09-08 08:24 UTC342
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC343
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC344
96fdf90aacd6atagen2026-09-08 08:24 UTC345
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC346
    pub const fn timeline_id(&self) -> Option<&TimelineId> {
96fdf90aacd6atagen2026-09-08 08:24 UTC347
        match self {
fa5b4e09943aatagen2026-10-24 09:33 UTC348
            Self::OpenThread { .. }
fa5b4e09943aatagen2026-10-24 09:33 UTC349
            | Self::CloseThread { .. }
fa5b4e09943aatagen2026-10-24 09:33 UTC350
            | Self::OpenPinned(_)
fa5b4e09943aatagen2026-10-24 09:33 UTC351
            | Self::ClosePinned(_) => None,
96fdf90aacd6atagen2026-09-08 08:24 UTC352
            Self::Resync { timeline_id }
96fdf90aacd6atagen2026-09-08 08:24 UTC353
            | Self::Paginate { timeline_id, .. }
96fdf90aacd6atagen2026-09-08 08:24 UTC354
            | Self::Send { timeline_id, .. }
96fdf90aacd6atagen2026-09-08 08:24 UTC355
            | Self::Edit { timeline_id, .. }
96fdf90aacd6atagen2026-09-08 08:24 UTC356
            | Self::Redact { timeline_id, .. }
fa9114fcf75fatagen2026-09-24 12:51 UTC357
            | Self::ToggleReaction { timeline_id, .. }
fa9114fcf75fatagen2026-09-24 12:51 UTC358
            | Self::MarkRead { timeline_id, .. } => Some(timeline_id),
96fdf90aacd6atagen2026-09-08 08:24 UTC359
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC360
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC361
}
96fdf90aacd6atagen2026-09-08 08:24 UTC362
96fdf90aacd6atagen2026-09-08 08:24 UTC363
#[derive(Clone, Debug, Eq, Hash, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC364
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC365
pub enum TimelineId {
96fdf90aacd6atagen2026-09-08 08:24 UTC366
    Room(OwnedRoomId),
96fdf90aacd6atagen2026-09-08 08:24 UTC367
    Thread {
96fdf90aacd6atagen2026-09-08 08:24 UTC368
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC369
        root_event_id: OwnedEventId,
96fdf90aacd6atagen2026-09-08 08:24 UTC370
    },
fa5b4e09943aatagen2026-10-24 09:33 UTC371
    Pinned(OwnedRoomId),
96fdf90aacd6atagen2026-09-08 08:24 UTC372
}
96fdf90aacd6atagen2026-09-08 08:24 UTC373
96fdf90aacd6atagen2026-09-08 08:24 UTC374
impl TimelineId {
96fdf90aacd6atagen2026-09-08 08:24 UTC375
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC376
    pub const fn room_id(&self) -> &OwnedRoomId {
96fdf90aacd6atagen2026-09-08 08:24 UTC377
        match self {
fa5b4e09943aatagen2026-10-24 09:33 UTC378
            Self::Room(room_id) | Self::Thread { room_id, .. } | Self::Pinned(room_id) => room_id,
96fdf90aacd6atagen2026-09-08 08:24 UTC379
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC380
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC381
96fdf90aacd6atagen2026-09-08 08:24 UTC382
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC383
    pub fn thread(room_id: OwnedRoomId, root_event_id: OwnedEventId) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC384
        Self::Thread {
96fdf90aacd6atagen2026-09-08 08:24 UTC385
            room_id,
96fdf90aacd6atagen2026-09-08 08:24 UTC386
            root_event_id,
96fdf90aacd6atagen2026-09-08 08:24 UTC387
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC388
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC389
96fdf90aacd6atagen2026-09-08 08:24 UTC390
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC391
    pub fn thread_root(&self) -> Option<&OwnedEventId> {
96fdf90aacd6atagen2026-09-08 08:24 UTC392
        match self {
fa5b4e09943aatagen2026-10-24 09:33 UTC393
            Self::Room(_) | Self::Pinned(_) => None,
96fdf90aacd6atagen2026-09-08 08:24 UTC394
            Self::Thread { root_event_id, .. } => Some(root_event_id),
96fdf90aacd6atagen2026-09-08 08:24 UTC395
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC396
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC397
}
96fdf90aacd6atagen2026-09-08 08:24 UTC398
96fdf90aacd6atagen2026-09-08 08:24 UTC399
impl From<OwnedRoomId> for TimelineId {
96fdf90aacd6atagen2026-09-08 08:24 UTC400
    fn from(room_id: OwnedRoomId) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC401
        Self::Room(room_id)
96fdf90aacd6atagen2026-09-08 08:24 UTC402
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC403
}
96fdf90aacd6atagen2026-09-08 08:24 UTC404
96fdf90aacd6atagen2026-09-08 08:24 UTC405
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC406
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC407
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC408
pub enum MediaCommand {
31ce2453c82fatagen2026-09-24 13:07 UTC409
    /// succeeds once the send queue has it. progress and failure arrive as events
31ce2453c82fatagen2026-09-24 13:07 UTC410
    Upload(AttachmentUpload),
96fdf90aacd6atagen2026-09-08 08:24 UTC411
}
96fdf90aacd6atagen2026-09-08 08:24 UTC412
66db1b3cd895atagen2026-10-25 10:28 UTC413
/// a room's threads, newest activity first, kept current as they gain replies. the room
66db1b3cd895atagen2026-10-25 10:28 UTC414
/// needn't be open
66db1b3cd895atagen2026-10-25 10:28 UTC415
#[derive(Clone, Debug, Eq, PartialEq)]
66db1b3cd895atagen2026-10-25 10:28 UTC416
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
66db1b3cd895atagen2026-10-25 10:28 UTC417
#[non_exhaustive]
66db1b3cd895atagen2026-10-25 10:28 UTC418
pub enum ThreadListCommand {
66db1b3cd895atagen2026-10-25 10:28 UTC419
    /// answers once `ThreadListReset` has gone out, empty until a page arrives. opening an
66db1b3cd895atagen2026-10-25 10:28 UTC420
    /// open list sends a fresh reset
66db1b3cd895atagen2026-10-25 10:28 UTC421
    Open(OwnedRoomId),
66db1b3cd895atagen2026-10-25 10:28 UTC422
    /// the next `limit` threads from the server, at most 50. one page runs at a time and a
66db1b3cd895atagen2026-10-25 10:28 UTC423
    /// second ask waits for it
66db1b3cd895atagen2026-10-25 10:28 UTC424
    Paginate {
66db1b3cd895atagen2026-10-25 10:28 UTC425
        room_id: OwnedRoomId,
66db1b3cd895atagen2026-10-25 10:28 UTC426
        limit: u16,
66db1b3cd895atagen2026-10-25 10:28 UTC427
    },
66db1b3cd895atagen2026-10-25 10:28 UTC428
    Close(OwnedRoomId),
66db1b3cd895atagen2026-10-25 10:28 UTC429
}
66db1b3cd895atagen2026-10-25 10:28 UTC430
fa51490b6ae9atagen2026-10-24 08:41 UTC431
/// msc2545 pack editing. edits read the server's copy and keep keys macltok doesn't model
fa51490b6ae9atagen2026-10-24 08:41 UTC432
#[derive(Clone, Debug, Eq, PartialEq)]
fa51490b6ae9atagen2026-10-24 08:41 UTC433
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
fa51490b6ae9atagen2026-10-24 08:41 UTC434
#[non_exhaustive]
fa51490b6ae9atagen2026-10-24 08:41 UTC435
pub enum PackCommand {
fa51490b6ae9atagen2026-10-24 08:41 UTC436
    /// body defaults to the shortcode
924b7c011591atagen2026-10-25 10:28 UTC437
    /// into a thread with the thread relation. the pinned timeline refuses it
fa51490b6ae9atagen2026-10-24 08:41 UTC438
    SendSticker {
924b7c011591atagen2026-10-25 10:28 UTC439
        timeline_id: TimelineId,
fa51490b6ae9atagen2026-10-24 08:41 UTC440
        pack_id: String,
fa51490b6ae9atagen2026-10-24 08:41 UTC441
        shortcode: String,
fa51490b6ae9atagen2026-10-24 08:41 UTC442
    },
fa51490b6ae9atagen2026-10-24 08:41 UTC443
    /// fails if the state key already holds a pack
fa51490b6ae9atagen2026-10-24 08:41 UTC444
    CreateRoomPack {
fa51490b6ae9atagen2026-10-24 08:41 UTC445
        room_id: OwnedRoomId,
fa51490b6ae9atagen2026-10-24 08:41 UTC446
        state_key: String,
fa51490b6ae9atagen2026-10-24 08:41 UTC447
        display_name: String,
fa51490b6ae9atagen2026-10-24 08:41 UTC448
    },
fa51490b6ae9atagen2026-10-24 08:41 UTC449
    /// empties the content, which is all deleting a pack can mean
fa51490b6ae9atagen2026-10-24 08:41 UTC450
    Delete(ImagePackSource),
fa51490b6ae9atagen2026-10-24 08:41 UTC451
    SetMeta {
fa51490b6ae9atagen2026-10-24 08:41 UTC452
        pack: ImagePackSource,
fa51490b6ae9atagen2026-10-24 08:41 UTC453
        display_name: Patch<String>,
fa51490b6ae9atagen2026-10-24 08:41 UTC454
        avatar: Patch<OwnedMxcUri>,
fa51490b6ae9atagen2026-10-24 08:41 UTC455
        usage: Patch<Vec<PackUsage>>,
fa51490b6ae9atagen2026-10-24 08:41 UTC456
    },
fa51490b6ae9atagen2026-10-24 08:41 UTC457
    /// adds or replaces by shortcode. a replaced image keeps its info unless the url changed
fa51490b6ae9atagen2026-10-24 08:41 UTC458
    PutImage {
fa51490b6ae9atagen2026-10-24 08:41 UTC459
        pack: ImagePackSource,
fa51490b6ae9atagen2026-10-24 08:41 UTC460
        shortcode: String,
fa51490b6ae9atagen2026-10-24 08:41 UTC461
        mxc: OwnedMxcUri,
fa51490b6ae9atagen2026-10-24 08:41 UTC462
        body: Option<String>,
fa51490b6ae9atagen2026-10-24 08:41 UTC463
        usage: Option<Vec<PackUsage>>,
fa51490b6ae9atagen2026-10-24 08:41 UTC464
        info: Option<PackImageInfo>,
fa51490b6ae9atagen2026-10-24 08:41 UTC465
    },
fa51490b6ae9atagen2026-10-24 08:41 UTC466
    /// fails if `to` is taken
fa51490b6ae9atagen2026-10-24 08:41 UTC467
    RenameImage {
fa51490b6ae9atagen2026-10-24 08:41 UTC468
        pack: ImagePackSource,
fa51490b6ae9atagen2026-10-24 08:41 UTC469
        from: String,
fa51490b6ae9atagen2026-10-24 08:41 UTC470
        to: String,
fa51490b6ae9atagen2026-10-24 08:41 UTC471
    },
fa51490b6ae9atagen2026-10-24 08:41 UTC472
    RemoveImage {
fa51490b6ae9atagen2026-10-24 08:41 UTC473
        pack: ImagePackSource,
fa51490b6ae9atagen2026-10-24 08:41 UTC474
        shortcode: String,
fa51490b6ae9atagen2026-10-24 08:41 UTC475
    },
fa51490b6ae9atagen2026-10-24 08:41 UTC476
    SetEnabledEverywhere {
fa51490b6ae9atagen2026-10-24 08:41 UTC477
        room_id: OwnedRoomId,
fa51490b6ae9atagen2026-10-24 08:41 UTC478
        state_key: String,
fa51490b6ae9atagen2026-10-24 08:41 UTC479
        enabled: bool,
fa51490b6ae9atagen2026-10-24 08:41 UTC480
    },
fa51490b6ae9atagen2026-10-24 08:41 UTC481
    /// answers with `CommandOutput::Mxc`, the same uri when it already lives on your homeserver
fa51490b6ae9atagen2026-10-24 08:41 UTC482
    Rehost(OwnedMxcUri),
fa51490b6ae9atagen2026-10-24 08:41 UTC483
    /// the rest answer with `CommandOutput::Cloned`. clashes get `-2`, `-3` and so on
fa51490b6ae9atagen2026-10-24 08:41 UTC484
    CloneImage {
fa51490b6ae9atagen2026-10-24 08:41 UTC485
        from_pack: String,
fa51490b6ae9atagen2026-10-24 08:41 UTC486
        shortcode: String,
fa51490b6ae9atagen2026-10-24 08:41 UTC487
        to: ImagePackSource,
2656c1d26d6batagen2026-10-25 05:44 UTC488
        usage: Option<Vec<PackUsage>>,
fa51490b6ae9atagen2026-10-24 08:41 UTC489
    },
fa51490b6ae9atagen2026-10-24 08:41 UTC490
    CloneSticker {
fa51490b6ae9atagen2026-10-24 08:41 UTC491
        room_id: OwnedRoomId,
fa51490b6ae9atagen2026-10-24 08:41 UTC492
        event_id: OwnedEventId,
fa51490b6ae9atagen2026-10-24 08:41 UTC493
        to: ImagePackSource,
fa51490b6ae9atagen2026-10-24 08:41 UTC494
        shortcode: String,
2656c1d26d6batagen2026-10-25 05:44 UTC495
        usage: Option<Vec<PackUsage>>,
fa51490b6ae9atagen2026-10-24 08:41 UTC496
    },
fa51490b6ae9atagen2026-10-24 08:41 UTC497
    /// makes the room pack if its state key is free, else merges. images that can't be
fa51490b6ae9atagen2026-10-24 08:41 UTC498
    /// fetched are skipped and listed, the rest are written
fa51490b6ae9atagen2026-10-24 08:41 UTC499
    ClonePack {
fa51490b6ae9atagen2026-10-24 08:41 UTC500
        from_pack: String,
fa51490b6ae9atagen2026-10-24 08:41 UTC501
        to: ImagePackSource,
fa51490b6ae9atagen2026-10-24 08:41 UTC502
        display_name: Option<String>,
2656c1d26d6batagen2026-10-25 05:44 UTC503
        usage: Option<Vec<PackUsage>>,
fa51490b6ae9atagen2026-10-24 08:41 UTC504
    },
fa51490b6ae9atagen2026-10-24 08:41 UTC505
}
fa51490b6ae9atagen2026-10-24 08:41 UTC506
fa51490b6ae9atagen2026-10-24 08:41 UTC507
#[derive(Clone, Debug, Default, Eq, PartialEq)]
fa51490b6ae9atagen2026-10-24 08:41 UTC508
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
fa51490b6ae9atagen2026-10-24 08:41 UTC509
pub enum Patch<T> {
fa51490b6ae9atagen2026-10-24 08:41 UTC510
    #[default]
fa51490b6ae9atagen2026-10-24 08:41 UTC511
    Keep,
fa51490b6ae9atagen2026-10-24 08:41 UTC512
    Clear,
fa51490b6ae9atagen2026-10-24 08:41 UTC513
    Set(T),
fa51490b6ae9atagen2026-10-24 08:41 UTC514
}
fa51490b6ae9atagen2026-10-24 08:41 UTC515
fa51490b6ae9atagen2026-10-24 08:41 UTC516
#[derive(Clone, Debug, Default, Eq, PartialEq)]
fa51490b6ae9atagen2026-10-24 08:41 UTC517
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
fa51490b6ae9atagen2026-10-24 08:41 UTC518
#[non_exhaustive]
fa51490b6ae9atagen2026-10-24 08:41 UTC519
pub struct PackImageInfo {
fa51490b6ae9atagen2026-10-24 08:41 UTC520
    pub mimetype: Option<String>,
fa51490b6ae9atagen2026-10-24 08:41 UTC521
    pub size_bytes: Option<u64>,
fa51490b6ae9atagen2026-10-24 08:41 UTC522
    pub width: Option<u64>,
fa51490b6ae9atagen2026-10-24 08:41 UTC523
    pub height: Option<u64>,
fa51490b6ae9atagen2026-10-24 08:41 UTC524
}
fa51490b6ae9atagen2026-10-24 08:41 UTC525
fa51490b6ae9atagen2026-10-24 08:41 UTC526
impl PackImageInfo {
fa51490b6ae9atagen2026-10-24 08:41 UTC527
    #[must_use]
fa51490b6ae9atagen2026-10-24 08:41 UTC528
    pub fn new(
fa51490b6ae9atagen2026-10-24 08:41 UTC529
        mimetype: Option<String>,
fa51490b6ae9atagen2026-10-24 08:41 UTC530
        size_bytes: Option<u64>,
fa51490b6ae9atagen2026-10-24 08:41 UTC531
        width: Option<u64>,
fa51490b6ae9atagen2026-10-24 08:41 UTC532
        height: Option<u64>,
fa51490b6ae9atagen2026-10-24 08:41 UTC533
    ) -> Self {
fa51490b6ae9atagen2026-10-24 08:41 UTC534
        Self {
fa51490b6ae9atagen2026-10-24 08:41 UTC535
            mimetype,
fa51490b6ae9atagen2026-10-24 08:41 UTC536
            size_bytes,
fa51490b6ae9atagen2026-10-24 08:41 UTC537
            width,
fa51490b6ae9atagen2026-10-24 08:41 UTC538
            height,
fa51490b6ae9atagen2026-10-24 08:41 UTC539
        }
fa51490b6ae9atagen2026-10-24 08:41 UTC540
    }
fa51490b6ae9atagen2026-10-24 08:41 UTC541
}
fa51490b6ae9atagen2026-10-24 08:41 UTC542
96fdf90aacd6atagen2026-09-08 08:24 UTC543
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC544
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
5a52012c9b1datagen2026-09-24 23:45 UTC545
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC546
pub struct AttachmentUpload {
96fdf90aacd6atagen2026-09-08 08:24 UTC547
    pub timeline_id: TimelineId,
96fdf90aacd6atagen2026-09-08 08:24 UTC548
    pub filename: String,
96fdf90aacd6atagen2026-09-08 08:24 UTC549
    pub mimetype: String,
96fdf90aacd6atagen2026-09-08 08:24 UTC550
    pub bytes: Vec<u8>,
0827ad2d24e9atagen2026-10-23 06:49 UTC551
    pub caption: Option<RichText>,
0827ad2d24e9atagen2026-10-23 06:49 UTC552
    pub mentions: MessageMentions,
0827ad2d24e9atagen2026-10-23 06:49 UTC553
    pub reply_to: Option<OwnedEventId>,
0827ad2d24e9atagen2026-10-23 06:49 UTC554
    pub notify_replied_to: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC555
    pub details: Option<UploadDetails>,
96fdf90aacd6atagen2026-09-08 08:24 UTC556
    pub thumbnail: Option<UploadThumbnail>,
96fdf90aacd6atagen2026-09-08 08:24 UTC557
}
96fdf90aacd6atagen2026-09-08 08:24 UTC558
96fdf90aacd6atagen2026-09-08 08:24 UTC559
impl AttachmentUpload {
96fdf90aacd6atagen2026-09-08 08:24 UTC560
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC561
    pub fn new(
96fdf90aacd6atagen2026-09-08 08:24 UTC562
        timeline_id: impl Into<TimelineId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC563
        filename: impl Into<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC564
        mimetype: impl Into<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC565
        bytes: Vec<u8>,
96fdf90aacd6atagen2026-09-08 08:24 UTC566
    ) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC567
        Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC568
            timeline_id: timeline_id.into(),
96fdf90aacd6atagen2026-09-08 08:24 UTC569
            filename: filename.into(),
96fdf90aacd6atagen2026-09-08 08:24 UTC570
            mimetype: mimetype.into(),
96fdf90aacd6atagen2026-09-08 08:24 UTC571
            bytes,
96fdf90aacd6atagen2026-09-08 08:24 UTC572
            caption: None,
0827ad2d24e9atagen2026-10-23 06:49 UTC573
            mentions: MessageMentions::default(),
0827ad2d24e9atagen2026-10-23 06:49 UTC574
            reply_to: None,
0827ad2d24e9atagen2026-10-23 06:49 UTC575
            notify_replied_to: true,
96fdf90aacd6atagen2026-09-08 08:24 UTC576
            details: None,
96fdf90aacd6atagen2026-09-08 08:24 UTC577
            thumbnail: None,
96fdf90aacd6atagen2026-09-08 08:24 UTC578
        }
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, 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 enum UploadDetails {
96fdf90aacd6atagen2026-09-08 08:24 UTC586
    Image {
96fdf90aacd6atagen2026-09-08 08:24 UTC587
        width: Option<u32>,
96fdf90aacd6atagen2026-09-08 08:24 UTC588
        height: Option<u32>,
96fdf90aacd6atagen2026-09-08 08:24 UTC589
        blurhash: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC590
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC591
    Video {
96fdf90aacd6atagen2026-09-08 08:24 UTC592
        width: Option<u32>,
96fdf90aacd6atagen2026-09-08 08:24 UTC593
        height: Option<u32>,
96fdf90aacd6atagen2026-09-08 08:24 UTC594
        duration_ms: Option<u64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC595
        blurhash: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC596
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC597
    Audio {
96fdf90aacd6atagen2026-09-08 08:24 UTC598
        duration_ms: Option<u64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC599
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC600
    Voice {
96fdf90aacd6atagen2026-09-08 08:24 UTC601
        duration_ms: u64,
96fdf90aacd6atagen2026-09-08 08:24 UTC602
        waveform: Vec<u16>,
96fdf90aacd6atagen2026-09-08 08:24 UTC603
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC604
    File,
96fdf90aacd6atagen2026-09-08 08:24 UTC605
}
96fdf90aacd6atagen2026-09-08 08:24 UTC606
96fdf90aacd6atagen2026-09-08 08:24 UTC607
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC608
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC609
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC610
pub struct UploadThumbnail {
96fdf90aacd6atagen2026-09-08 08:24 UTC611
    pub bytes: Vec<u8>,
96fdf90aacd6atagen2026-09-08 08:24 UTC612
    pub mimetype: String,
96fdf90aacd6atagen2026-09-08 08:24 UTC613
    pub width: u32,
96fdf90aacd6atagen2026-09-08 08:24 UTC614
    pub height: u32,
96fdf90aacd6atagen2026-09-08 08:24 UTC615
}
96fdf90aacd6atagen2026-09-08 08:24 UTC616
31ce2453c82fatagen2026-09-24 13:07 UTC617
impl UploadThumbnail {
31ce2453c82fatagen2026-09-24 13:07 UTC618
    #[must_use]
31ce2453c82fatagen2026-09-24 13:07 UTC619
    pub fn new(bytes: Vec<u8>, mimetype: impl Into<String>, width: u32, height: u32) -> Self {
31ce2453c82fatagen2026-09-24 13:07 UTC620
        Self {
31ce2453c82fatagen2026-09-24 13:07 UTC621
            bytes,
31ce2453c82fatagen2026-09-24 13:07 UTC622
            mimetype: mimetype.into(),
31ce2453c82fatagen2026-09-24 13:07 UTC623
            width,
31ce2453c82fatagen2026-09-24 13:07 UTC624
            height,
31ce2453c82fatagen2026-09-24 13:07 UTC625
        }
31ce2453c82fatagen2026-09-24 13:07 UTC626
    }
31ce2453c82fatagen2026-09-24 13:07 UTC627
}
31ce2453c82fatagen2026-09-24 13:07 UTC628
96fdf90aacd6atagen2026-09-08 08:24 UTC629
#[derive(Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC630
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC631
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC632
pub enum EncryptionCommand {
96fdf90aacd6atagen2026-09-08 08:24 UTC633
    Recover(String),
96fdf90aacd6atagen2026-09-08 08:24 UTC634
    CreateKeyBackup,
96fdf90aacd6atagen2026-09-08 08:24 UTC635
    EnableKeyBackup,
743123167e29atagen2026-10-26 04:02 UTC636
    DisableKeyBackup {
743123167e29atagen2026-10-26 04:02 UTC637
        delete_from_server: bool,
743123167e29atagen2026-10-26 04:02 UTC638
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC639
    RecoverKeyBackup(String),
743123167e29atagen2026-10-26 04:02 UTC640
    /// creates secret storage holding the cross-signing and backup keys, turns key backup on,
743123167e29atagen2026-10-26 04:02 UTC641
    /// and answers with the recovery key. refused while a backup this device can't open exists
743123167e29atagen2026-10-26 04:02 UTC642
    EnableRecovery {
743123167e29atagen2026-10-26 04:02 UTC643
        passphrase: Option<String>,
743123167e29atagen2026-10-26 04:02 UTC644
    },
743123167e29atagen2026-10-26 04:02 UTC645
    ResetRecoveryKey {
743123167e29atagen2026-10-26 04:02 UTC646
        passphrase: Option<String>,
743123167e29atagen2026-10-26 04:02 UTC647
    },
743123167e29atagen2026-10-26 04:02 UTC648
    DisableRecovery,
96fdf90aacd6atagen2026-09-08 08:24 UTC649
    StartVerification(VerificationTarget),
96fdf90aacd6atagen2026-09-08 08:24 UTC650
    Verify(VerificationAction),
96fdf90aacd6atagen2026-09-08 08:24 UTC651
}
96fdf90aacd6atagen2026-09-08 08:24 UTC652
96fdf90aacd6atagen2026-09-08 08:24 UTC653
impl fmt::Debug for EncryptionCommand {
96fdf90aacd6atagen2026-09-08 08:24 UTC654
    fn fmt(&self, formatter: &mut fmt::Formatter<'_>) -> fmt::Result {
96fdf90aacd6atagen2026-09-08 08:24 UTC655
        match self {
96fdf90aacd6atagen2026-09-08 08:24 UTC656
            Self::Recover(_) => formatter.debug_tuple("Recover").field(&"...").finish(),
96fdf90aacd6atagen2026-09-08 08:24 UTC657
            Self::CreateKeyBackup => formatter.write_str("CreateKeyBackup"),
96fdf90aacd6atagen2026-09-08 08:24 UTC658
            Self::EnableKeyBackup => formatter.write_str("EnableKeyBackup"),
96fdf90aacd6atagen2026-09-08 08:24 UTC659
            Self::DisableKeyBackup { delete_from_server } => formatter
96fdf90aacd6atagen2026-09-08 08:24 UTC660
                .debug_struct("DisableKeyBackup")
96fdf90aacd6atagen2026-09-08 08:24 UTC661
                .field("delete_from_server", delete_from_server)
96fdf90aacd6atagen2026-09-08 08:24 UTC662
                .finish(),
96fdf90aacd6atagen2026-09-08 08:24 UTC663
            Self::RecoverKeyBackup(_) => formatter
96fdf90aacd6atagen2026-09-08 08:24 UTC664
                .debug_tuple("RecoverKeyBackup")
96fdf90aacd6atagen2026-09-08 08:24 UTC665
                .field(&"...")
96fdf90aacd6atagen2026-09-08 08:24 UTC666
                .finish(),
743123167e29atagen2026-10-26 04:02 UTC667
            Self::EnableRecovery { passphrase } => formatter
743123167e29atagen2026-10-26 04:02 UTC668
                .debug_struct("EnableRecovery")
743123167e29atagen2026-10-26 04:02 UTC669
                .field("passphrase", &passphrase.as_ref().map(|_| "..."))
743123167e29atagen2026-10-26 04:02 UTC670
                .finish(),
743123167e29atagen2026-10-26 04:02 UTC671
            Self::ResetRecoveryKey { passphrase } => formatter
743123167e29atagen2026-10-26 04:02 UTC672
                .debug_struct("ResetRecoveryKey")
743123167e29atagen2026-10-26 04:02 UTC673
                .field("passphrase", &passphrase.as_ref().map(|_| "..."))
743123167e29atagen2026-10-26 04:02 UTC674
                .finish(),
743123167e29atagen2026-10-26 04:02 UTC675
            Self::DisableRecovery => formatter.write_str("DisableRecovery"),
96fdf90aacd6atagen2026-09-08 08:24 UTC676
            Self::StartVerification(target) => formatter
96fdf90aacd6atagen2026-09-08 08:24 UTC677
                .debug_tuple("StartVerification")
96fdf90aacd6atagen2026-09-08 08:24 UTC678
                .field(target)
96fdf90aacd6atagen2026-09-08 08:24 UTC679
                .finish(),
96fdf90aacd6atagen2026-09-08 08:24 UTC680
            Self::Verify(action) => formatter.debug_tuple("Verify").field(action).finish(),
96fdf90aacd6atagen2026-09-08 08:24 UTC681
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC682
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC683
}
96fdf90aacd6atagen2026-09-08 08:24 UTC684
96fdf90aacd6atagen2026-09-08 08:24 UTC685
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC686
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC687
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC688
pub enum NotificationCommand {
96fdf90aacd6atagen2026-09-08 08:24 UTC689
    SetRoomMode {
96fdf90aacd6atagen2026-09-08 08:24 UTC690
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC691
        mode: RoomNotificationMode,
96fdf90aacd6atagen2026-09-08 08:24 UTC692
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC693
    ResetRoomMode(OwnedRoomId),
96fdf90aacd6atagen2026-09-08 08:24 UTC694
    SetDefaultMode {
96fdf90aacd6atagen2026-09-08 08:24 UTC695
        encrypted: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC696
        one_to_one: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC697
        mode: RoomNotificationMode,
96fdf90aacd6atagen2026-09-08 08:24 UTC698
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC699
    AddKeyword(String),
96fdf90aacd6atagen2026-09-08 08:24 UTC700
    RemoveKeyword(String),
96fdf90aacd6atagen2026-09-08 08:24 UTC701
}
96fdf90aacd6atagen2026-09-08 08:24 UTC702
96fdf90aacd6atagen2026-09-08 08:24 UTC703
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC704
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC705
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC706
pub enum LifecycleCommand {
96fdf90aacd6atagen2026-09-08 08:24 UTC707
    Shutdown,
96fdf90aacd6atagen2026-09-08 08:24 UTC708
}
96fdf90aacd6atagen2026-09-08 08:24 UTC709
80381e06a573atagen2026-10-25 03:02 UTC710
#[derive(Clone, Debug, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC711
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC712
pub enum CommandOutput {
31ce2453c82fatagen2026-09-24 13:07 UTC713
    Done,
31ce2453c82fatagen2026-09-24 13:07 UTC714
    Room(OwnedRoomId),
9bd34e25bb86atagen2026-10-24 07:23 UTC715
    Mxc(OwnedMxcUri),
fa51490b6ae9atagen2026-10-24 08:41 UTC716
    /// the shortcodes the copies ended up under, and the ones that couldn't be fetched
fa51490b6ae9atagen2026-10-24 08:41 UTC717
    Cloned {
fa51490b6ae9atagen2026-10-24 08:41 UTC718
        shortcodes: Vec<String>,
fa51490b6ae9atagen2026-10-24 08:41 UTC719
        skipped: Vec<String>,
fa51490b6ae9atagen2026-10-24 08:41 UTC720
    },
da8896938cf0atagen2026-10-25 10:04 UTC721
    EventContext(EventContextSession),
89bc9f8d246datagen2026-10-24 13:40 UTC722
    EventContextPage(EventContextPage),
cbb715e11963atagen2026-10-24 23:24 UTC723
    MentionsPage(crate::MentionsPage),
cbb715e11963atagen2026-10-24 23:24 UTC724
    MentionContext(crate::SavedMentionContext),
c9effeac326aatagen2026-10-25 10:32 UTC725
    SearchSession(crate::SearchSession),
c9effeac326aatagen2026-10-25 10:32 UTC726
    SearchPage(crate::SearchPage),
c9effeac326aatagen2026-10-25 10:32 UTC727
    SearchCoverage(crate::SearchCoverage),
743123167e29atagen2026-10-26 04:02 UTC728
    RecoveryKey(RecoveryKey),
89bc9f8d246datagen2026-10-24 13:40 UTC729
}
89bc9f8d246datagen2026-10-24 13:40 UTC730
89bc9f8d246datagen2026-10-24 13:40 UTC731
#[derive(Clone, Debug, Eq, PartialEq)]
89bc9f8d246datagen2026-10-24 13:40 UTC732
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
89bc9f8d246datagen2026-10-24 13:40 UTC733
#[non_exhaustive]
89bc9f8d246datagen2026-10-24 13:40 UTC734
pub struct EventContext {
89bc9f8d246datagen2026-10-24 13:40 UTC735
    pub events_before: Vec<TimelineItem>,
cb7b3362e1ceatagen2026-10-25 09:08 UTC736
    pub event: TimelineItem,
89bc9f8d246datagen2026-10-24 13:40 UTC737
    pub events_after: Vec<TimelineItem>,
89bc9f8d246datagen2026-10-24 13:40 UTC738
    pub start_token: Option<String>,
89bc9f8d246datagen2026-10-24 13:40 UTC739
    pub end_token: Option<String>,
89bc9f8d246datagen2026-10-24 13:40 UTC740
}
89bc9f8d246datagen2026-10-24 13:40 UTC741
1f875b103b27atagen2026-10-25 10:44 UTC742
#[derive(Clone, Debug, Eq, PartialEq)]
1f875b103b27atagen2026-10-25 10:44 UTC743
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
1f875b103b27atagen2026-10-25 10:44 UTC744
pub enum EventContextCloseReason {
1f875b103b27atagen2026-10-25 10:44 UTC745
    /// opening a 33rd session closed the oldest
1f875b103b27atagen2026-10-25 10:44 UTC746
    Evicted,
1f875b103b27atagen2026-10-25 10:44 UTC747
    RoomLeft,
1f875b103b27atagen2026-10-25 10:44 UTC748
}
1f875b103b27atagen2026-10-25 10:44 UTC749
da8896938cf0atagen2026-10-25 10:04 UTC750
/// a session's media stay resolvable until it closes, and past `EngineConfig::max_context_media`
da8896938cf0atagen2026-10-25 10:04 UTC751
/// its least recently used are dropped
da8896938cf0atagen2026-10-25 10:04 UTC752
#[derive(Clone, Debug, Eq, PartialEq)]
da8896938cf0atagen2026-10-25 10:04 UTC753
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
da8896938cf0atagen2026-10-25 10:04 UTC754
#[non_exhaustive]
da8896938cf0atagen2026-10-25 10:04 UTC755
pub struct EventContextSession {
da8896938cf0atagen2026-10-25 10:04 UTC756
    pub context_id: String,
da8896938cf0atagen2026-10-25 10:04 UTC757
    pub context: EventContext,
da8896938cf0atagen2026-10-25 10:04 UTC758
}
da8896938cf0atagen2026-10-25 10:04 UTC759
89bc9f8d246datagen2026-10-24 13:40 UTC760
#[derive(Clone, Debug, Eq, PartialEq)]
89bc9f8d246datagen2026-10-24 13:40 UTC761
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
89bc9f8d246datagen2026-10-24 13:40 UTC762
#[non_exhaustive]
89bc9f8d246datagen2026-10-24 13:40 UTC763
pub struct EventContextPage {
89bc9f8d246datagen2026-10-24 13:40 UTC764
    pub events: Vec<TimelineItem>,
cb7b3362e1ceatagen2026-10-25 09:08 UTC765
    /// `None` once that end of the room is reached
89bc9f8d246datagen2026-10-24 13:40 UTC766
    pub next_token: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC767
}
96fdf90aacd6atagen2026-09-08 08:24 UTC768
96fdf90aacd6atagen2026-09-08 08:24 UTC769
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC770
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC771
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC772
pub enum MessageContent {
96fdf90aacd6atagen2026-09-08 08:24 UTC773
    Text {
96fdf90aacd6atagen2026-09-08 08:24 UTC774
        content: RichText,
96fdf90aacd6atagen2026-09-08 08:24 UTC775
        mentions: MessageMentions,
96fdf90aacd6atagen2026-09-08 08:24 UTC776
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC777
    Emote {
96fdf90aacd6atagen2026-09-08 08:24 UTC778
        content: RichText,
96fdf90aacd6atagen2026-09-08 08:24 UTC779
        mentions: MessageMentions,
96fdf90aacd6atagen2026-09-08 08:24 UTC780
    },
9bd34e25bb86atagen2026-10-24 07:23 UTC781
    /// m.notice, for bots. clients render it muted and never answer it automatically
9bd34e25bb86atagen2026-10-24 07:23 UTC782
    Notice {
9bd34e25bb86atagen2026-10-24 07:23 UTC783
        content: RichText,
9bd34e25bb86atagen2026-10-24 07:23 UTC784
        mentions: MessageMentions,
9bd34e25bb86atagen2026-10-24 07:23 UTC785
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC786
    Reply {
96fdf90aacd6atagen2026-09-08 08:24 UTC787
        event_id: OwnedEventId,
96fdf90aacd6atagen2026-09-08 08:24 UTC788
        content: RichText,
96fdf90aacd6atagen2026-09-08 08:24 UTC789
        mentions: MessageMentions,
96fdf90aacd6atagen2026-09-08 08:24 UTC790
        notify_replied_to: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC791
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC792
}
96fdf90aacd6atagen2026-09-08 08:24 UTC793
96fdf90aacd6atagen2026-09-08 08:24 UTC794
impl MessageContent {
96fdf90aacd6atagen2026-09-08 08:24 UTC795
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC796
    pub fn text(body: impl Into<String>) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC797
        Self::Text {
96fdf90aacd6atagen2026-09-08 08:24 UTC798
            content: RichText::plain(body),
96fdf90aacd6atagen2026-09-08 08:24 UTC799
            mentions: MessageMentions::default(),
96fdf90aacd6atagen2026-09-08 08:24 UTC800
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC801
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC802
96fdf90aacd6atagen2026-09-08 08:24 UTC803
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC804
    pub fn html(body: impl Into<String>, formatted_body: impl Into<String>) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC805
        Self::Text {
96fdf90aacd6atagen2026-09-08 08:24 UTC806
            content: RichText::html(body, formatted_body),
96fdf90aacd6atagen2026-09-08 08:24 UTC807
            mentions: MessageMentions::default(),
96fdf90aacd6atagen2026-09-08 08:24 UTC808
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC809
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC810
96fdf90aacd6atagen2026-09-08 08:24 UTC811
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC812
    pub fn emote(content: RichText, mentions: MessageMentions) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC813
        Self::Emote { content, mentions }
96fdf90aacd6atagen2026-09-08 08:24 UTC814
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC815
96fdf90aacd6atagen2026-09-08 08:24 UTC816
    #[must_use]
9bd34e25bb86atagen2026-10-24 07:23 UTC817
    pub fn notice(content: RichText, mentions: MessageMentions) -> Self {
9bd34e25bb86atagen2026-10-24 07:23 UTC818
        Self::Notice { content, mentions }
9bd34e25bb86atagen2026-10-24 07:23 UTC819
    }
9bd34e25bb86atagen2026-10-24 07:23 UTC820
9bd34e25bb86atagen2026-10-24 07:23 UTC821
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC822
    pub fn reply(event_id: OwnedEventId, content: RichText, mentions: MessageMentions) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC823
        Self::Reply {
96fdf90aacd6atagen2026-09-08 08:24 UTC824
            event_id,
96fdf90aacd6atagen2026-09-08 08:24 UTC825
            content,
96fdf90aacd6atagen2026-09-08 08:24 UTC826
            mentions,
96fdf90aacd6atagen2026-09-08 08:24 UTC827
            notify_replied_to: true,
96fdf90aacd6atagen2026-09-08 08:24 UTC828
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC829
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC830
96fdf90aacd6atagen2026-09-08 08:24 UTC831
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC832
    pub fn reply_without_notification(
96fdf90aacd6atagen2026-09-08 08:24 UTC833
        event_id: OwnedEventId,
96fdf90aacd6atagen2026-09-08 08:24 UTC834
        content: RichText,
96fdf90aacd6atagen2026-09-08 08:24 UTC835
        mentions: MessageMentions,
96fdf90aacd6atagen2026-09-08 08:24 UTC836
    ) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC837
        Self::Reply {
96fdf90aacd6atagen2026-09-08 08:24 UTC838
            event_id,
96fdf90aacd6atagen2026-09-08 08:24 UTC839
            content,
96fdf90aacd6atagen2026-09-08 08:24 UTC840
            mentions,
96fdf90aacd6atagen2026-09-08 08:24 UTC841
            notify_replied_to: false,
96fdf90aacd6atagen2026-09-08 08:24 UTC842
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC843
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC844
}
96fdf90aacd6atagen2026-09-08 08:24 UTC845
96fdf90aacd6atagen2026-09-08 08:24 UTC846
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC847
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC848
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC849
pub enum MessageEditContent {
96fdf90aacd6atagen2026-09-08 08:24 UTC850
    Text {
96fdf90aacd6atagen2026-09-08 08:24 UTC851
        content: RichText,
96fdf90aacd6atagen2026-09-08 08:24 UTC852
        mentions: MessageMentions,
96fdf90aacd6atagen2026-09-08 08:24 UTC853
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC854
    Emote {
96fdf90aacd6atagen2026-09-08 08:24 UTC855
        content: RichText,
96fdf90aacd6atagen2026-09-08 08:24 UTC856
        mentions: MessageMentions,
96fdf90aacd6atagen2026-09-08 08:24 UTC857
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC858
}
96fdf90aacd6atagen2026-09-08 08:24 UTC859
96fdf90aacd6atagen2026-09-08 08:24 UTC860
impl MessageEditContent {
96fdf90aacd6atagen2026-09-08 08:24 UTC861
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC862
    pub fn text(body: impl Into<String>) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC863
        Self::Text {
96fdf90aacd6atagen2026-09-08 08:24 UTC864
            content: RichText::plain(body),
96fdf90aacd6atagen2026-09-08 08:24 UTC865
            mentions: MessageMentions::default(),
96fdf90aacd6atagen2026-09-08 08:24 UTC866
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC867
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC868
96fdf90aacd6atagen2026-09-08 08:24 UTC869
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC870
    pub fn html(body: impl Into<String>, formatted_body: impl Into<String>) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC871
        Self::Text {
96fdf90aacd6atagen2026-09-08 08:24 UTC872
            content: RichText::html(body, formatted_body),
96fdf90aacd6atagen2026-09-08 08:24 UTC873
            mentions: MessageMentions::default(),
96fdf90aacd6atagen2026-09-08 08:24 UTC874
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC875
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC876
96fdf90aacd6atagen2026-09-08 08:24 UTC877
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC878
    pub fn emote(content: RichText, mentions: MessageMentions) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC879
        Self::Emote { content, mentions }
96fdf90aacd6atagen2026-09-08 08:24 UTC880
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC881
}
96fdf90aacd6atagen2026-09-08 08:24 UTC882
96fdf90aacd6atagen2026-09-08 08:24 UTC883
#[derive(Clone, Debug, Default, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC884
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC885
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC886
pub struct RichText {
96fdf90aacd6atagen2026-09-08 08:24 UTC887
    pub body: String,
96fdf90aacd6atagen2026-09-08 08:24 UTC888
    pub formatted_body: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC889
}
96fdf90aacd6atagen2026-09-08 08:24 UTC890
96fdf90aacd6atagen2026-09-08 08:24 UTC891
impl RichText {
96fdf90aacd6atagen2026-09-08 08:24 UTC892
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC893
    pub fn plain(body: impl Into<String>) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC894
        Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC895
            body: body.into(),
96fdf90aacd6atagen2026-09-08 08:24 UTC896
            formatted_body: None,
96fdf90aacd6atagen2026-09-08 08:24 UTC897
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC898
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC899
96fdf90aacd6atagen2026-09-08 08:24 UTC900
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC901
    pub fn html(body: impl Into<String>, formatted_body: impl Into<String>) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC902
        Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC903
            body: body.into(),
96fdf90aacd6atagen2026-09-08 08:24 UTC904
            formatted_body: Some(formatted_body.into()),
96fdf90aacd6atagen2026-09-08 08:24 UTC905
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC906
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC907
}
96fdf90aacd6atagen2026-09-08 08:24 UTC908
96fdf90aacd6atagen2026-09-08 08:24 UTC909
#[derive(Clone, Debug, Default, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC910
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC911
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC912
pub struct MessageMentions {
96fdf90aacd6atagen2026-09-08 08:24 UTC913
    pub user_ids: Vec<OwnedUserId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC914
    pub room: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC915
}
96fdf90aacd6atagen2026-09-08 08:24 UTC916
96fdf90aacd6atagen2026-09-08 08:24 UTC917
impl MessageMentions {
96fdf90aacd6atagen2026-09-08 08:24 UTC918
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC919
    pub fn with_user_ids(user_ids: impl IntoIterator<Item = OwnedUserId>) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC920
        Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC921
            user_ids: user_ids.into_iter().collect(),
96fdf90aacd6atagen2026-09-08 08:24 UTC922
            room: false,
96fdf90aacd6atagen2026-09-08 08:24 UTC923
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC924
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC925
96fdf90aacd6atagen2026-09-08 08:24 UTC926
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC927
    pub fn room() -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC928
        Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC929
            user_ids: Vec::new(),
96fdf90aacd6atagen2026-09-08 08:24 UTC930
            room: true,
96fdf90aacd6atagen2026-09-08 08:24 UTC931
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC932
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC933
}
96fdf90aacd6atagen2026-09-08 08:24 UTC934
80381e06a573atagen2026-10-25 03:02 UTC935
#[derive(Clone, Debug, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC936
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC937
pub enum Event {
96fdf90aacd6atagen2026-09-08 08:24 UTC938
    ConnectionChanged(ConnectionState),
96fdf90aacd6atagen2026-09-08 08:24 UTC939
    Authenticated {
96fdf90aacd6atagen2026-09-08 08:24 UTC940
        user_id: OwnedUserId,
96fdf90aacd6atagen2026-09-08 08:24 UTC941
    },
f12377bce9b9atagen2026-09-26 12:32 UTC942
    /// the tokens rotated. with a `SessionStore` the record is already saved by now,
f12377bce9b9atagen2026-09-26 12:32 UTC943
    /// without one persist a fresh `ClientHandle::session_record()` atomically
96fdf90aacd6atagen2026-09-08 08:24 UTC944
    SessionTokensChanged,
f12377bce9b9atagen2026-09-26 12:32 UTC945
    /// the rotated tokens didn't reach the `SessionStore`, so the saved record may not
f12377bce9b9atagen2026-09-26 12:32 UTC946
    /// restore. the engine tries again on the next rotation
f12377bce9b9atagen2026-09-26 12:32 UTC947
    SessionSaveFailed {
f12377bce9b9atagen2026-09-26 12:32 UTC948
        message: String,
f12377bce9b9atagen2026-09-26 12:32 UTC949
    },
7c26fad34822atagen2026-09-26 09:41 UTC950
    /// the server stopped honouring our token and the engine stops. a soft logout
7c26fad34822atagen2026-09-26 09:41 UTC951
    /// names the device to log in again as, keeping the store. otherwise the record
7c26fad34822atagen2026-09-26 09:41 UTC952
    /// and the store are both dead
fa9114fcf75fatagen2026-09-24 12:51 UTC953
    SessionAccessRejected {
7c26fad34822atagen2026-09-26 09:41 UTC954
        soft_logout: Option<OwnedDeviceId>,
fa9114fcf75fatagen2026-09-24 12:51 UTC955
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC956
    NotificationSettingsChanged,
96fdf90aacd6atagen2026-09-08 08:24 UTC957
    VerificationTargetChanged(VerificationTarget),
96fdf90aacd6atagen2026-09-08 08:24 UTC958
    RoomsChanged,
cbb715e11963atagen2026-10-24 23:24 UTC959
    MentionsChanged(crate::MentionsUpdate),
17e042fbc331atagen2026-10-08 12:39 UTC960
    /// an image pack came, went or changed somewhere. ask `image_packs` again
17e042fbc331atagen2026-10-08 12:39 UTC961
    ImagePacksChanged,
31ce2453c82fatagen2026-09-24 13:07 UTC962
    /// replaces whatever you had for this timeline. every diff after it applies to it
96fdf90aacd6atagen2026-09-08 08:24 UTC963
    TimelineReset {
96fdf90aacd6atagen2026-09-08 08:24 UTC964
        timeline_id: TimelineId,
d5d8097c3afdatagen2026-09-26 09:33 UTC965
        items: Vector<TimelineItem>,
96fdf90aacd6atagen2026-09-08 08:24 UTC966
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC967
    TimelineChanged {
96fdf90aacd6atagen2026-09-08 08:24 UTC968
        timeline_id: TimelineId,
96fdf90aacd6atagen2026-09-08 08:24 UTC969
        diffs: Vec<TimelineDiff>,
96fdf90aacd6atagen2026-09-08 08:24 UTC970
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC971
    HistoryChanged {
96fdf90aacd6atagen2026-09-08 08:24 UTC972
        timeline_id: TimelineId,
96fdf90aacd6atagen2026-09-08 08:24 UTC973
        state: HistoryState,
96fdf90aacd6atagen2026-09-08 08:24 UTC974
    },
c9f0fd0ee1ccatagen2026-10-25 06:16 UTC975
    RecentHistoryChanged {
c9f0fd0ee1ccatagen2026-10-25 06:16 UTC976
        room_id: OwnedRoomId,
c9f0fd0ee1ccatagen2026-10-25 06:16 UTC977
        state: RecentHistoryState,
c9f0fd0ee1ccatagen2026-10-25 06:16 UTC978
    },
80381e06a573atagen2026-10-25 03:02 UTC979
    HistoryRepairChanged(crate::HistoryRepairReport),
80381e06a573atagen2026-10-25 03:02 UTC980
    #[doc(hidden)]
c9f0fd0ee1ccatagen2026-10-25 06:16 UTC981
    PublicationBarrier {
c9f0fd0ee1ccatagen2026-10-25 06:16 UTC982
        #[cfg_attr(feature = "serde", serde(skip))]
c9f0fd0ee1ccatagen2026-10-25 06:16 UTC983
        acknowledgement: Option<crate::PublicationAck>,
c9f0fd0ee1ccatagen2026-10-25 06:16 UTC984
    },
0bfa3f46f0beatagen2026-09-26 09:12 UTC985
    /// the timeline was closed, or its room was left, and nothing more comes for it
0bfa3f46f0beatagen2026-09-26 09:12 UTC986
    /// until another `TimelineReset`
0bfa3f46f0beatagen2026-09-26 09:12 UTC987
    TimelineClosed {
0bfa3f46f0beatagen2026-09-26 09:12 UTC988
        timeline_id: TimelineId,
0bfa3f46f0beatagen2026-09-26 09:12 UTC989
    },
1f875b103b27atagen2026-10-25 10:44 UTC990
    /// an event context closed by something other than its own `Close`. its id answers
1f875b103b27atagen2026-10-25 10:44 UTC991
    /// `EventContextNotOpen` from now on
1f875b103b27atagen2026-10-25 10:44 UTC992
    EventContextClosed {
1f875b103b27atagen2026-10-25 10:44 UTC993
        context_id: String,
1f875b103b27atagen2026-10-25 10:44 UTC994
        reason: EventContextCloseReason,
1f875b103b27atagen2026-10-25 10:44 UTC995
    },
66db1b3cd895atagen2026-10-25 10:28 UTC996
    /// replaces whatever you had for this room's thread list, newest activity first
66db1b3cd895atagen2026-10-25 10:28 UTC997
    ThreadListReset {
66db1b3cd895atagen2026-10-25 10:28 UTC998
        room_id: OwnedRoomId,
66db1b3cd895atagen2026-10-25 10:28 UTC999
        entries: Vector<ThreadListEntry>,
66db1b3cd895atagen2026-10-25 10:28 UTC1000
    },
66db1b3cd895atagen2026-10-25 10:28 UTC1001
    /// apply each with `ThreadListEntry::upsert`
66db1b3cd895atagen2026-10-25 10:28 UTC1002
    ThreadListChanged {
66db1b3cd895atagen2026-10-25 10:28 UTC1003
        room_id: OwnedRoomId,
66db1b3cd895atagen2026-10-25 10:28 UTC1004
        upserts: Vec<ThreadListEntry>,
66db1b3cd895atagen2026-10-25 10:28 UTC1005
    },
66db1b3cd895atagen2026-10-25 10:28 UTC1006
    /// `StartReached` once the oldest thread is in
66db1b3cd895atagen2026-10-25 10:28 UTC1007
    ThreadListHistoryChanged {
66db1b3cd895atagen2026-10-25 10:28 UTC1008
        room_id: OwnedRoomId,
66db1b3cd895atagen2026-10-25 10:28 UTC1009
        state: HistoryState,
66db1b3cd895atagen2026-10-25 10:28 UTC1010
    },
74befbc72bafatagen2026-10-25 11:18 UTC1011
    /// a search closed by something other than its own `Close`. its id answers
74befbc72bafatagen2026-10-25 11:18 UTC1012
    /// `SearchNotOpen` from now on
74befbc72bafatagen2026-10-25 11:18 UTC1013
    SearchClosed {
74befbc72bafatagen2026-10-25 11:18 UTC1014
        search_id: String,
74befbc72bafatagen2026-10-25 11:18 UTC1015
        reason: crate::SearchCloseReason,
74befbc72bafatagen2026-10-25 11:18 UTC1016
    },
66db1b3cd895atagen2026-10-25 10:28 UTC1017
    /// nothing more comes for it until another `ThreadListReset`
66db1b3cd895atagen2026-10-25 10:28 UTC1018
    ThreadListClosed {
66db1b3cd895atagen2026-10-25 10:28 UTC1019
        room_id: OwnedRoomId,
60454002af5fatagen2026-10-25 11:13 UTC1020
        reason: ThreadListCloseReason,
66db1b3cd895atagen2026-10-25 10:28 UTC1021
    },
0bfa3f46f0beatagen2026-09-26 09:12 UTC1022
    /// a room that stops being watched says so with an empty `users`
96fdf90aacd6atagen2026-09-08 08:24 UTC1023
    TypingChanged(TypingState),
96fdf90aacd6atagen2026-09-08 08:24 UTC1024
    MediaUploadProgress {
96fdf90aacd6atagen2026-09-08 08:24 UTC1025
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC1026
        transaction_id: OwnedTransactionId,
96fdf90aacd6atagen2026-09-08 08:24 UTC1027
        uploaded_bytes: u64,
96fdf90aacd6atagen2026-09-08 08:24 UTC1028
        total_bytes: u64,
96fdf90aacd6atagen2026-09-08 08:24 UTC1029
        complete: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC1030
    },
0bfa3f46f0beatagen2026-09-26 09:12 UTC1031
    /// not the end of it. `will_retry` means the send queue has another go by itself,
0bfa3f46f0beatagen2026-09-26 09:12 UTC1032
    /// otherwise it waits for `retry_send` or `cancel_send`
96fdf90aacd6atagen2026-09-08 08:24 UTC1033
    MediaUploadFailed {
96fdf90aacd6atagen2026-09-08 08:24 UTC1034
        room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC1035
        transaction_id: OwnedTransactionId,
31ce2453c82fatagen2026-09-24 13:07 UTC1036
        kind: crate::ErrorKind,
0bfa3f46f0beatagen2026-09-26 09:12 UTC1037
        will_retry: bool,
0bfa3f46f0beatagen2026-09-26 09:12 UTC1038
    },
7cf348521204atagen2026-09-26 12:28 UTC1039
    /// an upload that turned up in a progress or failure event gets exactly one of
7cf348521204atagen2026-09-26 12:28 UTC1040
    /// these while the engine runs, and nothing about it after. stopping ends
7cf348521204atagen2026-09-26 12:28 UTC1041
    /// nothing, `Stopped` covers whatever is still going and the sdk resumes it next run
0bfa3f46f0beatagen2026-09-26 09:12 UTC1042
    MediaUploadFinished {
0bfa3f46f0beatagen2026-09-26 09:12 UTC1043
        room_id: OwnedRoomId,
0bfa3f46f0beatagen2026-09-26 09:12 UTC1044
        transaction_id: OwnedTransactionId,
0bfa3f46f0beatagen2026-09-26 09:12 UTC1045
        outcome: UploadOutcome,
96fdf90aacd6atagen2026-09-08 08:24 UTC1046
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC1047
    EncryptionChanged(EncryptionState),
96fdf90aacd6atagen2026-09-08 08:24 UTC1048
    VerificationChanged(VerificationState),
fa9114fcf75fatagen2026-09-24 12:51 UTC1049
    /// logout went through and the engine stops. delete the record and the store
96fdf90aacd6atagen2026-09-08 08:24 UTC1050
    LoggedOut,
96fdf90aacd6atagen2026-09-08 08:24 UTC1051
    Failed(EngineFailure),
fa9114fcf75fatagen2026-09-24 12:51 UTC1052
    /// always the last event. keep the saved record unless `LoggedOut` or a
5a52012c9b1datagen2026-09-24 23:45 UTC1053
    /// hard `SessionAccessRejected` came first. commands still in flight answer `Interrupted`
96fdf90aacd6atagen2026-09-08 08:24 UTC1054
    Stopped,
96fdf90aacd6atagen2026-09-08 08:24 UTC1055
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1056
0bfa3f46f0beatagen2026-09-26 09:12 UTC1057
#[derive(Clone, Debug, Eq, PartialEq)]
0bfa3f46f0beatagen2026-09-26 09:12 UTC1058
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
0bfa3f46f0beatagen2026-09-26 09:12 UTC1059
pub enum UploadOutcome {
0bfa3f46f0beatagen2026-09-26 09:12 UTC1060
    Sent {
0bfa3f46f0beatagen2026-09-26 09:12 UTC1061
        event_id: OwnedEventId,
0bfa3f46f0beatagen2026-09-26 09:12 UTC1062
    },
0bfa3f46f0beatagen2026-09-26 09:12 UTC1063
    Cancelled,
0bfa3f46f0beatagen2026-09-26 09:12 UTC1064
    /// its room was forgotten, and the queue with it
0bfa3f46f0beatagen2026-09-26 09:12 UTC1065
    RoomForgotten,
0bfa3f46f0beatagen2026-09-26 09:12 UTC1066
    /// the sdk's update channel overflowed while it ended, so whether it was sent is unknown
0bfa3f46f0beatagen2026-09-26 09:12 UTC1067
    Missed,
0bfa3f46f0beatagen2026-09-26 09:12 UTC1068
}
0bfa3f46f0beatagen2026-09-26 09:12 UTC1069
fe4133dbcd47atagen2026-09-26 09:05 UTC1070
/// why `Engine::run` came back, when nothing went wrong
fe4133dbcd47atagen2026-09-26 09:05 UTC1071
#[derive(Clone, Debug, Eq, PartialEq)]
fe4133dbcd47atagen2026-09-26 09:05 UTC1072
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
fe4133dbcd47atagen2026-09-26 09:05 UTC1073
pub enum Termination {
fe4133dbcd47atagen2026-09-26 09:05 UTC1074
    ShutDown,
fe4133dbcd47atagen2026-09-26 09:05 UTC1075
    /// every `ClientHandle` was dropped, so nobody could have asked for anything else
fe4133dbcd47atagen2026-09-26 09:05 UTC1076
    HandlesDropped,
fe4133dbcd47atagen2026-09-26 09:05 UTC1077
    LoggedOut,
fe4133dbcd47atagen2026-09-26 09:05 UTC1078
    /// the server rejected our token for good
fe4133dbcd47atagen2026-09-26 09:05 UTC1079
    AccessRevoked,
fe4133dbcd47atagen2026-09-26 09:05 UTC1080
    /// the server wants this device to log in again, and its e2ee keys live in the store
fe4133dbcd47atagen2026-09-26 09:05 UTC1081
    SoftLoggedOut {
fe4133dbcd47atagen2026-09-26 09:05 UTC1082
        device_id: OwnedDeviceId,
fe4133dbcd47atagen2026-09-26 09:05 UTC1083
    },
fe4133dbcd47atagen2026-09-26 09:05 UTC1084
}
fe4133dbcd47atagen2026-09-26 09:05 UTC1085
fe4133dbcd47atagen2026-09-26 09:05 UTC1086
impl Termination {
fe4133dbcd47atagen2026-09-26 09:05 UTC1087
    #[must_use]
fe4133dbcd47atagen2026-09-26 09:05 UTC1088
    pub const fn retain(&self) -> Retain {
fe4133dbcd47atagen2026-09-26 09:05 UTC1089
        match self {
fe4133dbcd47atagen2026-09-26 09:05 UTC1090
            Self::ShutDown | Self::HandlesDropped => Retain::RecordAndStore,
fe4133dbcd47atagen2026-09-26 09:05 UTC1091
            Self::SoftLoggedOut { .. } => Retain::Store,
fe4133dbcd47atagen2026-09-26 09:05 UTC1092
            Self::LoggedOut | Self::AccessRevoked => Retain::Nothing,
fe4133dbcd47atagen2026-09-26 09:05 UTC1093
        }
fe4133dbcd47atagen2026-09-26 09:05 UTC1094
    }
fe4133dbcd47atagen2026-09-26 09:05 UTC1095
}
fe4133dbcd47atagen2026-09-26 09:05 UTC1096
fe4133dbcd47atagen2026-09-26 09:05 UTC1097
/// what's still worth keeping of the saved record and the store
fe4133dbcd47atagen2026-09-26 09:05 UTC1098
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
fe4133dbcd47atagen2026-09-26 09:05 UTC1099
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
fe4133dbcd47atagen2026-09-26 09:05 UTC1100
pub enum Retain {
fe4133dbcd47atagen2026-09-26 09:05 UTC1101
    RecordAndStore,
6f1d6591c10datagen2026-09-26 09:52 UTC1102
    /// keep the store and a record naming the device to log in again as
fe4133dbcd47atagen2026-09-26 09:05 UTC1103
    Store,
fe4133dbcd47atagen2026-09-26 09:05 UTC1104
    Nothing,
fe4133dbcd47atagen2026-09-26 09:05 UTC1105
}
fe4133dbcd47atagen2026-09-26 09:05 UTC1106
96fdf90aacd6atagen2026-09-08 08:24 UTC1107
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1108
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1109
pub enum ConnectionState {
96fdf90aacd6atagen2026-09-08 08:24 UTC1110
    Idle,
96fdf90aacd6atagen2026-09-08 08:24 UTC1111
    Connecting,
96fdf90aacd6atagen2026-09-08 08:24 UTC1112
    Online,
96fdf90aacd6atagen2026-09-08 08:24 UTC1113
    Offline,
96fdf90aacd6atagen2026-09-08 08:24 UTC1114
    Stopped,
96fdf90aacd6atagen2026-09-08 08:24 UTC1115
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1116
96fdf90aacd6atagen2026-09-08 08:24 UTC1117
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1118
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1119
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1120
pub struct RoomSummary {
96fdf90aacd6atagen2026-09-08 08:24 UTC1121
    pub room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC1122
    pub name: String,
96fdf90aacd6atagen2026-09-08 08:24 UTC1123
    pub membership: RoomMembership,
e5c6427adb35atagen2026-10-25 10:23 UTC1124
    /// the main timeline's, threads have theirs in `thread_unreads`
96fdf90aacd6atagen2026-09-08 08:24 UTC1125
    pub unread_messages: u64,
e5c6427adb35atagen2026-10-25 10:23 UTC1126
    /// thread mentions included
96fdf90aacd6atagen2026-09-08 08:24 UTC1127
    pub unread_mentions: u64,
e5c6427adb35atagen2026-10-25 10:23 UTC1128
    /// unread events the push rules said to notify about, which is neither of the above.
e5c6427adb35atagen2026-10-25 10:23 UTC1129
    /// the main timeline's
5a52012c9b1datagen2026-09-24 23:45 UTC1130
    pub unread_notifications: u64,
e5c6427adb35atagen2026-10-25 10:23 UTC1131
    /// threads with anything unread, by root
e5c6427adb35atagen2026-10-25 10:23 UTC1132
    pub thread_unreads: BTreeMap<OwnedEventId, ThreadUnread>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1133
    pub encrypted: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC1134
    pub space: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC1135
    pub direct: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC1136
    pub favourite: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC1137
    pub low_priority: bool,
5d2974de5826atagen2026-10-08 11:29 UTC1138
    pub avatar: Option<MediaId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1139
    pub latest_event_timestamp_ms: Option<u64>,
31ce2453c82fatagen2026-09-24 13:07 UTC1140
    pub latest_event: Option<LatestEvent>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1141
    pub notification_mode: Option<RoomNotificationMode>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1142
    pub notification_mode_custom: bool,
31ce2453c82fatagen2026-09-24 13:07 UTC1143
    pub topic: Option<String>,
31ce2453c82fatagen2026-09-24 13:07 UTC1144
    pub canonical_alias: Option<OwnedRoomAliasId>,
31ce2453c82fatagen2026-09-24 13:07 UTC1145
    pub joined_members: u64,
31ce2453c82fatagen2026-09-24 13:07 UTC1146
    pub invited_members: u64,
31ce2453c82fatagen2026-09-24 13:07 UTC1147
    /// who a nameless room gets named after
31ce2453c82fatagen2026-09-24 13:07 UTC1148
    pub heroes: Vec<RoomHero>,
31ce2453c82fatagen2026-09-24 13:07 UTC1149
    /// set once the room has been upgraded, this is where everyone went
31ce2453c82fatagen2026-09-24 13:07 UTC1150
    pub successor: Option<OwnedRoomId>,
31ce2453c82fatagen2026-09-24 13:07 UTC1151
    pub inviter: Option<OwnedUserId>,
31ce2453c82fatagen2026-09-24 13:07 UTC1152
    /// joined spaces that list this room as a child
31ce2453c82fatagen2026-09-24 13:07 UTC1153
    pub parent_spaces: Vec<OwnedRoomId>,
31ce2453c82fatagen2026-09-24 13:07 UTC1154
    /// for a space, the children it lists, joined or not
31ce2453c82fatagen2026-09-24 13:07 UTC1155
    pub children: Vec<OwnedRoomId>,
9bd34e25bb86atagen2026-10-24 07:23 UTC1156
    /// a space's msc3230 order. ordered spaces sort first by (order, room id), the rest by room id
9bd34e25bb86atagen2026-10-24 07:23 UTC1157
    pub space_order: Option<String>,
fa51490b6ae9atagen2026-10-24 08:41 UTC1158
    /// you can send im.ponies.room_emotes here, so you can make and edit its packs
fa51490b6ae9atagen2026-10-24 08:41 UTC1159
    pub can_edit_packs: bool,
fa5b4e09943aatagen2026-10-24 09:33 UTC1160
    /// m.room.pinned_events in order, the newest pin last
fa5b4e09943aatagen2026-10-24 09:33 UTC1161
    pub pinned_events: Vec<OwnedEventId>,
fa5b4e09943aatagen2026-10-24 09:33 UTC1162
    pub can_pin: bool,
31ce2453c82fatagen2026-09-24 13:07 UTC1163
}
31ce2453c82fatagen2026-09-24 13:07 UTC1164
e5c6427adb35atagen2026-10-25 10:23 UTC1165
#[derive(Clone, Copy, Debug, Default, Eq, PartialEq)]
e5c6427adb35atagen2026-10-25 10:23 UTC1166
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
e5c6427adb35atagen2026-10-25 10:23 UTC1167
#[non_exhaustive]
e5c6427adb35atagen2026-10-25 10:23 UTC1168
pub struct ThreadUnread {
e5c6427adb35atagen2026-10-25 10:23 UTC1169
    pub messages: u64,
e5c6427adb35atagen2026-10-25 10:23 UTC1170
    pub mentions: u64,
e5c6427adb35atagen2026-10-25 10:23 UTC1171
    pub notifications: u64,
e5c6427adb35atagen2026-10-25 10:23 UTC1172
}
e5c6427adb35atagen2026-10-25 10:23 UTC1173
31ce2453c82fatagen2026-09-24 13:07 UTC1174
#[derive(Clone, Debug, Eq, PartialEq)]
31ce2453c82fatagen2026-09-24 13:07 UTC1175
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC1176
#[non_exhaustive]
31ce2453c82fatagen2026-09-24 13:07 UTC1177
pub struct RoomHero {
31ce2453c82fatagen2026-09-24 13:07 UTC1178
    pub user_id: OwnedUserId,
31ce2453c82fatagen2026-09-24 13:07 UTC1179
    pub display_name: Option<String>,
5d2974de5826atagen2026-10-08 11:29 UTC1180
    pub avatar: Option<MediaId>,
31ce2453c82fatagen2026-09-24 13:07 UTC1181
}
31ce2453c82fatagen2026-09-24 13:07 UTC1182
5a52012c9b1datagen2026-09-24 23:45 UTC1183
/// enough for a room list preview line. `kind` and `body` are only set for messages,
5a52012c9b1datagen2026-09-24 23:45 UTC1184
/// and an edit shows its new text
31ce2453c82fatagen2026-09-24 13:07 UTC1185
#[derive(Clone, Debug, Eq, PartialEq)]
31ce2453c82fatagen2026-09-24 13:07 UTC1186
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC1187
#[non_exhaustive]
31ce2453c82fatagen2026-09-24 13:07 UTC1188
pub struct LatestEvent {
31ce2453c82fatagen2026-09-24 13:07 UTC1189
    pub sender: Option<OwnedUserId>,
5a52012c9b1datagen2026-09-24 23:45 UTC1190
    pub kind: Option<MessageKind>,
31ce2453c82fatagen2026-09-24 13:07 UTC1191
    pub body: Option<String>,
31ce2453c82fatagen2026-09-24 13:07 UTC1192
    pub timestamp_ms: Option<u64>,
31ce2453c82fatagen2026-09-24 13:07 UTC1193
    pub send_state: SendState,
31ce2453c82fatagen2026-09-24 13:07 UTC1194
}
31ce2453c82fatagen2026-09-24 13:07 UTC1195
31ce2453c82fatagen2026-09-24 13:07 UTC1196
#[derive(Clone, Debug, Eq, PartialEq)]
31ce2453c82fatagen2026-09-24 13:07 UTC1197
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC1198
#[non_exhaustive]
31ce2453c82fatagen2026-09-24 13:07 UTC1199
pub struct Profile {
31ce2453c82fatagen2026-09-24 13:07 UTC1200
    pub user_id: OwnedUserId,
31ce2453c82fatagen2026-09-24 13:07 UTC1201
    pub display_name: Option<String>,
5d2974de5826atagen2026-10-08 11:29 UTC1202
    pub avatar: Option<MediaId>,
31ce2453c82fatagen2026-09-24 13:07 UTC1203
}
31ce2453c82fatagen2026-09-24 13:07 UTC1204
31ce2453c82fatagen2026-09-24 13:07 UTC1205
/// 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 UTC1206
#[derive(Clone, Debug, Eq, PartialEq)]
31ce2453c82fatagen2026-09-24 13:07 UTC1207
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC1208
#[non_exhaustive]
31ce2453c82fatagen2026-09-24 13:07 UTC1209
pub struct SpaceChild {
31ce2453c82fatagen2026-09-24 13:07 UTC1210
    pub room_id: OwnedRoomId,
31ce2453c82fatagen2026-09-24 13:07 UTC1211
    pub name: String,
31ce2453c82fatagen2026-09-24 13:07 UTC1212
    pub topic: Option<String>,
5d2974de5826atagen2026-10-08 11:29 UTC1213
    pub avatar: Option<MediaId>,
31ce2453c82fatagen2026-09-24 13:07 UTC1214
    pub canonical_alias: Option<OwnedRoomAliasId>,
31ce2453c82fatagen2026-09-24 13:07 UTC1215
    pub joined_members: u64,
31ce2453c82fatagen2026-09-24 13:07 UTC1216
    pub space: bool,
31ce2453c82fatagen2026-09-24 13:07 UTC1217
    pub children_count: u64,
31ce2453c82fatagen2026-09-24 13:07 UTC1218
    pub membership: Option<RoomMembership>,
31ce2453c82fatagen2026-09-24 13:07 UTC1219
    pub via: Vec<OwnedServerName>,
31ce2453c82fatagen2026-09-24 13:07 UTC1220
    pub suggested: bool,
31ce2453c82fatagen2026-09-24 13:07 UTC1221
    pub world_readable: Option<bool>,
31ce2453c82fatagen2026-09-24 13:07 UTC1222
    pub guest_can_join: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC1223
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1224
96fdf90aacd6atagen2026-09-08 08:24 UTC1225
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1226
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1227
pub enum RoomNotificationMode {
96fdf90aacd6atagen2026-09-08 08:24 UTC1228
    AllMessages,
96fdf90aacd6atagen2026-09-08 08:24 UTC1229
    MentionsAndKeywordsOnly,
96fdf90aacd6atagen2026-09-08 08:24 UTC1230
    Mute,
96fdf90aacd6atagen2026-09-08 08:24 UTC1231
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1232
96fdf90aacd6atagen2026-09-08 08:24 UTC1233
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1234
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1235
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1236
pub struct RoomNotificationSettings {
96fdf90aacd6atagen2026-09-08 08:24 UTC1237
    pub mode: RoomNotificationMode,
96fdf90aacd6atagen2026-09-08 08:24 UTC1238
    pub custom: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC1239
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1240
96fdf90aacd6atagen2026-09-08 08:24 UTC1241
#[derive(Clone, Debug)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1242
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1243
pub enum PushNotificationStatus {
96fdf90aacd6atagen2026-09-08 08:24 UTC1244
    Event(Box<PushNotification>),
96fdf90aacd6atagen2026-09-08 08:24 UTC1245
    NotFound,
96fdf90aacd6atagen2026-09-08 08:24 UTC1246
    FilteredOut,
96fdf90aacd6atagen2026-09-08 08:24 UTC1247
    Redacted,
96fdf90aacd6atagen2026-09-08 08:24 UTC1248
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1249
96fdf90aacd6atagen2026-09-08 08:24 UTC1250
#[derive(Clone, Debug)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1251
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1252
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1253
pub struct PushNotification {
96fdf90aacd6atagen2026-09-08 08:24 UTC1254
    pub event_id: OwnedEventId,
96fdf90aacd6atagen2026-09-08 08:24 UTC1255
    pub event: PushNotificationEvent,
96fdf90aacd6atagen2026-09-08 08:24 UTC1256
    pub sender: PushNotificationSender,
96fdf90aacd6atagen2026-09-08 08:24 UTC1257
    pub room: PushNotificationRoom,
96fdf90aacd6atagen2026-09-08 08:24 UTC1258
    pub noisy: Option<bool>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1259
    pub has_mention: Option<bool>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1260
    pub thread_id: Option<OwnedEventId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1261
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1262
96fdf90aacd6atagen2026-09-08 08:24 UTC1263
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1264
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1265
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1266
pub struct PushNotificationSender {
96fdf90aacd6atagen2026-09-08 08:24 UTC1267
    pub user_id: OwnedUserId,
96fdf90aacd6atagen2026-09-08 08:24 UTC1268
    pub display_name: Option<String>,
5d2974de5826atagen2026-10-08 11:29 UTC1269
    pub avatar_url: Option<MediaId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1270
    pub name_ambiguous: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC1271
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1272
96fdf90aacd6atagen2026-09-08 08:24 UTC1273
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1274
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1275
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1276
pub struct PushNotificationRoom {
96fdf90aacd6atagen2026-09-08 08:24 UTC1277
    pub room_id: OwnedRoomId,
2006a11ce142atagen2026-10-26 04:02 UTC1278
    /// from this session's store, so `None` for a room it hasn't synced yet
2006a11ce142atagen2026-10-26 04:02 UTC1279
    pub unread_notifications: Option<u64>,
2006a11ce142atagen2026-10-26 04:02 UTC1280
    pub unread_mentions: Option<u64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1281
    pub name: String,
5d2974de5826atagen2026-10-08 11:29 UTC1282
    pub avatar_url: Option<MediaId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1283
    pub canonical_alias: Option<OwnedRoomAliasId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1284
    pub topic: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1285
    pub encrypted: Option<bool>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1286
    pub direct: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC1287
    pub joined_members_count: u64,
96fdf90aacd6atagen2026-09-08 08:24 UTC1288
    pub service_members: Vec<OwnedUserId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1289
    pub active_service_members_count: u64,
96fdf90aacd6atagen2026-09-08 08:24 UTC1290
    pub space: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC1291
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1292
96fdf90aacd6atagen2026-09-08 08:24 UTC1293
#[derive(Clone, Debug)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1294
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1295
pub enum PushNotificationEvent {
96fdf90aacd6atagen2026-09-08 08:24 UTC1296
    Timeline(Raw<AnySyncTimelineEvent>),
96fdf90aacd6atagen2026-09-08 08:24 UTC1297
    Invite(Raw<StrippedRoomMemberEvent>),
96fdf90aacd6atagen2026-09-08 08:24 UTC1298
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1299
96fdf90aacd6atagen2026-09-08 08:24 UTC1300
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1301
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1302
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1303
pub struct RoomPowerLevels {
96fdf90aacd6atagen2026-09-08 08:24 UTC1304
    pub ban: i64,
96fdf90aacd6atagen2026-09-08 08:24 UTC1305
    pub invite: i64,
96fdf90aacd6atagen2026-09-08 08:24 UTC1306
    pub kick: i64,
96fdf90aacd6atagen2026-09-08 08:24 UTC1307
    pub redact: i64,
96fdf90aacd6atagen2026-09-08 08:24 UTC1308
    pub events_default: i64,
96fdf90aacd6atagen2026-09-08 08:24 UTC1309
    pub state_default: i64,
96fdf90aacd6atagen2026-09-08 08:24 UTC1310
    pub users_default: i64,
96fdf90aacd6atagen2026-09-08 08:24 UTC1311
    pub room_notification: i64,
96fdf90aacd6atagen2026-09-08 08:24 UTC1312
    pub users: Vec<(OwnedUserId, i64)>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1313
    pub events: Vec<(String, i64)>,
5a52012c9b1datagen2026-09-24 23:45 UTC1314
    /// in rooms from version 12 the creators outrank everyone and aren't listed in `users`
5a52012c9b1datagen2026-09-24 23:45 UTC1315
    pub creators: Vec<OwnedUserId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1316
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1317
96fdf90aacd6atagen2026-09-08 08:24 UTC1318
#[derive(Clone, Debug, Default, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1319
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1320
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1321
pub struct PowerLevelChanges {
96fdf90aacd6atagen2026-09-08 08:24 UTC1322
    pub ban: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1323
    pub invite: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1324
    pub kick: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1325
    pub redact: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1326
    pub events_default: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1327
    pub state_default: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1328
    pub users_default: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1329
    pub room_notification: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1330
    pub room_name: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1331
    pub room_avatar: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1332
    pub room_topic: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1333
    pub space_child: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1334
    pub beacon: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1335
    pub beacon_info: Option<i64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1336
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1337
96fdf90aacd6atagen2026-09-08 08:24 UTC1338
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1339
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1340
pub enum RoomMembership {
96fdf90aacd6atagen2026-09-08 08:24 UTC1341
    Joined,
96fdf90aacd6atagen2026-09-08 08:24 UTC1342
    Invited,
96fdf90aacd6atagen2026-09-08 08:24 UTC1343
    Left,
96fdf90aacd6atagen2026-09-08 08:24 UTC1344
    Knocked,
96fdf90aacd6atagen2026-09-08 08:24 UTC1345
    Banned,
96fdf90aacd6atagen2026-09-08 08:24 UTC1346
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1347
96fdf90aacd6atagen2026-09-08 08:24 UTC1348
#[derive(Clone, Debug, Default, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1349
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1350
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1351
pub struct RoomListFilter {
96fdf90aacd6atagen2026-09-08 08:24 UTC1352
    pub membership: Option<RoomMembership>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1353
    pub category: Option<RoomCategory>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1354
    pub favourite: Option<bool>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1355
    pub unread_only: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC1356
    pub search: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1357
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1358
96fdf90aacd6atagen2026-09-08 08:24 UTC1359
impl RoomListFilter {
96fdf90aacd6atagen2026-09-08 08:24 UTC1360
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC1361
    pub fn with_membership(mut self, membership: RoomMembership) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC1362
        self.membership = Some(membership);
96fdf90aacd6atagen2026-09-08 08:24 UTC1363
        self
96fdf90aacd6atagen2026-09-08 08:24 UTC1364
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC1365
96fdf90aacd6atagen2026-09-08 08:24 UTC1366
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC1367
    pub fn with_category(mut self, category: RoomCategory) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC1368
        self.category = Some(category);
96fdf90aacd6atagen2026-09-08 08:24 UTC1369
        self
96fdf90aacd6atagen2026-09-08 08:24 UTC1370
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC1371
96fdf90aacd6atagen2026-09-08 08:24 UTC1372
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC1373
    pub fn with_favourite(mut self, favourite: bool) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC1374
        self.favourite = Some(favourite);
96fdf90aacd6atagen2026-09-08 08:24 UTC1375
        self
96fdf90aacd6atagen2026-09-08 08:24 UTC1376
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC1377
96fdf90aacd6atagen2026-09-08 08:24 UTC1378
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC1379
    pub const fn with_unread_only(mut self, unread_only: bool) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC1380
        self.unread_only = unread_only;
96fdf90aacd6atagen2026-09-08 08:24 UTC1381
        self
96fdf90aacd6atagen2026-09-08 08:24 UTC1382
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC1383
96fdf90aacd6atagen2026-09-08 08:24 UTC1384
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC1385
    pub fn with_search(mut self, search: impl Into<String>) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC1386
        self.search = Some(search.into());
96fdf90aacd6atagen2026-09-08 08:24 UTC1387
        self
96fdf90aacd6atagen2026-09-08 08:24 UTC1388
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC1389
96fdf90aacd6atagen2026-09-08 08:24 UTC1390
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC1391
    pub fn matches(&self, room: &RoomSummary) -> bool {
31ce2453c82fatagen2026-09-24 13:07 UTC1392
        self.matcher().matches(room)
31ce2453c82fatagen2026-09-24 13:07 UTC1393
    }
31ce2453c82fatagen2026-09-24 13:07 UTC1394
31ce2453c82fatagen2026-09-24 13:07 UTC1395
    /// lowercases the search once, for filtering a whole list
31ce2453c82fatagen2026-09-24 13:07 UTC1396
    #[must_use]
31ce2453c82fatagen2026-09-24 13:07 UTC1397
    pub fn matcher(&self) -> RoomMatcher<'_> {
31ce2453c82fatagen2026-09-24 13:07 UTC1398
        RoomMatcher {
31ce2453c82fatagen2026-09-24 13:07 UTC1399
            filter: self,
31ce2453c82fatagen2026-09-24 13:07 UTC1400
            search: self.search.as_deref().map(str::to_lowercase),
31ce2453c82fatagen2026-09-24 13:07 UTC1401
        }
31ce2453c82fatagen2026-09-24 13:07 UTC1402
    }
31ce2453c82fatagen2026-09-24 13:07 UTC1403
}
31ce2453c82fatagen2026-09-24 13:07 UTC1404
31ce2453c82fatagen2026-09-24 13:07 UTC1405
#[derive(Debug)]
31ce2453c82fatagen2026-09-24 13:07 UTC1406
pub struct RoomMatcher<'a> {
31ce2453c82fatagen2026-09-24 13:07 UTC1407
    filter: &'a RoomListFilter,
31ce2453c82fatagen2026-09-24 13:07 UTC1408
    search: Option<String>,
31ce2453c82fatagen2026-09-24 13:07 UTC1409
}
31ce2453c82fatagen2026-09-24 13:07 UTC1410
31ce2453c82fatagen2026-09-24 13:07 UTC1411
impl RoomMatcher<'_> {
31ce2453c82fatagen2026-09-24 13:07 UTC1412
    #[must_use]
31ce2453c82fatagen2026-09-24 13:07 UTC1413
    pub fn matches(&self, room: &RoomSummary) -> bool {
31ce2453c82fatagen2026-09-24 13:07 UTC1414
        let filter = self.filter;
31ce2453c82fatagen2026-09-24 13:07 UTC1415
        filter
31ce2453c82fatagen2026-09-24 13:07 UTC1416
            .membership
96fdf90aacd6atagen2026-09-08 08:24 UTC1417
            .is_none_or(|membership| room.membership == membership)
31ce2453c82fatagen2026-09-24 13:07 UTC1418
            && filter.category.is_none_or(|category| match category {
96fdf90aacd6atagen2026-09-08 08:24 UTC1419
                RoomCategory::People => room.direct && !room.space,
96fdf90aacd6atagen2026-09-08 08:24 UTC1420
                RoomCategory::Rooms => !room.direct && !room.space,
96fdf90aacd6atagen2026-09-08 08:24 UTC1421
                RoomCategory::Spaces => room.space,
96fdf90aacd6atagen2026-09-08 08:24 UTC1422
            })
31ce2453c82fatagen2026-09-24 13:07 UTC1423
            && filter
96fdf90aacd6atagen2026-09-08 08:24 UTC1424
                .favourite
96fdf90aacd6atagen2026-09-08 08:24 UTC1425
                .is_none_or(|favourite| room.favourite == favourite)
31ce2453c82fatagen2026-09-24 13:07 UTC1426
            && (!filter.unread_only || room.unread_messages > 0 || room.unread_mentions > 0)
96fdf90aacd6atagen2026-09-08 08:24 UTC1427
            && self.search.as_ref().is_none_or(|search| {
31ce2453c82fatagen2026-09-24 13:07 UTC1428
                room.name.to_lowercase().contains(search)
31ce2453c82fatagen2026-09-24 13:07 UTC1429
                    || room.room_id.as_str().to_lowercase().contains(search)
96fdf90aacd6atagen2026-09-08 08:24 UTC1430
            })
96fdf90aacd6atagen2026-09-08 08:24 UTC1431
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC1432
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1433
96fdf90aacd6atagen2026-09-08 08:24 UTC1434
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1435
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
5a52012c9b1datagen2026-09-24 23:45 UTC1436
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1437
pub enum RoomCategory {
96fdf90aacd6atagen2026-09-08 08:24 UTC1438
    People,
96fdf90aacd6atagen2026-09-08 08:24 UTC1439
    Rooms,
96fdf90aacd6atagen2026-09-08 08:24 UTC1440
    Spaces,
96fdf90aacd6atagen2026-09-08 08:24 UTC1441
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1442
96fdf90aacd6atagen2026-09-08 08:24 UTC1443
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1444
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
5a52012c9b1datagen2026-09-24 23:45 UTC1445
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1446
pub enum MemberFilter {
96fdf90aacd6atagen2026-09-08 08:24 UTC1447
    Active,
96fdf90aacd6atagen2026-09-08 08:24 UTC1448
    Joined,
96fdf90aacd6atagen2026-09-08 08:24 UTC1449
    Invited,
5a52012c9b1datagen2026-09-24 23:45 UTC1450
    Banned,
5a52012c9b1datagen2026-09-24 23:45 UTC1451
    Left,
96fdf90aacd6atagen2026-09-08 08:24 UTC1452
    All,
96fdf90aacd6atagen2026-09-08 08:24 UTC1453
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1454
96fdf90aacd6atagen2026-09-08 08:24 UTC1455
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1456
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1457
pub enum MemberMembership {
96fdf90aacd6atagen2026-09-08 08:24 UTC1458
    Joined,
96fdf90aacd6atagen2026-09-08 08:24 UTC1459
    Invited,
96fdf90aacd6atagen2026-09-08 08:24 UTC1460
    Left,
96fdf90aacd6atagen2026-09-08 08:24 UTC1461
    Knocked,
96fdf90aacd6atagen2026-09-08 08:24 UTC1462
    Banned,
96fdf90aacd6atagen2026-09-08 08:24 UTC1463
    Custom(String),
96fdf90aacd6atagen2026-09-08 08:24 UTC1464
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1465
96fdf90aacd6atagen2026-09-08 08:24 UTC1466
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1467
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1468
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1469
pub struct MemberSummary {
96fdf90aacd6atagen2026-09-08 08:24 UTC1470
    pub user_id: OwnedUserId,
96fdf90aacd6atagen2026-09-08 08:24 UTC1471
    pub name: String,
96fdf90aacd6atagen2026-09-08 08:24 UTC1472
    pub display_name: Option<String>,
5d2974de5826atagen2026-10-08 11:29 UTC1473
    pub avatar: Option<MediaId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1474
    pub membership: MemberMembership,
96fdf90aacd6atagen2026-09-08 08:24 UTC1475
    pub own: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC1476
    pub name_ambiguous: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC1477
    pub ignored: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC1478
    pub service: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC1479
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1480
96fdf90aacd6atagen2026-09-08 08:24 UTC1481
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1482
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1483
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1484
pub struct OwnDevice {
96fdf90aacd6atagen2026-09-08 08:24 UTC1485
    pub device_id: OwnedDeviceId,
96fdf90aacd6atagen2026-09-08 08:24 UTC1486
    pub display_name: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1487
    pub last_seen_ip: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1488
    pub last_seen_timestamp_ms: Option<u64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1489
    pub current: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC1490
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1491
96fdf90aacd6atagen2026-09-08 08:24 UTC1492
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1493
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1494
pub enum TimelineItem {
960ac0721079atagen2026-09-25 00:24 UTC1495
    Event(Box<TimelineEvent>),
c9f0fd0ee1ccatagen2026-10-25 06:16 UTC1496
    HistoryGap(crate::HistoryGap),
96fdf90aacd6atagen2026-09-08 08:24 UTC1497
    DayDivider { timestamp_ms: u64 },
96fdf90aacd6atagen2026-09-08 08:24 UTC1498
    ReadMarker,
96fdf90aacd6atagen2026-09-08 08:24 UTC1499
    TimelineStart,
96fdf90aacd6atagen2026-09-08 08:24 UTC1500
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1501
96fdf90aacd6atagen2026-09-08 08:24 UTC1502
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1503
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1504
pub enum TimelineDiff {
96fdf90aacd6atagen2026-09-08 08:24 UTC1505
    Append { values: Vec<TimelineItem> },
96fdf90aacd6atagen2026-09-08 08:24 UTC1506
    Clear,
96fdf90aacd6atagen2026-09-08 08:24 UTC1507
    PushFront { value: TimelineItem },
96fdf90aacd6atagen2026-09-08 08:24 UTC1508
    PushBack { value: TimelineItem },
96fdf90aacd6atagen2026-09-08 08:24 UTC1509
    PopFront,
96fdf90aacd6atagen2026-09-08 08:24 UTC1510
    PopBack,
96fdf90aacd6atagen2026-09-08 08:24 UTC1511
    Insert { index: usize, value: TimelineItem },
96fdf90aacd6atagen2026-09-08 08:24 UTC1512
    Set { index: usize, value: TimelineItem },
96fdf90aacd6atagen2026-09-08 08:24 UTC1513
    Remove { index: usize },
96fdf90aacd6atagen2026-09-08 08:24 UTC1514
    Truncate { length: usize },
96fdf90aacd6atagen2026-09-08 08:24 UTC1515
    Reset { values: Vec<TimelineItem> },
96fdf90aacd6atagen2026-09-08 08:24 UTC1516
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1517
96fdf90aacd6atagen2026-09-08 08:24 UTC1518
#[derive(Clone, Copy, Debug, Eq, PartialEq, thiserror::Error)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1519
#[error("timeline diff is incompatible with the current {length}-item snapshot")]
96fdf90aacd6atagen2026-09-08 08:24 UTC1520
pub struct TimelineDiffError {
96fdf90aacd6atagen2026-09-08 08:24 UTC1521
    pub length: usize,
96fdf90aacd6atagen2026-09-08 08:24 UTC1522
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1523
96fdf90aacd6atagen2026-09-08 08:24 UTC1524
impl TimelineDiff {
96fdf90aacd6atagen2026-09-08 08:24 UTC1525
    /// Apply a diff only when its indices match the current snapshot.
96fdf90aacd6atagen2026-09-08 08:24 UTC1526
    /// On error the snapshot is unchanged; request `TimelineCommand::Resync`
96fdf90aacd6atagen2026-09-08 08:24 UTC1527
    /// and ignore further diffs until the corresponding `TimelineReset`.
d5d8097c3afdatagen2026-09-26 09:33 UTC1528
    pub fn try_apply(self, items: &mut Vector<TimelineItem>) -> Result<(), TimelineDiffError> {
96fdf90aacd6atagen2026-09-08 08:24 UTC1529
        let length = items.len();
d5d8097c3afdatagen2026-09-26 09:33 UTC1530
        if self.length_after(length).is_none() {
d5d8097c3afdatagen2026-09-26 09:33 UTC1531
            return Err(TimelineDiffError { length });
d5d8097c3afdatagen2026-09-26 09:33 UTC1532
        }
d5d8097c3afdatagen2026-09-26 09:33 UTC1533
        self.apply(items);
d5d8097c3afdatagen2026-09-26 09:33 UTC1534
        Ok(())
d5d8097c3afdatagen2026-09-26 09:33 UTC1535
    }
d5d8097c3afdatagen2026-09-26 09:33 UTC1536
d5d8097c3afdatagen2026-09-26 09:33 UTC1537
    /// a whole `TimelineChanged` or none of it. whether a diff fits depends only on the
d5d8097c3afdatagen2026-09-26 09:33 UTC1538
    /// length before it, so the batch is checked against lengths alone before anything
d5d8097c3afdatagen2026-09-26 09:33 UTC1539
    /// moves. the error carries the length the snapshot would have had at the misfit
d5d8097c3afdatagen2026-09-26 09:33 UTC1540
    pub fn try_apply_all(
d5d8097c3afdatagen2026-09-26 09:33 UTC1541
        diffs: Vec<Self>,
d5d8097c3afdatagen2026-09-26 09:33 UTC1542
        items: &mut Vector<TimelineItem>,
d5d8097c3afdatagen2026-09-26 09:33 UTC1543
    ) -> Result<(), TimelineDiffError> {
d5d8097c3afdatagen2026-09-26 09:33 UTC1544
        diffs.iter().try_fold(items.len(), |length, diff| {
d5d8097c3afdatagen2026-09-26 09:33 UTC1545
            diff.length_after(length)
d5d8097c3afdatagen2026-09-26 09:33 UTC1546
                .ok_or(TimelineDiffError { length })
d5d8097c3afdatagen2026-09-26 09:33 UTC1547
        })?;
d5d8097c3afdatagen2026-09-26 09:33 UTC1548
        for diff in diffs {
d5d8097c3afdatagen2026-09-26 09:33 UTC1549
            diff.apply(items);
d5d8097c3afdatagen2026-09-26 09:33 UTC1550
        }
d5d8097c3afdatagen2026-09-26 09:33 UTC1551
        Ok(())
d5d8097c3afdatagen2026-09-26 09:33 UTC1552
    }
d5d8097c3afdatagen2026-09-26 09:33 UTC1553
d5d8097c3afdatagen2026-09-26 09:33 UTC1554
    fn length_after(&self, length: usize) -> Option<usize> {
d5d8097c3afdatagen2026-09-26 09:33 UTC1555
        match self {
d5d8097c3afdatagen2026-09-26 09:33 UTC1556
            Self::Append { values } => Some(length + values.len()),
d5d8097c3afdatagen2026-09-26 09:33 UTC1557
            Self::Clear => Some(0),
d5d8097c3afdatagen2026-09-26 09:33 UTC1558
            Self::PushFront { .. } | Self::PushBack { .. } => Some(length + 1),
d5d8097c3afdatagen2026-09-26 09:33 UTC1559
            Self::PopFront | Self::PopBack => length.checked_sub(1),
d5d8097c3afdatagen2026-09-26 09:33 UTC1560
            Self::Insert { index, .. } => (*index <= length).then_some(length + 1),
d5d8097c3afdatagen2026-09-26 09:33 UTC1561
            Self::Set { index, .. } => (*index < length).then_some(length),
d5d8097c3afdatagen2026-09-26 09:33 UTC1562
            Self::Remove { index } => (*index < length).then(|| length - 1),
d5d8097c3afdatagen2026-09-26 09:33 UTC1563
            Self::Truncate { length: target } => (*target <= length).then_some(*target),
d5d8097c3afdatagen2026-09-26 09:33 UTC1564
            Self::Reset { values } => Some(values.len()),
d5d8097c3afdatagen2026-09-26 09:33 UTC1565
        }
d5d8097c3afdatagen2026-09-26 09:33 UTC1566
    }
d5d8097c3afdatagen2026-09-26 09:33 UTC1567
d5d8097c3afdatagen2026-09-26 09:33 UTC1568
    fn apply(self, items: &mut Vector<TimelineItem>) {
96fdf90aacd6atagen2026-09-08 08:24 UTC1569
        match self {
96fdf90aacd6atagen2026-09-08 08:24 UTC1570
            Self::Append { values } => items.extend(values),
96fdf90aacd6atagen2026-09-08 08:24 UTC1571
            Self::Clear => items.clear(),
d5d8097c3afdatagen2026-09-26 09:33 UTC1572
            Self::PushFront { value } => items.push_front(value),
d5d8097c3afdatagen2026-09-26 09:33 UTC1573
            Self::PushBack { value } => items.push_back(value),
96fdf90aacd6atagen2026-09-08 08:24 UTC1574
            Self::PopFront => {
d5d8097c3afdatagen2026-09-26 09:33 UTC1575
                items.pop_front();
96fdf90aacd6atagen2026-09-08 08:24 UTC1576
            }
96fdf90aacd6atagen2026-09-08 08:24 UTC1577
            Self::PopBack => {
d5d8097c3afdatagen2026-09-26 09:33 UTC1578
                items.pop_back();
96fdf90aacd6atagen2026-09-08 08:24 UTC1579
            }
96fdf90aacd6atagen2026-09-08 08:24 UTC1580
            Self::Insert { index, value } => items.insert(index, value),
d5d8097c3afdatagen2026-09-26 09:33 UTC1581
            Self::Set { index, value } => {
d5d8097c3afdatagen2026-09-26 09:33 UTC1582
                items.set(index, value);
d5d8097c3afdatagen2026-09-26 09:33 UTC1583
            }
96fdf90aacd6atagen2026-09-08 08:24 UTC1584
            Self::Remove { index } => {
96fdf90aacd6atagen2026-09-08 08:24 UTC1585
                items.remove(index);
96fdf90aacd6atagen2026-09-08 08:24 UTC1586
            }
96fdf90aacd6atagen2026-09-08 08:24 UTC1587
            Self::Truncate { length } => items.truncate(length),
d5d8097c3afdatagen2026-09-26 09:33 UTC1588
            Self::Reset { values } => *items = values.into_iter().collect(),
96fdf90aacd6atagen2026-09-08 08:24 UTC1589
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC1590
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC1591
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1592
96fdf90aacd6atagen2026-09-08 08:24 UTC1593
#[cfg(test)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1594
mod tests {
d5d8097c3afdatagen2026-09-26 09:33 UTC1595
    use imbl::{Vector, vector};
d5d8097c3afdatagen2026-09-26 09:33 UTC1596
96fdf90aacd6atagen2026-09-08 08:24 UTC1597
    use super::{TimelineDiff, TimelineItem};
96fdf90aacd6atagen2026-09-08 08:24 UTC1598
96fdf90aacd6atagen2026-09-08 08:24 UTC1599
    fn item(timestamp_ms: u64) -> TimelineItem {
96fdf90aacd6atagen2026-09-08 08:24 UTC1600
        TimelineItem::DayDivider { timestamp_ms }
96fdf90aacd6atagen2026-09-08 08:24 UTC1601
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC1602
96fdf90aacd6atagen2026-09-08 08:24 UTC1603
    #[test]
96fdf90aacd6atagen2026-09-08 08:24 UTC1604
    fn timeline_diff_try_apply_handles_every_variant() {
d5d8097c3afdatagen2026-09-26 09:33 UTC1605
        let mut items = vector![item(1), item(2)];
96fdf90aacd6atagen2026-09-08 08:24 UTC1606
96fdf90aacd6atagen2026-09-08 08:24 UTC1607
        TimelineDiff::Append {
96fdf90aacd6atagen2026-09-08 08:24 UTC1608
            values: vec![item(3)],
96fdf90aacd6atagen2026-09-08 08:24 UTC1609
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC1610
        .try_apply(&mut items)
96fdf90aacd6atagen2026-09-08 08:24 UTC1611
        .unwrap();
d5d8097c3afdatagen2026-09-26 09:33 UTC1612
        assert_eq!(items, vector![item(1), item(2), item(3)]);
96fdf90aacd6atagen2026-09-08 08:24 UTC1613
96fdf90aacd6atagen2026-09-08 08:24 UTC1614
        TimelineDiff::Clear.try_apply(&mut items).unwrap();
96fdf90aacd6atagen2026-09-08 08:24 UTC1615
        assert!(items.is_empty());
96fdf90aacd6atagen2026-09-08 08:24 UTC1616
96fdf90aacd6atagen2026-09-08 08:24 UTC1617
        TimelineDiff::PushFront { value: item(2) }
96fdf90aacd6atagen2026-09-08 08:24 UTC1618
            .try_apply(&mut items)
96fdf90aacd6atagen2026-09-08 08:24 UTC1619
            .unwrap();
96fdf90aacd6atagen2026-09-08 08:24 UTC1620
        TimelineDiff::PushBack { value: item(3) }
96fdf90aacd6atagen2026-09-08 08:24 UTC1621
            .try_apply(&mut items)
96fdf90aacd6atagen2026-09-08 08:24 UTC1622
            .unwrap();
d5d8097c3afdatagen2026-09-26 09:33 UTC1623
        assert_eq!(items, vector![item(2), item(3)]);
96fdf90aacd6atagen2026-09-08 08:24 UTC1624
96fdf90aacd6atagen2026-09-08 08:24 UTC1625
        TimelineDiff::PopFront.try_apply(&mut items).unwrap();
96fdf90aacd6atagen2026-09-08 08:24 UTC1626
        TimelineDiff::PopBack.try_apply(&mut items).unwrap();
96fdf90aacd6atagen2026-09-08 08:24 UTC1627
        assert!(items.is_empty());
96fdf90aacd6atagen2026-09-08 08:24 UTC1628
96fdf90aacd6atagen2026-09-08 08:24 UTC1629
        TimelineDiff::Reset {
96fdf90aacd6atagen2026-09-08 08:24 UTC1630
            values: vec![item(1), item(3)],
96fdf90aacd6atagen2026-09-08 08:24 UTC1631
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC1632
        .try_apply(&mut items)
96fdf90aacd6atagen2026-09-08 08:24 UTC1633
        .unwrap();
96fdf90aacd6atagen2026-09-08 08:24 UTC1634
        TimelineDiff::Insert {
96fdf90aacd6atagen2026-09-08 08:24 UTC1635
            index: 1,
96fdf90aacd6atagen2026-09-08 08:24 UTC1636
            value: item(2),
96fdf90aacd6atagen2026-09-08 08:24 UTC1637
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC1638
        .try_apply(&mut items)
96fdf90aacd6atagen2026-09-08 08:24 UTC1639
        .unwrap();
d5d8097c3afdatagen2026-09-26 09:33 UTC1640
        assert_eq!(items, vector![item(1), item(2), item(3)]);
96fdf90aacd6atagen2026-09-08 08:24 UTC1641
96fdf90aacd6atagen2026-09-08 08:24 UTC1642
        TimelineDiff::Set {
96fdf90aacd6atagen2026-09-08 08:24 UTC1643
            index: 1,
96fdf90aacd6atagen2026-09-08 08:24 UTC1644
            value: item(4),
96fdf90aacd6atagen2026-09-08 08:24 UTC1645
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC1646
        .try_apply(&mut items)
96fdf90aacd6atagen2026-09-08 08:24 UTC1647
        .unwrap();
d5d8097c3afdatagen2026-09-26 09:33 UTC1648
        assert_eq!(items, vector![item(1), item(4), item(3)]);
96fdf90aacd6atagen2026-09-08 08:24 UTC1649
96fdf90aacd6atagen2026-09-08 08:24 UTC1650
        TimelineDiff::Remove { index: 1 }
96fdf90aacd6atagen2026-09-08 08:24 UTC1651
            .try_apply(&mut items)
96fdf90aacd6atagen2026-09-08 08:24 UTC1652
            .unwrap();
d5d8097c3afdatagen2026-09-26 09:33 UTC1653
        assert_eq!(items, vector![item(1), item(3)]);
96fdf90aacd6atagen2026-09-08 08:24 UTC1654
96fdf90aacd6atagen2026-09-08 08:24 UTC1655
        TimelineDiff::Truncate { length: 1 }
96fdf90aacd6atagen2026-09-08 08:24 UTC1656
            .try_apply(&mut items)
96fdf90aacd6atagen2026-09-08 08:24 UTC1657
            .unwrap();
d5d8097c3afdatagen2026-09-26 09:33 UTC1658
        assert_eq!(items, vector![item(1)]);
96fdf90aacd6atagen2026-09-08 08:24 UTC1659
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC1660
96fdf90aacd6atagen2026-09-08 08:24 UTC1661
    #[test]
96fdf90aacd6atagen2026-09-08 08:24 UTC1662
    fn invalid_timeline_diff_leaves_snapshot_unchanged() {
96fdf90aacd6atagen2026-09-08 08:24 UTC1663
        let invalid = [
96fdf90aacd6atagen2026-09-08 08:24 UTC1664
            TimelineDiff::Insert {
96fdf90aacd6atagen2026-09-08 08:24 UTC1665
                index: 3,
96fdf90aacd6atagen2026-09-08 08:24 UTC1666
                value: item(3),
96fdf90aacd6atagen2026-09-08 08:24 UTC1667
            },
96fdf90aacd6atagen2026-09-08 08:24 UTC1668
            TimelineDiff::Set {
96fdf90aacd6atagen2026-09-08 08:24 UTC1669
                index: 2,
96fdf90aacd6atagen2026-09-08 08:24 UTC1670
                value: item(3),
96fdf90aacd6atagen2026-09-08 08:24 UTC1671
            },
96fdf90aacd6atagen2026-09-08 08:24 UTC1672
            TimelineDiff::Remove { index: 2 },
96fdf90aacd6atagen2026-09-08 08:24 UTC1673
            TimelineDiff::Truncate { length: 3 },
96fdf90aacd6atagen2026-09-08 08:24 UTC1674
        ];
96fdf90aacd6atagen2026-09-08 08:24 UTC1675
        for diff in invalid {
d5d8097c3afdatagen2026-09-26 09:33 UTC1676
            let mut items = vector![item(1), item(2)];
96fdf90aacd6atagen2026-09-08 08:24 UTC1677
            assert_eq!(diff.try_apply(&mut items).unwrap_err().length, 2);
d5d8097c3afdatagen2026-09-26 09:33 UTC1678
            assert_eq!(items, vector![item(1), item(2)]);
96fdf90aacd6atagen2026-09-08 08:24 UTC1679
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC1680
        for diff in [TimelineDiff::PopFront, TimelineDiff::PopBack] {
d5d8097c3afdatagen2026-09-26 09:33 UTC1681
            let mut items = Vector::new();
96fdf90aacd6atagen2026-09-08 08:24 UTC1682
            assert_eq!(diff.try_apply(&mut items).unwrap_err().length, 0);
96fdf90aacd6atagen2026-09-08 08:24 UTC1683
            assert!(items.is_empty());
96fdf90aacd6atagen2026-09-08 08:24 UTC1684
        }
96fdf90aacd6atagen2026-09-08 08:24 UTC1685
    }
d5d8097c3afdatagen2026-09-26 09:33 UTC1686
d5d8097c3afdatagen2026-09-26 09:33 UTC1687
    #[test]
d5d8097c3afdatagen2026-09-26 09:33 UTC1688
    fn a_batch_that_goes_wrong_halfway_changes_nothing() {
d5d8097c3afdatagen2026-09-26 09:33 UTC1689
        let mut items = vector![item(1), item(2)];
d5d8097c3afdatagen2026-09-26 09:33 UTC1690
        let batch = vec![
d5d8097c3afdatagen2026-09-26 09:33 UTC1691
            TimelineDiff::PushBack { value: item(3) },
0b8ce8dc9a1catagen2026-09-26 12:30 UTC1692
            TimelineDiff::PushBack { value: item(4) },
d5d8097c3afdatagen2026-09-26 09:33 UTC1693
            TimelineDiff::Remove { index: 0 },
d5d8097c3afdatagen2026-09-26 09:33 UTC1694
            TimelineDiff::Set {
0b8ce8dc9a1catagen2026-09-26 12:30 UTC1695
                index: 3,
0b8ce8dc9a1catagen2026-09-26 12:30 UTC1696
                value: item(5),
d5d8097c3afdatagen2026-09-26 09:33 UTC1697
            },
d5d8097c3afdatagen2026-09-26 09:33 UTC1698
        ];
d5d8097c3afdatagen2026-09-26 09:33 UTC1699
        assert_eq!(
d5d8097c3afdatagen2026-09-26 09:33 UTC1700
            TimelineDiff::try_apply_all(batch, &mut items)
d5d8097c3afdatagen2026-09-26 09:33 UTC1701
                .unwrap_err()
d5d8097c3afdatagen2026-09-26 09:33 UTC1702
                .length,
0b8ce8dc9a1catagen2026-09-26 12:30 UTC1703
            3
d5d8097c3afdatagen2026-09-26 09:33 UTC1704
        );
d5d8097c3afdatagen2026-09-26 09:33 UTC1705
        assert_eq!(items, vector![item(1), item(2)]);
d5d8097c3afdatagen2026-09-26 09:33 UTC1706
d5d8097c3afdatagen2026-09-26 09:33 UTC1707
        let batch = vec![
d5d8097c3afdatagen2026-09-26 09:33 UTC1708
            TimelineDiff::PushBack { value: item(3) },
d5d8097c3afdatagen2026-09-26 09:33 UTC1709
            TimelineDiff::Remove { index: 0 },
d5d8097c3afdatagen2026-09-26 09:33 UTC1710
            TimelineDiff::Set {
d5d8097c3afdatagen2026-09-26 09:33 UTC1711
                index: 1,
d5d8097c3afdatagen2026-09-26 09:33 UTC1712
                value: item(4),
d5d8097c3afdatagen2026-09-26 09:33 UTC1713
            },
d5d8097c3afdatagen2026-09-26 09:33 UTC1714
        ];
d5d8097c3afdatagen2026-09-26 09:33 UTC1715
        TimelineDiff::try_apply_all(batch, &mut items).unwrap();
d5d8097c3afdatagen2026-09-26 09:33 UTC1716
        assert_eq!(items, vector![item(2), item(4)]);
d5d8097c3afdatagen2026-09-26 09:33 UTC1717
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC1718
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1719
96fdf90aacd6atagen2026-09-08 08:24 UTC1720
#[derive(Clone, Debug, Eq, Hash, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1721
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1722
pub struct TimelineItemId(String);
96fdf90aacd6atagen2026-09-08 08:24 UTC1723
96fdf90aacd6atagen2026-09-08 08:24 UTC1724
impl TimelineItemId {
96fdf90aacd6atagen2026-09-08 08:24 UTC1725
    pub(crate) fn new(value: String) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC1726
        Self(value)
96fdf90aacd6atagen2026-09-08 08:24 UTC1727
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC1728
96fdf90aacd6atagen2026-09-08 08:24 UTC1729
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC1730
    pub fn as_str(&self) -> &str {
96fdf90aacd6atagen2026-09-08 08:24 UTC1731
        &self.0
96fdf90aacd6atagen2026-09-08 08:24 UTC1732
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC1733
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1734
96fdf90aacd6atagen2026-09-08 08:24 UTC1735
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1736
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1737
#[non_exhaustive]
960ac0721079atagen2026-09-25 00:24 UTC1738
pub struct TimelineEvent {
96fdf90aacd6atagen2026-09-08 08:24 UTC1739
    pub item_id: TimelineItemId,
96fdf90aacd6atagen2026-09-08 08:24 UTC1740
    pub event_id: Option<OwnedEventId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1741
    pub transaction_id: Option<OwnedTransactionId>,
960ac0721079atagen2026-09-25 00:24 UTC1742
    pub sender: Sender,
96fdf90aacd6atagen2026-09-08 08:24 UTC1743
    pub timestamp_ms: u64,
96fdf90aacd6atagen2026-09-08 08:24 UTC1744
    pub own: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC1745
    pub send_state: SendState,
960ac0721079atagen2026-09-25 00:24 UTC1746
    pub content: TimelineContent,
96fdf90aacd6atagen2026-09-08 08:24 UTC1747
    pub reply_to: Option<ReplyReference>,
960ac0721079atagen2026-09-25 00:24 UTC1748
    pub thread_root: Option<OwnedEventId>,
960ac0721079atagen2026-09-25 00:24 UTC1749
    pub thread_summary: Option<ThreadSummary>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1750
    pub reactions: Vec<Reaction>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1751
    pub read_by: Vec<OwnedUserId>,
960ac0721079atagen2026-09-25 00:24 UTC1752
    pub editable: bool,
913832a327a8atagen2026-10-25 09:33 UTC1753
    /// the push rules ask for this one to stand out, always false for a local echo
913832a327a8atagen2026-10-25 09:33 UTC1754
    pub highlight: bool,
960ac0721079atagen2026-09-25 00:24 UTC1755
}
960ac0721079atagen2026-09-25 00:24 UTC1756
960ac0721079atagen2026-09-25 00:24 UTC1757
impl TimelineEvent {
960ac0721079atagen2026-09-25 00:24 UTC1758
    /// what to hand edit, redact and react. works before the server has echoed it back
960ac0721079atagen2026-09-25 00:24 UTC1759
    #[must_use]
960ac0721079atagen2026-09-25 00:24 UTC1760
    pub fn target(&self) -> Option<EventRef> {
960ac0721079atagen2026-09-25 00:24 UTC1761
        self.event_id
960ac0721079atagen2026-09-25 00:24 UTC1762
            .clone()
960ac0721079atagen2026-09-25 00:24 UTC1763
            .map(EventRef::Remote)
960ac0721079atagen2026-09-25 00:24 UTC1764
            .or_else(|| self.transaction_id.clone().map(EventRef::Local))
960ac0721079atagen2026-09-25 00:24 UTC1765
    }
960ac0721079atagen2026-09-25 00:24 UTC1766
}
960ac0721079atagen2026-09-25 00:24 UTC1767
960ac0721079atagen2026-09-25 00:24 UTC1768
#[derive(Clone, Debug, Eq, Hash, PartialEq)]
960ac0721079atagen2026-09-25 00:24 UTC1769
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
960ac0721079atagen2026-09-25 00:24 UTC1770
#[non_exhaustive]
960ac0721079atagen2026-09-25 00:24 UTC1771
pub enum EventRef {
960ac0721079atagen2026-09-25 00:24 UTC1772
    Remote(OwnedEventId),
960ac0721079atagen2026-09-25 00:24 UTC1773
    /// a local echo, by the transaction id it was queued under
960ac0721079atagen2026-09-25 00:24 UTC1774
    Local(OwnedTransactionId),
960ac0721079atagen2026-09-25 00:24 UTC1775
}
960ac0721079atagen2026-09-25 00:24 UTC1776
960ac0721079atagen2026-09-25 00:24 UTC1777
impl From<OwnedEventId> for EventRef {
960ac0721079atagen2026-09-25 00:24 UTC1778
    fn from(event_id: OwnedEventId) -> Self {
960ac0721079atagen2026-09-25 00:24 UTC1779
        Self::Remote(event_id)
960ac0721079atagen2026-09-25 00:24 UTC1780
    }
960ac0721079atagen2026-09-25 00:24 UTC1781
}
960ac0721079atagen2026-09-25 00:24 UTC1782
960ac0721079atagen2026-09-25 00:24 UTC1783
#[derive(Clone, Debug, Eq, PartialEq)]
960ac0721079atagen2026-09-25 00:24 UTC1784
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
960ac0721079atagen2026-09-25 00:24 UTC1785
#[non_exhaustive]
960ac0721079atagen2026-09-25 00:24 UTC1786
pub struct Sender {
960ac0721079atagen2026-09-25 00:24 UTC1787
    pub user_id: OwnedUserId,
960ac0721079atagen2026-09-25 00:24 UTC1788
    pub display_name: Option<String>,
5d2974de5826atagen2026-10-08 11:29 UTC1789
    pub avatar: Option<MediaId>,
960ac0721079atagen2026-09-25 00:24 UTC1790
    /// someone else in the room goes by the same name, so show the user id too
960ac0721079atagen2026-09-25 00:24 UTC1791
    pub name_ambiguous: bool,
960ac0721079atagen2026-09-25 00:24 UTC1792
}
960ac0721079atagen2026-09-25 00:24 UTC1793
960ac0721079atagen2026-09-25 00:24 UTC1794
impl Sender {
960ac0721079atagen2026-09-25 00:24 UTC1795
    #[must_use]
960ac0721079atagen2026-09-25 00:24 UTC1796
    pub fn name(&self) -> &str {
960ac0721079atagen2026-09-25 00:24 UTC1797
        self.display_name
960ac0721079atagen2026-09-25 00:24 UTC1798
            .as_deref()
960ac0721079atagen2026-09-25 00:24 UTC1799
            .unwrap_or_else(|| self.user_id.as_str())
960ac0721079atagen2026-09-25 00:24 UTC1800
    }
960ac0721079atagen2026-09-25 00:24 UTC1801
}
960ac0721079atagen2026-09-25 00:24 UTC1802
960ac0721079atagen2026-09-25 00:24 UTC1803
#[derive(Clone, Debug, Eq, PartialEq)]
960ac0721079atagen2026-09-25 00:24 UTC1804
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
960ac0721079atagen2026-09-25 00:24 UTC1805
pub enum TimelineContent {
960ac0721079atagen2026-09-25 00:24 UTC1806
    Message(Message),
960ac0721079atagen2026-09-25 00:24 UTC1807
    Sticker {
960ac0721079atagen2026-09-25 00:24 UTC1808
        body: String,
960ac0721079atagen2026-09-25 00:24 UTC1809
        media: MediaDescriptor,
960ac0721079atagen2026-09-25 00:24 UTC1810
    },
960ac0721079atagen2026-09-25 00:24 UTC1811
    Poll {
960ac0721079atagen2026-09-25 00:24 UTC1812
        question: String,
960ac0721079atagen2026-09-25 00:24 UTC1813
    },
960ac0721079atagen2026-09-25 00:24 UTC1814
    Redacted,
960ac0721079atagen2026-09-25 00:24 UTC1815
    UnableToDecrypt(UtdCause),
960ac0721079atagen2026-09-25 00:24 UTC1816
    Membership {
960ac0721079atagen2026-09-25 00:24 UTC1817
        user_id: OwnedUserId,
960ac0721079atagen2026-09-25 00:24 UTC1818
        display_name: Option<String>,
960ac0721079atagen2026-09-25 00:24 UTC1819
        change: MembershipChange,
960ac0721079atagen2026-09-25 00:24 UTC1820
    },
960ac0721079atagen2026-09-25 00:24 UTC1821
    Profile {
960ac0721079atagen2026-09-25 00:24 UTC1822
        user_id: OwnedUserId,
960ac0721079atagen2026-09-25 00:24 UTC1823
        display_name: Option<Change<Option<String>>>,
5d2974de5826atagen2026-10-08 11:29 UTC1824
        avatar: Option<Change<Option<MediaId>>>,
960ac0721079atagen2026-09-25 00:24 UTC1825
    },
5a52012c9b1datagen2026-09-24 23:45 UTC1826
    /// `None` means it was cleared, or the event was redacted
960ac0721079atagen2026-09-25 00:24 UTC1827
    RoomName(Option<String>),
960ac0721079atagen2026-09-25 00:24 UTC1828
    RoomTopic(Option<String>),
5d2974de5826atagen2026-10-08 11:29 UTC1829
    RoomAvatar(Option<MediaId>),
960ac0721079atagen2026-09-25 00:24 UTC1830
    EncryptionEnabled,
960ac0721079atagen2026-09-25 00:24 UTC1831
    RoomCreated,
960ac0721079atagen2026-09-25 00:24 UTC1832
    RoomUpgraded {
960ac0721079atagen2026-09-25 00:24 UTC1833
        successor: OwnedRoomId,
960ac0721079atagen2026-09-25 00:24 UTC1834
    },
960ac0721079atagen2026-09-25 00:24 UTC1835
    OtherState {
960ac0721079atagen2026-09-25 00:24 UTC1836
        event_type: String,
960ac0721079atagen2026-09-25 00:24 UTC1837
        state_key: String,
960ac0721079atagen2026-09-25 00:24 UTC1838
    },
960ac0721079atagen2026-09-25 00:24 UTC1839
    Other {
960ac0721079atagen2026-09-25 00:24 UTC1840
        event_type: String,
960ac0721079atagen2026-09-25 00:24 UTC1841
    },
960ac0721079atagen2026-09-25 00:24 UTC1842
}
960ac0721079atagen2026-09-25 00:24 UTC1843
960ac0721079atagen2026-09-25 00:24 UTC1844
#[derive(Clone, Debug, Eq, PartialEq)]
960ac0721079atagen2026-09-25 00:24 UTC1845
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
960ac0721079atagen2026-09-25 00:24 UTC1846
#[non_exhaustive]
960ac0721079atagen2026-09-25 00:24 UTC1847
pub struct Message {
960ac0721079atagen2026-09-25 00:24 UTC1848
    pub kind: MessageKind,
960ac0721079atagen2026-09-25 00:24 UTC1849
    pub body: String,
5a52012c9b1datagen2026-09-24 23:45 UTC1850
    /// only for `MessageKind::Location`
5a52012c9b1datagen2026-09-24 23:45 UTC1851
    pub geo_uri: Option<String>,
960ac0721079atagen2026-09-25 00:24 UTC1852
    pub formatted_body: Option<String>,
960ac0721079atagen2026-09-25 00:24 UTC1853
    pub mentions: Option<MessageMentions>,
960ac0721079atagen2026-09-25 00:24 UTC1854
    pub edited: bool,
960ac0721079atagen2026-09-25 00:24 UTC1855
    pub media: Option<MediaDescriptor>,
0291516d40b5atagen2026-10-22 08:31 UTC1856
    /// previews the sender attached (msc4095), so showing them asks no one about the url.
0291516d40b5atagen2026-10-22 08:31 UTC1857
    /// one for a url the body doesn't contain is dropped
0291516d40b5atagen2026-10-22 08:31 UTC1858
    pub link_previews: Vec<LinkPreview>,
0291516d40b5atagen2026-10-22 08:31 UTC1859
}
0291516d40b5atagen2026-10-22 08:31 UTC1860
0291516d40b5atagen2026-10-22 08:31 UTC1861
/// a link card, from the sender's own message or from `ClientHandle::url_preview`. page
0291516d40b5atagen2026-10-22 08:31 UTC1862
/// text passes through whoever made it unfiltered, so it arrives trimmed to a sane length
0291516d40b5atagen2026-10-22 08:31 UTC1863
#[derive(Clone, Debug, Eq, PartialEq)]
0291516d40b5atagen2026-10-22 08:31 UTC1864
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
0291516d40b5atagen2026-10-22 08:31 UTC1865
#[non_exhaustive]
0291516d40b5atagen2026-10-22 08:31 UTC1866
pub struct LinkPreview {
0291516d40b5atagen2026-10-22 08:31 UTC1867
    /// the url as it appears in the message, or as it was asked about
0291516d40b5atagen2026-10-22 08:31 UTC1868
    pub url: String,
0291516d40b5atagen2026-10-22 08:31 UTC1869
    /// where the page says it lives, when that's somewhere else
0291516d40b5atagen2026-10-22 08:31 UTC1870
    pub canonical_url: Option<String>,
0291516d40b5atagen2026-10-22 08:31 UTC1871
    pub title: Option<String>,
0291516d40b5atagen2026-10-22 08:31 UTC1872
    pub description: Option<String>,
0291516d40b5atagen2026-10-22 08:31 UTC1873
    pub site_name: Option<String>,
0291516d40b5atagen2026-10-22 08:31 UTC1874
    pub image: Option<LinkPreviewImage>,
0291516d40b5atagen2026-10-22 08:31 UTC1875
}
0291516d40b5atagen2026-10-22 08:31 UTC1876
0291516d40b5atagen2026-10-22 08:31 UTC1877
#[derive(Clone, Debug, Eq, PartialEq)]
0291516d40b5atagen2026-10-22 08:31 UTC1878
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
0291516d40b5atagen2026-10-22 08:31 UTC1879
#[non_exhaustive]
0291516d40b5atagen2026-10-22 08:31 UTC1880
pub struct LinkPreviewImage {
0291516d40b5atagen2026-10-22 08:31 UTC1881
    pub media_id: MediaId,
0291516d40b5atagen2026-10-22 08:31 UTC1882
    pub mimetype: Option<String>,
0291516d40b5atagen2026-10-22 08:31 UTC1883
    pub size_bytes: Option<u64>,
0291516d40b5atagen2026-10-22 08:31 UTC1884
    pub width: Option<u64>,
0291516d40b5atagen2026-10-22 08:31 UTC1885
    pub height: Option<u64>,
960ac0721079atagen2026-09-25 00:24 UTC1886
}
960ac0721079atagen2026-09-25 00:24 UTC1887
960ac0721079atagen2026-09-25 00:24 UTC1888
#[derive(Clone, Debug, Eq, PartialEq)]
960ac0721079atagen2026-09-25 00:24 UTC1889
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
960ac0721079atagen2026-09-25 00:24 UTC1890
pub enum MessageKind {
960ac0721079atagen2026-09-25 00:24 UTC1891
    Text,
960ac0721079atagen2026-09-25 00:24 UTC1892
    Emote,
960ac0721079atagen2026-09-25 00:24 UTC1893
    Notice,
960ac0721079atagen2026-09-25 00:24 UTC1894
    ServerNotice,
960ac0721079atagen2026-09-25 00:24 UTC1895
    Image,
960ac0721079atagen2026-09-25 00:24 UTC1896
    Video,
960ac0721079atagen2026-09-25 00:24 UTC1897
    Audio,
960ac0721079atagen2026-09-25 00:24 UTC1898
    File,
960ac0721079atagen2026-09-25 00:24 UTC1899
    Location,
960ac0721079atagen2026-09-25 00:24 UTC1900
    VerificationRequest,
960ac0721079atagen2026-09-25 00:24 UTC1901
    Other(String),
960ac0721079atagen2026-09-25 00:24 UTC1902
}
960ac0721079atagen2026-09-25 00:24 UTC1903
960ac0721079atagen2026-09-25 00:24 UTC1904
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
960ac0721079atagen2026-09-25 00:24 UTC1905
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
960ac0721079atagen2026-09-25 00:24 UTC1906
pub enum MembershipChange {
960ac0721079atagen2026-09-25 00:24 UTC1907
    Joined,
960ac0721079atagen2026-09-25 00:24 UTC1908
    Left,
960ac0721079atagen2026-09-25 00:24 UTC1909
    Banned,
960ac0721079atagen2026-09-25 00:24 UTC1910
    Unbanned,
960ac0721079atagen2026-09-25 00:24 UTC1911
    Kicked,
960ac0721079atagen2026-09-25 00:24 UTC1912
    KickedAndBanned,
960ac0721079atagen2026-09-25 00:24 UTC1913
    Invited,
960ac0721079atagen2026-09-25 00:24 UTC1914
    InvitationAccepted,
960ac0721079atagen2026-09-25 00:24 UTC1915
    InvitationRejected,
960ac0721079atagen2026-09-25 00:24 UTC1916
    InvitationRevoked,
960ac0721079atagen2026-09-25 00:24 UTC1917
    Knocked,
960ac0721079atagen2026-09-25 00:24 UTC1918
    KnockAccepted,
960ac0721079atagen2026-09-25 00:24 UTC1919
    KnockRetracted,
960ac0721079atagen2026-09-25 00:24 UTC1920
    KnockDenied,
960ac0721079atagen2026-09-25 00:24 UTC1921
    /// nothing a person would call a change, or something the sdk couldn't make sense of
960ac0721079atagen2026-09-25 00:24 UTC1922
    Other,
960ac0721079atagen2026-09-25 00:24 UTC1923
}
960ac0721079atagen2026-09-25 00:24 UTC1924
960ac0721079atagen2026-09-25 00:24 UTC1925
#[derive(Clone, Debug, Eq, PartialEq)]
960ac0721079atagen2026-09-25 00:24 UTC1926
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
960ac0721079atagen2026-09-25 00:24 UTC1927
pub struct Change<T> {
960ac0721079atagen2026-09-25 00:24 UTC1928
    pub old: T,
960ac0721079atagen2026-09-25 00:24 UTC1929
    pub new: T,
960ac0721079atagen2026-09-25 00:24 UTC1930
}
960ac0721079atagen2026-09-25 00:24 UTC1931
960ac0721079atagen2026-09-25 00:24 UTC1932
/// why a message couldn't be read, worth telling the user since some of these they can fix
960ac0721079atagen2026-09-25 00:24 UTC1933
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
960ac0721079atagen2026-09-25 00:24 UTC1934
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
960ac0721079atagen2026-09-25 00:24 UTC1935
pub enum UtdCause {
960ac0721079atagen2026-09-25 00:24 UTC1936
    Unknown,
960ac0721079atagen2026-09-25 00:24 UTC1937
    SentBeforeWeJoined,
960ac0721079atagen2026-09-25 00:24 UTC1938
    VerificationViolation,
960ac0721079atagen2026-09-25 00:24 UTC1939
    UnsignedDevice,
960ac0721079atagen2026-09-25 00:24 UTC1940
    UnknownDevice,
960ac0721079atagen2026-09-25 00:24 UTC1941
    HistoricalMessageAndBackupIsDisabled,
960ac0721079atagen2026-09-25 00:24 UTC1942
    WithheldForUnverifiedOrInsecureDevice,
960ac0721079atagen2026-09-25 00:24 UTC1943
    WithheldBySender,
960ac0721079atagen2026-09-25 00:24 UTC1944
    HistoricalMessageAndDeviceIsUnverified,
96fdf90aacd6atagen2026-09-08 08:24 UTC1945
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1946
96fdf90aacd6atagen2026-09-08 08:24 UTC1947
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC1948
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC1949
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC1950
pub struct ThreadSummary {
96fdf90aacd6atagen2026-09-08 08:24 UTC1951
    pub reply_count: u32,
96fdf90aacd6atagen2026-09-08 08:24 UTC1952
    pub latest_event_id: Option<OwnedEventId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1953
    pub latest_event_timestamp_ms: Option<u64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC1954
}
96fdf90aacd6atagen2026-09-08 08:24 UTC1955
21b9227729a4atagen2026-10-25 11:03 UTC1956
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
21b9227729a4atagen2026-10-25 11:03 UTC1957
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
60454002af5fatagen2026-10-25 11:13 UTC1958
pub enum ThreadListCloseReason {
21b9227729a4atagen2026-10-25 11:03 UTC1959
    /// `Close` asked for it
21b9227729a4atagen2026-10-25 11:03 UTC1960
    Requested,
60454002af5fatagen2026-10-25 11:13 UTC1961
    /// left, kicked or banned
60454002af5fatagen2026-10-25 11:13 UTC1962
    RoomLeft,
21b9227729a4atagen2026-10-25 11:03 UTC1963
}
21b9227729a4atagen2026-10-25 11:03 UTC1964
66db1b3cd895atagen2026-10-25 10:28 UTC1965
#[derive(Clone, Debug, Eq, PartialEq)]
66db1b3cd895atagen2026-10-25 10:28 UTC1966
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
66db1b3cd895atagen2026-10-25 10:28 UTC1967
#[non_exhaustive]
66db1b3cd895atagen2026-10-25 10:28 UTC1968
pub struct ThreadListEntry {
66db1b3cd895atagen2026-10-25 10:28 UTC1969
    pub root_event_id: OwnedEventId,
66db1b3cd895atagen2026-10-25 10:28 UTC1970
    /// always an event, carrying `summary` as its own
66db1b3cd895atagen2026-10-25 10:28 UTC1971
    pub root: TimelineItem,
66db1b3cd895atagen2026-10-25 10:28 UTC1972
    pub summary: ThreadSummary,
66db1b3cd895atagen2026-10-25 10:28 UTC1973
    pub latest_reply: Option<TimelineItem>,
66db1b3cd895atagen2026-10-25 10:28 UTC1974
    /// the latest reply's timestamp, or the root's before any reply
66db1b3cd895atagen2026-10-25 10:28 UTC1975
    pub latest_activity_ms: u64,
66db1b3cd895atagen2026-10-25 10:28 UTC1976
}
66db1b3cd895atagen2026-10-25 10:28 UTC1977
66db1b3cd895atagen2026-10-25 10:28 UTC1978
impl ThreadListEntry {
66db1b3cd895atagen2026-10-25 10:28 UTC1979
    /// replaces the entry with the same root, or adds it, where its activity puts it.
66db1b3cd895atagen2026-10-25 10:28 UTC1980
    /// ties go by root event id
66db1b3cd895atagen2026-10-25 10:28 UTC1981
    pub fn upsert(entries: &mut Vector<Self>, entry: Self) {
66db1b3cd895atagen2026-10-25 10:28 UTC1982
        if let Some(index) = entries
66db1b3cd895atagen2026-10-25 10:28 UTC1983
            .iter()
66db1b3cd895atagen2026-10-25 10:28 UTC1984
            .position(|known| known.root_event_id == entry.root_event_id)
66db1b3cd895atagen2026-10-25 10:28 UTC1985
        {
66db1b3cd895atagen2026-10-25 10:28 UTC1986
            entries.remove(index);
66db1b3cd895atagen2026-10-25 10:28 UTC1987
        }
66db1b3cd895atagen2026-10-25 10:28 UTC1988
        let index = entries
66db1b3cd895atagen2026-10-25 10:28 UTC1989
            .binary_search_by(|known| {
66db1b3cd895atagen2026-10-25 10:28 UTC1990
                if known.sorts_before(&entry) {
66db1b3cd895atagen2026-10-25 10:28 UTC1991
                    std::cmp::Ordering::Less
66db1b3cd895atagen2026-10-25 10:28 UTC1992
                } else {
66db1b3cd895atagen2026-10-25 10:28 UTC1993
                    std::cmp::Ordering::Greater
66db1b3cd895atagen2026-10-25 10:28 UTC1994
                }
66db1b3cd895atagen2026-10-25 10:28 UTC1995
            })
66db1b3cd895atagen2026-10-25 10:28 UTC1996
            .unwrap_or_else(|index| index);
66db1b3cd895atagen2026-10-25 10:28 UTC1997
        entries.insert(index, entry);
66db1b3cd895atagen2026-10-25 10:28 UTC1998
    }
66db1b3cd895atagen2026-10-25 10:28 UTC1999
66db1b3cd895atagen2026-10-25 10:28 UTC2000
    #[must_use]
66db1b3cd895atagen2026-10-25 10:28 UTC2001
    pub fn sorts_before(&self, other: &Self) -> bool {
66db1b3cd895atagen2026-10-25 10:28 UTC2002
        (
66db1b3cd895atagen2026-10-25 10:28 UTC2003
            std::cmp::Reverse(self.latest_activity_ms),
66db1b3cd895atagen2026-10-25 10:28 UTC2004
            &self.root_event_id,
66db1b3cd895atagen2026-10-25 10:28 UTC2005
        ) < (
66db1b3cd895atagen2026-10-25 10:28 UTC2006
            std::cmp::Reverse(other.latest_activity_ms),
66db1b3cd895atagen2026-10-25 10:28 UTC2007
            &other.root_event_id,
66db1b3cd895atagen2026-10-25 10:28 UTC2008
        )
66db1b3cd895atagen2026-10-25 10:28 UTC2009
    }
66db1b3cd895atagen2026-10-25 10:28 UTC2010
}
66db1b3cd895atagen2026-10-25 10:28 UTC2011
96fdf90aacd6atagen2026-09-08 08:24 UTC2012
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC2013
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC2014
pub enum SendState {
96fdf90aacd6atagen2026-09-08 08:24 UTC2015
    Sent,
96fdf90aacd6atagen2026-09-08 08:24 UTC2016
    Sending,
5a52012c9b1datagen2026-09-24 23:45 UTC2017
    /// `will_retry` means macltok has it in hand. otherwise it's wedged until you
5a52012c9b1datagen2026-09-24 23:45 UTC2018
    /// `retry_send` or `cancel_send`, so that's when to show a retry button
5a52012c9b1datagen2026-09-24 23:45 UTC2019
    Failed {
5a52012c9b1datagen2026-09-24 23:45 UTC2020
        will_retry: bool,
5a52012c9b1datagen2026-09-24 23:45 UTC2021
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC2022
}
96fdf90aacd6atagen2026-09-08 08:24 UTC2023
96fdf90aacd6atagen2026-09-08 08:24 UTC2024
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC2025
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC2026
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC2027
pub struct ReplyReference {
96fdf90aacd6atagen2026-09-08 08:24 UTC2028
    pub event_id: OwnedEventId,
960ac0721079atagen2026-09-25 00:24 UTC2029
    pub details: ReplyDetails,
960ac0721079atagen2026-09-25 00:24 UTC2030
}
960ac0721079atagen2026-09-25 00:24 UTC2031
960ac0721079atagen2026-09-25 00:24 UTC2032
/// 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 UTC2033
#[derive(Clone, Debug, Eq, PartialEq)]
960ac0721079atagen2026-09-25 00:24 UTC2034
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
960ac0721079atagen2026-09-25 00:24 UTC2035
pub enum ReplyDetails {
960ac0721079atagen2026-09-25 00:24 UTC2036
    Pending,
960ac0721079atagen2026-09-25 00:24 UTC2037
    Ready {
960ac0721079atagen2026-09-25 00:24 UTC2038
        sender: Sender,
960ac0721079atagen2026-09-25 00:24 UTC2039
        content: Box<TimelineContent>,
960ac0721079atagen2026-09-25 00:24 UTC2040
        timestamp_ms: u64,
960ac0721079atagen2026-09-25 00:24 UTC2041
    },
960ac0721079atagen2026-09-25 00:24 UTC2042
    Unavailable,
96fdf90aacd6atagen2026-09-08 08:24 UTC2043
}
96fdf90aacd6atagen2026-09-08 08:24 UTC2044
96fdf90aacd6atagen2026-09-08 08:24 UTC2045
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC2046
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC2047
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC2048
pub struct Reaction {
96fdf90aacd6atagen2026-09-08 08:24 UTC2049
    pub key: String,
8fa8a7cde89catagen2026-10-08 12:39 UTC2050
    /// a custom emote's shortcode, from whichever sender gave one
8fa8a7cde89catagen2026-10-08 12:39 UTC2051
    pub shortcode: Option<String>,
8fa8a7cde89catagen2026-10-08 12:39 UTC2052
    /// the custom emote itself, when the key is an image
8fa8a7cde89catagen2026-10-08 12:39 UTC2053
    pub image: Option<MediaId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC2054
    pub count: usize,
96fdf90aacd6atagen2026-09-08 08:24 UTC2055
    pub own: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC2056
    pub senders: Vec<OwnedUserId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC2057
}
96fdf90aacd6atagen2026-09-08 08:24 UTC2058
17e042fbc331atagen2026-10-08 12:39 UTC2059
/// every custom emote and sticker pack the account can reach, from the user's own
17e042fbc331atagen2026-10-08 12:39 UTC2060
/// pack, each joined room's packs, and the rooms the user enabled everywhere
17e042fbc331atagen2026-10-08 12:39 UTC2061
#[derive(Clone, Debug, Default, Eq, PartialEq)]
17e042fbc331atagen2026-10-08 12:39 UTC2062
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
17e042fbc331atagen2026-10-08 12:39 UTC2063
#[non_exhaustive]
17e042fbc331atagen2026-10-08 12:39 UTC2064
pub struct ImagePacks {
17e042fbc331atagen2026-10-08 12:39 UTC2065
    /// the user's own pack, then the packs of rooms enabled everywhere
17e042fbc331atagen2026-10-08 12:39 UTC2066
    pub global: Vec<ImagePack>,
17e042fbc331atagen2026-10-08 12:39 UTC2067
    /// each joined room's own packs, rooms without any left out
17e042fbc331atagen2026-10-08 12:39 UTC2068
    pub rooms: imbl::HashMap<OwnedRoomId, Vec<ImagePack>>,
17e042fbc331atagen2026-10-08 12:39 UTC2069
}
17e042fbc331atagen2026-10-08 12:39 UTC2070
17e042fbc331atagen2026-10-08 12:39 UTC2071
impl ImagePacks {
17e042fbc331atagen2026-10-08 12:39 UTC2072
    /// what a picker in this room offers. the user's pack, the room's own, then the
17e042fbc331atagen2026-10-08 12:39 UTC2073
    /// rest of the enabled ones, each pack once
17e042fbc331atagen2026-10-08 12:39 UTC2074
    #[must_use]
17e042fbc331atagen2026-10-08 12:39 UTC2075
    pub fn for_room(&self, room_id: Option<&RoomId>) -> Vec<&ImagePack> {
17e042fbc331atagen2026-10-08 12:39 UTC2076
        let is_user = |pack: &&ImagePack| pack.source == ImagePackSource::User;
17e042fbc331atagen2026-10-08 12:39 UTC2077
        let own = room_id.and_then(|room_id| self.rooms.get(room_id));
17e042fbc331atagen2026-10-08 12:39 UTC2078
        let mut packs: Vec<&ImagePack> = self.global.iter().filter(is_user).collect();
17e042fbc331atagen2026-10-08 12:39 UTC2079
        packs.extend(own.into_iter().flatten());
17e042fbc331atagen2026-10-08 12:39 UTC2080
        for pack in self.global.iter().filter(|pack| !is_user(pack)) {
17e042fbc331atagen2026-10-08 12:39 UTC2081
            if !packs.iter().any(|seen| seen.id == pack.id) {
17e042fbc331atagen2026-10-08 12:39 UTC2082
                packs.push(pack);
17e042fbc331atagen2026-10-08 12:39 UTC2083
            }
17e042fbc331atagen2026-10-08 12:39 UTC2084
        }
17e042fbc331atagen2026-10-08 12:39 UTC2085
        packs
17e042fbc331atagen2026-10-08 12:39 UTC2086
    }
17e042fbc331atagen2026-10-08 12:39 UTC2087
}
17e042fbc331atagen2026-10-08 12:39 UTC2088
17e042fbc331atagen2026-10-08 12:39 UTC2089
#[derive(Clone, Debug, Eq, PartialEq)]
17e042fbc331atagen2026-10-08 12:39 UTC2090
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
17e042fbc331atagen2026-10-08 12:39 UTC2091
#[non_exhaustive]
17e042fbc331atagen2026-10-08 12:39 UTC2092
pub struct ImagePack {
17e042fbc331atagen2026-10-08 12:39 UTC2093
    /// `user`, or `room:<room id>:<state key>`, the same across calls
17e042fbc331atagen2026-10-08 12:39 UTC2094
    pub id: String,
17e042fbc331atagen2026-10-08 12:39 UTC2095
    pub display_name: Option<String>,
17e042fbc331atagen2026-10-08 12:39 UTC2096
    pub avatar: Option<MediaId>,
17e042fbc331atagen2026-10-08 12:39 UTC2097
    pub attribution: Option<String>,
17e042fbc331atagen2026-10-08 12:39 UTC2098
    pub source: ImagePackSource,
17e042fbc331atagen2026-10-08 12:39 UTC2099
    pub images: Vec<PackImage>,
fa51490b6ae9atagen2026-10-24 08:41 UTC2100
    /// your own pack, or a room pack whose state you're allowed to send
fa51490b6ae9atagen2026-10-24 08:41 UTC2101
    pub editable: bool,
fa51490b6ae9atagen2026-10-24 08:41 UTC2102
    /// listed in im.ponies.emote_rooms. always true for your own pack
fa51490b6ae9atagen2026-10-24 08:41 UTC2103
    pub enabled_everywhere: bool,
17e042fbc331atagen2026-10-08 12:39 UTC2104
}
17e042fbc331atagen2026-10-08 12:39 UTC2105
17e042fbc331atagen2026-10-08 12:39 UTC2106
#[derive(Clone, Debug, Eq, PartialEq)]
17e042fbc331atagen2026-10-08 12:39 UTC2107
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
17e042fbc331atagen2026-10-08 12:39 UTC2108
pub enum ImagePackSource {
17e042fbc331atagen2026-10-08 12:39 UTC2109
    User,
17e042fbc331atagen2026-10-08 12:39 UTC2110
    Room {
17e042fbc331atagen2026-10-08 12:39 UTC2111
        room_id: OwnedRoomId,
17e042fbc331atagen2026-10-08 12:39 UTC2112
        state_key: String,
17e042fbc331atagen2026-10-08 12:39 UTC2113
    },
17e042fbc331atagen2026-10-08 12:39 UTC2114
}
17e042fbc331atagen2026-10-08 12:39 UTC2115
17e042fbc331atagen2026-10-08 12:39 UTC2116
#[derive(Clone, Debug, Eq, PartialEq)]
17e042fbc331atagen2026-10-08 12:39 UTC2117
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
17e042fbc331atagen2026-10-08 12:39 UTC2118
#[non_exhaustive]
17e042fbc331atagen2026-10-08 12:39 UTC2119
pub struct PackImage {
17e042fbc331atagen2026-10-08 12:39 UTC2120
    pub shortcode: String,
17e042fbc331atagen2026-10-08 12:39 UTC2121
    pub media_id: MediaId,
17e042fbc331atagen2026-10-08 12:39 UTC2122
    /// what `toggle_reaction` takes to react with this image
17e042fbc331atagen2026-10-08 12:39 UTC2123
    pub reaction_key: String,
17e042fbc331atagen2026-10-08 12:39 UTC2124
    pub body: Option<String>,
17e042fbc331atagen2026-10-08 12:39 UTC2125
    pub mimetype: Option<String>,
17e042fbc331atagen2026-10-08 12:39 UTC2126
    pub width: Option<u64>,
17e042fbc331atagen2026-10-08 12:39 UTC2127
    pub height: Option<u64>,
17e042fbc331atagen2026-10-08 12:39 UTC2128
    /// the image's own, else its pack's, else both
17e042fbc331atagen2026-10-08 12:39 UTC2129
    pub usage: Vec<PackUsage>,
17e042fbc331atagen2026-10-08 12:39 UTC2130
}
17e042fbc331atagen2026-10-08 12:39 UTC2131
17e042fbc331atagen2026-10-08 12:39 UTC2132
#[derive(Clone, Copy, Debug, Eq, Hash, Ord, PartialEq, PartialOrd)]
17e042fbc331atagen2026-10-08 12:39 UTC2133
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
17e042fbc331atagen2026-10-08 12:39 UTC2134
pub enum PackUsage {
17e042fbc331atagen2026-10-08 12:39 UTC2135
    Emoticon,
17e042fbc331atagen2026-10-08 12:39 UTC2136
    Sticker,
17e042fbc331atagen2026-10-08 12:39 UTC2137
}
17e042fbc331atagen2026-10-08 12:39 UTC2138
96fdf90aacd6atagen2026-09-08 08:24 UTC2139
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC2140
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC2141
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC2142
pub struct MediaDescriptor {
96fdf90aacd6atagen2026-09-08 08:24 UTC2143
    pub id: MediaId,
96fdf90aacd6atagen2026-09-08 08:24 UTC2144
    pub kind: MediaKind,
9bd34e25bb86atagen2026-10-24 07:23 UTC2145
    /// only for unencrypted media, an encrypted file's mxc is ciphertext without the keys
9bd34e25bb86atagen2026-10-24 07:23 UTC2146
    pub mxc: Option<OwnedMxcUri>,
96fdf90aacd6atagen2026-09-08 08:24 UTC2147
    pub filename: String,
96fdf90aacd6atagen2026-09-08 08:24 UTC2148
    pub caption: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC2149
    pub mimetype: Option<String>,
96fdf90aacd6atagen2026-09-08 08:24 UTC2150
    pub size_bytes: Option<u64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC2151
    pub width: Option<u64>,
96fdf90aacd6atagen2026-09-08 08:24 UTC2152
    pub height: Option<u64>,
5a52012c9b1datagen2026-09-24 23:45 UTC2153
    pub duration_ms: Option<u64>,
5a52012c9b1datagen2026-09-24 23:45 UTC2154
    pub blurhash: Option<String>,
5a52012c9b1datagen2026-09-24 23:45 UTC2155
    /// the uploader sent a thumbnail, so `MediaSize::Thumbnail` won't need the server to resize
5a52012c9b1datagen2026-09-24 23:45 UTC2156
    pub has_thumbnail: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC2157
}
96fdf90aacd6atagen2026-09-08 08:24 UTC2158
96fdf90aacd6atagen2026-09-08 08:24 UTC2159
#[derive(Clone, Debug, Eq, Hash, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC2160
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC2161
pub struct MediaId(String);
96fdf90aacd6atagen2026-09-08 08:24 UTC2162
96fdf90aacd6atagen2026-09-08 08:24 UTC2163
impl MediaId {
96fdf90aacd6atagen2026-09-08 08:24 UTC2164
    pub(crate) fn new(value: String) -> Self {
96fdf90aacd6atagen2026-09-08 08:24 UTC2165
        Self(value)
96fdf90aacd6atagen2026-09-08 08:24 UTC2166
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC2167
5d2974de5826atagen2026-10-08 11:29 UTC2168
    /// plain media carries no keys, so it needs no registering and never expires
5d2974de5826atagen2026-10-08 11:29 UTC2169
    pub(crate) fn plain<U: AsRef<str> + ?Sized>(uri: &U) -> Self {
5d2974de5826atagen2026-10-08 11:29 UTC2170
        Self(uri.as_ref().to_owned())
5d2974de5826atagen2026-10-08 11:29 UTC2171
    }
5d2974de5826atagen2026-10-08 11:29 UTC2172
5d2974de5826atagen2026-10-08 11:29 UTC2173
    pub(crate) fn as_plain(&self) -> Option<&MxcUri> {
5d2974de5826atagen2026-10-08 11:29 UTC2174
        self.0.starts_with("mxc://").then(|| self.0.as_str().into())
5d2974de5826atagen2026-10-08 11:29 UTC2175
    }
5d2974de5826atagen2026-10-08 11:29 UTC2176
96fdf90aacd6atagen2026-09-08 08:24 UTC2177
    #[must_use]
96fdf90aacd6atagen2026-09-08 08:24 UTC2178
    pub fn as_str(&self) -> &str {
96fdf90aacd6atagen2026-09-08 08:24 UTC2179
        &self.0
96fdf90aacd6atagen2026-09-08 08:24 UTC2180
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC2181
}
96fdf90aacd6atagen2026-09-08 08:24 UTC2182
5a52012c9b1datagen2026-09-24 23:45 UTC2183
/// 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 UTC2184
impl std::str::FromStr for MediaId {
5a52012c9b1datagen2026-09-24 23:45 UTC2185
    type Err = std::convert::Infallible;
5a52012c9b1datagen2026-09-24 23:45 UTC2186
5a52012c9b1datagen2026-09-24 23:45 UTC2187
    fn from_str(value: &str) -> Result<Self, Self::Err> {
5a52012c9b1datagen2026-09-24 23:45 UTC2188
        Ok(Self(value.to_owned()))
5a52012c9b1datagen2026-09-24 23:45 UTC2189
    }
5a52012c9b1datagen2026-09-24 23:45 UTC2190
}
5a52012c9b1datagen2026-09-24 23:45 UTC2191
5a52012c9b1datagen2026-09-24 23:45 UTC2192
impl From<String> for MediaId {
5a52012c9b1datagen2026-09-24 23:45 UTC2193
    fn from(value: String) -> Self {
5a52012c9b1datagen2026-09-24 23:45 UTC2194
        Self(value)
5a52012c9b1datagen2026-09-24 23:45 UTC2195
    }
5a52012c9b1datagen2026-09-24 23:45 UTC2196
}
5a52012c9b1datagen2026-09-24 23:45 UTC2197
96fdf90aacd6atagen2026-09-08 08:24 UTC2198
impl std::fmt::Display for MediaId {
96fdf90aacd6atagen2026-09-08 08:24 UTC2199
    fn fmt(&self, formatter: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
96fdf90aacd6atagen2026-09-08 08:24 UTC2200
        self.0.fmt(formatter)
96fdf90aacd6atagen2026-09-08 08:24 UTC2201
    }
96fdf90aacd6atagen2026-09-08 08:24 UTC2202
}
96fdf90aacd6atagen2026-09-08 08:24 UTC2203
96fdf90aacd6atagen2026-09-08 08:24 UTC2204
#[derive(Clone, Copy, Debug, Eq, Hash, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC2205
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
5a52012c9b1datagen2026-09-24 23:45 UTC2206
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC2207
pub enum MediaSize {
96fdf90aacd6atagen2026-09-08 08:24 UTC2208
    Full,
31ce2453c82fatagen2026-09-24 13:07 UTC2209
    /// a hint. an uploader's own thumbnail wins over the server resizing anything
31ce2453c82fatagen2026-09-24 13:07 UTC2210
    Thumbnail {
31ce2453c82fatagen2026-09-24 13:07 UTC2211
        width: u32,
31ce2453c82fatagen2026-09-24 13:07 UTC2212
        height: u32,
31ce2453c82fatagen2026-09-24 13:07 UTC2213
    },
31ce2453c82fatagen2026-09-24 13:07 UTC2214
}
31ce2453c82fatagen2026-09-24 13:07 UTC2215
31ce2453c82fatagen2026-09-24 13:07 UTC2216
#[derive(Clone, Debug, Eq, PartialEq)]
31ce2453c82fatagen2026-09-24 13:07 UTC2217
#[non_exhaustive]
31ce2453c82fatagen2026-09-24 13:07 UTC2218
pub struct Media {
31ce2453c82fatagen2026-09-24 13:07 UTC2219
    pub bytes: Arc<[u8]>,
31ce2453c82fatagen2026-09-24 13:07 UTC2220
    pub mimetype: String,
96fdf90aacd6atagen2026-09-08 08:24 UTC2221
}
96fdf90aacd6atagen2026-09-08 08:24 UTC2222
5b21b919d1e6atagen2026-09-27 11:47 UTC2223
/// where media lives, for a host that fetches and decrypts it itself
5b21b919d1e6atagen2026-09-27 11:47 UTC2224
#[derive(Clone, Debug, Eq, PartialEq)]
5b21b919d1e6atagen2026-09-27 11:47 UTC2225
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
5b21b919d1e6atagen2026-09-27 11:47 UTC2226
pub enum MediaLocation {
5b21b919d1e6atagen2026-09-27 11:47 UTC2227
    File(MediaFile),
5b21b919d1e6atagen2026-09-27 11:47 UTC2228
    /// a resize of plaintext, so never encrypted. plenty of servers refuse some, and `media`
5b21b919d1e6atagen2026-09-27 11:47 UTC2229
    /// then fetches `fallback` instead, so should you
5b21b919d1e6atagen2026-09-27 11:47 UTC2230
    ServerThumbnail {
5b21b919d1e6atagen2026-09-27 11:47 UTC2231
        url: String,
5b21b919d1e6atagen2026-09-27 11:47 UTC2232
        fallback: MediaFile,
5b21b919d1e6atagen2026-09-27 11:47 UTC2233
    },
5b21b919d1e6atagen2026-09-27 11:47 UTC2234
    /// still in the send queue with no url yet. `media` has the bytes
5b21b919d1e6atagen2026-09-27 11:47 UTC2235
    Local,
5b21b919d1e6atagen2026-09-27 11:47 UTC2236
}
5b21b919d1e6atagen2026-09-27 11:47 UTC2237
5b21b919d1e6atagen2026-09-27 11:47 UTC2238
#[derive(Clone, Debug, Eq, PartialEq)]
5b21b919d1e6atagen2026-09-27 11:47 UTC2239
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
5b21b919d1e6atagen2026-09-27 11:47 UTC2240
#[non_exhaustive]
5b21b919d1e6atagen2026-09-27 11:47 UTC2241
pub struct MediaFile {
5b21b919d1e6atagen2026-09-27 11:47 UTC2242
    pub url: String,
5b21b919d1e6atagen2026-09-27 11:47 UTC2243
    pub mimetype: Option<String>,
5b21b919d1e6atagen2026-09-27 11:47 UTC2244
    pub declared_size: Option<u64>,
5b21b919d1e6atagen2026-09-27 11:47 UTC2245
    pub encryption: Option<AttachmentEncryption>,
5b21b919d1e6atagen2026-09-27 11:47 UTC2246
}
5b21b919d1e6atagen2026-09-27 11:47 UTC2247
5b21b919d1e6atagen2026-09-27 11:47 UTC2248
/// AES-256-CTR, the only attachment cipher matrix has
5b21b919d1e6atagen2026-09-27 11:47 UTC2249
#[derive(Clone, Debug, Eq, PartialEq)]
5b21b919d1e6atagen2026-09-27 11:47 UTC2250
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
5b21b919d1e6atagen2026-09-27 11:47 UTC2251
#[non_exhaustive]
5b21b919d1e6atagen2026-09-27 11:47 UTC2252
pub struct AttachmentEncryption {
5b21b919d1e6atagen2026-09-27 11:47 UTC2253
    /// the JWK `k`, unpadded url-safe base64
5b21b919d1e6atagen2026-09-27 11:47 UTC2254
    pub key: String,
5b21b919d1e6atagen2026-09-27 11:47 UTC2255
    /// unpadded base64, the initial counter block
5b21b919d1e6atagen2026-09-27 11:47 UTC2256
    pub iv: String,
5b21b919d1e6atagen2026-09-27 11:47 UTC2257
    /// unpadded base64 SHA-256 of the whole ciphertext, so a partial read goes unchecked
5b21b919d1e6atagen2026-09-27 11:47 UTC2258
    pub sha256: String,
5b21b919d1e6atagen2026-09-27 11:47 UTC2259
}
5b21b919d1e6atagen2026-09-27 11:47 UTC2260
96fdf90aacd6atagen2026-09-08 08:24 UTC2261
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC2262
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC2263
pub enum MediaKind {
96fdf90aacd6atagen2026-09-08 08:24 UTC2264
    Image,
96fdf90aacd6atagen2026-09-08 08:24 UTC2265
    Video,
96fdf90aacd6atagen2026-09-08 08:24 UTC2266
    Audio,
96fdf90aacd6atagen2026-09-08 08:24 UTC2267
    File,
96fdf90aacd6atagen2026-09-08 08:24 UTC2268
    Sticker,
96fdf90aacd6atagen2026-09-08 08:24 UTC2269
}
96fdf90aacd6atagen2026-09-08 08:24 UTC2270
96fdf90aacd6atagen2026-09-08 08:24 UTC2271
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC2272
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
31ce2453c82fatagen2026-09-24 13:07 UTC2273
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC2274
pub struct TypingState {
96fdf90aacd6atagen2026-09-08 08:24 UTC2275
    pub room_id: OwnedRoomId,
96fdf90aacd6atagen2026-09-08 08:24 UTC2276
    pub users: Vec<OwnedUserId>,
96fdf90aacd6atagen2026-09-08 08:24 UTC2277
}
96fdf90aacd6atagen2026-09-08 08:24 UTC2278
96fdf90aacd6atagen2026-09-08 08:24 UTC2279
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC2280
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC2281
pub enum HistoryState {
96fdf90aacd6atagen2026-09-08 08:24 UTC2282
    Idle,
96fdf90aacd6atagen2026-09-08 08:24 UTC2283
    Loading,
96fdf90aacd6atagen2026-09-08 08:24 UTC2284
    StartReached,
96fdf90aacd6atagen2026-09-08 08:24 UTC2285
    Failed(String),
96fdf90aacd6atagen2026-09-08 08:24 UTC2286
}
96fdf90aacd6atagen2026-09-08 08:24 UTC2287
96fdf90aacd6atagen2026-09-08 08:24 UTC2288
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC2289
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
c9f0fd0ee1ccatagen2026-10-25 06:16 UTC2290
pub enum RecentHistoryState {
d9b96952ec60atagen2026-10-25 09:07 UTC2291
    /// nothing running and nothing to show, which is also what closing the room leaves
c9f0fd0ee1ccatagen2026-10-25 06:16 UTC2292
    Idle,
c9f0fd0ee1ccatagen2026-10-25 06:16 UTC2293
    Loading,
c9f0fd0ee1ccatagen2026-10-25 06:16 UTC2294
    Loaded,
d9b96952ec60atagen2026-10-25 09:07 UTC2295
    Cancelled,
002c79e4c6ecatagen2026-10-25 10:42 UTC2296
    /// stays until a retry, or until closing the room makes it `Idle`
c9f0fd0ee1ccatagen2026-10-25 06:16 UTC2297
    Failed(String),
c9f0fd0ee1ccatagen2026-10-25 06:16 UTC2298
}
c9f0fd0ee1ccatagen2026-10-25 06:16 UTC2299
c9f0fd0ee1ccatagen2026-10-25 06:16 UTC2300
#[derive(Clone, Debug, Eq, PartialEq)]
c9f0fd0ee1ccatagen2026-10-25 06:16 UTC2301
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC2302
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC2303
pub struct EncryptionState {
96fdf90aacd6atagen2026-09-08 08:24 UTC2304
    pub device_id: OwnedDeviceId,
96fdf90aacd6atagen2026-09-08 08:24 UTC2305
    pub device_verified: bool,
96fdf90aacd6atagen2026-09-08 08:24 UTC2306
    pub recovery: RecoveryState,
96fdf90aacd6atagen2026-09-08 08:24 UTC2307
    pub key_backup: KeyBackupState,
96fdf90aacd6atagen2026-09-08 08:24 UTC2308
}
96fdf90aacd6atagen2026-09-08 08:24 UTC2309
96fdf90aacd6atagen2026-09-08 08:24 UTC2310
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC2311
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC2312
pub enum KeyBackupState {
96fdf90aacd6atagen2026-09-08 08:24 UTC2313
    Unknown,
96fdf90aacd6atagen2026-09-08 08:24 UTC2314
    Creating,
96fdf90aacd6atagen2026-09-08 08:24 UTC2315
    Enabling,
96fdf90aacd6atagen2026-09-08 08:24 UTC2316
    Resuming,
96fdf90aacd6atagen2026-09-08 08:24 UTC2317
    Downloading,
96fdf90aacd6atagen2026-09-08 08:24 UTC2318
    Enabled,
96fdf90aacd6atagen2026-09-08 08:24 UTC2319
    Disabling,
96fdf90aacd6atagen2026-09-08 08:24 UTC2320
}
96fdf90aacd6atagen2026-09-08 08:24 UTC2321
96fdf90aacd6atagen2026-09-08 08:24 UTC2322
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC2323
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC2324
pub enum RecoveryState {
96fdf90aacd6atagen2026-09-08 08:24 UTC2325
    Unknown,
96fdf90aacd6atagen2026-09-08 08:24 UTC2326
    Disabled,
743123167e29atagen2026-10-26 04:02 UTC2327
    /// `enable_recovery` is running
743123167e29atagen2026-10-26 04:02 UTC2328
    Enabling,
96fdf90aacd6atagen2026-09-08 08:24 UTC2329
    Incomplete,
96fdf90aacd6atagen2026-09-08 08:24 UTC2330
    Enabled,
96fdf90aacd6atagen2026-09-08 08:24 UTC2331
}
96fdf90aacd6atagen2026-09-08 08:24 UTC2332
743123167e29atagen2026-10-26 04:02 UTC2333
/// shown to a person once. macltok never stores or logs it, and Debug hides it
743123167e29atagen2026-10-26 04:02 UTC2334
#[derive(Clone, Eq, PartialEq)]
743123167e29atagen2026-10-26 04:02 UTC2335
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize), serde(transparent))]
743123167e29atagen2026-10-26 04:02 UTC2336
pub struct RecoveryKey(String);
743123167e29atagen2026-10-26 04:02 UTC2337
743123167e29atagen2026-10-26 04:02 UTC2338
impl RecoveryKey {
743123167e29atagen2026-10-26 04:02 UTC2339
    pub(crate) fn new(key: String) -> Self {
743123167e29atagen2026-10-26 04:02 UTC2340
        Self(key)
743123167e29atagen2026-10-26 04:02 UTC2341
    }
743123167e29atagen2026-10-26 04:02 UTC2342
743123167e29atagen2026-10-26 04:02 UTC2343
    pub fn as_str(&self) -> &str {
743123167e29atagen2026-10-26 04:02 UTC2344
        &self.0
743123167e29atagen2026-10-26 04:02 UTC2345
    }
743123167e29atagen2026-10-26 04:02 UTC2346
}
743123167e29atagen2026-10-26 04:02 UTC2347
743123167e29atagen2026-10-26 04:02 UTC2348
impl fmt::Debug for RecoveryKey {
743123167e29atagen2026-10-26 04:02 UTC2349
    fn fmt(&self, formatter: &mut fmt::Formatter<'_>) -> fmt::Result {
743123167e29atagen2026-10-26 04:02 UTC2350
        formatter.write_str("RecoveryKey(...)")
743123167e29atagen2026-10-26 04:02 UTC2351
    }
743123167e29atagen2026-10-26 04:02 UTC2352
}
743123167e29atagen2026-10-26 04:02 UTC2353
743123167e29atagen2026-10-26 04:02 UTC2354
impl fmt::Display for RecoveryKey {
743123167e29atagen2026-10-26 04:02 UTC2355
    fn fmt(&self, formatter: &mut fmt::Formatter<'_>) -> fmt::Result {
743123167e29atagen2026-10-26 04:02 UTC2356
        formatter.write_str(&self.0)
743123167e29atagen2026-10-26 04:02 UTC2357
    }
743123167e29atagen2026-10-26 04:02 UTC2358
}
743123167e29atagen2026-10-26 04:02 UTC2359
96fdf90aacd6atagen2026-09-08 08:24 UTC2360
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC2361
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
5a52012c9b1datagen2026-09-24 23:45 UTC2362
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC2363
pub enum VerificationAction {
5a52012c9b1datagen2026-09-24 23:45 UTC2364
    /// take up a request another device sent, which arrives as `VerificationState::Incoming`
5a52012c9b1datagen2026-09-24 23:45 UTC2365
    Accept,
96fdf90aacd6atagen2026-09-08 08:24 UTC2366
    Confirm,
96fdf90aacd6atagen2026-09-08 08:24 UTC2367
    Reject,
96fdf90aacd6atagen2026-09-08 08:24 UTC2368
    Cancel,
96fdf90aacd6atagen2026-09-08 08:24 UTC2369
}
96fdf90aacd6atagen2026-09-08 08:24 UTC2370
96fdf90aacd6atagen2026-09-08 08:24 UTC2371
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC2372
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC2373
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC2374
pub enum VerificationTarget {
96fdf90aacd6atagen2026-09-08 08:24 UTC2375
    OwnIdentity,
96fdf90aacd6atagen2026-09-08 08:24 UTC2376
    User(OwnedUserId),
96fdf90aacd6atagen2026-09-08 08:24 UTC2377
    Device {
96fdf90aacd6atagen2026-09-08 08:24 UTC2378
        user_id: OwnedUserId,
96fdf90aacd6atagen2026-09-08 08:24 UTC2379
        device_id: OwnedDeviceId,
96fdf90aacd6atagen2026-09-08 08:24 UTC2380
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC2381
}
96fdf90aacd6atagen2026-09-08 08:24 UTC2382
96fdf90aacd6atagen2026-09-08 08:24 UTC2383
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC2384
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC2385
pub enum VerificationState {
96fdf90aacd6atagen2026-09-08 08:24 UTC2386
    Waiting,
5a52012c9b1datagen2026-09-24 23:45 UTC2387
    /// someone else asked. `Accept` to go ahead, `Cancel` to turn them down
5a52012c9b1datagen2026-09-24 23:45 UTC2388
    Incoming {
5a52012c9b1datagen2026-09-24 23:45 UTC2389
        user_id: OwnedUserId,
5a52012c9b1datagen2026-09-24 23:45 UTC2390
        device_id: Option<OwnedDeviceId>,
5a52012c9b1datagen2026-09-24 23:45 UTC2391
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC2392
    Comparison {
96fdf90aacd6atagen2026-09-08 08:24 UTC2393
        emojis: Vec<(String, String)>,
96fdf90aacd6atagen2026-09-08 08:24 UTC2394
        decimals: (u16, u16, u16),
96fdf90aacd6atagen2026-09-08 08:24 UTC2395
    },
96fdf90aacd6atagen2026-09-08 08:24 UTC2396
    Confirmed,
96fdf90aacd6atagen2026-09-08 08:24 UTC2397
    Done,
96fdf90aacd6atagen2026-09-08 08:24 UTC2398
    Cancelled(String),
96fdf90aacd6atagen2026-09-08 08:24 UTC2399
    Failed(VerificationFailure),
96fdf90aacd6atagen2026-09-08 08:24 UTC2400
}
96fdf90aacd6atagen2026-09-08 08:24 UTC2401
96fdf90aacd6atagen2026-09-08 08:24 UTC2402
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC2403
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC2404
pub enum VerificationFailure {
96fdf90aacd6atagen2026-09-08 08:24 UTC2405
    RequestAcceptance(String),
96fdf90aacd6atagen2026-09-08 08:24 UTC2406
    SasStartup(String),
96fdf90aacd6atagen2026-09-08 08:24 UTC2407
    SasAcceptance(String),
96fdf90aacd6atagen2026-09-08 08:24 UTC2408
    RequestStreamEnded,
96fdf90aacd6atagen2026-09-08 08:24 UTC2409
    SasStreamEnded,
96fdf90aacd6atagen2026-09-08 08:24 UTC2410
}
96fdf90aacd6atagen2026-09-08 08:24 UTC2411
96fdf90aacd6atagen2026-09-08 08:24 UTC2412
#[derive(Clone, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC2413
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC2414
#[non_exhaustive]
96fdf90aacd6atagen2026-09-08 08:24 UTC2415
pub struct EngineFailure {
96fdf90aacd6atagen2026-09-08 08:24 UTC2416
    pub kind: EngineErrorKind,
96fdf90aacd6atagen2026-09-08 08:24 UTC2417
    pub message: String,
96fdf90aacd6atagen2026-09-08 08:24 UTC2418
}
96fdf90aacd6atagen2026-09-08 08:24 UTC2419
96fdf90aacd6atagen2026-09-08 08:24 UTC2420
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
96fdf90aacd6atagen2026-09-08 08:24 UTC2421
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
96fdf90aacd6atagen2026-09-08 08:24 UTC2422
pub enum EngineErrorKind {
96fdf90aacd6atagen2026-09-08 08:24 UTC2423
    EventReceiverClosed,
96fdf90aacd6atagen2026-09-08 08:24 UTC2424
    Watcher,
96fdf90aacd6atagen2026-09-08 08:24 UTC2425
    Other,
96fdf90aacd6atagen2026-09-08 08:24 UTC2426
}
2006a11ce142atagen2026-10-26 04:02 UTC2427
2006a11ce142atagen2026-10-26 04:02 UTC2428
#[derive(Clone, Debug, Eq, PartialEq)]
2006a11ce142atagen2026-10-26 04:02 UTC2429
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
2006a11ce142atagen2026-10-26 04:02 UTC2430
pub struct PusherKey {
2006a11ce142atagen2026-10-26 04:02 UTC2431
    pub app_id: String,
2006a11ce142atagen2026-10-26 04:02 UTC2432
    pub pushkey: String,
2006a11ce142atagen2026-10-26 04:02 UTC2433
}
2006a11ce142atagen2026-10-26 04:02 UTC2434
2006a11ce142atagen2026-10-26 04:02 UTC2435
#[derive(Clone, Debug, PartialEq)]
2006a11ce142atagen2026-10-26 04:02 UTC2436
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
2006a11ce142atagen2026-10-26 04:02 UTC2437
pub struct HttpPusher {
2006a11ce142atagen2026-10-26 04:02 UTC2438
    pub app_id: String,
2006a11ce142atagen2026-10-26 04:02 UTC2439
    pub pushkey: String,
2006a11ce142atagen2026-10-26 04:02 UTC2440
    pub app_display_name: String,
2006a11ce142atagen2026-10-26 04:02 UTC2441
    pub device_display_name: String,
2006a11ce142atagen2026-10-26 04:02 UTC2442
    pub lang: String,
2006a11ce142atagen2026-10-26 04:02 UTC2443
    pub url: String,
2006a11ce142atagen2026-10-26 04:02 UTC2444
    pub format: PushFormat,
2006a11ce142atagen2026-10-26 04:02 UTC2445
    /// sent beside `url` and `format` in the pusher's data, and back to the gateway in every push
2006a11ce142atagen2026-10-26 04:02 UTC2446
    pub data: serde_json::Map<String, serde_json::Value>,
2006a11ce142atagen2026-10-26 04:02 UTC2447
}
2006a11ce142atagen2026-10-26 04:02 UTC2448
2006a11ce142atagen2026-10-26 04:02 UTC2449
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
2006a11ce142atagen2026-10-26 04:02 UTC2450
#[cfg_attr(feature = "serde", derive(Serialize, Deserialize))]
2006a11ce142atagen2026-10-26 04:02 UTC2451
pub enum PushFormat {
2006a11ce142atagen2026-10-26 04:02 UTC2452
    Full,
2006a11ce142atagen2026-10-26 04:02 UTC2453
    EventIdOnly,
2006a11ce142atagen2026-10-26 04:02 UTC2454
}