AzuraCast/src/Controller/Api/Stations/StreamersController.php

324 lines
11 KiB
PHP

<?php
declare(strict_types=1);
namespace App\Controller\Api\Stations;
use App\Controller\Api\Traits\CanSearchResults;
use App\Controller\Api\Traits\CanSortResults;
use App\Entity\Repository\StationScheduleRepository;
use App\Entity\Repository\StationStreamerRepository;
use App\Entity\StationSchedule;
use App\Entity\StationStreamer;
use App\Http\Response;
use App\Http\ServerRequest;
use App\OpenApi;
use App\Radio\AutoDJ\Scheduler;
use App\Service\Flow\UploadedFile;
use App\Utilities\Types;
use Carbon\CarbonInterface;
use InvalidArgumentException;
use OpenApi\Attributes as OA;
use Psr\Http\Message\ResponseInterface;
use Symfony\Component\Serializer\Serializer;
use Symfony\Component\Validator\Validator\ValidatorInterface;
/** @extends AbstractScheduledEntityController<StationStreamer> */
#[
OA\Get(
path: '/station/{station_id}/streamers',
operationId: 'getStreamers',
description: 'List all current Streamer/DJ accounts for the specified station.',
security: OpenApi::API_KEY_SECURITY,
tags: ['Stations: Streamers/DJs'],
parameters: [
new OA\Parameter(ref: OpenApi::REF_STATION_ID_REQUIRED),
],
responses: [
new OA\Response(
response: 200,
description: 'Success',
content: new OA\JsonContent(
type: 'array',
items: new OA\Items(ref: '#/components/schemas/StationStreamer')
)
),
new OA\Response(ref: OpenApi::REF_RESPONSE_ACCESS_DENIED, response: 403),
new OA\Response(ref: OpenApi::REF_RESPONSE_NOT_FOUND, response: 404),
new OA\Response(ref: OpenApi::REF_RESPONSE_GENERIC_ERROR, response: 500),
]
),
OA\Post(
path: '/station/{station_id}/streamers',
operationId: 'addStreamer',
description: 'Create a new Streamer/DJ account.',
security: OpenApi::API_KEY_SECURITY,
requestBody: new OA\RequestBody(
content: new OA\JsonContent(ref: '#/components/schemas/StationStreamer')
),
tags: ['Stations: Streamers/DJs'],
parameters: [
new OA\Parameter(ref: OpenApi::REF_STATION_ID_REQUIRED),
],
responses: [
new OA\Response(
response: 200,
description: 'Success',
content: new OA\JsonContent(ref: '#/components/schemas/StationStreamer')
),
new OA\Response(ref: OpenApi::REF_RESPONSE_ACCESS_DENIED, response: 403),
new OA\Response(ref: OpenApi::REF_RESPONSE_NOT_FOUND, response: 404),
new OA\Response(ref: OpenApi::REF_RESPONSE_GENERIC_ERROR, response: 500),
]
),
OA\Get(
path: '/station/{station_id}/streamer/{id}',
operationId: 'getStreamer',
description: 'Retrieve details for a single Streamer/DJ account.',
security: OpenApi::API_KEY_SECURITY,
tags: ['Stations: Streamers/DJs'],
parameters: [
new OA\Parameter(ref: OpenApi::REF_STATION_ID_REQUIRED),
new OA\Parameter(
name: 'id',
description: 'Streamer ID',
in: 'path',
required: true,
schema: new OA\Schema(type: 'integer', format: 'int64')
),
],
responses: [
new OA\Response(
response: 200,
description: 'Success',
content: new OA\JsonContent(ref: '#/components/schemas/StationStreamer')
),
new OA\Response(ref: OpenApi::REF_RESPONSE_ACCESS_DENIED, response: 403),
new OA\Response(ref: OpenApi::REF_RESPONSE_NOT_FOUND, response: 404),
new OA\Response(ref: OpenApi::REF_RESPONSE_GENERIC_ERROR, response: 500),
]
),
OA\Put(
path: '/station/{station_id}/streamer/{id}',
operationId: 'editStreamer',
description: 'Update details of a single Streamer/DJ account.',
security: OpenApi::API_KEY_SECURITY,
requestBody: new OA\RequestBody(
content: new OA\JsonContent(ref: '#/components/schemas/StationStreamer')
),
tags: ['Stations: Streamers/DJs'],
parameters: [
new OA\Parameter(ref: OpenApi::REF_STATION_ID_REQUIRED),
new OA\Parameter(
name: 'id',
description: 'Streamer ID',
in: 'path',
required: true,
schema: new OA\Schema(type: 'integer', format: 'int64')
),
],
responses: [
new OA\Response(ref: OpenApi::REF_RESPONSE_SUCCESS, response: 200),
new OA\Response(ref: OpenApi::REF_RESPONSE_ACCESS_DENIED, response: 403),
new OA\Response(ref: OpenApi::REF_RESPONSE_NOT_FOUND, response: 404),
new OA\Response(ref: OpenApi::REF_RESPONSE_GENERIC_ERROR, response: 500),
]
),
OA\Delete(
path: '/station/{station_id}/streamer/{id}',
operationId: 'deleteStreamer',
description: 'Delete a single Streamer/DJ account.',
security: OpenApi::API_KEY_SECURITY,
tags: ['Stations: Streamers/DJs'],
parameters: [
new OA\Parameter(ref: OpenApi::REF_STATION_ID_REQUIRED),
new OA\Parameter(
name: 'id',
description: 'StationStreamer ID',
in: 'path',
required: true,
schema: new OA\Schema(type: 'integer', format: 'int64')
),
],
responses: [
new OA\Response(ref: OpenApi::REF_RESPONSE_SUCCESS, response: 200),
new OA\Response(ref: OpenApi::REF_RESPONSE_ACCESS_DENIED, response: 403),
new OA\Response(ref: OpenApi::REF_RESPONSE_NOT_FOUND, response: 404),
new OA\Response(ref: OpenApi::REF_RESPONSE_GENERIC_ERROR, response: 500),
]
)
]
final class StreamersController extends AbstractScheduledEntityController
{
use CanSortResults;
use CanSearchResults;
protected string $entityClass = StationStreamer::class;
protected string $resourceRouteName = 'api:stations:streamer';
public function __construct(
private readonly StationStreamerRepository $streamerRepo,
StationScheduleRepository $scheduleRepo,
Scheduler $scheduler,
Serializer $serializer,
ValidatorInterface $validator
) {
parent::__construct($scheduleRepo, $scheduler, $serializer, $validator);
}
public function listAction(
ServerRequest $request,
Response $response,
array $params
): ResponseInterface {
$station = $request->getStation();
$qb = $this->em->createQueryBuilder()
->select('e')
->from(StationStreamer::class, 'e')
->where('e.station = :station')
->setParameter('station', $station);
$qb = $this->sortQueryBuilder(
$request,
$qb,
[
'display_name' => 'e.display_name',
'streamer_username' => 'e.streamer_username',
],
'e.streamer_username'
);
$qb = $this->searchQueryBuilder(
$request,
$qb,
[
'e.streamer_username',
'e.display_name',
]
);
return $this->listPaginatedFromQuery($request, $response, $qb->getQuery());
}
protected function createRecord(ServerRequest $request, array $data): object
{
$station = $request->getStation();
/** @var StationStreamer $record */
$record = $this->editRecord(
$data,
new StationStreamer($station)
);
if (!empty($data['artwork_file'])) {
$artwork = UploadedFile::fromArray($data['artwork_file'], $station->getRadioTempDir());
$this->streamerRepo->writeArtwork(
$record,
$artwork->readAndDeleteUploadedFile()
);
$this->em->persist($record);
$this->em->flush();
}
return $record;
}
public function scheduleAction(
ServerRequest $request,
Response $response
): ResponseInterface {
$station = $request->getStation();
$scheduleItems = $this->em->createQuery(
<<<'DQL'
SELECT ssc, sst
FROM App\Entity\StationSchedule ssc
LEFT JOIN ssc.streamer sst
WHERE sst.station = :station AND sst.is_active = 1
DQL
)->setParameter('station', $station)
->execute();
return $this->renderEvents(
$request,
$response,
$scheduleItems,
function (
StationSchedule $scheduleItem,
CarbonInterface $start,
CarbonInterface $end
) use (
$request,
$station
) {
/** @var StationStreamer $streamer */
$streamer = $scheduleItem->getStreamer();
return [
'id' => $streamer->getId(),
'title' => $streamer->getDisplayName(),
'start' => $start->toIso8601String(),
'end' => $end->toIso8601String(),
'edit_url' => $request->getRouter()->named(
'api:stations:streamer',
['station_id' => $station->getId(), 'id' => $streamer->getId()]
),
];
}
);
}
/**
* @param StationStreamer $record
* @param ServerRequest $request
*
* @return mixed[]
*/
protected function viewRecord(object $record, ServerRequest $request): array
{
$return = parent::viewRecord($record, $request);
$router = $request->getRouter();
$isInternal = Types::bool($request->getParam('internal'), false, true);
$return['has_custom_art'] = (0 !== $record->getArtUpdatedAt());
$routeParams = [
'id' => $record->getIdRequired(),
];
if ($return['has_custom_art']) {
$routeParams['timestamp'] = $record->getArtUpdatedAt();
}
$return['art'] = $router->fromHere(
routeName: 'api:stations:streamer:art',
routeParams: $routeParams,
absolute: !$isInternal
);
$return['links']['broadcasts'] = $router->fromHere(
routeName: 'api:stations:streamer:broadcasts',
routeParams: ['id' => $record->getId()],
absolute: !$isInternal
);
$return['links']['art'] = $router->fromHere(
routeName: 'api:stations:streamer:art-internal',
routeParams: ['id' => $record->getId()],
absolute: !$isInternal
);
return $return;
}
protected function deleteRecord(object $record): void
{
if (!($record instanceof StationStreamer)) {
throw new InvalidArgumentException(sprintf('Record must be an instance of %s.', $this->entityClass));
}
$this->streamerRepo->delete($record);
}
}