Add HttpTokenResponseException making error handling easy

Although http status code and http error message are helpful in error handling,
TokenResponseException, throwed by oauth\HTTPClient if an error occured during
the http request, does not have fields/methods which indicate them directly.

Solve it by adding HttpTokenResponseException which has indicators of http status
code and http error message, and throwing it instead of TokenResponseException.

Signed-off-by: Naoto Kobayashi <naoto.kobayashi4c@gmail.com>

Author: YoitoFes

HTTPClient.php

@@ -4,7 +4,6 @@
 
 use dokuwiki\HTTP\DokuHTTPClient;
 use OAuth\Common\Http\Client\ClientInterface;
-use OAuth\Common\Http\Exception\TokenResponseException;
 use OAuth\Common\Http\Uri\UriInterface;
 
 /**
@@ -26,7 +25,11 @@ public function retrieveResponse(
         $ok = $http->sendRequest($endpoint->getAbsoluteUri(), $requestBody, $method);
         if (!$ok || $http->status < 200 || $http->status > 299) {
             $msg = "An error occured during the request to the oauth provider:\n";
-            throw new TokenResponseException($msg . $http->error . ' [HTTP ' . $http->status . ']');
+            throw new HttpTokenResponseException(
+                message: $msg . $http->error . ' [HTTP ' . $http->status . ']',
+                httpStatusCode: $http->status,
+                httpErrorMessage: $http->error
+            );
         }
 
         return $http->resp_body;

HttpTokenResponseException.php

@@ -0,0 +1,53 @@
+<?php
+
+namespace dokuwiki\plugin\oauth;
+
+use OAuth\Common\Http\Exception\TokenResponseException;
+
+/**
+ * Exception relating to http token response from service.
+ */
+class HttpTokenResponseException extends TokenResponseException
+{
+    protected $httpStatusCode = 0;
+    protected $httpErrorMessage = "";
+
+    /**
+     * @param string $message
+     * @param int $httpStatusCode
+     * @param string httpErrorMessage
+     * @param int $code
+     * @param \Throwable|null $previous
+     */
+    public function __construct(
+        $message = "",
+        $httpStatusCode = 0,
+        $httpErrorMessage = "",
+        $code = 0,
+        \Throwable $previous = null
+    ) {
+        parent::__construct($message, $code, $previous);
+        $this->httpStatusCode = $httpStatusCode;
+        $this->httpErrorMessage = $httpErrorMessage;
+    }
+
+    /**
+     * Get the HTTP status code
+     *
+     * @return int
+     */
+    public function getHttpStatusCode()
+    {
+        return $this->httpStatusCode;
+    }
+
+    /**
+     * Get the HTTP error message
+     *
+     * @return string
+     */
+    public function getHttpErrorMessage()
+    {
+        return $this->httpErrorMessage;
+    }
+}