Implement the aggragation of paginations

src/Exceptions/UnsupportedPaginationException.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Cerbero\LazyJsonPages\Exceptions;
+
+use Cerbero\LazyJsonPages\Dtos\Config;
+
+/**
+ * The exception to throw when a pagination is not supported.
+ */
+class UnsupportedPaginationException extends LazyJsonPagesException
+{
+    /**
+     * Instantiate the class.
+     */
+    public function __construct(public readonly Config $config)
+    {
+        parent::__construct('The provided configuration does not match with any supported pagination.');
+    }
+}

src/Paginations/AnyPagination.php

@@ -4,7 +4,50 @@
 
 namespace Cerbero\LazyJsonPages\Paginations;
 
+use Cerbero\LazyJsonPages\Exceptions\UnsupportedPaginationException;
+use Traversable;
+
+/**
+ * The aggregator of paginations.
+ */
 class AnyPagination extends Pagination
 {
-    //
+    /**
+     * The supported paginations.
+     *
+     * @var class-string<Pagination>[]
+     */
+    protected array $supportedPaginations = [
+        CursorPagination::class,
+        CustomPagination::class,
+        LengthAwarePagination::class,
+        LinkHeaderPagination::class,
+        OffsetPagination::class,
+    ];
+
+    /**
+     * Determine whether the configuration matches this pagination.
+     */
+    public function matches(): bool
+    {
+        return true;
+    }
+
+    /**
+     * Yield the paginated items.
+     *
+     * @return Traversable<string|int, mixed>
+     */
+    public function getIterator(): Traversable
+    {
+        foreach ($this->supportedPaginations as $class) {
+            $pagination = new $class($this->source, $this->config);
+
+            if ($pagination->matches()) {
+                return $pagination;
+            }
+        }
+
+        throw new UnsupportedPaginationException($this->config);
+    }
 }

src/Paginations/Pagination.php

@@ -10,20 +10,26 @@
 use Traversable;
 
 /**
+ * The abstract implementation of a pagination.
+ *
  * @implements IteratorAggregate<string|int, mixed>
  */
 abstract class Pagination implements IteratorAggregate
 {
-    final public function __construct(
-        protected readonly AnySource $source,
-        protected readonly Config $config,
-    ) {}
+    /**
+     * Determine whether the configuration matches this pagination.
+     */
+    abstract public function matches(): bool;
 
     /**
+     * Yield the paginated items.
+     *
      * @return Traversable<string|int, mixed>
      */
-    public function getIterator(): Traversable
-    {
-        yield 1;
-    }
+    abstract public function getIterator(): Traversable;
+
+    final public function __construct(
+        protected readonly AnySource $source,
+        protected readonly Config $config,
+    ) {}
 }