feat(GuildMember): add method to check timeout

src/structures/GuildMember.js

@@ -302,6 +302,17 @@ class GuildMember extends Base {
     return this.manageable && (this.guild.me?.permissions.has(Permissions.FLAGS.MODERATE_MEMBERS) ?? false);
   }
 
+  /**
+   * Whether this member is already under time out
+   * @returns {boolean}
+   */
+  isTimedOut() {
+    return (
+      typeof this.communicationDisabledUntilTimestamp === 'number' &&
+      this.communicationDisabledUntilTimestamp > Date.now()
+    );
+  }
+
   /**
    * Returns `channel.permissionsFor(guildMember)`. Returns permissions for a member in a guild channel,
    * taking into account roles and permission overwrites.

typings/index.d.ts

@@ -469,9 +469,10 @@ export type KeyedEnum<K, T> = {
   [Key in keyof K]: T | string;
 };
 
-export type EnumValueMapped<E extends KeyedEnum<T, number>, T extends Partial<Record<keyof E, unknown>>> = T & {
-  [Key in keyof T as E[Key]]: T[Key];
-};
+export type EnumValueMapped<E extends KeyedEnum<T, number>, T extends Partial<Record<keyof E, unknown>>> = T &
+  {
+    [Key in keyof T as E[Key]]: T[Key];
+  };
 
 export type MappedChannelCategoryTypes = EnumValueMapped<
   typeof ChannelTypes,
@@ -1122,6 +1123,10 @@ export class GuildMember extends PartialTextBasedChannel(Base) {
   public deleteDM(): Promise<DMChannel>;
   public displayAvatarURL(options?: ImageURLOptions): string;
   public edit(data: GuildMemberEditData, reason?: string): Promise<GuildMember>;
+  public isTimedOut(): this is GuildMember & {
+    communicationDisabledUntilTimestamp: number;
+    communicationDisabledUntil: Date;
+  };
   public kick(reason?: string): Promise<GuildMember>;
   public permissionsIn(channel: GuildChannelResolvable): Readonly<Permissions>;
   public setNickname(nickname: string | null, reason?: string): Promise<GuildMember>;