<?php
/**
 * Flips the detailed-logging switch on the Settings screen.
 *
 * @package Shiftora\Logging
 */

declare(strict_types=1);

namespace Shiftora\Logging;

use WP_Error;

// Prevent direct file access.
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * Turns migration diagnostics on and off behind a capability and a nonce.
 * toggle() reports a refusal as a WP_Error and leaves the response to the caller.
 */
final class DebugToggle {

	/** Nonce action, also printed by the form in the Settings template. */
	public const NONCE_ACTION = 'shiftora_debug_toggle';

	/**
	 * Flips the switch.
	 *
	 * @param array<string, mixed> $request Submitted fields, i.e. $_POST.
	 * @return bool|WP_Error True when flipped, otherwise why not.
	 */
	public function toggle( array $request ): bool|WP_Error {
		if ( ! current_user_can( 'manage_options' ) ) {
			return new WP_Error(
				'shiftora_debug_forbidden',
				__( 'You do not have permission to change this setting.', 'shiftora' )
			);
		}

		if ( ! wp_verify_nonce( sanitize_text_field( wp_unslash( (string) ( $request['_wpnonce'] ?? '' ) ) ), self::NONCE_ACTION ) ) {
			return new WP_Error(
				'shiftora_debug_forbidden',
				__( 'This request could not be verified. Please reload the page and try again.', 'shiftora' ),
				[ 'status' => 403 ]
			);
		}

		$next = ! ShiftoraDebug::enabled();

		// Stored as '0' rather than deleted so the option is always visibly set.
		update_option( ShiftoraDebug::OPTION, $next ? '1' : '0' );
		ShiftoraDebug::flush();

		return true;
	}
}