whalibmob 5.1.13 → 5.1.15

package/.env.example

@@ -0,0 +1,49 @@
+# ─────────────────────────────────────────────────────────────────────────────
+# whalibmob — Device Emulation Configuration
+# Copy this file to .env in your project root and set the values you need.
+# All variables are optional; defaults emulate an iPhone 15 Pro running iOS 17.
+# ─────────────────────────────────────────────────────────────────────────────
+
+# Operating system to emulate.  Accepted values: ios | android
+# Default: ios
+# WA_OS=android
+
+# Named device profile.
+#
+# iOS profiles (WA_OS=ios):
+#   iphone_15_pro, iphone_15, iphone_14_pro, iphone_14, iphone_13_pro,
+#   iphone_13, iphone_12_pro, iphone_12, iphone_11_pro, iphone_11,
+#   iphone_se3, iphone_xs
+#
+# Android profiles (WA_OS=android):
+#   pixel_8_pro, pixel_8, pixel_7, pixel_7a,
+#   samsung_s24_ultra, samsung_s24, samsung_s23_ultra, samsung_s23, samsung_a55,
+#   oneplus_12, oneplus_11, xiaomi_14, xiaomi_13, oppo_find_x7, realme_gt5
+#
+# Default: iphone_15_pro  (or pixel_8_pro when WA_OS=android)
+# WA_DEVICE=pixel_8_pro
+
+# ── Custom device overrides (applied on top of the selected profile) ─────────
+# Use these to fine-tune any field without creating a new profile.
+
+# WA_DEVICE_MODEL=SM-S928B
+# WA_DEVICE_MANUFACTURER=samsung
+# WA_DEVICE_OS_VERSION=14
+# WA_DEVICE_BUILD=UP1A.231005.007
+# WA_DEVICE_MODEL_ID=samsung-sm-s928b
+
+# ── Version & token overrides ─────────────────────────────────────────────────
+
+# Pin the WhatsApp version string instead of fetching the latest from the store.
+# Format: 2.x.x.x  (four-part)
+# WA_VERSION=2.24.13.80
+
+# Override the static token used in registration token computation.
+# Only needed if WhatsApp rotates the bundled token.
+# WA_STATIC_TOKEN=Y29Cs6AVNR2bj5PBeKSYFd1nAKuvNQ3h
+
+# ── Proxy / Tor ───────────────────────────────────────────────────────────────
+
+# Route registration HTTP traffic through a SOCKS5 proxy or Tor.
+# TOR_PROXY=socks5://127.0.0.1:9050
+# SOCKS_PROXY=socks5://user:pass@proxy.example.com:1080

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Kunboruto20
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,5 +1,5 @@
 <div align='center'>whalibmob is a pure JavaScript Node.js library for interacting with the WhatsApp Mobile API.</div>
-<div align='center'>v5.0.0</div>
+<div align='center'>v5.1.14</div>
 
 ##
 
@@ -41,6 +41,7 @@ npm install -g whalibmob
     - [Send Voice Note](#send-voice-note)
     - [Send Document](#send-document)
     - [Send Sticker](#send-sticker)
+    - [Send Poll](#send-poll-cli)
     - [React to a Message](#react-to-a-message)
     - [Edit a Message](#edit-a-message)
     - [Delete a Message](#delete-a-message)
@@ -90,6 +91,9 @@ npm install -g whalibmob
     - [Pending Join Requests](#pending-join-requests)
     - [Approve / Reject Join Requests](#approve--reject-join-requests)
     - [Group Settings](#group-settings)
+  - [Community Commands](#community-commands-cli)
+  - [Newsletter / Channel Commands](#newsletter-channel-commands)
+  - [Business Profile Command](#business-profile-command-cli)
   - [Registration Commands (in-shell)](#registration-commands-in-shell)
   - [Connection Commands (in-shell)](#connection-commands-in-shell)
   - [Full Command Reference Table](#full-command-reference-table)
@@ -124,6 +128,7 @@ npm install -g whalibmob
     - [Status / Stories](#status--stories)
   - [Send States in Chat](#send-states-in-chat)
     - [Reading Messages](#reading-messages)
+    - [Mark Voice Message Played](#mark-voice-message-played)
     - [Update Presence](#update-presence)
   - [Modifying Chats](#modifying-chats)
     - [Archive / Unarchive a Chat](#archive--unarchive-a-chat)
@@ -177,6 +182,12 @@ npm install -g whalibmob
 - [WhatsApp IDs](#whatsapp-ids)
 - [Transport](#transport)
 - [Media Encryption](#media-encryption)
+- [Device Emulation](#device-emulation)
+  - [Quick Start](#device-quick-start)
+  - [iOS Profiles](#ios-profiles)
+  - [Android Profiles](#android-profiles)
+  - [Custom Device Fields](#custom-device-fields)
+  - [Version & Token Overrides](#version--token-overrides)
 
 ---
 
@@ -308,10 +319,19 @@ connect()
 | `auth_failure` | `{ reason }` | Session revoked or banned |
 | `message` | message object | Incoming message received |
 | `receipt` | `{ type, id, from }` | Delivery / read / played receipt |
-| `presence` | `{ from, available, lastSeen }` | Contact came online or went offline |
+| `presence` | `{ from, available }` | Contact came online or went offline |
 | `group_update` | `{ type, groupJid, actor, participants, subject, timestamp }` | Member added / removed / promoted / demoted, subject or settings changed |
 | `notification` | node object | Group or contact update notification |
 | `call` | `{ from }` | Incoming call event |
+| `chat_read` | `{ jid, read }` | Chat marked read (`read: true`) or unread (`read: false`) |
+| `chat_muted` | `{ jid, muted, until }` | Chat muted or unmuted; `until` is epoch ms (−1 = indefinite) |
+| `chat_pinned` | `{ jid, pinned }` | Chat pinned or unpinned |
+| `chat_archived` | `{ jid, archived }` | Chat archived or unarchived |
+| `message_starred` | `{ msgId, chatJid, starred }` | Message starred or unstarred |
+| `stream_error` | `{ reason }` | Server sent a fatal stream error |
+| `decrypt_error` | `{ id, from, participant, err }` | Failed to decrypt an incoming message |
+| `session_refresh` | `{ node }` | Late re-authentication success; Signal session refreshed |
+| `close` | — | Underlying TCP socket closed |
 | `error` | Error | Unhandled transport error |
 
 The message object contains:
@@ -429,7 +449,7 @@ function decryptMedia(encrypted, mediaKey, mediaType) {
 function downloadBuffer(url) {
   return new Promise((resolve, reject) => {
     const lib = url.startsWith('https') ? https : http
-    const req = lib.get(url, { headers: { 'User-Agent': 'WhatsApp/2.23.24.83 A' } }, res => {
+    const req = lib.get(url, { headers: { 'User-Agent': 'WhatsApp/2.26.7.75 A' } }, res => {
       if (res.statusCode !== 200) { res.resume(); return reject(new Error('HTTP ' + res.statusCode)) }
       const chunks = []
       res.on('data',  c => chunks.push(c))
@@ -711,6 +731,15 @@ await client.sendStatus('Good morning!')
 await client.markChatRead('919634847671@s.whatsapp.net')
 ```
 
+### Mark Voice Message Played
+
+Send a `played` receipt for a received voice note (push-to-talk audio). This tells the sender that you have listened to the message.
+
+```js
+// msgId: ID of the audio message, from: JID of the sender
+client.markMessagePlayed('3EB0ABCDEF123456', '919634847671@s.whatsapp.net')
+```
+
 ### Update Presence
 
 ```js
@@ -820,7 +849,7 @@ const groupUrl = await client.queryPicture('120363000000000000@g.us')
 // triggers 'presence' events when the contact comes online or goes offline
 client.subscribeToPresence('919634847671@s.whatsapp.net')
 
-client.on('presence', ({ from, available, lastSeen }) => {
+client.on('presence', ({ from, available }) => {
   console.log(from, available ? 'online' : 'offline')
 })
 ```
@@ -1330,6 +1359,18 @@ The file must be in WebP format:
 wa> /sticker 919634847671@s.whatsapp.net ./sticker.webp
 ```
 
+#### Send Poll (CLI)
+
+Separate the question from the options using `|`. At least two options are required. Optionally append `selectable=N` to limit how many options a voter may choose (0 = any):
+
+```sh
+# single-choice poll (selectable=1)
+wa> /poll 919634847671@s.whatsapp.net Best language? | JavaScript | Python | Rust | selectable=1
+
+# unlimited-choice poll (default)
+wa> /poll 120363000000000000@g.us Pick your favourites | Red | Green | Blue
+```
+
 #### React to a Message
 
 ```sh
@@ -1849,6 +1890,78 @@ wa> /group settings 120363000000000000@g.us approve_participants admins
 
 ---
 
+### Community Commands (CLI)
+
+Communities group multiple linked groups under one umbrella. Only the community creator can link / unlink groups or deactivate the community.
+
+```sh
+# create a community (description is optional)
+wa> /community create "Dev Squad" "Our developer community"
+
+# link an existing group into the community
+wa> /community link  120363000000000001@g.us 120363000000000002@g.us
+
+# unlink a group from the community
+wa> /community unlink 120363000000000001@g.us 120363000000000002@g.us
+
+# permanently deactivate (delete) a community
+wa> /community deactivate 120363000000000001@g.us
+```
+
+---
+
+### Newsletter / Channel Commands
+
+Newsletters are one-to-many broadcast channels. Only the owner can post; anyone can subscribe.
+
+```sh
+# create a new channel
+wa> /newsletter create Tech News Daily tips about technology
+
+# subscribe to a channel
+wa> /newsletter join 120363000000000004@newsletter
+
+# unsubscribe from a channel
+wa> /newsletter leave 120363000000000004@newsletter
+
+# query channel metadata (name, description, subscriber count)
+wa> /newsletter info 120363000000000004@newsletter
+  ────────────────────────────────────────────────────────
+  jid           120363000000000004@newsletter
+  name          Tech News
+  description   Daily tips about technology
+  subscribers   1234
+  ────────────────────────────────────────────────────────
+
+# update the channel description (you must be the owner)
+wa> /newsletter desc 120363000000000004@newsletter New description here
+
+# post a text update to your channel (you must be the owner)
+wa> /newsletter post 120363000000000004@newsletter Breaking: WhatsApp adds polls!
+```
+
+---
+
+### Business Profile Command (CLI)
+
+Query the public business profile of any WhatsApp Business account:
+
+```sh
+wa> /biz 919634847671@s.whatsapp.net
+  ────────────────────────────────────────────────────────
+  jid           919634847671@s.whatsapp.net
+  category      Software & IT Services
+  email         contact@example.com
+  website       https://example.com
+  address       123 Main St
+  description   We build software
+  ────────────────────────────────────────────────────────
+```
+
+Returns a message if the number is not a WhatsApp Business account.
+
+---
+
 ### Registration Commands (in-shell)
 
 These commands work from within the shell — useful when you need to register a second number without closing the current session:
@@ -1909,6 +2022,7 @@ wa> /quit
 | `/ptt <jid> <file>` | Send a voice note (push-to-talk) |
 | `/doc <jid> <file> [name]` | Send a document |
 | `/sticker <jid> <file>` | Send a sticker (.webp) |
+| `/poll <jid> <question> \| <opt1> \| <opt2> [selectable=N]` | Send a poll |
 | `/react <jid> <msgId> <emoji>` | React to a message |
 | `/edit <jid> <msgId> <text>` | Edit a sent message |
 | `/delete <jid> <msgId> [all]` | Delete a message (add `all` for everyone) |
@@ -1970,6 +2084,20 @@ wa> /quit
 | `/group approve <jid> <member...>` | Approve pending join requests |
 | `/group reject <jid> <member...>` | Reject pending join requests |
 | `/group settings <jid> <setting> <policy>` | Change group setting |
+| **Community** | |
+| `/community create <subject> [description]` | Create a community |
+| `/community deactivate <communityJid>` | Permanently delete a community |
+| `/community link <communityJid> <groupJid>` | Link a group into a community |
+| `/community unlink <communityJid> <groupJid>` | Unlink a group from a community |
+| **Newsletter / Channel** | |
+| `/newsletter create <name> [description]` | Create a newsletter channel |
+| `/newsletter join <jid>` | Subscribe to a channel |
+| `/newsletter leave <jid>` | Unsubscribe from a channel |
+| `/newsletter info <jid>` | Query channel metadata |
+| `/newsletter desc <jid> <text>` | Update channel description |
+| `/newsletter post <jid> <text>` | Post a text update to your channel |
+| **Business** | |
+| `/biz <phone\|jid>` | Query business profile of a WhatsApp Business account |
 | **Registration** | |
 | `/reg check <phone>` | Check if number has WhatsApp |
 | `/reg code <phone> [method]` | Request verification code |
@@ -1980,7 +2108,7 @@ wa> /quit
 | `/reconnect` | Force reconnection |
 | `/session` | Show session info |
 | `/help` | Show all commands |
-| `/quit` | Disconnect and exit |
+| `/quit` / `/exit` | Disconnect and exit |
 
 ---
 
@@ -2056,6 +2184,111 @@ HKDF info strings:
 
 See the [Receiving Media](#receiving-media) section for a complete working code example.
 
+## Device Emulation
+
+whalibmob can emulate any iOS or Android device when communicating with WhatsApp servers.
+The device profile controls the User-Agent header, the Noise Protocol `platform` field, and the static token used in registration token computation.
+
+Configuration is done entirely through environment variables — no code changes required.
+Copy `.env.example` to `.env` in your project root and set the variables you need.
+
+### Device Quick Start
+
+Emulate an Android Pixel 8 Pro:
+
+```sh
+WA_OS=android WA_DEVICE=pixel_8_pro node your-app.js
+```
+
+Or put the variables in a `.env` file. When using the **CLI** (`wa` command) the file is loaded automatically. When using the **library directly**, load it before `require('whalibmob')`:
+
+```js
+require('dotenv').config()          // must be first
+const { WhalibmobClient } = require('whalibmob')
+```
+
+```dotenv
+WA_OS=android
+WA_DEVICE=pixel_8_pro
+```
+
+Emulate a custom Samsung device:
+
+```dotenv
+WA_OS=android
+WA_DEVICE_MODEL=SM-S928B
+WA_DEVICE_MANUFACTURER=samsung
+WA_DEVICE_OS_VERSION=14
+WA_DEVICE_BUILD=UP1A.231005.007
+WA_DEVICE_MODEL_ID=samsung-sm-s928b
+```
+
+### iOS Profiles
+
+Available values for `WA_DEVICE` when `WA_OS=ios` (default):
+
+| Profile key | Device | iOS version |
+|---|---|---|
+| `iphone_15_pro` | iPhone 15 Pro | 17.4.1 |
+| `iphone_15` | iPhone 15 | 17.4.1 |
+| `iphone_14_pro` | iPhone 14 Pro | 16.7.5 |
+| `iphone_14` | iPhone 14 | 16.7.5 |
+| `iphone_13_pro` | iPhone 13 Pro | 16.7.5 |
+| `iphone_13` | iPhone 13 | 16.7.5 |
+| `iphone_12_pro` | iPhone 12 Pro | 15.8.2 |
+| `iphone_12` | iPhone 12 | 15.8.2 |
+| `iphone_11_pro` | iPhone 11 Pro | 15.8.2 |
+| `iphone_11` | iPhone 11 | 15.8.2 |
+| `iphone_se3` | iPhone SE (3rd gen) | 16.7.5 |
+| `iphone_xs` | iPhone Xs | 15.8.2 |
+
+iOS User-Agent format: `WhatsApp/<version> iOS/<osVersion> Device/<model>`
+
+### Android Profiles
+
+Available values for `WA_DEVICE` when `WA_OS=android`:
+
+| Profile key | Device | Android version |
+|---|---|---|
+| `pixel_8_pro` | Pixel 8 Pro | 14 |
+| `pixel_8` | Pixel 8 | 14 |
+| `pixel_7` | Pixel 7 | 14 |
+| `pixel_7a` | Pixel 7a | 14 |
+| `samsung_s24_ultra` | Samsung Galaxy S24 Ultra | 14 |
+| `samsung_s24` | Samsung Galaxy S24 | 14 |
+| `samsung_s23_ultra` | Samsung Galaxy S23 Ultra | 14 |
+| `samsung_s23` | Samsung Galaxy S23 | 14 |
+| `samsung_a55` | Samsung Galaxy A55 | 14 |
+| `oneplus_12` | OnePlus 12 | 14 |
+| `oneplus_11` | OnePlus 11 | 13 |
+| `xiaomi_14` | Xiaomi 14 | 14 |
+| `xiaomi_13` | Xiaomi 13 | 13 |
+| `oppo_find_x7` | OPPO Find X7 | 14 |
+| `realme_gt5` | realme GT 5 Pro | 14 |
+
+Android User-Agent format: `WhatsApp/<version> A`
+
+The Android version is fetched automatically from the Google Play Store on first use and cached in memory. If the fetch fails, `ANDROID_VERSION_FALLBACK` is used.
+
+### Custom Device Fields
+
+These variables override individual fields on top of the selected profile:
+
+| Variable | Description |
+|---|---|
+| `WA_DEVICE_MODEL` | Device model string (e.g. `SM-S928B`) |
+| `WA_DEVICE_MANUFACTURER` | Manufacturer name (e.g. `samsung`) |
+| `WA_DEVICE_OS_VERSION` | OS version string (e.g. `14`) |
+| `WA_DEVICE_BUILD` | Build fingerprint (e.g. `UP1A.231005.007`) |
+| `WA_DEVICE_MODEL_ID` | Model ID slug (e.g. `samsung-sm-s928b`) |
+
+### Version & Token Overrides
+
+| Variable | Description |
+|---|---|
+| `WA_VERSION` | Pin the WhatsApp version (e.g. `2.24.13.80`). Skips the live store fetch. |
+| `WA_STATIC_TOKEN` | Override the static token used in registration token computation. |
+
 ## License
 
 MIT

package/cli.js

@@ -1,6 +1,12 @@
 #!/usr/bin/env node
 'use strict';
 
+// Load .env from the current working directory (silently — no error if missing).
+// This lets users configure WA_OS, WA_DEVICE, WA_VERSION etc. without touching
+// their shell environment.  Must happen before any other require() so that
+// process.env is fully populated when modules read it at load time.
+try { require('dotenv').config(); } catch (_) {}
+
 // Suppress internal [DBG] lines — keep console clean for users
 const _origStderrWrite = process.stderr.write.bind(process.stderr);
 process.stderr.write = function(chunk, enc, cb) {
@@ -22,13 +28,14 @@ const {
   requestSmsCode,
   verifyCode,
   assertRegistrationKeys,
-  fetchIosVersion,
+  fetchWaVersion,
+  getDeviceConfig,
   createNewStore,
   saveStore,
   loadStore
 } = require('./lib/Client');
 
-const VERSION = '5.1.9';
+const VERSION = '5.1.15';
 
 // ─── output helpers ───────────────────────────────────────────────────────────
 
@@ -481,8 +488,9 @@ async function handleLine(line) {
         const jid = normalizeJid(jR);
         if (!jid || !file) { fail('usage: /image <jid> <file> [caption]'); break; }
         out('uploading...');
-        const r = await _client.sendImage(jid, file, { caption: cap.join(' ') || undefined });
-        out('sent  ' + (r && r.id ? r.id : r));
+        _client.sendImage(jid, file, { caption: cap.join(' ') || undefined })
+          .then(r => out('sent  ' + (r && r.id ? r.id : r)))
+          .catch(e => fail('image error: ' + e.message));
         break;
       }
 
@@ -492,8 +500,9 @@ async function handleLine(line) {
         const jid = normalizeJid(jR);
         if (!jid || !file) { fail('usage: /video <jid> <file> [caption]'); break; }
         out('uploading...');
-        const r = await _client.sendVideo(jid, file, { caption: cap.join(' ') || undefined });
-        out('sent  ' + (r && r.id ? r.id : r));
+        _client.sendVideo(jid, file, { caption: cap.join(' ') || undefined })
+          .then(r => out('sent  ' + (r && r.id ? r.id : r)))
+          .catch(e => fail('video error: ' + e.message));
         break;
       }
 
@@ -503,8 +512,9 @@ async function handleLine(line) {
         const jid = normalizeJid(jR);
         if (!jid || !file) { fail('usage: /audio <jid> <file>'); break; }
         out('uploading...');
-        const r = await _client.sendAudio(jid, file, {});
-        out('sent  ' + (r && r.id ? r.id : r));
+        _client.sendAudio(jid, file, {})
+          .then(r => out('sent  ' + (r && r.id ? r.id : r)))
+          .catch(e => fail('audio error: ' + e.message));
         break;
       }
 
@@ -514,8 +524,9 @@ async function handleLine(line) {
         const jid = normalizeJid(jR);
         if (!jid || !file) { fail('usage: /ptt <jid> <file>'); break; }
         out('uploading...');
-        const r = await _client.sendAudio(jid, file, { ptt: true });
-        out('sent  ' + (r && r.id ? r.id : r));
+        _client.sendAudio(jid, file, { ptt: true })
+          .then(r => out('sent  ' + (r && r.id ? r.id : r)))
+          .catch(e => fail('ptt error: ' + e.message));
         break;
       }
 
@@ -525,8 +536,9 @@ async function handleLine(line) {
         const jid = normalizeJid(jR);
         if (!jid || !file) { fail('usage: /doc <jid> <file> [name]'); break; }
         out('uploading...');
-        const r = await _client.sendDocument(jid, file, { fileName: fname || path.basename(file) });
-        out('sent  ' + (r && r.id ? r.id : r));
+        _client.sendDocument(jid, file, { fileName: fname || path.basename(file) })
+          .then(r => out('sent  ' + (r && r.id ? r.id : r)))
+          .catch(e => fail('document error: ' + e.message));
         break;
       }
 
@@ -536,8 +548,9 @@ async function handleLine(line) {
         const jid = normalizeJid(jR);
         if (!jid || !file) { fail('usage: /sticker <jid> <file>'); break; }
         out('uploading...');
-        const r = await _client.sendSticker(jid, file, {});
-        out('sent  ' + (r && r.id ? r.id : r));
+        _client.sendSticker(jid, file, {})
+          .then(r => out('sent  ' + (r && r.id ? r.id : r)))
+          .catch(e => fail('sticker error: ' + e.message));
         break;
       }
 
@@ -546,8 +559,9 @@ async function handleLine(line) {
         const [, jR, msgId, emoji] = p;
         const jid = normalizeJid(jR);
         if (!jid || !msgId || !emoji) { fail('usage: /react <jid> <msgId> <emoji>'); break; }
-        const r = await _client.sendReaction(jid, msgId, emoji);
-        out('sent  ' + (r && r.id ? r.id : r));
+        _client.sendReaction(jid, msgId, emoji)
+          .then(r => out('sent  ' + (r && r.id ? r.id : r)))
+          .catch(e => fail('react error: ' + e.message));
         break;
       }
 
@@ -556,8 +570,9 @@ async function handleLine(line) {
         const [, jR, msgId, ...rest] = p;
         const jid = normalizeJid(jR);
         if (!jid || !msgId || !rest.length) { fail('usage: /edit <jid> <msgId> <text>'); break; }
-        const r = await _client.editMessage(msgId, jid, rest.join(' '));
-        out('edited  ' + (r && r.id ? r.id : r));
+        _client.editMessage(msgId, jid, rest.join(' '))
+          .then(r => out('edited  ' + (r && r.id ? r.id : r)))
+          .catch(e => fail('edit error: ' + e.message));
         break;
       }
 
@@ -566,8 +581,9 @@ async function handleLine(line) {
         const [, jR, msgId, scope] = p;
         const jid = normalizeJid(jR);
         if (!jid || !msgId) { fail('usage: /delete <jid> <msgId> [all]'); break; }
-        await _client.deleteMessage(msgId, jid, true, scope === 'all');
-        out('deleted  ' + (scope === 'all' ? 'for everyone' : 'for me'));
+        _client.deleteMessage(msgId, jid, true, scope === 'all')
+          .then(() => out('deleted  ' + (scope === 'all' ? 'for everyone' : 'for me')))
+          .catch(e => fail('delete error: ' + e.message));
         break;
       }
 
@@ -1142,7 +1158,7 @@ async function handleLine(line) {
           } else if (!store.codePending && !store.registered) {
             // Only check /exist when keys were never used to request a code.
             out('checking device keys...');
-            const waVersion = await fetchIosVersion();
+            const waVersion = await fetchWaVersion(getDeviceConfig());
             const fresh = await assertRegistrationKeys(store, waVersion);
             if (!fresh) {
               out('  device keys already registered — generating new keys...');
@@ -1468,7 +1484,7 @@ async function main() {
         // keys are already taken (e.g. leftover from a previous failed attempt).
         // FIX: only 1 /exist call now (was 2), and skipped entirely when codePending.
         out('checking device keys...');
-        const waVersion = await fetchIosVersion();
+        const waVersion = await fetchWaVersion(getDeviceConfig());
         const fresh = await assertRegistrationKeys(store, waVersion);
         if (!fresh) {
           out('  device keys already registered — generating new keys...');

package/index.js

@@ -1,7 +1,9 @@
 'use strict';
 
-const { WhalibmobClient, checkNumberStatus, fetchIosVersion, assertRegistrationKeys } = require('./lib/Client');
-const { createNewStore, saveStore, loadStore, toSixParts, fromSixParts } = require('./lib/Store');
+const { WhalibmobClient, checkNumberStatus, fetchIosVersion, fetchWaVersion, assertRegistrationKeys } = require('./lib/Client');
+const { getDeviceConfig } = require('./lib/DeviceConfig');
+const { fetchAndroidVersion } = require('./lib/Registration');
+const { createNewStore, saveStore, loadStore, toSixParts, fromSixParts, storeToJson, storeFromJson } = require('./lib/Store');
 const { checkIfRegistered, requestSmsCode, verifyCode } = require('./lib/Registration');
 const { SignalProtocol } = require('./lib/signal/SignalProtocol');
 const { SignalStore } = require('./lib/signal/SignalStore');
@@ -13,25 +15,37 @@ const { MessageSender, makeJid, generateMessageId } = require('./lib/messages/Me
 module.exports = {
   WhalibmobClient,
   checkNumberStatus,
-  fetchIosVersion,
+  checkIfRegistered,
+  requestSmsCode,
+  verifyCode,
   assertRegistrationKeys,
+  // Version fetch — use fetchWaVersion for device-aware (iOS or Android) fetching.
+  // fetchIosVersion is kept for backward compatibility.
+  fetchWaVersion,
+  fetchIosVersion,
+  fetchAndroidVersion,
+  // Device config — reads WA_OS / WA_DEVICE / WA_DEVICE_* from process.env
+  getDeviceConfig,
+  // Store helpers
   createNewStore,
   saveStore,
   loadStore,
+  storeToJson,
+  storeFromJson,
   toSixParts,
   fromSixParts,
-  checkIfRegistered,
-  requestSmsCode,
-  verifyCode,
+  // Signal / encryption internals
   SignalProtocol,
   SignalStore,
   SenderKeyStore,
   SenderKeyCrypto,
   DeviceManager,
+  // Media
   encryptMedia,
   decryptMedia,
   uploadMedia,
   downloadMedia,
+  // Message helpers
   MessageSender,
   makeJid,
   generateMessageId