namespace FrameworkDAL.DTO.EIPConversation
{
    /// <summary>
    /// Configuration for a DYNAMIC_CHOICE step — builds an interactive selection
    /// menu at runtime from a previously stored API response, allowing users to
    /// tap/click an item rather than typing a code.
    /// </summary>
    public class EIPDynamicChoiceConfigDTO
    {
        /// <summary>Context variable key that holds the API response JSON (set by a prior CALL_API step).</summary>
        public string SourceKey { get; set; } = "";

        /// <summary>
        /// Dot-notation path into the JSON to reach the item array.
        /// E.g. "Body.Items", "Data.Result". Empty/null → use JSON root directly.
        /// Reuses the same NavigateJsonPath helper as PRESENT/CALL_API steps.
        /// </summary>
        public string? DataPath { get; set; }

        /// <summary>JSON property name within each item to use as the button display label.</summary>
        public string LabelField { get; set; } = "";

        /// <summary>JSON property name within each item to use as the stored value on selection.</summary>
        public string ValueField { get; set; } = "";

        /// <summary>
        /// Context variable key to store the selected item's ValueField value.
        /// Use this to route or substitute: "You selected {SelectedCode}".
        /// </summary>
        public string? StoreSelectedKey { get; set; }

        /// <summary>
        /// Context variable key to store the entire selected item as a JSON string.
        /// Enables dot-notation in subsequent steps: {SelectedItem.ProductName}.
        /// </summary>
        public string? StoreItemKey { get; set; }

        /// <summary>Maximum number of choice buttons to present. Default 10.</summary>
        public int MaxChoices { get; set; } = 10;
    }
}