feat, refactor: Added Pin permission, updated pin endpoints

include/dpp/permissions.h

@@ -265,6 +265,11 @@ enum permissions : uint64_t {
 	 * @brief Allows use of Clyde AI.
 	 */
 	p_use_clyde_ai = 0x0000800000000000,
+
+	/**
+	 * @brief Allows pinning and unpinning messages
+	 */
+	p_pin_messages = 0x0008000000000000,
 };
 
 /**

include/dpp/role.h

@@ -828,6 +828,15 @@ class DPP_EXPORT role : public managed, public json_interface<role> {
 	 */
 	bool has_use_clyde_ai() const;
 
+	/**
+	 * @brief True if has permission to use pin messages.
+	 *
+	 * @note Having the administrator permission causes this method to always return true
+	 * Channel specific overrides may apply to permissions.
+	 * @return bool True if user has the Pin Messages permission or is administrator.
+	 */
+	bool has_pin_messages() const;
+
 	/**
 	 * @brief Get guild members who have this role.
 	 *

src/dpp/cluster/message.cpp

@@ -153,7 +153,7 @@ void cluster::message_get_reactions(snowflake message_id, snowflake channel_id,
 
 
 void cluster::message_pin(snowflake channel_id, snowflake message_id, command_completion_event_t callback) {
-	rest_request<confirmation>(this, API_PATH "/channels", std::to_string(channel_id), "pins/" + std::to_string(message_id), m_put, "", callback);
+	rest_request<confirmation>(this, API_PATH "/channels", std::to_string(channel_id), "/messages/pins/" + std::to_string(message_id), m_put, "", std::move(callback));
 }
 
 void cluster::messages_get(snowflake channel_id, snowflake around, snowflake before, snowflake after, uint64_t limit, command_completion_event_t callback) {
@@ -168,7 +168,7 @@ void cluster::messages_get(snowflake channel_id, snowflake around, snowflake bef
 
 
 void cluster::message_unpin(snowflake channel_id, snowflake message_id, command_completion_event_t callback) {
-	rest_request<confirmation>(this, API_PATH "/channels", std::to_string(channel_id), "pins/" + std::to_string(message_id), m_delete, "", callback);
+	rest_request<confirmation>(this, API_PATH "/channels", std::to_string(channel_id), "/messages/pins/" + std::to_string(message_id), m_delete, "", std::move(callback));
 }
 
 
@@ -205,7 +205,7 @@ void cluster::poll_end(snowflake message_id, snowflake channel_id, command_compl
 
 
 void cluster::channel_pins_get(snowflake channel_id, command_completion_event_t callback) {
-	rest_request_list<message>(this, API_PATH "/channels", std::to_string(channel_id), "pins", m_get, "", callback);
+	rest_request_list<message>(this, API_PATH "/channels", std::to_string(channel_id), "/messages/pins", m_get, "", std::move(callback));
 }
 
 }

src/dpp/role.cpp

@@ -341,6 +341,10 @@ bool role::has_use_clyde_ai() const {
 	return has_administrator() || permissions.has(p_use_clyde_ai);
 }
 
+bool role::has_pin_messages() const {
+	return has_administrator() || permissions.has(p_pin_messages);
+}
+
 role& role::set_name(const std::string& n) {
 	name = utility::validate(n, 1, 100, "Role name too short");
 	return *this;