Support paginations aware of their last page

src/Dtos/Config.php

@@ -29,7 +29,7 @@ public function __construct(
  public readonly ?int $perPageOverride = null,
  public readonly ?Closure $nextPage = null,
  public readonly ?string $nextPageKey = null,
- public readonly ?int $lastPage = null,
+ public readonly ?string $lastPageKey = null,
  public readonly ?string $offsetKey = null,
  public readonly ?string $pagination = null,
  public readonly int $async = 3,

src/LazyJsonPages.php

@@ -146,9 +146,9 @@ public function nextPage(Closure|string $key): self
  /**
  * Set the number of the last page.
  */
- public function lastPage(Closure|string $key): self
+ public function lastPage(string $key): self
  {
- $this->config['lastPage'] = $this->integerFromResponse($key);
+ $this->config['lastPageKey'] = $key;
 
  return $this;
  }

src/Paginations/AnyPagination.php

@@ -20,7 +20,7 @@ class AnyPagination extends Pagination
  protected array $supportedPaginations = [
  // CursorPagination::class,
  CustomPagination::class,
- // LastPageAwarePagination::class,
+ LastPageAwarePagination::class,
  // LinkHeaderPagination::class,
  TotalItemsAwarePagination::class,
  TotalPagesAwarePagination::class,

src/Paginations/LastPageAwarePagination.php

@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Cerbero\LazyJsonPages\Paginations;
+
+use Traversable;
+
+/**
+ * The pagination aware of the number of the last page.
+ */
+class LastPageAwarePagination extends LengthAwarePagination
+{
+ /**
+ * Determine whether the configuration matches this pagination.
+ */
+ public function matches(): bool
+ {
+ return $this->config->lastPageKey !== null;
+ }
+
+ /**
+ * Yield the paginated items.
+ *
+ * @return Traversable<int, mixed>
+ */
+ public function getIterator(): Traversable
+ {
+ yield from $this->yieldItemsUntilKey($this->config->lastPageKey, function (int $page) {
+ return $this->config->firstPage === 0 ? $page + 1 : $page;
+ });
+ }
+}

src/Paginations/TotalItemsAwarePagination.php

@@ -19,7 +19,7 @@ public function matches(): bool
  {
  return $this->config->totalItemsKey !== null
  && $this->config->totalPagesKey === null
- && $this->config->perPage === null;
+ && $this->config->lastPageKey === null;
  }
 
  /**