Check hard limit in client methods

Author: JulianVennen

lib/Client/CurseForgeAPIClient.php

@@ -131,9 +131,12 @@ public function setHttpClient(?ClientInterface $httpClient): static
      * @return PaginatedGameList
      * @throws ApiException
      */
-    public function getGames(int $offset = 0, int $pageSize = 50): PaginatedGameList
+    public function getGames(int $offset = 0, int $pageSize = PaginatedGameList::MAX_PAGE_SIZE): PaginatedGameList
     {
-        return new PaginatedGameList($this, $this->games->getGames($offset, $pageSize));
+        return new PaginatedGameList($this, $this->games->getGames(
+            $offset,
+            PaginatedGameList::getAllowedPageSize($offset, $pageSize),
+        ));
     }
 
     /**
@@ -243,7 +246,7 @@ public function searchMods(ModSearchOptions $options): PaginatedModList
             $options->getAuthorId(),
             $options->getSlug(),
             $options->getOffset(),
-            $options->getPageSize()
+            PaginatedModList::getAllowedPageSize($options->getOffset(), $options->getPageSize()),
         ), $options);
     }
 
@@ -313,7 +316,7 @@ public function getModFiles(ModFilesOptions $options): PaginatedFilesList
             $options->getModLoaderType()?->value,
             $options->getGameVersionTypeId(),
             $options->getOffset(),
-            $options->getPageSize(),
+            PaginatedFilesList::getAllowedPageSize($options->getOffset(), $options->getPageSize()),
         ), $options);
     }
 

lib/Client/List/PaginatedList.php

@@ -20,12 +20,30 @@ abstract class PaginatedList implements Iterator, ArrayAccess, Countable
 {
     /**
      * The limit for how many results are allowed to be requested.
-     * @type int
+     * @var int
      */
     public const LIMIT = 10_000;
 
+    /**
+     * The maximum page size that can be requested.
+     * @var int
+     */
+    public const MAX_PAGE_SIZE = 50;
+
     protected int $iterator = 0;
 
+
+    /**
+     * Get the maximum page size that can be requested.
+     * @param int $offset
+     * @param int $target
+     * @return int
+     */
+    public static function getAllowedPageSize(int $offset, int $target = self::MAX_PAGE_SIZE): int
+    {
+        return min($target, self::MAX_PAGE_SIZE, static::LIMIT - $offset);
+    }
+
     protected function __construct(
         protected Pagination $pagination,
         /**
@@ -235,7 +253,7 @@ public function count(): int
      */
     protected function getNextPageSize(int $offset): int
     {
-        return min($this->pagination->getPageSize(), static::LIMIT - $offset);
+        return static::getAllowedPageSize($offset, $this->pagination->getPageSize());
     }
 
     /**

lib/Client/Options/ModFiles/ModFilesOptions.php

@@ -2,6 +2,7 @@
 
 namespace Aternos\CurseForgeApi\Client\Options\ModFiles;
 
+use Aternos\CurseForgeApi\Client\List\PaginatedFilesList;
 use Aternos\CurseForgeApi\Client\Options\ModSearch\ModLoaderType;
 
 class ModFilesOptions
@@ -12,7 +13,7 @@ public function __construct(
         protected ?ModLoaderType $modLoaderType = null,
         protected ?int           $gameVersionTypeId = null,
         protected int            $offset = 0,
-        protected int            $pageSize = 50,
+        protected int            $pageSize = PaginatedFilesList::MAX_PAGE_SIZE,
     )
     {
     }

lib/Client/Options/ModSearch/ModSearchOptions.php

@@ -2,6 +2,8 @@
 
 namespace Aternos\CurseForgeApi\Client\Options\ModSearch;
 
+use Aternos\CurseForgeApi\Client\List\PaginatedModList;
+
 class ModSearchOptions
 {
     /**
@@ -32,7 +34,7 @@ public function __construct(
         protected ?int                $authorId = null,
         protected ?string             $slug = null,
         protected int                 $offset = 0,
-        protected int                 $pageSize = 50,
+        protected int                 $pageSize = PaginatedModList::MAX_PAGE_SIZE,
     )
     {
     }

tests/Integration/Client/ClientTest.php

@@ -211,6 +211,18 @@ public function testSearchMods()
     }
 
     public function testSearchModsLastPage()
+    {
+        $options = new ModSearchOptions(static::MINECRAFT_GAME_ID);
+        $options->setPageSize(50);
+        $options->setOffset(9_960);
+
+        $mods = $this->apiClient->searchMods($options);
+        $this->assertNotEmpty($mods);
+        $this->assertFalse($mods->hasNextPage());
+        $this->assertEquals($mods::LIMIT, $mods->getPagination()->getIndex() + $mods->getPagination()->getPageSize());
+    }
+
+    public function testSearchModsLastPageNext()
     {
         $options = new ModSearchOptions(static::MINECRAFT_GAME_ID);
         $options->setPageSize(50);