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

namespace EntitlementDAL.Interfaces;

/// <summary>
/// Narrow MUSER write path for ClientUserProvisioner — see its own doc comment for why this
/// exists instead of a FrameworkBLL/FrameworkDAL reference.
/// </summary>
public interface IEntitlementUserDAL
{
    Task SaveUserAsync(EntitlementUserDTO userDto, LoginDTO login, CancellationToken ct);

    /// <summary>Tracker §49 Decision 8/9 — reads back a central account's admin identity to seed
    /// a real per-prospect MUSER inside a pooled demo instance's own physical database.</summary>
    Task<EntitlementUserDTO?> GetUserByIdAsync(int userId, LoginDTO login, CancellationToken ct);

    /// <summary>Tracker §49 — resolves a demo/trial ClientId's own admin contact (Name/Email) for
    /// the warning-email step, without needing UserId threaded through the whole expiry pipeline.</summary>
    Task<EntitlementUserDTO?> GetUserByClientIdAsync(int clientId, LoginDTO login, CancellationToken ct);
}