/*
 * File: D:\shadowed-realms-mobile\ShadowedRealmsMobile\src\server\ShadowedRealms.Shared\DTOs\Purchase\PurchaseValidationRequestDto.cs
 * Created: 2025-10-23
 * Last Modified: 2025-10-23
 * Description: Request DTO for purchase validation operations
 * Last Edit Notes: Individual file implementation for purchase validation input with fraud detection and balance monitoring
 */

using System.ComponentModel.DataAnnotations;

namespace ShadowedRealms.Shared.DTOs.Purchase
{
    /// <summary>
    /// Request DTO for purchase validation operations
    /// </summary>
    public class PurchaseValidationRequestDto
    {
        /// <summary>
        /// Item or package being validated for purchase
        /// </summary>
        [Required]
        [StringLength(100)]
        public string ItemId { get; set; } = string.Empty;

        /// <summary>
        /// Quantity being validated for purchase
        /// </summary>
        [Range(1, int.MaxValue)]
        public int Quantity { get; set; } = 1;

        /// <summary>
        /// Purchase amount to validate
        /// </summary>
        [Range(0.01, double.MaxValue)]
        public decimal PurchaseAmount { get; set; }

        /// <summary>
        /// Currency code for validation
        /// </summary>
        [Required]
        [StringLength(3)]
        public string CurrencyCode { get; set; } = string.Empty;

        /// <summary>
        /// External transaction ID for validation
        /// </summary>
        [Required]
        [StringLength(200)]
        public string TransactionId { get; set; } = string.Empty;

        /// <summary>
        /// Payment method to validate
        /// </summary>
        [StringLength(50)]
        public string? PaymentMethod { get; set; }

        /// <summary>
        /// Include anti-pay-to-win balance check
        /// </summary>
        public bool IncludeBalanceCheck { get; set; } = true;

        /// <summary>
        /// Include fraud detection analysis
        /// </summary>
        public bool IncludeFraudDetection { get; set; } = true;

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