Support generic

phpstan.neon.dist

@@ -6,7 +6,7 @@ parameters:
         - src
 
     # The level 9 is the highest level
-    level: 7
+    level: 8
 
     tmpDir: build/phpstan
 

src/Contracts/ConnectorInterface.php

@@ -25,6 +25,10 @@ public function middleware(): Middleware;
      * Send the given request.
      *
      * The request and response should be processed through middleware.
+     *
+     * @template T of object
+     * @param  Request<T> $request
+     * @return Response<T>
      */
     public function send(Request $request): Response;
 }

src/Request.php

@@ -9,6 +9,9 @@
 use Fansipan\Contracts\PayloadInterface;
 use Fansipan\Decoder\ChainDecoder;
 
+/**
+ * @template T of object
+ */
 abstract class Request
 {
     /**

src/Response.php

@@ -11,6 +11,9 @@
 use LogicException;
 use Psr\Http\Message\ResponseInterface;
 
+/**
+ * @template T of object
+ */
 final class Response implements \ArrayAccess, \JsonSerializable, \Stringable
 {
     use Traits\Macroable;
@@ -62,14 +65,16 @@ public function data(): array
 
     /**
      * Get the decoded body of the response as an object.
+     *
+     * @return ?T
      */
     public function object(): ?object
     {
         if (! $this->decoder instanceof MapperInterface) {
             return null;
         }
 
-        return $this->decoder->map($this->response);
+        return $this->decoder->map($this->response); // @phpstan-ignore-line
     }
 
     /**
@@ -232,6 +237,10 @@ public function throw(): self
         if ($this->failed()) {
             $exception = $this->toException();
 
+            if (! $exception) {
+                return $this;
+            }
+
             if ($callback && \is_callable($callback)) {
                 $callback($this, $exception);
             }

src/Traits/ConnectorTrait.php

@@ -25,18 +25,13 @@ public static function baseUri(): ?string
         return null;
     }
 
-    /**
-     * Send the given request.
-     *
-     * The request and response should be processed through middleware.
-     */
     public function send(Request $request): Response
     {
         $response = $this->sendRequest(
             Util::request($request, static::baseUri())
         );
 
-        return new Response($response, $request->decoder());
+        return new Response($response, $request->decoder()); // @phpstan-ignore-line
     }
 
     public function sendRequest(RequestInterface $request): ResponseInterface

tests/Services/JsonPlaceholder/GetUserRequest.php

@@ -9,6 +9,9 @@
 use Fansipan\Request;
 use Fansipan\Util;
 
+/**
+ * @extends Request<User>
+ */
 final class GetUserRequest extends Request
 {
     private $id;