<?php
/**
 * A normalized result from an Api_Client call - the only shape the rest of
 * the plugin (Sync_Service, admin UI) ever inspects, so nobody downstream
 * has to know whether a failure was a transport error, a timeout, or a
 * parsed 404 Emails error body.
 *
 * @package Emails404
 */

namespace Emails404;

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

class Api_Response {

	/** @var bool */
	public $success;

	/** @var int|null HTTP status code, null if the request never reached the server (DNS/timeout/TLS failure). */
	public $status;

	/** @var array|null Decoded JSON body on success. */
	public $data;

	/**
	 * A small, stable, safe category - never a raw exception message or
	 * response body. One of: "timeout", "unreachable", "unauthorized",
	 * "forbidden_scope", "rate_limited", "server_error", "invalid_request",
	 * "not_found", "unexpected".
	 *
	 * @var string
	 */
	public $error_category;

	/** @var bool Whether Part M's retry policy considers this safe to retry (timeout / 429 / temporary 5xx only). */
	public $retryable;

	public function __construct( $success, $status, $data, $error_category = '', $retryable = false ) {
		$this->success        = (bool) $success;
		$this->status         = $status;
		$this->data           = $data;
		$this->error_category = $error_category;
		$this->retryable      = (bool) $retryable;
	}

	public static function success( $status, $data ) {
		return new self( true, $status, $data, '', false );
	}

	public static function failure( $status, $error_category, $retryable ) {
		return new self( false, $status, null, $error_category, $retryable );
	}
}