Add: update template endpoint

Author: tatevikg1

src/Messaging/Controller/TemplateController.php

@@ -14,6 +14,7 @@
 use PhpList\RestBundle\Common\Service\Provider\PaginatedDataProvider;
 use PhpList\RestBundle\Common\Validator\RequestValidator;
 use PhpList\RestBundle\Messaging\Request\CreateTemplateRequest;
+use PhpList\RestBundle\Messaging\Request\UpdateTemplateRequest;
 use PhpList\RestBundle\Messaging\Serializer\TemplateNormalizer;
 use Symfony\Bridge\Doctrine\Attribute\MapEntity;
 use Symfony\Component\HttpFoundation\JsonResponse;
@@ -229,6 +230,72 @@ public function createTemplates(Request $request): JsonResponse
         );
     }
 
+    #[Route('/{templateId}', name: 'update', methods: ['PUT'])]
+    #[OA\Put(
+        path: '/api/v2/templates/{templateId}',
+        description: '🚧 **Status: Beta** – This method is under development. Avoid using in production. ' .
+        'Returns a JSON response of updated template.',
+        summary: 'Update template.',
+        requestBody: new OA\RequestBody(
+            description: 'Pass session credentials',
+            required: true,
+            content: new OA\MediaType(
+                mediaType: 'multipart/form-data',
+                schema: new OA\Schema(ref: '#/components/schemas/CreateTemplateRequest')
+            )
+        ),
+        tags: ['templates'],
+        parameters: [
+            new OA\Parameter(
+                name: 'php-auth-pw',
+                description: 'Session key obtained from login',
+                in: 'header',
+                required: true,
+                schema: new OA\Schema(type: 'string')
+            ),
+        ],
+        responses: [
+            new OA\Response(
+                response: 201,
+                description: 'Success',
+                content: new OA\JsonContent(
+                    type: 'array',
+                    items: new OA\Items(ref: '#/components/schemas/Template')
+                )
+            ),
+            new OA\Response(
+                response: 403,
+                description: 'Failure',
+                content: new OA\JsonContent(ref: '#/components/schemas/UnauthorizedResponse')
+            ),
+            new OA\Response(
+                response: 422,
+                description: 'Failure',
+                content: new OA\JsonContent(ref: '#/components/schemas/ValidationErrorResponse')
+            ),
+        ]
+    )]
+    public function updateTemplates(
+        Request $request,
+        #[MapEntity(mapping: ['templateId' => 'id'])] ?Template $template = null,
+    ): JsonResponse {
+        $this->requireAuthentication($request);
+
+        if (!$template) {
+            throw $this->createNotFoundException('Template not found.');
+        }
+
+        /** @var UpdateTemplateRequest $templateRequest */
+        $templateRequest = $this->validator->validate($request, UpdateTemplateRequest::class);
+        $template = $this->templateManager->update(template: $template, updateTemplateDto: $templateRequest->getDto());
+        $this->entityManager->flush();
+
+        return $this->json(
+            data: $this->normalizer->normalize($template),
+            status: Response::HTTP_CREATED
+        );
+    }
+
     #[Route('/{templateId}', name: 'delete', requirements: ['templateId' => '\d+'], methods: ['DELETE'])]
     #[OA\Delete(
         path: '/api/v2/templates/{templateId}',

src/Messaging/Request/UpdateTemplateRequest.php

@@ -0,0 +1,83 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PhpList\RestBundle\Messaging\Request;
+
+use OpenApi\Attributes as OA;
+use PhpList\Core\Domain\Messaging\Model\Dto\CreateTemplateDto;
+use PhpList\Core\Domain\Messaging\Model\Dto\UpdateTemplateDto;
+use PhpList\RestBundle\Common\Request\RequestInterface;
+use PhpList\RestBundle\Messaging\Validator\Constraint\ContainsPlaceholder;
+use Symfony\Component\HttpFoundation\File\UploadedFile;
+use Symfony\Component\Validator\Constraints as Assert;
+
+#[OA\Schema(
+    schema: 'CreateTemplateRequest',
+    required: ['title'],
+    properties: [
+        new OA\Property(property: 'title', type: 'string', example: 'Newsletter Template'),
+        new OA\Property(
+            property: 'content',
+            type: 'string',
+            example: '<html><body>[CONTENT]</body></html>',
+            nullable: true
+        ),
+        new OA\Property(property: 'text', type: 'string', example: '[CONTENT]'),
+        new OA\Property(
+            property: 'file',
+            description: 'Optional file upload for HTML content',
+            type: 'string',
+            format: 'binary'
+        ),
+        new OA\Property(
+            property: 'check_links',
+            description: 'Check that all links have full URLs',
+            type: 'boolean',
+            example: true
+        ),
+        new OA\Property(
+            property: 'check_images',
+            description: 'Check that all images have full URLs',
+            type: 'boolean',
+            example: false
+        ),
+        new OA\Property(
+            property: 'check_external_images',
+            description: 'Check that all external images exist',
+            type: 'boolean',
+            example: true
+        ),
+    ],
+    type: 'object'
+)]
+class UpdateTemplateRequest implements RequestInterface
+{
+    #[Assert\NotBlank(normalizer: 'trim')]
+    #[Assert\NotNull]
+    public string $title;
+
+    #[ContainsPlaceholder]
+    public ?string $content = null;
+
+    #[ContainsPlaceholder]
+    public ?string $text = null;
+
+    public ?UploadedFile $file = null;
+    public bool $checkLinks = false;
+    public bool $checkImages = false;
+    public bool $checkExternalImages = false;
+
+    public function getDto(): UpdateTemplateDto
+    {
+        return new UpdateTemplateDto(
+            title: $this->title,
+            content: $this->content,
+            text: $this->text,
+            fileContent: $this->file instanceof UploadedFile ? file_get_contents($this->file->getPathname()) : null,
+            shouldCheckLinks: $this->checkLinks,
+            shouldCheckImages: $this->checkImages,
+            shouldCheckExternalImages: $this->checkExternalImages,
+        );
+    }
+}