miaw-core 1.1.1 → 1.2.0

package/dist/cli/repl.js

@@ -0,0 +1,899 @@
+/**
+ * Interactive REPL (Read-Eval-Print Loop)
+ *
+ * Provides an interactive shell for running miaw-cli commands
+ */
+import * as readline from "readline";
+import * as fs from "fs";
+import * as path from "path";
+import { listInstances } from "./utils/session.js";
+import { disconnectAll, disconnectClient, getOrCreateClient } from "./utils/client-cache.js";
+import { runCommand } from "./commands/index.js";
+import { setReplReadline, setReplLineHandler, clearReplReadline } from "./utils/prompt.js";
+import { initializeCLICleanup } from "./utils/cleanup.js";
+import { getErrorMessage } from "../utils/type-guards.js";
+import { defaultCLIContext } from "./context.js";
+import { cmdInstanceList, cmdInstanceStatus, cmdInstanceConnect, cmdInstanceDisconnect, } from "./commands/commands-index.js";
+const commandTree = {
+    // REPL-specific commands
+    help: {
+        subcommands: ["instance", "get", "load", "send", "media", "group", "check", "contact", "profile", "label", "catalog"],
+    },
+    status: {},
+    exit: { aliases: ["quit"] },
+    use: {},
+    connect: {},
+    disconnect: {},
+    debug: { flags: ["on", "off"] },
+    instances: { aliases: ["ls"] },
+    // Category commands with subcommands
+    instance: {
+        subcommands: ["ls", "list", "status", "create", "delete", "connect", "disconnect", "logout"],
+    },
+    get: {
+        subcommands: ["profile", "contacts", "groups", "chats", "messages", "labels"],
+        flags: ["--limit", "--json", "--filter"],
+    },
+    send: {
+        subcommands: ["text", "image", "document", "video", "audio"],
+        flags: ["--caption", "--gif", "--ptv", "--ptt"],
+    },
+    media: {
+        subcommands: ["download"],
+    },
+    group: {
+        subcommands: [
+            "list", "ls", "info", "participants", "invite-link", "invite", "create", "leave",
+            "name", "description", "picture"
+        ],
+        nestedSubcommands: {
+            participants: ["add", "remove", "promote", "demote"],
+            invite: ["accept", "revoke", "info"],
+            name: ["set"],
+            description: ["set"],
+            picture: ["set"],
+        },
+        flags: ["--limit", "--filter", "--json"],
+    },
+    load: {
+        subcommands: ["messages"],
+        flags: ["--count"],
+    },
+    check: {},
+    contact: {
+        subcommands: ["list", "ls", "info", "business", "picture", "add", "remove"],
+        flags: ["--limit", "--filter", "--json", "--high", "--first", "--last"],
+    },
+    profile: {
+        subcommands: ["picture", "name", "status"],
+        nestedSubcommands: {
+            picture: ["set", "remove"],
+            name: ["set"],
+            status: ["set"],
+        },
+    },
+    label: {
+        subcommands: ["list", "chats", "add", "chat"],
+        nestedSubcommands: {
+            chat: ["add", "remove"],
+        },
+    },
+    catalog: {
+        subcommands: ["list", "collections", "product"],
+        nestedSubcommands: {
+            product: ["create", "update", "delete"],
+        },
+        flags: ["--phone", "--limit", "--cursor", "--image", "--url", "--retailerId", "--hidden", "--json"],
+    },
+};
+// =============================================================================
+// Autocomplete Completer Function
+// =============================================================================
+/**
+ * Create autocomplete completer function for readline
+ * @param sessionPath - Path to session directory (for dynamic instance completion)
+ * @returns readline completer function
+ */
+function createCompleter(sessionPath) {
+    return (line) => {
+        const hits = [];
+        const parts = line.split(/\s+/);
+        const currentPart = parts[parts.length - 1] || "";
+        // Level 1: Top-level commands (only on first word)
+        if (parts.length === 1) {
+            for (const cmd of Object.keys(commandTree)) {
+                if (cmd.startsWith(currentPart)) {
+                    hits.push(cmd);
+                }
+                // Also check aliases
+                const aliases = commandTree[cmd]?.aliases || [];
+                for (const alias of aliases) {
+                    if (alias.startsWith(currentPart)) {
+                        hits.push(alias);
+                    }
+                }
+            }
+            return [hits, currentPart];
+        }
+        // Level 2: Subcommands (second word)
+        if (parts.length === 2) {
+            const category = parts[0];
+            const categoryData = commandTree[category];
+            // Commands that accept instance ID as second argument
+            if (["use", "connect", "disconnect"].includes(category)) {
+                const instances = listInstances(sessionPath);
+                for (const inst of instances) {
+                    if (inst.startsWith(currentPart)) {
+                        hits.push(inst);
+                    }
+                }
+                return [hits, currentPart];
+            }
+            if (categoryData?.subcommands) {
+                for (const sub of categoryData.subcommands) {
+                    if (sub.startsWith(currentPart)) {
+                        hits.push(sub);
+                    }
+                }
+                return [hits, currentPart];
+            }
+        }
+        // Level 3: Nested subcommands or flags (third word)
+        if (parts.length === 3) {
+            const category = parts[0];
+            const subCommand = parts[1];
+            const categoryData = commandTree[category];
+            // Check for nested subcommands
+            if (categoryData?.nestedSubcommands?.[subCommand]) {
+                const nestedSubs = categoryData.nestedSubcommands[subCommand];
+                for (const sub of nestedSubs) {
+                    if (sub.startsWith(currentPart)) {
+                        hits.push(sub);
+                    }
+                }
+                return [hits, currentPart];
+            }
+            // Flag completion for commands with flags
+            if (categoryData?.flags && currentPart.startsWith("-")) {
+                for (const flag of categoryData.flags) {
+                    if (flag.startsWith(currentPart)) {
+                        hits.push(flag);
+                    }
+                }
+                return [hits, currentPart];
+            }
+            // Instance ID completion (for 'instance delete', 'instance connect', etc.)
+            if (category === "instance") {
+                const instances = listInstances(sessionPath);
+                for (const inst of instances) {
+                    if (inst.startsWith(currentPart)) {
+                        hits.push(inst);
+                    }
+                }
+                return [hits, currentPart];
+            }
+        }
+        // Level 4+: Flags (fourth word onwards)
+        if (parts.length >= 4) {
+            const category = parts[0];
+            const categoryData = commandTree[category];
+            // Flag completion for commands with flags
+            if (categoryData?.flags && currentPart.startsWith("-")) {
+                for (const flag of categoryData.flags) {
+                    if (flag.startsWith(currentPart)) {
+                        hits.push(flag);
+                    }
+                }
+                return [hits, currentPart];
+            }
+        }
+        return [[], line];
+    };
+}
+// =============================================================================
+// Command History Management
+// =============================================================================
+const MAX_HISTORY_SIZE = 1000;
+/**
+ * Get the path to the history file
+ */
+function getHistoryFilePath(sessionPath) {
+    return path.join(sessionPath, ".cli_history");
+}
+/**
+ * Load command history from file
+ */
+function loadHistory(sessionPath) {
+    try {
+        const historyPath = getHistoryFilePath(sessionPath);
+        if (fs.existsSync(historyPath)) {
+            const content = fs.readFileSync(historyPath, "utf8");
+            const lines = content.split("\n").filter(line => line.trim() !== "");
+            // Return in reverse order (readline expects newest first)
+            return lines.slice(-MAX_HISTORY_SIZE);
+        }
+    }
+    catch (error) {
+        // Silently ignore history load errors
+    }
+    return [];
+}
+/**
+ * Save command history to file
+ */
+function saveHistory(sessionPath, history) {
+    try {
+        const historyPath = getHistoryFilePath(sessionPath);
+        // Ensure directory exists
+        const dir = path.dirname(historyPath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        // Keep only the last MAX_HISTORY_SIZE entries
+        const trimmedHistory = history.slice(-MAX_HISTORY_SIZE);
+        fs.writeFileSync(historyPath, trimmedHistory.join("\n") + "\n", "utf8");
+    }
+    catch (error) {
+        // Silently ignore history save errors
+    }
+}
+/**
+ * Add a command to history (avoiding duplicates of the last command)
+ */
+function addToHistory(history, command) {
+    const trimmed = command.trim();
+    if (trimmed && trimmed !== history[history.length - 1]) {
+        history.push(trimmed);
+    }
+}
+/**
+ * Run the interactive REPL
+ */
+export async function runRepl(config) {
+    // Initialize CLI cleanup handlers for graceful shutdown
+    initializeCLICleanup();
+    // Create client (uses cache)
+    let client = getOrCreateClient(config);
+    // Show welcome message
+    showWelcome(config);
+    // Check connection status
+    const state = client.getConnectionState();
+    if (state !== "connected") {
+        console.log("📱 Not connected. Type 'connect' to connect to WhatsApp.");
+    }
+    else {
+        console.log("✅ Connected to WhatsApp!");
+    }
+    // Load command history from previous sessions
+    const commandHistory = loadHistory(config.sessionPath);
+    // Create readline interface with autocomplete and history
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+        prompt: getPrompt(config.instanceId, state),
+        completer: createCompleter(config.sessionPath),
+        history: commandHistory,
+        historySize: MAX_HISTORY_SIZE,
+    });
+    // Register with prompt utility (to avoid double-character echo)
+    setReplReadline(rl);
+    // Handle REPL commands
+    rl.prompt();
+    // Define the line handler as a named function so we can store and restore it
+    const lineHandler = async (line) => {
+        const input = line.trim();
+        if (!input) {
+            rl.prompt();
+            return;
+        }
+        // Add to history (for persistence)
+        addToHistory(commandHistory, input);
+        // Handle REPL-specific commands
+        if (input === "exit" || input === "quit") {
+            console.log("\n👋 Goodbye!");
+            saveHistory(config.sessionPath, commandHistory);
+            rl.close();
+            return;
+        }
+        if (input === "help" || input.startsWith("help ")) {
+            const parts = input.split(/\s+/);
+            const helpTopic = parts[1] || "";
+            showReplHelp(helpTopic);
+            rl.prompt();
+            return;
+        }
+        if (input === "status") {
+            await cmdInstanceStatus(config.sessionPath, config.instanceId, defaultCLIContext);
+            rl.prompt();
+            return;
+        }
+        if (input.startsWith("use ")) {
+            const newInstanceId = input.slice(4).trim();
+            if (newInstanceId && newInstanceId !== config.instanceId) {
+                // Disconnect previous instance to prevent WhatsApp connection conflicts
+                // WhatsApp only allows one active connection per account
+                const previousState = client.getConnectionState();
+                if (previousState === "connected" || previousState === "connecting") {
+                    console.log(`📴 Disconnecting previous instance: ${config.instanceId}`);
+                    await disconnectClient({ instanceId: config.instanceId, sessionPath: config.sessionPath });
+                }
+                config.instanceId = newInstanceId;
+                client = getOrCreateClient(config);
+                console.log(`✅ Switched to instance: ${newInstanceId}`);
+                rl.setPrompt(getPrompt(newInstanceId, client.getConnectionState()));
+            }
+            else if (newInstanceId === config.instanceId) {
+                console.log(`ℹ️  Already using instance: ${newInstanceId}`);
+            }
+            rl.prompt();
+            return;
+        }
+        if (input === "connect" || input.startsWith("connect ")) {
+            const parts = input.split(/\s+/);
+            const targetInstanceId = parts[1] || config.instanceId;
+            // If connecting to a different instance, disconnect the current one first
+            // to prevent WhatsApp connection conflicts
+            if (targetInstanceId !== config.instanceId) {
+                const previousState = client.getConnectionState();
+                if (previousState === "connected" || previousState === "connecting") {
+                    console.log(`📴 Disconnecting current instance: ${config.instanceId}`);
+                    await disconnectClient({ instanceId: config.instanceId, sessionPath: config.sessionPath });
+                }
+            }
+            // Always use cmdInstanceConnect for consistency
+            const result = await cmdInstanceConnect(config.sessionPath, targetInstanceId);
+            // Handle auto-switch if result indicates it
+            if (result && typeof result === "object" && "switchToInstance" in result) {
+                const switchTo = result.switchToInstance;
+                if (switchTo && switchTo !== config.instanceId) {
+                    config.instanceId = switchTo;
+                    client = getOrCreateClient(config);
+                    rl.setPrompt(getPrompt(switchTo, client.getConnectionState()));
+                    rl.prompt();
+                    return;
+                }
+            }
+            rl.setPrompt(getPrompt(config.instanceId, client.getConnectionState()));
+            rl.prompt();
+            return;
+        }
+        if (input === "disconnect" || input.startsWith("disconnect ")) {
+            const parts = input.split(/\s+/);
+            const targetInstanceId = parts[1] || config.instanceId;
+            // Always use cmdInstanceDisconnect for consistency
+            const result = await cmdInstanceDisconnect(config.sessionPath, targetInstanceId, config.instanceId);
+            // Handle auto-switch if result suggests it
+            if (result && typeof result === "object" && "switchToInstance" in result) {
+                const switchTo = result.switchToInstance;
+                if (switchTo && switchTo !== config.instanceId) {
+                    config.instanceId = switchTo;
+                    client = getOrCreateClient(config);
+                    console.log(`✅ Switched to instance: ${switchTo}`);
+                }
+            }
+            rl.setPrompt(getPrompt(config.instanceId, client.getConnectionState()));
+            rl.prompt();
+            return;
+        }
+        // Debug toggle commands
+        if (input === "debug" || input === "debug on") {
+            client.enableDebug();
+            console.log("✅ Debug mode enabled");
+            rl.prompt();
+            return;
+        }
+        if (input === "debug off") {
+            client.disableDebug();
+            console.log("✅ Debug mode disabled");
+            rl.prompt();
+            return;
+        }
+        if (input === "instances" || input === "ls") {
+            await cmdInstanceList(config.sessionPath);
+            rl.prompt();
+            return;
+        }
+        // Run regular command (remove "miaw-cli" prefix if present)
+        let commandInput = input;
+        if (input.startsWith("miaw-cli ")) {
+            commandInput = input.slice(9).trim();
+        }
+        const parts = commandInput.split(/\s+/);
+        const command = parts[0];
+        const args = parts.slice(1);
+        try {
+            const result = await runCommand(command, args, {
+                clientConfig: config,
+                jsonOutput: false,
+            });
+            // Check if command suggests switching to a different instance
+            if (result && typeof result === "object" && "switchToInstance" in result) {
+                const switchTo = result.switchToInstance;
+                if (switchTo && switchTo !== config.instanceId) {
+                    // Disconnect previous instance to prevent WhatsApp connection conflicts
+                    const previousState = client.getConnectionState();
+                    if (previousState === "connected" || previousState === "connecting") {
+                        console.log(`📴 Disconnecting previous instance: ${config.instanceId}`);
+                        await disconnectClient({ instanceId: config.instanceId, sessionPath: config.sessionPath });
+                    }
+                    config.instanceId = switchTo;
+                    // Get the new client for the switched instance
+                    client = getOrCreateClient(config);
+                    console.log(`✅ Switched to instance: ${switchTo}`);
+                    // Update prompt with new client's state
+                    rl.setPrompt(getPrompt(switchTo, client.getConnectionState()));
+                    rl.prompt();
+                    return;
+                }
+            }
+        }
+        catch (error) {
+            console.log(`❌ Error: ${error.message}`);
+        }
+        // Update prompt in case connection state changed
+        rl.setPrompt(getPrompt(config.instanceId, client.getConnectionState()));
+        rl.prompt();
+    };
+    // Wrap async handler to catch promise rejections
+    const safeLineHandler = (line) => {
+        lineHandler(line).catch((error) => {
+            console.error("❌ Command error:", getErrorMessage(error));
+            if (config.debug) {
+                console.error(error);
+            }
+            rl.prompt(); // Re-display prompt after error
+        });
+    };
+    // Store the line handler so prompt utility can restore it
+    setReplLineHandler(safeLineHandler);
+    // Register the safe line handler
+    rl.on("line", safeLineHandler);
+    rl.on("close", async () => {
+        // Save command history before exiting
+        saveHistory(config.sessionPath, commandHistory);
+        // Clear REPL readline reference
+        clearReplReadline();
+        // Disconnect all cached clients before exiting
+        await disconnectAll();
+        console.log();
+        process.exit(0);
+    });
+}
+/**
+ * Show welcome message
+ */
+function showWelcome(config) {
+    console.log(`
+╔════════════════════════════════════════════════════════════╗
+║              miaw-cli - Interactive Mode                  ║
+╚════════════════════════════════════════════════════════════╝
+
+Instance: ${config.instanceId}
+Session:  ${config.sessionPath}
+
+Type 'help' for available commands, 'exit' to quit.
+`);
+}
+/**
+ * Show REPL help - full or topic-specific
+ */
+function showReplHelp(topic = "") {
+    const topicLower = topic.toLowerCase();
+    // Topic-specific help
+    switch (topicLower) {
+        case "instance":
+            showHelpInstance();
+            return;
+        case "get":
+            showHelpGet();
+            return;
+        case "load":
+            showHelpLoad();
+            return;
+        case "send":
+            showHelpSend();
+            return;
+        case "media":
+            showHelpMedia();
+            return;
+        case "group":
+            showHelpGroup();
+            return;
+        case "check":
+            showHelpCheck();
+            return;
+        case "contact":
+            showHelpContact();
+            return;
+        case "profile":
+            showHelpProfile();
+            return;
+        case "label":
+            showHelpLabel();
+            return;
+        case "catalog":
+            showHelpCatalog();
+            return;
+        case "":
+            // Show full help
+            break;
+        default:
+            console.log(`❌ Unknown help topic: ${topic}`);
+            console.log(`Available topics: instance, get, load, send, media, group, check, contact, profile, label, catalog`);
+            console.log(`Usage: help [topic]`);
+            return;
+    }
+    // Full help
+    console.log(`
+╔════════════════════════════════════════════════════════════════════════╗
+║                           REPL Commands                                ║
+╚════════════════════════════════════════════════════════════════════════╝
+
+REPL-SPECIFIC:
+  help [topic]                                Show help (topics: instance, get, send, group, contact, profile, label, catalog)
+  status                                      Show connection status
+  use <instance-id>                           Switch active instance
+  connect [id]                                Connect to WhatsApp
+  disconnect [id]                             Disconnect from WhatsApp
+  debug [on|off]                              Toggle debug mode
+  instances, ls                               List all instances
+  exit, quit                                  Exit REPL
+
+COMMANDS (use "help <command>" for details):
+  instance    Manage WhatsApp instances (create, connect, disconnect, etc.)
+  get         Fetch data (profile, contacts, groups, chats, messages, labels)
+  load        Load older messages from chat history
+  send        Send messages (text, image, document, video, audio)
+  media       Media operations (download)
+  group       Group management (info, participants, invites, settings)
+  check       Check if phone numbers are on WhatsApp
+  contact     Contact management (list, info, add, remove)
+  profile     Profile management (picture, name, status)
+  label       Label management (WhatsApp Business)
+  catalog     Catalog management (WhatsApp Business)
+
+QUICK EXAMPLES:
+  get groups --limit 5                        List first 5 groups
+  send text 6281234567890 "Hello"             Send a text message
+  contact list --filter john                  Find contacts named john
+  group info 120363039902323086@g.us          Get group details
+
+Type "help <command>" for detailed help on each command.
+`);
+}
+/**
+ * Show help for instance commands
+ */
+function showHelpInstance() {
+    console.log(`
+╔════════════════════════════════════════════════════════════════════════╗
+║                       Instance Commands                                ║
+╚════════════════════════════════════════════════════════════════════════╝
+
+COMMANDS:
+  instance ls                                 List all instances
+  instance status [id]                        Show connection status
+  instance create <id>                        Create new instance
+  instance delete <id>                        Delete instance
+  instance connect <id>                       Connect instance
+  instance disconnect <id>                    Disconnect instance
+  instance logout <id>                        Logout and clear session
+
+EXAMPLE:
+  instance create my-bot                      Create and scan QR for new instance
+
+NOTES:
+  - Each instance maintains its own WhatsApp session
+  - Creating an instance will prompt for QR code scan
+  - Logout clears the session, requiring re-authentication
+`);
+}
+/**
+ * Show help for get commands
+ */
+function showHelpGet() {
+    console.log(`
+╔════════════════════════════════════════════════════════════════════════╗
+║                          Get Commands                                  ║
+╚════════════════════════════════════════════════════════════════════════╝
+
+COMMANDS:
+  get profile [jid]                           Get profile (own or contact)
+  get contacts [options]                      List all contacts
+  get groups [options]                        List all groups
+  get chats [options]                         List all chats
+  get messages <jid> [options]                Get chat messages
+  get labels                                  List labels (Business only)
+
+OPTIONS:
+  --limit N                                   Limit number of results
+  --filter TEXT                               Filter by name/phone (case-insensitive)
+  --json                                      Output as JSON
+
+EXAMPLE:
+  get contacts --limit 10 --filter john       Filter and limit results
+
+NOTES:
+  - JID format: phone@s.whatsapp.net (individual), groupid@g.us (group)
+`);
+}
+/**
+ * Show help for load commands
+ */
+function showHelpLoad() {
+    console.log(`
+╔════════════════════════════════════════════════════════════════════════╗
+║                         Load Commands                                  ║
+╚════════════════════════════════════════════════════════════════════════╝
+
+COMMANDS:
+  load messages <jid> [--count N]             Load older messages from history
+
+OPTIONS:
+  --count N                                   Number of messages to load (default: 50)
+
+EXAMPLE:
+  load messages 628xxx@s.whatsapp.net --count 100
+
+NOTES:
+  - JID format: phone@s.whatsapp.net (individual), groupid@g.us (group)
+  - Use 'get messages' to view loaded messages
+`);
+}
+/**
+ * Show help for send commands
+ */
+function showHelpSend() {
+    console.log(`
+╔════════════════════════════════════════════════════════════════════════╗
+║                         Send Commands                                  ║
+╚════════════════════════════════════════════════════════════════════════╝
+
+COMMANDS:
+  send text <phone> <message>                 Send text message
+  send image <phone> <path> [caption]         Send image
+  send document <phone> <path> [caption]      Send document
+  send video <phone> <path> [options]         Send video
+  send audio <phone> <path> [options]         Send audio
+
+VIDEO OPTIONS:
+  --caption <text>                            Add caption to video
+  --gif                                       Play as GIF (loops, no audio)
+  --ptv                                       Send as video note (circular)
+
+AUDIO OPTIONS:
+  --ptt                                       Send as voice note (push-to-talk)
+
+EXAMPLES:
+  send image 6281234567890 ./photo.jpg "Caption"
+  send video 6281234567890 ./video.mp4 --caption "Check this"
+  send video 6281234567890 ./short.mp4 --gif
+  send audio 6281234567890 ./voice.ogg --ptt
+
+NOTES:
+  - Phone format: international without + (e.g., 6281234567890)
+  - Supported images: JPEG, PNG, GIF, WebP
+  - Supported video: MP4, MOV, AVI, WebM
+  - Supported audio: MP3, OGG, AAC, M4A, WAV
+  - Voice notes (--ptt) show as voice messages in WhatsApp
+`);
+}
+/**
+ * Show help for media commands
+ */
+function showHelpMedia() {
+    console.log(`
+╔════════════════════════════════════════════════════════════════════════╗
+║                         Media Commands                                 ║
+╚════════════════════════════════════════════════════════════════════════╝
+
+COMMANDS:
+  media download <jid> <messageId> <output>   Download media from message
+
+WORKFLOW:
+  1. Use 'get messages <jid>' to list messages and find message IDs
+  2. Copy the message ID of the media you want to download
+  3. Run 'media download <jid> <messageId> <output-path>'
+
+EXAMPLES:
+  media download 6281234567890@s.whatsapp.net 3EB0123ABC ./photo.jpg
+  media download 120363012345678@g.us MSGID123 ./video.mp4
+
+NOTES:
+  - Only recently received messages with raw data can be downloaded
+  - Supports: image, video, audio, document, sticker
+  - Output directory will be created if it doesn't exist
+  - JID format: phone@s.whatsapp.net or groupid@g.us
+`);
+}
+/**
+ * Show help for group commands
+ */
+function showHelpGroup() {
+    console.log(`
+╔════════════════════════════════════════════════════════════════════════╗
+║                         Group Commands                                 ║
+╚════════════════════════════════════════════════════════════════════════╝
+
+COMMANDS:
+  group list [options]                        List all groups
+  group info <jid>                            Get group details
+  group create <name> <phones..>              Create new group
+  group leave <jid>                           Leave a group
+
+PARTICIPANT MANAGEMENT:
+  group participants <jid> [options]          List group members
+  group participants add <jid> <phones>       Add members to group
+  group participants remove <jid> <phones>    Remove members from group
+  group participants promote <jid> <phones>   Promote to admin
+  group participants demote <jid> <phones>    Demote from admin
+
+INVITE MANAGEMENT:
+  group invite-link <jid>                     Get invite link
+  group invite accept <code>                  Join via invite code
+  group invite revoke <jid>                   Revoke and get new link
+  group invite info <code>                    Get info from invite code
+
+GROUP SETTINGS:
+  group name set <jid> <name>                 Update group name
+  group description set <jid> [desc]          Update group description
+  group picture set <jid> <path>              Update group picture
+
+OPTIONS:
+  --limit N                                   Limit number of results
+  --filter TEXT                               Filter by name (case-insensitive)
+
+EXAMPLE:
+  group participants add 120363xxx@g.us 628xxx 628yyy
+
+NOTES:
+  - Group JID format: groupid@g.us
+  - Admin rights required for participant/settings management
+`);
+}
+/**
+ * Show help for check commands
+ */
+function showHelpCheck() {
+    console.log(`
+╔════════════════════════════════════════════════════════════════════════╗
+║                         Check Commands                                 ║
+╚════════════════════════════════════════════════════════════════════════╝
+
+COMMANDS:
+  check <phone>                               Check if number is on WhatsApp
+  check <phone1> <phone2> ...                 Batch check multiple numbers
+
+OPTIONS:
+  --json                                      Output as JSON
+
+EXAMPLE:
+  check 6281234567890 6289876543210           Check multiple numbers
+
+NOTES:
+  - Phone format: international without + (e.g., 6281234567890)
+  - Shows registration status and JID for each number
+`);
+}
+/**
+ * Show help for contact commands
+ */
+function showHelpContact() {
+    console.log(`
+╔════════════════════════════════════════════════════════════════════════╗
+║                        Contact Commands                                ║
+╚════════════════════════════════════════════════════════════════════════╝
+
+COMMANDS:
+  contact list [options]                      List all contacts
+  contact info <phone>                        Get contact information
+  contact business <phone>                    Get business profile
+  contact picture <phone> [--high]            Get profile picture URL
+  contact add <phone> <name> [options]        Add or edit contact
+  contact remove <phone>                      Remove contact
+
+OPTIONS:
+  --limit N                                   Limit number of results
+  --filter TEXT                               Filter by name/phone
+  --high                                      Get high-resolution picture
+  --first <firstName>                         Set first name
+  --last <lastName>                           Set last name
+  --json                                      Output as JSON
+
+EXAMPLE:
+  contact add 628xxx "John Doe" --first John --last Doe
+
+NOTES:
+  - Phone format: international without + (e.g., 6281234567890)
+  - Business profile only for WhatsApp Business accounts
+`);
+}
+/**
+ * Show help for profile commands
+ */
+function showHelpProfile() {
+    console.log(`
+╔════════════════════════════════════════════════════════════════════════╗
+║                        Profile Commands                                ║
+╚════════════════════════════════════════════════════════════════════════╝
+
+COMMANDS:
+  profile picture set <path>                  Set your profile picture
+  profile picture remove                      Remove your profile picture
+  profile name set <name>                     Set your display name
+  profile status set <status>                 Set your status/about text
+
+NOTES:
+  - Supported image formats: JPEG, PNG
+`);
+}
+/**
+ * Show help for label commands
+ */
+function showHelpLabel() {
+    console.log(`
+╔════════════════════════════════════════════════════════════════════════╗
+║                    Label Commands (WhatsApp Business)                  ║
+╚════════════════════════════════════════════════════════════════════════╝
+
+COMMANDS:
+  label list                                  List all labels
+  label chats <labelId>                       List chats with this label
+  label add <name> <color>                    Create a new label
+  label chat add <jid> <labelId>              Add label to chat
+  label chat remove <jid> <labelId>           Remove label from chat
+
+COLOR OPTIONS:
+  By number: 0-19
+  By name: salmon, gold, yellow, mint, teal, cyan, sky, blue, purple, pink,
+           rose, orange, lime, green, emerald, indigo, violet, magenta, red, gray
+
+EXAMPLE:
+  label add "VIP" blue                        Color: name or number 0-19
+
+NOTES:
+  - Labels only available for WhatsApp Business accounts
+  - JID format: phone@s.whatsapp.net or groupid@g.us
+`);
+}
+/**
+ * Show help for catalog commands
+ */
+function showHelpCatalog() {
+    console.log(`
+╔════════════════════════════════════════════════════════════════════════╗
+║                   Catalog Commands (WhatsApp Business)                 ║
+╚════════════════════════════════════════════════════════════════════════╝
+
+COMMANDS:
+  catalog list [options]                      List catalog products
+  catalog collections [options]               List product collections
+  catalog product create <name> <desc> <price> <currency>
+  catalog product update <productId> [options]
+  catalog product delete <productIds...>      Delete products
+
+OPTIONS:
+  --phone <phone>                             View another business's catalog
+  --limit N                                   Limit number of results
+  --cursor <cursor>                           Pagination cursor
+  --image <path>                              Product image path
+  --url <url>                                 Product landing page URL
+  --retailerId <id>                           Your internal SKU/product ID
+  --hidden                                    Mark product as hidden
+
+EXAMPLE:
+  catalog product create "T-Shirt" "Cotton" 50000 IDR --image ./shirt.jpg
+
+NOTES:
+  - Catalog only available for WhatsApp Business accounts
+  - Currency: valid ISO code (IDR, USD, EUR, etc.)
+`);
+}
+/**
+ * Get prompt string based on connection state
+ */
+function getPrompt(instanceId, state) {
+    const status = state === "connected" ? "✓" : "✗";
+    return `miaw-cli[${instanceId}] ${status}> `;
+}
+//# sourceMappingURL=repl.js.map