<?php
/**
 * A single check result.
 *
 * @package Keepwatch
 */

namespace Keepwatch\Checks;

defined( 'ABSPATH' ) || exit;

/**
 * Immutable value object. Status values mirror WordPress Site Health (good / recommended / critical).
 */
final class Result {

	public const GOOD        = 'good';
	public const RECOMMENDED = 'recommended';
	public const CRITICAL    = 'critical';

	/**
	 * Stable identifier, e.g. "updates.plugins".
	 *
	 * @var string
	 */
	public $id;

	/**
	 * One of the status constants.
	 *
	 * @var string
	 */
	public $status;

	/**
	 * Short, translated headline.
	 *
	 * @var string
	 */
	public $label;

	/**
	 * Translated explanation (plain text).
	 *
	 * @var string
	 */
	public $description;

	/**
	 * Optional admin URL that helps fix the issue.
	 *
	 * @var string
	 */
	public $action_url;

	/**
	 * Optional translated label for the action link.
	 *
	 * @var string
	 */
	public $action_label;

	/**
	 * Constructor.
	 *
	 * @param string $id           Identifier.
	 * @param string $status       Status constant.
	 * @param string $label        Headline.
	 * @param string $description  Explanation.
	 * @param string $action_url   Fix link (optional).
	 * @param string $action_label Fix link text (optional).
	 */
	public function __construct( string $id, string $status, string $label, string $description = '', string $action_url = '', string $action_label = '' ) {
		$this->id           = $id;
		$this->status       = $status;
		$this->label        = $label;
		$this->description  = $description;
		$this->action_url   = $action_url;
		$this->action_label = $action_label;
	}

	/**
	 * Sort weight: critical first.
	 */
	public function weight(): int {
		if ( self::CRITICAL === $this->status ) {
			return 0;
		}
		return self::RECOMMENDED === $this->status ? 1 : 2;
	}
}