Examples

Các ví dụ chi tiết cho từng decorator và tính năng.

Danh sách ví dụ trong example bot

Module	File	Tính năng chính
Command	apps/mebot/src/bot/examples/example-command.handlers.ts	Ping/pong, đọc attachments/mentions, channel helper demo
Embed/Form	.../example-embed.handlers.ts	Embed, form input, quiz markdown, animated slots
Component	.../example-component.handlers.ts	Component pattern, @FormData, onClick, reaction
DM	.../example-dm.handlers.ts	DMHelper, ManagedMessage.sendDM
Event	.../example-event.handlers.ts	@On(VoiceJoined), TokenSend, voice events

Các template được copy đầy đủ khi bạn chạy create-mezon-bot.

---

@Command Examples

Basic Command

import { Command, AutoContext, SmartMessage } from '@n0xgg04/nezon';
import type { Nezon } from '@n0xgg04/nezon';

@Command('ping')
async onPing(@AutoContext() [managedMessage]: Nezon.AutoContext) {
  await managedMessage.reply(SmartMessage.text('pong!'));
}

Command với Arguments

@Command('greet')
async onGreet(
  @Args() args: Nezon.Args,
  @AutoContext() [managedMessage]: Nezon.AutoContext,
) {
  const name = args[0] ?? 'Anonymous';
  await managedMessage.reply(SmartMessage.text(`Hello, ${name}!`));
}

Command với Aliases

@Command({ name: 'help', aliases: ['h', '?'] })
async onHelp(@AutoContext() [managedMessage]: Nezon.AutoContext) {
  await managedMessage.reply(SmartMessage.text('Help message'));
}

Command đọc Attachments & Mentions

import {
  Command,
  Attachments,
  Mentions,
  AutoContext,
  SmartMessage,
} from '@n0xgg04/nezon';
import type { Nezon } from '@n0xgg04/nezon';

@Command('inspect')
async onInspect(
  @Attachments() files: Nezon.Attachments,
  @Attachments(0) firstFile: Nezon.Attachment | undefined,
  @Mentions() mentions: Nezon.Mentions,
  @Mentions(0) firstMention: Nezon.Mention | undefined,
  @AutoContext('message') managedMessage: Nezon.AutoContextType.Message,
) {
  const summary = [
    `Tổng số file: ${files.length}`,
    `File đầu tiên: ${firstFile?.filename ?? firstFile?.url ?? 'không có'}`,
    `Tổng số mention: ${mentions.length}`,
    `Mention đầu tiên: ${firstMention?.username ?? firstMention?.user_id ?? 'không có'}`,
  ].join('\n');
  await managedMessage.reply(SmartMessage.text(summary));
}

@Component Examples

Basic Component

import { Component, AutoContext, SmartMessage } from '@n0xgg04/nezon';
import type { Nezon } from '@n0xgg04/nezon';

@Component('click/confirm')
async onConfirm(@AutoContext() [managedMessage]: Nezon.AutoContext) {
  await managedMessage.reply(SmartMessage.text('Confirmed!'));
}

Component với Named Parameters

@Component({ pattern: '/user/:user_id/:action' })
async onUserAction(
  @ComponentParams('user_id') userId: string | undefined,
  @ComponentParams('action') action: string | undefined,
  @AutoContext() [managedMessage]: Nezon.AutoContext,
) {
  await message.reply(
    SmartMessage.text(`User ${userId}: ${action}`)
  );
}

onClick Examples

Basic onClick

import { Command, AutoContext, SmartMessage, ButtonBuilder, ButtonStyle } from '@n0xgg04/nezon';
import type { Nezon } from '@n0xgg04/nezon';

@Command('button')
async onButton(@AutoContext() [managedMessage]: Nezon.AutoContext) {
  await managedMessage.reply(
    SmartMessage.text('Click the button!')
      .addButton(
        new ButtonBuilder()
          .setLabel('Click Me')
          .setStyle(ButtonStyle.Primary)
          .onClick(async (context) => {
            await context.message.reply(SmartMessage.text('Clicked!'));
          })
      )
  );
}

onClick với Context

@Command('info')
async onInfo(@AutoContext() [managedMessage]: Nezon.AutoContext) {
  await managedMessage.reply(
    SmartMessage.text('Get info:')
      .addButton(
        new ButtonBuilder()
          .setLabel('Show Info')
          .setStyle(ButtonStyle.Info)
          .onClick(async ({ message, channel, user, clan }) => {
            const info = `
Channel: ${channel?.name ?? 'unknown'}
User: ${user?.username ?? 'unknown'}
Clan: ${clan?.name ?? 'unknown'}
            `.trim();
            await message.reply(SmartMessage.text(info));
          })
      )
  );
}

@On Examples

Channel Message Listener

import { On, ChannelMessagePayload, MessageContent } from '@n0xgg04/nezon';
import type { Nezon } from '@n0xgg04/nezon';

@On(Nezon.Events.ChannelMessage)
async onMessage(
  @ChannelMessagePayload() payload: Nezon.ChannelMessage,
  @MessageContent() content: string | undefined,
) {
  console.log('New message:', content);
}

Voice Joined Event với DM

import { On, EventPayload, AutoContext, SmartMessage } from '@n0xgg04/nezon';
import type { Nezon } from '@n0xgg04/nezon';

@On(Nezon.Events.VoiceJoinedEvent)
async onVoice(
  @EventPayload() event: Nezon.VoiceJoinedPayload,
  @AutoContext() [_, dm]: Nezon.AutoContext,
) {
  await dm.send(event.user_id, SmartMessage.text('Đã join'));
}

Token Send Event với DM

import { On, EventPayload, AutoContext, SmartMessage } from '@n0xgg04/nezon';
import type { Nezon } from '@n0xgg04/nezon';

@On(Nezon.Events.TokenSend)
async onTokenSend(
  @EventPayload() event: Nezon.TokenSendPayload,
  @AutoContext() [_, dm]: Nezon.AutoContext,
) {
  await dm.send(
    event.sender_id,
    SmartMessage.text(
      `Bạn đã gửi ${event.amount} token đến ${event.transaction_id}`,
    ),
  );
  this.logger.verbose(`token send received: ${event.amount}`);
}

DM Examples

Gửi DM với DMHelper

import { Command, AutoContext, SmartMessage, Args } from '@n0xgg04/nezon';
import type { Nezon } from '@n0xgg04/nezon';

@Command('dm')
async onDM(
  @Args() args: Nezon.Args,
  @AutoContext() [message, dm]: Nezon.AutoContext,
) {
  const userId = args[0];

  if (!userId) {
    await message.reply(SmartMessage.text('Sử dụng: *dm <user_id>'));
    return;
  }

  try {
    await dm.send(
      userId,
      SmartMessage.text('Đây là tin nhắn DM được gửi từ bot!'),
    );
    await message.reply(SmartMessage.text(`✅ Đã gửi DM đến ${userId}`));
  } catch (error) {
    await message.reply(
      SmartMessage.text(`❌ Lỗi: ${(error as Error).message}`),
    );
  }
}

Gửi DM tự động với sendDM()

@Command('senddm')
async onSendDM(@AutoContext() [managedMessage]: Nezon.AutoContext) {
  try {
    await managedMessage.sendDM(
      SmartMessage.text('Đây là tin nhắn DM được gửi tự động cho bạn!'),
    );
    await message.reply(SmartMessage.text('✅ Đã gửi DM cho bạn!'));
  } catch (error) {
    await message.reply(
      SmartMessage.text(`❌ Lỗi: ${(error as Error).message}`),
    );
  }
}

DM với Rich Content

@Command('dm-rich')
async onDMRich(
  @Args() args: Nezon.Args,
  @AutoContext() [message, dm]: Nezon.AutoContext,
) {
  const userId = args[0];

  await dm.send(
    userId,
    SmartMessage.text('DM với embed và button!')
      .addEmbed(
        new EmbedBuilder()
          .setTitle('Rich DM')
          .setDescription('Đây là DM với embed')
          .setColor('#00ff00'),
      )
      .addButton(
        new ButtonBuilder()
          .setLabel('Click Me')
          .setStyle(ButtonStyle.Primary)
          .onClick(async (context) => {
            await context.message.reply(SmartMessage.text('Button trong DM được click!'));
          }),
      ),
  );
}

Nezon.Events Examples

Sử dụng Nezon.Events thay vì import từ mezon-sdk

import { On, EventPayload } from '@n0xgg04/nezon';
import { Nezon } from '@n0xgg04/nezon';

@On(Nezon.Events.ChannelMessage)
async onMessage(@EventPayload() payload: Nezon.ChannelMessage) {
  console.log('New message:', payload.message_id);
}

@On(Nezon.Events.TokenSend)
async onTokenSend(@EventPayload() payload: Nezon.TokenSendPayload) {
  console.log('Token sent:', payload.amount);
}

Reaction Examples

Thêm reaction vào message

import { Command, AutoContext, SmartMessage } from '@n0xgg04/nezon';
import type { Nezon } from '@n0xgg04/nezon';

@Command('like')
async onLike(@AutoContext() [message]: Nezon.AutoContext) {
  await message.addReaction('👍');
  await message.reply(SmartMessage.text('Đã thêm like!'));
}

React vào message khác với getManagedMessage

import { Command, NezonUtils, AutoContext, SmartMessage, Args } from '@n0xgg04/nezon';
import type { Nezon } from '@n0xgg04/nezon';

@Command('react-message')
async onReactMessage(
  @NezonUtils() utils: Nezon.NezonUtilsService,
  @Args() args: Nezon.Args,
  @AutoContext() [message]: Nezon.AutoContext,
) {
  const messageId = args[0];
  if (!messageId) {
    await message.reply(SmartMessage.text('Sử dụng: *react-message <message_id>'));
    return;
  }

  const managedMsg = await utils.getManagedMessage(messageId, message.channelId);
  if (managedMsg) {
    await managedMsg.addReaction('👍');
    await managedMsg.addReaction('❤️');
    await message.reply(SmartMessage.text('✅ Đã thêm reactions!'));
  } else {
    await message.reply(SmartMessage.text('❌ Không tìm thấy message'));
  }
}

Toggle reaction

@Command('toggle-react')
async onToggleReact(@AutoContext() [message]: Nezon.AutoContext) {
  try {
    await message.react('👍', undefined, false);
    await message.reply(SmartMessage.text('Đã thêm reaction'));
  } catch (error) {
    await message.reply(SmartMessage.text('Lỗi khi thêm reaction'));
  }
}

Constructor Injection Examples

Inject MezonClient và NezonUtilsService

import { Injectable } from "@nestjs/common";
import {
  Command,
  MezonClient,
  NezonUtils,
  AutoContext,
  SmartMessage,
} from "@n0xgg04/nezon";
import type { Nezon } from "@n0xgg04/nezon";

@Injectable()
export class MyHandlers {
  constructor(
    @MezonClient() private readonly client: Nezon.Client,
    @NezonUtils() private readonly utils: Nezon.NezonUtilsService
  ) {}

  @Command("info")
  async onInfo(@AutoContext() [message]: Nezon.AutoContext) {
    const clan = await this.utils.getClan("clan-id");
    if (clan) {
      await message.reply(
        SmartMessage.text(
          `Clan: ${clan.name}\nBot: ${this.client.user?.username}`
        )
      );
    }
  }
}

SmartMessage Examples

Text với Buttons

@Command('menu')
async onMenu(@AutoContext() [managedMessage]: Nezon.AutoContext) {
  await managedMessage.reply(
    SmartMessage.text('Choose an option:')
      .addButton(new ButtonBuilder().setLabel('Option 1'))
      .addButton(new ButtonBuilder().setLabel('Option 2'))
  );
}

Embed với Form

@Command('poll')
async onPoll(@AutoContext() [managedMessage]: Nezon.AutoContext) {
  await managedMessage.reply(
    SmartMessage.build()
      .addEmbed(
        new EmbedBuilder()
          .setTitle('Create Poll')
          .addTextField('Title', 'title')
          .addSelectField('Type', 'type', [
            { label: 'Single', value: 'SINGLE' },
            { label: 'Multiple', value: 'MULTIPLE' },
          ])
      )
  );
}

Xem thêm các ví dụ chi tiết trong từng trang documentation.