mirror of
https://github.com/nextcloud/spreed.git
synced 2025-12-17 21:12:20 +01:00
122 lines
3.6 KiB
PHP
122 lines
3.6 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
/**
|
|
* SPDX-FileCopyrightText: 2024 Nextcloud GmbH and Nextcloud contributors
|
|
* SPDX-License-Identifier: AGPL-3.0-or-later
|
|
*/
|
|
|
|
namespace OCA\Talk\Controller;
|
|
|
|
use OCA\Talk\Middleware\Attribute\RequireModeratorParticipant;
|
|
use OCA\Talk\Model\Ban;
|
|
use OCA\Talk\ResponseDefinitions;
|
|
use OCA\Talk\Service\BanService;
|
|
use OCP\AppFramework\Http;
|
|
use OCP\AppFramework\Http\Attribute\ApiRoute;
|
|
use OCP\AppFramework\Http\Attribute\PublicPage;
|
|
use OCP\AppFramework\Http\DataResponse;
|
|
use OCP\AppFramework\Utility\ITimeFactory;
|
|
use OCP\IRequest;
|
|
|
|
/**
|
|
* @psalm-import-type TalkBan from ResponseDefinitions
|
|
*/
|
|
class BanController extends AEnvironmentAwareOCSController {
|
|
public function __construct(
|
|
string $appName,
|
|
IRequest $request,
|
|
protected BanService $banService,
|
|
protected ITimeFactory $timeFactory,
|
|
) {
|
|
parent::__construct($appName, $request);
|
|
}
|
|
|
|
/**
|
|
* Ban an actor or IP address
|
|
*
|
|
* Required capability: `ban-v1`
|
|
*
|
|
* @param 'users'|'guests'|'emails'|'ip' $actorType Type of actor to ban, or `ip` when banning a clients remote address
|
|
* @param string $actorId Actor ID or the IP address or range in case of type `ip`
|
|
* @param string $internalNote Optional internal note (max. 4000 characters)
|
|
* @return DataResponse<Http::STATUS_OK, TalkBan, array{}>|DataResponse<Http::STATUS_BAD_REQUEST, array{error: 'bannedActor'|'internalNote'|'moderator'|'self'|'room'}, array{}>
|
|
*
|
|
* 200: Ban successfully
|
|
* 400: Actor information is invalid
|
|
*/
|
|
#[PublicPage]
|
|
#[RequireModeratorParticipant]
|
|
#[ApiRoute(verb: 'POST', url: '/api/{apiVersion}/ban/{token}', requirements: [
|
|
'apiVersion' => '(v1)',
|
|
'token' => '[a-z0-9]{4,30}',
|
|
])]
|
|
public function banActor(string $actorType, string $actorId, string $internalNote = ''): DataResponse {
|
|
try {
|
|
$moderator = $this->participant->getAttendee();
|
|
|
|
$ban = $this->banService->createBan(
|
|
$this->room,
|
|
$moderator->getActorType(),
|
|
$moderator->getActorId(),
|
|
$moderator->getDisplayName(),
|
|
$actorType,
|
|
$actorId,
|
|
$this->timeFactory->getDateTime(),
|
|
$internalNote
|
|
);
|
|
|
|
return new DataResponse($ban->jsonSerialize(), Http::STATUS_OK);
|
|
} catch (\InvalidArgumentException $e) {
|
|
/** @var 'bannedActor'|'internalNote'|'moderator'|'self' $message */
|
|
$message = $e->getMessage();
|
|
return new DataResponse([
|
|
'error' => $message,
|
|
], Http::STATUS_BAD_REQUEST);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* List the bans of a conversation
|
|
*
|
|
* Required capability: `ban-v1`
|
|
*
|
|
* @return DataResponse<Http::STATUS_OK, list<TalkBan>, array{}>
|
|
*
|
|
* 200: List all bans
|
|
*/
|
|
#[PublicPage]
|
|
#[RequireModeratorParticipant]
|
|
#[ApiRoute(verb: 'GET', url: '/api/{apiVersion}/ban/{token}', requirements: [
|
|
'apiVersion' => '(v1)',
|
|
'token' => '[a-z0-9]{4,30}',
|
|
])]
|
|
public function listBans(): DataResponse {
|
|
$bans = $this->banService->getBansForRoom($this->room->getId());
|
|
$result = array_map(static fn (Ban $ban): array => $ban->jsonSerialize(), $bans);
|
|
return new DataResponse($result, Http::STATUS_OK);
|
|
}
|
|
|
|
/**
|
|
* Unban an actor or IP address
|
|
*
|
|
* Required capability: `ban-v1`
|
|
*
|
|
* @param int $banId ID of the ban to be removed
|
|
* @return DataResponse<Http::STATUS_OK, null, array{}>
|
|
*
|
|
* 200: Unban successfully or not found
|
|
*/
|
|
#[PublicPage]
|
|
#[RequireModeratorParticipant]
|
|
#[ApiRoute(verb: 'DELETE', url: '/api/{apiVersion}/ban/{token}/{banId}', requirements: [
|
|
'apiVersion' => '(v1)',
|
|
'token' => '[a-z0-9]{4,30}',
|
|
'banId' => '[0-9]{1,64}',
|
|
])]
|
|
public function unbanActor(int $banId): DataResponse {
|
|
$this->banService->findAndDeleteBanByIdForRoom($banId, $this->room->getId());
|
|
return new DataResponse(null, Http::STATUS_OK);
|
|
}
|
|
}
|