<?php
/**
 * Scheduling for premium cron events.
 *
 * @package AgentFirewall
 */

declare(strict_types=1);

namespace AgentFirewall\Support;

use Closure;
use Throwable;

defined( 'ABSPATH' ) || exit; // @codeCoverageIgnore

/**
 * Cron for code the free build does not have (AF-19.5).
 *
 * A scheduled event outlives the code that scheduled it, so downgrading to
 * the free build leaves a premium event in the cron table with its handler's
 * class stripped. Webcalendar-pro fataled on exactly that (d9e2a2e). Premium
 * events therefore exist only while their class does, and their handlers
 * cannot fatal the cron request.
 */
final class PremiumCron {

	/**
	 * Schedule an event while its class exists; clear it once the class is gone.
	 *
	 * @param string $hook       Cron hook (adaf_-prefixed).
	 * @param string $recurrence wp_get_schedules() key.
	 * @param string $class_name Class the handler needs.
	 */
	public static function sync( string $hook, string $recurrence, string $class_name ): void {
		if ( ! class_exists( $class_name ) ) {
			wp_clear_scheduled_hook( $hook );
			return;
		}

		if ( false === wp_next_scheduled( $hook ) ) {
			wp_schedule_event( time(), $recurrence, $hook );
		}
	}

	/**
	 * A handler that runs the task and reports, rather than throws, a failure.
	 *
	 * Arguments the event was scheduled with are passed through, so a
	 * single event can name what it is for.
	 *
	 * @param string           $hook Cron hook, named in the report.
	 * @param Closure          $task The work.
	 * @return Closure
	 */
	public static function guarded( string $hook, Closure $task ): Closure {
		return static function ( ...$args ) use ( $hook, $task ): void {
			try {
				$task( ...$args );
			} catch ( Throwable $e ) {
				wp_trigger_error(
					__METHOD__,
					sprintf( 'Premium cron task %s failed: %s', $hook, $e->getMessage() ),
					E_USER_WARNING
				);
			}
		};
	}
}