@japofc/baileys 2.1.0

package/README.md

@@ -0,0 +1,1254 @@
+<div align="center" id="top">
+
+<img src="https://capsule-render.vercel.app/api?type=waving&color=0:2ecc71,100:1d6a23&height=180&section=header&text=%40japofc%2Fbaileys&fontSize=48&fontColor=ffffff&animation=fadeIn&fontAlignY=35&desc=WhatsApp%20Web%20API%20%E2%80%94%20typed%2C%20extended%2C%20battle-tested&descSize=16&descAlignY=55" width="100%" alt="@japofc/baileys banner"/>
+
+<p>
+  <img src="https://readme-typing-svg.demolab.com?font=Fira+Code&size=18&pause=1200&color=2ECC71&center=true&vCenter=true&width=650&lines=Extended+interactive+messages+%26+native+flow;Status+tools+%2B+quality-of-life+fixes;WhatsApp+automation+toolkit" alt="Typing SVG" />
+</p>
+
+<p>
+<a href="https://www.npmjs.com/package/@japofc/baileys" target="_blank"><img src="https://img.shields.io/npm/v/@japofc/baileys?color=2ecc71&label=npm&style=for-the-badge" alt="npm version"/></a>
+<a href="https://www.npmjs.com/package/@japofc/baileys" target="_blank"><img src="https://img.shields.io/npm/dt/@japofc/baileys?color=3498db&style=for-the-badge" alt="npm downloads"/></a>
+<a href="https://github.com/JAPofc/baileys/stargazers" target="_blank"><img src="https://img.shields.io/github/stars/JAPofc/baileys?color=f1c40f&style=for-the-badge" alt="GitHub stars"/></a>
+<a href="https://github.com/JAPofc/baileys/issues" target="_blank"><img src="https://img.shields.io/github/issues/JAPofc/baileys?color=e74c3c&style=for-the-badge" alt="GitHub issues"/></a>
+</p>
+<p>
+<a href="https://github.com/JAPofc/baileys/actions/workflows/ci.yml" target="_blank"><img src="https://img.shields.io/github/actions/workflow/status/JAPofc/baileys/ci.yml?branch=main&style=flat-square&label=CI&color=2ecc71" alt="CI status"/></a>
+<img src="https://img.shields.io/badge/tests-174%20passing-2ecc71?style=flat-square" alt="Tests"/>
+<img src="https://img.shields.io/badge/tsc%20--strict-clean-3178c6?style=flat-square&logo=typescript&logoColor=white" alt="tsc strict clean"/>
+<img src="https://img.shields.io/github/last-commit/JAPofc/baileys?color=9b59b6&style=flat-square" alt="Last commit"/>
+<img src="https://img.shields.io/github/languages/code-size/JAPofc/baileys?color=e67e22&style=flat-square" alt="Code size"/>
+<img src="https://img.shields.io/badge/node-%3E%3D20-brightgreen?style=flat-square" alt="Node >=20"/>
+<img src="https://img.shields.io/badge/module-ESM-blue?style=flat-square" alt="ESM"/>
+<img src="https://img.shields.io/badge/dependencies-zero%20QR%2FPNG%20deps-success?style=flat-square" alt="Zero extra deps"/>
+<img src="https://img.shields.io/badge/license-see%20NOTICE-lightgrey?style=flat-square" alt="License"/>
+</p>
+
+<p>
+<img src="https://komarev.com/ghpvc/?username=JAPofc&repo=baileys&color=2ecc71&style=for-the-badge&label=Repo+Views" alt="Visitor count"/>
+</p>
+
+<p>
+<a href="#-why-this-fork">About</a> &#xa0;|&#xa0;
+<a href="#-comparison">Comparison</a> &#xa0;|&#xa0;
+<a href="#-features">Features</a> &#xa0;|&#xa0;
+<a href="#-installation">Installation</a> &#xa0;|&#xa0;
+<a href="#-quick-start">Quick Start</a> &#xa0;|&#xa0;
+<a href="#-usage-examples">Examples</a> &#xa0;|&#xa0;
+<a href="#-faq--troubleshooting">FAQ</a> &#xa0;|&#xa0;
+<a href="#-contributing">Contributing</a> &#xa0;|&#xa0;
+<a href="#-credits">Credits</a> &#xa0;|&#xa0;
+<a href="#-maintainer">Maintainer</a>
+</p>
+
+<details>
+<summary>📖 Full table of contents</summary>
+<br/>
+
+- [🍃 Why this fork](#-why-this-fork)
+- [🆚 Comparison](#-comparison)
+- [🧰 Built With](#-built-with)
+- [🔥 Features](#-features)
+- [✨ Exclusive J.AP Enhancements](#-exclusive-jap-enhancements)
+- [📦 Installation](#-installation)
+- [🚀 Quick Start](#-quick-start)
+- [🔐 Authentication](#-authentication)
+- [🗄️ Store Backends](#-store-backends)
+- [💡 Usage Examples](#-usage-examples)
+- [📨 Message Helpers](#-message-helpers)
+- [🧰 Channels, History & Transcripts](#-channels-history--transcripts)
+- [🔐 Security Pack](#-security-pack)
+- [🆕 WA 2026 catch-up](#-wa-2026-catch-up)
+- [🆕 Everyday Utilities](#-everyday-utilities)
+  - [Buttons & Native Flow](#buttons--native-flow)
+  - [Poll](#poll)
+  - [Carousel](#carousel)
+  - [AIRich — rich response cards](#airich--rich-response-cards)
+  - [📁 Builders Folder Map](#-builders-folder-map-libbuilders)
+  - [📌 Pin / Keep in Chat](#-pin--keep-in-chat)
+  - [📞 Scheduled Call](#-scheduled-call)
+  - [📱 Mini App](#-mini-app)
+- [📞 Voice & Video Calls](#-voice--video-calls)
+- [🔎 User Sync Queries](#-user-sync-queries)
+- [👤 Username Management](#-username-management)
+- [🤖 Bot Framework](#-bot-framework)
+- [🧩 Utility Modules](#-utility-modules)
+- [🛎️ System Notification Filter](#system-notification-filter)
+- [🛠 Recommended Environment](#-recommended-environment)
+- [📘 TypeScript Support](#-typescript-support)
+- [❓ FAQ & Troubleshooting](#-faq--troubleshooting)
+- [🤝 Contributing](#-contributing)
+- [🙏 Credits](#-credits)
+- [👑 Maintainer](#-maintainer)
+- [⚠️ Disclaimer](#-disclaimer)
+- [📝 Patch Notes](#-v210-patch-notes)
+
+</details>
+
+</div>
+
+---
+
+## 🍃 Why this fork?
+
+This fork focuses on:
+
+| | |
+|---|---|
+| 🚀 | Better developer experience |
+| 🎯 | Extended native flow support |
+| 📢 | Advanced status & broadcast features |
+| 🧩 | More interactive message types |
+| ⚡ | Cleaner implementation for bot developers |
+| 🔧 | Extra utilities not available in standard Baileys forks |
+| 🗄️ | Multiple auth & store backends out of the box (file, SQLite, MongoDB, MySQL, PostgreSQL, Redis) |
+| 📞 | Experimental voice-call (VoIP) support |
+
+---
+
+## 🆚 Comparison
+
+How `@japofc/baileys` stacks up against other Baileys libraries:
+
+| Capability | `@japofc/baileys` | Other forks (typical) |
+|---|:---:|:---:|
+| Native Flow buttons (V1/V2/V3) | ✅ | ⚠️ partial |
+| Carousel messages | ✅ | ❌ |
+| Rich response cards (AIRich) | ✅ | ❌ |
+| Commerce flow (catalog/order/payment) | ✅ | ⚠️ partial |
+| Voice calling (VoIP) | ✅ experimental | ❌ |
+| Multi-backend store (SQL/Mongo/Redis) | ✅ | ⚠️ partial |
+| Full `.d.ts` TypeScript definitions | ✅ | ⚠️ partial |
+| User sync queries (WAUSync) | ✅ | ✅ |
+| Username management (check/set/pin/recommend) | ✅ | ❌ |
+| Bot framework (middleware, session, stats) | ✅ | ❌ |
+| Built-in QR render (terminal/SVG/PNG, zero deps) | ✅ | ❌ needs `qrcode-terminal` |
+| Auto WA Web version resolution | ✅ | ❌ hardcoded |
+
+> Tabel ini menggambarkan fitur di level package, bukan benchmark performa. PR untuk memperbarui/mengoreksi tabel ini dipersilakan lewat [Contributing](#-contributing).
+
+---
+
+## 🧰 Built With
+
+<p>
+<img src="https://img.shields.io/badge/node.js-%2343853D.svg?style=for-the-badge&logo=node.js&logoColor=white" alt="Node.js"/>
+<img src="https://img.shields.io/badge/javascript-%23323330.svg?style=for-the-badge&logo=javascript&logoColor=%23F7DF1E" alt="JavaScript"/>
+<img src="https://img.shields.io/badge/esm-%23F7DF1E.svg?style=for-the-badge&logo=javascript&logoColor=black" alt="ESM"/>
+<img src="https://img.shields.io/badge/websocket-%23000000.svg?style=for-the-badge&logo=socket.io&logoColor=white" alt="WebSocket"/>
+<img src="https://img.shields.io/badge/signal%20protocol-%233A76F0.svg?style=for-the-badge&logo=signal&logoColor=white" alt="Signal Protocol"/>
+<img src="https://img.shields.io/badge/protobuf-%23345?style=for-the-badge&logo=google&logoColor=white" alt="Protobuf"/>
+<img src="https://img.shields.io/badge/npm-%23CB3837.svg?style=for-the-badge&logo=npm&logoColor=white" alt="npm"/>
+</p>
+
+<p>
+<a href="https://skillicons.dev">
+  <img src="https://skillicons.dev/icons?i=nodejs,js,ts,npm,docker,redis,mongodb,mysql,postgresql,sqlite" alt="Tech stack icons"/>
+</a>
+</p>
+
+---
+
+## 🔥 Features
+
+<table>
+<tr>
+<th align="center">💬 Interactive Messages</th>
+<th align="center">🛒 Commerce & Business</th>
+<th align="center">🧩 Utility Features</th>
+</tr>
+<tr>
+<td valign="top">
+
+- Native Flow
+- Buttons (V1 / V2 / V3)
+- Lists
+- Carousel Messages
+- Poll & Quiz Messages
+- Rich Response Messages (AIRich)
+- CTA / Reply / URL Buttons
+- Call Buttons
+- OTP Buttons
+- Authentication Buttons
+
+</td>
+<td valign="top">
+
+- Catalog Message
+- Order Details
+- Order Status
+- Review & Pay
+- Payment Status
+- Payment Method
+- Track Order
+- Reorder
+- Cancel Order
+
+</td>
+<td valign="top">
+
+- Group Status Support
+- Mention All
+- Lottie Sticker Support
+- Newsletter Support
+- ExternalAdReply Helper
+- View Once Support
+- Rich Formatting
+- Code Highlighting
+
+</td>
+</tr>
+</table>
+
+<table>
+<tr>
+<th align="center">🔐 Auth & Storage</th>
+<th align="center">📞 Realtime</th>
+<th align="center">🛠 Developer Tooling</th>
+</tr>
+<tr>
+<td valign="top">
+
+- Multi-file auth state
+- Single-file auth state
+- SQLite auth state
+- Cache-manager auth state
+- In-memory store
+- SQLite / MongoDB / MySQL /
+  PostgreSQL / Redis store adapters
+
+</td>
+<td valign="top">
+
+- Voice calling (VoIP, WASM engine)
+- User sync queries (WAUSync)
+- Presence / status / device lookup
+- Event buffer for high-volume bots
+
+</td>
+<td valign="top">
+
+- Full TypeScript definitions (`.d.ts`)
+- Anti-delete detection
+- Message search helpers
+- Auto-reply engine
+- Scheduling helpers
+- Message retry manager
+
+</td>
+</tr>
+</table>
+
+---
+
+## ✨ Exclusive J.AP Enhancements
+
+### Audio Group Status Fix
+Audio status uses a more compatible implementation to avoid unsupported-version errors on older WhatsApp clients.
+
+### AIRich — the rich-response message builder
+A chainable builder (`AIRich`, also exported as `AIJap` / `LeafRich` / `JapAI` / `JapRich`) with 40+ `add*()`/`set*()` methods covering headings, formatted text (hyperlinks/citations/LaTeX), code blocks, tables, image/video/product/post cards, task & progress cards, tip banners, and quick-reply suggestions — the kind of rich card layout you'd normally only see from an official AI/assistant-style bot. See [Usage Examples](#airich--rich-response-cards) below.
+
+### Native Flow Expansion
+
+<table>
+<tr>
+<td valign="top" width="33%">
+
+**Buttons & Actions**
+- cta_reminder
+- cta_cancel_reminder
+- otp_button
+- authentication_button
+- call_button
+- url_button
+- reply_button
+- voice_call
+- video_call_button
+
+</td>
+<td valign="top" width="33%">
+
+**Commerce Flow**
+- catalog_message
+- mpm
+- card_message
+- order_details
+- order_status
+- review_and_pay
+- payment_status
+- payment_method
+
+</td>
+<td valign="top" width="33%">
+
+**Navigation & Misc**
+- address_message
+- send_location
+- track_order
+- reorder
+- cancel_order
+- clear_chat
+- navigateToScreen
+- flow_action
+
+</td>
+</tr>
+</table>
+
+### System Notification Filter
+
+Messages include:
+
+```js
+message.isSystemNotification
+```
+
+Useful for filtering:
+
+- E2E notices
+- Meta service notices
+- Other system-generated messages
+
+---
+
+## 📦 Installation
+
+```bash
+npm install @japofc/baileys
+```
+
+Directly from GitHub:
+
+```bash
+npm install github:JAPofc/baileys
+```
+
+> Requires **Node.js 20+** — install will refuse to run below that (checked by `engine-requirements.js` on `preinstall`).
+
+### Optional peer dependencies
+
+Everything below is **optional** — the socket works without any of them. Install only what the features you use need; missing ones fail with a clear install hint instead of a silent crash.
+
+| Package | Unlocks |
+|---|---|
+| `sharp` | Fast image resizing/processing (used by the message builders' `Toolkit.resize`) |
+| `@napi-rs/image` | Lighter native alternative to `sharp` for image ops |
+| `jimp` | Pure-JS image fallback when neither of the above is installed |
+| `fluent-ffmpeg` | Audio/video conversion for media messages |
+| `audio-decode` | Audio waveform/duration extraction (voice notes, VoIP capture) |
+| `link-preview-js` | Rich link previews for URLs in outgoing text messages |
+| `better-sqlite3` | SQLite auth state, SQLite store adapter, **and** the [Bot Framework](#-bot-framework)'s `SQLiteStore`/`StatsManager` |
+| `node-webpmux` | Packname/author EXIF metadata on stickers made via `MediaManager.convertToSticker()` — not needed for plain sticker conversion |
+| `mongodb` | MongoDB store adapter |
+| `mysql2` | MySQL store adapter |
+| `pg` | PostgreSQL store adapter |
+| `ioredis` | Redis store adapter |
+| `@roamhq/wrtc` | Native WebRTC bindings for [voice calling](#-voice--video-calls) |
+
+---
+
+## 🚀 Quick Start
+
+```js
+import { makeWASocket, useMultiFileAuthState } from '@japofc/baileys'
+
+const { state, saveCreds } = await useMultiFileAuthState('auth_info')
+
+const sock = makeWASocket({
+    auth: state
+})
+
+// persist credentials whenever Baileys updates them
+sock.ev.on('creds.update', saveCreds)
+
+sock.ev.on('connection.update', (update) => {
+    const { connection, qr } = update
+
+    // Easiest: pass `printQRInTerminal: true` to makeWASocket and the QR is
+    // drawn automatically with the built-in zero-dependency renderer.
+    // Manual/custom rendering from the event also works:
+    //   import { renderQRToTerminal, qrToSVG, qrToPNG } from '@japofc/baileys'
+    //   if (qr) console.log(renderQRToTerminal(qr))          // terminal (▀▄█)
+    //   if (qr) fs.writeFileSync('qr.svg', qrToSVG(qr))      // for a web UI
+    //   if (qr) fs.writeFileSync('qr.png', qrToPNG(qr))      // raster (send anywhere)
+    if (qr) console.log('Got a pairing QR')
+
+    if (connection === 'open') console.log('🍃 Connected!')
+})
+
+sock.ev.on('messages.upsert', ({ messages }) => {
+    const msg = messages[0]
+    if (!msg.message || msg.key.fromMe) return
+    console.log('New message from', msg.key.remoteJid)
+})
+```
+
+---
+
+## 🔐 Authentication
+
+Four auth-state backends ship out of the box. All return the same `{ state, saveCreds }` shape expected by `makeWASocket({ auth })`, so they're drop-in interchangeable.
+
+| Function | Storage | Best for |
+|---|---|---|
+| `useMultiFileAuthState(folder)` | One JSON file per key, on disk | Default choice — simple, debuggable, works everywhere |
+| `useSingleFileAuthState(fileName)` | One JSON file, on disk | Small bots where a single file is easier to manage/back up |
+| `useSqliteAuthState(opts)` | SQLite (`better-sqlite3`) | Bots that already use SQLite, or want auth in one embedded DB file |
+| `useCacheManagerAuthState(store, sessionKey)` | Any [`cacheable`](https://www.npmjs.com/package/@cacheable/node-cache)-compatible store | Multi-session hosting panels, Redis-backed setups |
+
+```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
+// SQLite variant
+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)
+```
+
+`useMultiFileAuthState` also exports `pruneStaleAuthFiles(folder, options)` to clean up old sender-key files on a schedule — useful for long-running bots that accumulate thousands of stale key files.
+
+---
+
+## 🗄️ Store Backends
+
+`makeInMemoryStore()` from `lib/Store` gives you the classic in-memory chat/contact/message cache. For anything that needs to survive a restart, `makePersistentStore()` (from `PersistentStore.js`) wraps one of five backends behind the same interface:
+
+| Backend | Function |
+|---|---|
+| SQLite | `createSqliteStoreAdapter(opts)` |
+| MongoDB | `createMongoStoreAdapter(opts)` |
+| MySQL | `createMysqlStoreAdapter(opts)` |
+| PostgreSQL | `createPostgresStoreAdapter(opts)` |
+| Redis | `createRedisStoreAdapter(opts)` |
+
+```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 etc */ })
+store.bind(sock.ev)
+```
+
+---
+
+## 💡 Usage Examples
+
+### Buttons & 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)
+```
+
+### Carousel
+
+> Each card must be built with `Button(...).toCard()` first — a carousel card is really just a button card with an image/video header.
+
+```js
+import { Button, Carousel } from '@japofc/baileys'
+
+const cardA = await new Button(sock)
+    .setImage('https://example.com/a.jpg')
+    .setTitle('Produk A')
+    .addUrl('Lihat', 'https://example.com/a')
+    .toCard()
+
+const cardB = 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([cardA, cardB])
+    .send(jid)
+```
+
+### AIRich — rich response cards
+
+```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)
+```
+
+`AIRich` supports `{ id, insertAt }` on every `add*()`/`set*()` call, so you can insert a block relative to one you added earlier instead of always appending to the end — handy for streaming/edit-in-place style responses combined with `sendEdit(jid, id)`.
+
+Other builders worth knowing about: **`ButtonV2`** (simpler quick-reply-only buttons), **`ButtonV3`** (`loadFrom(msg)` to edit an existing template message in place), and **`Toolkit`** (static helpers: `Toolkit.resize()`, `Toolkit.fetchBuffer()`, `Toolkit.waitAllPromises()`, `Toolkit.extractIE()` for parsing `[label](url)` links/citations/LaTeX out of plain text).
+
+### 📁 Builders Folder Map (`lib/Builders/`)
+
+Every message builder lives in its own file under `lib/Builders/`, so you can trace exactly where a class comes from instead of digging through one giant `MessageBuilder.js`. `index.js` is just the barrel file that re-exports everything below (plus their aliases) for the top-level `import { ... } from '@japofc/baileys'` syntax.
+
+| File | Exports | What it's for |
+|---|---|---|
+| `shared.js` | `Toolkit`, `BaseBuilder`, `RowBuilder` | The shared foundation every other builder is built on. `BaseBuilder` holds the common chainable `send()`/context-info plumbing, `RowBuilder` is the shared row/section helper, and `Toolkit` is the static-helper grab bag (`resize`, `fetchBuffer`, `waitAllPromises`, `extractIE`, media-duration/preview helpers). Nothing here is meant to be instantiated directly in bot code — it exists so `Button`, `Poll`, `Carousel`, etc. don't each reimplement the same plumbing. |
+| `Button.js` | `Button`, `CardBuilder` | The main interactive/native-flow button builder — headers (image/video/document), CTA helpers (`addUrl`, `addCall`, `addReply`, and the wider native-flow set), and `.toCard()` to turn a button message into a `Carousel` card. |
+| `ButtonV2.js` | `ButtonV2` | A lighter-weight variant limited to simple quick-reply buttons — reach for this when you don't need the full native-flow surface of `Button`. |
+| `ButtonV3.js` | `ButtonV3` | Built around `loadFrom(msg)` — loads an existing `templateMessage` (e.g. one you fetched or that was quoted) so you can edit it in place instead of building one from scratch. |
+| `Carousel.js` | `Carousel` | Chains `Button(...).toCard()` results into a swipeable card carousel. Capped at `Carousel.MAX_CARDS` (10) since WhatsApp silently truncates anything beyond that. |
+| `Poll.js` | `Poll` | Poll/vote message builder — question, options, single/multi-select, hidden-voter mode, correct-answer marking, expiry. |
+| `AIRich.js` | `AIRich` (+ aliases `ORich`, `AIJap`, `LeafRich`, `JapAI`, `JapRich`, `RichJap`) | The rich AI-assistant-style response builder described above — headings, formatted text, tables, media/product/post cards, task/progress cards, tip banners, quick-reply suggestions. |
+| `A2UI.js` | `A2UI`, `sendA2UIWidget` | Lower-level A2UI/Bloks widget builder. Builds the flat `components` tree (Column/Row → `children`, Card/Button → `child`, Modal → `trigger`/`content`) that Bloks widgets expect and sends it through the same `getBizBinaryNode()` path as `Button`/`ButtonV2`, so the wire-level node always matches the button names actually sent. |
+| `JapBaileys.js` | `JapBaileys` | A unified builder **hub** — one object that wraps all the builders above behind short method names (`.button()`, `.buttonV2()`, `.buttonV3()`, `.carousel()`, `.poll()`, `.airich()`, `.a2ui()`), plus PascalCase aliases (`.Button()`, `.Carousel()`, `.Poll()`, `.AIRich()`, `.A2UI()`) for developers who prefer that naming style. Nothing new is implemented here — it's purely a single entry point over the individual classes. |
+| `index.js` | everything above, plus `MESSAGE_BUILDER_VERSION` | The barrel file — re-exports every builder and its aliases so `import { Button, Poll, AIRich, JapBaileys } from '@japofc/baileys'` works without reaching into individual files. `MESSAGE_BUILDER_VERSION` tracks the builder API surface's own version, independent of the package version. |
+
+**Unified hub example** — useful if you'd rather carry one object around than import each builder individually:
+
+```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 a message for 7 days (default 24h), unpin, keep / unkeep in disappearing chats
+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
+})
+```
+
+### 📞 Scheduled Call
+
+Native scheduled-call message (the "Schedule call" card with a join reminder):
+
+```js
+// 'voice' (default) or 'video'
+await sock.sendScheduledCall(jid, {
+    title: 'Daily standup',
+    scheduledAt: new Date('2026-09-15T09:00:00+07:00'),
+    callType: 'video'
+})
+
+// Cancel it later (needs the creation message's key)
+await sock.cancelScheduledCall(jid, creationMsg.key)
+```
+
+### 📱 Mini App
+
+Two modes — pass `url`, `flow`, or both (two buttons):
+
+```js
+import { sendMiniApp } from '@japofc/baileys'
+
+await sendMiniApp(sock, jid, {
+    title: 'My Mini App',
+    body: 'Tap the button to open the app 👇',
+    // 1) webview mode: rich card + CTA opening your web app
+    //    (in-app webview when supported, else the browser)
+    url: 'https://myapp.example.com',
+    params: { ref: 'wa-bot' }, // → appended as ?ref=wa-bot
+    buttonText: '🚀 Open App',
+    // 2) Flows mode: TRUE native in-chat mini app (forms/screens inside
+    //    WhatsApp, no browser). Needs a published Flow ID from Flows Manager.
+    flow: { id: '123456789', cta: '📝 Isi Form', screen: 'WELCOME' },
+    thumbnail: 'https://myapp.example.com/icon.png' // url or Buffer
+})
+// or as a socket method: await sock.sendMiniApp(jid, { ... })
+```
+
+---
+
+## 📨 Message Helpers
+
+High-level one-liners for modern message types — validated, with friendly aliases:
+
+```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: 'Party', startTime: new Date(...) });
+await sock.sendNewsletterInvite(jid, { newsletterJid, newsletterName: 'News' });
+
+// Poll upgrades (already wired end-to-end):
+await sock.sendPoll(jid, {
+  name: 'Jam berapa?', values: ['Pagi', 'Sore'],
+  endDate: new Date('2026-09-16T00:00:00Z'), // auto-close
+  hideVoter: true,      // anonymous poll
+  canAddOption: true,   // voters may add options
+});
+```
+
+Music messages are experimental (real provider catalog IDs required):
+
+```js
+await sock.sendMusic(jid, { songUri, artworkUri, embeddedMusic: { songId, title, author } });
+```
+
+**Escape hatch:** every content key also works inline via `sendMessage`, and `{ raw: true, <AnyMessageField>: {...} }`
+passes any proto field through untouched — full `WAProto` coverage with zero wrapper lag:
+
+```js
+await sock.sendMessage(jid, { raw: true, musicMessage: { songUri } });
+```
+
+TypeScript consumers get a typed `AnyMessageContent` (`import type { AnyMessageContent } from '@japofc/baileys'`).
+
+## 🧰 Channels, History & Transcripts
+
+**Channel management** (live queries):
+
+```js
+await sock.newsletterDelete(channelJid)
+await sock.newsletterAdminCount(channelJid)
+await sock.newsletterJoinInvite('invite-code')
+await sock.newsletterChangeOwner(channelJid, newOwnerJid) // experimental
+await sock.communityGetInviteCode(communityJid)
+// ...plus existing follow/unfollow/mute/react/fetch + full community CRUD
+```
+
+**Group history sharing** for new members (forwards recent messages to their DM):
+
+```js
+import { getGroupHistoryFromStore } from '@japofc/baileys'
+const messages = getGroupHistoryFromStore(store, groupJid, 10)
+await sock.shareGroupHistory({ groupJid, members: newMemberJid, messages, greeting: true })
+```
+
+**Voice-note transcription** (pluggable provider — cloud Whisper or your own):
+
+```js
+import { openAIWhisperProvider } from '@japofc/baileys'
+const provider = openAIWhisperProvider({ apiKey: process.env.OPENAI_API_KEY })
+const { text } = await sock.transcribeMessage(voiceNoteMsg, { provider })
+```
+
+**Mini-app deep links** (HMAC-signed params your web app can verify):
+
+```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' } (throws if tampered)
+buildFlowDataExchange('navigate', { screen: 'HOME' }) // Flows data_exchange payload
+```
+
+**A2UI widgets** now include `Slider`, `Switch`, `List`, `ProgressBar`, `Avatar`,
+`Badge`, `Spacer`, and `Tabs` alongside the existing Text/Image/Video/Button/Card/Modal
+set (all ref-validated at `build()`).
+
+## 🔐 Security Pack
+
+Drop-in hardening for auth state, secrets, and abuse — all in
+`lib/Utils/auth-secure.js`, covered by `tests/security.test.js` (incl. fuzzing).
+
+```js
+import {
+  useEncryptedFileAuthState, secureLogger, withPairingGuard,
+  createQRGuard, backupAuthState, writeAuthIntegrity, repairAuthState, secureLogout
+} from '@japofc/baileys'
+
+// 1. AES-256-GCM encrypted auth state (reads legacy plaintext, migrates on save)
+const { state, saveCreds } = await useEncryptedFileAuthState('./auth', { password: process.env.AUTH_PW })
+const sock = makeWASocket({
+  auth: state,
+  logger: secureLogger(pino({ level: 'info' })), // 7. redacts qr/tokens/keys in every log line
+})
+
+// 2. pairing-code rate limit: 5/hour per number, 30s between attempts
+withPairingGuard(sock, { maxPerHour: 5, minIntervalMs: 30_000 })
+
+// 3. QR fist-guard: handle the first QR, swallow re-emits for 60s
+const qrGuard = createQRGuard({ ttlMs: 60_000 })
+sock.ev.on('connection.update', ({ qr }) => { qr = qrGuard.handle(qr); if (qr) show(qr) })
+
+// 6/8. encrypted backup + integrity snapshot
+await backupAuthState('./auth', './auth.jabackup', { password: process.env.BACKUP_PW })
+await writeAuthIntegrity('./auth', { secret: process.env.INT_PW })
+
+// 9. repair corrupt stores (quarantines + restores creds from backup)
+await repairAuthState('./auth', { password: process.env.AUTH_PW, backupFile: './auth.jabackup', backupPassword: process.env.BACKUP_PW })
+
+// 4. logout + overwrite/unlink every auth file + scrub in-memory creds
+await secureLogout(sock, { authFolder: './auth' })
+```
+
+Single-file variant: `useEncryptedSingleFileAuthState(file, { password })`.
+
+## 🆕 WA 2026 catch-up
+
+WhatsApp 2026 features, wired into JAP-Baileys. Everything here was audited against the
+latest official clients — only gaps were added; what already worked is just documented.
+
+### Usernames (chat without phone numbers)
+
+```js
+await sock.checkUsername('japstore');            // availability
+await sock.setUsername('japstore');              // claim it
+await sock.reserveUsername('japstore');          // reserve it (2026 reservation flow)
+await sock.findUserByUsername('japstore');       // USync lookup → JID
+const u = await sock.fetchContactUsernames(['62812@s.whatsapp.net']);
+```
+
+### Editable polls (`editPoll`)
+
+Polls are editable for ~15 minutes after creation (server-side rule):
+
+```js
+const sent = await sock.sendPoll(jid, { name: 'Jam berapa?', values: ['Pagi', 'Sore'] });
+await sock.editPoll(jid, sent.key, { name: 'Jam berapa?', values: ['Pagi', 'Siang', 'Sore'] });
+```
+
+### Mass mention (`sendMentionAll`)
+
+```js
+await sock.sendMentionAll(groupJid, 'Pengumuman: rapat jam 9!');
+```
+
+> In groups with 32+ members `@all` is admin-only and the rule is enforced
+> server-side — non-admin calls are silently dropped by WhatsApp.
+
+### Event reminders
+
+```js
+await sock.sendMessage(jid, {
+  event: {
+    title: 'Rapat', description: 'Q3', startDate: new Date('2026-09-15T09:00:00+07:00'),
+    reminder: true, reminderOffsetSec: 1800, // remind 30 min before start
+  }
+});
+```
+
+### Sender phone from LID events (`resolveSenderPn`)
+
+Fixes LID-only payloads (e.g. call offers where `caller_pn` is missing):
+
+```js
+sock.ev.on('messages.upsert', async ({ messages }) => {
+  for (const m of messages) console.log(await sock.resolveSenderPn(m)); // '62812…' | null
+});
+```
+
+### View-once voice notes
+
+`sendVoiceNote()` content composes with `viewOnce`:
+
+```js
+await sock.sendMessage(jid, { ...(await buildVoiceNoteContent('./a.ogg')), viewOnce: true });
+```
+
+### Member tags (groups)
+
+Already exposed — no new code, documented here:
+
+```js
+await sock.updateMemberLabel({ groupJid, lid, label: 'Admin' });
+```
+
+### Honestly not implemented (and why)
+
+- **Voice message transcripts** — generated on-device by official clients only; there is
+  no transcript API on the wire.
+- **Group message history sharing** — the wire format isn't captured by any public Baileys
+  fork yet (verified against the latest upstream Baileys release, whose proto is 100+
+  fields behind this repo).
+- **Music messages** — `MusicMessage` needs Spotify/Apple catalog IDs plus an artwork
+  upload flow we haven't captured; the proto struct exists, sending real ones doesn't.
+- **`mediaKeyDomain` — IMPLEMENTED.** Backported from rc14 onto all 5 media types
+  (`Audio/Document/Image/Sticker/VideoMessage`, enum `UNSET/E2EE_CHAT/STATUS/CAPI/BOT`)
+  with a send passthrough: `sendMessage(jid, { image: buf, mediaKeyDomain: 1 })`.
+  Unset by default (recommended — the server labels it). Skipped only on
+  `MMSThumbnailMetadata`, where upstream's field number 8 collides with the newer
+  `messageHistoryMetadata` in our proto.
+
+## 🆕 Everyday Utilities
+
+One-liners for daily bot work (also usable standalone — see `examples/`):
+
+```js
+// 📊 Poll (chats/groups) + Quiz (channels only)
+await sock.sendPoll(jid, { name: 'Makan apa?', options: ['Nasi', 'Mie'] })
+await sock.sendQuiz(channelJid, { name: 'Kuis', options: ['A', 'B'], correctAnswer: 'A' })
+
+// 🎙️ Voice note — auto-converts mp3/wav/… to Opus PTT (needs fluent-ffmpeg)
+await sock.sendVoiceNote(jid, './hello.mp3') // path | Buffer | { url }
+
+// 📞 Tag everyone (visible @list vs hidden)
+await sock.tagAll(groupJid, 'Rapat jam 10!')
+await sock.hideTag(groupJid, 'Pengumuman 📢')
+
+// 🔍 LID → phone number (best-effort, null when unknown)
+await sock.getPhoneNumber('12345@lid') // → '62812…'
+await sock.getLidForPhone('62812…')    // reverse lookup
+
+// 🧍 Humanized send — typing… + natural delay + per-chat queue
+await sock.sendHumanized(jid, { text: 'Halo!' })
+
+// 🤖 Meta AI chat (experimental — needs Meta AI on the account/region)
+const { text } = await sock.askMetaAI('Jelaskan black hole!')
+```
+
+**Command router** for prefix bots (`!menu`, `.sticker`) with middleware + auto-help:
+
+```js
+import { createRouter } from '@japofc/baileys'
+const router = createRouter({ prefix: '!' })
+router.command('ping', async (ctx) => ctx.reply('pong! 🏓'), { desc: 'Check bot' })
+router.attach(sock) // → detach()
+```
+
+**Status / channel schedulers** (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)
+```
+
+`npm test` runs the offline suite (`tests/`, 68 asserts, no network needed).
+
+---
+
+## 📞 Voice & Video Calls
+
+Experimental audio-call support via a bundled WASM call stack + WebRTC relay. Requires the optional `@roamhq/wrtc` peer dependency.
+
+```js
+import { VoipClient } from '@japofc/baileys'
+
+const voip = new VoipClient({ resourcesPath: './voip-resources' })
+await voip.connectWithSocket(sock)
+
+const call = await voip.call('628123456789')
+
+call.on('ringing', () => console.log('Ringing...'))
+call.on('connected', () => console.log('Call connected'))
+call.on('ended', (reason) => console.log('Call ended:', reason))
+```
+
+`ActiveCall` (returned by `.call()`) and `CallState` are also exported directly if you need finer-grained control over call state.
+
+**Answering inbound calls** — offers are tracked, so the bot can pick up (1:1) or join (group):
+
+```js
+import { attachVoip } from '@japofc/baileys'
+const voip = await attachVoip(sock) // also stored as sock.voip
+
+voip.on('incoming-call', async ({ callId, from, isGroupCall, busy }) => {
+    if (busy) return
+    if (isGroupCall) await voip.joinGroupCall(callId, { audioSource: './greeting.mp3' })
+    else await voip.answerCall(callId, { audioSource: './greeting.mp3' })
+})
+
+// ...or fully automatic:
+await attachVoip(sock, { autoAnswer: true })   // pick up 1:1 calls
+await attachVoip(sock, { autoJoinGroup: true }) // join group calls
+await attachVoip(sock, { autoReject: true, autoRejectText: 'Bot cannot take calls 🙏' })
+
+// still-pending offers (answer before `offerTtlMs`, default 45s):
+voip.getPendingCalls() // → [{ callId, from, isGroupCall, ... }]
+```
+
+**Group / multi-party calls:**
+
+```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() // recovery after a drop
+
+voip.on('group-call-started', console.log)
+voip.on('group-call-joined', console.log)
+```
+
+Calls also support reactions, hand-raise, recording, and call links:
+
+```js
+const call = await voip.call('628123456789', { audioSource: './greeting.mp3' })
+call.react('👍')
+call.setHandRaised(true)
+const stopRecording = call.recordToFile('./call.wav') // remote peer → .wav
+await voip.previewCallLink('call-link-token')
+```
+
+**Reconnect & recovery** — a watchdog monitors the relay transport during every call
+(`watchdogIntervalMs`/`watchdogMaxSilent`); on a dead relay it emits `call-degraded`
+and automatically re-sends the crypto rekey + offer. Manual controls:
+
+```js
+voip.on('call-degraded', ({ callId }) => console.log('relay dead, recovering', callId))
+voip.on('call-recovery', (r) => console.log('recovery result', r))
+await voip.recoverCall({}) // manual: { rekey: true, offer: true }
+voip.getStats()            // { busy, callId, call, relay }
+sock.ev.on('call', (calls) => { /* standard offer/reject path still works */ })
+```
+
+**Refreshing the WASM stack** — if calls break after a WA Web update, re-fetch the official VoIP build from your own browser (Chrome with `--remote-debugging-port=9222` + web.whatsapp.com open):
+
+```bash
+npm run voip:fetch-wasm
+```
+
+---
+
+## 🔎 User Sync Queries
+
+`WAUSync` (`USyncQuery` / `USyncUser` + protocols) lets you check things like WhatsApp registration, device lists, status, and username info for a JID before you message it — the same mechanism behind `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 result = await sock.executeUSyncQuery(query)
+```
+
+Available protocols: `USyncContactProtocol`, `USyncDeviceProtocol`, `USyncStatusProtocol`, `USyncUsernameProtocol`, `USyncDisappearingModeProtocol`, `UsyncBotProfileProtocol`, `UsyncLIDProtocol`.
+
+---
+
+## 👤 Username Management
+
+High-level wrappers around WhatsApp's username feature (the `@username` handle you can set instead of exposing your phone number), sitting on top of `USyncUsernameProtocol`. Query IDs are captured from live WA Web sessions — if a call starts throwing `unexpected response structure`, WA has rotated them and they need re-capturing.
+
+```js
+// Check availability + get suggestions if taken
+const check = await sock.checkUsername('J.AP')
+// { available: true, username: 'J.AP' }
+// or: { available: false, suggestions: [...], rejectionReasons: [...] }
+
+// Claim a username
+await sock.setUsername('J.AP', { source: sock.USERNAME_SOURCE.USER_INPUT })
+
+// Lock it behind a PIN so it can't be changed without one
+await sock.setUsernamePin('123456')
+
+// Read your own username / drop it
+const mine = await sock.getMyUsername()
+await sock.deleteUsername()
+
+// Resolve a username to a JID (USync-based, like onWhatsApp() but by username)
+const user = await sock.findUserByUsername('someone')
+// { jid: '628...@s.whatsapp.net', contact: false }
+
+// Batch-resolve usernames for a list of known contacts
+const usernames = await sock.fetchContactUsernames(jid1, jid2, jid3)
+
+// Get WA's own suggestions (e.g. for onboarding flows)
+const recs = await sock.getUsernameRecommendations()
+```
+
+> Requires a Community/Contact-tier account in good standing — accounts under WA's usual restrictions for new/unverified numbers may see `INVALID` or empty suggestions regardless of the username's actual availability.
+
+---
+
+<div align="center">
+<img src="https://capsule-render.vercel.app/api?type=soft&color=0:2ecc71,100:1d6a23&height=70&section=header" width="100%"/>
+</div>
+
+## 🤖 Bot Framework
+
+An optional, higher-level layer on top of the raw socket: middleware routing, a `!command` dispatcher, a message queue that survives disconnects, exponential-backoff auto-reconnect, per-JID session storage, group activity stats, and media (sticker/voice-note) conversion helpers — so a new bot project doesn't have to hand-roll session/context management every time.
+
+Needs the `better-sqlite3` peer dependency (session + stats storage) and `fluent-ffmpeg` (sticker/voice-note conversion, already listed above) — both fail with an install hint rather than crashing if you use a Framework feature that needs them without installing them first.
+
+```js
+import { Bot } from '@japofc/baileys'
+
+const bot = new Bot({
+    socketConfig: { printQRInTerminal: true },
+    dbPath: './bot.db',   // sessions + stats, defaults to 'baileys_store.db'
+    enableStats: true     // group message/sticker leaderboards + ghost detection
+})
+
+bot.command('!ping', async (ctx) => {
+    await ctx.reply({ text: 'pong' })
+})
+
+bot.command('!sticker', async (ctx) => {
+    if (!ctx.quoted?.imageMessage) return ctx.reply({ text: 'Reply to an image with !sticker' })
+    // ctx.replySticker() handles the WebP conversion for you
+    await ctx.replySticker(imageBuffer, { packname: 'J.AP Pack', author: 'you' })
+})
+
+bot.onText(async (ctx) => {
+    // ctx.session() / ctx.setSession() / ctx.updateSession() / ctx.clearSession()
+    // persist small per-chat state (e.g. multi-step flows) to SQLite automatically
+    const state = ctx.session()
+    if (state?.awaitingReply) {
+        ctx.updateSession((s) => ({ ...s, awaitingReply: false }))
+    }
+})
+
+await bot.start()
+```
+
+`Context`, `SessionManager`, `StatsManager`, `MediaManager`, and `SQLiteStore` are also exported individually if you only need one piece rather than the full `Bot` class.
+
+> These files ship as plain `.js` for now — hand-written `.d.ts` declarations for the Framework module haven't been added yet, unlike the rest of this fork's fully-typed surface.
+
+---
+
+## 🧩 Utility Modules
+
+A sample of the utilities exported from `lib/Utils` beyond the message builders above:
+
+| Module | What it does |
+|---|---|
+| `anti-delete` | Detect and recover messages the sender deleted for everyone |
+| `auto-reply` | Simple keyword/pattern-based auto-responder engine |
+| `message-search` | Search cached/stored messages, peeling off ephemeral/view-once wrappers first |
+| `message-retry-manager` | Handles WhatsApp's retry-receipt protocol for undecryptable messages |
+| `scheduling` | Schedule messages/actions for later delivery |
+| `business` | Business-profile & catalog helpers |
+| `chat-control` | Pin, mute, archive, and mark-read/unread helpers |
+| `chat-history-helpers` | Work with synced chat history payloads |
+| `link-preview` | Generate link preview metadata for outgoing messages |
+| `stickerpack` | Build and send sticker packs (including animated/Lottie) |
+| `templates` | Legacy WhatsApp Business template message helpers |
+| `vcard` | Build vCard (contact card) payloads |
+| `status` | Post and manage WhatsApp Status updates |
+| `event-buffer` | Buffers/coalesces high-volume socket events for heavier bots |
+
+Every module above ships a matching `.d.ts`, so your editor will show full hover-docs regardless of which ones you import.
+
+---
+
+## 🛠 Recommended Environment
+
+| Requirement | Version |
+|---|---|
+| Node.js | 20+ |
+| Module system | ESM |
+| WhatsApp | Latest Multi Device |
+
+---
+
+## 📘 TypeScript Support
+
+Full `.d.ts`: every shipped `.js` file has a matching TypeScript declaration (guarded by `tests/types-parity.test.js`), and the whole package verifies at zero errors under `tsc --strict`. `import { ... } from '@japofc/baileys'` resolves with no `@types/` package needed (beyond the standard `@types/node` every Node TS project has): `makeWASocket` incl. the username methods and `USERNAME_*` constants, all `Types/*` definitions, `WAProto`, stores, `Utils/*`, the message builders (`Button`, `Poll`, `Carousel`, `AIRich`, `A2UI`, … with Bloks node types), the Bot Framework (`Bot`, `Context`, …), and the VoIP client (`VoipClient`, `ActiveCall`, …). Complex wire payloads are typed as loose records where WhatsApp publishes no schema.
+
+---
+
+## ❓ FAQ & Troubleshooting
+
+<details>
+<summary><b>Koneksi terus putus / reconnect loop</b></summary>
+<br/>
+
+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.
+
+</details>
+
+<details>
+<summary><b>QR tidak muncul / tidak ke-scan</b></summary>
+<br/>
+
+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 })`.
+
+</details>
+
+<details>
+<summary><b>Error "Bad MAC" / pesan gagal didekripsi</b></summary>
+<br/>
+
+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.
+
+</details>
+
+<details>
+<summary><b>Memory terus naik di bot yang jalan lama</b></summary>
+<br/>
+
+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.
+
+</details>
+
+<details>
+<summary><b>Voice call gagal connect</b></summary>
+<br/>
+
+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.
+
+</details>
+
+---
+
+## 🤝 Contributing
+
+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.
+
+---
+
+## 🙏 Credits
+
+Built on the shoulders of the open-source WhatsApp community.
+
+Full details and license terms per component: see [`NOTICE.md`](./NOTICE.md).
+
+---
+
+## 👑 Maintainer
+
+<table>
+<tr>
+<td width="180" align="center">
+<img src="https://github.com/JAPofc.png" width="160" alt="J.AP avatar" style="border-radius:50%"/>
+</td>
+<td>
+
+**J.AP**
+
+- GitHub: [github.com/JAPofc](https://github.com/JAPofc)
+- Package: [`@japofc/baileys`](https://www.npmjs.com/package/@japofc/baileys)
+- ✦ Maintains this fork solo — issues & PRs are welcome and reviewed personally.
+
+</td>
+</tr>
+</table>
+
+<p align="center">
+<img src="https://raw.githubusercontent.com/JAPofc/JAPofc/output/github-contribution-grid-snake.svg" width="100%" alt="Contribution snake animation"/>
+</p>
+
+---
+
+## ⚠️ Disclaimer
+
+This project is an independent fork.
+Use responsibly and follow WhatsApp Terms of Service.
+
+---
+
+## 📝 v2.1.0 Patch Notes
+
+> Ringkasan — detail lengkap di [CHANGELOG.md](./CHANGELOG.md).
+
+- **QR bawaan, nol dependency**: vendored [qrcodegen](https://github.com/nayuki/QR-Code-generator) (Nayuki, MIT) + renderer sendiri — `renderQRToTerminal` (half-block `▀▄█`, setengah tinggi renderer klasik), `qrToSVG`, `qrToPNG` (encoder PNG hand-rolled di atas zlib Node), `qrToMatrix`, `formatPairingCode`. Round-trip diverifikasi decoder independen (jsQR) di CI.
+- **`printQRInTerminal` berfungsi lagi** — bukan warning deprecated: QR digambar otomatis di terminal tiap `connection.update`.
+- **Fix spam VoIP `VoipStatsTracker is not a constructor`**: shim Metro di `worker-bootstrap.js` menggeser `module`/`exports` satu posisi (argumen ke-5 `null`). Diperbaiki untuk kedua konvensi export bundle FB Comet (flag-66 → arg 6, flag-98 → arg 7, 124/204 modul) + fallback `?.exports` di loader. Diverifikasi worker asli boot sampai `worker_ready` tanpa error shim.
+- **Auto WA-version di Framework `Bot`**: tiap `start()`/reconnect resolve versi tersegar via `fetchBestWaVersion()` (sw.js WA → fork → fallback), mencegah 405 pairing gara-gara versi basi. Opt-out: `versionCheck: false` atau pin `socketConfig.version`.
+- **Full `.d.ts` beneran**: setiap `.js` yang di-ship punya deklarasi pasangan, dijaga test parity + harness `tsc --strict` di CI.
+- **CI + release automation**: GitHub Actions (test di Node 20/22, type-check, pack sanity) dan publish workflow ber-provenance yang terpicu tag `v*`.
+
+---
+
+## 📝 V6 Patch Notes
+
+- Fixed a `package.json` typo: the version field was mistakenly left at `1.0.1` instead of `2.0.1` after the V5 release — corrected to `2.0.1` so the published package version matches the intended release.
+- Expanded README documentation, especially around `lib/Builders/`:
+  - Added the new [📁 Builders Folder Map](#-builders-folder-map-libbuilders) section — a per-file breakdown of everything under `lib/Builders/` (`shared.js`, `Button.js`, `ButtonV2.js`, `ButtonV3.js`, `Carousel.js`, `Poll.js`, `AIRich.js`, `A2UI.js`, `JapBaileys.js`, `index.js`), what each file exports, and what it's for — previously `A2UI` and `JapBaileys` in particular had no usage documentation at all.
+  - Added a usage example for the `JapBaileys` unified builder hub.
+- Redesigned `postinstall-banner.js`: cleaner box layout with a divider separating the title block from a small info section (Node version + docs link), a 256-color palette instead of basic ANSI colors, and a plain-text fallback when stdout isn't a TTY or `NO_COLOR` is set (CI logs, piped output) instead of forcing a box that may render misaligned.
+
+---
+
+## 📝 V5 Patch Notes
+
+- Added [Username Management](#-username-management): `checkUsername`, `checkUsernameMulti`, `setUsername`, `deleteUsername`, `getMyUsername`, `setUsernamePin`, `findUserByUsername`, `fetchContactUsernames`, `getUsernameRecommendations`, layered onto the existing `USyncUsernameProtocol` support.
+- Added the [Bot Framework](#-bot-framework) (`Bot`, `Context`, `SessionManager`, `StatsManager`, `MediaManager`, `SQLiteStore`). Adapted on the way in:
+  - `SQLiteStore`/`StatsManager` construction moved behind an async `.create()` factory so `better-sqlite3` stays a lazily-loaded optional peer dep instead of a hard top-level import that would crash the Framework module for anyone without it installed.
+  - `MediaManager`'s sticker/voice-note conversion now reuses this fork's existing lazy `fluent-ffmpeg` loader (see `Utils/MessageBuilder.js`) instead of adding `ffmpeg-static` + a second ffmpeg dependency; `node-webpmux` (sticker EXIF metadata) is lazy-loaded the same way and only when packname/author is actually requested.
+  - `Bot`'s default logger now falls back to this fork's own pino instance instead of a silent no-op stub.
+- No `.d.ts` files were written for the new Framework module yet — see the note in that section.
+- Bumped to `1.0.1`.
+
+---
+
+## 📝 V4 Patch Notes
+
+- Kept the existing J.AP custom MessageBuilder classes and AIRich implementation intact.
+- Added `whatsapp-rust-bridge@0.5.5` as a runtime dependency. The library already dynamically imports this module for LT Hash/app-state and crypto helpers; declaring it prevents accidental missing-module fallbacks in normal installations.
+- Existing guarded fallbacks for platforms where the native bridge cannot load remain in place.
+- ESM-only package metadata is preserved; no CommonJS build is included.
+
+
+---
+
+<div align="center">
+
+Made with 🍃 by **JAP**
+
+Thanks for visiting, bye 👋
+
+<img src="https://capsule-render.vercel.app/api?type=waving&color=0:2ecc71,100:1d6a23&height=100&section=footer" width="100%"/>
+
+
+
+<a href="#top">⬆️ Back to top</a>
+
+</div>