<?php
/**
 * Settings registration for the AI plugin.
 *
 * @package WordPress\AI
 *
 * @since 0.1.0
 */

declare(strict_types=1);

namespace WordPress\AI\Settings;

use WordPress\AI\Features\Registry;
use WordPress\AI\REST\Models_Controller;
use WordPress\AI\REST\Settings_IO_Controller;

/**
 * Handles registration of settings for the AI plugin.
 *
 * @since 0.1.0
 */
class Settings_Registration {

	/**
	 * The experiment registry instance.
	 *
	 * @since 0.1.0
	 *
	 * @var \WordPress\AI\Features\Registry
	 */
	private Registry $registry;

	/**
	 * The option group name for settings registration.
	 *
	 * @since 0.1.0
	 *
	 * @var string
	 */
	public const OPTION_GROUP = 'ai_experiments';

	/**
	 * The option name for the former global experiments toggle.
	 *
	 * The setting is no longer registered; features are controlled solely by
	 * their individual toggles. Kept only so third-party references don't fatal.
	 *
	 * @since 0.1.0
	 * @deprecated 1.4.0 Features are enabled individually; there is no global toggle.
	 *
	 * @var string
	 */
	public const GLOBAL_OPTION = 'wpai_features_enabled';

	/**
	 * Constructor.
	 *
	 * @since 0.1.0
	 *
	 * @param \WordPress\AI\Features\Registry $registry The feature registry.
	 */
	public function __construct( Registry $registry ) {
		$this->registry = $registry;
	}

	/**
	 * Initializes the settings registration hooks.
	 *
	 * @since 0.1.0
	 *
	 * @return void
	 */
	public function init(): void {
		$this->register_settings();

		// Initialize the provider/model discovery REST endpoint.
		( new Models_Controller() )->init();

		// Initialize the settings import/export REST endpoints.
		( new Settings_IO_Controller() )->init();

		// Extend the HTTP timeout while core revalidates provider keys on save,
		// then restore the default so it does not leak into later requests.
		add_filter( 'rest_post_dispatch', array( $this, 'maybe_extend_revalidation_timeout' ), 9, 3 );
		add_filter( 'rest_post_dispatch', array( $this, 'restore_default_timeout' ), 11 );
	}

	/**
	 * Registers a longer HTTP timeout during a `/wp/v2/settings` write.
	 *
	 * Core revalidates every stored provider key on each settings write using
	 * WordPress's 5-second HTTP default, which can time out on a slow provider
	 * and overwrite the stored key with ''.
	 *
	 * @since 1.4.0
	 *
	 * @param mixed $response The REST response (passed through).
	 * @param mixed $server   The REST server instance.
	 * @param mixed $request  The REST request.
	 * @return mixed The unchanged response.
	 */
	public function maybe_extend_revalidation_timeout( $response, $server, $request ) {
		if ( $request instanceof \WP_REST_Request
			&& '/wp/v2/settings' === $request->get_route()
			&& in_array( $request->get_method(), array( 'POST', 'PUT' ), true )
		) {
			add_filter( 'http_request_timeout', array( $this, 'extend_revalidation_timeout' ) ); // phpcs:ignore WordPressVIPMinimum.Hooks.RestrictedHooks.http_request_timeout
		}

		return $response;
	}

	/**
	 * Returns a longer HTTP timeout, never lowering an existing one.
	 *
	 * @since 1.4.0
	 *
	 * @param mixed $timeout The current timeout in seconds.
	 * @return float The timeout to use, in seconds.
	 */
	public function extend_revalidation_timeout( $timeout ): float {
		return (float) max( (float) $timeout, 30 );
	}

	/**
	 * Removes the extended HTTP timeout after the settings dispatch has run.
	 *
	 * Runs at a later priority than core's key revalidation so the timeout only
	 * applies to that dispatch and does not leak into other outbound requests in
	 * the same PHP process.
	 *
	 * @since 1.4.0
	 *
	 * @param mixed $response The REST response (passed through).
	 * @return mixed The unchanged response.
	 */
	public function restore_default_timeout( $response ) {
		remove_filter( 'http_request_timeout', array( $this, 'extend_revalidation_timeout' ) );

		return $response;
	}

	/**
	 * Registers all settings.
	 *
	 * @since 0.1.0
	 *
	 * @return void
	 */
	public function register_settings(): void {
		// Register settings for each experiment.
		foreach ( $this->registry->get_all_features() as $feature ) {
			$feature_id = $feature::get_id();

			register_setting(
				self::OPTION_GROUP,
				"wpai_feature_{$feature_id}_enabled",
				array(
					'type'              => 'boolean',
					'default'           => false,
					'sanitize_callback' => 'rest_sanitize_boolean',
					'show_in_rest'      => true,
				)
			);

			register_setting(
				self::OPTION_GROUP,
				"wpai_feature_{$feature_id}_field_developer",
				array(
					'type'         => 'object',
					'default'      => array(),
					'show_in_rest' => array(
						'schema' => array(
							'type'       => 'object',
							'properties' => array(
								'provider' => array(
									'type'    => 'string',
									'default' => '',
								),
								'model'    => array(
									'type'    => 'string',
									'default' => '',
								),
							),
						),
					),
				)
			);

			// Allow experiments to register their own custom settings.
			if ( ! method_exists( $feature, 'register_settings' ) ) {
				continue;
			}

			$feature->register_settings();
		}
	}
}