checkout-intents 0.0.2

data/lib/checkout_intents/models/checkout_intent_create_params.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+module CheckoutIntents
+  module Models
+    # @see CheckoutIntents::Resources::CheckoutIntents#create
+    class CheckoutIntentCreateParams < CheckoutIntents::Internal::Type::BaseModel
+      extend CheckoutIntents::Internal::Type::RequestParameters::Converter
+      include CheckoutIntents::Internal::Type::RequestParameters
+
+      # @!attribute buyer
+      #
+      #   @return [CheckoutIntents::Models::Buyer]
+      required :buyer, -> { CheckoutIntents::Buyer }
+
+      # @!attribute product_url
+      #
+      #   @return [String]
+      required :product_url, String, api_name: :productUrl
+
+      # @!attribute quantity
+      #
+      #   @return [Float]
+      required :quantity, Float
+
+      # @!attribute constraints
+      #
+      #   @return [CheckoutIntents::Models::CheckoutIntentCreateParams::Constraints, nil]
+      optional :constraints, -> { CheckoutIntents::CheckoutIntentCreateParams::Constraints }
+
+      # @!attribute promo_codes
+      #
+      #   @return [Array<String>, nil]
+      optional :promo_codes, CheckoutIntents::Internal::Type::ArrayOf[String], api_name: :promoCodes
+
+      # @!attribute variant_selections
+      #
+      #   @return [Array<CheckoutIntents::Models::VariantSelection>, nil]
+      optional :variant_selections,
+               -> { CheckoutIntents::Internal::Type::ArrayOf[CheckoutIntents::VariantSelection] },
+               api_name: :variantSelections
+
+      # @!method initialize(buyer:, product_url:, quantity:, constraints: nil, promo_codes: nil, variant_selections: nil, request_options: {})
+      #   @param buyer [CheckoutIntents::Models::Buyer]
+      #   @param product_url [String]
+      #   @param quantity [Float]
+      #   @param constraints [CheckoutIntents::Models::CheckoutIntentCreateParams::Constraints]
+      #   @param promo_codes [Array<String>]
+      #   @param variant_selections [Array<CheckoutIntents::Models::VariantSelection>]
+      #   @param request_options [CheckoutIntents::RequestOptions, Hash{Symbol=>Object}]
+
+      class Constraints < CheckoutIntents::Internal::Type::BaseModel
+        # @!attribute max_shipping_price
+        #
+        #   @return [Integer, nil]
+        optional :max_shipping_price, Integer, api_name: :maxShippingPrice
+
+        # @!attribute max_total_price
+        #
+        #   @return [Integer, nil]
+        optional :max_total_price, Integer, api_name: :maxTotalPrice
+
+        # @!method initialize(max_shipping_price: nil, max_total_price: nil)
+        #   @param max_shipping_price [Integer]
+        #   @param max_total_price [Integer]
+      end
+    end
+  end
+end

data/lib/checkout_intents/models/checkout_intent_list_params.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module CheckoutIntents
+  module Models
+    # @see CheckoutIntents::Resources::CheckoutIntents#list
+    class CheckoutIntentListParams < CheckoutIntents::Internal::Type::BaseModel
+      extend CheckoutIntents::Internal::Type::RequestParameters::Converter
+      include CheckoutIntents::Internal::Type::RequestParameters
+
+      # @!attribute id
+      #
+      #   @return [Array<String>, nil]
+      optional :id, CheckoutIntents::Internal::Type::ArrayOf[String]
+
+      # @!attribute after
+      #
+      #   @return [String, nil]
+      optional :after, String
+
+      # @!attribute before
+      #
+      #   @return [String, nil]
+      optional :before, String
+
+      # @!attribute limit
+      #
+      #   @return [Float, nil]
+      optional :limit, Float
+
+      # @!attribute state
+      #
+      #   @return [Array<Symbol, CheckoutIntents::Models::CheckoutIntentListParams::State>, nil]
+      optional :state,
+               -> { CheckoutIntents::Internal::Type::ArrayOf[enum: CheckoutIntents::CheckoutIntentListParams::State] }
+
+      # @!method initialize(id: nil, after: nil, before: nil, limit: nil, state: nil, request_options: {})
+      #   @param id [Array<String>]
+      #   @param after [String]
+      #   @param before [String]
+      #   @param limit [Float]
+      #   @param state [Array<Symbol, CheckoutIntents::Models::CheckoutIntentListParams::State>]
+      #   @param request_options [CheckoutIntents::RequestOptions, Hash{Symbol=>Object}]
+
+      module State
+        extend CheckoutIntents::Internal::Type::Enum
+
+        RETRIEVING_OFFER = :retrieving_offer
+        AWAITING_CONFIRMATION = :awaiting_confirmation
+        PLACING_ORDER = :placing_order
+        COMPLETED = :completed
+        FAILED = :failed
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/checkout_intents/models/checkout_intent_purchase_params.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+module CheckoutIntents
+  module Models
+    # @see CheckoutIntents::Resources::CheckoutIntents#purchase
+    class CheckoutIntentPurchaseParams < CheckoutIntents::Internal::Type::BaseModel
+      extend CheckoutIntents::Internal::Type::RequestParameters::Converter
+      include CheckoutIntents::Internal::Type::RequestParameters
+
+      # @!attribute buyer
+      #
+      #   @return [CheckoutIntents::Models::Buyer]
+      required :buyer, -> { CheckoutIntents::Buyer }
+
+      # @!attribute payment_method
+      #
+      #   @return [CheckoutIntents::Models::PaymentMethod::StripeTokenPaymentMethod, CheckoutIntents::Models::PaymentMethod::BasisTheoryPaymentMethod, CheckoutIntents::Models::PaymentMethod::NekudaPaymentMethod]
+      required :payment_method, union: -> { CheckoutIntents::PaymentMethod }, api_name: :paymentMethod
+
+      # @!attribute product_url
+      #
+      #   @return [String]
+      required :product_url, String, api_name: :productUrl
+
+      # @!attribute quantity
+      #
+      #   @return [Float]
+      required :quantity, Float
+
+      # @!attribute constraints
+      #
+      #   @return [CheckoutIntents::Models::CheckoutIntentPurchaseParams::Constraints, nil]
+      optional :constraints, -> { CheckoutIntents::CheckoutIntentPurchaseParams::Constraints }
+
+      # @!attribute promo_codes
+      #
+      #   @return [Array<String>, nil]
+      optional :promo_codes, CheckoutIntents::Internal::Type::ArrayOf[String], api_name: :promoCodes
+
+      # @!attribute variant_selections
+      #
+      #   @return [Array<CheckoutIntents::Models::VariantSelection>, nil]
+      optional :variant_selections,
+               -> { CheckoutIntents::Internal::Type::ArrayOf[CheckoutIntents::VariantSelection] },
+               api_name: :variantSelections
+
+      # @!method initialize(buyer:, payment_method:, product_url:, quantity:, constraints: nil, promo_codes: nil, variant_selections: nil, request_options: {})
+      #   @param buyer [CheckoutIntents::Models::Buyer]
+      #   @param payment_method [CheckoutIntents::Models::PaymentMethod::StripeTokenPaymentMethod, CheckoutIntents::Models::PaymentMethod::BasisTheoryPaymentMethod, CheckoutIntents::Models::PaymentMethod::NekudaPaymentMethod]
+      #   @param product_url [String]
+      #   @param quantity [Float]
+      #   @param constraints [CheckoutIntents::Models::CheckoutIntentPurchaseParams::Constraints]
+      #   @param promo_codes [Array<String>]
+      #   @param variant_selections [Array<CheckoutIntents::Models::VariantSelection>]
+      #   @param request_options [CheckoutIntents::RequestOptions, Hash{Symbol=>Object}]
+
+      class Constraints < CheckoutIntents::Internal::Type::BaseModel
+        # @!attribute max_shipping_price
+        #
+        #   @return [Integer, nil]
+        optional :max_shipping_price, Integer, api_name: :maxShippingPrice
+
+        # @!attribute max_total_price
+        #
+        #   @return [Integer, nil]
+        optional :max_total_price, Integer, api_name: :maxTotalPrice
+
+        # @!method initialize(max_shipping_price: nil, max_total_price: nil)
+        #   @param max_shipping_price [Integer]
+        #   @param max_total_price [Integer]
+      end
+    end
+  end
+end

data/lib/checkout_intents/models/checkout_intent_retrieve_params.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module CheckoutIntents
+  module Models
+    # @see CheckoutIntents::Resources::CheckoutIntents#retrieve
+    class CheckoutIntentRetrieveParams < CheckoutIntents::Internal::Type::BaseModel
+      extend CheckoutIntents::Internal::Type::RequestParameters::Converter
+      include CheckoutIntents::Internal::Type::RequestParameters
+
+      # @!method initialize(request_options: {})
+      #   @param request_options [CheckoutIntents::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/checkout_intents/models/checkout_session.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module CheckoutIntents
+  module Models
+    class CheckoutSession < CheckoutIntents::Internal::Type::BaseModel
+      # @!attribute url
+      #   URL to send your user to for checkout. This URL is valid for 4 hours.
+      #
+      #   @return [String]
+      required :url, String
+
+      # @!method initialize(url:)
+      #   A checkout session represents a hosted checkout form that shoppers can use to
+      #   complete their purchases.
+      #
+      #   Checkout sessions provide a pre-built UI for collecting payment and shipping
+      #   information, allowing you to quickly integrate checkout functionality without
+      #   building your own forms.
+      #
+      #   @param url [String] URL to send your user to for checkout. This URL is valid for 4 hours.
+    end
+  end
+end

data/lib/checkout_intents/models/money.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module CheckoutIntents
+  module Models
+    class Money < CheckoutIntents::Internal::Type::BaseModel
+      # @!attribute amount_subunits
+      #
+      #   @return [Float]
+      required :amount_subunits, Float, api_name: :amountSubunits
+
+      # @!attribute currency_code
+      #
+      #   @return [String]
+      required :currency_code, String, api_name: :currencyCode
+
+      # @!method initialize(amount_subunits:, currency_code:)
+      #   @param amount_subunits [Float]
+      #   @param currency_code [String]
+    end
+  end
+end

data/lib/checkout_intents/models/offer.rb

@@ -0,0 +1,113 @@
+# frozen_string_literal: true
+
+module CheckoutIntents
+  module Models
+    class Offer < CheckoutIntents::Internal::Type::BaseModel
+      # @!attribute cost
+      #
+      #   @return [CheckoutIntents::Models::Offer::Cost]
+      required :cost, -> { CheckoutIntents::Offer::Cost }
+
+      # @!attribute shipping
+      #
+      #   @return [CheckoutIntents::Models::Offer::Shipping]
+      required :shipping, -> { CheckoutIntents::Offer::Shipping }
+
+      # @!attribute applied_promo_codes
+      #
+      #   @return [Array<String>, nil]
+      optional :applied_promo_codes,
+               CheckoutIntents::Internal::Type::ArrayOf[String],
+               api_name: :appliedPromoCodes
+
+      # @!method initialize(cost:, shipping:, applied_promo_codes: nil)
+      #   @param cost [CheckoutIntents::Models::Offer::Cost]
+      #   @param shipping [CheckoutIntents::Models::Offer::Shipping]
+      #   @param applied_promo_codes [Array<String>]
+
+      # @see CheckoutIntents::Models::Offer#cost
+      class Cost < CheckoutIntents::Internal::Type::BaseModel
+        # @!attribute subtotal
+        #
+        #   @return [CheckoutIntents::Models::Money]
+        required :subtotal, -> { CheckoutIntents::Money }
+
+        # @!attribute total
+        #
+        #   @return [CheckoutIntents::Models::Money]
+        required :total, -> { CheckoutIntents::Money }
+
+        # @!attribute discount
+        #
+        #   @return [CheckoutIntents::Models::Money, nil]
+        optional :discount, -> { CheckoutIntents::Money }
+
+        # @!attribute shipping
+        #
+        #   @return [CheckoutIntents::Models::Money, nil]
+        optional :shipping, -> { CheckoutIntents::Money }
+
+        # @!attribute surcharge
+        #
+        #   @return [CheckoutIntents::Models::Money, nil]
+        optional :surcharge, -> { CheckoutIntents::Money }
+
+        # @!attribute tax
+        #
+        #   @return [CheckoutIntents::Models::Money, nil]
+        optional :tax, -> { CheckoutIntents::Money }
+
+        # @!method initialize(subtotal:, total:, discount: nil, shipping: nil, surcharge: nil, tax: nil)
+        #   @param subtotal [CheckoutIntents::Models::Money]
+        #   @param total [CheckoutIntents::Models::Money]
+        #   @param discount [CheckoutIntents::Models::Money]
+        #   @param shipping [CheckoutIntents::Models::Money]
+        #   @param surcharge [CheckoutIntents::Models::Money]
+        #   @param tax [CheckoutIntents::Models::Money]
+      end
+
+      # @see CheckoutIntents::Models::Offer#shipping
+      class Shipping < CheckoutIntents::Internal::Type::BaseModel
+        # @!attribute available_options
+        #
+        #   @return [Array<CheckoutIntents::Models::Offer::Shipping::AvailableOption>]
+        required :available_options,
+                 -> {
+                   CheckoutIntents::Internal::Type::ArrayOf[CheckoutIntents::Offer::Shipping::AvailableOption]
+                 },
+                 api_name: :availableOptions
+
+        # @!attribute selected_option_id
+        #
+        #   @return [String, nil]
+        optional :selected_option_id, String, api_name: :selectedOptionId
+
+        # @!method initialize(available_options:, selected_option_id: nil)
+        #   @param available_options [Array<CheckoutIntents::Models::Offer::Shipping::AvailableOption>]
+        #   @param selected_option_id [String]
+
+        class AvailableOption < CheckoutIntents::Internal::Type::BaseModel
+          # @!attribute id
+          #
+          #   @return [String]
+          required :id, String
+
+          # @!attribute cost
+          #
+          #   @return [CheckoutIntents::Models::Money]
+          required :cost, -> { CheckoutIntents::Money }
+
+          # @!attribute discount
+          #
+          #   @return [CheckoutIntents::Models::Money, nil]
+          optional :discount, -> { CheckoutIntents::Money }
+
+          # @!method initialize(id:, cost:, discount: nil)
+          #   @param id [String]
+          #   @param cost [CheckoutIntents::Models::Money]
+          #   @param discount [CheckoutIntents::Models::Money]
+        end
+      end
+    end
+  end
+end

data/lib/checkout_intents/models/payment_method.rb

@@ -0,0 +1,120 @@
+# frozen_string_literal: true
+
+module CheckoutIntents
+  module Models
+    module PaymentMethod
+      extend CheckoutIntents::Internal::Type::Union
+
+      variant -> { CheckoutIntents::PaymentMethod::StripeTokenPaymentMethod }
+
+      variant -> { CheckoutIntents::PaymentMethod::BasisTheoryPaymentMethod }
+
+      variant -> { CheckoutIntents::PaymentMethod::NekudaPaymentMethod }
+
+      class StripeTokenPaymentMethod < CheckoutIntents::Internal::Type::BaseModel
+        # @!attribute stripe_token
+        #
+        #   @return [String]
+        required :stripe_token, String, api_name: :stripeToken
+
+        # @!attribute type
+        #
+        #   @return [Symbol, CheckoutIntents::Models::PaymentMethod::StripeTokenPaymentMethod::Type]
+        required :type, enum: -> { CheckoutIntents::PaymentMethod::StripeTokenPaymentMethod::Type }
+
+        # @!method initialize(stripe_token:, type:)
+        #   @param stripe_token [String]
+        #   @param type [Symbol, CheckoutIntents::Models::PaymentMethod::StripeTokenPaymentMethod::Type]
+
+        # @see CheckoutIntents::Models::PaymentMethod::StripeTokenPaymentMethod#type
+        module Type
+          extend CheckoutIntents::Internal::Type::Enum
+
+          STRIPE_TOKEN = :stripe_token
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
+      class BasisTheoryPaymentMethod < CheckoutIntents::Internal::Type::BaseModel
+        # @!attribute basis_theory_token
+        #
+        #   @return [String]
+        required :basis_theory_token, String, api_name: :basisTheoryToken
+
+        # @!attribute type
+        #
+        #   @return [Symbol, CheckoutIntents::Models::PaymentMethod::BasisTheoryPaymentMethod::Type]
+        required :type, enum: -> { CheckoutIntents::PaymentMethod::BasisTheoryPaymentMethod::Type }
+
+        # @!method initialize(basis_theory_token:, type:)
+        #   @param basis_theory_token [String]
+        #   @param type [Symbol, CheckoutIntents::Models::PaymentMethod::BasisTheoryPaymentMethod::Type]
+
+        # @see CheckoutIntents::Models::PaymentMethod::BasisTheoryPaymentMethod#type
+        module Type
+          extend CheckoutIntents::Internal::Type::Enum
+
+          BASIS_THEORY_TOKEN = :basis_theory_token
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
+      class NekudaPaymentMethod < CheckoutIntents::Internal::Type::BaseModel
+        # @!attribute nekuda_user_id
+        #
+        #   @return [String]
+        required :nekuda_user_id, String, api_name: :nekudaUserId
+
+        # @!attribute type
+        #
+        #   @return [Symbol, CheckoutIntents::Models::PaymentMethod::NekudaPaymentMethod::Type]
+        required :type, enum: -> { CheckoutIntents::PaymentMethod::NekudaPaymentMethod::Type }
+
+        # @!attribute nekuda_mandate_data
+        #   Construct a type with a set of properties K of type T
+        #
+        #   @return [Hash{Symbol=>String, Float}, nil]
+        optional :nekuda_mandate_data,
+                 -> {
+                   CheckoutIntents::Internal::Type::HashOf[union: CheckoutIntents::PaymentMethod::NekudaPaymentMethod::NekudaMandateData]
+                 },
+                 api_name: :nekudaMandateData
+
+        # @!method initialize(nekuda_user_id:, type:, nekuda_mandate_data: nil)
+        #   @param nekuda_user_id [String]
+        #
+        #   @param type [Symbol, CheckoutIntents::Models::PaymentMethod::NekudaPaymentMethod::Type]
+        #
+        #   @param nekuda_mandate_data [Hash{Symbol=>String, Float}] Construct a type with a set of properties K of type T
+
+        # @see CheckoutIntents::Models::PaymentMethod::NekudaPaymentMethod#type
+        module Type
+          extend CheckoutIntents::Internal::Type::Enum
+
+          NEKUDA_TOKEN = :nekuda_token
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        module NekudaMandateData
+          extend CheckoutIntents::Internal::Type::Union
+
+          variant String
+
+          variant Float
+
+          # @!method self.variants
+          #   @return [Array(String, Float)]
+        end
+      end
+
+      # @!method self.variants
+      #   @return [Array(CheckoutIntents::Models::PaymentMethod::StripeTokenPaymentMethod, CheckoutIntents::Models::PaymentMethod::BasisTheoryPaymentMethod, CheckoutIntents::Models::PaymentMethod::NekudaPaymentMethod)]
+    end
+  end
+end

data/lib/checkout_intents/models/variant_selection.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module CheckoutIntents
+  module Models
+    class VariantSelection < CheckoutIntents::Internal::Type::BaseModel
+      # @!attribute label
+      #
+      #   @return [String]
+      required :label, String
+
+      # @!attribute value
+      #
+      #   @return [String, Float]
+      required :value, union: -> { CheckoutIntents::VariantSelection::Value }
+
+      # @!method initialize(label:, value:)
+      #   @param label [String]
+      #   @param value [String, Float]
+
+      # @see CheckoutIntents::Models::VariantSelection#value
+      module Value
+        extend CheckoutIntents::Internal::Type::Union
+
+        variant String
+
+        variant Float
+
+        # @!method self.variants
+        #   @return [Array(String, Float)]
+      end
+    end
+  end
+end

data/lib/checkout_intents/models.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+module CheckoutIntents
+  [
+    CheckoutIntents::Internal::Type::BaseModel,
+    *CheckoutIntents::Internal::Type::BaseModel.subclasses
+  ].each do |cls|
+    cls.define_sorbet_constant!(:OrHash) { T.type_alias { T.any(cls, CheckoutIntents::Internal::AnyHash) } }
+  end
+
+  CheckoutIntents::Internal::Util.walk_namespaces(CheckoutIntents::Models).each do |mod|
+    case mod
+    in CheckoutIntents::Internal::Type::Enum | CheckoutIntents::Internal::Type::Union
+      mod.constants.each do |name|
+        case mod.const_get(name)
+        in true | false
+          mod.define_sorbet_constant!(:TaggedBoolean) { T.type_alias { T::Boolean } }
+          mod.define_sorbet_constant!(:OrBoolean) { T.type_alias { T::Boolean } }
+        in Integer
+          mod.define_sorbet_constant!(:TaggedInteger) { T.type_alias { Integer } }
+          mod.define_sorbet_constant!(:OrInteger) { T.type_alias { Integer } }
+        in Float
+          mod.define_sorbet_constant!(:TaggedFloat) { T.type_alias { Float } }
+          mod.define_sorbet_constant!(:OrFloat) { T.type_alias { Float } }
+        in Symbol
+          mod.define_sorbet_constant!(:TaggedSymbol) { T.type_alias { Symbol } }
+          mod.define_sorbet_constant!(:OrSymbol) { T.type_alias { T.any(Symbol, String) } }
+        else
+        end
+      end
+    else
+    end
+  end
+
+  CheckoutIntents::Internal::Util.walk_namespaces(CheckoutIntents::Models)
+                                 .lazy
+                                 .grep(CheckoutIntents::Internal::Type::Union)
+                                 .each do |mod|
+    const = :Variants
+    next if mod.sorbet_constant_defined?(const)
+
+    mod.define_sorbet_constant!(const) { T.type_alias { mod.to_sorbet_type } }
+  end
+
+  BaseCheckoutIntent = CheckoutIntents::Models::BaseCheckoutIntent
+
+  Betas = CheckoutIntents::Models::Betas
+
+  BrandRetrieveParams = CheckoutIntents::Models::BrandRetrieveParams
+
+  Buyer = CheckoutIntents::Models::Buyer
+
+  CheckoutIntent = CheckoutIntents::Models::CheckoutIntent
+
+  CheckoutIntentAddPaymentParams = CheckoutIntents::Models::CheckoutIntentAddPaymentParams
+
+  CheckoutIntentConfirmParams = CheckoutIntents::Models::CheckoutIntentConfirmParams
+
+  CheckoutIntentCreateParams = CheckoutIntents::Models::CheckoutIntentCreateParams
+
+  CheckoutIntentListParams = CheckoutIntents::Models::CheckoutIntentListParams
+
+  CheckoutIntentPurchaseParams = CheckoutIntents::Models::CheckoutIntentPurchaseParams
+
+  CheckoutIntentRetrieveParams = CheckoutIntents::Models::CheckoutIntentRetrieveParams
+
+  CheckoutSession = CheckoutIntents::Models::CheckoutSession
+
+  Money = CheckoutIntents::Models::Money
+
+  Offer = CheckoutIntents::Models::Offer
+
+  PaymentMethod = CheckoutIntents::Models::PaymentMethod
+
+  VariantSelection = CheckoutIntents::Models::VariantSelection
+end

data/lib/checkout_intents/request_options.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+module CheckoutIntents
+  # Specify HTTP behaviour to use for a specific request. These options supplement
+  # or override those provided at the client level.
+  #
+  # When making a request, you can pass an actual {RequestOptions} instance, or
+  # simply pass a Hash with symbol keys matching the attributes on this class.
+  class RequestOptions < CheckoutIntents::Internal::Type::BaseModel
+    # @api private
+    #
+    # @param opts [CheckoutIntents::RequestOptions, Hash{Symbol=>Object}]
+    #
+    # @raise [ArgumentError]
+    def self.validate!(opts)
+      case opts
+      in CheckoutIntents::RequestOptions | Hash
+        opts.to_h.each_key do |k|
+          unless fields.include?(k)
+            raise ArgumentError.new("Request `opts` keys must be one of #{fields.keys}, got #{k.inspect}")
+          end
+        end
+      else
+        raise ArgumentError.new("Request `opts` must be a Hash or RequestOptions, got #{opts.inspect}")
+      end
+    end
+
+    # @!attribute idempotency_key
+    #   Idempotency key to send with request and all associated retries. Will only be
+    #   sent for write requests.
+    #
+    #   @return [String, nil]
+    optional :idempotency_key, String
+
+    # @!attribute extra_query
+    #   Extra query params to send with the request. These are `.merge`’d into any
+    #   `query` given at the client level.
+    #
+    #   @return [Hash{String=>Array<String>, String, nil}, nil]
+    optional :extra_query,
+             CheckoutIntents::Internal::Type::HashOf[CheckoutIntents::Internal::Type::ArrayOf[String]]
+
+    # @!attribute extra_headers
+    #   Extra headers to send with the request. These are `.merged`’d into any
+    #   `extra_headers` given at the client level.
+    #
+    #   @return [Hash{String=>String, nil}, nil]
+    optional :extra_headers, CheckoutIntents::Internal::Type::HashOf[String, nil?: true]
+
+    # @!attribute extra_body
+    #   Extra data to send with the request. These are deep merged into any data
+    #   generated as part of the normal request.
+    #
+    #   @return [Object, nil]
+    optional :extra_body, CheckoutIntents::Internal::Type::HashOf[CheckoutIntents::Internal::Type::Unknown]
+
+    # @!attribute max_retries
+    #   Maximum number of retries to attempt after a failed initial request.
+    #
+    #   @return [Integer, nil]
+    optional :max_retries, Integer
+
+    # @!attribute timeout
+    #   Request timeout in seconds.
+    #
+    #   @return [Float, nil]
+    optional :timeout, Float
+
+    # @!method initialize(values = {})
+    #   Returns a new instance of RequestOptions.
+    #
+    #   @param values [Hash{Symbol=>Object}]
+
+    define_sorbet_constant!(:OrHash) do
+      T.type_alias { T.any(CheckoutIntents::RequestOptions, CheckoutIntents::Internal::AnyHash) }
+    end
+  end
+end