@imessaging/telegram-mtproto 0.8.6 → 0.8.8

package/package.json

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

package/src/incoming.ts

@@ -337,6 +337,7 @@ export function toIncomingMessage(
     attachments: collectAttachments(message, chatId),
     links: collectLinks(message),
     mentionsMe: typeof message.mentioned === "boolean" ? message.mentioned : undefined,
+    outgoing: typeof message.out === "boolean" ? message.out : undefined,
     replyToMessageId,
     threadId,
     forwardedFrom: toForwardedFrom(message.fwdFrom),

package/src/telegram-mtproto-transport.ts

@@ -1,4 +1,6 @@
 import type {
+  ContactCard,
+  ContactTransport,
   PhoneLookupOptions,
   PhoneLookupTransport,
   PhoneMatch,
@@ -110,6 +112,7 @@ function inputPeerChatId(peer: Api.TypeInputPeer): string {
 
 export class TelegramMtprotoTransport
   implements
+    ContactTransport,
     DraftTransport,
     EditableMessageTransport,
     EditedMessageTransport,
@@ -285,6 +288,43 @@ export class TelegramMtprotoTransport
     }
   }
 
+  /**
+   * Контакт в адресной книге: имя и заметка (contacts.addContact.note — поле слоя Telegram, не фамилия).
+   * Свой номер человеку не открываем: addPhonePrivacyException не ставится. Пир — только из хранилища:
+   * без него запрос ушёл бы искать человека по сети, а это дело findByPhone и переписки.
+   */
+  async saveContact(contact: ContactCard): Promise<void> {
+    this.assertConnected();
+    if (!/^\d+$/.test(contact.userId))
+      throw new Error(`Telegram user id must be numeric: ${contact.userId}`);
+    if (!contact.firstName.trim()) throw new Error("Contact firstName must not be empty");
+    const stored = await this.peerStore.get(this.options.accountId, {
+      type: "user",
+      id: contact.userId,
+    });
+    if (!stored?.accessHash) {
+      throw new Error(
+        `Telegram user ${contact.userId} is unknown to this account: find it with findByPhone or receive a message first`,
+      );
+    }
+    const phone = contact.phone?.replace(/[\s()-]/g, "") ?? "";
+    await this.client.invoke(
+      new Api.contacts.AddContact({
+        id: new Api.InputUser({
+          userId: bigInt(contact.userId),
+          accessHash: bigInt(stored.accessHash),
+        }),
+        firstName: contact.firstName.trim(),
+        lastName: contact.lastName?.trim() ?? "",
+        phone,
+        ...(contact.note
+          ? { note: new Api.TextWithEntities({ text: contact.note, entities: [] }) }
+          : {}),
+      }),
+    );
+    this.lastActivityAt = new Date();
+  }
+
   private async rememberPhoneMatch(user: Api.User): Promise<PhoneMatch> {
     const userId = user.id.toString();
     if (user.accessHash) {