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

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

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

/**
 * Reference push handler: applies `wordpress.adstxt.updated` (contract §5.1).
 *
 * The `data` payload is a single string carrying the full ads.txt content. The
 * apply reuses the shared `AdsTxt::apply_pushed_content()` so the push and cron
 * paths behave identically: store the content, rewrite the local `/ads.txt`
 * file when serving is active, and record the update timestamp.
 *
 * @link       https://actirise.com
 * @since      4.3.0
 * @package    actirise
 * @subpackage actirise/includes/push/handler
 * @author     actirise <wordpress@actirise.com>
 */
final class AdstxtPushHandler implements PushEndpointHandlerInterface {
	/**
	 * {@inheritDoc}
	 *
	 * @since 4.3.0
	 * @return string
	 */
	public function endpoint() {
		return 'adstxt';
	}

	/**
	 * {@inheritDoc}
	 *
	 * @since 4.3.0
	 * @return string
	 */
	public function event_type() {
		return 'wordpress.adstxt.updated'; // 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 update.
	 *
	 * The payload must be a non-empty string; anything else is treated as a
	 * schema error and rejected with a 400 by the controller.
	 *
	 * @since 4.3.0
	 * @param mixed $data The full ads.txt content.
	 * @return bool True when the content was applied.
	 */
	public function apply( $data ) {
		if ( ! is_string( $data ) || '' === trim( $data ) ) {
			return false;
		}

		AdsTxt::apply_pushed_content( $data );

		return true;
	}
}