genesis_ruby 0.2.2 → 0.2.4

data/lib/genesis_ruby/api/requests/non_financial/tokenization/tokenize.rb

@@ -0,0 +1,45 @@
+module GenesisRuby
+  module Api
+    module Requests
+      module NonFinancial
+        module Tokenization
+          # Tokenizes cardholder data and issues a corresponding token. Merchants should take
+          # care to save the plain-text token value in their system as once issued it is not possible
+          # to obtain it again.
+          class Tokenize < Base::Versioned
+
+            include Api::Mixins::Requests::NonFinancial::Tokenization::CardDataAttributes
+            include Api::Mixins::Requests::NonFinancial::Tokenization::TokenizationAttributes
+
+            def initialize(configuration, builder_interface = Builder::XML)
+              super configuration, builder_interface
+
+              self.request_path = 'tokenize'
+            end
+
+            protected
+
+            # Tokenize field validations
+            def init_field_validations
+              super
+
+              required_fields.push *tokenization_required_fields, *%i[card_number]
+            end
+
+            # API Request structure
+            def request_structure
+              {
+                tokenize_request: tokenization_attributes_structure.merge(
+                  {
+                    card_data: card_data_attributes_structure
+                  }
+                )
+              }
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/requests/non_financial/tokenization/update_token.rb

@@ -0,0 +1,45 @@
+module GenesisRuby
+  module Api
+    module Requests
+      module NonFinancial
+        module Tokenization
+          # Updates the tokenized data corresponding to an existing valid token
+          class UpdateToken < Base::Versioned
+
+            include Api::Mixins::Requests::NonFinancial::Tokenization::CardDataAttributes
+            include Api::Mixins::Requests::NonFinancial::Tokenization::TokenAttributes
+            include Api::Mixins::Requests::NonFinancial::Tokenization::TokenizationAttributes
+
+            def initialize(configuration, builder_interface = Builder::XML)
+              super configuration, builder_interface
+
+              self.request_path = 'update_token'
+            end
+
+            protected
+
+            # Update Token field validations
+            def init_field_validations
+              super
+
+              required_fields.push *tokenization_required_fields, *%i[card_number token]
+            end
+
+            # API Request structure
+            def request_structure
+              {
+                update_token_request: tokenization_attributes_structure.merge(
+                  {
+                    token:     token,
+                    card_data: card_data_attributes_structure
+                  }
+                )
+              }
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/requests/non_financial/tokenization/validate_token.rb

@@ -0,0 +1,43 @@
+module GenesisRuby
+  module Api
+    module Requests
+      module NonFinancial
+        module Tokenization
+          # Validates if a token is active, owned by a merchant, etc.
+          class ValidateToken < Base::Versioned
+
+            include Api::Mixins::Requests::NonFinancial::Tokenization::TokenAttributes
+            include Api::Mixins::Requests::NonFinancial::Tokenization::TokenizationAttributes
+
+            def initialize(configuration, builder_interface = Builder::XML)
+              super configuration, builder_interface
+
+              self.request_path = 'validate_token'
+            end
+
+            protected
+
+            # Validate Token field validations
+            def init_field_validations
+              super
+
+              required_fields.push *tokenization_required_fields, *%i[token]
+            end
+
+            # API Request structure
+            def request_structure
+              {
+                validate_token_request: tokenization_attributes_structure.merge(
+                  {
+                    token: token
+                  }
+                )
+              }
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/builder.rb

@@ -1,6 +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
@@ -16,12 +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/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

@@ -21,6 +21,9 @@ 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/base/consumer'
+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

@@ -90,17 +90,28 @@ module GenesisRuby
 
         # Define Headers
         def headers
-          headers = {
-            'Authorization' => "Basic #{request_data.user_login}",
-            'User-Agent'    => request_data.user_agent
-          }
+          data = common_headers
 
-          unless request_data.type == Api::Request::METHOD_GET
-            headers.merge! 'Content-Type'   => request_data.format,
-                           'Content-Length' => request_data.body&.length.to_s
-          end
+          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
 
-          headers
+        # Payload Headers
+        def payload_headers
+          {
+            'Content-Type'   => request_data.format,
+            'Content-Length' => request_data.body&.length.to_s
+          }
         end
 
         # Safe Request execution

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/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 transaction_date post_date)
             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,8 @@ 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
@@ -40,6 +46,19 @@ module GenesisRuby
           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,

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

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

data/lib/genesis_ruby/version.rb

@@ -1,5 +1,5 @@
 module GenesisRuby
 
-  VERSION = '0.2.2'.freeze
+  VERSION = '0.2.4'.freeze
 
 end