test icon uploads

backend/tests/Unit/Controllers/ElementControllerTest.php

@@ -8,13 +8,17 @@ use App\Element\Element;
 use App\Element\UseCases\GetElement\GetElement;
 use App\Element\UseCases\UpdateElement\UpdateDescription;
 use App\Element\UseCases\UpdateElement\UpdateElement;
+use App\Element\UseCases\UpdateElement\UpdateElementIconImage;
 use App\Element\UseCases\UpdateElement\UpdateIconImageUrl;
 use App\Element\UseCases\UpdateElement\UpdatePdfPath;
 use App\Element\UseCases\UpdateElement\UpdateRichText;
 use App\Element\UseCases\UpdateElement\UpdateTitle;
 use App\Element\UseCases\UpdateElement\UpdateYoutubeUrl;
 use App\Set\Set as DomainSet;
+use Illuminate\Http\Request;
+use Illuminate\Http\UploadedFile;
 use Tests\Fakes\FakeElementRepository;
+use Tests\Fakes\FakeFileUploader;
 use Tests\TestCase;
 
 class ElementControllerTest extends TestCase
@@ -23,9 +27,12 @@ class ElementControllerTest extends TestCase
 
     private FakeElementRepository $elementRepo;
 
+    private FakeFileUploader $fileUploader;
+
     protected function setUp(): void
     {
         $this->elementRepo = new FakeElementRepository();
+        $this->fileUploader = new FakeFileUploader();
         $getElement = new GetElement($this->elementRepo);
         $updateElement = new UpdateElement(
             new UpdateTitle($this->elementRepo),
@@ -36,7 +43,15 @@ class ElementControllerTest extends TestCase
             new UpdateYoutubeUrl($this->elementRepo),
             $this->elementRepo,
         );
-        $this->controller = new ElementController($getElement, $updateElement);
+        $this->controller = new ElementController(
+            $getElement,
+            $updateElement,
+            new UpdateElementIconImage(
+                $this->elementRepo,
+                $this->fileUploader,
+            ),
+            $this->fileUploader,
+        );
     }
 
     public function testShowReturnsElementPayload(): void
@@ -135,6 +150,50 @@ class ElementControllerTest extends TestCase
         );
     }
 
+    public function testUploadIconImageReturnsElementPayload(): void
+    {
+        $set = $this->createSet(1, 'Baderech');
+        $element = $this->createElement(
+            $set,
+            'Baderech HaAvodah',
+            'A structured path for growth',
+            null,
+            '<p>A structured path for growth</p>',
+            null,
+            null,
+            null,
+        );
+        $fixturePath = __DIR__
+            . '/../../../../frontend/rabbi_gerzi/public/assets/'
+            . 'baderech-haavodah-icon.png';
+        $request = new Request([], [], [], [], [
+            'iconImage' => new UploadedFile(
+                $fixturePath,
+                'icon.png',
+                'image/png',
+                null,
+                true,
+            ),
+        ]);
+
+        $response = $this->controller->uploadIconImage(
+            $element->getId(),
+            $request,
+        );
+
+        $this->assertEquals(200, $response->getStatusCode());
+        $body = json_decode($response->getContent(), true);
+        $this->assertSame($element->getId(), $body['element']['id']);
+        $this->assertSame(
+            'https://test.local/storage/element-icons/fake-icon.png',
+            $body['element']['iconImageUrl'],
+        );
+        $this->assertSame(
+            'element-icons',
+            $this->fileUploader->uploads[0]['folder'],
+        );
+    }
+
     private function createSet(int $id, string $name): DomainSet
     {
         return new DomainSet(

backend/tests/Unit/Element/UseCases/UpdateElementIconImageTest.php

@@ -0,0 +1,175 @@
+<?php
+
+namespace Tests\Unit\Element\UseCases;
+
+use App\Element\CreateElementDto;
+use App\Element\Element;
+use App\Element\UseCases\UpdateElement\UpdateElementIconImage;
+use App\Element\UseCases\UpdateElement\UpdateElementIconImageRequest;
+use App\Exceptions\BadRequestException;
+use App\Exceptions\NotFoundException;
+use App\Set\Set as DomainSet;
+use Tests\Fakes\FakeElementRepository;
+use Tests\Fakes\FakeFileUploader;
+use Tests\TestCase;
+
+class UpdateElementIconImageTest extends TestCase
+{
+    private FakeElementRepository $elementRepository;
+
+    private FakeFileUploader $fileUploader;
+
+    private UpdateElementIconImage $useCase;
+
+    protected function setUp(): void
+    {
+        $this->elementRepository = new FakeElementRepository();
+        $this->fileUploader = new FakeFileUploader();
+        $this->useCase = new UpdateElementIconImage(
+            $this->elementRepository,
+            $this->fileUploader,
+        );
+    }
+
+    /**
+     * @return array{
+     *     iconImageContents: string,
+     *     iconImageOriginalName: string,
+     *     iconImageMimeType: string,
+     *     iconImageSizeBytes: int
+     * }
+     */
+    private function imageArgs(): array
+    {
+        return [
+            'iconImageContents' => 'binary-image-bytes',
+            'iconImageOriginalName' => 'icon.png',
+            'iconImageMimeType' => 'image/png',
+            'iconImageSizeBytes' => 1024,
+        ];
+    }
+
+    public function testUploadsIconImageAndStoresPath(): void
+    {
+        $element = $this->createElement();
+
+        $updatedElement = $this->useCase->execute(
+            new UpdateElementIconImageRequest(
+                ...$this->imageArgs(),
+                id: $element->getId(),
+            )
+        );
+
+        $this->assertSame(
+            'element-icons/fake-icon.png',
+            $updatedElement->getIconImageUrl(),
+        );
+        $this->assertSame(
+            'element-icons/fake-icon.png',
+            $this->elementRepository
+                ->find($element->getId())
+                ->getIconImageUrl(),
+        );
+        $this->assertSame(
+            'element-icons',
+            $this->fileUploader->uploads[0]['folder'],
+        );
+    }
+
+    public function testNullIdThrowsBadRequest(): void
+    {
+        $this->expectException(BadRequestException::class);
+        $this->expectExceptionMessage('id is required');
+
+        $this->useCase->execute(
+            new UpdateElementIconImageRequest(
+                ...$this->imageArgs(),
+                id: null,
+            )
+        );
+    }
+
+    public function testNullIconImageThrowsBadRequest(): void
+    {
+        $this->expectException(BadRequestException::class);
+        $this->expectExceptionMessage('icon image is required');
+
+        $this->useCase->execute(
+            new UpdateElementIconImageRequest(
+                id: 1,
+                iconImageContents: null,
+                iconImageOriginalName: null,
+                iconImageMimeType: null,
+                iconImageSizeBytes: null,
+            )
+        );
+    }
+
+    public function testDisallowedMimeThrowsBadRequest(): void
+    {
+        $this->expectException(BadRequestException::class);
+        $this->expectExceptionMessage(
+            'icon image must be a jpeg, png or webp image',
+        );
+
+        $this->useCase->execute(
+            new UpdateElementIconImageRequest(
+                id: 1,
+                iconImageContents: 'not-an-image',
+                iconImageOriginalName: 'icon.pdf',
+                iconImageMimeType: 'application/pdf',
+                iconImageSizeBytes: 1024,
+            )
+        );
+    }
+
+    public function testOversizedIconImageThrowsBadRequest(): void
+    {
+        $this->expectException(BadRequestException::class);
+        $this->expectExceptionMessage('icon image must be 5MB or smaller');
+
+        $this->useCase->execute(
+            new UpdateElementIconImageRequest(
+                id: 1,
+                iconImageContents: 'big',
+                iconImageOriginalName: 'icon.png',
+                iconImageMimeType: 'image/png',
+                iconImageSizeBytes: 6 * 1024 * 1024,
+            )
+        );
+    }
+
+    public function testMissingElementThrowsNotFound(): void
+    {
+        $this->expectException(NotFoundException::class);
+        $this->expectExceptionMessage('Element not found');
+
+        $this->useCase->execute(
+            new UpdateElementIconImageRequest(
+                ...$this->imageArgs(),
+                id: 999,
+            )
+        );
+    }
+
+    private function createElement(): Element
+    {
+        $set = new DomainSet(
+            id: 1,
+            name: 'Baderech',
+            description: 'Baderech description',
+            iconImageUrl: '/assets/baderech-icon.png',
+        );
+
+        return $this->elementRepository->create(new CreateElementDto(
+            set: $set,
+            title: 'Original title',
+            description: 'Original description',
+            iconImageUrl: null,
+            richText: '',
+            pdfPath: null,
+            youtubeUrl: null,
+            parentElement: null,
+        ));
+    }
+}