@mtkruto/node 0.1.102 → 0.1.103

package/esm/4_constants.d.ts

@@ -5,7 +5,7 @@ export declare const PUBLIC_KEYS: PublicKeys;
 export declare const VECTOR_CONSTRUCTOR = 481674261;
 export declare const INITIAL_DC: DC;
 export declare const LAYER = 161;
-export declare const APP_VERSION = "MTKruto 0.1.102";
+export declare const APP_VERSION = "MTKruto 0.1.103";
 export declare const DEVICE_MODEL: string;
 export declare const LANG_CODE: string;
 export declare const LANG_PACK = "";

package/esm/4_constants.js

@@ -54,7 +54,7 @@ export const PUBLIC_KEYS = Object.freeze([
 export const VECTOR_CONSTRUCTOR = 0x1CB5C415;
 export const INITIAL_DC = "2-test";
 export const LAYER = 161;
-export const APP_VERSION = "MTKruto 0.1.102";
+export const APP_VERSION = "MTKruto 0.1.103";
 // @ts-ignore: lib
 export const DEVICE_MODEL = typeof dntShim.Deno === "undefined" ? typeof navigator === "undefined" ? typeof process === "undefined" ? "Unknown" : process.platform + "-" + process.arch : navigator.userAgent.split(" ")[0] : dntShim.Deno.build.os + "-" + dntShim.Deno.build.arch;
 export const LANG_CODE = typeof navigator === "undefined" ? "en" : navigator.language.split("-")[0];

package/esm/client/3_types.d.ts

@@ -1,6 +1,6 @@
 import { MaybePromise } from "../1_utilities.js";
 import { functions, types } from "../2_tl.js";
-import { CallbackQuery, ChatID, ForceReply, InlineKeyboardMarkup, InlineQuery, Message, MessageEntity, ReplyKeyboardMarkup, ReplyKeyboardRemove } from "../3_types.js";
+import { BotCommandScope, CallbackQuery, ChatID, ForceReply, InlineKeyboardMarkup, InlineQuery, InlineQueryResultButton, Message, MessageEntity, ReplyKeyboardMarkup, ReplyKeyboardRemove } from "../3_types.js";
 import { With } from "./0_utilities.js";
 import { ClientPlainParams } from "./2_client_plain.js";
 export type ParseMode = "HTML" | null;
@@ -194,6 +194,30 @@ export interface SendPollParams {
      */
     protectContent?: boolean;
 }
+export interface DownloadParams {
+    /** Size of each download chunk in bytes. */
+    chunkSize?: number;
+}
+export interface UploadParams {
+    /** The file name to assign. */
+    fileName?: string;
+    /** Size of each upload chunk in bytes. */
+    chunkSize?: number;
+    /** Upload abort signal. */
+    signal?: AbortSignal | null;
+}
+export interface AnswerInlineQueryParams {
+    cacheTime?: number;
+    isPersonal?: boolean;
+    nextOffset?: string;
+    isGallery?: boolean;
+    button?: InlineQueryResultButton;
+}
+export interface SetMyCommandsParams {
+    languageCode?: string;
+    scope?: BotCommandScope;
+}
+export type GetMyCommandsParams = SetMyCommandsParams;
 export type ConnectionState = "notConnected" | "updating" | "ready";
 export type AuthorizationState = {
     authorized: boolean;

package/esm/client/4_client.d.ts

@@ -2,11 +2,11 @@ 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, BotCommandScope, ChatAction, ChatID, InlineQueryResult, InlineQueryResultButton, Message } from "../3_types.js";
+import { BotCommand, ChatAction, ChatID, InlineQueryResult, Message } from "../3_types.js";
 import { Migrate } from "../4_errors.js";
 import { With } from "./0_utilities.js";
 import { ClientAbstract } from "./1_client_abstract.js";
-import { AnswerCallbackQueryParams, AuthorizeUserParams, ClientParams, EditMessageParams, FilterableUpdates, FilterUpdate, ForwardMessagesParams, Handler, ParseMode, SendMessagesParams, SendPollParams, Update } from "./3_types.js";
+import { AnswerCallbackQueryParams, AnswerInlineQueryParams, AuthorizeUserParams, ClientParams, DownloadParams, EditMessageParams, FilterableUpdates, FilterUpdate, ForwardMessagesParams, GetMyCommandsParams, Handler, ParseMode, SendMessagesParams, SendPollParams, SetMyCommandsParams, Update, UploadParams } from "./3_types.js";
 export declare const getEntity: unique symbol;
 export declare const getStickerSetName: unique symbol;
 export declare const handleMigrationError: unique symbol;
@@ -168,9 +168,7 @@ export declare class Client extends ClientAbstract {
      *
      * @param fileId The identifier of the file to download.
      */
-    download(fileId: string, params?: {
-        chunkSize?: number;
-    }): Promise<AsyncGenerator<Uint8Array, void, unknown>>;
+    download(fileId: string, params?: DownloadParams): Promise<AsyncGenerator<Uint8Array, void, unknown>>;
     [getStickerSetName](inputStickerSet: types.InputStickerSetID, hash?: number): Promise<string>;
     /**
      * Forward multiple messages.
@@ -223,49 +221,47 @@ export declare class Client extends ClientAbstract {
      *
      * @param contents The contents of the file.
      */
-    upload(contents: Uint8Array, params?: {
-        fileName?: string;
-        chunkSize?: number;
-        signal?: AbortSignal | null;
-    }): Promise<types.InputFile | types.InputFileBig>;
-    setMyCommands(commands: BotCommand[], params?: {
-        languageCode?: string;
-        scope?: BotCommandScope;
-    }): Promise<void>;
-    getMyCommands(params?: {
-        languageCode?: string;
-        scope?: BotCommandScope;
-    }): Promise<BotCommand[]>;
-    answerInlineQuery(id: string, results: InlineQueryResult[], params?: {
-        cacheTime?: number;
-        isPersonal?: boolean;
-        nextOffset?: string;
-        isGallery?: boolean;
-        button: InlineQueryResultButton;
-    }): Promise<void>;
+    upload(contents: Uint8Array, params?: UploadParams): Promise<types.InputFile | types.InputFileBig>;
+    /**
+     * Set the bot's commands in the given scope and/or language. Bot-only.
+     *
+     * @param commands The commands to set.
+     */
+    setMyCommands(commands: BotCommand[], params?: SetMyCommandsParams): Promise<void>;
+    /**
+     * Get the bot's commands in the given scope and/or language. Bot-only.
+     */
+    getMyCommands(params?: GetMyCommandsParams): Promise<BotCommand[]>;
+    /**
+     * Answer an inline query. Bot-only.
+     *
+     * @param id The ID of the inline query to answer.
+     * @param results The results to answer with.
+     */
+    answerInlineQuery(id: string, results: InlineQueryResult[], params?: AnswerInlineQueryParams): Promise<void>;
     private handle;
     use(handler: Handler): void;
     branch(predicate: (upd: Update) => MaybePromise<boolean>, trueHandler: Handler, falseHandler: Handler): void;
     filter<D extends Update>(predicate: (update: Update) => update is D, handler: Handler<D>): void;
     filter(predicate: (update: Update) => MaybePromise<boolean>, handler: Handler): void;
     on<T extends keyof Update, F extends keyof NonNullable<Update[T]>>(filter: T extends FilterableUpdates ? T | [T, F, ...F[]] : T, handler: Handler<FilterUpdate<Update, T, F>>): void;
-    setMyInfo(info: Omit<ConstructorParameters<typeof functions["BotsSetBotInfo"]>[0], "bot">): Promise<void>;
+    private setMyInfo;
     /**
-     * Use this method to change the bot's description, which is shown in the chat with the bot if the chat is empty.
+     * Set the bot's description in the given language. Bot-only.
      */
     setMyDescription({ description, languageCode }: {
         description?: string;
         languageCode?: string;
     }): Promise<void>;
     /**
-     * Use this method to change the bot's name.
+     * Set the bot's name in the given language. Bot-only.
      */
     setMyName({ name, languageCode }: {
         name?: string;
         languageCode?: string;
     }): Promise<void>;
     /**
-     * Use this method to change the bot's short description, which is shown on the bot's profile page and is sent together with the link when users share the bot.
+     * Set the bot's short description in the given language. Bot-only.
      */
     setMyShortDescription({ shortDescription: about, languageCode }: {
         shortDescription?: string;
@@ -273,15 +269,15 @@ export declare class Client extends ClientAbstract {
     }): Promise<void>;
     private getMyInfo;
     /**
-     * Use this method to get the current bot description for the given user language.
+     * Get the bot's description in the given language. Bot-only.
      */
     getMyDescription(languageCode?: string): Promise<string>;
     /**
-     * Use this method to get the current bot name for the given user language.
+     * Set the bot's name in the given language. Bot-only.
      */
     getMyName(languageCode?: string): Promise<string>;
     /**
-     * Use this method to get the current bot short description for the given user language.
+     * Get the bot's short description in the given language. Bot-only.
      */
     getMyShortDescription(languageCode?: string): Promise<string>;
 }

package/esm/client/4_client.js

@@ -986,8 +986,7 @@ export class Client extends ClientAbstract {
                     }
                 }
                 else if (difference instanceof types.UpdatesDifferenceTooLong) {
-                    // TODO: we actually do now
-                    // stored messages should be invalidated in case we store messages in the future
+                    await this.storage.deleteMessages();
                     state.pts = difference.pts;
                     dGap("received differenceTooLong");
                 }
@@ -1747,6 +1746,11 @@ export class Client extends ClientAbstract {
             return new types.InputFile({ id: fileId, name, parts: part, md5Checksum: "" });
         }
     }
+    /**
+     * Set the bot's commands in the given scope and/or language. Bot-only.
+     *
+     * @param commands The commands to set.
+     */
     async setMyCommands(commands, params) {
         await this.invoke(new functions.BotsSetBotCommands({
             commands: commands.map((v) => new types.BotCommand(v)),
@@ -1754,6 +1758,9 @@ export class Client extends ClientAbstract {
             scope: await botCommandScopeToTlObject(params?.scope ?? { type: "default" }, this.getInputPeer.bind(this)),
         }));
     }
+    /**
+     * Get the bot's commands in the given scope and/or language. Bot-only.
+     */
     async getMyCommands(params) {
         const commands_ = await this.invoke(new functions.BotsGetBotCommands({
             langCode: params?.languageCode ?? "",
@@ -1761,6 +1768,12 @@ export class Client extends ClientAbstract {
         }));
         return commands_.map((v) => ({ command: v.command, description: v.description }));
     }
+    /**
+     * Answer an inline query. Bot-only.
+     *
+     * @param id The ID of the inline query to answer.
+     * @param results The results to answer with.
+     */
     async answerInlineQuery(id, results, params) {
         await this.invoke(new functions.MessagesSetInlineBotResults({
             queryId: BigInt(id),
@@ -1823,21 +1836,21 @@ export class Client extends ClientAbstract {
         await this.invoke(new functions.BotsSetBotInfo({ bot: new types.InputUserSelf(), ...info }));
     }
     /**
-     * Use this method to change the bot's description, which is shown in the chat with the bot if the chat is empty.
+     * Set the bot's description in the given language. Bot-only.
      */
     async setMyDescription({ description, languageCode }) {
         await this.assertBot("setMyDescription");
         await this.setMyInfo({ description, langCode: languageCode ?? "" });
     }
     /**
-     * Use this method to change the bot's name.
+     * Set the bot's name in the given language. Bot-only.
      */
     async setMyName({ name, languageCode }) {
         await this.assertBot("setMyName");
         await this.setMyInfo({ name, langCode: languageCode ?? "" });
     }
     /**
-     * Use this method to change the bot's short description, which is shown on the bot's profile page and is sent together with the link when users share the bot.
+     * Set the bot's short description in the given language. Bot-only.
      */
     async setMyShortDescription({ shortDescription: about, languageCode }) {
         await this.assertBot("setMyShortDescription");
@@ -1847,21 +1860,21 @@ export class Client extends ClientAbstract {
         return this.invoke(new functions.BotsGetBotInfo({ bot: new types.InputUserSelf(), langCode: languageCode ?? "" }));
     }
     /**
-     * Use this method to get the current bot description for the given user language.
+     * Get the bot's description in the given language. Bot-only.
      */
     async getMyDescription(languageCode) {
         await this.assertBot("getMyDescription");
         return await this.getMyInfo(languageCode).then((v) => v.description);
     }
     /**
-     * Use this method to get the current bot name for the given user language.
+     * Set the bot's name in the given language. Bot-only.
      */
     async getMyName(languageCode) {
         await this.assertBot("getMyName");
         return await this.getMyInfo(languageCode).then((v) => v.description);
     }
     /**
-     * Use this method to get the current bot short description for the given user language.
+     * Get the bot's short description in the given language. Bot-only.
      */
     async getMyShortDescription(languageCode) {
         await this.assertBot("getMyShortDescription");

package/esm/storage/0_storage.d.ts

@@ -1,12 +1,13 @@
 import { MaybePromise } from "../1_utilities.js";
 import { TLObject, types } from "../2_tl.js";
 import { DC } from "../3_transport.js";
-export type StorageKeyPart = string | number | bigint | Uint8Array;
+export type StorageKeyPart = string | number | bigint;
 export declare abstract class Storage {
     private _authKeyId;
     abstract init(): MaybePromise<void>;
     abstract set(key: readonly StorageKeyPart[], value: unknown): MaybePromise<void>;
     abstract get<T>(key: readonly StorageKeyPart[]): MaybePromise<T | null>;
+    abstract getMany<T>(prefix: readonly StorageKeyPart[]): MaybePromise<Generator<[readonly StorageKeyPart[], T]> | AsyncGenerator<[readonly StorageKeyPart[], T]>>;
     setDc(dc: DC | null): MaybePromise<void>;
     getDc(): MaybePromise<DC | null>;
     private resetAuthKeyId;
@@ -24,6 +25,7 @@ export declare abstract class Storage {
     setState(state: types.UpdatesState): Promise<void>;
     getState(): Promise<types.UpdatesState | null>;
     setMessage(chatId: number, messageId: number, message: types.TypeMessage | null): Promise<void>;
+    deleteMessages(): Promise<void>;
     getMessageChat(messageId: number): MaybePromise<number | null>;
     getMessage(chatId: number, messageId: number): Promise<types.TypeMessage | null>;
     setChannelPts(channelId: bigint, pts: number): Promise<void>;

package/esm/storage/0_storage.js

@@ -104,6 +104,13 @@ export class Storage {
         }
         await this.setTlObject(KPARTS_MESSAGE(chatId, messageId), message);
     }
+    async deleteMessages() {
+        const maybePromises = new Array();
+        for await (const [k, o] of await this.getMany(["messageRefs"])) {
+            maybePromises.push(Promise.all([this.set(k, null), o == null ? Promise.resolve() : this.set(KPARTS_MESSAGE(o, k[1]), null)]).then(() => { }));
+        }
+        await Promise.all(maybePromises.filter((v) => v instanceof Promise));
+    }
     getMessageChat(messageId) {
         return this.get(KPARTS_MESSAGE_REF(messageId));
     }

package/esm/storage/0_utilities.d.ts

@@ -10,4 +10,5 @@ export declare enum ValueType {
 }
 export declare function toString(value: unknown): string;
 export declare function fromString<T>(string: string): any;
-export declare function fixKey(key: StorageKeyPart[]): (string | number | Uint8Array)[];
+export declare function fixKey(key: readonly StorageKeyPart[]): (string | number)[];
+export declare function getPrefixKeyRange(prefix: any): IDBKeyRange;

package/esm/storage/0_utilities.js

@@ -60,3 +60,66 @@ export function fromString(string) {
 export function fixKey(key) {
     return key.map((v) => typeof v === "bigint" ? String(v) : v);
 }
+// Source: https://gist.github.com/inexorabletash/5462871
+// deno-lint-ignore no-explicit-any
+export function getPrefixKeyRange(prefix) {
+    // Ensure prefix is a valid key itself:
+    if (indexedDB.cmp(prefix, prefix) !== 0)
+        throw new TypeError();
+    const upperKey = successor(prefix);
+    if (upperKey === undefined)
+        return IDBKeyRange.lowerBound(prefix);
+    return IDBKeyRange.bound(prefix, upperKey, false, true);
+}
+const MAX_DATE_VALUE = 8640000000000000;
+const UPPER_BOUND = {
+    NUMBER: new Date(-MAX_DATE_VALUE),
+    DATE: "",
+    STRING: [],
+    ARRAY: undefined,
+};
+// deno-lint-ignore no-explicit-any
+function successor(key) {
+    if (typeof key === "number") {
+        if (key === Infinity)
+            return UPPER_BOUND.NUMBER;
+        if (key === -Infinity)
+            return -Number.MAX_VALUE;
+        if (key === 0)
+            return Number.MIN_VALUE;
+        let epsilon = Math.abs(key);
+        while (key + epsilon / 2 !== key)
+            epsilon = epsilon / 2;
+        return key + epsilon;
+    }
+    if (key instanceof Date) {
+        if (key.valueOf() + 1 > MAX_DATE_VALUE)
+            return UPPER_BOUND.DATE;
+        return new Date(key.valueOf() + 1);
+    }
+    if (typeof key === "string") {
+        let len = key.length;
+        while (len > 0) {
+            const head = key.substring(0, len - 1), tail = key.charCodeAt(len - 1);
+            if (tail !== 0xffff)
+                return head + String.fromCharCode(tail + 1);
+            key = head;
+            --len;
+        }
+        return UPPER_BOUND.STRING;
+    }
+    if (Array.isArray(key)) {
+        key = key.slice(); // Operate on a copy.
+        let len = key.length;
+        while (len > 0) {
+            const tail = successor(key.pop());
+            if (tail !== undefined) {
+                key.push(tail);
+                return key;
+            }
+            --len;
+        }
+        return UPPER_BOUND.ARRAY;
+    }
+    throw new TypeError();
+}

package/esm/storage/1_storage_indexed_db.d.ts

@@ -5,5 +5,6 @@ export declare class StorageIndexedDB extends Storage {
     constructor(name: string);
     init(): Promise<void>;
     set(k: StorageKeyPart[], v: unknown): Promise<void>;
-    get<T>(k: StorageKeyPart[]): Promise<T | null>;
+    get<T>(k: readonly StorageKeyPart[]): Promise<T | null>;
+    getMany<T>(prefix: readonly StorageKeyPart[]): AsyncGenerator<[readonly StorageKeyPart[], T], void, unknown>;
 }

package/esm/storage/1_storage_indexed_db.js

@@ -1,5 +1,5 @@
 import { Storage } from "./0_storage.js";
-import { fixKey } from "./0_utilities.js";
+import { fixKey, getPrefixKeyRange } from "./0_utilities.js";
 const VERSION = 1;
 const KV_OBJECT_STORE = "kv";
 export class StorageIndexedDB extends Storage {
@@ -72,4 +72,21 @@ export class StorageIndexedDB extends Storage {
             };
         });
     }
+    async *getMany(prefix) {
+        if (!this.database) {
+            throw new Error("Not initialized");
+        }
+        const keys = await new Promise((res, rej) => {
+            const tx = this.database.transaction(KV_OBJECT_STORE, "readonly")
+                .objectStore(KV_OBJECT_STORE)
+                .getAllKeys(getPrefixKeyRange(prefix));
+            tx.onerror = rej;
+            tx.onsuccess = () => {
+                res(tx.result);
+            };
+        });
+        for (const key of keys) {
+            yield [key, await this.get(key)];
+        }
+    }
 }

package/esm/storage/1_storage_local_storage.d.ts

@@ -5,5 +5,6 @@ export declare class StorageLocalStorage extends Storage implements Storage {
     constructor(prefix: string);
     init(): void;
     get(key_: readonly StorageKeyPart[]): any;
+    getMany<T>(prefix: readonly StorageKeyPart[]): Generator<[readonly StorageKeyPart[], T], void, unknown>;
     set(key_: readonly StorageKeyPart[], value: unknown): MaybePromise<void>;
 }

package/esm/storage/1_storage_local_storage.js

@@ -31,6 +31,22 @@ export class StorageLocalStorage extends Storage {
             return null;
         }
     }
+    *getMany(prefix) {
+        for (let [key, value] of Object.entries(localStorage)) {
+            if (key.startsWith(this.prefix)) {
+                key = key.slice(this.prefix.length);
+            }
+            const parts = fromString(key);
+            if (Array.isArray(parts)) {
+                for (const [i, p] of prefix.entries()) {
+                    if (toString(p) != toString(parts[i])) {
+                        continue;
+                    }
+                    yield [parts, fromString(value)];
+                }
+            }
+        }
+    }
     set(key_, value) {
         const key = this.prefix + toString(key_);
         if (value != null) {

package/esm/storage/1_storage_memory.d.ts

@@ -4,5 +4,6 @@ export declare class StorageMemory extends Storage implements Storage {
     protected map: Map<string, unknown>;
     init(): void;
     get<T>(key: readonly StorageKeyPart[]): NonNullable<T> | null;
+    getMany<T>(prefix: readonly StorageKeyPart[]): Generator<[readonly StorageKeyPart[], T], void, unknown>;
     set(key_: readonly StorageKeyPart[], value: unknown): MaybePromise<void>;
 }

package/esm/storage/1_storage_memory.js

@@ -1,5 +1,5 @@
 import { Storage } from "./0_storage.js";
-import { toString } from "./0_utilities.js";
+import { fromString, toString } from "./0_utilities.js";
 export class StorageMemory extends Storage {
     constructor() {
         super(...arguments);
@@ -15,6 +15,19 @@ export class StorageMemory extends Storage {
     get(key) {
         return this.map.get(toString(key)) ?? null;
     }
+    *getMany(prefix) {
+        for (const [key, value] of this.map.entries()) {
+            const parts = fromString(key);
+            if (Array.isArray(parts)) {
+                for (const [i, p] of prefix.entries()) {
+                    if (toString(p) != toString(parts[i])) {
+                        continue;
+                    }
+                    yield [parts, value];
+                }
+            }
+        }
+    }
     set(key_, value) {
         const key = toString(key_);
         if (value != null) {

package/esm/storage/1_storage_session_storage.d.ts

@@ -5,5 +5,6 @@ export declare class StorageSessionStorage extends Storage implements Storage {
     constructor(prefix: string);
     init(): void;
     get(key_: readonly StorageKeyPart[]): any;
+    getMany<T>(prefix: readonly StorageKeyPart[]): Generator<[readonly StorageKeyPart[], T], void, unknown>;
     set(key_: readonly StorageKeyPart[], value: unknown): MaybePromise<void>;
 }

package/esm/storage/1_storage_session_storage.js

@@ -31,6 +31,22 @@ export class StorageSessionStorage extends Storage {
             return null;
         }
     }
+    *getMany(prefix) {
+        for (let [key, value] of Object.entries(localStorage)) {
+            if (key.startsWith(this.prefix)) {
+                key = key.slice(this.prefix.length);
+            }
+            const parts = fromString(key);
+            if (Array.isArray(parts)) {
+                for (const [i, p] of prefix.entries()) {
+                    if (toString(p) != toString(parts[i])) {
+                        continue;
+                    }
+                    yield [parts, fromString(value)];
+                }
+            }
+        }
+    }
     set(key_, value) {
         const key = this.prefix + toString(key_);
         if (value != null) {

package/package.json

@@ -2,7 +2,7 @@
   "module": "./esm/mod.js",
   "main": "./script/mod.js",
   "name": "@mtkruto/node",
-  "version": "0.1.102",
+  "version": "0.1.103",
   "description": "MTKruto for Node.js",
   "author": "Roj <rojvv@icloud.com>",
   "license": "LGPL-3.0-or-later",

package/script/4_constants.d.ts

@@ -5,7 +5,7 @@ export declare const PUBLIC_KEYS: PublicKeys;
 export declare const VECTOR_CONSTRUCTOR = 481674261;
 export declare const INITIAL_DC: DC;
 export declare const LAYER = 161;
-export declare const APP_VERSION = "MTKruto 0.1.102";
+export declare const APP_VERSION = "MTKruto 0.1.103";
 export declare const DEVICE_MODEL: string;
 export declare const LANG_CODE: string;
 export declare const LANG_PACK = "";

package/script/4_constants.js

@@ -80,7 +80,7 @@ exports.PUBLIC_KEYS = Object.freeze([
 exports.VECTOR_CONSTRUCTOR = 0x1CB5C415;
 exports.INITIAL_DC = "2-test";
 exports.LAYER = 161;
-exports.APP_VERSION = "MTKruto 0.1.102";
+exports.APP_VERSION = "MTKruto 0.1.103";
 // @ts-ignore: lib
 exports.DEVICE_MODEL = typeof dntShim.Deno === "undefined" ? typeof navigator === "undefined" ? typeof process === "undefined" ? "Unknown" : process.platform + "-" + process.arch : navigator.userAgent.split(" ")[0] : dntShim.Deno.build.os + "-" + dntShim.Deno.build.arch;
 exports.LANG_CODE = typeof navigator === "undefined" ? "en" : navigator.language.split("-")[0];

package/script/client/3_types.d.ts

@@ -1,6 +1,6 @@
 import { MaybePromise } from "../1_utilities.js";
 import { functions, types } from "../2_tl.js";
-import { CallbackQuery, ChatID, ForceReply, InlineKeyboardMarkup, InlineQuery, Message, MessageEntity, ReplyKeyboardMarkup, ReplyKeyboardRemove } from "../3_types.js";
+import { BotCommandScope, CallbackQuery, ChatID, ForceReply, InlineKeyboardMarkup, InlineQuery, InlineQueryResultButton, Message, MessageEntity, ReplyKeyboardMarkup, ReplyKeyboardRemove } from "../3_types.js";
 import { With } from "./0_utilities.js";
 import { ClientPlainParams } from "./2_client_plain.js";
 export type ParseMode = "HTML" | null;
@@ -194,6 +194,30 @@ export interface SendPollParams {
      */
     protectContent?: boolean;
 }
+export interface DownloadParams {
+    /** Size of each download chunk in bytes. */
+    chunkSize?: number;
+}
+export interface UploadParams {
+    /** The file name to assign. */
+    fileName?: string;
+    /** Size of each upload chunk in bytes. */
+    chunkSize?: number;
+    /** Upload abort signal. */
+    signal?: AbortSignal | null;
+}
+export interface AnswerInlineQueryParams {
+    cacheTime?: number;
+    isPersonal?: boolean;
+    nextOffset?: string;
+    isGallery?: boolean;
+    button?: InlineQueryResultButton;
+}
+export interface SetMyCommandsParams {
+    languageCode?: string;
+    scope?: BotCommandScope;
+}
+export type GetMyCommandsParams = SetMyCommandsParams;
 export type ConnectionState = "notConnected" | "updating" | "ready";
 export type AuthorizationState = {
     authorized: boolean;

package/script/client/4_client.d.ts

@@ -2,11 +2,11 @@ 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, BotCommandScope, ChatAction, ChatID, InlineQueryResult, InlineQueryResultButton, Message } from "../3_types.js";
+import { BotCommand, ChatAction, ChatID, InlineQueryResult, Message } from "../3_types.js";
 import { Migrate } from "../4_errors.js";
 import { With } from "./0_utilities.js";
 import { ClientAbstract } from "./1_client_abstract.js";
-import { AnswerCallbackQueryParams, AuthorizeUserParams, ClientParams, EditMessageParams, FilterableUpdates, FilterUpdate, ForwardMessagesParams, Handler, ParseMode, SendMessagesParams, SendPollParams, Update } from "./3_types.js";
+import { AnswerCallbackQueryParams, AnswerInlineQueryParams, AuthorizeUserParams, ClientParams, DownloadParams, EditMessageParams, FilterableUpdates, FilterUpdate, ForwardMessagesParams, GetMyCommandsParams, Handler, ParseMode, SendMessagesParams, SendPollParams, SetMyCommandsParams, Update, UploadParams } from "./3_types.js";
 export declare const getEntity: unique symbol;
 export declare const getStickerSetName: unique symbol;
 export declare const handleMigrationError: unique symbol;
@@ -168,9 +168,7 @@ export declare class Client extends ClientAbstract {
      *
      * @param fileId The identifier of the file to download.
      */
-    download(fileId: string, params?: {
-        chunkSize?: number;
-    }): Promise<AsyncGenerator<Uint8Array, void, unknown>>;
+    download(fileId: string, params?: DownloadParams): Promise<AsyncGenerator<Uint8Array, void, unknown>>;
     [getStickerSetName](inputStickerSet: types.InputStickerSetID, hash?: number): Promise<string>;
     /**
      * Forward multiple messages.
@@ -223,49 +221,47 @@ export declare class Client extends ClientAbstract {
      *
      * @param contents The contents of the file.
      */
-    upload(contents: Uint8Array, params?: {
-        fileName?: string;
-        chunkSize?: number;
-        signal?: AbortSignal | null;
-    }): Promise<types.InputFile | types.InputFileBig>;
-    setMyCommands(commands: BotCommand[], params?: {
-        languageCode?: string;
-        scope?: BotCommandScope;
-    }): Promise<void>;
-    getMyCommands(params?: {
-        languageCode?: string;
-        scope?: BotCommandScope;
-    }): Promise<BotCommand[]>;
-    answerInlineQuery(id: string, results: InlineQueryResult[], params?: {
-        cacheTime?: number;
-        isPersonal?: boolean;
-        nextOffset?: string;
-        isGallery?: boolean;
-        button: InlineQueryResultButton;
-    }): Promise<void>;
+    upload(contents: Uint8Array, params?: UploadParams): Promise<types.InputFile | types.InputFileBig>;
+    /**
+     * Set the bot's commands in the given scope and/or language. Bot-only.
+     *
+     * @param commands The commands to set.
+     */
+    setMyCommands(commands: BotCommand[], params?: SetMyCommandsParams): Promise<void>;
+    /**
+     * Get the bot's commands in the given scope and/or language. Bot-only.
+     */
+    getMyCommands(params?: GetMyCommandsParams): Promise<BotCommand[]>;
+    /**
+     * Answer an inline query. Bot-only.
+     *
+     * @param id The ID of the inline query to answer.
+     * @param results The results to answer with.
+     */
+    answerInlineQuery(id: string, results: InlineQueryResult[], params?: AnswerInlineQueryParams): Promise<void>;
     private handle;
     use(handler: Handler): void;
     branch(predicate: (upd: Update) => MaybePromise<boolean>, trueHandler: Handler, falseHandler: Handler): void;
     filter<D extends Update>(predicate: (update: Update) => update is D, handler: Handler<D>): void;
     filter(predicate: (update: Update) => MaybePromise<boolean>, handler: Handler): void;
     on<T extends keyof Update, F extends keyof NonNullable<Update[T]>>(filter: T extends FilterableUpdates ? T | [T, F, ...F[]] : T, handler: Handler<FilterUpdate<Update, T, F>>): void;
-    setMyInfo(info: Omit<ConstructorParameters<typeof functions["BotsSetBotInfo"]>[0], "bot">): Promise<void>;
+    private setMyInfo;
     /**
-     * Use this method to change the bot's description, which is shown in the chat with the bot if the chat is empty.
+     * Set the bot's description in the given language. Bot-only.
      */
     setMyDescription({ description, languageCode }: {
         description?: string;
         languageCode?: string;
     }): Promise<void>;
     /**
-     * Use this method to change the bot's name.
+     * Set the bot's name in the given language. Bot-only.
      */
     setMyName({ name, languageCode }: {
         name?: string;
         languageCode?: string;
     }): Promise<void>;
     /**
-     * Use this method to change the bot's short description, which is shown on the bot's profile page and is sent together with the link when users share the bot.
+     * Set the bot's short description in the given language. Bot-only.
      */
     setMyShortDescription({ shortDescription: about, languageCode }: {
         shortDescription?: string;
@@ -273,15 +269,15 @@ export declare class Client extends ClientAbstract {
     }): Promise<void>;
     private getMyInfo;
     /**
-     * Use this method to get the current bot description for the given user language.
+     * Get the bot's description in the given language. Bot-only.
      */
     getMyDescription(languageCode?: string): Promise<string>;
     /**
-     * Use this method to get the current bot name for the given user language.
+     * Set the bot's name in the given language. Bot-only.
      */
     getMyName(languageCode?: string): Promise<string>;
     /**
-     * Use this method to get the current bot short description for the given user language.
+     * Get the bot's short description in the given language. Bot-only.
      */
     getMyShortDescription(languageCode?: string): Promise<string>;
 }

package/script/client/4_client.js

@@ -990,8 +990,7 @@ class Client extends _1_client_abstract_js_1.ClientAbstract {
                     }
                 }
                 else if (difference instanceof _2_tl_js_1.types.UpdatesDifferenceTooLong) {
-                    // TODO: we actually do now
-                    // stored messages should be invalidated in case we store messages in the future
+                    await this.storage.deleteMessages();
                     state.pts = difference.pts;
                     dGap("received differenceTooLong");
                 }
@@ -1751,6 +1750,11 @@ class Client extends _1_client_abstract_js_1.ClientAbstract {
             return new _2_tl_js_1.types.InputFile({ id: fileId, name, parts: part, md5Checksum: "" });
         }
     }
+    /**
+     * Set the bot's commands in the given scope and/or language. Bot-only.
+     *
+     * @param commands The commands to set.
+     */
     async setMyCommands(commands, params) {
         await this.invoke(new _2_tl_js_1.functions.BotsSetBotCommands({
             commands: commands.map((v) => new _2_tl_js_1.types.BotCommand(v)),
@@ -1758,6 +1762,9 @@ class Client extends _1_client_abstract_js_1.ClientAbstract {
             scope: await (0, _3_types_js_1.botCommandScopeToTlObject)(params?.scope ?? { type: "default" }, this.getInputPeer.bind(this)),
         }));
     }
+    /**
+     * Get the bot's commands in the given scope and/or language. Bot-only.
+     */
     async getMyCommands(params) {
         const commands_ = await this.invoke(new _2_tl_js_1.functions.BotsGetBotCommands({
             langCode: params?.languageCode ?? "",
@@ -1765,6 +1772,12 @@ class Client extends _1_client_abstract_js_1.ClientAbstract {
         }));
         return commands_.map((v) => ({ command: v.command, description: v.description }));
     }
+    /**
+     * Answer an inline query. Bot-only.
+     *
+     * @param id The ID of the inline query to answer.
+     * @param results The results to answer with.
+     */
     async answerInlineQuery(id, results, params) {
         await this.invoke(new _2_tl_js_1.functions.MessagesSetInlineBotResults({
             queryId: BigInt(id),
@@ -1827,21 +1840,21 @@ class Client extends _1_client_abstract_js_1.ClientAbstract {
         await this.invoke(new _2_tl_js_1.functions.BotsSetBotInfo({ bot: new _2_tl_js_1.types.InputUserSelf(), ...info }));
     }
     /**
-     * Use this method to change the bot's description, which is shown in the chat with the bot if the chat is empty.
+     * Set the bot's description in the given language. Bot-only.
      */
     async setMyDescription({ description, languageCode }) {
         await this.assertBot("setMyDescription");
         await this.setMyInfo({ description, langCode: languageCode ?? "" });
     }
     /**
-     * Use this method to change the bot's name.
+     * Set the bot's name in the given language. Bot-only.
      */
     async setMyName({ name, languageCode }) {
         await this.assertBot("setMyName");
         await this.setMyInfo({ name, langCode: languageCode ?? "" });
     }
     /**
-     * Use this method to change the bot's short description, which is shown on the bot's profile page and is sent together with the link when users share the bot.
+     * Set the bot's short description in the given language. Bot-only.
      */
     async setMyShortDescription({ shortDescription: about, languageCode }) {
         await this.assertBot("setMyShortDescription");
@@ -1851,21 +1864,21 @@ class Client extends _1_client_abstract_js_1.ClientAbstract {
         return this.invoke(new _2_tl_js_1.functions.BotsGetBotInfo({ bot: new _2_tl_js_1.types.InputUserSelf(), langCode: languageCode ?? "" }));
     }
     /**
-     * Use this method to get the current bot description for the given user language.
+     * Get the bot's description in the given language. Bot-only.
      */
     async getMyDescription(languageCode) {
         await this.assertBot("getMyDescription");
         return await this.getMyInfo(languageCode).then((v) => v.description);
     }
     /**
-     * Use this method to get the current bot name for the given user language.
+     * Set the bot's name in the given language. Bot-only.
      */
     async getMyName(languageCode) {
         await this.assertBot("getMyName");
         return await this.getMyInfo(languageCode).then((v) => v.description);
     }
     /**
-     * Use this method to get the current bot short description for the given user language.
+     * Get the bot's short description in the given language. Bot-only.
      */
     async getMyShortDescription(languageCode) {
         await this.assertBot("getMyShortDescription");

package/script/storage/0_storage.d.ts

@@ -1,12 +1,13 @@
 import { MaybePromise } from "../1_utilities.js";
 import { TLObject, types } from "../2_tl.js";
 import { DC } from "../3_transport.js";
-export type StorageKeyPart = string | number | bigint | Uint8Array;
+export type StorageKeyPart = string | number | bigint;
 export declare abstract class Storage {
     private _authKeyId;
     abstract init(): MaybePromise<void>;
     abstract set(key: readonly StorageKeyPart[], value: unknown): MaybePromise<void>;
     abstract get<T>(key: readonly StorageKeyPart[]): MaybePromise<T | null>;
+    abstract getMany<T>(prefix: readonly StorageKeyPart[]): MaybePromise<Generator<[readonly StorageKeyPart[], T]> | AsyncGenerator<[readonly StorageKeyPart[], T]>>;
     setDc(dc: DC | null): MaybePromise<void>;
     getDc(): MaybePromise<DC | null>;
     private resetAuthKeyId;
@@ -24,6 +25,7 @@ export declare abstract class Storage {
     setState(state: types.UpdatesState): Promise<void>;
     getState(): Promise<types.UpdatesState | null>;
     setMessage(chatId: number, messageId: number, message: types.TypeMessage | null): Promise<void>;
+    deleteMessages(): Promise<void>;
     getMessageChat(messageId: number): MaybePromise<number | null>;
     getMessage(chatId: number, messageId: number): Promise<types.TypeMessage | null>;
     setChannelPts(channelId: bigint, pts: number): Promise<void>;

package/script/storage/0_storage.js

@@ -107,6 +107,13 @@ class Storage {
         }
         await this.setTlObject(KPARTS_MESSAGE(chatId, messageId), message);
     }
+    async deleteMessages() {
+        const maybePromises = new Array();
+        for await (const [k, o] of await this.getMany(["messageRefs"])) {
+            maybePromises.push(Promise.all([this.set(k, null), o == null ? Promise.resolve() : this.set(KPARTS_MESSAGE(o, k[1]), null)]).then(() => { }));
+        }
+        await Promise.all(maybePromises.filter((v) => v instanceof Promise));
+    }
     getMessageChat(messageId) {
         return this.get(KPARTS_MESSAGE_REF(messageId));
     }

package/script/storage/0_utilities.d.ts

@@ -10,4 +10,5 @@ export declare enum ValueType {
 }
 export declare function toString(value: unknown): string;
 export declare function fromString<T>(string: string): any;
-export declare function fixKey(key: StorageKeyPart[]): (string | number | Uint8Array)[];
+export declare function fixKey(key: readonly StorageKeyPart[]): (string | number)[];
+export declare function getPrefixKeyRange(prefix: any): IDBKeyRange;

package/script/storage/0_utilities.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.fixKey = exports.fromString = exports.toString = exports.ValueType = void 0;
+exports.getPrefixKeyRange = exports.fixKey = exports.fromString = exports.toString = exports.ValueType = void 0;
 const _0_deps_js_1 = require("../0_deps.js");
 const _1_utilities_js_1 = require("../1_utilities.js");
 var ValueType;
@@ -66,3 +66,67 @@ function fixKey(key) {
     return key.map((v) => typeof v === "bigint" ? String(v) : v);
 }
 exports.fixKey = fixKey;
+// Source: https://gist.github.com/inexorabletash/5462871
+// deno-lint-ignore no-explicit-any
+function getPrefixKeyRange(prefix) {
+    // Ensure prefix is a valid key itself:
+    if (indexedDB.cmp(prefix, prefix) !== 0)
+        throw new TypeError();
+    const upperKey = successor(prefix);
+    if (upperKey === undefined)
+        return IDBKeyRange.lowerBound(prefix);
+    return IDBKeyRange.bound(prefix, upperKey, false, true);
+}
+exports.getPrefixKeyRange = getPrefixKeyRange;
+const MAX_DATE_VALUE = 8640000000000000;
+const UPPER_BOUND = {
+    NUMBER: new Date(-MAX_DATE_VALUE),
+    DATE: "",
+    STRING: [],
+    ARRAY: undefined,
+};
+// deno-lint-ignore no-explicit-any
+function successor(key) {
+    if (typeof key === "number") {
+        if (key === Infinity)
+            return UPPER_BOUND.NUMBER;
+        if (key === -Infinity)
+            return -Number.MAX_VALUE;
+        if (key === 0)
+            return Number.MIN_VALUE;
+        let epsilon = Math.abs(key);
+        while (key + epsilon / 2 !== key)
+            epsilon = epsilon / 2;
+        return key + epsilon;
+    }
+    if (key instanceof Date) {
+        if (key.valueOf() + 1 > MAX_DATE_VALUE)
+            return UPPER_BOUND.DATE;
+        return new Date(key.valueOf() + 1);
+    }
+    if (typeof key === "string") {
+        let len = key.length;
+        while (len > 0) {
+            const head = key.substring(0, len - 1), tail = key.charCodeAt(len - 1);
+            if (tail !== 0xffff)
+                return head + String.fromCharCode(tail + 1);
+            key = head;
+            --len;
+        }
+        return UPPER_BOUND.STRING;
+    }
+    if (Array.isArray(key)) {
+        key = key.slice(); // Operate on a copy.
+        let len = key.length;
+        while (len > 0) {
+            const tail = successor(key.pop());
+            if (tail !== undefined) {
+                key.push(tail);
+                return key;
+            }
+            --len;
+        }
+        return UPPER_BOUND.ARRAY;
+    }
+    throw new TypeError();
+}

package/script/storage/1_storage_indexed_db.d.ts

@@ -5,5 +5,6 @@ export declare class StorageIndexedDB extends Storage {
     constructor(name: string);
     init(): Promise<void>;
     set(k: StorageKeyPart[], v: unknown): Promise<void>;
-    get<T>(k: StorageKeyPart[]): Promise<T | null>;
+    get<T>(k: readonly StorageKeyPart[]): Promise<T | null>;
+    getMany<T>(prefix: readonly StorageKeyPart[]): AsyncGenerator<[readonly StorageKeyPart[], T], void, unknown>;
 }

package/script/storage/1_storage_indexed_db.js

@@ -75,5 +75,22 @@ class StorageIndexedDB extends _0_storage_js_1.Storage {
             };
         });
     }
+    async *getMany(prefix) {
+        if (!this.database) {
+            throw new Error("Not initialized");
+        }
+        const keys = await new Promise((res, rej) => {
+            const tx = this.database.transaction(KV_OBJECT_STORE, "readonly")
+                .objectStore(KV_OBJECT_STORE)
+                .getAllKeys((0, _0_utilities_js_1.getPrefixKeyRange)(prefix));
+            tx.onerror = rej;
+            tx.onsuccess = () => {
+                res(tx.result);
+            };
+        });
+        for (const key of keys) {
+            yield [key, await this.get(key)];
+        }
+    }
 }
 exports.StorageIndexedDB = StorageIndexedDB;

package/script/storage/1_storage_local_storage.d.ts

@@ -5,5 +5,6 @@ export declare class StorageLocalStorage extends Storage implements Storage {
     constructor(prefix: string);
     init(): void;
     get(key_: readonly StorageKeyPart[]): any;
+    getMany<T>(prefix: readonly StorageKeyPart[]): Generator<[readonly StorageKeyPart[], T], void, unknown>;
     set(key_: readonly StorageKeyPart[], value: unknown): MaybePromise<void>;
 }

package/script/storage/1_storage_local_storage.js

@@ -34,6 +34,22 @@ class StorageLocalStorage extends _0_storage_js_1.Storage {
             return null;
         }
     }
+    *getMany(prefix) {
+        for (let [key, value] of Object.entries(localStorage)) {
+            if (key.startsWith(this.prefix)) {
+                key = key.slice(this.prefix.length);
+            }
+            const parts = (0, _0_utilities_js_1.fromString)(key);
+            if (Array.isArray(parts)) {
+                for (const [i, p] of prefix.entries()) {
+                    if ((0, _0_utilities_js_1.toString)(p) != (0, _0_utilities_js_1.toString)(parts[i])) {
+                        continue;
+                    }
+                    yield [parts, (0, _0_utilities_js_1.fromString)(value)];
+                }
+            }
+        }
+    }
     set(key_, value) {
         const key = this.prefix + (0, _0_utilities_js_1.toString)(key_);
         if (value != null) {

package/script/storage/1_storage_memory.d.ts

@@ -4,5 +4,6 @@ export declare class StorageMemory extends Storage implements Storage {
     protected map: Map<string, unknown>;
     init(): void;
     get<T>(key: readonly StorageKeyPart[]): NonNullable<T> | null;
+    getMany<T>(prefix: readonly StorageKeyPart[]): Generator<[readonly StorageKeyPart[], T], void, unknown>;
     set(key_: readonly StorageKeyPart[], value: unknown): MaybePromise<void>;
 }

package/script/storage/1_storage_memory.js

@@ -18,6 +18,19 @@ class StorageMemory extends _0_storage_js_1.Storage {
     get(key) {
         return this.map.get((0, _0_utilities_js_1.toString)(key)) ?? null;
     }
+    *getMany(prefix) {
+        for (const [key, value] of this.map.entries()) {
+            const parts = (0, _0_utilities_js_1.fromString)(key);
+            if (Array.isArray(parts)) {
+                for (const [i, p] of prefix.entries()) {
+                    if ((0, _0_utilities_js_1.toString)(p) != (0, _0_utilities_js_1.toString)(parts[i])) {
+                        continue;
+                    }
+                    yield [parts, value];
+                }
+            }
+        }
+    }
     set(key_, value) {
         const key = (0, _0_utilities_js_1.toString)(key_);
         if (value != null) {

package/script/storage/1_storage_session_storage.d.ts

@@ -5,5 +5,6 @@ export declare class StorageSessionStorage extends Storage implements Storage {
     constructor(prefix: string);
     init(): void;
     get(key_: readonly StorageKeyPart[]): any;
+    getMany<T>(prefix: readonly StorageKeyPart[]): Generator<[readonly StorageKeyPart[], T], void, unknown>;
     set(key_: readonly StorageKeyPart[], value: unknown): MaybePromise<void>;
 }

package/script/storage/1_storage_session_storage.js

@@ -34,6 +34,22 @@ class StorageSessionStorage extends _0_storage_js_1.Storage {
             return null;
         }
     }
+    *getMany(prefix) {
+        for (let [key, value] of Object.entries(localStorage)) {
+            if (key.startsWith(this.prefix)) {
+                key = key.slice(this.prefix.length);
+            }
+            const parts = (0, _0_utilities_js_1.fromString)(key);
+            if (Array.isArray(parts)) {
+                for (const [i, p] of prefix.entries()) {
+                    if ((0, _0_utilities_js_1.toString)(p) != (0, _0_utilities_js_1.toString)(parts[i])) {
+                        continue;
+                    }
+                    yield [parts, (0, _0_utilities_js_1.fromString)(value)];
+                }
+            }
+        }
+    }
     set(key_, value) {
         const key = this.prefix + (0, _0_utilities_js_1.toString)(key_);
         if (value != null) {