namespace Tnsu.ApprovalRoute.Infrastructure.TnsuPortal;

/// <summary>
/// Подписывает список данных SharePoint на уведомления об изменениях через портал.
/// </summary>
public interface ISharePointWebhookSubscriber
{
    /// <summary>
    /// Подписать список. НЕ бросает: подписка — следствие создания списка, а не его
    /// условие (см. реализацию), поэтому сбой портала не должен рушить провижининг
    /// партиции. Возвращает true, только если портал подтвердил подписку.
    /// </summary>
    /// <param name="siteUrl">Абсолютный адрес сайта, где создан список.</param>
    /// <param name="listTitle">Заголовок списка данных — русское имя, как в SharePoint.</param>
    Task<bool> TrySubscribeAsync(string siteUrl, string listTitle, CancellationToken cancellationToken);
}