Add message/channel/guild acknowledging (#1239)

* add acking

* 👀

* Update RESTMethods.js

* Update TextBasedChannel.js

* Update RESTMethods.js

* Update Guild.js

* Update TextBasedChannel.js

* Update Message.js

* super shitty names

* Update GroupDMChannel.js

* Update DMChannel.js

* Update TextChannel.js

src/structures/DMChannel.js

@@ -54,6 +54,7 @@ class DMChannel extends Channel {
   createCollector() { return; }
   awaitMessages() { return; }
   // doesn't work on DM channels; bulkDelete() { return; }
+  acknowledge() { return; }
   _cacheMessage() { return; }
 }
 

src/structures/GroupDMChannel.js

@@ -170,6 +170,7 @@ class GroupDMChannel extends Channel {
   createCollector() { return; }
   awaitMessages() { return; }
   // doesn't work on group DMs; bulkDelete() { return; }
+  acknowledge() { return; }
   _cacheMessage() { return; }
 }
 

src/structures/Guild.js

@@ -770,6 +770,15 @@ class Guild {
     return this.client.rest.methods.deleteGuild(this);
   }
 
+  /**
+   * Marks all messages in this guild as read
+   * <warn>This is only available when using a user account.</warn>
+   * @returns {Promise<Guild>} this guild
+   */
+  acknowledge() {
+    return this.client.rest.methods.ackGuild(this);
+  }
+
   /**
    * Whether this Guild equals another Guild. It compares all properties, so for most operations
    * it is advisable to just compare `guild.id === guild2.id` as it is much faster and is often

src/structures/Message.js

@@ -493,6 +493,15 @@ class Message {
     return this.channel.send(content, Object.assign(options, { reply: this.member || this.author }));
   }
 
+  /**
+   * Marks the message as read
+   * <warn>This is only available when using a user account.</warn>
+   * @returns {Promise<Message>}
+   */
+  acknowledge() {
+    return this.client.rest.methods.ackMessage(this);
+  }
+
   /**
    * Fetches the webhook used to create this message.
    * @returns {Promise<?Webhook>}

src/structures/TextChannel.js

@@ -90,6 +90,7 @@ class TextChannel extends GuildChannel {
   createCollector() { return; }
   awaitMessages() { return; }
   bulkDelete() { return; }
+  acknowledge() { return; }
   _cacheMessage() { return; }
 }
 

src/structures/interface/TextBasedChannel.js

@@ -423,6 +423,15 @@ class TextBasedChannel {
     throw new TypeError('The messages must be an Array, Collection, or number.');
   }
 
+  /**
+   * Marks all messages in this channel as read
+   * <warn>This is only available when using a user account.</warn>
+   * @returns {Promise<TextChannel|GroupDMChannel|DMChannel>}
+   */
+  acknowledge() {
+    return this.client.rest.methods.ackTextMessage(this);
+  }
+
   _cacheMessage(message) {
     const maxSize = this.client.options.messageCacheMaxSize;
     if (maxSize === 0) return null;