animethemes-server/app/Actions/Http/Api/IndexAction.php

<?php

declare(strict_types=1);

namespace App\Actions\Http\Api;

use App\Concerns\Actions\Http\Api\ConstrainsEagerLoads;
use App\Enums\Http\Api\Paging\PaginationStrategy;
use App\Http\Api\Criteria\Paging\Criteria;
use App\Http\Api\Filter\HasFilter;
use App\Http\Api\Query\Query;
use App\Http\Api\Schema\EloquentSchema;
use App\Http\Api\Schema\Schema;
use App\Http\Api\Scope\ScopeParser;
use App\Scout\Search;
use Illuminate\Contracts\Pagination\Paginator;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Support\Collection;
use Illuminate\Support\Facades\Config;
use RuntimeException;

class IndexAction
{
    use ConstrainsEagerLoads;

    /**
     * Show paginated listing of models.
     */
    public function index(Builder $builder, Query $query, Schema $schema): Collection|Paginator
    {
        $builder->with($this->constrainEagerLoads($query, $schema));

        $this->select($builder, $query, $schema);

        $this->withAggregates($builder, $query, $schema);

        $scope = ScopeParser::parse($schema->type());
        $this->filter($builder, $query, $schema, $scope);

        // special case: only apply HasFilter to top-level models
        if (filled($schema->allowedIncludes())) {
            $hasFilter = new HasFilter($schema->allowedIncludes());
            foreach ($query->getFilterCriteria() as $criteria) {
                if ($criteria->shouldFilter($hasFilter, $scope)) {
                    $criteria->filter($builder, $hasFilter, $query, $schema);
                }
            }
        }

        $this->sort($builder, $query, $schema, $scope);

        // paginate
        $paginationCriteria = $query->getPagingCriteria(PaginationStrategy::OFFSET);

        return $paginationCriteria instanceof Criteria
            ? $paginationCriteria->paginate($builder)
            : $builder->get();
    }

    public function search(
        Query $query,
        Schema $schema,
        PaginationStrategy $paginationStrategy = PaginationStrategy::OFFSET
    ): Collection|Paginator {
        if ($query->hasSearchCriteria() && $schema instanceof EloquentSchema) {
            $search = Search::getSearch($schema->model(), $query->getSearchCriteria());

            if ($search->shouldSearch()) {
                return $search->searchViaJSONAPI($query, $schema, $paginationStrategy);
            }
        }

        // Let developer know why search can't be performed
        $driver = Config::get('scout.driver');
        $term = $query->getSearchCriteria()?->getTerm();
        throw new RuntimeException("Can't search for term '$term' with driver '$driver' and type '{$schema->type()}'");
    }
}