<?php
/**
 * Installation, activation and native TurtleReport updates.
 *
 * @package TurtleReport
 */

namespace TurtleReport;

use TurtleReport\Access\ViewerRole;
use TurtleReport\Cron\Jobs;
use TurtleReport\Delivery\Schema;

defined( 'ABSPATH' ) || exit;

/**
 * Creates the viewer role, schedules background jobs and records the installed version.
 *
 * Setup also runs lazily on admin_init, so network activation on Multisite
 * prepares each subsite the first time someone opens its admin, without
 * looping over every site during activation.
 */
final class Installer {

	const VERSION_OPTION = 'turtlereport_version';

	/**
	 * Activation hook.
	 *
	 * @return void
	 */
	public static function activate() {
		self::install( true );
	}

	/**
	 * Initializes a newly created subsite when the plugin is network-active.
	 *
	 * @param \WP_Site $site Initialized site.
	 * @return void
	 */
	public static function initialize_site( \WP_Site $site ) {
		$active = get_site_option( 'active_sitewide_plugins', array() );
		if ( ! is_array( $active ) || ! isset( $active[ plugin_basename( TURTLEREPORT_FILE ) ] ) ) {
			return;
		}
		switch_to_blog( (int) $site->blog_id );
		try {
			self::install( true );
		} finally {
			restore_current_blog();
		}
	}

	/**
	 * Deactivation hook: stops background jobs, on every subsite when network-deactivated.
	 *
	 * @param bool $network_wide Whether the plugin is being network-deactivated.
	 * @return void
	 */
	public static function deactivate( $network_wide = false ) {
		if ( $network_wide && is_multisite() ) {
			foreach ( get_sites(
				array(
					'fields' => 'ids',
					'number' => 0,
				)
			) as $blog_id ) {
				switch_to_blog( $blog_id );
				self::stop_jobs();
				restore_current_blog();
			}
			return;
		}
		self::stop_jobs();
	}

	/**
	 * Clears this site's cron events. Per-site email events are booked again by
	 * the hourly sweep after reactivation.
	 *
	 * @return void
	 */
	private static function stop_jobs() {
		Jobs::unschedule();
		wp_unschedule_hook( \TurtleReport\Email\Dispatcher::SITE_HOOK );
	}

	/**
	 * Initializes new sites and applies idempotent setup after a native update.
	 *
	 * @return void
	 */
	public static function maybe_install() {
		if ( TURTLEREPORT_VERSION !== get_option( self::VERSION_OPTION, false ) ) {
			self::install( false );
			return;
		}
		self::ensure_schema();
		Jobs::schedule();
	}

	/**
	 * Ensures the delivery history tables are initialized.
	 *
	 * Called from background jobs too, so a subsite that nobody has opened
	 * yet still gets its tables before it sends anything.
	 *
	 * @return bool Whether the tables are ready.
	 */
	public static function ensure_schema() {
		return Schema::ensure();
	}

	/**
	 * Idempotent setup for the current site. Background jobs are scheduled even
	 * when table setup fails: health checks and alerts don't need the tables, and
	 * delivery reports the database problem instead of silently stopping.
	 *
	 * @param bool $force Repair now, ignoring the back-off after a failed attempt.
	 * @return void
	 */
	private static function install( $force ) {
		ViewerRole::ensure();
		Jobs::schedule();
		if ( ! ( $force ? Schema::install() : Schema::ensure() ) ) {
			return;
		}
		update_option( self::VERSION_OPTION, TURTLEREPORT_VERSION, false );
	}
}