checkout-intents 0.11.0__py3-none-any.whl → 0.13.0__py3-none-any.whl

checkout_intents/_base_client.py

@@ -86,6 +86,7 @@ from ._exceptions import (
     APIConnectionError,
     APIResponseValidationError,
 )
+from ._utils._json import openapi_dumps
 
 log: logging.Logger = logging.getLogger(__name__)
 
@@ -554,8 +555,10 @@ class BaseClient(Generic[_HttpxClientT, _DefaultStreamT]):
                 kwargs["content"] = options.content
             elif isinstance(json_data, bytes):
                 kwargs["content"] = json_data
-            else:
-                kwargs["json"] = json_data if is_given(json_data) else None
+            elif not files:
+                # Don't set content when JSON is sent as multipart/form-data,
+                # since httpx's content param overrides other body arguments
+                kwargs["content"] = openapi_dumps(json_data) if is_given(json_data) and json_data is not None else None
             kwargs["files"] = files
         else:
             headers.pop("Content-Type", None)

checkout_intents/_client.py

@@ -31,8 +31,9 @@ from ._base_client import (
 )
 
 if TYPE_CHECKING:
-    from .resources import betas, brands, checkout_intents
+    from .resources import betas, brands, products, checkout_intents
     from .resources.brands import BrandsResource, AsyncBrandsResource
+    from .resources.products import ProductsResource, AsyncProductsResource
     from .resources.betas.betas import BetasResource, AsyncBetasResource
     from .resources.checkout_intents import CheckoutIntentsResource, AsyncCheckoutIntentsResource
 
@@ -167,6 +168,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
@@ -185,6 +188,12 @@ class CheckoutIntents(SyncAPIClient):
 
         return BrandsResource(self)
 
+    @cached_property
+    def products(self) -> ProductsResource:
+        from .resources.products import ProductsResource
+
+        return ProductsResource(self)
+
     @cached_property
     def with_raw_response(self) -> CheckoutIntentsWithRawResponse:
         return CheckoutIntentsWithRawResponse(self)
@@ -396,6 +405,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
@@ -414,6 +425,12 @@ class AsyncCheckoutIntents(AsyncAPIClient):
 
         return AsyncBrandsResource(self)
 
+    @cached_property
+    def products(self) -> AsyncProductsResource:
+        from .resources.products import AsyncProductsResource
+
+        return AsyncProductsResource(self)
+
     @cached_property
     def with_raw_response(self) -> AsyncCheckoutIntentsWithRawResponse:
         return AsyncCheckoutIntentsWithRawResponse(self)
@@ -553,6 +570,12 @@ class CheckoutIntentsWithRawResponse:
 
         return BrandsResourceWithRawResponse(self._client.brands)
 
+    @cached_property
+    def products(self) -> products.ProductsResourceWithRawResponse:
+        from .resources.products import ProductsResourceWithRawResponse
+
+        return ProductsResourceWithRawResponse(self._client.products)
+
 
 class AsyncCheckoutIntentsWithRawResponse:
     _client: AsyncCheckoutIntents
@@ -578,6 +601,12 @@ class AsyncCheckoutIntentsWithRawResponse:
 
         return AsyncBrandsResourceWithRawResponse(self._client.brands)
 
+    @cached_property
+    def products(self) -> products.AsyncProductsResourceWithRawResponse:
+        from .resources.products import AsyncProductsResourceWithRawResponse
+
+        return AsyncProductsResourceWithRawResponse(self._client.products)
+
 
 class CheckoutIntentsWithStreamedResponse:
     _client: CheckoutIntents
@@ -603,6 +632,12 @@ class CheckoutIntentsWithStreamedResponse:
 
         return BrandsResourceWithStreamingResponse(self._client.brands)
 
+    @cached_property
+    def products(self) -> products.ProductsResourceWithStreamingResponse:
+        from .resources.products import ProductsResourceWithStreamingResponse
+
+        return ProductsResourceWithStreamingResponse(self._client.products)
+
 
 class AsyncCheckoutIntentsWithStreamedResponse:
     _client: AsyncCheckoutIntents
@@ -628,6 +663,12 @@ class AsyncCheckoutIntentsWithStreamedResponse:
 
         return AsyncBrandsResourceWithStreamingResponse(self._client.brands)
 
+    @cached_property
+    def products(self) -> products.AsyncProductsResourceWithStreamingResponse:
+        from .resources.products import AsyncProductsResourceWithStreamingResponse
+
+        return AsyncProductsResourceWithStreamingResponse(self._client.products)
+
 
 Client = CheckoutIntents
 

checkout_intents/_compat.py

@@ -139,6 +139,7 @@ def model_dump(
     exclude_defaults: bool = False,
     warnings: bool = True,
     mode: Literal["json", "python"] = "python",
+    by_alias: bool | None = None,
 ) -> dict[str, Any]:
     if (not PYDANTIC_V1) or hasattr(model, "model_dump"):
         return model.model_dump(
@@ -148,13 +149,12 @@ def model_dump(
             exclude_defaults=exclude_defaults,
             # warnings are not supported in Pydantic v1
             warnings=True if PYDANTIC_V1 else warnings,
+            by_alias=by_alias,
         )
     return cast(
         "dict[str, Any]",
         model.dict(  # pyright: ignore[reportDeprecated, reportUnnecessaryCast]
-            exclude=exclude,
-            exclude_unset=exclude_unset,
-            exclude_defaults=exclude_defaults,
+            exclude=exclude, exclude_unset=exclude_unset, exclude_defaults=exclude_defaults, by_alias=bool(by_alias)
         ),
     )
 

checkout_intents/_utils/_json.py

@@ -0,0 +1,35 @@
+import json
+from typing import Any
+from datetime import datetime
+from typing_extensions import override
+
+import pydantic
+
+from .._compat import model_dump
+
+
+def openapi_dumps(obj: Any) -> bytes:
+    """
+    Serialize an object to UTF-8 encoded JSON bytes.
+
+    Extends the standard json.dumps with support for additional types
+    commonly used in the SDK, such as `datetime`, `pydantic.BaseModel`, etc.
+    """
+    return json.dumps(
+        obj,
+        cls=_CustomEncoder,
+        # Uses the same defaults as httpx's JSON serialization
+        ensure_ascii=False,
+        separators=(",", ":"),
+        allow_nan=False,
+    ).encode()
+
+
+class _CustomEncoder(json.JSONEncoder):
+    @override
+    def default(self, o: Any) -> Any:
+        if isinstance(o, datetime):
+            return o.isoformat()
+        if isinstance(o, pydantic.BaseModel):
+            return model_dump(o, exclude_unset=True, mode="json", by_alias=True)
+        return super().default(o)

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.13.0"  # x-release-please-version

checkout_intents/resources/__init__.py

@@ -16,6 +16,14 @@ from .brands import (
     BrandsResourceWithStreamingResponse,
     AsyncBrandsResourceWithStreamingResponse,
 )
+from .products import (
+    ProductsResource,
+    AsyncProductsResource,
+    ProductsResourceWithRawResponse,
+    AsyncProductsResourceWithRawResponse,
+    ProductsResourceWithStreamingResponse,
+    AsyncProductsResourceWithStreamingResponse,
+)
 from .checkout_intents import (
     CheckoutIntentsResource,
     AsyncCheckoutIntentsResource,
@@ -44,4 +52,10 @@ __all__ = [
     "AsyncBrandsResourceWithRawResponse",
     "BrandsResourceWithStreamingResponse",
     "AsyncBrandsResourceWithStreamingResponse",
+    "ProductsResource",
+    "AsyncProductsResource",
+    "ProductsResourceWithRawResponse",
+    "AsyncProductsResourceWithRawResponse",
+    "ProductsResourceWithStreamingResponse",
+    "AsyncProductsResourceWithStreamingResponse",
 ]

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/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/resources/products.py

@@ -0,0 +1,169 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+import httpx
+
+from ..types import product_lookup_params
+from .._types import Body, Query, Headers, NotGiven, not_given
+from .._utils import maybe_transform, async_maybe_transform
+from .._compat import cached_property
+from .._resource import SyncAPIResource, AsyncAPIResource
+from .._response import (
+    to_raw_response_wrapper,
+    to_streamed_response_wrapper,
+    async_to_raw_response_wrapper,
+    async_to_streamed_response_wrapper,
+)
+from .._base_client import make_request_options
+from ..types.product import Product
+
+__all__ = ["ProductsResource", "AsyncProductsResource"]
+
+
+class ProductsResource(SyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> ProductsResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/rye-com/checkout-intents-python#accessing-raw-response-data-eg-headers
+        """
+        return ProductsResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> ProductsResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/rye-com/checkout-intents-python#with_streaming_response
+        """
+        return ProductsResourceWithStreamingResponse(self)
+
+    def lookup(
+        self,
+        *,
+        url: str,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> Product:
+        """
+        Retrieve a product's information by URL.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return self._get(
+            "/api/v1/products/lookup",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform({"url": url}, product_lookup_params.ProductLookupParams),
+            ),
+            cast_to=Product,
+        )
+
+
+class AsyncProductsResource(AsyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> AsyncProductsResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/rye-com/checkout-intents-python#accessing-raw-response-data-eg-headers
+        """
+        return AsyncProductsResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncProductsResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/rye-com/checkout-intents-python#with_streaming_response
+        """
+        return AsyncProductsResourceWithStreamingResponse(self)
+
+    async def lookup(
+        self,
+        *,
+        url: str,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> Product:
+        """
+        Retrieve a product's information by URL.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return await self._get(
+            "/api/v1/products/lookup",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=await async_maybe_transform({"url": url}, product_lookup_params.ProductLookupParams),
+            ),
+            cast_to=Product,
+        )
+
+
+class ProductsResourceWithRawResponse:
+    def __init__(self, products: ProductsResource) -> None:
+        self._products = products
+
+        self.lookup = to_raw_response_wrapper(
+            products.lookup,
+        )
+
+
+class AsyncProductsResourceWithRawResponse:
+    def __init__(self, products: AsyncProductsResource) -> None:
+        self._products = products
+
+        self.lookup = async_to_raw_response_wrapper(
+            products.lookup,
+        )
+
+
+class ProductsResourceWithStreamingResponse:
+    def __init__(self, products: ProductsResource) -> None:
+        self._products = products
+
+        self.lookup = to_streamed_response_wrapper(
+            products.lookup,
+        )
+
+
+class AsyncProductsResourceWithStreamingResponse:
+    def __init__(self, products: AsyncProductsResource) -> None:
+        self._products = products
+
+        self.lookup = async_to_streamed_response_wrapper(
+            products.lookup,
+        )

checkout_intents/types/__init__.py

@@ -5,13 +5,17 @@ from __future__ import annotations
 from .buyer import Buyer as Buyer
 from .money import Money as Money
 from .offer import Offer as Offer
+from .product import Product as Product
 from .buyer_param import BuyerParam as BuyerParam
+from .product_image import ProductImage as ProductImage
 from .payment_method import PaymentMethod as PaymentMethod
 from .checkout_intent import CheckoutIntent as CheckoutIntent
 from .checkout_session import CheckoutSession as CheckoutSession
 from .variant_selection import VariantSelection as VariantSelection
 from .base_checkout_intent import BaseCheckoutIntent as BaseCheckoutIntent
 from .payment_method_param import PaymentMethodParam as PaymentMethodParam
+from .product_availability import ProductAvailability as ProductAvailability
+from .product_lookup_params import ProductLookupParams as ProductLookupParams
 from .brand_retrieve_response import BrandRetrieveResponse as BrandRetrieveResponse
 from .variant_selection_param import VariantSelectionParam as VariantSelectionParam
 from .checkout_intent_list_params import CheckoutIntentListParams as CheckoutIntentListParams

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/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/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/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/types/money.py

@@ -8,6 +8,6 @@ __all__ = ["Money"]
 
 
 class Money(BaseModel):
-    amount_subunits: float = FieldInfo(alias="amountSubunits")
+    amount_subunits: int = FieldInfo(alias="amountSubunits")
 
     currency_code: str = FieldInfo(alias="currencyCode")

checkout_intents/types/product.py

@@ -0,0 +1,38 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+
+from .money import Money
+from .._models import BaseModel
+from .product_image import ProductImage
+from .product_availability import ProductAvailability
+
+__all__ = ["Product"]
+
+
+class Product(BaseModel):
+    id: str
+
+    availability: ProductAvailability
+    """The availability status of a product.
+
+    - `in_stock`: Product is available for immediate purchase
+    - `out_of_stock`: Product is currently unavailable
+    - `preorder`: Product is available for pre-order before release
+    - `backorder`: Product is temporarily out of stock but can be ordered
+    - `unknown`: Availability could not be determined
+    """
+
+    brand: Optional[str] = None
+
+    description: Optional[str] = None
+
+    images: List[ProductImage]
+
+    name: str
+
+    price: Money
+
+    sku: Optional[str] = None
+
+    url: str

checkout_intents/types/product_availability.py

@@ -0,0 +1,7 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing_extensions import Literal, TypeAlias
+
+__all__ = ["ProductAvailability"]
+
+ProductAvailability: TypeAlias = Literal["in_stock", "out_of_stock", "preorder", "backorder", "unknown"]

checkout_intents/types/product_image.py

@@ -0,0 +1,13 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from pydantic import Field as FieldInfo
+
+from .._models import BaseModel
+
+__all__ = ["ProductImage"]
+
+
+class ProductImage(BaseModel):
+    is_featured: bool = FieldInfo(alias="isFeatured")
+
+    url: str

checkout_intents/types/product_lookup_params.py

@@ -0,0 +1,11 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, TypedDict
+
+__all__ = ["ProductLookupParams"]
+
+
+class ProductLookupParams(TypedDict, total=False):
+    url: Required[str]

{checkout_intents-0.11.0.dist-info → checkout_intents-0.13.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: checkout-intents
-Version: 0.11.0
+Version: 0.13.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.dist-info → checkout_intents-0.13.0.dist-info}/RECORD

@@ -1,7 +1,7 @@
 checkout_intents/__init__.py,sha256=5m0_Ktnyya4CJ0vdWZbAv7qZMeR1VnXqN_MJtH3RJTM,2833
-checkout_intents/_base_client.py,sha256=Y7hFug5-aMslho0bjwHHlk_gCxYhwuceCHEib1ByJxU,73419
-checkout_intents/_client.py,sha256=tClhspFXBkudspX5xGUhIy8MnG2caIt_5svkHi0qhCk,25244
-checkout_intents/_compat.py,sha256=DQBVORjFb33zch24jzkhM14msvnzY7mmSmgDLaVFUM8,6562
+checkout_intents/_base_client.py,sha256=erZOquhcv6qskhIcqEJ2mLowvp4htuOuVBjTH4d2qlk,73668
+checkout_intents/_client.py,sha256=SYYqLrhVffl0ellLIcJ602vNYYeYCbbN31mhH9IcdYs,26775
+checkout_intents/_compat.py,sha256=teO44AYozpv2wFRrUi7brcZfGPpFSERQZ4fcdX6zVvs,6627
 checkout_intents/_constants.py,sha256=S14PFzyN9-I31wiV7SmIlL5Ga0MLHxdvegInGdXH7tM,462
 checkout_intents/_exceptions.py,sha256=oQn7Y6LzccgRDOtdg20l68bXtgf2tgVNKIrufJPDsuk,4252
 checkout_intents/_files.py,sha256=KnEzGi_O756MvKyJ4fOCW_u3JhOeWPQ4RsmDvqihDQU,3545
@@ -11,12 +11,13 @@ checkout_intents/_resource.py,sha256=X-eWffEBAgzTZvakLqNUjwgidMKfBFRmCeeOiuko4lg
 checkout_intents/_response.py,sha256=sLqxWBxzmVqPsdr2x5z6d87h8jb1U-Huvh2YFg-U6nE,28876
 checkout_intents/_streaming.py,sha256=y8SjBVAw2SDdVczQsP1T3dufnx4040C5fQqz-jGSvmg,10257
 checkout_intents/_types.py,sha256=8crq0wrqM8FR-GJ-nXMwjLlp0QEjfJT5H01fve7mjs4,7604
-checkout_intents/_version.py,sha256=oH4MSe6tCtyuBhXFqKM_xSWWc763yD4crOrrZ6szjVc,169
+checkout_intents/_version.py,sha256=G9j4scvWEIXHxS3dIVTif_uRyTGHH9Pv4T7unuYbjNI,169
 checkout_intents/pagination.py,sha256=VMe3ftq-qqAku2ERRTOz7iZOoMQ_KKp2HIUl_I8oAXE,2908
 checkout_intents/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 checkout_intents/_utils/__init__.py,sha256=7fch0GT9zpNnErbciSpUNa-SjTxxjY6kxHxKMOM4AGs,2305
 checkout_intents/_utils/_compat.py,sha256=rN17SSvjMoQE1GmKFTLniRuG1sKj2WAD5VjdLPeRlF0,1231
 checkout_intents/_utils/_datetime_parse.py,sha256=bABTs0Bc6rabdFvnIwXjEhWL15TcRgWZ_6XGTqN8xUk,4204
+checkout_intents/_utils/_json.py,sha256=bl95uuIWwgSfXX-gP1trK_lDAPwJujYfJ05Cxo2SEC4,962
 checkout_intents/_utils/_logs.py,sha256=dw1slZVPfWp0Z_jBGEQvr8TDY0uu3V7pJuexM_MG4pk,804
 checkout_intents/_utils/_proxy.py,sha256=aglnj2yBTDyGX9Akk2crZHrl10oqRmceUy2Zp008XEs,1975
 checkout_intents/_utils/_reflection.py,sha256=ZmGkIgT_PuwedyNBrrKGbxoWtkpytJNU1uU4QHnmEMU,1364
@@ -27,33 +28,38 @@ checkout_intents/_utils/_transform.py,sha256=NjCzmnfqYrsAikUHQig6N9QfuTVbKipuP3u
 checkout_intents/_utils/_typing.py,sha256=N_5PPuFNsaygbtA_npZd98SVN1LQQvFTKL6bkWPBZGU,4786
 checkout_intents/_utils/_utils.py,sha256=g9ftElB09kVT6EVfCIlD_nUfANhDX5_vZO61FDWoIQI,12334
 checkout_intents/lib/.keep,sha256=wuNrz-5SXo3jJaJOJgz4vFHM41YH_g20F5cRQo0vLes,224
-checkout_intents/resources/__init__.py,sha256=zjz0ozirEslXBkOUq4FwPABJaLruYwIXS7HZ-0am5S4,1557
+checkout_intents/resources/__init__.py,sha256=TwKGeEBVHB9E7w-my6wFQVhH_KBKL72e8HsEEl1jcbw,2033
 checkout_intents/resources/brands.py,sha256=jJ5Jn2GG3MPkdKSg6_OG89dSQTaSGM9e7lBtovn-ABE,6389
-checkout_intents/resources/checkout_intents.py,sha256=gL9bDh0zexqLhDbae4awEHlxYXm0ztQfhBEcXpJH4DU,60268
+checkout_intents/resources/checkout_intents.py,sha256=c2i_3b3l9LrnWEgL0MRrxVzlRv9mn_8QboLnF_8tiuM,62156
+checkout_intents/resources/products.py,sha256=TO0VzX1JeAdByEIg0hLROzbZKDdBG3yS8JXi5mtSXKI,6029
 checkout_intents/resources/betas/__init__.py,sha256=DQKAlEq_xKd67cDJhihmsFJowbKXwPwZVi6zbGUykfQ,1120
 checkout_intents/resources/betas/betas.py,sha256=48PbcJQb3RFRJ2pbvr7aAR1KYi64bWBQgfxg6KtcqeU,3892
-checkout_intents/resources/betas/checkout_sessions.py,sha256=OT4o41rvVshRjAGY5hUs2E1K7XyvRv4pVEclafgoSCQ,8219
-checkout_intents/types/__init__.py,sha256=VlReDJoTw4Sps0a4Q5Bfm_ePZnfk61wVBNSgDR-rGVc,1363
-checkout_intents/types/base_checkout_intent.py,sha256=CgRzAWjEQXi1G4uCG6nqVXtwdHvT1BMP9UyEAxDZmTE,995
+checkout_intents/resources/betas/checkout_sessions.py,sha256=0Q7IARFC7RUmTPge5HXZb4YY9LCizOX2jCNxsSx7kdI,8659
+checkout_intents/types/__init__.py,sha256=qM17O5mEWQVyJACrKAys5TU4CsUUnSwiiAEt97t2A0w,1614
+checkout_intents/types/base_checkout_intent.py,sha256=pbGjljfrAcC8IwRc6A1ty2M-mdSTfa1_s2ddgy1h2ww,1437
 checkout_intents/types/brand_retrieve_response.py,sha256=c8DCAJvHFHcrIOW6onHj5Y51Yba7zyOrRXZuGfqYkBc,561
 checkout_intents/types/buyer.py,sha256=Ov6mVD-Hjm9A-i9p2dWCXtniLhYpG_6jvy9DReC54YQ,530
 checkout_intents/types/buyer_param.py,sha256=DAtEoK4VSzv2qDBBlC4RRE4FbHd87pieTOlfRntbjqg,695
 checkout_intents/types/checkout_intent.py,sha256=LLTGXwIRdZmxaHRcHAYZ6DPWnZurym2yG0pOfmkQ2eg,2726
 checkout_intents/types/checkout_intent_add_payment_params.py,sha256=s8KKWVM3XainGTLCwdfUjb5vgS80o2_W0wwUwRCFbk0,479
 checkout_intents/types/checkout_intent_confirm_params.py,sha256=v_fcmuH5GoEwUJLbV7N9BDti63dg8z1nmhpcr4-1qcs,473
-checkout_intents/types/checkout_intent_create_params.py,sha256=rS83w5jDs6_6O4204B-YGXTbpH9rkATKLrgV8KwLnKA,1053
+checkout_intents/types/checkout_intent_create_params.py,sha256=oYmkLLToBKcnvzIUEnXOb0K8iPfgCTInkWw8Rs1O4cc,1455
 checkout_intents/types/checkout_intent_list_params.py,sha256=zc8_xwBHChOcl7bTMSjU7ZbHKIyQGYeUy5UrxeloJj0,521
-checkout_intents/types/checkout_intent_purchase_params.py,sha256=TxT3yhTfaJF_vMt6w-oQk3d5fQfN1CtZ18QCiBWY0DU,1208
+checkout_intents/types/checkout_intent_purchase_params.py,sha256=L_NSyWsifBxpZ29zCFBSMqqkHZ1fZQ_q3YnlZH6IlC0,1610
 checkout_intents/types/checkout_session.py,sha256=e1Ay_2GYO9Ybmz53S0Z0o3R4Et5Gm2kiS5wn1y1Ey3g,589
-checkout_intents/types/money.py,sha256=-AfFFrfnUy6cAaFykF_gWZQxDGlzA1r_dJzJZRxhUto,328
+checkout_intents/types/money.py,sha256=tiB3lhLN-bHTkWrEA-11LuXiv-9SvF7WQyiru3mC7bE,326
 checkout_intents/types/offer.py,sha256=9nGYAlA3tEiRU9lvsktnVl6EWj5dLNr6K9LB8WprckI,985
 checkout_intents/types/payment_method.py,sha256=-v5-L5RPojm8IDrdAhIMGmhVb89vwqT1jhgb-ZWOG7Q,1069
 checkout_intents/types/payment_method_param.py,sha256=_yzwZ5nw7bStK4U2-1ybtpjdJz5funCOMN7MALtF0xk,1225
+checkout_intents/types/product.py,sha256=jl8b4yezOyaLeyx7BgVHjPpT2nLSoEYMCm5-r-oKNtg,924
+checkout_intents/types/product_availability.py,sha256=mzfVhS-KSXPgT4367qAEN0S3teGHPkNHQAy4FiA_BCc,277
+checkout_intents/types/product_image.py,sha256=_iN7QsLuq4u3kywPkxLkdCkFFcYD3_n3uLem5NZ_yU4,289
+checkout_intents/types/product_lookup_params.py,sha256=YFd1SWJoHifWr5jvZYT_KymSfFlf2Xc0h08eG5xIyuU,284
 checkout_intents/types/variant_selection.py,sha256=y6mlU-qGwDfE77mU-x1GTXkDsmn6vuPpy5lBYXqXCBw,259
 checkout_intents/types/variant_selection_param.py,sha256=ahwTmDVIUMV8jvpggEo2jDUTIm9xvXbntDxmIZqT2_k,355
 checkout_intents/types/betas/__init__.py,sha256=ZeKE1oI6DbXReHgxvn2kIS3G3_k8MH8a-o22ONpi5dc,226
-checkout_intents/types/betas/checkout_session_create_params.py,sha256=tfxZQyVfwqfwihaJDT2y9bl_6x867up072g_rtsjeqs,1602
-checkout_intents-0.11.0.dist-info/METADATA,sha256=Uz6DACSypO-jn15rWeRJeMOghBfFrPsucDYr5DTBDIs,24302
-checkout_intents-0.11.0.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
-checkout_intents-0.11.0.dist-info/licenses/LICENSE,sha256=BnK3I8R5OpT_XsQObbpssF9h8-B0aZaerlZjRgSPNpU,1056
-checkout_intents-0.11.0.dist-info/RECORD,,
+checkout_intents/types/betas/checkout_session_create_params.py,sha256=TdxIvwfNSJ2QX28ugqgTscIwTSBhsp_YrUj8xCYVfMY,2004
+checkout_intents-0.13.0.dist-info/METADATA,sha256=X8AJF7WVAsu0pj_cjUGnbddYPA6nlx_InOcQC_mp3bw,24302
+checkout_intents-0.13.0.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
+checkout_intents-0.13.0.dist-info/licenses/LICENSE,sha256=BnK3I8R5OpT_XsQObbpssF9h8-B0aZaerlZjRgSPNpU,1056
+checkout_intents-0.13.0.dist-info/RECORD,,