wazzup-cli 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 jensblond
+
+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,76 @@
+# wazzup-cli
+
+Send WhatsApp messages from the terminal.
+
+## Install
+
+```bash
+npm install -g wazzup-cli
+```
+
+## Quick Start
+
+### 1. Log in
+
+```bash
+wazzup login
+```
+
+Scan the QR code with WhatsApp on your phone (Linked Devices → Link a Device).
+
+### 2. Send a message
+
+```bash
+wazzup send --to "+491234567890" --message "Hello from the terminal!"
+```
+
+### 3. Pipe messages via stdin
+
+```bash
+echo "Server is down!" | wazzup send --to "+491234567890"
+```
+
+## Commands
+
+### `wazzup login`
+
+Connect to WhatsApp by scanning a QR code. Session is saved locally so you only need to do this once.
+
+### `wazzup logout`
+
+Delete stored session credentials.
+
+### `wazzup send`
+
+Send a message to a phone number.
+
+| Option | Description |
+|---|---|
+| `--to <number>` | Recipient phone number with country code (e.g. `+491234567890`) |
+| `--message <text>` | Message text. If omitted, reads from stdin. |
+
+### `wazzup config`
+
+View or update configuration.
+
+| Option | Description |
+|---|---|
+| `--default-number <number>` | Set a default recipient so you can skip `--to` |
+
+```bash
+# Set a default number
+wazzup config --default-number "+491234567890"
+
+# Then just
+wazzup send --message "Quick message"
+```
+
+## How It Works
+
+wazzup-cli uses [Baileys](https://github.com/WhiskeySockets/Baileys), an open-source WhatsApp Web API library. It connects as a linked device to your WhatsApp account — no separate phone number or WhatsApp Business account needed.
+
+Session credentials are stored in `~/.whatsapp-cli/auth/`.
+
+## License
+
+MIT

package/dist/commands/config.d.ts

@@ -0,0 +1,3 @@
+export declare function configCommand(options: {
+    defaultNumber?: string;
+}): void;

package/dist/commands/config.js

@@ -0,0 +1,20 @@
+import { loadConfig, saveConfig } from "../lib/config.js";
+export function configCommand(options) {
+    const config = loadConfig();
+    if (options.defaultNumber) {
+        config.defaultNumber = options.defaultNumber;
+        saveConfig(config);
+        console.log(`✅ Default number set to ${options.defaultNumber}`);
+        return;
+    }
+    // No flags — show current config
+    if (Object.keys(config).length === 0) {
+        console.log("No configuration set yet.");
+        console.log('  wazzup config --default-number "+491234567"');
+        return;
+    }
+    console.log("Current configuration:");
+    if (config.defaultNumber) {
+        console.log(`  Default number: ${config.defaultNumber}`);
+    }
+}

package/dist/commands/login.d.ts

@@ -0,0 +1 @@
+export declare function loginCommand(): Promise<void>;

package/dist/commands/login.js

@@ -0,0 +1,47 @@
+import makeWASocket, { useMultiFileAuthState, DisconnectReason, } from "@whiskeysockets/baileys";
+import { AUTH_DIR } from "../lib/auth.js";
+import qrcode from "qrcode-terminal";
+import { mkdirSync } from "fs";
+import P from "pino";
+const logger = P({ level: "silent" });
+async function startLogin() {
+    mkdirSync(AUTH_DIR, { recursive: true });
+    const { state, saveCreds } = await useMultiFileAuthState(AUTH_DIR);
+    const sock = makeWASocket({
+        auth: state,
+        logger,
+    });
+    sock.ev.on("creds.update", saveCreds);
+    sock.ev.on("connection.update", (update) => {
+        const { connection, lastDisconnect, qr } = update;
+        if (qr) {
+            console.log("\nScan this QR code with WhatsApp on your phone:\n");
+            qrcode.generate(qr, { small: true });
+        }
+        if (connection === "close") {
+            const statusCode = lastDisconnect?.error?.output?.statusCode;
+            if (statusCode === DisconnectReason.loggedOut) {
+                console.error("Logged out. Please run 'wazzup login' again.");
+                process.exit(1);
+            }
+            if (statusCode === DisconnectReason.restartRequired) {
+                // Retry connection after restart-required signal
+                startLogin();
+            }
+            else {
+                const msg = lastDisconnect?.error?.message || "unknown error";
+                console.error(`Connection failed (status ${statusCode}): ${msg}`);
+                process.exit(1);
+            }
+        }
+        if (connection === "open") {
+            console.log("✅ Successfully logged in! Session saved.");
+            console.log("You can now use 'wazzup send' to send messages.");
+            setTimeout(() => process.exit(0), 1000);
+        }
+    });
+}
+export async function loginCommand() {
+    console.log("Connecting to WhatsApp...");
+    await startLogin();
+}

package/dist/commands/logout.d.ts

@@ -0,0 +1 @@
+export declare function logoutCommand(): void;

package/dist/commands/logout.js

@@ -0,0 +1,10 @@
+import { rmSync, existsSync } from "fs";
+import { AUTH_DIR } from "../lib/auth.js";
+export function logoutCommand() {
+    if (!existsSync(AUTH_DIR)) {
+        console.log("No active session found. Already logged out.");
+        return;
+    }
+    rmSync(AUTH_DIR, { recursive: true, force: true });
+    console.log("✅ Logged out. Session credentials deleted.");
+}

package/dist/commands/send.d.ts

@@ -0,0 +1,4 @@
+export declare function sendCommand(options: {
+    to?: string;
+    message?: string;
+}): Promise<void>;

package/dist/commands/send.js

@@ -0,0 +1,76 @@
+import makeWASocket, { useMultiFileAuthState, DisconnectReason, } from "@whiskeysockets/baileys";
+import { AUTH_DIR, isAuthenticated } from "../lib/auth.js";
+import { loadConfig } from "../lib/config.js";
+import P from "pino";
+const logger = P({ level: "silent" });
+function formatPhoneNumber(phone) {
+    // Remove +, spaces, dashes -> append @s.whatsapp.net
+    const cleaned = phone.replace(/[\s\-+]/g, "");
+    return `${cleaned}@s.whatsapp.net`;
+}
+async function readStdin() {
+    return new Promise((resolve) => {
+        if (process.stdin.isTTY) {
+            resolve("");
+            return;
+        }
+        let data = "";
+        process.stdin.setEncoding("utf-8");
+        process.stdin.on("data", (chunk) => (data += chunk));
+        process.stdin.on("end", () => resolve(data.trim()));
+    });
+}
+export async function sendCommand(options) {
+    // Resolve recipient
+    const config = loadConfig();
+    const recipient = options.to || config.defaultNumber;
+    if (!recipient) {
+        console.error("Error: No recipient specified. Use --to or set a default number:");
+        console.error('  wazzup config --default-number "+491234567"');
+        process.exit(1);
+    }
+    // Resolve message (flag or stdin)
+    let message = options.message;
+    if (!message) {
+        message = await readStdin();
+    }
+    if (!message) {
+        console.error("Error: No message specified. Use --message or pipe via stdin.");
+        process.exit(1);
+    }
+    // Check auth
+    if (!isAuthenticated()) {
+        console.error("Error: Not logged in. Run 'wazzup login' first.");
+        process.exit(1);
+    }
+    const { state, saveCreds } = await useMultiFileAuthState(AUTH_DIR);
+    const sock = makeWASocket({
+        auth: state,
+        logger,
+    });
+    sock.ev.on("creds.update", saveCreds);
+    const jid = formatPhoneNumber(recipient);
+    sock.ev.on("connection.update", async (update) => {
+        const { connection, lastDisconnect } = update;
+        if (connection === "close") {
+            const statusCode = lastDisconnect?.error?.output?.statusCode;
+            if (statusCode === DisconnectReason.loggedOut) {
+                console.error("Session expired. Please run 'wazzup login' again.");
+                process.exit(1);
+            }
+            console.error("Connection closed unexpectedly.");
+            process.exit(1);
+        }
+        if (connection === "open") {
+            try {
+                await sock.sendMessage(jid, { text: message });
+                console.log(`✅ Message sent to ${recipient}`);
+            }
+            catch (err) {
+                console.error("Failed to send message:", err);
+                process.exit(1);
+            }
+            setTimeout(() => process.exit(0), 1000);
+        }
+    });
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { loginCommand } from "./commands/login.js";
+import { logoutCommand } from "./commands/logout.js";
+import { sendCommand } from "./commands/send.js";
+import { configCommand } from "./commands/config.js";
+const program = new Command();
+program
+    .name("wazzup")
+    .description("Send WhatsApp messages from the terminal")
+    .version("1.0.0");
+program
+    .command("login")
+    .description("Log in by scanning a QR code")
+    .action(loginCommand);
+program
+    .command("logout")
+    .description("Log out and delete stored session")
+    .action(logoutCommand);
+program
+    .command("send")
+    .description("Send a message")
+    .option("--to <number>", "Recipient phone number (with country code, e.g. +491234567)")
+    .option("--message <text>", "Message text (or pipe via stdin)")
+    .action(sendCommand);
+program
+    .command("config")
+    .description("View or set configuration")
+    .option("--default-number <number>", "Set default recipient number")
+    .action(configCommand);
+program.parse();

package/dist/lib/auth.d.ts

@@ -0,0 +1,2 @@
+export declare const AUTH_DIR: string;
+export declare function isAuthenticated(): boolean;

package/dist/lib/auth.js

@@ -0,0 +1,7 @@
+import { existsSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+export const AUTH_DIR = join(homedir(), ".whatsapp-cli", "auth");
+export function isAuthenticated() {
+    return existsSync(AUTH_DIR) && existsSync(join(AUTH_DIR, "creds.json"));
+}

package/dist/lib/config.d.ts

@@ -0,0 +1,5 @@
+export interface AppConfig {
+    defaultNumber?: string;
+}
+export declare function loadConfig(): AppConfig;
+export declare function saveConfig(config: AppConfig): void;

package/dist/lib/config.js

@@ -0,0 +1,16 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+const CONFIG_DIR = join(homedir(), ".whatsapp-cli");
+const CONFIG_FILE = join(CONFIG_DIR, "config.json");
+export function loadConfig() {
+    if (!existsSync(CONFIG_FILE)) {
+        return {};
+    }
+    const raw = readFileSync(CONFIG_FILE, "utf-8");
+    return JSON.parse(raw);
+}
+export function saveConfig(config) {
+    mkdirSync(CONFIG_DIR, { recursive: true });
+    writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2) + "\n", "utf-8");
+}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "wazzup-cli",
+  "version": "1.0.0",
+  "description": "Send WhatsApp messages from the terminal",
+  "type": "module",
+  "license": "MIT",
+  "author": "jensblond",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jensblond/wazzup-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/jensblond/wazzup-cli/issues"
+  },
+  "homepage": "https://github.com/jensblond/wazzup-cli#readme",
+  "keywords": [
+    "whatsapp",
+    "cli",
+    "terminal",
+    "messaging",
+    "send"
+  ],
+  "bin": {
+    "wazzup": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@whiskeysockets/baileys": "^7.0.0-rc.9",
+    "commander": "^13.1.0",
+    "pino": "^10.3.1",
+    "qrcode-terminal": "^0.12.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.1",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3"
+  }
+}