<?php
/**
 * Exception for release input validation failures.
 *
 * @package DrPlugin\WP\ReleaseCart
 */

declare(strict_types=1);

namespace DrPlugin\WP\ReleaseCart\Updates;

// Prevent direct file access.
defined( 'ABSPATH' ) || exit;

/**
 * Raised when release data fails validation.
 *
 * @since 1.0.0
 */
final class ReleaseValidationException extends ReleaseException {

	/**
	 * The individual validation messages that caused the failure.
	 *
	 * @var array<int, string>
	 */
	private array $errors;

	/**
	 * Builds the exception with its error list.
	 *
	 * @since 1.0.0
	 *
	 * @param string             $message A human-readable summary.
	 * @param array<int, string> $errors  The individual field-level messages.
	 */
	public function __construct( string $message, array $errors = array() ) {
		parent::__construct( $message );
		$this->errors = $errors;
	}

	/**
	 * Builds the exception from an error list.
	 *
	 * @since 1.0.0
	 *
	 * @param array<int, string> $errors The individual field-level messages.
	 * @return self
	 */
	public static function withErrors( array $errors ): self {
		return new self( implode( ' ', $errors ), $errors );
	}

	/**
	 * The individual validation messages.
	 *
	 * @since 1.0.0
	 *
	 * @return array<int, string> The field-level error messages.
	 */
	public function getErrors(): array {
		return $this->errors;
	}
}