fix(Structures): remove Structures (#6027)

2026-03-11 09:03:29 +01:00 · 2021-07-04 07:26:35 -04:00
parent db60e367b4
commit ab0b3b9a07
11 changed files with 31 additions and 193 deletions
--- a/src/util/Structures.js
+++ b/src/util/Structures.js
@@ -1,122 +0,0 @@
-'use strict';
-
-/**
- * An extendable structure:
- * * **`GuildEmoji`**
- * * **`DMChannel`**
- * * **`TextChannel`**
- * * **`VoiceChannel`**
- * * **`CategoryChannel`**
- * * **`NewsChannel`**
- * * **`StoreChannel`**
- * * **`StageChannel`**
- * * **`ThreadChannel`**
- * * **`GuildMember`**
- * * **`ThreadMember`**
- * * **`Guild`**
- * * **`Message`**
- * * **`MessageReaction`**
- * * **`Presence`**
- * * **`ClientPresence`**
- * * **`VoiceState`**
- * * **`Role`**
- * * **`User`**
- * * **`CommandInteraction`**
- * * **`ButtonInteraction`**
- * * **`StageInstance`**
- * * **`SelectMenuInteraction`**
- * @typedef {string} ExtendableStructure
- */
-
-/**
- * Allows for the extension of built-in Discord.js structures that are instantiated by {@link BaseManager Managers}.
- */
-class Structures extends null {
-  /**
-   * Retrieves a structure class.
-   * @param {string} structure Name of the structure to retrieve
-   * @returns {Function}
-   */
-  static get(structure) {
-    if (typeof structure === 'string') return structures[structure];
-    throw new TypeError(`"structure" argument must be a string (received ${typeof structure})`);
-  }
-
-  /**
-   * Extends a structure.
-   * <warn> Make sure to extend all structures before instantiating your client.
-   * Extending after doing so may not work as expected. </warn>
-   * @param {ExtendableStructure} structure Name of the structure class to extend
-   * @param {Function} extender Function that takes the base class to extend as its only parameter and returns the
-   * extended class/prototype
-   * @returns {Function} Extended class/prototype returned from the extender
-   * @example
-   * const { Structures } = require('discord.js');
-   *
-   * Structures.extend('Guild', Guild => {
-   *   class CoolGuild extends Guild {
-   *     constructor(client, data) {
-   *       super(client, data);
-   *       this.cool = true;
-   *     }
-   *   }
-   *
-   *   return CoolGuild;
-   * });
-   */
-  static extend(structure, extender) {
-    if (!structures[structure]) throw new RangeError(`"${structure}" is not a valid extensible structure.`);
-    if (typeof extender !== 'function') {
-      const received = `(received ${typeof extender})`;
-      throw new TypeError(
-        `"extender" argument must be a function that returns the extended structure class/prototype ${received}.`,
-      );
-    }
-
-    const extended = extender(structures[structure]);
-    if (typeof extended !== 'function') {
-      const received = `(received ${typeof extended})`;
-      throw new TypeError(`The extender function must return the extended structure class/prototype ${received}.`);
-    }
-
-    if (!(extended.prototype instanceof structures[structure])) {
-      const prototype = Object.getPrototypeOf(extended);
-      const received = `${extended.name ?? 'unnamed'}${prototype.name ? ` extends ${prototype.name}` : ''}`;
-      throw new Error(
-        'The class/prototype returned from the extender function must extend the existing structure class/prototype' +
-          ` (received function ${received}; expected extension of ${structures[structure].name}).`,
-      );
-    }
-
-    structures[structure] = extended;
-    return extended;
-  }
-}
-
-const structures = {
-  GuildEmoji: require('../structures/GuildEmoji'),
-  DMChannel: require('../structures/DMChannel'),
-  TextChannel: require('../structures/TextChannel'),
-  VoiceChannel: require('../structures/VoiceChannel'),
-  CategoryChannel: require('../structures/CategoryChannel'),
-  NewsChannel: require('../structures/NewsChannel'),
-  StoreChannel: require('../structures/StoreChannel'),
-  StageChannel: require('../structures/StageChannel'),
-  ThreadChannel: require('../structures/ThreadChannel'),
-  GuildMember: require('../structures/GuildMember'),
-  ThreadMember: require('../structures/ThreadMember'),
-  Guild: require('../structures/Guild'),
-  Message: require('../structures/Message'),
-  MessageReaction: require('../structures/MessageReaction'),
-  Presence: require('../structures/Presence').Presence,
-  ClientPresence: require('../structures/ClientPresence'),
-  VoiceState: require('../structures/VoiceState'),
-  Role: require('../structures/Role'),
-  User: require('../structures/User'),
-  CommandInteraction: require('../structures/CommandInteraction'),
-  ButtonInteraction: require('../structures/ButtonInteraction'),
-  SelectMenuInteraction: require('../structures/SelectMenuInteraction'),
-  StageInstance: require('../structures/StageInstance'),
-};
-
-module.exports = Structures;