/*
 * File: D:\shadowed-realms-mobile\ShadowedRealmsMobile\src\server\ShadowedRealms.Shared\DTOs\Purchase\VipProgressionRequestDto.cs
 * Created: 2025-10-23
 * Last Modified: 2025-10-23
 * Description: Request DTO for VIP progression management operations
 * Last Edit Notes: Individual file implementation for VIP progression with secret tier support and chargeback protection
 */

using System.ComponentModel.DataAnnotations;

namespace ShadowedRealms.Shared.DTOs.Purchase
{
    /// <summary>
    /// Request DTO for VIP progression management operations
    /// </summary>
    public class VipProgressionRequestDto
    {
        /// <summary>
        /// Type of VIP progression operation (advance, adjust, recalculate)
        /// </summary>
        [Required]
        [StringLength(50)]
        public string ProgressionType { get; set; } = string.Empty;

        /// <summary>
        /// Purchase amount contributing to VIP progression
        /// </summary>
        [Range(0, double.MaxValue)]
        public decimal? PurchaseAmount { get; set; }

        /// <summary>
        /// Target VIP level (for manual adjustments)
        /// </summary>
        [Range(0, 50)]
        public int? TargetVipLevel { get; set; }

        /// <summary>
        /// Whether to include secret tier calculations
        /// </summary>
        public bool IncludeSecretTiers { get; set; } = true;

        /// <summary>
        /// Whether to apply chargeback protection adjustments
        /// </summary>
        public bool ApplyChargebackProtection { get; set; } = true;

        /// <summary>
        /// Reason for VIP progression change
        /// </summary>
        [StringLength(200)]
        public string? ProgressionReason { get; set; }

        /// <summary>
        /// External transaction reference
        /// </summary>
        [StringLength(200)]
        public string? TransactionReference { get; set; }

        /// <summary>
        /// Whether to recalculate benefits automatically
        /// </summary>
        public bool RecalculateBenefits { get; set; } = true;

        /// <summary>
        /// Additional progression parameters
        /// </summary>
        public Dictionary<string, object>? ProgressionParameters { get; set; }
    }
}