listener

type Event string

type EventData struct {
	Event     Event          // Event type | 事件类型
	LoginID   string         // User login ID | 用户登录ID
	Device    string         // Device identifier | 设备标识
	Token     string         // Authentication token | 认证Token
	Extra     map[string]any // Additional custom data | 额外的自定义数据
	Timestamp int64          // Unix timestamp when event was triggered | 事件触发的Unix时间戳
}

type EventFilter func(data *EventData) bool

type EventStats struct {
	TotalTriggered int64               // Total number of events triggered | 触发的事件总数
	EventCounts    map[Event]int64     // Count per event type | 各类型事件的计数
	LastTriggered  map[Event]time.Time // Last trigger time per event | 各类型事件的最后触发时间
}

type Listener interface {
	// OnEvent is called when an event is triggered | 当事件触发时调用
	// The listener should not panic; any panic will be recovered by the event manager | 监听器不应该panic，任何panic都会被事件管理器恢复
	OnEvent(data *EventData)
}

type ListenerConfig struct {
	Async    bool   // If true, listener runs asynchronously | 如果为true，监听器异步运行
	Priority int    // Higher priority listeners are called first (default: 0) | 优先级越高越先执行（默认：0）
	ID       string // Unique identifier for this listener (for unregistering) | 监听器唯一标识（用于注销）
}

type ListenerFunc func(data *EventData)

type Manager struct {
	// contains filtered or unexported fields
}