refactor(NewsChannel)!: rename NewsChannel to AnnouncementChannel (#10532)

BREAKING CHANGE: The `NewsChannel` class was renamed to `AnnouncementChannel`, in line with the type name change

Author: imnaiyar

packages/discord.js/src/client/actions/ThreadListSync.js

@@ -36,7 +36,7 @@ class ThreadListSyncAction extends Action {
     }
 
     /**
-     * Emitted whenever the client user gains access to a text or news channel that contains threads
+     * Emitted whenever the client user gains access to a text or announcement channel that contains threads
      * @event Client#threadListSync
      * @param {Collection<Snowflake, ThreadChannel>} threads The threads that were synced
      * @param {Guild} guild The guild that the threads were synced in

packages/discord.js/src/client/actions/WebhooksUpdate.js

@@ -12,7 +12,7 @@ class WebhooksUpdate extends Action {
     /**
      * Emitted whenever a channel has its webhooks changed.
      * @event Client#webhooksUpdate
-     * @param {TextChannel|NewsChannel|VoiceChannel|StageChannel|ForumChannel|MediaChannel} channel
+     * @param {TextChannel|AnnouncementChannel|VoiceChannel|StageChannel|ForumChannel|MediaChannel} channel
      * The channel that had a webhook update
      */
     client.emit(Events.WebhooksUpdate, channel);

packages/discord.js/src/errors/Messages.js

@@ -75,7 +75,7 @@ const Messages = {
   [DjsErrorCodes.InvalidType]: (name, expected, an = false) => `Supplied ${name} is not a${an ? 'n' : ''} ${expected}.`,
   [DjsErrorCodes.InvalidElement]: (type, name, elem) => `Supplied ${type} ${name} includes an invalid element: ${elem}`,
 
-  [DjsErrorCodes.MessageThreadParent]: 'The message was not sent in a guild text or news channel',
+  [DjsErrorCodes.MessageThreadParent]: 'The message was not sent in a guild text or announcement channel',
   [DjsErrorCodes.MessageExistingThread]: 'The message already has a thread',
   [DjsErrorCodes.ThreadInvitableType]: type => `Invitable cannot be edited on ${type}`,
 

packages/discord.js/src/index.js

@@ -161,7 +161,7 @@ exports.MessagePayload = require('./structures/MessagePayload');
 exports.MessageReaction = require('./structures/MessageReaction');
 exports.ModalSubmitInteraction = require('./structures/ModalSubmitInteraction');
 exports.ModalSubmitFields = require('./structures/ModalSubmitFields');
-exports.NewsChannel = require('./structures/NewsChannel');
+exports.AnnouncementChannel = require('./structures/AnnouncementChannel.js');
 exports.OAuth2Guild = require('./structures/OAuth2Guild');
 exports.PartialGroupDMChannel = require('./structures/PartialGroupDMChannel');
 exports.PermissionOverwrites = require('./structures/PermissionOverwrites');

packages/discord.js/src/managers/GuildChannelManager.js

@@ -99,23 +99,23 @@ class GuildChannelManager extends CachedManager {
   }
 
   /**
-   * Data that can be resolved to a News Channel object. This can be:
-   * * A NewsChannel object
+   * Data that can be resolved to an Announcement Channel object. This can be:
+   * * An Announcement Channel object
    * * A Snowflake
-   * @typedef {NewsChannel|Snowflake} NewsChannelResolvable
+   * @typedef {AnnouncementChannel|Snowflake} AnnouncementChannelResolvable
    */
 
   /**
    * Adds the target channel to a channel's followers.
-   * @param {NewsChannelResolvable} channel The channel to follow
+   * @param {AnnouncementChannelResolvable} channel The channel to follow
    * @param {TextChannelResolvable} targetChannel The channel where published announcements will be posted at
    * @param {string} [reason] Reason for creating the webhook
    * @returns {Promise<Snowflake>} Returns created target webhook id.
    */
   async addFollower(channel, targetChannel, reason) {
     const channelId = this.resolveId(channel);
     if (!channelId) {
-      throw new DiscordjsTypeError(ErrorCodes.InvalidType, 'channel', 'NewsChannelResolvable');
+      throw new DiscordjsTypeError(ErrorCodes.InvalidType, 'channel', 'AnnouncementChannelResolvable');
     }
     const targetChannelId = this.resolveId(targetChannel);
     if (!targetChannelId) {
@@ -208,7 +208,7 @@ class GuildChannelManager extends CachedManager {
 
   /**
    * @typedef {ChannelWebhookCreateOptions} WebhookCreateOptions
-   * @property {TextChannel|NewsChannel|VoiceChannel|StageChannel|ForumChannel|MediaChannel|Snowflake} channel
+   * @property {TextChannel|AnnouncementChannel|VoiceChannel|StageChannel|ForumChannel|MediaChannel|Snowflake} channel
    * The channel to create the webhook for
    */
 
@@ -247,7 +247,7 @@ class GuildChannelManager extends CachedManager {
    * Options used to edit a guild channel.
    * @typedef {Object} GuildChannelEditOptions
    * @property {string} [name] The name of the channel
-   * @property {ChannelType} [type] The type of the channel (only conversion between text and news is supported)
+   * @property {ChannelType} [type] The type of the channel (only conversion between text and announcement is supported)
    * @property {number} [position] The position of the channel
    * @property {?string} [topic] The topic of the text channel
    * @property {boolean} [nsfw] Whether the channel is NSFW

packages/discord.js/src/managers/GuildInviteManager.js

@@ -43,12 +43,12 @@ class GuildInviteManager extends CachedManager {
    * Data that can be resolved to a channel that an invite can be created on. This can be:
    * * TextChannel
    * * VoiceChannel
-   * * NewsChannel
+   * * AnnouncementChannel
    * * StageChannel
    * * ForumChannel
    * * MediaChannel
    * * Snowflake
-   * @typedef {TextChannel|VoiceChannel|NewsChannel|StageChannel|ForumChannel|MediaChannel|Snowflake}
+   * @typedef {TextChannel|VoiceChannel|AnnouncementChannel|StageChannel|ForumChannel|MediaChannel|Snowflake}
    * GuildInvitableChannelResolvable
    */
 

packages/discord.js/src/managers/GuildTextThreadManager.js

@@ -12,7 +12,7 @@ class GuildTextThreadManager extends ThreadManager {
   /**
    * The channel this Manager belongs to
    * @name GuildTextThreadManager#channel
-   * @type {TextChannel|NewsChannel}
+   * @type {TextChannel|AnnouncementChannel}
    */
 
   /**
@@ -22,7 +22,7 @@ class GuildTextThreadManager extends ThreadManager {
    * <warn>If this is defined, then the `type` of thread gets inferred automatically and cannot be changed.</warn>
    * @property {ThreadChannelTypes} [type] The type of thread to create.
    * Defaults to {@link ChannelType.PublicThread} if created in a {@link TextChannel}
-   * <warn>When creating threads in a {@link NewsChannel}, this is ignored and is always
+   * <warn>When creating threads in a {@link AnnouncementChannel}, this is ignored and is always
    * {@link ChannelType.AnnouncementThread}</warn>
    * @property {boolean} [invitable] Whether non-moderators can add other non-moderators to the thread
    * <info>Can only be set when type will be {@link ChannelType.PrivateThread}</info>

packages/discord.js/src/managers/ThreadManager.js

@@ -20,7 +20,7 @@ class ThreadManager extends CachedManager {
 
     /**
      * The channel this Manager belongs to
-     * @type {TextChannel|NewsChannel|ForumChannel|MediaChannel}
+     * @type {TextChannel|AnnouncementChannel|ForumChannel|MediaChannel}
      */
     this.channel = channel;
   }

packages/discord.js/src/structures/NewsChannel.js renamed to packages/discord.js/src/structures/AnnouncementChannel.js

@@ -5,15 +5,15 @@ const BaseGuildTextChannel = require('./BaseGuildTextChannel');
 const { DiscordjsError, ErrorCodes } = require('../errors');
 
 /**
- * Represents a guild news channel on Discord.
+ * Represents a guild announcement channel on Discord.
  * @extends {BaseGuildTextChannel}
  */
-class NewsChannel extends BaseGuildTextChannel {
+class AnnouncementChannel extends BaseGuildTextChannel {
   /**
    * Adds the target to this channel's followers.
    * @param {TextChannelResolvable} channel The channel where the webhook should be created
    * @param {string} [reason] Reason for creating the webhook
-   * @returns {Promise<NewsChannel>}
+   * @returns {Promise<AnnouncementChannel>}
    * @example
    * if (channel.type === ChannelType.GuildAnnouncement) {
    *   channel.addFollower('222197033908436994', 'Important announcements')
@@ -29,4 +29,4 @@ class NewsChannel extends BaseGuildTextChannel {
   }
 }
 
-module.exports = NewsChannel;
+module.exports = AnnouncementChannel;

packages/discord.js/src/structures/BaseGuildTextChannel.js

@@ -101,7 +101,7 @@ class BaseGuildTextChannel extends GuildChannel {
 
   /**
    * Sets the type of this channel.
-   * <info>Only conversion between {@link TextChannel} and {@link NewsChannel} is supported.</info>
+   * <info>Only conversion between {@link TextChannel} and {@link AnnouncementChannel} is supported.</info>
    * @param {ChannelType.GuildText|ChannelType.GuildAnnouncement} type The new channel type
    * @param {string} [reason] Reason for changing the channel's type
    * @returns {Promise<GuildChannel>}