feat!: pagination field rename, and basic streaming docs

Author: stainless-app[bot]

README.md

@@ -50,6 +50,7 @@ use CasParser\Client;
 $client = new Client(apiKey: getenv("CAS_PARSER_API_KEY") ?: "My API Key");
 
 $unifiedResponse = $client->casParser->smartParse();
+
 var_dump($unifiedResponse->demat_accounts);
 ```
 
@@ -116,6 +117,7 @@ use CasParser\RequestOptions;
 $client = new Client(maxRetries: 0);
 
 // Or, configure per-request:
+
 $result = $client->casParser->smartParse(new RequestOptions(maxRetries: 5));
 ```
 

src/Core/Concerns/SdkPage.php

@@ -33,11 +33,11 @@ trait SdkPage
     /**
      * @return list<Item>
      */
-    abstract public function getPaginatedItems(): array;
+    abstract public function getItems(): array;
 
     public function hasNextPage(): bool
     {
-        $items = $this->getPaginatedItems();
+        $items = $this->getItems();
         if (empty($items)) {
             return false;
         }
@@ -66,7 +66,7 @@ public function getNextPage(): static
         [$req, $opts] = $next;
 
         // @phpstan-ignore-next-line
-        return $this->client->request(...$req, convert: $this->convert, page: $this, options: $opts);
+        return $this->client->request(...$req, convert: $this->convert, page: $this::class, options: $opts);
     }
 
     /**
@@ -94,7 +94,7 @@ public function getIterator(): \Generator
     public function pagingEachItem(): \Generator
     {
         foreach ($this as $page) {
-            foreach ($page->getPaginatedItems() as $item) {
+            foreach ($page->getItems() as $item) {
                 yield $item;
             }
         }

src/Core/Contracts/BasePage.php

@@ -45,7 +45,7 @@ public function hasNextPage(): bool;
     /**
      * @return list<Item>
      */
-    public function getPaginatedItems(): array;
+    public function getItems(): array;
 
     /**
      * @return static<Item>