davexbaileys 2.5.8 → 2.5.10

package/README.md

@@ -1,53 +1,254 @@
 <div align="center">
-  <h1>Davebaileys</h1>
-  <p>A WebSocket-based JavaScript library for interacting with the WhatsApp Web API</p>
-  
-  [![npm version](https://img.shields.io/npm/v/davebaileys.svg)](https://www.npmjs.com/package/davebaileys)
-  [![npm downloads](https://img.shields.io/npm/dm/davebaileys.svg)](https://www.npmjs.com/package/davebaileys)
-  [![License](https://img.shields.io/npm/l/davebaileys.svg)](https://github.com/Davex-254/davebaileys/blob/main/LICENSE)
+
+# davexbaileys
+
+**A fast, lightweight WhatsApp Web API library for Node.js**
+
+[![npm](https://img.shields.io/npm/v/davexbaileys?color=crimson)](https://www.npmjs.com/package/davexbaileys)
+[![npm downloads](https://img.shields.io/npm/dm/davexbaileys)](https://www.npmjs.com/package/davexbaileys)
+[![license](https://img.shields.io/npm/l/davexbaileys)](https://github.com/Davex-254/davebaileys/blob/main/LICENSE)
+
 </div>
 
-## Disclaimer
+---
+
+> **Disclaimer:** This project is not affiliated with or endorsed by WhatsApp. Use responsibly. Do not use for spam, bulk messaging, or stalkerware.
 
-This project is not affiliated, associated, authorized, endorsed by, or in any way officially connected with WhatsApp or any of its subsidiaries or affiliates. Use at your own discretion. Do not spam people with this. We discourage any stalkerware, bulk or automated messaging usage.
+---
+
+## Why davexbaileys?
+
+- No browser, no Selenium — connects directly via **WebSocket**
+- Based on the latest official WhatsApp multi-device protocol
+- Built-in fix for the **428 reconnection loop** that kills deployed bots
+- Pure ESM — works cleanly with modern Node.js (v20+)
+
+---
 
 ## Installation
 
 ```bash
-npm install davebaileys
+npm install davexbaileys
 ```
 
-Or using yarn:
-```bash
-yarn add davebaileys
+---
+
+## Requirements
+
+- **Node.js v20 or higher**
+- This package is **ESM only** — use `import`, not `require`
+
+---
+
+## Getting Started
+
+### Save & Restore Session
+
+```js
+import makeWASocket, { useMultiFileAuthState, DisconnectReason } from 'davexbaileys'
+import { Boom } from '@hapi/boom'
+
+async function start() {
+    const { state, saveCreds } = await useMultiFileAuthState('session')
+
+    const sock = makeWASocket({ auth: state })
+
+    sock.ev.on('creds.update', saveCreds)
+
+    sock.ev.on('connection.update', ({ connection, lastDisconnect, qr }) => {
+        if (qr) console.log('QR code:', qr)
+
+        if (connection === 'close') {
+            const code = lastDisconnect?.error?.output?.statusCode
+            if (code !== DisconnectReason.loggedOut) start()
+        } else if (connection === 'open') {
+            console.log('Connected!')
+        }
+    })
+
+    sock.ev.on('messages.upsert', async ({ messages }) => {
+        for (const msg of messages) {
+            console.log(msg)
+        }
+    })
+}
+
+start()
+```
+
+### Connect with Pairing Code (no QR)
+
+```js
+const sock = makeWASocket({ auth: state })
+
+if (!sock.authState.creds.registered) {
+    const code = await sock.requestPairingCode('2547XXXXXXXX') // full number, no +
+    console.log('Pairing code:', code)
+}
+```
+
+---
+
+## Sending Messages
+
+```js
+// Text
+await sock.sendMessage(jid, { text: 'Hello!' })
+
+// Reply / quote
+await sock.sendMessage(jid, { text: 'Got it' }, { quoted: msg })
+
+// Mention someone
+await sock.sendMessage(jid, {
+    text: '@254700000000 hey!',
+    mentions: ['254700000000@s.whatsapp.net']
+})
+
+// Image
+await sock.sendMessage(jid, {
+    image: { url: './image.jpg' },
+    caption: 'Check this out'
+})
+
+// Video
+await sock.sendMessage(jid, {
+    video: { url: './video.mp4' },
+    caption: 'Watch this'
+})
+
+// Audio
+await sock.sendMessage(jid, {
+    audio: { url: './audio.mp3' },
+    mimetype: 'audio/mp4'
+})
+
+// React to a message
+await sock.sendMessage(jid, {
+    react: { text: '🔥', key: msg.key }
+})
+
+// Delete for everyone
+await sock.sendMessage(jid, {
+    delete: msg.key
+})
+```
+
+---
+
+## WhatsApp JID Format
+
+| Type | Format |
+|------|--------|
+| Personal chat | `254700000000@s.whatsapp.net` |
+| Group | `123456789-123456@g.us` |
+| Broadcast | `status@broadcast` |
+
+---
+
+## Groups
+
+```js
+// Create
+const group = await sock.groupCreate('My Group', ['254700000000@s.whatsapp.net'])
+
+// Add / remove participants
+await sock.groupParticipantsUpdate(jid, ['254700000000@s.whatsapp.net'], 'add')    // or 'remove'
+
+// Promote / demote
+await sock.groupParticipantsUpdate(jid, ['254700000000@s.whatsapp.net'], 'promote') // or 'demote'
+
+// Get invite link
+const code = await sock.groupInviteCode(jid)
+
+// Join by invite code
+await sock.groupAcceptInvite('abc123')
+
+// Group info
+const meta = await sock.groupMetadata(jid)
+
+// Leave
+await sock.groupLeave(jid)
+```
+
+---
+
+## Privacy & Profile
+
+```js
+// Block / unblock
+await sock.updateBlockStatus(jid, 'block')   // or 'unblock'
+
+// Change display name
+await sock.updateProfileName('My Name')
+
+// Change status
+await sock.updateProfileStatus('Available')
+
+// Update profile picture
+await sock.updateProfilePicture(jid, { url: './photo.jpg' })
+
+// Fetch someone's profile picture
+const url = await sock.profilePictureUrl(jid, 'image')
+```
+
+---
+
+## Reading Messages & Presence
+
+```js
+// Mark messages as read
+await sock.readMessages([msg.key])
+
+// Update presence (in a chat)
+await sock.sendPresenceUpdate('composing', jid)  // typing
+await sock.sendPresenceUpdate('paused', jid)     // stopped typing
 ```
 
-## Quick Start
+---
 
-### CommonJS (Recommended)
-```javascript
-const { default: makeWASocket, useMultiFileAuthState, Browsers } = require('davebaileys')
+## Downloading Media
+
+```js
+import { downloadMediaMessage } from 'davexbaileys'
+
+sock.ev.on('messages.upsert', async ({ messages }) => {
+    for (const msg of messages) {
+        if (msg.message?.imageMessage) {
+            const buffer = await downloadMediaMessage(msg, 'buffer', {})
+            // save or process buffer
+        }
+    }
+})
 ```
 
-### ES Modules / TypeScript
-```javascript
-import pkg from 'davebaileys'
-const { default: makeWASocket, useMultiFileAuthState, Browsers } = pkg
+---
+
+## Caching Group Metadata (Recommended for group bots)
+
+```js
+import { NodeCache } from '@cacheable/node-cache'
+
+const groupCache = new NodeCache({ stdTTL: 300 })
+
+const sock = makeWASocket({
+    auth: state,
+    cachedGroupMetadata: async (jid) => groupCache.get(jid)
+})
+
+sock.ev.on('groups.update', async ([event]) => {
+    groupCache.set(event.id, await sock.groupMetadata(event.id))
+})
 ```
 
-## Features
+---
+
+## Links
+
+- **npm:** https://www.npmjs.com/package/davexbaileys
+- **GitHub:** https://github.com/Davex-254/davebaileys
 
-- Full WhatsApp Web API support
-- Multi-device support with QR code and pairing code authentication
-- LID (Link ID) addressing support for both personal chats and groups
-- Group status/story sending functionality
-- Session management and restoration
-- Message sending, receiving, and manipulation
-- Group management
-- Privacy settings
-- Profile management
-- And much more!
+---
 
-## Documentation
+## License
 
-Full documentation is available at [github.com/Davex-254/davebaileys](https://github.com/Davex-254/davebaileys)
+MIT — © Davex-254

package/lib/Defaults/index.js

@@ -36,7 +36,7 @@ export const PROCESSABLE_HISTORY_TYPES = [
 ];
 export const DEFAULT_CONNECTION_CONFIG = {
     version: version,
-    browser: Browsers.macOS('Chrome'),
+    browser: Browsers.ubuntu('Chrome'),
     waWebSocketUrl: 'wss://web.whatsapp.com/ws/chat',
     connectTimeoutMs: 20000,
     keepAliveIntervalMs: 30000,
@@ -49,7 +49,7 @@ export const DEFAULT_CONNECTION_CONFIG = {
     fireInitQueries: true,
     auth: undefined,
     markOnlineOnConnect: true,
-    syncFullHistory: true,
+    syncFullHistory: false,
     patchMessageBeforeSending: msg => msg,
     shouldSyncHistoryMessage: () => true,
     shouldIgnoreJid: () => false,

package/lib/Utils/generics.js

@@ -174,7 +174,7 @@ export const bindWaitForConnectionUpdate = (ev) => bindWaitForEvent(ev, 'connect
  * Use to ensure your WA connection is always on the latest version
  */
 export const fetchLatestBaileysVersion = async (options = {}) => {
-    const URL = 'https://raw.githubusercontent.com/WhiskeySockets/Baileys/master/src/Defaults/index.ts';
+    const URL = 'https://raw.githubusercontent.com/mauricegift/gifted-aileys/main/lib/Defaults/baileys-version.json';
     try {
         const response = await fetch(URL, {
             dispatcher: options.dispatcher,
@@ -184,21 +184,11 @@ export const fetchLatestBaileysVersion = async (options = {}) => {
         if (!response.ok) {
             throw new Boom(`Failed to fetch latest Baileys version: ${response.statusText}`, { statusCode: response.status });
         }
-        const text = await response.text();
-        // Extract version from line 7 (const version = [...])
-        const lines = text.split('\n');
-        const versionLine = lines[6]; // Line 7 (0-indexed)
-        const versionMatch = versionLine.match(/const version = \[(\d+),\s*(\d+),\s*(\d+)\]/);
-        if (versionMatch) {
-            const version = [parseInt(versionMatch[1]), parseInt(versionMatch[2]), parseInt(versionMatch[3])];
-            return {
-                version,
-                isLatest: true
-            };
-        }
-        else {
-            throw new Error('Could not parse version from Defaults/index.ts');
-        }
+        const result = await response.json();
+        return {
+            version: result.version,
+            isLatest: true
+        };
     }
     catch (error) {
         return {

package/lib/Utils/validate-connection.js

@@ -50,12 +50,10 @@ export const generateLoginNode = (userJid, config) => {
     const { user, device } = jidDecode(userJid);
     const payload = {
         ...getClientPayload(config),
-        passive: true,
+        passive: false,
         pull: true,
         username: +user,
-        device: device,
-        // TODO: investigate (hard set as false atm)
-        lidDbMigrated: false
+        device: device
     };
     return proto.ClientPayload.fromObject(payload);
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "davexbaileys",
-    "version": "2.5.8",
+    "version": "2.5.10",
     "type": "module",
     "description": "A lightweight, full-featured WhatsApp Web API library for Node.js",
     "main": "lib/index.js",