carbon-proxy 0.14.0

package/dist/src/classes/Client.d.ts

@@ -0,0 +1,253 @@
+import { type APIApplicationCommand, type APIInteraction } from "discord-api-types/v10";
+import type { BaseCommand } from "../abstracts/BaseCommand.js";
+import type { BaseListener } from "../abstracts/BaseListener.js";
+import type { BaseMessageInteractiveComponent } from "../abstracts/BaseMessageInteractiveComponent.js";
+import type { Context, Plugin, Route } from "../abstracts/Plugin.js";
+import { CommandHandler } from "../internals/CommandHandler.js";
+import { ComponentHandler } from "../internals/ComponentHandler.js";
+import { EmojiHandler } from "../internals/EmojiHandler.js";
+import { EventHandler } from "../internals/EventHandler.js";
+import type { EventQueueOptions } from "../internals/EventQueue.js";
+import { ModalHandler } from "../internals/ModalHandler.js";
+import { TemporaryListenerManager } from "../internals/TemporaryListenerManager.js";
+import { Guild } from "../structures/Guild.js";
+import { GuildMember } from "../structures/GuildMember.js";
+import { Message } from "../structures/Message.js";
+import { Role } from "../structures/Role.js";
+import { User } from "../structures/User.js";
+import { Webhook, type WebhookInput } from "../structures/Webhook.js";
+import type { Modal } from "./Modal.js";
+import { RequestClient, type RequestClientOptions } from "./RequestClient.js";
+/**
+ * The options used for initializing the client
+ */
+export interface ClientOptions {
+    /**
+     * The base URL of the app
+     */
+    baseUrl: string;
+    /**
+     * The client ID of the app
+     */
+    clientId: string;
+    /**
+     * The deploy secret of the app, used for protecting the deploy route
+     */
+    deploySecret?: string;
+    /**
+     * The public key of the app, used for interaction verification
+     * Can be a single key or an array of keys
+     */
+    publicKey: string | string[];
+    /**
+     * The token of the bot
+     */
+    token: string;
+    /**
+     * The options used to initialize the request client, if you want to customize it.
+     */
+    requestOptions?: RequestClientOptions;
+    /**
+     * Whether the commands should be deployed to Discord automatically.
+     * @default false
+     */
+    autoDeploy?: boolean;
+    /**
+     * Whether the deploy route should be disabled.
+     * @default false
+     */
+    disableDeployRoute?: boolean;
+    /**
+     * Whether the interactions route should be disabled
+     * @default false
+     */
+    disableInteractionsRoute?: boolean;
+    /**
+     * Whether the events route should be disabled
+     * @default false
+     */
+    disableEventsRoute?: boolean;
+    /**
+     * A list of guild IDs to deploy all commands to during development (guild command deployment is instant and rate-limited higher).
+     * If set, all commands will be deployed to these guilds instead of globally.
+     */
+    devGuilds?: string[];
+    /**
+     * Configuration for the event queue worker pool
+     */
+    eventQueue?: EventQueueOptions;
+}
+/**
+ * The main client used to interact with Discord
+ */
+export declare class Client {
+    /**
+     * The routes that the client will handle
+     */
+    routes: Route[];
+    /**
+     * The plugins that the client has registered
+     */
+    plugins: {
+        id: string;
+        plugin: Plugin;
+    }[];
+    /**
+     * The options used to initialize the client
+     */
+    options: ClientOptions;
+    /**
+     * The commands that the client has registered
+     */
+    commands: BaseCommand[];
+    /**
+     * The event listeners that the client has registered
+     */
+    listeners: BaseListener[];
+    /**
+     * The rest client used to interact with the Discord API
+     */
+    rest: RequestClient;
+    /**
+     * The handler for the component interactions sent from Discord
+     * @internal
+     */
+    componentHandler: ComponentHandler;
+    /**
+     * The handler for the modal interactions sent from Discord
+     * @internal
+     */
+    commandHandler: CommandHandler;
+    /**
+     * The handler for the modal interactions sent from Discord
+     * @internal
+     */
+    modalHandler: ModalHandler;
+    /**
+     * The handler for events sent from Discord
+     * @internal
+     */
+    eventHandler: EventHandler;
+    /**
+     * The manager for temporary event listeners with automatic cleanup
+     */
+    temporaryListeners: TemporaryListenerManager;
+    /**
+     * The handler for application emojis for this application
+     */
+    emoji: EmojiHandler;
+    private cachedGlobalCommands;
+    /**
+     * The ID of the shard this client is running on, if sharding is enabled
+     */
+    shardId?: number;
+    /**
+     * The total number of shards, if sharding is enabled
+     */
+    totalShards?: number;
+    /**
+     * Creates a new client
+     * @param options The options used to initialize the client
+     * @param handlers The handlers that the client has registered
+     * @param plugins The plugins that the client should use
+     */
+    constructor(options: ClientOptions, handlers: {
+        commands?: BaseCommand[];
+        listeners?: BaseListener[];
+        components?: BaseMessageInteractiveComponent[];
+        modals?: Modal[];
+    }, plugins?: Plugin[]);
+    getPlugin<T extends Plugin>(id: string): T | undefined;
+    private appendRoutes;
+    /**
+     * Handle a request to deploy the commands to Discord
+     * @returns A response
+     */
+    handleDeployRequest(): Promise<Response>;
+    /**
+     * Handle an interaction request from Discord
+     * @param req The request to handle
+     * @returns A response
+     */
+    handleEventsRequest(req: Request): Promise<Response>;
+    /**
+     * Handle an interaction request from Discord
+     * @param req The request to handle
+     * @param ctx The context for the request
+     * @returns A response
+     */
+    handleInteractionsRequest(req: Request, ctx: Context): Promise<Response>;
+    /**
+     * Handle an interaction request from Discord
+     * @param interaction The interaction to handle
+     * @param ctx The context for the request
+     * @returns A response
+     */
+    handleInteraction(interaction: APIInteraction, ctx: Context): Promise<void>;
+    /**
+     * Validate a request from Discord
+     * @param req The request to validate
+     */
+    protected validateDiscordRequest(req: Request): Promise<boolean>;
+    /**
+     * Register an event listener with the client.
+     * This method provides type-safe listener registration without requiring
+     * manual type casting at the call site.
+     * @param listener The listener to register
+     */
+    registerListener<T extends BaseListener>(listener: T): void;
+    /**
+     * Fetch a user from the Discord API
+     * @param id The ID of the user to fetch
+     * @returns The user data
+     */
+    fetchUser(id: string): Promise<User<false>>;
+    /**
+     * Fetch a guild from the Discord API
+     * @param id The ID of the guild to fetch
+     * @returns The guild data
+     */
+    fetchGuild(id: string): Promise<Guild<false>>;
+    /**
+     * Fetch a channel from the Discord API
+     * @param id The ID of the channel to fetch
+     * @returns The channel data
+     */
+    fetchChannel(id: string): Promise<import("../index.js").DmChannel<false> | import("../index.js").GroupDmChannel<false> | import("../index.js").GuildTextChannel<false> | import("../index.js").GuildVoiceChannel<false> | import("../index.js").GuildCategoryChannel<false> | import("../index.js").GuildAnnouncementChannel<false> | import("../index.js").GuildThreadChannel<import("discord-api-types/v10").ChannelType.AnnouncementThread | import("discord-api-types/v10").ChannelType.PublicThread | import("discord-api-types/v10").ChannelType.PrivateThread, false> | import("../index.js").GuildStageChannel<false> | import("../index.js").GuildForumChannel<false> | import("../index.js").GuildMediaChannel | null>;
+    /**
+     * Fetch a role from the Discord API
+     * @param guildId The ID of the guild the role is in
+     * @param id The ID of the role to fetch
+     * @returns The role data
+     */
+    fetchRole(guildId: string, id: string): Promise<Role<false>>;
+    /**
+     * Fetch a member from the Discord API
+     * @param guildId The ID of the guild the member is in
+     * @param id The ID of the member to fetch
+     * @returns The member data
+     */
+    fetchMember(guildId: string, id: string): Promise<GuildMember<false, true>>;
+    /**
+     * Fetch a message from the Discord API
+     * @param channelId The ID of the channel the message is in
+     * @param messageId The ID of the message to fetch
+     * @returns The message data
+     */
+    fetchMessage(channelId: string, messageId: string): Promise<Message<false>>;
+    /**
+     * Fetch a webhook from the Discord API
+     * @param input The webhook data, ID and token, or webhook URL
+     * @returns The webhook data
+     */
+    fetchWebhook(input: WebhookInput): Promise<Webhook<false>>;
+    getDiscordCommands(force?: boolean): Promise<APIApplicationCommand[]>;
+    private updateCommandIdsFromDeployment;
+}
+/**
+ * @hidden
+ */
+export interface ExecutionContext {
+    waitUntil(promise: Promise<any>): void;
+}
+//# sourceMappingURL=Client.d.ts.map

package/dist/src/classes/Client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Client.d.ts","sourceRoot":"","sources":["../../../src/classes/Client.ts"],"names":[],"mappings":"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"}

package/dist/src/classes/Client.js

@@ -0,0 +1,419 @@
+import { ApplicationWebhookType, InteractionResponseType, InteractionType, Routes } from "discord-api-types/v10";
+import { channelFactory } from "../functions/channelFactory.js";
+import { CommandHandler } from "../internals/CommandHandler.js";
+import { ComponentHandler } from "../internals/ComponentHandler.js";
+import { EmojiHandler } from "../internals/EmojiHandler.js";
+import { EventHandler } from "../internals/EventHandler.js";
+import { ModalHandler } from "../internals/ModalHandler.js";
+import { TemporaryListenerManager } from "../internals/TemporaryListenerManager.js";
+import { Guild } from "../structures/Guild.js";
+import { GuildMember } from "../structures/GuildMember.js";
+import { Message } from "../structures/Message.js";
+import { Role } from "../structures/Role.js";
+import { User } from "../structures/User.js";
+import { Webhook } from "../structures/Webhook.js";
+import { concatUint8Arrays, subtleCrypto, valueToUint8Array } from "../utils/index.js";
+import { RequestClient } from "./RequestClient.js";
+/**
+ * The main client used to interact with Discord
+ */
+export class Client {
+    /**
+     * The routes that the client will handle
+     */
+    routes = [];
+    /**
+     * The plugins that the client has registered
+     */
+    plugins = [];
+    /**
+     * The options used to initialize the client
+     */
+    options;
+    /**
+     * The commands that the client has registered
+     */
+    commands;
+    /**
+     * The event listeners that the client has registered
+     */
+    listeners = [];
+    /**
+     * The rest client used to interact with the Discord API
+     */
+    rest;
+    /**
+     * The handler for the component interactions sent from Discord
+     * @internal
+     */
+    componentHandler;
+    /**
+     * The handler for the modal interactions sent from Discord
+     * @internal
+     */
+    commandHandler;
+    /**
+     * The handler for the modal interactions sent from Discord
+     * @internal
+     */
+    modalHandler;
+    /**
+     * The handler for events sent from Discord
+     * @internal
+     */
+    eventHandler;
+    /**
+     * The manager for temporary event listeners with automatic cleanup
+     */
+    temporaryListeners;
+    /**
+     * The handler for application emojis for this application
+     */
+    emoji;
+    cachedGlobalCommands = null;
+    /**
+     * The ID of the shard this client is running on, if sharding is enabled
+     */
+    shardId;
+    /**
+     * The total number of shards, if sharding is enabled
+     */
+    totalShards;
+    /**
+     * Creates a new client
+     * @param options The options used to initialize the client
+     * @param handlers The handlers that the client has registered
+     * @param plugins The plugins that the client should use
+     */
+    constructor(options, handlers, plugins = []) {
+        if (!options.clientId)
+            throw new Error("Missing client ID");
+        if (!options.publicKey)
+            throw new Error("Missing public key");
+        if (!options.token)
+            throw new Error("Missing token");
+        if (!options.deploySecret && !options.disableDeployRoute)
+            throw new Error("Missing deploy secret");
+        this.options = options;
+        this.commands = handlers.commands ?? [];
+        this.listeners = handlers.listeners ?? [];
+        // Remove trailing slashes from the base URL
+        options.baseUrl = options.baseUrl.replace(/\/+$/, "");
+        this.commandHandler = new CommandHandler(this);
+        this.componentHandler = new ComponentHandler(this);
+        this.modalHandler = new ModalHandler(this);
+        this.eventHandler = new EventHandler(this);
+        this.temporaryListeners = new TemporaryListenerManager(this);
+        this.emoji = new EmojiHandler(this);
+        for (const component of handlers.components ?? []) {
+            this.componentHandler.registerComponent(component);
+        }
+        for (const command of this.commands) {
+            for (const component of command.components ?? []) {
+                this.componentHandler.registerComponent(component);
+            }
+        }
+        for (const modal of handlers.modals ?? []) {
+            this.modalHandler.registerModal(modal);
+        }
+        this.rest = new RequestClient(options.token, options.requestOptions);
+        this.appendRoutes();
+        for (const plugin of plugins) {
+            plugin.registerClient?.(this);
+            plugin.registerRoutes?.(this);
+            this.plugins.push({ id: plugin.id, plugin });
+        }
+        if (options.autoDeploy) {
+            this.handleDeployRequest();
+        }
+    }
+    getPlugin(id) {
+        return this.plugins.find((p) => p.id === id)?.plugin;
+    }
+    appendRoutes() {
+        this.routes.push({
+            method: "GET",
+            path: "/deploy",
+            handler: this.handleDeployRequest.bind(this),
+            protected: true,
+            disabled: this.options.disableDeployRoute
+        });
+        this.routes.push({
+            method: "POST",
+            path: "/interactions",
+            handler: this.handleInteractionsRequest.bind(this),
+            disabled: this.options.disableInteractionsRoute
+        });
+        this.routes.push({
+            method: "POST",
+            path: "/events",
+            handler: this.handleEventsRequest.bind(this),
+            disabled: this.options.disableEventsRoute
+        });
+    }
+    /**
+     * Handle a request to deploy the commands to Discord
+     * @returns A response
+     */
+    async handleDeployRequest() {
+        const commands = this.commands.filter((c) => c.name !== "*");
+        const globalCommands = commands.filter((c) => !c.guildIds);
+        const guildCommandsMap = {};
+        for (const command of commands) {
+            if (command.guildIds) {
+                for (const guildId of command.guildIds) {
+                    if (!guildCommandsMap[guildId])
+                        guildCommandsMap[guildId] = [];
+                    guildCommandsMap[guildId].push(command.serialize());
+                }
+            }
+        }
+        // If devGuilds is set, deploy all commands to those guilds (for development)
+        if (this.options.devGuilds && this.options.devGuilds.length > 0) {
+            for (const guildId of this.options.devGuilds) {
+                const deployed = (await this.rest.put(Routes.applicationGuildCommands(this.options.clientId, guildId), { body: commands.map((c) => c.serialize()) }));
+                this.updateCommandIdsFromDeployment(deployed);
+            }
+            return new Response("OK (devGuilds)", { status: 202 });
+        }
+        // Deploy guild-specific commands
+        for (const [guildId, cmds] of Object.entries(guildCommandsMap)) {
+            const deployed = (await this.rest.put(Routes.applicationGuildCommands(this.options.clientId, guildId), { body: cmds }));
+            this.updateCommandIdsFromDeployment(deployed);
+        }
+        // Deploy global commands
+        if (globalCommands.length > 0) {
+            const deployed = (await this.rest.put(Routes.applicationCommands(this.options.clientId), {
+                body: globalCommands.map((c) => c.serialize())
+            }));
+            this.updateCommandIdsFromDeployment(deployed);
+            this.cachedGlobalCommands = deployed;
+        }
+        return new Response("OK", { status: 202 });
+    }
+    /**
+     * Handle an interaction request from Discord
+     * @param req The request to handle
+     * @returns A response
+     */
+    async handleEventsRequest(req) {
+        const isValid = await this.validateDiscordRequest(req);
+        if (!isValid)
+            return new Response("Unauthorized", { status: 401 });
+        const payload = (await req.json());
+        if (payload.type === ApplicationWebhookType.Ping)
+            return new Response(null, { status: 204 });
+        const enqueued = this.eventHandler.handleEvent({ ...payload.event.data, clientId: this.options.clientId }, payload.event.type);
+        if (!enqueued) {
+            return new Response("Event queue full, retry later", { status: 429 });
+        }
+        return new Response(null, { status: 204 });
+    }
+    /**
+     * Handle an interaction request from Discord
+     * @param req The request to handle
+     * @param ctx The context for the request
+     * @returns A response
+     */
+    async handleInteractionsRequest(req, ctx) {
+        const isValid = await this.validateDiscordRequest(req);
+        if (!isValid)
+            return new Response("Unauthorized", { status: 401 });
+        const interaction = (await req.json());
+        if (interaction.type === InteractionType.Ping) {
+            return Response.json({ type: InteractionResponseType.Pong });
+        }
+        await this.handleInteraction(interaction, ctx);
+        return new Response("OK", { status: 202 });
+    }
+    /**
+     * Handle an interaction request from Discord
+     * @param interaction The interaction to handle
+     * @param ctx The context for the request
+     * @returns A response
+     */
+    async handleInteraction(interaction, ctx) {
+        if (interaction.type === InteractionType.ApplicationCommand) {
+            const promise = this.commandHandler.handleCommandInteraction(interaction);
+            if (ctx?.waitUntil)
+                ctx.waitUntil(promise);
+            else
+                await promise;
+        }
+        if (interaction.type === InteractionType.ApplicationCommandAutocomplete) {
+            const promise = this.commandHandler.handleAutocompleteInteraction(interaction);
+            if (ctx?.waitUntil)
+                ctx.waitUntil(promise);
+            else
+                await promise;
+        }
+        if (interaction.type === InteractionType.MessageComponent) {
+            const promise = this.componentHandler.handleInteraction(interaction);
+            if (ctx?.waitUntil)
+                ctx.waitUntil(promise);
+            else
+                await promise;
+        }
+        if (interaction.type === InteractionType.ModalSubmit) {
+            const promise = this.modalHandler.handleInteraction(interaction);
+            if (ctx?.waitUntil)
+                ctx.waitUntil(promise);
+            else
+                await promise;
+        }
+    }
+    /**
+     * Validate a request from Discord
+     * @param req The request to validate
+     */
+    async validateDiscordRequest(req) {
+        const body = await req.clone().text();
+        const signature = req.headers.get("X-Signature-Ed25519");
+        const timestamp = req.headers.get("X-Signature-Timestamp");
+        if (!timestamp || !signature || req.method !== "POST" || !body)
+            return false;
+        try {
+            const timestampData = valueToUint8Array(timestamp);
+            const bodyData = valueToUint8Array(body);
+            const message = concatUint8Arrays(timestampData, bodyData);
+            // Convert single key to array for consistent handling
+            const publicKeys = Array.isArray(this.options.publicKey)
+                ? this.options.publicKey
+                : [this.options.publicKey];
+            // Try each public key until one works
+            for (const publicKey of publicKeys) {
+                try {
+                    const publicKeyBuffer = valueToUint8Array(publicKey, "hex");
+                    const signatureBuffer = valueToUint8Array(signature, "hex");
+                    // Create proper ArrayBuffer for Web Crypto API
+                    const publicKeyArrayBuffer = new ArrayBuffer(publicKeyBuffer.length);
+                    new Uint8Array(publicKeyArrayBuffer).set(publicKeyBuffer);
+                    const signatureArrayBuffer = new ArrayBuffer(signatureBuffer.length);
+                    new Uint8Array(signatureArrayBuffer).set(signatureBuffer);
+                    const messageArrayBuffer = new ArrayBuffer(message.length);
+                    new Uint8Array(messageArrayBuffer).set(message);
+                    const isValid = await subtleCrypto.verify({
+                        name: "ed25519"
+                    }, await subtleCrypto.importKey("raw", publicKeyArrayBuffer, {
+                        name: "ed25519",
+                        namedCurve: "ed25519"
+                    }, false, ["verify"]), signatureArrayBuffer, messageArrayBuffer);
+                    if (isValid)
+                        return true;
+                }
+                catch {
+                    // Skip to next key if this one fails
+                }
+            }
+            return false;
+        }
+        catch (_) {
+            return false;
+        }
+    }
+    /**
+     * Register an event listener with the client.
+     * This method provides type-safe listener registration without requiring
+     * manual type casting at the call site.
+     * @param listener The listener to register
+     */
+    registerListener(listener) {
+        this.listeners.push(listener);
+    }
+    // ======================== Begin Fetchers ================================================
+    /**
+     * Fetch a user from the Discord API
+     * @param id The ID of the user to fetch
+     * @returns The user data
+     */
+    async fetchUser(id) {
+        const user = (await this.rest.get(Routes.user(id)));
+        return new User(this, user);
+    }
+    /**
+     * Fetch a guild from the Discord API
+     * @param id The ID of the guild to fetch
+     * @returns The guild data
+     */
+    async fetchGuild(id) {
+        const guild = (await this.rest.get(Routes.guild(id)));
+        return new Guild(this, guild);
+    }
+    /**
+     * Fetch a channel from the Discord API
+     * @param id The ID of the channel to fetch
+     * @returns The channel data
+     */
+    async fetchChannel(id) {
+        const channel = (await this.rest.get(Routes.channel(id)));
+        return channelFactory(this, channel);
+    }
+    /**
+     * Fetch a role from the Discord API
+     * @param guildId The ID of the guild the role is in
+     * @param id The ID of the role to fetch
+     * @returns The role data
+     */
+    async fetchRole(guildId, id) {
+        const role = (await this.rest.get(Routes.guildRole(guildId, id)));
+        return new Role(this, role, guildId);
+    }
+    /**
+     * Fetch a member from the Discord API
+     * @param guildId The ID of the guild the member is in
+     * @param id The ID of the member to fetch
+     * @returns The member data
+     */
+    async fetchMember(guildId, id) {
+        const member = (await this.rest.get(Routes.guildMember(guildId, id)));
+        return new GuildMember(this, member, new Guild(this, guildId));
+    }
+    /**
+     * Fetch a message from the Discord API
+     * @param channelId The ID of the channel the message is in
+     * @param messageId The ID of the message to fetch
+     * @returns The message data
+     */
+    async fetchMessage(channelId, messageId) {
+        const message = (await this.rest.get(Routes.channelMessage(channelId, messageId)));
+        return new Message(this, message);
+    }
+    /**
+     * Fetch a webhook from the Discord API
+     * @param input The webhook data, ID and token, or webhook URL
+     * @returns The webhook data
+     */
+    async fetchWebhook(input) {
+        const webhook = new Webhook(input);
+        return webhook.fetch();
+    }
+    async getDiscordCommands(force = false) {
+        if (!force && this.cachedGlobalCommands) {
+            return this.cachedGlobalCommands;
+        }
+        const commands = (await this.rest.get(Routes.applicationCommands(this.options.clientId)));
+        this.cachedGlobalCommands = commands;
+        this.updateCommandIdsFromDeployment(commands);
+        return commands;
+    }
+    updateCommandIdsFromDeployment(commands) {
+        for (const deployed of commands) {
+            const match = this.commands.find((command) => {
+                if (command.name !== deployed.name)
+                    return false;
+                if (command.type !== deployed.type)
+                    return false;
+                if (deployed.guild_id) {
+                    if (!command.guildIds || command.guildIds.length === 0)
+                        return true;
+                    return command.guildIds.includes(deployed.guild_id);
+                }
+                return !command.guildIds || command.guildIds.length === 0;
+            });
+            if (match) {
+                match.id = deployed.id;
+            }
+        }
+    }
+}
+//# sourceMappingURL=Client.js.map