@nuiisweety/baileys 0.1.0

package/README.md

@@ -0,0 +1,965 @@
+<h1 align="center">🌸 @nuiisweety/baileys 🌸</h1>
+
+<div align="center">
+  <img src="https://raw.githubusercontent.com/NuiiS4TORU/-nuisockets/refs/heads/main/nuiisweety.png" width="100%"/>
+</div>
+
+<div align="center">
+  <i>✨ Fork manis dari <code>@whiskeysockets/baileys</code> v7.0.0-rc11 &mdash; dikembangkan dengan sepenuh hati oleh <b>NuiiS4TORU</b> 💖</i>
+</div>
+
+<br/>
+
+<div align="center">
+  <blockquote>
+    🌷 <b>@nuiisweety/baileys hanya pernah bercabang dari satu sumber yang ia percaya, yaitu <a href="https://github.com/WhiskeySockets/Baileys">@whiskeysockets/baileys</a>.</b><br/>
+    Setiap modifikasi adalah buah dari pengembangan mandiri yang penuh dedikasi~ 🍀
+  </blockquote>
+</div>
+
+---
+
+## 🗺️ Navigasi Sayang
+
+<div align="center">
+
+**🔌 Koneksi**
+[QR Code](#-koneksi-qr-code) &nbsp;·&nbsp; [Pairing Code](#-koneksi-pairing-code) &nbsp;·&nbsp; [Browser Identity](#️-browser-identity) &nbsp;·&nbsp; [Opsi Koneksi](#️-opsi-koneksi)
+
+**📨 Handle Pesan**
+[Terima Pesan](#-terima-pesan) &nbsp;·&nbsp; [Handle Grup](#-handle-grup)
+
+**💌 Kirim Pesan**
+[Teks](#-teks) &nbsp;·&nbsp; [Gambar](#️-gambar) &nbsp;·&nbsp; [Video](#-video) &nbsp;·&nbsp; [Audio & Voice Note](#-audio--voice-note) &nbsp;·&nbsp; [Dokumen](#-dokumen) &nbsp;·&nbsp; [Sticker](#-sticker) &nbsp;·&nbsp; [Lokasi](#-lokasi) &nbsp;·&nbsp; [Kontak](#-kontak)
+
+**💞 Interaksi**
+[Reaksi](#-reaksi) &nbsp;·&nbsp; [Poll](#️-poll) &nbsp;·&nbsp; [Poll Result](#-poll-result) &nbsp;·&nbsp; [Poll Update](#️-poll-update) &nbsp;·&nbsp; [Forward](#️-forward) &nbsp;·&nbsp; [Hapus](#️-hapus-pesan) &nbsp;·&nbsp; [Edit](#️-edit-pesan) &nbsp;·&nbsp; [Pin](#-pin-pesan)
+
+**🌺 Tambahan**
+[Album](#️-album) &nbsp;·&nbsp; [Event](#-event) &nbsp;·&nbsp; [Group Status](#-group-status--group-story) &nbsp;·&nbsp; [Status Mention](#️-status-mention) &nbsp;·&nbsp; [Flow Reply](#-flow-reply) &nbsp;·&nbsp; [Button Reply](#-button-reply) &nbsp;·&nbsp; [Keep In Chat](#-keep-in-chat) &nbsp;·&nbsp; [Scheduled Call](#-scheduled-call) &nbsp;·&nbsp; [Group Invite](#-group-invite) &nbsp;·&nbsp; [Product](#️-product)
+
+**🎀 Wrapper**
+[View Once](#️-view-once) &nbsp;·&nbsp; [View Once V2](#️-view-once-v2) &nbsp;·&nbsp; [Ephemeral](#️-ephemeral) &nbsp;·&nbsp; [Spoiler](#-spoiler) &nbsp;·&nbsp; [Group Status Wrap](#-group-status-wrap) &nbsp;·&nbsp; [Lottie Sticker](#-lottie-sticker) &nbsp;·&nbsp; [AI Icon](#-ai-icon) &nbsp;·&nbsp; [Secure Meta Label](#️-secure-meta-service-label)
+
+**✨ Interactive**
+[Buttons](#-buttons) &nbsp;·&nbsp; [List Message](#-list-message) &nbsp;·&nbsp; [Template Buttons](#️-template-buttons) &nbsp;·&nbsp; [Native Flow](#-native-flow) &nbsp;·&nbsp; [Carousel](#-carousel)
+
+**🌟 Rich Message (AI)**
+[Code Block](#-code-block) &nbsp;·&nbsp; [Links](#-links-rich) &nbsp;·&nbsp; [Table](#-table-rich) &nbsp;·&nbsp; [Rich Response (Gabungan)](#-rich-response-gabungan)
+
+**🍃 Lainnya**
+[List Reply](#-list-reply) &nbsp;·&nbsp; [Sticker Pack](#-sticker-pack) &nbsp;·&nbsp; [External Ad Reply](#-external-ad-reply) &nbsp;·&nbsp; [Request Payment](#-request-payment) &nbsp;·&nbsp; [Invoice](#-invoice) &nbsp;·&nbsp; [Order](#-order) &nbsp;·&nbsp; [Disappearing Messages](#-disappearing-messages) &nbsp;·&nbsp; [Raw Message](#-raw-message)
+
+</div>
+
+---
+
+## 🌸 Instalasi
+
+```js
+const { default: makeWASocket } = require('@nuiisweety/baileys')
+// atau ESM 🌿
+import makeWASocket from '@nuiisweety/baileys'
+```
+
+---
+
+## 🔌 Koneksi QR Code
+
+```js
+const {
+  default: makeWASocket,
+  useMultiFileAuthState,
+  DisconnectReason,
+  fetchLatestBaileysVersion
+} = require('@nuiisweety/baileys')
+
+async function start() {
+  const { state, saveCreds } = await useMultiFileAuthState('auth_info')
+  const { version } = await fetchLatestBaileysVersion()
+
+  const sock = makeWASocket({
+    version,
+    auth: state,
+    printQRInTerminal: true
+  })
+
+  sock.ev.on('creds.update', saveCreds)
+  sock.ev.on('connection.update', ({ connection, lastDisconnect }) => {
+    if (connection === 'close') {
+      const code = lastDisconnect?.error?.output?.statusCode
+      if (code !== DisconnectReason.loggedOut) start()
+    } else if (connection === 'open') {
+      console.log('💖 Terhubung dengan indah!')
+    }
+  })
+}
+start()
+```
+
+---
+
+## 🔑 Koneksi Pairing Code
+
+> 🌷 Cocok untuk server/VPS tanpa tampilan terminal — tetap bisa terhubung dengan elegan~
+
+```js
+const sock = makeWASocket({
+  version,
+  auth: state,
+  printQRInTerminal: false
+})
+
+sock.ev.on('creds.update', saveCreds)
+sock.ev.on('connection.update', ({ connection, lastDisconnect }) => {
+  if (connection === 'close') {
+    if (lastDisconnect?.error?.output?.statusCode !== DisconnectReason.loggedOut) start()
+  }
+})
+
+// 💌 Nomor HP format internasional tanpa +
+if (!sock.authState.creds.registered) {
+  const code = await sock.requestPairingCode('628123456789')
+  console.log('🌸 Pairing code:', code)
+  // Masukkan di WA → Perangkat Tertaut → Tautkan Perangkat
+}
+```
+
+> 🍀 Pairing code kadaluarsa dalam beberapa menit. Jalankan ulang jika gagal ya~
+
+**🎀 Custom pairing code (8 karakter):**
+```js
+const code = await sock.requestPairingCode('628123456789', 'ABCD1234')
+```
+
+---
+
+## 🖥️ Browser Identity
+
+```js
+const { Browsers } = require('@nuiisweety/baileys')
+
+makeWASocket({
+  browser: Browsers.macOS('Chrome'),   // 🍎 Mac OS — Chrome
+  browser: Browsers.macOS('Firefox'),  // 🦊 Mac OS — Firefox
+  browser: Browsers.windows('Chrome'), // 🪟 Windows — Chrome
+  browser: Browsers.ubuntu('Chrome'),  // 🐧 Ubuntu — Chrome
+  browser: Browsers.baileys('Chrome'), // 🌸 Baileys — Chrome
+  browser: ['MyBot', 'Chrome', '1.0.0'] // ✨ custom
+})
+```
+
+---
+
+## ⚙️ Opsi Koneksi
+
+```js
+makeWASocket({
+  version,
+  auth: state,
+  printQRInTerminal: true,
+  browser: Browsers.macOS('Chrome'),
+  connectTimeoutMs: 20000,
+  keepAliveIntervalMs: 30000,
+  markOnlineOnConnect: true,
+  syncFullHistory: false,
+  generateHighQualityLinkPreview: false,
+  emitOwnEvents: true,
+  getMessage: async key => store?.messages?.[key.remoteJid]?.get(key.id)?.message
+})
+```
+
+---
+
+## 📥 Terima Pesan
+
+```js
+sock.ev.on('messages.upsert', async ({ messages, type }) => {
+  if (type !== 'notify') return
+
+  for (const m of messages) {
+    if (!m.message) continue
+    if (m.key.fromMe) continue
+
+    const jid = m.key.remoteJid
+    const isGroup = jid.endsWith('@g.us')
+    const sender = isGroup ? m.key.participant : jid
+
+    // 💬 Ambil teks
+    const text =
+      m.message.conversation ||
+      m.message.extendedTextMessage?.text ||
+      m.message.imageMessage?.caption ||
+      m.message.videoMessage?.caption || ''
+
+    // 👀 Tandai dibaca
+    await sock.readMessages([m.key])
+
+    // 🌸 Typing indicator
+    await sock.sendPresenceUpdate('composing', jid)
+  }
+})
+```
+
+---
+
+## 👥 Handle Grup
+
+```js
+// 🌷 Anggota masuk/keluar
+sock.ev.on('group-participants.update', ({ id, participants, action }) => {
+  // action: 'add' | 'remove' | 'promote' | 'demote'
+})
+
+// 📝 Info grup diupdate
+sock.ev.on('groups.update', updates => {})
+
+// 🔍 Metadata grup
+const meta = await sock.groupMetadata(groupJid)
+console.log(meta.subject, meta.participants)
+
+// 🌸 Semua grup
+const groups = await sock.groupFetchAllParticipating()
+
+// 💞 Tambah / keluarkan / promote / demote
+await sock.groupParticipantsUpdate(groupJid, ['628xxx@s.whatsapp.net'], 'add')
+await sock.groupParticipantsUpdate(groupJid, ['628xxx@s.whatsapp.net'], 'remove')
+await sock.groupParticipantsUpdate(groupJid, ['628xxx@s.whatsapp.net'], 'promote')
+await sock.groupParticipantsUpdate(groupJid, ['628xxx@s.whatsapp.net'], 'demote')
+
+// ✏️ Ubah nama / deskripsi
+await sock.groupUpdateSubject(groupJid, 'Nama Baru')
+await sock.groupUpdateDescription(groupJid, 'Deskripsi baru')
+
+// 🔒 Kunci / buka grup
+await sock.groupSettingUpdate(groupJid, 'announcement')
+await sock.groupSettingUpdate(groupJid, 'not_announcement')
+
+// 📣 Mention semua anggota
+const meta2 = await sock.groupMetadata(groupJid)
+const members = meta2.participants.map(p => p.id)
+await sock.sendMessage(groupJid, {
+  text: members.map(m => `@${m.split('@')[0]}`).join(' '),
+  mentions: members
+})
+```
+
+---
+
+## 💬 Teks
+
+```js
+await sock.sendMessage(jid, { text: 'Halo sayang~ 🌸' })
+
+// 💌 Dengan mention
+await sock.sendMessage(jid, {
+  text: '@628xxx halo!',
+  mentions: ['628xxx@s.whatsapp.net']
+}, { quoted: m })
+```
+
+---
+
+## 🖼️ Gambar
+
+```js
+// 🌐 URL
+await sock.sendMessage(jid, {
+  image: { url: 'https://example.com/image.jpg' },
+  caption: 'Keterangan 🌷'
+})
+
+// 📁 Buffer / file
+await sock.sendMessage(jid, {
+  image: fs.readFileSync('image.jpg'),
+  caption: 'Keterangan 💖'
+})
+```
+
+---
+
+## 🎥 Video
+
+```js
+await sock.sendMessage(jid, {
+  video: { url: 'https://example.com/video.mp4' },
+  caption: 'Keterangan 🌸',
+  gifPlayback: false  // true = GIF looping 🔁
+})
+
+// 🎞️ Video note (bubble)
+await sock.sendMessage(jid, {
+  video: fs.readFileSync('video.mp4'),
+  ptv: true
+})
+```
+
+---
+
+## 🎵 Audio & Voice Note
+
+```js
+// 🎶 Audio biasa
+await sock.sendMessage(jid, {
+  audio: { url: 'https://example.com/audio.mp3' },
+  mimetype: 'audio/mpeg'
+})
+
+// 🎙️ Voice note (PTT)
+await sock.sendMessage(jid, {
+  audio: fs.readFileSync('voice.ogg'),
+  mimetype: 'audio/ogg; codecs=opus',
+  ptt: true
+})
+```
+
+---
+
+## 📄 Dokumen
+
+```js
+await sock.sendMessage(jid, {
+  document: fs.readFileSync('file.pdf'),
+  mimetype: 'application/pdf',
+  fileName: 'dokumen.pdf',
+  caption: 'File ini 🍃'
+})
+```
+
+---
+
+## 🎭 Sticker
+
+```js
+await sock.sendMessage(jid, {
+  sticker: fs.readFileSync('sticker.webp')
+})
+```
+
+---
+
+## 📍 Lokasi
+
+```js
+await sock.sendMessage(jid, {
+  location: {
+    degreesLatitude: -6.2088,
+    degreesLongitude: 106.8456,
+    name: 'Monas 🌟',
+    address: 'Jakarta Pusat'
+  }
+})
+```
+
+---
+
+## 👤 Kontak
+
+```js
+await sock.sendMessage(jid, {
+  contacts: {
+    displayName: 'Nama 💕',
+    contacts: [{
+      vcard: 'BEGIN:VCARD\nVERSION:3.0\nFN:Nama\nTEL:+62812345678\nEND:VCARD'
+    }]
+  }
+})
+```
+
+---
+
+## 😍 Reaksi
+
+```js
+await sock.sendMessage(jid, { react: { text: '💖', key: m.key } })
+// 🌸 Hapus reaksi
+await sock.sendMessage(jid, { react: { text: '', key: m.key } })
+```
+
+---
+
+## 🗳️ Poll
+
+```js
+await sock.sendMessage(jid, {
+  poll: {
+    name: 'Pilih salah satu~ 🌷',
+    values: ['Opsi A 🌸', 'Opsi B 🌺', 'Opsi C 🌼'],
+    selectableCount: 1  // 0 = boleh pilih banyak 💞
+  }
+})
+```
+
+**🌟 Poll dengan fitur tambahan:**
+```js
+await sock.sendMessage(jid, {
+  poll: {
+    name: 'Nama Poll 💌',
+    values: ['Opsi A', 'Opsi B'],
+    selectableCount: 1,
+    endDate: new Date('2025-12-31'),   // 📅 tanggal berakhir
+    hideVoter: true,                    // 🙈 sembunyikan nama pemilih
+    canAddOption: false,                // 🔒 larang tambah opsi
+    toAnnouncementGroup: false          // true = community announcement group (pollV2)
+  }
+})
+```
+
+**🧠 Quiz (Poll dengan jawaban benar):**
+```js
+await sock.sendMessage(jid, {
+  poll: {
+    name: 'Ibu kota Indonesia? 🌏',
+    values: ['Jakarta', 'Surabaya', 'Bandung'],
+    selectableCount: 1,
+    pollType: 1,           // 1 = QUIZ 🎓
+    correctAnswer: 'Jakarta'
+  }
+})
+```
+
+---
+
+## 📊 Poll Result
+
+```js
+await sock.sendMessage(jid, {
+  pollResult: {
+    name: 'Nama Poll 🌸',
+    votes: [
+      { name: 'Opsi A 💖', voteCount: 10 },
+      { name: 'Opsi B 🌷', voteCount: 5 }
+    ],
+    pollType: 0  // 0 = POLL, 1 = QUIZ 🎓
+  }
+})
+```
+
+---
+
+## 🗳️ Poll Update
+
+```js
+await sock.sendMessage(jid, {
+  pollUpdate: {
+    key: pollMessage.key,  // 🗝️ key dari pesan poll yang mau di-vote
+    vote: encryptedVotePayload,
+    metadata: optionalMetadata
+  }
+})
+```
+
+---
+
+## ↩️ Forward
+
+```js
+await sock.sendMessage(jid, {
+  forward: targetMessage,
+  force: true  // 💌 paksa tampil sebagai forwarded
+})
+```
+
+---
+
+## 🗑️ Hapus Pesan
+
+```js
+await sock.sendMessage(jid, { delete: m.key })
+```
+
+---
+
+## ✏️ Edit Pesan
+
+```js
+await sock.sendMessage(jid, {
+  text: 'Teks yang sudah diedit dengan penuh kasih~ 🌸',
+  edit: m.key
+})
+```
+
+---
+
+## 📌 Pin Pesan
+
+```js
+// 📍 Pin
+await sock.sendMessage(jid, {
+  pin: m.key,
+  type: 1,
+  time: 86400  // 86400=1hr 🕐 | 604800=7hr 🕰️ | 2592000=30hr 📆
+})
+// 🪄 Unpin
+await sock.sendMessage(jid, { pin: m.key, type: 2 })
+```
+
+---
+
+## 🖼️ Album
+
+```js
+await sock.sendMessage(jid, {
+  album: [
+    { image: { url: 'https://example.com/1.jpg' }, caption: 'Foto 1 🌸' },
+    { image: { url: 'https://example.com/2.jpg' }, caption: 'Foto 2 🌷' },
+    { video: { url: 'https://example.com/vid.mp4' }, caption: 'Video 💕' }
+  ]
+})
+// 🌺 minimal 2 media ya~
+```
+
+---
+
+## 📅 Event
+
+```js
+await sock.sendMessage(jid, {
+  event: {
+    name: 'Nama Acara 🌟',
+    description: 'Deskripsi indah 🌸',
+    startDate: new Date('2025-12-01T10:00:00'),
+    endDate: new Date('2025-12-01T12:00:00'),
+    location: {
+      degreesLatitude: -6.2088,
+      degreesLongitude: 106.8456,
+      name: 'Monas, Jakarta 🌆'
+    },
+    extraGuestsAllowed: true
+  }
+})
+```
+
+**📞 Event dengan scheduled call (audio/video):**
+```js
+await sock.sendMessage(jid, {
+  event: {
+    name: 'Meeting Online 💻',
+    startDate: new Date('2025-12-01T10:00:00'),
+    call: 'audio',   // 🎙️ 'audio' | 📹 'video'
+    isScheduleCall: true
+  }
+})
+```
+
+---
+
+## 📸 Group Status / Group Story
+
+```js
+// 💬 Teks
+await sock.sendMessage(groupJid, {
+  groupStatusMessage: { text: 'Status teks yang manis~ 🌸' }
+})
+
+// 🖼️ Gambar
+await sock.sendMessage(groupJid, {
+  groupStatusMessage: {
+    image: { url: 'https://example.com/image.jpg' },
+    caption: 'Keterangan 💖'
+  }
+})
+
+// 🎥 Video
+await sock.sendMessage(groupJid, {
+  groupStatusMessage: {
+    video: { url: 'https://example.com/video.mp4' },
+    caption: 'Keterangan 🌷'
+  }
+})
+```
+
+---
+
+## ⚡ Flow Reply
+
+> 💫 Balas pesan interaktif native flow dengan anggun~
+
+```js
+await sock.sendMessage(jid, {
+  flowReply: {
+    name: 'quick_reply',       // 🔘 nama button yang ditekan
+    paramsJson: '{"id":"btn1"}',
+    text: 'Teks balasan 🌸',
+    format: 1,
+    version: 1
+  }
+})
+```
+
+---
+
+## 🔘 Button Reply
+
+```js
+// 🗂️ Template button
+await sock.sendMessage(jid, {
+  buttonReply: {
+    displayText: 'Opsi yang dipilih 💕',
+    id: 'btn_id',
+    index: 0
+  },
+  type: 'template'
+})
+
+// 🔵 Plain button
+await sock.sendMessage(jid, {
+  buttonReply: {
+    displayText: 'Opsi yang dipilih 🌸',
+    id: 'btn_id'
+  },
+  type: 'plain'
+})
+```
+
+---
+
+## 📌 Keep In Chat
+
+```js
+// 💾 Simpan
+await sock.sendMessage(jid, {
+  keep: m.key,
+  keepType: 1  // 1 = keep 💖, 2 = unkeep 🍃
+})
+```
+
+---
+
+## 📞 Scheduled Call
+
+```js
+await sock.sendMessage(jid, {
+  call: {
+    time: Date.now() + 3600000,
+    type: 1,  // 1 = voice 🎙️, 2 = video 📹
+    title: 'Meeting 🌸'
+  }
+})
+```
+
+---
+
+## 🔗 Group Invite
+
+```js
+await sock.sendMessage(jid, {
+  groupInvite: {
+    jid: 'xxx@g.us',
+    inviteCode: 'kode',
+    inviteExpiration: Date.now() + 86400000,
+    subject: 'Nama Grup 🌷',
+    text: 'Bergabunglah bersama kami~ 💕'
+  }
+})
+```
+
+---
+
+## 🛍️ Product
+
+```js
+await sock.sendMessage(jid, {
+  product: {
+    productImage: fs.readFileSync('produk.jpg'),
+    productId: 'prod_123',
+    title: 'Nama Produk 🌸',
+    description: 'Deskripsi cantik 💖',
+    currencyCode: 'IDR',
+    priceAmount1000: 50000000,
+    retailerId: 'sku_001',
+    url: 'https://toko.example.com/produk'
+  },
+  businessOwnerJid: '628xxx@s.whatsapp.net'  // 🌟 wajib diisi ya~
+})
+```
+
+---
+
+## 👁️ View Once
+
+```js
+await sock.sendMessage(jid, {
+  image: { url: 'https://example.com/image.jpg' },
+  viewOnce: true  // 🌸 sekali lihat, hilang bagai mimpi~
+})
+```
+
+---
+
+## 👁️ View Once V2
+
+```js
+await sock.sendMessage(jid, {
+  image: { url: 'https://example.com/image.jpg' },
+  viewOnceV2: true  // 💫 wrap ke viewOnceMessageV2
+})
+
+// 🌟 viewOnceV2Extension
+await sock.sendMessage(jid, {
+  image: { url: 'https://example.com/image.jpg' },
+  viewOnceV2Extension: true
+})
+```
+
+---
+
+## ⏱️ Ephemeral
+
+> 🍃 Wrap pesan ke dalam `ephemeralMessage` — pesan yang menghilang seperti embun pagi~
+
+```js
+await sock.sendMessage(jid, {
+  text: 'Pesan ini ephemeral 🌸',
+  ephemeral: true
+})
+```
+
+---
+
+## 🫣 Spoiler
+
+> 🎀 Wrap pesan ke dalam `spoilerMessage` — untuk kejutan yang manis~
+
+```js
+await sock.sendMessage(jid, {
+  image: { url: 'https://example.com/image.jpg' },
+  caption: 'Spoiler! 🌷',
+  spoiler: true
+})
+```
+
+---
+
+## 📢 Group Status Wrap
+
+> 💕 Wrap pesan biasa menjadi `groupStatusMessageV2`~
+
+```js
+await sock.sendMessage(jid, {
+  text: 'Status di grup ini 🌸',
+  groupStatus: true
+})
+```
+
+---
+
+## 🌀 Lottie Sticker
+
+> ✨ Wrap sticker ke dalam `lottieStickerMessage` — animasi yang memukau~
+
+```js
+await sock.sendMessage(jid, {
+  sticker: fs.readFileSync('sticker.webp'),
+  isLottie: true
+})
+```
+
+---
+
+## 🔲 Buttons
+
+> 💖 Kirim pesan dengan tombol interaktif yang menggemaskan~
+
+```js
+// 💬 Dengan teks biasa
+await sock.sendMessage(jid, {
+  text: 'Pilih salah satu ya sayang~ 🌸',
+  footer: 'Footer pesan 🍃',
+  buttons: [
+    { id: 'btn1', text: 'Tombol 1 💕' },
+    { id: 'btn2', text: 'Tombol 2 🌷' },
+    { id: 'btn3', text: 'Tombol 3 🌺' }
+  ]
+})
+
+// 🖼️ Dengan gambar sebagai header
+await sock.sendMessage(jid, {
+  image: { url: 'https://example.com/image.jpg' },
+  caption: 'Isi pesan 💖',
+  footer: 'Footer 🌸',
+  buttons: [
+    { id: 'btn1', text: 'Pilih A 🌷' },
+    { id: 'btn2', text: 'Pilih B 🌺' }
+  ]
+})
+
+// 🌊 Native flow button (single select dengan sections)
+await sock.sendMessage(jid, {
+  text: 'Pilih menu~ 🌸',
+  buttons: [
+    {
+      text: 'Buka Menu 💕',
+      sections: [
+        {
+          title: 'Kategori A 🌷',
+          rows: [
+            { id: 'row1', title: 'Item 1 🌸', description: 'Deskripsi manis' },
+            { id: 'row2', title: 'Item 2 🌺' }
+          ]
+        }
+      ]
+    }
+  ]
+})
+
+// ✨ Native flow button dengan name kustom
+await sock.sendMessage(jid, {
+  text: 'Pilih~ 💖',
+  buttons: [
+    { name: 'quick_reply', paramsJson: '{"id":"1"}', text: 'Quick Reply 🌸' }
+  ]
+})
+```
+
+---
+
+## 📋 List Message
+
+> 🌷 Kirim pesan daftar pilihan yang teratur dan elegan~
+
+```js
+await sock.sendMessage(jid, {
+  text: 'Silakan pilih~ 🌸',
+  title: 'Judul List 💕',
+  buttonText: 'Buka Daftar 🌷',
+  footer: 'Footer pesan 🍃',
+  sections: [
+    {
+      title: 'Bagian 1 🌺',
+      rows: [
+        { id: 'row1', title: 'Pilihan A 💖', description: 'Deskripsi A yang manis' },
+        { id: 'row2', title: 'Pilihan B 🌸', description: 'Deskripsi B yang lembut' }
+      ]
+    },
+    {
+      title: 'Bagian 2 🌼',
+      rows: [
+        { id: 'row3', title: 'Pilihan C 🌷' }
+      ]
+    }
+  ]
+})
+```
+
+---
+
+## 🗂️ Template Buttons
+
+> 💌 Tombol template (quick reply, URL, call) — tampil di WhatsApp Web/Desktop & iOS~
+
+```js
+// 💬 Dengan teks
+await sock.sendMessage(jid, {
+  text: 'Pesan template 🌸',
+  footer: 'Footer 🍃',
+  id: 'template-unik',
+  templateButtons: [
+    { id: 'btn1', text: 'Quick Reply 💕' },
+    { url: 'https://example.com', text: 'Kunjungi Website 🌐' },
+    { call: '+62812345678', text: 'Hubungi Kami 📞' }
+  ]
+})
+
+// 🖼️ Dengan gambar sebagai header
+await sock.sendMessage(jid, {
+  image: { url: 'https://example.com/img.jpg' },
+  caption: 'Isi pesan 💖',
+  title: 'Judul 🌸',
+  footer: 'Footer 🌷',
+  templateButtons: [
+    { id: 'btn1', text: 'Klik Sini 💕' },
+    { url: 'https://example.com', text: 'Buka Link 🌐' }
+  ]
+})
+```
+
+---
+
+## 🌊 Native Flow
+
+> ✨ Pesan interaktif dengan native flow buttons yang indah — mendukung media header & audio footer~
+
+```js
+// 💬 Teks dengan native flow buttons
+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 🌷' }
+  ]
+})
+
+// 🖼️ Dengan gambar sebagai header
+await sock.sendMessage(jid, {
+  image: { url: 'https://example.com/img.jpg' },
+  caption: 'Isi pesan 💖',
+  title: 'Judul 🌸',
+  subtitle: 'Subjudul 🌷',
+  footer: 'Footer 🍃',
+  nativeFlow: [
+    { name: 'quick_reply', paramsJson: '{"id":"1"}', text: 'Tombol 1 💕' }
+  ]
+})
+
+// 🎵 Dengan audio footer
+await sock.sendMessage(jid, {
+  text: 'Pesan dengan audio footer 🎶',
+  audioFooter: fs.readFileSync('audio.ogg'),
+  nativeFlow: [
+    { name: 'quick_reply', paramsJson: '{"id":"1"}', text: 'OK 💖' }
+  ]
+})
+
+// 🎀 Wrap sebagai templateMessage
+await sock.sendMessage(jid, {
+  text: 'Template interaktif 🌸',
+  nativeFlow: [
+    { name: 'quick_reply', paramsJson: '{"id":"1"}', text: 'Tombol 💕' }
+  ],
+  interactiveAsTemplate: true,
+  id: 'template-id-unik'
+})
+```
+
+---
+
+## 🎠 Carousel
+
+> 🌺 Pesan carousel dengan kartu-kartu yang cantik (image/video/product per kartu)~
+
+```js
+await sock.sendMessage(jid, {
+  text: 'Carousel utama 🌸',
+  footer: 'Footer utama 🍃',
+  cards: [
+    {
+      image: { url: 'https://example.com/1.jpg' },
+      title: 'Kartu 1 💕',
+      caption: 'Deskripsi kartu 1 yang manis 🌷',
+      footer: 'Footer kartu 1 🌸',
+      nativeFlow: [
+        { name: 'quick_reply', paramsJson: '{"id":"c1"}', text: 'Pilih Ini 💖' }
+      ]
+    },
+    {
+      image: { url: 'https://example.com/2.jpg' },
+      title: 'Kartu 2 🌺',
+      caption: 'Deskripsi kartu 2 yang indah 🌼',
+      nativeFlow: [
+        { name: 'quick_reply', paramsJson: '{"id":"c2"}', text: 'Pilih Itu 🌸' }
+      ]
+    }
+  ]
+})
+```
+
+---
+
+<div align="center">
+  <br/>
+  <i>🌸 Dibuat dengan cinta dan dedikasi oleh <b>NuiiS4TORU</b> 💖</i><br/>
+  <i>✨ Semoga library ini membawa kebahagiaan dalam setiap project-mu~ 🌷</i>
+  <br/><br/>
+</div>