@wirecat/tg-cli 0.0.0 → 0.43.1

package/dist/telegram/poll-voters.js

@@ -0,0 +1,31 @@
+import { PeersIndex, parsePeer } from "@mtcute/node";
+import { answerId, toMember } from "./map.js";
+/**
+ * Newest first, as Telegram lists them. Asked for one answer, Telegram sends each vote without it
+ * (`messagePeerVoteInputOption`): it is the answer asked for.
+ */
+export const pollVotersOf = async (client, chatId, messageId, { limit, answerId: answer }) => {
+    const list = await client.call({
+        _: "messages.getPollVotes",
+        peer: await client.resolvePeer(chatId),
+        id: messageId,
+        limit,
+        ...(answer === undefined ? {} : { option: Buffer.from(answer, "base64url") }),
+    });
+    const peers = PeersIndex.from(list);
+    const answersOf = (vote) => {
+        if (vote._ === "messagePeerVote")
+            return [answerId(vote.option)];
+        if (vote._ === "messagePeerVoteMultiple")
+            return vote.options.map(answerId);
+        return answer === undefined ? [] : [answer];
+    };
+    const items = list.votes.map((vote) => ({
+        person: toMember(parsePeer(vote.peer, peers)),
+        answers: answersOf(vote),
+        votedAt: new Date(vote.date * 1000).toISOString(),
+    }));
+    // Live 2026-10-08, Telegram sent a next offset with one vote of one; the count decides.
+    return { items, hasMore: Boolean(list.nextOffset) && items.length < list.count, total: list.count };
+};
+//# sourceMappingURL=poll-voters.js.map

package/dist/telegram/poll-voters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"poll-voters.js","sourceRoot":"","sources":["../../src/telegram/poll-voters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAgC,MAAM,cAAc,CAAA;AAElF,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAI7C;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAC/B,MAAc,EACd,MAAc,EACd,SAAiB,EACjB,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAwC,EACpB,EAAE;IAC/C,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;QAC7B,CAAC,EAAE,uBAAuB;QAC1B,IAAI,EAAE,MAAM,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC;QACtC,EAAE,EAAE,SAAS;QACb,KAAK;QACL,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,CAAC;KAC9E,CAAC,CAAA;IACF,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACnC,MAAM,SAAS,GAAG,CAAC,IAA4B,EAAE,EAAE;QACjD,IAAI,IAAI,CAAC,CAAC,KAAK,iBAAiB;YAAE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;QAChE,IAAI,IAAI,CAAC,CAAC,KAAK,yBAAyB;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAC3E,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;IAC7C,CAAC,CAAA;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACtC,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC7C,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC;QACxB,OAAO,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE;KAClD,CAAC,CAAC,CAAA;IACH,wFAAwF;IACxF,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAA;AACrG,CAAC,CAAA"}

package/dist/telegram/polls.d.ts

@@ -0,0 +1,5 @@
+import type { Poll as TgPoll } from "@mtcute/node";
+/** What Telegram would refuse anyway, said before anything is sent — the same checks max-cli makes. */
+export declare const refuseVote: (poll: TgPoll, answerIds: readonly string[]) => void;
+export declare const refuseClose: (poll: TgPoll) => void;
+//# sourceMappingURL=polls.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"polls.d.ts","sourceRoot":"","sources":["../../src/telegram/polls.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,IAAI,MAAM,EAAE,MAAM,cAAc,CAAA;AAGlD,uGAAuG;AACvG,eAAO,MAAM,UAAU,SAAU,MAAM,aAAa,SAAS,MAAM,EAAE,KAAG,IAQvE,CAAA;AAED,eAAO,MAAM,WAAW,SAAU,MAAM,KAAG,IAG1C,CAAA"}

package/dist/telegram/polls.js

@@ -0,0 +1,20 @@
+import { CliError } from "@wirecat/cli-core";
+/** What Telegram would refuse anyway, said before anything is sent — the same checks max-cli makes. */
+export const refuseVote = (poll, answerIds) => {
+    if (poll.isClosed)
+        throw new CliError("validation_error", "this poll is closed; `tg polls show` has its result");
+    const voted = poll.answers.some((answer) => answer.chosen);
+    if (answerIds.length === 0 && !voted)
+        throw new CliError("validation_error", "you have not voted in this poll");
+    if (voted && poll.isRevotingDisabled)
+        throw new CliError("validation_error", "this poll takes one vote, and yours is final — it cannot be changed");
+    if (answerIds.length > 1 && !poll.isMultiple)
+        throw new CliError("validation_error", "this poll takes one answer; give one id");
+};
+export const refuseClose = (poll) => {
+    if (poll.isClosed)
+        throw new CliError("validation_error", "this poll is closed already");
+    if (!poll.isCreator)
+        throw new CliError("permission_error", "only whoever made a poll can close it");
+};
+//# sourceMappingURL=polls.js.map

package/dist/telegram/polls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"polls.js","sourceRoot":"","sources":["../../src/telegram/polls.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAE5C,uGAAuG;AACvG,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,SAA4B,EAAQ,EAAE;IAC7E,IAAI,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,qDAAqD,CAAC,CAAA;IAChH,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IAC1D,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,iCAAiC,CAAC,CAAA;IAC/G,IAAI,KAAK,IAAI,IAAI,CAAC,kBAAkB;QAClC,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,qEAAqE,CAAC,CAAA;IAC/G,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU;QAC1C,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,yCAAyC,CAAC,CAAA;AACrF,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAY,EAAQ,EAAE;IAChD,IAAI,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,6BAA6B,CAAC,CAAA;IACxF,IAAI,CAAC,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,uCAAuC,CAAC,CAAA;AACtG,CAAC,CAAA"}

package/dist/telegram/profile.d.ts

@@ -0,0 +1,9 @@
+import type { FullUser, User } from "@mtcute/node";
+import type { ProfileFacts, Registered, Seen } from "@wirecat/cli-messaging";
+export declare const estimatedRegistration: (id: number) => Registered | null;
+/** Telegram's own month, `MM.YYYY`, sent only when they first contact the owner; the estimate otherwise. */
+export declare const registrationOf: (id: number, registrationMonth: string | undefined) => Registered | null;
+/** mtcute folds the empty status into `long_time_ago`; that is the one Telegram shows as hidden. */
+export declare const seenOf: (user: User) => Seen | undefined;
+export declare const toProfileFacts: (full: FullUser, chats: ProfileFacts["chats"]) => ProfileFacts;
+//# sourceMappingURL=profile.d.ts.map

package/dist/telegram/profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../src/telegram/profile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAA;AAuG5E,eAAO,MAAM,qBAAqB,OAAQ,MAAM,KAAG,UAAU,GAAG,IAI/D,CAAA;AAED,4GAA4G;AAC5G,eAAO,MAAM,cAAc,OAAQ,MAAM,qBAAqB,MAAM,GAAG,SAAS,KAAG,UAAU,GAAG,IAO/F,CAAA;AAED,oGAAoG;AACpG,eAAO,MAAM,MAAM,SAAU,IAAI,KAAG,IAAI,GAAG,SAiB1C,CAAA;AASD,eAAO,MAAM,cAAc,SAAU,QAAQ,SAAS,YAAY,CAAC,OAAO,CAAC,KAAG,YAmC7E,CAAA"}

package/dist/telegram/profile.js

@@ -0,0 +1,175 @@
+/**
+ * Id → month. A monotone best fit to 212 real sign-up dates (jobians/telegram-id-age, MIT, commit 86605dc,
+ * up to 2025-11), with tg-id-mcp's points (MIT, `REG_DATE_RANGES`) filling 2017–2021 where those are sparse
+ * and the 2021-12 start of 52-bit ids from the Bot API 5.5 changelog. Checked against points left out of the
+ * fit, 2022–2025 estimates are off by a median of 1–2 months and at most 4–6 for nine in ten. Ids are not
+ * promised to grow with time, so this is an estimate and is always labelled one.
+ *
+ * From 8.0e9 the same fit also takes 195 sign-up dates from the owner's own chats (2026-10-07; only these
+ * rounded bands are kept, no id), which carries the table into 2026. Checked on those dates left out of the fit:
+ * 2025 off by a median of 2 months and at most 3 for nine in ten, 2026 a median of 3 and at most 4 — the 2026
+ * rows rest on five dates, so read them as a season, not a month.
+ */
+const ID_MONTHS = [
+    [1, "2013-08"],
+    [2_000_000, "2013-11"],
+    [5_000_000, "2013-12"],
+    [10_000_000, "2014-02"],
+    [30_000_000, "2014-03"],
+    [40_000_000, "2014-05"],
+    [50_000_000, "2014-09"],
+    [60_000_000, "2014-10"],
+    [100_000_000, "2015-03"],
+    [102_000_000, "2015-05"],
+    [112_000_000, "2015-07"],
+    [124_000_000, "2015-08"],
+    [125_000_000, "2015-09"],
+    [132_000_000, "2015-10"],
+    [140_000_000, "2015-12"],
+    [145_000_000, "2016-01"],
+    [160_000_000, "2016-03"],
+    [180_000_000, "2016-04"],
+    [200_000_000, "2016-06"],
+    [250_000_000, "2016-09"],
+    [280_000_000, "2016-10"],
+    [290_000_000, "2016-11"],
+    [295_000_000, "2016-12"],
+    [300_000_000, "2017-01"],
+    [330_000_000, "2017-02"],
+    [360_000_000, "2017-03"],
+    [400_000_000, "2017-07"],
+    [500_000_000, "2018-01"],
+    [550_000_000, "2018-04"],
+    [600_000_000, "2018-06"],
+    [650_000_000, "2018-08"],
+    [700_000_000, "2018-09"],
+    [750_000_000, "2018-11"],
+    [800_000_000, "2019-01"],
+    [805_000_000, "2019-03"],
+    [900_000_000, "2019-05"],
+    [950_000_000, "2019-07"],
+    [1_000_000_000, "2019-09"],
+    [1_100_000_000, "2020-02"],
+    [1_200_000_000, "2020-06"],
+    [1_300_000_000, "2020-10"],
+    [1_400_000_000, "2021-01"],
+    [1_500_000_000, "2021-04"],
+    [1_600_000_000, "2021-06"],
+    [1_700_000_000, "2021-08"],
+    [1_800_000_000, "2021-10"],
+    [5_000_000_000, "2021-12"],
+    [5_040_000_000, "2022-01"],
+    [5_100_000_000, "2022-02"],
+    [5_150_000_000, "2022-03"],
+    [5_300_000_000, "2022-04"],
+    [5_350_000_000, "2022-05"],
+    [5_434_000_000, "2022-06"],
+    [5_440_000_000, "2022-07"],
+    [5_550_000_000, "2022-10"],
+    [5_780_000_000, "2022-11"],
+    [5_800_000_000, "2022-12"],
+    [5_865_000_000, "2023-01"],
+    [5_990_000_000, "2023-05"],
+    [6_300_000_000, "2023-07"],
+    [6_400_000_000, "2023-11"],
+    [6_530_000_000, "2023-12"],
+    [6_550_000_000, "2024-01"],
+    [7_000_000_000, "2024-04"],
+    [7_050_000_000, "2024-05"],
+    [7_243_000_000, "2024-06"],
+    [7_260_000_000, "2024-07"],
+    [7_450_000_000, "2024-08"],
+    [7_500_000_000, "2024-12"],
+    [7_800_000_000, "2025-01"],
+    [7_834_000_000, "2025-06"],
+    [7_900_000_000, "2025-07"],
+    [8_090_000_000, "2025-08"],
+    [8_200_000_000, "2025-10"],
+    [8_420_000_000, "2025-12"],
+    [8_580_000_000, "2026-01"],
+    [8_680_000_000, "2026-03"],
+    [8_760_000_000, "2026-04"],
+    [8_950_000_000, "2026-08"],
+    [8_960_000_000, "2026-08"],
+];
+/**
+ * The last point only marks where the table ends: the table cannot tell an id just above it made in
+ * 2025 from one made in 2026, so anything at or past it gets no estimate rather than a possibly wrong one.
+ */
+const TABLE_END = ID_MONTHS.at(-1)?.[0] ?? 0;
+export const estimatedRegistration = (id) => {
+    if (id < 1 || id >= TABLE_END)
+        return null;
+    const month = ID_MONTHS.findLast(([from]) => id >= from)?.[1];
+    return month ? { at: `${month}-01T00:00:00.000Z`, source: "estimate", precision: "month" } : null;
+};
+/** Telegram's own month, `MM.YYYY`, sent only when they first contact the owner; the estimate otherwise. */
+export const registrationOf = (id, registrationMonth) => {
+    const told = registrationMonth?.match(/^(\d{1,2})\.(\d{4})$/);
+    if (told) {
+        const [, month = "", year = ""] = told;
+        return { at: `${year}-${month.padStart(2, "0")}-01T00:00:00.000Z`, source: "telegram", precision: "month" };
+    }
+    return estimatedRegistration(id);
+};
+/** mtcute folds the empty status into `long_time_ago`; that is the one Telegram shows as hidden. */
+export const seenOf = (user) => {
+    switch (user.status) {
+        case "online":
+            return "online";
+        case "offline":
+            return user.lastOnline?.toISOString() ?? "hidden";
+        case "recently":
+            return "recently";
+        case "within_week":
+            return "week";
+        case "within_month":
+            return "month";
+        case "bot":
+            return undefined;
+        default:
+            return "hidden";
+    }
+};
+/**
+ * Their own photo, or the public one they show when privacy hides it — never the one the owner set
+ * for them. Read from Telegram's fields: mtcute's `realPhoto` answers that personal one (0.32.3).
+ */
+const hasOwnPhoto = ({ full }) => full._ === "userFull" && (full.profilePhoto?._ === "photo" || full.fallbackPhoto?._ === "photo");
+export const toProfileFacts = (full, chats) => {
+    const settings = full.peerSettings;
+    const birthday = full.birthday;
+    const usernames = (full.usernames ?? []).filter(({ active }) => active).map(({ username }) => username);
+    const seen = seenOf(full);
+    return {
+        id: String(full.id),
+        name: full.displayName || null,
+        usernames: usernames.length > 0 ? usernames : full.username ? [full.username] : [],
+        bio: full.bio || null,
+        birthday: birthday
+            ? [birthday.day, birthday.month, birthday.year]
+                .filter((part) => part !== undefined)
+                .map((part, index) => (index < 2 ? String(part).padStart(2, "0") : String(part)))
+                .join(".")
+            : null,
+        phone: full.phoneNumber,
+        flags: {
+            bot: full.isBot,
+            verified: full.isVerified,
+            premium: full.isPremium,
+            scam: full.isScam,
+            fake: full.isFake,
+            restricted: full.isRestricted,
+            deleted: full.isDeleted,
+            support: full.isSupport,
+        },
+        ...(seen === undefined ? {} : { seen }),
+        contact: full.isContact,
+        mutualContact: full.isMutualContact,
+        commonChatsCount: full.commonChatsCount,
+        registered: registrationOf(full.id, settings?._ === "peerSettings" ? settings.registrationMonth : undefined),
+        hasPhoto: hasOwnPhoto(full),
+        chats,
+    };
+};
+//# sourceMappingURL=profile.js.map

package/dist/telegram/profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.js","sourceRoot":"","sources":["../../src/telegram/profile.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AACH,MAAM,SAAS,GAAgC;IAC7C,CAAC,CAAC,EAAE,SAAS,CAAC;IACd,CAAC,SAAS,EAAE,SAAS,CAAC;IACtB,CAAC,SAAS,EAAE,SAAS,CAAC;IACtB,CAAC,UAAU,EAAE,SAAS,CAAC;IACvB,CAAC,UAAU,EAAE,SAAS,CAAC;IACvB,CAAC,UAAU,EAAE,SAAS,CAAC;IACvB,CAAC,UAAU,EAAE,SAAS,CAAC;IACvB,CAAC,UAAU,EAAE,SAAS,CAAC;IACvB,CAAC,WAAW,EAAE,SAAS,CAAC;IACxB,CAAC,WAAW,EAAE,SAAS,CAAC;IACxB,CAAC,WAAW,EAAE,SAAS,CAAC;IACxB,CAAC,WAAW,EAAE,SAAS,CAAC;IACxB,CAAC,WAAW,EAAE,SAAS,CAAC;IACxB,CAAC,WAAW,EAAE,SAAS,CAAC;IACxB,CAAC,WAAW,EAAE,SAAS,CAAC;IACxB,CAAC,WAAW,EAAE,SAAS,CAAC;IACxB,CAAC,WAAW,EAAE,SAAS,CAAC;IACxB,CAAC,WAAW,EAAE,SAAS,CAAC;IACxB,CAAC,WAAW,EAAE,SAAS,CAAC;IACxB,CAAC,WAAW,EAAE,SAAS,CAAC;IACxB,CAAC,WAAW,EAAE,SAAS,CAAC;IACxB,CAAC,WAAW,EAAE,SAAS,CAAC;IACxB,CAAC,WAAW,EAAE,SAAS,CAAC;IACxB,CAAC,WAAW,EAAE,SAAS,CAAC;IACxB,CAAC,WAAW,EAAE,SAAS,CAAC;IACxB,CAAC,WAAW,EAAE,SAAS,CAAC;IACxB,CAAC,WAAW,EAAE,SAAS,CAAC;IACxB,CAAC,WAAW,EAAE,SAAS,CAAC;IACxB,CAAC,WAAW,EAAE,SAAS,CAAC;IACxB,CAAC,WAAW,EAAE,SAAS,CAAC;IACxB,CAAC,WAAW,EAAE,SAAS,CAAC;IACxB,CAAC,WAAW,EAAE,SAAS,CAAC;IACxB,CAAC,WAAW,EAAE,SAAS,CAAC;IACxB,CAAC,WAAW,EAAE,SAAS,CAAC;IACxB,CAAC,WAAW,EAAE,SAAS,CAAC;IACxB,CAAC,WAAW,EAAE,SAAS,CAAC;IACxB,CAAC,WAAW,EAAE,SAAS,CAAC;IACxB,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1B,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1B,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1B,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1B,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1B,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1B,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1B,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1B,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1B,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1B,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1B,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1B,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1B,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1B,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1B,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1B,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1B,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1B,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1B,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1B,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1B,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1B,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1B,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1B,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1B,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1B,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1B,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1B,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1B,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1B,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1B,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1B,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1B,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1B,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1B,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1B,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1B,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1B,CAAC,aAAa,EAAE,SAAS,CAAC;IAC1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"}

package/dist/telegram/proxy.d.ts

@@ -0,0 +1,48 @@
+import { type proxyTransportFromUrl } from "@mtcute/node";
+import { CliError, type KeyringStore } from "@wirecat/cli-core";
+import { type Settings } from "@wirecat/cli-messaging/cli";
+import { type ProxyServer } from "../proxy.js";
+type TelegramTransport = ReturnType<typeof proxyTransportFromUrl>;
+export declare const PROXY_ENV = "TG_PROXY";
+/**
+ * A proxy's password or MTProxy secret in the OS keyring, one per profile and one for `--defaults`:
+ * a profile locked with `TG_PROFILE_LOCK` must not be able to change another profile's password.
+ * `undefined` is the defaults; the two namespaces keep a profile named "defaults" apart from them.
+ */
+export declare const proxySecrets: ({ env, keyring }: {
+    env?: NodeJS.ProcessEnv;
+    keyring?: KeyringStore;
+}) => {
+    read: (profile: string | undefined) => string | undefined;
+    write: (profile: string | undefined, secret: string) => import("@wirecat/cli-core").CredentialSource;
+    remove: (profile: string | undefined) => import("@wirecat/cli-core").CredentialSource[];
+};
+export interface ProxyInUse {
+    proxy: ProxyServer;
+    /** `TG_PROXY`, `config file` or `config defaults`. */
+    from: string;
+}
+/**
+ * `TG_PROXY` over the profile's `proxy` setting. `ALL_PROXY` and `HTTPS_PROXY` are not read: they
+ * are set for other tools, and a personal account sent through a work proxy nobody chose for it
+ * would be a surprise found late.
+ */
+export declare const resolveProxy: (settings: Pick<Settings, "profile" | "configured" | "shared">, { env, keyring }?: {
+    env?: NodeJS.ProcessEnv;
+    keyring?: KeyringStore;
+}) => ProxyInUse | undefined;
+/** Builds the transport once, so `config set` refuses an MTProxy secret the connection would refuse. */
+export declare const checkProxy: (proxy: ProxyServer) => void;
+/** Why a connection through the proxy failed, in words that never carry its password or secret. */
+export declare const proxyFailure: (proxy: ProxyServer, error: unknown) => CliError;
+/**
+ * mtcute reconnects through a dead proxy until the command's deadline, which reads as "Telegram did
+ * not answer" (measured 2026-10-04 against a closed port). The first failure before any connection
+ * worked ends the wait instead: by then the proxy, not Telegram, is the likely fault.
+ */
+export declare const proxiedTransport: (proxy: ProxyServer) => {
+    transport: TelegramTransport;
+    failed: Promise<never>;
+};
+export {};
+//# sourceMappingURL=proxy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../src/telegram/proxy.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,qBAAqB,EAG3B,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,QAAQ,EAAe,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAC5E,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AAEpE,OAAO,EAAE,KAAK,WAAW,EAAsC,MAAM,aAAa,CAAA;AAElF,KAAK,iBAAiB,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEjE,eAAO,MAAM,SAAS,aAAa,CAAA;AAEnC;;;;GAIG;AACH,eAAO,MAAM,YAAY,qBAAoC;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,OAAO,CAAC,EAAE,YAAY,CAAA;CAAE;IAW5G,IAAI,YAAY,MAAM,GAAG,SAAS;IAClC,KAAK,YAAY,MAAM,GAAG,SAAS,UAAU,MAAM;IACnD,MAAM,YAAY,MAAM,GAAG,SAAS;CAEvC,CAAA;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,WAAW,CAAA;IAClB,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;;GAIG;AACH,eAAO,MAAM,YAAY,aACb,IAAI,CAAC,QAAQ,EAAE,SAAS,GAAG,YAAY,GAAG,QAAQ,CAAC,qBAC7B;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,OAAO,CAAC,EAAE,YAAY,CAAA;CAAE,KAClF,UAAU,GAAG,SAcf,CAAA;AAsBD,wGAAwG;AACxG,eAAO,MAAM,UAAU,UAAW,WAAW,KAAG,IAE/C,CAAA;AAED,mGAAmG;AACnG,eAAO,MAAM,YAAY,UAAW,WAAW,SAAS,OAAO,KAAG,QAUjE,CAAA;AAID;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,UAAW,WAAW,KAAG;IAAE,SAAS,EAAE,iBAAiB,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAA;CAoB3G,CAAA"}

package/dist/telegram/proxy.js

@@ -0,0 +1,108 @@
+import { HttpProxyConnectionError, HttpProxyTcpTransport, MtProxyTcpTransport, SocksProxyConnectionError, SocksProxyTcpTransport, } from "@mtcute/node";
+import { CliError, Credentials } from "@wirecat/cli-core";
+import { fromFile } from "@wirecat/cli-messaging/cli";
+import { APP, isolated, pathsFor } from "../paths.js";
+import { parseProxy, proxyError, proxyLabel } from "../proxy.js";
+export const PROXY_ENV = "TG_PROXY";
+/**
+ * A proxy's password or MTProxy secret in the OS keyring, one per profile and one for `--defaults`:
+ * a profile locked with `TG_PROFILE_LOCK` must not be able to change another profile's password.
+ * `undefined` is the defaults; the two namespaces keep a profile named "defaults" apart from them.
+ */
+export const proxySecrets = ({ env = process.env, keyring }) => {
+    const store = new Credentials({
+        configDir: pathsFor(env).config,
+        service: APP,
+        isolated: isolated(env),
+        env,
+        ...(keyring ? { keyring } : {}),
+    });
+    const account = (profile) => profile === undefined ? "proxy:defaults" : `proxy:profile:${profile}`;
+    return {
+        read: (profile) => store.read(account(profile))?.secret,
+        write: (profile, secret) => store.write(account(profile), secret),
+        remove: (profile) => store.remove(account(profile)),
+    };
+};
+/**
+ * `TG_PROXY` over the profile's `proxy` setting. `ALL_PROXY` and `HTTPS_PROXY` are not read: they
+ * are set for other tools, and a personal account sent through a work proxy nobody chose for it
+ * would be a surprise found late.
+ */
+export const resolveProxy = (settings, { env = process.env, keyring } = {}) => {
+    const given = env[PROXY_ENV]?.trim();
+    if (given)
+        return { proxy: parseProxy(given, PROXY_ENV), from: PROXY_ENV };
+    const { value, from } = fromFile(settings, "proxy", undefined);
+    if (value === undefined)
+        return undefined;
+    const proxy = parseProxy(value, "the proxy setting");
+    const secrets = proxySecrets({ env, ...(keyring ? { keyring } : {}) });
+    const secret = secrets.read(settings.profile) ?? (from === "config defaults" ? secrets.read(undefined) : undefined);
+    if (proxy.kind === "mtproxy" && !secret)
+        throw new CliError("configuration_error", `no secret is stored for the MTProxy ${proxyLabel(proxy)} — run \`tg config set proxy -\` again`);
+    return { proxy: secret ? { ...proxy, secret } : proxy, from };
+};
+const transportOf = (proxy) => {
+    const auth = {
+        ...(proxy.user === undefined ? {} : { user: proxy.user }),
+        ...(proxy.secret === undefined ? {} : { password: proxy.secret }),
+    };
+    switch (proxy.kind) {
+        case "socks5":
+            return new SocksProxyTcpTransport({ version: 5, host: proxy.host, port: proxy.port, ...auth });
+        case "http":
+            return new HttpProxyTcpTransport({ host: proxy.host, port: proxy.port, tls: proxy.tls, ...auth });
+        case "mtproxy":
+            try {
+                return new MtProxyTcpTransport({ host: proxy.host, port: proxy.port, secret: proxy.secret ?? "" });
+            }
+            catch {
+                // mtcute's words would be "Telegram answered with something unexpected"; the secret is what was wrong.
+                throw new CliError("configuration_error", `the MTProxy ${proxyLabel(proxy)} has a secret tg cannot read`);
+            }
+    }
+};
+/** Builds the transport once, so `config set` refuses an MTProxy secret the connection would refuse. */
+export const checkProxy = (proxy) => {
+    transportOf(proxy);
+};
+/** Why a connection through the proxy failed, in words that never carry its password or secret. */
+export const proxyFailure = (proxy, error) => {
+    const code = error?.code;
+    return proxyError(proxy, error instanceof SocksProxyConnectionError || error instanceof HttpProxyConnectionError
+        ? `refused: ${hidden(error.message.replace(/^Error while connecting to [^:]+:\d+: /, ""), proxy)}`
+        : typeof code === "string"
+            ? `cannot be reached (${code})`
+            : "did not let tg through");
+};
+const hidden = (text, proxy) => (proxy.secret ? text.split(proxy.secret).join("[redacted]") : text);
+/**
+ * mtcute reconnects through a dead proxy until the command's deadline, which reads as "Telegram did
+ * not answer" (measured 2026-10-04 against a closed port). The first failure before any connection
+ * worked ends the wait instead: by then the proxy, not Telegram, is the likely fault.
+ */
+export const proxiedTransport = (proxy) => {
+    const transport = transportOf(proxy);
+    const connect = transport.connect.bind(transport);
+    let worked = false;
+    let fail = () => { };
+    const failed = new Promise((_, reject) => {
+        fail = reject;
+    });
+    failed.catch(() => { });
+    transport.connect = async (dc, signal) => {
+        try {
+            const connection = await connect(dc, signal);
+            worked = true;
+            return connection;
+        }
+        catch (error) {
+            if (!worked && !signal.aborted)
+                fail(proxyFailure(proxy, error));
+            throw error;
+        }
+    };
+    return { transport, failed };
+};
+//# sourceMappingURL=proxy.js.map

package/dist/telegram/proxy.js.map

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

package/dist/telegram/registration.d.ts

@@ -0,0 +1,31 @@
+import type { ApiCredentials } from "./credentials.js";
+/**
+ * Registers the owner's app on my.telegram.org and reads its `api_id` and `api_hash` — the same
+ * page a person would fill in, driven without a browser.
+ *
+ * ⚠ The site has no API; this follows its web form. The login half is read from the page's own
+ * script (2026-09-27): `send_password {phone}` answers `{random_hash}`, `login {phone, random_hash,
+ * password}` answers `true` and sets the session cookie. The app half — the `/apps` page and
+ * `/apps/create` — is behind that login and was read from two clients that drive it the same way,
+ * MadelineProto (`src/MyTelegramOrgWrapper.php`) and gogram (`telegram/auth.go`). Not measured by
+ * us until the first real run.
+ */
+export declare const MY_TELEGRAM = "https://my.telegram.org";
+export interface RegistrationPrompts {
+    phone: () => Promise<string>;
+    /** The code my.telegram.org sends as a message from Telegram — not an SMS, not the login code. */
+    code: () => Promise<string>;
+    note: (message: string) => void;
+}
+type Fetch = (url: string, init: RequestInit) => Promise<Response>;
+export declare const registerApp: (prompts: RegistrationPrompts, { fetch: request, shortName, signal, }?: {
+    fetch?: Fetch;
+    shortName?: string;
+    signal?: AbortSignal;
+}) => Promise<ApiCredentials & {
+    created: boolean;
+}>;
+/** The app's page, or `undefined` when the account has no app yet. */
+export declare const readApp: (html: string) => ApiCredentials | undefined;
+export {};
+//# sourceMappingURL=registration.d.ts.map

package/dist/telegram/registration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registration.d.ts","sourceRoot":"","sources":["../../src/telegram/registration.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEtD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,4BAA4B,CAAA;AAEpD,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;IAC5B,kGAAkG;IAClG,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;IAC3B,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CAChC;AAED,KAAK,KAAK,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;AAElE,eAAO,MAAM,WAAW,YACb,mBAAmB,2CAKzB;IAAE,KAAK,CAAC,EAAE,KAAK,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,KAC7D,OAAO,CAAC,cAAc,GAAG;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAsD/C,CAAA;AAWD,sEAAsE;AACtE,eAAO,MAAM,OAAO,SAAU,MAAM,KAAG,cAAc,GAAG,SAOvD,CAAA"}

package/dist/telegram/registration.js

@@ -0,0 +1,95 @@
+import { randomBytes } from "node:crypto";
+import { CliError, singleLine } from "@wirecat/cli-core";
+/**
+ * Registers the owner's app on my.telegram.org and reads its `api_id` and `api_hash` — the same
+ * page a person would fill in, driven without a browser.
+ *
+ * ⚠ The site has no API; this follows its web form. The login half is read from the page's own
+ * script (2026-09-27): `send_password {phone}` answers `{random_hash}`, `login {phone, random_hash,
+ * password}` answers `true` and sets the session cookie. The app half — the `/apps` page and
+ * `/apps/create` — is behind that login and was read from two clients that drive it the same way,
+ * MadelineProto (`src/MyTelegramOrgWrapper.php`) and gogram (`telegram/auth.go`). Not measured by
+ * us until the first real run.
+ */
+export const MY_TELEGRAM = "https://my.telegram.org";
+export const registerApp = async (prompts, { fetch: request = fetch, shortName = randomShortName(), signal, } = {}) => {
+    const cookies = new Map();
+    const call = async (path, form) => {
+        const response = await request(`${MY_TELEGRAM}${path}`, {
+            method: form ? "POST" : "GET",
+            headers: {
+                ...(form ? { "Content-Type": "application/x-www-form-urlencoded; charset=UTF-8" } : {}),
+                "X-Requested-With": "XMLHttpRequest",
+                Origin: MY_TELEGRAM,
+                Referer: `${MY_TELEGRAM}${path.startsWith("/apps") ? "/apps" : "/auth"}`,
+                ...(cookies.size > 0 ? { Cookie: [...cookies].map(([name, value]) => `${name}=${value}`).join("; ") } : {}),
+            },
+            ...(form ? { body: new URLSearchParams(form).toString() } : {}),
+            redirect: "manual",
+            ...(signal === undefined ? {} : { signal }),
+        });
+        for (const line of response.headers.getSetCookie()) {
+            const [pair] = line.split(";");
+            const at = pair?.indexOf("=") ?? -1;
+            if (pair && at > 0)
+                cookies.set(pair.slice(0, at).trim(), pair.slice(at + 1).trim());
+        }
+        return { status: response.status, text: await response.text() };
+    };
+    const phone = (await prompts.phone()).trim();
+    const sent = await call("/auth/send_password", { phone });
+    const randomHash = parseRandomHash(sent.text);
+    prompts.note("my.telegram.org sent a code as a message from Telegram — open the Telegram app to read it");
+    const login = await call("/auth/login", { phone, random_hash: randomHash, password: (await prompts.code()).trim() });
+    if (login.text.trim() !== "true") {
+        throw new CliError("authentication_error", `my.telegram.org refused the code: ${siteSays(login.text)}`);
+    }
+    const page = await call("/apps");
+    const existing = readApp(page.text);
+    if (existing)
+        return { ...existing, created: false };
+    const hash = creationHash(page.text);
+    const created = await call("/apps/create", {
+        hash,
+        app_title: "tg-cli",
+        app_shortname: shortName,
+        app_url: "https://github.com/WireCatLabs/tg-cli",
+        app_platform: "desktop",
+        app_desc: "A command line interface for my own account",
+    });
+    if (created.text.trim() !== "") {
+        throw new CliError("provider_error", `my.telegram.org did not create the app: ${siteSays(created.text)}`);
+    }
+    const app = readApp((await call("/apps")).text);
+    if (!app)
+        throw new CliError("invalid_response", "my.telegram.org says the app was created, but its page shows none");
+    return { ...app, created: true };
+};
+const parseRandomHash = (text) => {
+    try {
+        const hash = JSON.parse(text).random_hash;
+        if (typeof hash === "string" && hash !== "")
+            return hash;
+    }
+    catch { }
+    const said = siteSays(text);
+    throw new CliError(/too many/i.test(said) ? "rate_limited" : "provider_error", `my.telegram.org: ${said}`);
+};
+/** The app's page, or `undefined` when the account has no app yet. */
+export const readApp = (html) => {
+    const id = /<label for="app_id"[^>]*>[\s\S]*?<\/label>\s*<div[^>]*>\s*<span[^>]*><strong>(\d+)<\/strong><\/span>/.exec(html);
+    const hash = /<label for="app_hash"[^>]*>[\s\S]*?<\/label>\s*<div[^>]*>\s*<span[^>]*>([a-fA-F0-9]+)<\/span>/.exec(html);
+    return id?.[1] && hash?.[1] ? { id: Number(id[1]), hash: hash[1] } : undefined;
+};
+const creationHash = (html) => {
+    const hash = /<input type="hidden" name="hash" value="([a-fA-F0-9]+)"\s*\/?>/.exec(html)?.[1];
+    if (hash)
+        return hash;
+    const title = /<title>([^<]*)<\/title>/.exec(html)?.[1];
+    throw new CliError("invalid_response", `my.telegram.org showed a page this does not know (${singleLine(title ?? "no title")}) — create the app by hand with --app browser`);
+};
+/** App short names are letters and digits; a random tail keeps two profiles from colliding. */
+const randomShortName = () => `tgcli${[...randomBytes(6)].map((byte) => "abcdefghijklmnopqrstuvwxyz0123456789"[byte % 36]).join("")}`;
+/** The site answers errors as a short plain sentence; keep it one line and short. */
+const siteSays = (text) => singleLine(text.replace(/<[^>]+>/g, " ").trim()).slice(0, 200) || "(empty answer)";
+//# sourceMappingURL=registration.js.map

package/dist/telegram/registration.js.map

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

package/dist/telegram/send-as.d.ts

@@ -0,0 +1,17 @@
+import { type TelegramClient } from "@mtcute/node";
+import type { SenderIdentity } from "@wirecat/cli-messaging";
+type Client = Pick<TelegramClient, "getMe" | "getFullChat" | "resolvePeer" | "call">;
+/**
+ * Reads only. `messages.saveDefaultSendAs` would change the chat's saved choice for every client of
+ * the account, so the choice is made per send instead.
+ */
+export declare const sendAsIdentities: (client: Client, chatId: string) => Promise<SenderIdentity[]>;
+/**
+ * The group's saved default sender, when it is not the account: Telegram posts as it when a send names none
+ * (measured 2026-10-07: a comment went out as the linked channel). One request, a supergroup only.
+ */
+export declare const savedSenderOf: (client: Pick<TelegramClient, "getFullChat">, chatId: string, self: string | null) => Promise<string | null>;
+/** Telegram takes `send_as` in channels and supergroups only; elsewhere the account is the one author. */
+export declare const sendAsPeer: (chatId: string, sendAs: string, self: string | null) => number | undefined;
+export {};
+//# sourceMappingURL=send-as.d.ts.map

package/dist/telegram/send-as.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-as.d.ts","sourceRoot":"","sources":["../../src/telegram/send-as.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiD,KAAK,cAAc,EAAM,MAAM,cAAc,CAAA;AAErG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAE5D,KAAK,MAAM,GAAG,IAAI,CAAC,cAAc,EAAE,OAAO,GAAG,aAAa,GAAG,aAAa,GAAG,MAAM,CAAC,CAAA;AAEpF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,WAAkB,MAAM,UAAU,MAAM,KAAG,OAAO,CAAC,cAAc,EAAE,CA8B/F,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,WAChB,IAAI,CAAC,cAAc,EAAE,aAAa,CAAC,UACnC,MAAM,QACR,MAAM,GAAG,IAAI,KAClB,OAAO,CAAC,MAAM,GAAG,IAAI,CAMvB,CAAA;AAED,0GAA0G;AAC1G,eAAO,MAAM,UAAU,WAAY,MAAM,UAAU,MAAM,QAAQ,MAAM,GAAG,IAAI,KAAG,MAAM,GAAG,SAOzF,CAAA"}