using SharepointToolbox.Web.Core.Models;

namespace SharepointToolbox.Web.Services;

/// <summary>
/// Lists the document libraries of a single SharePoint site so users can pick a
/// library from a dropdown instead of typing its title by hand.
/// </summary>
public interface ILibraryDiscoveryService
{
    /// <summary>
    /// Returns the titles of the non-hidden document libraries on
    /// <paramref name="siteUrl"/>, ordered case-insensitively by title.
    /// Handles elevation + context creation internally.
    /// </summary>
    Task<IReadOnlyList<string>> ListLibrariesAsync(
        TenantProfile profile,
        string siteUrl,
        CancellationToken ct = default);
}