chore: 🐝 Update SDK - Generate 6.4.0 (#47)

* ci: regenerated with OpenAPI Doc , Speakeasy CLI 1.617.1

* empty commit to trigger [run-tests] workflow

* Update README.md

---------

Co-authored-by: speakeasybot <[email protected]>
Co-authored-by: speakeasy-github[bot] <128539517+speakeasy-github[bot]@users.noreply.github.com>
Co-authored-by: Maxence Maireaux <[email protected]>

Author: 4 people

.gitignore

@@ -1,3 +1,5 @@
+.env
+.env.local
 **/__pycache__/
 README-PYPI.md
 **/.speakeasy/temp/

.speakeasy/gen.lock

@@ -3,10 +3,10 @@ id: 1e0c88f5-b1c8-4198-83d8-36bd00451cd3
 management:
   docChecksum: 2303b8447e474d428256a66f5ab2f945
   docVersion: v3.0.5
-  speakeasyVersion: 1.565.0
-  generationVersion: 2.630.9
-  releaseVersion: 6.3.1
-  configChecksum: 1c7f48266aad475c205cf1af411d04aa
+  speakeasyVersion: 1.617.1
+  generationVersion: 2.701.8
+  releaseVersion: 6.4.0
+  configChecksum: d83c5cc9f192da616085309cdacc7240
   repoURL: https://github.com/formancehq/formance-sdk-python.git
   repoSubDirectory: .
   installationURL: https://github.com/formancehq/formance-sdk-python.git
@@ -16,29 +16,28 @@ features:
     additionalDependencies: 1.0.0
     bigint: 1.0.0
     constsAndDefaults: 1.0.5
-    core: 5.19.3
+    core: 5.20.4
     defaultEnabledRetries: 0.2.0
     deprecations: 3.0.2
     downloadStreams: 1.0.1
     enumUnions: 0.1.0
     envVarSecurityUsage: 0.3.2
-    errors: 3.2.0
+    errors: 3.3.3
     getRequestBodies: 3.0.0
-    globalSecurity: 3.0.3
+    globalSecurity: 3.0.4
     globalSecurityCallbacks: 1.0.0
     globalServerURLs: 3.1.1
     ignores: 3.0.1
     nameOverrides: 3.0.1
     nullables: 1.0.1
-    oauth2ClientCredentials: 1.2.1
+    oauth2ClientCredentials: 1.3.0
     responseFormat: 1.0.1
     retries: 3.0.2
     sdkHooks: 1.1.0
     unions: 3.0.4
     uploadStreams: 1.0.0
 generatedFiles:
   - .gitattributes
-  - .python-version
   - .vscode/settings.json
   - USAGE.md
   - docs/models/errors/error.md
@@ -1047,8 +1046,11 @@ generatedFiles:
   - src/formance_sdk_python/models/errors/__init__.py
   - src/formance_sdk_python/models/errors/error.py
   - src/formance_sdk_python/models/errors/errorresponse.py
+  - src/formance_sdk_python/models/errors/no_response_error.py
   - src/formance_sdk_python/models/errors/paymentserrorresponse.py
   - src/formance_sdk_python/models/errors/reconciliationerrorresponse.py
+  - src/formance_sdk_python/models/errors/responsevalidationerror.py
+  - src/formance_sdk_python/models/errors/sdkbaseerror.py
   - src/formance_sdk_python/models/errors/sdkerror.py
   - src/formance_sdk_python/models/errors/v2error.py
   - src/formance_sdk_python/models/errors/v2errorresponse.py
@@ -1731,6 +1733,7 @@ generatedFiles:
   - src/formance_sdk_python/utils/retries.py
   - src/formance_sdk_python/utils/security.py
   - src/formance_sdk_python/utils/serializers.py
+  - src/formance_sdk_python/utils/unmarshal_json_response.py
   - src/formance_sdk_python/utils/url.py
   - src/formance_sdk_python/utils/values.py
   - src/formance_sdk_python/v3.py

.speakeasy/workflow.lock

@@ -1,21 +1,21 @@
-speakeasyVersion: 1.565.0
+speakeasyVersion: 1.617.1
 sources:
     stacks-source:
         sourceNamespace: stacks-source
-        sourceRevisionDigest: sha256:112df29110fcab692d1ae2e445eb71bc723d0c06816ca0eb526fd28f1631f930
-        sourceBlobDigest: sha256:675ba84c245ed56b7b1b5b2bd89af6529a8c9018f62f9f329f41d53ce0eb1049
+        sourceRevisionDigest: sha256:fdd647ec761a320ea71c8b1d466fb5e760cf7f2b1296d3522d9d1706afb0e4c3
+        sourceBlobDigest: sha256:b4f71aed3da317fc4aeaa3a423976f893198810336c71f2ffef1d630f1a925d4
         tags:
             - latest
-            - speakeasy-sdk-regen-1750254471
+            - speakeasy-sdk-regen-1754440427
             - v3.0.5
 targets:
     formance-python-sdk:
         source: stacks-source
         sourceNamespace: stacks-source
-        sourceRevisionDigest: sha256:112df29110fcab692d1ae2e445eb71bc723d0c06816ca0eb526fd28f1631f930
-        sourceBlobDigest: sha256:675ba84c245ed56b7b1b5b2bd89af6529a8c9018f62f9f329f41d53ce0eb1049
+        sourceRevisionDigest: sha256:fdd647ec761a320ea71c8b1d466fb5e760cf7f2b1296d3522d9d1706afb0e4c3
+        sourceBlobDigest: sha256:b4f71aed3da317fc4aeaa3a423976f893198810336c71f2ffef1d630f1a925d4
         codeSamplesNamespace: stacks-source-python-code-samples
-        codeSamplesRevisionDigest: sha256:46e68b17f5c0bb9a63c0329639aef6571bd44d4f478c83f0529e876f84f81129
+        codeSamplesRevisionDigest: sha256:d73562e29b0ae7d60cca0dface1abafeb6cb4f1b227e993acb9824e7b157d0bc
 workflow:
     workflowVersion: 1.0.0
     speakeasyVersion: latest

README-PYPI.md

@@ -7,15 +7,6 @@
     </a>
 </div>
 
-
-## 🏗 **Welcome to your new SDK!** 🏗
-
-It has been generated successfully based on your OpenAPI spec. However, it is not yet ready for production use. Here are some next steps:
-- [ ] 🛠 Make your SDK feel handcrafted by [customizing it](https://www.speakeasyapi.dev/docs/customize-sdks)
-- [ ] ♻️ Refine your SDK quickly by iterating locally with the [Speakeasy CLI](https://github.com/speakeasy-api/speakeasy)
-- [ ] 🎁 Publish your SDK to package managers by [configuring automatic publishing](https://www.speakeasyapi.dev/docs/productionize-sdks/publish-sdks)
-- [ ] ✨ When ready to productionize, delete this section from the README
-
 <!-- Start Summary [summary] -->
 ## Summary
 
@@ -65,7 +56,15 @@ and standard method from web, mobile and desktop applications.
 >
 > Once a Python version reaches its [official end of life date](https://devguide.python.org/versions/), a 3-month grace period is provided for users to upgrade. Following this grace period, the minimum python version supported in the SDK will be updated.
 
-The SDK can be installed with either *pip* or *poetry* package managers.
+The SDK can be installed with *uv*, *pip*, or *poetry* package managers.
+
+### uv
+
+*uv* is a fast Python package installer and resolver, designed as a drop-in replacement for pip and pip-tools. It's recommended for its speed and modern Python tooling capabilities.
+
+```bash
+uv add formance-sdk-python
+```
 
 ### PIP
 
@@ -153,7 +152,7 @@ with SDK(
 
 </br>
 
-The same SDK client can also be used to make asychronous requests by importing asyncio.
+The same SDK client can also be used to make asynchronous requests by importing asyncio.
 ```python
 # Asynchronous Example
 import asyncio
@@ -563,26 +562,18 @@ with SDK(
 <!-- Start Error Handling [errors] -->
 ## Error Handling
 
-Handling errors in this SDK should largely match your expectations. All operations return a response object or raise an exception.
-
-By default, an API error will raise a errors.SDKError exception, which has the following properties:
+[`SDKBaseError`](./src/formance_sdk_python/models/errors/sdkbaseerror.py) is the base class for all HTTP error responses. It has the following properties:
 
-| Property        | Type             | Description           |
-|-----------------|------------------|-----------------------|
-| `.status_code`  | *int*            | The HTTP status code  |
-| `.message`      | *str*            | The error message     |
-| `.raw_response` | *httpx.Response* | The raw HTTP response |
-| `.body`         | *str*            | The response content  |
-
-When custom error responses are specified for an operation, the SDK may also raise their associated exceptions. You can refer to respective *Errors* tables in SDK docs for more details on possible exception types for each operation. For example, the `add_metadata_on_transaction_async` method may raise the following exceptions:
-
-| Error Type             | Status Code | Content Type     |
-| ---------------------- | ----------- | ---------------- |
-| errors.V2ErrorResponse | default     | application/json |
-| errors.SDKError        | 4XX, 5XX    | \*/\*            |
+| Property           | Type             | Description                                                                             |
+| ------------------ | ---------------- | --------------------------------------------------------------------------------------- |
+| `err.message`      | `str`            | Error message                                                                           |
+| `err.status_code`  | `int`            | HTTP response status code eg `404`                                                      |
+| `err.headers`      | `httpx.Headers`  | HTTP response headers                                                                   |
+| `err.body`         | `str`            | HTTP body. Can be empty string if no body is returned.                                  |
+| `err.raw_response` | `httpx.Response` | Raw HTTP response                                                                       |
+| `err.data`         |                  | Optional. Some errors may contain structured data. [See Error Classes](#error-classes). |
 
 ### Example
-
 ```python
 from formance_sdk_python import SDK
 from formance_sdk_python.models import errors, shared
@@ -611,13 +602,51 @@ with SDK(
         # Handle response
         print(res)
 
-    except errors.V2ErrorResponse as e:
-        # handle e.data: errors.V2ErrorResponseData
-        raise(e)
-    except errors.SDKError as e:
-        # handle exception
-        raise(e)
+
+    except errors.SDKBaseError as e:
+        # The base class for HTTP error responses
+        print(e.message)
+        print(e.status_code)
+        print(e.body)
+        print(e.headers)
+        print(e.raw_response)
+
+        # Depending on the method different errors may be thrown
+        if isinstance(e, errors.V2ErrorResponse):
+            print(e.data.details)  # Optional[str]
+            print(e.data.error_code)  # shared.V2ErrorsEnum
+            print(e.data.error_message)  # str
 ```
+
+### Error Classes
+**Primary error:**
+* [`SDKBaseError`](./src/formance_sdk_python/models/errors/sdkbaseerror.py): The base class for HTTP error responses.
+
+<details><summary>Less common errors (14)</summary>
+
+<br />
+
+**Network errors:**
+* [`httpx.RequestError`](https://www.python-httpx.org/exceptions/#httpx.RequestError): Base class for request errors.
+    * [`httpx.ConnectError`](https://www.python-httpx.org/exceptions/#httpx.ConnectError): HTTP client was unable to make a request to a server.
+    * [`httpx.TimeoutException`](https://www.python-httpx.org/exceptions/#httpx.TimeoutException): HTTP request timed out.
+
+
+**Inherit from [`SDKBaseError`](./src/formance_sdk_python/models/errors/sdkbaseerror.py)**:
+* [`V3ErrorResponse`](./src/formance_sdk_python/models/errors/v3errorresponse.py): Error. Applicable to 46 of 219 methods.*
+* [`PaymentsErrorResponse`](./src/formance_sdk_python/models/errors/paymentserrorresponse.py): Error. Applicable to 45 of 219 methods.*
+* [`V2ErrorResponse`](./src/formance_sdk_python/models/errors/v2errorresponse.py): Error. Applicable to 26 of 219 methods.*
+* [`ErrorResponse`](./src/formance_sdk_python/models/errors/errorresponse.py): Applicable to 19 of 219 methods.*
+* [`V2Error`](./src/formance_sdk_python/models/errors/v2error.py): General error. Applicable to 18 of 219 methods.*
+* [`Error`](./src/formance_sdk_python/models/errors/error.py): General error. Applicable to 17 of 219 methods.*
+* [`WalletsErrorResponse`](./src/formance_sdk_python/models/errors/walletserrorresponse.py): Applicable to 15 of 219 methods.*
+* [`ReconciliationErrorResponse`](./src/formance_sdk_python/models/errors/reconciliationerrorresponse.py): Error response. Applicable to 8 of 219 methods.*
+* [`WebhooksErrorResponse`](./src/formance_sdk_python/models/errors/webhookserrorresponse.py): Error. Applicable to 8 of 219 methods.*
+* [`ResponseValidationError`](./src/formance_sdk_python/models/errors/responsevalidationerror.py): Type mismatch between the response data and the expected Pydantic model. Provides access to the Pydantic validation error via the `cause` attribute.
+
+</details>
+
+\* Check [the method documentation](#available-resources-and-operations) to see if the error is applicable.
 <!-- End Error Handling [errors] -->
 
 <!-- Start Server Selection [server] -->

README.md

@@ -218,4 +218,14 @@ Based on:
 ### Generated
 - [python v6.3.1] .
 ### Releases
-- [PyPI v6.3.1] https://pypi.org/project/formance-sdk-python/6.3.1 - .
+- [PyPI v6.3.1] https://pypi.org/project/formance-sdk-python/6.3.1 - .
+
+## 2025-09-17 00:28:25
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.617.1 (2.701.8) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v6.4.0] .
+### Releases
+- [PyPI v6.4.0] https://pypi.org/project/formance-sdk-python/6.4.0 - .

RELEASES.md

@@ -22,7 +22,7 @@ with SDK(
 
 </br>
 
-The same SDK client can also be used to make asychronous requests by importing asyncio.
+The same SDK client can also be used to make asynchronous requests by importing asyncio.
 ```python
 # Asynchronous Example
 import asyncio

USAGE.md

@@ -23,6 +23,7 @@ Create client
 
 ### Example Usage
 
+<!-- UsageSnippet language="python" operationID="createClient" method="post" path="/api/auth/clients" -->
 ```python
 from formance_sdk_python import SDK
 from formance_sdk_python.models import shared
@@ -67,6 +68,7 @@ Add a secret to a client
 
 ### Example Usage
 
+<!-- UsageSnippet language="python" operationID="createSecret" method="post" path="/api/auth/clients/{clientId}/secrets" -->
 ```python
 from formance_sdk_python import SDK
 from formance_sdk_python.models import shared
@@ -113,6 +115,7 @@ Delete client
 
 ### Example Usage
 
+<!-- UsageSnippet language="python" operationID="deleteClient" method="delete" path="/api/auth/clients/{clientId}" -->
 ```python
 from formance_sdk_python import SDK
 from formance_sdk_python.models import shared
@@ -159,6 +162,7 @@ Delete a secret from a client
 
 ### Example Usage
 
+<!-- UsageSnippet language="python" operationID="deleteSecret" method="delete" path="/api/auth/clients/{clientId}/secrets/{secretId}" -->
 ```python
 from formance_sdk_python import SDK
 from formance_sdk_python.models import shared
@@ -206,6 +210,7 @@ Retrieve OpenID connect well-knowns.
 
 ### Example Usage
 
+<!-- UsageSnippet language="python" operationID="getOIDCWellKnowns" method="get" path="/api/auth/.well-known/openid-configuration" -->
 ```python
 from formance_sdk_python import SDK
 from formance_sdk_python.models import shared
@@ -249,6 +254,7 @@ Get server info
 
 ### Example Usage
 
+<!-- UsageSnippet language="python" operationID="getServerInfo" method="get" path="/api/auth/_info" -->
 ```python
 from formance_sdk_python import SDK
 from formance_sdk_python.models import shared
@@ -292,6 +298,7 @@ List clients
 
 ### Example Usage
 
+<!-- UsageSnippet language="python" operationID="listClients" method="get" path="/api/auth/clients" -->
 ```python
 from formance_sdk_python import SDK
 from formance_sdk_python.models import shared
@@ -335,6 +342,7 @@ List users
 
 ### Example Usage
 
+<!-- UsageSnippet language="python" operationID="listUsers" method="get" path="/api/auth/users" -->
 ```python
 from formance_sdk_python import SDK
 from formance_sdk_python.models import shared
@@ -378,6 +386,7 @@ Read client
 
 ### Example Usage
 
+<!-- UsageSnippet language="python" operationID="readClient" method="get" path="/api/auth/clients/{clientId}" -->
 ```python
 from formance_sdk_python import SDK
 from formance_sdk_python.models import shared
@@ -424,6 +433,7 @@ Read user
 
 ### Example Usage
 
+<!-- UsageSnippet language="python" operationID="readUser" method="get" path="/api/auth/users/{userId}" -->
 ```python
 from formance_sdk_python import SDK
 from formance_sdk_python.models import shared
@@ -470,6 +480,7 @@ Update client
 
 ### Example Usage
 
+<!-- UsageSnippet language="python" operationID="updateClient" method="put" path="/api/auth/clients/{clientId}" -->
 ```python
 from formance_sdk_python import SDK
 from formance_sdk_python.models import shared