using System.Collections.Generic;

namespace FrameworkDAL.DTO.EIPConversation
{
    /// <summary>
    /// Runtime-built structured result from a CALL_API or PRESENT step.
    /// Passed to channel handlers so each channel can render the data appropriately:
    /// AppChat renders TABLE/CARD/LIST natively; WhatsApp/SMS use EIPTextFormatter for text fallback.
    /// </summary>
    public class EIPStructuredDataDTO
    {
        /// <summary>Mirrors ResponseFormatDTO.Type — TABLE | CARD | LIST.</summary>
        public string Type { get; set; } = "TABLE";

        /// <summary>
        /// Column/field definitions. Either declared in ResponseFormat.Fields or auto-derived
        /// from the first row's properties (up to 8 fields).
        /// </summary>
        public List<EIPFieldDefinitionDTO> Fields { get; set; } = new();

        /// <summary>
        /// Rows of data. Each entry maps field name → string value.
        /// CARD = one row. TABLE/LIST = multiple rows (up to MaxRows).
        /// </summary>
        public List<Dictionary<string, string>> Rows { get; set; } = new();

        /// <summary>Total rows in the source data before MaxRows truncation.</summary>
        public int TotalCount { get; set; }

        /// <summary>True when Rows.Count &lt; TotalCount (more records exist).</summary>
        public bool IsTruncated { get; set; }
    }
}