Refactored Call Collection / Resource and added Sub-Resources:

- Yes, this should not have been a single commit.
- Changed `Calls` namespace to `Call` to match the rest of the library.
  - Should read better "Call Collection, Call Stream, etc".
  - But perhaps namespace should match client signature (still `$nexmo->calls[$id]->stream();`)
- Flattened `Nexmo\Call` namespace.
- Added support for steame / talk / dtmf.
- Refactored the concept of client / entity to collection / resource.
  - Now `Nexmo\Call\Collection`
  - Should perhaps change `Nexmo\Call\Call` to `Nexmo\Call\Resource`
  - Changed some interfaces / forced changes to `Nexmo\Applicaion\*`
- Fixed case of `jsonUnserialize`

Author: tjlytle

README.md

@@ -249,10 +249,10 @@ $client->calls()->create([
 ]);
 ```
 
-Or you can create a `Nexmo\Calls\Call` object, and use that:
+Or you can create a `Nexmo\Call\Call` object, and use that:
 
 ```php
-use Nexmo\Calls\Call;
+use Nexmo\Call\Call;
 $call = new Call();
 $call->setTo('14843331234')
      ->setFrom('14843335555')
@@ -264,17 +264,40 @@ $client->calls()->create($call);
 
 ### Fetching A Call
 
-You can fetch a call using a `Nexmo\Calls\Call` object, or the call's UUID as a string:
+You can fetch a call using a `Nexmo\Call\Call` object, or the call's UUID as a string:
 
 ```php
 $call = $client->calls()->get('3fd4d839-493e-4485-b2a5-ace527aacff3');
 
-$call = new Nexmo\Calls\Call('3fd4d839-493e-4485-b2a5-ace527aacff3');
+$call = new Nexmo\Call\Call('3fd4d839-493e-4485-b2a5-ace527aacff3');
 $client->calls()->get($call);
 
 echo $call->getDirection();
 ```
 
+The call collection can also be treated as an array:
+ 
+```php
+echo $client->calls['3fd4d839-493e-4485-b2a5-ace527aacff3']->getDirection();
+```
+
+And iterated over:
+
+```php
+foreach($client->calls as $call){
+    echo $call->getDirection();
+}
+```
+
+With an optional filter:
+
+```php
+$filter = new \Nexmo\Call\Filter()->setStatus('completed');
+foreach($client->calls($filter) as $call){
+    echo $call->getDirection();
+}
+```
+
 ### Creating An Application
 
 Application are configuration containers, and you can create one using a simple array structure:
@@ -377,7 +400,7 @@ API Coverage
             * [ ] Sending Alerts
             * [ ] Campaign Subscription Management
 * Voice
-    * [X] Outbound Calls
+    * [X] Outbound Call
     * [ ] Inbound Call
     * [ ] Text-To-Speech Call
     * [ ] Text-To-Speech Prompt

src/Application/Client.php

@@ -21,14 +21,14 @@ class Client implements ClientAwareInterface, CollectionInterface
     use ClientAwareTrait;
     use CollectionTrait;
 
-    public function getCollectionName()
+    public static function getCollectionName()
     {
         return 'applications';
     }
 
-    public function getCollectionPath()
+    public static function getCollectionPath()
     {
-        return '/v1/' . $this->getCollectionName();
+        return '/v1/' . self::getCollectionName();
     }
 
     public function hydrateEntity($data, $id)

src/Calls/Call.php src/Call/Call.phpsrc/Calls/Call.php renamed to src/Call/Call.php

@@ -6,28 +6,37 @@
  * @license   https://github.com/Nexmo/nexmo-php/blob/master/LICENSE.txt MIT License
  */
 
-namespace Nexmo\Calls;
+namespace Nexmo\Call;
 
+use Nexmo\Client\ClientAwareInterface;
+use Nexmo\Client\ClientAwareTrait;
 use Nexmo\Conversations\Conversation;
-use Nexmo\Entity\CollectionAwareInterface;
-use Nexmo\Entity\CollectionAwareTrait;
 use Nexmo\Entity\EntityInterface;
 use Nexmo\Entity\JsonResponseTrait;
 use Nexmo\Entity\JsonSerializableTrait;
 use Nexmo\Entity\JsonUnserializableInterface;
 use Nexmo\Entity\NoRequestResponseTrait;
-use Nexmo\Entity\Psr7Trait;
+use Psr\Http\Message\ResponseInterface;
+use Nexmo\Client\Exception;
+use Zend\Diactoros\Request;
 
 /**
  * Class Call
- * @method Collection getCollection()
+ *
+ * @property \Nexmo\Call\Stream $stream
+ * @property \Nexmo\Call\Talk   $talk
+ * @property \Nexmo\Call\Dtmf   $dtmf
+ *
+ * @method \Nexmo\Call\Stream stream()
+ * @method \Nexmo\Call\Talk   talk()
+ * @method \Nexmo\Call\Dtmf   dtmf()
  */
-class Call implements EntityInterface, \JsonSerializable, JsonUnserializableInterface, CollectionAwareInterface
+class Call implements EntityInterface, \JsonSerializable, JsonUnserializableInterface, ClientAwareInterface
 {
     use NoRequestResponseTrait;
     use JsonSerializableTrait;
     use JsonResponseTrait;
-    use CollectionAwareTrait;
+    use ClientAwareTrait;
 
     const WEBHOOK_ANSWER = 'answer';
     const WEBHOOK_EVENT  = 'event';
@@ -50,19 +59,65 @@ class Call implements EntityInterface, \JsonSerializable, JsonUnserializableInte
 
     protected $data = [];
 
+    protected $subresources = [];
+
     public function __construct($id = null)
     {
         $this->id = $id;
     }
 
     public function get()
     {
-        return $this->getCollection()->get($this);
+        $request = new Request(
+            \Nexmo\Client::BASE_API . Collection::getCollectionPath() . '/' . $this->getId()
+            ,'GET'
+        );
+
+        $response = $this->getClient()->send($request);
+
+        if($response->getStatusCode() != '200'){
+            throw $this->getException($response);
+        }
+
+        $data = json_decode($response->getBody()->getContents(), true);
+        $this->jsonUnserialize($data);
+
+        return $this;
+    }
+
+    protected function getException(ResponseInterface $response)
+    {
+        $body = json_decode($response->getBody()->getContents(), true);
+        $status = $response->getStatusCode();
+
+        if($status >= 400 AND $status < 500) {
+            $e = new Exception\Request($body['error_title'], $status);
+        } elseif($status >= 500 AND $status < 600) {
+            $e = new Exception\Server($body['error_title'], $status);
+        } else {
+            $e = new Exception\Exception('Unexpected HTTP Status Code');
+        }
+
+        return $e;
     }
 
     public function put($payload)
     {
-        return $this->getCollection()->put($payload, $this);
+        $request = new Request(
+            \Nexmo\Client::BASE_API . Collection::getCollectionPath() . '/' . $this->getId()
+            ,'PUT',
+            'php://temp',
+            ['content-type' => 'application/json']
+        );
+
+        $request->getBody()->write(json_encode($payload));
+        $response = $this->client->send($request);
+
+        if($response->getStatusCode() != '200'){
+            throw $this->getException($response);
+        }
+
+        return $this;
     }
 
     public function getId()
@@ -122,7 +177,7 @@ public function setWebhook($type, $url = null, $method = null)
         }
 
         if(is_null($url)){
-            throw new \InvalidArgumentException('must provide `Nexmo\Calls\Webhook` object, or a type and url: missing url' );
+            throw new \InvalidArgumentException('must provide `Nexmo\Call\Webhook` object, or a type and url: missing url' );
         }
 
         $this->webhooks[$type] = new Webhook($type, $url, $method);
@@ -160,20 +215,64 @@ public function getConversation()
         }
     }
 
+    /**
+     * Returns true if the resource data is loaded.
+     *
+     * Will attempt to load the data if it's not already.
+     *
+     * @return bool
+     */
     protected function lazyLoad()
     {
         if(!empty($this->data)){
             return true;
         }
 
         if(isset($this->id)){
-            $this->getCollection()->get($this);
+            $this->get($this);
             return true;
         }
 
         return false;
     }
 
+    public function __get($name)
+    {
+        switch($name){
+            case 'stream':
+            case 'talk':
+            case 'dtmf':
+                return $this->lazySubresource(ucfirst($name));
+            default:
+                throw new \RuntimeException('property does not exist: ' . $name);
+        }
+    }
+
+    public function __call($name, $arguments)
+    {
+        switch($name){
+            case 'stream':
+            case 'talk':
+            case 'dtmf':
+                $entity = $this->lazySubresource(ucfirst($name));
+                return call_user_func_array($entity, $arguments);
+            default:
+                throw new \RuntimeException('method does not exist: ' . $name);
+        }
+    }
+
+    protected function lazySubresource($type)
+    {
+        if(!isset($this->subresources[$type])){
+            $class = 'Nexmo\Call\\' . $type;
+            $instance = new $class($this->getId());
+            $instance->setClient($this->getClient());
+            $this->subresources[$type] = $instance;
+        }
+
+        return $this->subresources[$type];
+    }
+
     public function jsonSerialize()
     {
         $data = $this->data;
@@ -193,7 +292,7 @@ public function jsonSerialize()
         return $data;
     }
 
-    public function JsonUnserialize(array $json)
+    public function jsonUnserialize(array $json)
     {
         $this->data = $json;
         $this->id = $json['uuid'];