<?php

declare(strict_types=1);

namespace App\Exceptions\FormBuilder;

use RuntimeException;

/**
 * Base for every public form-builder API error. Renders as the S2c D6
 * standardised envelope:
 *
 *   { "message": "...", "code": "...", "errors"?: {...} }
 *
 * Concrete subclasses are tiny — they only set the machine code, HTTP
 * status, and the user-facing message.
 */
abstract class PublicFormApiException extends RuntimeException
{
    /** @var array<string, array<int, string>>|null */
    public ?array $fieldErrors = null;

    /** @var array<string, string> */
    public array $headers = [];

    public function __construct(
        public readonly string $publicCode,
        public readonly int $status,
        string $message,
    ) {
        parent::__construct($message);
    }
}