/** * Types extracted from https://discord.com/developers/docs/resources/channel */ import type { Permissions, Snowflake } from '../../globals'; import type { _NonNullableFields } from '../../utils/internals'; import type { APIApplication } from './application'; import type { APIPartialEmoji } from './emoji'; import type { APIGuildMember } from './guild'; import type { APIInteractionDataResolved, APIMessageInteraction, APIMessageInteractionMetadata } from './interactions'; import type { APIRole } from './permissions'; import type { APIPoll } from './poll'; import type { APISticker, APIStickerItem } from './sticker'; import type { APIUser } from './user'; /** * Not documented, but partial only includes id, name, and type */ export interface APIPartialChannel { /** * The id of the channel */ id: Snowflake; /** * The type of the channel * * @see {@link https://discord.com/developers/docs/resources/channel#channel-object-channel-types} */ type: ChannelType; /** * The name of the channel (1-100 characters) */ name?: string | null; } /** * A channel obtained from fetching an invite. */ export interface APIInviteChannel extends Required { /** * Icon hash. */ icon?: string | undefined; /** * The invite channel's recipients. * * @remarks Only includes usernames of users. */ recipients?: Pick[] | undefined; } /** * Source channel of channel follower webhooks. */ export type APIWebhookSourceChannel = Required<_NonNullableFields>>; /** * This interface is used to allow easy extension for other channel types. While * also allowing `APIPartialChannel` to be used without breaking. */ export interface APIChannelBase extends APIPartialChannel { type: T; flags?: ChannelFlags; } export type TextChannelType = ChannelType.AnnouncementThread | ChannelType.DM | ChannelType.GroupDM | ChannelType.GuildAnnouncement | ChannelType.GuildStageVoice | ChannelType.GuildText | ChannelType.GuildVoice | ChannelType.PrivateThread | ChannelType.PublicThread; export type GuildChannelType = Exclude; export interface APITextBasedChannel extends APIChannelBase { /** * The id of the last message sent in this channel (may not point to an existing or valid message) */ last_message_id?: Snowflake | null; /** * When the last pinned message was pinned. * This may be `null` in events such as `GUILD_CREATE` when a message is not pinned */ last_pin_timestamp?: string | null; /** * Amount of seconds a user has to wait before sending another message (0-21600); * bots, as well as users with the permission `MANAGE_MESSAGES` or `MANAGE_CHANNELS`, are unaffected * * `rate_limit_per_user` also applies to thread creation. Users can send one message and create one thread during each `rate_limit_per_user` interval. * * For thread channels, `rate_limit_per_user` is only returned if the field is set to a non-zero and non-null value. * The absence of this field in API calls and Gateway events should indicate that slowmode has been reset to the default value. */ rate_limit_per_user?: number; } export interface APISortableChannel { /** * Sorting position of the channel */ position: number; } export interface APIGuildChannel extends Omit, 'name'> { /** * The name of the channel (1-100 characters) */ name: string; /** * The id of the guild (may be missing for some channel objects received over gateway guild dispatches) */ guild_id?: Snowflake; /** * Explicit permission overwrites for members and roles * * @see {@link https://discord.com/developers/docs/resources/channel#overwrite-object} */ permission_overwrites?: APIOverwrite[]; /** * ID of the parent category for a channel (each parent category can contain up to 50 channels) * * OR * * ID of the parent channel for a thread */ parent_id?: Snowflake | null; /** * Whether the channel is nsfw */ nsfw?: boolean; } export type GuildTextChannelType = Exclude; export interface APIGuildTextChannel extends Omit, 'name'>, APIGuildChannel, APISortableChannel { /** * Default duration for newly created threads, in minutes, to automatically archive the thread after recent activity */ default_auto_archive_duration?: ThreadAutoArchiveDuration; /** * The initial `rate_limit_per_user` to set on newly created threads. * This field is copied to the thread at creation time and does not live update */ default_thread_rate_limit_per_user?: number; /** * The channel topic (0-1024 characters) */ topic?: string | null; } export type APITextChannel = APIGuildTextChannel; export type APINewsChannel = APIGuildTextChannel; export interface APIGuildCategoryChannel extends APIGuildChannel, APISortableChannel { } export interface APIVoiceChannelBase extends APIGuildChannel, APISortableChannel, Omit, 'last_pin_timestamp' | 'name'> { /** * The bitrate (in bits) of the voice or stage channel */ bitrate?: number; /** * The user limit of the voice or stage channel */ user_limit?: number; /** * Voice region id for the voice or stage channel, automatic when set to `null` * * @see {@link https://discord.com/developers/docs/resources/voice#voice-region-object} */ rtc_region?: string | null; /** * The camera video quality mode of the voice or stage channel, `1` when not present * * @see {@link https://discord.com/developers/docs/resources/channel#channel-object-video-quality-modes} */ video_quality_mode?: VideoQualityMode; } export type APIGuildVoiceChannel = APIVoiceChannelBase; export type APIGuildStageVoiceChannel = APIVoiceChannelBase; export interface APIDMChannelBase extends Omit, 'rate_limit_per_user'> { /** * The recipients of the DM * * @see {@link https://discord.com/developers/docs/resources/user#user-object} */ recipients?: APIUser[]; } export interface APIDMChannel extends Omit, 'name'> { /** * The name of the channel (always null for DM channels) */ name: null; } export interface APIGroupDMChannel extends Omit, 'name'> { /** * The name of the channel (1-100 characters) */ name: string | null; /** * Application id of the group DM creator if it is bot-created */ application_id?: Snowflake; /** * Icon hash */ icon?: string | null; /** * ID of the DM creator */ owner_id?: Snowflake; /** * The id of the last message sent in this channel (may not point to an existing or valid message) */ last_message_id?: Snowflake | null; /** * Whether the channel is managed by an OAuth2 application */ managed?: boolean; } export type ThreadChannelType = ChannelType.AnnouncementThread | ChannelType.PrivateThread | ChannelType.PublicThread; export interface APIThreadChannel extends Omit, 'name'>, APIGuildChannel { /** * The client users member for the thread, only included in select endpoints */ member?: APIThreadMember; /** * The metadata for a thread channel not shared by other channels */ thread_metadata?: APIThreadMetadata; /** * Number of messages (not including the initial message or deleted messages) in a thread * * If the thread was created before July 1, 2022, it stops counting at 50 messages */ message_count?: number; /** * The approximate member count of the thread, does not count above 50 even if there are more members */ member_count?: number; /** * ID of the thread creator */ owner_id?: Snowflake; /** * Number of messages ever sent in a thread * * Similar to `message_count` on message creation, but won't decrement when a message is deleted */ total_message_sent?: number; /** * The IDs of the set of tags that have been applied to a thread in a thread-only channel */ applied_tags: Snowflake[]; } export type APIPublicThreadChannel = APIThreadChannel; export type APIPrivateThreadChannel = APIThreadChannel; export type APIAnnouncementThreadChannel = APIThreadChannel; /** * @see {@link https://discord.com/developers/docs/resources/channel#forum-tag-object-forum-tag-structure} */ export interface APIGuildForumTag { /** * The id of the tag */ id: Snowflake; /** * The name of the tag (0-20 characters) */ name: string; /** * Whether this tag can only be added to or removed from threads by a member with the `MANAGE_THREADS` permission */ moderated: boolean; /** * The id of a guild's custom emoji */ emoji_id: Snowflake | null; /** * The unicode character of the emoji */ emoji_name: string | null; } /** * @see {@link https://discord.com/developers/docs/resources/channel#default-reaction-object-default-reaction-structure} */ export interface APIGuildForumDefaultReactionEmoji { /** * The id of a guild's custom emoji */ emoji_id: Snowflake | null; /** * The unicode character of the emoji */ emoji_name: string | null; } /** * @see {@link https://discord.com/developers/docs/resources/channel/#channel-object-sort-order-types} */ export declare enum SortOrderType { /** * Sort forum posts by activity */ LatestActivity = 0, /** * Sort forum posts by creation time (from most recent to oldest) */ CreationDate = 1 } /** * @see {@link https://discord.com/developers/docs/resources/channel/#channel-object-forum-layout-types} */ export declare enum ForumLayoutType { /** * No default has been set for forum channel */ NotSet = 0, /** * Display posts as a list */ ListView = 1, /** * Display posts as a collection of tiles */ GalleryView = 2 } export interface APIThreadOnlyChannel extends APIGuildChannel, APISortableChannel { /** * The channel topic (0-4096 characters) */ topic?: string | null; /** * The id of the last thread created in this channel (may not point to an existing or valid thread) */ last_message_id?: Snowflake | null; /** * Amount of seconds a user has to wait before creating another thread (0-21600); * bots, as well as users with the permission `MANAGE_MESSAGES` or `MANAGE_CHANNELS`, are unaffected * * The absence of this field in API calls and Gateway events should indicate that slowmode has been reset to the default value. */ rate_limit_per_user?: number; /** * When the last pinned message was pinned. * This may be `null` in events such as `GUILD_CREATE` when a message is not pinned */ last_pin_timestamp?: string | null; /** * Default duration for newly created threads, in minutes, to automatically archive the thread after recent activity */ default_auto_archive_duration?: ThreadAutoArchiveDuration; /** * The set of tags that can be used in a thread-only channel */ available_tags: APIGuildForumTag[]; /** * The initial `rate_limit_per_user` to set on newly created threads. * This field is copied to the thread at creation time and does not live update */ default_thread_rate_limit_per_user?: number; /** * The emoji to show in the add reaction button on a thread in a thread-only channel */ default_reaction_emoji: APIGuildForumDefaultReactionEmoji | null; /** * The default sort order type used to order posts in a thread-only channel */ default_sort_order: SortOrderType | null; } export interface APIGuildForumChannel extends APIThreadOnlyChannel { /** * The default layout type used to display posts in a forum channel * * @defaultValue `ForumLayoutType.NotSet` which indicates a layout view has not been set by a channel admin */ default_forum_layout: ForumLayoutType; } export type APIGuildMediaChannel = APIThreadOnlyChannel; /** * @see {@link https://discord.com/developers/docs/resources/channel#channel-object-channel-structure} */ export type APIChannel = APIAnnouncementThreadChannel | APIDMChannel | APIGroupDMChannel | APIGuildCategoryChannel | APIGuildForumChannel | APIGuildMediaChannel | APIGuildStageVoiceChannel | APIGuildVoiceChannel | APINewsChannel | APIPrivateThreadChannel | APIPublicThreadChannel | APITextChannel; /** * @see {@link https://discord.com/developers/docs/resources/channel#channel-object-channel-types} */ export declare enum ChannelType { /** * A text channel within a guild */ GuildText = 0, /** * A direct message between users */ DM = 1, /** * A voice channel within a guild */ GuildVoice = 2, /** * A direct message between multiple users */ GroupDM = 3, /** * An organizational category that contains up to 50 channels * * @see {@link https://support.discord.com/hc/articles/115001580171} */ GuildCategory = 4, /** * A channel that users can follow and crosspost into their own guild * * @see {@link https://support.discord.com/hc/articles/360032008192} */ GuildAnnouncement = 5, /** * A temporary sub-channel within a Guild Announcement channel */ AnnouncementThread = 10, /** * A temporary sub-channel within a Guild Text or Guild Forum channel */ PublicThread = 11, /** * A temporary sub-channel within a Guild Text channel that is only viewable by those invited and those with the Manage Threads permission */ PrivateThread = 12, /** * A voice channel for hosting events with an audience * * @see {@link https://support.discord.com/hc/articles/1500005513722} */ GuildStageVoice = 13, /** * The channel in a Student Hub containing the listed servers * * @see {@link https://support.discord.com/hc/articles/4406046651927} */ GuildDirectory = 14, /** * A channel that can only contain threads */ GuildForum = 15, /** * A channel like forum channels but contains media for server subscriptions * * @see {@link https://creator-support.discord.com/hc/articles/14346342766743} */ GuildMedia = 16, /** * A channel that users can follow and crosspost into their own guild * * @deprecated This is the old name for {@link ChannelType.GuildAnnouncement} * @see {@link https://support.discord.com/hc/articles/360032008192} */ GuildNews = 5, /** * A temporary sub-channel within a Guild Announcement channel * * @deprecated This is the old name for {@link ChannelType.AnnouncementThread} */ GuildNewsThread = 10, /** * A temporary sub-channel within a Guild Text channel * * @deprecated This is the old name for {@link ChannelType.PublicThread} */ GuildPublicThread = 11, /** * A temporary sub-channel within a Guild Text channel that is only viewable by those invited and those with the Manage Threads permission * * @deprecated This is the old name for {@link ChannelType.PrivateThread} */ GuildPrivateThread = 12 } export declare enum VideoQualityMode { /** * Discord chooses the quality for optimal performance */ Auto = 1, /** * 720p */ Full = 2 } /** * @see {@link https://discord.com/developers/docs/resources/channel#message-object-message-structure} */ export interface APIMessage { /** * ID of the message */ id: Snowflake; /** * ID of the channel the message was sent in */ channel_id: Snowflake; /** * The author of this message (only a valid user in the case where the message is generated by a user or bot user) * * If the message is generated by a webhook, the author object corresponds to the webhook's id, * username, and avatar. You can tell if a message is generated by a webhook by checking for the `webhook_id` property * * @see {@link https://discord.com/developers/docs/resources/user#user-object} */ author: APIUser; /** * Contents of the message * * The `MESSAGE_CONTENT` privileged gateway intent is required for verified applications to receive a non-empty value from this field * * In the Discord Developers Portal, you need to enable the toggle of this intent of your application in **Bot \> Privileged Gateway Intents**. * You also need to specify the intent bit value (`1 << 15`) if you are connecting to the gateway * * @see {@link https://support-dev.discord.com/hc/articles/6207308062871} */ content: string; /** * When this message was sent */ timestamp: string; /** * When this message was edited (or null if never) */ edited_timestamp: string | null; /** * Whether this was a TTS message */ tts: boolean; /** * Whether this message mentions everyone */ mention_everyone: boolean; /** * Users specifically mentioned in the message * * The `member` field is only present in `MESSAGE_CREATE` and `MESSAGE_UPDATE` events * from text-based guild channels * * @see {@link https://discord.com/developers/docs/resources/user#user-object} * @see {@link https://discord.com/developers/docs/resources/guild#guild-member-object} */ mentions: APIUser[]; /** * Roles specifically mentioned in this message * * @see {@link https://discord.com/developers/docs/topics/permissions#role-object} */ mention_roles: APIRole['id'][]; /** * Channels specifically mentioned in this message * * Not all channel mentions in a message will appear in `mention_channels`. * - Only textual channels that are visible to everyone in a lurkable guild will ever be included * - Only crossposted messages (via Channel Following) currently include `mention_channels` at all * * If no mentions in the message meet these requirements, this field will not be sent * * @see {@link https://discord.com/developers/docs/resources/channel#channel-mention-object} */ mention_channels?: APIChannelMention[]; /** * Any attached files * * @see {@link https://discord.com/developers/docs/resources/message#attachment-object-attachment-structure} * * The `MESSAGE_CONTENT` privileged gateway intent is required for verified applications to receive a non-empty value from this field * * In the Discord Developers Portal, you need to enable the toggle of this intent of your application in **Bot \> Privileged Gateway Intents**. * You also need to specify the intent bit value (`1 << 15`) if you are connecting to the gateway * @see {@link https://support-dev.discord.com/hc/articles/6207308062871} */ attachments: APIAttachment[]; /** * Any embedded content * * @see {@link https://discord.com/developers/docs/resources/channel#embed-object} * * The `MESSAGE_CONTENT` privileged gateway intent is required for verified applications to receive a non-empty value from this field * * In the Discord Developers Portal, you need to enable the toggle of this intent of your application in **Bot \> Privileged Gateway Intents**. * You also need to specify the intent bit value (`1 << 15`) if you are connecting to the gateway * @see {@link https://support-dev.discord.com/hc/articles/6207308062871} */ embeds: APIEmbed[]; /** * Reactions to the message * * @see {@link https://discord.com/developers/docs/resources/channel#reaction-object} */ reactions?: APIReaction[]; /** * A nonce that can be used for optimistic message sending (up to 25 characters) * * **You will not receive this from further fetches. This is received only once from a `MESSAGE_CREATE` * event to ensure it got sent** */ nonce?: number | string; /** * Whether this message is pinned */ pinned: boolean; /** * If the message is generated by a webhook, this is the webhook's id */ webhook_id?: Snowflake; /** * Type of message * * @see {@link https://discord.com/developers/docs/resources/channel#message-object-message-types} */ type: MessageType; /** * Sent with Rich Presence-related chat embeds * * @see {@link https://discord.com/developers/docs/resources/channel#message-object-message-activity-structure} */ activity?: APIMessageActivity; /** * Sent with Rich Presence-related chat embeds * * @see {@link https://discord.com/developers/docs/resources/application#application-object} */ application?: Partial; /** * If the message is a response to an Interaction, this is the id of the interaction's application */ application_id?: Snowflake; /** * Reference data sent with crossposted messages, replies, pins, and thread starter messages * * @see {@link https://discord.com/developers/docs/resources/channel#message-reference-object-message-reference-structure} */ message_reference?: APIMessageReference; /** * Message flags combined as a bitfield * * @see {@link https://discord.com/developers/docs/resources/channel#message-object-message-flags} * @see {@link https://en.wikipedia.org/wiki/Bit_field} */ flags?: MessageFlags; /** * The message associated with the `message_reference` * * This field is only returned for messages with a `type` of `19` (REPLY). * * If the message is a reply but the `referenced_message` field is not present, * the backend did not attempt to fetch the message that was being replied to, * so its state is unknown. * * If the field exists but is `null`, the referenced message was deleted * * @see {@link https://discord.com/developers/docs/resources/channel#message-object} */ referenced_message?: APIMessage | null; /** * Sent if the message is sent as a result of an interaction */ interaction_metadata?: APIMessageInteractionMetadata; /** * Sent if the message is a response to an Interaction * * @deprecated In favor of `interaction_metadata` */ interaction?: APIMessageInteraction; /** * Sent if a thread was started from this message */ thread?: APIChannel; /** * Sent if the message contains components like buttons, action rows, or other interactive components * * The `MESSAGE_CONTENT` privileged gateway intent is required for verified applications to receive a non-empty value from this field * * In the Discord Developers Portal, you need to enable the toggle of this intent of your application in **Bot \> Privileged Gateway Intents**. * You also need to specify the intent bit value (`1 << 15`) if you are connecting to the gateway * * @see {@link https://support-dev.discord.com/hc/articles/6207308062871} */ components?: APIMessageTopLevelComponent[]; /** * Sent if the message contains stickers * * @see {@link https://discord.com/developers/docs/resources/sticker#sticker-item-object} */ sticker_items?: APIStickerItem[]; /** * The stickers sent with the message * * @see {@link https://discord.com/developers/docs/resources/sticker#sticker-object} * @deprecated Use {@link APIMessage.sticker_items} instead */ stickers?: APISticker[]; /** * A generally increasing integer (there may be gaps or duplicates) that represents the approximate position of the message in a thread * * It can be used to estimate the relative position of the message in a thread in company with `total_message_sent` on parent thread */ position?: number; /** * Data of the role subscription purchase or renewal that prompted this `ROLE_SUBSCRIPTION_PURCHASE` message */ role_subscription_data?: APIMessageRoleSubscriptionData; /** * Data for users, members, channels, and roles in the message's auto-populated select menus * * @see {@link https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object-resolved-data-structure} */ resolved?: APIInteractionDataResolved; /** * A poll! * * The `MESSAGE_CONTENT` privileged gateway intent is required for verified applications to receive a non-empty value from this field * * In the Discord Developers Portal, you need to enable the toggle of this intent of your application in **Bot \> Privileged Gateway Intents**. * You also need to specify the intent bit value (`1 << 15`) if you are connecting to the gateway * * @see {@link https://support-dev.discord.com/hc/articles/6207308062871} */ poll?: APIPoll; /** * The message associated with the message_reference. This is a minimal subset of fields in a message (e.g. author is excluded.) */ message_snapshots?: APIMessageSnapshot[]; /** * The call associated with the message */ call?: APIMessageCall; } /** * @see {@link https://discord.com/developers/docs/resources/channel#message-object-message-types} */ export declare enum MessageType { Default = 0, RecipientAdd = 1, RecipientRemove = 2, Call = 3, ChannelNameChange = 4, ChannelIconChange = 5, ChannelPinnedMessage = 6, UserJoin = 7, GuildBoost = 8, GuildBoostTier1 = 9, GuildBoostTier2 = 10, GuildBoostTier3 = 11, ChannelFollowAdd = 12, GuildDiscoveryDisqualified = 14, GuildDiscoveryRequalified = 15, GuildDiscoveryGracePeriodInitialWarning = 16, GuildDiscoveryGracePeriodFinalWarning = 17, ThreadCreated = 18, Reply = 19, ChatInputCommand = 20, ThreadStarterMessage = 21, GuildInviteReminder = 22, ContextMenuCommand = 23, AutoModerationAction = 24, RoleSubscriptionPurchase = 25, InteractionPremiumUpsell = 26, StageStart = 27, StageEnd = 28, StageSpeaker = 29, /** * @unstable https://github.com/discord/discord-api-docs/pull/5927#discussion_r1107678548 */ StageRaiseHand = 30, StageTopic = 31, GuildApplicationPremiumSubscription = 32, GuildIncidentAlertModeEnabled = 36, GuildIncidentAlertModeDisabled = 37, GuildIncidentReportRaid = 38, GuildIncidentReportFalseAlarm = 39, PurchaseNotification = 44, PollResult = 46 } /** * @see {@link https://discord.com/developers/docs/resources/channel#message-object-message-activity-structure} */ export interface APIMessageActivity { /** * Type of message activity * * @see {@link https://discord.com/developers/docs/resources/channel#message-object-message-activity-types} */ type: MessageActivityType; /** * `party_id` from a Rich Presence event * * @see {@link https://discord.com/developers/docs/rich-presence/how-to#updating-presence-update-presence-payload-fields} */ party_id?: string; } /** * @see {@link https://discord.com/developers/docs/resources/channel#message-reference-object-message-reference-structure} */ export interface APIMessageReference { /** * Type of reference */ type?: MessageReferenceType; /** * ID of the originating message */ message_id?: Snowflake; /** * ID of the originating message's channel */ channel_id: Snowflake; /** * ID of the originating message's guild */ guild_id?: Snowflake; } /** * @see {@link https://discord.com/developers/docs/resources/channel#message-object-message-activity-types} */ export declare enum MessageActivityType { Join = 1, Spectate = 2, Listen = 3, JoinRequest = 5 } /** * @see {@link https://discord.com/developers/docs/resources/channel#message-reference-types} */ export declare enum MessageReferenceType { /** * A standard reference used by replies */ Default = 0, /** * Reference used to point to a message at a point in time */ Forward = 1 } /** * @see {@link https://discord.com/developers/docs/resources/channel#message-object-message-flags} */ export declare enum MessageFlags { /** * This message has been published to subscribed channels (via Channel Following) */ Crossposted = 1, /** * This message originated from a message in another channel (via Channel Following) */ IsCrosspost = 2, /** * Do not include any embeds when serializing this message */ SuppressEmbeds = 4, /** * The source message for this crosspost has been deleted (via Channel Following) */ SourceMessageDeleted = 8, /** * This message came from the urgent message system */ Urgent = 16, /** * This message has an associated thread, which shares its id */ HasThread = 32, /** * This message is only visible to the user who invoked the Interaction */ Ephemeral = 64, /** * This message is an Interaction Response and the bot is "thinking" */ Loading = 128, /** * This message failed to mention some roles and add their members to the thread */ FailedToMentionSomeRolesInThread = 256, /** * @unstable This message flag is currently not documented by Discord but has a known value which we will try to keep up to date. */ ShouldShowLinkNotDiscordWarning = 1024, /** * This message will not trigger push and desktop notifications */ SuppressNotifications = 4096, /** * This message is a voice message */ IsVoiceMessage = 8192, /** * This message has a snapshot (via Message Forwarding) */ HasSnapshot = 16384, /** * Allows you to create fully component-driven messages * * @see {@link https://discord.com/developers/docs/components/overview} */ IsComponentsV2 = 32768 } /** * @see {@link https://discord.com/developers/docs/resources/channel#message-call-object-message-call-object-structure} */ export interface APIMessageCall { /** * Array of user ids that participated in the call */ participants: Snowflake[]; /** * ISO8601 timestamp when the call ended */ ended_timestamp?: string | null; } /** * @see {@link https://discord.com/developers/docs/resources/channel#role-subscription-data-object-role-subscription-data-object-structure} */ export interface APIMessageRoleSubscriptionData { /** * The id of the SKU and listing the user is subscribed to */ role_subscription_listing_id: Snowflake; /** * The name of the tier the user is subscribed to */ tier_name: string; /** * The number of months the user has been subscribed for */ total_months_subscribed: number; /** * Whether this notification is for a renewal */ is_renewal: boolean; } /** * @see {@link https://discord.com/developers/docs/resources/channel#followed-channel-object} */ export interface APIFollowedChannel { /** * Source channel id */ channel_id: Snowflake; /** * Created target webhook id */ webhook_id: Snowflake; } /** * @see {@link https://discord.com/developers/docs/resources/channel#reaction-object-reaction-structure} */ export interface APIReaction { /** * Total number of times this emoji has been used to react (including super reacts) */ count: number; /** * An object detailing the individual reaction counts for different types of reactions */ count_details: APIReactionCountDetails; /** * Whether the current user reacted using this emoji */ me: boolean; /** * Whether the current user super-reacted using this emoji */ me_burst: boolean; /** * Emoji information * * @see {@link https://discord.com/developers/docs/resources/emoji#emoji-object} */ emoji: APIPartialEmoji; /** * Hexadecimal colors used for this super reaction */ burst_colors: string[]; } /** * @see {@link https://discord.com/developers/docs/resources/channel#reaction-count-details-object-reaction-count-details-structure} */ export interface APIReactionCountDetails { /** * Count of super reactions */ burst: number; /** * Count of normal reactions */ normal: number; } /** * @see {@link https://discord.com/developers/docs/resources/channel#overwrite-object-overwrite-structure} */ export interface APIOverwrite { /** * Role or user id */ id: Snowflake; /** * Either 0 (role) or 1 (member) */ type: OverwriteType; /** * Permission bit set * * @see {@link https://discord.com/developers/docs/topics/permissions#permissions-bitwise-permission-flags} * @see {@link https://en.wikipedia.org/wiki/Bit_field} */ allow: Permissions; /** * Permission bit set * * @see {@link https://discord.com/developers/docs/topics/permissions#permissions-bitwise-permission-flags} * @see {@link https://en.wikipedia.org/wiki/Bit_field} */ deny: Permissions; } export declare enum OverwriteType { Role = 0, Member = 1 } /** * @see {@link https://discord.com/developers/docs/resources/channel#thread-metadata-object-thread-metadata-structure} */ export interface APIThreadMetadata { /** * Whether the thread is archived */ archived: boolean; /** * Duration in minutes to automatically archive the thread after recent activity, can be set to: 60, 1440, 4320, 10080 */ auto_archive_duration: ThreadAutoArchiveDuration; /** * An ISO8601 timestamp when the thread's archive status was last changed, used for calculating recent activity */ archive_timestamp: string; /** * Whether the thread is locked; when a thread is locked, only users with `MANAGE_THREADS` can unarchive it */ locked: boolean; /** * Whether non-moderators can add other non-moderators to the thread; only available on private threads */ invitable?: boolean; /** * Timestamp when the thread was created; only populated for threads created after 2022-01-09 */ create_timestamp?: string; } export declare enum ThreadAutoArchiveDuration { OneHour = 60, OneDay = 1440, ThreeDays = 4320, OneWeek = 10080 } /** * @see {@link https://discord.com/developers/docs/resources/channel#thread-member-object-thread-member-structure} */ export interface APIThreadMember { /** * The id of the thread * * **This field is omitted on the member sent within each thread in the `GUILD_CREATE` event** */ id?: Snowflake; /** * The id of the member * * **This field is omitted on the member sent within each thread in the `GUILD_CREATE` event** */ user_id?: Snowflake; /** * An ISO8601 timestamp for when the member last joined */ join_timestamp: string; /** * Member flags combined as a bitfield * * @see {@link https://en.wikipedia.org/wiki/Bit_field} */ flags: ThreadMemberFlags; /** * Additional information about the user * * **This field is omitted on the member sent within each thread in the `GUILD_CREATE` event** * * **This field is only present when `with_member` is set to true when calling `List Thread Members` or `Get Thread Member`** */ member?: APIGuildMember; } export declare enum ThreadMemberFlags { /** * @unstable This thread member flag is currently not documented by Discord but has a known value which we will try to keep up to date. */ HasInteracted = 1, /** * @unstable This thread member flag is currently not documented by Discord but has a known value which we will try to keep up to date. */ AllMessages = 2, /** * @unstable This thread member flag is currently not documented by Discord but has a known value which we will try to keep up to date. */ OnlyMentions = 4, /** * @unstable This thread member flag is currently not documented by Discord but has a known value which we will try to keep up to date. */ NoMessages = 8 } export interface APIThreadList { /** * The threads that were fetched */ threads: APIChannel[]; /** * The members for the client user in each of the fetched threads */ members: APIThreadMember[]; } /** * @see {@link https://discord.com/developers/docs/resources/channel#embed-object-embed-structure} * * Length limit: 6000 characters */ export interface APIEmbed { /** * Title of embed * * Length limit: 256 characters */ title?: string; /** * Type of embed (always "rich" for webhook embeds) */ type?: EmbedType; /** * Description of embed * * Length limit: 4096 characters */ description?: string; /** * URL of embed */ url?: string; /** * Timestamp of embed content */ timestamp?: string; /** * Color code of the embed */ color?: number; /** * Footer information * * @see {@link https://discord.com/developers/docs/resources/channel#embed-object-embed-footer-structure} */ footer?: APIEmbedFooter; /** * Image information * * @see {@link https://discord.com/developers/docs/resources/channel#embed-object-embed-image-structure} */ image?: APIEmbedImage; /** * Thumbnail information * * @see {@link https://discord.com/developers/docs/resources/channel#embed-object-embed-thumbnail-structure} */ thumbnail?: APIEmbedThumbnail; /** * Video information * * @see {@link https://discord.com/developers/docs/resources/channel#embed-object-embed-video-structure} */ video?: APIEmbedVideo; /** * Provider information * * @see {@link https://discord.com/developers/docs/resources/channel#embed-object-embed-provider-structure} */ provider?: APIEmbedProvider; /** * Author information * * @see {@link https://discord.com/developers/docs/resources/channel#embed-object-embed-author-structure} */ author?: APIEmbedAuthor; /** * Fields information * * Length limit: 25 field objects * * @see {@link https://discord.com/developers/docs/resources/channel#embed-object-embed-field-structure} */ fields?: APIEmbedField[]; } /** * @see {@link https://discord.com/developers/docs/resources/channel#embed-object-embed-types} */ export declare enum EmbedType { /** * Generic embed rendered from embed attributes */ Rich = "rich", /** * Image embed */ Image = "image", /** * Video embed */ Video = "video", /** * Animated gif image embed rendered as a video embed */ GIFV = "gifv", /** * Article embed */ Article = "article", /** * Link embed */ Link = "link", /** * Auto moderation alert embed * * @unstable This embed type is currently not documented by Discord, but it is returned in the auto moderation system messages. */ AutoModerationMessage = "auto_moderation_message", /** * Poll result embed */ PollResult = "poll_result" } /** * @see {@link https://discord.com/developers/docs/resources/channel#embed-object-embed-thumbnail-structure} */ export interface APIEmbedThumbnail { /** * Source url of thumbnail (only supports http(s) and attachments) */ url: string; /** * A proxied url of the thumbnail */ proxy_url?: string; /** * Height of thumbnail */ height?: number; /** * Width of thumbnail */ width?: number; } /** * @see {@link https://discord.com/developers/docs/resources/channel#embed-object-embed-video-structure} */ export interface APIEmbedVideo { /** * Source url of video */ url?: string; /** * A proxied url of the video */ proxy_url?: string; /** * Height of video */ height?: number; /** * Width of video */ width?: number; } /** * @see {@link https://discord.com/developers/docs/resources/channel#embed-object-embed-image-structure} */ export interface APIEmbedImage { /** * Source url of image (only supports http(s) and attachments) */ url: string; /** * A proxied url of the image */ proxy_url?: string; /** * Height of image */ height?: number; /** * Width of image */ width?: number; } /** * @see {@link https://discord.com/developers/docs/resources/channel#embed-object-embed-provider-structure} */ export interface APIEmbedProvider { /** * Name of provider */ name?: string; /** * URL of provider */ url?: string; } /** * @see {@link https://discord.com/developers/docs/resources/channel#embed-object-embed-author-structure} */ export interface APIEmbedAuthor { /** * Name of author * * Length limit: 256 characters */ name: string; /** * URL of author */ url?: string; /** * URL of author icon (only supports http(s) and attachments) */ icon_url?: string; /** * A proxied url of author icon */ proxy_icon_url?: string; } /** * @see {@link https://discord.com/developers/docs/resources/channel#embed-object-embed-footer-structure} */ export interface APIEmbedFooter { /** * Footer text * * Length limit: 2048 characters */ text: string; /** * URL of footer icon (only supports http(s) and attachments) */ icon_url?: string; /** * A proxied url of footer icon */ proxy_icon_url?: string; } /** * @see {@link https://discord.com/developers/docs/resources/channel#embed-object-embed-field-structure} */ export interface APIEmbedField { /** * Name of the field * * Length limit: 256 characters */ name: string; /** * Value of the field * * Length limit: 1024 characters */ value: string; /** * Whether or not this field should display inline */ inline?: boolean; } /** * @see {@link https://discord.com/developers/docs/resources/message#attachment-object-attachment-structure} */ export interface APIAttachment { /** * Attachment id */ id: Snowflake; /** * Name of file attached */ filename: string; /** * The title of the file */ title?: string; /** * Description for the file */ description?: string; /** * The attachment's media type * * @see {@link https://en.wikipedia.org/wiki/Media_type} */ content_type?: string; /** * Size of file in bytes */ size: number; /** * Source url of file */ url: string; /** * A proxied url of file */ proxy_url: string; /** * Height of file (if image) */ height?: number | null; /** * Width of file (if image) */ width?: number | null; /** * Whether this attachment is ephemeral */ ephemeral?: boolean; /** * The duration of the audio file (currently for voice messages) */ duration_secs?: number; /** * Base64 encoded bytearray representing a sampled waveform (currently for voice messages) */ waveform?: string; /** * Attachment flags combined as a bitfield */ flags?: AttachmentFlags; } /** * @see {@link https://discord.com/developers/docs/resources/channel#attachment-object-attachment-structure-attachment-flags} */ export declare enum AttachmentFlags { /** * This attachment has been edited using the remix feature on mobile */ IsRemix = 4 } /** * @see {@link https://discord.com/developers/docs/resources/channel#channel-mention-object-channel-mention-structure} */ export interface APIChannelMention { /** * ID of the channel */ id: Snowflake; /** * ID of the guild containing the channel */ guild_id: Snowflake; /** * The type of channel * * @see {@link https://discord.com/developers/docs/resources/channel#channel-object-channel-types} */ type: ChannelType; /** * The name of the channel */ name: string; } /** * @see {@link https://discord.com/developers/docs/resources/channel#allowed-mentions-object-allowed-mention-types} */ export declare enum AllowedMentionsTypes { /** * Controls `@everyone` and `@here` mentions */ Everyone = "everyone", /** * Controls role mentions */ Role = "roles", /** * Controls user mentions */ User = "users" } /** * @see {@link https://discord.com/developers/docs/resources/channel#allowed-mentions-object-allowed-mentions-structure} */ export interface APIAllowedMentions { /** * An array of allowed mention types to parse from the content * * @see {@link https://discord.com/developers/docs/resources/channel#allowed-mentions-object-allowed-mention-types} */ parse?: AllowedMentionsTypes[]; /** * Array of role_ids to mention (Max size of 100) */ roles?: Snowflake[]; /** * Array of user_ids to mention (Max size of 100) */ users?: Snowflake[]; /** * For replies, whether to mention the author of the message being replied to * * @defaultValue `false` */ replied_user?: boolean; } /** * @see {@link https://discord.com/developers/docs/components/reference#anatomy-of-a-component} */ export interface APIBaseComponent { /** * The type of the component */ type: T; /** * 32 bit integer used as an optional identifier for component * * The id field is optional and is used to identify components in the response from an interaction that aren't interactive components. The id must be unique within the message and is generated sequentially if left empty. Generation of ids won't use another id that exists in the message if you have one defined for another component. */ id?: number; } /** * @see {@link https://discord.com/developers/docs/components/reference#component-object-component-types} */ export declare enum ComponentType { /** * Container to display a row of interactive components */ ActionRow = 1, /** * Button component */ Button = 2, /** * Select menu for picking from defined text options */ StringSelect = 3, /** * Text Input component */ TextInput = 4, /** * Select menu for users */ UserSelect = 5, /** * Select menu for roles */ RoleSelect = 6, /** * Select menu for users and roles */ MentionableSelect = 7, /** * Select menu for channels */ ChannelSelect = 8, /** * Container to display text alongside an accessory component */ Section = 9, /** * Markdown text */ TextDisplay = 10, /** * Small image that can be used as an accessory */ Thumbnail = 11, /** * Display images and other media */ MediaGallery = 12, /** * Displays an attached file */ File = 13, /** * Component to add vertical padding between other components */ Separator = 14, /** * @unstable This component type is currently not documented by Discord but has a known value which we will try to keep up to date. */ ContentInventoryEntry = 16, /** * Container that visually groups a set of components */ Container = 17, /** * Select menu for picking from defined text options * * @deprecated This is the old name for {@link ComponentType.StringSelect} */ SelectMenu = 3 } /** * An Action Row is a top-level layout component used in messages and modals. * * @see {@link https://discord.com/developers/docs/components/reference#action-row} */ export interface APIActionRowComponent extends APIBaseComponent { /** * The components in the ActionRow */ components: T[]; } /** * @see {@link https://discord.com/developers/docs/components/reference#button} */ export interface APIButtonComponentBase