using System.Collections.Generic;
using AnalyticsDAL.DTO.AnalysisAggregation.V1;
using AnalyticsDAL.DTO.BICatalog;
using GB5Shared.DTO.Framework.Login;

namespace AnalyticsDAL.CustomCode.ApiDataset
{
    public interface IApiDatasetDAL
    {
        /// <summary>Fetches raw (unaggregated) rows for an ApiService-kind dataset by calling the
        /// resolved MDATASOURCE endpoint via the existing IExcelExport.ReportURICalling mechanism
        /// (GB5Shared/ExcelExport/ExcelExport.cs) — reused as-is, not forked. The caller
        /// (IAnalysisAggregationService) is responsible for in-memory grouping afterwards, since
        /// GROUP BY cannot be pushed into an external HTTP call.</summary>
        Task<List<Dictionary<string, object?>>> FetchRowsAsync(
            DatasetResolutionDTO resolution,
            AnalysisQueryDefinition definition,
            LoginDTO login,
            CancellationToken ct);
    }
}