@mseep/telegram-api-mcp 0.1.0

package/dist/server.js

@@ -0,0 +1,287 @@
+import { z } from "zod";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import { TelegramClient, TelegramApiError } from "./telegram-client.js";
+import { buildZodSchema } from "./method-registry.js";
+import { allMethods, searchMethods, findMethodByApiName } from "./methods/index.js";
+import { CircuitOpenError } from "./circuit-breaker.js";
+import { Trail } from "./trail.js";
+/** Pre-built Zod schemas for all methods (built once, reused on every call). */
+const schemaCache = new Map();
+/** Module-level TRAIL instance for auto-logging in callTelegram. */
+let trailInstance = null;
+function getSchema(method) {
+    let schema = schemaCache.get(method.apiMethod);
+    if (!schema) {
+        schema = buildZodSchema(method.params);
+        schemaCache.set(method.apiMethod, schema);
+    }
+    return schema;
+}
+export async function startServer(config) {
+    const client = new TelegramClient(config);
+    const server = new McpServer({
+        name: "telegram-api-mcp",
+        version: "0.1.0",
+    });
+    // Log before connect (connect blocks on stdio transport)
+    log("info", `Starting server in ${config.metaMode ? "meta" : "standard"} mode with ${allMethods.length} methods`);
+    if (config.metaMode) {
+        registerMetaTools(server, client);
+    }
+    else {
+        registerAllTools(server, client);
+    }
+    trailInstance = registerTrailTools(server);
+    registerDownloadTool(server, client);
+    const shutdown = () => {
+        client.destroy();
+        process.exit(0);
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+// ─── Standard Mode ──────────────────────────────────────────────────────
+function registerAllTools(server, client) {
+    for (const method of allMethods) {
+        const zodSchema = getSchema(method);
+        const annotations = method.annotations || { destructiveHint: false };
+        server.tool(method.toolName, method.description, zodSchema.shape, annotations, async (params) => {
+            return callTelegram(client, method, params);
+        });
+    }
+}
+// ─── Meta Mode ──────────────────────────────────────────────────────────
+function registerMetaTools(server, client) {
+    server.tool("telegram_find", "Search Telegram Bot API methods by keyword. Returns matching methods with their parameters. Use this to discover available methods before calling them.", {
+        query: z.string().optional().describe("Search keyword (e.g. 'send photo', 'ban', 'poll', 'sticker')"),
+        category: z.string().optional().describe("Filter by category: messages, media, polls, chat, members, invite, forum, stickers, inline, payments, business, stories, gifts, games, bot, updates, editing, forwarding, managed_bots, passport, other"),
+    }, async (params) => {
+        let results = params.query ? searchMethods(params.query) : allMethods;
+        if (params.category) {
+            results = results.filter((m) => m.category === params.category);
+        }
+        if (results.length === 0) {
+            return { content: [{ type: "text", text: "No methods found. Try a different keyword." }] };
+        }
+        const text = results
+            .slice(0, 20)
+            .map((m) => {
+            const required = m.params.filter((p) => p.required).map((p) => p.name);
+            const optional = m.params.filter((p) => !p.required).map((p) => p.name).slice(0, 5);
+            return [
+                `**${m.apiMethod}** (tool: ${m.toolName}) [${m.category}]`,
+                `  ${m.description}`,
+                `  Required: ${required.join(", ") || "none"}`,
+                `  Optional: ${optional.join(", ")}${m.params.filter((p) => !p.required).length > 5 ? " ..." : ""}`,
+                `  Returns: ${m.returns}`,
+            ].join("\n");
+        })
+            .join("\n\n");
+        return {
+            content: [{
+                    type: "text",
+                    text: `Found ${results.length} method(s):\n\n${text}${results.length > 20 ? `\n\n... and ${results.length - 20} more. Narrow your search.` : ""}`,
+                }],
+        };
+    });
+    server.tool("telegram_call", "Call any Telegram Bot API method. Use telegram_find first to discover method names and required parameters.", {
+        method: z.string().describe("API method name (e.g. sendMessage, banChatMember)"),
+        params: z.record(z.unknown()).optional().describe("Method parameters as JSON object"),
+    }, async (args) => {
+        const methodDef = findMethodByApiName(args.method);
+        if (!methodDef) {
+            return {
+                content: [{ type: "text", text: `Unknown method: "${args.method}". Use telegram_find to search for the correct method name. Method names are camelCase (e.g. sendMessage, not send_message).` }],
+                isError: true,
+            };
+        }
+        return executeMethod(client, methodDef, (args.params || {}));
+    });
+}
+// ─── TRAIL ─────────────────────────────────────────────────────────────
+function registerTrailTools(server) {
+    const dataDir = join(dirname(fileURLToPath(import.meta.url)), "..", "data");
+    const trail = new Trail(dataDir, "telegram-mcp");
+    server.tool("get_trail", "Query the TRAIL content log. Check what content was posted, failed, or skipped across pipelines.", {
+        content_id: z.string().optional().describe("Filter by content ID (exact or prefix like 'civitai:image:')"),
+        action: z.union([z.string(), z.array(z.string())]).optional().describe("Filter by action (posted, failed, skipped, etc.)"),
+        requester: z.string().optional().describe("Filter by workflow/task ID"),
+        trace_id: z.string().optional().describe("Filter by pipeline trace ID"),
+        since: z.string().optional().describe("ISO 8601 timestamp — only entries after this time"),
+        limit: z.number().int().min(0).max(500).optional().describe("Max entries, newest first (default: 50, 0 = all)"),
+        offset: z.number().int().min(0).optional().describe("Entries to skip for pagination (default: 0)"),
+    }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }, async (params) => {
+        const { entries, total } = await trail.query({
+            content_id: params.content_id,
+            action: params.action,
+            requester: params.requester,
+            trace_id: params.trace_id,
+            since: params.since,
+            limit: params.limit ?? 50,
+            offset: params.offset,
+        });
+        if (entries.length === 0) {
+            return { content: [{ type: "text", text: "No trail entries found." }] };
+        }
+        const lines = entries.map((e) => {
+            const d = e.details ?? {};
+            const detailParts = Object.entries(d)
+                .filter(([, v]) => typeof v !== "object")
+                .map(([k, v]) => `${k}=${v}`);
+            const detailStr = detailParts.length ? ` — ${detailParts.join(", ")}` : "";
+            return `[${e.timestamp}] ${e.action} ${e.content_id} (req: ${e.requester})${detailStr}`;
+        });
+        return { content: [{ type: "text", text: `TRAIL Log (${entries.length}/${total}):\n\n${lines.join("\n")}` }] };
+    });
+    server.tool("mark_trail", "Write an entry to the TRAIL content log. Use to explicitly record content actions.", {
+        content_id: z.string().describe("Content ID in format source:type:id"),
+        action: z.string().describe("Action: fetched, selected, posted, failed, skipped"),
+        requester: z.string().describe("Workflow/task ID"),
+        details: z.record(z.unknown()).optional().describe("Platform-specific data"),
+        trace_id: z.string().optional().describe("Pipeline trace ID"),
+        tags: z.array(z.string()).optional().describe("Labels for filtering"),
+    }, { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false }, async (params) => {
+        await trail.append(params.content_id, params.action, params.requester, {
+            details: params.details,
+            trace_id: params.trace_id,
+            tags: params.tags,
+        });
+        return { content: [{ type: "text", text: `Trail entry recorded: ${params.action} ${params.content_id} (req: ${params.requester})` }] };
+    });
+    server.tool("get_trail_stats", "Get summary statistics from the TRAIL content log.", {
+        requester: z.string().optional().describe("Filter by workflow/task ID"),
+        since: z.string().optional().describe("ISO 8601 timestamp — only count entries after this"),
+    }, { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }, async (params) => {
+        const stats = await trail.stats(params.requester, params.since);
+        const actionLines = Object.entries(stats.by_action)
+            .sort(([a], [b]) => a.localeCompare(b))
+            .map(([act, count]) => `  ${act}: ${count}`)
+            .join("\n");
+        const text = [
+            `TRAIL Statistics:`,
+            `Total entries: ${stats.total_entries}`,
+            `Unique content IDs: ${stats.unique_content_ids}`,
+            `First entry: ${stats.first_entry ?? "N/A"}`,
+            `Last entry: ${stats.last_entry ?? "N/A"}`,
+            `By action:\n${actionLines}`,
+        ].join("\n");
+        return { content: [{ type: "text", text }] };
+    });
+    return trail;
+}
+// ─── Download ───────────────────────────────────────────────────────────
+function registerDownloadTool(server, client) {
+    const defaultDir = process.env.TELEGRAM_DOWNLOAD_DIR || (process.platform === "win32"
+        ? `${process.env.USERPROFILE || "C:\\Users\\user"}\\Downloads\\telegram-mcp`
+        : `${process.env.HOME || "/tmp"}/telegram-mcp-downloads`);
+    server.tool("download_file", "Download a file from Telegram by file_id. Saves locally and returns the path. Use after receiving a message with a photo, video, document, voice, etc. Max 20MB (Telegram Bot API limit).", {
+        file_id: z.string().describe("File ID from a message (photo[-1].file_id, document.file_id, video.file_id, etc.)"),
+        dest_dir: z.string().optional().describe(`Directory to save to (default: ${defaultDir})`),
+    }, { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true }, async (params) => {
+        try {
+            const dir = params.dest_dir || defaultDir;
+            const localPath = await client.downloadFile(params.file_id, dir);
+            return {
+                content: [{ type: "text", text: `Downloaded to: ${localPath}` }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Download failed: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+// ─── Execution ──────────────────────────────────────────────────────────
+/** For meta-mode: validate then call. */
+async function executeMethod(client, method, params) {
+    const schema = getSchema(method);
+    const parseResult = schema.safeParse(params);
+    if (!parseResult.success) {
+        const errors = parseResult.error.issues
+            .map((i) => `  ${i.path.join(".")}: ${i.message}`)
+            .join("\n");
+        const required = method.params.filter((p) => p.required).map((p) => p.name);
+        return {
+            content: [{ type: "text", text: `Validation error for ${method.apiMethod}:\n${errors}\n\nRequired params: ${required.join(", ") || "none"}. Use telegram_find(query: "${method.apiMethod}") to see full parameter list.` }],
+            isError: true,
+        };
+    }
+    return callTelegram(client, method, parseResult.data);
+}
+/** Methods that produce posts/messages worth logging. */
+const LOGGED_METHODS = new Set([
+    "sendMessage", "sendPhoto", "sendVideo", "sendDocument", "sendAudio",
+    "sendAnimation", "sendVoice", "sendVideoNote", "sendMediaGroup",
+    "sendPaidMedia", "sendSticker", "sendLocation", "sendVenue", "sendContact",
+    "sendPoll", "sendDice", "sendChecklist", "sendGame", "sendInvoice",
+    "sendGift", "sendMessageDraft", "forwardMessage", "forwardMessages",
+    "copyMessage", "copyMessages", "postStory",
+]);
+/** For standard mode: already validated by SDK, just call. */
+async function callTelegram(client, method, params) {
+    try {
+        const result = await client.call(method.apiMethod, params);
+        // Auto-log send/forward/copy/post calls
+        if (LOGGED_METHODS.has(method.apiMethod) && result != null) {
+            const r = (Array.isArray(result) ? result[0] : result);
+            // TRAIL auto-logging
+            const _trail = params._trail;
+            const trailCid = (_trail?.content_id ?? params.content_id);
+            const trailReq = (_trail?.requester ?? params.requester);
+            if (trailCid && trailReq && trailInstance) {
+                trailInstance.append(trailCid, "posted", trailReq, {
+                    details: {
+                        platform: "telegram",
+                        platform_id: String(r?.message_id ?? ""),
+                        chat_id: String(params.chat_id ?? ""),
+                    },
+                    trace_id: (_trail?.trace_id ?? params.trace_id),
+                }).catch((err) => {
+                    log("warn", `trail write failed: ${err.message}`);
+                });
+            }
+        }
+        const text = formatResult(method.apiMethod, result);
+        return { content: [{ type: "text", text }] };
+    }
+    catch (error) {
+        const message = error instanceof CircuitOpenError
+            ? error.message
+            : error instanceof TelegramApiError
+                ? error.message
+                : `Unexpected error: ${error.message}`;
+        return {
+            content: [{ type: "text", text: message }],
+            isError: true,
+        };
+    }
+}
+const MAX_RESPONSE_LENGTH = 100_000;
+function formatResult(method, result) {
+    if (result === true)
+        return `${method}: Success`;
+    let text;
+    if (typeof result === "object" && result !== null) {
+        text = JSON.stringify(result, null, 2);
+    }
+    else {
+        text = String(result);
+    }
+    // Truncate to prevent filling context window
+    if (text.length > MAX_RESPONSE_LENGTH) {
+        text = text.slice(0, MAX_RESPONSE_LENGTH) + `\n\n... [truncated, ${text.length} chars total]`;
+    }
+    return text;
+}
+function log(level, msg) {
+    const ts = new Date().toISOString();
+    process.stderr.write(`[${ts}] [${level.toUpperCase()}] ${msg}\n`);
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/telegram-client.d.ts

@@ -0,0 +1,28 @@
+import { Config } from "./config.js";
+export declare class TelegramClient {
+    private baseUrl;
+    private token;
+    private rateLimiter;
+    private circuitBreaker;
+    private config;
+    private cleanupInterval;
+    constructor(config: Config);
+    destroy(): void;
+    call(method: string, params?: Record<string, unknown>): Promise<unknown>;
+    private applyDefaults;
+    private callWithRetry;
+    private callJson;
+    private callMultipart;
+    private handleResponse;
+    private hasFileParams;
+    private isLocalFile;
+    private readLocalFile;
+    /** Download a file by file_id. Returns the local path. */
+    downloadFile(fileId: string, destDir: string): Promise<string>;
+}
+export declare class TelegramApiError extends Error {
+    statusCode?: number;
+    retryAfter?: number;
+    constructor(message: string, statusCode?: number, retryAfter?: number);
+}
+//# sourceMappingURL=telegram-client.d.ts.map

package/dist/telegram-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-client.d.ts","sourceRoot":"","sources":["../src/telegram-client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AA2BrC,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,eAAe,CAAiC;gBAE5C,MAAM,EAAE,MAAM;IAmB1B,OAAO,IAAI,IAAI;IAIT,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWlF,OAAO,CAAC,aAAa;YAWP,aAAa;YAqDb,QAAQ;YAkBR,aAAa;YAgCb,cAAc;IA0B5B,OAAO,CAAC,aAAa;YAeP,WAAW;YAUX,aAAa;IA8B3B,0DAA0D;IACpD,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CA2CrE;AAED,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAER,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAMtE"}

package/dist/telegram-client.js

@@ -0,0 +1,254 @@
+import { readFile, writeFile, stat, mkdir } from "node:fs/promises";
+import { basename, dirname, isAbsolute, join, resolve, normalize, sep } from "node:path";
+import { RateLimiter } from "./rate-limiter.js";
+import { CircuitBreaker, CircuitOpenError } from "./circuit-breaker.js";
+/** Default fetch timeout: 60 seconds */
+const FETCH_TIMEOUT_MS = 60_000;
+function log(level, msg) {
+    const ts = new Date().toISOString();
+    process.stderr.write(`[${ts}] [${level.toUpperCase()}] ${msg}\n`);
+}
+function maskToken(str, token) {
+    return str.replaceAll(token, "***");
+}
+export class TelegramClient {
+    baseUrl;
+    token;
+    rateLimiter;
+    circuitBreaker;
+    config;
+    cleanupInterval;
+    constructor(config) {
+        this.config = config;
+        this.token = config.botToken;
+        this.baseUrl = `https://api.telegram.org/bot${this.token}`;
+        this.rateLimiter = new RateLimiter(config.globalRateLimit, config.perChatRateLimit);
+        this.circuitBreaker = new CircuitBreaker(config.circuitBreakerThreshold, config.circuitBreakerCooldown);
+        this.cleanupInterval = setInterval(() => this.rateLimiter.cleanup(), 60_000);
+        this.cleanupInterval.unref(); // Don't prevent Node.js from exiting
+        // Warn if no upload directory restrictions
+        if (config.allowedUploadDirs.length === 0) {
+            log("warn", "TELEGRAM_ALLOWED_UPLOAD_DIRS not set — file uploads unrestricted. Set it to restrict paths.");
+        }
+    }
+    destroy() {
+        clearInterval(this.cleanupInterval);
+    }
+    async call(method, params = {}) {
+        const resolvedParams = this.applyDefaults(params);
+        const chatId = resolvedParams.chat_id;
+        this.circuitBreaker.check();
+        await this.rateLimiter.acquire(chatId);
+        const hasFiles = this.hasFileParams(resolvedParams);
+        return this.callWithRetry(method, resolvedParams, hasFiles);
+    }
+    applyDefaults(params) {
+        const result = { ...params };
+        if (!result.chat_id && this.config.defaultChatId) {
+            result.chat_id = this.config.defaultChatId;
+        }
+        if (!result.message_thread_id && this.config.defaultThreadId) {
+            result.message_thread_id = this.config.defaultThreadId;
+        }
+        return result;
+    }
+    async callWithRetry(method, params, hasFiles, attempt = 1) {
+        try {
+            const result = hasFiles
+                ? await this.callMultipart(method, params)
+                : await this.callJson(method, params);
+            this.circuitBreaker.recordSuccess();
+            return result;
+        }
+        catch (error) {
+            if (error instanceof CircuitOpenError)
+                throw error;
+            const err = error;
+            // Don't retry 4xx (except 429)
+            if (err.statusCode && err.statusCode >= 400 && err.statusCode < 500 && err.statusCode !== 429) {
+                throw error;
+            }
+            // 429: respect retry_after (or default 5s if not provided)
+            if (err.statusCode === 429) {
+                if (attempt <= this.config.maxRetries) {
+                    const retryAfter = err.retryAfter ?? 5;
+                    const waitMs = retryAfter * 1000;
+                    log("warn", `Rate limited on ${method}, waiting ${retryAfter}s (attempt ${attempt}/${this.config.maxRetries})`);
+                    await sleep(waitMs);
+                    return this.callWithRetry(method, params, hasFiles, attempt + 1);
+                }
+                throw error; // Exhausted retries on 429
+            }
+            // Record failure for circuit breaker (429 already handled above)
+            const justOpened = this.circuitBreaker.recordFailure(err.statusCode);
+            if (justOpened) {
+                log("error", `Circuit breaker OPENED after ${this.config.circuitBreakerThreshold} failures`);
+            }
+            // Retry on transient errors (5xx, network)
+            if (attempt < this.config.maxRetries) {
+                const backoffMs = Math.min(1000 * Math.pow(2, attempt - 1), 10_000);
+                log("warn", `Retrying ${method} in ${backoffMs}ms (attempt ${attempt + 1}/${this.config.maxRetries})`);
+                await sleep(backoffMs);
+                return this.callWithRetry(method, params, hasFiles, attempt + 1);
+            }
+            throw error;
+        }
+    }
+    async callJson(method, params) {
+        const url = `${this.baseUrl}/${method}`;
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+        try {
+            const response = await fetch(url, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify(params),
+                signal: controller.signal,
+            });
+            return this.handleResponse(method, response);
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+    async callMultipart(method, params) {
+        const url = `${this.baseUrl}/${method}`;
+        const formData = new FormData();
+        for (const [key, value] of Object.entries(params)) {
+            if (value === undefined || value === null)
+                continue;
+            if (typeof value === "string" && (await this.isLocalFile(value))) {
+                const file = await this.readLocalFile(value);
+                formData.append(key, file, basename(value));
+            }
+            else if (typeof value === "object") {
+                formData.append(key, JSON.stringify(value));
+            }
+            else {
+                formData.append(key, String(value));
+            }
+        }
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+        try {
+            const response = await fetch(url, {
+                method: "POST",
+                body: formData,
+                signal: controller.signal,
+            });
+            return this.handleResponse(method, response);
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+    async handleResponse(method, response) {
+        let data;
+        try {
+            data = (await response.json());
+        }
+        catch {
+            throw new TelegramApiError(`Failed to parse response from ${method} (HTTP ${response.status})`, response.status);
+        }
+        if (!data.ok) {
+            const description = data.description
+                ? maskToken(data.description, this.token)
+                : "Unknown error";
+            throw new TelegramApiError(`${method}: ${description}`, data.error_code || response.status, data.parameters?.retry_after);
+        }
+        return data.result;
+    }
+    hasFileParams(params) {
+        const fileFields = new Set([
+            "photo", "audio", "document", "video", "animation", "voice",
+            "video_note", "sticker", "thumbnail", "certificate",
+        ]);
+        for (const [key, value] of Object.entries(params)) {
+            if (fileFields.has(key) && typeof value === "string") {
+                if (isAbsolute(value))
+                    return true;
+            }
+        }
+        return false;
+    }
+    async isLocalFile(value) {
+        if (!isAbsolute(value))
+            return false;
+        try {
+            const info = await stat(value);
+            return info.isFile();
+        }
+        catch {
+            return false;
+        }
+    }
+    async readLocalFile(filePath) {
+        const resolved = resolve(normalize(filePath));
+        // Path traversal protection: require trailing separator in comparison
+        if (this.config.allowedUploadDirs.length > 0) {
+            const isAllowed = this.config.allowedUploadDirs.some((dir) => {
+                const normalizedDir = resolve(normalize(dir));
+                const dirWithSep = normalizedDir.endsWith(sep) ? normalizedDir : normalizedDir + sep;
+                return resolved.startsWith(dirWithSep) || resolved === normalizedDir;
+            });
+            if (!isAllowed) {
+                throw new Error(`File upload blocked: ${resolved} is not in allowed directories. ` +
+                    `Set TELEGRAM_ALLOWED_UPLOAD_DIRS to allow specific paths.`);
+            }
+        }
+        const info = await stat(resolved);
+        if (info.size > this.config.maxFileSize) {
+            throw new Error(`File too large: ${(info.size / 1024 / 1024).toFixed(1)}MB exceeds ` +
+                `limit of ${(this.config.maxFileSize / 1024 / 1024).toFixed(0)}MB`);
+        }
+        const buffer = await readFile(resolved);
+        return new Blob([buffer]);
+    }
+    /** Download a file by file_id. Returns the local path. */
+    async downloadFile(fileId, destDir) {
+        // Step 1: getFile to get file_path
+        const fileInfo = (await this.call("getFile", { file_id: fileId }));
+        if (!fileInfo.file_path) {
+            throw new Error("Telegram returned no file_path — file may be too large (>20MB)");
+        }
+        // Step 2: download from https://api.telegram.org/file/bot<token>/<file_path>
+        const url = `https://api.telegram.org/file/bot${this.token}/${fileInfo.file_path}`;
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 120_000);
+        try {
+            const response = await fetch(url, { signal: controller.signal });
+            if (!response.ok) {
+                throw new Error(`Download failed: HTTP ${response.status}`);
+            }
+            const buffer = Buffer.from(await response.arrayBuffer());
+            // Determine filename from file_path
+            const fileName = fileInfo.file_path.split("/").pop() || `file_${fileId}`;
+            const destPath = resolve(normalize(join(destDir, fileName)));
+            // Security: ensure dest is inside destDir
+            const normalizedDir = resolve(normalize(destDir));
+            if (!destPath.startsWith(normalizedDir + sep) && destPath !== normalizedDir) {
+                throw new Error(`Path traversal blocked: ${destPath} is not inside ${normalizedDir}`);
+            }
+            await mkdir(dirname(destPath), { recursive: true });
+            await writeFile(destPath, buffer);
+            return destPath;
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+}
+export class TelegramApiError extends Error {
+    statusCode;
+    retryAfter;
+    constructor(message, statusCode, retryAfter) {
+        super(message);
+        this.name = "TelegramApiError";
+        this.statusCode = statusCode;
+        this.retryAfter = retryAfter;
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=telegram-client.js.map

package/dist/telegram-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-client.js","sourceRoot":"","sources":["../src/telegram-client.ts"],"names":[],"mappings":"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"}