forge/app/Http/Resources/Api/V0/ModResource.php

<?php

namespace App\Http\Resources\Api\V0;

use App\Http\Controllers\Api\V0\ApiController;
use App\Models\Mod;
use Illuminate\Http\Request;
use Illuminate\Http\Resources\Json\JsonResource;

/** @mixin Mod */
class ModResource extends JsonResource
{
    /**
     * Transform the resource into an array.
     */
    public function toArray(Request $request): array
    {
        return [
            'type' => 'mod',
            'id' => $this->id,
            'attributes' => [
                'hub_id' => $this->hub_id,
                'name' => $this->name,
                'slug' => $this->slug,
                'teaser' => $this->teaser,
                'description' => $this->when(
                    $request->routeIs('api.v0.mods.show'),
                    $this->description
                ),
                'license_id' => $this->license_id,
                'source_code_link' => $this->source_code_link,
                'featured' => $this->featured,
                'contains_ai_content' => $this->contains_ai_content,
                'contains_ads' => $this->contains_ads,
                'created_at' => $this->created_at,
                'updated_at' => $this->updated_at,
                'published_at' => $this->published_at,
            ],
            'relationships' => [
                'users' => $this->users->map(fn ($user) => [
                    'data' => [
                        'type' => 'user',
                        'id' => $user->id,
                    ],
                    'links' => [
                        'self' => $user->profileUrl(),
                    ],
                ])->toArray(),
                'versions' => $this->versions->map(fn ($version) => [
                    'data' => [
                        'type' => 'version',
                        'id' => $version->id,
                    ],

                    // TODO: The download link to the version can be placed here, but I'd like to track the number of
                    //       downloads that are made, so we'll need a new route/feature for that. #35
                    'links' => [
                        'self' => $version->link,
                    ],

                ])->toArray(),
                'license' => [
                    [
                        'data' => [
                            'type' => 'license',
                            'id' => $this->license_id,
                        ],
                    ],
                ],
            ],
            'includes' => $this->when(
                ApiController::shouldInclude(['users', 'license', 'versions']),
                fn () => collect([
                    'users' => $this->users->map(fn ($user) => new UserResource($user)),
                    'license' => new LicenseResource($this->license),
                    'versions' => $this->versions->map(fn ($version) => new ModVersionResource($version)),
                ])
                    ->filter(fn ($value, $key) => ApiController::shouldInclude($key))
                    ->flatten(1)
                    ->values()
            ),
            'links' => [
                'self' => $this->detailUrl(),
            ],
        ];
    }
}