Support for the UK REST API

.env.example

@@ -2,5 +2,5 @@ UK_CARD_EXTERNAL_ID='ABCDEFGHIJKLM123'
 
 UK_REST_API_USERNAME='username'
 UK_REST_API_PASSWORD='password'
-UK_REST_API_MERCHANT_UNIQUE_TAG='tag'
-UK_REST_API_PROGRAM_UNIQUE_TAG='tag'
+UK_REST_API_MERCHANT_GROUP='tag'
+UK_REST_API_PROGRAM='tag'

.gitignore

@@ -1,4 +1,5 @@
 .env
 coverage
 Gemfile.lock
+spec/examples.txt
 spec/vcr_cassettes

.rubocop.yml

@@ -28,6 +28,10 @@ Lint/AmbiguousBlockAssociation:
   Exclude:
     - spec/**/*
 
+Metrics/BlockLength:
+  Exclude:
+    - spec/**/*
+
 RSpec/BeforeAfterAll:
   Enabled: false
 
@@ -58,6 +62,13 @@ Style/LambdaCall:
 Style/NegatedIf:
   Enabled: false
 
+Style/OptionalArguments:
+  Exclude:
+    - lib/eml/error/**/*
+
+Style/RaiseArgs:
+  Enabled: false
+
 Style/Send:
   Enabled: true
 
@@ -72,3 +83,8 @@ Style/TrailingCommaInArrayLiteral:
 
 Style/TrailingCommaInHashLiteral:
   EnforcedStyleForMultiline: consistent_comma
+
+Style/TrivialAccessors:
+  Exclude:
+    - lib/eml/uk/payload.rb
+    - lib/eml/uk/payload/**/*

Gemfile

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+
 source "https://rubygems.org"
 
 # Declare your dependencies in eml.gemspec

README.md

@@ -38,7 +38,7 @@ require "eml"
 EML::UK.configure do |config|
   config.username = "username"
   config.password = "password"
-  config.merchant = "merchant_id"
+  config.merchant_group = "merchant_id"
   config.program = "program_id"
 end
 ```

eml.gemspec

@@ -21,11 +21,17 @@ Gem::Specification.new do |s|
   s.require_paths = ["lib"]
 
   s.add_dependency "http", "~> 4.0.0"
+  s.add_dependency "sorbet-runtime"
 
+  s.add_development_dependency "dotenv"
+  s.add_development_dependency "faker"
+  s.add_development_dependency "pry-byebug"
   s.add_development_dependency "rspec", "~> 3.8"
   s.add_development_dependency "rubocop", "~> 0.71"
   s.add_development_dependency "rubocop-performance"
   s.add_development_dependency "rubocop-rspec"
   s.add_development_dependency "simplecov"
+  s.add_development_dependency "sorbet"
   s.add_development_dependency "vcr"
+  s.add_development_dependency "webmock"
 end

lib/eml.rb

@@ -1,10 +1,22 @@
+# typed: strong
 # frozen_string_literal: true
 
 require "http"
-
-require "eml/version"
-require "eml/api_operations"
-require "eml/uk"
+require "sorbet-runtime"
 
 module EML
 end
+
+require "eml/data/countries"
+require "eml/data/currencies"
+require "eml/data/states"
+
+require "eml/config"
+require "eml/environment"
+require "eml/error"
+require "eml/lib/endpoint_class"
+require "eml/parameters"
+require "eml/payload"
+require "eml/response"
+require "eml/uk"
+require "eml/version"

lib/eml/config.rb

@@ -0,0 +1,49 @@
+# typed: ignore
+# frozen_string_literal: true
+
+module EML
+  class Config
+    extend T::Sig
+
+    sig { returns(EML::Environment.class) }
+    def environment
+      EML::Environment
+    end
+
+    sig { params(value: Symbol).void }
+    def environment=(value)
+      EML::Environment.set(value)
+    end
+
+    sig { params(param: Symbol).returns(String) }
+    def require(param)
+      value = public_send(param)
+      return value unless value.nil? || value.empty?
+
+      require_error(param)
+    end
+
+    sig { params(param: Symbol).returns(String) }
+    def require_parameter(param)
+      require(param)
+    rescue ArgumentError => e
+      message = e.message + "\n" \
+        "Alternatively, you can pass dynamic values with your request " \
+        "parameters"
+      raise ArgumentError, message
+    end
+
+    private
+
+    sig { params(param: Symbol).void }
+    def require_error(param)
+      raise(
+        ArgumentError,
+        "#{param} is required but hasn't been set.\n" \
+          "EML::Config.configuration do |config|\n" +
+          %(  config.#{param} = "value") + "\n" \
+          "end"
+      )
+    end
+  end
+end