@alannxd/baileys 6.1.4 → 6.1.7

package/LICENSE

@@ -1,6 +1,9 @@
 MIT License
 
-Copyright (c) 2025 Rajeh Taher/WhiskeySockets
+Copyright (c) 2026 alannxd (AlannXD) and contributors
+
+Based on Baileys (https://github.com/WhiskeySockets/Baileys), originally
+created by Adhiraj Singh and the WhiskeySockets community, also MIT licensed.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -43,338 +43,264 @@ Begin by installing the library via your preferred package manager, then follow
 
 ---
 
-## Add Function ( Simple code )
-
-# AlannXD Baileys
+## Table of Contents
+
+- [Requirements](#requirements)
+- [Install](#install)
+- [Quick Start](#quick-start)
+  - [QR Code login](#login-with-qr-code)
+  - [Pairing Code login](#login-with-pairing-code)
+- [Store](#store)
+- [Sending Messages](#sending-messages)
+  - [Generic send / relay](#generic-send--relay)
+  - [Simple senders](#simple-senders)
+  - [Special message types](#special-message-types)
+- [Events](#events)
+- [Examples](#examples)
+- [Known Limitations](#known-limitations)
+- [Why Choose WhatsApp Baileys?](#why-choose-whatsapp-baileys?)
+- [Technical Notes](#technical-notes)
+- [Contact Developer](#contact-developer)
+- [Contributors](#contributors-outside-the-baileys-code)
+
+## Requirements
+
+- Node.js **>= 20**
+- Optional peer deps depending on the features you use: `sharp` or `jimp` (image processing), `link-preview-js` (link previews), `audio-decode` (audio waveform)
+
+## Install
+
+```bash
+npm install @alannxd/baileys
+```
 
-Simple WhatsApp Web API Library Based On Baileys.
+Or alias it as `baileys` / `@whiskeysockets/baileys` in your `package.json`:
 
----
-
-## Usage
 ```json
-"depencies": {
-  "@alannxd/baileys": "latest"
-  // or "@whiskeysocket/baileys": "npm:@alannxd/baileys"
+{
+  "dependencies": {
+    "@alannxd/baileys": "latest"
+  }
 }
 ```
-## Import
-```javascript
-const {
-  default: makeWASocket,
-  // Other function
-} = require('@alannxd/baileys');
+
+```js
+import makeWASocket from '@alannxd/baileys'
+// or, CommonJS:
+const { default: makeWASocket } = require('@alannxd/baileys')
 ```
 
----
-# How To Connect To Whatsapp
-## With QR Code
-```javascript
-const {
-  default: makeWASocket,
-  Browsers
-} = require('@alannxd/baileys');
+## Quick Start
+
+### Login with QR Code
+
+```js
+import makeWASocket, { Browsers, useMultiFileAuthState } from '@alannxd/baileys'
+
+const { state, saveCreds } = await useMultiFileAuthState('auth_info')
 
 const client = makeWASocket({
   browser: Browsers.ubuntu('Chrome'),
-  printQRInTerminal: true
+  printQRInTerminal: true,
+  auth: state
 })
+
+client.ev.on('creds.update', saveCreds)
 ```
 
-## Connect With Number
-```javascript
-const {
-  default: makeWASocket,
-  fetchLatestWAWebVersion,
-  Browsers
-} = require('@alannxd/baileys');
+### Login with Pairing Code
+
+```js
+import makeWASocket, { Browsers, fetchLatestWAWebVersion, useMultiFileAuthState } from '@alannxd/baileys'
+
+const { state, saveCreds } = await useMultiFileAuthState('auth_info')
+const { version } = await fetchLatestWAWebVersion()
 
 const client = makeWASocket({
   browser: Browsers.ubuntu('Chrome'),
   printQRInTerminal: false,
-  version: fetchLatestWAWebVersion()
-  aiLabel: false // enable for ai label in every message are bot send
-  // Other options
-});
+  version,
+  auth: state
+})
 
-const number = "628XXXXX";
-const code = await client.requestPairingCode(number.trim) //Use : (number, "YYYYYYYY") for custom-pairing
+client.ev.on('creds.update', saveCreds)
 
-console.log("Ur pairing code : " + code)
+if (!client.authState?.creds?.registered) {
+  const phoneNumber = '628XXXXXXXXXX' // international format, no '+'
+  const code = await client.requestPairingCode(phoneNumber)
+  // custom pairing code (8 characters):
+  // const code = await client.requestPairingCode(phoneNumber, 'YYYYYYYY')
+  console.log('Pairing code:', code)
+}
 ```
 
-# Store Data
-```javascript
-const {
-  default: makeWASocket,
-  makeInMemoryStore
-} = require('@alannxd/baileys');
-const pino = require('pino');
+## Store
+
+`makeInMemoryStore` builds a local cache of chats/contacts/messages, which
+Baileys does not persist automatically by default.
+
+```js
+import makeWASocket, { makeInMemoryStore } from '@alannxd/baileys'
+import pino from 'pino'
 
 const store = makeInMemoryStore({
   logger: pino().child({ level: 'silent', stream: 'store' })
-});
-const client = makeWASocket({
-  // option
-});
+})
+
+const client = makeWASocket({ /* ...other options */ })
 store.bind(client.ev)
 
 client.ev.on('contacts.upsert', () => {
-  console.log('Get new contact: ' + Object.values(store.contacts()));
+  console.log('New contact:', Object.values(store.contacts))
 })
 ```
-# Sending messages
-
-## send/relay message with participant
-```javascript
-await client.relayMessage(m.chat, {
-  conversation: "Alann Winter's"
-}, {
-  participant: true
-})
-// or
-await client.sendMessage(m.chat, {
-  text: "Alann Winter's"
-}, {
-  participant: true
-})
-```
-## send orderMessage
-```javascript
-const fs = require('fs');
-const AlannXd = fs.readFileSync('./AlannXd');
-
-await client.sendMessage(m.chat, {
-  thumbnail: AlannXd,
-  message: "Gotta get a grip",
-  orderTitle: "Alann-Winters",
-  totalAmount1000: 72502,
-  totalCurrencyCode: "IDR"
-}, { quoted:m })
-```
 
-## send pollResultSnapshotMessage
-```javascript
-await client.sendMessage(m.chat, {
-  pollResultMessage: {
-    name: "Alann-Winters",
-    options: [
-      {
-        optionName: "poll 1"
-      },
-      {
-        optionName: "poll 2"
-      }
-    ],
-    newsletter: {
-      newsletterName: "ALANNXD | HOLOW",
-      newsletterJid: "1@newsletter"
-    }
-  }
-})
-```
+Need a persistent store (Redis, etc.)? Use `makeCacheManagerStore` — see [API Reference](docs/API.md#store-libstore).
 
-## send productMessage
-```javascript
-await client.relayMessage(m.chat, {
-  productMessage {
-    title: "AlannWinter's",
-    description: "zazaza...",
-    thumbnail: { url: "./AlannXd" },
-    productId: "EXAMPLE_TOKEN",
-    retailerId: "EXAMPLE_RETAILER_ID",
-    url: "https://t.me/alannxd",
-    body: "Apalah ya",
-    footer: "Footer",
-    buttons: [
-      {
-        name: "cta_url",
-        buttonParamsJson: "{\"display_text\":\"AlannWinters\",\"url\":\"https://t.me/alannxd\"}"
-      }
-    ],
-    priceAmount1000: 72502,
-    currencyCode: "IDR"
-  }
+### Saving the store to a file
+
+`makeInMemoryStore` can read/write its state to a local JSON file, so it
+survives restarts without needing an external database:
+
+```js
+const store = makeInMemoryStore({ /* ... */ })
+
+// load once on startup, then auto-save every 10s
+const stopAutoSave = store.writeToFileInterval('./store.json')
+
+process.on('SIGINT', () => {
+  stopAutoSave()
+  process.exit(0)
 })
 ```
 
-## send interactiveMessage
-```javascript
-await client.sendMessage(m.chat, {
-  image: { url: "./alxd.jpg" },
-  text: "body",
-  title: "title", // if media, should put title in
-  footer: "footer",
-  interactiveButtons: [
-    {
-      name: "single_select",
-      buttonParamsJson: JSON.stringify({
-        title: "\0"
-      })
-    }
-  ],
-  messageParams: JSON.stringify({
-    bottom_sheet: {
-      /** ot params **/
-    }
-  })
-})
+Or handle it manually with `store.readFromFile(path)` / `store.writeToFile(path)` — see [API Reference](docs/API.md#file-persistence-makeinmemorystore) for details.
+
+## Sending Messages
+
+### Generic send / relay
+
+```js
+// relayMessage — send a raw message object, bypassing the sendMessage pipeline
+await client.relayMessage(jid, { conversation: 'Hello from Baileys' }, {})
+
+// sendMessage — the common way to send a message
+await client.sendMessage(jid, { text: 'Hello from Baileys' })
 ```
 
-## send member label
-```javascript
-await client.sendMessage(m.chat, {
-  groupLabel: {
-    labelText: "Tag anggota tercantum di sini"
-  }
-})
+### Simple senders
+
+All the `sendX` functions below are shortcuts on top of `sendMessage`.
+
+```js
+await client.sendText(jid, 'Hi!', { contextInfo: { mentionedJid: [jid] } })
+await client.sendImage(jid, { url: './photo.jpg' }, 'image caption')
+await client.sendVideo(jid, { url: './clip.mp4' }, 'video caption')
+await client.sendAudio(jid, { url: './clip.mp3' })
+await client.sendLocation(jid, 'Location name', -6.2, 106.8, 'https://maps.example', '1234567890')
+await client.sendPoll(jid, 'Pick one', ['Option 1', 'Option 2', 'Option 3'], /* multiSelect */ true)
+await client.sendQuiz(jid, 'Correct answer?', ['1', '2', '3'], /* correctIndex */ '2')
 ```
 
-## send message to members in group
-```javascript
-await client.sendMessageMembers(m.chat, {
-  extendedTextMessage: {
-    text: "woik sialan"
+### Special message types
+
+Handled internally by the `Socket/luxu.js` helper, invoked automatically via
+`sendMessage`/`relayMessage` whenever the content includes one of the fields below.
+
+```js
+// Product message (catalog)
+await client.relayMessage(jid, {
+  productMessage: {
+    title: 'Product Name',
+    description: 'Product description',
+    thumbnail: { url: './product.jpg' },
+    productId: 'PRODUCT_ID',
+    retailerId: 'RETAILER_ID',
+    url: 'https://store.example/product',
+    body: 'Body text',
+    footer: 'Footer text',
+    priceAmount1000: 72502, // price x 1000
+    currencyCode: 'IDR'
   }
 }, {})
-```
-# Simple sendMessage
 
-## send text
-```javascript
-await client.sendText(m.chat, "AlannWinters", {
-  contextInfo: {
-    mentionedJid: [m.chat]
-  }
-}, {
-  key: {
-    remoteJid: "status@broadcast",
-    participant: m.sender,
-    fromMe: true
-  },
-  message: {
-    conversation: "\0"
-  }
-})
-```
-## send image
-```javascript
-await client.sendImage(m.chat, { url: "./alxd.jpg" }, "AlannWinters", {
-  contextInfo: {
-    mentionedJid: [m.chat]
-  }
-}, {
-  key: {
-    remoteJid: "status@broadcast",
-    participant: m.sender,
-    fromMe: true
-  },
-  message: {
-    conversation: "\0"
-  }
-})
-```
+// Order message
+await client.sendMessage(jid, {
+  thumbnail: fs.readFileSync('./thumb.jpg'),
+  message: 'Order details',
+  orderTitle: 'Store Name',
+  totalAmount1000: 72502,
+  totalCurrencyCode: 'IDR'
+}, { quoted: m })
 
-## send video
-```javascript
-await client.sendVideo(m.chat, { url: "./alanxd.mp4" }, "AlannWinters", {
-  contextInfo: {
-    mentionedJid: [m.chat]
-  }
-}, {
-  key: {
-    remoteJid: "status@broadcast",
-    participant: m.sender,
-    fromMe: true
-  },
-  message: {
-    conversation: "\0"
+// Poll result snapshot (usually from a newsletter)
+await client.sendMessage(jid, {
+  pollResultMessage: {
+    name: 'Poll Title',
+    options: [{ optionName: 'Option 1' }, { optionName: 'Option 2' }],
+    newsletter: { newsletterName: 'Newsletter Name', newsletterJid: '1234567890@newsletter' }
   }
 })
-```
 
-## send audio
-```javascript
-await client.sendAudio(m.chat, { url: "./alanxd.mp3" }, {
-  contextInfo: {
-    mentionedJid: [m.chat]
-  }
-}, {
-  key: {
-    remoteJid: "status@broadcast",
-    participant: m.sender,
-    fromMe: true
-  },
-  message: {
-    conversation: "\0"
-  }
+// Interactive message (button)
+await client.sendMessage(jid, {
+  image: { url: './banner.jpg' },
+  text: 'Message body',
+  title: 'Title',
+  footer: 'Footer',
+  interactiveButtons: [{
+    name: 'cta_url',
+    buttonParamsJson: JSON.stringify({ display_text: 'Visit', url: 'https://example.com' })
+  }]
 })
-```
 
-## send location
-```javascript
-await client.sendLocation(m.chat, "AlannWinters", 90.0, 90.0, "https://t.me/alannxd", "1234567890", {
-  contextInfo: {
-    mentionedJid: [m.chat]
-  }
-}, {
-  key: {
-    remoteJid: "status@broadcast",
-    participant: m.sender,
-    fromMe: true
-  },
-  message: {
-    conversation: "\0"
-  }
+// Group member label
+await client.sendMessage(jid, {
+  groupLabel: { labelText: 'Admin' }
 })
-```
 
-## send polling
-```javascript
-await client.sendPoll(m.chat, "AlannWinters", ["1", "2", "3"], true, {
-  contextInfo: {
-    mentionedJid: [m.chat]
-  }
-}, {
-  key: {
-    remoteJid: "status@broadcast",
-    participant: m.sender,
-    fromMe: true
-  },
-  message: {
-    conversation: "\0"
-  }
-})
+// Broadcast to specific group members
+await client.sendMessageMembers(jid, { extendedTextMessage: { text: 'Announcement' } }, {})
 ```
 
-## send quiz
-```javascript
-await client.sendQuiz(m.chat, "AlannWinters", ["1", "2", "3"], "2", {
-  contextInfo: {
-    mentionedJid: [m.chat]
-  }
-}, {
-  key: {
-    remoteJid: "status@broadcast",
-    participant: m.sender,
-    fromMe: true
-  },
-  message: {
-    conversation: "\0"
-  }
+> Fields like `sender` and `participant: true` in the second argument of
+> `sendMessage`/`relayMessage` are used for group-participant send context — see
+> [`docs/API.md`](docs/API.md) for details on each socket layer.
+
+## Events
+
+All interaction happens through events on `client.ev`:
+
+```js
+client.ev.on('connection.update', ({ connection, lastDisconnect }) => {
+  console.log('Connection status:', connection)
 })
-```
 
-## send status mention
-```javascript
-await client.statusMention(m.chat, {
-  extendedTextMessage: {
-    text: "AlannWinters"
+client.ev.on('messages.upsert', ({ messages, type }) => {
+  for (const m of messages) {
+    console.log('Incoming message:', m.message)
   }
 })
+
+client.ev.on('creds.update', saveCreds)
 ```
 
----
+See the full list of events in `lib/Types/Events.js`.
+
+## Examples
+
+Ready-to-run scripts live in [`examples/`](examples):
+
+- [`examples/qr-login.js`](examples/qr-login.js) — QR login with auto-reconnect
+- [`examples/pairing-code.js`](examples/pairing-code.js) — pairing code login
+- [`examples/store-usage.js`](examples/store-usage.js) — using the in-memory store
+
+## Known Limitations
+
+- **No `.d.ts` for `lib/`** — only `WAProto` ships TypeScript types. Full autocomplete requires the TS source, which isn't included in this build.
+- **Console banner on import** — every time the package is `import`ed, an ASCII art banner and promotional link are printed to stdout. In production or multi-instance setups this becomes log noise.
+- **`optionHash` for per-option image polls** is not implemented — it appears to require further reverse-engineering at the WhatsApp APK level.
+- See [`docs/API.md`](docs/API.md#️-important-notes) for other technical notes.
 
 ## Why Choose WhatsApp Baileys?
 
@@ -424,10 +350,9 @@ Thanks to the following awesome contributors who help improve this project
       </a>
     </td>
     <td align="center">
-      <a href="https://github.com/tenka-san">
-        <img src="https://github.com/tenka-san.png" width="80px;" style="border-radius:50%;" alt="Developer"/>
-        <br />
-        <sub><b>D | Yuukey-7eppeli</b></sub>
+      <a href="https://github.com/Xazepysk">
+        <img src="https://github.com/XazepysK.png" width="80px;" style="border-radius:50%;" alt="Contributor"/>
+        <br /><sub><b>Xaz zepysK</b></sub>
       </a>
     </td>
 <td align="center">
@@ -445,5 +370,4 @@ Thanks to the following awesome contributors who help improve this project
       </a>
     </td>
   </tr>
-</table>
-
+</table>

package/lib/Defaults/index.js

@@ -2,7 +2,7 @@ import { proto } from '../../WAProto/index.js';
 import { makeLibSignalRepository } from '../Signal/libsignal.js';
 import { Browsers } from '../Utils/browser-utils.js';
 import logger from '../Utils/logger.js';
-const version = [2, 3000, 1035194821];
+const version = [2, 3000, 1043857760];
 export const UNAUTHORIZED_CODES = [401, 403, 419];
 export const DEFAULT_ORIGIN = 'https://web.whatsapp.com';
 export const CALL_VIDEO_PREFIX = 'https://call.whatsapp.com/video/';

package/lib/Socket/chats.js

@@ -397,6 +397,11 @@ export const makeChatsSocket = (config) => {
         return {
             onMutation(mutation) {
                 processSyncAction(mutation, ev, authState.creds.me, isInitialSync ? { accountSettings: authState.creds.accountSettings } : undefined, logger);
+                const nctSalt = mutation?.syncAction?.value?.nctSaltSyncAction?.salt;
+                if (nctSalt?.length) {
+                    authState.keys.set({ 'nct-salt': { default: Buffer.from(nctSalt) } })
+                        .catch(err => logger?.debug({ err: err?.message }, 'failed to store nct salt'));
+                }
             }
         };
     };