// mautrix-discord - A Matrix-Discord puppeting bridge. // Copyright 2015-2016 Bruce Marriner . All rights reserved. // Copyright (C) 2026 The mautrix-discord contributors // // This file is derived from discordgo (https://github.com/bwmarrin/discordgo), // used under the BSD-3-Clause license; see README.md in this directory. This // file is distributed under the GNU AGPLv3 as follows: // // This program is free software: you can redistribute it and/or modify // it under the terms of the GNU Affero General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // This program is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU Affero General Public License for more details. // // You should have received a copy of the GNU Affero General Public License // along with this program. If not, see . package meowcord // EventHandler is an interface for Discord events. type EventHandler interface { // Type returns the type of event this handler belongs to. Type() string // Handle is called whenever an event of Type() happens. // It is the receivers responsibility to type assert that the interface // is the expected struct. Handle(*Session, interface{}) } // EventInterfaceProvider is an interface for providing empty interfaces for // Discord events. type EventInterfaceProvider interface { // Type is the type of event this handler belongs to. Type() string // New returns a new instance of the struct this event handler handles. // This is called once per event. // The struct is provided to all handlers of the same Type(). New() interface{} } // interfaceEventType is the event handler type for interface{} events. const interfaceEventType = "__INTERFACE__" // interfaceEventHandler is an event handler for interface{} events. type interfaceEventHandler func(*Session, interface{}) // Type returns the event type for interface{} events. func (eh interfaceEventHandler) Type() string { return interfaceEventType } // Handle is the handler for an interface{} event. func (eh interfaceEventHandler) Handle(s *Session, i interface{}) { eh(s, i) } var registeredInterfaceProviders = map[string]EventInterfaceProvider{} // registerInterfaceProvider registers a provider so that DiscordGo can // access it's New() method. func registerInterfaceProvider(eh EventInterfaceProvider) { if _, ok := registeredInterfaceProviders[eh.Type()]; ok { return // XXX: // if we should error here, we need to do something with it. // fmt.Errorf("event %s already registered", eh.Type()) } registeredInterfaceProviders[eh.Type()] = eh } // eventHandlerInstance is a wrapper around an event handler, as functions // cannot be compared directly. type eventHandlerInstance struct { eventHandler EventHandler } // addEventHandler adds an event handler that will be fired anytime // the Discord WSAPI matching eventHandler.Type() fires. func (s *Session) addEventHandler(eventHandler EventHandler) func() { s.handlersMu.Lock() defer s.handlersMu.Unlock() if s.handlers == nil { s.handlers = map[string][]*eventHandlerInstance{} } ehi := &eventHandlerInstance{eventHandler} s.handlers[eventHandler.Type()] = append(s.handlers[eventHandler.Type()], ehi) return func() { s.removeEventHandlerInstance(eventHandler.Type(), ehi) } } // addEventHandler adds an event handler that will be fired the next time // the Discord WSAPI matching eventHandler.Type() fires. func (s *Session) addEventHandlerOnce(eventHandler EventHandler) func() { s.handlersMu.Lock() defer s.handlersMu.Unlock() if s.onceHandlers == nil { s.onceHandlers = map[string][]*eventHandlerInstance{} } ehi := &eventHandlerInstance{eventHandler} s.onceHandlers[eventHandler.Type()] = append(s.onceHandlers[eventHandler.Type()], ehi) return func() { s.removeEventHandlerInstance(eventHandler.Type(), ehi) } } // AddHandler allows you to add an event handler that will be fired anytime // the Discord WSAPI event that matches the function fires. // The first parameter is a *Session, and the second parameter is a pointer // to a struct corresponding to the event for which you want to listen. // // eg: // // Session.AddHandler(func(s *discordgo.Session, m *discordgo.MessageCreate) { // }) // // or: // // Session.AddHandler(func(s *discordgo.Session, m *discordgo.PresenceUpdate) { // }) // // List of events can be found at this page, with corresponding names in the // library for each event: https://discord.com/developers/docs/topics/gateway#event-names // There are also synthetic events fired by the library internally which are // available for handling, like Connect, Disconnect, and RateLimit. // events.go contains all of the Discord WSAPI and synthetic events that can be handled. // // The return value of this method is a function, that when called will remove the // event handler. func (s *Session) AddHandler(handler interface{}) func() { eh := handlerForInterface(handler) if eh == nil { s.log(LogError, "Invalid handler type, handler will never be called") return func() {} } return s.addEventHandler(eh) } // AddHandlerOnce allows you to add an event handler that will be fired the next time // the Discord WSAPI event that matches the function fires. // See AddHandler for more details. func (s *Session) AddHandlerOnce(handler interface{}) func() { eh := handlerForInterface(handler) if eh == nil { s.log(LogError, "Invalid handler type, handler will never be called") return func() {} } return s.addEventHandlerOnce(eh) } // removeEventHandler instance removes an event handler instance. func (s *Session) removeEventHandlerInstance(t string, ehi *eventHandlerInstance) { s.handlersMu.Lock() defer s.handlersMu.Unlock() handlers := s.handlers[t] for i := range handlers { if handlers[i] == ehi { s.handlers[t] = append(handlers[:i], handlers[i+1:]...) } } onceHandlers := s.onceHandlers[t] for i := range onceHandlers { if onceHandlers[i] == ehi { s.onceHandlers[t] = append(onceHandlers[:i], onceHandlers[i+1:]...) } } } // Handles calling permanent and once handlers for an event type. /* func (s *Session) handle(t string, i interface{}) { for _, eh := range s.handlers[t] { if s.SyncEvents { eh.eventHandler.Handle(s, i) } else { go eh.eventHandler.Handle(s, i) } } if len(s.onceHandlers[t]) > 0 { for _, eh := range s.onceHandlers[t] { if s.SyncEvents { eh.eventHandler.Handle(s, i) } else { go eh.eventHandler.Handle(s, i) } } s.onceHandlers[t] = nil } } */ // Handles an event type by calling internal methods, firing handlers and firing the // interface{} event. func (s *Session) handleEvent(t string, i interface{}) { //s.handlersMu.RLock() //defer s.handlersMu.RUnlock() // All events are dispatched internally first. s.onInterface(i) if s.EventHandler != nil { s.EventHandler(i) } // Then they are dispatched to anyone handling interface{} events. //s.handle(interfaceEventType, i) // Finally they are dispatched to any typed handlers. //s.handle(t, i) } // setGuildIds will set the GuildID on all the members of a guild. // This is done as event data does not have it set. func setGuildIds(g *Guild) { for _, c := range g.Channels { c.GuildID = g.ID } for _, m := range g.Members { m.GuildID = g.ID } for _, vs := range g.VoiceStates { vs.GuildID = g.ID } } func setPrivateChannelMembers(r *Ready) { users := make(map[string]*User) for _, user := range r.Users { users[user.ID] = user } for _, ch := range r.PrivateChannels { if ch.Recipients != nil || len(ch.RecipientIDs) == 0 { continue } ch.Recipients = make([]*User, len(ch.RecipientIDs)) for index, id := range ch.RecipientIDs { ch.Recipients[index] = users[id] } } } func copyGuildProperties(g *Guild) { if g.Properties == nil { return } g.AfkChannelID = g.Properties.AfkChannelID g.AfkTimeout = g.Properties.AfkTimeout g.ApplicationID = g.Properties.ApplicationID g.Banner = g.Properties.Banner g.DefaultMessageNotifications = g.Properties.DefaultMessageNotifications g.Description = g.Properties.Description g.DiscoverySplash = g.Properties.DiscoverySplash g.ExplicitContentFilter = g.Properties.ExplicitContentFilter g.Features = g.Properties.Features //g.HomeHeader = g.Properties.HomeHeader //g.HubType = g.Properties.HubType g.Icon = g.Properties.Icon //g.LatestOnboardingQuestionID = g.Properties.LatestOnboardingQuestionID g.MaxMembers = g.Properties.MaxMembers //g.MaxStageVideoChannelUsers = g.Properties.MaxStageVideoChannelUsers g.MaxVideoChannelUsers = g.Properties.MaxVideoChannelUsers g.MfaLevel = g.Properties.MfaLevel g.Name = g.Properties.Name //g.NSFW = g.Properties.NSFW g.NSFWLevel = g.Properties.NSFWLevel g.OwnerID = g.Properties.OwnerID g.PreferredLocale = g.Properties.PreferredLocale //g.PremiumProgressBarEnabled = g.Properties.PremiumProgressBarEnabled g.PremiumTier = g.Properties.PremiumTier g.PublicUpdatesChannelID = g.Properties.PublicUpdatesChannelID g.RulesChannelID = g.Properties.RulesChannelID //g.SafetyAlertsChannelID = g.Properties.SafetyAlertsChannelID g.Splash = g.Properties.Splash g.SystemChannelFlags = g.Properties.SystemChannelFlags g.SystemChannelID = g.Properties.SystemChannelID g.VanityURLCode = g.Properties.VanityURLCode g.VerificationLevel = g.Properties.VerificationLevel g.Properties = nil } // onInterface handles all internal events and routes them to the appropriate internal handler. func (s *Session) onInterface(i interface{}) { switch t := i.(type) { case *Ready: for _, g := range t.Guilds { copyGuildProperties(g) setGuildIds(g) } setPrivateChannelMembers(t) s.onReady(t) case *GuildCreate: copyGuildProperties(t.Guild) setGuildIds(t.Guild) case *GuildUpdate: copyGuildProperties(t.Guild) setGuildIds(t.Guild) case *VoiceServerUpdate: go s.onVoiceServerUpdate(t) case *VoiceStateUpdate: go s.onVoiceStateUpdate(t) } err := s.State.OnInterface(s, i) if err != nil { s.log(LogDebug, "error dispatching internal event, %s", err) } } // onReady handles the ready event. func (s *Session) onReady(r *Ready) { // Store the SessionID within the Session struct. s.sessionID = r.SessionID // Store the ResumeGatewayURL within the Session struct. s.resumeGatewayURL = r.ResumeGatewayURL }