slim-blog/tests/Post/PostServiceTest.php

<?php
declare(strict_types=1);

namespace Tests\Post;

use App\Post\Post;
use App\Post\PostRepositoryInterface;
use App\Post\PostService;
use App\Shared\Exception\NotFoundException;
use App\Shared\Html\HtmlSanitizerInterface;
use PHPUnit\Framework\MockObject\MockObject;
use PHPUnit\Framework\TestCase;

/**
 * Tests unitaires pour PostService.
 *
 * Couvre la création, la mise à jour, la suppression et les lectures.
 * HtmlSanitizerInterface et PostRepository sont mockés pour isoler la logique métier.
 */
#[\PHPUnit\Framework\Attributes\AllowMockObjectsWithoutExpectations]
final class PostServiceTest extends TestCase
{
    /** @var PostRepositoryInterface&MockObject */
    private PostRepositoryInterface $repository;

    /** @var HtmlSanitizerInterface&MockObject */
    private HtmlSanitizerInterface $sanitizer;

    private PostService $service;

    protected function setUp(): void
    {
        $this->repository = $this->createMock(PostRepositoryInterface::class);
        $this->sanitizer  = $this->createMock(HtmlSanitizerInterface::class);
        $this->service    = new PostService($this->repository, $this->sanitizer);
    }


    // ── Lectures déléguées ─────────────────────────────────────────

    /**
     * getAllPosts() délègue au repository.
     */
    public function testGetAllPostsDelegatesToRepository(): void
    {
        $posts = [$this->makePost(1, 'Titre', 'slug-titre')];
        $this->repository->method('findAll')->willReturn($posts);

        $this->assertSame($posts, $this->service->getAllPosts());
    }

    /**
     * getRecentPosts() délègue au repository.
     */
    public function testGetRecentPostsDelegatesToRepository(): void
    {
        $posts = [$this->makePost(1, 'Titre', 'slug-titre')];
        $this->repository->method('findRecent')->willReturn($posts);

        $this->assertSame($posts, $this->service->getRecentPosts(5));
    }

    /**
     * getPostsByUserId() délègue au repository.
     */
    public function testGetPostsByUserIdDelegatesToRepository(): void
    {
        $posts = [$this->makePost(1, 'Titre', 'slug-titre')];
        $this->repository->expects($this->once())->method('findByUserId')->with(3, null)->willReturn($posts);

        $this->assertSame($posts, $this->service->getPostsByUserId(3));
    }

    /**
     * getPostBySlug() lève NotFoundException si l'article est introuvable.
     */
    public function testGetPostBySlugThrowsNotFoundExceptionWhenMissing(): void
    {
        $this->repository->method('findBySlug')->willReturn(null);

        $this->expectException(NotFoundException::class);

        $this->service->getPostBySlug('slug-inexistant');
    }

    /**
     * getPostBySlug() retourne l'article tel que stocké — la sanitisation
     * se fait à l'écriture (createPost / updatePost), pas à la lecture.
     */
    public function testGetPostBySlugReturnsPost(): void
    {
        $post = $this->makePost(1, 'Titre', 'mon-slug', '<p>Contenu stocké</p>');
        $this->repository->method('findBySlug')->willReturn($post);

        $result = $this->service->getPostBySlug('mon-slug');

        $this->assertSame('<p>Contenu stocké</p>', $result->getContent());
    }

    /**
     * getPostById() lève NotFoundException si l'article est introuvable.
     */
    public function testGetPostByIdThrowsNotFoundExceptionWhenMissing(): void
    {
        $this->repository->method('findById')->willReturn(null);

        $this->expectException(NotFoundException::class);

        $this->service->getPostById(999);
    }



    /**
     * getPostById() retourne l'article trouvé.
     */
    public function testGetPostByIdReturnsPost(): void
    {
        $post = $this->makePost(7, 'Titre', 'slug-7');
        $this->repository->expects($this->once())->method('findById')->with(7)->willReturn($post);

        self::assertSame($post, $this->service->getPostById(7));
    }

    // ── createPost ─────────────────────────────────────────────────

    /**
     * createPost() lève InvalidArgumentException si le titre est vide.
     */
    public function testCreatePostThrowsWhenTitleEmpty(): void
    {
        $this->expectException(\InvalidArgumentException::class);

        $this->service->createPost('', '<p>Contenu</p>', 1);
    }

    /**
     * createPost() lève InvalidArgumentException si le contenu est vide.
     */
    public function testCreatePostThrowsWhenContentEmpty(): void
    {
        $this->sanitizer->method('sanitize')->willReturn('');

        $this->expectException(\InvalidArgumentException::class);

        $this->service->createPost('Titre', '', 1);
    }

    /**
     * createPost() sanitise le contenu et délègue la persistance.
     */
    public function testCreatePostSanitizesAndPersists(): void
    {
        $this->sanitizer->method('sanitize')->willReturn('<p>Contenu sûr</p>');
        $this->repository->method('findBySlug')->willReturn(null);
        $this->repository->expects($this->once())->method('create')->willReturn(42);

        $id = $this->service->createPost('Mon Titre', '<p>Contenu brut</p>', 1);

        $this->assertSame(42, $id);
    }


    // ── deletePost ─────────────────────────────────────────────────

    /**
     * deletePost() throws NotFoundException when the repository returns 0 affected rows.
     */
    public function testDeletePostThrowsNotFoundExceptionWhenMissing(): void
    {
        $this->repository->method('delete')->willReturn(0);

        $this->expectException(NotFoundException::class);

        $this->service->deletePost(99);
    }

    /**
     * deletePost() délègue la suppression au repository si l'article existe.
     */
    public function testDeletePostDelegatesToRepository(): void
    {
        $this->repository->expects($this->once())->method('delete')->with(5)->willReturn(1);

        $this->service->deletePost(5);
    }


    // ── searchPosts ────────────────────────────────────────────────

    /**
     * searchPosts() délègue la recherche au repository.
     */
    public function testSearchPostsDelegatesToRepository(): void
    {
        $posts = [$this->makePost(1, 'Résultat', 'resultat')];
        $this->repository->expects($this->once())->method('search')->with('mot', null, null)->willReturn($posts);

        $this->assertSame($posts, $this->service->searchPosts('mot'));
    }


    // ── updatePost ─────────────────────────────────────────────────

    /**
     * updatePost() lève NotFoundException si l'article n'existe plus.
     */
    public function testUpdatePostThrowsNotFoundExceptionWhenMissing(): void
    {
        $this->repository->method('findById')->willReturn(null);

        $this->expectException(NotFoundException::class);

        $this->service->updatePost(99, 'Titre', '<p>Contenu</p>');
    }

    /**
     * updatePost() sanitise le contenu et met à jour l'article.
     */
    public function testUpdatePostSanitizesAndUpdates(): void
    {
        $post = $this->makePost(1, 'Ancien titre', 'ancien-titre', '<p>Ancien contenu</p>');
        $this->repository->method('findById')->willReturn($post);
        $this->sanitizer->method('sanitize')->willReturn('<p>Nouveau contenu sûr</p>');
        $this->repository->method('findBySlug')->willReturn(null);
        $this->repository->expects($this->once())->method('update')->willReturn(1);

        $this->service->updatePost(1, 'Nouveau titre', '<p>Nouveau contenu</p>');
    }



    /**
     * updatePost() lève NotFoundException si la ligne disparaît entre lecture et écriture.
     */
    public function testUpdatePostThrowsWhenRepositoryUpdateAffectsZeroRows(): void
    {
        $post = $this->makePost(3, 'Titre courant', 'titre-courant', '<p>Ancien contenu</p>');
        $this->repository->expects($this->once())->method('findById')->with(3)->willReturn($post);
        $this->sanitizer->method('sanitize')->willReturn('<p>Contenu sûr</p>');
        $this->repository->expects($this->once())->method('update')->with(3, $this->isInstanceOf(Post::class), 'titre-courant', null)->willReturn(0);

        $this->expectException(NotFoundException::class);

        $this->service->updatePost(3, 'Titre courant', '<p>Contenu</p>');
    }

    /**
     * updatePost() normalise et rend unique un slug personnalisé.
     */
    public function testUpdatePostUsesNormalizedUniqueCustomSlug(): void
    {
        $current = $this->makePost(4, 'Titre courant', 'ancien-slug', '<p>Ancien contenu</p>');
        $this->repository->expects($this->once())->method('findById')->with(4)->willReturn($current);
        $this->sanitizer->method('sanitize')->willReturn('<p>Contenu sûr</p>');
        $this->repository->expects($this->exactly(2))
            ->method('slugExists')
            ->withAnyParameters()
            ->willReturnOnConsecutiveCalls(true, false);
        $this->repository->expects($this->once())
            ->method('update')
            ->with(4, $this->isInstanceOf(Post::class), 'nouveau-slug-1', 2)
            ->willReturn(1);

        $this->service->updatePost(4, 'Titre courant', '<p>Contenu</p>', '  Nouveau slug !!  ', 2);
    }

    // ── Helpers ────────────────────────────────────────────────────

    /**
     * Crée un Post de test.
     */
    private function makePost(int $id, string $title, string $slug, string $content = '<p>Contenu</p>'): Post
    {
        return new Post($id, $title, $content, $slug);
    }
}