using System;

namespace UVC.Data
{
    /// <summary>
    /// 수신된 단일 MQTT 메시지에 대한 모든 정보를 담는 데이터 컨테이너 클래스입니다.
    /// 이 객체는 MqttWorker가 메시지를 수신했을 때 생성되며, MqttDataManager를 통해
    /// 최종적으로 데이터 소비자에게 전달됩니다.
    /// </summary>
    /// <example>
    /// <code>
    /// // MqttDataPacket 객체 생성 예시
    /// var packet = new MqttDataPacket("sensor/temp", "25.5");
    /// 
    /// // 데이터 접근 예시
    /// Debug.Log($"수신 시간: {packet.Timestamp}");
    /// Debug.Log($"토픽: {packet.Topic}");
    /// Debug.Log($"내용: {packet.Payload}");
    /// 
    /// // MqttDataManager가 이 패킷을 리스너에게 전달한 후,
    /// // IsPropagated를 true로 설정하여 중복 전송을 방지합니다.
    /// packet.IsPropagated = true;
    /// Debug.Log($"처리 완료 여부: {packet.IsPropagated}");
    /// </code>
    /// </example>
    public class MqttDataPacket
    {
        /// <summary>
        /// 데이터가 수신된 시간 (UTC 기준)입니다.
        /// 전 세계 어디서든 동일한 시간 기록을 보장하기 위해 협정 세계시(UTC)를 사용합니다.
        /// 'init' 키워드는 객체가 처음 생성될 때만 값을 할당할 수 있도록 하여, 데이터의 불변성을 보장합니다.
        /// </summary>
        public DateTime Timestamp { get; private set; }

        /// <summary>
        /// 메시지가 발행된 MQTT 토픽입니다. (예: "home/livingroom/light")
        /// </summary>
        public string Topic { get; private set; }

        /// <summary>
        /// 메시지의 실제 내용(데이터)입니다. 보통 JSON 형식의 문자열이 담깁니다.
        /// </summary>
        public string Payload { get; private set; }

        /// <summary>
        /// 이 데이터가 리스너에게 전파(전달)되었는지 여부를 나타내는 플래그입니다.
        /// MqttDataManager가 이 값을 사용하여 동일한 데이터를 중복으로 전달하는 것을 방지합니다.
        /// </summary>
        public bool IsPropagated { get; set; }

        /// <summary>
        /// 새로운 MqttDataPacket 인스턴스를 생성합니다.
        /// </summary>
        /// <param name="topic">메시지가 수신된 토픽</param>
        /// <param name="payload">메시지의 내용</param>
        public MqttDataPacket(string topic, string payload)
        {
            this.Timestamp = DateTime.UtcNow;
            this.Topic = topic;
            this.Payload = payload;
            // 모든 패킷은 생성 시점에는 아직 리스너에게 전달되지 않았으므로 'false'로 초기화됩니다.
            this.IsPropagated = false;
        }
    }
}