@imessaging/telegram-mtproto 0.8.5 → 0.8.7

package/package.json

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

package/src/telegram-mtproto-transport.ts

@@ -1,4 +1,7 @@
 import type {
+  ContactCard,
+  ContactTransport,
+  PhoneLookupOptions,
   PhoneLookupTransport,
   PhoneMatch,
   DraftTransport,
@@ -109,6 +112,7 @@ function inputPeerChatId(peer: Api.TypeInputPeer): string {
 
 export class TelegramMtprotoTransport
   implements
+    ContactTransport,
     DraftTransport,
     EditableMessageTransport,
     EditedMessageTransport,
@@ -228,10 +232,10 @@ export class TelegramMtprotoTransport
 
   /**
    * Учётка по номеру телефона: сначала contacts.ResolvePhone (номер, открытый настройками приватности),
-   * затем contacts.ImportContacts (номер виден только контакту). Контакт, заведённый ради поиска, сразу
-   * удаляется — адресная книга не растёт; бывший контактом до поиска остаётся на месте.
+   * затем contacts.ImportContacts (номер виден только контакту) — он и заводит контакт. С `keepContact: false`
+   * заведённый контакт удаляется сразу; бывший контактом до поиска не удаляется никогда.
    */
-  async findByPhone(phone: string): Promise<PhoneMatch | null> {
+  async findByPhone(phone: string, options: PhoneLookupOptions = {}): Promise<PhoneMatch | null> {
     this.assertConnected();
     const digits = phone.replace(/[\s()-]/g, "").replace(/^\+/, "");
     if (!/^\d{7,15}$/.test(digits))
@@ -263,8 +267,8 @@ export class TelegramMtprotoTransport
           new Api.InputPhoneContact({
             clientId: bigInt(Date.now()),
             phone: `+${digits}`,
-            firstName: `+${digits}`,
-            lastName: "",
+            firstName: options.firstName?.trim() || `+${digits}`,
+            lastName: options.lastName?.trim() ?? "",
           }),
         ],
       }),
@@ -274,7 +278,7 @@ export class TelegramMtprotoTransport
     try {
       return await this.rememberPhoneMatch(user);
     } finally {
-      if (!known.has(user.id.toString()) && user.accessHash) {
+      if (options.keepContact === false && !known.has(user.id.toString()) && user.accessHash) {
         await this.client.invoke(
           new Api.contacts.DeleteContacts({
             id: [new Api.InputUser({ userId: user.id, accessHash: user.accessHash })],
@@ -284,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) {