@mtkruto/node 0.1.500 → 0.1.700

package/esm/3_types.d.ts

@@ -20,6 +20,7 @@
 export * from "./types/_file_id.js";
 export * from "./types/_getters.js";
 export * from "./types/0_authorization_state.js";
+export * from "./types/0_birthday.js";
 export * from "./types/0_bot_command.js";
 export * from "./types/0_callback_query_answer.js";
 export * from "./types/0_callback_query_question.js";
@@ -35,6 +36,7 @@ export * from "./types/0_giveaway_parameters.js";
 export * from "./types/0_id.js";
 export * from "./types/0_keyboard_button_poll_type.js";
 export * from "./types/0_link_preview.js";
+export * from "./types/0_live_stream_channel.js";
 export * from "./types/0_location.js";
 export * from "./types/0_login_url.js";
 export * from "./types/0_mask_position.js";
@@ -43,6 +45,7 @@ export * from "./types/0_message_reference.js";
 export * from "./types/0_message_search_filter.js";
 export * from "./types/0_mini_app_info.js";
 export * from "./types/0_network_statistics_entry.js";
+export * from "./types/0_opening_hours.js";
 export * from "./types/0_parse_mode.js";
 export * from "./types/0_poll_option.js";
 export * from "./types/0_price_tag.js";
@@ -51,6 +54,7 @@ export * from "./types/0_restriction_reason.js";
 export * from "./types/0_self_destruct_option.js";
 export * from "./types/0_story_reference.js";
 export * from "./types/0_thumbnail.js";
+export * from "./types/0_video_chat.js";
 export * from "./types/0_voice.js";
 export * from "./types/1_animation.js";
 export * from "./types/1_audio.js";
@@ -96,6 +100,7 @@ export * from "./types/3_story.js";
 export * from "./types/4_inline_query_result.js";
 export * from "./types/4_message.js";
 export * from "./types/5_callback_query.js";
-export * from "./types/5_chat.js";
+export * from "./types/5_chat_list_item.js";
+export * from "./types/2_chat.js";
 export * from "./types/5_inline_query_answer.js";
 export * from "./types/6_update.js";

package/esm/3_types.js

@@ -20,6 +20,7 @@
 export * from "./types/_file_id.js";
 export * from "./types/_getters.js";
 export * from "./types/0_authorization_state.js";
+export * from "./types/0_birthday.js";
 export * from "./types/0_bot_command.js";
 export * from "./types/0_callback_query_answer.js";
 export * from "./types/0_callback_query_question.js";
@@ -35,6 +36,7 @@ export * from "./types/0_giveaway_parameters.js";
 export * from "./types/0_id.js";
 export * from "./types/0_keyboard_button_poll_type.js";
 export * from "./types/0_link_preview.js";
+export * from "./types/0_live_stream_channel.js";
 export * from "./types/0_location.js";
 export * from "./types/0_login_url.js";
 export * from "./types/0_mask_position.js";
@@ -43,6 +45,7 @@ export * from "./types/0_message_reference.js";
 export * from "./types/0_message_search_filter.js";
 export * from "./types/0_mini_app_info.js";
 export * from "./types/0_network_statistics_entry.js";
+export * from "./types/0_opening_hours.js";
 export * from "./types/0_parse_mode.js";
 export * from "./types/0_poll_option.js";
 export * from "./types/0_price_tag.js";
@@ -51,6 +54,7 @@ export * from "./types/0_restriction_reason.js";
 export * from "./types/0_self_destruct_option.js";
 export * from "./types/0_story_reference.js";
 export * from "./types/0_thumbnail.js";
+export * from "./types/0_video_chat.js";
 export * from "./types/0_voice.js";
 export * from "./types/1_animation.js";
 export * from "./types/1_audio.js";
@@ -96,6 +100,7 @@ export * from "./types/3_story.js";
 export * from "./types/4_inline_query_result.js";
 export * from "./types/4_message.js";
 export * from "./types/5_callback_query.js";
-export * from "./types/5_chat.js";
+export * from "./types/5_chat_list_item.js";
+export * from "./types/2_chat.js";
 export * from "./types/5_inline_query_answer.js";
 export * from "./types/6_update.js";

package/esm/4_errors.js

@@ -73,10 +73,8 @@ export function upgradeInstance(error, call) {
             return new v({ ...error, call });
         }
     }
-    for (const [k, v] of Object.entries(map)) {
-        if (error.error_message == k) {
-            return new v({ ...error, call });
-        }
+    if (error.error_message in map) {
+        return new map[error.error_message]({ ...error, call });
     }
     return error;
 }

package/esm/5_client.d.ts

@@ -20,4 +20,4 @@
 export * from "./client/0_params.js";
 export * from "./client/1_client_encrypted.js";
 export * from "./client/1_client_plain.js";
-export * from "./client/4_client.js";
+export * from "./client/5_client.js";

package/esm/5_client.js

@@ -20,4 +20,4 @@
 export * from "./client/0_params.js";
 export * from "./client/1_client_encrypted.js";
 export * from "./client/1_client_plain.js";
-export * from "./client/4_client.js";
+export * from "./client/5_client.js";

package/esm/client/0_params.d.ts

@@ -18,7 +18,7 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 import { MaybePromise } from "../1_utilities.js";
-import { BotCommandScope, Chat, ChatMemberRights, FileSource, ID, InlineQueryResultButton, LinkPreview, Message, MessageEntity, MessageSearchFilter, ParseMode, ReplyMarkup, ReplyQuote, SelfDestructOption, StoryInteractiveArea, StoryPrivacy } from "../3_types.js";
+import { BotCommandScope, ChatListItem, ChatMemberRights, FileSource, ID, InlineQueryResultButton, LinkPreview, Message, MessageEntity, MessageSearchFilter, ParseMode, ReplyMarkup, ReplyQuote, SelfDestructOption, StoryInteractiveArea, StoryPrivacy } from "../3_types.js";
 export interface AnswerCallbackQueryParams {
     /** A text to be shown to the user. */
     text?: string;
@@ -29,11 +29,15 @@ export interface AnswerCallbackQueryParams {
     /** TTL of answer caches in seconds. */
     cacheTime?: number;
 }
-export interface AuthorizeUserParams<S = string> {
+export interface SignInParamsUser<S = string> {
     phone: S | (() => MaybePromise<S>);
     code: S | (() => MaybePromise<S>);
     password: S | ((hint: string | null) => MaybePromise<S>);
 }
+export interface SignInParamsBot {
+    botToken: string;
+}
+export type SignInParams = SignInParamsUser | SignInParamsBot;
 export interface _BusinessConnectionIdCommon {
     businessConnectionId?: string;
 }
@@ -48,7 +52,7 @@ export interface _SendCommon extends _BusinessConnectionIdCommon {
     replyQuote?: ReplyQuote;
     /** The identifier of a thread to send the message to. */
     messageThreadId?: number;
-    /** The identifier of the chat to send the message on behalf of. User-only. */
+    /** The identifier of a chat to send the message on behalf of. User-only. */
     sendAs?: ID;
     /** The reply markup of the message. Bot-only. */
     replyMarkup?: ReplyMarkup;
@@ -276,7 +280,7 @@ export interface GetChatsParams {
     /** The chat list to get the chats from. Defaults to main. */
     from?: "main" | "archived";
     /** The last chat to get chats after. */
-    after?: Chat;
+    after?: ChatListItem;
     /** The maximum number of results to return. Must be in the range of 1-100. Defaults to 100. */
     limit?: number;
 }
@@ -287,7 +291,7 @@ export interface PinMessageParams {
     disableNotification?: boolean;
 }
 export interface BanChatMemberParams {
-    /** A point of time in the future to automatically withdraw the ban. */
+    /** A point in time within the future in which the ban will be reverted. */
     untilDate?: Date;
     /** Whether to delete all of the user's messages. */
     deleteMessages?: boolean;
@@ -295,7 +299,7 @@ export interface BanChatMemberParams {
 export interface SetChatMemberRightsParams {
     /** The member's new rights. All fields default to `true` if the chat's default member rights allow. This means that this method is the same as unbanChatMember if this parameter is not provided or all of its fields are `true`. */
     rights?: ChatMemberRights;
-    /** A point of time in the future to automatically withdraw the restrictions. */
+    /** A point in time within the future in which the restriction will be reverted. */
     untilDate?: Date;
 }
 export interface CreateStoryParams extends _CaptionCommon, _UploadCommon {
@@ -325,7 +329,7 @@ export interface SearchMessagesParams {
 export interface CreateInviteLinkParams {
     /** An optional title to be attached to the link that can only be seen by admins. */
     title?: string;
-    /** The point of time in which the invite link must no longer work. */
+    /** A point in time within the future in which the invite link will be invalidated. */
     expireAt?: Date;
     /** The times the invite link can be used. Cannot be specified while `requireApproval` is `true`. */
     limit?: number;
@@ -359,3 +363,25 @@ export interface SendInlineQueryParams {
     query?: string;
     offset?: string;
 }
+export interface StartVideoChatParams {
+    /** The video chat's title. */
+    title?: string;
+    /** Whether this is going to be a live stream. */
+    liveStream?: boolean;
+}
+export interface ScheduleVideoChatParams extends StartVideoChatParams {
+}
+export interface JoinVideoChatParams {
+    /** The identifier of a chat to join the video chat on behalf of. */
+    joinAs?: ID;
+    /** Invite hash. */
+    inviteHash?: string;
+    /** Whether to enable audio. Enabled by default. */
+    audio?: boolean;
+    /** Whether to enable video. Enabled by default. */
+    video?: boolean;
+}
+export interface DownloadLiveStreamChunkParams {
+    /** Video quality. */
+    quality?: "low" | "medium" | "high";
+}

package/esm/client/0_storage_operations.d.ts

@@ -0,0 +1,182 @@
+/**
+ * MTKruto - Cross-runtime JavaScript library for building Telegram clients
+ * Copyright (C) 2023-2024 Roj <https://roj.im/>
+ *
+ * This file is part of MTKruto.
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+import { MaybePromise } from "../1_utilities.js";
+import { AnyEntity, enums, ReadObject, TLObject, types } from "../2_tl.js";
+import { DC } from "../3_transport.js";
+import { Storage, StorageKeyPart } from "../2_storage.js";
+export declare const K: {
+    connection: {
+        P: (string: string) => string;
+        apiId: () => StorageKeyPart[];
+    };
+    session: {
+        P: (string: string) => string;
+        serverSalt: () => StorageKeyPart[];
+    };
+    auth: {
+        P: (string: string) => string;
+        dc: () => StorageKeyPart[];
+        key: () => StorageKeyPart[];
+        accountId: () => StorageKeyPart[];
+        accountType: () => StorageKeyPart[];
+    };
+    updates: {
+        P: (string: string) => string;
+        state: () => StorageKeyPart[];
+        all: () => StorageKeyPart[];
+        updates: (boxId: bigint) => StorageKeyPart[];
+        update: (boxId: bigint, id: bigint) => StorageKeyPart[];
+        channelPts: (channelId: bigint) => StorageKeyPart[];
+    };
+    cache: {
+        P: (string: string) => string;
+        usernames: () => StorageKeyPart[];
+        username: (v: string) => StorageKeyPart[];
+        peers: () => StorageKeyPart[];
+        peer: (id: number) => StorageKeyPart[];
+        stickerSetNames: () => StorageKeyPart[];
+        stickerSetName: (id: bigint, accessHash: bigint) => StorageKeyPart[];
+        files: () => StorageKeyPart[];
+        file: (fileId: bigint) => StorageKeyPart[];
+        fileParts: () => StorageKeyPart[];
+        filePart: (fileId: bigint, n: number) => StorageKeyPart[];
+        customEmojiDocuments: () => StorageKeyPart[];
+        customEmojiDocument: (id: bigint) => StorageKeyPart[];
+        businessConnections: () => StorageKeyPart[];
+        businessConnection: (id: string) => StorageKeyPart[];
+        inlineQueryAnswers: () => StorageKeyPart[];
+        inlineQueryAnswer: (userId: number, chatId: number, query: string, offset: string) => StorageKeyPart[];
+        callbackQueryAnswers: () => StorageKeyPart[];
+        callbackQueryAnswer: (chatId: number, messageId: number, question: string) => StorageKeyPart[];
+        fullChats: () => StorageKeyPart[];
+        fullChat: (chatId: number) => StorageKeyPart[];
+        groupCalls: () => StorageKeyPart[];
+        groupCall: (id: bigint) => StorageKeyPart[];
+        groupCallAccessHashes: () => StorageKeyPart[];
+        groupCallAccessHash: (id: bigint) => StorageKeyPart[];
+    };
+    messages: {
+        P: (string: string) => string;
+        messages: (chatId: number) => StorageKeyPart[];
+        message: (chatId: number, messageId: number) => StorageKeyPart[];
+        allMessageRefs: () => StorageKeyPart[];
+        messageRef: (messageId: number) => StorageKeyPart[];
+    };
+    chatlists: {
+        P: (string: string) => string;
+        hasAllChats: (listId: number) => StorageKeyPart[];
+        chats: (listId: number) => StorageKeyPart[];
+        chat: (listId: number, chatId: number) => StorageKeyPart[];
+        pinnedChats: (listId: number) => StorageKeyPart[];
+    };
+};
+export declare class StorageOperations {
+    #private;
+    constructor(storage: Storage);
+    get provider(): Storage;
+    get supportsFiles(): boolean;
+    initialize(): Promise<void>;
+    set(...args: Parameters<Storage["set"]>): ReturnType<Storage["set"]>;
+    incr(...args: Parameters<Storage["incr"]>): ReturnType<Storage["incr"]>;
+    get<T>(...args: Parameters<Storage["get"]>): ReturnType<Storage["get"]>;
+    getMany<T>(...args: Parameters<Storage["getMany"]>): ReturnType<Storage["getMany"]>;
+    setDc(dc: DC | null): Promise<void>;
+    getDc(): MaybePromise<DC | null>;
+    getAuthKey(): Promise<Uint8Array | null>;
+    setAuthKey(authKey: Uint8Array | null): Promise<void>;
+    get authKeyId(): bigint | null;
+    exportAuthString(apiId_?: number | null): Promise<string>;
+    importAuthString(string: string): Promise<void>;
+    getChannelAccessHash(id: number): Promise<bigint | null>;
+    getUserAccessHash(id: number): Promise<bigint | null>;
+    updateUsernames(id: number, usernames: string[]): Promise<void>;
+    getUsername(username: string): Promise<[number, Date] | null>;
+    setTlObject(key: readonly StorageKeyPart[], value: TLObject | null): Promise<void>;
+    getTlObject(keyOrBuffer: TLObject | Uint8Array | readonly StorageKeyPart[]): Promise<ReadObject | null>;
+    setState(state: enums.updates.State): Promise<void>;
+    getState(): Promise<enums.updates.State | null>;
+    setMessage(chatId: number, messageId: number, message: enums.Message | null): Promise<void>;
+    deleteMessages(): Promise<void>;
+    getMessageChat(messageId: number): MaybePromise<number | null>;
+    getMessage(chatId: number, messageId: number): Promise<enums.Message | null>;
+    getLastMessage(chatId: number): Promise<enums.Message | null>;
+    setChannelPts(channelId: bigint, pts: number): Promise<void>;
+    getChannelPts(channelId: bigint): MaybePromise<number | null>;
+    setEntity(entity: AnyEntity): Promise<void>;
+    getEntity(key: number): Promise<ReadObject | null>;
+    setAccountId(accountId: number): Promise<void>;
+    getAccountId(): Promise<number | null>;
+    setAccountType(type: "user" | "bot"): Promise<void>;
+    getAccountType(): Promise<"user" | "bot" | null>;
+    updateStickerSetName(id: bigint, accessHash: bigint, name: string): Promise<void>;
+    getStickerSetName(id: bigint, accessHash: bigint): MaybePromise<[string, Date] | null>;
+    setServerSalt(serverSalt: bigint): Promise<void>;
+    getServerSalt(): MaybePromise<bigint | null>;
+    setChat(listId: number, chatId: number, pinned: number, topMessageId: number, topMessageDate: Date): Promise<void>;
+    getChats(listId: number): Promise<{
+        chatId: number;
+        pinned: number;
+        topMessageId: number;
+        topMessageDate: Date;
+    }[]>;
+    removeChats(listId: number): Promise<void>;
+    setHasAllChats(listId: number, hasAllChats: boolean): Promise<void>;
+    hasAllChats(listId: number): Promise<boolean>;
+    setPinnedChats(listId: number, chatIds: number[] | null): Promise<void>;
+    getPinnedChats(listId: number): Promise<number[] | null>;
+    getHistory(chatId: number, offsetId: number, limit: number): Promise<enums.Message[]>;
+    getFile(id: bigint): Promise<[number, number] | null>;
+    iterFileParts(id: bigint, partCount: number, offset: number): AsyncGenerator<Uint8Array>;
+    saveFilePart(id: bigint, index: number, bytes: Uint8Array): Promise<void>;
+    setFilePartCount(id: bigint, partCount: number, chunkSize: number): Promise<void>;
+    setCustomEmojiDocument(id: bigint, document: types.Document): Promise<void>;
+    getCustomEmojiDocument(id: bigint): Promise<[types.Document, Date] | null>;
+    setBusinessConnection(id: string, connection: types.BotBusinessConnection | null): Promise<void>;
+    getBusinessConnection(id: string): Promise<types.BotBusinessConnection | null>;
+    setInlineQueryAnswer(userId: number, chatId: number, query: string, offset: string, results: types.messages.BotResults, date: Date): Promise<void>;
+    getInlineQueryAnswer(userId: number, chatId: number, query: string, offset: string): Promise<[types.messages.BotResults, Date] | null>;
+    setCallbackQueryAnswer(chatId: number, messageId: number, question: string, answer: types.messages.BotCallbackAnswer): Promise<void>;
+    getCallbackQueryAnswer(chatId: number, messageId: number, question: string): Promise<[types.messages.BotCallbackAnswer, Date] | null>;
+    setFullChat(chatId: number, fullChat: types.UserFull | types.ChannelFull | types.ChatFull | null): Promise<void>;
+    getFullChat(chatId: number): Promise<types.UserFull | types.ChannelFull | types.ChatFull | null>;
+    setGroupCall(id: bigint, groupCall: types.GroupCall | null): Promise<void>;
+    getGroupCall(id: bigint): Promise<types.GroupCall | null>;
+    setGroupCallAccessHash(id: bigint, accessHash: bigint | null): Promise<void>;
+    getGroupCallAccessHash(id: bigint): Promise<bigint | null>;
+    setUpdate(boxId: bigint, update: enums.Update): Promise<void>;
+    deleteUpdates(): Promise<void>;
+    getFirstUpdate(boxId: bigint): Promise<[readonly StorageKeyPart[], enums.Update] | null>;
+    assertUser(source: string): Promise<void>;
+    assertBot(source: string): Promise<void>;
+    deleteFiles(): Promise<void>;
+    deleteCustomEmojiDocuments(): Promise<void>;
+    deleteBusinessConnections(): Promise<void>;
+    deleteInlineQueryAnswers(): Promise<void>;
+    deleteCallbackQueryAnswers(): Promise<void>;
+    deleteFullChats(): Promise<void>;
+    deleteGroupCalls(): Promise<void>;
+    deleteStickerSetNames(): Promise<void>;
+    deletePeers(): Promise<void>;
+    deleteUsernames(): Promise<void>;
+    clear(): Promise<void>;
+    setApiId(apiId: number): Promise<void>;
+    getApiId(): Promise<number | null>;
+    reset(): Promise<void>;
+}