<?php
/**
 * Outcome of a Redis connection check.
 *
 * @package Akantio\Cache
 */

declare(strict_types=1);

namespace Akantio\Cache\Application\ObjectCache;

final class ProbeResult {

	/**
	 * @param bool                 $ok         Connected and responding.
	 * @param string               $message    Human-readable outcome, without secrets.
	 * @param float|null           $latency_ms Round trip.
	 * @param array<string, mixed> $info       Server information.
	 */
	private function __construct(
		public readonly bool $ok,
		public readonly string $message,
		public readonly ?float $latency_ms,
		public readonly array $info,
	) {
	}

	/**
	 * Successful check.
	 *
	 * @param float                $latency_ms Latency.
	 * @param array<string, mixed> $info       Info.
	 */
	public static function success( float $latency_ms, array $info ): self {
		return new self( true, 'Connected.', round( $latency_ms, 2 ), $info );
	}

	/**
	 * Failed check.
	 *
	 * @param string $message Reason.
	 */
	public static function failure( string $message ): self {
		return new self( false, $message, null, [] );
	}
}