update phpDoc

Author: thiakil

src/OAuth2Handler.php

@@ -3,8 +3,6 @@
 namespace kamermans\OAuth2;
 
 use GuzzleHttp\Exception\BadResponseException;
-use kamermans\OAuth2\GrantType\GrantTypeInterface;
-use kamermans\OAuth2\Utils\Helper;
 
 /**
  * OAuth2 plugin.
@@ -16,43 +14,43 @@ class OAuth2Handler
     /**
      * The grant type implementation used to acquire access tokens.
      *
-     * @var GrantTypeInterface
+     * @var GrantType\GrantTypeInterface
      */
     protected $grantType;
 
     /**
      * The grant type implementation used to refresh access tokens.
      *
-     * @var GrantTypeInterface
+     * @var GrantType\GrantTypeInterface
      */
     protected $refreshTokenGrantType;
 
     /**
      * The service in charge of including client credentials into requests.
      * to get an access token.
      *
-     * @var AccessTokenSigner
+     * @var Signer\ClientCredentials\SignerInterface
      */
     protected $clientCredentialsSigner;
 
     /**
      * The service in charge of including the access token into requests.
      *
-     * @var AccessTokenSigner
+     * @var Signer\AccessToken\SignerInterface
      */
     protected $accessTokenSigner;
 
     /**
      * The object including access token.
      *
-     * @var TokenInterface
+     * @var Token\TokenInterface
      */
     protected $rawToken;
 
     /**
      * The service in charge of persisting access token.
      *
-     * @var TokenPersistenceInterface
+     * @var Persistence\TokenPersistenceInterface
      */
     protected $tokenPersistence;
 
@@ -65,8 +63,17 @@ class OAuth2Handler
     protected $newTokenSupplier;
 
     /**
-     * @param GrantTypeInterface $grantType
-     * @param GrantTypeInterface $refreshTokenGrantType
+     * Factory responsible for parsing server token response
+     *
+     * @var callable
+     */
+    protected $tokenFactory;
+
+    /**
+     * @param GrantType\GrantTypeInterface                  $grantType
+     * @param GrantType\GrantTypeInterface|null             $refreshTokenGrantType
+     * @param Signer\ClientCredentials\SignerInterface|null $clientCredentialsSigner
+     * @param Signer\AccessToken\SignerInterface|null       $accessTokenSigner
      */
     public function __construct(
                     GrantType\GrantTypeInterface $grantType,
@@ -94,6 +101,8 @@ public function __construct(
 
     /**
      * @param Signer\ClientCredentials\SignerInterface $signer
+     *
+     * @return self
      */
     public function setClientCredentialsSigner(Signer\ClientCredentials\SignerInterface $signer)
     {
@@ -103,7 +112,9 @@ public function setClientCredentialsSigner(Signer\ClientCredentials\SignerInterf
     }
 
     /**
-     * @param AccessToken\SignerInterface $signer
+     * @param Signer\AccessToken\SignerInterface $signer
+     *
+     * @return self
      */
     public function setAccessTokenSigner(Signer\AccessToken\SignerInterface $signer)
     {
@@ -114,6 +125,8 @@ public function setAccessTokenSigner(Signer\AccessToken\SignerInterface $signer)
 
     /**
      * @param Persistence\TokenPersistenceInterface $tokenPersistence
+     *
+     * @return self
      */
     public function setTokenPersistence(Persistence\TokenPersistenceInterface $tokenPersistence)
     {
@@ -124,6 +137,8 @@ public function setTokenPersistence(Persistence\TokenPersistenceInterface $token
 
     /**
      * @param callable $tokenFactory
+     *
+     * @return self
      */
     public function setTokenFactory(callable $tokenFactory)
     {
@@ -146,7 +161,9 @@ public function setNewTokenSupplier(callable $tokenSupplier) {
     /**
      * Manually set the access token.
      *
-     * @param string|array|TokenInterface $token An array of token data, an access token string, or a TokenInterface object
+     * @param string|array|Token\TokenInterface $token An array of token data, an access token string, or a TokenInterface object
+     *
+     * @return self
      */
     public function setAccessToken($token)
     {
@@ -179,7 +196,7 @@ public function deleteAccessToken()
      *
      * @return string|null A valid access token or null if unable to get one
      *
-     * @throws AccessTokenRequestException while trying to run `requestNewAccessToken` method
+     * @throws Exception\AccessTokenRequestException while trying to run `requestNewAccessToken` method
      */
     public function getAccessToken()
     {
@@ -207,7 +224,7 @@ public function getAccessToken()
     /**
      * Gets the current Token object
      *
-     * @return Token\RawToken|null
+     * @return Token\TokenInterface|null
      */
     public function getRawToken()
     {
@@ -228,7 +245,7 @@ protected function signRequest($request)
     /**
      * Helper method for (callable)tokenFactory
      *
-     * @return TokenInterface
+     * @return Token\TokenInterface
      */
     protected function tokenFactory()
     {
@@ -238,9 +255,7 @@ protected function tokenFactory()
     /**
      * Acquire a new access token from the server.
      *
-     * @return TokenInterface|null
-     *
-     * @throws AccessTokenRequestException
+     * @throws Exception\AccessTokenRequestException
      */
     protected function requestNewAccessToken()
     {

src/OAuth2Middleware.php

@@ -37,13 +37,17 @@ public function __invoke(callable $handler)
     }
 
     /**
-      * Request error event handler.
-      *
-      * Handles unauthorized errors by acquiring a new access token and
-      * retrying the request.
-      *
-      * @param ErrorEvent $event Event received
-      */
+     * Request error event handler.
+     *
+     * Handles unauthorized errors by acquiring a new access token and
+     * retrying the request.
+     *
+     * @param \Psr\Http\Message\RequestInterface $request
+     * @param array                              $options
+     * @param callable                           $handler
+     *
+     * @return callable
+     */
     private function onFulfilled(RequestInterface $request, array $options, $handler)
     {
         return function ($response) use ($request, $options, $handler) {