using FrameworkDAL.DTO.EIPConversation;
using System;
using System.Collections.Generic;

namespace FrameworkDAL.DTO.EIPConversation
{
    /// <summary>
    /// Represents the context for sending a response via a channel (WhatsApp, Email, Postman, etc.)
    /// </summary>
    public class EIPResponseContext
    {
        #region Channel / Recipient / Message

        /// <summary>
        /// Channel name (e.g., WHATSAPP, EMAIL, POSTMAN)
        /// </summary>
        public string Channel { get; set; } = default!;

        /// <summary>
        /// Channel type enum
        /// </summary>
        public EIPChannelType ChannelType { get; set; } = EIPChannelType.PostMan;

        /// <summary>
        /// Recipient identifier (e.g., phone number, email)
        /// </summary>
        public string Recipient { get; set; } = default!;

        /// <summary>
        /// Message text
        /// </summary>
        public string Message { get; set; } = default!;

        /// <summary>Optional logical key into MEIPMESSAGETEMPLATE — when set and a matching
        /// row exists for (TenantId, MessageKey, LanguageCode, ChannelType), EIPResponseEngine
        /// overrides Message with the localized template content before sending.</summary>
        public string? MessageKey { get; set; }

        /// <summary>Skips the per-recipient anti-spam rate limit (2s cooldown, keyed by
        /// Channel:Recipient). The limiter exists to stop a runaway flow from spamming a
        /// user, but it has no concept of message importance -- a completely normal,
        /// fast back-to-back conversation turn (e.g. answering a prompt within 2s of the
        /// previous message) would otherwise silently drop the next send, including a
        /// security-critical OTP code. Set true only for messages that must never be
        /// silently dropped (currently: OTP delivery).</summary>
        public bool BypassRateLimit { get; set; }

        /// <summary>
        /// Optional interactive buttons
        /// </summary>
        public List<EIPButtonDTO>? Buttons { get; set; }

        /// <summary>
        /// Optional media URL
        /// </summary>
        public string? MediaUrl { get; set; }

        /// <summary>
        /// Media type (image, video, document, etc.)
        /// </summary>
        public string? MediaType { get; set; }

        /// <summary>
        /// Optional caption for media
        /// </summary>
        public string? Caption { get; set; }

        #endregion

        #region Flow / Tenant / User

        /// <summary>
        /// Tenant Id
        /// </summary>
        public int? TenantId { get; set; }

        /// <summary>
        /// Flow code (can be string or enum)
        /// </summary>
        public object FlowCode { get; set; } = default!;

        /// <summary>
        /// User identifier (phone, email, etc.)
        /// </summary>
        public string? UserIdentifier { get; set; }

        /// <summary>
        /// Raw payload or object triggering this context
        /// </summary>
        public object? RawPayload { get; set; }

        #endregion

        #region WhatsApp Template Support

        /// <summary>
        /// Template name for WhatsApp messages
        /// </summary>
        public string? TemplateName { get; set; }

        /// <summary>
        /// Language code for template (e.g., en_US)
        /// </summary>
        public string? LanguageCode { get; set; }

        /// <summary>
        /// Template components (buttons, headers, body params)
        /// </summary>
        public List<object>? TemplateComponents { get; set; }

        #endregion

        #region Metadata & Trace

        /// <summary>
        /// Additional metadata to attach to this message context
        /// </summary>
        public Dictionary<string, object>? Metadata { get; set; }

        /// <summary>
        /// Execution trace of different phases
        /// </summary>
        public List<EIPExecutionPhaseDTO>? PhaseTrace { get; set; }

        #endregion

        #region Conversation Context

        /// <summary>
        /// Optional conversation id
        /// </summary>
        public long? ConversationId { get; set; }

        /// <summary>
        /// Current step in the flow
        /// </summary>
        public string? CurrentStepCode { get; set; }

        /// <summary>
        /// Next step in the flow
        /// </summary>
        public string? NextStepCode { get; set; }

        /// <summary>
        /// Whether the current flow/step is completed
        /// </summary>
        public bool? IsCompleted { get; set; }

        /// <summary>
        /// Whether the current operation succeeded
        /// </summary>
        public bool? IsSuccess { get; set; }

        /// <summary>
        /// Error message if any
        /// </summary>
        public string? ErrorMessage { get; set; }

        /// <summary>
        /// Response received from the channel
        /// </summary>
        public EIPChannelResponseDTO? ChannelResponse { get; set; }

        #endregion

        #region Additional Dynamic Info

        /// <summary>
        /// Any additional dynamic data to attach to this context
        /// </summary>
        public Dictionary<string, object>? AdditionalData { get; set; }

        #endregion

        #region Structured Response Data

        /// <summary>
        /// Populated when a CALL_API or PRESENT step has ResponseFormat configured.
        /// Text-only channels (WhatsApp, SMS) call EIPTextFormatter.FormatAsText() to produce
        /// a plain-text fallback; rich channels (AppChat) render TABLE/CARD/LIST natively.
        /// </summary>
        public EIPStructuredDataDTO? StructuredData { get; set; }

        #endregion

        #region Extended Interaction

        /// <summary>QR code data string — channels encode and deliver as QR image or raw text.</summary>
        public string? QrCodeData { get; set; }

        /// <summary>When true, the channel should render a location-share prompt/button.</summary>
        public bool RequestLocation { get; set; }

        /// <summary>
        /// For outbound map pin messages (WhatsApp/Telegram support sending a location).
        /// Channel handlers build the appropriate location payload from this.
        /// </summary>
        public EIPLocationDTO? LocationPin { get; set; }

        /// <summary>
        /// Input type hint for the next expected user reply.
        /// AppChat uses this to show the right widget. Text-only channels ignore it.
        /// </summary>
        public string? InputHint { get; set; }

        /// <summary>Max star value when InputHint="rating".</summary>
        public int? RatingMax { get; set; }

        /// <summary>SSML or plain-text TTS override for Voice channel.</summary>
        public string? VoiceHint { get; set; }

        #endregion
    }
}