alvin-bot 4.4.1

package/dist/platforms/telegram.js

@@ -0,0 +1,111 @@
+/**
+ * Telegram Platform Adapter
+ *
+ * Wraps grammy Bot into the PlatformAdapter interface.
+ * This is the reference implementation — all other adapters follow this pattern.
+ */
+import { Bot, InputFile } from "grammy";
+import { config } from "../config.js";
+import { authMiddleware } from "../middleware/auth.js";
+let _telegramState = {
+    status: "disconnected",
+    botName: null,
+    botUsername: null,
+    connectedAt: null,
+    error: null,
+};
+export function getTelegramState() {
+    return { ..._telegramState };
+}
+/** Called from index.ts when grammy bot connects (since we don't use TelegramAdapter yet) */
+export function setTelegramConnected(botName, botUsername) {
+    _telegramState.status = "connected";
+    _telegramState.botName = botName;
+    _telegramState.botUsername = botUsername;
+    _telegramState.connectedAt = Date.now();
+}
+export class TelegramAdapter {
+    platform = "telegram";
+    bot;
+    handler = null;
+    constructor() {
+        this.bot = new Bot(config.botToken);
+    }
+    /** Get the underlying grammy Bot instance (for command registration). */
+    getBot() {
+        return this.bot;
+    }
+    async start() {
+        // Auth middleware
+        this.bot.use(authMiddleware);
+        // Route raw messages to the platform handler
+        this.bot.on("message:text", async (ctx) => {
+            if (!this.handler)
+                return;
+            if (ctx.message?.text?.startsWith("/"))
+                return; // Commands handled separately
+            const msg = {
+                platform: "telegram",
+                messageId: String(ctx.message?.message_id),
+                chatId: String(ctx.chat?.id),
+                userId: String(ctx.from?.id),
+                userName: ctx.from?.first_name || "Unknown",
+                userHandle: ctx.from?.username,
+                text: ctx.message?.text || "",
+                isGroup: ctx.chat?.type !== "private",
+                isMention: false, // Handled by group middleware
+                isReplyToBot: false,
+                replyToText: ctx.message?.reply_to_message?.text,
+            };
+            await this.handler(msg);
+        });
+        _telegramState.status = "connecting";
+        await this.bot.start({
+            onStart: () => {
+                const me = this.bot.botInfo;
+                _telegramState.status = "connected";
+                _telegramState.botName = me.first_name || null;
+                _telegramState.botUsername = me.username || null;
+                _telegramState.connectedAt = Date.now();
+                console.log(`📱 Telegram adapter started (@${me.username})`);
+            },
+        });
+    }
+    async stop() {
+        this.bot.stop();
+    }
+    async sendText(chatId, text, options) {
+        const parseMode = options?.parseMode === "html" ? "HTML"
+            : options?.parseMode === "markdown" ? "Markdown"
+                : undefined;
+        await this.bot.api.sendMessage(Number(chatId), text, {
+            parse_mode: parseMode,
+            reply_parameters: options?.replyTo ? { message_id: Number(options.replyTo) } : undefined,
+        });
+    }
+    async sendPhoto(chatId, photo, caption) {
+        const input = typeof photo === "string" ? new InputFile(photo) : new InputFile(photo, "photo.jpg");
+        await this.bot.api.sendPhoto(Number(chatId), input, { caption });
+    }
+    async sendDocument(chatId, doc, fileName, caption) {
+        const input = typeof doc === "string" ? new InputFile(doc) : new InputFile(doc, fileName);
+        await this.bot.api.sendDocument(Number(chatId), input, { caption });
+    }
+    async sendVoice(chatId, audio) {
+        const input = typeof audio === "string" ? new InputFile(audio) : new InputFile(audio, "voice.ogg");
+        await this.bot.api.sendVoice(Number(chatId), input);
+    }
+    async react(chatId, messageId, emoji) {
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            await this.bot.api.setMessageReaction(Number(chatId), Number(messageId), [{ type: "emoji", emoji: emoji }]);
+        }
+        catch { /* Reactions not supported */ }
+    }
+    async setTyping(chatId) {
+        await this.bot.api.sendChatAction(Number(chatId), "typing");
+    }
+    onMessage(handler) {
+        this.handler = handler;
+    }
+}

package/dist/platforms/types.js

@@ -0,0 +1,8 @@
+/**
+ * Platform Abstraction — Unified interface for all messaging platforms.
+ *
+ * Every platform adapter implements PlatformAdapter.
+ * The bot logic talks to adapters through this interface,
+ * making it platform-agnostic.
+ */
+export {};