frederick_api 0.4.2 → 0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 3405bd97d370f433b11cf71636a9a45eda63db2a
-  data.tar.gz: c67e2e1aad4e82a35b454f6f926e9440061c86e1
+SHA256:
+  metadata.gz: 9848d60ef419d88f6758574988f60f90337c64645316a0c716c12aaf497f43a9
+  data.tar.gz: 2e6096aeca9837b93ee25a2468bc7d3e2cf2712f6c735fb7330cf13a489f3b1e
 SHA512:
-  metadata.gz: 425f96c7393736efcc851f35a1627f16007c1daba10d52c138f16f8e065832bd13f1f24326c0e7448ff613978a6ff8412a30cc621a11e5d39161563977257f28
-  data.tar.gz: 278b005db0e22ca5f2791e3fa54b58d2ea29956a92ab3735a621b1a9e298c8c8f2bbbecb635e96c083690c7d8a128cddb73654088d024b64237457ed2e0ba420
+  metadata.gz: 06f920d1c60e09288bb9c75ef3b9be31168b93fe24ab681c33b1e2b77fb9127172e86608da5c8f862a43965867e1e33f571a91dfb80bd768cc9b227979b084dc
+  data.tar.gz: 738cf8ec474b270d81e79a95499325f62f70557baf09bc16220abd4d467564ead6607bf180bb22352bd309d78fdab6ce84435863341ea8c99c89985d430939b7

data/README.md

@@ -101,3 +101,14 @@ FrederickAPI::V2::Location.with_access_token(access_token) do
   # => [...]
 end
 ```
+### Background Jobs
+
+FrederickAPI Gem handles asynchronous responses as suggested in 
+[JSONApi Recommendations](https://jsonapi.org/recommendations/#asynchronous-processing) 
+[Asynchronous Processing](https://jsonapi.org/recommendations/#asynchronous-processing).
+Polling until the job is complete, fetching and returning the completed resource.
+
+* A FrederickAPI::V2::Errors::BackgroundJobFailure exception is raised if the API returns 
+an error on an asyncronous job.
+* A BackgroundJob Resource will be returned from the client in the case that a successful 
+ job does not return a resources.  

data/lib/frederick_api.rb

@@ -12,11 +12,13 @@ require 'frederick_api/v2/helpers/has_many'
 require 'frederick_api/v2/helpers/paginator'
 require 'frederick_api/v2/helpers/query_builder'
 require 'frederick_api/v2/helpers/requestor'
+require 'frederick_api/v2/helpers/backgroundable_parser'
 require 'frederick_api/v2/resource'
 require 'frederick_api/v2/public_resource'
 
 require 'frederick_api/v2/user'
 require 'frederick_api/v2/location'
+require 'frederick_api/v2/background_job'
 
 # Public resources
 require 'frederick_api/v2/business_category'
@@ -29,6 +31,7 @@ require 'frederick_api/v2/contact_property'
 require 'frederick_api/v2/contact_list'
 require 'frederick_api/v2/contact_type'
 require 'frederick_api/v2/interaction'
+require 'frederick_api/v2/role'
 
 # Namespace for all Frederick API client methods/classes
 module FrederickAPI

data/lib/frederick_api/v2/background_job.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module FrederickAPI
+  module V2
+    # V2 Frederick API async background job class for parsing
+    # background job responses coming from API.
+    class BackgroundJob < Resource
+      attr_accessor :response
+
+      def has_errors?
+        @attributes['status'] == 'error'
+      end
+
+      def retry_after
+        try_time = @response[:headers]['retry-after'].to_i
+        @retry_after ||= try_time > 1 ? try_time : 1
+      end
+
+      def response_code
+        @response_code ||= @response[:status]
+      end
+
+      def status
+        @attributes['status']
+      end
+
+      def errors
+        @attributes['messages']
+      end
+
+      def id
+        @attributes['id']
+      end
+    end
+  end
+end

data/lib/frederick_api/v2/errors/errors.rb

@@ -23,6 +23,10 @@ module FrederickAPI
       class BadRequest < Error; end
       class UnprocessableEntity < Error; end
 
+      # an exception class for when the server reports that a
+      # long running job has failed.
+      class BackgroundJobFailure < Error; end
+
       ERROR_CODES = {
         '400' => BadRequest,
         '422' => UnprocessableEntity

data/lib/frederick_api/v2/helpers/backgroundable_parser.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module FrederickAPI
+  module V2
+    module Helpers
+      # Custom Parser for parsing BackgroundJob resources for FrederickAPI V2
+      class BackgroundableParser < ::JsonApiClient::Parsers::Parser
+        def self.parse(klass, response)
+          result_set = super(klass, response)
+          return result_set unless result_set&.first&.type == 'background_jobs'
+          result_set = super(::FrederickAPI::V2::BackgroundJob, response)
+          result_set&.first&.response = { headers: response.headers, status: response.status }
+          result_set
+        end
+      end
+    end
+  end
+end

data/lib/frederick_api/v2/helpers/has_many.rb

@@ -20,7 +20,7 @@ module FrederickAPI
           def query_builder(url)
             association_class.query_builder.new(
               association_class,
-              association_class.requestor_class.new(association_class, url)
+              requestor: association_class.requestor_class.new(association_class, url)
             )
           end
 

data/lib/frederick_api/v2/helpers/query_builder.rb

@@ -9,9 +9,9 @@ module FrederickAPI
       class QueryBuilder < JsonApiClient::Query::Builder
         attr_reader :requestor
 
-        def initialize(klass, requestor = nil)
-          super(klass)
-          @requestor = requestor || klass.requestor
+        def initialize(klass, opts = {})
+          super(klass, opts)
+          @requestor = opts[:requestor] || klass.requestor
         end
 
         def params
@@ -23,17 +23,6 @@ module FrederickAPI
             .merge(additional_params)
         end
 
-        def find(args = {})
-          case args
-          when Hash
-            where(args)
-          else
-            @primary_key = args
-          end
-
-          requestor.get(params)
-        end
-
         def filter_params
           super_filter_params = super
 
@@ -65,6 +54,27 @@ module FrederickAPI
             { prefix => object }
           end
         end
+
+        protected
+
+          def _fetch
+            (requestor || klass.requestor).get(params)
+          end
+
+        private
+
+          def _new_scope(opts = {})
+            self.class.new(@klass,
+                           requestor:         requestor,
+                           primary_key:       opts.fetch(:primary_key, @primary_key),
+                           pagination_params: @pagination_params.merge(opts.fetch(:pagination_params, {})),
+                           path_params:       @path_params.merge(opts.fetch(:path_params, {})),
+                           additional_params: @additional_params.merge(opts.fetch(:additional_params, {})),
+                           filters:           @filters.merge(opts.fetch(:filters, {})),
+                           includes:          @includes + opts.fetch(:includes, []),
+                           orders:            @orders + opts.fetch(:orders, []),
+                           fields:            @fields + opts.fetch(:fields, []))
+          end
       end
     end
   end

data/lib/frederick_api/v2/helpers/requestor.rb

@@ -7,6 +7,13 @@ module FrederickAPI
       class Requestor < JsonApiClient::Query::Requestor
         attr_reader :path
 
+        # Paths that may have an unbounded query param length so we should always use a POST
+        # instead of a GET to get around AWS Cloudfront limitations
+        GET_VIA_POST_PATHS = [
+          %r{^.*locations\/[^\/]+\/contacts$},
+          %r{^.*locations\/[^\/]+\/interactions$}
+        ].map(&:freeze).freeze
+
         def initialize(klass, path = nil)
           @klass = klass
           @path = path
@@ -21,15 +28,49 @@ module FrederickAPI
           end
         end
 
+        def get(params = {})
+          path = resource_path(params)
+
+          params.delete(klass.primary_key)
+          if get_via_post_path?(path)
+            return request(:post, path, body: params.to_json, additional_headers: { 'X-Request-Method' => 'GET' })
+          end
+
+          request(:get, path, params: params)
+        end
+
+        def linked(path)
+          uri = URI.parse(path)
+          return super unless get_via_post_path?(uri.path)
+
+          path_without_params = "#{uri.scheme}://#{uri.host}#{uri.path}"
+          params = uri.query ? CGI.parse(uri.query).each_with_object({}) { |(k, v), h| h[k] = v[0] } : {}
+          request(:post, path_without_params, params: params, additional_headers: { 'X-Request-Method' => 'GET' })
+        end
+
         # Retry once on unhandled server errors
-        def request(type, path, params)
-          handle_errors(super)
-        rescue JsonApiClient::Errors::ConnectionError, JsonApiClient::Errors::ServerError => ex
-          raise ex if ex.is_a?(JsonApiClient::Errors::NotFound) || ex.is_a?(JsonApiClient::Errors::Conflict)
-          handle_errors(super)
+        def request(type, path, params: nil, body: nil, additional_headers: {})
+          headers = klass.custom_headers.merge(additional_headers)
+          make_request = proc do
+            handle_background(handle_errors(make_request(type, path, params: params, body: body, headers: headers)))
+          end
+
+          begin
+            make_request.call
+          rescue JsonApiClient::Errors::ConnectionError, JsonApiClient::Errors::ServerError => ex
+            raise ex if ex.is_a?(JsonApiClient::Errors::NotFound) || ex.is_a?(JsonApiClient::Errors::Conflict)
+            make_request.call
+          end
         end
 
         private
+          def handle_background(response)
+            return response unless
+                (job = response&.first).is_a?(::FrederickAPI::V2::BackgroundJob) && job.status != 'complete'
+            raise FrederickAPI::V2::Errors::BackgroundJobFailure, job if job.has_errors?
+            sleep job.retry_after
+            linked(job.links.attributes['self'])
+          end
 
           def handle_errors(result)
             return result unless result.has_errors?
@@ -37,6 +78,18 @@ module FrederickAPI
               FrederickAPI::V2::Errors::Error
             raise error_klass, result
           end
+
+          def make_request(type, path, params:, body:, headers:)
+            faraday_response = connection.run(type, path, params: params, body: body, headers: headers)
+            return klass.parser.parse(klass, faraday_response) unless faraday_response.status == 303
+            linked(faraday_response.headers['location'])
+          rescue JsonApiClient::Errors::ClientError => ex
+            klass.parser.parse(klass, ex.env.response)
+          end
+
+          def get_via_post_path?(path)
+            GET_VIA_POST_PATHS.any? { |r| r.match(path) }
+          end
       end
     end
   end

data/lib/frederick_api/v2/resource.rb

@@ -10,6 +10,7 @@ module FrederickAPI
       self.query_builder = FrederickAPI::V2::Helpers::QueryBuilder
       self.paginator = FrederickAPI::V2::Helpers::Paginator
       self.requestor_class = FrederickAPI::V2::Helpers::Requestor
+      self.parser = ::FrederickAPI::V2::Helpers::BackgroundableParser
 
       attr_accessor :custom_headers
 

data/lib/frederick_api/v2/role.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module FrederickAPI
+  module V2
+    # /v2/users
+    class Role < Resource
+      has_many :users
+    end
+  end
+end

data/lib/frederick_api/v2/user.rb

@@ -4,6 +4,8 @@ module FrederickAPI
   module V2
     # /v2/users
     class User < Resource
+      has_many :roles, class_name: 'FrederickAPI::V2::Role'
+      has_many :permitted_locations, class_name: 'FrederickAPI::V2::Location'
     end
   end
 end

data/lib/frederick_api/version.rb

@@ -2,5 +2,5 @@
 
 module FrederickAPI
   # Current gem version
-  VERSION = '0.4.2'
+  VERSION = '0.6'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: frederick_api
 version: !ruby/object:Gem::Version
-  version: 0.4.2
+  version: '0.6'
 platform: ruby
 authors:
 - Frederick Engineering
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2017-12-26 00:00:00.000000000 Z
+date: 2020-09-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json_api_client
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.5.3
+        version: 1.17.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.5.3
+        version: 1.17.1
 description: Ruby client for the Frederick API
 email:
 - tech@hirefrederick.com
@@ -36,6 +36,7 @@ files:
 - lib/frederick_api.rb
 - lib/frederick_api/configuration.rb
 - lib/frederick_api/v2/automation.rb
+- lib/frederick_api/v2/background_job.rb
 - lib/frederick_api/v2/business_category.rb
 - lib/frederick_api/v2/communication_content.rb
 - lib/frederick_api/v2/contact.rb
@@ -43,6 +44,7 @@ files:
 - lib/frederick_api/v2/contact_property.rb
 - lib/frederick_api/v2/contact_type.rb
 - lib/frederick_api/v2/errors/errors.rb
+- lib/frederick_api/v2/helpers/backgroundable_parser.rb
 - lib/frederick_api/v2/helpers/has_many.rb
 - lib/frederick_api/v2/helpers/paginator.rb
 - lib/frederick_api/v2/helpers/query_builder.rb
@@ -51,13 +53,14 @@ files:
 - lib/frederick_api/v2/location.rb
 - lib/frederick_api/v2/public_resource.rb
 - lib/frederick_api/v2/resource.rb
+- lib/frederick_api/v2/role.rb
 - lib/frederick_api/v2/user.rb
 - lib/frederick_api/version.rb
 homepage: https://github.com/HireFrederick/frederick_api_gem
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -72,9 +75,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.11
-signing_key: 
+rubygems_version: 3.0.8
+signing_key:
 specification_version: 4
 summary: Frederick API Client
 test_files: []