Logo JAPofc # @japofc/baileys ### โšก WhatsApp Web API yang dirawat serius untuk Node.js ESM typed ยท versi WA Web selalu terkini ยท tooling protokol aman ยท 140+ utilitas bot siap produksi

versi npm unduhan npm lisensi MIT

Node >=20 ESM only tipe TypeScript tes lulus audit bersih

Channel WhatsApp JAPofc

[๐Ÿ“ฆ Instalasi](#instalasi) ยท [๐Ÿš€ Mulai cepat](#mulai-cepat) ยท [๐Ÿ”ฅ Fitur](#-fitur) ยท [๐Ÿ’ก Contoh](#-contoh-pemakaian) ยท [๐Ÿ“˜ TypeScript](#-dukungan-typescript) ยท [โ“ FAQ](#-faq--troubleshooting) ยท [๐Ÿ‡ฌ๐Ÿ‡ง English](./README.md)

---
### ๐Ÿ”Œ Inti yang andal Socket stabil, resolusi versi WA-Web otomatis, toolkit reconnect + anti-ban โ€” **tanpa efek samping tersembunyi**. ### ๐Ÿงฉ Lengkap sejak awal Tombol, native flow, carousel, kartu AIRich, poll, channel, VoIP, dan **140+ utilitas bot**. ### ๐Ÿ›ก๏ธ Siap produksi `.d.ts` bawaan, auth multi-backend, redaksi kredensial, session tools โ€” **1513 tes, 0 kerentanan**.
๐Ÿ“‘ Daftar isi โ€” klik untuk buka
> **Mulai**  โ€บ  [Instalasi](#instalasi) ยท [Mulai cepat](#mulai-cepat) ยท [Ringkasan](#ringkasan) ยท [Instalasi lengkap](#-instalasi) ยท [Autentikasi](#-autentikasi) ยท [Backend store](#-backend-store) > > **Isi paket**  โ€บ  [Perbandingan](#-perbandingan) ยท [Fitur](#-fitur) ยท [Peningkatan eksklusif J.AP](#-peningkatan-eksklusif-jap) ยท [Baru di v2.4.5](#-baru-di-v245) > > **Pesan**  โ€บ  [Contoh pemakaian](#-contoh-pemakaian) ยท [Helper pesan](#-helper-pesan) ยท [Channel, riwayat & transkrip](#-channel-riwayat--transkrip) ยท [Kejar-tayang WA 2026](#-kejar-tayang-wa-2026) > > **Panggilan & sync**  โ€บ  [Panggilan suara & video](#-panggilan-suara--video) ยท [Query sinkronisasi user](#-query-sinkronisasi-user) ยท [Manajemen username](#-manajemen-username) > > **Toolkit**  โ€บ  [Utilitas sehari-hari](#-utilitas-sehari-hari) ยท [Paket keamanan](#-paket-keamanan) ยท [Bot framework](#-bot-framework) ยท [Modul utilitas](#-modul-utilitas) > > **Referensi**  โ€บ  [Lingkungan yang direkomendasikan](#-lingkungan-yang-direkomendasikan) ยท [Dukungan TypeScript](#-dukungan-typescript) ยท [FAQ & troubleshooting](#-faq--troubleshooting) ยท [Kontribusi](#-kontribusi) ยท [Kredit](#-kredit) ยท [Maintainer](#-maintainer)
--- ## Instalasi ```bash npm i @japofc/baileys ``` Butuh Node.js 20+. Package ini ESM-only dan tidak memakai install/postinstall script. ## Mulai cepat ```js import makeWASocket, { useMultiFileAuthState } from '@japofc/baileys' const { state, saveCreds } = await useMultiFileAuthState('auth_info') const sock = makeWASocket({ auth: state, printQRInTerminal: true }) sock.ev.on('creds.update', saveCreds) sock.ev.on('messages.upsert', async ({ messages }) => { const msg = messages[0] if (!msg?.message || msg.key.fromMe) return await sock.sendMessage(msg.key.remoteJid, { text: 'pong' }, { quoted: msg }) }) ``` ## Ringkasan `@japofc/baileys` adalah library WhatsApp Web untuk builder bot yang butuh socket stabil, deklarasi TypeScript lengkap, dan utilitas yang dirawat tanpa efek samping tersembunyi. - Fallback versi WA Web terbaru plus `makeWASocketAuto()` untuk resolusi versi live. - Deklarasi WAProto lengkap dan deep export untuk pemakaian dari package ter-install. - Backend auth file, SQLite, Redis, MongoDB, MySQL, dan PostgreSQL. - Interactive messages, native flow, carousel, AIRich, channel/newsletter, status helper, dan modul bot. - Fetch media/link lebih aman, redaksi kredensial, tool sesi, helper reconnect, dan protocol-capture. - **Tidak ada auto join/follow grup atau saluran.** Helper join/follow tetap tersedia, tapi hanya jalan kalau dipanggil eksplisit oleh kode kamu. --- ## ๐Ÿ†š Perbandingan Posisi `@japofc/baileys` dibanding library Baileys lain: | Kemampuan | `@japofc/baileys` | Fork lain (umumnya) | |---|:---:|:---:| | Tombol Native Flow (V1/V2/V3) | โœ… | โš ๏ธ sebagian | | Pesan carousel | โœ… | โŒ | | Kartu respons kaya (AIRich) | โœ… | โŒ | | Alur commerce (katalog/order/pembayaran) | โœ… | โš ๏ธ sebagian | | Panggilan suara (VoIP) | โœ… eksperimental | โŒ | | Store multi-backend (SQL/Mongo/Redis) | โœ… | โš ๏ธ sebagian | | Definisi TypeScript `.d.ts` lengkap | โœ… | โš ๏ธ sebagian | | Query sinkronisasi user (WAUSync) | โœ… | โœ… | | Manajemen username (cek/set/pin/rekomendasi) | โœ… | โŒ | | Framework bot (middleware, sesi, statistik) | โœ… | โŒ | | Render QR bawaan (terminal/SVG/PNG, nol deps) | โœ… | โŒ butuh `qrcode-terminal` | | Resolusi versi WA Web otomatis | โœ… | โŒ hardcoded | | Mention di status (notifikasi user/grup) | โœ… | โŒ | | Toolkit anti-ban (ramp pemanasan, batas aksi grup, klasifikasi disconnect, jitter Gaussian) | โœ… | โŒ | | Perisai pesan crash (bom mention, zalgo, spoof RTLO) | โœ… | โŒ | | Dokter sesi + string sesi portabel/terenkripsi | โœ… | โŒ | | Modul komunitas/bot (economy, game, sewa, moderasi โ€” 140+ utils) | โœ… | โŒ | | Branding EXIF stiker | โœ… murni JS | โš ๏ธ butuh `node-webpmux` | | CLI (`doctor` / `session` / `sticker` / `export` / `wa`) | โœ… | โŒ | | Logger dengan redaksi kredensial | โœ… | โŒ | > Tabel ini menggambarkan fitur di level package, bukan benchmark performa. PR untuk memperbarui/mengoreksi tabel ini dipersilakan lewat [Kontribusi](#-kontribusi). --- ## ๐Ÿ”ฅ Fitur
๐Ÿ’ฌ Pesan Interaktif ๐Ÿ›’ Commerce & Bisnis ๐Ÿงฉ Fitur Utilitas
- Native Flow - Tombol (V1 / V2 / V3) - List - Pesan Carousel - Pesan Poll & Kuis - Pesan Respons Kaya (AIRich) - Tombol CTA / Reply / URL - Tombol Panggilan - Tombol OTP - Tombol Autentikasi - Pesan Katalog - Detail Order - Status Order - Review & Bayar - Status Pembayaran - Metode Pembayaran - Lacak Order - Pesan Ulang - Batalkan Order - Dukungan Status Grup - Mention Semua - Dukungan Stiker Lottie - Dukungan Newsletter - Helper ExternalAdReply - Dukungan View Once - Format Teks Kaya - Highlight Kode
๐Ÿ” Auth & Penyimpanan ๐Ÿ“ž Realtime ๐Ÿ›  Tooling Developer
- Auth state multi-file - Auth state satu file - Auth state SQLite - Auth state cache-manager - Store in-memory - Adapter store SQLite / MongoDB / MySQL / PostgreSQL / Redis - Panggilan suara (VoIP, engine WASM) - Query sinkronisasi user (WAUSync) - Cek presence / status / perangkat - Event buffer untuk bot trafik tinggi - Definisi TypeScript lengkap (`.d.ts`) - Deteksi anti-delete & anti-edit (pulihkan pesan terhapus, tangkap isi sebelum edit) - Helper pencarian pesan - Engine auto-reply - Helper penjadwalan - Manajer retry pesan
--- ## โœจ Peningkatan Eksklusif J.AP ### Perbaikan Status Grup Audio Status audio memakai implementasi yang lebih kompatibel untuk menghindari error unsupported-version di klien WhatsApp lama. ### AIRich โ€” builder pesan respons kaya Builder chainable (`AIRich`, juga diekspor sebagai `AIJap` / `LeafRich` / `JapAI` / `JapRich`) dengan 40+ method `add*()`/`set*()` yang mencakup heading, teks berformat (hyperlink/sitasi/LaTeX), blok kode, tabel, kartu gambar/video/produk/post, kartu tugas & progres, banner tips, dan saran quick-reply โ€” tampilan kartu kaya yang biasanya cuma kamu lihat dari bot AI/asisten resmi. Lihat [Contoh Pemakaian](#airich--kartu-respons-kaya) di bawah. ### Ekspansi Native Flow
**Tombol & Aksi** - cta_reminder - cta_cancel_reminder - otp_button - authentication_button - call_button - url_button - reply_button - voice_call - video_call_button **Alur Commerce** - catalog_message - mpm - card_message - order_details - order_status - review_and_pay - payment_status - payment_method **Navigasi & Lainnya** - address_message - send_location - track_order - reorder - cancel_order - clear_chat - navigateToScreen - flow (field payload: flow_action)
### Filter Notifikasi Sistem Setiap pesan menyertakan: ```js message.isSystemNotification ``` Berguna untuk memfilter: - Pemberitahuan E2E - Pemberitahuan layanan Meta - Pesan lain yang dihasilkan sistem --- ## ๐Ÿ“ฆ Instalasi ```bash npm install @japofc/baileys ``` Langsung dari GitHub: ```bash npm install github:JAPofc/baileys ``` > Butuh **Node.js 20+** โ€” dicek saat import dengan pesan error yang jelas (tanpa install script: paket ini sengaja **nol** hook `preinstall`/`postinstall`, jadi `npm ci --ignore-scripts` dan kebijakan supply-chain ketat langsung jalan). > **Pindahan dari `@whiskeysockets/baileys`?** Migrasi biasanya cuma ganti satu baris import โ€” lihat [MIGRATION.md](./MIGRATION.md). ### Peer dependency opsional Semua di bawah ini **opsional** โ€” socket tetap jalan tanpa satu pun. Install hanya yang dibutuhkan fitur yang kamu pakai; yang belum terinstall akan gagal dengan petunjuk install yang jelas, bukan crash diam-diam. | Paket | Membuka fitur | |---|---| | `sharp` | Resize/proses gambar cepat (dipakai `Toolkit.resize` milik builder pesan) | | `@napi-rs/image` | Alternatif native yang lebih ringan dari `sharp` | | `jimp` | Fallback gambar pure-JS kalau dua di atas tidak terinstall | | `fluent-ffmpeg` | Konversi audio/video untuk pesan media | | `ffmpeg-static` | **Binary** ffmpeg terbundel โ€” auto-terdeteksi, nol konfigurasi (~80MB; tidak tersedia untuk Termux/Android, pakai `pkg install ffmpeg` di sana) | | `@ffmpeg-installer/ffmpeg` | Binary ffmpeg terbundel alternatif โ€” juga auto-terdeteksi | | `audio-decode` | Ekstraksi waveform/durasi audio (voice note, capture VoIP) | | `link-preview-js` | Preview link kaya untuk URL di pesan teks keluar | | `better-sqlite3` | Auth state SQLite, adapter store SQLite, **dan** `SQLiteStore`/`StatsManager` milik [Bot Framework](#-bot-framework) | | `mongodb` | Adapter store MongoDB | | `mysql2` | Adapter store MySQL | | `pg` | Adapter store PostgreSQL | | `ioredis` | Adapter store Redis | | `@roamhq/wrtc` | Binding WebRTC native untuk [panggilan suara](#-panggilan-suara--video) | #### ffmpeg: cara dia ditemukan Semua fitur yang memanggil ffmpeg (thumbnail video, konversi stiker, konversi voice note, feeding audio VoIP) mencari binary lewat satu resolver terpusat, dengan urutan: 1. **Override kamu** โ€” `setFfmpegPath('/path/ke/ffmpeg')` (diekspor dari paket) atau env var `FFMPEG_PATH` 2. **`ffmpeg-static`** โ€” kalau terinstall, binary bundelannya dipakai otomatis 3. **`@ffmpeg-installer/ffmpeg`** โ€” sama, sebagai alternatif 4. **`ffmpeg` sistem** di `PATH` kamu Jadi di server biasa cukup `npm i ffmpeg-static` dan tidak perlu mikir lagi. Di **Termux/Android** (di mana kedua paket npm itu tidak punya binary) install versi sistem โ€” otomatis kepakai: ```sh pkg install ffmpeg ``` Kalau tidak ketemu sama sekali, fiturnya gagal dengan petunjuk install per-platform, bukan error misterius `spawn ffmpeg ENOENT`. #### Cek lingkunganmu (doctor) Bingung kenapa suatu fitur tidak jalan? Satu panggilan ini mendiagnosa semuanya โ€” versi Node, dependency opsional mana yang terinstall, ffmpeg ketemu di mana, backend gambar yang aktif: ```js import { printEnvironmentReport } from '@japofc/baileys' await printEnvironmentReport() // cetak laporan lengkap + return snapshot-nya // atau versi data mentah tanpa cetak: import { checkEnvironment } from '@japofc/baileys' const env = await checkEnvironment() // { ok, platform, node, ffmpeg, imageBackend, optionalDeps, warnings } ``` Atau langsung dari terminal, tanpa nulis kode: ```sh npx @japofc/baileys doctor # exit code 0 = semua beres, 1 = ada warning npx @japofc/baileys version ``` --- ## ๐Ÿš€ Mulai Cepat ```js import { makeWASocketAuto, useMultiFileAuthState } from '@japofc/baileys' const { state, saveCreds } = await useMultiFileAuthState('auth_info') // makeWASocketAuto mengambil versi WA Web terbaru sebelum konek // (sw.js WA -> fork -> fallback), mencegah error 405 pairing karena versi basi. // Lebih suka sync? `makeWASocket({ auth: state })` tetap jalan seperti biasa. const sock = await makeWASocketAuto({ auth: state }) // simpan kredensial setiap kali Baileys memperbaruinya sock.ev.on('creds.update', saveCreds) sock.ev.on('connection.update', (update) => { const { connection, qr } = update // Paling gampang: kasih `printQRInTerminal: true` ke makeWASocket dan QR // digambar otomatis oleh renderer bawaan (nol dependency). // Render manual/custom dari event juga bisa: // import { renderQRToTerminal, qrToSVG, qrToPNG } from '@japofc/baileys' // if (qr) console.log(renderQRToTerminal(qr)) // terminal (โ–€โ–„โ–ˆ) // if (qr) fs.writeFileSync('qr.svg', qrToSVG(qr)) // untuk web UI // if (qr) fs.writeFileSync('qr.png', qrToPNG(qr)) // raster (kirim ke mana saja) if (qr) console.log('Dapat QR pairing') if (connection === 'open') console.log('๐Ÿƒ Terhubung!') }) sock.ev.on('messages.upsert', ({ messages }) => { const msg = messages[0] if (!msg.message || msg.key.fromMe) return console.log('Pesan baru dari', msg.key.remoteJid) }) ``` **Tips produksi** โ€” bungkus socket dengan `autoReconnect()` dan urusan disconnect selesai otomatis (exponential backoff, tidak pernah reconnect saat `loggedOut`, reconnect langsung setelah pairing): ```js import { makeWASocketAuto, autoReconnect, useMultiFileAuthState } from '@japofc/baileys' const { state, saveCreds } = await useMultiFileAuthState('auth_info') const manager = autoReconnect(() => makeWASocketAuto({ auth: state, printQRInTerminal: true }), { onSocket: sock => { sock.ev.on('creds.update', saveCreds) sock.ev.on('messages.upsert', handler) // dipasang ulang di setiap reconnect }, onLoggedOut: () => console.log('hapus auth_info/ lalu pairing ulang'), }) await manager.start() ``` Versi lengkap yang bisa langsung dijalankan: [`examples/auto-reconnect-bot.js`](./examples/auto-reconnect-bot.js). ### Login pakai pairing code (tanpa QR) ```js import { makeWASocket, useMultiFileAuthState, formatPairingCode } from '@japofc/baileys' const { state, saveCreds } = await useMultiFileAuthState('auth_info') const sock = makeWASocket({ auth: state, printQRInTerminal: false }) sock.ev.on('creds.update', saveCreds) if (!state.creds.registered) { const code = await sock.requestPairingCode('628123456789') // nomor internasional lengkap console.log('Pairing code:', formatPairingCode(code)) // "ABCD-EFGH" } // kode custom 8 karakter (Crockford base32: 1-9, A-Z tanpa I/O/U) await sock.requestPairingCode('628123456789', 'JAPJAP12') ``` Input divalidasi di awal dengan error yang jelas, bukan gagal diam-diam di sisi server: karakter format (`+`, spasi, strip) dibersihkan, prefix telepon internasional `00` di depan dihapus otomatis, dan dua penyebab klasik langsung dilempar error โ€” **nomor format lokal** (`08123...` padahal harusnya `628123...`, penyebab #1 "pairing code gak pernah dateng") dan nomor lebih dari 15 digit (batas maksimum E.164). Pengecekan yang sama tersedia mandiri sebagai `normalizePairingPhone(nomor)`. Untuk bot publik, batasi percobaan pairing dengan `withPairingGuard`. **Observability** โ€” pasang `createDebugMonitor()` untuk snapshot terstruktur yang aman (status koneksi, alasan disconnect, uptime, persentil latensi pesan, hitungan retry kirim, hitungan error Signal, status VoIP/WASM, memori). Snapshot ini **tidak pernah** berisi payload QR, kode pairing, kunci auth, token, atau private key โ€” seluruh snapshot melewati `redactSecrets()` sebelum dikembalikan, jadi aman untuk di-log atau dilampirkan ke laporan bug apa adanya: ```js import { createDebugMonitor } from '@japofc/baileys' const monitor = createDebugMonitor(sock) // nanti โ€” di health endpoint, log cron, atau crash handler: console.log(JSON.stringify(monitor.getDebugInfo(), null, 2)) // { connection: { state, uptimeMs, lastDisconnect: { code, reason } }, // messages: { received, decryptFailed, latencyMs: { p50, p90, p99 } }, // sendRetries, signalErrors: { noSession, badMac, ... }, voip, memory } ``` **Protocol capture eksperimental** โ€” fitur WhatsApp baru jangan ditebak dari asumsi; pertama capture bentuk BinaryNode dari akun test yang memang kamu izinkan, rahasia akan diredaksi, lalu baru buat wrapper high-level setelah kontrak wire-nya jelas: ```js import { bindProtocolCapture } from '@japofc/baileys' const capture = bindProtocolCapture(sock, { file: './wa-protocol.ndjson' }) // trigger fitur di official client / akun test yang paired // tiap baris adalah JSON redacted: { direction, summary, node } await capture.close() ``` --- ## ๐Ÿ” Autentikasi Empat backend auth-state tersedia langsung. Semuanya mengembalikan bentuk `{ state, saveCreds }` yang sama seperti yang diharapkan `makeWASocket({ auth })`, jadi bisa saling tukar tanpa ubah kode. | Fungsi | Penyimpanan | Cocok untuk | |---|---|---| | `useMultiFileAuthState(folder)` | Satu file JSON per kunci, di disk | Pilihan default โ€” sederhana, mudah di-debug, jalan di mana saja | | `useSingleFileAuthState(namaFile)` | Satu file JSON, di disk | Bot kecil yang lebih mudah kelola/backup satu file | | `useSqliteAuthState(opsi)` | SQLite (`better-sqlite3`) | Bot yang sudah pakai SQLite, atau mau auth di satu file DB embedded | | `useCacheManagerAuthState(store, kunciSesi)` | Store apa pun yang kompatibel [`cacheable`](https://www.npmjs.com/package/@cacheable/node-cache) | Panel hosting multi-sesi, setup berbasis Redis | | `useRedisAuthState(opsi)` | Redis (client `ioredis` **atau** node-redis) | Bot multi-instance, penyimpanan sesi bersama yang cepat | | `useMongoAuthState(opsi)` | MongoDB (collection `mongodb`) | Bot yang sudah pakai Mongo; satu dokumen per key | | `usePostgresAuthState(opsi)` | Postgres (`pg` Pool/Client) | Deployment produksi di Postgres; tabel dibuat otomatis | | `useMySQLAuthState(opsi)` | MySQL/MariaDB (`mysql2/promise`) | Setup shared-hosting; tabel dibuat otomatis | | `makeAuthStateFromStore(store)` | Backend key-value **apa pun** buatanmu | Database kustom โ€” cukup implementasikan 5 method kecil | ```js import { makeWASocket, useMultiFileAuthState } from '@japofc/baileys' const { state, saveCreds } = await useMultiFileAuthState('auth_info') const sock = makeWASocket({ auth: state }) sock.ev.on('creds.update', saveCreds) ``` ```js // Varian SQLite import { makeWASocket, useSqliteAuthState } from '@japofc/baileys' const { state, saveCreds } = await useSqliteAuthState({ database: './auth.db' }) const sock = makeWASocket({ auth: state }) sock.ev.on('creds.update', saveCreds) ``` Keempat adapter database menerima **client/collection yang sudah ada** (disarankan โ€” kamu pegang kendali pooling & lifecycle) atau `uri` (driver di-import lazy hanya saat itu; tak ada yang jadi dependency wajib): ```js // Varian Redis โ€” jalan dengan ioredis DAN node-redis import { makeWASocket, useRedisAuthState } from '@japofc/baileys' const { state, saveCreds } = await useRedisAuthState({ client: myRedis, session: 'bot-1' }) const sock = makeWASocket({ auth: state }) sock.ev.on('creds.update', saveCreds) ``` `useMultiFileAuthState` juga mengekspor `pruneStaleAuthFiles(folder, opsi)` untuk membersihkan file sender-key lama secara terjadwal โ€” berguna untuk bot yang jalan lama dan menumpuk ribuan file kunci basi. --- ## ๐Ÿ—„๏ธ Backend Store `makeInMemoryStore()` dari `lib/Store` memberikan cache chat/kontak/pesan in-memory klasik. Untuk apa pun yang harus selamat dari restart, `makePersistentStore()` (dari `PersistentStore.js`) membungkus salah satu dari lima backend di balik interface yang sama: | Backend | Fungsi | |---|---| | SQLite | `createSqliteStoreAdapter(opsi)` | | MongoDB | `createMongoStoreAdapter(opsi)` | | MySQL | `createMysqlStoreAdapter(opsi)` | | PostgreSQL | `createPostgresStoreAdapter(opsi)` | | Redis | `createRedisStoreAdapter(opsi)` | ```js import { makeWASocket, makeInMemoryStore } from '@japofc/baileys' const store = makeInMemoryStore({}) store.readFromFile('./baileys_store.json') setInterval(() => store.writeToFile('./baileys_store.json'), 10_000) const sock = makeWASocket({ /* ...auth dll */ }) store.bind(sock.ev) ``` --- ## ๐Ÿ’ก Contoh Pemakaian ### Tombol & Native Flow ```js import { Button } from '@japofc/baileys' await new Button(sock) .setTitle('Promo Spesial') .setBody('Diskon 20% cuma hari ini') .setFooter('@japofc/baileys') .addReply('Klaim Sekarang', 'claim_promo') .addUrl('Lihat Katalog', 'https://example.com/catalog') .addCall('Hubungi Kami', '628123456789') .send(jid) ``` ### Poll ```js import { Poll } from '@japofc/baileys' await new Poll(sock) .setName('Mau makan apa hari ini?') .addOptions(['Nasi Goreng', 'Mie Ayam', 'Bakso']) .setSelectable(1) .send(jid) ``` > **v2.4.7** โ€” builder poll sekarang memvalidasi sebelum mengirim. Opsi duplikat > ditolak (hasil poll dikelompokkan berdasarkan teks opsi, jadi duplikat dulu menyatu > jadi satu hasil), `setEndDate()` melempar error untuk tanggal yang tidak bisa > diparsing alih-alih mengirim `endTime: NaN`, dan `setQuiz()` tidak lagi bisa > digabung dengan `setAnnouncementGroup()` (jalur itu memakai > `pollCreationMessageV2` yang tidak punya field `correctAnswer`, jadi mode kuis > hilang diam-diam). Poll kuis juga akhirnya terbaca: > `getAggregateVotesInPollMessage()` kini mengenali `pollCreationMessageV5`. ```js const poll = new Poll(sock) .setName('Kuis: ibu kota Indonesia?') .addOptions(['Jakarta', 'Bandung', 'Surabaya']) .setQuiz('Jakarta') poll.validate() // [] kalau aman dikirim โ€” mengumpulkan semua masalah sekaligus poll.assertValid() // melempar masalah pertama (dijalankan otomatis oleh build()/send()) poll.countOptions() // 3 poll.getOptions() // ['Jakarta', 'Bandung', 'Surabaya'] (salinan) poll.removeOption('Surabaya') Poll.MAX_OPTIONS // 12 โ€” ditegakkan, sama seperti MAX_NAME_LENGTH (255) / MAX_OPTION_LENGTH (100) await poll.send(jid) ``` ### Carousel > Kartu biasanya dibuat dengan `Button(...).toCard()` dulu. Kartu media tetap jalan seperti sebelumnya, dan v2.4.7 juga mengizinkan kartu carousel text/button-only yang valid (WhatsApp memang merendernya) lewat `addTextCard()` atau kartu `Button(...).toCard()` tanpa header media. ```js import { Button, Carousel } from '@japofc/baileys' const kartuA = await new Button(sock) .setImage('https://example.com/a.jpg') .setTitle('Produk A') .addUrl('Lihat', 'https://example.com/a') .toCard() const kartuB = await new Button(sock) .setImage('https://example.com/b.jpg') .setTitle('Produk B') .addUrl('Lihat', 'https://example.com/b') .toCard() await new Carousel(sock) .setBody('Pilih salah satu produk di bawah ini') .addCard([kartuA, kartuB]) .send(jid) // Kartu text/button-only, tanpa gambar: await new Carousel(sock) .setBody('Aksi cepat') .addTextCard({ title: 'Bantuan', text: 'Pilih aksi', buttons: [ { id: 'faq', text: 'FAQ' }, { webview: 'https://example.com/help', text: 'Buka Bantuan' } ] }) .send(jid) ``` ### AIRich โ€” kartu respons kaya ```js import { AIRich } from '@japofc/baileys' await new AIRich(sock) .addHeading('Ringkasan Order') .addText('Pesananmu sedang diproses.') .addTable([ ['Item', 'Qty'], ['Kopi Susu', '2'] ]) .addTip('Pesanan biasanya siap dalam 15 menit') .addSuggest('Lacak Order') .send(jid) ``` Untuk kasus umum, v2.4.7 juga mengekspor wrapper one-liner di atas builder yang sama: ```js import { sendJapRich, jap } from '@japofc/baileys' await sendJapRich(sock, jid, { title: 'Ringkasan Order', markdown: '# Lunas\nPesananmu sedang diproses.', actions: { text: 'Lacak', url: 'https://example.com/order/123' }, suggestions: ['Lacak Order', 'Hubungi CS'] }) // Atau tetap chaining setelah shortcut membangun kartunya: await jap(sock, '# Laporan Cepat').addTip('Dibuat sekarang').send(jid) ``` Alias netral (`sendRich`, `Rich`, `createRich`, `buildRich`) tetap tersedia, tapi helper ber-brand JAP (`jap`, `japRich`, `createJapRich`, `buildJapRich`, `sendJapRich`) adalah nama yang disarankan untuk kode baru. `AIRich` mendukung `{ id, insertAt }` di setiap panggilan `add*()`/`set*()`, jadi kamu bisa menyisipkan blok relatif terhadap blok yang sudah ditambahkan sebelumnya, bukan selalu menambah di akhir โ€” praktis untuk respons gaya streaming/edit-di-tempat yang dikombinasikan dengan `sendEdit(jid, id)`. **`streamText()` โ€” efek "AI lagi ngetik".** Satu bubble yang tumbuh lewat edit di tempat (persis cara Meta AI streaming jawabannya), bukan membanjiri chat: ```js // kirim sekali, lalu patch bubble yang sama sampai teks lengkap keluar await new AIRich(sock).streamText(jid, jawabanPanjang, { chunkSize: 120, // ~karakter per tahap (dipotong di batas kata) intervalMs: 900, // jeda antar edit (min 300) cursor: ' โ–' // tampil selama streaming, dihapus di akhir ('' menonaktifkan) }) // bisa digabung blok lain: addHeading()/addTable() dulu, baru streamText() ``` **`readRichMessage()` โ€” separuh pembacanya.** Parse kartu rich yang DITERIMA (dari bot AI/asisten mana pun) balik jadi blok terstruktur, bukan menatap proto mentah: ```js import { readRichMessage } from '@japofc/baileys' sock.ev.on('messages.upsert', ({ messages }) => { const rich = readRichMessage(messages[0]) if (!rich.found) return rich.blocks // [{ type: 'heading', text }, { type: 'code', language, code }, // { type: 'table', rows, headerRows }, { type: 'text', text, entities }, โ€ฆ] rich.suggestions // teks semua pill saran rich.text // render teks datar seluruh kartu }) ``` Mendukung dua bentuk wire (payload unified-response + fallback submessages proto), entity link inline dikembalikan jadi `[label](url)`, span kode ber-highlight digabung ulang, tidak pernah throw โ€” input non-rich mengembalikan `{ found: false }`. Teruji roundtrip terhadap builder AIRich sendiri. Builder lain yang layak diketahui: **`ButtonV2`** (tombol quick-reply sederhana), **`ButtonV3`** (`loadFrom(msg)` untuk mengedit pesan template yang sudah ada), dan **`Toolkit`** (helper statis: `Toolkit.resize()`, `Toolkit.fetchBuffer()`, `Toolkit.waitAllPromises()`, `Toolkit.extractIE()` untuk mem-parse link/sitasi/LaTeX `[label](url)` dari teks biasa). ### ๐Ÿ“ Peta Folder Builders (`lib/Builders/`) Setiap builder pesan tinggal di file-nya sendiri di `lib/Builders/`, jadi kamu bisa melacak persis dari mana sebuah class berasal, bukan mengubek satu `MessageBuilder.js` raksasa. `index.js` hanyalah barrel file yang me-re-export semuanya (plus alias-aliasnya) untuk sintaks `import { ... } from '@japofc/baileys'` di level teratas. | File | Ekspor | Untuk apa | |---|---|---| | `shared.js` | `Toolkit`, `BaseBuilder`, `RowBuilder` | Fondasi bersama semua builder lain. `BaseBuilder` memegang plumbing `send()`/context-info chainable yang umum, `RowBuilder` helper baris/section bersama, dan `Toolkit` kumpulan helper statis (`resize`, `fetchBuffer`, `waitAllPromises`, `extractIE`, helper durasi/preview media). Tidak ada yang dimaksudkan untuk dipakai langsung di kode bot โ€” dia ada supaya `Button`, `Poll`, `Carousel`, dll. tidak mengimplementasi ulang plumbing yang sama. | | `Button.js` | `Button`, `CardBuilder` | Builder tombol interaktif/native-flow utama โ€” header (gambar/video/dokumen), helper CTA (`addUrl`, `addCall`, `addReply`, dan set native-flow yang lebih luas), plus `.toCard()` untuk mengubah pesan tombol menjadi kartu `Carousel`. | | `ButtonV2.js` | `ButtonV2` | Varian legacy `buttonsMessage` yang lebih ringan dan terbatas maksimal 3 tombol quick-reply โ€” punya `validate()`/`assertValid()`, `countButtons()`/`getButtons()`/`clearButtons()`, dan relay memakai envelope canonical `getBizBinaryNode()` yang sama dengan jalur socket. | | `ButtonV3.js` | `ButtonV3` | Berpusat pada `loadFrom(msg)` โ€” memuat `templateMessage` yang sudah ada (misalnya yang kamu fetch atau di-quote) supaya bisa diedit di tempat. Juga memvalidasi hydrated quick-reply/url/call button dan relay dengan biz node canonical. | | `Carousel.js` | `Carousel` | Merangkai hasil `Button(...).toCard()` menjadi carousel kartu yang bisa digeser. Menerima kartu media dan kartu text/button-only (`addTextCard()`), memvalidasi sebelum kirim, dan dibatasi `Carousel.MAX_CARDS` (10) karena WhatsApp diam-diam memotong apa pun di atas itu. | | `Poll.js` | `Poll` | Builder pesan poll/voting โ€” pertanyaan, opsi, single/multi-select, mode pemilih tersembunyi, penandaan jawaban benar, kedaluwarsa. | | `AIRich.js` | `AIRich` (+ alias `ORich`, `AIJap`, `LeafRich`, `JapAI`, `JapRich`, `RichJap`) | Builder respons gaya asisten AI yang dijelaskan di atas โ€” heading, teks berformat, tabel, kartu media/produk/post, kartu tugas/progres, banner tips, saran quick-reply. | | `Rich.js` | `jap`, `japRich`, `createJapRich`, `buildJapRich`, `sendJapRich` (+ alias netral `Rich`, `createRich`, `buildRich`, `sendRich`) | Wrapper one-liner di atas `AIRich` untuk kartu umum (`markdown`, `text`, `actions`, `suggestions`, media, dll.) tanpa mengganti builder chainable penuh. | | `A2UI.js` | `A2UI`, `sendA2UIWidget` | Builder widget A2UI/Bloks level rendah. Membangun tree `components` flat (Column/Row โ†’ `children`, Card/Button โ†’ `child`, Modal โ†’ `trigger`/`content`) yang diharapkan widget Bloks dan mengirimnya lewat jalur `getBizBinaryNode()` yang sama dengan `Button`/`ButtonV2`, jadi node level wire selalu cocok dengan nama tombol yang benar-benar terkirim. | | `JapBaileys.js` | `JapBaileys` | **Hub** builder terpadu โ€” satu objek yang membungkus semua builder di atas di balik nama method pendek (`.button()`, `.buttonV2()`, `.buttonV3()`, `.carousel()`, `.poll()`, `.airich()`, `.rich()`, `.a2ui()`), plus alias PascalCase (`.Button()`, `.Carousel()`, `.Poll()`, `.AIRich()`, `.Rich()`, `.A2UI()`) untuk developer yang lebih suka gaya penamaan itu. | | `index.js` | semua di atas, plus `MESSAGE_BUILDER_VERSION` | Barrel file โ€” me-re-export setiap builder dan aliasnya supaya `import { Button, Poll, AIRich, JapBaileys } from '@japofc/baileys'` jalan tanpa masuk ke file individual. `MESSAGE_BUILDER_VERSION` melacak versi permukaan API builder sendiri, terpisah dari versi paket. | **Contoh hub terpadu** โ€” berguna kalau lebih suka membawa satu objek daripada mengimpor tiap builder satu-satu: ```js import { JapBaileys } from '@japofc/baileys' const vx = new JapBaileys(sock) await vx.button() .setTitle('Promo Spesial') .addReply('Klaim Sekarang', 'claim_promo') .send(jid) await vx.poll() .setName('Mau makan apa hari ini?') .addOptions(['Nasi Goreng', 'Mie Ayam']) .send(jid) ``` --- ### ๐Ÿ“Œ Pin / Keep in Chat ```js // Pin pesan 7 hari (default 24 jam), unpin, keep / unkeep di chat menghilang await sock.sendPin(jid, msg.key, { durationSec: 7 * 86400 }) await sock.sendUnpin(jid, msg.key) await sock.sendKeep(jid, msg.key) await sock.sendUnkeep(jid, msg.key) ``` ### ๐Ÿ“… Event ```js await sock.sendEvent(jid, { name: 'Rapat Mingguan', description: 'Bahas progres bot', startDate: new Date('2026-09-15T10:00:00+07:00'), endDate: new Date('2026-09-15T11:00:00+07:00'), location: { name: 'Kantor', address: 'Jakarta' }, extraGuestsAllowed: true }) ``` ### ๐Ÿ“ž Panggilan Terjadwal Pesan scheduled-call native (kartu "Jadwalkan panggilan" dengan pengingat join): ```js // 'voice' (default) atau 'video' await sock.sendScheduledCall(jid, { title: 'Standup harian', scheduledAt: new Date('2026-09-15T09:00:00+07:00'), callType: 'video' }) // Batalkan nanti (butuh key dari pesan pembuatan) await sock.cancelScheduledCall(jid, pesanPembuatan.key) ``` ### ๐Ÿ“ฑ Mini App Dua mode โ€” kirim `url`, `flow`, atau keduanya (dua tombol): ```js import { sendMiniApp } from '@japofc/baileys' await sendMiniApp(sock, jid, { title: 'Mini App Saya', body: 'Tekan tombol untuk membuka app ๐Ÿ‘‡', // 1) mode webview: kartu kaya + CTA yang membuka web app kamu // (webview dalam-app kalau didukung, kalau tidak lewat browser) url: 'https://myapp.example.com', params: { ref: 'wa-bot' }, // โ†’ ditambahkan sebagai ?ref=wa-bot buttonText: '๐Ÿš€ Buka App', // 2) mode Flows: mini app native BENERAN di dalam chat (form/layar di dalam // WhatsApp, tanpa browser). Butuh Flow ID yang sudah dipublish di Flows Manager. flow: { id: '123456789', cta: '๐Ÿ“ Isi Form', screen: 'WELCOME' }, thumbnail: 'https://myapp.example.com/icon.png' // url atau Buffer }) // atau sebagai method socket: await sock.sendMiniApp(jid, { ... }) ``` --- ## ๐Ÿ“จ Helper Pesan One-liner level tinggi untuk tipe pesan modern โ€” tervalidasi, dengan alias ramah: ```js await sock.sendLocation(jid, { lat: -6.2, lng: 106.8, name: 'Jakarta' }); await sock.sendContact(jid, { name: 'Budi', vcard: 'BEGIN:VCARD\n...' }); await sock.sendGroupInvite(jid, { code: 'AbC123', jid: groupJid, subject: 'Komunitas' }); await sock.sendPaymentRequest(jid, { currency: 'IDR', amount: 50000, note: 'kopi โ˜•' }); await sock.sendInvoice(jid, { note: 'INV-001' }); await sock.sendPollOption(jid, pollKey, ['Opsi baru']); await sock.sendEventInvite(jid, { eventTitle: 'Pesta', startTime: new Date(...) }); await sock.sendNewsletterInvite(jid, { newsletterJid, newsletterName: 'Berita' }); // Upgrade poll (sudah tersambung end-to-end): await sock.sendPoll(jid, { name: 'Jam berapa?', values: ['Pagi', 'Sore'], endDate: new Date('2026-09-16T00:00:00Z'), // auto-tutup hideVoter: true, // poll anonim canAddOption: true, // pemilih boleh menambah opsi }); ``` Pesan musik masih eksperimental โ€” proto-nya benar tapi interop dengan klien resmi belum terverifikasi (lihat [Yang jujur belum diimplementasi](#yang-jujur-belum-diimplementasi-dan-kenapa)): ```js await sock.sendMusic(jid, { songUri, artworkUri, embeddedMusic: { songId, title, author } }); ``` **Pintu darurat:** setiap kunci konten juga jalan inline via `sendMessage`, dan `{ raw: true, : {...} }` meneruskan field proto apa pun tanpa disentuh โ€” cakupan `WAProto` penuh tanpa nunggu wrapper: ```js await sock.sendMessage(jid, { raw: true, musicMessage: { songUri } }); ``` Pengguna TypeScript dapat `AnyMessageContent` yang bertipe (`import type { AnyMessageContent } from '@japofc/baileys'`). ## ๐Ÿงฐ Channel, Riwayat & Transkrip **Manajemen channel** (query langsung): ```js await sock.newsletterDelete(channelJid) await sock.newsletterAdminCount(channelJid) await sock.newsletterJoinInvite('kode-undangan') await sock.newsletterChangeOwner(channelJid, jidPemilikBaru) // eksperimental await sock.communityGetInviteCode(communityJid) // ...plus follow/unfollow/mute/react/fetch yang sudah ada + CRUD komunitas penuh ``` **Berbagi riwayat grup** untuk anggota baru (meneruskan pesan terakhir ke DM mereka): ```js import { getGroupHistoryFromStore } from '@japofc/baileys' const pesan = getGroupHistoryFromStore(store, groupJid, 10) await sock.shareGroupHistory({ groupJid, members: jidAnggotaBaru, messages: pesan, greeting: true }) ``` **Transkripsi voice note** (provider bisa diganti โ€” Whisper cloud atau milikmu sendiri): ```js import { openAIWhisperProvider } from '@japofc/baileys' const provider = openAIWhisperProvider({ apiKey: process.env.OPENAI_API_KEY }) const { text } = await sock.transcribeMessage(pesanVoiceNote, { provider }) ``` **Deep link mini-app** (parameter ber-HMAC yang bisa diverifikasi web app kamu): ```js import { createMiniAppLink, parseMiniAppParams, buildFlowDataExchange } from '@japofc/baileys' const link = createMiniAppLink('https://app.example.com/', { uid: '123' }, { secret: 's3cr3t' }) parseMiniAppParams(link, { secret: 's3cr3t' }) // โ†’ { uid: '123' } (throw kalau dimodifikasi) buildFlowDataExchange('navigate', { screen: 'HOME' }) // payload data_exchange untuk Flows ``` **Widget A2UI** kini mencakup `Slider`, `Switch`, `List`, `ProgressBar`, `Avatar`, `Badge`, `Spacer`, dan `Tabs` di samping set Text/Image/Video/Button/Card/Modal yang sudah ada (semua divalidasi ref-nya saat `build()`). ## ๐Ÿ” Paket Keamanan Pengerasan siap-pakai untuk auth state, rahasia, dan penyalahgunaan โ€” semuanya di `lib/Utils/auth-secure.js`, tercakup `tests/security.test.js` (termasuk fuzzing). ```js import { useEncryptedFileAuthState, secureLogger, withPairingGuard, createQRGuard, backupAuthState, writeAuthIntegrity, repairAuthState, secureLogout } from '@japofc/baileys' // 1. Auth state terenkripsi AES-256-GCM (membaca plaintext lama, migrasi saat save) const { state, saveCreds } = await useEncryptedFileAuthState('./auth', { password: process.env.AUTH_PW }) const sock = makeWASocket({ auth: state, logger: secureLogger(pino({ level: 'info' })), // 7. meredaksi qr/token/kunci di setiap baris log }) // 2. Rate limit kode pairing: 5/jam per nomor, jeda 30 detik antar percobaan withPairingGuard(sock, { maxPerHour: 5, minIntervalMs: 30_000 }) // 3. QR first-guard: tangani QR pertama, telan re-emit selama 60 detik const qrGuard = createQRGuard({ ttlMs: 60_000 }) sock.ev.on('connection.update', ({ qr }) => { qr = qrGuard.handle(qr); if (qr) tampilkan(qr) }) // 6/8. backup terenkripsi + snapshot integritas await backupAuthState('./auth', './auth.jabackup', { password: process.env.BACKUP_PW }) await writeAuthIntegrity('./auth', { secret: process.env.INT_PW }) // 9. perbaiki store korup (karantina + pulihkan creds dari backup) await repairAuthState('./auth', { password: process.env.AUTH_PW, backupFile: './auth.jabackup', backupPassword: process.env.BACKUP_PW }) // 4. logout + timpa/hapus semua file auth + bersihkan creds di memori await secureLogout(sock, { authFolder: './auth' }) ``` Varian satu file: `useEncryptedSingleFileAuthState(file, { password })`. ## ๐Ÿ†• Kejar-tayang WA 2026 Fitur WhatsApp 2026, tersambung ke JAP-Baileys. Semua di sini diaudit terhadap klien resmi terbaru โ€” hanya yang kurang yang ditambahkan; yang sudah jalan cukup didokumentasikan. ### Username (chat tanpa nomor telepon) ```js await sock.checkUsername('japstore'); // ketersediaan await sock.setUsername('japstore'); // klaim await sock.reserveUsername('japstore'); // reservasi (alur reservasi 2026) await sock.findUserByUsername('japstore'); // lookup USync โ†’ JID const u = await sock.fetchContactUsernames(['62812@s.whatsapp.net']); ``` ### Poll yang bisa diedit (`editPoll`) Poll bisa diedit ~15 menit setelah dibuat (aturan sisi server): ```js const terkirim = await sock.sendPoll(jid, { name: 'Jam berapa?', values: ['Pagi', 'Sore'] }); await sock.editPoll(jid, terkirim.key, { name: 'Jam berapa?', values: ['Pagi', 'Siang', 'Sore'] }); ``` ### Mention massal (`sendMentionAll`) ```js await sock.sendMentionAll(groupJid, 'Pengumuman: rapat jam 9!'); ``` > Di grup dengan 32+ anggota, `@all` khusus admin dan aturannya ditegakkan > sisi server โ€” panggilan dari non-admin dibuang diam-diam oleh WhatsApp. ### Mention di status (`sendStatusMention`) Posting status sekaligus memberi tahu user atau seluruh grup โ€” mereka dapat bubble "menyebut Anda dalam statusnya" yang tertaut ke status kamu: ```js // status teks, mention dua user await sock.sendStatusMention({ text: 'Pengumuman besar! ๐ŸŽ‰' }, [ '62812xxx@s.whatsapp.net', '62813xxx@s.whatsapp.net', ]) // status gambar, mention seluruh grup (semua anggota diberi tahu) await sock.sendStatusMention({ image: buffer, caption: 'Rilisan baru ๐Ÿ”ฅ' }, [groupJid]) ``` Mendukung semua konten status (`text`, `image`, `video`, `audio`). Atur jeda notifikasi dengan `{ delayMs }` di options (default 1500 ms per jid). ### Pengingat event ```js await sock.sendMessage(jid, { event: { title: 'Rapat', description: 'Q3', startDate: new Date('2026-09-15T09:00:00+07:00'), reminder: true, reminderOffsetSec: 1800, // ingatkan 30 menit sebelum mulai } }); ``` ### Nomor pengirim dari event LID (`resolveSenderPn`) Memperbaiki payload yang hanya berisi LID (mis. offer panggilan tanpa `caller_pn`): ```js sock.ev.on('messages.upsert', async ({ messages }) => { for (const m of messages) console.log(await sock.resolveSenderPn(m)); // '62812โ€ฆ' | null }); ``` ### Voice note sekali lihat Konten `sendVoiceNote()` bisa dikombinasikan dengan `viewOnce`: ```js await sock.sendMessage(jid, { ...(await buildVoiceNoteContent('./a.ogg')), viewOnce: true }); ``` ### Label anggota (grup) Sudah tersedia โ€” tanpa kode baru, cukup didokumentasikan di sini: ```js await sock.updateMemberLabel({ groupJid, lid, label: 'Admin' }); ``` ### Yang jujur belum diimplementasi (dan kenapa) - **Transkrip pesan suara** โ€” dibuat on-device oleh klien resmi saja; tidak ada API transkrip di level wire. - **Berbagi riwayat pesan grup (native)** โ€” WhatsApp mulai merilis fitur resmi "Group Message History" (bagikan 25โ€“100 pesan terakhir ke anggota yang baru ditambahkan, E2EE, dikontrol admin) pada Feb 2026. Format wire-nya masih belum berhasil di-capture library publik mana pun (diverifikasi ulang 28 Sep 2026 dengan men-download dan men-diff API upstream Baileys 7.0.0-rc14 plus 8 fork hidup terbesar โ€” tidak ada yang membawanya). Sampai itu terjadi, repo ini menyediakan *workaround* yang jujur โ€” `shareGroupHistory()` meneruskan pesan terakhir ke DM anggota baru โ€” yang BUKAN alur native (tanpa bubble riwayat di grup, tanpa notifikasi "riwayat dibagikan"). Kalau butuh perilaku native, satu-satunya jalan hari ini adalah klien resmi. - **Pesan musik (interoperabilitas)** โ€” struct proto `MusicMessage` round-trip dengan baik dan `sendMusic()` mengirimkannya, tapi interop nyata butuh ID katalog provider (Spotify/Apple) plus alur upload artwork yang dinegosiasikan klien resmi secara privat; belum ada capture publik (diverifikasi ulang Sep 2026). Pesan dengan ID karangan tampil sebagai preview polos atau tidak tampil sama sekali di klien resmi โ€” perlakukan `sendMusic()` sebagai eksperimental dan uji di perangkat nyata dulu. Yang *diperbaiki* di v2.4.1: field `embeddedMusic` yang tak dikenal dulu dibuang diam-diam oleh encoder proto (key typo hilang begitu saja dari wire) โ€” sekarang langsung throw 400 dengan daftar field yang didukung. Untuk fitur musik-di-status modern, lihat `withMusicAttribution()`. - **`mediaKeyDomain` โ€” SUDAH DIIMPLEMENTASI.** Di-backport dari rc14 ke semua 5 tipe media (`Audio/Document/Image/Sticker/VideoMessage`, enum `UNSET/E2EE_CHAT/STATUS/CAPI/BOT`) dengan passthrough kirim: `sendMessage(jid, { image: buf, mediaKeyDomain: 1 })`. Default-nya tidak diset (direkomendasikan โ€” server yang melabeli). Dilewati hanya di `MMSThumbnailMetadata`, karena field nomor 8 upstream bentrok dengan `messageHistoryMetadata` yang lebih baru di proto kita. ## ๐Ÿ†• Utilitas Sehari-hari One-liner untuk kerjaan bot harian (bisa juga standalone โ€” lihat `examples/`): ```js // ๐Ÿ“Š Poll (chat/grup) + Kuis (khusus channel) await sock.sendPoll(jid, { name: 'Makan apa?', options: ['Nasi', 'Mie'] }) await sock.sendQuiz(channelJid, { name: 'Kuis', options: ['A', 'B'], correctAnswer: 'A' }) // ๐ŸŽ™๏ธ Voice note โ€” otomatis konversi mp3/wav/โ€ฆ ke Opus PTT (butuh fluent-ffmpeg) await sock.sendVoiceNote(jid, './halo.mp3') // path | Buffer | { url } // ๐Ÿ“ž Tag semua orang (daftar @ terlihat vs tersembunyi) await sock.tagAll(groupJid, 'Rapat jam 10!') await sock.hideTag(groupJid, 'Pengumuman ๐Ÿ“ข') // ๐Ÿ” LID โ†’ nomor telepon (best-effort, null kalau tidak diketahui) await sock.getPhoneNumber('12345@lid') // โ†’ '62812โ€ฆ' await sock.getLidForPhone('62812โ€ฆ') // lookup kebalikannya // ๐Ÿง Kirim manusiawi โ€” mengetikโ€ฆ + jeda natural + antrean per-chat await sock.sendHumanized(jid, { text: 'Halo!' }) // ๐Ÿ›ก๏ธ Send Guard โ€” pacing anti-ban global langsung di dalam sendMessage() const sock = makeWASocket({ sendRateLimit: { messagesPerMinute: 20, // plafon global token-bucket (0 = mati) perChatDelayMs: 1500, // jeda minimum antar kirim ke chat yang sama jitterRatio: 0.2 // ยฑ20% acak biar timing tidak terlihat robotik } }) await sock.sendMessage(jid, { text: 'otomatis di-pace ๐Ÿ›ก๏ธ' }) // di-pace await sock.sendMessage(jid, { text: 'sekarang!' }, { skipRateLimit: true }) // bypass // โœ… Pelacakan pengiriman โ€” tunggu ack server untuk pesan keluar const msg = await sock.sendMessage(jid, { text: 'penting!' }) await sock.waitForMessageAck(msg.key.id) // resolve saat di-ack, reject saat // error server / timeout 60 detik // โœ… Varian satu panggilan โ€” kirim + tunggu ack, bebas race (waiter didaftarkan // SEBELUM pesan keluar, jadi ack yang datang cepat tidak mungkin lolos) const { message, ack } = await sock.sendMessageAcked(jid, { text: 'penting banget!' }, { ackTimeoutMs: 30_000 }) // ๐Ÿ“ฃ Broadcast ke banyak jid โ€” ada jeda, hasil per-jid, tidak mati di tengah jalan const report = await sock.sendBroadcast(jids, { text: 'promo!' }, { delayMs: 1500 }) // { sent: [...], failed: [{ jid, error }], total } // ๐Ÿ”— Link undangan grup extractGroupInviteCode('https://chat.whatsapp.com/AbCdEfโ€ฆ') // 'AbCdEfโ€ฆ' await sock.joinGroupViaLink('https://chat.whatsapp.com/AbCdEfโ€ฆ') // ๐Ÿท๏ธ Parse @mention dari teks โ†’ siap dipakai sendMessage const mentions = parseMentions(text) // ['62812โ€ฆ@s.whatsapp.net', โ€ฆ] await sock.sendMessage(jid, { text, mentions }) // ๐Ÿค– Chat Meta AI (eksperimental โ€” butuh Meta AI di akun/region) const { text } = await sock.askMetaAI('Jelaskan black hole!') ``` **Command router** untuk bot berprefix (`!menu`, `.sticker`) dengan middleware + auto-help: ```js import { createRouter } from '@japofc/baileys' const router = createRouter({ prefix: '!' }) router.command('ping', async (ctx) => ctx.reply('pong! ๐Ÿ“'), { desc: 'Cek bot' }) router.attach(sock) // โ†’ detach() ``` **Penjadwal status / channel** (in-memory): ```js import { StatusScheduler, ChannelScheduler, StatusHelper } from '@japofc/baileys' new StatusScheduler(sock).schedule(StatusHelper.text('Pagi! โ˜€๏ธ'), new Date('2026-09-11T06:00:00+07:00')) new ChannelScheduler(sock).schedule(channelJid, { text: 'Update' }, Date.now() + 3600_000) ``` **Atribusi musik di status** (`StatusAttribution.Type.MUSIC` โ€” fitur resmi WA Des-2025 "tambah musik ke status", terverifikasi wire terhadap WAProto): ```js import { StatusHelper, withMusicAttribution } from '@japofc/baileys' const status = withMusicAttribution( StatusHelper.text('vibes ๐ŸŽต'), { title: 'Nama Lagu', authorName: 'Artis', songId: '' } ) await StatusHelper.send(sock, status, jidList) ``` > Klien resmi me-resolve lagu lewat katalog berlisensi Meta, jadi `songId` > harus id katalog asli agar chip musiknya muncul di sana. Struktur atribusinya > sendiri wire-correct apa pun isinya (round-trip tercakup di test). **Ekspor chat & statistik** (offline โ€” format "Ekspor chat" resmi, JSON, CSV): ```js import { exportChatAsText, exportChatAsCSV, chatStatistics } from '@japofc/baileys' // messages: WAMessage[] dari store / cache anti-delete / messages.upsert console.log(exportChatAsText(messages)) // 14/09/2026, 10.32 - J.AP: halo! // 14/09/2026, 10.33 - Rina: fs.writeFileSync('chat.csv', exportChatAsCSV(messages)) const stats = chatStatistics(messages) // { total, bySender, byKind, byHour[24], byWeekday[7], topWords, ... } ``` Bisa juga tanpa kode sama sekali: `npx @japofc/baileys export dump.json --format text|json|csv`. **Testing bot offline (`createMockSocket`)** โ€” tes logika bot di CI tanpa akun WhatsApp, tanpa jaringan, tanpa risiko banned: ```js import { createMockSocket, createRouter } from '@japofc/baileys' import assert from 'assert' const mock = createMockSocket() setupBotKu(mock.sock) // kode bot asli, tanpa diubah await mock.receiveText('628xx@s.whatsapp.net', '!ping') const reply = await mock.waitForReply() assert.equal(reply.content.text, 'pong! ๐Ÿ“') ``` Permukaan `ev` dan signature `sendMessage()` sama dengan socket asli; pesan keluar adalah `proto.WebMessageInfo` SUNGGUHAN lewat pipeline `generateWAMessage()` yang sama. Mendukung injeksi grup, quoted reply, simulasi lifecycle koneksi, capture read-receipt/presence, dan `reset()` antar tes. Scope jujur: TIDAK mengemulasi server WhatsApp โ€” rate limit, sesi, dan enkripsi di luar cakupan by design. `npm test` menjalankan suite offline (`tests/`, tanpa jaringan). --- ## ๐Ÿ†• Baru di v2.4.5 Helper baru di rilis ini. Semua diekspor dari root paket dan sudah bertipe lengkap. ### ๐Ÿ—ณ๏ธ Poll manager โ€” lacak siapa memilih apa (`createPollManager`) `getAggregateVotesInPollMessage` itu stateless dan menghitung ganda pemilih yang berubah pikiran (WhatsApp mengirim ulang *seluruh* pilihan pemilih tiap ada perubahan). `createPollManager` menyimpan state itu โ€” tiap pemilih dihitung sekali, pilihan terakhir yang menang: ```js import { createPollManager } from '@japofc/baileys' const polls = createPollManager() const sent = await sock.sendMessage(jid, { poll: { name: 'Makan apa?', values: ['Pizza', 'Sushi'], selectableCount: 1 } }) polls.register(sent) // ingat opsi + key // beri vote yang sudah didekripsi (nama opsi, hash sha256 hex, atau Buffer hash mentah dari WA): polls.applyVote(sent.key.id, voterJid, ['Pizza']) polls.tally(sent.key.id) // [{ name:'Pizza', count, voters:[] }, ...] polls.winner(sent.key.id) // { winners:['Pizza'], count } (sadar seri) console.log(polls.render(sent.key.id)) // bar chart langsung ``` ### โค๏ธโ€๐Ÿฉน Monitor kesehatan sesi (`createSessionHealthMonitor`) Mendeteksi ledakan pesan yang gagal didekripsi (sesi Signal mati / Bad-MAC drift) per kontak lalu memberi peringatan โ€” murni observasi, tidak pernah melempar error ke event loop: ```js import { createSessionHealthMonitor } from '@japofc/baileys' const health = createSessionHealthMonitor({ badMacThreshold: 3, windowMs: 60_000 }) health.bind(sock) health.onUnhealthy(({ jid, failures }) => console.warn(`sesi ${jid} bermasalah (${failures} gagal dekripsi)`)) health.onRecover(({ jid }) => console.log(`${jid} pulih`)) ``` Dilengkapi `canonicalizeJid()` dan `makeJidCanonicalizer(sock)` untuk menyatukan identitas kontak lintas pemisahan PN/LID. ### ๐Ÿ” Anti-duplikat pesan / idempotensi (`createMessageDedupe`) Mencegah balasan dobel saat WhatsApp mengirim ulang pesan (reconnect, history sync, placeholder resend, retry): ```js import { createMessageDedupe } from '@japofc/baileys' const dedupe = createMessageDedupe({ maxSize: 5000 }) // opsional ttlMs sock.ev.on('messages.upsert', ({ messages }) => { for (const m of messages) { if (dedupe.seen(m.key)) continue // sudah ditangani โ†’ lewati // ...tangani tepat sekali } }) ``` ### ๐Ÿ”— Helper LID โ†” PN di socket Helper pemetaan kini jadi method socket kelas satu (tak perlu lagi menyentuh `signalRepository`): ```js await sock.getLIDForPN('62812โ€ฆ@s.whatsapp.net') // โ†’ 'โ€ฆ@lid' | null await sock.getPNForLID('123โ€ฆ@lid') // โ†’ 'โ€ฆ@s.whatsapp.net' | null await sock.getLIDsForPNs([...]) // batch await sock.getPNsForLIDs([...]) // batch await sock.storeLIDPNMappings([{ lid, pn }]) // isi cache ``` ### ๐Ÿงฉ Helper toolkit kecil Sepuluh helper murni & bertipe, diekspor dari root: ```js import { partition, zip, formatCountdown, wordCount, ellipsisMiddle, jidType, randomString, isNumeric, firstEmoji, maskJid } from '@japofc/baileys' partition([1, 2, 3, 4], n => n % 2 === 0) // [[2,4],[1,3]] zip([1, 2], ['a', 'b']) // [[1,'a'],[2,'b']] formatCountdown(90_061_000) // '1d 01:01:01' ellipsisMiddle('abcdefgh', 5) // 'abโ€ฆgh' jidType('123@g.us') // 'group' maskJid('628123456789@s.whatsapp.net') // '628******89@s.whatsapp.net' ``` --- ## ๐Ÿ“ž Panggilan Suara & Video Dukungan panggilan audio eksperimental via call stack WASM terbundel + relay WebRTC. Butuh peer dependency opsional `@roamhq/wrtc`. ```js import { VoipClient } from '@japofc/baileys' const voip = new VoipClient({ resourcesPath: './voip-resources' }) await voip.connectWithSocket(sock) const panggilan = await voip.call('628123456789') panggilan.on('ringing', () => console.log('Berdering...')) panggilan.on('connected', () => console.log('Panggilan tersambung')) panggilan.on('ended', (alasan) => console.log('Panggilan berakhir:', alasan)) ``` `ActiveCall` (dikembalikan `.call()`) dan `CallState` juga diekspor langsung kalau butuh kontrol status panggilan yang lebih detail. **Menjawab panggilan masuk** โ€” offer dilacak, jadi bot bisa mengangkat (1:1) atau join (grup): ```js import { attachVoip } from '@japofc/baileys' const voip = await attachVoip(sock) // juga disimpan sebagai sock.voip voip.on('incoming-call', async ({ callId, from, isGroupCall, busy }) => { if (busy) return if (isGroupCall) await voip.joinGroupCall(callId, { audioSource: './salam.mp3' }) else await voip.answerCall(callId, { audioSource: './salam.mp3' }) }) // ...atau sepenuhnya otomatis: await attachVoip(sock, { autoAnswer: true }) // angkat panggilan 1:1 await attachVoip(sock, { autoJoinGroup: true }) // join panggilan grup await attachVoip(sock, { autoReject: true, autoRejectText: 'Bot tidak bisa menerima panggilan ๐Ÿ™' }) // offer yang masih menunggu (jawab sebelum `offerTtlMs`, default 45 detik): voip.getPendingCalls() // โ†’ [{ callId, from, isGroupCall, ... }] ``` **Panggilan grup / multi-pihak:** ```js const gcall = await voip.startGroupCall(groupJid, ['62812โ€ฆ', '62813โ€ฆ'], { chatName: 'Rapat' }) await voip.inviteToGroupCall('62814โ€ฆ') await voip.removeGroupParticipant('62813@s.whatsapp.net') await voip.rejoinGroupCall() // pemulihan setelah putus voip.on('group-call-started', console.log) voip.on('group-call-joined', console.log) ``` Panggilan juga mendukung reaksi, angkat tangan, rekaman, dan call link: ```js const panggilan = await voip.call('628123456789', { audioSource: './salam.mp3' }) panggilan.react('๐Ÿ‘') panggilan.setHandRaised(true) const stopRekam = panggilan.recordToFile('./panggilan.wav') // peer lawan โ†’ .wav await voip.previewCallLink('token-call-link') // ๐Ÿ”€ ganti audio yang diputar TANPA menutup panggilan (alur gaya IVR) panggilan.setAudioSource('./menu.mp3') // file/URL panggilan.setAudioSource({ data: buffer, ext: 'mp3' }) // audio in-memory panggilan.setAudioSource('lavfi:sine=frequency=440') // nada hasil generate panggilan.setAudioSource('silence') // berhenti memutar, tetap di panggilan ``` **Reconnect & pemulihan** โ€” watchdog memantau transport relay selama panggilan (`watchdogIntervalMs`/`watchdogMaxSilent`); saat relay mati dia memancarkan `call-degraded` dan otomatis mengirim ulang rekey kripto + offer. Kontrol manual: ```js voip.on('call-degraded', ({ callId }) => console.log('relay mati, memulihkan', callId)) voip.on('call-recovery', (r) => console.log('hasil pemulihan', r)) await voip.recoverCall({}) // manual: { rekey: true, offer: true } voip.getStats() // { busy, callId, call, relay } sock.ev.on('call', (calls) => { /* jalur offer/reject standar tetap jalan */ }) ``` **Menyegarkan stack WASM** โ€” kalau panggilan rusak setelah update WA Web, ambil ulang build VoIP resmi langsung dari bootloader endpoint WhatsApp Web: ```bash npm run voip:fetch-wasm ``` Default-nya tidak perlu browser. Kalau suatu saat respons bootloader publik berubah, script masih bisa fallback ke sesi Chrome yang sudah login dengan `CALL_WASM_FETCH_MODE=browser` dan `--remote-debugging-port=9222`. --- ## ๐Ÿ”Ž Query Sinkronisasi User `WAUSync` (`USyncQuery` / `USyncUser` + protokol) memungkinkan kamu mengecek hal seperti registrasi WhatsApp, daftar perangkat, status, dan info username sebuah JID sebelum mengirim pesan โ€” mekanisme yang sama di balik `sock.onWhatsApp()`. ```js import { USyncQuery, USyncUser, USyncContactProtocol } from '@japofc/baileys' const query = new USyncQuery() .withContext('interactive') .withMode('query') .withUser(new USyncUser().withPhone('628123456789')) query.protocols.push(new USyncContactProtocol()) const hasil = await sock.executeUSyncQuery(query) ``` Protokol yang tersedia: `USyncContactProtocol`, `USyncDeviceProtocol`, `USyncStatusProtocol`, `USyncUsernameProtocol`, `USyncDisappearingModeProtocol`, `UsyncBotProfileProtocol`, `UsyncLIDProtocol`. --- ## ๐Ÿ‘ค Manajemen Username Wrapper level tinggi di atas fitur username WhatsApp (handle `@username` yang bisa kamu pakai supaya nomor tidak terekspos), di atas `USyncUsernameProtocol`. > โš ๏ธ **Rotasi query-ID.** Query ID GraphQL di balik panggilan-panggilan ini di-capture dari sesi WA Web live, dan WhatsApp merotasinya sewaktu-waktu. Kalau itu terjadi, panggilan gagal dengan `GraphQL server error: Bad Request` (atau `unexpected response structure`). Tidak perlu menunggu update paket โ€” hot-patch ID yang dirotasi langsung saat runtime: > > ```js > const sock = makeWASocket({ > usernameQueryIds: { CHECK: '', SET: '' } // bisa override: > // CHECK, CHECK_MULTI, SET, GET, GET_RECOMMENDATIONS, PIN_SET > }) > ``` > > ID baru bisa di-capture dari sesi WA Web live (DevTools โ†’ Network โ†’ WS frames โ†’ cari query `xmlns="w:mex"`). ```js // Cek ketersediaan + dapatkan saran kalau sudah dipakai const cek = await sock.checkUsername('J.AP') // { available: true, username: 'J.AP' } // atau: { available: false, suggestions: [...], rejectionReasons: [...] } // Klaim username await sock.setUsername('J.AP', { source: sock.USERNAME_SOURCE.USER_INPUT }) // Kunci dengan PIN supaya tidak bisa diganti tanpa PIN await sock.setUsernamePin('123456') // Baca username sendiri / hapus const punyaku = await sock.getMyUsername() await sock.deleteUsername() // Resolusi username ke JID (berbasis USync, seperti onWhatsApp() tapi via username) const user = await sock.findUserByUsername('seseorang') // { jid: '628...@s.whatsapp.net', contact: false } // Resolusi massal username untuk daftar kontak yang dikenal const usernames = await sock.fetchContactUsernames(jid1, jid2, jid3) // Dapatkan saran dari WA sendiri (mis. untuk alur onboarding) const rekomendasi = await sock.getUsernameRecommendations() ``` > Butuh akun tier Community/Contact dalam kondisi baik โ€” akun yang kena pembatasan WA untuk nomor baru/belum terverifikasi bisa mendapat `INVALID` atau saran kosong terlepas dari ketersediaan username sebenarnya. --- ## ๐Ÿค– Bot Framework Lapisan opsional level lebih tinggi di atas socket mentah: routing middleware, dispatcher `!command`, antrean pesan yang selamat dari disconnect, auto-reconnect exponential backoff, penyimpanan sesi per-JID, statistik aktivitas grup, dan helper konversi media (stiker/voice note) โ€” supaya proyek bot baru tidak perlu bikin manajemen sesi/context dari nol setiap kali. Butuh peer dependency `better-sqlite3` (penyimpanan sesi + statistik) dan `fluent-ffmpeg` (konversi stiker/voice note, sudah tercantum di atas) โ€” keduanya gagal dengan petunjuk install, bukan crash, kalau kamu memakai fitur Framework yang membutuhkannya tanpa menginstall dulu. ```js import { Bot } from '@japofc/baileys' const bot = new Bot({ socketConfig: { printQRInTerminal: true }, dbPath: './bot.db', // sesi + statistik, default 'baileys_store.db' enableStats: true // leaderboard pesan/stiker grup + deteksi ghost }) bot.command('!ping', async (ctx) => { await ctx.reply({ text: 'pong' }) }) bot.command('!sticker', async (ctx) => { if (!ctx.quoted?.imageMessage) return ctx.reply({ text: 'Reply gambar dengan !sticker' }) // ctx.replySticker() mengurus konversi WebP untukmu await ctx.replySticker(bufferGambar, { packname: 'J.AP Pack', author: 'kamu' }) }) bot.onText(async (ctx) => { // ctx.session() / ctx.setSession() / ctx.updateSession() / ctx.clearSession() // menyimpan state kecil per-chat (mis. alur multi-langkah) ke SQLite otomatis const state = ctx.session() if (state?.awaitingReply) { ctx.updateSession((s) => ({ ...s, awaitingReply: false })) } }) await bot.start() ``` `Context`, `SessionManager`, `StatsManager`, `MediaManager`, dan `SQLiteStore` juga diekspor sendiri-sendiri kalau kamu cuma butuh satu bagian, bukan class `Bot` penuh. > File-file ini masih di-ship sebagai `.js` polos โ€” deklarasi `.d.ts` tulisan tangan untuk modul Framework belum ditambahkan, berbeda dengan permukaan fork ini yang lain yang sudah bertipe penuh. --- ## ๐Ÿงฉ Modul Utilitas
๐Ÿ“– Buka referensi lengkap modul-utilitas (banyak konten)
Sampel utilitas yang diekspor dari `lib/Utils` di luar builder pesan di atas: | Modul | Fungsinya | |---|---| | `anti-delete` | Deteksi dan pulihkan pesan yang dihapus pengirim untuk semua orang | | `anti-edit` | Tangkap isi pesan SEBELUM di-edit โ€” teks before/after, riwayat revisi lengkap, edit berantai | | `trackers` | Tracker reaksi / tanda terima / presence โ€” siapa react apa, siapa sudah baca pesan grup, siapa online/ngetik | | `serialize` | `serializeMessage` โ€” objek pesan siap-bot dengan `.reply()`, `.react()`, `.download()`, quoted ke-unwrap | | `call-guard` | Lacak panggilan masuk, auto-reject + pesan teks opsional, hitungan per penelepon, allowlist | | `group-events` | Callback welcome/goodbye/promote/demote + log event per grup dari update grup | | `view-once` | Deteksi, buka, dan tangkap pesan view-once sebelum hilang | | `anti-link` | Deteksi (dan auto-hapus) link undangan grup/link apa pun di grup โ€” allowlist chat & domain | | `auto-read` | Auto centang-biru pesan masuk โ€” filter grup/DM/status, allow/deny list, pause/resume | | `afk` | Manajer AFK โ€” tandai user pergi, tangkap @mention & reply selama pergi, auto welcome-back | | `pairing-tools` | Siklus kode pairing โ€” validasi/normalisasi kode custom, hitung mundur kedaluwarsa, alur sekali panggil `pairWithCode` | | `flood-guard` | Deteksi spam per user โ€” N pesan dalam satu jendela memicu satu alert per burst | | `word-filter` | Moderasi kata/regex atas seluruh teks terekstrak (caption juga), auto-hapus, daftar kata runtime | | `warn-manager` | Sistem strike โ€” warn per user per chat, threshold, pardon, persistensi | | `gatekeeper` | Ban user/chat dari bot; bungkus handler apa pun agar trafik banned tak pernah masuk | | `level-system` | XP & level per user, event level-up, leaderboard global + per chat, persistensi | | `sticker-exif` | Baca/tulis EXIF packname/author stiker di WebP murni JS โ€” tanpa dependensi native, aman di Termux | | `economy` | Saldo, transfer dengan fee, hadiah harian dengan bonus streak, leaderboard, persistensi | | `group-scheduler` | Buka/tutup grup terjadwal harian ("mode malam"), filter hari | | `verifier` | Captcha member baru grup โ€” tantangan otomatis saat join, hook kick timeout/salah jawab | | `command-stats` | Analitik command โ€” command/user teratas, histogram per jam, middleware router, persistensi | | `anti-tagall` | Tangkap spam mass-mention & hidetag tak terlihat dari member โ€” threshold, pengecualian, auto-hapus | | `shop` | Toko & inventory di atas economy โ€” stok, consumable, jual balik, kirim item | | `group-backup` | Snapshot setting + member grup ke JSON, diff dengan kondisi live, restore setting | | `menfess` | Sesi relay DM anonim dua arah (bot "menfess") โ€” alias, kata stop, TTL | | `notes` | Catatan bernama per chat (`#save` / `#get`) โ€” cari, rename, limit, persistensi | | `birthday` | Buku ulang tahun โ€” daftar hari ini/mendatang, ucapan otomatis sekali per tahun | | `guess-game` | Engine tebak-tebakan โ€” satu ronde per chat, tercepat menang, hadiah, jawaban dibuka saat timeout | | `i18n` | Lapisan terjemahan mini โ€” kamus, bahasa per chat, interpolasi `{var}` | | `fancy-text` | Gaya teks Unicode untuk menu โ€” ๐—ฏ๐—ผ๐—น๐—ฑ, ๐š–๐š˜๐š—๐š˜, โ“’โ“˜โ“กโ“’โ“›โ“”โ““, ๏ฝ†๏ฝ•๏ฝŒ๏ฝŒ๏ฝ—๏ฝ‰๏ฝ„๏ฝ”๏ฝˆ, ๊œฑแดแด€สŸสŸแด„แด€แด˜๊œฑ (12 gaya) | | `join-requests` | Auto setujui/tolak permintaan join grup โ€” allowlist/denylist, routing manual, sweep pending | | `session-tools` | Dokter sesi โ€” analisis/perbaiki folder auth, export/import session-string portabel, migrasi antar backend | | `shutdown` | Manajer shutdown rapi โ€” creds diflush duluan, hook berurutan, tangani sinyal, jalan sekali | | `conversation-flow` | Wizard multi-langkah per user โ€” prompt, validasi, kata batal, timeout | | `webhook-bridge` | POST event socket ke endpoint HTTP mana pun โ€” tanda tangan HMAC, retry backoff | | `wa-links` | Bangun/parse URL wa.me, undangan grup & channel; ekstrak URL dari teks | | `media-probe` | Format + dimensi gambar murni JS (PNG/JPEG/GIF/WebP/BMP) โ€” tanpa library gambar | | `media-guard` | Blokir tipe media per chat ("dilarang stiker") โ€” aturan per chat, auto-hapus | | `health-monitor` | Kesehatan proses โ€” memori, lag event-loop, probe custom, alert threshold | | `text-extras` | Read-more, progress bar, durasi/ukuran manusiawi, pemenggalan, escape markdown, jarak fuzzy | | `reminders` | "!remind 10m โ€ฆ" โ€” parseDuration, timer, persistensi anti-restart (telat tetap bunyi) | | `quota` | Jatah harian per user dengan tier โ€” reset tengah malam, bonus, event kehabisan | | `tiers` | Keanggotaan premium/VIP berkedaluwarsa โ€” extend/stack, lifetime, penyapu expiry | | `todo` | Daftar tugas bersama per chat โ€” penanggung jawab, render โ˜/โ˜‘, mention, persistensi | | `url-watcher` | Pantau URL apa pun, alert saat konten berubah โ€” extract view, diff SHA-256 | | `bug-shield` | Deteksi pesan bug/crash โ€” bom mention, zalgo, banjir karakter tak terlihat, spoof RTL; sanitizeText | | `crash-guard` | Selamat dari exception/rejection tak tertangkap โ€” alert owner, counter, safeStringify | | `connection-watchdog` | Tangkap socket setengah-mati yang diam โ€” alert stale sekali, re-arm saat aktif lagi | | `secure-logger` | Logger pino dengan redaksi kredensial + redactSensitive() untuk objek apa pun | | `call-log` | Riwayat panggilan + statistik per penelepon dari event `call` โ€” hasil, durasi, persistensi | | `always-online` | Titik hijau tetap nyala โ€” penyegar presence dengan ganti mode live & counter gagal | | `status-watcher` | Story sisi penerima โ€” filter kontak, tipe media, hook download | | `button-extras` | quickButtons, sendConfirm (ya/tidak), sendMenuButtons sekali panggil | | `random-tools` | Notasi dadu, koin, pilihan berbobot, meter rate/"jodoh" deterministik | | `jid-extras` | Konversi nomorโ†”jid, banding tanpa peduli device, cetak nomor cantik | | `time-tools` | Waktu relatif ('5m ago'), jam, kejadian berikutnya, jendela lewat tengah malam, salam | | `group-tools` | Helper groupMetadata murni โ€” admin, owner, statistik, diff member, kartu info | | `msg-tools` | messageTypeOf, info quoted, timestamp, preview pesan satu baris | | `kv-store` | Database key-value JSON mini โ€” namespace, counter, simpan atomik debounce | | `warmup` | Pemanasan akun โ€” naikkan volume kirim harian nomor baru bertahap (20โ†’50โ†’โ€ฆโ†’bebas) | | `disconnect-classifier` | Error close โ†’ kategori + aksi yang disarankan (reconnect / pair ulang / stop) | | `group-op-guard` | Tetap di bawah batas aksi grup WhatsApp (~3 add & 2 create per 10 menit) | | `giveaway` | Undian masuk-via-keyword โ€” undian adil, multi-pemenang, deadline, kartu status | | `attendance` | Absen harian โ€” jam check-in, daftar yang belum, render bernomor | | `auction` | Lelang berwaktu โ€” kenaikan minimum, perpanjangan anti-snipe, alert tersalip | | `text-poll` | Polling balas-angka yang jalan di semua client โ€” tally, bar, penanganan seri | | `tictactoe` | Duel XO โ€” tantang/terima, papan emoji, menang/seri/menyerah | | `rps` | Suit batu-gunting-kertas โ€” pilihan tersembunyi, alias Indonesia, taruhan | | `word-games` | scrambleWord, generator soal matematika, engine "sambung kata" | | `rental` | Sewa bot per chat โ€” trial, peringatan kedaluwarsa, filter grup belum sewa | | `message-counter` | Aktivitas harian per user โ€” top chatter, rekap ๐Ÿฅ‡, riwayat harian | | `command-lock` | Matikan command per chat/global + mode maintenance dengan bypass owner | | `status-tools` | Auto-style status โ€” font/warna acak untuk status teks, normalisasi media/audio (terpasang di jalur kirim status) | | `newsletter-tools` | Operasi channel massal ber-jeda โ€” follow/unfollow/mute banyak dengan hasil per-jid | | `emoji-tools` | Deteksi/hitung/ekstrak/buang emoji, randomEmoji bertema | | `array-tools` | chunk, unique-by, groupBy, sortBy, sample unik, range | | `validate-tools` | isUrl/isEmail, parseBool id/en, clamp, ensureArray, pickFields | | `timing-tools` | debounce, throttle, stopwatch lap, measureTime | | `task-queue` | Job async konkuren terbatas + retry โ€” aman untuk DM massal | | `mask-tools` | maskPhone/maskEmail, censorText sadar batas kata | | `math-eval` | Parser !calc AMAN (tanpa eval) + terbilang + angka Romawi | | `chat-settings` | Toggle fitur per chat dengan default โ€” tulang punggung !settings, kartu โœ…/โŒ | | `voucher` | Buat & tukar kode (JAP-X7K2-9QMD) โ€” batas pakai, kedaluwarsa, sekali per user | | `quiz` | Sesi kuis multi-soal โ€” skor berjalan, skip, peringkat | | `socket-preflight` | validateSocketConfig โ€” tangkap config rusak sebelum jadi 405 misterius (otomatis di makeWASocket) | | `group-cache` | createGroupMetadataCache โ€” TTL-LRU untuk `cachedGroupMetadata` dengan invalidasi via event | | `reputation` | +rep/-rep dengan cooldown per pemberi, leaderboard, kartu rep | | `invite-tracker` | Siapa mengundang siapa โ€” hitungan aktif-vs-total (loop join/leave tak dibayar), papan top inviter | | `level-rewards` | attachLevelRewards โ€” payout otomatis (saldo/tier/custom) di ambang level, sekali saja | | `marriage` | Registri lamar/terima/cerai โ€” monogami ketat, hari jadi, daftar pasangan | | `ai-groups` | โš ๏ธ EKSPERIMENTAL: tambah/hapus Meta AI di grup, createAiGroup โ€” digerbang server per-akun oleh rollout Meta (tanpa flag = server menolak; tidak ada verifikasi manual) | | `auto-reply` | Engine auto-responder sederhana berbasis kata kunci/pola | | `message-search` | Cari pesan di cache/store, membuka wrapper ephemeral/view-once dulu | | `message-retry-manager` | Menangani protokol retry-receipt WhatsApp untuk pesan yang gagal didekripsi | | `scheduling` | Jadwalkan pesan/aksi untuk dikirim nanti | | `business` | Helper profil bisnis & katalog | | `chat-control` | Helper pin, mute, arsip, dan tandai dibaca/belum | | `chat-history-helpers` | Bekerja dengan payload riwayat chat tersinkron | | `link-preview` | Membuat metadata preview link untuk pesan keluar | ```js // anti-delete + anti-edit berbagi satu MessageStore import { MessageStore, createMessageStoreHandler, createAntiDeleteUpsertHandler, createAntiEditUpsertHandler } from '@japofc/baileys' const store = new MessageStore() sock.ev.on('messages.upsert', createMessageStoreHandler(store)) // daftarkan DULUAN sock.ev.on('messages.upsert', createAntiDeleteUpsertHandler(store, (info) => { console.log('terhapus:', info.originalMessage) // konten terpulihkan })) sock.ev.on('messages.upsert', createAntiEditUpsertHandler(store, (info) => { console.log(`edit #${info.editCount}: "${info.beforeText}" -> "${info.afterText}"`) info.history // semua revisi sebelumnya, dari yang paling lama })) ``` ```js // tracker event โ€” reaksi / tanda-baca / presence import { createReactionTracker, createReceiptTracker, createPresenceTracker } from '@japofc/baileys' const reaksi = createReactionTracker() reaksi.bind(sock) // messages.reaction reaksi.getSummary(msg.key) // { '๐Ÿ‘': ['628โ€ฆ@s.whatsapp.net'], โ€ฆ } reaksi.onReaction(({ user, emoji, removed }) => { /* update live */ }) const tandaTerima = createReceiptTracker() tandaTerima.bind(sock) // message-receipt.update + messages.update tandaTerima.getReceipts(msg.key) // { delivered: [...], read: [...], played: [...] } tandaTerima.isReadBy(msg.key, jid) // user INI sudah baca? tandaTerima.onRead(({ key, user }) => { /* sekali per pembaca */ }) const presence = createPresenceTracker() presence.bind(sock) // presence.update await sock.presenceSubscribe(jid) // WA hanya kirim presence untuk jid yang di-subscribe presence.isOnline(jid); presence.isTyping(jid); presence.get(jid)?.lastSeen presence.onChange(({ user, presence }) => { /* transisi online/offline/ngetik */ }) ``` ```js // toolkit bot โ€” serializer, call guard, event grup, view-once, anti-link import { serializeMessage, createCallGuard, createGroupEventsTracker, createViewOnceCapture, createAntiLinkGuard } from '@japofc/baileys' sock.ev.on('messages.upsert', async ({ messages }) => { const m = serializeMessage(sock, messages[0]) if (!m || m.fromMe) return if (m.body === 'ping') await m.reply('pong') // otomatis quote pesan asli if (m.isMedia) { const buf = await m.download() } // media jadi Buffer if (m.quoted) console.log('membalas:', m.quoted.body) }) const panggilan = createCallGuard({ autoReject: true, rejectMessage: 'Bot tidak bisa angkat telepon.' }) panggilan.bind(sock) // event 'call' panggilan.onRejected(call => console.log('ditolak', call.from, call.isVideo ? '(video)' : '')) const grup = createGroupEventsTracker() grup.bind(sock) // group-participants.update + groups.update grup.onJoin(({ id, participants }) => sock.sendMessage(id, { text: `Selamat datang ${participants.join(', ')}! ๐Ÿ‘‹` })) grup.onLeave(({ participants }) => console.log('keluar:', participants)) const brankas = createViewOnceCapture() brankas.bind(sock) // messages.upsert brankas.onViewOnce(({ msg, unwrapped }) => console.log('view-once', unwrapped.mediaType, 'dari', msg.key.remoteJid)) const antilink = createAntiLinkGuard({ autoDelete: true }) // link undangan di grup antilink.bind(sock) antilink.onDetected(({ chat, sender }) => sock.sendMessage(chat, { text: `@${sender.split('@')[0]} dilarang share link grup!`, mentions: [sender] })) ``` ```js // auto-read, AFK & tag-all import { createAutoRead, createAfkManager, sendMentionAll, sendHideTag } from '@japofc/baileys' const reader = createAutoRead({ denylist: ['bos@s.whatsapp.net'] }) reader.bind(sock) // sisanya auto centang biru begitu masuk reader.pause(); reader.resume() const afk = createAfkManager() afk.bind(sock) afk.setAfk(sender, 'istirahat makan ๐Ÿœ') // mis. dari command !afk afk.onAfkMention(({ chat, afkUser, reason, msg }) => sock.sendMessage(chat, { text: `@${afkUser.split('@')[0]} lagi AFK: ${reason}`, mentions: [afkUser] }, { quoted: msg })) afk.onReturn(({ user, missed }) => console.log(user, 'sudah balik,', missed.length, 'ping selama pergi')) await sendMentionAll(sock, groupJid, 'Rapat 5 menit lagi!') // @everyone kelihatan await sendHideTag(sock, groupJid, 'Pengumuman diam-diam') // semua ke-ping, teks bersih // upgrade serializeMessage: m.isViewOnce, m.viewOnce, m.expiration, m.forward(jid), m.delete() ``` ```js // pairing jadi nyaman โ€” sekali panggil dari socket sampai terpasang import { pairWithCode, getPairingCodeInfo } from '@japofc/baileys' const hasil = await pairWithCode(sock, '628123456789', { customCode: 'abcd-efgh', // opsional โ€” format bebas, dinormalisasi otomatis onCode: (code, formatted) => console.log('Masukkan di HP:', formatted) }) if (hasil.restartRequired) { /* buat ulang socket โ€” standar setelah pairing */ } const info = getPairingCodeInfo(state.creds) console.log(info.formatted, 'โ€” kedaluwarsa dalam', Math.round(info.remainingMs / 1000), 'detik') // requestPairingCode sendiri kini juga menerima kode custom "abcd-efgh" / "ABCD EFGH" ``` ```js // paket komunitas & moderasi import { createFloodGuard, createWordFilter, createWarnManager, createGatekeeper, createLevelSystem } from '@japofc/baileys' const flood = createFloodGuard({ maxMessages: 8, windowMs: 10_000 }) flood.bind(sock) flood.onFlood(({ chat, user }) => warns.warn(user, { chat, reason: 'spam beruntun' })) const filter = createWordFilter({ words: ['judol'], patterns: [/j\s*u\s*d\s*o\s*l/i], autoDelete: true }) filter.bind(sock) filter.onMatch(({ chat, sender }) => warns.warn(sender, { chat, reason: 'kata terlarang' })) const warns = createWarnManager({ threshold: 3 }) warns.onThreshold(async ({ user, chat }) => { await sock.groupParticipantsUpdate(chat, [user], 'remove') // tiga strike, keluar warns.reset(user, chat) }) const gate = createGatekeeper() gate.banUser('pengganggu@s.whatsapp.net', 'spam') sock.ev.on('messages.upsert', gate.filter(async ({ messages }) => { /* hanya trafik bersih */ })) const levels = createLevelSystem() levels.bind(sock) levels.onLevelUp(({ user, chat, level }) => sock.sendMessage(chat, { text: `๐ŸŽ‰ @${user.split('@')[0]} naik ke level ${level}!`, mentions: [user] })) levels.getLeaderboard(10, chat) // top 10 di grup ini ``` ```js // branding stiker, economy, mode malam & captcha join import { setStickerExif, readStickerExif, createEconomy, createGroupScheduler, createVerifier } from '@japofc/baileys' // murni JS โ€” tanpa node-webpmux, jalan di webp statis DAN animasi const stiker = setStickerExif(webpBuffer, { packName: 'Pack Gue', author: 'gue', emojis: ['๐Ÿ”ฅ'] }) await sock.sendMessage(jid, { sticker }) readStickerExif(stiker) // { 'sticker-pack-name': 'Pack Gue', โ€ฆ } const eco = createEconomy({ dailyAmount: [100, 200], streakBonus: 25, transferFee: 0.05 }) eco.claimDaily(user) // { claimed, amount, streak } atau { remainingMs } eco.transfer(userA, userB, 100) const modeMalam = createGroupScheduler() modeMalam.add({ group, action: 'close', at: '22:00' }) // hanya admin modeMalam.add({ group, action: 'open', at: '06:00' }) // semua bisa chat modeMalam.start(sock) const verifier = createVerifier({ timeoutMs: 120_000 }) verifier.bind(sock) // captcha matematika otomatis untuk member baru verifier.onChallenge(({ chat, user, question }) => sock.sendMessage(chat, { text: `๐Ÿ‘‹ @${user.split('@')[0]} verifikasi: ${question}`, mentions: [user] })) verifier.onFailed(({ chat, user }) => sock.groupParticipantsUpdate(chat, [user], 'remove')) // upgrade router โ€” guard & menu berkategori: router.command('kick', handler, { adminOnly: true, category: 'Admin' }) router.command('shutdown', handler, { ownerOnly: true }) // owners: [...] di createRouter router.command('daily', handler, { cooldownMs: 60_000, category: 'Economy' }) ``` ```js // analitik, anti-tagall, toko, backup grup & menfess import { createCommandStats, createAntiTagAllGuard, createShop, backupGroup, diffGroupBackup, restoreGroupSettings, createMenfessRelay } from '@japofc/baileys' const stats = createCommandStats() router.use(stats.middleware()) // hitung setiap command yang jalan stats.getTopCommands(5); stats.getBusiestHours() const antiTag = createAntiTagAllGuard({ threshold: 5, autoDelete: true }) antiTag.bind(sock) antiTag.onDetected(({ sender, hidden }) => console.log(sender, hidden ? 'hidetag!' : 'tag-all')) const toko = createShop(eco) // nyambung ke createEconomy() toko.addItem({ id: 'potion', name: 'Potion', price: 250, consumable: true }) toko.buy(user, 'potion', 2); toko.useItem(user, 'potion') eco.bet(user, 100, { winChance: 0.5, multiplier: 2 }) // upgrade economy const backup = await backupGroup(sock, groupJid) // setting + member, aman disimpan const diff = await diffGroupBackup(sock, backup) // joined/left/promoted/changed await restoreGroupSettings(sock, backup) // subjek, deskripsi, kunci grup const menfess = createMenfessRelay() menfess.bind(sock) await menfess.start(sock, sender, targetJid, 'pesan anonim pertama') // kedua pihak chat lewat bot sebagai Anon-1 / Anon-2 sampai kirim "stop" // upgrade lain: verifier { challenge: 'emoji' }, rank level (Newbieโ†’Legend) ``` ```js // catatan, ulang tahun, game, i18n, menu keren & permintaan join import { createNotes, createBirthdayManager, createGuessGame, createI18n, styleText, createJoinRequestManager } from '@japofc/baileys' const notes = createNotes() notes.set(chat, 'rules', 'Dilarang spam. Santun.') // !save rules โ€ฆ notes.get(chat, 'rules')?.content // !get rules const ultah = createBirthdayManager() ultah.set(user, { day: 17, month: 8, year: 2000, chat }) ultah.onBirthday(({ user, age, chat }) => sock.sendMessage(chat, { text: `๐ŸŽ‚ HBD @${user.split('@')[0]} (${age})!`, mentions: [user] })) ultah.start() const game = createGuessGame({ timeoutMs: 60_000 }) game.bind(sock) game.start(chat, { answer: 'Jakarta', hint: 'ibukota', reward: 500 }) game.onCorrect(({ user, reward }) => eco.add(user, reward, 'menang kuis')) const i18n = createI18n({ defaultLang: 'id' }) i18n.addLanguage('en', { greet: 'Hello {name}!' }) i18n.setChatLang(chat, 'en') // !lang en i18n.tFor(chat, 'greet', { name: 'Budi' }) styleText('Menu Bot', 'bold') // ๐— ๐—ฒ๐—ป๐˜‚ ๐—•๐—ผ๐˜ const joins = createJoinRequestManager({ denylist: [spammer] }) joins.bind(sock) // event join-request live joins.onRequest(({ user, approve, reject }) => approve()) await joins.sweep(sock, groupJid) // proses daftar pending // upgrade CLI: npx @japofc/baileys sticker in.webp out.webp --pack "Pack Gue" --author gue ``` ```js // perkakas sesi & sistem import { analyzeAuthState, repairAuthFolder, exportAuthToString, importAuthFromString, migrateFolderToAuthState, backupAuthStateRotating, createShutdownManager } from '@japofc/baileys' const laporan = await analyzeAuthState('./auth') // dokter sesi laporan.registered; laporan.counts; laporan.corrupted await repairAuthFolder('./auth') // karantina file rusak // kirim seluruh login sebagai SATU string (pola SESSION_ID) โ€” rahasiakan! const sessionString = await exportAuthToString('./auth') await importAuthFromString(sessionString, './auth') // di perangkat baru // pindahkan sesi folder ke adapter apa pun (SQLite/Redis/Mongo/single-file): const { state, saveCreds } = await useSQLiteAuthState('auth.db') await migrateFolderToAuthState('./auth', state, saveCreds) // backup terenkripsi bertimestamp yang bersih-bersih sendiri: await backupAuthStateRotating('./auth', './backups', { password, keep: 5 }) const shutdown = createShutdownManager({ sock, saveCreds }) shutdown.register('tutup db', () => db.close()) shutdown.attach() // SIGINT/SIGTERM โ†’ keluar rapi ``` ```bash # CLI: kelola sesi tanpa nulis kode npx @japofc/baileys session analyze ./auth npx @japofc/baileys session repair ./auth npx @japofc/baileys session export ./auth --out session.txt npx @japofc/baileys session import session.txt ./auth-baru ``` ```js // wizard, webhook, link, perkakas media & kesehatan import { createConversationFlow, createWebhookBridge, buildWaMeLink, parseWaLink, getImageDimensions, createMediaGuard, createHealthMonitor } from '@japofc/baileys' const flows = createConversationFlow() flows.define('order', [ { id: 'item', prompt: 'Mau pesan apa?' }, { id: 'qty', prompt: 'Berapa banyak?', validate: t => /^\d+$/.test(t) || 'Angka saja!' } ]) flows.bind(sock) await flows.start(sock, chat, sender, 'order') // mis. dari command !order flows.onComplete(({ answers }) => console.log(answers.qty, 'x', answers.item)) const bridge = createWebhookBridge('https://server.gue/hook', { secret, retries: 2 }) bridge.bind(sock) // pesan โ†’ backend/n8n lu buildWaMeLink('+62 812-3456-7890', 'Halo!') // https://wa.me/62812โ€ฆ?text=Halo%21 parseWaLink('https://chat.whatsapp.com/AbCโ€ฆ') // { type: 'group-invite', code } getImageDimensions(buffer) // { format: 'png', width, height } const media = createMediaGuard({ blocked: ['sticker'], autoDelete: true }) media.bind(sock) // "dilarang stiker di grup ini" const health = createHealthMonitor({ thresholds: { heapUsedMb: 400, eventLoopLagMs: 200 } }) health.onAlert(({ metric, value }) => sock.sendMessage(owner, { text: `โš ๏ธ ${metric}: ${value}` })) health.start() ``` ```js // pengerasan keamanan & stabilitas import { createBugShield, sanitizeText, installCrashGuard, createConnectionWatchdog, createSecureLogger, exportAuthToString, checkAuthPermissions, hardenAuthFolder, autoReconnect } from '@japofc/baileys' const shield = createBugShield({ autoDelete: true }) // anti pesan bug shield.bind(sock) shield.onDetected(({ sender, reasons }) => gate.banUser(sender, reasons.join(','))) sanitizeText(teksKotor) // buang RTLO/zalgo/banjir invisible installCrashGuard({ // bot tak pernah mati diam-diam onError: ({ type, error }) => sock.sendMessage(owner, { text: `๐Ÿ’ฅ ${type}: ${error?.message}` }).catch(() => {}) }) const watchdog = createConnectionWatchdog({ staleMs: 5 * 60_000 }) watchdog.bind(sock) watchdog.onStale(() => sock.end(new Error('koneksi basi'))) // auto-reconnect ambil alih watchdog.start() const logger = createSecureLogger() // kredensial TAK PERNAH masuk log const sock2 = makeWASocket({ auth: state, logger }) await exportAuthToString('./auth', { password }) // export JAPSESS2 terenkripsi AES await hardenAuthFolder('./auth') // chmod 700/600 semuanya await checkAuthPermissions('./auth') // audit kebocoran izin file autoReconnect(factory, { onGiveUp: ({ reason, attempts }) => kabariOwner(reason) // baru: hook nyerah + getStatus() }) ``` ```js // kartu JAP AI dari markdown, perkakas panggilan, presence & pintasan button import { AIRich, createCallLog, createCallGuard, createAlwaysOnline, createStatusWatcher, quickButtons, sendConfirm } from '@japofc/baileys' // satu kartu AI utuh dari string markdown (heading/kode/tabel otomatis) await AIRich.fromMarkdown('# Laporan\n\n```js\nconst x = 1\n```\n\n| A | B |\n|---|---|\n| 1 | 2 |', sock).send(jid) new AIRich(sock).addChecklist([{ text: 'sudah', done: true }, 'belum']) .addKeyValue({ Nama: 'JAP', Versi: '2.4.5' }) .addProgressBar('Unduhan', 70, 100) const callLog = createCallLog() // siapa nelpon, hasil, durasi callLog.bind(sock) createCallGuard({ // jam tenang + blokir keras autoReject: true, schedule: { from: '22:00', to: '06:00' }, // tolak hanya malam hari denylist: [pengganggu] // โ€ฆkecuali mereka: selalu }).bind(sock) createAlwaysOnline(sock).start() // titik hijau nyala terus const statuses = createStatusWatcher() // simpan story kontak statuses.bind(sock) statuses.onStatus(({ download }) => download()) await sendConfirm(sock, jid, 'Hapus semua data?') // confirm_yes/confirm_no await sendButtons(sock, jid, { text: 'Pilih', buttons: quickButtons(['A', 'B']) }) // ronde 50+ โ€” perkakas harian: import { rollDice, matchScore, phoneToJid, prettyPhone, formatRelative, getGroupAdmins, diffParticipants, summarizeMessage, createKVStore } from '@japofc/baileys' rollDice('2d6+3') // { rolls: [4, 2], total: 9 } matchScore('budi', 'ani') // 0-100, "jodoh meter" deterministik phoneToJid('+62 812-3456-7890') // 6281234567890@s.whatsapp.net prettyPhone('6281234567890') // +62 812-3456-7890 formatRelative(msg.timestamp) // '5m ago' getGroupAdmins(await sock.groupMetadata(jid)) summarizeMessage(msg) // '๐Ÿ“ท image: captionโ€ฆ' buat log const db = await createKVStore('./botdata.json') // DB persisten mini db.namespace('settings').set(jid, { welcome: true }) // paket anti-ban โ€” nomor baru, aksi grup aman, reconnect cerdas import { createAccountWarmup, classifyDisconnect, explainDisconnect, createGroupOpGuard, randomGaussian, createPresenceCycler } from '@japofc/baileys' const warmup = createAccountWarmup({ startedAt: loginPertamaTs }) if (warmup.trySend().allowed) await sock.sendMessage(jid, content) // hari 1 โ†’ 20 pesan, lalu 50, 100, 200, 400, 800, bebas sock.ev.on('connection.update', ({ connection, lastDisconnect }) => { if (connection !== 'close') return const verdict = classifyDisconnect(lastDisconnect) verdict.shouldReconnect ? restart() : console.log(explainDisconnect(lastDisconnect)) // ๐Ÿ”‘ [auth 401] Keluar dari HP โ€” sesi hilang, pairing ulang. }) const ops = createGroupOpGuard() const safe = ops.wrap(sock) // otomatis dijaga await safe.groupParticipantsUpdate(jid, users, 'add') // throw kalau lewat ~3 add/10 menit await sleep(randomGaussian(2000, 600, { clamp: [500, 5000] })) // jeda ala manusia createPresenceCycler(sock, { chats: [ownerJid] }).start() // aktivitas opt-in // acara komunitas โ€” giveaway, absen, lelang, polling import { createGiveaway, createAttendance, createAuction, createTextPoll } from '@japofc/baileys' const giveaway = createGiveaway({ keyword: 'ikut' }) giveaway.bind(sock) giveaway.start(chat, { prize: 'Voucher 50k', durationMs: 3600_000, winners: 2 }) giveaway.onEnd(({ winners }) => umumkan(winners)) // adil, RNG bisa diinjeksi const absen = createAttendance() absen.bind(sock) absen.open(chat, { title: 'Absen Pagi ๐ŸŒž' }) // member ketik "absen" await sock.sendMessage(chat, { text: absen.render(chat), mentions: absen.getMentions(chat) }) const lelang = createAuction() lelang.start(chat, { item: 'Akun ML', startBid: 50_000, minIncrement: 5_000, antiSnipeMs: 30_000 }) lelang.bid(chat, user, 60_000) // โ†’ accepted / too-low / already-leading lelang.onEnd(({ winner, amount }) => terjual(winner, amount)) const polls = createTextPoll() polls.bind(sock) // vote = balasan angka "1".."9" polls.start(chat, { question: 'Mabar jam?', options: ['19:00', '20:00', '21:00'] }) polls.onEnd(({ results }) => sock.sendMessage(chat, { text: polls.formatResults(results) })) // paket game โ€” duel & permainan kata import { createTicTacToe, createRPS, scrambleWord, generateMathProblem, createWordChain } from '@japofc/baileys' const ttt = createTicTacToe() ttt.challenge(chat, penantang, lawan); ttt.accept(chat, lawan) ttt.play(chat, user, 5) // kotak 1-9 โ†’ next/menang/seri await sock.sendMessage(chat, { text: ttt.render(chat) }) // papan emoji โŒโญ•3๏ธโƒฃ const suit = createRPS() suit.challenge(chat, a, b, { bet: 5000 }); suit.accept(chat, b) suit.pick(chat, a, 'batu') // pilihan tetap rahasia suit.onResult(({ winner, loser, bet }) => eco.transfer(loser, winner, bet)) game.start(chat, { answer: scrambleWord('bandung') }) // acak kata game.start(chat, generateMathProblem('hard')) // 17 ร— 8 - 24 = ? const sambung = createWordChain() // sambung kata sambung.start(chat, { firstWord: 'makan' }) await sambung.play(chat, user, 'nasi') // โœ… nโ€ฆ โ€” skor = panjang kata eco.rob(maling, korban) // upgrade: rampok dompet โ€” uang bank tetap aman // operasional bisnis bot โ€” sewa, aktivitas, kunci import { createRentalManager, createMessageCounter, createCommandLock } from '@japofc/baileys' const sewa = createRentalManager() sewa.add(groupJid, { days: 30 }); sewa.startTrial(grupBaru, { days: 3 }) sock.ev.on('messages.upsert', sewa.filter(handler)) // grup belum sewa diabaikan sewa.onExpiring(({ chat }) => ingatkan(chat)) // pengingat perpanjang (24 jam) sewa.onExpire(({ chat }) => sock.groupLeave(chat)) sewa.startSweeper() const counter = createMessageCounter() counter.bind(sock) counter.renderDigest(chat) // ๐Ÿฅ‡ @user โ€” 42 pesan (top chatter harian) const locks = createCommandLock({ owners: [ownerJid] }) locks.lock(chat, 'slot'); locks.lockGlobal('rob') router.use(locks.middleware()) // diblokir sebelum handler jalan locks.setMaintenance(true, { message: '๐Ÿ› ๏ธ maintenance' }) // owner tetap lolos // SAPUAN UPGRADE BESAR (36 upgrade di seluruh toolkit): // kv TTL + getOrSet ยท pin catatan ๐Ÿ“Œ ยท prioritas todo ๐Ÿ”ด๐ŸŸก ยท pengingat // berulang ยท warns.renderList ยท eco.getEconomyStats + eco.work() kerja ยท // shop.renderCatalog ยท tiers.extendAll (kompensasi downtime) ยท // quota.renderStatus ยท PRESTIGE level โญ ยท guess.revealHint('j_k__t_') ยท // rekor menang/kalah ttt + leaderboard ยท suit best-of-3 ยท syarat ikut // giveaway (canJoin) ยท streak absen ยท harga beli-langsung lelang ยท // poll renderLive bar ยท menfess.listActiveSessions ยท afk.renderAfkList ยท // shield.getReasonStats ยท gate.banMany (bersih-bersih raid) ยท warmup.skip ยท // opGuard.waitAndAssert ยท watchdog autoRestart ยท sparkline kesehatan โ–โ–…โ–ƒโ–ˆ ยท // command tersembunyi router + ctx.quotedText ยท i18n.addLanguages ยท // stats.renderTop ยท m.timestampMs ยท tag-all dipecah utk grup raksasa ยท // isForwarded/getForwardInfo ยท rental.renderList // // RONDE HUNT/UPDATE (ekosistem fork tuntas disapu โ€” 0 gap tersisa): // Versi WA โ†’ live 2.3000.1048680055 ยท backWords flow ('kembali' mundur) ยท // polling kondisional ETag/304 url-watcher ยท timeout probe health ยท // throttle alert crash-guard ยท batas body webhook ยท link bisnis // wa.me/message/CODE ยท formatParticipantChanges(โž•โž–โฌ†๏ธโฌ‡๏ธ) ยท boxText('MENU') โ•”โ•โ•— ยท // reminders.renderList // upgrade conversation-flow: langkah pilihan flows.define('order', [{ id: 'size', prompt: 'Ukuran:', choices: ['S', 'M', 'L'] }]) // dirender bernomor; jawaban diterima via teks ATAU angka // CLI: npx @japofc/baileys wa โ†’ versi paket + versi WA Web bawaan // +18 upgrade: titleCase/slugify/generateId, shop.updateItem, notes.exportText, // warns.getTop, stats.getTopChats, i18n.formatNumber/formatDate, levels.getRankPosition, // quota.getAllUsage, tiers.renderStatus, birthday.renderUpcoming, guess.startNumberGame, // flood.getTopFlooders, gate.listBans, health.setThreshold, watchdog.getReport // 10 upgrade lain: ban sementara gate.banUser(jid, r, { expiresInMs }), // flood autoMuteMs + isMuted, eco.applyInterest(0.01) bunga bank, // item toko maxPerUser, warns.decay(30 hari), levels.setMultiplier(2) event XP, // quota.setLimit live, tiers.getExpiring(3 hari) cron perpanjangan, // reminders.snooze(id, 10m), todos.setDue + getOverdue (โฐ di render) ``` #### Helper metadata grup / komunitas (v2.4.7) ```js import { extractLIDPNPairs, GROUP_PARTICIPANTS_CHUNK_SIZE } from '@japofc/baileys' // Semua pasangan LIDโ†”PN yang sudah dibawa oleh satu kali fetch metadata โ€” // ternormalisasi + tanpa duplikat. Socket kini menyimpannya otomatis pada // groupMetadata() / groupFetchAllParticipating() / communityMetadata(), jadi // getLIDForPN() dan getPNForLID() langsung mengenali anggota grup tanpa // round-trip USync tambahan. const meta = await sock.groupMetadata(jid) extractLIDPNPairs(meta) // [{ lid: '999@lid', pn: '628โ€ฆ@s.whatsapp.net' }, โ€ฆ] extractLIDPNPairs(cachedMeta) // murni + aman-null โ€” bisa untuk metadata cache GROUP_PARTICIPANTS_CHUNK_SIZE // 25 โ€” array peserta dipecah per ukuran ini ``` > Ikut diperbaiki di v2.4.7: metadata grup tidak lagi mengembalikan `NaN` untuk > `subjectTime` / `creation` / `descTime` saat WhatsApp tidak mengirimnya (sekarang > `undefined`, jadi tidak tersimpan sebagai `null`), dan metadata komunitas akhirnya > melaporkan `addressingMode` serta menghormati atribut `size` dari server โ€” keduanya > sebelumnya berbeda hasil dari parser grup untuk payload yang sama. #### Helper notifikasi grup `w:gp2` (v2.4.7) ```js import { resolveNotificationActors, extractNotificationLIDPNPairs, parseNotificationParticipants } from '@japofc/baileys' // Siapa pelakunya dan siapa targetnya โ€” diselesaikan sebagai SATU KESATUAN. Sebelum // v2.4.7 kedua sisinya jatuh ke fallback secara terpisah, jadi permintaan gabung bisa // melaporkan LID pemohon berdampingan dengan nomor telepon admin. const actors = resolveNotificationActors(notificationNode, actionChild) // { actingLid, actingPn, actingUsername, affectedLid, affectedPn, affectedIsActor } parseNotificationParticipants(actionChild) // bentuk messageStubParameters extractNotificationLIDPNPairs(node, actionChild) // [{ lid, pn }] โ€” hanya pasangan konsisten // Socket kini menyimpan pasangan itu otomatis pada setiap notifikasi grup, dan pasangan // basi bisa dihapus setelah event ganti nomor: await sock.signalRepository.lidMapping.removeMapping('628โ€ฆ@s.whatsapp.net') ``` #### Helper koneksi media & daftar perangkat (v2.4.7) ```js import { parseMediaConnNode, isMediaConnExpired, MEDIA_CONN_DEFAULT_TTL, dedupeJidsByUser, dedupeDeviceList } from '@japofc/baileys' // Handshake , diurai dengan aman. Sebelum v2.4.7 `ttl` yang hilang atau // bukan angka menjadi NaN, dan `now - fetchDate > NaN * 1000` selalu false โ€” jadi // koneksi upload tak pernah di-refresh lagi dan terus memakai token auth basi. const media = parseMediaConnNode(mediaConnNode) // { hosts, auth, ttl, fetchDate } โ€” ttl tak pernah NaN; jatuh ke 300 detik MEDIA_CONN_DEFAULT_TTL // 300 isMediaConnExpired(media) // false selama masih segar isMediaConnExpired({ ttl: NaN }) // true โ€” apa pun yang tak terpakai dianggap kedaluwarsa // Dedup yang mempertahankan urutan, dipakai fan-out perangkat USync. Mengirim pesan // ke nomor sendiri dulu mendata (dan mengenkripsi ke) setiap perangkat Anda dua kali. dedupeJidsByUser([{ jid: a }, { jid: a }, { jid: b }]) // โ†’ [a, b] dedupeDeviceList(devices) // kunci: user + indeks device; `u@s` === `u:0@s` ``` #### Membaca error USync (v2.4.7) ```js import { extractUSyncErrors, hasUSyncQueryError, USyncQuery, USyncUser } from '@japofc/baileys' const result = await sock.executeUSyncQuery( new USyncQuery().withContactProtocol().withUsers( new USyncUser().withPhone('+628111'), new USyncUser().withPhone('+628222') ) ) // Sebelum v2.4.7 query yang ditolak ("rate overlimit") terurai jadi list kosong yang // persis sama dengan "tidak ada yang cocok". Kini error server ikut di hasil. result.errors // [{ code: 479, text: 'rate overlimit' }] hasUSyncQueryError(result.errors) // true -> seluruh query gagal, jangan percaya `list` // false -> hanya user tertentu yang gagal (entri punya `jid`) extractUSyncErrors(rawIqNode) // ekstraksi yang sama, mandiri dan null-safe // onWhatsApp() kini benar-benar menerima argumen @lid (dulu dibuang diam-diam), selalu // mengembalikan array, dan memberi tahu LID asal setiap entri: await sock.onWhatsApp('628111@s.whatsapp.net', '99887766@lid') // [{ jid: '628111@s.whatsapp.net', exists: true, lid: undefined }, โ€ฆ] ``` #### Helper kamus store & daftar peserta (v2.4.7) ```js import { makeOrderedDictionary } from '@japofc/baileys' import { upsertParticipants, removeParticipants, setParticipantsAdmin } from '@japofc/baileys' // Memulihkan snapshot dulu mengganti array tapi tidak indeks id-nya, jadi setiap pesan // kembali dalam keadaan tak terlihat oleh get() dan upsert ulang malah menambah duplikat. const dict = makeOrderedDictionary(m => m.key.id) dict.fromJSON(JSON.parse(snapshot)) dict.get('AAA') // pesan yang dipulihkan, bukan undefined dict.update(versiBaru) // true kalau benar-benar ter-update (dulu selalu false) dict.has('AAA') // baru di v2.4.7 dict.size() // baru di v2.4.7 // Mutasi daftar peserta: mempertahankan urutan, tidak memutasi input, dan mencocokkan // orang lewat `id` ATAU `phoneNumber` (dua sisi pasangan LID<->PN = anggota yang sama). upsertParticipants(list, [{ id: '2@lid' }]) // merge, tidak pernah duplikat setParticipantsAdmin(list, [{ id: '1@lid' }], null) // demote -> admin: null (bukan false) removeParticipants(list, [{ phoneNumber: '628โ€ฆ@s.whatsapp.net' }]) ``` #### Round-trip repositori label (v2.4.7) ```js import { ObjectRepository } from '@japofc/baileys' // toJSON() menghasilkan array, tapi constructor-nya hanya paham map { id: entity }, jadi // memasukkan snapshot kembali menghasilkan entri ber-key '0', '1', โ€ฆ dan semua label hilang. const labels = new ObjectRepository({ L1: { id: 'L1', name: 'Work' } }) const restored = ObjectRepository.fromJSON(JSON.parse(JSON.stringify(labels))) restored.findById('L1') // { id: 'L1', name: 'Work' } โ€” bukan undefined restored.hasId('L1') // baru di v2.4.7 restored.load([{ id: 'L2', name: 'Family' }]) restored.clear() ``` #### Klasifikasi daftar chat (v2.4.7) ```js import { classifyMessage, isMissedCallMessage, MISSED_CALL_STUB_TYPES } from '@japofc/baileys' // Sebelum v2.4.7 panggilan tak terjawab tak pernah bisa jadi pesan "nyata" โ€” cek konten // ikut di-AND ke cabang stub โ€” jadi chat-nya tak pernah naik ke atas daftar. classifyMessage(missedCallStub, meId) // { isReal: true, isStub: true, isMissedCall: true, isAboutMe: false, // incrementsUnread: false, contentType: undefined } classifyMessage(textMessage, meId).contentType // 'conversation' isMissedCallMessage(msg) // true untuk 4 stub panggilan tak terjawab MISSED_CALL_STUB_TYPES // tabelnya sendiri ``` #### Membaca `messageStubParameters` (v2.4.7) ```js import { parseStubParticipant, stubParticipantIdentities, stubParticipantsInclude } from '@japofc/baileys' // Parameter stub bentuknya tak seragam: pasangan JSON untuk sebagian tipe, jid polos untuk lainnya. parseStubParticipant('{"lid":"1@lid","pn":"2@s.whatsapp.net"}') // { lid, pn } parseStubParticipant('628111@s.whatsapp.net') // { phoneNumber } stubParticipantIdentities(p) // semua jid yang bisa dipakai menyapa orang ini // "Apakah salah satunya saya?" โ€” cek lid DAN pn, jadi grup ber-LID ikut cocok. stubParticipantsInclude(msg.messageStubParameters, sock.user.id, sock.user.lid) ``` > Permintaan gabung lewat invite link kini juga memancarkan `group.join-request` (dulu > hanya varian admin-add), jadi `createJoinRequestManager()` bisa melihatnya. ```js // ronde 20+: perkakas teks, pengingat, jatah, tier, todo & lainnya import { readMore, progressBar, formatDuration, chunkText, similarity, parseDuration, createReminderManager, createQuotaManager, createTierManager, createTodoList, createUrlWatcher, getZodiac } from '@japofc/baileys' readMore('Promo!', 'detail panjangโ€ฆ') // tersembunyi di balik "Baca selengkapnya" progressBar(70, 100) // โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–‘โ–‘โ–‘ 70% formatDuration(93_784_000) // 1d 2h 3m chunkText(teksPanjang, 4000) // pecah sesuai batas WA const reminders = createReminderManager() reminders.add({ chat, user, text: 'angkat gorengan', inMs: parseDuration('10m') }) reminders.onDue(({ chat, user, text }) => sock.sendMessage(chat, { text: `โฐ @${user.split('@')[0]} ${text}`, mentions: [user] })) const tiers = createTierManager() tiers.setTier(user, 'premium', { days: 30 }) const quota = createQuotaManager({ defaultLimit: 20, limits: { premium: 200 } }) if (!quota.consume(sender, tiers.getTier(sender)?.name).allowed) return ctx.reply('Jatah habis!') const todos = createTodoList() todos.add(chat, 'bayar wifi', { assignee: member }) await sock.sendMessage(chat, { text: todos.render(chat), mentions: todos.mentions(chat) }) const watcher = createUrlWatcher('https://api.contoh.com/status.json', { intervalMs: 60_000 }) watcher.onChange(({ body }) => sock.sendMessage(owner, { text: `๐Ÿ”” berubah: ${body.slice(0, 300)}` })) watcher.start() // upgrade: eco.deposit/withdraw + eco.getRank, levels.renderRankCard, // router { onUnknownCommand } + router.remove, i18n.tn bentuk jamak, // styleText 'negativeSquared'/'boldFraktur', getZodiac(17, 8) โ†’ 'Leo', // hint "dikit lagi!" guess-game, formatHealthSnapshot buat DM owner ``` | `stickerpack` | Bangun dan kirim paket stiker (termasuk animasi/Lottie) | | `templates` | Helper pesan template WhatsApp Business lama | | `vcard` | Bangun payload vCard (kartu kontak) | | `status` | Posting dan kelola update Status WhatsApp | | `event-buffer` | Buffer/gabungkan event socket bervolume tinggi untuk bot berat | | `doctor` | `checkEnvironment()` / `printEnvironmentReport()` โ€” diagnosa lingkungan sekali panggil | Setiap modul di atas punya `.d.ts` pasangan, jadi editormu menampilkan dokumentasi hover lengkap apa pun yang kamu import.
--- ## ๐Ÿ›  Lingkungan yang Direkomendasikan | Kebutuhan | Versi | |---|---| | Node.js | 20+ | | Sistem modul | ESM | | WhatsApp | Multi Device terbaru | --- ## ๐Ÿ“˜ Dukungan TypeScript `.d.ts` penuh: setiap file `.js` yang di-ship punya deklarasi TypeScript pasangan (dijaga `tests/types-parity.test.js`), dan seluruh paket terverifikasi nol error di bawah `tsc --strict`. `import { ... } from '@japofc/baileys'` ter-resolve tanpa paket `@types/` tambahan (selain `@types/node` standar yang dimiliki semua proyek TS Node): `makeWASocket` termasuk method username dan konstanta `USERNAME_*`, semua definisi `Types/*`, `WAProto`, store, `Utils/*`, builder pesan (`Button`, `Poll`, `Carousel`, `AIRich`, `A2UI`, โ€ฆ dengan tipe node Bloks), Bot Framework (`Bot`, `Context`, โ€ฆ), dan klien VoIP (`VoipClient`, `ActiveCall`, โ€ฆ). Payload wire kompleks bertipe record longgar di bagian yang WhatsApp tidak mempublikasikan skemanya. --- ## โ“ FAQ & Troubleshooting
Koneksi terus putus / reconnect loop
Cek `connection.update` untuk field `lastDisconnect.error`. Kalau status code-nya `401` (loggedOut), sesi memang sudah invalid dan perlu scan ulang QR โ€” jangan auto-reconnect di kondisi ini. Untuk status lain (`428`, `440`, dsb.), reconnect dengan backoff biasanya cukup.
QR tidak muncul / tidak ke-scan
Di upstream Baileys `printQRInTerminal` sudah dihapus, tapi di paket ini opsi tersebut **berfungsi lagi** โ€” QR digambar otomatis oleh renderer bawaan (vendored [qrcodegen](https://github.com/nayuki/QR-Code-generator), tanpa dependency tambahan). Bisa juga render manual dari event `qr` dengan `renderQRToTerminal(qr)` / `qrToSVG(qr)` / `qrToPNG(qr)` / `qrToMatrix(qr)`. Kalau QR muncul tapi gagal linking, biasanya karena versi WA Web (`version` di `makeWASocket`) sudah kedaluwarsa; fetch versi terbaru lewat `fetchBestWaVersion()` (chain: sw.js WA โ†’ fork baileys โ†’ fallback). Framework `Bot` sudah melakukannya otomatis tiap `start()`/reconnect (matikan dengan `versionCheck: false`). QR kelihatan "kebalik" di terminal tema terang? Pakai `renderQRToTerminal(qr, { inverted: true })`.
Error "Bad MAC" / pesan gagal didekripsi
Umumnya terjadi kalau folder auth state korup atau sesi dipakai di lebih dari satu proses secara bersamaan. Pastikan hanya satu instance yang menulis ke folder auth state yang sama, dan pertimbangkan `pruneStaleAuthFiles()` untuk membersihkan sender-key lama secara berkala.
Memory terus naik di bot yang jalan lama
Kalau pakai `makeInMemoryStore()`, cache chat/message/contact akan terus tumbuh tanpa batas. Untuk bot yang jalan lama, pertimbangkan pindah ke salah satu backend `makePersistentStore()` (SQLite/Redis/dst) dan pakai `event-buffer` untuk meredam lonjakan event di trafik tinggi.
Voice call gagal connect
Fitur ini masih experimental dan butuh peer dependency `@roamhq/wrtc` โ€” pastikan sudah terinstall dan platform kamu didukung native binding-nya. Cek event `call.on('ended', reason => ...)` untuk detail penyebab gagalnya.
Fitur media error / "ffmpeg not found"
Jalankan `printEnvironmentReport()` (lihat [doctor](#cek-lingkunganmu-doctor)) โ€” dia menunjukkan persis apa yang kurang. Untuk ffmpeg: di server `npm i ffmpeg-static`, di Termux `pkg install ffmpeg` โ€” dua-duanya auto-terdeteksi tanpa konfigurasi.
Banner startup mengganggu / mau dimatikan
Banner adalah bagian dari identitas paket ini dan tampil sekali per proses. Dirancang supaya tidak mengganggu: di terminal interaktif tampil banner penuh; di log CI/pm2/pipe menyusut jadi satu baris teks polos (tanpa kode ANSI, jadi pipeline log JSON/terstruktur tidak pernah rusak). `NO_COLOR=1` menghilangkan pewarnaan, bukan banner-nya. Sejak v2.4.3 banner sekaligus jadi kartu kesehatan startup โ€” wordmark gradien plus panel info berbingkai: versi paket, versi WA Web bawaan, node/platform/pid, dan tagline harian yang berganti: ```text โ–ˆโ–ˆโ•— โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•— โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•— โ–ˆโ–ˆโ•‘ โ–ˆโ–ˆโ•”โ•โ•โ–ˆโ–ˆโ•— โ–ˆโ–ˆโ•”โ•โ•โ–ˆโ–ˆโ•— โ–ˆโ–ˆโ•‘ โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•‘ โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•”โ• โ–ˆโ–ˆ โ–ˆโ–ˆโ•‘ โ–ˆโ–ˆโ•”โ•โ•โ–ˆโ–ˆโ•‘ โ–ˆโ–ˆโ•”โ•โ•โ•โ• โ•šโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•”โ• โ–ˆโ–ˆโ•‘ โ–ˆโ–ˆโ•‘ โ–ˆโ–ˆโ•‘ โ•šโ•โ•โ•โ•โ• โ•šโ•โ• โ•šโ•โ• โ•šโ•โ• โ•ญโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฎ โ”‚ @japofc/baileys v2.4.5 โ— typed ยท extended ยท battle-tested โ”‚ โ”‚ WA Web 2.3000.1048680055 node 20.20.2 ยท linux/x64 ยท pid 1472 โ”‚ โ”‚ โšก anti-ban toolkit ๐Ÿ›ก๏ธ bug-shield ๐Ÿ“š github.com/JAPofc/baileys โ”‚ โ•ฐโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฏ "from Termux to production." โ€” Made with ๐Ÿƒ by J.AP ```
--- ## ๐Ÿค Kontribusi Kontribusi dipersilakan, terutama untuk perbaikan bug, dokumentasi, dan enhancement pada `MessageBuilder` / `AIRich`. 1. Fork repo ini, buat branch dari `main` (`feat/nama-fitur` atau `fix/nama-bug`) 2. Pastikan perubahan tetap ESM-only dan menyertakan/menyesuaikan `.d.ts` terkait 3. Uji perubahan pada minimal satu jalur auth state + satu store backend sebelum PR 4. Buka Pull Request dengan deskripsi singkat: apa yang berubah dan kenapa Untuk laporan bug, sertakan versi Node.js, cara reproduksi, dan potongan log `lastDisconnect.error` bila relevan โ€” atau lebih baik lagi, lampirkan output `printEnvironmentReport()` dan `monitor.getDebugInfo()` (dua-duanya aman, rahasia sudah diredaksi otomatis). --- ## ๐Ÿ™ Kredit Dibangun di atas pundak komunitas open-source WhatsApp. Detail lengkap dan ketentuan lisensi per komponen: lihat [`NOTICE.md`](./NOTICE.md). --- ## ๐Ÿ‘‘ Maintainer
Avatar J.AP **J.AP** - GitHub: [github.com/JAPofc](https://github.com/JAPofc) - Paket: [`@japofc/baileys`](https://www.npmjs.com/package/@japofc/baileys) - โœฆ Merawat fork ini sendirian โ€” issue & PR dipersilakan dan direview langsung.
--- ## ๐Ÿ“ Arsip Catatan Rilis > Riwayat lengkap tiap versi ada di [CHANGELOG.md](./CHANGELOG.md). Di bawah ini ringkasan rilis-rilis sebelumnya.
๐Ÿ—‚๏ธ Buka ringkasan rilis lama (v2.4.2 & v2.4.3)
### v2.4.3 - **Acara komunitas**: `createGiveaway` (undian adil), `createAttendance` (absen + streak), `createAuction` (anti-snipe + beli-langsung), `createTextPoll` (polling balas-angka, jalan di semua client). - **Game**: `createTicTacToe` (rekor + leaderboard), `createRPS` (suit, pilihan rahasia, best-of-N), `createWordChain` (sambung kata), `scrambleWord`, `generateMathProblem`. - **Bisnis bot**: `createRentalManager` (sewa per chat, trial sekali seumur hidup, filter grup belum-sewa), `createMessageCounter` (rekap harian ๐Ÿฅ‡), `createCommandLock` (+mode maintenance dengan bypass owner). - **Ekosistem fork tuntas disapu** (upstream rc14 + 8 fork hidup di-download & di-diff API-nya โ€” nol gap tersisa): diambil `status-tools` (status teks auto-bergaya, terpasang di jalur kirim status) dan `newsletter-tools` (batch follow/unfollow/mute ber-jeda). - **Grup AI (eksperimental, digerbang server)**: `addAiBotToGroup` / `createAiGroup` โ€” Meta AI di grup; diterima/tidaknya tergantung rollout per-akun dari Meta, penolakan muncul sebagai kode status. - **Sapuan 36 upgrade** di seluruh toolkit (kv TTL, pin catatan, pengingat berulang, economy `work()`/`rob()`/bunga, PRESTIGE level โญ, `revealHint`, ban sementara, `waitAndAssert`, watchdog `autoRestart`, sparkline, `ctx.quotedText`, polling ETag, throttle alert, `boxText`, dll) + 9 lanjutan. - **Banner startup v2**: kartu kesehatan berbingkai (versi paket + WA Web, node/platform/pid, tagline harian). - Versi WA Web โ†’ live `2.3000.1048680055`; CLI dapat `wa` dan `sticker`. ### v2.4.2 - **Paket anti-ban**: `createAccountWarmup` (ramp harian 20โ†’50โ†’โ€ฆโ†’bebas), `classifyDisconnect`/`explainDisconnect`, `createGroupOpGuard` (~3 add/2 create per 10 menit + `wrap(sock)`), jitter Gaussian, `createPresenceCycler` opt-in. - **Keamanan & stabilitas**: `createBugShield` (bom mention/zalgo/RTLO + `sanitizeText`), `createSecureLogger` + `redactSensitive`, string sesi terenkripsi `JAPSESS2`, `hardenAuthFolder`, `installCrashGuard` + `safeStringify`, `createConnectionWatchdog`. - **Perkakas sesi & DB**: `analyzeAuthState` (dokter sesi), `repairAuthFolder`, export/import sesi portabel, `migrateFolderToAuthState`, `backupAuthStateRotating`, `createShutdownManager`, command CLI `session`. - **Moderasi & komunitas**: flood/word-filter/warn/gatekeeper/level/quota/tier/economy+shop/command-stats/anti-tagall/verifier/join-requests/group-backup/menfess. - **Toolkit bot**: `serializeMessage`, call guard + call log, group events, toolkit view-once, anti-link, anti-delete/edit, tracker reaction/receipt/presence, auto-read, AFK, tag-all/hidetag, pairing tools (`pairWithCode`), guard router, conversation flows, webhook bridge, health monitor, i18n, fancy-text โ€” total 140+ modul utilitas. - **EXIF stiker murni JS** โ€” dependensi `node-webpmux` dihapus; branding stiker jalan di Termux; command CLI `sticker`.
--- ## โš ๏ธ Disclaimer Proyek ini adalah fork independen. Gunakan dengan bertanggung jawab dan patuhi Ketentuan Layanan WhatsApp. ---
Dibuat dengan ๐Ÿƒ oleh **JAP** Terima kasih sudah mampir, sampai jumpa ๐Ÿ‘‹ โฌ†๏ธ Kembali ke atas