Add sorting to a list endpoint

use apivalk\apivalk\Router\Route\Route;
use apivalk\apivalk\Router\Route\Sort\Sort;

public static function getRoute(): Route
{
    return Route::get('/api/v1/animals')
        ->sorting([
            Sort::asc('name'),
            Sort::desc('created_at'),
        ]);
}

GET /api/v1/animals                              # default sorting
GET /api/v1/animals?order_by=name                # name ASC
GET /api/v1/animals?order_by=-created_at         # created_at DESC
GET /api/v1/animals?order_by=name,-created_at    # name ASC, created_at DESC

public function __invoke(ApivalkRequestInterface $request): AbstractApivalkResponse
{
    $qb = $this->animals->query();

    foreach ($request->sorting() as $field => $sort) {
        $qb->orderBy($field, $sort->isAsc() ? 'ASC' : 'DESC');
    }

    // ...
}

if ($request->sorting()->created_at->isRequested()) {
    // The client explicitly asked to sort by created_at.
}

foreach ($request->sorting()->getRequested() as $sort) {
    // Empty array if the client did not send order_by at all.
}

public function availableSortings(): array
{
    return [Sort::asc('name'), Sort::desc('created_at')];
}