Method apiAdminSendMudmail

modules/mudmail/admin.go:107–176

apiAdminSendMudmail handles POST /admin/api/v1/mudmail Body: { "from_name": "...", "body": "...", "gold": 0, "user_id": 0 } If user_id == 0, sends to everyone.

(r *http.Request)

// Body: { "from_name": "...", "body": "...", "gold": 0, "user_id": 0 }
// If user_id == 0, sends to everyone.
func (m *MudmailModule) apiAdminSendMudmail(r *http.Request) (int, bool, any) {
	var req adminSendRequest
	if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
		return http.StatusBadRequest, false, map[string]string{"error": "invalid request body"}
	}
	if req.FromName == "" {
		return http.StatusBadRequest, false, map[string]string{"error": "from_name is required"}
	}
	if req.Body == "" {
		return http.StatusBadRequest, false, map[string]string{"error": "body is required"}
	}
	if req.Gold < 0 {
		return http.StatusBadRequest, false, map[string]string{"error": "gold must be non-negative"}
	}

	if req.UserId != 0 {
		var itm *items.Item
		if req.ItemId > 0 {
			newItem := items.New(req.ItemId)
			if newItem.ItemId == 0 {
				return http.StatusBadRequest, false, map[string]string{"error": "item_id not found"}
			}
			itm = &newItem
		}
		m.SendMudMail(req.UserId, req.FromName, req.Body, req.Gold, itm)
		return http.StatusOK, true, map[string]any{"sent_to": req.UserId}
	}

	// Broadcast to everyone.
	var broadcastItem *items.Item
	if req.ItemId > 0 {
		newItem := items.New(req.ItemId)
		if newItem.ItemId == 0 {
			return http.StatusBadRequest, false, map[string]string{"error": "item_id not found"}
		}
		broadcastItem = &newItem
	}
	msg := Message{
		FromName: req.FromName,
		Body:     req.Body,
		Gold:     req.Gold,
		Item:     broadcastItem,
		DateSent: time.Now(),
	}

	onlineIds := map[int]struct{}{}
	for _, u := range users.GetAllActiveUsers() {
		onlineIds[u.UserId] = struct{}{}
		inbox := m.inboxes[u.UserId]
		inbox = append(Inbox{msg}, inbox...)
		m.inboxes[u.UserId] = inbox
		m.save(u.UserId, inbox)
		u.Command(`inbox check`)
	}

	sentCount := len(onlineIds)

	users.SearchOfflineUsers(func(u *users.UserRecord) bool {