Add filtering to a list endpoint

use apivalk\apivalk\Documentation\Property\DateProperty;
use apivalk\apivalk\Documentation\Property\EnumProperty;
use apivalk\apivalk\Documentation\Property\IntegerProperty;
use apivalk\apivalk\Documentation\Property\StringProperty;
use apivalk\apivalk\Router\Route\Filter\DateFilter;
use apivalk\apivalk\Router\Route\Filter\EnumFilter;
use apivalk\apivalk\Router\Route\Filter\IntegerFilter;
use apivalk\apivalk\Router\Route\Filter\Operator;
use apivalk\apivalk\Router\Route\Filter\StringFilter;
use apivalk\apivalk\Router\Route\Route;

public static function getRoute(): Route
{
    return Route::get('/api/v1/animals')
        ->filtering([
            new EnumFilter(new EnumProperty('status', 'Lifecycle status', ['active', 'archived']), Operator::EQ, Operator::IN),
            new StringFilter(new StringProperty('name', 'Name'), Operator::CONTAINS),
            new IntegerFilter(new IntegerProperty('age', 'Age in years'), Operator::GTE, Operator::LTE),
            new DateFilter(new DateProperty('born_at', 'Date of birth'), Operator::GT, Operator::LT, Operator::NULL),
        ]);
}

GET /api/v1/animals?age[gte]=3&age[lte]=10
GET /api/v1/animals?status[in]=active,archived
GET /api/v1/animals?born_at[null]=true
GET /api/v1/animals?status=active

public function __invoke(ListAnimalsRequest $request): AbstractApivalkResponse
{
    $filters = $request->filtering();

    $qb = $this->animals->query();

    if ($filters->status->has(Operator::EQ)) {
        $qb->where('status', '=', $filters->status->equal);         // string
    }

    foreach ($filters->status->in as $status) {                     // string[]
        $qb->orWhere('status', '=', $status);
    }

    if ($filters->age->greaterThanOrEqual !== null) {
        $qb->where('age', '>=', $filters->age->greaterThanOrEqual); // int
    }

    if ($filters->born_at->isNull === true) {
        $qb->whereNull('born_at');
    }

    // ...
}

foreach ($filters as $field => $filter) {
    foreach ($filter->conditions() as $operator => $value) {
        // $operator is 'eq' | 'gte' | 'in' | …, $value is already typed
        $qb->where($field, $this->toSqlOperator($operator), $value);
    }
}

public function availableFilters(): array
{
    return [
        new EnumFilter(new EnumProperty('status', 'Status', ['active', 'archived']), Operator::EQ),
        new StringFilter(new StringProperty('name', 'Name'), Operator::CONTAINS),
    ];
}

QUERY /api/v1/animals

{"age": {"gte": 3, "lte": 10}, "status": {"in": ["active", "archived"]}}