Skip to main content

tuwunel_service/rooms/state_accessor/
server_can.rs

1//! Evaluates federation visibility against historical room state.
2//!
3//! History visibility determines whether an origin may receive an event. A
4//! separate strict membership check supports sender-erasure pruning.
5
6use futures::StreamExt;
7use ruma::{
8	EventId, RoomId, ServerName, UserId,
9	events::{StateEventType, room::history_visibility::HistoryVisibility},
10};
11use tuwunel_core::{implement, utils::stream::ReadyExt};
12
13/// Reports whether a server may see an event over federation.
14///
15/// Missing event state is allowed, and missing or invalid history visibility
16/// defaults to `shared`. For `invited` and `joined`, a currently joined user
17/// from the origin must also hold the required membership at the event.
18#[implement(super::Service)]
19#[tracing::instrument(skip_all, level = "trace")]
20pub async fn server_can_see_event(
21	&self,
22	origin: &ServerName,
23	room_id: &RoomId,
24	event_id: &EventId,
25) -> bool {
26	let Ok(shortstatehash) = self
27		.services
28		.state
29		.pdu_shortstatehash(event_id)
30		.await
31	else {
32		return true;
33	};
34
35	let history_visibility = self.history_visibility(shortstatehash).await;
36
37	let current_server_members = self
38		.services
39		.state_cache
40		.room_members(room_id)
41		.ready_filter(|member| member.server_name() == origin);
42
43	match history_visibility {
44		| HistoryVisibility::Invited => {
45			// Allow if any member on requesting server was AT LEAST invited, else deny
46			current_server_members
47				.any(|member| self.user_was_invited(shortstatehash, member))
48				.await
49		},
50		| HistoryVisibility::Joined => {
51			// Allow if any member on requested server was joined, else deny
52			current_server_members
53				.any(|member| self.user_was_joined(shortstatehash, member))
54				.await
55		},
56		| HistoryVisibility::WorldReadable | HistoryVisibility::Shared | _ => true,
57	}
58}
59
60/// Reports whether any user from an origin was joined at an event.
61///
62/// This MSC4025 helper scans membership state at the event and denies when the
63/// snapshot cannot be resolved. Invalid user state keys are skipped.
64#[implement(super::Service)]
65#[tracing::instrument(skip_all, level = "trace")]
66pub async fn server_joined_at_pdu(&self, origin: &ServerName, event_id: &EventId) -> bool {
67	let Ok(shortstatehash) = self
68		.services
69		.state
70		.pdu_shortstatehash(event_id)
71		.await
72	else {
73		return false;
74	};
75
76	self.state_keys(shortstatehash, &StateEventType::RoomMember)
77		.ready_filter_map(|state_key| UserId::parse(state_key.as_str()).ok())
78		.ready_filter(|user_id| user_id.server_name() == origin)
79		.any(async |user_id| {
80			self.user_was_joined(shortstatehash, &user_id)
81				.await
82		})
83		.await
84}