using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace Tango.FSE.BL.Connectivity
{
    /// <summary>
    /// Represents an Internet connection validation provider.
    /// </summary>
    public interface IConnectivityProvider
    {
        /// <summary>
        /// Gets or sets the connectivity verification method.
        /// </summary>
        ConnectivityVerificationMethod VerificationMethod { get; set; }

        /// <summary>
        /// Gets a value indicating whether the system has an active Internet connection currently.
        /// </summary>
        bool IsOnline { get; }

        /// <summary>
        /// Checks whether the system has an active Internet connection.
        /// </summary>
        /// <returns></returns>
        bool CheckOnline();

        /// <summary>
        /// Checks whether the system has an active Internet connection.
        /// </summary>
        /// <returns></returns>
        Task<bool> CheckOnlineAsync();

        /// <summary>
        /// Throws an exception if there is no Internet connection.
        /// </summary>
        void ThrowIfNoInternet();
    }
}