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

//! Endpoints for sending events.

/// [PUT /_matrix/client/r0/rooms/{roomId}/state/{eventType}](https://matrix.org/docs/spec/client_server/r0.2.0.html#put-matrix-client-r0-rooms-roomid-state-eventtype)
pub mod send_state_event_for_empty_key {
    use ruma_api_macros::ruma_api;
    use ruma_identifiers::{RoomId, EventId};
    use ruma_events::EventType;
    use serde_json::Value;

    ruma_api! {
        metadata {
            description: "Send a state event to a room associated with the empty state key.",
            method: PUT,
            name: "send_state_event_for_empty_key",
            path: "/_matrix/client/r0/rooms/:room_id/state/:event_type",
            rate_limited: false,
            requires_authentication: true,
        }

        request {
            /// The room to set the state in.
            #[ruma_api(path)]
            pub room_id: RoomId,
            /// The type of event to send.
            #[ruma_api(path)]
            pub event_type: EventType,
            /// The event's content.
            #[ruma_api(body)]
            pub data: Value,
        }

        response {
            /// A unique identifier for the event.
            pub event_id: EventId,
        }
    }
}

/// [PUT /_matrix/client/r0/rooms/{roomId}/state/{eventType}/{stateKey}](https://matrix.org/docs/spec/client_server/r0.2.0.html#put-matrix-client-r0-rooms-roomid-state-eventtype-statekey)
pub mod send_state_event_for_key {
    use ruma_api_macros::ruma_api;
    use ruma_identifiers::{RoomId, EventId};
    use ruma_events::EventType;
    use serde_json::Value;

    ruma_api! {
        metadata {
            description: "Send a state event to a room associated with a given state key.",
            method: PUT,
            name: "send_state_event_for_key",
            path: "/_matrix/client/r0/rooms/:room_id/state/:event_type/:state_key",
            rate_limited: false,
            requires_authentication: true,
        }

        request {
            /// The room to set the state in.
            #[ruma_api(path)]
            pub room_id: RoomId,
            /// The type of event to send.
            #[ruma_api(path)]
            pub event_type: EventType,
            /// The state_key for the state to send. Defaults to the empty string.
            #[ruma_api(path)]
            pub state_key: String,
            /// The event's content.
            #[ruma_api(body)]
            pub data: Value,
        }

        response {
            /// A unique identifier for the event.
            pub event_id: EventId,
        }
    }
}

/// [PUT /_matrix/client/r0/rooms/{roomId}/send/{eventType}/{txnId}](https://matrix.org/docs/spec/client_server/r0.2.0.html#put-matrix-client-r0-rooms-roomid-send-eventtype-txnid)
pub mod send_message_event {
    use ruma_api_macros::ruma_api;
    use ruma_identifiers::{RoomId, EventId};
    use ruma_events::EventType;
    use ruma_events::room::message::MessageEventContent;

    ruma_api! {
        metadata {
            description: "Send a message event to a room.",
            method: PUT,
            name: "send_message_event",
            path: "/_matrix/client/r0/rooms/:room_id/send/:event_type/:txn_id",
            rate_limited: false,
            requires_authentication: true,
        }

        request {
            /// The room to send the event to.
            #[ruma_api(path)]
            pub room_id: RoomId,
            /// The type of event to send.
            #[ruma_api(path)]
            pub event_type: EventType,
            /// The transaction ID for this event.
            ///
            /// Clients should generate an ID unique across requests with the
            /// same access token; it will be used by the server to ensure
            /// idempotency of requests.
            #[ruma_api(path)]
            pub txn_id: String,
            /// The event's content.
            #[ruma_api(body)]
            pub data: MessageEventContent,
        }

        response {
            /// A unique identifier for the event.
            pub event_id: EventId,
        }
    }
}