@mtcute/core 0.30.0 → 0.30.2

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;

package/highlevel/utils/entities.js

@@ -1,3 +1,5 @@
+import Long from "long";
+import { getMarkedPeerId } from "../../utils/peer-utils.js";
 function joinTextWithEntities(parts, delim = "") {
   const textParts = [];
   const newEntities = [];
@@ -29,6 +31,180 @@ 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: 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 };
+}
 export {
-  joinTextWithEntities
+  joinTextWithEntities,
+  richTextToTextWithEntities,
+  textWithEntitiesToRichText
 };

package/highlevel/utils/index.d.cts

@@ -9,3 +9,4 @@ export * from './rps-meter.js';
 export * from './stream-utils.js';
 export * from './string-session.js';
 export * from './voice-utils.js';
+export * from './walk-page-blocks.js';

package/highlevel/utils/index.d.ts

@@ -9,3 +9,4 @@ export * from './rps-meter.js';
 export * from './stream-utils.js';
 export * from './string-session.js';
 export * from './voice-utils.js';
+export * from './walk-page-blocks.js';

package/highlevel/utils/walk-page-blocks.cjs

@@ -0,0 +1,164 @@
+if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WARNED) {
+  globalThis._MTCUTE_CJS_DEPRECATION_WARNED = true;
+  console.warn("[@mtcute/core] CommonJS bundles are deprecated. They will be removed completely in one of the upcoming releases. No support is provided for CommonJS users. Please consider switching to ESM, it's " + (/* @__PURE__ */ new Date()).getFullYear() + " already.");
+  console.warn("[@mtcute/core] Learn more about switching to ESM: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c");
+}
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const utils = require("../../types/utils.cjs");
+function walkRichText(text, visitor) {
+  if (!text) return;
+  visitor.richText?.(text);
+  switch (text._) {
+    case "textEmpty":
+    case "textPlain":
+    case "textEmail":
+    case "textPhone":
+    case "textImage":
+    case "textMath":
+    case "textCustomEmoji":
+      break;
+    case "textBold":
+    case "textItalic":
+    case "textUnderline":
+    case "textStrike":
+    case "textFixed":
+    case "textUrl":
+    case "textSubscript":
+    case "textSuperscript":
+    case "textMarked":
+    case "textAnchor":
+    case "textSpoiler":
+    case "textMention":
+    case "textHashtag":
+    case "textBotCommand":
+    case "textCashtag":
+    case "textAutoUrl":
+    case "textAutoEmail":
+    case "textAutoPhone":
+    case "textBankCard":
+    case "textDate":
+    case "textMentionName":
+      walkRichText(text.text, visitor);
+      break;
+    case "textConcat":
+      for (const child of text.texts) walkRichText(child, visitor);
+      break;
+    default:
+      utils.assertNever();
+  }
+}
+function walkPageCaption(caption, visitor) {
+  if (!caption) return;
+  walkRichText(caption.text, visitor);
+  walkRichText(caption.credit, visitor);
+}
+function walkPageBlock(block, visitor) {
+  if (!block) return;
+  visitor.pageBlock?.(block);
+  switch (block._) {
+    case "pageBlockUnsupported":
+    case "pageBlockDivider":
+    case "pageBlockAnchor":
+    case "pageBlockMath":
+      break;
+    case "pageBlockTitle":
+    case "pageBlockSubtitle":
+    case "pageBlockHeader":
+    case "pageBlockSubheader":
+    case "pageBlockParagraph":
+    case "pageBlockPreformatted":
+    case "pageBlockFooter":
+    case "pageBlockKicker":
+    case "pageBlockThinking":
+    case "pageBlockHeading1":
+    case "pageBlockHeading2":
+    case "pageBlockHeading3":
+    case "pageBlockHeading4":
+    case "pageBlockHeading5":
+    case "pageBlockHeading6":
+      walkRichText(block.text, visitor);
+      break;
+    case "pageBlockAuthorDate":
+      walkRichText(block.author, visitor);
+      break;
+    case "pageBlockList":
+      for (const item of block.items) {
+        switch (item._) {
+          case "pageListItemText":
+            walkRichText(item.text, visitor);
+            break;
+          case "pageListItemBlocks":
+            for (const block2 of item.blocks) walkPageBlock(block2, visitor);
+            break;
+          default:
+            utils.assertNever();
+        }
+      }
+      break;
+    case "pageBlockOrderedList":
+      for (const item of block.items) {
+        switch (item._) {
+          case "pageListOrderedItemText":
+            walkRichText(item.text, visitor);
+            break;
+          case "pageListOrderedItemBlocks":
+            for (const block2 of item.blocks) walkPageBlock(block2, visitor);
+            break;
+          default:
+            utils.assertNever();
+        }
+      }
+      break;
+    case "pageBlockBlockquote":
+    case "pageBlockPullquote":
+      walkRichText(block.text, visitor);
+      walkRichText(block.caption, visitor);
+      break;
+    case "pageBlockPhoto":
+    case "pageBlockVideo":
+    case "pageBlockEmbed":
+    case "pageBlockAudio":
+    case "pageBlockMap":
+    case "inputPageBlockMap":
+      walkPageCaption(block.caption, visitor);
+      break;
+    case "pageBlockCover":
+      walkPageBlock(block.cover, visitor);
+      break;
+    case "pageBlockEmbedPost":
+      for (const child of block.blocks) walkPageBlock(child, visitor);
+      walkPageCaption(block.caption, visitor);
+      break;
+    case "pageBlockCollage":
+    case "pageBlockSlideshow":
+      for (const child of block.items) walkPageBlock(child, visitor);
+      walkPageCaption(block.caption, visitor);
+      break;
+    case "pageBlockChannel":
+      break;
+    case "pageBlockTable":
+      walkRichText(block.title, visitor);
+      for (const row of block.rows) {
+        for (const cell of row.cells) walkRichText(cell.text, visitor);
+      }
+      break;
+    case "pageBlockDetails":
+      for (const child of block.blocks) walkPageBlock(child, visitor);
+      walkRichText(block.title, visitor);
+      break;
+    case "pageBlockRelatedArticles":
+      walkRichText(block.title, visitor);
+      break;
+    case "pageBlockBlockquoteBlocks":
+      for (const child of block.blocks) walkPageBlock(child, visitor);
+      walkRichText(block.caption, visitor);
+      break;
+    default:
+      utils.assertNever();
+  }
+}
+function walkPageBlocks(blocks, visitor) {
+  for (const block of blocks) walkPageBlock(block, visitor);
+}
+exports.walkPageBlocks = walkPageBlocks;

package/highlevel/utils/walk-page-blocks.d.cts

@@ -0,0 +1,9 @@
+import { tl } from '../../tl/index.js';
+export interface PageBlockVisitor {
+    /** Called for every rich text node in the tree */
+    richText?: (text: tl.TypeRichText) => void;
+    /** Called for every page block in the tree */
+    pageBlock?: (block: tl.TypePageBlock) => void;
+}
+/** Recursively walk a list of page blocks, invoking the given visitor callbacks */
+export declare function walkPageBlocks(blocks: tl.TypePageBlock[], visitor: PageBlockVisitor): void;

package/highlevel/utils/walk-page-blocks.d.ts

@@ -0,0 +1,9 @@
+import { tl } from '../../tl/index.js';
+export interface PageBlockVisitor {
+    /** Called for every rich text node in the tree */
+    richText?: (text: tl.TypeRichText) => void;
+    /** Called for every page block in the tree */
+    pageBlock?: (block: tl.TypePageBlock) => void;
+}
+/** Recursively walk a list of page blocks, invoking the given visitor callbacks */
+export declare function walkPageBlocks(blocks: tl.TypePageBlock[], visitor: PageBlockVisitor): void;