Merge pull request #492 from yankewei/v3

Leverage PHPStan conditional return types for more precise return-type declarations

Author: Sammyjo20

src/Traits/OAuth2/AuthorizationCodeGrant.php

@@ -73,6 +73,9 @@ public function getAuthorizationUrl(array $scopes = [], ?string $state = null, s
      * @template TRequest of \Saloon\Http\Request
      *
      * @param callable(TRequest): (void)|null $requestModifier
+     *
+     * @return ($returnResponse is true ? \Saloon\Http\Response : \Saloon\Contracts\OAuthAuthenticator)
+     *
      * @throws \Saloon\Exceptions\InvalidStateException
      */
     public function getAccessToken(string $code, ?string $state = null, ?string $expectedState = null, bool $returnResponse = false, ?callable $requestModifier = null): OAuthAuthenticator|Response
@@ -108,6 +111,8 @@ public function getAccessToken(string $code, ?string $state = null, ?string $exp
      * @template TRequest of \Saloon\Http\Request
      *
      * @param callable(TRequest): (void)|null $requestModifier
+     *
+     * @return ($returnResponse is true ? \Saloon\Http\Response : \Saloon\Contracts\OAuthAuthenticator)
      */
     public function refreshAccessToken(OAuthAuthenticator|string $refreshToken, bool $returnResponse = false, ?callable $requestModifier = null): OAuthAuthenticator|Response
     {