using DataConnection.REST.Models;
using System.Collections.Generic;
using System.Threading;
using System.Threading.Tasks;

namespace DataConnection.REST.Interfaces
{
    /// <summary>
    /// Interface for discovering metadata (entities, properties) from a REST service.
    /// </summary>
    public interface IRestMetadataDiscovery
    {
        /// <summary>
        /// Discovers entities and their properties from the REST service metadata.
        /// </summary>
        /// <param name="cancellationToken">Cancellation token.</param>
        /// <returns>A list of discovered entity information.</returns>
        Task<List<RestEntityInfo>> DiscoverEntitiesAsync(CancellationToken cancellationToken = default);
    }
}