From bc5f864dd4df6068db1a0c4a503db10c7c603565 Mon Sep 17 00:00:00 2001
From: Dolav <sdolav@gmail.com>
Date: Wed, 15 Jul 2026 23:02:54 -0700
Subject: [PATCH 1/2] feat(client): add sendPresenceUpdate to Client to bypass
 database lookups

---
 index.d.ts      | 15 +++++++++++----
 src/Client.js   | 16 ++++++++++++++++
 tests/client.js | 10 ++++++++++
 3 files changed, 37 insertions(+), 4 deletions(-)

diff --git a/index.d.ts b/index.d.ts
index 8127770492b..f06a3cf1d03 100644
--- a/index.d.ts
+++ b/index.d.ts
@@ -212,10 +212,17 @@ declare namespace WAWebJS {
         ): Promise<Message>;
 
         /** Send a reaction to a specific messageId */
-        sendReaction(
-            messageId: string,
-            reaction: string,
-        ): Promise<void>;
+        sendReaction(messageId: string, reaction: string): Promise<void>;
+
+        /**
+         * Sends a presence state to a specific chat without fetching the chat from the database.
+         * @param {string} chatId The ID of the chat
+         * @param {string} state The presence state (e.g., 'typing', 'recording', 'paused')
+         */
+        sendPresenceUpdate(
+            chatId: string,
+            state?: 'typing' | 'recording' | 'paused',
+        ): Promise<boolean>;
 
         /** Sends a channel admin invitation to a user, allowing them to become an admin of the channel */
         sendChannelAdminInvite(
diff --git a/src/Client.js b/src/Client.js
index a122a8f336b..7dbccbdb147 100644
--- a/src/Client.js
+++ b/src/Client.js
@@ -1645,6 +1645,22 @@ class Client extends EventEmitter {
         );
     }
 
+    /**
+     * Sends a presence state to a specific chat without fetching the chat from the database.
+     * @param {string} chatId The ID of the chat
+     * @param {string} state The presence state (e.g., 'typing', 'recording', 'paused')
+     */
+    async sendPresenceUpdate(chatId, state = 'typing') {
+        return this.pupPage.evaluate(
+            (chatId, state) => {
+                window.WWebJS.sendChatstate(state, chatId);
+                return true;
+            },
+            chatId,
+            state,
+        );
+    }
+
     /**
      * @typedef {Object} SendChannelAdminInviteOptions
      * @property {?string} comment The comment to be added to an invitation
diff --git a/tests/client.js b/tests/client.js
index c0de50adb06..120018a3082 100644
--- a/tests/client.js
+++ b/tests/client.js
@@ -479,6 +479,16 @@ END:VCARD`;
             });
         });
 
+        describe('Presence Updates', function () {
+            it('can send a typing presence update via Client', async function () {
+                const result = await client.sendPresenceUpdate(
+                    remoteId,
+                    'typing',
+                );
+                expect(result).to.be.true;
+            });
+        });
+
         describe('Search messages', function () {
             it('can search for messages', async function () {
                 const m1 = await client.sendMessage(

From 2695a82774b3a1a525b53e66b4fdbbe99f3c5708 Mon Sep 17 00:00:00 2001
From: Dolav <sdolav@gmail.com>
Date: Wed, 15 Jul 2026 23:06:15 -0700
Subject: [PATCH 2/2] docs: regenerate documentation for sendPresenceUpdate

---
 docs/Base.html                               |   2 +-
 docs/BaseAuthStrategy.html                   |   2 +-
 docs/Broadcast.html                          |   2 +-
 docs/BusinessContact.html                    |   2 +-
 docs/Buttons.html                            |   2 +-
 docs/Call.html                               |   2 +-
 docs/Channel.html                            |   2 +-
 docs/Chat.html                               |   2 +-
 docs/Client.html                             | 160 +++--
 docs/Client.js.html                          | 670 +++++++++++--------
 docs/ClientInfo.html                         |   2 +-
 docs/Contact.html                            |   2 +-
 docs/GroupChat.html                          |   2 +-
 docs/GroupNotification.html                  |   2 +-
 docs/InterfaceController.html                |   2 +-
 docs/Label.html                              |   2 +-
 docs/List.html                               |   2 +-
 docs/LocalAuth.html                          |   2 +-
 docs/LocalWebCache.html                      |   2 +-
 docs/Location.html                           |   2 +-
 docs/Message.html                            |  86 ++-
 docs/MessageMedia.html                       |   2 +-
 docs/NoAuth.html                             |   2 +-
 docs/Order.html                              |   2 +-
 docs/Poll.html                               |   2 +-
 docs/PollVote.html                           |   2 +-
 docs/PrivateChat.html                        |   2 +-
 docs/PrivateContact.html                     |   2 +-
 docs/Product.html                            |   2 +-
 docs/Reaction.html                           |   2 +-
 docs/RemoteAuth.html                         |   2 +-
 docs/RemoteWebCache.html                     |   2 +-
 docs/ScheduledEvent.html                     |   2 +-
 docs/Util.html                               |   2 +-
 docs/WebCache.html                           |   2 +-
 docs/authStrategies_BaseAuthStrategy.js.html |   2 +-
 docs/authStrategies_LocalAuth.js.html        |   2 +-
 docs/authStrategies_NoAuth.js.html           |   2 +-
 docs/authStrategies_RemoteAuth.js.html       |   2 +-
 docs/global.html                             |   2 +-
 docs/index.html                              |  62 +-
 docs/structures_Base.js.html                 |   2 +-
 docs/structures_Broadcast.js.html            |   2 +-
 docs/structures_BusinessContact.js.html      |   2 +-
 docs/structures_Buttons.js.html              |   2 +-
 docs/structures_Call.js.html                 |   2 +-
 docs/structures_Channel.js.html              |   2 +-
 docs/structures_Chat.js.html                 |   2 +-
 docs/structures_ClientInfo.js.html           |   2 +-
 docs/structures_Contact.js.html              |  44 +-
 docs/structures_GroupChat.js.html            |   2 +-
 docs/structures_GroupNotification.js.html    |   2 +-
 docs/structures_Label.js.html                |   2 +-
 docs/structures_List.js.html                 |   2 +-
 docs/structures_Location.js.html             |   2 +-
 docs/structures_Message.js.html              | 151 +++--
 docs/structures_MessageMedia.js.html         |   2 +-
 docs/structures_Order.js.html                |   2 +-
 docs/structures_Payment.js.html              |   2 +-
 docs/structures_Poll.js.html                 |   2 +-
 docs/structures_PollVote.js.html             |   2 +-
 docs/structures_PrivateChat.js.html          |   2 +-
 docs/structures_PrivateContact.js.html       |   2 +-
 docs/structures_Product.js.html              |   2 +-
 docs/structures_ProductMetadata.js.html      |   2 +-
 docs/structures_Reaction.js.html             |   2 +-
 docs/structures_ScheduledEvent.js.html       |   2 +-
 docs/util_Constants.js.html                  |   2 +-
 docs/util_Injected_Utils.js.html             |  59 +-
 docs/util_InterfaceController.js.html        |   2 +-
 docs/util_Puppeteer.js.html                  |   2 +-
 docs/util_Util.js.html                       |   2 +-
 docs/webCache_LocalWebCache.js.html          |   2 +-
 docs/webCache_RemoteWebCache.js.html         |   2 +-
 docs/webCache_WebCache.js.html               |   2 +-
 75 files changed, 803 insertions(+), 565 deletions(-)

diff --git a/docs/Base.html b/docs/Base.html
index a32d5f5e9ea..1223ca5bbd8 100644
--- a/docs/Base.html
+++ b/docs/Base.html
@@ -50,7 +50,7 @@ <h2 id="Base">new&nbsp;<span class="symbol-name">Base</span><span class="signatu
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/BaseAuthStrategy.html b/docs/BaseAuthStrategy.html
index 89cd05c6e1a..4ea772eceff 100644
--- a/docs/BaseAuthStrategy.html
+++ b/docs/BaseAuthStrategy.html
@@ -50,7 +50,7 @@ <h2 id="BaseAuthStrategy">new&nbsp;<span class="symbol-name">BaseAuthStrategy</s
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/Broadcast.html b/docs/Broadcast.html
index da86c0ebe52..b6928ae8551 100644
--- a/docs/Broadcast.html
+++ b/docs/Broadcast.html
@@ -152,7 +152,7 @@ <h3 id="getContact"><span class="symbol-name">getContact</span><span class="sign
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/BusinessContact.html b/docs/BusinessContact.html
index 6237700cbd0..87cd147c1a9 100644
--- a/docs/BusinessContact.html
+++ b/docs/BusinessContact.html
@@ -338,7 +338,7 @@ <h3 id="unblock"><span class="symbol-name">unblock</span><span class="signature"
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/Buttons.html b/docs/Buttons.html
index 57a22954d79..6a2bc03ba34 100644
--- a/docs/Buttons.html
+++ b/docs/Buttons.html
@@ -234,7 +234,7 @@ <h4>Parameter</h4>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/Call.html b/docs/Call.html
index a17e61b7043..802d54cbbaf 100644
--- a/docs/Call.html
+++ b/docs/Call.html
@@ -168,7 +168,7 @@ <h3 id="reject"><span class="symbol-name">reject</span><span class="signature"><
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/Channel.html b/docs/Channel.html
index ecc244fd35e..a9f50dfc5c1 100644
--- a/docs/Channel.html
+++ b/docs/Channel.html
@@ -900,7 +900,7 @@ <h3 id="unmute"><span class="symbol-name">unmute</span><span class="signature"><
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/Chat.html b/docs/Chat.html
index 0f92ef1d0b0..3faf97b929c 100644
--- a/docs/Chat.html
+++ b/docs/Chat.html
@@ -644,7 +644,7 @@ <h3 id="unpin"><span class="symbol-name">unpin</span><span class="signature"><sp
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/Client.html b/docs/Client.html
index 9956aebb1a0..c91689f9cc7 100644
--- a/docs/Client.html
+++ b/docs/Client.html
@@ -23,7 +23,7 @@
                                 <div id="jsdoc-content-container">
                                         <div id="jsdoc-main" role="main">
                     <header class="page-header">
-<div class="symbol-detail-labels"><span class="label label-kind">class</span></div><h1><small></small><span class="symbol-name">Client</span></h1>        <p class="source-link">Source: <a href="Client.js.html#source-line-82">Client.<wbr>js:82</a></p>
+<div class="symbol-detail-labels"><span class="label label-kind">class</span></div><h1><small></small><span class="symbol-name">Client</span></h1>        <p class="source-link">Source: <a href="Client.js.html#source-line-81">Client.<wbr>js:81</a></p>
             <div class="symbol-classdesc">
                 <p>Starting point for interacting with the WhatsApp Web API</p>
             </div>
@@ -285,6 +285,9 @@ <h2 class="summary-callout-heading">Methods</h2>
                 <dt><a href="Client.html#sendPresenceUnavailable">sendPresenceUnavailable()</a></dt>
                 <dd>
                 </dd>
+                <dt><a href="Client.html#sendPresenceUpdate">sendPresenceUpdate(chatId, state)</a></dt>
+                <dd>
+                </dd>
                 <dt><a href="Client.html#sendReaction">sendReaction(messageId, reaction)</a></dt>
                 <dd>
                 </dd>
@@ -371,9 +374,6 @@ <h2 class="summary-callout-heading">Events</h2>
                 <dt><a href="Client.html#event:chat_removed">chat_removed</a></dt>
                 <dd>
                 </dd>
-                <dt><a href="Client.html#event:code">code</a></dt>
-                <dd>
-                </dd>
                 <dt><a href="Client.html#event:contact_changed">contact_changed</a></dt>
                 <dd>
                 </dd>
@@ -415,14 +415,14 @@ <h2 class="summary-callout-heading">Events</h2>
                 <dt><a href="Client.html#event:message_ciphertext">message_ciphertext</a></dt>
                 <dd>
                 </dd>
-                <dt><a href="Client.html#event:message_ciphertext_failed">message_ciphertext_failed</a></dt>
-                <dd>
-                </dd>
         </dl>
 </div>
 
                     <div class="summary-column">
         <dl class="dl-summary-callout">
+                <dt><a href="Client.html#event:message_ciphertext_failed">message_ciphertext_failed</a></dt>
+                <dd>
+                </dd>
                 <dt><a href="Client.html#event:message_create">message_create</a></dt>
                 <dd>
                 </dd>
@@ -5006,6 +5006,85 @@ <h4>Parameters</h4>
 
 
 
+
+
+
+
+        </dl>
+
+                <div class="symbol-detail-labels"><span class="label label-async">async</span></div><h3 id="sendPresenceUpdate"><span class="symbol-name">sendPresenceUpdate</span><span class="signature"><span class="signature-params">(chatId, state)</span></span></h3>            <p>Sends a presence state to a specific chat without fetching the chat from the database.</p>
+
+        
+            <section>
+        <h4>Parameters</h4>
+            <table class="jsdoc-details-table">
+        <thead>
+            <tr>
+                <th>Name</th>
+                <th>Type</th>
+                <th>Optional</th>
+                <th>Description</th>
+            </tr>
+        </thead>
+        <tbody>
+                <tr>
+        <td>
+            <p>chatId</p>
+        </td>
+        <td>
+                <p>string</p>
+        </td>
+        <td>
+                <p>&nbsp;</p>
+        </td>
+        <td>
+                <p>The ID of the chat</p>
+        </td>
+</tr>
+
+                <tr>
+        <td>
+            <p>state</p>
+        </td>
+        <td>
+                <p>string</p>
+        </td>
+        <td>
+                <p>&nbsp;</p>
+        </td>
+        <td>
+                <p>The presence state (e.g., 'typing', 'recording', 'paused')</p>
+                <p>Defaults to <code>typing</code>.</p>
+        </td>
+</tr>
+
+        </tbody>
+</table>
+
+    </section>
+
+        
+
+        <dl class="dl-compact">
+            
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
 
 
 
@@ -6600,71 +6679,6 @@ <h4>Parameter</h4>
 
 
 
-
-
-
-        </dl>
-
-                <h3 id="event:code"><span class="symbol-name">code</span></h3>            <p>Emitted when a pairing code is received</p>
-
-        
-            <section>
-        <h4>Parameter</h4>
-            <table class="jsdoc-details-table">
-        <thead>
-            <tr>
-                <th>Name</th>
-                <th>Type</th>
-                <th>Optional</th>
-                <th>Description</th>
-            </tr>
-        </thead>
-        <tbody>
-                <tr>
-        <td>
-            <p>code</p>
-        </td>
-        <td>
-                <p>string</p>
-        </td>
-        <td>
-                <p>&nbsp;</p>
-        </td>
-        <td>
-                <p>Code</p>
-        </td>
-</tr>
-
-        </tbody>
-</table>
-
-    </section>
-
-        
-
-        <dl class="dl-compact">
-            
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-    <dt>Returns</dt>
-        <dd><p><code>string</code> <p>Code that was just received</p></p></dd>
 
 
 
@@ -8390,7 +8404,7 @@ <h3 id="event:vote_update"><span class="symbol-name">vote_update</span></h3>
                     <footer id="jsdoc-footer" class="jsdoc-footer">
                             <div id="jsdoc-footer-container">
                                     <p>
-                                      Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+                                      Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
                                     </p>
                             </div>
                     </footer>
diff --git a/docs/Client.js.html b/docs/Client.js.html
index 5a9a3d3dcec..4604c40b74f 100644
--- a/docs/Client.js.html
+++ b/docs/Client.js.html
@@ -42,7 +42,6 @@ <h1>Source: Client.js</h1>
     WAState,
     MessageTypes,
 } &#x3D; require(&#x27;./util/Constants&#x27;);
-const { ExposeAuthStore } &#x3D; require(&#x27;./util/Injected/AuthStore/AuthStore&#x27;);
 const { LoadUtils } &#x3D; require(&#x27;./util/Injected/Utils&#x27;);
 const ChatFactory &#x3D; require(&#x27;./factories/ChatFactory&#x27;);
 const ContactFactory &#x3D; require(&#x27;./factories/ContactFactory&#x27;);
@@ -143,314 +142,355 @@ <h1>Source: Client.js</h1>
      * Private function
      */
     async inject() {
-        if (
-            this.options.authTimeoutMs &#x3D;&#x3D;&#x3D; undefined ||
-            this.options.authTimeoutMs &#x3D;&#x3D; 0
-        ) {
-            this.options.authTimeoutMs &#x3D; 30000;
-        }
-        let start &#x3D; Date.now();
-        let timeout &#x3D; this.options.authTimeoutMs;
-        let res &#x3D; false;
-        while (start &gt; Date.now() - timeout) {
-            res &#x3D; await this.pupPage.evaluate(
-                &#x27;window.Debug?.VERSION !&#x3D; undefined&#x27;,
+        // Cancel any previous inject still running
+        if (this._injectAbort) this._injectAbort.abort();
+        const abort &#x3D; new AbortController();
+        this._injectAbort &#x3D; abort;
+
+        try {
+            const authTimeout &#x3D; this.options.authTimeoutMs || 30000;
+            await this.pupPage
+                .waitForFunction(&#x27;window.Debug?.VERSION !&#x3D; undefined&#x27;, {
+                    timeout: authTimeout,
+                    signal: abort.signal,
+                })
+                .catch((err) &#x3D;&gt; {
+                    if (abort.signal.aborted) throw err;
+                    throw &#x27;auth timeout&#x27;;
+                });
+            if (abort.signal.aborted) return;
+            await this.setDeviceName(
+                this.options.deviceName,
+                this.options.browserName,
             );
-            if (res) {
-                break;
-            }
-            await new Promise((r) &#x3D;&gt; setTimeout(r, 200));
-        }
-        if (!res) {
-            throw &#x27;auth timeout&#x27;;
-        }
-        await this.setDeviceName(
-            this.options.deviceName,
-            this.options.browserName,
-        );
-        const pairWithPhoneNumber &#x3D; this.options.pairWithPhoneNumber;
-        const version &#x3D; await this.getWWebVersion();
+            const pairWithPhoneNumber &#x3D; this.options.pairWithPhoneNumber;
+            const version &#x3D; await this.getWWebVersion();
 
-        await this.pupPage.evaluate(ExposeAuthStore);
+            const needAuthHandle &#x3D; await this.pupPage.waitForFunction(
+                () &#x3D;&gt; {
+                    const state &#x3D;
+                        window.require?.(&#x27;WAWebSocketModel&#x27;)?.Socket?.state;
+                    if (
+                        !state ||
+                        state &#x3D;&#x3D;&#x3D; &#x27;OPENING&#x27; ||
+                        state &#x3D;&#x3D;&#x3D; &#x27;UNLAUNCHED&#x27; ||
+                        state &#x3D;&#x3D;&#x3D; &#x27;PAIRING&#x27;
+                    ) {
+                        return false;
+                    }
+                    return {
+                        need: state &#x3D;&#x3D;&#x3D; &#x27;UNPAIRED&#x27; || state &#x3D;&#x3D;&#x3D; &#x27;UNPAIRED_IDLE&#x27;,
+                        state,
+                    };
+                },
+                { timeout: authTimeout },
+            );
+            const needAuthentication &#x3D; await needAuthHandle.jsonValue();
 
-        const needAuthentication &#x3D; await this.pupPage.evaluate(async () &#x3D;&gt; {
-            let state &#x3D; window.require(&#x27;WAWebSocketModel&#x27;).Socket.state;
+            if (needAuthentication.need) {
+                const { failed, failureEventPayload, restart } &#x3D;
+                    await this.authStrategy.onAuthenticationNeeded();
 
-            if (
-                state &#x3D;&#x3D;&#x3D; &#x27;OPENING&#x27; ||
-                state &#x3D;&#x3D;&#x3D; &#x27;UNLAUNCHED&#x27; ||
-                state &#x3D;&#x3D;&#x3D; &#x27;PAIRING&#x27;
-            ) {
-                // wait till state changes
-                await new Promise((r) &#x3D;&gt; {
-                    window
-                        .require(&#x27;WAWebSocketModel&#x27;)
-                        .Socket.on(
-                            &#x27;change:state&#x27;,
-                            function waitTillInit(_AppState, state) {
-                                if (
-                                    state !&#x3D;&#x3D; &#x27;OPENING&#x27; &amp;amp;&amp;amp;
-                                    state !&#x3D;&#x3D; &#x27;UNLAUNCHED&#x27; &amp;amp;&amp;amp;
-                                    state !&#x3D;&#x3D; &#x27;PAIRING&#x27;
-                                ) {
-                                    window
-                                        .require(&#x27;WAWebSocketModel&#x27;)
-                                        .Socket.off(
-                                            &#x27;change:state&#x27;,
-                                            waitTillInit,
-                                        );
-                                    r();
-                                }
-                            },
-                        );
-                });
-            }
-            state &#x3D; window.require(&#x27;WAWebSocketModel&#x27;).Socket.state;
-            return state &#x3D;&#x3D; &#x27;UNPAIRED&#x27; || state &#x3D;&#x3D; &#x27;UNPAIRED_IDLE&#x27;;
-        });
+                if (failed) {
+                    /**
+                     * Emitted when there has been an error while trying to restore an existing session
+                     * @event Client#auth_failure
+                     * @param {string} message
+                     */
+                    this.emit(
+                        Events.AUTHENTICATION_FAILURE,
+                        failureEventPayload,
+                    );
+                    await this.destroy();
+                    if (restart) {
+                        // session restore failed so try again but without session to force new authentication
+                        return this.initialize();
+                    }
+                    return;
+                }
 
-        if (needAuthentication) {
-            const { failed, failureEventPayload, restart } &#x3D;
-                await this.authStrategy.onAuthenticationNeeded();
+                // Register qr/code events
+                if (pairWithPhoneNumber.phoneNumber) {
+                    this.requestPairingCode(
+                        pairWithPhoneNumber.phoneNumber,
+                        pairWithPhoneNumber.showNotification,
+                        pairWithPhoneNumber.intervalMs,
+                    );
+                } else {
+                    let qrRetries &#x3D; 0;
 
-            if (failed) {
-                /**
-                 * Emitted when there has been an error while trying to restore an existing session
-                 * @event Client#auth_failure
-                 * @param {string} message
-                 */
-                this.emit(Events.AUTHENTICATION_FAILURE, failureEventPayload);
-                await this.destroy();
-                if (restart) {
-                    // session restore failed so try again but without session to force new authentication
-                    return this.initialize();
-                }
-                return;
-            }
+                    this.on(Events.LOADING_SCREEN, () &#x3D;&gt; {
+                        qrRetries &#x3D; 0;
+                    });
 
-            // Register qr/code events
-            if (pairWithPhoneNumber.phoneNumber) {
-                await exposeFunctionIfAbsent(
-                    this.pupPage,
-                    &#x27;onCodeReceivedEvent&#x27;,
-                    async (code) &#x3D;&gt; {
-                        /**
-                         * Emitted when a pairing code is received
-                         * @event Client#code
-                         * @param {string} code Code
-                         * @returns {string} Code that was just received
-                         */
-                        this.emit(Events.CODE_RECEIVED, code);
-                        return code;
-                    },
-                );
-                this.requestPairingCode(
-                    pairWithPhoneNumber.phoneNumber,
-                    pairWithPhoneNumber.showNotification,
-                    pairWithPhoneNumber.intervalMs,
-                );
-            } else {
-                let qrRetries &#x3D; 0;
-                await exposeFunctionIfAbsent(
-                    this.pupPage,
-                    &#x27;onQRChangedEvent&#x27;,
-                    async (qr) &#x3D;&gt; {
-                        /**
-                         * Emitted when a QR code is received
-                         * @event Client#qr
-                         * @param {string} qr QR Code
-                         */
-                        this.emit(Events.QR_RECEIVED, qr);
-                        if (this.options.qrMaxRetries &gt; 0) {
-                            qrRetries++;
-                            if (qrRetries &gt; this.options.qrMaxRetries) {
-                                this.emit(
-                                    Events.DISCONNECTED,
-                                    &#x27;Max qrcode retries reached&#x27;,
-                                );
-                                await this.destroy();
+                    await exposeFunctionIfAbsent(
+                        this.pupPage,
+                        &#x27;onQRChangedEvent&#x27;,
+                        async (qr) &#x3D;&gt; {
+                            /**
+                             * Emitted when a QR code is received
+                             * @event Client#qr
+                             * @param {string} qr QR Code
+                             */
+                            this.emit(Events.QR_RECEIVED, qr);
+                            if (this.options.qrMaxRetries &gt; 0) {
+                                qrRetries++;
+                                if (qrRetries &gt; this.options.qrMaxRetries) {
+                                    this.emit(
+                                        Events.DISCONNECTED,
+                                        &#x27;Max qrcode retries reached&#x27;,
+                                    );
+                                    await this.destroy();
+                                }
                             }
-                        }
-                    },
-                );
-
-                await this.pupPage.evaluate(async () &#x3D;&gt; {
-                    const registrationInfo &#x3D;
-                        await window.AuthStore.RegistrationUtils.waSignalStore.getRegistrationInfo();
-                    const noiseKeyPair &#x3D;
-                        await window.AuthStore.RegistrationUtils.waNoiseInfo.get();
-                    const staticKeyB64 &#x3D; window.AuthStore.Base64Tools.encodeB64(
-                        noiseKeyPair.staticKeyPair.pubKey,
+                        },
                     );
-                    const identityKeyB64 &#x3D;
-                        window.AuthStore.Base64Tools.encodeB64(
-                            registrationInfo.identityKeyPair.pubKey,
-                        );
-                    const platform &#x3D;
-                        window.AuthStore.RegistrationUtils.DEVICE_PLATFORM;
-                    const getQR &#x3D; (ref) &#x3D;&gt;
-                        ref +
-                        &#x27;,&#x27; +
-                        staticKeyB64 +
-                        &#x27;,&#x27; +
-                        identityKeyB64 +
-                        &#x27;,&#x27; +
-                        window
-                            .require(&#x27;WAWebUserPrefsMultiDevice&#x27;)
-                            .getADVSecretKey() +
-                        &#x27;,&#x27; +
-                        platform;
-                    window.onQRChangedEvent(getQR(window.AuthStore.Conn.ref)); // initial qr
-                    window.AuthStore.Conn.on(&#x27;change:ref&#x27;, (_, ref) &#x3D;&gt; {
-                        window.onQRChangedEvent(getQR(ref));
-                    }); // future QR changes
-                });
-            }
-        }
 
-        await exposeFunctionIfAbsent(
-            this.pupPage,
-            &#x27;onAuthAppStateChangedEvent&#x27;,
-            async (state) &#x3D;&gt; {
-                if (
-                    state &#x3D;&#x3D; &#x27;UNPAIRED_IDLE&#x27; &amp;amp;&amp;amp;
-                    !pairWithPhoneNumber.phoneNumber
-                ) {
-                    // refresh qr code
-                    window.require(&#x27;WAWebCmd&#x27;).Cmd.refreshQR();
-                }
-            },
-        );
+                    await this.pupPage.evaluate(async () &#x3D;&gt; {
+                        const registrationInfo &#x3D; await window
+                            .require(&#x27;WAWebSignalStoreApi&#x27;)
+                            .waSignalStore.getRegistrationInfo();
+                        const noiseKeyPair &#x3D; await window
+                            .require(&#x27;WAWebUserPrefsInfoStore&#x27;)
+                            .waNoiseInfo.get();
+                        const staticKeyB64 &#x3D; window
+                            .require(&#x27;WABase64&#x27;)
+                            .encodeB64(noiseKeyPair.staticKeyPair.pubKey);
+                        const identityKeyB64 &#x3D; window
+                            .require(&#x27;WABase64&#x27;)
+                            .encodeB64(registrationInfo.identityKeyPair.pubKey);
+                        const advSecretKey &#x3D; await window
+                            .require(&#x27;WAWebUserPrefsMultiDevice&#x27;)
+                            .getADVSecretKey();
+                        const platform &#x3D; window.require(
+                            &#x27;WAWebCompanionRegClientUtils&#x27;,
+                        ).DEVICE_PLATFORM;
+                        const getQR &#x3D; (ref) &#x3D;&gt;
+                            ref +
+                            &#x27;,&#x27; +
+                            staticKeyB64 +
+                            &#x27;,&#x27; +
+                            identityKeyB64 +
+                            &#x27;,&#x27; +
+                            advSecretKey +
+                            &#x27;,&#x27; +
+                            platform;
+
+                        const onRefChange &#x3D; (_, ref) &#x3D;&gt; {
+                            if (ref &#x3D;&#x3D; null) return;
+                            window.onQRChangedEvent(getQR(ref));
+                        };
 
-        await exposeFunctionIfAbsent(
-            this.pupPage,
-            &#x27;onAppStateHasSyncedEvent&#x27;,
-            async () &#x3D;&gt; {
-                const authEventPayload &#x3D;
-                    await this.authStrategy.getAuthEventPayload();
-                /**
-                 * Emitted when authentication is successful
-                 * @event Client#authenticated
-                 */
-                this.emit(Events.AUTHENTICATED, authEventPayload);
+                        window.onQRChangedEvent(
+                            getQR(window.require(&#x27;WAWebConnModel&#x27;).Conn.ref),
+                        ); // initial qr
+                        window
+                            .require(&#x27;WAWebConnModel&#x27;)
+                            .Conn.on(&#x27;change:ref&#x27;, onRefChange); // future QR changes
 
-                const injected &#x3D; await this.pupPage.evaluate(async () &#x3D;&gt; {
-                    return typeof window.WWebJS !&#x3D;&#x3D; &#x27;undefined&#x27;;
-                });
+                        // Remove QR listener once authentication succeeds
+                        window
+                            .require(&#x27;WAWebSocketModel&#x27;)
+                            .Socket.on(&#x27;change:hasSynced&#x27;, () &#x3D;&gt; {
+                                window
+                                    .require(&#x27;WAWebConnModel&#x27;)
+                                    .Conn.off(&#x27;change:ref&#x27;, onRefChange);
+                            });
+                    });
+                }
+            }
 
-                if (!injected) {
+            await exposeFunctionIfAbsent(
+                this.pupPage,
+                &#x27;onAuthAppStateChangedEvent&#x27;,
+                async (state) &#x3D;&gt; {
                     if (
-                        this.options.webVersionCache.type &#x3D;&#x3D;&#x3D; &#x27;local&#x27; &amp;amp;&amp;amp;
-                        this.currentIndexHtml
+                        state &#x3D;&#x3D; &#x27;UNPAIRED_IDLE&#x27; &amp;amp;&amp;amp;
+                        !pairWithPhoneNumber.phoneNumber
                     ) {
-                        const { type: webCacheType, ...webCacheOptions } &#x3D;
-                            this.options.webVersionCache;
-                        const webCache &#x3D; WebCacheFactory.createWebCache(
-                            webCacheType,
-                            webCacheOptions,
-                        );
-
-                        await webCache.persist(this.currentIndexHtml, version);
+                        // refresh qr code
+                        await this.pupPage.evaluate(() &#x3D;&gt; {
+                            window.require(&#x27;WAWebCmd&#x27;).Cmd.refreshQR();
+                        });
                     }
+                },
+            );
+
+            await exposeFunctionIfAbsent(
+                this.pupPage,
+                &#x27;onAppStateHasSyncedEvent&#x27;,
+                async () &#x3D;&gt; {
+                    const authEventPayload &#x3D;
+                        await this.authStrategy.getAuthEventPayload();
+                    /**
+                     * Emitted when authentication is successful
+                     * @event Client#authenticated
+                     */
+                    this.emit(Events.AUTHENTICATED, authEventPayload);
 
-                    // Load util functions (serializers, helper functions)
-                    await this.pupPage.evaluate(LoadUtils);
+                    const injected &#x3D; await this.pupPage.evaluate(async () &#x3D;&gt; {
+                        return typeof window.WWebJS !&#x3D;&#x3D; &#x27;undefined&#x27;;
+                    });
 
-                    let start &#x3D; Date.now();
-                    let res &#x3D; false;
-                    while (start &gt; Date.now() - 30000) {
-                        // Check window.WWebJS Injection
-                        res &#x3D; await this.pupPage.evaluate(
-                            &#x27;window.WWebJS !&#x3D; undefined&#x27;,
-                        );
-                        if (res) {
-                            break;
+                    if (!injected) {
+                        if (
+                            this.options.webVersionCache.type &#x3D;&#x3D;&#x3D; &#x27;local&#x27; &amp;amp;&amp;amp;
+                            this.currentIndexHtml
+                        ) {
+                            const { type: webCacheType, ...webCacheOptions } &#x3D;
+                                this.options.webVersionCache;
+                            const webCache &#x3D; WebCacheFactory.createWebCache(
+                                webCacheType,
+                                webCacheOptions,
+                            );
+
+                            await webCache.persist(
+                                this.currentIndexHtml,
+                                version,
+                            );
                         }
-                        await new Promise((r) &#x3D;&gt; setTimeout(r, 200));
-                    }
-                    if (!res) {
-                        throw &#x27;ready timeout&#x27;;
-                    }
 
+                        // Load util functions (serializers, helper functions)
+                        await this.pupPage.evaluate(LoadUtils);
+
+                        await this.pupPage
+                            .waitForFunction(
+                                &#x27;typeof window.WWebJS !&#x3D;&#x3D; &quot;undefined&quot;&#x27;,
+                                { timeout: 30000 },
+                            )
+                            .catch(() &#x3D;&gt; {
+                                throw &#x27;ready timeout&#x27;;
+                            });
+
+                        /**
+                         * Current connection information
+                         * @type {ClientInfo}
+                         */
+                        this.info &#x3D; new ClientInfo(
+                            this,
+                            await this.pupPage.evaluate(() &#x3D;&gt; {
+                                return {
+                                    ...window
+                                        .require(&#x27;WAWebConnModel&#x27;)
+                                        .Conn.serialize(),
+                                    wid:
+                                        window
+                                            .require(&#x27;WAWebUserPrefsMeUser&#x27;)
+                                            .getMaybeMePnUser() ||
+                                        window
+                                            .require(&#x27;WAWebUserPrefsMeUser&#x27;)
+                                            .getMaybeMeLidUser(),
+                                };
+                            }),
+                        );
+
+                        this.interface &#x3D; new InterfaceController(this);
+
+                        await this.attachEventListeners();
+                    }
                     /**
-                     * Current connection information
-                     * @type {ClientInfo}
+                     * Emitted when the client has initialized and is ready to receive messages.
+                     * @event Client#ready
                      */
-                    this.info &#x3D; new ClientInfo(
-                        this,
-                        await this.pupPage.evaluate(() &#x3D;&gt; {
-                            return {
-                                ...window
-                                    .require(&#x27;WAWebConnModel&#x27;)
-                                    .Conn.serialize(),
-                                wid:
-                                    window
-                                        .require(&#x27;WAWebUserPrefsMeUser&#x27;)
-                                        .getMaybeMePnUser() ||
-                                    window
-                                        .require(&#x27;WAWebUserPrefsMeUser&#x27;)
-                                        .getMaybeMeLidUser(),
-                            };
-                        }),
-                    );
-
-                    this.interface &#x3D; new InterfaceController(this);
+                    this.emit(Events.READY);
+                    this.authStrategy.afterAuthReady();
+                },
+            );
+            let lastPercent &#x3D; null;
+            await exposeFunctionIfAbsent(
+                this.pupPage,
+                &#x27;onOfflineProgressUpdateEvent&#x27;,
+                async (percent) &#x3D;&gt; {
+                    if (lastPercent !&#x3D;&#x3D; percent) {
+                        lastPercent &#x3D; percent;
+                        this.emit(Events.LOADING_SCREEN, percent, &#x27;WhatsApp&#x27;); // Message is hardcoded as &quot;WhatsApp&quot; for now
+                    }
+                },
+            );
+            await exposeFunctionIfAbsent(
+                this.pupPage,
+                &#x27;onLogoutEvent&#x27;,
+                async () &#x3D;&gt; {
+                    this.lastLoggedOut &#x3D; true;
+                    await this.pupPage
+                        .waitForNavigation({ waitUntil: &#x27;load&#x27;, timeout: 5000 })
+                        .catch((_) &#x3D;&gt; _);
+                },
+            );
+            await this.pupPage.evaluate(() &#x3D;&gt; {
+                const Socket &#x3D; window.require(&#x27;WAWebSocketModel&#x27;).Socket;
+                const Cmd &#x3D; window.require(&#x27;WAWebCmd&#x27;).Cmd;
+
+                const listeners &#x3D; [
+                    [
+                        Socket,
+                        &#x27;change:state&#x27;,
+                        (_AppState, state) &#x3D;&gt; {
+                            window.onAuthAppStateChangedEvent(state);
+                        },
+                    ],
+                    [
+                        Socket,
+                        &#x27;change:hasSynced&#x27;,
+                        () &#x3D;&gt; {
+                            window.onAppStateHasSyncedEvent();
+                        },
+                    ],
+                    [
+                        Cmd,
+                        &#x27;offline_progress_update_from_bridge&#x27;,
+                        () &#x3D;&gt; {
+                            window.onOfflineProgressUpdateEvent(
+                                window
+                                    .require(&#x27;WAWebOfflineHandler&#x27;)
+                                    .OfflineMessageHandler.getOfflineDeliveryProgress(),
+                            );
+                        },
+                    ],
+                    [
+                        Cmd,
+                        &#x27;logout&#x27;,
+                        async () &#x3D;&gt; {
+                            await window.onLogoutEvent();
+                        },
+                    ],
+                    [
+                        Cmd,
+                        &#x27;logout_from_bridge&#x27;,
+                        async () &#x3D;&gt; {
+                            await window.onLogoutEvent();
+                        },
+                    ],
+                ];
 
-                    await this.attachEventListeners();
+                // Clean up old listeners to prevent accumulation on re-inject
+                if (window._wwjsListeners) {
+                    for (const [obj, event, handler] of window._wwjsListeners) {
+                        obj.off(event, handler);
+                    }
                 }
-                /**
-                 * Emitted when the client has initialized and is ready to receive messages.
-                 * @event Client#ready
-                 */
-                this.emit(Events.READY);
-                this.authStrategy.afterAuthReady();
-            },
-        );
-        let lastPercent &#x3D; null;
-        await exposeFunctionIfAbsent(
-            this.pupPage,
-            &#x27;onOfflineProgressUpdateEvent&#x27;,
-            async (percent) &#x3D;&gt; {
-                if (lastPercent !&#x3D;&#x3D; percent) {
-                    lastPercent &#x3D; percent;
-                    this.emit(Events.LOADING_SCREEN, percent, &#x27;WhatsApp&#x27;); // Message is hardcoded as &quot;WhatsApp&quot; for now
+
+                for (const [obj, event, handler] of listeners) {
+                    obj.on(event, handler);
                 }
-            },
-        );
-        await exposeFunctionIfAbsent(
-            this.pupPage,
-            &#x27;onLogoutEvent&#x27;,
-            async () &#x3D;&gt; {
-                this.lastLoggedOut &#x3D; true;
-                await this.pupPage
-                    .waitForNavigation({ waitUntil: &#x27;load&#x27;, timeout: 5000 })
-                    .catch((_) &#x3D;&gt; _);
-            },
-        );
-        await this.pupPage.evaluate(() &#x3D;&gt; {
-            window
-                .require(&#x27;WAWebSocketModel&#x27;)
-                .Socket.on(&#x27;change:state&#x27;, (_AppState, state) &#x3D;&gt; {
-                    window.onAuthAppStateChangedEvent(state);
-                });
-            window
-                .require(&#x27;WAWebSocketModel&#x27;)
-                .Socket.on(&#x27;change:hasSynced&#x27;, () &#x3D;&gt; {
+                window._wwjsListeners &#x3D; listeners;
+
+                // Atomic hasSynced check in the same synchronous block as listener registration.
+                // If hasSynced is already true, Backbone won&#x27;t fire change:hasSynced (no transition).
+                // If hasSynced is false, the listener above will catch the future transition.
+                const storeInjected &#x3D; typeof window.WWebJS !&#x3D;&#x3D; &#x27;undefined&#x27;;
+                if (Socket.hasSynced &#x3D;&#x3D;&#x3D; true &amp;amp;&amp;amp; !storeInjected) {
                     window.onAppStateHasSyncedEvent();
-                });
-            const Cmd &#x3D; window.require(&#x27;WAWebCmd&#x27;).Cmd;
-            Cmd.on(&#x27;offline_progress_update_from_bridge&#x27;, () &#x3D;&gt; {
-                window.onOfflineProgressUpdateEvent(
-                    window.AuthStore.OfflineMessageHandler.getOfflineDeliveryProgress(),
-                );
-            });
-            Cmd.on(&#x27;logout&#x27;, async () &#x3D;&gt; {
-                await window.onLogoutEvent();
-            });
-            Cmd.on(&#x27;logout_from_bridge&#x27;, async () &#x3D;&gt; {
-                await window.onLogoutEvent();
+                }
             });
-        });
+        } catch (err) {
+            if (abort.signal.aborted) return; // superseded by newer inject
+            throw err;
+        } finally {
+            if (this._injectAbort &#x3D;&#x3D;&#x3D; abort) {
+                this._injectAbort &#x3D; null;
+            }
+        }
     }
 
     /**
@@ -520,16 +560,37 @@ <h1>Source: Client.js</h1>
             referer: &#x27;https://whatsapp.com/&#x27;,
         });
 
+        // Register framenavigated BEFORE inject so that if navigation
+        // interrupts inject, the handler triggers a fresh inject.
+        this._registerFramenavigatedHandler();
+
         await this.inject();
+    }
+
+    _registerFramenavigatedHandler() {
+        if (this._framenavigatedRegistered) return;
+        this._framenavigatedRegistered &#x3D; true;
 
         this.pupPage.on(&#x27;framenavigated&#x27;, async (frame) &#x3D;&gt; {
-            if (frame.url().includes(&#x27;post_logout&#x3D;1&#x27;) || this.lastLoggedOut) {
+            if (frame.parentFrame() !&#x3D;&#x3D; null) return;
+
+            const isLogout &#x3D;
+                frame.url().includes(&#x27;post_logout&#x3D;1&#x27;) || this.lastLoggedOut;
+
+            if (isLogout) {
                 this.emit(Events.DISCONNECTED, &#x27;LOGOUT&#x27;);
                 await this.authStrategy.logout();
                 await this.authStrategy.beforeBrowserInitialized();
                 await this.authStrategy.afterBrowserInitialized();
                 this.lastLoggedOut &#x3D; false;
             }
+
+            const storeAvailable &#x3D; await this.pupPage.evaluate(() &#x3D;&gt; {
+                return typeof window.WWebJS !&#x3D;&#x3D; &#x27;undefined&#x27;;
+            });
+
+            if (!isLogout &amp;amp;&amp;amp; storeAvailable) return;
+
             await this.inject();
         });
     }
@@ -557,19 +618,15 @@ <h1>Source: Client.js</h1>
         return await this.pupPage.evaluate(
             async (phoneNumber, showNotification, intervalMs) &#x3D;&gt; {
                 const getCode &#x3D; async () &#x3D;&gt; {
-                    while (!window.AuthStore.PairingCodeLinkUtils) {
-                        await new Promise((resolve) &#x3D;&gt;
-                            setTimeout(resolve, 250),
-                        );
-                    }
-                    window.AuthStore.PairingCodeLinkUtils.setPairingType(
-                        &#x27;ALT_DEVICE_LINKING&#x27;,
-                    );
-                    await window.AuthStore.PairingCodeLinkUtils.initializeAltDeviceLinking();
-                    return window.AuthStore.PairingCodeLinkUtils.startAltLinkingFlow(
-                        phoneNumber,
-                        showNotification,
-                    );
+                    window
+                        .require(&#x27;WAWebAltDeviceLinkingApi&#x27;)
+                        .setPairingType(&#x27;ALT_DEVICE_LINKING&#x27;);
+                    await window
+                        .require(&#x27;WAWebAltDeviceLinkingApi&#x27;)
+                        .initializeAltDeviceLinking();
+                    return window
+                        .require(&#x27;WAWebAltDeviceLinkingApi&#x27;)
+                        .startAltLinkingFlow(phoneNumber, showNotification);
                 };
                 if (window.codeInterval) {
                     clearInterval(window.codeInterval); // remove existing interval
@@ -1305,6 +1362,9 @@ <h1>Source: Client.js</h1>
      * Closes the client
      */
     async destroy() {
+        if (this._injectAbort) this._injectAbort.abort();
+        this._framenavigatedRegistered &#x3D; false;
+
         const browser &#x3D; this.pupBrowser;
         const isConnected &#x3D; browser?.isConnected?.();
         if (isConnected) {
@@ -1615,6 +1675,22 @@ <h1>Source: Client.js</h1>
         );
     }
 
+    /**
+     * Sends a presence state to a specific chat without fetching the chat from the database.
+     * @param {string} chatId The ID of the chat
+     * @param {string} state The presence state (e.g., &#x27;typing&#x27;, &#x27;recording&#x27;, &#x27;paused&#x27;)
+     */
+    async sendPresenceUpdate(chatId, state &#x3D; &#x27;typing&#x27;) {
+        return this.pupPage.evaluate(
+            (chatId, state) &#x3D;&gt; {
+                window.WWebJS.sendChatstate(state, chatId);
+                return true;
+            },
+            chatId,
+            state,
+        );
+    }
+
     /**
      * @typedef {Object} SendChannelAdminInviteOptions
      * @property {?string} comment The comment to be added to an invitation
@@ -3472,7 +3548,7 @@ <h1>Source: Client.js</h1>
                     <footer id="jsdoc-footer" class="jsdoc-footer">
                             <div id="jsdoc-footer-container">
                                     <p>
-                                      Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+                                      Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
                                     </p>
                             </div>
                     </footer>
diff --git a/docs/ClientInfo.html b/docs/ClientInfo.html
index d73786e3e09..e86c10a1f0c 100644
--- a/docs/ClientInfo.html
+++ b/docs/ClientInfo.html
@@ -242,7 +242,7 @@ <h3 id="getBatteryStatus"><span class="symbol-name">getBatteryStatus</span><span
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/Contact.html b/docs/Contact.html
index 4ab6efc9cc6..4cdb9a8419b 100644
--- a/docs/Contact.html
+++ b/docs/Contact.html
@@ -305,7 +305,7 @@ <h3 id="unblock"><span class="symbol-name">unblock</span><span class="signature"
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/GroupChat.html b/docs/GroupChat.html
index b8dbcdbb4de..f0df284734c 100644
--- a/docs/GroupChat.html
+++ b/docs/GroupChat.html
@@ -1304,7 +1304,7 @@ <h3 id="unpin"><span class="symbol-name">unpin</span><span class="signature"><sp
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/GroupNotification.html b/docs/GroupNotification.html
index 284035c7188..cf911669450 100644
--- a/docs/GroupNotification.html
+++ b/docs/GroupNotification.html
@@ -233,7 +233,7 @@ <h4>Parameters</h4>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/InterfaceController.html b/docs/InterfaceController.html
index 6f7f0b56060..92987d08667 100644
--- a/docs/InterfaceController.html
+++ b/docs/InterfaceController.html
@@ -382,7 +382,7 @@ <h4>Parameter</h4>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/Label.html b/docs/Label.html
index b958016a13b..669a7be690b 100644
--- a/docs/Label.html
+++ b/docs/Label.html
@@ -163,7 +163,7 @@ <h3 id="getChats"><span class="symbol-name">getChats</span><span class="signatur
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/List.html b/docs/List.html
index e7e704e4199..2e289a76d1e 100644
--- a/docs/List.html
+++ b/docs/List.html
@@ -256,7 +256,7 @@ <h4>Parameter</h4>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/LocalAuth.html b/docs/LocalAuth.html
index b63b2e4293b..f312b29f479 100644
--- a/docs/LocalAuth.html
+++ b/docs/LocalAuth.html
@@ -134,7 +134,7 @@ <h3>Parameters</h3>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/LocalWebCache.html b/docs/LocalWebCache.html
index 6ad77ef8324..101d0223ab9 100644
--- a/docs/LocalWebCache.html
+++ b/docs/LocalWebCache.html
@@ -120,7 +120,7 @@ <h3>Parameters</h3>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/Location.html b/docs/Location.html
index 094b96eed8d..10679b21099 100644
--- a/docs/Location.html
+++ b/docs/Location.html
@@ -173,7 +173,7 @@ <h3 id="url"><span class="symbol-name">url</span><small class="property-type">
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/Message.html b/docs/Message.html
index 5cb3d3736a8..8e2b094d364 100644
--- a/docs/Message.html
+++ b/docs/Message.html
@@ -26,7 +26,7 @@
           <header class="page-header">
             <div class="symbol-detail-labels"><span class="label label-kind">class</span></div>
             <h1><small></small><span class="symbol-name">Message</span></h1>
-            <p class="source-link">Source: <a href="structures_Message.js.html#source-line-17">structures/<wbr>Message.<wbr>js:17</a></p>
+            <p class="source-link">Source: <a href="structures_Message.js.html#source-line-18">structures/<wbr>Message.<wbr>js:18</a></p>
             <div class="symbol-classdesc">
               <p>Represents a Message on WhatsApp</p>
             </div>
@@ -158,6 +158,9 @@ <h2 class="summary-callout-heading">Methods</h2>
                     <dt><a href="Message.html#downloadMedia">downloadMedia()</a></dt>
                     <dd>
                     </dd>
+                    <dt><a href="Message.html#downloadMediaStream">downloadMediaStream([options])</a></dt>
+                    <dd>
+                    </dd>
                     <dt><a href="Message.html#edit">edit(content[, options])</a></dt>
                     <dd>
                     </dd>
@@ -201,13 +204,13 @@ <h2 class="summary-callout-heading">Methods</h2>
                     <dt><a href="Message.html#getReactions">getReactions()</a></dt>
                     <dd>
                     </dd>
+                    <dt><a href="Message.html#pin">pin(duration)</a></dt>
+                    <dd>
+                    </dd>
                   </dl>
                 </div>
                 <div class="summary-column">
                   <dl class="dl-summary-callout">
-                    <dt><a href="Message.html#pin">pin(duration)</a></dt>
-                    <dd>
-                    </dd>
                     <dt><a href="Message.html#react">react(reaction)</a></dt>
                     <dd>
                     </dd>
@@ -465,12 +468,79 @@ <h4>Parameters</h4>
               <dl class="dl-compact">
               </dl>
               <div class="symbol-detail-labels"><span class="label label-async">async</span></div>
-              <h3 id="downloadMedia"><span class="symbol-name">downloadMedia</span><span class="signature"><span class="signature-params">()</span>&nbsp;&rarr; <span class="signature-returns"> Promise containing <a href="MessageMedia.html">MessageMedia</a></span></span></h3>
-              <p>Downloads and returns the attatched message media</p>
+              <h3 id="downloadMedia"><span class="symbol-name">downloadMedia</span><span class="signature"><span class="signature-params">()</span>&nbsp;&rarr; <span class="signature-returns"> Promise containing (<a href="MessageMedia.html">MessageMedia</a> or undefined)</span></span></h3>
+              <p>Downloads and returns the attached message media</p>
+              <dl class="dl-compact">
+                <dt>Returns</dt>
+                <dd>
+                  <p><code>Promise containing (<a href="MessageMedia.html">MessageMedia</a> or undefined)</code> </p>
+                </dd>
+              </dl>
+              <div class="symbol-detail-labels"><span class="label label-async">async</span></div>
+              <h3 id="downloadMediaStream"><span class="symbol-name">downloadMediaStream</span><span class="signature"><span class="signature-params">([options])</span>&nbsp;&rarr; <span class="signature-returns"> Promise containing (MessageMediaStream or undefined)</span></span></h3>
+              <p>Like downloadMedia(), but returns a Readable stream instead of loading the entire file into memory.</p>
+              <section>
+                <h4>Parameters</h4>
+                <table class="jsdoc-details-table">
+                  <thead>
+                    <tr>
+                      <th>Name</th>
+                      <th>Type</th>
+                      <th>Optional</th>
+                      <th>Description</th>
+                    </tr>
+                  </thead>
+                  <tbody>
+                    <tr>
+                      <td>
+                        <p>options</p>
+                      </td>
+                      <td>
+                        <p>Object</p>
+                      </td>
+                      <td>
+                        <p>Yes</p>
+                      </td>
+                      <td>
+                        <p>Values in <code>options</code> have the following properties:</p>
+                        <table class="jsdoc-details-table">
+                          <thead>
+                            <tr>
+                              <th>Name</th>
+                              <th>Type</th>
+                              <th>Optional</th>
+                              <th>Description</th>
+                            </tr>
+                          </thead>
+                          <tbody>
+                            <tr>
+                              <td>
+                                <p>chunkSize</p>
+                              </td>
+                              <td>
+                                <p>number</p>
+                              </td>
+                              <td>
+                                <p>Yes</p>
+                              </td>
+                              <td>
+                                <p>Size in bytes of each chunk read from the browser (default 10MB)</p>
+                                <p>Defaults to <code>10485760</code>.</p>
+                              </td>
+                            </tr>
+                          </tbody>
+                        </table>
+                      </td>
+                    </tr>
+                  </tbody>
+                </table>
+              </section>
               <dl class="dl-compact">
                 <dt>Returns</dt>
                 <dd>
-                  <p><code>Promise containing <a href="MessageMedia.html">MessageMedia</a></code> </p>
+                  <p><code>Promise containing (MessageMediaStream or undefined)</code> 
+                  <p>undefined if media is unavailable</p>
+                  </p>
                 </dd>
               </dl>
               <div class="symbol-detail-labels"><span class="label label-async">async</span></div>
@@ -911,7 +981,7 @@ <h4>Parameter</h4>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/MessageMedia.html b/docs/MessageMedia.html
index f55b94dbe27..9a15a1f172e 100644
--- a/docs/MessageMedia.html
+++ b/docs/MessageMedia.html
@@ -364,7 +364,7 @@ <h4>Parameters</h4>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/NoAuth.html b/docs/NoAuth.html
index 527655f327d..e75e93406bd 100644
--- a/docs/NoAuth.html
+++ b/docs/NoAuth.html
@@ -51,7 +51,7 @@ <h2 id="NoAuth">new&nbsp;<span class="symbol-name">NoAuth</span><span class="sig
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/Order.html b/docs/Order.html
index a3b867ccc06..a381eb139ac 100644
--- a/docs/Order.html
+++ b/docs/Order.html
@@ -102,7 +102,7 @@ <h3 id="total"><span class="symbol-name">total</span><small class="property-type
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/Poll.html b/docs/Poll.html
index c577797b4d4..6bf7f5e3ee3 100644
--- a/docs/Poll.html
+++ b/docs/Poll.html
@@ -148,7 +148,7 @@ <h3 id="pollOptions"><span class="symbol-name">pollOptions</span><small class="p
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/PollVote.html b/docs/PollVote.html
index 50e24bf46ab..ee10a95f48b 100644
--- a/docs/PollVote.html
+++ b/docs/PollVote.html
@@ -102,7 +102,7 @@ <h3 id="voter"><span class="symbol-name">voter</span><small class="property-type
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/PrivateChat.html b/docs/PrivateChat.html
index ad71a1f18a1..45b1f45ed13 100644
--- a/docs/PrivateChat.html
+++ b/docs/PrivateChat.html
@@ -680,7 +680,7 @@ <h3 id="unpin"><span class="symbol-name">unpin</span><span class="signature"><sp
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/PrivateContact.html b/docs/PrivateContact.html
index d40f1a9ab82..a28c15b894c 100644
--- a/docs/PrivateContact.html
+++ b/docs/PrivateContact.html
@@ -331,7 +331,7 @@ <h3 id="unblock"><span class="symbol-name">unblock</span><span class="signature"
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/Product.html b/docs/Product.html
index 18f6420dab4..64ea1c218ed 100644
--- a/docs/Product.html
+++ b/docs/Product.html
@@ -127,7 +127,7 @@ <h3 id="thumbnailUrl"><span class="symbol-name">thumbnailUrl</span><small class=
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/Reaction.html b/docs/Reaction.html
index 3cce2aa546f..8dd47fb5276 100644
--- a/docs/Reaction.html
+++ b/docs/Reaction.html
@@ -144,7 +144,7 @@ <h3 id="timestamp"><span class="symbol-name">timestamp</span><small class="prope
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/RemoteAuth.html b/docs/RemoteAuth.html
index e498fad619a..cbf7ff233c2 100644
--- a/docs/RemoteAuth.html
+++ b/docs/RemoteAuth.html
@@ -162,7 +162,7 @@ <h3>Parameters</h3>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/RemoteWebCache.html b/docs/RemoteWebCache.html
index 426531fca97..8e3c0ecaedd 100644
--- a/docs/RemoteWebCache.html
+++ b/docs/RemoteWebCache.html
@@ -120,7 +120,7 @@ <h3>Parameters</h3>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/ScheduledEvent.html b/docs/ScheduledEvent.html
index 845754db5f1..bf6ac0e274d 100644
--- a/docs/ScheduledEvent.html
+++ b/docs/ScheduledEvent.html
@@ -220,7 +220,7 @@ <h4>Parameters</h4>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/Util.html b/docs/Util.html
index fb1ba270269..c9f7273c6bf 100644
--- a/docs/Util.html
+++ b/docs/Util.html
@@ -243,7 +243,7 @@ <h4>Parameter</h4>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/WebCache.html b/docs/WebCache.html
index eda9e64ed9a..762a92269a0 100644
--- a/docs/WebCache.html
+++ b/docs/WebCache.html
@@ -50,7 +50,7 @@ <h2 id="WebCache">new&nbsp;<span class="symbol-name">WebCache</span><span class=
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/authStrategies_BaseAuthStrategy.js.html b/docs/authStrategies_BaseAuthStrategy.js.html
index 52b93506c64..478c40e66c6 100644
--- a/docs/authStrategies_BaseAuthStrategy.js.html
+++ b/docs/authStrategies_BaseAuthStrategy.js.html
@@ -68,7 +68,7 @@ <h1>Source: authStrategies/BaseAuthStrategy.js</h1>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/authStrategies_LocalAuth.js.html b/docs/authStrategies_LocalAuth.js.html
index 176a9711270..7e27ebb2e02 100644
--- a/docs/authStrategies_LocalAuth.js.html
+++ b/docs/authStrategies_LocalAuth.js.html
@@ -110,7 +110,7 @@ <h1>Source: authStrategies/LocalAuth.js</h1>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/authStrategies_NoAuth.js.html b/docs/authStrategies_NoAuth.js.html
index 07e73c66b30..2d48417927f 100644
--- a/docs/authStrategies_NoAuth.js.html
+++ b/docs/authStrategies_NoAuth.js.html
@@ -50,7 +50,7 @@ <h1>Source: authStrategies/NoAuth.js</h1>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/authStrategies_RemoteAuth.js.html b/docs/authStrategies_RemoteAuth.js.html
index 4d86617337e..9c83fe80dae 100644
--- a/docs/authStrategies_RemoteAuth.js.html
+++ b/docs/authStrategies_RemoteAuth.js.html
@@ -306,7 +306,7 @@ <h1>Source: authStrategies/RemoteAuth.js</h1>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/global.html b/docs/global.html
index 203cce73a7c..fe26a0ee8c2 100644
--- a/docs/global.html
+++ b/docs/global.html
@@ -4333,7 +4333,7 @@ <h4>Property</h4>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/index.html b/docs/index.html
index a00f047f883..e7dad37bdc9 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -1177,11 +1177,6 @@ <h2 id="Client">Client</h2>
             </dt>
             <dd>
             </dd>
-            <dt class="symbol-index-name">
-                <a href="Client.html#event:code" class="!symbol-index-name">Client#<wbr>event:code</a>
-            </dt>
-            <dd>
-            </dd>
             <dt class="symbol-index-name">
                 <a href="Client.html#event:contact_changed" class="!symbol-index-name">Client#<wbr>event:contact_changed</a>
             </dt>
@@ -1247,16 +1242,16 @@ <h2 id="Client">Client</h2>
             </dt>
             <dd>
             </dd>
-    </dl>
-</div>
-
-                            <div class="symbol-index-column">
-    <dl class="symbol-index-list">
             <dt class="symbol-index-name">
                 <a href="Client.html#event:message_create" class="!symbol-index-name">Client#<wbr>event:message_create</a>
             </dt>
             <dd>
             </dd>
+    </dl>
+</div>
+
+                            <div class="symbol-index-column">
+    <dl class="symbol-index-list">
             <dt class="symbol-index-name">
                 <a href="Client.html#event:message_edit" class="!symbol-index-name">Client#<wbr>event:message_edit</a>
             </dt>
@@ -1447,16 +1442,16 @@ <h2 id="Client">Client</h2>
             </dt>
             <dd>
             </dd>
-    </dl>
-</div>
-
-                            <div class="symbol-index-column">
-    <dl class="symbol-index-list">
             <dt class="symbol-index-name">
                 <a href="Client.html#isRegisteredUser" class="!symbol-index-name">Client#<wbr>isRegisteredUser(id)</a>
             </dt>
             <dd>
             </dd>
+    </dl>
+</div>
+
+                            <div class="symbol-index-column">
+    <dl class="symbol-index-list">
             <dt class="symbol-index-name">
                 <a href="Client.html#logout" class="!symbol-index-name">Client#<wbr>logout()</a>
             </dt>
@@ -1547,6 +1542,11 @@ <h2 id="Client">Client</h2>
             </dt>
             <dd>
             </dd>
+            <dt class="symbol-index-name">
+                <a href="Client.html#sendPresenceUpdate" class="!symbol-index-name">Client#<wbr>sendPresenceUpdate(chatId, state)</a>
+            </dt>
+            <dd>
+            </dd>
             <dt class="symbol-index-name">
                 <a href="Client.html#sendReaction" class="!symbol-index-name">Client#<wbr>sendReaction(messageId, reaction)</a>
             </dt>
@@ -2818,6 +2818,11 @@ <h2 id="Message">Message</h2>
             </dt>
             <dd>
             </dd>
+            <dt class="symbol-index-name">
+                <a href="Message.html#downloadMediaStream" class="!symbol-index-name">Message#<wbr>downloadMediaStream([options])</a>
+            </dt>
+            <dd>
+            </dd>
             <dt class="symbol-index-name">
                 <a href="Message.html#duration" class="!symbol-index-name">Message#<wbr>duration</a>
             </dt>
@@ -2863,16 +2868,16 @@ <h2 id="Message">Message</h2>
             </dt>
             <dd>
             </dd>
-            <dt class="symbol-index-name">
-                <a href="Message.html#getGroupMentions" class="!symbol-index-name">Message#<wbr>getGroupMentions()</a>
-            </dt>
-            <dd>
-            </dd>
     </dl>
 </div>
 
                             <div class="symbol-index-column">
     <dl class="symbol-index-list">
+            <dt class="symbol-index-name">
+                <a href="Message.html#getGroupMentions" class="!symbol-index-name">Message#<wbr>getGroupMentions()</a>
+            </dt>
+            <dd>
+            </dd>
             <dt class="symbol-index-name">
                 <a href="Message.html#getInfo" class="!symbol-index-name">Message#<wbr>getInfo()</a>
             </dt>
@@ -2963,16 +2968,16 @@ <h2 id="Message">Message</h2>
             </dt>
             <dd>
             </dd>
-            <dt class="symbol-index-name">
-                <a href="Message.html#links" class="!symbol-index-name">Message#<wbr>links</a>
-            </dt>
-            <dd>
-            </dd>
     </dl>
 </div>
 
                             <div class="symbol-index-column">
     <dl class="symbol-index-list">
+            <dt class="symbol-index-name">
+                <a href="Message.html#links" class="!symbol-index-name">Message#<wbr>links</a>
+            </dt>
+            <dd>
+            </dd>
             <dt class="symbol-index-name">
                 <a href="Message.html#location" class="!symbol-index-name">Message#<wbr>location</a>
             </dt>
@@ -4445,6 +4450,11 @@ <h2 id="window">window</h2>
 
                             <div class="symbol-index-column">
     <dl class="symbol-index-list">
+            <dt class="symbol-index-name">
+                <a href="window.WWebJS.html#.resolveMediaBlob" class="!symbol-index-name">window.<wbr>WWebJS.<wbr>resolveMediaBlob(msgId)</a>
+            </dt>
+            <dd>
+            </dd>
     </dl>
 </div>
 
@@ -4461,7 +4471,7 @@ <h2 id="window">window</h2>
                     <footer id="jsdoc-footer" class="jsdoc-footer">
                             <div id="jsdoc-footer-container">
                                     <p>
-                                      Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+                                      Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
                                     </p>
                             </div>
                     </footer>
diff --git a/docs/structures_Base.js.html b/docs/structures_Base.js.html
index 6086ac2ce3d..e7a433aecdf 100644
--- a/docs/structures_Base.js.html
+++ b/docs/structures_Base.js.html
@@ -63,7 +63,7 @@ <h1>Source: structures/Base.js</h1>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/structures_Broadcast.js.html b/docs/structures_Broadcast.js.html
index 8ac81b173cf..69c9a9e00ae 100644
--- a/docs/structures_Broadcast.js.html
+++ b/docs/structures_Broadcast.js.html
@@ -107,7 +107,7 @@ <h1>Source: structures/Broadcast.js</h1>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/structures_BusinessContact.js.html b/docs/structures_BusinessContact.js.html
index 6bbe16d83aa..0f6310abf29 100644
--- a/docs/structures_BusinessContact.js.html
+++ b/docs/structures_BusinessContact.js.html
@@ -59,7 +59,7 @@ <h1>Source: structures/BusinessContact.js</h1>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/structures_Buttons.js.html b/docs/structures_Buttons.js.html
index 2523107abc0..b37e108f7fa 100644
--- a/docs/structures_Buttons.js.html
+++ b/docs/structures_Buttons.js.html
@@ -125,7 +125,7 @@ <h1>Source: structures/Buttons.js</h1>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/structures_Call.js.html b/docs/structures_Call.js.html
index c03bacfb78b..145ab8618d4 100644
--- a/docs/structures_Call.js.html
+++ b/docs/structures_Call.js.html
@@ -119,7 +119,7 @@ <h1>Source: structures/Call.js</h1>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/structures_Channel.js.html b/docs/structures_Channel.js.html
index c5d7ae040bc..bc07e10623f 100644
--- a/docs/structures_Channel.js.html
+++ b/docs/structures_Channel.js.html
@@ -503,7 +503,7 @@ <h1>Source: structures/Channel.js</h1>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/structures_Chat.js.html b/docs/structures_Chat.js.html
index 2b305f440b3..821927228b5 100644
--- a/docs/structures_Chat.js.html
+++ b/docs/structures_Chat.js.html
@@ -390,7 +390,7 @@ <h1>Source: structures/Chat.js</h1>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/structures_ClientInfo.js.html b/docs/structures_ClientInfo.js.html
index 5eaf5d189aa..b936ed4264d 100644
--- a/docs/structures_ClientInfo.js.html
+++ b/docs/structures_ClientInfo.js.html
@@ -110,7 +110,7 @@ <h1>Source: structures/ClientInfo.js</h1>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/structures_Contact.js.html b/docs/structures_Contact.js.html
index f368a8b5380..578c04e41e1 100644
--- a/docs/structures_Contact.js.html
+++ b/docs/structures_Contact.js.html
@@ -189,15 +189,20 @@ <h1>Source: structures/Contact.js</h1>
             const contact &#x3D; await window
                 .require(&#x27;WAWebCollections&#x27;)
                 .Contact.find(contactId);
-            const resolved &#x3D; window
-                .require(&#x27;WAWebBlockContactUtils&#x27;)
-                .getContactToBlockOnlyUseIfNoAssociatedChat(
-                    contact,
-                    &#x27;ChatListBlock&#x27;,
-                );
-            await window
-                .require(&#x27;WAWebBlockContactAction&#x27;)
-                .blockContact({ contact: resolved });
+            const lid &#x3D; contact.id.isLid()
+                ? contact.id
+                : window
+                      .require(&#x27;WAWebApiContact&#x27;)
+                      .getAlternateUserWid(contact.id);
+            const ContactToBlock &#x3D; {
+                id: lid,
+                isContactBlocked: false,
+                phoneNumber: null,
+            };
+            await window.require(&#x27;WAWebBlockContactAction&#x27;).blockContact({
+                contact: ContactToBlock,
+                blockEntryPoint: &#x27;ChatListBlock&#x27;,
+            });
         }, this.id._serialized);
 
         this.isBlocked &#x3D; true;
@@ -212,18 +217,21 @@ <h1>Source: structures/Contact.js</h1>
         if (this.isGroup) return false;
 
         await this.client.pupPage.evaluate(async (contactId) &#x3D;&gt; {
-            const contact &#x3D; await window
+            let contact &#x3D; await window
                 .require(&#x27;WAWebCollections&#x27;)
                 .Contact.find(contactId);
-            const resolved &#x3D; window
-                .require(&#x27;WAWebBlockContactUtils&#x27;)
-                .getContactToBlockOnlyUseIfNoAssociatedChat(
-                    contact,
-                    &#x27;ChatListBlock&#x27;,
-                );
+            if (!contact.id.isLid()) {
+                const lid &#x3D; window
+                    .require(&#x27;WAWebApiContact&#x27;)
+                    .getAlternateUserWid(contact.id);
+
+                contact &#x3D; await window
+                    .require(&#x27;WAWebCollections&#x27;)
+                    .Contact.find(lid._serialized);
+            }
             await window
                 .require(&#x27;WAWebBlockContactAction&#x27;)
-                .unblockContact(resolved);
+                .unblockContact(contact, &#x27;ChatListBlock&#x27;);
         }, this.id._serialized);
 
         this.isBlocked &#x3D; false;
@@ -275,7 +283,7 @@ <h1>Source: structures/Contact.js</h1>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/structures_GroupChat.js.html b/docs/structures_GroupChat.js.html
index ec3192562b7..5861e7245c5 100644
--- a/docs/structures_GroupChat.js.html
+++ b/docs/structures_GroupChat.js.html
@@ -719,7 +719,7 @@ <h1>Source: structures/GroupChat.js</h1>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/structures_GroupNotification.js.html b/docs/structures_GroupNotification.js.html
index 7f26107bbb7..ff56c8c8f8e 100644
--- a/docs/structures_GroupNotification.js.html
+++ b/docs/structures_GroupNotification.js.html
@@ -152,7 +152,7 @@ <h1>Source: structures/GroupNotification.js</h1>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/structures_Label.js.html b/docs/structures_Label.js.html
index 1f4d8ec75e6..598c2f9dc78 100644
--- a/docs/structures_Label.js.html
+++ b/docs/structures_Label.js.html
@@ -89,7 +89,7 @@ <h1>Source: structures/Label.js</h1>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/structures_List.js.html b/docs/structures_List.js.html
index c446399bf94..845a53eeadc 100644
--- a/docs/structures_List.js.html
+++ b/docs/structures_List.js.html
@@ -126,7 +126,7 @@ <h1>Source: structures/List.js</h1>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/structures_Location.js.html b/docs/structures_Location.js.html
index c63f9efc92e..4e54173829e 100644
--- a/docs/structures_Location.js.html
+++ b/docs/structures_Location.js.html
@@ -102,7 +102,7 @@ <h1>Source: structures/Location.js</h1>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/structures_Message.js.html b/docs/structures_Message.js.html
index a3314631d7f..4f508139ea1 100644
--- a/docs/structures_Message.js.html
+++ b/docs/structures_Message.js.html
@@ -31,6 +31,7 @@ <h1>Source: structures/Message.js</h1>
           <article>
             <pre class="prettyprint linenums"><code>&#x27;use strict&#x27;;
 
+const { Readable } &#x3D; require(&#x27;stream&#x27;);
 const Base &#x3D; require(&#x27;./Base&#x27;);
 const MessageMedia &#x3D; require(&#x27;./MessageMedia&#x27;);
 const Location &#x3D; require(&#x27;./Location&#x27;);
@@ -538,84 +539,25 @@ <h1>Source: structures/Message.js</h1>
     }
 
     /**
-     * Downloads and returns the attatched message media
-     * @returns {Promise&amp;lt;MessageMedia&gt;}
+     * Downloads and returns the attached message media
+     * @returns {Promise&amp;lt;MessageMedia|undefined&gt;}
      */
     async downloadMedia() {
-        if (!this.hasMedia) {
-            return undefined;
-        }
+        if (!this.hasMedia) return undefined;
 
         const result &#x3D; await this.client.pupPage.evaluate(async (msgId) &#x3D;&gt; {
-            const msg &#x3D;
-                window.require(&#x27;WAWebCollections&#x27;).Msg.get(msgId) ||
-                (
-                    await window
-                        .require(&#x27;WAWebCollections&#x27;)
-                        .Msg.getMessagesById([msgId])
-                )?.messages?.[0];
-
-            // REUPLOADING mediaStage means the media is expired and the download button is spinning, cannot be downloaded now
-            if (
-                !msg ||
-                !msg.mediaData ||
-                msg.mediaData.mediaStage &#x3D;&#x3D;&#x3D; &#x27;REUPLOADING&#x27;
-            ) {
-                return null;
-            }
-            if (msg.mediaData.mediaStage !&#x3D; &#x27;RESOLVED&#x27;) {
-                // try to resolve media
-                await msg.downloadMedia({
-                    downloadEvenIfExpensive: true,
-                    rmrReason: 1,
-                });
-            }
-
-            if (
-                msg.mediaData.mediaStage.includes(&#x27;ERROR&#x27;) ||
-                msg.mediaData.mediaStage &#x3D;&#x3D;&#x3D; &#x27;FETCHING&#x27;
-            ) {
-                // media could not be downloaded
-                return undefined;
-            }
-
-            try {
-                const mockQpl &#x3D; {
-                    addAnnotations: function () {
-                        return this;
-                    },
-                    addPoint: function () {
-                        return this;
-                    },
-                };
-                const decryptedMedia &#x3D; await window
-                    .require(&#x27;WAWebDownloadManager&#x27;)
-                    .downloadManager.downloadAndMaybeDecrypt({
-                        directPath: msg.directPath,
-                        encFilehash: msg.encFilehash,
-                        filehash: msg.filehash,
-                        mediaKey: msg.mediaKey,
-                        mediaKeyTimestamp: msg.mediaKeyTimestamp,
-                        type: msg.type,
-                        signal: new AbortController().signal,
-                        downloadQpl: mockQpl,
-                    });
-
-                const data &#x3D;
-                    await window.WWebJS.arrayBufferToBase64Async(
-                        decryptedMedia,
-                    );
+            const resolved &#x3D; await window.WWebJS.resolveMediaBlob(msgId);
+            if (!resolved) return null;
 
-                return {
-                    data,
-                    mimetype: msg.mimetype,
-                    filename: msg.filename,
-                    filesize: msg.size,
-                };
-            } catch (e) {
-                if (e.status &amp;amp;&amp;amp; e.status &#x3D;&#x3D;&#x3D; 404) return undefined;
-                throw e;
-            }
+            const data &#x3D; await window.WWebJS.arrayBufferToBase64Async(
+                await resolved.blob.arrayBuffer(),
+            );
+            return {
+                data,
+                mimetype: resolved.mimetype,
+                filename: resolved.filename,
+                filesize: resolved.filesize,
+            };
         }, this.id._serialized);
 
         if (!result) return undefined;
@@ -627,6 +569,67 @@ <h1>Source: structures/Message.js</h1>
         );
     }
 
+    /**
+     * Like downloadMedia(), but returns a Readable stream instead of loading the entire file into memory.
+     * @param {Object} [options]
+     * @param {number} [options.chunkSize&#x3D;10485760] Size in bytes of each chunk read from the browser (default 10MB)
+     * @returns {Promise&amp;lt;MessageMediaStream|undefined&gt;} undefined if media is unavailable
+     */
+    async downloadMediaStream({ chunkSize &#x3D; 10 * 1024 * 1024 } &#x3D; {}) {
+        if (!this.hasMedia) return undefined;
+
+        const blobHandle &#x3D; await this.client.pupPage.evaluateHandle(
+            async (msgId) &#x3D;&gt; {
+                const result &#x3D; await window.WWebJS.resolveMediaBlob(msgId);
+                return result?.blob ?? null;
+            },
+            this.id._serialized,
+        );
+
+        let metadata;
+        try {
+            metadata &#x3D; await blobHandle.evaluate((blob, msgId) &#x3D;&gt; {
+                if (!blob) return null;
+                const msg &#x3D; window.require(&#x27;WAWebCollections&#x27;).Msg.get(msgId);
+                return {
+                    blobSize: blob.size,
+                    mimetype: msg?.mimetype,
+                    filename: msg?.filename,
+                    filesize: msg?.size,
+                };
+            }, this.id._serialized);
+        } catch (err) {
+            await blobHandle.dispose().catch(() &#x3D;&gt; {});
+            throw err;
+        }
+        if (!metadata) {
+            await blobHandle.dispose().catch(() &#x3D;&gt; {});
+            return undefined;
+        }
+
+        const { blobSize, ...rest } &#x3D; metadata;
+
+        async function* readChunks() {
+            try {
+                for (let offset &#x3D; 0; offset &amp;lt; blobSize; offset +&#x3D; chunkSize) {
+                    const base64 &#x3D; await blobHandle.evaluate(
+                        async (blob, s, e) &#x3D;&gt;
+                            window.WWebJS.arrayBufferToBase64Async(
+                                await blob.slice(s, e).arrayBuffer(),
+                            ),
+                        offset,
+                        offset + chunkSize,
+                    );
+                    yield Buffer.from(base64, &#x27;base64&#x27;);
+                }
+            } finally {
+                await blobHandle.dispose().catch(() &#x3D;&gt; {});
+            }
+        }
+
+        return { stream: Readable.from(readChunks()), ...rest };
+    }
+
     /**
      * Deletes a message from the chat
      * @param {?boolean} everyone If true and the message is sent by the current user or the user is an admin, will delete it for everyone in the chat.
@@ -1080,7 +1083,7 @@ <h1>Source: structures/Message.js</h1>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/structures_MessageMedia.js.html b/docs/structures_MessageMedia.js.html
index 6d600df1da6..d78175ada23 100644
--- a/docs/structures_MessageMedia.js.html
+++ b/docs/structures_MessageMedia.js.html
@@ -163,7 +163,7 @@ <h1>Source: structures/MessageMedia.js</h1>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/structures_Order.js.html b/docs/structures_Order.js.html
index a64fe699f9a..c6a3d9f839d 100644
--- a/docs/structures_Order.js.html
+++ b/docs/structures_Order.js.html
@@ -91,7 +91,7 @@ <h1>Source: structures/Order.js</h1>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/structures_Payment.js.html b/docs/structures_Payment.js.html
index dac7868f752..d68b422ead9 100644
--- a/docs/structures_Payment.js.html
+++ b/docs/structures_Payment.js.html
@@ -121,7 +121,7 @@ <h1>Source: structures/Payment.js</h1>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/structures_Poll.js.html b/docs/structures_Poll.js.html
index 88dcfda1e85..86b688d3115 100644
--- a/docs/structures_Poll.js.html
+++ b/docs/structures_Poll.js.html
@@ -83,7 +83,7 @@ <h1>Source: structures/Poll.js</h1>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/structures_PollVote.js.html b/docs/structures_PollVote.js.html
index d261e7b3b54..d1a4ed7bcc5 100644
--- a/docs/structures_PollVote.js.html
+++ b/docs/structures_PollVote.js.html
@@ -117,7 +117,7 @@ <h1>Source: structures/PollVote.js</h1>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/structures_PrivateChat.js.html b/docs/structures_PrivateChat.js.html
index 808a98fd7fb..a9861485bb1 100644
--- a/docs/structures_PrivateChat.js.html
+++ b/docs/structures_PrivateChat.js.html
@@ -50,7 +50,7 @@ <h1>Source: structures/PrivateChat.js</h1>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/structures_PrivateContact.js.html b/docs/structures_PrivateContact.js.html
index 6e9b557268f..50efafb1985 100644
--- a/docs/structures_PrivateContact.js.html
+++ b/docs/structures_PrivateContact.js.html
@@ -50,7 +50,7 @@ <h1>Source: structures/PrivateContact.js</h1>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/structures_Product.js.html b/docs/structures_Product.js.html
index edee2d050b7..38eee615d51 100644
--- a/docs/structures_Product.js.html
+++ b/docs/structures_Product.js.html
@@ -107,7 +107,7 @@ <h1>Source: structures/Product.js</h1>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/structures_ProductMetadata.js.html b/docs/structures_ProductMetadata.js.html
index c9e8c8d348f..ec6af3b9078 100644
--- a/docs/structures_ProductMetadata.js.html
+++ b/docs/structures_ProductMetadata.js.html
@@ -63,7 +63,7 @@ <h1>Source: structures/ProductMetadata.js</h1>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/structures_Reaction.js.html b/docs/structures_Reaction.js.html
index 5da180d714c..b7ec3a0ba20 100644
--- a/docs/structures_Reaction.js.html
+++ b/docs/structures_Reaction.js.html
@@ -106,7 +106,7 @@ <h1>Source: structures/Reaction.js</h1>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/structures_ScheduledEvent.js.html b/docs/structures_ScheduledEvent.js.html
index 7b7a9d4a2c5..fec1be807c9 100644
--- a/docs/structures_ScheduledEvent.js.html
+++ b/docs/structures_ScheduledEvent.js.html
@@ -122,7 +122,7 @@ <h1>Source: structures/ScheduledEvent.js</h1>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/util_Constants.js.html b/docs/util_Constants.js.html
index b31ac905cfe..4bcd73308ba 100644
--- a/docs/util_Constants.js.html
+++ b/docs/util_Constants.js.html
@@ -227,7 +227,7 @@ <h1>Source: util/Constants.js</h1>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/util_Injected_Utils.js.html b/docs/util_Injected_Utils.js.html
index 32fecaee04c..2a66d9aa308 100644
--- a/docs/util_Injected_Utils.js.html
+++ b/docs/util_Injected_Utils.js.html
@@ -1136,6 +1136,63 @@ <h1>Source: util/Injected/Utils.js</h1>
         });
     };
 
+    /**
+     * Resolves the media blob and metadata for a message.
+     * Shared by downloadMedia and downloadMediaStream.
+     * @param {string} msgId
+     * @returns {Promise&amp;lt;{blob: Blob, mimetype: string, filename: string, filesize: number}|null&gt;}
+     */
+    window.WWebJS.resolveMediaBlob &#x3D; async (msgId) &#x3D;&gt; {
+        const { Msg } &#x3D; window.require(&#x27;WAWebCollections&#x27;);
+        const msg &#x3D;
+            Msg.get(msgId) ||
+            (await Msg.getMessagesById([msgId]))?.messages?.[0];
+
+        if (
+            !msg ||
+            !msg.mediaData ||
+            msg.mediaData.mediaStage &#x3D;&#x3D;&#x3D; &#x27;REUPLOADING&#x27;
+        ) {
+            return null;
+        }
+
+        // Always call internal downloadMedia - never skip based on
+        // mediaStage, because cache eviction can leave stage&#x3D;RESOLVED
+        // with empty InMemoryMediaBlobCache.
+        await msg.downloadMedia({
+            downloadEvenIfExpensive: true,
+            rmrReason: 1,
+            isUserInitiated: true,
+        });
+
+        if (
+            msg.mediaData.mediaStage.includes(&#x27;ERROR&#x27;) ||
+            msg.mediaData.mediaStage &#x3D;&#x3D;&#x3D; &#x27;FETCHING&#x27;
+        ) {
+            return null;
+        }
+
+        const cached &#x3D; window
+            .require(&#x27;WAWebMediaInMemoryBlobCache&#x27;)
+            .InMemoryMediaBlobCache.get(msg.mediaObject?.filehash);
+
+        let blob;
+        if (cached) {
+            blob &#x3D; cached;
+        } else if (msg.mediaObject?.mediaBlob) {
+            blob &#x3D; msg.mediaObject.mediaBlob.forceToBlob();
+        }
+
+        if (!blob) return null;
+
+        return {
+            blob,
+            mimetype: msg.mimetype,
+            filename: msg.filename,
+            filesize: msg.size,
+        };
+    };
+
     window.WWebJS.arrayBufferToBase64 &#x3D; (arrayBuffer) &#x3D;&gt; {
         let binary &#x3D; &#x27;&#x27;;
         const bytes &#x3D; new Uint8Array(arrayBuffer);
@@ -1778,7 +1835,7 @@ <h1>Source: util/Injected/Utils.js</h1>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/util_InterfaceController.js.html b/docs/util_InterfaceController.js.html
index b4e800dc5a1..122a9adf6df 100644
--- a/docs/util_InterfaceController.js.html
+++ b/docs/util_InterfaceController.js.html
@@ -212,7 +212,7 @@ <h1>Source: util/InterfaceController.js</h1>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/util_Puppeteer.js.html b/docs/util_Puppeteer.js.html
index 33497a5b9c1..1f83838975f 100644
--- a/docs/util_Puppeteer.js.html
+++ b/docs/util_Puppeteer.js.html
@@ -62,7 +62,7 @@ <h1>Source: util/Puppeteer.js</h1>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/util_Util.js.html b/docs/util_Util.js.html
index e338ca98040..80714e7926c 100644
--- a/docs/util_Util.js.html
+++ b/docs/util_Util.js.html
@@ -238,7 +238,7 @@ <h1>Source: util/Util.js</h1>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/webCache_LocalWebCache.js.html b/docs/webCache_LocalWebCache.js.html
index 940dcb9c7eb..5bb855ea5ca 100644
--- a/docs/webCache_LocalWebCache.js.html
+++ b/docs/webCache_LocalWebCache.js.html
@@ -81,7 +81,7 @@ <h1>Source: webCache/LocalWebCache.js</h1>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/webCache_RemoteWebCache.js.html b/docs/webCache_RemoteWebCache.js.html
index 2db3d59f083..6a0b2f84d2f 100644
--- a/docs/webCache_RemoteWebCache.js.html
+++ b/docs/webCache_RemoteWebCache.js.html
@@ -85,7 +85,7 @@ <h1>Source: webCache/RemoteWebCache.js</h1>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>
diff --git a/docs/webCache_WebCache.js.html b/docs/webCache_WebCache.js.html
index 546ed71f7f1..a3636702581 100644
--- a/docs/webCache_WebCache.js.html
+++ b/docs/webCache_WebCache.js.html
@@ -56,7 +56,7 @@ <h1>Source: webCache/WebCache.js</h1>
   <footer id="jsdoc-footer" class="jsdoc-footer">
     <div id="jsdoc-footer-container">
       <p>
-        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on April 24, 2026.
+        Generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc</a> 3.6.11 on July 16, 2026.
       </p>
     </div>
   </footer>