feat: re-apply custom patches on top of upstream/main

- puppeteer-extra with stealth and adblocker plugins
- require() error wrapper to prevent crashes
- AB-flag conditional prefetch loadables with 10s delay
- auto-dismiss new version modal (multi-language)
- LID resolution fallback in getChat via WAWebContactSyncUtils
- CODE_FAILED event
- messageSecret optional typing fix

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: Alexey Poliakov

index.d.ts

@@ -714,6 +714,11 @@ declare namespace WAWebJS {
         webVersion?: string;
         /**  Determines how to retrieve the WhatsApp Web version specified in options.webVersion. */
         webVersionCache?: WebCacheOptions;
+        /**
+         * Enable the stealth version of wwebjs, uses puppeteer-stealth and adblocker
+         * @default false
+         */
+        stealth?: boolean;
         /** How many times should the qrcode be refreshed before giving up
          * @default 0 (disabled) */
         qrMaxRetries?: number;
@@ -1025,6 +1030,7 @@ declare namespace WAWebJS {
         GROUP_UPDATE = 'group_update',
         QR_RECEIVED = 'qr',
         CODE_RECEIVED = 'code',
+        CODE_FAILED = 'code_failed',
         LOADING_SCREEN = 'loading_screen',
         CALL = 'call',
         DISCONNECTED = 'disconnected',
@@ -1415,7 +1421,7 @@ declare namespace WAWebJS {
          * The custom message secret, can be used as a poll ID
          * @note It has to be a unique vector with a length of 32
          */
-        messageSecret: Array<number> | undefined;
+        messageSecret?: Array<number>;
     }
 
     /** Represents a Poll on WhatsApp */
@@ -1453,7 +1459,7 @@ declare namespace WAWebJS {
          * The custom message secret, can be used as an event ID
          * @note It has to be a unique vector with a length of 32
          */
-        messageSecret: Array<number> | undefined;
+        messageSecret?: Array<number>;
     }
 
     /** Represents a ScheduledEvent on WhatsApp */

package.json

@@ -39,6 +39,9 @@
         "mime": "^3.0.0",
         "node-fetch": "^2.6.9",
         "node-webpmux": "3.1.7",
+        "puppeteer-extra": "^3.3.6",
+        "puppeteer-extra-plugin-adblocker": "^2.13.6",
+        "puppeteer-extra-plugin-stealth": "^2.11.2",
         "puppeteer": "^24.31.0"
     },
     "devDependencies": {

src/Client.js

@@ -1,7 +1,9 @@
 'use strict';
 
 const EventEmitter = require('events');
-const puppeteer = require('puppeteer');
+const puppeteer = require('puppeteer-extra');
+const StealthPlugin = require('puppeteer-extra-plugin-stealth');
+const AdblockerPlugin = require('puppeteer-extra-plugin-adblocker');
 
 const Util = require('./util/Util');
 const InterfaceController = require('./util/InterfaceController');
@@ -142,6 +144,18 @@ class Client extends EventEmitter {
 
         await this.pupPage.evaluate(ExposeAuthStore);
 
+        await this.pupPage.evaluate(() => {
+            const originalRequire = window.require;
+            window.require = (...args) => {
+                try {
+                    return originalRequire(...args);
+                } catch (error) {
+                    console.error('Error in require:', error, 'Args:', args);
+                    return {};
+                }
+            };
+        });
+
         const needAuthentication = await this.pupPage.evaluate(async () => {
             let state = window.require('WAWebSocketModel').Socket.state;
 
@@ -322,6 +336,18 @@ class Client extends EventEmitter {
                         await webCache.persist(this.currentIndexHtml, version);
                     }
 
+                    await new Promise((r) => setTimeout(r, 10000)); // Avoid error "Dropping db read operation due to logout"
+                    await this.pupPage.evaluate(async () => {
+                        const targetABFlag = 'wa_web_disable_prefetch_loadables';
+                        const ABPrefetchLoadablesExists = !!(await window.require('WAWebABPropsConfigs').ABPropConfigs[targetABFlag]);
+                        if (ABPrefetchLoadablesExists) {
+                            const isUsingABPrefetchLoadables = await window.require('WAWebABProps').getABPropConfigValue(targetABFlag);
+                            if (isUsingABPrefetchLoadables) {
+                                await window.require('WAWebPrefetchLoadables')();
+                            }
+                        }
+                    });
+
                     //Load util functions (serializers, helper functions)
                     await this.pupPage.evaluate(LoadUtils);
 
@@ -373,6 +399,7 @@ class Client extends EventEmitter {
                  */
                 this.emit(Events.READY);
                 this.authStrategy.afterAuthReady();
+                this.clickNewVersionModalButton();
             },
         );
         let lastPercent = null;
@@ -422,6 +449,50 @@ class Client extends EventEmitter {
         });
     }
 
+    /**
+     * Clicks on new version modal button to close it
+     */
+    async clickNewVersionModalButton() {
+        try {
+            const modalSelector = 'div[data-animate-modal-popup="true"]';
+            const modalExists = await this.pupPage
+                .waitForSelector(modalSelector, {
+                    timeout: 30000,
+                    visible: true,
+                })
+                .then(() => true)
+                .catch(() => false);
+            if (!modalExists) {
+                return;
+            }
+            const buttonSelector = `${modalSelector} button div:not(:empty)`;
+            const buttonText = [
+                'Продолжить',
+                'Continue',
+                'Continuar',
+                'Continuare',
+                'Continuez',
+                'Продовжити',
+            ];
+            await this.pupPage.evaluate(
+                (selector, buttonText) => {
+                    const elements = document.querySelectorAll(selector);
+                    for (const element of elements) {
+                        const text = element.textContent.trim();
+                        if (buttonText.includes(text)) {
+                            element.click();
+                            return;
+                        }
+                    }
+                },
+                buttonSelector,
+                buttonText,
+            );
+        } catch (error) {
+            console.error('Error clicking new version modal button:', error);
+        }
+    }
+
     /**
      * Sets up events and requirements, kicks off authentication request
      */
@@ -458,6 +529,15 @@ class Client extends EventEmitter {
             // navigator.webdriver fix
             browserArgs.push('--disable-blink-features=AutomationControlled');
 
+            if (this.options.stealth) {
+                const stealth = StealthPlugin();
+                stealth.enabledEvasions.delete('iframe.contentWindow');
+                stealth.enabledEvasions.delete('media.codecs');
+                stealth.enabledEvasions.delete('user-agent-override');
+                puppeteer.use(stealth);
+                puppeteer.use(AdblockerPlugin({ blockTrackers: true }));
+            }
+
             browser = await puppeteer.launch({
                 ...puppeteerOpts,
                 args: browserArgs,

src/util/Constants.js

@@ -68,6 +68,7 @@ exports.Events = {
     GROUP_UPDATE: 'group_update',
     QR_RECEIVED: 'qr',
     CODE_RECEIVED: 'code',
+    CODE_FAILED: 'code_failed',
     LOADING_SCREEN: 'loading_screen',
     DISCONNECTED: 'disconnected',
     STATE_CHANGED: 'change_state',

src/util/Injected/Utils.js

@@ -861,13 +861,41 @@ exports.LoadUtils = () => {
                 chat = null;
             }
         } else {
-            chat =
-                window.require('WAWebCollections').Chat.get(chatWid) ||
-                (
+            chat = window.require('WAWebCollections').Chat.get(chatWid);
+            if (!chat) {
+                chat = (
                     await window
                         .require('WAWebFindChatAction')
                         .findOrCreateLatestChat(chatWid)
+                        .catch(() => null)
                 )?.chat;
+            }
+            if (!chat) {
+                try {
+                    const query = window
+                        .require('WAWebContactSyncUtils')
+                        .constructUsyncDeltaQuery([
+                            {
+                                type: 'add',
+                                phoneNumber: chatWid.user,
+                            },
+                        ]);
+                    const result = await query.execute();
+                    if (result?.list?.[0]?.lid) {
+                        const chatLid = window
+                            .require('WAWebWidFactory')
+                            .createWid(result.list[0].lid);
+                        chat = (
+                            await window
+                                .require('WAWebFindChatAction')
+                                .findOrCreateLatestChat(chatLid)
+                                .catch(() => null)
+                        )?.chat;
+                    }
+                } catch (e) {
+                    // LID resolution failed, chat remains undefined
+                }
+            }
         }
 
         return getAsModel && chat