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

using System.ComponentModel.DataAnnotations;

namespace ShadowedRealms.Shared.DTOs.Purchase
{
    /// <summary>
    /// Request DTO for refund processing operations
    /// </summary>
    public class RefundRequestDto
    {
        /// <summary>
        /// Original transaction ID to be refunded
        /// </summary>
        [Required]
        [StringLength(200)]
        public string OriginalTransactionId { get; set; } = string.Empty;

        /// <summary>
        /// Reason for the refund request
        /// </summary>
        [Required]
        [StringLength(500)]
        public string RefundReason { get; set; } = string.Empty;

        /// <summary>
        /// Refund amount requested
        /// </summary>
        [Range(0.01, double.MaxValue)]
        public decimal RefundAmount { get; set; }

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

        /// <summary>
        /// Refund type (partial, full, chargeback)
        /// </summary>
        [Required]
        [StringLength(50)]
        public string RefundType { get; set; } = string.Empty;

        /// <summary>
        /// Whether to adjust VIP progression for refund
        /// </summary>
        public bool AdjustVipProgression { get; set; } = true;

        /// <summary>
        /// Whether to remove purchased items/benefits
        /// </summary>
        public bool RemovePurchasedItems { get; set; } = true;

        /// <summary>
        /// External refund reference from payment processor
        /// </summary>
        [StringLength(200)]
        public string? ExternalRefundReference { get; set; }

        /// <summary>
        /// Additional refund processing parameters
        /// </summary>
        public Dictionary<string, object>? RefundParameters { get; set; }
    }
}