@yungho/noclaw-channel 0.4.2 → 0.4.4

package/dist/channels/TelegramChannel.d.ts

@@ -1,53 +1,30 @@
 /**
- * Telegram Channel Implementation
+ * Telegram Channel Implementation (production-grade)
  *
- * Uses Telegram Bot API for message communication.
- * This is a placeholder implementation for future use.
+ * Uses grammY Bot framework for polling, sequentialization, rate limiting,
+ * and DM access control. Replaces the previous manual HTTP fetch() approach.
+ *
+ * Architecture: Implements IChannel → registered via ChannelRegistry.
+ * Zero changes to WebSocketServer, ConfigManager, or TenantConfigManager.
  */
-import { IChannel, IpcMessage, TelegramConfig, ChannelStatus, ChannelCapabilities, MediaObject } from '../types.js';
-import pino from 'pino';
+import type { IChannel, IpcMessage, TelegramConfig, ChannelStatus, ChannelCapabilities, MediaObject } from "../types.js";
+import type pino from "pino";
 export declare class TelegramChannel implements IChannel {
-    private readonly baseUrl;
     private config;
     private logger;
     private status;
-    private pollingInterval?;
-    private messageCallback?;
+    private bot;
+    private messageCallback;
     private statusCallbacks;
-    private lastUpdateId;
-    private readonly POLLING_INTERVAL;
     constructor(config: TelegramConfig, logger: pino.Logger);
     connect(): Promise<void>;
     disconnect(): Promise<void>;
-    send(text: string, contextToken: string, media?: MediaObject[], _userId?: string): Promise<void>;
+    send(text: string, contextToken: string, _media?: MediaObject[], _userId?: string): Promise<void>;
     onMessage(callback: (msg: IpcMessage) => void): void;
+    onStatusChange(callback: (status: ChannelStatus) => void): void;
     getStatus(): ChannelStatus;
     getCapabilities(): ChannelCapabilities;
     getPlatformId(): string;
-    onStatusChange(callback: (status: ChannelStatus) => void): void;
-    /**
-     * Start polling for incoming messages
-     */
-    private startMessagePolling;
-    /**
-     * Stop all polling
-     */
-    private stopPolling;
-    /**
-     * Send text message
-     */
-    private sendMessage;
-    /**
-     * Send photo
-     */
-    private sendPhoto;
-    /**
-     * Make HTTP request to Telegram API
-     */
-    private makeRequest;
-    /**
-     * Update connection status
-     */
     private setStatus;
 }
 //# sourceMappingURL=TelegramChannel.d.ts.map

package/dist/channels/TelegramChannel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TelegramChannel.d.ts","sourceRoot":"","sources":["../../src/channels/TelegramChannel.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACpH,OAAO,IAAI,MAAM,MAAM,CAAC;AAqCxB,qBAAa,eAAgB,YAAW,QAAQ;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,eAAe,CAAC,CAAiB;IACzC,OAAO,CAAC,eAAe,CAAC,CAA4B;IACpD,OAAO,CAAC,eAAe,CAAmD;IAC1E,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAQ;gBAE7B,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM;IAMjD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA4BxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBtG,SAAS,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI;IAIpD,SAAS,IAAI,aAAa;IAI1B,eAAe,IAAI,mBAAmB;IAUtC,aAAa,IAAI,MAAM;IAIvB,cAAc,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI;IAI/D;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA+C3B;;OAEG;IACH,OAAO,CAAC,WAAW;IAOnB;;OAEG;YACW,WAAW;IAyBzB;;OAEG;YACW,SAAS;IA2BvB;;OAEG;YACW,WAAW;IAYzB;;OAEG;IACH,OAAO,CAAC,SAAS;CAIlB"}
+{"version":3,"file":"TelegramChannel.d.ts","sourceRoot":"","sources":["../../src/channels/TelegramChannel.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EACV,QAAQ,EACR,UAAU,EACV,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,WAAW,EACZ,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAI7B,qBAAa,eAAgB,YAAW,QAAQ;IAC9C,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,GAAG,CAAoB;IAC/B,OAAO,CAAC,eAAe,CAA4C;IACnE,OAAO,CAAC,eAAe,CAA8C;gBAEzD,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM;IAOjD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAiGxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B,IAAI,CACR,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,WAAW,EAAE,EACtB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAahB,SAAS,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI;IAIpD,cAAc,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI;IAI/D,SAAS,IAAI,aAAa;IAI1B,eAAe,IAAI,mBAAmB;IAUtC,aAAa,IAAI,MAAM;IAMvB,OAAO,CAAC,SAAS;CAUlB"}

package/dist/channels/TelegramChannel.js

@@ -1,79 +1,124 @@
 /**
- * Telegram Channel Implementation
+ * Telegram Channel Implementation (production-grade)
  *
- * Uses Telegram Bot API for message communication.
- * This is a placeholder implementation for future use.
+ * Uses grammY Bot framework for polling, sequentialization, rate limiting,
+ * and DM access control. Replaces the previous manual HTTP fetch() approach.
+ *
+ * Architecture: Implements IChannel → registered via ChannelRegistry.
+ * Zero changes to WebSocketServer, ConfigManager, or TenantConfigManager.
  */
+import { Bot } from "grammy";
+import { sequentialize } from "@grammyjs/runner";
+import { apiThrottler } from "@grammyjs/transformer-throttler";
+// ── TelegramChannel ───────────────────────────────────────────────────────────
 export class TelegramChannel {
-    baseUrl;
     config;
     logger;
-    status = 'disconnected';
-    pollingInterval;
-    messageCallback;
+    status = "disconnected";
+    bot = null;
+    messageCallback = null;
     statusCallbacks = new Set();
-    lastUpdateId = 0;
-    POLLING_INTERVAL = 2000; // 2 seconds
     constructor(config, logger) {
         this.config = config;
-        this.baseUrl = `https://api.telegram.org/bot${config.botToken}`;
-        this.logger = logger.child({ channel: 'telegram' });
+        this.logger = logger.child({ channel: "telegram" });
     }
+    // ── IChannel Implementation ─────────────────────────────────────────────
     async connect() {
         if (!this.config.enabled) {
-            this.logger.warn('Telegram channel is disabled in config');
+            this.logger.warn("Telegram channel is disabled in config");
             return;
         }
-        this.setStatus('connecting');
+        if (!this.config.botToken || this.config.botToken.trim().length === 0) {
+            throw new Error("Telegram botToken is required. Get one from @BotFather on Telegram.");
+        }
+        this.setStatus("connecting");
         try {
-            // Test token by making a request
-            const response = await this.makeRequest('/getUpdates', {
-                method: 'GET',
+            this.bot = new Bot(this.config.botToken);
+            // Middleware stack (order matters):
+            // 1. Sequentialize per-chat to prevent message reordering
+            this.bot.use(sequentialize((ctx) => {
+                return ctx.chat?.id?.toString();
+            }));
+            // 2. Rate limiting via API transformer (respects Telegram's ~30 msg/s limit)
+            this.bot.api.config.use(apiThrottler());
+            // 3. DM access control (Phase D)
+            this.bot.use(async (ctx, next) => {
+                const allowed = this.config.allowedUsers ?? [];
+                if (allowed.length === 0 || allowed.includes("*")) {
+                    return next();
+                }
+                const userId = ctx.from?.id?.toString();
+                if (!userId || !allowed.includes(userId)) {
+                    this.logger.warn({ userId: userId ?? "unknown" }, "Telegram: rejected non-whitelisted user");
+                    await ctx.reply("Sorry, you are not authorized to use this bot.");
+                    return;
+                }
+                return next();
             });
-            if (!response.ok) {
-                throw new Error('Invalid bot token or API error');
-            }
-            this.startMessagePolling();
-            this.setStatus('connected');
-            this.logger.info('Connected to Telegram Bot API');
+            // 4. Incoming text message handler
+            this.bot.on("message:text", (ctx) => {
+                const msg = ctx.message;
+                if (!msg?.text)
+                    return;
+                const chatId = msg.chat.id;
+                const fromId = msg.from?.id;
+                const ipcMessage = {
+                    type: "MSG_IN",
+                    platform: "telegram",
+                    content: msg.text,
+                    contextToken: `tg_${chatId}`,
+                    userId: fromId ? String(fromId) : undefined,
+                    metadata: {
+                        timestamp: Date.now(),
+                        platform: "telegram",
+                        userId: fromId ? String(fromId) : undefined,
+                        messageId: String(msg.message_id ?? ctx.msg?.message_id ?? 0),
+                    },
+                };
+                this.logger.info({ from: fromId, chatId, textPreview: msg.text.slice(0, 60) }, "Received Telegram message");
+                this.messageCallback?.(ipcMessage);
+            });
+            this.bot.catch((err) => {
+                this.logger.error({ err }, "Telegram bot error");
+            });
+            // Start grammY long-polling (returns immediately, runs in background)
+            this.bot.start({
+                onStart: () => {
+                    this.logger.info("Telegram long-polling started");
+                },
+            });
+            this.setStatus("connected");
+            this.logger.info("Connected to Telegram Bot API");
         }
         catch (error) {
-            this.logger.error({ error }, 'Failed to connect to Telegram');
-            this.setStatus('error');
+            this.bot = null;
+            this.setStatus("error");
+            this.logger.error({ error }, "Failed to connect to Telegram");
             throw error;
         }
     }
     async disconnect() {
-        this.stopPolling();
-        this.setStatus('disconnected');
-        this.logger.info('Disconnected from Telegram');
-    }
-    async send(text, contextToken, media, _userId) {
-        try {
-            const chatId = contextToken.replace('tg_', '');
-            if (media && media.length > 0) {
-                // Send media first
-                for (const item of media) {
-                    if (item.type === 'image') {
-                        await this.sendPhoto(chatId, item.data, text);
-                        break; // Only send first image for now
-                    }
-                }
-            }
-            else {
-                // Send text message
-                await this.sendMessage(chatId, text);
-            }
-            this.logger.debug({ chatId, textLength: text.length }, 'Message sent to Telegram');
+        if (this.bot) {
+            await this.bot.stop();
+            this.bot = null;
         }
-        catch (error) {
-            this.logger.error({ error, contextToken }, 'Failed to send message to Telegram');
-            throw error;
+        this.setStatus("disconnected");
+        this.logger.info("Disconnected from Telegram");
+    }
+    async send(text, contextToken, _media, _userId) {
+        if (!this.bot) {
+            throw new Error("Not connected. Call connect() first.");
         }
+        const chatId = contextToken.replace("tg_", "");
+        await this.bot.api.sendMessage(chatId, text);
+        this.logger.debug({ chatId, textLength: text.length }, "Message sent to Telegram");
     }
     onMessage(callback) {
         this.messageCallback = callback;
     }
+    onStatusChange(callback) {
+        this.statusCallbacks.add(callback);
+    }
     getStatus() {
         return this.status;
     }
@@ -87,126 +132,19 @@ export class TelegramChannel {
         };
     }
     getPlatformId() {
-        return 'telegram';
+        return "telegram";
     }
-    onStatusChange(callback) {
-        this.statusCallbacks.add(callback);
-    }
-    /**
-     * Start polling for incoming messages
-     */
-    startMessagePolling() {
-        this.stopPolling(); // Clear any existing polling
-        this.pollingInterval = setInterval(async () => {
+    // ── Private ──────────────────────────────────────────────────────────────
+    setStatus(status) {
+        this.status = status;
+        for (const cb of this.statusCallbacks) {
             try {
-                const response = await this.makeRequest(`/getUpdates?offset=${this.lastUpdateId}`, {
-                    method: 'GET',
-                });
-                if (response.result && response.result.length > 0) {
-                    this.logger.debug({ messageCount: response.result.length }, 'Received messages from Telegram');
-                    for (const update of response.result) {
-                        // Update last update ID (+1 to ACK this update)
-                        this.lastUpdateId = update.update_id + 1;
-                        // Emit message to callback
-                        if (update.message?.text) {
-                            this.messageCallback?.({
-                                type: 'MSG_IN',
-                                platform: 'telegram',
-                                content: update.message.text,
-                                contextToken: `tg_${update.message.chat.id}`,
-                                userId: String(update.message.from.id),
-                                metadata: {
-                                    timestamp: Date.now(),
-                                    platform: 'telegram',
-                                    userId: String(update.message.from.id),
-                                    messageId: String(update.message.message_id),
-                                },
-                            });
-                        }
-                    }
-                }
+                cb(status);
             }
-            catch (error) {
-                this.logger.error({ error }, 'Error polling for messages');
-                // Don't stop polling on error, just log it
+            catch {
+                // ignore callback errors
             }
-        }, this.POLLING_INTERVAL);
-    }
-    /**
-     * Stop all polling
-     */
-    stopPolling() {
-        if (this.pollingInterval) {
-            clearInterval(this.pollingInterval);
-            this.pollingInterval = undefined;
-        }
-    }
-    /**
-     * Send text message
-     */
-    async sendMessage(chatId, text) {
-        const url = `${this.baseUrl}/sendMessage`;
-        const body = JSON.stringify({
-            chat_id: parseInt(chatId),
-            text,
-        });
-        const response = await fetch(url, {
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/json',
-            },
-            body,
-        });
-        if (!response.ok) {
-            throw new Error(`Failed to send message: ${response.statusText}`);
-        }
-        const data = await response.json();
-        if (!data.ok) {
-            throw new Error('Failed to send message');
         }
     }
-    /**
-     * Send photo
-     */
-    async sendPhoto(chatId, photoData, caption) {
-        const url = `${this.baseUrl}/sendPhoto`;
-        const formData = new FormData();
-        formData.append('chat_id', chatId);
-        const buffer = Buffer.from(photoData, 'base64');
-        const blob = new Blob([buffer], { type: 'image/jpeg' });
-        formData.append('photo', blob, 'photo.jpg');
-        if (caption) {
-            formData.append('caption', caption);
-        }
-        const response = await fetch(url, {
-            method: 'POST',
-            body: formData,
-        });
-        if (!response.ok) {
-            throw new Error(`Failed to send photo: ${response.statusText}`);
-        }
-        const data = await response.json();
-        if (!data.ok) {
-            throw new Error('Failed to send photo');
-        }
-    }
-    /**
-     * Make HTTP request to Telegram API
-     */
-    async makeRequest(endpoint, options) {
-        const url = `${this.baseUrl}${endpoint}`;
-        const response = await fetch(url, options);
-        if (!response.ok) {
-            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
-        }
-        return await response.json();
-    }
-    /**
-     * Update connection status
-     */
-    setStatus(status) {
-        this.status = status;
-        this.statusCallbacks.forEach((callback) => callback(status));
-    }
 }
 //# sourceMappingURL=TelegramChannel.js.map

package/dist/channels/TelegramChannel.js.map

@@ -1 +1 @@
-{"version":3,"file":"TelegramChannel.js","sourceRoot":"","sources":["../../src/channels/TelegramChannel.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAwCH,MAAM,OAAO,eAAe;IACT,OAAO,CAAS;IACzB,MAAM,CAAiB;IACvB,MAAM,CAAc;IACpB,MAAM,GAAkB,cAAc,CAAC;IACvC,eAAe,CAAkB;IACjC,eAAe,CAA6B;IAC5C,eAAe,GAAyC,IAAI,GAAG,EAAE,CAAC;IAClE,YAAY,GAAG,CAAC,CAAC;IACR,gBAAgB,GAAG,IAAI,CAAC,CAAC,YAAY;IAEtD,YAAY,MAAsB,EAAE,MAAmB;QACrD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,+BAA+B,MAAM,CAAC,QAAQ,EAAE,CAAC;QAChE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACzB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;YAC3D,OAAO;QACT,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QAE7B,IAAI,CAAC;YACH,iCAAiC;YACjC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAqB,aAAa,EAAE;gBACzE,MAAM,EAAE,KAAK;aACd,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;YACpD,CAAC;YAED,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC3B,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;YAC5B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QACpD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,+BAA+B,CAAC,CAAC;YAC9D,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YACxB,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU;QACd,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QAC/B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,YAAoB,EAAE,KAAqB,EAAE,OAAgB;QACpF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAE/C,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9B,mBAAmB;gBACnB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;wBAC1B,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,IAAc,EAAE,IAAI,CAAC,CAAC;wBACxD,MAAM,CAAC,gCAAgC;oBACzC,CAAC;gBACH,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,oBAAoB;gBACpB,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YACvC,CAAC;YAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,0BAA0B,CAAC,CAAC;QACrF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,oCAAoC,CAAC,CAAC;YACjF,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,SAAS,CAAC,QAAmC;QAC3C,IAAI,CAAC,eAAe,GAAG,QAAQ,CAAC;IAClC,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,eAAe;QACb,OAAO;YACL,aAAa,EAAE,IAAI;YACnB,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,IAAI;YACrB,cAAc,EAAE,IAAI;YACpB,QAAQ,EAAE,KAAK;SAChB,CAAC;IACJ,CAAC;IAED,aAAa;QACX,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,cAAc,CAAC,QAAyC;QACtD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACK,mBAAmB;QACzB,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,6BAA6B;QAEjD,IAAI,CAAC,eAAe,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;YAC5C,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CACrC,sBAAsB,IAAI,CAAC,YAAY,EAAE,EACzC;oBACE,MAAM,EAAE,KAAK;iBACd,CACF,CAAC;gBAEF,IAAI,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAClD,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,EAAE,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,EACxC,iCAAiC,CAClC,CAAC;oBAEF,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;wBACrC,gDAAgD;wBAChD,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC;wBAEzC,2BAA2B;wBAC3B,IAAI,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;4BACzB,IAAI,CAAC,eAAe,EAAE,CAAC;gCACrB,IAAI,EAAE,QAAQ;gCACd,QAAQ,EAAE,UAAU;gCACpB,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI;gCAC5B,YAAY,EAAE,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE;gCAC5C,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gCACtC,QAAQ,EAAE;oCACR,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;oCACrB,QAAQ,EAAE,UAAU;oCACpB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;oCACtC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC;iCAC7C;6BACF,CAAC,CAAC;wBACL,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,4BAA4B,CAAC,CAAC;gBAC3D,2CAA2C;YAC7C,CAAC;QACH,CAAC,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACK,WAAW;QACjB,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,aAAa,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YACpC,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;QACnC,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,WAAW,CAAC,MAAc,EAAE,IAAY;QACpD,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,cAAc,CAAC;QAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;YAC1B,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC;YACzB,IAAI;SACL,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI;SACL,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,2BAA2B,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QACpE,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAyB,CAAC;QAC1D,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,SAAS,CAAC,MAAc,EAAE,SAAiB,EAAE,OAAgB;QACzE,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,YAAY,CAAC;QACxC,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;QAChC,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAChD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;QACxD,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;QAE5C,IAAI,OAAO,EAAE,CAAC;YACZ,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACtC,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,QAAe;SACtB,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,yBAAyB,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QAClE,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAyB,CAAC;QAC1D,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,WAAW,CAAI,QAAgB,EAAE,OAAoB;QACjE,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,GAAG,QAAQ,EAAE,CAAC;QAEzC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAE3C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,QAAQ,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QACrE,CAAC;QAED,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAO,CAAC;IACpC,CAAC;IAED;;OAEG;IACK,SAAS,CAAC,MAAqB;QACrC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/D,CAAC;CACF"}
+{"version":3,"file":"TelegramChannel.js","sourceRoot":"","sources":["../../src/channels/TelegramChannel.ts"],"names":[],"mappings":"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"}

package/dist/channels/__tests__/TelegramChannel.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=TelegramChannel.test.d.ts.map

package/dist/channels/__tests__/TelegramChannel.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TelegramChannel.test.d.ts","sourceRoot":"","sources":["../../../src/channels/__tests__/TelegramChannel.test.ts"],"names":[],"mappings":""}

package/dist/channels/__tests__/TelegramChannel.test.js

@@ -0,0 +1,191 @@
+/**
+ * TelegramChannel tests — NHP-2 TDD (RED phase)
+ *
+ * Verifies the IChannel interface implementation using grammY.
+ * All grammY internals are mocked — we test OUR code, not the library.
+ */
+import { describe, it, expect, vi, beforeEach } from "vitest";
+// ── Mocks ────────────────────────────────────────────────────────────────────
+const mockBotStart = vi.fn();
+const mockBotStop = vi.fn();
+const mockSendMessage = vi.fn();
+const mockBotOn = vi.fn();
+const mockBotUse = vi.fn();
+const mockBotCatch = vi.fn();
+const mockBotInstance = {
+    start: mockBotStart,
+    stop: mockBotStop,
+    api: { sendMessage: mockSendMessage, config: { use: vi.fn() } },
+    on: mockBotOn,
+    use: mockBotUse,
+    catch: mockBotCatch,
+};
+vi.mock("grammy", () => ({
+    Bot: vi.fn(function () {
+        return mockBotInstance;
+    }),
+}));
+vi.mock("@grammyjs/runner", () => ({
+    sequentialize: vi.fn(() => "mock-sequentialize-middleware"),
+}));
+vi.mock("@grammyjs/transformer-throttler", () => ({
+    apiThrottler: vi.fn(() => "mock-throttler-middleware"),
+}));
+import { Bot } from "grammy";
+import { sequentialize } from "@grammyjs/runner";
+import { apiThrottler } from "@grammyjs/transformer-throttler";
+import { TelegramChannel } from "../TelegramChannel.js";
+// ── Helpers ───────────────────────────────────────────────────────────────────
+function createChannel(overrides = {}) {
+    const config = {
+        enabled: true,
+        botToken: "test-bot-token",
+        allowedUsers: ["*"],
+        permissions: { chat: "all", executeTools: true, permissionRelay: true, adminUsers: [] },
+        ...overrides,
+    };
+    const logger = {
+        info: vi.fn(),
+        warn: vi.fn(),
+        error: vi.fn(),
+        debug: vi.fn(),
+        child: vi.fn(() => logger),
+    };
+    return new TelegramChannel(config, logger);
+}
+// ── Tests ────────────────────────────────────────────────────────────────────
+describe("TelegramChannel (grammY)", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    describe("connect()", () => {
+        it("creates a grammY Bot and starts long-polling", async () => {
+            const channel = createChannel();
+            await channel.connect();
+            expect(Bot).toHaveBeenCalledWith("test-bot-token");
+            // sequentialize should be registered
+            expect(vi.mocked(sequentialize)).toHaveBeenCalled();
+            // throttler should be registered
+            expect(vi.mocked(apiThrottler)).toHaveBeenCalled();
+            // message handler should be registered
+            expect(mockBotOn).toHaveBeenCalledWith("message:text", expect.any(Function));
+            // bot should start polling
+            expect(mockBotStart).toHaveBeenCalled();
+            expect(channel.getStatus()).toBe("connected");
+        });
+        it("throws if botToken is empty", async () => {
+            const channel = createChannel({ botToken: "" });
+            await expect(channel.connect()).rejects.toThrow("botToken is required");
+        });
+        it("does nothing if disabled", async () => {
+            const channel = createChannel({ enabled: false });
+            await channel.connect();
+            expect(Bot).not.toHaveBeenCalled();
+            expect(channel.getStatus()).toBe("disconnected");
+        });
+    });
+    describe("disconnect()", () => {
+        it("stops the bot and sets status to disconnected", async () => {
+            const channel = createChannel();
+            await channel.connect();
+            await channel.disconnect();
+            expect(mockBotStop).toHaveBeenCalled();
+            expect(channel.getStatus()).toBe("disconnected");
+        });
+    });
+    describe("send()", () => {
+        it("calls bot.api.sendMessage with chatId from contextToken", async () => {
+            const channel = createChannel();
+            await channel.connect();
+            await channel.send("Hello Telegram!", "tg_123456");
+            expect(mockSendMessage).toHaveBeenCalledWith("123456", "Hello Telegram!");
+        });
+        it("throws if not connected", async () => {
+            const channel = createChannel();
+            await expect(channel.send("hi", "tg_123")).rejects.toThrow("Not connected");
+        });
+        it("passes parse_mode and link_preview_options", async () => {
+            const channel = createChannel();
+            await channel.connect();
+            await channel.send("<b>bold</b>", "tg_789");
+            expect(mockSendMessage).toHaveBeenCalledWith("789", "<b>bold</b>");
+        });
+    });
+    describe("incoming message → MSG_IN", () => {
+        it("fires messageCallback with correct MSG_IN on text message", async () => {
+            const channel = createChannel();
+            const onMessage = vi.fn();
+            channel.onMessage(onMessage);
+            await channel.connect();
+            // Extract the handler registered with bot.on("message:text", handler)
+            const handler = mockBotOn.mock.calls.find((call) => call[0] === "message:text")?.[1];
+            expect(handler).toBeDefined();
+            // Simulate a grammY context
+            await handler({
+                message: {
+                    message_id: 42,
+                    text: "Hello from Telegram!",
+                    chat: { id: 123456, type: "private" },
+                    from: { id: 789, first_name: "Alice" },
+                },
+            });
+            expect(onMessage).toHaveBeenCalledTimes(1);
+            const msg = onMessage.mock.calls[0][0];
+            expect(msg.type).toBe("MSG_IN");
+            expect(msg.platform).toBe("telegram");
+            expect(msg.content).toBe("Hello from Telegram!");
+            expect(msg.contextToken).toBe("tg_123456");
+            expect(msg.userId).toBe("789");
+            expect(msg.metadata?.messageId).toBe("42");
+        });
+    });
+    describe("DM access control", () => {
+        it("allows whitelisted user", async () => {
+            const channel = createChannel({ allowedUsers: ["123", "456"] });
+            await channel.connect();
+            const handler = mockBotOn.mock.calls.find((call) => call[0] === "message:text")?.[1];
+            const onMessage = vi.fn();
+            channel.onMessage(onMessage);
+            const mockNext = vi.fn();
+            const mockReply = vi.fn();
+            // Access control is the 2nd bot.use() call (index 1, after sequentialize)
+            const accessMiddleware = mockBotUse.mock.calls[1]?.[0];
+            expect(accessMiddleware).toBeDefined();
+            await accessMiddleware({ from: { id: 123 }, reply: mockReply }, mockNext);
+            expect(mockNext).toHaveBeenCalled();
+            expect(mockReply).not.toHaveBeenCalled();
+        });
+        it("rejects non-whitelisted user", async () => {
+            const channel = createChannel({ allowedUsers: ["123"] });
+            await channel.connect();
+            const accessMiddleware = mockBotUse.mock.calls[1]?.[0];
+            const mockNext = vi.fn();
+            const mockReply = vi.fn();
+            await accessMiddleware({ from: { id: 999 }, reply: mockReply }, mockNext);
+            expect(mockNext).not.toHaveBeenCalled();
+            expect(mockReply).toHaveBeenCalledWith("Sorry, you are not authorized to use this bot.");
+        });
+        it('allows any user when allowedUsers is ["*"]', async () => {
+            const channel = createChannel({ allowedUsers: ["*"] });
+            await channel.connect();
+            const accessMiddleware = mockBotUse.mock.calls[1]?.[0];
+            const mockNext = vi.fn();
+            const mockReply = vi.fn();
+            await accessMiddleware({ from: { id: 999 }, reply: mockReply }, mockNext);
+            expect(mockNext).toHaveBeenCalled();
+            expect(mockReply).not.toHaveBeenCalled();
+        });
+    });
+    describe("getPlatformId / getCapabilities", () => {
+        it("returns 'telegram'", () => {
+            expect(createChannel().getPlatformId()).toBe("telegram");
+        });
+        it("reports text + media capabilities", () => {
+            const caps = createChannel().getCapabilities();
+            expect(caps.textMessaging).toBe(true);
+            expect(caps.mediaSharing).toBe(true);
+            expect(caps.webhooks).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=TelegramChannel.test.js.map

package/dist/channels/__tests__/TelegramChannel.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yungho/noclaw-channel",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "description": "NoClaw Channel Server - WebSocket IPC bridge for external chat platforms",
   "main": "dist/index.js",
   "type": "module",
@@ -24,7 +24,10 @@
   "author": "Yungho",
   "license": "Apache-2.0",
   "dependencies": {
+    "@grammyjs/runner": "^2.0.3",
+    "@grammyjs/transformer-throttler": "^1.2.1",
     "commander": "^12.1.0",
+    "grammy": "^1.34.0",
     "pino": "^9.0.0",
     "pino-pretty": "^11.0.0",
     "qrcode-terminal": "^0.12.0",