@nuiisweety/baileys 0.1.10 → 0.1.12

package/README.md

@@ -7,7 +7,7 @@
 *Fork dari [`@whiskeysockets/baileys`](https://github.com/WhiskeySockets/Baileys) v7.0.0-rc11*
 *dikembangkan dengan sepenuh hati oleh **NuiiS4TORU***
 
-[![npm version](https://img.shields.io/badge/npm-0.1.10-pink?style=flat-square&logo=npm)](https://www.npmjs.com/package/@nuiisweety/baileys)
+[![npm version](https://img.shields.io/badge/npm-0.1.12-pink?style=flat-square&logo=npm)](https://www.npmjs.com/package/@nuiisweety/baileys)
 [![license](https://img.shields.io/badge/license-MIT-lavender?style=flat-square)](LICENSE)
 [![based on](https://img.shields.io/badge/based%20on-@whiskeysockets%2Fbaileys-orchid?style=flat-square)](https://github.com/WhiskeySockets/Baileys)
 
@@ -72,6 +72,7 @@
 [Secure Meta Label](#secure-meta-service-label)
 
 🎛️ **Interactive** —
+[Buttons Location Header](#buttons-dengan-location-header-buttonsmessage-langsung) ·
 [Buttons](#buttons) ·
 [List Message](#list-message) ·
 [Template Buttons](#template-buttons) ·
@@ -927,11 +928,85 @@ await sock.sendMessage(jid, {
 
 ---
 
+<details>
+<summary>📍 Buttons dengan Location Header (buttonsMessage langsung)</summary>
+
+Kirim tombol menggunakan `buttonsMessage` secara langsung — berguna untuk header tipe **Location** (`headerType: 6`) yang tidak bisa dibuat lewat shorthand `buttons`.
+
+```js
+// Tombol dengan header lokasi (headerType 6)
+await sock.sendMessage(jid, {
+  buttonsMessage: {
+    locationMessage: {
+      degreesLatitude: 0,
+      degreesLongitude: 0,
+      name: 'NuiiSweety',
+      address: 'NuiiSweety Bot',
+      jpegThumbnail: './src/img/menu.jpg'  // path file, URL, atau Buffer
+    },
+    contentText: 'Pilih menu di bawah ini',
+    footerText: 'Powered by @nuiisweety/baileys',
+    buttons: [
+      { buttonId: 'allmenu', buttonText: { displayText: 'All Menu' }, type: 1 }
+    ],
+    headerType: 6
+  }
+})
+
+// Dengan quoted (reply ke pesan tertentu)
+await sock.sendMessage(jid, {
+  buttonsMessage: {
+    locationMessage: {
+      degreesLatitude: -6.2,
+      degreesLongitude: 106.8,
+      name: 'Menu Bot',
+      address: 'NuiiSweety',
+      jpegThumbnail: './src/img/menu.jpg'
+    },
+    contentText: 'Halo! Ini menu utama bot',
+    footerText: 'NuiiSweety Bot',
+    buttons: [
+      { buttonId: 'menu1', buttonText: { displayText: '🍱 Menu Utama' }, type: 1 },
+      { buttonId: 'help',  buttonText: { displayText: '❓ Bantuan' },    type: 1 }
+    ],
+    headerType: 6
+  }
+}, { quoted: m })
+
+// Header kosong (teks saja, tanpa media/lokasi) — headerType 1
+await sock.sendMessage(jid, {
+  buttonsMessage: {
+    contentText: 'Pilih opsi',
+    footerText: 'Bot Footer',
+    buttons: [
+      { buttonId: 'yes', buttonText: { displayText: 'Ya' },  type: 1 },
+      { buttonId: 'no',  buttonText: { displayText: 'Tidak' }, type: 1 }
+    ],
+    headerType: 1
+  }
+})
+```
+
+> **Catatan `headerType`:**
+> | Nilai | Tipe Header |
+> |-------|-------------|
+> | `1`   | Teks (`contentText`) |
+> | `2`   | Gambar (`imageMessage`) |
+> | `3`   | Video (`videoMessage`) |
+> | `4`   | Dokumen (`documentMessage`) |
+> | `6`   | Lokasi (`locationMessage`) |
+>
+> `jpegThumbnail` pada `locationMessage` bisa berupa **path file lokal**, **URL**, atau **Buffer** — otomatis diproses oleh Baileys.
+
+</details>
+
+---
+
 <details>
 <summary>🎛️ Buttons</summary>
 
 ```js
-// Teks dengan tombol
+// Teks dengan tombol (quick reply)
 await sock.sendMessage(jid, {
   text: 'Pilih salah satu',
   footer: 'Footer pesan',
@@ -953,7 +1028,28 @@ await sock.sendMessage(jid, {
   ]
 })
 
-// Native flow button
+// Native flow button dalam buttons — pakai name + paramsJson
+await sock.sendMessage(jid, {
+  text: 'Pilih menu',
+  buttons: [
+    {
+      name: 'single_select',
+      text: 'Buka Menu',
+      paramsJson: JSON.stringify({
+        title: 'Buka Menu',
+        sections: [{
+          title: 'Kategori A',
+          rows: [
+            { id: 'row1', title: 'Item 1', description: 'Deskripsi' },
+            { id: 'row2', title: 'Item 2' }
+          ]
+        }]
+      })
+    }
+  ]
+})
+
+// Shorthand: sections langsung di button (otomatis jadi single_select)
 await sock.sendMessage(jid, {
   text: 'Pilih menu',
   buttons: [{
@@ -969,6 +1065,8 @@ await sock.sendMessage(jid, {
 })
 ```
 
+> **Field tombol:** gunakan `text` atau `buttonText` untuk label. Untuk quick reply gunakan `id`/`buttonId`. Untuk native flow gunakan `name` + `paramsJson`.
+
 </details>
 
 ---
@@ -978,10 +1076,10 @@ await sock.sendMessage(jid, {
 
 ```js
 await sock.sendMessage(jid, {
-  text: 'Silakan pilih',
-  title: 'Judul List',
-  buttonText: 'Buka Daftar',
-  footer: 'Footer pesan',
+  text: 'Silakan pilih',       // → description (isi pesan)
+  title: 'Judul List',         // → title (judul di atas list)
+  buttonText: 'Buka Daftar',   // → teks tombol pembuka
+  footer: 'Footer pesan',      // → footerText
   sections: [
     {
       title: 'Bagian 1',
@@ -1000,6 +1098,8 @@ await sock.sendMessage(jid, {
 })
 ```
 
+> **Trigger key:** `sections` (bukan `listMessage`). `listType` otomatis di-set ke `SINGLE_SELECT`. Field `text` di-map ke `description` (isi pesan), bukan judul — gunakan `title` untuk judul list.
+
 </details>
 
 ---
@@ -1010,9 +1110,9 @@ await sock.sendMessage(jid, {
 ```js
 // Teks
 await sock.sendMessage(jid, {
-  text: 'Pesan template',
-  footer: 'Footer',
-  id: 'template-unik',
+  text: 'Pesan template',       // → hydratedContentText
+  footer: 'Footer',             // → hydratedFooterText
+  id: 'template-unik',          // → templateId (opsional, auto-generate jika tidak diisi)
   templateButtons: [
     { id: 'btn1', text: 'Quick Reply' },
     { url: 'https://example.com', text: 'Kunjungi Website' },
@@ -1023,8 +1123,8 @@ await sock.sendMessage(jid, {
 // Gambar sebagai header
 await sock.sendMessage(jid, {
   image: { url: 'https://example.com/img.jpg' },
-  caption: 'Isi pesan',
-  title: 'Judul',
+  caption: 'Isi pesan',         // → hydratedContentText
+  title: 'Judul',               // → hydratedTitleText (hanya aktif jika ada caption)
   footer: 'Footer',
   templateButtons: [
     { id: 'btn1', text: 'Klik Sini' },
@@ -1033,6 +1133,8 @@ await sock.sendMessage(jid, {
 })
 ```
 
+> **Tipe tombol:** `{ id, text }` → quick reply · `{ url, text }` → URL button · `{ call, text }` → call button. `text` atau `buttonText` keduanya diterima. Jika `id` tidak diisi, otomatis `template-<timestamp>`.
+
 </details>
 
 ---
@@ -1041,34 +1143,108 @@ await sock.sendMessage(jid, {
 <summary>🌊 Native Flow</summary>
 
 ```js
-// Teks dengan native flow buttons
+// Quick reply
 await sock.sendMessage(jid, {
   text: 'Pilih aksi',
   footer: 'Footer pesan',
   nativeFlow: [
-    { name: 'quick_reply', paramsJson: '{"id":"1"}', text: 'Opsi 1' },
-    { name: 'quick_reply', paramsJson: '{"id":"2"}', text: 'Opsi 2' }
+    { id: '1', text: 'Opsi 1' },   // id → quick_reply
+    { id: '2', text: 'Opsi 2' }
   ]
 })
 
-// Gambar sebagai header
+// URL button
+await sock.sendMessage(jid, {
+  text: 'Kunjungi kami',
+  nativeFlow: [
+    { url: 'https://example.com', text: 'Buka Website' }
+  ]
+})
+
+// Copy code button
+await sock.sendMessage(jid, {
+  text: 'Kode promo kamu',
+  nativeFlow: [
+    { copy: 'PROMO2025', text: 'Salin Kode' }
+  ]
+})
+
+// Call button
+await sock.sendMessage(jid, {
+  text: 'Hubungi kami',
+  nativeFlow: [
+    { call: '+62812345678', text: 'Telepon Sekarang' }
+  ]
+})
+
+// Single select (list dalam button)
+await sock.sendMessage(jid, {
+  text: 'Pilih menu',
+  nativeFlow: [
+    {
+      sections: [{
+        title: 'Kategori A',
+        rows: [
+          { id: 'row1', title: 'Item 1', description: 'Deskripsi' },
+          { id: 'row2', title: 'Item 2' }
+        ]
+      }],
+      text: 'Buka Daftar'
+    }
+  ]
+})
+
+// Dengan icon pada tombol
+await sock.sendMessage(jid, {
+  text: 'Pilih aksi',
+  nativeFlow: [
+    { id: '1', text: 'Konfirmasi', icon: 'CHECK' },
+    { url: 'https://example.com', text: 'Buka', icon: 'LINK' }
+  ]
+})
+
+// Gambar sebagai header — WAJIB pakai image/video/document/location/product
+// jika tidak ada media valid → throw Error: Invalid media type
 await sock.sendMessage(jid, {
   image: { url: 'https://example.com/img.jpg' },
-  caption: 'Isi pesan',
-  title: 'Judul',
-  subtitle: 'Subjudul',
+  caption: 'Isi pesan',     // → body.text
+  title: 'Judul',           // → header.title
+  subtitle: 'Subjudul',     // → header.subtitle
   footer: 'Footer',
   nativeFlow: [
-    { name: 'quick_reply', paramsJson: '{"id":"1"}', text: 'Tombol 1' }
+    { id: '1', text: 'Tombol 1' }
   ]
 })
 
-// Dengan audio footer
+// Dengan audio footer (menggantikan footer teks)
 await sock.sendMessage(jid, {
   text: 'Pesan dengan audio footer',
   audioFooter: fs.readFileSync('audio.ogg'),
   nativeFlow: [
-    { name: 'quick_reply', paramsJson: '{"id":"1"}', text: 'OK' }
+    { id: '1', text: 'OK' }
+  ]
+})
+
+// offerText — tampil sebagai limited time offer banner
+await sock.sendMessage(jid, {
+  text: 'Penawaran terbatas!',
+  offerText: 'Diskon 50%',
+  offerUrl: 'https://example.com/promo',
+  offerCode: 'DISKON50',
+  offerExpiration: 1800000000,
+  nativeFlow: [
+    { id: 'claim', text: 'Klaim Sekarang' }
+  ]
+})
+
+// optionText — tombol-tombol masuk ke bottom sheet
+await sock.sendMessage(jid, {
+  text: 'Pilih opsi',
+  optionText: 'Lihat Semua Opsi',
+  optionTitle: 'Daftar Pilihan',
+  nativeFlow: [
+    { id: '1', text: 'Opsi A' },
+    { id: '2', text: 'Opsi B' }
   ]
 })
 
@@ -1076,13 +1252,15 @@ await sock.sendMessage(jid, {
 await sock.sendMessage(jid, {
   text: 'Template interaktif',
   nativeFlow: [
-    { name: 'quick_reply', paramsJson: '{"id":"1"}', text: 'Tombol' }
+    { id: '1', text: 'Tombol' }
   ],
   interactiveAsTemplate: true,
   id: 'template-id-unik'
 })
 ```
 
+> **Tipe tombol ditentukan otomatis** dari field yang ada: `id` → quick_reply · `url` → cta_url · `copy` → cta_copy · `call` → cta_call · `sections` → single_select. Bisa juga pakai `name` + `paramsJson` langsung untuk kontrol penuh. `text` atau `buttonText` keduanya diterima. Field `icon` opsional (string uppercase, e.g. `'CHECK'`, `'LINK'`).
+
 </details>
 
 ---
@@ -1148,16 +1326,46 @@ await sock.sendMessage(['628xxx@s.whatsapp.net'], {
 
 > Rich message menggunakan format `AIRichResponseMessage` yang tampil seperti respons AI di WhatsApp. Semua tipe di bawah bisa dipakai secara flat (field langsung) atau dikombinasikan via `richResponse: [...]`.
 
+> ⚠️ **Penting:** `contentText`, `headerText`, `footerText`, dan `disclaimerText` **bukan** trigger key — artinya jika hanya field itu yang dikirim, pesan **tidak akan** diproses sebagai rich message dan akan menghasilkan **Error: Invalid media type**. Gunakan selalu minimal satu trigger key (`code`, `table`, `richImage`, `richVideo`, `richResponse`, dll), lalu kombinasikan dengan field teks di atas sebagai pelengkap.
+
 ### ✍️ addText
 
 Kirim teks markdown sebagai AI Rich Response. Mendukung hyperlink, citation, dan LaTeX inline.
 
+Karena `contentText` bukan trigger key, gunakan `richResponse: [{ text }]` untuk pesan teks murni:
+
+```js
+// ✅ Cara benar — pakai richResponse array
+await sock.sendMessage(jid, {
+  richResponse: [
+    { text: 'Ini teks dari AI dengan *markdown* dan **bold**.' }
+  ],
+  headerText: 'Judul',
+  footerText: 'Footer',
+  disclaimerText: 'Generated by AI'
+})
+```
+
+```js
+// ✅ Alternatif — contentText sebagai pelengkap dari trigger key lain
+await sock.sendMessage(jid, {
+  code: 'console.log("Hello")',
+  language: 'javascript',
+  contentText: 'Penjelasan tambahan di sini.',
+  headerText: 'Judul',
+  footerText: 'Footer',
+  disclaimerText: 'Generated by AI'
+})
+```
+
 ```js
+// ❌ SALAH — contentText saja tidak akan trigger rich message
 await sock.sendMessage(jid, {
-  contentText: 'Ini teks dari AI dengan *markdown* dan **bold**.',
+  contentText: 'halooo',
   headerText: 'Judul',
   footerText: 'Footer',
   disclaimerText: 'Generated by AI'
+  // → Error: Invalid media type
 })
 ```
 

package/README.md.bak

@@ -72,6 +72,7 @@
 [Secure Meta Label](#secure-meta-service-label)
 
 🎛️ **Interactive** —
+[Buttons Location Header](#buttons-dengan-location-header-buttonsmessage-langsung) ·
 [Buttons](#buttons) ·
 [List Message](#list-message) ·
 [Template Buttons](#template-buttons) ·
@@ -927,11 +928,85 @@ await sock.sendMessage(jid, {
 
 ---
 
+<details>
+<summary>📍 Buttons dengan Location Header (buttonsMessage langsung)</summary>
+
+Kirim tombol menggunakan `buttonsMessage` secara langsung — berguna untuk header tipe **Location** (`headerType: 6`) yang tidak bisa dibuat lewat shorthand `buttons`.
+
+```js
+// Tombol dengan header lokasi (headerType 6)
+await sock.sendMessage(jid, {
+  buttonsMessage: {
+    locationMessage: {
+      degreesLatitude: 0,
+      degreesLongitude: 0,
+      name: 'NuiiSweety',
+      address: 'NuiiSweety Bot',
+      jpegThumbnail: './src/img/menu.jpg'  // path file, URL, atau Buffer
+    },
+    contentText: 'Pilih menu di bawah ini',
+    footerText: 'Powered by @nuiisweety/baileys',
+    buttons: [
+      { buttonId: 'allmenu', buttonText: { displayText: 'All Menu' }, type: 1 }
+    ],
+    headerType: 6
+  }
+})
+
+// Dengan quoted (reply ke pesan tertentu)
+await sock.sendMessage(jid, {
+  buttonsMessage: {
+    locationMessage: {
+      degreesLatitude: -6.2,
+      degreesLongitude: 106.8,
+      name: 'Menu Bot',
+      address: 'NuiiSweety',
+      jpegThumbnail: './src/img/menu.jpg'
+    },
+    contentText: 'Halo! Ini menu utama bot',
+    footerText: 'NuiiSweety Bot',
+    buttons: [
+      { buttonId: 'menu1', buttonText: { displayText: '🍱 Menu Utama' }, type: 1 },
+      { buttonId: 'help',  buttonText: { displayText: '❓ Bantuan' },    type: 1 }
+    ],
+    headerType: 6
+  }
+}, { quoted: m })
+
+// Header kosong (teks saja, tanpa media/lokasi) — headerType 1
+await sock.sendMessage(jid, {
+  buttonsMessage: {
+    contentText: 'Pilih opsi',
+    footerText: 'Bot Footer',
+    buttons: [
+      { buttonId: 'yes', buttonText: { displayText: 'Ya' },  type: 1 },
+      { buttonId: 'no',  buttonText: { displayText: 'Tidak' }, type: 1 }
+    ],
+    headerType: 1
+  }
+})
+```
+
+> **Catatan `headerType`:**
+> | Nilai | Tipe Header |
+> |-------|-------------|
+> | `1`   | Teks (`contentText`) |
+> | `2`   | Gambar (`imageMessage`) |
+> | `3`   | Video (`videoMessage`) |
+> | `4`   | Dokumen (`documentMessage`) |
+> | `6`   | Lokasi (`locationMessage`) |
+>
+> `jpegThumbnail` pada `locationMessage` bisa berupa **path file lokal**, **URL**, atau **Buffer** — otomatis diproses oleh Baileys.
+
+</details>
+
+---
+
 <details>
 <summary>🎛️ Buttons</summary>
 
 ```js
-// Teks dengan tombol
+// Teks dengan tombol (quick reply)
 await sock.sendMessage(jid, {
   text: 'Pilih salah satu',
   footer: 'Footer pesan',
@@ -953,7 +1028,28 @@ await sock.sendMessage(jid, {
   ]
 })
 
-// Native flow button
+// Native flow button dalam buttons — pakai name + paramsJson
+await sock.sendMessage(jid, {
+  text: 'Pilih menu',
+  buttons: [
+    {
+      name: 'single_select',
+      text: 'Buka Menu',
+      paramsJson: JSON.stringify({
+        title: 'Buka Menu',
+        sections: [{
+          title: 'Kategori A',
+          rows: [
+            { id: 'row1', title: 'Item 1', description: 'Deskripsi' },
+            { id: 'row2', title: 'Item 2' }
+          ]
+        }]
+      })
+    }
+  ]
+})
+
+// Shorthand: sections langsung di button (otomatis jadi single_select)
 await sock.sendMessage(jid, {
   text: 'Pilih menu',
   buttons: [{
@@ -969,6 +1065,8 @@ await sock.sendMessage(jid, {
 })
 ```
 
+> **Field tombol:** gunakan `text` atau `buttonText` untuk label. Untuk quick reply gunakan `id`/`buttonId`. Untuk native flow gunakan `name` + `paramsJson`.
+
 </details>
 
 ---
@@ -978,10 +1076,10 @@ await sock.sendMessage(jid, {
 
 ```js
 await sock.sendMessage(jid, {
-  text: 'Silakan pilih',
-  title: 'Judul List',
-  buttonText: 'Buka Daftar',
-  footer: 'Footer pesan',
+  text: 'Silakan pilih',       // → description (isi pesan)
+  title: 'Judul List',         // → title (judul di atas list)
+  buttonText: 'Buka Daftar',   // → teks tombol pembuka
+  footer: 'Footer pesan',      // → footerText
   sections: [
     {
       title: 'Bagian 1',
@@ -1000,6 +1098,8 @@ await sock.sendMessage(jid, {
 })
 ```
 
+> **Trigger key:** `sections` (bukan `listMessage`). `listType` otomatis di-set ke `SINGLE_SELECT`. Field `text` di-map ke `description` (isi pesan), bukan judul — gunakan `title` untuk judul list.
+
 </details>
 
 ---
@@ -1010,9 +1110,9 @@ await sock.sendMessage(jid, {
 ```js
 // Teks
 await sock.sendMessage(jid, {
-  text: 'Pesan template',
-  footer: 'Footer',
-  id: 'template-unik',
+  text: 'Pesan template',       // → hydratedContentText
+  footer: 'Footer',             // → hydratedFooterText
+  id: 'template-unik',          // → templateId (opsional, auto-generate jika tidak diisi)
   templateButtons: [
     { id: 'btn1', text: 'Quick Reply' },
     { url: 'https://example.com', text: 'Kunjungi Website' },
@@ -1023,8 +1123,8 @@ await sock.sendMessage(jid, {
 // Gambar sebagai header
 await sock.sendMessage(jid, {
   image: { url: 'https://example.com/img.jpg' },
-  caption: 'Isi pesan',
-  title: 'Judul',
+  caption: 'Isi pesan',         // → hydratedContentText
+  title: 'Judul',               // → hydratedTitleText (hanya aktif jika ada caption)
   footer: 'Footer',
   templateButtons: [
     { id: 'btn1', text: 'Klik Sini' },
@@ -1033,6 +1133,8 @@ await sock.sendMessage(jid, {
 })
 ```
 
+> **Tipe tombol:** `{ id, text }` → quick reply · `{ url, text }` → URL button · `{ call, text }` → call button. `text` atau `buttonText` keduanya diterima. Jika `id` tidak diisi, otomatis `template-<timestamp>`.
+
 </details>
 
 ---
@@ -1041,34 +1143,108 @@ await sock.sendMessage(jid, {
 <summary>🌊 Native Flow</summary>
 
 ```js
-// Teks dengan native flow buttons
+// Quick reply
 await sock.sendMessage(jid, {
   text: 'Pilih aksi',
   footer: 'Footer pesan',
   nativeFlow: [
-    { name: 'quick_reply', paramsJson: '{"id":"1"}', text: 'Opsi 1' },
-    { name: 'quick_reply', paramsJson: '{"id":"2"}', text: 'Opsi 2' }
+    { id: '1', text: 'Opsi 1' },   // id → quick_reply
+    { id: '2', text: 'Opsi 2' }
   ]
 })
 
-// Gambar sebagai header
+// URL button
+await sock.sendMessage(jid, {
+  text: 'Kunjungi kami',
+  nativeFlow: [
+    { url: 'https://example.com', text: 'Buka Website' }
+  ]
+})
+
+// Copy code button
+await sock.sendMessage(jid, {
+  text: 'Kode promo kamu',
+  nativeFlow: [
+    { copy: 'PROMO2025', text: 'Salin Kode' }
+  ]
+})
+
+// Call button
+await sock.sendMessage(jid, {
+  text: 'Hubungi kami',
+  nativeFlow: [
+    { call: '+62812345678', text: 'Telepon Sekarang' }
+  ]
+})
+
+// Single select (list dalam button)
+await sock.sendMessage(jid, {
+  text: 'Pilih menu',
+  nativeFlow: [
+    {
+      sections: [{
+        title: 'Kategori A',
+        rows: [
+          { id: 'row1', title: 'Item 1', description: 'Deskripsi' },
+          { id: 'row2', title: 'Item 2' }
+        ]
+      }],
+      text: 'Buka Daftar'
+    }
+  ]
+})
+
+// Dengan icon pada tombol
+await sock.sendMessage(jid, {
+  text: 'Pilih aksi',
+  nativeFlow: [
+    { id: '1', text: 'Konfirmasi', icon: 'CHECK' },
+    { url: 'https://example.com', text: 'Buka', icon: 'LINK' }
+  ]
+})
+
+// Gambar sebagai header — WAJIB pakai image/video/document/location/product
+// jika tidak ada media valid → throw Error: Invalid media type
 await sock.sendMessage(jid, {
   image: { url: 'https://example.com/img.jpg' },
-  caption: 'Isi pesan',
-  title: 'Judul',
-  subtitle: 'Subjudul',
+  caption: 'Isi pesan',     // → body.text
+  title: 'Judul',           // → header.title
+  subtitle: 'Subjudul',     // → header.subtitle
   footer: 'Footer',
   nativeFlow: [
-    { name: 'quick_reply', paramsJson: '{"id":"1"}', text: 'Tombol 1' }
+    { id: '1', text: 'Tombol 1' }
   ]
 })
 
-// Dengan audio footer
+// Dengan audio footer (menggantikan footer teks)
 await sock.sendMessage(jid, {
   text: 'Pesan dengan audio footer',
   audioFooter: fs.readFileSync('audio.ogg'),
   nativeFlow: [
-    { name: 'quick_reply', paramsJson: '{"id":"1"}', text: 'OK' }
+    { id: '1', text: 'OK' }
+  ]
+})
+
+// offerText — tampil sebagai limited time offer banner
+await sock.sendMessage(jid, {
+  text: 'Penawaran terbatas!',
+  offerText: 'Diskon 50%',
+  offerUrl: 'https://example.com/promo',
+  offerCode: 'DISKON50',
+  offerExpiration: 1800000000,
+  nativeFlow: [
+    { id: 'claim', text: 'Klaim Sekarang' }
+  ]
+})
+
+// optionText — tombol-tombol masuk ke bottom sheet
+await sock.sendMessage(jid, {
+  text: 'Pilih opsi',
+  optionText: 'Lihat Semua Opsi',
+  optionTitle: 'Daftar Pilihan',
+  nativeFlow: [
+    { id: '1', text: 'Opsi A' },
+    { id: '2', text: 'Opsi B' }
   ]
 })
 
@@ -1076,13 +1252,15 @@ await sock.sendMessage(jid, {
 await sock.sendMessage(jid, {
   text: 'Template interaktif',
   nativeFlow: [
-    { name: 'quick_reply', paramsJson: '{"id":"1"}', text: 'Tombol' }
+    { id: '1', text: 'Tombol' }
   ],
   interactiveAsTemplate: true,
   id: 'template-id-unik'
 })
 ```
 
+> **Tipe tombol ditentukan otomatis** dari field yang ada: `id` → quick_reply · `url` → cta_url · `copy` → cta_copy · `call` → cta_call · `sections` → single_select. Bisa juga pakai `name` + `paramsJson` langsung untuk kontrol penuh. `text` atau `buttonText` keduanya diterima. Field `icon` opsional (string uppercase, e.g. `'CHECK'`, `'LINK'`).
+
 </details>
 
 ---
@@ -1148,16 +1326,46 @@ await sock.sendMessage(['628xxx@s.whatsapp.net'], {
 
 > Rich message menggunakan format `AIRichResponseMessage` yang tampil seperti respons AI di WhatsApp. Semua tipe di bawah bisa dipakai secara flat (field langsung) atau dikombinasikan via `richResponse: [...]`.
 
+> ⚠️ **Penting:** `contentText`, `headerText`, `footerText`, dan `disclaimerText` **bukan** trigger key — artinya jika hanya field itu yang dikirim, pesan **tidak akan** diproses sebagai rich message dan akan menghasilkan **Error: Invalid media type**. Gunakan selalu minimal satu trigger key (`code`, `table`, `richImage`, `richVideo`, `richResponse`, dll), lalu kombinasikan dengan field teks di atas sebagai pelengkap.
+
 ### ✍️ addText
 
 Kirim teks markdown sebagai AI Rich Response. Mendukung hyperlink, citation, dan LaTeX inline.
 
+Karena `contentText` bukan trigger key, gunakan `richResponse: [{ text }]` untuk pesan teks murni:
+
+```js
+// ✅ Cara benar — pakai richResponse array
+await sock.sendMessage(jid, {
+  richResponse: [
+    { text: 'Ini teks dari AI dengan *markdown* dan **bold**.' }
+  ],
+  headerText: 'Judul',
+  footerText: 'Footer',
+  disclaimerText: 'Generated by AI'
+})
+```
+
+```js
+// ✅ Alternatif — contentText sebagai pelengkap dari trigger key lain
+await sock.sendMessage(jid, {
+  code: 'console.log("Hello")',
+  language: 'javascript',
+  contentText: 'Penjelasan tambahan di sini.',
+  headerText: 'Judul',
+  footerText: 'Footer',
+  disclaimerText: 'Generated by AI'
+})
+```
+
 ```js
+// ❌ SALAH — contentText saja tidak akan trigger rich message
 await sock.sendMessage(jid, {
-  contentText: 'Ini teks dari AI dengan *markdown* dan **bold**.',
+  contentText: 'halooo',
   headerText: 'Judul',
   footerText: 'Footer',
   disclaimerText: 'Generated by AI'
+  // → Error: Invalid media type
 })
 ```
 

package/lib/Utils/messages.js

@@ -919,6 +919,24 @@ export const generateWAMessageContent = async (message, options) => {
             }
         };
     }
+    else if (hasNonNullishProperty(message, 'buttonsMessage')) {
+        // Direct buttonsMessage passthrough — supports headerType 6 (locationMessage), etc.
+        const btnMsg = { ...message.buttonsMessage };
+        if (btnMsg.locationMessage?.jpegThumbnail && !Buffer.isBuffer(btnMsg.locationMessage.jpegThumbnail)) {
+            const lib = await getImageProcessingLibrary();
+            const hasSharp = 'sharp' in lib && !!lib.sharp?.default;
+            if (hasSharp) {
+                const rawBuf = typeof btnMsg.locationMessage.jpegThumbnail === 'string'
+                    ? (await fs.readFile(btnMsg.locationMessage.jpegThumbnail))
+                    : btnMsg.locationMessage.jpegThumbnail;
+                btnMsg.locationMessage.jpegThumbnail = await lib.sharp.default(rawBuf)
+                    .resize(300, 300, { fit: 'inside', withoutEnlargement: true })
+                    .jpeg({ quality: 80 })
+                    .toBuffer();
+            }
+        }
+        m = { buttonsMessage: btnMsg };
+    }
     else {
         m = await prepareWAMessageMedia(message, options);
     }

package/lib/Utils/rich-message-utils.js

@@ -878,10 +878,17 @@ export const prepareRichResponseMessage = (content) => {
     }
 
     /* build unifiedResponse JSON — gabungkan sections dari submessages + extraSections */
-    const baseUnified = toUnified(submessages);
+    // Pisahkan footerSubs (teks setelah media) agar selalu muncul SETELAH extraSections (video/image)
+    const footerSubMessages = footerText ? [makeTextSub(footerText)] : [];
+    // Hapus footerText dari submessages jika sudah ada (sudah di-push sebelumnya)
+    const mainSubmessages = footerText
+        ? submessages.filter(s => !(s.messageType === RichSubMessageType.TEXT && s.messageText === footerText))
+        : submessages;
+    const baseUnified = toUnified(mainSubmessages);
+    const footerSections = footerSubMessages.map(buildUnifiedSection);
     const unified = extraSections && extraSections.length > 0
-        ? { ...baseUnified, sections: [...baseUnified.sections, ...extraSections] }
-        : baseUnified;
+        ? { ...baseUnified, sections: [...baseUnified.sections, ...extraSections, ...footerSections] }
+        : { ...baseUnified, sections: [...baseUnified.sections, ...footerSections] };
 
     const richResponseMessage = proto.AIRichResponseMessage.create({
         submessages,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nuiisweety/baileys",
   "type": "module",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "A WebSockets library for interacting with WhatsApp Web — forked STRICTLY from @whiskeysockets/baileys only, NOT from any other baileys fork. Modified by NuiiSweety.",
   "keywords": [
     "whatsapp",