<?php
/**
 * A refusal the REST layer turns into a translated error response.
 *
 * @package Fitzaro
 */

namespace Fitzaro\Api;

defined( 'ABSPATH' ) || exit;

// The message is never printed; RestController maps the code to escaped, translated text.
// phpcs:disable WordPress.Security.EscapeOutput.ExceptionNotEscaped

/**
 * Code + HTTP status + optional detail code (e.g. why a photo was rejected).
 */
final class ApiError extends \RuntimeException {

	public const INVALID_PHOTO       = 'invalid_photo';
	public const PHOTO_EXPIRED       = 'photo_expired';
	public const PRODUCT_UNAVAILABLE = 'product_unavailable';
	public const UNAVAILABLE         = 'unavailable';
	public const BUSY                = 'busy';
	public const NOT_FOUND           = 'not_found';
	public const STORAGE_FAILED      = 'storage_failed';
	public const BAD_REQUEST         = 'bad_request';
	public const LIMIT_REACHED       = 'limit_reached';

	private const STATUS = array(
		self::INVALID_PHOTO       => 422,
		self::PHOTO_EXPIRED       => 410,
		self::PRODUCT_UNAVAILABLE => 422,
		self::UNAVAILABLE         => 503,
		self::BUSY                => 409,
		self::NOT_FOUND           => 404,
		self::STORAGE_FAILED      => 500,
		self::BAD_REQUEST         => 400,
		self::LIMIT_REACHED       => 429,
	);

	/**
	 * One of the constants above.
	 *
	 * @var string
	 */
	private $error_code;

	/**
	 * Finer reason, e.g. an InvalidImage reason, or empty.
	 *
	 * @var string
	 */
	private $detail;

	/**
	 * Creates the error.
	 *
	 * @param string $code   One of the constants above.
	 * @param string $detail Finer reason, or empty.
	 */
	public function __construct( string $code, string $detail = '' ) {
		parent::__construct( 'Fitzaro API error: ' . $code );
		$this->error_code = isset( self::STATUS[ $code ] ) ? $code : self::BAD_REQUEST;
		$this->detail     = $detail;
	}

	/**
	 * Error code.
	 */
	public function code(): string {
		return $this->error_code;
	}

	/**
	 * Finer reason, or empty.
	 */
	public function detail(): string {
		return $this->detail;
	}

	/**
	 * HTTP status.
	 */
	public function status(): int {
		return self::STATUS[ $this->error_code ];
	}
}