Add ForbiddenException

CHANGELOG.md

@@ -5,6 +5,7 @@ All notable changes will be documented in this file.
 Updates should follow the [Keep a CHANGELOG](http://keepachangelog.com/) principles.
 
 ## [Unreleased]
+- Add `ForbiddenException`
 - Add `AccountBilling.productType`
 - Add `EnvelopesEndpoint.cancel` body
 - Fix `AccountUsersEndpoint.invite` endpoint

src/DigiSignClient.php

@@ -7,6 +7,7 @@
 use DateTimeInterface;
 use DigitalCz\DigiSign\Exception\BadRequestException;
 use DigitalCz\DigiSign\Exception\ClientException;
+use DigitalCz\DigiSign\Exception\ForbiddenException;
 use DigitalCz\DigiSign\Exception\NotFoundException;
 use DigitalCz\DigiSign\Exception\RuntimeException;
 use DigitalCz\DigiSign\Exception\ServerException;
@@ -34,6 +35,7 @@ final class DigiSignClient implements DigiSignClientInterface
     public const HTTP_NO_CONTENT = 204;
     public const HTTP_BAD_REQUEST = 400;
     public const HTTP_UNAUTHORIZED = 401;
+    public const HTTP_FORBIDDEN = 403;
     public const HTTP_NOT_FOUND = 404;
     public const HTTP_INTERNAL_SERVER_ERROR = 500;
 
@@ -288,6 +290,8 @@ private function checkResponse(ResponseInterface $response): void
                     throw new UnauthorizedException($response);
                 case self::HTTP_NOT_FOUND:
                     throw new NotFoundException($response);
+                case self::HTTP_FORBIDDEN:
+                    throw new ForbiddenException($response);
                 default:
                     throw new ClientException($response);
             }

src/Exception/ForbiddenException.php

@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DigitalCz\DigiSign\Exception;
+
+/**
+ * Represents response with http status 403
+ */
+final class ForbiddenException extends ClientException
+{
+}

tests/DigiSignClientTest.php

@@ -7,6 +7,7 @@
 use DateTime;
 use DigitalCz\DigiSign\Exception\BadRequestException;
 use DigitalCz\DigiSign\Exception\ClientException;
+use DigitalCz\DigiSign\Exception\ForbiddenException;
 use DigitalCz\DigiSign\Exception\NotFoundException;
 use DigitalCz\DigiSign\Exception\RuntimeException;
 use DigitalCz\DigiSign\Exception\ServerException;
@@ -339,6 +340,21 @@ public function testRequestClientException(): void
         $client->request('GET', 'https://example.com/api');
     }
 
+    public function testRequestForbiddenClientException(): void
+    {
+        $response = new Response(403);
+
+        $httpClient = new Client();
+        $httpClient->addResponse($response);
+
+        $client = new DigiSignClient($httpClient);
+
+        $this->expectException(ForbiddenException::class);
+        $this->expectExceptionMessage('403 Forbidden');
+
+        $client->request('GET', 'https://example.com/api');
+    }
+
     public function testNormalizeJson(): void
     {
         $httpClient = new Client();