<?php
/**
 * Разбор ответа API aiModelka в вид отказа.
 *
 * @package Aimodelka
 */

namespace Aimodelka\Api;

defined( 'ABSPATH' ) || exit;

/**
 * Превращает код ответа и код ошибки из тела в Error_Kind.
 *
 * Коды — из таблицы `Documents/WPPlugin-HLD.md` §4.6 и схемы `Error` в `specs/openapi.yaml`.
 * Чистая логика без WordPress — проверяется тестами: от неё зависит, что человек прочтёт
 * «получите новый ключ», «попробуйте позже» или «обратитесь к хостингу».
 */
final class Response_Classifier {

	/**
	 * Вид отказа по ответу.
	 *
	 * @param int|null $status Код ответа HTTP; null — ответа не было вовсе (ошибка соединения).
	 * @param string   $code   Поле `code` из тела ошибки; пустая строка — тела нет или оно не JSON.
	 * @return Error_Kind
	 */
	public static function classify( ?int $status, string $code ): Error_Kind {
		if ( null === $status ) {
			return Error_Kind::NoConnection;
		}

		// Сначала — коды сервиса: они точнее кода HTTP. Код ответа 401 бывает и без нашего
		// тела (прокси хостинга), а «ключ неверен» можно говорить только по API_KEY_INVALID.
		switch ( $code ) {
			case 'API_KEY_INVALID':
				return Error_Kind::KeyInvalid;
			case 'ACCOUNT_BLOCKED':
				return Error_Kind::AccountBlocked;
			case 'EMAIL_NOT_VERIFIED':
				return Error_Kind::EmailNotVerified;
			case 'LEGAL_ACCEPTANCE_REQUIRED':
				return Error_Kind::TermsNotAccepted;
			case 'CONTENT_REJECTED':
			case 'FILE_TOO_LARGE':
			case 'IMAGE_TOO_LARGE':
			case 'UNSUPPORTED_IMAGE_TYPE':
				return Error_Kind::PhotoRejected;
			case 'MODERATION_UNAVAILABLE':
			case 'STORAGE_UNAVAILABLE':
				return Error_Kind::ServiceUnavailable;
			case 'TOO_MANY_REQUESTS':
				return Error_Kind::RateLimited;
			case 'NOT_FOUND':
				return Error_Kind::NotFound;
		}

		if ( $status >= 500 ) {
			// 502 и 504 обычно отдаёт не сам сервис, а nginx или Cloudflare перед ним, без
			// нашего тела, — для человека это то же «сервис недоступен».
			return Error_Kind::ServiceUnavailable;
		}

		if ( 429 === $status ) {
			return Error_Kind::RateLimited;
		}

		if ( 404 === $status ) {
			return Error_Kind::NotFound;
		}

		return Error_Kind::Unexpected;
	}
}