gogobee/internal/plugin/plugin.go

package plugin

import (
	"context"
	"fmt"
	"log/slog"
	"os"
	"strconv"
	"strings"
	"sync"

	"gogobee/internal/db"
	"gogobee/internal/util"

	"maunium.net/go/mautrix"
	"maunium.net/go/mautrix/event"
	"maunium.net/go/mautrix/id"
)

// CommandDef describes a bot command for help/discovery.
type CommandDef struct {
	Name        string
	Description string
	Usage       string
	Category    string
	AdminOnly   bool
}

// MessageContext holds the context for a message event.
type MessageContext struct {
	RoomID    id.RoomID
	EventID   id.EventID
	Sender    id.UserID
	Body      string
	IsCommand bool // true if the message starts with the command prefix
	Event     *event.Event
}

// ReactionContext holds the context for a reaction event.
type ReactionContext struct {
	RoomID      id.RoomID
	EventID     id.EventID
	Sender      id.UserID
	TargetEvent id.EventID
	Emoji       string
	Event       *event.Event
}

// Plugin is the interface all plugins must implement.
type Plugin interface {
	Name() string
	Commands() []CommandDef
	OnMessage(ctx MessageContext) error
	OnReaction(ctx ReactionContext) error
	Init() error
}

// Base provides common helpers for plugin implementations.
type Base struct {
	Client *mautrix.Client
	Prefix string
}

// NewBase creates a Base with default prefix "!".
func NewBase(client *mautrix.Client) Base {
	return Base{Client: client, Prefix: "!"}
}

// IsCommand checks if body matches prefix+command.
func (b *Base) IsCommand(body, command string) bool {
	return util.IsCommand(body, b.Prefix, command)
}

// GetArgs returns the argument string after the command.
func (b *Base) GetArgs(body, command string) string {
	return util.GetArgs(body, b.Prefix, command)
}

// IsAdmin checks if a user ID is in the admin list.
func (b *Base) IsAdmin(userID id.UserID) bool {
	admins := os.Getenv("ADMIN_USERS")
	if admins == "" {
		return false
	}
	for _, a := range strings.Split(admins, ",") {
		if strings.TrimSpace(a) == string(userID) {
			return true
		}
	}
	return false
}

// RoomMembers returns the set of user IDs visible from a room. If space groups
// are enabled, this returns the union of all members across rooms in the same
// space group. Otherwise falls back to the single room's membership.
func (b *Base) RoomMembers(roomID id.RoomID) map[id.UserID]bool {
	if spaceGroupMgr != nil {
		if members := spaceGroupMgr.GetGroupMembers(roomID); members != nil {
			return members
		}
	}
	// Fallback: direct API call
	resp, err := b.Client.JoinedMembers(context.Background(), roomID)
	if err != nil {
		slog.Error("failed to get room members", "room", roomID, "err", err)
		return nil
	}
	members := make(map[id.UserID]bool, len(resp.Joined))
	for uid := range resp.Joined {
		members[uid] = true
	}
	return members
}

// ---- Space Group Manager ----

var spaceGroupMgr *SpaceGroupManager

// SpaceGroupManager automatically groups rooms with overlapping membership
// so that leaderboards and other scoped queries show the full community.
type SpaceGroupManager struct {
	mu           sync.RWMutex
	client       *mautrix.Client
	threshold    int // overlap percentage (0-100)
	roomToGroup  map[id.RoomID]int
	groupMembers map[int]map[id.UserID]bool
}

// InitSpaceGroups creates and initializes the space group manager.
func InitSpaceGroups(client *mautrix.Client) {
	threshold := 50
	if v := os.Getenv("SPACE_GROUP_THRESHOLD"); v != "" {
		if n, err := strconv.Atoi(v); err == nil && n > 0 && n <= 100 {
			threshold = n
		}
	}

	sg := &SpaceGroupManager{
		client:       client,
		threshold:    threshold,
		roomToGroup:  make(map[id.RoomID]int),
		groupMembers: make(map[int]map[id.UserID]bool),
	}

	// Always compute fresh groups on startup to pick up threshold changes
	sg.Refresh()
	spaceGroupMgr = sg
	slog.Info("space_groups: initialized", "threshold", threshold)
}

// RefreshSpaceGroups triggers a refresh of space group mappings.
func RefreshSpaceGroups() {
	if spaceGroupMgr != nil {
		spaceGroupMgr.Refresh()
	}
}

// GetGroupMembers returns the union of all members across rooms in the same
// space group as roomID. Returns nil if the room is not tracked.
func (sg *SpaceGroupManager) GetGroupMembers(roomID id.RoomID) map[id.UserID]bool {
	sg.mu.RLock()
	defer sg.mu.RUnlock()

	gid, ok := sg.roomToGroup[roomID]
	if !ok {
		return nil
	}
	return sg.groupMembers[gid]
}

// Refresh recomputes space groups from live room membership data.
func (sg *SpaceGroupManager) Refresh() {
	ctx := context.Background()

	// Get all rooms the bot is in
	joinedResp, err := sg.client.JoinedRooms(ctx)
	if err != nil {
		slog.Error("space_groups: failed to get joined rooms", "err", err)
		return
	}
	rooms := joinedResp.JoinedRooms
	if len(rooms) == 0 {
		slog.Warn("space_groups: bot is not in any rooms")
		return
	}

	// Fetch members for each room
	roomMembers := make(map[id.RoomID]map[id.UserID]bool, len(rooms))
	for _, roomID := range rooms {
		resp, err := sg.client.JoinedMembers(ctx, roomID)
		if err != nil {
			slog.Warn("space_groups: failed to get members", "room", roomID, "err", err)
			continue
		}
		members := make(map[id.UserID]bool, len(resp.Joined))
		for uid := range resp.Joined {
			members[uid] = true
		}
		roomMembers[roomID] = members
	}

	// Strict grouping: a room only joins a group if it meets the overlap
	// threshold with EVERY room already in that group (no transitive chaining).
	roomList := make([]id.RoomID, 0, len(roomMembers))
	for r := range roomMembers {
		roomList = append(roomList, r)
	}

	// Precompute pairwise overlap pass/fail
	meetsThreshold := func(a, b id.RoomID) bool {
		membersA, membersB := roomMembers[a], roomMembers[b]
		smallerSize := len(membersA)
		if len(membersB) < smallerSize {
			smallerSize = len(membersB)
		}
		if smallerSize == 0 {
			return false
		}
		overlap := 0
		if len(membersA) <= len(membersB) {
			for uid := range membersA {
				if membersB[uid] {
					overlap++
				}
			}
		} else {
			for uid := range membersB {
				if membersA[uid] {
					overlap++
				}
			}
		}
		return overlap*100 >= smallerSize*sg.threshold
	}

	// Build groups: try to add each room to an existing group where it
	// meets the threshold with every member. Otherwise start a new group.
	var groups [][]id.RoomID
	for _, r := range roomList {
		placed := false
		for gi, group := range groups {
			fitsAll := true
			for _, member := range group {
				if !meetsThreshold(r, member) {
					fitsAll = false
					break
				}
			}
			if fitsAll {
				groups[gi] = append(groups[gi], r)
				placed = true
				break
			}
		}
		if !placed {
			groups = append(groups, []id.RoomID{r})
		}
	}

	// Assign group IDs
	newRoomToGroup := make(map[id.RoomID]int, len(roomList))
	for gid, group := range groups {
		for _, r := range group {
			newRoomToGroup[r] = gid + 1
		}
	}

	// Build group member unions
	newGroupMembers := make(map[int]map[id.UserID]bool)
	for r, gid := range newRoomToGroup {
		if newGroupMembers[gid] == nil {
			newGroupMembers[gid] = make(map[id.UserID]bool)
		}
		for uid := range roomMembers[r] {
			newGroupMembers[gid][uid] = true
		}
	}

	// Persist to DB — only replace rows for rooms we successfully fetched
	d := db.Get()
	tx, err := d.Begin()
	if err != nil {
		slog.Error("space_groups: begin tx", "err", err)
		return
	}
	// Delete only rooms we have fresh data for (preserve entries for rooms that failed to fetch)
	for r := range newRoomToGroup {
		if _, err := tx.Exec(`DELETE FROM space_groups WHERE room_id = ?`, string(r)); err != nil {
			slog.Error("space_groups: delete row", "room", r, "err", err)
			tx.Rollback()
			return
		}
	}
	for r, gid := range newRoomToGroup {
		if _, err := tx.Exec(`INSERT INTO space_groups (room_id, group_id, updated_at) VALUES (?, ?, CURRENT_TIMESTAMP)`,
			string(r), gid); err != nil {
			slog.Error("space_groups: insert row", "room", r, "err", err)
			tx.Rollback()
			return
		}
	}
	if err := tx.Commit(); err != nil {
		slog.Error("space_groups: commit", "err", err)
		return
	}

	// Swap cache under write lock
	sg.mu.Lock()
	sg.roomToGroup = newRoomToGroup
	sg.groupMembers = newGroupMembers
	sg.mu.Unlock()

	// Log summary
	groupCounts := make(map[int]int)
	for _, gid := range newRoomToGroup {
		groupCounts[gid]++
	}
	multiRoom := 0
	for _, count := range groupCounts {
		if count > 1 {
			multiRoom++
		}
	}
	slog.Info("space_groups: refresh complete",
		"rooms", len(newRoomToGroup),
		"groups", len(groupCounts),
		"multi_room_groups", multiRoom,
		"threshold", sg.threshold)
}

// rebuildMemberCache fetches live membership for rooms in stored groups.
func (sg *SpaceGroupManager) rebuildMemberCache() {
	ctx := context.Background()
	newGroupMembers := make(map[int]map[id.UserID]bool)

	for roomID, gid := range sg.roomToGroup {
		resp, err := sg.client.JoinedMembers(ctx, roomID)
		if err != nil {
			slog.Warn("space_groups: rebuild cache failed for room", "room", roomID, "err", err)
			continue
		}
		if newGroupMembers[gid] == nil {
			newGroupMembers[gid] = make(map[id.UserID]bool)
		}
		for uid := range resp.Joined {
			newGroupMembers[gid][uid] = true
		}
	}

	sg.mu.Lock()
	sg.groupMembers = newGroupMembers
	sg.mu.Unlock()
}

// ResolveUser resolves a partial username or display name to a full Matrix user ID.
// Accepts any of: "@user:server", "user:server", "user", display name, or partial match.
// Uses room membership to match against display names when a localpart match isn't found.
// Returns the matched user ID and true, or empty and false if no unique match.
func (b *Base) ResolveUser(input string, roomIDs ...id.RoomID) (id.UserID, bool) {
	input = strings.TrimSpace(input)
	if input == "" {
		return "", false
	}

	// If it already looks like a full Matrix ID, use it directly
	if strings.Contains(input, ":") {
		if !strings.HasPrefix(input, "@") {
			input = "@" + input
		}
		return id.UserID(input), true
	}

	// Strip leading @ for the search
	query := strings.TrimPrefix(input, "@")
	queryLower := strings.ToLower(query)

	d := db.Get()
	rows, err := d.Query(`SELECT user_id FROM user_stats`)
	if err != nil {
		return "", false
	}
	defer rows.Close()

	var exact []string
	var partial []string

	for rows.Next() {
		var uid string
		if err := rows.Scan(&uid); err != nil {
			continue
		}

		// Extract localpart: @localpart:server -> localpart
		localpart := uid
		if strings.HasPrefix(localpart, "@") {
			localpart = localpart[1:]
		}
		if idx := strings.Index(localpart, ":"); idx > 0 {
			localpart = localpart[:idx]
		}

		lower := strings.ToLower(localpart)

		if lower == queryLower {
			exact = append(exact, uid)
		} else if strings.Contains(lower, queryLower) {
			partial = append(partial, uid)
		}
	}

	// Exact localpart match — return it (even if multiple servers, prefer first)
	if len(exact) >= 1 {
		return id.UserID(exact[0]), true
	}

	// Single partial localpart match
	if len(partial) == 1 {
		return id.UserID(partial[0]), true
	}

	// Fall back to display name matching via room membership
	if len(roomIDs) > 0 {
		resp, err := b.Client.JoinedMembers(context.Background(), roomIDs[0])
		if err == nil {
			var dnExact []id.UserID
			var dnPartial []id.UserID
			for uid, member := range resp.Joined {
				if member.DisplayName == "" {
					continue
				}
				dn := strings.ToLower(member.DisplayName)
				if dn == queryLower {
					dnExact = append(dnExact, uid)
				} else if strings.Contains(dn, queryLower) {
					dnPartial = append(dnPartial, uid)
				}
			}
			if len(dnExact) >= 1 {
				return dnExact[0], true
			}
			if len(dnPartial) == 1 {
				return dnPartial[0], true
			}
		}
	}

	return "", false
}

// SendMessage sends a plain text message to a room.
func (b *Base) SendMessage(roomID id.RoomID, text string) error {
	content := &event.MessageEventContent{
		MsgType: event.MsgText,
		Body:    text,
	}
	_, err := b.Client.SendMessageEvent(context.Background(), roomID, event.EventMessage, content)
	if err != nil {
		slog.Error("failed to send message", "room", roomID, "err", err)
	}
	return err
}

// SendMessageID sends a plain text message and returns the event ID.
func (b *Base) SendMessageID(roomID id.RoomID, text string) (id.EventID, error) {
	content := &event.MessageEventContent{
		MsgType: event.MsgText,
		Body:    text,
	}
	resp, err := b.Client.SendMessageEvent(context.Background(), roomID, event.EventMessage, content)
	if err != nil {
		slog.Error("failed to send message", "room", roomID, "err", err)
		return "", err
	}
	return resp.EventID, nil
}

// SendThread sends a message in a thread rooted at threadID.
func (b *Base) SendThread(roomID id.RoomID, threadID id.EventID, text string) error {
	content := &event.MessageEventContent{
		MsgType: event.MsgText,
		Body:    text,
		RelatesTo: &event.RelatesTo{
			Type:    event.RelThread,
			EventID: threadID,
			InReplyTo: &event.InReplyTo{
				EventID: threadID,
			},
			IsFallingBack: true,
		},
	}
	_, err := b.Client.SendMessageEvent(context.Background(), roomID, event.EventMessage, content)
	if err != nil {
		slog.Error("failed to send thread message", "room", roomID, "err", err)
	}
	return err
}

// SendNotice sends an m.notice message to a room.
func (b *Base) SendNotice(roomID id.RoomID, text string) error {
	content := &event.MessageEventContent{
		MsgType: event.MsgNotice,
		Body:    text,
	}
	_, err := b.Client.SendMessageEvent(context.Background(), roomID, event.EventMessage, content)
	return err
}

// SendReply sends a reply to a specific event.
func (b *Base) SendReply(roomID id.RoomID, eventID id.EventID, text string) error {
	content := &event.MessageEventContent{
		MsgType: event.MsgText,
		Body:    text,
		RelatesTo: &event.RelatesTo{
			InReplyTo: &event.InReplyTo{
				EventID: eventID,
			},
		},
	}
	_, err := b.Client.SendMessageEvent(context.Background(), roomID, event.EventMessage, content)
	if err != nil {
		slog.Error("failed to send reply", "room", roomID, "err", err)
	}
	return err
}

// SendHTML sends an HTML-formatted message.
func (b *Base) SendHTML(roomID id.RoomID, plain, html string) error {
	content := &event.MessageEventContent{
		MsgType:       event.MsgText,
		Body:          plain,
		Format:        event.FormatHTML,
		FormattedBody: html,
	}
	_, err := b.Client.SendMessageEvent(context.Background(), roomID, event.EventMessage, content)
	return err
}

// SendReact sends a reaction emoji to an event.
func (b *Base) SendReact(roomID id.RoomID, eventID id.EventID, emoji string) error {
	content := &event.ReactionEventContent{
		RelatesTo: event.RelatesTo{
			Type:    event.RelAnnotation,
			EventID: eventID,
			Key:     emoji,
		},
	}
	_, err := b.Client.SendMessageEvent(context.Background(), roomID, event.EventReaction, content)
	return err
}

// SendDM sends a direct message to a user. Creates a DM room if needed.
func (b *Base) SendDM(userID id.UserID, text string) error {
	resp, err := b.Client.CreateRoom(context.Background(), &mautrix.ReqCreateRoom{
		Preset:   "trusted_private_chat",
		Invite:   []id.UserID{userID},
		IsDirect: true,
		InitialState: []*event.Event{
			{
				Type: event.StateEncryption,
				Content: event.Content{
					Parsed: &event.EncryptionEventContent{
						Algorithm: id.AlgorithmMegolmV1,
					},
				},
			},
		},
	})
	if err != nil {
		return fmt.Errorf("create DM room: %w", err)
	}
	return b.SendMessage(resp.RoomID, text)
}

// UploadContent uploads data to the Matrix content repository and returns the MXC URI.
func (b *Base) UploadContent(data []byte, contentType, filename string) (id.ContentURI, error) {
	resp, err := b.Client.UploadBytesWithName(context.Background(), data, contentType, filename)
	if err != nil {
		return id.ContentURI{}, err
	}
	return resp.ContentURI, nil
}

// SendImage uploads image data and sends it as an m.image message with a caption.
func (b *Base) SendImage(roomID id.RoomID, imgData []byte, filename, caption string, width, height int) error {
	uri, err := b.UploadContent(imgData, "image/png", filename)
	if err != nil {
		return fmt.Errorf("upload image: %w", err)
	}
	content := &event.MessageEventContent{
		MsgType:  event.MsgImage,
		Body:     caption,
		FileName: filename,
		URL:      uri.CUString(),
		Info: &event.FileInfo{
			MimeType: "image/png",
			Size:     len(imgData),
			Width:    width,
			Height:   height,
		},
	}
	_, err = b.Client.SendMessageEvent(context.Background(), roomID, event.EventMessage, content)
	return err
}