PageTest.php

<?php

declare(strict_types=1);

namespace Rapttor\WhopSdk\Tests\Unit\Http;

use PHPUnit\Framework\TestCase;
use Rapttor\WhopSdk\Http\Page;
use Rapttor\WhopSdk\Resources\AbstractResource;

/**
 * @covers \Rapttor\WhopSdk\Http\Page
 */
final class PageTest extends TestCase
{
    // ── Helpers ────────────────────────────────────────────────────────────────

    /**
     * Build a Page from a fake response payload.
     *
     * @param list<array<string, mixed>>  $data
     * @param array<string, mixed>        $params
     */
    private function makePage(array $data, ?string $cursor, array $params = []): Page
    {
        $response = ['data' => $data];
        if ($cursor !== null) {
            $response['page_info'] = ['end_cursor' => $cursor];
        }

        $resource = $this->createMock(AbstractResource::class);

        return Page::fromResponse($response, $resource, $params);
    }

    // ── getData / count ────────────────────────────────────────────────────────

    public function testGetDataReturnsItems(): void
    {
        $items = [['id' => 'pay_1'], ['id' => 'pay_2']];
        $page  = $this->makePage($items, null);

        $this->assertSame($items, $page->getData());
    }

    public function testCountReflectsItemsOnCurrentPage(): void
    {
        $page = $this->makePage([['id' => 'a'], ['id' => 'b'], ['id' => 'c']], null);
        $this->assertCount(3, $page);
    }

    public function testEmptyPageHasCountZero(): void
    {
        $page = $this->makePage([], null);
        $this->assertCount(0, $page);
    }

    // ── Pagination state ───────────────────────────────────────────────────────

    public function testHasNextPageReturnsTrueWhenCursorPresent(): void
    {
        $page = $this->makePage([], 'cursor_abc');
        $this->assertTrue($page->hasNextPage());
    }

    public function testHasNextPageReturnsFalseWhenNoCursor(): void
    {
        $page = $this->makePage([], null);
        $this->assertFalse($page->hasNextPage());
    }

    public function testNextPageInfoReturnsArrayWithCursor(): void
    {
        $page = $this->makePage([], 'cursor_xyz');
        $this->assertSame(['after' => 'cursor_xyz'], $page->nextPageInfo());
    }

    public function testNextPageInfoReturnsNullOnLastPage(): void
    {
        $page = $this->makePage([], null);
        $this->assertNull($page->nextPageInfo());
    }

    // ── getNextPage ────────────────────────────────────────────────────────────

    public function testGetNextPageReturnsNullOnLastPage(): void
    {
        $page = $this->makePage([], null);
        $this->assertNull($page->getNextPage());
    }

    // ── Iterator (single page) ─────────────────────────────────────────────────

    public function testIteratorYieldsAllItemsOnSinglePage(): void
    {
        $items = [['id' => 'pay_1'], ['id' => 'pay_2']];
        $page  = $this->makePage($items, null);

        $collected = iterator_to_array($page, false);

        $this->assertSame($items, $collected);
    }

    public function testIteratorOnEmptyPageYieldsNothing(): void
    {
        $page = $this->makePage([], null);

        $collected = iterator_to_array($page, false);

        $this->assertSame([], $collected);
    }

    // ── fromResponse factory ───────────────────────────────────────────────────

    public function testFromResponseHandlesMissingDataKey(): void
    {
        $resource = $this->createMock(AbstractResource::class);
        $page = Page::fromResponse([], $resource, []);

        $this->assertSame([], $page->getData());
        $this->assertFalse($page->hasNextPage());
    }

    public function testFromResponseHandlesMissingPageInfo(): void
    {
        $resource = $this->createMock(AbstractResource::class);
        $page = Page::fromResponse(['data' => [['id' => 'x']]], $resource, []);

        $this->assertFalse($page->hasNextPage());
    }
}