@imessaging/telegram-mtproto 0.7.3 → 0.8.0

package/package.json

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

package/src/entities.ts

@@ -0,0 +1,27 @@
+import { Api } from "telegram";
+import type { FormattedText } from "@imessaging/core";
+
+/**
+ * Выделения FormattedText → сущности MTProto. Смещения у обоих в UTF-16, переводить их не нужно.
+ */
+export function toTelegramEntities(ft: FormattedText): Api.TypeMessageEntity[] {
+  return ft.entities.map((e) => {
+    const base = { offset: e.offset, length: e.length };
+    switch (e.type) {
+      case "bold":
+        return new Api.MessageEntityBold(base);
+      case "italic":
+        return new Api.MessageEntityItalic(base);
+      case "underline":
+        return new Api.MessageEntityUnderline(base);
+      case "strike":
+        return new Api.MessageEntityStrike(base);
+      case "code":
+        return new Api.MessageEntityCode(base);
+      case "pre":
+        return new Api.MessageEntityPre({ ...base, language: e.language ?? "" });
+      case "link":
+        return new Api.MessageEntityTextUrl({ ...base, url: e.url ?? "" });
+    }
+  });
+}

package/src/incoming.ts

@@ -14,9 +14,10 @@ export type MtprotoMessageLike = {
   message?: string;
   /** `true` — сообщение отправлено САМОЙ учётной записью. */
   out?: boolean;
-  date?: number;
-  editDate?: number;
-  groupedId?: { toString(): string };
+  // gramjs отдаёт отсутствующее поле как `null`, а не `undefined`: проверки ниже — на оба.
+  date?: number | null;
+  editDate?: number | null;
+  groupedId?: { toString(): string } | null;
   peerId?: MtprotoPeerLike;
   fromId?: MtprotoPeerLike;
   media?: MtprotoMediaLike;
@@ -31,7 +32,7 @@ export type MtprotoMessageLike = {
   replyMarkup?: { rows?: { buttons?: MtprotoButtonLike[] }[] };
   replyTo?: {
     replyToMsgId?: number | string;
-    replyToTopId?: number | string;
+    replyToTopId?: number | string | null;
     forumTopic?: boolean;
   };
   /** Заголовок форварда. Пусто — сообщение своё, не пересланное. */
@@ -53,6 +54,13 @@ export type MtprotoMessageLike = {
     title?: string;
     accessHash?: { toString(): string } | string | number;
   };
+  /** Сущность САМОГО чата из обновления: канал, группа или собеседник. Может не прийти. */
+  chat?: {
+    username?: string;
+    firstName?: string;
+    lastName?: string;
+    title?: string;
+  };
   /**
    * Пир отправителя ВМЕСТЕ с `accessHash` — так его отдаёт само обновление.
    *
@@ -251,12 +259,18 @@ export function toIncomingMessage(
     else if (message.sender.title) senderName = message.sender.title;
   }
 
+  const chatName = [message.chat?.firstName, message.chat?.lastName]
+    .filter(Boolean)
+    .join(" ")
+    .trim();
+  const chatTitle = message.chat?.title || chatName || undefined;
+
   let threadId: number | undefined;
   let replyToMessageId: string | undefined;
   if (message.replyTo?.forumTopic === true) {
     threadId = Number(message.replyTo.replyToTopId ?? message.replyTo.replyToMsgId);
     replyToMessageId =
-      message.replyTo.replyToTopId === undefined ? undefined : String(message.replyTo.replyToMsgId);
+      message.replyTo.replyToTopId == null ? undefined : String(message.replyTo.replyToMsgId);
   } else {
     replyToMessageId =
       message.replyTo?.replyToMsgId === undefined
@@ -274,11 +288,14 @@ export function toIncomingMessage(
     // связывают человека со своей учётной записью.
     senderUsername: message.sender?.username,
     senderName,
+    chatTitle,
+    chatUsername: message.chat?.username ?? undefined,
     messageId: String(message.id),
     albumId: message.groupedId?.toString(),
     text: message.message ?? "",
-    sentAt: message.date !== undefined ? new Date(message.date * 1000) : undefined,
-    editedAt: message.editDate !== undefined ? new Date(message.editDate * 1000) : undefined,
+    sentAt: message.date ? new Date(message.date * 1000) : undefined,
+    // Непоправленное сообщение приходит с `editDate: null` — это не правка в 1970 году.
+    editedAt: message.editDate ? new Date(message.editDate * 1000) : undefined,
     attachments: collectAttachments(message, chatId),
     links: collectLinks(message),
     replyToMessageId,

package/src/telegram-mtproto-transport.ts

@@ -17,7 +17,8 @@ import type {
   TransportStatus,
   TypingTransport,
 } from "@imessaging/core";
-import { isTelegramRecipient, MemoryPeerStore } from "@imessaging/core";
+import { isTelegramRecipient, MemoryPeerStore, formattedOf } from "@imessaging/core";
+import { toTelegramEntities } from "./entities";
 import { peerToChat, unmarkPeerId } from "./incoming";
 import bigInt from "big-integer";
 import { Api, TelegramClient } from "telegram";
@@ -442,9 +443,15 @@ export class TelegramMtprotoTransport
   private async sendWithRetry(message: OutboundMessage, retried: boolean): Promise<SendResult> {
     try {
       const peer = await this.getInputPeer(message.recipient);
+      // С `format` уходят готовые выделения: gramjs тогда не разбирает текст своим markdown вовсе.
+      const ft = formattedOf(message);
+      const text = ft ? ft.text : message.text;
+      const parseMode = ft ? undefined : message.parseMode?.toLowerCase();
+      const formattingEntities = ft ? toTelegramEntities(ft) : undefined;
       const sent = await this.client.sendMessage(peer, {
-        message: message.text,
-        parseMode: message.parseMode?.toLowerCase(),
+        message: text,
+        parseMode,
+        formattingEntities,
         replyTo: message.replyToMessageId ?? message.threadId,
       });
       for (const document of message.documents ?? []) {
@@ -604,12 +611,17 @@ export class TelegramMtprotoTransport
     let peer: Api.TypeInputPeer | null = null;
     try {
       peer = await this.getInputPeer(message.recipient);
+      const ft = formattedOf(message);
+      const text = ft ? ft.text : message.text;
+      const parseMode = ft ? undefined : message.parseMode?.toLowerCase();
+      const formattingEntities = ft ? toTelegramEntities(ft) : undefined;
       // Кнопки здесь не передаются — ровно как и при отправке этим транспортом: inline-клавиатуру
       // MTProto-аккаунт не рисует. Передать их сюда значило бы обещать разметку, которой не будет.
       await this.client.editMessage(peer, {
         message: messageId,
-        text: message.text,
-        parseMode: message.parseMode?.toLowerCase(),
+        text,
+        parseMode,
+        formattingEntities,
       });
       this.lastActivityAt = new Date();
       return {