"""
基础事件模型模块

定义了所有 OneBot 11 事件的基类和事件类型枚举。
"""
from dataclasses import dataclass, field
from typing import TYPE_CHECKING, Optional
from abc import ABC, abstractmethod

if TYPE_CHECKING:
    from core.bot import Bot


class EventType:
    """
    事件类型枚举
    """
    META = 'meta_event'      # 元事件
    REQUEST = 'request'      # 请求事件
    NOTICE = 'notice'        # 通知事件
    MESSAGE = 'message'      # 消息事件
    MESSAGE_SENT = 'message_sent'  # 消息发送事件


@dataclass
class OneBotEvent(ABC):
    """
    OneBot 事件基类
    所有具体的事件类型都应该继承自此类
    """

    time: int
    """事件发生的时间戳"""

    self_id: int
    """收到事件的机器人 QQ 号"""

    _bot: Optional["Bot"] = field(default=None, init=False)
    """Bot 实例引用，用于快捷调用 API"""

    @property
    @abstractmethod
    def post_type(self) -> str:
        """
        上报类型
        """
        pass

    @property
    def bot(self) -> "Bot":
        """
        获取 Bot 实例

        :return: Bot 实例
        :raises ValueError: 如果 Bot 实例未设置
        """
        if self._bot is None:
            raise ValueError("Bot instance not set for this event")
        return self._bot

    @bot.setter
    def bot(self, value: "Bot"):
        """
        设置 Bot 实例

        :param value: Bot 实例
        """
        self._bot = value