<?php
/**
 * Event store contract.
 *
 * @package ZeroSpamForms
 */

namespace TwoOTwoCode\ZeroSpamForms\Logging;

defined( 'ABSPATH' ) || exit;

/**
 * Stores privacy-safe event metadata.
 */
interface EventStoreInterface {
	/**
	 * Add an event and apply retention bounds.
	 *
	 * @param SpamEvent $event          Event.
	 * @param int       $retention_days Retention days.
	 * @param int       $max_records    Max records.
	 */
	public function add_event( SpamEvent $event, int $retention_days, int $max_records ): bool;

	/**
	 * Get stored events.
	 *
	 * @return array<int, SpamEvent>
	 */
	public function get_events(): array;

	/**
	 * Count stored events.
	 */
	public function count_events(): int;
}