vezxa-baileys 1.0.0

package/LICENSE

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

package/README.md

@@ -0,0 +1,68 @@
+# ⚡ VEZXA-BAILEYS
+
+> WhatsApp Web API Library - Socket-based TypeScript/JavaScript
+
+[![npm version](https://img.shields.io/npm/v/vezxa-baileys.svg)](https://www.npmjs.com/package/vezxa-baileys)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+---
+
+## 🚀 Installation
+
+```bash
+npm install vezxa-baileys
+```
+```bash
+yarn add vezxa-baileys
+```
+
+## 📖 Quick Start
+
+```typescript
+import { connectToWhatsApp } from 'vezxa-baileys'
+
+const { sock } = await connectToWhatsApp({
+  printQRInTerminal: true
+})
+```
+
+## ✨ Features
+
+- ✅ QR Code & Pairing Code connection
+- ✅ Send/Receive all message types (text, image, video, audio, gif, sticker, location, contact, poll, reaction, pin)
+- ✅ View Once messages
+- ✅ Link Preview
+- ✅ Delete & Edit messages
+- ✅ Download & Re-upload media
+- ✅ Full group management
+- ✅ Privacy settings
+- ✅ Profile management
+- ✅ Broadcast & Stories
+- ✅ Chat modifications (archive, mute, pin, star, disappearing)
+- ✅ User queries (presence, status, profile picture, business profile)
+- ✅ Reject calls
+- ✅ Debug logs
+- ✅ Session persistence
+- ✅ Multi-device support
+- ✅ In-memory store
+
+## 📚 Documentation
+
+Full documentation: [baileys.vezxa.com](https://baileys.vezxa.com)
+
+## 👤 Author
+
+**EMPEROR SUKUNA**
+
+- 📸 Instagram: [j.m.h.2024](https://instagram.com/j.m.h.2024)
+- 🐙 GitHub: [SUKUNA6999](https://github.com/SUKUNA6999)
+- 💬 WhatsApp: [+1 (904) 514-6724](https://wa.me/19045146724)
+- 🌐 Website: [baileys.vezxa.com](https://baileys.vezxa.com)
+
+## ⚠️ Disclaimer
+
+This project is not affiliated with WhatsApp. Use at your own risk and responsibility.
+
+## 📄 License
+
+MIT © EMPEROR SUKUNA

package/lib/broadcast.d.ts

@@ -0,0 +1,35 @@
+import { WASocket, AnyMessageContent, WAMessage } from '@whiskeysockets/baileys';
+/**
+ * Send a message to a broadcast list or as a story (status update).
+ * @param sock - The Baileys socket
+ * @param jid - The broadcast list JID or 'status@broadcast' for stories
+ * @param content - The message content to broadcast
+ * @param options - Additional send options (e.g., statusJidList for stories)
+ */
+export declare function sendBroadcast(sock: WASocket, jid: string, content: AnyMessageContent, options?: {
+    statusJidList?: string[];
+}): Promise<WAMessage | undefined>;
+/**
+ * Send a WhatsApp story (status update) visible to specified contacts.
+ * @param sock - The Baileys socket
+ * @param content - The story content (image, video, or text message)
+ * @param statusJidList - Array of contact JIDs who can see this story
+ * @param options - Additional send options
+ */
+export declare function sendStory(sock: WASocket, content: AnyMessageContent, statusJidList: string[], options?: Record<string, unknown>): Promise<WAMessage | undefined>;
+/**
+ * Get information about a broadcast list.
+ * @param sock - The Baileys socket
+ * @param broadcastId - The broadcast list JID
+ * @returns The broadcast list metadata
+ */
+export declare function getBroadcastListInfo(sock: WASocket, broadcastId: string): Promise<import('@whiskeysockets/baileys').GroupMetadata>;
+/**
+ * Query message history for a chat (up to 50 messages per request).
+ * @param sock - The Baileys socket
+ * @param jid - The chat JID
+ * @param oldestMessage - The oldest message already known (used as cursor)
+ * @param count - Number of messages to fetch (max 50)
+ */
+export declare function queryMessageHistory(sock: WASocket, jid: string, oldestMessage: WAMessage, count: number): Promise<void>;
+//# sourceMappingURL=broadcast.d.ts.map

package/lib/broadcast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcast.d.ts","sourceRoot":"","sources":["../src/broadcast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,SAAS,EAAiB,MAAM,yBAAyB,CAAA;AAE/F;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,iBAAiB,EAC1B,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GACrC,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAOhC;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,iBAAiB,EAC1B,aAAa,EAAE,MAAM,EAAE,EACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAWhC;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,QAAQ,EACd,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,yBAAyB,EAAE,aAAa,CAAC,CAO1D;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,SAAS,EACxB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAQf"}

package/lib/broadcast.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendBroadcast = sendBroadcast;
+exports.sendStory = sendStory;
+exports.getBroadcastListInfo = getBroadcastListInfo;
+exports.queryMessageHistory = queryMessageHistory;
+/**
+ * Send a message to a broadcast list or as a story (status update).
+ * @param sock - The Baileys socket
+ * @param jid - The broadcast list JID or 'status@broadcast' for stories
+ * @param content - The message content to broadcast
+ * @param options - Additional send options (e.g., statusJidList for stories)
+ */
+async function sendBroadcast(sock, jid, content, options) {
+    try {
+        return await sock.sendMessage(jid, content, options);
+    }
+    catch (err) {
+        console.error('[sendBroadcast] Error:', err);
+        throw err;
+    }
+}
+/**
+ * Send a WhatsApp story (status update) visible to specified contacts.
+ * @param sock - The Baileys socket
+ * @param content - The story content (image, video, or text message)
+ * @param statusJidList - Array of contact JIDs who can see this story
+ * @param options - Additional send options
+ */
+async function sendStory(sock, content, statusJidList, options) {
+    try {
+        return await sock.sendMessage('status@broadcast', content, { statusJidList, ...options });
+    }
+    catch (err) {
+        console.error('[sendStory] Error:', err);
+        throw err;
+    }
+}
+/**
+ * Get information about a broadcast list.
+ * @param sock - The Baileys socket
+ * @param broadcastId - The broadcast list JID
+ * @returns The broadcast list metadata
+ */
+async function getBroadcastListInfo(sock, broadcastId) {
+    try {
+        return await sock.groupMetadata(broadcastId);
+    }
+    catch (err) {
+        console.error('[getBroadcastListInfo] Error:', err);
+        throw err;
+    }
+}
+/**
+ * Query message history for a chat (up to 50 messages per request).
+ * @param sock - The Baileys socket
+ * @param jid - The chat JID
+ * @param oldestMessage - The oldest message already known (used as cursor)
+ * @param count - Number of messages to fetch (max 50)
+ */
+async function queryMessageHistory(sock, jid, oldestMessage, count) {
+    try {
+        const safeCount = Math.min(count, 50);
+        await sock.fetchMessageHistory(safeCount, oldestMessage.key, oldestMessage.messageTimestamp);
+    }
+    catch (err) {
+        console.error('[queryMessageHistory] Error:', err);
+        throw err;
+    }
+}
+//# sourceMappingURL=broadcast.js.map

package/lib/broadcast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcast.js","sourceRoot":"","sources":["../src/broadcast.ts"],"names":[],"mappings":";;AASA,sCAYC;AASD,8BAgBC;AAQD,oDAUC;AASD,kDAaC;AApFD;;;;;;GAMG;AACI,KAAK,UAAU,aAAa,CACjC,IAAc,EACd,GAAW,EACX,OAA0B,EAC1B,OAAsC;IAEtC,IAAI,CAAC;QACH,OAAO,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IACtD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,GAAG,CAAC,CAAA;QAC5C,MAAM,GAAG,CAAA;IACX,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,SAAS,CAC7B,IAAc,EACd,OAA0B,EAC1B,aAAuB,EACvB,OAAiC;IAEjC,IAAI,CAAC;QACH,OAAO,MAAM,IAAI,CAAC,WAAW,CAC3B,kBAAkB,EAClB,OAAO,EACP,EAAE,aAAa,EAAE,GAAG,OAAO,EAAE,CAC9B,CAAA;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,oBAAoB,EAAE,GAAG,CAAC,CAAA;QACxC,MAAM,GAAG,CAAA;IACX,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,oBAAoB,CACxC,IAAc,EACd,WAAmB;IAEnB,IAAI,CAAC;QACH,OAAO,MAAM,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,CAAA;IAC9C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAE,GAAG,CAAC,CAAA;QACnD,MAAM,GAAG,CAAA;IACX,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,mBAAmB,CACvC,IAAc,EACd,GAAW,EACX,aAAwB,EACxB,KAAa;IAEb,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;QACrC,MAAM,IAAI,CAAC,mBAAmB,CAAC,SAAS,EAAE,aAAa,CAAC,GAAG,EAAE,aAAa,CAAC,gBAA0B,CAAC,CAAA;IACxG,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,GAAG,CAAC,CAAA;QAClD,MAAM,GAAG,CAAA;IACX,CAAC;AACH,CAAC"}

package/lib/chat.d.ts

@@ -0,0 +1,100 @@
+import { WASocket, WAMessage } from '@whiskeysockets/baileys';
+/**
+ * Archive a chat.
+ * @param sock - The Baileys socket
+ * @param jid - The chat JID to archive
+ * @param lastMessage - The last message in the chat
+ */
+export declare function archiveChat(sock: WASocket, jid: string, lastMessage: WAMessage): Promise<void>;
+/**
+ * Unarchive a previously archived chat.
+ * @param sock - The Baileys socket
+ * @param jid - The chat JID to unarchive
+ * @param lastMessage - The last message in the chat
+ */
+export declare function unarchiveChat(sock: WASocket, jid: string, lastMessage: WAMessage): Promise<void>;
+/**
+ * Mute a chat for a specified duration.
+ * @param sock - The Baileys socket
+ * @param jid - The chat JID to mute
+ * @param duration - Mute duration in milliseconds (e.g., 28800000 = 8h, 604800000 = 7d)
+ */
+export declare function muteChat(sock: WASocket, jid: string, duration: number): Promise<void>;
+/**
+ * Unmute a muted chat.
+ * @param sock - The Baileys socket
+ * @param jid - The chat JID to unmute
+ */
+export declare function unmuteChat(sock: WASocket, jid: string): Promise<void>;
+/**
+ * Mark a chat as read.
+ * @param sock - The Baileys socket
+ * @param jid - The chat JID
+ * @param lastMessage - The last message in the chat
+ */
+export declare function markChatRead(sock: WASocket, jid: string, lastMessage: WAMessage): Promise<void>;
+/**
+ * Mark a chat as unread.
+ * @param sock - The Baileys socket
+ * @param jid - The chat JID
+ * @param lastMessage - The last message in the chat
+ */
+export declare function markChatUnread(sock: WASocket, jid: string, lastMessage: WAMessage): Promise<void>;
+/**
+ * Delete a specific message only for yourself (not for everyone).
+ * @param sock - The Baileys socket
+ * @param jid - The chat JID
+ * @param messageId - The ID of the message to delete
+ * @param fromMe - Whether the message was sent by you
+ * @param timestamp - The timestamp of the message
+ */
+export declare function deleteMessageForMe(sock: WASocket, jid: string, messageId: string, fromMe: boolean, timestamp: number): Promise<void>;
+/**
+ * Delete an entire chat from the chat list.
+ * @param sock - The Baileys socket
+ * @param jid - The chat JID to delete
+ * @param lastMessage - The last message in the chat
+ */
+export declare function deleteChat(sock: WASocket, jid: string, lastMessage: WAMessage): Promise<void>;
+/**
+ * Pin a chat to the top of the chat list.
+ * @param sock - The Baileys socket
+ * @param jid - The chat JID to pin
+ */
+export declare function pinChat(sock: WASocket, jid: string): Promise<void>;
+/**
+ * Unpin a pinned chat.
+ * @param sock - The Baileys socket
+ * @param jid - The chat JID to unpin
+ */
+export declare function unpinChat(sock: WASocket, jid: string): Promise<void>;
+/**
+ * Star (favourite) a specific message.
+ * @param sock - The Baileys socket
+ * @param jid - The chat JID
+ * @param messageId - The ID of the message to star
+ * @param fromMe - Whether the message was sent by you
+ */
+export declare function starMessage(sock: WASocket, jid: string, messageId: string, fromMe: boolean): Promise<void>;
+/**
+ * Remove a star from a previously starred message.
+ * @param sock - The Baileys socket
+ * @param jid - The chat JID
+ * @param messageId - The ID of the message to unstar
+ * @param fromMe - Whether the message was sent by you
+ */
+export declare function unstarMessage(sock: WASocket, jid: string, messageId: string, fromMe: boolean): Promise<void>;
+/**
+ * Enable disappearing messages in a chat.
+ * @param sock - The Baileys socket
+ * @param jid - The chat JID
+ * @param expiration - Expiration in seconds: 86400 (24h), 604800 (7d), 7776000 (90d)
+ */
+export declare function setDisappearingMessages(sock: WASocket, jid: string, expiration: 86400 | 604800 | 7776000): Promise<void>;
+/**
+ * Disable disappearing messages in a chat.
+ * @param sock - The Baileys socket
+ * @param jid - The chat JID
+ */
+export declare function disableDisappearingMessages(sock: WASocket, jid: string): Promise<void>;
+//# sourceMappingURL=chat.d.ts.map

package/lib/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../src/chat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAE7D;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,SAAS,GACrB,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,SAAS,GACrB,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,SAAS,GACrB,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,SAAS,GACrB,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,SAAS,GACrB,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;;;GAIG;AACH,wBAAsB,OAAO,CAC3B,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GACnC,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;;GAIG;AACH,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/lib/chat.js

@@ -0,0 +1,233 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.archiveChat = archiveChat;
+exports.unarchiveChat = unarchiveChat;
+exports.muteChat = muteChat;
+exports.unmuteChat = unmuteChat;
+exports.markChatRead = markChatRead;
+exports.markChatUnread = markChatUnread;
+exports.deleteMessageForMe = deleteMessageForMe;
+exports.deleteChat = deleteChat;
+exports.pinChat = pinChat;
+exports.unpinChat = unpinChat;
+exports.starMessage = starMessage;
+exports.unstarMessage = unstarMessage;
+exports.setDisappearingMessages = setDisappearingMessages;
+exports.disableDisappearingMessages = disableDisappearingMessages;
+/**
+ * Archive a chat.
+ * @param sock - The Baileys socket
+ * @param jid - The chat JID to archive
+ * @param lastMessage - The last message in the chat
+ */
+async function archiveChat(sock, jid, lastMessage) {
+    try {
+        await sock.chatModify({ archive: true, lastMessages: [lastMessage] }, jid);
+    }
+    catch (err) {
+        console.error('[archiveChat] Error:', err);
+        throw err;
+    }
+}
+/**
+ * Unarchive a previously archived chat.
+ * @param sock - The Baileys socket
+ * @param jid - The chat JID to unarchive
+ * @param lastMessage - The last message in the chat
+ */
+async function unarchiveChat(sock, jid, lastMessage) {
+    try {
+        await sock.chatModify({ archive: false, lastMessages: [lastMessage] }, jid);
+    }
+    catch (err) {
+        console.error('[unarchiveChat] Error:', err);
+        throw err;
+    }
+}
+/**
+ * Mute a chat for a specified duration.
+ * @param sock - The Baileys socket
+ * @param jid - The chat JID to mute
+ * @param duration - Mute duration in milliseconds (e.g., 28800000 = 8h, 604800000 = 7d)
+ */
+async function muteChat(sock, jid, duration) {
+    try {
+        await sock.chatModify({ mute: duration }, jid);
+    }
+    catch (err) {
+        console.error('[muteChat] Error:', err);
+        throw err;
+    }
+}
+/**
+ * Unmute a muted chat.
+ * @param sock - The Baileys socket
+ * @param jid - The chat JID to unmute
+ */
+async function unmuteChat(sock, jid) {
+    try {
+        await sock.chatModify({ mute: null }, jid);
+    }
+    catch (err) {
+        console.error('[unmuteChat] Error:', err);
+        throw err;
+    }
+}
+/**
+ * Mark a chat as read.
+ * @param sock - The Baileys socket
+ * @param jid - The chat JID
+ * @param lastMessage - The last message in the chat
+ */
+async function markChatRead(sock, jid, lastMessage) {
+    try {
+        await sock.chatModify({ markRead: true, lastMessages: [lastMessage] }, jid);
+    }
+    catch (err) {
+        console.error('[markChatRead] Error:', err);
+        throw err;
+    }
+}
+/**
+ * Mark a chat as unread.
+ * @param sock - The Baileys socket
+ * @param jid - The chat JID
+ * @param lastMessage - The last message in the chat
+ */
+async function markChatUnread(sock, jid, lastMessage) {
+    try {
+        await sock.chatModify({ markRead: false, lastMessages: [lastMessage] }, jid);
+    }
+    catch (err) {
+        console.error('[markChatUnread] Error:', err);
+        throw err;
+    }
+}
+/**
+ * Delete a specific message only for yourself (not for everyone).
+ * @param sock - The Baileys socket
+ * @param jid - The chat JID
+ * @param messageId - The ID of the message to delete
+ * @param fromMe - Whether the message was sent by you
+ * @param timestamp - The timestamp of the message
+ */
+async function deleteMessageForMe(sock, jid, messageId, fromMe, timestamp) {
+    try {
+        await sock.chatModify({
+            deleteForMe: {
+                deleteMedia: false,
+                key: { id: messageId, fromMe, remoteJid: jid },
+                timestamp,
+            },
+        }, jid);
+    }
+    catch (err) {
+        console.error('[deleteMessageForMe] Error:', err);
+        throw err;
+    }
+}
+/**
+ * Delete an entire chat from the chat list.
+ * @param sock - The Baileys socket
+ * @param jid - The chat JID to delete
+ * @param lastMessage - The last message in the chat
+ */
+async function deleteChat(sock, jid, lastMessage) {
+    try {
+        await sock.chatModify({ delete: true, lastMessages: [lastMessage] }, jid);
+    }
+    catch (err) {
+        console.error('[deleteChat] Error:', err);
+        throw err;
+    }
+}
+/**
+ * Pin a chat to the top of the chat list.
+ * @param sock - The Baileys socket
+ * @param jid - The chat JID to pin
+ */
+async function pinChat(sock, jid) {
+    try {
+        await sock.chatModify({ pin: true }, jid);
+    }
+    catch (err) {
+        console.error('[pinChat] Error:', err);
+        throw err;
+    }
+}
+/**
+ * Unpin a pinned chat.
+ * @param sock - The Baileys socket
+ * @param jid - The chat JID to unpin
+ */
+async function unpinChat(sock, jid) {
+    try {
+        await sock.chatModify({ pin: false }, jid);
+    }
+    catch (err) {
+        console.error('[unpinChat] Error:', err);
+        throw err;
+    }
+}
+/**
+ * Star (favourite) a specific message.
+ * @param sock - The Baileys socket
+ * @param jid - The chat JID
+ * @param messageId - The ID of the message to star
+ * @param fromMe - Whether the message was sent by you
+ */
+async function starMessage(sock, jid, messageId, fromMe) {
+    try {
+        await sock.chatModify({ star: { messages: [{ id: messageId, fromMe }], star: true } }, jid);
+    }
+    catch (err) {
+        console.error('[starMessage] Error:', err);
+        throw err;
+    }
+}
+/**
+ * Remove a star from a previously starred message.
+ * @param sock - The Baileys socket
+ * @param jid - The chat JID
+ * @param messageId - The ID of the message to unstar
+ * @param fromMe - Whether the message was sent by you
+ */
+async function unstarMessage(sock, jid, messageId, fromMe) {
+    try {
+        await sock.chatModify({ star: { messages: [{ id: messageId, fromMe }], star: false } }, jid);
+    }
+    catch (err) {
+        console.error('[unstarMessage] Error:', err);
+        throw err;
+    }
+}
+/**
+ * Enable disappearing messages in a chat.
+ * @param sock - The Baileys socket
+ * @param jid - The chat JID
+ * @param expiration - Expiration in seconds: 86400 (24h), 604800 (7d), 7776000 (90d)
+ */
+async function setDisappearingMessages(sock, jid, expiration) {
+    try {
+        await sock.sendMessage(jid, { disappearingMessagesInChat: expiration });
+    }
+    catch (err) {
+        console.error('[setDisappearingMessages] Error:', err);
+        throw err;
+    }
+}
+/**
+ * Disable disappearing messages in a chat.
+ * @param sock - The Baileys socket
+ * @param jid - The chat JID
+ */
+async function disableDisappearingMessages(sock, jid) {
+    try {
+        await sock.sendMessage(jid, { disappearingMessagesInChat: false });
+    }
+    catch (err) {
+        console.error('[disableDisappearingMessages] Error:', err);
+        throw err;
+    }
+}
+//# sourceMappingURL=chat.js.map

package/lib/chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.js","sourceRoot":"","sources":["../src/chat.ts"],"names":[],"mappings":"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"}

package/lib/connection.d.ts

@@ -0,0 +1,51 @@
+import { useMultiFileAuthState, WASocket } from '@whiskeysockets/baileys';
+/** Options for connecting to WhatsApp via vezxa-baileys */
+export interface VezxaConnectionOptions {
+    /** Folder to store auth state. Default: 'auth_info_baileys' */
+    authFolder?: string;
+    /** Whether to print QR code in terminal. Default: true */
+    printQRInTerminal?: boolean;
+    /** Phone number to request a pairing code for (digits only, with country code) */
+    pairingCode?: string;
+    /** Sync full message history on connect. Default: false */
+    syncFullHistory?: boolean;
+    /** Mark the bot as online when connected. Default: true */
+    markOnlineOnConnect?: boolean;
+    /** Enable debug-level logging. Default: false */
+    debug?: boolean;
+    /** Browser identification tuple. Default: ['Vezxa-Baileys', 'Chrome', '1.0.0'] */
+    browser?: [string, string, string];
+}
+/**
+ * Connect to WhatsApp using vezxa-baileys.
+ *
+ * Supports QR code and pairing code authentication, automatic reconnection,
+ * session persistence, and group-metadata caching.
+ *
+ * @param options - Connection options
+ * @returns An object containing the active socket and the auth state saver
+ */
+export declare function connectToWhatsApp(options?: VezxaConnectionOptions): Promise<{
+    sock: WASocket;
+    saveCreds: () => Promise<void>;
+}>;
+/**
+ * Save the current WhatsApp session credentials.
+ *
+ * This is a convenience re-export; the `saveCreds` function returned by
+ * `connectToWhatsApp` already handles credential persistence automatically.
+ *
+ * @param saveCreds - The saveCreds callback from connectToWhatsApp
+ */
+export declare function saveSession(saveCreds: () => Promise<void>): Promise<void>;
+/**
+ * Restore a saved WhatsApp session from disk.
+ *
+ * @param authFolder - Path to the folder containing the auth state files
+ * @returns The restored auth state and saveCreds function
+ */
+export declare function restoreSession(authFolder?: string): Promise<{
+    state: Awaited<ReturnType<typeof useMultiFileAuthState>>['state'];
+    saveCreds: () => Promise<void>;
+}>;
+//# sourceMappingURL=connection.d.ts.map

package/lib/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"AAAA,OAAqB,EACnB,qBAAqB,EAGrB,QAAQ,EACT,MAAM,yBAAyB,CAAA;AAKhC,2DAA2D;AAC3D,MAAM,WAAW,sBAAsB;IACrC,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,2DAA2D;IAC3D,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,2DAA2D;IAC3D,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,iDAAiD;IACjD,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,kFAAkF;IAClF,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CACnC;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC,CAqF7D;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,UAAU,SAAsB,GAC/B,OAAO,CAAC;IAAE,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAAC,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC,CAOhH"}