@pontalabs/baileys 1.0.6 → 1.0.7

package/README.md

@@ -29,7 +29,7 @@
 
 <br><br>
 
-<p><em>Extended from <code>@whiskeysockets/baileys</code> — dengan lapisan AI rich-message, patch grup/lokasi/order, dan API sendiri yang <strong>bukan</strong> sekadar rename dari fork lain.</em></p>
+<p><em>Extended from <code>@whiskeysockets/baileys</code> — packed with exclusive patches, AI-rich messages, and advanced WhatsApp features.</em></p>
 
 </div>
 
@@ -45,9 +45,7 @@
   - [Connecting](#-connecting)
   - [Events](#-events)
   - [Sending Messages](#-sending-messages)
-  - [Location + Buttons](#-location--buttons)
-  - [Order Status](#-order-status)
-  - [AI Rich Messages](#-ai-rich-messages)
+  - [Rich Messages](#-rich-messages)
   - [Newsletter](#-newsletter)
   - [Groups](#-groups)
   - [Privacy](#-privacy)
@@ -61,32 +59,34 @@
 
 ## ✨ Why This Fork?
 
-Fork ini dibangun di atas Baileys asli, dengan penekanan khusus pada satu hal: **API AI rich-message punya nama field sendiri**, bukan tempelan ulang dari fork lain. Kalau kamu pernah pakai fork "AI-message" lain dan lihat field seperti `richResponse` / `headerText` / `footerText` / `disclaimerText` / `richTip` — di sini semua itu dipetakan ulang jadi nama yang berbeda (`aiBlocks`, `topText`, `bottomText`, `aiNotice`, `tip`, dst), lengkap dengan struktur data yang juga disesuaikan.
+This fork builds on top of the original Baileys library with **targeted, production-ready patches** designed for modern bot development and AI integrations.
 
 | # | Patch | Description |
 |:---:|:---|:---|
-| 01 | 🤖 **AI Blocks (`aiBlocks`)** | Array campuran text/code/table/image/video/product/post/reels/tip/suggest dalam satu pesan |
-| 02 | 💻 **Code Block** | Syntax-highlighted code block via `code` + `language` |
-| 03 | 📊 **Table** | Tabel data via `table` (rows) + `title` |
-| 04 | 🖼️ **Rich Image** | Grid gambar AI via `richImage` |
-| 05 | 🎥 **Rich Video** | Video embed animasi AI via `richVideo` |
-| 06 | 💡 **Suggest** | Follow-up prompt pills via `suggest` |
-| 07 | 🔣 **LaTeX** | Render rumus matematika via `latex` |
-| 08 | 🛍️ **Rich Product** | Kartu produk (single / carousel) via `richProduct` |
-| 09 | 📰 **Rich Post** | Kartu post carousel via `richPost` |
-| 10 | 🎬 **Reels** | Carousel reels via `reels` |
-| 11 | 🔍 **Source** | Daftar sumber pencarian dengan favicon via `source` |
-| 12 | 📌 **Header / Footer / Disclaimer** | `topText`, `bottomText`, `aiNotice` — bukan `headerText`/`footerText`/`disclaimerText` |
-| 13 | 🔀 **Mixed Blocks** | Semua tipe di atas bisa digabung bebas lewat `aiBlocks` |
-| 14 | 🔗 **Inline Citation** | Kutipan inline lewat `links` |
-| 15 | 🐛 **LID Bug Fixes** | Resolusi penuh untuk participant, sender, dan admin LID |
-| 16 | 📦 **makeInMemoryStore Fix** | Session handling dan store behavior lebih stabil |
-| 17 | 📣 **Newsletter Support** | Create, follow, react, dan admin tools untuk channel/newsletter |
-| 18 | 📊 **Logger Buffer Clear** | Mencegah memory buildup dari log buffer |
-| 19 | 🔁 **LID → JID Conversion** | Auto-convert mention/sender/member LID ke JID |
-| 20 | 📍 **Location + Buttons** | Pesan lokasi dengan native list menu (`buttonLocation.sections`) dan extra buttons |
-| 21 | 📢 **Group Status** | `groupStatusMessage` dengan `audienceType`, `backgroundColor`, `textColor`, `font` |
-| 22 | 📦 **Order Status** | Kartu order tracking interaktif via flow native `order_status` |
+| 01 | 🤖 **Rich Text** | AI-styled markdown text via `richText` |
+| 02 | 💻 **Rich Code Block** | Syntax-highlighted code blocks with language support |
+| 03 | 📊 **Rich Table** | Structured data tables with headers and rows |
+| 04 | 🖼️ **Rich Images** | Image grid / carousel for AI-generated visuals |
+| 05 | 🎥 **Rich Video** | Video embeds rendered as AI animated media |
+| 06 | 💡 **Rich Suggestions** | Follow-up prompt pills (like native AI chat) |
+| 07 | 🔣 **Rich LaTeX** | Math formula rendering via `GenAILatexItem` |
+| 08 | 🛍️ **Rich Product** | Product cards with horizontal scroll carousel |
+| 09 | 📰 **Rich Post** | Post cards with author metadata and carousel |
+| 10 | 🎬 **Rich Reels** | Reels carousel with engagement stats |
+| 11 | 🔍 **Rich Sources** | Search result source list with favicons |
+| 12 | 📌 **Rich Tip & Footer** | Metadata blocks for branding and disclaimers |
+| 13 | 🔀 **Rich Mixed** | Combine all rich types freely in `items` arrays |
+| 14 | 🔗 **Rich Response** | Full array mode with inline citations |
+| 15 | 🪪 **Custom Message ID** | All outgoing IDs prefixed with `PONTASOCKETS` |
+| 16 | 🐛 **LID Bug Fixes** | Full resolution for participant, sender, and admin LID issues |
+| 17 | 📦 **makeInMemoryStore Fix** | Stable session handling and store behavior |
+| 18 | 📣 **Newsletter Support** | Full channel/newsletter create, follow, react, and admin tools |
+| 19 | 🤖 **AI Logo Message** | Bot avatar support in message context |
+| 20 | 📊 **Logger Buffer Clear** | Prevents memory buildup from log buffers |
+| 21 | 🔁 **LID → JID Conversion** | Auto-converts LID mentions, sender, and member LIDs to JID |
+| 22 | 📍 **Location + Buttons** | Location messages with native list menu and extra buttons |
+| 23 | 📢 **Group Status** | Styled group status (text/media) with audience control |
+| 24 | 📦 **Order Status** | Interactive order tracking cards with native `order_status` flow |
 
 ---
 
@@ -95,7 +95,7 @@ Fork ini dibangun di atas Baileys asli, dengan penekanan khusus pada satu hal: *
 ```
 ✔  Multi-Device Support          ✔  End-to-End Encryption
 ✔  Real-Time Messaging           ✔  Session Persistence
-✔  AI Rich Messages (aiBlocks)   ✔  Newsletter Management
+✔  Rich AI Bot Messages          ✔  Newsletter Management
 ✔  Group & Channel Management    ✔  Inline Citations & LaTeX
 ✔  Poll, Album, Carousel         ✔  LID → JID Auto-Conversion
 ✔  Product / Post / Reels Cards  ✔  Math Formula Rendering
@@ -168,6 +168,8 @@ const sock = makeWASocket({
 if (!sock.authState.creds.registered) {
   const number = '62xxxx'
   const code = await sock.requestPairingCode(number)
+  // Or custom 8-digit code:
+  const customCode = await sock.requestPairingCode(number, 'PONTASOCKETS')
   console.log(code)
 }
 ```
@@ -227,11 +229,13 @@ await sock.sendMessage(jid, { text: 'Reply!' }, { quoted: message })
 <summary><b>🖼️ Image</b></summary>
 
 ```js
+// From file
 await sock.sendMessage(jid, {
   image: fs.readFileSync('image.jpg'),
   caption: 'Caption here'
 })
 
+// From URL
 await sock.sendMessage(jid, {
   image: { url: 'https://example.com/image.jpg' },
   caption: 'Downloaded image'
@@ -248,6 +252,7 @@ await sock.sendMessage(jid, {
   caption: 'Funny clip!'
 })
 
+// View Once
 await sock.sendMessage(jid, {
   video: fs.readFileSync('secret.mp4'),
   viewOnce: true
@@ -259,8 +264,10 @@ await sock.sendMessage(jid, {
 <summary><b>🎵 Audio / PTT</b></summary>
 
 ```js
+// Regular audio
 await sock.sendMessage(jid, { audio: fs.readFileSync('audio.mp3'), ptt: false })
 
+// Push-to-talk
 await sock.sendMessage(jid, {
   audio: fs.readFileSync('voice.ogg'),
   ptt: true,
@@ -304,7 +311,8 @@ await sock.sendMessage(jid, {
 
 ```js
 await sock.sendMessage(jid, { react: { text: '👍', key: message.key } })
-await sock.sendMessage(jid, { react: { text: '', key: message.key } }) // hapus reaksi
+// Remove reaction
+await sock.sendMessage(jid, { react: { text: '', key: message.key } })
 ```
 </details>
 
@@ -325,15 +333,11 @@ await sock.sendMessage(jid, {
 <details>
 <summary><b>📸 Album</b></summary>
 
-> Minimal 2 media (gabungan gambar/video). Gunakan key `album`, bukan method terpisah.
-
 ```js
-await sock.sendMessage(jid, {
-  album: [
-    { image: { url: 'https://example.com/1.jpg' }, caption: 'First' },
-    { video: { url: 'https://example.com/clip.mp4' }, caption: 'Second' }
-  ]
-}, { quoted: message })
+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>
 
@@ -341,11 +345,12 @@ await sock.sendMessage(jid, {
 <summary><b>👨‍💻 Interactive (Native Flow & Carousel)</b></summary>
 
 ```js
-// Native Flow — key-nya "nativeFlow", bukan "interactive"
+// Native Flow
 await sock.sendMessage(jid, {
   text: 'Choose an option:',
-  footer: '© Pontact Baileys',
-  nativeFlow: [{
+  title: 'Title',
+  footer: '© PONTASOCKETS Baileys',
+  interactive: [{
     name: 'quick_reply',
     buttonParamsJson: JSON.stringify({ display_text: 'Quick Reply', id: '123' })
   }]
@@ -354,13 +359,14 @@ await sock.sendMessage(jid, {
 // Carousel
 await sock.sendMessage(jid, {
   text: 'Check out our collection!',
-  footer: '© Pontact Baileys',
+  title: 'Catalog',
+  footer: '© PONTASOCKETS Baileys',
   cards: [{
     image: { url: 'https://example.com/image.jpg' },
     title: 'Product Name',
-    caption: 'Product description',
-    footer: '© PontaCT',
-    nativeFlow: [{
+    body: 'Product description',
+    footer: '© PONTASOCKETS',
+    buttons: [{
       name: 'quick_reply',
       buttonParamsJson: JSON.stringify({ display_text: 'Select', id: '1' })
     }]
@@ -385,7 +391,7 @@ await sock.sendMessage(jid, { keep: { key: message.key, type: 1 } })
 
 ### 📍 Location + Buttons
 
-> Pesan lokasi dengan list menu native (`single_select`) dan extra buttons — semuanya dalam satu `buttonLocation`. Perhatikan: strukturnya pakai `sections` (bukan `listMenu` flat).
+> Location message with native list menu (`single_select`) and extra buttons — all in one `buttonsMessage`.
 
 <details>
 <summary><b>Location + List Menu</b></summary>
@@ -401,15 +407,11 @@ await sock.sendMessage(jid, {
     footer: '© PontaCT',
     thumbnail: 'https://example.com/map-preview.jpg',
     listButtonText: 'Pilih Layanan',
-    sections: [
-      {
-        title: 'Layanan Tersedia',
-        rows: [
-          { id: 'cs', title: 'Customer Service', description: 'Lantai 1, Senin–Jumat 08.00–17.00' },
-          { id: 'kasir', title: 'Kasir & Pembayaran', description: 'Lantai 2, buka setiap hari' },
-          { id: 'gudang', title: 'Gudang & Pengiriman', description: 'Gedung B, pintu belakang' }
-        ]
-      }
+    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' }
     ]
   }
 })
@@ -439,23 +441,51 @@ await sock.sendMessage(jid, {
 ```
 </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` | ✅ | — | Latitude coordinate |
-| `longitude` | `number` | ✅ | — | Longitude coordinate |
-| `name` | `string` | — | `'Location'` | Nama tempat |
-| `address` | `string` | — | `''` | Alamat teks |
-| `text` | `string` | — | `''` | Isi pesan |
-| `footer` | `string` | — | `''` | Teks footer |
-| `thumbnail` | `Buffer / URL / path` | — | — | Gambar preview peta |
-| `listButtonText` | `string` | — | `'📄 Pilih Menu'` | Label tombol list |
-| `sections` | `array<{title, rows[]}>` | — | — | Section list menu, tiap `row` wajib punya `id` & `title` |
-| `extraButtons` | `array<{id, displayText}>` | — | — | Tombol tambahan |
-
-> Wajib ada minimal 1 `sections` **atau** 1 `extraButtons`.
+| `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>
 
@@ -463,7 +493,7 @@ await sock.sendMessage(jid, {
 
 ### 📦 Order Status
 
-> Kartu order tracking interaktif menggunakan native flow button `order_status`.
+> Interactive order tracking card using native `order_status` flow button.
 
 <details>
 <summary><b>Basic Order Status</b></summary>
@@ -474,7 +504,7 @@ await sock.sendMessage(jid, {
     image: 'https://example.com/order-banner.jpg',
     title: 'Status Pesanan',
     text: 'Pesanan kamu sedang diproses oleh penjual.',
-    referenceId: 'ORD-20260629-001',
+    referenceId: 'ORD-20250629-001',
     status: 'PROCESSING',
     currency: 'IDR'
   }
@@ -489,10 +519,10 @@ await sock.sendMessage(jid, {
 await sock.sendMessage(jid, {
   orderStatus: {
     image: 'https://example.com/order.jpg',
-    title: 'Update Pesanan #ORD-2026-001',
+    title: 'Update Pesanan #ORD-2025-001',
     text: 'Pesananmu sedang dalam perjalanan! 🚚',
     footer: 'Estimasi tiba: 2–3 hari kerja',
-    referenceId: 'ORD-2026-001',
+    referenceId: 'ORD-2025-001',
     status: 'SHIPPED',
     subtotalValue: 15000000,
     subtotalOffset: 100,
@@ -504,22 +534,40 @@ await sock.sendMessage(jid, {
 ```
 </details>
 
+<details>
+<summary><b>Local Image File</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'
+  }
+})
+```
+</details>
+
 <details>
 <summary><b>📋 Fields Reference</b></summary>
 
 | Field | Type | Required | Default | Description |
 |:---|:---|:---:|:---|:---|
-| `image` | `Buffer / URL / path` | ✅ | — | Gambar header kartu |
-| `title` | `string` | — | `'Order Status'` | Judul header |
-| `text` | `string` | — | `'Silakan cek status pesanan Anda.'` | Isi body |
-| `footer` | `string` | — | `'Powered by @pontalabs/baileys'` | Teks footer |
-| `referenceId` | `string` | ✅ | — | ID referensi order |
-| `status` | `string` | — | `'PROCESSING'` | Status order |
-| `subtotalValue` | `number` | — | `0` | Nilai subtotal (dalam satuan offset) |
-| `subtotalOffset` | `number` | — | `100` | Pembagi nilai |
-| `taxValue` | `number` | — | `0` | Nilai pajak |
-| `taxOffset` | `number` | — | `100` | Pembagi pajak |
-| `currency` | `string` | — | `'IDR'` | Kode mata uang |
+| `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`
 
@@ -527,60 +575,75 @@ await sock.sendMessage(jid, {
 
 ---
 
-### 🤖 AI Rich Messages
+### 🤖 Rich Messages
 
-> Semua rich message dikirim lewat `sendMessage` biasa dan dirender sebagai AI bot message di WhatsApp. **Field-nya sengaja berbeda dari fork lain** — bukan `richResponse`/`headerText`/`footerText`/`disclaimerText`, tapi `aiBlocks`/`topText`/`bottomText`/`aiNotice`.
+> All rich messages are sent via standard `sendMessage` and rendered as AI bot messages in WhatsApp. Use the appropriate key instead of `text`, `image`, `video`, etc.
 
-**Quick jump:** [AI Blocks](#-ai-blocks--aiblocks) · [Code](#-code-block) · [Table](#-table) · [Rich Image](#-rich-image) · [Rich Video](#-rich-video) · [Suggest](#-suggest) · [LaTeX](#-latex) · [Rich Product](#-rich-product) · [Rich Post](#-rich-post) · [Reels](#-reels) · [Source](#-source) · [Header / Footer / Disclaimer](#-header--footer--disclaimer) · [Links & Citations](#-links--citations)
+**Quick jump:** [Rich Text](#rich-text) · [Code](#rich-code-block) · [Table](#rich-table) · [Images](#rich-images) · [Video](#rich-video) · [Suggestions](#rich-suggestions) · [LaTeX](#rich-latex) · [Product](#rich-product) · [Post](#rich-post) · [Reels](#rich-reels) · [Sources](#rich-sources) · [Tip & Footer](#rich-tip--footer) · [Mixed](#rich-mixed) · [Response](#rich-response)
 
 ---
 
-#### 🔀 AI Blocks — `aiBlocks`
+#### 📝 Rich Text
+
+> AI bot-styled markdown text rendered in `richResponseMessage`.
 
-> Mode array — campur bebas semua tipe block dalam satu pesan. Ini pengganti pola `items`/`richResponse` di fork lain.
+<details>
+<summary><b>Simple Text</b></summary>
+
+```js
+await sock.sendMessage(jid, { richText: 'Halo! Ini pesan dari bot.' }, { quoted: message })
+```
+</details>
+
+<details>
+<summary><b>Markdown (bold, italic, inline code)</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
-  aiBlocks: [
-    { text: 'Ini teks dari AI dengan *markdown* dan _italic_.' },
-    { code: 'console.log("Hello World")', language: 'javascript' },
-    { table: [['id', 'name', 'score'], ['1', 'Ponta', '98'], ['2', 'Yue', '87']], title: 'Leaderboard' },
-    { suggest: ['Lihat selengkapnya', 'Bagikan', 'Simpan'] }
-  ],
-  topText: 'Judul',
-  bottomText: 'Footer',
-  aiNotice: 'Generated by AI'
+  richText: '*Hasil eksekusi:*\nStatus: `success`\nWaktu: _120ms_'
 }, { quoted: message })
 ```
+</details>
 
-**Valid keys di dalam array `aiBlocks`:**
+<details>
+<summary><b>Multiple Paragraphs (Array)</b></summary>
 
-| Key | Keterangan |
-|:---|:---|
-| `{ text, inlineEntities? }` | Teks (opsional dengan citation) |
-| `{ code, language }` | Code block |
-| `{ table, title?, noHeading? }` | Tabel — `table` = array of rows |
-| `{ richImage }` | Grid gambar |
-| `{ richVideo }` | Video embed |
-| `{ latex }` | Formula matematika |
-| `{ richProduct }` | Kartu produk |
-| `{ richPost }` | Kartu post |
-| `{ reels }` | Carousel reels |
-| `{ source }` | Daftar sumber pencarian |
-| `{ tip }` | Teks metadata kecil |
-| `{ suggest }` | Suggestion pills |
-| `{ gridImage, inlineImage, dynamic, map, contentItems }` | Tipe legacy (masih didukung) |
+```js
+await sock.sendMessage(jid, {
+  richText: ['Baris pertama.', 'Baris kedua.', 'Baris ketiga.']
+}, { quoted: message })
+```
+</details>
 
 ---
 
-#### 💻 Code Block
+#### 💻 Rich Code Block
+
+> Syntax-highlighted code. Use `code` for single block, `codes` for multiple.
+
+<details>
+<summary><b>Single Block</b></summary>
+
+```js
+await sock.sendMessage(jid, {
+  code: 'console.log("Hello World")',
+  language: 'javascript'
+}, { quoted: message })
+```
+</details>
+
+<details>
+<summary><b>Multiple Blocks</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
-  code: 'SELECT * FROM users WHERE id = 1;',
-  language: 'sql'
+  codes: [
+    { code: 'SELECT * FROM users WHERE id = 1;', language: 'sql' },
+    { code: '{ "id": 1, "name": "Ponta", "role": "admin" }', language: 'json' }
+  ]
 }, { quoted: message })
 ```
+</details>
 
 <details>
 <summary><b>Supported Languages</b></summary>
@@ -603,141 +666,373 @@ await sock.sendMessage(jid, {
 
 ---
 
-#### 📊 Table
+#### 📊 Rich Table
+
+> Structured table with `title`, `headers`, and `rows`.
 
-> `table` diisi array of rows (bukan object `{headers, rows}`). Baris pertama otomatis jadi heading kecuali `noHeading: true`.
+<details>
+<summary><b>Simple Table</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
-  title: 'Daftar User',
-  table: [
-    ['Name', 'Role', 'Status'],
-    ['Ponta', 'Admin', 'Active'],
-    ['Yue', 'Member', 'Idle']
-  ]
+  table: {
+    title: 'Daftar User',
+    headers: ['Name', 'Role', 'Status'],
+    rows: [
+      ['Ponta', 'Admin', 'Active'],
+      ['Yue', 'Member', 'Idle'],
+      ['Frieren', 'Guest', 'Offline']
+    ]
+  }
+}, { quoted: message })
+```
+</details>
+
+<details>
+<summary><b>Table without Title</b></summary>
+
+```js
+await sock.sendMessage(jid, {
+  table: {
+    headers: ['Command', 'Description'],
+    rows: [
+      ['.ping', 'Cek latency bot'],
+      ['.info', 'Info bot'],
+      ['.help', 'List semua command']
+    ]
+  }
+}, { quoted: message })
+```
+</details>
+
+<details>
+<summary><b>Data Only (no header)</b></summary>
+
+```js
+await sock.sendMessage(jid, {
+  table: {
+    rows: [
+      ['RAM', '512 MB'],
+      ['CPU', '4 Core'],
+      ['Uptime', '99.9%']
+    ]
+  }
 }, { quoted: message })
 ```
+</details>
 
 ---
 
-#### 🖼️ Rich Image
+#### 🖼️ Rich Images
+
+> AI image grid. Single URL = single image, multiple URLs = carousel.
+
+<details>
+<summary><b>Single Image</b></summary>
 
 ```js
-// Satu gambar
-await sock.sendMessage(jid, { richImage: 'https://example.com/photo.jpg' }, { quoted: message })
+await sock.sendMessage(jid, { richImages: 'https://example.com/photo.jpg' }, { quoted: message })
+```
+</details>
 
-// Beberapa gambar (grid)
+<details>
+<summary><b>Multiple Images (Grid)</b></summary>
+
+```js
 await sock.sendMessage(jid, {
-  richImage: [
+  richImages: [
     'https://example.com/photo1.jpg',
     'https://example.com/photo2.jpg',
     'https://example.com/photo3.jpg'
   ]
 }, { quoted: message })
 ```
+</details>
+
+<details>
+<summary><b>Inside items / richResponse</b></summary>
+
+```js
+// items
+await sock.sendMessage(jid, {
+  items: [
+    { text: 'Hasil foto hari ini:' },
+    { images: ['https://example.com/1.jpg', 'https://example.com/2.jpg'] }
+  ]
+}, { quoted: message })
+
+// richResponse
+await sock.sendMessage(jid, {
+  richResponse: [
+    { text: 'Lihat gambarnya:' },
+    { images: 'https://example.com/banner.jpg' }
+  ]
+}, { quoted: message })
+```
+</details>
 
 ---
 
 #### 🎥 Rich Video
 
-> Format `url|durasiDetik`, bisa string tunggal atau array.
+> Video embed as AI animated media (`GenAIImaginePrimitive` with `imagine_type: ANIMATE`).
+
+<details>
+<summary><b>Shorthand URL</b></summary>
+
+```js
+await sock.sendMessage(jid, { richVideo: 'https://example.com/clip.mp4' }, { quoted: message })
+```
+</details>
+
+<details>
+<summary><b>Full Options</b></summary>
+
+```js
+await sock.sendMessage(jid, {
+  richVideo: {
+    url: 'https://example.com/clip.mp4',
+    mimeType: 'video/mp4',        // default: 'video/mp4'
+    duration: 15,                   // seconds, default: 10
+    fallbackText: 'Preview video' // default: '[ VIDEO - PontaCT ]'
+  }
+}, { quoted: message })
+```
+</details>
+
+<details>
+<summary><b>Inside items / richResponse</b></summary>
 
 ```js
+// items
+await sock.sendMessage(jid, {
+  items: [
+    { text: 'Cek videonya:' },
+    { videoUrl: 'https://example.com/clip.mp4', duration: 20 }
+  ]
+}, { quoted: message })
+
+// richResponse
 await sock.sendMessage(jid, {
-  richVideo: 'https://example.com/clip.mp4|15'
+  richResponse: [
+    { text: 'Tutorial:' },
+    { video: { url: 'https://example.com/tutorial.mp4', duration: 30 } }
+  ]
 }, { quoted: message })
 ```
+</details>
 
 ---
 
-#### 💡 Suggest
+#### 💡 Rich Suggestions
+
+> Follow-up prompt pills — like native AI chat buttons.
+
+<details>
+<summary><b>Shorthand</b></summary>
+
+```js
+await sock.sendMessage(jid, {
+  richSuggestions: ['Coba lagi', 'Lihat detail', 'Batalkan']
+}, { quoted: message })
+```
+</details>
+
+<details>
+<summary><b>Inside items / richResponse</b></summary>
 
 ```js
+// items
 await sock.sendMessage(jid, {
-  suggest: ['Coba lagi', 'Lihat detail', 'Batalkan']
+  items: [
+    { text: 'Mau lanjut ke mana?' },
+    { suggestions: ['Halaman utama', 'Bantuan', 'Hubungi admin'] }
+  ]
+}, { quoted: message })
+
+// richResponse
+await sock.sendMessage(jid, {
+  richResponse: [
+    { text: 'Hasil pencarian ditemukan.' },
+    { suggestions: ['Tampilkan semua', 'Filter ulang', 'Export'] }
+  ]
 }, { quoted: message })
 ```
+</details>
 
 ---
 
-#### 🔣 LaTeX
+#### 🔣 Rich LaTeX
+
+> Math formula rendering as `GenAILatexItem` inline entity. `url` points to a rendered formula image (PNG/JPG from external LaTeX renderer).
 
-> `latex.expressions[].url` di-generate otomatis lewat `latex.codecogs.com` kalau tidak diisi.
+<details>
+<summary><b>Shorthand URL</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
-  latex: {
-    text: 'E = mc²',
-    expressions: [
-      { expression: 'E=mc^2', width: 120, height: 40 }
-    ]
+  richLatex: 'https://latex.codecogs.com/png.latex?E%3Dmc%5E2'
+}, { quoted: message })
+```
+</details>
+
+<details>
+<summary><b>Full Options</b></summary>
+
+```js
+await sock.sendMessage(jid, {
+  richLatex: {
+    url: 'https://latex.codecogs.com/png.latex?E%3Dmc%5E2',
+    text: 'E = mc²',     // label & fallback
+    width: 120,            // default: 100
+    height: 60,            // default: 100
+    font_height: 83.33,    // default: 83.33
+    padding: 15            // default: 15
   }
 }, { quoted: message })
 ```
+</details>
+
+<details>
+<summary><b>Inside items / richResponse</b></summary>
+
+```js
+// items
+await sock.sendMessage(jid, {
+  items: [
+    { text: 'Rumus energi kinetik:' },
+    {
+      latexUrl: 'https://latex.codecogs.com/png.latex?E_k%3D%5Cfrac%7B1%7D%7B2%7Dmv%5E2',
+      latexText: 'Ek = ½mv²',
+      latexWidth: 150,
+      latexHeight: 60
+    }
+  ]
+}, { quoted: message })
+
+// richResponse
+await sock.sendMessage(jid, {
+  richResponse: [
+    { text: 'Solusi integral:' },
+    { latex: { url: 'https://latex.codecogs.com/png.latex?%5Cint%20x%5E2%20dx', text: '∫x² dx = x³/3 + C' } }
+  ]
+}, { quoted: message })
+```
+</details>
 
 ---
 
 #### 🛍️ Rich Product
 
+> Product card(s) as `GenAIProductItemCardPrimitive`. Object = single card, Array = horizontal scroll carousel.
+
+<details>
+<summary><b>Single Product</b></summary>
+
 ```js
-// Single
 await sock.sendMessage(jid, {
   richProduct: {
     title: 'Sepatu Adidas Samba',
-    brand: 'Adidas',
-    price: 'Rp 1.200.000',
-    product_url: 'https://example.com/produk/adidas-samba',
-    image_url: 'https://example.com/adidas.jpg'
+    price_display_string: 'Rp 1.200.000',
+    description: 'Sepatu casual ikonik, tersedia berbagai ukuran.',
+    retailer_id: 'adidas_store',
+    thumbnail: { url: 'https://example.com/adidas.jpg', mime_type: 'image/jpeg', width: 300, height: 300 }
   }
 }, { quoted: message })
+```
+</details>
+
+<details>
+<summary><b>Product Carousel</b></summary>
 
-// Carousel — cukup kirim array
+```js
 await sock.sendMessage(jid, {
   richProduct: [
-    { title: 'Sepatu A', price: 'Rp 500.000', product_url: 'https://example.com/a', image_url: 'https://example.com/a.jpg' },
-    { title: 'Sepatu B', price: 'Rp 750.000', product_url: 'https://example.com/b', image_url: 'https://example.com/b.jpg' }
+    {
+      title: 'Sepatu A',
+      price_display_string: 'Rp 500.000',
+      thumbnail: { url: 'https://example.com/a.jpg', mime_type: 'image/jpeg', width: 300, height: 300 }
+    },
+    {
+      title: 'Sepatu B',
+      price_display_string: 'Rp 750.000',
+      thumbnail: { url: 'https://example.com/b.jpg', mime_type: 'image/jpeg', width: 300, height: 300 }
+    }
   ]
 }, { quoted: message })
 ```
+</details>
 
 <details>
-<summary><b>📋 Fields Reference</b></summary>
+<summary><b>Inside items / richResponse</b></summary>
 
-| Field | Description |
-|:---|:---|
-| `title`, `brand`, `price`, `sale_price` | Info produk |
-| `product_url` (alias `url`) | **Wajib** diawali `http(s)://` |
-| `image_url` (alias `image`) | Gambar utama |
-| `icon_url` (alias `icon`) | Gambar tambahan/ikon |
+```js
+// items
+await sock.sendMessage(jid, {
+  items: [
+    { text: 'Rekomendasi produk hari ini:' },
+    { product: { title: 'Produk X', price_display_string: 'Rp 99.000' } }
+  ]
+}, { quoted: message })
 
+// richResponse
+await sock.sendMessage(jid, {
+  richResponse: [
+    { text: 'Pilih produkmu:' },
+    { product: [{ title: 'A' }, { title: 'B' }] }
+  ]
+}, { quoted: message })
+```
 </details>
 
 ---
 
 #### 📰 Rich Post
 
+> Post card(s) as `GenAIPostPrimitive`. Object = single post, Array = carousel.
+
+<details>
+<summary><b>Single Post</b></summary>
+
 ```js
 await sock.sendMessage(jid, {
   richPost: {
     title: 'Caption post ini',
-    username: '@pontalabs',
-    profile_picture_url: 'https://example.com/avatar.jpg',
-    thumbnail_url: 'https://example.com/post.jpg',
-    likes_count: 120,
-    comments_count: 8,
-    source_app: 'INSTAGRAM'
+    author_display_name: '@pontalabs',
+    author_profile_image: 'https://example.com/avatar.jpg',
+    media_url: 'https://example.com/post.jpg',
+    timestamp: Math.floor(Date.now() / 1000)
   }
 }, { quoted: message })
 ```
+</details>
+
+<details>
+<summary><b>Post Carousel</b></summary>
+
+```js
+await sock.sendMessage(jid, {
+  richPost: [
+    { title: 'Post 1', author_display_name: '@user1', media_url: 'https://example.com/1.jpg' },
+    { title: 'Post 2', author_display_name: '@user2', media_url: 'https://example.com/2.jpg' }
+  ]
+}, { quoted: message })
+```
+</details>
 
 ---
 
-#### 🎬 Reels
+#### 🎬 Rich Reels
+
+> Reels carousel as `GenAIReelPrimitive` with `contentItemsMetadata`. Auto-injects `richResponseSourcesMetadata` with `provider: 'PontaCT'`.
+
+<details>
+<summary><b>Single Reel</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
-  reels: {
-    username: '@creator_name',
+  richReels: {
+    title: '@creator_name',
     profileIconUrl: 'https://example.com/avatar.jpg',
     thumbnailUrl: 'https://example.com/thumb.jpg',
     videoUrl: 'https://example.com/reel.mp4',
@@ -750,72 +1045,330 @@ await sock.sendMessage(jid, {
   }
 }, { quoted: message })
 ```
+</details>
+
+<details>
+<summary><b>Reels Carousel</b></summary>
+
+```js
+await sock.sendMessage(jid, {
+  richReels: [
+    {
+      title: '@creator1',
+      profileIconUrl: 'https://example.com/av1.jpg',
+      thumbnailUrl: 'https://example.com/th1.jpg',
+      videoUrl: 'https://example.com/r1.mp4',
+      likes_count: 5000,
+      reel_source: 'IG'
+    },
+    {
+      title: '@creator2',
+      profileIconUrl: 'https://example.com/av2.jpg',
+      thumbnailUrl: 'https://example.com/th2.jpg',
+      videoUrl: 'https://example.com/r2.mp4',
+      likes_count: 8200,
+      reel_source: 'TT'
+    }
+  ]
+}, { quoted: message })
+```
+</details>
 
 <details>
 <summary><b>📋 Fields Reference</b></summary>
 
-| Field | Default | Description |
-|:---|:---:|:---|
-| `username` (alias `title`) | — | Nama creator |
-| `profileIconUrl` | — | Avatar URL |
-| `thumbnailUrl` | — | Thumbnail cover |
-| `videoUrl` | — | Sumber video |
-| `reels_title` | `''` | Judul reel |
-| `likes_count`, `shares_count`, `view_count` | `0` | Statistik |
-| `reel_source` | `'IG'` | Platform sumber |
-| `is_verified` | `false` | Badge verified |
+| Field | Type | Default | Description |
+|:---|:---|:---:|:---|
+| `title` | `string` | — | Username / creator name |
+| `profileIconUrl` | `string` | — | Avatar URL |
+| `thumbnailUrl` | `string` | — | Thumbnail cover URL |
+| `videoUrl` | `string` | — | Video source URL |
+| `reels_title` | `string` | `''` | Reel title |
+| `likes_count` | `number` | `0` | Like count |
+| `shares_count` | `number` | `0` | Share count |
+| `view_count` | `number` | `0` | View count |
+| `reel_source` | `string` | `'IG'` | Source platform |
+| `is_verified` | `boolean` | `false` | Verified badge |
 
 </details>
 
 ---
 
-#### 🔍 Source
+#### 🔍 Rich Sources
+
+> Search result source list as `GenAISearchResultPrimitive`. Accepts full objects **or** shorthand `[faviconUrl, sourceUrl, displayName]`.
+
+<details>
+<summary><b>Shorthand Array</b></summary>
+
+```js
+await sock.sendMessage(jid, {
+  richSources: [
+    ['https://wikipedia.org/favicon.ico', 'https://wikipedia.org/wiki/Node.js', 'Wikipedia'],
+    ['https://nodejs.org/favicon.ico', 'https://nodejs.org/en/docs', 'Node.js Docs'],
+    ['https://github.com/favicon.ico', 'https://github.com/nodejs/node', 'GitHub']
+  ]
+}, { quoted: message })
+```
+</details>
+
+<details>
+<summary><b>Full Object</b></summary>
+
+```js
+await sock.sendMessage(jid, {
+  richSources: [
+    {
+      source_type: 'THIRD_PARTY',
+      source_display_name: 'Wikipedia',
+      source_subtitle: 'wikipedia.org',
+      source_url: 'https://wikipedia.org/wiki/Node.js',
+      favicon: { url: 'https://wikipedia.org/favicon.ico', mime_type: 'image/jpeg', width: 16, height: 16 }
+    }
+  ]
+}, { quoted: message })
+```
+</details>
+
+<details>
+<summary><b>Mixed Format</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
-  source: [
-    { url: 'https://wikipedia.org/wiki/Node.js', title: 'Node.js', favicon: 'https://wikipedia.org/favicon.ico' },
-    { url: 'https://nodejs.org/en/docs', title: 'Node.js Docs', favicon: 'https://nodejs.org/favicon.ico' }
+  richSources: [
+    ['https://wikipedia.org/fav.ico', 'https://wikipedia.org', 'Wikipedia'],
+    { source_type: 'THIRD_PARTY', source_display_name: 'Docs', source_url: 'https://docs.example.com' }
   ]
 }, { quoted: message })
 ```
+</details>
 
 ---
 
-#### 📌 Header / Footer / Disclaimer
+#### 📌 Rich Tip & Footer
+
+> `richTip` — small metadata text above/center of message.  
+> `richFooter` — metadata text below message (disclaimer / branding).
 
-> `topText` tampil di paling atas, `bottomText` selalu tampil paling bawah (setelah semua media), `aiNotice` tampil sebagai badge disclaimer bawaan WhatsApp — **ini yang membedakan dari fork lain** yang biasanya memakai `headerText` / `footerText` / `disclaimerText`.
+<details>
+<summary><b>Rich Tip</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
-  aiBlocks: [
-    { text: 'Ini teks dari AI dengan *markdown* dan **bold**.' }
-  ],
-  topText: 'Judul',
-  bottomText: 'Footer',
-  aiNotice: 'Generated by AI'
-})
+  richTip: 'Dihasilkan oleh AI · pontalabs v0.3.4'
+}, { quoted: message })
+```
+</details>
+
+<details>
+<summary><b>Rich Footer</b></summary>
+
+```js
+await sock.sendMessage(jid, {
+  richFooter: '© 2025 PontaCT · Data bersumber dari layanan publik'
+}, { quoted: message })
+```
+</details>
+
+<details>
+<summary><b>Inside items / richResponse</b></summary>
+
+```js
+// items
+await sock.sendMessage(jid, {
+  items: [
+    { text: 'Hasil pencarian:' },
+    { sources: [['https://fav.ico', 'https://example.com', 'Example']] },
+    { tip: 'AI-generated content' },
+    { footer: '© PontaCT Baileys' }
+  ]
+}, { quoted: message })
+
+// richResponse
+await sock.sendMessage(jid, {
+  richResponse: [
+    { text: 'Summary di sini.' },
+    { footer: '© PontaCT · pontalabs' }
+  ]
+}, { quoted: message })
+```
+</details>
+
+---
+
+#### 🔀 Rich Mixed — `items`
+
+> Combine all rich types in any order. Array order = display order.
+
+**Valid keys in `items`:**
+
+| Key | Type |
+|:---|:---|
+| `{ text }` | Rich text |
+| `{ code, language }` | Code block |
+| `{ table }` | Table |
+| `{ images }` | Image grid |
+| `{ videoUrl, mimeType?, duration? }` | Video embed |
+| `{ suggestions }` | Suggestion pills |
+| `{ latexUrl, latexText?, latexWidth?, latexHeight? }` | LaTeX formula |
+| `{ product }` | Product card(s) |
+| `{ post }` | Post card(s) |
+| `{ reels }` | Reels carousel |
+| `{ sources }` | Search sources |
+| `{ tip }` | Tip metadata |
+| `{ footer }` | Footer metadata |
+
+<details>
+<summary><b>Text + Code + Table</b></summary>
+
+```js
+await sock.sendMessage(jid, {
+  items: [
+    { text: 'Query yang dijalankan:' },
+    { code: 'SELECT id, name, score FROM users ORDER BY score DESC LIMIT 3', language: 'sql' },
+    { text: 'Hasil:' },
+    {
+      table: {
+        headers: ['id', 'name', 'score'],
+        rows: [
+          ['1', 'Ponta', '98'],
+          ['2', 'Yue', '87'],
+          ['3', 'Frieren', '75']
+        ]
+      }
+    }
+  ]
+}, { quoted: message })
+```
+</details>
+
+<details>
+<summary><b>Text + Images + Video + Suggestions</b></summary>
+
+```js
+await sock.sendMessage(jid, {
+  items: [
+    { text: '*Konten hari ini*' },
+    { images: ['https://example.com/1.jpg', 'https://example.com/2.jpg'] },
+    { videoUrl: 'https://example.com/preview.mp4', duration: 15 },
+    { suggestions: ['Lihat selengkapnya', 'Bagikan', 'Simpan'] }
+  ]
+}, { quoted: message })
+```
+</details>
+
+<details>
+<summary><b>Full Mixed (all types)</b></summary>
+
+```js
+await sock.sendMessage(jid, {
+  items: [
+    { text: '*Laporan Harian Bot*' },
+    { table: { headers: ['Metric', 'Value'], rows: [['Uptime', '99.9%'], ['Messages', '1.2K']] } },
+    { code: 'SELECT COUNT(*) FROM messages WHERE date = CURDATE()', language: 'sql' },
+    { text: 'Formula uptime:' },
+    {
+      latexUrl: 'https://latex.codecogs.com/png.latex?U%3D%5Cfrac%7Bt_u%7D%7Bt_t%7D%5Ctimes100',
+      latexText: 'U = (tu/tt) × 100'
+    },
+    { sources: [['https://example.com/fav.ico', 'https://example.com', 'Dashboard']] },
+    { suggestions: ['Refresh', 'Export PDF'] },
+    { footer: 'Auto-generated · PontaCT' }
+  ]
+}, { quoted: message })
 ```
+</details>
 
 ---
 
-#### 🔗 Links & Citations
+#### 🔗 Rich Response — `richResponse`
 
-> `links` bisa digabung dengan tipe lain di mode flat, dan otomatis diubah jadi teks bernomor + citation.
+> Full array mode supporting all types including inline citations via `inlineEntities`.
+
+**Valid keys in `richResponse`:**
+
+| Key | Type |
+|:---|:---|
+| `{ text, inlineEntities? }` | Text + optional citation/hyperlink |
+| `{ code, language }` | Code block |
+| `{ table, title? }` | Table |
+| `{ images }` | Image grid |
+| `{ video }` | Video embed |
+| `{ suggestions }` | Suggestion pills |
+| `{ latex }` | LaTeX formula |
+| `{ product }` | Product card(s) |
+| `{ post }` | Post card(s) |
+| `{ reels }` | Reels carousel |
+| `{ sources }` | Search sources |
+| `{ tip }` | Tip metadata |
+| `{ footer }` | Footer metadata |
+
+<details>
+<summary><b>Inline Citation</b></summary>
 
 ```js
 await sock.sendMessage(jid, {
-  links: [
+  richResponse: [
     {
-      text: 'Node.js adalah runtime JavaScript',
-      title: 'Node.js Official',
-      url: 'https://nodejs.org',
-      sources: [{ url: 'https://nodejs.org', displayName: 'nodejs.org' }]
+      text: 'Node.js {{SS_0}}¹{{/SS_0}} adalah runtime JavaScript. Dibuat oleh Ryan Dahl {{SS_1}}²{{/SS_1}} pada 2009.',
+      inlineEntities: [
+        {
+          key: 'SS_0',
+          metadata: {
+            reference_id: 1,
+            reference_url: 'https://nodejs.org',
+            reference_title: 'Node.js Official',
+            reference_display_name: 'nodejs.org',
+            sources: [{
+              source_type: 'THIRD_PARTY',
+              source_display_name: 'nodejs.org',
+              source_subtitle: 'nodejs.org',
+              source_url: 'https://nodejs.org'
+            }],
+            __typename: 'GenAISearchCitationItem'
+          }
+        },
+        {
+          key: 'SS_1',
+          metadata: {
+            reference_id: 2,
+            reference_url: 'https://wikipedia.org/wiki/Ryan_Dahl',
+            reference_title: 'Ryan Dahl - Wikipedia',
+            reference_display_name: 'Wikipedia',
+            sources: [{
+              source_type: 'THIRD_PARTY',
+              source_display_name: 'Wikipedia',
+              source_subtitle: 'wikipedia.org',
+              source_url: 'https://wikipedia.org/wiki/Ryan_Dahl'
+            }],
+            __typename: 'GenAISearchCitationItem'
+          }
+        }
+      ]
     }
-  ],
-  bottomText: 'Sumber: nodejs.org'
+  ]
+}, { quoted: message })
+```
+</details>
+
+<details>
+<summary><b>Full Response — all types at once</b></summary>
+
+```js
+await sock.sendMessage(jid, {
+  richResponse: [
+    { text: '*Hasil Pencarian:* Node.js {{SS_0}}¹{{/SS_0}}', inlineEntities: [/* ... */] },
+    { images: ['https://example.com/nodejs.png'] },
+    { text: 'Cara install:' },
+    { code: 'npm install node', language: 'bash' },
+    { table: { headers: ['Version', 'LTS', 'Release'], rows: [['22.x', 'Yes', '2024'], ['21.x', 'No', '2023']] } },
+    { sources: [['https://nodejs.org/fav.ico', 'https://nodejs.org', 'Node.js']] },
+    { suggestions: ['Lihat changelog', 'Download', 'Docs'] },
+    { footer: 'PontaCT · pontalabs' }
+  ]
 }, { quoted: message })
 ```
+</details>
 
 ---
 
@@ -825,8 +1378,11 @@ await sock.sendMessage(jid, {
 <summary><b>📋 Get Newsletter Metadata</b></summary>
 
 ```js
+// By invite code
 const newsletter = await sock.newsletterMetadata('invite', '0029Vaf0HPMLdQeZsp3XRp2T')
-const newsletter2 = await sock.newsletterMetadata('jid', '120363282083849178@newsletter')
+
+// By JID
+const newsletter = await sock.newsletterMetadata('jid', '120363282083849178@newsletter')
 ```
 </details>
 
@@ -859,7 +1415,11 @@ const newsletter = await sock.newsletterCreate(
 <summary><b>🌟 React to Newsletter Post</b></summary>
 
 ```js
-await sock.newsletterReactMessage('120363282083849178@newsletter', '12', '🦖')
+await sock.newsletterReactMessage(
+  '120363282083849178@newsletter',
+  '12',   // server message ID
+  '🦖'    // emoji
+)
 ```
 </details>
 
@@ -886,10 +1446,10 @@ console.log('Group JID:', group.id)
 ```js
 const jid = '123456789@g.us'
 
-await sock.groupSettingUpdate(jid, 'announcement')
-await sock.groupSettingUpdate(jid, 'not_announcement')
-await sock.groupSettingUpdate(jid, 'locked')
-await sock.groupSettingUpdate(jid, 'unlocked')
+await sock.groupSettingUpdate(jid, 'announcement')      // admin-only messages
+await sock.groupSettingUpdate(jid, 'not_announcement')  // all members can send
+await sock.groupSettingUpdate(jid, 'locked')            // admin-only edit info
+await sock.groupSettingUpdate(jid, 'unlocked')          // all members can edit info
 ```
 </details>
 
@@ -913,41 +1473,54 @@ await sock.groupParticipantsUpdate(jid, participants, 'demote')
 const code = await sock.groupInviteCode(jid)
 console.log('Link: https://chat.whatsapp.com/' + code)
 
+// Revoke & generate new link
 const newCode = await sock.groupRevokeInvite(jid)
 ```
 </details>
 
+<details>
+<summary><b>📋 Group Metadata</b></summary>
+
+```js
+const metadata = await sock.groupMetadata(jid)
+console.log('Name:', metadata.subject)
+console.log('Participants:', metadata.participants.length)
+```
+</details>
+
 <details>
 <summary><b>📢 Group Status</b></summary>
 
-> Kirim status grup lewat `groupStatusMessage`. `message` boleh `string` biasa (dianggap `text`) atau object payload `sendMessage` lain (mis. media).
+> Send group status (`groupStatusMessageV2`) with audience control and styling. `message` can be a `string` or a prepared WAMessage object.
 
 ```js
 // Text Status
 await sock.sendMessage(jid, {
-  groupStatusMessage: {
-    message: { text: 'Selamat datang di grup PontaCT! 🎉' },
-    audienceType: 0
+  groupStatus: {
+    message: 'Selamat datang di grup PontaCT! 🎉',
+    audienceType: 0  // 0 = all members
   }
 })
 
 // Styled Text Status
 await sock.sendMessage(jid, {
-  groupStatusMessage: {
-    message: { text: 'Bot aktif kembali! ✅' },
+  groupStatus: {
+    message: 'Bot aktif kembali! ✅',
     audienceType: 0,
-    backgroundColor: '#1A1A2E',
-    textColor: '#FFFFFF',
+    backgroundArgb: 0xFF1A1A2E,
+    textArgb: 0xFFFFFFFF,
     font: 4
   }
 })
 
 // Media Status
+const { imageMessage } = await prepareWAMessageMedia(
+  { image: { url: 'https://example.com/banner.jpg' } },
+  { upload: sock.waUploadToServer }
+)
+
 await sock.sendMessage(jid, {
-  groupStatusMessage: {
-    message: { image: { url: 'https://example.com/banner.jpg' } },
-    audienceType: 0
-  }
+  groupStatus: { message: { imageMessage }, audienceType: 0 }
 })
 ```
 
@@ -956,11 +1529,11 @@ await sock.sendMessage(jid, {
 
 | Field | Type | Required | Default | Description |
 |:---|:---|:---:|:---|:---|
-| `message` | `object` | ✅ | — | Payload pesan (`{ text }`, `{ image }`, dst) |
+| `message` | `string / object` | ✅ | — | Status content (string or WAMessage) |
 | `audienceType` | `number` | — | `0` | Target audience (0 = all) |
-| `backgroundColor` | `string / number` | — | — | Hex (`'#ff6b9d'`) atau integer ARGB — hanya untuk teks |
-| `textColor` | `string / number` | — | — | Hex atau integer ARGB — hanya untuk teks |
-| `font` | `number` | — | — | Gaya font 0–9 — hanya untuk teks |
+| `backgroundArgb` | `number` | — | — | Background ARGB color (text only) |
+| `textArgb` | `number` | — | — | Text ARGB color (text only) |
+| `font` | `number` | — | — | Font style 0–9 (text only) |
 
 </details>
 
@@ -992,12 +1565,12 @@ await sock.updateBlockStatus(jid, 'unblock')
 <summary><b>👁️ Privacy Settings</b></summary>
 
 ```js
-await sock.updateLastSeenPrivacy('all')
-await sock.updateOnlinePrivacy('all')
-await sock.updateProfilePicturePrivacy('all')
-await sock.updateReadReceiptsPrivacy('all')
-await sock.updateGroupsAddPrivacy('all')
-await sock.updateDefaultDisappearingMode(86400)
+await sock.updateLastSeenPrivacy('all')         // 'all' | 'contacts' | 'none'
+await sock.updateOnlinePrivacy('all')           // 'all' | 'match_last_seen'
+await sock.updateProfilePicturePrivacy('all')   // 'all' | 'contacts' | 'none'
+await sock.updateReadReceiptsPrivacy('all')     // 'all' | 'none'
+await sock.updateGroupsAddPrivacy('all')        // 'all' | 'contacts'
+await sock.updateDefaultDisappearingMode(86400) // 0 = disable
 ```
 </details>
 
@@ -1010,7 +1583,7 @@ await sock.updateDefaultDisappearingMode(86400)
 
 ```js
 const sock = makeWASocket({
-  logger: { level: 'debug' },
+  logger: { level: 'debug' }, // 'fatal' | 'error' | 'warn' | 'info' | 'debug' | 'trace'
   auth: state
 })
 ```
@@ -1023,6 +1596,10 @@ const sock = makeWASocket({
 sock.ws.on('CB:presence', (json) => {
   console.log('Presence update:', json)
 })
+
+sock.ws.on('CB:edge_routing', (node) => {
+  console.log('Edge routing:', node)
+})
 ```
 </details>
 
@@ -1030,39 +1607,34 @@ sock.ws.on('CB:presence', (json) => {
 
 ## 📚 API Reference
 
-| Method / Field | Description |
+| Method | Description |
 |:---|:---|
-| `makeWASocket(options)` | Buat koneksi socket WhatsApp baru |
-| `useMultiFileAuthState(path)` | Multi-file auth state manager |
-| `sock.sendMessage(jid, content, opts)` | Kirim pesan tipe apa pun |
-| `content.album` | Kirim album/carousel media (min. 2 item) |
-| `content.aiBlocks` | Kirim rich AI message berbagai tipe (lihat [AI Rich Messages](#-ai-rich-messages)) |
-| `content.topText / bottomText / aiNotice` | Header / footer / disclaimer untuk AI rich message |
-| `content.buttonLocation` | Pesan lokasi + list menu / extra buttons |
-| `content.orderStatus` | Kartu order tracking interaktif |
-| `content.groupStatusMessage` | Kirim status grup dengan styling |
-| `sock.groupCreate(title, participants)` | Buat grup baru |
-| `sock.groupMetadata(jid)` | Ambil metadata grup |
-| `sock.groupSettingUpdate(jid, setting)` | Update pengaturan grup |
-| `sock.groupParticipantsUpdate(jid, participants, action)` | Ubah anggota grup |
-| `sock.groupInviteCode(jid)` | Ambil kode undangan grup |
-| `sock.groupRevokeInvite(jid)` | Cabut & buat ulang undangan |
-| `sock.newsletterMetadata(type, value)` | Ambil info newsletter |
-| `sock.newsletterCreate(name, desc, picture)` | Buat newsletter |
-| `sock.newsletterFollow(jid)` | Follow newsletter |
-| `sock.newsletterUnfollow(jid)` | Unfollow newsletter |
-| `sock.newsletterMute(jid)` | Mute newsletter |
-| `sock.newsletterUnmute(jid)` | Unmute newsletter |
-| `sock.newsletterReactMessage(jid, id, emoji)` | React ke post newsletter |
-| `sock.updateProfilePicture(jid, content)` | Update foto profil |
-| `sock.removeProfilePicture(jid)` | Hapus foto profil |
-| `sock.updateBlockStatus(jid, status)` | Block / unblock user |
-| `sock.updateLastSeenPrivacy(value)` | Atur visibilitas last seen |
-| `sock.updateOnlinePrivacy(value)` | Atur visibilitas status online |
-| `sock.updateProfilePicturePrivacy(value)` | Atur visibilitas foto profil |
-| `sock.updateReadReceiptsPrivacy(value)` | Atur read receipts |
-| `sock.updateGroupsAddPrivacy(value)` | Atur siapa yang bisa menambahkan ke grup |
-| `sock.updateDefaultDisappearingMode(seconds)` | Atur default disappearing messages |
+| `makeWASocket(options)` | Create a new WhatsApp socket connection |
+| `useMultiFileAuthState(path)` | Multi-file authentication state manager |
+| `sock.sendMessage(jid, content, opts)` | Send any message type |
+| `sock.sendAlbumMessage(jid, contents, opts)` | Send album/carousel of media |
+| `sock.groupCreate(title, participants)` | Create a new group |
+| `sock.groupMetadata(jid)` | Fetch group metadata |
+| `sock.groupSettingUpdate(jid, setting)` | Update group settings |
+| `sock.groupParticipantsUpdate(jid, participants, action)` | Modify group members |
+| `sock.groupInviteCode(jid)` | Get group invite code |
+| `sock.groupRevokeInvite(jid)` | Revoke and regenerate invite |
+| `sock.newsletterMetadata(type, value)` | Fetch newsletter info |
+| `sock.newsletterCreate(name, desc, picture)` | Create a newsletter |
+| `sock.newsletterFollow(jid)` | Follow a newsletter |
+| `sock.newsletterUnfollow(jid)` | Unfollow a newsletter |
+| `sock.newsletterMute(jid)` | Mute a newsletter |
+| `sock.newsletterUnmute(jid)` | Unmute a newsletter |
+| `sock.newsletterReactMessage(jid, id, emoji)` | React to a newsletter post |
+| `sock.updateProfilePicture(jid, content)` | Update profile picture |
+| `sock.removeProfilePicture(jid)` | Remove profile picture |
+| `sock.updateBlockStatus(jid, status)` | Block or unblock a user |
+| `sock.updateLastSeenPrivacy(value)` | Control last seen visibility |
+| `sock.updateOnlinePrivacy(value)` | Control online status visibility |
+| `sock.updateProfilePicturePrivacy(value)` | Control profile picture visibility |
+| `sock.updateReadReceiptsPrivacy(value)` | Control read receipts |
+| `sock.updateGroupsAddPrivacy(value)` | Control who can add you to groups |
+| `sock.updateDefaultDisappearingMode(seconds)` | Set default disappearing messages |
 
 ---
 
@@ -1078,31 +1650,31 @@ sock.ws.on('CB:presence', (json) => {
 
 ## 🤝 Contributing
 
-1. **Fork** repository ini
-2. Buat feature branch: `git checkout -b feat/your-feature`
-3. Commit perubahan: `git commit -m "feat: add something awesome"`
-4. Push ke branch kamu: `git push origin feat/your-feature`
-5. Buka **Pull Request**
+1. **Fork** the repository
+2. Create a feature branch: `git checkout -b feat/your-feature`
+3. Commit your changes: `git commit -m "feat: add something awesome"`
+4. Push to your branch: `git push origin feat/your-feature`
+5. Open a **Pull Request**
 
 ---
 
 ## 📜 License
 
-Proyek ini dilisensikan untuk **penggunaan personal dan non-komersial saja**.
+This project is licensed for **personal and non-commercial use only**.
 
 | | |
 |:---:|:---|
-| ✅ | Penggunaan dan modifikasi personal diperbolehkan |
-| ✅ | Redistribusi dengan atribusi diperbolehkan |
-| ❌ | Penggunaan komersial dilarang keras |
-| ❌ | Dijual ulang atau rebranding dilarang |
+| ✅ | Personal use and modification allowed |
+| ✅ | Redistribution with attribution allowed |
+| ❌ | Commercial use strictly prohibited |
+| ❌ | Resale or rebranding prohibited |
 
 ---
 
 ## ⚠️ Disclaimer
 
-> Proyek ini **tidak berafiliasi dengan WhatsApp atau Meta** dengan cara apa pun.
-> Gunakan dengan risiko sendiri dan lihat [Terms of Service](https://www.whatsapp.com/legal/terms-of-service) WhatsApp untuk kepatuhan.
+> This project is **not affiliated with WhatsApp or Meta** in any way.  
+> Use at your own risk and refer to WhatsApp's [Terms of Service](https://www.whatsapp.com/legal/terms-of-service) for compliance.
 
 ---