@volter/twin-telegram 1.0.0

package/dist/spec/sources.json

@@ -0,0 +1,416 @@
+{
+  "https://core.telegram.org/bots/api#accent-colors": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "Colors with identifiers 0 (red), 1 (orange), 2 (purple/violet), 3 (green), 4 (cyan), 5 (blue), 6 (pink) can be customized by app themes.": true
+    }
+  },
+  "https://core.telegram.org/bots/api#chat": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "Unique identifier for this chat.": true,
+      "Type of the chat, can be either": true
+    }
+  },
+  "https://core.telegram.org/bots/api#chatmember": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "Currently, the following 6 types of chat members are supported": true
+    }
+  },
+  "https://core.telegram.org/bots/api#chatmemberadministrator": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "True , if the administrator can post messages in the channel": true,
+      "Represents a chat member that has some additional privileges.": true
+    }
+  },
+  "https://core.telegram.org/bots/api#chatmemberbanned": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "If 0, then the user is banned forever": true,
+      "Date when restrictions will be lifted for this user; Unix time. If 0, then the user is banned forever": true,
+      "Represents a chat member that was banned in the chat and can't return to the chat or view chat messages.": true
+    }
+  },
+  "https://core.telegram.org/bots/api#chatmembermember": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "Represents a chat member that has no additional privileges or restrictions.": true
+    }
+  },
+  "https://core.telegram.org/bots/api#chatmemberowner": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "Represents a chat member that owns the chat and has all administrator privileges.": true
+    }
+  },
+  "https://core.telegram.org/bots/api#chatphoto": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "File identifier of small (160x160) chat photo.": true
+    }
+  },
+  "https://core.telegram.org/bots/api#deletemessage": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "Use this method to delete a message, including service messages, with the following limitations:": true,
+      "A message can only be deleted if it was sent less than 48 hours ago.": true,
+      "Service messages about a supergroup, channel, or forum topic creation can't be deleted.": true,
+      "Bots can delete outgoing messages in private chats, groups, and supergroups.": true,
+      "Bots can delete incoming messages in private chats.": true,
+      "Bots granted can_post_messages permissions can delete outgoing messages in channels.": true,
+      "If the bot is an administrator of a group, it can delete any message there.": true,
+      "If the bot has can_delete_messages administrator right in a supergroup or a channel, it can delete any message there.": true
+    }
+  },
+  "https://core.telegram.org/bots/api#deletewebhook": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "Pass True to drop all pending updates": true
+    }
+  },
+  "https://core.telegram.org/bots/api#file": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "Optional. File path. Use https://api.telegram.org/file/bot<token>/<file_path> to get the file.": true,
+      "Unique identifier for this file, which is supposed to be the same over time and for different bots.": true
+    }
+  },
+  "https://core.telegram.org/bots/api#formatting-options": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "Custom emoji entities can only be used by bots that purchased additional usernames on Fragment or in the messages directly sent by the bot to private, group and supergroup chats if the owner of the bot has a Telegram Premium subscription.": true,
+      "Links tg://user?id=<user_id> can be used to mention a user by their identifier without using a username.": true
+    }
+  },
+  "https://core.telegram.org/bots/api#getchat": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "Use this method to get up-to-date information about the chat. Returns a ChatFullInfo object on success.": true
+    }
+  },
+  "https://core.telegram.org/bots/api#getchatmember": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "Use this method to get information about a member of a chat.": true
+    }
+  },
+  "https://core.telegram.org/bots/api#getfile": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "Use this method to get basic information about a file and prepare it for downloading. For the moment, bots can download files of up to 20MB in size.": true,
+      "The file can then be downloaded via the link https://api.telegram.org/file/bot<token>/<file_path> , where <file_path> is taken from the response.": true
+    }
+  },
+  "https://core.telegram.org/bots/api#getme": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "Returns basic information about the bot in form of a User object.": true
+    }
+  },
+  "https://core.telegram.org/bots/api#getting-updates": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "Incoming updates are stored on the server until the bot receives them either way, but they will not be kept longer than 24 hours.": true
+    }
+  },
+  "https://core.telegram.org/bots/api#getupdates": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "Limits the number of updates to be retrieved. Values between 1-100 are accepted. Defaults to 100.": true,
+      "Timeout in seconds for long polling. Defaults to 0, i.e. usual short polling.": true,
+      "If not specified, the previous setting will be used.": true,
+      "The negative offset can be specified to retrieve updates starting from -offset update from the end of the updates queue. All previous updates will be forgotten.": true,
+      "An update is considered confirmed as soon as getUpdates is called with an offset higher than its update_id.": true,
+      "Should be positive, short polling should be used for testing purposes only.": true,
+      "Specify an empty list to receive all update types except chat_member, message_reaction, and message_reaction_count (default).": true,
+      "Please note that this parameter doesn't affect updates created before the call to getUpdates, so unwanted updates may be received for a short period of time.": true,
+      "Values between 1-100 are accepted. Defaults to 100.": true
+    }
+  },
+  "https://core.telegram.org/bots/api#making-requests": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "We support GET and POST HTTP methods.": true,
+      "All methods in the Bot API are case-insensitive.": true,
+      "If 'ok' equals True, the request was successful and the result of the query can be found in the 'result' field.": true,
+      "We support four ways of passing parameters in Bot API requests": true,
+      "In case of an unsuccessful request, 'ok' equals False and the error is explained in the 'description'.": true,
+      "https://api.telegram.org/bot<token>/METHOD_NAME": true
+    }
+  },
+  "https://core.telegram.org/bots/api#markdown-style": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "This is a legacy mode, retained for backward compatibility.": true
+    }
+  },
+  "https://core.telegram.org/bots/api#markdownv2-style": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "To use this mode, pass MarkdownV2 in the parse_mode field.": true
+    }
+  },
+  "https://core.telegram.org/bots/api#message": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "Optional. Message is a photo, available sizes of the photo": true,
+      "Optional. The unique identifier inside this chat of a media message group this message belongs to": true,
+      "Optional. Sender of the message when sent on behalf of a chat. For example, the supergroup itself for messages sent by its anonymous administrators or a linked channel for messages automatically forwarded to the channel's discussion group.": true,
+      "Optional. Service message: the group has been created": true,
+      "Optional. New members that were added to the group or supergroup and information about them (the bot itself may be one of these members)": true,
+      "Optional. A member was removed from the group, information about them (this member may be the bot itself)": true,
+      "Note that the Message object in this field will not contain further reply_to_message fields even if it itself is a reply.": true,
+      "Unique message identifier inside this chat;": true,
+      "Optional. Sender of the message; may be empty for messages sent to channels.": true,
+      "Date the message was sent in Unix time": true
+    }
+  },
+  "https://core.telegram.org/bots/api#sendchataction": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "Use this method when you need to tell the user that something is happening on the bot's side.": true,
+      "The status is set for 5 seconds or less (when a message arrives from your bot, Telegram clients clear its typing status). Returns True on success.": true
+    }
+  },
+  "https://core.telegram.org/bots/api#senddocument": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "Bots can currently send files of any type of up to 50 MB in size, this limit may be changed in the future.": true,
+      "Use this method to send general files. On success, the sent Message is returned.": true
+    }
+  },
+  "https://core.telegram.org/bots/api#sending-files": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "It is not possible to change the file type when resending by file_id .": true,
+      "file_id is unique for each individual bot and can't be transferred from one bot to another.": true
+    }
+  },
+  "https://core.telegram.org/bots/api#sendmediagroup": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "On success, an Array of Message objects that were sent is returned.": true,
+      "Documents and audio files can be only grouped in an album with messages of the same type.": true
+    }
+  },
+  "https://core.telegram.org/bots/api#sendmessage": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "Text of the message to be sent, 1-4096 characters after entities parsing": true
+    }
+  },
+  "https://core.telegram.org/bots/api#sendphoto": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "Photo caption (may also be used when resending photos by file_id), 0-1024 characters after entities parsing": true,
+      "The photo must be at most 10 MB in size.": true,
+      "The photo's width and height must not exceed 10000 in total. Width and height ratio must be at most 20.": true,
+      "Use this method to send photos. On success, the sent Message is returned.": true
+    }
+  },
+  "https://core.telegram.org/bots/api#sendvideo": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "Bots can currently send video files of up to 50 MB in size, this limit may be changed in the future.": true,
+      "Duration of sent video in seconds": true,
+      "Use this method to send video files, Telegram clients support MPEG4 videos (other formats may be sent as Document).": true
+    }
+  },
+  "https://core.telegram.org/bots/api#update": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "Optional. The bot's chat member status was updated in a chat.": true,
+      "Optional. New incoming channel post of any kind - text, photo, sticker, etc.": true,
+      "For private chats, this update is received only when the bot is blocked or unblocked by the user.": true,
+      "Update identifiers start from a certain positive number and increase sequentially.": true
+    }
+  },
+  "https://core.telegram.org/bots/api#user": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "Optional. User's or bot's username": true,
+      "Optional. True, if the bot can be invited to groups. Returned only in getMe.": true,
+      "Unique identifier for this user or bot.": true
+    }
+  },
+  "https://core.telegram.org/bots/faq": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "bots are not able to broadcast more than about 30 messages per second": true
+    }
+  },
+  "https://core.telegram.org/bots/features#botfather": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "Usernames are 5-32 characters long and not case sensitive – but may only include Latin characters, numbers, and underscores. Your bot's username must end in 'bot’, like 'tetris_bot' or 'TetrisBot'.": true,
+      "If your existing token is compromised or you lost it for some reason, use the /token command to generate a new one.": true,
+      "Users will see a Start button the first time they open a chat with your bot.": true,
+      "The token is a string, like 110201543:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw": true
+    }
+  },
+  "https://core.telegram.org/bots/features#privacy-mode": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "Privacy mode is enabled by default for all bots": true,
+      "All messages from channels where they are a member.": true,
+      "Privacy mode is enabled by default for all bots, except bots that were added to a group as admins (bot admins always receive all messages ).": true,
+      "All service messages.": true,
+      "Commands explicitly meant for them (e.g., /command@this_bot ).": true,
+      "General commands (e.g. /start ) if the bot was the last bot to send a message to the group.": true,
+      "Replies to any messages implicitly or explicitly meant for this bot.": true
+    }
+  },
+  "https://core.telegram.org/bots/samples": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "these projects are not maintained by Telegram": true
+    }
+  },
+  "https://core.telegram.org/method/messages.sendMedia": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "Failure while processing image.": true
+    }
+  },
+  "https://raw.githubusercontent.com/tdlib/td/42e6a5259551178d1dab54a22ad96d14bd906e20/td/telegram/DialogManager.cpp": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "Need administrator rights in the channel chat": true
+    }
+  },
+  "https://raw.githubusercontent.com/tdlib/td/42e6a5259551178d1dab54a22ad96d14bd906e20/td/telegram/files/FileManager.cpp": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "Can't use file of type": true
+    }
+  },
+  "https://raw.githubusercontent.com/tdlib/td/42e6a5259551178d1dab54a22ad96d14bd906e20/td/telegram/MessageContent.cpp": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "There are no messages to send": true,
+      "Too many messages to send as an album": true,
+      "Invalid message content type": true,
+      "can't be mixed with other media types": true,
+      "Not enough rights to send": true
+    }
+  },
+  "https://raw.githubusercontent.com/tdlib/td/42e6a5259551178d1dab54a22ad96d14bd906e20/td/telegram/MessageEntity.cpp": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "Text must be non-empty": true,
+      "Unsupported start tag": true,
+      "is reserved and must be escaped with the preceding": true,
+      "add_entities(MessageEntity::Type::Mention, find_mentions);": true
+    }
+  },
+  "https://raw.githubusercontent.com/tdlib/td/42e6a5259551178d1dab54a22ad96d14bd906e20/td/telegram/MessagesManager.cpp": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "Message is too long": true,
+      "Message caption is too long": true,
+      "Bot can't initiate conversation with a user": true,
+      "Wrong file identifier/HTTP URL specified": true
+    }
+  },
+  "https://raw.githubusercontent.com/tdlib/telegram-bot-api/e3e9dd8e5b3d7ab8537cd5a10dc31d5ffa8f82d1/telegram-bot-api/Client.cpp": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "result.code = 401;": true,
+      "Message text is empty": true,
+      "Bad Request: file is too big": true,
+      "(error_message[1] == '_' || ('A' <= error_message[1] && error_message[1] <= 'Z'))) {": true,
+      "Can't parse media JSON object": true,
+      "Wrong parameter action in request": true,
+      "user not found": true,
+      "invalid file_id": true,
+      "auto allowed_update_types = get_allowed_update_types(query->arg(": true,
+      "Webhook is already deleted": true,
+      "Bad Request: chat not found": true,
+      "Bad Request: chat_id is empty": true,
+      "Forbidden: bot was kicked from the group chat": true,
+      "Forbidden: bot was kicked from the channel chat": true,
+      "bool need_more_access_rights = is_public ? need_edit_access : need_read_access;": true,
+      "Forbidden: bot is not a member of the channel chat": true,
+      "Text is too long": true,
+      "text_parse_mode = make_object<td_api::textParseModeMarkdown>(2);": true,
+      "Unsupported parse_mode": true,
+      "Can't parse reply parameters JSON object": true,
+      "result.reply_to_message_id = get_message_id(query,": true,
+      "message to be replied not found": true,
+      "Failed to get HTTP URL content": true,
+      "message to delete": true,
+      "message can't be deleted": true,
+      "error_code = 403;": true,
+      "Not Found: method not found": true,
+      "result.reply_to_message_id = get_message_id(query, \"reply_to_message_id\");": true
+    }
+  },
+  "https://raw.githubusercontent.com/tdlib/telegram-bot-api/e3e9dd8e5b3d7ab8537cd5a10dc31d5ffa8f82d1/telegram-bot-api/Client.h": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "static constexpr int32 LONG_POLL_MAX_TIMEOUT = 50;": true
+    }
+  },
+  "https://raw.githubusercontent.com/tdlib/telegram-bot-api/e3e9dd8e5b3d7ab8537cd5a10dc31d5ffa8f82d1/telegram-bot-api/ClientManager.cpp": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "Unauthorized: invalid token specified": true,
+      "if (token[0] == '0' || token.size() > 80u || token.find('/') != td::string::npos ||": true,
+      "auto r_user_id = td::to_integer_safe<td::int64>(query->token().substr(0, token.find(':')));": true
+    }
+  },
+  "https://raw.githubusercontent.com/tdlib/telegram-bot-api/e3e9dd8e5b3d7ab8537cd5a10dc31d5ffa8f82d1/telegram-bot-api/HttpConnection.cpp": {
+    "status": 200,
+    "checked": "2026-10-02",
+    "quotes": {
+      "if (!url_path_parser.try_skip(": true,
+      "return send_http_error(404,": true
+    }
+  }
+}

package/dist/src/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/src/cli.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+// world-telegram: serve the telegram twin.
+import { hasFlag, optionValue } from '@volter/world-core/args';
+import { keepProcessAlive } from '@volter/world-core/lifecycle';
+import { createTelegramTwinServer } from "./server.js";
+const [cmd, ...rest] = process.argv.slice(2);
+const port = Number(optionValue(rest, '--port', '0')) || undefined;
+const root = optionValue(rest, '--root') || undefined;
+const readOnly = hasFlag(rest, '--read-only');
+// the World's managed Postgres, which the runtime binds a pack declaring managedDatabase to
+const database = optionValue(rest, '--database') || undefined;
+// the World's scenario file, for a model vendor's turns
+const scenarioPath = optionValue(rest, '--scenario') || undefined;
+if (cmd === 'serve' || cmd === undefined) {
+    const s = await createTelegramTwinServer({ readOnly, ...(root ? { root } : {}), ...(port ? { port } : {}), ...(database ? { database } : {}), ...(scenarioPath ? { scenarioPath } : {}) });
+    process.stdout.write(`telegram twin${readOnly ? ' [read-only]' : ''} at http://127.0.0.1:${s.port}\n`);
+    await keepProcessAlive();
+}
+else {
+    process.stdout.write('Usage: world-telegram serve [--port N] [--root DIR] [--read-only] [--database URL] [--scenario FILE]\n');
+}

package/dist/src/engine/media.d.ts

@@ -0,0 +1,17 @@
+export type ImageSize = {
+    width: number;
+    height: number;
+    mime: string;
+};
+export type VideoInfo = {
+    width: number;
+    height: number;
+    duration: number;
+};
+/** An image's size from its header: PNG (IHDR), GIF (logical screen), JPEG (the first start-of-frame); undefined for
+ *  anything else (a photo Telegram takes is a .jpg, .jpeg, .gif, .png, .tif or .bmp, MessagesManager.cpp's
+ *  PHOTO_EXT_INVALID; the twin reads the first three). */
+export declare function imageSize(b: Uint8Array): ImageSize | undefined;
+/** An MP4's (ISO base media) duration in whole seconds from its movie header (mvhd), and the first track with a size
+ *  from its track header (tkhd: 16.16 fixed-point width and height); undefined for a file that is not one. */
+export declare function mp4Info(b: Uint8Array): VideoInfo | undefined;

package/dist/src/engine/media.js

@@ -0,0 +1,75 @@
+// What Telegram reads from an uploaded file's own bytes: an image's width and height (a PhotoSize), and a video's width,
+// height and duration (a Video), each from the format's header as that format defines it. Pure computation over bytes.
+const u16be = (b, i) => (b[i] << 8) | b[i + 1];
+const u32be = (b, i) => ((b[i] << 24) >>> 0) + (b[i + 1] << 16) + (b[i + 2] << 8) + b[i + 3];
+const u16le = (b, i) => b[i] | (b[i + 1] << 8);
+const ascii = (b, i, n) => String.fromCharCode(...b.subarray(i, i + n));
+/** An image's size from its header: PNG (IHDR), GIF (logical screen), JPEG (the first start-of-frame); undefined for
+ *  anything else (a photo Telegram takes is a .jpg, .jpeg, .gif, .png, .tif or .bmp, MessagesManager.cpp's
+ *  PHOTO_EXT_INVALID; the twin reads the first three). */
+export function imageSize(b) {
+    if (b.length >= 24 && b[0] === 0x89 && ascii(b, 1, 3) === 'PNG' && ascii(b, 12, 4) === 'IHDR')
+        return { width: u32be(b, 16), height: u32be(b, 20), mime: 'image/png' };
+    if (b.length >= 10 && ascii(b, 0, 3) === 'GIF')
+        return { width: u16le(b, 6), height: u16le(b, 8), mime: 'image/gif' };
+    // a JPEG's markers are walked to its first frame header; a JPEG with none, like any other file, has no size
+    const jpeg = b.length >= 4 && b[0] === 0xff && b[1] === 0xd8;
+    for (let i = 2; jpeg && i + 9 < b.length; i += b[i] !== 0xff ? 1 : jpegStep(b, i)) {
+        const marker = b[i + 1];
+        // SOF0-SOF15 but DHT (C4), JPG (C8) and DAC (CC) carry the frame's height and width
+        if (b[i] === 0xff && marker >= 0xc0 && marker <= 0xcf && marker !== 0xc4 && marker !== 0xc8 && marker !== 0xcc)
+            return { height: u16be(b, i + 5), width: u16be(b, i + 7), mime: 'image/jpeg' };
+    }
+    return undefined;
+}
+/** How far a JPEG's marker at `i` reaches: a marker with no length (SOI, TEM, RSTn) is its two bytes, any other its
+ *  length after them. */
+const jpegStep = (b, i) => {
+    const marker = b[i + 1];
+    return marker === 0xd8 || marker === 0x01 || (marker >= 0xd0 && marker <= 0xd7) ? 2 : 2 + u16be(b, i + 2);
+};
+/** An MP4's (ISO base media) duration in whole seconds from its movie header (mvhd), and the first track with a size
+ *  from its track header (tkhd: 16.16 fixed-point width and height); undefined for a file that is not one. */
+export function mp4Info(b) {
+    if (b.length < 12 || ascii(b, 4, 4) !== 'ftyp')
+        return undefined;
+    let duration;
+    let width = 0;
+    let height = 0;
+    const walk = (start, end) => {
+        let i = start;
+        while (i + 8 <= end) {
+            let size = u32be(b, i);
+            const type = ascii(b, i + 4, 4);
+            let header = 8;
+            if (size === 1 && i + 16 <= end) {
+                size = u32be(b, i + 8) * 2 ** 32 + u32be(b, i + 12);
+                header = 16;
+            }
+            if (size === 0)
+                size = end - i;
+            if (size < header || i + size > end)
+                return;
+            if (type === 'moov' || type === 'trak')
+                walk(i + header, i + size);
+            else if (type === 'mvhd') {
+                const v = b[i + header];
+                const timescale = v === 1 ? u32be(b, i + header + 20) : u32be(b, i + header + 12);
+                const units = v === 1 ? u32be(b, i + header + 24) * 2 ** 32 + u32be(b, i + header + 28) : u32be(b, i + header + 16);
+                if (timescale)
+                    duration = Math.round(units / timescale);
+            }
+            else if (type === 'tkhd' && !width) {
+                const v = b[i + header];
+                const at = i + header + (v === 1 ? 88 : 76);
+                if (at + 8 <= i + size) {
+                    width = u32be(b, at) >>> 16;
+                    height = u32be(b, at + 4) >>> 16;
+                }
+            }
+            i += size;
+        }
+    };
+    walk(0, b.length);
+    return duration === undefined ? undefined : { width, height, duration };
+}

package/dist/src/engine/text.d.ts

@@ -0,0 +1,45 @@
+export type Entity = {
+    type: string;
+    offset: number;
+    length: number;
+    url?: string;
+    language?: string;
+    custom_emoji_id?: string;
+    unix_time?: number;
+    date_time_format?: string;
+    user_id?: number;
+};
+export type Formatted = {
+    text: string;
+    entities: Entity[];
+};
+/** The HTML parse mode: the text and its entities, or the parser's refusal in TDLib's words. */
+export declare function parseHtml(input: string): Formatted | {
+    error: string;
+};
+/** The MarkdownV2 parse mode: the text and its entities, or the parser's refusal in TDLib's words. A backslash escapes
+ *  any ASCII character; outside code every one of `_*[]()~`>#+-=|{}.!` that opens no mark must be escaped; inside code
+ *  only the backquote is reserved. */
+export declare function parseMarkdownV2(input: string): Formatted | {
+    error: string;
+};
+/** The legacy Markdown parse mode: *bold*, _italic_, `code`, ```pre``` (a language after its opening), [text](link),
+ *  none nested; a backslash escapes only _ * ` and [. The text and its entities, or the parser's refusal in TDLib's
+ *  words. */
+export declare function parseMarkdown(input: string): Formatted | {
+    error: string;
+};
+/** Entities in TDLib's order: by offset, the longer first. */
+export declare function sortEntities(entities: Entity[]): Entity[];
+/** The entities the server finds in a text by itself: mentions (@name, 2-32 letters, digits and underscores, not
+ *  inside a word), bot commands (/command, 1-64, optionally @bot), hashtags (#tag with a letter), cashtags ($ABC),
+ *  links (http, https, or www.) and e-mail addresses. Where the twin stops: TDLib's own link matcher also takes bare
+ *  domains by their top-level domain, and finds bank card numbers; the twin does not. */
+export declare function findEntities(text: string, skipBotCommands: boolean): Entity[];
+/** What the server keeps of a formatted text (TDLib's fix_formatted_text): whitespace trimmed from both ends (the
+ *  entities moved and cut with it), the entities it finds itself added where they cross none given, sorted. Empty
+ *  is the caller's to refuse. */
+export declare function finish(f: Formatted, opts: {
+    find: boolean;
+    skipBotCommands: boolean;
+}): Formatted;