Bulk User support

Author: bobjflong

README.md

@@ -533,3 +533,26 @@ foreach ($iterator as $contact) {
   print_r($contact);
 }
 ```
+
+#### Bulk API
+
+The [Bulk APIs](https://doc.intercom.io/api/#bulk-apis) are themselves in Beta:
+
+```php
+// Create or update a batch of users
+$result = $intercom->bulkUsers(
+[
+  'items' => [
+    [
+      'data_type' => 'user',
+      'method' => 'post', // can be 'delete'
+      'data' => [
+        'email' => '[email protected]',
+        'name' => 'Pi'
+      ]
+    ],
+    ...
+  ]
+]);
+```
+

src/Intercom/Service/config/intercom_public_user.json

@@ -240,9 +240,60 @@
             "responseType": "model",
             "summary": "Deletes a user given id, email or user_id",
             "uri": "/users"
+        },
+        "bulkUsers": {
+            "httpMethod": "POST",
+            "parameters": {
+                "items": {
+                    "location": "json",
+                    "required": true,
+                    "type": "array"
+                }
+            },
+            "responseClass": "JobModel",
+            "responseType": "model",
+            "summary": "Updates users in bulk, asynchronously",
+            "uri": "/bulk/users"
         }
     },
     "models": {
+        "JobModel": {
+          "type": "object",
+          "properties": {
+            "id": {
+              "location": "json",
+              "type": "string"
+            },
+            "app_id": {
+              "location": "json",
+              "type": "string"
+            },
+            "name": {
+              "location": "json",
+              "type": "string"
+            },
+            "state": {
+              "location": "json",
+              "type": "string"
+            },
+            "updated_at": {
+              "location": "json",
+              "type": "integer"
+            },
+            "created_at": {
+              "location": "json",
+              "type": "integer"
+            },
+            "completed_at": {
+              "location": "json",
+              "type": "integer"
+            },
+            "links": {
+              "location": "json",
+              "type": "object"
+            }
+          }
+        },
         "UserModel": {
             "type": "object",
             "properties": {

tests/Intercom/Resources/UserTest.php

@@ -4,6 +4,30 @@
 
 class UserTest extends IntercomTestCase
 {
+    public function testBulk()
+    {
+      $this->setMockResponse($this->client, 'User/UserJob.txt');
+      $response = $this->client->bulkUsers(
+      [
+        'items' => [
+          [
+            'data_type' => 'user',
+            'method' => 'post', // can be 'delete'
+            'data' => [
+              'email' => '[email protected]',
+              'name' => 'Pi'
+            ]
+          ]
+        ]
+      ]);
+
+      $this->assertRequest('POST', '/bulk/users');
+      $this->assertRequestJson(['items' => [['data_type' => 'user', 'method' => 'post', 'data' =>['email' => '[email protected]', 'name' => 'Pi']]]]);
+
+      $this->assertInstanceOf('\Guzzle\Service\Resource\Model', $response);
+      $this->assertEquals('job_5ca1ab1eca11ab1e', $response['id']);
+    }
+
     public function testGetUserByID()
     {
         $this->setMockResponse($this->client, 'User/User.txt');
@@ -122,7 +146,7 @@ public function testUpdateUserNoID()
     {
       $this->setMockResponse($this->client, 'User/User.txt');
       $response = $this->client->updateUser(['user_id' => '1234', 'hi' => 'hello', 'new_session' => true]);
-      
+
       $this->assertRequest('POST', '/users');
       $this->assertRequestJson(['user_id' => '1234', 'new_session' => true]);
     }

tests/Mock/User/UserJob.txt

@@ -0,0 +1,19 @@
+HTTP/1.1 200 OK
+Cache-Control: max-age=0, private, must-revalidate
+Content-Type: application/json; charset=utf-8
+Date: Mon, 25 Aug 2014 23:57:54 GMT
+Server: nginx
+
+{
+  "id": "job_5ca1ab1eca11ab1e",
+  "app_id": "pi3243fa",
+  "name": "api bulk job",
+  "state": "running",
+  "updated_at": 1438944983,
+  "created_at": 1438944983,
+  "completed_at": null,
+  "links": {
+    "error": "https://api.intercom.io/jobs/job_5ca1ab1eca11ab1e/error",
+    "self": "https://api.intercom.io/jobs/job_5ca1ab1eca11ab1e"
+  }
+}