grammy 1.34.1 → 1.35.0

package/README.md

@@ -10,7 +10,7 @@
 
 <!-- deno-fmt-ignore-start -->
 
-[![Bot API](https://img.shields.io/badge/Bot%20API-8.2-blue?logo=telegram&style=flat&labelColor=000&color=3b82f6)](https://core.telegram.org/bots/api)
+[![Bot API](https://img.shields.io/badge/Bot%20API-8.3-blue?logo=telegram&style=flat&labelColor=000&color=3b82f6)](https://core.telegram.org/bots/api)
 [![Deno](https://shield.deno.dev/x/grammy)](https://deno.land/x/grammy)
 [![npm](https://img.shields.io/npm/v/grammy?logo=npm&style=flat&labelColor=000&color=3b82f6)](https://www.npmjs.org/package/grammy)
 [![All Contributors](https://img.shields.io/github/all-contributors/grammyjs/grammy?style=flat&labelColor=000&color=3b82f6)](#contributors-)
@@ -322,6 +322,7 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
       <td align="center" valign="top" width="11.11%"><a href="https://github.com/mahovich"><img src="https://avatars.githubusercontent.com/u/2377626?v=4?s=100" width="100px;" alt="mahovich"/><br /><sub><b>mahovich</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/commits?author=mahovich" title="Documentation">📖</a></td>
       <td align="center" valign="top" width="11.11%"><a href="https://github.com/Hth4nh"><img src="https://avatars.githubusercontent.com/u/63627651?v=4?s=100" width="100px;" alt="Thành Hoàng Trần"/><br /><sub><b>Thành Hoàng Trần</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/commits?author=Hth4nh" title="Documentation">📖</a></td>
       <td align="center" valign="top" width="11.11%"><a href="https://github.com/ikelax"><img src="https://avatars.githubusercontent.com/u/163678144?v=4?s=100" width="100px;" alt="ikelax"/><br /><sub><b>ikelax</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/commits?author=ikelax" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="11.11%"><a href="http://zeokku.com"><img src="https://avatars.githubusercontent.com/u/22231294?v=4?s=100" width="100px;" alt="Lutymane"/><br /><sub><b>Lutymane</b></sub></a><br /><a href="https://github.com/grammyjs/grammY/commits?author=Lutymane" title="Code">💻</a></td>
     </tr>
   </tbody>
 </table>

package/out/context.d.ts

@@ -703,7 +703,7 @@ export declare class Context implements RenamedUpdate {
      */
     replyWithChatAction(action: "typing" | "upload_photo" | "record_video" | "upload_video" | "record_voice" | "upload_voice" | "upload_document" | "choose_sticker" | "find_location" | "record_video_note" | "upload_video_note", other?: Other<"sendChatAction", "chat_id" | "action">, signal?: AbortSignal): Promise<true>;
     /**
-     * Context-aware alias for `api.setMessageReaction`. Use this method to change the chosen reactions on a message. Service messages can't be reacted to. Automatically forwarded messages from a channel to its discussion group have the same available reactions as messages in the channel. Bots can't use paid reactions. Returns True on success.
+     * Context-aware alias for `api.setMessageReaction`. Use this method to change the chosen reactions on a message. Service messages of some types can't be reacted to. Automatically forwarded messages from a channel to its discussion group have the same available reactions as messages in the channel. Bots can't use paid reactions. Returns True on success.
      *
      * @param reaction A list of reaction types to set on the message. Currently, as non-premium users, bots can set up to one reaction per message. A custom emoji reaction can be used if it is either already present on the message or explicitly allowed by chat administrators. Paid reactions can't be used by bots.
      * @param other Optional remaining parameters, confer the official reference below
@@ -1324,7 +1324,7 @@ export declare class Context implements RenamedUpdate {
      */
     getCustomEmojiStickers(signal?: AbortSignal): Promise<import("@grammyjs/types/message.js").Sticker[]>;
     /**
-     * Context-aware alias for `api.sendGift`. Sends a gift to the given user. The gift can't be converted to Telegram Stars by the user. Returns True on success.
+     * Context-aware alias for `api.sendGift`. Sends a gift to the given user. The gift can't be converted to Telegram Stars by the receiver. Returns True on success.
      *
      * @param gift_id Identifier of the gift
      * @param other Optional remaining parameters, confer the official reference below
@@ -1332,7 +1332,17 @@ export declare class Context implements RenamedUpdate {
      *
      * **Official reference:** https://core.telegram.org/bots/api#sendgift
      */
-    replyWithGift(gift_id: string, other?: Other<"sendGift", "user_id" | "gift_id">, signal?: AbortSignal): Promise<import("@grammyjs/types/payment.js").Gifts>;
+    replyWithGift(gift_id: string, other?: Other<"sendGift", "user_id" | "chat_id" | "gift_id">, signal?: AbortSignal): Promise<import("@grammyjs/types/payment.js").Gifts>;
+    /**
+     * Context-aware alias for `api.sendGift`. Sends a gift to the given channel chat. The gift can't be converted to Telegram Stars by the receiver. Returns True on success.
+     *
+     * @param gift_id Identifier of the gift
+     * @param other Optional remaining parameters, confer the official reference below
+     * @param signal Optional `AbortSignal` to cancel the request
+     *
+     * **Official reference:** https://core.telegram.org/bots/api#sendgift
+     */
+    replyWithGiftToChannel(gift_id: string, other?: Other<"sendGift", "user_id" | "chat_id" | "gift_id">, signal?: AbortSignal): Promise<import("@grammyjs/types/payment.js").Gifts>;
     /**
      * Context-aware alias for `api.answerInlineQuery`. Use this method to send answers to an inline query. On success, True is returned.
      * No more than 50 results per query are allowed.

package/out/context.js

@@ -943,7 +943,7 @@ class Context {
         return this.api.sendChatAction(orThrow(this.chatId, "sendChatAction"), action, { business_connection_id: this.businessConnectionId, ...other }, signal);
     }
     /**
-     * Context-aware alias for `api.setMessageReaction`. Use this method to change the chosen reactions on a message. Service messages can't be reacted to. Automatically forwarded messages from a channel to its discussion group have the same available reactions as messages in the channel. Bots can't use paid reactions. Returns True on success.
+     * Context-aware alias for `api.setMessageReaction`. Use this method to change the chosen reactions on a message. Service messages of some types can't be reacted to. Automatically forwarded messages from a channel to its discussion group have the same available reactions as messages in the channel. Bots can't use paid reactions. Returns True on success.
      *
      * @param reaction A list of reaction types to set on the message. Currently, as non-premium users, bots can set up to one reaction per message. A custom emoji reaction can be used if it is either already present on the message or explicitly allowed by chat administrators. Paid reactions can't be used by bots.
      * @param other Optional remaining parameters, confer the official reference below
@@ -1743,7 +1743,7 @@ class Context {
             .map((e) => e.custom_emoji_id), signal);
     }
     /**
-     * Context-aware alias for `api.sendGift`. Sends a gift to the given user. The gift can't be converted to Telegram Stars by the user. Returns True on success.
+     * Context-aware alias for `api.sendGift`. Sends a gift to the given user. The gift can't be converted to Telegram Stars by the receiver. Returns True on success.
      *
      * @param gift_id Identifier of the gift
      * @param other Optional remaining parameters, confer the official reference below
@@ -1754,6 +1754,18 @@ class Context {
     replyWithGift(gift_id, other, signal) {
         return this.api.sendGift(orThrow(this.from, "sendGift").id, gift_id, other, signal);
     }
+    /**
+     * Context-aware alias for `api.sendGift`. Sends a gift to the given channel chat. The gift can't be converted to Telegram Stars by the receiver. Returns True on success.
+     *
+     * @param gift_id Identifier of the gift
+     * @param other Optional remaining parameters, confer the official reference below
+     * @param signal Optional `AbortSignal` to cancel the request
+     *
+     * **Official reference:** https://core.telegram.org/bots/api#sendgift
+     */
+    replyWithGiftToChannel(gift_id, other, signal) {
+        return this.api.sendGiftToChannel(orThrow(this.chat, "sendGift").id, gift_id, other, signal);
+    }
     /**
      * Context-aware alias for `api.answerInlineQuery`. Use this method to send answers to an inline query. On success, True is returned.
      * No more than 50 results per query are allowed.

package/out/convenience/frameworks.d.ts

@@ -71,6 +71,14 @@ export type CloudflareAdapter = (event: {
     respondWith: (response: Promise<Response>) => void;
 }) => ReqResHandler;
 export type CloudflareModuleAdapter = (request: Request) => ReqResHandler<Response>;
+export type ElysiaAdapter = (ctx: {
+    body: Update;
+    headers: Record<string, string | undefined>;
+    set: {
+        headers: Record<string, string>;
+        status: number;
+    };
+}) => ReqResHandler<string>;
 export type ExpressAdapter = (req: {
     body: Update;
     header: (header: string) => string | undefined;
@@ -186,6 +194,7 @@ export declare const adapters: {
     bun: BunAdapter;
     cloudflare: CloudflareAdapter;
     "cloudflare-mod": CloudflareModuleAdapter;
+    elysia: ElysiaAdapter;
     express: ExpressAdapter;
     fastify: FastifyAdapter;
     hono: HonoAdapter;

package/out/convenience/frameworks.js

@@ -307,6 +307,30 @@ const worktop = (req, res) => {
         unauthorized: () => res.send(401, WRONG_TOKEN_ERROR),
     });
 };
+const elysia = (ctx) => {
+    // @note upgrade target to use modern code?
+    // const { promise, resolve } = Promise.withResolvers<string>();
+    let resolve;
+    const handlerReturn = new Promise((res) => resolve = res);
+    return {
+        // @note technically the type shouldn't be limited to Promise, because it's fine to await plain values as well
+        update: Promise.resolve(ctx.body),
+        header: ctx.headers[SECRET_HEADER_LOWERCASE],
+        end() {
+            resolve("");
+        },
+        respond(json) {
+            // @note since json is passed as string here, we gotta define proper content-type
+            ctx.set.headers["content-type"] = "application/json";
+            resolve(json);
+        },
+        unauthorized() {
+            ctx.set.status = 401;
+            resolve("");
+        },
+        handlerReturn,
+    };
+};
 // Please open a pull request if you want to add another adapter
 exports.adapters = {
     "aws-lambda": awsLambda,
@@ -315,6 +339,7 @@ exports.adapters = {
     bun,
     cloudflare,
     "cloudflare-mod": cloudflareModule,
+    elysia,
     express,
     fastify,
     hono,

package/out/convenience/webhook.d.ts

@@ -9,6 +9,7 @@ declare const adapters: {
     bun: import("./frameworks.js").BunAdapter;
     cloudflare: import("./frameworks.js").CloudflareAdapter;
     "cloudflare-mod": import("./frameworks.js").CloudflareModuleAdapter;
+    elysia: import("./frameworks.js").ElysiaAdapter;
     express: import("./frameworks.js").ExpressAdapter;
     fastify: import("./frameworks.js").FastifyAdapter;
     hono: import("./frameworks.js").HonoAdapter;

package/out/core/api.d.ts

@@ -421,7 +421,7 @@ export declare class Api<R extends RawApi = RawApi> {
      */
     sendDice(chat_id: number | string, emoji: (string & Record<never, never>) | "🎲" | "🎯" | "🏀" | "⚽" | "🎳" | "🎰", other?: Other<R, "sendDice", "chat_id" | "emoji">, signal?: AbortSignal): Promise<import("@grammyjs/types/message.js").Message.DiceMessage>;
     /**
-     * Use this method to change the chosen reactions on a message. Service messages can't be reacted to. Automatically forwarded messages from a channel to its discussion group have the same available reactions as messages in the channel. Bots can't use paid reactions. Returns True on success.
+     * Use this method to change the chosen reactions on a message. Service messages of some types can't be reacted to. Automatically forwarded messages from a channel to its discussion group have the same available reactions as messages in the channel. Bots can't use paid reactions. Returns True on success.
      *
      * @param chat_id Unique identifier for the target chat or username of the target channel (in the format @channelusername)
      * @param message_id Identifier of the target message
@@ -1363,7 +1363,7 @@ export declare class Api<R extends RawApi = RawApi> {
      */
     setCustomEmojiStickerSetThumbnail(name: string, custom_emoji_id: string, signal?: AbortSignal): Promise<true>;
     /**
-     * Returns the list of gifts that can be sent by the bot to users. Requires no parameters. Returns a Gifts object.
+     * Returns the list of gifts that can be sent by the bot to users and channel chats. Requires no parameters. Returns a Gifts object.
      *
      * @param signal Optional `AbortSignal` to cancel the request
      *
@@ -1371,16 +1371,27 @@ export declare class Api<R extends RawApi = RawApi> {
      */
     getAvailableGifts(signal?: AbortSignal): Promise<import("@grammyjs/types/payment.js").Gifts>;
     /**
-     * Sends a gift to the given user. The gift can't be converted to Telegram Stars by the user. Returns True on success.
+     * Sends a gift to the given user. The gift can't be converted to Telegram Stars by the receiver. Returns True on success.
      *
-     * @param user_id Unique identifier of the target user that will receive the gift
+     * @param user_id Unique identifier of the target user who will receive the gift
      * @param gift_id Identifier of the gift
      * @param other Optional remaining parameters, confer the official reference below
      * @param signal Optional `AbortSignal` to cancel the request
      *
      * **Official reference:** https://core.telegram.org/bots/api#sendgift
      */
-    sendGift(user_id: number, gift_id: string, other?: Other<R, "sendGift", "user_id" | "gift_id">, signal?: AbortSignal): Promise<import("@grammyjs/types/payment.js").Gifts>;
+    sendGift(user_id: number, gift_id: string, other?: Other<R, "sendGift", "user_id" | "chat_id" | "gift_id">, signal?: AbortSignal): Promise<import("@grammyjs/types/payment.js").Gifts>;
+    /**
+     * Sends a gift to the given channel chat. The gift can't be converted to Telegram Stars by the receiver. Returns True on success.
+     *
+     * @param chat_id Unique identifier for the chat or username of the channel (in the format @channelusername) that will receive the gift
+     * @param gift_id Identifier of the gift
+     * @param other Optional remaining parameters, confer the official reference below
+     * @param signal Optional `AbortSignal` to cancel the request
+     *
+     * **Official reference:** https://core.telegram.org/bots/api#sendgift
+     */
+    sendGiftToChannel(chat_id: number | string, gift_id: string, other?: Other<R, "sendGift", "user_id" | "chat_id" | "gift_id">, signal?: AbortSignal): Promise<import("@grammyjs/types/payment.js").Gifts>;
     /**
      * Use this method to send answers to an inline query. On success, True is returned.
      * No more than 50 results per query are allowed.

package/out/core/api.js

@@ -452,7 +452,7 @@ class Api {
         return this.raw.sendDice({ chat_id, emoji, ...other }, signal);
     }
     /**
-     * Use this method to change the chosen reactions on a message. Service messages can't be reacted to. Automatically forwarded messages from a channel to its discussion group have the same available reactions as messages in the channel. Bots can't use paid reactions. Returns True on success.
+     * Use this method to change the chosen reactions on a message. Service messages of some types can't be reacted to. Automatically forwarded messages from a channel to its discussion group have the same available reactions as messages in the channel. Bots can't use paid reactions. Returns True on success.
      *
      * @param chat_id Unique identifier for the target chat or username of the target channel (in the format @channelusername)
      * @param message_id Identifier of the target message
@@ -1584,7 +1584,7 @@ class Api {
         }, signal);
     }
     /**
-     * Returns the list of gifts that can be sent by the bot to users. Requires no parameters. Returns a Gifts object.
+     * Returns the list of gifts that can be sent by the bot to users and channel chats. Requires no parameters. Returns a Gifts object.
      *
      * @param signal Optional `AbortSignal` to cancel the request
      *
@@ -1594,9 +1594,9 @@ class Api {
         return this.raw.getAvailableGifts(signal);
     }
     /**
-     * Sends a gift to the given user. The gift can't be converted to Telegram Stars by the user. Returns True on success.
+     * Sends a gift to the given user. The gift can't be converted to Telegram Stars by the receiver. Returns True on success.
      *
-     * @param user_id Unique identifier of the target user that will receive the gift
+     * @param user_id Unique identifier of the target user who will receive the gift
      * @param gift_id Identifier of the gift
      * @param other Optional remaining parameters, confer the official reference below
      * @param signal Optional `AbortSignal` to cancel the request
@@ -1606,6 +1606,19 @@ class Api {
     sendGift(user_id, gift_id, other, signal) {
         return this.raw.sendGift({ user_id, gift_id, ...other }, signal);
     }
+    /**
+     * Sends a gift to the given channel chat. The gift can't be converted to Telegram Stars by the receiver. Returns True on success.
+     *
+     * @param chat_id Unique identifier for the chat or username of the channel (in the format @channelusername) that will receive the gift
+     * @param gift_id Identifier of the gift
+     * @param other Optional remaining parameters, confer the official reference below
+     * @param signal Optional `AbortSignal` to cancel the request
+     *
+     * **Official reference:** https://core.telegram.org/bots/api#sendgift
+     */
+    sendGiftToChannel(chat_id, gift_id, other, signal) {
+        return this.raw.sendGift({ chat_id, gift_id, ...other }, signal);
+    }
     /**
      * Use this method to send answers to an inline query. On success, True is returned.
      * No more than 50 results per query are allowed.

package/out/web.mjs

@@ -1083,6 +1083,9 @@ class Context {
     replyWithGift(gift_id, other, signal) {
         return this.api.sendGift(orThrow(this.from, "sendGift").id, gift_id, other, signal);
     }
+    replyWithGiftToChannel(gift_id, other, signal) {
+        return this.api.sendGiftToChannel(orThrow(this.chat, "sendGift").id, gift_id, other, signal);
+    }
     answerInlineQuery(results, other, signal) {
         return this.api.answerInlineQuery(orThrow(this.inlineQuery, "answerInlineQuery").id, results, other, signal);
     }
@@ -3232,6 +3235,13 @@ class Api {
             ...other
         }, signal);
     }
+    sendGiftToChannel(chat_id, gift_id, other, signal) {
+        return this.raw.sendGift({
+            chat_id,
+            gift_id,
+            ...other
+        }, signal);
+    }
     answerInlineQuery(inline_query_id, results, other, signal) {
         return this.raw.answerInlineQuery({
             inline_query_id,
@@ -4971,6 +4981,26 @@ const worktop = (req, res)=>({
         respond: (json)=>res.send(200, json),
         unauthorized: ()=>res.send(401, WRONG_TOKEN_ERROR)
     });
+const elysia = (ctx)=>{
+    let resolve;
+    const handlerReturn = new Promise((res)=>resolve = res);
+    return {
+        update: Promise.resolve(ctx.body),
+        header: ctx.headers[SECRET_HEADER_LOWERCASE],
+        end () {
+            resolve("");
+        },
+        respond (json) {
+            ctx.set.headers["content-type"] = "application/json";
+            resolve(json);
+        },
+        unauthorized () {
+            ctx.set.status = 401;
+            resolve("");
+        },
+        handlerReturn
+    };
+};
 const adapters = {
     "aws-lambda": awsLambda,
     "aws-lambda-async": awsLambdaAsync,
@@ -4978,6 +5008,7 @@ const adapters = {
     bun,
     cloudflare,
     "cloudflare-mod": cloudflareModule,
+    elysia,
     express,
     fastify,
     hono,

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "grammy",
     "description": "The Telegram Bot Framework.",
-    "version": "1.34.1",
+    "version": "1.35.0",
     "author": "KnorpelSenf",
     "license": "MIT",
     "engines": {
@@ -17,7 +17,7 @@
         "backport": "deno2node tsconfig.json"
     },
     "dependencies": {
-        "@grammyjs/types": "3.18.0",
+        "@grammyjs/types": "3.19.0",
         "abort-controller": "^3.0.0",
         "debug": "^4.3.4",
         "node-fetch": "^2.7.0"