dressed/dist/types/config.d.ts

A sleek, serverless-ready Discord bot framework.

import type { ApplicationCommandType, InteractionContextType, PermissionFlagsBits, RESTPostAPIChatInputApplicationCommandsJSONBody, RESTPostAPIContextMenuApplicationCommandsJSONBody, RESTPostAPIPrimaryEntryPointApplicationCommandJSONBody, Snowflake } from "discord-api-types/v10";
import type { CallConfig } from "../utils/call-discord.ts";
import type { CommandHandler, ComponentHandler, EventHandler } from "./handlers.ts";
import type { AnyFn, Promisable } from "./utilities.ts";
/**
 * The configuration for the server.
 */
export interface ServerConfig {
    /** The endpoint to listen on
     * @default "/"
     */
    endpoint?: string;
    /** The port to listen on
     * @default 8000
     */
    port?: number;
    /** Build configuration */
    build?: {
        /** Source root for the bot
         * @default "src"
         */
        root?: string;
        /** File extensions to include when bundling handlers
         * @default ["js", "ts", "mjs"]
         */
        extensions?: string[];
    };
    /**
     * A layer before your individual handlers are executed.
     * The return values are the props passed to your handler.
     *
     * If you don't want to modify the handler's props, directly return the middleware's props.
     *
     * @example
     * {
     *   // Passthroughed props
     *   commands(...props) {
     *     console.log("Middleware!")
     *     return props
     *   },
     *   // Modified props
     *   components: (interaction, args) => [patchInteraction(interaction), args]
     * }
     */
    middleware?: {
        commands?: (...p: Parameters<CommandHandler>) => Promisable<unknown[]>;
        components?: (...p: Parameters<ComponentHandler>) => Promisable<unknown[]>;
        events?: (...p: Parameters<EventHandler>) => Promisable<unknown[]>;
    };
    /** Configuration for all API requests */
    requests?: CallConfig;
}
interface BaseCommandConfig {
    /** Type of the command, defaults to `ChatInput` */
    type?: keyof typeof ApplicationCommandType;
    /** Interaction context(s) where the command can be used, only for globally-scoped commands. Defaults to all */
    contexts?: (keyof typeof InteractionContextType)[];
    /** Where a command can be installed, also called its supported installation context. Defaults to both */
    integration_type?: "Guild" | "User";
    /** The guilds this command is available in, this prop will cause the command to become guild-scoped */
    guilds?: Snowflake[];
    /** An array of permissions */
    default_member_permissions?: (keyof typeof PermissionFlagsBits)[] | string;
}
type CommandTypeConfig<T, K extends PropertyKey, A> = Omit<T, keyof BaseCommandConfig | "name" | K> & A & BaseCommandConfig;
export type ChatInputConfig = CommandTypeConfig<RESTPostAPIChatInputApplicationCommandsJSONBody, 0, {
    type?: "ChatInput";
}>;
type ContextMenuConfig = CommandTypeConfig<RESTPostAPIContextMenuApplicationCommandsJSONBody, "options", {
    type: "Message" | "User";
}>;
type PrimaryEntryPointConfig = CommandTypeConfig<RESTPostAPIPrimaryEntryPointApplicationCommandJSONBody, "options", {
    type: "PrimaryEntryPoint";
}>;
/**
 * Configuration for a specific command.
 */
export type CommandConfig = ChatInputConfig | ContextMenuConfig | PrimaryEntryPointConfig;
export interface BaseData<T, M extends object = object> {
    name: string;
    path: string;
    uid: string;
    data: T;
    /** @deprecated Use the `default` key in `exports` instead */
    run?: AnyFn;
    exports: M & {
        default: AnyFn;
    };
}
/**
 * Command data object in the `commands` array outputted from `build()`
 */
export type CommandData = BaseData<{
    config?: CommandConfig;
}, {
    autocomplete?: AnyFn;
    config?: CommandConfig;
}>;
/**
 * Component data object in the `components` array outputted from `build()`
 */
export type ComponentData = BaseData<{
    regex: string;
    category: string;
    score: number;
}, {
    pattern?: string | RegExp;
}>;
/**
 * Event data object in the `events` array outputted from `build()`
 */
export type EventData = BaseData<{
    type: string;
}>;
export {};