UPSTREAM BASELINE: nextcloud/spreed v22.0.12 (без изменений)

Источник: https://github.com/nextcloud/spreed/archive/refs/tags/v22.0.12.tar.gz
С этого коммита ветка официального Nextcloud Talk отрезана (решение владельца 2026-07-06).
Все дальнейшие изменения — только наши; версии релизов: 22.0.12-f7.N.

lib/Federation/Proxy/TalkV1/Controller/RoomController.php

@@ -0,0 +1,169 @@
+<?php
+
+declare(strict_types=1);
+/**
+ * SPDX-FileCopyrightText: 2024 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace OCA\Talk\Federation\Proxy\TalkV1\Controller;
+
+use OCA\Talk\Exceptions\CannotReachRemoteException;
+use OCA\Talk\Federation\Proxy\TalkV1\ProxyRequest;
+use OCA\Talk\Federation\Proxy\TalkV1\UserConverter;
+use OCA\Talk\Model\Session;
+use OCA\Talk\Participant;
+use OCA\Talk\ResponseDefinitions;
+use OCA\Talk\Room;
+use OCP\AppFramework\Http;
+use OCP\AppFramework\Http\DataResponse;
+
+/**
+ * @psalm-import-type TalkCapabilities from ResponseDefinitions
+ * @psalm-import-type TalkParticipant from ResponseDefinitions
+ * @psalm-import-type TalkRoom from ResponseDefinitions
+ */
+class RoomController {
+	public function __construct(
+		protected ProxyRequest $proxy,
+		protected UserConverter $userConverter,
+	) {
+	}
+
+	/**
+	 * @see \OCA\Talk\Controller\RoomController::getParticipants()
+	 *
+	 * @return DataResponse<Http::STATUS_OK, list<TalkParticipant>, array{X-Nextcloud-Has-User-Statuses?: bool}>
+	 * @throws CannotReachRemoteException
+	 *
+	 * 200: Participants returned
+	 * 403: Missing permissions for getting participants
+	 */
+	public function getParticipants(Room $room, Participant $participant): DataResponse {
+		$proxy = $this->proxy->get(
+			$participant->getAttendee()->getInvitedCloudId(),
+			$participant->getAttendee()->getAccessToken(),
+			$room->getRemoteServer() . '/ocs/v2.php/apps/spreed/api/v4/room/' . $room->getRemoteToken() . '/participants',
+		);
+
+		/** @var list<TalkParticipant> $data */
+		$data = $this->proxy->getOCSData($proxy);
+
+		/** @var list<TalkParticipant> $data */
+		$data = $this->userConverter->convertAttendees($room, $data, 'actorType', 'actorId', 'displayName');
+		$headers = [];
+		if ($proxy->getHeader('X-Nextcloud-Has-User-Statuses')) {
+			$headers['X-Nextcloud-Has-User-Statuses'] = (bool)$proxy->getHeader('X-Nextcloud-Has-User-Statuses');
+		}
+
+		return new DataResponse($data, Http::STATUS_OK, $headers);
+	}
+
+	/**
+	 * @see \OCA\Talk\Controller\RoomController::joinFederatedRoom()
+	 *
+	 * @param Room $room the federated room to join
+	 * @param Participant $participant the federated user to will join the room;
+	 *                                 the participant must have a session
+	 * @return DataResponse<Http::STATUS_OK|Http::STATUS_NOT_FOUND, array<empty>, array{X-Nextcloud-Talk-Proxy-Hash: string}>
+	 * @throws CannotReachRemoteException
+	 *
+	 * 200: Federated user joined the room
+	 * 404: Room not found
+	 */
+	public function joinFederatedRoom(Room $room, Participant $participant): DataResponse {
+		$options = [
+			'sessionId' => $participant->getSession()->getSessionId(),
+		];
+
+		$proxy = $this->proxy->post(
+			$participant->getAttendee()->getInvitedCloudId(),
+			$participant->getAttendee()->getAccessToken(),
+			$room->getRemoteServer() . '/ocs/v2.php/apps/spreed/api/v4/room/' . $room->getRemoteToken() . '/federation/active',
+			$options,
+		);
+
+		$statusCode = $proxy->getStatusCode();
+		if (!in_array($statusCode, [Http::STATUS_OK, Http::STATUS_NOT_FOUND], true)) {
+			$this->proxy->logUnexpectedStatusCode(__METHOD__, $proxy->getStatusCode());
+			throw new CannotReachRemoteException();
+		}
+
+		$headers = ['X-Nextcloud-Talk-Proxy-Hash' => $this->proxy->overwrittenRemoteTalkHash($proxy->getHeader('X-Nextcloud-Talk-Hash'))];
+
+		/** @var TalkRoom[] $data */
+		$data = $this->proxy->getOCSData($proxy);
+
+		$data = $this->userConverter->convertAttendee($room, $data, 'actorType', 'actorId', 'displayName');
+
+		return new DataResponse($data, $statusCode, $headers);
+	}
+
+	/**
+	 * @see \OCA\Talk\Controller\RoomController::leaveFederatedRoom()
+	 *
+	 * @param Room $room the federated room to leave
+	 * @param Participant $participant the federated user that will leave the
+	 *                                 room; the participant must have a session
+	 * @return DataResponse<Http::STATUS_OK, array<empty>, array{}>
+	 * @throws CannotReachRemoteException
+	 *
+	 * 200: Federated user left the room
+	 */
+	public function leaveFederatedRoom(Room $room, Participant $participant): DataResponse {
+		$options = [
+			'sessionId' => $participant->getSession()->getSessionId(),
+		];
+
+		$proxy = $this->proxy->delete(
+			$participant->getAttendee()->getInvitedCloudId(),
+			$participant->getAttendee()->getAccessToken(),
+			$room->getRemoteServer() . '/ocs/v2.php/apps/spreed/api/v4/room/' . $room->getRemoteToken() . '/federation/active',
+			$options,
+		);
+
+		// STATUS_NOT_FOUND is not taken into account, as it should happen only
+		// for non-federation requests.
+		$statusCode = $proxy->getStatusCode();
+		if (!in_array($statusCode, [Http::STATUS_OK], true)) {
+			$this->proxy->logUnexpectedStatusCode(__METHOD__, $proxy->getStatusCode());
+			throw new CannotReachRemoteException();
+		}
+
+		return new DataResponse([], $statusCode);
+	}
+
+	/**
+	 * @see \OCA\Talk\Controller\RoomController::getCapabilities()
+	 *
+	 * @return DataResponse<Http::STATUS_OK, TalkCapabilities|array<empty>, array{X-Nextcloud-Talk-Hash: string}>
+	 * @throws CannotReachRemoteException
+	 *
+	 * 200: Get capabilities successfully
+	 */
+	public function getCapabilities(Room $room, Participant $participant): DataResponse {
+		$proxy = $this->proxy->get(
+			$participant->getAttendee()->getInvitedCloudId(),
+			$participant->getAttendee()->getAccessToken(),
+			$room->getRemoteServer() . '/ocs/v2.php/apps/spreed/api/v4/room/' . $room->getRemoteToken() . '/capabilities',
+		);
+
+		/** @var TalkCapabilities|array<empty> $data */
+		$data = $this->proxy->getOCSData($proxy);
+
+		$headers = [
+			'X-Nextcloud-Talk-Hash' => $this->proxy->overwrittenRemoteTalkHash($proxy->getHeader('X-Nextcloud-Talk-Hash')),
+		];
+
+		return new DataResponse($data, Http::STATUS_OK, $headers);
+	}
+
+	/**
+	 * @return array<string, mixed>|\stdClass
+	 */
+	protected function emptyArray(): array|\stdClass {
+		// Cheating here to make sure the array is always a
+		// JSON object on the API, even when there is no entry at all.
+		return new \stdClass();
+	}
+}