fix: adding query filtered to request

Author: binaryk

docs-v3/content/docs/api/getters.md

@@ -143,6 +143,27 @@ public function handle(Request $request)
 }
 ```
 
+#### Accessing the filtered query
+
+For index getters, you can access the filtered query builder via `$request->filteredQuery()`. This query builder already has all filters, search queries, and other query modifiers applied by Restify:
+
+```php
+public function handle(Request $request): JsonResponse
+{
+    // Get the filtered query builder with all applied filters, search, etc.
+    $query = $request->filteredQuery();
+
+    // You can further refine the query
+    $data = $query->where('status', 'active')->get();
+
+    return response()->json([
+        'data' => $data,
+    ]);
+}
+```
+
+This allows you to build upon the existing query without having to manually apply filters again.
+
 ## Getter customizations
 
 Getters could be easily customized.
@@ -278,16 +299,26 @@ Index getters are used when you have to apply them for many items.
 
 ### Index getter definition
 
-The index getter definition differs in how it receives arguments for the `handle` method. 
+The index getter definition receives only the `$request` in the `handle` method. You can access the filtered query builder using `$request->filteredQuery()`:
 
 ```php
 public function handle(Request $request): JsonResponse
 {
-    //
+    // Get the filtered query builder with all applied filters, search, etc.
+    $query = $request->filteredQuery();
+
+    // You can further refine the query
+    $data = $query->where('status', 'active')->get();
+
+    return response()->json([
+        'data' => $data,
+    ]);
 }
 
 ```
 
+The filtered query builder contains all repository filters, search queries, and other query modifiers already applied. This allows you to leverage existing filters without re-implementing them.
+
 ### Index getter registration
 
 To register an index getter, we have to use the `->onlyOnIndex()` accessor:

src/Getters/Getter.php

@@ -117,9 +117,7 @@ public function handleRequest(GetterRequest $request): Response
             );
         }
 
-        $query = RepositorySearchService::make()->search($request, $request->repository());
-
-        return $this->handle($request, $query);
+        return $this->handle($request);
     }
 
     public function withoutMiddleware(string|array $middleware): self

src/Http/Requests/Concerns/InteractWithRepositories.php

@@ -7,6 +7,7 @@
 use Binaryk\LaravelRestify\Repositories\Repository;
 use Binaryk\LaravelRestify\Repositories\RepositoryInstance;
 use Binaryk\LaravelRestify\Restify;
+use Binaryk\LaravelRestify\Services\Search\RepositorySearchService;
 use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\Relation;
@@ -121,4 +122,9 @@ public function isViaRepository(): bool
 
         return $parentRepository && $parentRepositoryId;
     }
+
+    public function filteredQuery(): Builder
+    {
+        return RepositorySearchService::make()->search($this, $this->repository());
+    }
 }

tests/Fixtures/Post/Getters/PostsFilteredQueryGetter.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace Binaryk\LaravelRestify\Tests\Fixtures\Post\Getters;
+
+use Binaryk\LaravelRestify\Getters\Getter;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class PostsFilteredQueryGetter extends Getter
+{
+    public static $uriKey = 'posts-filtered-query-getter';
+
+    public function handle(Request $request): JsonResponse
+    {
+        $query = $request->filteredQuery();
+
+        $count = $query->count();
+
+        return response()->json([
+            'message' => 'filtered query works',
+            'count' => $count,
+        ]);
+    }
+}

tests/Fixtures/Post/PostRepository.php

@@ -7,6 +7,7 @@
 use Binaryk\LaravelRestify\Http\Requests\ActionRequest;
 use Binaryk\LaravelRestify\Http\Requests\RestifyRequest;
 use Binaryk\LaravelRestify\Repositories\Repository;
+use Binaryk\LaravelRestify\Tests\Fixtures\Post\Getters\PostsFilteredQueryGetter;
 use Binaryk\LaravelRestify\Tests\Fixtures\Post\Getters\PostsIndexGetter;
 use Binaryk\LaravelRestify\Tests\Fixtures\Post\Getters\PostsIndexInvokableGetter;
 use Binaryk\LaravelRestify\Tests\Fixtures\Post\Getters\PostsShowGetter;
@@ -139,6 +140,7 @@ public function getters(RestifyRequest $request): array
             PostsIndexGetter::make(),
             PostsShowGetter::make()->onlyOnShow(),
             UnauthenticatedActionGetter::make()->withoutMiddleware(AuthorizeRestify::class),
+            PostsFilteredQueryGetter::make(),
             new PostsShowInvokableGetter,
             new PostsIndexInvokableGetter,
         ];

tests/Getters/PerformGetterControllerTest.php

@@ -2,10 +2,12 @@
 
 namespace Binaryk\LaravelRestify\Tests\Getters;
 
+use Binaryk\LaravelRestify\Tests\Fixtures\Post\Getters\PostsFilteredQueryGetter;
 use Binaryk\LaravelRestify\Tests\Fixtures\Post\Getters\PostsIndexGetter;
 use Binaryk\LaravelRestify\Tests\Fixtures\Post\Getters\PostsIndexInvokableGetter;
 use Binaryk\LaravelRestify\Tests\Fixtures\Post\Getters\PostsShowGetter;
 use Binaryk\LaravelRestify\Tests\Fixtures\Post\Getters\PostsShowInvokableGetter;
+use Binaryk\LaravelRestify\Tests\Fixtures\Post\Post;
 use Binaryk\LaravelRestify\Tests\Fixtures\Post\PostRepository;
 use Binaryk\LaravelRestify\Tests\IntegrationTestCase;
 use Illuminate\Testing\Fluent\AssertableJson;
@@ -62,4 +64,44 @@ public function test_could_perform_repository_invokable_getter(): void
                     ->etc()
             );
     }
+
+    public function test_getter_can_access_filtered_query(): void
+    {
+        // Create 5 posts: 3 active, 2 inactive
+        Post::factory()->count(3)->create(['is_active' => true]);
+        Post::factory()->count(2)->create(['is_active' => false]);
+
+        // Call getter without filter - should return all 5 posts
+        $this
+            ->getJson(PostRepository::getter(PostsFilteredQueryGetter::class))
+            ->assertOk()
+            ->assertJson(
+                fn (AssertableJson $json) => $json
+                    ->where('message', 'filtered query works')
+                    ->where('count', 5)
+                    ->etc()
+            );
+
+        // Call getter with active filter - should return only 3 active posts
+        $this
+            ->getJson(PostRepository::getter(PostsFilteredQueryGetter::class) . '?is_active=1')
+            ->assertOk()
+            ->assertJson(
+                fn (AssertableJson $json) => $json
+                    ->where('message', 'filtered query works')
+                    ->where('count', 3)
+                    ->etc()
+            );
+
+        // Call getter with inactive filter - should return only 2 inactive posts
+        $this
+            ->getJson(PostRepository::getter(PostsFilteredQueryGetter::class) . '?is_active=0')
+            ->assertOk()
+            ->assertJson(
+                fn (AssertableJson $json) => $json
+                    ->where('message', 'filtered query works')
+                    ->where('count', 2)
+                    ->etc()
+            );
+    }
 }