Extremely Popular
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530import { ListArchivedThreads } from "../helpers/channels/threads/getArchivedThreads.ts";import { GetGuildAuditLog } from "../helpers/guilds/getAuditLogs.ts";import { GetBans } from "../helpers/guilds/getBans.ts";import { GetGuildPruneCountQuery } from "../helpers/guilds/getPruneCount.ts";import { GetScheduledEventUsers } from "../helpers/guilds/scheduledEvents/getScheduledEventUsers.ts";import { GetInvite } from "../helpers/invites/getInvite.ts";import { ListGuildMembers } from "../helpers/members/getMembers.ts";import { GetMessagesOptions, isGetMessagesAfter, isGetMessagesAround, isGetMessagesBefore, isGetMessagesLimit,} from "../helpers/messages/getMessages.ts";import { GetReactions } from "../helpers/messages/getReactions.ts";
/** https://discord.com/developers/docs/reference#api-reference-base-url */export const BASE_URL = "https://discord.com/api";
/** https://discord.com/developers/docs/reference#api-versioning-api-versions */export const API_VERSION = 10;
/** https://discord.com/developers/docs/topics/gateway#gateways-gateway-versions */export const GATEWAY_VERSION = 10;
// TODO: update this version/** https://github.com/discordeno/discordeno/releases */export const DISCORDENO_VERSION = "13.0.0-rc45";
/** https://discord.com/developers/docs/reference#user-agent */export const USER_AGENT = `DiscordBot (https://github.com/discordeno/discordeno, v${DISCORDENO_VERSION})`;
/** https://discord.com/developers/docs/reference#image-formatting-image-base-url */export const IMAGE_BASE_URL = "https://cdn.discordapp.com";
// This can be modified by big brain bots and use a proxyexport const baseEndpoints = { BASE_URL: `${BASE_URL}/v${API_VERSION}`, CDN_URL: IMAGE_BASE_URL,};
export const routes = { GATEWAY_BOT: () => { return `/gateway/bot`; },
// Channel Endpoints CHANNEL: (channelId: bigint) => { return `/channels/${channelId}`; }, CHANNEL_MESSAGE: (channelId: bigint, messageId: bigint) => { return `/channels/${channelId}/messages/${messageId}`; }, CHANNEL_MESSAGES: (channelId: bigint, options?: GetMessagesOptions) => { let url = `/channels/${channelId}/messages?`;
if (options) { if (isGetMessagesAfter(options) && options.after) url += `after=${options.after}`; if (isGetMessagesBefore(options) && options.before) url += `&before=${options.before}`; if (isGetMessagesAround(options) && options.around) url += `&around=${options.around}`; if (isGetMessagesLimit(options) && options.limit) url += `&limit=${options.limit}`; }
return url; }, CHANNEL_PIN: (channelId: bigint, messageId: bigint) => { return `/channels/${channelId}/pins/${messageId}`; }, CHANNEL_PINS: (channelId: bigint) => { return `/channels/${channelId}/pins`; }, CHANNEL_BULK_DELETE: (channelId: bigint) => { return `/channels/${channelId}/messages/bulk-delete`; }, CHANNEL_INVITES: (channelId: bigint) => { return `/channels/${channelId}/invites`; }, CHANNEL_WEBHOOKS: (channelId: bigint) => { return `/channels/${channelId}/webhooks`; }, CHANNEL_MESSAGE_REACTION_ME: (channelId: bigint, messageId: bigint, emoji: string) => { return `/channels/${channelId}/messages/${messageId}/reactions/${encodeURIComponent(emoji)}/@me`; }, CHANNEL_MESSAGE_REACTION_USER: (channelId: bigint, messageId: bigint, emoji: string, userId: bigint) => { return `/channels/${channelId}/messages/${messageId}/reactions/${encodeURIComponent(emoji)}/${userId}`; }, CHANNEL_MESSAGE_REACTIONS: (channelId: bigint, messageId: bigint) => { return `/channels/${channelId}/messages/${messageId}/reactions`; }, CHANNEL_MESSAGE_REACTION: (channelId: bigint, messageId: bigint, emoji: string, options?: GetReactions) => { let url = `/channels/${channelId}/messages/${messageId}/reactions/${encodeURIComponent(emoji)}?`;
if (options) { if (options.after) url += `after=${options.after}`; if (options.limit) url += `&limit=${options.limit}`; }
return url; }, CHANNEL_FOLLOW: (channelId: bigint) => { return `/channels/${channelId}/followers`; }, CHANNEL_MESSAGE_CROSSPOST: (channelId: bigint, messageId: bigint) => { return `/channels/${channelId}/messages/${messageId}/crosspost`; }, CHANNEL_OVERWRITE: (channelId: bigint, overwriteId: bigint) => { return `/channels/${channelId}/permissions/${overwriteId}`; }, // Bots SHALL NOT use this endpoint but they can CHANNEL_TYPING: (channelId: bigint) => { return `/channels/${channelId}/typing`; },
// Thread Endpoints THREAD_START_PUBLIC: (channelId: bigint, messageId: bigint) => { return `/channels/${channelId}/messages/${messageId}/threads`; }, THREAD_START_PRIVATE: (channelId: bigint) => { return `/channels/${channelId}/threads`; }, THREAD_ACTIVE: (guildId: bigint) => { return `/guilds/${guildId}/threads/active`; }, THREAD_MEMBERS: (channelId: bigint) => { return `/channels/${channelId}/thread-members`; }, THREAD_ME: (channelId: bigint) => { return `/channels/${channelId}/thread-members/@me`; }, THREAD_USER: (channelId: bigint, userId: bigint) => { return `/channels/${channelId}/thread-members/${userId}`; }, THREAD_ARCHIVED: (channelId: bigint) => { return `/channels/${channelId}/threads/archived`; }, THREAD_ARCHIVED_PUBLIC: (channelId: bigint, options?: ListArchivedThreads) => { let url = `/channels/${channelId}/threads/archived/public?`;
if (options) { if (options.before) url += `before=${new Date(options.before).toISOString()}`; if (options.limit) url += `&limit=${options.limit}`; }
return url; }, THREAD_ARCHIVED_PRIVATE: (channelId: bigint, options?: ListArchivedThreads) => { let url = `/channels/${channelId}/threads/archived/private?`;
if (options) { if (options.before) url += `before=${new Date(options.before).toISOString()}`; if (options.limit) url += `&limit=${options.limit}`; }
return url; }, THREAD_ARCHIVED_PRIVATE_JOINED: (channelId: bigint, options?: ListArchivedThreads) => { let url = `/channels/${channelId}/users/@me/threads/archived/private?`;
if (options) { if (options.before) url += `before=${new Date(options.before).toISOString()}`; if (options.limit) url += `&limit=${options.limit}`; }
return url; },
// Thread -> Forum Endpoints FORUM_START: (channelId: bigint) => { return `/channels/${channelId}/threads?has_message=true`; },
// Guild Endpoints GUILD: (guildId: bigint, withCounts?: boolean) => { let url = `/guilds/${guildId}?`;
if (withCounts !== undefined) { url += `with_counts=${withCounts}`; }
return url; }, GUILDS: () => { return `/guilds`; }, GUILD_AUDIT_LOGS: (guildId: bigint, options?: GetGuildAuditLog) => { let url = `/guilds/${guildId}/audit-logs?`;
if (options) { if (options.actionType) url += `action_type=${options.actionType}`; if (options.before) url += `&before=${options.before}`; if (options.limit) url += `&limit=${options.limit}`; if (options.userId) url += `&user_id=${options.userId}`; }
return url; }, GUILD_BAN: (guildId: bigint, userId: bigint) => { return `/guilds/${guildId}/bans/${userId}`; }, GUILD_BANS: (guildId: bigint, options?: GetBans) => { let url = `/guilds/${guildId}/bans?`;
if (options) { if (options.limit) url += `limit=${options.limit}`; if (options.after) url += `&after=${options.after}`; if (options.before) url += `&before=${options.before}`; }
return url; }, // TODO: move this away GUILD_BANNER: (guildId: bigint, icon: string) => { return `${baseEndpoints.CDN_URL}/banners/${guildId}/${icon}`; }, GUILD_CHANNELS: (guildId: bigint) => { return `/guilds/${guildId}/channels`; }, GUILD_WIDGET: (guildId: bigint) => { return `/guilds/${guildId}/widget`; }, GUILD_WIDGET_JSON: (guildId: bigint) => { return `/guilds/${guildId}/widget.json`; }, GUILD_WIDGET_IMAGE: ( guildId: bigint, style?: | "shield" | "banner1" | "banner2" | "banner3" | "banner4", ) => { let url = `/guilds/${guildId}/widget.png?`;
if (style) { url += `style=${style}`; }
return url; }, GUILD_EMOJI: (guildId: bigint, emojiId: bigint) => { return `/guilds/${guildId}/emojis/${emojiId}`; }, GUILD_EMOJIS: (guildId: bigint) => { return `/guilds/${guildId}/emojis`; }, // TODO: move this away GUILD_ICON: (guildId: bigint, icon: string) => { return `${baseEndpoints.CDN_URL}/icons/${guildId}/${icon}`; }, GUILD_INTEGRATION: (guildId: bigint, integrationId: bigint) => { return `/guilds/${guildId}/integrations/${integrationId}`; }, GUILD_INTEGRATION_SYNC: (guildId: bigint, integrationId: bigint) => { return `/guilds/${guildId}/integrations/${integrationId}/sync`; }, GUILD_INTEGRATIONS: (guildId: bigint) => { return `/guilds/${guildId}/integrations?include_applications=true`; }, GUILD_INVITES: (guildId: bigint) => { return `/guilds/${guildId}/invites`; }, GUILD_LEAVE: (guildId: bigint) => { return `/users/@me/guilds/${guildId}`; }, GUILD_MEMBER: (guildId: bigint, userId: bigint) => { return `/guilds/${guildId}/members/${userId}`; }, GUILD_MEMBERS: (guildId: bigint, options?: ListGuildMembers) => { let url = `/guilds/${guildId}/members?`;
if (options !== undefined) { if (options.limit) url += `limit=${options.limit}`; if (options.after) url += `&after=${options.after}`; }
return url; }, GUILD_MEMBER_ROLE: (guildId: bigint, memberId: bigint, roleId: bigint) => { return `/guilds/${guildId}/members/${memberId}/roles/${roleId}`; }, GUILD_MEMBERS_SEARCH: (guildId: bigint, query: string, options?: { limit?: number }) => { let url = `/guilds/${guildId}/members/search?query=${encodeURIComponent(query)}`;
if (options) { if (options.limit !== undefined) url += `&limit=${options.limit}`; }
return url; }, GUILD_PRUNE: (guildId: bigint, options?: GetGuildPruneCountQuery) => { let url = `/guilds/${guildId}/prune?`;
if (options) { if (options.days) url += `days=${options.days}`; if (options.includeRoles) url += `&include_roles=${options.includeRoles}`; }
return url; }, GUILD_REGIONS: (guildId: bigint) => { return `/guilds/${guildId}/regions`; }, GUILD_ROLE: (guildId: bigint, roleId: bigint) => { return `/guilds/${guildId}/roles/${roleId}`; }, GUILD_ROLES: (guildId: bigint) => { return `/guilds/${guildId}/roles`; }, // TODO: move this away GUILD_SPLASH: (guildId: bigint, icon: string) => { return `${baseEndpoints.CDN_URL}/splashes/${guildId}/${icon}`; }, GUILD_VANITY_URL: (guildId: bigint) => { return `/guilds/${guildId}/vanity-url`; }, GUILD_WEBHOOKS: (guildId: bigint) => { return `/guilds/${guildId}/webhooks`; }, TEMPLATE: (code: string) => { return `/guilds/templates/${code}`; }, GUILD_TEMPLATE: (guildId: bigint, code: string) => { return `/guilds/${guildId}/templates/${code}`; }, GUILD_TEMPLATES: (guildId: bigint) => { return `/guilds/${guildId}/templates`; }, GUILD_PREVIEW: (guildId: bigint) => { return `/guilds/${guildId}/preview`; }, UPDATE_VOICE_STATE: (guildId: bigint, userId?: bigint) => { return `/guilds/${guildId}/voice-states/${userId ?? "@me"}`; }, GUILD_WELCOME_SCREEN: (guildId: bigint) => { return `/guilds/${guildId}/welcome-screen`; }, GUILD_SCHEDULED_EVENTS: (guildId: bigint, withUserCount?: boolean) => { let url = `/guilds/${guildId}/scheduled-events?`;
if (withUserCount !== undefined) { url += `with_user_count=${withUserCount}`; } return url; }, GUILD_SCHEDULED_EVENT: (guildId: bigint, eventId: bigint, withUserCount?: boolean) => { let url = `/guilds/${guildId}/scheduled-events/${eventId}`;
if (withUserCount !== undefined) { url += `with_user_count=${withUserCount}`; }
return url; }, GUILD_SCHEDULED_EVENT_USERS: (guildId: bigint, eventId: bigint, options?: GetScheduledEventUsers) => { let url = `/guilds/${guildId}/scheduled-events/${eventId}/users?`;
if (options) { if (options.limit) url += `limit=${options.limit}`; if (options.withMember) url += `&with_member=${options.withMember}`; if (options.after) url += `&after=${options.after}`; if (options.before) url += `&before=${options.before}`; }
return url; }, // Voice VOICE_REGIONS: () => { return `/voice/regions`; },
INVITE: (inviteCode: string, options?: GetInvite) => { let url = `/invites/${inviteCode}?`;
if (options) { if (options.withCounts) url += `with_counts=${options.withCounts}`; if (options.withExpiration) url += `&with_expiration=${options.withExpiration}`; if (options.scheduledEventId) url += `&guild_scheduled_event_id=${options.scheduledEventId}`; }
return url; },
WEBHOOK: (webhookId: bigint, token: string, options?: { wait?: boolean; threadId?: bigint }) => { let url = `/webhooks/${webhookId}/${token}?`;
if (options) { if (options?.wait !== undefined) url += `wait=${options.wait}`; if (options.threadId) url += `threadId=${options.threadId}`; }
return url; }, WEBHOOK_ID: (webhookId: bigint) => { return `/webhooks/${webhookId}`; }, WEBHOOK_MESSAGE: (webhookId: bigint, token: string, messageId: bigint, options?: { threadId?: bigint }) => { let url = `/webhooks/${webhookId}/${token}/messages/${messageId}?`;
if (options) { if (options.threadId) url += `threadId=${options.threadId}`; }
return url; }, WEBHOOK_MESSAGE_ORIGINAL: (webhookId: bigint, token: string, options?: { threadId?: bigint }) => { let url = `/webhooks/${webhookId}/${token}/messages/@original?`;
if (options) { if (options.threadId) url += `threadId=${options.threadId}`; }
return url; }, WEBHOOK_SLACK: (webhookId: bigint, token: string) => { return `/webhooks/${webhookId}/${token}/slack`; }, WEBHOOK_GITHUB: (webhookId: bigint, token: string) => { return `/webhooks/${webhookId}/${token}/github`; },
// Application Endpoints COMMANDS: (applicationId: bigint) => { return `/applications/${applicationId}/commands`; }, COMMANDS_GUILD: (applicationId: bigint, guildId: bigint) => { return `/applications/${applicationId}/guilds/${guildId}/commands`; }, COMMANDS_PERMISSIONS: (applicationId: bigint, guildId: bigint) => { return `/applications/${applicationId}/guilds/${guildId}/commands/permissions`; }, COMMANDS_PERMISSION: (applicationId: bigint, guildId: bigint, commandId: bigint) => { return `/applications/${applicationId}/guilds/${guildId}/commands/${commandId}/permissions`; }, COMMANDS_ID: (applicationId: bigint, commandId: bigint, withLocalizations?: boolean) => { let url = `/applications/${applicationId}/commands/${commandId}?`;
if (withLocalizations !== undefined) { url += `withLocalizations=${withLocalizations}`; }
return url; }, COMMANDS_GUILD_ID: (applicationId: bigint, guildId: bigint, commandId: bigint, withLocalizations?: boolean) => { let url = `/applications/${applicationId}/guilds/${guildId}/commands/${commandId}?`;
if (withLocalizations !== undefined) { url += `with_localizations=${withLocalizations}`; }
return url; },
// Interaction Endpoints INTERACTION_ID_TOKEN: (interactionId: bigint, token: string) => { return `/interactions/${interactionId}/${token}/callback`; }, INTERACTION_ORIGINAL_ID_TOKEN: (interactionId: bigint, token: string) => { return `/webhooks/${interactionId}/${token}/messages/@original`; }, INTERACTION_ID_TOKEN_MESSAGE_ID: (applicationId: bigint, token: string, messageId: bigint) => { return `/webhooks/${applicationId}/${token}/messages/${messageId}`; },
// User endpoints USER: (userId: bigint) => { return `/users/${userId}`; }, USER_BOT: () => { return `/users/@me`; }, USER_GUILDS: () => { return `/@me/guilds`; }, // TODO: move this away USER_AVATAR: (userId: bigint, icon: string) => { return `${baseEndpoints.CDN_URL}/avatars/${userId}/${icon}`; }, // TODO: move this away USER_DEFAULT_AVATAR: (icon: number) => { return `${baseEndpoints.CDN_URL}/embed/avatars/${icon}.png`; }, USER_DM: () => { return `/users/@me/channels`; }, USER_CONNECTIONS: () => { return `/users/@me/connections`; }, USER_NICK: (guildId: bigint) => { return `/guilds/${guildId}/members/@me`; },
// Discovery Endpoints DISCOVERY_CATEGORIES: () => { return `/discovery/categories`; }, DISCOVERY_VALID_TERM: (term: string) => { return `/discovery/valid-term?term=${term}`; }, DISCOVERY_METADATA: (guildId: bigint) => { return `/guilds/${guildId}/discovery-metadata`; }, DISCOVERY_SUBCATEGORY: (guildId: bigint, categoryId: number) => { return `/guilds/${guildId}/discovery-categories/${categoryId}`; },
// OAuth2 OAUTH2_APPLICATION: () => { return `/oauth2/applications/@me`; },
// Stage instances STAGE_INSTANCES: () => { return `/stage-instances`; }, STAGE_INSTANCE: (channelId: bigint) => { return `/stage-instances/${channelId}`; },
// Misc Endpoints NITRO_STICKER_PACKS: () => { return `/sticker-packs`; },};
export const SLASH_COMMANDS_NAME_REGEX = /^[-_\p{L}\p{N}\p{sc=Deva}\p{sc=Thai}]{1,32}$/u;export const CONTEXT_MENU_COMMANDS_NAME_REGEX = /^[\w-\s]{1,32}$/;export const CHANNEL_MENTION_REGEX = /<#[0-9]+>/g;export const DISCORD_SNOWFLAKE_REGEX = /^(?<id>\d{17,19})$/;