@blurose/baileys 1.1.3 → 1.1.5

package/README.md

@@ -1,45 +1,72 @@
-<h1 align='center'><img alt="Baileys logo" src="https://veracloud.biz.id/LIXS.png" height="auto"/><br/>Baileys Newsletter (blurose/baileys)</h1>
+<h1 align='center'><img alt="Baileys logo" src="https://veracloud.biz.id/LIXS.png" height="auto"/><br/>@blurose/baileys</h1>
 
-<div align='center'>A WebSockets-based TypeScript library for interacting with the WhatsApp Web API, customized for Newsletter/Channel Media support and built-in Advanced Interactive Message Builders (MessageBuilder v4.6).</div>
+<div align='center'>A WebSockets-based TypeScript library for interacting with the WhatsApp Web API, customized for Newsletter/Channel Media support, built-in Advanced Interactive Message Builders (MessageBuilder v4.6), and full backwards compatibility for MikirBot & Kiu-style bots.</div>
 
 > [!IMPORTANT]
-> **This is a custom fork and patch of `@whiskeysockets/baileys` (`blurose/baileys`)**
+> **This is a custom fork and patch of `@whiskeysockets/baileys` (`@blurose/baileys`)**
 >
 > Developed & Maintained by: **Xyraa Team** & **alfavz**.
 >
-> This version introduces stable and native support for sending media (audios, images, videos, and documents) to WhatsApp Channels / Newsletters, bypassing E2E encryption for public channel broadcasts, and properly formatting the output stanzas (`type="media"` and `mediatype` metadata) which is currently unsupported in the official WhiskeySockets repository.
->
-> In addition, it integrates **MessageBuilder v4.6** directly into the library, allowing you to generate advanced UI components (Buttons, Carousels, Native Flows, and AI Rich Responses) natively and easily.
+> `@blurose/baileys` keeps the current upstream Baileys RC internals while adding a rich compatibility layer for older Kiu/@z4phdev-style bots and MikirBot projects. The goal is to let existing plugins continue working without replacing newer Baileys features such as modern LID/PN, newsletter, community, and MEX handling.
 
 ---
 
-# Sponsor & Support
-If you'd like to support the original author and maintainer of Baileys (Rajeh), you can book a slot or pre-order [here](https://purpshell.dev/book).
+## Maintenance Status & Compatibility
 
-# Disclaimer
-This project is not affiliated, associated, authorized, endorsed by, or in any way officially connected with WhatsApp or any of its subsidiaries or its affiliates.
-Use at your own discretion. Do not spam people with this. We discourage any stalkerware, bulk or automated messaging usage.
+Active maintained release: **1.1.5**
 
----
+### Key Enhancements & Compatibility Provided
 
-## Key Features
-- **No Selenium/Chromium**: Baileys does not require Selenium or any other browser to interface with WhatsApp Web, saving massive amounts of RAM.
-- **Multi-Device Support**: Interacts natively with the multi-device and web versions of WhatsApp.
+- **Group Participant Safety (1.1.5)**: Safe try-catch parsing for `messageStubParameters` preventing crashes on raw participant events.
+- **Link Preview Safety (1.1.5)**: Silent fallback handling on link preview thumbnail fetch failures.
 - **Newsletter Media Patch**: Automatically maps correct CDN upload endpoints and formats stanzas so media displays perfectly in WhatsApp Channels.
 - **MessageBuilder v4.6 (Built-in)**: Chainable API for creating Buttons, Carousels, Native Flow messages, and AI Rich Response payloads natively from the library.
+- **Legacy Store Helpers**:
+  - `makeInMemoryStore()`
+  - `loadMessages()`
+  - `fetchImageUrl()`
+  - `fetchGroupMetadata()`
+  - `fetchMessageReceipts()`
+- **Legacy Export Aliases**:
+  - `isJidUser`
+  - `isJidNewsLetter`
+  - `MessageType`
+  - `Presence`
+  - `Mimetype`
+  - `WAFlag`
+  - `WA_MESSAGE_STUB_TYPES`
+- **Receive & Meta AI / Bot Compatibility**:
+  - Meta AI / `@bot` `msmsg` replies via message-secret HKDF/AES-GCM decrypt.
+  - Automatic `remoteJidAlt` and `participantAlt` LID ↔ PN resolution.
+- **Socket / Send Compatibility**:
+  - `setLabelGroup()`
+  - `sendStatusMention()`
+  - Kiu-style album/status/raw proto send branches.
+  - Android browser simulation support (`UserAgent.Platform.ANDROID`).
 
-## Install
+---
 
-To install this custom patched version into your project, use:
+## Install
 
 ```bash
 npm install @blurose/baileys
 ```
 
-Then import it in your code:
-
-```ts
-import makeWASocket from 'baileys' // (or whichever alias is configured)
+```js
+const {
+  default: makeWASocket,
+  makeInMemoryStore,
+  isJidUser,
+  isJidNewsLetter,
+  MessageType,
+  Mimetype,
+  Button,
+  ButtonV2,
+  Carousel,
+  AIRich
+} = require('@blurose/baileys')
+
+const store = makeInMemoryStore({})
 ```
 
 ---
@@ -54,27 +81,21 @@ import makeWASocket from 'baileys' // (or whichever alias is configured)
     - [Caching Group Metadata (Recommended)](#caching-group-metadata-recommended)
     - [Improve Retry System & Decrypt Poll Votes](#improve-retry-system--decrypt-poll-votes)
     - [Receive Notifications in Whatsapp App](#receive-notifications-in-whatsapp-app)
-- [Save Auth Info](#saving--restoring-sessions)
+- [Saving & Restoring Sessions](#saving--restoring-sessions)
 - [Handling Events](#handling-events)
 - [Implementing a Data Store](#implementing-a-data-store)
 - [Whatsapp IDs Explain](#whatsapp-ids-explain)
 - [Utility Functions](#utility-functions)
 - [Sending Messages](#sending-messages)
+    - [Non-Media Messages](#non-media-messages)
+    - [Media Messages & Newsletter Sending](#media-messages--newsletter-sending)
 - [MessageBuilder Documentation (UI Components)](#messagebuilder-documentation-ui-components)
     - [1. Button Builder (Button V1)](#1-button-builder-button-v1)
     - [2. ButtonV2 Builder (Native Flow)](#2-buttonv2-builder-native-flow)
     - [3. Carousel Builder](#3-carousel-builder)
     - [4. AIRich Builder (AI Rich Response)](#4-airich-builder-ai-rich-response)
-- [Modify Messages](#modify-messages)
-- [Manipulating Media Messages](#manipulating-media-messages)
-- [Reject Call](#reject-call)
-- [Send States in Chat](#send-states-in-chat)
-- [Modifying Chats](#modifying-chats)
-- [User Querys](#user-querys)
-- [Groups](#groups)
-- [Privacy](#privacy)
-- [Broadcast Lists & Stories](#broadcast-lists--stories)
-- [Writing Custom Functionality](#writing-custom-functionality)
+- [Credits & Acknowledgements](#credits--acknowledgements)
+- [License](#license)
 
 ---
 
@@ -85,10 +106,10 @@ WhatsApp provides a multi-device API that allows Baileys to be authenticated as
 ### Starting socket with **QR-CODE**
 
 ```ts
-import makeWASocket from 'baileys'
+import makeWASocket from '@blurose/baileys'
 
 const sock = makeWASocket({
-    browser: Browsers.ubuntu('My App'),
+    browser: ['Ubuntu', 'Chrome', '20.0.0'],
     printQRInTerminal: true
 })
 ```
@@ -98,26 +119,59 @@ If the connection is successful, you will see a QR code printed on your terminal
 ### Starting socket with **Pairing Code**
 
 ```ts
-import makeWASocket from 'baileys'
+import makeWASocket from '@blurose/baileys'
 
 const sock = makeWASocket({
     printQRInTerminal: false
 })
 
 if (!sock.authState.creds.registered) {
-    const number = 'XXXXXXXXXXX' // Country code + phone number without + or spacing
+    const number = '628XXXXXXXXX' // Country code + phone number without + or spacing
     const code = await sock.requestPairingCode(number)
     console.log(code)
 }
 ```
 
+### Receive Full History
+
+```ts
+const sock = makeWASocket({
+    syncFullHistory: true
+})
+```
+
+---
+
+## Important Notes About Socket Config
+
+### Caching Group Metadata (Recommended)
+- If you use Baileys for groups, we recommend setting `cachedGroupMetadata` in socket config:
+
+```ts
+const groupCache = new NodeCache({ stdTTL: 5 * 60, useClones: false })
+
+const sock = makeWASocket({
+    cachedGroupMetadata: async (jid) => groupCache.get(jid)
+})
+
+sock.ev.on('groups.update', async ([event]) => {
+    const metadata = await sock.groupMetadata(event.id)
+    groupCache.set(event.id, metadata)
+})
+
+sock.ev.on('group-participants.update', async (event) => {
+    const metadata = await sock.groupMetadata(event.id)
+    groupCache.set(event.id, metadata)
+})
+```
+
 ---
 
 ## Saving & Restoring Sessions
 
 Save credentials to log back in without scanning a QR code:
 ```ts
-import makeWASocket, { useMultiFileAuthState } from 'baileys'
+import makeWASocket, { useMultiFileAuthState } from '@blurose/baileys'
 
 const { state, saveCreds } = await useMultiFileAuthState('auth_info_baileys')
 
@@ -127,6 +181,55 @@ sock.ev.on('creds.update', saveCreds)
 
 ---
 
+## Handling Events
+
+```ts
+sock.ev.on('messages.upsert', ({ messages }) => {
+    console.log('got messages', messages)
+})
+```
+
+---
+
+## Implementing a Data Store
+
+This custom fork restores `makeInMemoryStore` out of the box:
+
+```ts
+import makeWASocket, { makeInMemoryStore } from '@blurose/baileys'
+
+const store = makeInMemoryStore({})
+store.readFromFile('./baileys_store.json')
+setInterval(() => {
+    store.writeToFile('./baileys_store.json')
+}, 10_000)
+
+const sock = makeWASocket({})
+store.bind(sock.ev)
+```
+
+---
+
+## Whatsapp IDs Explain
+
+- `jid` format:
+  - User: `[country code][phone number]@s.whatsapp.net` (e.g. `628123456789@s.whatsapp.net`)
+  - LID User: `[id]@lid`
+  - Group: `[timestamp]@g.us`
+  - Channel / Newsletter: `[id]@newsletter`
+  - Stories: `status@broadcast`
+
+---
+
+## Utility Functions
+
+- `isJidUser(jid)`: Checks if JID is a phone number user.
+- `isJidNewsletter(jid)` / `isJidNewsLetter(jid)`: Checks if JID is a WhatsApp Channel.
+- `getContentType(message)`: Returns message content type.
+- `downloadContentFromMessage(message, type)`: Downloads media content buffer.
+
+---
+
 ## Sending Messages
 
 ### Non-Media Messages
@@ -168,7 +271,7 @@ You can import the builders directly from the library:
 ```javascript
 const { Button, ButtonV2, Carousel, AIRich } = require('@blurose/baileys');
 // or when using ESM:
-// import { Button, ButtonV2, Carousel, AIRich } from 'baileys';
+// import { Button, ButtonV2, Carousel, AIRich } from '@blurose/baileys';
 ```
 
 ### 1. Button Builder (Button V1)
@@ -280,10 +383,14 @@ Ini auto citation:
 
 ---
 
+# Disclaimer
+This project is not affiliated, associated, authorized, endorsed by, or in any way officially connected with WhatsApp or any of its subsidiaries or its affiliates.
+Use at your own discretion. Do not spam people with this. We discourage any stalkerware, bulk or automated messaging usage.
+
 # Credits & Acknowledgements
 - Forked from the official [WhiskeySockets/Baileys](https://github.com/WhiskeySockets/Baileys) project by **Rajeh Taher** and contributors.
-- Patch ideas and concepts incorporated from **wileys** package.
-- Patched, customized, and maintained by **Xyraa Team** & **alfavz**.
+- Compatibility ideas and shims inspired by **KonaimaV2/baileys** (Arraffi) and **wileys**.
+- Maintained & Developed by **Xyraa Team** & **alfavz**.
 
 # License
 Copyright (c) 2025 Rajeh Taher/WhiskeySockets & Xyraa Team. Licensed under the MIT License.

package/lib/Socket/messages-recv.js

@@ -1393,6 +1393,20 @@ export const makeMessagesRecvSocket = (config) => {
                     if (messageRetryManager && msg.key.id) {
                         messageRetryManager.cancelPendingPhoneRequest(msg.key.id);
                     }
+                    if (isLidUser(msg.key.participant) && msg.key.participantAlt) {
+                        msg.key.participant = msg.key.participantAlt;
+                    }
+                    if (!isJidGroup(msg.key.remoteJid) && isLidUser(msg.key.remoteJid) && msg.key.remoteJidAlt) {
+                        msg.key.remoteJid = msg.key.remoteJidAlt;
+                    }
+                    const quotedCtx = msg.message?.extendedTextMessage?.contextInfo;
+                    if (isJidGroup(msg.key.remoteJid) && isLidUser(quotedCtx?.participant)) {
+                        try {
+                            const metadata = await groupMetadata(msg.key.remoteJid);
+                            const found = metadata?.participants?.find(p => p.id === quotedCtx.participant || p.lid === quotedCtx.participant);
+                            quotedCtx.participant = found?.jid || found?.pn || quotedCtx.participant;
+                        } catch { }
+                    }
                     const isNewsletter = isJidNewsletter(msg.key.remoteJid);
                     if (!isNewsletter) {
                         // no type in the receipt => message delivered

package/lib/Store/index.d.ts

@@ -0,0 +1,19 @@
+export type LegacyInMemoryStore = {
+  chats: Record<string, any>
+  contacts: Record<string, any>
+  messages: Record<string, any[] & { upsert?: (msg: any, mode?: string) => any, get?: (id: string) => any }>
+  groupMetadata: Record<string, any>
+  presences: Record<string, any>
+  state: Record<string, any>
+  bind: (ev: { on?: (event: string, listener: (...args: any[]) => void) => any }) => LegacyInMemoryStore
+  insertMessage: (msg: any, mode?: string) => any
+  loadMessage: (jid: string, id: string) => any
+  mostRecentMessage: (jid: string) => any
+  readFromFile: (path: string) => void
+  writeToFile: (path: string) => void
+  toJSON: () => any
+}
+export declare const makeInMemoryStore: (opts?: { logger?: any }) => LegacyInMemoryStore
+export default makeInMemoryStore
+
+export declare const makeCacheManagerAuthState: () => Promise<never>;

package/lib/Store/index.js

@@ -0,0 +1,218 @@
+/**
+ * Legacy makeInMemoryStore compatibility helper.
+ *
+ * Baileys v7 no longer ships the old Store folder used by many CJS bots.
+ * This lightweight store keeps the old surface MikirBot needs: chats, contacts,
+ * messages, bind(ev), readFromFile(), writeToFile(), loadMessage().
+ */
+import { writeFileSync, readFileSync, existsSync } from 'fs'
+
+const jidKey = (jid = '') => String(jid)
+const messageId = (msg = {}) => msg?.key?.id || msg?.id || ''
+const chatIdFromMessage = (msg = {}) => msg?.key?.remoteJid || msg?.chat || ''
+
+const makeMessageBucket = () => {
+  const arr = []
+  arr.upsert = (msg, mode = 'append') => {
+    const id = messageId(msg)
+    const idx = id ? arr.findIndex((x) => messageId(x) === id) : -1
+    if (idx >= 0) arr[idx] = { ...arr[idx], ...msg }
+    else if (mode === 'prepend') arr.unshift(msg)
+    else arr.push(msg)
+    return msg
+  }
+  arr.get = (id) => arr.find((x) => messageId(x) === id)
+  arr.toJSON = () => Array.from(arr)
+  return arr
+}
+
+export const makeInMemoryStore = ({ logger } = {}) => {
+  const store = {
+    chats: {},
+    contacts: {},
+    messages: {},
+    groupMetadata: {},
+    presences: {},
+    labels: {},
+    labelAssociations: {},
+    state: {},
+    logger,
+
+    bind(ev) {
+      if (!ev?.on) return this
+
+      ev.on('messaging-history.set', ({ chats = [], contacts = [], messages = [], isLatest } = {}) => {
+        for (const chat of chats) if (chat?.id) this.chats[jidKey(chat.id)] = { ...(this.chats[jidKey(chat.id)] || {}), ...chat }
+        for (const contact of contacts) if (contact?.id) this.contacts[jidKey(contact.id)] = { ...(this.contacts[jidKey(contact.id)] || {}), ...contact }
+        for (const msg of messages) this.insertMessage(msg)
+        this.state.isLatest = isLatest
+      })
+
+      ev.on('chats.set', ({ chats = [] } = {}) => {
+        this.chats = {}
+        for (const chat of chats) if (chat?.id) this.chats[jidKey(chat.id)] = chat
+      })
+
+      ev.on('contacts.set', ({ contacts = [] } = {}) => {
+        this.contacts = {}
+        for (const contact of contacts) if (contact?.id) this.contacts[jidKey(contact.id)] = contact
+      })
+
+      ev.on('messages.set', ({ messages = [] } = {}) => {
+        this.messages = {}
+        for (const msg of messages) this.insertMessage(msg)
+      })
+
+      ev.on('chats.upsert', (chats = []) => {
+        for (const chat of chats) if (chat?.id) this.chats[jidKey(chat.id)] = { ...(this.chats[jidKey(chat.id)] || {}), ...chat }
+      })
+
+      ev.on('chats.update', (updates = []) => {
+        for (const update of updates) if (update?.id) this.chats[jidKey(update.id)] = { ...(this.chats[jidKey(update.id)] || {}), ...update }
+      })
+
+      ev.on('contacts.upsert', (contacts = []) => {
+        for (const contact of contacts) if (contact?.id) this.contacts[jidKey(contact.id)] = { ...(this.contacts[jidKey(contact.id)] || {}), ...contact }
+      })
+
+      ev.on('contacts.update', (updates = []) => {
+        for (const update of updates) if (update?.id) this.contacts[jidKey(update.id)] = { ...(this.contacts[jidKey(update.id)] || {}), ...update }
+      })
+
+      ev.on('messages.upsert', ({ messages = [], type } = {}) => {
+        const mode = type === 'prepend' ? 'prepend' : 'append'
+        for (const msg of messages) this.insertMessage(msg, mode)
+      })
+
+      ev.on('messages.update', (updates = []) => {
+        for (const update of updates) {
+          const jid = jidKey(update?.key?.remoteJid)
+          const id = update?.key?.id
+          if (!jid || !id || !this.messages[jid]) continue
+          const msg = this.messages[jid].get(id)
+          if (msg) Object.assign(msg, update.update || update)
+        }
+      })
+
+      ev.on('groups.update', (updates = []) => {
+        for (const update of updates) if (update?.id) this.groupMetadata[jidKey(update.id)] = { ...(this.groupMetadata[jidKey(update.id)] || {}), ...update }
+      })
+
+      ev.on('group-participants.update', ({ id, participants = [], action } = {}) => {
+        if (!id) return
+        const meta = this.groupMetadata[jidKey(id)] || { id, participants: [] }
+        const existing = new Map((meta.participants || []).map((p) => [p.id, p]))
+        if (action === 'remove') for (const jid of participants) existing.delete(jid)
+        else for (const jid of participants) if (!existing.has(jid)) existing.set(jid, { id: jid })
+        meta.participants = Array.from(existing.values())
+        this.groupMetadata[jidKey(id)] = meta
+      })
+
+      ev.on('presence.update', ({ id, presences } = {}) => {
+        if (id) this.presences[jidKey(id)] = presences || {}
+      })
+
+      return this
+    },
+
+    insertMessage(msg, mode = 'append') {
+      const jid = jidKey(chatIdFromMessage(msg))
+      if (!jid) return msg
+      if (!this.messages[jid]) this.messages[jid] = makeMessageBucket()
+      return this.messages[jid].upsert(msg, mode)
+    },
+
+    loadMessage(jid, id) {
+      return this.messages?.[jidKey(jid)]?.get?.(id)
+    },
+
+    loadMessages(jid, count = 25) {
+      const bucket = this.messages?.[jidKey(jid)] || []
+      return Array.from(bucket).slice(-count)
+    },
+
+    fetchImageUrl(jid) {
+      return this.contacts?.[jidKey(jid)]?.imgUrl || this.chats?.[jidKey(jid)]?.imgUrl
+    },
+
+    fetchGroupMetadata(jid) {
+      return this.groupMetadata?.[jidKey(jid)]
+    },
+
+    fetchMessageReceipts() {
+      return []
+    },
+
+    getLabels() { return this.labels || [] },
+    getChatLabels(jid) { return this.labelAssociations?.[jidKey(jid)] || [] },
+    getMessageLabels(jid, id) { return this.labelAssociations?.[`${jidKey(jid)}|${id}`] || [] },
+
+    mostRecentMessage(jid) {
+      const bucket = this.messages?.[jidKey(jid)] || []
+      return bucket[bucket.length - 1]
+    },
+
+    readFromFile(path) {
+      if (!existsSync(path)) return
+      const data = JSON.parse(readFileSync(path, 'utf8'))
+      this.chats = data.chats || {}
+      this.contacts = data.contacts || {}
+      this.groupMetadata = data.groupMetadata || {}
+      this.presences = data.presences || {}
+      this.labels = data.labels || {}
+      this.labelAssociations = data.labelAssociations || {}
+      this.state = data.state || {}
+      this.messages = {}
+      for (const [jid, messages] of Object.entries(data.messages || {})) {
+        const bucket = makeMessageBucket()
+        for (const msg of messages || []) bucket.upsert(msg)
+        this.messages[jid] = bucket
+      }
+    },
+
+    writeToFile(path) {
+      const messages = {}
+      for (const [jid, bucket] of Object.entries(this.messages || {})) messages[jid] = Array.from(bucket || [])
+      writeFileSync(path, JSON.stringify({
+        chats: this.chats,
+        contacts: this.contacts,
+        messages,
+        groupMetadata: this.groupMetadata,
+        presences: this.presences,
+        labels: this.labels,
+        labelAssociations: this.labelAssociations,
+        state: this.state
+      }, null, 2))
+    },
+
+    toJSON() {
+      const messages = {}
+      for (const [jid, bucket] of Object.entries(this.messages || {})) messages[jid] = Array.from(bucket || [])
+      return {
+        chats: this.chats,
+        contacts: this.contacts,
+        messages,
+        groupMetadata: this.groupMetadata,
+        presences: this.presences,
+        labels: this.labels,
+        labelAssociations: this.labelAssociations,
+        state: this.state
+      }
+    }
+  }
+
+  return store
+}
+
+export default makeInMemoryStore
+
+
+/**
+ * Kiu/@z4phdev legacy export placeholder.
+ * The modern auth path should use useMultiFileAuthState(), but exposing this
+ * name prevents old imports from crashing. It intentionally fails loudly if
+ * someone tries to use the unimplemented cache-manager auth backend.
+ */
+export const makeCacheManagerAuthState = async () => {
+  throw new Error('makeCacheManagerAuthState is not implemented in @konaa/baileys; use useMultiFileAuthState instead')
+}

package/lib/Utils/messages.js

@@ -486,32 +486,68 @@ export const generateWAMessageContent = async (message, options) => {
         };
     }
     else if (hasNonNullishProperty(message, 'buttons')) {
-        const buttonsMessage = {
-            contentText: message.text || message.caption || '',
-            footerText: message.footer || '',
-            buttons: message.buttons,
-            headerType: 1
-        };
+        let header = {};
         if (hasNonNullishProperty(message, 'image')) {
             const { imageMessage } = await prepareWAMessageMedia({ image: message.image }, options);
-            buttonsMessage.imageMessage = imageMessage;
-            buttonsMessage.headerType = 4;
+            header = {
+                title: message.title || '',
+                hasMediaAttachment: true,
+                imageMessage
+            };
         }
         else if (hasNonNullishProperty(message, 'video')) {
             const { videoMessage } = await prepareWAMessageMedia({ video: message.video }, options);
-            buttonsMessage.videoMessage = videoMessage;
-            buttonsMessage.headerType = 5;
+            header = {
+                title: message.title || '',
+                hasMediaAttachment: true,
+                videoMessage
+            };
         }
         else if (hasNonNullishProperty(message, 'document')) {
             const { documentMessage } = await prepareWAMessageMedia({ document: message.document }, options);
-            buttonsMessage.documentMessage = documentMessage;
-            buttonsMessage.headerType = 3;
+            header = {
+                title: message.title || '',
+                hasMediaAttachment: true,
+                documentMessage
+            };
         }
         else if (hasNonNullishProperty(message, 'location')) {
-            buttonsMessage.locationMessage = message.location;
-            buttonsMessage.headerType = 6;
+            header = {
+                title: message.title || '',
+                hasMediaAttachment: true,
+                locationMessage: message.location
+            };
         }
-        m.buttonsMessage = buttonsMessage;
+        else if (message.title) {
+            header = {
+                title: message.title,
+                hasMediaAttachment: false
+            };
+        }
+
+        m.interactiveMessage = {
+            header: Object.keys(header).length ? header : undefined,
+            body: {
+                text: message.text || message.caption || ''
+            },
+            footer: message.footer ? {
+                text: message.footer
+            } : undefined,
+            nativeFlowMessage: {
+                buttons: message.buttons.map(btn => {
+                    if (btn.buttonText?.displayText) {
+                        return {
+                            name: 'quick_reply',
+                            buttonParamsJson: JSON.stringify({
+                                display_text: btn.buttonText.displayText,
+                                id: btn.buttonId || ''
+                            })
+                        };
+                    }
+                    return btn;
+                })
+            }
+        };
     }
     else {
         m = await prepareWAMessageMedia(message, options);

package/lib/Utils/process-message.js

@@ -507,12 +507,26 @@ const processMessage = async (message, { shouldProcessHistoryMsg, placeholderRes
         const participantsIncludesMe = () => participants.find(jid => areJidsSameUser(meId, jid.phoneNumber)); // ADD SUPPORT FOR LID
         switch (message.messageStubType) {
             case WAMessageStubType.GROUP_PARTICIPANT_CHANGE_NUMBER:
-                participants = message.messageStubParameters.map((a) => JSON.parse(a)) || [];
+                participants = message.messageStubParameters.map((a) => {
+                    try {
+                        return JSON.parse(a);
+                    }
+                    catch (_a) {
+                        return a;
+                    }
+                }) || [];
                 emitParticipantsUpdate('modify');
                 break;
             case WAMessageStubType.GROUP_PARTICIPANT_LEAVE:
             case WAMessageStubType.GROUP_PARTICIPANT_REMOVE:
-                participants = message.messageStubParameters.map((a) => JSON.parse(a)) || [];
+                participants = message.messageStubParameters.map((a) => {
+                    try {
+                        return JSON.parse(a);
+                    }
+                    catch (_a) {
+                        return a;
+                    }
+                }) || [];
                 emitParticipantsUpdate('remove');
                 // mark the chat read only if you left the group
                 if (participantsIncludesMe()) {
@@ -522,18 +536,39 @@ const processMessage = async (message, { shouldProcessHistoryMsg, placeholderRes
             case WAMessageStubType.GROUP_PARTICIPANT_ADD:
             case WAMessageStubType.GROUP_PARTICIPANT_INVITE:
             case WAMessageStubType.GROUP_PARTICIPANT_ADD_REQUEST_JOIN:
-                participants = message.messageStubParameters.map((a) => JSON.parse(a)) || [];
+                participants = message.messageStubParameters.map((a) => {
+                    try {
+                        return JSON.parse(a);
+                    }
+                    catch (_a) {
+                        return a;
+                    }
+                }) || [];
                 if (participantsIncludesMe()) {
                     chat.readOnly = false;
                 }
                 emitParticipantsUpdate('add');
                 break;
             case WAMessageStubType.GROUP_PARTICIPANT_DEMOTE:
-                participants = message.messageStubParameters.map((a) => JSON.parse(a)) || [];
+                participants = message.messageStubParameters.map((a) => {
+                    try {
+                        return JSON.parse(a);
+                    }
+                    catch (_a) {
+                        return a;
+                    }
+                }) || [];
                 emitParticipantsUpdate('demote');
                 break;
             case WAMessageStubType.GROUP_PARTICIPANT_PROMOTE:
-                participants = message.messageStubParameters.map((a) => JSON.parse(a)) || [];
+                participants = message.messageStubParameters.map((a) => {
+                    try {
+                        return JSON.parse(a);
+                    }
+                    catch (_a) {
+                        return a;
+                    }
+                }) || [];
                 emitParticipantsUpdate('promote');
                 break;
             case WAMessageStubType.GROUP_CHANGE_ANNOUNCE:

package/lib/Utils/validate-connection.js

@@ -43,7 +43,9 @@ const getClientPayload = (config) => {
         connectReason: proto.ClientPayload.ConnectReason.USER_ACTIVATED,
         userAgent: getUserAgent(config)
     };
-    payload.webInfo = getWebInfo(config);
+    if (!config.browser[1].toLocaleLowerCase().includes('android')) {
+        payload.webInfo = getWebInfo(config);
+    }
     if (config.pushName) {
         payload.pushName = config.pushName;
     }
@@ -64,6 +66,9 @@ export const generateLoginNode = (userJid, config) => {
 };
 const getPlatformType = (platform) => {
     const platformType = platform.toUpperCase();
+    if (platformType === 'ANDROID') {
+        return proto.DeviceProps.PlatformType.ANDROID_PHONE;
+    }
     return (proto.DeviceProps.PlatformType[platformType] ||
         proto.DeviceProps.PlatformType.CHROME);
 };

package/lib/WABinary/jid-utils.js

@@ -63,6 +63,8 @@ export const areJidsSameUser = (jid1, jid2) => jidDecode(jid1)?.user === jidDeco
 export const isJidMetaAI = (jid) => jid?.endsWith('@bot');
 /** is the jid a PN user */
 export const isPnUser = (jid) => jid?.endsWith('@s.whatsapp.net');
+// Kiu/@z4phdev legacy alias
+export const isJidUser = isPnUser;
 /** is the jid a LID */
 export const isLidUser = (jid) => jid?.endsWith('@lid');
 /** is the jid a broadcast */
@@ -73,6 +75,8 @@ export const isJidGroup = (jid) => jid?.endsWith('@g.us');
 export const isJidStatusBroadcast = (jid) => jid === 'status@broadcast';
 /** is the jid a newsletter */
 export const isJidNewsletter = (jid) => jid?.endsWith('@newsletter');
+// Kiu/@z4phdev legacy typo-cased alias
+export const isJidNewsLetter = isJidNewsletter;
 /** is the jid a hosted PN */
 export const isHostedPnUser = (jid) => jid?.endsWith('@hosted');
 /** is the jid a hosted LID */
@@ -87,6 +91,73 @@ export const jidNormalizedUser = (jid) => {
     const { user, server } = result;
     return jidEncode(user, server === 'c.us' ? 's.whatsapp.net' : server);
 };
+
+// Compatibility helper inspired by Elaina Baileys.
+// This is a suffix-level fallback only; it is not a real LID↔PN resolver.
+export const lidToJid = (jid) => jid && jid.endsWith('@lid') ? jid.replace('@lid', '@s.whatsapp.net') : jid;
+
+// Meta bot id compatibility map inspired by Elaina Baileys.
+const BOT_JID_MAP = new Map([
+    ['867051314767696', '13135550002'],
+    ['1061492271844689', '13135550005'],
+    ['245886058483988', '13135550009'],
+    ['3509905702656130', '13135550012'],
+    ['1059680132034576', '13135550013'],
+    ['715681030623646', '13135550014'],
+    ['1644971366323052', '13135550015'],
+    ['582497970646566', '13135550019'],
+    ['645459357769306', '13135550022'],
+    ['294997126699143', '13135550023'],
+    ['1522631578502677', '13135550027'],
+    ['719421926276396', '13135550030'],
+    ['1788488635002167', '13135550031'],
+    ['24232338603080193', '13135550033'],
+    ['689289903143209', '13135550035'],
+    ['871626054177096', '13135550039'],
+    ['362351902849370', '13135550042'],
+    ['1744617646041527', '13135550043'],
+    ['893887762270570', '13135550046'],
+    ['1155032702135830', '13135550047'],
+    ['333931965993883', '13135550048'],
+    ['853748013058752', '13135550049'],
+    ['1559068611564819', '13135550053'],
+    ['890487432705716', '13135550054'],
+    ['240254602395494', '13135550055'],
+    ['1578420349663261', '13135550062'],
+    ['322908887140421', '13135550065'],
+    ['3713961535514771', '13135550067'],
+    ['997884654811738', '13135550070'],
+    ['403157239387035', '13135550081'],
+    ['535242369074963', '13135550082'],
+    ['946293427247659', '13135550083'],
+    ['3664707673802291', '13135550084'],
+    ['1821827464894892', '13135550085'],
+    ['1760312477828757', '13135550086'],
+    ['439480398712216', '13135550087'],
+    ['1876735582800984', '13135550088'],
+    ['984025089825661', '13135550089'],
+    ['1001336351558186', '13135550090'],
+    ['3739346336347061', '13135550091'],
+    ['3632749426974980', '13135550092'],
+    ['427864203481615', '13135550093'],
+    ['1434734570493055', '13135550094'],
+    ['992873449225921', '13135550095'],
+    ['813087747426445', '13135550096'],
+    ['806369104931434', '13135550098'],
+    ['1220982902403148', '13135550099'],
+    ['1365893374104393', '13135550100'],
+    ['491811473512352', '13165550064'],
+]);
+
+export const getBotJid = (jid) => {
+    const sepIdx = typeof jid === 'string' ? jid.indexOf('@') : -1;
+    if (sepIdx < 0) return jid;
+    const server = jid.slice(sepIdx + 1);
+    if (server !== 'bot') return jid;
+    const user = jid.slice(0, sepIdx);
+    const mappedNumber = BOT_JID_MAP.get(user);
+    return mappedNumber ? `${mappedNumber}@s.whatsapp.net` : jid;
+};
 export const transferDevice = (fromJid, toJid) => {
     const fromDecoded = jidDecode(fromJid);
     const deviceId = fromDecoded?.device || 0;

package/lib/index.js

@@ -1,4 +1,5 @@
 import makeWASocket from './Socket/index.js';
+import { proto } from '../WAProto/index.js';
 export * from '../WAProto/index.js';
 export * from './Utils/index.js';
 export * from './Types/index.js';
@@ -6,6 +7,57 @@ export * from './Defaults/index.js';
 export * from './WABinary/index.js';
 export * from './WAM/index.js';
 export * from './WAUSync/index.js';
+export * from './Store/index.js';
+// Kiu/@z4phdev legacy root exports.
+export const MessageType = {
+    text: 'conversation',
+    extendedText: 'extendedTextMessage',
+    image: 'imageMessage',
+    video: 'videoMessage',
+    audio: 'audioMessage',
+    sticker: 'stickerMessage',
+    document: 'documentMessage',
+    contact: 'contactMessage',
+    contactsArray: 'contactsArrayMessage',
+    location: 'locationMessage',
+    liveLocation: 'liveLocationMessage',
+    buttons: 'buttonsMessage',
+    template: 'templateMessage',
+    list: 'listMessage',
+    reaction: 'reactionMessage',
+    pollCreation: 'pollCreationMessage',
+    pollUpdate: 'pollUpdateMessage'
+};
+export const Presence = {
+    available: 'available',
+    unavailable: 'unavailable',
+    composing: 'composing',
+    recording: 'recording',
+    paused: 'paused'
+};
+export const Mimetype = {
+    jpeg: 'image/jpeg',
+    jpg: 'image/jpeg',
+    png: 'image/png',
+    gif: 'image/gif',
+    webp: 'image/webp',
+    mp4: 'video/mp4',
+    mp3: 'audio/mpeg',
+    ogg: 'audio/ogg; codecs=opus',
+    opus: 'audio/ogg; codecs=opus',
+    pdf: 'application/pdf',
+    doc: 'application/msword',
+    docx: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+    xls: 'application/vnd.ms-excel',
+    xlsx: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+    ppt: 'application/vnd.ms-powerpoint',
+    pptx: 'application/vnd.openxmlformats-officedocument.presentationml.presentation',
+    json: 'application/json',
+    zip: 'application/zip',
+    txt: 'text/plain'
+};
+export const WAFlag = { ignore: 'ignore', ack: 'ack', unavailable: 'unavailable' };
+export const WA_MESSAGE_STUB_TYPES = proto.WebMessageInfo?.StubType || {};
 export { makeWASocket };
 export default makeWASocket;
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@blurose/baileys",
   "type": "module",
-  "version": "1.1.3",
+  "version": "1.1.5",
   "description": "A WebSockets library for interacting with WhatsApp Web",
   "keywords": [
     "whatsapp",