using SharepointToolbox.Web.Core.Models;

namespace SharepointToolbox.Web.Services;

/// <summary>
/// Discovers SharePoint sites in a tenant via Microsoft Graph so users can
/// pick multiple sites to scan instead of typing URLs one at a time.
/// </summary>
public interface ISiteDiscoveryService
{
    /// <summary>
    /// Returns sites matching <paramref name="query"/> (defaults to all sites).
    /// OneDrive personal sites are excluded; results are de-duplicated by URL
    /// and ordered by title.
    /// </summary>
    Task<IReadOnlyList<SiteInfo>> SearchSitesAsync(
        TenantProfile profile,
        string? query = null,
        CancellationToken ct = default);
}