<?php
/**
 * Outbound transport contract.
 *
 * @package AdPix\Analytics
 */

declare( strict_types = 1 );

namespace AdPix\Analytics\Contracts;

use AdPix\Analytics\Http\Response;

defined( 'ABSPATH' ) || exit;

/**
 * Sends one payload to an AdPix server-to-server endpoint.
 *
 * Kept behind an interface so the queue worker, the connection test and the unit suite all talk to
 * the same seam — the tests substitute a recording double instead of standing up a collector.
 */
interface TransportInterface {

	/**
	 * POST a payload to /api/v1/s2s/{endpoint}.
	 *
	 * Implementations never throw: a transport failure is a Response with status 0, so one caller
	 * can branch on one thing.
	 *
	 * @param string              $endpoint Endpoint suffix, e.g. `events`, `identify`, `verify`.
	 * @param array<string,mixed> $payload  JSON-serialisable body.
	 * @return Response
	 */
	public function send( string $endpoint, array $payload ): Response;
}