@emaxe/tuigram 1.0.0

package/src/ui/components/statusBar.js

@@ -0,0 +1,64 @@
+import blessed from "neo-blessed";
+import { fg } from "../theme.js";
+
+/**
+ * Создаёт нижнюю строку состояния (Status Bar) с подсказками и временными тостами.
+ * @param {blessed.Widgets.Screen} screen
+ * @param {object} theme
+ * @returns {blessed.Widgets.BoxElement & { showMessage: (text: string, type?: string, duration?: number) => void }}
+ */
+export function createStatusBar(screen, theme) {
+    const statusBar = blessed.box({
+        parent: screen,
+        bottom: 0,
+        left: 0,
+        width: "100%",
+        height: 1,
+        tags: true,
+        style: {
+            bg: theme.status.bg,
+            fg: theme.status.fg,
+        },
+    });
+
+    let currentTimeout = null;
+
+    const key = (label) => `{bold}${fg(theme.accent, label)}{/bold}`;
+    const defaultHints =
+        ` ${key("[Tab]")} Панель ${fg(theme.dim, "│")} ${key("[Enter]")} Выбрать/Отправить ` +
+        `${fg(theme.dim, "│")} ${key("[1-6]")} Вкладки ${fg(theme.dim, "│")} ${key("[/]")} Поиск ` +
+        `${fg(theme.dim, "│")} ${key("[F1]")} Помощь ${fg(theme.dim, "│")} ${key("[Ctrl+A]")} Действия ` +
+        `${fg(theme.dim, "│")} ${key("[Ctrl+P]")} Инфо ${fg(theme.dim, "│")} ${key("[Ctrl+Q]")} Выход`;
+
+    statusBar.setContent(defaultHints);
+
+    /**
+     * Показывает временное статусное сообщение (тост).
+     * @param {string} text
+     * @param {"info"|"success"|"warning"|"error"} [type="info"]
+     * @param {number} [duration=4000]
+     */
+    statusBar.showMessage = function (text, type = "info", duration = 4000) {
+        if (currentTimeout) {
+            clearTimeout(currentTimeout);
+        }
+
+        const palette = {
+            info: [theme.info, "ℹ"],
+            success: [theme.success, "✓"],
+            warning: [theme.warning, "⚠️"],
+            error: [theme.error, "✕"],
+        };
+        const [color, icon] = palette[type] || palette.info;
+
+        statusBar.setContent(` ${fg(color, `${icon} ${text}`)}`);
+        screen.render();
+
+        currentTimeout = setTimeout(() => {
+            statusBar.setContent(defaultHints);
+            screen.render();
+        }, duration);
+    };
+
+    return statusBar;
+}

package/src/ui/screen.js

@@ -0,0 +1,60 @@
+import blessed from "neo-blessed";
+
+/**
+ * Глобальные сочетания, которые должны работать даже когда поле ввода или строка
+ * поиска перехватили клавиатуру (blessed выставляет screen.grabKeys = true и
+ * перестаёт рассылать screen-события всему, чего нет в ignoreLocked).
+ */
+export const GLOBAL_KEYS = [
+    "C-c",
+    "C-q",
+    "tab",
+    "S-tab",
+    "f1",
+    "C-o",
+    "C-r",
+    "C-e",
+    "C-p",
+    // escape — чтобы можно было прервать отправку файла из любого места
+    "escape",
+];
+
+/**
+ * Создаёт и настраивает главный экран терминального интерфейса.
+ * @param {object} [options]
+ * @param {object} [options.theme] активная тема (для фона экрана)
+ * @param {() => void} [options.onExit] вызывается перед завершением процесса по Ctrl+C
+ * @returns {blessed.Widgets.Screen}
+ */
+export function createScreen({ theme, onExit } = {}) {
+    const screen = blessed.screen({
+        smartCSR: true,
+        title: "TuiGram - Telegram Terminal Client",
+        fullUnicode: true,
+        dockBorders: true,
+        cursor: {
+            synthetic: true,
+            blink: true,
+            shape: "line",
+        },
+        style: {
+            bg: theme?.bg ?? "black",
+            fg: theme?.fg ?? "white",
+        }
+    });
+
+    screen.ignoreLocked = [...GLOBAL_KEYS];
+
+    // Обработка закрытия терминала или аварийного прерывания
+    screen.key(["C-c"], () => {
+        try {
+            onExit?.();
+        } catch {
+            // Выходим в любом случае
+        }
+        screen.destroy();
+        process.exit(0);
+    });
+
+    return screen;
+}

package/src/ui/theme.js

@@ -0,0 +1,223 @@
+/**
+ * Цветовые схемы и стили элементов интерфейса TuiGram.
+ *
+ * Все цвета заданы hex-значениями намеренно: именованные ("blue", "cyan")
+ * занимают индексы 0-15, которые тема терминала перекрашивает как хочет —
+ * из-за этого синий фон рисовался бирюзовым, а серый текст пропадал.
+ *
+ * Важно: blessed сам сводит hex к ближайшему цвету xterm-256 и иногда попадает
+ * в те же индексы 0-15. Поэтому значения подобраны так, чтобы после конверсии
+ * индекс был >= 16 — это проверяется тестом в test/unit.test.js.
+ */
+
+/**
+ * Собирает тему из плоской палитры, чтобы контраст задавался в одном месте.
+ * @param {object} p палитра
+ * @returns {object} тема
+ */
+function buildTheme(p) {
+    return {
+        name: p.name,
+        bg: p.bg,
+        fg: p.fg,
+        surface: p.surface,
+        surfaceHigh: p.surfaceHigh,
+
+        // Семантика — для компонентов, которым нужен цвет «по смыслу»
+        accent: p.accent,
+        onAccent: p.onAccent,
+        muted: p.muted,
+        dim: p.dim,
+        success: p.green,
+        warning: p.yellow,
+        error: p.red,
+        info: p.cyan,
+
+        header: {
+            bg: p.surface,
+            fg: p.fgBright,
+            bold: true,
+        },
+        borders: {
+            fg: p.border,
+            focusFg: p.accent,
+        },
+        chatList: {
+            bg: p.bg,
+            fg: p.fg,
+            selectedBg: p.surfaceHigh,
+            selectedFg: p.fgBright,
+            itemHoverBg: p.surface,
+            itemMuted: p.dim,
+            itemUnreadBg: p.accent,
+            itemUnreadFg: p.onAccent,
+            pinnedFg: p.yellow,
+            previewFg: p.muted,
+            timeFg: p.dim,
+        },
+        tabs: {
+            bg: p.bg,
+            fg: p.muted,
+            activeBg: p.accent,
+            activeFg: p.onAccent,
+        },
+        chatView: {
+            bg: p.bg,
+            fg: p.fg,
+            incomingName: p.cyan,
+            outgoingName: p.green,
+            time: p.dim,
+            dateDivider: p.yellow,
+            replyBorder: p.muted,
+            systemMsg: p.yellow,
+            mediaFg: p.magenta,
+            reactionFg: p.yellow,
+        },
+        input: {
+            bg: p.bg,
+            fg: p.fgBright,
+            contextBg: p.surface,
+            contextFg: p.muted,
+            replyBg: p.cyan,
+            replyFg: p.onAccent,
+            editBg: p.yellow,
+            editFg: p.onAccent,
+        },
+        modal: {
+            bg: p.surface,
+            fg: p.fgBright,
+            borderFg: p.accent,
+            selectedBg: p.accent,
+            selectedFg: p.onAccent,
+            labelFg: p.fg,
+            hintFg: p.muted,
+            inputBg: p.bg,
+            inputFg: p.fgBright,
+            inputFocusBg: p.surfaceHigh,
+            inputFocusFg: p.fgBright,
+            buttonBg: p.green,
+            buttonFg: p.onAccent,
+            dangerBg: p.red,
+            dangerFg: p.onDanger,
+            neutralBg: p.surfaceHigh,
+            neutralFg: p.fg,
+            buttonFocusBg: p.accent,
+            buttonFocusFg: p.onAccent,
+        },
+        picker: {
+            // filemanager сам красит элементы в light-blue/light-cyan —
+            // эти значения подставляются вместо них (см. filePickerModal.js)
+            dirFg: p.accent,
+            fileFg: p.fgBright,
+            linkFg: p.cyan,
+        },
+        search: {
+            bg: p.bg,
+            fg: p.yellow,
+            placeholderFg: p.dim,
+        },
+        scrollbar: {
+            bg: p.border,
+            fg: p.accent,
+        },
+        status: {
+            bg: p.bg,
+            fg: p.muted,
+            online: p.green,
+            connecting: p.yellow,
+            offline: p.red,
+        },
+    };
+}
+
+export const themes = {
+    default: buildTheme({
+        name: "Default Dark",
+        bg: "#16161e",
+        surface: "#1f2335",
+        surfaceHigh: "#2f3549",
+        border: "#3b4261",
+        fg: "#a9b1d6",
+        fgBright: "#c0caf5",
+        muted: "#8288a6",
+        dim: "#6874a0",
+        accent: "#7aa2f7",
+        onAccent: "#16161e",
+        onDanger: "#16161e",
+        cyan: "#7dcfff",
+        green: "#9ece6a",
+        yellow: "#e0af68",
+        red: "#f7768e",
+        magenta: "#bb9af7",
+    }),
+
+    nord: buildTheme({
+        name: "Nord",
+        bg: "#2e3440",
+        surface: "#3b4252",
+        surfaceHigh: "#434c5e",
+        border: "#4c566a",
+        fg: "#d8dee9",
+        fgBright: "#eceff4",
+        muted: "#8b98b0",
+        dim: "#7e879b",
+        accent: "#88c0d0",
+        onAccent: "#2e3440",
+        onDanger: "#2e3440",
+        cyan: "#8fbcbb",
+        green: "#a3be8c",
+        yellow: "#ebcb8b",
+        red: "#d07a83",
+        magenta: "#b48ead",
+    }),
+
+    light: buildTheme({
+        name: "Light",
+        bg: "#f5f6f8",
+        surface: "#eceff4",
+        surfaceHigh: "#d8dee9",
+        border: "#c0c5ce",
+        fg: "#3b4252",
+        fgBright: "#2e3440",
+        muted: "#5f6672",
+        dim: "#6f7788",
+        accent: "#2d6df6",
+        onAccent: "#f5f6f8",
+        onDanger: "#f5f6f8",
+        cyan: "#0b7285",
+        green: "#2f7d32",
+        yellow: "#a16207",
+        red: "#c02c38",
+        magenta: "#7048b6",
+    }),
+};
+
+/**
+ * Оборачивает текст в цветовой тег blessed.
+ * @param {string} color hex или именованный цвет
+ * @param {string} text
+ * @returns {string}
+ */
+export function fg(color, text) {
+    return `{${color}-fg}${text}{/${color}-fg}`;
+}
+
+/**
+ * Оборачивает текст в тег фона с явным цветом текста.
+ * @param {string} bgColor
+ * @param {string} fgColor
+ * @param {string} text
+ * @returns {string}
+ */
+export function badge(bgColor, fgColor, text) {
+    return `{${bgColor}-bg}{${fgColor}-fg}${text}{/${fgColor}-fg}{/${bgColor}-bg}`;
+}
+
+/**
+ * Получает активную тему по её названию из конфигурации.
+ * @param {string} themeName
+ * @returns {typeof themes.default}
+ */
+export function getTheme(themeName = "default") {
+    return themes[themeName] || themes.default;
+}

package/src/utils/commands.js

@@ -0,0 +1,40 @@
+/**
+ * Разбор аргументов слэш-команд TUI.
+ */
+
+/**
+ * Разбирает аргументы `/sendfile`.
+ *
+ * Формат: `путь [| путь ...] [-- подпись]`
+ * Разделитель путей — `|`, подпись отделяется первым ` -- `.
+ * Всё после первого ` -- ` считается подписью целиком, поэтому подпись
+ * сама может содержать двойное тире.
+ *
+ * @param {string|string[]} rawArgs
+ * @returns {{ paths: string[], caption: string }}
+ */
+export function parseSendFileArgs(rawArgs) {
+    const raw = (Array.isArray(rawArgs) ? rawArgs.join(" ") : String(rawArgs ?? "")).trim();
+    if (!raw) return { paths: [], caption: "" };
+
+    let pathsPart = raw;
+    let caption = "";
+
+    const separator = raw.match(/(^|\s)--(\s|$)/);
+    if (separator) {
+        pathsPart = raw.slice(0, separator.index);
+        caption = raw.slice(separator.index + separator[0].length).trim();
+        // Разделитель в начале строки: путей нет вовсе
+        if (separator[1] === "") {
+            pathsPart = "";
+            caption = raw.slice(separator[0].length - (separator[2] === "" ? 0 : 1)).trim();
+        }
+    }
+
+    const paths = pathsPart
+        .split("|")
+        .map((part) => part.trim())
+        .filter(Boolean);
+
+    return { paths, caption };
+}

package/src/utils/storage.js

@@ -0,0 +1,177 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+
+/**
+ * Создаёт директорию, если она ещё не существует.
+ * @param {string} dirPath 
+ */
+export function ensureDir(dirPath) {
+    if (!fs.existsSync(dirPath)) {
+        fs.mkdirSync(dirPath, { recursive: true });
+    }
+}
+
+/**
+ * Безопасно читает текстовый файл.
+ * @param {string} filePath 
+ * @param {string} [defaultValue=""]
+ * @returns {string}
+ */
+export function readFileSafe(filePath, defaultValue = "") {
+    try {
+        if (!fs.existsSync(filePath)) return defaultValue;
+        return fs.readFileSync(filePath, "utf8");
+    } catch {
+        return defaultValue;
+    }
+}
+
+/**
+ * Записывает файл, создавая родительские папки при необходимости.
+ * @param {string} filePath 
+ * @param {string} content 
+ * @param {object} [options]
+ */
+export function writeFileSafe(filePath, content, options = {}) {
+    const dir = path.dirname(filePath);
+    ensureDir(dir);
+    fs.writeFileSync(filePath, content, { encoding: "utf8", ...options });
+}
+
+/**
+ * Сохраняет строку сессии Telegram с правами 0600 (только для владельца).
+ * @param {string} filePath 
+ * @param {string} sessionString 
+ */
+export function saveSessionFile(filePath, sessionString) {
+    const dir = path.dirname(filePath);
+    ensureDir(dir);
+    fs.writeFileSync(filePath, sessionString.trim(), { encoding: "utf8", mode: 0o600 });
+}
+
+/**
+ * Читает JSON-файл или возвращает значение по умолчанию при ошибке.
+ * @template T
+ * @param {string} filePath 
+ * @param {T} [defaultValue=null]
+ * @returns {T}
+ */
+export function readJson(filePath, defaultValue = null) {
+    try {
+        if (!fs.existsSync(filePath)) return defaultValue;
+        const text = fs.readFileSync(filePath, "utf8");
+        return JSON.parse(text);
+    } catch {
+        return defaultValue;
+    }
+}
+
+/**
+ * Записывает объект в JSON-файл.
+ * @param {string} filePath 
+ * @param {unknown} data 
+ * @param {boolean} [pretty=true]
+ */
+export function writeJson(filePath, data, pretty = true) {
+    const dir = path.dirname(filePath);
+    ensureDir(dir);
+    const text = JSON.stringify(data, null, pretty ? 2 : 0);
+    fs.writeFileSync(filePath, text, "utf8");
+}
+
+/** Расширения, которые teleproto отправляет как сжатое фото (см. Utils.isImage). */
+const PHOTO_EXTENSIONS = new Set([".png", ".jpg", ".jpeg"]);
+/** Расширения, которые Telegram показывает как видео. */
+const VIDEO_EXTENSIONS = new Set([".mp4", ".mov", ".mkv", ".avi", ".webm", ".m4v", ".3gp"]);
+
+/**
+ * Приводит введённый пользователем путь к абсолютному:
+ * снимает обрамляющие кавычки, shell-экранирование (перетаскивание файла
+ * в терминал) и раскрывает "~".
+ * @param {string} raw
+ * @returns {string} абсолютный путь или "" для пустого ввода
+ */
+export function resolveLocalPath(raw) {
+    let value = String(raw ?? "").trim();
+    if (!value) return "";
+
+    const quoted =
+        (value.startsWith('"') && value.endsWith('"')) ||
+        (value.startsWith("'") && value.endsWith("'"));
+
+    if (quoted && value.length >= 2) {
+        value = value.slice(1, -1);
+    } else {
+        // Снимаем экранирование только тех символов, которые экранирует shell,
+        // чтобы не покалечить windows-путь вида C:\Users\name
+        value = value.replace(/\\([ ()'"&!$`;|<>*?\[\]{}~#])/g, "$1");
+    }
+
+    value = value.trim();
+    if (!value) return "";
+
+    if (value === "~") {
+        value = os.homedir();
+    } else if (value.startsWith("~/") || value.startsWith("~\\")) {
+        value = path.join(os.homedir(), value.slice(2));
+    }
+
+    return path.resolve(value);
+}
+
+/**
+ * Определяет, чем Telegram покажет файл: фото, видео или документом.
+ * @param {string} filePath
+ * @returns {"photo"|"video"|"document"}
+ */
+export function detectFileKind(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    if (PHOTO_EXTENSIONS.has(ext)) return "photo";
+    if (VIDEO_EXTENSIONS.has(ext)) return "video";
+    return "document";
+}
+
+/**
+ * Проверяет локальный файл перед отправкой и возвращает понятную ошибку
+ * вместо сетевой. Единая точка валидации для TUI, слэш-команд и CLI.
+ * @param {string} raw путь в любом виде (с "~", кавычками, экранированием)
+ * @returns {{ ok: boolean, filePath: string, name?: string, size?: number, kind?: string, error?: string }}
+ */
+export function inspectLocalFile(raw) {
+    const filePath = resolveLocalPath(raw);
+    if (!filePath) {
+        return { ok: false, filePath: "", error: "Не указан путь к файлу" };
+    }
+
+    let stat;
+    try {
+        stat = fs.statSync(filePath);
+    } catch {
+        return { ok: false, filePath, error: `Файл не найден: ${filePath}` };
+    }
+
+    if (stat.isDirectory()) {
+        return { ok: false, filePath, error: `Это папка, а не файл: ${filePath}` };
+    }
+    if (!stat.isFile()) {
+        return { ok: false, filePath, error: `Не обычный файл: ${filePath}` };
+    }
+    if (stat.size === 0) {
+        return { ok: false, filePath, error: `Файл пустой: ${path.basename(filePath)}` };
+    }
+
+    try {
+        fs.accessSync(filePath, fs.constants.R_OK);
+    } catch {
+        return { ok: false, filePath, error: `Нет прав на чтение: ${filePath}` };
+    }
+
+    return {
+        ok: true,
+        filePath,
+        name: path.basename(filePath),
+        size: stat.size,
+        kind: detectFileKind(filePath),
+    };
+}

package/src/utils/time.js

@@ -0,0 +1,132 @@
+/**
+ * Утилиты форматирования дат, времени и размеров данных.
+ */
+
+/**
+ * Преобразует unix-timestamp (секунды или Date) в объект Date.
+ * @param {number|Date|string} time
+ * @returns {Date}
+ */
+export function toDate(time) {
+    if (!time) return new Date();
+    if (time instanceof Date) return time;
+    if (typeof time === "number") {
+        // Если timestamp в секундах (как в Telegram), умножаем на 1000
+        return new Date(time < 1e11 ? time * 1000 : time);
+    }
+    return new Date(time);
+}
+
+/**
+ * Форматирует время для отображения в списке чатов (например, "14:32" или "29 авг").
+ * @param {number|Date|string} time
+ * @returns {string}
+ */
+export function formatChatTime(time) {
+    if (!time) return "";
+    const date = toDate(time);
+    const now = new Date();
+
+    const isToday =
+        date.getDate() === now.getDate() &&
+        date.getMonth() === now.getMonth() &&
+        date.getFullYear() === now.getFullYear();
+
+    if (isToday) {
+        return date.toLocaleTimeString([], { hour: "2-digit", minute: "2-digit", hour12: false });
+    }
+
+    const yesterday = new Date(now);
+    yesterday.setDate(now.getDate() - 1);
+    const isYesterday =
+        date.getDate() === yesterday.getDate() &&
+        date.getMonth() === yesterday.getMonth() &&
+        date.getFullYear() === yesterday.getFullYear();
+
+    if (isYesterday) {
+        return "Вчера";
+    }
+
+    const isSameYear = date.getFullYear() === now.getFullYear();
+    if (isSameYear) {
+        return date.toLocaleDateString("ru-RU", { day: "numeric", month: "short" });
+    }
+
+    return date.toLocaleDateString("ru-RU", { day: "2-digit", month: "2-digit", year: "2-digit" });
+}
+
+/**
+ * Форматирует время для сообщения (HH:MM).
+ * @param {number|Date|string} time
+ * @returns {string}
+ */
+export function formatMessageTime(time) {
+    if (!time) return "";
+    const date = toDate(time);
+    return date.toLocaleTimeString([], { hour: "2-digit", minute: "2-digit", hour12: false });
+}
+
+/**
+ * Форматирует полную дату и время (DD.MM.YYYY HH:MM:SS).
+ * @param {number|Date|string} time
+ * @returns {string}
+ */
+export function formatFullDateTime(time) {
+    if (!time) return "";
+    const date = toDate(time);
+    return date.toLocaleString("ru-RU", {
+        day: "2-digit",
+        month: "2-digit",
+        year: "numeric",
+        hour: "2-digit",
+        minute: "2-digit",
+        second: "2-digit",
+        hour12: false,
+    });
+}
+
+/**
+ * Возвращает строку разделителя даты для ленты сообщений (например "29 августа 2026").
+ * @param {number|Date|string} time
+ * @returns {string}
+ */
+export function formatDateDivider(time) {
+    if (!time) return "";
+    const date = toDate(time);
+    return date.toLocaleDateString("ru-RU", {
+        day: "numeric",
+        month: "long",
+        year: "numeric",
+    });
+}
+
+/**
+ * Форматирует размер файла в человекопонятный вид (KB, MB, GB).
+ * @param {number} bytes
+ * @returns {string}
+ */
+export function formatFileSize(bytes) {
+    if (!bytes || bytes <= 0) return "0 B";
+    const units = ["B", "KB", "MB", "GB", "TB"];
+    const i = Math.floor(Math.log(bytes) / Math.log(1024));
+    const size = (bytes / Math.pow(1024, i)).toFixed(1);
+    return `${size} ${units[i]}`;
+}
+
+/**
+ * Форматирует длительность в секундах (MM:SS или HH:MM:SS).
+ * @param {number} seconds
+ * @returns {string}
+ */
+export function formatDuration(seconds) {
+    if (!seconds) return "0:00";
+    const sec = Math.floor(seconds);
+    const m = Math.floor(sec / 60);
+    const s = sec % 60;
+    if (m < 60) {
+        return `${m}:${s.toString().padStart(2, "0")}`;
+    }
+    const h = Math.floor(m / 60);
+    const remM = m % 60;
+    return `${h}:${remM.toString().padStart(2, "0")}:${s.toString().padStart(2, "0")}`;
+}