NINENITYECOSYSTEM
Acesso rápidoComeçando com o CoreBase do Core↵O modelo mentalComeçando com o Core↵Estrutura do Template BotComeçando com o Core↵Configure o ClientComeçando com o Core↵Inicialize o runtimeComeçando com o Core↵Crie o primeiro móduloComeçando com o Core↵Variáveis de ambienteComeçando com o Core↵ComandosBase do Core↵
Documentação/Componentes
COMPONENTES / PROMPTS

Prompts

Crie confirmações reutilizáveis, páginas de resultado e instâncias isoladas que funcionam tanto em slash quanto em prefixo.

PromptregisterPromptpromptRequest

Definição e solicitação são separadas#

1

Defina uma vez

O módulo em Discord/Interactions monta o prompt e registra um ID estável.

2

Solicite quando precisar

Um comando chama interaction.promptRequest(id) para criar a instância.

3

O Core isola

Autor, guild e runtime são vinculados para impedir que outra pessoa controle o fluxo.

4

Resolva a escolha

O botão atualiza para sua página de resultado e executa o callback associado.

Prompt simples com opções automáticas#

Prompt.create() adiciona uma linha de botões com base nas opções informadas.

TSDiscord/Interactions/DeletePrompt.ts
import {  ButtonStyle,  ContainerBuilder,  MessageBuilder,  Prompt,  TextDisplayBuilder} from '@ninenity/componentbuilder'import Client from '../../Shared/Settings/Client'const prompt = Prompt.create({  id: 'delete-prompt',  prompt: new MessageBuilder()    .addComponents(      new ContainerBuilder()        .setAccentColor(0xff7582)        .addTextDisplayComponents(          new TextDisplayBuilder().setContent(            '## Excluir projeto?Esta ação não poderá ser desfeita.'          )        )    )    .template(),  options: [    { id: 'confirm', label: 'Excluir', style: ButtonStyle.Danger },    { id: 'cancel', label: 'Cancelar', style: ButtonStyle.Secondary }  ]})Client.registerPrompt('delete-prompt', prompt)

Sem páginas ou callbacks, uma opção apenas conclui o fluxo. Para executar uma regra e mostrar um resultado diferente, use páginas exportadas ou botões com callback como no próximo exemplo.

Prompt com páginas de resultado#

A primeira página contém os botões; páginas chamadas yes e no são escolhidas pelo sufixo do customId.

TSDiscord/Interactions/PublishPrompt.ts
const promptPage = new MessageBuilder()  .addComponents(    new ContainerBuilder()      .setAccentColor(0xffc14e)      .addTextDisplayComponents(        new TextDisplayBuilder().setContent('Deseja publicar esta versão?')      )      .addActionRowComponents(        new ActionRowBuilder<MessageActionRowComponentBuilder>().addComponents(          new ButtonBuilder()            .setStyle(ButtonStyle.Success)            .setLabel('Publicar')            .setCustomId('publish-prompt:yes')            .setCallback(async interaction => {              await publishVersion(interaction.guildId)              console.log('[Prompt] versão publicada')            }),          new ButtonBuilder()            .setStyle(ButtonStyle.Secondary)            .setLabel('Agora não')            .setCustomId('publish-prompt:no')        )      )  )  .template()const successPage = new MessageBuilder()  .addComponents(new ContainerBuilder().addTextDisplayComponents(    new TextDisplayBuilder().setContent('✓ Versão publicada com sucesso.')  ))  .template()const canceledPage = new MessageBuilder()  .addComponents(new ContainerBuilder().addTextDisplayComponents(    new TextDisplayBuilder().setContent('Publicação cancelada.')  ))  .template()Client.registerPrompt('publish-prompt', [  { id: 'prompt', name: 'prompt', template: promptPage },  { id: 'result-yes', name: 'yes', template: successPage },  { id: 'result-no', name: 'no', template: canceledPage }])

Solicitar no comando#

O mesmo ID registrado funciona em qualquer interação normalizada pelo Core.

TSDiscord/Commands/Publish.ts
Client.slash({  data: new SlashCommandBuilder()    .setName('publish')    .setDescription('Confirma a publicação.'),  execute: async interaction => {    await interaction.promptRequest('publish-prompt', {      ephemeral: true    })  }})Client.prefix({  data: new PrefixCommandBuilder()    .setName('publish')    .setAliases(['publicar']),  execute: async interaction => {    await interaction.promptRequest('publish-prompt', {      ephemeral: true    })  }})

Cada chamada cria uma instância com o autor e a guild da interação. O erro Prompt "id" is not registered indica que o módulo não foi carregado, o ID diverge ou o arquivo está fora das pastas percorridas.

Definição dinâmica por usuário#

Registre uma factory quando o texto ou as páginas dependem da interação que abriu o prompt.

TSprompt factory
Client.registerPrompt('remove-member', async context => {  const targetId = context.interaction.options?.getUser('usuario')?.id  const target = targetId ? await loadMember(targetId) : null  const page = new MessageBuilder()    .addComponents(      new ContainerBuilder().addTextDisplayComponents(        new TextDisplayBuilder().setContent(          'Remover **' + (target?.name ?? 'membro desconhecido') + '**?'        )      )    )    .template()  return Prompt.create({    id: 'remove-member',    prompt: page,    ownerId: context.ownerId,    guildId: context.guildId  })})