<?php
/**
 * @package PlugixaCrm
 */

declare( strict_types = 1 );

namespace PlugixaCrm\Core\Http;

use PlugixaCrm\Core\Database\Repository;
use WP_Error;
use WP_REST_Request;

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

/**
 * Tells an API client which value was too long, instead of "could not be saved".
 *
 * {@see Repository} refuses a value that does not fit its column and records why. The service that asked
 * only sees `0` or `false`, as it always has, and answers with its own 500 — there are dozens of those,
 * one per service, and none of them can know the reason. This swaps that 500 for the recorded 422 on its
 * way out of the REST server, so every entity gets the precise answer without each service being taught it.
 *
 * Only a 500 is replaced. A service that answered a refused write with something more specific of its
 * own is left alone, and the refusal is cleared before every request so one request's cannot surface
 * in another's response.
 */
final class RefusedWrite {

	public function register_hooks(): void {
		add_filter( 'rest_request_before_callbacks', array( $this, 'forget' ) );
		add_filter( 'rest_request_after_callbacks', array( $this, 'explain' ), 10, 3 );
	}

	/**
	 * Start every request with no refusal pending.
	 *
	 * @param mixed $response What the dispatcher has so far — returned untouched.
	 */
	public function forget( mixed $response ): mixed {
		Repository::take_refusal();

		return $response;
	}

	/**
	 * @param mixed           $response The callback's result.
	 * @param array           $handler  The route handler.
	 * @param WP_REST_Request $request  The request.
	 *
	 * @return mixed
	 */
	public function explain( mixed $response, array $handler, WP_REST_Request $request ): mixed {
		unset( $handler, $request );

		$refusal = Repository::take_refusal();

		if ( null === $refusal || ! $response instanceof WP_Error ) {
			return $response;
		}

		$data = $response->get_error_data();

		return is_array( $data ) && 500 === (int) ( $data['status'] ?? 0 ) ? $refusal : $response;
	}
}