wip

src/Http/Adapter/CurlFactory.php

@@ -7,15 +7,24 @@
 use Mollie\Api\Http\PendingRequest;
 use Mollie\Api\Types\Method;
 
+/**
+ * @phpstan-type CurlType resource|CurlHandle
+ */
 class CurlFactory
 {
     public const DEFAULT_TIMEOUT = 10;
     public const DEFAULT_CONNECT_TIMEOUT = 2;
 
-    private CurlHandle $handle;
+    /**
+     * @var CurlType The curl handle
+     */
+    private $handle;
     private PendingRequest $pendingRequest;
 
-    private function __construct(CurlHandle $handle, PendingRequest $pendingRequest)
+    /**
+     * @param CurlType $handle
+     */
+    private function __construct($handle, PendingRequest $pendingRequest)
     {
         $this->handle = $handle;
         $this->pendingRequest = $pendingRequest;
@@ -85,11 +94,18 @@ public function withMethod(string $method, ?string $body): self
         return $this;
     }
 
-    public function create(): CurlHandle
+    /**
+     * @return CurlType
+     */
+    public function create()
     {
         return $this->handle;
     }
 
+    /**
+     * @param int $option
+     * @param mixed $value
+     */
     private function setOption(int $option, $value): void
     {
         if (curl_setopt($this->handle, $option, $value) === false) {

src/Http/Adapter/CurlMollieHttpAdapter.php

@@ -2,7 +2,6 @@
 
 namespace Mollie\Api\Http\Adapter;
 
-use CurlHandle;
 use Mollie\Api\Contracts\HttpAdapterContract;
 use Mollie\Api\Exceptions\NetworkRequestException;
 use Mollie\Api\Exceptions\RetryableNetworkRequestException;
@@ -12,6 +11,9 @@
 use Mollie\Api\Traits\HasDefaultFactories;
 use Throwable;
 
+/**
+ * @phpstan-import-type CurlType from CurlFactory
+ */
 final class CurlMollieHttpAdapter implements HttpAdapterContract
 {
     use HasDefaultFactories;
@@ -51,9 +53,11 @@ public function sendRequest(PendingRequest $pendingRequest): Response
 
     /**
      * @throws NetworkRequestException
+     * @return array{0: array<string, string>, 1: string, 2: int}
      */
     protected function send(PendingRequest $pendingRequest): array
     {
+        /** @var CurlType|null */
         $curl = null;
         $request = $pendingRequest->createPsrRequest();
 
@@ -100,7 +104,12 @@ protected function createResponse(PendingRequest $pendingRequest, int $statusCod
         );
     }
 
-    private function extractResponseDetails(CurlHandle $curl, string $response): array
+    /**
+     * @param CurlType $curl
+     * @param string $response
+     * @return array{0: array<string, string>, 1: string, 2: int}
+     */
+    private function extractResponseDetails($curl, string $response): array
     {
         $headerSize = curl_getinfo($curl, CURLINFO_HEADER_SIZE);
         $headerValues = substr($response, 0, $headerSize);