genesis_ruby 0.2.7 → 0.2.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7375cd2f010ae7260cfd9a2fb2e04bf62178f48353f40686f4fb3549620ea413
-  data.tar.gz: 9e28cff8451d213953caefd574b0039bd9eb44dd04797b9a26ea6d5f093be1df
+  metadata.gz: 28b3ffc2f8c2cb0705096ebfcccb8875a5c9c38e0d5e2231b5fa1b2cbdb24f67
+  data.tar.gz: 95da15fb47cb68a96da44147e48143a395b06ebd0e64c707564cf0e6045c814d
 SHA512:
-  metadata.gz: a817da3baca00bc23befdc0accbe6581a4726d824c38b23b624e127249f65fcd77a2626f757eded93ee309687253f9102738bc16ce0de79ae244497e2b150cad
-  data.tar.gz: e9065632b9ada6d805be664fb4b2370d06cc3ed2af04f7164e67e888d373041d0a554f71b45cd0bb75f955b3aa41b43b0444cf56ae95436975f32053bbffda4e
+  metadata.gz: daada6305af5b16335f35653ccf946b376811b76c4768b702a4e7d3c1c2456355f123a9baf1d5c07a257e2242d5af303dbcdd9e67330a429f3681e4df6177f02
+  data.tar.gz: b0298a9bff220ecdb6554dfe2a94faecc9cfd4dac03bbe1f1b90dbeb6baa2ff6a2b30c484214be3b385cb3d8d70f55af7485ccb2fd88b86cf0217504f9341338

data/CHANGELOG.md

@@ -1,3 +1,12 @@
+0.2.8
+-----
+**Features**
+
+* Add Smart Router support with single Reconcile
+* Add PATCH method support
+* Add Update Payee and Update Payee Account request support
+* Add parse_email restricted setter
+
 0.2.7
 -----
 **Features**:

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    genesis_ruby (0.2.7)
+    genesis_ruby (0.2.8)
       net-http (~> 0.3.2)
       nokogiri (~> 1.14)
 

data/README.md

@@ -1156,9 +1156,11 @@ GenesisRuby::Api::Requests::NonFinancial::Kyc::Transaction::Create
 ## Payee API
 GenesisRuby::Api::Requests::NonFinancial::Payee::Create
 GenesisRuby::Api::Requests::NonFinancial::Payee::Retrieve
+GenesisRuby::Api::Requests::NonFinancial::Payee::Update
 GenesisRuby::Api::Requests::NonFinancial::Payee::Account::Create
 GenesisRuby::Api::Requests::NonFinancial::Payee::Account::Retrieve
 GenesisRuby::Api::Requests::NonFinancial::Payee::Account::List
+GenesisRuby::Api::Requests::NonFinancial::Payee::Account::Update
 
 ## Chargeback API
 GenesisRuby::Api::Requests::NonFinancial::Fraud::Chargeback::Transaction

data/VERSION

@@ -1 +1 @@
-0.2.7
+0.2.8

data/lib/genesis_ruby/api/mixins/requests/customer_address/customer_info_attributes.rb

@@ -15,9 +15,7 @@ module GenesisRuby
 
             # Email of the customer
             def customer_email=(value)
-              raise GenesisRuby::ParameterError unless value.nil? || value =~ /\A.+@.+\..+\Z/
-
-              @customer_email = value
+              parse_email attribute: __method__, value: value, allow_empty: true
             end
 
           end

data/lib/genesis_ruby/api/mixins/requests/non_financial/kyc/verification_attributes.rb

@@ -17,9 +17,7 @@ module GenesisRuby
 
               # User's email
               def email=(value)
-                raise InvalidArgumentError unless value =~ /\A.+@.+\..+\Z/
-
-                @email = value
+                parse_email attribute: __method__, value: value
               end
 
               # Signifies that both sides of the document are required to verify the identity

data/lib/genesis_ruby/api/mixins/requests/non_financial/tokenization/tokenization_attributes.rb

@@ -19,14 +19,7 @@ module GenesisRuby
 
               # Consumer e-mail address
               def email=(value)
-                error_message = format(
-                  'Invalid value given for %{attribute}',
-                  attribute: __method__
-                )
-
-                raise GenesisRuby::ParameterError, error_message unless value.nil? || value =~ /\A.+@.+\..+\Z/
-
-                @email = value
+                parse_email attribute: __method__, value: value, allow_empty: true
               end
 
               protected

data/lib/genesis_ruby/api/mixins/requests/restricted_setter.rb

@@ -81,6 +81,16 @@ module GenesisRuby
             assign_instance_variable attribute, value
           end
 
+          # Parses given value to a valid email address and assign it to the given attribute
+          # If allow_empty is true, it will assign nil if the value is empty
+          def parse_email(attribute:, value:, allow_empty: false)
+            return assign_instance_variable attribute, nil if allow_empty && value.to_s.empty?
+
+            raise InvalidArgumentError, "#{attribute} must be a valid email address." unless value =~ /\A.+@.+\..+\Z/
+
+            assign_instance_variable attribute, value
+          end
+
           private
 
           # Helper for assigning a attribute to the class instance

data/lib/genesis_ruby/api/mixins/requests/smart_router_attributes.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module GenesisRuby
+  module Api
+    module Mixins
+      module Requests
+        # Smart Router Attributes Mixin
+        module SmartRouterAttributes
+
+          # Use Smart Router endpoint for the current request
+          def use_smart_router
+            @use_smart_router ||= false
+          end
+
+          # Use Smart Router endpoint for the current request
+          def use_smart_router=(value)
+            unless [true, false].include? value
+              raise InvalidArgumentError, 'Given invalid Use Smart Routing value! Allowed: true, false'
+            end
+
+            @use_smart_router = value
+          end
+
+          protected
+
+          # Process the request
+          def process_request_parameters
+            init_api_smart_router_configuration if use_smart_router
+
+            super
+          end
+
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/request.rb

@@ -20,6 +20,7 @@ module GenesisRuby
       METHOD_POST    = 'POST'
       METHOD_GET     = 'GET'
       METHOD_PUT     = 'PUT'
+      METHOD_PATCH   = 'PATCH'
 
       AUTH_TYPE_BASIC = 'basic'
       AUTH_TYPE_TOKEN = 'bearer'
@@ -85,6 +86,11 @@ module GenesisRuby
         @api_config.load_graphql_config
       end
 
+      # Pre-defined PATCH Request Configuration
+      def init_patch_configuration
+        @api_config.load_patch_config
+      end
+
       # Initializes Api EndPoint Url with request path & terminal token
       def init_api_gateway_configuration(options = { request_path: 'process', include_token: true })
         request_path  = options.fetch :request_path, 'process'

data/lib/genesis_ruby/api/requests/base/financial.rb

@@ -9,20 +9,7 @@ module GenesisRuby
 
           include Mixins::Requests::Financial::BaseAttributes
           include Mixins::Requests::Financial::PaymentAttributes
-
-          # Use Smart Router endpoint for the current request
-          def use_smart_router
-            @use_smart_router ||= false
-          end
-
-          # Use Smart Router endpoint for the current request
-          def use_smart_router=(value)
-            unless [true, false].include? value
-              raise InvalidArgumentError, 'Given invalid Use Smart Routing value! Allowed: true, false'
-            end
-
-            @use_smart_router = value
-          end
+          include Mixins::Requests::SmartRouterAttributes
 
           protected
 
@@ -44,13 +31,6 @@ module GenesisRuby
             init_api_smart_router_configuration if @configuration.force_smart_routing
           end
 
-          # Process the request
-          def process_request_parameters
-            init_api_smart_router_configuration if use_smart_router
-
-            super
-          end
-
           # Populate the request structure
           def populate_structure
             self.tree_structure = {

data/lib/genesis_ruby/api/requests/non_financial/payee/account/update.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+module GenesisRuby
+  module Api
+    module Requests
+      module NonFinancial
+        module Payee
+          module Account
+            # Update Payee Account
+            class Update < Base::Versioned
+
+              attr_accessor :payee_unique_id, :account_unique_id, :payee_account_country
+
+              # Retrieve Payee initialization
+              def initialize(configuration, _builder_interface = nil)
+                super configuration
+
+                self.request_path = 'payee/:payee_unique_id/account/:account_unique_id'
+
+                init_patch_configuration
+              end
+
+              protected
+
+              # Sets the request field validations
+              def init_field_validations
+                super
+
+                required_fields.push *%i[payee_unique_id account_unique_id payee_account_country]
+                field_values.merge! payee_account_country: GenesisRuby::Utils::Country::COUNTRIES.keys
+              end
+
+              # Returns the request structure
+              def request_structure
+                {
+                  account: {
+                    country: payee_account_country
+                  }
+                }
+              end
+
+              # Override API endpoint configuration
+              def process_request_parameters
+                super
+
+                processed_path = request_path.dup
+                                             .gsub(':payee_unique_id', payee_unique_id.to_s)
+                                             .gsub(':account_unique_id', account_unique_id.to_s)
+
+                init_api_service_configuration request_path: processed_path, include_token: false
+              end
+
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/genesis_ruby/api/requests/non_financial/payee/update.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module GenesisRuby
+  module Api
+    module Requests
+      module NonFinancial
+        module Payee
+          # Update Payee
+          class Update < Base::Versioned
+
+            attr_accessor :payee_unique_id, :payee_name, :payee_country
+
+            # Retrieve Payee initialization
+            def initialize(configuration, _builder_interface = nil)
+              super configuration
+
+              self.request_path = 'payee/:payee_unique_id'
+
+              init_patch_configuration
+            end
+
+            protected
+
+            # Sets the request field validations
+            def init_field_validations
+              super
+
+              required_fields.push *%i[
+                payee_unique_id
+              ]
+              field_values.merge! payee_country: GenesisRuby::Utils::Country::COUNTRIES.keys
+            end
+
+            # Returns the request structure
+            def request_structure
+              {
+                payee: {
+                  name:    payee_name,
+                  country: payee_country
+                }
+              }
+            end
+
+            # Override API endpoint configuration
+            def process_request_parameters
+              super
+
+              processed_path = request_path.dup.gsub(':payee_unique_id', payee_unique_id.to_s)
+
+              init_api_service_configuration request_path: processed_path, include_token: false
+            end
+
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -10,6 +10,8 @@ module GenesisRuby
           # which returned an error or has changed eg. has beed chargebacked.
           class Transaction < Api::Request
 
+            include Mixins::Requests::SmartRouterAttributes
+
             attr_accessor :arn, :transaction_id, :unique_id
 
             protected
@@ -18,6 +20,12 @@ module GenesisRuby
             def init_configuration
               init_xml_configuration
               init_api_gateway_configuration request_path: 'reconcile'
+              init_api_smart_router_configuration if @configuration.force_smart_routing
+            end
+
+            # Initialize Smart Router endpoint
+            def init_api_smart_router_configuration
+              api_config.url = build_request_url({ subdomain: 'smart_router', path: 'reconcile' })
             end
 
             # API Request structure

data/lib/genesis_ruby/builder.rb

@@ -4,6 +4,7 @@ require 'genesis_ruby/builders/xml'
 require 'genesis_ruby/builders/form'
 require 'genesis_ruby/builders/json'
 require 'genesis_ruby/builders/graphql'
+require 'genesis_ruby/builders/patch'
 require 'genesis_ruby/errors/builder_error'
 
 module GenesisRuby
@@ -22,6 +23,9 @@ module GenesisRuby
     # Builder GraphQL
     GRAPHQL = 'graphql'
 
+    # Builder PATCH
+    PATCH = 'patch'
+
     # Initialize the Builder Interface based on the Request requirements
     def initialize(request_interface)
       case request_interface
@@ -29,6 +33,7 @@ module GenesisRuby
       when FORM then @builder_context = Builders::Form.new
       when JSON then @builder_context = Builders::Json.new
       when GRAPHQL then @builder_context = Builders::Graphql.new
+      when PATCH then @builder_context = Builders::Patch.new
       else
         raise GenesisRuby::BuilderError, 'Invalid Builder interface!'
       end

data/lib/genesis_ruby/builders/patch.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require 'genesis_ruby/builders/base'
+require 'json'
+
+module GenesisRuby
+  module Builders
+    # PATCH Document builder
+    class Patch < Base
+
+      # PATCH constructor
+      def initialize
+        @document = ''
+
+        super
+      end
+
+      # PATCH output string
+      def output
+        @document
+      end
+
+      # Generate PATCH 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/network/adapter/net_http_adapter.rb

@@ -32,6 +32,7 @@ module GenesisRuby
             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
             when Api::Request::METHOD_GET then @response = @request.get path, headers
+            when Api::Request::METHOD_PATCH then @response = @request.patch path, request_data.body, headers
             else raise 'Invalid Request Type!'
             end
           end

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

@@ -63,6 +63,17 @@ module GenesisRuby
           self.bearer_token          = nil
         end
 
+        # Load pre-defined PATCH configuration
+        def load_patch_config
+          self.protocol              = GenesisRuby::Api::Request::PROTOCOL_HTTPS
+          self.port                  = GenesisRuby::Api::Request::PORT_HTTPS
+          self.type                  = GenesisRuby::Api::Request::METHOD_PATCH
+          self.format                = Builder::PATCH
+          self.parser_skip_root_node = false
+          self.authorization         = GenesisRuby::Api::Request::AUTH_TYPE_BASIC
+          self.bearer_token          = nil
+        end
+
       end
     end
   end

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

@@ -35,7 +35,8 @@ module GenesisRuby
           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'
+          when Builder::PATCH then 'application/json'
+          else raise InvalidArgumentError, 'Invalid request format type. Allowed are XML, JSON, FORM AND PATCH'
           end
         end
 

data/lib/genesis_ruby/version.rb

@@ -2,6 +2,6 @@
 
 module GenesisRuby
 
-  VERSION = '0.2.7'
+  VERSION = '0.2.8'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: genesis_ruby
 version: !ruby/object:Gem::Version
-  version: 0.2.7
+  version: 0.2.8
 platform: ruby
 authors:
 - emerchantpay Ltd.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-07-02 00:00:00.000000000 Z
+date: 2025-08-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: net-http
@@ -416,6 +416,7 @@ files:
 - lib/genesis_ruby/api/mixins/requests/non_financial/tokenization/token_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/non_financial/tokenization/tokenization_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/restricted_setter.rb
+- lib/genesis_ruby/api/mixins/requests/smart_router_attributes.rb
 - lib/genesis_ruby/api/mixins/requests/wpf_reminders_attributes.rb
 - lib/genesis_ruby/api/notification.rb
 - lib/genesis_ruby/api/request.rb
@@ -537,8 +538,10 @@ files:
 - lib/genesis_ruby/api/requests/non_financial/payee/account/create.rb
 - lib/genesis_ruby/api/requests/non_financial/payee/account/list.rb
 - lib/genesis_ruby/api/requests/non_financial/payee/account/retrieve.rb
+- lib/genesis_ruby/api/requests/non_financial/payee/account/update.rb
 - lib/genesis_ruby/api/requests/non_financial/payee/create.rb
 - lib/genesis_ruby/api/requests/non_financial/payee/retrieve.rb
+- lib/genesis_ruby/api/requests/non_financial/payee/update.rb
 - lib/genesis_ruby/api/requests/non_financial/processed_transactions/date_range.rb
 - lib/genesis_ruby/api/requests/non_financial/processed_transactions/post_date_range.rb
 - lib/genesis_ruby/api/requests/non_financial/processed_transactions/transaction.rb
@@ -560,6 +563,7 @@ files:
 - lib/genesis_ruby/builders/form.rb
 - lib/genesis_ruby/builders/graphql.rb
 - lib/genesis_ruby/builders/json.rb
+- lib/genesis_ruby/builders/patch.rb
 - lib/genesis_ruby/builders/xml.rb
 - lib/genesis_ruby/configuration.rb
 - lib/genesis_ruby/connection.rb