kintsugi_sdk 5.6.1 → 5.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 01dc6b44526f591a090a16bd42c48d838a75a72c6699abb75083c998ec6dc005
-  data.tar.gz: 6e77246bf663ad87704bd5e42b225c3ad3235de728e4531d3eaac302754e5ed5
+  metadata.gz: 9e1f8dca0f19bcb61d969611b43a34b907b7f5968efc490336f22d3bc87f8e4e
+  data.tar.gz: 17f55c88ccddcc090fafe079fa8cc7f8744e0672394799181f053aa438b2737f
 SHA512:
-  metadata.gz: c6ebbf8344599e17cbf97e52663c7b02f75f33749edc2af94fac1194306407fd5c520b3f87fbf08261db74e0668740b5e065e697e3125af38d7ee324a09d8a8b
-  data.tar.gz: 23614642b7ef742ae64adcdf75a3428afa55b2857ed7fa67e1b2310ab35a09b3268a266c67b16d00cba205a1f5c9d1bc444218fdb34fb8c469907472a5558dbd
+  metadata.gz: 34e521af35ffe584ef2f76dc344663e663cbf14331e4a27ece8a7276f7f218c2d2748b968a3f488eb0b35f02ffab9c7ce1f9ffcac3d1b2472d6bcb0eacd698a3
+  data.tar.gz: 6c3d152232b9c0d2e29ecadc1526d58b63a35c011c8a4e965ae9a5aaff68fa658a4c55fe3a38ce9f26337613ae591aa6e54d252939dac174a89c03c6416852b6

data/lib/kintsugi_sdk/addressvalidation.rb

@@ -41,8 +41,8 @@ module KintsugiSDK
 
 
 
-    sig { params(security: Models::Ops::SearchV1AddressValidationSearchPostSecurity, request: Models::Shared::AddressBase, timeout_ms: T.nilable(Integer), http_headers: T.nilable(T::Hash[T.any(String, Symbol), String])).returns(T::Array[Models::Shared::AddressSearchResponse]) }
-    def search(security:, request:, timeout_ms: nil, http_headers: nil)
+    sig { params(request: Models::Shared::AddressBase, timeout_ms: T.nilable(Integer), http_headers: T.nilable(T::Hash[T.any(String, Symbol), String])).returns(T::Array[Models::Shared::AddressSearchResponse]) }
+    def search(request:, timeout_ms: nil, http_headers: nil)
       # search - Search
       # This API validates and enriches address information
       #     submitted by the user. It ensures that the address is standardized, accurate,
@@ -67,6 +67,8 @@ module KintsugiSDK
       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
 
@@ -78,7 +80,7 @@ module KintsugiSDK
         base_url: base_url,
         oauth2_scopes: nil,
         operation_id: 'search_v1_address_validation_search_post',
-        security_source: -> { security }
+        security_source: @sdk_configuration.security_source
       )
 
       error = T.let(nil, T.nilable(StandardError))
@@ -197,7 +199,7 @@ module KintsugiSDK
     end
 
 
-    sig { params(request: Models::Shared::ValidationAddress, timeout_ms: T.nilable(Integer), http_headers: T.nilable(T::Hash[T.any(String, Symbol), String])).returns(::Object) }
+    sig { params(request: Models::Ops::SuggestionsV1AddressValidationSuggestionsPostRequest, timeout_ms: T.nilable(Integer), http_headers: T.nilable(T::Hash[T.any(String, Symbol), String])).returns(::Object) }
     def suggestions(request:, timeout_ms: nil, http_headers: nil)
       # suggestions - Suggestions
       # This API endpoint provides address suggestions based on
@@ -208,9 +210,9 @@ module KintsugiSDK
       url, params = @sdk_configuration.get_server_details
       base_url = Utils.template_url(url, params)
       url = "#{base_url}/v1/address_validation/suggestions"
-      headers = {}
+      headers = Utils.get_headers(request)
       headers = T.cast(headers, T::Hash[String, String])
-      req_content_type, data, form = Utils.serialize_request_body(request, false, false, :request, :json)
+      req_content_type, data, form = Utils.serialize_request_body(request, false, false, :validation_address, :json)
       headers['content-type'] = req_content_type
       raise StandardError, 'request body is required' if data.nil? && form.nil?
 

data/lib/kintsugi_sdk/customers.rb

@@ -43,14 +43,14 @@ module KintsugiSDK
 
     sig { params(request: Models::Ops::GetCustomersV1Request, timeout_ms: T.nilable(Integer), http_headers: T.nilable(T::Hash[T.any(String, Symbol), String])).returns(Models::Shared::PageCustomerRead) }
     def list(request:, timeout_ms: nil, http_headers: nil)
-      # list - Get Customers
+      # list - Get customers
       # The Get Customers API retrieves
       #     a paginated list of customers based on specified filters.
       #     This API allows searching, filtering by country and state, and sorting the results.
       url, params = @sdk_configuration.get_server_details
       base_url = Utils.template_url(url, params)
       url = "#{base_url}/v1/customers"
-      headers = {}
+      headers = Utils.get_headers(request)
       headers = T.cast(headers, T::Hash[String, String])
       query_params = Utils.get_query_params(Models::Ops::GetCustomersV1Request, request, nil)
       headers['Accept'] = 'application/json'
@@ -188,17 +188,17 @@ module KintsugiSDK
     end
 
 
-    sig { params(request: Models::Shared::CustomerCreate, timeout_ms: T.nilable(Integer), http_headers: T.nilable(T::Hash[T.any(String, Symbol), String])).returns(Models::Shared::CustomerRead) }
+    sig { params(request: Models::Ops::CreateCustomerV1CustomersPostRequest, timeout_ms: T.nilable(Integer), http_headers: T.nilable(T::Hash[T.any(String, Symbol), String])).returns(Models::Shared::CustomerRead) }
     def create(request:, timeout_ms: nil, http_headers: nil)
-      # create - Create Customer
+      # create - Create customer
       # The Create Customer API enables the creation of a new customer record with essential
       # details like name, contact information, and address, along with optional metadata.
       url, params = @sdk_configuration.get_server_details
       base_url = Utils.template_url(url, params)
       url = "#{base_url}/v1/customers"
-      headers = {}
+      headers = Utils.get_headers(request)
       headers = T.cast(headers, T::Hash[String, String])
-      req_content_type, data, form = Utils.serialize_request_body(request, false, false, :request, :json)
+      req_content_type, data, form = Utils.serialize_request_body(request, false, false, :customer_create, :json)
       headers['content-type'] = req_content_type
       raise StandardError, 'request body is required' if data.nil? && form.nil?
 
@@ -344,21 +344,21 @@ module KintsugiSDK
     end
 
 
-    sig { params(request: Models::Ops::GetCustomerByIdV1CustomersCustomerIdGetRequest, timeout_ms: T.nilable(Integer), http_headers: T.nilable(T::Hash[T.any(String, Symbol), String])).returns(Models::Shared::CustomerRead) }
-    def get(request:, timeout_ms: nil, http_headers: nil)
-      # get - Get Customer By Id
-      # The Get Customer By ID API retrieves the details of a single customer
-      #     using their unique identifier. It returns customer-specific data,
-      #     including contact information, address, name and metadata, etc.
+    sig { params(request: Models::Ops::GetCustomerByExternalIdV1CustomersExternalExternalIdGetRequest, timeout_ms: T.nilable(Integer), http_headers: T.nilable(T::Hash[T.any(String, Symbol), String])).returns(Models::Shared::CustomerRead) }
+    def get_by_external_id(request:, timeout_ms: nil, http_headers: nil)
+      # get_by_external_id - Get customer by external id
+      # The Get Customer By External ID API retrieves the details of a single customer using
+      # their external identifier. This endpoint is useful for accessing customer data when only
+      # an external ID is available.
       url, params = @sdk_configuration.get_server_details
       base_url = Utils.template_url(url, params)
       url = Utils.generate_url(
-        Models::Ops::GetCustomerByIdV1CustomersCustomerIdGetRequest,
+        Models::Ops::GetCustomerByExternalIdV1CustomersExternalExternalIdGetRequest,
         base_url,
-        '/v1/customers/{customer_id}',
+        '/v1/customers/external/{external_id}',
         request
       )
-      headers = {}
+      headers = Utils.get_headers(request)
       headers = T.cast(headers, T::Hash[String, String])
       headers['Accept'] = 'application/json'
       headers['user-agent'] = @sdk_configuration.user_agent
@@ -375,7 +375,7 @@ module KintsugiSDK
         config: @sdk_configuration,
         base_url: base_url,
         oauth2_scopes: nil,
-        operation_id: 'get_customer_by_id_v1_customers__customer_id__get',
+        operation_id: 'get_customer_by_external_id_v1_customers_external__external_id__get',
         security_source: @sdk_configuration.security_source
       )
 
@@ -466,33 +466,22 @@ module KintsugiSDK
     end
 
 
-    sig { params(request: Models::Ops::UpdateCustomerV1CustomersCustomerIdPutRequest, timeout_ms: T.nilable(Integer), http_headers: T.nilable(T::Hash[T.any(String, Symbol), String])).returns(Models::Shared::CustomerRead) }
-    def update(request:, timeout_ms: nil, http_headers: nil)
-      # update - Update Customer
-      # The Update Customer API allows you to modify an existing customer's
-      #     information using their unique identifier,
-      #     enabling updates to their details as needed.
+    sig { params(request: Models::Ops::GetCustomerByIdV1CustomersCustomerIdGetRequest, timeout_ms: T.nilable(Integer), http_headers: T.nilable(T::Hash[T.any(String, Symbol), String])).returns(Models::Shared::CustomerRead) }
+    def get(request:, timeout_ms: nil, http_headers: nil)
+      # get - Get customer by id
+      # The Get Customer By ID API retrieves the details of a single customer
+      #     using their unique identifier. It returns customer-specific data,
+      #     including contact information, address, name and metadata, etc.
       url, params = @sdk_configuration.get_server_details
       base_url = Utils.template_url(url, params)
       url = Utils.generate_url(
-        Models::Ops::UpdateCustomerV1CustomersCustomerIdPutRequest,
+        Models::Ops::GetCustomerByIdV1CustomersCustomerIdGetRequest,
         base_url,
         '/v1/customers/{customer_id}',
         request
       )
-      headers = {}
+      headers = Utils.get_headers(request)
       headers = T.cast(headers, T::Hash[String, String])
-      req_content_type, data, form = Utils.serialize_request_body(request, false, false, :customer_update, :json)
-      headers['content-type'] = req_content_type
-      raise StandardError, 'request body is required' if data.nil? && form.nil?
-
-      if form && !form.empty?
-        body = Utils.encode_form(form)
-      elsif Utils.match_content_type(req_content_type, 'application/x-www-form-urlencoded')
-        body = URI.encode_www_form(T.cast(data, T::Hash[Symbol, Object]))
-      else
-        body = data
-      end
       headers['Accept'] = 'application/json'
       headers['user-agent'] = @sdk_configuration.user_agent
 
@@ -508,7 +497,7 @@ module KintsugiSDK
         config: @sdk_configuration,
         base_url: base_url,
         oauth2_scopes: nil,
-        operation_id: 'update_customer_v1_customers__customer_id__put',
+        operation_id: 'get_customer_by_id_v1_customers__customer_id__get',
         security_source: @sdk_configuration.security_source
       )
 
@@ -517,8 +506,7 @@ module KintsugiSDK
       
 
       begin
-        http_response = T.must(connection).put(url) do |req|
-          req.body = body
+        http_response = T.must(connection).get(url) do |req|
           req.headers.merge!(headers)
           req.options.timeout = timeout unless timeout.nil?
           Utils.configure_request_security(req, security)
@@ -575,20 +563,6 @@ module KintsugiSDK
         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, ['401', '404'])
-        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::ErrorResponse)
-          raise 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(
@@ -598,26 +572,12 @@ module KintsugiSDK
             response: http_response
           )
           response_data = http_response.env.response_body
-          obj = Crystalline.unmarshal_json(JSON.parse(response_data), Models::Errors::BackendSrcCustomersResponsesValidationErrorResponse)
-          raise 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, ['500'])
-        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::ErrorResponse)
+          obj = Crystalline.unmarshal_json(JSON.parse(response_data), Models::Errors::HTTPValidationError)
           raise 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'])
+      elsif Utils.match_status_code(http_response.status, ['404', '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'
@@ -628,22 +588,33 @@ module KintsugiSDK
     end
 
 
-    sig { params(request: Models::Ops::GetCustomerByExternalIdV1CustomersExternalExternalIdGetRequest, timeout_ms: T.nilable(Integer), http_headers: T.nilable(T::Hash[T.any(String, Symbol), String])).returns(Models::Shared::CustomerRead) }
-    def get_by_external_id(request:, timeout_ms: nil, http_headers: nil)
-      # get_by_external_id - Get Customer By External Id
-      # The Get Customer By External ID API retrieves the details of a single customer using
-      # their external identifier. This endpoint is useful for accessing customer data when only
-      # an external ID is available.
+    sig { params(request: Models::Ops::UpdateCustomerV1CustomersCustomerIdPutRequest, timeout_ms: T.nilable(Integer), http_headers: T.nilable(T::Hash[T.any(String, Symbol), String])).returns(Models::Shared::CustomerRead) }
+    def update(request:, timeout_ms: nil, http_headers: nil)
+      # update - Update customer
+      # The Update Customer API allows you to modify an existing customer's
+      #     information using their unique identifier,
+      #     enabling updates to their details as needed.
       url, params = @sdk_configuration.get_server_details
       base_url = Utils.template_url(url, params)
       url = Utils.generate_url(
-        Models::Ops::GetCustomerByExternalIdV1CustomersExternalExternalIdGetRequest,
+        Models::Ops::UpdateCustomerV1CustomersCustomerIdPutRequest,
         base_url,
-        '/v1/customers/external/{external_id}',
+        '/v1/customers/{customer_id}',
         request
       )
-      headers = {}
+      headers = Utils.get_headers(request)
       headers = T.cast(headers, T::Hash[String, String])
+      req_content_type, data, form = Utils.serialize_request_body(request, false, false, :customer_update, :json)
+      headers['content-type'] = req_content_type
+      raise StandardError, 'request body is required' if data.nil? && form.nil?
+
+      if form && !form.empty?
+        body = Utils.encode_form(form)
+      elsif Utils.match_content_type(req_content_type, 'application/x-www-form-urlencoded')
+        body = URI.encode_www_form(T.cast(data, T::Hash[Symbol, Object]))
+      else
+        body = data
+      end
       headers['Accept'] = 'application/json'
       headers['user-agent'] = @sdk_configuration.user_agent
 
@@ -659,7 +630,7 @@ module KintsugiSDK
         config: @sdk_configuration,
         base_url: base_url,
         oauth2_scopes: nil,
-        operation_id: 'get_customer_by_external_id_v1_customers_external__external_id__get',
+        operation_id: 'update_customer_v1_customers__customer_id__put',
         security_source: @sdk_configuration.security_source
       )
 
@@ -668,7 +639,8 @@ module KintsugiSDK
       
 
       begin
-        http_response = T.must(connection).get(url) do |req|
+        http_response = T.must(connection).put(url) do |req|
+          req.body = body
           req.headers.merge!(headers)
           req.options.timeout = timeout unless timeout.nil?
           Utils.configure_request_security(req, security)
@@ -725,6 +697,20 @@ module KintsugiSDK
         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, ['401', '404'])
+        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::ErrorResponse)
+          raise 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(
@@ -734,12 +720,26 @@ module KintsugiSDK
             response: http_response
           )
           response_data = http_response.env.response_body
-          obj = Crystalline.unmarshal_json(JSON.parse(response_data), Models::Errors::HTTPValidationError)
+          obj = Crystalline.unmarshal_json(JSON.parse(response_data), Models::Errors::BackendSrcCustomersResponsesValidationErrorResponse)
           raise 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, ['404', '4XX'])
+      elsif Utils.match_status_code(http_response.status, ['500'])
+        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::ErrorResponse)
+          raise 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'
@@ -750,10 +750,10 @@ module KintsugiSDK
     end
 
 
-    sig { params(request: Models::Ops::GetTransactionsByCustomerRequest, timeout_ms: T.nilable(Integer), http_headers: T.nilable(T::Hash[T.any(String, Symbol), String])).returns(T::Array[Models::Shared::TransactionRead]) }
+    sig { params(request: Models::Ops::GetTransactionsByCustomerRequest, timeout_ms: T.nilable(Integer), http_headers: T.nilable(T::Hash[T.any(String, Symbol), String])).returns(T.any(T::Array[Models::Shared::TransactionRead], Models::Shared::PageTransactionRead)) }
     def get_transactions(request:, timeout_ms: nil, http_headers: nil)
-      # get_transactions - Get Transactions By Customer Id
-      # Get a list of transactions for a customer by their unique ID.
+      # get_transactions - Get transactions by customer id
+      # Get a list of transactions for a customer by their unique ID. When pagination params are provided, this endpoint returns a paginated response. When omitted, it returns the legacy list response format (deprecated).
       url, params = @sdk_configuration.get_server_details
       base_url = Utils.template_url(url, params)
       url = Utils.generate_url(
@@ -762,8 +762,9 @@ module KintsugiSDK
         '/v1/customers/{customer_id}/transactions',
         request
       )
-      headers = {}
+      headers = Utils.get_headers(request)
       headers = T.cast(headers, T::Hash[String, String])
+      query_params = Utils.get_query_params(Models::Ops::GetTransactionsByCustomerRequest, request, nil)
       headers['Accept'] = 'application/json'
       headers['user-agent'] = @sdk_configuration.user_agent
 
@@ -791,6 +792,7 @@ module KintsugiSDK
         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)
           http_headers&.each do |key, value|
             req.headers[key.to_s] = value
@@ -839,7 +841,7 @@ module KintsugiSDK
             response: http_response
           )
           response_data = http_response.env.response_body
-          obj = Crystalline.unmarshal_json(JSON.parse(response_data), Crystalline::Array.new(Models::Shared::TransactionRead))
+          obj = Crystalline.unmarshal_json(JSON.parse(response_data), Crystalline::Union.new(Crystalline::Array.new(Models::Shared::TransactionRead), Models::Shared::PageTransactionRead))
 
           return obj
         else
@@ -872,7 +874,7 @@ module KintsugiSDK
 
     sig { params(request: Models::Ops::CreateTransactionByCustomerRequest, timeout_ms: T.nilable(Integer), http_headers: T.nilable(T::Hash[T.any(String, Symbol), String])).returns(Models::Shared::TransactionRead) }
     def create_transaction(request:, timeout_ms: nil, http_headers: nil)
-      # create_transaction - Create Transaction By Customer Id
+      # create_transaction - Create transaction by customer id
       # Create a new transaction for a specific customer.
       url, params = @sdk_configuration.get_server_details
       base_url = Utils.template_url(url, params)
@@ -882,7 +884,7 @@ module KintsugiSDK
         '/v1/customers/{customer_id}/transactions',
         request
       )
-      headers = {}
+      headers = Utils.get_headers(request)
       headers = T.cast(headers, T::Hash[String, String])
       req_content_type, data, form = Utils.serialize_request_body(request, false, false, :transaction_create, :json)
       headers['content-type'] = req_content_type