spreed/lib/Controller/FederationController.php
jld3103 c75e7be132
Add annotations for FederationController
Signed-off-by: jld3103 <jld3103yt@gmail.com>
2023-10-06 12:39:28 +02:00

129 lines
3.7 KiB
PHP

<?php
declare(strict_types=1);
/**
* @copyright Copyright (c) 2021, Gary Kim <gary@garykim.dev>
*
* @author Gary Kim <gary@garykim.dev>
* @author Kate Döen <kate.doeen@nextcloud.com>
*
* @license GNU AGPL version 3 or any later version
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU Affero General Public License as
* published by the Free Software Foundation, either version 3 of the
* License, or (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Affero General Public License for more details.
*
* You should have received a copy of the GNU Affero General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*
*/
namespace OCA\Talk\Controller;
use OCA\Talk\AppInfo\Application;
use OCA\Talk\Exceptions\RoomNotFoundException;
use OCA\Talk\Exceptions\UnauthorizedException;
use OCA\Talk\Federation\FederationManager;
use OCA\Talk\Manager;
use OCA\Talk\Model\Invitation;
use OCA\Talk\ResponseDefinitions;
use OCP\AppFramework\Db\MultipleObjectsReturnedException;
use OCP\AppFramework\Http;
use OCP\AppFramework\Http\Attribute\NoAdminRequired;
use OCP\AppFramework\Http\DataResponse;
use OCP\AppFramework\OCSController;
use OCP\DB\Exception as DBException;
use OCP\IRequest;
use OCP\IUser;
use OCP\IUserSession;
/**
* @psalm-import-type SpreedRoomShare from ResponseDefinitions
*/
class FederationController extends OCSController {
public function __construct(
IRequest $request,
private FederationManager $federationManager,
private Manager $talkManager,
private IUserSession $userSession,
) {
parent::__construct(Application::APP_ID, $request);
}
/**
* Accept a federated share
*
* @param int $id ID of the share
* @return DataResponse<Http::STATUS_OK, array<empty>, array{}>
* @throws UnauthorizedException
* @throws DBException
* @throws MultipleObjectsReturnedException
*
* 200: Share accepted successfully
*/
#[NoAdminRequired]
public function acceptShare(int $id): DataResponse {
$user = $this->userSession->getUser();
if (!$user instanceof IUser) {
throw new UnauthorizedException();
}
$this->federationManager->acceptRemoteRoomShare($user, $id);
return new DataResponse();
}
/**
* Reject a federated share
*
* @param int $id ID of the share
* @return DataResponse<Http::STATUS_OK, array<empty>, array{}>
* @throws UnauthorizedException
* @throws DBException
* @throws MultipleObjectsReturnedException
*
* 200: Share rejected successfully
*/
#[NoAdminRequired]
public function rejectShare(int $id): DataResponse {
$user = $this->userSession->getUser();
if (!$user instanceof IUser) {
throw new UnauthorizedException();
}
$this->federationManager->rejectRemoteRoomShare($user, $id);
return new DataResponse();
}
/**
* Get a list of federated shares
*
* @return DataResponse<Http::STATUS_OK, SpreedRoomShare[], array{}>
*
* 200: Get list of received shares successfully
*/
#[NoAdminRequired]
public function getShares(): DataResponse {
$user = $this->userSession->getUser();
if (!$user instanceof IUser) {
throw new UnauthorizedException();
}
$invitations = $this->federationManager->getRemoteRoomShares($user);
return new DataResponse(array_map(function (Invitation $invitation) {
$data = $invitation->asArray();
try {
$room = $this->talkManager->getRoomById($invitation->getRoomId());
$data['remote_token'] = $room->getRemoteToken();
$data['remote_server'] = $room->getRemoteServer();
} catch (RoomNotFoundException $exception) {
}
return $data;
}, $invitations));
}
}