@leemour/max-cli 0.16.0 → 0.17.0

package/dist/client.js

@@ -1,4 +1,5 @@
 import { CliError } from "@leemour/cli-core";
+import { delayMs } from "./config.js";
 import { namesFrom, POLL_CLOSED, pollSettings, SETTING_FLAGS, toChat, toContact, toFolder, toGroupCard, toGroupMember, toMessage, toPoll, toProfile, toReactions, toSession, } from "./domain/map.js";
 import { heldWindows } from "./export.js";
 import { wireClient } from "./generated/client.generated.js";
@@ -71,10 +72,12 @@ export class MaxClient {
             if (!firstName)
                 throw new CliError("validation_error", "MAX needs a first name, and the profile has none — pass --first-name");
             const lastName = change.lastName ?? current.lastName;
+            const photoToken = change.photo === undefined ? undefined : await this.#profilePhoto(change.photo);
             const answer = await this.#wire.account.update({
                 firstName,
                 ...(lastName === undefined ? {} : { lastName }),
                 ...(change.description === undefined ? {} : { description: change.description }),
+                ...(photoToken === undefined ? {} : { photoToken, avatarType: "USER_AVATAR" }),
             });
             return toProfile(record(answer.profile) ?? {});
         }),
@@ -272,12 +275,13 @@ export class MaxClient {
                 throw new CliError("validation_error", "`--offline` reads what was recorded; it cannot read a link");
             const wire = wireLink(link);
             await this.#connectOnce();
-            return toGroupCard(record((await this.#wire.chats.linkInfo({ link: wire })).chat) ?? {});
+            const answer = await this.#wire.chats.linkInfo({ link: wire }).catch(deadLink(link));
+            return toGroupCard(record(answer.chat) ?? {});
         },
         join: (link) => {
             const wire = wireLink(link);
             return this.#changeChat(null, "join", async () => {
-                const chat = toGroupCard(record((await this.#wire.chats.join({ link: wire })).chat) ?? {});
+                const chat = toGroupCard(record((await this.#wire.chats.join({ link: wire }).catch(deadLink(link))).chat) ?? {});
                 return { chatId: chat.id, result: chat };
             });
         },
@@ -320,13 +324,13 @@ export class MaxClient {
          * Not retried, unlike a message: a second attempt with a new `cid` is a second group, and
          * whether MAX deduplicates a creation by `cid` is not measured.
          */
-        create: async (title, people = []) => {
+        create: async (title, people = [], { channel = false } = {}) => {
             const userIds = await this.#personIds(people);
             return this.#changeChat(null, "create", async () => {
                 const answer = await this.#wire.messages.send({
                     message: {
                         cid: this.#nextCid(),
-                        attaches: [{ _type: "CONTROL", event: "new", chatType: "CHAT", title, userIds }],
+                        attaches: [{ _type: "CONTROL", event: "new", chatType: channel ? "CHANNEL" : "CHAT", title, userIds }],
                     },
                     notify: true,
                 });
@@ -384,23 +388,6 @@ export class MaxClient {
             }),
             remove: (reference, person) => this.#updateMembers(reference, [person], "admins.remove", { operation: "remove", type: "ADMIN" }),
         },
-        requests: {
-            /** Each with the age of their account, read like a member's — the answer's `{contact}` is the same shape. */
-            list: async (reference) => {
-                if (this.#offline)
-                    throw new CliError("validation_error", "`--offline` reads what was recorded; join requests never are");
-                const chatId = await this.chats.resolve(reference);
-                await this.#connectOnce();
-                const answer = await this.#wire.chats.members({ chatId, type: "JOIN_REQUEST", count: JOIN_REQUESTS });
-                return asArray(answer.members).map(toGroupMember);
-            },
-            accept: (reference, people) => this.#updateMembers(reference, people, "requests.accept", {
-                operation: "add",
-                type: "JOIN_REQUEST",
-                showHistory: true,
-            }),
-            decline: (reference, people) => this.#updateMembers(reference, people, "requests.decline", { operation: "remove", type: "JOIN_REQUEST" }),
-        },
         update: async (reference, { title, description }) => {
             if (title === undefined && description === undefined) {
                 throw new CliError("validation_error", "nothing to change — give --title, --description or both");
@@ -501,8 +488,13 @@ export class MaxClient {
                 throw new CliError("not_found", "MAX has nobody under that number");
             return this.#remember(toContact(contact));
         },
-        add: (reference) => this.#contactAction("contact-add", "ADD", reference),
-        remove: (reference) => this.#contactAction("contact-remove", "REMOVE", reference),
+        add: (reference) => this.#contactAction("contact-add", { action: "ADD" }, reference),
+        remove: (reference) => this.#contactAction("contact-remove", { action: "REMOVE" }, reference),
+        /** They can no longer write to you. Works for somebody who is not a contact too (measured). */
+        block: (reference) => this.#contactAction("contact-block", { action: "BLOCK" }, reference),
+        unblock: (reference) => this.#contactAction("contact-unblock", { action: "UNBLOCK" }, reference),
+        /** A name of your own for them, kept beside the one they chose; they do not see it. */
+        rename: (reference, firstName, lastName) => this.#contactAction("contact-rename", { action: "UPDATE", firstName, ...(lastName === undefined ? {} : { lastName }) }, reference),
         /** Uploads phone numbers to MAX — other people's — under the names they were saved with. */
         import: (entries) => this.#change("contact-import", async () => {
             if (entries.length === 0)
@@ -769,9 +761,14 @@ export class MaxClient {
          */
         moment: (reference, flag = "--before") => {
             const wanted = reference.trim();
-            const time = /^\d+$/.test(wanted) ? timeOfMessageId(wanted) : Date.parse(wanted);
+            const ago = delayMs(wanted);
+            const time = /^\d+$/.test(wanted)
+                ? timeOfMessageId(wanted)
+                : ago === undefined
+                    ? Date.parse(wanted)
+                    : Date.now() - ago;
             if (time === undefined || Number.isNaN(time)) {
-                throw new CliError("validation_error", `${flag} takes a message id or an ISO 8601 time, not "${wanted}"`);
+                throw new CliError("validation_error", `${flag} takes a message id, an ISO 8601 time or 30m, 2h, 1d ago — not "${wanted}"`);
             }
             return time;
         },
@@ -1607,6 +1604,10 @@ export class MaxClient {
                     `the keyring is probably out of reach (cron, ssh: set XDG_RUNTIME_DIR); ` +
                     `\`max ${asFirstWord(profile)}doctor\` shows it. Log in again only if the token was removed`);
             }
+            if (this.#store.isBot()) {
+                throw new CliError("authentication_error", `profile "${profile}" is a bot — its commands are \`max ${asFirstWord(profile)}bot …\`; ` +
+                    `\`max ${asFirstWord(profile)}session start\` would add a personal account to it`);
+            }
             // The fix has to carry the profile, or it logs the wrong one in: a name nobody has logged
             // in under is the ordinary shape of this failure now that the first word is the profile.
             throw new CliError("authentication_error", `no session for profile "${profile}" — run \`max ${asFirstWord(profile)}session start\``);
@@ -2010,6 +2011,15 @@ export class MaxClient {
      * Uploads one file and answers what the message attaches (measured 2026-09-24). An upload is never
      * retried: a failure here happens before `MSG_SEND`, so nothing was sent.
      */
+    async #profilePhoto(path) {
+        if (!isImage(path))
+            throw new CliError("validation_error", `${path} is not an image MAX takes as a photo`);
+        const bytes = await readUpload(path);
+        const { url } = await this.#wire.uploads.photo({ count: 1, type: 0, uploaderType: 0, profile: true });
+        if (typeof url !== "string")
+            throw new CliError("provider_error", "MAX gave no address to upload the photo to");
+        return uploadPhoto(url, path, bytes);
+    }
     async #upload({ path, bytes, kind, voice }) {
         const request = { count: 1, type: 0, uploaderType: 0, profile: false };
         if (kind === "photo") {
@@ -2235,7 +2245,7 @@ export class MaxClient {
                 throw new CliError("validation_error", "without a local store a person is named by id — `max contacts lookup` finds one");
             }
             const id = isId(reference) ? reference.trim() : pickPerson(reference, cache).id;
-            const answer = await this.#wire.contacts.update({ contactId: id, action: wire });
+            const answer = await this.#wire.contacts.update({ contactId: id, ...wire });
             const contact = record(answer.contact);
             if (contact)
                 return this.#remember(toContact(contact));
@@ -2266,20 +2276,25 @@ export class MaxClient {
         return this.#login;
     }
 }
-/** PyMax `AdminPermission`; the sum is what MAX takes. */
+/**
+ * PyMax `AdminPermission`; the sum is what MAX takes. `read` and `link` measured 2026-09-27 by
+ * switching them in the app for a bot and reading its `permissions` back (`MAX-61`): «Read messages»
+ * sets 1 and 32 together — the Bot API calls them `read_all_messages` and `write` — and «Update chat
+ * link» 128. A bot without `read` sees no message of the group.
+ */
 export const ADMIN_RIGHTS = {
+    read: 1 | 32,
     members: 2,
     admins: 4,
     info: 8,
     pin: 16,
+    link: 128,
     post: 256,
     edit: 512,
     delete: 1024,
 };
-/** PyMax asks for this many; paging join requests is not known. */
 /** The most chats `max serve` holds from pushes before it logs in again instead. */
 const LIVE_CHATS = 10_000;
-const JOIN_REQUESTS = 100;
 /** PyMax's page, the one measured. */
 const MEMBERS_PAGE = 50;
 const MEMBERS_READ = 5000;
@@ -2470,6 +2485,13 @@ const asRefusal = (error) => {
     }
     return new CliError("provider_error", error.message, { operation: String(error.opcode) });
 };
+/** A link that was reset, or never led anywhere, is `not.found` from MAX (measured 2026-09-28). */
+const deadLink = (link) => (error) => {
+    const failure = asCliError(error);
+    if (failure.details.maxError !== "not.found")
+        throw failure;
+    throw new CliError("not_found", `${link.trim()} leads nowhere — the link was reset, or never worked`);
+};
 const LIMIT_WORDS = ["limit.violate", "rate_limit", "rate limit", "too many", "слишком много"];
 /** Before any request: a login inside the pause is one more attempt MAX counts (`MAX-38`). */
 export const refuseWhilePaused = (state) => {