/*
 * File: D:\shadowed-realms-mobile\ShadowedRealmsMobile\src\server\ShadowedRealms.Shared\DTOs\Player\VipAdvancementRequestDto.cs
 * Created: 2025-10-23
 * Last Modified: 2025-10-23
 * Description: Request DTO for VIP advancement operations
 * Last Edit Notes: Individual file implementation for VIP advancement input validation
 */

using System.ComponentModel.DataAnnotations;

namespace ShadowedRealms.Shared.DTOs.Player
{
    /// <summary>
    /// Request DTO for VIP advancement operations
    /// </summary>
    public class VipAdvancementRequestDto
    {
        /// <summary>
        /// Target VIP level to advance to
        /// </summary>
        [Required]
        [Range(1, 20)]
        public int TargetVipLevel { get; set; }

        /// <summary>
        /// Whether to use accumulated VIP points
        /// </summary>
        public bool UseVipPoints { get; set; } = true;

        /// <summary>
        /// Whether to purchase additional points if needed
        /// </summary>
        public bool AllowPurchase { get; set; } = false;

        /// <summary>
        /// Maximum amount willing to spend on advancement
        /// </summary>
        [Range(0, 10000)]
        public decimal MaxSpendAmount { get; set; } = 0;

        /// <summary>
        /// Preferred payment method if purchase is needed
        /// </summary>
        [StringLength(50)]
        public string? PreferredPaymentMethod { get; set; }

        /// <summary>
        /// Additional advancement preferences
        /// </summary>
        public Dictionary<string, object> AdvancementPreferences { get; set; } = new();
    }
}