feat: room_membership api

Author: kilimnik

src/lib.rs

@@ -13,6 +13,7 @@ pub mod account_validity;
 pub mod background_updates;
 pub mod experimental_features;
 pub mod register_users;
+pub mod room_membership;
 pub mod rooms;
 pub mod users;
 pub mod version;

src/room_membership.rs

@@ -0,0 +1,3 @@
+//! Endpoints in the `/_synapse/admin/v<x>/join/` scope.
+
+pub mod join_room;

src/room_membership/join_room.rs

@@ -0,0 +1,3 @@
+//! Different versions of the endpoint to place users into rooms.
+
+pub mod v1;

src/room_membership/join_room/v1.rs

@@ -0,0 +1,88 @@
+//! [POST /_synapse/admin/v1/join/:room_id_or_alias](https://github.com/element-hq/synapse/blob/master/docs/admin_api/room_membership.md)
+
+use ruma::{
+    api::{request, response, Metadata},
+    metadata, OwnedRoomId, OwnedRoomOrAliasId, OwnedUserId,
+};
+use serde::{Deserialize, Serialize};
+
+const METADATA: Metadata = metadata! {
+    method: POST,
+    rate_limited: false,
+    authentication: AccessToken,
+    history: {
+        unstable => "/_synapse/admin/v1/join/:room_id_or_alias",
+    }
+};
+
+#[request]
+#[derive(Serialize, Deserialize, PartialEq)]
+pub struct Request {
+    /// Alias or ID of the room to join.
+    #[ruma_api(path)]
+    pub room_id_or_alias: OwnedRoomOrAliasId,
+
+    /// User to join the room.
+    pub user_id: OwnedUserId,
+}
+
+#[response]
+#[derive(Serialize, Deserialize, PartialEq)]
+pub struct Response {
+    /// Room ID of the joined room.
+    pub room_id: OwnedRoomId,
+}
+
+impl Request {
+    /// Creates a new `Request` with the given room or alias ID and user id.
+    pub fn new(room_id_or_alias: OwnedRoomOrAliasId, user_id: OwnedUserId) -> Self {
+        Self { room_id_or_alias, user_id }
+    }
+}
+
+impl Response {
+    /// Creates a new `Response` with the given room id
+    pub fn new(room_id: OwnedRoomId) -> Self {
+        Self { room_id }
+    }
+}
+
+#[test]
+fn test_join_room() {
+    use ruma::{RoomId, UserId};
+    use std::convert::TryFrom;
+
+    let room_id: &RoomId =
+        <&RoomId>::try_from("!test:example.com").expect("Failed to create RoomId");
+
+    let user_id: &UserId =
+        <&UserId>::try_from("@carl:example.com").expect("Failed to create UserId.");
+
+    // Check create request
+    let request = Request::new(room_id.to_owned().into(), user_id.to_owned());
+
+    // Serialize
+    let serialized_request = serde_json::to_string(&request).expect("Failed to serialize request");
+    assert_eq!(
+        serialized_request,
+        "{\"room_id_or_alias\":\"!test:example.com\",\"user_id\":\"@carl:example.com\"}"
+    );
+
+    // Deserialize
+    let deserialized_request: Request =
+        serde_json::from_str(&serialized_request).expect("Failed to deserialize request");
+    assert_eq!(deserialized_request, request);
+
+    // Check create response
+    let response = Response::new(room_id.to_owned());
+
+    // Serialize
+    let serialized_response =
+        serde_json::to_string(&response).expect("Failed to serialize response");
+    assert_eq!(serialized_response, "{\"room_id\":\"!test:example.com\"}");
+
+    // Deserialize
+    let deserialized_response: Response =
+        serde_json::from_str(&serialized_response).expect("Failed to deserialize response");
+    assert_eq!(deserialized_response, response);
+}