Class DMChannel

Hierarchy

Channel
- DMChannel

Constructors

constructor

new DMChannel(client: Client, data: {
    _id: string;
    channel_type: "SavedMessages";
    user: string;
} | {
    _id: string;
    active: boolean;
    channel_type: "DirectMessage";
    last_message_id?: string;
    recipients: string[];
} | {
    _id: string;
    channel_type: "Group";
    description?: string;
    icon?: {
        _id: string;
        content_type: string;
        deleted?: boolean;
        filename: string;
        message_id?: string;
        metadata: {
            type: "File";
        } | {
            type: "Text";
        } | {
            height: number;
            type: "Image";
            width: number;
        } | {
            height: number;
            type: "Video";
            width: number;
        } | {
            type: "Audio";
        };
        object_id?: string;
        reported?: boolean;
        server_id?: string;
        size: number;
        tag: string;
        user_id?: string;
    };
    last_message_id?: string;
    name: string;
    nsfw?: boolean;
    owner: string;
    permissions?: number;
    recipients: string[];
} | {
    _id: string;
    channel_type: "TextChannel";
    default_permissions?: {
        a: number;
        d: number;
    };
    description?: string;
    icon?: {
        _id: string;
        content_type: string;
        deleted?: boolean;
        filename: string;
        message_id?: string;
        metadata: {
            type: "File";
        } | {
            type: "Text";
        } | {
            height: number;
            type: "Image";
            width: number;
        } | {
            height: number;
            type: "Video";
            width: number;
        } | {
            type: "Audio";
        };
        object_id?: string;
        reported?: boolean;
        server_id?: string;
        size: number;
        tag: string;
        user_id?: string;
    };
    last_message_id?: string;
    name: string;
    nsfw?: boolean;
    role_permissions?: {
        [key: string]: components["schemas"]["OverrideField"];
    };
    server: string;
} | {
    _id: string;
    channel_type: "VoiceChannel";
    default_permissions?: {
        a: number;
        d: number;
    };
    description?: string;
    icon?: {
        _id: string;
        content_type: string;
        deleted?: boolean;
        filename: string;
        message_id?: string;
        metadata: {
            type: "File";
        } | {
            type: "Text";
        } | {
            height: number;
            type: "Image";
            width: number;
        } | {
            height: number;
            type: "Video";
            width: number;
        } | {
            type: "Audio";
        };
        object_id?: string;
        reported?: boolean;
        server_id?: string;
        size: number;
        tag: string;
        user_id?: string;
    };
    name: string;
    nsfw?: boolean;
    role_permissions?: {
        [key: string]: components["schemas"]["OverrideField"];
    };
    server: string;
}): DMChannel
Parameters
- client: Client
- data: {
      _id: string;
      channel_type: "SavedMessages";
      user: string;
  } | {
      _id: string;
      active: boolean;
      channel_type: "DirectMessage";
      last_message_id?: string;
      recipients: string[];
  } | {
      _id: string;
      channel_type: "Group";
      description?: string;
      icon?: {
          _id: string;
          content_type: string;
          deleted?: boolean;
          filename: string;
          message_id?: string;
          metadata: {
              type: "File";
          } | {
              type: "Text";
          } | {
              height: number;
              type: "Image";
              width: number;
          } | {
              height: number;
              type: "Video";
              width: number;
          } | {
              type: "Audio";
          };
          object_id?: string;
          reported?: boolean;
          server_id?: string;
          size: number;
          tag: string;
          user_id?: string;
      };
      last_message_id?: string;
      name: string;
      nsfw?: boolean;
      owner: string;
      permissions?: number;
      recipients: string[];
  } | {
      _id: string;
      channel_type: "TextChannel";
      default_permissions?: {
          a: number;
          d: number;
      };
      description?: string;
      icon?: {
          _id: string;
          content_type: string;
          deleted?: boolean;
          filename: string;
          message_id?: string;
          metadata: {
              type: "File";
          } | {
              type: "Text";
          } | {
              height: number;
              type: "Image";
              width: number;
          } | {
              height: number;
              type: "Video";
              width: number;
          } | {
              type: "Audio";
          };
          object_id?: string;
          reported?: boolean;
          server_id?: string;
          size: number;
          tag: string;
          user_id?: string;
      };
      last_message_id?: string;
      name: string;
      nsfw?: boolean;
      role_permissions?: {
          [key: string]: components["schemas"]["OverrideField"];
      };
      server: string;
  } | {
      _id: string;
      channel_type: "VoiceChannel";
      default_permissions?: {
          a: number;
          d: number;
      };
      description?: string;
      icon?: {
          _id: string;
          content_type: string;
          deleted?: boolean;
          filename: string;
          message_id?: string;
          metadata: {
              type: "File";
          } | {
              type: "Text";
          } | {
              height: number;
              type: "Image";
              width: number;
          } | {
              height: number;
              type: "Video";
              width: number;
          } | {
              type: "Audio";
          };
          object_id?: string;
          reported?: boolean;
          server_id?: string;
          size: number;
          tag: string;
          user_id?: string;
      };
      name: string;
      nsfw?: boolean;
      role_permissions?: {
          [key: string]: components["schemas"]["OverrideField"];
      };
      server: string;
  }
Returns DMChannel
Overrides Channel.constructor
- Defined in core/src/objects/DMChannel.ts:13

Properties

client

client: Client

deleted

deleted: boolean = false

messages

messages: MessageManager

typingIDs

typingIDs: Set<string> = ...

Can include your own user ID.

Accessors

`Protected` _id

get _id(): ""
Returns ""
Inherited from Channel._id
- Defined in core/src/objects/BaseObject.ts:10

active

get active(): boolean
Will be false if the DM is closed.

Returns boolean
- Defined in core/src/objects/DMChannel.ts:18

createdAt

get createdAt(): number
Returns number
Inherited from Channel.createdAt
- Defined in core/src/objects/BaseObject.ts:19

description

get description(): string
Returns string
Inherited from Channel.description
- Defined in core/src/objects/Channel.ts:77

icon

get icon(): Attachment
Returns Attachment
Inherited from Channel.icon
- Defined in core/src/objects/Channel.ts:88

id

get id(): string
Returns string
Inherited from Channel.id
- Defined in core/src/objects/BaseObject.ts:16

lastMessage

get lastMessage(): BaseMessage
Returns BaseMessage
Inherited from Channel.lastMessage
- Defined in core/src/objects/Channel.ts:125

lastMessageID

get lastMessageID(): string
Returns string
Inherited from Channel.lastMessageID
- Defined in core/src/objects/Channel.ts:120

mentions

get mentions(): string[]
Returns string[]
Inherited from Channel.mentions
- Defined in core/src/objects/Channel.ts:169

name

get name(): string
Returns string
Inherited from Channel.name
- Defined in core/src/objects/Channel.ts:71

nsfw

get nsfw(): boolean
Returns boolean
Inherited from Channel.nsfw
- Defined in core/src/objects/Channel.ts:82

permissions

get permissions(): PermissionFlags
Returns PermissionFlags
Inherited from Channel.permissions
- Defined in core/src/objects/Channel.ts:107

recipient

get recipient(): User
Returns User
- Defined in core/src/objects/DMChannel.ts:25

recipientID

get recipientID(): string
Returns string
- Defined in core/src/objects/DMChannel.ts:22

source

get source(): {
    _id: string;
    active: boolean;
    channel_type: "DirectMessage";
    last_message_id?: string;
    recipients: string[];
}
Original API object.

Returns {
    _id: string;
    active: boolean;
    channel_type: "DirectMessage";
    last_message_id?: string;
    recipients: string[];
}
- _id: string
  
  Description
  Unique Id
- active: boolean
  
  Description
  Whether this direct message channel is currently open on both sides
- channel_type: "DirectMessage"
- Optional last_message_id?: string
  
  Description
  Id of the last message sent in this channel
- recipients: string[]
  
  Description
  2-tuple of user ids participating in direct message
Overrides Channel.source
- Defined in core/src/objects/DMChannel.ts:9

type

get type(): DM
Returns DM
Overrides Channel.type
- Defined in core/src/objects/DMChannel.ts:6

typing

get typing(): User[]
Will not include your user.

Returns User[]
Inherited from Channel.typing
- Defined in core/src/objects/Channel.ts:142

unread

get unread(): boolean
Returns boolean
Inherited from Channel.unread
- Defined in core/src/objects/Channel.ts:159

Methods

ack

ack(message?: string | BaseMessage): Promise<void>
Mark a specific message as read/unread.
Parameters
- Optional message: string | BaseMessage
Returns Promise<void>
Inherited from Channel.ack
- Defined in core/src/objects/Channel.ts:174

checkUnread

checkUnread(valid: ChannelUnreadChecker): any
Parameters
- valid: ChannelUnreadChecker
Returns any
Inherited from Channel.checkUnread
- Defined in core/src/objects/Channel.ts:155

createInvite

createInvite(): Promise<ServerInvite>
Returns Promise<ServerInvite>
Inherited from Channel.createInvite
- Defined in core/src/objects/Channel.ts:113

delete

delete(silent?: boolean): Promise<void>
Delete or leave this channel.
Parameters
- Optional silent: boolean
Returns Promise<void>
Inherited from Channel.delete
- Defined in core/src/objects/Channel.ts:219

edit

edit(data: {
    archived?: boolean;
    description?: string;
    icon?: string;
    name?: string;
    nsfw?: boolean;
    owner?: string;
    remove?: ("Description" | "Icon" | "DefaultPermissions")[];
}): Promise<DMChannel>
Parameters
- data: {
      archived?: boolean;
      description?: string;
      icon?: string;
      name?: string;
      nsfw?: boolean;
      owner?: string;
      remove?: ("Description" | "Icon" | "DefaultPermissions")[];
  }
  - Optional archived?: boolean
    
    Description
    Whether this channel is archived
  - Optional description?: string
    
    Description
    Channel description
  - Optional icon?: string
    
    Description
    Icon
    
    Provide an Autumn attachment Id.
  - Optional name?: string
    
    Description
    Channel name
  - Optional nsfw?: boolean
    
    Description
    Whether this channel is age-restricted
  - Optional owner?: string
    
    Description
    Group owner
  - Optional remove?: ("Description" | "Icon" | "DefaultPermissions")[]
Returns Promise<DMChannel>
Inherited from Channel.edit
- Defined in core/src/objects/Channel.ts:215

fetchLastMessage

fetchLastMessage(): Promise<BaseMessage>
Returns Promise<BaseMessage>
Inherited from Channel.fetchLastMessage
- Defined in core/src/objects/Channel.ts:128

fetchMessage

fetchMessage(id: string): Promise<BaseMessage>
Parameters
- id: string
Returns Promise<BaseMessage>
Inherited from Channel.fetchMessage
- Defined in core/src/objects/Channel.ts:211

fetchRecipient

fetchRecipient(): Promise<User>
Returns Promise<User>
- Defined in core/src/objects/DMChannel.ts:28

fireUpdate

fireUpdate(updated?: any[]): void
Runs all of the callbacks for this emitter. (meant to run when an update occurs)
Parameters
- Optional updated: any[]
  
  The objects that caused this update.
Returns void
Inherited from Channel.fireUpdate
- Defined in core/src/utils/MiniEmitter.ts:33

generateIconURL

generateIconURL(...args: AttachmentArgs): any
Parameters
- Rest ...args: AttachmentArgs
Returns any
Inherited from Channel.generateIconURL
- Defined in core/src/objects/Channel.ts:94

getMentions

getMentions(valid: ChannelUnreadChecker): any
Parameters
- valid: ChannelUnreadChecker
Returns any
Inherited from Channel.getMentions
- Defined in core/src/objects/Channel.ts:165

isDM

isDM(): this is DMChannel
Returns this is DMChannel
Inherited from Channel.isDM
- Defined in core/src/objects/Channel.ts:51

isText

isText(): this is TextChannel
Returns this is TextChannel
Inherited from Channel.isText
- Defined in core/src/objects/Channel.ts:45

isTextBased

isTextBased(): this is TextChannel | DMChannel | GroupDMChannel | SavedMessagesChannel
Returns this is TextChannel | DMChannel | GroupDMChannel | SavedMessagesChannel
Inherited from Channel.isTextBased
- Defined in core/src/objects/Channel.ts:61

isVoice

isVoice(): this is VoiceChannel
Returns this is VoiceChannel
Inherited from Channel.isVoice
- Defined in core/src/objects/Channel.ts:48

joinCall

joinCall(): Promise<string>
Request a call join token.

Returns Promise<string>
- Defined in core/src/objects/DMChannel.ts:33

lastMessageBy

lastMessageBy(user: User): Message
Parameters
- user: User
Returns Message
Inherited from Channel.lastMessageBy
- Defined in core/src/objects/Channel.ts:132

markRead

markRead(useSeparate?: boolean): Promise<void>
Syncs unreads from server and marks channel as read if unread.
Parameters
- useSeparate: boolean = false
  
  If true, will create a new unread object to avoid 'unread flashing'.
Returns Promise<void>
Inherited from Channel.markRead
- Defined in core/src/objects/Channel.ts:183

offUpdate

offUpdate(callback: MiniEmitterCallback<any>): DMChannel
Stops listening for Map updates.

Returns
this, useful for chaining.
Parameters
- callback: MiniEmitterCallback<any>
  
  The callback to stop listening for updates on.
Returns DMChannel
Inherited from Channel.offUpdate
- Defined in core/src/utils/MiniEmitter.ts:24

onUpdate

onUpdate(callback: MiniEmitterCallback<any>): DMChannel
Listen for an update to this Map.

Returns
this, useful for chaining.
Parameters
- callback: MiniEmitterCallback<any>
  
  The callback to run when an update occurs.
Returns DMChannel
Inherited from Channel.onUpdate
- Defined in core/src/utils/MiniEmitter.ts:15

permissionsFor

permissionsFor(member: Member): PermissionFlags
Parameters
- member: Member
Returns PermissionFlags
Inherited from Channel.permissionsFor
- Defined in core/src/objects/Channel.ts:110

send

send(data: MessagePayload): Promise<Message>
Set expandMentions to automatically turn plaintext user mentions into 'real' ones. Set expandEmojis to do the same for emojis (using uniqueName).
Parameters
- data: MessagePayload
Returns Promise<Message>
Inherited from Channel.send
- Defined in core/src/objects/Channel.ts:201

setPermissions

setPermissions(role: Role | "default", permissions: {
allow: number;
deny: number;
}): Promise<void>
Set permissions for a role or 'default' for everyone.
Parameters
- role: Role | "default"
- permissions: {
  allow: number;
  deny: number;
  }
  - allow: number
    
    Format: uint64
    
    Description
    Allow bit flags
  - deny: number
    
    Format: uint64
    
    Description
    Disallow bit flags
Returns Promise<void>
Inherited from Channel.setPermissions
- Defined in core/src/objects/Channel.ts:99

startTyping

startTyping(): void
Returns void
Inherited from Channel.startTyping
- Defined in core/src/objects/Channel.ts:148

stopTyping

stopTyping(): void
Returns void
Inherited from Channel.stopTyping
- Defined in core/src/objects/Channel.ts:151

toString

toString(): string
Returns
The channel formatted for markdown. <#id>

Returns string
Inherited from Channel.toString
- Defined in core/src/objects/Channel.ts:228

update

update(data?: Partial<{
    _id: string;
    channel_type: "SavedMessages";
    user: string;
} | {
    _id: string;
    active: boolean;
    channel_type: "DirectMessage";
    last_message_id?: string;
    recipients: string[];
} | {
    _id: string;
    channel_type: "Group";
    description?: string;
    icon?: {
        _id: string;
        content_type: string;
        deleted?: boolean;
        filename: string;
        message_id?: string;
        metadata: {
            type: "File";
        } | {
            type: "Text";
        } | {
            height: number;
            type: "Image";
            width: number;
        } | {
            height: number;
            type: "Video";
            width: number;
        } | {
            type: "Audio";
        };
        object_id?: string;
        reported?: boolean;
        server_id?: string;
        size: number;
        tag: string;
        user_id?: string;
    };
    last_message_id?: string;
    name: string;
    nsfw?: boolean;
    owner: string;
    permissions?: number;
    recipients: string[];
} | {
    _id: string;
    channel_type: "TextChannel";
    default_permissions?: {
        a: number;
        d: number;
    };
    description?: string;
    icon?: {
        _id: string;
        content_type: string;
        deleted?: boolean;
        filename: string;
        message_id?: string;
        metadata: {
            type: "File";
        } | {
            type: "Text";
        } | {
            height: number;
            type: "Image";
            width: number;
        } | {
            height: number;
            type: "Video";
            width: number;
        } | {
            type: "Audio";
        };
        object_id?: string;
        reported?: boolean;
        server_id?: string;
        size: number;
        tag: string;
        user_id?: string;
    };
    last_message_id?: string;
    name: string;
    nsfw?: boolean;
    role_permissions?: {
        [key: string]: components["schemas"]["OverrideField"];
    };
    server: string;
} | {
    _id: string;
    channel_type: "VoiceChannel";
    default_permissions?: {
        a: number;
        d: number;
    };
    description?: string;
    icon?: {
        _id: string;
        content_type: string;
        deleted?: boolean;
        filename: string;
        message_id?: string;
        metadata: {
            type: "File";
        } | {
            type: "Text";
        } | {
            height: number;
            type: "Image";
            width: number;
        } | {
            height: number;
            type: "Video";
            width: number;
        } | {
            type: "Audio";
        };
        object_id?: string;
        reported?: boolean;
        server_id?: string;
        size: number;
        tag: string;
        user_id?: string;
    };
    name: string;
    nsfw?: boolean;
    role_permissions?: {
        [key: string]: components["schemas"]["OverrideField"];
    };
    server: string;
}>): DMChannel
Update this object with new API data.
Parameters
- data: Partial<{
      _id: string;
      channel_type: "SavedMessages";
      user: string;
  } | {
      _id: string;
      active: boolean;
      channel_type: "DirectMessage";
      last_message_id?: string;
      recipients: string[];
  } | {
      _id: string;
      channel_type: "Group";
      description?: string;
      icon?: {
          _id: string;
          content_type: string;
          deleted?: boolean;
          filename: string;
          message_id?: string;
          metadata: {
              type: "File";
          } | {
              type: "Text";
          } | {
              height: number;
              type: "Image";
              width: number;
          } | {
              height: number;
              type: "Video";
              width: number;
          } | {
              type: "Audio";
          };
          object_id?: string;
          reported?: boolean;
          server_id?: string;
          size: number;
          tag: string;
          user_id?: string;
      };
      last_message_id?: string;
      name: string;
      nsfw?: boolean;
      owner: string;
      permissions?: number;
      recipients: string[];
  } | {
      _id: string;
      channel_type: "TextChannel";
      default_permissions?: {
          a: number;
          d: number;
      };
      description?: string;
      icon?: {
          _id: string;
          content_type: string;
          deleted?: boolean;
          filename: string;
          message_id?: string;
          metadata: {
              type: "File";
          } | {
              type: "Text";
          } | {
              height: number;
              type: "Image";
              width: number;
          } | {
              height: number;
              type: "Video";
              width: number;
          } | {
              type: "Audio";
          };
          object_id?: string;
          reported?: boolean;
          server_id?: string;
          size: number;
          tag: string;
          user_id?: string;
      };
      last_message_id?: string;
      name: string;
      nsfw?: boolean;
      role_permissions?: {
          [key: string]: components["schemas"]["OverrideField"];
      };
      server: string;
  } | {
      _id: string;
      channel_type: "VoiceChannel";
      default_permissions?: {
          a: number;
          d: number;
      };
      description?: string;
      icon?: {
          _id: string;
          content_type: string;
          deleted?: boolean;
          filename: string;
          message_id?: string;
          metadata: {
              type: "File";
          } | {
              type: "Text";
          } | {
              height: number;
              type: "Image";
              width: number;
          } | {
              height: number;
              type: "Video";
              width: number;
          } | {
              type: "Audio";
          };
          object_id?: string;
          reported?: boolean;
          server_id?: string;
          size: number;
          tag: string;
          user_id?: string;
      };
      name: string;
      nsfw?: boolean;
      role_permissions?: {
          [key: string]: components["schemas"]["OverrideField"];
      };
      server: string;
  }> = {}
Returns DMChannel
Inherited from Channel.update
- Defined in core/src/objects/BaseObject.ts:24

Class DMChannel

Hierarchy

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

client: Client

Returns DMChannel

Properties

client

deleted

messages

typingIDs

Accessors

Protected _id

Returns ""

active

Returns boolean

createdAt

Returns number

description

Returns string

icon

Returns Attachment

id

Returns string

lastMessage

Returns BaseMessage

lastMessageID

Returns string

mentions

Returns string[]

name

Returns string

nsfw

Returns boolean

permissions

Returns PermissionFlags

recipient

Returns User

recipientID

Returns string

source

Returns { _id: string; active: boolean; channel_type: "DirectMessage"; last_message_id?: string; recipients: string[]; }

_id: string

Description

active: boolean

Description

channel_type: "DirectMessage"

Optional last_message_id?: string

Description

recipients: string[]

Description

type

Returns DM

typing

Returns User[]

unread

Returns boolean

Methods

ack

Parameters

Optional message: string | BaseMessage

Returns Promise<void>

checkUnread

Parameters

valid: ChannelUnreadChecker

Returns any

createInvite

Returns Promise<ServerInvite>

delete

Parameters

Optional silent: boolean

Returns Promise<void>

edit

Parameters

`Protected` _id

Returns {
_id: string;
active: boolean;
channel_type: "DirectMessage";
last_message_id?: string;
recipients: string[];
}

`Optional` last_message_id?: string

`Optional` message: string | BaseMessage

`Optional` silent: boolean

data: {
archived?: boolean;
description?: string;
icon?: string;
name?: string;
nsfw?: boolean;
owner?: string;
remove?: ("Description" | "Icon" | "DefaultPermissions")[];
}

`Optional` archived?: boolean

`Optional` description?: string

`Optional` icon?: string

`Optional` name?: string

`Optional` nsfw?: boolean

`Optional` owner?: string

`Optional` remove?: ("Description" | "Icon" | "DefaultPermissions")[]

`Optional` updated: any[]

`Rest` ...args: AttachmentArgs