@kangwifi-pro/waliwa 3.0.0 → 3.0.1

package/README.md

@@ -1,600 +1,467 @@
 # Waliwa
 
-> **Lightweight WhatsApp library with hybrid protocol (WA Web MD + Mobile API)**
+> WhatsApp library based on Baileys 7 + zaileys + baileys-mbuilder
 >
-> Lebih lengkap dari Baileys, lebih ringan dari ZapoJS, lebih hemat RAM.
+> Super ringan, fluent API, dengan MessageBuilder, CommandSystem, Automation, dan Plugin system.
 
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue.svg)](https://www.typescriptlang.org/)
-[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D16-green.svg)](https://nodejs.org/)
+[![npm version](https://img.shields.io/npm/v/@kangwifi-pro/waliwa.svg)](https://www.npmjs.com/package/@kangwifi-pro/waliwa)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 
-## ✨ Fitur Utama
-
-### Hybrid Protocol (Lebih Lengkap dari Baileys)
-- **WhatsApp Web Multi-Device** - QR code login via WebSocket + Noise Protocol
-- **Mobile API Pairing** - Login via phone number + 8-character code (tanpa scan QR)
-- **Auto-Fallback** - Switch otomatis antara WA Web dan Mobile API jika gagal
-
-### SKDM (Store Key Data Manager) - Baru!
-- **Auto-regenerate pre-keys** saat hampir habis (fix Baileys pre-key exhaustion)
-- **LRU cache** untuk sessions (RAM efficient, fix memory leak)
-- **Atomic file writes** (fix session corruption on disconnect)
-- **Identity change detection** (security alerts)
-- **Background key rotation** otomatis
-
-### RAM-Efficient (Lebih Ringan dari ZapoJS)
-- **Buffer Pooling** - Reuse buffer untuk hindari GC pressure
-- **Lazy Loading** - Hanya load sessions/keys saat dibutuhkan
-- **Debounced Writes** - Batch disk writes untuk hemat IO
-- **3 Level Optimasi** - Balanced, Aggressive, Ultra (untuk low-end devices)
-
-### Fix Baileys Issues (9+ fixes)
-1. ✅ Pre-key exhaustion → auto-regeneration
-2. ✅ Race condition → per-recipient message queue
-3. ✅ Memory leak → WeakEventEmitter dengan FinalizationRegistry
-4. ✅ Connection hang → heartbeat dengan dead detection
-5. ✅ Decryption failure → retry queue + session prefetch
-6. ✅ Duplicate messages → idempotency cache dengan TTL
-7. ✅ Group events missing → event coalescing
-8. ✅ Media upload timeout → chunked upload dengan resume
-9. ✅ History sync incomplete → resume manager
-
-### Fitur Baru
-- ✅ **Multi-Branch SKDM Recovery** - 8 disconnect reasons dengan recovery branches masing-masing
-- ✅ **Health Monitor** - real-time health score 0-100 dengan auto-recovery
-- ✅ **Multi-account Manager** - manage multiple WhatsApp accounts
-- ✅ **Webhook System** - reliable delivery dengan HMAC signature + retry + DLQ
-- ✅ **Circuit Breaker** - prevent retry storms untuk failed recipients
-- ✅ **Rate Limit Tracker** - per-recipient rate limiting
-- ✅ **Message Persistence** - survive restarts dengan pending message recovery
-
-### Fitur Lengkap WhatsApp
-- ✅ **Auth & Session** - QR pairing, phone code pairing, persistent session
-- ✅ **Messages** - Text, media, reply, forward, reactions, polls
-- ✅ **Group Management** - Create, invite, promote, demote, settings, anti-link, anti-spam
-- ✅ **Advanced** - Newsletter, Status/Stories, Business Profile, Catalog, Labels
-- ✅ **Call Handling** - Incoming call notification, auto-reject, voice transcription hook
-- ✅ **Media** - Upload/download dengan AES-256-CBC + HMAC-SHA256 encryption
-
-### Original Implementation
-- Clean-room implementation dari Noise Protocol XX handshake
-- Manual binary encoder/decoder untuk WA Web binary format
-- Hybrid approach: lib untuk primitives (Noble Curves), manual untuk WA-specific encoding
-
-## 📦 Instalasi
+## Instalasi
 
 ```bash
-npm install waliwa
-# atau
-yarn add waliwa
-# atau
-pnpm add waliwa
+npm install @kangwifi-pro/waliwa
 ```
 
-## 🚀 Quick Start
-
-### Basic Bot dengan QR Code
-
-```typescript
-import { makeWASocket, useFileAuthState } from 'waliwa';
-
-async function main() {
-  // Initialize file-based auth state
-  const { state } = await useFileAuthState('./auth');
-
-  // Create socket
-  const sock = makeWASocket({
-    authState: state,
-    printQRInTerminal: true,
-    ramOptimizationLevel: 2 // 1=balanced, 2=aggressive, 3=ultra
-  });
-
-  // Connection events
-  sock.ev.on('connection.update', ({ connection, qr }) => {
-    if (qr) console.log('Scan QR dengan WhatsApp mobile');
-    if (connection === 'open') console.log('✓ Connected!');
-  });
-
-  // Handle messages
-  sock.ev.on('message.upsert', async ({ messages, type }) => {
-    if (type !== 'notify') return;
-    for (const msg of messages) {
-      if (!msg.key.fromMe && msg.message?.text) {
-        await sock.sendMessage(msg.key.remoteJid, {
-          text: `Echo: ${msg.message.text}`
-        });
-      }
-    }
-  });
-}
-
-main();
-```
-
-### Mobile API Mode (Pairing Code)
+## Quick Start (3 baris)
 
 ```typescript
-import { makeWASocket, useFileAuthState } from 'waliwa';
-
-const { state } = await useFileAuthState('./auth');
+import { quickStart, MessageHelper } from '@kangwifi-pro/waliwa';
 
-const sock = makeWASocket({
-  authState: state,
-  mobile: true, // Enable Mobile API mode
-  phoneNumber: '6281234567890', // Target phone number
-  ramOptimizationLevel: 3
-});
-
-sock.ev.on('pairing-code.update', ({ code }) => {
-  console.log(`\nPairing code: ${code}`);
-  console.log('Input code ini di WhatsApp mobile app > Settings > Linked Devices\n');
-});
+const sock = await quickStart({ authFolder: './auth' });
 
-sock.ev.on('connection.update', ({ connection }) => {
-  if (connection === 'open') console.log('✓ Paired & connected!');
+sock.ev.on('messages.upsert', async ({ messages }) => {
+  for (const msg of messages) {
+    if (MessageHelper.isFromMe(msg)) continue;
+    const text = MessageHelper.getText(msg);
+    if (text === '!ping') await MessageHelper.reply(sock, msg, 'pong! 🏓');
+  }
 });
 ```
 
-### Multi-Branch SKDM Recovery
+QR otomatis muncul di terminal. Scan dengan WhatsApp → Settings → Linked Devices.
 
-```typescript
-import { makeWASocket, useFileAuthState } from 'waliwa';
-
-const { state } = await useFileAuthState('./auth');
-
-const sock = makeWASocket({
-  authState: state,
-  printQRInTerminal: true,
-
-  // Multi-Branch Recovery config
-  recovery: {
-    enabled: true,
-    maxAttemptsPerBranch: 3,       // Max attempts per branch
-    maxTotalAttempts: 20,          // Total max attempts
-    initialDelayMs: 1000,         // Initial backoff delay
-    maxDelayMs: 60000,             // Max backoff delay
-    rateLimitedDelayMs: 300000     // 5 min cooldown for rate limit
-  }
-});
+Auto-reconnect, auto-save credentials, auto-keepalive — semua sudah aktif default.
 
-// Monitor recovery events
-sock.recoveryManager.on('recovery:start', ({ reason, code }) => {
-  console.warn(`Recovery started: ${reason} (code ${code})`);
-});
+## Fitur Utama
 
-sock.recoveryManager.on('recovery:success', ({ reason, totalAttempts, duration }) => {
-  console.log(`Recovery succeeded: ${reason} in ${duration}ms (${totalAttempts} attempts)`);
-});
-
-sock.recoveryManager.on('recovery:failed', ({ reason, fatal }) => {
-  console.error(`Recovery failed: ${reason} (fatal: ${fatal})`);
-  if (fatal) {
-    // Manual QR re-scan required
-    notifyAdmin(`Bot logged out! Reason: ${reason}. Re-auth required.`);
-  }
-});
-
-// Branches:
-// Connection lost → Immediate retry → Stream reconnect → Backoff →
-//                  Key refresh → Pre-key fetch → Full re-auth QR
-// Rate limited → Wait cooldown 5min → Backoff retry
-// Logged out → Key refresh → No recovery (fatal)
-// Multi-device mismatch → Key refresh → Full re-auth QR
-// Connection replaced → Key refresh → Full re-auth QR
-// ... dan lainnya
-```
+| Modul | Asal | Deskripsi |
+|-------|------|-----------|
+| Core | Baileys 7 | Koneksi WA Web multi-device, Noise XX, protobuf |
+| `quickStart()` | Waliwa | One-liner setup dengan auto QR, reconnect, save creds |
+| `MessageBuilder` | zaileys | Fluent chaining: `.to().text().image().reply().send()` |
+| `ButtonBuilder` | baileys-mbuilder | Button interactive messages |
+| `CarouselBuilder` | baileys-mbuilder | Carousel card messages |
+| `AIRichBuilder` | baileys-mbuilder | AI rich response (hyperlink, citation, LaTeX) |
+| `CommandSystem` | zaileys | Command registry + middleware + guards (cooldown, adminOnly) |
+| `AutoRejectCall` | zaileys | Auto-reject incoming calls |
+| `AutoRead` | zaileys | Auto-mark messages as read |
+| `AutoPresence` | zaileys | Auto typing indicator |
+| `Broadcast` | zaileys | Send to multiple recipients dengan delay |
+| `Scheduler` | zaileys | Schedule messages untuk future delivery |
+| `RateLimiter` | zaileys | Per-recipient rate limiting |
+| `PluginRegistry` | zaileys | Modular plugin system dengan `definePlugin()` |
+| `MediaHelper` | Waliwa | Download, convert, resize (sharp) |
+| `StickerHelper` | Waliwa | Create stickers dari image/video/text (sharp + ffmpeg) |
+| `MessageHelper` | Waliwa | Parse, format, reply utilities |
 
-## 📖 API Reference
+## API
 
-### Events (Baileys-style)
+### quickStart()
 
 ```typescript
-sock.ev.on('connection.update', (update) => {});
-sock.ev.on('creds.update', (creds) => {});
-sock.ev.on('qr.update', (qr) => {});
-sock.ev.on('pairing-code.update', (code) => {});
-sock.ev.on('message.upsert', ({ messages, type }) => {});
-sock.ev.on('message.update', ({ messages, keys }) => {});
-sock.ev.on('message.reaction', ({ key, reaction, sender }) => {});
-sock.ev.on('presence.update', (presence) => {});
-sock.ev.on('chats.upsert', (chats) => {});
-sock.ev.on('groups.upsert', (groups) => {});
-sock.ev.on('groups.update', (groups) => {});
-sock.ev.on('group-participants.update', (update) => {});
-sock.ev.on('calls', (callEvent) => {});
-sock.ev.on('contacts.upsert', (contacts) => {});
+const sock = await quickStart({
+  authFolder: './auth',
+  browser: ['Waliwa Bot', 'Chrome', '1.0.0'],
+  printQRInTerminal: true,  // default: true
+  autoReconnect: true,      // default: true
+  reconnectDelayMs: 5000,  // default: 5000
+  markOnlineOnConnect: true,
+  syncFullHistory: false
+});
 ```
 
-### Send Messages
+### MessageBuilder
 
 ```typescript
-// Text
-await sock.sendMessage(jid, { text: 'Hello!' });
+import { MessageBuilder } from '@kangwifi-pro/waliwa';
 
-// Reply
-await sock.sendMessage(jid, {
-  text: 'Reply!',
-  quoted: originalMessage
-});
+const builder = new MessageBuilder(sock);
 
-// Mention
-await sock.sendMessage(jid, {
-  text: 'Hi @user!',
-  mentions: ['6281234567890@s.whatsapp.net']
-});
+// Text + reply + mentions
+await builder.to(jid).text('Hello!').reply(message).mentions(['user@s.whatsapp.net']).send();
 
 // Image
-import { readFileSync } from 'fs';
-await sock.sendMessage(jid, {
-  image: { stream: readFileSync('photo.jpg'), mimetype: 'image/jpeg' },
-  caption: 'Photo caption'
-});
+await builder.to(jid).image(buffer, { caption: 'Check this!' }).send();
+
+// Audio (voice note)
+await builder.to(jid).audio(buffer, { ptt: true }).send();
 
 // Document
-await sock.sendMessage(jid, {
-  document: {
-    stream: readFileSync('doc.pdf'),
-    mimetype: 'application/pdf',
-    fileName: 'document.pdf'
-  }
-});
+await builder.to(jid).document(buffer, { fileName: 'report.pdf' }).send();
+
+// Sticker
+await builder.to(jid).sticker(webpBuffer).send();
 
 // Location
-await sock.sendMessage(jid, {
-  location: {
-    degreesLatitude: -6.2088,
-    degreesLongitude: 106.8456,
-    name: 'Jakarta'
-  }
-});
+await builder.to(jid).location(-6.2088, 106.8456, { name: 'Jakarta' }).send();
 
 // Contact
-await sock.sendMessage(jid, {
-  contact: {
-    displayName: 'John Doe',
-    vcard: 'BEGIN:VCARD\nVERSION:3.0\nFN:John Doe\nTEL:+6281234567890\nEND:VCARD'
-  }
-});
+await builder.to(jid).contact(vcardString, 'John Doe').send();
 
 // Poll
-await sock.sendMessage(jid, {
-  poll: {
-    name: 'Pilih makan siang',
-    values: ['Nasi Goreng', 'Mie Ayam', 'Sate'],
-    selectableCounts: [1]
-  }
-});
-
-// Reaction
-await sock.reactToMessage(jid, message.key, '👍');
-```
+await builder.to(jid).poll('Pilih makan?', ['Nasi', 'Mie', 'Sate']).send();
 
-### Group Management
-
-```typescript
-// Create group
-const group = await sock.groupCreate({
-  subject: 'My Group',
-  participants: ['6281234567890@s.whatsapp.net'],
-  desc: 'Group description'
-});
+// Buttons
+await builder.to(jid).text('Choose:').buttons([
+  { label: 'Yes', id: 'yes' },
+  { label: 'No', id: 'no' }
+]).send();
 
-// Get metadata
-const metadata = await sock.groupMetadata(group.id);
+// Carousel
+await builder.to(jid).carousel([
+  { title: 'Product A', text: '$10', buttons: [{ label: 'Buy', id: 'buy_a' }] },
+  { title: 'Product B', text: '$20', buttons: [{ label: 'Buy', id: 'buy_b' }] }
+]).send();
 
-// Update subject
-await sock.groupUpdateSubject(group.id, 'New Name');
+// Broadcast ke multiple recipients
+await builder.to('dummy').text('Announcement!').broadcast([jid1, jid2, jid3], 2000);
 
-// Add/remove/promote/demote
-await sock.groupParticipantsUpdate(group.id, ['user@s.whatsapp.net'], 'add');
-await sock.groupParticipantsUpdate(group.id, ['user@s.whatsapp.net'], 'remove');
-await sock.groupParticipantsUpdate(group.id, ['user@s.whatsapp.net'], 'promote');
-await sock.groupParticipantsUpdate(group.id, ['user@s.whatsapp.net'], 'demote');
+// View once
+await builder.to(jid).image(buffer).viewOnce().send();
+```
 
-// Invite link
-const code = await sock.groupInviteCode(group.id);
-await sock.groupRevokeInvite(group.id);
+### ButtonBuilder
 
-// Join via code
-const joinedGroupJid = await sock.groupJoinViaCode('inviteCode');
+```typescript
+import { ButtonBuilder } from '@kangwifi-pro/waliwa';
 
-// Leave group
-await sock.groupLeave(group.id);
+const msg = new ButtonBuilder()
+  .text('Choose an option:')
+  .button('Yes', 'yes_id')
+  .button('No', 'no_id')
+  .footer('Powered by Waliwa')
+  .build();
 
-// Settings
-await sock.groupSettingUpdate(group.id, 'restrict', true); // Only admins can send
-await sock.groupSettingUpdate(group.id, 'announce', true);  // Only admins can edit info
+await sock.sendMessage(jid, msg);
 ```
 
-### Call Handling
+### CarouselBuilder
 
 ```typescript
-sock.ev.on('calls', async (callEvent) => {
-  console.log(`Incoming ${callEvent.isVideo ? 'video' : 'voice'} call from ${callEvent.from}`);
-
-  // Auto-reject
-  await sock.rejectCall(callEvent.id, callEvent.from);
-});
-```
+import { CarouselBuilder } from '@kangwifi-pro/waliwa';
 
-### Media Upload/Download
+const msg = new CarouselBuilder()
+  .card(c => c.title('Product A').text('$10').button('Buy', 'buy_a'))
+  .card(c => c.title('Product B').text('$20').button('Buy', 'buy_b'))
+  .build();
 
-```typescript
-import { readFileSync, writeFileSync } from 'fs';
-
-// Upload
-const buffer = readFileSync('photo.jpg');
-const uploadResult = await sock.uploadMedia(buffer, 'image', 'image/jpeg', 'photo.jpg');
-console.log('Uploaded:', uploadResult.url);
-
-// Download (from message)
-if (msg.message?.image) {
-  const downloadResult = await sock.downloadMedia(
-    msg.message.image.url,
-    msg.message.image.mediaKey,
-    'image',
-    msg.message.image.mimetype
-  );
-  writeFileSync('downloaded.jpg', downloadResult.buffer);
-}
+await sock.sendMessage(jid, msg);
 ```
 
-### Presence & Typing Indicator
+### AIRichBuilder
 
 ```typescript
-// Subscribe to user presence
-await sock.presenceSubscribe(['6281234567890@s.whatsapp.net']);
-
-// Listen to presence updates
-sock.ev.on('presence.update', ({ jid, presence }) => {
-  console.log(`${jid} is ${presence}`);
-});
+import { AIRichBuilder } from '@kangwifi-pro/waliwa';
 
-// Send typing indicator
-await sock.sendPresenceUpdate(jid, 'composing'); // typing
-await sock.sendPresenceUpdate(jid, 'recording'); // recording voice
-await sock.sendPresenceUpdate(jid, 'paused');   // stopped
+const msg = new AIRichBuilder()
+  .text('Visit [Google](https://google.com) for details')
+  .build();
 
-// Update own presence
-await sock.updatePresence('available');
-await sock.updatePresence('unavailable');
+await sock.sendMessage(jid, msg);
 ```
 
-### Advanced Features
+### CommandSystem
 
 ```typescript
-// Newsletter
-const newsletter = await sock.newsletterManager.create('My Channel', 'Description');
-await sock.newsletterManager.subscribe(newsletter.id);
+import { CommandSystem } from '@kangwifi-pro/waliwa';
 
-// Status/Stories
-await sock.statusManager.sendTextStatus('Hello world!', {
-  backgroundColor: '#FF0000'
+const cmd = new CommandSystem(sock, {
+  prefix: '!',
+  ownerIds: ['6281234567890@s.whatsapp.net']
 });
 
-// Business Profile
-await sock.businessProfileManager.update({
-  description: 'My Business',
-  email: 'contact@business.com',
-  address: 'Jakarta, Indonesia'
+// Simple command
+cmd.command('ping', async (ctx) => {
+  await ctx.reply('pong! 🏓');
 });
 
-// Catalog
-await sock.catalogManager.addProduct({
-  name: 'Product 1',
-  description: 'Description',
-  price: 100000,
-  currency: 'IDR'
+// With guards
+cmd.command('kick', {
+  adminOnly: true,
+  cooldown: 5000,
+  description: 'Kick member dari grup',
+  aliases: ['remove']
+}, async (ctx) => {
+  // ctx.sender, ctx.jid, ctx.args, ctx.isGroup, ctx.isOwner, ctx.quoted
+  const target = ctx.mentions[0] || ctx.quoted?.participant;
+  if (!target) return ctx.reply('Tag atau reply user yang mau di-kick');
+  await sock.groupParticipantsUpdate(ctx.jid, [target], 'remove');
+  await ctx.reply(`✅ Kicked ${target}`);
 });
-```
 
-## 🏗️ Arsitektur
+// Middleware
+cmd.use(async (ctx, next) => {
+  console.log(`[${ctx.senderName}] ${ctx.fullText}`);
+  await next();
+});
 
-```
-┌──────────────────────────────────────────────────────────────────┐
-│                         Your Application                          │
-└──────────────────────────────────────────────────────────────────┘
-                                 │
-                                 ▼
-┌──────────────────────────────────────────────────────────────────┐
-│                          WASocket (Public API)                    │
-│  Event Emitter, sendMessage, groupCreate, etc.                  │
-└──────────────────────────────────────────────────────────────────┘
-                                 │
-       ┌─────────────────────────┼─────────────────────────┐
-       ▼                         ▼                         ▼
-┌──────────────┐         ┌──────────────┐         ┌──────────────┐
-│  Messages    │         │   Groups     │         │    Calls     │
-│ Send/Receive │         │  Management  │         │   Handler    │
-│   Media      │         │  Participants│         │   Reject     │
-└──────────────┘         └──────────────┘         └──────────────┘
-                                 │
-                                 ▼
-┌──────────────────────────────────────────────────────────────────┐
-│                     Hybrid Socket Manager                         │
-│   Auto-fallback antara WA Web MD dan Mobile API                  │
-└──────────────────────────────────────────────────────────────────┘
-                                 │
-       ┌─────────────────────────┼─────────────────────────┐
-       ▼                         ▼                         ▼
-┌──────────────┐         ┌──────────────┐         ┌──────────────┐
-│  WA Web MD   │         │  Mobile API  │         │   Auth State  │
-│  WebSocket   │         │   Pairing    │         │  File JSON    │
-└──────────────┘         └──────────────┘         └──────────────┘
-       │                         │
-       ▼                         ▼
-┌──────────────────────────────────────────────────────────────────┐
-│                    Noise Protocol XX Handshake                     │
-│         + AES-256-GCM Traffic Cipher + WA Binary Protocol         │
-└──────────────────────────────────────────────────────────────────┘
-                                 │
-                                 ▼
-┌──────────────────────────────────────────────────────────────────┐
-│              Crypto Primitives (@noble/curves + @noble/hashes)    │
-│      Curve25519, Ed25519, SHA-256, HMAC, HKDF, AES-GCM/CBC       │
-└──────────────────────────────────────────────────────────────────┘
+cmd.attach();
 ```
 
-## 🔒 Reverse Engineering Approach
+#### CommandContext Properties
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `sock` | any | Socket instance |
+| `message` | any | Raw WA message |
+| `jid` | string | Chat JID |
+| `sender` | string | Sender JID |
+| `text` | string | Full message text |
+| `command` | string | Command name (tanpa prefix) |
+| `args` | string[] | Arguments |
+| `isGroup` | boolean | Apakah dari grup |
+| `isFromMe` | boolean | Apakah dari bot sendiri |
+| `isOwner` | boolean | Apakah sender adalah owner |
+| `senderName` | string | Nama sender (pushName) |
+| `quoted` | any | Quoted message context |
+| `mentions` | string[] | Mentioned JIDs |
+
+#### CommandContext Methods
+
+| Method | Description |
+|--------|-------------|
+| `reply(text)` | Reply ke message |
+| `replyWithMedia(buffer)` | Reply dengan image |
+| `react(emoji)` | React ke message |
+| `sendTyping()` | Kirim typing indicator |
+| `sendRecording()` | Kirim recording indicator |
+| `stopTyping()` | Stop typing indicator |
+
+#### CommandOptions
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `adminOnly` | boolean | Hanya admin grup |
+| `ownerOnly` | boolean | Hanya owner bot |
+| `groupOnly` | boolean | Hanya bisa di grup |
+| `privateOnly` | boolean | Hanya bisa di DM |
+| `cooldown` | number | Cooldown dalam ms |
+| `rateLimit` | { max, windowMs } | Rate limit per user |
+| `aliases` | string[] | Command aliases |
+| `description` | string | Deskripsi untuk help |
+
+### Automation
 
-Waliwa adalah clean-room implementation berdasarkan publicly documented WhatsApp protocol:
+```typescript
+import { AutoRejectCall, AutoRead, AutoPresence, Broadcast, Scheduler, RateLimiter } from '@kangwifi-pro/waliwa';
+
+// Auto-reject incoming calls
+const autoReject = new AutoRejectCall(sock);
+autoReject.start();
+// Allow specific users
+autoReject.allow('6281234567890@s.whatsapp.net');
+
+// Auto-read messages (exclude groups)
+const autoRead = new AutoRead(sock, { excludeGroups: true });
+autoRead.start();
+
+// Auto typing indicator
+const autoPresence = new AutoPresence(sock);
+autoPresence.start();
+
+// Broadcast
+const broadcast = new Broadcast(sock, 2000); // 2s delay
+await broadcast.sendText([jid1, jid2, jid3], 'Announcement!');
+
+// Scheduler
+const scheduler = new Scheduler(sock);
+scheduler.schedule('reminder1', jid, { text: 'Waktunya meeting!' }, 60 * 60 * 1000); // 1 hour
+scheduler.cancel('reminder1');
+scheduler.list(); // [{ id, jid }]
+
+// Rate limiter
+const limiter = new RateLimiter();
+limiter.setLimit(jid, 10, 60000); // 10 messages per minute
+if (limiter.canSend(jid)) {
+  await sock.sendMessage(jid, { text: 'Hi!' });
+}
+```
 
-1. **Noise Protocol Framework** - Public spec dari [noiseprotocol.org](https://noiseprotocol.org/)
-   - Pattern: `Noise_XX_25519_AESGCM_SHA256`
-   - Manual implementation di `src/core/noise.ts`
+### Plugin System
 
-2. **WhatsApp Binary Format** - Custom binary protocol untuk encoding
-   - Tags: list, dictionary, packed nibble/hex, binary 8/20/32
-   - Manual encoder/decoder di `src/core/binary.ts`
+```typescript
+import { definePlugin, PluginLoader } from '@kangwifi-pro/waliwa';
+
+// plugins/echo.ts
+export default definePlugin({
+  name: 'echo',
+  version: '1.0.0',
+  description: 'Echo plugin',
+  onLoad: (ctx) => console.log('Echo plugin loaded!'),
+  onMessage: async (msg, ctx) => {
+    const text = msg.message?.conversation || '';
+    if (text === '!echo') {
+      await ctx.sock.sendMessage(msg.key.remoteJid, { text: 'Echo!' });
+    }
+  }
+});
 
-3. **Multi-Device Protocol** - WebSocket with encrypted frames
-   - Frame: `[WA header][version][length][encrypted payload]`
-   - AES-256-GCM dengan counter-based nonce
+// Load plugins
+const loader = new PluginLoader(sock);
+await loader.loadFromDir('./plugins');
+loader.getRegistry().list(); // [{ name, version, description }]
+```
 
-4. **Mobile API Pairing** - Companion device registration
-   - Pairing code: 8 alphanumeric chars derived via HKDF
-   - Format: `AB12-CD34` (dash separator)
+### MediaHelper
 
-5. **Media Encryption** - AES-256-CBC + HMAC-SHA256
-   - 112-byte derived key (iv + cipherKey + macKey + refKey)
-   - 10-byte MAC truncation sesuai WA spec
+```typescript
+import { MediaHelper } from '@kangwifi-pro/waliwa';
 
-## 📊 RAM Usage Comparison
+// Download dari message
+const buffer = await MediaHelper.downloadFromMessage(sock, msg);
 
-| Library       | Idle RAM | Active RAM | Notes                                |
-|---------------|----------|------------|--------------------------------------|
-| Baileys       | ~80 MB   | ~150 MB    | Pino logger, full buffer             |
-| ZapoJS        | ~60 MB   | ~120 MB    | Heavy dependencies                   |
-| **Waliwa**    | **~35 MB** | **~70 MB** | Buffer pool, lazy load, debounced IO |
+// Download dari URL
+const buffer = await MediaHelper.downloadFromUrl('https://...');
 
-*Benchmarks pada Node.js 20, single account, moderate message rate*
+// Resize (untuk profile picture 640x640)
+const resized = await MediaHelper.resizeImage(buffer, 640, 640);
 
-## 📚 Examples
+// Convert format
+const webp = await MediaHelper.toWebP(buffer);
+const jpeg = await MediaHelper.toJPEG(buffer, 80);
 
-4 contoh bot siap pakai tersedia di `examples/`:
+// Compress
+const compressed = await MediaHelper.compress(buffer, 60);
 
-1. **echo-bot** - Basic echo bot untuk testing
-   ```bash
-   cd examples/echo-bot && npm install && npm start
-   ```
+// Thumbnail
+const thumb = await MediaHelper.createThumbnail(buffer, 200);
 
-2. **group-bot** - Group management dengan admin commands
-   ```bash
-   cd examples/group-bot && npm install && npm start
-   ```
+// Watermark
+const watermarked = await MediaHelper.addWatermark(buffer, '© Waliwa');
 
-3. **ai-bot** - AI chatbot dengan OpenAI GPT integration
-   ```bash
-   cd examples/ai-bot
-   echo "OPENAI_API_KEY=your_key" > .env
-   npm install && npm start
-   ```
+// Grayscale / blur
+const gray = await MediaHelper.grayscale(buffer);
+const blurred = await MediaHelper.blur(buffer, 5);
+```
 
-4. **rest-gateway** - HTTP REST API untuk send/receive
-   ```bash
-   cd examples/rest-gateway && npm install && npm start
-   curl -X POST http://localhost:3000/send-text \
-     -H "Content-Type: application/json" \
-     -d '{"to":"6281234567890","message":"Hello!"}'
-   ```
+### StickerHelper
 
-## 📖 Documentation
+```typescript
+import { StickerHelper } from '@kangwifi-pro/waliwa';
 
-- [**Multi-Branch SKDM Recovery**](docs/RECOVERY.md) - Recovery branches per disconnect reason
-- [**SKDM (Store Key Data Manager)**](docs/SKDM.md) - Key management subsystem
-- [**Baileys Fixes**](docs/BAILEYS_FIXES.md) - Detail 9+ fix untuk issue Baileys
-- [**New Features**](docs/FEATURES.md) - Health monitor, multi-account, webhooks, dll
-- [**Architecture**](docs/ARCHITECTURE.md) - Internal design dan module dependencies
-- [**Protocol**](docs/PROTOCOL.md) - WhatsApp protocol reverse engineering details
-- [**API Reference**](docs/API.md) - Complete API documentation
+// Dari image
+const sticker = await StickerHelper.fromImage(imageBuffer, {
+  pack: 'My Pack',
+  author: 'Me',
+  categories: ['😀']
+});
 
-## 🔧 Production Monitoring
+// Dari video (animated)
+const animated = await StickerHelper.fromVideo(videoBuffer);
 
-```typescript
-const sock = makeWASocket({ authState: state });
-
-// Get comprehensive system stats
-const stats = sock.getSystemStats();
-console.log(JSON.stringify(stats, null, 2));
-// {
-//   messageQueue: { totalQueues: 5, totalPending: 0, ... },
-//   circuitBreakers: [],
-//   rateLimits: { trackedRecipients: 12, ... },
-//   webhooks: { sent: 145, failed: 3, ... },
-//   messagePersistence: { total: 89, pending: 0, failed: 1 },
-//   idempotency: { size: 89, hitRate: 0.95 },
-//   health: { status: 'healthy', score: 95, ... }
-// }
-
-// Health monitoring
-sock.healthMonitor.on('health:recovery', (status) => {
-  console.warn('Auto-recovery triggered:', status.issues);
+// Dari text
+const textSticker = await StickerHelper.fromText('Hello!', {
+  color: '#ffffff',
+  backgroundColor: '#000000'
 });
 
-// Register webhook untuk external monitoring
-sock.registerWebhook({
-  url: 'https://yourapp.com/webhook',
-  events: ['message.sent', 'message.failed', 'auth.success'],
-  secret: process.env.WEBHOOK_SECRET,
-  enabled: true,
-  retryCount: 5,
-  retryDelayMs: 1000,
-  timeoutMs: 10000
-});
-```
+// Dari URL
+const urlSticker = await StickerHelper.fromUrl('https://...');
 
-## ⚙️ Configuration
+// Dari file
+const fileSticker = await StickerHelper.fromFile('./image.jpg');
 
-### WaliwaConfig Options
+// Send
+await sock.sendMessage(jid, { sticker });
+```
 
-| Option                  | Type      | Default                              | Description                          |
-|-------------------------|-----------|--------------------------------------|--------------------------------------|
-| authState               | AuthState | **required**                         | Auth state (file, memory, custom)    |
-| printQRInTerminal       | boolean   | false                                | Print QR ke terminal                 |
-| mobile                  | boolean   | false                                | Use Mobile API mode                  |
-| phoneNumber             | string    | -                                    | Phone number untuk Mobile API mode   |
-| browser                 | [3 string]| ['Waliwa', 'WA', '1.0.0']           | Browser identification               |
-| wsURL                   | string    | wss://web.whatsapp.com/ws/chat       | Custom WebSocket URL                  |
-| connectTimeoutMs        | number    | 20000                                | Connect timeout ms                   |
-| keepAliveIntervalMs     | number    | 20000                                | Keep-alive ping interval             |
-| maxReconnectAttempts    | number    | 10                                   | Max auto-reconnect attempts          |
-| reconnectInterval       | number    | 2000                                 | Initial reconnect delay ms           |
-| ramOptimizationLevel    | 1/2/3     | 2                                    | 1=balanced, 2=aggressive, 3=ultra    |
-| syncFullHistory         | boolean   | false                                | Sync full message history on connect |
-| markOnlineOnConnect     | boolean   | true                                 | Mark bot online saat connect        |
+### MessageHelper
 
-### RAM Optimization Levels
+```typescript
+import { MessageHelper } from '@kangwifi-pro/waliwa';
+
+// Extract text
+const text = MessageHelper.getText(msg);
+
+// Info
+MessageHelper.isFromMe(msg);
+MessageHelper.isGroupMessage(msg);
+MessageHelper.getSender(msg);
+MessageHelper.getChat(msg);
+MessageHelper.hasMedia(msg);
+MessageHelper.getMediaType(msg);
+MessageHelper.getMentions(msg);
+MessageHelper.getQuoted(msg);
+
+// Parse command
+const cmd = MessageHelper.parseCommand(msg, '!');
+// { command: 'ping', args: [], fullText: '!ping' }
+
+// Actions
+await MessageHelper.reply(sock, msg, 'Hello!');
+await MessageHelper.sendText(sock, jid, 'Hi!', { mentions: [...] });
+await MessageHelper.mentionAll(sock, groupJid);
+await MessageHelper.react(sock, msg, '👍');
+await MessageHelper.markAsRead(sock, msg.key);
+await MessageHelper.sendTyping(sock, jid);
+await MessageHelper.stopTyping(sock, jid);
+await MessageHelper.delete(sock, msg);
+await MessageHelper.forward(sock, toJid, msg);
+```
 
-| Level     | Buffer Pool | Lazy Load | Debounce | Use Case                          |
-|-----------|-------------|-----------|----------|-----------------------------------|
-| 1 Balanced| 8 buffers   | Off       | 100ms    | Development, high-throughput      |
-| 2 Aggressive| 16 buffers| On        | 50ms     | Production default                 |
-| 3 Ultra   | 32 buffers  | On        | 25ms     | Low-end VPS, multi-account         |
+## Events
 
-## 🛠️ Development
+```typescript
+sock.ev.on('connection.update', (update) => {
+  // update.connection: 'connecting' | 'open' | 'close'
+  // update.qr: string (QR code)
+  // update.lastDisconnect: { error, output }
+});
 
-```bash
-# Install dependencies
-npm install
+sock.ev.on('messages.upsert', ({ messages, type }) => {
+  // type: 'notify' (new) | 'append' (history)
+});
+
+sock.ev.on('messages.update', (updates) => {
+  // Status updates: sent, delivered, read
+});
 
-# Build library
-npm run build
+sock.ev.on('message-receipt.update', (updates) => {
+  // Delivery/read receipts
+});
 
-# Run tests
-npm test
+sock.ev.on('presence.update', ({ id, presences }) => {
+  // Presence: available, unavailable, composing, recording
+});
 
-# Run example
-cd examples/echo-bot && npm start
+sock.ev.on('chats.upsert', (chats) => {});
+sock.ev.on('chats.update', (chats) => {});
+sock.ev.on('contacts.upsert', (contacts) => {});
+sock.ev.on('groups.upsert', (groups) => {});
+sock.ev.on('groups.update', (groups) => {});
+sock.ev.on('group-participants.update', (update) => {
+  // update.action: 'add' | 'remove' | 'promote' | 'demote'
+});
+sock.ev.on('call', (calls) => {});
+sock.ev.on('creds.update', () => saveCreds());
 ```
 
-## ⚠️ Disclaimer
+## Reconnect Behavior
+
+| Status Code | Reason | Reconnect? |
+|-------------|--------|------------|
+| 515 | Restart required | ✅ Ya |
+| 428 | Connection closed | ✅ Ya |
+| 440 | Connection replaced | ✅ Ya |
+| 500 | Server error | ✅ Ya |
+| 401 | Logged out | ❌ Tidak (clear auth folder) |
 
-This library is for educational purposes. WhatsApp is a trademark of WhatsApp Inc., and this project is not affiliated with or endorsed by WhatsApp Inc. Use at your own risk and comply with WhatsApp's Terms of Service.
+Auto-reconnect default aktif dengan delay 5 detik.
 
-## 📄 License
+## Dependencies
 
-MIT - See [LICENSE](LICENSE) file for details.
+| Package | Purpose |
+|---------|---------|
+| `@whiskeysockets/baileys` | Core WA protocol |
+| `@hapi/boom` | Error handling |
+| `pino` + `pino-pretty` | Logging |
+| `qrcode-terminal` | QR display |
+| `axios` | HTTP requests |
+| `mime-types` | MIME detection |
+| `sharp` | Image processing |
+| `fluent-ffmpeg` + `@ffmpeg-installer/ffmpeg` | Video/sticker processing |
 
-## 🤝 Contributing
+## License
 
-Contributions welcome! Please read contributing guidelines dan ensure all tests pass sebelum submit PR.
+MIT