import { createRestManager, CreateRestManagerOptions } from "./rest/mod.ts"; import { bigintToSnowflake, snowflakeToBigint } from "./util/bigint.ts"; import { Collection } from "./util/collection.ts"; import { Channel, Guild, Member, Message, Role, ScheduledEvent, Template, transformChannel, transformGuild, transformMember, transformMessage, transformRole, transformTemplate, transformUser, transformVoiceState, User, VoiceState, } from "./transformers/mod.ts"; import { baseEndpoints, CHANNEL_MENTION_REGEX, CONTEXT_MENU_COMMANDS_NAME_REGEX, DISCORD_SNOWFLAKE_REGEX, DISCORDENO_VERSION, SLASH_COMMANDS_NAME_REGEX, USER_AGENT, } from "./util/constants.ts"; import { createGatewayManager, GatewayManager } from "./gateway/manager/gatewayManager.ts"; import { validateLength } from "./util/validateLength.ts"; import { delay, formatImageURL } from "./util/utils.ts"; import { iconBigintToHash, iconHashToBigInt } from "./util/hash.ts"; import { calculateShardId } from "./util/calculateShardId.ts"; import * as handlers from "./handlers/mod.ts"; import { Interaction, InteractionDataOption, transformInteraction, transformInteractionDataOption, } from "./transformers/interaction.ts"; import { Integration, transformIntegration } from "./transformers/integration.ts"; import { transformApplication } from "./transformers/application.ts"; import { transformTeam } from "./transformers/team.ts"; import { Invite, transformInvite } from "./transformers/invite.ts"; import * as helpers from "./helpers/mod.ts"; import { Emoji, transformEmoji } from "./transformers/emoji.ts"; import { transformActivity } from "./transformers/activity.ts"; import { PresenceUpdate, transformPresence } from "./transformers/presence.ts"; import { urlToBase64 } from "./util/urlToBase64.ts"; import { transformAttachment } from "./transformers/attachment.ts"; import { transformEmbed } from "./transformers/embed.ts"; import { transformComponent } from "./transformers/component.ts"; import { transformWebhook } from "./transformers/webhook.ts"; import { transformAuditLogEntry } from "./transformers/auditLogEntry.ts"; import { transformApplicationCommandPermission } from "./transformers/applicationCommandPermission.ts"; import { calculateBits, calculatePermissions } from "./util/permissions.ts"; import { transformScheduledEvent } from "./transformers/scheduledEvent.ts"; import { ThreadMember, transformThreadMember } from "./transformers/threadMember.ts"; import { transformApplicationCommandOption } from "./transformers/applicationCommandOption.ts"; import { transformApplicationCommand } from "./transformers/applicationCommand.ts"; import { transformWelcomeScreen } from "./transformers/welcomeScreen.ts"; import { transformVoiceRegion } from "./transformers/voiceRegion.ts"; import { transformWidget } from "./transformers/widget.ts"; import { transformWidgetSettings } from "./transformers/widgetSettings.ts"; import { transformStageInstance } from "./transformers/stageInstance.ts"; import { StickerPack, transformSticker, transformStickerPack } from "./transformers/sticker.ts"; import { GetGatewayBot, transformGatewayBot } from "./transformers/gatewayBot.ts"; import { DiscordAllowedMentions, DiscordApplicationCommandOptionChoice, DiscordAutoModerationActionExecution, DiscordAutoModerationRule, DiscordEmoji, DiscordGatewayPayload, DiscordInteractionDataOption, DiscordReady, DiscordStickerPack, DiscordTemplate, } from "./types/discord.ts"; import { Errors, GatewayDispatchEventNames, GatewayIntents } from "./types/shared.ts"; import { DiscordActivity, DiscordApplication, DiscordApplicationCommand, DiscordApplicationCommandOption, DiscordAttachment, DiscordAuditLogEntry, DiscordChannel, DiscordComponent, DiscordEmbed, DiscordGetGatewayBot, DiscordGuild, DiscordGuildApplicationCommandPermissions, DiscordGuildWidget, DiscordGuildWidgetSettings, DiscordIntegrationCreateUpdate, DiscordInteraction, DiscordInviteCreate, DiscordMember, DiscordMessage, DiscordPresenceUpdate, DiscordRole, DiscordScheduledEvent, DiscordStageInstance, DiscordSticker, DiscordTeam, DiscordThreadMember, DiscordUser, DiscordVoiceRegion, DiscordVoiceState, DiscordWebhook, DiscordWelcomeScreen, } from "./types/discord.ts"; import { Application } from "./transformers/application.ts"; import { Team } from "./transformers/team.ts"; import { Activity } from "./transformers/activity.ts"; import { Attachment } from "./transformers/attachment.ts"; import { Embed } from "./transformers/embed.ts"; import { Webhook } from "./transformers/webhook.ts"; import { Component } from "./transformers/component.ts"; import { ApplicationCommand } from "./transformers/applicationCommand.ts"; import { AuditLogEntry } from "./transformers/auditLogEntry.ts"; import { ApplicationCommandOption } from "./transformers/applicationCommandOption.ts"; import { ApplicationCommandPermission } from "./transformers/applicationCommandPermission.ts"; import { WelcomeScreen } from "./transformers/welcomeScreen.ts"; import { VoiceRegions } from "./transformers/voiceRegion.ts"; import { GuildWidget } from "./transformers/widget.ts"; import { GuildWidgetSettings } from "./transformers/widgetSettings.ts"; import { StageInstance } from "./transformers/stageInstance.ts"; import { Sticker } from "./transformers/sticker.ts"; import { ApplicationCommandOptionChoice, transformApplicationCommandOptionChoice, } from "./transformers/applicationCommandOptionChoice.ts"; import { transformEmbedToDiscordEmbed } from "./transformers/reverse/embed.ts"; import { transformComponentToDiscordComponent } from "./transformers/reverse/component.ts"; import { transformActivityToDiscordActivity } from "./transformers/reverse/activity.ts"; import { transformTeamToDiscordTeam } from "./transformers/reverse/team.ts"; import { transformMemberToDiscordMember, transformUserToDiscordUser } from "./transformers/reverse/member.ts"; import { transformApplicationToDiscordApplication } from "./transformers/reverse/application.ts"; import { getBotIdFromToken, removeTokenPrefix } from "./util/token.ts"; import { CreateShardManager } from "./gateway/manager/shardManager.ts"; import { AutoModerationRule, transformAutoModerationRule } from "./transformers/automodRule.ts"; import { AutoModerationActionExecution, transformAutoModerationActionExecution, } from "./transformers/automodActionExecution.ts"; import { routes } from "./util/routes.ts"; import { transformAllowedMentionsToDiscordAllowedMentions } from "./transformers/reverse/allowedMentions.ts"; import { AllowedMentions } from "./mod.ts"; export function createBot(options: CreateBotOptions): Bot { const bot = { id: options.botId ?? getBotIdFromToken(options.token), applicationId: options.applicationId || options.botId, token: removeTokenPrefix(options.token), events: createEventHandlers(options.events ?? {}), intents: options.intents, botGatewayData: options.botGatewayData, activeGuildIds: new Set(), constants: createBotConstants(), handlers: createBotGatewayHandlers({}), utils: createUtils(options.utils ?? {}), transformers: createTransformers(options.transformers ?? {}), enabledPlugins: new Set(), handleDiscordPayload: options.handleDiscordPayload, cache: { unrepliedInteractions: new Set(), fetchAllMembersProcessingRequests: new Map(), }, rest: createRestManager({ token: options.token, debug: options.events?.debug, secretKey: options.secretKey ?? undefined, }), } as Bot; bot.helpers = createHelpers(bot, options.helpers ?? {}); bot.gateway = createGatewayManager({ gatewayBot: bot.botGatewayData ?? {} as any, gatewayConfig: { token: options.token, intents: options.intents, }, debug: bot.events.debug, handleDiscordPayload: bot.handleDiscordPayload ?? async function (shard, data: DiscordGatewayPayload) { // TRIGGER RAW EVENT bot.events.raw(bot as Bot, data, shard.id); if (!data.t) return; // RUN DISPATCH CHECK await bot.events.dispatchRequirements(bot as Bot, data, shard.id); bot.handlers[data.t as GatewayDispatchEventNames]?.( bot as Bot, data, shard.id, ); }, }); return bot as Bot; } export function createEventHandlers( events: Partial, ): EventHandlers { function ignore() {} return { debug: events.debug ?? ignore, automodRuleCreate: events.automodRuleCreate ?? ignore, automodRuleUpdate: events.automodRuleUpdate ?? ignore, automodRuleDelete: events.automodRuleDelete ?? ignore, automodActionExecution: events.automodActionExecution ?? ignore, threadCreate: events.threadCreate ?? ignore, threadDelete: events.threadDelete ?? ignore, threadMemberUpdate: events.threadMemberUpdate ?? ignore, threadMembersUpdate: events.threadMembersUpdate ?? ignore, threadUpdate: events.threadUpdate ?? ignore, scheduledEventCreate: events.scheduledEventCreate ?? ignore, scheduledEventUpdate: events.scheduledEventUpdate ?? ignore, scheduledEventDelete: events.scheduledEventDelete ?? ignore, scheduledEventUserAdd: events.scheduledEventUserAdd ?? ignore, scheduledEventUserRemove: events.scheduledEventUserRemove ?? ignore, ready: events.ready ?? ignore, dispatchRequirements: events.dispatchRequirements ?? ignore, integrationCreate: events.integrationCreate ?? ignore, integrationDelete: events.integrationDelete ?? ignore, integrationUpdate: events.integrationUpdate ?? ignore, interactionCreate: events.interactionCreate ?? ignore, inviteCreate: events.inviteCreate ?? ignore, inviteDelete: events.inviteDelete ?? ignore, guildMemberAdd: events.guildMemberAdd ?? ignore, guildMemberRemove: events.guildMemberRemove ?? ignore, guildMemberUpdate: events.guildMemberUpdate ?? ignore, messageCreate: events.messageCreate ?? ignore, messageDelete: events.messageDelete ?? ignore, messageDeleteBulk: events.messageDeleteBulk ?? ignore, messageUpdate: events.messageUpdate ?? ignore, reactionAdd: events.reactionAdd ?? ignore, reactionRemove: events.reactionRemove ?? ignore, reactionRemoveAll: events.reactionRemoveAll ?? ignore, reactionRemoveEmoji: events.reactionRemoveEmoji ?? ignore, presenceUpdate: events.presenceUpdate ?? ignore, voiceServerUpdate: events.voiceServerUpdate ?? ignore, voiceStateUpdate: events.voiceStateUpdate ?? ignore, channelCreate: events.channelCreate ?? ignore, channelDelete: events.channelDelete ?? ignore, channelPinsUpdate: events.channelPinsUpdate ?? ignore, channelUpdate: events.channelUpdate ?? ignore, guildEmojisUpdate: events.guildEmojisUpdate ?? ignore, guildBanAdd: events.guildBanAdd ?? ignore, guildBanRemove: events.guildBanRemove ?? ignore, guildLoaded: events.guildLoaded ?? ignore, guildCreate: events.guildCreate ?? ignore, guildDelete: events.guildDelete ?? ignore, guildUpdate: events.guildUpdate ?? ignore, raw: events.raw ?? ignore, stageInstanceCreate: events.stageInstanceCreate ?? ignore, stageInstanceDelete: events.stageInstanceDelete ?? ignore, stageInstanceUpdate: events.stageInstanceUpdate ?? ignore, roleCreate: events.roleCreate ?? ignore, roleDelete: events.roleDelete ?? ignore, roleUpdate: events.roleUpdate ?? ignore, webhooksUpdate: events.webhooksUpdate ?? ignore, botUpdate: events.botUpdate ?? ignore, typingStart: events.typingStart ?? ignore, }; } export async function startBot(bot: Bot) { if (!Object.keys(bot.botGatewayData ?? {}).length) { bot.gateway.gatewayBot = await bot.helpers.getGatewayBot(); bot.gateway.lastShardId = bot.gateway.gatewayBot.shards - 1; bot.gateway.manager.totalShards = bot.gateway.gatewayBot.shards; } bot.gateway.spawnShards(); } export function createUtils(options: Partial) { return { snowflakeToBigint, bigintToSnowflake, calculateShardId, delay, iconHashToBigInt, iconBigintToHash, validateLength, urlToBase64, formatImageURL, calculateBits, calculatePermissions, }; } export interface HelperUtils { snowflakeToBigint: typeof snowflakeToBigint; bigintToSnowflake: typeof bigintToSnowflake; calculateShardId: typeof calculateShardId; delay: typeof delay; iconHashToBigInt: typeof iconHashToBigInt; iconBigintToHash: typeof iconBigintToHash; validateLength: typeof validateLength; urlToBase64: typeof urlToBase64; formatImageURL: typeof formatImageURL; calculateBits: typeof calculateBits; calculatePermissions: typeof calculatePermissions; } export async function stopBot(bot: Bot) { await bot.gateway.stop(1000, "User requested bot stop"); return bot; } export interface CreateBotOptions { token: string; botId?: bigint; applicationId?: bigint; secretKey?: string; events?: Partial; intents?: GatewayIntents; botGatewayData?: GetGatewayBot; rest?: Omit; handleDiscordPayload?: CreateShardManager["handleMessage"]; utils?: Partial>; transformers?: Partial>; helpers?: Partial; } export type UnPromise> = T extends Promise ? K : never; export interface Bot { id: bigint; applicationId: bigint; token: string; intents: GatewayIntents; urlWSS: string; botGatewayData?: GetGatewayBot; utils: ReturnType; transformers: Transformers; helpers: ReturnType; rest: ReturnType; gateway: ReturnType; events: EventHandlers; handlers: ReturnType; activeGuildIds: Set; constants: ReturnType; cache: { unrepliedInteractions: Set; fetchAllMembersProcessingRequests: Map; }; enabledPlugins: Set; handleDiscordPayload?: CreateShardManager["handleMessage"]; } export const defaultHelpers = { ...helpers }; export type DefaultHelpers = typeof defaultHelpers; // deno-lint-ignore no-empty-interface export interface Helpers extends DefaultHelpers {} // Use interface for declaration merging export function createHelpers( bot: Bot, customHelpers?: Partial, ): FinalHelpers { const converted = {} as FinalHelpers; for ( const [name, fun] of Object.entries({ ...createBaseHelpers(customHelpers || {}), }) ) { // @ts-ignore - TODO: make the types better converted[name as keyof FinalHelpers] = ( // @ts-ignore - TODO: make the types better ...args: RemoveFirstFromTuple> ) => // @ts-ignore - TODO: make the types better fun(bot, ...args); } return converted; } export function createBaseHelpers(options: Partial) { return { ...defaultHelpers, ...options, }; } export interface Transformers { reverse: { allowedMentions: (bot: Bot, payload: AllowedMentions) => DiscordAllowedMentions; embed: (bot: Bot, payload: Embed) => DiscordEmbed; component: (bot: Bot, payload: Component) => DiscordComponent; activity: (bot: Bot, payload: Activity) => DiscordActivity; member: (bot: Bot, payload: Member) => DiscordMember; user: (bot: Bot, payload: User) => DiscordUser; team: (bot: Bot, payload: Team) => DiscordTeam; application: (bot: Bot, payload: Application) => DiscordApplication; }; snowflake: (snowflake: string) => bigint; gatewayBot: (payload: DiscordGetGatewayBot) => GetGatewayBot; automodRule: (bot: Bot, payload: DiscordAutoModerationRule) => AutoModerationRule; automodActionExecution: (bot: Bot, payload: DiscordAutoModerationActionExecution) => AutoModerationActionExecution; channel: (bot: Bot, payload: { channel: DiscordChannel } & { guildId?: bigint }) => Channel; guild: (bot: Bot, payload: { guild: DiscordGuild } & { shardId: number }) => Guild; user: (bot: Bot, payload: DiscordUser) => User; member: (bot: Bot, payload: DiscordMember, guildId: bigint, userId: bigint) => Member; message: (bot: Bot, payload: DiscordMessage) => Message; role: (bot: Bot, payload: { role: DiscordRole } & { guildId: bigint }) => Role; voiceState: (bot: Bot, payload: { voiceState: DiscordVoiceState } & { guildId: bigint }) => VoiceState; interaction: (bot: Bot, payload: DiscordInteraction) => Interaction; interactionDataOptions: (bot: Bot, payload: DiscordInteractionDataOption) => InteractionDataOption; integration: (bot: Bot, payload: DiscordIntegrationCreateUpdate) => Integration; invite: (bot: Bot, invite: DiscordInviteCreate) => Invite; application: (bot: Bot, payload: DiscordApplication) => Application; team: (bot: Bot, payload: DiscordTeam) => Team; emoji: (bot: Bot, payload: DiscordEmoji) => Emoji; activity: (bot: Bot, payload: DiscordActivity) => Activity; presence: (bot: Bot, payload: DiscordPresenceUpdate) => PresenceUpdate; attachment: (bot: Bot, payload: DiscordAttachment) => Attachment; embed: (bot: Bot, payload: DiscordEmbed) => Embed; component: (bot: Bot, payload: DiscordComponent) => Component; webhook: (bot: Bot, payload: DiscordWebhook) => Webhook; auditLogEntry: (bot: Bot, payload: DiscordAuditLogEntry) => AuditLogEntry; applicationCommand: (bot: Bot, payload: DiscordApplicationCommand) => ApplicationCommand; applicationCommandOption: (bot: Bot, payload: DiscordApplicationCommandOption) => ApplicationCommandOption; applicationCommandPermission: ( bot: Bot, payload: DiscordGuildApplicationCommandPermissions, ) => ApplicationCommandPermission; scheduledEvent: (bot: Bot, payload: DiscordScheduledEvent) => ScheduledEvent; threadMember: (bot: Bot, payload: DiscordThreadMember) => ThreadMember; welcomeScreen: (bot: Bot, payload: DiscordWelcomeScreen) => WelcomeScreen; voiceRegion: (bot: Bot, payload: DiscordVoiceRegion) => VoiceRegions; widget: (bot: Bot, payload: DiscordGuildWidget) => GuildWidget; widgetSettings: (bot: Bot, payload: DiscordGuildWidgetSettings) => GuildWidgetSettings; stageInstance: (bot: Bot, payload: DiscordStageInstance) => StageInstance; sticker: (bot: Bot, payload: DiscordSticker) => Sticker; stickerPack: (bot: Bot, payload: DiscordStickerPack) => StickerPack; applicationCommandOptionChoice: ( bot: Bot, payload: DiscordApplicationCommandOptionChoice, ) => ApplicationCommandOptionChoice; template: (bot: Bot, payload: DiscordTemplate) => Template; } export function createTransformers(options: Partial) { return { reverse: { allowedMentions: options.reverse?.allowedMentions || transformAllowedMentionsToDiscordAllowedMentions, embed: options.reverse?.embed || transformEmbedToDiscordEmbed, component: options.reverse?.component || transformComponentToDiscordComponent, activity: options.reverse?.activity || transformActivityToDiscordActivity, member: options.reverse?.member || transformMemberToDiscordMember, user: options.reverse?.user || transformUserToDiscordUser, team: options.reverse?.team || transformTeamToDiscordTeam, application: options.reverse?.application || transformApplicationToDiscordApplication, }, automodRule: options.automodRule || transformAutoModerationRule, automodActionExecution: options.automodActionExecution || transformAutoModerationActionExecution, activity: options.activity || transformActivity, application: options.application || transformApplication, attachment: options.attachment || transformAttachment, channel: options.channel || transformChannel, component: options.component || transformComponent, embed: options.embed || transformEmbed, emoji: options.emoji || transformEmoji, guild: options.guild || transformGuild, integration: options.integration || transformIntegration, interaction: options.interaction || transformInteraction, interactionDataOptions: options.interactionDataOptions || transformInteractionDataOption, invite: options.invite || transformInvite, member: options.member || transformMember, message: options.message || transformMessage, presence: options.presence || transformPresence, role: options.role || transformRole, user: options.user || transformUser, team: options.team || transformTeam, voiceState: options.voiceState || transformVoiceState, snowflake: options.snowflake || snowflakeToBigint, webhook: options.webhook || transformWebhook, auditLogEntry: options.auditLogEntry || transformAuditLogEntry, applicationCommand: options.applicationCommand || transformApplicationCommand, applicationCommandOption: options.applicationCommandOption || transformApplicationCommandOption, applicationCommandPermission: options.applicationCommandPermission || transformApplicationCommandPermission, scheduledEvent: options.scheduledEvent || transformScheduledEvent, threadMember: options.threadMember || transformThreadMember, welcomeScreen: options.welcomeScreen || transformWelcomeScreen, voiceRegion: options.voiceRegion || transformVoiceRegion, widget: options.widget || transformWidget, widgetSettings: options.widgetSettings || transformWidgetSettings, stageInstance: options.stageInstance || transformStageInstance, sticker: options.sticker || transformSticker, stickerPack: options.stickerPack || transformStickerPack, gatewayBot: options.gatewayBot || transformGatewayBot, applicationCommandOptionChoice: options.applicationCommandOptionChoice || transformApplicationCommandOptionChoice, template: options.template || transformTemplate, }; } export interface EventHandlers { debug: (text: string, ...args: any[]) => unknown; automodRuleCreate: (bot: Bot, rule: AutoModerationRule) => unknown; automodRuleUpdate: (bot: Bot, rule: AutoModerationRule) => unknown; automodRuleDelete: (bot: Bot, rule: AutoModerationRule) => unknown; automodActionExecution: (bot: Bot, payload: AutoModerationActionExecution) => unknown; threadCreate: (bot: Bot, thread: Channel) => unknown; threadDelete: (bot: Bot, thread: Channel) => unknown; threadMemberUpdate: (bot: Bot, payload: { id: bigint; guildId: bigint; joinedAt: number; flags: number; }) => unknown; threadMembersUpdate: ( bot: Bot, payload: { id: bigint; guildId: bigint; addedMembers?: ThreadMember[]; removedMemberIds?: bigint[]; }, ) => unknown; threadUpdate: (bot: Bot, thread: Channel) => unknown; scheduledEventCreate: (bot: Bot, event: ScheduledEvent) => unknown; scheduledEventUpdate: (bot: Bot, event: ScheduledEvent) => unknown; scheduledEventDelete: (bot: Bot, event: ScheduledEvent) => unknown; /** Sent when a user has subscribed to a guild scheduled event. EXPERIMENTAL! */ scheduledEventUserAdd: ( bot: Bot, payload: { guildScheduledEventId: bigint; guildId: bigint; userId: bigint; }, ) => unknown; /** Sent when a user has unsubscribed to a guild scheduled event. EXPERIMENTAL! */ scheduledEventUserRemove: ( bot: Bot, payload: { guildScheduledEventId: bigint; guildId: bigint; userId: bigint; }, ) => unknown; ready: ( bot: Bot, payload: { shardId: number; v: number; user: User; guilds: bigint[]; sessionId: string; shard?: number[]; applicationId: bigint; }, rawPayload: DiscordReady, ) => unknown; interactionCreate: (bot: Bot, interaction: Interaction) => unknown; integrationCreate: (bot: Bot, integration: Integration) => unknown; integrationDelete: ( bot: Bot, payload: { id: bigint; guildId: bigint; applicationId?: bigint }, ) => unknown; integrationUpdate: (bot: Bot, payload: { guildId: bigint }) => unknown; inviteCreate: (bot: Bot, invite: Invite) => unknown; inviteDelete: ( bot: Bot, payload: { channelId: bigint; guildId?: bigint; code: string; }, ) => unknown; guildMemberAdd: ( bot: Bot, member: Member, user: User, ) => unknown; guildMemberRemove: (bot: Bot, user: User, guildId: bigint) => unknown; guildMemberUpdate: ( bot: Bot, member: Member, user: User, ) => unknown; messageCreate: (bot: Bot, message: Message) => unknown; messageDelete: ( bot: Bot, payload: { id: bigint; channelId: bigint; guildId?: bigint }, message?: Message, ) => unknown; messageDeleteBulk: (bot: Bot, payload: { ids: bigint[]; channelId: bigint; guildId?: bigint }) => unknown; messageUpdate: ( bot: Bot, message: Message, oldMessage?: Message, ) => unknown; reactionAdd: ( bot: Bot, payload: { userId: bigint; channelId: bigint; messageId: bigint; guildId?: bigint; member?: Member; user?: User; emoji: Emoji; }, ) => unknown; reactionRemove: ( bot: Bot, payload: { userId: bigint; channelId: bigint; messageId: bigint; guildId?: bigint; emoji: Emoji; }, ) => unknown; reactionRemoveEmoji: ( bot: Bot, payload: { channelId: bigint; messageId: bigint; guildId?: bigint; emoji: Emoji; }, ) => unknown; reactionRemoveAll: ( bot: Bot, payload: { channelId: bigint; messageId: bigint; guildId?: bigint; }, ) => unknown; presenceUpdate: ( bot: Bot, presence: PresenceUpdate, oldPresence?: PresenceUpdate, ) => unknown; voiceServerUpdate: ( bot: Bot, payload: { token: string; endpoint?: string; guildId: bigint }, ) => unknown; voiceStateUpdate: ( bot: Bot, voiceState: VoiceState, ) => unknown; channelCreate: (bot: Bot, channel: Channel) => unknown; dispatchRequirements: ( bot: Bot, data: DiscordGatewayPayload, shardId: number, ) => unknown; channelDelete: (bot: Bot, channel: Channel) => unknown; channelPinsUpdate: ( bot: Bot, data: { guildId?: bigint; channelId: bigint; lastPinTimestamp?: number }, ) => unknown; channelUpdate: (bot: Bot, channel: Channel) => unknown; stageInstanceCreate: ( bot: Bot, data: { id: bigint; guildId: bigint; channelId: bigint; topic: string; }, ) => unknown; stageInstanceDelete: ( bot: Bot, data: { id: bigint; guildId: bigint; channelId: bigint; topic: string; }, ) => unknown; stageInstanceUpdate: ( bot: Bot, data: { id: bigint; guildId: bigint; channelId: bigint; topic: string; }, ) => unknown; guildEmojisUpdate: ( bot: Bot, payload: { guildId: bigint; emojis: Collection; }, ) => unknown; guildBanAdd: (bot: Bot, user: User, guildId: bigint) => unknown; guildBanRemove: (bot: Bot, user: User, guildId: bigint) => unknown; guildLoaded: (bot: Bot, guild: Guild) => unknown; guildCreate: (bot: Bot, guild: Guild) => unknown; guildDelete: (bot: Bot, id: bigint, shardId: number) => unknown; guildUpdate: (bot: Bot, guild: Guild) => unknown; raw: (bot: Bot, data: DiscordGatewayPayload, shardId: number) => unknown; roleCreate: (bot: Bot, role: Role) => unknown; roleDelete: (bot: Bot, payload: { guildId: bigint; roleId: bigint }) => unknown; roleUpdate: (bot: Bot, role: Role) => unknown; webhooksUpdate: ( bot: Bot, payload: { channelId: bigint; guildId: bigint }, ) => unknown; botUpdate: (bot: Bot, user: User) => unknown; typingStart: ( bot: Bot, payload: { guildId: bigint | undefined; channelId: bigint; userId: bigint; timestamp: number; member: Member | undefined; }, ) => unknown; } export function createBotConstants() { return { DISCORDENO_VERSION, USER_AGENT, BASE_URL: baseEndpoints.BASE_URL, CDN_URL: baseEndpoints.CDN_URL, routes, regexes: { SLASH_COMMANDS_NAME_REGEX, CONTEXT_MENU_COMMANDS_NAME_REGEX, CHANNEL_MENTION_REGEX, DISCORD_SNOWFLAKE_REGEX, }, Errors, }; } export interface BotGatewayHandlerOptions { READY: typeof handlers.handleReady; CHANNEL_CREATE: typeof handlers.handleChannelCreate; CHANNEL_DELETE: typeof handlers.handleChannelDelete; CHANNEL_PINS_UPDATE: typeof handlers.handleChannelPinsUpdate; CHANNEL_UPDATE: typeof handlers.handleChannelUpdate; THREAD_CREATE: typeof handlers.handleThreadCreate; THREAD_UPDATE: typeof handlers.handleThreadUpdate; THREAD_DELETE: typeof handlers.handleThreadDelete; THREAD_LIST_SYNC: typeof handlers.handleThreadListSync; THREAD_MEMBERS_UPDATE: typeof handlers.handleThreadMembersUpdate; STAGE_INSTANCE_CREATE: typeof handlers.handleStageInstanceCreate; STAGE_INSTANCE_UPDATE: typeof handlers.handleStageInstanceUpdate; STAGE_INSTANCE_DELETE: typeof handlers.handleStageInstanceDelete; GUILD_BAN_ADD: typeof handlers.handleGuildBanAdd; GUILD_BAN_REMOVE: typeof handlers.handleGuildBanRemove; GUILD_CREATE: typeof handlers.handleGuildCreate; GUILD_LOADED_DD: typeof handlers.handleGuildLoaded; GUILD_DELETE: typeof handlers.handleGuildDelete; GUILD_EMOJIS_UPDATE: typeof handlers.handleGuildEmojisUpdate; GUILD_INTEGRATIONS_UPDATE: typeof handlers.handleGuildIntegrationsUpdate; GUILD_MEMBER_ADD: typeof handlers.handleGuildMemberAdd; GUILD_MEMBER_REMOVE: typeof handlers.handleGuildMemberRemove; GUILD_MEMBER_UPDATE: typeof handlers.handleGuildMemberUpdate; GUILD_MEMBERS_CHUNK: typeof handlers.handleGuildMembersChunk; GUILD_ROLE_CREATE: typeof handlers.handleGuildRoleCreate; GUILD_ROLE_DELETE: typeof handlers.handleGuildRoleDelete; GUILD_ROLE_UPDATE: typeof handlers.handleGuildRoleUpdate; GUILD_SCHEDULED_EVENT_CREATE: typeof handlers.handleGuildScheduledEventCreate; GUILD_SCHEDULED_EVENT_DELETE: typeof handlers.handleGuildScheduledEventDelete; GUILD_SCHEDULED_EVENT_UPDATE: typeof handlers.handleGuildScheduledEventUpdate; GUILD_SCHEDULED_EVENT_USER_ADD: typeof handlers.handleGuildScheduledEventUserAdd; GUILD_SCHEDULED_EVENT_USER_REMOVE: typeof handlers.handleGuildScheduledEventUserRemove; GUILD_UPDATE: typeof handlers.handleGuildUpdate; INTERACTION_CREATE: typeof handlers.handleInteractionCreate; INVITE_CREATE: typeof handlers.handleInviteCreate; INVITE_DELETE: typeof handlers.handleInviteCreate; MESSAGE_CREATE: typeof handlers.handleMessageCreate; MESSAGE_DELETE_BULK: typeof handlers.handleMessageDeleteBulk; MESSAGE_DELETE: typeof handlers.handleMessageDelete; MESSAGE_REACTION_ADD: typeof handlers.handleMessageReactionAdd; MESSAGE_REACTION_REMOVE_ALL: typeof handlers.handleMessageReactionRemoveAll; MESSAGE_REACTION_REMOVE_EMOJI: typeof handlers.handleMessageReactionRemoveEmoji; MESSAGE_REACTION_REMOVE: typeof handlers.handleMessageReactionRemove; MESSAGE_UPDATE: typeof handlers.handleMessageUpdate; PRESENCE_UPDATE: typeof handlers.handlePresenceUpdate; TYPING_START: typeof handlers.handleTypingStart; USER_UPDATE: typeof handlers.handleUserUpdate; VOICE_SERVER_UPDATE: typeof handlers.handleVoiceServerUpdate; VOICE_STATE_UPDATE: typeof handlers.handleVoiceStateUpdate; WEBHOOKS_UPDATE: typeof handlers.handleWebhooksUpdate; INTEGRATION_CREATE: typeof handlers.handleIntegrationCreate; INTEGRATION_UPDATE: typeof handlers.handleIntegrationUpdate; INTEGRATION_DELETE: typeof handlers.handleIntegrationDelete; } export function createBotGatewayHandlers( options: Partial, ): Record< GatewayDispatchEventNames | "GUILD_LOADED_DD", (bot: Bot, data: DiscordGatewayPayload, shardId: number) => any > { return { // misc READY: options.READY ?? handlers.handleReady, // channels CHANNEL_CREATE: options.CHANNEL_CREATE ?? handlers.handleChannelCreate, CHANNEL_DELETE: options.CHANNEL_DELETE ?? handlers.handleChannelDelete, CHANNEL_PINS_UPDATE: options.CHANNEL_PINS_UPDATE ?? handlers.handleChannelPinsUpdate, CHANNEL_UPDATE: options.CHANNEL_UPDATE ?? handlers.handleChannelUpdate, THREAD_CREATE: options.THREAD_CREATE ?? handlers.handleThreadCreate, THREAD_UPDATE: options.THREAD_UPDATE ?? handlers.handleThreadUpdate, THREAD_DELETE: options.THREAD_DELETE ?? handlers.handleThreadDelete, THREAD_LIST_SYNC: options.THREAD_LIST_SYNC ?? handlers.handleThreadListSync, THREAD_MEMBERS_UPDATE: options.THREAD_MEMBERS_UPDATE ?? handlers.handleThreadMembersUpdate, STAGE_INSTANCE_CREATE: options.STAGE_INSTANCE_CREATE ?? handlers.handleStageInstanceCreate, STAGE_INSTANCE_UPDATE: options.STAGE_INSTANCE_UPDATE ?? handlers.handleStageInstanceUpdate, STAGE_INSTANCE_DELETE: options.STAGE_INSTANCE_DELETE ?? handlers.handleStageInstanceDelete, // guilds GUILD_BAN_ADD: options.GUILD_BAN_ADD ?? handlers.handleGuildBanAdd, GUILD_BAN_REMOVE: options.GUILD_BAN_REMOVE ?? handlers.handleGuildBanRemove, GUILD_CREATE: options.GUILD_CREATE ?? handlers.handleGuildCreate, GUILD_LOADED_DD: options.GUILD_LOADED_DD ?? handlers.handleGuildLoaded, GUILD_DELETE: options.GUILD_DELETE ?? handlers.handleGuildDelete, GUILD_EMOJIS_UPDATE: options.GUILD_EMOJIS_UPDATE ?? handlers.handleGuildEmojisUpdate, GUILD_INTEGRATIONS_UPDATE: options.GUILD_INTEGRATIONS_UPDATE ?? handlers.handleGuildIntegrationsUpdate, GUILD_MEMBER_ADD: options.GUILD_MEMBER_ADD ?? handlers.handleGuildMemberAdd, GUILD_MEMBER_REMOVE: options.GUILD_MEMBER_REMOVE ?? handlers.handleGuildMemberRemove, GUILD_MEMBER_UPDATE: options.GUILD_MEMBER_UPDATE ?? handlers.handleGuildMemberUpdate, GUILD_MEMBERS_CHUNK: options.GUILD_MEMBERS_CHUNK ?? handlers.handleGuildMembersChunk, GUILD_ROLE_CREATE: options.GUILD_ROLE_CREATE ?? handlers.handleGuildRoleCreate, GUILD_ROLE_DELETE: options.GUILD_ROLE_DELETE ?? handlers.handleGuildRoleDelete, GUILD_ROLE_UPDATE: options.GUILD_ROLE_UPDATE ?? handlers.handleGuildRoleUpdate, GUILD_UPDATE: options.GUILD_UPDATE ?? handlers.handleGuildUpdate, // guild events GUILD_SCHEDULED_EVENT_CREATE: options.GUILD_SCHEDULED_EVENT_CREATE ?? handlers.handleGuildScheduledEventCreate, GUILD_SCHEDULED_EVENT_DELETE: options.GUILD_SCHEDULED_EVENT_DELETE ?? handlers.handleGuildScheduledEventDelete, GUILD_SCHEDULED_EVENT_UPDATE: options.GUILD_SCHEDULED_EVENT_UPDATE ?? handlers.handleGuildScheduledEventUpdate, GUILD_SCHEDULED_EVENT_USER_ADD: options.GUILD_SCHEDULED_EVENT_USER_ADD ?? handlers.handleGuildScheduledEventUserAdd, GUILD_SCHEDULED_EVENT_USER_REMOVE: options.GUILD_SCHEDULED_EVENT_USER_REMOVE ?? handlers.handleGuildScheduledEventUserRemove, // interactions INTERACTION_CREATE: options.INTERACTION_CREATE ?? handlers.handleInteractionCreate, // invites INVITE_CREATE: options.INVITE_CREATE ?? handlers.handleInviteCreate, INVITE_DELETE: options.INVITE_DELETE ?? handlers.handleInviteCreate, // messages MESSAGE_CREATE: options.MESSAGE_CREATE ?? handlers.handleMessageCreate, MESSAGE_DELETE_BULK: options.MESSAGE_DELETE_BULK ?? handlers.handleMessageDeleteBulk, MESSAGE_DELETE: options.MESSAGE_DELETE ?? handlers.handleMessageDelete, MESSAGE_REACTION_ADD: options.MESSAGE_REACTION_ADD ?? handlers.handleMessageReactionAdd, MESSAGE_REACTION_REMOVE_ALL: options.MESSAGE_REACTION_REMOVE_ALL ?? handlers.handleMessageReactionRemoveAll, MESSAGE_REACTION_REMOVE_EMOJI: options.MESSAGE_REACTION_REMOVE_EMOJI ?? handlers.handleMessageReactionRemoveEmoji, MESSAGE_REACTION_REMOVE: options.MESSAGE_REACTION_REMOVE ?? handlers.handleMessageReactionRemove, MESSAGE_UPDATE: options.MESSAGE_UPDATE ?? handlers.handleMessageUpdate, // presence PRESENCE_UPDATE: options.PRESENCE_UPDATE ?? handlers.handlePresenceUpdate, TYPING_START: options.TYPING_START ?? handlers.handleTypingStart, USER_UPDATE: options.USER_UPDATE ?? handlers.handleUserUpdate, // voice VOICE_SERVER_UPDATE: options.VOICE_SERVER_UPDATE ?? handlers.handleVoiceServerUpdate, VOICE_STATE_UPDATE: options.VOICE_STATE_UPDATE ?? handlers.handleVoiceStateUpdate, // webhooks WEBHOOKS_UPDATE: options.WEBHOOKS_UPDATE ?? handlers.handleWebhooksUpdate, // integrations INTEGRATION_CREATE: options.INTEGRATION_CREATE ?? handlers.handleIntegrationCreate, INTEGRATION_UPDATE: options.INTEGRATION_UPDATE ?? handlers.handleIntegrationUpdate, INTEGRATION_DELETE: options.INTEGRATION_DELETE ?? handlers.handleIntegrationDelete, }; } export type RemoveFirstFromTuple = T["length"] extends 0 ? [] : ((...b: T) => void) extends (a: any, ...b: infer I) => void ? I : []; export type FinalHelpers = { [K in keyof Helpers]: ( ...args: RemoveFirstFromTuple> ) => ReturnType; };