Skip to main content

tuwunel_admin/room/moderation/
mod.rs

1mod ban_list_of_rooms;
2mod ban_room;
3mod list_banned_rooms;
4mod unban_room;
5
6use clap::Subcommand;
7use futures::StreamExt;
8use ruma::{OwnedRoomOrAliasId, RoomId};
9use tuwunel_core::{Result, debug, utils::ReadyExt, warn};
10use tuwunel_service::Services;
11
12use crate::admin_command_dispatch;
13
14#[admin_command_dispatch]
15#[derive(Debug, Subcommand)]
16pub(crate) enum RoomModerationCommand {
17	/// - Bans a room from local users joining and evicts all our local users
18	///   (including server
19	/// admins)
20	///   from the room. Also blocks any invites (local and remote) for the
21	///   banned room, and disables federation entirely with it.
22	BanRoom {
23		/// The room in the format of `!roomid:example.com` or a room alias in
24		/// the format of `#roomalias:example.com`
25		room: OwnedRoomOrAliasId,
26	},
27
28	/// - Bans a list of rooms (room IDs and room aliases) from a newline
29	///   delimited codeblock similar to `user deactivate-all`. Applies the same
30	///   steps as ban-room
31	BanListOfRooms,
32
33	/// - Unbans a room to allow local users to join again
34	///
35	/// The room's `m.federate` property is unaffected; it is fixed at room
36	/// creation.
37	UnbanRoom {
38		/// The room in the format of `!roomid:example.com` or a room alias in
39		/// the format of `#roomalias:example.com`
40		room: OwnedRoomOrAliasId,
41	},
42
43	/// - List of all rooms we have banned
44	ListBannedRooms {
45		#[arg(long)]
46		/// Whether to only output room IDs without supplementary room
47		/// information
48		no_details: bool,
49	},
50}
51
52async fn do_ban_room(services: &Services, room_id: &RoomId) {
53	let federation_lock = services
54		.event_handler
55		.mutex_federation
56		.lock(room_id)
57		.await;
58
59	let state_lock = services.state.mutex.lock(room_id).await;
60
61	services.metadata.ban_room(room_id);
62	drop(state_lock);
63	drop(federation_lock);
64
65	debug!("Banned {room_id} successfully");
66
67	debug!("Making all users leave the room {room_id} and forgetting it");
68	let mut users = services
69		.state_cache
70		.room_members(room_id)
71		.ready_filter(|user| services.globals.user_is_local(user))
72		.map(ToOwned::to_owned)
73		.boxed(); // Unpin for next
74
75	while let Some(ref user_id) = users.next().await {
76		debug!(
77			"Attempting leave for user {user_id} in room {room_id} (ignoring all errors, \
78			 evicting admins too)",
79		);
80
81		let state_lock = services.state.mutex.lock(room_id).await;
82
83		if let Err(e) = services
84			.membership
85			.leave(user_id, room_id, None, false, &state_lock)
86			.await
87		{
88			warn!("Failed to leave room: {e}");
89		}
90
91		services
92			.state_cache
93			.forget(room_id, user_id)
94			.await
95			.inspect_err(|error| warn!(%user_id, %room_id, %error, "Failed to forget room"))
96			.ok();
97	}
98
99	// remove any local aliases, ignore errors
100	services
101		.alias
102		.local_aliases_for_room(room_id)
103		.map(ToOwned::to_owned)
104		.for_each(async |local_alias| {
105			if let Err(e) = services.alias.remove_alias(&local_alias).await {
106				warn!("Error removing alias {local_alias} for {room_id}: {e}");
107			}
108		})
109		.await;
110
111	// unpublish from room directory, ignore errors
112	services.directory.set_not_public(room_id);
113
114	services.metadata.disable_room(room_id);
115}