@wirecat/cli-core 0.20.0 → 0.262.0

package/dist/cli/messenger/admin-commands.js

@@ -0,0 +1,246 @@
+import { CliError } from "@wirecat/cli-base";
+import { annotate } from "@wirecat/cli-base/commands";
+import { Command } from "commander";
+import { ADMIN_RIGHTS, GROUP_SETTINGS } from "../../domain/models.js";
+import { readUpload } from "../../sends/upload.js";
+import { positiveCount } from "../paging.js";
+import { messengerContext } from "./context.js";
+const SETTING_FLAGS = {
+    allCanPin: ["all-can-pin", "every member may pin messages"],
+    onlyAdminsAdd: ["only-admins-add", "only admins may add members"],
+    onlyAdminsCall: ["only-admins-call", "only admins may start a call"],
+    onlyOwnerEditsInfo: ["only-owner-edits-info", "only the owner may change the name and photo"],
+    membersSeeLink: ["members-see-link", "members may see the invite link"],
+    joinApproval: ["join-approval", "people ask to join, and an admin lets them in"],
+};
+const settingsOf = (keys, options) => {
+    const changes = {};
+    for (const key of keys) {
+        const value = options[key];
+        if (value === undefined)
+            continue;
+        if (value !== "on" && value !== "off") {
+            throw new CliError("validation_error", `--${SETTING_FLAGS[key][0]} takes on or off, not "${String(value)}"`);
+        }
+        changes[key] = value === "on";
+    }
+    return changes;
+};
+const updateCommand = (messenger) => {
+    const keys = messenger.groupSettings ?? GROUP_SETTINGS;
+    const update = annotate(new Command("update"), { mutates: true })
+        .description("rename a group or channel, change its description, or turn one of its settings on or off")
+        .argument("<chat>", messenger.chatArgument)
+        .option("--title <title>", "the new name")
+        .option("--description <text>", "the new description");
+    if (messenger.groupPhoto === true)
+        update.option("--photo <file>", "a new photo for it — an image file");
+    for (const key of keys)
+        update.option(`--${SETTING_FLAGS[key][0]} <on|off>`, SETTING_FLAGS[key][1]);
+    return update.action(async function (chat) {
+        const context = messengerContext(this, messenger);
+        const { title, description, photo, ...rest } = this.opts();
+        const settings = settingsOf(keys, rest);
+        const upload = photo === undefined ? undefined : await readUpload("photo", photo, { app: messenger.app, env: context.env });
+        context.renderer.result(await context.withServices((services) => services.admin.update(chat, {
+            ...(title === undefined ? {} : { title }),
+            ...(description === undefined ? {} : { description }),
+            ...(Object.keys(settings).length > 0 ? { settings } : {}),
+            ...(upload === undefined ? {} : { photo: upload }),
+        })));
+    });
+};
+const linkCommand = (messenger) => {
+    const link = new Command("link").description("a group's invite link");
+    link
+        .command("show")
+        .description("the invite link, if you may see it")
+        .argument("<chat>", messenger.chatArgument)
+        .action(async function (chat) {
+        const context = messengerContext(this, messenger);
+        context.renderer.result(await context.withServices((services) => services.admin.link(chat)));
+    });
+    link.addCommand(annotate(new Command("create"), { mutates: true })
+        .description("make another invite link; nobody is told until you share it")
+        .argument("<chat>", messenger.chatArgument)
+        .option("--approval", "who joins by it asks first, and an admin lets them in; it then has no use limit")
+        .option("--expire-time <time>", "it stops working then: 2026-09-25T09:00 (local time), or 30m, 2h, 7d from now")
+        .option("--max-uses <n>", "at most this many people join by it, 1 to 99999", positiveCount("--max-uses"))
+        .action(async function (chat) {
+        const context = messengerContext(this, messenger);
+        const { approval, expireTime, maxUses } = this.opts();
+        context.renderer.result(await context.withServices((services) => services.admin.createLink(chat, {
+            approval: approval === true,
+            ...(expireTime === undefined ? {} : { expires: expireTime }),
+            ...(maxUses === undefined ? {} : { maxUses }),
+        })));
+    }));
+    if (messenger.inviteLinkList !== false)
+        link
+            .command("list")
+            .description("your invite links, newest first, with how many joined and how many wait")
+            .argument("<chat>", messenger.chatArgument)
+            .option("--revoked", "the links you stopped, instead")
+            .option("--limit <n>", "how many", positiveCount("--limit"))
+            .action(async function (chat) {
+            const context = messengerContext(this, messenger);
+            const { revoked } = this.opts();
+            const { limit } = context.settings;
+            const found = await context.withServices((services) => services.admin.links(chat, { limit, revoked: revoked === true }));
+            if (context.format === "json")
+                context.renderer.result(found);
+            else
+                context.renderer.stream(found.items);
+            if (found.hasMore)
+                context.renderer.note(`more links: raise --limit above ${limit}`);
+        });
+    if (messenger.inviteLinkRevoke !== false)
+        link.addCommand(annotate(new Command("revoke"), { mutates: true })
+            .description("stop one link; for the group's own link, the answer is the new one")
+            .argument("<chat>", messenger.chatArgument)
+            .argument("<link>", "the link, as `chats link list` shows it")
+            .action(async function (chat, link) {
+            const context = messengerContext(this, messenger);
+            context.renderer.result(await context.withServices((services) => services.admin.revokeLink(chat, link)));
+        }));
+    if (messenger.inviteLinkUpdate === true)
+        link.addCommand(annotate(new Command("update"), { mutates: true })
+            .description("change one of your invite links, the group's own one too")
+            .argument("<chat>", messenger.chatArgument)
+            .argument("<link>", "the link, as `chats link list` shows it")
+            .option("--approval", "who joins by it asks first, and an admin lets them in; it then has no use limit")
+            .option("--no-approval", "anyone with it joins at once")
+            .option("--expire-time <time>", "it stops working then: 2026-09-25T09:00 (local time), or 30m, 2h, 7d from now; `never` takes the expiry away")
+            .option("--max-uses <n>", "at most this many people join by it, 1 to 99999", positiveCount("--max-uses"))
+            .action(async function (chat, link) {
+            const context = messengerContext(this, messenger);
+            const { approval, expireTime, maxUses } = this.opts();
+            context.renderer.result(await context.withServices((services) => services.admin.updateLink(chat, link, {
+                ...(approval === undefined ? {} : { approval }),
+                ...(expireTime === undefined ? {} : { expires: expireTime }),
+                ...(maxUses === undefined ? {} : { maxUses }),
+            })));
+        }));
+    link.addCommand(annotate(new Command("reset"), { mutates: true })
+        .description("replace the invite link; the old one stops working")
+        .argument("<chat>", messenger.chatArgument)
+        .action(async function (chat) {
+        const context = messengerContext(this, messenger);
+        context.renderer.result(await context.withServices((services) => services.admin.resetLink(chat)));
+    }));
+    return link;
+};
+const adminsCommand = (messenger) => {
+    const offered = messenger.adminRights ?? ADMIN_RIGHTS;
+    const admins = new Command("admins").description("give or take back a member's admin rights");
+    admins.addCommand(annotate(new Command("add"), { mutates: true })
+        .description("make a member an admin with these rights")
+        .argument("<chat>", messenger.chatArgument)
+        .argument("<person>", "an id, or part of a name")
+        .requiredOption("--can <rights>", `what they may do, comma-separated: ${offered.join(", ")}`)
+        .action(async function (chat, person) {
+        const context = messengerContext(this, messenger);
+        const rights = rightsOf(offered, this.opts().can);
+        context.renderer.result(await context.withServices((services) => services.admin.addAdmin(chat, person, rights)));
+    }));
+    admins.addCommand(annotate(new Command("remove"), { mutates: true })
+        .description("take an admin's rights back; they stay a member")
+        .argument("<chat>", messenger.chatArgument)
+        .argument("<person>", "an id, or part of a name")
+        .action(async function (chat, person) {
+        const context = messengerContext(this, messenger);
+        context.renderer.result(await context.withServices((services) => services.admin.removeAdmin(chat, person)));
+    }));
+    return admins;
+};
+export const rightsOf = (offered, typed) => {
+    const rights = [
+        ...new Set(typed
+            .split(",")
+            .map((one) => one.trim())
+            .filter(Boolean)),
+    ];
+    const unknown = rights.filter((one) => !offered.includes(one));
+    if (rights.length === 0 || unknown.length > 0) {
+        throw new CliError("validation_error", `--can takes rights from: ${offered.join(", ")}${unknown.length > 0 ? ` — not ${unknown.join(", ")}` : ""}`);
+    }
+    return rights;
+};
+const requestsCommand = (messenger) => {
+    const requests = new Command("requests").description("requests to join a group that needs an admin's approval");
+    requests
+        .command("list")
+        .description("who asked to join, newest first; only admins see them, and reading tells nobody")
+        .argument("<chat>", messenger.chatArgument)
+        .option("--limit <n>", "how many", positiveCount("--limit"))
+        .option("--search <text>", "only people whose name or @username has this")
+        .option("--link <link>", "only people who asked through this invite link; not with --search")
+        .action(async function (chat) {
+        const context = messengerContext(this, messenger);
+        const { limit } = context.settings;
+        const { search, link } = this.opts();
+        const window = { limit, ...(search === undefined ? {} : { search }), ...(link === undefined ? {} : { link }) };
+        const found = await context.withServices((services) => services.admin.requests(chat, window));
+        if (context.format === "json")
+            context.renderer.result(found);
+        else
+            context.renderer.stream(found.items);
+        if (found.hasMore)
+            context.renderer.note(`more requests: raise --limit above ${limit}`);
+    });
+    for (const [verb, accept, help] of [
+        ["accept", true, "let them in; the group sees them join"],
+        ["decline", false, "turn the request away"],
+    ]) {
+        requests.addCommand(annotate(new Command(verb), { mutates: true })
+            .description(help)
+            .argument("<chat>", messenger.chatArgument)
+            .argument("[person]", "who asked: an id from `chats requests list`")
+            .option("--all", "every pending request, counted against the hourly limit first")
+            .option("--link <link>", "with --all: only the requests made by this invite link")
+            .action(async function (chat, person) {
+            const context = messengerContext(this, messenger);
+            const { all, link } = this.opts();
+            if ((person === undefined) === (all !== true))
+                throw new CliError("validation_error", "give one person, or --all — not both, not neither");
+            if (link !== undefined && all !== true)
+                throw new CliError("validation_error", "--link goes with --all");
+            context.renderer.result(await context.withServices((services) => person === undefined
+                ? services.admin.answerAllRequests(chat, accept, link === undefined ? {} : { link })
+                : services.admin.answerRequest(chat, person, accept)));
+        }));
+    }
+    return requests;
+};
+/** `chats create`, `join`, `leave`, `update` and `link`: the help text is max-cli's, the one both tools say (standard, help rule 2). */
+export const groupCommands = (messenger) => [
+    annotate(new Command("create"), { mutates: true })
+        .description("create a group or a channel; the people added are told")
+        .argument("<title>", "the group's name")
+        .argument("[person...]", "people to add: an id, or part of a name")
+        .option("--channel", "a private channel instead of a group; people join it by its link")
+        .action(async function (title, people) {
+        const context = messengerContext(this, messenger);
+        const { channel } = this.opts();
+        context.renderer.result(await context.withServices((services) => services.admin.create({ title, people, channel: channel === true })));
+    }),
+    annotate(new Command("join"), { mutates: true })
+        .description("join a group or channel by its link; the others in it see that you joined")
+        .argument("<link>", `an invite link, or a public one`)
+        .action(async function (link) {
+        const context = messengerContext(this, messenger);
+        context.renderer.result(await context.withServices((services) => services.admin.join(link)));
+    }),
+    annotate(new Command("leave"), { mutates: true })
+        .description("leave a group or channel; the others in it see that you left")
+        .argument("<chat>", messenger.chatArgument)
+        .action(async function (chat) {
+        const context = messengerContext(this, messenger);
+        context.renderer.result(await context.withServices((services) => services.admin.leave(chat)));
+    }),
+    updateCommand(messenger),
+    linkCommand(messenger),
+    requestsCommand(messenger),
+    adminsCommand(messenger),
+];
+//# sourceMappingURL=admin-commands.js.map

package/dist/cli/messenger/admin-commands.js.map

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

package/dist/cli/messenger/admin-contacts-command.d.ts

@@ -0,0 +1,8 @@
+import { Command } from "commander";
+import type { PhoneBookEntry } from "../../domain/models.js";
+import { type Messenger } from "./context.js";
+/** The address book's writes, in max-cli's words. */
+export declare const contactWriteCommands: (messenger: Messenger) => Command[];
+/** ⚠ A bad line is named by its number, never by what is on it. */
+export declare const phoneBook: (text: string) => PhoneBookEntry[];
+//# sourceMappingURL=admin-contacts-command.d.ts.map

package/dist/cli/messenger/admin-contacts-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-contacts-command.d.ts","sourceRoot":"","sources":["../../../src/cli/messenger/admin-contacts-command.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAE5D,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,cAAc,CAAA;AAI/D,qDAAqD;AACrD,eAAO,MAAM,oBAAoB,cAAe,SAAS,KAAG,OAAO,EAiDlE,CAAA;AAED,mEAAmE;AACnE,eAAO,MAAM,SAAS,SAAU,MAAM,KAAG,cAAc,EAUnD,CAAA"}

package/dist/cli/messenger/admin-contacts-command.js

@@ -0,0 +1,60 @@
+import { readFile } from "node:fs/promises";
+import { CliError } from "@wirecat/cli-base";
+import { annotate } from "@wirecat/cli-base/commands";
+import { Command } from "commander";
+import { phoneOf } from "../../services/index.js";
+import { messengerContext } from "./context.js";
+const PERSON = "person id — `contacts lookup` finds one — or part of a known name";
+/** The address book's writes, in max-cli's words. */
+export const contactWriteCommands = (messenger) => {
+    const simple = [
+        ["add", "add a person to your contacts — `contacts list` still shows only people you have a dialog with"],
+        ["remove", "remove a person from your contacts; the chat stays, a name you gave them may not"],
+        ["block", "stop a person from writing to you — they need not be a contact"],
+        ["unblock", "let a blocked person write to you again"],
+    ].map(([name, description]) => annotate(new Command(name), { mutates: true })
+        .description(description)
+        .argument("<person>", PERSON)
+        .action(async function (person) {
+        const context = messengerContext(this, messenger);
+        context.renderer.result(await context.withServices((services) => services.people[name](person)));
+    }));
+    const rename = annotate(new Command("rename"), { mutates: true })
+        .description("rename the contact in the messenger address book; use contacts alias for a private local name")
+        .argument("<person>", PERSON)
+        .argument("<first-name>", "the name you want to see for them")
+        .argument("[last-name]")
+        .action(async function (person, firstName, lastName) {
+        const context = messengerContext(this, messenger);
+        context.renderer.result(await context.withServices((services) => services.people.rename(person, firstName, lastName)));
+    });
+    /** A file rather than argv: these are phone numbers, and argv is read by `ps` and kept by the shell. */
+    const importing = annotate(new Command("import"), { mutates: true })
+        .description("upload phone numbers and add the people the messenger has under them")
+        .argument("<file>", "one person per line: number, then a comma, a tab or a semicolon, then the name")
+        .action(async function (file) {
+        const context = messengerContext(this, messenger);
+        const entries = phoneBook(await readFile(file, "utf8").catch((error) => {
+            throw new CliError("not_found", `cannot read ${file}: ${error.code ?? error.message}`);
+        }));
+        const imported = await context.withServices((services) => services.people.import(entries));
+        context.renderer.result(imported);
+        context.renderer.success(`${imported.sent} sent, ${imported.recognised.length} recognised`);
+    });
+    return [...simple, rename, importing];
+};
+/** ⚠ A bad line is named by its number, never by what is on it. */
+export const phoneBook = (text) => text.split(/\r?\n/).flatMap((line, index) => {
+    if (line.trim() === "")
+        return [];
+    const match = /^\s*([^,\t;]+?)\s*[,\t;]\s*(.*\S)\s*$/.exec(line);
+    if (!match?.[1] || !match[2])
+        throw new CliError("validation_error", `line ${index + 1} is not "number, name"`);
+    try {
+        return [{ phone: phoneOf(match[1]), name: match[2] }];
+    }
+    catch {
+        throw new CliError("validation_error", `line ${index + 1}: the number is not a phone number with a country code`);
+    }
+});
+//# sourceMappingURL=admin-contacts-command.js.map

package/dist/cli/messenger/admin-contacts-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-contacts-command.js","sourceRoot":"","sources":["../../../src/cli/messenger/admin-contacts-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AACjD,OAAO,EAAkB,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAE/D,MAAM,MAAM,GAAG,mEAAmE,CAAA;AAElF,qDAAqD;AACrD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,SAAoB,EAAa,EAAE;IACtE,MAAM,MAAM,GACV;QACE,CAAC,KAAK,EAAE,gGAAgG,CAAC;QACzG,CAAC,QAAQ,EAAE,kFAAkF,CAAC;QAC9F,CAAC,OAAO,EAAE,gEAAgE,CAAC;QAC3E,CAAC,SAAS,EAAE,yCAAyC,CAAC;KAEzD,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,EAAE,CAC5B,QAAQ,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;SAC3C,WAAW,CAAC,WAAW,CAAC;SACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;SAC5B,MAAM,CAAC,KAAK,WAA0B,MAAc;QACnD,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;QACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CACrB,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAmB,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CACzF,CAAA;IACH,CAAC,CAAC,CACL,CAAA;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;SAC9D,WAAW,CAAC,+FAA+F,CAAC;SAC5G,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;SAC5B,QAAQ,CAAC,cAAc,EAAE,mCAAmC,CAAC;SAC7D,QAAQ,CAAC,aAAa,CAAC;SACvB,MAAM,CAAC,KAAK,WAA0B,MAAc,EAAE,SAAiB,EAAE,QAAiB;QACzF,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;QACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CACrB,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAC9F,CAAA;IACH,CAAC,CAAC,CAAA;IAEJ,wGAAwG;IACxG,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;SACjE,WAAW,CAAC,sEAAsE,CAAC;SACnF,QAAQ,CAAC,QAAQ,EAAE,gFAAgF,CAAC;SACpG,MAAM,CAAC,KAAK,WAA0B,IAAY;QACjD,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;QACjD,MAAM,OAAO,GAAG,SAAS,CACvB,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,KAA4B,EAAE,EAAE;YAClE,MAAM,IAAI,QAAQ,CAAC,WAAW,EAAE,eAAe,IAAI,KAAK,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;QACxF,CAAC,CAAC,CACH,CAAA;QACD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAA;QAC1F,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;QACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAC,IAAI,UAAU,QAAQ,CAAC,UAAU,CAAC,MAAM,aAAa,CAAC,CAAA;IAC7F,CAAC,CAAC,CAAA;IAEJ,OAAO,CAAC,GAAG,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAA;AACvC,CAAC,CAAA;AAED,mEAAmE;AACnE,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAY,EAAoB,EAAE,CAC1D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;IAC1C,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,EAAE,CAAA;IACjC,MAAM,KAAK,GAAG,uCAAuC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAChE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAAE,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,QAAQ,KAAK,GAAG,CAAC,wBAAwB,CAAC,CAAA;IAC/G,IAAI,CAAC;QACH,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,QAAQ,KAAK,GAAG,CAAC,wDAAwD,CAAC,CAAA;IACnH,CAAC;AACH,CAAC,CAAC,CAAA"}

package/dist/cli/messenger/admin-folders-command.d.ts

@@ -0,0 +1,5 @@
+import { Command } from "commander";
+import { type Messenger } from "./context.js";
+/** `chats folders …`, in max-cli's words. */
+export declare const foldersCommand: (messenger: Messenger) => Command;
+//# sourceMappingURL=admin-folders-command.d.ts.map

package/dist/cli/messenger/admin-folders-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-folders-command.d.ts","sourceRoot":"","sources":["../../../src/cli/messenger/admin-folders-command.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAInC,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,cAAc,CAAA;AAoD/D,6CAA6C;AAC7C,eAAO,MAAM,cAAc,cAAe,SAAS,KAAG,OA0FrD,CAAA"}

package/dist/cli/messenger/admin-folders-command.js

@@ -0,0 +1,107 @@
+import { CliError } from "@wirecat/cli-base";
+import { annotate } from "@wirecat/cli-base/commands";
+import { Command } from "commander";
+import { FOLDER_KINDS, FOLDER_SKIPS } from "../../domain/models.js";
+import { renderList } from "../paging.js";
+import { messengerContext } from "./context.js";
+const collect = (value, previous = []) => [...previous, value];
+const listOf = (flag, allowed) => (value) => {
+    if (value.trim() === "none")
+        return [];
+    const words = value.split(",").map((one) => one.trim());
+    const wrong = words.find((one) => !allowed.includes(one));
+    if (wrong !== undefined)
+        throw new CliError("validation_error", `${flag} takes ${allowed.join(", ")} or none — not "${wrong}"`);
+    return words;
+};
+/** Offered only where the messenger's folders have rules, so a CLI never lists a flag it refuses. */
+const withRules = (command, messenger, replaces) => {
+    if (!messenger.folderRules)
+        return command;
+    const set = replaces ? "; replaces what it had, none clears it" : "";
+    return command
+        .option("--include <kinds>", `every chat of these kinds: ${FOLDER_KINDS.join(", ")}${set}`, listOf("--include", FOLDER_KINDS))
+        .option("--skip <which>", `leave out chats that are ${FOLDER_SKIPS.join(", ")}${set}`, listOf("--skip", FOLDER_SKIPS))
+        .option("--exclude-chat <chat>", "never show this chat in it; repeat it for more", collect)
+        .option("--pin <chat>", "pin this chat at the top of the folder; repeat it for more", collect)
+        .option("--emoji <emoji>", "the folder's icon");
+};
+const rulesOf = (command) => {
+    const { include, skip, excludeChat, pin, emoji } = command.opts();
+    return {
+        ...(include === undefined ? {} : { include }),
+        ...(skip === undefined ? {} : { skip }),
+        ...(excludeChat === undefined ? {} : { exclude: excludeChat }),
+        ...(pin === undefined ? {} : { pin }),
+        ...(emoji === undefined ? {} : { emoji }),
+    };
+};
+/** `chats folders …`, in max-cli's words. */
+export const foldersCommand = (messenger) => {
+    const folders = new Command("folders").description("your chat folders");
+    folders
+        .command("list")
+        .description("your chat folders, in the order the app shows them")
+        .action(async function () {
+        const context = messengerContext(this, messenger);
+        renderList(context.renderer, context.format, await context.withServices((services) => services.folders.list()));
+    });
+    folders
+        .command("show")
+        .description("one chat folder, with the names of the chats in it")
+        .argument("<folder>", "the folder's id, or its title exactly")
+        .action(async function (folder) {
+        const context = messengerContext(this, messenger);
+        context.renderer.result(await context.withServices((services) => services.folders.show(folder)));
+    });
+    folders.addCommand(withRules(annotate(new Command("create"), { mutates: true })
+        .description("create a chat folder")
+        .argument("<title>", "the folder's name; the app may refuse a long one")
+        .option("--chat <chat>", "a chat to put in it, by id or name; repeat it for more", collect), messenger, false).action(async function (title) {
+        const context = messengerContext(this, messenger);
+        const { chat = [] } = this.opts();
+        const rules = rulesOf(this);
+        context.renderer.result(await context.withServices((services) => services.folders.create(title, chat, rules)));
+    }));
+    folders.addCommand(withRules(annotate(new Command("update"), { mutates: true })
+        .description("rename a folder, or change which chats are in it")
+        .argument("<folder>", "folder id, or its title exactly")
+        .option("--title <title>", "a new name")
+        .option("--add <chat>", "put a chat in it; repeat it for more", collect)
+        .option("--remove <chat>", "take a chat out of it, and off its excluded and pinned lists; repeat it for more", collect), messenger, true).action(async function (folder) {
+        const context = messengerContext(this, messenger);
+        const { title, add, remove } = this.opts();
+        const edit = {
+            ...(title === undefined ? {} : { title }),
+            ...(add === undefined ? {} : { add }),
+            ...(remove === undefined ? {} : { remove }),
+            ...rulesOf(this),
+        };
+        context.renderer.result(await context.withServices((services) => services.folders.update(folder, edit)));
+    }));
+    folders.addCommand(annotate(new Command("delete"), { mutates: true })
+        .description("delete a folder; the chats in it stay")
+        .argument("<folder>", "folder id, or its title exactly")
+        .action(async function (folder) {
+        const context = messengerContext(this, messenger);
+        context.renderer.result(await context.withServices((services) => services.folders.delete(folder)));
+    }));
+    if (messenger.folderOrder !== false)
+        folders.addCommand(annotate(new Command("order"), { mutates: true })
+            .description("put folders in this order; the ones not named keep theirs after them")
+            .argument("<folders...>", "folder ids, or titles exactly, first one first")
+            .action(async function (typed) {
+            const context = messengerContext(this, messenger);
+            context.renderer.result(await context.withServices((services) => services.folders.order(typed)));
+        }));
+    if (messenger.folderJoin !== false)
+        folders.addCommand(annotate(new Command("join"), { mutates: true })
+            .description("add a folder someone shared by a link; joins every chat in it, and the others there see you joined")
+            .argument("<link>", "the folder's link, as t.me/addlist/…")
+            .action(async function (link) {
+            const context = messengerContext(this, messenger);
+            context.renderer.result(await context.withServices((services) => services.folders.join(link)));
+        }));
+    return folders;
+};
+//# sourceMappingURL=admin-folders-command.js.map

package/dist/cli/messenger/admin-folders-command.js.map

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

package/dist/cli/messenger/admin-moderation-command.d.ts

@@ -0,0 +1,11 @@
+import { Command } from "commander";
+import { type Messenger } from "./context.js";
+/** `chats rules show|set|unset`: the rules live in a file of this profile, and only the chat's id is asked of the messenger. */
+export declare const rulesCommand: (messenger: Messenger) => Command;
+/**
+ * **The one command that acts on a group's rules** (max-cli `NEED-306`): typing it is the consent
+ * for what the rules name, within each action's level in the group's rules. Nothing watches groups
+ * in the background.
+ */
+export declare const moderateCommand: (messenger: Messenger) => Command;
+//# sourceMappingURL=admin-moderation-command.d.ts.map

package/dist/cli/messenger/admin-moderation-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-moderation-command.d.ts","sourceRoot":"","sources":["../../../src/cli/messenger/admin-moderation-command.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAKnC,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,cAAc,CAAA;AAE/D,gIAAgI;AAChI,eAAO,MAAM,YAAY,cAAe,SAAS,KAAG,OAkCnD,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,cAAe,SAAS,KAAG,OA8CjD,CAAA"}

package/dist/cli/messenger/admin-moderation-command.js

@@ -0,0 +1,83 @@
+import { CliError } from "@wirecat/cli-base";
+import { annotate } from "@wirecat/cli-base/commands";
+import { Command } from "commander";
+import { describe, MAX_ACTIONS } from "../../moderation/check.js";
+import { RULE_KEYS } from "../../moderation/rules.js";
+import { momentOf } from "../../services/moment.js";
+import { answerOf } from "./ask.js";
+import { messengerContext } from "./context.js";
+/** `chats rules show|set|unset`: the rules live in a file of this profile, and only the chat's id is asked of the messenger. */
+export const rulesCommand = (messenger) => {
+    const rules = new Command("rules").description("what `chats moderate` judges a group by, kept in a file of this profile");
+    rules
+        .command("show")
+        .description("the group's rules; the defaults, marked not saved, if it has none yet")
+        .argument("<chat>", messenger.chatArgument)
+        .action(async function (chat) {
+        const context = messengerContext(this, messenger);
+        context.renderer.result(await context.withServices((services) => services.moderation.rules(chat)));
+    });
+    rules.addCommand(annotate(new Command("set"), { mutates: true, local: true })
+        .description("change one rule; the group's first change writes every rule with its default")
+        .argument("<chat>", messenger.chatArgument)
+        .argument("<key>", `one of: ${RULE_KEYS.join(", ")}`)
+        .argument("<value>", "the new value; a list is comma-separated")
+        .action(async function (chat, key, value) {
+        const context = messengerContext(this, messenger);
+        context.renderer.result(await context.withServices((services) => services.moderation.set(chat, key, value)));
+    }));
+    rules.addCommand(annotate(new Command("unset"), { mutates: true, local: true })
+        .description("put one rule back to its default")
+        .argument("<chat>", messenger.chatArgument)
+        .argument("<key>", `one of: ${RULE_KEYS.join(", ")}`)
+        .action(async function (chat, key) {
+        const context = messengerContext(this, messenger);
+        context.renderer.result(await context.withServices((services) => services.moderation.unset(chat, key)));
+    }));
+    return rules;
+};
+/**
+ * **The one command that acts on a group's rules** (max-cli `NEED-306`): typing it is the consent
+ * for what the rules name, within each action's level in the group's rules. Nothing watches groups
+ * in the background.
+ */
+export const moderateCommand = (messenger) => annotate(new Command("moderate"), { mutates: true })
+    .description("judge a group's new messages and members by its rules, and act as they allow")
+    .argument("<chat>", messenger.chatArgument)
+    .option("--since-time <time>", "judge what came after this ISO 8601 time, or 2h / 1d ago; the saved point stays")
+    .option("--dry-run", "judge and plan; do nothing")
+    .option("--allow-dangerous", "yes to every action whose level in the group's rules is ask")
+    .option("--max-actions <n>", `at most this many actions in one run; ${MAX_ACTIONS} if not given`)
+    .action(async function (chat) {
+    const context = messengerContext(this, messenger);
+    const options = this.opts();
+    const maxActions = options.maxActions === undefined ? MAX_ACTIONS : Number(options.maxActions);
+    if (!Number.isInteger(maxActions) || maxActions < 0) {
+        throw new CliError("validation_error", `--max-actions takes a whole number — got ${String(options.maxActions)}`);
+    }
+    const { chatId, rows, notes } = await context.withServices((services) => services.moderation.moderate(chat, {
+        ...(options.sinceTime === undefined ? {} : { since: momentOf(options.sinceTime, "--since-time") }),
+        dryRun: options.dryRun === true,
+        allowDangerous: options.allowDangerous === true,
+        maxActions,
+        confirm: async (finding) => {
+            const answer = await answerOf(this, `${describe(finding)}? [y/N] `);
+            if (answer === null)
+                return undefined;
+            return /^\s*y(es)?\s*$/i.test(answer);
+        },
+    }));
+    context.renderer.result(context.format === "pretty"
+        ? rows.map((row) => ({
+            what: row.kind,
+            who: row.personName ?? row.personId,
+            rule: row.rule,
+            action: row.action,
+            outcome: row.outcome,
+            ...(row.reason ? { why: row.reason } : {}),
+        }))
+        : { chatId, rows });
+    for (const note of notes)
+        context.renderer.note(note);
+});
+//# sourceMappingURL=admin-moderation-command.js.map

package/dist/cli/messenger/admin-moderation-command.js.map

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

package/dist/cli/messenger/admin-statistics-command.d.ts

@@ -0,0 +1,5 @@
+import { Command } from "commander";
+import type { AdminReport } from "../../domain/admin-statistics.js";
+import { type Messenger } from "./context.js";
+export declare const adminStatisticsCommand: (messenger: Messenger, report: AdminReport) => Command;
+//# sourceMappingURL=admin-statistics-command.d.ts.map

package/dist/cli/messenger/admin-statistics-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-statistics-command.d.ts","sourceRoot":"","sources":["../../../src/cli/messenger/admin-statistics-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAA;AAInE,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,cAAc,CAAA;AAG/D,eAAO,MAAM,sBAAsB,cAAe,SAAS,UAAU,WAAW,KAAG,OA2DlF,CAAA"}