@kyyinfinite/baileys 2.0.0 → 2.1.0

package/README.md

@@ -1,453 +1,57 @@
-<div align="center">
-
-<img src="https://readme-typing-svg.demolab.com?font=Fira+Code&weight=700&size=15&duration=2500&pause=800&color=00B4D8&center=true&vCenter=true&width=750&lines=@kyyinfinite%2Fbaileys+%E2%80%94+v2.0.0;Interactive+Messages+%7C+Flow+Buttons+%7C+List+Menus;AI+Rich+Response+%7C+Table+%7C+Code+Block+%7C+Link;Album+Messages+%7C+Multi-media+Grouped+Delivery;Based+on+WhiskeySockets%2FBaileys+v7.0.0-rc14;ESM-only+%7C+TypeScript+%7C+Signal+Protocol" alt="Typing SVG" />
-
-<br/>
-
-[![npm version](https://img.shields.io/badge/npm-v2.0.0-CB3837?style=for-the-badge&logo=npm&logoColor=white)](https://www.npmjs.com/package/@kyyinfinite/baileys)
-[![Baileys base](https://img.shields.io/badge/Baileys-7.0.0--rc14-00B4D8?style=for-the-badge)](https://github.com/WhiskeySockets/Baileys/releases/tag/v7.0.0-rc14)
-[![npm downloads](https://img.shields.io/badge/downloads-monthly-00B4D8?style=for-the-badge&logo=npm&logoColor=white)](https://www.npmjs.com/package/@kyyinfinite/baileys)
-[![License](https://img.shields.io/badge/license-MIT-green?style=for-the-badge)](LICENSE)
-[![Node.js](https://img.shields.io/badge/node-%3E%3D20.0.0-339933?style=for-the-badge&logo=nodedotjs&logoColor=white)](https://nodejs.org)
-[![ESM Only](https://img.shields.io/badge/ESM-only-F7DF1E?style=for-the-badge&logo=javascript&logoColor=black)](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules)
-[![TypeScript](https://img.shields.io/badge/TypeScript-ready-3178C6?style=for-the-badge&logo=typescript&logoColor=white)](https://www.typescriptlang.org)
-[![GitHub](https://img.shields.io/badge/GitHub-kyyinfinite-181717?style=for-the-badge&logo=github&logoColor=white)](https://github.com/kyyinfinite/baileys)
-
-<br/>
-
-**`@kyyinfinite/baileys`** is built on top of the official **[WhiskeySockets/Baileys](https://github.com/WhiskeySockets/Baileys) v7.0.0-rc14** release.  
-It keeps the native Baileys socket API intact while adding a cleaner **Kyyinfinite Simple API** for message building, media, buttons, carousels, and other helpers.
-
-<br/>
-
-> [!IMPORTANT]
-> **`@kyyinfinite/baileys`** is **ESM-only**. You must set `"type": "module"` in your `package.json`.  
-> CommonJS projects must migrate or use dynamic `import()` wrappers.
-> 
-> **Base:** `@whiskeysockets/baileys@7.0.0-rc14`
-
-<br/>
-
-</div>
-
----
-
-## 📋 Table of Contents
-
-- [✨ Features](#-features)
-- [✅ Requirements](#-requirements)
-- [📦 Installation](#-installation)
-- [🚀 Quick Start](#-quick-start)
-- [✨ Simple API](#-simple-api)
-  - [Setup](#setup)
-  - [Text](#text-1)
-  - [Media](#media)
-  - [Message Builder](#message-builder)
-  - [Buttons](#buttons)
-  - [Carousel](#carousel-1)
-  - [Generic Message Helpers](#generic-message-helpers)
-  - [Non-mutating API](#non-mutating-api)
-  - [Native Baileys Still Works](#native-baileys-still-works)
-- [💬 Message Examples](#-message-examples)
-  - [Text](#text)
-  - [Image](#image)
-  - [Video](#video)
-  - [Audio & PTT](#audio--ptt)
-  - [Sticker](#sticker)
-  - [Document](#document)
-  - [Location](#location)
-  - [Contact](#contact)
-  - [Poll](#poll)
-  - [Reaction](#reaction)
-  - [Delete & Edit](#delete--edit)
-  - [Forward & Quoted](#forward--quoted)
-  - [Mention](#mention)
-- [⚡ Interactive Messages](#-interactive-messages)
-  - [Flow Buttons](#flow-buttons)
-  - [CTA URL Button](#cta-url-button)
-  - [Copy Button](#copy-button)
-  - [List Menu (single_select)](#list-menu-single_select)
-  - [Carousel](#carousel)
-  - [Native Interactive](#native-interactive)
-- [🤖 AI Rich Response](#-ai-rich-response)
-  - [sendTable()](#sendtable)
-  - [sendList()](#sendlist)
-  - [sendCodeBlock()](#sendcodeblock)
-  - [sendLink()](#sendlink)
-  - [sendUnifiedResponse()](#sendunifiedresponse)
-  - [sendTableV2()](#sendtablev2)
-  - [sendCodeBlockV2()](#sendcodeblockv2)
-  - [sendLinkV2()](#sendlinkv2)
-- [🎞️ Album Messages](#️-album-messages)
-- [📰 Newsletter](#-newsletter)
-- [👥 Group](#-group)
-- [🏘️ Community](#️-community)
-- [🏢 Business](#-business)
-- [👤 Profile](#-profile)
-- [💬 Chat](#-chat)
-- [🔒 Privacy](#-privacy)
-- [📡 Events](#-events)
-- [🔧 Utility Exports](#-utility-exports)
-- [📚 API Reference](#-api-reference)
-- [❓ FAQ](#-faq)
-- [📄 License](#-license)
-
----
-
-## ✨ Features
-
-| Feature | Description | Status |
-|---|---|:---:|
-| **Interactive Messages** | Native Baileys interactive messages, native flow buttons, list/select menus, and carousel structures | ✅ |
-| **Flow Buttons** | `quick_reply`, `cta_url`, `cta_copy` and more button types | ✅ |
-| **Native Button** | Native WhatsApp button structures | ✅ |
-| **Carousel** | Multi-card carousel messages using Baileys `interactiveMessage` / `carouselMessage` structures | ✅ |
-| **AI Rich Response** | Rich-response message structures plus Kyyinfinite helper methods such as `sendTable`, `sendList`, `sendCodeBlock`, and `sendUnifiedResponse` | ✅ |
-| **Album Messages** | Multi-image/video album relay with count metadata and grouped delivery | ✅ |
-| **Link Messages** | Rich inline links with citations, proofs, and forwarded bot context | ✅ |
-| **Table Message** | `sendTable()` / `sendTableV2()` styled as Meta AI tables | ✅ |
-| **Code Block** | `sendCodeBlock()` / `sendCodeBlockV2()` with multi-language syntax support | ✅ |
-| **Unified Response** | `sendUnifiedResponse()` unified sections | ✅ |
-| **Newsletter** | URL resolve, metadata fetch, create/update, bulk follow, admin utilities, live updates | ✅ |
-| **Communities** | Community CRUD, linked groups, invite workflows, join approval, labels | ✅ |
-| **Business API** | Business profile update, catalog management, product CRUD | ✅ |
-| **Catalog** | Fetch, create, update, delete product listings and cover photos | ✅ |
-| **Payment** | Request payment messages with note/sticker support | ✅ |
-| **Poll** | Send and receive poll messages with `selectableCount` | ✅ |
-| **Event** | Event message builders and poll result snapshots | ✅ |
-| **Status Mention** | `sendStatusMention()` to mention users/groups in status flows | ✅ |
-| **LID Mapping** | Full LID↔PN mapping + session migration and retry helpers | ✅ |
-| **Pairing Code** | Request pairing code or use custom 8-char code | ✅ |
-| **QR Login** | Scan QR code via `connection.update` event | ✅ |
-| **Media Upload** | Image, video, audio, sticker, document via URL or Buffer | ✅ |
-| **TypeScript** | Included `.d.ts` declarations for all exported APIs | ✅ |
-| **ESM** | Native ES Module — no CommonJS bundle | ✅ |
-
----
-
-## ✅ Requirements
-
-| Requirement | Version / Detail |
-|---|---|
-| **Node.js** | `>= 20.0.0` |
-| **Baileys base** | `7.0.0-rc14` |
-| **Module system** | ESM only — `"type": "module"` in `package.json` |
-| **Auth store** | Persistent auth required for production use |
-
-**Optional companion packages:**
-
-| Package | Purpose |
-|---|---|
-| `pino` | Structured logging |
-| `qrcode-terminal` | Render QR codes in terminal |
-| `sharp` | Image processing for sticker/media utilities |
-| `link-preview-js` | Generate link previews |
-| `audio-decode` | Audio format decoding |
-
-> [!NOTE]
-> Peer dependencies like `sharp`, `jimp`, `audio-decode`, and `link-preview-js` are **optional**.  
-> Install only what your bot features actually need.
-
----
-
-## 📦 Installation
-
-**npm**
-```bash
-npm install @kyyinfinite/baileys
-```
-
-**pnpm**
-```bash
-pnpm add @kyyinfinite/baileys
-```
-
-**yarn**
-```bash
-yarn add @kyyinfinite/baileys
-```
-
-**bun**
-```bash
-bun add @kyyinfinite/baileys
-```
-
-**Recommended companion packages:**
-```bash
-npm install pino qrcode-terminal
-```
-
-> [!TIP]
-> Always install `pino` and `qrcode-terminal` alongside `@kyyinfinite/baileys` for the best development experience — logger suppression and QR rendering are needed in almost every bot project.
-
----
-
-## 🚀 Quick Start
-
-### 1. Project Setup
-
-```bash
-mkdir my-bot && cd my-bot
-npm init -y
-```
-
-Open `package.json` and add `"type": "module"`:
-
-```json
-{
-  "name": "my-bot",
-  "version": "1.0.0",
-  "type": "module",
-  "main": "index.js",
-  "scripts": {
-    "start": "node index.js"
-  }
-}
-```
-
-> [!IMPORTANT]
-> **`"type": "module"` is required.** `@kyyinfinite/baileys` is ESM-only.  
-> Without this field, all imports will throw a syntax error.
-
----
-
-### 2. Install Dependencies
-
-```bash
-npm install @kyyinfinite/baileys pino qrcode-terminal
-```
-
----
-
-### 3. Create index.js
-
-```js
-import makeWASocket, {
-  useMultiFileAuthState,
-  DisconnectReason,
-  Browsers,
-} from "@kyyinfinite/baileys";
-import pino from "pino";
-import qrcode from "qrcode-terminal";
-
-const logger = pino({ level: "silent" });
-
-async function startBot() {
-  const { state, saveCreds } = await useMultiFileAuthState("./session");
-
-  const sock = makeWASocket({
-    auth: state,
-    logger,
-    browser: Browsers.ubuntu("Chrome"),
-    syncFullHistory: false,
-  });
-
-  sock.ev.on("creds.update", saveCreds);
-
-  sock.ev.on("connection.update", ({ connection, lastDisconnect, qr }) => {
-    if (qr) {
-      qrcode.generate(qr, { small: true });
-    }
-
-    if (connection === "close") {
-      const shouldReconnect =
-        lastDisconnect?.error?.output?.statusCode !== DisconnectReason.loggedOut;
-      if (shouldReconnect) startBot();
-    }
-
-    if (connection === "open") {
-      console.log("✅ Connected!");
-    }
-  });
-
-  sock.ev.on("messages.upsert", async ({ messages }) => {
-    const msg = messages[0];
-    if (!msg?.message || msg.key.fromMe) return;
-
-    const text =
-      msg.message.conversation ||
-      msg.message.extendedTextMessage?.text ||
-      "";
-
-    if (text === ".ping") {
-      await sock.sendMessage(msg.key.remoteJid, { text: "🏓 Pong!" });
-    }
-  });
-}
-
-startBot();
-```
-
----
-
-### 4. Run & QR Code Login
-
-```bash
-node index.js
-```
-
-Scan the QR code in your terminal using **WhatsApp → Linked Devices → Link a Device**.  
-Wait until the socket reaches `connection === "open"`, then send `.ping` to test.
-
----
-
-### 5. Pairing Code Login
+# @kyyinfinite/baileys
 
-If you prefer pairing code authentication over QR:
+A developer-friendly WhatsApp messaging API for Node.js with a fluent
+builder interface, message utilities, JID helpers, interactive messages,
+media handling, and advanced message composition.
 
-```js
-import makeWASocket, {
-  useMultiFileAuthState,
-  Browsers,
-} from "@kyyinfinite/baileys";
-import pino from "pino";
+## Installation
 
-const logger = pino({ level: "silent" });
-
-async function startBot() {
-  const { state, saveCreds } = await useMultiFileAuthState("./session");
-
-  const sock = makeWASocket({
-    auth: state,
-    logger,
-    browser: Browsers.windows("Chrome"),
-  });
-
-  sock.ev.on("creds.update", saveCreds);
-
-  sock.ev.on("connection.update", async ({ connection }) => {
-    if (connection === "connecting") {
-      // Replace with your phone number (include country code, no +)
-      const code = await sock.requestPairingCode("6281234567890");
-      console.log("🔑 Pairing code:", code);
-    }
-
-    if (connection === "open") {
-      console.log("✅ Connected via pairing code!");
-    }
-  });
-}
-
-startBot();
-```
-
-**Custom pairing code (exactly 8 characters):**
-
-```js
-const code = await sock.requestPairingCode("6281234567890", "A1B2C3D4");
-console.log("🔑 Custom pairing code:", code);
-```
-
-> [!WARNING]
-> Custom pairing codes **must be exactly 8 characters**. Any other length will be rejected by WhatsApp.
-
-> [!NOTE]
-> `printQRInTerminal` still exists in the type surface for compatibility, but it is deprecated in this build.  
-> Prefer handling the `qr` value from `connection.update` directly with `qrcode-terminal`.
-
----
-
-### 6. Auto Reconnect
-
-```js
-sock.ev.on("connection.update", ({ connection, lastDisconnect }) => {
-  if (connection === "close") {
-    const statusCode = lastDisconnect?.error?.output?.statusCode;
-    const shouldReconnect = statusCode !== DisconnectReason.loggedOut;
-
-    console.log(`Connection closed (code: ${statusCode}). Reconnecting: ${shouldReconnect}`);
-
-    if (shouldReconnect) {
-      startBot(); // call your startBot function again
-    } else {
-      console.log("Logged out. Delete ./session and restart.");
-    }
-  }
-});
+``` bash
+npm install @kyyinfinite/baileys
 ```
 
-> [!TIP]
-> For production bots, use a process manager like **PM2** (`pm2 start index.js`) so your bot automatically restarts after crashes, not just reconnects after disconnects.
-
----
-
-## ✨ Simple API
-
-> [!NOTE]
-> **v2.0.0** introduces the `@kyyinfinite/baileys` Simple API — a fluent wrapper on top of the native socket.
-> Native Baileys methods remain available and unchanged.
-
-### Setup
+## Quick Start
 
-```js
-import makeWASocket, {
-  useMultiFileAuthState,
-  attachKyyinfinite,
-} from "@kyyinfinite/baileys";
-
-const { state, saveCreds } = await useMultiFileAuthState("./session");
-
-const sock = makeWASocket({
-  auth: state,
-});
-
-sock.ev.on("creds.update", saveCreds);
-
-attachKyyinfinite(sock);
-```
+``` js
+import { makeWASocket, attachKyyinfinite } from '@kyyinfinite/baileys'
 
-After attaching the wrapper, the socket can use both the original Baileys API and the simpler fluent API.
+const sock = makeWASocket(config)
 
-### Text
+attachKyyinfinite(sock)
 
-```js
-await sock.text("Hello")
-  .send(jid);
+await sock
+  .text('Hello')
+  .send(jid)
 ```
 
-### Media
+The API is designed to keep common operations short while still allowing
+advanced message builders when needed.
 
-```js
-await sock.image({ url: "./image.jpg" })
-  .caption("Hello")
-  .send(jid);
+------------------------------------------------------------------------
 
-await sock.video({ url: "./video.mp4" })
-  .caption("Video")
-  .send(jid);
+# API
 
-await sock.audio({ url: "./audio.mp3" })
-  .send(jid);
+## Text
 
-await sock.voice({ url: "./voice.ogg" })
-  .send(jid);
-
-await sock.sticker({ url: "./sticker.webp" })
-  .send(jid);
-
-await sock.document({ url: "./file.pdf" })
-  .fileName("document.pdf")
-  .send(jid);
-
-await sock.ptv({ url: "./video.mp4" })
-  .send(jid);
-
-await sock.gif({ url: "./video.mp4" })
-  .send(jid);
+``` js
+await sock
+  .text('Hello')
+  .send(jid)
 ```
 
-### Message Builder
+Additional text options:
 
-```js
-await sock.text("Hello")
-  .footer("Powered by @kyyinfinite/baileys")
-  .mentions(["6281234567890@s.whatsapp.net"])
-  .send(jid);
+``` js
+await sock
+  .text('Hello')
+  .footer('Kyyinfinite')
+  .mentions(['628123456789@s.whatsapp.net'])
+  .send(jid)
 ```
 
-Supported fluent options include:
+Available text builder methods:
 
-```text
+``` text
 text()
 footer()
 context()
@@ -459,1436 +63,730 @@ build()
 send()
 ```
 
-### Buttons
+------------------------------------------------------------------------
 
-```js
-await sock.button()
-  .title("Welcome")
-  .body("Choose an option")
-  .footer("Powered by @kyyinfinite/baileys")
-  .addButton("Menu", "menu")
-  .send(jid);
-```
+# Media
 
-CTA helpers are also available:
-
-```js
-await sock.button()
-  .title("Actions")
-  .body("Choose an action")
-  .reply("Reply", "reply_1")
-  .url("Website", "https://example.com")
-  .copy("Copy", "KYY-001")
-  .call("Call", "628123456789")
-  .send(jid);
-```
+Shortcut builders:
 
-The copy helper also supports the shorthand typo-compatible alias:
+``` js
+await sock.image('./image.jpg')
+  .caption('Image')
+  .send(jid)
 
-```js
-.copy("Copy", "KYY-001")
-.coppy("Copy", "KYY-001")
-```
+await sock.video('./video.mp4')
+  .caption('Video')
+  .send(jid)
 
-Additional button helpers:
+await sock.audio('./audio.mp3')
+  .send(jid)
 
-```text
-reply() / quickReply()
-call()
-url()
-copy() / coppy()
-reminder()
-cancelReminder()
-address()
-location()
-select()
-section()
-row()
-```
+await sock.voice('./voice.ogg')
+  .send(jid)
 
-### ButtonV2
+await sock.document('./file.pdf')
+  .fileName('document.pdf')
+  .send(jid)
 
-```js
-await sock.buttonV2()
-  .title("Button V2")
-  .body("Choose an option")
-  .send(jid);
+await sock.sticker('./sticker.webp')
+  .send(jid)
 ```
 
-The raw builder is still available when full low-level control is required.
+Other media shortcuts:
 
-### Carousel
+``` text
+ptv()
+gif()
+```
 
-The carousel API supports a nested fluent card builder:
+## Universal Media
 
-```js
-await sock.carousel()
-  .body("Choose a product")
-  .footer("Kyyinfinite")
-  .card()
-    .image({ url: "./product-1.jpg" })
-    .title("Product One")
-    .body("Product description")
-    .button("Pilih", "product_1")
-    .url("Website", "https://example.com")
-    .copy("Copy Code", "KYY-001")
-    .call("Call", "628123456789")
-    .add()
-  .card()
-    .image({ url: "./product-2.jpg" })
-    .title("Product Two")
-    .body("Product two")
-    .button("Pilih", "product_2")
-    .add()
-  .send(jid);
+Use one builder when the media type needs to be selected dynamically:
+
+``` js
+await sock
+  .media(buffer)
+  .asImage()
+  .caption('Photo')
+  .send(jid)
 ```
 
-Card helpers:
+Supported types:
 
-```text
-title()
-body() / text()
-footer()
-image()
-video()
-media()
-button()
-reply() / quickReply()
-url()
-copy() / coppy()
-call()
-buttons()
-rawButton()
-context()
-payload()
-build()
-add()
-end()
+``` text
+asImage()
+asVideo()
+asAudio()
+asDocument()
+asSticker()
 ```
 
-Carousel helpers:
+Media builder options include:
 
-```text
-card()
-addCard()
-cards()
-clear()
-title()
-subtitle()
-body() / text()
-footer()
+``` text
+caption()
+fileName()
+mimetype()
 context()
+mentions()
 payload()
-loadFrom()
+viewOnce()
+ptt()
+voice()
+ptv()
+videoNote()
+gif()
+animated()
+dimensions()
+thumbnail()
 build()
 send()
 ```
 
-### Generic Message Helpers
+------------------------------------------------------------------------
 
-```js
-await sock.message({ text: "Hello" })
-  .send(jid);
+## Unified Send
 
-await sock.poll(
-  "What's your favorite language?",
-  ["JavaScript", "TypeScript", "Python"],
-  1
-).send(jid);
+For simple messages, use:
 
-await sock.location({
-  degreesLatitude: -6.2088,
-  degreesLongitude: 106.8456,
-  name: "Jakarta"
-}).send(jid);
+``` js
+await sock.send(jid, 'Hello')
+```
 
-await sock.react(msg.key, "👍");
+Object payloads are also supported:
 
-await sock.delete(msg.key);
+``` js
+await sock.send(jid, {
+  text: 'Hello'
+})
 ```
 
-Available helpers include:
+Media:
 
-```text
-message()
-poll()
-event()
-album()
-contacts()
-location()
-buttonReply()
-listReply()
-react()
-groupInvite()
-product()
-requestPhoneNumber()
-sharePhoneNumber()
-pin()
-forward()
-delete()
-disappearing()
-limitSharing()
+``` js
+await sock.send(jid, {
+  image: './image.jpg',
+  caption: 'Hello'
+})
 ```
 
-### Non-mutating API
+The unified API is intended for cases where you do not need to manually
+create a builder.
 
-If you do not want to modify the socket object, create a separate API facade:
+------------------------------------------------------------------------
 
-```js
-import {
-  createKyyinfinite,
-} from "@kyyinfinite/baileys";
+## Quoted Messages
 
-const api = createKyyinfinite(sock);
+Reply directly to an existing message:
 
-await api.text("Hello")
-  .send(jid);
+``` js
+await sock.reply(message, 'Hello')
 ```
 
-The facade keeps the original socket accessible through `api.raw`:
+Or:
 
-```js
-api.raw
+``` js
+await sock.quoted(message, 'Hello')
 ```
 
-Raw wrapper classes are available through:
-
-```js
-api.raw.Button
-api.raw.ButtonV2
-api.raw.Carousel
-api.raw.AIRich
-api.raw.Toolkit
-api.raw.Foad
-api.raw.Foad2
-```
+Message wrapper:
 
-Use the Simple API for everyday message construction while keeping the raw builders available whenever lower-level control is needed.
+``` js
+const m = sock.wrapMessage(message)
 
-### Native Baileys Still Works
+await m.reply('Hello')
+```
 
-The Simple API does not replace native socket methods:
+Available message actions:
 
-```js
-await sock.sendMessage(jid, {
-  text: "Hello from native Baileys"
-});
+``` text
+reply()
+react()
+edit()
+delete()
+forward()
+download()
+```
 
-await sock.sendPresenceUpdate("composing", jid);
+Socket shortcuts:
 
-sock.ev.on("messages.upsert", ({ messages }) => {
-  console.log(messages);
-});
+``` text
+reply()
+reactTo()
+editMessage()
+deleteMessage()
+forwardMessage()
+downloadMessage()
 ```
 
-Use the Simple API when you want shorter, cleaner code. Use the native API or `.raw` builders whenever you need lower-level control.
+------------------------------------------------------------------------
 
----
+## Message Parser
 
-## 💬 Message Examples
+Parse an incoming message into a simple object:
 
-### Text
+``` js
+const parsed = sock.parseMessage(message, {
+  prefix: '.'
+})
 
-```js
-await sock.sendMessage(jid, { text: "Hello, World! 👋" });
+console.log(parsed.text)
+console.log(parsed.command)
+console.log(parsed.args)
 ```
 
-### Image
-
-```js
-// From URL
-await sock.sendMessage(jid, {
-  image: { url: "https://example.com/photo.jpg" },
-  caption: "A beautiful photo 📸",
-});
-
-// From file path
-await sock.sendMessage(jid, {
-  image: { url: "./photo.jpg" },
-  caption: "Local photo",
-});
-
-// From Buffer
-import { readFileSync } from "fs";
-await sock.sendMessage(jid, {
-  image: readFileSync("./photo.jpg"),
-  caption: "From buffer",
-});
-```
+Returned data includes:
 
-### Video
-
-```js
-await sock.sendMessage(jid, {
-  video: { url: "./video.mp4" },
-  caption: "Check this out 🎬",
-  gifPlayback: false, // set true for GIF-style playback
-});
-```
-
-### Audio & PTT
-
-```js
-// Audio file
-await sock.sendMessage(jid, {
-  audio: { url: "./audio.mp3" },
-  mimetype: "audio/mp4",
-});
-
-// Push-to-talk (voice note)
-await sock.sendMessage(jid, {
-  audio: { url: "./voice.ogg" },
-  mimetype: "audio/ogg; codecs=opus",
-  ptt: true,
-});
+``` text
+message
+content
+messageType
+text
+command
+args
+jid
+sender
+isGroup
+isReply
+quoted
+key
 ```
 
-### Sticker
+Example command:
 
-```js
-await sock.sendMessage(jid, {
-  sticker: { url: "./sticker.webp" },
-});
+``` text
+.menu game hard
 ```
 
-### Document
+can be consumed as:
 
-```js
-await sock.sendMessage(jid, {
-  document: { url: "./report.pdf" },
-  fileName: "Monthly Report.pdf",
-  mimetype: "application/pdf",
-  caption: "Here is the report 📄",
-});
+``` js
+parsed.command // "menu"
+parsed.args    // ["game", "hard"]
 ```
 
-### Location
-
-```js
-await sock.sendMessage(jid, {
-  location: {
-    degreesLatitude: -6.2088,
-    degreesLongitude: 106.8456,
-    name: "Jakarta, Indonesia",
-    address: "Jakarta, Indonesia",
-  },
-});
-```
+------------------------------------------------------------------------
 
-### Contact
-
-```js
-await sock.sendMessage(jid, {
-  contacts: {
-    displayName: "John Doe",
-    contacts: [
-      {
-        vcard: `BEGIN:VCARD\nVERSION:3.0\nFN:John Doe\nTEL;type=CELL;type=VOICE;waid=6281234567890:+62 812-3456-7890\nEND:VCARD`,
-      },
-    ],
-  },
-});
-```
+## Mentions
 
-### Poll
+Text containing a WhatsApp-style number can be resolved automatically:
 
-```js
-await sock.sendMessage(jid, {
-  poll: {
-    name: "What's your favorite language?",
-    values: ["JavaScript", "TypeScript", "Python", "Go"],
-    selectableCount: 1, // 0 = allow multiple
-  },
-});
+``` js
+await sock.send(
+  jid,
+  'Hello @628123456789'
+)
 ```
 
-### Reaction
+Disable automatic mention resolution when required:
 
-```js
-await sock.sendMessage(jid, {
-  react: {
-    key: msg.key,  // key of the message to react to
-    text: "👍",    // use "" to remove reaction
-  },
-});
+``` js
+await sock.send(
+  jid,
+  'Hello @628123456789',
+  {
+    autoMentions: false
+  }
+)
 ```
 
-### Delete & Edit
+Explicit mentions can also be supplied through the builder API.
 
-```js
-// Delete a message (for everyone)
-await sock.sendMessage(jid, { delete: msg.key });
+------------------------------------------------------------------------
 
-// Edit a sent message
-await sock.sendMessage(jid, {
-  text: "This is the corrected text ✏️",
-  edit: msg.key,
-});
-```
-
-### Forward & Quoted
+## JID Utilities
 
-```js
-// Forward a message
-await sock.sendMessage(jid, { forward: msg });
+Parse a JID:
 
-// Reply (quoted message)
-await sock.sendMessage(
-  jid,
-  { text: "This is a reply!" },
-  { quoted: msg }
-);
+``` js
+sock.parseJid('628123456789:7@s.whatsapp.net')
 ```
 
-### Mention
-
-```js
-await sock.sendMessage(jid, {
-  text: "Hey @628111222333, how are you?",
-  mentions: ["628111222333@s.whatsapp.net"],
-});
-```
+Result:
 
-### Context Info
-
-```js
-await sock.sendMessage(jid, {
-  text: "Message with custom context",
-  contextInfo: {
-    externalAdReply: {
-      title: "My Bot",
-      body: "Powered by @kyyinfinite/baileys",
-      thumbnail: readFileSync("./thumbnail.jpg"),
-      sourceUrl: "https://github.com/kyyinfinite/baileys",
-      mediaType: 1,
-      renderLargerThumbnail: true,
-    },
-  },
-});
+``` js
+{
+  user: '628123456789',
+  device: '7',
+  server: 's.whatsapp.net',
+  jid: '628123456789:7@s.whatsapp.net'
+}
 ```
 
----
-
-## ⚡ Interactive Messages
-
-> [!NOTE]
-> Interactive messages are based on the native **Baileys v7.0.0-rc14** message structures.  
-> The Kyyinfinite Simple API provides a shorter fluent interface on top of those native structures.
-
-### Flow Buttons
-
-```js
-await sock.sendMessage(jid, {
-  interactiveMessage: {
-    title: "Welcome! 👋",
-    footer: "Powered by @kyyinfinite/baileys",
-    buttons: [
-      {
-        name: "quick_reply",
-        buttonParamsJson: JSON.stringify({
-          display_text: "📋 Menu",
-          id: "menu",
-        }),
-      },
-    ],
-    header: "Choose an option below",
-  },
-});
-```
+Access individual parts:
 
-### CTA URL Button
-
-```js
-await sock.sendMessage(jid, {
-  interactiveMessage: {
-    title: "Visit our website",
-    footer: "Powered by @kyyinfinite/baileys",
-    buttons: [
-      {
-        name: "cta_url",
-        buttonParamsJson: JSON.stringify({
-          display_text: "🌐 Open Website",
-          url: "https://example.com",
-          merchant_url: "https://example.com",
-        }),
-      },
-    ],
-    header: "External Link",
-  },
-});
+``` js
+sock.jidUser(jid)
+sock.jidServer(jid)
+sock.jidDevice(jid)
 ```
 
-### Copy Button
-
-```js
-await sock.sendMessage(jid, {
-  interactiveMessage: {
-    title: "Your promo code",
-    footer: "Tap to copy",
-    buttons: [
-      {
-        name: "cta_copy",
-        buttonParamsJson: JSON.stringify({
-          display_text: "📋 Copy Code",
-          copy_code: "KYYBAILEYS2024",
-        }),
-      },
-    ],
-    header: "Promo Code",
-  },
-});
-```
+Normalize:
 
-### List Menu (single_select)
-
-```js
-await sock.sendMessage(jid, {
-  interactiveMessage: {
-    title: "Select a Category",
-    footer: "Powered by @kyyinfinite/baileys",
-    buttons: [
-      {
-        name: "single_select",
-        buttonParamsJson: JSON.stringify({
-          title: "📋 Open Menu",
-          sections: [
-            {
-              title: "🛠️ Tools",
-              rows: [
-                { title: "🖼️ Sticker Maker", description: "Convert image to sticker", id: ".sticker" },
-                { title: "🗣️ Text to Speech", description: "Convert text to audio", id: ".tts" },
-                { title: "🔍 AI Search", description: "Ask the AI anything", id: ".ai" },
-              ],
-            },
-            {
-              title: "ℹ️ Info",
-              rows: [
-                { title: "📊 Bot Stats", description: "View bot statistics", id: ".stats" },
-                { title: "❓ Help", description: "How to use this bot", id: ".help" },
-              ],
-            },
-          ],
-        }),
-      },
-    ],
-    header: "🤖 Bot Menu",
-  },
-});
+``` js
+sock.jid(jid)
 ```
 
-### Carousel
-
-For the native Baileys structure, a carousel is represented by an `interactiveMessage` containing a `carouselMessage`. Media headers are prepared before the message is relayed:
-
-```js
-import {
-  proto,
-  prepareWAMessageMedia,
-  generateWAMessageFromContent,
-} from "@kyyinfinite/baileys";
-
-const cards = [];
-
-for (const [index, imageUrl] of [
-  "https://example.com/card1.jpg",
-  "https://example.com/card2.jpg",
-]) {
-  const media = await prepareWAMessageMedia(
-    { image: { url: imageUrl } },
-    { upload: sock.waUploadToServer },
-  );
-
-  cards.push(
-    proto.Message.InteractiveMessage.fromObject({
-      header: {
-        title: `Card ${index + 1}`,
-        hasMediaAttachment: true,
-        ...media,
-      },
-      body: { text: `Description for card ${index + 1}` },
-      footer: { text: "@kyyinfinite/baileys" },
-      nativeFlowMessage: {
-        buttons: [
-          {
-            name: "quick_reply",
-            buttonParamsJson: JSON.stringify({
-              display_text: "Select",
-              id: `card_${index + 1}`,
-            }),
-          },
-        ],
-      },
-    }),
-  );
-}
+Create a JID:
 
-const message = generateWAMessageFromContent(
-  jid,
-  {
-    viewOnceMessage: {
-      message: {
-        interactiveMessage: proto.Message.InteractiveMessage.fromObject({
-          body: { text: "Choose a product" },
-          footer: { text: "Swipe to see more" },
-          carouselMessage: { cards },
-        }),
-      },
-    },
-  },
-  {},
-);
-
-await sock.relayMessage(
-  jid,
-  message.message,
-  { messageId: message.key.id },
-);
+``` js
+sock.makeJid('628123456789')
 ```
 
+JID checks:
 
-### Native Interactive
-
-Combine multiple button types in a single message:
-
-```js
-await sock.sendMessage(jid, {
-  interactiveMessage: {
-    title: "🛍️ Product Details",
-    footer: "Free shipping above Rp 100.000",
-    buttons: [
-      {
-        name: "quick_reply",
-        buttonParamsJson: JSON.stringify({ display_text: "🛒 Buy Now", id: "buy_now" }),
-      },
-      {
-        name: "cta_url",
-        buttonParamsJson: JSON.stringify({
-          display_text: "📄 More Info",
-          url: "https://example.com/product",
-        }),
-      },
-      {
-        name: "cta_copy",
-        buttonParamsJson: JSON.stringify({
-          display_text: "📋 Copy Product ID",
-          copy_code: "PROD-12345",
-        }),
-      },
-    ],
-    header: "Premium Package",
-    image: { url: "https://example.com/product.jpg" },
-  },
-});
+``` js
+sock.isGroup(jid)
+sock.isPrivate(jid)
+sock.isBroadcast(jid)
+sock.isStatus(jid)
+sock.isNewsletter(jid)
+sock.isLid(jid)
 ```
 
----
+------------------------------------------------------------------------
 
-## 🤖 AI Rich Response
+## Buttons
 
-> [!NOTE]
-> These message types are styled to match **Meta AI's** WhatsApp response format — tables, code blocks, and rich linked text.  
-> The underlying rich-response message types are part of the Baileys v7 line. The `sendTable()`, `sendList()`, `sendCodeBlock()`, and related convenience methods documented here are exposed by this package.
+## Basic Button
 
-### sendTable()
-
-```js
-await sock.sendTable(
-  jid,
-  "Java vs JavaScript",
-  ["Feature", "Java", "JavaScript"],
-  [
-    ["Type",     "Compiled",    "Interpreted"],
-    ["Typing",   "Static",      "Dynamic"],
-    ["Runtime",  "JVM",         "V8 / Browser"],
-    ["Main Use", "Enterprise",  "Web, Full-stack"],
-    ["Speed",    "Faster",      "Slightly Slower"],
-  ],
-  quoted,
-  {
-    headerText: "📊 Comparison Table:",
-    footer: "Hope this helps! 😊",
-  }
-);
+``` js
+await sock
+  .button()
+  .title('Menu')
+  .body('Choose an option')
+  .addButton('Option 1', 'one')
+  .addButton('Option 2', 'two')
+  .send(jid)
 ```
 
-### sendList()
+## Reply
 
-```js
-await sock.sendList(
-  jid,
-  "Bot Information",
-  [
-    ["Package",   "@kyyinfinite/baileys"],
-    ["Version",   "2.0.0"],
-    ["Developer", "kyyinfinite"],
-    ["License",   "MIT"],
-    ["Node",      ">= 20"],
-  ],
-  quoted,
-  { footer: "© 2026 kyyinfinite" }
-);
+``` js
+sock.button()
+  .reply('Open', 'open')
 ```
 
-### sendCodeBlock()
+Aliases:
 
-V1 supports: `javascript`, `typescript`, `python`
-
-```js
-await sock.sendCodeBlock(
-  jid,
-  `import makeWASocket from "@kyyinfinite/baileys";\n\nconst sock = makeWASocket({ auth: state });`,
-  quoted,
-  {
-    language: "javascript",
-    title: "Quick Start",
-    footer: "Powered by @kyyinfinite/baileys",
-  }
-);
+``` text
+reply()
+quickReply()
 ```
 
-### sendLink()
+## URL
 
-```js
-await sock.sendLink(
-  jid,
-  "Upload results:\n🔗 Click: {{IE_0}}download here{{/IE_0}}",
-  ["https://example.com/file.zip"],
-  quoted,
-  {
-    headerText: "📁 File Uploader",
-    footer: "✨ Upload complete!",
-    citations: [{ sourceTitle: "FileHost", citationNumber: 1 }],
-  }
-);
+``` js
+sock.button()
+  .url('Website', 'https://example.com')
 ```
 
-### sendUnifiedResponse()
+## Copy
 
-```js
-await sock.sendUnifiedResponse(
-  jid,
-  "Here is a unified response combining text and structured data.",
-  quoted,
-  {
-    headerText: "🤖 AI Response",
-    footer: "Powered by @kyyinfinite/baileys",
-  }
-);
+``` js
+sock.button()
+  .copy('Copy Code', 'KYY-001')
 ```
 
-### sendTableV2()
+Both aliases are supported:
 
-```js
-await sock.sendTableV2(
-  jid,
-  "Framework Comparison",
-  ["Framework", "Language", "Use Case"],
-  [
-    ["Express",  "JavaScript", "REST API"],
-    ["Fastify",  "JavaScript", "High-perf API"],
-    ["Hono",     "TypeScript", "Edge / Bun"],
-    ["Elysia",   "TypeScript", "Bun Native"],
-  ],
-  quoted,
-  {
-    text: "Here's a framework comparison you requested:",
-    headerText: "📊 Frameworks",
-    footer: "Updated 2026",
-  }
-);
+``` text
+copy()
+coppy()
+ctaCopy()
 ```
 
-### sendCodeBlockV2()
-
-V2 supports: `javascript` / `js` / `typescript` / `ts`, `python` / `py`, `go` / `golang`, `lua`, `bash` / `sh` / `shell`
+## Call
 
-```js
-await sock.sendCodeBlockV2(
-  jid,
-  `func main() {\n    fmt.Println("Hello, @kyyinfinite/baileys!")\n}`,
-  quoted,
-  {
-    language: "go",
-    title: "Go Example",
-    text: "Here is a Go snippet:",
-    footer: "Powered by @kyyinfinite/baileys",
-  }
-);
+``` js
+sock.button()
+  .call('Call', '628123456789')
 ```
 
-**All supported V2 languages:**
-
-| Language Key | Aliases |
-|---|---|
-| `javascript` | `js`, `typescript`, `ts` |
-| `python` | `py` |
-| `go` | `golang` |
-| `lua` | — |
-| `bash` | `sh`, `shell` |
-
-### sendLinkV2()
+Aliases:
 
-```js
-await sock.sendLinkV2(
-  jid,
-  "Search results:\n- {{IE_0}}Official npm page{{/IE_0}}\n- {{IE_1}}GitHub repository{{/IE_1}}",
-  [
-    {
-      url: "https://www.npmjs.com/package/@kyyinfinite/baileys",
-      displayName: "Official npm page",
-      sourceDisplayName: "npmjs.com",
-    },
-    {
-      url: "https://github.com/kyyinfinite/baileys",
-      displayName: "GitHub repository",
-      sourceDisplayName: "github.com",
-    },
-  ],
-  quoted,
-  {
-    headerText: "@kyyinfinite/baileys",
-    footer: "Reference links",
-    searchEngine: "MAME",
-  }
-);
+``` text
+call()
+ctaCall()
 ```
 
----
-
-## 🎞️ Album Messages
+Other button helpers:
 
-Send multiple images and/or videos as a grouped album in a single message:
-
-```js
-await sock.sendMessage(jid, {
-  albumMessage: [
-    { image: { url: "./photo1.jpg" }, caption: "First photo 🌅" },
-    { image: { url: "./photo2.jpg" }, caption: "Second photo 🌄" },
-    { image: { url: "https://example.com/photo3.jpg" }, caption: "Remote photo 🌃" },
-    { video: { url: "./clip.mp4" }, caption: "Bonus clip 🎬" },
-  ],
-});
+``` text
+reminder()
+cancelReminder()
+address()
+location()
+select()
+section()
+row()
+image()
+document()
+media()
+context()
+payload()
+clear()
+params()
 ```
 
-> [!NOTE]
-> Albums automatically compute and set `expectedImageCount` and `expectedVideoCount`  
-> based on the array content. You do not need to set these manually.
-
-> [!TIP]
-> You can mix images and videos freely inside an album. Albums support both local file paths and remote URLs.
-
----
-
-## 📰 Newsletter
-
-All newsletter methods are available directly on the socket:
-
-```js
-// Follow a newsletter channel
-await sock.newsletterFollow("123456789@newsletter");
-
-// Unfollow a newsletter channel
-await sock.newsletterUnfollow("123456789@newsletter");
+------------------------------------------------------------------------
 
-// Create a new newsletter channel
-await sock.newsletterCreate("My Channel", "Channel description");
+## ButtonV2
 
-// Update newsletter metadata
-await sock.newsletterUpdate("123456789@newsletter", {
-  name: "Updated Channel Name",
-  description: "Updated description",
-});
-
-// React to a newsletter message
-await sock.newsletterReactMessage("123456789@newsletter", serverId, "👍");
-
-// Fetch recent newsletter messages
-const msgs = await sock.newsletterFetchMessages("123456789@newsletter", 50, 0, 0);
-
-// Fetch newsletter metadata
-const meta = await sock.newsletterMetadata("123456789@newsletter");
-
-// Admin: Mute/unmute newsletter
-await sock.newsletterAdminMute("123456789@newsletter", true);
-
-// Bulk follow multiple channels
-await sock.newsletterBulkFollow([
-  "123456789@newsletter",
-  "987654321@newsletter",
-]);
-
-// Resolve newsletter URL
-const resolved = await sock.newsletterResolveUrl("https://whatsapp.com/channel/xxxxx");
+``` js
+await sock
+  .buttonV2()
+  .addButton(...)
+  .send(jid)
 ```
 
----
-
-## 👥 Group
-
-Complete group management API:
-
-```js
-// Fetch group metadata
-const meta = await sock.groupMetadata("groupid@g.us");
-console.log(meta.subject, meta.participants);
+The builder also supports:
 
-// Create a new group
-const group = await sock.groupCreate("My New Group", [
-  "628111@s.whatsapp.net",
-  "628222@s.whatsapp.net",
-]);
-
-// Add / remove / promote / demote participants
-await sock.groupParticipantsUpdate("groupid@g.us", ["628111@s.whatsapp.net"], "add");
-await sock.groupParticipantsUpdate("groupid@g.us", ["628111@s.whatsapp.net"], "remove");
-await sock.groupParticipantsUpdate("groupid@g.us", ["628111@s.whatsapp.net"], "promote");
-await sock.groupParticipantsUpdate("groupid@g.us", ["628111@s.whatsapp.net"], "demote");
-
-// Update group name / description
-await sock.groupUpdateSubject("groupid@g.us", "New Group Name");
-await sock.groupUpdateDescription("groupid@g.us", "New group description");
-
-// Group settings
-await sock.groupSettingUpdate("groupid@g.us", "announcement");  // only admins send
-await sock.groupSettingUpdate("groupid@g.us", "not_announcement"); // everyone sends
-
-// Toggle disappearing messages
-await sock.groupToggleEphemeral("groupid@g.us", 86400); // 24 hours; 0 to disable
-
-// Get & reset invite link
-const code = await sock.groupInviteCode("groupid@g.us");
-await sock.groupRevokeInvite("groupid@g.us");
-
-// Join via invite code
-await sock.groupAcceptInvite("INVITECODE");
-
-// Leave a group
-await sock.groupLeave("groupid@g.us");
-
-// Handle join requests
-await sock.groupRequestParticipantsList("groupid@g.us");
-await sock.groupRequestParticipantsUpdate("groupid@g.us", ["628xxx@s.whatsapp.net"], "approve");
-await sock.groupRequestParticipantsUpdate("groupid@g.us", ["628xxx@s.whatsapp.net"], "reject");
+``` text
+addButton()
+addRawButton()
+setRawThumbnail()
+setThumbnail()
+setMedia()
+loadFrom()
+build()
+send()
 ```
 
----
-
-## 🏘️ Community
+------------------------------------------------------------------------
 
-```js
-// Create a community
-const community = await sock.communityCreate("Our Community", "Community description");
+## Carousel
 
-// Link an existing group to a community
-await sock.communityLinkGroup("groupid@g.us", "communityid@g.us");
+Create multiple cards:
 
-// Unlink a group from a community
-await sock.communityUnlinkGroup("groupid@g.us", "communityid@g.us");
+``` js
+await sock
+  .carousel()
+  .body('Choose a product')
+  .footer('Kyyinfinite')
 
-// Fetch all groups linked to a community
-const linked = await sock.communityFetchLinkedGroups("communityid@g.us");
-console.log(linked);
+  .card()
+    .image(image1)
+    .title('Product One')
+    .body('Product description')
+    .button('Pilih', 'product_1')
+    .url('Website', 'https://example.com')
+    .copy('Code', 'KYY-001')
+    .call('Call', '628123456789')
+    .add()
 
-// Deactivate a community
-await sock.communityDeactivate("communityid@g.us");
-```
+  .card()
+    .image(image2)
+    .title('Product Two')
+    .body('Another product')
+    .button('Pilih', 'product_2')
+    .add()
 
----
-
-## 🏢 Business
-
-```js
-// Fetch product catalog
-const { products } = await sock.getCatalog({
-  jid: "628xxx@s.whatsapp.net",
-  limit: 10,
-});
-
-// Create a product
-const product = await sock.productCreate({
-  name: "Premium Package",
-  description: "Full-featured premium plan",
-  price: 150000,
-  currency: "IDR",
-  originCountryCode: "ID",
-  isHidden: false,
-  images: [mediaUpload],
-});
-
-// Update a product
-await sock.productUpdate(productId, {
-  name: "Premium Package Pro",
-  price: 200000,
-});
-
-// Delete products
-await sock.productDelete([productId]);
-
-// Update business profile
-await sock.updateBusinessProfile({
-  address: "Jakarta, Indonesia",
-  websites: ["https://example.com"],
-  email: "hello@example.com",
-  category: "Technology",
-  description: "WhatsApp bot services",
-});
-
-// Fetch business profile
-const profile = await sock.getBusinessProfile("628xxx@s.whatsapp.net");
-console.log(profile);
+  .send(jid)
 ```
 
----
-
-## 👤 Profile
-
-```js
-// Update profile picture
-await sock.updateProfilePicture(jid, {
-  url: "./avatar.jpg",
-});
+Carousel methods:
 
-// Update display name
-await sock.updateProfileName("My New Name");
-
-// Update status/about
-await sock.updateProfileStatus("🤖 Powered by @kyyinfinite/baileys");
-
-// Fetch someone's profile picture
-const ppUrl = await sock.profilePictureUrl("628xxx@s.whatsapp.net", "image");
-console.log(ppUrl);
-
-// Fetch your own profile
-const me = sock.user;
-console.log(me);
+``` text
+card()
+addCard()
+cards()
+clear()
+title()
+subtitle()
+body()
+text()
+footer()
+context()
+payload()
+loadFrom()
+build()
+send()
 ```
 
----
-
-## 💬 Chat
-
-```js
-// Mark messages as read
-await sock.readMessages([msg.key]);
-
-// Star / unstar messages
-await sock.star(jid, [{ id: msgId, fromMe: true }], true);   // star
-await sock.star(jid, [{ id: msgId, fromMe: true }], false);  // unstar
+Card methods:
 
-// Archive / unarchive chat
-await sock.chatModify({ archive: true, lastMessages: [msg] }, jid);
-await sock.chatModify({ archive: false, lastMessages: [msg] }, jid);
-
-// Mute / unmute chat
-await sock.chatModify(
-  { mute: 8 * 60 * 60 * 1000 }, // mute for 8 hours (in ms)
-  jid
-);
-await sock.chatModify({ mute: null }, jid); // unmute
-
-// Pin / unpin chat
-await sock.chatModify({ pin: true }, jid);
-await sock.chatModify({ pin: false }, jid);
-
-// Delete chat
-await sock.chatModify({ delete: true, lastMessages: [msg] }, jid);
-
-// Block / unblock a user
-await sock.updateBlockStatus(jid, "block");
-await sock.updateBlockStatus(jid, "unblock");
+``` text
+title()
+body()
+text()
+footer()
+image()
+video()
+media()
+button()
+reply()
+quickReply()
+url()
+copy()
+coppy()
+call()
+buttons()
+rawButton()
+context()
+payload()
+build()
+add()
+end()
 ```
 
----
-
-## 🔒 Privacy
-
-```js
-// Last seen visibility
-await sock.updateLastSeenPrivacy("all");       // 'all' | 'contacts' | 'nobody'
-
-// Online status visibility
-await sock.updateOnlinePrivacy("all");          // 'all' | 'match_last_seen'
-
-// Profile picture visibility
-await sock.updateProfilePicturePrivacy("contacts"); // 'all' | 'contacts' | 'nobody'
+------------------------------------------------------------------------
 
-// Read receipts (blue ticks)
-await sock.updateReadReceiptsPrivacy("all");    // 'all' | 'none'
+## Rich Messages
 
-// Who can add you to groups
-await sock.updateGroupsAddPrivacy("all");       // 'all' | 'contacts' | 'contact_blacklist'
+The advanced rich-message builder is available through:
 
-// Default disappearing message timer
-await sock.updateDefaultDisappearingMode(86400); // seconds; 0 to disable
+``` js
+await sock
+  .ai()
+  .title('Example')
+  .text('Rich message')
+  .code('console.log("Hello")')
+  .send(jid)
 ```
 
----
-
-## 📡 Events
-
-Listen to all socket events via `sock.ev.on(...)`:
-
-```js
-// Connection state changes (open, close, connecting)
-sock.ev.on("connection.update", ({ connection, lastDisconnect, qr, isNewLogin }) => {});
-
-// Credentials updated — always save
-sock.ev.on("creds.update", (update) => {});
-
-// New / updated messages
-sock.ev.on("messages.upsert", ({ messages, type }) => {});
+The rich builder supports composition features such as:
 
-// Message edits / status updates
-sock.ev.on("messages.update", (updates) => {});
-
-// Messages deleted
-sock.ev.on("messages.delete", (keys) => {});
-
-// Reactions on messages
-sock.ev.on("messages.reaction", (reactions) => {});
-
-// Group metadata updates (subject, description, settings)
-sock.ev.on("groups.update", (updates) => {});
-
-// Participants added/removed/promoted/demoted
-sock.ev.on("group-participants.update", ({ id, participants, action }) => {});
-
-// Join request received in a group
-sock.ev.on("group.join-request", (update) => {});
+``` text
+text
+FOA text
+code
+table
+source
+reels
+image
+video
+product
+post
+metadata
+tip
+HTML
+widget
+footer action
+suggestion
+section
+submessage
+```
 
-// New or updated chats
-sock.ev.on("chats.upsert", (chats) => {});
+It also provides message/node management:
 
-// Chat updates (archive, mute, pin, etc.)
-sock.ev.on("chats.update", (updates) => {});
+``` text
+delete()
+assignId()
+hasId()
+getIds()
+peek()
+loadFrom()
+build()
+buildEdit()
+send()
+sendEdit()
+```
 
-// Chats deleted
-sock.ev.on("chats.delete", (ids) => {});
+------------------------------------------------------------------------
 
-// Contacts synced or updated
-sock.ev.on("contacts.upsert", (contacts) => {});
-sock.ev.on("contacts.update", (contacts) => {});
+## FOAD
 
-// Incoming calls
-sock.ev.on("call", (calls) => {});
+``` js
+await sock
+  .foad()
+  .addTitle('Example')
+  .addHtml('<p>Hello</p>')
+  .addTab(...)
+  .send(jid)
+```
 
-// Newsletter events
-sock.ev.on("newsletter.update", (updates) => {});
-sock.ev.on("newsletter.follow", (jid) => {});
+Available operations include:
 
-// Privacy/settings updates
-sock.ev.on("settings.update", (settings) => {});
+``` text
+setResponseId()
+refreshResponseId()
+setBotResponseId()
+refreshBotResponseId()
+addTitle()
+setPreviewTitle()
+addHtml()
+addTab()
+clearTabs()
+buildResponse()
+build()
+send()
+sendEdit()
+```
 
-// Message history sync (on first connect)
-sock.ev.on("messaging-history.set", ({ chats, contacts, messages, isLatest }) => {});
+------------------------------------------------------------------------
 
-// Blocklist updates
-sock.ev.on("blocklist.update", ({ blocklist, type }) => {});
-```
+### FOAD2
 
----
-
-## 🔧 Utility Exports
-
-All named exports available from `@kyyinfinite/baileys`:
-
-```js
-import {
-  //auth
-  useMultiFileAuthState,
-  makeCacheableSignalKeyStore,
-  initAuthCreds,
-  BufferJSON,
-  fetchLatestBaileysVersion,
-
- //rich message
-  generateTableContent,
-  generateTableContentV2,
-  generateListContent,
-  generateCodeBlockContent,
-  generateCodeBlockContentV2,
-  generateLinkContent,
-  generateLinkContentV2,
-  generateRichMessageContent,
-  generateLatexContent,
-  generateUnifiedResponseContent,
-  captureUnifiedResponse,
-
-  buildRichContextInfo,
-  buildBotForwardedMessage,
-
-  
-  tokenizeCode,
-  tokenizeCodeV2,
-  CodeHighlightType,
-  RichSubMessageType,
-
-  //jid utils
-  jidEncode,
-  jidDecode,
-  jidNormalizedUser,
-  areJidsSameUser,
-  isJidGroup,
-  isJidNewsletter,
-  isLidUser,
-  isPnUser,
-  isJidBot,
-
-  //consecution helper
-  DisconnectReason,
-  Browsers,
-
-
-} from "@kyyinfinite/baileys";
+``` js
+await sock
+  .foad2()
+  ...
 ```
 
----
-
-## 📚 API Reference
-
-### Socket Constructor Options
-
-| Option | Type | Default | Description |
-|---|---|---|---|
-| `auth` | `AuthenticationState` | — | Auth state from `useMultiFileAuthState` |
-| `logger` | `Logger` | pino default | Logger instance (use `pino({ level: "silent" })`) |
-| `browser` | `WABrowserDescription` | — | Browser descriptor e.g. `Browsers.ubuntu("Chrome")` |
-| `version` | `WAVersion` | Latest | WhatsApp Web version tuple |
-| `connectTimeoutMs` | `number` | `20000` | Connection timeout in milliseconds |
-| `defaultQueryTimeoutMs` | `number` | `60000` | Default IQ query timeout |
-| `retryRequestDelayMs` | `number` | `250` | Delay between retries |
-| `maxMsgRetryCount` | `number` | `5` | Max message retry attempts |
-| `syncFullHistory` | `boolean` | `false` | Whether to sync full message history |
-| `enableAutoSessionRecreation` | `boolean` | `true` | Auto recreate session on failure |
-| `generateHighQualityLinkPreview` | `boolean` | `false` | Generate HQ link previews |
-| `qrTimeout` | `number` | `60000` | QR code expiry timeout in ms |
-
----
-
-### Message Methods
-
-| Method | Description | Returns |
-|---|---|---|
-| `sock.sendMessage(jid, content, opts?)` | Send any message type | `Promise<WAProto.WebMessageInfo>` |
-| `sock.sendTable(jid, title, headers, rows, quoted?, opts?)` | Send a styled table | `Promise<void>` |
-| `sock.sendTableV2(jid, title, headers, rows, quoted?, opts?)` | Send a V2 unified table | `Promise<void>` |
-| `sock.sendList(jid, title, rows, quoted?, opts?)` | Send a styled list | `Promise<void>` |
-| `sock.sendCodeBlock(jid, code, quoted?, opts?)` | Send V1 code block | `Promise<void>` |
-| `sock.sendCodeBlockV2(jid, code, quoted?, opts?)` | Send V2 unified code block | `Promise<void>` |
-| `sock.sendLink(jid, text, urls, quoted?, opts?)` | Send inline link message | `Promise<void>` |
-| `sock.sendLinkV2(jid, text, links, quoted?, opts?)` | Send V2 search-style links | `Promise<void>` |
-| `sock.sendUnifiedResponse(jid, text, quoted?, opts?)` | Send unified AI response | `Promise<void>` |
-
----
-
-### Connection Methods
-
-| Method | Description | Returns |
-|---|---|---|
-| `sock.requestPairingCode(phoneNumber, code?)` | Request or set pairing code | `Promise<string>` |
-| `sock.logout()` | Log out and invalidate session | `Promise<void>` |
-| `sock.end(error?)` | Close the socket connection | `void` |
-| `sock.waitForSocketOpen()` | Wait until socket is open | `Promise<void>` |
-| `sock.sendPresenceUpdate(presence, jid?)` | Set online/typing/recording status | `Promise<void>` |
-
----
-
-### Group Methods
-
-| Method | Description | Returns |
-|---|---|---|
-| `sock.groupMetadata(jid)` | Get group info | `Promise<GroupMetadata>` |
-| `sock.groupCreate(subject, participants)` | Create a new group | `Promise<GroupMetadata>` |
-| `sock.groupParticipantsUpdate(jid, participants, action)` | Add/remove/promote/demote | `Promise<ParticipantUpdate[]>` |
-| `sock.groupUpdateSubject(jid, subject)` | Change group name | `Promise<void>` |
-| `sock.groupUpdateDescription(jid, description)` | Change group description | `Promise<void>` |
-| `sock.groupSettingUpdate(jid, setting)` | Update group settings | `Promise<void>` |
-| `sock.groupToggleEphemeral(jid, expiration)` | Toggle disappearing messages | `Promise<void>` |
-| `sock.groupInviteCode(jid)` | Get invite link code | `Promise<string>` |
-| `sock.groupRevokeInvite(jid)` | Reset invite link | `Promise<string>` |
-| `sock.groupAcceptInvite(code)` | Join via invite code | `Promise<string>` |
-| `sock.groupLeave(jid)` | Leave a group | `Promise<void>` |
-
----
-
-### Newsletter Methods
-
-| Method | Description | Returns |
-|---|---|---|
-| `sock.newsletterFollow(jid)` | Follow a newsletter | `Promise<void>` |
-| `sock.newsletterUnfollow(jid)` | Unfollow a newsletter | `Promise<void>` |
-| `sock.newsletterCreate(name, desc)` | Create newsletter | `Promise<NewsletterMetadata>` |
-| `sock.newsletterUpdate(jid, metadata)` | Update newsletter info | `Promise<void>` |
-| `sock.newsletterReactMessage(jid, serverId, emoji)` | React to newsletter message | `Promise<void>` |
-| `sock.newsletterFetchMessages(jid, count, before, after)` | Fetch newsletter messages | `Promise<NewsletterMessage[]>` |
-| `sock.newsletterBulkFollow(jids)` | Follow multiple channels | `Promise<void>` |
-| `sock.newsletterMetadata(jid)` | Fetch channel metadata | `Promise<NewsletterMetadata>` |
-
----
-
-## ❓ FAQ
-
-<details>
-<summary><strong>Why is @kyyinfinite/baileys ESM-only?</strong></summary>
-
-ESM (ECMAScript Modules) is the modern JavaScript standard. It enables tree-shaking, top-level `await`, better static analysis, and aligns with the Node.js ecosystem roadmap. CommonJS support is intentionally dropped to keep the codebase clean and forward-compatible.
-
-If your project is still CommonJS, wrap the import dynamically:
-
-```js
-const { default: makeWASocket } = await import("@kyyinfinite/baileys");
-```
+FOAD2 is exposed as a separate builder for its own response/composition
+workflow.
 
-Or better — migrate your project to ESM by adding `"type": "module"` to `package.json`.
+------------------------------------------------------------------------
 
-</details>
+## createKyyinfinite
 
-<details>
-<summary><strong>How do I reconnect automatically?</strong></summary>
+If you do not want to augment the socket directly:
 
-Listen to `connection.update` and call your `startBot()` function again if the disconnect reason is not `loggedOut`:
+``` js
+const api = createKyyinfinite(sock)
 
-```js
-sock.ev.on("connection.update", ({ connection, lastDisconnect }) => {
-  if (connection === "close") {
-    const code = lastDisconnect?.error?.output?.statusCode;
-    if (code !== DisconnectReason.loggedOut) startBot();
-  }
-});
+await api.text('Hello').send(jid)
 ```
 
-For production, also use PM2 or Docker restart policies.
+This creates a facade without replacing the socket.
 
-</details>
+------------------------------------------------------------------------
 
-<details>
-<summary><strong>How do I use pairing code instead of QR?</strong></summary>
+## attachKyyinfinite
 
-Call `sock.requestPairingCode(phoneNumber)` when the connection status is `"connecting"`.  
-Phone number must include the country code without `+` (e.g. `6281234567890` for Indonesia).
+For direct socket helpers:
 
-See the [Pairing Code Login](#5-pairing-code-login) section for a complete example.
+``` js
+attachKyyinfinite(sock)
 
-</details>
-
-<details>
-<summary><strong>How do I persist authentication between restarts?</strong></summary>
-
-Use `useMultiFileAuthState("./session")` and save on every `creds.update` event:
-
-```js
-const { state, saveCreds } = await useMultiFileAuthState("./session");
-sock.ev.on("creds.update", saveCreds);
+await sock.text('Hello').send(jid)
 ```
 
-For production, implement a custom auth store backed by Redis, MongoDB, or PostgreSQL instead of local files.
+The augmentation is additive. Existing socket methods are not
+intentionally replaced when their names already exist.
 
-</details>
+------------------------------------------------------------------------
 
-<details>
-<summary><strong>How do I deploy to a VPS or cloud?</strong></summary>
+## API Overview
 
-1. Upload your project files (without `node_modules`)
-2. Run `npm install` on the server
-3. Use PM2 to keep the bot alive: `npm install -g pm2 && pm2 start index.js --name my-bot`
-4. Enable PM2 auto-start: `pm2 startup && pm2 save`
+``` text
+Messaging
+├── text()
+├── send()
+├── quoted()
+├── reply()
+├── wrapMessage()
+├── parseMessage()
+└── message actions
 
-> [!TIP]
-> Use `pm2 logs my-bot` to monitor your bot in production.
+Media
+├── media()
+├── image()
+├── video()
+├── audio()
+├── voice()
+├── document()
+├── sticker()
+├── ptv()
+└── gif()
 
-</details>
+JID
+├── jid()
+├── parseJid()
+├── jidUser()
+├── jidServer()
+├── jidDevice()
+├── makeJid()
+├── isGroup()
+├── isPrivate()
+├── isBroadcast()
+├── isStatus()
+├── isNewsletter()
+└── isLid()
 
-<details>
-<summary><strong>How do I handle multiple sessions / multi-device?</strong></summary>
+Interactive
+├── button()
+├── buttonV2()
+└── carousel()
 
-Create a separate auth state directory for each session:
-
-```js
-const session1 = await useMultiFileAuthState("./sessions/bot1");
-const session2 = await useMultiFileAuthState("./sessions/bot2");
+Advanced
+├── ai()
+├── foad()
+└── foad2()
 ```
 
-Then instantiate a separate `makeWASocket` for each session.
-
-</details>
+------------------------------------------------------------------------
 
-<details>
-<summary><strong>Interactive messages are not rendering. What's wrong?</strong></summary>
+## Design Goals
 
-Interactive messages depend on the message type, current WhatsApp client behavior, and server-side availability. Rendering can differ between WhatsApp Web, Android, and iOS. Test the specific interactive structure with the account and client versions you target.
+The API is built around a few principles:
 
-</details>
+-   short syntax for common operations;
+-   chainable builders;
+-   reusable message utilities;
+-   simple JID handling;
+-   flexible media input;
+-   advanced builders remain available;
+-   existing low-level access stays usable;
+-   no duplicate connection layer;
+-   builders keep isolated state.
 
-<details>
-<summary><strong>What is the difference from official Baileys?</strong></summary>
+The main idea is:
 
-| Area | Baileys v7.0.0-rc14 | @kyyinfinite/baileys |
-|---|---|---|
-| Native socket API | ✅ | ✅ Preserved |
-| ESM | ✅ | ✅ |
-| Interactive messages | ✅ Native structures | ✅ Plus fluent builders |
-| Carousel messages | ✅ Native `carouselMessage` structures | ✅ Plus nested carousel builder |
-| Rich responses | ✅ Native rich-response structures | ✅ Plus convenience helpers |
-| Media messages | ✅ | ✅ Plus fluent media builders |
-| Newsletter / Group / Business APIs | ✅ | ✅ Native API preserved |
-| Simple fluent API | — | ✅ `text()`, `image()`, `button()`, `carousel()`, etc. |
-| Raw escape hatch | ✅ Native socket / proto APIs | ✅ `api.raw` + native socket |
-
-</details>
+``` text
+Simple when you need it.
+Advanced when you want it.
+```
 
----
+------------------------------------------------------------------------
 
-> [!TIP]
-> Use `browser: Browsers.ubuntu("Chrome")` for QR login and `Browsers.windows("Chrome")` for pairing code — this can affect compatibility with certain WhatsApp features.
+## TypeScript
 
-> [!IMPORTANT]
-> Always call `sock.ev.on("creds.update", saveCreds)` — missing this will cause your session to expire on every restart.
+Type declarations are included with the package.
 
-> [!WARNING]
-> Do **not** share your `./session` folder publicly. It contains your authentication keys and allows full access to the linked WhatsApp account.
+``` ts
+import { attachKyyinfinite } from '@kyyinfinite/baileys'
+```
 
-> [!NOTE]
-> `@kyyinfinite/baileys` follows the same Signal Protocol as official Baileys. End-to-end encryption is preserved for all messages.
+The Simple API declarations cover the builder and convenience APIs
+exposed by the package.
 
-> [!CAUTION]
-> This library is intended for **educational and personal automation** purposes. Ensure your usage complies with [WhatsApp's Terms of Service](https://www.whatsapp.com/legal/terms-of-service). Mass messaging, spam, or unauthorized data collection may result in permanent account bans.
+------------------------------------------------------------------------
 
----
+## Version
 
-## 📄 License
+Current release:
 
+``` text
+@kyyinfinite/baileys 2.1.0
 ```
-MIT License
-
-Copyright (c) 2026 kyyinfinite
 
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+### What's new in 2.1.0
 
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+``` text
++ Unified send()
++ Quoted/reply helpers
++ KyyMessage
++ Message parser
++ Universal media builder
++ JID parser and utilities
++ JID classifiers
++ makeJid()
++ Automatic mention handling
++ Additional message shortcuts
++ Expanded Simple API declarations
 ```
 
----
+------------------------------------------------------------------------
 
-<div align="center">
+## Roadmap
 
-[![npm](https://img.shields.io/badge/npm-%40kyyinfinite%2Fbaileys-CB3837?style=for-the-badge&logo=npm&logoColor=white)](https://www.npmjs.com/package/@kyyinfinite/baileys)
-[![GitHub](https://img.shields.io/badge/GitHub-kyyinfinite%2Fbaileys-181717?style=for-the-badge&logo=github&logoColor=white)](https://github.com/kyyinfinite/baileys)
-[![Star on GitHub](https://img.shields.io/badge/⭐_Star_this_repo-yellow?style=for-the-badge)](https://github.com/kyyinfinite/baileys/stargazers)
+Planned improvements:
 
-<br/>
+-   Native Baileys API compatibility
+-   More message shortcuts
+-   More media utilities
+-   Additional TypeScript improvements
+-   Expanded integration tests
+-   API documentation expansion
 
-[🐛 Report Bug](https://github.com/kyyinfinite/baileys/issues/new?template=bug_report.md) · [💡 Request Feature](https://github.com/kyyinfinite/baileys/issues/new?template=feature_request.md) · [📦 npm Package](https://www.npmjs.com/package/@kyyinfinite/baileys)
+------------------------------------------------------------------------
 
-<br/>
+## Repository
 
-**© 2026 kyyinfinite — `@kyyinfinite/baileys` v2.0.0 • MIT License**
+urlGitHub Repositoryhttps://github.com/kyyinfinite/baileys
 
-*Built on top of [WhiskeySockets/Baileys](https://github.com/WhiskeySockets/Baileys)*
+## License
 
-</div>
+MIT