refactor: introduce async method and wip inline types

run_checks.php

@@ -57,6 +57,24 @@
     exit(1);
 }
 
+$eventPromise = $client->getEventAsync($request_id);
+$eventPromise->then(function ($tuple) {
+    list($result, $response) = $tuple;
+    fwrite(STDOUT, sprintf("\n\nGot async event: %s \n", $response->getBody()->getContents()));
+}, function($exception) {
+    fwrite(STDERR, sprintf("\n\nException when calling FingerprintApi->getVisits: %s\n", $exception->getMessage()));
+    exit(1);
+})->wait();
+
+$visitsPromise = $client->getVisitsAsync($visitor_id);
+$visitsPromise->then(function($tuple) {
+    list($result, $response) = $tuple;
+    fwrite(STDOUT, sprintf("\n\nGot async visits: %s \n", $response->getBody()->getContents()));
+}, function ($exception) {
+    fwrite(STDERR, sprintf("\n\nException when calling FingerprintApi->getVisits: %s\n", $exception->getMessage()));
+    exit(1);
+})->wait();
+
 // Enable the deprecated ArrayAccess return type warning again if needed
 error_reporting(error_reporting() | E_DEPRECATED);
 

src/ApiException.php

@@ -28,6 +28,8 @@
 
 namespace Fingerprint\ServerAPI;
 
+use Psr\Http\Message\ResponseInterface;
+
 /**
  * ApiException Class Doc Comment.
  *
@@ -39,38 +41,19 @@
  */
 class ApiException extends \Exception
 {
-    /**
-     * The deserialized response object.
-     */
-    protected $responseObject;
+    protected ResponseInterface $responseObject;
 
-    /**
-     * Constructor.
-     *
-     * @param string $message Error message
-     * @param int    $code    HTTP status code
-     */
-    public function __construct($message = '', $code = 0)
+    public function __construct(?string $message = '', ?int $code = 0)
     {
         parent::__construct($message, $code);
     }
 
-    /**
-     * Sets the deseralized response object (during deserialization).
-     *
-     * @param mixed $obj Deserialized response object
-     */
-    public function setResponseObject($obj)
+    public function setResponseObject(ResponseInterface $obj): void
     {
         $this->responseObject = $obj;
     }
 
-    /**
-     * Gets the deseralized response object (during deserialization).
-     *
-     * @return mixed the deserialized response object
-     */
-    public function getResponseObject()
+    public function getResponseObject(): ResponseInterface
     {
         return $this->responseObject;
     }