checkout-intents 0.2.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7d8d5a1ddee326274b3bf70f1984a643b09a03d67b92f5a2ae000ca6a82e538d
-  data.tar.gz: 85113215243021df5e95cf03ec0a7b77c471c653ff88e5b2bb4d300b980554de
+  metadata.gz: bda63c599b8cd83771abe42c287a04c4ad82c5d4f0786fd3709de9c5170845b6
+  data.tar.gz: 7b984e686cc00fb3ab287cc07ae8dec14c3f9ff6a56210d7638e0952691b2c4c
 SHA512:
-  metadata.gz: 7dc143a24721befccedb01f1c4449d02c23966b325bfbac050dda2fe238a1cf655472ba98216024d8e6bac18c78493f68e4145aef435675a46fbe7ee665c8914
-  data.tar.gz: a9f2fdfc3c4e44176ad6fa2fe41050c3919693ca31a0d75d90f3adccc8e49e3e5e8554ecde12295b3c91907d664427a5806f693dd14a5427ebd915b1daeb6f52
+  metadata.gz: ac453b93ad2940abf04156c8f80111558b0dc4fa9caeb64a52e97a721c057519b3c5bb6a61fca0ef5d58dd3f65c1fb00e25e0f03447d83c5245fca24e54886d9
+  data.tar.gz: 3f70463b0132c2c69e35b20ff4a8488d51afafc9c439dd01c91238f24f9cd904b032e4f834e81b38cce83c6dfaf85aa36846cd2586ec3ca74735e2c93356570e

data/CHANGELOG.md

@@ -1,5 +1,38 @@
 # Changelog
 
+## 0.3.0 (2026-01-30)
+
+Full Changelog: [v0.2.2...v0.3.0](https://github.com/rye-com/checkout-intents-ruby/compare/v0.2.2...v0.3.0)
+
+### Features
+
+* add support for idempotency for v2 api ([b94de41](https://github.com/rye-com/checkout-intents-ruby/commit/b94de413ad3cfd4a5a552d2719203f060414d228))
+* **api:** introduce lookup product data endpoint ([f4edc38](https://github.com/rye-com/checkout-intents-ruby/commit/f4edc38289d432cbc3f87497274c0798bd88b7ee))
+* **api:** introduce offerRetrievalEffort constraint ([0d38c14](https://github.com/rye-com/checkout-intents-ruby/commit/0d38c1491c570ae1c8164ed001eb803d600d8bf1))
+* Implement shipping profile -> shipping option calculation ([eb0fa3a](https://github.com/rye-com/checkout-intents-ruby/commit/eb0fa3a0c180fbbc616032f02bb303a154d41cb0))
+
+
+### Bug Fixes
+
+* **internal:** transformer script to fix references ([8481675](https://github.com/rye-com/checkout-intents-ruby/commit/8481675e295bbfa698b9edb93af9d2c99cd840db))
+
+
+### Chores
+
+* **internal:** add format step in ci ([ad0d359](https://github.com/rye-com/checkout-intents-ruby/commit/ad0d3594d6b4f92df889e645434dbc5310802216))
+* **internal:** format and fix absolute references ([2509f6a](https://github.com/rye-com/checkout-intents-ruby/commit/2509f6af145d3b586fbbde14e94697975d15653c))
+* **internal:** format and fix absolute references ([09920e1](https://github.com/rye-com/checkout-intents-ruby/commit/09920e1eef0dc90eb8a0999d9fbcce0b0e12de72))
+* **internal:** rename `Product` type ([fdadda4](https://github.com/rye-com/checkout-intents-ruby/commit/fdadda4eefc867d5492376e23b25138c263c0811))
+* **internal:** update `actions/checkout` version ([00c3bfa](https://github.com/rye-com/checkout-intents-ruby/commit/00c3bfa75b4fd0d01e040070e37a4e72396ea230))
+
+## 0.2.2 (2026-01-15)
+
+Full Changelog: [v0.2.1...v0.2.2](https://github.com/rye-com/checkout-intents-ruby/compare/v0.2.1...v0.2.2)
+
+### Bug Fixes
+
+* **api:** correctly type quantity as integer ([a85ecbf](https://github.com/rye-com/checkout-intents-ruby/commit/a85ecbf160c0cc4b24dc62357aa5bf47e7f7932a))
+
 ## 0.2.1 (2026-01-13)
 
 Full Changelog: [v0.2.0...v0.2.1](https://github.com/rye-com/checkout-intents-ruby/compare/v0.2.0...v0.2.1)

data/README.md

@@ -17,7 +17,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "checkout-intents", "~> 0.2.1"
+gem "checkout-intents", "~> 0.3.0"
 ```
 
 <!-- x-release-please-end -->
@@ -422,6 +422,32 @@ params = CheckoutIntents::CheckoutIntentPurchaseParams.new(
 checkout_intents.checkout_intents.purchase(**params)
 ```
 
+### Enums
+
+Since this library does not depend on `sorbet-runtime`, it cannot provide [`T::Enum`](https://sorbet.org/docs/tenum) instances. Instead, we provide "tagged symbols" instead, which is always a primitive at runtime:
+
+```ruby
+# :in_stock
+puts(CheckoutIntents::ProductAvailability::IN_STOCK)
+
+# Revealed type: `T.all(CheckoutIntents::ProductAvailability, Symbol)`
+T.reveal_type(CheckoutIntents::ProductAvailability::IN_STOCK)
+```
+
+Enum parameters have a "relaxed" type, so you can either pass in enum constants or their literal value:
+
+```ruby
+CheckoutIntents::Product.new(
+  availability: CheckoutIntents::ProductAvailability::IN_STOCK,
+  # …
+)
+
+CheckoutIntents::Product.new(
+  availability: :in_stock,
+  # …
+)
+```
+
 ## Versioning
 
 This package follows [SemVer](https://semver.org/spec/v2.0.0.html) conventions. As the library is in initial development and has a major version of `0`, APIs may change at any time.

data/lib/checkout_intents/client.rb

@@ -33,6 +33,9 @@ module CheckoutIntents
     # @return [CheckoutIntents::Resources::Brands]
     attr_reader :brands
 
+    # @return [CheckoutIntents::Resources::Products]
+    attr_reader :products
+
     # @api private
     #
     # @return [Hash{String=>String}]
@@ -77,6 +80,8 @@ module CheckoutIntents
     # @param initial_retry_delay [Float]
     #
     # @param max_retry_delay [Float]
+    #
+    # @param idempotency_header [String]
     def initialize(
       api_key: ENV["CHECKOUT_INTENTS_API_KEY"],
       environment: nil,
@@ -84,7 +89,8 @@ module CheckoutIntents
       max_retries: self.class::DEFAULT_MAX_RETRIES,
       timeout: self.class::DEFAULT_TIMEOUT_IN_SECONDS,
       initial_retry_delay: self.class::DEFAULT_INITIAL_RETRY_DELAY,
-      max_retry_delay: self.class::DEFAULT_MAX_RETRY_DELAY
+      max_retry_delay: self.class::DEFAULT_MAX_RETRY_DELAY,
+      idempotency_header: "Idempotency-Key"
     )
       if api_key.nil?
         raise ArgumentError.new("api_key is required, and can be set via environ: \"CHECKOUT_INTENTS_API_KEY\"")
@@ -118,12 +124,14 @@ module CheckoutIntents
         timeout: timeout,
         max_retries: max_retries,
         initial_retry_delay: initial_retry_delay,
-        max_retry_delay: max_retry_delay
+        max_retry_delay: max_retry_delay,
+        idempotency_header: idempotency_header
       )
 
       @checkout_intents = CheckoutIntents::Resources::CheckoutIntents.new(client: self)
       @betas = CheckoutIntents::Resources::Betas.new(client: self)
       @brands = CheckoutIntents::Resources::Brands.new(client: self)
+      @products = CheckoutIntents::Resources::Products.new(client: self)
     end
   end
 end

data/lib/checkout_intents/internal/type/enum.rb

@@ -15,6 +15,31 @@ module CheckoutIntents
       #
       # We can therefore convert string values to Symbols, but can't convert other
       # values safely.
+      #
+      # @example
+      #   # `product_availability` is a `CheckoutIntents::ProductAvailability`
+      #   case product_availability
+      #   when CheckoutIntents::ProductAvailability::IN_STOCK
+      #     # ...
+      #   when CheckoutIntents::ProductAvailability::OUT_OF_STOCK
+      #     # ...
+      #   when CheckoutIntents::ProductAvailability::PREORDER
+      #     # ...
+      #   else
+      #     puts(product_availability)
+      #   end
+      #
+      # @example
+      #   case product_availability
+      #   in :in_stock
+      #     # ...
+      #   in :out_of_stock
+      #     # ...
+      #   in :preorder
+      #     # ...
+      #   else
+      #     puts(product_availability)
+      #   end
       module Enum
         include CheckoutIntents::Internal::Type::Converter
         include CheckoutIntents::Internal::Util::SorbetRuntimeSupport

data/lib/checkout_intents/models/base_checkout_intent.rb

@@ -67,9 +67,48 @@ module CheckoutIntents
         #   @return [Integer, nil]
         optional :max_total_price, Integer, api_name: :maxTotalPrice
 
-        # @!method initialize(max_shipping_price: nil, max_total_price: nil)
+        # @!attribute offer_retrieval_effort
+        #   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'
+        #
+        #   @return [Symbol, CheckoutIntents::Models::BaseCheckoutIntent::Constraints::OfferRetrievalEffort, nil]
+        optional :offer_retrieval_effort,
+                 enum: -> { CheckoutIntents::BaseCheckoutIntent::Constraints::OfferRetrievalEffort },
+                 api_name: :offerRetrievalEffort
+
+        # @!method initialize(max_shipping_price: nil, max_total_price: nil, offer_retrieval_effort: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {CheckoutIntents::Models::BaseCheckoutIntent::Constraints} for more details.
+        #
         #   @param max_shipping_price [Integer]
+        #
         #   @param max_total_price [Integer]
+        #
+        #   @param offer_retrieval_effort [Symbol, CheckoutIntents::Models::BaseCheckoutIntent::Constraints::OfferRetrievalEffort] Controls how much effort the system should spend retrieving an offer.
+
+        # 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'
+        #
+        # @see CheckoutIntents::Models::BaseCheckoutIntent::Constraints#offer_retrieval_effort
+        module OfferRetrievalEffort
+          extend CheckoutIntents::Internal::Type::Enum
+
+          MAX = :max
+          LOW = :low
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
       end
     end
   end

data/lib/checkout_intents/models/betas/checkout_session_create_params.rb

@@ -138,9 +138,51 @@ module CheckoutIntents
           #   @return [Integer, nil]
           optional :max_total_price, Integer, api_name: :maxTotalPrice
 
-          # @!method initialize(max_shipping_price: nil, max_total_price: nil)
+          # @!attribute offer_retrieval_effort
+          #   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'
+          #
+          #   @return [Symbol, CheckoutIntents::Models::Betas::CheckoutSessionCreateParams::Constraints::OfferRetrievalEffort, nil]
+          optional :offer_retrieval_effort,
+                   enum: -> {
+                     CheckoutIntents::Betas::CheckoutSessionCreateParams::Constraints::OfferRetrievalEffort
+                   },
+                   api_name: :offerRetrievalEffort
+
+          # @!method initialize(max_shipping_price: nil, max_total_price: nil, offer_retrieval_effort: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {CheckoutIntents::Models::Betas::CheckoutSessionCreateParams::Constraints} for
+          #   more details.
+          #
           #   @param max_shipping_price [Integer]
+          #
           #   @param max_total_price [Integer]
+          #
+          #   @param offer_retrieval_effort [Symbol, CheckoutIntents::Models::Betas::CheckoutSessionCreateParams::Constraints::OfferRetrievalEffort] Controls how much effort the system should spend retrieving an offer.
+
+          # 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'
+          #
+          # @see CheckoutIntents::Models::Betas::CheckoutSessionCreateParams::Constraints#offer_retrieval_effort
+          module OfferRetrievalEffort
+            extend CheckoutIntents::Internal::Type::Enum
+
+            MAX = :max
+            LOW = :low
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
         end
       end
     end

data/lib/checkout_intents/models/checkout_intent_create_params.rb

@@ -59,9 +59,49 @@ module CheckoutIntents
         #   @return [Integer, nil]
         optional :max_total_price, Integer, api_name: :maxTotalPrice
 
-        # @!method initialize(max_shipping_price: nil, max_total_price: nil)
+        # @!attribute offer_retrieval_effort
+        #   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'
+        #
+        #   @return [Symbol, CheckoutIntents::Models::CheckoutIntentCreateParams::Constraints::OfferRetrievalEffort, nil]
+        optional :offer_retrieval_effort,
+                 enum: -> { CheckoutIntents::CheckoutIntentCreateParams::Constraints::OfferRetrievalEffort },
+                 api_name: :offerRetrievalEffort
+
+        # @!method initialize(max_shipping_price: nil, max_total_price: nil, offer_retrieval_effort: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {CheckoutIntents::Models::CheckoutIntentCreateParams::Constraints} for more
+        #   details.
+        #
         #   @param max_shipping_price [Integer]
+        #
         #   @param max_total_price [Integer]
+        #
+        #   @param offer_retrieval_effort [Symbol, CheckoutIntents::Models::CheckoutIntentCreateParams::Constraints::OfferRetrievalEffort] Controls how much effort the system should spend retrieving an offer.
+
+        # 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'
+        #
+        # @see CheckoutIntents::Models::CheckoutIntentCreateParams::Constraints#offer_retrieval_effort
+        module OfferRetrievalEffort
+          extend CheckoutIntents::Internal::Type::Enum
+
+          MAX = :max
+          LOW = :low
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
       end
     end
   end

data/lib/checkout_intents/models/checkout_intent_purchase_params.rb

@@ -65,9 +65,51 @@ module CheckoutIntents
         #   @return [Integer, nil]
         optional :max_total_price, Integer, api_name: :maxTotalPrice
 
-        # @!method initialize(max_shipping_price: nil, max_total_price: nil)
+        # @!attribute offer_retrieval_effort
+        #   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'
+        #
+        #   @return [Symbol, CheckoutIntents::Models::CheckoutIntentPurchaseParams::Constraints::OfferRetrievalEffort, nil]
+        optional :offer_retrieval_effort,
+                 enum: -> {
+                   CheckoutIntents::CheckoutIntentPurchaseParams::Constraints::OfferRetrievalEffort
+                 },
+                 api_name: :offerRetrievalEffort
+
+        # @!method initialize(max_shipping_price: nil, max_total_price: nil, offer_retrieval_effort: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {CheckoutIntents::Models::CheckoutIntentPurchaseParams::Constraints} for more
+        #   details.
+        #
         #   @param max_shipping_price [Integer]
+        #
         #   @param max_total_price [Integer]
+        #
+        #   @param offer_retrieval_effort [Symbol, CheckoutIntents::Models::CheckoutIntentPurchaseParams::Constraints::OfferRetrievalEffort] Controls how much effort the system should spend retrieving an offer.
+
+        # 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'
+        #
+        # @see CheckoutIntents::Models::CheckoutIntentPurchaseParams::Constraints#offer_retrieval_effort
+        module OfferRetrievalEffort
+          extend CheckoutIntents::Internal::Type::Enum
+
+          MAX = :max
+          LOW = :low
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
       end
     end
   end

data/lib/checkout_intents/models/money.rb

@@ -5,8 +5,8 @@ module CheckoutIntents
     class Money < CheckoutIntents::Internal::Type::BaseModel
       # @!attribute amount_subunits
       #
-      #   @return [Float]
-      required :amount_subunits, Float, api_name: :amountSubunits
+      #   @return [Integer]
+      required :amount_subunits, Integer, api_name: :amountSubunits
 
       # @!attribute currency_code
       #
@@ -14,7 +14,7 @@ module CheckoutIntents
       required :currency_code, String, api_name: :currencyCode
 
       # @!method initialize(amount_subunits:, currency_code:)
-      #   @param amount_subunits [Float]
+      #   @param amount_subunits [Integer]
       #   @param currency_code [String]
     end
   end

data/lib/checkout_intents/models/product.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+module CheckoutIntents
+  module Models
+    # @see CheckoutIntents::Resources::Products#lookup
+    class Product < CheckoutIntents::Internal::Type::BaseModel
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute availability
+      #   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
+      #
+      #   @return [Symbol, CheckoutIntents::Models::ProductAvailability]
+      required :availability, enum: -> { CheckoutIntents::ProductAvailability }
+
+      # @!attribute brand
+      #
+      #   @return [String, nil]
+      required :brand, String, nil?: true
+
+      # @!attribute description
+      #
+      #   @return [String, nil]
+      required :description, String, nil?: true
+
+      # @!attribute images
+      #
+      #   @return [Array<CheckoutIntents::Models::ProductImage>]
+      required :images, -> { CheckoutIntents::Internal::Type::ArrayOf[CheckoutIntents::ProductImage] }
+
+      # @!attribute name
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!attribute price
+      #
+      #   @return [CheckoutIntents::Models::Money]
+      required :price, -> { CheckoutIntents::Money }
+
+      # @!attribute sku
+      #
+      #   @return [String, nil]
+      required :sku, String, nil?: true
+
+      # @!attribute url
+      #
+      #   @return [String]
+      required :url, String
+
+      # @!method initialize(id:, availability:, brand:, description:, images:, name:, price:, sku:, url:)
+      #   Some parameter documentations has been truncated, see
+      #   {CheckoutIntents::Models::Product} for more details.
+      #
+      #   @param id [String]
+      #
+      #   @param availability [Symbol, CheckoutIntents::Models::ProductAvailability] The availability status of a product.
+      #
+      #   @param brand [String, nil]
+      #
+      #   @param description [String, nil]
+      #
+      #   @param images [Array<CheckoutIntents::Models::ProductImage>]
+      #
+      #   @param name [String]
+      #
+      #   @param price [CheckoutIntents::Models::Money]
+      #
+      #   @param sku [String, nil]
+      #
+      #   @param url [String]
+    end
+  end
+end

data/lib/checkout_intents/models/product_availability.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module CheckoutIntents
+  module Models
+    # 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
+    module ProductAvailability
+      extend CheckoutIntents::Internal::Type::Enum
+
+      IN_STOCK = :in_stock
+      OUT_OF_STOCK = :out_of_stock
+      PREORDER = :preorder
+      BACKORDER = :backorder
+      UNKNOWN = :unknown
+
+      # @!method self.values
+      #   @return [Array<Symbol>]
+    end
+  end
+end

data/lib/checkout_intents/models/product_image.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module CheckoutIntents
+  module Models
+    class ProductImage < CheckoutIntents::Internal::Type::BaseModel
+      # @!attribute is_featured
+      #
+      #   @return [Boolean]
+      required :is_featured, CheckoutIntents::Internal::Type::Boolean, api_name: :isFeatured
+
+      # @!attribute url
+      #
+      #   @return [String]
+      required :url, String
+
+      # @!method initialize(is_featured:, url:)
+      #   @param is_featured [Boolean]
+      #   @param url [String]
+    end
+  end
+end

data/lib/checkout_intents/models/product_lookup_params.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module CheckoutIntents
+  module Models
+    # @see CheckoutIntents::Resources::Products#lookup
+    class ProductLookupParams < CheckoutIntents::Internal::Type::BaseModel
+      extend CheckoutIntents::Internal::Type::RequestParameters::Converter
+      include CheckoutIntents::Internal::Type::RequestParameters
+
+      # @!attribute url
+      #
+      #   @return [String]
+      required :url, String
+
+      # @!method initialize(url:, request_options: {})
+      #   @param url [String]
+      #   @param request_options [CheckoutIntents::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/checkout_intents/models.rb

@@ -72,5 +72,13 @@ module CheckoutIntents
 
   PaymentMethod = CheckoutIntents::Models::PaymentMethod
 
+  Product = CheckoutIntents::Models::Product
+
+  ProductAvailability = CheckoutIntents::Models::ProductAvailability
+
+  ProductImage = CheckoutIntents::Models::ProductImage
+
+  ProductLookupParams = CheckoutIntents::Models::ProductLookupParams
+
   VariantSelection = CheckoutIntents::Models::VariantSelection
 end

data/lib/checkout_intents/resources/products.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module CheckoutIntents
+  module Resources
+    class Products
+      # Retrieve a product's information by URL.
+      #
+      # @overload lookup(url:, request_options: {})
+      #
+      # @param url [String]
+      # @param request_options [::CheckoutIntents::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [::CheckoutIntents::Models::Product]
+      #
+      # @see ::CheckoutIntents::Models::ProductLookupParams
+      def lookup(params)
+        parsed, options = ::CheckoutIntents::ProductLookupParams.dump_request(params)
+        @client.request(
+          method: :get,
+          path: "api/v1/products/lookup",
+          query: parsed,
+          model: ::CheckoutIntents::Product,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [::CheckoutIntents::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/checkout_intents/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module CheckoutIntents
-  VERSION = "0.2.1"
+  VERSION = "0.3.0"
 end

data/lib/checkout_intents.rb

@@ -69,9 +69,14 @@ require_relative "checkout_intents/models/checkout_session"
 require_relative "checkout_intents/models/money"
 require_relative "checkout_intents/models/offer"
 require_relative "checkout_intents/models/payment_method"
+require_relative "checkout_intents/models/product"
+require_relative "checkout_intents/models/product_availability"
+require_relative "checkout_intents/models/product_image"
+require_relative "checkout_intents/models/product_lookup_params"
 require_relative "checkout_intents/models/variant_selection"
 require_relative "checkout_intents/models"
 require_relative "checkout_intents/resources/betas"
 require_relative "checkout_intents/resources/betas/checkout_sessions"
 require_relative "checkout_intents/resources/brands"
 require_relative "checkout_intents/resources/checkout_intents"
+require_relative "checkout_intents/resources/products"

data/rbi/checkout_intents/client.rbi

@@ -32,6 +32,9 @@ module CheckoutIntents
     sig { returns(CheckoutIntents::Resources::Brands) }
     attr_reader :brands
 
+    sig { returns(CheckoutIntents::Resources::Products) }
+    attr_reader :products
+
     # @api private
     sig { override.returns(T::Hash[String, String]) }
     private def auth_headers
@@ -46,7 +49,8 @@ module CheckoutIntents
         max_retries: Integer,
         timeout: Float,
         initial_retry_delay: Float,
-        max_retry_delay: Float
+        max_retry_delay: Float,
+        idempotency_header: String
       ).returns(T.attached_class)
     end
     def self.new(
@@ -67,7 +71,8 @@ module CheckoutIntents
       max_retries: CheckoutIntents::Client::DEFAULT_MAX_RETRIES,
       timeout: CheckoutIntents::Client::DEFAULT_TIMEOUT_IN_SECONDS,
       initial_retry_delay: CheckoutIntents::Client::DEFAULT_INITIAL_RETRY_DELAY,
-      max_retry_delay: CheckoutIntents::Client::DEFAULT_MAX_RETRY_DELAY
+      max_retry_delay: CheckoutIntents::Client::DEFAULT_MAX_RETRY_DELAY,
+      idempotency_header: "Idempotency-Key"
     )
     end
   end

data/rbi/checkout_intents/internal/transport/base_client.rbi

@@ -305,7 +305,8 @@ module CheckoutIntents
         # Used internally for polling helpers that need to inspect headers.
         sig do
           params(
-            req: CheckoutIntents::Internal::Transport::BaseClient::RequestComponents
+            req:
+              CheckoutIntents::Internal::Transport::BaseClient::RequestComponents
           ).returns({ data: T.anything, headers: T::Hash[String, String] })
         end
         def request_with_headers(req)