feat: support external browser + page in puppeteer options

allow passing a pre-existing `browser` and `page` via
`options.puppeteer` so the Client can work with a browser
you already control.

when both are provided, the Client skips puppeteer.launch()
and uses them directly.

also uses browser.process() in destroy/logout to decide
cleanup: close() for launched browsers, disconnect() for
connected ones.

Author: Adi1231234

index.d.ts

@@ -695,7 +695,12 @@ declare namespace WAWebJS {
         evalOnNewDoc?: Function;
         /** Puppeteer launch options. View docs here: https://github.com/puppeteer/puppeteer/ */
         puppeteer?: puppeteer.PuppeteerNodeLaunchOptions &
-            puppeteer.ConnectOptions;
+            puppeteer.ConnectOptions & {
+                /** Pre-existing browser instance to use instead of launching a new one */
+                browser?: puppeteer.Browser;
+                /** Pre-existing page instance to use */
+                page?: puppeteer.Page;
+            };
         /** Determines how to save and restore sessions. Will use LegacySessionAuth if options.session is set. Otherwise, NoAuth will be used. */
         authStrategy?: AuthStrategy;
         /** The version of WhatsApp Web to use. Use options.webVersionCache to configure how the version is retrieved. */

src/Client.js

@@ -442,7 +442,11 @@ class Client extends EventEmitter {
         await this.authStrategy.beforeBrowserInitialized();
 
         const puppeteerOpts = this.options.puppeteer;
-        if (
+        if (puppeteerOpts && puppeteerOpts.browser && puppeteerOpts.page) {
+            // External browser + page provided by caller
+            browser = puppeteerOpts.browser;
+            page = puppeteerOpts.page;
+        } else if (
             puppeteerOpts &&
             (puppeteerOpts.browserWSEndpoint || puppeteerOpts.browserURL)
         ) {
@@ -1181,7 +1185,11 @@ class Client extends EventEmitter {
         const browser = this.pupBrowser;
         const isConnected = browser?.isConnected?.();
         if (isConnected) {
-            await browser.close();
+            if (browser.process()) {
+                await browser.close();
+            } else {
+                browser.disconnect();
+            }
         }
         await this.authStrategy.destroy();
     }
@@ -1193,13 +1201,16 @@ class Client extends EventEmitter {
         await this.pupPage.evaluate(() => {
             return window.require('WAWebSocketModel').Socket.logout();
         });
-        await this.pupBrowser.close();
+        if (this.pupBrowser.process()) {
+            await this.pupBrowser.close();
 
-        let maxDelay = 0;
-        while (this.pupBrowser.isConnected() && maxDelay < 10) {
-            // waits a maximum of 1 second before calling the AuthStrategy
-            await new Promise((resolve) => setTimeout(resolve, 100));
-            maxDelay++;
+            let maxDelay = 0;
+            while (this.pupBrowser.isConnected() && maxDelay < 10) {
+                await new Promise((resolve) => setTimeout(resolve, 100));
+                maxDelay++;
+            }
+        } else {
+            this.pupBrowser.disconnect();
         }
 
         await this.authStrategy.logout();