WhopClient.php

<?php

declare(strict_types=1);

namespace Rapttor\WhopSdk;

use Rapttor\WhopSdk\Http\HttpClient;
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;

/**
 * Whop API client.
 *
 * @property-read AccessTokens          $accessTokens
 * @property-read Apps                  $apps
 * @property-read CheckoutConfigurations $checkoutConfigurations
 * @property-read Companies             $companies
 * @property-read Experiences           $experiences
 * @property-read Invoices              $invoices
 * @property-read Members               $members
 * @property-read Memberships           $memberships
 * @property-read Payments              $payments
 * @property-read Plans                 $plans
 * @property-read Products              $products
 * @property-read PromoCodes            $promoCodes
 * @property-read Refunds               $refunds
 * @property-read Reviews               $reviews
 * @property-read Users                 $users
 * @property-read Webhooks              $webhooks
 */
class WhopClient
{
    private HttpClient $http;

    /** @var array<string, object> */
    private array $resourceCache = [];

    /** @var array<string, class-string> */
    private const RESOURCES = [
        'accessTokens'           => AccessTokens::class,
        'apps'                   => Apps::class,
        'checkoutConfigurations' => CheckoutConfigurations::class,
        'companies'              => Companies::class,
        'experiences'            => Experiences::class,
        'invoices'               => Invoices::class,
        'members'                => Members::class,
        'memberships'            => Memberships::class,
        'payments'               => Payments::class,
        'plans'                  => Plans::class,
        'products'               => Products::class,
        'promoCodes'             => PromoCodes::class,
        'refunds'                => Refunds::class,
        'reviews'                => Reviews::class,
        'users'                  => Users::class,
        'webhooks'               => Webhooks::class,
    ];

    /**
     * @param string|null $apiKey     Whop API key. Falls back to the WHOP_API_KEY env variable.
     * @param string      $baseUrl    Override the API base URL.
     * @param int         $maxRetries Number of automatic retries (default: 2).
     * @param int         $timeout    Request timeout in seconds (default: 60).
     * @param array<string, string> $defaultHeaders Extra headers sent on every request.
     */
    public function __construct(
        ?string $apiKey = null,
        string $baseUrl = 'https://api.whop.com',
        int $maxRetries = 2,
        int $timeout = 60,
        array $defaultHeaders = [],
    ) {
        $resolvedKey = $apiKey ?? (string) getenv('WHOP_API_KEY');

        if ($resolvedKey === '') {
            throw new \InvalidArgumentException(
                'A Whop API key is required. Pass it via $apiKey or set the WHOP_API_KEY environment variable.'
            );
        }

        $this->http = new HttpClient(
            apiKey: $resolvedKey,
            baseUrl: rtrim($baseUrl, '/'),
            maxRetries: $maxRetries,
            timeout: $timeout,
            defaultHeaders: $defaultHeaders,
        );
    }

    // ── Magic resource access ──────────────────────────────────────────────────

    public function __get(string $name): object
    {
        if (!array_key_exists($name, self::RESOURCES)) {
            throw new \InvalidArgumentException(
                "Unknown resource \"{$name}\". Available: " . implode(', ', array_keys(self::RESOURCES))
            );
        }

        if (!isset($this->resourceCache[$name])) {
            $class = self::RESOURCES[$name];
            $this->resourceCache[$name] = new $class($this->http);
        }

        return $this->resourceCache[$name];
    }

    public function __isset(string $name): bool
    {
        return array_key_exists($name, self::RESOURCES);
    }

    // ── Option overrides ───────────────────────────────────────────────────────

    /**
     * Return a new client instance with the given options overridden.
     *
     * Useful for per-request timeout / retry customisation without mutating the
     * original client.
     *
     * @param array{
     *     max_retries?: int,
     *     timeout?: int,
     *     headers?: array<string, string>
     * } $options
     */
    public function withOptions(array $options): static
    {
        $clone = clone $this;
        $clone->http = $this->http->withOptions($options);
        $clone->resourceCache = [];

        return $clone;
    }

    // ── Raw HTTP helpers ───────────────────────────────────────────────────────

    /**
     * @param array<string, mixed>  $query
     * @param array<string, mixed>  $options
     * @return array<string, mixed>
     */
    public function get(string $path, array $query = [], array $options = []): array
    {
        return $this->http->get($path, $query, $options);
    }

    /**
     * @param array<string, mixed>  $body
     * @param array<string, mixed>  $options
     * @return array<string, mixed>
     */
    public function post(string $path, array $body = [], array $options = []): array
    {
        return $this->http->post($path, $body, $options);
    }

    /**
     * @param array<string, mixed>  $body
     * @param array<string, mixed>  $options
     * @return array<string, mixed>
     */
    public function patch(string $path, array $body = [], array $options = []): array
    {
        return $this->http->patch($path, $body, $options);
    }

    /**
     * @param array<string, mixed>  $options
     * @return array<string, mixed>
     */
    public function delete(string $path, array $options = []): array
    {
        return $this->http->delete($path, $options);
    }
}