@mtkruto/node 0.1.600 → 0.1.701

package/{esm/client/0_types.d.ts → script/client/1_types.d.ts}

@@ -18,7 +18,7 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 import { enums, functions, types } from "../2_tl.js";
-import { Storage } from "../3_storage.js";
+import { StorageOperations } from "./0_storage_operations.js";
 import { ConnectionState, EntityGetter, ID, ParseMode, Update } from "../3_types.js";
 type Functions = typeof functions;
 type Keys = keyof Functions;
@@ -53,8 +53,8 @@ interface GetCdnConnectionPool {
 export interface C {
     id: number;
     api: Api;
-    storage: Storage;
-    messageStorage: Storage;
+    storage: StorageOperations;
+    messageStorage: StorageOperations;
     guaranteeUpdateDelivery: boolean;
     setConnectionState: (connectionState: ConnectionState) => void;
     resetConnectionState: () => void;

package/{esm/client/1_account_manager.d.ts → script/client/2_account_manager.d.ts}

@@ -18,7 +18,7 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 import { ID } from "../3_types.js";
-import { C } from "./0_types.js";
+import { C } from "./1_types.js";
 export declare class AccountManager {
     #private;
     constructor(c: C);

package/{esm/client/1_bot_info_manager.d.ts → script/client/2_bot_info_manager.d.ts}

@@ -19,7 +19,7 @@
  */
 import { BotCommand } from "../3_types.js";
 import { GetMyCommandsParams, SetMyCommandsParams } from "./0_params.js";
-import { C } from "./0_types.js";
+import { C } from "./1_types.js";
 export declare class BotInfoManager {
     #private;
     constructor(c: C);

package/script/client/{1_business_connection_manager.d.ts → 2_business_connection_manager.d.ts}

@@ -19,7 +19,7 @@
  */
 import { enums, types } from "../2_tl.js";
 import { Update } from "../3_types.js";
-import { C } from "./0_types.js";
+import { C } from "./1_types.js";
 export type BusinessConnectionManagerUpdate = types.UpdateBotBusinessConnect;
 export declare class BusinessConnectionManager {
     #private;

package/{esm/client/1_file_manager.d.ts → script/client/2_file_manager.d.ts}

@@ -1,7 +1,7 @@
 import { enums, types } from "../2_tl.js";
 import { FileSource, Sticker } from "../3_types.js";
 import { DownloadParams, UploadParams } from "./0_params.js";
-import { C } from "./0_types.js";
+import { C } from "./1_types.js";
 export declare class FileManager {
     #private;
     constructor(c: C);

package/script/client/{1_file_manager.js → 2_file_manager.js}

@@ -318,14 +318,16 @@ _a = FileManager, _FileManager_c = new WeakMap(), _FileManager_Lupload = new Wea
     const isBig = buffer.byteLength > __classPrivateFieldGet(_a, _a, "f", _FileManager_BIG_FILE_THRESHOLD);
     const partCount = Math.ceil(buffer.byteLength / chunkSize);
     let promises = new Array();
-    for (let part = 0; part < partCount;) {
+    main: for (let part = 0; part < partCount;) {
         for (let i = 0; i < pool.size; ++i) {
             const api = pool.api();
             for (let i = 0; i < __classPrivateFieldGet(_a, _a, "f", _FileManager_UPLOAD_REQUEST_PER_CONNECTION); ++i) {
                 const start = part * chunkSize;
                 const end = start + chunkSize;
                 const bytes = buffer.subarray(start, end);
-                (0, _0_deps_js_1.assert)(bytes.length != 0);
+                if (!bytes.length) {
+                    break main;
+                }
                 const thisPart = part++; // `thisPart` must be used instead of `part` in the promise body
                 promises.push(Promise.resolve().then(async () => {
                     while (true) {

package/script/client/{1_network_statistics_manager.d.ts → 2_network_statistics_manager.d.ts}

@@ -17,7 +17,7 @@
  * 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 { C } from "./0_types.js";
+import { C } from "./1_types.js";
 export declare class NetworkStatisticsManager {
     #private;
     constructor(c: C);

package/{esm/client/1_reaction_manager.d.ts → script/client/2_reaction_manager.d.ts}

@@ -19,7 +19,7 @@
  */
 import { enums, types } from "../2_tl.js";
 import { Update } from "../3_types.js";
-import { C } from "./0_types.js";
+import { C } from "./1_types.js";
 type ReactionManagerUpdate = types.UpdateBotMessageReactions | types.UpdateBotMessageReaction | types.UpdateMessageReactions | types.UpdateChannelMessageViews | types.UpdateChannelMessageForwards;
 export declare class ReactionManager {
     #private;

package/{esm/client/1_update_manager.d.ts → script/client/2_update_manager.d.ts}

@@ -19,7 +19,7 @@
  */
 import { Queue } from "../1_utilities.js";
 import { enums, ReadObject, TLObject, types } from "../2_tl.js";
-import { C } from "./0_types.js";
+import { C } from "./1_types.js";
 type UpdateHandler = (update: enums.Update) => Promise<(() => Promise<unknown>)>;
 export type PtsUpdate = types.UpdateNewMessage | types.UpdateDeleteMessages | types.UpdateReadHistoryInbox | types.UpdateReadHistoryOutbox | types.UpdatePinnedChannelMessages | types.UpdatePinnedMessages | types.UpdateFolderPeers | types.UpdateChannelWebPage | types.UpdateEditMessage | types.UpdateReadMessagesContents | types.UpdateWebPage;
 export type ChannelPtsUpdate = types.UpdateNewChannelMessage | types.UpdateEditChannelMessage | types.UpdateDeleteChannelMessages | types.UpdateChannelTooLong;

package/{esm/client/2_message_manager.d.ts → script/client/3_message_manager.d.ts}

@@ -21,8 +21,8 @@ import { enums, types } from "../2_tl.js";
 import { InputMedia } from "../3_types.js";
 import { ChatAction, ChatMember, FileSource, FileType, ID, Message, MessageEntity, ParseMode, Reaction, Update, UsernameResolver } from "../3_types.js";
 import { AddReactionParams, BanChatMemberParams, CreateInviteLinkParams, DeleteMessagesParams, EditMessageLiveLocationParams, EditMessageMediaParams, EditMessageParams, EditMessageReplyMarkupParams, ForwardMessagesParams, GetCreatedInviteLinksParams, GetHistoryParams, PinMessageParams, SearchMessagesParams, SendAnimationParams, SendAudioParams, SendChatActionParams, SendContactParams, SendDiceParams, SendDocumentParams, SendLocationParams, SendMessageParams, SendPhotoParams, SendPollParams, SendStickerParams, SendVenueParams, SendVideoNoteParams, SendVideoParams, SendVoiceParams, SetChatMemberRightsParams, SetChatPhotoParams, SetReactionsParams, StopPollParams } from "./0_params.js";
-import { C as C_ } from "./0_types.js";
-import { FileManager } from "./1_file_manager.js";
+import { C as C_ } from "./1_types.js";
+import { FileManager } from "./2_file_manager.js";
 interface C extends C_ {
     fileManager: FileManager;
 }

package/script/client/{2_video_chat_manager.d.ts → 3_video_chat_manager.d.ts}

@@ -20,8 +20,8 @@
 import { enums, types } from "../2_tl.js";
 import { ID, Update, VideoChatActive, VideoChatScheduled } from "../3_types.js";
 import { DownloadLiveStreamChunkParams, JoinVideoChatParams, StartVideoChatParams } from "./0_params.js";
-import { C as C_ } from "./0_types.js";
-import { FileManager } from "./1_file_manager.js";
+import { C as C_ } from "./1_types.js";
+import { FileManager } from "./2_file_manager.js";
 interface C extends C_ {
     fileManager: FileManager;
 }

package/{esm/client/3_callback_query_manager.d.ts → script/client/4_callback_query_manager.d.ts}

@@ -20,8 +20,8 @@
 import { enums, types } from "../2_tl.js";
 import { CallbackQueryQuestion, ID, Update } from "../3_types.js";
 import { AnswerCallbackQueryParams } from "./0_params.js";
-import { C as C_ } from "./0_types.js";
-import { MessageManager } from "./2_message_manager.js";
+import { C as C_ } from "./1_types.js";
+import { MessageManager } from "./3_message_manager.js";
 type C = C_ & {
     messageManager: MessageManager;
 };

package/{esm/client/3_chat_list_manager.d.ts → script/client/4_chat_list_manager.d.ts}

@@ -19,9 +19,9 @@
  */
 import { enums, types } from "../2_tl.js";
 import { ChatListItem, ID } from "../3_types.js";
-import { C as C_ } from "./0_types.js";
-import { FileManager } from "./1_file_manager.js";
-import { MessageManager } from "./2_message_manager.js";
+import { C as C_ } from "./1_types.js";
+import { FileManager } from "./2_file_manager.js";
+import { MessageManager } from "./3_message_manager.js";
 type C = C_ & {
     fileManager: FileManager;
     messageManager: MessageManager;

package/{esm/client/3_inline_query_manager.d.ts → script/client/4_inline_query_manager.d.ts}

@@ -20,8 +20,8 @@
 import { enums, types } from "../2_tl.js";
 import { ID, InlineQueryResult, Update } from "../3_types.js";
 import { AnswerInlineQueryParams, SendInlineQueryParams } from "./0_params.js";
-import { C as C_ } from "./0_types.js";
-import { MessageManager } from "./2_message_manager.js";
+import { C as C_ } from "./1_types.js";
+import { MessageManager } from "./3_message_manager.js";
 type C = C_ & {
     messageManager: MessageManager;
 };

package/script/client/{3_story_manager.d.ts → 4_story_manager.d.ts}

@@ -21,9 +21,9 @@ import { enums, types } from "../2_tl.js";
 import { ID, Story, Update } from "../3_types.js";
 import { InputStoryContent } from "../types/1_input_story_content.js";
 import { CreateStoryParams } from "./0_params.js";
-import { C as C_ } from "./0_types.js";
-import { FileManager } from "./1_file_manager.js";
-import { MessageManager } from "./2_message_manager.js";
+import { C as C_ } from "./1_types.js";
+import { FileManager } from "./2_file_manager.js";
+import { MessageManager } from "./3_message_manager.js";
 type C = C_ & {
     fileManager: FileManager;
     messageManager: MessageManager;

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

@@ -19,18 +19,19 @@
  */
 import { MaybePromise } from "../1_utilities.js";
 import { enums, functions, types } from "../2_tl.js";
-import { Storage } from "../3_storage.js";
+import { Storage } from "../2_storage.js";
 import { DC } from "../3_transport.js";
 import { BotCommand, BusinessConnection, CallbackQueryAnswer, CallbackQueryQuestion, Chat, ChatAction, ChatListItem, ChatMember, ChatP, FileSource, ID, InactiveChat, InlineQueryAnswer, InlineQueryResult, InputMedia, InputStoryContent, InviteLink, LiveStreamChannel, Message, MessageAnimation, MessageAudio, MessageContact, MessageDice, MessageDocument, MessageLocation, MessagePhoto, MessagePoll, MessageSticker, MessageText, MessageVenue, MessageVideo, MessageVideoNote, MessageVoice, NetworkStatistics, ParseMode, Poll, Reaction, Sticker, Story, Update, User, VideoChat, VideoChatActive, VideoChatScheduled } from "../3_types.js";
 import { Migrate } from "../4_errors.js";
-import { AddReactionParams, AnswerCallbackQueryParams, AnswerInlineQueryParams, AuthorizeUserParams, BanChatMemberParams, CreateInviteLinkParams, CreateStoryParams, DeleteMessageParams, DeleteMessagesParams, DownloadLiveStreamChunkParams, DownloadParams, EditMessageLiveLocationParams, EditMessageMediaParams, EditMessageParams, EditMessageReplyMarkupParams, ForwardMessagesParams, GetChatsParams, GetCreatedInviteLinksParams, GetHistoryParams, GetMyCommandsParams, JoinVideoChatParams, PinMessageParams, ReplyParams, ScheduleVideoChatParams, SearchMessagesParams, SendAnimationParams, SendAudioParams, SendContactParams, SendDiceParams, SendDocumentParams, SendInlineQueryParams, SendLocationParams, SendMessageParams, SendPhotoParams, SendPollParams, SendStickerParams, SendVenueParams, SendVideoNoteParams, SendVideoParams, SendVoiceParams, SetChatMemberRightsParams, SetChatPhotoParams, SetMyCommandsParams, SetReactionsParams, StartVideoChatParams, StopPollParams } from "./0_params.js";
-import { Api } from "./0_types.js";
+import { AddReactionParams, AnswerCallbackQueryParams, AnswerInlineQueryParams, BanChatMemberParams, CreateInviteLinkParams, CreateStoryParams, DeleteMessageParams, DeleteMessagesParams, DownloadLiveStreamChunkParams, DownloadParams, EditMessageLiveLocationParams, EditMessageMediaParams, EditMessageParams, EditMessageReplyMarkupParams, ForwardMessagesParams, GetChatsParams, GetCreatedInviteLinksParams, GetHistoryParams, GetMyCommandsParams, JoinVideoChatParams, PinMessageParams, ReplyParams, ScheduleVideoChatParams, SearchMessagesParams, SendAnimationParams, SendAudioParams, SendContactParams, SendDiceParams, SendDocumentParams, SendInlineQueryParams, SendLocationParams, SendMessageParams, SendPhotoParams, SendPollParams, SendStickerParams, SendVenueParams, SendVideoNoteParams, SendVideoParams, SendVoiceParams, SetChatMemberRightsParams, SetChatPhotoParams, SetMyCommandsParams, SetReactionsParams, SignInParams, StartVideoChatParams, StopPollParams } from "./0_params.js";
+import { Api } from "./1_types.js";
 import { ClientPlainParams } from "./1_client_plain.js";
 import { Composer as Composer_, NextFunction } from "./1_composer.js";
+import { StorageOperations } from "./0_storage_operations.js";
 export interface Context {
     /** The client that received the update. */
     client: Client;
-    /** The currently authorized user. */
+    /** The currently signed in user. */
     me?: User;
     /** Resolves to `message`, `editedMessage`, or the `message` field of `callbackQuery`. */
     msg?: Message;
@@ -184,19 +185,25 @@ export declare const restartAuth: unique symbol;
 export declare const handleMigrationError: unique symbol;
 declare const getEntity: unique symbol;
 export interface ClientParams extends ClientPlainParams {
+    /** The storage provider to use. Defaults to memory storage. Passing a string constructs a memory storage with the string being the auth string. */
+    storage?: Storage;
+    /** App's API ID from [my.telegram.org/apps](https://my.telegram.org/apps). Required if no account was previously authorized. */
+    apiId?: number;
+    /** App's API hash from [my.telegram.org/apps](https://my.telegram.org/apps). Required if no account was previously authorized. */
+    apiHash?: string;
     /** A parse mode to use when the `parseMode` parameter is not specified when sending or editing messages. Defaults to `ParseMode.None`. */
     parseMode?: ParseMode;
-    /** The app_version parameter to be passed to initConnection when calling `authorize`. It is recommended that this parameter is changed if users are authorized. Defaults to _MTKruto_. */
+    /** The app_version parameter to be passed to initConnection. It is recommended that this parameter is changed if users are authorized. Defaults to _MTKruto_. */
     appVersion?: string;
-    /** The device_version parameter to be passed to initConnection when calling `authorize`. The default varies by the current runtime. */
+    /** The device_version parameter to be passed to initConnection. The default varies by the current runtime. */
     deviceModel?: string;
-    /** The lang_code parameter to be passed to initConnection when calling `authorize`. Defaults to the runtime's language or `"en"`. */
+    /** The lang_code parameter to be passed to initConnection. Defaults to the runtime's language or `"en"`. */
     langCode?: string;
-    /** The lang_pack parameter to be passed to initConnection when calling `authorize`. Defaults to an empty string. */
+    /** The lang_pack parameter to be passed to initConnection. Defaults to an empty string. */
     langPack?: string;
-    /** The system_lang_cde parameter to be passed to initConnection when calling `authorize`. Defaults to the runtime's language or `"en"`. */
+    /** The system_lang_cde parameter to be passed to initConnection. Defaults to the runtime's language or `"en"`. */
     systemLangCode?: string;
-    /** The system_version parameter to be passed to initConnection when calling `authorize`. The default varies by the current runtime. */
+    /** The system_version parameter to be passed to initConnection. The default varies by the current runtime. */
     systemVersion?: string;
     /** Whether to use default handlers. Defaults to `true`. */
     defaultHandlers?: boolean;
@@ -208,18 +215,26 @@ export interface ClientParams extends ClientPlainParams {
     guaranteeUpdateDelivery?: boolean;
     /** Whether to not handle updates received when the client was not running. Defaults to `true` for bots, and `false` for users. */
     dropPendingUpdates?: boolean;
-    /** Whether to store messages. Defaults to `false`. */
-    storeMessages?: boolean;
+    /**
+     * Whether to persist cache to the provided storage, and not memory. Defaults to `false`.
+     *
+     * Explicitly setting this option to `true` is highly recommended if:
+     *
+     * - User accounts are authorized.
+     * - Less memory usage is demanded.
+     * - The client does not usually have a large uptime.
+     *
+     * When the provided storage takes advantage of memory, nothing changes, even if set to `true`.
+     */
+    persistCache?: boolean;
 }
 /**
  * An MTKruto client.
  */
 export declare class Client<C extends Context = Context> extends Composer<C> {
     #private;
-    readonly apiId: number | null;
-    readonly apiHash: string | null;
-    readonly storage: Storage;
-    readonly messageStorage: Storage;
+    readonly storage: StorageOperations;
+    readonly messageStorage: StorageOperations;
     readonly appVersion: string;
     readonly deviceModel: string;
     readonly langCode: string;
@@ -233,7 +248,7 @@ export declare class Client<C extends Context = Context> extends Composer<C> {
      * @param apiId App's API ID from [my.telegram.org](https://my.telegram.org/apps). Defaults to 0 (unset).
      * @param apiHash App's API hash from [my.telegram.org/apps](https://my.telegram.org/apps). Defaults to empty string (unset).
      */
-    constructor(storage?: Storage | string | null, apiId?: number | null, apiHash?: string | null, params?: ClientParams);
+    constructor(params?: ClientParams);
     get connected(): boolean;
     get disconnected(): boolean;
     api: Api;
@@ -254,24 +269,19 @@ export declare class Client<C extends Context = Context> extends Composer<C> {
     [handleMigrationError](err: Migrate): Promise<void>;
     disconnect(): Promise<void>;
     /**
-     * Authorizes the client with one of the following:
-     *
-     * - Bot token (`string`)
-     * - User authorization handlers (`AuthorizeUserParams`)
-     *
-     * if the current auth key doesn't throw AUTH_KEY_UNREGISTERED when calling [updates.getState](1).
+     * Signs in using the provided parameters if not already signed in.
+     * If no parameters are provided, the credentials will be prompted in runtime.
      *
      * Notes:
      * 1. Requires the `apiId` and `apiHash` paramters to be passed when constructing the client.
-     * 2. Reconnects the client to the appropriate DC in case of MIGRATE_X errors.
-     *
-     * [1]: https://core.telegram.org/method/updates.getState
+     * 3. Reconnects the client to the appropriate DC in case of MIGRATE_X errors.
      */
-    authorize(params?: string | AuthorizeUserParams): Promise<void>;
+    signIn(params?: SignInParams): Promise<void>;
+    signOut(): Promise<void>;
     /**
-     * Same as calling `.connect()` followed by `.authorize(params)`.
+     * Same as calling `.connect()` followed by `.signIn(params)`.
      */
-    start(params?: string | AuthorizeUserParams): Promise<void>;
+    start(params?: SignInParams): Promise<void>;
     /**
      * Invokes a function waiting and returning its reply if the second parameter is not `true`. Requires the client
      * to be connected.