WhopClientTest.php

<?php

declare(strict_types=1);

namespace Rapttor\WhopSdk\Tests\Unit;

use Rapttor\WhopSdk\Resources\AccessTokens;
use Rapttor\WhopSdk\Resources\Apps;
use Rapttor\WhopSdk\Resources\CheckoutConfigurations;
use Rapttor\WhopSdk\Resources\Companies;
use Rapttor\WhopSdk\Resources\Experiences;
use Rapttor\WhopSdk\Resources\Invoices;
use Rapttor\WhopSdk\Resources\Members;
use Rapttor\WhopSdk\Resources\Memberships;
use Rapttor\WhopSdk\Resources\Payments;
use Rapttor\WhopSdk\Resources\Plans;
use Rapttor\WhopSdk\Resources\Products;
use Rapttor\WhopSdk\Resources\PromoCodes;
use Rapttor\WhopSdk\Resources\Refunds;
use Rapttor\WhopSdk\Resources\Reviews;
use Rapttor\WhopSdk\Resources\Users;
use Rapttor\WhopSdk\Resources\Webhooks;
use Rapttor\WhopSdk\Tests\SdkTestCase;
use Rapttor\WhopSdk\WhopClient;

/**
 * @covers \Rapttor\WhopSdk\WhopClient
 */
final class WhopClientTest extends SdkTestCase
{
    // ── Construction ───────────────────────────────────────────────────────────

    public function testConstructWithExplicitApiKey(): void
    {
        $client = new WhopClient(apiKey: 'my_key');
        $this->assertInstanceOf(WhopClient::class, $client);
    }

    public function testConstructReadsApiKeyFromEnvironment(): void
    {
        putenv('WHOP_API_KEY=env_key_123');
        $client = new WhopClient();
        $this->assertInstanceOf(WhopClient::class, $client);
        putenv('WHOP_API_KEY=');
    }

    public function testConstructThrowsWhenNoApiKeyProvided(): void
    {
        $this->expectException(\InvalidArgumentException::class);
        $this->expectExceptionMessageMatches('/api key/i');

        putenv('WHOP_API_KEY=');
        new WhopClient();
    }

    // ── Resource access ────────────────────────────────────────────────────────

    /**
     * @dataProvider resourceProvider
     */
    public function testResourceAccessReturnsCorrectType(string $property, string $expectedClass): void
    {
        $client = $this->makeClient();
        $this->assertInstanceOf($expectedClass, $client->$property);
    }

    /**
     * @return array<string, array{string, class-string}>
     */
    public static function resourceProvider(): array
    {
        return [
            'accessTokens'           => ['accessTokens',           AccessTokens::class],
            'apps'                   => ['apps',                   Apps::class],
            'checkoutConfigurations' => ['checkoutConfigurations', CheckoutConfigurations::class],
            'companies'              => ['companies',              Companies::class],
            'experiences'            => ['experiences',            Experiences::class],
            'invoices'               => ['invoices',               Invoices::class],
            'members'                => ['members',                Members::class],
            'memberships'            => ['memberships',            Memberships::class],
            'payments'               => ['payments',               Payments::class],
            'plans'                  => ['plans',                  Plans::class],
            'products'               => ['products',               Products::class],
            'promoCodes'             => ['promoCodes',             PromoCodes::class],
            'refunds'                => ['refunds',                Refunds::class],
            'reviews'                => ['reviews',                Reviews::class],
            'users'                  => ['users',                  Users::class],
            'webhooks'               => ['webhooks',               Webhooks::class],
        ];
    }

    public function testResourceIsCachedOnSubsequentAccess(): void
    {
        $client = $this->makeClient();

        $first  = $client->payments;
        $second = $client->payments;

        $this->assertSame($first, $second);
    }

    public function testIssetReturnsTrueForKnownResource(): void
    {
        $client = $this->makeClient();
        $this->assertTrue(isset($client->payments));
    }

    public function testIssetReturnsFalseForUnknownResource(): void
    {
        $client = $this->makeClient();
        $this->assertFalse(isset($client->unknown));
    }

    public function testAccessingUnknownResourceThrowsInvalidArgument(): void
    {
        $this->expectException(\InvalidArgumentException::class);
        $this->expectExceptionMessageMatches('/unknown resource/i');

        $client = $this->makeClient();
        /** @phpstan-ignore-next-line */
        $client->doesNotExist;
    }

    // ── withOptions ────────────────────────────────────────────────────────────

    public function testWithOptionsReturnsNewClientInstance(): void
    {
        $client  = $this->makeClient();
        $derived = $client->withOptions(['max_retries' => 0]);

        $this->assertNotSame($client, $derived);
        $this->assertInstanceOf(WhopClient::class, $derived);
    }

    public function testWithOptionsClearsCachedResources(): void
    {
        $client  = $this->makeClient();
        $before  = $client->payments;    // populate cache

        $derived = $client->withOptions(['timeout' => 5]);
        $after   = $derived->payments;   // new instance, fresh cache

        $this->assertNotSame($before, $after);
    }
}