frederick_api 0.4.3 → 0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 885bbe71573e83a6cd26d1321539c05885b09bf3
-  data.tar.gz: d8154b394e152ed1b15fa57704cec9588bdb083c
+SHA256:
+  metadata.gz: f39d405adb2db91e4cb552498c7188779cba58f587c7d2a35824f0cc18ee4587
+  data.tar.gz: 53b2858d0355ac8bba535e75d7950c0407cbfe61317b52f38d4623e002f044e4
 SHA512:
-  metadata.gz: '049c7b295aaeed0a069646b36cb66c95a6a4b6e4ccec7807c522e33e6fb0e16358ac3a71841dc3ab97c65f3b25eecfd45bd3277787ffa172fc6ecbe0353438f4'
-  data.tar.gz: da213d17ac1a57a7b176f8fa3e4e8e43b3d85299f84fb52cadd3c04714cb8d819ce9930867390a4402e7275fdf6ee30bf1866dcbce02a730242c9b9f0ca1b591
+  metadata.gz: 65a77c37baa3e8d3f170438d206a3095d21ca3b4548a6f009dd3cb450dcba43453c8f99f8704df0898a631b67dd3595002a7e7723d0c21124b1349869beba5ee
+  data.tar.gz: eabcd9f083df57b8b7350a405daa27cdaa8eebe82a00ea65694dbbf03bcbc0e94e0ec7bc2f5fd345106cd4ee30ddd327c31a4c24ca21317ac272b10dc2e4fa98

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,9 @@ 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'
+require 'frederick_api/v2/campaign'
+require 'frederick_api/v2/email_document'
 
 # 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/campaign.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module FrederickAPI
+  module V2
+    # V2 Campaign Resource
+    class Campaign < Resource
+      belongs_to :location
+
+      self.read_only_attributes += [:location_id]
+    end
+  end
+end

data/lib/frederick_api/v2/email_document.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module FrederickAPI
+  module V2
+    # V2 Email Document Resource
+    class EmailDocument < Resource
+      belongs_to :location
+
+      self.read_only_attributes += [:location_id]
+    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,24 @@ module FrederickAPI
       class Requestor < JsonApiClient::Query::Requestor
         attr_reader :path
 
+        # For backward compatibility, preserve these JSON API client errors instead of raising
+        # FrederickAPI::Errors::Error
+        JSON_API_CLIENT_PASSTHROUGH_ERRORS = [
+          JsonApiClient::Errors::NotAuthorized,
+          JsonApiClient::Errors::AccessDenied,
+          JsonApiClient::Errors::NotFound,
+          JsonApiClient::Errors::Conflict,
+          JsonApiClient::Errors::ServerError,
+          JsonApiClient::Errors::UnexpectedStatus
+        ].freeze
+
+        # 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 +39,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 +89,25 @@ 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 => e
+            handle_json_api_client_error(e)
+          end
+
+          def get_via_post_path?(path)
+            GET_VIA_POST_PATHS.any? { |r| r.match(path) }
+          end
+
+          def handle_json_api_client_error(error)
+            raise error if JSON_API_CLIENT_PASSTHROUGH_ERRORS.include?(error.class)
+
+            klass.parser.parse(klass, error.env.response)
+          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,7 +4,8 @@ module FrederickAPI
   module V2
     # /v2/users
     class User < Resource
-      has_many :roles
+      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.3'
+  VERSION = '0.7'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: frederick_api
 version: !ruby/object:Gem::Version
-  version: 0.4.3
+  version: '0.7'
 platform: ruby
 authors:
 - Frederick Engineering
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2018-01-09 00:00:00.000000000 Z
+date: 2020-11-14 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,13 +36,17 @@ 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/campaign.rb
 - lib/frederick_api/v2/communication_content.rb
 - lib/frederick_api/v2/contact.rb
 - lib/frederick_api/v2/contact_list.rb
 - lib/frederick_api/v2/contact_property.rb
 - lib/frederick_api/v2/contact_type.rb
+- lib/frederick_api/v2/email_document.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 +55,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 +77,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.14
-signing_key: 
+rubygems_version: 3.0.8
+signing_key:
 specification_version: 4
 summary: Frederick API Client
 test_files: []