violetics 7.0.0-alpha

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 xhclinton
+
+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,318 @@
+<div align="center">
+  <h1>🌟 Violetics Baileys</h1>
+  <p><i>A professionally enhanced, feature-rich version of the Baileys WhatsApp Web API</i></p>
+
+  [![npm version](https://img.shields.io/npm/v/violetics.svg?style=for-the-badge)](https://www.npmjs.com/package/violetics)
+  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](LICENSE)
+</div>
+
+<br/>
+
+Built for developers requiring robust WhatsApp automation with modern tooling, enhanced stability, and comprehensive documentation to handle **Hundreds of Sessions (Multi-Device)** concurrently using **SQLite**.
+
+---
+
+## 📋 Table of Contents
+
+- [✨ Features](#-features)
+- [📦 Installation](#-installation)
+- [🚀 Quick Start](#-quick-start)
+- [🔌 Connection & Configuration](#-connection--configuration)
+- [💾 Handling Hundreds of Sessions (SQLite)](#-handling-hundreds-of-sessions-sqlite)
+- [📥 Core Features (Messages, Groups, Profile)](#-core-features)
+- [⚖️ Legal Notice](#️-legal-notice)
+
+---
+
+## ✨ Features
+
+- 🚀 **Modern & Fast** – Built with TypeScript and latest technologies.
+- 🔧 **Production Ready Stability** – Modified Web Socket client configurations, custom ping/pong keep-alives, and connection limits removed to prevent random logouts.
+- 📱 **Multi-Device Support** – Full support for WhatsApp's multi-device protocol.
+- 🔐 **End-to-End Encryption** – Secure communication using Signal Protocol.
+- 📨 **All Message Types** – Support for text, media, documents, contacts, locations, polls, reactions, and more.
+- 👥 **Advanced Group Management** – Comprehensive controls including unique group status support.
+- 🛠️ **Developer Friendly** – Clean API, extensive examples, and detailed documentation.
+
+---
+
+## 📦 Installation
+
+### Via NPM
+```bash
+npm install violetics
+```
+
+### Via GitHub
+```bash
+npm install github:cv3inx/violetics.git
+```
+
+---
+
+## 🚀 Quick Start
+
+Here is a basic example to get you connected and listening to messages using standard File Authentication.
+
+```javascript
+const { makeWASocket, useMultiFileAuthState, DisconnectReason } = require('violetics');
+const { Boom } = require('@hapi/boom');
+
+async function connectToWhatsApp() {
+    const { state, saveCreds } = await useMultiFileAuthState('auth_info_baileys');
+    
+    const sock = makeWASocket({
+        auth: state,
+        printQRInTerminal: true,
+        browser: ["Ubuntu", "Chrome", "125"],
+    });
+
+    sock.ev.on('connection.update', (update) => {
+        const { connection, lastDisconnect } = update;
+        if (connection === 'close') {
+            const shouldReconnect = (lastDisconnect?.error)?.output?.statusCode !== DisconnectReason.loggedOut;
+            console.log('Connection closed. Reconnecting:', shouldReconnect);
+            if (shouldReconnect) connectToWhatsApp();
+        } else if (connection === 'open') {
+            console.log('✅ Successfully connected to WhatsApp!');
+        }
+    });
+
+    sock.ev.on('messages.upsert', async ({ messages }) => {
+        const m = messages[0];
+        if (!m.message || m.key.fromMe) return;
+        
+        // Auto-reply example
+        if (m.message.conversation === 'ping') {
+            await sock.sendMessage(m.key.remoteJid, { text: 'pong!' });
+        }
+    });
+
+    // Save credentials when updated (debounced by default in this library)
+    sock.ev.on('creds.update', saveCreds);
+}
+
+connectToWhatsApp();
+```
+
+---
+
+## 🔌 Connection & Configuration
+
+### Connect via Pairing Code (No QR)
+
+If you're running the bot on a remote server without a terminal, you can pair using an 8-digit code instead of scanning a QR code.
+
+```javascript
+const sock = makeWASocket({ printQRInTerminal: false });
+
+if (!sock.authState.creds.registered) {
+    const phoneNumber = '1234567890'; // Include country code, no symbols
+    const pairingCode = await sock.requestPairingCode(phoneNumber);
+    console.log('🔑 Your Pairing Code:', pairingCode);
+}
+```
+
+---
+
+## 💾 Handling Hundreds of Sessions (SQLite)
+
+Jika target Anda adalah merender **Ratusan Bot secara bersamaan** dalam 1 Node.js Process, **file JSON biasa sangat tidak dianjurkan** karena rentan lock-file race condition dan limitasi sinkronisasi disk I/O, yang memicu masalah `Connection Closed` atau `DisconnectReason.loggedOut` tiba-tiba karena Socket API kehabisan waktu memanggil Event Emitter.
+
+Gunakan **SQLite** untuk auth *Multi-Session* dengan tiga aturan vital:
+
+### 1. Gunakan Mode SQLite `WAL`
+SQLite biasanya mengunci database saat sedang diproses (*Database is locked*). Untuk mematikan lock tersebut, pastikan perintah ini selalu berjalan di koneksi pertama inisialisasi SQLite Anda:
+```sql
+PRAGMA journal_mode=WAL;
+PRAGMA synchronous=NORMAL;
+PRAGMA cache_size=-64000;
+```
+
+### 2. Hindari `Sync` Database Queries
+Menggunakan fungsi bawaan `better-sqlite3` dengan eksekusi *sync* (seperti `db.prepare(query).run()`) dapat mem-blok *event loop* Node.js untuk mengeksekusi *callback* dari lib WhatsApp, menyebabkan ping-pong timeout.  
+Gunakan pendekatan koneksi SQLite *asynchronous* (`async/await`) atau *Worker Threads*.
+
+### 3. Gunakan `addTransactionCapability`
+Ratusan WhatsApp session menghasilkan jutaan Signal Keys selama pertukaran PreKey login. Menyimpan data satu-per-satu ke SQLite secara harfiah akan merusak login sinkronisasi Anda! Anda diwajibkan menggunakan pembungkus Native `addTransactionCapability` yang terdapat dalam library ini.
+
+**Contoh Template Asinkron Auth Bot SQLite:**
+```javascript
+const { addTransactionCapability, initAuthCreds } = require('violetics');
+
+// Membungkus Database Custom Anda ke Session Bot
+function makeSqliteAuthState(dbConnection, sessionId) {
+    const state = {
+        get: async (type, ids) => {
+            // TODO: Ambil row dari tabel session secara `async`
+            // return dict { [id]: data }
+        },
+        set: async (data) => {
+            // TODO: Insert/Update row ke tabel SQLite secara `async`
+        }
+    };
+
+    // WAJIB: Membungkus transaksi Anda agar dieksekusi dalam bentuk 'Batch' 
+    // Setiap transaksi Signal WhatsApp akan disimpan 100 sekaligus tanpa spam query DB
+    const keys = addTransactionCapability(state, console, {
+        maxCommitRetries: 10,
+        delayBetweenTriesMs: 3000
+    });
+
+    return {
+        state: {
+            creds: /* creds dari database dbConnection */,
+            keys
+        },
+        saveCreds: () => {
+            // Simpan perubahan kredensial
+            // Sebaiknya Anda buat fungsi "Debounce" disini selama 2 detik
+            // agar tidak menyebabkan CPU Spike saat Login Pertama Kali
+        }
+    }
+}
+```
+
+---
+
+## 📥 Core Features
+
+<details>
+<summary><b>📤 Sending Messages</b></summary>
+<br>
+
+```javascript
+// 1. Text message
+await sock.sendMessage(jid, { text: 'Hello World!' });
+
+// 2. Mention users
+await sock.sendMessage(jid, {
+    text: 'Hello @12345678901!',
+    mentions: ['12345678901@s.whatsapp.net']
+});
+
+// 3. Send Media (Image)
+await sock.sendMessage(jid, {
+    image: { url: './path/to/image.jpg' },
+    caption: 'Check out this image!'
+});
+
+// 4. Send Poll
+await sock.sendMessage(jid, {
+    poll: {
+        name: 'Favorite Language?',
+        values: ['TypeScript', 'Python', 'Go'],
+        selectableCount: 1
+    }
+});
+```
+</details>
+
+<details>
+<summary><b>👥 Group Management</b></summary>
+<br>
+
+```javascript
+// 1. Create a group
+const group = await sock.groupCreate('My Developer Group', ['123...@s.whatsapp.net']);
+
+// 2. Modify participants (Add, Remove, Promote)
+await sock.groupParticipantsUpdate(groupJid, ['123...@s.whatsapp.net'], 'add');
+
+// 3. Update Group Info
+await sock.groupUpdateSubject(groupJid, 'New Amazing Name');
+await sock.groupUpdateDescription(groupJid, 'New description for the group');
+```
+</details>
+
+<details>
+<summary><b>📢 Newsletter (Channels) API</b></summary>
+<br>
+
+Full support for WhatsApp Newsletters (Channels). Manage, fetch, and react to channel updates!
+
+```javascript
+// 1. Fetch Newsletter by Invitelink/URL
+const channelData = await sock.newsletterFromUrl('https://whatsapp.com/channel/0029...');
+
+// 2. Follow / Unfollow a Channel
+await sock.newsletterFollow(channelJid);
+await sock.newsletterUnfollow(channelJid);
+
+// 3. Mute / Unmute
+await sock.newsletterMute(channelJid);
+await sock.newsletterUnmute(channelJid);
+
+// 4. Create a new Channel
+const newChannel = await sock.newsletterCreate('My Channel', 'Description here', 'ALL');
+
+// 5. Fetch Subscribed Channels & Messages
+const mySubscriptions = await sock.newsletterFetchAllSubscribe();
+console.log(mySubscriptions); // List of your followed newsletters
+
+const messages = await sock.newsletterFetchMessages('get', channelJid, 50);
+
+// 6. Update Channel Info
+await sock.newsletterUpdateName(channelJid, 'New Name');
+await sock.newsletterUpdateDescription(channelJid, 'New Description');
+await sock.newsletterUpdatePicture(channelJid, buffer);
+```
+</details>
+
+<details>
+<summary><b>✨ Advanced Messages (Violetics)</b></summary>
+<br>
+
+Violetics implements advanced parsing and sending for native flow menus, albums, events, and unique status interactions directly through the `sock` instance!
+
+```javascript
+// 1. Send Interactive Message (Buttons & Media)
+const interactive = await sock.handleInteractive(jid, {
+    interactiveMessage: {
+        title: "Main Menu",
+        footer: "Powered by Violetics",
+        header: "Select an option",
+        buttons: [
+            { name: 'quick_reply', buttonParamsJson: '{"display_text":"Option 1","id":"opt1"}' },
+            { name: 'cta_url', buttonParamsJson: '{"display_text":"Visit Site","url":"https://example.com"}' }
+        ]
+    }
+}, { quoted: messageObject }); // Pass quoting using the `options` object
+
+await sock.relayMessage(jid, interactive.interactiveMessage, {});
+
+// 2. Send Album (Multiple Media)
+await sock.handleAlbum(jid, [
+    { image: { url: './image1.jpg' } },
+    { video: { url: './video1.mp4' } }
+]);
+
+// 3. Send Group / Private WhatsApp Status with Mentions
+await sock.sendStatusWhatsApp(['12345678901@s.whatsapp.net', '12345678902-1234@g.us'], {
+    text: "Check out this status!",
+    backgroundColor: "#ff0000",
+    font: 1
+});
+
+// 4. Handle External Ad Replies, Payments, and Events natively!
+await sock.handleEvent(jid, {
+    eventMessage: {
+        name: "Developer Meetup",
+        description: "Join us for coding!",
+        joinLink: "https://zoom.us/...",
+        startTime: Date.now(),
+        endTime: Date.now() + 3600000
+    }
+});
+```
+</details>
+
+---
+
+## ⚖️ Legal Notice
+
+**Disclaimer**: This project is **NOT** affiliated with, authorized, maintained, sponsored, or endorsed by WhatsApp LLC or any of its affiliates. 
+- This library is intended for strictly legitimate automation purposes.
+- Do **NOT** use it for spamming, bulk reporting, or harassment.
+- Users are solely responsible for compliance with WhatsApp's Terms of Service. 
+- The maintainers assume **NO** liability for any damages, legal actions, or account bans caused by the use of this software.