mirror of
https://github.com/diamondburned/arikawa.git
synced 2024-09-12 05:06:28 +00:00
150 lines
4.2 KiB
Go
150 lines
4.2 KiB
Go
package api
|
|
|
|
import (
|
|
"github.com/diamondburned/arikawa/discord"
|
|
"github.com/diamondburned/arikawa/utils/httputil"
|
|
)
|
|
|
|
// React creates a reaction for the message.
|
|
//
|
|
// This endpoint requires the READ_MESSAGE_HISTORY permission to be present on
|
|
// the current user. Additionally, if nobody else has reacted to the message
|
|
// using this emoji, this endpoint requires the 'ADD_REACTIONS' permission to
|
|
// be present on the current user.
|
|
func (c *Client) React(channelID, messageID discord.Snowflake, emoji EmojiAPI) error {
|
|
var msgURL = EndpointChannels + channelID.String() +
|
|
"/messages/" + messageID.String() +
|
|
"/reactions/" + emoji + "/@me"
|
|
return c.FastRequest("PUT", msgURL)
|
|
}
|
|
|
|
// Unreact removes a reaction the current user has made for the message.
|
|
func (c *Client) Unreact(chID, msgID discord.Snowflake, emoji EmojiAPI) error {
|
|
return c.DeleteUserReaction(chID, msgID, 0, emoji)
|
|
}
|
|
|
|
// Reactions returns reactions up to the specified limit. It will paginate
|
|
// automatically.
|
|
//
|
|
// Max can be 0, in which case the function will try and fetch all reactions.
|
|
func (c *Client) Reactions(
|
|
channelID, messageID discord.Snowflake, max uint, emoji EmojiAPI) ([]discord.User, error) {
|
|
|
|
var users []discord.User
|
|
var after discord.Snowflake = 0
|
|
|
|
const hardLimit int = 100
|
|
|
|
for fetch := uint(hardLimit); max > 0; fetch = uint(hardLimit) {
|
|
if max > 0 {
|
|
if fetch > max {
|
|
fetch = max
|
|
}
|
|
max -= fetch
|
|
}
|
|
|
|
r, err := c.ReactionsRange(channelID, messageID, 0, after, fetch, emoji)
|
|
if err != nil {
|
|
return users, err
|
|
}
|
|
users = append(users, r...)
|
|
|
|
if len(r) < hardLimit {
|
|
break
|
|
}
|
|
|
|
after = r[hardLimit-1].ID
|
|
}
|
|
|
|
return users, nil
|
|
}
|
|
|
|
// ReactionsBefore gets all reactions before the passed user ID.
|
|
func (c *Client) ReactionsBefore(
|
|
channelID, messageID, before discord.Snowflake,
|
|
limit uint, emoji EmojiAPI) ([]discord.User, error) {
|
|
|
|
return c.ReactionsRange(channelID, messageID, before, 0, limit, emoji)
|
|
}
|
|
|
|
// Refer to ReactionsRange.
|
|
func (c *Client) ReactionsAfter(
|
|
channelID, messageID, after discord.Snowflake,
|
|
limit uint, emoji EmojiAPI) ([]discord.User, error) {
|
|
|
|
return c.ReactionsRange(channelID, messageID, 0, after, limit, emoji)
|
|
}
|
|
|
|
// ReactionsRange get users before and after IDs. Before, after, and limit are
|
|
// optional. A maximum limit of only 100 reactions could be returned.
|
|
func (c *Client) ReactionsRange(
|
|
channelID, messageID, before, after discord.Snowflake,
|
|
limit uint, emoji EmojiAPI) ([]discord.User, error) {
|
|
|
|
switch {
|
|
case limit == 0:
|
|
limit = 25
|
|
case limit > 100:
|
|
limit = 100
|
|
}
|
|
|
|
var param struct {
|
|
Before discord.Snowflake `schema:"before,omitempty"`
|
|
After discord.Snowflake `schema:"after,omitempty"`
|
|
|
|
Limit uint `schema:"limit"`
|
|
}
|
|
|
|
param.Before = before
|
|
param.After = after
|
|
param.Limit = limit
|
|
|
|
var users []discord.User
|
|
return users, c.RequestJSON(
|
|
&users, "GET", EndpointChannels+channelID.String()+
|
|
"/messages/"+messageID.String()+
|
|
"/reactions/"+emoji,
|
|
httputil.WithSchema(c, param),
|
|
)
|
|
}
|
|
|
|
// DeleteReaction deletes another user's reaction.
|
|
//
|
|
// This endpoint requires the MANAGE_MESSAGES permission to be present on the
|
|
// current user.
|
|
func (c *Client) DeleteUserReaction(
|
|
channelID, messageID, userID discord.Snowflake, emoji EmojiAPI) error {
|
|
|
|
var user = "@me"
|
|
if userID > 0 {
|
|
user = userID.String()
|
|
}
|
|
|
|
return c.FastRequest("DELETE", EndpointChannels+channelID.String()+
|
|
"/messages/"+messageID.String()+
|
|
"/reactions/"+emoji+"/"+user)
|
|
}
|
|
|
|
// DeleteReactions deletes all the reactions for a given emoji on a message.
|
|
//
|
|
// This endpoint requires the MANAGE_MESSAGES permission to be present on the
|
|
// current user.
|
|
// Fires a Message Reaction Remove Emoji Gateway event.
|
|
func (c *Client) DeleteReactions(
|
|
channelId, messageID discord.Snowflake, emoji EmojiAPI) error {
|
|
|
|
return c.FastRequest("DELETE", EndpointChannels+channelId.String()+
|
|
"/messages/"+messageID.String()+
|
|
"/reactions/"+emoji)
|
|
}
|
|
|
|
// DeleteAllReactions deletes all reactions on a message.
|
|
//
|
|
// This endpoint requires the MANAGE_MESSAGES permission to be present on the
|
|
// current user.
|
|
// Fires a Message Reaction Remove All Gateway event.
|
|
func (c *Client) DeleteAllReactions(channelID, messageID discord.Snowflake) error {
|
|
return c.FastRequest("DELETE", EndpointChannels+channelID.String()+
|
|
"/messages/"+messageID.String()+"/reactions/")
|
|
}
|