<?php
/**
 * Failure talking to a source site.
 *
 * @package AccessNow\Replica
 */

namespace AccessNow\Replica\Client;

defined( 'ABSPATH' ) || exit;

/**
 * Remote error. Retryable errors (timeouts, 5xx, busy) are retried by the job runner with
 * back-off; the others need the admin's attention.
 */
class Remote_Exception extends \RuntimeException {

	/**
	 * Whether retrying later may succeed.
	 *
	 * @var bool
	 */
	public $retryable;

	/**
	 * Machine code.
	 *
	 * @var string
	 */
	public $error_code;

	/**
	 * Suggested wait in seconds.
	 *
	 * @var int
	 */
	public $wait;

	/**
	 * Creates the error.
	 *
	 * @param string $code      Code.
	 * @param string $message   Plain-language message with the fix.
	 * @param bool   $retryable Retryable.
	 * @param int    $wait      Suggested wait.
	 */
	public function __construct( $code, $message, $retryable = false, $wait = 0 ) {
		parent::__construct( $message );
		$this->error_code = $code;
		$this->retryable  = (bool) $retryable;
		$this->wait       = (int) $wait;
	}
}