import { checkRateLimits, processQueue, cleanupQueues, createRequestBody, processRateLimitedPaths, processRequest, processRequestHeaders, runMethod, processGlobalQueue, simplifyUrl, } from "./rest/mod.ts"; import type { RestPayload, RestRateLimitedPath, RestRequest } from "./rest/rest.ts"; import { GatewayIntents, Intents } from "./types/gateway/gatewayIntents.ts"; import { GetGatewayBot } from "./types/gateway/getGatewayBot.ts"; import { bigintToSnowflake, snowflakeToBigint } from "./util/bigint.ts"; import { Collection } from "./util/collection.ts"; import { DiscordenoMember, DiscordenoUser, transformMember, transformUser, DiscordenoGuild, transformGuild, DiscordenoChannel, transformChannel, transformMessage, transformRole, DiscordenoVoiceState, transformVoiceState, DiscordenoMessage, DiscordenoRole, } from "./transformers/mod.ts"; import { baseEndpoints, CHANNEL_MENTION_REGEX, CONTEXT_MENU_COMMANDS_NAME_REGEX, DISCORDENO_VERSION, DISCORD_SNOWFLAKE_REGEX, endpoints, SLASH_COMMANDS_NAME_REGEX, USER_AGENT, } from "./util/constants.ts"; import { Errors } from "./types/discordeno/errors.ts"; import { DiscordGatewayPayload, GatewayDispatchEventNames, GatewayPayload } from "./types/gateway/gatewayPayload.ts"; import { closeWS, handleOnMessage, resume, resharder, spawnShards, prepareBuckets, createShard, identify, heartbeat, tellWorkerToIdentify, sendShardMessage, DiscordenoShard, processGatewayQueue, } from "./ws/mod.ts"; import { validateLength } from "./util/validateLength.ts"; import { delay, formatImageURL, hasProperty } 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 { DiscordenoInteraction, transformInteraction } from "./transformers/interaction.ts"; import { DiscordenoIntegration, transformIntegration } from "./transformers/integration.ts"; import { Emoji } from "./types/emojis/emoji.ts"; import { transformApplication } from "./transformers/application.ts"; import { transformTeam } from "./transformers/team.ts"; import { DiscordenoInvite, transformInvite } from "./transformers/invite.ts"; import * as helpers from "./helpers/mod.ts"; import { DiscordenoEmoji, transformEmoji } from "./transformers/emoji.ts"; import { transformActivity } from "./transformers/activity.ts"; import { DiscordenoPresence, transformPresence } from "./transformers/presence.ts"; import { DiscordReady } from "./types/gateway/ready.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 { StatusUpdate } from "./types/gateway/statusUpdate.ts"; import { calculateBits, calculatePermissions } from "./util/permissions.ts"; import { transformScheduledEvent } from "./transformers/scheduledEvent.ts"; import { DiscordenoScheduledEvent } from "./transformers/scheduledEvent.ts"; import { DiscordenoThreadMember, 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 { transformStageInstance } from "./transformers/stageInstance.ts"; export function createBot(options: CreateBotOptions): Bot { const bot = { id: options.botId, applicationId: options.applicationId || options.botId, token: `Bot ${options.token}`, events: createEventHandlers(options.events), intents: options.intents.reduce((bits, next) => (bits |= GatewayIntents[next]), 0), 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({ token: bot.token, intents: bot.intents, debug: bot.events.debug, handleDiscordPayload: bot.handleDiscordPayload ?? async function (_, data: DiscordGatewayPayload, shardId: number) { // TRIGGER RAW EVENT bot.events.raw(bot as Bot, data, shardId); if (!data.t) return; // RUN DISPATCH CHECK await bot.events.dispatchRequirements(bot as Bot, data, shardId); bot.handlers[data.t as GatewayDispatchEventNames]?.(bot as Bot, data, shardId); }, }); return bot as Bot; } export function createEventHandlers(events: Partial): EventHandlers { function ignore() {} return { debug: events.debug ?? ignore, threadCreate: events.threadCreate ?? ignore, threadDelete: events.threadDelete ?? 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, 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, voiceChannelLeave: events.voiceChannelLeave ?? 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 interface CreateRestManagerOptions { token: string; customUrl?: string; maxRetryCount?: number; version?: number; secretKey?: string; debug?: (text: string) => unknown; checkRateLimits?: typeof checkRateLimits; cleanupQueues?: typeof cleanupQueues; processQueue?: typeof processQueue; processRateLimitedPaths?: typeof processRateLimitedPaths; processRequestHeaders?: typeof processRequestHeaders; processRequest?: typeof processRequest; createRequestBody?: typeof createRequestBody; runMethod?: typeof runMethod; simplifyUrl?: typeof simplifyUrl; processGlobalQueue?: typeof processGlobalQueue; } export function createRestManager(options: CreateRestManagerOptions) { const version = options.version || "9"; if (options.customUrl) { baseEndpoints.BASE_URL = `${options.customUrl}/v${version}`; } return { // current invalid amount invalidRequests: 0, // max invalid requests allowed until ban maxInvalidRequests: 10000, // 10 minutes invalidRequestsInterval: 600000, // timer to reset to 0 invalidRequestsTimeoutId: 0, // how safe to be from max invalidRequestsSafetyAmount: 1, // when first request in this period was made invalidRequestFrozenAt: 0, invalidRequestErrorStatuses: [401, 403, 429], version, token: `${options.token.startsWith("Bot ") ? "" : "Bot "}${options.token}`, maxRetryCount: options.maxRetryCount || 10, secretKey: options.secretKey || "discordeno_best_lib_ever", customUrl: options.customUrl || "", pathQueues: new Map< string, { isWaiting: boolean; requests: { request: RestRequest; payload: RestPayload; }[]; } >(), processingQueue: false, processingRateLimitedPaths: false, globallyRateLimited: false, globalQueue: [] as { request: RestRequest; payload: RestPayload; basicURL: string; urlToUse: string; }[], globalQueueProcessing: false, ratelimitedPaths: new Map(), debug: options.debug || function (_text: string) {}, checkRateLimits: options.checkRateLimits || checkRateLimits, cleanupQueues: options.cleanupQueues || cleanupQueues, processQueue: options.processQueue || processQueue, processRateLimitedPaths: options.processRateLimitedPaths || processRateLimitedPaths, processRequestHeaders: options.processRequestHeaders || processRequestHeaders, processRequest: options.processRequest || processRequest, createRequestBody: options.createRequestBody || createRequestBody, runMethod: options.runMethod || runMethod, simplifyUrl: options.simplifyUrl || simplifyUrl, processGlobalQueue: options.processGlobalQueue || processGlobalQueue, }; } export async function startBot(bot: Bot) { if (!bot.botGatewayData) bot.botGatewayData = await bot.helpers.getGatewayBot(); // SETUP GATEWAY LOGIN INFO bot.gateway.urlWSS = bot.botGatewayData.url; bot.gateway.shardsRecommended = bot.botGatewayData.shards; bot.gateway.sessionStartLimitTotal = bot.botGatewayData.sessionStartLimit.total; bot.gateway.sessionStartLimitRemaining = bot.botGatewayData.sessionStartLimit.remaining; bot.gateway.sessionStartLimitResetAfter = bot.botGatewayData.sessionStartLimit.resetAfter; bot.gateway.maxConcurrency = bot.botGatewayData.sessionStartLimit.maxConcurrency; bot.gateway.lastShardId = bot.botGatewayData.shards; bot.gateway.maxShards = bot.botGatewayData.shards; bot.gateway.spawnShards(bot.gateway); } export function createUtils(options: Partial) { return { snowflakeToBigint, bigintToSnowflake, calculateShardId, delay, iconHashToBigInt, iconBigintToHash, validateLength, hasProperty, 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; hasProperty: typeof hasProperty; urlToBase64: typeof urlToBase64; formatImageURL: typeof formatImageURL; calculateBits: typeof calculateBits; calculatePermissions: typeof calculatePermissions; } export function createGatewayManager( options: Partial & Pick ): GatewayManager { return { cache: { guildIds: new Set(), loadingGuildIds: new Set(), editedMessages: new Collection(), }, secretKey: options.secretKey ?? "", url: options.url ?? "", reshard: options.reshard ?? true, reshardPercentage: options.reshardPercentage ?? 80, spawnShardDelay: options.spawnShardDelay ?? 2600, maxShards: options.maxShards ?? options.shardsRecommended ?? 0, useOptimalLargeBotSharding: options.useOptimalLargeBotSharding ?? true, shardsPerWorker: options.shardsPerWorker ?? 25, maxWorkers: options.maxWorkers ?? 4, firstShardId: options.firstShardId ?? 0, lastShardId: options.lastShardId ?? options.maxShards ?? options.shardsRecommended ?? 1, token: options.token ?? "", compress: options.compress ?? false, $os: options.$os ?? "linux", $browser: options.$browser ?? "Discordeno", $device: options.$device ?? "Discordeno", intents: (Array.isArray(options.intents) ? options.intents.reduce((bits, next) => (bits |= GatewayIntents[next]), 0) : options.intents) ?? 0, shard: options.shard ?? [0, options.shardsRecommended ?? 1], urlWSS: options.urlWSS ?? "wss://gateway.discord.gg/?v=9&encoding=json", shardsRecommended: options.shardsRecommended ?? 1, sessionStartLimitTotal: options.sessionStartLimitTotal ?? 1000, sessionStartLimitRemaining: options.sessionStartLimitRemaining ?? 1000, sessionStartLimitResetAfter: options.sessionStartLimitResetAfter ?? 0, maxConcurrency: options.maxConcurrency ?? 1, shards: options.shards ?? new Collection(), loadingShards: options.loadingShards ?? new Collection(), buckets: new Collection(), utf8decoder: new TextDecoder(), prepareBuckets: options.prepareBuckets ?? prepareBuckets, spawnShards: options.spawnShards ?? spawnShards, createShard: options.createShard ?? createShard, identify: options.identify ?? identify, heartbeat: options.heartbeat ?? heartbeat, tellWorkerToIdentify, debug: options.debug || function () {}, resharder: options.resharder ?? resharder, handleOnMessage: options.handleOnMessage ?? handleOnMessage, processGatewayQueue: options.processGatewayQueue ?? processGatewayQueue, closeWS: options.closeWS ?? closeWS, sendShardMessage: options.sendShardMessage ?? sendShardMessage, resume: options.resume ?? resume, handleDiscordPayload: options.handleDiscordPayload, }; } export async function stopBot(bot: Bot) { // STOP WS bot.gateway.shards.forEach((shard) => { clearInterval(shard.heartbeat.intervalId); bot.gateway.closeWS(shard.ws, 3061, "Discordeno Testing Finished! Do Not RESUME!"); }); await delay(5000); return bot; } export interface CreateBotOptions { token: string; botId: bigint; applicationId?: bigint; secretKey?: string; events: Partial; intents: (keyof typeof GatewayIntents)[]; botGatewayData?: GetGatewayBot; rest?: Omit; handleDiscordPayload?: GatewayManager["handleDiscordPayload"]; 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: ReturnType; helpers: ReturnType; rest: ReturnType; gateway: ReturnType; events: EventHandlers; handlers: ReturnType; activeGuildIds: Set; constants: ReturnType; cache: { unrepliedInteractions: Set; fetchAllMembersProcessingRequests: Map; }; enabledPlugins: Set; handleDiscordPayload?: GatewayManager["handleDiscordPayload"]; } 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] = (...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 { snowflake: typeof snowflakeToBigint; channel: typeof transformChannel; guild: typeof transformGuild; user: typeof transformUser; member: typeof transformMember; message: typeof transformMessage; role: typeof transformRole; voiceState: typeof transformVoiceState; interaction: typeof transformInteraction; integration: typeof transformIntegration; invite: typeof transformInvite; application: typeof transformApplication; team: typeof transformTeam; emoji: typeof transformEmoji; activity: typeof transformActivity; presence: typeof transformPresence; attachment: typeof transformAttachment; embed: typeof transformEmbed; component: typeof transformComponent; webhook: typeof transformWebhook; auditlogEntry: typeof transformAuditlogEntry; applicationCommand: typeof transformApplicationCommand; applicationCommandOption: typeof transformApplicationCommandOption; applicationCommandPermission: typeof transformApplicationCommandPermission; scheduledEvent: typeof transformScheduledEvent; threadMember: typeof transformThreadMember; welcomeScreen: typeof transformWelcomeScreen; voiceRegion: typeof transformVoiceRegion; widget: typeof transformWidget; stageInstance: typeof transformStageInstance; } export function createTransformers(options: Partial) { return { 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, 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, stageInstance: options.stageInstance || transformStageInstance, }; } export type RestManager = ReturnType; export interface GatewayManager { /** The secret key authorization header the bot will expect when sending payloads. */ secretKey: string; /** The url that all discord payloads for the dispatch type should be sent to. */ url: string; /** Whether or not to automatically reshard. */ reshard: boolean; /** The percentage at which resharding should occur. */ reshardPercentage: number; /** The delay in milliseconds to wait before spawning next shard. OPTIMAL IS ABOVE 2500. YOU DON"T WANT TO HIT THE RATE LIMIT!!! */ spawnShardDelay: number; /** The maximum shard Id number. Useful for zero-downtime updates or resharding. */ maxShards: number; /** Whether or not the resharder should automatically switch to LARGE BOT SHARDING when you are above 100K servers. */ useOptimalLargeBotSharding: boolean; /** The amount of shards to load per worker. */ shardsPerWorker: number; /** The maximum amount of workers to use for your bot. */ maxWorkers: number; /** The first shard Id to start spawning. */ firstShardId: number; /** The last shard Id for this worker. */ lastShardId: number; token: string; compress: boolean; $os: string; $browser: string; $device: string; intents: number | (keyof typeof GatewayIntents)[]; shard: [number, number]; presence?: Omit; /** The WSS URL that can be used for connecting to the gateway. */ urlWSS: string; /** The recommended number of shards to use when connecting. */ shardsRecommended: number; /** The total number of session starts the current user is allowed. */ sessionStartLimitTotal: number; /** The remaining number of session starts the current user is allowed. */ sessionStartLimitRemaining: number; /** Milliseconds left until limit is reset. */ sessionStartLimitResetAfter: number; /** The number of identify requests allowed per 5 seconds. * So, if you had a max concurrency of 16, and 16 shards for example, you could start them all up at the same time. * Whereas if you had 32 shards, if you tried to start up shard 0 and 16 at the same time for example, it would not work. You can start shards 0-15 concurrently, then 16-31... */ maxConcurrency: number; shards: Collection; loadingShards: Collection< number, { shardId: number; resolve: (value: unknown) => void; } >; /** Stored as bucketId: { workers: [workerId, [ShardIds]], createNextShard: boolean } */ buckets: Collection< number, { workers: number[][]; createNextShard: (() => Promise)[]; } >; utf8decoder: TextDecoder; cache: { guildIds: Set; loadingGuildIds: Set; editedMessages: Collection; }; // METHODS /** Prepares the buckets for identifying */ prepareBuckets: typeof prepareBuckets; /** The handler for spawning ALL the shards. */ spawnShards: typeof spawnShards; /** Create the websocket and adds the proper handlers to the websocket. */ createShard: typeof createShard; /** Begins identification of the shard to discord. */ identify: typeof identify; /** Begins heartbeating of the shard to keep it alive. */ heartbeat: typeof heartbeat; /** Sends the discord payload to another server. */ handleDiscordPayload: (gateway: GatewayManager, data: GatewayPayload, shardId: number) => any; /** Tell the worker to begin identifying this shard */ tellWorkerToIdentify: typeof tellWorkerToIdentify; /** Handle the different logs. Used for debugging. */ debug: (text: string, ...args: any[]) => unknown; /** Handles resharding the bot when necessary. */ resharder: typeof resharder; /** Handles the message events from websocket. */ handleOnMessage: typeof handleOnMessage; /** Handles processing queue of requests send to this shard. */ processGatewayQueue: typeof processGatewayQueue; /** Closes shard WebSocket connection properly. */ closeWS: typeof closeWS; /** Properly adds a message to the shards queue. */ sendShardMessage: typeof sendShardMessage; /** Properly resume an old shards session. */ resume: typeof resume; } export interface EventHandlers { debug: (text: string, ...args: any[]) => unknown; threadCreate: (bot: Bot, thread: DiscordenoChannel) => unknown; threadDelete: (bot: Bot, thread: DiscordenoChannel) => unknown; threadMembersUpdate: ( bot: Bot, payload: { id: bigint; guildId: bigint; addedMembers?: DiscordenoThreadMember[]; removedMemberIds?: bigint[]; } ) => unknown; threadUpdate: (bot: Bot, thread: DiscordenoChannel) => unknown; scheduledEventCreate: (bot: Bot, event: DiscordenoScheduledEvent) => unknown; scheduledEventUpdate: (bot: Bot, event: DiscordenoScheduledEvent) => unknown; scheduledEventDelete: (bot: Bot, event: DiscordenoScheduledEvent) => 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: DiscordenoUser; guilds: bigint[]; sessionId: string; shard?: number[]; applicationId: bigint; }, rawPayload: DiscordReady ) => any; interactionCreate: (bot: Bot, interaction: DiscordenoInteraction) => any; integrationCreate: (bot: Bot, integration: DiscordenoIntegration) => any; integrationDelete: (bot: Bot, payload: { id: bigint; guildId: bigint; applicationId?: bigint }) => any; integrationUpdate: (bot: Bot, payload: { guildId: bigint }) => any; inviteCreate: (bot: Bot, invite: DiscordenoInvite) => any; inviteDelete: ( bot: Bot, payload: { channelId: bigint; guildId?: bigint; code: string; } ) => any; guildMemberAdd: (bot: Bot, member: DiscordenoMember, user: DiscordenoUser) => any; guildMemberRemove: (bot: Bot, user: DiscordenoUser, guildId: bigint) => any; guildMemberUpdate: (bot: Bot, member: DiscordenoMember, user: DiscordenoUser) => any; messageCreate: (bot: Bot, message: DiscordenoMessage) => any; messageDelete: ( bot: Bot, payload: { id: bigint; channelId: bigint; guildId?: bigint }, message?: DiscordenoMessage ) => any; messageUpdate: (bot: Bot, message: DiscordenoMessage, oldMessage?: DiscordenoMessage) => any; reactionAdd: ( bot: Bot, payload: { userId: bigint; channelId: bigint; messageId: bigint; guildId?: bigint; member?: DiscordenoMember; emoji: DiscordenoEmoji; } ) => any; reactionRemove: ( bot: Bot, payload: { userId: bigint; channelId: bigint; messageId: bigint; guildId?: bigint; emoji: DiscordenoEmoji; } ) => any; reactionRemoveEmoji: ( bot: Bot, payload: { channelId: bigint; messageId: bigint; guildId?: bigint; emoji: DiscordenoEmoji; } ) => any; reactionRemoveAll: ( bot: Bot, payload: { channelId: bigint; messageId: bigint; guildId?: bigint; } ) => any; presenceUpdate: (bot: Bot, presence: DiscordenoPresence, oldPresence?: DiscordenoPresence) => any; voiceServerUpdate: (bot: Bot, payload: { token: string; endpoint?: string; guildId: bigint }) => any; voiceStateUpdate: ( bot: Bot, voiceState: { guildId?: bigint; channelId?: bigint; userId: bigint; member?: DiscordenoMember; user?: DiscordenoUser; sessionId: string; deaf: boolean; mute: boolean; selfDeaf: boolean; selfMute: boolean; selfStream?: boolean; selfVideo: boolean; suppress: boolean; requestToSpeakTimestamp?: number; } ) => any; channelCreate: (bot: Bot, channel: DiscordenoChannel) => any; dispatchRequirements: (bot: Bot, data: GatewayPayload, shardId: number) => any; voiceChannelLeave: ( bot: Bot, voiceState: DiscordenoVoiceState, guild: DiscordenoGuild, channel?: DiscordenoChannel ) => any; channelDelete: (bot: Bot, channel: DiscordenoChannel) => any; channelPinsUpdate: (bot: Bot, data: { guildId?: bigint; channelId: bigint; lastPinTimestamp?: number }) => any; channelUpdate: (bot: Bot, channel: DiscordenoChannel) => any; stageInstanceCreate: ( bot: Bot, data: { id: bigint; guildId: bigint; channelId: bigint; topic: string; privacyLevel: number; discoverableDisabled: boolean; } ) => any; stageInstanceDelete: ( bot: Bot, data: { id: bigint; guildId: bigint; channelId: bigint; topic: string; privacyLevel: number; discoverableDisabled: boolean; } ) => any; stageInstanceUpdate: ( bot: Bot, data: { id: bigint; guildId: bigint; channelId: bigint; topic: string; privacyLevel: number; discoverableDisabled: boolean; } ) => any; // TODO: THREADS guildEmojisUpdate: ( bot: Bot, payload: { guildId: bigint; emojis: Collection; } ) => any; guildBanAdd: (bot: Bot, user: DiscordenoUser, guildId: bigint) => any; guildBanRemove: (bot: Bot, user: DiscordenoUser, guildId: bigint) => any; guildLoaded: (bot: Bot, guild: DiscordenoGuild) => any; guildCreate: (bot: Bot, guild: DiscordenoGuild) => any; guildDelete: (bot: Bot, id: bigint, shardId: number) => any; guildUpdate: (bot: Bot, guild: DiscordenoGuild) => any; raw: (bot: Bot, data: GatewayPayload, shardId: number) => any; roleCreate: (bot: Bot, role: DiscordenoRole) => any; roleDelete: (bot: Bot, payload: { guildId: bigint; roleId: bigint }) => any; roleUpdate: (bot: Bot, role: DiscordenoRole) => any; webhooksUpdate: (bot: Bot, payload: { channelId: bigint; guildId: bigint }) => any; botUpdate: (bot: Bot, user: DiscordenoUser) => any; typingStart: ( bot: Bot, payload: { guildId: bigint | undefined; channelId: bigint; userId: bigint; timestamp: number; member: DiscordenoMember | undefined; } ) => any; } export function createBotConstants() { return { DISCORDENO_VERSION, USER_AGENT, BASE_URL: baseEndpoints.BASE_URL, CDN_URL: baseEndpoints.CDN_URL, endpoints, 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_MEMBER_UPDATE: typeof handlers.handleThreadMemberUpdate; 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 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_MEMBER_UPDATE: options.THREAD_MEMBER_UPDATE ?? handlers.handleThreadMemberUpdate, // 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; };