aspirecloud/app/Values/WpOrg/Themes/QueryThemesRequest.php

<?php
declare(strict_types=1);

namespace App\Values\WpOrg\Themes;

use App\Values\DTO;
use Bag\Attributes\StripExtraParameters;
use Bag\Attributes\Transforms;
use Illuminate\Http\Request;
use Illuminate\Support\Arr;

#[StripExtraParameters]
readonly class QueryThemesRequest extends DTO
{
    use ThemeFields;

    public const ACTION = 'query_themes';

    /**
     * @param list<string>|null $tags
     * @param list<string>|null $ac_tags
     * @param string|array<string,bool>|null $fields
     */
    public function __construct(
        public ?string $search = null, // text to search
        public ?array $tags = null,    // tag or set of tags
        public ?string $theme = null,  // slug of a specific theme
        public ?string $author = null, // wp.org username of author
        public ?string $browse = null, // one of popular|featured|updated|new
        public mixed $fields = null,
        public int $page = 1,
        public int $per_page = 24,

        // AspireCloud-specific extensions
        public ?array $ac_tags = null, // tag or set of tags, AND'ed together
    ) {}

    /** @return array<string, mixed> */
    #[Transforms(Request::class)]
    public static function fromRequest(Request $request): array
    {
        $query = $request->query->all();
        $query['tags'] = Arr::wrap(Arr::pull($query, 'tag', []));
        $query['ac_tags'] = Arr::wrap(Arr::pull($query, 'ac_tag', []));

        $defaultFields = [
            'description' => true,
            'rating' => true,
            'homepage' => true,
            'template' => true,
        ];

        $query['fields'] = self::getFields($request, $defaultFields);
        return $query;
    }
}