giact_verification 0.1.0

data/lib/giact_verification/configuration.rb

@@ -0,0 +1,52 @@
+require 'yaml'
+
+module GiactVerification
+  class Configuration
+
+    attr_accessor :api_username
+    attr_accessor :api_password
+    attr_accessor :giact_endpoint
+
+    def initialize(args = {})
+      @giact_endpoint = :production
+    end
+
+    def invalid?
+      api_username.nil? || api_password.nil?
+    end
+
+    def servicing?(state)
+      serviced_states.include?(state)
+    end
+
+    def servicing_country?(country)
+      serviced_countries.include?(country)
+    end
+
+    def accepts_id_type?(id_type)
+      valid_alternative_id_types.include?(id_type)
+    end
+
+    def valid_account_type?(account_type)
+      valid_account_types.include?(account_type)
+    end
+
+    private
+
+    def valid_account_types
+      @valid_account_types ||= YAML.load_file(GiactVerification.config_directory + '/valid_account_types.yml')
+    end
+
+    def valid_alternative_id_types
+      @valid_alternative_id_types ||= YAML.load_file(GiactVerification.config_directory + '/alternative_id_types.yml')
+    end
+
+    def serviced_states
+      @serviced_states ||= YAML.load_file(GiactVerification.config_directory + '/serviced_states.yml')
+    end
+
+    def serviced_countries
+      @serviced_countries ||= YAML.load_file(GiactVerification.config_directory + '/serviced_countries.yml')
+    end
+  end
+end

data/lib/giact_verification/decorators/decorate_hash.rb

@@ -0,0 +1,22 @@
+module GiactVerification
+  class DecorateHash
+
+    def self.call(args)
+      new(args).call
+    end
+
+    def initialize(args)
+      @input = args[:hashable].to_h
+      @decorator = args.fetch(:decorator, GiactVerification::GiactSoapDecorator)
+    end
+
+    def call
+      input.map do |key, value|
+        decorator.call(key: key, value: value)
+      end.to_h
+    end
+
+    private
+    attr_reader :input, :decorator
+  end
+end

data/lib/giact_verification/decorators/giact_soap_decorator.rb

@@ -0,0 +1,32 @@
+module GiactVerification
+  class GiactSoapDecorator
+
+    KEYS_TO_UPCASE = [:state, :drivers_license_state, :country]
+
+    def self.call(args)
+      new(args).call
+    end
+
+    def initialize(args)
+      @key   = args[:key]
+      @value = args[:value]
+    end
+
+    def call
+      [key, modified_value]
+    end
+
+    private
+    attr_reader :key, :value
+
+    def modified_value
+      if value.methods.include?(:strftime)
+        value.strftime('%Y-%m-%d')
+      elsif KEYS_TO_UPCASE.include?(key)
+        value.upcase
+      else
+        value.to_s
+      end
+    end
+  end
+end

data/lib/giact_verification/errors.rb

@@ -0,0 +1,7 @@
+module GiactVerification
+  class ArgumentError < RuntimeError; end
+  class ConfigurationError < RuntimeError; end
+  class HTTPError < StandardError;end;
+  class MalformedXmlError < StandardError;end;
+  class GiactXmlError < StandardError;end;
+end

data/lib/giact_verification/etc/alternative_id_types.yml

@@ -0,0 +1,10 @@
+- UsaMilitaryId
+- UsaStateId
+- PassportUsa
+- PassportForeign
+- UsaResidentAlienId
+- StudentId
+- TribalId
+- DlCanada
+- DlMexico
+- OtherForeignId

data/lib/giact_verification/etc/check_validator_errors.yml

@@ -0,0 +1,11 @@
+en:
+  errors:
+    valid_account_type?:
+      arg:
+        default: 'Must be a valid account type (Checking, Savings or Other)'
+    routing_number_length?:
+      arg:
+        default: 'length must be 9 digits with no dashes or whitespace'
+    account_number_length?:
+      arg:
+        default: 'length must be between 4 and 17 digits with no dashes or whitespace'

data/lib/giact_verification/etc/customer_validator_errors.yml

@@ -0,0 +1,35 @@
+en:
+  errors:
+    serviced_state?:
+      arg:
+        default: 'must be a serviced US state or Canadian province (this includes all US states or CA provinces)'
+    serviced_country?:
+      arg:
+        default: 'must be a serviced country (US or CA)'
+    postal_code?:
+      arg:
+        default: 'must be a valid US (5 or 10 digit) or Canadian (7 digit) zip/postal code with no dashes or white space'
+    phone_number_length?:
+      arg:
+        default: 'length must be 10 digits with no dashes or whitespace'
+    phone_number_format?:
+      arg:
+        default: 'length must be 10 digits with 1-9 as the first digit (matching this regex: /[1-9][0-9]{9}/)'
+    last_four_ssn_length?:
+      arg:
+        default: 'length must be 4 digits with no dashes or white space'
+    ssn_or_ein_length?:
+      arg:
+        default: 'length must be 9 digits with no dashes or white space'
+    respond_to_strftime?:
+      arg:
+        default: "must be an object that responds to the method ':strftime'"
+    drivers_license_length?:
+      arg:
+        default: "length must be between 1-28 characters"
+    accepted_alternative_id?:
+      arg:
+        default: "id type must be one of the accepted alternative ids (UsaMilitaryId, UsaStateId, PassportUsa, PassportForeign, UsaResidentAlienId, StudentId, TribalId, DlCanada, DlMexico, or OtherForeignId)"
+    alternative_id_number_length?:
+      arg:
+        default: "length must be between 1 and 50 digits"

data/lib/giact_verification/etc/serviced_countries.yml

@@ -0,0 +1,2 @@
+- US
+- CA

data/lib/giact_verification/etc/serviced_states.yml

@@ -0,0 +1,78 @@
+# CANADA
+- 'AB'
+- 'BC'
+- 'MB'
+- 'NB'
+- 'NL'
+- 'NS'
+- 'NU'
+- 'ON'
+- 'PE'
+- 'QC'
+- 'SK'
+- 'NT'
+- 'YT'
+
+#UNITED STATES
+- 'AA'
+- 'AE'
+- 'AK'
+- 'AL'
+- 'AP'
+- 'AR'
+- 'AS'
+- 'AZ'
+- 'CA'
+- 'CO'
+- 'CT'
+- 'DC'
+- 'DE'
+- 'FL'
+- 'FM'
+- 'GA'
+- 'GU'
+- 'HI'
+- 'IA'
+- 'ID'
+- 'IL'
+- 'IN'
+- 'KS'
+- 'KY'
+- 'LA'
+- 'MA'
+- 'MD'
+- 'ME'
+- 'MH'
+- 'MI'
+- 'MN'
+- 'MO'
+- 'MP'
+- 'MS'
+- 'MT'
+- 'NC'
+- 'ND'
+- 'NE'
+- 'NH'
+- 'NJ'
+- 'NM'
+- 'NV'
+- 'NY'
+- 'OH'
+- 'OK'
+- 'OR'
+- 'PA'
+- 'PR'
+- 'PW'
+- 'RI'
+- 'SC'
+- 'SD'
+- 'TN'
+- 'TX'
+- 'UT'
+- 'VA'
+- 'VI'
+- 'VT'
+- 'WA'
+- 'WV'
+- 'WI'
+- 'WY'

data/lib/giact_verification/etc/valid_account_types.yml

@@ -0,0 +1,4 @@
+- Checking
+- Savings
+- Other
+

data/lib/giact_verification/extract_inquiry_result.rb

@@ -0,0 +1,26 @@
+module GiactVerification
+  class ExtractInquiryResult
+
+    def self.call(args)
+      new(args).call
+    end
+
+    def initialize(args)
+      @xml  = args[:xml]
+      @hash = GiactVerification::XmlToHash.call(xml: xml)
+    end
+
+    def call
+      @inquiry_result = hash.dig(:'soap:envelope', :'soap:body', :post_inquiry_response, :post_inquiry_result)
+
+      if inquiry_result == nil
+        raise MalformedXmlError, xml
+      end
+
+      inquiry_result
+    end
+
+    private
+    attr_reader :xml, :hash, :inquiry_result
+  end
+end

data/lib/giact_verification/inquiry_template_renderer.rb

@@ -0,0 +1,26 @@
+require 'erb'
+
+module GiactVerification
+  class InquiryTemplateRenderer
+
+    def self.call(args)
+      new(args).call
+    end
+
+    def initialize(args)
+      @substitutions = args[:substitutions]
+      @filepath      = GiactVerification.inquiry_template_directory
+    end
+
+    def call
+      ERB.new(template_contents, nil, '>').result(binding)
+    end
+
+    private
+    attr_reader :substitutions, :filepath, :rendered_template
+
+    def template_contents
+      File.read(filepath)
+    end
+  end
+end

data/lib/giact_verification/models/check.rb

@@ -0,0 +1,33 @@
+require 'ostruct'
+
+module GiactVerification
+  class Check < OpenStruct
+
+    def initialize(args)
+      @attributes       = args[:attributes]
+      @validation_class = args[:validation_class] || CheckValidator
+
+      super(attributes)
+    end
+
+    def invalid?
+      validator.failure?
+    end
+
+    def errors
+      validator.messages
+    end
+
+    def decorate_for_xml
+      GiactVerification::DecorateHash.call(hashable: self)
+    end
+
+    private
+    attr_reader :validation_class, :attributes
+
+    def validator
+      @validator ||= validation_class.call(self.to_h)
+    end
+  end
+end
+

data/lib/giact_verification/models/customer.rb

@@ -0,0 +1,33 @@
+require 'ostruct'
+
+module GiactVerification
+  class Customer < OpenStruct
+
+    def initialize(args)
+      @attributes        = args[:attributes]
+      @validation_class  = args[:validation_class] || CustomerValidator
+
+      super(attributes)
+    end
+
+    def invalid?
+      validator.failure?
+    end
+
+    def errors
+      validator.messages
+    end
+
+    def decorate_for_xml
+      GiactVerification::DecorateHash.call(hashable: self)
+    end
+
+    private
+    attr_reader :validation_class, :attributes
+
+    def validator
+      @validator ||= validation_class.call(self.to_h)
+    end
+  end
+end
+

data/lib/giact_verification/models/giact_xml.rb

@@ -0,0 +1,28 @@
+module GiactVerification
+  class GiactXml
+
+    def initialize(args)
+      @xml = args[:xml]
+      @validator = args[:validator] || GiactVerification::GiactXmlValidator
+    end
+
+    def valid?
+      @valid ||= validator.call(xml: xml)
+    end
+
+    def inquiry_result
+      if invalid?
+        raise GiactVerification::GiactXmlError, 'Cannot retrieve inquiry result from invalid xml'
+      else
+        @inquiry_result ||= GiactVerification::ExtractInquiryResult.call(xml: xml)
+      end
+    end
+
+    private
+    attr_reader :xml, :validator
+
+    def invalid?
+      !valid?
+    end
+  end
+end

data/lib/giact_verification/requests/production_requester.rb

@@ -0,0 +1,28 @@
+require 'uri'
+require 'net/http'
+
+module GiactVerification
+  class ProductionRequester
+
+    PRODUCTION_URI = URI.parse('https://api.giact.com/verificationservices/v5/InquiriesWS-5-8.asmx').freeze
+
+    def self.call(args)
+      new(args).call
+    end
+
+    def initialize(args)
+      @endpointable = PRODUCTION_URI
+      @body         = args[:body]
+    end
+
+    def call
+      http = Net::HTTP.new(endpointable.host, endpointable.port)
+      http.use_ssl = true
+
+      response = http.post(endpointable.path, body, 'Content-Type' => 'text/xml')
+    end
+
+    private
+    attr_reader :endpointable, :body
+  end
+end