littleshop/LittleShop/Services/IBotDiscoveryService.cs

using LittleShop.DTOs;

namespace LittleShop.Services;

/// <summary>
/// Service for discovering and configuring remote TeleBot instances
/// </summary>
public interface IBotDiscoveryService
{
    /// <summary>
    /// Probe a remote TeleBot instance to discover its status
    /// </summary>
    Task<DiscoveryResult> ProbeRemoteBotAsync(string ipAddress, int port);

    /// <summary>
    /// Initialize a remote TeleBot instance with a BotKey
    /// </summary>
    Task<InitializeResult> InitializeRemoteBotAsync(Guid botId, string ipAddress, int port);

    /// <summary>
    /// Push configuration (bot token and settings) to a remote TeleBot instance
    /// </summary>
    Task<ConfigureResult> PushConfigurationAsync(Guid botId, string botToken, Dictionary<string, object>? settings = null);

    /// <summary>
    /// Test basic connectivity to a remote address
    /// </summary>
    Task<bool> TestConnectivityAsync(string ipAddress, int port);

    /// <summary>
    /// Get the status of a remote TeleBot instance
    /// </summary>
    Task<DiscoveryProbeResponse?> GetRemoteStatusAsync(string ipAddress, int port, string botKey);

    /// <summary>
    /// Control a remote TeleBot instance (start/stop/restart)
    /// </summary>
    /// <param name="botId">The bot ID in LittleShop</param>
    /// <param name="action">Action to perform: "start", "stop", or "restart"</param>
    Task<BotControlResult> ControlBotAsync(Guid botId, string action);
}