checkout-intents 0.2.1 → 0.3.0

data/rbi/checkout_intents/models/product_lookup_params.rbi

@@ -0,0 +1,38 @@
+# typed: strong
+
+module CheckoutIntents
+  module Models
+    class ProductLookupParams < CheckoutIntents::Internal::Type::BaseModel
+      extend CheckoutIntents::Internal::Type::RequestParameters::Converter
+      include CheckoutIntents::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            CheckoutIntents::ProductLookupParams,
+            CheckoutIntents::Internal::AnyHash
+          )
+        end
+
+      sig { returns(String) }
+      attr_accessor :url
+
+      sig do
+        params(
+          url: String,
+          request_options: CheckoutIntents::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(url:, request_options: {})
+      end
+
+      sig do
+        override.returns(
+          { url: String, request_options: CheckoutIntents::RequestOptions }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/checkout_intents/models.rbi

@@ -36,5 +36,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/rbi/checkout_intents/resources/betas.rbi

@@ -7,7 +7,9 @@ module CheckoutIntents
       attr_reader :checkout_sessions
 
       # @api private
-      sig { params(client: ::CheckoutIntents::Client).returns(T.attached_class) }
+      sig do
+        params(client: ::CheckoutIntents::Client).returns(T.attached_class)
+      end
       def self.new(client:)
       end
     end

data/rbi/checkout_intents/resources/brands.rbi

@@ -21,7 +21,9 @@ module CheckoutIntents
       end
 
       # @api private
-      sig { params(client: ::CheckoutIntents::Client).returns(T.attached_class) }
+      sig do
+        params(client: ::CheckoutIntents::Client).returns(T.attached_class)
+      end
       def self.new(client:)
       end
     end

data/rbi/checkout_intents/resources/checkout_intents.rbi

@@ -270,7 +270,9 @@ module CheckoutIntents
       end
 
       # @api private
-      sig { params(client: ::CheckoutIntents::Client).returns(T.attached_class) }
+      sig do
+        params(client: ::CheckoutIntents::Client).returns(T.attached_class)
+      end
       def self.new(client:)
       end
     end

data/rbi/checkout_intents/resources/products.rbi

@@ -0,0 +1,24 @@
+# typed: strong
+
+module CheckoutIntents
+  module Resources
+    class Products
+      # Retrieve a product's information by URL.
+      sig do
+        params(
+          url: String,
+          request_options: ::CheckoutIntents::RequestOptions::OrHash
+        ).returns(::CheckoutIntents::Product)
+      end
+      def lookup(url:, request_options: {})
+      end
+
+      # @api private
+      sig do
+        params(client: ::CheckoutIntents::Client).returns(T.attached_class)
+      end
+      def self.new(client:)
+      end
+    end
+  end
+end

data/sig/checkout_intents/client.rbs

@@ -21,6 +21,8 @@ module CheckoutIntents
 
     attr_reader brands: CheckoutIntents::Resources::Brands
 
+    attr_reader products: CheckoutIntents::Resources::Products
+
     private def auth_headers: -> ::Hash[String, String]
 
     def initialize: (
@@ -30,7 +32,8 @@ module CheckoutIntents
       ?max_retries: Integer,
       ?timeout: Float,
       ?initial_retry_delay: Float,
-      ?max_retry_delay: Float
+      ?max_retry_delay: Float,
+      ?idempotency_header: String
     ) -> void
   end
 end

data/sig/checkout_intents/models/base_checkout_intent.rbs

@@ -62,7 +62,11 @@ module CheckoutIntents
       }
 
       type constraints =
-        { max_shipping_price: Integer, max_total_price: Integer }
+        {
+          max_shipping_price: Integer,
+          max_total_price: Integer,
+          offer_retrieval_effort: CheckoutIntents::Models::BaseCheckoutIntent::Constraints::offer_retrieval_effort
+        }
 
       class Constraints < CheckoutIntents::Internal::Type::BaseModel
         attr_reader max_shipping_price: Integer?
@@ -73,15 +77,34 @@ module CheckoutIntents
 
         def max_total_price=: (Integer) -> Integer
 
+        attr_reader offer_retrieval_effort: CheckoutIntents::Models::BaseCheckoutIntent::Constraints::offer_retrieval_effort?
+
+        def offer_retrieval_effort=: (
+          CheckoutIntents::Models::BaseCheckoutIntent::Constraints::offer_retrieval_effort
+        ) -> CheckoutIntents::Models::BaseCheckoutIntent::Constraints::offer_retrieval_effort
+
         def initialize: (
           ?max_shipping_price: Integer,
-          ?max_total_price: Integer
+          ?max_total_price: Integer,
+          ?offer_retrieval_effort: CheckoutIntents::Models::BaseCheckoutIntent::Constraints::offer_retrieval_effort
         ) -> void
 
         def to_hash: -> {
           max_shipping_price: Integer,
-          max_total_price: Integer
+          max_total_price: Integer,
+          offer_retrieval_effort: CheckoutIntents::Models::BaseCheckoutIntent::Constraints::offer_retrieval_effort
         }
+
+        type offer_retrieval_effort = :max | :low
+
+        module OfferRetrievalEffort
+          extend CheckoutIntents::Internal::Type::Enum
+
+          MAX: :max
+          LOW: :low
+
+          def self?.values: -> ::Array[CheckoutIntents::Models::BaseCheckoutIntent::Constraints::offer_retrieval_effort]
+        end
       end
     end
   end

data/sig/checkout_intents/models/betas/checkout_session_create_params.rbs

@@ -145,7 +145,11 @@ module CheckoutIntents
         end
 
         type constraints =
-          { max_shipping_price: Integer, max_total_price: Integer }
+          {
+            max_shipping_price: Integer,
+            max_total_price: Integer,
+            offer_retrieval_effort: CheckoutIntents::Models::Betas::CheckoutSessionCreateParams::Constraints::offer_retrieval_effort
+          }
 
         class Constraints < CheckoutIntents::Internal::Type::BaseModel
           attr_reader max_shipping_price: Integer?
@@ -156,15 +160,34 @@ module CheckoutIntents
 
           def max_total_price=: (Integer) -> Integer
 
+          attr_reader offer_retrieval_effort: CheckoutIntents::Models::Betas::CheckoutSessionCreateParams::Constraints::offer_retrieval_effort?
+
+          def offer_retrieval_effort=: (
+            CheckoutIntents::Models::Betas::CheckoutSessionCreateParams::Constraints::offer_retrieval_effort
+          ) -> CheckoutIntents::Models::Betas::CheckoutSessionCreateParams::Constraints::offer_retrieval_effort
+
           def initialize: (
             ?max_shipping_price: Integer,
-            ?max_total_price: Integer
+            ?max_total_price: Integer,
+            ?offer_retrieval_effort: CheckoutIntents::Models::Betas::CheckoutSessionCreateParams::Constraints::offer_retrieval_effort
           ) -> void
 
           def to_hash: -> {
             max_shipping_price: Integer,
-            max_total_price: Integer
+            max_total_price: Integer,
+            offer_retrieval_effort: CheckoutIntents::Models::Betas::CheckoutSessionCreateParams::Constraints::offer_retrieval_effort
           }
+
+          type offer_retrieval_effort = :max | :low
+
+          module OfferRetrievalEffort
+            extend CheckoutIntents::Internal::Type::Enum
+
+            MAX: :max
+            LOW: :low
+
+            def self?.values: -> ::Array[CheckoutIntents::Models::Betas::CheckoutSessionCreateParams::Constraints::offer_retrieval_effort]
+          end
         end
       end
     end

data/sig/checkout_intents/models/checkout_intent_create_params.rbs

@@ -58,7 +58,11 @@ module CheckoutIntents
       }
 
       type constraints =
-        { max_shipping_price: Integer, max_total_price: Integer }
+        {
+          max_shipping_price: Integer,
+          max_total_price: Integer,
+          offer_retrieval_effort: CheckoutIntents::Models::CheckoutIntentCreateParams::Constraints::offer_retrieval_effort
+        }
 
       class Constraints < CheckoutIntents::Internal::Type::BaseModel
         attr_reader max_shipping_price: Integer?
@@ -69,15 +73,34 @@ module CheckoutIntents
 
         def max_total_price=: (Integer) -> Integer
 
+        attr_reader offer_retrieval_effort: CheckoutIntents::Models::CheckoutIntentCreateParams::Constraints::offer_retrieval_effort?
+
+        def offer_retrieval_effort=: (
+          CheckoutIntents::Models::CheckoutIntentCreateParams::Constraints::offer_retrieval_effort
+        ) -> CheckoutIntents::Models::CheckoutIntentCreateParams::Constraints::offer_retrieval_effort
+
         def initialize: (
           ?max_shipping_price: Integer,
-          ?max_total_price: Integer
+          ?max_total_price: Integer,
+          ?offer_retrieval_effort: CheckoutIntents::Models::CheckoutIntentCreateParams::Constraints::offer_retrieval_effort
         ) -> void
 
         def to_hash: -> {
           max_shipping_price: Integer,
-          max_total_price: Integer
+          max_total_price: Integer,
+          offer_retrieval_effort: CheckoutIntents::Models::CheckoutIntentCreateParams::Constraints::offer_retrieval_effort
         }
+
+        type offer_retrieval_effort = :max | :low
+
+        module OfferRetrievalEffort
+          extend CheckoutIntents::Internal::Type::Enum
+
+          MAX: :max
+          LOW: :low
+
+          def self?.values: -> ::Array[CheckoutIntents::Models::CheckoutIntentCreateParams::Constraints::offer_retrieval_effort]
+        end
       end
     end
   end

data/sig/checkout_intents/models/checkout_intent_purchase_params.rbs

@@ -63,7 +63,11 @@ module CheckoutIntents
       }
 
       type constraints =
-        { max_shipping_price: Integer, max_total_price: Integer }
+        {
+          max_shipping_price: Integer,
+          max_total_price: Integer,
+          offer_retrieval_effort: CheckoutIntents::Models::CheckoutIntentPurchaseParams::Constraints::offer_retrieval_effort
+        }
 
       class Constraints < CheckoutIntents::Internal::Type::BaseModel
         attr_reader max_shipping_price: Integer?
@@ -74,15 +78,34 @@ module CheckoutIntents
 
         def max_total_price=: (Integer) -> Integer
 
+        attr_reader offer_retrieval_effort: CheckoutIntents::Models::CheckoutIntentPurchaseParams::Constraints::offer_retrieval_effort?
+
+        def offer_retrieval_effort=: (
+          CheckoutIntents::Models::CheckoutIntentPurchaseParams::Constraints::offer_retrieval_effort
+        ) -> CheckoutIntents::Models::CheckoutIntentPurchaseParams::Constraints::offer_retrieval_effort
+
         def initialize: (
           ?max_shipping_price: Integer,
-          ?max_total_price: Integer
+          ?max_total_price: Integer,
+          ?offer_retrieval_effort: CheckoutIntents::Models::CheckoutIntentPurchaseParams::Constraints::offer_retrieval_effort
         ) -> void
 
         def to_hash: -> {
           max_shipping_price: Integer,
-          max_total_price: Integer
+          max_total_price: Integer,
+          offer_retrieval_effort: CheckoutIntents::Models::CheckoutIntentPurchaseParams::Constraints::offer_retrieval_effort
         }
+
+        type offer_retrieval_effort = :max | :low
+
+        module OfferRetrievalEffort
+          extend CheckoutIntents::Internal::Type::Enum
+
+          MAX: :max
+          LOW: :low
+
+          def self?.values: -> ::Array[CheckoutIntents::Models::CheckoutIntentPurchaseParams::Constraints::offer_retrieval_effort]
+        end
       end
     end
   end

data/sig/checkout_intents/models/money.rbs

@@ -1,15 +1,15 @@
 module CheckoutIntents
   module Models
-    type money = { amount_subunits: Float, currency_code: String }
+    type money = { amount_subunits: Integer, currency_code: String }
 
     class Money < CheckoutIntents::Internal::Type::BaseModel
-      attr_accessor amount_subunits: Float
+      attr_accessor amount_subunits: Integer
 
       attr_accessor currency_code: String
 
-      def initialize: (amount_subunits: Float, currency_code: String) -> void
+      def initialize: (amount_subunits: Integer, currency_code: String) -> void
 
-      def to_hash: -> { amount_subunits: Float, currency_code: String }
+      def to_hash: -> { amount_subunits: Integer, currency_code: String }
     end
   end
 end

data/sig/checkout_intents/models/product.rbs

@@ -0,0 +1,60 @@
+module CheckoutIntents
+  module Models
+    type product =
+      {
+        id: String,
+        availability: CheckoutIntents::Models::product_availability,
+        brand: String?,
+        description: String?,
+        images: ::Array[CheckoutIntents::ProductImage],
+        name: String,
+        price: CheckoutIntents::Money,
+        sku: String?,
+        url: String
+      }
+
+    class Product < CheckoutIntents::Internal::Type::BaseModel
+      attr_accessor id: String
+
+      attr_accessor availability: CheckoutIntents::Models::product_availability
+
+      attr_accessor brand: String?
+
+      attr_accessor description: String?
+
+      attr_accessor images: ::Array[CheckoutIntents::ProductImage]
+
+      attr_accessor name: String
+
+      attr_accessor price: CheckoutIntents::Money
+
+      attr_accessor sku: String?
+
+      attr_accessor url: String
+
+      def initialize: (
+        id: String,
+        availability: CheckoutIntents::Models::product_availability,
+        brand: String?,
+        description: String?,
+        images: ::Array[CheckoutIntents::ProductImage],
+        name: String,
+        price: CheckoutIntents::Money,
+        sku: String?,
+        url: String
+      ) -> void
+
+      def to_hash: -> {
+        id: String,
+        availability: CheckoutIntents::Models::product_availability,
+        brand: String?,
+        description: String?,
+        images: ::Array[CheckoutIntents::ProductImage],
+        name: String,
+        price: CheckoutIntents::Money,
+        sku: String?,
+        url: String
+      }
+    end
+  end
+end

data/sig/checkout_intents/models/product_availability.rbs

@@ -0,0 +1,18 @@
+module CheckoutIntents
+  module Models
+    type product_availability =
+      :in_stock | :out_of_stock | :preorder | :backorder | :unknown
+
+    module ProductAvailability
+      extend CheckoutIntents::Internal::Type::Enum
+
+      IN_STOCK: :in_stock
+      OUT_OF_STOCK: :out_of_stock
+      PREORDER: :preorder
+      BACKORDER: :backorder
+      UNKNOWN: :unknown
+
+      def self?.values: -> ::Array[CheckoutIntents::Models::product_availability]
+    end
+  end
+end

data/sig/checkout_intents/models/product_image.rbs

@@ -0,0 +1,15 @@
+module CheckoutIntents
+  module Models
+    type product_image = { is_featured: bool, url: String }
+
+    class ProductImage < CheckoutIntents::Internal::Type::BaseModel
+      attr_accessor is_featured: bool
+
+      attr_accessor url: String
+
+      def initialize: (is_featured: bool, url: String) -> void
+
+      def to_hash: -> { is_featured: bool, url: String }
+    end
+  end
+end

data/sig/checkout_intents/models/product_lookup_params.rbs

@@ -0,0 +1,23 @@
+module CheckoutIntents
+  module Models
+    type product_lookup_params =
+      { url: String } & CheckoutIntents::Internal::Type::request_parameters
+
+    class ProductLookupParams < CheckoutIntents::Internal::Type::BaseModel
+      extend CheckoutIntents::Internal::Type::RequestParameters::Converter
+      include CheckoutIntents::Internal::Type::RequestParameters
+
+      attr_accessor url: String
+
+      def initialize: (
+        url: String,
+        ?request_options: CheckoutIntents::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        url: String,
+        request_options: CheckoutIntents::RequestOptions
+      }
+    end
+  end
+end

data/sig/checkout_intents/models.rbs

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

data/sig/checkout_intents/resources/checkout_intents.rbs

@@ -53,14 +53,16 @@ module CheckoutIntents
         ?poll_interval: Float,
         ?max_attempts: Integer,
         ?request_options: CheckoutIntents::request_opts
-      ) -> (CheckoutIntents::CheckoutIntent::CompletedCheckoutIntent | CheckoutIntents::CheckoutIntent::FailedCheckoutIntent)
+      ) -> (CheckoutIntents::CheckoutIntent::CompletedCheckoutIntent
+      | CheckoutIntents::CheckoutIntent::FailedCheckoutIntent)
 
       def poll_until_awaiting_confirmation: (
         String id,
         ?poll_interval: Float,
         ?max_attempts: Integer,
         ?request_options: CheckoutIntents::request_opts
-      ) -> (CheckoutIntents::CheckoutIntent::AwaitingConfirmationCheckoutIntent | CheckoutIntents::CheckoutIntent::FailedCheckoutIntent)
+      ) -> (CheckoutIntents::CheckoutIntent::AwaitingConfirmationCheckoutIntent
+      | CheckoutIntents::CheckoutIntent::FailedCheckoutIntent)
 
       def create_and_poll: (
         buyer: CheckoutIntents::Buyer,
@@ -72,7 +74,8 @@ module CheckoutIntents
         ?poll_interval: Float,
         ?max_attempts: Integer,
         ?request_options: CheckoutIntents::request_opts
-      ) -> (CheckoutIntents::CheckoutIntent::AwaitingConfirmationCheckoutIntent | CheckoutIntents::CheckoutIntent::FailedCheckoutIntent)
+      ) -> (CheckoutIntents::CheckoutIntent::AwaitingConfirmationCheckoutIntent
+      | CheckoutIntents::CheckoutIntent::FailedCheckoutIntent)
 
       def confirm_and_poll: (
         String id,
@@ -80,7 +83,8 @@ module CheckoutIntents
         ?poll_interval: Float,
         ?max_attempts: Integer,
         ?request_options: CheckoutIntents::request_opts
-      ) -> (CheckoutIntents::CheckoutIntent::CompletedCheckoutIntent | CheckoutIntents::CheckoutIntent::FailedCheckoutIntent)
+      ) -> (CheckoutIntents::CheckoutIntent::CompletedCheckoutIntent
+      | CheckoutIntents::CheckoutIntent::FailedCheckoutIntent)
 
       def initialize: (client: CheckoutIntents::Client) -> void
     end

data/sig/checkout_intents/resources/products.rbs

@@ -0,0 +1,12 @@
+module CheckoutIntents
+  module Resources
+    class Products
+      def lookup: (
+        url: String,
+        ?request_options: CheckoutIntents::request_opts
+      ) -> CheckoutIntents::Product
+
+      def initialize: (client: CheckoutIntents::Client) -> void
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: checkout-intents
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.0
 platform: ruby
 authors:
 - Checkout Intents
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-01-13 00:00:00.000000000 Z
+date: 2026-01-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -86,12 +86,17 @@ files:
 - lib/checkout_intents/models/money.rb
 - lib/checkout_intents/models/offer.rb
 - lib/checkout_intents/models/payment_method.rb
+- lib/checkout_intents/models/product.rb
+- lib/checkout_intents/models/product_availability.rb
+- lib/checkout_intents/models/product_image.rb
+- lib/checkout_intents/models/product_lookup_params.rb
 - lib/checkout_intents/models/variant_selection.rb
 - lib/checkout_intents/request_options.rb
 - lib/checkout_intents/resources/betas.rb
 - lib/checkout_intents/resources/betas/checkout_sessions.rb
 - lib/checkout_intents/resources/brands.rb
 - lib/checkout_intents/resources/checkout_intents.rb
+- lib/checkout_intents/resources/products.rb
 - lib/checkout_intents/version.rb
 - manifest.yaml
 - rbi/checkout_intents/client.rbi
@@ -130,12 +135,17 @@ files:
 - rbi/checkout_intents/models/money.rbi
 - rbi/checkout_intents/models/offer.rbi
 - rbi/checkout_intents/models/payment_method.rbi
+- rbi/checkout_intents/models/product.rbi
+- rbi/checkout_intents/models/product_availability.rbi
+- rbi/checkout_intents/models/product_image.rbi
+- rbi/checkout_intents/models/product_lookup_params.rbi
 - rbi/checkout_intents/models/variant_selection.rbi
 - rbi/checkout_intents/request_options.rbi
 - rbi/checkout_intents/resources/betas.rbi
 - rbi/checkout_intents/resources/betas/checkout_sessions.rbi
 - rbi/checkout_intents/resources/brands.rbi
 - rbi/checkout_intents/resources/checkout_intents.rbi
+- rbi/checkout_intents/resources/products.rbi
 - rbi/checkout_intents/version.rbi
 - sig/checkout_intents/client.rbs
 - sig/checkout_intents/errors.rbs
@@ -173,12 +183,17 @@ files:
 - sig/checkout_intents/models/money.rbs
 - sig/checkout_intents/models/offer.rbs
 - sig/checkout_intents/models/payment_method.rbs
+- sig/checkout_intents/models/product.rbs
+- sig/checkout_intents/models/product_availability.rbs
+- sig/checkout_intents/models/product_image.rbs
+- sig/checkout_intents/models/product_lookup_params.rbs
 - sig/checkout_intents/models/variant_selection.rbs
 - sig/checkout_intents/request_options.rbs
 - sig/checkout_intents/resources/betas.rbs
 - sig/checkout_intents/resources/betas/checkout_sessions.rbs
 - sig/checkout_intents/resources/brands.rbs
 - sig/checkout_intents/resources/checkout_intents.rbs
+- sig/checkout_intents/resources/products.rbs
 - sig/checkout_intents/version.rbs
 homepage: https://gemdocs.org/gems/checkout-intents
 licenses: []