Responders

O que são Responders?

A função createResponder é poderosa para lidar com diferentes tipos de interações do discord. Com ela podemos responder botões, menus de seleção e modais, ou todos ao mesmo tempo.

Para criar um Responder é preciso importar a função e o enum

import { createResponder } from "#base";
import { ResponderType } from "@constatic/base";

Veja um simples exemplo abaixo, vamos enviar um botão através de um comando e responder ele usando a função createResponder

import { createCommand } from "#base";
import { createComponents } from "@magicyan/discord";
import { ApplicationCommandType, ButtonBuilder, ButtonStyle } from "discord.js";

createCommand({
    name: "ping",
    description: "Comando de ping",
    dmPermission: false,
    type: ApplicationCommandType.ChatInput,
    async run(interaction){

        await interaction.reply({ 
            flags: ["Ephemeral", "IsComponentsV2"], 
            components: createComponents(
                new ButtonBuilder({
                    customId: "/ping/button",
                    label: "Ping", 
                    style: ButtonStyle.Success
                })
            ) 
        });
    }
});

import { createResponder } from "#base";
import { ResponderType } from "@constatic/base";

createResponder({
    customId: "/ping/button",
    types: [ResponderType.Button], cache: "cached",
    async run(interaction) {
        await interaction.reply({ 
            flags: ["Ephemeral", "IsComponentsV2"], 
            content: createComponents(
                "pong"
            ) 
        });
    },
});

Dessa forma estamos respondendo a um componente de botão fixo em uma mensagem onde o customId é /ping/button, então qualquer botão que nosso bot enviar que tiver esse customId, será respondido por essa função definida no run do nosso Responder.

Os Responders usam o evento interactionCreate, o que significa que mesmo que o bot reinicie, se alguém usar esse botão novamente, ele ainda será respondido com a função definida. O mesmo ocorre para menus de seleção e modais.

Podemos responder interações de tipos diferentes mas com o mesmo customId definindo mais tipos no array types:

createResponder({
    customId: "/form/register",
    types: [ 
        ResponderType.Button, 
        ResponderType.ModalComponent
    ], cache: "cached",
    async run(interaction) {
        if (interaction.isButton()){
            await interaction.showModal({
                //    ^ ButtonInteraction
                customId: interaction.customId,
                // ...
            })
            return;
        }
        const { fields } = interaction;
        //                      ^ ModalMessageModalSubmitInteraction

        // ...
    },
});

No exemplo acima temos um botão que abre um modal e no mesmo Responder pegamos os dados passados para o modal de mesmo customId. O type narrowing definido pelas chegagens com os type guards das interações, restringiu o tipo delas dentro dos blocos.

Confira todos os tipos de interações que os Respoders podem receber: