@wirecat/cli-core 0.20.0 → 0.262.0

package/dist/sends/permissions.js

@@ -0,0 +1,434 @@
+import { CliError } from "@wirecat/cli-base";
+/**
+ * What a profile may be allowed to do (max-cli `CLI-37`, `NEED-251`). One name per thing the owner would
+ * recognise, so `sessions` — which logs the owner out of their phone — never rides along with
+ * adding a contact. There is no `*`: "everything" is not setting `allow` at all, and a wildcard
+ * would switch on `delete` without anyone naming it.
+ */
+export const PERMISSIONS = [
+    "send",
+    "forward",
+    "reaction",
+    "edit",
+    "pin",
+    "read",
+    "delete",
+    "groups",
+    "contacts",
+    "profile",
+    "folders",
+    "sessions",
+];
+const ACCOUNT = {
+    "contact-add": "contacts",
+    "contact-remove": "contacts",
+    "contact-import": "contacts",
+    "contact-rename": "contacts",
+    "contact-block": "contacts",
+    "contact-unblock": "contacts",
+    profile: "profile",
+    "folder-create": "folders",
+    "folder-update": "folders",
+    "folder-delete": "folders",
+    "folder-order": "folders",
+    "folder-join": "folders",
+    "sessions-end": "sessions",
+    "chat-mute": "profile",
+    privacy: "profile",
+};
+export const permissionFor = (kind, action) => {
+    switch (kind) {
+        case "message":
+            return "send";
+        case "chat":
+            return "groups";
+        case "account": {
+            const permission = ACCOUNT[action];
+            if (!permission)
+                throw new Error(`an account change without a known action: ${action}`);
+            return permission;
+        }
+        default:
+            return kind;
+    }
+};
+/** What a profile may do with one command path — the standard's "Permissions". */
+export const LEVELS = ["deny", "readonly", "ask", "allow"];
+/** The deletions nobody gets back: the word that skips their question is `--allow-dangerous`, never `--yes`. */
+const DANGEROUS = new Set(["messages.delete", "bot.messages.delete", "topics.delete", "chats.delete", "chats.clear"]);
+/** Deleting has its own word for "yes": the flag a person has to mean, not a habit (max-cli `NEED-238`). */
+export const skipFlagFor = (key) => DANGEROUS.has(key) ? "--allow-dangerous" : "--yes";
+/** Only what cannot be undone asks; the tool is meant to work without questions (owner, NEED-460). */
+export const DEFAULT_PERMISSIONS = {
+    "messages.delete": "ask",
+    "account.sessions.end": "ask",
+    "bot.messages.delete": "ask",
+    "topics.enable": "ask",
+    "topics.delete": "ask",
+    "chats.delete": "ask",
+    "chats.clear": "ask",
+    // NEED-568: a rule writes to people with nobody typing a command; it waits for the owner's own allow.
+    "replies.send": "deny",
+};
+/** The resources at the top of the command tree, which `readOnly` and `allow` turn read-only as a whole. */
+export const RESOURCES = [
+    "messages",
+    "reactions",
+    "polls",
+    "topics",
+    "chats",
+    "contacts",
+    "account",
+    "bot",
+    "conversations",
+    "tags",
+    "search",
+    "searches",
+    "tasks",
+    "replies",
+    "attachments",
+    "stats",
+    "store",
+    "metadata",
+];
+const OLD_WORDS = {
+    send: ["messages.send", "polls.create", "chats.start"],
+    forward: ["messages.forward"],
+    reaction: ["reactions", "polls.vote", "messages.press", "chats.app"],
+    edit: ["messages.edit", "polls.close"],
+    pin: ["messages.pin", "messages.unpin"],
+    read: ["chats.mark-read"],
+    delete: ["messages.delete", "chats.delete", "chats.clear"],
+    groups: [
+        "chats.create",
+        "chats.update",
+        "chats.join",
+        "chats.leave",
+        "chats.members",
+        "chats.admins",
+        "chats.link",
+        "chats.requests",
+        "chats.moderate",
+        "topics.enable",
+        "topics.create",
+        "topics.edit",
+        "topics.delete",
+    ],
+    contacts: ["contacts"],
+    profile: ["account.update", "account.privacy.set", "chats.mute"],
+    folders: ["chats.folders"],
+    sessions: ["account.sessions.end"],
+};
+/** The command path an old `allow` word stood for, as one key — what an MCP tool's `permission` is checked against. */
+export const keyOfWord = (word) => OLD_WORDS[word][0];
+/** `readOnly` and `allow` as levels, so a file written before `permissions` keeps meaning what it meant. */
+/**
+ * A bot's old words meant its own writes: `profile` was its command menu, and `read` was taking
+ * updates, which every level but `deny` allows now.
+ */
+const botKeysOf = (word) => {
+    if (word === "profile")
+        return ["bot.commands"];
+    if (word === "read")
+        return [];
+    return OLD_WORDS[word].map((key) => `bot.${key}`);
+};
+/** `bot` translates a bot's `readOnly` and `allow`, which only ever covered the bot. */
+export const fromOldSettings = (readOnly, allow, { bot = false } = {}) => {
+    if (!readOnly && allow === undefined)
+        return {};
+    const levels = bot
+        ? { bot: "readonly" }
+        : Object.fromEntries(RESOURCES.filter((resource) => resource !== "bot").map((resource) => [resource, "readonly"]));
+    if (readOnly)
+        return levels;
+    // A deletion needed its flag whatever `allow` said, so it keeps asking.
+    for (const word of allow ?? []) {
+        for (const key of bot ? botKeysOf(word) : OLD_WORDS[word])
+            levels[key] = DEFAULT_PERMISSIONS[key] ?? "allow";
+    }
+    return levels;
+};
+/**
+ * Layers come nearest first. A key a nearer layer sets hides that key and every key under it in the
+ * farther layers, so a profile's `messages: readonly` is not undone by `messages.delete: allow` in
+ * `defaults` — the nearest section wins, as it does for every other setting (NEED-573).
+ */
+export const layerPermissions = (layers) => {
+    const levels = {};
+    const sources = {};
+    for (const [from, layer] of layers) {
+        const nearer = Object.keys(levels);
+        for (const [key, level] of Object.entries(layer ?? {})) {
+            if (nearer.some((named) => key === named || key.startsWith(`${named}.`)))
+                continue;
+            levels[key] = level;
+            sources[key] = from;
+        }
+    }
+    return { levels, sources };
+};
+const ALLOWED = { level: "allow", key: null };
+const ORDER = { deny: 0, readonly: 1, ask: 2, allow: 3 };
+const nearest = (levels, key) => {
+    for (let parts = key.split("."); parts.length > 0; parts = parts.slice(0, -1)) {
+        const named = parts.join(".");
+        const level = levels[named];
+        if (level)
+            return { level, key: named, depth: parts.length };
+    }
+    return undefined;
+};
+/**
+ * The most specific key the owner set wins. A built-in default (`DEFAULT_PERMISSIONS`) only ever
+ * tightens: against a broader key of the owner's, the stricter of the two holds — so
+ * `messages: readonly` still stops a deletion, and `messages: allow` does not drop its question.
+ * A path nothing names is allowed.
+ */
+export const levelFor = (permissions, key, defaults = DEFAULT_PERMISSIONS) => {
+    const own = nearest(permissions, key);
+    const builtIn = nearest(defaults, key);
+    if (!builtIn || (own && own.depth >= builtIn.depth))
+        return own ? { level: own.level, key: own.key } : ALLOWED;
+    if (!own || ORDER[builtIn.level] <= ORDER[own.level])
+        return { level: builtIn.level, key: builtIn.key };
+    return { level: own.level, key: own.key };
+};
+const CHAT_KEYS = { settings: "chats.update" };
+const ACCOUNT_KEYS = {
+    "contact-add": "contacts.add",
+    "contact-remove": "contacts.remove",
+    "contact-import": "contacts.import",
+    "contact-rename": "contacts.rename",
+    "contact-block": "contacts.block",
+    "contact-unblock": "contacts.unblock",
+    profile: "account.update",
+    "folder-create": "chats.folders.create",
+    "folder-update": "chats.folders.update",
+    "folder-delete": "chats.folders.delete",
+    "folder-order": "chats.folders.order",
+    "folder-join": "chats.folders.join",
+    "sessions-end": "account.sessions.end",
+    "chat-mute": "chats.mute",
+    privacy: "account.privacy.set",
+};
+const KIND_KEYS = {
+    message: "messages.send",
+    forward: "messages.forward",
+    edit: "messages.edit",
+    pin: "messages.pin",
+    reaction: "reactions",
+    read: "chats.mark-read",
+    delete: "messages.delete",
+};
+/** The command path a guarded write belongs to, when the caller did not name it. */
+export const keyForWrite = (kind, action) => {
+    if (kind === "chat")
+        return CHAT_KEYS[action ?? ""] ?? `chats.${action ?? "update"}`;
+    if (kind === "account") {
+        const key = ACCOUNT_KEYS[action];
+        if (!key)
+            throw new Error(`an account change without a known action: ${action}`);
+        return key;
+    }
+    return KIND_KEYS[kind];
+};
+/** Write keys written out where a write is checked; `permission-keys.test.ts` keeps this list whole. */
+const NAMED_WRITE_KEYS = [
+    "store.gaps.repair",
+    "messages.sync-first",
+    "messages.server-search",
+    "messages.press",
+    "chats.start",
+    "chats.app",
+    "stats.messages.counters.refresh",
+    "stats.messages.show.sync-first",
+    "stats.messages.top.sync-first",
+    "stats.contacts.top.sync-first",
+    "account.sessions.list",
+    "attachments.extract",
+    "attachments.text.set",
+    "bot.callbacks.answer",
+    "bot.chats.action",
+    "bot.chats.admins.add",
+    "bot.chats.admins.remove",
+    "bot.chats.leave",
+    "bot.chats.members.remove",
+    "bot.chats.moderate",
+    "bot.messages.delete",
+    "bot.messages.edit",
+    "bot.messages.pin",
+    "bot.messages.send",
+    "bot.messages.unpin",
+    "chats.admins.add",
+    "chats.admins.remove",
+    "chats.link.create",
+    "chats.link.reset",
+    "chats.link.revoke",
+    "chats.link.update",
+    "chats.members.add",
+    "chats.members.remove",
+    "chats.moderate",
+    "conversations.embed",
+    "conversations.links",
+    "polls.close",
+    "polls.create",
+    "polls.vote",
+    "searches.clear",
+    "searches.create",
+    "searches.delete",
+    "contacts.alias.set",
+    "contacts.alias.rm",
+    "contacts.notes.add",
+    "contacts.notes.edit",
+    "contacts.notes.remove",
+    "tags.auto",
+    "metadata.refresh",
+    "tags.add",
+    "tags.remove",
+    "tasks.add",
+    "tasks.close",
+    "tasks.link",
+    "tasks.plan",
+    "topics.create",
+    "topics.edit",
+    "topics.enable",
+];
+/** Every key a write is checked against that a command path may not spell out. */
+export const WRITE_KEYS = [
+    ...new Set([
+        ...NAMED_WRITE_KEYS,
+        ...Object.keys(DEFAULT_PERMISSIONS),
+        ...Object.values(KIND_KEYS),
+        ...Object.values(ACCOUNT_KEYS),
+        ...Object.values(CHAT_KEYS),
+        ...PERMISSIONS.flatMap((word) => [...OLD_WORDS[word], ...botKeysOf(word)]),
+    ]),
+];
+/** Commands that look after the tool and its files and never show a message: no level stops them. */
+const HOUSEKEEPING = new Set([
+    "config",
+    "session",
+    "doctor",
+    "commands",
+    "complete",
+    "upgrade",
+    "skill",
+    "models",
+    "server",
+    // What a schedule runs is checked by its own key when it runs; an agent runs read-only.
+    "schedule",
+    "runs",
+    "sends",
+    "recipients",
+    "flood",
+    "mcp",
+    // Its commands read the rules or flip the pause switch; what a rule sends is checked as `replies.send`.
+    "replies",
+]);
+/** Under `bot`: its token, its names, its lists and its MCP server. */
+const BOT_HOUSEKEEPING = new Set(["auth", "list", "sends", "recipients", "mcp"]);
+const STORE_MAINTENANCE = new Set(["info", "check", "migrate", "backup", "restore", "repair", "copies"]);
+/** Commands outside `messages` that print what people wrote, so `deny messages` reaches them too. */
+const SHOW_MESSAGES = new Set(["inbox", "review", "watch", "serve", "store", "conversations"]);
+/** Before every search moved under `search` (2026-10-09): `config migrate` rewrites these. */
+const OLD_SEARCH_KEY = /^(bot\.)?(messages|conversations|topics)\.search(?:\.|$)/;
+/** Statistics and searches moved; a profile still naming the old paths must be migrated before they run. */
+export const assertStatsPermissionsCurrent = (path, permissions) => {
+    if (path[0] === "bot") {
+        assertStatsPermissionsCurrent(path.slice(1), permissions);
+        return;
+    }
+    if (path[0] === "search" && Object.keys(permissions).some((key) => OLD_SEARCH_KEY.test(key)))
+        throw new CliError("configuration_error", "search permission paths have moved — run config migrate before searching", { retryable: false });
+    if (path[0] !== "stats")
+        return;
+    if (Object.keys(permissions).some((key) => /^(bot\.)?(messages|chats|tasks)\.stats(?:\.|$)/.test(key)))
+        throw new CliError("configuration_error", "statistics permission paths have moved — run config migrate before reading statistics", { retryable: false });
+};
+export const readKeysForCommand = (path) => {
+    if (path[0] === "bot")
+        return readKeysForCommand(path.slice(1)).map((key) => `bot.${key}`);
+    const key = keyForCommand(path);
+    if (!key)
+        return [];
+    if (path[0] === "attachments" && (path[1] === "extract" || path[1] === "show"))
+        return [key, "messages"];
+    if (path[0] === "store" && path[1] === "gaps" && path[2] === "repair")
+        return [key, "messages"];
+    // A search shows what people wrote, so `deny messages` reaches every leaf that reads messages.
+    if (path[0] === "search") {
+        if (path[1] === "notes")
+            return [key];
+        if (path[1] === "topics")
+            return [key, "topics"];
+        if (path[1] === "conversations")
+            return [key, "messages", "conversations"];
+        return [key, "messages"];
+    }
+    if (path[0] !== "stats")
+        return [key];
+    const resource = path[1] === "charts" ? "chats" : path[1];
+    return [
+        ...new Set([
+            key,
+            "messages",
+            ...(["chats", "contacts", "tasks"].includes(resource ?? "") ? [resource] : []),
+        ]),
+    ];
+};
+/**
+ * The key a command path is checked against: `null` for housekeeping, which no level stops, and
+ * `undefined` for a path this package does not know — a CLI's own command, which its CLI maps.
+ */
+export const keyForCommand = (path) => {
+    const [top, next] = path;
+    if (top === "bot") {
+        if (next === undefined || BOT_HOUSEKEEPING.has(next))
+            return null;
+        const inner = keyForCommand(path.slice(1));
+        return `bot.${inner ?? path.slice(1).join(".")}`;
+    }
+    if (top === undefined || HOUSEKEEPING.has(top))
+        return null;
+    if (top === "store" && next !== undefined && STORE_MAINTENANCE.has(next))
+        return null;
+    // The agent's answers write only to the local store: their own key, so read-only messages can still link (phase 4 A10).
+    if (top === "conversations" && next === "links")
+        return "conversations.links";
+    // Vectors are written to the local store only, and the text never leaves the machine (phase 5 E10).
+    if (top === "conversations" && next === "embed")
+        return "conversations.embed";
+    // Which files a message has, and where they are saved, tells as much as a message does; so does who
+    // shared which document link, and when.
+    if ((top === "attachments" && next === "list") || (top === "chats" && next === "documents"))
+        return "messages";
+    if (top === "store" && (next === "gaps" || next === "jobs"))
+        return path.join(".");
+    if (top === "messages" && next === "sync")
+        return "messages";
+    if (SHOW_MESSAGES.has(top) || (top === "contacts" && (next === "context" || next === "timeline")))
+        return "messages";
+    if (RESOURCES.includes(top))
+        return path.join(".");
+    return undefined;
+};
+/** Startup overrides are a nearer layer than the saved profile, and never write that profile. */
+export const permissionOverrides = (entries = []) => {
+    const levels = {};
+    const path = new RegExp(`^(${RESOURCES.join("|")})(\\.[a-z][a-z-]*)*$`);
+    for (const entry of entries) {
+        const [key = "", level = "", extra] = entry.split("=");
+        if (!path.test(key) || !LEVELS.includes(level) || extra !== undefined)
+            throw new CliError("validation_error", "--permission takes a command path and level, e.g. messages.send=allow (deny, readonly, ask, allow)");
+        levels[key] = level;
+    }
+    return levels;
+};
+export const assertRetentionEvidenceRead = (permissions) => {
+    for (const permission of ["stats.chats.retention", "chats"]) {
+        if (levelFor(permissions, permission).level === "deny")
+            throw new CliError("permission_error", `profile denies ${permission}`, { permission });
+    }
+};
+//# sourceMappingURL=permissions.js.map

package/dist/sends/permissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../../src/sends/permissions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAG5C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,MAAM;IACN,SAAS;IACT,UAAU;IACV,MAAM;IACN,KAAK;IACL,MAAM;IACN,QAAQ;IACR,QAAQ;IACR,UAAU;IACV,SAAS;IACT,SAAS;IACT,UAAU;CACF,CAAA;AAIV,MAAM,OAAO,GAAsC;IACjD,aAAa,EAAE,UAAU;IACzB,gBAAgB,EAAE,UAAU;IAC5B,gBAAgB,EAAE,UAAU;IAC5B,gBAAgB,EAAE,UAAU;IAC5B,eAAe,EAAE,UAAU;IAC3B,iBAAiB,EAAE,UAAU;IAC7B,OAAO,EAAE,SAAS;IAClB,eAAe,EAAE,SAAS;IAC1B,eAAe,EAAE,SAAS;IAC1B,eAAe,EAAE,SAAS;IAC1B,cAAc,EAAE,SAAS;IACzB,aAAa,EAAE,SAAS;IACxB,cAAc,EAAE,UAAU;IAC1B,WAAW,EAAE,SAAS;IACtB,OAAO,EAAE,SAAS;CACnB,CAAA;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAc,EAAE,MAAe,EAAc,EAAE;IAC3E,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,SAAS;YACZ,OAAO,MAAM,CAAA;QACf,KAAK,MAAM;YACT,OAAO,QAAQ,CAAA;QACjB,KAAK,SAAS,EAAE,CAAC;YACf,MAAM,UAAU,GAAG,OAAO,CAAC,MAAuB,CAAC,CAAA;YACnD,IAAI,CAAC,UAAU;gBAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,MAAM,EAAE,CAAC,CAAA;YACvF,OAAO,UAAU,CAAA;QACnB,CAAC;QACD;YACE,OAAO,IAAI,CAAA;IACf,CAAC;AACH,CAAC,CAAA;AAED,kFAAkF;AAClF,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,CAAU,CAAA;AAOnE,gHAAgH;AAChH,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,iBAAiB,EAAE,qBAAqB,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC,CAAA;AAErH,4GAA4G;AAC5G,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,GAAW,EAAiC,EAAE,CACxE,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,OAAO,CAAA;AAEpD,sGAAsG;AACtG,MAAM,CAAC,MAAM,mBAAmB,GAA2C;IACzE,iBAAiB,EAAE,KAAK;IACxB,sBAAsB,EAAE,KAAK;IAC7B,qBAAqB,EAAE,KAAK;IAC5B,eAAe,EAAE,KAAK;IACtB,eAAe,EAAE,KAAK;IACtB,cAAc,EAAE,KAAK;IACrB,aAAa,EAAE,KAAK;IACpB,sGAAsG;IACtG,cAAc,EAAE,MAAM;CACvB,CAAA;AAED,4GAA4G;AAC5G,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,UAAU;IACV,WAAW;IACX,OAAO;IACP,QAAQ;IACR,OAAO;IACP,UAAU;IACV,SAAS;IACT,KAAK;IACL,eAAe;IACf,MAAM;IACN,QAAQ;IACR,UAAU;IACV,OAAO;IACP,SAAS;IACT,aAAa;IACb,OAAO;IACP,OAAO;IACP,UAAU;CACF,CAAA;AAEV,MAAM,SAAS,GAAwC;IACrD,IAAI,EAAE,CAAC,eAAe,EAAE,cAAc,EAAE,aAAa,CAAC;IACtD,OAAO,EAAE,CAAC,kBAAkB,CAAC;IAC7B,QAAQ,EAAE,CAAC,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,WAAW,CAAC;IACpE,IAAI,EAAE,CAAC,eAAe,EAAE,aAAa,CAAC;IACtC,GAAG,EAAE,CAAC,cAAc,EAAE,gBAAgB,CAAC;IACvC,IAAI,EAAE,CAAC,iBAAiB,CAAC;IACzB,MAAM,EAAE,CAAC,iBAAiB,EAAE,cAAc,EAAE,aAAa,CAAC;IAC1D,MAAM,EAAE;QACN,cAAc;QACd,cAAc;QACd,YAAY;QACZ,aAAa;QACb,eAAe;QACf,cAAc;QACd,YAAY;QACZ,gBAAgB;QAChB,gBAAgB;QAChB,eAAe;QACf,eAAe;QACf,aAAa;QACb,eAAe;KAChB;IACD,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,CAAC,gBAAgB,EAAE,qBAAqB,EAAE,YAAY,CAAC;IAChE,OAAO,EAAE,CAAC,eAAe,CAAC;IAC1B,QAAQ,EAAE,CAAC,sBAAsB,CAAC;CACnC,CAAA;AAED,uHAAuH;AACvH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAgB,EAAiB,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAkB,CAAA;AAEjG,4GAA4G;AAC5G;;;GAGG;AACH,MAAM,SAAS,GAAG,CAAC,IAAgB,EAAmB,EAAE;IACtD,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,CAAC,cAAc,CAAC,CAAA;IAC/C,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,EAAE,CAAA;IAC9B,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,GAAG,EAAE,CAAC,CAAA;AACnD,CAAC,CAAA;AAED,wFAAwF;AACxF,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,QAAiB,EACjB,KAAwC,EACxC,EAAE,GAAG,GAAG,KAAK,EAAE,GAAsB,EAAE,EACT,EAAE;IAChC,IAAI,CAAC,QAAQ,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAA;IAC/C,MAAM,MAAM,GAAiC,GAAG;QAC9C,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE;QACrB,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,CAAA;IACpH,IAAI,QAAQ;QAAE,OAAO,MAAM,CAAA;IAC3B,wEAAwE;IACxE,KAAK,MAAM,IAAI,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;QAC/B,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,mBAAmB,CAAC,GAAG,CAAC,IAAI,OAAO,CAAA;IAC9G,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAA+E,EAAE,EAAE;IAClH,MAAM,MAAM,GAAiC,EAAE,CAAA;IAC/C,MAAM,OAAO,GAAkC,EAAE,CAAA;IACjD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAClC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;YACvD,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,KAAK,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;gBAAE,SAAQ;YAClF,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;YACnB,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAA;QACrB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAA;AAC5B,CAAC,CAAA;AAED,MAAM,OAAO,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAW,CAAA;AAEtD,MAAM,KAAK,GAA0B,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAA;AAE/E,MAAM,OAAO,GAAG,CAAC,MAA8C,EAAE,GAAkB,EAAE,EAAE;IACrF,KAAK,IAAI,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9E,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;QAC3B,IAAI,KAAK;YAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,CAAA;IAC9D,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CACtB,WAAmD,EACnD,GAAkB,EAClB,QAAQ,GAA2C,mBAAmB,EACzB,EAAE;IAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAA;IACrC,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAA;IACtC,IAAI,CAAC,OAAO,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,CAAA;IAC9G,IAAI,CAAC,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAA;IACvG,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAA;AAC3C,CAAC,CAAA;AAED,MAAM,SAAS,GAA2C,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAA;AAEtF,MAAM,YAAY,GAAyC;IACzD,aAAa,EAAE,cAAc;IAC7B,gBAAgB,EAAE,iBAAiB;IACnC,gBAAgB,EAAE,iBAAiB;IACnC,gBAAgB,EAAE,iBAAiB;IACnC,eAAe,EAAE,gBAAgB;IACjC,iBAAiB,EAAE,kBAAkB;IACrC,OAAO,EAAE,gBAAgB;IACzB,eAAe,EAAE,sBAAsB;IACvC,eAAe,EAAE,sBAAsB;IACvC,eAAe,EAAE,sBAAsB;IACvC,cAAc,EAAE,qBAAqB;IACrC,aAAa,EAAE,oBAAoB;IACnC,cAAc,EAAE,sBAAsB;IACtC,WAAW,EAAE,YAAY;IACzB,OAAO,EAAE,qBAAqB;CAC/B,CAAA;AAED,MAAM,SAAS,GAAiE;IAC9E,OAAO,EAAE,eAAe;IACxB,OAAO,EAAE,kBAAkB;IAC3B,IAAI,EAAE,eAAe;IACrB,GAAG,EAAE,cAAc;IACnB,QAAQ,EAAE,WAAW;IACrB,IAAI,EAAE,iBAAiB;IACvB,MAAM,EAAE,iBAAiB;CAC1B,CAAA;AAED,oFAAoF;AACpF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAc,EAAE,MAAe,EAAiB,EAAE;IAC5E,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,SAAS,CAAC,MAAM,IAAI,EAAE,CAAC,IAAI,SAAS,MAAM,IAAI,QAAQ,EAAE,CAAA;IACpF,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,YAAY,CAAC,MAAuB,CAAC,CAAA;QACjD,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,MAAM,EAAE,CAAC,CAAA;QAChF,OAAO,GAAG,CAAA;IACZ,CAAC;IACD,OAAO,SAAS,CAAC,IAAI,CAAC,CAAA;AACxB,CAAC,CAAA;AAED,wGAAwG;AACxG,MAAM,gBAAgB,GAAG;IACvB,mBAAmB;IACnB,qBAAqB;IACrB,wBAAwB;IACxB,gBAAgB;IAChB,aAAa;IACb,WAAW;IACX,iCAAiC;IACjC,gCAAgC;IAChC,+BAA+B;IAC/B,+BAA+B;IAC/B,uBAAuB;IACvB,qBAAqB;IACrB,sBAAsB;IACtB,sBAAsB;IACtB,kBAAkB;IAClB,sBAAsB;IACtB,yBAAyB;IACzB,iBAAiB;IACjB,0BAA0B;IAC1B,oBAAoB;IACpB,qBAAqB;IACrB,mBAAmB;IACnB,kBAAkB;IAClB,mBAAmB;IACnB,oBAAoB;IACpB,kBAAkB;IAClB,qBAAqB;IACrB,mBAAmB;IACnB,kBAAkB;IAClB,mBAAmB;IACnB,mBAAmB;IACnB,mBAAmB;IACnB,sBAAsB;IACtB,gBAAgB;IAChB,qBAAqB;IACrB,qBAAqB;IACrB,aAAa;IACb,cAAc;IACd,YAAY;IACZ,gBAAgB;IAChB,iBAAiB;IACjB,iBAAiB;IACjB,oBAAoB;IACpB,mBAAmB;IACnB,oBAAoB;IACpB,qBAAqB;IACrB,uBAAuB;IACvB,WAAW;IACX,kBAAkB;IAClB,UAAU;IACV,aAAa;IACb,WAAW;IACX,aAAa;IACb,YAAY;IACZ,YAAY;IACZ,eAAe;IACf,aAAa;IACb,eAAe;CAChB,CAAA;AAED,kFAAkF;AAClF,MAAM,CAAC,MAAM,UAAU,GAA6B;IAClD,GAAG,IAAI,GAAG,CAAC;QACT,GAAG,gBAAgB;QACnB,GAAG,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC;QACnC,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;QAC3B,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC;QAC9B,GAAI,MAAM,CAAC,MAAM,CAAC,SAAS,CAAqB;QAChD,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;KAC3E,CAAC;CACH,CAAA;AAED,qGAAqG;AACrG,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC;IAC3B,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,UAAU;IACV,UAAU;IACV,SAAS;IACT,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,wFAAwF;IACxF,UAAU;IACV,MAAM;IACN,OAAO;IACP,YAAY;IACZ,OAAO;IACP,KAAK;IACL,wGAAwG;IACxG,SAAS;CACV,CAAC,CAAA;AAEF,uEAAuE;AACvE,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC,CAAA;AAEhF,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAA;AAExG,qGAAqG;AACrG,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC,CAAA;AAE9F,8FAA8F;AAC9F,MAAM,cAAc,GAAG,0DAA0D,CAAA;AAEjF,4GAA4G;AAC5G,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAC3C,IAAuB,EACvB,WAA4C,EACtC,EAAE;IACR,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC;QACtB,6BAA6B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAA;QACzD,OAAM;IACR,CAAC;IACD,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1F,MAAM,IAAI,QAAQ,CAChB,qBAAqB,EACrB,0EAA0E,EAC1E,EAAE,SAAS,EAAE,KAAK,EAAE,CACrB,CAAA;IACH,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,OAAO;QAAE,OAAM;IAC/B,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,gDAAgD,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpG,MAAM,IAAI,QAAQ,CAChB,qBAAqB,EACrB,uFAAuF,EACvF,EAAE,SAAS,EAAE,KAAK,EAAE,CACrB,CAAA;AACL,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAAuB,EAAmB,EAAE;IAC7E,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK;QAAE,OAAO,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,GAAG,EAAE,CAAC,CAAA;IAC1F,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,CAAA;IAC/B,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAA;IACnB,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,aAAa,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC;QAAE,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,CAAA;IACxG,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,CAAA;IAC/F,+FAA+F;IAC/F,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,OAAO;YAAE,OAAO,CAAC,GAAG,CAAC,CAAA;QACrC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ;YAAE,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;QAChD,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,eAAe;YAAE,OAAO,CAAC,GAAG,EAAE,UAAU,EAAE,eAAe,CAAC,CAAA;QAC1E,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,CAAA;IAC1B,CAAC;IACD,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,OAAO;QAAE,OAAO,CAAC,GAAG,CAAC,CAAA;IACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACzD,OAAO;QACL,GAAG,IAAI,GAAG,CAAC;YACT,GAAG;YACH,UAAU;YACV,GAAG,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAkB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SACzF,CAAC;KACH,CAAA;AACH,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAuB,EAAoC,EAAE;IACzF,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,CAAA;IACxB,IAAI,GAAG,KAAK,KAAK,EAAE,CAAC;QAClB,IAAI,IAAI,KAAK,SAAS,IAAI,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAA;QACjE,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;QAC1C,OAAO,OAAO,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAA;IAClD,CAAC;IACD,IAAI,GAAG,KAAK,SAAS,IAAI,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAA;IAC3D,IAAI,GAAG,KAAK,OAAO,IAAI,IAAI,KAAK,SAAS,IAAI,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IACrF,wHAAwH;IACxH,IAAI,GAAG,KAAK,eAAe,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,qBAAqB,CAAA;IAC7E,oGAAoG;IACpG,IAAI,GAAG,KAAK,eAAe,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,qBAAqB,CAAA;IAC7E,oGAAoG;IACpG,wCAAwC;IACxC,IAAI,CAAC,GAAG,KAAK,aAAa,IAAI,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,OAAO,IAAI,IAAI,KAAK,WAAW,CAAC;QAAE,OAAO,UAAU,CAAA;IAC9G,IAAI,GAAG,KAAK,OAAO,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAClF,IAAI,GAAG,KAAK,UAAU,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,UAAU,CAAA;IAC5D,IAAI,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,UAAU,CAAC,CAAC;QAAE,OAAO,UAAU,CAAA;IACpH,IAAK,SAA+B,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACzE,OAAO,SAAS,CAAA;AAClB,CAAC,CAAA;AAED,iGAAiG;AACjG,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,OAAO,GAAsB,EAAE,EAAgC,EAAE;IACnG,MAAM,MAAM,GAAiC,EAAE,CAAA;IAC/C,MAAM,IAAI,GAAG,IAAI,MAAM,CAAC,KAAK,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAA;IACvE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,CAAC,GAAG,GAAG,EAAE,EAAE,KAAK,GAAG,EAAE,EAAE,KAAK,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QACtD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAE,MAA4B,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,SAAS;YAC1F,MAAM,IAAI,QAAQ,CAChB,kBAAkB,EAClB,oGAAoG,CACrG,CAAA;QACH,MAAM,CAAC,GAAG,CAAC,GAAG,KAAc,CAAA;IAC9B,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,WAA4C,EAAQ,EAAE;IAChG,KAAK,MAAM,UAAU,IAAI,CAAC,uBAAuB,EAAE,OAAO,CAAC,EAAE,CAAC;QAC5D,IAAI,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,KAAK,KAAK,MAAM;YACpD,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE,CAAC,CAAA;IAC1F,CAAC;AACH,CAAC,CAAA"}

package/dist/sends/polls.d.ts

@@ -0,0 +1,49 @@
+import type { MessengerAdapter, NewPoll, Sent } from "../cli/messenger/port.js";
+import type { Id, Page, Poll, PollVote } from "../domain/models.js";
+import type { SendGuard } from "./guard.js";
+import { type Operated } from "./guarded.js";
+/** The poll is read first: nobody, the owner included, may see who voted in an anonymous one. */
+export declare const pollVoters: (connection: MessengerAdapter, { chat, message, answer, limit }: {
+    chat: string;
+    message: string;
+    answer?: Id;
+    limit: number;
+}) => Promise<Page<PollVote> & {
+    chatId: Id;
+    messageId: Id;
+    total: number;
+}>;
+/** A vote is shown to the others like a reaction, and counts toward nothing. */
+export declare const guardedVote: (guard: SendGuard, connection: MessengerAdapter, { chat, message, answers }: {
+    chat: string;
+    message: string;
+    answers: Id[];
+}) => Promise<Operated<{
+    poll: Poll;
+}>>;
+/** Closing changes the owner's own message for everyone in the chat, like an edit. */
+export declare const guardedClose: (guard: SendGuard, connection: MessengerAdapter, { chat, message }: {
+    chat: string;
+    message: string;
+}) => Promise<Operated<{
+    poll: Poll;
+}>>;
+/** A new poll is a new message: the recipient list and the hourly limit apply, and a send id makes a retry safe. */
+export declare const guardedCreatePoll: (guard: SendGuard, connection: MessengerAdapter, { chat, poll, silent, sendId, threadId: typedThread, sendAs, }: {
+    chat: string;
+    poll: NewPoll;
+    silent: boolean;
+    sendId?: string;
+    threadId?: Id;
+    sendAs?: Id;
+}) => Promise<Operated<Sent>>;
+/** `--quiz --correct <n> --solution <text>` as typed, `n` from 1; refused when they do not go together. */
+export declare const quizOf: ({ quiz, correct, solution, }: {
+    quiz?: boolean;
+    correct?: number;
+    solution?: string;
+}) => NewPoll["quiz"];
+export declare const closeRange: ([min, max]: readonly [number, number]) => string;
+/** A delay like `90s` or `5m`, in seconds, inside the messenger's range. */
+export declare const closeAfterOf: (value: string | undefined, range: readonly [number, number] | undefined) => number | undefined;
+//# sourceMappingURL=polls.d.ts.map

package/dist/sends/polls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polls.d.ts","sourceRoot":"","sources":["../../src/sends/polls.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAA;AAG/E,OAAO,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAC3C,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAA;AAI1D,iGAAiG;AACjG,eAAO,MAAM,UAAU,eACT,gBAAgB,oCACM;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,KAC9F,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG;IAAE,MAAM,EAAE,EAAE,CAAC;IAAC,SAAS,EAAE,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAUvE,CAAA;AAED,gFAAgF;AAChF,eAAO,MAAM,WAAW,UACf,SAAS,cACJ,gBAAgB,8BACA;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,EAAE,EAAE,CAAA;CAAE,KAC3E,OAAO,CAAC,QAAQ,CAAC;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,CAAC,CAUlC,CAAA;AAED,sFAAsF;AACtF,eAAO,MAAM,YAAY,UAChB,SAAS,cACJ,gBAAgB,qBACT;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,KACnD,OAAO,CAAC,QAAQ,CAAC;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,CAAC,CAUlC,CAAA;AAED,oHAAoH;AACpH,eAAO,MAAM,iBAAiB,UACrB,SAAS,cACJ,gBAAgB,kEAQzB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,EAAE,CAAA;CAAE,KAC/F,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAwCxB,CAAA;AAED,2GAA2G;AAC3G,eAAO,MAAM,MAAM,iCAIhB;IACD,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,KAAG,OAAO,CAAC,MAAM,CASjB,CAAA;AAID,eAAO,MAAM,UAAU,eAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,WAAyC,CAAA;AAEzG,4EAA4E;AAC5E,eAAO,MAAM,YAAY,UAAW,MAAM,GAAG,SAAS,SAAS,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,uBAYnG,CAAA"}

package/dist/sends/polls.js

@@ -0,0 +1,97 @@
+import { CliError } from "@wirecat/cli-base";
+import { capability } from "../cli/messenger/port.js";
+import { threadIdOf } from "../cli/messenger/thread.js";
+import { guardedWrite } from "./guarded.js";
+import { sendAsCheck } from "./send-as.js";
+import { newOperationId, newSendId } from "./send-id.js";
+/** The poll is read first: nobody, the owner included, may see who voted in an anonymous one. */
+export const pollVoters = async (connection, { chat, message, answer, limit }) => {
+    const voters = capability(connection, "pollVoters", "list who voted");
+    const read = capability(connection, "poll", "read a poll");
+    const { id: chatId } = await connection.resolve(chat);
+    const poll = await read(chatId, message);
+    if (poll.anonymous)
+        throw new CliError("validation_error", "nobody can see who voted in an anonymous poll");
+    if (answer !== undefined && !poll.answers.some((one) => one.id === answer))
+        throw new CliError("validation_error", `the poll has no answer ${answer}; \`polls show\` prints their ids`);
+    const page = await voters(chatId, message, { limit, ...(answer === undefined ? {} : { answerId: answer }) });
+    return { chatId, messageId: message, ...page };
+};
+/** A vote is shown to the others like a reaction, and counts toward nothing. */
+export const guardedVote = async (guard, connection, { chat, message, answers }) => {
+    const vote = capability(connection, "vote", "vote in a poll");
+    const { id: chatId } = await connection.resolve(chat);
+    const operationId = newOperationId();
+    const poll = await guardedWrite(guard, { operationId, chatId, kind: "reaction", messageId: message, key: "polls.vote" }, () => vote(chatId, message, answers));
+    return { operationId, poll };
+};
+/** Closing changes the owner's own message for everyone in the chat, like an edit. */
+export const guardedClose = async (guard, connection, { chat, message }) => {
+    const close = capability(connection, "closePoll", "close a poll");
+    const { id: chatId } = await connection.resolve(chat);
+    const operationId = newOperationId();
+    const poll = await guardedWrite(guard, { operationId, chatId, kind: "edit", messageId: message, key: "polls.close" }, () => close(chatId, message));
+    return { operationId, poll };
+};
+/** A new poll is a new message: the recipient list and the hourly limit apply, and a send id makes a retry safe. */
+export const guardedCreatePoll = async (guard, connection, { chat, poll, silent, sendId, threadId: typedThread, sendAs, }) => {
+    if (poll.answers.length < 2)
+        throw new CliError("validation_error", "a poll needs two answers or more");
+    if (poll.quiz) {
+        const { correct } = poll.quiz;
+        if (!Number.isInteger(correct) || correct < 0 || correct >= poll.answers.length)
+            throw new CliError("validation_error", `--correct takes an answer's position, 1 to ${poll.answers.length}`);
+        if (poll.multiple || poll.revote)
+            throw new CliError("validation_error", "a quiz takes one final answer; not with --multiple or --revote");
+    }
+    const threadId = threadIdOf(typedThread);
+    const validate = threadId === undefined ? undefined : capability(connection, "validateThread", "send to a forum topic");
+    const create = capability(connection, "createPoll", "create a poll");
+    const checkSendAs = sendAsCheck(connection, sendAs);
+    const { id: chatId } = await connection.resolve(chat);
+    await checkSendAs(chatId);
+    const id = sendId ?? connection.newSendId?.() ?? newSendId();
+    const sent = await guardedWrite(guard, {
+        chatId,
+        kind: "message",
+        sendId: id,
+        operationId: id,
+        length: poll.question.length,
+        key: "polls.create",
+        ...(threadId === undefined ? {} : { threadId }),
+        ...(sendAs === undefined ? {} : { sendAs }),
+    }, () => create(chatId, poll, {
+        sendId: id,
+        ...(silent ? { silent } : {}),
+        ...(threadId === undefined ? {} : { threadId }),
+        ...(sendAs === undefined ? {} : { sendAs }),
+    }), (done) => ({ messageId: done.message.id }), validate === undefined || threadId === undefined ? undefined : () => validate(chatId, threadId, {}));
+    return { ...sent, operationId: id };
+};
+/** `--quiz --correct <n> --solution <text>` as typed, `n` from 1; refused when they do not go together. */
+export const quizOf = ({ quiz, correct, solution, }) => {
+    if (quiz !== true) {
+        if (correct !== undefined || solution !== undefined)
+            throw new CliError("validation_error", "--correct and --solution go with --quiz");
+        return undefined;
+    }
+    if (correct === undefined)
+        throw new CliError("validation_error", "a quiz needs --correct <n>, the right answer's position");
+    return { correct: correct - 1, ...(solution === undefined ? {} : { solution }) };
+};
+const seconds = (n) => (n % 60 === 0 ? `${n / 60}m` : `${n}s`);
+export const closeRange = ([min, max]) => `${seconds(min)} to ${seconds(max)}`;
+/** A delay like `90s` or `5m`, in seconds, inside the messenger's range. */
+export const closeAfterOf = (value, range) => {
+    if (value === undefined)
+        return undefined;
+    if (range === undefined)
+        throw new CliError("validation_error", "this messenger cannot close a poll by itself");
+    const [, amount, unit] = /^(\d+)(s|m)$/.exec(value.trim()) ?? [];
+    const after = Number(amount) * (unit === "m" ? 60 : 1);
+    const [min, max] = range;
+    if (!amount || after < min || after > max)
+        throw new CliError("validation_error", `--close-time takes a delay from ${closeRange(range)}, like 90s or 5m — not "${value}"`);
+    return after;
+};
+//# sourceMappingURL=polls.js.map

package/dist/sends/polls.js.map

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

package/dist/sends/recipients.d.ts

@@ -0,0 +1,34 @@
+import type { AppIdentity } from "../cli/app.js";
+import type { Id } from "../domain/models.js";
+export interface Recipient {
+    id: Id;
+    title: string | null;
+    /** The other person, for a one-to-one chat: who may be put in a group when the list is on. */
+    partnerId?: Id;
+    addedAt: string;
+}
+/**
+ * A state file, not a setting: the configuration schema has deliberately no place for a chat id,
+ * and this list is data about a profile rather than a preference.
+ */
+export declare const recipientsPathFor: (app: AppIdentity, profile: string, env?: NodeJS.ProcessEnv) => string;
+/**
+ * The chats a profile may send to. **No file means the check is off**; a file with no chats in it
+ * means nowhere.
+ */
+export declare class RecipientList {
+    #private;
+    readonly path: string;
+    readonly command: string;
+    /** `command` names the program in the hint that turns the list off. */
+    constructor(path: string, command: string);
+    /** `undefined` when the list is off. A file that cannot be read refuses rather than opening up. */
+    read(): Recipient[] | undefined;
+    /** Whether it was new. Adding one again fills in a partner an older entry was stored without. */
+    add(recipient: Recipient): boolean;
+    /** The id or the title as it was stored; `undefined` when neither matched. */
+    remove(reference: string): Recipient | undefined;
+    /** Whether there was a list to turn off. */
+    off(): boolean;
+}
+//# sourceMappingURL=recipients.d.ts.map