[EasyPagination] Improve enum support

packages/EasyPagination/src/Paginator/DoctrineCommonPaginatorTrait.php

@@ -3,6 +3,8 @@
 
 namespace EonX\EasyPagination\Paginator;
 
+use BackedEnum;
+use Doctrine\DBAL\ParameterType;
 use Doctrine\DBAL\Platforms\PostgreSQLPlatform;
 use Doctrine\DBAL\Platforms\SqlitePlatform;
 use Doctrine\DBAL\Query\QueryBuilder as DbalQueryBuilder;
@@ -189,6 +191,13 @@ private function getTotalItemsForLargeDataset(OrmQueryBuilder|DbalQueryBuilder $
             $paramTypes = $queryBuilder->getParameterTypes();
         }
 
+        foreach ($params as $key => $param) {
+            if ($param instanceof BackedEnum) {
+                $params[$key] = $param->value;
+                $paramTypes[$key] = \is_int($param->value) ? ParameterType::INTEGER : ParameterType::STRING;
+            }
+        }
+
         if (\is_string($sql) === false) {
             return null;
         }

packages/EasyPagination/src/Paginator/DoctrineDbalPaginatorTrait.php

@@ -3,7 +3,9 @@
 
 namespace EonX\EasyPagination\Paginator;
 
+use BackedEnum;
 use Doctrine\DBAL\Connection;
+use Doctrine\DBAL\ParameterType;
 use Doctrine\DBAL\Query\QueryBuilder;
 
 trait DoctrineDbalPaginatorTrait
@@ -25,11 +27,17 @@ private function createQueryBuilder(): QueryBuilder
      */
     private function fetchResults(QueryBuilder $queryBuilder): array
     {
-        return $this->connection->fetchAllAssociative(
-            $queryBuilder->getSQL(),
-            $queryBuilder->getParameters(),
-            $queryBuilder->getParameterTypes()
-        );
+        $params = $queryBuilder->getParameters();
+        $paramTypes = $queryBuilder->getParameterTypes();
+
+        foreach ($params as $key => $param) {
+            if ($param instanceof BackedEnum) {
+                $params[$key] = $param->value;
+                $paramTypes[$key] = \is_int($param->value) ? ParameterType::INTEGER : ParameterType::STRING;
+            }
+        }
+
+        return $this->connection->fetchAllAssociative($queryBuilder->getSQL(), $params, $paramTypes);
     }
 
     private function getConnection(): Connection

packages/EasyPagination/tests/Stub/Entity/Item.php

@@ -5,6 +5,7 @@
 
 use Doctrine\DBAL\Types\Types;
 use Doctrine\ORM\Mapping as ORM;
+use EonX\EasyPagination\Tests\Stub\Enum\Status;
 
 #[ORM\Entity]
 #[ORM\Table(name: 'items')]
@@ -15,6 +16,9 @@ class Item
     #[ORM\Id]
     private int $id;
 
+    #[ORM\Column(type: Types::STRING, length: 255, nullable: true, enumType: Status::class)]
+    private ?Status $status = null;
+
     #[ORM\Column(type: Types::STRING, length: 255, nullable: true)]
     private ?string $title = null;
 
@@ -23,11 +27,21 @@ public function getId(): int
         return $this->id;
     }
 
+    public function getStatus(): ?Status
+    {
+        return $this->status;
+    }
+
     public function getTitle(): ?string
     {
         return $this->title;
     }
 
+    public function setStatus(?Status $status): void
+    {
+        $this->status = $status;
+    }
+
     public function setTitle(?string $title): void
     {
         $this->title = $title;

packages/EasyPagination/tests/Stub/Enum/Status.php

@@ -0,0 +1,11 @@
+<?php
+declare(strict_types=1);
+
+namespace EonX\EasyPagination\Tests\Stub\Enum;
+
+enum Status: string
+{
+    case Active = 'active';
+
+    case Inactive = 'inactive';
+}

packages/EasyPagination/tests/Unit/src/Paginator/AbstractDoctrineDbalPaginatorTestCase.php

@@ -6,6 +6,7 @@
 use Doctrine\DBAL\Connection;
 use Doctrine\DBAL\DriverManager;
 use Doctrine\DBAL\Schema\Schema;
+use EonX\EasyPagination\Tests\Stub\Enum\Status;
 use EonX\EasyPagination\Tests\Unit\AbstractUnitTestCase;
 use Symfony\Component\Uid\Uuid;
 
@@ -27,9 +28,9 @@ protected static function addChildItemToTable(Connection $connection, string $ti
     /**
      * @throws \Doctrine\DBAL\Exception
      */
-    protected static function addItemToTable(Connection $connection, string $title): void
+    protected static function addItemToTable(Connection $connection, string $title, ?Status $status = null): void
     {
-        $connection->insert('items', ['title' => $title]);
+        $connection->insert('items', ['title' => $title, 'status' => $status?->value]);
     }
 
     /**
@@ -76,6 +77,10 @@ protected static function createItemsTable(Connection $connection): void
             ->addColumn('title', 'string', ['length' => 255])
             ->setNotnull(false);
 
+        $table
+            ->addColumn('status', 'string', ['length' => 255])
+            ->setNotnull(false);
+
         $table->setPrimaryKey(['id']);
 
         foreach ($schema->toSql($connection->getDatabasePlatform()) as $sql) {

packages/EasyPagination/tests/Unit/src/Paginator/AbstractDoctrineOrmPaginatorTestCase.php

@@ -12,6 +12,7 @@
 use Doctrine\ORM\Tools\SchemaTool;
 use EonX\EasyPagination\Tests\Stub\Entity\ChildItem;
 use EonX\EasyPagination\Tests\Stub\Entity\Item;
+use EonX\EasyPagination\Tests\Stub\Enum\Status;
 use EonX\EasyPagination\Tests\Stub\Type\SqliteStringUuidType;
 use EonX\EasyPagination\Tests\Unit\AbstractUnitTestCase;
 
@@ -29,10 +30,14 @@ protected static function addChildItemToTable(EntityManagerInterface $manager, s
         $manager->flush();
     }
 
-    protected static function addItemToTable(EntityManagerInterface $manager, string $title): Item
-    {
+    protected static function addItemToTable(
+        EntityManagerInterface $manager,
+        string $title,
+        ?Status $status = null,
+    ): Item {
         $item = new Item();
         $item->setTitle($title);
+        $item->setStatus($status);
 
         $manager->persist($item);
         $manager->flush();

packages/EasyPagination/tests/Unit/src/Paginator/DoctrineDbalLengthAwarePaginatorTest.php

@@ -10,6 +10,7 @@
 use EonX\EasyPagination\Pagination\Pagination;
 use EonX\EasyPagination\Pagination\PaginationInterface;
 use EonX\EasyPagination\Paginator\DoctrineDbalLengthAwarePaginator;
+use EonX\EasyPagination\Tests\Stub\Enum\Status;
 use PHPUnit\Framework\Attributes\DataProvider;
 use Prophecy\Argument;
 use Prophecy\PhpUnit\ProphecyTrait;
@@ -136,6 +137,27 @@ static function (DoctrineDbalLengthAwarePaginator $paginator): void {
             },
         ];
 
+        yield '2 items filter 1 with enum parameter' => [
+            Pagination::create(1, 15),
+            'items',
+            null,
+            function (Connection $connection, DoctrineDbalLengthAwarePaginator $paginator): void {
+                self::createItemsTable($connection);
+                self::addItemToTable($connection, 'my-title', Status::Active);
+                self::addItemToTable($connection, 'my-title-1', Status::Inactive);
+
+                $paginator->setFilterCriteria(static function (QueryBuilder $queryBuilder): void {
+                    $queryBuilder
+                        ->where('status = :status')
+                        ->setParameter('status', Status::Inactive);
+                });
+            },
+            static function (DoctrineDbalLengthAwarePaginator $paginator): void {
+                self::assertCount(1, $paginator->getItems());
+                self::assertEquals(1, $paginator->getTotalItems());
+            },
+        ];
+
         yield '2 items filter 1 with fromAlias' => [
             Pagination::create(1, 15),
             'items',

packages/EasyPagination/tests/Unit/src/Paginator/DoctrineOrmLengthAwarePaginatorTest.php

@@ -14,6 +14,7 @@
 use EonX\EasyPagination\Paginator\DoctrineOrmLengthAwarePaginator;
 use EonX\EasyPagination\Tests\Stub\Entity\ChildItem;
 use EonX\EasyPagination\Tests\Stub\Entity\Item;
+use EonX\EasyPagination\Tests\Stub\Enum\Status;
 use PHPUnit\Framework\Attributes\DataProvider;
 use Prophecy\Argument;
 use Prophecy\PhpUnit\ProphecyTrait;
@@ -93,6 +94,28 @@ static function (DoctrineOrmLengthAwarePaginator $paginator): void {
             },
         ];
 
+        yield '2 items filter 1 with enum parameter' => [
+            Pagination::create(1, 15),
+            Item::class,
+            'i',
+            null,
+            function (EntityManagerInterface $manager, DoctrineOrmLengthAwarePaginator $paginator): void {
+                self::createItemsTable($manager);
+                self::addItemToTable($manager, 'my-title', Status::Active);
+                self::addItemToTable($manager, 'my-title-1', Status::Inactive);
+
+                $paginator->setFilterCriteria(static function (QueryBuilder $queryBuilder): void {
+                    $queryBuilder
+                        ->where('i.status = :status')
+                        ->setParameter('status', Status::Inactive);
+                });
+            },
+            static function (DoctrineOrmLengthAwarePaginator $paginator): void {
+                self::assertCount(1, $paginator->getItems());
+                self::assertEquals(1, $paginator->getTotalItems());
+            },
+        ];
+
         yield '1 item select everything by default' => [
             Pagination::create(1, 15),
             Item::class,