whalibmob 5.5.83 → 5.5.86

package/README.md

@@ -157,6 +157,7 @@ npm install -g whalibmob
     - [Quoted Reply](#quoted-reply)
     - [Location Message](#location-message)
     - [Contact Message (vCard)](#contact-message-vcard)
+    - [Call Link](#call-link)
     - [Media Messages](#media-messages)
       - [Image Message](#image-message)
       - [Video Message](#video-message)
@@ -1137,6 +1138,7 @@ const { id, encKey } = await client.sendPoll(
   1            // voters may pick 1 option (0 = unlimited)
 )
 // encKey (32-byte Buffer) is needed to decrypt incoming poll votes
+// (also returned as `messageSecret`, which is the name the protocol uses)
 ```
 
 ### Quoted Reply
@@ -1181,6 +1183,12 @@ await client.sendLocation('919634847671@s.whatsapp.net', 48.8566, 2.3522, {
 await client.sendLocation('120363000000000000@g.us', 51.5074, -0.1278, {
   name: 'London'
 })
+
+// with a map image for the bubble — WhatsApp draws a blank card without one
+await client.sendLocation('919634847671@s.whatsapp.net', 48.8566, 2.3522, {
+  name: 'Eiffel Tower',
+  thumbnail: jpegBuffer
+})
 ```
 
 ### Contact Message (vCard)
@@ -1200,8 +1208,37 @@ const vcard = [
 await client.sendContact('919634847671@s.whatsapp.net', 'Alice Smith', vcard)
 ```
 
+### Call Link
+
+Ask WhatsApp for a link that lets someone join a call by tapping it, instead of
+being rung. Returns the token, the shareable link and the media type.
+
+```js
+const { link } = await client.createCallLink('video')
+// https://call.whatsapp.com/video/XXXXXXXX
+
+// audio is the default
+const audio = await client.createCallLink()
+
+// schedule it — startTime is seconds since the epoch
+await client.createCallLink('video', { startTime: 1800000000 })
+
+// create it and send it in one step
+await client.sendCallLink('919634847671@s.whatsapp.net', 'video', {
+  text: 'Join me here:'
+})
+```
+
 ## Media Messages
 
+Photos and videos are sent with an inline preview so they show up in the chat
+directly, rather than as a placeholder the recipient has to tap. The dimensions
+are read out of the file header with no dependency at all. The preview itself
+uses `jimp` (installed automatically as an optional dependency) or `sharp` if
+you have it; failing both, a photo that carries an EXIF thumbnail still gets
+one. Video previews need `ffmpeg` on PATH — on Termux, `pkg install ffmpeg`.
+Without any of these the media still sends, just without the preview.
+
 ### Image Message
 
 ```js

package/cli.js

@@ -362,7 +362,9 @@ const HELP = `
 
   Contacts
     /whatsapp  <phone...>                    check which numbers have WhatsApp
-    /picture   <jid>                         get profile picture URL of a contact
+    /picture   <jid> [file]                  profile picture URL; downloads it when a file is given
+    /read      <jid> <msgId...>              mark messages as read (blue ticks)
+    /autoread  on|off                        auto-send read receipts for incoming messages
     /contact about <jid>                     get bio/status text of a contact
 
   Chats
@@ -393,7 +395,7 @@ const HELP = `
     /group desc    <jid> <text>              change description
     /group invite      <jid>                  get invite link
     /group revoke      <jid>                  revoke invite link
-    /group join        <code>                 join by invite code
+    /group join        <code|link>            join by invite code or full link
     /group invite-info <code|url>             preview group metadata from invite link
     /group photo       <jid> <file>           change group picture (JPEG)
     /group meta        <jid>                  query group metadata + participants
@@ -1003,11 +1005,37 @@ async function handleLine(line) {
       }
 
       case '/picture': {
+        requireConn();
+        const jid  = normalizeJid(p[1]);
+        const dest = p[2];
+        if (!jid) { fail('usage: /picture <jid> [file]'); break; }
+        const info = await _client.queryPictureInfo(jid);
+        if (!info || !info.url) { out('  (no picture or private)'); break; }
+        out('  ' + info.url);
+        if (info.id) out('  id  ' + info.id);
+        if (!dest) break;
+        const buf = await _client.downloadProfilePicture(jid);
+        if (!buf) { fail('download returned nothing'); break; }
+        require('fs').writeFileSync(dest, buf);
+        out('  saved  ' + dest + '  (' + buf.length + ' bytes)');
+        break;
+      }
+
+      case '/read': {
         requireConn();
         const jid = normalizeJid(p[1]);
-        if (!jid) { fail('usage: /picture <jid>'); break; }
-        const url = await _client.queryPicture(jid);
-        out('  ' + (url || '(no picture or private)'));
+        const ids = p.slice(2);
+        if (!jid || !ids.length) { fail('usage: /read <jid> <msgId...>'); break; }
+        _client.markRead(jid, ids);
+        out('marked read  ' + ids.length + ' message(s) in ' + jid);
+        break;
+      }
+
+      case '/autoread': {
+        const val = (p[1] || '').toLowerCase();
+        if (val !== 'on' && val !== 'off') { fail('usage: /autoread on|off'); break; }
+        if (_client) _client.autoRead = (val === 'on');
+        out('auto read receipts  ' + val);
         break;
       }
 
@@ -1232,14 +1260,15 @@ async function handleLine(line) {
         else if (sub === 'revoke') {
           const gj = asGroupJid(p[2]);
           if (!gj) { fail('usage: /group revoke <jid>'); break; }
-          await _client.revokeGroupInvite(gj);
+          const fresh = await _client.revokeGroupInvite(gj);
           out('invite link revoked');
+          if (fresh) out('  new link  ' + fresh);
         }
         else if (sub === 'join') {
           const code = p[2];
-          if (!code) { fail('usage: /group join <code>'); break; }
-          const jid = await _client.acceptGroupInvite(code);
-          out('joined  ' + (jid || 'ok'));
+          if (!code) { fail('usage: /group join <code|link>'); break; }
+          const r = await _client.joinGroupWithLink(code);
+          out((r.pendingApproval ? 'join request sent  ' : 'joined  ') + r.jid);
         }
         else if (sub === 'invite-info') {
           const code = p[2];