feat: new premium upsell button style (#1175)

include/dpp/appcommand.h

@@ -443,6 +443,9 @@ enum interaction_response_type {
 	 * @see https://discord.com/developers/docs/monetization/entitlements#premiumrequired-interaction-response
 	 * @note Not available for autocomplete and ping interactions.
 	 * @warning This response does not support using `content`, `embeds`, or `attachments`, so reply with no data when using this!
+	 *
+	 * @depreciated Replaced with buttons with a style of cos_premium
+	 * This interaction type may stop working at any point
 	 */
 	ir_premium_required = 10,
 };

include/dpp/message.h

@@ -166,29 +166,36 @@ enum text_style_type : uint8_t {
  */
 enum component_style : uint8_t {
 	/**
-	 * @brief Blurple
+	 * @brief Blurple; Primary
 	 */
 	cos_primary = 1,
 
 	/**
-	 * @brief Grey
+	 * @brief Grey; Secondary
 	 */
 	cos_secondary,
 
 	/**
-	 * @brief Green
+	 * @brief Green; Success
 	 */
 	cos_success,
 
 	/**
-	 * @brief Red
+	 * @brief Red; danger
 	 */
 	cos_danger,
 
 	/**
-	 * @brief An external hyperlink to a website
+	 * @brief An external hyperlink to a website, requires url to be set
+	 * @note Will not work unless url is set
 	 */
-	cos_link
+	cos_link,
+
+	/**
+	 * @brief Premium upsell button, requires sku_id to be set
+	 * @note Will not work unless sku is set
+	 */
+	cos_premium,
 };
 
 /**
@@ -387,6 +394,11 @@ class DPP_EXPORT component : public json_interface<component> {
 	 */
 	std::string url;
 
+	/**
+	 * @brief The SKU ID for premium upsell buttons
+	 */
+	dpp::snowflake sku_id;
+
 	/**
 	 * @brief Placeholder text for select menus and text inputs (max 150 characters)
 	 */
@@ -489,6 +501,17 @@ class DPP_EXPORT component : public json_interface<component> {
 	 */
 	component& set_type(component_type ct);
 
+	/**
+	 * @brief Set the SKU ID for a premium upsell button
+	 * This is only valid for premium upsell buttons of type
+	 * cos_premium. It indicates which premium package to
+	 * link to when the button is clicked.
+	 *
+	 * @param sku The SKU ID
+	 * @return component& reference to self
+	 */
+	component& set_sku_id(dpp::snowflake sku);
+
 	/**
 	 * @brief Set the text style of a text component
 	 * @note Sets type to `cot_text`
@@ -1869,6 +1892,8 @@ enum message_type {
 
 	/**
 	 * @brief Interaction premium upsell
+	 * @depreciated Replaced with buttons with a style of cos_premium
+	 * This message type may stop working at any point
 	 */
 	mt_interaction_premium_upsell = 26,
 

src/dpp/message.cpp

@@ -20,18 +20,11 @@
  ************************************************************************************/
 #include <algorithm>
 #include <dpp/message.h>
-#include <dpp/user.h>
-#include <dpp/channel.h>
-#include <dpp/guild.h>
 #include <dpp/cache.h>
 #include <dpp/json.h>
 #include <dpp/discordevents.h>
-#include <dpp/stringops.h>
-#include <dpp/exception.h>
 #include <dpp/cluster.h>
 
-
-
 namespace dpp {
 
 using json = nlohmann::json;
@@ -235,6 +228,12 @@ component& component::set_max_length(uint32_t max_l)
 	return *this;
 }
 
+component& component::set_sku_id(dpp::snowflake sku)
+{
+	sku_id = sku;
+	return *this;
+}
+
 void to_json(json& j, const attachment& a) {
 	if (a.id) {
 		j["id"] = a.id;
@@ -274,15 +273,20 @@ void to_json(json& j, const component& cp) {
 		}
 	}
 	if (cp.type == cot_button) {
-		j["label"] = cp.label;
+		if (!cp.label.empty()) {
+			j["label"] = cp.label;
+		}
 		j["style"] = int(cp.style);
-		if (cp.type == cot_button && cp.style != cos_link && !cp.custom_id.empty()) {
-			/* Links cannot have a custom id */
+		if (cp.style != cos_link && cp.style != cos_premium && !cp.custom_id.empty()) {
+			/* Links and premium upsell cannot have a custom id */
 			j["custom_id"] = cp.custom_id;
 		}
-		if (cp.type == cot_button && cp.style == cos_link && !cp.url.empty()) {
+		if (cp.style == cos_link && !cp.url.empty()) {
 			j["url"] = cp.url;
 		}
+		if (cp.style == cos_premium && !cp.sku_id.empty()) {
+			j["sku_id"] = cp.sku_id;
+		}
 		j["disabled"] = cp.disabled;
 
 		if (cp.emoji.id || !cp.emoji.name.empty()) {