@fazzcode/baileys 2.5.4 → 2.5.6

package/README.MD

@@ -40,7 +40,31 @@
 
 ## 🔧 Requirement
 
-- **Node.js** >= 20.0.0 (direkomendasikan LTS terbaru)
+### Versi Node.js yang Didukung
+
+| Versi Node.js | Status | Catatan |
+|---|---|---|
+| < 20.0.0 | ❌ Tidak didukung | ESM & fitur JS modern yang dipakai library ini butuh minimal v20 |
+| 20.x (LTS) | ✅ Didukung | Minimum version, paling stabil untuk produksi |
+| 22.x (LTS) | ✅ Didukung | Direkomendasikan |
+| 23.x | ✅ Didukung | |
+| 24.x (LTS) | ✅ Didukung | |
+| 25.x / 26.x dan seterusnya | ✅ Didukung | Versi Current/terbaru, selama masih kompatibel dengan ESM Node standar |
+
+Singkatnya: **selama Node.js >= 20.0.0, baik versi LTS maupun Current/terbaru, library ini bisa dipakai.** Tidak ada batas atas versi — cukup pastikan minimal v20 karena `package.json` menggunakan `"type": "module"` dan sintaks ES2022+.
+
+Cek versi Node.js yang terpasang:
+
+```bash
+node -v
+```
+
+Kalau masih di bawah v20 (misalnya v16/v18), update Node.js dulu sebelum install package ini. Di Termux (Android) bisa update dengan:
+
+```bash
+pkg update && pkg upgrade nodejs
+```
+
 - **npm** atau **yarn**
 - **WhatsApp Account** (hanya 1 account per instance)
 - **System Requirements**:
@@ -66,17 +90,16 @@ yarn add @fazzcode/baileys
 
 ### Dependency Tambahan (Optional)
 
+`jimp` sudah otomatis terpasang sebagai dependency utama (dibutuhkan untuk crop gambar profil), jadi tidak perlu diinstal manual. Yang masih opsional hanya:
+
 ```bash
 # Untuk link preview
 npm install link-preview-js
 
-# Untuk image processing
-npm install jimp@latest
-
-# Untuk audio processing
+# Untuk audio processing (durasi audio, dsb)
 npm install audio-decode
 
-# Logging
+# Logging (pino sudah ikut terpasang otomatis, opsional kalau mau versi/konfigurasi sendiri)
 npm install pino
 ```
 
@@ -879,6 +902,56 @@ await sock.groupParticipantsUpdate(
 
 ## ⚠️ Error Handling
 
+### Troubleshooting Instalasi (Cannot find module)
+
+Kalau muncul error seperti ini saat menjalankan bot:
+
+```
+Error: Cannot find module '@protobufjs/inquire'
+Require stack:
+- node_modules/libsignal-xeuka/node_modules/protobufjs/...
+```
+
+atau error `Cannot find module` lain yang nyebut folder di dalam `node_modules/<package-lain>/node_modules/...`, itu artinya **instalasi `node_modules` tidak lengkap/corrupt** — biasanya karena koneksi putus saat `npm install`, atau (sering terjadi di Termux/Android) penyimpanan eksternal (`/storage/emulated/0/...`) yang bermasalah saat npm menulis banyak file kecil bersarang.
+
+**Solusi (install ulang bersih):**
+
+```bash
+# 1. Hapus instalasi yang rusak
+rm -rf node_modules package-lock.json
+
+# 2. Bersihkan cache npm
+npm cache clean --force
+
+# 3. Install ulang
+npm install
+```
+
+**Khusus pengguna Termux/Android**, kalau masih sering gagal di tengah jalan, coba install di internal storage Termux dulu (lebih stabil daripada `/storage/emulated/0/...`), baru pindahkan foldernya kalau perlu:
+
+```bash
+cd ~        # masuk ke home Termux, bukan /storage/emulated/0
+mkdir -p project && cd project
+npm install @fazzcode/baileys
+```
+
+Pastikan juga koneksi internet stabil selama proses install karena beberapa dependency (terutama yang diambil dari GitHub seperti `libsignal-xeuka`) butuh proses clone/download yang agak besar.
+
+### Troubleshooting "Connection Closed" / Koneksi Tidak Mau Tersambung
+
+Kalau koneksi terus-terusan putus sebelum berhasil login/pairing (baik muncul error `Connection Closed` maupun cuma diam tanpa respons), berarti koneksi WebSocket ke server WhatsApp gagal terbentuk. Penyebab paling umum:
+
+- **Internet tidak stabil** atau koneksi terlalu lambat saat proses handshake awal
+- **Firewall/ISP/provider data** memblokir akses ke `web.whatsapp.com` (lumayan sering terjadi di beberapa jaringan kampus/kantor/operator seluler tertentu)
+- **VPN/Proxy** yang dipakai memblokir atau memodifikasi traffic WebSocket
+
+Cara cek & atasi:
+
+1. Pastikan kamu bisa akses `https://web.whatsapp.com` lewat browser di perangkat yang sama.
+2. Kalau pakai VPN/proxy, coba matikan dulu lalu jalankan ulang bot.
+3. Coba ganti jaringan (misal dari WiFi ke data seluler, atau sebaliknya) untuk memastikan bukan masalah jaringan spesifik.
+4. Library ini sudah dilengkapi penanganan kalau server membalas dengan response HTTP yang tidak terduga (misalnya diblokir oleh jaringan), jadi error akan langsung ditampilkan dengan jelas alih-alih bot diam tanpa sebab — perhatikan kode status yang muncul di log untuk diagnosis lebih lanjut.
+
 ### Basic Error Handling
 
 ```javascript

package/lib/Socket/socket.js

@@ -640,6 +640,18 @@ const toPn = async (pn) => {
   });
   ws.on("error", mapWebSocketError(end));
   ws.on("close", () => end(new Boom("Connection Terminated", { statusCode: DisconnectReason.connectionClosed })));
+  ws.on("unexpected-response", (req, res) => {
+    const statusCode = res?.statusCode || DisconnectReason.connectionClosed;
+    const denyReason = res?.headers?.["x-deny-reason"];
+    logger.error({ statusCode, denyReason }, "unexpected (non-websocket) response received during handshake");
+    try {
+      res?.resume?.();
+    }
+    catch {
+      // ignore, just making sure the socket isn't left dangling
+    }
+    end(new Boom(`Unexpected server response: ${statusCode}`, { statusCode: DisconnectReason.connectionClosed, data: { httpStatusCode: statusCode, denyReason } }));
+  });
   ws.on("CB:xmlstreamend", () => end(new Boom("Connection Terminated by Server", { statusCode: DisconnectReason.connectionClosed })));
   ws.on("CB:iq,type:set,pair-device", async (stanza) => {
     const iq = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fazzcode/baileys",
-  "version": "2.5.4",
+  "version": "2.5.6",
   "description": "Websocket Whatsapp API for Node.js",
   "keywords": [
     "whatsapp",
@@ -35,7 +35,6 @@
     "changelog:update": "conventional-changelog -p angular -i CHANGELOG.md -s -r 0",
     "changelog:preview": "conventional-changelog -p angular -u",
     "changelog:last": "conventional-changelog -p angular -r 2",
-    "gen:protobuf": "sh WAProto/GenerateStatics.sh",
     "example": "node --inspect Example/example.js",
     "lint": "eslint src --ext .js",
     "lint:fix": "yarn lint --fix",
@@ -44,13 +43,13 @@
   },
   "dependencies": {
     "@cacheable/node-cache": "*",
-    "libsignal-xeuka": "github:tskiofc/libsignal",
+    "libsignal-xeuka": "github:tskiofc/libsignal#250643990ae58c9e16dcfb34b1c8feaf7da41b06",
     "music-metadata": "*",
     "cache-manager": "*",
     "async-mutex": "*",
     "@hapi/boom": "*",
     "jimp": "*",
-    "protobufjs": "*",
+    "protobufjs": "7.5.0",
     "lru-cache": "*",
     "p-queue": "*",
     "axios": "*",
@@ -62,7 +61,6 @@
     "@whiskeysockets/eslint-config": "github:whiskeysockets/eslint-config",
     "conventional-changelog-cli": "*",
     "link-preview-js": "*",
-    "protobufjs-cli": "*",
     "@types/jest": "*",
     "@types/node": "*",
     "release-it": "*",