novaapp-sdk 1.0.10 → 1.1.0

package/dist/index.d.mts

@@ -80,25 +80,35 @@ interface EmbedField {
 interface Embed {
     title?: string;
     description?: string;
+    /** Makes the title a clickable link. */
     url?: string;
-    color?: number;
+    /** Hex colour string — e.g. `'#5865F2'`. */
+    color?: string;
     thumbnail?: string;
     image?: string;
     footer?: string;
     fields?: EmbedField[];
     timestamp?: string;
+    author?: {
+        name: string;
+        iconUrl?: string;
+    };
 }
 interface MessageComponent {
     type: 'button' | 'select';
-    customId: string;
+    customId?: string;
     label?: string;
-    style?: 'primary' | 'secondary' | 'success' | 'danger';
+    style?: 'primary' | 'secondary' | 'success' | 'danger' | 'link';
+    emoji?: string;
+    url?: string;
     placeholder?: string;
     options?: Array<{
         label: string;
         value: string;
         description?: string;
     }>;
+    minValues?: number;
+    maxValues?: number;
     disabled?: boolean;
 }
 interface Message {
@@ -306,41 +316,10 @@ interface NovaClientOptions {
     token: string;
     /**
      * Base URL of the Nova server.
-     * @default "https://api.nova.chat"
+     * @default "https://novachatapp.com"
      */
     baseUrl?: string;
 }
-interface NovaClientEvents {
-    /** Fired when the bot successfully connects and is identified. */
-    ready: (bot: BotApplication) => void;
-    /** Fired for every bot:event from the gateway. */
-    event: (event: BotEvent) => void;
-    /** Fired when an interaction is created (slash command, button, etc.). */
-    interactionCreate: (interaction: Interaction) => void;
-    /** Fired when the gateway connection is lost. */
-    disconnect: (reason: string) => void;
-    /** Fired on gateway/API errors. */
-    error: (err: {
-        code: number;
-        message: string;
-    }) => void;
-    /** A message was sent in a channel the bot is in. */
-    messageCreate: (data: BotEvent['data']) => void;
-    /** A message was edited. */
-    messageUpdate: (data: BotEvent['data']) => void;
-    /** A message was deleted. */
-    messageDelete: (data: BotEvent['data']) => void;
-    /** A reaction was added to a message. */
-    reactionAdd: (data: BotEvent['data']) => void;
-    /** A reaction was removed from a message. */
-    reactionRemove: (data: BotEvent['data']) => void;
-    /** A user joined a server the bot is in. */
-    memberAdd: (data: BotEvent['data']) => void;
-    /** A user left a server the bot is in. */
-    memberRemove: (data: BotEvent['data']) => void;
-    /** A user started typing. */
-    typingStart: (data: BotEvent['data']) => void;
-}
 
 declare class MessagesAPI {
     private readonly http;
@@ -619,6 +598,321 @@ declare class PermissionsAPI {
     get(options: PermissionsQueryOptions): Promise<PermissionsResult>;
 }
 
+type TextInputStyle = 'short' | 'paragraph';
+/**
+ * Fluent builder for a single text-input field inside a modal.
+ *
+ * @example
+ * new TextInputBuilder()
+ *   .setCustomId('reason')
+ *   .setLabel('Reason')
+ *   .setStyle('paragraph')
+ *   .setPlaceholder('Describe the issue in detail…')
+ *   .setRequired(true)
+ *   .setMaxLength(1000)
+ */
+declare class TextInputBuilder {
+    private _data;
+    /** Unique ID for this field — the key in `interaction.modalData` on submit. */
+    setCustomId(customId: string): this;
+    /** Label shown above the input inside the modal. */
+    setLabel(label: string): this;
+    /**
+     * Input style:
+     * - `'short'` — single-line text input
+     * - `'paragraph'` — multi-line textarea
+     */
+    setStyle(style: TextInputStyle): this;
+    /** Greyed-out hint text shown when the field is empty. */
+    setPlaceholder(placeholder: string): this;
+    /** Whether the user must fill in this field before submitting. */
+    setRequired(required?: boolean): this;
+    /** Minimum number of characters required. */
+    setMinLength(min: number): this;
+    /** Maximum number of characters allowed. */
+    setMaxLength(max: number): this;
+    /** Pre-filled default value. */
+    setValue(value: string): this;
+    toJSON(): BotModalField;
+}
+
+type FieldLike = TextInputBuilder | BotModalField;
+/**
+ * Fluent builder for bot modal dialogs.
+ *
+ * @example
+ * const modal = new ModalBuilder()
+ *   .setTitle('Submit a report')
+ *   .setCustomId('report_modal')
+ *   .addField(
+ *     new TextInputBuilder()
+ *       .setCustomId('reason')
+ *       .setLabel('Reason')
+ *       .setStyle('paragraph')
+ *       .setRequired(true)
+ *       .setMaxLength(1000)
+ *   )
+ *   .addField(
+ *     new TextInputBuilder()
+ *       .setCustomId('proof')
+ *       .setLabel('Evidence (optional URL)')
+ *       .setStyle('short')
+ *   )
+ *
+ * const submitted = await interaction.openModal(modal)
+ * if (submitted) {
+ *   const reason = submitted.modalData.reason
+ * }
+ */
+declare class ModalBuilder {
+    private _title;
+    private _customId;
+    private readonly _fields;
+    /** Title shown at the top of the modal dialog. */
+    setTitle(title: string): this;
+    /** Custom ID passed back with the `MODAL_SUBMIT` interaction. */
+    setCustomId(customId: string): this;
+    /** Add a single text-input field. */
+    addField(field: FieldLike): this;
+    /** Add multiple fields at once. */
+    addFields(...fields: FieldLike[]): this;
+    toJSON(): BotModalDefinition;
+}
+
+/**
+ * Typed accessor for slash- and prefix-command options.
+ * Available via `interaction.options`.
+ *
+ * @example
+ * client.command('ban', async (interaction) => {
+ *   const userId = interaction.options.getString('user', true)
+ *   const reason = interaction.options.getString('reason') ?? 'No reason given'
+ * })
+ */
+declare class InteractionOptions {
+    private readonly _map;
+    constructor(data: unknown);
+    /** Whether this option was supplied by the user. */
+    has(name: string): boolean;
+    /** @overload Required — never returns `null`. */
+    getString(name: string, required: true): string;
+    /** @overload Optional — returns `null` when not supplied. */
+    getString(name: string, required?: false): string | null;
+    /** @overload Required — never returns `null`. */
+    getInteger(name: string, required: true): number;
+    /** @overload Optional — returns `null` when not supplied. */
+    getInteger(name: string, required?: false): number | null;
+    /** @overload Required — never returns `null`. */
+    getNumber(name: string, required: true): number;
+    /** @overload Optional — returns `null` when not supplied. */
+    getNumber(name: string, required?: false): number | null;
+    /** Returns `true` or `false`, or `null` if not supplied. */
+    getBoolean(name: string): boolean | null;
+    /**
+     * Returns the mentioned **user ID** string (type `USER` option).
+     * @overload Required.
+     */
+    getUser(name: string, required: true): string;
+    getUser(name: string, required?: false): string | null;
+    /**
+     * Returns the mentioned **channel ID** string (type `CHANNEL` option).
+     * @overload Required.
+     */
+    getChannel(name: string, required: true): string;
+    getChannel(name: string, required?: false): string | null;
+    /**
+     * Returns the mentioned **role ID** string (type `ROLE` option).
+     * @overload Required.
+     */
+    getRole(name: string, required: true): string;
+    getRole(name: string, required?: false): string | null;
+}
+/**
+ * Rich wrapper around a raw bot interaction.
+ * Returned by `interactionCreate`, `client.command()`, `client.button()`, `client.selectMenu()`.
+ *
+ * @example
+ * client.on('interactionCreate', async (interaction) => {
+ *   if (interaction.isSlashCommand() && interaction.commandName === 'ping') {
+ *     await interaction.reply('Pong! 🏓')
+ *   }
+ * })
+ *
+ * // Or use built-in routing:
+ * client.command('ping', async (interaction) => {
+ *   await interaction.reply('Pong! 🏓')
+ * })
+ */
+declare class NovaInteraction {
+    private readonly _raw;
+    private readonly _api;
+    /** Unique interaction ID. */
+    readonly id: string;
+    /** Interaction type. Use type guards (`.isSlashCommand()` etc.) for narrowing. */
+    readonly type: InteractionType;
+    /** Command name — set for `SLASH_COMMAND` and `PREFIX_COMMAND` interactions. */
+    readonly commandName: string | null;
+    /** Component custom ID — set for `BUTTON_CLICK`, `SELECT_MENU`, and `MODAL_SUBMIT` interactions. */
+    readonly customId: string | null;
+    /** ID of the user who triggered this interaction. */
+    readonly userId: string;
+    /** ID of the channel where this interaction occurred. */
+    readonly channelId: string;
+    /** ID of the server where this interaction occurred (`null` in DMs). */
+    readonly serverId: string | null;
+    /** ID of the message that contained the button/select component (if any). */
+    readonly triggerMsgId: string | null;
+    /** Selected option values for `SELECT_MENU` interactions. */
+    readonly values: string[];
+    /**
+     * Field values submitted in a `MODAL_SUBMIT` interaction.
+     * Keys are the `customId`s of the `TextInputBuilder` fields.
+     *
+     * @example
+     * const reason = interaction.modalData.reason
+     */
+    readonly modalData: Record<string, string>;
+    /** ISO timestamp of when the interaction was created. */
+    readonly createdAt: string;
+    /**
+     * Typed accessor for slash/prefix command options.
+     *
+     * @example
+     * const userId = interaction.options.getUser('user', true)
+     * const reason = interaction.options.getString('reason') ?? 'No reason given'
+     */
+    readonly options: InteractionOptions;
+    constructor(_raw: Interaction, _api: InteractionsAPI);
+    /** `true` when triggered by a `/slash` command. */
+    isSlashCommand(): boolean;
+    /** `true` when triggered by a `!prefix` command. */
+    isPrefixCommand(): boolean;
+    /** `true` for both slash and prefix commands. */
+    isCommand(): boolean;
+    /** `true` when a button component was clicked. */
+    isButton(): boolean;
+    /** `true` when a select-menu option was chosen. */
+    isSelectMenu(): boolean;
+    /** `true` when the user submitted a modal form. */
+    isModalSubmit(): boolean;
+    /** `true` during autocomplete suggestion requests. */
+    isAutocomplete(): boolean;
+    /** `true` when triggered via a context-menu command. */
+    isContextMenu(): boolean;
+    /**
+     * Respond with a message.
+     * Accepts a plain string or a full options object.
+     *
+     * @example
+     * await interaction.reply('Pong! 🏓')
+     * await interaction.reply({ content: 'Done!', ephemeral: true })
+     * await interaction.reply({ embed: new EmbedBuilder().setTitle('Stats').toJSON() })
+     */
+    reply(options: RespondInteractionOptions | string): Promise<Message | {
+        ok: true;
+        ephemeral: true;
+    }>;
+    /**
+     * Respond with a message **only visible to the user** who triggered the interaction.
+     *
+     * @example
+     * await interaction.replyEphemeral('Only you can see this!')
+     */
+    replyEphemeral(options: string | Omit<RespondInteractionOptions, 'ephemeral'>): Promise<{
+        ok: true;
+        ephemeral: true;
+    }>;
+    /**
+     * Acknowledge the interaction without sending a response yet.
+     * Shows a loading indicator to the user.
+     * Follow up with `interaction.editReply()` when you're done.
+     *
+     * @example
+     * await interaction.defer()
+     * const data = await fetchSomeSlow()
+     * await interaction.editReply({ content: `Result: ${data}` })
+     */
+    defer(): Promise<{
+        ok: true;
+    }>;
+    /**
+     * Edit the previous reply (e.g. after `defer()`).
+     *
+     * @example
+     * await interaction.defer()
+     * await interaction.editReply(`Done — processed ${count} items.`)
+     */
+    editReply(options: RespondInteractionOptions | string): Promise<Message | {
+        ok: true;
+        ephemeral: true;
+    }>;
+    /**
+     * Open a **modal dialog** and return the user's submission as a new `NovaInteraction`.
+     * Returns `null` if the user closes the modal or the timeout expires (default: 5 min).
+     *
+     * **This is the recommended way to open modals.**
+     *
+     * @example
+     * const submitted = await interaction.openModal(
+     *   new ModalBuilder()
+     *     .setTitle('Submit a report')
+     *     .setCustomId('report_modal')
+     *     .addField(
+     *       new TextInputBuilder()
+     *         .setCustomId('reason')
+     *         .setLabel('Reason')
+     *         .setStyle('paragraph')
+     *         .setRequired(true)
+     *     )
+     * )
+     *
+     * if (!submitted) return // user dismissed or timed out
+     *
+     * const reason = submitted.modalData.reason
+     * await submitted.replyEphemeral(`Report received: ${reason}`)
+     */
+    openModal(modal: ModalBuilder | BotModalDefinition, options?: {
+        timeout?: number;
+    }): Promise<NovaInteraction | null>;
+    /** Returns the raw interaction data from the gateway. */
+    toJSON(): Interaction;
+}
+
+interface NovaClientEvents {
+    /** Fired when the bot connects and is identified by the gateway. */
+    ready: (bot: BotApplication) => void;
+    /** Fired for every raw `bot:event` from the gateway. */
+    event: (event: BotEvent) => void;
+    /**
+     * Fired when an interaction is received (slash command, button click, etc.).
+     * Use `client.command()`, `client.button()`, or `client.selectMenu()` for
+     * convenient routing instead of handling everything here.
+     */
+    interactionCreate: (interaction: NovaInteraction) => void;
+    /** Fired when the WebSocket connection drops. */
+    disconnect: (reason: string) => void;
+    /** Fired on gateway / API errors. */
+    error: (err: Error | {
+        code: number;
+        message: string;
+    }) => void;
+    /** A new message was sent in a channel the bot can see. */
+    messageCreate: (data: BotEvent['data']) => void;
+    /** A message was edited. */
+    messageUpdate: (data: BotEvent['data']) => void;
+    /** A message was deleted. */
+    messageDelete: (data: BotEvent['data']) => void;
+    /** A reaction was added. */
+    reactionAdd: (data: BotEvent['data']) => void;
+    /** A reaction was removed. */
+    reactionRemove: (data: BotEvent['data']) => void;
+    /** A member joined a server the bot is in. */
+    memberAdd: (data: BotEvent['data']) => void;
+    /** A member left a server the bot is in. */
+    memberRemove: (data: BotEvent['data']) => void;
+    /** A user started typing. */
+    typingStart: (data: BotEvent['data']) => void;
+}
 /**
  * The main Nova bot client.
  *
@@ -657,7 +951,39 @@ declare class NovaClient extends EventEmitter {
     private socket;
     private readonly http;
     private readonly options;
+    private readonly _commandHandlers;
+    private readonly _buttonHandlers;
+    private readonly _selectHandlers;
     constructor(options: NovaClientOptions);
+    /**
+     * Register a handler for a slash or prefix command by name.
+     * Automatically routes `interactionCreate` events whose `commandName` matches.
+     *
+     * @example
+     * client.command('ping', async (interaction) => {
+     *   await interaction.reply('Pong! 🏓')
+     * })
+     */
+    command(name: string, handler: (interaction: NovaInteraction) => unknown): this;
+    /**
+     * Register a handler for a button by its `customId`.
+     *
+     * @example
+     * client.button('confirm_delete', async (interaction) => {
+     *   await interaction.replyEphemeral('Deleted.')
+     * })
+     */
+    button(customId: string, handler: (interaction: NovaInteraction) => unknown): this;
+    /**
+     * Register a handler for a select menu by its `customId`.
+     *
+     * @example
+     * client.selectMenu('colour_pick', async (interaction) => {
+     *   const chosen = interaction.values[0]
+     *   await interaction.reply(`You picked: ${chosen}`)
+     * })
+     */
+    selectMenu(customId: string, handler: (interaction: NovaInteraction) => unknown): this;
     /**
      * Connect to the Nova WebSocket gateway.
      * Resolves when the `ready` event is received.
@@ -696,4 +1022,243 @@ declare class NovaClient extends EventEmitter {
     emit(event: string | symbol, ...args: unknown[]): boolean;
 }
 
-export { type Attachment, type BotApplication, type BotEvent, type BotEventType, type BotModalDefinition, type BotModalField, type BotPermissionRecord, type BotUser, CommandsAPI, type ContextCommandDefinition, type EditMessageOptions, type Embed, type EmbedField, type FetchMembersOptions, type FetchMessagesOptions, HttpClient, type Interaction, type InteractionType, InteractionsAPI, type Member, MembersAPI, type Message, type MessageComponent, MessagesAPI, NovaClient, type NovaClientEvents, type NovaClientOptions, type NovaServer, PermissionsAPI, type PermissionsQueryOptions, type PermissionsResult, type PollInteractionsOptions, type PrefixCommandDefinition, type Reaction, type RegisteredContextCommand, type RegisteredPrefixCommand, type RegisteredSlashCommand, type RespondInteractionOptions, type SendMessageOptions, ServersAPI, type SlashCommandDefinition, type SlashCommandOption };
+/**
+ * Fluent builder for bot message embeds.
+ *
+ * @example
+ * const embed = new EmbedBuilder()
+ *   .setTitle('Server Stats')
+ *   .setDescription('Here are the latest numbers.')
+ *   .setColor('#5865F2')
+ *   .addField('Members', '1 234', true)
+ *   .addField('Messages today', '567', true)
+ *   .setFooter('Nova Bot')
+ *   .setTimestamp()
+ *
+ * await client.messages.send(channelId, { embed })
+ */
+declare class EmbedBuilder {
+    private readonly _data;
+    /** Set the embed title (shown in bold at the top). */
+    setTitle(title: string): this;
+    /** Set the main description text (supports markdown). */
+    setDescription(description: string): this;
+    /**
+     * Set the accent colour.
+     * @param color Hex string — e.g. `'#5865F2'` or `'5865F2'`
+     */
+    setColor(color: string): this;
+    /** Make the title a clickable hyperlink. */
+    setUrl(url: string): this;
+    /** Small image shown in the top-right corner. */
+    setThumbnail(url: string): this;
+    /** Large image shown below the fields. */
+    setImage(url: string): this;
+    /** Footer text shown at the very bottom of the embed. */
+    setFooter(text: string): this;
+    /**
+     * Add a timestamp to the footer line.
+     * @param date Defaults to `new Date()`.
+     */
+    setTimestamp(date?: Date | number): this;
+    /** Author name + optional icon shown above the title. */
+    setAuthor(author: {
+        name: string;
+        iconUrl?: string;
+    }): this;
+    /**
+     * Add a single field.
+     * @param inline Pass `true` to render this field side-by-side with adjacent inline fields.
+     */
+    addField(name: string, value: string, inline?: boolean): this;
+    /** Add multiple fields at once. */
+    addFields(...fields: EmbedField[]): this;
+    /** Replace all fields. */
+    setFields(fields: EmbedField[]): this;
+    /** Serialise to a plain `Embed` object you can pass to any API call. */
+    toJSON(): Embed;
+}
+
+type ButtonStyle = 'primary' | 'secondary' | 'success' | 'danger' | 'link';
+/**
+ * Fluent builder for button components.
+ *
+ * @example
+ * const row = new ActionRowBuilder()
+ *   .addButton(
+ *     new ButtonBuilder()
+ *       .setCustomId('confirm')
+ *       .setLabel('Confirm')
+ *       .setStyle('success')
+ *   )
+ *   .addButton(
+ *     new ButtonBuilder()
+ *       .setCustomId('cancel')
+ *       .setLabel('Cancel')
+ *       .setStyle('danger')
+ *   )
+ *
+ * await client.messages.send(channelId, { content: 'Are you sure?', components: row.toJSON() })
+ */
+declare class ButtonBuilder {
+    private _customId;
+    private _label;
+    private _style;
+    private _disabled;
+    private _emoji?;
+    private _url?;
+    /** Custom ID returned in the `BUTTON_CLICK` interaction. Not required for `link` style buttons. */
+    setCustomId(customId: string): this;
+    /** Text displayed on the button. */
+    setLabel(label: string): this;
+    /**
+     * Visual style:
+     * - `primary` — blurple / brand colour
+     * - `secondary` — grey
+     * - `success` — green
+     * - `danger` — red
+     * - `link` — grey, navigates to a URL instead of creating an interaction
+     */
+    setStyle(style: ButtonStyle): this;
+    /** Emoji shown to the left of the label (unicode or custom e.g. `'👋'`). */
+    setEmoji(emoji: string): this;
+    /**
+     * URL for `link` style buttons.
+     * Sets the style to `'link'` automatically.
+     */
+    setUrl(url: string): this;
+    /** Prevent users from clicking the button. */
+    setDisabled(disabled?: boolean): this;
+    toJSON(): MessageComponent;
+}
+
+interface SelectMenuOption {
+    /** Visible label shown to the user. */
+    label: string;
+    /** Value returned in the interaction's `values` array. */
+    value: string;
+    /** Optional description shown below the label. */
+    description?: string;
+}
+/**
+ * Fluent builder for select-menu (dropdown) components.
+ *
+ * @example
+ * const menu = new SelectMenuBuilder()
+ *   .setCustomId('colour_pick')
+ *   .setPlaceholder('Pick a colour…')
+ *   .addOption({ label: 'Red',   value: 'red' })
+ *   .addOption({ label: 'Green', value: 'green' })
+ *   .addOption({ label: 'Blue',  value: 'blue' })
+ *
+ * await client.messages.send(channelId, { content: 'Choose:', components: [menu.toJSON()] })
+ */
+declare class SelectMenuBuilder {
+    private _customId;
+    private _placeholder?;
+    private _disabled;
+    private readonly _options;
+    /** Custom ID returned in the `SELECT_MENU` interaction. */
+    setCustomId(customId: string): this;
+    /** Greyed-out hint shown when nothing is selected. */
+    setPlaceholder(placeholder: string): this;
+    /** Prevent users from interacting with the menu. */
+    setDisabled(disabled?: boolean): this;
+    /** Add a single option. */
+    addOption(option: SelectMenuOption): this;
+    /** Add multiple options at once. */
+    addOptions(...options: SelectMenuOption[]): this;
+    /** Replace all options. */
+    setOptions(options: SelectMenuOption[]): this;
+    toJSON(): MessageComponent;
+}
+
+type ComponentBuilder = ButtonBuilder | SelectMenuBuilder | {
+    toJSON(): MessageComponent;
+};
+/**
+ * Groups buttons (and/or a select menu) into a single row of components.
+ *
+ * @example
+ * const row = new ActionRowBuilder()
+ *   .addComponent(new ButtonBuilder().setCustomId('yes').setLabel('Yes').setStyle('success'))
+ *   .addComponent(new ButtonBuilder().setCustomId('no').setLabel('No').setStyle('danger'))
+ *
+ * await interaction.reply({ content: 'Confirm?', components: row.toJSON() })
+ */
+declare class ActionRowBuilder {
+    private readonly _components;
+    /** Add a single component (button or select menu). */
+    addComponent(component: ComponentBuilder): this;
+    /** Add multiple components at once. */
+    addComponents(...components: ComponentBuilder[]): this;
+    /**
+     * Serialise to a flat `MessageComponent[]` array — the format accepted by all API calls.
+     */
+    toJSON(): MessageComponent[];
+}
+
+/**
+ * Fluent builder for a single slash command option (parameter).
+ * Obtain one via the callback in `SlashCommandBuilder.addStringOption()` etc.
+ */
+declare class SlashCommandOptionBuilder {
+    private _data;
+    constructor(type: SlashCommandOption['type']);
+    /** Internal option name (lowercase, no spaces). Shown after `/command ` in the client UI. */
+    setName(name: string): this;
+    /** Short human-readable description shown in the command picker. */
+    setDescription(description: string): this;
+    /** Whether users must supply this option before sending the command. */
+    setRequired(required?: boolean): this;
+    /**
+     * Restrict the option to specific values.
+     * The picker will show these as autocomplete suggestions.
+     */
+    addChoice(name: string, value: string | number): this;
+    /** Set all allowed choices at once. */
+    setChoices(choices: Array<{
+        name: string;
+        value: string | number;
+    }>): this;
+    toJSON(): SlashCommandOption;
+}
+/**
+ * Fluent builder for slash commands.
+ *
+ * @example
+ * await client.commands.setSlash([
+ *   new SlashCommandBuilder()
+ *     .setName('ban')
+ *     .setDescription('Ban a member from this server')
+ *     .addUserOption((opt) =>
+ *       opt.setName('user').setDescription('Who to ban').setRequired(true)
+ *     )
+ *     .addStringOption((opt) =>
+ *       opt.setName('reason').setDescription('Reason for the ban')
+ *     )
+ *     .toJSON(),
+ * ])
+ */
+declare class SlashCommandBuilder {
+    private _data;
+    /** Command name — lowercase, no spaces (e.g. `'ban'`, `'server-info'`). */
+    setName(name: string): this;
+    /** Short description shown in the command picker UI. */
+    setDescription(description: string): this;
+    /** Add a text (string) option. */
+    addStringOption(fn: (opt: SlashCommandOptionBuilder) => SlashCommandOptionBuilder): this;
+    /** Add an integer (whole number) option. */
+    addIntegerOption(fn: (opt: SlashCommandOptionBuilder) => SlashCommandOptionBuilder): this;
+    /** Add a boolean (true/false) option. */
+    addBooleanOption(fn: (opt: SlashCommandOptionBuilder) => SlashCommandOptionBuilder): this;
+    /** Add a user-mention option (returns a user ID string). */
+    addUserOption(fn: (opt: SlashCommandOptionBuilder) => SlashCommandOptionBuilder): this;
+    /** Add a channel-mention option (returns a channel ID string). */
+    addChannelOption(fn: (opt: SlashCommandOptionBuilder) => SlashCommandOptionBuilder): this;
+    /** Add a role-mention option (returns a role ID string). */
+    addRoleOption(fn: (opt: SlashCommandOptionBuilder) => SlashCommandOptionBuilder): this;
+    toJSON(): SlashCommandDefinition;
+}
+
+export { ActionRowBuilder, type Attachment, type BotApplication, type BotEvent, type BotEventType, type BotModalDefinition, type BotModalField, type BotPermissionRecord, type BotUser, ButtonBuilder, type ButtonStyle, CommandsAPI, type ContextCommandDefinition, type EditMessageOptions, type Embed, EmbedBuilder, type EmbedField, type FetchMembersOptions, type FetchMessagesOptions, HttpClient, type Interaction, InteractionOptions, type InteractionType, InteractionsAPI, type Member, MembersAPI, type Message, type MessageComponent, MessagesAPI, ModalBuilder, NovaClient, type NovaClientEvents, type NovaClientOptions, NovaInteraction, type NovaServer, PermissionsAPI, type PermissionsQueryOptions, type PermissionsResult, type PollInteractionsOptions, type PrefixCommandDefinition, type Reaction, type RegisteredContextCommand, type RegisteredPrefixCommand, type RegisteredSlashCommand, type RespondInteractionOptions, SelectMenuBuilder, type SelectMenuOption, type SendMessageOptions, ServersAPI, SlashCommandBuilder, type SlashCommandDefinition, type SlashCommandOption, SlashCommandOptionBuilder, TextInputBuilder, type TextInputStyle };