<?php

declare(strict_types=1);

namespace LinkCheckup\Features\Scanning;

use WP_Error;

/** @phpstan-import-type StatusSummary from StatusReport */
final class ScanEndpoint {

	private const INVALID_PARAMETER_CODE = 'rest_invalid_param';
	private const BAD_REQUEST_STATUS     = 400;

	public function __construct(
		private ScanControl $scan_control,
		private StatusReport $status_report
	) {
	}

	/** @return StatusSummary|WP_Error */
	public function handle( mixed $requested_action ): array|WP_Error {
		$action = is_string( $requested_action )
			? ScanAction::tryFrom( $requested_action )
			: null;

		if ( null === $action ) {
			return new WP_Error(
				self::INVALID_PARAMETER_CODE,
				__(
					'Choose a scan action: start, pause, resume or cancel.',
					'aiplaz-link-checkup'
				),
				array( 'status' => self::BAD_REQUEST_STATUS )
			);
		}

		$this->scan_control->apply( $action );

		return $this->status_report->build();
	}
}