using FrameworkDAL.DTO.EIPConversation;
using GB5Shared.DTO.Framework.Login;
using System.Threading;
using System.Threading.Tasks;

namespace FrameworkBLL.EIPConversation.EIPHandlers.ChannelHandler
{
    /// <summary>
    /// Generic interface for all platform/channel handlers.
    /// Each handler implements this and specifies which channel/platform it supports.
    /// </summary>
    public interface IEIPChannelHandler
    {
        string ChannelName { get; }

        /// <summary>
        /// Determines if this handler can handle the given channel/platform.
        /// Example values: "SMS", "Teams", "Telegram", "Slack", "Postman", "WhatsApp".
        /// </summary>
        /// <param name="channel">The platform/channel type</param>
        /// <returns>True if this handler can send messages to the channel</returns>
        bool CanHandle(string channel);

        /// <summary>
        /// Sends a response/message to the target channel/platform.
        /// All platform-specific handlers implement this method.
        /// </summary>
        /// <param name="context">The response context containing message, recipient, buttons, etc.</param>
        /// <param name="loginDTO">Login information for tenant/user</param>
        /// <param name="cancellationToken">Cancellation token for async operation</param>
        /// <returns>Response object indicating success/failure of sending</returns>
        Task<EIPChannelResponseDTO> SendAsync(
            EIPResponseContext context,
            LoginDTO loginDTO,
            CancellationToken cancellationToken);
    }
}