<?php
/**
 * Lets sibling AI-O plugins reach the Connector Hub through this plugin.
 *
 * Optimiser is installed on essentially every client site; Content Pal on a
 * subset of those. So Content Pal can rely on Optimiser being present and does
 * not need its own Hub client — which matters, because a second signed-request
 * implementation is how the Local GBP client ended up on weaker transport than
 * the original (see class-ai-o-optimiser-connector-client.php).
 *
 * Exposed as a filter rather than a public class call on purpose. This plugin's
 * classes were renamed once already (ACT_* to AI_O_Optimiser_*), which would
 * have broken any caller holding the class name; a hook survives that. It is
 * also how these two plugins already talk.
 *
 * Callers get back exactly what the Hub returned — array on success, WP_Error
 * otherwise, including when this bridge declines the route.
 *
 *     $result = apply_filters(
 *         'ai_o_optimiser_hub_request',
 *         new WP_Error( 'ai_o_optimiser_hub_unavailable', 'Optimiser is not active.' ),
 *         '/search-console/query',
 *         array( 'property' => $property, 'start_date' => $start, 'end_date' => $end )
 *     );
 *
 * Passing a WP_Error as the default means a caller that runs without Optimiser
 * present gets a clean failure rather than a fatal or a silent empty result.
 *
 * @package AI_O_Optimiser
 */

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

final class AI_O_Optimiser_Hub_Bridge {

	/**
	 * Hub routes a sibling plugin may reach through this bridge.
	 *
	 * Read-only reporting only. Deliberately excludes /register and /disconnect
	 * (they change this site's Hub identity, which belongs to Optimiser's own
	 * settings screens) and /business-profile/* (Optimiser's Local workspace
	 * owns that evidence). Widen this list when a sibling has a stated need,
	 * not in advance.
	 */
	const ALLOWED_ROUTES = array(
		'/status',
		'/properties',
		'/search-console/query',
	);

	/** Register the boundary. Cheap: no client loaded until a call arrives. */
	public static function boot() {
		add_filter( 'ai_o_optimiser_hub_request', array( __CLASS__, 'handle' ), 10, 3 );
	}

	/**
	 * Answer a sibling plugin's Hub request.
	 *
	 * @param mixed  $default Value to return if this bridge does not answer.
	 * @param string $route   Hub route below /aio-connector/v1.
	 * @param array  $payload Request body.
	 * @return array|WP_Error
	 */
	public static function handle( $default, $route = '', $payload = array() ) {
		$route = (string) $route;

		if ( ! in_array( $route, self::ALLOWED_ROUTES, true ) ) {
			return new WP_Error(
				'ai_o_optimiser_hub_route_not_allowed',
				sprintf(
					/* translators: %s: requested Connector Hub route. */
					__( 'The Connector Hub route %s is not available to other plugins through AI-O Optimiser.', 'ai-o-optimiser' ),
					$route
				)
			);
		}

		if ( ! class_exists( 'AI_O_Optimiser_Connector_Client' ) ) {
			if ( function_exists( 'ai_o_optimiser_guidance_load_connector_client' ) ) {
				ai_o_optimiser_guidance_load_connector_client();
			}
		}

		if ( ! class_exists( 'AI_O_Optimiser_Connector_Client' ) ) {
			return new WP_Error(
				'ai_o_optimiser_hub_client_missing',
				__( 'The AI-O Connector Hub client could not be loaded.', 'ai-o-optimiser' )
			);
		}

		unset( $default );

		return AI_O_Optimiser_Connector_Client::hub_request(
			$route,
			is_array( $payload ) ? $payload : array()
		);
	}
}