feat(api): update via SDK Studio

Author: stainless-app[bot]

api.md

@@ -16,16 +16,16 @@ Types:
 
 ```python
 from zeroentropy.types import (
-    CollectionAddCollectionResponse,
-    CollectionDeleteCollectionResponse,
+    CollectionDeleteResponse,
+    CollectionAddResponse,
     CollectionGetListResponse,
 )
 ```
 
 Methods:
 
-- <code title="post /collections/add-collection">client.collections.<a href="./src/zeroentropy/resources/collections.py">add_collection</a>(\*\*<a href="src/zeroentropy/types/collection_add_collection_params.py">params</a>) -> <a href="./src/zeroentropy/types/collection_add_collection_response.py">CollectionAddCollectionResponse</a></code>
-- <code title="post /collections/delete-collection">client.collections.<a href="./src/zeroentropy/resources/collections.py">delete_collection</a>(\*\*<a href="src/zeroentropy/types/collection_delete_collection_params.py">params</a>) -> <a href="./src/zeroentropy/types/collection_delete_collection_response.py">CollectionDeleteCollectionResponse</a></code>
+- <code title="post /collections/delete-collection">client.collections.<a href="./src/zeroentropy/resources/collections.py">delete</a>(\*\*<a href="src/zeroentropy/types/collection_delete_params.py">params</a>) -> <a href="./src/zeroentropy/types/collection_delete_response.py">CollectionDeleteResponse</a></code>
+- <code title="post /collections/add-collection">client.collections.<a href="./src/zeroentropy/resources/collections.py">add</a>(\*\*<a href="src/zeroentropy/types/collection_add_params.py">params</a>) -> <a href="./src/zeroentropy/types/collection_add_response.py">CollectionAddResponse</a></code>
 - <code title="post /collections/get-collection-list">client.collections.<a href="./src/zeroentropy/resources/collections.py">get_list</a>() -> <a href="./src/zeroentropy/types/collection_get_list_response.py">CollectionGetListResponse</a></code>
 
 # Documents
@@ -34,8 +34,8 @@ Types:
 
 ```python
 from zeroentropy.types import (
-    DocumentAddDocumentResponse,
-    DocumentDeleteDocumentResponse,
+    DocumentDeleteResponse,
+    DocumentAddResponse,
     DocumentGetInfoResponse,
     DocumentGetInfoListResponse,
     DocumentGetPageInfoResponse,
@@ -44,8 +44,8 @@ from zeroentropy.types import (
 
 Methods:
 
-- <code title="post /documents/add-document">client.documents.<a href="./src/zeroentropy/resources/documents.py">add_document</a>(\*\*<a href="src/zeroentropy/types/document_add_document_params.py">params</a>) -> <a href="./src/zeroentropy/types/document_add_document_response.py">DocumentAddDocumentResponse</a></code>
-- <code title="post /documents/delete-document">client.documents.<a href="./src/zeroentropy/resources/documents.py">delete_document</a>(\*\*<a href="src/zeroentropy/types/document_delete_document_params.py">params</a>) -> <a href="./src/zeroentropy/types/document_delete_document_response.py">DocumentDeleteDocumentResponse</a></code>
+- <code title="post /documents/delete-document">client.documents.<a href="./src/zeroentropy/resources/documents.py">delete</a>(\*\*<a href="src/zeroentropy/types/document_delete_params.py">params</a>) -> <a href="./src/zeroentropy/types/document_delete_response.py">DocumentDeleteResponse</a></code>
+- <code title="post /documents/add-document">client.documents.<a href="./src/zeroentropy/resources/documents.py">add</a>(\*\*<a href="src/zeroentropy/types/document_add_params.py">params</a>) -> <a href="./src/zeroentropy/types/document_add_response.py">DocumentAddResponse</a></code>
 - <code title="post /documents/get-document-info">client.documents.<a href="./src/zeroentropy/resources/documents.py">get_info</a>(\*\*<a href="src/zeroentropy/types/document_get_info_params.py">params</a>) -> <a href="./src/zeroentropy/types/document_get_info_response.py">DocumentGetInfoResponse</a></code>
 - <code title="post /documents/get-document-info-list">client.documents.<a href="./src/zeroentropy/resources/documents.py">get_info_list</a>(\*\*<a href="src/zeroentropy/types/document_get_info_list_params.py">params</a>) -> <a href="./src/zeroentropy/types/document_get_info_list_response.py">DocumentGetInfoListResponse</a></code>
 - <code title="post /documents/get-page-info">client.documents.<a href="./src/zeroentropy/resources/documents.py">get_page_info</a>(\*\*<a href="src/zeroentropy/types/document_get_page_info_params.py">params</a>) -> <a href="./src/zeroentropy/types/document_get_page_info_response.py">DocumentGetPageInfoResponse</a></code>
@@ -73,12 +73,12 @@ Methods:
 Types:
 
 ```python
-from zeroentropy.types import ParserParseResponse
+from zeroentropy.types import ParserParseDocumentResponse
 ```
 
 Methods:
 
-- <code title="post /parsers/parse-document">client.parsers.<a href="./src/zeroentropy/resources/parsers.py">parse</a>(\*\*<a href="src/zeroentropy/types/parser_parse_params.py">params</a>) -> <a href="./src/zeroentropy/types/parser_parse_response.py">ParserParseResponse</a></code>
+- <code title="post /parsers/parse-document">client.parsers.<a href="./src/zeroentropy/resources/parsers.py">parse_document</a>(\*\*<a href="src/zeroentropy/types/parser_parse_document_params.py">params</a>) -> <a href="./src/zeroentropy/types/parser_parse_document_response.py">ParserParseDocumentResponse</a></code>
 
 # Models
 

src/zeroentropy/pagination.py

@@ -0,0 +1,63 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Any, List, Generic, TypeVar, Optional, cast
+from typing_extensions import Protocol, override, runtime_checkable
+
+from ._base_client import BasePage, PageInfo, BaseSyncPage, BaseAsyncPage
+
+__all__ = ["SyncGetDocumentInfoListCursor", "AsyncGetDocumentInfoListCursor"]
+
+_T = TypeVar("_T")
+
+
+@runtime_checkable
+class GetDocumentInfoListCursorItem(Protocol):
+    id: str
+
+
+class SyncGetDocumentInfoListCursor(BaseSyncPage[_T], BasePage[_T], Generic[_T]):
+    documents: List[_T]
+
+    @override
+    def _get_page_items(self) -> List[_T]:
+        documents = self.documents
+        if not documents:
+            return []
+        return documents
+
+    @override
+    def next_page_info(self) -> Optional[PageInfo]:
+        documents = self.documents
+        if not documents:
+            return None
+
+        item = cast(Any, documents[-1])
+        if not isinstance(item, GetDocumentInfoListCursorItem) or item.id is None:  # pyright: ignore[reportUnnecessaryComparison]
+            # TODO emit warning log
+            return None
+
+        return PageInfo(params={"id_gt": item.id})
+
+
+class AsyncGetDocumentInfoListCursor(BaseAsyncPage[_T], BasePage[_T], Generic[_T]):
+    documents: List[_T]
+
+    @override
+    def _get_page_items(self) -> List[_T]:
+        documents = self.documents
+        if not documents:
+            return []
+        return documents
+
+    @override
+    def next_page_info(self) -> Optional[PageInfo]:
+        documents = self.documents
+        if not documents:
+            return None
+
+        item = cast(Any, documents[-1])
+        if not isinstance(item, GetDocumentInfoListCursorItem) or item.id is None:  # pyright: ignore[reportUnnecessaryComparison]
+            # TODO emit warning log
+            return None
+
+        return PageInfo(params={"id_gt": item.id})

src/zeroentropy/resources/collections.py

@@ -4,7 +4,7 @@
 
 import httpx
 
-from ..types import collection_add_collection_params, collection_delete_collection_params
+from ..types import collection_add_params, collection_delete_params
 from .._types import NOT_GIVEN, Body, Query, Headers, NotGiven
 from .._utils import (
     maybe_transform,
@@ -19,9 +19,9 @@
     async_to_streamed_response_wrapper,
 )
 from .._base_client import make_request_options
+from ..types.collection_add_response import CollectionAddResponse
+from ..types.collection_delete_response import CollectionDeleteResponse
 from ..types.collection_get_list_response import CollectionGetListResponse
-from ..types.collection_add_collection_response import CollectionAddCollectionResponse
-from ..types.collection_delete_collection_response import CollectionDeleteCollectionResponse
 
 __all__ = ["CollectionsResource", "AsyncCollectionsResource"]
 
@@ -46,7 +46,7 @@ def with_streaming_response(self) -> CollectionsResourceWithStreamingResponse:
         """
         return CollectionsResourceWithStreamingResponse(self)
 
-    def add_collection(
+    def delete(
         self,
         *,
         collection_name: str,
@@ -56,16 +56,15 @@ def add_collection(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> CollectionAddCollectionResponse:
+    ) -> CollectionDeleteResponse:
         """
-        Adds a collection.
+        Deletes a collection.
 
-        If the collection already exists, a `409 Conflict` status code will be returned.
+        A `404 Not Found` status code will be returned, if the provided collection name
+        does not exist.
 
         Args:
-          collection_name: The name of the collection to add. The maximum length of this string is 1024
-              characters. If special characters are used, then the UTF-8 encoded string cannot
-              exceed 1024 bytes.
+          collection_name: The name of the collection to delete.
 
           extra_headers: Send extra headers
 
@@ -76,17 +75,15 @@ def add_collection(
           timeout: Override the client-level default timeout for this request, in seconds
         """
         return self._post(
-            "/collections/add-collection",
-            body=maybe_transform(
-                {"collection_name": collection_name}, collection_add_collection_params.CollectionAddCollectionParams
-            ),
+            "/collections/delete-collection",
+            body=maybe_transform({"collection_name": collection_name}, collection_delete_params.CollectionDeleteParams),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=CollectionAddCollectionResponse,
+            cast_to=CollectionDeleteResponse,
         )
 
-    def delete_collection(
+    def add(
         self,
         *,
         collection_name: str,
@@ -96,15 +93,16 @@ def delete_collection(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> CollectionDeleteCollectionResponse:
+    ) -> CollectionAddResponse:
         """
-        Deletes a collection.
+        Adds a collection.
 
-        A `404 Not Found` status code will be returned, if the provided collection name
-        does not exist.
+        If the collection already exists, a `409 Conflict` status code will be returned.
 
         Args:
-          collection_name: The name of the collection to delete.
+          collection_name: The name of the collection to add. The maximum length of this string is 1024
+              characters. If special characters are used, then the UTF-8 encoded string cannot
+              exceed 1024 bytes.
 
           extra_headers: Send extra headers
 
@@ -115,15 +113,12 @@ def delete_collection(
           timeout: Override the client-level default timeout for this request, in seconds
         """
         return self._post(
-            "/collections/delete-collection",
-            body=maybe_transform(
-                {"collection_name": collection_name},
-                collection_delete_collection_params.CollectionDeleteCollectionParams,
-            ),
+            "/collections/add-collection",
+            body=maybe_transform({"collection_name": collection_name}, collection_add_params.CollectionAddParams),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=CollectionDeleteCollectionResponse,
+            cast_to=CollectionAddResponse,
         )
 
     def get_list(
@@ -166,7 +161,7 @@ def with_streaming_response(self) -> AsyncCollectionsResourceWithStreamingRespon
         """
         return AsyncCollectionsResourceWithStreamingResponse(self)
 
-    async def add_collection(
+    async def delete(
         self,
         *,
         collection_name: str,
@@ -176,16 +171,15 @@ async def add_collection(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> CollectionAddCollectionResponse:
+    ) -> CollectionDeleteResponse:
         """
-        Adds a collection.
+        Deletes a collection.
 
-        If the collection already exists, a `409 Conflict` status code will be returned.
+        A `404 Not Found` status code will be returned, if the provided collection name
+        does not exist.
 
         Args:
-          collection_name: The name of the collection to add. The maximum length of this string is 1024
-              characters. If special characters are used, then the UTF-8 encoded string cannot
-              exceed 1024 bytes.
+          collection_name: The name of the collection to delete.
 
           extra_headers: Send extra headers
 
@@ -196,17 +190,17 @@ async def add_collection(
           timeout: Override the client-level default timeout for this request, in seconds
         """
         return await self._post(
-            "/collections/add-collection",
+            "/collections/delete-collection",
             body=await async_maybe_transform(
-                {"collection_name": collection_name}, collection_add_collection_params.CollectionAddCollectionParams
+                {"collection_name": collection_name}, collection_delete_params.CollectionDeleteParams
             ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=CollectionAddCollectionResponse,
+            cast_to=CollectionDeleteResponse,
         )
 
-    async def delete_collection(
+    async def add(
         self,
         *,
         collection_name: str,
@@ -216,15 +210,16 @@ async def delete_collection(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> CollectionDeleteCollectionResponse:
+    ) -> CollectionAddResponse:
         """
-        Deletes a collection.
+        Adds a collection.
 
-        A `404 Not Found` status code will be returned, if the provided collection name
-        does not exist.
+        If the collection already exists, a `409 Conflict` status code will be returned.
 
         Args:
-          collection_name: The name of the collection to delete.
+          collection_name: The name of the collection to add. The maximum length of this string is 1024
+              characters. If special characters are used, then the UTF-8 encoded string cannot
+              exceed 1024 bytes.
 
           extra_headers: Send extra headers
 
@@ -235,15 +230,14 @@ async def delete_collection(
           timeout: Override the client-level default timeout for this request, in seconds
         """
         return await self._post(
-            "/collections/delete-collection",
+            "/collections/add-collection",
             body=await async_maybe_transform(
-                {"collection_name": collection_name},
-                collection_delete_collection_params.CollectionDeleteCollectionParams,
+                {"collection_name": collection_name}, collection_add_params.CollectionAddParams
             ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=CollectionDeleteCollectionResponse,
+            cast_to=CollectionAddResponse,
         )
 
     async def get_list(
@@ -270,11 +264,11 @@ class CollectionsResourceWithRawResponse:
     def __init__(self, collections: CollectionsResource) -> None:
         self._collections = collections
 
-        self.add_collection = to_raw_response_wrapper(
-            collections.add_collection,
+        self.delete = to_raw_response_wrapper(
+            collections.delete,
         )
-        self.delete_collection = to_raw_response_wrapper(
-            collections.delete_collection,
+        self.add = to_raw_response_wrapper(
+            collections.add,
         )
         self.get_list = to_raw_response_wrapper(
             collections.get_list,
@@ -285,11 +279,11 @@ class AsyncCollectionsResourceWithRawResponse:
     def __init__(self, collections: AsyncCollectionsResource) -> None:
         self._collections = collections
 
-        self.add_collection = async_to_raw_response_wrapper(
-            collections.add_collection,
+        self.delete = async_to_raw_response_wrapper(
+            collections.delete,
         )
-        self.delete_collection = async_to_raw_response_wrapper(
-            collections.delete_collection,
+        self.add = async_to_raw_response_wrapper(
+            collections.add,
         )
         self.get_list = async_to_raw_response_wrapper(
             collections.get_list,
@@ -300,11 +294,11 @@ class CollectionsResourceWithStreamingResponse:
     def __init__(self, collections: CollectionsResource) -> None:
         self._collections = collections
 
-        self.add_collection = to_streamed_response_wrapper(
-            collections.add_collection,
+        self.delete = to_streamed_response_wrapper(
+            collections.delete,
         )
-        self.delete_collection = to_streamed_response_wrapper(
-            collections.delete_collection,
+        self.add = to_streamed_response_wrapper(
+            collections.add,
         )
         self.get_list = to_streamed_response_wrapper(
             collections.get_list,
@@ -315,11 +309,11 @@ class AsyncCollectionsResourceWithStreamingResponse:
     def __init__(self, collections: AsyncCollectionsResource) -> None:
         self._collections = collections
 
-        self.add_collection = async_to_streamed_response_wrapper(
-            collections.add_collection,
+        self.delete = async_to_streamed_response_wrapper(
+            collections.delete,
         )
-        self.delete_collection = async_to_streamed_response_wrapper(
-            collections.delete_collection,
+        self.add = async_to_streamed_response_wrapper(
+            collections.add,
         )
         self.get_list = async_to_streamed_response_wrapper(
             collections.get_list,