@pney/whatsapp-web 1.34.6 → 1.34.7-2

package/.env.example

@@ -1,3 +1,2 @@
 WWEBJS_TEST_REMOTE_ID=XXXXXXXXXX@c.us
 WWEBJS_TEST_CLIENT_ID=authenticated
-WWEBJS_TEST_MD=1

package/.gitattributes

@@ -0,0 +1,4 @@
+* text=auto eol=lf
+
+package-lock.json linguist-generated=true text=auto eol=lf
+docs/* linguist-generated=true text=auto eol=lf

package/.husky/commit-msg

@@ -0,0 +1,4 @@
+# Normalize commit type to lowercase
+sed -E 's/^[A-Za-z]+/\L&/' "$1" > "$1.tmp" && mv "$1.tmp" "$1"
+
+npx --no-install commitlint --edit "$1"

package/.husky/pre-commit

@@ -0,0 +1 @@
+npx lint-staged

package/.lintstagedrc.json

@@ -0,0 +1,6 @@
+{
+    "*": "prettier --ignore-unknown --write",
+    "*.{js,ts}": "eslint --fix",
+    "src/**/*.{js,ts}": "eslint --fix",
+    "tests/**/*.{js,ts}": "eslint --fix"
+}

package/.prettierignore

@@ -0,0 +1,8 @@
+node_modules
+dist
+coverage
+*.min.js
+.wa-version
+.wwebjs_auth
+.wwebjs_cache
+docs

package/.prettierrc.json

@@ -0,0 +1,10 @@
+{
+    "semi": true,
+    "trailingComma": "all",
+    "singleQuote": true,
+    "printWidth": 80,
+    "tabWidth": 4,
+    "useTabs": false,
+    "arrowParens": "always",
+    "endOfLine": "lf"
+}

package/README.md

@@ -1,59 +1,65 @@
 <div align="center">
-    <br />
     <p>
-        <a href="https://wwebjs.dev"><img src="https://github.com/wwebjs/assets/blob/main/Collection/GitHub/wwebjs.png?raw=true" title="whatsapp-web.js" alt="WWebJS Website" width="500" /></a>
+        <a href="https://wwebjs.dev">
+            <img src="https://github.com/wwebjs/Assets/blob/main/Collection/GitHub/whatsapp-web.js.png?raw=true"
+                title="whatsapp-web.js" alt="WWebJS Website" />
+        </a>
     </p>
-    <br />
     <p>
-		<a href="https://www.npmjs.com/package/whatsapp-web.js"><img src="https://img.shields.io/npm/v/whatsapp-web.js.svg" alt="npm" /></a>
-        <a href="https://depfu.com/github/pedroslopez/whatsapp-web.js?project_id=9765"><img src="https://badges.depfu.com/badges/4a65a0de96ece65fdf39e294e0c8dcba/overview.svg" alt="Depfu" /></a>
-        <img src="https://img.shields.io/badge/WhatsApp_Web-2.3000.1017054665-brightgreen.svg" alt="WhatsApp_Web 2.2346.52" />
-        <a href="https://discord.gg/H7DqQs4"><img src="https://img.shields.io/discord/698610475432411196.svg?logo=discord" alt="Discord server" /></a>
-	</p>
-    <br />
+        <a href="https://www.npmjs.com/package/whatsapp-web.js"><img
+                src="https://img.shields.io/npm/v/whatsapp-web.js.svg" alt="npm" /></a>
+        <a href="https://www.npmjs.com/package/whatsapp-web.js"><img alt="NPM Downloads"
+                src="https://img.shields.io/npm/d18m/whatsapp-web.js" /></a>
+        <a href="https://github.com/wwebjs/whatsapp-web.js/graphs/contributors"><img alt="GitHub contributors"
+                src="https://img.shields.io/github/contributors-anon/wwebjs/whatsapp-web.js" /></a>
+        <a href="https://depfu.com/github/wwebjs/whatsapp-web.js?project_id=9765"><img
+                src="https://badges.depfu.com/badges/4a65a0de96ece65fdf39e294e0c8dcba/overview.svg" alt="Depfu" /></a>
+        <a href="https://discord.wwebjs.dev"><img
+                src="https://img.shields.io/discord/698610475432411196.svg?logo=discord" alt="Discord server" /></a>
+    </p>
 </div>
 
 ## About
-**A WhatsApp API client that operates via the WhatsApp Web browser.**
-
-The library launches the WhatsApp Web browser app via Puppeteer, accessing its internal functions and creating a managed instance to reduce the risk of being blocked. This gives the API client nearly all WhatsApp Web features for dynamic use in a Node.js application.
 
-> [!IMPORTANT]
-> **It is not guaranteed you will not be blocked by using this method. WhatsApp does not allow bots or unofficial clients on their platform, so this shouldn't be considered totally safe.**
+whatsapp‑web.js is a powerful [Node.js][nodejs] library that lets you interact with WhatsApp Web, making it easy to build a dynamic WhatsApp API with nearly all features of the web client. It uses [Puppeteer][puppeteer] to access WhatsApp Web’s internal functions and runs them in a managed browser instance to reduce the risk of being blocked.
 
 ## Links
 
-* [GitHub][gitHub]
-* [Guide][guide] ([source][guide-source])
-* [Documentation][documentation] ([source][documentation-source])
-* [Discord Server][discord]
-* [npm][npm]
+- [GitHub][gitHub]
+- [Guide][guide] ([source][guide-source])
+- [Documentation][documentation] ([source][documentation-source])
+- [Discord Server][discord]
+- [npm][npm]
 
 ## Installation
 
-The module is available on [npm][npm] via `npm i whatsapp-web.js`!
+**Node.js `v18.0.0` or higher, is required.**
+
+```sh
+npm install whatsapp-web.js
+yarn add whatsapp-web.js
+pnpm add whatsapp-web.js
+```
 
-> [!NOTE]
-> **Node ``v18`` or higher, is required.**  
-> See the [Guide][guide] for quick upgrade instructions.
+Having trouble installing? Take a peak at the [Guide][guide] for more detailed instructions.
 
 ## Example usage
 
 ```js
 const { Client } = require('whatsapp-web.js');
+const qrcode = require('qrcode-terminal');
 
 const client = new Client();
 
 client.on('qr', (qr) => {
-    // Generate and scan this code with your phone
-    console.log('QR RECEIVED', qr);
+    qrcode.generate(qr, { small: true });
 });
 
 client.on('ready', () => {
     console.log('Client is ready!');
 });
 
-client.on('message', msg => {
+client.on('message', (msg) => {
     if (msg.body == '!ping') {
         msg.reply('pong');
     }
@@ -62,60 +68,58 @@ client.on('message', msg => {
 client.initialize();
 ```
 
-Take a look at [example.js][examples] for another examples with additional use cases.  
-For further details on saving and restoring sessions, explore the provided [Authentication Strategies][auth-strategies].
-
+Take a look at [example.js][examples] for additional examples and use cases.  
+For more details on saving and restoring sessions, check out the [Authentication Strategies][auth-strategies].
 
 ## Supported features
 
-| Feature  | Status |
-| ------------- | ------------- |
-| Multi Device  | ✅  |
-| Send messages  | ✅  |
-| Receive messages  | ✅  |
-| Send media (images/audio/documents)  | ✅  |
-| Send media (video)  | ✅ [(requires Google Chrome)][google-chrome]  |
-| Send stickers | ✅ |
-| Receive media (images/audio/video/documents)  | ✅  |
-| Send contact cards | ✅ |
-| Send location | ✅ |
-| Send buttons | ❌  [(DEPRECATED)][deprecated-video] |
-| Send lists | ❌  [(DEPRECATED)][deprecated-video] |
-| Receive location | ✅ | 
-| Message replies | ✅ |
-| Join groups by invite  | ✅ |
-| Get invite for group  | ✅ |
-| Modify group info (subject, description)  | ✅  |
-| Modify group settings (send messages, edit info)  | ✅  |
-| Add group participants  | ✅  |
-| Kick group participants  | ✅  |
-| Promote/demote group participants | ✅ |
-| Mention users | ✅ |
-| Mention groups | ✅ |
-| Mute/unmute chats | ✅ |
-| Block/unblock contacts | ✅ |
-| Get contact info | ✅ |
-| Get profile pictures | ✅ |
-| Set user status message | ✅ |
-| React to messages | ✅ |
-| Create polls | ✅ |
-| Channels | ✅ |
-| Vote in polls | 🔜 |
-| Communities | 🔜 |
+| Feature                                          | Status                                       |
+| ------------------------------------------------ | -------------------------------------------- |
+| Multi Device                                     | ✅                                           |
+| Send messages                                    | ✅                                           |
+| Receive messages                                 | ✅                                           |
+| Send media (images/audio/documents)              | ✅                                           |
+| Send media (video)                               | ✅ [(requires Google Chrome)][google-chrome] |
+| Send stickers                                    | ✅                                           |
+| Receive media (images/audio/video/documents)     | ✅                                           |
+| Send contact cards                               | ✅                                           |
+| Send location                                    | ✅                                           |
+| Send buttons                                     | ❌ [(DEPRECATED)][deprecated-video]          |
+| Send lists                                       | ❌ [(DEPRECATED)][deprecated-video]          |
+| Receive location                                 | ✅                                           |
+| Message replies                                  | ✅                                           |
+| Join groups by invite                            | ✅                                           |
+| Get invite for group                             | ✅                                           |
+| Modify group info (subject, description)         | ✅                                           |
+| Modify group settings (send messages, edit info) | ✅                                           |
+| Add group participants                           | ✅                                           |
+| Kick group participants                          | ✅                                           |
+| Promote/demote group participants                | ✅                                           |
+| Mention users                                    | ✅                                           |
+| Mention groups                                   | ✅                                           |
+| Mute/unmute chats                                | ✅                                           |
+| Block/unblock contacts                           | ✅                                           |
+| Get contact info                                 | ✅                                           |
+| Get profile pictures                             | ✅                                           |
+| Set user status message                          | ✅                                           |
+| React to messages                                | ✅                                           |
+| Create polls                                     | ✅                                           |
+| Channels                                         | ✅                                           |
+| Vote in polls                                    | ✅                                           |
+| Communities                                      | 🔜                                           |
 
 Something missing? Make an issue and let us know!
 
-## Contributing
-
-Feel free to open pull requests; we welcome contributions! However, for significant changes, it's best to open an issue beforehand. Make sure to review our [contribution guidelines][contributing] before creating a pull request. Before creating your own issue or pull request, always check to see if one already exists!
-
 ## Supporting the project
 
-You can support the maintainer of this project through the links below
+You can support the maintainer of this project through the links below:
 
 - [Support via GitHub Sponsors][gitHub-sponsors]
 - [Support via PayPal][support-payPal]
-- [Sign up for DigitalOcean][digitalocean] and get $200 in credit when you sign up (Referral)
+
+## Contributing
+
+Feel free to open pull requests; we welcome contributions! However, for significant changes, it's best to open an issue beforehand. Make sure to review our [contribution guidelines][contributing] before creating a pull request. Before creating your own issue or pull request, always check to see if one already exists!
 
 ## Disclaimer
 
@@ -123,33 +127,32 @@ This project is not affiliated, associated, authorized, endorsed by, or in any w
 
 ## License
 
-Copyright 2019 Pedro S Lopez  
+Copyright 2019 Pedro S Lopez
 
 Licensed under the Apache License, Version 2.0 (the "License");  
 you may not use this project except in compliance with the License.  
-You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.  
+You may obtain a copy of the License at <https://www.apache.org/licenses/LICENSE-2.0>.
 
 Unless required by applicable law or agreed to in writing, software  
 distributed under the License is distributed on an "AS IS" BASIS,  
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  
 See the License for the specific language governing permissions and  
-limitations under the License.  
-
+limitations under the License.
 
 [guide]: https://guide.wwebjs.dev/guide
 [guide-source]: https://github.com/wwebjs/wwebjs.dev/tree/main
 [documentation]: https://docs.wwebjs.dev/
-[documentation-source]: https://github.com/pedroslopez/whatsapp-web.js/tree/main/docs
-[discord]: https://discord.gg/H7DqQs4
-[gitHub]: https://github.com/pedroslopez/whatsapp-web.js
+[documentation-source]: https://github.com/wwebjs/whatsapp-web.js/tree/main/docs
+[discord]: https://discord.wwebjs.dev
+[gitHub]: https://github.com/wwebjs/whatsapp-web.js
 [npm]: https://npmjs.org/package/whatsapp-web.js
 [nodejs]: https://nodejs.org/en/download/
-[examples]: https://github.com/pedroslopez/whatsapp-web.js/blob/master/example.js
+[examples]: https://github.com/wwebjs/whatsapp-web.js/blob/main/example.js
 [auth-strategies]: https://wwebjs.dev/guide/creating-your-bot/authentication.html
 [google-chrome]: https://wwebjs.dev/guide/creating-your-bot/handling-attachments.html#caveat-for-sending-videos-and-gifs
 [deprecated-video]: https://www.youtube.com/watch?v=hv1R1rLeVVE
-[gitHub-sponsors]: https://github.com/sponsors/pedroslopez
+[gitHub-sponsors]: https://github.com/sponsors/wwebjs
 [support-payPal]: https://www.paypal.me/psla/
-[digitalocean]: https://m.do.co/c/73f906a36ed4
-[contributing]: https://github.com/pedroslopez/whatsapp-web.js/blob/main/CODE_OF_CONDUCT.md
+[contributing]: .github/CONTRIBUTING.md
 [whatsapp]: https://whatsapp.com
+[puppeteer]: https://pptr.dev/

package/commitlint.config.js

@@ -0,0 +1,29 @@
+module.exports = {
+    extends: ['@commitlint/config-conventional'],
+    rules: {
+        'header-max-length': [2, 'always', 72],
+        'type-enum': [
+            2,
+            'always',
+            [
+                'feat',
+                'fix',
+                'docs',
+                'style',
+                'refactor',
+                'perf',
+                'test',
+                'build',
+                'ci',
+                'chore',
+                'types',
+                'revert',
+                'infra',
+            ],
+        ],
+        'type-case': [0],
+        'scope-case': [0],
+        'subject-case': [0],
+        'subject-exclamation-mark': [0],
+    },
+};

package/eslint.config.mjs

@@ -0,0 +1,67 @@
+import globals from 'globals';
+import pluginEslintJs from '@eslint/js';
+import pluginMocha from 'eslint-plugin-mocha';
+import configEslintConfigPrettier from 'eslint-plugin-prettier/recommended';
+
+export default [
+    pluginEslintJs.configs.recommended,
+    {
+        name: 'whatsapp-web.js/default/rules',
+        plugins: {
+            mocha: pluginMocha,
+        },
+        languageOptions: {
+            ecmaVersion: 2025,
+
+            globals: {
+                ...globals.browser,
+                ...globals.commonjs,
+                ...globals.es6,
+                ...globals.node,
+
+                Atomics: 'readonly',
+                SharedArrayBuffer: 'readonly',
+            },
+        },
+        rules: {
+            'no-unused-vars': [
+                'error',
+                {
+                    // TODO: args can be uncommented, but there is code, that causes lint-errors
+                    // args: 'all',
+                    vars: 'all',
+                    caughtErrorsIgnorePattern: '^ignoredError',
+                },
+            ],
+        },
+    },
+    {
+        // be careful, "recommended" settings object has 4 fields:
+        // - name (string)
+        // - plugins (object)
+        // - languageOptions (object)
+        // - rules (object)
+        //
+        // by simple "adding" any of mentioned fields to this object
+        // you REPLACE the "recommended" value.
+        // If you want to PATCH it - consider nested "..." spread operator
+        ...pluginMocha.configs.recommended,
+        name: 'whatsapp-web.js/default/mocha',
+
+        files: ['tests/**/*'],
+    },
+    {
+        name: 'whatsapp-web.js/default/ignores',
+        ignores: [
+            'node_modules',
+            'dist',
+            'coverage',
+            'docs',
+            '*.min.js',
+            '.wa-version',
+            '.wwebjs_auth',
+            '.wwebjs_cache',
+        ],
+    },
+    configEslintConfigPrettier,
+];