@aseppxyzz12/baileys 1.1.8

package/README.md

@@ -0,0 +1,2579 @@
+# <div align='center'>AsepXyz Baileys - A WebSockets library for interacting with WhatsApp Web</div>
+
+<div align="center">
+
+
+**AsepXyz Baileys** is a fast, stable, and modern interactive-feature-focused WhatsApp Web API library built on WebSocket.
+
+</div>
+
+## Example
+
+Do check out & run [example.js](Example/example.js) to see an example usage of the library.
+The script covers most common use cases.
+To run the example script, download or clone the repo and then type the following in a terminal:
+
+```bash
+cd path/to/AsepXyz Baileys
+node example.js
+```
+
+## Install
+
+Use the stable version:
+
+```
+npm install AsepXyz
+```
+
+Use the edge version (no guarantee of stability, but latest fixes + features)
+
+```
+npm install github:AsepXyz
+```
+
+Then import your code using:
+
+```js
+import makeWASocket from 'AsepXyz'
+```
+
+# Links
+
+- [WhatsApp](https://wa.me/628138045539)
+- [Telegram](https://t.me/lepicode)
+- [Docs](https://guide.whiskeysockets.io/)
+
+## Connecting Account
+
+WhatsApp provides a multi-device API that allows Baileys to be authenticated as a second WhatsApp client by scanning a **QR code** or **Pairing Code** with WhatsApp on your phone.
+
+> [!NOTE]
+> **[Here](#example-to-start) is a simple example of event handling**
+
+> [!TIP]
+> **You can see all supported socket configs [here](https://baileys.whiskeysockets.io/types/SocketConfig.html) (Recommended)**
+
+### Starting socket with **QR-CODE**
+
+> [!TIP]
+> You can customize browser name if you connect with **QR-CODE**, with `Browser` constant, we have some browsers config, **see [here](https://baileys.whiskeysockets.io/types/BrowsersMap.html)**
+
+```js
+import makeWASocket from 'AsepXyz'
+
+const conn = makeWASocket({
+    // can provide additional config here
+    browser: Browsers.ubuntu('My App'),
+    printQRInTerminal: true,
+})
+```
+
+If the connection is successful, you will see a QR code printed on your terminal screen, scan it with WhatsApp on your phone and you'll be logged in!
+
+### Starting socket with **Pairing Code**
+
+> [!IMPORTANT]
+> Pairing Code isn't Mobile API, it's a method to connect Whatsapp Web without QR-CODE, you can connect only with one device, see [here](https://faq.whatsapp.com/1324084875126592/?cms_platform=web)
+
+The phone number can't have `+` or `()` or `-`, only numbers, you must provide country code
+
+```js
+import makeWASocket from 'AsepXyz'
+
+const conn = makeWASocket({
+    // can provide additional config here
+    printQRInTerminal: false, //need to be false
+})
+
+if (!conn.authState.creds.registered) {
+    const number = 'XXXXXXXXXXX'
+    const code = await conn.requestPairingCode(number) // or await conn.requestPairingCode(number, 'CODEOTPS') custom your pairing code
+    console.log(code)
+}
+```
+
+### Receive Full History
+
+1. Set `syncFullHistory` as `true`
+2. Baileys, by default, use chrome browser config
+    - If you'd like to emulate a desktop connection (and receive more message history), this browser setting to your Socket config:
+
+```js
+const conn = makeWASocket({
+    ...otherOpts,
+    // can use Windows, Ubuntu here too
+    browser: Browsers.macOS('Desktop'),
+    syncFullHistory: true,
+})
+```
+
+## Important Notes About Socket Config
+
+### Caching Group Metadata (Recommended)
+
+- If you use baileys for groups, we recommend you to set `cachedGroupMetadata` in socket config, you need to implement a cache like this:
+
+    ```js
+    const groupCache = new NodeCache({ stdTTL: 5 * 60, useClones: false })
+
+    const conn = makeWASocket({
+        cachedGroupMetadata: async (jid) => groupCache.get(jid),
+    })
+
+    conn.ev.on('groups.update', async ([event]) => {
+        const metadata = await conn.groupMetadata(event.id)
+        groupCache.set(event.id, metadata)
+    })
+
+    conn.ev.on('group-participants.update', async (event) => {
+        const metadata = await conn.groupMetadata(event.id)
+        groupCache.set(event.id, metadata)
+    })
+    ```
+
+### Improve Retry System & Decrypt Poll Votes
+
+- If you want to improve sending message, retrying when error occurs and decrypt poll votes, you need to have a store and set `getMessage` config in socket like this:
+    ```js
+    const conn = makeWASocket({
+        getMessage: async (key) => await getMessageFromStore(key),
+    })
+    ```
+
+### Receive Notifications in Whatsapp App
+
+- If you want to receive notifications in whatsapp app, set `markOnlineOnConnect` to `false`
+    ```js
+    const conn = makeWASocket({
+        markOnlineOnConnect: false,
+    })
+    ```
+
+## Saving & Restoring Sessions
+
+You obviously don't want to keep scanning the QR code every time you want to connect.
+
+So, you can load the credentials to log back in:
+
+```js
+import makeWASocket, { useMultiFileAuthState } from 'AsepXyz'
+
+const { state, saveCreds } = await useMultiFileAuthState('auth_info_baileys')
+
+// will use the given state to connect
+// so if valid credentials are available -- it'll connect without QR
+const conn = makeWASocket({ auth: state })
+
+// this will be called as soon as the credentials are updated
+conn.ev.on('creds.update', saveCreds)
+```
+
+> [!IMPORTANT]
+> `useMultiFileAuthState` is a utility function to help save the auth state in a single folder, this function serves as a good guide to help write auth & key states for SQL/no-SQL databases, which I would recommend in any production grade system.
+
+> [!NOTE]
+> When a message is received/sent, due to signal sessions needing updating, the auth keys (`authState.keys`) will update. Whenever that happens, you must save the updated keys (`authState.keys.set()` is called). Not doing so will prevent your messages from reaching the recipient & cause other unexpected consequences. The `useMultiFileAuthState` function automatically takes care of that, but for any other serious implementation -- you will need to be very careful with the key state management.
+
+## Handling Events
+
+- Baileys uses the EventEmitter syntax for events.
+  They're all nicely typed up, so you shouldn't have any issues with an Intellisense editor like VS Code.
+
+> [!IMPORTANT]
+> **The events are [these](https://baileys.whiskeysockets.io/types/BaileysEventMap.html)**, it's important you see all events
+
+You can listen to these events like this:
+
+```js
+const conn = makeWASocket()
+conn.ev.on('messages.upsert', ({ messages }) => {
+    console.log('got messages', messages)
+})
+```
+
+### Example to Start
+
+> [!NOTE]
+> This example includes basic auth storage too
+
+```js
+import makeWASocket, { DisconnectReason, useMultiFileAuthState } from 'AsepXyz'
+import { Boom } from '@hapi/boom'
+
+async function connectToWhatsApp () {
+    const { state, saveCreds } = await useMultiFileAuthState('./auth_info_baileys')
+    const conn = makeWASocket({
+        // can provide additional config here
+        auth: state,
+        printQRInTerminal: true
+    })
+    conn.ev.on('connection.update', (update) => {
+        const { connection, lastDisconnect } = update
+        if(connection === 'close') {
+            const shouldReconnect = (lastDisconnect.error as Boom)?.output?.statusCode !== DisconnectReason.loggedOut
+            console.log('connection closed due to ', lastDisconnect.error, ', reconnecting ', shouldReconnect)
+            // reconnect if not logged out
+            if(shouldReconnect) {
+                connectToWhatsApp()
+            }
+        } else if(connection === 'open') {
+            console.log('opened connection')
+        }
+    })
+    conn.ev.on('messages.upsert', event => {
+        for (const m of event.messages) {
+            console.log(JSON.stringify(m, undefined, 2))
+
+            console.log('replying to', m.key.remoteJid)
+            await conn.sendMessage(m.key.remoteJid!, { text: 'Hello Word' })
+        }
+    })
+
+    // to storage creds (session info) when it updates
+    conn.ev.on('creds.update', saveCreds)
+}
+// run in main file
+connectToWhatsApp()
+```
+
+> [!IMPORTANT]
+> In `messages.upsert` it's recommended to use a loop like `for (const message of event.messages)` to handle all messages in array
+
+### Decrypt Poll Votes
+
+- By default poll votes are encrypted and handled in `messages.update`
+
+```js
+import pino from 'pino'
+import { makeInMemoryStore, getAggregateVotesInPollMessage } from 'AsepXyz'
+
+const logger = pino({ timestamp: () => `,"time":"${new Date().toJSON()}"` }).child({
+    class: 'AsepXyz',
+})
+logger.level = 'fatal'
+const store = makeInMemoryStore({ logger })
+
+async function getMessage(key) {
+    if (store) {
+        const msg = await store.loadMessage(key.remoteJid, key.id)
+        return msg?.message
+    }
+    return {
+        conversation: 'AsepXyz',
+    }
+}
+
+conn.ev.on('messages.update', async (chatUpdate) => {
+    for (const { key, update } of chatUpdate) {
+        if (update.pollUpdates && key.fromMe) {
+            const pollCreation = await getMessage(key)
+            if (pollCreation) {
+                const pollUpdate = await getAggregateVotesInPollMessage({
+                    message: pollCreation,
+                    pollUpdates: update.pollUpdates,
+                })
+                const toCmd = pollUpdate.filter((v) => v.voters.length !== 0)[0]?.name
+                if (toCmd == undefined) return
+                console.log(toCmd)
+            }
+        }
+    }
+})
+```
+
+### Decrypt Event Response
+
+- By default event response are encrypted and handled in `messages.update`
+
+```js
+import { jidNormalizedUser, getAggregateResponsesInEventMessage } from 'AsepXyz'
+
+conn.ev.on('messages.update', async ([chatUpdate]) => {
+    const eventResponses = chatUpdate.update?.eventResponses
+    const agregate = getAggregateResponsesInEventMessage(
+        { eventResponses },
+        jidNormalizedUser(conn.user.lid)
+    )
+    console.log(agregate)
+})
+```
+
+### Summary of Events on First Connection
+
+1. When you connect first time, `connection.update` will be fired requesting you to restart sock
+2. Then, history messages will be received in `messaging.history-set`
+
+## Implementing a Data Store
+
+- Baileys does not come with a defacto storage for chats, contacts, or messages. However, a simple in-memory implementation has been provided. The store listens for chat updates, new messages, message updates, etc., to always have an up-to-date version of the data.
+
+> [!IMPORTANT]
+> I highly recommend building your own data store, as storing someone's entire chat history in memory is a terrible waste of RAM.
+
+It can be used as follows:
+
+```js
+import makeWASocket, { makeInMemoryStore } from 'AsepXyz'
+// the store maintains the data of the WA connection in memory
+// can be written out to a file & read from it
+const store = makeInMemoryStore({})
+// can be read from a file
+store.readFromFile('./baileys_store.json')
+// saves the state to a file every 10s
+setInterval(() => {
+    store.writeToFile('./baileys_store.json')
+}, 10_000)
+
+const conn = makeWASocket({})
+// will listen from this socket
+// the store can listen from a new socket once the current socket outlives its lifetime
+store.bind(conn.ev)
+
+conn.ev.on('chats.upsert', () => {
+    // can use 'store.chats' however you want, even after the socket dies out
+    // 'chats' => a KeyedDB instance
+    console.log('got chats', store.chats.all())
+})
+
+conn.ev.on('contacts.upsert', () => {
+    console.log('got contacts', Object.values(store.contacts))
+})
+```
+
+The store also provides some simple functions such as `loadMessages` that utilize the store to speed up data retrieval.
+
+## Whatsapp IDs Explain
+
+- `id` is the WhatsApp ID, called `jid` too, of the person or group you're sending the message to.
+    - It must be in the format `[country code][phone number]@s.whatsapp.net`
+        - Example for people: `+19999999999@s.whatsapp.net`.
+        - For groups, it must be in the format `123456789-123345@g.us`.
+    - For broadcast lists, it's `[timestamp of creation]@broadcast`.
+    - For stories, the ID is `status@broadcast`.
+
+## Utility Functions
+
+- `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
+
+## 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**
+    - **[Here](https://baileys.whiskeysockets.io/types/MiscMessageGenerationOptions.html) you can see all options supported, like quote message**
+
+    ```js
+    const jid: string
+    const content: AnyMessageContent
+    const options: MiscMessageGenerationOptions
+
+    conn.sendMessage(jid, content, options)
+    ```
+
+### Non-Media Messages
+
+#### Text Message
+
+```js
+await conn.sendMessage(jid, { text: 'hello word' })
+```
+
+#### Quote Message (works with all types)
+
+```js
+await conn.sendMessage(jid, { text: 'hello word' }, { quoted: message })
+```
+
+#### Mention User (works with most types)
+
+- @number is to mention in text, it's optional
+
+```js
+await conn.sendMessage(jid, {
+    text: '@12345678901',
+    mentions: ['12345678901@s.whatsapp.net'],
+})
+```
+
+#### Forward Messages
+
+- You need to have message object, can be retrieved from [store](#implementing-a-data-store) or use a [message](https://baileys.whiskeysockets.io/types/WAMessage.html) object
+
+```js
+const msg = getMessageFromStore() // implement this on your end
+await conn.sendMessage(jid, { forward: msg, force: true or number }) // WA forward the message!
+```
+
+#### Location Message
+
+```js
+await conn.sendMessage(jid, {
+    location: {
+        degreesLatitude: 24.121231,
+        degreesLongitude: 55.1121221,
+    },
+})
+```
+
+#### Live Location Message
+
+```js
+await conn.sendMessage(jid, {
+    location: {
+        degreesLatitude: 24.121231,
+        degreesLongitude: 55.1121221,
+    },
+    live: true,
+})
+```
+
+#### Contact Message
+
+```js
+const vcard =
+    'BEGIN:VCARD\n' + // metadata of the contact card
+    'VERSION:3.0\n' +
+    'FN:Jeff Singh\n' + // full name
+    'ORG:Ashoka Uni\n' + // the organization of the contact
+    'TELtype=CELLtype=VOICEwaid=911234567890:+91 12345 67890\n' + // WhatsApp ID + phone number
+    'END:VCARD'
+
+await conn.sendMessage(id, {
+    contacts: {
+        displayName: 'AsepXyz Baileys',
+        contacts: [{ vcard }],
+    },
+})
+```
+
+#### Reaction Message
+
+- You need to pass the key of message, you can retrieve from [store](#implementing-a-data-store) or use a [key](https://baileys.whiskeysockets.io/types/WAMessageKey.html) object
+
+```js
+await conn.sendMessage(jid, {
+    react: {
+        text: '💖', // use an empty string to remove the reaction
+        key: message.key,
+    },
+})
+```
+
+#### Pin Message
+
+- You need to pass the key of message, you can retrieve from [store](#implementing-a-data-store) or use a [key](https://baileys.whiskeysockets.io/types/WAMessageKey.html) object
+
+- Time can be:
+
+| Time | Seconds   |
+| ---- | --------- |
+| 24h  | 86.400    |
+| 7d   | 604.800   |
+| 30d  | 2.592.000 |
+
+```js
+await conn.sendMessage(jid, {
+    pin: {
+        type: 1, // 2 to remove
+        time: 86400,
+        key: Key,
+    },
+})
+```
+
+### Keep Message
+
+```js
+await conn.sendMessage(jid, {
+    keep: {
+        key: Key,
+        type: 1, // or 2
+    },
+})
+```
+
+#### Poll Message
+
+```js
+await conn.sendMessage(
+    jid,
+    {
+        poll: {
+            name: 'My Poll',
+            values: ['Option 1', 'Option 2', ...],
+            selectableCount: 1,
+            toAnnouncementGroup: false // or true
+        }
+    }
+)
+```
+
+#### Poll Result Message
+
+```js
+await conn.sendMessage(jid, {
+    pollResult: {
+        name: 'Hi',
+        values: [
+            ['Option 1', 1000],
+            ['Option 2', 2000],
+        ],
+    },
+})
+```
+
+### Call Message
+
+```js
+await conn.sendMessage(jid, {
+    call: {
+        name: 'Hay',
+        type: 1, // 2 for video
+    },
+})
+```
+
+### Event Message
+
+```js
+await conn.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
+
+```js
+await conn.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
+
+```js
+await conn.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
+
+```js
+await conn.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
+
+```js
+await conn.sendMessage(id, {
+    paymentInvite: {
+        type: number, // 1 || 2 || 3
+        expiry: 0,
+    },
+})
+```
+
+### Admin Invite Message
+
+```js
+await conn.sendMessage(jid, {
+    adminInvite: {
+        jid: '123xxx@newsletter',
+        name: 'newsletter_name',
+        caption: 'Please be my channel admin',
+        expiration: 86400,
+        jpegThumbnail: Buffer, // optional
+    },
+})
+```
+
+### Group Invite Message
+
+```js
+await conn.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
+
+```js
+// I don't know why the sticker doesn't appear
+await conn.sendMessage(jid, {
+    stickerPack: {
+        name: 'Hiii',
+        publisher: 'AsepXyz Baileys',
+        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
+
+```js
+await conn.sendMessage(jid, {
+    sharePhoneNumber: {},
+})
+```
+
+### Request Phone Number Message
+
+```js
+await conn.sendMessage(jid, {
+    requestPhoneNumber: {},
+})
+```
+
+### Buttons Reply Message
+
+```js
+// List
+await conn.sendMessage(
+    jid,
+    {
+        buttonReply: {
+            name: 'Hii',
+            description: 'description',
+            rowId: 'ID'
+       },
+       type: 'list'
+    }
+)
+// Plain
+await conn.sendMessage(
+    jid,
+    {
+        buttonReply: {
+            displayText: 'Hii',
+            id: 'ID'
+       },
+       type: 'plain'
+    }
+)
+
+// Template
+await conn.sendMessage(
+    jid,
+    {
+        buttonReply: {
+            displayText: 'Hii',
+            id: 'ID',
+            index: 'number'
+       },
+       type: 'template'
+    }
+)
+
+// Interactive
+await conn.sendMessage(
+    jid,
+    {
+        buttonReply: {
+            body: 'Hii',
+            nativeFlows: {
+                name: 'menu_options',
+                paramsJson: JSON.stringify({ id: 'ID', description: 'description' })
+                version: 1 // 2 | 3
+            }
+       },
+       type: 'interactive'
+    }
+)
+```
+
+### Buttons Message
+
+```js
+await conn.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
+
+```js
+// Just working in a private chat
+await conn.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
+
+```js
+// Just working in a private chat
+await conn.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
+
+```js
+await conn.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
+
+```js
+// This no longer works
+await conn.sendMessage(jid, {
+    text: 'This is a template message!',
+    footer: 'Hello World!',
+    templateButtons: [
+        {
+            index: 1,
+            urlButton: {
+                displayText: 'Follow Me',
+                url: 'https://whatsapp.com/channel/0029Vb7JPWCAInPfKWC14s2V,
+            },
+        },
+        {
+            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
+
+```js
+await conn.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/0029Vb7JPWCAInPfKWC14s2V,
+                merchant_url: 'https://whatsapp.com/channel/0029Vb7JPWCAInPfKWC14s2V,
+            }),
+        },
+        {
+            name: 'cta_copy',
+            buttonParamsJson: JSON.stringify({
+                display_text: 'Click Me!',
+                copy_code: 'https://whatsapp.com/channel/0029Vb7JPWCAInPfKWC14s2V,
+            }),
+        },
+        {
+            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/0029Vb7JPWCAInPfKWC14s2V,
+                },
+            }),
+        },
+        {
+            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: 'AsepXyz Baileys',
+                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 conn.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 an video
+await conn.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 an document
+await conn.sendMessage(jid, {
+    document: {
+        url: 'https://example.com/jdbenkksjs.jpg',
+    },
+    mimetype: 'image/jpeg',
+    jpegThumbnail: await conn.resize('https://example.com/jdbenkksjs.jpg', 320, 320),
+    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 an location
+await conn.sendMessage(jid, {
+    location: {
+        degressLatitude: -0,
+        degressLongitude: 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
+})
+
+// if you want to use an product
+await conn.sendMessage(jid, {
+    product: {
+        productImage: {
+            url: 'https://example.com/jdbenkksjs.jpg',
+        },
+        productId: '836xxx',
+        title: 'Title',
+        description: 'Description',
+        currencyCode: 'IDR',
+        priceAmount1000: '283xxx',
+        retailerId: 'AsepXyz Baileys',
+        url: 'https://example.com',
+        productImageCount: 1,
+    },
+    businessOwnerJid: '628xxx@s.whatsapp.net',
+    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
+
+```js
+await conn.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: 'AsepXyz Baileys',
+                            key: 'example@AsepXyz Baileys.com',
+                            key_type: 'EMAIL', // PHONE || EMAIL || CPF || EVP
+                        },
+                    },
+                ],
+            }),
+        },
+    ],
+})
+```
+
+### Buttons Interactive Message PAY
+
+```js
+await conn.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: 'AsepXyz Baileys',
+                            amount: {
+                                value: '999999999',
+                                offset: '100',
+                            },
+                            quantity: '1',
+                        },
+                    ],
+                },
+                additional_note: 'AsepXyz Baileys',
+                native_payment_methods: [],
+                share_payment_status: false,
+            }),
+        },
+    ],
+})
+```
+
+### Status Mentions Message
+
+```js
+const jidat = [
+    '123451679@g.us',
+    '124848899@g.us',
+    '111384848@g.us',
+    '62689xxxx@s.whatsapp.net',
+    '62xxxxxxx@s.whatsapp.net'
+]
+// Text
+await conn.sendStatusMentions(
+    {
+      text: 'Hello Everyone :3',
+      font: 2, // optional
+      textColor: 'FF0000', // optional
+      backgroundColor: '#000000' // optional
+    },
+    jids // Limit to 5 mentions per status
+)
+
+// Image
+await conn.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 conn.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 conn.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
+
+```js
+await conn.sendMessage(jid, {
+    text: 'Body',
+    title: 'Title',
+    subtitle: 'Subtitle',
+    footer: 'Footer',
+    shop: {
+        surface: 1, // 2 | 3 | 4
+        id: 'https://example.com',
+    },
+    viewOnce: true,
+})
+
+// Image
+await conn.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,
+})
+
+// Video
+await conn.sendMessage(jid, {
+    video: {
+        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,
+})
+
+// Document
+await conn.sendMessage(jid, {
+    document: {
+        url: 'https://example.com/jdbenkksjs.jpg',
+    },
+    mimetype: 'image/jpeg',
+    jpegThumbnail: await conn.resize('https://example.com/jdbenkksjs.jpg', 320, 320),
+    caption: 'Body',
+    title: 'Title',
+    subtitle: 'Subtitle',
+    footer: 'Footer',
+    shop: {
+        surface: 1, // 2 | 3 | 4
+        id: 'https://example.com',
+    },
+    hasMediaAttachment: false, // or true,
+    viewOnce: true,
+})
+
+// Location
+await conn.sendMessage(jid, {
+    location: {
+        degressLatitude: -0,
+        degressLongitude: 0,
+        name: 'Hi',
+    },
+    caption: 'Body',
+    title: 'Title',
+    subtitle: 'Subtitle',
+    footer: 'Footer',
+    shop: {
+        surface: 1, // 2 | 3 | 4
+        id: 'https://example.com',
+    },
+    hasMediaAttachment: false, // or true
+    viewOnce: true,
+})
+
+// Product
+await conn.sendMessage(jid, {
+    product: {
+        productImage: {
+            url: 'https://example.com/jdbenkksjs.jpg',
+        },
+        productId: '836xxx',
+        title: 'Title',
+        description: 'Description',
+        currencyCode: 'IDR',
+        priceAmount1000: '283xxx',
+        retailerId: 'AsepXyz Baileys',
+        url: 'https://example.com',
+        productImageCount: 1,
+    },
+    businessOwnerJid: '628xxx@s.whatsapp.net',
+    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
+
+```js
+await conn.sendMessage(jid, {
+    text: 'Body',
+    title: 'Title',
+    subtitle: 'Subtitle',
+    footer: 'Footer',
+    collection: {
+        bizJid: 'jid',
+        id: 'https://example.com',
+        version: 1,
+    },
+    viewOnce: true,
+})
+
+// Image
+await conn.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,
+})
+
+// Video
+await conn.sendMessage(jid, {
+    video: {
+        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,
+})
+
+// Document
+await conn.sendMessage(jid, {
+    document: {
+        url: 'https://example.com/jdbenkksjs.jpg',
+    },
+    mimetype: 'image/jpeg',
+    jpegThumbnail: await conn.resize('https://example.com/jdbenkksjs.jpg', 320, 320),
+    caption: 'Body',
+    title: 'Title',
+    subtitle: 'Subtitle',
+    footer: 'Footer',
+    collection: {
+        bizJid: 'jid',
+        id: 'https://example.com',
+        version: 1,
+    },
+    hasMediaAttachment: false, // or true,
+    viewOnce: true,
+})
+
+// Location
+await conn.sendMessage(jid, {
+    location: {
+        degressLatitude: -0,
+        degressLongitude: 0,
+        name: 'Hi',
+    },
+    caption: 'Body',
+    title: 'Title',
+    subtitle: 'Subtitle',
+    footer: 'Footer',
+    collection: {
+        bizJid: 'jid',
+        id: 'https://example.com',
+        version: 1,
+    },
+    hasMediaAttachment: false, // or true
+    viewOnce: true,
+})
+
+// Product
+await conn.sendMessage(jid, {
+    product: {
+        productImage: {
+            url: 'https://example.com/jdbenkksjs.jpg',
+        },
+        productId: '836xxx',
+        title: 'Title',
+        description: 'Description',
+        currencyCode: 'IDR',
+        priceAmount1000: '283xxx',
+        retailerId: 'AsepXyz Baileys',
+        url: 'https://example.com',
+        productImageCount: 1,
+    },
+    businessOwnerJid: '628xxx@s.whatsapp.net',
+    caption: 'Body',
+    title: 'Title',
+    subtitle: 'Subtitle',
+    footer: 'Footer',
+    collection: {
+        bizJid: 'jid',
+        id: 'https://example.com',
+        version: 1,
+    },
+    hasMediaAttachment: false, // or true
+    viewOnce: true,
+})
+```
+
+---
+
+# Rich Message
+
+Rich Message adalah fitur UI premium pada AsepXyz Baileys yang mendukung markdown, code block, table, images, video, product card, social post, reels, sources, suggestions, dan tip dalam satu pesan.
+
+## Full Example
+
+```js
+conn.sendMessage(m.chat, {
+  richMessage: {
+    title: 'AsepXyz AI',
+    text: '# AsepXyz AI\nHalo Website dan sumber ',
+
+    code: {
+      language: 'javascript',
+      code: `const levvi = "AsepXyz";
+console.log(\`Hello \${levvi}!\`);`
+    },
+
+    table: [
+      ['Nama', 'Role'],
+      ['AsepXyz', 'Developer']
+    ],
+
+    images: [
+      'https://example.com/image.jpg'
+    ],
+
+    video: 'https://example.com/video.mp4',
+
+    product: {
+      title: 'Jasa Bot',
+      brand: 'AsepXyz',
+      price: '50k',
+      sale_price: '35k',
+      product_url: 'https://www.asepxyz.cloud/',
+      image: {
+        url: 'https://example.com/product.jpg'
+      },
+      additional_images: [
+        {
+          url: 'https://example.com/product-2.jpg'
+        }
+      ]
+    },
+
+    post: {
+      title: 'Update',
+      subtitle: 'v2.0',
+      username: 'asepxyz',
+      profile_picture_url: 'https://example.com/profile.jpg',
+      is_verified: true,
+      thumbnail_url: 'https://example.com/thumbnail.jpg',
+      post_caption: 'Update besar!',
+      likes_count: 1,
+      comments_count: 0,
+      shares_count: 0,
+      post_url: 'https://www.asepxyz.cloud/',
+      post_deeplink: 'asepxyz://',
+      source_app: 'INSTAGRAM',
+      footer_label: 'Baru',
+      footer_icon: 'https://example.com/footer.jpg',
+      is_carousel: false,
+      orientation: 'LANDSCAPE',
+      post_type: 'IMAGE'
+    },
+
+    reels: [
+      {
+        title: 'AsepXyz',
+        profileIconUrl: 'https://example.com/reel-profile-1.jpg',
+        thumbnailUrl: 'https://example.com/reel-thumb-1.jpg',
+        videoUrl: 'https://example.com/reel-1.mp4',
+        reels_title: 'Demo 1',
+        likes_count: 12,
+        shares_count: 5,
+        view_count: 99,
+        reel_source: 'IG',
+        is_verified: true
+      }
+    ],
+
+    sources: [
+      [
+        'https://example.com/github.ico',
+        'https://github.com/AsepXyz',
+        'GitHub'
+      ]
+    ],
+
+    tip: '💡 Tips: Gunakan kode LEVVI untuk diskon!',
+
+    suggestions: [
+      'Coba fitur baru',
+      'Hubungi admin',
+      'Lihat produk'
+    ],
+
+    footer: '© 2025 AsepXyz. All rights reserved.'
+  }
+}, { quoted: m })
+```
+
+---
+
+# Order Status Message
+
+Mengirim kartu status pesanan dengan tampilan native WhatsApp.
+
+## Example
+
+```js
+conn.sendMessage(m.chat, {
+  orderStatus: {
+    image: 'src/img/menu.jpg',
+    title: 'AsepXyz Shop',
+    text: 'Silakan cek status pesanan Anda.',
+    footer: 'Powered by AsepXyz',
+    referenceId: 'LV-001',
+    status: 'PROCESSING',
+    subtotalValue: 10000,
+    subtotalOffset: 100,
+    taxValue: 0,
+    taxOffset: 100,
+    currency: 'IDR'
+  }
+}, { quoted: m })
+```
+
+
+
+### AI Icon Feature
+
+```js
+await conn.sendMessage(
+    jid,
+    {
+        text: 'Hi',
+    },
+    {
+        ai: true, // Add ai usage and change it to true
+    }
+)
+
+// If using relay
+await conn.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
+2. Baileys has a function to generate the content for these link previews
+3. To enable this function's usage, add `unfurl.js` as a dependency to your project with `yarn add unfurl.js`
+4. Send a link:
+
+```js
+await conn.sendMessage(jid, {
+    text: 'Hi, this was sent using https://github.com/whiskeysockets/baileys',
+})
+```
+
+### Media Messages
+
+Sending media (video, stickers, images) is easier & more efficient than ever.
+
+> [!NOTE]
+> In media messages, you can pass `{ stream: Stream }` or `{ url: Url }` or `Buffer` directly, you can see more [here](https://baileys.whiskeysockets.io/types/WAMediaUpload.html)
+
+- When specifying a media url, Baileys never loads the entire buffer into memory it even encrypts the media as a readable stream.
+
+> [!TIP]
+> It's recommended to use Stream or Url to save memory
+
+#### Gif Message
+
+- Whatsapp doesn't support `.gif` files, that's why we send gifs as common `.mp4` video with `gifPlayback` flag
+
+```js
+await conn.sendMessage(jid, {
+    video: fs.readFileSync('Media/ma_gif.mp4'),
+    caption: 'hello word',
+    gifPlayback: true,
+})
+```
+
+#### Video Message
+
+```js
+await conn.sendMessage(id, {
+    video: {
+        url: './Media/ma_gif.mp4',
+    },
+    caption: 'hello word',
+})
+```
+
+#### Video Ptv Message
+
+```js
+await conn.sendMessage(id, {
+    video: {
+        url: './Media/ma_gif.mp4',
+    },
+    ptv: true,
+})
+```
+
+#### Audio Message
+
+- To audio message work in all devices you need to convert with some tool like `ffmpeg` with this flags:
+    ```bash
+        codec: libopus //ogg file
+        ac: 1 //one channel
+        avoid_negative_ts
+        make_zero
+    ```
+
+    - Example:
+    ```bash
+    ffmpeg -i input.mp4 -avoid_negative_ts make_zero -ac 1 output.ogg
+    ```
+
+```js
+await conn.sendMessage(jid, {
+    audio: {
+        url: './Media/audio.mp3',
+    },
+    mimetype: 'audio/mp4',
+})
+```
+
+#### Image Message
+
+```js
+await conn.sendMessage(id, {
+    image: {
+        url: './Media/ma_img.png',
+    },
+    caption: 'hello word',
+})
+```
+
+### Album Message
+
+```js
+await conn.sendMessage(
+    id,
+    {
+        album: [{
+        	image: {
+        		url: 'https://example.com/AsepXyz.jpg'
+        	},
+        	caption: 'Hay'
+        }, {
+        	image: Buffer,
+        	caption: 'Hay'
+        }, {
+        	video: {
+        		url: 'https://example.com/AsepXyz.mp4'
+        	},
+        	caption: 'Hay'
+        }, {
+        	video: Buffer,
+        	caption: 'Hay'
+        }
+    }
+)
+```
+
+#### View Once Message
+
+- You can send all messages above as `viewOnce`, you only need to pass `viewOnce: true` in content object
+
+```js
+await conn.sendMessage(id, {
+    image: {
+        url: './Media/ma_img.png',
+    },
+    viewOnce: true, //works with video, audio too
+    caption: 'hello word',
+})
+```
+
+## Modify Messages
+
+### Deleting Messages (for everyone)
+
+```js
+const msg = await conn.sendMessage(jid, { text: 'hello word' })
+await conn.sendMessage(jid, { delete: msg.key })
+```
+
+**Note:** deleting for oneself is supported via `chatModify`, see in [this section](#modifying-chats)
+
+### Editing Messages
+
+- You can pass all editable contents here
+
+```js
+await conn.sendMessage(jid, {
+    text: 'updated text goes here',
+    edit: response.key,
+})
+```
+
+## Manipulating Media Messages
+
+### Thumbnail in Media Messages
+
+- For media messages, the thumbnail can be generated automatically for images & stickers provided you add `jimp` or `sharp` as a dependency in your project using `yarn add jimp` or `yarn add sharp`.
+- Thumbnails for videos can also be generated automatically, though, you need to have `ffmpeg` installed on your system.
+
+### Downloading Media Messages
+
+If you want to save the media you received
+
+```js
+import { createWriteStream } from 'fs'
+import { downloadMediaMessage, getContentType } from 'AsepXyz'
+
+conn.ev.on('messages.upsert', async ({ [m] }) => {
+    if (!m.message) return // if there is no text or media message
+    const messageType = getContentType(m) // get what type of message it is (text, image, video...)
+
+    // if the message is an image
+    if (messageType === 'imageMessage') {
+        // download the message
+        const stream = await downloadMediaMessage(
+            m,
+            'stream', // can be 'buffer' too
+            { },
+            {
+                logger,
+                // pass this so that baileys can request a reupload of media
+                // that has been deleted
+                reuploadRequest: conn.updateMediaMessage
+            }
+        )
+        // save to file
+        const writeStream = createWriteStream('./my-download.jpeg')
+        stream.pipe(writeStream)
+    }
+}
+```
+
+### Re-upload Media Message to Whatsapp
+
+- WhatsApp automatically removes old media from their servers. For the device to access said media -- a re-upload is required by another device that has it. This can be accomplished using:
+
+```js
+await conn.updateMediaMessage(msg)
+```
+
+## Reject Call
+
+- You can obtain `callId` and `callFrom` from `call` event
+
+```js
+await conn.rejectCall(callId, callFrom)
+```
+
+## Send States in Chat
+
+### Reading Messages
+
+- A set of message [keys](https://baileys.whiskeysockets.io/types/WAMessageKey.html) must be explicitly marked read now.
+- You cannot mark an entire 'chat' read as it were with Baileys Web.
+  This means you have to keep track of unread messages.
+
+```js
+const key: WAMessageKey
+// can pass multiple keys to read multiple messages as well
+await conn.readMessages([key])
+```
+
+The message ID is the unique identifier of the message that you are marking as read.
+On a `WAMessage`, the `messageID` can be accessed using `messageID = message.key.id`.
+
+### Update Presence
+
+- `presence` can be one of [these](https://baileys.whiskeysockets.io/types/WAPresence.html)
+- The presence expires after about 10 seconds.
+- This lets the person/group with `jid` know whether you're online, offline, typing etc.
+
+```js
+await conn.sendPresenceUpdate('available', jid)
+```
+
+> [!NOTE]
+> If a desktop client is active, WA doesn't send push notifications to the device. If you would like to receive said notifications -- mark your Baileys client offline using `conn.sendPresenceUpdate('unavailable')`
+
+## Modifying Chats
+
+WA uses an encrypted form of communication to send chat/app updates. This has been implemented mostly and you can send the following updates:
+
+> [!IMPORTANT]
+> If you mess up one of your updates, WA can log you out of all your devices and you'll have to log in again.
+
+### Archive a Chat
+
+```js
+const lastMsgInChat = await getLastMessageInChat(jid) // implement this on your end
+await conn.chatModify({ archive: true, lastMessages: [lastMsgInChat] }, jid)
+```
+
+### Mute/Unmute a Chat
+
+- Supported times:
+
+| Time   | Miliseconds |
+| ------ | ----------- |
+| Remove | null        |
+| 8h     | 86.400.000  |
+| 7d     | 604.800.000 |
+
+```js
+// mute for 8 hours
+await conn.chatModify({ mute: 8 * 60 * 60 * 1000 }, jid)
+// unmute
+await conn.chatModify({ mute: null }, jid)
+```
+
+### Mark a Chat Read/Unread
+
+```js
+const lastMsgInChat = await getLastMessageInChat(jid) // implement this on your end
+// mark it unread
+await conn.chatModify({ markRead: false, lastMessages: [lastMsgInChat] }, jid)
+```
+
+### Delete a Message for Me
+
+```js
+await conn.chatModify(
+    {
+        clear: {
+            messages: [
+                {
+                    id: 'ATWYHDNNWU81732J',
+                    fromMe: true,
+                    timestamp: '1654823909',
+                },
+            ],
+        },
+    },
+    jid
+)
+```
+
+### Delete a Chat
+
+```js
+const lastMsgInChat = await getLastMessageInChat(jid) // implement this on your end
+await conn.chatModify(
+    {
+        delete: true,
+        lastMessages: [
+            {
+                key: lastMsgInChat.key,
+                messageTimestamp: lastMsgInChat.messageTimestamp,
+            },
+        ],
+    },
+    jid
+)
+```
+
+### Pin/Unpin a Chat
+
+```js
+await conn.chatModify(
+    {
+        pin: true, // or `false` to unpin
+    },
+    jid
+)
+```
+
+### Star/Unstar a Message
+
+```js
+await conn.chatModify(
+    {
+        star: {
+            messages: [
+                {
+                    id: 'messageID',
+                    fromMe: true, // or `false`
+                },
+            ],
+            star: true, // - true: Star Message false: Unstar Message
+        },
+    },
+    jid
+)
+```
+
+### Disappearing Messages
+
+- Ephemeral can be:
+
+| Time   | Seconds   |
+| ------ | --------- |
+| Remove | 0         |
+| 24h    | 86.400    |
+| 7d     | 604.800   |
+| 90d    | 7.776.000 |
+
+- You need to pass in **Seconds**, default is 7 days
+
+```js
+// turn on disappearing messages
+await conn.sendMessage(
+    jid,
+    // this is 1 week in seconds -- how long you want messages to appear for
+    { disappearingMessagesInChat: WA_DEFAULT_EPHEMERAL }
+)
+
+// will send as a disappearing message
+await conn.sendMessage(jid, { text: 'hello' }, { ephemeralExpiration: WA_DEFAULT_EPHEMERAL })
+
+// turn off disappearing messages
+await conn.sendMessage(jid, { disappearingMessagesInChat: false })
+```
+
+### Clear Messages
+
+```js
+await conn.clearMessage(jid, key, timestamps)
+```
+
+## User Querys
+
+### Check If ID Exists in Whatsapp
+
+```js
+const [result] = await conn.onWhatsApp(jid)
+if (result.exists) console.log(`${jid} exists on WhatsApp, as jid: ${result.jid}`)
+```
+
+### Query Chat History (groups too)
+
+- You need to have oldest message in chat
+
+```js
+const msg = await getOldestMessageInChat(jid)
+await conn.fetchMessageHistory(
+    50, //quantity (max: 50 per query)
+    msg.key,
+    msg.messageTimestamp
+)
+```
+
+- Messages will be received in `messaging.history-set` event
+
+### Fetch Status
+
+```js
+const status = await conn.fetchStatus(jid)
+console.log('status: ' + status)
+```
+
+### Fetch Profile Picture
+
+- To get the display picture of some person, group and channel
+
+```js
+// for low res picture
+const ppUrl = await conn.profilePictureUrl(jid)
+console.log(ppUrl)
+```
+
+### Fetch Bussines Profile (such as description or category)
+
+```js
+const profile = await conn.getBusinessProfile(jid)
+console.log('business description: ' + profile.description + ', category: ' + profile.category)
+```
+
+### Fetch Someone's Presence (if they're typing or online)
+
+```js
+// the presence update is fetched and called here
+conn.ev.on('presence.update', console.log)
+
+// request updates for a chat
+await conn.presenceSubscribe(jid)
+```
+
+## Change Profile
+
+### Change Profile Status
+
+```js
+await conn.updateProfileStatus('Hello World!')
+```
+
+### Change Profile Name
+
+```js
+await conn.updateProfileName('My name')
+```
+
+### Change Display Picture (groups too)
+
+- To change your display picture or a group's
+
+> [!NOTE]
+> Like media messages, you can pass `{ stream: Stream }` or `{ url: Url }` or `Buffer` directly, you can see more [here](https://baileys.whiskeysockets.io/types/WAMediaUpload.html)
+
+```js
+await conn.updateProfilePicture(jid, { url: './new-profile-picture.jpeg' })
+```
+
+### Remove display picture (groups too)
+
+```js
+await conn.removeProfilePicture(jid)
+```
+
+## Groups
+
+- To change group properties you need to be admin
+
+### Create a Group
+
+```js
+// title & participants
+const group = await conn.groupCreate('My Fab Group', ['1234@s.whatsapp.net', '4564@s.whatsapp.net'])
+console.log('created group with id: ' + group.gid)
+await conn.sendMessage(group.id, { text: 'hello there' }) // say hello to everyone on the group
+```
+
+### Add/Remove or Demote/Promote
+
+```js
+// id & people to add to the group (will throw error if it fails)
+await conn.groupParticipantsUpdate(
+    jid,
+    ['abcd@s.whatsapp.net', 'efgh@s.whatsapp.net'],
+    'add' // replace this parameter with 'remove' or 'demote' or 'promote'
+)
+```
+
+### Change Subject (name)
+
+```js
+await conn.groupUpdateSubject(jid, 'New Subject!')
+```
+
+### Change Description
+
+```js
+await conn.groupUpdateDescription(jid, 'New Description!')
+```
+
+### Change Settings
+
+```js
+// only allow admins to send messages
+await conn.groupSettingUpdate(jid, 'announcement')
+// allow everyone to send messages
+await conn.groupSettingUpdate(jid, 'not_announcement')
+// allow everyone to modify the group's settings -- like display picture etc.
+await conn.groupSettingUpdate(jid, 'unlocked')
+// only allow admins to modify the group's settings
+await conn.groupSettingUpdate(jid, 'locked')
+```
+
+### Leave a Group
+
+```js
+// will throw error if it fails
+await conn.groupLeave(jid)
+```
+
+### Get Invite Code
+
+- To create link with code use `'https://chat.whatsapp.com/' + code`
+
+```js
+const code = await conn.groupInviteCode(jid)
+console.log('group code: ' + code)
+```
+
+### Revoke Invite Code
+
+```js
+const code = await conn.groupRevokeInvite(jid)
+console.log('New group code: ' + code)
+```
+
+### Join Using Invitation Code
+
+- Code can't have `https://chat.whatsapp.com/`, only code
+
+```js
+const response = await conn.groupAcceptInvite(code)
+console.log('joined to: ' + response)
+```
+
+### Get Group Info by Invite Code
+
+```js
+const response = await conn.groupGetInviteInfo(code)
+console.log('group information: ' + response)
+```
+
+### Query Metadata (participants, name, description...)
+
+```js
+const metadata = await conn.groupMetadata(jid)
+console.log(metadata.id + ', title: ' + metadata.subject + ', description: ' + metadata.desc)
+```
+
+### Join using `groupInviteMessage`
+
+```js
+const response = await conn.groupAcceptInviteV4(jid, groupInviteMessage)
+console.log('joined to: ' + response)
+```
+
+### Get Request Join List
+
+```js
+const response = await conn.groupRequestParticipantsList(jid)
+console.log(response)
+```
+
+### Approve/Reject Request Join
+
+```js
+const response = await conn.groupRequestParticipantsUpdate(
+    jid, // group id
+    ['abcd@s.whatsapp.net', 'efgh@s.whatsapp.net'],
+    'approve' // or 'reject'
+)
+console.log(response)
+```
+
+### Get All Participating Groups Metadata
+
+```js
+const response = await conn.groupFetchAllParticipating()
+console.log(response)
+```
+
+### Toggle Ephemeral
+
+- Ephemeral can be:
+
+| Time   | Seconds   |
+| ------ | --------- |
+| Remove | 0         |
+| 24h    | 86.400    |
+| 7d     | 604.800   |
+| 90d    | 7.776.000 |
+
+```js
+await conn.groupToggleEphemeral(jid, 86400)
+```
+
+### Change Add Mode
+
+```js
+await conn.groupMemberAddMode(
+    jid,
+    'all_member_add' // or 'admin_add'
+)
+```
+
+## Privacy
+
+### Block/Unblock User
+
+```js
+await conn.updateBlockStatus(jid, 'block') // Block user
+await conn.updateBlockStatus(jid, 'unblock') // Unblock user
+```
+
+### Get Privacy Settings
+
+```js
+const privacySettings = await conn.fetchPrivacySettings(true)
+console.log('privacy settings: ' + privacySettings)
+```
+
+### Get BlockList
+
+```js
+const response = await conn.fetchBlocklist()
+console.log(response)
+```
+
+### Update LastSeen Privacy
+
+```js
+const value = 'all' // 'contacts' | 'contact_blacklist' | 'none'
+await conn.updateLastSeenPrivacy(value)
+```
+
+### Update Online Privacy
+
+```js
+const value = 'all' // 'match_last_seen'
+await conn.updateOnlinePrivacy(value)
+```
+
+### Update Profile Picture Privacy
+
+```js
+const value = 'all' // 'contacts' | 'contact_blacklist' | 'none'
+await conn.updateProfilePicturePrivacy(value)
+```
+
+### Update Status Privacy
+
+```js
+const value = 'all' // 'contacts' | 'contact_blacklist' | 'none'
+await conn.updateStatusPrivacy(value)
+```
+
+### Update Read Receipts Privacy
+
+```js
+const value = 'all' // 'none'
+await conn.updateReadReceiptsPrivacy(value)
+```
+
+### Update Groups Add Privacy
+
+```js
+const value = 'all' // 'contacts' | 'contact_blacklist'
+await conn.updateGroupsAddPrivacy(value)
+```
+
+### Update Default Disappearing Mode
+
+- Like [this](#disappearing-messages), ephemeral can be:
+
+| Time   | Seconds   |
+| ------ | --------- |
+| Remove | 0         |
+| 24h    | 86.400    |
+| 7d     | 604.800   |
+| 90d    | 7.776.000 |
+
+```js
+const ephemeral = 86400
+await conn.updateDefaultDisappearingMode(ephemeral)
+```
+
+## Broadcast Lists & Stories
+
+### Send Broadcast & Stories
+
+- Messages can be sent to broadcasts & stories. You need to add the following message options in sendMessage, like this:
+
+```js
+await conn.sendMessage(
+    jid,
+    {
+        image: {
+            url: url,
+        },
+        caption: caption,
+    },
+    {
+        backgroundColor: backgroundColor,
+        font: font,
+        statusJidList: statusJidList,
+        broadcast: true,
+    }
+)
+```
+
+- Message body can be a `extendedTextMessage` or `imageMessage` or `videoMessage` or `voiceMessage`, see [here](https://baileys.whiskeysockets.io/types/AnyRegularMessageContent.html)
+- You can add `backgroundColor` and other options in the message options, see [here](https://baileys.whiskeysockets.io/types/MiscMessageGenerationOptions.html)
+- `broadcast: true` enables broadcast mode
+- `statusJidList`: a list of people that you can get which you need to provide, which are the people who will get this status message.
+
+- You can send messages to broadcast lists the same way you send messages to groups & individual chats.
+- Right now, WA Web does not support creating broadcast lists, but you can still delete them.
+- Broadcast IDs are in the format `12345678@broadcast`
+
+### Query a Broadcast List's Recipients & Name
+
+```js
+const bList = await conn.getBroadcastListInfo('1234@broadcast')
+console.log(`list name: ${bList.name}, recps: ${bList.recipients}`)
+```
+
+## Writing Custom Functionality
+
+Baileys is written with custom functionality in mind. Instead of forking the project & re-writing the internals, you can simply write your own extensions.
+
+### Enabling Debug Level in Baileys Logs
+
+First, enable the logging of unhandled messages from WhatsApp by setting:
+
+```js
+const conn = makeWASocket({
+    logger: P({ level: 'debug' }),
+})
+```
+
+This will enable you to see all sorts of messages WhatsApp sends in the console.
+
+### How Whatsapp Communicate With Us
+
+> [!TIP]
+> If you want to learn whatsapp protocol, we recommend to study about Libsignal Protocol and Noise Protocol
+
+- **Example:** Functionality to track the battery percentage of your phone. You enable logging and you'll see a message about your battery pop up in the console:
+    ```
+    {
+        "level": 10,
+        "fromMe": false,
+        "frame": {
+            "tag": "ib",
+            "attrs": {
+                "from": "@s.whatsapp.net"
+            },
+            "content": [
+                {
+                    "tag": "edge_routing",
+                    "attrs": {},
+                    "content": [
+                        {
+                            "tag": "routing_info",
+                            "attrs": {},
+                            "content": {
+                                "type": "Buffer",
+                                "data": [8,2,8,5]
+                            }
+                        }
+                    ]
+                }
+            ]
+        },
+        "msg":"communication"
+    }
+    ```
+
+The `'frame'` is what the message received is, it has three components:
+
+- `tag` -- what this frame is about (eg. message will have 'message')
+- `attrs` -- a string key-value pair with some metadata (contains ID of the message usually)
+- `content` -- the actual data (eg. a message node will have the actual message content in it)
+- read more about this format [here](/src/WABinary/readme.md)
+
+### Register a Callback for Websocket Events
+
+> [!TIP]
+> Recommended to see `onMessageReceived` function in `socket.js` file to understand how websockets events are fired
+
+```js
+// for any message with tag 'edge_routing'
+conn.ws.on('CB:edge_routing', (node: BinaryNode) => { })
+
+// for any message with tag 'edge_routing' and id attribute = abcd
+conn.ws.on('CB:edge_routing,id:abcd', (node: BinaryNode) => { })
+
+// for any message with tag 'edge_routing', id attribute = abcd & first content node routing_info
+conn.ws.on('CB:edge_routing,id:abcd,routing_info', (node: BinaryNode) => { })
+```
+
+<div align="center">
+  <p>© 2026 Made With Love by <b>AsepXyz</b></p>
+</div>
+
+