@emaxe/tuigram 1.0.1 → 1.2.0

package/.env.example

@@ -27,3 +27,27 @@ AUTO_SCROLL=true
 
 # Показывать уведомления о наборе текста (true/false)
 SHOW_TYPING=true
+
+# Отображение цветных превью изображений в чате (true/false)
+SHOW_IMAGES=true
+
+# Максимальные размеры превью изображений в символах терминала (ширина x высота)
+IMAGE_MAX_WIDTH=36
+IMAGE_MAX_HEIGHT=14
+
+# ── Proxy Settings ────────────────────────────────────────────────────────────
+# Поддерживаются HTTP и SOCKS5 (как с авторизацией, так и без).
+# Формат единого URL:
+# PROXY_URL=http://127.0.0.1:8080
+# PROXY_URL=http://user:password@proxy.example.com:8080
+# PROXY_URL=socks5://127.0.0.1:1080
+# PROXY_URL=socks5://user:password@127.0.0.1:1080
+#
+# Либо отдельными переменными:
+# PROXY_TYPE=http
+# PROXY_HOST=127.0.0.1
+# PROXY_PORT=8080
+# PROXY_USERNAME=
+# PROXY_PASSWORD=
+# PROXY_TIMEOUT=10
+

package/CHANGELOG.md

@@ -13,6 +13,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 - English localization of the TUI and CLI interface strings.
 
+## [1.2.0] — 2026-09-01
+
+### Added
+
+- Display color image previews directly in chat messages using high-resolution Unicode half-block characters (`▀` `U+2580`) with instant rendering of Telegram stripped thumbnails (`PhotoStrippedSize`).
+- Configuration options `SHOW_IMAGES`, `IMAGE_MAX_WIDTH`, and `IMAGE_MAX_HEIGHT` to control image preview rendering in `.env` and `config.js`.
+
+## [1.1.0] — 2026-08-31
+
+### Added
+
+- Support for HTTP/HTTPS (via HTTP CONNECT) and SOCKS5/SOCKS4 proxies with optional username and password authentication.
+- Proxy configuration options via `.env` (`PROXY_URL` or `PROXY_TYPE`/`PROXY_HOST`/`PROXY_PORT`/`PROXY_USERNAME`/`PROXY_PASSWORD`) and standard environment variables (`HTTPS_PROXY`, `HTTP_PROXY`, `ALL_PROXY`).
+- Display of active proxy status with password masking in `tuigram paths`.
+
 ## [1.0.1] — 2026-08-29
 
 Documentation and packaging only — no runtime changes.
@@ -103,6 +118,8 @@ First public release.
 - A WCAG contrast test (3:1 threshold) applied to every theme **after** conversion
   to xterm-256 — the colors are checked exactly as the user sees them.
 
-[Unreleased]: https://github.com/emaxe/tuigram/compare/v1.0.1...HEAD
+[Unreleased]: https://github.com/emaxe/tuigram/compare/v1.2.0...HEAD
+[1.2.0]: https://github.com/emaxe/tuigram/compare/v1.1.0...v1.2.0
+[1.1.0]: https://github.com/emaxe/tuigram/compare/v1.0.1...v1.1.0
 [1.0.1]: https://github.com/emaxe/tuigram/compare/v1.0.0...v1.0.1
 [1.0.0]: https://github.com/emaxe/tuigram/releases/tag/v1.0.0

package/CHANGELOG.ru.md

@@ -13,6 +13,21 @@
 
 - Английская локализация строк интерфейса TUI и CLI.
 
+## [1.2.0] — 2026-09-01
+
+### Добавлено
+
+- Отображение цветных превью изображений прямо в ленте сообщений чата с помощью псевдографики высокого разрешения (Unicode Half-Block `▀` `U+2580`) и мгновенного рендеринга миниатюр `PhotoStrippedSize`.
+- Параметры конфигурации `SHOW_IMAGES`, `IMAGE_MAX_WIDTH` и `IMAGE_MAX_HEIGHT` в `.env` и `config.js` для управления отображением превью и их максимальным размером.
+
+## [1.1.0] — 2026-08-31
+
+### Добавлено
+
+- Поддержка работы через HTTP/HTTPS (HTTP CONNECT) и SOCKS5/SOCKS4 прокси, как с авторизацией по логину и паролю, так и без неё.
+- Настройка прокси через `.env` (`PROXY_URL` или `PROXY_TYPE`/`PROXY_HOST`/`PROXY_PORT`/`PROXY_USERNAME`/`PROXY_PASSWORD`) и стандартные переменные окружения (`HTTPS_PROXY`, `HTTP_PROXY`, `ALL_PROXY`).
+- Отображение активного прокси с маскированием пароля в выводе команды `tuigram paths`.
+
 ## [1.0.1] — 2026-08-29
 
 Только документация и упаковка — поведение клиента не менялось.
@@ -105,6 +120,8 @@
 - Тест контраста по WCAG (порог 3:1) для каждой темы — **после** конверсии в xterm-256,
   то есть ровно в том виде, в каком цвет увидит пользователь.
 
-[Unreleased]: https://github.com/emaxe/tuigram/compare/v1.0.1...HEAD
+[Unreleased]: https://github.com/emaxe/tuigram/compare/v1.2.0...HEAD
+[1.2.0]: https://github.com/emaxe/tuigram/compare/v1.1.0...v1.2.0
+[1.1.0]: https://github.com/emaxe/tuigram/compare/v1.0.1...v1.1.0
 [1.0.1]: https://github.com/emaxe/tuigram/compare/v1.0.0...v1.0.1
 [1.0.0]: https://github.com/emaxe/tuigram/releases/tag/v1.0.0

package/README.md

@@ -55,6 +55,8 @@ TuiGram lets you use Telegram entirely from the terminal: browse your dialog lis
 - [Slash commands](#-slash-commands-in-the-input-box)
 - [Sending files and images](#-sending-files-and-images)
 - [Themes](#-themes)
+- [Inline image previews](#️-inline-image-previews)
+- [Proxy configuration](#-proxy-configuration)
 - [Command line usage (CLI)](#️-command-line-usage-cli)
 - [Project structure](#-project-structure)
 - [Security](#-security)
@@ -73,6 +75,7 @@ TuiGram lets you use Telegram entirely from the terminal: browse your dialog lis
   - Instant search and filtering of chats by title and `@username` (`/`);
   - Live typing indicator ("… is typing");
   - Colored rendering of Telegram entities (bold, italic, monospace code, URLs, mentions, spoilers);
+  - High-resolution inline image previews (Unicode Half-Block `▀` pixel art);
   - Media attachment indicators (photo, video, document, voice, sticker, poll);
   - Message reactions (👍, 🔥, ❤️);
   - Infinite upward pagination of message history (`PageUp` / `Ctrl+U`);
@@ -511,6 +514,52 @@ The contrast of every "text on background" pair is verified by an automated WCAG
 
 ---
 
+## 🖼️ Inline image previews
+
+TuiGram displays color image previews directly in the chat history using high-resolution Unicode half-block characters (`▀` `U+2580`). Each character cell renders 2 vertical subpixels with 24-bit RGB colors, producing crisp, proportional pixel art that scrolls naturally with messages and works across all terminals.
+
+Previews are enabled by default and can be configured in `.env`:
+
+```env
+# Enable/disable image previews in chat (true/false)
+SHOW_IMAGES=true
+
+# Maximum preview size in terminal characters (width x height)
+IMAGE_MAX_WIDTH=36
+IMAGE_MAX_HEIGHT=14
+```
+
+---
+
+## 🌐 Proxy configuration
+
+TuiGram supports routing MTProto connections through HTTP (including HTTPS CONNECT) and SOCKS5/SOCKS4 proxies — both with and without username/password authentication.
+
+Proxy options can be configured in `.env` (or via environment variables):
+
+**Single URL:**
+```env
+PROXY_URL=http://127.0.0.1:8080
+PROXY_URL=http://user:password@proxy.example.com:8080
+PROXY_URL=socks5://127.0.0.1:1080
+PROXY_URL=socks5://user:password@127.0.0.1:1080
+```
+
+**Or separate variables:**
+```env
+PROXY_TYPE=http         # http, https, socks5, socks4
+PROXY_HOST=127.0.0.1
+PROXY_PORT=8080
+PROXY_USERNAME=user     # optional
+PROXY_PASSWORD=password # optional
+PROXY_TIMEOUT=10        # timeout in seconds (default: 10)
+```
+
+Standard environment variables `HTTPS_PROXY`, `HTTP_PROXY`, and `ALL_PROXY` are also supported as fallbacks.
+The active proxy status can be inspected using `tuigram paths`.
+
+---
+
 ## 🛠️ Command line usage (CLI)
 
 TuiGram can be used as a set of console utilities (when running from a repository
@@ -554,6 +603,7 @@ TuiGram/
 │   ├── state.js                 # Reactive centralized state store
 │   ├── telegram/
 │   │   ├── client.js            # MTProto client creation and management
+│   │   ├── socket.js            # MTProto network transport and proxy tunneling (HTTP/SOCKS5)
 │   │   ├── auth.js              # Interactive login wizard and 2FA
 │   │   ├── dialogs.js           # Fetching, filtering and searching dialogs
 │   │   ├── messages.js          # History loading, sending, editing, files, reactions
@@ -581,6 +631,7 @@ TuiGram/
 │   │   ├── init.js              # tuigram init / paths — setup and diagnostics
 │   │   └── formatters.js        # Console table and log formatters
 │   └── utils/
+│       ├── image.js             # Image decoding, resizing and Half-Block ANSI rendering
 │       ├── storage.js           # File operations and session persistence
 │       └── time.js              # Time and date formatting
 ├── scripts/

package/README.ru.md

@@ -51,6 +51,8 @@
 - [Слэш-команды](#-слэш-команды-в-поле-ввода)
 - [Отправка файлов и картинок](#-отправка-файлов-и-картинок)
 - [Темы оформления](#-темы-оформления)
+- [Превью изображений в сообщениях](#️-превью-изображений-в-сообщениях)
+- [Прокси-сервер](#-прокси-сервер)
 - [Использование через консоль (CLI)](#️-использование-через-консоль-cli)
 - [Структура проекта](#-структура-проекта)
 - [Безопасность](#-безопасность)
@@ -69,6 +71,7 @@
   - Мгновенный поиск и фильтрация чатов по названию и `@username` (`/`);
   - Отображение статуса набора текста («Собеседник печатает...») в реальном времени;
   - Цветовое форматирование Telegram Entities (Bold, Italic, Monospace Code, URLs, Mentions, Spoilers);
+  - Цветные превью изображений высокого разрешения прямо в чате (Unicode Half-Block `▀` pixel art);
   - Индикаторы медиа-вложений (фото, видео, документы, голосовые, стикеры, опросы);
   - Реакции на сообщения (👍, 🔥, ❤️);
   - Бесконечная пагинация истории сообщений вверх (`PageUp` / `Ctrl+U`);
@@ -505,6 +508,52 @@ TUI_THEME=light     # светлая
 
 ---
 
+## 🖼️ Превью изображений в сообщениях
+
+TuiGram отображает цветные превью фотографий прямо в ленте сообщений чата с помощью псевдографики высокого разрешения (Unicode Half-Block `▀` `U+2580`). Каждое знакоместо терминала вмещает 2 вертикальных субпикселя с 24-битными цветами, обеспечивая чёткое пропорциональное изображение 1:1, которое плавно прокручивается вместе с сообщениями и поддерживается всеми терминалами.
+
+Отображение превью включено по умолчанию и настраивается в `.env`:
+
+```env
+# Включение/отключение превью картинок в чате (true/false)
+SHOW_IMAGES=true
+
+# Максимальный размер превью в символах терминала (ширина x высота)
+IMAGE_MAX_WIDTH=36
+IMAGE_MAX_HEIGHT=14
+```
+
+---
+
+## 🌐 Прокси-сервер
+
+TuiGram поддерживает маршрутизацию MTProto-соединений через HTTP (включая HTTPS CONNECT) и SOCKS5/SOCKS4 прокси — как с авторизацией по логину и паролю, так и без неё.
+
+Настройки прокси задаются в `.env` (или через переменные окружения):
+
+**Единый URL:**
+```env
+PROXY_URL=http://127.0.0.1:8080
+PROXY_URL=http://user:password@proxy.example.com:8080
+PROXY_URL=socks5://127.0.0.1:1080
+PROXY_URL=socks5://user:password@127.0.0.1:1080
+```
+
+**Либо отдельными переменными:**
+```env
+PROXY_TYPE=http         # http, https, socks5, socks4
+PROXY_HOST=127.0.0.1
+PROXY_PORT=8080
+PROXY_USERNAME=user     # опционально
+PROXY_PASSWORD=password # опционально
+PROXY_TIMEOUT=10        # таймаут в секундах (по умолчанию 10)
+```
+
+Также в качестве фолбэка поддерживаются стандартные переменные `HTTPS_PROXY`, `HTTP_PROXY` и `ALL_PROXY`.
+Проверить активное состояние прокси можно командой `tuigram paths`.
+
+---
+
 ## 🛠️ Использование через консоль (CLI)
 
 TuiGram можно запускать в режиме консольных утилит (при запуске из клона
@@ -548,6 +597,7 @@ TuiGram/
 │   ├── state.js                 # Реактивное централизованное хранилище состояния
 │   ├── telegram/
 │   │   ├── client.js            # Создание и управление MTProto клиентом
+│   │   ├── socket.js            # Сетевой транспорт MTProto и туннелирование прокси (HTTP/SOCKS5)
 │   │   ├── auth.js              # Интерактивный логин-визард и 2FA
 │   │   ├── dialogs.js           # Получение, фильтрация и поиск диалогов
 │   │   ├── messages.js          # Загрузка истории, отправка, правка, файлы, реакции
@@ -575,6 +625,7 @@ TuiGram/
 │   │   ├── init.js              # tuigram init / paths — настройка и диагностика
 │   │   └── formatters.js        # Консольные форматтеры таблиц и логов
 │   └── utils/
+│       ├── image.js             # Декодирование, масштабирование и Half-Block ANSI рендеринг изображений
 │       ├── storage.js           # Файловые операции и сохранение сессий
 │       └── time.js              # Форматирование времени и дат
 ├── scripts/

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emaxe/tuigram",
-  "version": "1.0.1",
+  "version": "1.2.0",
   "description": "Полнофункциональный TUI & CLI клиент Telegram на Node.js на базе MTProto (teleproto)",
   "type": "module",
   "exports": {
@@ -70,7 +70,9 @@
     "colorette": "^2.0.20",
     "dotenv": "^16.4.7",
     "input": "^1.0.1",
+    "jpeg-js": "^0.4.4",
     "neo-blessed": "^0.2.0",
+    "pngjs": "^7.0.0",
     "teleproto": "^1.229.0"
   }
 }

package/src/cli/init.js

@@ -2,7 +2,7 @@ import fs from "node:fs";
 import path from "node:path";
 import input from "input";
 import { bold, cyan, green, yellow, dim } from "colorette";
-import { config } from "../config.js";
+import { config, formatProxyUrl } from "../config.js";
 
 /** Сколько раз переспрашивать значение, прежде чем сдаться. */
 const MAX_ATTEMPTS = 3;
@@ -193,5 +193,6 @@ export function cmdPaths() {
     console.log(`  Сессия:          ${config.sessionPath} ${sessionExists ? green("(есть)") : dim("(нет)")}`);
     console.log(`  Загрузки:        ${config.downloadsDir}`);
     console.log(`  Ключи API:       ${config.apiId && config.apiHash ? green("заданы") : yellow("не заданы — запустите tuigram init")}`);
+    console.log(`  Прокси:          ${config.proxy ? green(formatProxyUrl(config.proxy)) : dim("не используется")}`);
     console.log("");
 }

package/src/config.js

@@ -110,6 +110,129 @@ function readVersion() {
     }
 }
 
+/**
+ * @typedef {Object} ProxyConfig
+ * @property {"http"|"https"|"socks5"|"socks4"} type - Протокол прокси
+ * @property {string} host - Адрес сервера прокси
+ * @property {number} port - Порт сервера прокси
+ * @property {string} [username] - Логин пользователя
+ * @property {string} [password] - Пароль пользователя
+ * @property {number} [timeout] - Таймаут в секундах
+ * @property {string} ip - Хост прокси (для совместимости с MTProto)
+ * @property {4|5} [socksType] - Тип SOCKS-прокси
+ * @property {boolean} [http] - Флаг HTTP-прокси
+ */
+
+/**
+ * Нормализует тип прокси из строки протокола.
+ * @param {string} [raw]
+ * @returns {"http"|"https"|"socks5"|"socks4"}
+ */
+function normalizeProxyType(raw) {
+    const clean = String(raw || "").toLowerCase().replace(/:$/, "").trim();
+    if (clean === "https") return "https";
+    if (clean === "socks4" || clean === "socks4a") return "socks4";
+    if (clean === "socks5" || clean === "socks5h" || clean === "socks") return "socks5";
+    return "http";
+}
+
+/**
+ * Разбирает параметры прокси из переменных окружения или переданного объекта.
+ * Поддерживает URL-формат (PROXY_URL, HTTPS_PROXY, HTTP_PROXY, ALL_PROXY)
+ * и отдельные переменные (PROXY_TYPE, PROXY_HOST, PROXY_PORT, PROXY_USERNAME, PROXY_PASSWORD).
+ * @param {Record<string, string|undefined>} [env=process.env]
+ * @returns {ProxyConfig|null}
+ */
+export function parseProxyConfig(env = process.env) {
+    const rawUrl = env.PROXY_URL || env.proxy_url || (!env.PROXY_HOST && !env.PROXY_IP && !env.proxy_host && !env.proxy_ip
+        ? (env.HTTPS_PROXY || env.https_proxy || env.HTTP_PROXY || env.http_proxy || env.ALL_PROXY || env.all_proxy)
+        : undefined);
+
+    let type = "http";
+    let host = "";
+    let port = 0;
+    let username = "";
+    let password = "";
+
+    if (rawUrl && typeof rawUrl === "string" && rawUrl.trim()) {
+        let urlStr = rawUrl.trim();
+        // Добавляем схему по умолчанию, если передан host:port без префикса
+        if (!/^[a-zA-Z0-9+-.]+:\/\//.test(urlStr)) {
+            const defaultScheme = (env.PROXY_TYPE || "http").toLowerCase().replace(/:$/, "");
+            urlStr = `${defaultScheme}://${urlStr}`;
+        }
+
+        try {
+            const parsed = new URL(urlStr);
+            type = normalizeProxyType(parsed.protocol);
+            host = parsed.hostname.replace(/^\[(.*)\]$/, "$1");
+            port = parsed.port ? parseInt(parsed.port, 10) : (type === "https" ? 443 : (type.startsWith("socks") ? 1080 : 8080));
+            if (parsed.username) username = decodeURIComponent(parsed.username);
+            if (parsed.password) password = decodeURIComponent(parsed.password);
+        } catch {
+            return null;
+        }
+    } else if (env.PROXY_HOST || env.PROXY_IP) {
+        type = normalizeProxyType(env.PROXY_TYPE || "http");
+        host = String(env.PROXY_HOST || env.PROXY_IP).trim();
+        const defaultPort = type === "https" ? 443 : (type.startsWith("socks") ? 1080 : 8080);
+        port = env.PROXY_PORT ? parseInt(String(env.PROXY_PORT).trim(), 10) : defaultPort;
+        username = String(env.PROXY_USERNAME || env.PROXY_USER || "").trim();
+        password = String(env.PROXY_PASSWORD || env.PROXY_PASS || "").trim();
+    } else {
+        return null;
+    }
+
+    if (!host || !port || isNaN(port) || port <= 0 || port > 65535) {
+        return null;
+    }
+
+    const rawTimeout = env.PROXY_TIMEOUT ? parseInt(String(env.PROXY_TIMEOUT).trim(), 10) : 10;
+    const timeout = isNaN(rawTimeout) || rawTimeout <= 0 ? 10 : rawTimeout;
+
+    /** @type {ProxyConfig} */
+    const result = {
+        type,
+        host,
+        port,
+        ip: host,
+        timeout,
+    };
+
+    if (username) result.username = username;
+    if (password) result.password = password;
+
+    if (type === "socks5") {
+        result.socksType = 5;
+    } else if (type === "socks4") {
+        result.socksType = 4;
+    } else {
+        result.http = true;
+    }
+
+    return result;
+}
+
+/**
+ * Форматирует конфигурацию прокси в строку для вывода в терминал.
+ * Пароль маскируется звездочками в целях безопасности.
+ * @param {ProxyConfig|null} proxy
+ * @returns {string}
+ */
+export function formatProxyUrl(proxy) {
+    if (!proxy) return "не используется";
+
+    let auth = "";
+    if (proxy.username) {
+        auth = proxy.password
+            ? `${encodeURIComponent(proxy.username)}:***@`
+            : `${encodeURIComponent(proxy.username)}@`;
+    }
+
+    const host = proxy.host.includes(":") ? `[${proxy.host}]` : proxy.host;
+    return `${proxy.type}://${auth}${host}:${proxy.port}`;
+}
+
 export const config = {
     packageRoot,
     /** @deprecated оставлено для обратной совместимости, равно packageRoot */
@@ -128,6 +251,11 @@ export const config = {
     theme: process.env.TUI_THEME || "default",
     autoScroll: String(process.env.AUTO_SCROLL || "true").toLowerCase() === "true",
     showTyping: String(process.env.SHOW_TYPING || "true").toLowerCase() === "true",
+    showImages: String(process.env.SHOW_IMAGES || "true").toLowerCase() !== "false",
+    imageMaxWidth: parseInt(process.env.IMAGE_MAX_WIDTH || "36", 10) || 36,
+    imageMaxHeight: parseInt(process.env.IMAGE_MAX_HEIGHT || "14", 10) || 14,
+
+    proxy: parseProxyConfig(),
 
     /**
      * Путь к файлу сессии.

package/src/state.js

@@ -140,7 +140,7 @@ class AppState extends EventEmitter {
         combined.sort((a, b) => (a.date || 0) - (b.date || 0) || (a.id - b.id));
 
         this.messagesByChat.set(chatId, combined);
-        this.emit("messages_updated", { chatId, messages: combined, isPrepend: prepend });
+        this.emit("messages_updated", { chatId, messages: combined, isPrepend: prepend, isUpdate: false });
     }
 
     /**
@@ -181,7 +181,7 @@ class AppState extends EventEmitter {
             this.emit("dialogs_updated", this.getVisibleDialogs());
         }
 
-        this.emit("messages_updated", { chatId, messages: list, isPrepend: false });
+        this.emit("messages_updated", { chatId, messages: list, isPrepend: false, isNewMessage: true });
     }
 
     /**
@@ -194,7 +194,7 @@ class AppState extends EventEmitter {
         const index = list.findIndex((m) => m.id === updatedMessage.id);
         if (index !== -1) {
             list[index] = { ...list[index], ...updatedMessage };
-            this.emit("messages_updated", { chatId, messages: list, isPrepend: false });
+            this.emit("messages_updated", { chatId, messages: list, isPrepend: false, isUpdate: true });
         }
     }
 
@@ -208,7 +208,7 @@ class AppState extends EventEmitter {
         const idSet = new Set(deletedIds);
         const filtered = list.filter((m) => !idSet.has(m.id));
         this.messagesByChat.set(chatId, filtered);
-        this.emit("messages_updated", { chatId, messages: filtered, isPrepend: false });
+        this.emit("messages_updated", { chatId, messages: filtered, isPrepend: false, isUpdate: true });
     }
 
     /**

package/src/telegram/client.js

@@ -4,6 +4,7 @@ import { StringSession } from "teleproto/sessions/index.js";
 import { Logger, LogLevel } from "teleproto/extensions/Logger.js";
 import { config } from "../config.js";
 import { saveSessionFile, readFileSafe } from "../utils/storage.js";
+import { TuiGramNetSockets } from "./socket.js";
 
 /**
  * Читает сохранённую строку сессии.
@@ -42,17 +43,24 @@ export function clearSession() {
 export function buildClient(sessionString = readSession()) {
     config.assertCredentials();
 
+    const clientParams = {
+        connectionRetries: 10,
+        autoReconnect: true,
+        retryDelay: 1500,
+        baseLogger: new Logger(LogLevel.ERROR),
+        useWSS: false,
+    };
+
+    if (config.proxy) {
+        clientParams.proxy = config.proxy;
+        clientParams.networkSocket = TuiGramNetSockets;
+    }
+
     const client = new TelegramClient(
         new StringSession(sessionString),
         config.apiId,
         config.apiHash,
-        {
-            connectionRetries: 10,
-            autoReconnect: true,
-            retryDelay: 1500,
-            baseLogger: new Logger(LogLevel.ERROR),
-            useWSS: false,
-        }
+        clientParams
     );
 
     return client;

package/src/telegram/messages.js

@@ -1,6 +1,8 @@
 import { Api, errors } from "teleproto";
 import { idToString, toMarkedId, getEntityDisplayName, entityCache, resolveEntity } from "./entities.js";
 import { describeMedia } from "./formatter.js";
+import { config } from "../config.js";
+import { renderStrippedThumbnail, renderImageBuffer } from "../utils/image.js";
 
 const { FloodWaitError } = errors;
 
@@ -38,6 +40,27 @@ export function normalizeMessage(message) {
         }
     }
 
+    // Извлечение и рендеринг PhotoStrippedSize в псевдографику
+    let imagePreview = null;
+    if (config.showImages && message.media) {
+        const media = message.media;
+        const photo = media.photo;
+        const doc = media.document;
+        const sizes = photo?.sizes || doc?.thumbs || [];
+        const stripped = sizes.find((s) => s?.className === "PhotoStrippedSize" || s?.type === "i" || (s?.bytes && s.bytes.length > 0));
+
+        if (stripped?.bytes) {
+            const cacheKey = photo?.id
+                ? `photo_${photo.id}`
+                : (doc?.id ? `doc_${doc.id}` : `msg_${message.id}`);
+            imagePreview = renderStrippedThumbnail(stripped.bytes, {
+                maxWidth: config.imageMaxWidth,
+                maxHeight: config.imageMaxHeight,
+                cacheKey,
+            }) || null;
+        }
+    }
+
     return {
         id: message.id,
         date: message.date ? message.date * 1000 : Date.now(),
@@ -53,6 +76,7 @@ export function normalizeMessage(message) {
         forwards: message.forwards || null,
         media: message.media || null,
         mediaDescription: describeMedia(message.media),
+        imagePreview,
         entities: message.entities || [],
         reactions,
         rawMessage: message,
@@ -263,3 +287,37 @@ export async function markAsRead(client, rawPeer, maxId = 0) {
         // Игнорируем незначительные сетевые ошибки прочтения
     }
 }
+
+/**
+ * Асинхронно загружает и декодирует превью изображения сообщения через MTProto.
+ * @param {import("teleproto").TelegramClient} client
+ * @param {object} rawMessage
+ * @param {object} [options]
+ * @param {number} [options.maxWidth]
+ * @param {number} [options.maxHeight]
+ * @returns {Promise<string>}
+ */
+export async function loadMessageImagePreview(client, rawMessage, { maxWidth = config.imageMaxWidth, maxHeight = config.imageMaxHeight } = {}) {
+    if (!rawMessage?.media) return "";
+    const media = rawMessage.media;
+    const isPhoto = media.className === "MessageMediaPhoto";
+    const isDoc = media.className === "MessageMediaDocument";
+    if (!isPhoto && !isDoc) return "";
+
+    const cacheKey = isPhoto
+        ? `photo_full_${media.photo?.id || rawMessage.id}`
+        : `doc_full_${media.document?.id || rawMessage.id}`;
+
+    try {
+        const thumbBuf = await client.downloadMedia(media, { thumb: 1 });
+        if (!thumbBuf || thumbBuf.length === 0) return "";
+        return renderImageBuffer(thumbBuf, {
+            maxWidth,
+            maxHeight,
+            cacheKey,
+        });
+    } catch {
+        return "";
+    }
+}
+