zalo-agent-cli 1.0.23 → 1.0.24

package/README.md

@@ -231,6 +231,35 @@ zalo-agent whoami
 
 **Privacy settings:** `online-status`, `seen-status`, `birthday`, `receive-msg`, `accept-call`, `add-by-phone`, `add-by-qr`, `add-by-group`, `recommend`
 
+#### Polls (`poll`)
+
+| Command | Description |
+|---------|-------------|
+| `poll create <groupId> <question> <options...>` | Create a poll (see flags below) |
+| `poll info <pollId>` | View poll details and vote results |
+| `poll vote <pollId> <optionIds...>` | Vote on a poll (option IDs from `poll info`) |
+| `poll unvote <pollId>` | Remove your vote |
+| `poll add-option <pollId> <options...> [--vote]` | Add new options to a poll |
+| `poll lock <pollId>` | Close a poll (no more votes) |
+| `poll share <pollId>` | Share a poll |
+
+**Poll create flags:** `--multi` (multiple choices), `--add-options` (members can add options), `--anonymous` (hide voters), `--hide-preview` (hide results until voted), `--expire <minutes>` (auto-close)
+
+**Example:**
+```bash
+# Create a multi-choice poll with 3 options, auto-close after 60 minutes
+zalo-agent poll create <groupId> "Chọn ngày họp" "Thứ 2" "Thứ 4" "Thứ 6" --multi --expire 60
+
+# View results
+zalo-agent poll info <pollId>
+
+# Vote for option IDs 123 and 456
+zalo-agent poll vote <pollId> 123 456
+
+# Close the poll
+zalo-agent poll lock <pollId>
+```
+
 #### Accounts (`account`)
 
 | Command | Description |
@@ -470,6 +499,22 @@ zalo-agent profile settings
 zalo-agent profile set online-status 0
 ```
 
+#### 6. Tạo khảo sát (Poll) trong nhóm
+
+```bash
+# Tạo poll multi-choice, tự đóng sau 60 phút
+zalo-agent poll create <groupId> "Chọn ngày họp" "Thứ 2" "Thứ 4" "Thứ 6" --multi --expire 60
+
+# Xem kết quả
+zalo-agent poll info <pollId>
+
+# Bỏ phiếu (dùng option ID từ poll info)
+zalo-agent poll vote <pollId> 123 456
+
+# Đóng poll
+zalo-agent poll lock <pollId>
+```
+
 ### Danh sách lệnh
 
 Xem đầy đủ tại [phần tiếng Anh](#command-reference) phía trên. Tất cả lệnh đều giống nhau.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zalo-agent-cli",
-  "version": "1.0.23",
+  "version": "1.0.24",
   "description": "CLI tool for Zalo automation — multi-account, proxy support, bank transfers, QR payments",
   "type": "module",
   "bin": {

package/src/commands/poll.js

@@ -0,0 +1,159 @@
+/**
+ * Poll commands — create, view, vote, add options, lock, and share polls in groups.
+ */
+
+import { getApi } from "../core/zalo-client.js";
+import { success, error, info, output } from "../utils/output.js";
+
+export function registerPollCommands(program) {
+    const poll = program.command("poll").description("Create and manage polls in groups");
+
+    poll.command("create <groupId> <question> <options...>")
+        .description("Create a poll in a group (options separated by spaces, quote multi-word options)")
+        .option("--multi", "Allow multiple choices")
+        .option("--add-options", "Allow members to add new options")
+        .option("--anonymous", "Hide voter identities")
+        .option("--hide-preview", "Hide results until voted")
+        .option("--expire <minutes>", "Auto-close after N minutes", parseInt)
+        .action(async (groupId, question, options, opts) => {
+            try {
+                if (options.length < 2) {
+                    error("A poll requires at least 2 options.");
+                    return;
+                }
+                const expiredTime = opts.expire ? opts.expire * 60 * 1000 : 0;
+                const result = await getApi().createPoll(
+                    {
+                        question,
+                        options,
+                        allowMultiChoices: !!opts.multi,
+                        allowAddNewOption: !!opts.addOptions,
+                        isAnonymous: !!opts.anonymous,
+                        hideVotePreview: !!opts.hidePreview,
+                        expiredTime,
+                    },
+                    groupId,
+                );
+                output(result, program.opts().json, () => {
+                    success(`Poll created: "${question}"`);
+                    info(`Poll ID: ${result.poll_id}`);
+                    if (result.options) {
+                        result.options.forEach((o, i) => console.log(`  [${o.option_id}] ${o.content}`));
+                    }
+                });
+            } catch (e) {
+                error(`Create poll failed: ${e.message}`);
+            }
+        });
+
+    poll.command("info <pollId>")
+        .description("View poll details and results")
+        .action(async (pollId) => {
+            try {
+                const result = await getApi().getPollDetail(Number(pollId));
+                output(result, program.opts().json, () => {
+                    info(`Question: ${result.question}`);
+                    info(`Poll ID: ${result.poll_id}`);
+                    info(`Status: ${result.closed ? "Closed" : "Open"}`);
+                    info(`Total votes: ${result.num_vote}`);
+                    info(`Multi-choice: ${result.allow_multi_choices ? "Yes" : "No"}`);
+                    info(`Anonymous: ${result.is_anonymous ? "Yes" : "No"}`);
+                    if (result.expired_time > 0) {
+                        const expDate = new Date(result.expired_time);
+                        info(`Expires: ${expDate.toLocaleString()}`);
+                    }
+                    console.log();
+                    console.log("  ID    VOTES  OPTION");
+                    console.log("  " + "-".repeat(50));
+                    for (const o of result.options || []) {
+                        const voted = o.voted ? " ✓" : "";
+                        console.log(
+                            `  ${String(o.option_id).padEnd(6)} ${String(o.votes).padEnd(6)} ${o.content}${voted}`,
+                        );
+                    }
+                });
+            } catch (e) {
+                error(`Get poll failed: ${e.message}`);
+            }
+        });
+
+    poll.command("vote <pollId> <optionIds...>")
+        .description("Vote on a poll (use option IDs from 'poll info')")
+        .action(async (pollId, optionIds) => {
+            try {
+                const ids = optionIds.map(Number);
+                const result = await getApi().votePoll(Number(pollId), ids);
+                output(result, program.opts().json, () => {
+                    success(`Voted on poll ${pollId}`);
+                    if (result.options) {
+                        for (const o of result.options) {
+                            const voted = o.voted ? " ✓" : "";
+                            console.log(`  [${o.option_id}] ${o.content}: ${o.votes} vote(s)${voted}`);
+                        }
+                    }
+                });
+            } catch (e) {
+                error(`Vote failed: ${e.message}`);
+            }
+        });
+
+    poll.command("unvote <pollId>")
+        .description("Remove your vote from a poll")
+        .action(async (pollId) => {
+            try {
+                const result = await getApi().votePoll(Number(pollId), []);
+                output(result, program.opts().json, () => success(`Removed vote from poll ${pollId}`));
+            } catch (e) {
+                error(`Unvote failed: ${e.message}`);
+            }
+        });
+
+    poll.command("add-option <pollId> <options...>")
+        .description("Add new options to an existing poll")
+        .option("--vote", "Also vote for the new options")
+        .action(async (pollId, options, opts) => {
+            try {
+                const newOptions = options.map((content) => ({
+                    content,
+                    voted: !!opts.vote,
+                }));
+                const result = await getApi().addPollOptions({
+                    pollId: Number(pollId),
+                    options: newOptions,
+                    votedOptionIds: [],
+                });
+                output(result, program.opts().json, () => {
+                    success(`Added ${options.length} option(s) to poll ${pollId}`);
+                    if (result.options) {
+                        for (const o of result.options) {
+                            console.log(`  [${o.option_id}] ${o.content}: ${o.votes} vote(s)`);
+                        }
+                    }
+                });
+            } catch (e) {
+                error(`Add option failed: ${e.message}`);
+            }
+        });
+
+    poll.command("lock <pollId>")
+        .description("Lock/close a poll (no more votes)")
+        .action(async (pollId) => {
+            try {
+                const result = await getApi().lockPoll(Number(pollId));
+                output(result, program.opts().json, () => success(`Poll ${pollId} locked`));
+            } catch (e) {
+                error(`Lock poll failed: ${e.message}`);
+            }
+        });
+
+    poll.command("share <pollId>")
+        .description("Share a poll")
+        .action(async (pollId) => {
+            try {
+                const result = await getApi().sharePoll(Number(pollId));
+                output(result, program.opts().json, () => success(`Poll ${pollId} shared`));
+            } catch (e) {
+                error(`Share poll failed: ${e.message}`);
+            }
+        });
+}

package/src/commands/profile.js

@@ -18,7 +18,7 @@ const SETTING_MAP = {
         label: "Display seen status",
         values: { 0: "hidden", 1: "visible" },
     },
-    "birthday": {
+    birthday: {
         key: "view_birthday",
         label: "Birthday visibility",
         values: { 0: "hidden", 1: "full (day/month/year)", 2: "partial (day/month)" },
@@ -48,7 +48,7 @@ const SETTING_MAP = {
         label: "Find via group",
         values: { 0: "disabled", 1: "enabled" },
     },
-    "recommend": {
+    recommend: {
         key: "display_on_recommend_friend",
         label: "Show in friend recommendations",
         values: { 0: "disabled", 1: "enabled" },
@@ -111,7 +111,9 @@ export function registerProfileCommands(program) {
                     } else {
                         output({ bio: newBio, requested: text }, program.opts().json, () => {
                             success(`Bio update request sent: "${text}"`);
-                            info("Note: Zalo may take time to reflect changes, or bio may not be supported for your account type.");
+                            info(
+                                "Note: Zalo may take time to reflect changes, or bio may not be supported for your account type.",
+                            );
                         });
                     }
                 }
@@ -145,7 +147,7 @@ export function registerProfileCommands(program) {
                     profile: {
                         name: opts.name || p.displayName || p.zaloName,
                         dob: opts.dob || currentDob,
-                        gender: opts.gender !== undefined ? Number(opts.gender) : p.gender ?? 0,
+                        gender: opts.gender !== undefined ? Number(opts.gender) : (p.gender ?? 0),
                     },
                 };
                 const result = await getApi().updateProfile(payload);
@@ -193,14 +195,14 @@ export function registerProfileCommands(program) {
                 const numVal = Number(value);
                 if (!(numVal in meta.values)) {
                     error(
-                        `Invalid value for ${setting}. Valid: ${Object.entries(meta.values).map(([k, v]) => `${k}=${v}`).join(", ")}`,
+                        `Invalid value for ${setting}. Valid: ${Object.entries(meta.values)
+                            .map(([k, v]) => `${k}=${v}`)
+                            .join(", ")}`,
                     );
                     return;
                 }
                 const result = await getApi().updateSettings(meta.key, numVal);
-                output(result, program.opts().json, () =>
-                    success(`${meta.label}: ${meta.values[numVal]} (${numVal})`),
-                );
+                output(result, program.opts().json, () => success(`${meta.label}: ${meta.values[numVal]} (${numVal})`));
             } catch (e) {
                 error(`Setting update failed: ${e.message}`);
             }

package/src/index.js

@@ -19,12 +19,14 @@ import { registerGroupCommands } from "./commands/group.js";
 import { registerConvCommands } from "./commands/conv.js";
 import { registerAccountCommands } from "./commands/account.js";
 import { registerProfileCommands } from "./commands/profile.js";
+import { registerPollCommands } from "./commands/poll.js";
 import { registerListenCommand } from "./commands/listen.js";
 import { autoLogin } from "./core/zalo-client.js";
 import { checkForUpdates, selfUpdate } from "./utils/update-check.js";
 import { success, error, warning } from "./utils/output.js";
 
-const DISCLAIMER = "This tool uses unofficial Zalo APIs (zca-js) — your account may be banned. Use at your own risk. | Tool này dùng API Zalo không chính thức (zca-js) — account có thể bị ban. Tự chịu trách nhiệm.";
+const DISCLAIMER =
+    "This tool uses unofficial Zalo APIs (zca-js) — your account may be banned. Use at your own risk. | Tool này dùng API Zalo không chính thức (zca-js) — account có thể bị ban. Tự chịu trách nhiệm.";
 
 const program = new Command();
 
@@ -71,6 +73,7 @@ registerGroupCommands(program);
 registerConvCommands(program);
 registerAccountCommands(program);
 registerProfileCommands(program);
+registerPollCommands(program);
 registerListenCommand(program);
 
 program.parse();