Simplify pagination

README.md

@@ -600,12 +600,14 @@ _ = try await client.upsertSpaceVariable(
 The API automatically handles pagination using `Link` headers:
 
 ```swift
-let page1 = try await client.listModels(limit: 100)
-print("Page 1: \(page1.items.count) models")
+var page = try await client.listModels(limit: 100)
+print("Page 1: \(page.items.count) models")
 
-// Get next page if available
-if let nextURL = page1.nextURL {
-    // Make a request to nextURL to get the next page
+while page.nextURL != nil {
+    guard let next = try await client.nextPage(of: page) else { break }
+    page = next
+
+    print("Page: \(page.items.count) models")
 }
 ```
 

Sources/HuggingFace/Hub/HubClient+Pagination.swift

@@ -0,0 +1,17 @@
+//
+//  File 2.swift
+//  swift-huggingface
+//
+//  Created by Ronald Mannak on 12/17/25.
+//
+
+import Foundation
+
+extension HubClient {
+    public func nextPage<T: Decodable>(
+        of page: PaginatedResponse<T>
+    ) async throws -> PaginatedResponse<T>? {
+        guard let next = page.nextURL else { return nil }
+        return try await httpClient.fetchPaginated(.get, url: next)
+    }
+}

Sources/HuggingFace/Shared/HTTPClient.swift

@@ -113,7 +113,19 @@ final class HTTPClient: @unchecked Sendable {
         params: [String: Value]? = nil,
         headers: [String: String]? = nil
     ) async throws -> PaginatedResponse<T> {
-        let request = try await createRequest(method, path, params: params, headers: headers)
+        guard let url = URL(string: path, relativeTo: host) else {
+            throw HTTPClientError.unexpectedError("Invalid URL")
+        }
+        return try await fetchPaginated(method, url: url, params: params, headers: headers)
+    }
+
+    func fetchPaginated<T: Decodable>(
+        _ method: HTTPMethod,
+        url: URL,
+        params: [String: Value]? = nil,
+        headers: [String: String]? = nil
+    ) async throws -> PaginatedResponse<T> {
+        let request = try await createRequest(method, url: url, params: params, headers: headers)
         let (data, response) = try await session.data(for: request)
         let httpResponse = try validateResponse(response, data: data)