fix(pagination): add total_pages check to prevent infinite loop

Author: AzmainMahatab

src/cloudflare/pagination.py

@@ -84,6 +84,11 @@ class V4PagePaginationArrayResultInfo(BaseModel):
 
     per_page: Optional[int] = None
 
+    # Added missing fields present in V4 API
+    total_pages: Optional[int] = None
+    total_count: Optional[int] = None
+    count: Optional[int] = None
+
 
 class SyncV4PagePaginationArray(BaseSyncPage[_T], BasePage[_T], Generic[_T]):
     result: List[_T]
@@ -100,6 +105,10 @@ def _get_page_items(self) -> List[_T]:
     def next_page_info(self) -> Optional[PageInfo]:
         last_page = cast("int | None", self._options.params.get("page")) or 1
 
+        # Guard against infinite loops where API returns data past the last page
+        if self.result_info and self.result_info.total_pages is not None and last_page >= self.result_info.total_pages:
+            return None
+
         return PageInfo(params={"page": last_page + 1})
 
 
@@ -118,6 +127,9 @@ def _get_page_items(self) -> List[_T]:
     def next_page_info(self) -> Optional[PageInfo]:
         last_page = cast("int | None", self._options.params.get("page")) or 1
 
+        # Guard against infinite loops where API returns data past the last page
+        if self.result_info and self.result_info.total_pages is not None and last_page >= self.result_info.total_pages:
+            return None
         return PageInfo(params={"page": last_page + 1})