@mtcute/core 0.30.0 → 0.30.1

package/highlevel/types/messages/{rich-message.cjs → rich/rich-message.cjs}

@@ -5,11 +5,11 @@ if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WAR
 }
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const longUtils = require("../../../utils/long-utils.cjs");
-const inspectable = require("../../utils/inspectable.cjs");
-const memoize = require("../../utils/memoize.cjs");
-const documentUtils = require("../media/document-utils.cjs");
-const photo = require("../media/photo.cjs");
+const longUtils = require("../../../../utils/long-utils.cjs");
+const inspectable = require("../../../utils/inspectable.cjs");
+const memoize = require("../../../utils/memoize.cjs");
+const documentUtils = require("../../media/document-utils.cjs");
+const photo = require("../../media/photo.cjs");
 class RichMessage {
   constructor(raw) {
     this.raw = raw;
@@ -31,7 +31,7 @@ class RichMessage {
     }
     return map;
   }
-  /** Documents (usually videos) in this message */
+  /** Documents (usually videos and audios) in this message */
   get documents() {
     const map = new longUtils.LongMap();
     for (const photo2 of this.raw.documents) {

package/highlevel/types/messages/{rich-message.d.cts → rich/rich-message.d.cts}

@@ -1,7 +1,7 @@
-import { tl } from '../../../tl/index.js';
-import { ParsedDocument } from '../media/document-utils.js';
-import { LongMap } from '../../../utils/long-utils.js';
-import { Photo } from '../media/photo.js';
+import { tl } from '../../../../tl/index.js';
+import { ParsedDocument } from '../../media/document-utils.js';
+import { LongMap } from '../../../../utils/long-utils.js';
+import { Photo } from '../../media/photo.js';
 export declare class RichMessage {
     readonly raw: tl.TypeRichMessage;
     constructor(raw: tl.TypeRichMessage);
@@ -11,7 +11,7 @@ export declare class RichMessage {
     get isPart(): boolean;
     /** Photos in this message */
     get photos(): LongMap<Photo>;
-    /** Documents (usually videos) in this message */
+    /** Documents (usually videos and audios) in this message */
     get documents(): LongMap<ParsedDocument>;
     /** Blocks in this message */
     get blocks(): tl.TypePageBlock[];

package/highlevel/types/messages/{rich-message.d.ts → rich/rich-message.d.ts}

@@ -1,7 +1,7 @@
-import { tl } from '../../../tl/index.js';
-import { ParsedDocument } from '../media/document-utils.js';
-import { LongMap } from '../../../utils/long-utils.js';
-import { Photo } from '../media/photo.js';
+import { tl } from '../../../../tl/index.js';
+import { ParsedDocument } from '../../media/document-utils.js';
+import { LongMap } from '../../../../utils/long-utils.js';
+import { Photo } from '../../media/photo.js';
 export declare class RichMessage {
     readonly raw: tl.TypeRichMessage;
     constructor(raw: tl.TypeRichMessage);
@@ -11,7 +11,7 @@ export declare class RichMessage {
     get isPart(): boolean;
     /** Photos in this message */
     get photos(): LongMap<Photo>;
-    /** Documents (usually videos) in this message */
+    /** Documents (usually videos and audios) in this message */
     get documents(): LongMap<ParsedDocument>;
     /** Blocks in this message */
     get blocks(): tl.TypePageBlock[];

package/highlevel/types/messages/{rich-message.js → rich/rich-message.js}

@@ -1,8 +1,8 @@
-import { LongMap } from "../../../utils/long-utils.js";
-import { makeInspectable } from "../../utils/inspectable.js";
-import { memoizeGetters } from "../../utils/memoize.js";
-import { parseDocument } from "../media/document-utils.js";
-import { Photo as Photo$2 } from "../media/photo.js";
+import { LongMap } from "../../../../utils/long-utils.js";
+import { makeInspectable } from "../../../utils/inspectable.js";
+import { memoizeGetters } from "../../../utils/memoize.js";
+import { parseDocument } from "../../media/document-utils.js";
+import { Photo as Photo$2 } from "../../media/photo.js";
 class RichMessage {
   constructor(raw) {
     this.raw = raw;
@@ -24,7 +24,7 @@ class RichMessage {
     }
     return map;
   }
-  /** Documents (usually videos) in this message */
+  /** Documents (usually videos and audios) in this message */
   get documents() {
     const map = new LongMap();
     for (const photo of this.raw.documents) {

package/highlevel/types/messages/rich/types.d.cts

@@ -0,0 +1,76 @@
+import { tl } from '../../../../tl/index.js';
+import { ReplaceDeep } from '../../../../types/utils.js';
+import { InputMediaAudio, InputMediaPhoto, InputMediaVideo } from '../../media/index.js';
+/**
+ * Input rich message media, can be one of:
+ * - Bot API-compatible file ID
+ * - {@link InputMediaPhoto} (e.g. `InputMedia.photo(...)`)
+ * - {@link InputMediaVideo} (e.g. `InputMedia.video(...)`)
+ * - {@link InputMediaAudio} (e.g. `InputMedia.audio(...)`)
+ * - a raw TL object
+ */
+export type InputRichMessageMedia = string | tl.TypeInputPhoto | tl.TypeInputDocument | InputMediaPhoto | InputMediaVideo | InputMediaAudio;
+/** In-memory cache mapping an {@link InputRichMessageMedia} to its uploaded media, used by streaming drafts */
+export type RichMediaUploadCache = Map<unknown, tl.RawInputMediaPhoto | tl.RawInputMediaDocument>;
+interface InputRichMessageBase {
+    /** Whether this message should be rendered RTL */
+    rtl?: boolean;
+    /**
+     * Whether to skip automatic entities detection (e.g., URLs, email addresses,
+     *  username mentions, hashtags, cashtags, bot commands, or phone numbers)
+     */
+    skipEntityDetection?: boolean;
+}
+/**
+ * Input rich message that is parsed by the server in the specified format
+ */
+export interface InputServerParsedRichMessage extends InputRichMessageBase {
+    type: 'html' | 'markdown';
+    /**
+     * HTML or Markdown content
+     *
+     * Format reference is available in the Bot API:
+     * - [Markdown](https://core.telegram.org/bots/api#rich-markdown-style),
+     * - [HTML](https://core.telegram.org/bots/api#rich-html-style)
+     *
+     * In addition to the above, you can use the following links to reference non-HTTP/s media:
+     * - photos: `tg://photo?id=XXX`
+     * - videos/gifs: `tg://video?id=XXX`
+     * - audio: `tg://audio?id=XXX`
+     *
+     * where XXX is a unique identifier of the media in the {@link attachments} map.
+     */
+    content: string;
+    /**
+     * Attachments to the rich message.
+     */
+    attachments?: Record<string, InputRichMessageMedia>;
+}
+/**
+ * A convenience wrapper for the raw page blocks containing a file
+ * (photo, video, document, etc.)
+ *
+ * You can simply pass `Long.ZERO` as the ID inside the block, and pass the
+ * actual file in the `file` property, and mtcute will take care of the rest.
+ */
+export interface InputPageBlockWithFile {
+    block: InputPageBlock;
+    file: InputRichMessageMedia;
+}
+export type InputPageBlock = ReplaceDeep<tl.TypePageBlock, tl.TypePageBlock, InputPageBlockWithFile>;
+/**
+ * A page block as accepted in a *nested* position (inside another block's
+ * children, list items, etc.) — either a raw {@link tl.TypePageBlock} or
+ * an {@link InputPageBlockWithFile} wrapper.
+ */
+export type InputPageBlockOrFile = tl.TypePageBlock | InputPageBlockWithFile;
+/** Input rich message that is built block-by-block */
+export interface InputBlocksRichMessage extends InputRichMessageBase {
+    type: 'blocks';
+    /**
+     * Blocks of the rich message
+     */
+    blocks: (InputPageBlock | InputPageBlockWithFile)[];
+}
+export type InputRichMessage = tl.TypeInputRichMessage | InputBlocksRichMessage | InputServerParsedRichMessage;
+export {};

package/highlevel/types/messages/rich/types.d.ts

@@ -0,0 +1,76 @@
+import { tl } from '../../../../tl/index.js';
+import { ReplaceDeep } from '../../../../types/utils.js';
+import { InputMediaAudio, InputMediaPhoto, InputMediaVideo } from '../../media/index.js';
+/**
+ * Input rich message media, can be one of:
+ * - Bot API-compatible file ID
+ * - {@link InputMediaPhoto} (e.g. `InputMedia.photo(...)`)
+ * - {@link InputMediaVideo} (e.g. `InputMedia.video(...)`)
+ * - {@link InputMediaAudio} (e.g. `InputMedia.audio(...)`)
+ * - a raw TL object
+ */
+export type InputRichMessageMedia = string | tl.TypeInputPhoto | tl.TypeInputDocument | InputMediaPhoto | InputMediaVideo | InputMediaAudio;
+/** In-memory cache mapping an {@link InputRichMessageMedia} to its uploaded media, used by streaming drafts */
+export type RichMediaUploadCache = Map<unknown, tl.RawInputMediaPhoto | tl.RawInputMediaDocument>;
+interface InputRichMessageBase {
+    /** Whether this message should be rendered RTL */
+    rtl?: boolean;
+    /**
+     * Whether to skip automatic entities detection (e.g., URLs, email addresses,
+     *  username mentions, hashtags, cashtags, bot commands, or phone numbers)
+     */
+    skipEntityDetection?: boolean;
+}
+/**
+ * Input rich message that is parsed by the server in the specified format
+ */
+export interface InputServerParsedRichMessage extends InputRichMessageBase {
+    type: 'html' | 'markdown';
+    /**
+     * HTML or Markdown content
+     *
+     * Format reference is available in the Bot API:
+     * - [Markdown](https://core.telegram.org/bots/api#rich-markdown-style),
+     * - [HTML](https://core.telegram.org/bots/api#rich-html-style)
+     *
+     * In addition to the above, you can use the following links to reference non-HTTP/s media:
+     * - photos: `tg://photo?id=XXX`
+     * - videos/gifs: `tg://video?id=XXX`
+     * - audio: `tg://audio?id=XXX`
+     *
+     * where XXX is a unique identifier of the media in the {@link attachments} map.
+     */
+    content: string;
+    /**
+     * Attachments to the rich message.
+     */
+    attachments?: Record<string, InputRichMessageMedia>;
+}
+/**
+ * A convenience wrapper for the raw page blocks containing a file
+ * (photo, video, document, etc.)
+ *
+ * You can simply pass `Long.ZERO` as the ID inside the block, and pass the
+ * actual file in the `file` property, and mtcute will take care of the rest.
+ */
+export interface InputPageBlockWithFile {
+    block: InputPageBlock;
+    file: InputRichMessageMedia;
+}
+export type InputPageBlock = ReplaceDeep<tl.TypePageBlock, tl.TypePageBlock, InputPageBlockWithFile>;
+/**
+ * A page block as accepted in a *nested* position (inside another block's
+ * children, list items, etc.) — either a raw {@link tl.TypePageBlock} or
+ * an {@link InputPageBlockWithFile} wrapper.
+ */
+export type InputPageBlockOrFile = tl.TypePageBlock | InputPageBlockWithFile;
+/** Input rich message that is built block-by-block */
+export interface InputBlocksRichMessage extends InputRichMessageBase {
+    type: 'blocks';
+    /**
+     * Blocks of the rich message
+     */
+    blocks: (InputPageBlock | InputPageBlockWithFile)[];
+}
+export type InputRichMessage = tl.TypeInputRichMessage | InputBlocksRichMessage | InputServerParsedRichMessage;
+export {};

package/highlevel/updates/manager.cjs

@@ -1558,6 +1558,7 @@ class UpdatesManager {
                 localPts,
                 pending.ptsBefore
               );
+              postponedTimer.emitBefore(pending.timeout);
             } else {
               log.debug(
                 "gap for postponed %s (cid = %d) wasn't filled, fetching diff (current pts %d, need %d)",
@@ -1635,6 +1636,8 @@ class UpdatesManager {
               this.qts,
               pending.qtsBefore
             );
+            pendingQtsUpdatesPostponed.removeIndex(i);
+            i--;
             continue;
           }
           if (this.qts < pending.qtsBefore) {
@@ -1647,6 +1650,7 @@ class UpdatesManager {
                 this.qts,
                 pending.qtsBefore
               );
+              postponedTimer.emitBefore(pending.timeout);
             } else {
               log.debug(
                 "gap for postponed %s wasn't filled, fetching diff (current qts %d, need %d)",

package/highlevel/updates/manager.js

@@ -1551,6 +1551,7 @@ class UpdatesManager {
                 localPts,
                 pending.ptsBefore
               );
+              postponedTimer.emitBefore(pending.timeout);
             } else {
               log.debug(
                 "gap for postponed %s (cid = %d) wasn't filled, fetching diff (current pts %d, need %d)",
@@ -1628,6 +1629,8 @@ class UpdatesManager {
               this.qts,
               pending.qtsBefore
             );
+            pendingQtsUpdatesPostponed.removeIndex(i);
+            i--;
             continue;
           }
           if (this.qts < pending.qtsBefore) {
@@ -1640,6 +1643,7 @@ class UpdatesManager {
                 this.qts,
                 pending.qtsBefore
               );
+              postponedTimer.emitBefore(pending.timeout);
             } else {
               log.debug(
                 "gap for postponed %s wasn't filled, fetching diff (current qts %d, need %d)",

package/highlevel/utils/entities.cjs

@@ -5,6 +5,8 @@ if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WAR
 }
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const Long = require("long");
+const peerUtils = require("../../utils/peer-utils.cjs");
 function joinTextWithEntities(parts, delim = "") {
   const textParts = [];
   const newEntities = [];
@@ -36,4 +38,178 @@ function joinTextWithEntities(parts, delim = "") {
     entities: newEntities
   };
 }
+function _entityToRichTextWrapper(entity, text) {
+  const covered = () => text.slice(entity.offset, entity.offset + entity.length);
+  switch (entity._) {
+    case "messageEntityBold":
+      return (inner) => ({ _: "textBold", text: inner });
+    case "messageEntityItalic":
+      return (inner) => ({ _: "textItalic", text: inner });
+    case "messageEntityUnderline":
+      return (inner) => ({ _: "textUnderline", text: inner });
+    case "messageEntityStrike":
+      return (inner) => ({ _: "textStrike", text: inner });
+    case "messageEntityCode":
+    case "messageEntityPre":
+      return (inner) => ({ _: "textFixed", text: inner });
+    case "messageEntitySpoiler":
+      return (inner) => ({ _: "textSpoiler", text: inner });
+    case "messageEntityMention":
+      return (inner) => ({ _: "textMention", text: inner });
+    case "messageEntityHashtag":
+      return (inner) => ({ _: "textHashtag", text: inner });
+    case "messageEntityCashtag":
+      return (inner) => ({ _: "textCashtag", text: inner });
+    case "messageEntityBotCommand":
+      return (inner) => ({ _: "textBotCommand", text: inner });
+    case "messageEntityBankCard":
+      return (inner) => ({ _: "textBankCard", text: inner });
+    case "messageEntityUrl":
+      return (inner) => ({ _: "textUrl", text: inner, url: covered(), webpageId: Long.ZERO });
+    case "messageEntityTextUrl":
+      return (inner) => ({ _: "textUrl", text: inner, url: entity.url, webpageId: Long.ZERO });
+    case "messageEntityEmail":
+      return (inner) => ({ _: "textEmail", text: inner, email: covered() });
+    case "messageEntityPhone":
+      return (inner) => ({ _: "textPhone", text: inner, phone: covered() });
+    case "messageEntityMentionName":
+      return (inner) => ({ _: "textMentionName", text: inner, userId: entity.userId });
+    case "inputMessageEntityMentionName":
+      return (inner) => ({ _: "textMentionName", text: inner, userId: peerUtils.getMarkedPeerId(entity.userId) });
+    case "messageEntityCustomEmoji":
+      return () => ({ _: "textCustomEmoji", documentId: entity.documentId, alt: covered() });
+    case "messageEntityFormattedDate":
+      return (inner) => ({
+        _: "textDate",
+        text: inner,
+        date: entity.date,
+        relative: entity.relative,
+        shortTime: entity.shortTime,
+        longTime: entity.longTime,
+        shortDate: entity.shortDate,
+        longDate: entity.longDate,
+        dayOfWeek: entity.dayOfWeek
+      });
+    default:
+      return null;
+  }
+}
+function textWithEntitiesToRichText(input) {
+  const { text, entities } = input;
+  if (!text) return { _: "textEmpty" };
+  if (!entities?.length) return { _: "textPlain", text };
+  const bounds = /* @__PURE__ */ new Set([0, text.length]);
+  for (const e of entities) {
+    bounds.add(e.offset);
+    bounds.add(e.offset + e.length);
+  }
+  const sorted = [...bounds].filter((b) => b >= 0 && b <= text.length).sort((a, b) => a - b);
+  const segments = [];
+  for (let i = 0; i < sorted.length - 1; i++) {
+    const start = sorted[i];
+    const end = sorted[i + 1];
+    if (start === end) continue;
+    let node = { _: "textPlain", text: text.slice(start, end) };
+    const active = entities.filter((e) => e.offset <= start && e.offset + e.length >= end).sort((a, b) => a.length - b.length);
+    for (const e of active) {
+      const wrap = _entityToRichTextWrapper(e, text);
+      if (wrap) node = wrap(node);
+    }
+    segments.push(node);
+  }
+  if (segments.length === 0) return { _: "textEmpty" };
+  if (segments.length === 1) return segments[0];
+  return { _: "textConcat", texts: segments };
+}
+function _richTextNodeToEntity(node, offset, length) {
+  switch (node._) {
+    case "textBold":
+      return { _: "messageEntityBold", offset, length };
+    case "textItalic":
+      return { _: "messageEntityItalic", offset, length };
+    case "textUnderline":
+      return { _: "messageEntityUnderline", offset, length };
+    case "textStrike":
+      return { _: "messageEntityStrike", offset, length };
+    case "textFixed":
+      return { _: "messageEntityCode", offset, length };
+    case "textSpoiler":
+      return { _: "messageEntitySpoiler", offset, length };
+    case "textMention":
+      return { _: "messageEntityMention", offset, length };
+    case "textHashtag":
+      return { _: "messageEntityHashtag", offset, length };
+    case "textCashtag":
+      return { _: "messageEntityCashtag", offset, length };
+    case "textBotCommand":
+      return { _: "messageEntityBotCommand", offset, length };
+    case "textBankCard":
+      return { _: "messageEntityBankCard", offset, length };
+    case "textUrl":
+      return { _: "messageEntityTextUrl", offset, length, url: node.url };
+    case "textEmail":
+      return { _: "messageEntityEmail", offset, length };
+    case "textPhone":
+      return { _: "messageEntityPhone", offset, length };
+    case "textMentionName":
+      return { _: "messageEntityMentionName", offset, length, userId: node.userId };
+    case "textDate":
+      return {
+        _: "messageEntityFormattedDate",
+        offset,
+        length,
+        date: node.date,
+        relative: node.relative,
+        shortTime: node.shortTime,
+        longTime: node.longTime,
+        shortDate: node.shortDate,
+        longDate: node.longDate,
+        dayOfWeek: node.dayOfWeek
+      };
+    default:
+      return null;
+  }
+}
+function richTextToTextWithEntities(rich) {
+  const entities = [];
+  let text = "";
+  const walk = (node) => {
+    switch (node._) {
+      case "textEmpty":
+        return;
+      case "textPlain":
+        text += node.text;
+        return;
+      case "textConcat":
+        for (const t of node.texts) walk(t);
+        return;
+      case "textImage":
+        return;
+      case "textMath":
+        text += node.source;
+        return;
+      case "textCustomEmoji": {
+        const start = text.length;
+        text += node.alt;
+        entities.push({
+          _: "messageEntityCustomEmoji",
+          offset: start,
+          length: text.length - start,
+          documentId: node.documentId
+        });
+        return;
+      }
+      default: {
+        const start = text.length;
+        walk(node.text);
+        const entity = _richTextNodeToEntity(node, start, text.length - start);
+        if (entity) entities.push(entity);
+      }
+    }
+  };
+  walk(rich);
+  return { text, entities };
+}
 exports.joinTextWithEntities = joinTextWithEntities;
+exports.richTextToTextWithEntities = richTextToTextWithEntities;
+exports.textWithEntitiesToRichText = textWithEntitiesToRichText;

package/highlevel/utils/entities.d.cts

@@ -1,3 +1,4 @@
+import { tl } from '../../tl/index.js';
 import { TextWithEntities } from '../types/misc/entities.js';
 /**
  * Join multiple text parts with entities into a single text with entities,
@@ -17,3 +18,20 @@ import { TextWithEntities } from '../types/misc/entities.js';
  * ```
  */
 export declare function joinTextWithEntities(parts: (string | TextWithEntities)[], delim?: string | TextWithEntities): TextWithEntities;
+/**
+ * Convert a {@link TextWithEntities} into a {@link tl.TypeRichText} tree
+ * (as used in page blocks / instant view).
+ *
+ * Overlapping entities are handled by splitting the text at every entity
+ * boundary and nesting the wrappers per-segment, so the result may be more
+ * fragmented than the input, but always renders identically.
+ */
+export declare function textWithEntitiesToRichText(input: TextWithEntities): tl.TypeRichText;
+/**
+ * Convert a {@link tl.TypeRichText} tree back into a {@link TextWithEntities}.
+ *
+ * This conversion is **lossy**: rich text nodes that have no message entity
+ * equivalent (e.g. `textMarked`, `textSubscript`, anchors, images) are dropped,
+ * keeping only their textual content.
+ */
+export declare function richTextToTextWithEntities(rich: tl.TypeRichText): TextWithEntities;

package/highlevel/utils/entities.d.ts

@@ -1,3 +1,4 @@
+import { tl } from '../../tl/index.js';
 import { TextWithEntities } from '../types/misc/entities.js';
 /**
  * Join multiple text parts with entities into a single text with entities,
@@ -17,3 +18,20 @@ import { TextWithEntities } from '../types/misc/entities.js';
  * ```
  */
 export declare function joinTextWithEntities(parts: (string | TextWithEntities)[], delim?: string | TextWithEntities): TextWithEntities;
+/**
+ * Convert a {@link TextWithEntities} into a {@link tl.TypeRichText} tree
+ * (as used in page blocks / instant view).
+ *
+ * Overlapping entities are handled by splitting the text at every entity
+ * boundary and nesting the wrappers per-segment, so the result may be more
+ * fragmented than the input, but always renders identically.
+ */
+export declare function textWithEntitiesToRichText(input: TextWithEntities): tl.TypeRichText;
+/**
+ * Convert a {@link tl.TypeRichText} tree back into a {@link TextWithEntities}.
+ *
+ * This conversion is **lossy**: rich text nodes that have no message entity
+ * equivalent (e.g. `textMarked`, `textSubscript`, anchors, images) are dropped,
+ * keeping only their textual content.
+ */
+export declare function richTextToTextWithEntities(rich: tl.TypeRichText): TextWithEntities;