tuwunel_service/rooms/event_handler/

handle_incoming_pdu.rs

use std::collections::HashMap;

use futures::{FutureExt, TryStreamExt, future::try_join5};
use ruma::{
	CanonicalJsonObject, CanonicalJsonValue, EventId, MilliSecondsSinceUnixEpoch, OwnedEventId,
	RoomId, RoomVersionId, ServerName, UserId,
	events::{
		AnyStrippedStateEvent, StateEventType,
		room::member::{MembershipState, RoomMemberEventContent},
	},
};
use tuwunel_core::{
	Err, Result, debug,
	debug::INFO_SPAN_LEVEL,
	debug_warn, err, implement,
	matrix::{Event, PduCount, PduEvent, pdu::MAX_PREV_EVENTS, room_version::from_create_event},
	smallvec::SmallVec,
	trace,
	utils::{
		BoolExt,
		stream::{IterStream, TryWidebandExt},
	},
	warn,
};

use super::backoff::{Context, Disposition};
use crate::rooms::timeline::RawPduId;

type PrevResultsHandled = SmallVec<[PrevHandled; MAX_PREV_EVENTS]>;
type PrevHandled = (OwnedEventId, Handled);
type PrevSplit = SmallVec<[OwnedEventId; MAX_PREV_EVENTS]>;

type Handled = Option<(RawPduId, bool)>;

/// When receiving an event one needs to:
/// 0. Check the server is in the room
/// 1. Skip the PDU if we already know about it
/// 1.1. Remove unsigned field
/// 2. Check signatures, otherwise drop
/// 3. Check content hash, redact if doesn't match
/// 4. Fetch any missing auth events doing all checks listed here starting at 1.
///    These are not timeline events
/// 5. Reject "due to auth events" if can't get all the auth events or some of
///    the auth events are also rejected "due to auth events"
/// 6. Reject "due to auth events" if the event doesn't pass auth based on the
///    auth events
/// 7. Persist this event as an outlier
/// 8. If not timeline event: stop
/// 9. Fetch any missing prev events doing all checks listed here starting at 1.
///    These are timeline events
/// 10. Fetch missing state and auth chain events by calling `/state_ids` at
///     backwards extremities doing all the checks in this list starting at
///     1. These are not timeline events
/// 11. Check the auth of the event passes based on the state of the event
/// 12. Ensure that the state is derived from the previous current state (i.e.
///     we calculated by doing state res where one of the inputs was a
///     previously trusted set of state, don't just trust a set of state we got
///     from a remote)
/// 13. Use state resolution to find new room state
/// 14. Check if the event passes auth based on the "current state" of the room,
///     if not soft fail it
#[implement(super::Service)]
#[tracing::instrument(
	name = "pdu",
	level = INFO_SPAN_LEVEL,
	skip_all,
	fields(%room_id, %event_id),
	ret(level = "debug"),
)]
pub async fn handle_incoming_pdu<'a>(
	&'a self,
	origin: &'a ServerName,
	room_id: &'a RoomId,
	event_id: &'a EventId,
	pdu: CanonicalJsonObject,
	is_timeline_event: bool,
) -> Result<Handled> {
	// 1. Skip the PDU if we already have it as a timeline event
	if let Ok(pdu_id) = self.services.timeline.get_pdu_id(event_id).await {
		debug!(?pdu_id, "Exists.");
		return Ok(Some((pdu_id, false)));
	}

	// 1.1 Check the server is in the room
	let meta_exists = self.services.metadata.exists(room_id).map(Ok);

	// 1.2 Check if the room is disabled
	let is_disabled = self
		.services
		.metadata
		.is_disabled(room_id)
		.map(Ok);

	// 1.3.1 Check room ACL on origin field/server
	let origin_acl_check = self.acl_check(origin, room_id);

	// 1.3.2 Check room ACL on sender's server name
	let sender: &UserId = pdu
		.get("sender")
		.try_into()
		.map_err(|e| err!(Request(InvalidParam("PDU does not have a valid sender key: {e}"))))?;

	let sender_acl_check = sender
		.server_name()
		.ne(origin)
		.then_async(|| self.acl_check(sender.server_name(), room_id));

	// Fetch create event; absent when we are not resident in the room.
	let create_event = self
		.services
		.state_accessor
		.room_state_get(room_id, &StateEventType::RoomCreate, "")
		.map(|result| Ok(result.ok()));

	let (meta_exists, is_disabled, (), (), create_event) = try_join5(
		meta_exists,
		is_disabled,
		origin_acl_check,
		sender_acl_check.map(|o| o.unwrap_or(Ok(()))),
		create_event,
	)
	.await?;

	// When not resident, the only event we can act on is a leave rescinding an
	// out-of-band invite we hold for a local user.
	if !meta_exists {
		return if self
			.handle_rescinded_invite(room_id, &pdu)
			.await?
		{
			Ok(None)
		} else {
			Err!(Request(NotFound("Room is unknown to this server")))
		};
	}

	if is_disabled {
		return Err!(Request(Forbidden("Federation of this room is disabled by this server.")));
	}

	let create_event =
		create_event.ok_or_else(|| err!(Request(NotFound("Room is unknown to this server"))))?;

	let room_version = from_create_event(&create_event)?;
	let recursion_level = 0;

	let (incoming_pdu, pdu) = self
		.handle_outlier_pdu(origin, room_id, event_id, pdu, &room_version, recursion_level, false)
		.await?;

	// 8. if not timeline event: stop
	if !is_timeline_event {
		debug!(
			kind = ?incoming_pdu.event_type(),
			"Not a timeline event.",
		);
		return Ok(None);
	}

	// Skip old events
	let first_ts_in_room = self
		.services
		.timeline
		.first_pdu_in_room(room_id)
		.await?
		.origin_server_ts();

	if incoming_pdu.origin_server_ts() < first_ts_in_room {
		debug!(
			origin_server_ts = ?incoming_pdu.origin_server_ts(),
			?first_ts_in_room,
			"Skipping old event."
		);
		return Ok(None);
	}

	// 9. Fetch any missing prev events doing all checks listed here starting at 1.
	//    These are timeline events
	let (sorted_prev_events, eventid_info) = self
		.fetch_prev(
			origin,
			room_id,
			event_id,
			incoming_pdu.prev_events(),
			&room_version,
			recursion_level,
			first_ts_in_room,
		)
		.await?;

	self.handle_prev_events(
		origin,
		room_id,
		event_id,
		sorted_prev_events,
		eventid_info,
		&room_version,
		recursion_level,
		first_ts_in_room,
		create_event.event_id(),
	)
	.boxed()
	.await?;

	// Done with prev events, now handling the incoming event
	self.upgrade_outlier_to_timeline_pdu(
		origin,
		room_id,
		incoming_pdu,
		pdu,
		&room_version,
		recursion_level,
		create_event.event_id(),
	)
	.boxed()
	.await
}

/// Apply a federated leave that rescinds an out-of-band invite for a local
/// user.
///
/// We are not resident in the room, so the kick cannot be processed as a normal
/// timeline event for lack of room state; but it must still clear the invite so
/// the invited user's `/sync` reflects the rescission. Mirrors Synapse's
/// out-of-band membership handling: only a kick from the original inviter is
/// honored, since without the room state we cannot judge any other sender's
/// authority. Returns `true` when a rescission was applied.
#[implement(super::Service)]
#[tracing::instrument(skip_all, level = "debug", fields(%room_id))]
async fn handle_rescinded_invite(
	&self,
	room_id: &RoomId,
	pdu: &CanonicalJsonObject,
) -> Result<bool> {
	if pdu
		.get("type")
		.and_then(CanonicalJsonValue::as_str)
		!= Some("m.room.member")
	{
		return Ok(false);
	}

	let Some(target) = pdu
		.get("state_key")
		.and_then(CanonicalJsonValue::as_str)
		.and_then(|state_key| UserId::parse(state_key).ok())
	else {
		return Ok(false);
	};

	let Some(sender) = pdu
		.get("sender")
		.and_then(CanonicalJsonValue::as_str)
		.and_then(|sender| UserId::parse(sender).ok())
	else {
		return Ok(false);
	};

	if sender == target || !self.services.globals.user_is_local(&target) {
		return Ok(false);
	}

	let Some(content) = pdu
		.get("content")
		.cloned()
		.map(Into::into)
		.and_then(|content| serde_json::from_value::<RoomMemberEventContent>(content).ok())
	else {
		return Ok(false);
	};

	if content.membership != MembershipState::Leave {
		return Ok(false);
	}

	if self
		.services
		.state_cache
		.user_membership(&target, room_id)
		.await != Some(MembershipState::Invite)
	{
		return Ok(false);
	}

	// Recover the inviter and the room version from the stored stripped state.
	let invite_state = self
		.services
		.state_cache
		.invite_state(&target, room_id)
		.await?;

	let inviter = invite_state
		.iter()
		.find_map(|event| match event.deserialize() {
			| Ok(AnyStrippedStateEvent::RoomMember(member)) if member.state_key == target =>
				Some(member.sender),
			| _ => None,
		});

	// Honor the rescission only from the original inviter.
	if inviter.as_ref() != Some(&sender) {
		return Ok(false);
	}

	let Some(room_version_id) = super::room_version_of(&invite_state) else {
		return Ok(false);
	};

	// Verify the kick is signed by the sender's server before acting on it.
	self.services
		.server_keys
		.verify_event(pdu, Some(&room_version_id))
		.await
		.map_err(|e| {
			err!(Request(InvalidParam("Invite rescission signature is invalid: {e}")))
		})?;

	let count = self.services.globals.next_count();
	self.services
		.state_cache
		.update_membership(
			room_id,
			&target,
			RoomMemberEventContent::new(MembershipState::Leave),
			&sender,
			None,
			None,
			false,
			PduCount::Normal(*count),
		)
		.await?;

	debug!(%room_id, %target, %sender, "Applied a federated invite rescission.");

	Ok(true)
}

/// Upgrade an incoming PDU's previous events, walking interior events after
/// their parents so each derives state locally instead of refetching it.
#[implement(super::Service)]
#[expect(clippy::too_many_arguments)]
async fn handle_prev_events(
	&self,
	origin: &ServerName,
	room_id: &RoomId,
	event_id: &EventId,
	sorted_prev_events: Vec<OwnedEventId>,
	mut eventid_info: HashMap<OwnedEventId, (PduEvent, CanonicalJsonObject)>,
	room_version: &RoomVersionId,
	recursion_level: usize,
	first_ts_in_room: MilliSecondsSinceUnixEpoch,
	create_event_id: &EventId,
) -> Result<()> {
	trace!(
		events = sorted_prev_events.len(),
		event_ids = ?sorted_prev_events,
		"Handling previous events"
	);

	let (interior, extremities): (PrevSplit, PrevSplit) = sorted_prev_events
		.into_iter()
		.partition(|prev_id| {
			eventid_info.get(prev_id).is_some_and(|(pdu, _)| {
				pdu.prev_events()
					.any(|prev| eventid_info.contains_key(prev))
			})
		});

	extremities
		.into_iter()
		.try_stream()
		.map_ok(|prev_id| (eventid_info.remove(&prev_id), prev_id))
		.widen_and_then(MAX_PREV_EVENTS, async |(info, prev_id)| {
			self.upgrade_prev_event(
				origin,
				room_id,
				event_id,
				info,
				room_version,
				recursion_level,
				first_ts_in_room,
				prev_id,
				create_event_id,
			)
			.await
		})
		.try_collect::<PrevResultsHandled>()
		.boxed()
		.await?;

	// Walk interior events forward so each parent commits before its children.
	interior
		.into_iter()
		.try_stream()
		.map_ok(|prev_id| (eventid_info.remove(&prev_id), prev_id))
		.try_for_each(async |(info, prev_id)| {
			self.upgrade_prev_event(
				origin,
				room_id,
				event_id,
				info,
				room_version,
				recursion_level,
				first_ts_in_room,
				prev_id,
				create_event_id,
			)
			.await?;

			Ok(())
		})
		.boxed()
		.await
}

/// Upgrade one previous event, folding a transient failure into a no-op so a
/// single bad prev does not abort the batch; a shutdown still propagates.
#[implement(super::Service)]
#[expect(clippy::too_many_arguments)]
async fn upgrade_prev_event(
	&self,
	origin: &ServerName,
	room_id: &RoomId,
	event_id: &EventId,
	info: Option<(PduEvent, CanonicalJsonObject)>,
	room_version: &RoomVersionId,
	recursion_level: usize,
	first_ts_in_room: MilliSecondsSinceUnixEpoch,
	prev_id: OwnedEventId,
	create_event_id: &EventId,
) -> Result<PrevHandled> {
	self.services.server.check_running()?;
	match self
		.handle_prev_pdu(
			origin,
			room_id,
			event_id,
			info,
			room_version,
			recursion_level,
			first_ts_in_room,
			&prev_id,
			create_event_id,
		)
		.await
	{
		| Ok(handled) => {
			if handled.is_some() {
				self.record_success(Context::Upgrade, &prev_id)
					.await;
				debug!(?prev_id, ?handled, "Prev event processed.");
			} else {
				debug_warn!(?prev_id, "Prev event not processed.");
			}

			Ok((prev_id, handled))
		},
		| Err(e) => {
			self.record_outcome(Context::Upgrade, &prev_id, Disposition::Transient);
			warn!(?prev_id, ?event_id, ?room_id, "Prev event processing failed: {e}");

			Ok((prev_id, None))
		},
	}
}