@mtcute/core 0.1.0

package/esm/storage/memory.js

@@ -0,0 +1,295 @@
+import { LruMap, toggleChannelIdMark } from '../utils/index.js';
+const CURRENT_VERSION = 1;
+const USERNAME_TTL = 86400000; // 24 hours
+export class MemoryStorage {
+    constructor(params) {
+        this._cachedInputPeers = new LruMap(100);
+        this.reset();
+        this._cachedFull = new LruMap(params?.cacheSize ?? 100);
+        this._vacuumInterval = params?.vacuumInterval ?? 300000;
+    }
+    load() {
+        this._vacuumTimeout = setInterval(this._vacuum.bind(this), this._vacuumInterval);
+    }
+    destroy() {
+        clearInterval(this._vacuumTimeout);
+    }
+    reset() {
+        this._state = {
+            $version: CURRENT_VERSION,
+            defaultDcs: null,
+            authKeys: new Map(),
+            authKeysTemp: new Map(),
+            authKeysTempExpiry: new Map(),
+            entities: new Map(),
+            phoneIndex: new Map(),
+            usernameIndex: new Map(),
+            gpts: null,
+            pts: new Map(),
+            fsm: new Map(),
+            rl: new Map(),
+            self: null,
+        };
+    }
+    /**
+     * Set a given object as an underlying state.
+     *
+     * Note that this object will be used as-is, so if
+     * you plan on using it somewhere else, be sure to copy it beforehand.
+     */
+    _setStateFrom(obj) {
+        if (obj.$version !== CURRENT_VERSION)
+            return;
+        // populate indexes if needed
+        let populate = false;
+        if (!obj.phoneIndex) {
+            obj.phoneIndex = new Map();
+            populate = true;
+        }
+        if (!obj.usernameIndex) {
+            obj.usernameIndex = new Map();
+            populate = true;
+        }
+        if (populate) {
+            Object.values(obj.entities).forEach((ent) => {
+                if (ent.phone)
+                    obj.phoneIndex.set(ent.phone, ent.id);
+                if (ent.username) {
+                    obj.usernameIndex.set(ent.username, ent.id);
+                }
+            });
+        }
+        this._state = obj;
+    }
+    _vacuum() {
+        // remove expired entities from fsm and rate limit storages
+        const now = Date.now();
+        // make references in advance to avoid lookups
+        const state = this._state;
+        const fsm = state.fsm;
+        const rl = state.rl;
+        for (const [key, item] of fsm) {
+            if (item.e && item.e < now) {
+                fsm.delete(key);
+            }
+        }
+        for (const [key, item] of rl) {
+            if (item.res < now) {
+                rl.delete(key);
+            }
+        }
+    }
+    getDefaultDcs() {
+        return this._state.defaultDcs;
+    }
+    setDefaultDcs(dcs) {
+        this._state.defaultDcs = dcs;
+    }
+    setTempAuthKeyFor(dcId, index, key, expiresAt) {
+        const k = `${dcId}:${index}`;
+        if (key) {
+            this._state.authKeysTemp.set(k, key);
+            this._state.authKeysTempExpiry.set(k, expiresAt);
+        }
+        else {
+            this._state.authKeysTemp.delete(k);
+            this._state.authKeysTempExpiry.delete(k);
+        }
+    }
+    setAuthKeyFor(dcId, key) {
+        if (key) {
+            this._state.authKeys.set(dcId, key);
+        }
+        else {
+            this._state.authKeys.delete(dcId);
+        }
+    }
+    getAuthKeyFor(dcId, tempIndex) {
+        if (tempIndex !== undefined) {
+            const k = `${dcId}:${tempIndex}`;
+            if (Date.now() > (this._state.authKeysTempExpiry.get(k) ?? 0)) {
+                return null;
+            }
+            return this._state.authKeysTemp.get(k) ?? null;
+        }
+        return this._state.authKeys.get(dcId) ?? null;
+    }
+    dropAuthKeysFor(dcId) {
+        this._state.authKeys.delete(dcId);
+        for (const key of this._state.authKeysTemp.keys()) {
+            if (key.startsWith(`${dcId}:`)) {
+                this._state.authKeysTemp.delete(key);
+                this._state.authKeysTempExpiry.delete(key);
+            }
+        }
+    }
+    updatePeers(peers) {
+        for (const peer of peers) {
+            this._cachedFull.set(peer.id, peer.full);
+            peer.updated = Date.now();
+            const old = this._state.entities.get(peer.id);
+            if (old) {
+                // delete old index entries if needed
+                if (old.username && peer.username !== old.username) {
+                    this._state.usernameIndex.delete(old.username);
+                }
+                if (old.phone && old.phone !== peer.phone) {
+                    this._state.phoneIndex.delete(old.phone);
+                }
+            }
+            if (peer.username) {
+                this._state.usernameIndex.set(peer.username, peer.id);
+            }
+            if (peer.phone)
+                this._state.phoneIndex.set(peer.phone, peer.id);
+            this._state.entities.set(peer.id, peer);
+        }
+    }
+    _getInputPeer(peerInfo) {
+        if (!peerInfo)
+            return null;
+        switch (peerInfo.type) {
+            case 'user':
+                return {
+                    _: 'inputPeerUser',
+                    userId: peerInfo.id,
+                    accessHash: peerInfo.accessHash,
+                };
+            case 'chat':
+                return {
+                    _: 'inputPeerChat',
+                    chatId: -peerInfo.id,
+                };
+            case 'channel':
+                return {
+                    _: 'inputPeerChannel',
+                    channelId: toggleChannelIdMark(peerInfo.id),
+                    accessHash: peerInfo.accessHash,
+                };
+        }
+    }
+    getPeerById(peerId) {
+        if (this._cachedInputPeers.has(peerId)) {
+            return this._cachedInputPeers.get(peerId);
+        }
+        const peer = this._getInputPeer(this._state.entities.get(peerId));
+        if (peer)
+            this._cachedInputPeers.set(peerId, peer);
+        return peer;
+    }
+    getPeerByPhone(phone) {
+        const peerId = this._state.phoneIndex.get(phone);
+        if (!peerId)
+            return null;
+        return this._getInputPeer(this._state.entities.get(peerId));
+    }
+    getPeerByUsername(username) {
+        const id = this._state.usernameIndex.get(username.toLowerCase());
+        if (!id)
+            return null;
+        const peer = this._state.entities.get(id);
+        if (!peer)
+            return null;
+        if (Date.now() - peer.updated > USERNAME_TTL)
+            return null;
+        return this._getInputPeer(peer);
+    }
+    getSelf() {
+        return this._state.self;
+    }
+    setSelf(self) {
+        this._state.self = self;
+    }
+    setManyChannelPts(values) {
+        for (const [id, pts] of values) {
+            this._state.pts.set(id, pts);
+        }
+    }
+    getChannelPts(entityId) {
+        return this._state.pts.get(entityId) ?? null;
+    }
+    getUpdatesState() {
+        return this._state.gpts ?? null;
+    }
+    setUpdatesPts(val) {
+        if (!this._state.gpts)
+            this._state.gpts = [0, 0, 0, 0];
+        this._state.gpts[0] = val;
+    }
+    setUpdatesQts(val) {
+        if (!this._state.gpts)
+            this._state.gpts = [0, 0, 0, 0];
+        this._state.gpts[1] = val;
+    }
+    setUpdatesDate(val) {
+        if (!this._state.gpts)
+            this._state.gpts = [0, 0, 0, 0];
+        this._state.gpts[2] = val;
+    }
+    setUpdatesSeq(val) {
+        if (!this._state.gpts)
+            this._state.gpts = [0, 0, 0, 0];
+        this._state.gpts[3] = val;
+    }
+    getFullPeerById(id) {
+        return this._cachedFull.get(id) ?? null;
+    }
+    // IStateStorage implementation
+    getState(key) {
+        const val = this._state.fsm.get(key);
+        if (!val)
+            return null;
+        if (val.e && val.e < Date.now()) {
+            // expired
+            this._state.fsm.delete(key);
+            return null;
+        }
+        return val.v;
+    }
+    setState(key, state, ttl) {
+        this._state.fsm.set(key, {
+            v: state,
+            e: ttl ? Date.now() + ttl * 1000 : undefined,
+        });
+    }
+    deleteState(key) {
+        this._state.fsm.delete(key);
+    }
+    getCurrentScene(key) {
+        return this.getState(`$current_scene_${key}`);
+    }
+    setCurrentScene(key, scene, ttl) {
+        return this.setState(`$current_scene_${key}`, scene, ttl);
+    }
+    deleteCurrentScene(key) {
+        this._state.fsm.delete(`$current_scene_${key}`);
+    }
+    getRateLimit(key, limit, window) {
+        // leaky bucket
+        const now = Date.now();
+        const item = this._state.rl.get(key);
+        if (!item) {
+            const state = {
+                res: now + window * 1000,
+                rem: limit,
+            };
+            this._state.rl.set(key, state);
+            return [state.rem, state.res];
+        }
+        if (item.res < now) {
+            // expired
+            const state = {
+                res: now + window * 1000,
+                rem: limit,
+            };
+            this._state.rl.set(key, state);
+            return [state.rem, state.res];
+        }
+        item.rem = item.rem > 0 ? item.rem - 1 : 0;
+        return [item.rem, item.res];
+    }
+    resetRateLimit(key) {
+        this._state.rl.delete(key);
+    }
+}
+//# sourceMappingURL=memory.js.map

package/esm/storage/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../../src/storage/memory.ts"],"names":[],"mappings":"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","sourcesContent":["import { tl } from '@mtcute/tl'\n\nimport { MaybeAsync } from '../types/index.js'\nimport { LruMap, toggleChannelIdMark } from '../utils/index.js'\nimport { ITelegramStorage } from './abstract.js'\n\nconst CURRENT_VERSION = 1\n\ntype PeerInfoWithUpdated = ITelegramStorage.PeerInfo & { updated: number }\n\nexport interface MemorySessionState {\n    // forwards compatibility for persistent storages\n    $version: typeof CURRENT_VERSION\n\n    defaultDcs: ITelegramStorage.DcOptions | null\n    authKeys: Map<number, Uint8Array>\n    authKeysTemp: Map<string, Uint8Array>\n    authKeysTempExpiry: Map<string, number>\n\n    // marked peer id -> entity info\n    entities: Map<number, PeerInfoWithUpdated>\n    // phone number -> peer id\n    phoneIndex: Map<string, number>\n    // username -> peer id\n    usernameIndex: Map<string, number>\n\n    // common pts, date, seq, qts\n    gpts: [number, number, number, number] | null\n    // channel pts\n    pts: Map<number, number>\n\n    // state for fsm\n    fsm: Map<\n        string,\n        {\n            // value\n            v: unknown\n            // expires\n            e?: number\n        }\n    >\n\n    // state for rate limiter\n    rl: Map<\n        string,\n        {\n            // reset\n            res: number\n            // remaining\n            rem: number\n        }\n    >\n\n    self: ITelegramStorage.SelfInfo | null\n}\n\nconst USERNAME_TTL = 86400000 // 24 hours\n\nexport class MemoryStorage implements ITelegramStorage /*, IStateStorage*/ {\n    protected _state!: MemorySessionState\n    private _cachedInputPeers: LruMap<number, tl.TypeInputPeer> = new LruMap(100)\n\n    private _cachedFull: LruMap<number, tl.TypeUser | tl.TypeChat>\n\n    private _vacuumTimeout?: NodeJS.Timeout\n    private _vacuumInterval: number\n\n    constructor(params?: {\n        /**\n         * Maximum number of cached full entities.\n         *\n         * Note that full entities are **NOT** persisted\n         * to the disk (in case this storage is backed\n         * by a local storage), and only available within\n         * the current runtime.\n         *\n         * @default  `100`, use `0` to disable\n         */\n        cacheSize?: number\n\n        /**\n         * Interval in milliseconds for vacuuming the storage.\n         *\n         * When vacuuming, the storage will remove expired FSM\n         * states to reduce memory usage.\n         *\n         * @default  `300_000` (5 minutes)\n         */\n        vacuumInterval?: number\n    }) {\n        this.reset()\n        this._cachedFull = new LruMap(params?.cacheSize ?? 100)\n        this._vacuumInterval = params?.vacuumInterval ?? 300_000\n    }\n\n    load(): void {\n        this._vacuumTimeout = setInterval(this._vacuum.bind(this), this._vacuumInterval)\n    }\n\n    destroy(): void {\n        clearInterval(this._vacuumTimeout)\n    }\n\n    reset(): void {\n        this._state = {\n            $version: CURRENT_VERSION,\n            defaultDcs: null,\n            authKeys: new Map(),\n            authKeysTemp: new Map(),\n            authKeysTempExpiry: new Map(),\n            entities: new Map(),\n            phoneIndex: new Map(),\n            usernameIndex: new Map(),\n            gpts: null,\n            pts: new Map(),\n            fsm: new Map(),\n            rl: new Map(),\n            self: null,\n        }\n    }\n\n    /**\n     * Set a given object as an underlying state.\n     *\n     * Note that this object will be used as-is, so if\n     * you plan on using it somewhere else, be sure to copy it beforehand.\n     */\n    protected _setStateFrom(obj: MemorySessionState): void {\n        if (obj.$version !== CURRENT_VERSION) return\n\n        // populate indexes if needed\n        let populate = false\n\n        if (!obj.phoneIndex) {\n            obj.phoneIndex = new Map()\n            populate = true\n        }\n        if (!obj.usernameIndex) {\n            obj.usernameIndex = new Map()\n            populate = true\n        }\n\n        if (populate) {\n            Object.values(obj.entities).forEach((ent: ITelegramStorage.PeerInfo) => {\n                if (ent.phone) obj.phoneIndex.set(ent.phone, ent.id)\n\n                if (ent.username) {\n                    obj.usernameIndex.set(ent.username, ent.id)\n                }\n            })\n        }\n\n        this._state = obj\n    }\n\n    private _vacuum(): void {\n        // remove expired entities from fsm and rate limit storages\n\n        const now = Date.now()\n\n        // make references in advance to avoid lookups\n        const state = this._state\n        const fsm = state.fsm\n        const rl = state.rl\n\n        for (const [key, item] of fsm) {\n            if (item.e && item.e < now) {\n                fsm.delete(key)\n            }\n        }\n\n        for (const [key, item] of rl) {\n            if (item.res < now) {\n                rl.delete(key)\n            }\n        }\n    }\n\n    getDefaultDcs(): ITelegramStorage.DcOptions | null {\n        return this._state.defaultDcs\n    }\n\n    setDefaultDcs(dcs: ITelegramStorage.DcOptions | null): void {\n        this._state.defaultDcs = dcs\n    }\n\n    setTempAuthKeyFor(dcId: number, index: number, key: Uint8Array | null, expiresAt: number): void {\n        const k = `${dcId}:${index}`\n\n        if (key) {\n            this._state.authKeysTemp.set(k, key)\n            this._state.authKeysTempExpiry.set(k, expiresAt)\n        } else {\n            this._state.authKeysTemp.delete(k)\n            this._state.authKeysTempExpiry.delete(k)\n        }\n    }\n\n    setAuthKeyFor(dcId: number, key: Uint8Array | null): void {\n        if (key) {\n            this._state.authKeys.set(dcId, key)\n        } else {\n            this._state.authKeys.delete(dcId)\n        }\n    }\n\n    getAuthKeyFor(dcId: number, tempIndex?: number): Uint8Array | null {\n        if (tempIndex !== undefined) {\n            const k = `${dcId}:${tempIndex}`\n\n            if (Date.now() > (this._state.authKeysTempExpiry.get(k) ?? 0)) {\n                return null\n            }\n\n            return this._state.authKeysTemp.get(k) ?? null\n        }\n\n        return this._state.authKeys.get(dcId) ?? null\n    }\n\n    dropAuthKeysFor(dcId: number): void {\n        this._state.authKeys.delete(dcId)\n\n        for (const key of this._state.authKeysTemp.keys()) {\n            if (key.startsWith(`${dcId}:`)) {\n                this._state.authKeysTemp.delete(key)\n                this._state.authKeysTempExpiry.delete(key)\n            }\n        }\n    }\n\n    updatePeers(peers: PeerInfoWithUpdated[]): MaybeAsync<void> {\n        for (const peer of peers) {\n            this._cachedFull.set(peer.id, peer.full)\n\n            peer.updated = Date.now()\n            const old = this._state.entities.get(peer.id)\n\n            if (old) {\n                // delete old index entries if needed\n                if (old.username && peer.username !== old.username) {\n                    this._state.usernameIndex.delete(old.username)\n                }\n                if (old.phone && old.phone !== peer.phone) {\n                    this._state.phoneIndex.delete(old.phone)\n                }\n            }\n\n            if (peer.username) {\n                this._state.usernameIndex.set(peer.username, peer.id)\n            }\n\n            if (peer.phone) this._state.phoneIndex.set(peer.phone, peer.id)\n\n            this._state.entities.set(peer.id, peer)\n        }\n    }\n\n    protected _getInputPeer(peerInfo?: ITelegramStorage.PeerInfo): tl.TypeInputPeer | null {\n        if (!peerInfo) return null\n\n        switch (peerInfo.type) {\n            case 'user':\n                return {\n                    _: 'inputPeerUser',\n                    userId: peerInfo.id,\n                    accessHash: peerInfo.accessHash,\n                }\n            case 'chat':\n                return {\n                    _: 'inputPeerChat',\n                    chatId: -peerInfo.id,\n                }\n            case 'channel':\n                return {\n                    _: 'inputPeerChannel',\n                    channelId: toggleChannelIdMark(peerInfo.id),\n                    accessHash: peerInfo.accessHash,\n                }\n        }\n    }\n\n    getPeerById(peerId: number): tl.TypeInputPeer | null {\n        if (this._cachedInputPeers.has(peerId)) {\n            return this._cachedInputPeers.get(peerId)!\n        }\n        const peer = this._getInputPeer(this._state.entities.get(peerId))\n        if (peer) this._cachedInputPeers.set(peerId, peer)\n\n        return peer\n    }\n\n    getPeerByPhone(phone: string): tl.TypeInputPeer | null {\n        const peerId = this._state.phoneIndex.get(phone)\n        if (!peerId) return null\n\n        return this._getInputPeer(this._state.entities.get(peerId))\n    }\n\n    getPeerByUsername(username: string): tl.TypeInputPeer | null {\n        const id = this._state.usernameIndex.get(username.toLowerCase())\n        if (!id) return null\n        const peer = this._state.entities.get(id)\n        if (!peer) return null\n\n        if (Date.now() - peer.updated > USERNAME_TTL) return null\n\n        return this._getInputPeer(peer)\n    }\n\n    getSelf(): ITelegramStorage.SelfInfo | null {\n        return this._state.self\n    }\n\n    setSelf(self: ITelegramStorage.SelfInfo | null): void {\n        this._state.self = self\n    }\n\n    setManyChannelPts(values: Map<number, number>): void {\n        for (const [id, pts] of values) {\n            this._state.pts.set(id, pts)\n        }\n    }\n\n    getChannelPts(entityId: number): number | null {\n        return this._state.pts.get(entityId) ?? null\n    }\n\n    getUpdatesState(): MaybeAsync<[number, number, number, number] | null> {\n        return this._state.gpts ?? null\n    }\n\n    setUpdatesPts(val: number): MaybeAsync<void> {\n        if (!this._state.gpts) this._state.gpts = [0, 0, 0, 0]\n        this._state.gpts[0] = val\n    }\n\n    setUpdatesQts(val: number): MaybeAsync<void> {\n        if (!this._state.gpts) this._state.gpts = [0, 0, 0, 0]\n        this._state.gpts[1] = val\n    }\n\n    setUpdatesDate(val: number): MaybeAsync<void> {\n        if (!this._state.gpts) this._state.gpts = [0, 0, 0, 0]\n        this._state.gpts[2] = val\n    }\n\n    setUpdatesSeq(val: number): MaybeAsync<void> {\n        if (!this._state.gpts) this._state.gpts = [0, 0, 0, 0]\n        this._state.gpts[3] = val\n    }\n\n    getFullPeerById(id: number): tl.TypeUser | tl.TypeChat | null {\n        return this._cachedFull.get(id) ?? null\n    }\n\n    // IStateStorage implementation\n\n    getState(key: string): unknown {\n        const val = this._state.fsm.get(key)\n        if (!val) return null\n\n        if (val.e && val.e < Date.now()) {\n            // expired\n            this._state.fsm.delete(key)\n\n            return null\n        }\n\n        return val.v\n    }\n\n    setState(key: string, state: unknown, ttl?: number): void {\n        this._state.fsm.set(key, {\n            v: state,\n            e: ttl ? Date.now() + ttl * 1000 : undefined,\n        })\n    }\n\n    deleteState(key: string): void {\n        this._state.fsm.delete(key)\n    }\n\n    getCurrentScene(key: string): string | null {\n        return this.getState(`$current_scene_${key}`) as string | null\n    }\n\n    setCurrentScene(key: string, scene: string, ttl?: number): void {\n        return this.setState(`$current_scene_${key}`, scene, ttl)\n    }\n\n    deleteCurrentScene(key: string): void {\n        this._state.fsm.delete(`$current_scene_${key}`)\n    }\n\n    getRateLimit(key: string, limit: number, window: number): [number, number] {\n        // leaky bucket\n        const now = Date.now()\n\n        const item = this._state.rl.get(key)\n\n        if (!item) {\n            const state = {\n                res: now + window * 1000,\n                rem: limit,\n            }\n\n            this._state.rl.set(key, state)\n\n            return [state.rem, state.res]\n        }\n\n        if (item.res < now) {\n            // expired\n\n            const state = {\n                res: now + window * 1000,\n                rem: limit,\n            }\n\n            this._state.rl.set(key, state)\n\n            return [state.rem, state.res]\n        }\n\n        item.rem = item.rem > 0 ? item.rem - 1 : 0\n\n        return [item.rem, item.res]\n    }\n\n    resetRateLimit(key: string): void {\n        this._state.rl.delete(key)\n    }\n}\n"]}

package/esm/types/errors.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Base class for all mtcute errors
+ */
+export declare class MtcuteError extends Error {
+}
+/**
+ * Method invocation was invalid because some argument
+ * passed was invalid.
+ */
+export declare class MtArgumentError extends MtcuteError {
+}
+/**
+ * Something isn't right with security of the connection.
+ */
+export declare class MtSecurityError extends MtcuteError {
+}
+/**
+ * Either you requested or the server returned something
+ * that is not (yet) supported.
+ *
+ * Stay tuned for future updates!
+ *
+ * In some cases, this error may mean that you are missing some
+ * optional peer dependencies, or that the feature is not supported
+ * in the current environment.
+ */
+export declare class MtUnsupportedError extends MtcuteError {
+}
+/**
+ * Server returned something of an unexpected type.
+ *
+ * This is usually a problem on library side.
+ * Feel free to open an issue about this!
+ */
+export declare class MtTypeAssertionError extends MtcuteError {
+    /**
+     * Context at which the error occurred.
+     * Usually a user-friendly string containing name
+     * of the high-level API method, name of the TL
+     * RPC method, and path of the entity,
+     * like this: `signIn (@ auth.signIn -> user)`
+     */
+    context: string;
+    /** Expected TL type */
+    expected: string;
+    /** Actual TL type */
+    actual: string;
+    constructor(context: string, expected: string, actual: string);
+}
+export declare class MtTimeoutError extends MtcuteError {
+    readonly timeout?: number | undefined;
+    constructor(timeout?: number | undefined);
+}

package/esm/types/errors.js

@@ -0,0 +1,49 @@
+/**
+ * Base class for all mtcute errors
+ */
+export class MtcuteError extends Error {
+}
+/**
+ * Method invocation was invalid because some argument
+ * passed was invalid.
+ */
+export class MtArgumentError extends MtcuteError {
+}
+/**
+ * Something isn't right with security of the connection.
+ */
+export class MtSecurityError extends MtcuteError {
+}
+/**
+ * Either you requested or the server returned something
+ * that is not (yet) supported.
+ *
+ * Stay tuned for future updates!
+ *
+ * In some cases, this error may mean that you are missing some
+ * optional peer dependencies, or that the feature is not supported
+ * in the current environment.
+ */
+export class MtUnsupportedError extends MtcuteError {
+}
+/**
+ * Server returned something of an unexpected type.
+ *
+ * This is usually a problem on library side.
+ * Feel free to open an issue about this!
+ */
+export class MtTypeAssertionError extends MtcuteError {
+    constructor(context, expected, actual) {
+        super(`Type assertion error at ${context}: expected ${expected}, but got ${actual}`);
+        this.context = context;
+        this.expected = expected;
+        this.actual = actual;
+    }
+}
+export class MtTimeoutError extends MtcuteError {
+    constructor(timeout) {
+        super(`Request timed out${timeout ? ` after ${timeout}ms` : ''}`);
+        this.timeout = timeout;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/esm/types/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/types/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;CAAG;AAEzC;;;GAGG;AACH,MAAM,OAAO,eAAgB,SAAQ,WAAW;CAAG;AAEnD;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,WAAW;CAAG;AAEnD;;;;;;;;;GASG;AACH,MAAM,OAAO,kBAAmB,SAAQ,WAAW;CAAG;AAEtD;;;;;GAKG;AACH,MAAM,OAAO,oBAAqB,SAAQ,WAAW;IAgBjD,YAAY,OAAe,EAAE,QAAgB,EAAE,MAAc;QACzD,KAAK,CAAC,2BAA2B,OAAO,cAAc,QAAQ,aAAa,MAAM,EAAE,CAAC,CAAA;QACpF,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACxB,CAAC;CACJ;AAED,MAAM,OAAO,cAAe,SAAQ,WAAW;IAC3C,YAAqB,OAAgB;QACjC,KAAK,CAAC,oBAAoB,OAAO,CAAC,CAAC,CAAC,UAAU,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QADhD,YAAO,GAAP,OAAO,CAAS;IAErC,CAAC;CACJ","sourcesContent":["/**\n * Base class for all mtcute errors\n */\nexport class MtcuteError extends Error {}\n\n/**\n * Method invocation was invalid because some argument\n * passed was invalid.\n */\nexport class MtArgumentError extends MtcuteError {}\n\n/**\n * Something isn't right with security of the connection.\n */\nexport class MtSecurityError extends MtcuteError {}\n\n/**\n * Either you requested or the server returned something\n * that is not (yet) supported.\n *\n * Stay tuned for future updates!\n *\n * In some cases, this error may mean that you are missing some\n * optional peer dependencies, or that the feature is not supported\n * in the current environment.\n */\nexport class MtUnsupportedError extends MtcuteError {}\n\n/**\n * Server returned something of an unexpected type.\n *\n * This is usually a problem on library side.\n * Feel free to open an issue about this!\n */\nexport class MtTypeAssertionError extends MtcuteError {\n    /**\n     * Context at which the error occurred.\n     * Usually a user-friendly string containing name\n     * of the high-level API method, name of the TL\n     * RPC method, and path of the entity,\n     * like this: `signIn (@ auth.signIn -> user)`\n     */\n    context: string\n\n    /** Expected TL type */\n    expected: string\n\n    /** Actual TL type */\n    actual: string\n\n    constructor(context: string, expected: string, actual: string) {\n        super(`Type assertion error at ${context}: expected ${expected}, but got ${actual}`)\n        this.context = context\n        this.expected = expected\n        this.actual = actual\n    }\n}\n\nexport class MtTimeoutError extends MtcuteError {\n    constructor(readonly timeout?: number) {\n        super(`Request timed out${timeout ? ` after ${timeout}ms` : ''}`)\n    }\n}\n"]}

package/esm/types/index.d.ts

@@ -0,0 +1,3 @@
+export * from './errors.js';
+export * from './peers.js';
+export * from './utils.js';

package/esm/types/index.js

@@ -0,0 +1,4 @@
+export * from './errors.js';
+export * from './peers.js';
+export * from './utils.js';
+//# sourceMappingURL=index.js.map

package/esm/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA","sourcesContent":["export * from './errors.js'\nexport * from './peers.js'\nexport * from './utils.js'\n"]}

package/esm/types/peers.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Peer types that have one-to-one relation to `tl.Peer*` types.
+ */
+export type BasicPeerType = 'user' | 'chat' | 'channel';

package/esm/types/peers.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=peers.js.map

package/esm/types/peers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"peers.js","sourceRoot":"","sources":["../../../src/types/peers.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Peer types that have one-to-one relation to `tl.Peer*` types.\n */\nexport type BasicPeerType = 'user' | 'chat' | 'channel'\n"]}

package/esm/types/utils.d.ts

@@ -0,0 +1,6 @@
+export type MaybeAsync<T> = T | Promise<T>;
+export type PartialExcept<T, K extends keyof T> = Partial<Omit<T, K>> & Pick<T, K>;
+export type PartialOnly<T, K extends keyof T> = Partial<Pick<T, K>> & Omit<T, K>;
+export type MaybeArray<T> = T | T[];
+export type MustEqual<T, V> = T extends V ? (V extends T ? T : V) : V;
+export declare function assertNever(x: never): never;

package/esm/types/utils.js

@@ -0,0 +1,5 @@
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function assertNever(x) {
+    throw new Error('Illegal state');
+}
+//# sourceMappingURL=utils.js.map

package/esm/types/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/types/utils.ts"],"names":[],"mappings":"AAQA,6DAA6D;AAC7D,MAAM,UAAU,WAAW,CAAC,CAAQ;IAChC,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAA;AACpC,CAAC","sourcesContent":["export type MaybeAsync<T> = T | Promise<T>\nexport type PartialExcept<T, K extends keyof T> = Partial<Omit<T, K>> & Pick<T, K>\nexport type PartialOnly<T, K extends keyof T> = Partial<Pick<T, K>> & Omit<T, K>\n\nexport type MaybeArray<T> = T | T[]\n\nexport type MustEqual<T, V> = T extends V ? (V extends T ? T : V) : V\n\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nexport function assertNever(x: never): never {\n    throw new Error('Illegal state')\n}\n"]}

package/esm/utils/async-lock.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Simple class implementing a semaphore like
+ * behaviour.
+ */
+export declare class AsyncLock {
+    private _queue;
+    acquire(): Promise<void>;
+    release(): void;
+    with(func: () => Promise<void>): Promise<void>;
+}

package/esm/utils/async-lock.js

@@ -0,0 +1,39 @@
+import { Deque } from './deque.js';
+/**
+ * Simple class implementing a semaphore like
+ * behaviour.
+ */
+export class AsyncLock {
+    constructor() {
+        this._queue = new Deque();
+    }
+    async acquire() {
+        let info;
+        while ((info = this._queue.peekFront())) {
+            await info[0];
+        }
+        let unlock;
+        const prom = new Promise((resolve) => {
+            unlock = resolve;
+        });
+        this._queue.pushBack([prom, unlock]);
+    }
+    release() {
+        if (!this._queue.length)
+            throw new Error('Nothing to release');
+        this._queue.popFront()[1]();
+    }
+    with(func) {
+        let err = null;
+        return this.acquire()
+            .then(() => func())
+            .catch((e) => void (err = e))
+            .then(() => {
+            this.release();
+            // eslint-disable-next-line @typescript-eslint/no-throw-literal
+            if (err)
+                throw err;
+        });
+    }
+}
+//# sourceMappingURL=async-lock.js.map

package/esm/utils/async-lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-lock.js","sourceRoot":"","sources":["../../../src/utils/async-lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAIlC;;;GAGG;AACH,MAAM,OAAO,SAAS;IAAtB;QACY,WAAM,GAAG,IAAI,KAAK,EAAY,CAAA;IAmC1C,CAAC;IAjCG,KAAK,CAAC,OAAO;QACT,IAAI,IAAI,CAAA;QAER,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,EAAE;YACrC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAA;SAChB;QAED,IAAI,MAAkB,CAAA;QACtB,MAAM,IAAI,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACvC,MAAM,GAAG,OAAO,CAAA;QACpB,CAAC,CAAC,CAAA;QAEF,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,MAAO,CAAC,CAAC,CAAA;IACzC,CAAC;IAED,OAAO;QACH,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAA;QAE9D,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAG,CAAC,CAAC,CAAC,EAAE,CAAA;IAChC,CAAC;IAED,IAAI,CAAC,IAAyB;QAC1B,IAAI,GAAG,GAAY,IAAI,CAAA;QAEvB,OAAO,IAAI,CAAC,OAAO,EAAE;aAChB,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;aAClB,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;aAC5B,IAAI,CAAC,GAAG,EAAE;YACP,IAAI,CAAC,OAAO,EAAE,CAAA;YACd,+DAA+D;YAC/D,IAAI,GAAG;gBAAE,MAAM,GAAG,CAAA;QACtB,CAAC,CAAC,CAAA;IACV,CAAC;CACJ","sourcesContent":["import { Deque } from './deque.js'\n\ntype LockInfo = [Promise<void>, () => void]\n\n/**\n * Simple class implementing a semaphore like\n * behaviour.\n */\nexport class AsyncLock {\n    private _queue = new Deque<LockInfo>()\n\n    async acquire(): Promise<void> {\n        let info\n\n        while ((info = this._queue.peekFront())) {\n            await info[0]\n        }\n\n        let unlock: () => void\n        const prom = new Promise<void>((resolve) => {\n            unlock = resolve\n        })\n\n        this._queue.pushBack([prom, unlock!])\n    }\n\n    release(): void {\n        if (!this._queue.length) throw new Error('Nothing to release')\n\n        this._queue.popFront()![1]()\n    }\n\n    with(func: () => Promise<void>): Promise<void> {\n        let err: unknown = null\n\n        return this.acquire()\n            .then(() => func())\n            .catch((e) => void (err = e))\n            .then(() => {\n                this.release()\n                // eslint-disable-next-line @typescript-eslint/no-throw-literal\n                if (err) throw err\n            })\n    }\n}\n"]}

package/esm/utils/bigint-utils.d.ts

@@ -0,0 +1,40 @@
+import bigInt, { BigInteger } from 'big-integer';
+/**
+ * Convert a big integer to a buffer
+ *
+ * @param value  Value to convert
+ * @param length  Length of the resulting buffer (by default it's computed automatically)
+ * @param le  Whether to use little-endian encoding
+ */
+export declare function bigIntToBuffer(value: BigInteger, length?: number, le?: boolean): Uint8Array;
+/**
+ * Convert a buffer to a big integer
+ *
+ * @param buffer  Buffer to convert
+ * @param offset  Offset to start reading from
+ * @param length  Length to read
+ * @param le  Whether to use little-endian encoding
+ */
+export declare function bufferToBigInt(buffer: Uint8Array, offset?: number, length?: number, le?: boolean): BigInteger;
+/**
+ * Generate a random big integer of the given size (in bytes)
+ * @param size  Size in bytes
+ */
+export declare function randomBigInt(size: number): BigInteger;
+/**
+ * Generate a random big integer of the given size (in bits)
+ * @param bits
+ */
+export declare function randomBigIntBits(bits: number): BigInteger;
+/**
+ * Generate a random big integer in the range [min, max)
+ *
+ * @param max  Maximum value (exclusive)
+ * @param min  Minimum value (inclusive)
+ */
+export declare function randomBigIntInRange(max: BigInteger, min?: bigInt.BigInteger): BigInteger;
+/**
+ * Compute the multiplicity of 2 in the prime factorization of n
+ * @param n
+ */
+export declare function twoMultiplicity(n: BigInteger): BigInteger;