grammY news

🎉 Release of grammY 1.8 🎉

This update brings support for the recently released Telegram Bot API 6.0. This means that grammY and its plugins now have full support for Web Bots.

What's new:
+ Added support for Bot API 6.0.
+ Added supported for Web Bots to the built-in keyboard plugins.
+ Release 1.1.0 of the menu plugin:
+ Added support for Inline Keyboard Web Bots.
+ Release 1.1.0 of the hydration plugin:
+ Added hydration for answers to Web App Queries.
+ Added hydration for callback query updates based on inline messages identifiers.
+ Added hydration for chosen inline results.
+ New plugin: grammY validator let's you easily validate the data received from Web Apps. It can also check the authorization data for Telegram Login Widgets. The plugin has now reached 1.0 and is considered stable.
+ New plugin: grammY web-app provides a type-safe version of the fundamental building block for building Telegram Web Apps. Note that this plugin is still in its infant stage. Please try it out, feedback is welcome!
+ Various fixes and improvements.

Enjoy!

A good choice for translating software is Fluent (https://projectfluent.org/).

With the new fluent plugin, you can use Fluent to let your bot speak multiple languages! The plugin has now reached 1.0 and is considered stable. It provides a convenient integration with the Fluent localisation system, which makes it super simple to provide translations for your bot and let your bot respond in different languages. Now all you have to do is translate! Docs are here!

The current i18n plugin can integrate with any localisation system. However, it can sometimes be cumbersome to use. In contrast, the fluent plugin focuses on one integration, and it does it well. Give it a try!

🎉 Release of grammY 1.7 🎉

This update brings support for the recently released Telegram Bot API 5.7.

Once again, this release includes bug fixes and small improvements, such as bot.isInited() to determine if the bot was already initialized.

Are you using a lot of strikethrough, italic, underline, bold (you expected “spoiler”?), or other message entities in your bot? Then the parse-mode plugin is for you! It provides convenient helper methods so you don't have to specify the cumbersome { "parse_mode": "MarkdownV2" } anymore. Today, the plugin has reached 1.0 and is considered stable. Try it now, and check out the docs!

Copy-pasting emoji sucks. There is now an emoji plugin which makes it super simple to include emoji in your bot by looking them up with their name. No more emojis in your bot code! The plugin has reached 1.0 and is considered stable. Thanks to everyone who contributed! :party_popper:

🎉 Release of grammY 1.6 🎉

This update brings support for the recently released Telegram Bot API 5.6.

As always, this release includes bug fixes and other small improvements. For example, grammY now uses TypeScript 4.5.

⭐️⭐️⭐️

grammY 1.0 is not even 8 months old, but counted in GitHub stars, grammY is already the fourth-most used Telegram bot framework for Node.js! 🎉

If you only count projects that have received at least one Bot API update in the last 18 months, grammY is in the top 3 projects for Node.js!

Measured in any thinkable way, grammY is by far the most popular bot framework that runs on Deno! 🥳

🎉 Release of grammY 1.5 🎉

This update brings support for the recently released Telegram Bot API 5.5.

This release also includes a few smaller improvements and updated inline documentation.

🇷🇺 There's now a Russian community chat! 🇷🇺
Join here: @grammyjs_ru

In a joint effort, several contributors spent weeks on translating grammy.dev. It is now 100 % available in Chinese. Thanks to all of them!

If you want to translate the documentation into your language, please read this guide before you start your work!

The menu plugin has reached 1.0 and is now considered stable. This plugin lets you easily add interactive buttons underneath messages. Navigating between different pages has never been easier! Try it out now, and have a look at the docs! 🥳

🎉 Release of grammY 1.4 🎉

This update brings support for the recently released Telegram Bot API 5.4.

grammY also migrated to a new build tool that allows us to write code for Deno, and compile it for Node.js. It replaces our old shell scripts. Having proper tooling makes it much easier to contribute code. You can even install grammY from source now—npm install grammyjs/grammy will download the most recent code from GitHub, and install it directly into your node_modules folder.

This release also includes a bunch of fixes and smaller improvements.

Check out the new Awesome grammY list—a curated list of awesome projects that are powered by grammY!

Open a PR to add your own project to the list! Alternatively, drop us a message in the @grammyjs group chat if you built another impressive project that you'd like to show to people!

🎉 Release of grammY 1.3 🎉

This update is all about more convenience.

What's new for Bot:
+ Added an onStart callback that is run after initialisation, and before polling starts.
+ The bot.botInfo property is now public and available after initialising the bot.
+ Added an automatic memory leak prevention for inexperienced users.

What's new for filter queries:
+ Added shortcuts that group queries commonly used together, example: bot.on('edit').
+ Implemented an optimisation engine that automatically improves filter query performance.
+ Filter query types can now more accurately tell if a query does not make sense, e.g. channel_post:left_chat_member (that message type does not exist).

What's new for Context:
+ The shortcuts ctx.chat and ctx.from respect chat_member and my_chat_member updates.
+ Added a getFile method.
+ Transformative context flavours are a more powerful type of context flavour that enable new categories of plugins.

What's new for command handling:
+ Added auto-complete suggestions for 'start', 'help', and 'settings'.
+ Improved types for command arguments.
+ Fixed handling commands @-directed for other bots.

What's new for the internal client implementation:
+ Added API flavours that let you install custom types to align API methods with your installed transformers.
+ Allow transformers to throw their own errors. They were considered as network errors before.
+ Added a flag to the bot configuration that activates sensitive logs. This allows you to print raw network error messages if DEBUG is set, but it will leak the bot token.
+ Improved client speed for handling nested objects such as inline keyboards.

What's new for docs and error handling:
+ Automatic stopping of polling when the token is wrong or another instance is running.
+ Improved lots of error messages, this includes those during polling.
+ Added numerous new sections to grammy.dev for this update.
+ Improved inline documentation in many places.
+ Updated Telegram Bot API types and documentation.

Transformative context flavours in combination with API flavours enable a wealth of new exciting plugins. For now, there are two of them:
+ New hydration plugin. Installs convenient methods on API call results and on the context object. It has now reached 1.0 and is considered stable.
+ New files plugin. Makes downloading files as simple as file.download(). It has now reached 1.0 and is considered stable.

Update your dependencies and enjoy!

🎉 Release of grammY 1.2 🎉

This update brings support for the recently released Telegram Bot API 5.3.

In addition, a workaround was implemented in grammY for a current bug in TypeScript 4.3 so the project compiles again. If your code is affected by the bug, downgrade to TypeScript 4.2 for now.
Note that a fix for the bug has been implemented in this PR (and I have verified that it solves our problem), but we're still waiting for Microsoft to click Merge.
Update: The pull request was merged and the fix will be shipped with TypeScript 4.4.
Update: Everything works as expected again.

The stable plugin to rate-limit individual users called rateLimiter has been transferred to the @grammyjs organisation and its current version 1.1.3 is now published both under @grammyjs/ratelimiter on npm and under grammy_ratelimiter on deno.land/x. The plugin tracks the number of messages inside, say, a particular chat, and automatically prevents users from spamming your bot. The documentation will be updated soon. (Edit: docs are updated!)

The documentation website under grammy.dev is now available in dark mode. It automatically adjusts to your system settings.

Starting today, you can also search the grammY docs right inside Telegram with the new @grammYdocsbot.

The flood control plugin called transformer-throttler has reached 1.0 and is now considered stable. This plugin makes sure your bot automatically avoids hitting rate limits. It is a much more mature approach than the recently introduced auto-retry plugin. Be sure to check out the updated documentation!

🎉 Release of grammY 1.1 🎉

This update is all about improved error handling.

What's new:
+ Error boundaries. A novel way to handle errors across files.
+ Introduction of the HttpError object. This makes it easier to handle failing network requests.
+ Improved error types. You now have type safety when handling ResponseParameter objects.
+ Improved error documentation. All error objects now have thorough JSDocs. (The official Telegram Bot API Reference is missing them.)
+ New plugin: grammY auto-retry let's you automatically retry API requests that fail with retry_after specified. It has now reached 1.0 and is considered stable.

Enjoy!