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

/**
 * Premium Feature Helper Class
 *
 * Handles premium feature detection and development overrides.
 * is_premium_enabled() is a pure, side-effect-free check. All enforcement
 * actions (settings resets, IP privacy guard) are triggered via WordPress
 * hooks registered in init().
 *
 * @since      1.0.0
 */

// Ensure the plugin.php file is included for is_plugin_active() function
if ( ! function_exists( 'is_plugin_active' ) ) {
	require_once ABSPATH . 'wp-admin/includes/plugin.php';
}

class ACTLOGPRO_Premium_Helper {

	/** @var bool|null Cached premium status — null means not yet evaluated this request. */
	private static $premium_enabled_cache = null;

	/**
	 * Register WordPress hooks and run lightweight startup enforcement.
	 *
	 * Call once after the class is loaded (e.g. from actlogpro_initialize_activity_log_pro()).
	 *
	 * @since    1.0.0
	 */
	public static function init() {
		// Refresh cache and enforce settings when premium plugin is activated or deactivated
		add_action( 'deactivated_plugin', array( __CLASS__, 'on_plugin_deactivated' ) );
		add_action( 'activated_plugin',   array( __CLASS__, 'on_plugin_activated' ) );

		// Enforce privacy-safe IP once at startup (WP object-cache makes get_option() cheap)
		self::ensure_privacy_safe_ip_setting();

		// Downgrade check runs in admin only — catches FTP/manual premium deactivation
		if ( is_admin() ) {
			self::maybe_reset_premium_settings_on_downgrade();
		}
	}

	/**
	 * Fires when any plugin is deactivated — handles premium plugin removal.
	 *
	 * @since    1.0.0
	 * @param    string $plugin  Plugin basename being deactivated.
	 */
	public static function on_plugin_deactivated( $plugin ) {
		if ( 'activity-log-pro-premium/activity-log-pro-premium.php' === $plugin ) {
			self::invalidate_cache();
			self::maybe_reset_premium_settings_on_downgrade();
			self::ensure_privacy_safe_ip_setting();
		}
	}

	/**
	 * Fires when any plugin is activated — handles premium plugin installation.
	 *
	 * @since    1.0.0
	 * @param    string $plugin  Plugin basename being activated.
	 */
	public static function on_plugin_activated( $plugin ) {
		if ( 'activity-log-pro-premium/activity-log-pro-premium.php' === $plugin ) {
			self::invalidate_cache();
			self::maybe_reset_premium_settings_on_upgrade();
		}
	}

	/**
	 * Invalidate the cached premium status so the next call re-evaluates.
	 *
	 * @since    1.0.0
	 */
	public static function invalidate_cache() {
		self::$premium_enabled_cache = null;
	}

	/**
	 * Check if premium features are enabled.
	 *
	 * Pure read-only check — no side effects. Result is cached for the duration
	 * of the request to avoid repeated DB/plugin-list queries.
	 *
	 * @since    1.0.0
	 * @return   bool    True if premium features should be enabled.
	 */
	public static function is_premium_enabled() {

		// Development Constants 002

		if ( null !== self::$premium_enabled_cache ) {
			return self::$premium_enabled_cache;
		}

		// Check if premium extension is registered and active
		if ( class_exists( 'ACTLOGPRO_Extension_Interface' ) ) {
			$premium_extension_active = ACTLOGPRO_Extension_Interface::is_extension_registered( 'activity-log-pro-premium' );

			if ( $premium_extension_active ) {
				$license_valid                = get_option( 'actlogpro_premium_license_valid', '0' ) === '1';
				self::$premium_enabled_cache  = $license_valid;
				return self::$premium_enabled_cache;
			}
		}

		// Legacy check for premium plugin activation
		if ( function_exists( 'is_plugin_active' ) && is_plugin_active( 'activity-log-pro-premium/activity-log-pro-premium.php' ) ) {
			$license_valid               = get_option( 'actlogpro_premium_license_valid', '0' ) === '1';
			self::$premium_enabled_cache = $license_valid;
			return self::$premium_enabled_cache;
		}

		self::$premium_enabled_cache = false;
		return self::$premium_enabled_cache;
	}

	/**
	 * Check if premium plugin is properly licensed.
	 *
	 * This method is deprecated in the free plugin. License validation
	 * is now handled entirely by the premium plugin.
	 *
	 * @since    1.0.0
	 * @return   bool    Always returns false in free plugin.
	 */
	public static function is_premium_licensed() {
		// License validation is handled by premium plugin only
		return false;
	}

	/**
	 * Check if premium UI should be shown.
	 *
	 * @since    1.0.0
	 * @return   bool    True if premium UI should be displayed.
	 */
	public static function show_premium_ui() {
		// Development Constants 003

		return ! self::is_premium_enabled();
	}

	/**
	 * Get the upgrade URL for premium features.
	 *
	 * @since    1.0.0
	 * @return   string  The upgrade URL.
	 */
	public static function get_upgrade_url() {
		return admin_url( 'admin.php?page=activity-log-pro-upgrade' );
	}

	/**
	 * Check if a specific feature is available.
	 *
	 * @since    1.0.0
	 * @param    string  $feature_key  The feature identifier.
	 * @return   bool    True if the feature is available.
	 */
	public static function is_feature_available( $feature_key ) {
		// Check if feature is registered via extension interface
		if ( class_exists( 'ACTLOGPRO_Extension_Interface' ) ) {
			if ( ACTLOGPRO_Extension_Interface::is_premium_feature_available( $feature_key ) ) {
				return true;
			}
		}

		// For legacy compatibility, check general premium status
		return self::is_premium_enabled();
	}

	/**
	 * Reset premium settings to their default values when switching from premium to free.
	 *
	 * @since    1.0.0
	 */
	public static function reset_premium_settings_to_defaults() {
		$premium_settings = array(
			'actlogpro_store_full_ip'    => '0', // Default: privacy-safe (hide last IP octet)
			'actlogpro_enable_json_feed' => '0', // Default: JSON feed disabled
			// Note: RSS feed is NOT a premium feature, so it is not reset here
		);

		foreach ( $premium_settings as $setting => $default_value ) {
			update_option( $setting, $default_value );
		}

		// Clear feed tokens when disabling JSON feed (RSS tokens are not premium)
		delete_option( 'actlogpro_json_feed_token' );
		delete_option( 'actlogpro_feed_token_updated' );

		// Persist notice flag so admin sees a dismissible downgrade notice
		update_option( 'actlogpro_premium_settings_reset_notice', true );

		if ( class_exists( 'ACTLOGPRO_Logger' ) ) {
			ACTLOGPRO_Logger::log_activity_minimal(
				'system',
				'settings',
				0,
				'Premium Settings Reset',
				'premium_settings_reset',
				'Premium features have been disabled and settings reset to defaults'
			);
		}
	}

	/**
	 * Reset premium settings if we were previously premium but are no longer.
	 *
	 * @since    1.0.0
	 */
	private static function maybe_reset_premium_settings_on_downgrade() {
		$was_premium = get_option( 'actlogpro_was_premium_enabled', false );
		$is_premium  = self::is_premium_enabled();

		if ( $was_premium && ! $is_premium ) {
			self::reset_premium_settings_to_defaults();
			update_option( 'actlogpro_was_premium_enabled', false );
		}
	}

	/**
	 * Track premium state when activating the premium plugin.
	 *
	 * @since    1.0.0
	 */
	private static function maybe_reset_premium_settings_on_upgrade() {
		$was_premium = get_option( 'actlogpro_was_premium_enabled', false );
		$is_premium  = self::is_premium_enabled();

		if ( ! $was_premium && $is_premium ) {
			update_option( 'actlogpro_was_premium_enabled', true );
		}
	}

	/**
	 * Ensure the full-IP storage setting is reset to privacy-safe default when premium is inactive.
	 *
	 * @since    1.0.0
	 */
	private static function ensure_privacy_safe_ip_setting() {
		$current_setting = get_option( 'actlogpro_store_full_ip', '0' );

		// Only act if full-IP storage is enabled but premium is no longer active
		if ( '1' === $current_setting && ! self::is_premium_enabled() ) {
			update_option( 'actlogpro_store_full_ip', '0' );

			if ( class_exists( 'ACTLOGPRO_Logger' ) ) {
				ACTLOGPRO_Logger::log_activity_minimal(
					'system',
					'settings',
					0,
					'IP Privacy Setting',
					'auto_privacy_reset',
					'IP address setting automatically reset to privacy-safe default due to premium deactivation'
				);
			}
		}
	}
}