checkr-official 1.5.3 → 1.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 11baecc2701fe8183773014e0e0ca9f742927b18
-  data.tar.gz: 37d162612fedee47d704685bd1ffbba10687bc73
+SHA256:
+  metadata.gz: b0ee6cb8b70cdb9316063b99aac65380b7e41d52a06d6a48c8843993c2570b9f
+  data.tar.gz: c4d091feae1158ea8656a2119fe0833da5088663a3cc276f4b33765546bc291f
 SHA512:
-  metadata.gz: 719b7d97e082cf7ef6c3c1e5eee60effacd1ccbd4443c315ff5818f8db5d842e419cdec1fc18dd13ef6e5000bf650ee92e79654513b18fd3d4c8e949a91b7363
-  data.tar.gz: f3cb6255a0affca7bd97668a636b138a13ad1327a7711149c49787b00d90e118d1c9bd05a6275209c79d52e2d4a0dc764ece24aa841e71331f8a64bd701c1e68
+  metadata.gz: e0893885361a9e8e647e57c91cdb7861184af8aceb9eaeeaf721e96536d0f1a76240e0ed5d1fe39268298094ae37d6e4a2089de720bf1e448a034026e22328e8
+  data.tar.gz: ca30bce1ec02e0f9c5dc0a0366c6bded136d48da334c5ff38e4e1f44cea2b6586a92fdcc068e14908cd9f7615624c1cc805d0ddef2faea2e63448c261ffee1d4

data/Changelog.md

@@ -1,3 +1,22 @@
+## 1.7.1 (2021-08-31)
+* Remove usage of deprecated `URI.escape`  
+
+## 1.6.1 (2019-07-16)
+
+Features:
+
+- Add Adverse Action resource
+- Add Adverse Item resource
+
+## 1.6 (2019-05-20)
+
+- Add State Criminal Search
+- Add Employment Verification
+
+## v1.5.4 (2018-12-10)
+
+- Add ability to pass api key to individual API method calls
+
 ## v1.5.3 (2018-11-28)
 
 - Add geos to Report
@@ -16,8 +35,8 @@ Fixes:
 
 Features:
 
-- Add FederalCivilSearch
-- Add FederalCriminalSearch
+- Add Federal Civil Search
+- Add Federal Criminal Search
 
 ## v1.5.0 (2018-02-2)
 

data/RELEASE.md

@@ -0,0 +1,20 @@
+# Releasing a new version of checkr-official
+
+## Release process
+
+1. Create a list of all the changes since the prior release
+    1. Compare the latest release to master using
+       https://github.com/checkr/checkr-ruby/compare/`${latest}`...master
+    1. Open the linked pull requests from all the `Merge pull request #...` commits
+    1. For all non-documentation PRs, copy title (including pull request number)
+       into markdown list items
+    1. Sort into logical buckets, like "New", "Improvement", "Fix"
+    1. Reorganize to put the pull request number at the end of the line with author in parenthesis
+1. Ensure there are no breaking changes, or if there are breaking changes you'll need to bump
+   the major version, following [SemVer](https://semver.org/)
+1. Update the version
+    1. Update the constant in `lib/checkr/version.rb`
+    1. Commit and push to your branch
+    1. Get it reviewed and merge to master
+1. Move to master branch and pull last version
+1. Run the `bin/release` script to cut a release

data/bin/release

@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+# Usage: bin/release
+# Build the gem, tag master, push it to origin, and then release the package on RubyGems.
+
+set -e
+
+branch="$(git rev-parse --abbrev-ref HEAD)"
+[ "$branch" = "master" ] ||
+  (echo "You are not on master. First push your branch, get your PR reviewed, merge it on Github. "\
+    "Then locally move to master and pull last changes." && exit 1)
+
+version="$(gem build *.gemspec | grep Version: | awk '{print $2}')"
+[ -n "$version" ] || (echo "Version needs to be a number" && exit 1)
+
+echo $version
+#git tag "v$version"
+#git push origin "v$version"
+gem push *-${version}.gem

data/checkr-official.gemspec

@@ -21,7 +21,7 @@ Gem::Specification.new do |s|
   s.add_development_dependency('shoulda', '~> 3.4.0')
   s.add_development_dependency('activesupport', '~> 4.2.6')
   s.add_development_dependency('bump', '0.5.2')
-  s.add_development_dependency('rake', '10.4.2')
+  s.add_development_dependency('rake', '12.3.3')
   s.add_development_dependency('test-unit')
 
   s.files = `git ls-files`.split("\n")

data/lib/checkr/adverse_action.rb

@@ -0,0 +1,23 @@
+module Checkr
+  class AdverseAction < APIResource
+    attribute :status
+    attribute :report_id
+    attribute :post_notice_scheduled_at
+    attribute :post_notice_ready_at
+    attribute :canceled_at
+    attribute :individualized_assessment_engaged
+    attribute :adverse_items, APIList.constructor(:AdverseItem)
+
+    api_class_method :create, :post, '/v1/reports/:report_id/adverse_actions'
+    api_class_method :retrieve, :get, ':path/:id', :arguments => [:id]
+    api_class_method :cancel, :delete, ':path/:id', :arguments => [:id]
+
+    api_instance_method :cancel, :delete
+
+    def self.path
+      '/v1/adverse_actions'
+    end
+
+    APIClass.register_subclass(self, 'adverse_action')
+  end
+end

data/lib/checkr/adverse_item.rb

@@ -0,0 +1,9 @@
+module Checkr
+  class AdverseItem < APIResource
+    attribute :text
+
+    api_class_method :all, :get, '/v1/reports/:report_id/adverse_items', :constructor => :AdverseItemList
+
+    APIClass.register_subclass(self, 'adverse_item')
+  end
+end

data/lib/checkr/adverse_item_list.rb

@@ -0,0 +1,24 @@
+module Checkr
+  class AdverseItemList < APIList
+
+    attribute :next_href
+    attribute :previous_href
+    attribute :count
+    attr_accessor :parent
+
+    api_instance_method :all, :get
+
+    def self.construct(json, parent=nil)
+      lambda = constructor(:AdverseItem)
+      instance = lambda.call(json)
+      instance.parent = parent if parent
+      instance.clear_changed_attributes
+      instance
+    end
+
+    def path
+      parent.path + '/adverse_items'
+    end
+
+  end
+end

data/lib/checkr/employment_verification.rb

@@ -0,0 +1,18 @@
+module Checkr
+  class EmploymentVerification < APIResource
+
+    attribute :status
+    attribute :completed_at
+    attribute :turnaround_time
+    attribute :records
+
+    api_class_method :retrieve, :get, ':path/:id', arguments: [:id]
+
+    def self.path
+      '/v1/employment_verifications'
+    end
+
+    APIClass.register_subclass(self, 'employment_verification')
+
+  end
+end

data/lib/checkr/report.rb

@@ -11,6 +11,9 @@ module Checkr
     attribute :candidate, :Candidate
     attribute_writer_alias :candidate_id, :candidate
 
+    attribute :adverse_items, :AdverseItemList, :nested => true, :default => {}
+    attribute_writer_alias :adverse_item_ids, :adverse_items
+
     attribute :ssn_trace, :SSNTrace
     attribute_writer_alias :ssn_trace_id, :ssn_trace
 
@@ -29,6 +32,9 @@ module Checkr
     attribute :county_criminal_searches, APIList.constructor(:CountyCriminalSearch)
     attribute_writer_alias :county_criminal_search_ids, :county_criminal_searches
 
+    attribute :state_criminal_searches, APIList.constructor(:StateCriminalSearch)
+    attribute_writer_alias :state_criminal_search_ids, :state_criminal_searches
+
     attribute :federal_criminal_search, :FederalCriminalSearch
     attribute_writer_alias :federal_criminal_search_ids, :federal_criminal_search
 
@@ -50,6 +56,9 @@ module Checkr
     attribute :education_verification, :EducationVerification
     attribute_writer_alias :education_verification_id, :education_verification
 
+    attribute :employment_verification, :EmploymentVerification
+    attribute_writer_alias :employment_verification_id, :employment_verification
+
     api_class_method :retrieve, :get, ":path/:id", :arguments => [:id]
     api_class_method :create, :post
 

data/lib/checkr/state_criminal_search.rb

@@ -0,0 +1,22 @@
+module Checkr
+  class StateCriminalSearch < APIResource
+
+    attribute :status
+    attribute :completed_at
+    attribute :turnaround_time
+    attribute :state
+    attribute :records
+    attribute :filtered_by_positive_adjudication_records
+    attribute :estimated_completion_date
+    attribute :estimated_completion_time
+
+    api_class_method :retrieve, :get, ':path/:id', arguments: [:id]
+
+    def self.path
+      '/v1/state_criminal_searches'
+    end
+
+    APIClass.register_subclass(self, 'state_criminal_search')
+
+  end
+end

data/lib/checkr/util.rb

@@ -1,3 +1,5 @@
+require 'erb'
+
 module Checkr
   module Util
 
@@ -38,7 +40,7 @@ module Checkr
     end
 
     def self.escape(val)
-      URI.escape(val.to_s, Regexp.new("[^#{URI::PATTERN::UNRESERVED}]"))
+      ERB::Util.url_encode(val.to_s)
     end
 
     def self.symbolize_keys(obj)

data/lib/checkr/version.rb

@@ -1,3 +1,3 @@
 module Checkr
-  VERSION = '1.5.3'.freeze
+  VERSION = '1.7.1'.freeze
 end

data/lib/checkr.rb

@@ -18,11 +18,15 @@ require 'checkr/api_list'
 require 'checkr/util'
 
 # Requires for classes
+require 'checkr/adverse_action'
+require 'checkr/adverse_item'
+require 'checkr/adverse_item_list'
 require 'checkr/candidate'
 require 'checkr/county_criminal_search'
 require 'checkr/document'
 require 'checkr/document_list'
 require 'checkr/education_verification'
+require 'checkr/employment_verification'
 require 'checkr/eviction_search'
 require 'checkr/federal_civil_search'
 require 'checkr/federal_criminal_search'
@@ -37,6 +41,7 @@ require 'checkr/report'
 require 'checkr/report_list'
 require 'checkr/sex_offender_search'
 require 'checkr/ssn_trace'
+require 'checkr/state_criminal_search'
 require 'checkr/subscription'
 require 'checkr/verification'
 require 'checkr/verification_list'
@@ -61,6 +66,9 @@ module Checkr
   end
 
   def self.request(method, path, params={}, headers={})
+    api_key = params[:api_key] || self.api_key
+    params.delete(:api_key)
+
     verify_api_key(api_key)
 
     url = api_url(path)

data/samples/state_criminal_search.md

@@ -0,0 +1,59 @@
+# State Criminal Search
+
+## The State Criminal Search Object
+
+### Example Response
+
+```ruby
+#<Checkr::StateCriminalSearch:0x3fd909bcd974 id=539fdcf335644a0ef4000001> JSON: {
+  "status": "pending",
+  "completed_at": "2019-05-14T19:43:32Z",
+  "turnaround_time": 455685,
+  "state": "CA",
+  "records": [],
+  "id": "539fdcf335644a0ef4000001",
+  "object": "test_state_criminal_search",
+  "uri": "/v1/state_criminal_searches/539fdcf335644a0ef4000001",
+  "created_at": "2014-06-17T06:15:47Z",
+  "estimated_completion_time": "2019-05-09T21:40:45Z",
+  "estimated_completion_date": "2019-05-10",
+  "filtered_by_positive_adjudication_records": []
+}
+```
+
+
+## Retrieve an existing State Criminal Search
+
+### Definition
+
+```ruby
+Checkr::StateCriminalSearch.retrieve({STATE_CRIMINAL_SEARCH_ID})
+```
+
+### Example Request
+
+```ruby
+require 'checkr' # Note the gem is named checkr-official
+Checkr.api_key = "83ebeabdec09f6670863766f792ead24d61fe3f9"
+
+ccs = Checkr::StateCriminalSearch.retrieve("539fdcf335644a0ef4000001")
+```
+
+### Example Response
+
+```ruby
+#<Checkr::StateCriminalSearch:0x3fd909bcd974 id=539fdcf335644a0ef4000001> JSON: {
+  "status": "pending",
+  "completed_at": "2019-05-14T19:43:32Z",
+  "turnaround_time": 455685,
+  "state": "CA",
+  "records": [],
+  "id": "539fdcf335644a0ef4000001",
+  "object": "test_state_criminal_search",
+  "uri": "/v1/state_criminal_searches/539fdcf335644a0ef4000001",
+  "created_at": "2014-06-17T06:15:47Z",
+  "estimated_completion_time": "2019-05-09T21:40:45Z",
+  "estimated_completion_date": "2019-05-10",
+  "filtered_by_positive_adjudication_records": []
+}
+```

data/test/checkr/adverse_action_test.rb

@@ -0,0 +1,91 @@
+require File.expand_path('../../test_helper', __FILE__)
+
+module Checkr
+  class AdverseActionTest < Test::Unit::TestCase
+    setup do
+      @adverse_action_url = "#{Checkr.api_base}#{AdverseAction.path}"
+    end
+
+    should 'be registered' do
+      assert(APIClass.subclasses.include?(AdverseAction))
+      assert_equal(AdverseAction, APIClass.subclass_fetch('adverse_action'))
+    end
+
+    context 'Constructed AdverseAction instance' do
+      setup do
+        @adverse_action = AdverseAction.construct(test_adverse_action)
+      end
+
+      [
+        :id,
+        :object,
+        :uri,
+        :created_at,
+        :status,
+        :report_id,
+        :post_notice_scheduled_at,
+        :post_notice_ready_at,
+        :canceled_at,
+        :individualized_assessment_engaged,
+      ].each do |attribute|
+        should "have the #{attribute.to_s} attribute" do
+          assert_equal(test_adverse_action[attribute], @adverse_action.public_send(attribute))
+        end
+      end
+    end
+
+    context '.create' do
+      setup do
+        @report = Report.construct(test_report)
+        @create_url = "#{Checkr.api_base}#{Report.path}/#{@report.id}/adverse_actions"
+      end
+
+      should 'creates an instance of AdverseAction' do
+        @mock.expects(:post).once.with(@create_url, anything, anything)
+            .returns(test_response(test_adverse_action))
+
+        adverse_action = AdverseAction.create({ :report_id => @report.id })
+
+        assert(adverse_action.is_a?(AdverseAction))
+        assert_equal(test_adverse_action[:id], adverse_action.id)
+      end
+    end
+
+    context '.retrieve' do
+      setup do
+        @id = test_adverse_action[:id]
+        @retrieve_url = "#{Checkr.api_base}#{AdverseAction.path}/#{@id}"
+      end
+
+      should 'fetches an instance of AdverseAction' do
+        @mock.expects(:get).once.with(@retrieve_url, anything, anything)
+          .returns(test_response(test_adverse_action))
+
+        adverse_action = AdverseAction.retrieve(@id)
+
+        assert(adverse_action.is_a?(AdverseAction))
+        assert_equal(@id, adverse_action.id)
+      end
+    end
+
+    context '#cancel/.cancel' do
+      setup do
+        @id = test_adverse_action[:id]
+        @cancel_url = "#{Checkr.api_base}#{AdverseAction.path}/#{@id}"
+      end
+
+      should 'cancels an instance of AdverseAction' do
+        @mock.expects(:delete).twice.with(@cancel_url, anything, anything)
+          .returns(test_response(test_adverse_action))
+
+        adverse_action = AdverseAction.cancel(@id)
+        assert(adverse_action.is_a?(AdverseAction))
+        assert_equal(@id, adverse_action.id)
+
+        adverse_action = AdverseAction.new(@id).cancel
+        assert(adverse_action.is_a?(AdverseAction))
+        assert_equal(@id, adverse_action.id)
+      end
+    end
+  end
+end

data/test/checkr/adverse_item_test.rb

@@ -0,0 +1,49 @@
+require File.expand_path('../../test_helper', __FILE__)
+
+module Checkr
+  class AdverseItemTest < Test::Unit::TestCase
+    setup do
+      @report = Report.construct(test_report)
+      @adverse_item_url = "#{Checkr.api_base}#{@report.path}/adverse_items"
+    end
+
+    context 'Constructed AdverseItem instance' do
+      setup do
+        @adverse_item = AdverseItem.construct(test_adverse_item)
+      end
+
+      [
+        :id,
+        :object,
+        :uri,
+        :created_at,
+        :text,
+      ].each do |attribute|
+        should "have the #{attribute.to_s} attribute" do
+          assert_equal(test_adverse_item[attribute], @adverse_item.public_send(attribute))
+        end
+      end
+    end
+
+    context '.all' do
+      should 'return instances of AdverseItem' do
+        @mock.expects(:get).once.with do |url, params, opts|
+          url.start_with?(@adverse_item_url)
+        end.returns(test_response(test_adverse_item_list))
+
+        adverse_items = AdverseItem.all({ :report_id => @report.id })
+
+        assert(adverse_items.is_a?(AdverseItemList))
+        assert(adverse_items.length > 0)
+        adverse_items.each do |adverse_item|
+          assert(adverse_item.is_a?(AdverseItem))
+        end
+      end
+    end
+
+    should 'be registered' do
+      assert(APIClass.subclasses.include?(AdverseItem))
+      assert_equal(AdverseItem, APIClass.subclass_fetch('adverse_item'))
+    end
+  end
+end

data/test/checkr/api_class_test.rb

@@ -48,6 +48,47 @@ module Checkr
           :filter => 'test filter',
         })
       end
+
+      should 'allow passing an api_key as a param when the global api_key is set' do
+        response = test_response(test_mock_resource_list)
+        api_key = '123456'
+
+        @mock.expects(:get).with do |url, headers, params|
+          (url == "#{Checkr.api_base}#{MockResource.path}?page=1&filter=test%20filter" ||
+            url == "#{Checkr.api_base}#{MockResource.path}?filter=test%20filter&page=1") &&
+            params == nil &&
+            Checkr.api_key == 'foo'
+            headers["Authorization"] == "Basic #{Base64.encode64("#{api_key}:")}"
+        end.returns(response)
+
+        list = MockResource.all(
+          :page => 1,
+          :filter => 'test filter',
+          :api_key => api_key
+        )
+      end
+
+      should 'allow passing an api_key as a param when the global api_key is NOT set' do
+        response = test_response(test_mock_resource_list)
+        api_key = '123456'
+        Checkr.api_key = nil
+
+        
+        @mock.expects(:get).with do |url, headers, params|
+          (url == "#{Checkr.api_base}#{MockResource.path}?page=1&filter=test%20filter" ||
+            url == "#{Checkr.api_base}#{MockResource.path}?filter=test%20filter&page=1") &&
+            params == nil &&
+            headers["Authorization"] == "Basic #{Base64.encode64("#{api_key}:")}"
+        end.returns(response)
+
+        assert_equal(Checkr.api_key, nil)
+
+        list = MockResource.all(
+          :page => 1,
+          :filter => 'test filter',
+          :api_key => api_key
+        )
+      end
     end
 
     context 'Making a DELETE request' do
@@ -60,6 +101,19 @@ module Checkr
         end.returns(test_response({}))
         mock_resource.delete(:reason => "delinquent payments")
       end
+
+      should 'allow passing an api_key as a param' do
+        api_key = '123456'
+
+        @mock.expects(:get).once.returns(test_response(test_mock_resource))
+        mock_resource = MockResource.retrieve("fake_id")
+
+        @mock.expects(:delete).once.with do |url, headers, payload|
+          url == "#{Checkr.api_base}#{mock_resource.path}?reason=delinquent%20payments" && payload.nil? &&
+          headers["Authorization"] == "Basic #{Base64.encode64("#{api_key}:")}"
+        end.returns(test_response({}))
+        mock_resource.delete(:reason => "delinquent payments", :api_key => api_key)
+      end
     end
 
     context 'Making a PUT request' do
@@ -73,6 +127,20 @@ module Checkr
         end.returns(test_response(test_mock_resource))
         mock_resource.save
       end
+
+      should 'allow passing an api_key as a param' do
+        api_key = '123456'
+
+        @mock.expects(:get).once.returns(test_response(test_mock_resource))
+        mock_resource = MockResource.retrieve("fake_id")
+        mock_resource.name = "new name"
+
+        @mock.expects(:put).once.with do |url, headers, payload|
+          payload == { :name => "new name"} && 
+          headers["Authorization"] == "Basic #{Base64.encode64("#{api_key}:")}"
+        end.returns(test_response(test_mock_resource))
+        mock_resource.save(:api_key => api_key)
+      end
     end
 
     context 'Making a POST request' do
@@ -82,6 +150,17 @@ module Checkr
 
         MockResource.create(params)
       end
+
+      should 'allow passing an api_key as a param' do
+        api_key = '123456'
+
+        @mock.expects(:post).once.with do |url, headers, payload|
+          url == "#{Checkr.api_base}#{MockResource.path}" && payload == { :name => "some name" } &&
+          headers["Authorization"] == "Basic #{Base64.encode64("#{api_key}:")}"
+        end.returns(test_response(test_mock_resource))
+
+        MockResource.create(:name => "some name", :api_key => api_key)
+      end
     end
 
     context 'APIClass :default_params' do

data/test/checkr/employment_verification_test.rb

@@ -0,0 +1,80 @@
+require File.expand_path('../test_helper', __dir__)
+
+module Checkr
+  class EmploymentVerificationTest < Test::Unit::TestCase
+
+    setup do
+      @employment_verification_url = "#{Checkr.api_base}/v1/employment_verifications"
+    end
+
+    context 'EmploymentVerification class' do
+      should 'be retrieveable' do
+        id = 'employment_verification_id'
+        @mock.expects(:get).once.with("#{@employment_verification_url}/#{id}", anything, anything)
+          .returns(test_response(test_employment_verification))
+        employment_verification = EmploymentVerification.retrieve(id)
+        assert(employment_verification.is_a?(EmploymentVerification))
+      end
+    end
+
+    context 'EmploymentVerification instance' do
+      should 'be refreshable' do
+        @mock.expects(:get).once
+          .with("#{@employment_verification_url}/#{test_employment_verification[:id]}",
+                anything, anything)
+          .returns(test_response(test_employment_verification))
+        employment_verification = EmploymentVerification.new(test_employment_verification[:id])
+        employment_verification.refresh
+        assert_equal(test_employment_verification[:status], employment_verification.status)
+      end
+    end
+
+    context 'Retrieved EmploymentVerification instance' do
+      setup do
+        @mock.expects(:get).once.returns(test_response(test_employment_verification))
+        @employment_verification = EmploymentVerification.retrieve('employment_verification_id')
+      end
+
+      should 'have the id attribute' do
+        assert_equal(test_employment_verification[:id], @employment_verification.id)
+      end
+
+      should 'have the object attribute' do
+        assert_equal(test_employment_verification[:object], @employment_verification.object)
+      end
+
+      should 'have the uri attribute' do
+        assert_equal(test_employment_verification[:uri], @employment_verification.uri)
+      end
+
+      should 'have the status attribute' do
+        assert_equal(test_employment_verification[:status], @employment_verification.status)
+      end
+
+      should 'have the created_at attribute' do
+        assert_equal(test_employment_verification[:created_at],
+                     @employment_verification.created_at)
+      end
+
+      should 'have the completed_at attribute' do
+        assert_equal(test_employment_verification[:completed_at],
+                     @employment_verification.completed_at)
+      end
+
+      should 'have the turnaround_time attribute' do
+        assert_equal(test_employment_verification[:turnaround_time],
+                     @employment_verification.turnaround_time)
+      end
+
+      should 'have the records attribute' do
+        assert_equal(test_employment_verification[:records], @employment_verification.records)
+      end
+    end
+
+    should 'be registered' do
+      assert(APIClass.subclasses.include?(EmploymentVerification))
+      assert_equal(EmploymentVerification, APIClass.subclass_fetch('employment_verification'))
+    end
+
+  end
+end

data/test/checkr/state_criminal_search_test.rb

@@ -0,0 +1,82 @@
+require File.expand_path('../test_helper', __dir__)
+
+module Checkr
+  class StateCriminalSearchTest < Test::Unit::TestCase
+
+    setup do
+      @state_criminal_search_url = "#{Checkr.api_base}/v1/state_criminal_searches"
+    end
+
+    context 'StateCriminalSearch class' do
+      should 'be retrieveable' do
+        id = 'state_criminal_search_id'
+        @mock.expects(:get).once.with("#{@state_criminal_search_url}/#{id}", anything, anything)
+          .returns(test_response(test_state_criminal_search))
+        state_criminal_search = StateCriminalSearch.retrieve(id)
+        assert(state_criminal_search.is_a?(StateCriminalSearch))
+      end
+    end
+
+    context 'StateCriminalSearch instance' do
+      should 'be refreshable' do
+        @mock.expects(:get).once
+          .with("#{@state_criminal_search_url}/#{test_state_criminal_search[:id]}",
+                anything, anything)
+          .returns(test_response(test_state_criminal_search))
+        state_criminal_search = StateCriminalSearch.new(test_state_criminal_search[:id])
+        state_criminal_search.refresh
+        assert_equal(test_state_criminal_search[:status], state_criminal_search.status)
+      end
+    end
+
+    context 'Retrieved StateCriminalSearch instance' do
+      setup do
+        @mock.expects(:get).once.returns(test_response(test_state_criminal_search))
+        @state_criminal_search = StateCriminalSearch.retrieve('state_criminal_search_id')
+      end
+
+      should 'have the id attribute' do
+        assert_equal(test_state_criminal_search[:id], @state_criminal_search.id)
+      end
+
+      should 'have the object attribute' do
+        assert_equal(test_state_criminal_search[:object], @state_criminal_search.object)
+      end
+
+      should 'have the uri attribute' do
+        assert_equal(test_state_criminal_search[:uri], @state_criminal_search.uri)
+      end
+
+      should 'have the status attribute' do
+        assert_equal(test_state_criminal_search[:status], @state_criminal_search.status)
+      end
+
+      should 'have the created_at attribute' do
+        assert_equal(test_state_criminal_search[:created_at], @state_criminal_search.created_at)
+      end
+
+      should 'have the completed_at attribute' do
+        assert_equal(test_state_criminal_search[:completed_at], @state_criminal_search.completed_at)
+      end
+
+      should 'have the turnaround_time attribute' do
+        assert_equal(test_state_criminal_search[:turnaround_time],
+                     @state_criminal_search.turnaround_time)
+      end
+
+      should 'have the state attribute' do
+        assert_equal(test_state_criminal_search[:state], @state_criminal_search.state)
+      end
+
+      should 'have the records attribute' do
+        assert_equal(test_state_criminal_search[:records], @state_criminal_search.records)
+      end
+    end
+
+    should 'be registered' do
+      assert(APIClass.subclasses.include?(StateCriminalSearch))
+      assert_equal(StateCriminalSearch, APIClass.subclass_fetch('state_criminal_search'))
+    end
+
+  end
+end

data/test/test_data.rb

@@ -380,6 +380,22 @@ module Checkr
              :disposition_date=>"2011-06-02"}]}]}
     end
 
+    def test_state_criminal_search
+      { id: "5cd4265fd46fcf0001c6b8f3",
+        object: "state_criminal_search",
+        uri: "/v1/state_criminal_searches/5cd4265fd46fcf0001c6b8f3",
+        status: "clear",
+        state: "NY",
+        created_at: "2019-05-09T13:08:47Z",
+        completed_at: "2019-05-14T19:43:32Z",
+        turnaround_time: 455685,
+        estimated_completion_time: "2019-05-09T21:40:45Z",
+        estimated_completion_date: "2019-05-10",
+        records: [],
+        filtered_by_positive_adjudication_records: []
+      }
+    end
+
     def test_invitation
       { id: '2c8447d8c35761ad8f70d9d3',
         status: 'pending',
@@ -497,6 +513,7 @@ module Checkr
        :type=>"driver_license",
        :content_type=>"image/jpeg"}
     end
+
     def test_document_list
       {
         :object => 'list',
@@ -512,6 +529,7 @@ module Checkr
        :verification_url=>"http://verifications.checkr.com/db313e73383710d4fa2f18fd",
        :completed_at=>nil}
     end
+
     def test_verification_list
       {
         :object => 'list',
@@ -519,6 +537,46 @@ module Checkr
       }
     end
 
+    def test_adverse_item
+      {
+        :id => '71c0c2c79349c9f899bda22d3ccf60b7e0469266',
+        :object => 'adverse_item',
+        :text => 'License status: Suspended',
+      }
+    end
+
+    def test_adverse_item_list
+      {
+        :object => 'list',
+        :count => 2,
+        :data => [test_adverse_item, test_adverse_item],
+      }
+    end
+
+    def test_adverse_action
+      {
+        :id => '5d0af2cdfccff00034be49e9',
+        :object => 'adverse_action',
+        :uri => '/v1/adverse_actions/5d0af2cdfccff00034be49e9',
+        :created_at => '2019-06-20T02:43:25Z',
+        :status => 'pending',
+        :report_id => 'd36abda710bde8fd2c9d2587',
+        :post_notice_scheduled_at => '2019-06-27T02:43:25Z',
+        :post_notice_ready_at => '2019-06-27T02:43:25Z',
+        :canceled_at => nil,
+        :individualized_assessment_engaged => false,
+        :adverse_items => test_adverse_item_list,
+      }
+    end
+
+    def test_adverse_action_list
+      {
+        :object => 'list',
+        :count => 2,
+        :data => [test_adverse_action, test_adverse_action],
+      }
+    end
+
     def test_education_verification
       {:id => "5af5e030d24297006cce1e06",
        :object => "education_verification",
@@ -530,6 +588,17 @@ module Checkr
        :records => []}
     end
 
+    def test_employment_verification
+      { id: "5cd42657682ee80028cece4c",
+        object: "employment_verification",
+        uri: "/v1/employment_verifications/5cd42657682ee80028cece4c",
+        status: "clear",
+        created_at: "2019-05-09T13:08:39Z",
+        completed_at: "2019-05-13T12:50:47Z",
+        turnaround_time: 344528,
+        records: [] }
+    end
+
     # Errors
     def test_api_error
       {

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: checkr-official
 version: !ruby/object:Gem::Version
-  version: 1.5.3
+  version: 1.7.1
 platform: ruby
 authors:
 - Checkr Engineering Team
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2018-11-29 00:00:00.000000000 Z
+date: 2021-08-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client
@@ -100,14 +100,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 10.4.2
+        version: 12.3.3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 10.4.2
+        version: 12.3.3
 - !ruby/object:Gem::Dependency
   name: test-unit
   requirement: !ruby/object:Gem::Requirement
@@ -128,6 +128,7 @@ email:
 - eng@checkr.com
 executables:
 - checkr-console
+- release
 extensions: []
 extra_rdoc_files: []
 files:
@@ -138,10 +139,15 @@ files:
 - Gemfile
 - LICENSE
 - README.md
+- RELEASE.md
 - Rakefile
 - bin/checkr-console
+- bin/release
 - checkr-official.gemspec
 - lib/checkr.rb
+- lib/checkr/adverse_action.rb
+- lib/checkr/adverse_item.rb
+- lib/checkr/adverse_item_list.rb
 - lib/checkr/api_class.rb
 - lib/checkr/api_list.rb
 - lib/checkr/api_resource.rb
@@ -151,6 +157,7 @@ files:
 - lib/checkr/document.rb
 - lib/checkr/document_list.rb
 - lib/checkr/education_verification.rb
+- lib/checkr/employment_verification.rb
 - lib/checkr/errors/api_connection_error.rb
 - lib/checkr/errors/api_error.rb
 - lib/checkr/errors/authentication_error.rb
@@ -171,6 +178,7 @@ files:
 - lib/checkr/screening.rb
 - lib/checkr/sex_offender_search.rb
 - lib/checkr/ssn_trace.rb
+- lib/checkr/state_criminal_search.rb
 - lib/checkr/subscription.rb
 - lib/checkr/util.rb
 - lib/checkr/verification.rb
@@ -178,7 +186,7 @@ files:
 - lib/checkr/version.rb
 - mclovin.jpg
 - samples/candidate.md
-- samples/country_criminal_search.md
+- samples/county_criminal_search.md
 - samples/document.md
 - samples/geo.md
 - samples/global_watchlist_search.md
@@ -188,8 +196,11 @@ files:
 - samples/report.md
 - samples/sex_offender_search.md
 - samples/ssn_trace.md
+- samples/state_criminal_search.md
 - samples/subscription.md
 - tasks/api_test.rb
+- test/checkr/adverse_action_test.rb
+- test/checkr/adverse_item_test.rb
 - test/checkr/api_class_test.rb
 - test/checkr/api_list_test.rb
 - test/checkr/api_resource_test.rb
@@ -200,6 +211,7 @@ files:
 - test/checkr/document_list_test.rb
 - test/checkr/document_test.rb
 - test/checkr/education_verification_test.rb
+- test/checkr/employment_verification_test.rb
 - test/checkr/eviction_search_test.rb
 - test/checkr/federal_civil_search_test.rb
 - test/checkr/federal_criminal_search_test.rb
@@ -213,6 +225,7 @@ files:
 - test/checkr/report_test.rb
 - test/checkr/sex_offender_search_test.rb
 - test/checkr/ssn_trace_test.rb
+- test/checkr/state_criminal_search_test.rb
 - test/checkr/status_codes_test.rb
 - test/checkr/subscription_test.rb
 - test/checkr/util_test.rb
@@ -225,7 +238,7 @@ homepage: https://checkr.com/
 licenses:
 - Apache-2.0
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -240,12 +253,13 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.5.2.3
-signing_key: 
+rubygems_version: 3.0.3
+signing_key:
 specification_version: 4
 summary: Ruby bindings for Checkr API
 test_files:
+- test/checkr/adverse_action_test.rb
+- test/checkr/adverse_item_test.rb
 - test/checkr/api_class_test.rb
 - test/checkr/api_list_test.rb
 - test/checkr/api_resource_test.rb
@@ -256,6 +270,7 @@ test_files:
 - test/checkr/document_list_test.rb
 - test/checkr/document_test.rb
 - test/checkr/education_verification_test.rb
+- test/checkr/employment_verification_test.rb
 - test/checkr/eviction_search_test.rb
 - test/checkr/federal_civil_search_test.rb
 - test/checkr/federal_criminal_search_test.rb
@@ -269,6 +284,7 @@ test_files:
 - test/checkr/report_test.rb
 - test/checkr/sex_offender_search_test.rb
 - test/checkr/ssn_trace_test.rb
+- test/checkr/state_criminal_search_test.rb
 - test/checkr/status_codes_test.rb
 - test/checkr/subscription_test.rb
 - test/checkr/util_test.rb