/*
 * File: D:\shadowed-realms-mobile\ShadowedRealmsMobile\src\server\ShadowedRealms.Shared\DTOs\Purchase\VipBenefitClaimRequestDto.cs
 * Created: 2025-10-23
 * Last Modified: 2025-10-23
 * Description: Request DTO for VIP benefit claim operations
 * Last Edit Notes: Individual file implementation for VIP benefit claiming with secret tier support and eligibility validation
 */

using System.ComponentModel.DataAnnotations;

namespace ShadowedRealms.Shared.DTOs.Purchase
{
    /// <summary>
    /// Request DTO for VIP benefit claim operations
    /// </summary>
    public class VipBenefitClaimRequestDto
    {
        /// <summary>
        /// Type of benefit being claimed
        /// </summary>
        [Required]
        [StringLength(100)]
        public string BenefitType { get; set; } = string.Empty;

        /// <summary>
        /// Specific benefit identifier
        /// </summary>
        [Required]
        [StringLength(100)]
        public string BenefitId { get; set; } = string.Empty;

        /// <summary>
        /// Quantity of benefit to claim
        /// </summary>
        [Range(1, int.MaxValue)]
        public int Quantity { get; set; } = 1;

        /// <summary>
        /// Whether this is a secret tier benefit
        /// </summary>
        public bool IsSecretTierBenefit { get; set; } = false;

        /// <summary>
        /// Claim frequency type (daily, weekly, monthly, one-time)
        /// </summary>
        [StringLength(50)]
        public string? ClaimFrequency { get; set; }

        /// <summary>
        /// Whether to validate eligibility before claiming
        /// </summary>
        public bool ValidateEligibility { get; set; } = true;

        /// <summary>
        /// Whether to apply bonus multipliers
        /// </summary>
        public bool ApplyBonusMultipliers { get; set; } = true;

        /// <summary>
        /// Target resource or item for benefit application
        /// </summary>
        [StringLength(100)]
        public string? TargetResource { get; set; }

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