<?php
namespace Actirise\Includes\Push\Handler;

if ( ! defined( 'ABSPATH' ) ) {
	exit; // Exit if accessed directly
}

use Actirise\Includes\Cron;
use Actirise\Includes\Push\PushEndpointHandlerInterface;
use ActirisePublic\Includes\AdsTxt;

/**
 * Applies `wordpress.adstxt_monitoring.completed` (contract §5.2).
 *
 * The `data` payload is the final validation verdict — `{state, missing[],
 * blacklistLines[]}` — where `state` is `ok` or `error` (the API never pushes
 * `pending`). The apply reuses the same writers as the polling fallback so both
 * paths persist identical state: `AdsTxt::store_validation_counts()` records the
 * `adstxt-missing-count` / `adstxt-blacklist-count` read by the admin health
 * badge, and `Cron::finalize_adstxt_check()` derives the `adstxt-update` flag
 * from the verdict. Because push delivers the final verdict directly, the
 * plugin-side "pending -> result" follow-up poll is disabled while push is
 * active (see {@see Cron::check_adstxt()}).
 *
 * @link       https://actirise.com
 * @since      4.3.0
 * @package    actirise
 * @subpackage actirise/includes/push/handler
 * @author     actirise <wordpress@actirise.com>
 */
final class AdstxtMonitoringPushHandler implements PushEndpointHandlerInterface {
	/**
	 * {@inheritDoc}
	 *
	 * @since 4.3.0
	 * @return string
	 */
	public function endpoint() {
		return 'adstxt-monitoring';
	}

	/**
	 * {@inheritDoc}
	 *
	 * @since 4.3.0
	 * @return string
	 */
	public function event_type() {
		return 'wordpress.adstxt_monitoring.completed'; // phpcs:ignore WordPress.WP.CapitalPDangit.MisspelledInText -- Actirise API event-type identifier.
	}

	/**
	 * {@inheritDoc}
	 *
	 * @since 4.3.0
	 * @return int[]
	 */
	public function supported_versions() {
		return array( 1 );
	}

	/**
	 * Apply an ads.txt validation verdict.
	 *
	 * The payload must be an object carrying a final `state` (`ok` or `error`);
	 * a missing, `pending` or unknown state is treated as a schema error and
	 * rejected with a 400 by the controller. The counts and the update flag are
	 * derived by the shared writers reused by the polling fallback.
	 *
	 * @since 4.3.0
	 * @param mixed $data The validation verdict `{state, missing[], blacklistLines[]}`.
	 * @return bool True when the verdict was applied.
	 */
	public function apply( $data ) {
		if ( ! is_array( $data ) || ! isset( $data['state'] ) ) {
			return false;
		}

		if ( 'ok' !== $data['state'] && 'error' !== $data['state'] ) {
			return false;
		}

		AdsTxt::store_validation_counts( $data );
		Cron::finalize_adstxt_check( $data );

		return true;
	}
}