@pontalabs/baileys 1.2.5 → 1.2.6

package/README.md

@@ -1,41 +1,60 @@
+<img src="https://capsule-render.vercel.app/api?type=waving&color=0:0f0c29,50:302b63,100:24243e&height=220&section=header&text=Baileys%20PontaLabs&fontSize=52&fontColor=ffffff&animation=fadeIn&fontAlignY=38&desc=⚡%20AI%20Rich%20Messages%20•%20High%20Performance%20•%20Advanced%20Features&descAlignY=58&descSize=16" width="100%"/>
+
 <div align="center">
 
-<!-- Logo Banner -->
-<img src="https://raw.githubusercontent.com/PontaSja/image/408b34d9d8521dd22688a24d6b28db3f8ab1825a/IMG-20260710-WA0070.jpg" alt="PontaSockets Banner" width="720" style="border-radius: 12px;" />
+<!-- Animated Banner with Glow -->
+<a href="https://github.com/PontaSja">
+  <img src="https://raw.githubusercontent.com/PontaSja/image/408b34d9d8521dd22688a24d6b28db3f8ab1825a/IMG-20260710-WA0070.jpg" alt="PontaSockets Banner" width="720" style="border-radius: 18px; box-shadow: 0 0 40px rgba(0,217,255,0.4), 0 0 80px rgba(124,58,237,0.3);" />
+</a>
 
 <br><br>
 
-<!-- Welcome Text -->
-<h2>
-  <img src="https://raw.githubusercontent.com/Tarikul-Islam-Anik/Animated-Fluent-Emojis/master/Emojis/Hand%20gestures/Waving%20Hand.png" alt="Waving Hand" width="35" style="vertical-align: middle; margin-right: 8px;" />
-  Selamat Datang di Baileys PontaLabs
-</h2>
+<!-- Typing Animation -->
+<a href="https://git.io/typing-svg">
+  <img src="https://readme-typing-svg.demolab.com?font=JetBrains+Mono&weight=700&size=24&duration=3000&pause=1000&color=00D9FF&center=true&vCenter=true&width=800&height=50&lines=Extended+from+%40whiskeysockets%2Fbaileys;🚀+Packed+with+Exclusive+Patches+%26+AI+Features;💬+Rich+Messages+%7C+Newsletter+%7C+Groups;⚡+Built+for+Speed%2C+Stability+%26+Scale" alt="Typing Animation" />
+</a>
 
 <br>
 
-<!-- Badges -->
-<a href="https://www.npmjs.com/package/@pontalabs/baileys">
-  <img src="https://img.shields.io/npm/v/@pontalabs/baileys?style=flat-square&amp;color=cb3837&amp;label=npm&amp;logo=npm" alt="NPM Version" />
-</a>
-<a href="https://nodejs.org">
-  <img src="https://img.shields.io/badge/node-%3E%3D18.x-339933?style=flat-square&amp;logo=node.js&amp;logoColor=white" alt="Node.js" />
-</a>
-<a href="./LICENSE">
-  <img src="https://img.shields.io/badge/license-Non--Commercial-orange?style=flat-square" alt="License" />
-</a>
-<a href="https://github.com/WhiskeySockets/Baileys">
-  <img src="https://img.shields.io/badge/fork-whiskeysockets%2Fbaileys-blue?style=flat-square&amp;logo=github" alt="Fork" />
-</a>
-
-<br><br>
+<!-- Animated Badges -->
+<p>
+  <a href="https://www.npmjs.com/package/@pontalabs/baileys">
+    <img src="https://img.shields.io/npm/v/@pontalabs/baileys?style=for-the-badge&color=cb3837&label=npm&logo=npm&logoColor=white" alt="NPM Version" />
+  </a>
+  <a href="https://nodejs.org">
+    <img src="https://img.shields.io/badge/node-%3E%3D18.x-339933?style=for-the-badge&logo=node.js&logoColor=white" alt="Node.js" />
+  </a>
+  <a href="./LICENSE">
+    <img src="https://img.shields.io/badge/license-Non--Commercial-orange?style=for-the-badge" alt="License" />
+  </a>
+  <a href="https://github.com/WhiskeySockets/Baileys">
+    <img src="https://img.shields.io/badge/fork-whiskeysockets%2Fbaileys-6e5494?style=for-the-badge&logo=github" alt="Fork" />
+  </a>
+</p>
+
+<!-- Animated Stats / Divider -->
+<img src="https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/rainbow.png" width="100%" />
 
 <p><em>Extended from <code>@whiskeysockets/baileys</code> — packed with exclusive patches, AI-rich messages, and advanced WhatsApp features.</em></p>
 
+<!-- Visitor + Animated Wave -->
+<img src="https://komarev.com/ghpvc/?username=PontaSja&label=Views&color=00D9FF&style=for-the-badge" alt="Views" />
+<img src="https://img.shields.io/github/stars/PontaSja/baileys?color=FFD700&style=for-the-badge&logo=github" alt="Stars" />
+
+</div>
+
+<br>
+
+<div align="center">
+
+### ⚡ Quick Navigation ⚡
+`Installation` • `Quick Start` • `Rich Messages` • `Newsletter` • `Groups`
+
 </div>
 
 ---
 
-## 📑 Table of Contents
+## <img src="https://raw.githubusercontent.com/Tarikul-Islam-Anik/Animated-Fluent-Emojis/master/Emojis/Objects/Bookmark.png" width="30" /> Table of Contents
 
 - [Why This Fork?](#-why-this-fork)
 - [Features](#-features)
@@ -56,8 +75,20 @@
 
 ---
 
+<div align="center">
+  <img src="https://raw.githubusercontent.com/platane/snk/output/github-contribution-grid-snake-dark.svg" alt="Snake animation" width="100%"/>
+</div>
+
+---
+
 <details>
-<summary><h2>📥 Installation</h2></summary>
+<summary><h2>📥 Installation <img src="https://raw.githubusercontent.com/Tarikul-Islam-Anik/Animated-Fluent-Emojis/master/Emojis/Objects/Inbox%20Tray.png" width="28" /></h2></summary>
+
+<br>
+
+<div align="center">
+  <img src="https://readme-typing-svg.demolab.com?font=Fira+Code&size=18&pause=1000&color=00D9FF&center=true&width=600&lines=npm+install+%40pontalabs%2Fbaileys" alt="install" />
+</div>
 
 ```bash
 # npm
@@ -65,6 +96,12 @@ npm install @pontalabs/baileys
 
 # yarn
 yarn add @pontalabs/baileys
+
+# pnpm
+pnpm add @pontalabs/baileys
+
+# bun
+bun add @pontalabs/baileys
 ```
 
 </details>
@@ -72,7 +109,9 @@ yarn add @pontalabs/baileys
 ---
 
 <details>
-<summary><h2>🚀 Quick Start</h2></summary>
+<summary><h2>🚀 Quick Start <img src="https://raw.githubusercontent.com/Tarikul-Islam-Anik/Animated-Fluent-Emojis/master/Emojis/Travel%20and%20places/Rocket.png" width="28" /></h2></summary>
+
+<br>
 
 ```js
 import makeWASocket, { useMultiFileAuthState } from '@pontalabs/baileys'
@@ -95,13 +134,15 @@ async function start() {
 start()
 ```
 
+> <img src="https://raw.githubusercontent.com/Tarikul-Islam-Anik/Animated-Fluent-Emojis/master/Emojis/Symbols/Bubbles.png" width="20" /> **Tip:** Gunakan `printQRInTerminal: true` untuk scan QR langsung di terminal!
+
 </details>
 
 ---
 
 ## 📖 Documentation
 
-### 🔌 Connecting
+### <img src="https://raw.githubusercontent.com/Tarikul-Islam-Anik/Animated-Fluent-Emojis/master/Emojis/Objects/Electric%20Plug.png" width="25" /> Connecting
 
 <details>
 <summary><b>🔗 QR Code</b></summary>
@@ -257,341 +298,61 @@ await sock.sendMessage(jid, {
 await sock.sendMessage(jid, {
   location: {
     degreesLatitude: 37.422,
-    degreesLongitude: -122.084,
-    name: 'Google HQ'
+    degreesLongitude: -122.084
   }
 })
 ```
 </details>
 
 <details>
-<summary><b>💥 React</b></summary>
-
-```js
-await sock.sendMessage(jid, { react: { text: '👍', key: message.key } })
-// Remove reaction
-await sock.sendMessage(jid, { react: { text: '', key: message.key } })
-```
-</details>
-
-<details>
-<summary><b>📊 Poll</b></summary>
+<summary><b>📄 Document</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
-  poll: {
-    name: 'Favorite color?',
-    values: ['Red', 'Blue', 'Green'],
-    selectableCount: 1
-  }
+  document: fs.readFileSync('file.pdf'),
+  mimetype: 'application/pdf',
+  fileName: 'myfile.pdf'
 })
 ```
 </details>
 
 <details>
-<summary><b>📸 Album</b></summary>
-
-```js
-await sock.sendAlbumMessage(jid, [
-  { image: { url: 'https://example.com/1.jpg' }, caption: 'First' },
-  { video: { url: 'https://example.com/clip.mp4' }, caption: 'Second' }
-], { quoted: message, delay: 3000 })
-```
-</details>
-
-<details>
-<summary><b>👨‍💻 Interactive (Native Flow & Carousel)</b></summary>
+<summary><b>😆 Reaction</b></summary>
 
 ```js
-// Native Flow
-await sock.sendMessage(jid, {
-  text: 'Choose an option:',
-  title: 'Title',
-  footer: '© PontaLabs Baileys',
-  interactive: [{
-    name: 'quick_reply',
-    buttonParamsJson: JSON.stringify({ display_text: 'Quick Reply', id: '123' })
-  }]
-})
-
-// Carousel
 await sock.sendMessage(jid, {
-  text: 'Check out our collection!',
-  title: 'Catalog',
-  footer: '© PontaLabs Baileys',
-  cards: [{
-    image: { url: 'https://example.com/image.jpg' },
-    title: 'Product Name',
-    body: 'Product description',
-    footer: '© PontaLabs',
-    buttons: [{
-      name: 'quick_reply',
-      buttonParamsJson: JSON.stringify({ display_text: 'Select', id: '1' })
-    }]
-  }]
-})
-```
-</details>
-
-<details>
-<summary><b>🔩 Raw / Legacy Buttons</b></summary>
-
-> Varian tombol raw/proto WhatsApp mentah — lebih fleksibel, tapi kamu yang susun strukturnya sendiri.
-
-#### `buttonsMessage`
-
-Kirim objek `buttonsMessage` proto WhatsApp mentah — thumbnail lokasi di dalamnya otomatis diproses kalau berupa Buffer/URL/path.
-
-```js
-await sock.sendMessage(jid, {
-  buttonsMessage: {
-    contentText: 'Pilih salah satu:',
-    footerText: '© PontaCT',
-    buttons: [
-      { buttonId: 'a', buttonText: { displayText: 'Opsi A' }, type: 1 },
-      { buttonId: 'b', buttonText: { displayText: 'Opsi B' }, type: 1 }
-    ]
-  }
-}, { quoted: message })
-```
-
-#### `templateButtons`
-
-```js
-await sock.sendMessage(jid, {
-  text: 'Butuh bantuan?',
-  footer: '© PontaCT',
-  templateButtons: [
-    { index: 1, urlButton: { displayText: 'Kunjungi Website', url: 'https://example.com' } },
-    { index: 2, callButton: { displayText: 'Telepon', phoneNumber: '+6281234567890' } }
-  ]
-}, { quoted: message })
-```
-
-#### `interactiveButtons`
-
-```js
-await sock.sendMessage(jid, {
-  title: 'Menu Utama',
-  subtitle: 'Silakan pilih',
-  text: 'Ada yang bisa dibantu?',
-  footer: '© PontaCT',
-  interactiveButtons: [
-    { name: 'quick_reply', buttonParamsJson: JSON.stringify({ display_text: 'Mulai', id: 'start' }) }
-  ]
-}, { quoted: message })
-```
-
-</details>
-
-<details>
-<summary><b>📌 Pin & Keep</b></summary>
-
-```js
-// Pin — 24h = 86400 · 7d = 604800 · 30d = 2592000
-await sock.sendMessage(jid, { pin: { type: 1, time: 86400, key: message.key } })
-
-// Keep
-await sock.sendMessage(jid, { keep: { key: message.key, type: 1 } })
-```
-</details>
-
----
-
-### 📍 Location + Buttons
-
-> Location message with native list menu (`single_select`) and extra buttons — all in one `buttonsMessage`.
-
-<details>
-<summary><b>Location + List Menu</b></summary>
-
-```js
-await sock.sendMessage(jid, {
-  buttonLocation: {
-    latitude: -6.2088,
-    longitude: 106.8456,
-    name: 'Kantor Pusat PontaCT',
-    address: 'Jl. Sudirman No. 1, Jakarta Pusat',
-    text: 'Temukan kami di sini:',
-    footer: '© PontaCT',
-    thumbnail: 'https://example.com/map-preview.jpg',
-    listButtonText: 'Pilih Layanan',
-    listSectionTitle: 'Layanan Tersedia',
-    listMenu: [
-      { title: 'Customer Service', description: 'Lantai 1, Senin–Jumat 08.00–17.00', id: 'cs' },
-      { title: 'Kasir & Pembayaran', description: 'Lantai 2, buka setiap hari', id: 'kasir' },
-      { title: 'Gudang & Pengiriman', description: 'Gedung B, pintu belakang', id: 'gudang' }
-    ]
-  }
-})
-```
-</details>
-
-<details>
-<summary><b>Location + Extra Buttons</b></summary>
-
-```js
-await sock.sendMessage(jid, {
-  buttonLocation: {
-    latitude: -6.2088,
-    longitude: 106.8456,
-    name: 'Toko PontaCT',
-    address: 'Jl. Kebon Sirih No. 10, Jakarta',
-    text: 'Kunjungi toko kami!',
-    footer: '© PontaCT',
-    thumbnail: 'https://example.com/store.jpg',
-    extraButtons: [
-      { id: 'call', displayText: '📞 Hubungi Kami' },
-      { id: 'whatsapp', displayText: '💬 WhatsApp' },
-      { id: 'maps', displayText: '🗺️ Buka di Maps' }
-    ]
+  react: {
+    text: '🔥',
+    key: message.key
   }
 })
 ```
 </details>
 
 <details>
-<summary><b>Location + List Menu + Extra Buttons</b></summary>
-
-```js
-await sock.sendMessage(jid, {
-  buttonLocation: {
-    latitude: -6.2088,
-    longitude: 106.8456,
-    name: 'Plaza PontaCT',
-    address: 'Jl. MH Thamrin No. 5, Jakarta',
-    text: 'Selamat datang di pusat layanan kami.',
-    footer: 'Buka setiap hari 09.00–21.00',
-    thumbnail: 'https://example.com/plaza.jpg',
-    listButtonText: 'Pilih Tujuan',
-    listSectionTitle: 'Area Tersedia',
-    listMenu: [
-      { title: 'Food Court', description: 'Lt. 1 — lebih dari 30 tenant', id: 'food' },
-      { title: 'Cinema', description: 'Lt. 4 — 8 studio', id: 'cinema' },
-      { title: 'Customer Care', description: 'Lt. 2 — sebelah eskalator', id: 'care' }
-    ],
-    extraButtons: [
-      { id: 'navigate', displayText: '🧭 Navigasi' },
-      { id: 'promo', displayText: '🎁 Promo Hari Ini' }
-    ]
-  }
-})
-```
-</details>
-
-<details>
-<summary><b>📋 Fields Reference</b></summary>
-
-| Field | Type | Required | Default | Description |
-|:---|:---|:---:|:---|:---|
-| `latitude` | `number` | — | `0` | Latitude coordinate |
-| `longitude` | `number` | — | `0` | Longitude coordinate |
-| `name` | `string` | — | `'Location'` | Place name |
-| `address` | `string` | — | `''` | Text address |
-| `text` | `string` | — | `''` | Message body text |
-| `footer` | `string` | — | `''` | Footer text |
-| `thumbnail` | `Buffer / URL / path` | ✅ | — | Map preview image |
-| `listButtonText` | `string` | — | `'Pilih Menu'` | List button label |
-| `listSectionTitle` | `string` | — | `'Pilihan'` | List section title |
-| `listMenu` | `array` | — | — | Menu rows |
-| `extraButtons` | `array` | — | — | Extra buttons |
-
-</details>
-
----
-
-### 📦 Order Status
-
-> Interactive order tracking card using native `order_status` flow button.
-
-<details>
-<summary><b>Basic Order Status</b></summary>
-
-```js
-await sock.sendMessage(jid, {
-  orderStatus: {
-    image: 'https://example.com/order-banner.jpg',
-    title: 'Status Pesanan',
-    text: 'Pesanan kamu sedang diproses oleh penjual.',
-    referenceId: 'ORD-20250629-001',
-    status: 'PROCESSING',
-    currency: 'IDR'
-  }
-})
-```
-</details>
-
-<details>
-<summary><b>Full Order Status with Total & Tax</b></summary>
-
-```js
-await sock.sendMessage(jid, {
-  orderStatus: {
-    image: 'https://example.com/order.jpg',
-    title: 'Update Pesanan #ORD-2025-001',
-    text: 'Pesananmu sedang dalam perjalanan! 🚚',
-    footer: 'Estimasi tiba: 2–3 hari kerja',
-    referenceId: 'ORD-2025-001',
-    status: 'SHIPPED',
-    subtotalValue: 15000000,
-    subtotalOffset: 100,
-    taxValue: 1500000,
-    taxOffset: 100,
-    currency: 'IDR'
-  }
-})
-```
-</details>
-
-<details>
-<summary><b>Local Image File</b></summary>
+<summary><b>📊 Poll</b></summary>
 
 ```js
-const fs = require('fs')
 await sock.sendMessage(jid, {
-  orderStatus: {
-    image: fs.readFileSync('./assets/order-confirm.jpg'),
-    title: 'Pesanan Dikonfirmasi ✅',
-    text: 'Terima kasih telah berbelanja!',
-    referenceId: 'ORD-LOCAL-001',
-    status: 'PROCESSING',
-    currency: 'IDR'
+  poll: {
+    name: 'Favorite Programming Language?',
+    values: ['JavaScript', 'Python', 'Go'],
+    selectableCount: 1
   }
 })
 ```
 </details>
 
-<details>
-<summary><b>📋 Fields Reference</b></summary>
-
-| Field | Type | Required | Default | Description |
-|:---|:---|:---:|:---|:---|
-| `image` | `Buffer / URL / path` | ✅ | — | Header card image |
-| `title` | `string` | — | `'Order Status'` | Header title |
-| `text` | `string` | — | `'Silakan cek status pesanan Anda.'` | Body text |
-| `footer` | `string` | — | `'Powered by PontaCT'` | Footer text |
-| `referenceId` | `string` | — | `'PT-001'` | Order reference ID |
-| `status` | `string` | — | `'PROCESSING'` | Order status |
-| `subtotalValue` | `number` | — | `0` | Subtotal value (in offset units) |
-| `subtotalOffset` | `number` | — | `100` | Value divider |
-| `taxValue` | `number` | — | `0` | Tax value |
-| `taxOffset` | `number` | — | `100` | Tax divider |
-| `currency` | `string` | — | `'IDR'` | Currency code |
-
-> **Status values:** `PROCESSING` · `SHIPPED` · `DELIVERED` · `CANCELLED` · `REFUNDED`
-
-</details>
-
 ---
 
-### 🤖 Rich Messages
+### <img src="https://raw.githubusercontent.com/Tarikul-Islam-Anik/Animated-Fluent-Emojis/master/Emojis/Activities/Sparkles.png" width="25" /> Rich Messages
 
-> Semua fitur **Rich Message** dikirim melalui `sock.sendMessage()` dan dirender sebagai AI bot message di WhatsApp.
+> <img src="https://raw.githubusercontent.com/Tarikul-Islam-Anik/Animated-Fluent-Emojis/master/Emojis/Objects/Light%20Bulb.png" width="20" /> Semua fitur **Rich Message** dikirim melalui `sock.sendMessage()` dan dirender sebagai AI bot message di WhatsApp.
 >
 > **Tidak ada daftar `build.*` terpisah.** Builder, shortcut lama, `items`, `richResponse`, HTML WebView, interactive builder, dan opsi terkait semuanya didokumentasikan di bagian ini supaya API Rich tetap berada di satu tempat.
 
 <details>
-<summary><b>📌 Quick Start — Rich Message</b></summary>
+<summary><b>📌 Quick Start — Rich Message <img src="https://raw.githubusercontent.com/Tarikul-Islam-Anik/Animated-Fluent-Emojis/master/Emojis/Symbols/Double%20Exclamation%20Mark.png" width="20" /></b></summary>
 
 ```js
 await sock.sendMessage(jid, {
@@ -649,16 +410,6 @@ await sock.sendMessage(jid, {
 })
 ```
 
-**Raw item:**
-
-```js
-await sock.sendMessage(jid, {
-  items: [
-    { text: 'Halo! 👋' }
-  ]
-})
-```
-
 </details>
 
 <details>
@@ -710,60 +461,26 @@ await sock.sendMessage(jid, {
 > HTML berjalan di sisi client/webview. Gunakan HTML/JavaScript yang kamu kontrol dan sesuaikan dengan dukungan client WhatsApp yang dituju.
 
 </details>
-<details>
-<summary>👤 richCard — Entity Card</summary>
-
-Membuat Card Entity/Profile langsung melalui `sendMessage()`. Tidak membutuhkan `build` atau `AIRich`.
-
-```js
-await conn.sendMessage(m.chat, {
-    richCard: {
-        thumbnail_url: 'https://example.com/profile.jpg',
-        verification: true,
-        title: 'PontaLabs',
-        subtitle: 'Owner: Ponta',
-        description: 'Ini Ownernya',
-        entity_id: '6283857182374',
-        entity_url: 'https://wa.me/6283857182374',
-        profile_url: 'https://example.com/profile.jpg'
-    }
-});
-```
-
-| Property | Type | Description |
-|---|---|---|
-| `thumbnail_url` | `string` | Thumbnail Card |
-| `verification` | `boolean` | Status verified |
-| `title` | `string` | Judul Entity |
-| `subtitle` | `string` | Subjudul |
-| `description` | `string` | Deskripsi |
-| `entity_id` | `string` | ID Entity |
-| `entity_url` | `string` | URL Entity |
-| `profile_url` | `string` | URL fallback/profile |
-
-</details>
-
 
 <details>
-<summary><b>💻 Rich Code — <code>code</code> / <code>codes</code> / <code>richCode</code></b></summary>
-
-**Single block:**
+<summary><b>👤 Rich Card — <code>richCard</code></b></summary>
 
-```js
-await sock.sendMessage(jid, {
-  code: 'console.log("Hello World")',
-  language: 'javascript'
-}, { quoted: message })
-```
+Entity card / profile preview yang dirender sebagai AI message. Cocok untuk menampilkan kontak, channel, atau brand profile tanpa perlu builder terpisah.
 
-**Multiple blocks:**
+**Direct `sendMessage`:**
 
 ```js
 await sock.sendMessage(jid, {
-  codes: [
-    { code: 'console.log("hello")', language: 'javascript' },
-    { code: 'SELECT * FROM users;', language: 'sql' }
-  ]
+  richCard: {
+    thumbnail_url: 'https://example.com/profile.jpg',
+    verification: true,
+    title: 'PontaLabs',
+    subtitle: 'Official Channel',
+    description: 'WhatsApp Bot Framework by PontaLabs',
+    entity_id: '62123456789',
+    entity_url: 'https://wa.me/62123456789',
+    profile_url: 'https://example.com/profile.jpg'
+  }
 }, { quoted: message })
 ```
 
@@ -772,12 +489,32 @@ await sock.sendMessage(jid, {
 ```js
 await sock.sendMessage(jid, {
   items: [
-    build.richCode('console.log("hello")', 'javascript')
+    build.richCard({
+      thumbnail_url: 'https://example.com/profile.jpg',
+      verification: true,
+      title: 'PontaLabs',
+      subtitle: 'Official Channel',
+      description: 'WhatsApp Bot Framework by PontaLabs',
+      entity_id: '62123456789',
+      entity_url: 'https://wa.me/62123456789',
+      profile_url: 'https://example.com/profile.jpg'
+    })
   ]
 })
 ```
 
-**Supported language aliases:** `javascript`, `js`, `typescript`, `ts`, `python`, `py`, `bash`, `sh`, `zsh`, `go`, `golang`, `rust`, `rs`, `c`, `h`, `cpp`, `c++`, `csharp`, `cs`, `css`, `html`, `powershell`, `ps1`, `cmd`, `bat`, `sql`, `json`.
+| Property | Type | Required | Description |
+|:---|:---|:---:|:---|
+| `thumbnail_url` | `string` | — | URL thumbnail publik untuk card |
+| `verification` | `boolean` | — | Menampilkan badge verified |
+| `title` | `string` | ✅ | Judul utama entity |
+| `subtitle` | `string` | — | Subjudul / role / tagline |
+| `description` | `string` | — | Deskripsi singkat entity |
+| `entity_id` | `string` | ✅ | ID / nomor WhatsApp entity |
+| `entity_url` | `string` | — | URL tujuan saat card diklik |
+| `profile_url` | `string` | — | Fallback URL untuk avatar / profile |
+
+> Gunakan URL thumbnail yang valid dan dapat diakses publik. `entity_id` harus dalam format nomor internasional tanpa `+`.
 
 </details>
 
@@ -979,8 +716,8 @@ await sock.sendMessage(jid, {
 await sock.sendMessage(jid, {
   items: [
     build.richProduct({
-      title: 'Produk A',
-      price_display_string: 'Rp 99.000'
+      title: 'Sepatu A',
+      price_display_string: 'Rp 500.000'
     })
   ]
 })
@@ -1094,7 +831,7 @@ await sock.sendMessage(jid, {
 await sock.sendMessage(jid, {
   items: [
     build.richSource([
-      ['https://example.com/favicon.ico', 'https://example.com', 'Example']
+      ['https://wikipedia.org/favicon.ico', 'https://wikipedia.org/wiki/Node.js', 'Wikipedia']
     ])
   ]
 })
@@ -1173,7 +910,7 @@ await sock.sendMessage(jid, {
         ['Messages', '1.2K']
       ]
     }},
-    build.richCode('SELECT COUNT(*) FROM messages;', 'sql'),
+    build.richText('SELECT COUNT(*) FROM messages;'),
     build.richHtml('<h2>Dashboard</h2>'),
     build.richSuggest('Refresh'),
     build.richFooter('Auto-generated · PontaLabs')
@@ -1187,7 +924,6 @@ await sock.sendMessage(jid, {
 <summary><b>📋 Lihat semua key <code>items</code></b></summary>
 
 - `{ text, inlineEntities? }` — Rich text
-- `{ code, language }` — Code block
 - `{ table }` — Table
 - `{ images }` — Image grid
 - `{ videoUrl, mimeType?, duration? }` — Video
@@ -1237,11 +973,9 @@ await sock.sendMessage(jid, {
         reference_display_name: 'nodejs.org',
         sources: [{
           source_type: 'THIRD_PARTY',
-          source_display_name: 'nodejs.org',
-          source_subtitle: 'nodejs.org',
+          source_display_name: 'Node.js',
           source_url: 'https://nodejs.org'
-        }],
-        __typename: 'GenAISearchCitationItem'
+        }]
       }
     }]
   }]
@@ -1253,12 +987,14 @@ await sock.sendMessage(jid, {
 ```js
 await sock.sendMessage(jid, {
   richResponse: [{
-    table: [
-      { items: ['Version', 'LTS', 'Release'], isHeading: true },
-      { items: ['22.x', 'Yes', '2024'], isHeading: false }
-    ]
+    table: {
+      items: [
+        { items: ['Name', 'Role'], isHeading: true },
+        { items: ['Ponta', 'Admin'] }
+      ]
+    }
   }]
-})
+}, { quoted: message })
 ```
 
 > Berbeda dari `table` top-level / `items`, format table di `richResponse` harus berupa array row siap-pakai.
@@ -1304,17 +1040,22 @@ await sock.sendMessage(jid, {
 
 ```js
 const carousel = build.carousel()
-  .setBody('Pilih produk')
-  .setFooter('PontaLabs')
-  .addCard(card)
+  .addCard(c => c
+    .setTitle('Card 1')
+    .setBody('Deskripsi 1')
+    .addReply('Pilih', 'card1')
+  )
+  .addCard(c => c
+    .setTitle('Card 2')
+    .setBody('Deskripsi 2')
+    .addUrl('Buka', 'https://example.com')
+  )
 
 await sock.sendMessage(jid, {
   items: [carousel]
 })
 ```
 
-> `build.button()`, `build.buttonV2()`, dan `build.carousel()` tidak membutuhkan `sock` saat dibuat. Builder hanya menghasilkan payload.
-
 </details>
 
 <details>
@@ -1348,8 +1089,6 @@ await sock.sendMessage(jid, {
 })
 ```
 
-> `buildDelay` hanya berlaku untuk `items` dan nilainya harus lebih besar dari `0`.
-
 </details>
 
 <details>
@@ -1456,39 +1195,19 @@ const newsletter = await sock.newsletterMetadata('jid', '120363282083849178@news
 </details>
 
 <details>
-<summary><b>👆 Follow / Unfollow / Mute / Unmute</b></summary>
-
-```js
-const nlJid = '120363282083849178@newsletter'
-
-await sock.newsletterFollow(nlJid)
-await sock.newsletterUnfollow(nlJid)
-await sock.newsletterMute(nlJid)
-await sock.newsletterUnmute(nlJid)
-```
-</details>
-
-<details>
-<summary><b>📣 Create Newsletter</b></summary>
+<summary><b>➕ Follow / Unfollow Newsletter</b></summary>
 
 ```js
-const newsletter = await sock.newsletterCreate(
-  'Newsletter Name',
-  'Description here',
-  { url: 'https://example.com/image.jpg' }
-)
+await sock.newsletterFollow('120363282083849178@newsletter')
+await sock.newsletterUnfollow('120363282083849178@newsletter')
 ```
 </details>
 
 <details>
-<summary><b>🌟 React to Newsletter Post</b></summary>
+<summary><b>📨 Newsletter Reaction</b></summary>
 
 ```js
-await sock.newsletterReactMessage(
-  '120363282083849178@newsletter',
-  '12',   // server message ID
-  '🦖'    // emoji
-)
+await sock.newsletterReactMessage('120363282083849178@newsletter', '123', '🔥')
 ```
 </details>
 
@@ -1497,15 +1216,11 @@ await sock.newsletterReactMessage(
 ## 👥 Groups
 
 <details>
-<summary><b>🔄 Create Group</b></summary>
+<summary><b>📝 Create Group</b></summary>
 
 ```js
-const group = await sock.groupCreate('Group Title', [
-  '1234567890@s.whatsapp.net',
-  '0987654321@s.whatsapp.net'
-])
-
-console.log('Group JID:', group.id)
+const group = await sock.groupCreate('My Group', ['1234567890@s.whatsapp.net'])
+console.log('Group ID:', group.id)
 ```
 </details>
 
@@ -1705,6 +1420,14 @@ const summary = getAggregateResponsesInEventMessage(eventMsg, sock.user.lid)
 
 ## 🤝 Contributing
 
+<div align="center">
+
+<img src="https://raw.githubusercontent.com/Tarikul-Islam-Anik/Animated-Fluent-Emojis/master/Emojis/Hand%20gestures/Handshake.png" width="60" />
+
+**Contributions are welcome!**
+
+</div>
+
 1. **Fork** repository
 2. Create a feature branch: `git checkout -b feat/your-feature`
 3. Commit your changes: `git commit -m "feat: add something awesome"`
@@ -1715,6 +1438,10 @@ const summary = getAggregateResponsesInEventMessage(eventMsg, sock.user.lid)
 
 ## 📜 License
 
+<div align="center">
+
+<img src="https://raw.githubusercontent.com/Tarikul-Islam-Anik/Animated-Fluent-Emojis/master/Emojis/Objects/Scroll.png" width="40" />
+
 This project is licensed for **personal and non-commercial use only**.
 
 | | |
@@ -1724,6 +1451,8 @@ This project is licensed for **personal and non-commercial use only**.
 | ❌ | Commercial use strictly prohibited |
 | ❌ | Resale or rebranding prohibited |
 
+</div>
+
 ---
 
 ## ⚠️ Disclaimer
@@ -1735,10 +1464,16 @@ This project is licensed for **personal and non-commercial use only**.
 
 <div align="center">
 
+<img src="https://capsule-render.vercel.app/api?type=waving&color=0:0f0c29,100:302b63&height=150&section=footer&text=PontaLabs&fontSize=30&fontColor=fff&animation=fadeIn" width="100%"/>
+
 [📦 NPM](https://www.npmjs.com/package/@pontalabs/baileys) · [📖 Baileys Wiki](https://github.com/WhiskeySockets/Baileys/wiki) · [⭐ Star this repo](#)
 
 <br>
 
-Made with ♥ by **PontaCT**
+<img src="https://readme-typing-svg.demolab.com?font=Fira+Code&size=14&pause=1000&color=00D9FF&center=true&width=400&lines=Made+with+%E2%99%A5+by+PontaCT;Thanks+for+visiting!" alt="footer typing" />
+
+<br><br>
+
+<img src="https://komarev.com/ghpvc/?username=PontaCT&label=Thanks+for+visiting&color=00D9FF&style=flat-square" />
 
 </div>

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pontalabs/baileys",
   "type": "module",
-  "version": "1.2.5",
+  "version": "1.2.6",
   "description": "PontaLabs Baileys is a lightweight, modern, and customizable WhatsApp Web API library built on Baileys.",
   "keywords": [
     "whatsapp",