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

declare( strict_types = 1 );

namespace AdPix\Analytics\Contracts;

defined( 'ABSPATH' ) || exit;

/**
 * Somewhere to record why a delivery did not happen.
 *
 * Deliberately narrow: the plugin has exactly two things worth saying — a delivery failed, and here
 * is detail a developer asked to see. A full PSR-3 level ladder would be eight methods that nothing
 * calls.
 */
interface LoggerInterface {

	/**
	 * Record a failure the site owner may need to act on.
	 *
	 * @param string              $message Human-readable summary.
	 * @param array<string,mixed> $context Structured detail.
	 * @return void
	 */
	public function error( string $message, array $context = array() ): void;

	/**
	 * Record detail that is only useful while debugging.
	 *
	 * @param string              $message Human-readable summary.
	 * @param array<string,mixed> $context Structured detail.
	 * @return void
	 */
	public function debug( string $message, array $context = array() ): void;
}