namespace Books.Api.AiBookkeeper;

/// <summary>
/// Provides chart of accounts data for AI Bookkeeper processing.
/// </summary>
public interface IChartOfAccountsProvider
{
    /// <summary>
    /// Get the chart of accounts for a company.
    /// Returns only expense-type accounts (expense, cogs, personnel, financial) that AI can suggest.
    /// </summary>
    /// <param name="companyId">Company ID</param>
    /// <param name="cancellationToken">Cancellation token</param>
    /// <returns>Chart of accounts with filtered expense accounts</returns>
    Task<ChartOfAccountsDto> GetChartOfAccountsAsync(
        string companyId, CancellationToken cancellationToken = default);
}