discord.js 15.0.0-move-client-init.1761650119-a4c0a246f → 15.0.0-pr-11006.1765450794-e636950b2

package/src/client/BaseClient.js

@@ -1,131 +0,0 @@
-'use strict';
-
-const { REST, RESTEvents } = require('@discordjs/rest');
-const { AsyncEventEmitter } = require('@vladfrangu/async_event_emitter');
-const { Routes } = require('discord-api-types/v10');
-const { DiscordjsTypeError, ErrorCodes } = require('../errors/index.js');
-const { Events } = require('../util/Events.js');
-const { Options } = require('../util/Options.js');
-const { flatten } = require('../util/Util.js');
-
-/**
- * The base class for all clients.
- *
- * @extends {AsyncEventEmitter}
- */
-class BaseClient extends AsyncEventEmitter {
-  constructor(options = {}) {
-    super();
-
-    if (typeof options !== 'object' || options === null) {
-      throw new DiscordjsTypeError(ErrorCodes.InvalidType, 'options', 'object', true);
-    }
-
-    const defaultOptions = Options.createDefault();
-    /**
-     * The options the client was instantiated with
-     *
-     * @type {ClientOptions}
-     */
-    this.options = {
-      ...defaultOptions,
-      ...options,
-      presence: {
-        ...defaultOptions.presence,
-        ...options.presence,
-      },
-      sweepers: {
-        ...defaultOptions.sweepers,
-        ...options.sweepers,
-      },
-      ws: {
-        ...defaultOptions.ws,
-        ...options.ws,
-      },
-      rest: {
-        ...defaultOptions.rest,
-        ...options.rest,
-        userAgentAppendix: options.rest?.userAgentAppendix
-          ? `${Options.userAgentAppendix} ${options.rest.userAgentAppendix}`
-          : Options.userAgentAppendix,
-      },
-    };
-
-    /**
-     * The REST manager of the client
-     *
-     * @type {REST}
-     */
-    this.rest = new REST(this.options.rest);
-
-    this.rest.on(RESTEvents.Debug, message => this.emit(Events.Debug, message));
-  }
-
-  /**
-   * Destroys all assets used by the base client.
-   *
-   * @returns {void}
-   */
-  destroy() {
-    this.rest.clearHashSweeper();
-    this.rest.clearHandlerSweeper();
-  }
-
-  /**
-   * Options used for deleting a webhook.
-   *
-   * @typedef {Object} WebhookDeleteOptions
-   * @property {string} [token] Token of the webhook
-   * @property {string} [reason] The reason for deleting the webhook
-   */
-
-  /**
-   * Deletes a webhook.
-   *
-   * @param {Snowflake} id The webhook's id
-   * @param {WebhookDeleteOptions} [options] Options for deleting the webhook
-   * @returns {Promise<void>}
-   */
-  async deleteWebhook(id, { token, reason } = {}) {
-    await this.rest.delete(Routes.webhook(id, token), { auth: !token, reason });
-  }
-
-  /**
-   * Increments max listeners by one, if they are not zero.
-   *
-   * @private
-   */
-  incrementMaxListeners() {
-    const maxListeners = this.getMaxListeners();
-    if (maxListeners !== 0) {
-      this.setMaxListeners(maxListeners + 1);
-    }
-  }
-
-  /**
-   * Decrements max listeners by one, if they are not zero.
-   *
-   * @private
-   */
-  decrementMaxListeners() {
-    const maxListeners = this.getMaxListeners();
-    if (maxListeners !== 0) {
-      this.setMaxListeners(maxListeners - 1);
-    }
-  }
-
-  toJSON(...props) {
-    return flatten(this, ...props);
-  }
-
-  async [Symbol.asyncDispose]() {
-    await this.destroy();
-  }
-}
-
-exports.BaseClient = BaseClient;
-
-/**
- * @external REST
- * @see {@link https://discord.js.org/docs/packages/rest/stable/REST:Class}
- */

package/src/client/WebhookClient.js

@@ -1,119 +0,0 @@
-'use strict';
-
-const { DiscordjsError, ErrorCodes } = require('../errors/index.js');
-const { Webhook } = require('../structures/Webhook.js');
-const { parseWebhookURL } = require('../util/Util.js');
-const { BaseClient } = require('./BaseClient.js');
-
-/**
- * The webhook client.
- *
- * @implements {Webhook}
- * @extends {BaseClient}
- */
-class WebhookClient extends BaseClient {
-  /**
-   * Represents the credentials used for a webhook in the form of its id and token.
-   *
-   * @typedef {Object} WebhookClientDataIdWithToken
-   * @property {Snowflake} id The webhook's id
-   * @property {string} token The webhook's token
-   */
-
-  /**
-   * Represents the credentials used for a webhook in the form of a URL.
-   *
-   * @typedef {Object} WebhookClientDataURL
-   * @property {string} url The full URL for the webhook
-   */
-
-  /**
-   * Represents the credentials used for a webhook.
-   *
-   * @typedef {WebhookClientDataIdWithToken|WebhookClientDataURL} WebhookClientData
-   */
-
-  /**
-   * Options for a webhook client.
-   *
-   * @typedef {Object} WebhookClientOptions
-   * @property {MessageMentionOptions} [allowedMentions] Default value for {@link BaseMessageOptions#allowedMentions}
-   * @property {RESTOptions} [rest] Options for the REST manager
-   */
-
-  /**
-   * @param {WebhookClientData} data The data of the webhook
-   * @param {WebhookClientOptions} [options] Options for the webhook client
-   */
-  constructor(data, options) {
-    super(options);
-    Object.defineProperty(this, 'client', { value: this });
-    let { id, token } = data;
-
-    if ('url' in data) {
-      const parsed = parseWebhookURL(data.url);
-      if (!parsed) {
-        throw new DiscordjsError(ErrorCodes.WebhookURLInvalid);
-      }
-
-      ({ id, token } = parsed);
-    }
-
-    this.id = id;
-    Object.defineProperty(this, 'token', { value: token, writable: true, configurable: true });
-  }
-
-  /**
-   * The options the webhook client was instantiated with.
-   *
-   * @type {WebhookClientOptions}
-   * @name WebhookClient#options
-   */
-
-  // These are here only for documentation purposes - they are implemented by Webhook
-
-  /* eslint-disable jsdoc/check-param-names, getter-return */
-  /**
-   * Sends a message with this webhook.
-   *
-   * @param {string|MessagePayload|WebhookMessageCreateOptions} options The content for the reply
-   * @returns {Promise<APIMessage>}
-   */
-  async send() {}
-
-  /**
-   * Gets a message that was sent by this webhook.
-   *
-   * @param {Snowflake} message The id of the message to fetch
-   * @param {WebhookFetchMessageOptions} [options] The options to provide to fetch the message.
-   * @returns {Promise<APIMessage>} Returns the message sent by this webhook
-   */
-  async fetchMessage() {}
-
-  /**
-   * Edits a message that was sent by this webhook.
-   *
-   * @param {MessageResolvable} message The message to edit
-   * @param {string|MessagePayload|WebhookMessageEditOptions} options The options to provide
-   * @returns {Promise<APIMessage>} Returns the message edited by this webhook
-   */
-  async editMessage() {}
-
-  sendSlackMessage() {}
-
-  edit() {}
-
-  delete() {}
-
-  deleteMessage() {}
-
-  get createdTimestamp() {}
-
-  get createdAt() {}
-
-  get url() {}
-}
-
-Webhook.applyToClass(WebhookClient);
-
-exports.WebhookClient = WebhookClient;

package/src/structures/AttachmentBuilder.js

@@ -1,185 +0,0 @@
-'use strict';
-
-const { basename, flatten } = require('../util/Util.js');
-
-/**
- * Represents an attachment builder
- */
-class AttachmentBuilder {
-  /**
-   * @param {BufferResolvable|Stream} attachment The file
-   * @param {AttachmentData} [data] Extra data
-   */
-  constructor(attachment, data = {}) {
-    /**
-     * The file associated with this attachment.
-     *
-     * @type {BufferResolvable|Stream}
-     */
-    this.attachment = attachment;
-
-    /**
-     * The name of this attachment
-     *
-     * @type {?string}
-     */
-    this.name = data.name;
-
-    /**
-     * The description of the attachment
-     *
-     * @type {?string}
-     */
-    this.description = data.description;
-
-    /**
-     * The title of the attachment
-     *
-     * @type {?string}
-     */
-    this.title = data.title;
-
-    /**
-     * The base64 encoded byte array representing a sampled waveform
-     * <info>This is only for voice message attachments.</info>
-     *
-     * @type {?string}
-     */
-    this.waveform = data.waveform;
-
-    /**
-     * The duration of the attachment in seconds
-     * <info>This is only for voice message attachments.</info>
-     *
-     * @type {?number}
-     */
-    this.duration = data.duration;
-  }
-
-  /**
-   * Sets the description of this attachment.
-   *
-   * @param {string} description The description of the file
-   * @returns {AttachmentBuilder} This attachment
-   */
-  setDescription(description) {
-    this.description = description;
-    return this;
-  }
-
-  /**
-   * Sets the file of this attachment.
-   *
-   * @param {BufferResolvable|Stream} attachment The file
-   * @returns {AttachmentBuilder} This attachment
-   */
-  setFile(attachment) {
-    this.attachment = attachment;
-    return this;
-  }
-
-  /**
-   * Sets the name of this attachment.
-   *
-   * @param {string} name The name of the file
-   * @returns {AttachmentBuilder} This attachment
-   */
-  setName(name) {
-    this.name = name;
-    return this;
-  }
-
-  /**
-   * Sets the title of this attachment.
-   *
-   * @param {string} title The title of the file
-   * @returns {AttachmentBuilder} This attachment
-   */
-  setTitle(title) {
-    this.title = title;
-    return this;
-  }
-
-  /**
-   * Sets the waveform of this attachment.
-   * <info>This is only for voice message attachments.</info>
-   *
-   * @param {string} waveform The base64 encoded byte array representing a sampled waveform
-   * @returns {AttachmentBuilder} This attachment
-   */
-  setWaveform(waveform) {
-    this.waveform = waveform;
-    return this;
-  }
-
-  /**
-   * Sets the duration of this attachment.
-   * <info>This is only for voice message attachments.</info>
-   *
-   * @param {number} duration The duration of the attachment in seconds
-   * @returns {AttachmentBuilder} This attachment
-   */
-  setDuration(duration) {
-    this.duration = duration;
-    return this;
-  }
-
-  /**
-   * Sets whether this attachment is a spoiler
-   *
-   * @param {boolean} [spoiler=true] Whether the attachment should be marked as a spoiler
-   * @returns {AttachmentBuilder} This attachment
-   */
-  setSpoiler(spoiler = true) {
-    if (spoiler === this.spoiler) return this;
-
-    if (!spoiler) {
-      while (this.spoiler) {
-        this.name = this.name.slice('SPOILER_'.length);
-      }
-
-      return this;
-    }
-
-    this.name = `SPOILER_${this.name}`;
-    return this;
-  }
-
-  /**
-   * Whether or not this attachment has been marked as a spoiler
-   *
-   * @type {boolean}
-   * @readonly
-   */
-  get spoiler() {
-    return basename(this.name).startsWith('SPOILER_');
-  }
-
-  toJSON() {
-    return flatten(this);
-  }
-
-  /**
-   * Makes a new builder instance from a preexisting attachment structure.
-   *
-   * @param {AttachmentBuilder|Attachment|AttachmentPayload} other The builder to construct a new instance from
-   * @returns {AttachmentBuilder}
-   */
-  static from(other) {
-    return new AttachmentBuilder(other.attachment, {
-      name: other.name,
-      description: other.description,
-    });
-  }
-}
-
-exports.AttachmentBuilder = AttachmentBuilder;
-
-/**
- * @typedef {Object} AttachmentData
- * @property {string} [name] The name of the attachment
- * @property {string} [description] The description of the attachment
- * @property {string} [title] The title of the attachment
- * @property {string} [waveform] The base64 encoded byte array representing a sampled waveform (for voice message attachments)
- * @property {number} [duration] The duration of the attachment in seconds (for voice message attachments)
- */