<?php

declare(strict_types=1);

namespace WebCalendar\WP\Holiday;

defined( 'ABSPATH' ) || exit;

/**
 * Contract for holiday data providers.
 */
interface HolidayProviderInterface {

	public function get_id(): string;

	public function get_label(): string;

	/**
	 * @return array<string, string> Country code => country name.
	 */
	public function get_countries(): array;

	/**
	 * Fetch holidays for a country and year.
	 *
	 * @param string $country_code Country code.
	 * @param int    $year         Year to fetch.
	 * @return string ICS calendar data.
	 * @throws \RuntimeException On fetch failure.
	 */
	public function fetch_holidays( string $country_code, int $year ): string;
}