grammy 1.25.2 → 1.26.1

package/README.md

@@ -10,7 +10,7 @@
 
 <!-- deno-fmt-ignore-start -->
 
-[![Bot API](https://img.shields.io/badge/Bot%20API-7.5-blue?logo=telegram&style=flat&labelColor=000&color=3b82f6)](https://core.telegram.org/bots/api)
+[![Bot API](https://img.shields.io/badge/Bot%20API-7.6-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-)

package/out/composer.d.ts

@@ -1,4 +1,4 @@
-import { type CallbackQueryContext, type ChatTypeContext, type ChosenInlineResultContext, type CommandContext, Context, type GameQueryContext, type HearsContext, type InlineQueryContext, type MaybeArray, type PreCheckoutQueryContext, type ReactionContext, type ShippingQueryContext, type StringWithSuggestions } from "./context.js";
+import { type CallbackQueryContext, type ChatTypeContext, type ChosenInlineResultContext, type CommandContext, Context, type GameQueryContext, type HearsContext, type InlineQueryContext, type MaybeArray, type PreCheckoutQueryContext, type ReactionContext, type ShippingQueryContext, type StringWithCommandSuggestions } from "./context.js";
 import { type Filter, type FilterQuery } from "./filter.js";
 import { type Chat, type ReactionType, type ReactionTypeEmoji } from "./types.js";
 type MaybePromise<T> = T | Promise<T>;
@@ -267,7 +267,7 @@ export declare class Composer<C extends Context> implements MiddlewareObj<C> {
      * @param command The command to look for
      * @param middleware The middleware to register
      */
-    command<S extends string>(command: MaybeArray<StringWithSuggestions<S | "start" | "help" | "settings">>, ...middleware: Array<CommandMiddleware<C>>): Composer<CommandContext<C>>;
+    command(command: MaybeArray<StringWithCommandSuggestions>, ...middleware: Array<CommandMiddleware<C>>): Composer<CommandContext<C>>;
     /**
      * Registers some middleware that will only be added when a new reaction of
      * the given type is added to a message.
@@ -412,10 +412,10 @@ export declare class Composer<C extends Context> implements MiddlewareObj<C> {
     inlineQuery(trigger: MaybeArray<string | RegExp>, ...middleware: Array<InlineQueryMiddleware<C>>): Composer<InlineQueryContext<C>>;
     /**
      * Registers middleware for the ChosenInlineResult by the given id or ids.
-     * ChosenInlineResult represents a result of an inline query that was
-     * chosen by the user and sent to their chat partner. Check out
-     * https://core.telegram.org/bots/api#choseninlineresult to read more
-     * about chosen inline results.
+     * ChosenInlineResult represents a result of an inline query that was chosen
+     * by the user and sent to their chat partner. Check out
+     * https://core.telegram.org/bots/api#choseninlineresult to read more about
+     * chosen inline results.
      *
      * ```ts
      * bot.chosenInlineResult('id', async ctx => {
@@ -429,13 +429,14 @@ export declare class Composer<C extends Context> implements MiddlewareObj<C> {
      */
     chosenInlineResult(resultId: MaybeArray<string | RegExp>, ...middleware: Array<ChosenInlineResultMiddleware<C>>): Composer<ChosenInlineResultContext<C>>;
     /**
-     * Registers middleware for pre-checkout queries. Telegram sends a pre-checkout
-     * query to your bot whenever a user has confirmed their payment and shipping
-     * details. You bot will then receive all information about the order and
-     * has to respond within 10 seconds with a confirmation of whether everything
-     * is alright (goods are available, etc.) and the bot is ready to proceed
-     * with the order. Check out https://core.telegram.org/bots/api#precheckoutquery
-     * to read more about pre-checkout queries.
+     * Registers middleware for pre-checkout queries. Telegram sends a
+     * pre-checkout query to your bot whenever a user has confirmed their
+     * payment and shipping details. You bot will then receive all information
+     * about the order and has to respond within 10 seconds with a confirmation
+     * of whether everything is alright (goods are available, etc.) and the bot
+     * is ready to proceed with the order. Check out
+     * https://core.telegram.org/bots/api#precheckoutquery to read more about
+     * pre-checkout queries.
      *
      * ```ts
      * bot.preCheckoutQuery('invoice_payload', async ctx => {
@@ -449,13 +450,14 @@ export declare class Composer<C extends Context> implements MiddlewareObj<C> {
      */
     preCheckoutQuery(trigger: MaybeArray<string | RegExp>, ...middleware: Array<PreCheckoutQueryMiddleware<C>>): Composer<PreCheckoutQueryContext<C>>;
     /**
-     * Registers middleware for shipping queries. If you sent an invoice requesting
-     * a shipping address and the parameter _is_flexible_ was specified, Telegram
-     * will send a shipping query to your bot whenever a user has confirmed their
-     * shipping details. You bot will then receive the shipping information and
-     * can respond with a confirmation of whether delivery to the specified address
-     * is possible. Check out https://core.telegram.org/bots/api#shippingquery to
-     * read more about shipping queries.
+     * Registers middleware for shipping queries. If you sent an invoice
+     * requesting a shipping address and the parameter _is_flexible_ was
+     * specified, Telegram will send a shipping query to your bot whenever a
+     * user has confirmed their shipping details. You bot will then receive the
+     * shipping information and can respond with a confirmation of whether
+     * delivery to the specified address is possible. Check out
+     * https://core.telegram.org/bots/api#shippingquery to read more about
+     * shipping queries.
      *
      * ```ts
      * bot.shippingQuery('invoice_payload', async ctx => {
@@ -728,8 +730,8 @@ export type InlineQueryMiddleware<C extends Context> = Middleware<InlineQueryCon
  *
  * This helper type can be used to annotate middleware functions that are
  * defined in one place, so that they have the correct type when passed to
- * `bot.chosenInlineResult` in a different place. For instance, this allows for more
- * modular code where handlers are defined in separate files.
+ * `bot.chosenInlineResult` in a different place. For instance, this allows for
+ * more modular code where handlers are defined in separate files.
  */
 export type ChosenInlineResultMiddleware<C extends Context> = Middleware<ChosenInlineResultContext<C>>;
 /**
@@ -737,8 +739,8 @@ export type ChosenInlineResultMiddleware<C extends Context> = Middleware<ChosenI
  *
  * This helper type can be used to annotate middleware functions that are
  * defined in one place, so that they have the correct type when passed to
- * `bot.preCheckoutQuery` in a different place. For instance, this allows for more
- * modular code where handlers are defined in separate files.
+ * `bot.preCheckoutQuery` in a different place. For instance, this allows for
+ * more modular code where handlers are defined in separate files.
  */
 export type PreCheckoutQueryMiddleware<C extends Context> = Middleware<PreCheckoutQueryContext<C>>;
 /**

package/out/composer.js

@@ -429,10 +429,10 @@ class Composer {
     }
     /**
      * Registers middleware for the ChosenInlineResult by the given id or ids.
-     * ChosenInlineResult represents a result of an inline query that was
-     * chosen by the user and sent to their chat partner. Check out
-     * https://core.telegram.org/bots/api#choseninlineresult to read more
-     * about chosen inline results.
+     * ChosenInlineResult represents a result of an inline query that was chosen
+     * by the user and sent to their chat partner. Check out
+     * https://core.telegram.org/bots/api#choseninlineresult to read more about
+     * chosen inline results.
      *
      * ```ts
      * bot.chosenInlineResult('id', async ctx => {
@@ -448,13 +448,14 @@ class Composer {
         return this.filter(context_js_1.Context.has.chosenInlineResult(resultId), ...middleware);
     }
     /**
-     * Registers middleware for pre-checkout queries. Telegram sends a pre-checkout
-     * query to your bot whenever a user has confirmed their payment and shipping
-     * details. You bot will then receive all information about the order and
-     * has to respond within 10 seconds with a confirmation of whether everything
-     * is alright (goods are available, etc.) and the bot is ready to proceed
-     * with the order. Check out https://core.telegram.org/bots/api#precheckoutquery
-     * to read more about pre-checkout queries.
+     * Registers middleware for pre-checkout queries. Telegram sends a
+     * pre-checkout query to your bot whenever a user has confirmed their
+     * payment and shipping details. You bot will then receive all information
+     * about the order and has to respond within 10 seconds with a confirmation
+     * of whether everything is alright (goods are available, etc.) and the bot
+     * is ready to proceed with the order. Check out
+     * https://core.telegram.org/bots/api#precheckoutquery to read more about
+     * pre-checkout queries.
      *
      * ```ts
      * bot.preCheckoutQuery('invoice_payload', async ctx => {
@@ -470,13 +471,14 @@ class Composer {
         return this.filter(context_js_1.Context.has.preCheckoutQuery(trigger), ...middleware);
     }
     /**
-     * Registers middleware for shipping queries. If you sent an invoice requesting
-     * a shipping address and the parameter _is_flexible_ was specified, Telegram
-     * will send a shipping query to your bot whenever a user has confirmed their
-     * shipping details. You bot will then receive the shipping information and
-     * can respond with a confirmation of whether delivery to the specified address
-     * is possible. Check out https://core.telegram.org/bots/api#shippingquery to
-     * read more about shipping queries.
+     * Registers middleware for shipping queries. If you sent an invoice
+     * requesting a shipping address and the parameter _is_flexible_ was
+     * specified, Telegram will send a shipping query to your bot whenever a
+     * user has confirmed their shipping details. You bot will then receive the
+     * shipping information and can respond with a confirmation of whether
+     * delivery to the specified address is possible. Check out
+     * https://core.telegram.org/bots/api#shippingquery to read more about
+     * shipping queries.
      *
      * ```ts
      * bot.shippingQuery('invoice_payload', async ctx => {

package/out/context.d.ts

@@ -1,9 +1,10 @@
 import { type Api, type Other as OtherApi } from "./core/api.js";
 import { type Methods, type RawApi } from "./core/client.js";
 import { type Filter, type FilterCore, type FilterQuery } from "./filter.js";
-import { type Chat, type ChatPermissions, type InlineQueryResult, type InputFile, type InputMedia, type InputMediaAudio, type InputMediaDocument, type InputMediaPhoto, type InputMediaVideo, type InputPollOption, type LabeledPrice, type Message, type MessageEntity, type PassportElementError, type ReactionType, type ReactionTypeEmoji, type Update, type User, type UserFromGetMe } from "./types.js";
+import { type Chat, type ChatPermissions, type InlineQueryResult, type InputFile, type InputMedia, type InputMediaAudio, type InputMediaDocument, type InputMediaPhoto, type InputMediaVideo, type InputPaidMedia, type InputPollOption, type LabeledPrice, type Message, type MessageEntity, type PassportElementError, type ReactionType, type ReactionTypeEmoji, type Update, type User, type UserFromGetMe } from "./types.js";
 export type MaybeArray<T> = T | T[];
-export type StringWithSuggestions<S extends string> = (string & Record<never, never>) | S;
+/** permits `string` but gives hints */
+export type StringWithCommandSuggestions = (string & Record<never, never>) | "start" | "help" | "settings" | "privacy";
 type Other<M extends Methods<RawApi>, X extends string = never> = OtherApi<RawApi, M, X>;
 type SnakeToCamelCase<S extends string> = S extends `${infer L}_${infer R}` ? `${L}${Capitalize<SnakeToCamelCase<R>>}` : S;
 type AliasProps<U> = {
@@ -32,11 +33,11 @@ interface StaticHas {
      *
      * @param command The command to match
      */
-    command<S extends string>(command: MaybeArray<StringWithSuggestions<S | "start" | "help" | "settings">>): <C extends Context>(ctx: C) => ctx is CommandContext<C>;
+    command(command: MaybeArray<StringWithCommandSuggestions>): <C extends Context>(ctx: C) => ctx is CommandContext<C>;
     /**
-     * Generates a predicate function that can test context
-     * objects for containing a message reaction update. This uses the same
-     * logic as `bot.reaction`.
+     * Generates a predicate function that can test context objects for
+     * containing a message reaction update. This uses the same logic as
+     * `bot.reaction`.
      *
      * @param reaction The reaction to test against
      */
@@ -93,8 +94,8 @@ interface StaticHas {
     preCheckoutQuery(trigger: MaybeArray<string | RegExp>): <C extends Context>(ctx: C) => ctx is PreCheckoutQueryContext<C>;
     /**
      * Generates a predicate function that can test context objects for
-     * containing the given shipping query, or for the shipping query to
-     * match the given regular expression. This uses the same logic as
+     * containing the given shipping query, or for the shipping query to match
+     * the given regular expression. This uses the same logic as
      * `bot.shippingQuery`.
      *
      * @param trigger The string or regex to match
@@ -266,11 +267,12 @@ export declare class Context implements RenamedUpdate {
      */
     get businessConnectionId(): string | undefined;
     /**
-     * Get entities and their text. Extracts the text from `ctx.msg.text` or `ctx.msg.caption`.
-     * Returns an empty array if one of `ctx.msg`, `ctx.msg.text`
-     * or `ctx.msg.entities` is undefined.
+     * Get entities and their text. Extracts the text from `ctx.msg.text` or
+     * `ctx.msg.caption`. Returns an empty array if one of `ctx.msg`,
+     * `ctx.msg.text` or `ctx.msg.entities` is undefined.
      *
-     * You can filter specific entity types by passing the `types` parameter. Example:
+     * You can filter specific entity types by passing the `types` parameter.
+     * Example:
      *
      * ```ts
      * ctx.entities() // Returns all entity types
@@ -382,7 +384,7 @@ export declare class Context implements RenamedUpdate {
      *
      * @param command The command to match
      */
-    hasCommand<S extends string>(command: MaybeArray<StringWithSuggestions<S | "start" | "help" | "settings">>): this is CommandContextCore;
+    hasCommand(command: MaybeArray<StringWithCommandSuggestions>): this is CommandContextCore;
     hasReaction(reaction: MaybeArray<ReactionTypeEmoji["emoji"] | ReactionType>): this is ReactionContextCore;
     /**
      * Returns `true` if this context object belongs to a chat with the given
@@ -418,17 +420,19 @@ export declare class Context implements RenamedUpdate {
      */
     hasInlineQuery(trigger: MaybeArray<string | RegExp>): this is InlineQueryContextCore;
     /**
-     * Returns `true` if this context object contains the chosen inline result, or
-     * if the contained chosen inline result matches the given regular expression. It
-     * returns `false` otherwise. This uses the same logic as `bot.chosenInlineResult`.
+     * Returns `true` if this context object contains the chosen inline result,
+     * or if the contained chosen inline result matches the given regular
+     * expression. It returns `false` otherwise. This uses the same logic as
+     * `bot.chosenInlineResult`.
      *
      * @param trigger The string or regex to match
      */
     hasChosenInlineResult(trigger: MaybeArray<string | RegExp>): this is ChosenInlineResultContextCore;
     /**
-     * Returns `true` if this context object contains the given pre-checkout query,
-     * or if the contained pre-checkout query matches the given regular expression.
-     * It returns `false` otherwise. This uses the same logic as `bot.preCheckoutQuery`.
+     * Returns `true` if this context object contains the given pre-checkout
+     * query, or if the contained pre-checkout query matches the given regular
+     * expression. It returns `false` otherwise. This uses the same logic as
+     * `bot.preCheckoutQuery`.
      *
      * @param trigger The string or regex to match
      */
@@ -436,7 +440,8 @@ export declare class Context implements RenamedUpdate {
     /**
      * Returns `true` if this context object contains the given shipping query,
      * or if the contained shipping query matches the given regular expression.
-     * It returns `false` otherwise. This uses the same logic as `bot.shippingQuery`.
+     * It returns `false` otherwise. This uses the same logic as
+     * `bot.shippingQuery`.
      *
      * @param trigger The string or regex to match
      */
@@ -473,7 +478,7 @@ export declare class Context implements RenamedUpdate {
      */
     forwardMessages(chat_id: number | string, message_ids: number[], other?: Other<"forwardMessages", "chat_id" | "from_chat_id" | "message_ids">, signal?: AbortSignal): Promise<import("@grammyjs/types/message.js").MessageId[]>;
     /**
-     * Context-aware alias for `api.copyMessage`. Use this method to copy messages of any kind. Service messages, giveaway messages, giveaway winners messages, and invoice messages can't be copied. A quiz poll can be copied only if the value of the field correct_option_id is known to the bot. The method is analogous to the method forwardMessage, but the copied message doesn't have a link to the original message. Returns the MessageId of the sent message on success.
+     * Context-aware alias for `api.copyMessage`. Use this method to copy messages of any kind. Service messages, paid media messages, giveaway messages, giveaway winners messages, and invoice messages can't be copied. A quiz poll can be copied only if the value of the field correct_option_id is known to the bot. The method is analogous to the method forwardMessage, but the copied message doesn't have a link to the original message. Returns the MessageId of the sent message on success.
      *
      * @param chat_id Unique identifier for the target chat or username of the target channel (in the format @channelusername)
      * @param other Optional remaining parameters, confer the official reference below
@@ -483,7 +488,7 @@ export declare class Context implements RenamedUpdate {
      */
     copyMessage(chat_id: number | string, other?: Other<"copyMessage", "chat_id" | "from_chat_id" | "message_id">, signal?: AbortSignal): Promise<import("@grammyjs/types/message.js").MessageId>;
     /**
-     * Context-aware alias for `api.copyMessages`.Use this method to copy messages of any kind. If some of the specified messages can't be found or copied, they are skipped. Service messages, giveaway messages, giveaway winners messages, and invoice messages can't be copied. A quiz poll can be copied only if the value of the field correct_option_id is known to the bot. The method is analogous to the method forwardMessages, but the copied messages don't have a link to the original message. Album grouping is kept for copied messages. On success, an array of MessageId of the sent messages is returned.
+     * Context-aware alias for `api.copyMessages`. Use this method to copy messages of any kind. If some of the specified messages can't be found or copied, they are skipped. Service messages, paid media messages, giveaway messages, giveaway winners messages, and invoice messages can't be copied. A quiz poll can be copied only if the value of the field correct_option_id is known to the bot. The method is analogous to the method forwardMessages, but the copied messages don't have a link to the original message. Album grouping is kept for copied messages. On success, an array of MessageId of the sent messages is returned.
      *
      * @param chat_id Unique identifier for the target chat or username of the target channel (in the format @channelusername)
      * @param message_ids A list of 1-100 identifiers of messages in the current chat to copy. The identifiers must be specified in a strictly increasing order.
@@ -611,6 +616,17 @@ export declare class Context implements RenamedUpdate {
     stopMessageLiveLocation(other?: Other<"stopMessageLiveLocation", "chat_id" | "message_id" | "inline_message_id">, signal?: AbortSignal): Promise<true | (Update.Edited & Message.CommonMessage & {
         location: import("@grammyjs/types/message.js").Location;
     })>;
+    /**
+     * Context-aware alias for `api.sendPaidMedia`. Use this method to send paid media to channel chats. On success, the sent Message is returned.
+     *
+     * @param star_count The number of Telegram Stars that must be paid to buy access to the media
+     * @param media An array describing the media to be sent; up to 10 items
+     * @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#sendpaidmedia
+     */
+    sendPaidMedia(star_count: number, media: InputPaidMedia[], other?: Other<"sendPaidMedia", "chat_id" | "star_count" | "media">, signal?: AbortSignal): Promise<Message.PaidMediaMessage>;
     /**
      * Context-aware alias for `api.sendVenue`. Use this method to send information about a venue. On success, the sent Message is returned.
      *

package/out/context.js

@@ -593,9 +593,10 @@ class Context {
         return Context.has.inlineQuery(trigger)(this);
     }
     /**
-     * Returns `true` if this context object contains the chosen inline result, or
-     * if the contained chosen inline result matches the given regular expression. It
-     * returns `false` otherwise. This uses the same logic as `bot.chosenInlineResult`.
+     * Returns `true` if this context object contains the chosen inline result,
+     * or if the contained chosen inline result matches the given regular
+     * expression. It returns `false` otherwise. This uses the same logic as
+     * `bot.chosenInlineResult`.
      *
      * @param trigger The string or regex to match
      */
@@ -603,9 +604,10 @@ class Context {
         return Context.has.chosenInlineResult(trigger)(this);
     }
     /**
-     * Returns `true` if this context object contains the given pre-checkout query,
-     * or if the contained pre-checkout query matches the given regular expression.
-     * It returns `false` otherwise. This uses the same logic as `bot.preCheckoutQuery`.
+     * Returns `true` if this context object contains the given pre-checkout
+     * query, or if the contained pre-checkout query matches the given regular
+     * expression. It returns `false` otherwise. This uses the same logic as
+     * `bot.preCheckoutQuery`.
      *
      * @param trigger The string or regex to match
      */
@@ -615,7 +617,8 @@ class Context {
     /**
      * Returns `true` if this context object contains the given shipping query,
      * or if the contained shipping query matches the given regular expression.
-     * It returns `false` otherwise. This uses the same logic as `bot.shippingQuery`.
+     * It returns `false` otherwise. This uses the same logic as
+     * `bot.shippingQuery`.
      *
      * @param trigger The string or regex to match
      */
@@ -661,7 +664,7 @@ class Context {
         return this.api.forwardMessages(chat_id, orThrow(this.chatId, "forwardMessages"), message_ids, other, signal);
     }
     /**
-     * Context-aware alias for `api.copyMessage`. Use this method to copy messages of any kind. Service messages, giveaway messages, giveaway winners messages, and invoice messages can't be copied. A quiz poll can be copied only if the value of the field correct_option_id is known to the bot. The method is analogous to the method forwardMessage, but the copied message doesn't have a link to the original message. Returns the MessageId of the sent message on success.
+     * Context-aware alias for `api.copyMessage`. Use this method to copy messages of any kind. Service messages, paid media messages, giveaway messages, giveaway winners messages, and invoice messages can't be copied. A quiz poll can be copied only if the value of the field correct_option_id is known to the bot. The method is analogous to the method forwardMessage, but the copied message doesn't have a link to the original message. Returns the MessageId of the sent message on success.
      *
      * @param chat_id Unique identifier for the target chat or username of the target channel (in the format @channelusername)
      * @param other Optional remaining parameters, confer the official reference below
@@ -673,7 +676,7 @@ class Context {
         return this.api.copyMessage(chat_id, orThrow(this.chatId, "copyMessage"), orThrow(this.msgId, "copyMessage"), other, signal);
     }
     /**
-     * Context-aware alias for `api.copyMessages`.Use this method to copy messages of any kind. If some of the specified messages can't be found or copied, they are skipped. Service messages, giveaway messages, giveaway winners messages, and invoice messages can't be copied. A quiz poll can be copied only if the value of the field correct_option_id is known to the bot. The method is analogous to the method forwardMessages, but the copied messages don't have a link to the original message. Album grouping is kept for copied messages. On success, an array of MessageId of the sent messages is returned.
+     * Context-aware alias for `api.copyMessages`. Use this method to copy messages of any kind. If some of the specified messages can't be found or copied, they are skipped. Service messages, paid media messages, giveaway messages, giveaway winners messages, and invoice messages can't be copied. A quiz poll can be copied only if the value of the field correct_option_id is known to the bot. The method is analogous to the method forwardMessages, but the copied messages don't have a link to the original message. Album grouping is kept for copied messages. On success, an array of MessageId of the sent messages is returned.
      *
      * @param chat_id Unique identifier for the target chat or username of the target channel (in the format @channelusername)
      * @param message_ids A list of 1-100 identifiers of messages in the current chat to copy. The identifiers must be specified in a strictly increasing order.
@@ -827,6 +830,19 @@ class Context {
             ? this.api.stopMessageLiveLocationInline(inlineId, other)
             : this.api.stopMessageLiveLocation(orThrow(this.chatId, "stopMessageLiveLocation"), orThrow(this.msgId, "stopMessageLiveLocation"), other, signal);
     }
+    /**
+     * Context-aware alias for `api.sendPaidMedia`. Use this method to send paid media to channel chats. On success, the sent Message is returned.
+     *
+     * @param star_count The number of Telegram Stars that must be paid to buy access to the media
+     * @param media An array describing the media to be sent; up to 10 items
+     * @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#sendpaidmedia
+     */
+    sendPaidMedia(star_count, media, other, signal) {
+        return this.api.sendPaidMedia(orThrow(this.chatId, "sendPaidMedia"), star_count, media, other, signal);
+    }
     /**
      * Context-aware alias for `api.sendVenue`. Use this method to send information about a venue. On success, the sent Message is returned.
      *

package/out/core/api.d.ts

@@ -1,4 +1,4 @@
-import { type BotCommand, type ChatPermissions, type InlineQueryResult, type InputFile, type InputMedia, type InputMediaAudio, type InputMediaDocument, type InputMediaPhoto, type InputMediaVideo, type InputPollOption, type InputSticker, type LabeledPrice, type MaskPosition, type PassportElementError, type ReactionType } from "../types.js";
+import { type BotCommand, type ChatPermissions, type InlineQueryResult, type InputFile, type InputMedia, type InputMediaAudio, type InputMediaDocument, type InputMediaPhoto, type InputMediaVideo, type InputPaidMedia, type InputPollOption, type InputSticker, type LabeledPrice, type MaskPosition, type PassportElementError, type ReactionType } from "../types.js";
 import { type ApiClientOptions, type Methods, type Payload, type RawApi, type Transformer, type TransformerConsumer, type WebhookReplyEnvelope } from "./client.js";
 /**
  * Helper type to derive remaining properties of a given API method call M,
@@ -179,7 +179,7 @@ export declare class Api<R extends RawApi = RawApi> {
      */
     forwardMessages(chat_id: number | string, from_chat_id: number | string, message_ids: number[], other?: Other<R, "forwardMessages", "chat_id" | "from_chat_id" | "message_ids">, signal?: AbortSignal): Promise<import("@grammyjs/types/message.js").MessageId[]>;
     /**
-     * Use this method to copy messages of any kind. Service messages, giveaway messages, giveaway winners messages, and invoice messages can't be copied. A quiz poll can be copied only if the value of the field correct_option_id is known to the bot. The method is analogous to the method forwardMessage, but the copied message doesn't have a link to the original message. Returns the MessageId of the sent message on success.
+     * Use this method to copy messages of any kind. Service messages, paid media messages, giveaway messages, giveaway winners messages, and invoice messages can't be copied. A quiz poll can be copied only if the value of the field correct_option_id is known to the bot. The method is analogous to the method forwardMessage, but the copied message doesn't have a link to the original message. Returns the MessageId of the sent message on success.
      *
      * @param chat_id Unique identifier for the target chat or username of the target channel (in the format @channelusername)
      * @param from_chat_id Unique identifier for the chat where the original message was sent (or channel username in the format @channelusername)
@@ -191,7 +191,7 @@ export declare class Api<R extends RawApi = RawApi> {
      */
     copyMessage(chat_id: number | string, from_chat_id: number | string, message_id: number, other?: Other<R, "copyMessage", "chat_id" | "from_chat_id" | "message_id">, signal?: AbortSignal): Promise<import("@grammyjs/types/message.js").MessageId>;
     /**
-     * Use this method to copy messages of any kind. If some of the specified messages can't be found or copied, they are skipped. Service messages, giveaway messages, giveaway winners messages, and invoice messages can't be copied. A quiz poll can be copied only if the value of the field correct_option_id is known to the bot. The method is analogous to the method forwardMessages, but the copied messages don't have a link to the original message. Album grouping is kept for copied messages. On success, an array of MessageId of the sent messages is returned.
+     * Use this method to copy messages of any kind. If some of the specified messages can't be found or copied, they are skipped. Service messages, paid media messages, giveaway messages, giveaway winners messages, and invoice messages can't be copied. A quiz poll can be copied only if the value of the field correct_option_id is known to the bot. The method is analogous to the method forwardMessages, but the copied messages don't have a link to the original message. Album grouping is kept for copied messages. On success, an array of MessageId of the sent messages is returned.
      *
      * @param chat_id Unique identifier for the target chat or username of the target channel (in the format @channelusername)
      * @param from_chat_id Unique identifier for the chat where the original messages were sent (or channel username in the format @channelusername)
@@ -359,6 +359,18 @@ export declare class Api<R extends RawApi = RawApi> {
     stopMessageLiveLocationInline(inline_message_id: string, other?: Other<R, "stopMessageLiveLocation", "chat_id" | "message_id" | "inline_message_id">, signal?: AbortSignal): Promise<true | (import("@grammyjs/types/update.js").Update.Edited & import("@grammyjs/types/message.js").Message.CommonMessage & {
         location: import("@grammyjs/types/message.js").Location;
     })>;
+    /**
+     * Use this method to send paid media to channel chats. On success, the sent Message is returned.
+     *
+     * @param chat_id Unique identifier for the target chat or username of the target channel (in the format @channelusername)
+     * @param star_count The number of Telegram Stars that must be paid to buy access to the media
+     * @param media An array describing the media to be sent; up to 10 items
+     * @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#sendpaidmedia
+     */
+    sendPaidMedia(chat_id: number | string, star_count: number, media: InputPaidMedia[], other?: Other<R, "sendPaidMedia", "chat_id" | "star_count" | "media">, signal?: AbortSignal): Promise<import("@grammyjs/types/message.js").Message.PaidMediaMessage>;
     /**
      * Use this method to send information about a venue. On success, the sent Message is returned.
      *

package/out/core/api.js

@@ -173,7 +173,7 @@ class Api {
         }, signal);
     }
     /**
-     * Use this method to copy messages of any kind. Service messages, giveaway messages, giveaway winners messages, and invoice messages can't be copied. A quiz poll can be copied only if the value of the field correct_option_id is known to the bot. The method is analogous to the method forwardMessage, but the copied message doesn't have a link to the original message. Returns the MessageId of the sent message on success.
+     * Use this method to copy messages of any kind. Service messages, paid media messages, giveaway messages, giveaway winners messages, and invoice messages can't be copied. A quiz poll can be copied only if the value of the field correct_option_id is known to the bot. The method is analogous to the method forwardMessage, but the copied message doesn't have a link to the original message. Returns the MessageId of the sent message on success.
      *
      * @param chat_id Unique identifier for the target chat or username of the target channel (in the format @channelusername)
      * @param from_chat_id Unique identifier for the chat where the original message was sent (or channel username in the format @channelusername)
@@ -187,7 +187,7 @@ class Api {
         return this.raw.copyMessage({ chat_id, from_chat_id, message_id, ...other }, signal);
     }
     /**
-     * Use this method to copy messages of any kind. If some of the specified messages can't be found or copied, they are skipped. Service messages, giveaway messages, giveaway winners messages, and invoice messages can't be copied. A quiz poll can be copied only if the value of the field correct_option_id is known to the bot. The method is analogous to the method forwardMessages, but the copied messages don't have a link to the original message. Album grouping is kept for copied messages. On success, an array of MessageId of the sent messages is returned.
+     * Use this method to copy messages of any kind. If some of the specified messages can't be found or copied, they are skipped. Service messages, paid media messages, giveaway messages, giveaway winners messages, and invoice messages can't be copied. A quiz poll can be copied only if the value of the field correct_option_id is known to the bot. The method is analogous to the method forwardMessages, but the copied messages don't have a link to the original message. Album grouping is kept for copied messages. On success, an array of MessageId of the sent messages is returned.
      *
      * @param chat_id Unique identifier for the target chat or username of the target channel (in the format @channelusername)
      * @param from_chat_id Unique identifier for the chat where the original messages were sent (or channel username in the format @channelusername)
@@ -380,6 +380,20 @@ class Api {
     stopMessageLiveLocationInline(inline_message_id, other, signal) {
         return this.raw.stopMessageLiveLocation({ inline_message_id, ...other }, signal);
     }
+    /**
+     * Use this method to send paid media to channel chats. On success, the sent Message is returned.
+     *
+     * @param chat_id Unique identifier for the target chat or username of the target channel (in the format @channelusername)
+     * @param star_count The number of Telegram Stars that must be paid to buy access to the media
+     * @param media An array describing the media to be sent; up to 10 items
+     * @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#sendpaidmedia
+     */
+    sendPaidMedia(chat_id, star_count, media, other, signal) {
+        return this.raw.sendPaidMedia({ chat_id, star_count, media, ...other }, signal);
+    }
     /**
      * Use this method to send information about a venue. On success, the sent Message is returned.
      *

package/out/filter.d.ts

@@ -91,6 +91,7 @@ declare const UPDATE_KEYS: {
         readonly poll: {};
         readonly venue: {};
         readonly location: {};
+        readonly paid_media: {};
         readonly entities: {
             readonly mention: {};
             readonly hashtag: {};
@@ -213,6 +214,7 @@ declare const UPDATE_KEYS: {
         readonly poll: {};
         readonly venue: {};
         readonly location: {};
+        readonly paid_media: {};
         readonly entities: {
             readonly mention: {};
             readonly hashtag: {};
@@ -303,6 +305,7 @@ declare const UPDATE_KEYS: {
         readonly poll: {};
         readonly venue: {};
         readonly location: {};
+        readonly paid_media: {};
         readonly entities: {
             readonly mention: {};
             readonly hashtag: {};
@@ -393,6 +396,7 @@ declare const UPDATE_KEYS: {
         readonly poll: {};
         readonly venue: {};
         readonly location: {};
+        readonly paid_media: {};
         readonly entities: {
             readonly mention: {};
             readonly hashtag: {};
@@ -519,6 +523,7 @@ declare const UPDATE_KEYS: {
         readonly poll: {};
         readonly venue: {};
         readonly location: {};
+        readonly paid_media: {};
         readonly entities: {
             readonly mention: {};
             readonly hashtag: {};
@@ -641,6 +646,7 @@ declare const UPDATE_KEYS: {
         readonly poll: {};
         readonly venue: {};
         readonly location: {};
+        readonly paid_media: {};
         readonly entities: {
             readonly mention: {};
             readonly hashtag: {};

package/out/filter.js

@@ -265,6 +265,7 @@ const COMMON_MESSAGE_KEYS = {
     poll: {},
     venue: {},
     location: {},
+    paid_media: {},
     entities: ENTITY_KEYS,
     caption_entities: ENTITY_KEYS,
     caption: {},

package/out/types.node.d.ts

@@ -1,5 +1,5 @@
 /// <reference types="node" />
-import { type ApiMethods as ApiMethodsF, type InputMedia as InputMediaF, type InputMediaAnimation as InputMediaAnimationF, type InputMediaAudio as InputMediaAudioF, type InputMediaDocument as InputMediaDocumentF, type InputMediaPhoto as InputMediaPhotoF, type InputMediaVideo as InputMediaVideoF, type InputSticker as InputStickerF, type Opts as OptsF } from "@grammyjs/types";
+import { type ApiMethods as ApiMethodsF, type InputMedia as InputMediaF, type InputMediaAnimation as InputMediaAnimationF, type InputMediaAudio as InputMediaAudioF, type InputMediaDocument as InputMediaDocumentF, type InputMediaPhoto as InputMediaPhotoF, type InputMediaVideo as InputMediaVideoF, type InputPaidMedia as InputPaidMediaF, type InputPaidMediaPhoto as InputPaidMediaPhotoF, type InputPaidMediaVideo as InputPaidMediaVideoF, type InputSticker as InputStickerF, type Opts as OptsF } from "@grammyjs/types";
 import { type ReadStream } from "fs";
 export * from "@grammyjs/types";
 /** A value, or a potentially async function supplying that value */
@@ -69,3 +69,11 @@ export type InputMediaAnimation = InputMediaAnimationF<InputFile>;
 export type InputMediaAudio = InputMediaAudioF<InputFile>;
 /** Represents a general file to be sent. */
 export type InputMediaDocument = InputMediaDocumentF<InputFile>;
+/** This object describes the paid media to be sent. Currently, it can be one of
+- InputPaidMediaPhoto
+- InputPaidMediaVideo */
+export type InputPaidMedia = InputPaidMediaF<InputFile>;
+/** The paid media to send is a photo. */
+export type InputPaidMediaPhoto = InputPaidMediaPhotoF<InputFile>;
+/** The paid media to send is a video. */
+export type InputPaidMediaVideo = InputPaidMediaVideoF<InputFile>;

package/out/web.mjs

@@ -210,6 +210,7 @@ const COMMON_MESSAGE_KEYS = {
     poll: {},
     venue: {},
     location: {},
+    paid_media: {},
     entities: ENTITY_KEYS,
     caption_entities: ENTITY_KEYS,
     caption: {},
@@ -781,6 +782,9 @@ class Context {
         const inlineId = this.inlineMessageId;
         return inlineId !== undefined ? this.api.stopMessageLiveLocationInline(inlineId, other) : this.api.stopMessageLiveLocation(orThrow(this.chatId, "stopMessageLiveLocation"), orThrow(this.msgId, "stopMessageLiveLocation"), other, signal);
     }
+    sendPaidMedia(star_count, media, other, signal) {
+        return this.api.sendPaidMedia(orThrow(this.chatId, "sendPaidMedia"), star_count, media, other, signal);
+    }
     replyWithVenue(latitude, longitude, title, address, other, signal) {
         return this.api.sendVenue(orThrow(this.chatId, "sendVenue"), latitude, longitude, title, address, {
             business_connection_id: this.businessConnectionId,
@@ -2563,6 +2567,14 @@ class Api {
             ...other
         }, signal);
     }
+    sendPaidMedia(chat_id, star_count, media, other, signal) {
+        return this.raw.sendPaidMedia({
+            chat_id,
+            star_count,
+            media,
+            ...other
+        }, signal);
+    }
     sendVenue(chat_id, latitude, longitude, title, address, other, signal) {
         return this.raw.sendVenue({
             chat_id,

package/package.json

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