<?php
/**
 * The marketplace answered with an HTTP error.
 *
 * @package Tidelist
 */

namespace Tidelist\Channel\Exception;

/**
 * The marketplace answered with an HTTP error.
 */
final class ApiException extends ChannelException {

	/**
	 * HTTP status.
	 *
	 * @var int
	 */
	private $status;

	/**
	 * Field validation errors: list of [field, title].
	 *
	 * @var array
	 */
	private $validation;

	/**
	 * Constructor.
	 *
	 * @param int    $status     HTTP status.
	 * @param string $message    Message.
	 * @param array  $validation Validation errors.
	 */
	public function __construct( int $status, string $message, array $validation = array() ) {
		parent::__construct( $message, $status );
		$this->status     = $status;
		$this->validation = $validation;
	}

	/**
	 * Builds the exception from a marketplace error body.
	 *
	 * Marketplaces use shapes such as: {"error":{"status","title","detail","validation":[...]}} for API errors
	 * and {"error":"invalid_grant","error_description":"..."} for OAuth errors.
	 *
	 * @param int        $status HTTP status.
	 * @param array|null $data   Decoded body.
	 */
	public static function from_response( int $status, ?array $data ): self {
		$message    = 'HTTP ' . $status;
		$validation = array();
		$error      = $data['error'] ?? null;
		if ( is_array( $error ) ) {
			$parts   = array_filter( array( $error['title'] ?? '', $error['detail'] ?? '' ) );
			$message = $parts ? implode( ': ', array_unique( $parts ) ) : $message;
			foreach ( (array) ( $error['validation'] ?? array() ) as $item ) {
				$validation[] = array(
					'field' => (string) ( $item['field'] ?? '' ),
					'title' => (string) ( $item['title'] ?? ( $item['detail'] ?? '' ) ),
				);
			}
		} elseif ( is_string( $error ) ) {
			$message = $error . ( isset( $data['error_description'] ) ? ': ' . $data['error_description'] : '' );
		}
		return new self( $status, $message, $validation );
	}

	/**
	 * HTTP status.
	 */
	public function status(): int {
		return $this->status;
	}

	/**
	 * Validation errors.
	 */
	public function validation(): array {
		return $this->validation;
	}
}