@tryty/easydc-js 1.2.0 → 1.2.2

package/examples/basic.js

@@ -1,5 +1,5 @@
 // Jalankan: TOKEN=token_bot_kamu node examples/basic.js
-const { Bot } = require('easydc-js'); // saat dicoba dari folder ini: require('../src')
+const { Bot } = require('@tryty/easydc-js'); // saat dicoba dari folder ini: require('../src')
 
 const bot = new Bot({
   token: process.env.TOKEN,

package/examples/mongo.js

@@ -1,8 +1,8 @@
 // Bot dengan database MongoDB.
-// Pasang dulu: npm install easydc-js discord.js mongodb
+// Pasang dulu: npm install @tryty/easydc-js discord.js mongodb
 // Jalankan:   TOKEN=token_bot MONGO_URI="mongodb+srv://..." node examples/mongo.js
-const { Bot } = require('easydc-js'); // saat dicoba dari folder ini: require('../src')
-const { mongodb } = require('easydc-js/mongodb'); // saat dicoba dari folder ini: require('../src/plugins/mongodb')
+const { Bot } = require('@tryty/easydc-js'); // saat dicoba dari folder ini: require('../src')
+const { mongodb } = require('@tryty/easydc-js/mongodb'); // saat dicoba dari folder ini: require('../src/plugins/mongodb')
 
 const bot = new Bot({ token: process.env.TOKEN, prefix: '!', timezone: 'Asia/Jakarta' });
 

package/index.d.ts

@@ -111,6 +111,8 @@ export class Bot {
   contextMenu(def: ContextMenuDef): this;
   /** Pasang command eval siap pakai (butuh `eval: true` dan `owners`). */
   evalCommand(def?: { name?: string; aliases?: string[] }): this;
+  /** Pasang command tes otomatis di Discord asli (butuh `owners`). `ui: true` menambah /tesauto & menu klik-kanan uji. */
+  selfTestCommand(def?: { name?: string; aliases?: string[]; ui?: boolean }): this;
   event(def: EventDef): this;
   onMemberBan(code: string | Omit<EventDef, 'type'>): this;
   onMemberUnban(code: string | Omit<EventDef, 'type'>): this;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tryty/easydc-js",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "Super easy Discord bot on top of discord.js: write commands with $function[arg] syntax.",
   "main": "src/index.js",
   "types": "index.d.ts",
@@ -9,6 +9,7 @@
     "examples",
     "index.d.ts",
     "mongodb.d.ts",
+    "voice.d.ts",
     "README.md",
     "LICENSE"
   ],
@@ -21,8 +22,11 @@
     "discord",
     "discord.js",
     "easy",
+    "lavalink",
     "mongodb",
+    "music",
     "plugin",
+    "voice",
     "wrapper"
   ],
   "author": "",
@@ -42,14 +46,22 @@
       "types": "./mongodb.d.ts",
       "default": "./src/plugins/mongodb.js"
     },
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./voice": {
+      "types": "./voice.d.ts",
+      "default": "./src/plugins/voice.js"
+    }
   },
   "peerDependencies": {
-    "mongodb": ">=5.0.0"
+    "mongodb": ">=5.0.0",
+    "shoukaku": ">=4.0.0"
   },
   "peerDependenciesMeta": {
     "mongodb": {
       "optional": true
+    },
+    "shoukaku": {
+      "optional": true
     }
   }
 }

package/src/bot.js

@@ -2,6 +2,7 @@
 const fs = require('node:fs');
 const path = require('node:path');
 const { BotError, Stop, ValidationError } = require('./errors');
+const { normalizeOwners } = require('./owners');
 const { parse } = require('./parser');
 const { Interpreter } = require('./interpreter');
 const { Context } = require('./context');
@@ -80,7 +81,7 @@ class Bot {
     };
     opts.prefix = (Array.isArray(opts.prefix) ? opts.prefix : [opts.prefix]).filter((p) => typeof p === 'string' && p !== '');
     if (!opts.prefix.length && !opts.mentionPrefix) throw new BotError('Isi minimal satu prefix atau aktifkan mentionPrefix');
-    opts.owners = (Array.isArray(opts.owners) ? opts.owners : [opts.owners]).filter(Boolean).map(String);
+    opts.owners = normalizeOwners(opts.owners);
     opts.messages = {
       cooldown: '⏳ Tunggu %time% lagi sebelum memakai perintah ini.',
       error: '❌ Terjadi kesalahan saat menjalankan perintah.',
@@ -256,6 +257,16 @@ class Bot {
     return this.command({ name, aliases, code: EVAL_CODE });
   }
 
+  /**
+   * Pasang command tes otomatis (khusus owner) untuk menguji bot di Discord asli.
+   *   bot.selfTestCommand();             // lalu ketik: !selftest   atau   !selftest full
+   *   bot.selfTestCommand({ ui: true }); // + /tesauto & 2 menu klik-kanan untuk dicoba manual
+   */
+  selfTestCommand(def) {
+    // eslint-disable-next-line global-require
+    return require('./selftest').installSelfTest(this, def);
+  }
+
   /** Handler event. { type, channel?, code } */
   event(def) {
     if (!def || !EVENT_TYPES.includes(def.type)) {

package/src/functions/control.js

@@ -2,6 +2,7 @@
 const { BotError, Stop } = require('../errors');
 const { parseTime, formatDuration } = require('../util');
 const { f, list, cleanId } = require('./helpers');
+const { isOwner } = require('../owners');
 
 const MAX_WAIT = 60 * 1000;
 const MAX_DELETE_IN = 24 * 60 * 60 * 1000;
@@ -45,7 +46,7 @@ module.exports = [
     }),
   f('onlyOwner', { max: 1, lazy: true, s: '[pesan?]', d: 'Lanjut hanya jika pengirim ada di opsi owners' },
     async (ctx, args, api) => {
-      if (ctx.bot.options.owners.includes(ctx.user?.id)) return '';
+      if (isOwner(ctx, '$onlyOwner')) return '';
       throw new Stop(await msgOf(api, args, 0));
     }),
   f('onlyForIDs', { b: 'required', min: 1, max: 2, lazy: true, s: '[id1,id2;pesan?]', d: 'Lanjut hanya untuk user dengan ID tertentu' },

package/src/functions/eval.js

@@ -3,6 +3,7 @@ const util = require('node:util');
 const { BotError, Stop } = require('../errors');
 const { parse } = require('../parser');
 const { f } = require('./helpers');
+const { isOwner } = require('../owners');
 
 const AsyncFunction = Object.getPrototypeOf(async () => {}).constructor;
 const MAX_OUTPUT = 1800;
@@ -13,7 +14,7 @@ function guard(ctx, label) {
   if (!ctx.bot.options.eval) {
     throw new Stop(`❌ ${label} dimatikan. Nyalakan dengan new Bot({ eval: true, owners: ['ID_KAMU'] }).`);
   }
-  if (!ctx.bot.options.owners.includes(ctx.user?.id)) throw new Stop('❌ Hanya owner bot yang boleh memakai eval.');
+  if (!isOwner(ctx, label)) throw new Stop('❌ Hanya owner bot yang boleh memakai eval.');
 }
 
 function clean(ctx, text) {

package/src/functions/messages.js

@@ -88,8 +88,8 @@ module.exports = [
       return '';
     }),
 
-  f('createThread', { b: 'required', min: 1, max: 3, s: '[nama;messageID?;arsipOtomatisMenit?]', d: 'Buat thread (dari pesan bila messageID diisi). Arsip: 60/1440/4320/10080. Mengembalikan ID thread' },
-    async (ctx, [name, mid, archive]) => {
+  f('createThread', { b: 'required', min: 1, max: 4, s: '[nama;messageID?;arsipOtomatisMenit?;channelID?]', d: 'Buat thread (dari pesan bila messageID diisi; channelID = channel tempat pesan itu, bawaan channel ini). Arsip: 60/1440/4320/10080. Mengembalikan ID thread' },
+    async (ctx, [name, mid, archive, cid]) => {
       if (!name.trim()) throw new BotError('Nama thread tidak boleh kosong');
       const opts = { name: limit('nama', name.trim(), 100) };
       if (has(archive)) {
@@ -99,10 +99,11 @@ module.exports = [
       }
       let thread;
       if (has(mid)) {
-        thread = await (await fetchMessage(ctx, mid)).startThread(opts);
+        thread = await (await fetchMessage(ctx, mid, cid)).startThread(opts);
       } else {
-        if (!ctx.channel?.threads || typeof ctx.channel.threads.create !== 'function') throw new BotError('Channel ini tidak mendukung thread');
-        thread = await ctx.channel.threads.create(opts);
+        const ch = await channelOrCurrent(ctx, cid);
+        if (!ch.threads || typeof ch.threads.create !== 'function') throw new BotError('Channel ini tidak mendukung thread');
+        thread = await ch.threads.create(opts);
       }
       return thread.id;
     }),

package/src/owners.js

@@ -0,0 +1,36 @@
+'use strict';
+const { BotError } = require('./errors');
+
+/** Rapikan daftar owners: wajib string; angka besar ditolak karena ID Discord kehilangan ketelitian. */
+function normalizeOwners(input) {
+  const list = Array.isArray(input) ? input : [input];
+  const out = [];
+  for (const raw of list) {
+    if (raw === undefined || raw === null || raw === '' || raw === false) continue;
+    if (typeof raw === 'number' && !Number.isSafeInteger(raw)) {
+      throw new BotError(
+        `owners: angka ${raw} tidak akurat karena ID Discord terlalu besar untuk angka JavaScript. ` +
+        'Tulis ID dengan tanda kutip, contoh: owners: ["123456789012345678"]',
+      );
+    }
+    let id = String(raw).trim();
+    const mention = /^<@!?(\d+)>$/.exec(id);
+    if (mention) id = mention[1];
+    id = id.replace(/[​-‍]/g, '');
+    if (id) out.push(id);
+  }
+  return out;
+}
+
+/** Cek owner; bila ditolak, tulis petunjuk ke konsol agar mudah dicari penyebabnya. */
+function isOwner(ctx, label) {
+  const id = ctx.user?.id;
+  const owners = ctx.bot.options.owners;
+  if (owners.includes(id)) return true;
+  // eslint-disable-next-line no-console
+  console.warn(`[easydc] ${label} ditolak: ID pengirim = "${id}", owners yang terdaftar = ${JSON.stringify(owners)}. ` +
+    'Salin ID pengirim ke owners (dengan tanda kutip) bila itu memang akunmu.');
+  return false;
+}
+
+module.exports = { normalizeOwners, isOwner };

package/src/plugins/mongodb.js

@@ -125,7 +125,7 @@ class MongoDatabase {
 
 /**
  * Plugin MongoDB untuk Bot.
- *   const { mongodb } = require('easydc-js/mongodb');
+ *   const { mongodb } = require('@tryty/easydc-js/mongodb');
  *   bot.use(mongodb({ uri: process.env.MONGO_URI, dbName: 'botku' }));
  */
 function mongodb(options) {