zalo-agent-cli 1.0.1 → 1.0.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zalo-agent-cli",
-  "version": "1.0.1",
+  "version": "1.0.4",
   "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/index.js

@@ -5,8 +5,14 @@
  * Entry point: registers all command groups via Commander.js.
  */
 
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
 import { Command } from "commander";
 import { registerLoginCommands } from "./commands/login.js";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf8"));
 import { registerMsgCommands } from "./commands/msg.js";
 import { registerFriendCommands } from "./commands/friend.js";
 import { registerGroupCommands } from "./commands/group.js";
@@ -19,7 +25,7 @@ const program = new Command();
 program
     .name("zalo-agent")
     .description("CLI tool for Zalo automation — multi-account, proxy, bank transfers, QR payments")
-    .version("1.0.0")
+    .version(pkg.version)
     .option("--json", "Output results as JSON (machine-readable)")
     .hook("preAction", async (thisCommand) => {
         // Suppress zca-js internal logs in JSON mode to keep stdout clean for piping