djs-selfbot-v13 3.1.7 → 3.2.2

package/src/structures/Presence.js

@@ -1,8 +1,7 @@
 'use strict';
 
+const { randomUUID } = require('node:crypto');
 const Base = require('./Base');
-const { Emoji } = require('./Emoji');
-const { CustomStatus, SpotifyRPC, RichPresence } = require('./RichPresence');
 const ActivityFlags = require('../util/ActivityFlags');
 const { ActivityTypes } = require('../util/Constants');
 const Util = require('../util/Util');
@@ -77,7 +76,7 @@ class Presence extends Base {
     return this.guild.members.resolve(this.userId);
   }
 
-  _patch(data, fromClient) {
+  _patch(data) {
     if ('status' in data) {
       /**
        * The status of this presence
@@ -90,17 +89,17 @@ class Presence extends Base {
 
     if ('activities' in data) {
       /**
-       * The activities of this presence
-       * @type {Activity[]}
+       * The activities of this presence (Always `Activity[]` if not ClientUser)
+       * @type {CustomStatus[]|RichPresence[]|SpotifyRPC[]|Activity[]}
        */
       this.activities = data.activities.map(activity => {
-        if (fromClient === true) {
+        if (this.userId == this.client.user.id) {
           if ([ActivityTypes.CUSTOM, 'CUSTOM'].includes(activity.type)) {
-            return new CustomStatus(activity, this);
+            return new CustomStatus(this.client, activity);
           } else if (activity.id == 'spotify:1') {
-            return new SpotifyRPC(this.client, activity, this);
+            return new SpotifyRPC(this.client, activity);
           } else {
-            return new RichPresence(this.client, activity, false, this);
+            return new RichPresence(this.client, activity);
           }
         } else {
           return new Activity(this, activity);
@@ -168,6 +167,11 @@ class Presence extends Base {
  * * **`desktop`**
  * * **`samsung`** - playing on Samsung Galaxy
  * * **`xbox`** - playing on Xbox Live
+ * * **`ios`**
+ * * **`android`**
+ * * **`embedded`**
+ * * **`ps4`**
+ * * **`ps5`**
  * @typedef {string} ActivityPlatform
  */
 
@@ -176,6 +180,9 @@ class Presence extends Base {
  */
 class Activity {
   constructor(presence, data) {
+    if (!(presence instanceof Presence)) {
+      throw new Error("Class constructor Activity cannot be invoked without 'presence'");
+    }
     /**
      * The presence of the Activity
      * @type {Presence}
@@ -184,126 +191,184 @@ class Activity {
      */
     Object.defineProperty(this, 'presence', { value: presence });
 
-    /**
-     * The activity's id
-     * @type {string}
-     */
-    this.id = data.id;
+    this._patch(data);
+  }
 
-    /**
-     * The activity's name
-     * @type {string}
-     */
-    this.name = data.name;
+  _patch(data = {}) {
+    if ('id' in data) {
+      /**
+       * The activity's id
+       * @type {string}
+       */
+      this.id = data.id;
+    }
 
-    /**
-     * The activity status's type
-     * @type {ActivityType}
-     */
-    this.type = typeof data.type === 'number' ? ActivityTypes[data.type] : data.type;
+    if ('name' in data) {
+      /**
+       * The activity's name
+       * @type {string}
+       */
+      this.name = data.name;
+    }
 
-    /**
-     * If the activity is being streamed, a link to the stream
-     * @type {?string}
-     */
-    this.url = data.url ?? null;
+    if ('type' in data) {
+      /**
+       * The activity status's type
+       * @type {ActivityType}
+       */
+      this.type = typeof data.type === 'number' ? ActivityTypes[data.type] : data.type;
+    }
 
-    /**
-     * Details about the activity
-     * @type {?string}
-     */
-    this.details = data.details ?? null;
+    if ('url' in data) {
+      /**
+       * If the activity is being streamed, a link to the stream
+       * @type {?string}
+       */
+      this.url = data.url;
+    } else {
+      this.url = null;
+    }
 
-    /**
-     * State of the activity
-     * @type {?string}
-     */
-    this.state = data.state ?? null;
+    if ('created_at' in data || 'createdTimestamp' in data) {
+      /**
+       * Creation date of the activity
+       * @type {number}
+       */
+      this.createdTimestamp = data.created_at || data.createdTimestamp;
+    }
 
-    /**
-     * The id of the application associated with this activity
-     * @type {?Snowflake}
-     */
-    this.applicationId = data.application_id ?? null;
+    if ('session_id' in data) {
+      /**
+       * The game's or Spotify session's id
+       * @type {?string}
+       */
+      this.sessionId = data.session_id;
+    } else {
+      this.sessionId = this.presence.client?.sessionId;
+    }
 
-    /**
-     * Represents timestamps of an activity
-     * @typedef {Object} ActivityTimestamps
-     * @property {?Date} start When the activity started
-     * @property {?Date} end When the activity will end
-     */
+    if ('platform' in data) {
+      /**
+       * The platform the game is being played on
+       * @type {?ActivityPlatform}
+       */
+      this.platform = data.platform;
+    } else {
+      this.platform = null;
+    }
 
-    /**
-     * Timestamps for the activity
-     * @type {?ActivityTimestamps}
-     */
-    this.timestamps = data.timestamps
-      ? {
-          start: data.timestamps.start ? new Date(Number(data.timestamps.start)) : null,
-          end: data.timestamps.end ? new Date(Number(data.timestamps.end)) : null,
-        }
-      : null;
+    if ('timestamps' in data && data.timestamps) {
+      /**
+       * Represents timestamps of an activity
+       * @typedef {Object} ActivityTimestamps
+       * @property {?number} start When the activity started
+       * @property {?number} end When the activity will end
+       */
 
-    /**
-     * The Spotify song's id
-     * @type {?string}
-     */
-    this.syncId = data.sync_id ?? null;
+      /**
+       * Timestamps for the activity
+       * @type {?ActivityTimestamps}
+       */
+      this.timestamps = {
+        start: data.timestamps.start ? new Date(data.timestamps.start).getTime() : null,
+        end: data.timestamps.end ? new Date(data.timestamps.end).getTime() : null,
+      };
+    } else {
+      this.timestamps = null;
+    }
 
-    /**
-     * The platform the game is being played on
-     * @type {?ActivityPlatform}
-     */
-    this.platform = data.platform ?? null;
+    if ('application_id' in data || 'applicationId' in data) {
+      /**
+       * The id of the application associated with this activity
+       * @type {?Snowflake}
+       */
+      this.applicationId = data.application_id || data.applicationId;
+    } else {
+      this.applicationId = null;
+    }
 
-    /**
-     * Represents a party of an activity
-     * @typedef {Object} ActivityParty
-     * @property {?string} id The party's id
-     * @property {number[]} size Size of the party as `[current, max]`
-     */
+    if ('details' in data) {
+      /**
+       * Details about the activity
+       * @type {?string}
+       */
+      this.details = data.details;
+    } else {
+      this.details = null;
+    }
 
-    /**
-     * Party of the activity
-     * @type {?ActivityParty}
-     */
-    this.party = data.party ?? null;
+    if ('state' in data) {
+      /**
+       * State of the activity
+       * @type {?string}
+       */
+      this.state = data.state;
+    } else {
+      this.state = null;
+    }
 
-    /**
-     * Assets for rich presence
-     * @type {?RichPresenceAssets}
-     */
-    this.assets = data.assets ? new RichPresenceAssets(this, data.assets) : null;
+    if ('sync_id' in data || 'syncId' in data) {
+      /**
+       * The Spotify song's id
+       * @type {?string}
+       */
+      this.syncId = data.sync_id || data.syncId;
+    } else {
+      this.syncId = null;
+    }
 
-    /**
-     * Flags that describe the activity
-     * @type {Readonly<ActivityFlags>}
-     */
-    this.flags = new ActivityFlags(data.flags).freeze();
+    if ('flags' in data) {
+      /**
+       * Flags that describe the activity
+       * @type {Readonly<ActivityFlags>}
+       */
+      this.flags = new ActivityFlags(data.flags).freeze();
+    } else {
+      this.flags = new ActivityFlags().freeze();
+    }
 
-    /**
-     * Emoji for a custom activity
-     * @type {?Emoji}
-     */
-    this.emoji = data.emoji ? new Emoji(presence.client, data.emoji) : null;
+    if ('buttons' in data) {
+      /**
+       * The labels of the buttons of this rich presence
+       * @type {string[]}
+       */
+      this.buttons = data.buttons;
+    } else {
+      this.buttons = [];
+    }
 
-    /**
-     * The game's or Spotify session's id
-     * @type {?string}
-     */
-    this.sessionId = data.session_id ?? null;
+    if ('emoji' in data && data.emoji) {
+      /**
+       * Emoji for a custom activity
+       * @type {?EmojiIdentifierResolvable}
+       */
+      this.emoji = Util.resolvePartialEmoji(data.emoji);
+    } else {
+      this.emoji = null;
+    }
 
-    /**
-     * The labels of the buttons of this rich presence
-     * @type {string[]}
-     */
-    this.buttons = data.buttons ?? [];
+    if ('party' in data) {
+      /**
+       * Represents a party of an activity
+       * @typedef {Object} ActivityParty
+       * @property {?string} id The party's id
+       * @property {number[]} size Size of the party as `[current, max]`
+       */
+
+      /**
+       * Party of the activity
+       * @type {?ActivityParty}
+       */
+      this.party = data.party;
+    } else {
+      this.party = null;
+    }
 
     /**
-     * Creation date of the activity
-     * @type {number}
+     * Assets for rich presence
+     * @type {?RichPresenceAssets}
      */
-    this.createdTimestamp = data.created_at;
+    this.assets = new RichPresenceAssets(this, data.assets);
   }
 
   /**
@@ -345,6 +410,13 @@ class Activity {
   _clone() {
     return Object.assign(Object.create(this), this);
   }
+
+  toJSON(...props) {
+    return Util.clearNullOrUndefinedObject({
+      ...Util.flatten(this, ...props),
+      type: typeof this.type === 'number' ? this.type : ActivityTypes[this.type],
+    });
+  }
 }
 
 /**
@@ -360,29 +432,49 @@ class RichPresenceAssets {
      */
     Object.defineProperty(this, 'activity', { value: activity });
 
-    /**
-     * Hover text for the large image
-     * @type {?string}
-     */
-    this.largeText = assets.large_text ?? null;
+    this._patch(assets);
+  }
 
-    /**
-     * Hover text for the small image
-     * @type {?string}
-     */
-    this.smallText = assets.small_text ?? null;
+  _patch(assets = {}) {
+    if ('large_text' in assets || 'largeText' in assets) {
+      /**
+       * Hover text for the large image
+       * @type {?string}
+       */
+      this.largeText = assets.large_text || assets.largeText;
+    } else {
+      this.largeText = null;
+    }
 
-    /**
-     * The large image asset's id
-     * @type {?Snowflake}
-     */
-    this.largeImage = assets.large_image ?? null;
+    if ('small_text' in assets || 'smallText' in assets) {
+      /**
+       * Hover text for the small image
+       * @type {?string}
+       */
+      this.smallText = assets.small_text || assets.smallText;
+    } else {
+      this.smallText = null;
+    }
 
-    /**
-     * The small image asset's id
-     * @type {?Snowflake}
-     */
-    this.smallImage = assets.small_image ?? null;
+    if ('large_image' in assets || 'largeImage' in assets) {
+      /**
+       * The large image asset's id
+       * @type {?Snowflake}
+       */
+      this.largeImage = assets.large_image || assets.largeImage;
+    } else {
+      this.largeImage = null;
+    }
+
+    if ('small_image' in assets || 'smallImage' in assets) {
+      /**
+       * The small image asset's id
+       * @type {?Snowflake}
+       */
+      this.smallImage = assets.small_image || assets.smallImage;
+    } else {
+      this.smallImage = null;
+    }
   }
 
   /**
@@ -397,6 +489,12 @@ class RichPresenceAssets {
       switch (platform) {
         case 'mp':
           return `https://media.discordapp.net/${id}`;
+        case 'spotify':
+          return `https://i.scdn.co/image/${id}`;
+        case 'youtube':
+          return `https://i.ytimg.com/vi/${id}/hqdefault_live.jpg`;
+        case 'twitch':
+          return `https://static-cdn.jtvnw.net/previews-ttv/live_user_${id}.png`;
         default:
           return null;
       }
@@ -436,8 +534,568 @@ class RichPresenceAssets {
       size,
     });
   }
+
+  static parseImage(image) {
+    if (typeof image != 'string') {
+      image = null;
+    } else if (URL.canParse(image) && ['http:', 'https:'].includes(new URL(image).protocol)) {
+      // Discord URL:
+      image = image
+        .replace('https://cdn.discordapp.com/', 'mp:')
+        .replace('http://cdn.discordapp.com/', 'mp:')
+        .replace('https://media.discordapp.net/', 'mp:')
+        .replace('http://media.discordapp.net/', 'mp:');
+      //
+      if (!image.startsWith('mp:')) {
+        throw new Error('INVALID_URL');
+      }
+    } else if (/^[0-9]{17,19}$/.test(image)) {
+      // ID Assets
+    } else if (['mp:', 'youtube:', 'spotify:', 'twitch:'].some(v => image.startsWith(v))) {
+      // Image
+    } else if (image.startsWith('external/')) {
+      image = `mp:${image}`;
+    }
+    return image;
+  }
+
+  toJSON() {
+    if (!this.largeImage && !this.largeText && !this.smallImage && !this.smallText) return null;
+    return {
+      large_image: RichPresenceAssets.parseImage(this.largeImage),
+      large_text: this.largeText,
+      small_image: RichPresenceAssets.parseImage(this.smallImage),
+      small_text: this.smallText,
+    };
+  }
+
+  /**
+   * @typedef {string} RichPresenceImage
+   * Support:
+   * - cdn.discordapp.com
+   * - media.discordapp.net
+   * - Assets ID (https://discord.com/api/v9/oauth2/applications/{application_id}/assets)
+   * - Media Proxy (mp:external/{hash})
+   * - Twitch (twitch:{username})
+   * - YouTube (youtube:{video_id})
+   * - Spotify (spotify:{image_id})
+   */
+
+  /**
+   * Set the large image of this activity
+   * @param {?RichPresenceImage} image The large image asset's id
+   * @returns {RichPresenceAssets}
+   */
+  setLargeImage(image) {
+    image = RichPresenceAssets.parseImage(image);
+    this.largeImage = image;
+    return this;
+  }
+
+  /**
+   * Set the small image of this activity
+   * @param {?RichPresenceImage} image The small image asset's id
+   * @returns {RichPresenceAssets}
+   */
+  setSmallImage(image) {
+    image = RichPresenceAssets.parseImage(image);
+    this.smallImage = image;
+    return this;
+  }
+
+  /**
+   * Hover text for the large image
+   * @param {string} text Assets text
+   * @returns {RichPresenceAssets}
+   */
+  setLargeText(text) {
+    this.largeText = text;
+    return this;
+  }
+
+  /**
+   * Hover text for the small image
+   * @param {string} text Assets text
+   * @returns {RichPresenceAssets}
+   */
+  setSmallText(text) {
+    this.smallText = text;
+    return this;
+  }
+}
+
+class CustomStatus extends Activity {
+  /**
+   * @typedef {Object} CustomStatusOptions
+   * @property {string} [state] The state to be displayed
+   * @property {EmojiIdentifierResolvable} [emoji] The emoji to be displayed
+   */
+
+  /**
+   * @param {Client} client Discord Client
+   * @param {CustomStatus|CustomStatusOptions} [data={}] CustomStatus to clone or raw data
+   */
+  constructor(client, data = {}) {
+    if (!client) throw new Error("Class constructor CustomStatus cannot be invoked without 'client'");
+    super('presence' in client ? client.presence : client, {
+      name: 'Custom Status',
+      type: ActivityTypes.CUSTOM,
+      ...data,
+    });
+  }
+
+  /**
+   * Set the emoji of this activity
+   * @param {EmojiIdentifierResolvable} emoji The emoji to be displayed
+   * @returns {CustomStatus}
+   */
+  setEmoji(emoji) {
+    this.emoji = Util.resolvePartialEmoji(emoji);
+    return this;
+  }
+
+  /**
+   * Set state of this activity
+   * @param {string | null} state The state to be displayed
+   * @returns {CustomStatus}
+   */
+  setState(state) {
+    if (typeof state == 'string' && state.length > 128) throw new Error('State must be less than 128 characters');
+    this.state = state;
+    return this;
+  }
+
+  /**
+   * Returns an object that can be used to set the status
+   * @returns {CustomStatus}
+   */
+  toJSON() {
+    if (!this.emoji & !this.state) throw new Error('CustomStatus must have at least one of emoji or state');
+    return {
+      name: this.name,
+      emoji: this.emoji,
+      type: this.type,
+      state: this.state,
+    };
+  }
+}
+
+class RichPresence extends Activity {
+  /**
+   * @param {Client} client Discord client
+   * @param {RichPresence} [data={}] RichPresence to clone or raw data
+   */
+  constructor(client, data = {}) {
+    if (!client) throw new Error("Class constructor RichPresence cannot be invoked without 'client'");
+    super('presence' in client ? client.presence : client, { type: 0, ...data });
+    this.setup(data);
+  }
+
+  /**
+   * Sets the status from a JSON object
+   * @param {RichPresence} data data
+   * @private
+   */
+  setup(data = {}) {
+    this.secrets = 'secrets' in data ? data.secrets : {};
+    this.metadata = 'metadata' in data ? data.metadata : {};
+  }
+
+  /**
+   * Set the large image of this activity
+   * @param {?RichPresenceImage} image The large image asset's id
+   * @returns {RichPresence}
+   */
+  setAssetsLargeImage(image) {
+    this.assets.setLargeImage(image);
+    return this;
+  }
+
+  /**
+   * Set the small image of this activity
+   * @param {?RichPresenceImage} image The small image asset's id
+   * @returns {RichPresence}
+   */
+  setAssetsSmallImage(image) {
+    this.assets.setSmallImage(image);
+    return this;
+  }
+
+  /**
+   * Hover text for the large image
+   * @param {string} text Assets text
+   * @returns {RichPresence}
+   */
+  setAssetsLargeText(text) {
+    this.assets.setLargeText(text);
+    return this;
+  }
+
+  /**
+   * Hover text for the small image
+   * @param {string} text Assets text
+   * @returns {RichPresence}
+   */
+  setAssetsSmallText(text) {
+    this.assets.setSmallText(text);
+    return this;
+  }
+
+  /**
+   * Set the name of the activity
+   * @param {?string} name The activity's name
+   * @returns {RichPresence}
+   */
+  setName(name) {
+    this.name = name;
+    return this;
+  }
+
+  /**
+   * If the activity is being streamed, a link to the stream
+   * @param {?string} url URL of the stream
+   * @returns {RichPresence}
+   */
+  setURL(url) {
+    if (typeof url == 'string' && !URL.canParse(url)) throw new Error('URL must be a valid URL');
+    this.url = url;
+    return this;
+  }
+
+  /**
+   * The activity status's type
+   * @param {?ActivityTypes} type The type of activity
+   * @returns {RichPresence}
+   */
+  setType(type) {
+    this.type = typeof type == 'number' ? type : ActivityTypes[type];
+    return this;
+  }
+
+  /**
+   * Set the application id of this activity
+   * @param {?Snowflake} id Bot's id
+   * @returns {RichPresence}
+   */
+  setApplicationId(id) {
+    this.applicationId = id;
+    return this;
+  }
+
+  /**
+   * Set the state of the activity
+   * @param {?string} state The state of the activity
+   * @returns {RichPresence}
+   */
+  setState(state) {
+    this.state = state;
+    return this;
+  }
+
+  /**
+   * Set the details of the activity
+   * @param {?string} details The details of the activity
+   * @returns {RichPresence}
+   */
+  setDetails(details) {
+    this.details = details;
+    return this;
+  }
+
+  /**
+   * @typedef {Object} RichParty
+   * @property {string} id The id of the party
+   * @property {number} max The maximum number of members in the party
+   * @property {number} current The current number of members in the party
+   */
+
+  /**
+   * Set the party of this activity
+   * @param {?RichParty} party The party to be displayed
+   * @returns {RichPresence}
+   */
+  setParty(party) {
+    if (typeof party == 'object') {
+      if (!party.max || typeof party.max != 'number') throw new Error('Party must have max number');
+      if (!party.current || typeof party.current != 'number') throw new Error('Party must have current');
+      if (party.current > party.max) throw new Error('Party current must be less than max number');
+      if (!party.id || typeof party.id != 'string') party.id = randomUUID();
+      this.party = {
+        size: [party.current, party.max],
+        id: party.id,
+      };
+    } else {
+      this.party = null;
+    }
+    return this;
+  }
+
+  /**
+   * Sets the start timestamp of the activity
+   * @param {Date|number|null} timestamp The timestamp of the start of the activity
+   * @returns {RichPresence}
+   */
+  setStartTimestamp(timestamp) {
+    if (!this.timestamps) this.timestamps = {};
+    if (timestamp instanceof Date) timestamp = timestamp.getTime();
+    this.timestamps.start = timestamp;
+    return this;
+  }
+
+  /**
+   * Sets the end timestamp of the activity
+   * @param {Date|number|null} timestamp The timestamp of the end of the activity
+   * @returns {RichPresence}
+   */
+  setEndTimestamp(timestamp) {
+    if (!this.timestamps) this.timestamps = {};
+    if (timestamp instanceof Date) timestamp = timestamp.getTime();
+    this.timestamps.end = timestamp;
+    return this;
+  }
+
+  /**
+   * @typedef {object} RichButton
+   * @property {string} name The name of the button
+   * @property {string} url The url of the button
+   */
+  /**
+   * Set the buttons of the rich presence
+   * @param  {...?RichButton} button A list of buttons to set
+   * @returns {RichPresence}
+   */
+  setButtons(...button) {
+    if (button.length == 0) {
+      this.buttons = [];
+      delete this.metadata.button_urls;
+      return this;
+    } else if (button.length > 2) {
+      throw new Error('RichPresence can only have up to 2 buttons');
+    }
+
+    this.buttons = [];
+    this.metadata.button_urls = [];
+
+    button.flat(2).forEach(b => {
+      if (b.name && b.url) {
+        this.buttons.push(b.name);
+        if (!URL.canParse(b.url)) throw new Error('Button url must be a valid url');
+        this.metadata.button_urls.push(b.url);
+      } else {
+        throw new Error('Button must have name and url');
+      }
+    });
+    return this;
+  }
+
+  /**
+   * The platform the activity is being played on
+   * @param {ActivityPlatform | null} platform Any platform
+   * @returns {RichPresence}
+   */
+  setPlatform(platform) {
+    this.platform = platform;
+    return this;
+  }
+
+  /**
+   * Secrets for rich presence joining and spectating (send-only)
+   * @param {?string} join Secrets for rich presence joining
+   * @returns {RichPresence}
+   */
+  setJoinSecret(join) {
+    this.secrets.join = join;
+    return this;
+  }
+
+  /**
+   * Add a button to the rich presence
+   * @param {string} name The name of the button
+   * @param {string} url The url of the button
+   * @returns {RichPresence}
+   */
+  addButton(name, url) {
+    if (!name || !url) {
+      throw new Error('Button must have name and url');
+    }
+    if (typeof name !== 'string') throw new Error('Button name must be a string');
+    if (!URL.canParse(url)) throw new Error('Button url must be a valid url');
+    this.buttons.push(name);
+    if (Array.isArray(this.metadata.button_urls)) this.metadata.button_urls.push(url);
+    else this.metadata.button_urls = [url];
+    return this;
+  }
+
+  /**
+   * Convert the rich presence to a JSON object
+   * @returns {Object}
+   */
+  toJSON(...props) {
+    return super.toJSON(
+      {
+        applicationId: 'application_id',
+        sessionId: 'session_id',
+        syncId: 'sync_id',
+        createdTimestamp: 'created_at',
+      },
+      ...props,
+    );
+  }
+
+  /**
+   * @typedef {Object} ExternalAssets
+   * @property {?string} url Orginal url of the image
+   * @property {?string} external_asset_path Proxy url of the image (Using to RPC)
+   */
+
+  /**
+   * Get Assets from a RichPresence (Util)
+   * @param {Client} client Discord Client
+   * @param {Snowflake} applicationId Application id
+   * @param {string} image1 URL image 1 (not from Discord)
+   * @param {string} image2 URL image 2 (not from Discord)
+   * @returns {ExternalAssets[]}
+   */
+  static async getExternal(client, applicationId, image1 = '', image2 = '') {
+    if (!client || !client.token || !client.api) throw new Error('Client must be set');
+    // Check if applicationId is discord snowflake (17 , 18, 19 numbers)
+    if (!/^[0-9]{17,19}$/.test(applicationId)) {
+      throw new Error('Application id must be a Discord Snowflake');
+    }
+    // Check if large_image is a valid url
+    if (image1 && image1.length > 0 && !URL.canParse(image1)) {
+      throw new Error('Image 1 must be a valid url');
+    }
+    // Check if small_image is a valid url
+    if (image2 && image2.length > 0 && !URL.canParse(image2)) {
+      throw new Error('Image 2 must be a valid url');
+    }
+    const data_ = [];
+    if (image1) data_.push(image1);
+    if (image2) data_.push(image2);
+    const res = await client.api.applications[applicationId]['external-assets'].post({
+      data: {
+        urls: data_,
+      },
+    });
+    return res;
+  }
+
+  /**
+   * When concatenated with a string, this automatically returns the activities' name instead of the Activity object.
+   * @returns {string}
+   */
+  toString() {
+    return this.name;
+  }
+
+  _clone() {
+    return Object.assign(Object.create(this), this);
+  }
+}
+
+/**
+ * @extends {RichPresence}
+ */
+class SpotifyRPC extends RichPresence {
+  /**
+   * Create a new RichPresence (Spotify style)
+   * @param {Client} client Discord Client
+   * @param {SpotifyRPC} [options] Options for the Spotify RPC
+   */
+  constructor(client, options = {}) {
+    if (!client) throw new Error("Class constructor SpotifyRPC cannot be invoked without 'client'");
+    super(client, {
+      name: 'Spotify',
+      type: ActivityTypes.LISTENING,
+      party: {
+        id: `spotify:${client.user.id}`,
+      },
+      id: 'spotify:1',
+      flags: 48, // Sync + Play (ActivityFlags)
+      ...options,
+    });
+    this.setup(options);
+  }
+  /**
+   * Sets the status from a JSON object
+   * @param {SpotifyRPC} options data
+   * @private
+   */
+  setup(options) {
+    /**
+     * @typedef {Object} SpotifyMetadata
+     * @property {string} album_id The Spotify ID of the album of the song being played
+     * @property {Array<string>} artist_ids The Spotify IDs of the artists of the song being played
+     * @property {string} context_uri The Spotify URI of the current player context
+     */
+
+    /**
+     * Spotify metadata
+     * @type {SpotifyMetadata}
+     */
+    this.metadata = {
+      album_id: options.metadata?.album_id || null,
+      artist_ids: options.metadata?.artist_ids || [],
+      context_uri: options.metadata?.context_uri || null,
+    };
+  }
+
+  /**
+   * Set Spotify song id to sync with
+   * @param {string} id Song id
+   * @returns {SpotifyRPC}
+   */
+  setSongId(id) {
+    this.syncId = id;
+    return this;
+  }
+
+  /**
+   * Add the artist id
+   * @param {string} id Artist id
+   * @returns {SpotifyRPC}
+   */
+  addArtistId(id) {
+    if (!this.metadata.artist_ids) this.metadata.artist_ids = [];
+    this.metadata.artist_ids.push(id);
+    return this;
+  }
+
+  /**
+   * Set the artist ids
+   * @param {string | Array<string>} ids Artist ids
+   * @returns {SpotifyRPC}
+   */
+  setArtistIds(...ids) {
+    if (!ids?.length) {
+      this.metadata.artist_ids = [];
+      return this;
+    }
+    if (!this.metadata.artist_ids) this.metadata.artist_ids = [];
+    ids.flat(2).forEach(id => this.metadata.artist_ids.push(id));
+    return this;
+  }
+
+  /**
+   * Set the album id
+   * @param {string} id Album id
+   * @returns {SpotifyRPC}
+   */
+  setAlbumId(id) {
+    this.metadata.album_id = id;
+    this.metadata.context_uri = `spotify:album:${id}`;
+    return this;
+  }
+
+  toJSON() {
+    return super.toJSON({ id: false, emoji: false, platform: false, buttons: false });
+  }
 }
 
 exports.Presence = Presence;
 exports.Activity = Activity;
 exports.RichPresenceAssets = RichPresenceAssets;
+exports.CustomStatus = CustomStatus;
+exports.RichPresence = RichPresence;
+exports.SpotifyRPC = SpotifyRPC;