Merge pull request #7 from intercom/BL/contacts

Contacts

Author: bobjflong

README.md

@@ -68,6 +68,50 @@ client.users.find({ id: '1234' }, callback);
 client.users.delete({ id: '1234' }, callback);
 ```
 
+## Contacts
+
+```node
+// Create a contact
+client.contacts.create(function (r) {
+  console.log(r);
+});
+```
+
+```node
+// Update a contact by id
+client.contacts.update({ id: '5435345', email: '[email protected]' }, callback);
+```
+
+```node
+// List contacts
+client.contacts.list(callback);
+```
+
+```node
+// List contacts by email
+client.contacts.listBy({ email: '[email protected]' }, callback);
+```
+
+
+```node
+// Find contact by id
+client.contacts.find({ id: '5342423' }, callback);
+```
+
+```node
+// Delete contact by id
+client.contacts.find({ id: '5342423' }, callback);
+```
+
+```node
+// Convert Contacts into Users
+var conversion = {
+  contact: { user_id: '1234-5678-9876' },
+  user: { email: '[email protected]' }
+};
+client.contacts.convert(conversion, callback);
+```
+
 ## Companies
 
 ```node
@@ -94,8 +138,9 @@ client.companies.find({ id: '1234' }, callback);
 
 ```node
 // List company users
-client.company.listUsers({ id: '1234' }, callback);
+client.companies.listUsers({ id: '1234' }, callback);
 ```
+
 ## Events
 
 ```node

lib/client.js

@@ -2,6 +2,7 @@ var unirest = require('unirest');
 import {User} from './user';
 import {Event} from './event';
 import {Company} from './company';
+import {Contact} from './contact';
 
 export class Client {
   constructor(appId, appApiKey) {
@@ -10,6 +11,7 @@ export class Client {
     this.users = new User(this);
     this.events = new Event(this);
     this.companies = new Company(this);
+    this.contacts = new Contact(this);
   }
   ping(f) {
     unirest.get('https://api.intercom.io/admins')

lib/contact.js

@@ -0,0 +1,28 @@
+export class Contact {
+  constructor(client) {
+    this.client = client;
+  }
+  create(f) {
+    this.client.post('/contacts', {}, f);
+  }
+  update(params, f) {
+    let id = params.id;
+    delete params.id;
+    this.client.post(`/contacts/${id}`, params, f);
+  }
+  list(f) {
+    this.client.get('/contacts', {}, f);
+  }
+  listBy(params, f) {
+    this.client.get('/contacts', params, f);
+  }
+  find(params, f) {
+    this.client.get(`/contacts/${params.id}`, {}, f);
+  }
+  delete(params, f) {
+    this.client.delete(`/contacts/${params.id}`, {}, f);
+  }
+  convert(params, f) {
+    this.client.post('/contacts/convert', params, f);
+  }
+}

test/contact.js

@@ -0,0 +1,66 @@
+import assert from 'assert';
+import {Client} from '../lib';
+var nock = require('nock');
+
+describe('contacts', function () {
+  it('should be created', function (done) {
+    nock('https://api.intercom.io').post('/contacts').reply(200, {});
+    let client = new Client('foo', 'bar');
+    client.contacts.create(function (r) {
+      assert.equal(200, r.status);
+      done();
+    });
+  });
+  it('should be updated', function (done) {
+    nock('https://api.intercom.io').post('/contacts/baz', { email: '[email protected]' }).reply(200, {});
+    let client = new Client('foo', 'bar');
+    client.contacts.update({ id: 'baz', email: '[email protected]' }, function (r) {
+      assert.equal(200, r.status);
+      done();
+    });
+  });
+  it('should list', function (done) {
+    nock('https://api.intercom.io').get('/contacts').reply(200, {});
+    let client = new Client('foo', 'bar');
+    client.contacts.list(function (r) {
+      assert.equal(200, r.status);
+      done();
+    });
+  });
+  it('should list by params', function (done) {
+    nock('https://api.intercom.io').get('/contacts').query({ email: '[email protected]' }).reply(200, {});
+    let client = new Client('foo', 'bar');
+    client.contacts.listBy({ email: '[email protected]' }, function (r) {
+      assert.equal(200, r.status);
+      done();
+    });
+  });
+  it('should find by id', function (done) {
+    nock('https://api.intercom.io').get('/contacts/baz').reply(200, {});
+    let client = new Client('foo', 'bar');
+    client.contacts.find({ id: 'baz' }, function (r) {
+      assert.equal(200, r.status);
+      done();
+    });
+  });
+  it('delete by id', function (done) {
+    nock('https://api.intercom.io').delete('/contacts/baz').reply(200, {});
+    let client = new Client('foo', 'bar');
+    client.contacts.delete({ id: 'baz' }, function (r) {
+      assert.equal(200, r.status);
+      done();
+    });
+  });
+  it('should convert', function (done) {
+    let conversionObject = {
+      contact: { user_id: 'baz' },
+      user: { email: 'bang' }
+    };
+    nock('https://api.intercom.io').post('/contacts/convert', conversionObject).reply(200, {});
+    let client = new Client('foo', 'bar');
+    client.contacts.convert(conversionObject, function (r) {
+      assert.equal(200, r.status);
+      done();
+    });
+  });
+});

test/user.js

@@ -27,15 +27,15 @@ describe('users', function () {
       done();
     });
   });
-  it('find users by id', function (done) {
+  it('should find users by id', function (done) {
     nock('https://api.intercom.io').get('/users/baz').reply(200, {});
     let client = new Client('foo', 'bar');
     client.users.find({ id: 'baz' }, function (r) {
       assert.equal(200, r.status);
       done();
     });
   });
-  it('deletes users by id', function (done) {
+  it('should delete users by id', function (done) {
     nock('https://api.intercom.io').delete('/users/baz').reply(200, {});
     let client = new Client('foo', 'bar');
     client.users.delete({ id: 'baz' }, function (r) {