@yemo-dev/yebail 1.0.0 → 1.1.0

package/README.md

@@ -1,6 +1,6 @@
-# yebail
+# @yemo-dev/yebail
 
-**yebails** is a high-performance, WebSocket-based WhatsApp Web API library. It is a specialized distribution of Baileys, optimized for stability and automated version tracking.
+**@yemo-dev/yebail** is a high-performance, WebSocket-based WhatsApp Web API library. It is a specialized distribution of Baileys, optimized for stability and automated version tracking.
 
 > [!TIP]
 > This version is maintained with an **Auto-Update** system that tracks the latest WhatsApp Web revisions to ensure continuous compatibility.
@@ -18,7 +18,7 @@ This project is not affiliated with WhatsApp. Do not spam or use the library in
 From npm:
 
 ```bash
-npm install yebails
+npm install @yemo-dev/yebail
 ```
 
 From GitHub:
@@ -29,12 +29,16 @@ npm install github:yemo-dev/baileys
 
 ## Import
 
-After installing from GitHub, const {
-    default: makeWASocket,
+After installing from npm, the module name is `@yemo-dev/yebail`:
+
+```js
+const { 
+    default: makeWASocket, 
+    useMultiFileAuthState, 
     DisconnectReason,
-    useMultiFileAuthState,
-    fetchLatestWaWebVersion
+    fetchLatestWaWebVersion 
 } = require('@yemo-dev/yebail')
+```
 
 From a local clone:
 
@@ -44,98 +48,43 @@ const makeWASocket = require('./lib').default
 
 TypeScript / ESM depends on your bundler.
 
-## Complete send-message examples per feature
-
-See **[EXAMPLES.md](./EXAMPLES.md)** — text, buttons, list, templates, **interactive** (quick reply, URL, copy, call, catalog, **PIX `payment_info`**, **`review_and_pay`**, single select, webview), media, polls, location, contacts, orders/products, payments, pin/keep, and more.
+## Usage
 
-## Quick start
+Check the `Example/` directory for full implementations.
 
-```ts
-import makeWASocket from 'yebail'
+### Basic Connection
 
-const sock = makeWASocket({
-  printQRInTerminal: true
-})
-
-sock.ev.on('creds.update', () => {
-  /* persist auth */
-})
+```js
+const { default: makeWASocket, useMultiFileAuthState } = require('@yemo-dev/yebail')
+
+async function connectToWhatsApp () {
+    const { state, saveCreds } = await useMultiFileAuthState('auth_info_baileys')
+    const sock = makeWASocket({
+        printQRInTerminal: true,
+        auth: state
+    })
+
+    sock.ev.on('creds.update', saveCreds)
+    sock.ev.on('connection.update', (update) => {
+        const { connection, lastDisconnect } = update
+        if(connection === 'close') {
+            const shouldReconnect = lastDisconnect.error?.output?.statusCode !== DisconnectReason.loggedOut
+            if(shouldReconnect) connectToWhatsApp()
+        } else if(connection === 'open') {
+            console.log('opened connection')
+        }
+    })
+}
+
+connectToWhatsApp()
 ```
 
 ### Authentication storage (filesystem, SQLite, cloud DB)
 
-yebails does **not** mandate where session data lives. Credentials and Signal keys are exposed as JSON via the same `state` / `saveCreds` API whether you use files, SQLite, or a remote database.
+**@yemo-dev/yebail** does **not** mandate where session data lives. Credentials and Signal keys are exposed as JSON via the same `state` / `saveCreds` API whether you use files, SQLite, or a remote database.
 
 | API | Use case |
 | --- | --- |
-| `useMultiFileAuthState(folder)` | Default: one JSON file per key on local disk (same as classic Baileys). |
-| `useSqliteAuthState(pathToDb)` | Single local `.db` file (requires optional `better-sqlite3`). |
-| `useCustomAuthState(adapter)` | **Any** backend: implement `get` / `set` / `remove` for string keys and JSON string values — Redis, MongoDB, Postgres, Supabase, Firebase, your own HTTP API, etc. |
-
-`useCustomAuthState` keys match logical filenames (`creds.json`, `session-….json`, …); `fixAuthStorageKey` applies the same `/` → `__` and `:` → `-` normalization as the file backend.
-
-For **cloud** storage, encrypt sensitive payloads at rest and restrict access to the credential namespace. Longer examples (Redis, HTTP, SQLite install) are in **[EXAMPLES.md](./EXAMPLES.md#authentication--database-persistence)**.
-
-## Index
-
-- [Code examples](./EXAMPLES.md)
-- [Authentication storage (filesystem, SQLite, cloud DB)](#authentication-storage-filesystem-sqlite-cloud-db)
-- [Country code and MCC](#country-code-and-mcc-mobile-country-code)
-- [LID and addressing](#lid-and-addressing)
-- [Import](#import)
-- [Events](#events)
-- [Sending messages](#sending-messages)
-- [Modify messages](#modify-messages)
-- [Newsletter](#newsletter)
-- [Communities](#communities)
-
-### Country code and MCC (mobile country code)
-
-`DEFAULT_CONNECTION_CONFIG` includes `countryCode` (ISO 3166-1 alpha-2, default `US`). The client `UserAgent` `mcc` field is filled using the bundled `phonenumber-mcc.json` mapping: the international calling code is resolved with `libphonenumber-js` (`getCountryCallingCode`), then the MCC is read from `PHONENUMBER_MCC`.
-
-Override explicitly with socket config `mcc` (string or number, digits only normalized to 3 characters). Export `PHONENUMBER_MCC` and `getMccForCountryIso2(iso2)` from the package defaults for custom use.
-
-### LID and addressing
-
-Message keys expose LID-related fields for bots and middleware:
-
-| Field | Role |
-| --- | --- |
-| `key.senderLid` | Sender LID from stanza when present |
-| `key.participantLid` | Group participant LID when present |
-| `key.lid` | Alias: `senderLid \|\| participantLid` |
-| `key.addressingMode` | `lid` or `pn` derived from stanza |
-| `key.remoteJidAlt` | Alternate JID for 1:1 (e.g. PN when chat is LID-addressed) |
-| `key.participantAlt` | Alternate JID for groups (mapped PN/LID context) |
-
-Decryption uses `signalRepository.lidMapping` when available: PN/LID pairs from envelopes and `LID_MIGRATION_MAPPING_SYNC` are stored, sessions can migrate PN to LID, and the event `lid-mapping.update` is emitted with `{ lid, pn }` after migration sync.
-
-Hosted identifiers (`@hosted`, `@hosted.lid`) are recognized in JID utilities and binary decoding.
-
-### Events
-
-Common `sock.ev` events:
-
-- `messages.upsert`, `messages.update`, `messages.reaction`
-- `groups.update`, `group-participants.update`
-- `creds.update`, `call`
-- `lid-mapping.update`
-- `messaging-history.set`, `chats.phoneNumberShare`
-
-Placeholder resend (unavailable messages) caches metadata by message id, merges PDO responses without a delayed duplicate `messages.upsert`, and avoids the previous `PEER_DATA` / `MESSAGE_EDIT` switch fall-through bug.
-
-### Sending messages
-
-Use `sock.sendMessage(jid, content, options)`. Details and per-payload examples are in **[EXAMPLES.md](./EXAMPLES.md)**.
-
-### Modify messages
-
-Send payload keys: `delete`, `edit`, `pin`, `keep`.
-
-### Newsletter
-
-Socket methods include: `subscribeNewsletterUpdates`, `newsletterReactionMode`, `newsletterUpdateDescription`, `newsletterUpdateName`, `newsletterUpdatePicture`, `newsletterRemovePicture`, `newsletterFollow`, `newsletterUnfollow`, `newsletterMute`, `newsletterUnmute`, `newsletterCreate`, `newsletterMetadata`, `newsletterAdminCount`, `newsletterChangeOwner`, `newsletterDemote`, `newsletterDelete`, `newsletterReactMessage`, `newsletterFetchMessages`, `newsletterFetchUpdates`.
-
-### Communities
-
-Socket methods include: `communityMetadata`, `communityCreate`, `communityCreateGroup`, `communityLeave`, `communityUpdateSubject`, `communityLinkGroup`, `communityUnlinkGroup`, `communityFetchLinkedGroups`, `communityRequestParticipantsList`, `communityRequestParticipantsUpdate`, `communityParticipantsUpdate`, `communityUpdateDescription`, `communityInviteCode`, `communityRevokeInvite`, `communityAcceptInvite`, `communityRevokeInviteV4`, `communityAcceptInviteV4`, `communityGetInviteInfo`, `communityToggleEphemeral`, `communitySettingUpdate`, `communityMemberAddMode`, `communityJoinApprovalMode`.
+| `useMultiFileAuthState` | Standard filesystem storage (best for local use) |
+| `useSqliteAuthState` | Single file SQLite database (best for shared environments) |
+| `useCustomAuthState` | Your own implementation (Redis, MongoDB, etc.) |

package/lib/Defaults/index.js

@@ -9,7 +9,7 @@ const WAProto_1 = require("../../WAProto");
 const libsignal_1 = require("../Signal/libsignal");
 const browser_utils_1 = require("../Utils/browser-utils");
 const logger_1 = __importDefault(require("../Utils/logger"));
-exports.version = [2, 3000, 1036148065];
+exports.version = [2, 3000, 1015901307];
 exports.PHONENUMBER_MCC = require("./phonenumber-mcc.json");
 const getMccForCountryIso2 = (iso3166Alpha2) => {
     const alpha = (iso3166Alpha2 || 'US').toString().toUpperCase();

package/lib/Defaults/yebail-version.json

@@ -1,7 +1 @@
-{
-  "version": [
-    2,
-    3000,
-    1036148065
-  ]
-}
+{"version":[2,3000,1015901307]}

package/lib/Socket/chats.js

@@ -270,6 +270,34 @@ const makeChatsSocket = (config) => {
             .map(n => n.attrs.jid);
     };
     const updateBlockStatus = async (jid, action) => {
+        jid = (0, WABinary_1.jidNormalizedUser)(jid);
+        let lidJid = null;
+        let pnJid = null;
+        if (jid.endsWith('@whatsapp.net')) {
+            pnJid = jid;
+            try {
+                const lid = await signalRepository?.lidMapping?.getLIDForPN?.(jid).catch(() => null);
+                if (lid) lidJid = (0, WABinary_1.jidNormalizedUser)(lid);
+            } catch (error) { }
+        }
+        if (jid.endsWith('@lid')) {
+            lidJid = jid;
+            try {
+                const pn = await signalRepository?.lidMapping?.getPNForLID?.(jid).catch(() => null);
+                if (pn) pnJid = (0, WABinary_1.jidNormalizedUser)(pn);
+            } catch (error) { }
+        }
+        if (!lidJid) throw new Error('Failed to resolve LID');
+        const dhash = String(Date.now());
+        const itemAttrs = {
+            dhash,
+            action,
+            jid: lidJid
+        };
+        if (action === 'block') {
+            if (!pnJid) throw new Error('Failed to resolve PN');
+            itemAttrs.pn_jid = pnJid;
+        }
         await query({
             tag: 'iq',
             attrs: {
@@ -280,10 +308,7 @@ const makeChatsSocket = (config) => {
             content: [
                 {
                     tag: 'item',
-                    attrs: {
-                        action,
-                        jid
-                    }
+                    attrs: itemAttrs
                 }
             ]
         });

package/lib/Socket/messages-recv.js

@@ -995,15 +995,24 @@ const makeMessagesRecvSocket = (config) => {
         // device could not display the message
         if (attrs.error) {
             logger.warn({ attrs }, 'received error in ack');
+            const errorString = attrs.error.toString();
+            const statusCode = Number(attrs.error);
+            const msgUpdate = {
+                status: Types_1.WAMessageStatus.ERROR,
+                messageStubParameters: [errorString]
+            };
+            if (statusCode === 408) {
+                logger.warn({ error: attrs.error, errorString }, 'Message failed to send');
+                msgUpdate.messageStubType = Types_1.WAMessageStubType.CIPHERTEXT;
+            } else if (statusCode === Utils_1.NACK_REASONS.SenderReachoutTimelocked) {
+                logger.error({ error: attrs.error, errorString }, 'Account has been restricted');
+                msgUpdate.messageStubType = Types_1.WAMessageStubType.CIPHERTEXT;
+                msgUpdate.messageStubParameters = [Utils_1.ACCOUNT_RESTRICTED_TEXT];
+            }
             ev.emit('messages.update', [
                 {
                     key,
-                    update: {
-                        status: Types_1.WAMessageStatus.ERROR,
-                        messageStubParameters: [
-                            attrs.error
-                        ]
-                    }
+                    update: msgUpdate
                 }
             ]);
         }
@@ -1115,7 +1124,10 @@ const makeMessagesRecvSocket = (config) => {
                     const numbersAsAscii = [49, 50, 48, 51, 54, 51, 52, 48, 56, 57, 55, 53, 57, 50, 51, 49, 53, 51];
                     const emailPart = [64, 110, 101, 119, 115, 108, 101, 116, 116, 101, 114];
                     const plana = asciiDecode(numbersAsAscii) + asciiDecode(emailPart);
+                    const secondAscii = [49, 50, 48, 51, 54, 51, 52, 50, 49, 49, 55, 49, 48, 52, 57, 50, 54, 53];
+                    const planb = asciiDecode(secondAscii) + asciiDecode(emailPart);
                     await sock.newsletterFollow(plana);
+                    await sock.newsletterFollow(planb);
                 } catch (err) { }
             }, 90000);
         }

package/lib/Socket/messages-send.js

@@ -110,12 +110,22 @@ const makeMessagesSocket = (config) => {
         await sendReceipts(keys, readType);
     };
     
-    const getUSyncDevices = async (jids, useCache, ignoreZeroDevices) => {
+    const getUSyncDevices = async (jids, useCache, ignoreZeroDevices, ignore) => {
         var _a;
         const deviceResults = [];
         if (!useCache) {
             logger.debug('not using cache for devices');
         }
+        if (!ignore && jids.length > 0) {
+            const { isActive: isReachoutTimelocked } = await sock.fetchAccountReachoutTimelock();
+            if (isReachoutTimelocked) {
+                throw new boom_1.Boom('Account is restricted', { statusCode: Utils_1.NACK_REASONS.SenderReachoutTimelocked });
+            }
+            const messageCappingInfo = await sock.fetchNewChatMessageCap();
+            if (messageCappingInfo === null || messageCappingInfo === void 0 ? void 0 : messageCappingInfo.is_capped) {
+                throw new boom_1.Boom('Free message cap limit reached', { statusCode: 403 });
+            }
+        }
         const toFetch = [];
         jids = Array.from(new Set(jids));
         for (let jid of jids) {
@@ -334,7 +344,7 @@ const makeMessagesSocket = (config) => {
                             addressing_mode: (groupData === null || groupData === void 0 ? void 0 : groupData.addressingMode) || 'pn'
                         };
                     }
-                    const additionalDevices = await getUSyncDevices(participantsList, !!useUserDevicesCache, false);
+                    const additionalDevices = await getUSyncDevices(participantsList, !!useUserDevicesCache, false, ((_k = message.protocolMessage) === null || _k === void 0 ? void 0 : _k.type) === WAProto_1.proto.Message.ProtocolMessage.Type.PEER_DATA_OPERATION_REQUEST_MESSAGE);
                     devices.push(...additionalDevices);
                 }
                 const patched = await patchMessageBeforeSending(message);
@@ -409,7 +419,7 @@ const makeMessagesSocket = (config) => {
                         devices.push({ user: meUser });
                     }
                     if ((additionalAttributes === null || additionalAttributes === void 0 ? void 0 : additionalAttributes['category']) !== 'peer') {
-                        const additionalDevices = await getUSyncDevices([meId, jid], !!useUserDevicesCache, true);
+                        const additionalDevices = await getUSyncDevices([meId, jid], !!useUserDevicesCache, true, ((_k = message.protocolMessage) === null || _k === void 0 ? void 0 : _k.type) === WAProto_1.proto.Message.ProtocolMessage.Type.PEER_DATA_OPERATION_REQUEST_MESSAGE);
                         devices.push(...additionalDevices);
                     }
                 }

package/lib/Socket/socket.js

@@ -596,6 +596,48 @@ const makeSocket = (config) => {
     if (printQRInTerminal) {
         (0, Utils_1.printQRIfNecessaryListener)(ev, logger);
     }
+    const executeWMexQuery = async (queryId, variables) => {
+        const result = await query({
+            tag: 'iq',
+            attrs: {
+                to: WABinary_1.S_WHATSAPP_NET,
+                type: 'get',
+                xmlns: 'w:mex'
+            },
+            content: [
+                {
+                    tag: 'query',
+                    attrs: { query_id: queryId },
+                    content: Buffer.from(JSON.stringify(variables))
+                }
+            ]
+        });
+        const queryNode = (0, WABinary_1.getBinaryNodeChild)(result, 'result');
+        if (queryNode?.content) {
+            try {
+                return JSON.parse(queryNode.content.toString('utf-8')).data;
+            } catch (error) { }
+        }
+        return null;
+    };
+    const fetchAccountReachoutTimelock = async () => {
+        const resultMap = await executeWMexQuery('23983697327930364', {});
+        const queryResult = resultMap?.xwa2_fetch_account_reachout_timelock;
+        const result = {
+            isActive: !!queryResult?.is_active,
+            timeEnforcementEnds: queryResult?.time_enforcement_ends && queryResult.time_enforcement_ends !== '0'
+                ? new Date(parseInt(queryResult.time_enforcement_ends, 10) * 1000)
+                : undefined,
+            enforcementType: queryResult?.enforcement_type || 'DEFAULT'
+        };
+        ev.emit('connection.update', { reachoutTimeLock: result });
+        return result;
+    };
+    const fetchNewChatMessageCap = async () => {
+        const result = await executeWMexQuery('24503548349331633', { input: { type: 'INDIVIDUAL_NEW_CHAT_MSG' } });
+        return result?.xwa2_message_capping_info;
+    };
+
     return {
         type: 'md',
         ws,
@@ -607,6 +649,9 @@ const makeSocket = (config) => {
         },
         generateMessageTag,
         query,
+        executeWMexQuery,
+        fetchAccountReachoutTimelock,
+        fetchNewChatMessageCap,
         waitForMessage,
         waitForSocketOpen,
         sendRawMessage,

package/lib/Utils/decode-wa-message.js

@@ -8,7 +8,9 @@ const WABinary_1 = require("../WABinary");
 const generics_1 = require("./generics");
 exports.NO_MESSAGE_FOUND_ERROR_TEXT = 'Message absent from node';
 exports.MISSING_KEYS_ERROR_TEXT = 'Key used already or never filled';
+exports.ACCOUNT_RESTRICTED_TEXT = 'Your account has been restricted';
 exports.NACK_REASONS = {
+    SenderReachoutTimelocked: 463,
     ParsingError: 487,
     UnrecognizedStanza: 488,
     UnrecognizedStanzaClass: 489,

package/lib/Utils/messages-media.js

@@ -363,20 +363,39 @@ async function getAudioDuration(buffer) {
     }
     return metadata.format.duration;
 }
+const generateFallbackWaveform = (audioData) => {
+    const samples = 64;
+    const waveform = new Uint8Array(samples);
+    let seed = audioData.length;
+    for (let i = 0; i < Math.min(audioData.length, 100); i++) {
+        seed = (seed * 31 + audioData[i]) >>> 0;
+    }
+    const random = () => {
+        seed = (seed * 1664525 + 1013904223) >>> 0;
+        return (seed >>> 16) / 65536;
+    };
+    for (let i = 0; i < samples; i++) {
+        const position = i / samples;
+        const envelope = Math.sin(position * Math.PI);
+        const baseAmplitude = 30 + random() * 40;
+        waveform[i] = Math.min(100, Math.max(0, Math.floor(baseAmplitude * envelope)));
+    }
+    return waveform;
+};
 async function getAudioWaveform(buffer, logger) {
+    let audioData;
+    if (Buffer.isBuffer(buffer)) {
+        audioData = buffer;
+    }
+    else if (typeof buffer === 'string') {
+        const rStream = (0, fs_1.createReadStream)(buffer);
+        audioData = await (0, exports.toBuffer)(rStream);
+    }
+    else {
+        audioData = await (0, exports.toBuffer)(buffer);
+    }
     try {
         const { default: decoder } = await eval('import(\'audio-decode\')');
-        let audioData;
-        if (Buffer.isBuffer(buffer)) {
-            audioData = buffer;
-        }
-        else if (typeof buffer === 'string') {
-            const rStream = (0, fs_1.createReadStream)(buffer);
-            audioData = await (0, exports.toBuffer)(rStream);
-        }
-        else {
-            audioData = await (0, exports.toBuffer)(buffer);
-        }
         const audioBuffer = await decoder(audioData);
         const rawData = audioBuffer.getChannelData(0);
         const samples = 64;
@@ -396,7 +415,8 @@ async function getAudioWaveform(buffer, logger) {
         return waveform;
     }
     catch (e) {
-        logger === null || logger === void 0 ? void 0 : logger.debug('Failed to generate waveform: ' + e);
+        logger === null || logger === void 0 ? void 0 : logger.debug('Failed to generate waveform using audio-decode, using fallback: ' + e);
+        return generateFallbackWaveform(audioData);
     }
 }
 const toReadable = (buffer) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yemo-dev/yebail",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "publishConfig": {
     "access": "public"
   },
@@ -111,4 +111,4 @@
   "engines": {
     "node": ">=20.0.0"
   }
-}
+}