@emaxe/tuigram 1.0.0

package/src/cli/formatters.js

@@ -0,0 +1,72 @@
+import { cyan, green, yellow, magenta, gray, bold, blue, red } from "colorette";
+import { formatFullDateTime } from "../utils/time.js";
+
+/**
+ * Форматирует строку диалога для консольного вывода таблицы.
+ * @param {object} d
+ * @returns {string}
+ */
+export function formatDialogRow(d) {
+    const typeColor =
+        d.type === "channel" ? magenta :
+        d.type === "supergroup" || d.type === "group" ? cyan :
+        d.type === "bot" ? yellow :
+        d.type === "saved" ? green : blue;
+
+    const pin = d.pinned ? "📌 " : "   ";
+    const type = typeColor(`[${d.type.padEnd(10)}]`);
+    const title = bold((d.title || "Без названия").slice(0, 32).padEnd(32));
+    const unread = d.unreadCount > 0 ? green(` (+${d.unreadCount})`) : "";
+    const id = gray(`id=${d.id}`);
+
+    return `${pin}${type} ${title} ${id}${unread}`;
+}
+
+/**
+ * Форматирует сообщение для вывода истории в консоль.
+ * @param {object} m
+ * @returns {string}
+ */
+export function formatHistoryMessage(m) {
+    const time = gray(`[${formatFullDateTime(m.date)}]`);
+    const id = gray(`#${m.id}`);
+    const author = m.out ? green(bold("Вы:")) : cyan(bold(`${m.senderName || "Собеседник"}:`));
+    const text = m.text || (m.mediaDescription ? m.mediaDescription.replace(/\{[a-z0-9\-]+\}/gi, "") : "");
+    const reply = m.replyToMsgId ? gray(` (в ответ на #${m.replyToMsgId})`) : "";
+    const edited = m.editDate ? gray(" (изменено)") : "";
+
+    return `${time} ${id} ${author}${reply} ${text}${edited}`;
+}
+
+/**
+ * Форматирует живое событие для CLI потока.
+ * @param {string} kind
+ * @param {object} data
+ * @returns {string}
+ */
+export function formatStreamEvent(kind, data) {
+    const time = gray(`[${new Date().toLocaleTimeString()}]`);
+    switch (kind) {
+        case "new_message": {
+            const m = data.message;
+            const peer = yellow(`[${data.peerId}]`);
+            const author = m.out ? green("Вы") : cyan(m.senderName || "Собеседник");
+            const text = m.text || "[медиа]";
+            return `${time} ${green("+ НОВОЕ")} ${peer} ${author}: ${text}`;
+        }
+        case "edited_message": {
+            const m = data.message;
+            const peer = yellow(`[${data.peerId}]`);
+            return `${time} ${yellow("~ ИЗМЕНЕНО")} ${peer} #${m.id}: ${m.text}`;
+        }
+        case "deleted_messages": {
+            const peer = yellow(`[${data.peerId}]`);
+            return `${time} ${red("- УДАЛЕНО")} ${peer} IDs: ${data.deletedIds.join(", ")}`;
+        }
+        case "typing": {
+            return `${time} ${gray("✍️ ПЕЧАТАЕТ")} чат: ${data.chatId}`;
+        }
+        default:
+            return `${time} ${gray(kind)}`;
+    }
+}

package/src/cli/init.js

@@ -0,0 +1,197 @@
+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";
+
+/** Сколько раз переспрашивать значение, прежде чем сдаться. */
+const MAX_ATTEMPTS = 3;
+
+/**
+ * Экранирует значение для записи в .env: переносы строк и кавычки
+ * ломают формат, поэтому оборачиваем в кавычки при необходимости.
+ * @param {string} value
+ * @returns {string}
+ */
+export function escapeEnvValue(value) {
+    const clean = String(value ?? "").trim();
+    if (/^[A-Za-z0-9_.\-/]*$/.test(clean)) return clean;
+    return `"${clean.replace(/(["\\])/g, "\\$1").replace(/\n/g, "\\n")}"`;
+}
+
+/**
+ * Обновляет (или добавляет) переменные в тексте .env, сохраняя остальные строки
+ * и комментарии пользователя.
+ * @param {string} original
+ * @param {Record<string, string>} values
+ * @returns {string}
+ */
+export function upsertEnv(original, values) {
+    let text = String(original ?? "");
+    for (const [key, value] of Object.entries(values)) {
+        const line = `${key}=${escapeEnvValue(value)}`;
+        const pattern = new RegExp(`^[ \\t]*${key}[ \\t]*=.*$`, "m");
+        text = pattern.test(text) ? text.replace(pattern, line) : `${text.replace(/\s*$/, "")}\n${line}\n`;
+    }
+    return text.replace(/^\n+/, "");
+}
+
+/** Заголовок, который пишется в свежесозданный конфиг. */
+const HEADER = `# TuiGram — настройки пользователя
+# Ключи API выдаются на https://my.telegram.org (API development tools).
+`;
+
+/** @param {unknown} value @returns {boolean} */
+export const isValidApiId = (value) => /^\d+$/.test(String(value ?? "").trim());
+/** @param {unknown} value @returns {boolean} */
+export const isValidApiHash = (value) => /^[a-f0-9]{32}$/i.test(String(value ?? "").trim());
+
+/**
+ * Записывает ключи в пользовательский .env с правами 0600, сохраняя
+ * остальное содержимое файла.
+ * @param {string} apiId
+ * @param {string} apiHash
+ * @param {string} [targetPath=config.configEnvPath]
+ * @returns {string} путь к записанному файлу
+ */
+export function saveCredentials(apiId, apiHash, targetPath = config.configEnvPath) {
+    if (!isValidApiId(apiId)) throw new Error(`Некорректный api_id: ${apiId}`);
+    if (!isValidApiHash(apiHash)) throw new Error("Некорректный api_hash: ожидается 32 hex-символа");
+
+    fs.mkdirSync(path.dirname(targetPath), { recursive: true });
+
+    let existingText = HEADER;
+    try {
+        existingText = fs.readFileSync(targetPath, "utf8");
+    } catch {
+        // файла ещё нет — пишем с заголовком
+    }
+
+    const text = upsertEnv(existingText, {
+        TELEGRAM_API_ID: String(apiId).trim(),
+        TELEGRAM_API_HASH: String(apiHash).trim()
+    });
+
+    fs.writeFileSync(targetPath, text, { encoding: "utf8", mode: 0o600 });
+    // Если файл уже существовал, mode в writeFileSync игнорируется — выставляем явно.
+    fs.chmodSync(targetPath, 0o600);
+    return targetPath;
+}
+
+/**
+ * Спрашивает значение с валидацией. Отдельно обрабатывает EOF (закрытый stdin,
+ * запуск в CI или из пайпа): без этого цикл переспрашивания молча вырождается
+ * в «успешный» выход без сохранения настроек.
+ * @param {string} label
+ * @param {(value: unknown) => boolean} validate
+ * @param {string} hint
+ * @returns {Promise<string>}
+ */
+async function promptValidated(label, validate, hint) {
+    for (let attempt = 1; attempt <= MAX_ATTEMPTS; attempt++) {
+        const answer = await input.text(label);
+
+        if (answer === undefined || answer === null) {
+            throw new Error(
+                "Ввод недоступен (stdin закрыт). Запустите tuigram init в интерактивном терминале\n" +
+                "  либо задайте ключи без диалога:\n" +
+                "  tuigram init --api-id <ID> --api-hash <HASH>"
+            );
+        }
+
+        const value = String(answer).trim();
+        if (validate(value)) return value;
+
+        if (attempt < MAX_ATTEMPTS) {
+            console.log(yellow(`  ${hint} Попробуйте ещё раз.`));
+        }
+    }
+    throw new Error(`Не удалось получить корректное значение (${MAX_ATTEMPTS} попытки). ${hint}`);
+}
+
+/**
+ * Интерактивная (или неинтерактивная — через флаги) первичная настройка.
+ * @param {Record<string, string|boolean>} [flags]
+ * @returns {Promise<void>}
+ */
+export async function cmdInit(flags = {}) {
+    const flagApiId = flags["api-id"] ?? flags.apiId;
+    const flagApiHash = flags["api-hash"] ?? flags.apiHash;
+
+    // Неинтерактивный режим: оба ключа переданы флагами.
+    if (flagApiId || flagApiHash) {
+        if (!flagApiId || !flagApiHash) {
+            throw new Error("Нужны оба флага сразу: --api-id <ID> --api-hash <HASH>");
+        }
+        const saved = saveCredentials(String(flagApiId), String(flagApiHash));
+        console.log(green(`\n✓ Настройки сохранены: ${saved}`));
+        console.log(dim("  Права доступа: 0600 (только владелец).\n"));
+        return;
+    }
+
+    // Без TTY промис ввода не резолвится вовсе, и процесс молча выходит
+    // с кодом 0, ничего не сохранив. Отсекаем это заранее понятной ошибкой.
+    if (!process.stdin.isTTY) {
+        throw new Error(
+            "Интерактивный ввод недоступен (stdin не подключён к терминалу).\n" +
+            "  Задайте ключи без диалога:\n" +
+            "  tuigram init --api-id <ID> --api-hash <HASH>"
+        );
+    }
+
+    console.log(bold("\n🚀 Настройка TuiGram\n"));
+    console.log(`Файл настроек: ${cyan(config.configEnvPath)}`);
+    console.log(`Данные и сессия: ${cyan(config.dataDir)}\n`);
+    console.log(dim("Ключи API выдаются на https://my.telegram.org → API development tools.\n"));
+
+    if (config.apiId && config.apiHash) {
+        console.log(yellow(`Ключи уже заданы (api_id: ${config.apiId}).`));
+        const overwrite = await input.confirm("Перезаписать их?", { default: false });
+        if (!overwrite) {
+            console.log(dim("\nОтменено, настройки не изменены."));
+            return;
+        }
+        console.log("");
+    }
+
+    const apiId = await promptValidated(
+        "TELEGRAM_API_ID: ",
+        isValidApiId,
+        "api_id — это число, например 1234567."
+    );
+    const apiHash = await promptValidated(
+        "TELEGRAM_API_HASH: ",
+        isValidApiHash,
+        "api_hash — 32 шестнадцатеричных символа."
+    );
+
+    const saved = saveCredentials(apiId, apiHash);
+
+    console.log(green(`\n✓ Настройки сохранены: ${saved}`));
+    console.log(dim("  Права доступа: 0600 (только владелец).\n"));
+    console.log("Следующий шаг — авторизация:");
+    console.log(`  ${bold("tuigram login")}   вход по номеру телефона`);
+    console.log(`  ${bold("tuigram")}         запуск интерфейса\n`);
+}
+
+/**
+ * Печатает актуальные пути и состояние конфигурации — для диагностики.
+ */
+export function cmdPaths() {
+    const sessionExists = fs.existsSync(config.sessionPath);
+    const configExists = fs.existsSync(config.configEnvPath);
+    const localEnv = path.join(config.packageRoot, ".env");
+
+    console.log(bold("\n📂 Пути TuiGram\n"));
+    console.log(`  Версия:          ${config.version}`);
+    console.log(`  Корень пакета:   ${config.packageRoot}`);
+    console.log(`  Настройки:       ${config.configEnvPath} ${configExists ? green("(есть)") : dim("(нет)")}`);
+    if (fs.existsSync(localEnv)) {
+        console.log(`  Локальный .env:  ${localEnv} ${green("(есть, имеет приоритет)")}`);
+    }
+    console.log(`  Данные:          ${config.dataDir}`);
+    console.log(`  Сессия:          ${config.sessionPath} ${sessionExists ? green("(есть)") : dim("(нет)")}`);
+    console.log(`  Загрузки:        ${config.downloadsDir}`);
+    console.log(`  Ключи API:       ${config.apiId && config.apiHash ? green("заданы") : yellow("не заданы — запустите tuigram init")}`);
+    console.log("");
+}

package/src/config.js

@@ -0,0 +1,158 @@
+import path from "node:path";
+import fs from "node:fs";
+import os from "node:os";
+import { fileURLToPath } from "node:url";
+import dotenv from "dotenv";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+/** Корень пакета (там, где лежит package.json). */
+const packageRoot = path.resolve(__dirname, "..");
+
+/** Имя приложения — используется в путях пользовательских директорий. */
+const APP_DIR_NAME = "tuigram";
+
+/**
+ * Директория пользовательских настроек.
+ * Пакет может быть установлен глобально в системную папку без прав на запись,
+ * поэтому ни настройки, ни сессия внутри самого пакета не хранятся.
+ * @returns {string}
+ */
+function resolveConfigDir() {
+    if (process.env.TUIGRAM_CONFIG_DIR) {
+        return path.resolve(process.env.TUIGRAM_CONFIG_DIR);
+    }
+    if (process.platform === "win32") {
+        const appData = process.env.APPDATA || path.join(os.homedir(), "AppData", "Roaming");
+        return path.join(appData, APP_DIR_NAME);
+    }
+    const xdg = process.env.XDG_CONFIG_HOME || path.join(os.homedir(), ".config");
+    return path.join(xdg, APP_DIR_NAME);
+}
+
+/**
+ * Директория пользовательских данных (сессия, загрузки).
+ * @returns {string}
+ */
+function resolveDataDir() {
+    if (process.env.TUIGRAM_DATA_DIR) {
+        return path.resolve(process.env.TUIGRAM_DATA_DIR);
+    }
+    if (process.env.DATA_DIR) {
+        // Обратная совместимость со старым .env: относительные пути
+        // разрешаются от корня пакета, как было раньше.
+        return path.resolve(packageRoot, process.env.DATA_DIR);
+    }
+    if (process.platform === "win32") {
+        const localAppData = process.env.LOCALAPPDATA || path.join(os.homedir(), "AppData", "Local");
+        return path.join(localAppData, APP_DIR_NAME);
+    }
+    const xdg = process.env.XDG_DATA_HOME || path.join(os.homedir(), ".local", "share");
+    return path.join(xdg, APP_DIR_NAME);
+}
+
+const configDir = resolveConfigDir();
+const configEnvPath = path.join(configDir, ".env");
+
+// Порядок загрузки = приоритет: dotenv не перетирает уже заданные переменные.
+// 1. Переменные окружения процесса (наивысший приоритет — ничего не грузим).
+// 2. .env в корне пакета — рабочий режим при запуске из клона репозитория
+//    (в опубликованный пакет этот файл не попадает, см. "files" в package.json).
+// 3. .env в пользовательской директории настроек — режим установленного CLI.
+const localEnvPath = path.join(packageRoot, ".env");
+if (fs.existsSync(localEnvPath)) {
+    dotenv.config({ path: localEnvPath, quiet: true });
+}
+if (fs.existsSync(configEnvPath)) {
+    dotenv.config({ path: configEnvPath, quiet: true });
+}
+
+const dataDir = resolveDataDir();
+const sessionPath = path.join(dataDir, "session.txt");
+const downloadsDir = path.join(dataDir, "downloads");
+
+/** Путь к сессии в старом формате (внутри пакета) — для одноразовой миграции. */
+const legacySessionPath = path.resolve(packageRoot, "data", "session.txt");
+
+/**
+ * Переносит сессию из старого расположения (`<пакет>/data/session.txt`)
+ * в пользовательскую директорию. Выполняется один раз и молча:
+ * отсутствие прав или файла не должно ломать запуск.
+ * @returns {boolean} true, если сессия была перенесена
+ */
+function migrateLegacySession() {
+    try {
+        if (sessionPath === legacySessionPath) return false;
+        if (!fs.existsSync(legacySessionPath)) return false;
+        if (fs.existsSync(sessionPath)) return false;
+
+        const session = fs.readFileSync(legacySessionPath, "utf8").trim();
+        if (!session) return false;
+
+        fs.mkdirSync(path.dirname(sessionPath), { recursive: true });
+        fs.writeFileSync(sessionPath, session, { encoding: "utf8", mode: 0o600 });
+        return true;
+    } catch {
+        return false;
+    }
+}
+
+/**
+ * Версия из package.json — единственный источник правды для `--version`.
+ * @returns {string}
+ */
+function readVersion() {
+    try {
+        const raw = fs.readFileSync(path.join(packageRoot, "package.json"), "utf8");
+        return JSON.parse(raw).version || "0.0.0";
+    } catch {
+        return "0.0.0";
+    }
+}
+
+export const config = {
+    packageRoot,
+    /** @deprecated оставлено для обратной совместимости, равно packageRoot */
+    rootDir: packageRoot,
+    configDir,
+    configEnvPath,
+    dataDir,
+    sessionPath,
+    downloadsDir,
+    legacySessionPath,
+    version: readVersion(),
+
+    apiId: parseInt(process.env.TELEGRAM_API_ID || "0", 10),
+    apiHash: process.env.TELEGRAM_API_HASH || "",
+
+    theme: process.env.TUI_THEME || "default",
+    autoScroll: String(process.env.AUTO_SCROLL || "true").toLowerCase() === "true",
+    showTyping: String(process.env.SHOW_TYPING || "true").toLowerCase() === "true",
+
+    /**
+     * Путь к файлу сессии.
+     * @returns {string}
+     */
+    getSessionFilePath() {
+        return sessionPath;
+    },
+
+    migrateLegacySession,
+
+    /**
+     * Проверяет наличие ключей API.
+     */
+    assertCredentials() {
+        if (!config.apiId || !config.apiHash) {
+            throw new Error(
+                "Не заданы TELEGRAM_API_ID / TELEGRAM_API_HASH.\n" +
+                "  1. Получите ключи на https://my.telegram.org (API development tools)\n" +
+                "  2. Запустите: tuigram init\n" +
+                `     (ключи будут сохранены в ${configEnvPath})\n` +
+                "  Либо задайте их через переменные окружения TELEGRAM_API_ID и TELEGRAM_API_HASH."
+            );
+        }
+    }
+};
+
+migrateLegacySession();

package/src/index.js

@@ -0,0 +1,172 @@
+#!/usr/bin/env node
+/**
+ * TuiGram — Полнофункциональный TUI & CLI клиент Telegram.
+ */
+import { checkAuthStatus, loginInteractive } from "./telegram/auth.js";
+import { connectClient } from "./telegram/client.js";
+import { startTui } from "./ui/app.js";
+import {
+    cmdLogin,
+    cmdDialogs,
+    cmdHistory,
+    cmdSend,
+    cmdSendFile,
+    cmdListen
+} from "./cli/cliCommands.js";
+import { cmdInit, cmdPaths } from "./cli/init.js";
+import { config } from "./config.js";
+import { red, bold } from "colorette";
+
+/**
+ * Простой парсер аргументов командной строки.
+ * @param {string[]} argv
+ * @returns {{ positional: string[], flags: Record<string, string|boolean> }}
+ */
+function parseArgs(argv) {
+    const positional = [];
+    const flags = {};
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg.startsWith("--")) {
+            const key = arg.slice(2);
+            const next = argv[i + 1];
+            if (next && !next.startsWith("--")) {
+                flags[key] = next;
+                i++;
+            } else {
+                flags[key] = true;
+            }
+        } else if (arg.startsWith("-")) {
+            const key = arg.slice(1);
+            flags[key] = true;
+        } else {
+            positional.push(arg);
+        }
+    }
+    return { positional, flags };
+}
+
+const HELP_TEXT = `
+${bold("🚀 TuiGram — Терминальный клиент Telegram")}
+
+${bold("Запуск TUI (по умолчанию):")}
+  tuigram                        Запустить графический терминальный интерфейс (TUI)
+  tuigram tui                    То же самое
+
+${bold("Настройка:")}
+  tuigram init                   Ввести ключи Telegram API (api_id / api_hash)
+                                 --api-id <ID> --api-hash <HASH>  без диалога
+  tuigram paths                  Показать пути к настройкам, сессии и загрузкам
+
+${bold("Консольные команды (CLI):")}
+  tuigram login                  Авторизация в аккаунте (телефон, код, 2FA)
+  tuigram dialogs [--limit 50]   Список диалогов
+  tuigram history <peer> [--limit 30]
+                                 История сообщений (@username, ID, me)
+  tuigram send <peer> <текст>    Отправить текстовое сообщение
+  tuigram sendfile <peer> <путь> [<путь> ...]
+                                 Отправить файл(ы); несколько путей уходят альбомом
+                                 --caption "текст"  подпись
+                                 --as-file          без сжатия, документом
+  tuigram listen                 Слушать обновления в реальном времени
+
+${bold("Примеры:")}
+  tuigram send me "Привет из TuiGram!"
+  tuigram history @durov --limit 20
+  tuigram sendfile @friend ./document.pdf
+  tuigram sendfile me ~/a.png ~/b.png --caption "Две картинки"
+  tuigram sendfile me ~/photo.png --as-file
+`;
+
+async function main() {
+    const { positional, flags } = parseArgs(process.argv.slice(2));
+
+    if (flags.help || flags.h) {
+        console.log(HELP_TEXT);
+        return;
+    }
+
+    if (flags.version || flags.v) {
+        console.log(`TuiGram v${config.version}`);
+        return;
+    }
+
+    const command = positional[0]?.toLowerCase();
+
+    switch (command) {
+        case "init":
+        case "setup":
+            await cmdInit(flags);
+            process.exit(0);
+            break;
+        case "paths":
+        case "config":
+            cmdPaths();
+            process.exit(0);
+            break;
+        case "login":
+            await cmdLogin();
+            process.exit(0);
+            break;
+        case "dialogs":
+            await cmdDialogs(flags);
+            process.exit(0);
+            break;
+        case "history":
+            await cmdHistory(positional[1], flags);
+            process.exit(0);
+            break;
+        case "send": {
+            const peer = positional[1];
+            const text = positional.slice(2).join(" ");
+            await cmdSend(peer, text, flags);
+            process.exit(0);
+            break;
+        }
+        case "sendfile":
+        case "send-file":
+            await cmdSendFile(positional[1], positional.slice(2), flags);
+            process.exit(0);
+            break;
+        case "listen":
+            await cmdListen();
+            break;
+        case "help":
+            console.log(HELP_TEXT);
+            process.exit(0);
+            break;
+        case "version":
+            console.log(`TuiGram v${config.version}`);
+            process.exit(0);
+            break;
+        case "tui":
+        default: {
+            if (command && command !== "tui") {
+                console.log(red(`\nНеизвестная команда: "${command}"`));
+                console.log(HELP_TEXT);
+                process.exit(1);
+            }
+
+            // Запуск TUI интерфейса
+            let { authorized, me, client } = await checkAuthStatus();
+
+            if (!authorized) {
+                console.log(bold("\n🔑 Сессия не найдена. Требуется авторизация для входа в TuiGram:\n"));
+                me = await loginInteractive();
+                client = await connectClient();
+            }
+
+            if (!client) {
+                client = await connectClient();
+            }
+
+            await startTui(client, me);
+            break;
+        }
+    }
+}
+
+main().catch((err) => {
+    console.error(red(`\nОшибка TuiGram: ${err?.message || err}`));
+    process.exit(1);
+});