Home

Awesome

telegram-bot-api-types

Telegram Bot API SDK compiled size is 0KB that only includes type definition files and JSDoc files. It can be used to conveniently develop Telegram Bots in TypeScript and JavaScript. You can wrap your API client with as many web request libraries as you want.

This is a d.ts and jsdoc file for Telegram Bot API. It is based on the official Telegram Bot API documentation.

Installation

npm i telegram-bot-api-types --save-dev # d.ts for TypeScript
npm i telegram-bot-api-jsdoc --save-dev # jsdoc for JavaScript

Example

You can use any HTTP request library you want to encapsulate your API client. Here is a simple echo bot.

import type * as Telegram from "telegram-bot-api-types"; // Import the types with namespace
import * as fs from 'node:fs';

class APIClientBase {
    // Implement your request method
    // you can use any http request library you want
    // You can go to `test` to see an example of the implementation
}

type APIClient = APIClientBase & Telegram.AllBotMethods;

// Use Proxy to automatically call the methods
export function createAPIClient(token: string): APIClient {
    const client = new APIClientBase(token);
    return new Proxy(client, {
        get(target, prop, receiver) {
            if (prop in target) {
                return Reflect.get(target, prop, receiver);
            }
            return (...args: any[]) => {
                if (typeof prop === 'string' && prop.endsWith('WithReturns')) {
                    const method = prop.slice(0, -11) as Telegram.BotMethod;
                    return Reflect.apply(target.requestJSON, target, [method, ...args]);
                }
                return Reflect.apply(target.request, target, [prop as Telegram.BotMethod, ...args]);
            };
        }
    }) as APIClient;
}

async function main() {
    const { token } = JSON.parse(fs.readFileSync('config.json', 'utf8'));
    const client = createAPIClient(token);
    const { result: user } = await client.getMeWithReturns()
    console.log(`Hello! My name is ${user.username}`);
    await client.deleteWebhook({});
    while (true) {
        const { result: updates } = await client.getUpdatesWithReturns({ offset: 0 });
        for (const update of updates) {
            if (update.message) {
                await client.sendMessageWithReturns({ chat_id: update.message.chat.id, text: update.message.text });
            }
        }
    }
}

main().catch(console.error);

You don't need to implement the methods one by one, you can use the Proxy object to create a client that automatically calls the methods. You can find the implementation of the APIClientBase class in the test folder.

If you want to use javascript, you can follow the example jsdoc.test.js

License

telegram-bot-api-types is released under the MIT license. See LICENSE for details.