<?php
declare(strict_types=1);

require_once dirname(__DIR__) . '/payments.php';

/**
 * Square driver stub — Phase B priority C.
 * Settings fields exist in Admin; live Checkout API lands when a shop needs Square POS.
 */
final class SquareGateway implements PaymentGateway
{
    /** @param array<string,mixed> $settings */
    public function __construct(private array $settings)
    {
    }

    public function providerId(): string
    {
        return 'square';
    }

    public function createCheckout(array $input): array
    {
        throw new RuntimeException(
            'Square checkout is not enabled yet (priority C). Use Stripe, PayPal/Venmo, or pay at shop for now.'
        );
    }

    public function fetchStatus(string $externalId): array
    {
        return ['status' => 'pending', 'external_id' => $externalId, 'raw' => ['stub' => true]];
    }
}
