openzca 0.1.45 → 0.1.46

package/README.md

@@ -126,6 +126,11 @@ For media debugging, grep these events in the debug log:
 | `openzca group info <groupId>` | Get group details |
 | `openzca group members <groupId>` | List members |
 | `openzca group create <name> <members...>` | Create a group |
+| `openzca group poll create <groupId>` | Create a poll (`--question`, repeatable `--option`, optional poll flags) |
+| `openzca group poll detail <pollId>` | Get poll details |
+| `openzca group poll vote <pollId>` | Vote on a poll with repeatable `--option <id>` |
+| `openzca group poll lock <pollId>` | Close a poll |
+| `openzca group poll share <pollId>` | Share a poll |
 | `openzca group rename <groupId> <name>` | Rename group |
 | `openzca group avatar <groupId> <file>` | Change group avatar |
 | `openzca group settings <groupId>` | Update settings (`--lock-name`, `--sign-admin`, etc.) |
@@ -146,6 +151,8 @@ For media debugging, grep these events in the debug log:
 | `openzca group leave <groupId>` | Leave group |
 | `openzca group disperse <groupId>` | Disperse group |
 
+Poll creation currently targets group threads only and maps to the existing `zca-js` group poll APIs. `group poll create` requires `--question` plus at least two `--option` values, and also supports `--multi`, `--allow-add-option`, `--hide-vote-preview`, `--anonymous`, and `--expire-ms`.
+
 ### friend — Friend management
 
 | Command | Description |

package/dist/cli.js

@@ -578,6 +578,60 @@ async function assertFilesExist(files) {
   }
 }
 
+// src/lib/group-poll.ts
+function parsePositiveInteger(value, label) {
+  const normalized = value.trim();
+  if (!/^[1-9]\d*$/.test(normalized)) {
+    throw new Error(`${label} must be a positive integer.`);
+  }
+  const parsed = Number.parseInt(normalized, 10);
+  if (!Number.isSafeInteger(parsed) || parsed <= 0) {
+    throw new Error(`${label} must be a positive integer.`);
+  }
+  return parsed;
+}
+function requireQuestion(value) {
+  const normalized = value?.trim() ?? "";
+  if (!normalized) {
+    throw new Error("Poll question is required.");
+  }
+  return normalized;
+}
+function normalizeOptions(values) {
+  const normalized = (values ?? []).map((value) => value.trim());
+  if (normalized.length < 2) {
+    throw new Error("Poll must include at least two options.");
+  }
+  for (let index = 0; index < normalized.length; index += 1) {
+    if (!normalized[index]) {
+      throw new Error(`Poll option ${index + 1} cannot be empty.`);
+    }
+  }
+  return normalized;
+}
+function parsePollId(value) {
+  return parsePositiveInteger(value, "Poll id");
+}
+function parsePollOptionIds(values) {
+  const optionIds = values ?? [];
+  if (optionIds.length === 0) {
+    throw new Error("Provide at least one option id.");
+  }
+  return optionIds.map((value) => parsePositiveInteger(value, "Option id"));
+}
+function buildCreatePollOptions(options) {
+  const expireMs = options.expireMs?.trim();
+  return {
+    question: requireQuestion(options.question),
+    options: normalizeOptions(options.option),
+    expiredTime: expireMs ? parsePositiveInteger(expireMs, "expire-ms") : void 0,
+    allowMultiChoices: Boolean(options.multi),
+    allowAddNewOption: Boolean(options.allowAddOption),
+    hideVotePreview: Boolean(options.hideVotePreview),
+    isAnonymous: Boolean(options.anonymous)
+  };
+}
+
 // src/lib/text-send.ts
 import { ThreadType } from "zca-js";
 
@@ -3867,6 +3921,51 @@ group.command("create <name> <members...>").description("Create new group").acti
     output(response, false);
   })
 );
+var groupPoll = group.command("poll").description("Group poll management");
+groupPoll.command("create <groupId>").requiredOption("-q, --question <text>", "Poll question").requiredOption("-o, --option <text>", "Poll option (repeatable)", collectValues, []).option("--multi", "Allow multiple choices").option("--allow-add-option", "Allow members to add new options").option("--hide-vote-preview", "Hide results until the member votes").option("--anonymous", "Hide voters").option("--expire-ms <ms>", "Poll expiration time in milliseconds").description("Create a poll in a group").action(
+  wrapAction(
+    async (groupId, opts, command) => {
+      const pollOptions = buildCreatePollOptions(opts);
+      const { api } = await requireApi(command);
+      output(await api.createPoll(pollOptions, groupId), false);
+    }
+  )
+);
+groupPoll.command("detail <pollId>").description("Get poll detail").action(
+  wrapAction(async (pollId, command) => {
+    const normalizedPollId = parsePollId(pollId);
+    const { api } = await requireApi(command);
+    output(await api.getPollDetail(normalizedPollId), false);
+  })
+);
+groupPoll.command("vote <pollId>").requiredOption("-o, --option <id>", "Poll option id (repeatable)", collectValues, []).description("Vote on a group poll").action(
+  wrapAction(
+    async (pollId, opts, command) => {
+      const normalizedPollId = parsePollId(pollId);
+      const optionIds = parsePollOptionIds(opts.option);
+      const { api } = await requireApi(command);
+      const response = await api.votePoll(
+        normalizedPollId,
+        optionIds.length === 1 ? optionIds[0] : optionIds
+      );
+      output(response, false);
+    }
+  )
+);
+groupPoll.command("lock <pollId>").description("Close a poll").action(
+  wrapAction(async (pollId, command) => {
+    const normalizedPollId = parsePollId(pollId);
+    const { api } = await requireApi(command);
+    output(await api.lockPoll(normalizedPollId), false);
+  })
+);
+groupPoll.command("share <pollId>").description("Share a poll").action(
+  wrapAction(async (pollId, command) => {
+    const normalizedPollId = parsePollId(pollId);
+    const { api } = await requireApi(command);
+    output(await api.sharePoll(normalizedPollId), false);
+  })
+);
 group.command("rename <groupId> <name>").description("Rename group").action(
   wrapAction(async (groupId, name, command) => {
     const { api } = await requireApi(command);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openzca",
-  "version": "0.1.45",
+  "version": "0.1.46",
   "description": "Open-source zca-compatible CLI to integrate Zalo with OpenClaw",
   "type": "module",
   "bin": {
@@ -16,6 +16,7 @@
   "scripts": {
     "build": "tsup src/cli.ts --format esm --target node18 --out-dir dist --clean",
     "dev": "tsx src/cli.ts",
+    "test": "tsx --test tests/*.test.ts",
     "typecheck": "tsc -p tsconfig.json",
     "lint": "tsc -p tsconfig.json --noEmit",
     "prepublishOnly": "npm run build"