Implemented Exceptions

Author: StanBarrows

src/DTO/Exception.php

@@ -0,0 +1,37 @@
+<?php
+
+declare(strict_types=1);
+
+namespace CodebarAg\MFiles\DTO;
+
+use Illuminate\Support\Arr;
+
+final class Exception
+{
+    public function __construct(
+        public readonly string $name,
+        public readonly string $message,
+        public readonly ?InnerException $innerException,
+    ) {}
+
+    public static function fromArray(array $data): self
+    {
+        $innerExceptionData = Arr::get($data, 'InnerException');
+        $innerException = $innerExceptionData ? InnerException::fromArray($innerExceptionData) : null;
+
+        return new self(
+            name: Arr::get($data, 'Name', ''),
+            message: Arr::get($data, 'Message', ''),
+            innerException: $innerException,
+        );
+    }
+
+    public function toArray(): array
+    {
+        return [
+            'name' => $this->name,
+            'message' => $this->message,
+            'innerException' => $this->innerException?->toArray(),
+        ];
+    }
+}

src/DTO/InnerException.php

@@ -0,0 +1,37 @@
+<?php
+
+declare(strict_types=1);
+
+namespace CodebarAg\MFiles\DTO;
+
+use Illuminate\Support\Arr;
+
+final class InnerException
+{
+    public function __construct(
+        public readonly string $name,
+        public readonly string $message,
+        public readonly ?string $stackText,
+        public readonly ?string $errorCode,
+    ) {}
+
+    public static function fromArray(array $data): self
+    {
+        return new self(
+            name: Arr::get($data, 'Name', ''),
+            message: Arr::get($data, 'Message', ''),
+            stackText: Arr::get($data, 'StackText'),
+            errorCode: Arr::get($data, 'ErrorCode'),
+        );
+    }
+
+    public function toArray(): array
+    {
+        return [
+            'name' => $this->name,
+            'message' => $this->message,
+            'stackText' => $this->stackText,
+            'errorCode' => $this->errorCode,
+        ];
+    }
+}

src/DTO/MFilesError.php

@@ -0,0 +1,58 @@
+<?php
+
+declare(strict_types=1);
+
+namespace CodebarAg\MFiles\DTO;
+
+use Illuminate\Support\Arr;
+
+final class MFilesError
+{
+    public function __construct(
+        public readonly string $errorCode,
+        public readonly int $status,
+        public readonly string $url,
+        public readonly string $method,
+        public readonly ?Exception $exception,
+        public readonly ?string $stack,
+        public readonly string $message,
+        public readonly bool $isLoggedToVault,
+        public readonly bool $isLoggedToApplication,
+        public readonly string $exceptionName,
+    ) {}
+
+    public static function fromArray(array $data): self
+    {
+        $exceptionData = Arr::get($data, 'Exception');
+        $exception = $exceptionData ? Exception::fromArray($exceptionData) : null;
+
+        return new self(
+            errorCode: Arr::get($data, 'ErrorCode', ''),
+            status: Arr::get($data, 'Status', 0),
+            url: Arr::get($data, 'URL', ''),
+            method: Arr::get($data, 'Method', ''),
+            exception: $exception,
+            stack: Arr::get($data, 'Stack'),
+            message: Arr::get($data, 'Message', ''),
+            isLoggedToVault: Arr::get($data, 'IsLoggedToVault', false),
+            isLoggedToApplication: Arr::get($data, 'IsLoggedToApplication', false),
+            exceptionName: Arr::get($data, 'ExceptionName', ''),
+        );
+    }
+
+    public function toArray(): array
+    {
+        return [
+            'errorCode' => $this->errorCode,
+            'status' => $this->status,
+            'url' => $this->url,
+            'method' => $this->method,
+            'exception' => $this->exception?->toArray(),
+            'stack' => $this->stack,
+            'message' => $this->message,
+            'isLoggedToVault' => $this->isLoggedToVault,
+            'isLoggedToApplication' => $this->isLoggedToApplication,
+            'exceptionName' => $this->exceptionName,
+        ];
+    }
+}

src/Exceptions/MFilesErrorException.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace CodebarAg\MFiles\Exceptions;
+
+use CodebarAg\MFiles\DTO\MFilesError;
+use Exception as BaseException;
+
+final class MFilesErrorException extends BaseException
+{
+    public function __construct(
+        public readonly MFilesError $error
+    ) {
+        parent::__construct($error->message, $error->status);
+    }
+}

src/Responses/DownloadFileResponse.php

@@ -5,12 +5,16 @@
 namespace CodebarAg\MFiles\Responses;
 
 use CodebarAg\MFiles\DTO\DownloadedFile;
+use CodebarAg\MFiles\Exceptions\MFilesErrorException;
 use Saloon\Http\Response;
 
 final class DownloadFileResponse
 {
     public static function createDtoFromResponse(Response $response): DownloadedFile
     {
+        if (! $response->successful()) {
+            throw new MFilesErrorException(ErrorResponse::createDtoFromResponse($response));
+        }
         $headers = $response->headers();
         $fileContentType = $headers->get('Content-Type');
         $fileSize = (int) $headers->get('Content-Length', 0);

src/Responses/ErrorResponse.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace CodebarAg\MFiles\Responses;
+
+use CodebarAg\MFiles\DTO\MFilesError;
+use Saloon\Http\Response;
+
+final class ErrorResponse
+{
+    public static function createDtoFromResponse(Response $response): MFilesError
+    {
+        return MFilesError::fromArray($response->json());
+    }
+}

src/Responses/LogInToVaultResponse.php

@@ -4,13 +4,18 @@
 
 namespace CodebarAg\MFiles\Responses;
 
+use CodebarAg\MFiles\Exceptions\MFilesErrorException;
 use Illuminate\Support\Arr;
 use Saloon\Http\Response;
 
 final class LogInToVaultResponse
 {
     public static function createDtoFromResponse(Response $response): ?string
     {
+        if (! $response->successful()) {
+            throw new MFilesErrorException(ErrorResponse::createDtoFromResponse($response));
+        }
+
         return Arr::get($response->json(), 'Value');
     }
 }

src/Responses/ObjectPropertiesResponse.php

@@ -5,12 +5,17 @@
 namespace CodebarAg\MFiles\Responses;
 
 use CodebarAg\MFiles\DTO\ObjectProperties;
+use CodebarAg\MFiles\Exceptions\MFilesErrorException;
 use Saloon\Http\Response;
 
 final class ObjectPropertiesResponse
 {
     public static function createDtoFromResponse(Response $response): ObjectProperties
     {
+        if (! $response->successful()) {
+            throw new MFilesErrorException(ErrorResponse::createDtoFromResponse($response));
+        }
+
         return ObjectProperties::fromArray($response->json());
     }
 }

src/Responses/UploadFileResponse.php

@@ -4,6 +4,7 @@
 
 namespace CodebarAg\MFiles\Responses;
 
+use CodebarAg\MFiles\Exceptions\MFilesErrorException;
 use Illuminate\Support\Arr;
 use Illuminate\Support\Str;
 use Saloon\Http\Response;
@@ -12,6 +13,10 @@ final class UploadFileResponse
 {
     public static function createDtoFromResponse(Response $response, string $fileName): array
     {
+        if (! $response->successful()) {
+            throw new MFilesErrorException(ErrorResponse::createDtoFromResponse($response));
+        }
+
         $data = $response->json();
         $data = Arr::add($data, 'Title', Str::beforeLast($fileName, '.'));
         $data = Arr::add($data, 'Extension', Str::afterLast($fileName, '.'));