Merge pull request #22 from devaction-labs/fix/version-composer

docs: update README and add PHPDoc for filterable trait

Author: alexnogueirasilva

README.md

@@ -308,7 +308,7 @@ class ProductController extends Controller
             // Apply pagination with custom parameters
             ->customPaginate(false, [
                 'per_page' => $request->input('per_page', 15),
-                'sort' => $request->input('sort', '-created_at'),
+                'sort' => $request->input('sort', '-created_at'),===========fffdfdfsdddddddddddsdsdsdsads
             ]);
 
         return response()->json($products);

composer.json

@@ -9,7 +9,7 @@
             "email": "alex@devaction.com.br"
         }
     ],
-    "version": "1.0.22",
+    "version": "1.0.23",
     "require": {
         "php": "^8.2|^8.3|^8.4",
         "illuminate/cache": "^11|^12",

src/Traits/Filterable.php

@@ -7,6 +7,7 @@
 use Illuminate\Contracts\Pagination\LengthAwarePaginator;
 use Illuminate\Contracts\Pagination\Paginator;
 use Illuminate\Database\Eloquent\Builder;
+use Illuminate\Database\Query\Expression;
 use Illuminate\Support\Facades\DB;
 use InvalidArgumentException;
 use JsonException;
@@ -58,6 +59,9 @@ public function scopeFiltrable(Builder $builder, array $filters): Builder
         return $this->scopeFilterable($builder, $filters);
     }
 
+    /**
+     * @throws JsonException
+     */
     public function scopeFilterable(Builder $builder, array $filters): Builder
     {
         [$relationshipFilters, $directFilters, $relationshipsToLoad] = $this->categorizeFilters($filters);
@@ -394,7 +398,7 @@ private function hasJsonPath(Filter $filter): bool
     /**
      * Apply a filter to a builder
      */
-    private function applyFilterToBuilder(Builder $builder, Filter $filter, string $attribute, mixed $value): void
+    private function applyFilterToBuilder(Builder $builder, Filter $filter, string|Expression $attribute, mixed $value): void
     {
         if ($filter->getOperator() === 'IN') {
             $builder->whereIn($attribute, $value);