Voice Channel Statuses

Author: DonovanDMC

lib/Constants.ts

@@ -470,6 +470,7 @@ export namespace Permissions {
     export const USE_EXTERNAL_SOUNDS                 = 35184372088832n; // 1 << 45
     export const SEND_VOICE_MESSAGES                 = 70368744177664n; // 1 << 46
     export const USE_CLYDE_AI                        = 140737488355328n;// 1 << 47
+    export const SET_VOICE_CHANNEL_STATUS            = 281474976710656n;// 1 << 48
 }
 
 // bigints can't be used as object keys, so we need to convert them to strings
@@ -533,7 +534,8 @@ export const VoicePermissions = [
     Permissions.USE_SOUNDBOARD,
     Permissions.USE_EXTERNAL_SOUNDS,
     Permissions.SEND_VOICE_MESSAGES,
-    Permissions.USE_CLYDE_AI
+    Permissions.USE_CLYDE_AI,
+    Permissions.SET_VOICE_CHANNEL_STATUS
 ] as const;
 export const AllVoicePermissions = VoicePermissions.reduce((all, p) => all | p, 0n);
 export const AllVoicePermissionNames = VoicePermissions.map(p => PermissionValueToName[String(p) as `${typeof p}`]);
@@ -919,8 +921,10 @@ export enum AuditLogActionTypes {
 
     HARMFUL_LINKS_BLOCKED_MESSAGE = 180,
 
-    HOME_SETTINGS_CREATE = 190,
-    HOME_SETTINGS_UPDATE = 191,
+    HOME_SETTINGS_CREATE        = 190,
+    HOME_SETTINGS_UPDATE        = 191,
+    VOICE_CHANNEL_STATUS_CREATE = 192,
+    VOICE_CHANNEL_STATUS_DELETE = 193,
 }
 
 export enum ApplicationCommandTypes {

lib/gateway/Shard.ts

@@ -1152,6 +1152,11 @@ export default class Shard extends TypedEmitter<ShardEvents> {
                 break;
             }
 
+            case "VOICE_CHANNEL_STATUS_UPDATE": {
+                this.client.emit("voiceChannelStatusUpdate", this.client.getChannel<VoiceChannel>(packet.d.id) ?? { id: packet.d.id }, packet.d.status);
+                break;
+            }
+
             case "VOICE_SERVER_UPDATE": {
                 // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-call
                 this.client.voiceAdapters.get(packet.d.guild_id)?.onVoiceServerUpdate(packet.d);

lib/structures/VoiceChannel.ts

@@ -7,12 +7,25 @@ import type { JSONVoiceChannel } from "../types/json";
 
 /** Represents a guild voice channel. */
 export default class VoiceChannel extends TextableVoiceChannel<VoiceChannel> {
+    /** The status of this voice channel. */
+    status: string | null;
     declare type: ChannelTypes.GUILD_VOICE;
     constructor(data: RawVoiceChannel, client: Client) {
         super(data, client);
+        this.status = null;
+        this.update(data);
+    }
+
+    protected override update(data: Partial<RawVoiceChannel>): void {
+        this.status = data.status ?? null;
+        super.update(data);
     }
 
     override toJSON(): JSONVoiceChannel {
-        return super.toJSON() as JSONVoiceChannel;
+        return {
+            ...super.toJSON(),
+            status: this.status,
+            type:   this.type
+        };
     }
 }

lib/types/channels.d.ts

@@ -84,6 +84,7 @@ export interface RawChannel {
     rate_limit_per_user?: number;
     recipients?: Array<RawUser>;
     rtc_region?: string | null;
+    status?: string | null;
     thread_metadata?: RawThreadMetadata;
     topic?: string | null;
     total_message_sent?: number;
@@ -98,7 +99,7 @@ export interface RawGroupChannel extends Required<Pick<RawChannel, "id" | "recip
 export interface RawTextChannel extends Omit<RawGuildChannel, "type">, Required<Pick<RawChannel, "default_auto_archive_duration" | "last_message_id" | "last_pin_timestamp" | "rate_limit_per_user" | "topic" | "nsfw" | "permission_overwrites" | "position">> { type: ChannelTypes.GUILD_TEXT; }
 export interface RawCategoryChannel extends Omit<RawGuildChannel, "type">, Required<Pick<RawChannel,  "permission_overwrites" | "position">> { type: ChannelTypes.GUILD_CATEGORY; }
 export interface RawAnnouncementChannel extends Omit<RawTextChannel, "type"> { type: ChannelTypes.GUILD_ANNOUNCEMENT; }
-export interface RawVoiceChannel extends Omit<RawGuildChannel, "type">, Required<Pick<RawChannel, "bitrate" | "user_limit" | "video_quality_mode" | "rtc_region" | "nsfw" | "topic" | "permission_overwrites" | "position" | "last_message_id" | "rate_limit_per_user">> { type: ChannelTypes.GUILD_VOICE; }
+export interface RawVoiceChannel extends Omit<RawGuildChannel, "type">, Required<Pick<RawChannel, "bitrate" | "user_limit" | "video_quality_mode" | "rtc_region" | "nsfw" | "topic" | "permission_overwrites" | "position" | "last_message_id" | "rate_limit_per_user" | "status">> { type: ChannelTypes.GUILD_VOICE; }
 export interface RawStageChannel extends Omit<RawVoiceChannel, "type"> { type: ChannelTypes.GUILD_STAGE_VOICE; }
 export type RawThreadChannel = RawAnnouncementThreadChannel | RawPublicThreadChannel | RawPrivateThreadChannel;
 export interface RawAnnouncementThreadChannel extends Required<Pick<RawChannel, "id" | "guild_id" | "parent_id" | "owner_id" | "last_message_id" | "thread_metadata" | "message_count" | "member_count" | "rate_limit_per_user" | "flags" | "total_message_sent" | "newly_created" | "member">> { name: string; type: ChannelTypes.ANNOUNCEMENT_THREAD; }

lib/types/events.d.ts

@@ -220,6 +220,8 @@ export interface ClientEvents {
     voiceChannelJoin: [member: Member, channel: VoiceChannel | StageChannel | Uncached];
     /** @event Emitted when a user leaves a voice channel. Requires the `GUILD_VOICE_STATES` intent. */
     voiceChannelLeave: [member: Member, channel: VoiceChannel | StageChannel | Uncached];
+    /** @event Emitted when a voice channel's status is updated. Requires the `GUILD_VOICE_STATES` intent. */
+    voiceChannelStatusUpdate: [channel: VoiceChannel | Uncached, status: string | null];
     /** @event Emitted when a user switches voice channels. Requires the `GUILD_VOICE_STATES` intent. */
     voiceChannelSwitch: [member: Member, channel: VoiceChannel | StageChannel | Uncached, oldChannel: VoiceChannel | StageChannel | Uncached | null];
     /** @event Emitted when a user's voice state is updated. Requires the `GUILD_VOICE_STATES` intent. */

lib/types/gateway-raw.d.ts

@@ -521,6 +521,11 @@ export interface VoiceChannelEffectSendPacket extends BaseDispatchPacket {
     t: "VOICE_CHANNEL_EFFECT_SEND";
 }
 
+export interface VoiceChannelStatusUpdatePacket extends BaseDispatchPacket {
+    d: { id: string; status: string | null; };
+    t: "VOICE_CHANNEL_STATUS_UPDATE";
+}
+
 export type AnyDispatchPacket = PresenceUpdatePacket | ReadyPacket | ResumedPacket |
 GuildCreatePacket | GuildDeletePacket | GuildUpdatePacket | ApplicationCommandPermissionsUpdatePacket | GuildAuditLogEntryCreatePacket |
 AutoModerationRuleCreatePacket | AutoModerationRuleDeletePacket | AutoModerationRuleUpdatePacket | AutoModerationActionExecutionPacket |
@@ -533,4 +538,4 @@ GuildScheduledEventCreatePacket | GuildScheduledEventDeletePacket | GuildSchedul
 IntegrationCreatePacket | IntegrationDeletePacket | IntegrationUpdatePacket |
 InviteCreatePacket | InviteDeletePacket |
 MessageCreatePacket | MessageDeletePacket | MessageDeleteBulkPacket | MessageUpdatePacket | MessageReactionAddPacket | MessageReactionRemovePacket | MessageReactionRemoveAllPacket | MessageReactionRemoveEmojiPacket |
-TypingStartPacket | UserUpdatePacket | VoiceStateUpdatePacket | VoiceChannelEffectSendPacket | VoiceServerUpdatePacket | WebhooksUpdatePacket | InteractionCreatePacket | StageInstanceCreatePacket | StageInstanceDeletePacket | StageInstanceUpdatePacket;
+TypingStartPacket | UserUpdatePacket | VoiceStateUpdatePacket | VoiceChannelEffectSendPacket | VoiceChannelStatusUpdatePacket | VoiceServerUpdatePacket | WebhooksUpdatePacket | InteractionCreatePacket | StageInstanceCreatePacket | StageInstanceDeletePacket | StageInstanceUpdatePacket;

lib/types/json.d.ts

@@ -621,6 +621,7 @@ export interface JSONUser extends JSONBase {
     username: string;
 }
 export interface JSONVoiceChannel extends JSONTextableVoiceChannel {
+    status: string | null;
     type: ChannelTypes.GUILD_VOICE;
 }
 export interface JSONVoiceState extends JSONBase {