<?php
/**
 * Cron Event Manager.
 *
 * Handles cron event management.
 *
 * @package Accessibility_Audio_TTS\Handlers
 */

namespace Accessibility_Audio_TTS\Handlers;

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

/**
 * Single Responsibility: managing cron events (scheduling, cleanup, monitoring).
 */
class Cron_Event_Manager {

    /**
     * Schedule a test cron event.
     *
     * @param int $delay_seconds Delay in seconds from now.
     * @return bool|\WP_Error Result of scheduling.
     */
	public function schedule_test_event( $delay_seconds = 60 ) {
		$test_hook      = 'accessibility_audio_tts_cron_test_' . time();
		$scheduled_time = time() + $delay_seconds;

		$result = wp_schedule_single_event( $scheduled_time, $test_hook );

        if ( false !== $result ) {
			accessibility_audio_tts_debug_log( "Cron Event Manager: Test event scheduled for {$delay_seconds} seconds" );
		} else {
			accessibility_audio_tts_debug_log( 'Cron Event Manager: Failed to schedule test event' );
		}

		return $result;
	}

    /**
     * Clean up test events (remove old test events).
     *
     * @return int Number of cleaned up events.
     */
	public function cleanup_old_test_events() {
		$cron_array    = $this->get_cron_array();
		$cleaned_count = 0;

		foreach ( $cron_array as $timestamp => $jobs ) {
			foreach ( $jobs as $hook => $instances ) {
                // Clean up old test events (older than 1 hour).
                if ( 0 === strpos( $hook, 'accessibility_audio_tts_cron_test_' ) && ( $timestamp < ( time() - 3600 ) ) ) {
					foreach ( $instances as $instance ) {
                        wp_unschedule_event( $timestamp, $hook, isset( $instance['args'] ) ? $instance['args'] : array() );
						++$cleaned_count;
					}
				}
			}
		}

        if ( $cleaned_count > 0 ) {
			accessibility_audio_tts_debug_log( "Cron Event Manager: Cleaned up {$cleaned_count} old test events" );
		}

		return $cleaned_count;
	}

    /**
     * Get all scheduled events for a specific hook.
     *
     * @param string $hook Hook name.
     * @return array Array of scheduled events.
     */
	public function get_scheduled_events_for_hook( $hook ) {
		$events     = array();
		$cron_array = $this->get_cron_array();

		foreach ( $cron_array as $timestamp => $jobs ) {
			if ( isset( $jobs[ $hook ] ) ) {
				foreach ( $jobs[ $hook ] as $instance ) {
                    $events[] = array(
						'timestamp'      => $timestamp,
						'formatted_time' => gmdate( 'Y-m-d H:i:s', $timestamp ),
                        'args'           => isset( $instance['args'] ) ? $instance['args'] : array(),
                        'interval'       => isset( $instance['interval'] ) ? $instance['interval'] : null,
                        'schedule'       => isset( $instance['schedule'] ) ? $instance['schedule'] : null,
					);
				}
			}
		}

		return $events;
	}


    /**
     * Get cron array safely.
     *
     * @return array Cron array or empty array on failure.
     */
	private function get_cron_array() {
		$cron_array = array();

		if ( function_exists( '_get_cron_array' ) ) {
			$cron_array = _get_cron_array();
			if ( ! is_array( $cron_array ) ) {
				$cron_array = array();
			}
		}

		return $cron_array;
	}

    /**
     * Check if a specific hook is scheduled.
     *
     * @param string $hook Hook name.
     * @return bool True if hook is scheduled.
     */
	public function is_hook_scheduled( $hook ) {
        return false !== wp_next_scheduled( $hook );
	}
}