AzuraCast/src/Controller/Frontend/PublicPages/PodcastFeedAction.php

<?php

declare(strict_types=1);

namespace App\Controller\Frontend\PublicPages;

use App\Controller\SingleActionInterface;
use App\Entity\ApiGenerator\PodcastApiGenerator;
use App\Entity\ApiGenerator\PodcastEpisodeApiGenerator;
use App\Entity\PodcastCategory;
use App\Entity\PodcastEpisode;
use App\Exception\NotFoundException;
use App\Http\Response;
use App\Http\ServerRequest;
use App\Xml\Writer;
use Carbon\CarbonImmutable;
use DateTime;
use MarcW\RssWriter\Extension\Core\Channel as RssChannel;
use Psr\Http\Message\ResponseInterface;

final class PodcastFeedAction implements SingleActionInterface
{
    public function __construct(
        private readonly PodcastApiGenerator $podcastApiGenerator,
        private readonly PodcastEpisodeApiGenerator $episodeApiGenerator
    ) {
    }

    public function __invoke(
        ServerRequest $request,
        Response $response,
        array $params
    ): ResponseInterface {
        $station = $request->getStation();
        if (!$station->getEnablePublicPage()) {
            throw NotFoundException::station();
        }

        $podcast = $request->getPodcast();

        $channel = new RssChannel();
        $channel->setTtl(5);
        $channel->setLastBuildDate(new DateTime());

        // Fetch podcast API feed.
        $podcastApi = $this->podcastApiGenerator->__invoke($podcast, $request);

        $now = CarbonImmutable::now($station->getTimezoneObject());

        $rss = [
            '@xmlns:itunes' => 'http://www.itunes.com/dtds/podcast-1.0.dtd',
            '@xmlns:sy' => 'http://purl.org/rss/1.0/modules/syndication/',
            '@xmlns:slash' => 'http://purl.org/rss/1.0/modules/slash/',
            '@xmlns:atom' => 'http://www.w3.org/2005/Atom',
            '@xmlns:podcast' => 'https://podcastindex.org/namespace/1.0',
            '@version' => '2.0',
        ];

        $channel = [
            'title' => $podcastApi->title,
            'link' => $podcastApi->link ?? $podcastApi->links['self'],
            'description' => $podcastApi->description,
            'language' => $podcastApi->language,
            'lastBuildDate' => $now->toRssString(),
            'category' => $podcast->getCategories()->map(
                function (PodcastCategory $podcastCategory) {
                    return (null === $podcastCategory->getSubTitle())
                        ? $podcastCategory->getTitle()
                        : $podcastCategory->getSubTitle();
                }
            )->getValues(),
            'ttl' => 5,
            'image' => [
                'url' => $podcastApi->art,
                'title' => $podcastApi->title,
            ],
            'itunes:author' => $podcastApi->author,
            'itunes:owner' => [],
            'itunes:image' => [
                '@href' => $podcastApi->art,
            ],
            'itunes:explicit' => 'false',
            'itunes:category' => $podcast->getCategories()->map(
                function (PodcastCategory $podcastCategory) {
                    return (null === $podcastCategory->getSubTitle())
                        ? [
                            '@text' => $podcastCategory->getTitle(),
                        ] : [
                            '@text' => $podcastCategory->getTitle(),
                            'itunes:category' => [
                                '@text' => $podcastCategory->getSubTitle(),
                            ],
                        ];
                }
            )->getValues(),
            'atom:link' => [
                '@rel' => 'self',
                '@type' => 'application/rss+xml',
                '@href' => (string)$request->getUri(),
            ],
            'item' => [],
        ];

        if (null !== $podcastApi->link) {
            $channel['image']['link'] = $podcastApi->link;
        }

        if (empty($podcastApi->author) && empty($podcastApi->email)) {
            unset($channel['itunes:owner']);
        } else {
            $channel['itunes:owner'] = [
                'itunes:name' => $podcastApi->author,
                'itunes:email' => $podcastApi->email,
            ];
        }

        // Iterate through episodes.
        $hasPublishedEpisode = false;
        $hasExplicitEpisode = false;

        /** @var PodcastEpisode $episode */
        foreach ($podcast->getEpisodes() as $episode) {
            if (!$episode->isPublished()) {
                continue;
            }

            $hasPublishedEpisode = true;
            if ($episode->getExplicit()) {
                $hasExplicitEpisode = true;
            }

            $channel['item'][] = $this->buildItemForEpisode($episode, $request);
        }

        if (!$hasPublishedEpisode) {
            throw NotFoundException::podcast();
        }

        if ($hasExplicitEpisode) {
            $channel['itunes:explicit'] = 'true';
        }

        $rss['channel'] = $channel;

        $response->getBody()->write(
            Writer::toString($rss, 'rss')
        );

        return $response
            ->withHeader('Content-Type', 'application/rss+xml')
            ->withHeader('X-Robots-Tag', 'index, nofollow');
    }

    private function buildItemForEpisode(PodcastEpisode $episode, ServerRequest $request): array
    {
        $station = $request->getStation();

        $episodeApi = $this->episodeApiGenerator->__invoke($episode, $request);

        $publishedAt = CarbonImmutable::createFromTimestamp($episodeApi->publish_at, $station->getTimezoneObject());

        $item = [
            'title' => $episodeApi->title,
            'link' => $episodeApi->link ?? $episodeApi->links['self'],
            'description' => $episodeApi->description,
            'enclosure' => [
                '@url' => $episodeApi->links['download'],
            ],
            'guid' => [
                '@isPermaLink' => 'false',
                '_' => $episodeApi->id,
            ],
            'pubDate' => $publishedAt->toRssString(),
            'itunes:image' => [
                '@href' => $episodeApi->art,
            ],
            'itunes:explicit' => $episodeApi->explicit ? 'true' : 'false',
        ];

        $podcastMedia = $episode->getMedia();
        if (null !== $podcastMedia) {
            $item['enclosure']['@length'] = $podcastMedia->getLength();
            $item['enclosure']['@type'] = $podcastMedia->getMimeType();
        }

        if (null !== $episodeApi->season_number) {
            $item['itunes:season'] = (string)$episodeApi->season_number;
        }
        if (null !== $episodeApi->episode_number) {
            $item['itunes:episode'] = (string)$episodeApi->episode_number;
        }

        return $item;
    }
}