add icon uploads

backend/app/Controllers/ElementController.php

@@ -5,18 +5,24 @@ namespace App\Controllers;
 use App\Element\Element;
 use App\Element\UseCases\GetElement\GetElement;
 use App\Element\UseCases\GetElement\GetElementRequest;
+use App\Element\UseCases\UpdateElement\UpdateElementIconImage;
+use App\Element\UseCases\UpdateElement\UpdateElementIconImageRequest;
 use App\Element\UseCases\UpdateElement\UpdateElement;
 use App\Element\UseCases\UpdateElement\UpdateElementRequest;
 use App\Exceptions\BadRequestException;
 use App\Exceptions\NotFoundException;
+use App\Shared\Files\FileUploader;
 use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
+use Illuminate\Http\UploadedFile;
 
 class ElementController
 {
     public function __construct(
         private GetElement $getElement,
         private UpdateElement $updateElement,
+        private UpdateElementIconImage $updateElementIconImage,
+        private FileUploader $fileUploader,
     ) {
     }
 
@@ -84,6 +90,35 @@ class ElementController
         ], 200);
     }
 
+    public function uploadIconImage(?int $id, Request $request): JsonResponse
+    {
+        $iconImage = $this->uploadedFileInput($request, 'iconImage');
+
+        try {
+            $element = $this->updateElementIconImage->execute(
+                new UpdateElementIconImageRequest(
+                    id: $id,
+                    iconImageContents: $iconImage['contents'],
+                    iconImageOriginalName: $iconImage['originalName'],
+                    iconImageMimeType: $iconImage['mimeType'],
+                    iconImageSizeBytes: $iconImage['sizeBytes'],
+                )
+            );
+        } catch (BadRequestException $exception) {
+            return new JsonResponse([
+                'error' => $exception->getMessage(),
+            ], 400);
+        } catch (NotFoundException $exception) {
+            return new JsonResponse([
+                'error' => $exception->getMessage(),
+            ], 404);
+        }
+
+        return new JsonResponse([
+            'element' => $this->buildElementPayload($element),
+        ], 200);
+    }
+
     private function stringInput(Request $request, string $key): ?string
     {
         $value = $request->input($key);
@@ -94,6 +129,45 @@ class ElementController
         return $value;
     }
 
+    /**
+     * @return array{
+     *     contents: string|null,
+     *     originalName: string|null,
+     *     mimeType: string|null,
+     *     sizeBytes: int|null
+     * }
+     */
+    private function uploadedFileInput(Request $request, string $key): array
+    {
+        $emptyFileInput = [
+            'contents' => null,
+            'originalName' => null,
+            'mimeType' => null,
+            'sizeBytes' => null,
+        ];
+
+        if (! $request->hasFile($key)) {
+            return $emptyFileInput;
+        }
+
+        $file = $request->file($key);
+        if (! $file instanceof UploadedFile) {
+            return $emptyFileInput;
+        }
+
+        $realPath = $file->getRealPath();
+        if ($realPath === false) {
+            return $emptyFileInput;
+        }
+
+        return [
+            'contents' => (string) file_get_contents($realPath),
+            'originalName' => $file->getClientOriginalName(),
+            'mimeType' => (string) $file->getMimeType(),
+            'sizeBytes' => (int) $file->getSize(),
+        ];
+    }
+
     /**
      * @return array{
      *     id: int,
@@ -111,10 +185,26 @@ class ElementController
             'id' => $element->getId(),
             'title' => $element->getTitle(),
             'description' => $element->getDescription(),
-            'iconImageUrl' => $element->getIconImageUrl(),
+            'iconImageUrl' => $this->storageUrl(
+                $element->getIconImageUrl(),
+                'element-icons/',
+            ),
             'richText' => $element->getRichText(),
             'pdfPath' => $element->getPdfPath(),
             'youtubeUrl' => $element->getYoutubeUrl(),
         ];
     }
+
+    private function storageUrl(?string $path, string $folderPrefix): ?string
+    {
+        if ($path === null) {
+            return null;
+        }
+
+        if (str_starts_with($path, $folderPrefix)) {
+            return $this->fileUploader->url($path);
+        }
+
+        return $path;
+    }
 }