wrappergram

Simple and tiny code-generated Telegram Bot API wrapper for TypeScript/JavaScript with file upload support.

🌐 Multi-runtime - Works on Node.js, Bun and Deno

⚙️ Code-generated - For example, code-generated and auto-published Telegram Bot API types)

🛡️ Type-safe - Written in TypeScript with love ❤️

🤏 Tiny - Simple sendMessage call cost some  in bundle size. So it is a good choice for browser/serverless environments

But if you need a more complete framework, then please look to GramIO.

$3

``ts
import { Telegram, getUpdates } from "wrappergram";

const telegram = new Telegram(process.env.BOT_TOKEN as string);

telegram.api.sendMessage({
chat_id: 617580375,
text: "Hello!",
});

for await (const update of getUpdates(telegram)) {
console.log(update);

if (update.message?.from) {
telegram.api.sendMessage({
chat_id: update.message.from.id,
text: "Hi! Thanks for the message",
});
}
}
`

This example on bundlejs cost ![bundlejs](https://bundlejs.com/?q=wrappergram&treeshake=%5B%5D&share=MYewdgzgLgBFCmAbeBzATgQwLYwLwzHgHcYAVJVTLACgAc0Rh4IIA6eMAN1YCEB5UgH1SfANIBRAHIBKANwAoeQmTpsrDLQCWrCBwAmAWWYQMKeNQDe8mDZjAAFhiiDNegFwwAbAEYA7AFYADgAGAGYAgBprWwQADygPACIACSREEABCRKiAXzlFADMQNBgMIgxNWGpQSFgAV1o9J3gYEAKYMygAVUbmiGplSmxpaRgrWztwCBBkVnSUagamhHzom012xd6EVixjU3gAflYChixR8YmYilUsdS0dfSMWA8s1q4mHJxd3GCXm3b7MwnM6sVxRD4fOIJGApTQZMiOMAAawgMCKJSg9haexeZmy7wmeQURPkOSAA)

> [!IMPORTANT]
> Use getUpdates only once in your code otherwise it will cause double calls to getUpdates

$3

You can send requests to Telegram Bot API Methods via telegram.api with full type-safety!

`ts
const response = await telegram.api.sendMessage({
chat_id: "@gramio_forum",
text: "Hello, world!",
});

if (!response.ok) console.error("Something went wrong");
else console.log(New message id is ${response.result.message_id});
`

$3

For keyboards you need to install @gramio/keyboard library and just use it!

`ts
import { Keyboard } from "@gramio/keyboards";

// telegram init
telegram.api.sendMessage({
chat_id: "@gramio_forum",
text: "Hello, world!",
reply_markup: new InlineKeyboard().url(
"GitHub",
"https://github.com/gramiojs/wrappergram"
),
});
`

This example cost - ![bundlejs;\n\ntelegram.api.sendMessage({\n++chat_id:+617580375,\n++text:+%22Hello!%22,\n++reply_markup:+new+InlineKeyboard().url(%22GitHub%22,+%22https://github.com/gramiojs/wrappergram%22)\n});%22>)](https://bundlejs.com/?q=wrappergram%2C%40gramio%2Fkeyboards&treeshake=%5B%5D%2C%5B%5D&text=%22const+telegram+%3D+new+Telegram%28process.env.BOT_TOKEN%29%3B%5Cn%5Cntelegram.api.sendMessage%28%7B%5Cn++chat_id%3A+617580375%2C%5Cn++text%3A+%5C%22Hello%21%5C%22%2C%5Cn++reply_markup%3A+new+InlineKeyboard%28%29.url%28%5C%22GitHub%5C%22%2C+%5C%22https%3A%2F%2Fgithub.com%2Fgramiojs%2Fwrappergram%5C%22%29%5Cn%7D%29%3B%22)

Read more here

$3

@gramio/files already used under the hood so you don't need to install it

`ts
import { MediaUpload } from "wrappergram";

telegram.api.sendPhoto({
chat_id: "@gramio_forum",
text: "Hello, world!",
photo: MediaUpload.path("./cute-cat.png"),
});

telegram.api.sendDocument({
chat_id: "@gramio_forum",
text: "Hello, world!",
photo: Bun.file("README.md"), // you can use File instance to upload files
});
``

This example cost - 

Read more here