koel/app/Values/AlbumInformation.php

<?php

namespace App\Values;

use App\Values\Concerns\FormatsLastFmText;
use Illuminate\Contracts\Support\Arrayable;
use Illuminate\Support\Arr;

final class AlbumInformation implements Arrayable
{
    use FormatsLastFmText;

    public const JSON_STRUCTURE = [
        'url',
        'cover',
        'wiki' => [
            'summary',
            'full',
        ],
        'tracks' => [
            '*' => [
                'title',
                'length',
                'url',
            ],
        ],
    ];

    private function __construct(public ?string $url, public ?string $cover, public array $wiki, public array $tracks)
    {
    }

    public static function make(
        ?string $url = null,
        ?string $cover = null,
        array $wiki = ['summary' => '', 'full' => ''],
        array $tracks = []
    ): self {
        return new self($url, $cover, $wiki, $tracks);
    }

    public static function fromLastFmData(object $data): self
    {
        return self::make(
            url: $data->url,
            cover: Arr::get($data->image, '0.#text'),
            wiki: [
                'summary' => isset($data->wiki) ? self::formatLastFmText($data->wiki->summary) : '',
                'full' => isset($data->wiki) ? self::formatLastFmText($data->wiki->content) : '',
            ],
            tracks: array_map(static fn ($track): array => [
                'title' => $track->name,
                'length' => (int) $track->duration,
                'url' => $track->url,
            ], $data->tracks?->track ?? []),
        );
    }

    /** @return array<mixed> */
    public function toArray(): array
    {
        return [
            'url' => $this->url,
            'cover' => $this->cover,
            'wiki' => $this->wiki,
            'tracks' => $this->tracks,
        ];
    }
}