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

namespace DataConnection.Interfaces;

/// <summary>
/// Interfaccia per provider di estrazione dello schema del database
/// </summary>
public interface IDatabaseSchemaProvider
{
    /// <summary>
    /// Estrae lo schema del database (tabelle e colonne)
    /// </summary>
    /// <param name="connectionString">Stringa di connessione al database</param>
    /// <returns>Struttura gerarchica delle tabelle e delle loro colonne</returns>
    Task<IDictionary<string, IEnumerable<DbColumnInfo>>> GetDatabaseSchemaAsync(string connectionString);
    
    /// <summary>
    /// Ottiene la lista dei database disponibili sul server
    /// </summary>
    /// <param name="connectionString">Stringa di connessione al server (senza specificare il database)</param>
    /// <returns>Lista dei nomi dei database disponibili</returns>
    Task<IEnumerable<string>> GetAvailableDatabasesAsync(string connectionString);
    
    /// <summary>
    /// Ottiene solo la lista dei nomi delle tabelle disponibili (senza dettagli delle colonne)
    /// </summary>
    /// <param name="connectionString">Stringa di connessione al database</param>
    /// <returns>Lista dei nomi delle tabelle</returns>
    Task<IEnumerable<string>> GetTableNamesAsync(string connectionString);
    
    /// <summary>
    /// Ottiene i dettagli delle colonne per una specifica tabella
    /// </summary>
    /// <param name="connectionString">Stringa di connessione al database</param>
    /// <param name="tableName">Nome della tabella (con schema se necessario)</param>
    /// <returns>Lista delle informazioni sulle colonne</returns>
    Task<IEnumerable<DbColumnInfo>> GetTableSchemaAsync(string connectionString, string tableName);
}