<?php
/**
 * Central AJAX dispatcher.
 *
 * @package Postlinkly
 * @since   1.0.0
 */

declare(strict_types=1);

namespace Postlinkly\Admin;

use Postlinkly\Admin\Ajax\AjaxHandler;
use Postlinkly\Hooks\ServiceProvider;

/**
 * Central AJAX dispatcher.
 *
 * Registers one `wp_ajax_postlinkly_*` action per handler and routes
 * incoming requests to the correct handler. All handlers follow the
 * same pattern: nonce → capability → sanitise → run → respond.
 *
 * Every AJAX action is prefixed `postlinkly_` without exception.
 * `wp_ajax_postlinkly_get_suggestions` is correct.
 * `wp_ajax_get_suggestions` is not.
 *
 * @since 1.0.0
 */
final class AjaxRouter implements ServiceProvider {

	/**
	 * @var array<int, AjaxHandler>
	 */
	private array $handlers;

	/**
	 * @since 1.0.0
	 *
	 * @param array<int, AjaxHandler> $handlers All AJAX handlers.
	 */
	public function __construct( array $handlers ) {
		$this->handlers = array_values(
			array_filter( $handlers, static fn( $h ) => $h instanceof AjaxHandler )
		);
	}

	/**
	 * Registers Plugin service hooks.
	 *
	 * @since 1.0.0
	 *
	 * @return array<int, array<int, mixed>>
	 */
	public function get_hooks(): array {
		$hooks = array();
		foreach ( $this->handlers as $handler ) {
			$action  = 'wp_ajax_postlinkly_' . $handler->get_action();
			$hooks[] = array( $action, array( $handler, 'handle' ) );
		}
		return $hooks;
	}
}