refactor: deprecate invite stage instance (#7437)

packages/discord.js/src/structures/Invite.js

@@ -176,6 +176,7 @@ class Invite extends Base {
       /**
        * The stage instance data if there is a public {@link StageInstance} in the stage channel this invite is for
        * @type {?InviteStageInstance}
+       * @deprecated
        */
       this.stageInstance = new InviteStageInstance(this.client, data.stage_instance, this.channel.id, this.guild.id);
     } else {

packages/discord.js/src/structures/InviteStageInstance.js

@@ -6,6 +6,7 @@ const Base = require('./Base');
 /**
  * Represents the data about a public {@link StageInstance} in an {@link Invite}.
  * @extends {Base}
+ * @deprecated
  */
 class InviteStageInstance extends Base {
   constructor(client, data, channelId, guildId) {

packages/discord.js/typings/index.d.ts

@@ -1445,10 +1445,12 @@ export class Invite extends Base {
   public toJSON(): unknown;
   public toString(): string;
   public static INVITES_PATTERN: RegExp;
+  /** @deprecated */
   public stageInstance: InviteStageInstance | null;
   public guildScheduledEvent: GuildScheduledEvent | null;
 }
 
+/** @deprecated */
 export class InviteStageInstance extends Base {
   private constructor(client: Client, data: RawInviteStageInstance, channelId: Snowflake, guildId: Snowflake);
   public channelId: Snowflake;