<?php
/**
 * Plugin Initializer for Accessibility Audio TTS
 *
 * Coordinates plugin initialization using specialized initializers for
 * core, admin, and frontend components. Implements SOLID principles
 * with dependency injection and lazy loading.
 *
 * @package Accessibility_Audio_TTS
 * @subpackage Core
 * @since 2.0.0
 * @author App4You.dev
 */

namespace Accessibility_Audio_TTS;

use Accessibility_Audio_TTS\Core\Bootstrap\Core_Initializer;
if ( ! defined( 'ABSPATH' ) ) {
	exit; }

use Accessibility_Audio_TTS\Core\Bootstrap\Admin_Initializer;
use Accessibility_Audio_TTS\Core\Bootstrap\Frontend_Initializer;
/**
 * Main plugin initialization coordinator
 *
 * Delegates initialization to specialized initializers while maintaining
 * backward compatibility. Uses dependency injection and lazy loading
 * for optimal performance and maintainability.
 *
 * @since 2.0.0
 */
class Plugin_Initializer {

	/**
	 * Initialize essential plugin components
	 *
	 * Called on WordPress 'init' action to load core functionality needed
	 * across both admin and frontend. Delegates to Core_Initializer.
	 *
	 * @since 2.0.0
	 * @throws \Exception If critical initialization fails.
	 * @return void.
	 */
	public static function init_essential() {
		try {
			accessibility_audio_tts_debug_log( __( 'Essential plugin initialization started', 'accessibility-audio-tts-text-to-speech-for-articles' ) );

			Plugin_Utils::load_textdomain();

			// Initialize core components using new architecture.
			Core_Initializer::init();

			// Initialize text correction features.
			\Accessibility_Audio_TTS\API\Text_Correction_Initializer::init();

			// Initialize admin components if in admin area (needed for menu registration).
			if ( is_admin() ) {
				Admin_Initializer::init();
			}

			accessibility_audio_tts_debug_log( __( 'Essential plugin initialization completed successfully', 'accessibility-audio-tts-text-to-speech-for-articles' ) );

		} catch ( \Exception $e ) {
			self::handle_initialization_error( $e );
		}
	}

	/**
	 * Initialize admin-specific components
	 *
	 * Called on WordPress 'admin_init' action for additional admin-only functionality.
	 * Main admin components are already initialized in init_essential().
	 *
	 * @since 2.0.0
	 * @throws \Exception If admin initialization fails.
	 * @return void.
	 */
	public static function init_admin() {
		try {
			accessibility_audio_tts_debug_log( __( 'Admin late initialization started', 'accessibility-audio-tts-text-to-speech-for-articles' ) );

			// Additional admin initialization that needs to happen after admin_init.
			// Most admin components are already initialized in init_essential().

			accessibility_audio_tts_debug_log( __( 'Admin late initialization completed successfully', 'accessibility-audio-tts-text-to-speech-for-articles' ) );

		} catch ( \Exception $e ) {
			self::handle_initialization_error( $e );
		}
	}

	/**
	 * Initialize frontend-specific components
	 *
	 * Called on WordPress 'wp' action to load frontend-only functionality.
	 * Delegates to Frontend_Initializer for specialized handling.
	 *
	 * @since 2.0.0
	 * @throws \Exception If frontend initialization fails.
	 * @return void.
	 */
	public static function init_frontend() {
		try {
			// Initialize frontend components using new architecture.
			Frontend_Initializer::init();
		} catch ( \Exception $e ) {
			self::handle_initialization_error( $e );
		}
	}

	/**
	 * Get core component instance
	 *
	 * Provides access to core components through dependency injection.
	 *
	 * @since 2.0.0
	 * @param string $component Component name.
	 * @return object Component instance.
	 */
	public static function get_core_component( string $component ): object {
		return Core_Initializer::get_instance( $component );
	}

	/**
	 * Get admin component instance
	 *
	 * Provides access to admin components through lazy loading.
	 *
	 * @since 2.0.0
	 * @param string $component Component name.
	 * @return object Component instance.
	 */
	public static function get_admin_component( string $component ): object {
		return Admin_Initializer::get_component( $component );
	}

	/**
	 * Get frontend component instance
	 *
	 * Provides access to frontend components through lazy loading.
	 *
	 * @since 2.0.0
	 * @param string $component Component name.
	 * @return object Component instance.
	 */
	public static function get_frontend_component( string $component ): object {
		return Frontend_Initializer::get_component( $component );
	}

	/**
	 * Handle initialization errors
	 *
	 * Provides centralized error handling for initialization failures.
	 * Logs errors and displays admin notices to inform administrators.
	 *
	 * @since 2.0.0
	 * @param \Exception $e The exception that occurred during initialization.
	 * @return void.
	 */
	private static function handle_initialization_error( \Exception $e ) {
		/* translators: %s: error message */
		accessibility_audio_tts_error_log( sprintf( __( 'CRITICAL ERROR in plugin initialization: %s', 'accessibility-audio-tts-text-to-speech-for-articles' ), $e->getMessage() ) );
		/* translators: %s: stack trace */
		accessibility_audio_tts_error_log( sprintf( __( 'Stack trace: %s', 'accessibility-audio-tts-text-to-speech-for-articles' ), $e->getTraceAsString() ) );

		add_action(
			'admin_notices',
			function () use ( $e ) {
				?>
			<div class="notice notice-error">
				<?php /* translators: %s: error message */ ?>
				<p><?php printf( esc_html__( 'Accessibility Audio TTS Error: %s', 'accessibility-audio-tts-text-to-speech-for-articles' ), esc_html( $e->getMessage() ) ); ?></p>
			</div>
				<?php
			}
		);
	}

	/**
	 * Get initialization statistics
	 *
	 * Returns statistics from all initializers for debugging and monitoring.
	 *
	 * @since 2.0.0
	 * @return array Combined statistics.
	 */
	public static function get_initialization_stats(): array {
		return array(
			'core'     => Core_Initializer::get_container_stats(),
			'admin'    => Admin_Initializer::get_admin_stats(),
			'frontend' => Frontend_Initializer::get_frontend_stats(),
		);
	}

	/**
	 * Handle plugin activation
	 *
	 * Performs necessary setup tasks when the plugin is activated,
	 * including CRON system initialization and rewrite rule flushing.
	 *
	 * @since 1.0.0
	 * @return void.
	 */
	public static function on_activation() {
		accessibility_audio_tts_debug_log( __( 'Plugin activated - Initializing systems', 'accessibility-audio-tts-text-to-speech-for-articles' ) );

		// Ensure autoloader is registered before using namespaced classes during activation.
		if ( class_exists( '\\Accessibility_Audio_TTS\\Plugin_Utils' ) ) {
			\Accessibility_Audio_TTS\Plugin_Utils::register_autoloader();
		}

		// Preload critical CRON classes to avoid activation-time autoload ordering issues.
		if ( defined( 'ACCESSIBILITY_AUDIO_TTS_PLUGIN_DIR' ) ) {
			$maybe_require = function ( string $relative ) {
				$path = ACCESSIBILITY_AUDIO_TTS_PLUGIN_DIR . $relative;
				if ( file_exists( $path ) ) {
					require_once $path;
				}
			};
			$maybe_require( 'infrastructure/cron/cron-executor.php' );
			$maybe_require( 'infrastructure/cron/cron-scheduler.php' );
			$maybe_require( 'infrastructure/cron/cron-monitor.php' );
			$maybe_require( 'infrastructure/cron/cron-job-registry.php' );
		}

		// Initialize CRON system on activation.
		CRON_Manager::init_cron_on_activation();

		// Flush rewrite rules if needed.
		flush_rewrite_rules();

		accessibility_audio_tts_debug_log( __( 'Plugin activation completed', 'accessibility-audio-tts-text-to-speech-for-articles' ) );
	}

	/**
	 * Handle plugin deactivation
	 *
	 * Performs necessary cleanup tasks when the plugin is deactivated,
	 * including CRON cleanup, license system cleanup, and rewrite rule flushing.
	 *
	 * @since 1.0.0
	 * @return void.
	 */
	public static function on_deactivation() {
		accessibility_audio_tts_debug_log( __( 'Plugin deactivated - Cleaning up systems', 'accessibility-audio-tts-text-to-speech-for-articles' ) );

		// Clear all scheduled CRON jobs.
		CRON_Manager::cleanup_cron_on_deactivation();

		// Flush rewrite rules.
		flush_rewrite_rules();

		accessibility_audio_tts_debug_log( __( 'Plugin deactivation completed', 'accessibility-audio-tts-text-to-speech-for-articles' ) );
	}
}