chore(doc): small improvement to pagination example

Author: stainless-app[bot]

README.md

@@ -43,6 +43,7 @@ $message = $client->messages->create(
   messages: [MessageParam::with(role: "user", content: "Hello, Claude")],
   model: "claude-sonnet-4-20250514",
 );
+
 var_dump($message->content);
 ```
 
@@ -53,6 +54,60 @@ and named parameters to initialize value objects.
 
 However, builders are also provided `(new Base64ImageSource)->withData("U3RhaW5sZXNzIHJvY2tz")`.
 
+### Streaming
+
+We provide support for streaming responses using Server-Sent Events (SSE).
+
+```php
+<?php
+
+use Anthropic\Client;
+use Anthropic\Messages\MessageParam;
+
+$client = new Client(
+  apiKey: getenv("ANTHROPIC_API_KEY") ?: "my-anthropic-api-key"
+);
+
+$stream = $client->messages->createStream(
+  maxTokens: 1024,
+  messages: [MessageParam::with(role: "user", content: "Hello, Claude")],
+  model: "claude-sonnet-4-20250514",
+);
+
+foreach ($stream as $message) {
+  var_dump($message);
+}
+```
+
+### Pagination
+
+List methods in the Anthropic API are paginated.
+
+This library provides auto-paginating iterators with each list response, so you do not have to request successive pages manually:
+
+```php
+<?php
+
+use Anthropic\Client;
+
+$client = new Client(
+  apiKey: getenv("ANTHROPIC_API_KEY") ?: "my-anthropic-api-key"
+);
+
+$page = $client->beta->messages->batches->list();
+
+var_dump($page);
+
+// fetch items from the current page
+foreach ($page->getItems() as $item) {
+  var_dump($item->id);
+}
+// make additional network requests to fetch items from all pages, including and after the current page
+foreach ($page->pagingEachItem() as $item) {
+  var_dump($item->id);
+}
+```
+
 ### Handling errors
 
 When the library is unable to connect to the API, or if the API returns a non-success status code (i.e., 4xx or 5xx response), a subclass of `Anthropic\Errors\APIError` will be thrown:
@@ -115,6 +170,7 @@ use Anthropic\Messages\MessageParam;
 $client = new Client(maxRetries: 0);
 
 // Or, configure per-request:
+
 $result = $client->messages->create(
   maxTokens: 1024,
   messages: [MessageParam::with(role: "user", content: "Hello, Claude")],

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>

src/Core/Page.php

@@ -71,7 +71,7 @@ public function __construct(
     }
 
     /** @return list<TItem> */
-    public function getPaginatedItems(): array
+    public function getItems(): array
     {
         // @phpstan-ignore-next-line
         return $this->offsetGet('data') ?? [];
@@ -96,8 +96,12 @@ public function nextRequest(): ?array
             return null;
         }
 
-        $nextRequest = $this->request;
+        $nextRequest = array_merge_recursive(
+            $this->request,
+            ['query' => ['after_id' => $next]]
+        );
 
+        // @phpstan-ignore-next-line
         return [$nextRequest, $this->options];
     }
 }