feat: added before and limit to channel_pins_get

Author: Jaskowicz1

include/dpp/cluster.h

@@ -2379,6 +2379,17 @@ class DPP_EXPORT cluster {
 	 */
 	void channel_pins_get(snowflake channel_id, command_completion_event_t callback);
 
+	/**
+	 * @brief Get a channel's pins
+	 * @see https://discord.com/developers/docs/resources/channel#get-pinned-messages
+	 * @param channel_id Channel ID to get pins for
+	 * @param before Get messages pinned before this timestamp.
+	 * @param limit Max number of pins to return (1-50). Defaults to 50 if not set.
+	 * @param callback Function to call when the API call completes.
+	 * On success the callback will contain a dpp::message_map object in confirmation_callback_t::value. On failure, the value is undefined and confirmation_callback_t::is_error() method will return true. You can obtain full error details with confirmation_callback_t::get_error().
+	 */
+	void channel_pins_get(snowflake channel_id, std::optional<time_t> before, std::optional<uint64_t> limit, command_completion_event_t callback);
+
 	/**
 	 * @brief Adds a recipient to a Group DM using their access token
 	 * @see https://discord.com/developers/docs/resources/channel#group-dm-add-recipient

src/dpp/cluster/message.cpp

@@ -23,6 +23,8 @@
 
 namespace dpp {
 
+constexpr uint8_t GET_CHANNEL_PINS_MAX = 50;
+
 void cluster::message_add_reaction(const struct message &m, const std::string &reaction, command_completion_event_t callback) {
 	rest_request<confirmation>(this, API_PATH "/channels", std::to_string(m.channel_id), "messages/" + std::to_string(m.id) + "/reactions/" + utility::url_encode(reaction) + "/@me", m_put, "", callback);
 }
@@ -205,10 +207,25 @@ 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) {
+	channel_pins_get(channel_id, {}, {}, callback);
+}
+
+void cluster::channel_pins_get(snowflake channel_id, std::optional<time_t> before, std::optional<uint64_t> limit, command_completion_event_t callback) {
+	if (!limit.has_value())
+	{
+		limit = GET_CHANNEL_PINS_MAX;
+	}
+
+	std::string parameters = "messages/pins?limit=" + std::to_string(limit.value());
+
+	if (before.has_value()) {
+		parameters.append("&before=" + ts_to_string(before.value()));
+	}
+
 	/* Have to do it like this because this now returns more than just a list.
 	 * It's now a structure containing the pinned items in "items" and then a boolean called "has_more".
 	 */
-	this->post_rest_multipart(API_PATH "/channels", std::to_string(channel_id), "messages/pins", m_get, "", [this, callback](json &j, const http_request_completion_t& http) {
+	this->post_rest_multipart(API_PATH "/channels", std::to_string(channel_id), parameters, m_get, "", [this, callback](json &j, const http_request_completion_t& http) {
 		std::unordered_map<snowflake, dpp::message_pin> list;
 
 		confirmation_callback_t e(this, confirmation(), http);