genesis_ruby 0.2.1 → 0.2.3

data/lib/genesis_ruby/api/requests/non_financial/installments/fetch.rb

@@ -0,0 +1,59 @@
+module GenesisRuby
+  module Api
+    module Requests
+      module NonFinancial
+        module Installments
+          # Fetch the applicable installments for a given amount, currency and card brand.
+          class Fetch < Base::Versioned
+
+            attr_reader :amount, :card_number
+            attr_accessor :currency
+
+            # Installments Fetch initialization
+            def initialize(configuration, _builder_interface = nil)
+              super configuration
+
+              self.request_path = 'installments'
+            end
+
+            # Amount of transaction in minor currency unit
+            def amount=(value)
+              raise InvalidArgumentError, 'Invalid Amount given, only integer value allowed!' unless value.is_a? Integer
+
+              @amount = value
+            end
+
+            # Complete cc number of customer
+            def card_number=(value)
+              value = value.to_s
+
+              raise InvalidArgumentError, 'Invalid Credit Card number given!' unless value =~ /\A[0-9]{13,19}\Z/
+
+              @card_number = value
+            end
+
+            protected
+
+            # Fetch request field validations
+            def init_field_validations
+              super
+
+              required_fields.push *%i[amount currency card_number]
+              field_values.merge! currency: Constants::Currencies::Iso4217.all.map(&:upcase)
+            end
+
+            # Installments Fetch request structure
+            def request_structure
+              {
+                amount:      amount,
+                currency:    currency,
+                card_number: card_number
+              }
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/requests/non_financial/installments/show.rb

@@ -0,0 +1,58 @@
+module GenesisRuby
+  module Api
+    module Requests
+      module NonFinancial
+        module Installments
+          # Retrieves details about a specific installment based on its ID.
+          class Show < Base::Versioned
+
+            attr_writer :installment_id
+
+            # Installments Show initialization
+            def initialize(configuration, _builder_interface = nil)
+              super configuration
+
+              self.request_path = 'installments/:installment_id'
+            end
+
+            # Installment identifier
+            def installment_id
+              @installment_id.to_s
+            end
+
+            protected
+
+            # Override default Versioned Network configuration
+            def init_configuration
+              super
+
+              init_get_configuration
+            end
+
+            # Fetch request field validations
+            def init_field_validations
+              super
+
+              required_fields.push *%i[installment_id]
+            end
+
+            # Installments Show request structure
+            def request_structure
+              {}
+            end
+
+            # Override API endpoint with provided Installment ID
+            def process_request_parameters
+              super
+
+              request_path.sub!(':installment_id', installment_id)
+
+              init_api_gateway_configuration request_path: "#{version}/#{request_path}", include_token: false
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/requests/non_financial/reconcile/date_range.rb

@@ -8,43 +8,9 @@ module GenesisRuby
           # The response is paginated, each request will return 100 entries max.
           class DateRange < Api::Request
 
-            attr_reader :page
-
-            # Start of the requested date range (time is optional)
-            def start_date
-              format = if start_date_time?
-                         Constants::DateTimeFormats::YYYY_MM_DD_H_I_S
-                       else
-                         Constants::DateTimeFormats::YYYY_MM_DD_ISO_8601
-                       end
-
-              @start_date&.strftime format
-            end
-
-            # Start of the requested date range (time is optional)
-            def start_date=(value)
-              self.start_date_time = Utils::Common.date_has_time? value
-
-              parse_date attribute: __method__, value: value, allow_empty: false
-            end
-
-            # Start of the requested date range (time is optional)
-            def end_date
-              format = if end_date_time?
-                         Constants::DateTimeFormats::YYYY_MM_DD_H_I_S
-                       else
-                         Constants::DateTimeFormats::YYYY_MM_DD_ISO_8601
-                       end
-
-              @end_date&.strftime format
-            end
+            include Api::Mixins::Requests::NonFinancial::DateAttributes
 
-            # End of the requested date range (time is optional)
-            def end_date=(value)
-              self.end_date_time = Utils::Common.date_has_time? value
-
-              parse_date attribute: __method__, value: value, allow_empty: true
-            end
+            attr_reader :page
 
             # The page within the paginated result, defaults to 1
             def page=(value)
@@ -75,20 +41,6 @@ module GenesisRuby
               }
             end
 
-            private
-
-            attr_accessor :start_date_time, :end_date_time
-
-            # Start Date has time within the given string
-            def start_date_time?
-              self.start_date_time ||= false
-            end
-
-            # End Date has time within the given string
-            def end_date_time?
-              self.end_date_time ||= false
-            end
-
           end
         end
       end

data/lib/genesis_ruby/builder.rb

@@ -1,5 +1,7 @@
 require 'genesis_ruby/builders/xml'
 require 'genesis_ruby/builders/form'
+require 'genesis_ruby/builders/json'
+require 'genesis_ruby/builders/graphql'
 require 'genesis_ruby/errors/builder_error'
 
 module GenesisRuby
@@ -15,11 +17,16 @@ module GenesisRuby
     # Builder FORM
     FORM = 'form'.freeze
 
+    # Builder GraphQL
+    GRAPHQL = 'graphql'.freeze
+
     # Initialize the Builder Interface based on the Request requirements
     def initialize(request_interface)
       case request_interface
       when XML then @builder_context = Builders::Xml.new
       when FORM then @builder_context = Builders::Form.new
+      when JSON then @builder_context = Builders::Json.new
+      when GRAPHQL then @builder_context = Builders::Graphql.new
       else
         raise GenesisRuby::BuilderError, 'Invalid Builder interface!'
       end

data/lib/genesis_ruby/builders/graphql.rb

@@ -0,0 +1,118 @@
+require 'genesis_ruby/builders/base'
+require 'json'
+
+module GenesisRuby
+  module Builders
+    # GraphQL builder
+    class Graphql < Base
+
+      # Builder GraphQL constructor
+      def initialize
+        @document = ''
+        super
+      end
+
+      # Outputs generated document
+      def output
+        @document
+      end
+
+      # Created GraphQL query from provided structure
+      def populate_nodes(structure)
+        validate_structure(structure)
+
+        @document = build_query(structure)
+      end
+
+      private
+
+      # Validates given structure
+      def validate_structure(structure)
+        raise BuilderError, 'Invalid Hash structure given in Graphql builder!' unless structure.is_a? Hash
+
+        root_key = structure.keys.first
+
+        raise BuilderError, 'Missing structure root key in Graphql builder' if root_key.nil?
+        raise BuilderError, 'Invalid GraphQL structure given in GraphQL builder' unless structure[root_key].is_a? Hash
+      end
+
+      # Build GraphQL Query
+      def build_query(structure)
+        ident           = ' ' * 2
+        root_key        = structure.keys.first
+        filters         = build_filters structure[root_key][:filters]
+        response_fields = build_response_fields structure[root_key][:response_fields], ident * 2
+
+        format("%{root} {\n#{ident}%{action}(%{filters})\n#{ident}{\n%{response_fields}\n#{ident}}\n}",
+               root:            root_key,
+               action:          structure[root_key][:action].to_s,
+               filters:         filters,
+               response_fields: response_fields)
+      end
+
+      # Build GraphQL filters
+      def build_filters(data)
+        out = ''
+
+        return out unless data.is_a? Hash
+
+        data.each do |key, value|
+          out += splat_hash Hash[key, value]
+          out += ', ' unless data.keys.last == key
+        end
+
+        out
+      end
+
+      # Builds given hash in the GraphQL syntax
+      # { key: { key1: 'value1', key2: 'value2' } } becomes key: { key1: value1, key2: value2 }
+      def splat_hash(data)
+        out      = ''
+        root_key = data.keys.first
+
+        return out unless data[root_key].is_a? Hash
+
+        data[root_key].each do |key, value|
+          out += format '%{key}: %{value}', key: key.to_s, value: value.to_s
+          out += ', ' unless key == data[root_key].keys.last
+        end
+
+        format '%{key}: { %{out} }', key: root_key, out: out
+      end
+
+      # Build GraphQL query response fields
+      def build_response_fields(data, ident)
+        out = ''
+
+        return out unless data.is_a? Hash
+
+        data.each do |key, value|
+          out += formatted_array Hash[key, value], ident
+          out += "\n" unless key == data.keys.last
+        end
+
+        out
+      end
+
+      # Build given array into formatted GraphQL query items
+      # items: [item1 item2 item3] will output
+      #   items
+      #   {
+      #     item1
+      #     item2
+      #     item3
+      #   }
+      def formatted_array(data, ident)
+        out      = ''
+        root_key = data.keys.first
+
+        return out unless data[root_key].is_a? Array
+
+        out += data[root_key].map { |key| "#{ident}  #{key}" }.join("\n")
+
+        format "#{ident}%{key}\n#{ident}{\n%{out}\n#{ident}}", key: root_key, out: out
+      end
+
+    end
+  end
+end

data/lib/genesis_ruby/builders/json.rb

@@ -0,0 +1,30 @@
+require 'genesis_ruby/builders/base'
+require 'json'
+
+module GenesisRuby
+  module Builders
+    # JSON Document builder
+    class Json < Base
+
+      # JSON constructor
+      def initialize
+        @document = ''
+
+        super
+      end
+
+      # JSON output string
+      def output
+        @document
+      end
+
+      # Generate JSON document
+      def populate_nodes(structure)
+        @document = JSON.pretty_generate structure
+      rescue StandardError => e
+        raise BuilderError, "Given request structure can not be generated! #{e.message}"
+      end
+
+    end
+  end
+end

data/lib/genesis_ruby/configuration.rb

@@ -20,8 +20,8 @@ module GenesisRuby
     # Default sanitize Response
     DEFAULT_SANITIZE_RESPONSE = true
 
-    # Genesis basic configuration - credentials, endpoint, environment, token
-    attr_writer :username, :password, :token, :interface, :format_response, :sanitize_response
+    # Genesis basic configuration - credentials, endpoint, environment, token, etc
+    attr_writer :username, :password, :token, :interface, :format_response, :sanitize_response, :billing_api_token
 
     # Configuration constructor
     def initialize
@@ -64,6 +64,11 @@ module GenesisRuby
       @force_smart_routing ||= false
     end
 
+    # Defines the Bearer token used for authorization in Billing API Service
+    def billing_api_token
+      @billing_api_token || ''
+    end
+
     # Genesis Request Timeout
     def timeout=(value)
       timeout = value.to_i
@@ -187,6 +192,10 @@ module GenesisRuby
         smart_router: {
           GenesisRuby::Api::Constants::Environments::PRODUCTION => 'prod.api.',
           GenesisRuby::Api::Constants::Environments::STAGING    => 'staging.api.'
+        },
+        api_service:  {
+          GenesisRuby::Api::Constants::Environments::PRODUCTION => 'prod.api.',
+          GenesisRuby::Api::Constants::Environments::STAGING    => 'staging.api.'
         }
       }
     end

data/lib/genesis_ruby/dependencies.rb

@@ -20,6 +20,9 @@ require 'genesis_ruby/api/requests/base/financial'
 require 'genesis_ruby/api/requests/base/financials/credit_card'
 require 'genesis_ruby/api/requests/base/financials/south_american_payments'
 require 'genesis_ruby/api/requests/base/reference'
+require 'genesis_ruby/api/requests/base/versioned'
+require 'genesis_ruby/api/requests/financial/sdd/sale'
+require 'genesis_ruby/api/requests/base/graphql'
 require 'genesis_ruby/api/notification'
 
 # Load Financial and Non Financial API Requests

data/lib/genesis_ruby/network/adapter/net_http_adapter.rb

@@ -22,15 +22,15 @@ module GenesisRuby
         end
 
         # Send the request
-        def execute
+        def execute # rubocop:disable Metrics/AbcSize
           raise NetworkError, 'Request is not initialized' unless @request
 
           safe_execute do
             case request_data.type
             when Api::Request::METHOD_POST then @response = @request.post path, request_data.body, headers
             when Api::Request::METHOD_PUT then @response = @request.put path, request_data.body, headers
-            else
-              raise 'Invalid Request Type!'
+            when Api::Request::METHOD_GET then @response = @request.get path, headers
+            else raise 'Invalid Request Type!'
             end
           end
         end
@@ -90,11 +90,27 @@ module GenesisRuby
 
         # Define Headers
         def headers
+          data = common_headers
+
+          data.merge! payload_headers unless request_data.type == Api::Request::METHOD_GET
+          data.merge! request_data.headers if request_data.headers.is_a?(Hash) && !request_data.headers.empty?
+
+          data
+        end
+
+        # Provides default request headers
+        def common_headers
+          {
+            'Authorization' => request_data.user_login.to_s,
+            'User-Agent'    => request_data.user_agent.to_s
+          }
+        end
+
+        # Payload Headers
+        def payload_headers
           {
             'Content-Type'   => request_data.format,
-            'Content-Length' => request_data.body&.length.to_s,
-            'Authorization'  => "Basic #{request_data.user_login}",
-            'User-Agent'     => request_data.user_agent
+            'Content-Length' => request_data.body&.length.to_s
           }
         end
 

data/lib/genesis_ruby/network/base_network.rb

@@ -1,6 +1,4 @@
-require 'genesis_ruby/errors/invalid_argument_error'
 require 'genesis_ruby/utils/options/network_adapter_config'
-require 'base64'
 
 module GenesisRuby
   module Network
@@ -75,18 +73,7 @@ module GenesisRuby
 
       # Map the Request to the Network Adapter object
       def adapter_data_mapper(request)
-        network_adapter_config.map_from_request(request).merge(
-          {
-            user_login: build_user_login,
-            user_agent: network_user_agent,
-            timeout:    configuration.timeout
-          }
-        )
-      end
-
-      # Build the User login string used for the Authorization Header
-      def build_user_login
-        Base64.urlsafe_encode64("#{configuration.username}:#{configuration.password}")
+        network_adapter_config.map_from_request(request, configuration).merge({ user_agent: network_user_agent })
       end
 
       # The default user agent for every Network

data/lib/genesis_ruby/parser.rb

@@ -1,4 +1,5 @@
 require 'genesis_ruby/parsers/xml'
+require 'genesis_ruby/parsers/json'
 require 'genesis_ruby/errors/parser_error'
 
 module GenesisRuby
@@ -16,6 +17,8 @@ module GenesisRuby
       case response_interface
       when XML
         @parser_context = GenesisRuby::Parsers::Xml.new
+      when JSON
+        @parser_context = GenesisRuby::Parsers::Json.new
       else
         raise GenesisRuby::ParserError, 'Invalid Parser interface!'
       end

data/lib/genesis_ruby/parsers/json.rb

@@ -0,0 +1,18 @@
+require 'genesis_ruby/parsers/base'
+require 'json'
+
+module GenesisRuby
+  module Parsers
+    # JSON Document parser
+    class Json < Base
+
+      # Parse received document
+      def parse_document(document)
+        @structure = JSON.parse(document, symbolize_names: true)
+      rescue StandardError => e
+        raise ParserError, "Given JSON string can not be parsed! #{e.message}"
+      end
+
+    end
+  end
+end

data/lib/genesis_ruby/utils/formatters/response/formats/timestamp.rb

@@ -11,7 +11,7 @@ module GenesisRuby
 
             # The Response keys that the formatter will be applied to
             def formatting_keys
-              %w(timestamp)
+              %w(timestamp transactionDate valueDate)
             end
 
             # Format the given timestamp to DateTime object

data/lib/genesis_ruby/utils/options/api_config.rb

@@ -13,6 +13,8 @@ module GenesisRuby
           self.type                  = GenesisRuby::Api::Request::METHOD_POST
           self.format                = Builder::XML
           self.parser_skip_root_node = true
+          self.authorization         = GenesisRuby::Api::Request::AUTH_TYPE_BASIC
+          self.bearer_token          = nil
         end
 
         # Load pre-defined JSON configuration
@@ -22,6 +24,8 @@ module GenesisRuby
           self.type                  = GenesisRuby::Api::Request::METHOD_POST
           self.format                = Builder::JSON
           self.parser_skip_root_node = false
+          self.authorization         = GenesisRuby::Api::Request::AUTH_TYPE_BASIC
+          self.bearer_token          = nil
         end
 
         # Load pre-defined FORM configuration
@@ -31,6 +35,30 @@ module GenesisRuby
           self.type                  = GenesisRuby::Api::Request::METHOD_POST
           self.format                = Builder::FORM
           self.parser_skip_root_node = true
+          self.authorization         = GenesisRuby::Api::Request::AUTH_TYPE_BASIC
+          self.bearer_token          = nil
+        end
+
+        # Load pre-defined GET configuration
+        def load_get_config
+          self.protocol              = GenesisRuby::Api::Request::PROTOCOL_HTTPS
+          self.port                  = GenesisRuby::Api::Request::PORT_HTTPS
+          self.type                  = GenesisRuby::Api::Request::METHOD_GET
+          self.format                = Builder::XML
+          self.parser_skip_root_node = false
+          self.authorization         = GenesisRuby::Api::Request::AUTH_TYPE_BASIC
+          self.bearer_token          = nil
+        end
+
+        # Load pre-defined GraphQL configuration
+        def load_graphql_config
+          self.protocol              = GenesisRuby::Api::Request::PROTOCOL_HTTPS
+          self.port                  = GenesisRuby::Api::Request::PORT_HTTPS
+          self.type                  = GenesisRuby::Api::Request::METHOD_POST
+          self.format                = Builder::GRAPHQL
+          self.parser_skip_root_node = false
+          self.authorization         = GenesisRuby::Api::Request::AUTH_TYPE_TOKEN
+          self.bearer_token          = nil
         end
 
       end

data/lib/genesis_ruby/utils/options/network_adapter_config.rb

@@ -1,4 +1,6 @@
 require 'genesis_ruby/utils/options/base'
+require 'genesis_ruby/errors/invalid_argument_error'
+require 'base64'
 
 module GenesisRuby
   module Utils
@@ -7,13 +9,17 @@ module GenesisRuby
       class NetworkAdapterConfig < Base
 
         # Map the Adapter configuration from the Request object
-        def map_from_request(request) # rubocop:disable Metrics/AbcSize
-          self.body     = request.build_document
-          self.url      = request.api_config.url
-          self.type     = request.api_config.type
-          self.port     = request.api_config.port
-          self.protocol = request.api_config.protocol
-          self.format   = fetch_content_type(request.api_config.format)
+        def map_from_request(request, configuration) # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
+          self.body          = request.build_document
+          self.url           = request.api_config.url
+          self.type          = request.api_config.type
+          self.port          = request.api_config.port
+          self.protocol      = request.api_config.protocol
+          self.format        = fetch_content_type request.api_config.format
+          self.authorization = request.api_config.authorization
+          self.user_login    = build_user_login request, configuration
+          self.setimeout     = configuration.timeout
+          self.headers       = build_additional_headers request
 
           self
         end
@@ -23,17 +29,46 @@ module GenesisRuby
         # Retrieve the Request data format that must be used as Content-Type header
         def fetch_content_type(data_format)
           case data_format
-          when Builder::XML
-            'text/xml'
-          when Builder::JSON
-            'application/json'
-          when Builder::FORM
-            'application/x-www-form-urlencoded'
+          when Builder::XML then 'text/xml'
+          when Builder::JSON then 'application/json'
+          when Builder::FORM then 'application/x-www-form-urlencoded'
+          when Builder::GRAPHQL then 'application/graphql'
+          else raise InvalidArgumentError, 'Invalid request format type. Allowed are XML, JSON and FORM'
+          end
+        end
+
+        # Build the User login string used for the Authorization Header
+        def build_user_login(request, configuration)
+          auth = request.api_config.authorization
+          kind = fetch_authorization_kind auth
+
+          return "#{kind} #{request.api_config.bearer_token}" if auth == Api::Request::AUTH_TYPE_TOKEN
+
+          "#{kind} #{Base64.urlsafe_encode64("#{configuration.username}:#{configuration.password}")}"
+        end
+
+        # Fetches the Request authorization kind
+        # TODO: Add AUTH_TYPE_NONE, should be used for METHOD CONTINUE request
+        def fetch_authorization_kind(auth)
+          case auth
+          when Api::Request::AUTH_TYPE_BASIC
+            'Basic'
+          when Api::Request::AUTH_TYPE_TOKEN
+            'Bearer'
           else
-            raise InvalidArgumentError, 'Invalid request format type. Allowed are XML, JSON and FORM'
+            raise InvalidArgumentError, 'Invalid Authorization given in the Request. Allowed: BASIC, TOKEN'
           end
         end
 
+        # Build additional headers to be added based on the specific request format
+        def build_additional_headers(request)
+          headers = {}
+
+          headers.merge! 'Accept' => 'application/json' if request.api_config.format == Builder::GRAPHQL
+
+          headers
+        end
+
       end
     end
   end

data/lib/genesis_ruby/utils/transactions/financial_types.rb

@@ -11,7 +11,7 @@ module GenesisRuby
           # Return array containing all available Web Payment Form transaction types
           def all # rubocop:disable Metrics/MethodLength
             [
-              AFRICAN_MOBILE_PAYOUT, AFRICAN_MOBILE_SALE, APPLE_PAY, ARGENCARD, AURA, AUTHORIZE, AUTHORIZE_3D,
+              AFRICAN_MOBILE_PAYOUT, AFRICAN_MOBILE_SALE, ALIPAY, APPLE_PAY, ARGENCARD, AURA, AUTHORIZE, AUTHORIZE_3D,
               BALOTO, BANCOMER, BANCONTACT, BANCO_DE_OCCIDENTE, BANCO_DO_BRASIL, BITPAY_PAYOUT, BITPAY_REFUND,
               BITPAY_SALE, BOLETO, BRADESCO,
               CABAL, CAPTURE, CASHU, CENCOSUD, CREDIT,

data/lib/genesis_ruby/utils/transactions/references/refundable_types.rb

@@ -12,7 +12,7 @@ module GenesisRuby
             # Array containing all available Refundable Types
             def all # rubocop:disable Metrics/MethodLength
               [
-                AFRICAN_MOBILE_PAYOUT, AFRICAN_MOBILE_SALE, APPLE_PAY,
+                AFRICAN_MOBILE_PAYOUT, AFRICAN_MOBILE_SALE, ALIPAY, APPLE_PAY,
                 BALOTO, BANCOMER, BANCONTACT, BANCO_DE_OCCIDENTE, BANCO_DO_BRASIL, BITPAY_SALE, BOLETO, BRADESCO,
                 CAPTURE, CASHU,
                 DAVIVIENDA,