@daemux/telegram-adapter 1.0.0

package/dist/message-resolver.js

@@ -0,0 +1,155 @@
+/**
+ * Message Type & File ID Resolver
+ * Extracts message type and primary file ID from a Telegram message.
+ */
+// ---------------------------------------------------------------------------
+// Message type resolution
+// ---------------------------------------------------------------------------
+/**
+ * Determine the message type from a Telegram message.
+ * Priority order matches Telegram's conventions: animation before video
+ * (since animations have both animation and document fields).
+ */
+export function resolveMessageType(msg) {
+    if (msg.photo && msg.photo.length > 0)
+        return 'photo';
+    if (msg.animation)
+        return 'animation';
+    if (msg.video)
+        return 'video';
+    if (msg.video_note)
+        return 'video_note';
+    if (msg.voice)
+        return 'voice';
+    if (msg.audio)
+        return 'audio';
+    if (msg.sticker)
+        return 'sticker';
+    if (msg.document)
+        return 'document';
+    if (msg.contact)
+        return 'contact';
+    if (msg.location)
+        return 'location';
+    return 'text';
+}
+// ---------------------------------------------------------------------------
+// File ID resolution
+// ---------------------------------------------------------------------------
+/** Extract the primary file_id from a Telegram message, if it has a file attachment. */
+export function resolveFileId(msg) {
+    if (msg.photo && msg.photo.length > 0) {
+        return pickLargestPhoto(msg.photo);
+    }
+    if (msg.animation)
+        return msg.animation.file_id;
+    if (msg.video)
+        return msg.video.file_id;
+    if (msg.video_note)
+        return msg.video_note.file_id;
+    if (msg.voice)
+        return msg.voice.file_id;
+    if (msg.audio)
+        return msg.audio.file_id;
+    if (msg.sticker)
+        return msg.sticker.file_id;
+    if (msg.document)
+        return msg.document.file_id;
+    return undefined;
+}
+// ---------------------------------------------------------------------------
+// Full attachment resolution
+// ---------------------------------------------------------------------------
+/** Extract all attachment metadata from a Telegram message. */
+export function resolveAttachment(msg) {
+    if (msg.photo && msg.photo.length > 0) {
+        const largest = pickLargestPhotoSize(msg.photo);
+        return {
+            type: 'photo',
+            fileId: largest.file_id,
+            fileSize: largest.file_size,
+            width: largest.width,
+            height: largest.height,
+        };
+    }
+    if (msg.animation) {
+        return {
+            type: 'animation',
+            fileId: msg.animation.file_id,
+            mimeType: msg.animation.mime_type,
+            fileSize: msg.animation.file_size,
+            duration: msg.animation.duration,
+            width: msg.animation.width,
+            height: msg.animation.height,
+        };
+    }
+    if (msg.video) {
+        return {
+            type: 'video',
+            fileId: msg.video.file_id,
+            mimeType: msg.video.mime_type,
+            fileSize: msg.video.file_size,
+            duration: msg.video.duration,
+            width: msg.video.width,
+            height: msg.video.height,
+        };
+    }
+    if (msg.video_note) {
+        return {
+            type: 'video_note',
+            fileId: msg.video_note.file_id,
+            fileSize: msg.video_note.file_size,
+            duration: msg.video_note.duration,
+            width: msg.video_note.length,
+            height: msg.video_note.length,
+        };
+    }
+    if (msg.voice) {
+        return {
+            type: 'voice',
+            fileId: msg.voice.file_id,
+            mimeType: msg.voice.mime_type,
+            fileSize: msg.voice.file_size,
+            duration: msg.voice.duration,
+        };
+    }
+    if (msg.audio) {
+        return {
+            type: 'audio',
+            fileId: msg.audio.file_id,
+            mimeType: msg.audio.mime_type,
+            fileName: msg.audio.title,
+            fileSize: msg.audio.file_size,
+            duration: msg.audio.duration,
+        };
+    }
+    if (msg.sticker) {
+        return {
+            type: 'sticker',
+            fileId: msg.sticker.file_id,
+            fileSize: msg.sticker.file_size,
+            width: msg.sticker.width,
+            height: msg.sticker.height,
+        };
+    }
+    if (msg.document) {
+        return {
+            type: 'document',
+            fileId: msg.document.file_id,
+            mimeType: msg.document.mime_type,
+            fileName: msg.document.file_name,
+            fileSize: msg.document.file_size,
+        };
+    }
+    return undefined;
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function pickLargestPhotoSize(photos) {
+    return photos.reduce((a, b) => (a.file_size ?? 0) > (b.file_size ?? 0) ? a : b);
+}
+function pickLargestPhoto(photos) {
+    return pickLargestPhotoSize(photos).file_id;
+}
+//# sourceMappingURL=message-resolver.js.map

package/dist/message-resolver.js.map

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

package/dist/poller.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Telegram Long-Polling Manager
+ * Handles update fetching with exponential backoff and graceful shutdown.
+ */
+import type { TelegramUpdate } from './types';
+import type { TelegramApi } from './api';
+export type UpdateHandler = (update: TelegramUpdate) => Promise<void>;
+export type PollerLogger = {
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string, err?: unknown): void;
+};
+export declare class TelegramPoller {
+    private api;
+    private handler;
+    private running;
+    private offset;
+    private pollTimeoutSec;
+    private abortController;
+    private consecutiveErrors;
+    private maxBackoffMs;
+    private logger;
+    constructor(options: {
+        api: TelegramApi;
+        handler: UpdateHandler;
+        pollTimeoutSec?: number;
+        maxBackoffMs?: number;
+        logger?: PollerLogger;
+    });
+    /** Start the polling loop. This method runs until stop() is called. */
+    start(): Promise<void>;
+    /** Signal the polling loop to stop. */
+    stop(): void;
+    /** Whether the poller is currently running. */
+    isRunning(): boolean;
+    private processUpdate;
+    private handlePollingError;
+    private sleep;
+}
+//# sourceMappingURL=poller.d.ts.map

package/dist/poller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poller.d.ts","sourceRoot":"","sources":["../src/poller.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAOzC,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEtE,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC7C,CAAC;AAYF,qBAAa,cAAc;IACzB,OAAO,CAAC,GAAG,CAAc;IACzB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,MAAM,CAAe;gBAEjB,OAAO,EAAE;QACnB,GAAG,EAAE,WAAW,CAAC;QACjB,OAAO,EAAE,aAAa,CAAC;QACvB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,MAAM,CAAC,EAAE,YAAY,CAAC;KACvB;IAQD,uEAAuE;IACjE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA0B5B,uCAAuC;IACvC,IAAI,IAAI,IAAI;IAMZ,+CAA+C;IAC/C,SAAS,IAAI,OAAO;YAQN,aAAa;YAWb,kBAAkB;IAuBhC,OAAO,CAAC,KAAK;CAGd"}

package/dist/poller.js

@@ -0,0 +1,95 @@
+/**
+ * Telegram Long-Polling Manager
+ * Handles update fetching with exponential backoff and graceful shutdown.
+ */
+import { TelegramApiError } from './api';
+const defaultLogger = {
+    info: (msg) => console.log(`[telegram-poller] ${msg}`),
+    warn: (msg) => console.warn(`[telegram-poller] ${msg}`),
+    error: (msg, err) => console.error(`[telegram-poller] ${msg}`, err ?? ''),
+};
+// ---------------------------------------------------------------------------
+// Poller
+// ---------------------------------------------------------------------------
+export class TelegramPoller {
+    api;
+    handler;
+    running = false;
+    offset;
+    pollTimeoutSec;
+    abortController = null;
+    consecutiveErrors = 0;
+    maxBackoffMs;
+    logger;
+    constructor(options) {
+        this.api = options.api;
+        this.handler = options.handler;
+        this.pollTimeoutSec = options.pollTimeoutSec ?? 30;
+        this.maxBackoffMs = options.maxBackoffMs ?? 30_000;
+        this.logger = options.logger ?? defaultLogger;
+    }
+    /** Start the polling loop. This method runs until stop() is called. */
+    async start() {
+        if (this.running)
+            return;
+        this.running = true;
+        this.abortController = new AbortController();
+        this.logger.info('Polling started');
+        while (this.running) {
+            try {
+                const updates = await this.api.getUpdates(this.offset, this.pollTimeoutSec, this.abortController?.signal);
+                this.consecutiveErrors = 0;
+                for (const update of updates) {
+                    this.offset = update.update_id + 1;
+                    await this.processUpdate(update);
+                }
+            }
+            catch (err) {
+                if (!this.running)
+                    break;
+                await this.handlePollingError(err);
+            }
+        }
+        this.logger.info('Polling stopped');
+    }
+    /** Signal the polling loop to stop. */
+    stop() {
+        this.running = false;
+        this.abortController?.abort();
+        this.abortController = null;
+    }
+    /** Whether the poller is currently running. */
+    isRunning() {
+        return this.running;
+    }
+    // -----------------------------------------------------------------------
+    // Internal
+    // -----------------------------------------------------------------------
+    async processUpdate(update) {
+        try {
+            await this.handler(update);
+        }
+        catch (err) {
+            this.logger.error(`Update handler error for update_id=${update.update_id}`, err instanceof Error ? err.message : err);
+        }
+    }
+    async handlePollingError(err) {
+        this.consecutiveErrors++;
+        // Telegram rate limit: respect the retry_after value.
+        if (err instanceof TelegramApiError && err.retryAfter) {
+            const waitMs = err.retryAfter * 1000;
+            this.logger.warn(`Rate limited, waiting ${err.retryAfter}s`);
+            await this.sleep(waitMs);
+            return;
+        }
+        // Exponential backoff: 1s, 2s, 4s, 8s, ... up to maxBackoffMs.
+        const backoffMs = Math.min(1000 * Math.pow(2, this.consecutiveErrors - 1), this.maxBackoffMs);
+        const errorMessage = err instanceof Error ? err.message : String(err);
+        this.logger.error(`Polling error (retry in ${backoffMs}ms): ${errorMessage}`);
+        await this.sleep(backoffMs);
+    }
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+//# sourceMappingURL=poller.js.map

package/dist/poller.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,158 @@
+/**
+ * Telegram Bot API Type Definitions
+ * Covers all message types, media attachments, and API responses.
+ */
+export interface TelegramUser {
+    id: number;
+    is_bot: boolean;
+    first_name: string;
+    last_name?: string;
+    username?: string;
+    language_code?: string;
+}
+export interface TelegramChat {
+    id: number;
+    type: 'private' | 'group' | 'supergroup' | 'channel';
+    title?: string;
+    username?: string;
+    first_name?: string;
+    last_name?: string;
+    is_forum?: boolean;
+}
+export interface TelegramPhotoSize {
+    file_id: string;
+    file_unique_id: string;
+    width: number;
+    height: number;
+    file_size?: number;
+}
+export interface TelegramDocument {
+    file_id: string;
+    file_unique_id: string;
+    file_name?: string;
+    mime_type?: string;
+    file_size?: number;
+}
+export interface TelegramAudio {
+    file_id: string;
+    file_unique_id: string;
+    duration: number;
+    performer?: string;
+    title?: string;
+    mime_type?: string;
+    file_size?: number;
+}
+export interface TelegramVideo {
+    file_id: string;
+    file_unique_id: string;
+    width: number;
+    height: number;
+    duration: number;
+    mime_type?: string;
+    file_size?: number;
+}
+export interface TelegramVoice {
+    file_id: string;
+    file_unique_id: string;
+    duration: number;
+    mime_type?: string;
+    file_size?: number;
+}
+export interface TelegramVideoNote {
+    file_id: string;
+    file_unique_id: string;
+    length: number;
+    duration: number;
+    file_size?: number;
+}
+export interface TelegramSticker {
+    file_id: string;
+    file_unique_id: string;
+    type: 'regular' | 'mask' | 'custom_emoji';
+    width: number;
+    height: number;
+    is_animated: boolean;
+    is_video: boolean;
+    emoji?: string;
+    set_name?: string;
+    file_size?: number;
+}
+export interface TelegramAnimation {
+    file_id: string;
+    file_unique_id: string;
+    width: number;
+    height: number;
+    duration: number;
+    mime_type?: string;
+    file_size?: number;
+}
+export interface TelegramContact {
+    phone_number: string;
+    first_name: string;
+    last_name?: string;
+    user_id?: number;
+}
+export interface TelegramLocation {
+    longitude: number;
+    latitude: number;
+}
+export interface TelegramMessage {
+    message_id: number;
+    from?: TelegramUser;
+    chat: TelegramChat;
+    date: number;
+    text?: string;
+    caption?: string;
+    reply_to_message?: TelegramMessage;
+    message_thread_id?: number;
+    photo?: TelegramPhotoSize[];
+    document?: TelegramDocument;
+    audio?: TelegramAudio;
+    video?: TelegramVideo;
+    voice?: TelegramVoice;
+    video_note?: TelegramVideoNote;
+    sticker?: TelegramSticker;
+    animation?: TelegramAnimation;
+    contact?: TelegramContact;
+    location?: TelegramLocation;
+    forward_date?: number;
+    forward_from?: TelegramUser;
+}
+export interface TelegramUpdate {
+    update_id: number;
+    message?: TelegramMessage;
+    edited_message?: TelegramMessage;
+}
+export interface TelegramApiResponse<T> {
+    ok: boolean;
+    result?: T;
+    description?: string;
+    error_code?: number;
+    parameters?: {
+        retry_after?: number;
+    };
+}
+export interface TelegramFileInfo {
+    file_id: string;
+    file_unique_id: string;
+    file_size?: number;
+    file_path?: string;
+}
+export interface TelegramBotInfo {
+    id: number;
+    is_bot: boolean;
+    first_name: string;
+    username: string;
+}
+export interface TelegramChannelConfig {
+    /** Bot token from @BotFather */
+    botToken: string;
+    /** Allowed user IDs (whitelist). Empty array = allow all. */
+    allowedUserIds: number[];
+    /** Long-polling timeout in seconds (default: 30) */
+    pollTimeoutSec?: number;
+    /** Maximum file download size in bytes (default: 20MB) */
+    maxFileSize?: number;
+}
+export type ChannelMessageType = 'text' | 'photo' | 'audio' | 'video' | 'voice' | 'video_note' | 'document' | 'sticker' | 'location' | 'contact' | 'animation';
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * Telegram Bot API Type Definitions
+ * Covers all message types, media attachments, and API responses.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@daemux/telegram-adapter",
+  "version": "1.0.0",
+  "description": "Telegram Bot API channel adapter for daemux",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@daemux/plugin-sdk": "^0.5.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.9",
+    "typescript": "^5.9.0"
+  },
+  "peerDependencies": {
+    "daemux": "^0.1.0"
+  },
+  "peerDependenciesMeta": {
+    "daemux": {
+      "optional": true
+    }
+  },
+  "files": [
+    "dist",
+    ".claude-plugin"
+  ],
+  "keywords": [
+    "daemux",
+    "telegram",
+    "channel",
+    "bot"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/daemux/daemux-plugins.git",
+    "directory": "channels/telegram-adapter"
+  }
+}