npm - ishumdz-bail - Versions diffs - 1.0.8 → 1.0.10 - Mend

ishumdz-bail 1.0.8 → 1.0.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2) hide show

package/README.md +259 -873
package/package.json +1 -1

package/README.md CHANGED Viewed

@@ -1,992 +1,378 @@
 <div align="center">
-<img src="https://capsule-render.vercel.app/api?type=waving&height=220&color=0:ff6b6b,40:f06595,100:845ef7&text=ishumdz-bail&fontAlignY=40&fontSize=44&fontColor=ffffff&desc=Stable%20WhatsApp%20Web%20API%20Fork%20for%20Production%20Bots&descAlignY=60&descSize=16" alt="Header Banner" />
-<br/>
+```
+╔═══════════════════════════════════════════════════════════════════════════╗
+║                         📱 MAIN FEATURES                                 ║
+╠═══════════════════════════════════════════════════════════════════════════╣
+║                                                                           ║
+║  ┌─────────────────────────────────────────────────────────────────────┐  ║
+║  │ 🎮 GAMES            │ 📞 VOIP CALLER      │ ⚡ PRO METHODS         │  ║
+║  │ ├─ Blackjack         │ ├─ Auto Answer       │ ├─ sendPoll            │  ║
+║  │ ├─ Slots             │ ├─ Audio Playback    │ ├─ sendPollVote        │  ║
+║  │ ├─ Dice              │ └─ VoipClient        │ ├─ editMessage         │  ║
+║  │ ├─ Coin Flip         │                     │ ├─ deleteMessage        │  ║
+║  │ ├─ Roulette          │ 📊 POLLS            │ ├─ pinMessage          │  ║
+║  │ ├─ Mines             │ ├─ Create Poll       │ ├─ starMessage         │  ║
+║  │ ├─ Trivia            │ ├─ Vote Poll         │ ├─ reactMessage        │  ║
+║  │ └─ RPS               │ └─ Get Results       │ ├─ sendPresence        │  ║
+║  └─────────────────────────────────────────────────────────────────────┘  ║
+║                                                                           ║
+║  ┌─────────────────────────────────────────────────────────────────────┐  ║
+║  │ 📢 NEWSLETTER       │ 🟢 STATUS            │ 💬 CHAT               │  ║
+║  │ ├─ channelVote       │ ├─ sendText           │ ├─ editMessage        │  ║
+║  │ ├─ newsletterReact   │ ├─ sendMedia          │ ├─ deleteMessage      │  ║
+║  │ ├─ getMessages       │ ├─ readStatus         │ ├─ pinMessage         │  ║
+║  │ ├─ searchChannels    │ └─ reactStatus        │ ├─ unpinMessage       │  ║
+║  │ └─ listChannels      │                     │ ├─ starMessage        │  ║
+║  └─────────────────────────────────────────────────────────────────────┘  ║
+║                                                                           ║
+║  ┌─────────────────────────────────────────────────────────────────────┐  ║
+║  │ 👥 GROUPS            │ 👤 PROFILE           │ 📰 MEDIA             │  ║
+║  │ ├─ Get Invite Info   │ ├─ checkNumber        │ ├─ Newsletter Paths   │  ║
+║  │ ├─ Join via Invite   │ ├─ setBio             │ ├─ Image Upload       │  ║
+║  │ ├─ Set Announcement  │ ├─ updateName         │ ├─ Video Upload       │  ║
+║  │ ├─ Set Locked        │ ├─ setProfilePic      │ ├─ Audio Upload       │  ║
+║  │ ├─ Request List      │ ├─ removeProfilePic   │ ├─ Document Upload    │  ║
+║  │ ├─ Approve           │ └─ rejectCall         │ └─ Sticker Upload     │  ║
+║  │ └─ Reject            │                     │                     │  ║
+║  └─────────────────────────────────────────────────────────────────────┘  ║
+║                                                                           ║
+║  ✅ No Browser Required  ✅ Multi-Device  ✅ WebSocket Based             ║
+║  ✅ Active Maintenance   ✅ MIT License   ✅ Full API Coverage           ║
+║                                                                           ║
+╚═══════════════════════════════════════════════════════════════════════════╝
+```
-<!-- Rounded + border image -->
-<a href="https://ishanx-pro.site.je">
-  <kbd>
-    <img src="https://i.postimg.cc/9Q6q2Pv6/IMG-20260925-WA4965.jpg" alt="WhatsApp Baileys 2026" width="720" />
-  </kbd>
-</a>
+<br/>
-<br/><br/>
+```
+     ██╗  ██╗██████╗  █████╗ ███████╗████████╗
+     ██║  ██║██╔══██╗██╔══██╗██╔════╝╚══██╔══╝
+     ███████║██████╔╝███████║███████╗   ██║
+     ██╔══██║██╔══██╗██╔══██║╚════██║   ██║
+     ██║  ██║██████╔╝██║  ██║███████║   ██║
+     ╚═╝  ╚═╝╚═════╝ ╚═╝  ╚═╝╚══════╝   ╚═╝
+              WhatsApp Web API Fork
+                    By Lovely ❤️
+```
-# 🧑‍💻 ishumdz-bail
+<img src="https://i.postimg.cc/9Q6q2Pv6/IMG-20260925-WA4965.jpg" alt="ishumdz-bail" width="700" />
-<p>
-  <img src="https://img.shields.io/badge/Node.js-%3E%3D20-339933?style=for-the-badge&logo=nodedotjs&logoColor=white" />
-  <img src="https://img.shields.io/badge/WhatsApp-25D366?style=for-the-badge&logo=whatsapp&logoColor=white" />
-  <img src="https://img.shields.io/badge/WebSocket-010101?style=for-the-badge&logo=socketdotio&logoColor=white" />
-  <img src="https://img.shields.io/badge/Open%20Source-FF4500?style=for-the-badge&logo=github&logoColor=white" />
-  <img src="https://img.shields.io/badge/license-MIT-blue?style=for-the-badge" />
-</p>
+<br/>
-<p>
-  <img src="https://img.shields.io/npm/v/ishumdz-bail?style=flat-square&color=25D366&label=npm" />
-  <img src="https://img.shields.io/badge/maintained%20by-Lovely-black?style=flat-square" />
-</p>
+[![npm](https://img.shields.io/badge/npm-ishumdz--bail-25D366?style=for-the-badge&logo=npm&logoColor=white)](https://www.npmjs.com/package/ishumdz-bail)
+[![GitHub](https://img.shields.io/badge/GitHub-lovelyofficial/ishumdz--bail-FF4500?style=for-the-badge&logo=github&logoColor=white)](https://github.com/lovelyofficial/ishumdz-bail)
+[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D20-339933?style=for-the-badge&logo=nodedotjs&logoColor=white)](https://nodejs.org)
+[![License](https://img.shields.io/badge/License-MIT-blue?style=for-the-badge)](LICENSE)
+[![WhatsApp](https://img.shields.io/badge/WhatsApp-25D366?style=for-the-badge&logo=whatsapp&logoColor=white)](https://whatsapp.com)
 **Open-source WhatsApp automation library — no browser required.**
 Built on WebSocket for speed, stability, and full multi-device support.
-<br/>
-[Installation](#-getting-started) • [Features](#-main-features) • [Stability](#-stability--disconnect-handling) • [Website](https://ishanx-pro.site.je) • [WhatsApp Channel](https://shyracore.indevs.in)
 </div>
 ---
-## ✨ What is ishumdz-bail?
-**ishumdz-bail** (`ishumdz-bail`) is a powerful, open-source WhatsApp Web library built on top of the Baileys protocol stack — extended with features not found in any other public fork. It connects directly to WhatsApp's multi-device WebSocket protocol. No Selenium, no Puppeteer, no browser overhead.
-> ⚡ **Node.js ≥ 20 required.**
----
-## 🚀 Getting Started
+## 🚀 Installation
 ```bash
 npm install ishumdz-bail
 ```
-```javascript
-import { makeWASocket, useMultiFileAuthState } from 'ishumdz-bail'
-const { state, saveCreds } = await useMultiFileAuthState('auth_info')
-const sock = makeWASocket({
-    auth: state,
-    syncFullHistory: false,  // skip history sync — bot works immediately
-    aiLabel: true,           // stamp messages with AI bot marker (default: true)
-})
-sock.ev.on('creds.update', saveCreds)
-```
----
-## 🧩 Main Features
-| Feature | Description |
-|---|---|
-| 💬 **Rich Response (GenAI Bubble)** | Send Meta AI-style messages: markdown, code blocks, tables, LaTeX, maps, inline images, HTML — rendered natively as GenAI bubble in WA client |
-| 🚫 **4-Factor Ban Checker** | Detect ban status via 4 independent signals: live registry, public send-page, identity-key probe, device-count signature |
-| 🆔 **Username Socket (w:mex)** | Full WA username API: check availability, set, delete, pin, find by username, fetch recommendations — via WhatsApp's internal Pando/MEX GraphQL protocol |
-| 🏘️ **Communities Socket** | Full community management: create, link/unlink groups, manage participants, invite codes, ephemeral toggle, approval mode |
-| 🔕 **noSelfSync** | Skip syncing outgoing messages to your own other devices — reduces noise and bandwidth. Includes silent-drop guard (throws 421 instead of pretending the send succeeded) |
-| ⚙️ **Rust-powered Crypto** | `md5`, `hkdf`, LT-Hash anti-tampering offloaded to `whatsapp-rust-bridge` native module for raw speed |
-| 🗂️ **LID Mapping Store** | Persistent LID ↔ phone-number bi-directional cache with LRU eviction and in-flight dedup — prevents duplicate USync lookups |
-| 🔐 **Pre-Key Manager** | Concurrency-safe Signal pre-key operations via per-key-type PQueue — no race conditions on key updates/deletions |
-| 🔄 **Classify Disconnect** | Maps every WA disconnect code to `{ category, shouldReconnect, backoffMs }` — properly handles code 515 (restartRequired) as recoverable, not fatal |
-| ⏱️ **Rate Limiter** | Anti-spam pacing calculator: enforces per-minute/hour/day caps, burst allowance, new-chat delays, identical-message dedup |
-| 🖼️ **Album Message** | Send multiple images/videos as a single WA album/grid, with per-item or top-level caption and `gifPlayback` support |
-| 🤖 **AI Label Config** | `aiLabel: true/false` in socket config — controls whether outgoing messages carry the `biz_bot` attribute that WA uses to render the AI icon |
-| 🔎 **USync Username Protocol** | Username resolution baked into USync queries — resolve WA usernames alongside contacts in a single round-trip |
-| 📥 **Offline Node Processor** | Batch-processes pending stanzas received while offline, preventing message loss on reconnect |
-| 🔑 **Identity Change Handler** | Dedicated handler for Signal identity key changes — prevents session corruption when a contact re-registers |
-| 📣 **Newsletter/Channel Media Upload** | Full support for uploading images, videos, audio, stickers to channels using correct `/newsletter/newsletter-*` paths |
-| 😀 **Newsletter Reactions** | React to channel messages with emojis, track votes, and manage newsletter engagement |
-| 📊 **Poll Voting** | Create polls, track encrypted votes, display results, and support multiple selection polls |
-| 🎮 **Built-in Games** | 8 games: Blackjack, Slots, Dice, Coin Flip, Roulette, Mines, Trivia, Rock Paper Scissors |
-| 📞 **VoIP Caller** | Answer incoming calls with audio playback using WASM VoIP engine |
-| ⚡ **Pro Methods** | 34 convenience methods: Polls, Newsletter, Status, Chat, Groups, Profile |
----
-## 📞 VoIP Caller (Call Answer + Audio)
-Answer incoming WhatsApp calls and play audio automatically:
-```javascript
-const { makeWASocket, enableCallAutoAnswer } = require('ishumdz-bail');
-const sock = makeWASocket({ auth: state });
-// Enable auto-answer with audio playback
-sock.enableCallAutoAnswer({
-    audio: './welcome.wav',      // Audio file to play (MP3/WAV)
-    autoAnswer: true,            // Auto-answer incoming calls
-    answerDelayMs: 200,          // Delay before answering
-    durationMs: 60000,           // Max call duration (60s)
-    loop: true,                  // Loop audio
-    onCall: (call) => {},        // Callback on incoming call
-    onAnswer: (call) => {},      // Callback when answered
-    onEnd: (call, reason) => {}  // Callback when ended
-});
-```
-**Manual call handling:**
-```javascript
-sock.ev.on('call', async ([call]) => {
-    if (call.status === 'offer') {
-        // Reject call
-        await sock.rejectCall(call.id, call.from);
-        // Or accept with VoIP client
-        const voipClient = getActiveVoipClient();
-        if (voipClient) {
-            const activeCall = voipClient.activeCall;
-            activeCall.accept('./audio.wav');
-        }
-    }
-});
-```
 ---
-## ⚡ Pro Methods
-34 convenience methods attached to socket via `attachProMethods()`:
+## ⚡ Quick Start
 ```javascript
-const { makeWASocket, attachProMethods } = require('ishumdz-bail');
+const { makeWASocket, useMultiFileAuthState, attachProMethods } = require('ishumdz-bail');
-const sock = makeWASocket({ auth: state });
-attachProMethods(sock); // Attach all Pro methods
-```
+const { state, saveCreds } = await useMultiFileAuthState('auth_info');
-### 📊 Polls Pro
-```javascript
-// Create a poll
-await sock.sendPoll(jid, {
-    name: 'What is your favorite color?',
-    values: ['Red', 'Blue', 'Green', 'Yellow'],
-    selectableCount: 1
+const sock = makeWASocket({
+    auth: state,
+    syncFullHistory: false,
+    aiLabel: true,
 });
-// Vote on a poll
-await sock.sendPollVote(jid, pollMessage, ['Red']);
+attachProMethods(sock);
-// Get poll results
-const votes = sock.getAggregatePollVotes(pollMessage);
-```
-### 📢 Newsletter/Channel Pro
-```javascript
-// Smart channel poll vote (auto-resolves links, IDs)
-await sock.channelVote('https://whatsapp.com/channel/xxx/123', 1);
-// React to channel post
-await sock.newsletterReact(channelJid, serverId, '👍');
-// Get channel messages (decoded)
-const messages = await sock.newsletterGetMessages(channelJid, 50);
-// Search channels
-const results = await sock.newsletterSearch('technology');
-// List followed channels
-const channels = await sock.newsletterList();
-```
-### 🟢 Status/Stories Pro
-```javascript
-// Send text status
-await sock.sendStatusText('Hello World!', {
-    backgroundColor: '#25D366',
-    font: 1
-});
+sock.ev.on('creds.update', saveCreds);
-// Send media status
-await sock.sendStatusMedia('./photo.jpg', {
-    type: 'image',
-    caption: 'My status!'
+sock.ev.on('connection.update', ({ connection }) => {
+    if (connection === 'open') {
+        console.log('✅ Connected!');
+    }
 });
-// React to status
-await sock.reactStatus(statusKey, '❤️');
-```
-### 💬 Chat Pro
-```javascript
-// Edit a message
-await sock.editMessage(jid, messageKey, 'Updated text!');
-// Delete a message
-await sock.deleteMessage(jid, messageKey);
-// Pin a message (24h, 7d, or 30d)
-await sock.pinMessage(jid, messageKey, 86400); // 24 hours
-// Star/unstar a message
-await sock.starMessage(jid, messageKey, true);
-// React to a message
-await sock.reactMessage(jid, messageKey, '😂');
-// Send presence (typing indicator)
-await sock.sendPresence(jid, 'composing');
-// Quick reply with quote
-await sock.reply(jid, 'This is a reply!', quotedMessage);
-```
-### 👥 Groups Pro
-```javascript
-// Get group info from invite link
-const info = await sock.groupGetInviteInfo('https://chat.whatsapp.com/xxx');
-// Join group via invite
-await sock.groupJoinViaInvite('https://chat.whatsapp.com/xxx');
-// Set announcement mode (admin only)
-await sock.groupSetAnnouncement(groupJid, true);
-// Set locked mode (admin only)
-await sock.groupSetLocked(groupJid, true);
-// Manage join requests
-const requests = await sock.groupRequestParticipantsList(groupJid);
-await sock.groupApproveParticipants(groupJid, [participant1, participant2]);
-await sock.groupRejectParticipants(groupJid, [participant3]);
-```
-### 👤 Profile Pro
-```javascript
-// Check if number exists on WhatsApp
-const result = await sock.checkNumber('1234567890');
-console.log(result.exists); // true/false
-// Update bio
-await sock.setBio('Hello, I am a bot!');
-// Update display name
-await sock.updateProfileName('My Bot');
-// Set profile picture
-await sock.setProfilePicture(jid, './avatar.jpg');
-// Remove profile picture
-await sock.removeProfilePicture(jid);
 ```
 ---
-## 🎮 Built-in Games
-8 fun games for your WhatsApp bot:
+## 🎮 Games
 ```javascript
 const { blackjack, slotMachine, diceGame, coinFlip, roulette, rps, trivia, createMines } = require('ishumdz-bail');
-// Blackjack
-const game = blackjack('start', [], [], 100); // Start with 100 bet
-// game.playerHand, game.dealerHand, game.status
+// 🃏 Blackjack
+const bj = blackjack('start', [], [], 100);
+// bj.playerHand, bj.dealerHand, bj.status
-// Slots
+// 🎰 Slots
 const slots = slotMachine(100);
 // slots.reels, slots.payout
-// Dice
-const dice = diceGame(100, 'high'); // Bet on high (7-12)
+// 🎲 Dice
+const dice = diceGame(100, 'high');
 // dice.total, dice.dice1, dice.dice2
-// Coin Flip
+// 🪙 Coin Flip
 const flip = coinFlip(100, 'heads');
 // flip.result, flip.payout
-// Roulette
+// 🎡 Roulette
 const spin = roulette(100, 'red');
-// spin.number, spin.color, spin.payout
+// spin.number, spin.color
-// Rock Paper Scissors
+// ✊ Rock Paper Scissors
 const game = rps('rock');
 // game.playerChoice, game.botChoice, game.result
-// Trivia
-const question = trivia(100);
-// question.question, question.options, question.answer
-// Mines
-const mines = createMines(5, 5, 5); // 5x5 grid, 5 mines
-const tile = revealTile(mines, 0, 0); // Reveal tile at (0,0)
-// tile.safe, tile.mine
-const cashout = cashoutMines(mines, 100); // Cash out
-// cashout.payout
-```
-## 💬 Rich Response (GenAI Bubble)
-Send messages that render as Meta AI-style bubbles inside WhatsApp. Supports multiple primitives in a single message:
-```javascript
-// Markdown text
-await sock.sendMessage(jid, {
-    richResponse: {
-        text: '**Hello** from *ishumdz-bail*',
-        responseId: 'optional-uuid'
-    }
-})
-// Code block
-await sock.sendMessage(jid, {
-    richResponse: {
-        code: 'console.log("hello")',
-        language: 'javascript'
-    }
-})
-// Table
-await sock.sendMessage(jid, {
-    richResponse: {
-        table: {
-            rows: [
-                ['Name', 'Age'],
-                ['Alice', '25'],
-                ['Bob', '30']
-            ]
-        }
-    }
-})
-// HTML (raw HTML rendered in client)
-await sock.sendMessage(jid, {
-    richResponse: {
-        text: 'fallback',
-        html: '<b>bold</b> <a href="https://example.com">link</a>'
-    }
-})
-// LaTeX
-await sock.sendMessage(jid, {
-    richResponse: {
-        latex: 'E = mc^2'
-    }
-})
-// Map / location
-await sock.sendMessage(jid, {
-    richResponse: {
-        map: {
-            latitude: -6.2,
-            longitude: 106.8,
-            zoom: 15,
-            title: 'Jakarta',
-            annotations: []
-        }
-    }
-})
-// Inline image
-await sock.sendMessage(jid, {
-    richResponse: {
-        imageUrl: 'https://example.com/photo.jpg'
-    }
-})
-```
-**Shortcut methods** (all accept `quoted` and `options`):
-```javascript
-await sock.sendTable(jid, 'Title', ['H1','H2'], [['A','B']], quoted)
-await sock.sendList(jid, 'Title', ['item1','item2'], quoted)
-await sock.sendCodeBlock(jid, 'print("hello")', quoted, { language: 'python' })
-await sock.sendLatex(jid, quoted, { latex: 'x^2 + y^2 = z^2' })
-await sock.sendRichMessage(jid, submessages, quoted)
-```
----
-## 🖼️ Album Message
-Send multiple images/videos grouped into a single WA album:
-```javascript
-await sock.sendMessage(jid, {
-    album: [
-        { image: { url: 'https://example.com/a.jpg' } },
-        { image: { url: 'https://example.com/b.jpg' }, caption: 'caption foto kedua' },
-        { video: { url: 'https://example.com/c.mp4' }, gifPlayback: false }
-    ],
-    caption: 'caption ini otomatis ke item pertama'
-})
-```
----
-## 🚫 Ban Checker
-4-factor ban detection against WhatsApp's own servers — no third-party API:
-```javascript
-const result = await sock.checkBanStatus('628123456789')
-// or: sock.checkBanStatus('628123456789@s.whatsapp.net')
-console.log(result)
-// {
-//   status: 'ACTIVE' | 'PROFILE_HIDDEN' | 'LIKELY_ACTIVE' | 'BANNED' | 'OFF_WHATSAPP' | 'UNKNOWN',
-//   emoji: '🟢' | '🟡' | '🔴' | '❓',
-//   confidence: 0..1,
-//   deviceCount: number | null,
-//   registryExists: boolean | null,
-//   pageVisible: boolean | null,
-//   profileName: string | null
-// }
-```
-**Four factors checked:**
-- **Factor A** — Live registry (`sock.onWhatsApp`)
-- **Factor B** — Public send-page title/image probe (`api.whatsapp.com`)
-- **Factor C** — Identity-key device probe via USync (strongest: banned numbers have their keys destroyed)
-- **Factor D** — Device-count signature (2+ = ACTIVE, 1 generic = likely BANNED, 0 = BANNED/OFF_WA)
+// 🧠 Trivia
+const q = trivia(100);
+// q.question, q.options, q.answer
----
-## 🆔 Username Socket (w:mex)
-Full WA `@username` API via WhatsApp's internal Pando/MEX GraphQL protocol, query IDs sourced from Java decompile of WA 2.26.17.2:
-```javascript
-// Check availability
-const res = await sock.checkUsername('myusername')
-// { available: true, username } or { available: false, suggestions: [...] }
-// Set username
-await sock.setUsername('myusername')
-// Delete username
-await sock.deleteUsername()
-// Get your own username
-const mine = await sock.getMyUsername()
-// Pin/unpin username
-await sock.setUsernamePin(true)
-// Find user by username
-const user = await sock.findUserByUsername('someuser', pin)
-// Fetch usernames of your contacts in batch
-const usernames = await sock.fetchContactUsernames('94xxxx@s.whatsapp.net', '628yyy@s.whatsapp.net')
-// Get username suggestions
-const suggestions = await sock.getUsernameRecommendations()
-```
----
-## 🏘️ Communities Socket
-```javascript
-// Create community
-const community = await sock.communityCreate('Community Name', 'Description')
-// Create group inside community
-await sock.communityCreateGroup('Group Name', [jid1, jid2], communityJid)
-// Link/unlink existing group
-await sock.communityLinkGroup(groupJid, communityJid)
-await sock.communityUnlinkGroup(groupJid, communityJid)
-// Fetch linked groups
-const groups = await sock.communityFetchLinkedGroups(communityJid)
-// Manage participants
-await sock.communityParticipantsUpdate(communityJid, [jid1], 'add')   // 'add' | 'remove' | 'promote' | 'demote'
-// Invite code
-const code = await sock.communityInviteCode(communityJid)
-await sock.communityRevokeInvite(communityJid)
-await sock.communityAcceptInvite(code)
-// Settings
-await sock.communityToggleEphemeral(communityJid, 86400)   // seconds
-await sock.communityMemberAddMode(communityJid, 'admin_add')
-await sock.communityJoinApprovalMode(communityJid, 'on')
-await sock.communityUpdateSubject(communityJid, 'New Name')
-await sock.communityUpdateDescription(communityJid, 'New Desc')
-await sock.communityLeave(communityJid)
-```
----
-## 🔕 noSelfSync
-Skip syncing outgoing messages to your own linked devices. Useful for high-volume bots where sync traffic is unnecessary:
-```javascript
-await sock.sendMessage(jid, { text: 'hello' }, { noSelfSync: true })
-// Also supported in all shortcut methods:
-await sock.sendTable(jid, title, headers, rows, quoted, { noSelfSync: true })
-await sock.sendCodeBlock(jid, code, quoted, { noSelfSync: true })
-```
-> **Safe by design:** if `noSelfSync` would accidentally drop all recipients (e.g. messaging yourself), the guard kicks in and delivers normally. If the other party has zero resolved devices, it throws `Boom 421` instead of silently pretending the message was sent.
----
-## 🔄 Stability & Disconnect Handling
-ishumdz-bail ships `classifyDisconnect()` — maps every WA status code into an actionable result:
-```javascript
-import { classifyDisconnect } from 'ishumdz-bail'
-sock.ev.on('connection.update', ({ connection, lastDisconnect }) => {
-    if (connection === 'close') {
-        const code = lastDisconnect?.error?.output?.statusCode
-        const info = classifyDisconnect(code)
-        console.log(info)
-        // {
-        //   category: 'fatal' | 'recoverable' | 'rate-limited' | 'unknown',
-        //   shouldReconnect: boolean,
-        //   backoffMs: number,    // ms to wait before reconnecting
-        //   message: string,
-        //   code: number
-        // }
-        if (info.shouldReconnect) {
-            setTimeout(() => reconnect(), info.backoffMs)
-        }
-    }
-})
-```
-**Code map:**
-| Code | Category | Reconnect | Backoff |
-|---|---|---|---|
-| 401, 440 | fatal | ❌ | — |
-| 515 | recoverable | ✅ | 0 ms (immediate) |
-| 405 | fatal | ❌ | — |
-| 408 | recoverable | ✅ | 30 s |
-| 503 | recoverable | ✅ | 5 min |
-| 429 | rate-limited | ✅ | 60 s |
-| 500 | recoverable | ✅ | 5 s |
-| 503 | recoverable | ✅ | 10 s |
-| Graceful close | recoverable | ✅ | 2 s |
-| Unknown | unknown | ✅ | 15 s |
-> **Important:** Code 515 (`restartRequired`) is WhatsApp's normal post-pairing signal. ishumdz-bail correctly treats it as recoverable with 0 ms backoff — other forks incorrectly mark it as fatal, causing bots to stop after first pair.
----
-## ⏱️ Rate Limiter
-Anti-ban pacing calculator — wire into your send path before each `sendMessage`:
-```javascript
-import { RateLimiter } from 'ishumdz-bail'
-const limiter = new RateLimiter({
-    maxPerMinute: 8,
-    maxPerHour: 200,
-    maxPerDay: 1500,
-    minDelayMs: 1500,
-    maxDelayMs: 5000,
-    newChatDelayMs: 3000,
-    maxIdenticalMessages: 3,
-    burstAllowance: 3
-})
-async function safeSend(jid, content) {
-    const delay = await limiter.getDelay(jid, content)
-    if (delay === -1) throw new Error('Rate limit exceeded — blocked')
-    if (delay > 0) await new Promise(r => setTimeout(r, delay))
-    await sock.sendMessage(jid, content)
-    limiter.record(jid, content)
-}
+// 💣 Mines
+const mines = createMines(5, 5, 5);
+const tile = revealTile(mines, 0, 0);
+const cashout = cashoutMines(mines, 100);
 ```
 ---
-## 📦 Supported Message Types
-Every WhatsApp message type is covered:
-- Text, image, video, audio, document, sticker, GIF/video note (PTV)
-- Location & live location
-- Contact / vCard
-- Poll (create, vote, add option, poll result)
-- Button, list, template, interactive (native flow)
-- Album (multiple media in one message)
-- Event & event invite
-- Group invite, group status, group mention
-- Spoiler (blurred) messages
-- Reaction & edited message
-- View-once media
-- Status/story mention & reply
-- Newsletter / channel messages
-- Payment & payment invite
-- All WhatsApp Business types: product, catalog, order, invoice, business profile
-<details>
-<summary><b>Example: Album</b></summary>
+## 📞 VoIP Caller
 ```javascript
-await sock.sendMessage(jid, {
-    album: [
-        { image: { url: 'https://example.com/1.jpg' } },
-        { video: { url: 'https://example.com/2.mp4' } }
-    ],
-    caption: 'Album caption'
-})
-```
-</details>
-<details>
-<summary><b>Example: Poll</b></summary>
+const { makeWASocket, enableCallAutoAnswer, getActiveVoipClient } = require('ishumdz-bail');
-```javascript
-await sock.sendMessage(jid, {
-    poll: {
-        name: 'Poll Title',
-        values: ['Option A', 'Option B'],
-        selectableCount: 1
-    }
-})
-```
-</details>
-<details>
-<summary><b>Example: Spoiler</b></summary>
-```javascript
-await sock.sendMessage(jid, {
-    text: 'Spoiler content',
-    spoiler: true
-})
-```
-</details>
+const sock = makeWASocket({ auth: state });
-<details>
-<summary><b>Example: Event</b></summary>
+// Auto-answer calls with audio
+sock.enableCallAutoAnswer({
+    audio: './welcome.wav',
+    autoAnswer: true,
+    answerDelayMs: 200,
+    durationMs: 60000,
+    loop: true
+});
-```javascript
-await sock.sendMessage(jid, {
-    eventMessage: {
-        name: 'Meeting',
-        description: 'Weekly sync',
-        location: { degreesLatitude: -6.2, degreesLongitude: 106.8 },
-        startTime: Math.floor(Date.now() / 1000) + 3600
+// Manual call handling
+sock.ev.on('call', async ([call]) => {
+    if (call.status === 'offer') {
+        await sock.rejectCall(call.id, call.from);
     }
-})
-```
-</details>
----
-## 🛠️ Additional Methods
-```javascript
-// Parse incoming extended/special messages
-sock.ev.on('messages.upsert', ({ messages }) => {
-    const extended = sock.parseExtendedMessageContent(messages[0].message)
-    if (extended) console.log(extended.type, extended.data)
-})
-// Business profile
-const profile = await sock.getBusinessProfile(jid)
-await sock.updateBusinessProfile({ description: 'Open 9-5', email: 'hi@example.com', category: 'Retail' })
-// Get newsletter/channel JID from URL
-await sock.newsletterId('https://whatsapp.com/channel/...')
-// Refresh media URL for expired messages
-await sock.updateMediaMessage(message)
+});
 ```
 ---
-## 🎮 Games
-Built-in games for your WhatsApp bot! Import from `ishumdz-bail`:
-```javascript
-import {
-    blackjack, slotMachine, diceGame,
-    coinFlip, roulette, rps, trivia,
-    createMines, revealTile, cashoutMines
-} from 'ishumdz-bail'
-```
-### 🃏 Blackjack
-```javascript
-// Start game
-const game = blackjack('start', [], [], 1000)
-await sock.sendMessage(jid, { text: game.message })
-// Hit (after start)
-const hit = blackjack('hit', game.playerHand, game.dealerHand, 1000)
-// Stand
-const stand = blackjack('stand', game)
-// Double
-const dbl = blackjack('double', game)
-```
-### 🎰 Slot Machine
+## ⚡ Pro Methods
 ```javascript
-const slot = slotMachine(100)
-await sock.sendMessage(jid, { text: slot.message })
-// 🎰 [🍒] [🍋] [💎] - NO MATCH
-```
-### 🎲 Dice
+const { makeWASocket, attachProMethods } = require('ishumdz-bail');
-```javascript
-const dice = diceGame(100, 'high') // high, low, or seven
-await sock.sendMessage(jid, { text: dice.message })
+const sock = makeWASocket({ auth: state });
+attachProMethods(sock); // Attach all 34 Pro methods
 ```
-### 🪙 Coin Flip
+### 📊 Polls
 ```javascript
-const coin = coinFlip(100, 'heads') // heads or tails
-await sock.sendMessage(jid, { text: coin.message })
+await sock.sendPoll(jid, { name: 'Vote?', values: ['Yes', 'No'] });
+await sock.sendPollVote(jid, pollMsg, ['Yes']);
+const votes = sock.getAggregatePollVotes(pollMsg);
 ```
-### 🎰 Roulette
+### 📢 Newsletter/Channels
 ```javascript
-const rou = roulette(100, 'red') // red, black, odd, even, low, high
-await sock.sendMessage(jid, { text: rou.message })
+await sock.channelVote('https://whatsapp.com/channel/xxx', 1);
+await sock.newsletterReact(jid, serverId, '👍');
+const msgs = await sock.newsletterGetMessages(jid, 50);
+const results = await sock.newsletterSearch('tech');
+const channels = await sock.newsletterList();
 ```
-### ✊ Rock Paper Scissors
+### 🟢 Status/Stories
 ```javascript
-const r = rps('rock') // rock, paper, scissors
-await sock.sendMessage(jid, { text: r.message })
+await sock.sendStatusText('Hello!', { backgroundColor: '#25D366' });
+await sock.sendStatusMedia('./photo.jpg', { type: 'image' });
+await sock.reactStatus(key, '❤️');
 ```
-### 💣 Mines
+### 💬 Chat
 ```javascript
-// Create game
-const game = createMines(5, 5, 5) // rows, cols, mines
-// Reveal tile
-const result = revealTile(game, 0, 0) // row, col
-await sock.sendMessage(jid, { text: result.message })
-// Cashout
-const cashout = cashoutMines(game, 100)
-await sock.sendMessage(jid, { text: cashout.message })
+await sock.editMessage(jid, key, 'Updated!');
+await sock.deleteMessage(jid, key);
+await sock.pinMessage(jid, key, 86400);
+await sock.starMessage(jid, key, true);
+await sock.reactMessage(jid, key, '😂');
+await sock.sendPresence(jid, 'composing');
+await sock.reply(jid, 'Reply!', quotedMsg);
 ```
-### 🧠 Trivia
+### 👥 Groups
 ```javascript
-const quiz = trivia(100)
-await sock.sendMessage(jid, { text: quiz.message })
-// Check answer (A, B, C, or D)
-const answer = checkTriviaAnswer('B', quiz.answer, 100)
-await sock.sendMessage(jid, { text: answer.message })
+const info = await sock.groupGetInviteInfo('https://chat.whatsapp.com/xxx');
+await sock.groupJoinViaInvite('https://chat.whatsapp.com/xxx');
+await sock.groupSetAnnouncement(jid, true);
+await sock.groupSetLocked(jid, true);
+const requests = await sock.groupRequestParticipantsList(jid);
+await sock.groupApproveParticipants(jid, [user1]);
+await sock.groupRejectParticipants(jid, [user2]);
 ```
-### 📱 Bot Command Example
+### 👤 Profile
 ```javascript
-sock.ev.on('messages.upsert', async ({ messages }) => {
-    const msg = messages[0]
-    const text = msg.message?.conversation || ''
-    if (text === '.rps rock' || text === '.rps paper' || text === '.rps scissors') {
-        const choice = text.split(' ')[1]
-        const result = rps(choice)
-        await sock.sendMessage(msg.key.remoteJid, { text: result.message })
-    }
-    if (text.startsWith('.slot')) {
-        const bet = parseInt(text.split(' ')[1]) || 100
-        const result = slotMachine(bet)
-        await sock.sendMessage(msg.key.remoteJid, { text: result.message })
-    }
-    if (text.startsWith('.coinflip')) {
-        const choice = text.split(' ')[1] || 'heads'
-        const bet = parseInt(text.split(' ')[2]) || 100
-        const result = coinFlip(bet, choice)
-        await sock.sendMessage(msg.key.remoteJid, { text: result.message })
-    }
-})
+const check = await sock.checkNumber('1234567890');
+await sock.setBio('My bot');
+await sock.updateProfileName('Bot Name');
+await sock.setProfilePicture(jid, './avatar.jpg');
+await sock.removeProfilePicture(jid);
+await sock.rejectCall(callId, callFrom);
 ```
 ---
-## 📊 Poll Voting
-Create polls, track votes, and display results.
-### 🗳️ Create Poll
+## 📰 Newsletter Media Paths
 ```javascript
-await sock.sendMessage(jid, {
-    poll: {
-        name: 'Best programming language?',
-        values: ['JavaScript', 'Python', 'Java', 'Go', 'Rust'],
-        selectableCount: 1
-    }
-})
-```
+const { NEWSLETTER_MEDIA_PATH_MAP } = require('ishumdz-bail');
-### 📊 Poll with Multiple Selections
-```javascript
-await sock.sendMessage(jid, {
-    poll: {
-        name: 'Which features do you want?',
-        values: ['Games', 'AI', 'Stickers', 'Download'],
-        selectableCount: 3 // Users can select up to 3 options
-    }
-})
-```
-### 📢 Announcement Group Poll (Admin Only Voting)
-```javascript
-await sock.sendMessage(groupJid, {
-    poll: {
-        name: 'Admin Poll',
-        values: ['Option 1', 'Option 2'],
-        selectableCount: 1,
-        toAnnouncementGroup: true
-    }
-})
-```
-### 🏆 Poll Result (Fake Results)
-```javascript
-await sock.sendMessage(jid, {
-    pollResult: {
-        name: 'Best framework?',
-        votes: [['React', 150], ['Vue', 120], ['Angular', 80]]
-    }
-})
-```
-### 📈 Track Poll Votes
-```javascript
-import { getAggregateVotesInPollMessage } from 'ishumdz-bail'
-// Store messages
-const messageStore = new Map()
-sock.ev.on('messages.upsert', async ({ messages }) => {
-    for (const msg of messages) {
-        const id = msg.key.remoteJid + ':' + msg.key.id
-        messageStore.set(id, msg)
-    }
-})
-// Listen for poll votes
-sock.ev.on('messages.update', async (events) => {
-    for (const { key, update } of events) {
-        if (update.pollUpdates) {
-            const id = key.remoteJid + ':' + key.id
-            const pollCreation = messageStore.get(id)
-            if (pollCreation) {
-                const votes = getAggregateVotesInPollMessage({
-                    message: pollCreation,
-                    pollUpdates: update.pollUpdates
-                })
-                console.log('Poll votes:', votes)
-                // [{ name: 'Option 1', voters: ['123@s.whatsapp.net'] }, ...]
-            }
-        }
-    }
-})
+// All paths for channel uploads
+console.log(NEWSLETTER_MEDIA_PATH_MAP);
+// {
+//   image: '/newsletter/newsletter-image',
+//   video: '/newsletter/newsletter-video',
+//   document: '/newsletter/newsletter-document',
+//   audio: '/newsletter/newsletter-audio',
+//   sticker: '/newsletter/newsletter-image',
+//   gif: '/newsletter/newsletter-gif',
+//   ptt: '/newsletter/newsletter-ptt',
+//   ptv: '/newsletter/newsletter-ptv'
+// }
 ```
-### 📱 Poll Bot Command Example
+---
-```javascript
-sock.ev.on('messages.upsert', async ({ messages }) => {
-    const msg = messages[0]
-    const text = msg.message?.conversation || ''
-    // .poll Question | Option1 | Option2 | Option3
-    if (text.startsWith('.poll')) {
-        const args = text.slice(5).split('|').map(s => s.trim())
-        const question = args[0]
-        const options = args.slice(1)
-        if (question && options.length >= 2) {
-            await sock.sendMessage(msg.key.remoteJid, {
-                poll: {
-                    name: question,
-                    values: options,
-                    selectableCount: 1
-                }
-            })
-        }
-    }
-    // .pollresult React | 150 | Vue | 120
-    if (text.startsWith('.pollresult')) {
-        const args = text.slice(12).split('|').map(s => s.trim())
-        const votes = []
-        for (let i = 0; i < args.length; i += 2) {
-            votes.push([args[i], parseInt(args[i + 1]) || 0])
-        }
-        await sock.sendMessage(msg.key.remoteJid, {
-            pollResult: {
-                name: 'Poll Results',
-                votes
-            }
-        })
-    }
-})
+## 📋 All Features List
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│                           COMPLETE FEATURE LIST                             │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                             │
+│  🎮 GAMES (8 functions)                                                    │
+│  ├── blackjack(action, playerHand, dealerHand, bet)                        │
+│  ├── slotMachine(bet)                                                      │
+│  ├── diceGame(bet, prediction)                                             │
+│  ├── coinFlip(bet, choice)                                                 │
+│  ├── roulette(bet, choice)                                                 │
+│  ├── rps(choice)                                                           │
+│  ├── trivia(bet)                                                           │
+│  ├── createMines(rows, cols, mineCount)                                    │
+│  ├── revealTile(game, row, col)                                            │
+│  └── cashoutMines(game, bet)                                               │
+│                                                                             │
+│  📞 VOIP (3 functions)                                                     │
+│  ├── VoipClient                                                            │
+│  ├── ActiveCall                                                             │
+│  ├── AudioFeeder                                                            │
+│  ├── VideoFeeder                                                            │
+│  ├── enableCallAutoAnswer(sock, options)                                   │
+│  └── getActiveVoipClient()                                                 │
+│                                                                             │
+│  ⚡ PRO METHODS (34 functions)                                              │
+│  ├── sendPoll(jid, pollData)                                               │
+│  ├── sendPollVote(jid, pollKey, options)                                   │
+│  ├── getAggregatePollVotes(pollMsg)                                        │
+│  ├── channelVote(target, option)                                           │
+│  ├── newsletterVoteMessage(jid, serverId, option)                          │
+│  ├── newsletterReact(jid, serverId, reaction)                              │
+│  ├── newsletterGetMessages(jid, count)                                     │
+│  ├── newsletterSearch(query)                                               │
+│  ├── newsletterList()                                                      │
+│  ├── sendStatusText(text, options)                                         │
+│  ├── sendStatusMedia(media, options)                                       │
+│  ├── readStatus(key)                                                       │
+│  ├── reactStatus(key, emoji)                                               │
+│  ├── editMessage(jid, key, text)                                           │
+│  ├── deleteMessage(jid, key)                                               │
+│  ├── pinMessage(jid, key, duration)                                        │
+│  ├── unpinMessage(jid, key)                                                │
+│  ├── starMessage(jid, key, star)                                           │
+│  ├── reactMessage(jid, key, emoji)                                         │
+│  ├── sendPresence(jid, presence)                                           │
+│  ├── reply(jid, text, quoted)                                              │
+│  ├── checkNumber(phone)                                                    │
+│  ├── setBio(text)                                                          │
+│  ├── updateProfileName(name)                                               │
+│  ├── setProfilePicture(jid, content)                                       │
+│  ├── removeProfilePicture(jid)                                             │
+│  ├── rejectCall(callId, callFrom)                                          │
+│  ├── groupGetInviteInfo(code)                                              │
+│  ├── groupJoinViaInvite(code)                                              │
+│  ├── groupSetAnnouncement(jid, bool)                                       │
+│  ├── groupSetLocked(jid, bool)                                             │
+│  ├── groupRequestParticipantsList(jid)                                     │
+│  ├── groupApproveParticipants(jid, participants)                           │
+│  ├── groupRejectParticipants(jid, participants)                            │
+│  └── attachProMethods(sock)                                                │
+│                                                                             │
+│  📰 NEWSLETTER (8 functions)                                                │
+│  ├── NEWSLETTER_MEDIA_PATH_MAP                                              │
+│  ├── newsletterFetchMessages(jid, count, since, after)                     │
+│  ├── newsletterMetadata(type, query)                                       │
+│  ├── newsletterReactMessage(jid, serverId, reaction)                       │
+│  ├── newsletterUpdate(jid, settings)                                       │
+│  ├── newsletterCreate(name, description)                                   │
+│  ├── newsletterDelete(jid)                                                 │
+│  └── newsletterFollow(jid)                                                 │
+│                                                                             │
+│  📊 POLL VOTING (1 function)                                                │
+│  └── getAggregateVotesInPollMessage(pollMsg)                               │
+│                                                                             │
+│  🎯 CORE (10+ functions)                                                    │
+│  ├── makeWASocket(config)                                                  │
+│  ├── useMultiFileAuthState(dir)                                            │
+│  ├── makeCacheableSignalKeyStore(state, logger)                            │
+│  ├── DisconnectReason                                                       │
+│  ├── delay(ms)                                                              │
+│  ├── proto                                                                   │
+│  ├── encodeBinaryNode(frame)                                                │
+│  ├── decodeBinaryNode(buffer)                                               │
+│  ├── jidDecode(jid)                                                         │
+│  └── jidEncode(user, server)                                                │
+│                                                                             │
+└─────────────────────────────────────────────────────────────────────────────┘
 ```
 ---
-## 🌐 Community & Support
-<div align="center">
-<table>
-<tr>
-<td align="center">
-<a href="https://ishanx-pro.site.je">
-🌐<br/><b>Website</b><br/>ishanx-pro.site.je
-</a>
-</td>
-<td align="center">
-<a href="https://shyracore.indevs.in">
-💬<br/><b>WhatsApp Channel</b><br/>shyracore.indevs.in
-</a>
-</td>
-</tr>
-</table>
-**Developer:** Lovely
+## 📄 License
-</div>
+MIT License
 ---
 <div align="center">
-### ⭐ If this project helped you, consider giving it a star!
+**Made with ❤️ by Lovely**
-Made with ❤️ by **Lovely**
+[![npm](https://img.shields.io/badge/npm-ishumdz--bail-25D366?style=for-the-badge&logo=npm&logoColor=white)](https://www.npmjs.com/package/ishumdz-bail)
+[![GitHub](https://img.shields.io/badge/GitHub-lovelyofficial-FF4500?style=for-the-badge&logo=github&logoColor=white)](https://github.com/lovelyofficial/ishumdz-bail)
 </div>
----
-## 📄 License
-MIT

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
     "name": "ishumdz-bail",
-    "version": "1.0.8",
+    "version": "1.0.10",
     "description": "WhatsApp API Modification By Lovely",
     "keywords": [
         "whatsapp",