@kangwifi-pro/waliwa 1.0.0

package/examples/group-bot/index.ts

@@ -0,0 +1,557 @@
+/**
+ * Group Bot Example - Bot manajemen grup WhatsApp dengan admin commands
+ *
+ * Features:
+ * - Welcome message untuk member baru
+ * - Goodbye message saat member keluar
+ * - Anti-spam dengan rate limiting
+ * - Anti-link (auto-hapus link di grup)
+ * - Admin commands: !kick, !promote, !demote, !mute, !unmute
+ * - Tagall, hidetag untuk mention semua member
+ * - Group info, !setsubject, !setdesc
+ */
+
+import {
+  makeWASocket,
+  useFileAuthState,
+  isGroupJid,
+  jidToString,
+  type WAMessage,
+  type WAGroupMetadata,
+  type JIDLike
+} from 'waliwa';
+
+// ============== Config ==============
+
+const CONFIG = {
+  prefix: '!',
+  ownerNumber: process.env.OWNER_NUMBER ?? '6281234567890', // Ganti dengan nomor lo
+  welcomeMessage: 'Selamat datang di grup {groupName}, {userName}! 🎉',
+  goodbyeMessage: 'Sampai jumpa {userName}! 👋',
+  antiLinkEnabled: true,
+  antiSpamEnabled: true,
+  spamThreshold: 5, // max 5 messages per 10 seconds
+  spamWindowMs: 10000,
+  muteDurationMs: 60 * 60 * 1000, // 1 jam default mute
+  tagAllCooldownMs: 30000 // 30 detik cooldown
+};
+
+// ============== State ==============
+
+interface UserSpamTracker {
+  messageCount: number;
+  lastReset: number;
+  warnings: number;
+}
+
+const spamTracker = new Map<string, UserSpamTracker>();
+const mutedUsers = new Set<string>(); // groupJid:userJid
+const lastTagAll = new Map<string, number>(); // groupJid -> timestamp
+
+// ============== Main ==============
+
+async function main() {
+  const { state } = await useFileAuthState('./auth');
+
+  const sock = makeWASocket({
+    authState: state,
+    printQRInTerminal: true,
+    ramOptimizationLevel: 2,
+    maxReconnectAttempts: 10
+  });
+
+  sock.ev.on('connection.update', (update) => {
+    const { connection, qr } = update;
+    if (qr) console.log('Scan QR dengan WhatsApp mobile...');
+    if (connection === 'open') console.log('✓ Group bot online sebagai', sock.user?.id);
+    if (connection === 'close') console.log('Connection closed, akan reconnect...');
+  });
+
+  // Handle incoming messages
+  sock.ev.on('message.upsert', async ({ messages, type }) => {
+    if (type !== 'notify') return;
+    for (const message of messages) {
+      try {
+        await handleMessage(sock, message);
+      } catch (err: any) {
+        console.error('Error handling message:', err.message);
+      }
+    }
+  });
+
+  // Handle group participant updates (join/leave/promote/demote)
+  sock.ev.on('group-participants.update', async (update) => {
+    const { id: groupJid, participants, action, author } = update;
+    try {
+      const metadata = await sock.groupMetadata(groupJid);
+      const groupName = metadata.subject;
+
+      for (const participant of participants) {
+        const userName = await getUserName(sock, participant);
+
+        if (action === 'add') {
+          console.log(`${userName} joined group ${groupName}`);
+          const welcomeMsg = CONFIG.welcomeMessage
+            .replace('{groupName}', groupName)
+            .replace('{userName}', userName);
+          await sock.sendMessage(groupJid, {
+            text: welcomeMsg,
+            mentions: [participant]
+          });
+        } else if (action === 'remove') {
+          console.log(`${userName} left group ${groupName}`);
+          const goodbyeMsg = CONFIG.goodbyeMessage
+            .replace('{groupName}', groupName)
+            .replace('{userName}', userName);
+          await sock.sendMessage(groupJid, { text: goodbyeMsg });
+        } else if (action === 'promote') {
+          await sock.sendMessage(groupJid, {
+            text: `${userName} telah dipromosikan menjadi admin 👑`,
+            mentions: [participant]
+          });
+        } else if (action === 'demote') {
+          await sock.sendMessage(groupJid, {
+            text: `${userName} telah di-demote dari admin`,
+            mentions: [participant]
+          });
+        }
+      }
+    } catch (err: any) {
+      console.error('Error in group update:', err.message);
+    }
+  });
+
+  console.log('Group bot started. Waiting for messages...');
+}
+
+// ============== Message Handler ==============
+
+async function handleMessage(sock: ReturnType<typeof makeWASocket>, message: WAMessage) {
+  if (message.key.fromMe) return;
+
+  const from = message.key.remoteJid;
+  const text = message.message?.text || '';
+  const sender = message.key.participant ?? message.key.remoteJid;
+  const pushName = message.pushName || 'User';
+
+  if (!text) return;
+
+  // Cek apakah di grup
+  const isGroup = isGroupJid(from);
+  if (!isGroup) {
+    // DM mode - reply sederhana
+    if (text === '!menu') {
+      await sock.sendMessage(from, {
+        text: 'Bot ini bekerja di grup. Add bot ke grup untuk fitur lengkap!'
+      });
+    }
+    return;
+  }
+
+  // Check mute status
+  const muteKey = `${jidToString(from)}:${jidToString(sender)}`;
+  if (mutedUsers.has(muteKey) && text.startsWith(CONFIG.prefix)) {
+    return; // Ignore commands dari muted users
+  }
+
+  // Anti-spam check
+  if (CONFIG.antiSpamEnabled) {
+    if (isSpamming(jidToString(sender))) {
+      await warnAndMute(sock, from, sender, pushName);
+      return;
+    }
+  }
+
+  // Anti-link check
+  if (CONFIG.antiLinkEnabled && containsLink(text)) {
+    if (!text.startsWith(CONFIG.prefix)) {
+      await handleAntiLink(sock, from, sender, message);
+      return;
+    }
+  }
+
+  // Parse command
+  if (!text.startsWith(CONFIG.prefix)) return;
+  const [cmd, ...args] = text.slice(1).split(' ');
+  const cmdLower = cmd.toLowerCase();
+
+  console.log(`[${from}] ${pushName}: ${text}`);
+
+  // Get group metadata
+  let metadata: WAGroupMetadata | undefined;
+  try {
+    metadata = await sock.groupMetadata(from);
+  } catch {
+    // ignore
+  }
+
+  const isAdmin = metadata?.participants.find(p => jidToString(p.id) === jidToString(sender))?.isAdmin ?? false;
+  const isOwner = jidUser(jidToString(sender)) === CONFIG.ownerNumber;
+
+  switch (cmdLower) {
+    case 'menu':
+    case 'help':
+      await sendMenu(sock, from);
+      break;
+
+    case 'groupinfo':
+      if (metadata) {
+        await sock.sendMessage(from, {
+          text: [
+            `*Group Info*`,
+            ``,
+            `Nama: ${metadata.subject}`,
+            `Members: ${metadata.participants.length}`,
+            `Admins: ${metadata.participants.filter(p => p.isAdmin).length}`,
+            `Created: ${metadata.creation ? new Date(metadata.creation * 1000).toLocaleDateString('id-ID') : 'unknown'}`,
+            `Desc: ${metadata.desc ?? 'No description'}`
+          ].join('\n')
+        });
+      }
+      break;
+
+    case 'kick':
+      if (!isAdmin && !isOwner) {
+        await sock.sendMessage(from, { text: '❌ Hanya admin yang bisa kick' });
+        return;
+      }
+      await handleKick(sock, from, sender, args, message);
+      break;
+
+    case 'promote':
+      if (!isAdmin && !isOwner) {
+        await sock.sendMessage(from, { text: '❌ Hanya admin yang bisa promote' });
+        return;
+      }
+      await handlePromote(sock, from, args, message, true);
+      break;
+
+    case 'demote':
+      if (!isAdmin && !isOwner) {
+        await sock.sendMessage(from, { text: '❌ Hanya admin yang bisa demote' });
+        return;
+      }
+      await handlePromote(sock, from, args, message, false);
+      break;
+
+    case 'tagall':
+      await handleTagAll(sock, from, metadata, sender);
+      break;
+
+    case 'hidetag':
+      if (!isAdmin && !isOwner) {
+        await sock.sendMessage(from, { text: '❌ Hanya admin yang bisa hidetag' });
+        return;
+      }
+      await handleHideTag(sock, from, args.join(' '), metadata);
+      break;
+
+    case 'setsubject':
+      if (!isAdmin && !isOwner) {
+        await sock.sendMessage(from, { text: '❌ Hanya admin yang bisa ubah nama grup' });
+        return;
+      }
+      if (args.length === 0) {
+        await sock.sendMessage(from, { text: 'Usage: !setsubject <new name>' });
+        return;
+      }
+      await sock.groupUpdateSubject(from, args.join(' '));
+      await sock.sendMessage(from, { text: '✓ Nama grup diubah' });
+      break;
+
+    case 'setdesc':
+      if (!isAdmin && !isOwner) {
+        await sock.sendMessage(from, { text: '❌ Hanya admin yang bisa ubah deskripsi' });
+        return;
+      }
+      if (args.length === 0) {
+        await sock.sendMessage(from, { text: 'Usage: !setdesc <new description>' });
+        return;
+      }
+      await sock.groupUpdateDescription(from, args.join(' '));
+      await sock.sendMessage(from, { text: '✓ Deskripsi grup diubah' });
+      break;
+
+    case 'mute':
+      if (!isAdmin && !isOwner) {
+        await sock.sendMessage(from, { text: '❌ Hanya admin yang bisa mute' });
+        return;
+      }
+      const target = await extractMentionedUser(sock, args, message);
+      if (target) {
+        mutedUsers.add(`${jidToString(from)}:${jidToString(target)}`);
+        await sock.sendMessage(from, {
+          text: `✓ ${pushName} telah di-mute selama 1 jam`,
+          mentions: [target]
+        });
+        setTimeout(() => {
+          mutedUsers.delete(`${jidToString(from)}:${jidToString(target)}`);
+        }, CONFIG.muteDurationMs);
+      }
+      break;
+
+    case 'unmute':
+      if (!isAdmin && !isOwner) {
+        await sock.sendMessage(from, { text: '❌ Hanya admin yang bisa unmute' });
+        return;
+      }
+      const unmuteTarget = await extractMentionedUser(sock, args, message);
+      if (unmuteTarget) {
+        mutedUsers.delete(`${jidToString(from)}:${jidToString(unmuteTarget)}`);
+        await sock.sendMessage(from, {
+          text: `✓ User telah di-unmute`,
+          mentions: [unmuteTarget]
+        });
+      }
+      break;
+
+    case 'invite':
+      const code = await sock.groupInviteCode(from);
+      await sock.sendMessage(from, {
+        text: `Link invite grup: https://chat.whatsapp.com/${code}`
+      });
+      break;
+
+    case 'revoke':
+      if (!isAdmin && !isOwner) {
+        await sock.sendMessage(from, { text: '❌ Hanya admin yang bisa revoke link' });
+        return;
+      }
+      await sock.groupRevokeInvite(from);
+      await sock.sendMessage(from, { text: '✓ Invite link di-revoke' });
+      break;
+
+    case 'poll':
+      await handlePoll(sock, from, args);
+      break;
+
+    default:
+      // Unknown command - ignore
+      break;
+  }
+}
+
+// ============== Helper Functions ==============
+
+async function sendMenu(sock: ReturnType<typeof makeWASocket>, from: JIDLike) {
+  const menu = [
+    '*Group Bot Commands*',
+    '',
+    '*General:*',
+    '!menu - Tampilkan menu ini',
+    '!groupinfo - Info grup',
+    '!invite - Get invite link',
+    '',
+    '*Admin Commands:*',
+    '!kick @user - Kick member',
+    '!promote @user - Promote jadi admin',
+    '!demote @user - Demote admin',
+    '!setsubject <name> - Ubah nama grup',
+    '!setdesc <desc> - Ubah deskripsi',
+    '!revoke - Revoke invite link',
+    '!tagall - Mention semua member',
+    '!hidetag <msg> - Hidden mention',
+    '!mute @user - Mute user (1 jam)',
+    '!unmute @user - Unmute user',
+    '',
+    '*Fun:*',
+    '!poll <question> | opt1 | opt2 - Create poll'
+  ].join('\n');
+  await sock.sendMessage(from, { text: menu });
+}
+
+async function getUserName(sock: ReturnType<typeof makeWASocket>, jid: JIDLike): Promise<string> {
+  try {
+    // Try get from contacts - simplified
+    return jidToString(jid).split('@')[0];
+  } catch {
+    return 'Unknown';
+  }
+}
+
+function containsLink(text: string): boolean {
+  const linkPattern = /(https?:\/\/[^\s]+|www\.[^\s]+|[a-zA-Z0-9-]+\.[a-zA-Z]{2,}(?:\/[^\s]*)?)/i;
+  return linkPattern.test(text);
+}
+
+async function handleAntiLink(
+  sock: ReturnType<typeof makeWASocket>,
+  from: JIDLike,
+  sender: JIDLike,
+  message: WAMessage
+) {
+  await sock.sendMessage(from, {
+    text: `⚠️ Link tidak diperbolehkan di grup ini!`,
+    quoted: message
+  });
+  // Delete message
+  await sock.deleteMessage(from, message.key, { revokeEveryone: true }).catch(() => {});
+}
+
+function isSpamming(userJid: string): boolean {
+  const now = Date.now();
+  let tracker = spamTracker.get(userJid);
+  if (!tracker) {
+    tracker = { messageCount: 0, lastReset: now, warnings: 0 };
+    spamTracker.set(userJid, tracker);
+  }
+  // Reset if window expired
+  if (now - tracker.lastReset > CONFIG.spamWindowMs) {
+    tracker.messageCount = 0;
+    tracker.lastReset = now;
+  }
+  tracker.messageCount++;
+  return tracker.messageCount > CONFIG.spamThreshold;
+}
+
+async function warnAndMute(
+  sock: ReturnType<typeof makeWASocket>,
+  from: JIDLike,
+  sender: JIDLike,
+  pushName: string
+) {
+  const tracker = spamTracker.get(jidToString(sender));
+  if (tracker) tracker.warnings++;
+
+  await sock.sendMessage(from, {
+    text: `⚠️ ${pushName} terdeteksi spam! Warning ${tracker?.warnings ?? 1}/${3}`,
+    mentions: [sender]
+  });
+
+  if ((tracker?.warnings ?? 0) >= 3) {
+    // Auto mute
+    mutedUsers.add(`${jidToString(from)}:${jidToString(sender)}`);
+    await sock.sendMessage(from, {
+      text: `🔇 ${pushName} telah di-auto-mute karena spam berlebihan`,
+      mentions: [sender]
+    });
+    setTimeout(() => {
+      mutedUsers.delete(`${jidToString(from)}:${jidToString(sender)}`);
+    }, CONFIG.muteDurationMs);
+  }
+}
+
+async function handleKick(
+  sock: ReturnType<typeof makeWASocket>,
+  from: JIDLike,
+  sender: JIDLike,
+  args: string[],
+  message: WAMessage
+) {
+  const target = await extractMentionedUser(sock, args, message);
+  if (!target) {
+    await sock.sendMessage(from, { text: 'Usage: !kick @user' });
+    return;
+  }
+  await sock.groupParticipantsUpdate(from, [target], 'remove');
+  await sock.sendMessage(from, { text: `✓ User kicked`, mentions: [target] });
+}
+
+async function handlePromote(
+  sock: ReturnType<typeof makeWASocket>,
+  from: JIDLike,
+  args: string[],
+  message: WAMessage,
+  promote: boolean
+) {
+  const target = await extractMentionedUser(sock, args, message);
+  if (!target) {
+    await sock.sendMessage(from, {
+      text: `Usage: !${promote ? 'promote' : 'demote'} @user`
+    });
+    return;
+  }
+  await sock.groupParticipantsUpdate(from, [target], promote ? 'promote' : 'demote');
+}
+
+async function handleTagAll(
+  sock: ReturnType<typeof makeWASocket>,
+  from: JIDLike,
+  metadata: WAGroupMetadata | undefined,
+  sender: JIDLike
+) {
+  if (!metadata) return;
+  const now = Date.now();
+  const last = lastTagAll.get(jidToString(from)) ?? 0;
+  if (now - last < CONFIG.tagAllCooldownMs) {
+    await sock.sendMessage(from, {
+      text: `Cooldown! Tunggu ${Math.ceil((CONFIG.tagAllCooldownMs - (now - last)) / 1000)} detik`
+    });
+    return;
+  }
+  lastTagAll.set(jidToString(from), now);
+
+  const mentions = metadata.participants.map(p => p.id);
+  const text = `*Tag All*\n\n` + mentions.map(m => `@${jidToString(m).split('@')[0]}`).join(' ');
+  await sock.sendMessage(from, { text, mentions });
+}
+
+async function handleHideTag(
+  sock: ReturnType<typeof makeWASocket>,
+  from: JIDLike,
+  text: string,
+  metadata: WAGroupMetadata | undefined
+) {
+  if (!metadata || !text) {
+    await sock.sendMessage(from, { text: 'Usage: !hidetag <message>' });
+    return;
+  }
+  const mentions = metadata.participants.map(p => p.id);
+  await sock.sendMessage(from, { text, mentions });
+}
+
+async function handlePoll(
+  sock: ReturnType<typeof makeWASocket>,
+  from: JIDLike,
+  args: string[]
+) {
+  const text = args.join(' ');
+  if (!text || !text.includes('|')) {
+    await sock.sendMessage(from, { text: 'Usage: !poll <question> | opt1 | opt2 | opt3' });
+    return;
+  }
+  const parts = text.split('|').map(p => p.trim());
+  const question = parts[0];
+  const options = parts.slice(1);
+  if (options.length < 2) {
+    await sock.sendMessage(from, { text: 'Minimal 2 options!' });
+    return;
+  }
+  // Note: This requires PollManager integration on WASocket
+  // For now, send as text
+  await sock.sendMessage(from, {
+    text: `*Poll: ${question}*\n\n${options.map((o, i) => `${i + 1}. ${o}`).join('\n')}`
+  });
+}
+
+async function extractMentionedUser(
+  sock: ReturnType<typeof makeWASocket>,
+  args: string[],
+  message: WAMessage
+): Promise<JIDLike | null> {
+  // Check mentioned jids dalam message
+  if (message.message?.contextInfo?.mentionedJid && message.message.contextInfo.mentionedJid.length > 0) {
+    return message.message.contextInfo.mentionedJid[0];
+  }
+  // Check args (phone number)
+  if (args.length > 0 && args[0].startsWith('@')) {
+    const phone = args[0].slice(1).replace(/[^0-9]/g, '');
+    return `${phone}@s.whatsapp.net`;
+  }
+  // Check quoted message participant
+  if (message.message?.contextInfo?.participant) {
+    return message.message.contextInfo.participant;
+  }
+  return null;
+}
+
+function jidUser(jid: string): string {
+  return jid.split('@')[0].split(':')[0];
+}
+
+// ============== Run ==============
+
+main().catch(err => {
+  console.error('Fatal error:', err);
+  process.exit(1);
+});

package/examples/group-bot/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "waliwa-group-bot",
+  "version": "1.0.0",
+  "description": "Group management bot dengan admin commands, anti-spam, welcome messages",
+  "main": "index.ts",
+  "scripts": {
+    "start": "ts-node index.ts"
+  },
+  "dependencies": {
+    "waliwa": "file:../../"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.3.3",
+    "ts-node": "^10.9.2"
+  }
+}