Merge pull request #58 from openintegrations/release-please--branches--main--changes--next

release: 1.4.0

Author: pellicceama

.github/workflows/ci.yml

@@ -12,7 +12,6 @@ jobs:
   lint:
     name: lint
     runs-on: ubuntu-latest
-
     steps:
       - uses: actions/checkout@v4
 
@@ -33,7 +32,6 @@ jobs:
   test:
     name: test
     runs-on: ubuntu-latest
-
     steps:
       - uses: actions/checkout@v4
 

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "1.3.0"
+  ".": "1.4.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 9
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openint%2Fopenint-573ba7bb24acb12f9769960c0d801cd5e6d9522993d27f66c5c10c9e6588ea0e.yml
-openapi_spec_hash: db9d90654bbdc3d6280c4a4c752a08ed
-config_hash: 3745e90e1c879ca82ecfade8dfd108df
+configured_endpoints: 10
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openint%2Fopenint-349f41f89a594b4ccde7574cb56751d53504914e8b74a0561c86522f5b838e01.yml
+openapi_spec_hash: b33b7134c3e9650af2beebfbc0af1389
+config_hash: a6e549521fa293498319c532d9cfa93f

CHANGELOG.md

@@ -1,5 +1,36 @@
 # Changelog
 
+## 1.4.0 (2025-04-17)
+
+Full Changelog: [v1.3.0...v1.4.0](https://github.com/openintegrations/python-sdk/compare/v1.3.0...v1.4.0)
+
+### Features
+
+* **docs:** updating documented docs for stainless ([#59](https://github.com/openintegrations/python-sdk/issues/59)) ([67d2b1a](https://github.com/openintegrations/python-sdk/commit/67d2b1afd93f7c03ec0cf4b9efca10955e67b0a2))
+* **docs:** updating documented docs for stainless ([#60](https://github.com/openintegrations/python-sdk/issues/60)) ([3198217](https://github.com/openintegrations/python-sdk/commit/3198217a87b4905bccd2a2aa8b73d1d7078c64dd))
+* **docs:** updating documented docs for stainless ([#63](https://github.com/openintegrations/python-sdk/issues/63)) ([c58d10f](https://github.com/openintegrations/python-sdk/commit/c58d10f974edc4e5b0a4b773e491ac15dc0a6a1a))
+
+
+### Bug Fixes
+
+* **api:** adding list connectors ([#57](https://github.com/openintegrations/python-sdk/issues/57)) ([4346d9f](https://github.com/openintegrations/python-sdk/commit/4346d9f25c93a12cc9d053a875f7ddd8713ad8b2))
+* **client:** add missing `None` default ([#62](https://github.com/openintegrations/python-sdk/issues/62)) ([c485bed](https://github.com/openintegrations/python-sdk/commit/c485bed766abe22f064cbe35e565dd46a7c65153))
+* **client:** send all configured auth headers ([#64](https://github.com/openintegrations/python-sdk/issues/64)) ([d275e08](https://github.com/openintegrations/python-sdk/commit/d275e08a1ad94ceb314199a05ac77f4fe3fa42c5))
+* **perf:** optimize some hot paths ([0cfd3e8](https://github.com/openintegrations/python-sdk/commit/0cfd3e84986aab3170fe95d03914fca2cf4a6de1))
+* **perf:** skip traversing types for NotGiven values ([8701b67](https://github.com/openintegrations/python-sdk/commit/8701b673ba7330a950b8b01ced03e7f932aafc1c))
+
+
+### Chores
+
+* **client:** minor internal fixes ([51521a0](https://github.com/openintegrations/python-sdk/commit/51521a02d06ba4735c88b2a2c4a8e5cbc1a73fc4))
+* **internal:** base client updates ([b363862](https://github.com/openintegrations/python-sdk/commit/b363862cbc085488312f80981f866bf116e49b42))
+* **internal:** bump pyright version ([218ab17](https://github.com/openintegrations/python-sdk/commit/218ab17be07865cca836d851809edf2e1aa11943))
+* **internal:** expand CI branch coverage ([2fd500b](https://github.com/openintegrations/python-sdk/commit/2fd500bff96581dad3331a0a89e2a02d0a00f872))
+* **internal:** reduce CI branch coverage ([763f501](https://github.com/openintegrations/python-sdk/commit/763f501a41880cfff017f4469863d0d5e2e3789d))
+* **internal:** remove trailing character ([#61](https://github.com/openintegrations/python-sdk/issues/61)) ([b5d7c1c](https://github.com/openintegrations/python-sdk/commit/b5d7c1ca8c2180df9c831996e0253415e0b0571b))
+* **internal:** slight transform perf improvement ([#65](https://github.com/openintegrations/python-sdk/issues/65)) ([8ec7112](https://github.com/openintegrations/python-sdk/commit/8ec71120f3f140b0998e561bb738b7de6bb0c489))
+* **internal:** update pyright settings ([075ff3f](https://github.com/openintegrations/python-sdk/commit/075ff3f61e5dcfc11e68df7db663e5611f1c064a))
+
 ## 1.3.0 (2025-04-03)
 
 Full Changelog: [v1.2.0...v1.3.0](https://github.com/openintegrations/python-sdk/compare/v1.2.0...v1.3.0)

README.md

@@ -90,9 +90,9 @@ response = client.create_magic_link(
         "minus_card_foreground": "--card-foreground",
         "minus_foreground": "--foreground",
         "minus_primary": "--primary",
-        "connector_name": "plaid",
+        "connector_name": "aircall",
         "debug": True,
-        "tab": "my-connections",
+        "view": "add",
     },
 )
 print(response.client_options)

api.md

@@ -13,6 +13,7 @@ from openint.types import (
     GetCurrentUserResponse,
     ListConnectionConfigsResponse,
     ListConnectionsResponse,
+    ListConnectorsResponse,
 )
 ```
 
@@ -27,3 +28,4 @@ Methods:
 - <code title="get /viewer">client.<a href="./src/openint/_client.py">get_current_user</a>() -> <a href="./src/openint/types/get_current_user_response.py">GetCurrentUserResponse</a></code>
 - <code title="get /connector-config">client.<a href="./src/openint/_client.py">list_connection_configs</a>(\*\*<a href="src/openint/types/client_list_connection_configs_params.py">params</a>) -> <a href="./src/openint/types/list_connection_configs_response.py">SyncOffsetPagination[ListConnectionConfigsResponse]</a></code>
 - <code title="get /connection">client.<a href="./src/openint/_client.py">list_connections</a>(\*\*<a href="src/openint/types/client_list_connections_params.py">params</a>) -> <a href="./src/openint/types/list_connections_response.py">SyncOffsetPagination[ListConnectionsResponse]</a></code>
+- <code title="get /connector">client.<a href="./src/openint/_client.py">list_connectors</a>(\*\*<a href="src/openint/types/client_list_connectors_params.py">params</a>) -> <a href="./src/openint/types/list_connectors_response.py">ListConnectorsResponse</a></code>

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "openint"
-version = "1.3.0"
+version = "1.4.0"
 description = "The official Python library for the Openint API"
 dynamic = ["readme"]
 license = "Apache-2.0"
@@ -42,7 +42,7 @@ Repository = "https://github.com/openintegrations/python-sdk"
 managed = true
 # version pins are in requirements-dev.lock
 dev-dependencies = [
-    "pyright>=1.1.359",
+    "pyright==1.1.399",
     "mypy",
     "respx",
     "pytest",
@@ -147,6 +147,7 @@ exclude = [
 ]
 
 reportImplicitOverride = true
+reportOverlappingOverload = false
 
 reportImportCycles = false
 reportPrivateUsage = false

requirements-dev.lock

@@ -69,7 +69,7 @@ pydantic-core==2.27.1
     # via pydantic
 pygments==2.18.0
     # via rich
-pyright==1.1.392.post0
+pyright==1.1.399
 pytest==8.3.3
     # via pytest-asyncio
 pytest-asyncio==0.24.0

src/openint/_base_client.py

@@ -98,7 +98,11 @@
 _AsyncStreamT = TypeVar("_AsyncStreamT", bound=AsyncStream[Any])
 
 if TYPE_CHECKING:
-    from httpx._config import DEFAULT_TIMEOUT_CONFIG as HTTPX_DEFAULT_TIMEOUT
+    from httpx._config import (
+        DEFAULT_TIMEOUT_CONFIG,  # pyright: ignore[reportPrivateImportUsage]
+    )
+
+    HTTPX_DEFAULT_TIMEOUT = DEFAULT_TIMEOUT_CONFIG
 else:
     try:
         from httpx._config import DEFAULT_TIMEOUT_CONFIG as HTTPX_DEFAULT_TIMEOUT
@@ -115,6 +119,7 @@ class PageInfo:
 
     url: URL | NotGiven
     params: Query | NotGiven
+    json: Body | NotGiven
 
     @overload
     def __init__(
@@ -130,19 +135,30 @@ def __init__(
         params: Query,
     ) -> None: ...
 
+    @overload
+    def __init__(
+        self,
+        *,
+        json: Body,
+    ) -> None: ...
+
     def __init__(
         self,
         *,
         url: URL | NotGiven = NOT_GIVEN,
+        json: Body | NotGiven = NOT_GIVEN,
         params: Query | NotGiven = NOT_GIVEN,
     ) -> None:
         self.url = url
+        self.json = json
         self.params = params
 
     @override
     def __repr__(self) -> str:
         if self.url:
             return f"{self.__class__.__name__}(url={self.url})"
+        if self.json:
+            return f"{self.__class__.__name__}(json={self.json})"
         return f"{self.__class__.__name__}(params={self.params})"
 
 
@@ -191,6 +207,19 @@ def _info_to_options(self, info: PageInfo) -> FinalRequestOptions:
             options.url = str(url)
             return options
 
+        if not isinstance(info.json, NotGiven):
+            if not is_mapping(info.json):
+                raise TypeError("Pagination is only supported with mappings")
+
+            if not options.json_data:
+                options.json_data = {**info.json}
+            else:
+                if not is_mapping(options.json_data):
+                    raise TypeError("Pagination is only supported with mappings")
+
+                options.json_data = {**options.json_data, **info.json}
+            return options
+
         raise ValueError("Unexpected PageInfo state")
 
 
@@ -409,7 +438,8 @@ def _build_headers(self, options: FinalRequestOptions, *, retries_taken: int = 0
 
         idempotency_header = self._idempotency_header
         if idempotency_header and options.method.lower() != "get" and idempotency_header not in headers:
-            headers[idempotency_header] = options.idempotency_key or self._idempotency_key()
+            options.idempotency_key = options.idempotency_key or self._idempotency_key()
+            headers[idempotency_header] = options.idempotency_key
 
         # Don't set these headers if they were already set or removed by the caller. We check
         # `custom_headers`, which can contain `Omit()`, instead of `headers` to account for the removal case.
@@ -943,6 +973,10 @@ def _request(
         request = self._build_request(options, retries_taken=retries_taken)
         self._prepare_request(request)
 
+        if options.idempotency_key:
+            # ensure the idempotency key is reused between requests
+            input_options.idempotency_key = options.idempotency_key
+
         kwargs: HttpxSendArgs = {}
         if self.custom_auth is not None:
             kwargs["auth"] = self.custom_auth
@@ -1475,6 +1509,10 @@ async def _request(
         request = self._build_request(options, retries_taken=retries_taken)
         await self._prepare_request(request)
 
+        if options.idempotency_key:
+            # ensure the idempotency key is reused between requests
+            input_options.idempotency_key = options.idempotency_key
+
         kwargs: HttpxSendArgs = {}
         if self.custom_auth is not None:
             kwargs["auth"] = self.custom_auth