<?php
/**
 * Service registration.
 *
 * @package FormPilot
 * @since   1.0.0
 */

declare( strict_types = 1 );

namespace FormPilot\Core;

/*
 * Before the imports rather than after them, as elsewhere: there are enough of
 * them to push the guard past the top of the file, where tools look for it.
 */
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

use FormPilot\Admin\Admin;
use FormPilot\Admin\Menu;
use FormPilot\Admin\Pages\EntriesPage;
use FormPilot\Admin\Pages\FormEditPage;
use FormPilot\Admin\Pages\FormsPage;
use FormPilot\Admin\Pages\SettingsPage;
use FormPilot\Admin\Pages\ToolsPage;
use FormPilot\Database\Migrator;
use FormPilot\Database\Repositories\FieldRepository;
use FormPilot\Database\Repositories\FormRepository;
use FormPilot\Database\Repositories\SubmissionRepository;
use FormPilot\Exports\ExportManager;
use FormPilot\Fields\Duplicator;
use FormPilot\Fields\FieldSanitizer;
use FormPilot\Frontend\FormRenderer;
use FormPilot\Frontend\Frontend;
use FormPilot\Frontend\SubmissionHandler;
use FormPilot\Integrations\IntegrationRegistry;
use FormPilot\Integrations\Integrations;
use FormPilot\Logging\Logger;
use FormPilot\Logging\LogStore;
use FormPilot\Logging\LogSubscriber;
use FormPilot\MultiStep\ProgressStore;
use FormPilot\MultiStep\StepHandler;
use FormPilot\MultiStep\StepResolver;
use FormPilot\Notifications\CronQueue;
use FormPilot\Notifications\ImmediateQueue;
use FormPilot\Notifications\Mailer;
use FormPilot\Notifications\NotificationBuilder;
use FormPilot\Notifications\Notifier;
use FormPilot\Rest\Authentication;
use FormPilot\Rest\EntriesController;
use FormPilot\Rest\FormsController;
use FormPilot\Rest\RestServer;
use FormPilot\Rest\SubmissionController;
use FormPilot\Security\SpamGuard;
use FormPilot\Services\FormMetadata;
use FormPilot\Services\SavedFilters;
use FormPilot\Services\SubmissionMessages;
use FormPilot\Settings\SettingsRegistry;
use FormPilot\Settings\SettingsTransfer;
use FormPilot\Submissions\SubmissionProcessor;
use FormPilot\Submissions\Validator;
use FormPilot\Submissions\ValueFormatter;
use FormPilot\Submissions\ValueSanitizer;
use FormPilot\Uploads\OrphanCleaner;
use FormPilot\Uploads\UploadManager;
use FormPilot\Validation\Rules\CallbackRule;
use FormPilot\Validation\ValidationEngine;
use FormPilot\Webhooks\DeliveryLog;
use FormPilot\Webhooks\WebhookPayload;
use FormPilot\Webhooks\WebhookRegistry;
use FormPilot\Webhooks\Webhooks;
use FormPilot\Webhooks\WebhookSender;
use wpdb;

/**
 * The plugin's wiring, in one place.
 *
 * The container autowires anything it can reach by reading a constructor, so
 * registration is not a list of factories: it is a list of the classes that must
 * be *shared* rather than rebuilt per injection, plus the one binding reflection
 * cannot work out on its own.
 *
 * @since 1.0.0
 */
final class Services {

	/**
	 * Classes that resolve to one shared instance per request.
	 *
	 * Sharing is not a default: it is a decision, and each of these has a
	 * reason. Repositories and lookups hold per request caches worth reusing;
	 * admin pages are registered twice (as a screen and as its `load` handler)
	 * and must be the same object both times; the validation engine has to see
	 * the callbacks registered against it.
	 */
	private const SHARED = array(
		// Core.
		Assets::class,
		SpamGuard::class,
		SettingsRegistry::class,

		// Logging, registered early so a later failure has somewhere to go.
		LogStore::class,
		Logger::class,
		LogSubscriber::class,

		// Database.
		Migrator::class,
		FormRepository::class,
		FieldRepository::class,
		SubmissionRepository::class,
		FormMetadata::class,

		// Submissions.
		Duplicator::class,
		OrphanCleaner::class,
		ValueSanitizer::class,
		ValueFormatter::class,
		FieldSanitizer::class,
		UploadManager::class,
		CallbackRule::class,
		ValidationEngine::class,
		Validator::class,
		SubmissionProcessor::class,
		SubmissionMessages::class,
		ExportManager::class,

		// Notifications and webhooks.
		Mailer::class,
		NotificationBuilder::class,
		ImmediateQueue::class,
		CronQueue::class,
		Notifier::class,
		DeliveryLog::class,
		WebhookRegistry::class,
		WebhookPayload::class,
		WebhookSender::class,
		Webhooks::class,

		// Integrations.
		IntegrationRegistry::class,
		Integrations::class,

		// Admin.
		SavedFilters::class,
		FormsPage::class,
		FormEditPage::class,
		EntriesPage::class,
		SettingsPage::class,
		ToolsPage::class,
		Menu::class,
		Admin::class,
		SettingsTransfer::class,

		// Frontend.
		StepResolver::class,
		ProgressStore::class,
		FormRenderer::class,
		Frontend::class,
		SubmissionHandler::class,
		StepHandler::class,

		// REST.
		FormsController::class,
		EntriesController::class,
		SubmissionController::class,
		Authentication::class,
		RestServer::class,
	);

	/**
	 * Registers every service with the container.
	 *
	 * @param Container $container Container to register with.
	 */
	public static function register( Container $container ): void {
		/*
		 * The repositories type hint wpdb, and wpdb cannot be autowired: its
		 * constructor wants credentials. Handing the container the live
		 * connection is what makes every repository resolvable.
		 */
		$container->instance( wpdb::class, $GLOBALS['wpdb'] );

		foreach ( self::SHARED as $class_name ) {
			$container->singleton( $class_name );
		}
	}

	/**
	 * Returns the modules that attach callbacks to WordPress, in load order.
	 *
	 * Logging comes early, so a module that fails to start is itself something
	 * the log can carry; REST authentication comes before the routes, so a bearer
	 * token is resolved before any permission callback asks who the caller is.
	 *
	 * There is no translations module. WordPress has loaded a plugin's language
	 * pack on first use since 4.6, and the plugin ships only a .pot, so calling
	 * load_plugin_textdomain() here loaded nothing.
	 *
	 * @return array<int, class-string> Class names implementing Hookable.
	 */
	public static function modules(): array {
		return array(
			SettingsRegistry::class,
			Assets::class,
			LogSubscriber::class,
			Migrator::class,
			Duplicator::class,
			OrphanCleaner::class,
			Notifier::class,
			Webhooks::class,
			Integrations::class,
			Admin::class,
			SettingsTransfer::class,
			Frontend::class,
			SubmissionHandler::class,
			StepHandler::class,
			Authentication::class,
			RestServer::class,
		);
	}
}