Several improvements

- Rename Guild#updateChannelPositions -> setChannelPositions
- Allow Guild#setChannelPositions to take ChannelResolvables
- Prioritise ClientDataResolver#resolveChannel's string case
- Minor cleanup

src/client/ClientDataResolver.js

@@ -117,9 +117,9 @@ class ClientDataResolver {
    */
   resolveChannel(channel) {
     if (channel instanceof Channel) return channel;
+    if (typeof channel === 'string') return this.client.channels.get(channel) || null;
     if (channel instanceof Message) return channel.channel;
     if (channel instanceof Guild) return channel.channels.get(channel.id) || null;
-    if (typeof channel === 'string') return this.client.channels.get(channel) || null;
     return null;
   }
 

src/client/actions/GuildChannelsPositionUpdate.js

@@ -8,9 +8,7 @@ class GuildChannelsPositionUpdate extends Action {
     if (guild) {
       for (const partialChannel of data.channels) {
         const channel = guild.roles.get(partialChannel.id);
-        if (channel) {
+        if (channel) channel.position = partialChannel.position;
-          channel.position = partialChannel.position;
-        }
       }
     }
 

src/client/rest/RESTMethods.js

@@ -770,7 +770,15 @@ class RESTMethods {
   }
 
   updateChannelPositions(guildID, channels) {
-    return this.rest.makeRequest('patch', Constants.Endpoints.guildChannels(guildID), true, channels).then(() =>
+    const data = new Array(channels.length);
+    for (let i = 0; i < channels.length; i++) {
+      data[i] = {
+        id: this.client.resolver.resolveChannelID(channels[i].channel),
+        position: channels[i].position,
+      };
+    }
+
+    return this.rest.makeRequest('patch', Constants.Endpoints.guildChannels(guildID), true, data).then(() =>
       this.client.actions.GuildChannelsPositionUpdate.handle({
         guild_id: guildID,
         channels,

src/client/voice/player/AudioPlayer.js

@@ -55,7 +55,7 @@ class AudioPlayer extends EventEmitter {
    * @type {?StreamDispatcher}
    */
   get currentDispatcher() {
-    return (this.streams.last() || {}).dispatcher;
+    return this.streams.size > 0 ? this.streams.last().dispatcher || null : null;
   }
 
   destroy() {

src/structures/ClientUser.js

@@ -304,15 +304,15 @@ class ClientUser extends User {
   /**
    * An object containing either a user or access token, and an optional nickname
    * @typedef {Object} GroupDMRecipientOptions
-   * @property {UserResolvable|Snowflake} [user] User to add to the group dm
+   * @property {UserResolvable|Snowflake} [user] User to add to the group DM
-   * (only available if a user is creating the dm)
+   * (only available if a user is creating the DM)
-   * @property {string} [accessToken] Access token to use to add a user to the group dm
+   * @property {string} [accessToken] Access token to use to add a user to the group DM
-   * (only available if a bot is creating the dm)
+   * (only available if a bot is creating the DM)
-   * @property {string} [nick] Permanent nickname (only available if a bot is creating the dm)
+   * @property {string} [nick] Permanent nickname (only available if a bot is creating the DM)
    */
 
   /**
-   * Create a group dm
+   * Creates a group DM
    * @param {GroupDMRecipientOptions[]} recipients The recipients
    * @returns {Promise<GroupDMChannel>}
    */
@@ -325,6 +325,7 @@ class ClientUser extends User {
   }
 
   /**
+   * Accepts an invite to join a guild
    * @param {Invite|string} invite Invite or code to accept
    * @returns {Promise<Guild>} Joined guild
    */

src/structures/Guild.js

@@ -639,20 +639,20 @@ class Guild {
   /**
    * The data needed for updating a channel's position.
    * @typedef {Object} ChannelPosition
-   * @property {Snowflake} id The channel being updated's unique id.
+   * @property {ChannelResolvable} channel Channel to update
-   * @property {number} position The new position of the channel.
+   * @property {number} position New position for the channel
    */
 
   /**
-   * Updates this guild's channel positions as a batch.
+   * Batch-updates the guild's channels' positions.
-   * @param {Array<ChannelPosition>} channelPositions Array of objects that defines which channel is going where.
+   * @param {ChannelPosition[]} channelPositions Channel positions to update
    * @returns {Promise<Guild>}
    * @example
-   * guild.updateChannels([{ id: channelID, position: newChannelIndex }])
+   * guild.updateChannels([{ channel: channelID, position: newChannelIndex }])
-   *  .then(guild => console.log(`Updated channels for ${guild.id}`))
+   *  .then(guild => console.log(`Updated channel positions for ${guild.id}`))
    *  .catch(console.error);
    */
-  updateChannelPositions(channelPositions) {
+  setChannelPositions(channelPositions) {
     return this.client.rest.methods.updateChannelPositions(this.id, channelPositions);
   }