mirror of
https://github.com/VCMP-SqMod/SqMod.git
synced 2024-11-08 16:57:16 +01:00
1112 lines
30 KiB
C
1112 lines
30 KiB
C
|
/************************************************************************************
|
||
|
*
|
||
|
* D++, A Lightweight C++ library for Discord
|
||
|
*
|
||
|
* Copyright 2021 Craig Edwards and D++ contributors
|
||
|
* (https://github.com/brainboxdotcc/DPP/graphs/contributors)
|
||
|
*
|
||
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||
|
* you may not use this file except in compliance with the License.
|
||
|
* You may obtain a copy of the License at
|
||
|
*
|
||
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||
|
*
|
||
|
* Unless required by applicable law or agreed to in writing, software
|
||
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||
|
* See the License for the specific language governing permissions and
|
||
|
* limitations under the License.
|
||
|
*
|
||
|
************************************************************************************/
|
||
|
#pragma once
|
||
|
#include <dpp/export.h>
|
||
|
#include <dpp/discord.h>
|
||
|
#include <optional>
|
||
|
#include <dpp/json_fwd.hpp>
|
||
|
|
||
|
namespace dpp {
|
||
|
|
||
|
/**
|
||
|
* @brief Represents the type of a component
|
||
|
*/
|
||
|
enum component_type : uint8_t {
|
||
|
/// Action row, a container for other components
|
||
|
cot_action_row = 1,
|
||
|
/// Clickable button
|
||
|
cot_button = 2,
|
||
|
/// Select menu
|
||
|
cot_selectmenu = 3
|
||
|
};
|
||
|
|
||
|
/**
|
||
|
* @brief Represents the style of a button
|
||
|
*/
|
||
|
enum component_style : uint8_t {
|
||
|
/// Blurple
|
||
|
cos_primary = 1,
|
||
|
/// Grey
|
||
|
cos_secondary,
|
||
|
/// Green
|
||
|
cos_success,
|
||
|
/// Red
|
||
|
cos_danger,
|
||
|
/// An external hyperlink to a website
|
||
|
cos_link
|
||
|
};
|
||
|
|
||
|
struct CoreExport select_option {
|
||
|
std::string label;
|
||
|
std::string value;
|
||
|
std::string description;
|
||
|
bool is_default;
|
||
|
/** Emoji definition. To set an emoji on your button
|
||
|
* you must set one of either the name or id fields.
|
||
|
* The easiest way is to use the component::set_emoji
|
||
|
* method.
|
||
|
*/
|
||
|
struct inner_select_emoji {
|
||
|
/** Set the name field to the name of the emoji.
|
||
|
* For built in unicode emojis, set this to the
|
||
|
* actual unicode value of the emoji e.g. "😄"
|
||
|
* and not for example ":smile:"
|
||
|
*/
|
||
|
std::string name;
|
||
|
/** The emoji ID value for emojis that are custom
|
||
|
* ones belonging to a guild. The same rules apply
|
||
|
* as with other emojis, that the bot must be on
|
||
|
* the guild where the emoji resides and it must
|
||
|
* be available for use (e.g. not disabled due to
|
||
|
* lack of boosts etc)
|
||
|
*/
|
||
|
dpp::snowflake id = 0;
|
||
|
/** True if the emoji is animated. Only applies to
|
||
|
* custom emojis.
|
||
|
*/
|
||
|
bool animated = false;
|
||
|
} emoji;
|
||
|
|
||
|
select_option();
|
||
|
|
||
|
select_option(const std::string &label, const std::string &value, const std::string &description = "");
|
||
|
|
||
|
select_option& set_label(const std::string &l);
|
||
|
|
||
|
select_option& set_value(const std::string &v);
|
||
|
|
||
|
select_option& set_description(const std::string &d);
|
||
|
|
||
|
select_option& set_emoji(const std::string &n, dpp::snowflake id = 0, bool animated = false);
|
||
|
|
||
|
select_option& set_default(bool def);
|
||
|
|
||
|
select_option& set_animated(bool anim);
|
||
|
};
|
||
|
|
||
|
/**
|
||
|
* @brief Represents the component object.
|
||
|
* A component is a clickable button or drop down list
|
||
|
* within a discord message, where the buttons emit
|
||
|
* on_button_click events when the user interacts with
|
||
|
* them.
|
||
|
*
|
||
|
* You should generally define one component object and
|
||
|
* then insert one or more additional components into it
|
||
|
* using component::add_component(), so that the parent
|
||
|
* object is an action row and the child objects are buttons.
|
||
|
*
|
||
|
* @note At present this only works for whitelisted
|
||
|
* guilds. The beta is **closed**. When this feature is
|
||
|
* released, then the functionality will work correctly.
|
||
|
*/
|
||
|
class CoreExport component {
|
||
|
public:
|
||
|
/** Component type, either a button or action row
|
||
|
*/
|
||
|
component_type type;
|
||
|
|
||
|
/** Sub commponents, buttons on an action row
|
||
|
*/
|
||
|
std::vector<component> components;
|
||
|
|
||
|
/** Component label (for buttons).
|
||
|
* Maximum of 80 characters.
|
||
|
*/
|
||
|
std::string label;
|
||
|
|
||
|
/** Component style (for buttons)
|
||
|
*/
|
||
|
component_style style;
|
||
|
|
||
|
/** Component id (for buttons).
|
||
|
* Maximum of 100 characters.
|
||
|
*/
|
||
|
std::string custom_id;
|
||
|
|
||
|
/** URL for link types (dpp::cos_link).
|
||
|
* Maximum of 512 characters.
|
||
|
*/
|
||
|
std::string url;
|
||
|
|
||
|
/** Placeholder text for select menus
|
||
|
*/
|
||
|
std::string placeholder;
|
||
|
|
||
|
/** Minimum number of selectable values for a select menu.
|
||
|
* -1 to not set this
|
||
|
*/
|
||
|
int32_t min_values;
|
||
|
|
||
|
/** Maximum number of selectable values for a select menu.
|
||
|
* -1 to not set this.
|
||
|
*/
|
||
|
int32_t max_values;
|
||
|
|
||
|
/** Select options for select menus
|
||
|
*/
|
||
|
std::vector<select_option> options;
|
||
|
|
||
|
/** Disabled flag (for buttons)
|
||
|
*/
|
||
|
bool disabled;
|
||
|
|
||
|
/** Emoji definition. To set an emoji on your button
|
||
|
* you must set one of either the name or id fields.
|
||
|
* The easiest way is to use the component::set_emoji
|
||
|
* method.
|
||
|
*/
|
||
|
struct inner_emoji {
|
||
|
/** Set the name field to the name of the emoji.
|
||
|
* For built in unicode emojis, set this to the
|
||
|
* actual unicode value of the emoji e.g. "😄"
|
||
|
* and not for example ":smile:"
|
||
|
*/
|
||
|
std::string name;
|
||
|
/** The emoji ID value for emojis that are custom
|
||
|
* ones belonging to a guild. The same rules apply
|
||
|
* as with other emojis, that the bot must be on
|
||
|
* the guild where the emoji resides and it must
|
||
|
* be available for use (e.g. not disabled due to
|
||
|
* lack of boosts etc)
|
||
|
*/
|
||
|
dpp::snowflake id;
|
||
|
/** True if the emoji is animated. Only applies to
|
||
|
* custom emojis.
|
||
|
*/
|
||
|
bool animated;
|
||
|
} emoji;
|
||
|
|
||
|
/** Constructor
|
||
|
*/
|
||
|
component();
|
||
|
|
||
|
/** Destructor
|
||
|
*/
|
||
|
~component() = default;
|
||
|
|
||
|
/**
|
||
|
* @brief Set the type of the component. Button components
|
||
|
* (type dpp::cot_button) should always be contained within
|
||
|
* an action row (type dpp::cot_action_row). As described
|
||
|
* below, many of the other methods automatically set this
|
||
|
* to the correct type so usually you should not need to
|
||
|
* manually call component::set_type().
|
||
|
*
|
||
|
* @param ct The component type
|
||
|
* @return component& reference to self
|
||
|
*/
|
||
|
component& set_type(component_type ct);
|
||
|
|
||
|
/**
|
||
|
* @brief Set the label of the component, e.g. button text.
|
||
|
* For action rows, this field is ignored. Setting the
|
||
|
* label will auto-set the type to dpp::cot_button.
|
||
|
*
|
||
|
* @param label Label text to set
|
||
|
* @return component& Reference to self
|
||
|
*/
|
||
|
component& set_label(const std::string &label);
|
||
|
|
||
|
/**
|
||
|
* @brief Set the url for dpp::cos_link types.
|
||
|
* Calling this function sets the style to dpp::cos_link
|
||
|
* and the type to dpp::cot_button.
|
||
|
*
|
||
|
* @param url URL to set, maximum length of 512 characters
|
||
|
* @return component& reference to self.
|
||
|
*/
|
||
|
component& set_url(const std::string &url);
|
||
|
|
||
|
/**
|
||
|
* @brief Set the style of the component, e.g. button colour.
|
||
|
* For action rows, this field is ignored. Setting the
|
||
|
* style will auto-set the type to dpp::cot_button.
|
||
|
*
|
||
|
* @param cs Component style to set
|
||
|
* @return component& reference to self
|
||
|
*/
|
||
|
component& set_style(component_style cs);
|
||
|
|
||
|
/**
|
||
|
* @brief Set the id of the component.
|
||
|
* For action rows, this field is ignored. Setting the
|
||
|
* id will auto-set the type to dpp::cot_button.
|
||
|
*
|
||
|
* @param id Custom ID string to set. This ID will be sent
|
||
|
* for any on_button_click events related to the button.
|
||
|
* @return component& Reference to self
|
||
|
*/
|
||
|
component& set_id(const std::string &id);
|
||
|
|
||
|
/**
|
||
|
* @brief Set the component to disabled.
|
||
|
* Defaults to false on all created components.
|
||
|
*
|
||
|
* @param disable True to disable, false to disable.
|
||
|
* @return component&
|
||
|
*/
|
||
|
component& set_disabled(bool disable);
|
||
|
|
||
|
|
||
|
component& set_placeholder(const std::string &placeholder);
|
||
|
|
||
|
component& set_min_values(uint32_t min_values);
|
||
|
|
||
|
component& set_max_values(uint32_t max_values);
|
||
|
|
||
|
component& add_select_option(const select_option &option);
|
||
|
|
||
|
/**
|
||
|
* @brief Add a sub-component, only valid for action rows.
|
||
|
* Adding subcomponents to a component will automatically
|
||
|
* set this component's type to dpp::cot_action_row.
|
||
|
*
|
||
|
* @param c The sub-component to add
|
||
|
* @return component& reference to self
|
||
|
*/
|
||
|
component& add_component(const component& c);
|
||
|
|
||
|
/**
|
||
|
* @brief Set the emoji of the current sub-component.
|
||
|
* Only valid for buttons. Adding an emoji to a component
|
||
|
* will automatically set this components type to
|
||
|
* dpp::cot_button. One or both of name and id must be set.
|
||
|
* For a built in unicode emoji, you only need set name,
|
||
|
* and should set it to a unicode character e.g. "😄".
|
||
|
* For custom emojis, set the name to the name of the emoji
|
||
|
* on the guild, and the id to the emoji's ID.
|
||
|
* Setting the animated boolean is only valid for custom
|
||
|
* emojis.
|
||
|
*
|
||
|
* @param name Emoji name, or unicode character to use
|
||
|
* @param id Emoji id, for custom emojis only.
|
||
|
* @param animated True if the custom emoji is animated.
|
||
|
* @return component& Reference to self
|
||
|
*/
|
||
|
component& set_emoji(const std::string& name, dpp::snowflake id = 0, bool animated = false);
|
||
|
|
||
|
/** Read class values from json object
|
||
|
* @param j A json object to read from
|
||
|
* @return A reference to self
|
||
|
*/
|
||
|
component& fill_from_json(nlohmann::json* j);
|
||
|
|
||
|
/** Build JSON from this object.
|
||
|
* @return The JSON text of the invite
|
||
|
*/
|
||
|
std::string build_json() const;
|
||
|
|
||
|
};
|
||
|
|
||
|
/**
|
||
|
* @brief A footer in a dpp::embed
|
||
|
*/
|
||
|
struct CoreExport embed_footer {
|
||
|
/** Footer text */
|
||
|
std::string text;
|
||
|
/** Footer icon url */
|
||
|
std::string icon_url;
|
||
|
/** Proxied icon url */
|
||
|
std::string proxy_url;
|
||
|
|
||
|
/** Set footer's text. Returns footer itself so these methods may be "chained"
|
||
|
* @param t string to set as footer text
|
||
|
* @return A reference to self
|
||
|
*/
|
||
|
embed_footer& set_text(const std::string& t);
|
||
|
|
||
|
/** Set footer's icon url. Returns footer itself so these methods may be "chained"
|
||
|
* @param i url to set as footer icon url
|
||
|
* @return A reference to self
|
||
|
*/
|
||
|
embed_footer& set_icon(const std::string& i);
|
||
|
|
||
|
/** Set footer's proxied icon url. Returns footer itself so these methods may be "chained"
|
||
|
* @param p url to set as footer proxied icon url
|
||
|
* @return A reference to self
|
||
|
*/
|
||
|
embed_footer& set_proxy(const std::string& p);
|
||
|
};
|
||
|
|
||
|
/**
|
||
|
* @brief An video, image or thumbnail in a dpp::embed
|
||
|
*/
|
||
|
struct CoreExport embed_image {
|
||
|
/** URL to image or video */
|
||
|
std::string url;
|
||
|
/** Proxied image url */
|
||
|
std::string proxy_url;
|
||
|
/** Height (calculated by discord) */
|
||
|
std::string height;
|
||
|
/** Width (calculated by discord) */
|
||
|
std::string width;
|
||
|
};
|
||
|
|
||
|
/**
|
||
|
* @brief Embed provider in a dpp::embed. Received from discord but cannot be sent
|
||
|
*/
|
||
|
struct CoreExport embed_provider {
|
||
|
/** Provider name */
|
||
|
std::string name;
|
||
|
/** Provider URL */
|
||
|
std::string url;
|
||
|
};
|
||
|
|
||
|
/**
|
||
|
* @brief Author within a dpp::embed object
|
||
|
*/
|
||
|
struct CoreExport embed_author {
|
||
|
/** Author name */
|
||
|
std::string name;
|
||
|
/** Author url */
|
||
|
std::string url;
|
||
|
/** Author icon url */
|
||
|
std::string icon_url;
|
||
|
/** Proxied icon url */
|
||
|
std::string proxy_icon_url;
|
||
|
};
|
||
|
|
||
|
/**
|
||
|
* @brief A dpp::embed may contain zero or more fields
|
||
|
*/
|
||
|
struct CoreExport embed_field {
|
||
|
/** Name of field */
|
||
|
std::string name;
|
||
|
/** Value of field (max length 1000) */
|
||
|
std::string value;
|
||
|
/** True if the field is to be displayed inline */
|
||
|
bool is_inline;
|
||
|
};
|
||
|
|
||
|
/**
|
||
|
* @brief A rich embed for display within a dpp::message
|
||
|
*/
|
||
|
struct CoreExport embed {
|
||
|
/** Optional: title of embed */
|
||
|
std::string title;
|
||
|
/** Optional: type of embed (always "rich" for webhook embeds) */
|
||
|
std::string type;
|
||
|
/** Optional: description of embed */
|
||
|
std::string description;
|
||
|
/** Optional: url of embed */
|
||
|
std::string url;
|
||
|
/** Optional: timestamp of embed content */
|
||
|
time_t timestamp;
|
||
|
/** Optional: color code of the embed */
|
||
|
uint32_t color;
|
||
|
/** Optional: footer information */
|
||
|
std::optional<embed_footer> footer;
|
||
|
/** Optional: image information */
|
||
|
std::optional<embed_image> image;
|
||
|
/** Optional: thumbnail information */
|
||
|
std::optional<embed_image> thumbnail;
|
||
|
/** Optional: video information (can't send these) */
|
||
|
std::optional<embed_image> video;
|
||
|
/** Optional: provider information (can't send these) */
|
||
|
std::optional<embed_provider> provider;
|
||
|
/** Optional: author information */
|
||
|
std::optional<embed_author> author;
|
||
|
/** Optional: fields information */
|
||
|
std::vector<embed_field> fields;
|
||
|
|
||
|
/** Constructor */
|
||
|
embed();
|
||
|
|
||
|
/** Constructor to build embed from json object
|
||
|
* @param j JSON to read content from
|
||
|
*/
|
||
|
embed(nlohmann::json* j);
|
||
|
|
||
|
/** Destructor */
|
||
|
~embed();
|
||
|
|
||
|
/** Set embed title. Returns the embed itself so these method calls may be "chained"
|
||
|
* @param text The text of the title
|
||
|
* @return A reference to self
|
||
|
*/
|
||
|
embed& set_title(const std::string &text);
|
||
|
|
||
|
/** Set embed description. Returns the embed itself so these method calls may be "chained"
|
||
|
* @param text The text of the title
|
||
|
* @return A reference to self
|
||
|
*/
|
||
|
embed& set_description(const std::string &text);
|
||
|
|
||
|
/**
|
||
|
* @brief Set the footer of the embed
|
||
|
*
|
||
|
* @param f the footer to set
|
||
|
* @return embed& a reference to self
|
||
|
*/
|
||
|
embed& set_footer(const embed_footer& f);
|
||
|
|
||
|
/** Set embed colour. Returns the embed itself so these method calls may be "chained"
|
||
|
* @param col The colour of the embed
|
||
|
* @return A reference to self
|
||
|
*/
|
||
|
embed& set_color(uint32_t col);
|
||
|
|
||
|
/** Set embed url. Returns the embed itself so these method calls may be "chained"
|
||
|
* @param url the url of the embed
|
||
|
* @return A reference to self
|
||
|
*/
|
||
|
embed& set_url(const std::string &url);
|
||
|
|
||
|
/** Add an embed field. Returns the embed itself so these method calls may be "chained"
|
||
|
* @param name The name of the field
|
||
|
* @param value The value of the field (max length 1000)
|
||
|
* @param is_inline Wether or not to display the field 'inline' or on its own line
|
||
|
* @return A reference to self
|
||
|
*/
|
||
|
embed& add_field(const std::string& name, const std::string &value, bool is_inline = false);
|
||
|
|
||
|
/** Set embed author. Returns the embed itself so these method calls may be "chained"
|
||
|
* @param a The author to set
|
||
|
* @return A reference to self
|
||
|
*/
|
||
|
embed& set_author(const dpp::embed_author& a);
|
||
|
|
||
|
/** Set embed author. Returns the embed itself so these method calls may be "chained"
|
||
|
* @param name The name of the author
|
||
|
* @param url The url of the author
|
||
|
* @param icon_url The icon URL of the author
|
||
|
* @return A reference to self
|
||
|
*/
|
||
|
embed& set_author(const std::string& name, const std::string& url, const std::string& icon_url);
|
||
|
|
||
|
/** Set embed provider. Returns the embed itself so these method calls may be "chained"
|
||
|
* @param name The provider name
|
||
|
* @param url The provider url
|
||
|
* @return A reference to self
|
||
|
*/
|
||
|
embed& set_provider(const std::string& name, const std::string& url);
|
||
|
|
||
|
/** Set embed image. Returns the embed itself so these method calls may be "chained"
|
||
|
* @param url The embed image URL
|
||
|
* @return A reference to self
|
||
|
*/
|
||
|
embed& set_image(const std::string& url);
|
||
|
|
||
|
/** Set embed video. Returns the embed itself so these method calls may be "chained"
|
||
|
* @param url The embed video url
|
||
|
* @return A reference to self
|
||
|
*/
|
||
|
embed& set_video(const std::string& url);
|
||
|
|
||
|
/** Set embed thumbnail. Returns the embed itself so these method calls may be "chained"
|
||
|
* @param url The embed thumbnail url
|
||
|
* @return A reference to self
|
||
|
*/
|
||
|
embed& set_thumbnail(const std::string& url);
|
||
|
};
|
||
|
|
||
|
/**
|
||
|
* @brief Represets a reaction to a dpp::message
|
||
|
*/
|
||
|
struct CoreExport reaction {
|
||
|
/** Number of times this reaction has been added */
|
||
|
uint32_t count;
|
||
|
/** Reaction was from the bot's id */
|
||
|
bool me;
|
||
|
/** ID of emoji for reaction */
|
||
|
snowflake emoji_id;
|
||
|
/** Name of emoji, if applicable */
|
||
|
std::string emoji_name;
|
||
|
|
||
|
/**
|
||
|
* @brief Constructs a new reaction object.
|
||
|
*/
|
||
|
reaction();
|
||
|
|
||
|
/**
|
||
|
* @brief Constructs a new reaction object from a JSON object.
|
||
|
* @param j The JSON to read data from
|
||
|
*/
|
||
|
reaction(nlohmann::json* j);
|
||
|
|
||
|
/**
|
||
|
* @brief Destructs the reaction object.
|
||
|
*/
|
||
|
~reaction() = default;
|
||
|
};
|
||
|
|
||
|
/**
|
||
|
* @brief Represents an attachment in a dpp::message
|
||
|
*/
|
||
|
struct CoreExport attachment {
|
||
|
/** ID of attachment */
|
||
|
snowflake id;
|
||
|
/** Size of the attachment in bytes */
|
||
|
uint32_t size;
|
||
|
/** File name of the attachment */
|
||
|
std::string filename;
|
||
|
/** URL which points to the attachment */
|
||
|
std::string url;
|
||
|
/** Proxied URL which points to the attachment */
|
||
|
std::string proxy_url;
|
||
|
/** Width of the attachment, if applicable */
|
||
|
uint32_t width;
|
||
|
/** Height of the attachment, if applicable */
|
||
|
uint32_t height;
|
||
|
/** MIME type of the attachment, if applicable */
|
||
|
std::string content_type;
|
||
|
|
||
|
/**
|
||
|
* @brief Constructs a new attachment object.
|
||
|
*/
|
||
|
attachment();
|
||
|
|
||
|
/**
|
||
|
* @brief Constructs a new attachment object from a JSON object.
|
||
|
* @param j JSON to read information from
|
||
|
*/
|
||
|
attachment(nlohmann::json* j);
|
||
|
|
||
|
/**
|
||
|
* @brief Destructs the attachment object.
|
||
|
*/
|
||
|
~attachment() = default;
|
||
|
};
|
||
|
|
||
|
enum sticker_type : uint8_t {
|
||
|
/// Nitro pack sticker
|
||
|
st_standard = 1,
|
||
|
/// Guild sticker
|
||
|
st_guild = 2
|
||
|
};
|
||
|
|
||
|
/**
|
||
|
* @brief The file format (png, apng, lottie) of a sticker
|
||
|
*/
|
||
|
enum sticker_format : uint8_t {
|
||
|
sf_png = 1,
|
||
|
sf_apng = 2,
|
||
|
sf_lottie = 3
|
||
|
};
|
||
|
|
||
|
/**
|
||
|
* @brief Represents stickers received in messages
|
||
|
*/
|
||
|
struct CoreExport sticker {
|
||
|
/** @brief The ID of the sticker
|
||
|
*/
|
||
|
snowflake id;
|
||
|
/** Optional: for standard stickers, id of the pack the sticker is from
|
||
|
*/
|
||
|
snowflake pack_id;
|
||
|
/** The name of the sticker */
|
||
|
std::string name;
|
||
|
/// description of the sticker (may be empty)
|
||
|
std::string description;
|
||
|
/** for guild stickers, the Discord name of a unicode emoji representing the sticker's expression.
|
||
|
* for standard stickers, a comma-separated list of related expressions.
|
||
|
*/
|
||
|
std::string tags;
|
||
|
/**
|
||
|
* @brief Asset ID
|
||
|
* @deprecated now an empty string but still sent by discord.
|
||
|
* While discord still send this empty string value we will still have a field
|
||
|
* here in the library.
|
||
|
*/
|
||
|
std::string asset;
|
||
|
/** The type of sticker */
|
||
|
sticker_type type;
|
||
|
/// type of sticker format
|
||
|
sticker_format format_type;
|
||
|
/// Optional: whether this guild sticker can be used, may be false due to loss of Server Boosts
|
||
|
bool available;
|
||
|
/// Optional: id of the guild that owns this sticker
|
||
|
snowflake guild_id;
|
||
|
/// Optional: the user that uploaded the guild sticker
|
||
|
user sticker_user;
|
||
|
/// Optional: the standard sticker's sort order within its pack
|
||
|
uint8_t sort_value;
|
||
|
/** Name of file to upload (when adding or editing a sticker) */
|
||
|
std::string filename;
|
||
|
/** File content to upload (raw binary) */
|
||
|
std::string filecontent;
|
||
|
|
||
|
/**
|
||
|
* @brief Construct a new sticker object
|
||
|
*/
|
||
|
sticker();
|
||
|
|
||
|
/** Read class values from json object
|
||
|
* @param j A json object to read from
|
||
|
* @return A reference to self
|
||
|
*/
|
||
|
sticker& fill_from_json(nlohmann::json* j);
|
||
|
|
||
|
/** Build JSON from this object.
|
||
|
* @param with_id True if the ID is to be set in the JSON structure
|
||
|
* @return The JSON text of the invite
|
||
|
*/
|
||
|
std::string build_json(bool with_id = true) const;
|
||
|
|
||
|
/**
|
||
|
* @brief Set the filename
|
||
|
*
|
||
|
* @param fn filename
|
||
|
* @return message& reference to self
|
||
|
*/
|
||
|
sticker& set_filename(const std::string &fn);
|
||
|
|
||
|
/**
|
||
|
* @brief Set the file content
|
||
|
*
|
||
|
* @param fc raw file content contained in std::string
|
||
|
* @return message& reference to self
|
||
|
*/
|
||
|
sticker& set_file_content(const std::string &fc);
|
||
|
|
||
|
};
|
||
|
|
||
|
struct CoreExport sticker_pack {
|
||
|
/// id of the sticker pack
|
||
|
snowflake id;
|
||
|
/// the stickers in the pack
|
||
|
std::map<snowflake, sticker> stickers;
|
||
|
/// name of the sticker pack
|
||
|
std::string name;
|
||
|
/// id of the pack's SKU
|
||
|
snowflake sku_id;
|
||
|
/// Optional: id of a sticker in the pack which is shown as the pack's icon
|
||
|
snowflake cover_sticker_id;
|
||
|
/// description of the sticker pack
|
||
|
std::string description;
|
||
|
/// id of the sticker pack's banner image
|
||
|
snowflake banner_asset_id;
|
||
|
|
||
|
/**
|
||
|
* @brief Construct a new sticker pack object
|
||
|
*/
|
||
|
sticker_pack();
|
||
|
|
||
|
/** Read class values from json object
|
||
|
* @param j A json object to read from
|
||
|
* @return A reference to self
|
||
|
*/
|
||
|
sticker_pack& fill_from_json(nlohmann::json* j);
|
||
|
|
||
|
/** Build JSON from this object.
|
||
|
* @param with_id True if the ID is to be set in the JSON structure
|
||
|
* @return The JSON text of the invite
|
||
|
*/
|
||
|
std::string build_json(bool with_id = true) const;
|
||
|
|
||
|
};
|
||
|
|
||
|
/**
|
||
|
* @brief Bitmask flags for a dpp::message
|
||
|
*/
|
||
|
enum message_flags {
|
||
|
/// this message has been published to subscribed channels (via Channel Following)
|
||
|
m_crossposted = 1 << 0,
|
||
|
/// this message originated from a message in another channel (via Channel Following)
|
||
|
m_is_crosspost = 1 << 1,
|
||
|
/// do not include any embeds when serializing this message
|
||
|
m_supress_embeds = 1 << 2,
|
||
|
/// the source message for this crosspost has been deleted (via Channel Following)
|
||
|
m_source_message_deleted = 1 << 3,
|
||
|
/// this message came from the urgent message system
|
||
|
m_urgent = 1 << 4,
|
||
|
/// this message is only visible to the user who invoked the Interaction
|
||
|
m_ephemeral = 1 << 6,
|
||
|
/// this message is an Interaction Response and the bot is "thinking"
|
||
|
m_loading = 1 << 7
|
||
|
};
|
||
|
|
||
|
/**
|
||
|
* @brief Mesage types for dpp::message::type
|
||
|
*/
|
||
|
enum message_type {
|
||
|
/// Default
|
||
|
mt_default = 0,
|
||
|
/// Add recipient
|
||
|
mt_recipient_add = 1,
|
||
|
/// Remove recipient
|
||
|
mt_recipient_remove = 2,
|
||
|
/// Call
|
||
|
mt_call = 3,
|
||
|
/// Channel name change
|
||
|
mt_channel_name_change = 4,
|
||
|
/// Channel icon change
|
||
|
mt_channel_icon_change = 5,
|
||
|
/// Message pinned
|
||
|
mt_channel_pinned_message = 6,
|
||
|
/// Member joined
|
||
|
mt_guild_member_join = 7,
|
||
|
/// Boost
|
||
|
mt_user_premium_guild_subscription = 8,
|
||
|
/// Boost level 1
|
||
|
mt_user_premium_guild_subscription_tier_1 = 9,
|
||
|
/// Boost level 2
|
||
|
mt_user_premium_guild_subscription_tier_2 = 10,
|
||
|
/// Boost level 3
|
||
|
mt_user_premium_guild_subscription_tier_3 = 11,
|
||
|
/// Follow channel
|
||
|
mt_channel_follow_add = 12,
|
||
|
/// Disqualified from discovery
|
||
|
mt_guild_discovery_disqualified = 14,
|
||
|
/// Re-qualified for discovery
|
||
|
mt_guild_discovery_requalified = 15,
|
||
|
/// Discovery grace period warning 1
|
||
|
mt_guild_discovery_grace_period_initial_warning = 16,
|
||
|
/// Discovery grace period warning 2
|
||
|
mt_guild_discovery_grace_period_final_warning = 17,
|
||
|
/// Thread Created
|
||
|
mt_thread_created = 18,
|
||
|
/// Reply
|
||
|
mt_reply = 19,
|
||
|
/// Application command
|
||
|
mt_application_command = 20,
|
||
|
/// Thread starter message
|
||
|
mt_thread_starter_message = 21,
|
||
|
/// Invite reminder
|
||
|
mt_guild_invite_reminder = 22
|
||
|
};
|
||
|
|
||
|
enum cache_policy_setting_t {
|
||
|
/**
|
||
|
* @brief request aggressively on seeing new guilds, and also store missing data from messages.
|
||
|
* This is the default behaviour.
|
||
|
*/
|
||
|
cp_aggressive = 0,
|
||
|
/**
|
||
|
* @brief only cache when there is relavent activity, e.g. a message to the bot.
|
||
|
*/
|
||
|
cp_lazy = 1,
|
||
|
/**
|
||
|
* @brief Don't cache anything. Fill details when we see them.
|
||
|
* (NOT IMPLEMENTED YET)
|
||
|
*/
|
||
|
cp_none = 2
|
||
|
};
|
||
|
|
||
|
/**
|
||
|
* @brief Represents the caching policy of the cluster.
|
||
|
*
|
||
|
* Channels and guilds are always cached as these caches are used
|
||
|
* interally by the library. The memory usage of these is minimal.
|
||
|
*
|
||
|
* All default to 'aggressive' which means to actively attempt to cache,
|
||
|
* going out of the way to fill the caches completely. On large bots this
|
||
|
* can take a LOT of RAM.
|
||
|
*/
|
||
|
struct CoreExport cache_policy_t {
|
||
|
/**
|
||
|
* @brief Caching policy for users and guild members
|
||
|
*/
|
||
|
cache_policy_setting_t user_policy = cp_aggressive;
|
||
|
|
||
|
/**
|
||
|
* @brief Caching policy for emojis
|
||
|
*/
|
||
|
cache_policy_setting_t emoji_policy = cp_aggressive;
|
||
|
|
||
|
/**
|
||
|
* @brief Caching policy for roles
|
||
|
*/
|
||
|
cache_policy_setting_t role_policy = cp_aggressive;
|
||
|
};
|
||
|
|
||
|
/**
|
||
|
* @brief Represents messages sent and received on Discord
|
||
|
*/
|
||
|
struct CoreExport message {
|
||
|
/** id of the message */
|
||
|
snowflake id;
|
||
|
/** id of the channel the message was sent in */
|
||
|
snowflake channel_id;
|
||
|
/** Optional: id of the guild the message was sent in */
|
||
|
snowflake guild_id;
|
||
|
/** the author of this message (not guaranteed to be a valid user) */
|
||
|
user* author;
|
||
|
/** Optional: member properties for this message's author */
|
||
|
guild_member member;
|
||
|
/** contents of the message */
|
||
|
std::string content;
|
||
|
/** message components */
|
||
|
std::vector<dpp::component> components;
|
||
|
/** when this message was sent */
|
||
|
time_t sent;
|
||
|
/** when this message was edited (may be 0 if never edited) */
|
||
|
time_t edited;
|
||
|
/** whether this was a TTS message */
|
||
|
bool tts;
|
||
|
/** whether this message mentions everyone */
|
||
|
bool mention_everyone;
|
||
|
/** users specifically mentioned in the message */
|
||
|
std::vector<snowflake> mentions;
|
||
|
/** roles specifically mentioned in this message */
|
||
|
std::vector<snowflake> mention_roles;
|
||
|
/** Optional: channels specifically mentioned in this message */
|
||
|
std::vector<snowflake> mention_channels;
|
||
|
/** any attached files */
|
||
|
std::vector<attachment> attachments;
|
||
|
/** zero or more dpp::embed objects */
|
||
|
std::vector<embed> embeds;
|
||
|
/** Optional: reactions to the message */
|
||
|
std::vector<reaction> reactions;
|
||
|
/** Optional: used for validating a message was sent */
|
||
|
std::string nonce;
|
||
|
/** whether this message is pinned */
|
||
|
bool pinned;
|
||
|
/** Optional: if the message is generated by a webhook, its id will be here otherwise the field will be 0 */
|
||
|
snowflake webhook_id;
|
||
|
/** Flags */
|
||
|
uint8_t flags;
|
||
|
/** Stickers */
|
||
|
std::vector<sticker> stickers;
|
||
|
|
||
|
/** Name of file to upload (for use server-side in discord's url) */
|
||
|
std::string filename;
|
||
|
|
||
|
/** File content to upload (raw binary) */
|
||
|
std::string filecontent;
|
||
|
|
||
|
/** Message type */
|
||
|
uint8_t type;
|
||
|
|
||
|
/** Self allocated user for caching being off */
|
||
|
user self_author;
|
||
|
|
||
|
struct message_ref {
|
||
|
/// id of the originating message
|
||
|
snowflake message_id;
|
||
|
/// id of the originating message's channel
|
||
|
snowflake channel_id;
|
||
|
/// id of the originating message's guild
|
||
|
snowflake guild_id;
|
||
|
/// when sending, whether to error if the referenced message doesn't exist instead of sending as a normal (non-reply) message, default true
|
||
|
bool fail_if_not_exists;
|
||
|
} message_reference;
|
||
|
|
||
|
struct message_interaction_struct{
|
||
|
// id of the interaction
|
||
|
snowflake id;
|
||
|
// type of interaction
|
||
|
uint8_t type;
|
||
|
// name of the application command
|
||
|
std::string name;
|
||
|
// the user who invoked the interaction
|
||
|
user usr;
|
||
|
} interaction;
|
||
|
|
||
|
struct allowed_ref {
|
||
|
bool parse_users;
|
||
|
bool parse_everyone;
|
||
|
bool parse_roles;
|
||
|
bool replied_user;
|
||
|
std::vector<snowflake> users;
|
||
|
std::vector<snowflake> roles;
|
||
|
} allowed_mentions;
|
||
|
|
||
|
/**
|
||
|
* @brief Construct a new message object
|
||
|
*/
|
||
|
message();
|
||
|
|
||
|
/**
|
||
|
* @brief Destroy the message object
|
||
|
*/
|
||
|
~message();
|
||
|
|
||
|
/**
|
||
|
* @brief Construct a new message object with a channel and content
|
||
|
*
|
||
|
* @param channel_id The channel to send the message to
|
||
|
* @param content The content of the message
|
||
|
* @param type The message type to create
|
||
|
*/
|
||
|
message(snowflake channel_id, const std::string &content, message_type type = mt_default);
|
||
|
|
||
|
/**
|
||
|
* @brief Construct a new message object with a channel and content
|
||
|
*
|
||
|
* @param channel_id The channel to send the message to
|
||
|
* @param _embed An embed to send
|
||
|
*/
|
||
|
message(snowflake channel_id, const embed & _embed);
|
||
|
|
||
|
/**
|
||
|
* @brief Construct a new message object with content
|
||
|
*
|
||
|
* @param content The content of the message
|
||
|
* @param type The message type to create
|
||
|
*/
|
||
|
message(const std::string &content, message_type type = mt_default);
|
||
|
|
||
|
/**
|
||
|
* @brief Set the original message reference for replies/crossposts
|
||
|
*
|
||
|
* @param _message_id message id to reply to
|
||
|
* @param _guild_id guild id to reply to (optional)
|
||
|
* @param _channel_id channel id to reply to (optional)
|
||
|
* @param fail_if_not_exists true if the message send should fail if these values are invalid (optional)
|
||
|
* @return message& reference to self
|
||
|
*/
|
||
|
message& set_reference(snowflake _message_id, snowflake _guild_id = 0, snowflake _channel_id = 0, bool fail_if_not_exists = false);
|
||
|
|
||
|
/**
|
||
|
* @brief Set the allowed mentions object for pings on the message
|
||
|
*
|
||
|
* @param _parse_users wether or not to parse users in the message content or embeds
|
||
|
* @param _parse_roles wether or not to parse roles in the message content or embeds
|
||
|
* @param _parse_everyone wether or not to parse everyone/here in the message content or embeds
|
||
|
* @param _replied_user if set to true and this is a reply, then ping the user we reply to
|
||
|
* @param users list of user ids to allow pings for
|
||
|
* @param roles list of role ids to allow pings for
|
||
|
* @return message& reference to self
|
||
|
*/
|
||
|
message& set_allowed_mentions(bool _parse_users, bool _parse_roles, bool _parse_everyone, bool _replied_user, const std::vector<snowflake> &users, const std::vector<snowflake> &roles);
|
||
|
|
||
|
/** Fill this object from json.
|
||
|
* @param j JSON object to fill from
|
||
|
* @param cp Cache policy for user records, wether or not we cache users when a message is received
|
||
|
* @return A reference to self
|
||
|
*/
|
||
|
message& fill_from_json(nlohmann::json* j, cache_policy_t cp = {cp_aggressive, cp_aggressive, cp_aggressive});
|
||
|
|
||
|
/** Build JSON from this object.
|
||
|
* @param with_id True if the ID is to be included in the built JSON
|
||
|
* @return The JSON text of the message
|
||
|
*/
|
||
|
std::string build_json(bool with_id = false, bool is_interaction_response = false) const;
|
||
|
|
||
|
/**
|
||
|
* @brief Returns true if the message was crossposted to other servers
|
||
|
*
|
||
|
* @return true if crossposted
|
||
|
*/
|
||
|
bool is_crossposted() const;
|
||
|
|
||
|
/**
|
||
|
* @brief Returns true if posted from other servers news channel via webhook
|
||
|
*
|
||
|
* @return true if posted from other server
|
||
|
*/
|
||
|
bool is_crosspost() const;
|
||
|
|
||
|
/**
|
||
|
* @brief True if embeds have been removed
|
||
|
*
|
||
|
* @return true if embeds removed
|
||
|
*/
|
||
|
bool supress_embeds() const;
|
||
|
|
||
|
/**
|
||
|
* @brief True if source message was deleted
|
||
|
*
|
||
|
* @return true if source message deleted
|
||
|
*/
|
||
|
bool is_source_message_deleted() const;
|
||
|
|
||
|
/**
|
||
|
* @brief True if urgent
|
||
|
*
|
||
|
* @return true if urgent
|
||
|
*/
|
||
|
bool is_urgent() const;
|
||
|
|
||
|
/**
|
||
|
* @brief True if ephemeral (visible only to issuer of a slash command)
|
||
|
*
|
||
|
* @return true if ephemeral
|
||
|
*/
|
||
|
bool is_ephemeral() const;
|
||
|
|
||
|
/**
|
||
|
* @brief True if loading
|
||
|
*
|
||
|
* @return true if loading
|
||
|
*/
|
||
|
bool is_loading() const;
|
||
|
|
||
|
/**
|
||
|
* @brief Add a component (button) to message
|
||
|
*
|
||
|
* @param c component to add
|
||
|
* @return message& reference to self
|
||
|
*/
|
||
|
message& add_component(const component& c);
|
||
|
|
||
|
/**
|
||
|
* @brief Add an embed to message
|
||
|
*
|
||
|
* @param e embed to add
|
||
|
* @return message& reference to self
|
||
|
*/
|
||
|
message& add_embed(const embed& e);
|
||
|
|
||
|
/**
|
||
|
* @brief Set the flags
|
||
|
*
|
||
|
* @param f flags to set
|
||
|
* @return message& reference to self
|
||
|
*/
|
||
|
message& set_flags(uint8_t f);
|
||
|
|
||
|
/**
|
||
|
* @brief Set the message type
|
||
|
*
|
||
|
* @param t type to set
|
||
|
* @return message& reference to self
|
||
|
*/
|
||
|
message& set_type(message_type t);
|
||
|
|
||
|
/**
|
||
|
* @brief Set the filename
|
||
|
*
|
||
|
* @param fn filename
|
||
|
* @return message& reference to self
|
||
|
*/
|
||
|
message& set_filename(const std::string &fn);
|
||
|
|
||
|
/**
|
||
|
* @brief Set the file content
|
||
|
*
|
||
|
* @param fc raw file content contained in std::string
|
||
|
* @return message& reference to self
|
||
|
*/
|
||
|
message& set_file_content(const std::string &fc);
|
||
|
|
||
|
/**
|
||
|
* @brief Set the message content
|
||
|
*
|
||
|
* @param c message content
|
||
|
* @return message& reference to self
|
||
|
*/
|
||
|
message& set_content(const std::string &c);
|
||
|
};
|
||
|
|
||
|
/** A group of messages */
|
||
|
typedef std::unordered_map<snowflake, message> message_map;
|
||
|
|
||
|
/** A group of stickers */
|
||
|
typedef std::unordered_map<snowflake, sticker> sticker_map;
|
||
|
|
||
|
/** A group of sticker packs */
|
||
|
typedef std::unordered_map<snowflake, sticker_pack> sticker_pack_map;
|
||
|
|
||
|
};
|