andiwagateway 1.0.0

package/PUBLISH_GUIDE.md

@@ -0,0 +1,151 @@
+# Panduan Publish SDK ke NPM
+
+## 🚀 Langkah-langkah Publish ke NPM
+
+### 1. Daftar Akun NPM (Gratis)
+
+1. Buka https://www.npmjs.com/signup
+2. Buat akun dengan username (contoh: `andiwa`)
+3. Verifikasi email
+
+### 2. Login di Terminal
+
+```bash
+cd /Users/andiyanto/Desktop/qr-wa/andi-wa-gateway-sdk
+npm login
+```
+Masukkan:
+- Username: (username NPM Anda)
+- Password: (password NPM Anda)
+- Email: (email verifikasi)
+- OTP: (kode dari email/authenticator)
+
+### 3. Test Package (Dry Run)
+
+```bash
+npm publish --dry-run
+```
+Ini akan simulasi publish tanpa benar-benar upload. Cek apakah ada error.
+
+### 4. Publish (Public - Gratis)
+
+```bash
+npm publish --access public
+```
+
+**Sukses!** SDK sekarang ada di: `https://www.npmjs.com/package/andi-wa-gateway-sdk`
+
+---
+
+## 🔄 Update SDK (Versi Baru)
+
+Kalau ada perubahan di SDK, update versi dulu:
+
+### Otomatis (Recommended)
+
+```bash
+# Update patch version (1.0.0 -> 1.0.1)
+npm version patch
+
+# Update minor version (1.0.0 -> 1.1.0)
+npm version minor
+
+# Update major version (1.0.0 -> 2.0.0)
+npm version major
+```
+
+Lalu publish:
+```bash
+npm publish
+```
+
+### Manual
+
+Edit `package.json`, ubah version:
+```json
+"version": "1.0.1"
+```
+
+Lalu:
+```bash
+npm publish
+```
+
+---
+
+## 📦 Developer Cara Install
+
+Setelah publish, developer bisa:
+
+```bash
+npm install andi-wa-gateway-sdk
+```
+
+Lalu pakai:
+```javascript
+const sdk = require('andi-wa-gateway-sdk');
+
+const wa = sdk.createClient({
+  apiKey: 'ak_live_xxxx'
+});
+
+await wa.sendMessage('628123456789', 'Halo!');
+```
+
+---
+
+## ❌ Unpublish (Kalau ada masalah)
+
+**Hati-hati!** Hanya bisa unpublish dalam 24 jam pertama:
+```bash
+npm unpublish andi-wa-gateway-sdk --force
+```
+
+Setelah 24 jam, harus kontak NPM support.
+
+---
+
+## ✅ Checklist Sebelum Publish
+
+```
+□ Nama package unik (andi-wa-gateway-sdk)
+□ Version benar (1.0.0)
+□ Description jelas
+□ Keywords lengkap
+□ Repository URL benar (opsional)
+□ License MIT
+□ .npmignore ada (exclude examples/)
+□ axios di dependencies
+□ Test dry-run berhasil
+□ npm login berhasil
+```
+
+---
+
+## 🆘 Troubleshooting
+
+### Error: "You do not have permission"
+```bash
+# Pastikan login	npm whoami
+# Kalau tidak keluar username, login ulang
+npm login
+```
+
+### Error: "Package name too similar"
+```bash
+# Ganti nama di package.json
+"name": "andi-wa-gateway-sdk-v2"
+```
+
+### Error: "Failed to replace blob"
+```bash
+# Bersihkan cache
+npm cache clean --force
+```
+
+---
+
+## 📞 Butuh Bantuan?
+
+- Dokumentasi NPM: https://docs.npmjs.com/
+- Support: https://www.npmjs.com/support

package/README.md

@@ -0,0 +1,173 @@
+# Andi WA Gateway SDK
+
+> **SDK Official untuk Andi WA Gateway**
+> 
+> Tinggal pasang API Key, langsung kirim pesan WhatsApp!
+
+---
+
+## 🎯 Fitur
+
+- ✅ **API Key Only** - Tidak perlu setup server, tinggal API Key
+- ✅ **Base URL Built-in** - Sudah terkonfigurasi ke `andi-wa-gateway.up.railway.app`
+- ✅ **OTP Plugin** - Kirim kode verifikasi dengan 1 baris kode
+- ✅ **Webhook Handler** - Terima pesan masuk dengan mudah
+- ✅ **Express Ready** - Middleware siap pakai
+
+---
+
+## 📦 Install
+
+```bash
+npm install andi-wa-gateway-sdk
+```
+
+---
+
+## 🚀 Quick Start
+
+### 1. Kirim Pesan (Basic)
+
+```javascript
+const sdk = require('andi-wa-gateway-sdk');
+
+// Inisialisasi - Cukup API Key!
+const wa = sdk.createClient({
+  apiKey: 'ak_live_abc123xyz789'  // Dari Panel Andi WA Gateway
+});
+
+// Kirim pesan
+await wa.sendMessage('628123456789', 'Halo dari SDK!');
+```
+
+### 2. Kirim OTP (Plugin)
+
+```javascript
+const sdk = require('andi-wa-gateway-sdk');
+
+const otp = sdk.createOtp({
+  apiKey: 'ak_live_abc123xyz789'
+});
+
+// Kirim OTP
+const result = await otp.send('628123456789', {
+  appName: 'MyApp'
+});
+
+console.log('Kode OTP:', result.code); // Simpan ke database!
+
+// Verifikasi
+const isValid = otp.verify(inputUser, result.code);
+```
+
+### 3. Webhook Handler (Terima Pesan)
+
+```javascript
+const sdk = require('andi-wa-gateway-sdk');
+const webhook = sdk.createWebhook();
+
+// Handler pesan masuk
+webhook.onMessage(async (msg) => {
+  console.log('Dari:', msg.from);
+  console.log('Isi:', msg.body);
+});
+
+// Express middleware
+app.post('/webhook/whatsapp', webhook.middleware());
+```
+
+---
+
+## 📚 API Reference
+
+### `createClient(config)`
+
+Membuat instance client utama.
+
+```javascript
+const wa = sdk.createClient({
+  apiKey: 'your-api-key',           // Required
+  sessionId: 'default-session',     // Optional
+  baseUrl: 'https://custom-url.com'  // Optional (override default)
+});
+```
+
+**Methods:**
+
+| Method | Description |
+|--------|-------------|
+| `wa.sendMessage(number, message, sessionId?)` | Kirim pesan teks |
+| `wa.sendMedia(number, mediaUrl, caption?, sessionId?)` | Kirim file/media |
+| `wa.getStatus(sessionId?)` | Cek status session |
+| `wa.listSessions()` | Daftar semua session |
+| `wa.registerWebhook(url, events?)` | Register webhook URL |
+
+### `createOtp(config)`
+
+Plugin untuk kirim OTP.
+
+```javascript
+const otp = sdk.createOtp({
+  apiKey: 'your-api-key',
+  sessionId: 'otp-session'
+});
+```
+
+**Methods:**
+
+| Method | Description |
+|--------|-------------|
+| `otp.generateCode(length?)` | Generate kode random |
+| `otp.send(number, options?)` | Kirim OTP |
+| `otp.sendWithTemplate(number, template, options?)` | Kirim dengan template custom |
+| `otp.verify(input, stored)` | Verifikasi kode |
+
+### `createWebhook(config)`
+
+Handler untuk webhook.
+
+```javascript
+const webhook = sdk.createWebhook({
+  secret: 'optional-secret'  // Untuk verify signature
+});
+```
+
+**Methods:**
+
+| Method | Description |
+|--------|-------------|
+| `webhook.on(event, handler)` | Register handler untuk event |
+| `webhook.onMessage(handler)` | Handler khusus pesan masuk |
+| `webhook.middleware()` | Express middleware |
+| `webhook.createRouter()` | Express router instance |
+
+---
+
+## 💡 Contoh Lengkap
+
+Lihat folder `examples/`:
+
+- `basic-usage.js` - Kirim pesan & media
+- `otp-plugin.js` - Sistem verifikasi OTP
+- `express-webhook.js` - Express server dengan webhook
+
+---
+
+## 🔧 Environment Variables
+
+```env
+WA_GATEWAY_API_KEY=ak_live_abc123xyz789
+```
+
+---
+
+## 📞 Support
+
+- Panel Admin: https://andi-wa-gateway.up.railway.app
+- API Docs: Lihat dokumentasi di panel
+
+---
+
+## 📄 License
+
+MIT

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "andiwagateway",
+  "version": "1.0.0",
+  "description": "Official SDK for Andi WA Gateway - WhatsApp API integration made simple. Just add API Key and start sending messages.",
+  "main": "src/index.js",
+  "keywords": [
+    "whatsapp",
+    "gateway",
+    "sdk",
+    "andi",
+    "otp",
+    "notification",
+    "webhook",
+    "baileys",
+    "messaging",
+    "api"
+  ],
+  "author": "Andi <andi@andi-wa-gateway.com>",
+  "license": "MIT",
+  "type": "commonjs",
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "dependencies": {
+    "axios": "^1.6.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/andi/andi-wa-gateway-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/andi/andi-wa-gateway-sdk/issues"
+  },
+  "homepage": "https://github.com/andi/andi-wa-gateway-sdk#readme",
+  "scripts": {
+    "test": "echo 'Error: no test specified' && exit 1"
+  }
+}

package/src/core/client.js

@@ -0,0 +1,65 @@
+const createHttpClient = require('./http-client');
+
+/**
+ * Main SDK Client
+ * File ini adalah entry point untuk semua operasi SDK
+ */
+
+function createClient(config) {
+  const http = createHttpClient(config);
+
+  return {
+    config,
+    http,
+
+    /**
+     * Kirim pesan teks WhatsApp
+     * @param {string} number - Nomor tujuan (format: 628123456789 atau 08123456789)
+     * @param {string} message - Isi pesan
+     * @param {string} [sessionId] - Override session ID (opsional)
+     */
+    async sendMessage(number, message, sessionId = null) {
+      const targetSession = sessionId || config.sessionId;
+      return http.sendMessage(targetSession, number, message);
+    },
+
+    /**
+     * Kirim media/file WhatsApp
+     * @param {string} number - Nomor tujuan
+     * @param {string} mediaUrl - URL file/media
+     * @param {string} [caption] - Keterangan media
+     * @param {string} [sessionId] - Override session ID
+         */
+    async sendMedia(number, mediaUrl, caption = '', sessionId = null) {
+      const targetSession = sessionId || config.sessionId;
+      return http.sendMedia(targetSession, number, mediaUrl, caption);
+    },
+
+    /**
+     * Cek status session WhatsApp
+     * @param {string} [sessionId] - Session ID (default: session dari config)
+     */
+    async getStatus(sessionId = null) {
+      const targetSession = sessionId || config.sessionId;
+      return http.getSessionStatus(targetSession);
+    },
+
+    /**
+     * Daftar semua session
+     */
+    async listSessions() {
+      return http.getSessions();
+    },
+
+    /**
+     * Register webhook untuk terima pesan masuk
+     * @param {string} webhookUrl - URL endpoint webhook Anda
+     * @param {Array} [events] - Event yang didengar (default: ['messages.upsert'])
+     */
+    async registerWebhook(webhookUrl, events = ['messages.upsert']) {
+      return http.registerWebhook(webhookUrl, events);
+    }
+  };
+}
+
+module.exports = createClient;

package/src/core/http-client.js

@@ -0,0 +1,71 @@
+const axios = require('axios');
+
+/**
+ * HTTP Client untuk Andi WA Gateway
+ * File ini handle semua HTTP request ke API
+ */
+
+function createHttpClient(config) {
+  const instance = axios.create({
+    baseURL: `${config.baseUrl}/api`,
+    headers: {
+      'Authorization': `x-api-key ${config.apiKey}`,
+      'Content-Type': 'application/json'
+    },
+    timeout: 30000
+  });
+
+  return {
+    async sendMessage(sessionId, number, message) {
+      const response = await instance.post('/messages/send', {
+        sessionId,
+        number: formatNumber(number),
+        message
+      });
+      return response.data;
+    },
+
+    async sendMedia(sessionId, number, mediaUrl, caption = '') {
+      const response = await instance.post('/messages/send-media', {
+        sessionId,
+        number: formatNumber(number),
+        mediaUrl,
+        caption
+      });
+      return response.data;
+    },
+
+    async getSessionStatus(sessionId) {
+      const response = await instance.get(`/session/status/${sessionId}`);
+      return response.data;
+    },
+
+    async getSessions() {
+      const response = await instance.get('/sessions');
+      return response.data;
+    },
+
+    async registerWebhook(url, events = ['messages.upsert']) {
+      const response = await instance.post('/webhook/register', {
+        url,
+        events
+      });
+      return response.data;
+    },
+
+    async getApiKeys() {
+      const response = await instance.get('/keys');
+      return response.data;
+    }
+  };
+}
+
+function formatNumber(number) {
+  let clean = String(number).replace(/[\s\+-]/g, '');
+  if (clean.startsWith('0')) {
+    clean = '62' + clean.substring(1);
+  }
+  return clean;
+}
+
+module.exports = createHttpClient;

package/src/index.js

@@ -0,0 +1,78 @@
+/**
+ * Andi WA Gateway SDK
+ * Official SDK untuk integrasi dengan Andi WA Gateway
+ * 
+ * Usage:
+ * const sdk = require('andi-wa-gateway-sdk');
+ * const wa = sdk.createClient({ apiKey: 'your-api-key' });
+ * await wa.sendMessage('628123456789', 'Hello!');
+ */
+
+const createClient = require('./core/client');
+const createOtpPlugin = require('./plugins/otp');
+const createWebhookHandler = require('./webhook/handler');
+
+const DEFAULT_BASE_URL = 'https://andi-wa-gateway.up.railway.app';
+
+/**
+ * Create SDK Client
+ * @param {Object} config
+ * @param {string} config.apiKey - API Key dari Andi WA Gateway Panel
+ * @param {string} [config.baseUrl] - Optional: Override base URL (default: https://andi-wa-gateway.up.railway.app)
+ * @param {string} [config.sessionId] - Default session ID untuk kirim pesan
+ * @returns {Object} SDK Client instance
+ */
+function createClient(config = {}) {
+  if (!config.apiKey) {
+    throw new Error('API Key wajib diisi. Dapatkan dari Panel Andi WA Gateway.');
+  }
+
+  const finalConfig = {
+    baseUrl: config.baseUrl || DEFAULT_BASE_URL,
+    apiKey: config.apiKey,
+    sessionId: config.sessionId || 'default-session'
+  };
+
+  return createClient(finalConfig);
+}
+
+/**
+ * Create OTP Plugin
+ * @param {Object} config
+ * @param {string} config.apiKey - API Key
+ * @param {string} [config.sessionId] - Session ID
+ * @returns {Object} OTP Plugin instance
+ */
+function createOtp(config = {}) {
+  if (!config.apiKey) {
+    throw new Error('API Key wajib diisi.');
+  }
+
+  const finalConfig = {
+    baseUrl: config.baseUrl || DEFAULT_BASE_URL,
+    apiKey: config.apiKey,
+    sessionId: config.sessionId || 'default-session'
+  };
+
+  return createOtpPlugin(finalConfig);
+}
+
+/**
+ * Create Webhook Handler
+ * @param {Object} config
+ * @param {string} [config.secret] - Webhook secret untuk verifikasi
+ * @returns {Object} Webhook Handler instance
+ */
+function createWebhook(config = {}) {
+  return createWebhookHandler(config);
+}
+
+module.exports = {
+  createClient,
+  createOtp,
+  createWebhook,
+  DEFAULT_BASE_URL,
+  // Export webhook constants untuk akses mudah
+  WEBHOOK_EVENTS: createWebhookHandler.WEBHOOK_EVENTS,
+  PAYLOAD_PARSERS: createWebhookHandler.PAYLOAD_PARSERS
+};

package/src/plugins/otp.js

@@ -0,0 +1,105 @@
+const createHttpClient = require('../core/http-client');
+
+/**
+ * OTP Plugin untuk Andi WA Gateway
+ * Plugin khusus untuk mengirim kode OTP/verifikasi
+ */
+
+function createOtpPlugin(config) {
+  const http = createHttpClient(config);
+
+  return {
+    config,
+
+    /**
+     * Generate kode OTP random
+     * @param {number} [length] - Panjang kode (default: 6)
+     * @returns {string} Kode OTP
+     */
+    generateCode(length = 6) {
+      const digits = '0123456789';
+      let code = '';
+      for (let i = 0; i < length; i++) {
+        code += digits[Math.floor(Math.random() * digits.length)];
+      }
+      return code;
+    },
+
+    /**
+     * Format pesan OTP (bisa di-override)
+     * @param {string} code - Kode OTP
+     * @param {string} [appName] - Nama aplikasi
+     * @returns {string} Pesan yang diformat
+     */
+    formatMessage(code, appName = 'Aplikasi') {
+      return `Kode verifikasi ${appName}: ${code}\n\n` +
+             `Jangan berikan kode ini kepada siapapun.\n` +
+             `Kode berlaku 5 menit.`;
+    },
+
+    /**
+     * Kirim OTP ke nomor WhatsApp
+     * @param {string} number - Nomor tujuan
+     * @param {Object} [options]
+     * @param {string} [options.code] - Kode OTP (auto-generate jika tidak diisi)
+     * @param {string} [options.appName] - Nama aplikasi untuk pesan
+     * @param {string} [options.sessionId] - Override session ID
+     * @returns {Promise<Object>} Response dari API + kode yang dikirim
+     */
+    async send(number, options = {}) {
+      const code = options.code || this.generateCode();
+      const message = this.formatMessage(code, options.appName);
+      const sessionId = options.sessionId || config.sessionId;
+
+      const response = await http.sendMessage(sessionId, number, message);
+
+      return {
+        ...response,
+        code,  // Return kode untuk disimpan di database
+        number: formatNumber(number)
+      };
+    },
+
+    /**
+     * Kirim OTP dengan template custom
+     * @param {string} number - Nomor tujuan
+     * @param {string} template - Template pesan dengan placeholder {code}
+     * @param {Object} [options]
+     * @param {string} [options.code] - Kode OTP
+     * @param {string} [options.sessionId] - Override session ID
+     */
+    async sendWithTemplate(number, template, options = {}) {
+      const code = options.code || this.generateCode();
+      const message = template.replace(/{code}/g, code);
+      const sessionId = options.sessionId || config.sessionId;
+
+      const response = await http.sendMessage(sessionId, number, message);
+
+      return {
+        ...response,
+        code,
+        number: formatNumber(number)
+      };
+    },
+
+    /**
+     * Verify kode OTP (logic di sisi client/database)
+     * @param {string} inputCode - Kode yang diinput user
+     * @param {string} storedCode - Kode yang tersimpan di database
+     * @returns {boolean} Valid atau tidak
+     */
+    verify(inputCode, storedCode) {
+      return String(inputCode) === String(storedCode);
+    }
+  };
+}
+
+function formatNumber(number) {
+  let clean = String(number).replace(/[\s\+-]/g, '');
+  if (clean.startsWith('0')) {
+    clean = '62' + clean.substring(1);
+  }
+  return clean;
+}
+
+module.exports = createOtpPlugin;

package/src/webhook/handler.js

@@ -0,0 +1,625 @@
+/**
+ * Webhook Handler untuk Andi WA Gateway
+ * 
+ * Menangani 35 Event Webhook dengan 63+ Field Payload
+ * Kategori Event:
+ * - Pesan & Media (8 event)
+ * - Kontak & Profil (3 event)
+ * - Chat & Grup (11 event)
+ * - Notifikasi & Status (3 event)
+ * - Session & Koneksi (6 event)
+ * - Blocklist & Broadcast (2 event)
+ * - Newsletter & Community (2 event)
+ * - Payment (1 event)
+ */
+
+// ============================================================================
+// WEBHOOK EVENT CONSTANTS (35 Events)
+// ============================================================================
+
+const WEBHOOK_EVENTS = {
+  // Pesan & Media (8 events)
+  MESSAGES_UPSERT: 'messages.upsert',
+  MESSAGE_STATUS: 'message.status',
+  MESSAGE_REACTION: 'message.reaction',
+  MESSAGE_POLL_VOTE: 'message.poll_vote',
+  MESSAGE_EDIT: 'message.edit',
+  MESSAGE_REVOKE: 'message.revoke',
+  MESSAGE_DELETE: 'message.delete',
+  MESSAGE_HISTORY_SYNC: 'message.history_sync',
+
+  // Kontak & Profil (3 events)
+  CONTACT_UPSERT: 'contact.upsert',
+  CONTACT_UPDATE: 'contact.update',
+  PRESENCE_UPDATE: 'presence.update',
+
+  // Chat & Grup (11 events)
+  CHAT_UPSERT: 'chat.upsert',
+  CHAT_UPDATE: 'chat.update',
+  CHAT_PIN: 'chat.pin',
+  CHAT_UNPIN: 'chat.unpin',
+  CHAT_ARCHIVE: 'chat.archive',
+  CHAT_UNARCHIVE: 'chat.unarchive',
+  GROUP_PARTICIPANTS: 'group.participants',
+  GROUP_UPDATE: 'group.update',
+  GROUP_MEMBERSHIP_REQUEST: 'group.membership_request',
+  GROUP_JOIN: 'group.join',
+  GROUP_LEAVE: 'group.leave',
+
+  // Notifikasi & Status (3 events)
+  CALL_NOTIFICATION: 'call.notification',
+  STATUS_UPDATE: 'status.update',
+  LABELS_UPDATE: 'labels.update',
+
+  // Session & Koneksi (6 events)
+  CONNECTION_UPDATE: 'connection.update',
+  CREDS_UPDATE: 'creds.update',
+  QR_GENERATED: 'qr.generated',
+  SESSION_LOGOUT: 'session.logout',
+  SYNC_REQUIRED: 'sync.required',
+  MESSAGE_MEDIA_DOWNLOAD: 'message.media_download',
+
+  // Blocklist & Broadcast (2 events)
+  BLOCKLIST_UPDATE: 'blocklist.update',
+  BROADCAST_UPDATE: 'broadcast.update',
+
+  // Newsletter & Community (2 events)
+  NEWSLETTER_UPDATE: 'newsletter.update',
+  COMMUNITY_UPDATE: 'community.update',
+
+  // Payment (1 event)
+  PAYMENT_UPDATE: 'payment.update'
+};
+
+// ============================================================================
+// PAYLOAD PARSER - 63+ Field Support
+// ============================================================================
+
+/**
+ * Parse payload messages.upsert (Pesan Masuk)
+ * Field yang tersedia: 25+ field
+ */
+function parseMessagePayload(data) {
+  return {
+    // Identitas
+    sessionId: data.sessionId,
+    device_id: data.device_id,
+    device: data.device,
+    
+    // Pengirim
+    from: data.from,
+    participant: data.participant,
+    push_name: data.push_name,
+    
+    // Pesan
+    message_id: data.message_id,
+    message_type: data.message_type,
+    message: data.message,
+    
+    // Chat Info
+    chat_type: data.chat_type,
+    is_group: data.is_group,
+    is_me: data.is_me,
+    
+    // Status Pesan
+    is_view_once: data.is_view_once,
+    is_ephemeral: data.is_ephemeral,
+    is_business: data.is_business,
+    is_marketing_keyword: data.is_marketing_keyword,
+    is_mentioned: data.is_mentioned,
+    
+    // Media/File
+    file: data.file, // { type, mimetype, fileName, fileSize, caption }
+    
+    // Mentions & Quotes
+    mentioned_jids: data.mentioned_jids || [],
+    quoted_message: data.quoted_message,
+    
+    // Timestamp
+    timestamp: data.timestamp,
+    datetime: data.timestamp ? new Date(data.timestamp * 1000) : null
+  };
+}
+
+/**
+ * Parse payload message.status (Status Pesan)
+ * Field: message_id, from, status, timestamp
+ */
+function parseMessageStatusPayload(data) {
+  return {
+    message_id: data.message_id,
+    from: data.from,
+    status: data.status, // 'pending', 'sent', 'delivered', 'read', 'played'
+    timestamp: data.timestamp,
+    datetime: data.timestamp ? new Date(data.timestamp) : null
+  };
+}
+
+/**
+ * Parse payload presence.update (Status Online/Typing)
+ */
+function parsePresencePayload(data) {
+  return {
+    id: data.id,
+    presence: data.presence?.lastKnownPresence, // 'composing', 'recording', 'available', 'unavailable'
+    timestamp: data.timestamp
+  };
+}
+
+/**
+ * Parse payload group.participants (Perubahan Anggota Grup)
+ */
+function parseGroupParticipantsPayload(data) {
+  return {
+    group_id: data.group_id,
+    action: data.action, // 'add', 'remove', 'promote', 'demote'
+    participants: data.participants || [],
+    by: data.by, // Siapa yang melakukan aksi
+    timestamp: data.timestamp
+  };
+}
+
+/**
+ * Parse payload group.update (Update Info Grup)
+ */
+function parseGroupUpdatePayload(data) {
+  return {
+    group_id: data.group_id,
+    subject: data.subject, // Nama grup baru
+    description: data.description,
+    owner: data.owner,
+    participants_count: data.participants_count,
+    timestamp: data.timestamp
+  };
+}
+
+/**
+ * Parse payload connection.update (Status Koneksi)
+ */
+function parseConnectionPayload(data) {
+  return {
+    connection: data.connection, // 'connecting', 'open', 'close', 'error'
+    isNewLogin: data.isNewLogin,
+    qr: data.qr, // QR string jika ada
+    receivedPendingNotifications: data.receivedPendingNotifications,
+    timestamp: data.timestamp
+  };
+}
+
+/**
+ * Parse payload payment.update (Pembayaran)
+ */
+function parsePaymentPayload(data) {
+  return {
+    payment_id: data.payment_id,
+    status: data.status, // 'pending', 'completed', 'failed'
+    amount: data.amount,
+    currency: data.currency,
+    sender: data.sender,
+    receiver: data.receiver,
+    timestamp: data.timestamp
+  };
+}
+
+/**
+ * Parse payload call.notification (Panggilan)
+ */
+function parseCallPayload(data) {
+  return {
+    call_id: data.call_id,
+    from: data.from,
+    isVideo: data.isVideo,
+    isGroupCall: data.isGroupCall,
+    status: data.status, // 'offer', 'accept', 'reject', 'timeout'
+    timestamp: data.timestamp
+  };
+}
+
+/**
+ * Parse payload contact.update (Update Kontak)
+ */
+function parseContactPayload(data) {
+  return {
+    id: data.id,
+    name: data.name,
+    notify: data.notify,
+    imgUrl: data.imgUrl,
+    status: data.status,
+    timestamp: data.timestamp
+  };
+}
+
+// ============================================================================
+// MAIN WEBHOOK HANDLER
+// ============================================================================
+
+function createWebhookHandler(config = {}) {
+  const handlers = new Map();
+  const middlewares = [];
+
+  const handler = {
+    config,
+
+    // ========================================================================
+    // EVENT REGISTRATION
+    // ========================================================================
+
+    /**
+     * Register handler untuk event tertentu
+     * @param {string} event - Nama event dari WEBHOOK_EVENTS
+     * @param {Function} handler - Function handler (parsedPayload, rawPayload) => void
+     */
+    on(event, handler) {
+      if (!handlers.has(event)) {
+        handlers.set(event, []);
+      }
+      handlers.get(event).push(handler);
+      return this; // Chainable
+    },
+
+    /**
+     * Register multiple handlers sekaligus
+     * @param {Object} handlersMap - { event: handler }
+     */
+    onMany(handlersMap) {
+      Object.entries(handlersMap).forEach(([event, handler]) => {
+        this.on(event, handler);
+      });
+      return this;
+    },
+
+    /**
+     * Remove handler untuk event
+     */
+    off(event, handlerToRemove) {
+      if (handlers.has(event)) {
+        const eventHandlers = handlers.get(event);
+        const index = eventHandlers.indexOf(handlerToRemove);
+        if (index > -1) {
+          eventHandlers.splice(index, 1);
+        }
+      }
+      return this;
+    },
+
+    // ========================================================================
+    // CORE PROCESSING
+    // ========================================================================
+
+    /**
+     * Parse payload berdasarkan event type
+     */
+    parsePayload(event, data) {
+      switch (event) {
+        case WEBHOOK_EVENTS.MESSAGES_UPSERT:
+          return parseMessagePayload(data);
+        case WEBHOOK_EVENTS.MESSAGE_STATUS:
+          return parseMessageStatusPayload(data);
+        case WEBHOOK_EVENTS.PRESENCE_UPDATE:
+          return parsePresencePayload(data);
+        case WEBHOOK_EVENTS.GROUP_PARTICIPANTS:
+          return parseGroupParticipantsPayload(data);
+        case WEBHOOK_EVENTS.GROUP_UPDATE:
+          return parseGroupUpdatePayload(data);
+        case WEBHOOK_EVENTS.CONNECTION_UPDATE:
+          return parseConnectionPayload(data);
+        case WEBHOOK_EVENTS.PAYMENT_UPDATE:
+          return parsePaymentPayload(data);
+        case WEBHOOK_EVENTS.CALL_NOTIFICATION:
+          return parseCallPayload(data);
+        case WEBHOOK_EVENTS.CONTACT_UPSERT:
+        case WEBHOOK_EVENTS.CONTACT_UPDATE:
+          return parseContactPayload(data);
+        default:
+          return data; // Return as-is untuk event lain
+      }
+    },
+
+    /**
+     * Process webhook payload
+     */
+    async process(rawPayload) {
+      const event = rawPayload.event || WEBHOOK_EVENTS.MESSAGES_UPSERT;
+      const data = rawPayload.data || rawPayload;
+      
+      // Parse payload sesuai event type
+      const parsedPayload = this.parsePayload(event, data);
+      
+      // Jalankan middlewares
+      for (const mw of middlewares) {
+        await mw(parsedPayload, rawPayload, event);
+      }
+      
+      // Jalankan event handlers
+      const eventHandlers = handlers.get(event) || [];
+      const results = [];
+      
+      for (const handler of eventHandlers) {
+        try {
+          const result = await handler(parsedPayload, rawPayload);
+          results.push({ success: true, result });
+        } catch (err) {
+          results.push({ success: false, error: err.message });
+        }
+      }
+
+      return { 
+        event, 
+        processed: results.length, 
+        results,
+        parsed: parsedPayload 
+      };
+    },
+
+    // ========================================================================
+    // EXPRESS MIDDLEWARE
+    // ========================================================================
+
+    /**
+     * Express/Fastify middleware
+     */
+    middleware() {
+      return async (req, res, next) => {
+        try {
+          // Verify secret jika di-configure
+          if (config.secret) {
+            const secret = req.headers['x-webhook-secret'];
+            if (secret !== config.secret) {
+              return res.status(401).json({ 
+                error: 'Invalid webhook secret',
+                code: 'UNAUTHORIZED'
+              });
+            }
+          }
+
+          // Verify signature jika di-configure
+          if (config.verifySignature && config.signatureKey) {
+            const signature = req.headers['x-signature'];
+            // TODO: Implement signature verification
+          }
+
+          const rawPayload = req.body;
+          
+          // Validasi payload
+          if (!rawPayload || typeof rawPayload !== 'object') {
+            return res.status(400).json({
+              error: 'Invalid payload',
+              code: 'BAD_REQUEST'
+            });
+          }
+
+          // Process
+          const result = await this.process(rawPayload);
+
+          res.json({ 
+            success: true, 
+            processed: result.processed,
+            event: result.event
+          });
+        } catch (err) {
+          if (next) {
+            next(err);
+          } else {
+            res.status(500).json({
+              error: err.message,
+              code: 'INTERNAL_ERROR'
+            });
+          }
+        }
+      };
+    },
+
+    /**
+     * Add middleware
+     */
+    use(middleware) {
+      middlewares.push(middleware);
+      return this;
+    },
+
+    // ========================================================================
+    // CONVENIENCE HANDLERS (Shortcuts)
+    // ========================================================================
+
+    /**
+     * Handler untuk pesan masuk (messages.upsert)
+     * @param {Function} handler - (message) => void
+     */
+    onMessage(handler) {
+      this.on(WEBHOOK_EVENTS.MESSAGES_UPSERT, (parsed, raw) => {
+        handler(parsed, raw);
+      });
+      return this;
+    },
+
+    /**
+     * Handler untuk pesan teks saja (filter media)
+     */
+    onTextMessage(handler) {
+      this.on(WEBHOOK_EVENTS.MESSAGES_UPSERT, (parsed, raw) => {
+        if (parsed.message_type === 'text' && !parsed.is_me) {
+          handler(parsed, raw);
+        }
+      });
+      return this;
+    },
+
+    /**
+     * Handler untuk media (image, video, audio, document)
+     */
+    onMedia(handler) {
+      const mediaTypes = ['image', 'video', 'audio', 'document', 'sticker'];
+      this.on(WEBHOOK_EVENTS.MESSAGES_UPSERT, (parsed, raw) => {
+        if (mediaTypes.includes(parsed.message_type) && !parsed.is_me) {
+          handler(parsed, raw);
+        }
+      });
+      return this;
+    },
+
+    /**
+     * Handler untuk grup message saja
+     */
+    onGroupMessage(handler) {
+      this.on(WEBHOOK_EVENTS.MESSAGES_UPSERT, (parsed, raw) => {
+        if (parsed.is_group && !parsed.is_me) {
+          handler(parsed, raw);
+        }
+      });
+      return this;
+    },
+
+    /**
+     * Handler untuk private message saja
+     */
+    onPrivateMessage(handler) {
+      this.on(WEBHOOK_EVENTS.MESSAGES_UPSERT, (parsed, raw) => {
+        if (!parsed.is_group && !parsed.is_me) {
+          handler(parsed, raw);
+        }
+      });
+      return this;
+    },
+
+    /**
+     * Handler untuk status pesan (sent/delivered/read)
+     */
+    onStatusUpdate(handler) {
+      this.on(WEBHOOK_EVENTS.MESSAGE_STATUS, handler);
+      return this;
+    },
+
+    /**
+     * Handler untuk pesan diterima (delivered)
+     */
+    onDelivered(handler) {
+      this.on(WEBHOOK_EVENTS.MESSAGE_STATUS, (parsed, raw) => {
+        if (parsed.status === 'delivered') {
+          handler(parsed, raw);
+        }
+      });
+      return this;
+    },
+
+    /**
+     * Handler untuk pesan dibaca (read)
+     */
+    onRead(handler) {
+      this.on(WEBHOOK_EVENTS.MESSAGE_STATUS, (parsed, raw) => {
+        if (parsed.status === 'read') {
+          handler(parsed, raw);
+        }
+      });
+      return this;
+    },
+
+    /**
+     * Handler untuk kontak sedang mengetik
+     */
+    onTyping(handler) {
+      this.on(WEBHOOK_EVENTS.PRESENCE_UPDATE, (parsed, raw) => {
+        if (parsed.presence === 'composing') {
+          handler(parsed, raw);
+        }
+      });
+      return this;
+    },
+
+    /**
+     * Handler untuk perubahan grup
+     */
+    onGroupUpdate(handler) {
+      this.on(WEBHOOK_EVENTS.GROUP_UPDATE, handler);
+      return this;
+    },
+
+    /**
+     * Handler untuk member join/leave grup
+     */
+    onGroupParticipants(handler) {
+      this.on(WEBHOOK_EVENTS.GROUP_PARTICIPANTS, handler);
+      return this;
+    },
+
+    /**
+     * Handler untuk perubahan koneksi
+     */
+    onConnectionUpdate(handler) {
+      this.on(WEBHOOK_EVENTS.CONNECTION_UPDATE, handler);
+      return this;
+    },
+
+    /**
+     * Handler untuk QR code generated
+     */
+    onQR(handler) {
+      this.on(WEBHOOK_EVENTS.QR_GENERATED, handler);
+      return this;
+    },
+
+    /**
+     * Handler untuk incoming call
+     */
+    onCall(handler) {
+      this.on(WEBHOOK_EVENTS.CALL_NOTIFICATION, handler);
+      return this;
+    },
+
+    /**
+     * Handler untuk payment update
+     */
+    onPayment(handler) {
+      this.on(WEBHOOK_EVENTS.PAYMENT_UPDATE, handler);
+      return this;
+    },
+
+    /**
+     * Handler untuk kontak update
+     */
+    onContactUpdate(handler) {
+      this.on(WEBHOOK_EVENTS.CONTACT_UPDATE, handler);
+      return this;
+    },
+
+    // ========================================================================
+    // EXPRESS ROUTER
+    // ========================================================================
+
+    /**
+     * Create Express router dengan endpoint siap pakai
+     */
+    createRouter() {
+      const express = require('express');
+      const router = express.Router();
+      
+      router.post('/', this.middleware());
+      
+      // Health check endpoint
+      router.get('/health', (req, res) => {
+        res.json({ status: 'ok', handler: 'andi-wa-gateway-webhook' });
+      });
+      
+      return router;
+    }
+  };
+
+  return handler;
+}
+
+// ============================================================================
+// EXPORTS
+// ============================================================================
+
+module.exports = createWebhookHandler;
+module.exports.WEBHOOK_EVENTS = WEBHOOK_EVENTS;
+module.exports.PAYLOAD_PARSERS = {
+  parseMessagePayload,
+  parseMessageStatusPayload,
+  parsePresencePayload,
+  parseGroupParticipantsPayload,
+  parseGroupUpdatePayload,
+  parseConnectionPayload,
+  parsePaymentPayload,
+  parseCallPayload,
+  parseContactPayload
+};