<?php

declare(strict_types=1);

namespace VPlugins\WPCloudClient\Handler;

interface HandlerInterface {

	/**
	 * Unique action name this handler responds to.
	 *
	 * @return string Action name.
	 */
	public function action(): string;

	/**
	 * Execute the action with the given parameters.
	 *
	 * @param array<string, mixed> $params Action parameters.
	 * @return array<string, mixed> Action result data.
	 *
	 * @throws \RuntimeException On failure.
	 */
	public function execute( array $params ): array;
}