feat(api): manual updates

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 15
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/beeper%2Fbeeper-desktop-api-f48e33c7d90ed6418a852f8d4d951d07b09f4f3f939feb395dc2aa03f522d81e.yml
-openapi_spec_hash: c516120ecf51bb8425b3b9ed76c6423a
-config_hash: c5ac9bd5889d27aa168f06d6d0fef0b3
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/beeper%2Fbeeper-desktop-api-f48bb509412536c41fdfa537894cecd4af486099d95fe79369f2ef239fa94a75.yml
+openapi_spec_hash: f8b886fdfdc5ee3d51d2cd05daee3bab
+config_hash: 6f12c5e4c662e1f315b95a70389b1549

README.md

@@ -33,12 +33,7 @@ client = BeeperDesktop(
     access_token=os.environ.get("BEEPER_ACCESS_TOKEN"),  # This is the default and can be omitted
 )
 
-page = client.chats.search(
-    include_muted=True,
-    limit=3,
-    type="single",
-)
-print(page.items)
+accounts = client.accounts.list()
 ```
 
 While you can provide a `access_token` keyword argument,
@@ -61,12 +56,7 @@ client = AsyncBeeperDesktop(
 
 
 async def main() -> None:
-    page = await client.chats.search(
-        include_muted=True,
-        limit=3,
-        type="single",
-    )
-    print(page.items)
+    accounts = await client.accounts.list()
 
 
 asyncio.run(main())
@@ -98,12 +88,7 @@ async def main() -> None:
         access_token="My Access Token",
         http_client=DefaultAioHttpClient(),
     ) as client:
-        page = await client.chats.search(
-            include_muted=True,
-            limit=3,
-            type="single",
-        )
-        print(page.items)
+        accounts = await client.accounts.list()
 
 
 asyncio.run(main())
@@ -118,85 +103,6 @@ Nested request parameters are [TypedDicts](https://docs.python.org/3/library/typ
 
 Typed requests and responses provide autocomplete and documentation within your editor. If you would like to see type errors in VS Code to help catch bugs earlier, set `python.analysis.typeCheckingMode` to `basic`.
 
-## Pagination
-
-List methods in the Beeper Desktop API are paginated.
-
-This library provides auto-paginating iterators with each list response, so you do not have to request successive pages manually:
-
-```python
-from beeper_desktop_api import BeeperDesktop
-
-client = BeeperDesktop()
-
-all_messages = []
-# Automatically fetches more pages as needed.
-for message in client.messages.search(
-    account_ids=["local-telegram_ba_QFrb5lrLPhO3OT5MFBeTWv0x4BI"],
-    limit=10,
-    query="deployment",
-):
-    # Do something with message here
-    all_messages.append(message)
-print(all_messages)
-```
-
-Or, asynchronously:
-
-```python
-import asyncio
-from beeper_desktop_api import AsyncBeeperDesktop
-
-client = AsyncBeeperDesktop()
-
-
-async def main() -> None:
-    all_messages = []
-    # Iterate through items across all pages, issuing requests as needed.
-    async for message in client.messages.search(
-        account_ids=["local-telegram_ba_QFrb5lrLPhO3OT5MFBeTWv0x4BI"],
-        limit=10,
-        query="deployment",
-    ):
-        all_messages.append(message)
-    print(all_messages)
-
-
-asyncio.run(main())
-```
-
-Alternatively, you can use the `.has_next_page()`, `.next_page_info()`, or `.get_next_page()` methods for more granular control working with pages:
-
-```python
-first_page = await client.messages.search(
-    account_ids=["local-telegram_ba_QFrb5lrLPhO3OT5MFBeTWv0x4BI"],
-    limit=10,
-    query="deployment",
-)
-if first_page.has_next_page():
-    print(f"will fetch next page using these details: {first_page.next_page_info()}")
-    next_page = await first_page.get_next_page()
-    print(f"number of items we just fetched: {len(next_page.items)}")
-
-# Remove `await` for non-async usage.
-```
-
-Or just work directly with the returned data:
-
-```python
-first_page = await client.messages.search(
-    account_ids=["local-telegram_ba_QFrb5lrLPhO3OT5MFBeTWv0x4BI"],
-    limit=10,
-    query="deployment",
-)
-
-print(f"next page cursor: {first_page.oldest_cursor}")  # => "next page cursor: ..."
-for message in first_page.items:
-    print(message.id)
-
-# Remove `await` for non-async usage.
-```
-
 ## Nested params
 
 Nested parameters are dictionaries, typed using `TypedDict`, for example:

api.md

@@ -9,13 +9,13 @@ from beeper_desktop_api.types import Attachment, BaseResponse, Error, Message, R
 Types:
 
 ```python
-from beeper_desktop_api.types import DownloadAssetResponse, OpenResponse, SearchResponse
+from beeper_desktop_api.types import DownloadAssetResponse, FocusResponse, SearchResponse
 ```
 
 Methods:
 
 - <code title="post /v1/download-asset">client.<a href="./src/beeper_desktop_api/_client.py">download_asset</a>(\*\*<a href="src/beeper_desktop_api/types/client_download_asset_params.py">params</a>) -> <a href="./src/beeper_desktop_api/types/download_asset_response.py">DownloadAssetResponse</a></code>
-- <code title="post /v1/open">client.<a href="./src/beeper_desktop_api/_client.py">open</a>(\*\*<a href="src/beeper_desktop_api/types/client_open_params.py">params</a>) -> <a href="./src/beeper_desktop_api/types/open_response.py">OpenResponse</a></code>
+- <code title="post /v1/focus">client.<a href="./src/beeper_desktop_api/_client.py">focus</a>(\*\*<a href="src/beeper_desktop_api/types/client_focus_params.py">params</a>) -> <a href="./src/beeper_desktop_api/types/focus_response.py">FocusResponse</a></code>
 - <code title="get /v1/search">client.<a href="./src/beeper_desktop_api/_client.py">search</a>(\*\*<a href="src/beeper_desktop_api/types/client_search_params.py">params</a>) -> <a href="./src/beeper_desktop_api/types/search_response.py">SearchResponse</a></code>
 
 # Accounts
@@ -30,17 +30,18 @@ Methods:
 
 - <code title="get /v1/accounts">client.accounts.<a href="./src/beeper_desktop_api/resources/accounts.py">list</a>() -> <a href="./src/beeper_desktop_api/types/account_list_response.py">AccountListResponse</a></code>
 
-# Contacts
+# Search
 
 Types:
 
 ```python
-from beeper_desktop_api.types import ContactSearchResponse
+from beeper_desktop_api.types import SearchContactsResponse
 ```
 
 Methods:
 
-- <code title="get /v1/accounts/{accountID}/contacts/search">client.contacts.<a href="./src/beeper_desktop_api/resources/contacts.py">search</a>(account_id, \*\*<a href="src/beeper_desktop_api/types/contact_search_params.py">params</a>) -> <a href="./src/beeper_desktop_api/types/contact_search_response.py">ContactSearchResponse</a></code>
+- <code title="get /v1/search/chats">client.search.<a href="./src/beeper_desktop_api/resources/search.py">chats</a>(\*\*<a href="src/beeper_desktop_api/types/search_chats_params.py">params</a>) -> <a href="./src/beeper_desktop_api/types/chat.py">SyncCursorSearch[Chat]</a></code>
+- <code title="get /v1/search/contacts/{accountID}">client.search.<a href="./src/beeper_desktop_api/resources/search.py">contacts</a>(account_id, \*\*<a href="src/beeper_desktop_api/types/search_contacts_params.py">params</a>) -> <a href="./src/beeper_desktop_api/types/search_contacts_response.py">SearchContactsResponse</a></code>
 
 # Chats
 
@@ -56,7 +57,6 @@ Methods:
 - <code title="get /v1/chats/{chatID}">client.chats.<a href="./src/beeper_desktop_api/resources/chats/chats.py">retrieve</a>(chat_id, \*\*<a href="src/beeper_desktop_api/types/chat_retrieve_params.py">params</a>) -> <a href="./src/beeper_desktop_api/types/chat.py">Chat</a></code>
 - <code title="get /v1/chats">client.chats.<a href="./src/beeper_desktop_api/resources/chats/chats.py">list</a>(\*\*<a href="src/beeper_desktop_api/types/chat_list_params.py">params</a>) -> <a href="./src/beeper_desktop_api/types/chat_list_response.py">SyncCursorList[ChatListResponse]</a></code>
 - <code title="post /v1/chats/{chatID}/archive">client.chats.<a href="./src/beeper_desktop_api/resources/chats/chats.py">archive</a>(chat_id, \*\*<a href="src/beeper_desktop_api/types/chat_archive_params.py">params</a>) -> <a href="./src/beeper_desktop_api/types/shared/base_response.py">BaseResponse</a></code>
-- <code title="get /v1/chats/search">client.chats.<a href="./src/beeper_desktop_api/resources/chats/chats.py">search</a>(\*\*<a href="src/beeper_desktop_api/types/chat_search_params.py">params</a>) -> <a href="./src/beeper_desktop_api/types/chat.py">SyncCursorSearch[Chat]</a></code>
 
 ## Reminders
 
@@ -76,5 +76,5 @@ from beeper_desktop_api.types import MessageSendResponse
 Methods:
 
 - <code title="get /v1/chats/{chatID}/messages">client.messages.<a href="./src/beeper_desktop_api/resources/messages.py">list</a>(chat_id, \*\*<a href="src/beeper_desktop_api/types/message_list_params.py">params</a>) -> <a href="./src/beeper_desktop_api/types/shared/message.py">SyncCursorList[Message]</a></code>
-- <code title="get /v1/messages/search">client.messages.<a href="./src/beeper_desktop_api/resources/messages.py">search</a>(\*\*<a href="src/beeper_desktop_api/types/message_search_params.py">params</a>) -> <a href="./src/beeper_desktop_api/types/shared/message.py">SyncCursorSearch[Message]</a></code>
+- <code title="get /v1/search/messages">client.messages.<a href="./src/beeper_desktop_api/resources/messages.py">search</a>(\*\*<a href="src/beeper_desktop_api/types/message_search_params.py">params</a>) -> <a href="./src/beeper_desktop_api/types/shared/message.py">SyncCursorSearch[Message]</a></code>
 - <code title="post /v1/chats/{chatID}/messages">client.messages.<a href="./src/beeper_desktop_api/resources/messages.py">send</a>(chat_id, \*\*<a href="src/beeper_desktop_api/types/message_send_params.py">params</a>) -> <a href="./src/beeper_desktop_api/types/message_send_response.py">MessageSendResponse</a></code>