Add http promise interface

Author: joelwurtz

src/HttpAsyncClient.php

@@ -2,7 +2,7 @@
 
 namespace Http\Client;
 
-use Http\Promise\Promise;
+use Http\Client\Promise\HttpPromise;
 use Psr\Http\Message\RequestInterface;
 
 /**
@@ -19,7 +19,7 @@ interface HttpAsyncClient
      *
      * @param RequestInterface $request
      *
-     * @return Promise Resolves a PSR-7 Response or fails with an Http\Client\Exception.
+     * @return HttpPromise Promise Resolves a PSR-7 Response or fails with an Http\Client\Exception.
      *
      * @throws \Exception If processing the request is impossible (eg. bad configuration).
      */

src/Promise/HttpFulfilledPromise.php

@@ -3,10 +3,9 @@
 namespace Http\Client\Promise;
 
 use Http\Client\Exception;
-use Http\Promise\Promise;
 use Psr\Http\Message\ResponseInterface;
 
-final class HttpFulfilledPromise implements Promise
+final class HttpFulfilledPromise implements HttpPromise
 {
     /**
      * @var ResponseInterface
@@ -42,7 +41,7 @@ public function then(callable $onFulfilled = null, callable $onRejected = null)
      */
     public function getState()
     {
-        return Promise::FULFILLED;
+        return HttpPromise::FULFILLED;
     }
 
     /**

src/Promise/HttpPromise.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace Http\Client\Promise;
+
+use Http\Client\Exception;
+use Http\Promise\Promise;
+use Psr\Http\Message\ResponseInterface;
+
+interface HttpPromise extends Promise
+{
+    /**
+     * {@inheritdoc}
+     *
+     * @return HttpPromise A new resolved http promise with value of the executed callback (onFulfilled / onRejected).
+     */
+    public function then(callable $onFulfilled = null, callable $onRejected = null);
+
+    /**
+     * {@inheritdoc}
+     *
+     * @return ResponseInterface Resolved response, null if $unwrap is set to false
+     *
+     * @throws Exception The http exception if $unwrap is set to true and the request failed.
+     */
+    public function wait($unwrap = true);
+}

src/Promise/HttpRejectedPromise.php

@@ -3,9 +3,8 @@
 namespace Http\Client\Promise;
 
 use Http\Client\Exception;
-use Http\Promise\Promise;
 
-final class HttpRejectedPromise implements Promise
+final class HttpRejectedPromise implements HttpPromise
 {
     /**
      * @var Exception
@@ -41,7 +40,7 @@ public function then(callable $onFulfilled = null, callable $onRejected = null)
      */
     public function getState()
     {
-        return Promise::REJECTED;
+        return HttpPromise::REJECTED;
     }
 
     /**