@vanzxy/baileys 1.2.5 → 1.2.7

package/README.md

@@ -1,61 +1,175 @@
-# 🌿 @vanzxy/baileys
+# 🍃 @vanzxy/baileys
+
+> Next-generation Baileys fork by **Vanzxy**.
+> Built for modern WhatsApp bot development with extended interactive messages, native flow enhancements, status tools, and quality-of-life improvements.
+
+![Version](https://img.shields.io/npm/v/@vanzxy/baileys)
+![Node](https://img.shields.io/badge/node-%3E%3D18-brightgreen)
+![ESM](https://img.shields.io/badge/module-ESM-blue)
+
+---
+
+# ✨ Why @vanzxy/baileys?
+
+This fork focuses on:
+
+- 🚀 Better developer experience
+- 🎯 Extended native flow support
+- 📢 Advanced status & broadcast features
+- 🧩 More interactive message types
+- ⚡ Cleaner implementation for bot developers
+- 🔧 Extra utilities not available in standard Baileys forks
+
+---
+
+# 🔥 Features
+
+## Interactive Messages
+- Native Flow
+- Buttons
+- Lists
+- Carousel Messages
+- Rich Response Messages
+- CTA Buttons
+- Reply Buttons
+- URL Buttons
+- Call Buttons
+- OTP Buttons
+- Authentication Buttons
+
+## Commerce & Business
+- Catalog Message
+- Order Details
+- Order Status
+- Review & Pay
+- Payment Status
+- Payment Method
+- Track Order
+- Reorder
+- Cancel Order
+
+## Utility Features
+- Group Status Support
+- Mention All
+- Lottie Sticker Support
+- Newsletter Support
+- ExternalAdReply Helper
+- View Once Support
+- Rich Formatting
+- Code Highlighting
+
+---
+
+# 🌟 Exclusive Vanzxy Enhancements
+
+### Audio Group Status Fix
+Audio status uses a more compatible implementation to avoid unsupported-version errors on older WhatsApp clients.
+
+### Native Flow Expansion
+Additional supported button types:
+
+- cta_reminder
+- cta_cancel_reminder
+- address_message
+- send_location
+- catalog_message
+- mpm
+- otp_button
+- authentication_button
+- call_button
+- url_button
+- reply_button
+- card_message
+- order_details
+- order_status
+- review_and_pay
+- payment_status
+- payment_method
+- track_order
+- reorder
+- cancel_order
+- clear_chat
+- navigateToScreen
+- flow_action
+- voice_call
+- video_call_button
+
+### System Notification Filter
+Messages include:
 
-Enhanced Baileys fork by **Vanzxy🍃 (VanzxyPrst🍃)** — built on top of `@itsliaaa/baileys` with extended native flow button support, system-notification filtering, and other fixes for WhatsApp bot development.
+```js
+message.isSystemNotification
+```
 
-## ✨ What's Different
+Useful for filtering:
 
-### 🔧 Fixes & Additions by Vanzxy🍃
+- E2E notices
+- Meta service notices
+- Other system-generated messages
 
-- **Audio Group Status** — Audio in `groupStatus: true` now uses `groupStatusMessage` (v1) instead of `groupStatusMessageV2`. This fixes the black screen / *"versi WhatsApp tidak mendukung"* error on older WA versions when bots broadcast audio via `swgc`.
-- **No "Lihat Saluran" Button** — Removed `mediaAnnotation` that auto-injected newsletter context into every image/video upload, causing an unwanted *"Lihat saluran"* button to appear on all media messages.
-- **Extended Native Flow Buttons** — Added support for `cta_reminder`, `cta_cancel_reminder`, `address_message`, `send_location`, `catalog_message`, `mpm`, `otp_button`, `authentication_button`, `call_button`, `url_button`, `reply_button`, `card_message`, `order_details`, `order_status`, `review_and_pay`, `payment_status`, `payment_method`, `track_order`, `reorder`, `cancel_order`, `clear_chat`, `navigateToScreen`, `flow_action`, `voice_call`, `video_call_button` — fully additive, existing button types untouched.
-- **System Notification Filtering** — Messages now carry an `isSystemNotification` flag (e.g. for E2E encryption notices, "business uses Meta service" notices) so bots can easily skip them without affecting normal message handling.
+---
 
-### ✅ Inherited from `@itsliaaa/baileys`
-- Interactive messages (buttons, list, native flow, carousel)
-- Album message (multi image/video)
-- Group Status message (`groupStatus: true`)
-- `mentionAll` without listing JIDs
-- `makeInMemoryStore` ESM port
-- Rich response, code blocks, tables, inline entities
-- Sticker pack, lottie sticker, spoiler, view once v2
-- Newsletter fixes, `externalAdReply` helper
-- `findUserId` for JID/LID lookup
-- `tokenizeCode` for syntax highlighting
+# 📦 Installation
 
-### ✅ Inherited from `@whiskeysockets/baileys`
-- LID/PN session management & mapping
-- Reachout timelock handling
-- New chat message cap
-- `validateSession` checks
-- `fetchNewChatMessageCap`, `fetchAccountReachoutTimelock`
+```bash
+npm install @vanzxy/baileys
+```
 
-## 📥 Installation
+GitHub:
 
 ```bash
-# Via npm
-npm i @vanzxy/baileys
-
-# Via GitHub
-npm i github:vanzxy/baileys
+npm install github:vanzxy/baileys
 ```
 
-## 🧩 Import
+---
+
+# 🚀 Quick Start
 
 ```js
-// ESM
 import { makeWASocket } from '@vanzxy/baileys'
+
+const sock = makeWASocket({
+    printQRInTerminal: true
+})
 ```
 
-## 📦 Fork Base
+---
+
+# 🛠 Recommended Environment
+
+- Node.js 18+
+- ESM Project
+- Latest WhatsApp Multi Device
+
+---
+
+# 📚 Fork Lineage
+
+@vanzxy/baileys
+└── @itsliaaa/baileys
+    └── WhiskeySockets/Baileys
+
+Respect to all original maintainers and contributors.
+
+---
+
+# 👑 Maintainer
+
+**Vanzxy**
+
+GitHub:
+https://github.com/vanzxy
+
+Package:
+@vanzxy/baileys
+
+---
 
-- [`@itsliaaa/baileys`](https://github.com/itsliaaa/baileys)
-- [`@whiskeysockets/baileys`](https://github.com/WhiskeySockets/Baileys)
+# ⚠️ Disclaimer
 
-## 📣 Credits
+This project is an independent fork.
+Use responsibly and follow WhatsApp Terms of Service.
 
-Full credit to original maintainers:
-- [purpshell](https://github.com/purpshell), [jlucaso1](https://github.com/jlucaso1), [adiwajshing](https://github.com/adiwajshing) — WhiskeySockets/Baileys
-- [Lia Wynn (itsliaaa)](https://github.com/itsliaaa) — @itsliaaa/baileys
+---
 
-Fixes & fork by **Vanzxy🍃 (VanzxyPrst🍃)** — [github.com/vanzxy](https://github.com/vanzxy)
+Made with 🍃 by Vanzxy

package/lib/Defaults/index.js

@@ -8,8 +8,8 @@ export const BIZ_BOT_SUPPORT_PAYLOAD = '{"version":1,"is_ai_message":true,"shoul
 export const DEFAULT_ORIGIN = 'https://web.whatsapp.com';
 export const CALL_VIDEO_PREFIX = 'https://call.whatsapp.com/video/';
 export const CALL_AUDIO_PREFIX = 'https://call.whatsapp.com/voice/';
-export const DONATE_URL = 'https://saweria.co/itsliaaa'; // Lia@Note 02-02-26 --- Apologies if this feels cheeky, just a fallback
-export const LIBRARY_NAME = 'itsliaaa/baileys';
+export const DONATE_URL = ''; // Vanz@Fix: cleared itsliaaa's donate URL fallback
+export const LIBRARY_NAME = 'vanzxy/baileys';
 export const DEF_CALLBACK_PREFIX = 'CB:';
 export const DEF_TAG_PREFIX = 'TAG:';
 export const PHONE_CONNECTION_CB = 'CB:Pong';
@@ -70,8 +70,12 @@ export const DEFAULT_CONNECTION_CONFIG = {
         return syncType !== proto.HistorySync.HistorySyncType.FULL;
     },
     shouldIgnoreJid: () => false,
-    linkPreviewImageThumbnailWidth: 192,
+    linkPreviewImageThumbnailWidth: 480, // Vanz@Fix: was 192 — too small, bumped to 480
     transactionOpts: { maxCommitRetries: 10, delayBetweenTriesMs: 3000 },
+    eventBufferTimeoutMs: 30000, // Vanz@Fix (bug 25): configurable — increase if bot is heavy load
+    statusBroadcastDelayMs: 1500, // Vanz@Fix (bug 5): configurable delay between status broadcasts — default 1500ms
+    albumDelayMs: 1500, // Vanz@Fix (bug 5): configurable delay between album message sends — default 1500ms
+    phashRetryEnabled: false, // Vanz@Fix (bug 54/55): enable phash retry on ack (caution: can cause loops if not careful)
     generateHighQualityLinkPreview: true,
     enableAutoSessionRecreation: true,
     enableRecentMessageCache: true,
@@ -81,6 +85,9 @@ export const DEFAULT_CONNECTION_CONFIG = {
         snapshot: false
     },
     countryCode: 'US',
+    // Vanz@Fix (bug 15): default returns undefined — every retry request will fail unless overridden.
+    // Override this in your makeWASocket config to return messages from your store:
+    //   getMessage: async (key) => store.loadMessage(key.remoteJid, key.id)?.message
     getMessage: async () => undefined,
     cachedGroupMetadata: async () => undefined,
     makeSignalRepository: makeLibSignalRepository