checkout-intents 0.11.0__tar.gz → 0.12.0__tar.gz

checkout_intents-0.12.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.12.0"
+}

{checkout_intents-0.11.0 → checkout_intents-0.12.0}/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 0.12.0 (2026-01-24)
+
+Full Changelog: [v0.11.0...v0.12.0](https://github.com/rye-com/checkout-intents-python/compare/v0.11.0...v0.12.0)
+
+### Features
+
+* add support for idempotency for v2 api ([b7a09af](https://github.com/rye-com/checkout-intents-python/commit/b7a09af76927e67befdbe59566bddf7ab43240f0))
+* **api:** introduce offerRetrievalEffort constraint ([5bc7a2c](https://github.com/rye-com/checkout-intents-python/commit/5bc7a2cc58c555dd4dcd5c0e3abf1f157cd61e8f))
+
+
+### Chores
+
+* **ci:** upgrade `actions/github-script` ([526d94a](https://github.com/rye-com/checkout-intents-python/commit/526d94ae385eb0e5f54124ca429651d55ce0ec53))
+* **internal:** update `actions/checkout` version ([9eadb2e](https://github.com/rye-com/checkout-intents-python/commit/9eadb2e9a5a8abaad98be7567dd3dc195458cd53))
+
 ## 0.11.0 (2026-01-15)
 
 Full Changelog: [v0.10.0...v0.11.0](https://github.com/rye-com/checkout-intents-python/compare/v0.10.0...v0.11.0)

{checkout_intents-0.11.0 → checkout_intents-0.12.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: checkout-intents
-Version: 0.11.0
+Version: 0.12.0
 Summary: The official Python library for the Checkout Intents API
 Project-URL: Homepage, https://github.com/rye-com/checkout-intents-python
 Project-URL: Repository, https://github.com/rye-com/checkout-intents-python

{checkout_intents-0.11.0 → checkout_intents-0.12.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "checkout-intents"
-version = "0.11.0"
+version = "0.12.0"
 description = "The official Python library for the Checkout Intents API"
 dynamic = ["readme"]
 license = "MIT"

{checkout_intents-0.11.0 → checkout_intents-0.12.0}/src/checkout_intents/_client.py

@@ -167,6 +167,8 @@ class CheckoutIntents(SyncAPIClient):
             _strict_response_validation=_strict_response_validation,
         )
 
+        self._idempotency_header = "Idempotency-Key"
+
     @cached_property
     def checkout_intents(self) -> CheckoutIntentsResource:
         from .resources.checkout_intents import CheckoutIntentsResource
@@ -396,6 +398,8 @@ class AsyncCheckoutIntents(AsyncAPIClient):
             _strict_response_validation=_strict_response_validation,
         )
 
+        self._idempotency_header = "Idempotency-Key"
+
     @cached_property
     def checkout_intents(self) -> AsyncCheckoutIntentsResource:
         from .resources.checkout_intents import AsyncCheckoutIntentsResource

{checkout_intents-0.11.0 → checkout_intents-0.12.0}/src/checkout_intents/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "checkout_intents"
-__version__ = "0.11.0"  # x-release-please-version
+__version__ = "0.12.0"  # x-release-please-version

{checkout_intents-0.11.0 → checkout_intents-0.12.0}/src/checkout_intents/resources/betas/checkout_sessions.py

@@ -59,6 +59,7 @@ class CheckoutSessionsResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
+        idempotency_key: str | None = None,
     ) -> CheckoutSession:
         """
         Create a new checkout session.
@@ -77,6 +78,8 @@ class CheckoutSessionsResource(SyncAPIResource):
           extra_body: Add additional JSON properties to the request
 
           timeout: Override the client-level default timeout for this request, in seconds
+
+          idempotency_key: Specify a custom idempotency key for this request
         """
         return self._post(
             "/api/v1/betas/checkout-sessions",
@@ -92,7 +95,11 @@ class CheckoutSessionsResource(SyncAPIResource):
                 checkout_session_create_params.CheckoutSessionCreateParams,
             ),
             options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                idempotency_key=idempotency_key,
             ),
             cast_to=CheckoutSession,
         )
@@ -133,6 +140,7 @@ class AsyncCheckoutSessionsResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
+        idempotency_key: str | None = None,
     ) -> CheckoutSession:
         """
         Create a new checkout session.
@@ -151,6 +159,8 @@ class AsyncCheckoutSessionsResource(AsyncAPIResource):
           extra_body: Add additional JSON properties to the request
 
           timeout: Override the client-level default timeout for this request, in seconds
+
+          idempotency_key: Specify a custom idempotency key for this request
         """
         return await self._post(
             "/api/v1/betas/checkout-sessions",
@@ -166,7 +176,11 @@ class AsyncCheckoutSessionsResource(AsyncAPIResource):
                 checkout_session_create_params.CheckoutSessionCreateParams,
             ),
             options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                idempotency_key=idempotency_key,
             ),
             cast_to=CheckoutSession,
         )

{checkout_intents-0.11.0 → checkout_intents-0.12.0}/src/checkout_intents/resources/checkout_intents.py

@@ -80,6 +80,7 @@ class CheckoutIntentsResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
+        idempotency_key: str | None = None,
     ) -> CheckoutIntent:
         """
         Create a checkout intent with the given request body.
@@ -92,6 +93,8 @@ class CheckoutIntentsResource(SyncAPIResource):
           extra_body: Add additional JSON properties to the request
 
           timeout: Override the client-level default timeout for this request, in seconds
+
+          idempotency_key: Specify a custom idempotency key for this request
         """
         return cast(
             CheckoutIntent,
@@ -109,7 +112,11 @@ class CheckoutIntentsResource(SyncAPIResource):
                     checkout_intent_create_params.CheckoutIntentCreateParams,
                 ),
                 options=make_request_options(
-                    extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                    idempotency_key=idempotency_key,
                 ),
                 cast_to=cast(Any, CheckoutIntent),  # Union types cannot be passed in as arguments in the type system
             ),
@@ -217,6 +224,7 @@ class CheckoutIntentsResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
+        idempotency_key: str | None = None,
     ) -> CheckoutIntent:
         """
         Add payment details to a checkout intent
@@ -229,6 +237,8 @@ class CheckoutIntentsResource(SyncAPIResource):
           extra_body: Add additional JSON properties to the request
 
           timeout: Override the client-level default timeout for this request, in seconds
+
+          idempotency_key: Specify a custom idempotency key for this request
         """
         if not id:
             raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
@@ -241,7 +251,11 @@ class CheckoutIntentsResource(SyncAPIResource):
                     checkout_intent_add_payment_params.CheckoutIntentAddPaymentParams,
                 ),
                 options=make_request_options(
-                    extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                    idempotency_key=idempotency_key,
                 ),
                 cast_to=cast(Any, CheckoutIntent),  # Union types cannot be passed in as arguments in the type system
             ),
@@ -258,6 +272,7 @@ class CheckoutIntentsResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
+        idempotency_key: str | None = None,
     ) -> CheckoutIntent:
         """
         Confirm a checkout intent with provided payment information
@@ -273,6 +288,8 @@ class CheckoutIntentsResource(SyncAPIResource):
           extra_body: Add additional JSON properties to the request
 
           timeout: Override the client-level default timeout for this request, in seconds
+
+          idempotency_key: Specify a custom idempotency key for this request
         """
         if not id:
             raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
@@ -284,7 +301,11 @@ class CheckoutIntentsResource(SyncAPIResource):
                     {"payment_method": payment_method}, checkout_intent_confirm_params.CheckoutIntentConfirmParams
                 ),
                 options=make_request_options(
-                    extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                    idempotency_key=idempotency_key,
                 ),
                 cast_to=cast(Any, CheckoutIntent),  # Union types cannot be passed in as arguments in the type system
             ),
@@ -306,6 +327,7 @@ class CheckoutIntentsResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
+        idempotency_key: str | None = None,
     ) -> CheckoutIntent:
         """
         Create a checkout intent and immediately trigger the purchase workflow.
@@ -322,6 +344,8 @@ class CheckoutIntentsResource(SyncAPIResource):
           extra_body: Add additional JSON properties to the request
 
           timeout: Override the client-level default timeout for this request, in seconds
+
+          idempotency_key: Specify a custom idempotency key for this request
         """
         return cast(
             CheckoutIntent,
@@ -340,7 +364,11 @@ class CheckoutIntentsResource(SyncAPIResource):
                     checkout_intent_purchase_params.CheckoutIntentPurchaseParams
                 ),
                 options=make_request_options(
-                    extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                    idempotency_key=idempotency_key,
                 ),
                 cast_to=cast(Any, CheckoutIntent),  # Union types cannot be passed in as arguments in the type system
             ),
@@ -741,6 +769,7 @@ class AsyncCheckoutIntentsResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
+        idempotency_key: str | None = None,
     ) -> CheckoutIntent:
         """
         Create a checkout intent with the given request body.
@@ -753,6 +782,8 @@ class AsyncCheckoutIntentsResource(AsyncAPIResource):
           extra_body: Add additional JSON properties to the request
 
           timeout: Override the client-level default timeout for this request, in seconds
+
+          idempotency_key: Specify a custom idempotency key for this request
         """
         return cast(
             CheckoutIntent,
@@ -770,7 +801,11 @@ class AsyncCheckoutIntentsResource(AsyncAPIResource):
                     checkout_intent_create_params.CheckoutIntentCreateParams,
                 ),
                 options=make_request_options(
-                    extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                    idempotency_key=idempotency_key,
                 ),
                 cast_to=cast(Any, CheckoutIntent),  # Union types cannot be passed in as arguments in the type system
             ),
@@ -878,6 +913,7 @@ class AsyncCheckoutIntentsResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
+        idempotency_key: str | None = None,
     ) -> CheckoutIntent:
         """
         Add payment details to a checkout intent
@@ -890,6 +926,8 @@ class AsyncCheckoutIntentsResource(AsyncAPIResource):
           extra_body: Add additional JSON properties to the request
 
           timeout: Override the client-level default timeout for this request, in seconds
+
+          idempotency_key: Specify a custom idempotency key for this request
         """
         if not id:
             raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
@@ -902,7 +940,11 @@ class AsyncCheckoutIntentsResource(AsyncAPIResource):
                     checkout_intent_add_payment_params.CheckoutIntentAddPaymentParams,
                 ),
                 options=make_request_options(
-                    extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                    idempotency_key=idempotency_key,
                 ),
                 cast_to=cast(Any, CheckoutIntent),  # Union types cannot be passed in as arguments in the type system
             ),
@@ -919,6 +961,7 @@ class AsyncCheckoutIntentsResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
+        idempotency_key: str | None = None,
     ) -> CheckoutIntent:
         """
         Confirm a checkout intent with provided payment information
@@ -934,6 +977,8 @@ class AsyncCheckoutIntentsResource(AsyncAPIResource):
           extra_body: Add additional JSON properties to the request
 
           timeout: Override the client-level default timeout for this request, in seconds
+
+          idempotency_key: Specify a custom idempotency key for this request
         """
         if not id:
             raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
@@ -945,7 +990,11 @@ class AsyncCheckoutIntentsResource(AsyncAPIResource):
                     {"payment_method": payment_method}, checkout_intent_confirm_params.CheckoutIntentConfirmParams
                 ),
                 options=make_request_options(
-                    extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                    idempotency_key=idempotency_key,
                 ),
                 cast_to=cast(Any, CheckoutIntent),  # Union types cannot be passed in as arguments in the type system
             ),
@@ -967,6 +1016,7 @@ class AsyncCheckoutIntentsResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
+        idempotency_key: str | None = None,
     ) -> CheckoutIntent:
         """
         Create a checkout intent and immediately trigger the purchase workflow.
@@ -983,6 +1033,8 @@ class AsyncCheckoutIntentsResource(AsyncAPIResource):
           extra_body: Add additional JSON properties to the request
 
           timeout: Override the client-level default timeout for this request, in seconds
+
+          idempotency_key: Specify a custom idempotency key for this request
         """
         return cast(
             CheckoutIntent,
@@ -1001,7 +1053,11 @@ class AsyncCheckoutIntentsResource(AsyncAPIResource):
                     checkout_intent_purchase_params.CheckoutIntentPurchaseParams
                 ),
                 options=make_request_options(
-                    extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                    extra_headers=extra_headers,
+                    extra_query=extra_query,
+                    extra_body=extra_body,
+                    timeout=timeout,
+                    idempotency_key=idempotency_key,
                 ),
                 cast_to=cast(Any, CheckoutIntent),  # Union types cannot be passed in as arguments in the type system
             ),

{checkout_intents-0.11.0 → checkout_intents-0.12.0}/src/checkout_intents/types/base_checkout_intent.py

@@ -2,6 +2,7 @@
 
 from typing import List, Optional
 from datetime import datetime
+from typing_extensions import Literal
 
 from pydantic import Field as FieldInfo
 
@@ -17,6 +18,16 @@ class Constraints(BaseModel):
 
     max_total_price: Optional[int] = FieldInfo(alias="maxTotalPrice", default=None)
 
+    offer_retrieval_effort: Optional[Literal["max", "low"]] = FieldInfo(alias="offerRetrievalEffort", default=None)
+    """Controls how much effort the system should spend retrieving an offer.
+
+    - 'max': Full effort including AI agent fallback (slower, higher success rate)
+    - 'low': Fast API-only retrieval, fails if API unavailable (faster, lower
+      success rate)
+
+    Default: 'max'
+    """
+
 
 class BaseCheckoutIntent(BaseModel):
     id: str

{checkout_intents-0.11.0 → checkout_intents-0.12.0}/src/checkout_intents/types/betas/checkout_session_create_params.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 
 from typing import Iterable
-from typing_extensions import Required, Annotated, TypedDict
+from typing_extensions import Literal, Required, Annotated, TypedDict
 
 from ..._types import SequenceNotStr
 from ..._utils import PropertyInfo
@@ -60,3 +60,13 @@ class Constraints(TypedDict, total=False):
     max_shipping_price: Annotated[int, PropertyInfo(alias="maxShippingPrice")]
 
     max_total_price: Annotated[int, PropertyInfo(alias="maxTotalPrice")]
+
+    offer_retrieval_effort: Annotated[Literal["max", "low"], PropertyInfo(alias="offerRetrievalEffort")]
+    """Controls how much effort the system should spend retrieving an offer.
+
+    - 'max': Full effort including AI agent fallback (slower, higher success rate)
+    - 'low': Fast API-only retrieval, fails if API unavailable (faster, lower
+      success rate)
+
+    Default: 'max'
+    """

{checkout_intents-0.11.0 → checkout_intents-0.12.0}/src/checkout_intents/types/checkout_intent_create_params.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 
 from typing import Iterable
-from typing_extensions import Required, Annotated, TypedDict
+from typing_extensions import Literal, Required, Annotated, TypedDict
 
 from .._types import SequenceNotStr
 from .._utils import PropertyInfo
@@ -31,3 +31,13 @@ class Constraints(TypedDict, total=False):
     max_shipping_price: Annotated[int, PropertyInfo(alias="maxShippingPrice")]
 
     max_total_price: Annotated[int, PropertyInfo(alias="maxTotalPrice")]
+
+    offer_retrieval_effort: Annotated[Literal["max", "low"], PropertyInfo(alias="offerRetrievalEffort")]
+    """Controls how much effort the system should spend retrieving an offer.
+
+    - 'max': Full effort including AI agent fallback (slower, higher success rate)
+    - 'low': Fast API-only retrieval, fails if API unavailable (faster, lower
+      success rate)
+
+    Default: 'max'
+    """

{checkout_intents-0.11.0 → checkout_intents-0.12.0}/src/checkout_intents/types/checkout_intent_purchase_params.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 
 from typing import Iterable
-from typing_extensions import Required, Annotated, TypedDict
+from typing_extensions import Literal, Required, Annotated, TypedDict
 
 from .._types import SequenceNotStr
 from .._utils import PropertyInfo
@@ -34,3 +34,13 @@ class Constraints(TypedDict, total=False):
     max_shipping_price: Annotated[int, PropertyInfo(alias="maxShippingPrice")]
 
     max_total_price: Annotated[int, PropertyInfo(alias="maxTotalPrice")]
+
+    offer_retrieval_effort: Annotated[Literal["max", "low"], PropertyInfo(alias="offerRetrievalEffort")]
+    """Controls how much effort the system should spend retrieving an offer.
+
+    - 'max': Full effort including AI agent fallback (slower, higher success rate)
+    - 'low': Fast API-only retrieval, fails if API unavailable (faster, lower
+      success rate)
+
+    Default: 'max'
+    """

{checkout_intents-0.11.0 → checkout_intents-0.12.0}/tests/api_resources/betas/test_checkout_sessions.py

@@ -47,6 +47,7 @@ class TestCheckoutSessions:
             constraints={
                 "max_shipping_price": 500,
                 "max_total_price": 100000,
+                "offer_retrieval_effort": "max",
             },
             promo_codes=["string"],
             variant_selections=[
@@ -122,6 +123,7 @@ class TestAsyncCheckoutSessions:
             constraints={
                 "max_shipping_price": 500,
                 "max_total_price": 100000,
+                "offer_retrieval_effort": "max",
             },
             promo_codes=["string"],
             variant_selections=[

{checkout_intents-0.11.0 → checkout_intents-0.12.0}/tests/api_resources/test_checkout_intents.py

@@ -61,6 +61,7 @@ class TestCheckoutIntents:
             constraints={
                 "max_shipping_price": 500,
                 "max_total_price": 100000,
+                "offer_retrieval_effort": "max",
             },
             promo_codes=["sqF12lZ1VlBb"],
             variant_selections=[
@@ -393,6 +394,7 @@ class TestCheckoutIntents:
             constraints={
                 "max_shipping_price": 500,
                 "max_total_price": 100000,
+                "offer_retrieval_effort": "max",
             },
             promo_codes=["sqF12lZ1VlBb"],
             variant_selections=[
@@ -509,6 +511,7 @@ class TestAsyncCheckoutIntents:
             constraints={
                 "max_shipping_price": 500,
                 "max_total_price": 100000,
+                "offer_retrieval_effort": "max",
             },
             promo_codes=["sqF12lZ1VlBb"],
             variant_selections=[
@@ -841,6 +844,7 @@ class TestAsyncCheckoutIntents:
             constraints={
                 "max_shipping_price": 500,
                 "max_total_price": 100000,
+                "offer_retrieval_effort": "max",
             },
             promo_codes=["sqF12lZ1VlBb"],
             variant_selections=[

{checkout_intents-0.11.0 → checkout_intents-0.12.0}/tests/test_client.py

@@ -685,6 +685,37 @@ class TestCheckoutIntents:
         assert isinstance(response, Model)
         assert response.foo == 2
 
+    @pytest.mark.respx(base_url=base_url)
+    def test_idempotency_header_options(self, respx_mock: MockRouter, client: CheckoutIntents) -> None:
+        respx_mock.post("/foo").mock(return_value=httpx.Response(200, json={}))
+
+        response = client.post("/foo", cast_to=httpx.Response)
+
+        header = response.request.headers.get("Idempotency-Key")
+        assert header is not None
+        assert header.startswith("stainless-python-retry")
+
+        # explicit header
+        response = client.post(
+            "/foo",
+            cast_to=httpx.Response,
+            options=make_request_options(extra_headers={"Idempotency-Key": "custom-key"}),
+        )
+        assert response.request.headers.get("Idempotency-Key") == "custom-key"
+
+        response = client.post(
+            "/foo",
+            cast_to=httpx.Response,
+            options=make_request_options(extra_headers={"idempotency-key": "custom-key"}),
+        )
+        assert response.request.headers.get("Idempotency-Key") == "custom-key"
+
+        # custom argument
+        response = client.post(
+            "/foo", cast_to=httpx.Response, options=make_request_options(idempotency_key="custom-key")
+        )
+        assert response.request.headers.get("Idempotency-Key") == "custom-key"
+
     def test_base_url_setter(self) -> None:
         client = CheckoutIntents(
             base_url="https://example.com/from_init", api_key=api_key, _strict_response_validation=True
@@ -1668,6 +1699,37 @@ class TestAsyncCheckoutIntents:
         assert isinstance(response, Model)
         assert response.foo == 2
 
+    @pytest.mark.respx(base_url=base_url)
+    async def test_idempotency_header_options(self, respx_mock: MockRouter, async_client: AsyncCheckoutIntents) -> None:
+        respx_mock.post("/foo").mock(return_value=httpx.Response(200, json={}))
+
+        response = await async_client.post("/foo", cast_to=httpx.Response)
+
+        header = response.request.headers.get("Idempotency-Key")
+        assert header is not None
+        assert header.startswith("stainless-python-retry")
+
+        # explicit header
+        response = await async_client.post(
+            "/foo",
+            cast_to=httpx.Response,
+            options=make_request_options(extra_headers={"Idempotency-Key": "custom-key"}),
+        )
+        assert response.request.headers.get("Idempotency-Key") == "custom-key"
+
+        response = await async_client.post(
+            "/foo",
+            cast_to=httpx.Response,
+            options=make_request_options(extra_headers={"idempotency-key": "custom-key"}),
+        )
+        assert response.request.headers.get("Idempotency-Key") == "custom-key"
+
+        # custom argument
+        response = await async_client.post(
+            "/foo", cast_to=httpx.Response, options=make_request_options(idempotency_key="custom-key")
+        )
+        assert response.request.headers.get("Idempotency-Key") == "custom-key"
+
     async def test_base_url_setter(self) -> None:
         client = AsyncCheckoutIntents(
             base_url="https://example.com/from_init", api_key=api_key, _strict_response_validation=True

checkout_intents-0.11.0/.release-please-manifest.json

@@ -1,3 +0,0 @@
-{
-  ".": "0.11.0"
-}