@tryty/easydc-js 0.0.0-stage → 1.2.0

package/examples/advanced/lanjutan.js

@@ -0,0 +1,60 @@
+// Contoh fitur v1.1: modal, autocomplete, menu klik-kanan, poll, event baru.
+// Dimuat dengan: bot.loadCommands('./examples/advanced')
+module.exports = [
+  // --- Modal: slash command membuka form, lalu handler membaca isinya ---
+  {
+    type: 'slash',
+    name: 'lapor',
+    description: 'Kirim laporan lewat form',
+    code: `
+$addModal[lapor_form;Form Laporan]
+$addTextInput[judul;Judul;short;Ringkas saja;true;3;50]
+$addTextInput[isi;Isi laporan;paragraph]
+`,
+  },
+  {
+    type: 'modal',
+    customId: 'lapor_form',
+    code: '$ephemeral Terima kasih $username! Judul: $modalValue[judul] | Isi: $modalValue[isi]',
+  },
+
+  // --- Autocomplete ---
+  {
+    type: 'slash',
+    name: 'buah',
+    description: 'Pilih buah',
+    options: [{ name: 'nama', description: 'Nama buah', autocomplete: true }],
+    code: 'Kamu memilih $option[nama]',
+  },
+  {
+    type: 'autocomplete',
+    command: 'buah',
+    option: 'nama',
+    code: `
+$addChoice[Apel;apel]
+$addChoice[Jeruk;jeruk]
+$addChoice[Mangga;mangga]
+`,
+  },
+
+  // --- Menu klik-kanan ---
+  { type: 'contextMenu', menu: 'user', name: 'Lihat Profil', code: '$ephemeral Profil: $targetName (ID $targetID)' },
+  { type: 'contextMenu', menu: 'message', name: 'Laporkan', code: '$ephemeral Pesan "$targetContent" dari $targetName dilaporkan.' },
+
+  // --- Poll + moderasi dengan pelindung izin ---
+  { name: 'vote', code: '$poll[Makan apa hari ini?;24;false;Nasi;Mie;Roti]' },
+  {
+    name: 'unban',
+    code: `
+$onlyPerms[BanMembers;❌ Kamu butuh izin BanMembers.]
+$argsCheck[1;Format: !unban <userID>]
+$if[$isBanned[$message[1]]==false]User itu tidak sedang di-ban.$stop$endif
+$unban[$message[1];Dicabut oleh $username]
+✅ Ban dicabut.
+`,
+  },
+
+  // --- Event baru ---
+  { type: 'voiceJoin', code: '🔊 $username masuk ke $targetName' },
+  { type: 'memberBan', code: '🔨 $targetName di-ban dari server.' },
+];

package/examples/basic.js

@@ -0,0 +1,100 @@
+// Jalankan: TOKEN=token_bot_kamu node examples/basic.js
+const { Bot } = require('easydc-js'); // saat dicoba dari folder ini: require('../src')
+
+const bot = new Bot({
+  token: process.env.TOKEN,
+  prefix: '!',
+  owners: [], // isi ID Discord kamu agar $onlyOwner berfungsi
+  timezone: 'Asia/Jakarta',
+  status: { text: '!help', type: 'Listening' },
+});
+
+// Variabel yang disimpan permanen di database (harus dideklarasikan + nilai awal)
+bot.variables({ uang: 100 });
+
+bot.command({ name: 'ping', code: '🏓 Pong! $ping ms' });
+
+bot.command({
+  name: 'help',
+  code: `
+$title[Daftar perintah]
+$description[\`!ping\` \`!uang\` \`!kerja\` \`!ulang\` \`!ban\`]
+$color[blurple]
+`,
+});
+
+bot.command({
+  name: 'uang',
+  code: '💰 $username punya $numberSeparator[$getUserVar[uang];.] koin',
+});
+
+bot.command({
+  name: 'kerja',
+  code: `
+$cooldown[1m;Kamu capek, istirahat %time% lagi.]
+$let[gaji;$random[10;50]]
+$setUserVar[uang;$math[$getUserVar[uang]+$get[gaji]]]
+Kamu kerja dan dapat $get[gaji] koin! Total: $getUserVar[uang]
+`,
+});
+
+bot.command({
+  name: 'ulang',
+  code: `
+$argsCheck[2;Format: !ulang <kata> <jumlah>]
+$repeat[$message[1] ;$message[2]]
+`,
+});
+
+// Contoh if / else
+bot.command({
+  name: 'cek',
+  code: `
+$if[$isAdmin==true]
+Kamu admin 👑
+$elseif[$hasRole[ISI_ID_ROLE]==true]
+Kamu anggota 🙂
+$else
+Kamu tamu 👋
+$endif
+`,
+});
+
+// Moderasi: SELALU lindungi dengan $onlyPerms
+bot.command({
+  name: 'ban',
+  code: `
+$onlyPerms[BanMembers;❌ Kamu butuh izin BanMembers.]
+$onlyBotPerms[BanMembers;❌ Bot tidak punya izin BanMembers.]
+$argsCheck[1;Format: !ban @user alasan]
+$ban[$mentioned[1];Dibanned oleh $username]
+✅ Berhasil ban <@$mentioned[1]>
+`,
+});
+
+// Slash command
+bot.slashCommand({
+  name: 'halo',
+  description: 'Menyapa seseorang',
+  options: [{ name: 'nama', description: 'Siapa yang disapa', type: 'string', required: true }],
+  code: 'Halo, $option[nama]! 👋',
+});
+
+// Tombol
+bot.command({
+  name: 'tombol',
+  code: `
+Tekan tombolnya:
+$addButton[Klik aku;primary;klik_1]
+$addButton[Website;link;https://discord.js.org]
+`,
+});
+bot.button({ customId: 'klik_*', code: '$ephemeral Kamu menekan `$customID`' });
+
+// Event
+bot.onMemberJoin('Selamat datang $mention di **$serverName**! 🎉');
+
+bot.connect().then(() => console.log('Bot sedang login...')).catch((e) => {
+  console.error(e.message);
+  process.exit(1);
+});

package/examples/commands/ping.js

@@ -0,0 +1,6 @@
+// Command dari file: dimuat dengan bot.loadCommands('./examples/commands')
+module.exports = {
+  name: 'ping',
+  aliases: ['p'],
+  code: `🏓 Pong! Latensi: $ping ms | Aktif: $uptime`,
+};

package/examples/commands/profil.js

@@ -0,0 +1,28 @@
+// Satu file boleh berisi banyak command (array) dan jenis berbeda (type).
+module.exports = [
+  {
+    name: 'profil',
+    code: `
+$cooldown[5s;Tunggu %time% ya.]
+$newEmbed
+$title[Profil $username[$mentioned[1;yes]]]
+$thumbnail[$userAvatar[$mentioned[1;yes]]]
+$color[#5865F2]
+$addField[Uang;💰 $numberSeparator[$getUserVar[uang;$mentioned[1;yes]];.];true]
+$addField[Bergabung;<t:$round[$math[$userCreatedAt[$mentioned[1;yes]]/1000]]:D>;true]
+$footer[Diminta oleh $username]
+`,
+  },
+  {
+    type: 'slash',
+    name: 'halo',
+    description: 'Menyapa seseorang',
+    options: [{ name: 'nama', description: 'Nama yang disapa', type: 'string', required: true }],
+    code: `Halo, $option[nama]! 👋`,
+  },
+  {
+    type: 'button',
+    customId: 'klik_*',
+    code: `$ephemeral Kamu menekan tombol \`$customID\`.`,
+  },
+];

package/examples/mongo.js

@@ -0,0 +1,44 @@
+// Bot dengan database MongoDB.
+// Pasang dulu: npm install 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 = new Bot({ token: process.env.TOKEN, prefix: '!', timezone: 'Asia/Jakarta' });
+
+bot.use(mongodb({
+  uri: process.env.MONGO_URI,
+  dbName: 'botku',
+  // cache: false,   // aktifkan baris ini jika bot dijalankan di lebih dari satu proses/server
+}));
+
+bot.variables({ uang: 100 });
+
+bot.command({ name: 'uang', code: '💰 $username punya $numberSeparator[$getUserVar[uang];.] koin' });
+
+bot.command({
+  name: 'kerja',
+  code: `
+$cooldown[1m;Istirahat dulu, tunggu %time%.]
+$incUserVar[uang;$random[10;50]]
+Kamu bekerja! Uangmu sekarang $getUserVar[uang]
+`,
+});
+
+bot.command({
+  name: 'kirim',
+  code: `
+$argsCheck[2;Format: !kirim @user jumlah]
+$onlyIf[$mentioned[1]!=;Mention user tujuan.]
+$onlyIf[$isNumber[$message[2]]==true&&$message[2]>0;Jumlah harus angka lebih dari 0.]
+$onlyIf[$getUserVar[uang]>=$message[2];Uangmu tidak cukup.]
+$incUserVar[uang;-$message[2]]
+$incUserVar[uang;$message[2];$mentioned[1]]
+✅ Terkirim $message[2] koin ke <@$mentioned[1]>
+`,
+});
+
+bot.connect().then(() => console.log('Bot online, database terhubung.')).catch((e) => {
+  console.error(e.message);
+  process.exit(1);
+});

package/index.d.ts

@@ -0,0 +1,150 @@
+import type { Client } from 'discord.js';
+
+export interface BotOptions {
+  token?: string;
+  prefix?: string | string[];
+  mentionPrefix?: boolean;
+  ignoreBots?: boolean;
+  owners?: string | string[];
+  intents?: 'default' | 'all' | Array<string | number>;
+  syncSlash?: boolean;
+  slashGuild?: string | null;
+  timezone?: string;
+  allowedMentions?: object;
+  debug?: boolean;
+  handleSignals?: boolean;
+  /** Nyalakan $eval / $jsEval / bot.evalCommand (hanya untuk ID di `owners`). Bawaan: false */
+  eval?: boolean;
+  database?: { path?: string; memory?: boolean; saveDelay?: number } | DatabaseAdapter;
+  messages?: { cooldown?: string; error?: string };
+  status?: { text: string; type?: 'Playing' | 'Streaming' | 'Listening' | 'Watching' | 'Competing'; status?: 'online' | 'idle' | 'dnd' | 'invisible' };
+  onError?: (error: Error, ctx: Context) => unknown;
+  client?: Client;
+  discord?: unknown;
+}
+
+export interface CommandDef { name: string; aliases?: string[]; code: string }
+export interface SlashOption {
+  name: string;
+  description: string;
+  type?: 'string' | 'integer' | 'boolean' | 'user' | 'channel' | 'role' | 'mentionable' | 'number' | 'attachment';
+  required?: boolean;
+  choices?: Array<{ name: string; value: string | number }>;
+  minValue?: number;
+  maxValue?: number;
+  minLength?: number;
+  maxLength?: number;
+  /** Pilihan dinamis; daftarkan handler dengan bot.autocomplete(). Tidak bisa bersama `choices`. */
+  autocomplete?: boolean;
+}
+export interface AutocompleteDef { command: string; option?: string; code: string }
+export interface ContextMenuDef { name: string; menu: 'user' | 'message'; code: string }
+export interface SlashDef { name: string; description: string; options?: SlashOption[]; code: string }
+export interface ComponentDef { customId: string; code: string }
+export type EventType = 'ready' | 'memberJoin' | 'memberLeave' | 'messageDelete' | 'messageUpdate' | 'reactionAdd' | 'reactionRemove' | 'guildJoin' | 'guildLeave' | 'message'
+  | 'memberBan' | 'memberUnban' | 'channelCreate' | 'channelDelete' | 'roleCreate' | 'roleDelete' | 'threadCreate' | 'voiceJoin' | 'voiceLeave';
+export interface EventDef { type: EventType; channel?: string; code: string }
+export interface CustomFunction {
+  name: string;
+  params?: number;
+  min?: number;
+  max?: number;
+  brackets?: 'none' | 'optional' | 'required';
+  override?: boolean;
+  signature?: string;
+  description?: string;
+  run: (ctx: Context, args: string[]) => unknown | Promise<unknown>;
+}
+
+export class Context {
+  bot: Bot;
+  client: Client;
+  kind: 'message' | 'slash' | 'component' | 'event';
+  guild: any;
+  channel: any;
+  member: any;
+  user: any;
+  message: any;
+  interaction: any;
+  args: string[];
+  rawArgs: string;
+}
+
+/** Adapter database: hanya get/set/delete yang wajib. Nilai balik boleh Promise. */
+export interface DatabaseAdapter {
+  get(key: string): unknown | Promise<unknown>;
+  set(key: string, value: unknown): unknown | Promise<unknown>;
+  delete(key: string): unknown | Promise<unknown>;
+  has?(key: string): boolean | Promise<boolean>;
+  keys?(prefix?: string): string[] | Promise<string[]>;
+  flush?(): unknown | Promise<unknown>;
+  connect?(): Promise<void>;
+  close?(): unknown | Promise<unknown>;
+}
+
+export class Database implements DatabaseAdapter {
+  constructor(options?: { path?: string; memory?: boolean; saveDelay?: number });
+  get(key: string): unknown;
+  set(key: string, value: unknown): void;
+  has(key: string): boolean;
+  delete(key: string): boolean;
+  keys(prefix?: string): string[];
+  flush(): void;
+  close(): void;
+}
+
+export function copyDatabase(from: DatabaseAdapter, to: DatabaseAdapter, options?: { overwrite?: boolean; prefix?: string }): Promise<{ copied: number; skipped: number }>;
+
+export type Plugin = ((bot: Bot, options?: unknown) => void) | { name?: string; install(bot: Bot, options?: unknown): void };
+
+export class Bot {
+  constructor(options?: BotOptions);
+  client: Client | null;
+  db: DatabaseAdapter;
+  plugins: Map<string, unknown>;
+  command(def: CommandDef): this;
+  slashCommand(def: SlashDef): this;
+  button(def: ComponentDef): this;
+  select(def: ComponentDef): this;
+  modal(def: ComponentDef): this;
+  autocomplete(def: AutocompleteDef): this;
+  contextMenu(def: ContextMenuDef): this;
+  /** Pasang command eval siap pakai (butuh `eval: true` dan `owners`). */
+  evalCommand(def?: { name?: string; aliases?: string[] }): this;
+  event(def: EventDef): this;
+  onMemberBan(code: string | Omit<EventDef, 'type'>): this;
+  onMemberUnban(code: string | Omit<EventDef, 'type'>): this;
+  onChannelCreate(code: string | Omit<EventDef, 'type'>): this;
+  onChannelDelete(code: string | Omit<EventDef, 'type'>): this;
+  onRoleCreate(code: string | Omit<EventDef, 'type'>): this;
+  onRoleDelete(code: string | Omit<EventDef, 'type'>): this;
+  onThreadCreate(code: string | Omit<EventDef, 'type'>): this;
+  onVoiceJoin(code: string | Omit<EventDef, 'type'>): this;
+  onVoiceLeave(code: string | Omit<EventDef, 'type'>): this;
+  onReady(code: string | Omit<EventDef, 'type'>): this;
+  onMemberJoin(code: string | Omit<EventDef, 'type'>): this;
+  onMemberLeave(code: string | Omit<EventDef, 'type'>): this;
+  onMessageDelete(code: string | Omit<EventDef, 'type'>): this;
+  onMessageUpdate(code: string | Omit<EventDef, 'type'>): this;
+  onReactionAdd(code: string | Omit<EventDef, 'type'>): this;
+  onReactionRemove(code: string | Omit<EventDef, 'type'>): this;
+  onGuildJoin(code: string | Omit<EventDef, 'type'>): this;
+  onGuildLeave(code: string | Omit<EventDef, 'type'>): this;
+  onMessage(code: string | Omit<EventDef, 'type'>): this;
+  variables(vars: Record<string, string | number | boolean>): this;
+  addFunction(fn: CustomFunction): this;
+  loadCommands(dir: string): this;
+  validate(): true;
+  use(plugin: Plugin, options?: unknown): this;
+  setDatabase(adapter: DatabaseAdapter): this;
+  getVar(scope: 'user' | 'server' | 'channel' | 'global', name: string, id?: string | null): Promise<string>;
+  setVar(scope: 'user' | 'server' | 'channel' | 'global', name: string, value: unknown, id?: string | null): Promise<void>;
+  resetVar(scope: 'user' | 'server' | 'channel' | 'global', name: string, id?: string | null): Promise<void>;
+  incVar(scope: 'user' | 'server' | 'channel' | 'global', name: string, amount: number | string, id?: string | null): Promise<string>;
+  connect(token?: string): Promise<this>;
+  destroy(): Promise<void>;
+}
+
+export class BotError extends Error {}
+export class ParseError extends BotError { line?: number; col?: number }
+export class ValidationError extends BotError { problems: string[] }

package/mongodb.d.ts

@@ -0,0 +1,31 @@
+import type { Database } from './index';
+
+export interface MongoOptions {
+  /** Alamat MongoDB, mis. process.env.MONGO_URI. Wajib kecuali `client` diisi. */
+  uri?: string;
+  dbName?: string;
+  /** Bawaan: "easydc" */
+  collection?: string;
+  /** Bawaan true. Matikan bila lebih dari satu proses bot memakai database yang sama. */
+  cache?: boolean;
+  cacheLimit?: number;
+  /** MongoClient milik sendiri (tidak ditutup otomatis). */
+  client?: unknown;
+  driver?: unknown;
+  clientOptions?: Record<string, unknown>;
+}
+
+export class MongoDatabase {
+  constructor(options: MongoOptions);
+  connect(): Promise<void>;
+  get(key: string): Promise<string | undefined>;
+  has(key: string): Promise<boolean>;
+  set(key: string, value: unknown): Promise<void>;
+  delete(key: string): Promise<boolean>;
+  keys(prefix?: string): Promise<string[]>;
+  flush(): Promise<void>;
+  close(): Promise<void>;
+}
+
+/** Plugin: bot.use(mongodb({ uri, dbName })) */
+export function mongodb(options: MongoOptions): { name: string; install(bot: unknown): void };

package/package.json

@@ -1,6 +1,55 @@
 {
   "name": "@tryty/easydc-js",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.2.0",
+  "description": "Super easy Discord bot on top of discord.js: write commands with $function[arg] syntax.",
+  "main": "src/index.js",
+  "types": "index.d.ts",
+  "files": [
+    "src",
+    "examples",
+    "index.d.ts",
+    "mongodb.d.ts",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "node --test",
+    "docs": "node scripts/gen-docs.js"
+  },
+  "keywords": [
+    "bot",
+    "discord",
+    "discord.js",
+    "easy",
+    "mongodb",
+    "plugin",
+    "wrapper"
+  ],
+  "author": "",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.17.0"
+  },
+  "dependencies": {
+    "discord.js": "^14.16.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./src/index.js"
+    },
+    "./mongodb": {
+      "types": "./mongodb.d.ts",
+      "default": "./src/plugins/mongodb.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "peerDependencies": {
+    "mongodb": ">=5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "mongodb": {
+      "optional": true
+    }
+  }
+}