@wirecat/cli-core 0.20.0 → 0.263.0

package/dist/cli/messenger/polls-command.js

@@ -0,0 +1,128 @@
+import { CliError } from "@wirecat/cli-base";
+import { annotate } from "@wirecat/cli-base/commands";
+import { Command } from "commander";
+import { closeAfterOf, closeRange, guardedClose, guardedCreatePoll, guardedVote, pollVoters, quizOf, } from "../../sends/polls.js";
+import { typedSendAs } from "../../sends/send-as.js";
+import { positiveCount } from "../paging.js";
+import { messengerContext } from "./context.js";
+import { capability } from "./port.js";
+import { threadIdOf } from "./thread.js";
+/**
+ * `polls show|vote|close|create`. An answer is named by its id, as `polls show` prints it — never by
+ * position, which changes nothing for a person and everything for a vote.
+ */
+export const pollsCommand = (messenger) => {
+    const polls = new Command("polls").description("read a poll, vote in it, close your own, create one");
+    polls
+        .command("show")
+        .description("a poll and its answer ids, as the message carries it now")
+        .argument("<chat>", messenger.chatArgument)
+        .argument("<message>", "the id of the message that carries the poll")
+        .action(async function (chat, message) {
+        const context = messengerContext(this, messenger);
+        context.renderer.result(await context.withMessenger(async (connection) => {
+            const poll = capability(connection, "poll", "read a poll");
+            return poll((await connection.resolve(chat)).id, message.trim());
+        }));
+    });
+    if (messenger.pollVoters)
+        polls
+            .command("voters")
+            .description("who voted for what, newest first; not in an anonymous poll")
+            .argument("<chat>", messenger.chatArgument)
+            .argument("<message>", "the id of the message that carries the poll")
+            .option("--answer <id>", "only those who chose this answer, as `polls show` prints it")
+            .option("--limit <n>", "how many", positiveCount("--limit"))
+            .action(async function (chat, message) {
+            const context = messengerContext(this, messenger);
+            const { answer } = this.opts();
+            const { limit } = context.settings;
+            const found = await context.withMessenger((connection) => pollVoters(connection, {
+                chat,
+                message: message.trim(),
+                limit,
+                ...(answer === undefined ? {} : { answer: answer.trim() }),
+            }));
+            if (context.format === "json")
+                context.renderer.result(found);
+            else
+                context.renderer.stream(found.items);
+            if (found.hasMore)
+                context.renderer.note(`more voters: raise --limit above ${limit}`);
+        });
+    annotate(polls.command("vote"), { mutates: true })
+        .description("vote in a poll, or take your vote back; the others see it unless the poll is anonymous")
+        .argument("<chat>", messenger.chatArgument)
+        .argument("<message>", "the id of the message that carries the poll")
+        .argument("[answers...]", "answer ids, as `polls show` prints them")
+        .option("--retract", "take your vote back")
+        .action(async function (chat, message, answers) {
+        const context = messengerContext(this, messenger);
+        const { retract } = this.opts();
+        if (retract && answers.length > 0) {
+            throw new CliError("validation_error", "`--retract` takes no answers: it removes the vote you have");
+        }
+        if (!retract && answers.length === 0) {
+            throw new CliError("validation_error", "name at least one answer id (`polls show` prints them), or pass --retract");
+        }
+        context.renderer.result(await context.withMessenger((connection) => guardedVote(context.guard, connection, {
+            chat,
+            message: message.trim(),
+            answers: answers.map((a) => a.trim()),
+        })));
+    });
+    annotate(polls.command("close"), { mutates: true })
+        .description("close your own poll; nobody can vote after that, and it cannot be reopened")
+        .argument("<chat>", messenger.chatArgument)
+        .argument("<message>", "the id of your own message that carries the poll")
+        .action(async function (chat, message) {
+        const context = messengerContext(this, messenger);
+        context.renderer.result(await context.withMessenger((connection) => guardedClose(context.guard, connection, { chat, message: message.trim() })));
+    });
+    const create = annotate(polls.command("create"), { mutates: true })
+        .description("send a poll to a chat, as a message of its own; public unless --anonymous")
+        .argument("<chat>", messenger.chatArgument)
+        .argument("<question>", "the question")
+        .argument("<answers...>", "two answers or more")
+        .option("--topic <id>", "send to this forum topic; unsupported by messengers without topics")
+        .option("--multiple", "people may pick several answers")
+        .option("--anonymous", "nobody sees who voted for what")
+        .option("--revote", "people may change their vote")
+        .option("--silent", "send without a notification")
+        .option("--send-as <id>", "post as one of the identities `chats send-as` lists; required where the chat posts as someone else by default")
+        .option("--send-id <id>", "repeat a create whose outcome was unknown, without risking a second poll");
+    if (messenger.pollQuiz)
+        create
+            .option("--quiz", "a quiz: one answer is right, and a vote is final")
+            .option("--correct <n>", "with --quiz: the right answer's position, from 1", positiveCount("--correct"))
+            .option("--solution <text>", "with --quiz: what people see once they answered");
+    if (messenger.pollCloseSeconds)
+        create.option("--close-time <delay>", `it closes by itself this long after sending: ${closeRange(messenger.pollCloseSeconds)}, like 90s or 5m`);
+    create.action(async function (chat, question, answers) {
+        const context = messengerContext(this, messenger);
+        const { multiple, anonymous, revote, silent, sendId, topic, sendAs: given, quiz, correct, solution, closeTime, } = this.opts();
+        const threadId = threadIdOf(topic);
+        const sendAs = typedSendAs(given);
+        const asQuiz = quizOf({ quiz, correct, solution });
+        const closeAfter = closeAfterOf(closeTime, messenger.pollCloseSeconds);
+        const sent = await context.withMessenger((connection) => guardedCreatePoll(context.guard, connection, {
+            chat,
+            ...(threadId === undefined ? {} : { threadId }),
+            poll: {
+                question,
+                answers,
+                multiple: multiple === true,
+                anonymous: anonymous === true,
+                revote: revote === true,
+                ...(asQuiz === undefined ? {} : { quiz: asQuiz }),
+                ...(closeAfter === undefined ? {} : { closeAfter }),
+            },
+            silent: silent === true,
+            ...(sendId === undefined ? {} : { sendId }),
+            ...(sendAs === undefined ? {} : { sendAs }),
+        }));
+        context.renderer.result({ sendId: sent.sendId, operationId: sent.operationId, message: sent.message });
+    });
+    return polls;
+};
+//# sourceMappingURL=polls-command.js.map

package/dist/cli/messenger/polls-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"polls-command.js","sourceRoot":"","sources":["../../../src/cli/messenger/polls-command.ts"],"names":[],"mappings":"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"}