<?php
/**
 * The front end debug panel.
 *
 * @package WPAttributionTracker
 */

declare( strict_types=1 );

namespace WPAttributionTracker\Features;

use WPAttributionTracker\Channels;
use WPAttributionTracker\Ajax\DebugAccess;
use WPAttributionTracker\Settings;

defined( 'ABSPATH' ) || exit;

final class DebuggerFeature implements Feature {

	public const ID = 'debugger';

	public function id(): string {
		return self::ID;
	}

	public function label(): string {
		return __( 'Debug panel', 'ghizo-attribution-tracker' );
	}

	public function description(): string {
		return __( 'Lets an administrator inspect the stored attribution on the front end, opened from a button on the Status screen or with ?wpat_debug=1.', 'ghizo-attribution-tracker' );
	}

	public function is_available(): bool {
		return true;
	}

	public function register(): void {
		( new DebugAccess() )->register();

		add_filter( 'wpat_debug_config', array( $this, 'script_config' ) );
		add_filter( 'wpat_debug_allowed', array( $this, 'grant_access' ) );
	}

	/**
	 * Tell the capture script where to ask about access.
	 *
	 * @param array<string, mixed>|null $config Existing configuration.
	 * @return array<string, mixed>
	 */
	public function script_config( ?array $config ): array {
		return array(
			'endpoint' => DebugAccess::url(),
			'labels'   => Channels::labels(),
		);
	}

	/**
	 * Administrators always qualify. Everyone else only when the site opted in,
	 * which keeps the panel away from normal visitors by default.
	 *
	 * @param bool $allowed Whether access has already been granted.
	 */
	public function grant_access( bool $allowed ): bool {
		return $allowed || current_user_can( 'manage_options' ) || (bool) Settings::get( 'public_debug' );
	}
}