@tryty/easydc-js 1.1.0 → 1.2.2

package/src/selftest.js

@@ -0,0 +1,215 @@
+'use strict';
+const { BotError } = require('./errors');
+const { parse } = require('./parser');
+const { Context } = require('./context');
+
+const PERM_RE = /missing (permissions|access)|50013|50001/i;
+const GROUP_TITLES = {
+  basic: 'Dasar (tanpa kirim apa pun)',
+  db: 'Database',
+  send: 'Kirim pesan ke Discord (embed, tombol, select, file, poll)',
+  full: 'Penuh (membuat lalu menghapus channel/role/thread sementara)',
+};
+
+/**
+ * Pasang command tes otomatis untuk dijalankan di Discord asli (khusus owner).
+ *   !selftest         -> tes aman: fungsi dasar, database, dan pengiriman pesan uji
+ *   !selftest full    -> ditambah tes yang membuat lalu menghapus channel & role sementara
+ * Dengan { ui: true } juga didaftarkan /tesauto (autocomplete) dan 2 menu klik-kanan untuk dicoba manual.
+ */
+function installSelfTest(bot, { name = 'selftest', aliases = [], ui = false } = {}) {
+  if (!bot.options.owners.length) throw new BotError('selfTestCommand butuh owners: ["ID_KAMU"] pada new Bot({...})');
+  bot.variables({ __selftest: 0 });
+
+  // Komponen yang dikirim saat tes: diklik manual untuk membuktikan handler tombol/select/modal
+  bot.button({ customId: 'selftest_btn', code: '$ephemeral ✅ Tombol berfungsi! Ditekan oleh $username' });
+  bot.button({ customId: 'selftest_modal', code: '$addModal[selftest_form;Tes Modal]$addTextInput[teks;Ketik apa saja;short;Halo]' });
+  bot.modal({ customId: 'selftest_form', code: '$ephemeral ✅ Modal berfungsi! Kamu mengetik: $modalValue[teks]' });
+  bot.select({ customId: 'selftest_sel', code: '$ephemeral ✅ Select menu berfungsi! Pilihanmu: $interactionValues' });
+  bot.select({ customId: 'selftest_usr', code: '$ephemeral ✅ Select user berfungsi! Terpilih: $interactionValues' });
+  if (ui) {
+    bot.slashCommand({
+      name: 'tesauto', description: 'Uji autocomplete',
+      options: [{ name: 'buah', description: 'Ketik untuk mencari', autocomplete: true }],
+      code: '$ephemeral ✅ Slash berfungsi! Kamu memilih: $option[buah]',
+    });
+    bot.autocomplete({ command: 'tesauto', option: 'buah', code: '$addChoice[Apel;apel]$addChoice[Jeruk;jeruk]$addChoice[Mangga;mangga]$addChoice[Anda mengetik: $focusedValue;ketikan]' });
+    bot.contextMenu({ name: 'Tes Profil', menu: 'user', code: '$ephemeral ✅ Menu user berfungsi! Sasaran: $targetName ($targetID)' });
+    bot.contextMenu({ name: 'Tes Pesan', menu: 'message', code: '$ephemeral ✅ Menu pesan berfungsi! Isi: $targetContent' });
+  }
+
+  bot.addFunction({
+    name: '$runSelfTest',
+    params: 1,
+    description: 'Jalankan tes otomatis (dipakai oleh bot.selfTestCommand)',
+    run: (ctx, [mode]) => runSelfTest(bot, ctx, mode.trim().toLowerCase() === 'full'),
+  });
+  return bot.command({
+    name,
+    aliases,
+    code: '$onlyOwner[❌ Perintah ini hanya untuk owner bot.]$cooldown[10s;⏳ Tunggu %time% sebelum mengulang tes.]$runSelfTest[$message[1]]',
+  });
+}
+
+async function runSelfTest(bot, ctx, full) {
+  const results = [];
+  const record = (group, label, status, note = '') => results.push({ group, label, status, note });
+  const step = async (group, label, fn) => {
+    try {
+      await fn();
+      record(group, label, 'ok');
+    } catch (e) {
+      const msg = String(e?.message ?? e);
+      record(group, label, PERM_RE.test(msg) ? 'warn' : 'fail', PERM_RE.test(msg) ? `bot kurang izin (${msg})` : msg);
+    }
+  };
+  const fresh = () => new Context(bot, {
+    kind: 'message', message: ctx.message, guild: ctx.guild, channel: ctx.channel,
+    member: ctx.member, user: ctx.user, command: ctx.command, args: [], rawArgs: '',
+  });
+  const port = async (code) => {
+    const c = fresh();
+    const out = await bot.interpreter.run(parse(code, bot.registry), c);
+    return { out, c };
+  };
+  const expectOut = (group, label, code, expected) => step(group, label, async () => {
+    const { out } = await port(code);
+    const ok = expected instanceof RegExp ? expected.test(out) : out === expected;
+    if (!ok) throw new Error(`hasil "${out}", diharapkan ${expected}`);
+  });
+
+  await ctx.sendPlain(`⏳ Menjalankan tes${full ? ' penuh' : ''}... (beberapa pesan uji akan muncul lalu dihapus)`);
+
+  // ---- Dasar ------------------------------------------------------------------
+  const g = 'basic';
+  await expectOut(g, '$math', '$math[6*7]', '42');
+  await expectOut(g, '$if / $else', '$if[1==1]ya$else tidak$endif', 'ya');
+  await expectOut(g, '$toUpperCase', '$toUpperCase[halo]', 'HALO');
+  await expectOut(g, '$replaceText', '$replaceText[a-b;-;+]', 'a+b');
+  await expectOut(g, '$date', '$date[YYYY]', /^\d{4}$/);
+  await expectOut(g, '$random', '$random[1;3]', /^[123]$/);
+  await expectOut(g, '$username', '$username', ctx.user.username);
+  await expectOut(g, '$botName', '$botName', bot.client.user.username);
+  await expectOut(g, '$ping', '$ping', /^-?\d+$/);
+  await expectOut(g, '$uptime', '$uptime', /\d+s/);
+  await expectOut(g, '$serverCount', '$serverCount', /^\d+$/);
+  if (ctx.guild) {
+    await expectOut(g, '$serverName', '$serverName', ctx.guild.name);
+    await expectOut(g, '$memberCount', '$memberCount', /^\d+$/);
+    await expectOut(g, '$channelName', '$channelName', ctx.channel.name ?? '');
+    await expectOut(g, '$isAdmin', '$isAdmin', /^(true|false)$/);
+    await expectOut(g, '$roleCount', '$roleCount', /^\d+$/);
+  } else {
+    record(g, 'fungsi server', 'warn', 'dilewati: jalankan di dalam server, bukan DM');
+  }
+
+  // ---- Database ---------------------------------------------------------------
+  const d = 'db';
+  const dbName = bot.db?.constructor?.name ?? 'adapter';
+  await step(d, `simpan & baca (${dbName})`, async () => {
+    await bot.setVar('global', '__selftest', '123', null);
+    const v = await bot.getVar('global', '__selftest', null);
+    if (v !== '123') throw new Error(`dibaca "${v}", diharapkan "123"`);
+  });
+  await step(d, 'tambah angka ($inc...Var)', async () => {
+    const v = await bot.incVar('global', '__selftest', 7, null);
+    if (v !== '130') throw new Error(`hasil "${v}", diharapkan "130"`);
+  });
+  await step(d, 'reset ke nilai awal', async () => {
+    await bot.resetVar('global', '__selftest', null);
+    const v = await bot.getVar('global', '__selftest', null);
+    if (v !== '0') throw new Error(`hasil "${v}", diharapkan "0"`);
+  });
+
+  // ---- Kirim pesan ------------------------------------------------------------
+  const s = 'send';
+  const sendCase = (label, code, text, keep) => step(s, label, async () => {
+    const { c } = await port(code);
+    await c.respond(text);
+    if (!c.sent.length) throw new Error('tidak ada pesan yang terkirim');
+    if (!keep) for (const m of c.sent) await m?.delete?.().catch(() => {});
+  });
+  await sendCase(
+    'embed + tombol + select menu + select user',
+    '$title[Selftest]$description[Klik komponen di bawah untuk menguji handler (tidak dihapus otomatis).]$color[blurple]'
+    + '$addField[A;1;true]$addField[B;2;true]$footer[easydc selftest]$addTimestamp'
+    + '$addButton[Tes tombol;primary;selftest_btn]$addButton[Tes modal;secondary;selftest_modal]'
+    + '$newRow$addSelectMenu[selftest_sel;Pilih salah satu]$addSelectOption[Satu;1;Opsi pertama]$addSelectOption[Dua;2]'
+    + '$newRow$addUserSelect[selftest_usr;Pilih user]',
+    '🧪 Pesan uji komponen: klik tiap komponen untuk memastikan jawabannya muncul.',
+    true,
+  );
+  await sendCase('lampiran file teks', '$addTextFile[selftest.txt;halo dari easydc]', 'Uji lampiran', false);
+  await sendCase('polling', '$poll[Selftest berhasil?;1;false;Ya;Tidak]', '', false);
+
+  // ---- Penuh (membuat & menghapus objek sementara) ----------------------------------
+  if (full) {
+    const f = 'full';
+    if (!ctx.guild) {
+      record(f, 'tes penuh', 'fail', 'harus dijalankan di dalam server');
+    } else {
+      let chId = null;
+      try {
+        await step(f, '$createChannel', async () => { chId = (await port('$createChannel[selftest-sementara;text]')).out; if (!/^\d+$/.test(chId)) throw new Error(`ID aneh "${chId}"`); });
+        if (chId) {
+          await expectOut(f, '$setChannelName', `$setChannelName[${chId};selftest-ubah]`, '');
+          await expectOut(f, '$setChannelTopic', `$setChannelTopic[${chId};topik uji]`, '');
+          await expectOut(f, '$lockChannel + $unlockChannel', `$lockChannel[${chId}]$unlockChannel[${chId}]`, '');
+          await expectOut(f, '$createInvite', `$createInvite[${chId};60;1]`, /^https:\/\/discord\.(gg|com)\//);
+          await expectOut(f, '$channelType', `$channelType[${chId}]`, 'text');
+          await expectOut(f, '$sendMessage', `$sendMessage[${chId};pesan uji]`, '');
+          let mid = null;
+          await step(f, 'kirim pesan uji', async () => {
+            const ch = await bot.client.channels.fetch(chId);
+            mid = (await ch.send('pesan awal')).id;
+          });
+          if (mid) {
+            await expectOut(f, '$editMessage', `$editMessage[${mid};sudah diedit;${chId}]`, '');
+            await expectOut(f, '$messageContentOf', `$messageContentOf[${mid};${chId}]`, 'sudah diedit');
+            await expectOut(f, '$pinMessage + $unpinMessage', `$pinMessage[${mid};${chId}]$unpinMessage[${mid};${chId}]`, '');
+            await expectOut(f, '$addReaction', `$addReaction[${mid};👍;${chId}]`, '');
+            await expectOut(f, '$createThread', `$createThread[utas-uji;${mid};;${chId}]`, /^\d+$/);
+            await expectOut(f, '$deleteMessage', `$deleteMessage[${mid};${chId}]`, '');
+          }
+        }
+      } finally {
+        if (chId) {
+          await step(f, '$deleteChannel (bersih-bersih)', async () => {
+            await port(`$deleteChannel[${chId}]`);
+          });
+        }
+      }
+
+      let roleId = null;
+      try {
+        await step(f, '$createRole', async () => { roleId = (await port('$createRole[selftest-role;#5865F2]')).out; if (!/^\d+$/.test(roleId)) throw new Error(`ID aneh "${roleId}"`); });
+        if (roleId) {
+          await expectOut(f, '$setRoleName', `$setRoleName[${roleId};selftest-ubah]`, '');
+          await expectOut(f, '$setRoleColor', `$setRoleColor[${roleId};red]`, '');
+        }
+      } finally {
+        if (roleId) await step(f, '$deleteRole (bersih-bersih)', async () => { await port(`$deleteRole[${roleId}]`); });
+      }
+      await expectOut(f, '$isBanned (bot sendiri)', `$isBanned[${bot.client.user.id}]`, 'false');
+      await expectOut(f, '$banCount', '$banCount', /^\d+$/);
+    }
+  }
+
+  // ---- Laporan ------------------------------------------------------------------
+  const icon = { ok: '✅', fail: '❌', warn: '⚠️' };
+  const lines = [];
+  for (const group of Object.keys(GROUP_TITLES)) {
+    const rows = results.filter((r) => r.group === group);
+    if (!rows.length) continue;
+    lines.push(`**${GROUP_TITLES[group]}**`);
+    for (const r of rows) lines.push(`${icon[r.status]} ${r.label}${r.note ? ` — ${r.note}` : ''}`);
+    lines.push('');
+  }
+  const count = (st) => results.filter((r) => r.status === st).length;
+  lines.push(`**Ringkasan:** ${count('ok')} lulus, ${count('fail')} gagal, ${count('warn')} peringatan.`);
+  lines.push(full ? '' : 'Ketik `selftest full` untuk tes yang membuat & menghapus channel/role sementara.');
+  lines.push('Komponen di pesan uji (tombol, modal, select) perlu diklik manual.');
+  return lines.join('\n').replace(/\n{3,}/g, '\n\n');
+}
+
+module.exports = { installSelfTest, runSelfTest };

package/voice.d.ts

@@ -0,0 +1,29 @@
+export interface LavalinkNode {
+  name: string;
+  url: string;
+  auth: string;
+  secure?: boolean;
+}
+
+export interface VoicePluginOptions {
+  /** Daftar node Lavalink. Kosongkan bila hanya butuh koneksi voice channel dasar ($joinVC / $leaveVC). */
+  nodes?: LavalinkNode[];
+  /** Mesin pencari default bila query bukan link. Bawaan: 'ytsearch' */
+  defaultSearchEngine?: 'ytsearch' | 'ytmsearch' | 'scsearch' | 'spsearch' | string;
+  shoukakuOptions?: Record<string, unknown>;
+  driver?: unknown;
+}
+
+export class VoiceManager {
+  constructor(bot: unknown, options?: VoicePluginOptions);
+  initShoukaku(client: unknown): void;
+  destroy(): Promise<void>;
+}
+
+/**
+ * Plugin:
+ * bot.use(voice({
+ *   nodes: [{ name: 'main', url: 'localhost:2333', auth: 'sandi', secure: false }]
+ * }))
+ */
+export function voice(options?: VoicePluginOptions): { name: string; install(bot: unknown): void };