using EntitlementDAL.DTOs;
using EntitlementDAL.Enums;

namespace EntitlementBLL.Interfaces;

/// <summary>
/// The 9-layer feature resolution engine. IsFeatureEnabledAsync's layer order is HARD-CODED,
/// NO EXCEPTIONS, NO BYPASS — see EntitlementService.IsFeatureEnabledAsync for the literal
/// implementation of every layer, in order.
/// </summary>
public interface IEntitlementService
{
    Task<bool> IsFeatureEnabledAsync(int clientId, int userId, string featureCode, CancellationToken ct);

    /// <summary>Throws EntitlementQuotaExceededException when a Quota-type feature would be exceeded.</summary>
    Task EnsureQuotaAsync(int clientId, string featureCode, long delta, CancellationToken ct);

    Task<int> GetRemainingSeatsAsync(int clientId, LicenseTypeEnum licenseType, CancellationToken ct);

    Task<EntitlementBundleDto> GetResolvedBundleAsync(int clientId, CancellationToken ct);
}