<?php
/**
 * Outbound HTTP for automation integrations (docs/20 §5).
 *
 * @package Bookline
 */

declare( strict_types=1 );

namespace Bookline\Application\Automation;

use Bookline\Domain\Shared\DomainException;

/**
 * Transport used by `fire_webhook`. Implementations live in Infrastructure.
 *
 * @since 0.1.0
 */
interface AutomationHttpClient {

	/**
	 * Send one request.
	 *
	 * @param string                $method  HTTP method.
	 * @param string                $url     Absolute URL.
	 * @param array<string, string> $headers Headers.
	 * @param string                $body    Body.
	 * @param int                   $timeout Timeout seconds.
	 * @return array{status: int, body: string}
	 *
	 * @throws DomainException On transport failure.
	 */
	public function send( string $method, string $url, array $headers, string $body, int $timeout ): array;
}