kintsugi_sdk 5.5.0

data/lib/kintsugi_sdk/models/shared/validationaddress.rb

@@ -0,0 +1,73 @@
+# Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+
+# typed: true
+# frozen_string_literal: true
+
+
+module KintsugiSDK
+  module Models
+    module Shared
+    
+
+      class ValidationAddress
+        extend T::Sig
+        include Crystalline::MetadataFields
+
+        # Primary address line, such as street name and number
+        field :line1, Crystalline::Nilable.new(::String), { 'format_json': { 'letter_case': ::KintsugiSDK::Utils.field_name('line1') } }
+        # Additional address details, such as an apartment or suite number
+        field :line2, Crystalline::Nilable.new(::String), { 'format_json': { 'letter_case': ::KintsugiSDK::Utils.field_name('line2') } }
+        # Additional address details for complex addresses
+        field :line3, Crystalline::Nilable.new(::String), { 'format_json': { 'letter_case': ::KintsugiSDK::Utils.field_name('line3') } }
+        # The city or town name for the address
+        field :city, Crystalline::Nilable.new(::String), { 'format_json': { 'letter_case': ::KintsugiSDK::Utils.field_name('city') } }
+        # State, province, or region of the address
+        field :state, Crystalline::Nilable.new(::String), { 'format_json': { 'letter_case': ::KintsugiSDK::Utils.field_name('state') } }
+        # Unique identifier for the request, if applicable
+        field :id, Crystalline::Nilable.new(::Integer), { 'format_json': { 'letter_case': ::KintsugiSDK::Utils.field_name('id') } }
+        # County or district name for the address
+        field :county, Crystalline::Nilable.new(::String), { 'format_json': { 'letter_case': ::KintsugiSDK::Utils.field_name('county') } }
+        # A complete address string that can be used as an alternative to providing individual fields.
+        field :full_address, Crystalline::Nilable.new(::String), { 'format_json': { 'letter_case': ::KintsugiSDK::Utils.field_name('full_address') } }
+        # Country code in ISO 3166-1 alpha-2 format (e.g., 'US' for the United States).
+        #         Defaults to 'US'.
+        #         should not be empty. Not validating here as the validation
+        #         structure can be different for different providers
+        field :country, Crystalline::Nilable.new(::String), { 'format_json': { 'letter_case': ::KintsugiSDK::Utils.field_name('country') } }
+        # ZIP or postal code for the address. Can be empty for some locales.
+        #         Not validating here as the validation structure can be different for different providers
+        field :postal_code, Crystalline::Nilable.new(::String), { 'format_json': { 'letter_case': ::KintsugiSDK::Utils.field_name('postalCode') } }
+
+        sig { params(line1: T.nilable(::String), line2: T.nilable(::String), line3: T.nilable(::String), city: T.nilable(::String), state: T.nilable(::String), id: T.nilable(::Integer), county: T.nilable(::String), full_address: T.nilable(::String), country: T.nilable(::String), postal_code: T.nilable(::String)).void }
+        def initialize(line1: nil, line2: nil, line3: nil, city: nil, state: nil, id: nil, county: nil, full_address: nil, country: 'US', postal_code: '')
+          @line1 = line1
+          @line2 = line2
+          @line3 = line3
+          @city = city
+          @state = state
+          @id = id
+          @county = county
+          @full_address = full_address
+          @country = country
+          @postal_code = postal_code
+        end
+
+        sig { params(other: T.untyped).returns(T::Boolean) }
+        def ==(other)
+          return false unless other.is_a? self.class
+          return false unless @line1 == other.line1
+          return false unless @line2 == other.line2
+          return false unless @line3 == other.line3
+          return false unless @city == other.city
+          return false unless @state == other.state
+          return false unless @id == other.id
+          return false unless @county == other.county
+          return false unless @full_address == other.full_address
+          return false unless @country == other.country
+          return false unless @postal_code == other.postal_code
+          true
+        end
+      end
+    end
+  end
+end

data/lib/kintsugi_sdk/models/shared/validationaddress.rbi

@@ -0,0 +1,31 @@
+# typed: true
+# frozen_string_literal: true
+
+
+class KintsugiSDK::Models::Shared::ValidationAddress
+  extend ::Crystalline::MetadataFields::ClassMethods
+end
+
+
+class KintsugiSDK::Models::Shared::ValidationAddress
+  def line1(); end
+  def line1=(str_); end
+  def line2(); end
+  def line2=(str_); end
+  def line3(); end
+  def line3=(str_); end
+  def city(); end
+  def city=(str_); end
+  def state(); end
+  def state=(str_); end
+  def id(); end
+  def id=(str_); end
+  def county(); end
+  def county=(str_); end
+  def full_address(); end
+  def full_address=(str_); end
+  def country(); end
+  def country=(str_); end
+  def postal_code(); end
+  def postal_code=(str_); end
+end

data/lib/kintsugi_sdk/models/shared/validationerror.rb

@@ -0,0 +1,41 @@
+# Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+
+# typed: true
+# frozen_string_literal: true
+
+
+module KintsugiSDK
+  module Models
+    module Shared
+    
+
+      class ValidationError
+        extend T::Sig
+        include Crystalline::MetadataFields
+
+
+        field :loc, Crystalline::Array.new(::String), { 'format_json': { 'letter_case': ::KintsugiSDK::Utils.field_name('loc'), required: true } }
+
+        field :msg, ::String, { 'format_json': { 'letter_case': ::KintsugiSDK::Utils.field_name('msg'), required: true } }
+
+        field :type, ::String, { 'format_json': { 'letter_case': ::KintsugiSDK::Utils.field_name('type'), required: true } }
+
+        sig { params(loc: T::Array[::String], msg: ::String, type: ::String).void }
+        def initialize(loc:, msg:, type:)
+          @loc = loc
+          @msg = msg
+          @type = type
+        end
+
+        sig { params(other: T.untyped).returns(T::Boolean) }
+        def ==(other)
+          return false unless other.is_a? self.class
+          return false unless @loc == other.loc
+          return false unless @msg == other.msg
+          return false unless @type == other.type
+          true
+        end
+      end
+    end
+  end
+end

data/lib/kintsugi_sdk/models/shared/validationerror.rbi

@@ -0,0 +1,17 @@
+# typed: true
+# frozen_string_literal: true
+
+
+class KintsugiSDK::Models::Shared::ValidationError
+  extend ::Crystalline::MetadataFields::ClassMethods
+end
+
+
+class KintsugiSDK::Models::Shared::ValidationError
+  def loc(); end
+  def loc=(str_); end
+  def msg(); end
+  def msg=(str_); end
+  def type(); end
+  def type=(str_); end
+end

data/lib/kintsugi_sdk/models/shared.rb

@@ -0,0 +1,104 @@
+# Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+
+# typed: true
+# frozen_string_literal: true
+
+module KintsugiSDK
+  module Models
+    module Shared
+      autoload :AddressBase, 'kintsugi_sdk/models/shared/addressbase.rb'
+      autoload :AddressResponseData, 'kintsugi_sdk/models/shared/addressresponsedata.rb'
+      autoload :AddressSearchResponse, 'kintsugi_sdk/models/shared/addresssearchresponse.rb'
+      autoload :AddressStatus, 'kintsugi_sdk/models/shared/addressstatus.rb'
+      autoload :AddressSubmittedResponse, 'kintsugi_sdk/models/shared/addresssubmittedresponse.rb'
+      autoload :AddressType, 'kintsugi_sdk/models/shared/addresstype.rb'
+      autoload :AppliedTo, 'kintsugi_sdk/models/shared/appliedto.rb'
+      autoload :AttachmentRead, 'kintsugi_sdk/models/shared/attachmentread.rb'
+      autoload :BodyUploadExemptionCertificateV1ExemptionsExemptionIdAttachmentsPost, 'kintsugi_sdk/models/shared/body_upload_exemption_certificate_v1_exemptions_exemption_id_attachments_post.rb'
+      autoload :CountryCodeEnum, 'kintsugi_sdk/models/shared/countrycodeenum.rb'
+      autoload :CurrencyEnum, 'kintsugi_sdk/models/shared/currencyenum.rb'
+      autoload :CustomerBase, 'kintsugi_sdk/models/shared/customerbase.rb'
+      autoload :CustomerBaseBase, 'kintsugi_sdk/models/shared/customerbasebase.rb'
+      autoload :CustomerBasePublic, 'kintsugi_sdk/models/shared/customerbasepublic.rb'
+      autoload :CustomerCreate, 'kintsugi_sdk/models/shared/customercreate.rb'
+      autoload :CustomerRead, 'kintsugi_sdk/models/shared/customerread.rb'
+      autoload :CustomerUpdate, 'kintsugi_sdk/models/shared/customerupdate.rb'
+      autoload :DiscountBuilder, 'kintsugi_sdk/models/shared/discountbuilder.rb'
+      autoload :Exemption, 'kintsugi_sdk/models/shared/exemption.rb'
+      autoload :ExemptionCreate, 'kintsugi_sdk/models/shared/exemptioncreate.rb'
+      autoload :ExemptionRequired, 'kintsugi_sdk/models/shared/exemptionrequired.rb'
+      autoload :ExemptionStatus, 'kintsugi_sdk/models/shared/exemptionstatus.rb'
+      autoload :ExemptionType, 'kintsugi_sdk/models/shared/exemptiontype.rb'
+      autoload :File, 'kintsugi_sdk/models/shared/file.rb'
+      autoload :JurisdictionType, 'kintsugi_sdk/models/shared/jurisdictiontype.rb'
+      autoload :NexusResponse, 'kintsugi_sdk/models/shared/nexusresponse.rb'
+      autoload :NexusStateEnum, 'kintsugi_sdk/models/shared/nexusstateenum.rb'
+      autoload :NexusStatusEnum, 'kintsugi_sdk/models/shared/nexusstatusenum.rb'
+      autoload :NexusTypeEnum, 'kintsugi_sdk/models/shared/nexustypeenum.rb'
+      autoload :PageCustomerRead, 'kintsugi_sdk/models/shared/page_customerread_.rb'
+      autoload :PageNexusResponse, 'kintsugi_sdk/models/shared/page_nexusresponse_.rb'
+      autoload :PageProductRead, 'kintsugi_sdk/models/shared/page_productread_.rb'
+      autoload :PageTransactionEstimateResponse, 'kintsugi_sdk/models/shared/page_transactionestimateresponse_.rb'
+      autoload :PageTransactionRead, 'kintsugi_sdk/models/shared/page_transactionread_.rb'
+      autoload :PeriodModelEnum, 'kintsugi_sdk/models/shared/periodmodelenum.rb'
+      autoload :ProcessingStatusEnum, 'kintsugi_sdk/models/shared/processingstatusenum.rb'
+      autoload :ProductCategories, 'kintsugi_sdk/models/shared/productcategories.rb'
+      autoload :ProductCategoryEnum, 'kintsugi_sdk/models/shared/productcategoryenum.rb'
+      autoload :ProductCodeEnum, 'kintsugi_sdk/models/shared/productcodeenum.rb'
+      autoload :ProductCreateManual, 'kintsugi_sdk/models/shared/productcreatemanual.rb'
+      autoload :ProductRead, 'kintsugi_sdk/models/shared/productread.rb'
+      autoload :ProductStatusEnum, 'kintsugi_sdk/models/shared/productstatusenum.rb'
+      autoload :ProductSubCategory, 'kintsugi_sdk/models/shared/productsubcategory.rb'
+      autoload :ProductSubCategoryEnum, 'kintsugi_sdk/models/shared/productsubcategoryenum.rb'
+      autoload :ProductUpdate, 'kintsugi_sdk/models/shared/productupdate.rb'
+      autoload :RegistrationsRegimeEnum, 'kintsugi_sdk/models/shared/registrationsregimeenum.rb'
+      autoload :RelatedEntityType, 'kintsugi_sdk/models/shared/relatedentitytype.rb'
+      autoload :SalesOrTransactionsEnum, 'kintsugi_sdk/models/shared/salesortransactionsenum.rb'
+      autoload :Security, 'kintsugi_sdk/models/shared/security.rb'
+      autoload :SourceEnum, 'kintsugi_sdk/models/shared/sourceenum.rb'
+      autoload :StatusEnum, 'kintsugi_sdk/models/shared/statusenum.rb'
+      autoload :TaxExemptionEnum, 'kintsugi_sdk/models/shared/taxexemptionenum.rb'
+      autoload :TaxItemBuilder, 'kintsugi_sdk/models/shared/taxitembuilder.rb'
+      autoload :TaxItemEstimate, 'kintsugi_sdk/models/shared/taxitemestimate.rb'
+      autoload :TaxItemRead, 'kintsugi_sdk/models/shared/taxitemread.rb'
+      autoload :TaxItemReturnReasonEnum, 'kintsugi_sdk/models/shared/taxitemreturnreasonenum.rb'
+      autoload :TaxItemTypeEnum, 'kintsugi_sdk/models/shared/taxitemtypeenum.rb'
+      autoload :TaxLiabilitySourceEnum, 'kintsugi_sdk/models/shared/taxliabilitysourceenum.rb'
+      autoload :TransactionAddressBuilder, 'kintsugi_sdk/models/shared/transactionaddressbuilder.rb'
+      autoload :TransactionAddressPublic, 'kintsugi_sdk/models/shared/transactionaddresspublic.rb'
+      autoload :TransactionAddressReadOutput, 'kintsugi_sdk/models/shared/transactionaddressread_output.rb'
+      autoload :TransactionCreate, 'kintsugi_sdk/models/shared/transactioncreate.rb'
+      autoload :TransactionEstimatePublicRequest, 'kintsugi_sdk/models/shared/transactionestimatepublicrequest.rb'
+      autoload :TransactionEstimateResponse, 'kintsugi_sdk/models/shared/transactionestimateresponse.rb'
+      autoload :TransactionEstimateResponseAddresses, 'kintsugi_sdk/models/shared/transactionestimateresponse_addresses.rb'
+      autoload :TransactionEstimateResponseType, 'kintsugi_sdk/models/shared/transactionestimateresponse_type.rb'
+      autoload :TransactionExemptStatusEnum, 'kintsugi_sdk/models/shared/transactionexemptstatusenum.rb'
+      autoload :TransactionItemBuilder, 'kintsugi_sdk/models/shared/transactionitembuilder.rb'
+      autoload :TransactionItemCreateUpdate, 'kintsugi_sdk/models/shared/transactionitemcreateupdate.rb'
+      autoload :TransactionItemEstimateBase, 'kintsugi_sdk/models/shared/transactionitemestimatebase.rb'
+      autoload :TransactionItemEstimateResponse, 'kintsugi_sdk/models/shared/transactionitemestimateresponse.rb'
+      autoload :TransactionItemRead, 'kintsugi_sdk/models/shared/transactionitemread.rb'
+      autoload :TransactionPublicRequest, 'kintsugi_sdk/models/shared/transactionpublicrequest.rb'
+      autoload :TransactionRead, 'kintsugi_sdk/models/shared/transactionread.rb'
+      autoload :TransactionRefundStatus, 'kintsugi_sdk/models/shared/transactionrefundstatus.rb'
+      autoload :TransactionStatusEnum, 'kintsugi_sdk/models/shared/transactionstatusenum.rb'
+      autoload :TransactionTypeEnum, 'kintsugi_sdk/models/shared/transactiontypeenum.rb'
+      autoload :TransactionUpdate, 'kintsugi_sdk/models/shared/transactionupdate.rb'
+      autoload :TreatmentEnum, 'kintsugi_sdk/models/shared/treatmentenum.rb'
+      autoload :ValidationAddress, 'kintsugi_sdk/models/shared/validationaddress.rb'
+      autoload :ValidationError, 'kintsugi_sdk/models/shared/validationerror.rb'
+      autoload :Addresses, 'kintsugi_sdk/models/shared/addresses.rb'
+      autoload :BackendSrcAddressValidationResponsesValidationErrorItem, 'kintsugi_sdk/models/shared/backend_src_address_validation_responses_validationerroritem.rb'
+      autoload :BackendSrcCustomersResponsesValidationErrorItem, 'kintsugi_sdk/models/shared/backend_src_customers_responses_validationerroritem.rb'
+      autoload :BackendSrcExemptionsModelsExemptionRead, 'kintsugi_sdk/models/shared/backend_src_exemptions_models_exemptionread.rb'
+      autoload :BackendSrcExemptionsResponsesValidationErrorItem, 'kintsugi_sdk/models/shared/backend_src_exemptions_responses_validationerroritem.rb'
+      autoload :BackendSrcExemptionsSerializersExemptionRead, 'kintsugi_sdk/models/shared/backend_src_exemptions_serializers_exemptionread.rb'
+      autoload :BackendSrcProductsResponsesValidationErrorItem, 'kintsugi_sdk/models/shared/backend_src_products_responses_validationerroritem.rb'
+      autoload :BackendSrcTaxEstimationResponsesValidationErrorItem, 'kintsugi_sdk/models/shared/backend_src_tax_estimation_responses_validationerroritem.rb'
+      autoload :BackendSrcTransactionsResponsesValidationErrorItem, 'kintsugi_sdk/models/shared/backend_src_transactions_responses_validationerroritem.rb'
+      autoload :FastapiPaginationDefaultPageExemptionRead2, 'kintsugi_sdk/models/shared/fastapi_pagination_default_page_exemptionread_2.rb'
+      autoload :Registration, 'kintsugi_sdk/models/shared/registration.rb'
+      autoload :Type, 'kintsugi_sdk/models/shared/type.rb'
+    end
+  end
+end

data/lib/kintsugi_sdk/nexus.rb

@@ -0,0 +1,155 @@
+# Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+
+# typed: true
+# frozen_string_literal: true
+
+require 'faraday'
+require 'faraday/multipart'
+require 'faraday/retry'
+require 'sorbet-runtime'
+require_relative 'sdk_hooks/hooks'
+require_relative 'utils/retries'
+
+module KintsugiSDK
+  extend T::Sig
+  class Nexus
+    extend T::Sig
+    
+
+
+    sig { params(sdk_config: SDKConfiguration).void }
+    def initialize(sdk_config)
+      @sdk_configuration = sdk_config
+      
+    end
+
+    sig { params(base_url: String, url_variables: T.nilable(T::Hash[Symbol, T.any(String, T::Enum)])).returns(String) }
+    def get_url(base_url:, url_variables: nil)
+      sd_base_url, sd_options = @sdk_configuration.get_server_details
+
+      if base_url.nil?
+        base_url = sd_base_url
+      end
+
+      if url_variables.nil?
+        url_variables = sd_options
+      end
+
+      return Utils.template_url base_url, url_variables
+    end
+
+
+    sig { params(request: Models::Ops::GetNexusForOrgV1NexusGetRequest, timeout_ms: T.nilable(Integer)).returns(Models::Shared::PageNexusResponse) }
+    def list(request:, timeout_ms: nil)
+      # list - Get Nexus For Org
+      # Get a list of all nexuses for the organization.
+      url, params = @sdk_configuration.get_server_details
+      base_url = Utils.template_url(url, params)
+      url = "#{base_url}/v1/nexus"
+      headers = {}
+      headers = T.cast(headers, T::Hash[String, String])
+      query_params = Utils.get_query_params(Models::Ops::GetNexusForOrgV1NexusGetRequest, request, nil)
+      headers['Accept'] = 'application/json'
+      headers['user-agent'] = @sdk_configuration.user_agent
+
+      security = @sdk_configuration.security_source&.call
+
+      timeout = (timeout_ms.to_f / 1000) unless timeout_ms.nil?
+      timeout ||= @sdk_configuration.timeout
+      
+
+      connection = @sdk_configuration.client
+
+      hook_ctx = SDKHooks::HookContext.new(
+        config: @sdk_configuration,
+        base_url: base_url,
+        oauth2_scopes: [],
+        operation_id: 'get_nexus_for_org_v1_nexus_get',
+        security_source: @sdk_configuration.security_source
+      )
+
+      error = T.let(nil, T.nilable(StandardError))
+      http_response = T.let(nil, T.nilable(Faraday::Response))
+      
+      
+      begin
+        http_response = T.must(connection).get(url) do |req|
+          req.headers.merge!(headers)
+          req.options.timeout = timeout unless timeout.nil?
+          req.params = query_params
+          Utils.configure_request_security(req, security)
+
+          @sdk_configuration.hooks.before_request(
+            hook_ctx: SDKHooks::BeforeRequestHookContext.new(
+              hook_ctx: hook_ctx
+            ),
+            request: req
+          )
+        end
+      rescue StandardError => e
+        error = e
+      ensure
+        if http_response.nil? || Utils.error_status?(http_response.status)
+          http_response = @sdk_configuration.hooks.after_error(
+            error: error,
+            hook_ctx: SDKHooks::AfterErrorHookContext.new(
+              hook_ctx: hook_ctx
+            ),
+            response: http_response
+          )
+        else
+          http_response = @sdk_configuration.hooks.after_success(
+            hook_ctx: SDKHooks::AfterSuccessHookContext.new(
+              hook_ctx: hook_ctx
+            ),
+            response: http_response
+          )
+        end
+        
+        if http_response.nil?
+          raise error if !error.nil?
+          raise 'no response'
+        end
+      end
+      
+      content_type = http_response.headers.fetch('Content-Type', 'application/octet-stream')
+      if Utils.match_status_code(http_response.status, ['200'])
+        if Utils.match_content_type(content_type, 'application/json')
+          @sdk_configuration.hooks.after_success(
+            hook_ctx: SDKHooks::AfterSuccessHookContext.new(
+              hook_ctx: hook_ctx
+            ),
+            response: http_response
+          )
+          response_data = http_response.env.response_body
+          obj = Crystalline.unmarshal_json(JSON.parse(response_data), Models::Shared::PageNexusResponse)
+
+          return obj
+        else
+          raise ::KintsugiSDK::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'Unknown content type received'
+        end
+      elsif Utils.match_status_code(http_response.status, ['422'])
+        if Utils.match_content_type(content_type, 'application/json')
+          @sdk_configuration.hooks.after_success(
+            hook_ctx: SDKHooks::AfterSuccessHookContext.new(
+              hook_ctx: hook_ctx
+            ),
+            response: http_response
+          )
+          response_data = http_response.env.response_body
+          obj = Crystalline.unmarshal_json(JSON.parse(response_data), Models::Errors::HTTPValidationError)
+          throw obj
+        else
+          raise ::KintsugiSDK::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'Unknown content type received'
+        end
+      elsif Utils.match_status_code(http_response.status, ['4XX'])
+        raise ::KintsugiSDK::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'API error occurred'
+      elsif Utils.match_status_code(http_response.status, ['5XX'])
+        raise ::KintsugiSDK::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'API error occurred'
+      else
+        raise ::KintsugiSDK::Models::Errors::APIError.new(status_code: http_response.status, body: http_response.env.response_body, raw_response: http_response), 'Unknown status code received'
+
+      end
+    end
+  end
+end

data/lib/kintsugi_sdk/openapisdk.rb

@@ -0,0 +1,104 @@
+# Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+
+# typed: true
+# frozen_string_literal: true
+
+require 'faraday'
+require 'faraday/multipart'
+require 'faraday/retry'
+require 'sorbet-runtime'
+require_relative 'sdk_hooks/hooks'
+require_relative 'utils/retries'
+
+module KintsugiSDK
+  extend T::Sig
+
+  class OpenApiSDK
+    extend T::Sig
+
+    attr_accessor :address_validation, :customers, :exemptions, :nexus, :products, :transactions, :tax_estimation
+
+    sig do
+      params(
+        client: T.nilable(Faraday::Connection),
+        retry_config: T.nilable(::KintsugiSDK::Utils::RetryConfig),
+        timeout_ms: T.nilable(Integer),
+        security: T.nilable(Models::Shared::Security),
+        security_source: T.nilable(T.proc.returns(Models::Shared::Security)),
+        server_idx: T.nilable(Integer),
+        server_url: T.nilable(String),
+        url_params: T.nilable(T::Hash[Symbol, String])
+      ).void
+    end
+    def initialize(client: nil, retry_config: nil, timeout_ms: nil, security: nil, security_source: nil, server_idx: nil, server_url: nil, url_params: nil)
+      ## Instantiates the SDK configuring it with the provided parameters.
+      # @param [T.nilable(Faraday::Connection)] client The faraday HTTP client to use for all operations
+      # @param [T.nilable(::KintsugiSDK::Utils::RetryConfig)] retry_config The retry configuration to use for all operations
+      # @param [T.nilable(Integer)] timeout_ms Request timeout in milliseconds for all operations
+      # @param [T.nilable(Models::Shared::Security)] security: The security details required for authentication
+      # @param [T.proc.returns(T.nilable(Models::Shared::Security))] security_source: A function that returns security details required for authentication
+      # @param [T.nilable(::Integer)] server_idx The index of the server to use for all operations
+      # @param [T.nilable(::String)] server_url The server URL to use for all operations
+      # @param [T.nilable(::Hash<::Symbol, ::String>)] url_params Parameters to optionally template the server URL with
+
+      connection_options = {
+        request: {
+          params_encoder: Faraday::FlatParamsEncoder
+        }
+      }
+      connection_options[:request][:timeout] = (timeout_ms.to_f / 1000) unless timeout_ms.nil?
+
+      client ||= Faraday.new(**connection_options) do |f|
+        f.request :multipart, {}
+        # f.response :logger, nil, { headers: true, bodies: true, errors: true }
+      end
+      
+      if !server_url.nil?
+        if !url_params.nil?
+          server_url = Utils.template_url(server_url, url_params)
+        end
+      end
+
+      server_idx = 0 if server_idx.nil?
+      hooks = SDKHooks::Hooks.new
+      @sdk_configuration = SDKConfiguration.new(
+        client,
+        hooks,
+        retry_config,
+        timeout_ms,
+        security,
+        security_source,
+        server_url,
+        server_idx
+      )
+      @sdk_configuration = hooks.sdk_init(config: @sdk_configuration)
+      init_sdks
+    end
+
+    sig { void }
+    def init_sdks
+      @address_validation = AddressValidation.new(@sdk_configuration)
+      @customers = Customers.new(@sdk_configuration)
+      @exemptions = Exemptions.new(@sdk_configuration)
+      @nexus = Nexus.new(@sdk_configuration)
+      @products = Products.new(@sdk_configuration)
+      @transactions = Transactions.new(@sdk_configuration)
+      @tax_estimation = TaxEstimation.new(@sdk_configuration)
+    end
+
+    sig { params(base_url: String, url_variables: T.nilable(T::Hash[Symbol, T.any(String, T::Enum)])).returns(String) }
+    def get_url(base_url:, url_variables: nil)
+      sd_base_url, sd_options = @sdk_configuration.get_server_details
+
+      if base_url.nil?
+        base_url = sd_base_url
+      end
+
+      if url_variables.nil?
+        url_variables = sd_options
+      end
+
+      return Utils.template_url base_url, url_variables
+    end
+  end
+end