/*
 * File: D:\shadowed-realms-mobile\ShadowedRealmsMobile\src\server\ShadowedRealms.Shared\DTOs\Purchase\RefundResponseDto.cs
 * Created: 2025-10-23
 * Last Modified: 2025-10-23
 * Description: Response DTO for refund processing results
 * Last Edit Notes: Individual file implementation for refund processing results with VIP adjustment and item removal tracking
 */

namespace ShadowedRealms.Shared.DTOs.Purchase
{
    /// <summary>
    /// Response DTO for refund processing results
    /// </summary>
    public class RefundResponseDto
    {
        /// <summary>
        /// Whether the refund was successfully processed
        /// </summary>
        public bool IsRefunded { get; set; }

        /// <summary>
        /// Player receiving the refund
        /// </summary>
        public int PlayerId { get; set; }

        /// <summary>
        /// Original transaction ID that was refunded
        /// </summary>
        public string OriginalTransactionId { get; set; } = string.Empty;

        /// <summary>
        /// New refund transaction ID
        /// </summary>
        public string RefundTransactionId { get; set; } = string.Empty;

        /// <summary>
        /// Amount successfully refunded
        /// </summary>
        public decimal RefundedAmount { get; set; }

        /// <summary>
        /// Currency of the refund
        /// </summary>
        public string CurrencyCode { get; set; } = string.Empty;

        /// <summary>
        /// Type of refund processed
        /// </summary>
        public string RefundType { get; set; } = string.Empty;

        /// <summary>
        /// VIP progression adjustments made
        /// </summary>
        public Dictionary<string, object> VipAdjustments { get; set; } = new();

        /// <summary>
        /// Items/benefits removed due to refund
        /// </summary>
        public List<string> RemovedItems { get; set; } = new();

        /// <summary>
        /// External payment processor response
        /// </summary>
        public Dictionary<string, object>? PaymentProcessorResponse { get; set; }

        /// <summary>
        /// When the refund was processed
        /// </summary>
        public DateTime ProcessedAt { get; set; }

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