@mtcute/dispatcher 0.16.0 → 0.16.9

package/README.md

@@ -1,6 +1,6 @@
 # @mtcute/dispatcher
 
-📖 [API Reference](https://ref.mtcute.dev/modules/_mtcute_dispatcher.html)  
+📖 [API Reference](https://ref.mtcute.dev/modules/_mtcute_dispatcher.html)
 🧐 [Guide](https://mtcute.dev/guide/dispatcher/intro.html)
 
 Dispatcher and bot framework based on @mtcute/core.
@@ -23,4 +23,4 @@ const dp = Dispatcher.for(tg)
 dp.onNewMessage(async (msg) => {
     await msg.replyText('Hello world!')
 })
-```
+```

package/callback-data-builder.test.d.ts

@@ -0,0 +1 @@
+export {};

package/{esm/context → context}/business-message.d.ts

@@ -1,4 +1,4 @@
-import { BusinessMessage, OmitInputMessageId, ParametersSkip1 } from '@mtcute/core';
+import { Message, OmitInputMessageId, ParametersSkip1, Sticker, BusinessMessage } from '@mtcute/core';
 import { TelegramClient } from '@mtcute/core/client.js';
 import { DeleteMessagesParams, ForwardMessageOptions, SendCopyGroupParams, SendCopyParams } from '@mtcute/core/methods.js';
 import { UpdateContext } from './base.js';
@@ -13,7 +13,7 @@ import { UpdateContext } from './base.js';
  */
 export declare class BusinessMessageContext extends BusinessMessage implements UpdateContext<BusinessMessage> {
     readonly client: TelegramClient;
-    readonly _name = "new_business_message";
+    readonly _name: "new_business_message";
     /**
      * List of messages in the message group.
      *
@@ -24,37 +24,37 @@ export declare class BusinessMessageContext extends BusinessMessage implements U
     readonly isMessageGroup: boolean;
     constructor(client: TelegramClient, message: BusinessMessage | BusinessMessage[]);
     /** Get all custom emojis contained in this message (message group), if any */
-    getCustomEmojis(): Promise<import("@mtcute/core").Sticker[]>;
+    getCustomEmojis(): Promise<Sticker[]>;
     /** Send a text message to the same chat (and topic, if applicable) as a given message */
-    answerText(...params: ParametersSkip1<TelegramClient['answerText']>): Promise<import("@mtcute/core").Message>;
+    answerText(...params: ParametersSkip1<TelegramClient['answerText']>): Promise<Message>;
     /** Send a media to the same chat (and topic, if applicable) as a given message */
-    answerMedia(...params: ParametersSkip1<TelegramClient['answerMedia']>): Promise<import("@mtcute/core").Message>;
+    answerMedia(...params: ParametersSkip1<TelegramClient['answerMedia']>): Promise<Message>;
     /** Send a media group to the same chat (and topic, if applicable) as a given message */
-    answerMediaGroup(...params: ParametersSkip1<TelegramClient['answerMediaGroup']>): Promise<import("@mtcute/core").Message[]>;
+    answerMediaGroup(...params: ParametersSkip1<TelegramClient['answerMediaGroup']>): Promise<Message[]>;
     /** Send a text message in reply to this message */
-    replyText(...params: ParametersSkip1<TelegramClient['replyText']>): Promise<import("@mtcute/core").Message>;
+    replyText(...params: ParametersSkip1<TelegramClient['replyText']>): Promise<Message>;
     /** Send a media in reply to this message */
-    replyMedia(...params: ParametersSkip1<TelegramClient['replyMedia']>): Promise<import("@mtcute/core").Message>;
+    replyMedia(...params: ParametersSkip1<TelegramClient['replyMedia']>): Promise<Message>;
     /** Send a media group in reply to this message */
-    replyMediaGroup(...params: ParametersSkip1<TelegramClient['replyMediaGroup']>): Promise<import("@mtcute/core").Message[]>;
+    replyMediaGroup(...params: ParametersSkip1<TelegramClient['replyMediaGroup']>): Promise<Message[]>;
     /** Send a text message in reply to this message */
-    quoteWithText(params: Parameters<TelegramClient['quoteWithText']>[1]): Promise<import("@mtcute/core").Message>;
+    quoteWithText(params: Parameters<TelegramClient['quoteWithText']>[1]): Promise<Message>;
     /** Send a media in reply to this message */
-    quoteWithMedia(params: Parameters<TelegramClient['quoteWithMedia']>[1]): Promise<import("@mtcute/core").Message>;
+    quoteWithMedia(params: Parameters<TelegramClient['quoteWithMedia']>[1]): Promise<Message>;
     /** Send a media group in reply to this message */
-    quoteWithMediaGroup(params: Parameters<TelegramClient['quoteWithMediaGroup']>[1]): Promise<import("@mtcute/core").Message[]>;
+    quoteWithMediaGroup(params: Parameters<TelegramClient['quoteWithMediaGroup']>[1]): Promise<Message[]>;
     /** Delete this message (message group) */
     delete(params?: DeleteMessagesParams): Promise<void>;
     /** Pin this message */
-    pin(params?: OmitInputMessageId<Parameters<TelegramClient['pinMessage']>[0]>): Promise<import("@mtcute/core").Message | null>;
+    pin(params?: OmitInputMessageId<Parameters<TelegramClient['pinMessage']>[0]>): Promise<Message | null>;
     /** Unpin this message */
     unpin(): Promise<void>;
     /** Edit this message */
-    edit(params: OmitInputMessageId<Parameters<TelegramClient['editMessage']>[0]>): Promise<import("@mtcute/core").Message>;
+    edit(params: OmitInputMessageId<Parameters<TelegramClient['editMessage']>[0]>): Promise<Message>;
     /** Forward this message (message group) */
-    forwardTo(params: ForwardMessageOptions): Promise<import("@mtcute/core").Message[]>;
+    forwardTo(params: ForwardMessageOptions): Promise<Message[]>;
     /** Send a copy of this message (message group) */
-    copy(params: SendCopyParams & SendCopyGroupParams): Promise<import("@mtcute/core").Message> | Promise<import("@mtcute/core").Message[]>;
+    copy(params: SendCopyParams & SendCopyGroupParams): Promise<Message | Message[]>;
     /** React to this message */
-    react(params: OmitInputMessageId<Parameters<TelegramClient['sendReaction']>[0]>): Promise<import("@mtcute/core").Message | null>;
+    react(params: OmitInputMessageId<Parameters<TelegramClient['sendReaction']>[0]>): Promise<Message | null>;
 }

package/{esm/context → context}/callback-query.d.ts

@@ -1,4 +1,4 @@
-import { BusinessCallbackQuery, CallbackQuery, InlineCallbackQuery, MaybePromise, Message } from '@mtcute/core';
+import { MaybePromise, Message, BusinessCallbackQuery, CallbackQuery, InlineCallbackQuery } from '@mtcute/core';
 import { TelegramClient } from '@mtcute/core/client.js';
 import { UpdateContext } from './base.js';
 /**
@@ -8,7 +8,7 @@ import { UpdateContext } from './base.js';
  */
 export declare class CallbackQueryContext extends CallbackQuery implements UpdateContext<CallbackQuery> {
     readonly client: TelegramClient;
-    readonly _name = "callback_query";
+    readonly _name: "callback_query";
     constructor(client: TelegramClient, query: CallbackQuery);
     /** Answer to this callback query */
     answer(params: Parameters<TelegramClient['answerCallbackQuery']>[1]): Promise<void>;
@@ -35,7 +35,7 @@ export declare class CallbackQueryContext extends CallbackQuery implements Updat
  */
 export declare class InlineCallbackQueryContext extends InlineCallbackQuery implements UpdateContext<InlineCallbackQuery> {
     readonly client: TelegramClient;
-    readonly _name = "inline_callback_query";
+    readonly _name: "inline_callback_query";
     constructor(client: TelegramClient, query: InlineCallbackQuery);
     /** Answer to this callback query */
     answer(params: Parameters<TelegramClient['answerCallbackQuery']>[1]): Promise<void>;
@@ -51,7 +51,7 @@ export declare class InlineCallbackQueryContext extends InlineCallbackQuery impl
  */
 export declare class BusinessCallbackQueryContext extends BusinessCallbackQuery implements UpdateContext<BusinessCallbackQuery> {
     readonly client: TelegramClient;
-    readonly _name = "business_callback_query";
+    readonly _name: "business_callback_query";
     constructor(client: TelegramClient, query: BusinessCallbackQuery);
     /** Answer to this callback query */
     answer(params: Parameters<TelegramClient['answerCallbackQuery']>[1]): Promise<void>;

package/{cjs/context → context}/chat-join-request.d.ts

@@ -8,7 +8,7 @@ import { UpdateContext } from './base.js';
  */
 export declare class ChatJoinRequestUpdateContext extends BotChatJoinRequestUpdate implements UpdateContext<BotChatJoinRequestUpdate> {
     readonly client: TelegramClient;
-    readonly _name = "bot_chat_join_request";
+    readonly _name: "bot_chat_join_request";
     constructor(client: TelegramClient, update: BotChatJoinRequestUpdate);
     /** Approve the request */
     approve(): Promise<void>;

package/{esm/context → context}/chosen-inline-result.d.ts

@@ -11,7 +11,7 @@ import { UpdateContext } from './base.js';
  */
 export declare class ChosenInlineResultContext extends ChosenInlineResult implements UpdateContext<ChosenInlineResult> {
     readonly client: TelegramClient;
-    readonly _name = "chosen_inline_result";
+    readonly _name: "chosen_inline_result";
     constructor(client: TelegramClient, result: ChosenInlineResult);
     /**
      * Edit the message that was sent when this inline result that was chosen.

package/{esm/context → context}/inline-query.d.ts

@@ -1,4 +1,4 @@
-import { InlineQuery, ParametersSkip1 } from '@mtcute/core';
+import { ParametersSkip1, InlineQuery } from '@mtcute/core';
 import { TelegramClient } from '@mtcute/core/client.js';
 import { UpdateContext } from './base.js';
 /**
@@ -8,7 +8,7 @@ import { UpdateContext } from './base.js';
  */
 export declare class InlineQueryContext extends InlineQuery implements UpdateContext<InlineQuery> {
     readonly client: TelegramClient;
-    readonly _name = "inline_query";
+    readonly _name: "inline_query";
     constructor(client: TelegramClient, query: InlineQuery);
     /** Answer to this inline query */
     answer(...params: ParametersSkip1<TelegramClient['answerInlineQuery']>): Promise<void>;

package/{cjs/context → context}/message.d.ts

@@ -1,4 +1,4 @@
-import { Message, OmitInputMessageId, ParametersSkip1, Peer } from '@mtcute/core';
+import { OmitInputMessageId, ParametersSkip1, Peer, Sticker, Message } from '@mtcute/core';
 import { TelegramClient } from '@mtcute/core/client.js';
 import { DeleteMessagesParams, ForwardMessageOptions, SendCopyGroupParams, SendCopyParams } from '@mtcute/core/methods.js';
 import { UpdateContext } from './base.js';
@@ -13,7 +13,7 @@ import { UpdateContext } from './base.js';
  */
 export declare class MessageContext extends Message implements UpdateContext<Message> {
     readonly client: TelegramClient;
-    readonly _name = "new_message";
+    readonly _name: "new_message";
     /**
      * List of messages in the message group.
      *
@@ -34,7 +34,7 @@ export declare class MessageContext extends Message implements UpdateContext<Mes
     /** If this is a channel post, get its automatic forward in the discussion group */
     getDiscussionMessage(): Promise<Message | null>;
     /** Get all custom emojis contained in this message (message group), if any */
-    getCustomEmojis(): Promise<import("@mtcute/core").Sticker[]>;
+    getCustomEmojis(): Promise<Sticker[]>;
     /** Send a text message to the same chat (and topic, if applicable) as a given message */
     answerText(...params: ParametersSkip1<TelegramClient['answerText']>): Promise<Message>;
     /** Send a media to the same chat (and topic, if applicable) as a given message */

package/context/parse.d.ts

@@ -0,0 +1,13 @@
+import { BotReactionCountUpdate, BotReactionUpdate, BotStoppedUpdate, BusinessConnection, ChatJoinRequestUpdate, ChatMemberUpdate, DeleteBusinessMessageUpdate, DeleteMessageUpdate, DeleteStoryUpdate, HistoryReadUpdate, ParsedUpdate, PollUpdate, PollVoteUpdate, StoryUpdate, UserStatusUpdate, UserTypingUpdate } from '@mtcute/core';
+import { TelegramClient } from '@mtcute/core/client.js';
+import { UpdateContextDistributed } from './base.js';
+import { BusinessMessageContext } from './business-message.js';
+import { BusinessCallbackQueryContext, CallbackQueryContext, InlineCallbackQueryContext } from './callback-query.js';
+import { ChatJoinRequestUpdateContext } from './chat-join-request.js';
+import { ChosenInlineResultContext } from './chosen-inline-result.js';
+import { InlineQueryContext } from './inline-query.js';
+import { MessageContext } from './message.js';
+import { PreCheckoutQueryContext } from './pre-checkout-query.js';
+export type UpdateContextType = MessageContext | InlineQueryContext | ChosenInlineResultContext | CallbackQueryContext | InlineCallbackQueryContext | BusinessCallbackQueryContext | ChatJoinRequestUpdateContext | PreCheckoutQueryContext | BusinessMessageContext | UpdateContextDistributed<DeleteMessageUpdate | ChatMemberUpdate | PollUpdate | PollVoteUpdate | UserStatusUpdate | UserTypingUpdate | HistoryReadUpdate | BotStoppedUpdate | ChatJoinRequestUpdate | StoryUpdate | DeleteStoryUpdate | BotReactionUpdate | BotReactionCountUpdate | BusinessConnection | DeleteBusinessMessageUpdate>;
+/** @internal */
+export declare function _parsedUpdateToContext(client: TelegramClient, update: ParsedUpdate): UpdateContextType;

package/{esm/context → context}/pre-checkout-query.d.ts

@@ -8,7 +8,7 @@ import { UpdateContext } from './base.js';
  */
 export declare class PreCheckoutQueryContext extends PreCheckoutQuery implements UpdateContext<PreCheckoutQuery> {
     readonly client: TelegramClient;
-    readonly _name = "pre_checkout_query";
+    readonly _name: "pre_checkout_query";
     constructor(client: TelegramClient, query: PreCheckoutQuery);
     /** Approve the query */
     approve(): Promise<void>;

package/{cjs/dispatcher.d.ts → dispatcher.d.ts}

@@ -1,10 +1,10 @@
-import { BotReactionCountUpdate, BotReactionUpdate, BotStoppedUpdate, BusinessConnection, ChatJoinRequestUpdate, ChatMemberUpdate, DeleteBusinessMessageUpdate, DeleteMessageUpdate, DeleteStoryUpdate, HistoryReadUpdate, MaybePromise, ParsedUpdate, PeersIndex, PollUpdate, PollVoteUpdate, StoryUpdate, tl, UserStatusUpdate, UserTypingUpdate } from '@mtcute/core';
+import { BotReactionCountUpdate, BotReactionUpdate, BotStoppedUpdate, BusinessConnection, ChatJoinRequestUpdate, ChatMemberUpdate, DeleteBusinessMessageUpdate, DeleteMessageUpdate, DeleteStoryUpdate, HistoryReadUpdate, MaybePromise, ParsedUpdate, PeersIndex, PollUpdate, PollVoteUpdate, StoryUpdate, UserStatusUpdate, UserTypingUpdate, tl } from '@mtcute/core';
 import { TelegramClient } from '@mtcute/core/client.js';
 import { UpdateContext } from './context/base.js';
 import { BusinessMessageContext } from './context/business-message.js';
 import { BusinessCallbackQueryContext, CallbackQueryContext, ChatJoinRequestUpdateContext, ChosenInlineResultContext, InlineCallbackQueryContext, InlineQueryContext, MessageContext, PreCheckoutQueryContext } from './context/index.js';
 import { SceneTransitionContext } from './context/scene-transition.js';
-import { filters, UpdateFilter } from './filters/index.js';
+import { UpdateFilter, filters } from './filters/index.js';
 import { BotChatJoinRequestHandler, BotReactionCountUpdateHandler, BotReactionUpdateHandler, BotStoppedHandler, BusinessCallbackQueryHandler, BusinessConnectionUpdateHandler, BusinessMessageGroupHandler, CallbackQueryHandler, ChatJoinRequestHandler, ChatMemberUpdateHandler, ChosenInlineResultHandler, DeleteBusinessMessageHandler, DeleteMessageHandler, DeleteStoryHandler, EditBusinessMessageHandler, EditMessageHandler, HistoryReadHandler, InlineCallbackQueryHandler, InlineQueryHandler, MessageGroupHandler, NewBusinessMessageHandler, NewMessageHandler, PollUpdateHandler, PollVoteHandler, PreCheckoutQueryHandler, RawUpdateHandler, StoryUpdateHandler, UpdateHandler, UserStatusUpdateHandler, UserTypingHandler } from './handler.js';
 import { PropagationAction } from './propagation.js';
 import { IStateStorageProvider, StateKeyDelegate, UpdateState } from './state/index.js';

package/{cjs/filters → filters}/bots.d.ts

@@ -1,7 +1,7 @@
-import { MaybeArray } from '@mtcute/core';
+import { Chat, MaybeArray } from '@mtcute/core';
 import { BusinessMessageContext } from '../context/business-message.js';
 import { MessageContext } from '../context/message.js';
-import { UpdateFilter } from './types.js';
+import { Modify, UpdateFilter } from './types.js';
 /**
  * Filter messages that call the given command(s)..
  *
@@ -18,40 +18,30 @@ import { UpdateFilter } from './types.js';
  *   Can be `null` to disable prefixes altogether
  * @param caseSensitive
  */
-export declare const command: (commands: MaybeArray<string | RegExp>, { prefixes, caseSensitive, }?: {
-    prefixes?: MaybeArray<string> | null | undefined;
-    caseSensitive?: boolean | undefined;
-}) => UpdateFilter<MessageContext | BusinessMessageContext, {
+export declare function command(commands: MaybeArray<string | RegExp>, { prefixes, caseSensitive, }?: {
+    prefixes?: MaybeArray<string> | null;
+    caseSensitive?: boolean;
+}): UpdateFilter<MessageContext | BusinessMessageContext, {
     command: string[];
 }>;
 /**
  * Shorthand filter that matches /start commands sent to bot's
  * private messages.
  */
-export declare const start: UpdateFilter<{
-    chat: import("@mtcute/core").Chat;
-} & (BusinessMessageContext | MessageContext), {
-    chat: import("./types.js").Modify<import("@mtcute/core").Chat, {
-        chatType: "private";
+export declare const start: UpdateFilter<MessageContext | BusinessMessageContext, {
+    chat: Modify<Chat, {
+        chatType: 'private';
     }>;
-} & import("./types.js").EmptyObject & {
     command: string[];
-}, never>;
+}>;
 /**
  * Shorthand filter that matches /start commands
  * sent in groups (i.e. using `?startgroup` parameter).
  */
-export declare const startGroup: UpdateFilter<{
-    chat: import("@mtcute/core").Chat;
-} & (BusinessMessageContext | MessageContext), (({
-    chat: import("./types.js").Modify<import("@mtcute/core").Chat, {
-        chatType: "supergroup";
-    }>;
-} & import("./types.js").EmptyObject) | ({
-    chat: import("./types.js").Modify<import("@mtcute/core").Chat, {
-        chatType: "group";
+export declare const startGroup: UpdateFilter<MessageContext | BusinessMessageContext, {
+    chat: Modify<Chat, {
+        chatType: 'group' | 'supergroup';
     }>;
-} & import("./types.js").EmptyObject)) & {
     command: string[];
 }, never>;
 /**

package/filters/bots.test.d.ts

@@ -0,0 +1 @@
+export {};

package/{esm/filters → filters}/chat.d.ts

@@ -4,9 +4,9 @@ import { EmptyObject, Modify, UpdateFilter } from './types.js';
 /**
  * Filter updates by type of the chat where they happened
  */
-export declare const chat: <T extends ChatType, Obj extends {
+export declare function chat<T extends ChatType, Obj extends {
     chat: Chat;
-}>(type: T) => UpdateFilter<Obj, {
+}>(type: T): UpdateFilter<Obj, {
     chat: Modify<Chat, {
         chatType: T;
     }>;

package/filters/logic.test.d.ts

@@ -0,0 +1 @@
+export {};

package/filters/message.d.ts

@@ -0,0 +1,214 @@
+import { Audio, Contact, Dice, Document, Game, Invoice, LiveLocation, Location, MaybeArray, Message, MessageAction, MessageMediaType, Peer, Photo, Poll, RepliedMessageInfo, RepliedMessageOrigin, Sticker, StickerSourceType, StickerType, User, Venue, Video, Voice, WebPage, _RepliedMessageAssertionsByOrigin, RawDocument } from '@mtcute/core';
+import { BusinessMessageContext } from '../context/business-message.js';
+import { MessageContext } from '../index.js';
+import { Modify, UpdateFilter } from './types.js';
+/**
+ * Filter incoming messages.
+ *
+ * Messages sent to yourself (i.e. Saved Messages) are also "incoming"
+ */
+export declare const incoming: UpdateFilter<Message, {
+    isOutgoing: false;
+}>;
+/**
+ * Filter outgoing messages.
+ *
+ * Messages sent to yourself (i.e. Saved Messages) are **not** "outgoing"
+ */
+export declare const outgoing: UpdateFilter<Message, {
+    isOutgoing: true;
+}>;
+/**
+ * Filter for scheduled messages
+ */
+export declare const scheduled: UpdateFilter<Message, {
+    isScheduled: true;
+}>;
+/**
+ * Filter messages that are replies to some other message
+ */
+export declare const reply: UpdateFilter<Message, {
+    replyToMessage: RepliedMessageInfo;
+}>;
+/**
+ * Filter messages that are replies with the given origin type
+ */
+export declare function replyOrigin<T extends RepliedMessageOrigin>(origin: T): UpdateFilter<Message, {
+    replyToMessage: Modify<RepliedMessageInfo, _RepliedMessageAssertionsByOrigin[T] & {
+        origin: T;
+    }>;
+}>;
+/**
+ * Filter messages containing some media
+ */
+export declare const media: UpdateFilter<Message, {
+    media: Exclude<Message['media'], null>;
+}>;
+/**
+ * Filter messages containing media of given type
+ */
+export declare function mediaOf<T extends MessageMediaType>(type: T): UpdateFilter<Message, {
+    media: Extract<Message['media'], {
+        type: T;
+    }>;
+}>;
+/** Filter messages containing a photo */
+export declare const photo: UpdateFilter<Message, {
+    media: Photo;
+}>;
+/** Filter messages containing a dice */
+export declare const dice: UpdateFilter<Message, {
+    media: Dice;
+}>;
+/** Filter messages containing a contact */
+export declare const contact: UpdateFilter<Message, {
+    media: Contact;
+}>;
+/** Filter messages containing an audio file */
+export declare const audio: UpdateFilter<Message, {
+    media: Audio;
+}>;
+/** Filter messages containing a voice message (audio-only) */
+export declare const voice: UpdateFilter<Message, {
+    media: Voice;
+}>;
+/** Filter messages containing a sticker */
+export declare const sticker: UpdateFilter<Message, {
+    media: Sticker;
+}>;
+/** Filter messages containing a document (a file) */
+export declare const document: UpdateFilter<Message, {
+    media: Document;
+}>;
+/** Filter messages containing any video (videos, round messages and animations) */
+export declare const anyVideo: UpdateFilter<Message, {
+    media: Video;
+}>;
+/** Filter messages containing a static location */
+export declare const location: UpdateFilter<Message, {
+    media: Location;
+}>;
+/** Filter messages containing a live location */
+export declare const liveLocation: UpdateFilter<Message, {
+    media: LiveLocation;
+}>;
+/** Filter messages containing a game */
+export declare const game: UpdateFilter<Message, {
+    media: Game;
+}>;
+/** Filter messages containing a web page */
+export declare const webpage: UpdateFilter<Message, {
+    media: WebPage;
+}>;
+/** Filter messages containing a venue */
+export declare const venue: UpdateFilter<Message, {
+    media: Venue;
+}>;
+/** Filter messages containing a poll */
+export declare const poll: UpdateFilter<Message, {
+    media: Poll;
+}>;
+/** Filter messages containing an invoice */
+export declare const invoice: UpdateFilter<Message, {
+    media: Invoice;
+}>;
+/**
+ * Filter messages containing any location (live or static).
+ */
+export declare const anyLocation: UpdateFilter<Message, {
+    media: Location;
+}>;
+/**
+ * Filter messages containing a document
+ *
+ * This will also match media like audio, video, voice
+ * that also use Documents
+ */
+export declare const anyDocument: UpdateFilter<Message, {
+    media: RawDocument;
+}>;
+/**
+ * Filter messages containing a simple video.
+ *
+ * This does not include round messages and animations
+ */
+export declare const video: UpdateFilter<Message, {
+    media: Modify<Video, {
+        isRound: false;
+        isAnimation: false;
+    }>;
+}>;
+/**
+ * Filter messages containing an animation.
+ *
+ * > **Note**: Legacy GIFs (i.e. documents with `image/gif` MIME)
+ * > are also considered animations.
+ */
+export declare const animation: UpdateFilter<Message, {
+    media: Modify<Video, {
+        isRound: false;
+        isAnimation: true;
+    }>;
+}>;
+/**
+ * Filter messages containing a round message (aka video note).
+ */
+export declare const roundMessage: UpdateFilter<Message, {
+    media: Modify<Video, {
+        isRound: true;
+        isAnimation: false;
+    }>;
+}>;
+/**
+ * Filter messages containing a sticker by its type
+ */
+export declare function stickerByType(type: StickerType): UpdateFilter<Message, {
+    media: Sticker;
+}>;
+/**
+ * Filter messages containing a sticker by its source file type
+ */
+export declare function stickerBySourceType(type: StickerSourceType): UpdateFilter<Message, {
+    media: Sticker;
+}>;
+/**
+ * Filter text-only messages non-service messages
+ */
+export declare const text: UpdateFilter<Message, {
+    media: null;
+    isService: false;
+}>;
+/**
+ * Filter service messages
+ */
+export declare const service: UpdateFilter<Message, {
+    isService: true;
+}>;
+/**
+ * Filter service messages by action type
+ */
+export declare function action<T extends Exclude<MessageAction, null>['type']>(type: MaybeArray<T>): UpdateFilter<Message, {
+    action: Extract<MessageAction, {
+        type: T;
+    }>;
+    sender: T extends 'user_joined_link' | 'user_removed' | 'history_cleared' | 'contact_joined' | 'bot_allowed' ? User : Peer;
+}>;
+export declare function sender<T extends Message['sender']['type']>(type: T): UpdateFilter<Message, {
+    sender: Extract<Message['sender'], {
+        type: T;
+    }>;
+}>;
+/**
+ * Filter that matches messages that are replies to some other message that can be fetched
+ * (i.e. not `private` origin, and has not been deleted)
+ *
+ * Optionally, you can pass a filter that will be applied to the replied message.
+ */
+export declare function replyTo<Mod, State extends object>(filter?: UpdateFilter<Message, Mod, State>): UpdateFilter<MessageContext | BusinessMessageContext, {
+    getReplyTo: () => Promise<Message & Mod>;
+}, State>;
+/**
+ * Middleware-like filter that will fetch the sender of the message
+ * and make it available to further filters, as well as the handler itself.
+ */
+export declare function withCompleteSender<Mod, State extends object>(filter?: UpdateFilter<MessageContext, Mod, State>): UpdateFilter<MessageContext, Mod, State>;

package/{cjs/filters → filters}/state.d.ts

@@ -12,4 +12,4 @@ export declare const stateEmpty: UpdateFilter<any>;
  *
  * @param predicate  State predicate
  */
-export declare const state: <T extends object>(predicate: (state: T) => MaybePromise<boolean>) => UpdateFilter<any, {}, T>;
+export declare function state<T extends object>(predicate: (state: T) => MaybePromise<boolean>): UpdateFilter<any, {}, T>;

package/{esm/filters → filters}/text.d.ts

@@ -14,7 +14,7 @@ type UpdatesWithText = UpdateContextDistributed<Message | BusinessMessage | Inli
  *
  * @param regex  Regex to be matched
  */
-export declare const regex: (regex: RegExp) => UpdateFilter<UpdatesWithText, {
+export declare function regex(regex: RegExp): UpdateFilter<UpdatesWithText, {
     match: RegExpMatchArray;
 }>;
 /**
@@ -27,7 +27,7 @@ export declare const regex: (regex: RegExp) => UpdateFilter<UpdatesWithText, {
  * @param str  String to be matched
  * @param ignoreCase  Whether string case should be ignored
  */
-export declare const equals: (str: string, ignoreCase?: boolean) => UpdateFilter<UpdatesWithText>;
+export declare function equals(str: string, ignoreCase?: boolean): UpdateFilter<UpdatesWithText>;
 /**
  * Filter objects which contain the text given (as a substring)
  *  - for `Message`, `Message.text` is used
@@ -38,7 +38,7 @@ export declare const equals: (str: string, ignoreCase?: boolean) => UpdateFilter
  * @param str  Substring to be matched
  * @param ignoreCase  Whether string case should be ignored
  */
-export declare const contains: (str: string, ignoreCase?: boolean) => UpdateFilter<UpdatesWithText>;
+export declare function contains(str: string, ignoreCase?: boolean): UpdateFilter<UpdatesWithText>;
 /**
  * Filter objects which contain the text starting with a given string
  *  - for `Message`, `Message.text` is used
@@ -49,7 +49,7 @@ export declare const contains: (str: string, ignoreCase?: boolean) => UpdateFilt
  * @param str  Substring to be matched
  * @param ignoreCase  Whether string case should be ignored
  */
-export declare const startsWith: (str: string, ignoreCase?: boolean) => UpdateFilter<UpdatesWithText>;
+export declare function startsWith(str: string, ignoreCase?: boolean): UpdateFilter<UpdatesWithText>;
 /**
  * Filter objects which contain the text ending with a given string
  *  - for `Message`, `Message.text` is used
@@ -60,5 +60,5 @@ export declare const startsWith: (str: string, ignoreCase?: boolean) => UpdateFi
  * @param str  Substring to be matched
  * @param ignoreCase  Whether string case should be ignored
  */
-export declare const endsWith: (str: string, ignoreCase?: boolean) => UpdateFilter<UpdatesWithText>;
+export declare function endsWith(str: string, ignoreCase?: boolean): UpdateFilter<UpdatesWithText>;
 export {};

package/{esm/filters → filters}/user.d.ts

@@ -1,4 +1,4 @@
-import { BotChatJoinRequestUpdate, BusinessCallbackQuery, BusinessMessage, CallbackQuery, ChatMemberUpdate, ChosenInlineResult, DeleteStoryUpdate, HistoryReadUpdate, InlineCallbackQuery, InlineQuery, MaybeArray, Message, PollVoteUpdate, StoryUpdate, User, UserStatusUpdate, UserTypingUpdate } from '@mtcute/core';
+import { BotChatJoinRequestUpdate, BusinessCallbackQuery, BusinessMessage, CallbackQuery, ChatMemberUpdate, ChosenInlineResult, DeleteStoryUpdate, HistoryReadUpdate, InlineCallbackQuery, InlineQuery, MaybeArray, Message, PollVoteUpdate, StoryUpdate, UserStatusUpdate, UserTypingUpdate, User } from '@mtcute/core';
 import { UpdateContextDistributed } from '../context/base.js';
 import { UpdateFilter } from './types.js';
 /**

package/{esm/handler.d.ts → handler.d.ts}

@@ -1,4 +1,4 @@
-import { BotReactionCountUpdate, BotReactionUpdate, BotStoppedUpdate, BusinessConnection, ChatJoinRequestUpdate, ChatMemberUpdate, DeleteBusinessMessageUpdate, DeleteMessageUpdate, DeleteStoryUpdate, HistoryReadUpdate, MaybePromise, PeersIndex, PollUpdate, PollVoteUpdate, StoryUpdate, tl, UserStatusUpdate, UserTypingUpdate } from '@mtcute/core';
+import { BotReactionCountUpdate, BotReactionUpdate, BotStoppedUpdate, BusinessConnection, ChatJoinRequestUpdate, ChatMemberUpdate, DeleteBusinessMessageUpdate, DeleteMessageUpdate, DeleteStoryUpdate, HistoryReadUpdate, MaybePromise, PeersIndex, PollUpdate, PollVoteUpdate, StoryUpdate, UserStatusUpdate, UserTypingUpdate, tl } from '@mtcute/core';
 import { TelegramClient } from '@mtcute/core/client.js';
 import { UpdateContext } from './context/base.js';
 import { BusinessCallbackQueryContext, BusinessMessageContext, CallbackQueryContext, ChatJoinRequestUpdateContext, ChosenInlineResultContext, InlineCallbackQueryContext, InlineQueryContext, MessageContext, PreCheckoutQueryContext } from './context/index.js';