@tryty/easydc-js 0.0.0-stage → 1.1.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/index.d.ts

@@ -0,0 +1,129 @@
+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 } | Database;
+  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;
+}
+
+export class Database {
+  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;
+}
+
+export class Bot {
+  constructor(options?: BotOptions);
+  client: Client | null;
+  db: Database;
+  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;
+  getVar(scope: 'user' | 'server' | 'channel' | 'global', name: string, id?: string | null): string;
+  setVar(scope: 'user' | 'server' | 'channel' | 'global', name: string, value: unknown, id?: string | null): void;
+  resetVar(scope: 'user' | 'server' | 'channel' | 'global', name: string, id?: string | null): void;
+  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/package.json

@@ -1,6 +1,34 @@
 {
   "name": "@tryty/easydc-js",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.1.0",
+  "description": "Bot Discord super mudah di atas discord.js: tulis perintah dengan sintaks $fungsi[arg] ala aoi.js.",
+  "main": "src/index.js",
+  "types": "index.d.ts",
+  "files": [
+    "src",
+    "examples",
+    "index.d.ts",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "node --test",
+    "docs": "node scripts/gen-docs.js"
+  },
+  "keywords": [
+    "discord",
+    "discord.js",
+    "bot",
+    "aoi.js",
+    "easy",
+    "wrapper"
+  ],
+  "author": "",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.17.0"
+  },
+  "dependencies": {
+    "discord.js": "^14.16.0"
+  }
+}