<?php
/**
 * Uninstall routine.
 *
 * @package ForensixDigital
 */

declare(strict_types=1);

namespace ForensixDigital\Core;

defined( 'ABSPATH' ) || exit;

use ForensixDigital\Services\Permissions\Capabilities;
use ForensixDigital\Services\Settings\Settings;

/**
 * Removes Forensix data when the plugin is deleted (section 8.5).
 *
 * By default, form entries and backups are kept and everything else is removed. When the user
 * enabled "Remove all Forensix data on uninstall" (core setting remove_all_data), everything goes.
 * Backups on external destinations are never touched.
 */
final class Uninstaller {

	/**
	 * Option prefixes kept unless the user chose to remove all data.
	 * Apps that own long-lived user data (forms, backups) store their options under these.
	 */
	public const KEEP_OPTION_PREFIXES = array(
		'forensix_settings_forms',
		'forensix_settings_backup',
	);

	/**
	 * Runs the uninstall.
	 */
	public static function run(): void {
		$core       = get_option( Settings::OPTION_PREFIX . 'core', array() );
		$remove_all = is_array( $core ) && ! empty( $core['remove_all_data'] );

		/**
		 * Fires before Forensix data is removed. Apps whose code is still present can clean up here.
		 *
		 * @param bool $remove_all Whether the user chose to remove all data.
		 */
		do_action( 'forensix_uninstall', $remove_all );

		Schema::drop();
		Capabilities::remove_all();
		self::delete_options( $remove_all );
		self::delete_transients();
	}

	/**
	 * Deletes forensix_ options, keeping long-lived user data unless $remove_all is true.
	 *
	 * @param bool $remove_all Remove everything.
	 */
	private static function delete_options( bool $remove_all ): void {
		global $wpdb;
		// phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching -- One-off uninstall lookup of our own options.
		$names = $wpdb->get_col(
			$wpdb->prepare( 'SELECT option_name FROM %i WHERE option_name LIKE %s', $wpdb->options, $wpdb->esc_like( 'forensix_' ) . '%' )
		);

		foreach ( $names as $name ) {
			if ( ! $remove_all && self::is_kept( (string) $name ) ) {
				continue;
			}
			delete_option( (string) $name );
		}
	}

	/**
	 * Deletes forensix_ transients.
	 */
	private static function delete_transients(): void {
		global $wpdb;
		// phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching -- One-off uninstall cleanup of our own transients.
		$wpdb->query(
			$wpdb->prepare(
				'DELETE FROM %i WHERE option_name LIKE %s OR option_name LIKE %s',
				$wpdb->options,
				$wpdb->esc_like( '_transient_forensix_' ) . '%',
				$wpdb->esc_like( '_transient_timeout_forensix_' ) . '%'
			)
		);
	}

	/**
	 * Whether an option holds data that is kept by default.
	 *
	 * @param string $name Option name.
	 */
	private static function is_kept( string $name ): bool {
		foreach ( self::KEEP_OPTION_PREFIXES as $prefix ) {
			if ( str_starts_with( $name, $prefix ) ) {
				return true;
			}
		}
		return false;
	}
}