@mtkruto/node 0.1.132 → 0.1.134

package/script/client/{5_client.d.ts → 4_client.d.ts}

@@ -2,12 +2,21 @@ import { MaybePromise } from "../1_utilities.js";
 import { functions, ReadObject, types } from "../2_tl.js";
 import { Storage } from "../3_storage.js";
 import { DC } from "../3_transport.js";
-import { BotCommand, CallbackQuery, Chat, ChatAction, ChatID, Document, InlineQuery, InlineQueryResult, Message, ParseMode, Reaction, User } from "../3_types.js";
+import { BotCommand, Chat, ChatAction, ChatID, ChatP, Document, InlineQueryResult, Message, MessageAnimation, MessageAudio, MessageContact, MessageDice, MessageDocument, MessageLocation, MessagePhoto, MessagePoll, MessageText, MessageTypes, MessageVenue, MessageVideo, MessageVideoNote, MessageVoice, NetworkStatistics, ParseMode, Reaction, Update, UpdateIntersection, UpdateMap, User } from "../3_types.js";
 import { Migrate } from "../4_errors.js";
-import { FileSource, With } from "./0_utilities.js";
-import { ClientAbstract } from "./1_client_abstract.js";
-import { AddReactionParams, AnswerCallbackQueryParams, AnswerInlineQueryParams, AuthorizeUserParams, ClientParams, DeleteMessageParams, DeleteMessagesParams, DownloadParams, EditMessageParams, FilterableUpdates, FilterUpdate, ForwardMessagesParams, GetChatsParams, GetHistoryParams, GetMyCommandsParams, InvokeErrorHandler, NetworkStatistics, ReplyParams, SendAnimationParams, SendAudioParams, SendContactParams, SendDiceParams, SendDocumentParams, SendLocationParams, SendMessageParams, SendPhotoParams, SendPollParams, SendVenueParams, SendVideoNoteParams, SendVideoParams, SendVoiceParams, SetMyCommandsParams, Update, UploadParams } from "./3_types.js";
-import { Composer, Middleware } from "./4_composer.js";
+import { ClientAbstract } from "./0_client_abstract.js";
+import { FileSource, WithUpdate } from "./0_utilities.js";
+import { Composer, Middleware } from "./1_composer.js";
+import { AddReactionParams, AnswerCallbackQueryParams, AnswerInlineQueryParams, AuthorizeUserParams, ClientParams, DeleteMessageParams, DeleteMessagesParams, DownloadParams, EditMessageParams, ForwardMessagesParams, GetChatsParams, GetHistoryParams, GetMyCommandsParams, ReplyParams, SendAnimationParams, SendAudioParams, SendContactParams, SendDiceParams, SendDocumentParams, SendLocationParams, SendMessageParams, SendPhotoParams, SendPollParams, SendVenueParams, SendVideoNoteParams, SendVideoParams, SendVoiceParams, SetMyCommandsParams, SetReactionsParams, UploadParams } from "./3_params.js";
+export type NextFn<T = void> = () => Promise<T>;
+export interface InvokeErrorHandler<C> {
+    (ctx: {
+        client: C;
+        error: unknown;
+        function: types.Type | functions.Function<unknown>;
+        n: number;
+    }, next: NextFn<boolean>): MaybePromise<boolean>;
+}
 declare const getEntity: unique symbol;
 declare const getStickerSetName: unique symbol;
 export declare const handleMigrationError: unique symbol;
@@ -25,62 +34,65 @@ export type Api = {
         } ? Promisify<Functions[K][K_]["__F"]> : Functions[K][K_];
     };
 };
-export interface Context extends Update {
+export interface Context {
     /** The client that received the update. */
     client: Client;
-    me: undefined extends this["connectionState"] ? undefined extends this["authorizationState"] ? User : (User | undefined) : (User | undefined);
-    /** Resolves to `ctx.message ?? ctx.editedMessage ?? ctx.callbackQuery?.message`. */
-    msg: undefined extends this["message"] ? undefined extends this["editedMessage"] ? undefined extends this["callbackQuery"] ? never : this["callbackQuery"] extends With<CallbackQuery, "message"> ? this["callbackQuery"]["message"] : this["callbackQuery"] extends With<CallbackQuery, "inlineMessageId"> ? never : (Message | undefined) : this["editedMessage"] : this["message"];
-    /** Resolves to `effectiveMessage?.chat`. */
-    chat: this["msg"] extends never ? never : this["msg"]["chat"];
-    /** Resolves to `(ctx.message ?? ctx.editedMessage)?.from ?? ctx.callbackQuery?.from ?? ctx.inlineQuery?.from`. */
-    from: this["message"] extends Message ? this["message"]["from"] : this["editedMessage"] extends Message ? this["editedMessage"]["from"] : this["callbackQuery"] extends CallbackQuery ? this["callbackQuery"]["from"] : this["inlineQuery"] extends InlineQuery ? this["inlineQuery"]["from"] : never;
-    /** Resolves to `effectiveMessage?.senderChat`. */
-    senderChat: this["msg"] extends never ? never : this["msg"]["senderChat"];
+    /** The currently authorized user. */
+    me?: User;
+    /** Resolves to `message`, `editedMessage`, or the `message` field of `callbackQuery`. */
+    msg?: Message;
+    /** Resolves to `msg?.chat`. TODO */
+    chat?: ChatP;
+    /** Resolves to the `from` field of `message`, `editedMessage`, `callbackQuery`, or `inlineQuery`. */
+    from?: User;
+    /** Resolves to `msg?.senderChat`. */
+    senderChat?: ChatP;
     /** Reply the received message with a text message. */
-    reply: (text: string, params?: Omit<SendMessageParams, "replyToMessageId"> & ReplyParams) => Promise<With<Message, "text">>;
+    reply: (text: string, params?: Omit<SendMessageParams, "replyToMessageId"> & ReplyParams) => Promise<MessageText>;
     /** Reply the received message with a poll. */
-    replyPoll: (question: string, options: [string, string, ...string[]], params?: Omit<SendPollParams, "replyToMessageId"> & ReplyParams) => Promise<With<Message, "poll">>;
+    replyPoll: (question: string, options: [string, string, ...string[]], params?: Omit<SendPollParams, "replyToMessageId"> & ReplyParams) => Promise<MessagePoll>;
     /** Reply the received message with a photo. */
-    replyPhoto: (photo: FileSource, params?: Omit<SendPhotoParams, "replyToMessageId"> & ReplyParams) => Promise<With<Message, "photo">>;
+    replyPhoto: (photo: FileSource, params?: Omit<SendPhotoParams, "replyToMessageId"> & ReplyParams) => Promise<MessagePhoto>;
     /** Reply the received message with a document. */
-    replyDocument: (document: FileSource, params?: Omit<SendDocumentParams, "replyToMessageId"> & ReplyParams) => Promise<With<Message, "document">>;
+    replyDocument: (document: FileSource, params?: Omit<SendDocumentParams, "replyToMessageId"> & ReplyParams) => Promise<MessageDocument>;
     /** Reply the received message with a location. */
-    replyLocation: (latitude: number, longitude: number, params?: Omit<SendLocationParams, "replyToMessageId"> & ReplyParams) => Promise<With<Message, "location">>;
+    replyLocation: (latitude: number, longitude: number, params?: Omit<SendLocationParams, "replyToMessageId"> & ReplyParams) => Promise<MessageLocation>;
     /** Reply the received message with a dice. */
-    replyDice: (params?: Omit<SendDiceParams, "replyToMessageId"> & ReplyParams) => Promise<With<Message, "dice">>;
+    replyDice: (params?: Omit<SendDiceParams, "replyToMessageId"> & ReplyParams) => Promise<MessageDice>;
     /** Reply the received message with a venue. */
-    replyVenue: (latitude: number, longitude: number, title: string, address: string, params?: Omit<SendVenueParams, "replyToMessageId"> & ReplyParams) => Promise<With<Message, "venue">>;
+    replyVenue: (latitude: number, longitude: number, title: string, address: string, params?: Omit<SendVenueParams, "replyToMessageId"> & ReplyParams) => Promise<MessageVenue>;
     /** Reply the received message with a contact. */
-    replyContact: (firstName: string, number: string, params?: Omit<SendContactParams, "replyToMessageId"> & ReplyParams) => Promise<With<Message, "contact">>;
+    replyContact: (firstName: string, number: string, params?: Omit<SendContactParams, "replyToMessageId"> & ReplyParams) => Promise<MessageContact>;
     /** Reply the received message with a video. */
-    replyVideo: (video: FileSource, params?: Omit<SendVideoParams, "replyToMessageId"> & ReplyParams) => Promise<With<Message, "video">>;
+    replyVideo: (video: FileSource, params?: Omit<SendVideoParams, "replyToMessageId"> & ReplyParams) => Promise<MessageVideo>;
     /** Reply the received message with an animation. */
-    replyAnimation: (animation: FileSource, params?: Omit<SendAnimationParams, "replyToMessageId"> & ReplyParams) => Promise<With<Message, "animation">>;
+    replyAnimation: (animation: FileSource, params?: Omit<SendAnimationParams, "replyToMessageId"> & ReplyParams) => Promise<MessageAnimation>;
     /** Reply the received message with a voice message. */
-    replyVoice: (voice: FileSource, params?: Omit<SendVoiceParams, "replyToMessageId"> & ReplyParams) => Promise<With<Message, "voice">>;
+    replyVoice: (voice: FileSource, params?: Omit<SendVoiceParams, "replyToMessageId"> & ReplyParams) => Promise<MessageVoice>;
     /** Reply the received message with an audio file. */
-    replyAudio: (audio: FileSource, params?: Omit<SendAudioParams, "replyToMessageId"> & ReplyParams) => Promise<With<Message, "audio">>;
+    replyAudio: (audio: FileSource, params?: Omit<SendAudioParams, "replyToMessageId"> & ReplyParams) => Promise<MessageAudio>;
     /** Reply the received message with a video note. */
-    replyVideoNote: (videoNote: FileSource, params?: Omit<SendVideoNoteParams, "replyToMessageId"> & ReplyParams) => Promise<With<Message, "videoNote">>;
+    replyVideoNote: (videoNote: FileSource, params?: Omit<SendVideoNoteParams, "replyToMessageId"> & ReplyParams) => Promise<MessageVideoNote>;
     /** Delete the received message. */
     delete: () => Promise<void>;
     /** Forward the received message. */
     forward: (to: ChatID, params?: ForwardMessagesParams) => Promise<this["msg"]>;
+    /** Change the reactions made to the received message. */
+    react: (reactions: Reaction[], params?: SetReactionsParams) => Promise<void>;
     /** Send a chat action to the chat which the message was received from. */
     sendChatAction: (action: ChatAction, params?: {
         messageThreadId?: number;
     }) => Promise<void>;
     /** Edit a message in the chat which the message was received from. */
-    editMessageText: (messageId: number, text: string, params?: EditMessageParams) => Promise<With<Message, "text">>;
+    editMessageText: (messageId: number, text: string, params?: EditMessageParams) => Promise<MessageText>;
     /** Answer the received callback query. */
     answerCallbackQuery: (params?: AnswerCallbackQueryParams) => Promise<void>;
     /** Answer the received inline query. */
     answerInlineQuery: (results: InlineQueryResult[], params?: AnswerInlineQueryParams) => Promise<void>;
     /** Retrieve a single message of the chat which the message was received from. */
-    getMessage: (messageId: number) => Promise<Omit<Message, "replyToMessage"> | null>;
+    getMessage: (messageId: number) => Promise<Message | null>;
     /** Retrieve multiple messages of the chat which the message was received from. */
-    getMessages: (messageIds: number[]) => Promise<Omit<Message, "replyToMessage">[]>;
+    getMessages: (messageIds: number[]) => Promise<Message[]>;
     /** Forward a message of the chat which the message was received from. */
     forwardMessage: (to: ChatID, messageId: number, params?: ForwardMessagesParams) => Promise<Message>;
     /** Forward multiple messages of the chat which the message was received from. */
@@ -93,6 +105,10 @@ export interface Context extends Update {
     setAvailableReactions: (availableReactions: "none" | "all" | Reaction[]) => Promise<void>;
     /** Add a reaction to a message of the chat which the message was received from. */
     addReaction: (messageId: number, reaction: Reaction, params?: AddReactionParams) => Promise<void>;
+    /** Remove a reaction from a message of the chat which the message was received from. */
+    removeReaction: (messageId: number, reaction: Reaction) => Promise<void>;
+    /** Change the reactions made to a message of the chat which the message was received from. */
+    setReactions: (messageId: number, reactions: Reaction[], params?: SetReactionsParams) => Promise<void>;
     toJSON: () => Update;
 }
 export declare function skipInvoke<C extends Context>(): InvokeErrorHandler<Client<C>>;
@@ -189,7 +205,7 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      * @param text The message's text.
      * @returns The sent text message.
      */
-    sendMessage(chatId: ChatID, text: string, params?: SendMessageParams): Promise<With<Message, "text">>;
+    sendMessage(chatId: ChatID, text: string, params?: SendMessageParams): Promise<MessageText>;
     /**
      * Edit a message's text.
      *
@@ -199,7 +215,7 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      * @param text The new text of the message.
      * @returns The edited text message.
      */
-    editMessageText(chatId: ChatID, messageId: number, text: string, params?: EditMessageParams): Promise<With<Message, "text">>;
+    editMessageText(chatId: ChatID, messageId: number, text: string, params?: EditMessageParams): Promise<MessageText>;
     /**
      * Retrieve multiple messages.
      *
@@ -211,7 +227,7 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      * ```
      * @returns The retrieved messages.
      */
-    getMessages(chatId: ChatID, messageIds: number[]): Promise<Omit<Message, "replyToMessage">[]>;
+    getMessages(chatId: ChatID, messageIds: number[]): Promise<Message[]>;
     private [getMessageWithReply];
     /**
      * Retrieve a single message.
@@ -224,7 +240,7 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      * ```
      * @returns The retrieved message.
      */
-    getMessage(chatId: ChatID, messageId: number): Promise<Omit<Message, "replyToMessage"> | null>;
+    getMessage(chatId: ChatID, messageId: number): Promise<Message | null>;
     /**
      * Download a file.
      *
@@ -281,7 +297,7 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      * @param options The poll's options.
      * @returns The sent poll.
      */
-    sendPoll(chatId: ChatID, question: string, options: [string, string, ...string[]], params?: SendPollParams): Promise<With<Message, "poll">>;
+    sendPoll(chatId: ChatID, question: string, options: [string, string, ...string[]], params?: SendPollParams): Promise<MessagePoll>;
     /**
      * Send a chat action.
      *
@@ -319,21 +335,21 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      * @param results The results to answer with.
      */
     answerInlineQuery(id: string, results: InlineQueryResult[], params?: AnswerInlineQueryParams): Promise<void>;
-    use(...middleware: Middleware<C>[]): Composer<C>;
-    branch(predicate: (ctx: C) => MaybePromise<boolean>, trueHandler_: Middleware<C>, falseHandler_: Middleware<C>): Composer<C>;
-    filter<D extends C>(predicate: (ctx: C) => ctx is D, ...middleware: Middleware<D>[]): Composer<D>;
-    filter(predicate: (ctx: C) => MaybePromise<boolean>, ...middleware: Middleware<C>[]): Composer<C>;
-    on<T extends keyof Update, F extends string>(filter: T extends FilterableUpdates ? T | [T, F, ...F[]] : T, ...middleawre: Middleware<FilterUpdate<C, T, F>>[]): Composer<FilterUpdate<C, T, F>>;
+    use(...middleware: Middleware<UpdateIntersection<C>>[]): Composer<UpdateIntersection<C>>;
+    branch(predicate: (ctx: UpdateIntersection<C>) => MaybePromise<boolean>, trueHandler_: Middleware<UpdateIntersection<C>>, falseHandler_: Middleware<UpdateIntersection<C>>): Composer<UpdateIntersection<C>>;
+    filter<D extends C>(predicate: (ctx: UpdateIntersection<C>) => ctx is D, ...middleware: Middleware<D>[]): Composer<D>;
+    filter(predicate: (ctx: UpdateIntersection<C>) => MaybePromise<boolean>, ...middleware: Middleware<UpdateIntersection<C>>[]): Composer<C>;
+    on<T extends keyof UpdateMap, F extends string, K extends keyof MessageTypes>(filter: T extends "message" | "editedMessage" ? T | [T, K, ...F[]] : T, ...middleawre: Middleware<WithUpdate<C, T, K, F>>[]): Composer<WithUpdate<C, T, K, F>>;
     command(commands: string | RegExp | (string | RegExp)[] | {
         names: string | RegExp | (string | RegExp)[];
         prefixes: string | string[];
-    }, ...middleawre: Middleware<FilterUpdate<C, "message", "text">>[]): Composer<FilterUpdate<C, "message", "text">>;
+    }, ...middleawre: Middleware<WithUpdate<C, "message", "text">>[]): Composer<WithUpdate<C, "message", "text", string>>;
     /**
      * Set the bot's description in the given language. Bot-only.
      *
      * @method
      */
-    setMyDescription({ description, languageCode }: {
+    setMyDescription(params?: {
         description?: string;
         languageCode?: string;
     }): Promise<void>;
@@ -342,7 +358,7 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      *
      * @method
      */
-    setMyName({ name, languageCode }: {
+    setMyName(params?: {
         name?: string;
         languageCode?: string;
     }): Promise<void>;
@@ -351,7 +367,7 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      *
      * @method
      */
-    setMyShortDescription({ shortDescription: about, languageCode }: {
+    setMyShortDescription(params?: {
         shortDescription?: string;
         languageCode?: string;
     }): Promise<void>;
@@ -402,7 +418,7 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      * @param chatId The chat to send the photo to.
      * @param photo The photo to send.
      */
-    sendPhoto(chatId: ChatID, photo: FileSource, params?: SendPhotoParams): Promise<With<Message, "photo">>;
+    sendPhoto(chatId: ChatID, photo: FileSource, params?: SendPhotoParams): Promise<MessagePhoto>;
     /**
      * Send a document.
      *
@@ -410,7 +426,7 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      * @param chatId The chat to send the document to.
      * @param document The document to send.
      */
-    sendDocument(chatId: ChatID, document: FileSource, params?: SendDocumentParams): Promise<With<Message, "document">>;
+    sendDocument(chatId: ChatID, document: FileSource, params?: SendDocumentParams): Promise<MessageDocument>;
     /**
      * Send a video.
      *
@@ -418,7 +434,7 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      * @param chatId The chat to send the video to.
      * @param video The video to send.
      */
-    sendVideo(chatId: ChatID, video: FileSource, params?: SendVideoParams): Promise<With<Message, "video">>;
+    sendVideo(chatId: ChatID, video: FileSource, params?: SendVideoParams): Promise<MessageVideo>;
     /**
      * Send an animation.
      *
@@ -426,7 +442,7 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      * @param chatId The chat to send the animation to.
      * @param animation The animation to send.
      */
-    sendAnimation(chatId: ChatID, animation: FileSource, params?: SendAnimationParams): Promise<With<Message, "animation">>;
+    sendAnimation(chatId: ChatID, animation: FileSource, params?: SendAnimationParams): Promise<MessageAnimation>;
     /**
      * Send a voice message.
      *
@@ -434,7 +450,7 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      * @param chatId The chat to send the voice message to.
      * @param voice The voice to send.
      */
-    sendVoice(chatId: ChatID, voice: FileSource, params?: SendVoiceParams): Promise<With<Message, "voice">>;
+    sendVoice(chatId: ChatID, voice: FileSource, params?: SendVoiceParams): Promise<MessageVoice>;
     /**
      * Send an audio file.
      *
@@ -442,7 +458,7 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      * @param chatId The chat to send the audio file to.
      * @param audio The audio to send.
      */
-    sendAudio(chatId: ChatID, audio: FileSource, params?: SendAudioParams): Promise<With<Message, "audio">>;
+    sendAudio(chatId: ChatID, audio: FileSource, params?: SendAudioParams): Promise<MessageAudio>;
     /**
      * Send a video note.
      *
@@ -450,7 +466,7 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      * @param chatId The chat to send the video note to.
      * @param videoNote The video note to send.
      */
-    sendVideoNote(chatId: ChatID, audio: FileSource, params?: SendVideoNoteParams): Promise<With<Message, "videoNote">>;
+    sendVideoNote(chatId: ChatID, audio: FileSource, params?: SendVideoNoteParams): Promise<MessageVideoNote>;
     /**
      * Send a location.
      *
@@ -459,7 +475,7 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      * @param latitude The location's latitude.
      * @param longitude The location's longitude.
      */
-    sendLocation(chatId: ChatID, latitude: number, longitude: number, params?: SendLocationParams): Promise<With<Message, "location">>;
+    sendLocation(chatId: ChatID, latitude: number, longitude: number, params?: SendLocationParams): Promise<MessageLocation>;
     /**
      * Send a contact.
      *
@@ -468,14 +484,14 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      * @param firstName The contact's first name.
      * @param number The contact's phone number.
      */
-    sendContact(chatId: ChatID, firstName: string, number: string, params?: SendContactParams): Promise<With<Message, "contact">>;
+    sendContact(chatId: ChatID, firstName: string, number: string, params?: SendContactParams): Promise<MessageContact>;
     /**
      * Send a dice.
      *
      * @method
      * @param chatId The chat to send the dice to.
      */
-    sendDice(chatId: ChatID, params?: SendDiceParams): Promise<With<Message, "dice">>;
+    sendDice(chatId: ChatID, params?: SendDiceParams): Promise<MessageDice>;
     /**
      * Send a venue.
      *
@@ -486,7 +502,7 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      * @param title The title of the venue.
      * @param address The written address of the venue.
      */
-    sendVenue(chatId: ChatID, latitude: number, longitude: number, title: string, address: string, params?: SendVenueParams): Promise<With<Message, "dice">>;
+    sendVenue(chatId: ChatID, latitude: number, longitude: number, title: string, address: string, params?: SendVenueParams): Promise<MessageVenue>;
     /**
      * Get network statistics. This might not always be available.
      *
@@ -528,12 +544,28 @@ export declare class Client<C extends Context = Context> extends ClientAbstract
      */
     setAvailableReactions(chatId: ChatID, availableReactions: "none" | "all" | Reaction[]): Promise<void>;
     /**
-     * Add a reaction to a message.
+     * Change reactions made to a message.
+     *
+     * @param chatId The identifier of the chat which the message belongs to.
+     * @param messageId The identifier of the message to add the reaction to.
+     * @param reactions The new reactions.
+     */
+    setReactions(chatId: number, messageId: number, reactions: Reaction[], params?: SetReactionsParams): Promise<void>;
+    /**
+     * Make a reaction to a message.
      *
      * @param chatId The identifier of the chat which the message belongs to.
      * @param messageId The identifier of the message to add the reaction to.
      * @param reaction The reaction to add.
      */
     addReaction(chatId: number, messageId: number, reaction: Reaction, params?: AddReactionParams): Promise<void>;
+    /**
+     * Undo a reaction made to a message.
+     *
+     * @param chatId The identifier of the chat which the message belongs to.
+     * @param messageId The identifier of the message which the reaction was made to.
+     * @param reaction The reaction to remove.
+     */
+    removeReaction(chatId: number, messageId: number, reaction: Reaction): Promise<void>;
 }
 export {};