@imessaging/telegram-mtproto 0.6.7 → 0.7.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imessaging/telegram-mtproto",
-  "version": "0.6.7",
+  "version": "0.7.1",
   "description": "Telegram MTProto user-account transport for imessaging",
   "keywords": [
     "messaging",
@@ -31,7 +31,7 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@imessaging/core": "0.6.0",
+    "@imessaging/core": "^0.7.1",
     "big-integer": "^1.6.52"
   },
   "peerDependencies": {

package/src/incoming.ts

@@ -18,6 +18,12 @@ export type MtprotoMessageLike = {
   fromId?: MtprotoPeerLike;
   media?: MtprotoMediaLike;
   replyTo?: { replyToMsgId?: number | string };
+  /** Заголовок форварда. Пусто — сообщение своё, не пересланное. */
+  fwdFrom?: {
+    fromId?: MtprotoPeerLike;
+    fromName?: string;
+    channelPost?: number;
+  };
   /**
    * Отправитель целиком — его приносит обновление вместе с `accessHash`.
    *
@@ -31,7 +37,9 @@ export type MtprotoMessageLike = {
    * Без него ответить по одному номеру нельзя: клиент знает только тех, кого уже разрешал, а
    * `accessHash` из обновления больше нигде не хранится.
    */
-  getInputSender?: () => Promise<{ userId?: { toString(): string }; accessHash?: { toString(): string } } | undefined>;
+  getInputSender?: () => Promise<
+    { userId?: { toString(): string }; accessHash?: { toString(): string } } | undefined
+  >;
   /** Отправитель целиком. Обращение к сущностям обновления, а не поход в сеть. */
   getSender?: () => Promise<{ username?: string } | undefined>;
 };
@@ -64,7 +72,8 @@ export function peerToChat(peer: MtprotoPeerLike | undefined): {
 } {
   if (peer?.channelId !== undefined)
     return { chatId: `-100${peer.channelId.toString()}`, chatType: "channel" };
-  if (peer?.chatId !== undefined) return { chatId: `-${peer.chatId.toString()}`, chatType: "group" };
+  if (peer?.chatId !== undefined)
+    return { chatId: `-${peer.chatId.toString()}`, chatType: "group" };
   if (peer?.userId !== undefined) return { chatId: peer.userId.toString(), chatType: "user" };
   throw new Error("MTProto peer without userId, chatId or channelId");
 }
@@ -81,6 +90,25 @@ export function unmarkPeerId(chatId: string): string {
   return chatId;
 }
 
+/**
+ * Источник форварда → общий вид.
+ *
+ * Пир источника МОЖЕТ отсутствовать: автор форварда вправе скрыть его. Тогда остаётся имя, а
+ * иногда и оно пустое — и это честнее выдумывания, чем подстановка чата, в котором сообщение лежит.
+ */
+function toForwardedFrom(
+  fwdFrom: MtprotoMessageLike["fwdFrom"],
+): IncomingMessage["forwardedFrom"] {
+  if (!fwdFrom) return undefined;
+  const peer = fwdFrom.fromId ? peerToChat(fwdFrom.fromId) : null;
+  return {
+    chatId: peer?.chatId,
+    chatType: peer?.chatType,
+    title: fwdFrom.fromName,
+    messageId: fwdFrom.channelPost === undefined ? undefined : String(fwdFrom.channelPost),
+  };
+}
+
 /**
  * Что приехало файлом.
  *
@@ -154,6 +182,7 @@ export function toIncomingMessage(
       message.replyTo?.replyToMsgId === undefined
         ? undefined
         : String(message.replyTo.replyToMsgId),
+    forwardedFrom: toForwardedFrom(message.fwdFrom),
   };
 }
 

package/src/telegram-mtproto-transport.ts

@@ -243,7 +243,9 @@ export class TelegramMtprotoTransport
    * Повторы неизбежны и это нормально: потребитель обязан отсеивать по идентификатору сообщения,
    * а не полагаться на то, что канал не повторится. Он и так повторяется в обычной жизни.
    */
-  async catchUp(options: { limit?: number; dialogs?: number; sinceMs?: number } = {}): Promise<number> {
+  async catchUp(
+    options: { limit?: number; dialogs?: number; sinceMs?: number } = {},
+  ): Promise<number> {
     const limit = options.limit ?? 20;
     // ГРАНИЦА ПО ВРЕМЕНИ ОБЯЗАТЕЛЬНА ПО СМЫСЛУ: без неё первый же опрос поднимает всю доступную
     // историю каждого диалога и отдаёт её потребителю как новьё. Замер 07.09.2026 — сотни старых
@@ -402,7 +404,7 @@ export class TelegramMtprotoTransport
    * «мы этому человеку ещё не писали и он нам тоже», а не поломку.
    */
   private async knownInputPeer(recipient: MessageRecipient): Promise<Api.TypeInputPeer | null> {
-    if (recipient.type === "email" || recipient.type === "username") return null;
+    if (!isTelegramRecipient(recipient) || recipient.type === "username") return null;
     // Обычной группе ни клиент, ни хранилище не нужны: `InputPeerChat` строится из одного номера.
     if (recipient.type === "group") {
       return new Api.InputPeerChat({ chatId: bigInt(unmarkPeerId(recipient.id)) });
@@ -418,7 +420,10 @@ export class TelegramMtprotoTransport
     // Почтовый получатель сюда доходить не должен: разрешать адрес как @username бессмысленно, а
     // сообщение об отказе тогда врало бы про Telegram.
     if (!isTelegramRecipient(recipient)) {
-      throw new Error("Telegram MTProto cannot send email");
+      if (recipient.type === "email") {
+        throw new Error("Telegram MTProto cannot send email");
+      }
+      throw new Error(`Telegram MTProto cannot address ${recipient.type}`);
     }
     if (recipient.type !== "username" && !recipient.username) {
       throw new Error(