1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
//! `GET /_matrix/client/v1/summary/{roomIdOrAlias}`
//!
//! Experimental API enabled with MSC3266.
//!
//! Returns a short description of the state of a room.

pub mod msc3266 {
    //! `MSC3266` ([MSC])
    //!
    //! [MSC]: https://github.com/matrix-org/matrix-spec-proposals/pull/3266

    use js_int::UInt;
    use ruma_common::{
        api::{request, response, Metadata},
        metadata,
        room::RoomType,
        space::SpaceRoomJoinRule,
        EventEncryptionAlgorithm, OwnedMxcUri, OwnedRoomAliasId, OwnedRoomId, OwnedRoomOrAliasId,
        OwnedServerName, RoomVersionId,
    };
    use ruma_events::room::member::MembershipState;

    const METADATA: Metadata = metadata! {
        method: GET,
        rate_limited: false,
        authentication: AccessTokenOptional,
        history: {
            unstable => "/_matrix/client/unstable/im.nheko.summary/rooms/:room_id_or_alias/summary",
        }
    };

    /// Request type for the `get_summary` endpoint.
    #[request(error = crate::Error)]
    pub struct Request {
        /// Alias or ID of the room to be summarized.
        #[ruma_api(path)]
        pub room_id_or_alias: OwnedRoomOrAliasId,

        /// A list of servers the homeserver should attempt to use to peek at the room.
        ///
        /// Defaults to an empty `Vec`.
        #[serde(default, skip_serializing_if = "Vec::is_empty")]
        #[ruma_api(query)]
        pub via: Vec<OwnedServerName>,
    }

    /// Response type for the `get_summary` endpoint.
    #[response(error = crate::Error)]
    pub struct Response {
        /// ID of the room (useful if it's an alias).
        pub room_id: OwnedRoomId,

        /// The canonical alias for this room, if set.
        #[serde(skip_serializing_if = "Option::is_none")]
        pub canonical_alias: Option<OwnedRoomAliasId>,

        /// Avatar of the room.
        #[serde(skip_serializing_if = "Option::is_none")]
        pub avatar_url: Option<OwnedMxcUri>,

        /// Whether guests can join the room.
        pub guest_can_join: bool,

        /// Name of the room.
        #[serde(skip_serializing_if = "Option::is_none")]
        pub name: Option<String>,

        /// Member count of the room.
        pub num_joined_members: UInt,

        /// Topic of the room.
        #[serde(skip_serializing_if = "Option::is_none")]
        pub topic: Option<String>,

        /// Whether the room history can be read without joining.
        pub world_readable: bool,

        /// Join rule of the room.
        pub join_rule: SpaceRoomJoinRule,

        /// Type of the room, if any.
        #[serde(skip_serializing_if = "Option::is_none")]
        pub room_type: Option<RoomType>,

        /// Version of the room.
        #[serde(skip_serializing_if = "Option::is_none")]
        pub room_version: Option<RoomVersionId>,

        /// The current membership of this user in the room.
        ///
        /// This field will not be present when called unauthenticated, but is required when called
        /// authenticated. It should be `leave` if the server doesn't know about the room, since
        /// for all other membership states the server would know about the room already.
        #[serde(skip_serializing_if = "Option::is_none")]
        pub membership: Option<MembershipState>,

        /// If the room is encrypted, the algorithm used for this room.
        #[serde(skip_serializing_if = "Option::is_none")]
        pub encryption: Option<EventEncryptionAlgorithm>,
    }

    impl Request {
        /// Creates a new `Request` with the given room or alias ID and via server names.
        pub fn new(room_id_or_alias: OwnedRoomOrAliasId, via: Vec<OwnedServerName>) -> Self {
            Self { room_id_or_alias, via }
        }
    }

    impl Response {
        /// Creates a new [`Response`] with all the mandatory fields set.
        pub fn new(
            room_id: OwnedRoomId,
            join_rule: SpaceRoomJoinRule,
            guest_can_join: bool,
            num_joined_members: UInt,
            world_readable: bool,
        ) -> Self {
            Self {
                room_id,
                canonical_alias: None,
                avatar_url: None,
                guest_can_join,
                name: None,
                num_joined_members,
                topic: None,
                world_readable,
                join_rule,
                room_type: None,
                room_version: None,
                membership: None,
                encryption: None,
            }
        }
    }
}