fix(pagination): prevent integer overflow in typesense pagination (#924)

* fix(pagination): prevent integer overflow in typesense pagination

- add test to verify pagination works correctly with overflow page numbers

* chore: lint

* Update TypesenseEngine.php

---------

Co-authored-by: Taylor Otwell <[email protected]>

Author: tharropoulos

src/Engines/TypesenseEngine.php

@@ -228,6 +228,15 @@ public function search(Builder $builder)
      */
     public function paginate(Builder $builder, $perPage, $page)
     {
+        $maxInt = 4294967295;
+
+        $page = max(1, (int) $page);
+        $perPage = max(1, (int) $perPage);
+
+        if ($page * $perPage > $maxInt) {
+            $page = floor($maxInt / $perPage);
+        }
+
         return $this->performSearch(
             $builder,
             $this->buildSearchParameters($builder, $page, $perPage)

tests/Integration/TypesenseSearchableTest.php

@@ -223,6 +223,21 @@ public function test_it_can_use_raw_cursor_search_with_after_raw_search_callback
         $this->assertArrayHasKey('search_time_ms', $rawResults);
     }
 
+    public function test_it_handles_pagination_with_max_int_overflow()
+    {
+        $maxInt = 4294967295;
+        $perPage = 10;
+        $overflowPage = 4294967296; // max int + 1
+        $expectedPage = floor($maxInt / $perPage);
+
+        $results = SearchableUser::search('lar')
+            ->paginate($perPage, $overflowPage);
+
+        // Verify the page was adjusted correctly
+        $this->assertEquals($expectedPage, $results->currentPage());
+        $this->assertEquals($perPage, $results->perPage());
+    }
+
     protected static function scoutDriver(): string
     {
         return 'typesense';