hermes_api 0.2.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ba713d90a001a203b2183daced46a46ba80df789de7d7750983576a676cecbc2
-  data.tar.gz: 203653ed48a7a7bf6699313ece6c24b983d9ef490642f1b68c44f192cb371e2a
+  metadata.gz: 2b1313c32c78bfdd9fb7a8256298157ca5a13f8a92a5074edeb1671969cb5f43
+  data.tar.gz: 14a9dbfd88d46e2c0dce1e49baf0fd8d992332ac5051a60e24b7dc9af083c9a4
 SHA512:
-  metadata.gz: 423c6ff94ecf47a18771b5757b4daa022a580d9747b9a6e898bc7d34e489e243dc9a9aaa463cafe0846a8c90cec991122c8324c1a0e10d5e94cf96b49506dd65
-  data.tar.gz: 07d1efee834a66a3d5570a5729e003031512a15f8795c3c74f518fc0ac95fb1ad6abe8e44cf8b2a4cc84e2b61798e7cf3115644855fdfefc12e0a199f7f89840
+  metadata.gz: 8bab7f7db1681634318f832ce9e2aacd1d059025f2745dfddc6a115581dfaad5de7baa552ceb23116e31fa3dae7cbdc16f9200ddad8ad61b7a828156a3fd925b
+  data.tar.gz: 31f1ea2846b709e074a7a280b8ee7fa84820db2622370c2b011fe53d69d1bcd3ff536b921a8aaa20bfe2a6aad66d3098d1f81bea283866b74e9d5eb555e3cdff

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    hermes_api (0.1.0)
+    hermes_api (0.2.1)
       activeresource (>= 4.1.0, < 6.0.0)
 
 GEM
@@ -32,6 +32,7 @@ GEM
     dotenv (2.7.6)
     ffi (1.15.3)
     formatador (0.3.0)
+    gem-release (2.2.2)
     guard (2.17.0)
       formatador (>= 0.2.4)
       listen (>= 2.7, < 4.0)
@@ -117,6 +118,7 @@ PLATFORMS
 
 DEPENDENCIES
   dotenv
+  gem-release
   guard-rspec
   hermes_api!
   pry
@@ -127,4 +129,4 @@ DEPENDENCIES
   standard
 
 BUNDLED WITH
-   2.2.15
+   2.2.24

data/hermes_api.gemspec

@@ -3,15 +3,15 @@
 require_relative "lib/hermes_api/version"
 
 Gem::Specification.new do |spec|
-  spec.name          = "hermes_api"
-  spec.version       = HermesAPI::VERSION
-  spec.authors       = ["Andy Chong"]
-  spec.email         = ["andygg1996personal@gmail.com"]
-
-  spec.summary       = "Unofficial Ruby object based Hermes UK API wrapper."
-  spec.description   = "Unofficial Ruby object based Hermes UK API wrapper."
-  spec.homepage      = "https://github.com/PostCo/hermes_api"
-  spec.license       = "MIT"
+  spec.name = "hermes_api"
+  spec.version = HermesAPI::VERSION
+  spec.authors = ["Andy Chong"]
+  spec.email = ["andygg1996personal@gmail.com"]
+
+  spec.summary = "Unofficial Ruby object based Hermes UK API wrapper."
+  spec.description = "Unofficial Ruby object based Hermes UK API wrapper."
+  spec.homepage = "https://github.com/PostCo/hermes_api"
+  spec.license = "MIT"
   spec.required_ruby_version = Gem::Requirement.new(">= 2.4.0")
 
   spec.metadata["allowed_push_host"] = "https://rubygems.org/"
@@ -25,11 +25,11 @@ Gem::Specification.new do |spec|
   spec.files = Dir.chdir(File.expand_path(__dir__)) do
     `git ls-files -z`.split("\x0").reject { |f| f.match(%r{\A(?:test|spec|features)/}) }
   end
-  spec.bindir        = "exe"
-  spec.executables   = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.bindir = "exe"
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  spec.add_dependency "activeresource", ">= 4.1.0", "< 6.0.0" 
+  spec.add_dependency "activeresource", ">= 4.1.0", "< 6.0.0"
 
   spec.add_development_dependency "rspec", "~> 3.2"
   spec.add_development_dependency "dotenv"
@@ -37,6 +37,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "pry"
   spec.add_development_dependency "guard-rspec"
   spec.add_development_dependency "standard"
+  spec.add_development_dependency "gem-release"
 
   # Uncomment to register a new dependency of your gem
   # spec.add_dependency "example-gem", "~> 1.0"

data/lib/dev/config.rb

@@ -2,9 +2,12 @@ require "dotenv/load"
 
 def set_config
   HermesAPI.configure do |config|
-    config.user = ENV["HERMES_API_USER"] 
+    config.user = ENV["HERMES_API_USER"]
     config.password = ENV["HERMES_API_PASSWORD"]
     config.env = :test
     config.proxy = ENV["HERMES_API_PROXY"]
+    config.auth_id = ENV["HERMES_API_AUTH_ID"]
+    config.auth_secret = ENV["HERMES_API_AUTH_SECRET"]
+    config.api_key = ENV["HERMES_API_KEY"]
   end
-end 
+end

data/lib/dev/zeitwerk_loader.rb

@@ -8,6 +8,7 @@ loader.inflector.inflect(
 loader.push_dir("./lib")
 loader.collapse("./lib/hermes_api/resources")
 loader.ignore("#{__dir__}/config.rb")
+loader.ignore("./lib/hermes_api/cache.rb")
 loader.enable_reloading
 # loader.log!
 loader.setup

data/lib/hermes_api.rb

@@ -4,10 +4,16 @@ require_relative "hermes_api/version"
 require "active_resource"
 
 module HermesAPI
+  require "hermes_api/cache"
   require "hermes_api/configuration"
   require "hermes_api/creation_error"
   require "hermes_api/connection"
 
   require "hermes_api/resources/base"
   require "hermes_api/resources/return_label"
+  
+  require "hermes_api/resources/o_auth"
+  require "hermes_api/resources/json_base"
+  require "hermes_api/resources/print_in_store_qr"
+
 end

data/lib/hermes_api/cache.rb

@@ -0,0 +1,10 @@
+module HermesAPI
+  mattr_accessor :cache
+
+  self.cache = if defined?(Rails) && Rails.respond_to?(:cache) &&
+                  Rails.cache.is_a?(ActiveSupport::Cache::Store)
+    Rails.cache
+  else
+    ActiveSupport::Cache::MemoryStore.new
+  end
+end

data/lib/hermes_api/configuration.rb

@@ -1,11 +1,19 @@
 module HermesAPI
   class Configuration
-    attr_accessor :proxy, :env, :user, :password
+    attr_accessor :proxy, :env, :user, :password, :auth_id, :auth_secret, :api_key
   end
 
   PRODUCTION_SITE = "https://www.hermes-europe.co.uk"
   TESTING_SITE = "https://sit.hermes-europe.co.uk"
 
+  OAUTH_PRODUCTION_SITE = "https://hermes-client-integration-prod.eu.auth0.com"
+  OAUTH_TESTING_SITE = "https://hermes-client-integration-pre.eu.auth0.com"
+
+  JSON_PRODUCTION_SITE = "https://api.hermesworld.co.uk"
+  JSON_TESTING_SITE = "https://api.hermesworld.co.uk"
+  # temporarily disabled until it is fixed
+  # JSON_TESTING_SITE = "https://hermeslive-pre-prod.apigee.net"
+
   class << self
     def config
       @config ||= Configuration.new
@@ -16,6 +24,11 @@ module HermesAPI
       HermesAPI::Base.proxy = config.proxy
       HermesAPI::Base.user = config.user
       HermesAPI::Base.password = config.password
+
+      HermesAPI::JsonBase.site = config.env.to_s == "production" ? JSON_PRODUCTION_SITE : JSON_TESTING_SITE
+      HermesAPI::OAuth.site = config.env.to_s == "production" ? OAUTH_PRODUCTION_SITE : OAUTH_TESTING_SITE
+
+      HermesAPI::JsonBase.headers["apikey"] = config.api_key
     end
 
     def configure

data/lib/hermes_api/resources/json_base.rb

@@ -0,0 +1,26 @@
+module HermesAPI
+  class JsonBase < ActiveResource::Base
+    self.include_format_in_path = false
+    self.auth_type = :bearer
+
+    OAUTH_AUDIENCE = nil
+
+    def save
+      token = HermesAPI.cache.read("#{self.class.name}/oauth_token") || fetch_token
+      connection.bearer_token = token
+      super
+    end
+
+    private
+
+    def fetch_token
+      response = OAuth.create(audience: self.class::OAUTH_AUDIENCE)
+      HermesAPI.cache.write(
+        "#{self.class.name}/oauth_token",
+        response.access_token,
+        expires_in: response.expires_in - 15 # clear cache earlier
+      )
+      response.access_token
+    end
+  end
+end

data/lib/hermes_api/resources/o_auth.rb

@@ -0,0 +1,17 @@
+module HermesAPI
+  class OAuth < ActiveResource::Base
+    self.include_format_in_path = false
+    self.element_name=""
+    self.prefix="/oauth/token"
+
+    def initialize(attributes = {}, persisted = false)
+      attributes = {
+        grant_type: "client_credentials",
+        client_id: HermesAPI.config.auth_id,
+        client_secret: HermesAPI.config.auth_secret,
+        **attributes
+      }
+      super
+    end
+  end
+end

data/lib/hermes_api/resources/print_in_store_qr.rb

@@ -0,0 +1,14 @@
+module HermesAPI
+  class PrintInStoreQr < JsonBase
+    self.element_name = ""
+    self.prefix = "/client-print-in-store-api/v1/references"
+
+    OAUTH_AUDIENCE = "client-print-in-store-api"
+
+    def load(attributes, remove_root = false, persisted = false)
+      # remove the outer array before parsing the response body
+      attributes = attributes[0] if attributes.is_a?(Array) && attributes.length == 1
+      super
+    end
+  end
+end

data/lib/hermes_api/resources/return_label.rb

@@ -50,6 +50,8 @@ module HermesAPI
     rescue NameError
     end
 
+    alias_method :label, :labels
+
     def tracking_numbers
       entries = routingResponseEntries.routingResponseEntry
       if entries.is_a?(Array)
@@ -62,7 +64,65 @@ module HermesAPI
     rescue NameError
     end
 
-    alias_method :label, :labels
     alias_method :tracking_number, :tracking_numbers
+
+    def request_print_in_store_qr_code(attrs = {
+      dimensions: {
+        depth: 15,
+        length: 20,
+        width: 15,
+        weight: 1
+      },
+      value: {
+        currency: "GBP",
+        amount: 10
+      }
+    })
+      return nil if attributes["routingResponseEntries"].blank?
+
+      entries = routingResponseEntries.routingResponseEntry
+      entry = entries.is_a?(Array) ? entries[0] : entries
+      carrier = entry.inboundCarriers.carrier1
+      barcode = carrier.barcode1
+      customer = collectionRoutingRequestEntries[0].customer
+      address = customer.address
+
+      self.print_in_store_qr_code = PrintInStoreQr.create(
+        customer: {
+          customerReference1: customer.customerReference1
+        },
+        deliveryAddress: {
+          name: "#{address.firstName} #{address.lastName}",
+          addressLine1: address.addressLine1,
+          countryCode: address.countryCode,
+          postcode: address.postCode
+        },
+        labelType: "RETURN",
+        barcode: {
+          barcode: barcode.barcodeNumber,
+          barcodeDisplay: barcode.barcodeDisplay
+        },
+        client: {
+          clientId: clientId,
+          clientName: clientName
+        },
+        routing: {
+          deliveryMethod: {
+            deliveryMethodId: carrier.deliveryMethodCode,
+            deliveryMethodDescription: carrier.deliveryMethodDesc
+          },
+          sortLevels: {
+            sortLevel1: carrier.sortLevel1.strip,
+            sortLevel2: carrier.sortLevel2
+          }
+        },
+        serviceOffers: [],
+        **attrs
+      )
+    end
+
+    def base64_print_in_store_qr_code
+      as_json.dig("print_in_store_qr_code", "qrCode", "base64EncodedBytes")
+    end
   end
 end

data/lib/hermes_api/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module HermesAPI
-  VERSION = "0.2.1"
+  VERSION = "0.3.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hermes_api
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.0
 platform: ruby
 authors:
 - Andy Chong
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-07-07 00:00:00.000000000 Z
+date: 2021-08-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activeresource
@@ -114,6 +114,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: gem-release
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Unofficial Ruby object based Hermes UK API wrapper.
 email:
 - andygg1996personal@gmail.com
@@ -137,10 +151,14 @@ files:
 - lib/dev/config.rb
 - lib/dev/zeitwerk_loader.rb
 - lib/hermes_api.rb
+- lib/hermes_api/cache.rb
 - lib/hermes_api/configuration.rb
 - lib/hermes_api/connection.rb
 - lib/hermes_api/creation_error.rb
 - lib/hermes_api/resources/base.rb
+- lib/hermes_api/resources/json_base.rb
+- lib/hermes_api/resources/o_auth.rb
+- lib/hermes_api/resources/print_in_store_qr.rb
 - lib/hermes_api/resources/return_label.rb
 - lib/hermes_api/version.rb
 homepage: https://github.com/PostCo/hermes_api
@@ -166,7 +184,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.6
+rubygems_version: 3.2.22
 signing_key:
 specification_version: 4
 summary: Unofficial Ruby object based Hermes UK API wrapper.