kevinx-baileys 1.2.0 → 1.2.1

package/kevinx-baileys/CHANGELOG.md

@@ -0,0 +1,24 @@
+# Changelog
+
+## 1.2.1
+- Added `sock.toLid(jid)` (single-JID shortcut returning the LID string or `null`)
+- Added `sock.newsletterReactionMode(jid, mode)` (`ALL` / `BASIC` / `NONE` / `BLOCKLIST`)
+- Added `sock.newsletterFetchUpdates(jid, count, after, since)` (parsed views + reaction counts)
+- Added `sock.newsletterFetchMessagesDecoded(type, key, count, after)` (decrypted + parsed channel messages, supports invite keys)
+- Added `Browsers.kevinx(browser)`
+- Exported `wMexQuery` from `Socket/mex.js`
+- Fixed `sendMessageMembers`: with `onlyMember: true` and no admin data the message was sent to 0 members (empty array is truthy); now falls back to all members
+- Fixed `makeCacheManagerAuthState`: creds TTL was 63115200 *milliseconds* (~17.5 h) instead of 2 years
+- Fixed raw send while the socket is still connecting: waits for the socket to open instead of failing immediately
+- Fixed `WebSocketClient.send()` never calling its callback when there is no socket; connect timeout now falls back to 30 s
+
+## 1.2.0
+- Added `makeKevinXSocket()` (auto-reconnect with backoff, no reconnect on loggedOut / replaced / forbidden)
+- Added `sock.pair()`, `sock.reply()`, `sock.sendWithTyping()`, `sock.sendStatus*()`
+- Added `sock.queue` / `sock.broadcast()` (random delay send queue)
+- Added `backupSession`, `restoreSession`, `cleanSession`
+- Added `useMongoAuthState`, `useRedisAuthState`
+- Added `sock.channel.*`, built-in group metadata cache, `sock.tagAll()`, `sock.hidetag()`
+- Added opt-in update check (`KEVINX_CHECK_UPDATE=true`)
+- Added TypeScript typings
+- New startup banner: boxed layout, diagonal gradient logo, runtime info, thanks/follow lines. `KEVINX_BANNER=compact` for one line, `false` to disable, `NO_COLOR=1` for no colours; narrow terminals get the compact one automatically

package/{LICENSE → kevinx-baileys/LICENSE}

@@ -1,6 +1,5 @@
 MIT License
 
-Copyright (c) 2025 Rajeh Taher/WhiskeySockets (Baileys)
 Copyright (c) 2026 KevinX (https://t.me/kevinxddd) — modifications
 
 Permission is hereby granted, free of charge, to any person obtaining a copy

package/{README.md → kevinx-baileys/README.md}

@@ -155,6 +155,31 @@ await sock.sendMessage(m.chat, { text: 'KevinX Baileys' }, { ptcp: true })
 
 ---
 
+## What's new in 1.2.1
+
+Additive again; no existing method is removed or renamed.
+
+```js
+// PN -> LID (single value, or null)
+const lid = await sock.toLid('62812xxxxxxx@s.whatsapp.net')
+
+// Channel: who may react, and parsed views / reaction counts
+await sock.newsletterReactionMode('120363...@newsletter', 'BASIC')   // ALL | BASIC | NONE | BLOCKLIST
+const stats = await sock.newsletterFetchUpdates('120363...@newsletter', 20)
+// [{ server_id, views, reactions: [{ code, count }] }]
+
+// Channel messages, decrypted + parsed (also works with an invite key)
+const posts = await sock.newsletterFetchMessagesDecoded('invite', 'INVITE_KEY', 10)
+
+// Browser preset
+const sock = makeWASocket({ browser: Browsers.kevinx('Chrome') })
+
+// Send to a group's members one by one (admins only when onlyMember is true)
+await sock.sendMessageMembers(groupJid, { text: 'Hello' }, { delayMs: 1500, onlyMember: true })
+```
+
+Fixes: `sendMessageMembers` no longer sends to 0 people when admin data is empty, the cache-manager auth state keeps `creds` for 2 years (the TTL was in the wrong unit), raw sends wait for a still-connecting socket, and `WebSocketClient.send()` reports an error when there is no socket. Full list in `CHANGELOG.md`.
+
 ## What's new in 1.2
 
 Everything below is additive. Existing code keeps working, and no existing socket method is replaced.

package/{lib → kevinx-baileys/lib}/Socket/Client/websocket.js

@@ -25,8 +25,8 @@ export class WebSocketClient extends AbstractSocketClient {
         this.socket = new WebSocket(this.url, {
             origin: DEFAULT_ORIGIN,
             headers: this.config.options?.headers,
-            handshakeTimeout: this.config.connectTimeoutMs,
-            timeout: this.config.connectTimeoutMs,
+            handshakeTimeout: this.config.connectTimeoutMs || 30000,
+            timeout: this.config.connectTimeoutMs || 30000,
             agent: this.config.agent
         });
         this.socket.setMaxListeners(0);
@@ -47,8 +47,13 @@ export class WebSocketClient extends AbstractSocketClient {
         this.socket = null;
     }
     send(str, cb) {
-        this.socket?.send(str, cb);
-        return Boolean(this.socket);
+        if (!this.socket) {
+            // no socket at all: report it instead of never calling cb (which would hang until timeout)
+            cb?.(new Error('WebSocket is not connected'));
+            return false;
+        }
+        this.socket.send(str, cb);
+        return true;
     }
 }
 //# sourceMappingURL=websocket.js.map

package/{lib → kevinx-baileys/lib}/Socket/messages-send.js

@@ -1484,7 +1484,9 @@ export const makeMessagesSocket = (config) => {
             const isAdmin = groupData.participants.filter((x) => x.admin !== null).map((y) => y.id);
             let participantJids = groupData.participants.map(z => z.id);
             if (onlyMember) {
-                participantJids = isAdmin ? isAdmin : participantJids;
+                // an empty array is truthy in JS, so check .length to really fall back to all members
+                // when no admin data is available (otherwise the message goes to 0 people)
+                participantJids = isAdmin.length ? isAdmin : participantJids;
             }
             logger.info(`Sending message to ${participantJids.length} members from ${jid}`);
             for (let i = 0; i < participantJids.length; i++) {

package/{lib → kevinx-baileys/lib}/Socket/mex.js

@@ -1,7 +1,7 @@
 import { Boom } from '@hapi/boom'
 import { S_WHATSAPP_NET, getBinaryNodeChild } from '../WABinary/index.js'
 
-const wMexQuery = (variables, queryId, query, generateMessageTag) => {
+export const wMexQuery = (variables, queryId, query, generateMessageTag) => {
   return query({
     tag: 'iq',
     attrs: {

package/{lib → kevinx-baileys/lib}/Socket/newsletter.js

@@ -1,6 +1,7 @@
 import * as Types from '../Types/index.js'
+import { decryptMessageNode } from '../Utils/decode-wa-message.js'
 import { generateProfilePicture } from '../Utils/messages-media.js'
-import { getBinaryNodeChild } from '../WABinary/index.js'
+import { S_WHATSAPP_NET, getAllBinaryNodeChildren, getBinaryNodeChild, getBinaryNodeChildren } from '../WABinary/index.js'
 import { makeGroupsSocket } from './groups.js'
 import { executeWMexQuery } from './mex.js'
 
@@ -38,7 +39,7 @@ const parseNewsletterMetadata = result => {
 
 export const makeNewsletterSocket = config => {
   const sock = makeGroupsSocket(config)
-  const { query, generateMessageTag } = sock
+  const { query, generateMessageTag, authState, signalRepository } = sock
 
   const mexQuery = (variables, queryId, dataPath) => {
     return executeWMexQuery(variables, queryId, dataPath, query, generateMessageTag)
@@ -68,6 +69,48 @@ export const makeNewsletterSocket = config => {
     }, delay)
   })
 
+  /** parse the result of a `messages` / `message_updates` newsletter fetch (views, reactions, decrypted message) */
+  const parseFetchedUpdates = async (node, type) => {
+    let child
+    if (type === 'messages') {
+      child = getBinaryNodeChild(node, 'messages')
+    } else {
+      const parent = getBinaryNodeChild(node, 'message_updates')
+      child = getBinaryNodeChild(parent, 'messages')
+    }
+    return Promise.all(
+      getAllBinaryNodeChildren(child).map(async messageNode => {
+        messageNode.attrs.from = child?.attrs.jid
+        const views = parseInt(getBinaryNodeChild(messageNode, 'views_count')?.attrs?.count || '0', 10)
+        const reactionNode = getBinaryNodeChild(messageNode, 'reactions')
+        const reactions = getBinaryNodeChildren(reactionNode, 'reaction').map(({ attrs }) => ({
+          count: +attrs.count,
+          code: attrs.code
+        }))
+        const data = { server_id: messageNode.attrs.server_id, views, reactions }
+        if (type === 'messages') {
+          const { fullMessage: message, decrypt } = await decryptMessageNode(
+            messageNode,
+            authState.creds.me.id,
+            authState.creds.me.lid || '',
+            signalRepository,
+            config.logger
+          )
+          await decrypt()
+          data.message = message
+        }
+        return data
+      })
+    )
+  }
+
+  const newsletterIq = (to, type, content) =>
+    query({
+      tag: 'iq',
+      attrs: { id: generateMessageTag(), type, xmlns: 'newsletter', to },
+      content
+    })
+
   const newsletterUpdate = async (jid, updates) => {
     const variables = {
       newsletter_id: jid,
@@ -81,6 +124,55 @@ export const makeNewsletterSocket = config => {
 
   return {
     ...sock,
+    /**
+     * Set which reactions are allowed on a channel.
+     * @param {string} jid newsletter jid
+     * @param {'ALL'|'BASIC'|'NONE'|'BLOCKLIST'} mode reaction mode
+     */
+    newsletterReactionMode: async (jid, mode) => {
+      const variables = { newsletter_id: jid, updates: { settings: { reaction_codes: { value: mode } } } }
+      return mexQuery(variables, Types.QueryIds.UPDATE_METADATA, 'xwa2_newsletter_update')
+    },
+
+    /**
+     * Fetch message updates (views + reaction counts) of a channel, parsed.
+     * @returns {Promise<{ server_id: string, views: number, reactions: { count: number, code: string }[] }[]>}
+     */
+    newsletterFetchUpdates: async (jid, count, after, since) => {
+      const result = await newsletterIq(jid, 'get', [
+        {
+          tag: 'message_updates',
+          attrs: {
+            count: count.toString(),
+            after: after?.toString() || '100',
+            since: since?.toString() || '0'
+          }
+        }
+      ])
+      return parseFetchedUpdates(result, 'updates')
+    },
+
+    /**
+     * Fetch channel messages and return them decrypted + parsed (views, reactions, message).
+     * Unlike `newsletterFetchMessages` (raw node), this also accepts an invite key.
+     * @param {'jid'|'invite'} type
+     * @param {string} key newsletter jid, or invite code when type is 'invite'
+     */
+    newsletterFetchMessagesDecoded: async (type, key, count, after) => {
+      const result = await newsletterIq(S_WHATSAPP_NET, 'get', [
+        {
+          tag: 'messages',
+          attrs: {
+            type,
+            ...(type === 'invite' ? { key } : { jid: key }),
+            count: count.toString(),
+            after: after?.toString() || '100'
+          }
+        }
+      ])
+      return parseFetchedUpdates(result, 'messages')
+    },
+
     newsletterFetchAllSubscribe: async () => {
       const list = await executeWMexQuery(
         {},

package/{lib → kevinx-baileys/lib}/Socket/socket.js

@@ -57,7 +57,15 @@ export const makeSocket = (config) => {
     /** send a raw buffer */
     const sendRawMessage = async (data) => {
         if (!ws.isOpen) {
-            throw new Boom('Connection Closed', { statusCode: DisconnectReason.connectionClosed });
+            // socket is still connecting (e.g. right after a network hiccup): wait for it
+            // instead of failing immediately. waitForSocketOpen() throws 'Connection Closed'
+            // if the socket is already closed/closing.
+            if (!ws.isConnecting) {
+                throw new Boom('Connection Closed', { statusCode: DisconnectReason.connectionClosed });
+            }
+            await promiseTimeout(connectTimeoutMs, (resolve, reject) => {
+                waitForSocketOpen().then(resolve, reject);
+            });
         }
         const bytes = noise.encodeFrame(data);
         await promiseTimeout(connectTimeoutMs, async (resolve, reject) => {
@@ -1099,6 +1107,11 @@ export const makeSocket = (config) => {
         fetchNewChatMessageCap,
         toPn,
         toLID,
+        /** single-JID convenience: PN jid -> LID string (or null) */
+        toLid: async (jid) => {
+            const res = await toLID(jid);
+            return res?.[0]?.lid ?? null;
+        },
         fetchUsername,
 		checkBan
     };

package/{lib → kevinx-baileys/lib}/Store/make-cache-manager-store.js

@@ -12,7 +12,7 @@ export default async function makeCacheManagerAuthState(store, sessionKey) {
 
     const writeData = async (file, data) => {
         let ttl = undefined;
-        if (file === "creds") ttl = 63115200; // 2 years
+        if (file === "creds") ttl = 63115200 * 1000; // 2 years (cache-manager ttl is in milliseconds)
         await databaseConn.set(
             defaultKey(file),
             JSON.stringify(data, Utils_1.BufferJSON.replacer),

package/{lib → kevinx-baileys/lib}/Utils/browser-utils.js

@@ -30,6 +30,7 @@ export const Browsers = {
     ubuntu: browser => ['Ubuntu', getBrowserN(browser), '22.04.4'],
     macOS: browser => ['Mac OS', getBrowserN(browser), '14.4.1'],
     baileys: browser => ['Baileys', getBrowserN(browser), '6.5.0'],
+    kevinx: browser => ['KevinX', getBrowserN(browser), '1.2.1'],
     windows: browser => ['Windows', getBrowserN(browser), '10.0.22631'],
     iOS: browser => ['iOS', getBrowserN(browser), '18.2'],
     android: browser => ['Android', getBrowserN(browser), '14.0.0'],

package/{lib → kevinx-baileys/lib}/index.d.ts

@@ -140,6 +140,14 @@ export interface WASocket {
   newsletterMetadata(type: 'invite' | 'jid', key: string): Promise<any>
   newsletterFollow(jid: string): Promise<any>
   newsletterReactMessage(jid: string, serverId: string, reaction?: string): Promise<void>
+  /** allowed reactions on a channel */
+  newsletterReactionMode(jid: string, mode: 'ALL' | 'BASIC' | 'NONE' | 'BLOCKLIST'): Promise<any>
+  /** views + reaction counts of recent channel messages (parsed) */
+  newsletterFetchUpdates(jid: string, count: number, after?: number | string, since?: number | string): Promise<{ server_id: string; views: number; reactions: { count: number; code: string }[] }[]>
+  /** channel messages, decrypted and parsed (accepts an invite key) */
+  newsletterFetchMessagesDecoded(type: 'jid' | 'invite', key: string, count: number, after?: number | string): Promise<{ server_id: string; views: number; reactions: { count: number; code: string }[]; message?: any }[]>
+  /** PN jid -> LID string (null if not found) */
+  toLid(jid: string): Promise<string | null>
 
   /* existing helpers (unchanged signatures) */
   sendText(jid: string, text: string, options?: object, quoted?: WAMessage | null): Promise<any>
@@ -256,6 +264,7 @@ export declare const Browsers: {
   ubuntu(browser: string): [string, string, string]
   macOS(browser: string): [string, string, string]
   baileys(browser: string): [string, string, string]
+  kevinx(browser: string): [string, string, string]
   windows(browser: string): [string, string, string]
   iOS(browser: string): [string, string, string]
   android(browser: string): [string, string, string]

package/kevinx-baileys/package.json

@@ -0,0 +1,153 @@
+{
+    "name": "kevinx-baileys",
+    "version": "1.2.1",
+    "description": "KevinX Baileys — a WebSockets library for interacting with WhatsApp Web (multi-device, pairing code, interactive messages, newsletter, auto-reconnect, send queue, typings).",
+    "keywords": [
+        "baileys",
+        "kevinx-baileys",
+        "whatsapp",
+        "whatsapp-baileys",
+        "whatsapp-bot",
+        "multi-device",
+        "auto-reconnect",
+        "typescript",
+        "whatsapp-api"
+    ],
+    "homepage": "https://t.me/kevinxddd",
+    "repository": {
+        "type": "git",
+        "url": "https://t.me/kevinxddd"
+    },
+    "bugs": {
+        "url": "https://t.me/kevinxddd"
+    },
+    "license": "MIT",
+    "author": "KevinX (https://t.me/kevinxddd)",
+    "type": "module",
+    "main": "lib/index.js",
+    "exports": {
+        ".": {
+            "types": "./lib/index.d.ts",
+            "import": "./lib/index.js",
+            "default": "./lib/index.js"
+        },
+        "./WAProto": "./WAProto/index.js",
+        "./lib/*": "./lib/*",
+        "./WAProto/*": "./WAProto/*",
+        "./package.json": "./package.json"
+    },
+    "files": [
+        "lib/**/*",
+        "WAProto/**/*",
+        "engine-requirements.js",
+        "LICENSE",
+        "README.md",
+        "CHANGELOG.md"
+    ],
+    "scripts": {
+        "gen:protobuf": "sh WAProto/GenerateStatics.sh",
+        "preinstall": "node ./engine-requirements.js",
+        "test": "node --import ./test/register.mjs --test test/extras.test.mjs",
+        "prepublishOnly": "npm test"
+    },
+    "dependencies": {
+        "@cacheable/node-cache": "^1.4.0",
+        "@hapi/boom": "^9.1.3",
+        "async-mutex": "^0.5.0",
+        "cache-manager": "^7.2.8",
+        "chalk": "^4.1.2",
+        "fluent-ffmpeg": "^2.1.3",
+        "libsignal": "^6.0.0",
+        "lru-cache": "^11.1.0",
+        "music-metadata": "^11.12.3",
+        "p-queue": "^9.0.0",
+        "pino": "^9.6",
+        "protobufjs": "^7.5.6",
+        "whatsapp-rust-bridge": "0.5.4",
+        "ws": "^8.13.0"
+    },
+    "devDependencies": {
+        "@eslint/eslintrc": "^3.3.1",
+        "@eslint/js": "^9.31.0",
+        "@types/jest": "^30.0.0",
+        "@types/node": "^20.9.0",
+        "@types/ws": "^8.0.0",
+        "@typescript-eslint/eslint-plugin": "^8",
+        "@typescript-eslint/parser": "^8",
+        "@whiskeysockets/eslint-config": "^1.0.0",
+        "conventional-changelog": "^7.1.1",
+        "conventional-changelog-angular": "^8.0.0",
+        "esbuild-register": "^3.6.0",
+        "eslint": "^9",
+        "eslint-config-prettier": "^10.1.2",
+        "eslint-plugin-prettier": "^5.4.0",
+        "jest": "^30.0.5",
+        "jimp": "^1.6.1",
+        "jiti": "^2.4.2",
+        "json": "^11.0.0",
+        "link-preview-js": "^3.0.0",
+        "lru-cache": "^11.1.0",
+        "open": "^8.4.2",
+        "pino-pretty": "^13.1.1",
+        "prettier": "^3.5.3",
+        "protobufjs-cli": "^1.1.3",
+        "release-it": "^20.0.1",
+        "ts-jest": "^29.4.0",
+        "tsc-esm-fix": "^3.1.2",
+        "tsx": "^4.20.3",
+        "typedoc": "^0.27.9",
+        "typedoc-plugin-markdown": "4.4.2",
+        "typescript": "^5.8.2"
+    },
+    "peerDependencies": {
+        "audio-decode": "^2.1.3",
+        "jimp": "^1.6.1",
+        "link-preview-js": "^3.0.0",
+        "sharp": "*"
+    },
+    "peerDependenciesMeta": {
+        "audio-decode": {
+            "optional": true
+        },
+        "jimp": {
+            "optional": true
+        },
+        "link-preview-js": {
+            "optional": true
+        }
+    },
+    "resolutions": {
+        "ajv@npm:^6.12.4": "^6.14.0",
+        "basic-ftp": "^5.2.4",
+        "brace-expansion@npm:^1.1.7": "^1.1.13",
+        "brace-expansion@npm:^2.0.1": "^2.0.3",
+        "flatted": "^3.4.2",
+        "glob@npm:^10.2.2": "^10.5.0",
+        "glob@npm:^10.3.10": "^10.5.0",
+        "glob@npm:^10.5.0": "^10.5.0",
+        "handlebars": "^4.7.9",
+        "ip-address": "^10.1.1",
+        "js-yaml@npm:^3.13.1": "^3.14.2",
+        "js-yaml@npm:^4.1.0": "^4.1.1",
+        "markdown-it": "^14.1.1",
+        "minimatch@npm:^3.0.4": "^3.1.5",
+        "minimatch@npm:^3.1.2": "^3.1.5",
+        "minimatch@npm:^5.0.1": "^5.1.8",
+        "minimatch@npm:^9.0.4": "^9.0.9",
+        "minimatch@npm:^9.0.5": "^9.0.9",
+        "picomatch@npm:^2.0.4": "^2.3.2",
+        "picomatch@npm:^2.3.1": "^2.3.2",
+        "picomatch@npm:^4.0.0": "^4.0.4",
+        "picomatch@npm:^4.0.2": "^4.0.4",
+        "socks": "^2.8.8",
+        "tar": "^7.5.11",
+        "tmp": "^0.2.5",
+        "underscore": "^1.13.8",
+        "yaml@npm:^2.6.1": "^2.8.4"
+    },
+    "packageManager": "yarn@4.9.2",
+    "engines": {
+        "node": ">=20.0.0"
+    },
+    "types": "lib/index.d.ts"
+}