intercom 3.7.3 → 3.7.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 72074a3a5bc6699bf1a5d17aa79b7653fb1b5bc7
-  data.tar.gz: 46aab387557d19fa6db6a0b7d5b588640afb01f0
+  metadata.gz: ee56e3e11c13b620ee6b5a04c3eab742c6064297
+  data.tar.gz: 39bf3533177283eadb4c021bee58a38d889cbf4b
 SHA512:
-  metadata.gz: 4643efa421e81d2f548c6982e19d54b3234ae45c7b4fc1540be1200d10c533788cc58d0e3c871b6354d93586a0e8e51d9706b84a1698b2fdbf9b09db8af2a400
-  data.tar.gz: 11005b933a45e374f66481311aa15df949fbab2b006c4576304c9f5598ebad5c27dc22a496aec3ba3eb49e92f5b629358da8828e30096c81ac47575ab87d7564
+  metadata.gz: 236a3df567693a41cdcf45c761d0339748748581c048763850122e93efcf56b58633d951b20c9c2ce2f034ab1728c269d784378adae250059bf04b1dbbad5729
+  data.tar.gz: 5dacf1bcec13579a7161f9467d520174960a1544a03dc2f99cc2a6fdca959901db6ce7800c0dfed10bc235c6353a6e457398e410a59dc175e0c277b9abe1e525

data/README.md

@@ -22,7 +22,7 @@ This version of the gem is compatible with `Ruby 2.1` and above.
 
 Using bundler:
 
-    gem 'intercom', '~> 3.7.2'
+    gem 'intercom', '~> 3.7.3'
 
 ## Basic Usage
 

data/changes.txt

@@ -1,3 +1,6 @@
+3.7.3
+Added error handling for when an admin cannot be found.
+
 3.7.2
 Added error handling for when an app's custom attribute limits have been reached.
 

data/lib/intercom/client.rb

@@ -2,7 +2,7 @@ module Intercom
   class MisconfiguredClientError < StandardError; end
   class Client
     include Options
-    attr_reader :base_url, :rate_limit_details, :username_part, :password_part, :handle_rate_limit, :timeouts
+    attr_reader :base_url, :rate_limit_details, :username_part, :password_part, :handle_rate_limit, :timeouts, :api_version
 
     class << self
       def set_base_url(base_url)
@@ -25,7 +25,7 @@ module Intercom
       end
     end
 
-    def initialize(app_id: 'my_app_id', api_key: 'my_api_key', token: nil, base_url:'https://api.intercom.io', handle_rate_limit: false)
+    def initialize(app_id: 'my_app_id', api_key: 'my_api_key', token: nil, base_url:'https://api.intercom.io', handle_rate_limit: false, api_version: nil)
       if token
         @username_part = token
         @password_part = ""
@@ -35,6 +35,9 @@ module Intercom
       end
       validate_credentials!
 
+      @api_version = api_version
+      validate_api_version!
+
       @base_url = base_url
       @rate_limit_details = {}
       @handle_rate_limit = handle_rate_limit
@@ -123,9 +126,14 @@ module Intercom
       fail error if @username_part.nil?
     end
 
+    def validate_api_version!
+      error = MisconfiguredClientError.new("api_version must be either nil or a valid API version")
+      fail error if (@api_version && Gem::Version.new(@api_version) < Gem::Version.new('1.0'))
+    end
+
     def execute_request(request)
       request.handle_rate_limit = handle_rate_limit
-      request.execute(@base_url, username: @username_part, secret: @password_part, **timeouts)
+      request.execute(@base_url, username: @username_part, secret: @password_part, api_version: @api_version, **timeouts)
     ensure
       @rate_limit_details = request.rate_limit_details
     end

data/lib/intercom/errors.rb

@@ -81,6 +81,9 @@ module Intercom
   # Raised when unexpected nil returned from server
   class Intercom::HttpError < IntercomError; end
 
+  # Raised when an invalid api version is used
+  class ApiVersionInvalid < IntercomError; end
+
   #
   # Non-public errors (internal to the gem)
   #

data/lib/intercom/request.rb

@@ -19,6 +19,10 @@ module Intercom
       method.basic_auth(CGI.unescape(username), CGI.unescape(secret))
     end
 
+    def set_api_version(method, api_version)
+      method.add_field('Intercom-Version', api_version)
+    end
+
     def self.get(path, params)
       new(path, Net::HTTP::Get.new(append_query_string_to_url(path, params), default_headers))
     end
@@ -58,11 +62,12 @@ module Intercom
       net
     end
 
-    def execute(target_base_url=nil, username:, secret: nil, read_timeout: 90, open_timeout: 30)
+    def execute(target_base_url=nil, username:, secret: nil, read_timeout: 90, open_timeout: 30, api_version: nil)
       retries = 3
       base_uri = URI.parse(target_base_url)
       set_common_headers(net_http_method, base_uri)
       set_basic_auth(net_http_method, username, secret)
+      set_api_version(net_http_method, api_version) if api_version
       begin
         client(base_uri, read_timeout: read_timeout, open_timeout: open_timeout).start do |http|
           begin
@@ -180,6 +185,8 @@ module Intercom
         raise Intercom::MultipleMatchingUsersError.new(error_details['message'], error_context)
       when 'resource_conflict'
         raise Intercom::ResourceNotUniqueError.new(error_details['message'], error_context)
+      when 'intercom_version_invalid'
+        raise Intercom::ApiVersionInvalid.new(error_details['message'], error_context)
       when nil, ''
         raise Intercom::UnexpectedError.new(message_for_unexpected_error_without_type(error_details, parsed_http_code), error_context)
       else

data/lib/intercom/version.rb

@@ -1,3 +1,3 @@
 module Intercom #:nodoc:
-  VERSION = "3.7.3"
+  VERSION = "3.7.4"
 end

data/spec/unit/intercom/client_spec.rb

@@ -42,6 +42,29 @@ module Intercom
       proc { Client.new(app_id: nil, api_key: nil) }.must_raise MisconfiguredClientError
     end
 
+    describe 'API version' do
+      it 'does not set the api version by default' do
+        assert_nil(client.api_version)
+      end
+
+      it 'allows api version to be provided' do
+        Client.new(app_id: app_id, api_key: api_key, api_version: '1.0').api_version.must_equal('1.0')
+      end
+
+      it 'allows api version to be nil' do
+        # matches default behavior, and will honor version set in the Developer Hub
+        assert_nil(Client.new(app_id: app_id, api_key: api_key, api_version: nil).api_version)
+      end
+
+      it 'raises on invalid api version' do
+        proc { Client.new(app_id: app_id, api_key: api_key, api_version: '0.2') }.must_raise MisconfiguredClientError
+      end
+
+      it 'raises on empty api version' do
+        proc { Client.new(app_id: app_id, api_key: api_key, api_version: '') }.must_raise MisconfiguredClientError
+      end
+    end
+
     describe 'OAuth clients' do
       it 'supports "token"' do
         client = Client.new(token: 'foo')

data/spec/unit/intercom/request_spec.rb

@@ -72,7 +72,6 @@ describe 'Intercom::Request' do
       req.expects(:sleep).never.with(any_parameters)
       req.execute(target_base_url=uri, username: "ted", secret: "")
     end
-
   end
 
 
@@ -85,6 +84,14 @@ describe 'Intercom::Request' do
       req = Intercom::Request.put(uri, "")
       expect { req.execute(target_base_url=uri, username: "ted", secret: "") }.must_raise(Intercom::ResourceNotUniqueError)
     end
+
+    it 'should raise ApiVersionInvalid error on intercom_version_invalid code' do
+      # Use webmock to mock the HTTP request
+      stub_request(:put, uri).\
+      to_return(status: [400, "Bad Request"], headers: { 'X-RateLimit-Reset' => (Time.now.utc + 10).to_i.to_s }, body: {type: "error.list", errors: [ code: "intercom_version_invalid" ]}.to_json)
+      req = Intercom::Request.put(uri, "")
+      expect { req.execute(uri, username: "ted", secret: "") }.must_raise(Intercom::ApiVersionInvalid)
+    end
   end
 
   it 'parse_body returns nil if decoded_body is nil' do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: intercom
 version: !ruby/object:Gem::Version
-  version: 3.7.3
+  version: 3.7.4
 platform: ruby
 authors:
 - Ben McRedmond
@@ -15,7 +15,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-01-18 00:00:00.000000000 Z
+date: 2019-03-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest