@wirecat/tg-cli 0.0.0 → 0.43.0

package/dist/bot/map.js

@@ -0,0 +1,193 @@
+import { CliError } from "@wirecat/cli-core";
+const KINDS = {
+    private: "dialog",
+    group: "group",
+    supergroup: "group",
+    channel: "channel",
+};
+const ENTITY = { bold: "bold", italic: "italic", strike: "strikethrough", code: "code" };
+const nameOf = (person) => person ? [person.first_name, person.last_name].filter(Boolean).join(" ") || null : null;
+const iso = (seconds) => new Date(seconds * 1000).toISOString();
+/**
+ * A file by Telegram's `file_id` only. ⚠ Never a download address: Telegram's has the bot token in
+ * it, and an `Attachment.url` would put the token into the store and into command output.
+ */
+const attachmentsOf = (message) => {
+    const files = [
+        ["photo", message.photo?.at(-1)],
+        ["file", message.document],
+        ["voice", message.voice],
+        ["video", message.video],
+        ["audio", message.audio],
+    ];
+    return files.flatMap(([kind, file]) => {
+        if (!file)
+            return [];
+        const attachment = { kind, providerRef: { fileId: file.file_id } };
+        if (file.file_name)
+            attachment.name = file.file_name;
+        if (file.file_size !== undefined)
+            attachment.size = file.file_size;
+        if (file.duration !== undefined)
+            attachment.duration = file.duration;
+        return [attachment];
+    });
+};
+const quoted = (message, selfId) => ({
+    id: String(message.message_id),
+    senderId: message.from ? String(message.from.id) : null,
+    senderName: nameOf(message.from),
+    timestamp: iso(message.date),
+    text: message.text ?? message.caption ?? "",
+    attachments: attachmentsOf(message),
+    outgoing: selfId === undefined || !message.from ? null : String(message.from.id) === selfId,
+});
+/** `selfId` is the bot's own id, when known, so `outgoing` says whether the bot wrote it. */
+export const toMessage = (message, selfId) => {
+    const mapped = {
+        id: String(message.message_id),
+        chatId: String(message.chat.id),
+        senderId: message.from ? String(message.from.id) : null,
+        senderName: nameOf(message.from),
+        timestamp: iso(message.date),
+        editedAt: message.edit_date === undefined ? null : iso(message.edit_date),
+        text: message.text ?? message.caption ?? "",
+        outgoing: selfId === undefined || !message.from ? null : String(message.from.id) === selfId,
+        attachments: attachmentsOf(message),
+        replyTo: message.reply_to_message ? quoted(message.reply_to_message, selfId) : null,
+        forwardedFrom: null,
+        reactions: null,
+    };
+    if (message.reply_to_message)
+        mapped.replyToId = String(message.reply_to_message.message_id);
+    return mapped;
+};
+export const toChat = (chat) => ({
+    id: String(chat.id),
+    title: chat.title ?? nameOf(chat),
+    kind: KINDS[chat.type] ?? "unknown",
+    unreadCount: null,
+    lastMessageAt: null,
+    participantsCount: null,
+    providerMetadata: { type: chat.type, ...(chat.username ? { username: chat.username } : {}) },
+});
+/** Markup is in UTF-16 positions, which is what Telegram's [entities](https://core.telegram.org/bots/api#messageentity) count. */
+export const entitiesOf = (markup) => markup.map((span) => {
+    const base = { offset: span.from, length: span.length };
+    switch (span.type) {
+        case "bold":
+        case "italic":
+        case "strike":
+        case "code":
+            return { type: ENTITY[span.type], ...base };
+        case "underline":
+        case "spoiler":
+        case "blockquote":
+            return { type: span.type, ...base };
+        case "pre":
+            return { type: "pre", ...base, language: span.language ?? "" };
+        case "link":
+            return { type: "text_link", ...base, url: span.url };
+        default:
+            throw new CliError("validation_error", "Telegram does not support this formatting span");
+    }
+});
+/**
+ * The shared admin rights in [promoteChatMember](https://core.telegram.org/bots/api#promotechatmember)'s
+ * words, as tg's personal account maps them. Telegram has no right to read: an admin always reads.
+ */
+export const ADMIN_RIGHT_FIELDS = {
+    members: "can_restrict_members",
+    admins: "can_promote_members",
+    info: "can_change_info",
+    pin: "can_pin_messages",
+    link: "can_invite_users",
+    post: "can_post_messages",
+    edit: "can_edit_messages",
+    delete: "can_delete_messages",
+};
+export const BOT_ADMIN_RIGHTS = Object.keys(ADMIN_RIGHT_FIELDS);
+/** Every right promoteChatMember takes; all of them false demotes. */
+export const PROMOTE_FIELDS = [
+    "is_anonymous",
+    "can_manage_chat",
+    "can_delete_messages",
+    "can_manage_video_chats",
+    "can_restrict_members",
+    "can_promote_members",
+    "can_change_info",
+    "can_invite_users",
+    "can_post_stories",
+    "can_edit_stories",
+    "can_delete_stories",
+    "can_post_messages",
+    "can_edit_messages",
+    "can_pin_messages",
+    "can_manage_topics",
+    "can_send_welcome_messages",
+];
+export const toAdmin = ({ status, user, custom_title, ...rights }) => ({
+    id: String(user.id),
+    name: nameOf(user),
+    username: user.username ?? null,
+    role: status === "creator" ? "owner" : "admin",
+    rights: BOT_ADMIN_RIGHTS.filter((right) => status === "creator" || rights[ADMIN_RIGHT_FIELDS[right]] === true),
+    title: custom_title ?? null,
+});
+/**
+ * Asked for every time, because Telegram keeps the last list it was given (RISK-95): without
+ * `chat_member`, nobody joining or leaving would ever arrive.
+ */
+export const UPDATE_TYPES = [
+    "message",
+    "edited_message",
+    "channel_post",
+    "edited_channel_post",
+    "callback_query",
+    "my_chat_member",
+    "chat_member",
+];
+const inChat = ({ status, is_member }) => status === "creator" ||
+    status === "administrator" ||
+    status === "member" ||
+    (status === "restricted" && is_member === true);
+const personOf = (user) => ({ id: String(user.id), name: nameOf(user), username: user.username ?? null });
+/** One update in the shared words; a kind not decoded here is `other`, under Telegram's own name. */
+export const toEvent = (update, selfId) => {
+    const created = update.message ?? update.channel_post;
+    if (created)
+        return { event: "message", message: { ...toMessage(created, selfId), chatTitle: null } };
+    const edited = update.edited_message ?? update.edited_channel_post;
+    if (edited)
+        return { event: "edit", message: { ...toMessage(edited, selfId), chatTitle: null } };
+    const press = update.callback_query;
+    if (press) {
+        return {
+            event: "callback",
+            callbackId: press.id,
+            chatId: press.message ? String(press.message.chat.id) : null,
+            messageId: press.message ? String(press.message.message_id) : null,
+            from: personOf(press.from),
+            data: press.data ?? "",
+        };
+    }
+    const change = update.chat_member;
+    if (change) {
+        const was = inChat(change.old_chat_member);
+        const is = inChat(change.new_chat_member);
+        const person = change.new_chat_member.user;
+        const self = change.from.id === person.id;
+        if (was !== is) {
+            return {
+                event: is ? (self ? "joined" : "added") : self ? "left" : "removed",
+                chatId: String(change.chat.id),
+                person: personOf(person),
+                at: iso(change.date),
+            };
+        }
+    }
+    const kind = Object.keys(update).find((key) => key !== "update_id") ?? "unknown";
+    const chat = update[kind]?.chat;
+    return { event: "other", type: kind, chatId: chat ? String(chat.id) : null };
+};
+//# sourceMappingURL=map.js.map

package/dist/bot/map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.js","sourceRoot":"","sources":["../../src/bot/map.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAwD5C,MAAM,KAAK,GAAqC;IAC9C,OAAO,EAAE,QAAQ;IACjB,KAAK,EAAE,OAAO;IACd,UAAU,EAAE,OAAO;IACnB,OAAO,EAAE,SAAS;CACnB,CAAA;AAED,MAAM,MAAM,GAAmC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;AAExH,MAAM,MAAM,GAAG,CAAC,MAA+D,EAAiB,EAAE,CAChG,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;AAEzF,MAAM,GAAG,GAAG,CAAC,OAAe,EAAU,EAAE,CAAC,IAAI,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE,CAAA;AAE/E;;;GAGG;AACH,MAAM,aAAa,GAAG,CAAC,OAAkB,EAAgB,EAAE;IACzD,MAAM,KAAK,GAAoC;QAC7C,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC;QAC1B,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC;QACxB,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC;QACxB,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC;KACzB,CAAA;IACD,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE;QACpC,IAAI,CAAC,IAAI;YAAE,OAAO,EAAE,CAAA;QACpB,MAAM,UAAU,GAAe,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,CAAA;QAC9E,IAAI,IAAI,CAAC,SAAS;YAAE,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAA;QACpD,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;YAAE,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAA;QAClE,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;YAAE,UAAU,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAA;QACpE,OAAO,CAAC,UAAU,CAAC,CAAA;IACrB,CAAC,CAAC,CAAA;AACJ,CAAC,CAAA;AAED,MAAM,MAAM,GAAG,CAAC,OAAkB,EAAE,MAA0B,EAAiB,EAAE,CAAC,CAAC;IACjF,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI;IACvD,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;IAChC,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC;IAC5B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,OAAO,IAAI,EAAE;IAC3C,WAAW,EAAE,aAAa,CAAC,OAAO,CAAC;IACnC,QAAQ,EAAE,MAAM,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,MAAM;CAC5F,CAAC,CAAA;AAEF,6FAA6F;AAC7F,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,OAAkB,EAAE,MAAe,EAAW,EAAE;IACxE,MAAM,MAAM,GAAY;QACtB,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC;QAC9B,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI;QACvD,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;QAChC,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC;QAC5B,QAAQ,EAAE,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC;QACzE,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,OAAO,IAAI,EAAE;QAC3C,QAAQ,EAAE,MAAM,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,MAAM;QAC3F,WAAW,EAAE,aAAa,CAAC,OAAO,CAAC;QACnC,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI;QACnF,aAAa,EAAE,IAAI;QACnB,SAAS,EAAE,IAAI;KAChB,CAAA;IACD,IAAI,OAAO,CAAC,gBAAgB;QAAE,MAAM,CAAC,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAA;IAC5F,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,IAAY,EAAQ,EAAE,CAAC,CAAC;IAC7C,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;IACnB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC;IACjC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS;IACnC,WAAW,EAAE,IAAI;IACjB,aAAa,EAAE,IAAI;IACnB,iBAAiB,EAAE,IAAI;IACvB,gBAAgB,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;CAC7F,CAAC,CAAA;AAEF,kIAAkI;AAClI,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,MAAsC,EAAE,EAAE,CACnE,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;IAClB,MAAM,IAAI,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAA;IACvD,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,MAAM,CAAC;QACZ,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ,CAAC;QACd,KAAK,MAAM;YACT,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,CAAA;QAC7C,KAAK,WAAW,CAAC;QACjB,KAAK,SAAS,CAAC;QACf,KAAK,YAAY;YACf,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,EAAE,CAAA;QACrC,KAAK,KAAK;YACR,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAA;QAChE,KAAK,MAAM;YACT,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAA;QACtD;YACE,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,gDAAgD,CAAC,CAAA;IAC5F,CAAC;AACH,CAAC,CAAC,CAAA;AAEJ;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,OAAO,EAAE,sBAAsB;IAC/B,MAAM,EAAE,qBAAqB;IAC7B,IAAI,EAAE,iBAAiB;IACvB,GAAG,EAAE,kBAAkB;IACvB,IAAI,EAAE,kBAAkB;IACxB,IAAI,EAAE,mBAAmB;IACzB,IAAI,EAAE,mBAAmB;IACzB,MAAM,EAAE,qBAAqB;CACyB,CAAA;AAExD,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAwC,CAAA;AAEtG,sEAAsE;AACtE,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,cAAc;IACd,iBAAiB;IACjB,qBAAqB;IACrB,wBAAwB;IACxB,sBAAsB;IACtB,qBAAqB;IACrB,iBAAiB;IACjB,kBAAkB;IAClB,kBAAkB;IAClB,kBAAkB;IAClB,oBAAoB;IACpB,mBAAmB;IACnB,mBAAmB;IACnB,kBAAkB;IAClB,mBAAmB;IACnB,2BAA2B;CACnB,CAAA;AAUV,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,MAAM,EAAW,EAAgB,EAAE,CAAC,CAAC;IAC5F,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC;IAClB,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI;IAC/B,IAAI,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO;IAC9C,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC;IAC9G,KAAK,EAAE,YAAY,IAAI,IAAI;CAC5B,CAAC,CAAA;AAqBF;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,SAAS;IACT,gBAAgB;IAChB,cAAc;IACd,qBAAqB;IACrB,gBAAgB;IAChB,gBAAgB;IAChB,aAAa;CACd,CAAA;AAED,MAAM,MAAM,GAAG,CAAC,EAAE,MAAM,EAAE,SAAS,EAAgB,EAAE,EAAE,CACrD,MAAM,KAAK,SAAS;IACpB,MAAM,KAAK,eAAe;IAC1B,MAAM,KAAK,QAAQ;IACnB,CAAC,MAAM,KAAK,YAAY,IAAI,SAAS,KAAK,IAAI,CAAC,CAAA;AAEjD,MAAM,QAAQ,GAAG,CAAC,IAAU,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI,EAAE,CAAC,CAAA;AAE/G,qGAAqG;AACrG,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,MAAgB,EAAE,MAA0B,EAAY,EAAE;IAChF,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,YAAY,CAAA;IACrD,IAAI,OAAO;QAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAA;IACrG,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,IAAI,MAAM,CAAC,mBAAmB,CAAA;IAClE,IAAI,MAAM;QAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAA;IAChG,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAA;IACnC,IAAI,KAAK,EAAE,CAAC;QACV,OAAO;YACL,KAAK,EAAE,UAAU;YACjB,UAAU,EAAE,KAAK,CAAC,EAAE;YACpB,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI;YAC5D,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI;YAClE,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;YAC1B,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE;SACvB,CAAA;IACH,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAA;IACjC,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAA;QAC1C,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAA;QACzC,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,CAAC,IAAI,CAAA;QAC1C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE,CAAA;QACzC,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;YACf,OAAO;gBACL,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;gBACnE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9B,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC;gBACxB,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;aACrB,CAAA;QACH,CAAC;IACH,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,WAAW,CAAC,IAAI,SAAS,CAAA;IAChF,MAAM,IAAI,GAAI,MAAM,CAAC,IAAI,CAAmC,EAAE,IAAI,CAAA;IAClE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;AAC9E,CAAC,CAAA"}

package/dist/bot/proxy.d.ts

@@ -0,0 +1,15 @@
+import type { Dispatcher } from "undici";
+import { type ProxyServer } from "../proxy.js";
+import type { FetchLike } from "./transport.js";
+/**
+ * The Bot API is HTTPS, so it can go through a SOCKS5 or an HTTP proxy — never an MTProxy, which
+ * carries only Telegram's own protocol. Credentials go as options, never in the URL, so no error
+ * undici builds from the URL can carry them.
+ */
+export declare const botDispatcher: (proxy: ProxyServer) => Promise<Dispatcher | undefined>;
+/**
+ * undici's own `fetch` with its agent, not the global one: an agent from one copy of undici is not
+ * promised to work with another's fetch.
+ */
+export declare const proxiedFetch: (proxy: ProxyServer) => FetchLike | undefined;
+//# sourceMappingURL=proxy.d.ts.map

package/dist/bot/proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../src/bot/proxy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AACxC,OAAO,EAAE,KAAK,WAAW,EAA4B,MAAM,aAAa,CAAA;AACxE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE/C;;;;GAIG;AACH,eAAO,MAAM,aAAa,UAAiB,WAAW,KAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAiBtF,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,UAAW,WAAW,KAAG,SAAS,GAAG,SAY7D,CAAA"}

package/dist/bot/proxy.js

@@ -0,0 +1,64 @@
+import { proxyAddress, proxyError } from "../proxy.js";
+/**
+ * The Bot API is HTTPS, so it can go through a SOCKS5 or an HTTP proxy — never an MTProxy, which
+ * carries only Telegram's own protocol. Credentials go as options, never in the URL, so no error
+ * undici builds from the URL can carry them.
+ */
+export const botDispatcher = async (proxy) => {
+    if (proxy.kind === "mtproxy")
+        return undefined;
+    // Loaded on use: Bun answers `import "undici"` with its own module, which has no SOCKS agent.
+    const { ProxyAgent, Socks5ProxyAgent } = await import("undici");
+    const uri = proxyAddress(proxy);
+    if (typeof ProxyAgent !== "function" || typeof Socks5ProxyAgent !== "function")
+        throw proxyError(proxy, "cannot carry the Bot API under this runtime — run tg with Node");
+    if (proxy.kind === "socks5")
+        return new Socks5ProxyAgent(uri, {
+            ...(proxy.user === undefined ? {} : { username: proxy.user }),
+            ...(proxy.secret === undefined ? {} : { password: proxy.secret }),
+        });
+    const basic = proxy.user === undefined
+        ? undefined
+        : `Basic ${Buffer.from(`${proxy.user}:${proxy.secret ?? ""}`).toString("base64")}`;
+    return new ProxyAgent({ uri, ...(basic ? { token: basic } : {}) });
+};
+/**
+ * undici's own `fetch` with its agent, not the global one: an agent from one copy of undici is not
+ * promised to work with another's fetch.
+ */
+export const proxiedFetch = (proxy) => {
+    if (proxy.kind === "mtproxy")
+        return undefined;
+    let dispatcher;
+    return async (url, init) => {
+        dispatcher ??= botDispatcher(proxy);
+        const [{ fetch }, agent] = await Promise.all([import("undici"), dispatcher]);
+        try {
+            return (await fetch(url, { ...init, ...(agent ? { dispatcher: agent } : {}) }));
+        }
+        catch (error) {
+            throw proxyRefusal(proxy, error) ?? error;
+        }
+    };
+};
+/**
+ * With a proxy, tg opens no connection but the one to the proxy, so a refused or unknown address is
+ * the proxy's; a tunnel the proxy would not open is too. Either way the request never left.
+ */
+const proxyRefusal = (proxy, error) => {
+    for (let cause = error; cause instanceof Error; cause = cause.cause) {
+        const code = cause.code;
+        const status = /Proxy response \((\d+)\)/.exec(cause.message)?.[1];
+        const reason = status !== undefined
+            ? `refused the tunnel (HTTP ${status})`
+            : typeof code === "string" && code.startsWith("UND_ERR_SOCKS5")
+                ? `refused (${code})`
+                : typeof code === "string" && /^(ECONN|ENOTFOUND|EAI_AGAIN|ETIMEDOUT|ENETUNREACH|EHOSTUNREACH)/.test(code)
+                    ? `cannot be reached (${code})`
+                    : undefined;
+        if (reason)
+            return proxyError(proxy, reason);
+    }
+    return undefined;
+};
+//# sourceMappingURL=proxy.js.map

package/dist/bot/proxy.js.map

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

package/dist/bot/transport.d.ts

@@ -0,0 +1,42 @@
+import type { EventSink } from "@wirecat/cli-messaging/cli";
+export type FetchLike = (url: string, init: RequestInit) => Promise<Response>;
+export interface BotTransportOptions {
+    token: string;
+    baseUrl?: string;
+    fetch?: FetchLike;
+    timeoutMs?: number;
+    /** Ends the command's request in flight: the deadline, or Ctrl-C on a command that runs until told to. */
+    signal?: AbortSignal;
+    events?: EventSink;
+}
+/**
+ * Telegram's Bot API, method by method.
+ *
+ * ⚠ **The token is part of every address** — `/bot<token>/<method>` — so the address never leaves
+ * this class: not in an error, not in a trace line, and never by passing on a failed request's own
+ * error, whose text may hold it. A failure keeps the method, Telegram's code and Telegram's words.
+ */
+export declare class TelegramBotTransport {
+    #private;
+    constructor(options: BotTransportOptions);
+    /**
+     * `reads: false` for a write, so a write that got no answer is `outcome_unknown`, never retried by
+     * anyone. `file` goes up in the same request, as multipart: Telegram has no upload step of its own.
+     * `timeoutMs` replaces the transport's for one call — a long poll waits longer than any other request.
+     */
+    call(method: string, params?: Record<string, unknown>, { reads, file, files, body, secrets, timeoutMs, }?: {
+        reads?: boolean;
+        file?: OutgoingFile;
+        files?: readonly OutgoingFile[];
+        body?: string;
+        secrets?: readonly string[];
+        timeoutMs?: number;
+    }): Promise<unknown>;
+}
+/** A file sent with a method — `photo` for sendPhoto, `document`, `voice`. */
+export interface OutgoingFile {
+    field: string;
+    name: string;
+    bytes: Uint8Array;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/bot/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/bot/transport.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAM3D,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;AAE7E,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,0GAA0G;IAC1G,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,MAAM,CAAC,EAAE,SAAS,CAAA;CACnB;AAWD;;;;;;GAMG;AACH,qBAAa,oBAAoB;;IAQ/B,YAAY,OAAO,EAAE,mBAAmB,EAOvC;IAED;;;;OAIG;IACG,IAAI,CACR,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACpC,EACE,KAAY,EACZ,IAAI,EACJ,KAAU,EACV,IAAI,EACJ,OAAY,EACZ,SAA2B,GAC5B,GAAE;QACD,KAAK,CAAC,EAAE,OAAO,CAAA;QACf,IAAI,CAAC,EAAE,YAAY,CAAA;QACnB,KAAK,CAAC,EAAE,SAAS,YAAY,EAAE,CAAA;QAC/B,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;QAC3B,SAAS,CAAC,EAAE,MAAM,CAAA;KACd,GACL,OAAO,CAAC,OAAO,CAAC,CAkElB;CAsBF;AAED,8EAA8E;AAC9E,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,UAAU,CAAA;CAClB"}

package/dist/bot/transport.js

@@ -0,0 +1,158 @@
+import { CliError, isCliError } from "@wirecat/cli-core";
+import { apiJson, apiPlainJson, parseApiJson } from "@wirecat/cli-messaging/cli";
+const API = "https://api.telegram.org";
+const DEFAULT_TIMEOUT_MS = 30_000;
+/**
+ * Telegram's Bot API, method by method.
+ *
+ * ⚠ **The token is part of every address** — `/bot<token>/<method>` — so the address never leaves
+ * this class: not in an error, not in a trace line, and never by passing on a failed request's own
+ * error, whose text may hold it. A failure keeps the method, Telegram's code and Telegram's words.
+ */
+export class TelegramBotTransport {
+    #token;
+    #baseUrl;
+    #fetch;
+    #timeoutMs;
+    #signal;
+    #events;
+    constructor(options) {
+        this.#token = options.token;
+        this.#baseUrl = options.baseUrl ?? API;
+        this.#fetch = options.fetch ?? fetch;
+        this.#timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        this.#signal = options.signal;
+        this.#events = options.events;
+    }
+    /**
+     * `reads: false` for a write, so a write that got no answer is `outcome_unknown`, never retried by
+     * anyone. `file` goes up in the same request, as multipart: Telegram has no upload step of its own.
+     * `timeoutMs` replaces the transport's for one call — a long poll waits longer than any other request.
+     */
+    async call(method, params = {}, { reads = true, file, files = [], body, secrets = [], timeoutMs = this.#timeoutMs, } = {}) {
+        this.#events?.({ event: "request", operation: method });
+        const started = performance.now();
+        const signals = [AbortSignal.timeout(timeoutMs), ...(this.#signal ? [this.#signal] : [])];
+        let response;
+        try {
+            response = await this.#fetch(`${this.#baseUrl}/bot${this.#token}/${method}`, {
+                method: "POST",
+                ...(file || files.length
+                    ? {
+                        headers: { Accept: "application/json" },
+                        body: multipart(body === undefined ? params : parseApiJson(body), file ? [file, ...files] : files),
+                    }
+                    : {
+                        headers: { "Content-Type": "application/json", Accept: "application/json" },
+                        body: body ?? apiJson(params),
+                    }),
+                signal: AbortSignal.any(signals),
+            });
+        }
+        catch (error) {
+            const failure = this.#unanswered(method, error, reads, timeoutMs);
+            this.#events?.({ event: "response", operation: method, outcome: "error", errorCode: failure.code });
+            throw failure;
+        }
+        let text;
+        try {
+            text = await response.text();
+        }
+        catch (error) {
+            const failure = this.#unanswered(method, error, reads, timeoutMs);
+            this.#events?.({ event: "response", operation: method, outcome: "error", errorCode: failure.code });
+            throw failure;
+        }
+        const answered = {
+            event: "response",
+            operation: method,
+            status: response.status,
+            bytes: Buffer.byteLength(text),
+            durationMs: Math.round(performance.now() - started),
+        };
+        let answer;
+        try {
+            answer = apiPlainJson(parseApiJson(text));
+        }
+        catch {
+            this.#events?.({ ...answered, outcome: "error", errorCode: "invalid_response" });
+            throw new CliError("invalid_response", `Telegram answered ${method} with something that is not JSON`, {
+                operation: method,
+                status: response.status,
+            });
+        }
+        if (answer.ok === true) {
+            this.#events?.({ ...answered, outcome: "ok" });
+            return answer.result;
+        }
+        const secretValues = [this.#token, ...secrets];
+        if (answer.description) {
+            for (const secret of secretValues)
+                if (secret)
+                    answer.description = answer.description.split(secret).join("[redacted]");
+            answer.description = answer.description.replace(/\b\d+:[A-Za-z0-9_-]{20,}\b/g, "[redacted]");
+        }
+        const refusal = refusalOf(method, answer, response.status);
+        this.#events?.({ ...answered, outcome: "error", errorCode: refusal.code });
+        throw refusal;
+    }
+    #unanswered(method, error, reads, timeoutMs) {
+        // A proxy that refused, or was not there, never passed the request on — not an unknown outcome.
+        if (isCliError(error) && error.details.proxy !== undefined)
+            return error;
+        const timedOut = error?.name === "TimeoutError";
+        if (this.#signal?.aborted && this.#signal.reason?.name !== "TimeoutError") {
+            return new CliError("cancelled", `${method} was cancelled`, { operation: method });
+        }
+        if (!reads) {
+            return new CliError("outcome_unknown", `${method} got no answer; Telegram may or may not have carried it out — check before repeating it`, { operation: method, retryable: false });
+        }
+        return new CliError(timedOut ? "timeout" : "network_error", timedOut ? `${method} got no answer within ${timeoutMs} ms` : `${method} could not reach Telegram`, { operation: method, retryable: true });
+    }
+}
+/** A field that is not a string goes as JSON, as Telegram reads `reply_parameters` and `caption_entities` from a form. */
+const multipart = (params, files) => {
+    const form = new FormData();
+    for (const [name, value] of Object.entries(params)) {
+        if (value !== undefined)
+            form.append(name, typeof value === "string" ? value : apiJson(value));
+    }
+    for (const file of files)
+        form.append(file.field, new Blob([file.bytes]), file.name);
+    return form;
+};
+/**
+ * Telegram's own words go into the message: they name the problem ("chat not found") and never the
+ * token. Its `error_code` is "subject to change", so the code here follows the HTTP status.
+ */
+const refusalOf = (method, answer, status) => {
+    const said = answer.description ?? `HTTP ${status}`;
+    const details = { operation: method, status };
+    const retryAfter = answer.parameters?.retry_after;
+    if (retryAfter !== undefined) {
+        return new CliError("rate_limited", `Telegram asks to wait ${retryAfter} s before ${method}: ${said}`, {
+            ...details,
+            retryAfterMs: retryAfter * 1000,
+            retryable: true,
+        });
+    }
+    const migrated = answer.parameters?.migrate_to_chat_id;
+    if (migrated !== undefined) {
+        return new CliError("not_found", `this group became a supergroup with id ${migrated} — use that id from now on (${said})`, { ...details, migratedTo: String(migrated) });
+    }
+    // A token Telegram cannot parse answers 404, a revoked one 401; the methods called are this code's own.
+    const code = status === 401 || status === 404
+        ? "authentication_error"
+        : status === 403
+            ? "permission_error"
+            : status >= 500
+                ? "provider_unavailable"
+                : /not found/i.test(said)
+                    ? "not_found"
+                    : status === 400
+                        ? "validation_error"
+                        : "provider_error";
+    const message = code === "authentication_error" ? `Telegram did not accept this bot token (${said})` : `${method}: ${said}`;
+    return new CliError(code, message, details);
+};
+//# sourceMappingURL=transport.js.map

package/dist/bot/transport.js.map

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

package/dist/browser.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Hands a link to the system's own opener. Best effort: a server has no browser, so the caller
+ * prints the link as well and never depends on this.
+ */
+export declare const openInBrowser: (url: string, platform?: NodeJS.Platform) => boolean;
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,aAAa,QAAS,MAAM,aAAY,MAAM,CAAC,QAAQ,KAAsB,OAWzF,CAAA"}

package/dist/browser.js

@@ -0,0 +1,18 @@
+import { spawn } from "node:child_process";
+/**
+ * Hands a link to the system's own opener. Best effort: a server has no browser, so the caller
+ * prints the link as well and never depends on this.
+ */
+export const openInBrowser = (url, platform = process.platform) => {
+    const [command, ...args] = platform === "darwin" ? ["open", url] : platform === "win32" ? ["cmd", "/c", "start", "", url] : ["xdg-open", url];
+    try {
+        const child = spawn(command ?? "xdg-open", args, { detached: true, stdio: "ignore" });
+        child.on("error", () => { });
+        child.unref();
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE1C;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,GAAW,EAAE,QAAQ,GAAoB,OAAO,CAAC,QAAQ,EAAW,EAAE;IAClG,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GACtB,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,GAAG,CAAC,CAAA;IACpH,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,IAAI,UAAU,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAA;QACrF,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QAC3B,KAAK,CAAC,KAAK,EAAE,CAAA;QACb,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC,CAAA"}

package/dist/commands/bot-api.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare const telegramBotApiCommand: () => Command;
+//# sourceMappingURL=bot-api.d.ts.map

package/dist/commands/bot-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot-api.d.ts","sourceRoot":"","sources":["../../src/commands/bot-api.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAiBxC,eAAO,MAAM,qBAAqB,QAAO,OAyGrC,CAAA"}