AbstractResource.php

<?php

declare(strict_types=1);

namespace Rapttor\WhopSdk\Resources;

use Rapttor\WhopSdk\Http\HttpClient;
use Rapttor\WhopSdk\Http\Page;

/**
 * Base class for all Whop API resource wrappers.
 */
abstract class AbstractResource
{
    public function __construct(
        protected readonly HttpClient $client,
    ) {}

    /**
     * Build a Page from a raw API response.
     *
     * @param array<string, mixed> $response
     * @param array<string, mixed> $params
     * @return Page<array<string, mixed>>
     */
    protected function buildPage(array $response, array $params): Page
    {
        return Page::fromResponse($response, $this, $params);
    }

    /**
     * Resources that support listing must implement this to enable auto-pagination.
     *
     * @param array<string, mixed> $params
     * @return Page<array<string, mixed>>
     */
    public function list(array $params = []): Page
    {
        throw new \BadMethodCallException(static::class . ' does not support list().');
    }

    /**
     * Helper: extract and validate a required string parameter.
     *
     * @param array<string, mixed> $params
     */
    protected function requireParam(array $params, string $key): string
    {
        $value = $params[$key] ?? null;

        if (!is_string($value) || $value === '') {
            throw new \InvalidArgumentException("\"{$key}\" is required and must be a non-empty string.");
        }

        return $value;
    }

    /**
     * Helper: strip known resource-level params before forwarding to the HTTP query.
     *
     * @param array<string, mixed> $params
     * @param list<string>         $keys
     * @return array<string, mixed>
     */
    protected function stripParams(array $params, array $keys): array
    {
        return array_diff_key($params, array_flip($keys));
    }
}