osu-web / app / Transformers / BuildTransformer.php

<?php

// Copyright (c) ppy Pty Ltd <[e-mail]>. Licensed under the GNU Affero General Public License v3.0.
// See the LICENCE file in the repository root for full licence text.

namespace App\Transformers;

use App\Models\Build;
use App\Models\ChangelogEntry;

class BuildTransformer extends TransformerAbstract
{
    protected array $availableIncludes = [
        'changelog_entries',
        'update_stream',
        'versions',
    ];

    protected array $defaultIncludes = [
        'update_stream',
    ];

    public function transform(Build $build)
    {
        return [
            'created_at' => json_time($build->date),
            'display_version' => $build->displayVersion(),
            'id' => $build->getKey(),
            'users' => $build->users ?? 0,
            'version' => $build->version,
            'youtube_id' => $build->youtube_id,
        ];
    }

    public function includeChangelogEntries(Build $build)
    {
        $legacyEntries = $build
            ->defaultChangelogs
            ->filter(fn ($item) => $item->stream_id === $build->stream_id)
            ->map(fn ($item) => ChangelogEntry::convertLegacy($item));

        $entries = $build
            ->defaultChangelogEntries
            ->concat($legacyEntries)
            ->sortBy('created_at');

        if ($entries->count() === 0) {
            $entries = collect([ChangelogEntry::placeholder()]);
        }

        return $this->collection($entries, new ChangelogEntryTransformer());
    }

    public function includeUpdateStream(Build $build)
    {
        return $this->item($build->updateStream, new UpdateStreamTransformer());
    }

    public function includeVersions(Build $build)
    {
        $versions = [];

        $next = $build->versionNext();
        if ($next !== null) {
            $versions['next'] = json_item($next, $this);
        }

        $previous = $build->versionPrevious();
        if ($previous !== null) {
            $versions['previous'] = json_item($previous, $this);
        }

        return $this->primitive($versions);
    }
}