<?php
/**
 * Отказ API aiModelka.
 *
 * @package Aimodelka
 */

namespace Aimodelka\Api;

defined( 'ABSPATH' ) || exit;

/**
 * Исключение клиента API: запрос к aiModelka не удался.
 *
 * Несёт вид отказа (Error_Kind) — по нему плагин выбирает слова для человека — и сырые
 * подробности для журнала: код ответа, код ошибки сервиса, его текст или текст ошибки
 * соединения. Сырые подробности человеку не показываются: текст сервиса на языке аккаунта,
 * а не админки, а текст ошибки cURL человеку ничего не скажет.
 */
final class Api_Exception extends \RuntimeException {

	/**
	 * Создаёт исключение.
	 *
	 * @param Error_Kind $kind        Вид отказа.
	 * @param int|null   $status      Код ответа HTTP; null — ответа не было.
	 * @param string     $error_code  Поле `code` тела ошибки; пустая строка — его нет.
	 * @param string     $detail      Для журнала: текст сервиса или ошибки соединения.
	 */
	public function __construct(
		public readonly Error_Kind $kind,
		public readonly ?int $status,
		public readonly string $error_code,
		string $detail
	) {
		parent::__construct( $detail );
	}

	/**
	 * Подробности для журнала одной строкой.
	 *
	 * @return array<string, mixed>
	 */
	public function log_context(): array {
		return array(
			'kind'        => $this->kind->value,
			'http_status' => $this->status,
			'error_code'  => $this->error_code,
			'detail'      => $this->getMessage(),
		);
	}
}