using System.Threading;
using System.Threading.Tasks;

namespace MediaBrowser.Controller.ScheduledTasks;

/// <summary>
/// Provides a distributed leader lease that gates periodic, library-mutating scheduled tasks
/// to a single instance across a multi-pod deployment.
/// </summary>
public interface IScanLeaderLease
{
    /// <summary>
    /// Attempts to acquire the scan-leader lease, or renews it when this instance already holds it.
    /// </summary>
    /// <param name="cancellationToken">A cancellation token.</param>
    /// <returns>
    /// <c>true</c> if this instance holds the leader lease and gated periodic tasks may run here;
    /// otherwise <c>false</c>.
    /// </returns>
    Task<bool> TryAcquireOrRenewAsync(CancellationToken cancellationToken = default);
}