Implement partner account integration

Integrate the SDK with the partner account API to be able to CRUD sub
accounts for the user which has the privilege to use the Partner Account
feature.

You can find the Partner Account documentation on the MessageBird
website (https://developers.messagebird.com/)

Author: Felipe Coppola

examples/partner-account-create.php

@@ -0,0 +1,21 @@
+<?php
+
+require_once(__DIR__ . '/../autoload.php');
+
+$messageBird = new \MessageBird\Client('YOUR_ACCESS_KEY'); // Set your own API access key here.
+
+$account = new \MessageBird\Objects\PartnerAccount\Account();
+$account->name = 'Name Test';
+$account->email = '[email protected]';
+
+try {
+    $partnerAccountResult = $messageBird->partnerAccounts->create($account);
+    var_dump($partnerAccountResult);
+
+} catch (\MessageBird\Exceptions\AuthenticateException $e) {
+    // That means that your accessKey is unknown
+    echo 'wrong login';
+
+} catch (\Exception $e) {
+    echo $e->getMessage();
+}

examples/partner-account-delete.php

@@ -0,0 +1,17 @@
+<?php
+
+require_once(__DIR__ . '/../autoload.php');
+
+$messageBird = new \MessageBird\Client('YOUR_ACCESS_KEY'); // Set your own API access key here.
+
+try {
+    $partnerAccountResult = $messageBird->partnerAccounts->delete(1);
+    var_dump($partnerAccountResult);
+
+} catch (\MessageBird\Exceptions\AuthenticateException $e) {
+    // That means that your accessKey is unknown
+    echo 'wrong login';
+
+} catch (\Exception $e) {
+    echo $e->getMessage();
+}

examples/partner-account-list.php

@@ -0,0 +1,17 @@
+<?php
+
+require_once(__DIR__ . '/../autoload.php');
+
+$messageBird = new \MessageBird\Client('YOUR_ACCESS_KEY'); // Set your own API access key here.
+
+try {
+    $partnerAccountResult = $messageBird->partnerAccounts->getList();
+    var_dump($partnerAccountResult);
+
+} catch (\MessageBird\Exceptions\AuthenticateException $e) {
+    // That means that your accessKey is unknown
+    echo 'wrong login';
+
+} catch (\Exception $e) {
+    echo $e->getMessage();
+}

examples/partner-account-read.php

@@ -0,0 +1,17 @@
+<?php
+
+require_once(__DIR__ . '/../autoload.php');
+
+$messageBird = new \MessageBird\Client('YOUR_ACCESS_KEY'); // Set your own API access key here.
+
+try {
+    $partnerAccountResult = $messageBird->partnerAccounts->read(1);
+    var_dump($partnerAccountResult);
+
+} catch (\MessageBird\Exceptions\AuthenticateException $e) {
+    // That means that your accessKey is unknown
+    echo 'wrong login';
+
+} catch (\Exception $e) {
+    echo $e->getMessage();
+}

src/MessageBird/Client.php

@@ -13,6 +13,7 @@ class Client
     const CHATAPI_ENDPOINT = 'https://chat.messagebird.com/1';
     const CONVERSATIONSAPI_ENDPOINT = 'https://conversations.messagebird.com/v1';
     const VOICEAPI_ENDPOINT = 'https://voice.messagebird.com';
+    const PARTNER_ACCOUNT_ENDPOINT = 'https://partner-accounts.messagebird.com';
 
     const ENABLE_CONVERSATIONSAPI_WHATSAPP_SANDBOX = 'ENABLE_CONVERSATIONSAPI_WHATSAPP_SANDBOX';
     const CONVERSATIONSAPI_WHATSAPP_SANDBOX_ENDPOINT = 'https://whatsapp-sandbox.messagebird.com/v1';
@@ -139,6 +140,11 @@ class Client
      */
     public $conversationWebhooks;
 
+    /**
+     * @var Resources\PartnerAccount\Accounts;
+     */
+    public $partnerAccounts;
+
     /**
      * @var Common\HttpClient
      */
@@ -159,6 +165,11 @@ class Client
      */
     protected $VoiceAPIHttpClient;
 
+    /**
+     * @var Common\HttpClient
+     */
+    protected $partnerAccountClient;
+
     /**
      * @param string            $accessKey
      * @param Common\HttpClient $httpClient
@@ -172,11 +183,13 @@ public function __construct($accessKey = null, Common\HttpClient $httpClient = n
             $this->VoiceAPIHttpClient = new Common\HttpClient(self::VOICEAPI_ENDPOINT, 10, 2, array(
                 'X-MessageBird-Version' => '20170314',
            ));
+            $this->partnerAccountClient = new Common\HttpClient(self::PARTNER_ACCOUNT_ENDPOINT);
         } else {
             $this->ChatAPIHttpClient = $httpClient;
             $this->ConversationsAPIHttpClient = $httpClient;
             $this->HttpClient = $httpClient;
             $this->VoiceAPIHttpClient = $httpClient;
+            $this->partnerAccountClient = $httpClient;
         }
 
         $this->HttpClient->addUserAgentString('MessageBird/ApiClient/' . self::CLIENT_VERSION);
@@ -191,6 +204,9 @@ public function __construct($accessKey = null, Common\HttpClient $httpClient = n
         $this->VoiceAPIHttpClient->addUserAgentString('MessageBird/ApiClient/' . self::CLIENT_VERSION);
         $this->VoiceAPIHttpClient->addUserAgentString($this->getPhpVersion());
 
+        $this->partnerAccountClient->addUserAgentString('MessageBird/ApiClient/' . self::CLIENT_VERSION);
+        $this->partnerAccountClient->addUserAgentString($this->getPhpVersion());
+
         if ($accessKey !== null) {
             $this->setAccessKey($accessKey);
         }
@@ -218,6 +234,7 @@ public function __construct($accessKey = null, Common\HttpClient $httpClient = n
         $this->conversations        = new Resources\Conversation\Conversations($this->ConversationsAPIHttpClient);
         $this->conversationMessages = new Resources\Conversation\Messages($this->ConversationsAPIHttpClient);
         $this->conversationWebhooks = new Resources\Conversation\Webhooks($this->ConversationsAPIHttpClient);
+        $this->partnerAccounts      = new Resources\PartnerAccount\Accounts($this->partnerAccountClient);
     }
 
     /**
@@ -231,6 +248,7 @@ public function setAccessKey ($accessKey)
         $this->ConversationsAPIHttpClient->setAuthentication($Authentication);
         $this->HttpClient->setAuthentication($Authentication);
         $this->VoiceAPIHttpClient->setAuthentication($Authentication);
+        $this->partnerAccountClient->setAuthentication($Authentication);
     }
 
     /**

src/MessageBird/Objects/PartnerAccount/AccessKey.php

@@ -0,0 +1,14 @@
+<?php
+
+namespace MessageBird\Objects\PartnerAccount;
+
+use MessageBird\Objects\Base;
+
+class AccessKey extends Base
+{
+    public $id;
+
+    public $key;
+
+    public $mode;
+}

src/MessageBird/Objects/PartnerAccount/Account.php

@@ -0,0 +1,47 @@
+<?php
+
+namespace MessageBird\Objects\PartnerAccount;
+
+use MessageBird\Objects\Base;
+
+class Account extends Base
+{
+    public $id;
+
+    public $name;
+
+    public $email;
+
+    public $accessKeys = [];
+
+    public $signingKey;
+
+    public function loadToJson()
+    {
+        return json_encode([
+            'name' => $this->name,
+            'email' => $this->email,
+        ]);
+    }
+
+    /**
+     * @param $object
+     *
+     * @return $this|void
+     */
+    public function loadFromArray($object)
+    {
+        parent::loadFromArray($object);
+
+        if (empty($this->accessKeys)) {
+            return $this;
+        }
+
+        foreach($this->accessKeys as &$item) {
+            $accessKey = new AccessKey();
+            $item = $accessKey->loadFromArray($item);
+        }
+
+        return $this;
+    }
+}

src/MessageBird/Resources/PartnerAccount/Accounts.php

@@ -0,0 +1,58 @@
+<?php
+
+namespace MessageBird\Resources\PartnerAccount;
+
+use MessageBird\Common\HttpClient;
+use MessageBird\Objects\PartnerAccount\Account;
+use MessageBird\Resources\Base;
+
+class Accounts extends Base
+{
+    const RESOURCE_NAME = 'child-accounts';
+
+    public function __construct(HttpClient $httpClient)
+    {
+        parent::__construct($httpClient);
+
+        $this->setObject(new Account());
+        $this->setResourceName(self::RESOURCE_NAME);
+    }
+
+    public function create($object, $query = null)
+    {
+
+        list($status, , $body) = $this->HttpClient->performHttpRequest(
+            HttpClient::REQUEST_POST,
+            self::RESOURCE_NAME,
+            null,
+            $object->loadToJson()
+        );
+
+        var_dump($status);
+        var_dump($body);
+
+        return $this->processRequest($body);
+    }
+
+    public function getList($parameters = [])
+    {
+        list($status, , $body) = $this->HttpClient->performHttpRequest(
+            HttpClient::REQUEST_GET,
+            self::RESOURCE_NAME,
+            $parameters
+        );
+
+        if ($status !== 200) {
+            return $this->processRequest($body);
+        }
+
+
+        $response = json_decode($body, true);
+
+        foreach ($response as &$item) {
+            $item = $this->getObject()->loadFromArray($item);
+        }
+
+        return $response;
+    }
+}