Document readonly and private properties (#1338)

src/structures/Guild.js

@@ -306,6 +306,7 @@ class Guild {
    * Fetches a collection of roles in the current guild sorted by position.
    * @type {Collection<Snowflake, Role>}
    * @readonly
+   * @private
    */
   get _sortedRoles() {
     return this._sortPositionWithID(this.roles);
@@ -963,6 +964,7 @@ class Guild {
    * Fetches a collection of channels in the current guild sorted by position.
    * @param {string} type Channel type
    * @returns {Collection<Snowflake, GuildChannel>}
+   * @private
    */
   _sortedChannels(type) {
     return this._sortPositionWithID(this.channels.filter(c => {
@@ -977,6 +979,7 @@ class Guild {
    * Intended to be identical to Discord's sorting method.
    * @param {Collection} collection The collection to sort
    * @returns {Collection}
+   * @private
    */
   _sortPositionWithID(collection) {
     return collection.sort((a, b) =>

src/structures/GuildChannel.js

@@ -49,6 +49,7 @@ class GuildChannel extends Channel {
   /**
    * The position of the channel
    * @type {number}
+   * @readonly
    */
   get calculatedPosition() {
     const sorted = this.guild._sortedChannels(this.type);

src/structures/MessageEmbed.js

@@ -105,6 +105,7 @@ class MessageEmbed {
   /**
    * The date this embed was created
    * @type {Date}
+   * @readonly
    */
   get createdAt() {
     return new Date(this.createdTimestamp);

src/structures/MessageReaction.js

@@ -39,6 +39,7 @@ class MessageReaction {
    * object which has fewer properties. Whatever the prototype of the emoji, it will still have
    * `name`, `id`, `identifier` and `toString()`
    * @type {Emoji|ReactionEmoji}
+   * @readonly
    */
   get emoji() {
     if (this._emoji instanceof Emoji) return this._emoji;

src/structures/Role.js

@@ -126,6 +126,7 @@ class Role {
   /**
    * The position of the role in the role manager
    * @type {number}
+   * @readonly
    */
   get calculatedPosition() {
     const sorted = this.guild._sortedRoles;

src/structures/User.js

@@ -175,6 +175,7 @@ class User {
   /**
    * The DM between the client's user and this user
    * @type {?DMChannel}
+   * @readonly
    */
   get dmChannel() {
     return this.client.channels.filter(c => c.type === 'dm').find(c => c.recipient.id === this.id);

src/structures/VoiceChannel.js

@@ -48,6 +48,7 @@ class VoiceChannel extends GuildChannel {
   /**
    * Checks if the voice channel is full
    * @type {boolean}
+   * @readonly
    */
   get full() {
     return this.userLimit > 0 && this.members.size >= this.userLimit;
@@ -56,6 +57,7 @@ class VoiceChannel extends GuildChannel {
   /**
    * Checks if the client has permission join the voice channel
    * @type {boolean}
+   * @readonly
    */
   get joinable() {
     if (this.client.browser) return false;
@@ -67,6 +69,7 @@ class VoiceChannel extends GuildChannel {
   /**
    * Checks if the client has permission to send audio to the voice channel
    * @type {boolean}
+   * @readonly
    */
   get speakable() {
     return this.permissionsFor(this.client.user).hasPermission('SPEAK');