intercom 2.4.4 → 2.5.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 82ddbad91e926ed0c894fe37d0695240b4057b45
-  data.tar.gz: 634738ed9ce4a02e1905a8d57d1c14deb46b540a
+  metadata.gz: 6cb2e27f3e7be79c2ad08dc54ab70fc0706dbc3c
+  data.tar.gz: 4ceabd2c867c299ed35cb1a38402ffa944c508fe
 SHA512:
-  metadata.gz: 2f185aab2e94659bece31fa08edfee6282b9757a51c2ee3d17ec6ec125b2208b9495c6cbac701b726c4db43d74cd39b9b701d8c2a39982ac67236b67ab042b8e
-  data.tar.gz: cff5588e8520d1f0589467642ba2b1fd94c599c00424eba192a345b77c5d6913b721685fe65bacd08174e6a4c6c2f66445b033661fd73850ddfc0d6a7e21bfee
+  metadata.gz: 15533df079a3388c672190e83d714d0999445f2c2d978f5905eeee01d9bad2254fe274ff5777d18047c9164e965333457e8124a1dc4062f8686c58d142ed6954
+  data.tar.gz: bc9d73e3c607f6052ca297330dc062e93cb521a6e8e1be8769776d129e20e717efd93b8dc09e36ab95a08fee68487f2878ed31c14fceb4673bf01edfc9a5774d

data/README.md

@@ -19,7 +19,7 @@ This version of the gem is compatible with `Ruby 2.1`, `Ruby 2.0` & `Ruby 1.9.3`
 
 Using bundler:
 
-    gem 'intercom', "~> 2.4.4"
+    gem 'intercom', "~> 2.5.4"
 
 ## Basic Usage
 
@@ -62,6 +62,8 @@ user = Intercom::User.find(:user_id => "1")
 user = Intercom::User.find(:id => "1")
 # Create a user
 user = Intercom::User.create(:email => "bob@example.com", :name => "Bob Smith", :signed_up_at => Time.now.to_i)
+# Delete a user
+deleted_user = Intercom::User.find(:id => "1").delete
 # Update custom_attributes for a user
 user.custom_attributes["average_monthly_spend"] = 1234.56; user.save
 # Perform incrementing
@@ -296,6 +298,24 @@ The metadata key values in the example are treated as follows-
 - order_number: a Rich Link (value contains 'url' and 'value' keys)
 - price: An Amount in US Dollars (value contains 'amount' and 'currency' keys)
 
+*NB:* This version of the gem reserves the field name `type` in Event data.
+
+### Contacts
+
+`Contacts` represent logged out users of your application.
+
+```ruby
+# Create a contact
+contact = Intercom::Contact.create(email: "some_contact@example.com")
+
+# Update a contact
+contact.custom_attributes['foo'] = 'bar'
+contact.save
+
+# Find contacts by email
+contacts = Intercom::Contact.find_all(email: "some_contact@example.com")
+```
+
 ### Subscriptions
 
 Subscribe to events in Intercom to receive webhooks.

data/changes.txt

@@ -1,3 +1,6 @@
+2.5.4
+ - Acquire support
+
 2.4.4
  - Fix parsing nil lists from notifications
 

data/lib/intercom.rb

@@ -1,4 +1,5 @@
 require "intercom/version"
+require "intercom/contact"
 require "intercom/user"
 require "intercom/company"
 require "intercom/note"

data/lib/intercom/api_operations/convert.rb

@@ -0,0 +1,19 @@
+require 'intercom/traits/api_resource'
+
+module Intercom
+  module ApiOperations
+    module Convert
+      def convert(user)
+        from_response(
+          Intercom.post(
+            "/contacts/convert",
+            {
+              contact: { user_id: user_id },
+              user: user.identity_hash
+            }
+          )
+        )
+      end
+    end
+  end
+end

data/lib/intercom/api_operations/save.rb

@@ -5,7 +5,14 @@ module Intercom
     module Save
 
       module ClassMethods
-        def create(params)
+        PARAMS_NOT_PROVIDED = Object.new
+        def create(params = PARAMS_NOT_PROVIDED)
+          if self.ancestors.include?(Intercom::Contact) && params == PARAMS_NOT_PROVIDED
+            params = Hash.new
+          elsif params == PARAMS_NOT_PROVIDED
+            raise ArgumentError, '.create requires 1 parameter'
+          end
+
           instance = self.new(params)
           instance.mark_fields_as_changed!(params.keys)
           instance.save
@@ -26,6 +33,10 @@ module Intercom
         from_response(response) if response # may be nil we received back a 202
       end
 
+      def identity_hash
+        respond_to?(:identity_vars) ? SliceableHash.new(to_hash).slice(*(identity_vars.map(&:to_s))) : {}
+      end
+
       private
 
       def id_present?
@@ -35,10 +46,6 @@ module Intercom
       def posted_updates?
         respond_to?(:update_verb) && update_verb == 'post'
       end
-
-      def identity_hash
-        respond_to?(:identity_vars) ? SliceableHash.new(to_hash).slice(*(identity_vars.map(&:to_s))) : {}
-      end
     end
   end
 end

data/lib/intercom/contact.rb

@@ -0,0 +1,22 @@
+require 'intercom/api_operations/count'
+require 'intercom/api_operations/load'
+require 'intercom/api_operations/find'
+require 'intercom/api_operations/find_all'
+require 'intercom/api_operations/save'
+require 'intercom/api_operations/convert'
+require 'intercom/traits/api_resource'
+
+module Intercom
+  class Contact
+    include ApiOperations::Load
+    include ApiOperations::Find
+    include ApiOperations::FindAll
+    include ApiOperations::Save
+    include ApiOperations::Convert
+    include Traits::ApiResource
+
+    def identity_vars ; [:email, :user_id] ; end
+    def flat_store_attributes ; [:custom_attributes] ; end
+    def update_verb; 'put' ; end
+  end
+end

data/lib/intercom/version.rb

@@ -1,3 +1,3 @@
 module Intercom #:nodoc:
-  VERSION = "2.4.4"
+  VERSION = "2.5.4"
 end

data/spec/unit/intercom/contact_spec.rb

@@ -0,0 +1,25 @@
+require "spec_helper"
+
+describe "Intercom::Contact" do
+  it 'should not throw ArgumentErrors when there are no parameters' do
+    Intercom.expects(:post)
+    Intercom::Contact.create
+  end
+
+  describe 'converting' do
+    let(:contact) { Intercom::Contact.from_api(user_id: 'contact_id') }
+    let(:user) { Intercom::User.from_api(id: 'user_id') }
+
+    it do
+      Intercom.expects(:post).with(
+        "/contacts/convert",
+        {
+          contact: { user_id: contact.user_id },
+          user: user.identity_hash
+        }
+      ).returns(test_user)
+
+      contact.convert(user)
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: intercom
 version: !ruby/object:Gem::Version
-  version: 2.4.4
+  version: 2.5.4
 platform: ruby
 authors:
 - Ben McRedmond
@@ -15,76 +15,76 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-01-19 00:00:00.000000000 Z
+date: 2015-05-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '5.4'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '5.4'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '10.3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '10.3'
 - !ruby/object:Gem::Dependency
   name: mocha
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
 - !ruby/object:Gem::Dependency
   name: fakeweb
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.3'
 - !ruby/object:Gem::Dependency
   name: json
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.8'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.8'
 description: 'Intercom (https://www.intercom.io) is a customer relationship management
@@ -103,8 +103,8 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- .gitignore
-- .travis.yml
+- ".gitignore"
+- ".travis.yml"
 - Gemfile
 - MIT-LICENSE
 - README.md
@@ -115,6 +115,7 @@ files:
 - lib/ext/sliceable_hash.rb
 - lib/intercom.rb
 - lib/intercom/admin.rb
+- lib/intercom/api_operations/convert.rb
 - lib/intercom/api_operations/count.rb
 - lib/intercom/api_operations/delete.rb
 - lib/intercom/api_operations/find.rb
@@ -124,6 +125,7 @@ files:
 - lib/intercom/api_operations/save.rb
 - lib/intercom/collection_proxy.rb
 - lib/intercom/company.rb
+- lib/intercom/contact.rb
 - lib/intercom/conversation.rb
 - lib/intercom/count.rb
 - lib/intercom/errors.rb
@@ -157,6 +159,7 @@ files:
 - spec/unit/intercom/admin_spec.rb
 - spec/unit/intercom/collection_proxy_spec.rb
 - spec/unit/intercom/company_spec.rb
+- spec/unit/intercom/contact_spec.rb
 - spec/unit/intercom/event_spec.rb
 - spec/unit/intercom/lib/flat_store_spec.rb
 - spec/unit/intercom/message_spec.rb
@@ -178,17 +181,17 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: 1.9.3
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: intercom
-rubygems_version: 2.0.14
+rubygems_version: 2.2.3
 signing_key: 
 specification_version: 4
 summary: Ruby bindings for the Intercom API
@@ -197,6 +200,7 @@ test_files:
 - spec/unit/intercom/admin_spec.rb
 - spec/unit/intercom/collection_proxy_spec.rb
 - spec/unit/intercom/company_spec.rb
+- spec/unit/intercom/contact_spec.rb
 - spec/unit/intercom/event_spec.rb
 - spec/unit/intercom/lib/flat_store_spec.rb
 - spec/unit/intercom/message_spec.rb
@@ -208,3 +212,4 @@ test_files:
 - spec/unit/intercom/traits/api_resource_spec.rb
 - spec/unit/intercom/user_spec.rb
 - spec/unit/intercom_spec.rb
+has_rdoc: