univapay-apimatic-sdk 0.0.1

data/lib/univapay_client_sdk/logging/configuration/api_logging_configuration.rb

@@ -0,0 +1,186 @@
+# univapay_client_sdk
+#
+# This file was automatically generated for Univapay
+# by APIMATIC v3.0 ( https://www.apimatic.io ).
+
+module UnivapayClientSdk
+  # Initializes a new instance of RequestLoggingConfiguration.
+  class RequestLoggingConfiguration < CoreLibrary::ApiRequestLoggingConfiguration
+    # @param log_body [Boolean] Indicates whether the message body should be logged. Default is false.
+    # @param log_headers [Boolean] Indicates whether the message headers should be logged. Default is false.
+    # @param headers_to_exclude [Array<String>] Array of headers not displayed in logging. Default is an empty array.
+    # @param headers_to_include [Array<String>] Array of headers to be displayed in logging. Default is an empty array.
+    # @param headers_to_unmask [Array<String>] Array of headers which values are non-sensitive to display in logging.
+    #   Default is an empty array.
+    def initialize(log_body: false, log_headers: false, headers_to_include: nil,
+                   headers_to_exclude: nil, headers_to_unmask: nil,
+                   include_query_in_path: false)
+      super(
+        log_body,
+        log_headers,
+        headers_to_exclude,
+        headers_to_include,
+        headers_to_unmask,
+        include_query_in_path
+      )
+    end
+
+    def clone_with(log_body: nil, log_headers: nil, headers_to_include: nil,
+                   headers_to_exclude: nil, headers_to_unmask: nil, include_query_in_path: nil)
+      log_body ||= self.log_body
+      log_headers ||= self.log_headers
+      headers_to_include ||= self.headers_to_include
+      headers_to_exclude ||= self.headers_to_exclude
+      headers_to_unmask ||= self.headers_to_unmask
+      include_query_in_path ||= self.include_query_in_path
+
+      RequestLoggingConfiguration.new(
+        log_body: log_body,
+        log_headers: log_headers,
+        headers_to_include: headers_to_include,
+        headers_to_exclude: headers_to_exclude,
+        headers_to_unmask: headers_to_unmask,
+        include_query_in_path: include_query_in_path
+      )
+    end
+
+    def self.from_env
+      log_body = ENV['REQUEST_LOG_BODY']
+      log_headers = ENV['REQUEST_LOG_HEADERS']
+      headers_to_include = ENV['REQUEST_HEADERS_TO_INCLUDE']
+      headers_to_exclude = ENV['REQUEST_HEADERS_TO_EXCLUDE']
+      headers_to_unmask = ENV['REQUEST_HEADERS_TO_UNMASK']
+      include_query_in_path = ENV['REQUEST_INCLUDE_QUERY_IN_PATH']
+
+      new(
+        log_body: log_body,
+        log_headers: log_headers,
+        headers_to_include: headers_to_include,
+        headers_to_exclude: headers_to_exclude,
+        headers_to_unmask: headers_to_unmask,
+        include_query_in_path: include_query_in_path
+      )
+    end
+
+    def self.any_logging_configured?
+      %w[
+        REQUEST_LOG_BODY
+        REQUEST_LOG_HEADERS
+        REQUEST_HEADERS_TO_INCLUDE
+        REQUEST_HEADERS_TO_EXCLUDE
+        REQUEST_HEADERS_TO_UNMASK
+        REQUEST_INCLUDE_QUERY_IN_PATH
+      ].any? { |key| ENV.key?(key) && !ENV[key].nil? && !ENV[key].empty? }
+    end
+  end
+
+  # Initializes a new instance of ResponseLoggingConfiguration.
+  class ResponseLoggingConfiguration < CoreLibrary::ApiResponseLoggingConfiguration
+    def initialize(log_body: false, log_headers: false, headers_to_include: nil,
+                   headers_to_exclude: nil, headers_to_unmask: nil)
+      super(
+        log_body,
+        log_headers,
+        headers_to_exclude,
+        headers_to_include,
+        headers_to_unmask
+      )
+    end
+
+    def clone_with(log_body: nil, log_headers: nil, headers_to_include: nil,
+                   headers_to_exclude: nil, headers_to_unmask: nil)
+      log_body ||= self.log_body
+      log_headers ||= self.log_headers
+      headers_to_include ||= self.headers_to_include
+      headers_to_exclude ||= self.headers_to_exclude
+      headers_to_unmask ||= self.headers_to_unmask
+
+      ResponseLoggingConfiguration.new(
+        log_body: log_body,
+        log_headers: log_headers,
+        headers_to_include: headers_to_include,
+        headers_to_exclude: headers_to_exclude,
+        headers_to_unmask: headers_to_unmask
+      )
+    end
+
+    def self.from_env
+      log_body = ENV['RESPONSE_LOG_BODY']
+      log_headers = ENV['RESPONSE_LOG_HEADERS']
+      headers_to_include = ENV['RESPONSE_HEADERS_TO_INCLUDE']
+      headers_to_exclude = ENV['RESPONSE_HEADERS_TO_EXCLUDE']
+      headers_to_unmask = ENV['RESPONSE_HEADERS_TO_UNMASK']
+
+      new(
+        log_body: log_body,
+        log_headers: log_headers,
+        headers_to_include: headers_to_include,
+        headers_to_exclude: headers_to_exclude,
+        headers_to_unmask: headers_to_unmask
+      )
+    end
+
+    def self.any_logging_configured?
+      %w[
+        RESPONSE_LOG_BODY
+        RESPONSE_LOG_HEADERS
+        RESPONSE_HEADERS_TO_INCLUDE
+        RESPONSE_HEADERS_TO_EXCLUDE
+        RESPONSE_HEADERS_TO_UNMASK
+      ].any? { |key| ENV.key?(key) && !ENV[key].nil? && !ENV[key].empty? }
+    end
+  end
+
+  # Initializes a new instance of LoggingConfiguration.
+  class LoggingConfiguration < CoreLibrary::ApiLoggingConfiguration
+    def initialize(logger: nil, log_level: nil, mask_sensitive_headers: true,
+                   request_logging_config: nil,
+                   response_logging_config: nil)
+      request_logging_config ||= RequestLoggingConfiguration.new
+      response_logging_config ||= ResponseLoggingConfiguration.new
+      super(
+        logger,
+        log_level,
+        request_logging_config,
+        response_logging_config,
+        mask_sensitive_headers
+      )
+    end
+
+    def clone_with(logger: nil, log_level: nil, mask_sensitive_headers: nil,
+                   request_logging_config: nil, response_logging_config: nil)
+      logger ||= self.logger
+      log_level ||= self.log_level
+      mask_sensitive_headers ||= self.mask_sensitive_headers
+      request_logging_config ||= self.request_logging_config.clone
+      response_logging_config ||= self.response_logging_config.clone
+
+      LoggingConfiguration.new(
+        logger: logger,
+        log_level: log_level,
+        mask_sensitive_headers: mask_sensitive_headers,
+        request_logging_config: request_logging_config,
+        response_logging_config: response_logging_config
+      )
+    end
+
+    def self.from_env
+      log_level = ENV['LOG_LEVEL']
+      mask_sensitive_headers = ENV['MASK_SENSITIVE_HEADERS']
+
+      new(
+        log_level: log_level,
+        mask_sensitive_headers: mask_sensitive_headers,
+        request_logging_config: RequestLoggingConfiguration.from_env,
+        response_logging_config: ResponseLoggingConfiguration.from_env
+      )
+    end
+
+    def self.any_logging_configured?
+      RequestLoggingConfiguration.any_logging_configured? ||
+        ResponseLoggingConfiguration.any_logging_configured? ||
+        ENV.key?('LOG_LEVEL') ||
+        ENV.key?('MASK_SENSITIVE_HEADERS')
+    end
+  end
+end

data/lib/univapay_client_sdk/logging/sdk_logger.rb

@@ -0,0 +1,17 @@
+# univapay_client_sdk
+#
+# This file was automatically generated for Univapay
+# by APIMATIC v3.0 ( https://www.apimatic.io ).
+
+module UnivapayClientSdk
+  # Represents the generic logger facade
+  class AbstractLogger < Logger
+    # Logs a message with a specified log level and additional parameters.
+    # @param level [Symbol] The log level of the message.
+    # @param message [String] The message to log.
+    # @param params [Hash] Additional parameters to include in the log message.
+    def log(level, message, params)
+      raise NotImplementedError, 'This method needs to be implemented in a child class.'
+    end
+  end
+end

data/lib/univapay_client_sdk/models/api_error_detail.rb

@@ -0,0 +1,87 @@
+# univapay_client_sdk
+#
+# This file was automatically generated for Univapay
+# by APIMATIC v3.0 ( https://www.apimatic.io ).
+
+module UnivapayClientSdk
+  # Structured detail entry describing a single API validation or business
+  # error.
+  class ApiErrorDetail < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # The field name of the parameter that caused the error (lower_snake_case).
+    # @return [String]
+    attr_accessor :field
+
+    # Detailed reason for the nested error (UPPER_SNAKE_CASE or English
+    # description).
+    # @return [String]
+    attr_accessor :reason
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['field'] = 'field'
+      @_hash['reason'] = 'reason'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        field
+        reason
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(field: SKIP, reason: SKIP, additional_properties: nil)
+      # Add additional model properties to the instance
+      additional_properties = {} if additional_properties.nil?
+
+      @field = field unless field == SKIP
+      @reason = reason unless reason == SKIP
+      @additional_properties = additional_properties
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Extract variables from the hash.
+      field = hash.key?('field') ? hash['field'] : SKIP
+      reason = hash.key?('reason') ? hash['reason'] : SKIP
+
+      # Create a new hash for additional properties, removing known properties.
+      new_hash = hash.reject { |k, _| names.value?(k) }
+
+      additional_properties = APIHelper.get_additional_properties(
+        new_hash, proc { |value| value }
+      )
+
+      # Create object from extracted values.
+      ApiErrorDetail.new(field: field,
+                         reason: reason,
+                         additional_properties: additional_properties)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} field: #{@field}, reason: #{@reason}, additional_properties:"\
+      " #{@additional_properties}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} field: #{@field.inspect}, reason: #{@reason.inspect},"\
+      " additional_properties: #{@additional_properties}>"
+    end
+  end
+end

data/lib/univapay_client_sdk/models/api_error_status.rb

@@ -0,0 +1,26 @@
+# univapay_client_sdk
+#
+# This file was automatically generated for Univapay
+# by APIMATIC v3.0 ( https://www.apimatic.io ).
+
+module UnivapayClientSdk
+  # Always returns 'error'.
+  class ApiErrorStatus
+    API_ERROR_STATUS = [
+      # TODO: Write general description for ERROR
+      ERROR = 'error'.freeze
+    ].freeze
+
+    def self.validate(value)
+      return false if value.nil?
+
+      API_ERROR_STATUS.include?(value)
+    end
+
+    def self.from_value(value, default_value = ERROR)
+      return default_value if value.nil?
+
+      default_value
+    end
+  end
+end

data/lib/univapay_client_sdk/models/bank_transfer_event.rb

@@ -0,0 +1,27 @@
+# univapay_client_sdk
+#
+# This file was automatically generated for Univapay
+# by APIMATIC v3.0 ( https://www.apimatic.io ).
+
+module UnivapayClientSdk
+  # Event type discriminator — always `bank_transfer_status_updated` for this
+  # callback.
+  class BankTransferEvent
+    BANK_TRANSFER_EVENT = [
+      # TODO: Write general description for BANK_TRANSFER_STATUS_UPDATED
+      BANK_TRANSFER_STATUS_UPDATED = 'bank_transfer_status_updated'.freeze
+    ].freeze
+
+    def self.validate(value)
+      return false if value.nil?
+
+      BANK_TRANSFER_EVENT.include?(value)
+    end
+
+    def self.from_value(value, default_value = BANK_TRANSFER_STATUS_UPDATED)
+      return default_value if value.nil?
+
+      default_value
+    end
+  end
+end

data/lib/univapay_client_sdk/models/bank_transfer_ledger.rb

@@ -0,0 +1,199 @@
+# univapay_client_sdk
+#
+# This file was automatically generated for Univapay
+# by APIMATIC v3.0 ( https://www.apimatic.io ).
+
+require 'date'
+module UnivapayClientSdk
+  # Single bank transfer ledger entry associated with a charge.
+  class BankTransferLedger < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # Bank Transfer Ledger Bank Ledger Type schema.
+    # @return [BankTransferLedgerBankLedgerType]
+    attr_accessor :bank_ledger_type
+
+    # Amount in the smallest currency unit.
+    # @return [Integer]
+    attr_accessor :amount
+
+    # Current balance in the smallest currency unit.
+    # @return [Integer]
+    attr_accessor :balance
+
+    # Virtual bank account holder name.
+    # @return [String]
+    attr_accessor :virtual_bank_account_holder_name
+
+    # Virtual bank account number.
+    # @return [String]
+    attr_accessor :virtual_bank_account_number
+
+    # Virtual account id value.
+    # @return [String]
+    attr_accessor :virtual_account_id
+
+    # Transaction date.
+    # @return [Date]
+    attr_accessor :transaction_date
+
+    # Transaction timestamp.
+    # @return [DateTime]
+    attr_accessor :transaction_timestamp
+
+    # Bank Transfer Ledger Mode schema.
+    # @return [BankTransferLedgerMode]
+    attr_accessor :mode
+
+    # Timestamp when the resource was created.
+    # @return [DateTime]
+    attr_accessor :created_on
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['bank_ledger_type'] = 'bank_ledger_type'
+      @_hash['amount'] = 'amount'
+      @_hash['balance'] = 'balance'
+      @_hash['virtual_bank_account_holder_name'] =
+        'virtual_bank_account_holder_name'
+      @_hash['virtual_bank_account_number'] = 'virtual_bank_account_number'
+      @_hash['virtual_account_id'] = 'virtual_account_id'
+      @_hash['transaction_date'] = 'transaction_date'
+      @_hash['transaction_timestamp'] = 'transaction_timestamp'
+      @_hash['mode'] = 'mode'
+      @_hash['created_on'] = 'created_on'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        bank_ledger_type
+        amount
+        balance
+        virtual_bank_account_holder_name
+        virtual_bank_account_number
+        virtual_account_id
+        transaction_date
+        transaction_timestamp
+        mode
+        created_on
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(bank_ledger_type: SKIP, amount: SKIP, balance: SKIP,
+                   virtual_bank_account_holder_name: SKIP,
+                   virtual_bank_account_number: SKIP, virtual_account_id: SKIP,
+                   transaction_date: SKIP, transaction_timestamp: SKIP,
+                   mode: SKIP, created_on: SKIP, additional_properties: nil)
+      # Add additional model properties to the instance
+      additional_properties = {} if additional_properties.nil?
+
+      @bank_ledger_type = bank_ledger_type unless bank_ledger_type == SKIP
+      @amount = amount unless amount == SKIP
+      @balance = balance unless balance == SKIP
+      unless virtual_bank_account_holder_name == SKIP
+        @virtual_bank_account_holder_name =
+          virtual_bank_account_holder_name
+      end
+      unless virtual_bank_account_number == SKIP
+        @virtual_bank_account_number =
+          virtual_bank_account_number
+      end
+      @virtual_account_id = virtual_account_id unless virtual_account_id == SKIP
+      @transaction_date = transaction_date unless transaction_date == SKIP
+      @transaction_timestamp = transaction_timestamp unless transaction_timestamp == SKIP
+      @mode = mode unless mode == SKIP
+      @created_on = created_on unless created_on == SKIP
+      @additional_properties = additional_properties
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Extract variables from the hash.
+      bank_ledger_type =
+        hash.key?('bank_ledger_type') ? hash['bank_ledger_type'] : SKIP
+      amount = hash.key?('amount') ? hash['amount'] : SKIP
+      balance = hash.key?('balance') ? hash['balance'] : SKIP
+      virtual_bank_account_holder_name =
+        hash.key?('virtual_bank_account_holder_name') ? hash['virtual_bank_account_holder_name'] : SKIP
+      virtual_bank_account_number =
+        hash.key?('virtual_bank_account_number') ? hash['virtual_bank_account_number'] : SKIP
+      virtual_account_id =
+        hash.key?('virtual_account_id') ? hash['virtual_account_id'] : SKIP
+      transaction_date =
+        hash.key?('transaction_date') ? hash['transaction_date'] : SKIP
+      transaction_timestamp = if hash.key?('transaction_timestamp')
+                                (DateTimeHelper.from_rfc3339(hash['transaction_timestamp']) if hash['transaction_timestamp'])
+                              else
+                                SKIP
+                              end
+      mode = hash.key?('mode') ? hash['mode'] : SKIP
+      created_on = if hash.key?('created_on')
+                     (DateTimeHelper.from_rfc3339(hash['created_on']) if hash['created_on'])
+                   else
+                     SKIP
+                   end
+
+      # Create a new hash for additional properties, removing known properties.
+      new_hash = hash.reject { |k, _| names.value?(k) }
+
+      additional_properties = APIHelper.get_additional_properties(
+        new_hash, proc { |value| value }
+      )
+
+      # Create object from extracted values.
+      BankTransferLedger.new(bank_ledger_type: bank_ledger_type,
+                             amount: amount,
+                             balance: balance,
+                             virtual_bank_account_holder_name: virtual_bank_account_holder_name,
+                             virtual_bank_account_number: virtual_bank_account_number,
+                             virtual_account_id: virtual_account_id,
+                             transaction_date: transaction_date,
+                             transaction_timestamp: transaction_timestamp,
+                             mode: mode,
+                             created_on: created_on,
+                             additional_properties: additional_properties)
+    end
+
+    def to_custom_transaction_timestamp
+      DateTimeHelper.to_rfc3339(transaction_timestamp)
+    end
+
+    def to_custom_created_on
+      DateTimeHelper.to_rfc3339(created_on)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} bank_ledger_type: #{@bank_ledger_type}, amount: #{@amount}, balance:"\
+      " #{@balance}, virtual_bank_account_holder_name: #{@virtual_bank_account_holder_name},"\
+      " virtual_bank_account_number: #{@virtual_bank_account_number}, virtual_account_id:"\
+      " #{@virtual_account_id}, transaction_date: #{@transaction_date}, transaction_timestamp:"\
+      " #{@transaction_timestamp}, mode: #{@mode}, created_on: #{@created_on},"\
+      " additional_properties: #{@additional_properties}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} bank_ledger_type: #{@bank_ledger_type.inspect}, amount: #{@amount.inspect},"\
+      " balance: #{@balance.inspect}, virtual_bank_account_holder_name:"\
+      " #{@virtual_bank_account_holder_name.inspect}, virtual_bank_account_number:"\
+      " #{@virtual_bank_account_number.inspect}, virtual_account_id:"\
+      " #{@virtual_account_id.inspect}, transaction_date: #{@transaction_date.inspect},"\
+      " transaction_timestamp: #{@transaction_timestamp.inspect}, mode: #{@mode.inspect},"\
+      " created_on: #{@created_on.inspect}, additional_properties: #{@additional_properties}>"
+    end
+  end
+end

data/lib/univapay_client_sdk/models/bank_transfer_ledger_bank_ledger_type.rb

@@ -0,0 +1,36 @@
+# univapay_client_sdk
+#
+# This file was automatically generated for Univapay
+# by APIMATIC v3.0 ( https://www.apimatic.io ).
+
+module UnivapayClientSdk
+  # Bank Transfer Ledger Bank Ledger Type schema.
+  class BankTransferLedgerBankLedgerType
+    BANK_TRANSFER_LEDGER_BANK_LEDGER_TYPE = [
+      # TODO: Write general description for DEPOSIT
+      DEPOSIT = 'deposit'.freeze,
+
+      # TODO: Write general description for PAYMENT
+      PAYMENT = 'payment'.freeze
+    ].freeze
+
+    def self.validate(value)
+      return false if value.nil?
+
+      BANK_TRANSFER_LEDGER_BANK_LEDGER_TYPE.include?(value)
+    end
+
+    def self.from_value(value, default_value = DEPOSIT)
+      return default_value if value.nil?
+
+      str = value.to_s.strip
+
+      case str.downcase
+      when 'deposit' then DEPOSIT
+      when 'payment' then PAYMENT
+      else
+        default_value
+      end
+    end
+  end
+end

data/lib/univapay_client_sdk/models/bank_transfer_ledger_list.rb

@@ -0,0 +1,104 @@
+# univapay_client_sdk
+#
+# This file was automatically generated for Univapay
+# by APIMATIC v3.0 ( https://www.apimatic.io ).
+
+module UnivapayClientSdk
+  # Paginated list of bank transfer ledger entries.
+  class BankTransferLedgerList < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # List of resources.
+    # @return [Array[BankTransferLedger]]
+    attr_accessor :items
+
+    # Whether more results are available.
+    # @return [TrueClass | FalseClass]
+    attr_accessor :has_more
+
+    # Total number of matching resources.
+    # @return [Integer]
+    attr_accessor :total_hits
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['items'] = 'items'
+      @_hash['has_more'] = 'has_more'
+      @_hash['total_hits'] = 'total_hits'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        items
+        has_more
+        total_hits
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(items: SKIP, has_more: SKIP, total_hits: SKIP,
+                   additional_properties: nil)
+      # Add additional model properties to the instance
+      additional_properties = {} if additional_properties.nil?
+
+      @items = items unless items == SKIP
+      @has_more = has_more unless has_more == SKIP
+      @total_hits = total_hits unless total_hits == SKIP
+      @additional_properties = additional_properties
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Extract variables from the hash.
+      # Parameter is an array, so we need to iterate through it
+      items = nil
+      unless hash['items'].nil?
+        items = []
+        hash['items'].each do |structure|
+          items << (BankTransferLedger.from_hash(structure) if structure)
+        end
+      end
+
+      items = SKIP unless hash.key?('items')
+      has_more = hash.key?('has_more') ? hash['has_more'] : SKIP
+      total_hits = hash.key?('total_hits') ? hash['total_hits'] : SKIP
+
+      # Create a new hash for additional properties, removing known properties.
+      new_hash = hash.reject { |k, _| names.value?(k) }
+
+      additional_properties = APIHelper.get_additional_properties(
+        new_hash, proc { |value| value }
+      )
+
+      # Create object from extracted values.
+      BankTransferLedgerList.new(items: items,
+                                 has_more: has_more,
+                                 total_hits: total_hits,
+                                 additional_properties: additional_properties)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} items: #{@items}, has_more: #{@has_more}, total_hits: #{@total_hits},"\
+      " additional_properties: #{@additional_properties}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} items: #{@items.inspect}, has_more: #{@has_more.inspect}, total_hits:"\
+      " #{@total_hits.inspect}, additional_properties: #{@additional_properties}>"
+    end
+  end
+end