@imessaging/telegram-mtproto 0.6.4 → 0.6.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imessaging/telegram-mtproto",
-  "version": "0.6.4",
+  "version": "0.6.6",
   "description": "Telegram MTProto user-account transport for imessaging",
   "keywords": [
     "messaging",

package/src/telegram-mtproto-transport.ts

@@ -86,6 +86,8 @@ export class TelegramMtprotoTransport
   private lastActivityAt?: Date;
   private readonly incoming = new IncomingDispatcher();
   private incomingListener: ((event: unknown) => void) | null = null;
+  /** Отметка жизни подписки: срабатывает на любом обновлении, включая служебные. */
+  private activityListener: ((event: unknown) => void) | null = null;
 
   constructor(private readonly options: TelegramMtprotoTransportOptions) {
     if (!options.accountId.trim()) throw new Error("accountId must not be empty");
@@ -182,6 +184,17 @@ export class TelegramMtprotoTransport
     };
     this.incomingListener = listener;
     this.client.addEventHandler(listener, new NewMessage({}));
+
+    // ОТМЕТКА ЖИЗНИ ПОДПИСКИ — на ЛЮБОМ обновлении, а не только на сообщении.
+    //
+    // Канал заказчика молчит и сутки — это его обычный ритм, а не поломка. Сторож, который смотрит
+    // на сообщения, в таком затишье перезапускает процесс зря, а каждый перезапуск — новая
+    // авторизация сессии, за частоту которых Telegram наказывает. Служебные события идут и в
+    // тишине, поэтому именно они отличают мёртвую подписку от спокойного канала.
+    this.activityListener = (): void => {
+      this.lastActivityAt = new Date();
+    };
+    this.client.addEventHandler(this.activityListener);
   }
 
   /**
@@ -218,10 +231,50 @@ export class TelegramMtprotoTransport
     }
   }
 
+  /**
+   * ДОГРУЗКА ПРОПУЩЕННОГО. Возвращает число сообщений, отданных подписчикам.
+   *
+   * Живая подписка теряет часть сообщений — чаще всего в супергруппах с темами: обновление
+   * приходит по каналу, которого клиент не помнит, и молча отбрасывается. Замер 07.09.2026:
+   * сообщение в теме форума видно по ссылке, а в подписке его нет ни у одного потребителя.
+   * Продукт italent живёт с этим давно и добирает последние сообщения опросом — здесь то же
+   * самое, только на уровне транспорта, чтобы каждому приложению не изобретать своё.
+   *
+   * Повторы неизбежны и это нормально: потребитель обязан отсеивать по идентификатору сообщения,
+   * а не полагаться на то, что канал не повторится. Он и так повторяется в обычной жизни.
+   */
+  async catchUp(options: { limit?: number; dialogs?: number } = {}): Promise<number> {
+    const limit = options.limit ?? 20;
+    const dialogs = await this.client.getDialogs({ limit: options.dialogs ?? 200 });
+    let dispatched = 0;
+    for (const dialog of dialogs) {
+      if (!dialog.isGroup && !dialog.isChannel) continue;
+      const entity = dialog.entity;
+      if (!entity) continue;
+      const messages = await this.client.getMessages(entity, { limit }).catch(() => []);
+      // От старых к новым: порядок обработки должен совпадать с тем, в каком они пришли бы живьём.
+      for (const message of [...messages].reverse()) {
+        const delivered = await this.incoming.dispatch(
+          message as unknown as MtprotoMessageLike,
+          this.id,
+          this.options.accountId,
+        );
+        if (delivered) dispatched += 1;
+      }
+    }
+    this.lastActivityAt = new Date();
+    return dispatched;
+  }
+
   private stopListeningIfIdle(): void {
     if (this.incoming.size > 0 || this.incomingListener === null) return;
     this.client.removeEventHandler(this.incomingListener, new NewMessage({}));
     this.incomingListener = null;
+    if (this.activityListener) {
+      // Снимается тем же способом, что и ставилась: без построителя событий.
+      this.client.removeEventHandler(this.activityListener, undefined as never);
+      this.activityListener = null;
+    }
   }
 
   /**