Guild::fetchVanityUrl()

Author: valzargaming

src/Discord/Parts/Channel/Channel.php

@@ -684,7 +684,7 @@ public function sendSoundboardSound(string $sound_id, ?string $source_guild_id =
      *
      * @param string $webhookChannelId ID of the channel to receive crossposted messages.
      *
-    * @return PromiseInterface<array{channel: Channel|int, webhook: int}>
+     * @return PromiseInterface<array{channel: Channel|int, webhook: int}>
      *
      * @since 10.46.0
      */

src/Discord/Parts/Guild/Guild.php

@@ -655,6 +655,42 @@ public function getCurrentUserVoiceState(): PromiseInterface
         return $this->voice_states->getCurrentUserVoiceState($this->id);
     }
 
+    /**
+     * Returns a partial invite object for guilds with that feature enabled.
+     *
+     * Requires the `MANAGE_GUILD` permission. `code` will be null if a vanity url for the guild is not set.
+     *
+     * @link https://docs.discord.com/developers/resources/guild#get-guild-vanity-url
+     *
+     * @return PromiseInterface<string|null> Vanity URL code or null if no vanity URL is set.
+     */
+    public function fetchVanityUrl(): PromiseInterface
+    {
+        if ($botperms = $this->getBotPermissions()) {
+            if (! $botperms->manage_guild) {
+                return reject(new NoPermissionsException("You do not have permission to get the vanity URL for the guild {$this->id}."));
+            }
+        }
+
+        return $this->http->get(Endpoint::bind(Endpoint::GUILD_VANITY_URL, $this->id))
+            ->then(function ($response) {
+                $response = (array) $response;
+
+                if (! isset($response['code'])) {
+                    return null;
+                }
+
+                if ($invite = $this->invites->get('code', $response['code'])) {
+                    return (string) $invite;
+                }
+
+                $invite = new Invite($this->discord, $response, true);
+                $this->invites->pushItem($invite);
+
+                return (string) $invite;
+            });
+    }
+
     /**
      * Modify the current user's voice state in the guild.
      *