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

ishumdz-bail 1.0.8 → 1.0.9

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 +396 -764
package/package.json +1 -1

package/README.md CHANGED Viewed

@@ -1,135 +1,300 @@
 <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/>
-<!-- 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/>
-# 🧑‍💻 ishumdz-bail
+```
+╔═══════════════════════════════════════════════════════════════════╗
+║                                                                   ║
+║     ██╗  ██╗██████╗  █████╗ ███████╗████████╗                    ║
+║     ██║  ██║██╔══██╗██╔══██╗██╔════╝╚══██╔══╝                    ║
+║     ███████║██████╔╝███████║███████╗   ██║                       ║
+║     ██╔══██║██╔══██╗██╔══██║╚════██║   ██║                       ║
+║     ██║  ██║██████╔╝██║  ██║███████║   ██║                       ║
+║     ╚═╝  ╚═╝╚═════╝ ╚═╝  ╚═╝╚══════╝   ╚═╝                       ║
+║                                                                   ║
+║     ██████╗ ██╗   ██╗██╗███████╗                                ║
+║     ██╔══██╗██║   ██║██║╚══███╔╝                                ║
+║     ██║  ██║██║   ██║██║  ███╔╝                                 ║
+║     ██║  ██║██║   ██║██║ ███╔╝                                  ║
+║     ██████╔╝╚██████╔╝██║███████╗                                ║
+║     ╚═════╝  ╚═════╝ ╚═╝╚══════╝                                ║
+║                                                                   ║
+║              WhatsApp Web API Fork for Bots                      ║
+║                  By Lovely ❤️                                    ║
+║                                                                   ║
+╚═══════════════════════════════════════════════════════════════════╝
+```
+<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/>
+</div>
-[Installation](#-getting-started) • [Features](#-main-features) • [Stability](#-stability--disconnect-handling) • [Website](https://ishanx-pro.site.je) • [WhatsApp Channel](https://shyracore.indevs.in)
+---
-</div>
+## 📋 Table of Contents
+- [✨ What is ishumdz-bail?](#-what-is-ishumdz-bail)
+- [🚀 Installation](#-installation)
+- [⚡ Quick Start](#-quick-start)
+- [🎯 Features Overview](#-features-overview)
+- [🎮 Games](#-games)
+- [📞 VoIP Caller](#-voip-caller)
+- [⚡ Pro Methods](#-pro-methods)
+- [📊 Polls](#-polls)
+- [📢 Newsletter/Channels](#-newsletterchannels)
+- [🟢 Status/Stories](#-statusstories)
+- [💬 Chat Actions](#-chat-actions)
+- [👥 Group Management](#-group-management)
+- [👤 Profile Management](#-profile-management)
+- [📰 Newsletter Media](#-newsletter-media)
+- [🔌 API Reference](#-api-reference)
+- [📝 Examples](#-examples)
 ---
 ## ✨ 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.
+**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.
-> ⚡ **Node.js ≥ 20 required.**
+**Why choose ishumdz-bail?**
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  ✅ No Browser Required     │  ✅ Multi-Device Support          │
+│  ✅ WebSocket Based         │  ✅ Full API Coverage             │
+│  ✅ Built-in Games (8)      │  ✅ VoIP Call Answer              │
+│  ✅ Pro Methods (34)        │  ✅ Newsletter/Channel Support    │
+│  ✅ Active Maintenance      │  ✅ MIT Licensed                  │
+└─────────────────────────────────────────────────────────────────┘
+```
 ---
-## 🚀 Getting Started
+## 🚀 Installation
 ```bash
 npm install ishumdz-bail
 ```
+**Requirements:**
+- Node.js ≥ 20
+- npm or yarn
+---
+## ⚡ Quick Start
 ```javascript
-import { makeWASocket, useMultiFileAuthState } from 'ishumdz-bail'
+const { makeWASocket, useMultiFileAuthState, attachProMethods } = require('ishumdz-bail');
+const { state, saveCreds } = await useMultiFileAuthState('auth_info');
-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)
-})
+    syncFullHistory: false,
+    aiLabel: true,
+    autoAnswer: false,
+});
+sock.ev.on('creds.update', saveCreds);
-sock.ev.on('creds.update', saveCreds)
+sock.ev.on('connection.update', ({ connection }) => {
+    if (connection === 'open') {
+        console.log('✅ Connected to WhatsApp!');
+        // Attach Pro methods
+        attachProMethods(sock);
+    }
+});
 ```
 ---
-## 🧩 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 |
+## 🎯 Features Overview
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                          ISHUMDZ-BAIL FEATURES                         │
+├─────────────────────────────────────────────────────────────────────────┤
+│                                                                         │
+│  🎮 GAMES (8)        │  📞 VOIP (3)        │  ⚡ PRO METHODS (34)     │
+│  ├─ Blackjack         │  ├─ VoipClient       │  ├─ sendPoll             │
+│  ├─ Slots             │  ├─ ActiveCall       │  ├─ sendPollVote         │
+│  ├─ Dice              │  └─ AudioFeeder      │  ├─ editMessage          │
+│  ├─ Coin Flip         │                      │  ├─ deleteMessage        │
+│  ├─ Roulette          │  📊 POLLS (3)       │  ├─ pinMessage           │
+│  ├─ Mines             │  ├─ sendPoll         │  ├─ reactMessage         │
+│  ├─ Trivia            │  ├─ sendPollVote     │  ├─ sendStatusText       │
+│  └─ Rock Paper        │  └─ getAggregate     │  ├─ checkNumber          │
+│     Scissors          │     Votes            │  └─ ... and more!        │
+│                                                                         │
+│  📢 NEWSLETTER (6)    │  🟢 STATUS (4)      │  💬 CHAT (8)            │
+│  ├─ channelVote       │  ├─ sendStatusText   │  ├─ editMessage          │
+│  ├─ newsletterReact   │  ├─ sendStatusMedia  │  ├─ deleteMessage        │
+│  ├─ newsletterGet     │  ├─ readStatus       │  ├─ pinMessage           │
+│  │   Messages         │  └─ reactStatus      │  ├─ unpinMessage         │
+│  ├─ newsletterSearch  │                      │  ├─ starMessage          │
+│  └─ newsletterList    │  👥 GROUPS (7)      │  ├─ sendPresence         │
+│                      │  ├─ groupGetInvite   │  └─ reply                │
+│  👤 PROFILE (6)      │  ├─ groupJoinVia     │                         │
+│  ├─ checkNumber       │  │   Invite          │                         │
+│  ├─ setBio            │  ├─ groupSet         │                         │
+│  ├─ updateProfileName │  │   Announcement    │                         │
+│  ├─ setProfilePicture │  ├─ groupSetLocked   │                         │
+│  ├─ removeProfile     │  ├─ groupRequest     │                         │
+│  │   Picture          │  │   Participants    │                         │
+│  └─ rejectCall        │  ├─ groupApprove     │                         │
+│                       │  │   Participants    │                         │
+│                       │  └─ groupReject      │                         │
+│                       │     Participants    │                         │
+│                                                                         │
+└─────────────────────────────────────────────────────────────────────────┘
+```
 ---
-## 📞 VoIP Caller (Call Answer + Audio)
+## 🎮 Games
+8 built-in games for your WhatsApp bot:
+```javascript
+const { blackjack, slotMachine, diceGame, coinFlip, roulette, rps, trivia, createMines } = require('ishumdz-bail');
+```
+### 🃏 Blackjack
+```javascript
+// Start a game
+const game = blackjack('start', [], [], 100);
+console.log(game.playerHand); // [{suit:'♠️',value:'A'}, {suit:'♥️',value:'K'}]
+console.log(game.dealerHand); // [{suit:'♦️',value:'5'}, {suit:'♣️',value:'?'}]
+console.log(game.status);     // 'playing'
+// Hit (draw card)
+const hit = blackjack('hit', game.playerHand, game.dealerHand, 100);
-Answer incoming WhatsApp calls and play audio automatically:
+// Stand (end turn)
+const stand = blackjack('stand', game.playerHand, game.dealerHand, 100);
+console.log(stand.status);    // 'win', 'lose', or 'push'
+```
+### 🎰 Slots
 ```javascript
-const { makeWASocket, enableCallAutoAnswer } = require('ishumdz-bail');
+const slots = slotMachine(100);
+console.log(slots.reels);   // ['🍒', '🍋', '🍊']
+console.log(slots.payout);  // 0-500 (multiplier)
+```
+### 🎲 Dice
+```javascript
+const dice = diceGame(100, 'high'); // 'high', 'low', or specific number
+console.log(dice.dice1);  // 1-6
+console.log(dice.dice2);  // 1-6
+console.log(dice.total);  // 2-12
+console.log(dice.win);    // true/false
+```
+### 🪙 Coin Flip
+```javascript
+const flip = coinFlip(100, 'heads'); // 'heads' or 'tails'
+console.log(flip.result);  // 'heads' or 'tails'
+console.log(flip.payout);  // 0 or 200
+```
+### 🎡 Roulette
+```javascript
+const spin = roulette(100, 'red'); // 'red', 'black', 'green', or number
+console.log(spin.number);  // 0-36
+console.log(spin.color);   // 'red', 'black', or 'green'
+console.log(spin.payout);  // 0-3600
+```
+### ✊ Rock Paper Scissors
+```javascript
+const game = rps('rock'); // 'rock', 'paper', or 'scissors'
+console.log(game.playerChoice);  // 'rock'
+console.log(game.botChoice);     // 'paper'
+console.log(game.result);        // 'win', 'lose', or 'draw'
+```
+### 🧠 Trivia
+```javascript
+const question = trivia(100);
+console.log(question.question);  // 'What is the capital of France?'
+console.log(question.options);   // ['A) Paris', 'B) London', ...]
+console.log(question.answer);    // 'A'
+```
+### 💣 Mines
+```javascript
+// Create a 5x5 grid with 5 mines
+const game = createMines(5, 5, 5);
+console.log(game.totalSafe);  // 20
+// Reveal a tile
+const tile = revealTile(game, 0, 0);
+console.log(tile.safe);   // true (diamond) or false (mine)
+console.log(tile.mine);   // true or false
+// Cash out
+const cashout = cashoutMines(game, 100);
+console.log(cashout.payout);  // based on revealed tiles
+```
+---
+## 📞 VoIP Caller
+Answer incoming WhatsApp calls with audio playback:
+```javascript
+const { makeWASocket, enableCallAutoAnswer, getActiveVoipClient } = require('ishumdz-bail');
 const sock = makeWASocket({ auth: state });
-// Enable auto-answer with audio playback
+// Enable auto-answer
 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
+    audio: './welcome.wav',        // Audio file (MP3/WAV)
+    autoAnswer: true,              // Auto-answer calls
+    answerDelayMs: 200,            // Delay before answer
+    durationMs: 60000,             // Max duration (60s)
+    loop: true,                    // Loop audio
+    onCall: (call) => {},          // Incoming call callback
+    onAnswer: (call) => {},        // Answered callback
+    onEnd: (call, reason) => {}    // Ended callback
 });
 ```
-**Manual call handling:**
+### Manual Call Handling
 ```javascript
 sock.ev.on('call', async ([call]) => {
     if (call.status === 'offer') {
+        console.log(`📞 Incoming ${call.isVideo ? 'video' : 'voice'} call from ${call.from}`);
         // 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');
+        if (voipClient?.activeCall) {
+            voipClient.activeCall.accept('./audio.wav');
         }
     }
 });
@@ -139,7 +304,7 @@ sock.ev.on('call', async ([call]) => {
 ## ⚡ Pro Methods
-34 convenience methods attached to socket via `attachProMethods()`:
+34 convenience methods for easier development:
 ```javascript
 const { makeWASocket, attachProMethods } = require('ishumdz-bail');
@@ -148,7 +313,9 @@ const sock = makeWASocket({ auth: state });
 attachProMethods(sock); // Attach all Pro methods
 ```
-### 📊 Polls Pro
+---
+## 📊 Polls
 ```javascript
 // Create a poll
@@ -165,10 +332,12 @@ await sock.sendPollVote(jid, pollMessage, ['Red']);
 const votes = sock.getAggregatePollVotes(pollMessage);
 ```
-### 📢 Newsletter/Channel Pro
+---
+## 📢 Newsletter/Channels
 ```javascript
-// Smart channel poll vote (auto-resolves links, IDs)
+// Smart channel poll vote (auto-resolves links)
 await sock.channelVote('https://whatsapp.com/channel/xxx/123', 1);
 // React to channel post
@@ -184,7 +353,9 @@ const results = await sock.newsletterSearch('technology');
 const channels = await sock.newsletterList();
 ```
-### 🟢 Status/Stories Pro
+---
+## 🟢 Status/Stories
 ```javascript
 // Send text status
@@ -203,7 +374,9 @@ await sock.sendStatusMedia('./photo.jpg', {
 await sock.reactStatus(statusKey, '❤️');
 ```
-### 💬 Chat Pro
+---
+## 💬 Chat Actions
 ```javascript
 // Edit a message
@@ -212,8 +385,11 @@ 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
+// Pin a message (86400 = 24h, 604800 = 7d, 2592000 = 30d)
+await sock.pinMessage(jid, messageKey, 86400);
+// Unpin a message
+await sock.unpinMessage(jid, messageKey);
 // Star/unstar a message
 await sock.starMessage(jid, messageKey, true);
@@ -228,7 +404,9 @@ await sock.sendPresence(jid, 'composing');
 await sock.reply(jid, 'This is a reply!', quotedMessage);
 ```
-### 👥 Groups Pro
+---
+## 👥 Group Management
 ```javascript
 // Get group info from invite link
@@ -249,7 +427,9 @@ await sock.groupApproveParticipants(groupJid, [participant1, participant2]);
 await sock.groupRejectParticipants(groupJid, [participant3]);
 ```
-### 👤 Profile Pro
+---
+## 👤 Profile Management
 ```javascript
 // Check if number exists on WhatsApp
@@ -271,722 +451,174 @@ await sock.removeProfilePicture(jid);
 ---
-## 🎮 Built-in Games
+## 📰 Newsletter Media
-8 fun games for your WhatsApp bot:
+Upload media to channels with correct paths:
 ```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
-// Slots
-const slots = slotMachine(100);
-// slots.reels, slots.payout
-// Dice
-const dice = diceGame(100, 'high'); // Bet on high (7-12)
-// dice.total, dice.dice1, dice.dice2
-// Coin Flip
-const flip = coinFlip(100, 'heads');
-// flip.result, flip.payout
-// Roulette
-const spin = roulette(100, 'red');
-// spin.number, spin.color, spin.payout
-// 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'
-    }
-})
-```
+const { NEWSLETTER_MEDIA_PATH_MAP } = require('ishumdz-bail');
-**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)
+console.log(NEWSLETTER_MEDIA_PATH_MAP);
 // {
-//   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
+//   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'
 // }
 ```
-**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)
----
-## 🆔 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)
-```
+## 🔌 API Reference
+### Core Functions
+| Function | Description |
+|----------|-------------|
+| `makeWASocket(config)` | Create WhatsApp socket |
+| `useMultiFileAuthState(dir)` | Multi-file auth state |
+| `attachProMethods(sock)` | Attach Pro methods |
+| `enableCallAutoAnswer(sock, opts)` | Enable VoIP auto-answer |
+| `getActiveVoipClient()` | Get active VoIP client |
+| `delay(ms)` | Delay execution |
+### Games
+| Function | Description |
+|----------|-------------|
+| `blackjack(action, player, dealer, bet)` | Play blackjack |
+| `slotMachine(bet)` | Play slots |
+| `diceGame(bet, prediction)` | Play dice |
+| `coinFlip(bet, choice)` | Flip coin |
+| `roulette(bet, choice)` | Play roulette |
+| `rps(choice)` | Rock Paper Scissors |
+| `trivia(bet)` | Play trivia |
+| `createMines(rows, cols, mines)` | Create mines game |
+| `revealTile(game, row, col)` | Reveal tile |
+| `cashoutMines(game, bet)` | Cash out |
+### Pro Methods
+| Function | Description |
+|----------|-------------|
+| `sendPoll(jid, data)` | Create poll |
+| `sendPollVote(jid, key, options)` | Vote on poll |
+| `editMessage(jid, key, text)` | Edit message |
+| `deleteMessage(jid, key)` | Delete message |
+| `pinMessage(jid, key, duration)` | Pin message |
+| `unpinMessage(jid, key)` | Unpin message |
+| `starMessage(jid, key, star)` | Star message |
+| `reactMessage(jid, key, emoji)` | React to message |
+| `sendPresence(jid, presence)` | Send presence |
+| `reply(jid, text, quoted)` | Reply with quote |
+| `checkNumber(phone)` | Check WhatsApp number |
+| `setBio(text)` | Update bio |
+| `updateProfileName(name)` | Update name |
+| `setProfilePicture(jid, content)` | Set profile pic |
+| `removeProfilePicture(jid)` | Remove profile pic |
+| `sendStatusText(text, options)` | Send text status |
+| `sendStatusMedia(media, options)` | Send media status |
+| `readStatus(key)` | Mark status as read |
+| `reactStatus(key, emoji)` | React to status |
+| `channelVote(target, option)` | Smart channel vote |
+| `newsletterReact(jid, id, reaction)` | React to channel |
+| `newsletterGetMessages(jid, count)` | Get channel messages |
+| `newsletterSearch(query)` | Search channels |
+| `newsletterList()` | List followed channels |
+| `groupGetInviteInfo(code)` | Get group info |
+| `groupJoinViaInvite(code)` | Join via invite |
+| `groupSetAnnouncement(jid, bool)` | Admin-only messages |
+| `groupSetLocked(jid, bool)` | Admin-only edit |
+| `groupRequestParticipantsList(jid)` | Pending requests |
+| `groupApproveParticipants(jid, list)` | Approve requests |
+| `groupRejectParticipants(jid, list)` | Reject requests |
+| `rejectCall(callId, from)` | Reject call |
 ---
-## 🔕 noSelfSync
+## 📝 Examples
-Skip syncing outgoing messages to your own linked devices. Useful for high-volume bots where sync traffic is unnecessary:
+### Basic Bot
 ```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.
----
+const { makeWASocket, useMultiFileAuthState, attachProMethods } = require('ishumdz-bail');
-## 🔄 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)
-}
-```
----
-## 📦 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>
-```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>
-```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>
-<details>
-<summary><b>Example: Event</b></summary>
-```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
-    }
-})
-```
-</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
-```javascript
-const slot = slotMachine(100)
-await sock.sendMessage(jid, { text: slot.message })
-// 🎰 [🍒] [🍋] [💎] - NO MATCH
-```
-### 🎲 Dice
-```javascript
-const dice = diceGame(100, 'high') // high, low, or seven
-await sock.sendMessage(jid, { text: dice.message })
-```
-### 🪙 Coin Flip
-```javascript
-const coin = coinFlip(100, 'heads') // heads or tails
-await sock.sendMessage(jid, { text: coin.message })
-```
-### 🎰 Roulette
-```javascript
-const rou = roulette(100, 'red') // red, black, odd, even, low, high
-await sock.sendMessage(jid, { text: rou.message })
-```
-### ✊ Rock Paper Scissors
-```javascript
-const r = rps('rock') // rock, paper, scissors
-await sock.sendMessage(jid, { text: r.message })
-```
-### 💣 Mines
-```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 })
-```
-### 🧠 Trivia
-```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 })
-```
-### 📱 Bot Command Example
-```javascript
-sock.ev.on('messages.upsert', async ({ messages }) => {
-    const msg = messages[0]
-    const text = msg.message?.conversation || ''
+async function startBot() {
+    const { state, saveCreds } = await useMultiFileAuthState('auth');
-    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 })
-    }
+    const sock = makeWASocket({
+        auth: state,
+        printQRInTerminal: true
+    });
-    if (text.startsWith('.slot')) {
-        const bet = parseInt(text.split(' ')[1]) || 100
-        const result = slotMachine(bet)
-        await sock.sendMessage(msg.key.remoteJid, { text: result.message })
-    }
+    attachProMethods(sock);
-    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 })
-    }
-})
-```
----
-## 📊 Poll Voting
-Create polls, track votes, and display results.
-### 🗳️ Create Poll
-```javascript
-await sock.sendMessage(jid, {
-    poll: {
-        name: 'Best programming language?',
-        values: ['JavaScript', 'Python', 'Java', 'Go', 'Rust'],
-        selectableCount: 1
-    }
-})
-```
-### 📊 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)
+    sock.ev.on('creds.update', saveCreds);
+    sock.ev.on('messages.upsert', async ({ messages }) => {
+        const msg = messages[0];
+        if (!msg.key.fromMe && msg.message?.conversation) {
+            const text = msg.message.conversation.toLowerCase();
-            if (pollCreation) {
-                const votes = getAggregateVotesInPollMessage({
-                    message: pollCreation,
-                    pollUpdates: update.pollUpdates
-                })
-                console.log('Poll votes:', votes)
-                // [{ name: 'Option 1', voters: ['123@s.whatsapp.net'] }, ...]
+            if (text === '!ping') {
+                await sock.reply(msg.key.remoteJid, 'Pong! 🏓', msg);
+            }
+            if (text === '!slots') {
+                const slots = slotMachine(100);
+                await sock.reply(msg.key.remoteJid,
+                    `🎰 Slots: ${slots.reels.join(' | ')}\nPayout: ${slots.payout}`, msg);
             }
         }
-    }
-})
+    });
+}
+startBot();
 ```
-### 📱 Poll Bot Command Example
+### Call Auto-Answer Bot
 ```javascript
-sock.ev.on('messages.upsert', async ({ messages }) => {
-    const msg = messages[0]
-    const text = msg.message?.conversation || ''
+const { makeWASocket, useMultiFileAuthState, enableCallAutoAnswer } = require('ishumdz-bail');
+async function startCallBot() {
+    const { state, saveCreds } = await useMultiFileAuthState('auth');
-    // .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
-                }
-            })
-        }
-    }
+    const sock = makeWASocket({ auth: state });
+    sock.ev.on('creds.update', saveCreds);
-    // .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])
+    sock.ev.on('connection.update', ({ connection }) => {
+        if (connection === 'open') {
+            sock.enableCallAutoAnswer({
+                audio: './welcome.wav',
+                autoAnswer: true
+            });
+            console.log('📞 Call bot ready!');
         }
-        await sock.sendMessage(msg.key.remoteJid, {
-            pollResult: {
-                name: 'Poll Results',
-                votes
-            }
-        })
-    }
-})
+    });
+}
+startCallBot();
 ```
 ---
-## 🌐 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 - See [LICENSE](LICENSE) for details.
 ---
 <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.9",
     "description": "WhatsApp API Modification By Lovely",
     "keywords": [
         "whatsapp",