whatsapp-cli-pro 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jack Williams
+
+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/index.js

@@ -0,0 +1,245 @@
+#!/usr/bin/env node
+const { Client, LocalAuth } = require('whatsapp-web.js');
+const qrcode = require('qrcode-terminal');
+const chalk = require('chalk');     
+const figlet = require('figlet');   
+const gradient = require('gradient-string'); 
+const boxen = require('boxen'); 
+const inquirer = require('inquirer'); 
+const notifier = require('node-notifier'); 
+
+// --- THEME CONFIGURATION ---
+const theme = {
+    logo: gradient('cyan', 'blue', 'magenta'),
+    text: chalk.cyanBright,
+    border: 'magenta',
+    wa: chalk.hex('#25D366'), 
+    warning: chalk.hex('#F7E01D'), 
+    dim: chalk.dim
+};
+
+const client = new Client({
+    authStrategy: new LocalAuth(),
+    puppeteer: { 
+        args: ['--no-sandbox'],
+        headless: true
+    }
+});
+
+// --- UTILS ---
+const sleep = (ms) => new Promise(r => setTimeout(r, ms));
+const clearScreen = () => console.clear();
+
+// --- DISPLAY COMPONENTS ---
+
+const showBanner = () => {
+    const bigTitle = figlet.textSync('WhatsApp - CLI', { 
+        font: 'ANSI Shadow', 
+        horizontalLayout: 'full' 
+    });
+    
+    console.log(theme.logo(bigTitle));
+    console.log(theme.dim('━'.repeat(65)));
+    console.log(gradient.pastel('  >> SECURE TERMINAL CONNECTION ESTABLISHED <<'));
+    console.log(theme.dim('━'.repeat(65)));
+};
+
+async function showBootSequence() {
+    clearScreen();
+    const steps = [
+        'Initializing core modules...',
+        'Bypassing local firewalls...',
+        'Decrypting session keys...',
+        'Connecting to WhatsApp servers...',
+        'Handshake successful.',
+        'Loading interface...'
+    ];
+
+    for (const step of steps) {
+        process.stdout.write(theme.text(`[SYSTEM] ${step}`));
+        await sleep(300); 
+        process.stdout.clearLine();
+        process.stdout.cursorTo(0);
+        console.log(chalk.green(`[OK] ${step}`));
+    }
+    await sleep(500);
+}
+
+// --- MAIN MENUS ---
+
+async function showMainMenu() {
+    clearScreen();
+    showBanner();
+    
+    // Info Bar
+    if (client.info) {
+        console.log(boxen(`${chalk.bold(client.info.pushname)} | ${client.info.wid.user} | Battery: ${await getBattery()}`, {
+            padding: 0, borderStyle: 'classic', borderColor: 'gray', dimBorder: true
+        }));
+    }
+
+    const answers = await inquirer.prompt([
+        {
+            type: 'list',
+            name: 'action',
+            message: theme.text('SELECT OPERATION >'),
+            choices: [
+                { name: '📨  Open Chat List', value: 'chat_list' },
+                { name: '📡  Broadcast / Manual', value: 'manual' },
+                { name: '❓  Help / Manual', value: 'help' }, 
+                { name: '❌  Terminate Session', value: 'exit' }
+            ]
+        }
+    ]);
+
+    handleMenu(answers.action);
+}
+
+async function handleMenu(action) {
+    switch(action) {
+        case 'chat_list': await showContactPicker(); break;
+        case 'manual': await manualInput(); break;
+        case 'help': await showHelpScreen(); break; 
+        case 'exit': 
+            console.log(chalk.red('Terminating...')); 
+            process.exit(0); 
+            break;
+    }
+}
+
+// --- HELP SCREEN ---
+async function showHelpScreen() {
+    clearScreen();
+    
+    const helpContent = `
+${chalk.bold.underline('NAVIGATION GUIDE')}
+• Use ${chalk.yellow('UP/DOWN')} arrow keys to navigate menus.
+• Press ${chalk.yellow('ENTER')} to select an option.
+
+${chalk.bold.underline('CHAT ROOM COMMANDS')}
+• Type your message and press ENTER to send.
+• Type ${theme.warning('"menu"')} (without quotes) to exit the chat room.
+
+${chalk.bold.underline('ICONS LEGEND')}
+📨 : Unread Messages / Chat List
+📡 : Manual Send (By typing number)
+❌ : Exit Application
+    `.trim();
+
+    console.log(boxen(helpContent, {
+        title: 'SYSTEM MANUAL',
+        titleAlignment: 'center',
+        borderStyle: 'double',
+        borderColor: 'cyan',
+        padding: 1,
+        margin: 1
+    }));
+
+    await inquirer.prompt([{ type: 'input', name: 'back', message: 'Press ENTER to return to Main Menu...' }]);
+    showMainMenu();
+}
+
+// --- CHAT FUNCTIONS ---
+
+async function getBattery() {
+    try {
+        const batt = await client.getInterface().getBatteryStatus();
+        return `${batt.battery}%`;
+    } catch (e) { return 'N/A'; }
+}
+
+async function showContactPicker() {
+    const chats = await client.getChats();
+    const recentChats = chats.slice(0, 12).map(chat => ({
+        name: `${chat.name} ${chat.unreadCount > 0 ? chalk.red(`(${chat.unreadCount})`) : ''}`,
+        value: chat.id._serialized
+    }));
+
+    recentChats.push(new inquirer.Separator());
+    recentChats.push({ name: '🔙 Back', value: 'back' });
+
+    const { id } = await inquirer.prompt([{
+        type: 'list',
+        name: 'id',
+        message: 'Select Target:',
+        choices: recentChats,
+        pageSize: 15
+    }]);
+
+    if (id === 'back') return showMainMenu();
+    await enterChatRoom(id);
+}
+
+async function enterChatRoom(chatId) {
+    clearScreen();
+    const chat = await client.getChatById(chatId);
+    
+    // Header
+    console.log(gradient.cristal(figlet.textSync(chat.name.substring(0, 10), { font: 'Standard' })));
+    console.log(theme.dim('------------------------------------------------'));
+
+    // Messages
+    const messages = await chat.fetchMessages({ limit: 8 });
+    messages.forEach(msg => {
+        const time = new Date(msg.timestamp * 1000).toLocaleTimeString('en-US', {hour: '2-digit', minute:'2-digit'});
+        if (msg.fromMe) {
+            console.log(chalk.cyan(`[${time}] Me:`));
+            console.log(chalk.white(msg.body));
+        } else {
+            console.log(theme.wa(`[${time}] ${chat.name}:`));
+            console.log(chalk.white(msg.body));
+        }
+        console.log('');
+    });
+
+    // Reply Input
+    const { reply } = await inquirer.prompt([{
+        type: 'input',
+        name: 'reply',
+        message: theme.logo('Type message (type "menu" to exit) >')
+    }]);
+
+    if (reply.toLowerCase() === 'menu') return showMainMenu();
+    
+    if (reply.trim()) {
+        await chat.sendMessage(reply);
+    }
+    await enterChatRoom(chatId); 
+}
+
+async function manualInput() {
+    const q = await inquirer.prompt([
+        { type: 'input', name: 'num', message: 'Target Number (628...):' },
+        { type: 'input', name: 'msg', message: 'Message Payload:' }
+    ]);
+    const finalNum = q.num.includes('@c.us') ? q.num : `${q.num}@c.us`;
+    await client.sendMessage(finalNum, q.msg);
+    console.log(chalk.green('>> Payload Delivered'));
+    await sleep(1500);
+    showMainMenu();
+}
+
+// --- INIT ---
+
+client.on('qr', (qr) => {
+    clearScreen();
+    console.log(chalk.yellow('Waiting for authentication...'));
+    qrcode.generate(qr, { small: true });
+});
+
+client.on('ready', async () => {
+    await showBootSequence();
+    showMainMenu();
+});
+
+client.on('message', async msg => {
+    const contact = await msg.getContact();
+    const name = contact.pushname || contact.number;
+    notifier.notify({
+        title: `New Message: ${name}`,
+        message: msg.body,
+        sound: true
+    });
+});
+
+client.initialize();

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "whatsapp-cli-pro",
+  "version": "1.0.0",
+  "description": "WhatsApp CLI made by Jack Williams",
+  "main": "index.js",
+  "bin": {
+    "whatsapp-cli": "./index.js"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "preferGlobal": true,
+  "keywords": ["whatsapp", "cli", "terminal"],
+  "author": "Jack Williams",
+  "license": "ISC",
+  "type": "commonjs",
+  "dependencies": {
+    "boxen": "^5.1.2",
+    "chalk": "^4.1.2",
+    "figlet": "^1.9.4",
+    "gradient-string": "^2.0.2",
+    "inquirer": "^8.2.7",
+    "node-notifier": "^10.0.1",
+    "ora": "^5.4.1",
+    "qrcode": "^1.5.4",
+    "qrcode-terminal": "^0.12.0",
+    "whatsapp-web.js": "^1.34.2"
+  }
+}

package/readme.md

@@ -0,0 +1,55 @@
+# WhatsApp CLI Pro
+
+![NodeJS](https://img.shields.io/badge/Node.js-18+-green) ![WhatsApp-Web.js](https://img.shields.io/badge/Library-whatsapp--web.js-blue)
+
+A professional Command Line Interface (CLI) tool for sending and receiving WhatsApp messages directly from your terminal. Built with Node.js and `whatsapp-web.js`.
+
+## ✨ Features
+
+* **Real-time Messaging:** Send and receive messages instantly.
+* **QR Code Authentication:** Login easily by scanning a QR code, just like WhatsApp Web.
+* **Session Persistence:** Login state is saved locally, so you don't need to rescan every time.
+* **Beautiful UI:** Interactive terminal interface with colored output (`chalk`) and ASCII banners (`figlet`).
+* **Lightweight:** Runs purely on Node.js without a browser window (headless).
+
+## Installation
+
+1.  **Clone the repository:**
+    ```bash
+    git clone [https://github.com/YOUR_USERNAME/wa-cli-pro.git](https://github.com/YOUR_USERNAME/wa-cli-pro.git)
+    cd wa-cli-pro
+    ```
+
+2.  **Install dependencies:**
+    ```bash
+    npm install
+    ```
+
+3.  **Run the application:**
+    ```bash
+    node index.js
+    ```
+
+## Usage
+
+1.  Run the script using `node index.js`.
+2.  Scan the QR Code that appears in your terminal using your WhatsApp mobile app (Linked Devices).
+3.  Once connected, use the following commands:
+
+    **Send a message:**
+    ```bash
+    > send 628123456789 Hello from Terminal!
+    ```
+    *(Note: Use the country code, e.g., 62 for Indonesia, without '0' or '+')*
+
+    **Exit the application:**
+    ```bash
+    > exit
+    ```
+
+## ⚠️ Disclaimer
+
+This project is for **educational purposes only**. It uses the `whatsapp-web.js` library which emulates a browser instance of WhatsApp Web. It is not affiliated with, associated with, or endorsed by WhatsApp Inc. Use responsibly to avoid your account being restricted.
+
+---
+Created by [Your Name]