onlinepayments-sdk-ruby 4.22.0 → 5.0.0

data/lib/onlinepayments/sdk/pooled_connection.rb

@@ -1,21 +0,0 @@
-module OnlinePayments::SDK
-
-  # {OnlinePayments::SDK::Connection} that supports connection pooling. This is used to more efficiently communicate using HTTP.
-  # Connection pooling means that a number of connections are kept alive after use so they can possibly be reused.
-  # If the Connection does not do so automatically,
-  # the methods _close_idle_connections_ and _close_expired_connections_ can be used to drop connections
-  # that are idle for a specified amount of time or that have expired.
-  # @see OnlinePayments::SDK::DefaultImpl::DefaultConnection
-  class PooledConnection < Connection
-
-    # Closes all connections that have not been used for _idle_time_ seconds.
-    def close_idle_connections(idle_time)
-      raise NotImplementedError
-    end
-
-    # Closes all connections that have expired.
-    def close_expired_connections
-      raise NotImplementedError
-    end
-  end
-end

data/lib/onlinepayments/sdk/request_header.rb

@@ -1,50 +0,0 @@
-module OnlinePayments::SDK
-
-  # Represents HTTP request headers
-  # Each header is immutable has a #name and #value attribute
-  #
-  # @attr_reader [String] name  HTTP header name
-  # @attr_reader [String] value HTTP header value
-  class RequestHeader
-
-    # Create a new header using the name and value given as parameters.
-    def initialize(name, value)
-      raise ArgumentError, 'name is required' if name.nil? || name.strip.empty?
-      @name = name
-      @value = normalize_value(value)
-    end
-
-    attr_reader :name
-    attr_reader :value
-
-    def to_s
-      "#{name}:#{value}"
-    end
-
-    # Return the {OnlinePayments::SDK::ResponseHeader} that goes by the given _header_name_,
-    # If this Response does not contain a header with the given name, return _nil_ instead
-    def self.get_header(headers, header_name)
-      selected_headers = headers.select { |h| h.name == header_name }
-      return selected_headers&.length.positive? ?
-               selected_headers[0] :
-               nil
-    end
-
-    # Returns the header value of the header that goes by the given _header_name_,
-    # If this response does not contain a header with the given name, return _nil_ instead
-    def self.get_header_value(headers, header_name)
-      return get_header(headers, header_name)&.value
-    end
-
-    private
-
-    def normalize_value(value)
-      return value if value.nil? || value.empty?
-      # Replace all sequences of whitespace*-linebreak-whitespace* into a single linebreak-space
-      # This will ensure that:
-      # - no line ends with whitespace, because this causes authentication failures
-      # - each line starts with a single whitespace, so it is a valid header value
-      value.gsub(/[\s&&[^\r\n]]*(\r?\n)[\s&&[^\r\n]]*/, '\1 ')
-    end
-  end
-end

data/lib/onlinepayments/sdk/request_param.rb

@@ -1,23 +0,0 @@
-module OnlinePayments::SDK
-
-  # Represents a URL request parameter.
-  # Each parameter is immutable and has a #name and #value attribute.
-  #
-  # @attr_reader [String] name  Parameter name
-  # @attr_reader [String] value Parameter value
-  class RequestParam
-
-    def initialize(name, value)
-      raise ArgumentError, 'name is required' if name.nil? || name.strip.empty?
-      @name = name
-      @value = value
-    end
-
-    attr_reader :name
-    attr_reader :value
-
-    def to_s
-      "#{name}=#{value}"
-    end
-  end
-end

data/lib/onlinepayments/sdk/response_exception.rb

@@ -1,47 +0,0 @@
-module OnlinePayments::SDK
-
-  # Exception used internally in the SDK to indicate an error response was received from the Online Payments platform.
-  #
-  # @attr_reader [Integer] status_code HTTP status code that was returned by the Online Payments platform
-  # @attr_reader [String] body         HTTP message body that was returned by the Online Payments platform
-  # @attr_reader [Array<OnlinePayments:SDK:ResponseHeader>] headers HTTP headers used in the response from the Online Payments platform
-  class ResponseException < RuntimeError
-
-    def initialize(status_code, headers, body)
-      super('the Online Payments platform returned an error response')
-      @status_code = status_code
-      @headers = if headers.nil? || headers.empty?
-                   {}
-                 else
-                   headers.inject({}) do |hash, header|
-                     hash[header.name.downcase.to_sym] = header.dup.freeze
-                     hash
-                   end
-                 end.freeze
-      @body = body
-    end
-
-    attr_reader :status_code
-    attr_reader :body
-    attr_reader :headers
-
-    # Returns the {OnlinePayments::SDK::ResponseHeader} that corresponds to the given _header_name_
-    # used in the HTTP response from the Online Payments platform, or *nil* if the header was not present in the response.
-    def get_header(header_name)
-      ResponseHeader.get_header(@headers, header_name)
-    end
-
-    # Returns the header value received that corresponds to the header named by _header_name_,
-    # or *nil* if _header_name_ was not a header present in the HTTP response.
-    def get_header_value(header_name)
-      ResponseHeader.get_header_value(@headers, header_name)
-    end
-
-    def to_s
-      str = super.to_s
-      str += "; status_code=#{@status_code}" if @status_code.positive?
-      str += "; response_body='#{@body}'" if @body&.length.positive?
-      str.to_s
-    end
-  end
-end

data/lib/onlinepayments/sdk/response_header.rb

@@ -1,42 +0,0 @@
-module OnlinePayments::SDK
-
-  # Represents HTTP response headers
-  # Each header is immutable has a #name and #value attribute
-  #
-  # @attr_reader [String] name  HTTP header name
-  # @attr_reader [String] value HTTP header value
-  class ResponseHeader
-
-    # Create a new header using the name and value given as parameters.
-    def initialize(name, value)
-      raise ArgumentError, 'name is required' if name.nil? || name.strip.empty?
-      @name = name
-      @value = value
-    end
-
-    attr_reader :name
-    attr_reader :value
-
-    def to_s
-      "#{name}:#{value}"
-    end
-
-    # Return the {OnlinePayments::SDK::ResponseHeader} that goes by the given _header_name_,
-    # If this Response does not contain a header with the given name, return _nil_ instead
-    def self.get_header(headers, header_name)
-      selected_headers = headers.select { |h| h.name.casecmp(header_name) == 0 }
-      if selected_headers.nil? || selected_headers.length == 0
-        return nil
-      else
-        return selected_headers[0]
-      end
-    end
-
-    # Returns the header value of the header that goes by the given _header_name_,
-    # If this response does not contain a header with the given name, return _nil_ instead
-    def self.get_header_value(headers, header_name)
-      header = get_header(headers, header_name)
-      return header&.value
-    end
-  end
-end

data/lib/onlinepayments/sdk/uploadable_file.rb

@@ -1,30 +0,0 @@
-module OnlinePayments::SDK
-
-    # A file that can be uploaded
-    #
-    # The allowed forms of content are defined by the Connection implementation
-    # The default implementation supports file paths and IO objects.
-    #
-    # @attr_reader [String] file_name       The name of the file.
-    # @attr_reader [String, IO] content     The file's content.
-    # @attr_reader [String] content_type    The file's content type.
-    # @attr_reader [Integer] content_length The file's content length, or -1 if not known.
-    class UploadableFile
-
-        def initialize(file_name, content, content_type, content_length=-1)
-            raise ArgumentError.new("file_name is required") if file_name.nil? or !file_name.strip
-            raise ArgumentError.new("content is required") if content.nil?
-            raise ArgumentError.new("content_type is required") if content_type.nil? or !content_type.strip
-
-            @file_name = file_name
-            @content = content
-            @content_type = content_type
-            @content_length = [content_length, -1].max
-        end
-
-        attr_reader :file_name
-        attr_reader :content
-        attr_reader :content_type
-        attr_reader :content_length
-    end
-end

data/lib/onlinepayments/sdk/webhooks/webhooks.rb

@@ -1,22 +0,0 @@
-module OnlinePayments::SDK
-  module Webhooks
-    # Online Payments platform factory for several webhooks components
-    module Webhooks
-      DefaultMarshaller ||= OnlinePayments::SDK::DefaultImpl::DefaultMarshaller
-
-      # Creates a WebhooksHelperBuilder that uses the
-      # given SecretkeyStore
-      def self.create_helper_builder(secret_key_store)
-        WebhooksHelperBuilder.new
-                             .with_marshaller(DefaultMarshaller.INSTANCE)
-                             .with_secret_key_store(secret_key_store)
-      end
-
-      # Creates a WebhooksHelper that uses the given
-      # SecretkeyStore.
-      def self.create_helper(secret_key_store)
-        create_helper_builder(secret_key_store).build
-      end
-    end
-  end
-end

data/lib/onlinepayments/sdk/webhooks/webhooks_helper_builder.rb

@@ -1,25 +0,0 @@
-module OnlinePayments::SDK
-  module Webhooks
-
-    # Builder for a WebhooksHelper object.
-    class WebhooksHelperBuilder
-
-      # Sets the Marshaller to use.
-      def with_marshaller(marshaller)
-        @marshaller = marshaller
-        self
-      end
-
-      # Sets the SecretkeyStore to use.
-      def with_secret_key_store(secret_key_store)
-        @secret_key_store = secret_key_store
-        self
-      end
-
-      # Creates a fully initialized WebhooksHelper object
-      def build
-        WebhooksHelper.new(@marshaller, @secret_key_store)
-      end
-    end
-  end
-end