SDKs e exemplos

@nex/bot-sdk e o bot de exemplo.

O NEX tem um pacote Node.js para desenvolvedores, o @nex/bot-sdk. Ele ainda não está publicado no npm: está no repositório do NEX e é instalado por caminho local.

Nota
Não há (ainda) um cliente REST/Gateway completo: use fetch e socket.io-client como nos exemplos destas docs.

@nex/bot-sdk

Builders encadeáveis que geram exatamente o JSON aceito pela API para mensagens ricas e modais.

package.json
"dependencies": {
  "@nex/bot-sdk": "file:../bot-sdk"
}
ExportaPara
EmbedBuilderEmbeds
ButtonBuilder, ActionRowBuilderBotões e linhas
StringSelectMenuBuilder, UserSelectMenuBuilder, RoleSelectMenuBuilder, ChannelSelectMenuBuilderMenus de seleção
ContainerBuilder, SectionBuilder, TextDisplayBuilder, ThumbnailBuilder, MediaGalleryBuilder, FileBuilder, SeparatorBuilderComponents V2
ModalBuilderModais
ButtonStyle, MessageFlags, TextInputStyle, ComponentType, InteractionResponseType, InteractionKindConstantes
const { EmbedBuilder } = require('@nex/bot-sdk');

const embed = new EmbedBuilder()
  .setTitle('Status do servidor')
  .setDescription('Tudo **normal**.')
  .setColor(0x57f287)
  .addField('Uptime', '99,9%', true)
  .toJSON();

await fetch(`${API}/bot/servers/${serverId}/channels/${channelId}/messages`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${TOKEN}` },
  body: JSON.stringify({ embeds: [embed] }),
});

Cliente de voz

O cliente de voz (@nexapponline/voice-client, licença MIT) coloca o bot em canais de voz e transmite áudio de arquivos ou URLs http(s). Precisa de Node.js 18+ e ffmpeg. Detalhes de permissões, eventos e privacidade na página Voz.

Instalação
npm install @nexapponline/voice-client

Bot de exemplo

Em examples/ping-bot/ no repositório: responde !ping, registra slash commands e demonstra embeds, painel de música com botões, menu de seleção, modal e Components V2 (/status, /nowplaying, /loopmenu, /feedback, /showcase), além de tocar música em voz com /play (essa parte usa o @nexapponline/voice-client).