zalo-agent-cli 1.0.0 → 1.0.3

package/README.md

@@ -1,3 +1,7 @@
+<p align="center">
+  <img src="assets/mascot.png" width="200" alt="zalo-agent-cli mascot" />
+</p>
+
 # zalo-agent-cli
 
 CLI tool for Zalo automation — multi-account, proxy support, bank transfers, QR payments.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zalo-agent-cli",
-  "version": "1.0.0",
+  "version": "1.0.3",
   "description": "CLI tool for Zalo automation — multi-account, proxy support, bank transfers, QR payments",
   "type": "module",
   "bin": {
@@ -29,6 +29,10 @@
     "vietqr",
     "zca-js"
   ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/PhucMPham/zalo-agent-cli"
+  },
   "license": "MIT",
   "engines": {
     "node": ">=20"

package/src/commands/friend.js

@@ -5,6 +5,12 @@
 import { getApi } from "../core/zalo-client.js";
 import { success, error, info, output } from "../utils/output.js";
 
+/** Extract numeric error code from zca-js error message string. */
+function extractErrorCode(msg) {
+    const match = String(msg).match(/\((\-?\d+)\)/);
+    return match ? Number(match[1]) : null;
+}
+
 export function registerFriendCommands(program) {
     const friend = program.command("friend").description("Manage friends and contacts");
 
@@ -45,13 +51,17 @@ export function registerFriendCommands(program) {
         .action(async (query) => {
             try {
                 const result = await getApi().findUser(query);
+                if (!result || (!result.uid && !result?.data?.uid)) {
+                    error(`No Zalo user found for "${query}". User may not exist, has disabled phone search, or phone is not registered on Zalo.`);
+                    return;
+                }
                 output(result, program.opts().json, () => {
                     const u = result?.uid ? result : result?.data || result;
                     info(`User ID: ${u.uid || "?"}`);
-                    info(`Name: ${u.displayName || u.zaloName || "?"}`);
+                    info(`Name: ${u.displayName || u.zaloName || u.display_name || u.zalo_name || "?"}`);
                 });
             } catch (e) {
-                error(e.message);
+                error(`Find user failed: ${e.message}`);
             }
         });
 
@@ -79,10 +89,19 @@ export function registerFriendCommands(program) {
         .option("-m, --msg <text>", "Message to include", "")
         .action(async (userId, opts) => {
             try {
-                const result = await getApi().sendFriendRequest(userId, opts.msg);
-                output(result, program.opts().json, () => success("Friend request sent"));
+                // zca-js API signature: sendFriendRequest(msg, userId)
+                const result = await getApi().sendFriendRequest(opts.msg, userId);
+                output(result, program.opts().json, () => success(`Friend request sent to ${userId}`));
             } catch (e) {
-                error(e.message);
+                // Map Zalo error codes to actionable messages
+                const code = e.code || extractErrorCode(e.message);
+                const errMap = {
+                    225: `Already friends with ${userId}. Use "friend list" to verify.`,
+                    215: `User ${userId} may have blocked you or is unreachable.`,
+                    222: `User ${userId} already sent you a friend request. Use "friend accept ${userId}" instead.`,
+                    "-1": `Invalid userId "${userId}". Use "friend find <phone>" to get the correct userId first.`,
+                };
+                error(errMap[code] || `Friend request failed (code ${code}): ${e.message}`);
             }
         });
 
@@ -92,9 +111,9 @@ export function registerFriendCommands(program) {
         .action(async (userId) => {
             try {
                 const result = await getApi().acceptFriendRequest(userId);
-                output(result, program.opts().json, () => success("Friend request accepted"));
+                output(result, program.opts().json, () => success(`Accepted friend request from ${userId}`));
             } catch (e) {
-                error(e.message);
+                error(`Accept friend request failed for ${userId}: ${e.message}`);
             }
         });
 
@@ -104,9 +123,9 @@ export function registerFriendCommands(program) {
         .action(async (userId) => {
             try {
                 const result = await getApi().removeFriend(userId);
-                output(result, program.opts().json, () => success("Friend removed"));
+                output(result, program.opts().json, () => success(`Removed friend ${userId}`));
             } catch (e) {
-                error(e.message);
+                error(`Remove friend failed for ${userId}: ${e.message}`);
             }
         });
 
@@ -116,9 +135,9 @@ export function registerFriendCommands(program) {
         .action(async (userId) => {
             try {
                 const result = await getApi().blockUser(userId);
-                output(result, program.opts().json, () => success("User blocked"));
+                output(result, program.opts().json, () => success(`Blocked user ${userId}`));
             } catch (e) {
-                error(e.message);
+                error(`Block user failed for ${userId}: ${e.message}`);
             }
         });
 
@@ -128,9 +147,9 @@ export function registerFriendCommands(program) {
         .action(async (userId) => {
             try {
                 const result = await getApi().unblockUser(userId);
-                output(result, program.opts().json, () => success("User unblocked"));
+                output(result, program.opts().json, () => success(`Unblocked user ${userId}`));
             } catch (e) {
-                error(e.message);
+                error(`Unblock user failed for ${userId}: ${e.message}`);
             }
         });
 

package/src/utils/qr-http-server.js

@@ -29,28 +29,60 @@ export function startQrServer(qrImagePath, port = 18927, tryPorts = [18927, 8080
             }
             const img = readFileSync(qrImagePath);
             const b64 = img.toString("base64");
+            // Embed mascot inline (read from assets if available, else skip)
+            let mascotB64 = "";
+            try {
+                const { resolve: resolvePath } = await import("path");
+                const { fileURLToPath } = await import("url");
+                const { dirname } = await import("path");
+                const dir = dirname(fileURLToPath(import.meta.url));
+                const mascotPath = resolvePath(dir, "../../assets/mascot.png");
+                if (existsSync(mascotPath)) {
+                    mascotB64 = readFileSync(mascotPath).toString("base64");
+                }
+            } catch {}
+            const mascotImg = mascotB64
+                ? `<img src="data:image/png;base64,${mascotB64}" class="mascot" alt="zalo-agent"/>`
+                : "";
             res.writeHead(200, { "Content-Type": "text/html" });
             res.end(`<!DOCTYPE html>
-<html><head><meta charset="utf-8"><title>Zalo QR Login</title>
+<html><head><meta charset="utf-8"><title>Zalo Agent — QR Login</title>
 <meta name="viewport" content="width=device-width,initial-scale=1">
 <style>
-body{display:flex;justify-content:center;align-items:center;min-height:100vh;margin:0;background:#111;font-family:system-ui}
-.card{text-align:center;padding:2rem;background:#1a1a2e;border-radius:16px;max-width:400px}
-h2{color:#fff;margin-bottom:1rem}img{width:280px;border-radius:8px}
-p{color:#888;font-size:0.9rem;margin-top:1rem}
-.success{color:#4ade80;font-size:1.2rem;font-weight:bold}
+*{box-sizing:border-box}
+body{display:flex;justify-content:center;align-items:center;min-height:100vh;margin:0;
+  background:linear-gradient(135deg,#0a1628 0%,#111d33 50%,#0d1f3c 100%);font-family:system-ui,-apple-system,sans-serif}
+.card{text-align:center;padding:2.5rem 2rem;background:rgba(17,29,51,0.9);
+  border-radius:20px;max-width:420px;width:90%;
+  border:1px solid rgba(59,130,246,0.2);backdrop-filter:blur(10px);
+  box-shadow:0 20px 60px rgba(0,0,0,0.5),0 0 40px rgba(59,130,246,0.1)}
+.mascot{width:80px;height:80px;border-radius:50%;margin-bottom:0.5rem;
+  border:2px solid rgba(59,130,246,0.4);box-shadow:0 0 20px rgba(59,130,246,0.2)}
+h1{color:#e2e8f0;font-size:1.1rem;font-weight:600;margin:0.5rem 0}
+.brand{color:#3b82f6;font-size:0.8rem;margin-bottom:1.5rem;opacity:0.8}
+.qr-img{width:260px;height:260px;border-radius:12px;border:3px solid rgba(59,130,246,0.3);
+  box-shadow:0 0 30px rgba(59,130,246,0.15)}
+.hint{color:#94a3b8;font-size:0.85rem;margin-top:1.2rem;line-height:1.5}
+.hint strong{color:#60a5fa}
+.success-text{color:#4ade80;font-size:1.3rem;font-weight:bold}
 .hidden{display:none}
+.footer{color:#475569;font-size:0.7rem;margin-top:1.5rem}
+.footer a{color:#3b82f6;text-decoration:none}
 </style></head>
 <body><div class="card">
 <div id="qr-view">
-<h2>Scan with Zalo app</h2>
-<img src="data:image/png;base64,${b64}" alt="QR Code"/>
-<p>Open Zalo > QR Scanner to scan this code</p>
+${mascotImg}
+<h1>Zalo Agent CLI</h1>
+<p class="brand">QR Code Login</p>
+<img src="data:image/png;base64,${b64}" class="qr-img" alt="QR Code"/>
+<p class="hint">Open <strong>Zalo app</strong> > <strong>QR Scanner</strong> to scan</p>
+<p class="footer">Powered by <a href="https://github.com/PhucMPham/zalo-agent-cli">zalo-agent-cli</a></p>
 </div>
 <div id="success-view" class="hidden">
-<h2 style="color:#4ade80">Login Successful!</h2>
-<p class="success">You can close this page now.</p>
-<p>The CLI is ready to use.</p>
+${mascotImg}
+<h1 style="color:#4ade80;font-size:1.5rem;margin:1rem 0">Login Successful!</h1>
+<p class="success-text">You can close this page now.</p>
+<p class="hint">The CLI is ready to use.</p>
 </div>
 </div>
 <script>