using EntitlementDAL.DTOs;
using GB5Shared.DTO.Framework.Login;

namespace EntitlementBLL.Interfaces;

/// <summary>Plain CRUD for MENTITLEMENTFEATUREFLAG, kept separate from IFeatureFlagService
/// (which owns the kill-switch/rollout/target mutation + audit semantics per the core spec).</summary>
public interface IFeatureFlagBLL
{
    Task<FeatureFlagDTO?> GetAsync(int featureFlagId, LoginDTO login, CancellationToken ct);
    Task<IEnumerable<FeatureFlagDTO>> GetListAsync(LoginDTO login, CancellationToken ct);
    Task<string> SaveAsync(FeatureFlagDTO dto, LoginDTO login, CancellationToken ct);

    /// <summary>Resolves a flag by its feature's FEATURECODE — used by CapabilityDisabledSubscriber
    /// to mirror an EAP capability-disable event as a kill switch (see that class's TODO note).</summary>
    Task<FeatureFlagDTO?> GetByFeatureCodeAsync(string featureCode, LoginDTO login, CancellationToken ct);

    /// <summary>MENTITLEMENTFEATUREFLAGTARGET rows for a flag (FeatureFlag.svc/GetTargetList) —
    /// previously only addable/removable via AddTarget/RemoveTarget, never listable.</summary>
    Task<IEnumerable<FeatureFlagTargetDTO>> GetTargetListAsync(int featureFlagId, LoginDTO login, CancellationToken ct);
}