<?php
/**
 * CRON Scheduler for Accessibility Audio TTS.
 * Handles scheduling and unscheduling of WordPress CRON events.
 *
 * @package Accessibility_Audio_TTS
 */

namespace Accessibility_Audio_TTS\Cron\Schedulers;

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

/**
 * Manages scheduling of WordPress CRON events.
 */
class Cron_Scheduler {

	/**
	 * Schedule a CRON event.
	 *
	 * @param string $hook     The hook name.
	 * @param string $interval The interval (hourly, daily, etc.).
	 * @param array  $args     Optional arguments to pass to the hook.
	 * @return bool True on success, false on failure.
	 */
	public function schedule_event( string $hook, string $interval, array $args = array() ): bool {
		if ( wp_next_scheduled( $hook, $args ) ) {
			accessibility_audio_tts_debug_log( "Event {$hook} is already scheduled" );
			return true;
		}

		$scheduled = wp_schedule_event( time(), $interval, $hook, $args );

		if ( false === $scheduled ) {
			accessibility_audio_tts_debug_log( "Failed to schedule event: {$hook}" );
			return false;
		}

		accessibility_audio_tts_debug_log( "Successfully scheduled event: {$hook} with interval: {$interval}" );
		return true;
	}

	/**
	 * Schedule a single CRON event.
	 *
	 * @param string $hook      The hook name.
	 * @param int    $timestamp When to run the event.
	 * @param array  $args      Optional arguments to pass to the hook.
	 * @return bool True on success, false on failure.
	 */
	public function schedule_single_event( string $hook, int $timestamp, array $args = array() ): bool {
		if ( wp_next_scheduled( $hook, $args ) ) {
			accessibility_audio_tts_debug_log( "Single event {$hook} is already scheduled" );
			return true;
		}

		$scheduled = wp_schedule_single_event( $timestamp, $hook, $args );

		if ( false === $scheduled ) {
			accessibility_audio_tts_debug_log( "Failed to schedule single event: {$hook}" );
			return false;
		}

		accessibility_audio_tts_debug_log( "Successfully scheduled single event: {$hook} for timestamp: {$timestamp}" );
		return true;
	}

	/**
	 * Unschedule a CRON event.
	 *
	 * @param string $hook The hook name.
	 * @param array  $args Optional arguments that were passed to the hook.
	 * @return bool True on success, false on failure.
	 */
	public function unschedule_event( string $hook, array $args = array() ): bool {
		$timestamp = wp_next_scheduled( $hook, $args );

		if ( ! $timestamp ) {
			accessibility_audio_tts_debug_log( "Event {$hook} is not scheduled" );
			return true;
		}

		$unscheduled = wp_unschedule_event( $timestamp, $hook, $args );

		if ( false === $unscheduled ) {
			accessibility_audio_tts_debug_log( "Failed to unschedule event: {$hook}" );
			return false;
		}

		accessibility_audio_tts_debug_log( "Successfully unscheduled event: {$hook}" );
		return true;
	}

	/**
	 * Clear all scheduled instances of a hook.
	 *
	 * @param string $hook The hook name.
	 * @return bool True on success, false on failure.
	 */
	public function clear_scheduled_hook( string $hook ): bool {
		$cleared = wp_clear_scheduled_hook( $hook );

		if ( false === $cleared ) {
			accessibility_audio_tts_debug_log( "Failed to clear scheduled hook: {$hook}" );
			return false;
		}

		accessibility_audio_tts_debug_log( "Successfully cleared all instances of hook: {$hook}" );
		return true;
	}

	/**
	 * Get the next scheduled time for a hook.
	 *
	 * @param string $hook The hook name.
	 * @param array  $args Optional arguments that were passed to the hook.
	 * @return int|false The timestamp of the next scheduled event, or false if not scheduled.
	 */
	public function get_next_scheduled( string $hook, array $args = array() ) {
		return wp_next_scheduled( $hook, $args );
	}

	/**
	 * Check if a hook is scheduled.
	 *
	 * @param string $hook The hook name.
	 * @param array  $args Optional arguments that were passed to the hook.
	 * @return bool True if scheduled, false otherwise.
	 */
	public function is_scheduled( string $hook, array $args = array() ): bool {
		return (bool) wp_next_scheduled( $hook, $args );
	}

	/**
	 * Add custom CRON intervals.
	 *
	 * @param array $schedules Existing schedules.
	 * @return array Modified schedules.
	 */
	public function add_custom_intervals( array $schedules ): array {
		// Static intervals for system tasks.
		$schedules['five_minutes'] = array(
			'interval' => 300, // 5 minutes in seconds.
			'display'  => __( 'Every 5 minutes', 'accessibility-audio-tts-text-to-speech-for-articles' ),
		);

		$schedules['fifteen_minutes'] = array(
			'interval' => 900, // 15 minutes in seconds.
			'display'  => __( 'Every 15 minutes', 'accessibility-audio-tts-text-to-speech-for-articles' ),
		);

		// Dynamic interval based on user performance settings.
		$processing_interval = get_option( 'accessibility_audio_tts_processing_interval', 10 );
		$interval_seconds    = $processing_interval * 60;

		$schedules['accessibility_audio_tts_custom_interval'] = array(
			'interval' => $interval_seconds,
			/* translators: %d: number of minutes */
			'display'  => sprintf( __( 'Every %1$d minutes (user settings)', 'accessibility-audio-tts-text-to-speech-for-articles' ), $processing_interval ),
		);

		accessibility_audio_tts_debug_log( "Added custom CRON interval: {$processing_interval} minutes ({$interval_seconds} seconds)" );

		return $schedules;
	}

	/**
	 * Schedule all plugin CRON events.
	 *
	 * @return array Results of scheduling attempts.
	 */
	public function schedule_all_events(): array {
		$results = array();

		$events = array(
			'accessibility_audio_tts_process_queue'    => 'accessibility_audio_tts_custom_interval',
			'accessibility_audio_tts_security_cleanup' => 'daily',
		);

		foreach ( $events as $hook => $interval ) {
			$results[ $hook ] = $this->schedule_event( $hook, $interval );
		}

		return $results;
	}

	/**
	 * Unschedule all plugin CRON events.
	 *
	 * @return array Results of unscheduling attempts.
	 */
	public function unschedule_all_events(): array {
		$results = array();

		$hooks = array(
			'accessibility_audio_tts_process_queue',
			'accessibility_audio_tts_process_background_posts',
			'accessibility_audio_tts_auto_trigger_cron',
			'accessibility_audio_tts_security_cleanup',
		);

		foreach ( $hooks as $hook ) {
			$results[ $hook ] = $this->clear_scheduled_hook( $hook );
		}

		return $results;
	}
}