tgapi

Paused

App Files Files Community

WalleGriffkinder commited on May 16, 2025

Commit

132b8f7

verified ·

1 Parent(s): 0e4208f

Update server.js

Browse files

Files changed (1) hide show

server.js +129 -314

server.js CHANGED Viewed

@@ -451,7 +451,7 @@ fileRouter.get('/:botToken/getFile', async (req, res) => {
                 }
             }
         }
-        res.json(fileInfo);
     } catch (error) {
         console.error(`Error in /:botToken/getFile for file_id ${file_id}:`, error);
         res.status(500).json({ error: 'Server error processing getFile request.', details: error.message });
@@ -539,27 +539,14 @@ app.use(PROXY_TELEGRAM_PATH_PREFIX, createProxyMiddleware({
 app.get('/', (req, res) => {
   const spaceHost = process.env.SPACE_HOST;
   const baseUrl = req.protocol + '://' + (spaceHost || req.get('host'));
-  const botTokenPh = "<YOUR_BOT_TOKEN>";
-  const fileIdPh = "<FILE_ID>";
-  const relativeFilePathPh = `bot${botTokenPh}/<CATEGORY>/<FILENAME>`; // Used for /file/<path> and deleteFile?file=
-  const linkExpiryPh = "<HOURS>";
-  const encryptedPayloadPh = "<ENCRYPTED_PAYLOAD>";
-  const exampleGetFileResponse = JSON.stringify({
-      ok: true,
-      result: {
-          file_id: "EXAMPLE_FILE_ID",
-          file_unique_id: "EXAMPLE_UNIQUE_ID",
-          file_size: 123456,
-          file_path: `${TELEGRAM_DATA_DIR.replace(/</g, '<').replace(/>/g, '>')}/${relativeFilePathPh.replace(/</g, '<').replace(/>/g, '>')}`,
-          direct_download_link_by_path: `${baseUrl}/file/${relativeFilePathPh}`,
-          delete_link_by_path: `${baseUrl}/file/deleteFile?file=${encodeURIComponent(relativeFilePathPh.replace(/</g, '<').replace(/>/g, '>'))}`,
-          encrypted_download_link_by_path: encryptionKeyBuffer ? `${baseUrl}/file/downloadEncrypted?payload=${encryptedPayloadPh}` : "Encryption disabled",
-          direct_download_link_by_id: `${baseUrl}/file/${botTokenPh}/downloadFile?file_id=${fileIdPh}`,
-          delete_link_by_id: `${baseUrl}/file/${botTokenPh}/deleteById?file_id=${fileIdPh}`,
-          encrypted_download_link_by_id: encryptionKeyBuffer ? `${baseUrl}/file/downloadEncrypted?payload=${encryptedPayloadPh}` : "Encryption disabled"
-      }
-  }, null, 2).replace(/</g, '<').replace(/>/g, '>');
   const htmlDoc = `
   <!DOCTYPE html>
@@ -567,309 +554,138 @@ app.get('/', (req, res) => {
   <head>
       <meta charset="UTF-8">
       <meta name="viewport" content="width=device-width, initial-scale=1.0">
-      <title>API Documentation: Telegram Bot API Proxy & Tools</title>
       <style>
-          body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif; line-height: 1.6; padding: 20px; max-width: 1000px; margin: auto; color: #333; }
-          .container { padding: 0 15px; }
-          h1, h2, h3, h4 { color: #2c3e50; margin-top: 1.5em; margin-bottom: 0.8em; }
-          h1 { text-align: center; margin-bottom: 1em; font-size: 2.2em; }
-          h2 { border-bottom: 2px solid #ecf0f1; padding-bottom: 0.3em; font-size: 1.8em;}
-          h3 { font-size: 1.5em; color: #34495e; }
-          h4 { font-size: 1.2em; color: #7f8c8d; }
-          code { background-color: #ecf0f1; padding: 0.2em 0.4em; margin: 0; font-size: 85%; border-radius: 3px; font-family: "SFMono-Regular", Consolas, "Liberation Mono", Menlo, Courier, monospace; word-break: break-all; }
-          pre { background-color: #2c3e50; color: #ecf0f1; padding: 15px; border-radius: 5px; overflow-x: auto; font-size: 0.9em; }
-          pre code { background-color: transparent; padding: 0; }
-          .endpoint-group { margin-bottom: 30px; padding: 20px; border: 1px solid #bdc3c7; border-radius: 5px; background-color: #fff; box-shadow: 0 2px 4px rgba(0,0,0,0.05); }
-          .endpoint-group h3 { margin-top: 0; border-bottom: 1px solid #ecf0f1; padding-bottom: 0.5em;}
-          .endpoint-group p { margin-bottom: 0.5em; }
-          .endpoint-group strong { color: #2980b9; }
-          .lang-toggle { text-align: center; margin-bottom: 30px; padding: 10px; background-color: #f8f9fa; border-radius: 5px;}
-          .lang-toggle button { padding: 10px 20px; margin: 0 8px; cursor: pointer; border: none; background-color: #e9ecef; color: #495057; border-radius: 4px; font-weight: bold; transition: background-color 0.2s, color 0.2s;}
-          .lang-toggle button.active { background-color: #007bff; color: white; }
           .ru, .en { display: none; }
           .ru.active, .en.active { display: block; }
-          table { width: 100%; border-collapse: collapse; margin: 1.5em 0; box-shadow: 0 1px 3px rgba(0,0,0,0.03); }
-          th, td { border: 1px solid #e0e0e0; padding: 10px 12px; text-align: left; }
-          th { background-color: #f7f9fa; font-weight: 600; color: #555; }
-          td code { font-size: 90%; }
-          .param-table th:first-child { width: 20%; }
-          .param-table th:nth-child(2) { width: 15%; }
-          .param-table th:nth-child(3) { width: 15%; }
-          .param-table th:last-child { width: 50%; }
-          .note { background-color: #e7f3fe; border-left: 4px solid #2196F3; padding: 10px 15px; margin: 1.5em 0; border-radius: 0 4px 4px 0; }
-          .note strong { color: #1e88e5; }
-          .badge { background-color: #2ecc71; color: white; padding: 0.2em 0.6em; border-radius: 10px; font-size: 0.8em; margin-right: 5px; display: inline-block; vertical-align: middle;}
-          .badge-get { background-color: #3498db; }
-          .badge-post { background-color: #2ecc71; }
-          .badge-delete { background-color: #e74c3c; }
-          .endpoint-header { display: flex; align-items: center; margin-bottom: 0.5em; }
-          .endpoint-header .badge { margin-right: 10px; font-weight: bold; padding: 0.3em 0.7em;}
-          .endpoint-header code { font-size: 1.1em; font-weight: bold; }
       </style>
   </head>
   <body>
-      <div class="container">
-          <div class="lang-toggle">
-              <button id="lang-ru-btn" onclick="setLang('ru')">Русский</button>
-              <button id="lang-en-btn" onclick="setLang('en')">English</button>
           </div>
-          <div class="ru">
-              <h1>Документация API: Прокси Telegram Bot API и Инструменты</h1>
-              <p>Этот сервис предоставляет прокси для локального сервера Telegram Bot API, а также набор инструментов для управления файлами и генерации ссылок.</p>
-              <h2>Базовый URL</h2>
-              <p>Все URL, указанные в этой документации, начинаются с этого базового URL:</p>
-              <pre><code>${baseUrl}</code></pre>
-              <h2>1. Прокси Telegram Bot API (Стандартный)</h2>
-              <section class="endpoint-group">
-                  <div class="endpoint-header"><span class="badge badge-get">GET</span><span class="badge badge-post">POST</span><code>${PROXY_TELEGRAM_PATH_PREFIX}/bot${botTokenPh}/{METHOD_NAME}</code></div>
-                  <p><strong>Описание:</strong> Прямое проксирование запросов к вашему локальному серверу Telegram Bot API. Этот эндпоинт возвращает <strong>неизмененный</strong> ответ от Telegram API, обеспечивая полную совместимость со стандартными клиентами Telegram.</p>
-                  <h4>Параметры Path:</h4>
-                  <table class="param-table">
-                      <thead><tr><th>Параметр</th><th>Тип</th><th>Обязательный</th><th>Описание</th></tr></thead>
-                      <tbody>
-                          <tr><td><code>TOKEN</code></td><td>string</td><td>Да</td><td>Токен вашего Telegram бота.</td></tr>
-                          <tr><td><code>METHOD_NAME</code></td><td>string</td><td>Да</td><td>Имя метода Telegram Bot API (например, <code>getMe</code>, <code>sendMessage</code>).</td></tr>
-                      </tbody>
-                  </table>
-                  <p><strong>Пример URL:</strong> <code>${baseUrl}${PROXY_TELEGRAM_PATH_PREFIX}/bot${botTokenPh}/getMe</code></p>
-              </section>
-              <h2>2. Расширенные Инструменты и Операции с Файлами</h2>
-              <section class="endpoint-group">
-                  <div class="endpoint-header"><span class="badge badge-get">GET</span><code>/stats</code></div>
-                  <p><strong>Описание:</strong> Получает статистику использования диска каталогом данных Telegram Bot API.</p>
-                  <h4>Параметры Query:</h4>
-                  <table class="param-table">
-                      <thead><tr><th>Параметр</th><th>Тип</th><th>Обязательный</th><th>Описание</th></tr></thead>
-                      <tbody>
-                          <tr><td><code>run_ttl_now</code></td><td>boolean</td><td>Нет</td><td>Если <code>true</code>, запускает немедленную очистку старых файлов согласно настройке <code>FILES_TTL_HOURS</code>.</td></tr>
-                      </tbody>
-                  </table>
-                  <p><strong>Пример URL:</strong> <code>${baseUrl}/stats</code></p>
-                  <p><strong>Пример URL (с очисткой):</strong> <code>${baseUrl}/stats?run_ttl_now=true</code></p>
-                  <h4>Пример Ответа (JSON):</h4>
-                  <pre><code>${JSON.stringify({ directory: TELEGRAM_DATA_DIR, fileCount: 120, totalSizeBytes: 512000000, totalSizeHuman: "488.28 MB", files_ttl_hours: FILES_TTL_HOURS > 0 ? FILES_TTL_HOURS : "disabled", ttl_cleanup_on_this_request: { message: "Cleanup completed..." } }, null, 2)}</code></pre>
-              </section>
-              <section class="endpoint-group">
-                  <div class="endpoint-header"><span class="badge badge-get">GET</span><code>/file/{TOKEN}/getFile</code></div>
-                  <p><strong>Описание:</strong> Получает информацию о файле от Telegram API (через внутренний вызов <code>/bot{TOKEN}/getFile</code>) и дополняет стандартный ответ Telegram дополнительными ссылками для скачивания и удаления, включая зашифрованные версии с ограниченным сроком действия.</p>
-                  <h4>Параметры Path:</h4>
-                  <table class="param-table">
-                      <thead><tr><th>Параметр</th><th>Тип</th><th>Обязательный</th><th>Описание</th></tr></thead>
-                      <tbody>
-                          <tr><td><code>TOKEN</code></td><td>string</td><td>Да</td><td>Токен вашего Telegram бота.</td></tr>
-                      </tbody>
-                  </table>
-                  <h4>Параметры Query:</h4>
-                  <table class="param-table">
-                      <thead><tr><th>Параметр</th><th>Тип</th><th>Обязательный</th><th>Описание</th></tr></thead>
-                      <tbody>
-                          <tr><td><code>file_id</code></td><td>string</td><td>Да</td><td>Идентификатор файла.</td></tr>
-                          <tr><td><code>link_expiry_hours</code></td><td>integer</td><td>Нет</td><td>Срок действия для генерируемых зашифрованных ссылок в часах. <code>-1</code> для бессрочных. По умолчанию: <code>${DEFAULT_LINK_EXPIRY_HOURS}</code>.</td></tr>
-                      </tbody>
-                  </table>
-                  <p><strong>Пример URL:</strong> <code>${baseUrl}/file/${botTokenPh}/getFile?file_id=${fileIdPh}&link_expiry_hours=2</code></p>
-                  <h4>Пример Ответа (JSON):</h4>
-                  <pre><code>${exampleGetFileResponse}</code></pre>
-              </section>
-              <section class="endpoint-group">
-                  <div class="endpoint-header"><span class="badge badge-get">GET</span><code>/file/list</code></div>
-                  <p><strong>Описание:</strong> Возвращает список файлов, их размеры и общий размер для указанного бота в его директории внутри <code>TELEGRAM_DATA_DIR</code>.</p>
-                  <h4>Параметры Query:</h4>
-                   <table class="param-table">
-                      <thead><tr><th>Параметр</th><th>Тип</th><th>Обязательный</th><th>Описание</th></tr></thead>
-                      <tbody>
-                          <tr><td><code>token</code></td><td>string</td><td>Да</td><td>Токен Telegram бота, для которого нужно получить список файлов.</td></tr>
-                      </tbody>
-                  </table>
-                  <p><strong>Пример URL:</strong> <code>${baseUrl}/file/list?token=${botTokenPh}</code></p>
-              </section>
-              <section class="endpoint-group">
-                  <div class="endpoint-header"><span class="badge badge-get">GET</span><code>/file/{TOKEN}/downloadFile</code></div>
-                  <p><strong>Описание:</strong> Скачивает файл по его ID. Внутренне вызывает <code>getFile</code> для получения пути к файлу.</p>
-                  <h4>Параметры Path:</h4>
-                  <table class="param-table"><thead><tr><th>Параметр</th><th>Тип</th><th>Обязательный</th><th>Описание</th></tr></thead><tbody><tr><td><code>TOKEN</code></td><td>string</td><td>Да</td><td>Токен бота.</td></tr></tbody></table>
-                  <h4>Параметры Query:</h4>
-                  <table class="param-table"><thead><tr><th>Параметр</th><th>Тип</th><th>Обязательный</th><th>Описание</th></tr></thead><tbody><tr><td><code>file_id</code></td><td>string</td><td>Да</td><td>Идентификатор файла.</td></tr></tbody></table>
-                  <p><strong>Пример URL:</strong> <code>${baseUrl}/file/${botTokenPh}/downloadFile?file_id=${fileIdPh}</code></p>
-              </section>
-              <section class="endpoint-group">
-                  <div class="endpoint-header"><span class="badge badge-get">GET</span><code>/file/{RELATIVE_FILE_PATH_WITH_TOKEN}</code></div>
-                  <p><strong>Описание:</strong> Скачивает файл по его полному относительному пути внутри <code>TELEGRAM_DATA_DIR</code>. Путь должен включать директорию с именем токена бота.</p>
-                  <h4>Параметры Path:</h4>
-                  <table class="param-table"><thead><tr><th>Параметр</th><th>Тип</th><th>Обязательный</th><th>Описание</th></tr></thead><tbody><tr><td><code>RELATIVE_FILE_PATH_WITH_TOKEN</code></td><td>string</td><td>Да</td><td>Относительный путь к файлу, например, <code>${relativeFilePathPh}</code>.</td></tr></tbody></table>
-                  <p><strong>Пример URL:</strong> <code>${baseUrl}/file/${relativeFilePathPh}</code></p>
-              </section>
-              <section class="endpoint-group">
-                  <div class="endpoint-header"><span class="badge badge-get">GET</span><code>/file/downloadEncrypted</code></div>
-                  <p><strong>Описание:</strong> Скачивает файл, используя зашифрованную полезную нагрузку (payload), полученную из эндпоинта <code>/file/{TOKEN}/getFile</code>. Проверяет срок действия ссылки.</p>
-                  <h4>Параметры Query:</h4>
-                  <table class="param-table"><thead><tr><th>Параметр</th><th>Тип</th><th>Обязательный</th><th>Описание</th></tr></thead><tbody><tr><td><code>payload</code></td><td>string</td><td>Да</td><td>Зашифрованная строка.</td></tr></tbody></table>
-                  <p><strong>Пример URL:</strong> <code>${baseUrl}/file/downloadEncrypted?payload=${encryptedPayloadPh}</code></p>
-              </section>
-              <section class="endpoint-group">
-                  <div class="endpoint-header"><span class="badge badge-get">GET</span><code>/file/deleteFile</code></div>
-                  <p><strong>Описание:</strong> Удаляет файл по его относительному пути внутри <code>TELEGRAM_DATA_DIR</code>.</p>
-                  <h4>Параметры Query:</h4>
-                  <table class="param-table"><thead><tr><th>Параметр</th><th>Тип</th><th>Обязательный</th><th>Описание</th></tr></thead><tbody><tr><td><code>file</code></td><td>string</td><td>Да</td><td>Относительный путь к файлу, например, <code>${relativeFilePathPh}</code>.</td></tr></tbody></table>
-                  <p><strong>Пример URL:</strong> <code>${baseUrl}/file/deleteFile?file=${encodeURIComponent(relativeFilePathPh.replace(/</g, '<').replace(/>/g, '>'))}</code></p>
-              </section>
-              <section class="endpoint-group">
-                  <div class="endpoint-header"><span class="badge badge-get">GET</span><code>/file/{TOKEN}/deleteById</code></div>
-                  <p><strong>Описание:</strong> Удаляет файл по его ID. Внутренне вызывает <code>getFile</code> для получения пути.</p>
-                  <h4>Параметры Path:</h4>
-                  <table class="param-table"><thead><tr><th>Параметр</th><th>Тип</th><th>Обязательный</th><th>Описание</th></tr></thead><tbody><tr><td><code>TOKEN</code></td><td>string</td><td>Да</td><td>Токен бота.</td></tr></tbody></table>
-                  <h4>Параметры Query:</h4>
-                  <table class="param-table"><thead><tr><th>Параметр</th><th>Тип</th><th>Обязательный</th><th>Описание</th></tr></thead><tbody><tr><td><code>file_id</code></td><td>string</td><td>Да</td><td>Идентификатор файла.</td></tr></tbody></table>
-                  <p><strong>Пример URL:</strong> <code>${baseUrl}/file/${botTokenPh}/deleteById?file_id=${fileIdPh}</code></p>
-              </section>
-              <h2>3. Общие Замечания</h2>
-              <div class="note">
-                  <p><strong>Шифрование ссылок:</strong> ${encryptionKeyBuffer ? `Включено. Для генерации зашифрованных ссылок необходим секрет <code>LINK_ENCRYPTION_KEY</code>.` : `Отключено. Установите секрет <code>LINK_ENCRYPTION_KEY</code> для включения.`}</p>
-                  <p><strong>Срок действия ссылок по умолчанию:</strong> <code>${DEFAULT_LINK_EXPIRY_HOURS}</code> часов (<code>-1</code> означает бессрочные). Может быть переопределен параметром <code>link_expiry_hours</code> в запросах к <code>/file/{TOKEN}/getFile</code>.</p>
-                  <p><strong>Gist:</strong> ${ENV_GIST_ID && GITHUB_USERNAME ? `Информация о данном Space и доступных URL автоматически обновляется в <a href="https://gist.github.com/${GITHUB_USERNAME}/${ENV_GIST_ID}" target="_blank">этом Gist</a> (файл <code>hf_space_telegram_bot_api_proxy_info.json</code>).` : "Обновление Gist не настроено (отсутствуют <code>ENV_GIST_ID</code> или <code>GITHUB_USERNAME</code>)."}</p>
-              </div>
           </div>
-          <div class="en">
-              <h1>API Documentation: Telegram Bot API Proxy & Tools</h1>
-              <p>This service provides a proxy for a local Telegram Bot API server, along with a suite of tools for file management and link generation.</p>
-              <h2>Base URL</h2>
-              <p>All URLs referenced in this documentation start with this base URL:</p>
-              <pre><code>${baseUrl}</code></pre>
-              <h2>1. Telegram Bot API Proxy (Standard)</h2>
-              <section class="endpoint-group">
-                  <div class="endpoint-header"><span class="badge badge-get">GET</span><span class="badge badge-post">POST</span><code>${PROXY_TELEGRAM_PATH_PREFIX}/bot${botTokenPh}/{METHOD_NAME}</code></div>
-                  <p><strong>Description:</strong> Directly proxies requests to your local Telegram Bot API server. This endpoint returns the <strong>unmodified</strong> response from the Telegram API, ensuring full compatibility with standard Telegram clients.</p>
-                  <h4>Path Parameters:</h4>
-                  <table class="param-table">
-                      <thead><tr><th>Parameter</th><th>Type</th><th>Required</th><th>Description</th></tr></thead>
-                      <tbody>
-                          <tr><td><code>TOKEN</code></td><td>string</td><td>Yes</td><td>Your Telegram bot token.</td></tr>
-                          <tr><td><code>METHOD_NAME</code></td><td>string</td><td>Yes</td><td>The Telegram Bot API method name (e.g., <code>getMe</code>, <code>sendMessage</code>).</td></tr>
-                      </tbody>
-                  </table>
-                  <p><strong>Example URL:</strong> <code>${baseUrl}${PROXY_TELEGRAM_PATH_PREFIX}/bot${botTokenPh}/getMe</code></p>
-              </section>
-              <h2>2. Enhanced Tools & File Operations</h2>
-              <section class="endpoint-group">
-                  <div class="endpoint-header"><span class="badge badge-get">GET</span><code>/stats</code></div>
-                  <p><strong>Description:</strong> Retrieves disk usage statistics for the Telegram Bot API data directory.</p>
-                  <h4>Query Parameters:</h4>
-                  <table class="param-table">
-                      <thead><tr><th>Parameter</th><th>Type</th><th>Required</th><th>Description</th></tr></thead>
-                      <tbody>
-                          <tr><td><code>run_ttl_now</code></td><td>boolean</td><td>No</td><td>If <code>true</code>, immediately triggers cleanup of old files based on the <code>FILES_TTL_HOURS</code> setting.</td></tr>
-                      </tbody>
-                  </table>
-                  <p><strong>Example URL:</strong> <code>${baseUrl}/stats</code></p>
-                  <p><strong>Example URL (with cleanup):</strong> <code>${baseUrl}/stats?run_ttl_now=true</code></p>
-                  <h4>Example Response (JSON):</h4>
-                  <pre><code>${JSON.stringify({ directory: TELEGRAM_DATA_DIR, fileCount: 120, totalSizeBytes: 512000000, totalSizeHuman: "488.28 MB", files_ttl_hours: FILES_TTL_HOURS > 0 ? FILES_TTL_HOURS : "disabled", ttl_cleanup_on_this_request: { message: "Cleanup completed..." } }, null, 2)}</code></pre>
-              </section>
-              <section class="endpoint-group">
-                  <div class="endpoint-header"><span class="badge badge-get">GET</span><code>/file/{TOKEN}/getFile</code></div>
-                  <p><strong>Description:</strong> Retrieves file information from the Telegram API (via an internal call to <code>/bot{TOKEN}/getFile</code>) and augments the standard Telegram response with additional download and delete links, including time-limited encrypted versions.</p>
-                  <h4>Path Parameters:</h4>
-                  <table class="param-table">
-                      <thead><tr><th>Parameter</th><th>Type</th><th>Required</th><th>Description</th></tr></thead>
-                      <tbody>
-                          <tr><td><code>TOKEN</code></td><td>string</td><td>Yes</td><td>Your Telegram bot token.</td></tr>
-                      </tbody>
-                  </table>
-                  <h4>Query Parameters:</h4>
-                  <table class="param-table">
-                      <thead><tr><th>Parameter</th><th>Type</th><th>Required</th><th>Description</th></tr></thead>
-                      <tbody>
-                          <tr><td><code>file_id</code></td><td>string</td><td>Yes</td><td>The file identifier.</td></tr>
-                          <tr><td><code>link_expiry_hours</code></td><td>integer</td><td>No</td><td>Expiry time for generated encrypted links in hours. <code>-1</code> for indefinite. Default: <code>${DEFAULT_LINK_EXPIRY_HOURS}</code>.</td></tr>
-                      </tbody>
-                  </table>
-                  <p><strong>Example URL:</strong> <code>${baseUrl}/file/${botTokenPh}/getFile?file_id=${fileIdPh}&link_expiry_hours=2</code></p>
-                  <h4>Example Response (JSON):</h4>
-                  <pre><code>${exampleGetFileResponse}</code></pre>
-              </section>
-              <section class="endpoint-group">
-                  <div class="endpoint-header"><span class="badge badge-get">GET</span><code>/file/list</code></div>
-                  <p><strong>Description:</strong> Returns a list of files, their sizes, and the total size for the specified bot within its directory inside <code>TELEGRAM_DATA_DIR</code>.</p>
-                  <h4>Query Parameters:</h4>
-                   <table class="param-table">
-                      <thead><tr><th>Parameter</th><th>Type</th><th>Required</th><th>Description</th></tr></thead>
-                      <tbody>
-                          <tr><td><code>token</code></td><td>string</td><td>Yes</td><td>The Telegram bot token for which to list files.</td></tr>
-                      </tbody>
-                  </table>
-                  <p><strong>Example URL:</strong> <code>${baseUrl}/file/list?token=${botTokenPh}</code></p>
-              </section>
-              <section class="endpoint-group">
-                  <div class="endpoint-header"><span class="badge badge-get">GET</span><code>/file/{TOKEN}/downloadFile</code></div>
-                  <p><strong>Description:</strong> Downloads a file by its ID. Internally calls <code>getFile</code> to retrieve the file path.</p>
-                  <h4>Path Parameters:</h4>
-                  <table class="param-table"><thead><tr><th>Parameter</th><th>Type</th><th>Required</th><th>Description</th></tr></thead><tbody><tr><td><code>TOKEN</code></td><td>string</td><td>Yes</td><td>Bot token.</td></tr></tbody></table>
-                  <h4>Query Parameters:</h4>
-                  <table class="param-table"><thead><tr><th>Parameter</th><th>Type</th><th>Required</th><th>Description</th></tr></thead><tbody><tr><td><code>file_id</code></td><td>string</td><td>Yes</td><td>File identifier.</td></tr></tbody></table>
-                  <p><strong>Example URL:</strong> <code>${baseUrl}/file/${botTokenPh}/downloadFile?file_id=${fileIdPh}</code></p>
-              </section>
-              <section class="endpoint-group">
-                  <div class="endpoint-header"><span class="badge badge-get">GET</span><code>/file/{RELATIVE_FILE_PATH_WITH_TOKEN}</code></div>
-                  <p><strong>Description:</strong> Downloads a file by its full relative path within <code>TELEGRAM_DATA_DIR</code>. The path must include the bot token directory.</p>
-                  <h4>Path Parameters:</h4>
-                  <table class="param-table"><thead><tr><th>Parameter</th><th>Type</th><th>Required</th><th>Description</th></tr></thead><tbody><tr><td><code>RELATIVE_FILE_PATH_WITH_TOKEN</code></td><td>string</td><td>Yes</td><td>Relative file path, e.g., <code>${relativeFilePathPh}</code>.</td></tr></tbody></table>
-                  <p><strong>Example URL:</strong> <code>${baseUrl}/file/${relativeFilePathPh}</code></p>
-              </section>
-              <section class="endpoint-group">
-                  <div class="endpoint-header"><span class="badge badge-get">GET</span><code>/file/downloadEncrypted</code></div>
-                  <p><strong>Description:</strong> Downloads a file using an encrypted payload obtained from the <code>/file/{TOKEN}/getFile</code> endpoint. Validates link expiry.</p>
-                  <h4>Query Parameters:</h4>
-                  <table class="param-table"><thead><tr><th>Parameter</th><th>Type</th><th>Required</th><th>Description</th></tr></thead><tbody><tr><td><code>payload</code></td><td>string</td><td>Yes</td><td>Encrypted string.</td></tr></tbody></table>
-                  <p><strong>Example URL:</strong> <code>${baseUrl}/file/downloadEncrypted?payload=${encryptedPayloadPh}</code></p>
-              </section>
-              <section class="endpoint-group">
-                  <div class="endpoint-header"><span class="badge badge-get">GET</span><code>/file/deleteFile</code></div>
-                  <p><strong>Description:</strong> Deletes a file by its relative path within <code>TELEGRAM_DATA_DIR</code>.</p>
-                  <h4>Query Parameters:</h4>
-                  <table class="param-table"><thead><tr><th>Parameter</th><th>Type</th><th>Required</th><th>Description</th></tr></thead><tbody><tr><td><code>file</code></td><td>string</td><td>Yes</td><td>Relative file path, e.g., <code>${relativeFilePathPh}</code>.</td></tr></tbody></table>
-                  <p><strong>Example URL:</strong> <code>${baseUrl}/file/deleteFile?file=${encodeURIComponent(relativeFilePathPh.replace(/</g, '<').replace(/>/g, '>'))}</code></p>
-              </section>
-              <section class="endpoint-group">
-                  <div class="endpoint-header"><span class="badge badge-get">GET</span><code>/file/{TOKEN}/deleteById</code></div>
-                  <p><strong>Description:</strong> Deletes a file by its ID. Internally calls <code>getFile</code> to retrieve the path.</p>
-                  <h4>Path Parameters:</h4>
-                  <table class="param-table"><thead><tr><th>Parameter</th><th>Type</th><th>Required</th><th>Description</th></tr></thead><tbody><tr><td><code>TOKEN</code></td><td>string</td><td>Yes</td><td>Bot token.</td></tr></tbody></table>
-                  <h4>Query Parameters:</h4>
-                  <table class="param-table"><thead><tr><th>Parameter</th><th>Type</th><th>Required</th><th>Description</th></tr></thead><tbody><tr><td><code>file_id</code></td><td>string</td><td>Yes</td><td>File identifier.</td></tr></tbody></table>
-                  <p><strong>Example URL:</strong> <code>${baseUrl}/file/${botTokenPh}/deleteById?file_id=${fileIdPh}</code></p>
-              </section>
-              <h2>3. General Notes</h2>
-              <div class="note">
-                  <p><strong>Link Encryption:</strong> ${encryptionKeyBuffer ? `Enabled. Requires the <code>LINK_ENCRYPTION_KEY</code> secret to generate encrypted links.` : `Disabled. Set the <code>LINK_ENCRYPTION_KEY</code> secret to enable.`}</p>
-                  <p><strong>Default Link Expiry:</strong> <code>${DEFAULT_LINK_EXPIRY_HOURS}</code> hours (<code>-1</code> means indefinite). Can be overridden by the <code>link_expiry_hours</code> parameter in <code>/file/{TOKEN}/getFile</code> requests.</p>
-                  <p><strong>Gist:</strong> ${ENV_GIST_ID && GITHUB_USERNAME ? `Information about this Space and available URLs is automatically updated in <a href="https://gist.github.com/${GITHUB_USERNAME}/${ENV_GIST_ID}" target="_blank">this Gist</a> (file <code>hf_space_telegram_bot_api_proxy_info.json</code>).` : "Gist update is not configured (<code>ENV_GIST_ID</code> or <code>GITHUB_USERNAME</code> missing)."}</p>
-              </div>
           </div>
       </div>
       <script>
           function setLang(lang) {
               document.querySelectorAll('.ru, .en').forEach(el => el.classList.remove('active'));
@@ -889,7 +705,6 @@ app.get('/', (req, res) => {
 app.listen(APP_PORT, () => {
   console.log(`Main app (Proxy & Tools) listening on port ${APP_PORT}`);
   console.log(`Telegram Bot API (internal) should be on port ${INTERNAL_TELEGRAM_API_PORT}`);
-  console.log(`Documentation available at /`);
   console.log(`Statistics available at /stats`);
   console.log(`File operations available under /file/`);
   console.log(`Telegram API (standard) proxied from ${PROXY_TELEGRAM_PATH_PREFIX}/`);

                 }
             }
         }
+        res.json(fileInfo);
     } catch (error) {
         console.error(`Error in /:botToken/getFile for file_id ${file_id}:`, error);
         res.status(500).json({ error: 'Server error processing getFile request.', details: error.message });
 app.get('/', (req, res) => {
   const spaceHost = process.env.SPACE_HOST;
   const baseUrl = req.protocol + '://' + (spaceHost || req.get('host'));
+  const botTokenPlaceholder = "<YOUR_BOT_TOKEN>";
+  const fileIdPlaceholder = "<FILE_ID>";
+  const methodPlaceholder = "<METHOD_NAME>";
+  const categoryPlaceholder = "<CATEGORY>";
+  const filenamePlaceholder = "<FILENAME>";
+  const relativeFilePathWithTokenPlaceholder = `bot${botTokenPlaceholder}/${categoryPlaceholder}/${filenamePlaceholder}`;
+  const linkExpiryPlaceholder = "<HOURS>";
+  const encryptedPayloadPlaceholder = "<ENCRYPTED_PAYLOAD>";
   const htmlDoc = `
   <!DOCTYPE html>
   <head>
       <meta charset="UTF-8">
       <meta name="viewport" content="width=device-width, initial-scale=1.0">
+      <title>Telegram Bot API Proxy & Tools Documentation</title>
       <style>
+          body { font-family: sans-serif; line-height: 1.6; padding: 20px; max-width: 900px; margin: auto; }
+          h1, h2, h3, h4 { color: #333; }
+          code { background-color: #f4f4f4; padding: 2px 6px; border-radius: 4px; font-family: monospace; word-break: break-all;}
+          pre { background-color: #f4f4f4; padding: 10px; border-radius: 4px; overflow-x: auto; }
+          .endpoint { margin-bottom: 15px; padding: 10px; border: 1px solid #ddd; border-radius: 4px; }
+          .endpoint strong { display: inline-block; min-width: 70px; }
+          .lang-toggle { text-align: center; margin-bottom: 20px; }
+          .lang-toggle button { padding: 8px 15px; margin: 0 5px; cursor: pointer; border: 1px solid #ccc; background-color: #eee; border-radius: 4px;}
+          .lang-toggle button.active { background-color: #007bff; color: white; border-color: #007bff; }
           .ru, .en { display: none; }
           .ru.active, .en.active { display: block; }
+          table { width: 100%; border-collapse: collapse; margin-bottom: 15px; }
+          th, td { border: 1px solid #ddd; padding: 8px; text-align: left; }
+          th { background-color: #f9f9f9; }
       </style>
   </head>
   <body>
+      <div class="lang-toggle">
+          <button id="lang-ru-btn" onclick="setLang('ru')">Русский</button>
+          <button id="lang-en-btn" onclick="setLang('en')">English</button>
+      </div>
+      <div class="ru">
+          <h1>Прокси Telegram Bot API с расширенными инструментами</h1>
+          <p>Этот Space запускает локальный сервер Telegram Bot API и предоставляет многофункциональное Node.js приложение-прокси с дополнительными инструментами.</p>
+          <p><strong>Базовый URL вашего Space:</strong> <code>${baseUrl}</code></p>
+          <h2>1. Основные возможности</h2>
+          <ul>
+              <li>"Чистое" проксирование Telegram Bot API (эндпоинт <code>${PROXY_TELEGRAM_PATH_PREFIX}/</code>).</li>
+              <li>Специальный эндпоинт <code>/file/${botTokenPlaceholder}/getFile</code> для получения стандартного ответа Telegram API, дополненного ссылками на скачивание/удаление.</li>
+              <li>Управление файлами: статистика, скачивание, удаление, листинг.</li>
+              <li>Зашифрованные ссылки с истечением срока действия.</li>
+              <li>Автоматическая очистка кэша (TTL).</li>
+              <li>Интеграция с GitHub Gist.</li>
+          </ul>
+          <h2>2. Прокси Telegram Bot API (Стандартный)</h2>
+          <div class="endpoint">
+              <strong>URL:</strong> <code>${baseUrl}${PROXY_TELEGRAM_PATH_PREFIX}/bot${botTokenPlaceholder}/${methodPlaceholder}</code><br>
+              <strong>Описание:</strong> Используйте этот URL вместо стандартного <code>api.telegram.org</code>. Возвращает <strong>неизмененный</strong> ответ от Telegram API.<br>
+          </div>
+          <h2>3. Расширенные инструменты и операции с файлами</h2>
+          <h3>3.1. Получение информации о файле с дополнительными ссылками</h3>
+           <div class="endpoint">
+              <strong>URL:</strong> <code>${baseUrl}/file/${botTokenPlaceholder}/getFile?file_id=${fileIdPlaceholder}</code><br>
+              <strong>Метод:</strong> <code>GET</code><br>
+              <strong>Описание:</strong> Делает запрос к локальному Telegram API, получает стандартный ответ и дополняет его полями: <code>direct_download_link_by_path</code>, <code>direct_download_link_by_id</code>, <code>delete_link_by_path</code>, <code>delete_link_by_id</code>, <code>encrypted_download_link_by_path</code>, <code>encrypted_download_link_by_id</code>.<br>
+              <strong>Управление сроком действия зашифрованных ссылок:</strong> Добавьте параметр <code>?link_expiry_hours=${linkExpiryPlaceholder}</code> к URL (<code>${linkExpiryPlaceholder}</code> - часы, <code>-1</code> для бессрочной). По умолчанию: ${DEFAULT_LINK_EXPIRY_HOURS} ч.
+          </div>
+          <h3>3.2. Статистика</h3>
+          <div class="endpoint">
+              <strong>URL:</strong> <code>${baseUrl}/stats</code><br>
+              <strong>Метод:</strong> <code>GET</code><br>
+              <strong>Параметры Query:</strong> <code>run_ttl_now=true</code> (опционально) - запустить очистку.<br>
+              <strong>Ответ:</strong> JSON со статистикой.
           </div>
+          <h3>3.3. Другие операции с файлами (базовый путь: <code>${baseUrl}/file</code>)</h3>
+          <table>
+              <thead><tr><th>Операция</th><th>URL</th><th>Метод</th><th>Описание</th></tr></thead>
+              <tbody>
+                  <tr><td>Список файлов бота</td><td><code>/list?token=${botTokenPlaceholder}</code></td><td>GET</td><td>JSON со списком файлов и их размерами.</td></tr>
+                  <tr><td>Скачать по ID</td><td><code>/${botTokenPlaceholder}/downloadFile?file_id=${fileIdPlaceholder}</code></td><td>GET</td><td>Файл для скачивания.</td></tr>
+                  <tr><td>Скачать по пути</td><td><code>/${relativeFilePathWithTokenPlaceholder}</code></td><td>GET</td><td>Файл для скачивания.</td></tr>
+                  <tr><td>Скачать по зашифр. ссылке</td><td><code>/downloadEncrypted?payload=${encryptedPayloadPlaceholder}</code></td><td>GET</td><td>Файл, если ссылка действительна.</td></tr>
+                  <tr><td>Удалить по пути</td><td><code>/deleteFile?file=${relativeFilePathWithTokenPlaceholder}</code></td><td>GET</td><td>JSON с результатом.</td></tr>
+                  <tr><td>Удалить по ID</td><td><code>/${botTokenPlaceholder}/deleteById?file_id=${fileIdPlaceholder}</code></td><td>GET</td><td>JSON с результатом.</td></tr>
+              </tbody>
+          </table>
+          <p><strong>Замечание о Gist:</strong> Если настроено, информация о Space обновляется в <a href="https://gist.github.com/${GITHUB_USERNAME || "_"}/${ENV_GIST_ID}" target="_blank">вашем Gist</a> (файл <code>hf_space_telegram_bot_api_proxy_info.json</code>).</p>
+          <p><strong>Шифрование ссылок:</strong> ${encryptionKeyBuffer ? "Включено" : "Отключено (LINK_ENCRYPTION_KEY не установлен)"}.</p>
+      </div>
+      <div class="en">
+          <h1>Telegram Bot API Proxy & Tools</h1>
+          <p>This Space runs a local Telegram Bot API server and provides a feature-rich Node.js proxy application with additional tools.</p>
+          <p><strong>Your Space Base URL:</strong> <code>${baseUrl}</code></p>
+          <h2>1. Core Features</h2>
+          <ul>
+              <li>"Clean" Telegram Bot API Proxying (<code>${PROXY_TELEGRAM_PATH_PREFIX}/</code> endpoint).</li>
+              <li>Dedicated endpoint <code>/file/${botTokenPlaceholder}/getFile</code> to get standard Telegram API response augmented with download/delete links.</li>
+              <li>File Management: statistics, download, delete, list.</li>
+              <li>Encrypted links with expiry.</li>
+              <li>Automatic Cache Cleanup (TTL).</li>
+              <li>GitHub Gist Integration.</li>
+          </ul>
+          <h2>2. Telegram Bot API Proxy (Standard)</h2>
+          <div class="endpoint">
+              <strong>URL:</strong> <code>${baseUrl}${PROXY_TELEGRAM_PATH_PREFIX}/bot${botTokenPlaceholder}/${methodPlaceholder}</code><br>
+              <strong>Description:</strong> Use this URL instead of the standard <code>api.telegram.org</code>. Returns the <strong>unmodified</strong> response from the Telegram API.<br>
+          </div>
+          <h2>3. Enhanced Tools & File Operations</h2>
+          <h3>3.1. Get File Info with Augmented Links</h3>
+           <div class="endpoint">
+              <strong>URL:</strong> <code>${baseUrl}/file/${botTokenPlaceholder}/getFile?file_id=${fileIdPlaceholder}</code><br>
+              <strong>Method:</strong> <code>GET</code><br>
+              <strong>Description:</strong> Makes a request to the local Telegram API, gets the standard response, and augments it with: <code>direct_download_link_by_path</code>, <code>direct_download_link_by_id</code>, <code>delete_link_by_path</code>, <code>delete_link_by_id</code>, <code>encrypted_download_link_by_path</code>, <code>encrypted_download_link_by_id</code>.<br>
+              <strong>Encrypted Link Expiry Management:</strong> Add <code>?link_expiry_hours=${linkExpiryPlaceholder}</code> to the URL (<code>${linkExpiryPlaceholder}</code> is hours, <code>-1</code> for indefinite). Default: ${DEFAULT_LINK_EXPIRY_HOURS}h.
           </div>
+          <h3>3.2. Statistics</h3>
+          <div class="endpoint">
+              <strong>URL:</strong> <code>${baseUrl}/stats</code><br>
+              <strong>Method:</strong> <code>GET</code><br>
+              <strong>Query Parameters:</strong> <code>run_ttl_now=true</code> (optional) - trigger cleanup.<br>
+              <strong>Response:</strong> JSON with statistics.
           </div>
+          <h3>3.3. Other File Operations (base path: <code>${baseUrl}/file</code>)</h3>
+          <table>
+              <thead><tr><th>Операция</th><th>URL</th><th>Метод</th><th>Описание</th></tr></thead>
+              <tbody>
+                  <tr><td>List Bot Files</td><td><code>/list?token=${botTokenPlaceholder}</code></td><td>GET</td><td>JSON list of files and their sizes.</td></tr>
+                  <tr><td>Download by ID</td><td><code>/${botTokenPlaceholder}/downloadFile?file_id=${fileIdPlaceholder}</code></td><td>GET</td><td>The file for download.</td></tr>
+                  <tr><td>Download by Path</td><td><code>/${relativeFilePathWithTokenPlaceholder}</code></td><td>GET</td><td>The file for download.</td></tr>
+                  <tr><td>Download via Encrypted Link</td><td><code>/downloadEncrypted?payload=${encryptedPayloadPlaceholder}</code></td><td>GET</td><td>File, if link is valid.</td></tr>
+                  <tr><td>Delete by Path</td><td><code>/deleteFile?file=${relativeFilePathWithTokenPlaceholder}</code></td><td>GET</td><td>JSON with result.</td></tr>
+                  <tr><td>Delete by ID</td><td><code>/${botTokenPlaceholder}/deleteById?file_id=${fileIdPlaceholder}</code></td><td>GET</td><td>JSON with result.</td></tr>
+              </tbody>
+          </table>
+          <p><strong>Gist Note:</strong> If configured, Space info is updated in <a href="https://gist.github.com/${GITHUB_USERNAME || "_"}/${ENV_GIST_ID}" target="_blank">your Gist</a> (file <code>hf_space_telegram_bot_api_proxy_info.json</code>).</p>
+          <p><strong>Link Encryption:</strong> ${encryptionKeyBuffer ? "Enabled" : "Disabled (LINK_ENCRYPTION_KEY not set)"}.</p>
       </div>
       <script>
           function setLang(lang) {
               document.querySelectorAll('.ru, .en').forEach(el => el.classList.remove('active'));
 app.listen(APP_PORT, () => {
   console.log(`Main app (Proxy & Tools) listening on port ${APP_PORT}`);
   console.log(`Telegram Bot API (internal) should be on port ${INTERNAL_TELEGRAM_API_PORT}`);
   console.log(`Statistics available at /stats`);
   console.log(`File operations available under /file/`);
   console.log(`Telegram API (standard) proxied from ${PROXY_TELEGRAM_PATH_PREFIX}/`);