Discord.js: Add function to get vanity URL uses

[Lilli-Samson]

Is your feature request related to a problem? Please describe.
I want to get the uses of a vanity URL, but there is no function for that.

Describe the ideal solution
Add a function Guild.fetchVanityUses() that gets the uses of a vanity URL, if any.

Describe alternatives you've considered
It is already possible to get vanity invites via client.fetchInvite(server.vanityURLCode), but the .uses is always null. Instead of the extra function the implementation could fill that field. Alternatively the fetchInvites function could be changed to include the vanity URL invite and its uses.

Additional context
The Discord API supports this: https://discordapp.com/developers/docs/resources/guild#get-guild-vanity-url
There is this code in https://github.com/discordjs/discord.js/blob/master/src/structures/Guild.js#L726-L746:

  fetchVanityCode() {
    if (!this.features.includes('VANITY_URL')) {
      return Promise.reject(new Error('VANITY_URL'));
    }
    return this.client.api
      .guilds(this.id, 'vanity-url')
      .get()
      .then(res => res.code);
  }

so it should be relatively easy to add

  fetchVanityUses() {
    if (!this.features.includes('VANITY_URL')) {
      return Promise.reject(new Error('VANITY_URL'));
    }
    return this.client.api
      .guilds(this.id, 'vanity-url')
      .get()
      .then(res => res.uses);
  }

[SunGame7]

You could just make a parameter based function yourself:
fetchVanityUses(guild) {
  if (guild.vanityURLCode) {
    guild.fetchInvites()
      .then(result = invites => console.log(invites.find(invite => invite.code === guild.vanityURLCode)))
      .catch(console.error)
    return(result)
  } else {
    return('0')
  }
}

[Naim2000]

Or maybe just have a function that fetches the vanity invite?
Which of course returns Promise<Invite>, which then you can resolve to get uses.

[monbrey]

The linked PR #4103 will provide the ability to fetch the vanity data from the /guilds/{guild.id}/vanity-url endpoint - there's really no need to discuss it further here or implement a workaround by Invite.

[mamike917]

how do we change custom url?

[almostSouji]

https://discord.com/developers/docs/resources/guild#modify-guild does not seem to have anything documented that could change the vanity url, we can only implement features discord supports (and documents)

If you need help with discord.js installation or usage, please go to the discord.js Discord server instead:
https://discord.gg/bRCvFy9
This issue tracker is only for bug reports and enhancement suggestions. You won't receive any basic help here.