@blckrose/baileys 1.1.1 → 1.2.6

package/README.md

@@ -54,21 +54,36 @@ To run the example script, download or clone the repo and then type the followin
 
 ## Install
 
-Use the stable version:
+Install dari file `.tgz` lokal (versi modified blckrose):
 ```
-yarn add @blckrose/baileys
+npm install ./blckrose-baileys-1.1.5-apoc.tgz
 ```
 
-Use the edge version (no guarantee of stability, but latest fixes + features)
+Atau tambahkan ke `package.json`:
+```json
+{
+  "dependencies": {
+    "@blckrose/baileys": "file:./blckrose-baileys-1.1.5-apoc.tgz"
+  }
+}
+```
+
+Kemudian jalankan:
 ```
-yarn add github:WhiskeySockets/Baileys
+npm install
 ```
 
-Then import your code using:
+**ESM:**
 ```ts
 import makeWASocket from '@blckrose/baileys'
 ```
 
+**CJS (destructure langsung, tanpa top-level await):**
+```js
+const { makeWASocket, useMultiFileAuthState, Browsers, DisconnectReason } = require('@blckrose/baileys')
+// global apocalypse otomatis tersedia setelah baris di atas
+```
+
 # Links
 
 - [Discord](https://discord.gg/WeJM5FP9GG)
@@ -93,6 +108,15 @@ import makeWASocket from '@blckrose/baileys'
 - [Implementing a Data Store](#implementing-a-data-store)
 - [Whatsapp IDs Explain](#whatsapp-ids-explain)
 - [Utility Functions](#utility-functions)
+- [Apocalypse API](#apocalypse-api)
+    - [Cara Pakai Tanpa API Key](#cara-pakai-tanpa-api-key)
+    - [Cara Pakai Dengan API Key](#cara-pakai-dengan-api-key)
+    - [Contoh Penggunaan](#contoh-penggunaan-apocalypse)
+- [Newsletter / Channel](#newsletter--channel)
+    - [Kirim Media ke Channel](#kirim-media-ke-channel)
+    - [Button di Channel](#button-di-channel)
+    - [Edit & Hapus Pesan Channel](#edit--hapus-pesan-channel)
+- [Resolve JID (LID → Phone)](#resolve-jid)
 - [Sending Messages](#sending-messages)
     - [Non-Media Messages](#non-media-messages)
         - [Text Message](#text-message)
@@ -100,16 +124,45 @@ import makeWASocket from '@blckrose/baileys'
         - [Mention User](#mention-user-works-with-most-types)
         - [Forward Messages](#forward-messages)
         - [Location Message](#location-message)
+        - [Live Location Message](#live-location-message)
         - [Contact Message](#contact-message)
         - [Reaction Message](#reaction-message)
         - [Pin Message](#pin-message)
+        - [Keep Message](#keep-message)
         - [Poll Message](#poll-message)
+        - [Poll Result Message](#poll-result-message)
+        - [Call Message](#call-message)
+        - [Event Message](#event-message)
+        - [Order Message](#order-message)
+        - [Product Message](#product-message)
+        - [Payment Message](#payment-message)
+        - [Payment Invite Message](#payment-invite-message)
+        - [Admin Invite Message](#admin-invite-message)
+        - [Group Invite Message](#group-invite-message)
+        - [Sticker Pack Message](#sticker-pack-message)
+        - [Share Phone Number Message](#share-phone-number-message)
+        - [Request Phone Number Message](#request-phone-number-message)
+        - [Buttons Reply Message](#buttons-reply-message)
+        - [Buttons Message](#buttons-message)
+        - [Buttons List Message](#buttons-list-message)
+        - [Buttons Product List Message](#buttons-product-list-message)
+        - [Buttons Cards Message](#buttons-cards-message)
+        - [Buttons Template Message](#buttons-template-message)
+        - [Buttons Interactive Message](#buttons-interactive-message)
+        - [Buttons Interactive Message PIX](#buttons-interactive-message-pix)
+        - [Buttons Interactive Message PAY](#buttons-interactive-message-pay)
+        - [Status Mentions Message](#status-mentions-message)
+        - [Shop Message](#shop-message)
+        - [Collection Message](#collection-message)
+    - [AI Icon Feature](#ai-icon-feature)
     - [Sending with Link Preview](#sending-messages-with-link-previews)
     - [Media Messages](#media-messages)
         - [Gif Message](#gif-message)
         - [Video Message](#video-message)
         - [Audio Message](#audio-message)
         - [Image Message](#image-message)
+        - [Album Message](#album-message)
+        - [Ptv Video Message](#ptv-video-message)
         - [ViewOnce Message](#view-once-message)
 - [Modify Messages](#modify-messages)
     - [Delete Messages (for everyone)](#deleting-messages-for-everyone)
@@ -130,6 +183,7 @@ import makeWASocket from '@blckrose/baileys'
     - [Delete a Chat](#delete-a-chat)
     - [Star/Unstar a Message](#starunstar-a-message)
     - [Disappearing Messages](#disappearing-messages)
+    - [Clear Messages](#clear-messages)
 - [User Querys](#user-querys)
     - [Check If ID Exists in Whatsapp](#check-if-id-exists-in-whatsapp)
     - [Query Chat History (groups too)](#query-chat-history-groups-too)
@@ -370,6 +424,46 @@ async function connectToWhatsApp () {
 connectToWhatsApp()
 ```
 
+### For example if you use useSingleFileAuthState and useMongoFileAuthState
+```ts
+import makeWASocket, { useSingleFileAuthState, useMongoFileAuthState } from '@blckrose/baileys'
+
+// Single Auth
+const { state, saveState } = await useSingleFileAuthState('./auth_info_baileys.json') 
+const sock = makeWASocket({
+        auth: state,
+        printQRInTerminal: true
+    })
+    
+sock.ev.on('creds.update', saveState)
+
+// Mongo Auth
+import { MongoClient } from "mongodb"
+
+const connectAuth = async() => {
+    global.client = new MongoClient('mongoURL')
+    global.client.connect(err => {
+        if (err) {
+            console.warn("Warning: MongoDB link is invalid or cannot be connected.")
+        } else {
+            console.log('Successfully Connected To MongoDB Server')
+        }
+    })
+  await client.connect()
+  const collection = client.db("@blckrose").collection("sessions")
+  return collection
+}
+
+const Authentication = await connectAuth()
+const { state, saveCreds } = await useMongoFileAuthState(Authentication)
+const sock = makeWASocket({
+        auth: state,
+        printQRInTerminal: true
+    })
+    
+sock.ev.on('creds.update', saveCreds)
+```
+
 > [!IMPORTANT]
 > In `messages.upsert` it's recommended to use a loop like `for (const message of event.messages)` to handle all messages in array
 
@@ -454,12 +548,399 @@ The store also provides some simple functions such as `loadMessages` that utiliz
 
 ## Utility Functions
 
+### Resize Image
+```ts
+// Resize an image (Buffer, URL, or stream) to given dimensions
+const resized = await sock.resize('https://example.com/image.jpg', 320, 320)
+// or
+const resized = await sock.resize(buffer, 320, 320)
+```
+
 - `getContentType`, returns the content type for any message
 - `getDevice`, returns the device from message
 - `makeCacheableSignalKeyStore`, make auth store more fast
 - `downloadContentFromMessage`, download content from any message
+- `makeNewsletterUtils`, helper lengkap untuk kirim ke newsletter/channel
+- `resolveJid`, resolve LID / participant ID ke JID @s.whatsapp.net
+- `resolveJids`, resolve banyak JID sekaligus
+
+---
+
+## Apocalypse API
+
+> **Base URL:** `https://api.apocalypse.web.id`
+> **Docs:** `https://api.apocalypse.web.id/docs`
+
+`apocalypse` adalah global HTTP client yang otomatis tersedia setelah `require('@blckrose/baileys')`. Tidak perlu import apapun lagi.
+
+### Cara Pakai Tanpa API Key
+
+```js
+// Cukup require baileys seperti biasa, apocalypse langsung ada
+const { makeWASocket, useMultiFileAuthState } = require('@blckrose/baileys')
+
+// Di handler / file manapun — langsung pakai:
+const res = await apocalypse.get('/search/spotify?q=swim')
+console.log(res.result)
+
+// Atau gunakan params object (auto-encode):
+const res = await apocalypse.get('/search/spotify', { q: 'swim' })
+
+// Sub-path dengan params:
+const res = await apocalypse.get('/manga/jagoanmanga/search', { q: 'killer+peter' })
+
+// POST:
+const res = await apocalypse.post('/ai/chatgpt', { text: 'halo' })
+```
+
+### Cara Pakai Dengan API Key
+
+`createApocalypse` tersedia **global** tanpa import, otomatis setelah `require('@blckrose/baileys')`.
+
+**Cara 1 — API key langsung di kode:**
+```js
+const api = createApocalypse({ apiKey: 'NEMOPHILA' })
+await api.get('/search/spotify', { q: 'swim' })
+```
+
+**Cara 2 — API key dari `config.js` / `setting.js`:**
+```js
+// config.js / setting.js
+global.apikey = 'NEMOPHILA'
+
+// handler / file manapun — tidak perlu import apapun
+const api = createApocalypse({ apiKey: global.apikey })
+await api.get('/search/spotify', { q: 'swim' })
+```
+
+**Cara 3 — Set ke global `apocalypse` instance (berlaku semua request):**
+```js
+// bot.js — set sekali
+apocalypse.setKey(global.apikey)
+
+// handler manapun — langsung pakai, key terbawa otomatis
+await apocalypse.get('/premium/endpoint', { q: 'test' })
+```
+
+**Config lengkap yang tersedia:**
+```js
+const api = createApocalypse({
+    apiKey: 'NEMOPHILA',     // API key → dikirim sebagai header x-api-key
+    timeout: 15000,          // timeout ms (default: 30000)
+    baseUrl: 'https://...',  // override base URL (opsional)
+    headers: {               // header tambahan (opsional)
+        'x-custom': 'value'
+    }
+})
+```
+
+> [!NOTE]
+> `createApocalypse` dan `apocalypse` keduanya tersedia global — tidak perlu tulis `import` atau `require` apapun selain `require('@blckrose/baileys')` yang sudah ada di bot.js.
+
+### Contoh Penggunaan Apocalypse
+
+#### Respon Object
+
+Setiap response memiliki struktur yang sama:
+
+| Property | Tipe | Keterangan |
+|---|---|---|
+| `.result` | `any` | Data utama (`data.result` / `data.data` / root) |
+| `.status` | `boolean` | `true` jika API sukses |
+| `.message` | `string` | Pesan dari API |
+| `.raw` | `object` | Full JSON response mentah |
+| `.url` | `string` | URL yang dipanggil |
+| `.get(key)` | `any` | Ambil field tertentu dari result |
+
+#### Search Spotify
+
+```js
+const res = await apocalypse.get('/search/spotify', { q: 'swim' })
+// atau
+const res = await apocalypse.get('/search/spotify?q=swim')
+
+console.log(res.result)  // data hasil pencarian
+console.log(res.status)  // true / false
+```
+
+#### Search YouTube
+
+```js
+const res = await apocalypse.get('/search/youtube', { q: 'lagu baru' })
+console.log(res.result)
+```
+
+#### Search dengan URL
+
+```js
+const res = await apocalypse.get('/search/tiktok', { url: 'https://vm.tiktok.com/xxx' })
+console.log(res.result)
+```
+
+#### Manga Search
+
+```js
+// Sub-path: /manga/{sumber}/search
+const res = await apocalypse.get('/manga/jagoanmanga/search', { q: 'killer+peter' })
+console.log(res.result)
+```
+
+#### AI / Chatbot
+
+```js
+const res = await apocalypse.post('/ai/chatgpt', { text: 'halo, siapa kamu?' })
+console.log(res.result)
+```
+
+#### Category Helper (shortcut)
+
+```js
+// Buat caller untuk satu kategori
+const search = apocalypse.category('search')
+await search.get('spotify', { q: 'swim' })
+await search.get('youtube', { q: 'lagu' })
+await search.get('tiktok', { q: 'viral' })
+
+// Sub-path
+const manga = apocalypse.category('manga/jagoanmanga')
+await manga.get('search', { q: 'naruto' })
+await manga.get('chapter', { id: '123' })
+```
+
+#### Pakai di Handler Bot
+
+```js
+// handler/search.js
+let handler = async (m, { conn }) => {
+    const query = m.text.slice(8).trim() // contoh: !search <query>
+    if (!query) return conn.sendMessage(m.chat, { text: 'Masukkan kata kunci!' }, { quoted: m })
+
+    try {
+        const res = await apocalypse.get('/search/spotify', { q: query })
+        if (!res.status) return conn.sendMessage(m.chat, { text: 'Tidak ditemukan.' }, { quoted: m })
+
+        const data = res.result
+        await conn.sendMessage(m.chat, {
+            text: `🎵 *${data.title}*\n👤 ${data.artist}\n🔗 ${data.url}`
+        }, { quoted: m })
+    } catch (e) {
+        await conn.sendMessage(m.chat, { text: `Error: ${e.message}` }, { quoted: m })
+    }
+}
+
+handler.command = /^search$/i
+module.exports = handler
+```
+
+#### Pakai Dengan API Key
+
+```js
+// Cara 1 — langsung di kode
+const api = createApocalypse({ apiKey: 'NEMOPHILA' })
+await api.get('/search/spotify', { q: 'swim' })
+
+// Cara 2 — dari config/setting global
+const api = createApocalypse({ apiKey: global.apikey })
+await api.get('/search/spotify', { q: 'swim' })
+
+// Cara 3 — set ke global instance (berlaku semua request berikutnya)
+apocalypse.setKey(global.apikey)
+await apocalypse.get('/premium/endpoint', { q: 'test' })
+```
+
+---
+
+## Newsletter / Channel
+
+> [!NOTE]
+> Newsletter menggunakan format JID `@newsletter`, contoh: `120363xxxxxxxxx@newsletter`
+
+### Kirim Media ke Channel
+
+Gunakan helper `makeNewsletterUtils(conn)` yang menggabungkan semua fungsi kirim ke channel:
+
+```js
+const { makeNewsletterUtils } = require('@blckrose/baileys')
+const nl = makeNewsletterUtils(conn)
+
+const JID = '120363xxxxxxxxx@newsletter'
+
+// Teks
+await nl.sendNewsletterText(JID, 'Halo dari bot!')
+
+// Gambar
+await nl.sendNewsletterImage(JID, { url: 'https://example.com/img.jpg' }, { caption: 'Gambar keren' })
+
+// Video
+await nl.sendNewsletterVideo(JID, { url: 'https://example.com/vid.mp4' }, { caption: 'Video nih' })
+
+// PTV (video note / lingkaran)
+await nl.sendNewsletterPtv(JID, { url: 'https://example.com/vid.mp4' })
+
+// Audio
+await nl.sendNewsletterAudio(JID, { url: 'https://example.com/audio.mp3' })
+
+// Dokumen
+await nl.sendNewsletterDocument(JID, { url: 'https://example.com/file.pdf' }, {
+    mimetype: 'application/pdf',
+    fileName: 'dokumen.pdf'
+})
+
+// Sticker
+await nl.sendNewsletterSticker(JID, fs.readFileSync('./sticker.webp'))
+```
+
+Atau langsung pakai `conn.sendMessage` seperti biasa — semua tipe media sudah support:
+```js
+await conn.sendMessage(JID, { image: { url: 'https://...' }, caption: 'test' })
+await conn.sendMessage(JID, { video: { url: 'https://...' }, ptv: true })
+```
+
+### Button di Channel
+
+> [!IMPORTANT]
+> Fitur ini **hanya ada di blckrose-baileys 1.1.5-apoc**. Fork lain tidak support button di newsletter.
+
+```js
+const nl = makeNewsletterUtils(conn)
+const JID = '120363xxxxxxxxx@newsletter'
+
+// Quick Reply Buttons
+await nl.sendNewsletterButtons(JID, {
+    body: 'Pilih salah satu:',
+    buttons: [
+        { id: 'btn_yes', text: '✅ Setuju' },
+        { id: 'btn_no',  text: '❌ Tidak' },
+        { id: 'btn_skip', text: '⏭ Skip' }
+    ],
+    footer: 'Powered by bot'
+})
+
+// Single Select List
+await nl.sendNewsletterList(JID, {
+    body: 'Pilih menu yang kamu mau:',
+    buttonText: 'Buka Menu',
+    sections: [
+        {
+            title: 'Fitur Utama',
+            rows: [
+                { id: 'info',  title: 'Info Bot',   description: 'Lihat info bot' },
+                { id: 'help',  title: 'Bantuan',    description: 'Cara pakai bot' },
+                { id: 'stats', title: 'Statistik',  description: 'Lihat statistik' }
+            ]
+        },
+        {
+            title: 'Lainnya',
+            rows: [
+                { id: 'about', title: 'Tentang',    description: 'Info developer' }
+            ]
+        }
+    ],
+    title: 'Menu Bot',
+    footer: 'Versi 1.0'
+})
+
+// CTA URL Button
+await nl.sendNewsletterCtaUrl(JID, {
+    body: 'Kunjungi website kami untuk info lebih lanjut!',
+    buttonText: '🌐 Buka Website',
+    url: 'https://example.com',
+    title: 'Info Lengkap',
+    footer: 'Klik tombol di bawah'
+})
+```
+
+Atau langsung via `conn.sendMessage` dengan `interactiveMessage`:
+```js
+await conn.sendMessage(JID, {
+    interactiveMessage: {
+        nativeFlowMessage: {
+            buttons: [
+                {
+                    name: 'quick_reply',
+                    buttonParamsJson: JSON.stringify({ display_text: '✅ Ya', id: 'yes' })
+                },
+                {
+                    name: 'cta_url',
+                    buttonParamsJson: JSON.stringify({ display_text: 'Buka Link', url: 'https://example.com', merchant_url: 'https://example.com' })
+                }
+            ],
+            messageParamsJson: '',
+            messageVersion: 1
+        },
+        body: { text: 'Pilih aksi:' },
+        footer: { text: 'Footer text' }
+    }
+})
+```
+
+### Edit & Hapus Pesan Channel
+
+```js
+const nl = makeNewsletterUtils(conn)
+const JID = '120363xxxxxxxxx@newsletter'
+
+// Edit pesan (gunakan key.id dari pesan yang dikirim)
+const sent = await nl.sendNewsletterText(JID, 'Teks lama')
+await nl.editNewsletterMessage(JID, sent.key.id, 'Teks baru yang sudah diedit')
+
+// Hapus pesan
+await nl.deleteNewsletterMessage(JID, sent.key.id)
+
+// React ke pesan channel (gunakan server message ID dari event)
+await nl.sendNewsletterReact(JID, serverMessageId, '👍')
+// Unreact (kosongkan emoji)
+await nl.sendNewsletterReact(JID, serverMessageId, '')
+```
+
+Atau langsung via `conn.sendMessage`:
+```js
+// Edit
+await conn.sendMessage(JID, { text: 'Teks baru', edit: { remoteJid: JID, fromMe: true, id: messageId } })
+
+// Hapus
+await conn.sendMessage(JID, { delete: { remoteJid: JID, fromMe: true, id: messageId } })
+```
+
+---
+
+## Resolve JID
+
+Berguna untuk mengubah `@lid` format (format baru WA) menjadi JID `@s.whatsapp.net` yang bisa dipakai mengirim pesan.
+
+```js
+const { resolveJid, resolveJids } = require('@blckrose/baileys')
+
+// Resolve dari sender pesan (otomatis ambil dari m.sender / m.quoted / m.mentionedJid)
+const jid = await resolveJid(conn, m)
+if (!jid) return conn.sendMessage(m.chat, { text: 'Tidak bisa resolve JID.' }, { quoted: m })
+
+console.log(jid) // → '628xxxxxxxxxx@s.whatsapp.net'
+
+// Resolve target eksplisit (misal dari mention)
+const jid = await resolveJid(conn, m, m.mentionedJid?.[0])
+
+// Resolve banyak JID sekaligus
+const jids = await resolveJids(conn, m, m.mentionedJid)
+// → ['628xxx@s.whatsapp.net', '628yyy@s.whatsapp.net', null, ...]
+
+// Contoh pakai di handler
+let handler = async (m, { conn }) => {
+    const target = await resolveJid(conn, m, m.mentionedJid?.[0] || m.quoted?.sender)
+    if (!target) return conn.sendMessage(m.chat, { text: 'Tag atau reply seseorang.' }, { quoted: m })
+
+    await conn.sendMessage(m.chat, {
+        text: `JID target: ${target}`
+    }, { quoted: m })
+}
+```
+
+> [!NOTE]
+> `resolveJid` otomatis melakukan lookup ke `groupMetadata` jika JID berbentuk `@lid` di dalam grup. Butuh akses ke `conn` yang terkoneksi.
+
+---
+
 
-## Sending Messages
 
 - Send all types of messages with a single function
     - **[Here](https://baileys.whiskeysockets.io/types/AnyMessageContent.html) you can see all message contents supported, like text message**
@@ -516,6 +997,19 @@ await sock.sendMessage(
     }
 )
 ```
+#### Live Location Message
+```ts
+await sock.sendMessage(
+    jid, 
+    {
+        location: {
+            degreesLatitude: 24.121231,
+            degreesLongitude: 55.1121221
+        }, 
+        live: true
+    }
+)
+```
 #### Contact Message
 ```ts
 const vcard = 'BEGIN:VCARD\n' // metadata of the contact card
@@ -574,6 +1068,19 @@ await sock.sendMessage(
 )
 ```
 
+### Keep Message
+```ts
+await sock.sendMessage(
+    jid,
+    {
+        keep: {
+            key: Key,
+            type: 1 // or 2
+        }
+    }
+)
+```
+
 #### Poll Message
 ```ts
 await sock.sendMessage(
@@ -589,6 +1096,956 @@ await sock.sendMessage(
 )
 ```
 
+#### Poll Result Message
+```ts
+await sock.sendMessage(
+    jid, 
+    {
+        pollResult: {
+            name: 'Hi', 
+            values: [
+               [
+               'Option 1',
+               1000
+               ], 
+               [
+               'Option 2', 
+               2000
+               ]
+           ]
+        }
+    }
+)
+```
+
+### Call Message
+```ts
+await sock.sendMessage(
+    jid,
+    {
+        call: {
+            name: 'Hay',
+            type: 1 // 2 for video
+        }
+    }
+)
+```
+
+### Event Message
+```ts
+await sock.sendMessage(
+    jid,
+    {
+        event: {
+            isCanceled: false, // or true
+            name: 'holiday together!',
+            description: 'who wants to come along?', 
+            location: {
+                degreesLatitude: 24.121231,
+                degreesLongitude: 55.1121221,
+                name: 'name'
+            },
+            call: 'audio', // or 'video'
+            startTime: number, 
+            endTime: number, 
+            extraGuestsAllowed: true // or false
+        }
+    }
+)
+```
+
+### Order Message
+```ts
+await sock.sendMessage(
+    jid,
+    {
+        order: {
+            orderId: '574xxx',
+            thumbnail: 'your_thumbnail', 
+            itemCount: 'your_count',
+            status: 'your_status', // INQUIRY || ACCEPTED || DECLINED
+            surface: 'CATALOG',
+            message: 'your_caption',
+            orderTitle: "your_title",
+            sellerJid: 'your_jid',
+            token: 'your_token',
+            totalAmount1000: 'your_amount',
+            totalCurrencyCode: 'IDR'
+        }
+    }
+)
+```
+
+### Product Message
+```ts
+await sock.sendMessage(
+    jid,
+    {
+        product: {
+            productImage: {   // for using buffer >> productImage: your_buffer
+              url: your_url
+            },
+            productId: 'your_id', 
+            title: 'your_title',
+            description: 'your_description', 
+            currencyCode: 'IDR', 
+            priceAmount1000: 'your_amount', 
+            retailerId: 'your_reid', // optional use if needed
+            url: 'your_url', // optional use if needed
+            productImageCount: 'your_imageCount', 
+            firstImageId: 'your_image', // optional use if needed
+            salePriceAmount1000: 'your_priceSale', 
+            signedUrl: 'your_url' // optional use if needed
+        },
+       businessOwnerJid: 'your_jid' 
+    }
+)
+```
+
+### Payment Message
+```ts
+await sock.sendMessage(
+    jid,
+    {
+        payment: {
+            note: 'Hi!',
+            currency: 'IDR', // optional 
+            offset: 0, // optional
+            amount: '10000', // optional
+            expiry: 0, // optional
+            from: '628xxxx@s.whatsapp.net', // optional
+            image: { // optional
+               placeholderArgb: "your_background", // optional
+               textArgb: "your_text",  // optional
+               subtextArgb: "your_subtext" // optional
+            }
+        }
+    }
+)
+```
+
+#### Payment Invite Message
+```ts
+await sock.sendMessage(
+    id, 
+    { 
+        paymentInvite: {
+            type: number, // 1 || 2 || 3
+            expiry: 0 
+        }   
+    }
+)
+```
+
+### Admin Invite Message
+```ts
+await sock.sendMessage(
+    jid,
+    {
+        adminInvite: {
+            jid: '123xxx@newsletter',
+            name: 'newsletter_name', 
+            caption: 'Please be my channel admin',
+            expiration: 86400,
+            jpegThumbnail: Buffer // optional
+        }
+    }
+)
+```
+
+### Group Invite Message
+```ts
+await sock.sendMessage(
+    jid,
+    {
+        groupInvite: {
+            jid: '123xxx@g.us',
+            name: 'group_name', 
+            caption: 'Please Join My Whatsapp Group',
+            code: 'code_invite',
+            expiration: 86400,
+            jpegThumbnail: Buffer, // optional            
+        }
+    }
+)
+```
+
+### Sticker Pack Message
+```ts 
+// I don't know why the sticker doesn't appear
+await sock.sendMessage(
+    jid,
+    {
+        stickerPack: {
+            name: 'Hiii', 
+            publisher: 'By blckrose', 
+            description: 'Hello', 
+            cover: Buffer, // Image buffer
+            stickers: [{
+                sticker: { url: 'https://example.com/1234kjd.webp' }, 
+                emojis: ['❤'], // optional
+                accessibilityLabel: '', // optional
+                isLottie: Boolean, // optional
+                isAnimated: Boolean // optional
+            }, 
+            {
+                sticker: Buffer, 
+                emojis: ['❤'], // optional
+                accessibilityLabel: '', // optional
+                isLottie: Boolean, // optional
+                isAnimated: Boolean // optional
+            }]
+        }
+    }
+)
+```
+
+### Share Phone Number Message
+```ts
+await sock.sendMessage(
+    jid,
+    {
+        sharePhoneNumber: {
+        }
+    }
+)
+```
+
+### Request Phone Number Message
+```ts
+await sock.sendMessage(
+    jid,
+    {
+        requestPhoneNumber: {
+        }
+    }
+)
+```
+
+### Buttons Reply Message
+```ts
+// List
+await sock.sendMessage(
+    jid,
+    {
+        buttonReply: {
+            name: 'Hii', 
+            description: 'description', 
+            rowId: 'ID'
+       }, 
+       type: 'list'
+    }
+)
+// Plain
+await sock.sendMessage(
+    jid,
+    {
+        buttonReply: {
+            displayText: 'Hii', 
+            id: 'ID'
+       }, 
+       type: 'plain'
+    }
+)
+
+// Template
+await sock.sendMessage(
+    jid,
+    {
+        buttonReply: {
+            displayText: 'Hii', 
+            id: 'ID', 
+            index: 'number'
+       }, 
+       type: 'template'
+    }
+)
+
+// Interactive
+await sock.sendMessage(
+    jid,
+    {
+        buttonReply: {
+            body: 'Hii', 
+            nativeFlows: {
+                name: 'menu_options', 
+                paramsJson: JSON.stringify({ id: 'ID', description: 'description' }) 
+                version: 1 // 2 | 3
+            }
+       }, 
+       type: 'interactive'
+    }
+)
+```
+
+### Buttons Message
+```ts
+await sock.sendMessage(
+    jid,
+    {
+        text: 'This is a button message!',  // image: buffer or // image: { url: url } If you want to use images
+        caption: 'caption', // Use this if you are using an image or video
+        footer: 'Hello World!',  
+        buttons: [{ 
+            buttonId: 'Id1', 
+            buttonText: { 
+                 displayText: 'Button 1'
+              }
+          }, 
+          { 
+            buttonId: 'Id2', 
+            buttonText: { 
+                 displayText: 'Button 2'
+              }
+          }, 
+          { 
+            buttonId: 'Id3', 
+            buttonText: { 
+                 displayText: 'Button 3'
+              }
+         }]
+    }
+)
+```
+
+### Buttons List Message
+```ts
+// Just working in a private chat
+await sock.sendMessage(
+    jid,
+    {
+        text: 'This is a list!', 
+        footer: 'Hello World!', 
+        title: 'Amazing boldfaced list title', 
+        buttonText: 'Required, text on the button to view the list', 
+        sections: [
+           {
+         	title: 'Section 1',
+         	rows: [{
+                title: 'Option 1', 
+                rowId: 'option1'
+             },
+ 	        {
+                title: 'Option 2', 
+                rowId: 'option2', 
+                description: 'This is a description'
+           }]
+       },
+       {
+       	title: 'Section 2',
+       	rows: [{
+               title: 'Option 3', 
+               rowId: 'option3'
+           },
+	       {
+               title: 'Option 4', 
+               rowId: 'option4', 
+               description: 'This is a description V2'
+           }]
+       }]
+    }
+)
+```
+
+### Buttons Product List Message
+```ts
+// Just working in a private chat
+await sock.sendMessage(
+    jid,
+    {
+        text: 'This is a list!', 
+        footer: 'Hello World!', 
+        title: 'Amazing boldfaced list title', 
+        buttonText: 'Required, text on the button to view the list', 
+        productList: [{
+            title: 'This is a title', 
+            products: [
+               {
+                  productId: '1234'
+               }, 
+               {
+                  productId: '5678'
+               }
+            ]
+        }], 
+        businessOwnerJid: '628xxx@s.whatsapp.net', 
+        thumbnail: 'https://example.com/jdbenkksjs.jpg' // or buffer
+    }
+)
+```
+
+### Buttons Cards Message
+```ts
+await sock.sendMessage(
+    jid,
+    {
+        text: 'Body Message',
+        title: 'Title Message', 
+        subtile: 'Subtitle Message', 
+        footer: 'Footer Message',
+        cards: [
+           {
+              image: { url: 'https://example.com/jdbenkksjs.jpg' }, // or buffer
+              title: 'Title Cards',
+              body: 'Body Cards',
+              footer: 'Footer Cards',
+              buttons: [
+                  {
+                      name: 'quick_reply',
+                      buttonParamsJson: JSON.stringify({
+                         display_text: 'Display Button',
+                         id: 'ID'
+                      })
+                  },
+                  {
+                      name: 'cta_url',
+                      buttonParamsJson: JSON.stringify({
+                         display_text: 'Display Button',
+                         url: 'https://www.example.com'
+                      })
+                  }
+              ]
+           },
+           {
+              video: { url: 'https://example.com/jdbenkksjs.mp4' }, // or buffer
+              title: 'Title Cards',
+              body: 'Body Cards',
+              footer: 'Footer Cards',
+              buttons: [
+                  {
+                      name: 'quick_reply',
+                      buttonParamsJson: JSON.stringify({
+                         display_text: 'Display Button',
+                         id: 'ID'
+                      })
+                  },
+                  {
+                      name: 'cta_url',
+                      buttonParamsJson: JSON.stringify({
+                         display_text: 'Display Button',
+                         url: 'https://www.example.com'
+                      })
+                  }
+              ]
+           }
+        ]
+    }
+)
+```
+
+### Buttons Template Message
+```ts
+// This no longer works
+await sock.sendMessage(
+    jid,
+    {
+       text: 'This is a template message!', 
+       footer: 'Hello World!', 
+       templateButtons: [{
+           index: 1,
+           urlButton: {
+                displayText: 'Follow Me', 
+                url: 'https://whatsapp.com/channel/0029Vag9VSI2ZjCocqa2lB1y'
+             }, 
+         }, 
+         {
+            index: 2,
+            callButton: {
+                displayText: 'Call Me!', 
+                phoneNumber: '628xxx'
+            }, 
+        }, 
+        {
+           index: 3,
+           quickReplyButton: {
+                displayText: 'This is a reply, just like normal buttons!', 
+                id: 'id-like-buttons-message'
+            }, 
+       }]
+    }
+)
+```
+
+### Buttons Interactive Message
+```ts
+await sock.sendMessage(
+    jid,
+    {
+        text: 'This is an Interactive message!',
+        title: 'Hiii',
+        subtitle: 'There is a subtitle', 
+        footer: 'Hello World!',
+        interactiveButtons: [
+            {
+                name: 'quick_reply',
+                buttonParamsJson: JSON.stringify({
+                    display_text: 'Click Me!',
+                    id: 'your_id'
+                })
+            },
+            {
+                name: 'cta_url',
+                buttonParamsJson: JSON.stringify({
+                    display_text: 'Follow Me',
+                    url: 'https://whatsapp.com/channel/0029Vag9VSI2ZjCocqa2lB1y',
+                    merchant_url: 'https://whatsapp.com/channel/0029Vag9VSI2ZjCocqa2lB1y'
+                })
+            },
+            {
+                name: 'cta_copy',
+                buttonParamsJson: JSON.stringify({
+                    display_text: 'Click Me!',
+                    copy_code: 'https://whatsapp.com/channel/0029Vag9VSI2ZjCocqa2lB1y'
+                })
+            },
+            {
+                name: 'cta_call',
+                buttonParamsJson: JSON.stringify({
+                    display_text: 'Call Me!',
+                    phone_number: '628xxx'
+                })
+            },
+            {
+                name: 'cta_catalog',
+                buttonParamsJson: JSON.stringify({
+                    business_phone_number: '628xxx'
+                })
+            },
+            {
+                name: 'cta_reminder',
+                buttonParamsJson: JSON.stringify({
+                    display_text: '...'
+                })
+            },
+            {
+                name: 'cta_cancel_reminder',
+                buttonParamsJson: JSON.stringify({
+                    display_text: '...'
+                })
+            },
+            {
+                name: 'address_message',
+                buttonParamsJson: JSON.stringify({
+                    display_text: '...'
+                })
+            },
+            {
+                name: 'send_location',
+                buttonParamsJson: JSON.stringify({
+                    display_text: '...'
+                })
+            },
+            {
+                name: 'open_webview',
+                buttonParamsJson: JSON.stringify({
+                    title: 'Follow Me!',
+                    link: {
+                        in_app_webview: true, // or false
+                        url: 'https://whatsapp.com/channel/0029Vag9VSI2ZjCocqa2lB1y'
+                    }
+                })
+            },
+            {
+               name: 'mpm',
+               buttonParamsJson: JSON.stringify({
+                  product_id: '8816262248471474'
+               })
+            },
+            {
+               name: 'wa_payment_transaction_details',
+               buttonParamsJson: JSON.stringify({
+                  transaction_id: '12345848'
+               })
+            },
+            {
+               name: 'automated_greeting_message_view_catalog',
+               buttonParamsJson: JSON.stringify({
+                   business_phone_number: '628xxx', 
+                   catalog_product_id: '12345'
+               })
+            },
+            {
+                name: 'galaxy_message', 
+                buttonParamsJson: JSON.stringify({
+                	mode: 'published', 
+                    flow_message_version: '3', 
+                    flow_token: '1:1307913409923914:293680f87029f5a13d1ec5e35e718af3',
+                    flow_id: '1307913409923914',
+                    flow_cta: 'blckrose >', 
+                    flow_action: 'navigate', 
+                    flow_action_payload: {
+                    	screen: 'QUESTION_ONE',
+                        params: {
+                        	user_id: '123456789', 
+                            referral: 'campaign_xyz'
+                        }
+                    }, 
+                    flow_metadata: {
+                    	flow_json_version: '201', 
+                        data_api_protocol: 'v2', 
+                        flow_name: 'Lead Qualification [en]',
+                        data_api_version: 'v2', 
+                        categories: ['Lead Generation', 'Sales']
+                   }
+                }) 
+            }, 
+            {
+                name: 'single_select',
+                buttonParamsJson: JSON.stringify({
+                    title: 'Click Me!',
+                    sections: [
+                        {
+                            title: 'Title 1',
+                            highlight_label: 'Highlight label 1',
+                            rows: [
+                                {
+                                    header: 'Header 1',
+                                    title: 'Title 1',
+                                    description: 'Description 1',
+                                    id: 'Id 1'
+                                },
+                                {
+                                    header: 'Header 2',
+                                    title: 'Title 2',
+                                    description: 'Description 2',
+                                    id: 'Id 2'
+                                }
+                            ]
+                        }
+                    ]
+                })
+            }
+        ]
+    }
+)
+
+// If you want to use an image
+await sock.sendMessage(
+    jid, 
+    {
+       image: { 
+          url: 'https://example.com/jdbenkksjs.jpg' 
+       },
+       caption: 'Body',
+       title: 'Title',
+       subtitle: 'Subtitle', 
+       footer: 'Footer',
+       interactiveButtons: [
+           {
+               name: 'quick_reply',
+               buttonParamsJson: JSON.stringify({
+                   display_text: 'DisplayText',
+                   id: 'ID1'
+               })
+           }
+       ], 
+       hasMediaAttachment: false // or true
+    }
+)
+
+// If you want to use a video
+await sock.sendMessage(
+    jid, 
+    {
+        video: { 
+          url: 'https://example.com/jdbenkksjs.mp4' 
+       },
+       caption: 'Body',
+       title: 'Title', 
+       subtitle: 'Subtitle', 
+       footer: 'Footer',
+       interactiveButtons: [
+           {
+               name: 'quick_reply',
+               buttonParamsJson: JSON.stringify({
+                   display_text: 'DisplayText',
+                   id: 'ID1'
+               })
+           }
+       ], 
+       hasMediaAttachment: false // or true
+    }
+)
+
+// If you want to use a document
+await sock.sendMessage(
+    jid, 
+    {
+        document: { 
+          url: 'https://example.com/jdbenkksjs.jpg' 
+       }, 
+       mimetype: 'image/jpeg', 
+       caption: 'Body',
+       title: 'Title',
+       subtitle: 'Subtitle', 
+       footer: 'Footer',
+       interactiveButtons: [
+           {
+               name: 'quick_reply',
+               buttonParamsJson: JSON.stringify({
+                   display_text: 'DisplayText',
+                   id: 'ID1'
+               })
+           }
+       ], 
+       hasMediaAttachment: false // or true
+    }
+)
+
+// If you want to use a location
+await sock.sendMessage(
+    jid, 
+    {
+        location: { 
+          degreesLatitude: -0,
+          degreesLongitude: 0,
+          name: 'Hi'
+       },
+       caption: 'Body',
+       title: 'Title', 
+       subtitle: 'Subtitle', 
+       footer: 'Footer',
+       interactiveButtons: [
+           {
+               name: 'quick_reply',
+               buttonParamsJson: JSON.stringify({
+                   display_text: 'DisplayText',
+                   id: 'ID1'
+               })
+           }
+       ], 
+       hasMediaAttachment: false // or true
+    }
+)
+```
+
+### Buttons Interactive Message PIX
+```ts
+await sock.sendMessage( 
+    jid, 
+    { 
+       text: '', // This string is required. Even it's empty. 
+       interactiveButtons: [ 
+          { 
+             name: 'payment_info', 
+             buttonParamsJson: JSON.stringify({ 
+                payment_settings: [{ 
+                   type: "pix_static_code", 
+                   pix_static_code:  { 
+                      merchant_name: 'blckrose', 
+                      key: 'example@blckrose.com', 
+                      key_type: 'EMAIL' // PHONE || EMAIL || CPF || EVP 
+                   } 
+               }] 
+            }) 
+         } 
+      ], 
+   } 
+)
+ ```
+
+### Buttons Interactive Message PAY
+```ts
+await sock.sendMessage( 
+    jid, 
+    { 
+       text: '', // This string is required. Even it's empty. 
+       interactiveButtons: [ 
+          { 
+             name: 'review_and_pay', 
+             buttonParamsJson: JSON.stringify({ 
+                currency: 'IDR', 
+                payment_configuration: '', 
+                payment_type: '', 
+                total_amount: {
+                    value: '999999999',
+                    offset: '100'
+                }, 
+                reference_id: '45XXXXX',
+                type: 'physical-goods',
+                payment_method: 'confirm', 
+                payment_status: 'captured', 
+                payment_timestamp: Math.floor(Date.now() / 1000),
+                order: {
+                    status: 'completed', 
+                    description: '', 
+                    subtotal: {
+                        value: '0', 
+                        offset: '100'
+                    }, 
+                    order_type: 'PAYMENT_REQUEST', 
+                    items: [{
+                        retailer_id: 'your_retailer_id', 
+                        name: 'blckrose', 
+                        amount: {
+                            value: '999999999', 
+                            offset: '100'
+                        }, 
+                        quantity: '1', 
+                    }]
+                }, 
+                additional_note: 'blckrose', 
+                native_payment_methods: [], 
+                share_payment_status: false
+            }) 
+         } 
+      ], 
+   } 
+)
+ ```
+
+### Status Mentions Message
+```ts
+const jidat = [
+    '123451679@g.us', 
+    '124848899@g.us', 
+    '111384848@g.us', 
+    '62689xxxx@s.whatsapp.net', 
+    '62xxxxxxx@s.whatsapp.net'
+]
+// Text
+await sock.sendStatusMentions(
+    {
+      text: 'Hello Everyone :3', 
+      font: 2, // optional
+      textColor: 'FF0000', // optional
+      backgroundColor: '#000000' // optional
+    }, 
+    jids // Limit to 5 mentions per status
+)
+
+// Image
+await sock.sendStatusMentions(
+    {
+      Image: { url: 'https://example.com/ruriooe.jpg' }, // or image buffer
+      caption: 'Hello Everyone :3' // optional
+    }, 
+    jids // Limit to 5 mentions per status
+)
+
+// Video
+await sock.sendStatusMentions(
+    {
+      video: { url: 'https://example.com/ruriooe.mp4' }, // or video buffer
+      caption: 'Hello Everyone :3' // optional
+    }, 
+    jids // Limit to 5 mentions per status
+)
+
+// Audio
+await sock.sendStatusMentions(
+    {
+      audio: { url: 'https://example.com/ruriooe.mp3' }, // or audio buffer
+      backgroundColor: '#000000', // optional 
+      mimetype: 'audio/mp4', 
+      ppt: true
+    }, 
+    jids // Limit to 5 mentions per status
+)
+```
+
+### Shop Message
+```ts
+await sock.sendMessage(
+    jid, 
+    {      
+       text: 'Body',
+       title: 'Title', 
+       subtitle: 'Subtitle', 
+       footer: 'Footer',
+       shop: {
+          surface: 1, // 2 | 3 | 4
+          id: 'https://example.com'
+       }, 
+       viewOnce: true
+    }
+)
+
+// Image
+await sock.sendMessage(
+    jid, 
+    { 
+       image: {
+          url: 'https://example.com/jdbenkksjs.jpg'
+       },    
+       caption: 'Body',
+       title: 'Title', 
+       subtitle: 'Subtitle', 
+       footer: 'Footer',
+       shop: {
+          surface: 1, // 2 | 3 | 4
+          id: 'https://example.com'
+       }, 
+       hasMediaAttachment: false, // or true
+       viewOnce: true
+    }
+)
+```
+
+### Collection Message
+```ts
+await sock.sendMessage(
+    jid, 
+    {      
+       text: 'Body',
+       title: 'Title', 
+       subtitle: 'Subtitle', 
+       footer: 'Footer',
+       collection: {
+          bizJid: 'jid', 
+          id: 'https://example.com', 
+          version: 1
+       }, 
+       viewOnce: true
+    }
+)
+
+// Image
+await sock.sendMessage(
+    jid, 
+    { 
+       image: {
+          url: 'https://example.com/jdbenkksjs.jpg'
+       },    
+       caption: 'Body',
+       title: 'Title', 
+       subtitle: 'Subtitle', 
+       footer: 'Footer',
+       collection: {
+          bizJid: 'jid', 
+          id: 'https://example.com', 
+          version: 1
+       }, 
+       hasMediaAttachment: false, // or true
+       viewOnce: true
+    }
+)
+```
+
+### AI Icon Feature
+```ts
+await sock.sendMessage(
+    jid,
+    {
+        text: 'Hi'
+    }, {
+    ai: true // Add ai usage and change it to true
+    }
+)
+
+// If using relay
+await sock.relayMessage(
+    jid,
+    {
+        extendedTextMessage: {
+            text: 'Hi'
+        }
+    }, {
+    AI: true // Use capital letters
+    }
+)
+```
+
 ### Sending Messages with Link Previews
 
 1. By default, wa does not have link generation when sent from the web
@@ -680,6 +2137,45 @@ await sock.sendMessage(
 )
 ```
 
+### Album Message
+```ts
+await sock.sendMessage(
+    id, 
+    { 
+        album: [{
+        	image: {
+        		url: 'https://example.com/blckrose.jpg'
+        	}, 
+        	caption: 'Hay'
+        }, {
+        	image: Buffer, 
+        	caption: 'Hay'
+        }, {
+        	video: {
+        		url: 'https://example.com/blckrose.mp4'
+        	}, 
+        	caption: 'Hay'
+        }, {
+        	video: Buffer, 
+        	caption: 'Hay'
+        }]
+    }
+)
+```
+
+#### Ptv Video Message
+```ts
+await sock.sendMessage(
+    id, 
+    { 
+        video: {
+            url: './Media/ma_gif.mp4'
+        },
+        ptv: true	    
+    }
+)
+```
+
 #### View Once Message
 
 - You can send all messages above as `viewOnce`, you only need to pass `viewOnce: true` in content object
@@ -924,6 +2420,11 @@ await sock.sendMessage(
 )
 ```
 
+### Clear Messages
+```ts
+await sock.clearMessage(jid, key, timestamps) 
+```
+
 ## User Querys
 
 ### Check If ID Exists in Whatsapp