@overpod/mcp-telegram 1.1.1 → 1.2.0

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "dotenv/config";

package/dist/qr-login-cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "dotenv/config";

package/dist/telegram-client.d.ts

@@ -0,0 +1,111 @@
+export declare class TelegramService {
+    private client;
+    private apiId;
+    private apiHash;
+    private sessionString;
+    private connected;
+    lastError: string;
+    constructor(apiId: number, apiHash: string);
+    loadSession(): Promise<boolean>;
+    /** Set session string in memory (for programmatic / hosted use) */
+    setSessionString(session: string): void;
+    /** Get the current session string (for external persistence) */
+    getSessionString(): string;
+    private saveSession;
+    connect(): Promise<boolean>;
+    clearSession(): Promise<void>;
+    /** Ensure connection is active, auto-reconnect if session exists */
+    ensureConnected(): Promise<boolean>;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
+    startQrLogin(onQrDataUrl: (dataUrl: string) => void, onQrUrl?: (url: string) => void): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    getMe(): Promise<{
+        id: string;
+        username?: string;
+        firstName?: string;
+    }>;
+    sendMessage(chatId: string, text: string, replyTo?: number, parseMode?: "md" | "html"): Promise<void>;
+    sendFile(chatId: string, filePath: string, caption?: string): Promise<void>;
+    downloadMedia(chatId: string, messageId: number, downloadPath: string): Promise<string>;
+    pinMessage(chatId: string, messageId: number, silent?: boolean): Promise<void>;
+    unpinMessage(chatId: string, messageId: number): Promise<void>;
+    getDialogs(limit?: number, offsetDate?: number, filterType?: "private" | "group" | "channel"): Promise<Array<{
+        id: string;
+        name: string;
+        type: string;
+        unreadCount: number;
+    }>>;
+    getUnreadDialogs(limit?: number): Promise<Array<{
+        id: string;
+        name: string;
+        type: string;
+        unreadCount: number;
+    }>>;
+    markAsRead(chatId: string): Promise<void>;
+    forwardMessage(fromChatId: string, toChatId: string, messageIds: number[]): Promise<void>;
+    editMessage(chatId: string, messageId: number, newText: string): Promise<void>;
+    deleteMessages(chatId: string, messageIds: number[]): Promise<void>;
+    getChatInfo(chatId: string): Promise<{
+        id: string;
+        name: string;
+        type: string;
+        username?: string;
+        description?: string;
+        membersCount?: number;
+    }>;
+    /** Extract media info from a message */
+    private extractMediaInfo;
+    /** Resolve sender ID to a display name */
+    private resolveSenderName;
+    getMessages(chatId: string, limit?: number, offsetId?: number, minDate?: number, maxDate?: number): Promise<Array<{
+        id: number;
+        text: string;
+        sender: string;
+        date: string;
+        media?: {
+            type: string;
+            fileName?: string;
+            size?: number;
+        };
+    }>>;
+    searchChats(query: string, limit?: number): Promise<Array<{
+        id: string;
+        name: string;
+        type: string;
+        username?: string;
+    }>>;
+    searchMessages(chatId: string, query: string, limit?: number, minDate?: number, maxDate?: number): Promise<Array<{
+        id: number;
+        text: string;
+        sender: string;
+        date: string;
+        media?: {
+            type: string;
+            fileName?: string;
+            size?: number;
+        };
+    }>>;
+    getContacts(limit?: number): Promise<Array<{
+        id: string;
+        name: string;
+        username?: string;
+        phone?: string;
+    }>>;
+    getChatMembers(chatId: string, limit?: number): Promise<Array<{
+        id: string;
+        name: string;
+        username?: string;
+    }>>;
+    getProfile(userId: string): Promise<{
+        id: string;
+        name: string;
+        username?: string;
+        phone?: string;
+        bio?: string;
+        photo: boolean;
+        lastSeen?: string;
+    }>;
+}

package/dist/telegram-client.js

@@ -27,9 +27,22 @@ export class TelegramService {
         }
         return false;
     }
+    /** Set session string in memory (for programmatic / hosted use) */
+    setSessionString(session) {
+        this.sessionString = session;
+    }
+    /** Get the current session string (for external persistence) */
+    getSessionString() {
+        return this.sessionString;
+    }
     async saveSession(session) {
         this.sessionString = session;
-        await writeFile(SESSION_FILE, session, "utf-8");
+        try {
+            await writeFile(SESSION_FILE, session, "utf-8");
+        }
+        catch {
+            // File write may fail in containerized environments — session string is still in memory
+        }
     }
     async connect() {
         if (this.connected && this.client)

package/package.json

@@ -1,9 +1,13 @@
 {
   "name": "@overpod/mcp-telegram",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "description": "MCP server for Telegram userbot — 20 tools for messages, media, contacts & more. Built on GramJS/MTProto.",
   "type": "module",
   "main": "dist/index.js",
+  "exports": {
+    ".": "./dist/index.js",
+    "./service": "./dist/telegram-client.js"
+  },
   "bin": {
     "mcp-telegram": "dist/cli.js"
   },