using GB5Shared.DTO.Framework.Login;
using GoodBooks.PAY.PAYDAL.DTO.Loyalty;

namespace GoodBooks.PAY.PAYBLL.Loyalty
{
    public interface ICustomerLoyaltyBLL
    {
        /// <summary>
        /// Idempotent enrollment. Returns success (not error) if customer is already enrolled.
        /// Creates a zero-point ledger row as an enrollment marker.
        /// </summary>
        Task<string> EnrollCustomer(CustomerLoyaltyEnrollmentDTO dto, LoginDTO login, CancellationToken ct);

        Task<string> GetEnrollment(int enrollmentId, LoginDTO login, CancellationToken ct);

        /// <summary>
        /// Returns the live balance as serialised JSON {AvailablePoints: N}.
        /// Always queries TLOYALTYLEDGER directly — never from enrollment header.
        /// </summary>
        Task<string> GetCustomerLoyaltyBalance(int enrollmentId, LoginDTO login, CancellationToken ct);

        Task<string> GetLoyaltyLedger(int enrollmentId, int pageOffset, int pageSize, LoginDTO login, CancellationToken ct);

        /// <summary>
        /// Awards loyalty points for a payment success event.
        /// Resolves the correct earn rule, calculates points, appends a ledger row,
        /// updates enrollment totals, and checks for tier upgrades.
        /// Called by PayWebhookBLL (and CashbackLedgerBLL for mode-4 payouts).
        /// </summary>
        Task EarnPointsAsync(
            int      enrollmentId,
            int      payOrderId,
            decimal  netPayableAmt,
            int?     productId,
            int?     categoryId,
            int      payGatewayId,
            LoginDTO login,
            CancellationToken ct);

        /// <summary>
        /// Inserts compensating negative-points rows for all enrollments with points
        /// expiring today. Called daily by LoyaltyPointsExpiryJob.
        /// APPEND-ONLY — never updates existing ledger rows.
        /// </summary>
        Task ExpirePointsAsync(LoginDTO login, CancellationToken ct);
    }
}