@mtcute/core 0.1.0

package/cjs/utils/peer-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-utils.js","sourceRoot":"","sources":["../../../src/utils/peer-utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { tl } from '@mtcute/tl'\n\nimport { MtArgumentError, MtUnsupportedError } from '../types/errors.js'\nimport { BasicPeerType } from '../types/peers.js'\n\n// src: https://github.com/tdlib/td/blob/master/td/telegram/DialogId.h\nconst ZERO_CHANNEL_ID = -1000000000000\nconst ZERO_SECRET_CHAT_ID = -2000000000000\nconst MAX_SECRET_CHAT_ID = -1997852516353 // ZERO_SECRET_CHAT_ID + 0x7fffffff\n// src: https://github.com/tdlib/td/blob/master/td/telegram/ChatId.h\n// const MAX_CHAT_ID = 999999999999\nconst MIN_MARKED_CHAT_ID = -999999999999 // -MAX_CHAT_ID\n// src: https://github.com/tdlib/td/blob/master/td/telegram/UserId.h\n// MAX_USER_ID = (1ll << 40) - 1\nconst MAX_USER_ID = 1099511627775\n// src: https://github.com/tdlib/td/blob/master/td/telegram/ChannelId.h\n// the last (1 << 31) - 1 identifiers will be used for secret chat dialog identifiers\n// MAX_CHANNEL_ID = 1000000000000ll - (1ll << 31)\n// const MAX_CHANNEL_ID = 997852516352\nconst MIN_MARKED_CHANNEL_ID = -1997852516352 // ZERO_CHANNEL_ID - MAX_CHANNEL_ID\n\n/**\n * Add or remove channel marker from ID\n */\nexport function toggleChannelIdMark(id: number): number {\n    return ZERO_CHANNEL_ID - id\n}\n\n/**\n * Get the bare (non-marked) ID from a {@link tl.TypePeer}\n */\nexport function getBarePeerId(peer: tl.TypePeer): number {\n    switch (peer._) {\n        case 'peerUser':\n            return peer.userId\n        case 'peerChat':\n            return peer.chatId\n        case 'peerChannel':\n            return peer.channelId\n    }\n}\n\n// src: https://github.com/tdlib/td/blob/master/td/telegram/DialogId.cpp\n\n/**\n * Get the marked (non-bare) ID from a {@link tl.TypePeer}\n *\n * *Mark* is bot API compatible, which is:\n * - ID stays the same for users\n * - ID is negated for chats\n * - ID is negated and `-1e12` is subtracted for channels\n */\nexport function getMarkedPeerId(peerId: number, peerType: BasicPeerType): number\nexport function getMarkedPeerId(peer: tl.TypePeer | tl.TypeInputPeer | tl.TypeInputUser | tl.TypeInputChannel): number\n\nexport function getMarkedPeerId(\n    peer: tl.TypePeer | tl.TypeInputPeer | tl.TypeInputUser | tl.TypeInputChannel | number,\n    peerType?: BasicPeerType,\n): number {\n    if (typeof peer === 'number') {\n        switch (peerType) {\n            case 'user':\n                return peer\n            case 'chat':\n                return -peer\n            case 'channel':\n                return ZERO_CHANNEL_ID - peer\n        }\n        throw new MtArgumentError('Invalid peer type')\n    }\n\n    switch (peer._) {\n        case 'peerUser':\n        case 'inputPeerUser':\n        case 'inputUser':\n            return peer.userId\n        case 'peerChat':\n        case 'inputPeerChat':\n            return -peer.chatId\n        case 'peerChannel':\n        case 'inputPeerChannel':\n        case 'inputChannel':\n            return ZERO_CHANNEL_ID - peer.channelId\n    }\n\n    throw new MtArgumentError('Invalid peer')\n}\n\n/**\n * Extract basic peer type from {@link tl.TypePeer} or its marked ID.\n */\nexport function getBasicPeerType(peer: tl.TypePeer | number): BasicPeerType {\n    if (typeof peer !== 'number') {\n        switch (peer._) {\n            case 'peerUser':\n                return 'user'\n            case 'peerChat':\n                return 'chat'\n            case 'peerChannel':\n                return 'channel'\n        }\n    }\n\n    if (peer < 0) {\n        if (MIN_MARKED_CHAT_ID <= peer) {\n            return 'chat'\n        }\n\n        if (MIN_MARKED_CHANNEL_ID <= peer && peer !== ZERO_CHANNEL_ID) {\n            return 'channel'\n        }\n\n        if (MAX_SECRET_CHAT_ID <= peer && peer !== ZERO_SECRET_CHAT_ID) {\n            // return 'secret'\n            throw new MtUnsupportedError('Secret chats are not supported')\n        }\n    } else if (peer > 0 && peer <= MAX_USER_ID) {\n        return 'user'\n    }\n\n    throw new MtArgumentError(`Invalid marked peer id: ${peer}`)\n}\n\n/**\n * Extract bare peer ID from marked ID.\n *\n * @param peerId  Marked peer ID\n */\nexport function markedPeerIdToBare(peerId: number): number {\n    const type = getBasicPeerType(peerId)\n\n    switch (type) {\n        case 'user':\n            return peerId\n        case 'chat':\n            return -peerId\n        case 'channel':\n            return toggleChannelIdMark(peerId)\n    }\n}\n\n/**\n * Extracts all (cacheable) entities from a TlObject or a list of them.\n * Only checks `.user`, `.chat`, `.channel`, `.users` and `.chats` properties\n */\nexport function* getAllPeersFrom(obj: tl.TlObject | tl.TlObject[]): Iterable<tl.TypeUser | tl.TypeChat> {\n    if (typeof obj !== 'object') return\n\n    if (Array.isArray(obj)) {\n        for (const it of obj) {\n            yield* getAllPeersFrom(it)\n        }\n\n        return\n    }\n\n    switch (obj._) {\n        case 'user':\n        case 'chat':\n        case 'channel':\n        case 'chatForbidden':\n        case 'channelForbidden':\n            yield obj\n\n            return\n    }\n\n    if ('user' in obj && typeof obj.user === 'object' && obj.user._ === 'user') {\n        yield obj.user\n    }\n\n    if ('chat' in obj && typeof obj.chat === 'object') {\n        switch (obj.chat._) {\n            case 'chat':\n            case 'channel':\n            case 'chatForbidden':\n            case 'channelForbidden':\n                yield obj.chat\n                break\n        }\n    }\n\n    if ('channel' in obj && typeof obj.channel === 'object') {\n        switch (obj.channel._) {\n            case 'chat':\n            case 'channel':\n            case 'chatForbidden':\n            case 'channelForbidden':\n                yield obj.channel\n                break\n        }\n    }\n\n    if ('users' in obj && Array.isArray(obj.users) && obj.users.length) {\n        for (const user of obj.users) {\n            // .users is sometimes number[]\n            if (typeof user === 'object' && user._ === 'user') {\n                yield user\n            }\n        }\n    }\n\n    if ('chats' in obj && Array.isArray(obj.chats) && obj.chats.length) {\n        for (const chat of obj.chats) {\n            // .chats is sometimes number[]\n            if (typeof chat === 'object') {\n                switch (chat._) {\n                    case 'chat':\n                    case 'channel':\n                    case 'chatForbidden':\n                    case 'channelForbidden':\n                        yield chat\n                        break\n                }\n            }\n        }\n    }\n}\n"]}

package/cjs/utils/platform/crypto.d.ts

@@ -0,0 +1 @@
+export {};

package/cjs/utils/platform/crypto.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._defaultCryptoProviderFactory = void 0;
+const node_crypto_js_1 = require("../crypto/node-crypto.js");
+/** @internal */
+const _defaultCryptoProviderFactory = () => new node_crypto_js_1.NodeCryptoProvider();
+exports._defaultCryptoProviderFactory = _defaultCryptoProviderFactory;
+//# sourceMappingURL=crypto.js.map

package/cjs/utils/platform/crypto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.js","sourceRoot":"","sources":["../../../../src/utils/platform/crypto.ts"],"names":[],"mappings":";;;AAAA,6DAA6D;AAE7D,gBAAgB;AACT,MAAM,6BAA6B,GAAG,GAAG,EAAE,CAAC,IAAI,mCAAkB,EAAE,CAAA;AAA9D,QAAA,6BAA6B,iCAAiC","sourcesContent":["import { NodeCryptoProvider } from '../crypto/node-crypto.js'\n\n/** @internal */\nexport const _defaultCryptoProviderFactory = () => new NodeCryptoProvider()\n"]}

package/cjs/utils/platform/crypto.web.d.ts

@@ -0,0 +1 @@
+export {};

package/cjs/utils/platform/crypto.web.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._defaultCryptoProviderFactory = void 0;
+const index_js_1 = require("../../index.js");
+const subtle_js_1 = require("../crypto/subtle.js");
+/** @internal */
+const _defaultCryptoProviderFactory = () => {
+    if (typeof crypto === 'undefined' || typeof crypto.subtle === 'undefined') {
+        throw new index_js_1.MtUnsupportedError('WebCrypto API is not available');
+    }
+    return new subtle_js_1.SubtleCryptoProvider(crypto.subtle);
+};
+exports._defaultCryptoProviderFactory = _defaultCryptoProviderFactory;
+//# sourceMappingURL=crypto.web.js.map

package/cjs/utils/platform/crypto.web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.web.js","sourceRoot":"","sources":["../../../../src/utils/platform/crypto.web.ts"],"names":[],"mappings":";;;AAAA,6CAAmD;AACnD,mDAA0D;AAE1D,gBAAgB;AACT,MAAM,6BAA6B,GAAG,GAAG,EAAE;IAC9C,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE;QACvE,MAAM,IAAI,6BAAkB,CAAC,gCAAgC,CAAC,CAAA;KACjE;IAED,OAAO,IAAI,gCAAoB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;AAClD,CAAC,CAAA;AANY,QAAA,6BAA6B,iCAMzC","sourcesContent":["import { MtUnsupportedError } from '../../index.js'\nimport { SubtleCryptoProvider } from '../crypto/subtle.js'\n\n/** @internal */\nexport const _defaultCryptoProviderFactory = () => {\n    if (typeof crypto === 'undefined' || typeof crypto.subtle === 'undefined') {\n        throw new MtUnsupportedError('WebCrypto API is not available')\n    }\n\n    return new SubtleCryptoProvider(crypto.subtle)\n}\n"]}

package/cjs/utils/platform/error-reporting.d.ts

@@ -0,0 +1,3 @@
+import { tl } from '@mtcute/tl';
+import { Logger } from '../logger.js';
+export declare function reportUnknownError(log: Logger, error: tl.RpcError, method: string): void;

package/cjs/utils/platform/error-reporting.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reportUnknownError = void 0;
+function reportUnknownError(log, error, method) {
+    if (typeof fetch !== 'function')
+        return;
+    fetch(`https://rpc.pwrtelegram.xyz/?code=${error.code}&method=${method}&error=${error.text}`)
+        .then((r) => r.json())
+        .then((r) => {
+        if (r.ok) {
+            log.info('telerpc responded with error info for %s: %s', error.text, r.result);
+        }
+        else {
+            log.info('Reported error %s to telerpc. You can disable this using `enableErrorReporting: false`', error.text);
+        }
+    })
+        .catch((e) => {
+        log.debug('failed to report error %s to telerpc: %s', error.text, e);
+    });
+}
+exports.reportUnknownError = reportUnknownError;
+//# sourceMappingURL=error-reporting.js.map

package/cjs/utils/platform/error-reporting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-reporting.js","sourceRoot":"","sources":["../../../../src/utils/platform/error-reporting.ts"],"names":[],"mappings":";;;AAIA,SAAgB,kBAAkB,CAAC,GAAW,EAAE,KAAkB,EAAE,MAAc;IAC9E,IAAI,OAAO,KAAK,KAAK,UAAU;QAAE,OAAM;IAEvC,KAAK,CAAC,qCAAqC,KAAK,CAAC,IAAI,WAAW,MAAM,UAAU,KAAK,CAAC,IAAI,EAAE,CAAC;SACxF,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACrB,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;QACR,IAAI,CAAC,CAAC,EAAE,EAAE;YACN,GAAG,CAAC,IAAI,CAAC,8CAA8C,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAA;SACjF;aAAM;YACH,GAAG,CAAC,IAAI,CACJ,wFAAwF,EACxF,KAAK,CAAC,IAAI,CACb,CAAA;SACJ;IACL,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,GAAG,CAAC,KAAK,CAAC,0CAA0C,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;IACxE,CAAC,CAAC,CAAA;AACV,CAAC;AAlBD,gDAkBC","sourcesContent":["import { tl } from '@mtcute/tl'\n\nimport { Logger } from '../logger.js'\n\nexport function reportUnknownError(log: Logger, error: tl.RpcError, method: string): void {\n    if (typeof fetch !== 'function') return\n\n    fetch(`https://rpc.pwrtelegram.xyz/?code=${error.code}&method=${method}&error=${error.text}`)\n        .then((r) => r.json())\n        .then((r) => {\n            if (r.ok) {\n                log.info('telerpc responded with error info for %s: %s', error.text, r.result)\n            } else {\n                log.info(\n                    'Reported error %s to telerpc. You can disable this using `enableErrorReporting: false`',\n                    error.text,\n                )\n            }\n        })\n        .catch((e) => {\n            log.debug('failed to report error %s to telerpc: %s', error.text, e)\n        })\n}\n"]}

package/cjs/utils/platform/logging.d.ts

@@ -0,0 +1 @@
+export {};

package/cjs/utils/platform/logging.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._defaultLoggingHandler = void 0;
+const tty_1 = require("tty");
+const isTty = (0, tty_1.isatty)(process.stdout.fd);
+const BASE_FORMAT = isTty ? '%s [%s] [%s%s\x1b[0m] ' : '%s [%s] [%s] ';
+const LEVEL_NAMES = isTty ?
+    [
+        '',
+        '\x1b[31mERR\x1b[0m',
+        '\x1b[33mWRN\x1b[0m',
+        '\x1b[34mINF\x1b[0m',
+        '\x1b[36mDBG\x1b[0m',
+        '\x1b[35mVRB\x1b[0m',
+    ] :
+    [
+        '',
+        'ERR',
+        'WRN',
+        'INF',
+        'DBG',
+        'VRB',
+    ];
+const TAG_COLORS = [6, 2, 3, 4, 5, 1].map((i) => `\x1b[3${i};1m`);
+/** @internal */
+exports._defaultLoggingHandler = isTty ?
+    (color, level, tag, fmt, args) => {
+        // eslint-disable-next-line no-console
+        console.log(BASE_FORMAT + fmt, new Date().toISOString(), LEVEL_NAMES[level], TAG_COLORS[color], tag, ...args);
+    } :
+    (color, level, tag, fmt, args) => {
+        // eslint-disable-next-line no-console
+        console.log(BASE_FORMAT + fmt, new Date().toISOString(), LEVEL_NAMES[level], tag, ...args);
+    };
+//# sourceMappingURL=logging.js.map

package/cjs/utils/platform/logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../../../../src/utils/platform/logging.ts"],"names":[],"mappings":";;;AAAA,6BAA4B;AAE5B,MAAM,KAAK,GAAG,IAAA,YAAM,EAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;AAEvC,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,eAAe,CAAA;AACtE,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC;IACvB;QACI,EAAE;QACF,oBAAoB;QACpB,oBAAoB;QACpB,oBAAoB;QACpB,oBAAoB;QACpB,oBAAoB;KACvB,CAAC,CAAC;IACH;QACI,EAAE;QACF,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;KACR,CAAA;AACL,MAAM,UAAU,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;AAEjE,gBAAgB;AACH,QAAA,sBAAsB,GAAG,KAAK,CAAC,CAAC;IACzC,CAAC,KAAa,EAAE,KAAa,EAAE,GAAW,EAAE,GAAW,EAAE,IAAe,EAAQ,EAAE;QAC9E,sCAAsC;QACtC,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,GAAG,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAA;IACjH,CAAC,CAAC,CAAC;IACH,CAAC,KAAa,EAAE,KAAa,EAAE,GAAW,EAAE,GAAW,EAAE,IAAe,EAAQ,EAAE;QAC9E,sCAAsC;QACtC,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,GAAG,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAA;IAC9F,CAAC,CAAA","sourcesContent":["import { isatty } from 'tty'\n\nconst isTty = isatty(process.stdout.fd)\n\nconst BASE_FORMAT = isTty ? '%s [%s] [%s%s\\x1b[0m] ' : '%s [%s] [%s] '\nconst LEVEL_NAMES = isTty ?\n    [\n        '', // OFF\n        '\\x1b[31mERR\\x1b[0m',\n        '\\x1b[33mWRN\\x1b[0m',\n        '\\x1b[34mINF\\x1b[0m',\n        '\\x1b[36mDBG\\x1b[0m',\n        '\\x1b[35mVRB\\x1b[0m',\n    ] :\n    [\n        '', // OFF\n        'ERR',\n        'WRN',\n        'INF',\n        'DBG',\n        'VRB',\n    ]\nconst TAG_COLORS = [6, 2, 3, 4, 5, 1].map((i) => `\\x1b[3${i};1m`)\n\n/** @internal */\nexport const _defaultLoggingHandler = isTty ?\n    (color: number, level: number, tag: string, fmt: string, args: unknown[]): void => {\n        // eslint-disable-next-line no-console\n        console.log(BASE_FORMAT + fmt, new Date().toISOString(), LEVEL_NAMES[level], TAG_COLORS[color], tag, ...args)\n    } :\n    (color: number, level: number, tag: string, fmt: string, args: unknown[]): void => {\n        // eslint-disable-next-line no-console\n        console.log(BASE_FORMAT + fmt, new Date().toISOString(), LEVEL_NAMES[level], tag, ...args)\n    }\n"]}

package/cjs/utils/platform/logging.web.d.ts

@@ -0,0 +1 @@
+export {};

package/cjs/utils/platform/logging.web.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._defaultLoggingHandler = void 0;
+const BASE_FORMAT = '%s [%c%s%c] [%c%s%c] ';
+const LEVEL_NAMES = [
+    '',
+    'ERR',
+    'WRN',
+    'INF',
+    'DBG',
+    'VRB',
+];
+const COLORS = [
+    '',
+    'color: #7a5f9d',
+    'color: #8d7041',
+    'color: #396c9e',
+    'color: #437761',
+    'color: #7a5f9d',
+];
+const TAG_COLORS = [
+    'color: #437761',
+    'color: #537a36',
+    'color: #8d7041',
+    'color: #396c9e',
+    'color: #7a5f9d',
+    'color: #7a5f9d',
+];
+/** @internal */
+const _defaultLoggingHandler = (color, level, tag, fmt, args) => {
+    // eslint-disable-next-line no-console
+    console.log(BASE_FORMAT + fmt, new Date().toISOString(), COLORS[level], LEVEL_NAMES[level], '', TAG_COLORS[color], tag, '', ...args);
+};
+exports._defaultLoggingHandler = _defaultLoggingHandler;
+//# sourceMappingURL=logging.web.js.map

package/cjs/utils/platform/logging.web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.web.js","sourceRoot":"","sources":["../../../../src/utils/platform/logging.web.ts"],"names":[],"mappings":";;;AAAA,MAAM,WAAW,GAAG,uBAAuB,CAAA;AAC3C,MAAM,WAAW,GAAG;IAChB,EAAE;IACF,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;CACR,CAAA;AACD,MAAM,MAAM,GAAG;IACX,EAAE;IACF,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;CACnB,CAAA;AACD,MAAM,UAAU,GAAG;IACf,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;CACnB,CAAA;AAED,gBAAgB;AACT,MAAM,sBAAsB,GAAG,CAClC,KAAa,EACb,KAAa,EACb,GAAW,EACX,GAAW,EACX,IAAe,EACX,EAAE;IACN,sCAAsC;IACtC,OAAO,CAAC,GAAG,CACP,WAAW,GAAG,GAAG,EACjB,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EACxB,MAAM,CAAC,KAAK,CAAC,EACb,WAAW,CAAC,KAAK,CAAC,EAClB,EAAE,EACF,UAAU,CAAC,KAAK,CAAC,EACjB,GAAG,EACH,EAAE,EACF,GAAG,IAAI,CACV,CAAA;AACL,CAAC,CAAA;AAnBY,QAAA,sBAAsB,0BAmBlC","sourcesContent":["const BASE_FORMAT = '%s [%c%s%c] [%c%s%c] '\nconst LEVEL_NAMES = [\n    '', // OFF\n    'ERR',\n    'WRN',\n    'INF',\n    'DBG',\n    'VRB',\n]\nconst COLORS = [\n    '', // OFF\n    'color: #7a5f9d',\n    'color: #8d7041',\n    'color: #396c9e',\n    'color: #437761',\n    'color: #7a5f9d',\n]\nconst TAG_COLORS = [\n    'color: #437761',\n    'color: #537a36',\n    'color: #8d7041',\n    'color: #396c9e',\n    'color: #7a5f9d',\n    'color: #7a5f9d',\n]\n\n/** @internal */\nexport const _defaultLoggingHandler = (\n    color: number,\n    level: number,\n    tag: string,\n    fmt: string,\n    args: unknown[],\n): void => {\n    // eslint-disable-next-line no-console\n    console.log(\n        BASE_FORMAT + fmt,\n        new Date().toISOString(),\n        COLORS[level],\n        LEVEL_NAMES[level],\n        '',\n        TAG_COLORS[color],\n        tag,\n        '',\n        ...args,\n    )\n}\n"]}

package/cjs/utils/platform/random.d.ts

@@ -0,0 +1 @@
+export declare const _randomBytes: (size: number) => Uint8Array;

package/cjs/utils/platform/random.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._randomBytes = void 0;
+// eslint-disable-next-line no-restricted-imports
+const crypto_1 = require("crypto");
+exports._randomBytes = crypto_1.randomBytes;
+//# sourceMappingURL=random.js.map

package/cjs/utils/platform/random.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.js","sourceRoot":"","sources":["../../../../src/utils/platform/random.ts"],"names":[],"mappings":";;;AAAA,iDAAiD;AACjD,mCAAoC;AAEvB,QAAA,YAAY,GAAG,oBAA2C,CAAA","sourcesContent":["// eslint-disable-next-line no-restricted-imports\nimport { randomBytes } from 'crypto'\n\nexport const _randomBytes = randomBytes as (size: number) => Uint8Array\n"]}

package/cjs/utils/platform/random.web.d.ts

@@ -0,0 +1 @@
+export declare function _randomBytes(size: number): Uint8Array;

package/cjs/utils/platform/random.web.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._randomBytes = void 0;
+function _randomBytes(size) {
+    const ret = new Uint8Array(size);
+    crypto.getRandomValues(ret);
+    return ret;
+}
+exports._randomBytes = _randomBytes;
+//# sourceMappingURL=random.web.js.map

package/cjs/utils/platform/random.web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.web.js","sourceRoot":"","sources":["../../../../src/utils/platform/random.web.ts"],"names":[],"mappings":";;;AAAA,SAAgB,YAAY,CAAC,IAAY;IACrC,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAA;IAChC,MAAM,CAAC,eAAe,CAAC,GAAG,CAAC,CAAA;IAE3B,OAAO,GAAG,CAAA;AACd,CAAC;AALD,oCAKC","sourcesContent":["export function _randomBytes(size: number): Uint8Array {\n    const ret = new Uint8Array(size)\n    crypto.getRandomValues(ret)\n\n    return ret\n}\n"]}

package/cjs/utils/platform/transport.d.ts

@@ -0,0 +1 @@
+export {};

package/cjs/utils/platform/transport.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._defaultTransportFactory = void 0;
+const tcp_js_1 = require("../../network/transports/tcp.js");
+/** @internal */
+const _defaultTransportFactory = () => new tcp_js_1.TcpTransport();
+exports._defaultTransportFactory = _defaultTransportFactory;
+//# sourceMappingURL=transport.js.map

package/cjs/utils/platform/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../../../src/utils/platform/transport.ts"],"names":[],"mappings":";;;AAAA,4DAA8D;AAE9D,gBAAgB;AACT,MAAM,wBAAwB,GAAG,GAAG,EAAE,CAAC,IAAI,qBAAY,EAAE,CAAA;AAAnD,QAAA,wBAAwB,4BAA2B","sourcesContent":["import { TcpTransport } from '../../network/transports/tcp.js'\n\n/** @internal */\nexport const _defaultTransportFactory = () => new TcpTransport()\n"]}

package/cjs/utils/platform/transport.web.d.ts

@@ -0,0 +1 @@
+export {};

package/cjs/utils/platform/transport.web.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._defaultTransportFactory = void 0;
+const websocket_js_1 = require("../../network/transports/websocket.js");
+const index_js_1 = require("../../types/index.js");
+/** @internal */
+exports._defaultTransportFactory = 
+// if no websocket, throw an error i guess ¯\_(ツ)_/¯
+// (user can still implement something on their own)
+typeof WebSocket === 'undefined' ?
+    () => {
+        throw new index_js_1.MtUnsupportedError('Neither TCP nor WebSocket are available. Please pass a Transport factory explicitly');
+    } :
+    () => new websocket_js_1.WebSocketTransport();
+//# sourceMappingURL=transport.web.js.map

package/cjs/utils/platform/transport.web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.web.js","sourceRoot":"","sources":["../../../../src/utils/platform/transport.web.ts"],"names":[],"mappings":";;;AAAA,wEAA0E;AAC1E,mDAAyD;AAEzD,gBAAgB;AACH,QAAA,wBAAwB;AACjC,oDAAoD;AACpD,oDAAoD;AACpD,OAAO,SAAS,KAAK,WAAW,CAAC,CAAC;IAC9B,GAAG,EAAE;QACD,MAAM,IAAI,6BAAkB,CACxB,qFAAqF,CACxF,CAAA;IACL,CAAC,CAAC,CAAC;IACH,GAAG,EAAE,CAAC,IAAI,iCAAkB,EAAE,CAAA","sourcesContent":["import { WebSocketTransport } from '../../network/transports/websocket.js'\nimport { MtUnsupportedError } from '../../types/index.js'\n\n/** @internal */\nexport const _defaultTransportFactory =\n    // if no websocket, throw an error i guess ¯\\_(ツ)_/¯\n    // (user can still implement something on their own)\n    typeof WebSocket === 'undefined' ?\n        () => {\n            throw new MtUnsupportedError(\n                'Neither TCP nor WebSocket are available. Please pass a Transport factory explicitly',\n            )\n        } :\n        () => new WebSocketTransport()\n"]}

package/cjs/utils/sorted-array.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Array that adds elements in sorted order.
+ *
+ * Comparator is always called like: comparator(itemFromSortedArray, yourItem)
+ */
+export declare class SortedArray<T> {
+    readonly comparator: (a: T, b: T) => number;
+    readonly raw: T[];
+    constructor(array: T[] | undefined, comparator: (a: T, b: T) => number);
+    get length(): number;
+    insert(item: T | T[]): number;
+    index(item: T, closest?: boolean): number;
+    remove(item: T): void;
+    includes(item: T): boolean;
+    find(item: T): T | null;
+    clear(): void;
+}

package/cjs/utils/sorted-array.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SortedArray = void 0;
+/**
+ * Array that adds elements in sorted order.
+ *
+ * Comparator is always called like: comparator(itemFromSortedArray, yourItem)
+ */
+class SortedArray {
+    constructor(array = [], comparator) {
+        this.comparator = comparator;
+        this.raw = array.sort(comparator);
+        this.comparator = comparator;
+    }
+    get length() {
+        return this.raw.length;
+    }
+    insert(item) {
+        if (Array.isArray(item)) {
+            let ind = -1;
+            item.forEach((it) => {
+                ind = this.insert(it);
+            });
+            return ind;
+        }
+        if (this.raw.length === 0) {
+            this.raw.push(item);
+            return 0;
+        }
+        // find insert position
+        let lo = 0;
+        let hi = this.raw.length;
+        while (lo < hi) {
+            const mid = Math.floor((lo + hi) / 2);
+            if (this.comparator(this.raw[mid], item) > 0) {
+                hi = mid;
+            }
+            else {
+                lo = mid + 1;
+            }
+        }
+        this.raw.splice(lo, 0, item);
+        return lo;
+    }
+    // closest: return the closest value (right-hand side)
+    // meaning that raw[idx - 1] <= item <= raw[idx]
+    index(item, closest = false) {
+        let lo = 0;
+        let hi = this.raw.length;
+        while (lo < hi) {
+            const mid = Math.floor((lo + hi) / 2);
+            const cmp = this.comparator(this.raw[mid], item);
+            if (cmp === 0) {
+                return mid;
+            }
+            if (cmp > 0) {
+                hi = mid;
+            }
+            else {
+                lo = mid + 1;
+            }
+        }
+        return closest ? lo : -1;
+    }
+    remove(item) {
+        const idx = this.index(item);
+        if (idx === -1)
+            return;
+        this.raw.splice(idx, 1);
+    }
+    includes(item) {
+        return this.index(item) !== -1;
+    }
+    find(item) {
+        const ind = this.index(item);
+        return ind === -1 ? null : this.raw[ind];
+    }
+    clear() {
+        this.raw.length = 0;
+    }
+}
+exports.SortedArray = SortedArray;
+//# sourceMappingURL=sorted-array.js.map

package/cjs/utils/sorted-array.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sorted-array.js","sourceRoot":"","sources":["../../../src/utils/sorted-array.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Array that adds elements in sorted order.\n *\n * Comparator is always called like: comparator(itemFromSortedArray, yourItem)\n */\nexport class SortedArray<T> {\n    readonly raw: T[]\n\n    constructor(\n        array: T[] = [],\n        readonly comparator: (a: T, b: T) => number,\n    ) {\n        this.raw = array.sort(comparator)\n        this.comparator = comparator\n    }\n\n    get length(): number {\n        return this.raw.length\n    }\n\n    insert(item: T | T[]): number {\n        if (Array.isArray(item)) {\n            let ind = -1\n            item.forEach((it) => {\n                ind = this.insert(it)\n            })\n\n            return ind\n        }\n\n        if (this.raw.length === 0) {\n            this.raw.push(item)\n\n            return 0\n        }\n\n        // find insert position\n        let lo = 0\n        let hi = this.raw.length\n\n        while (lo < hi) {\n            const mid = Math.floor((lo + hi) / 2)\n\n            if (this.comparator(this.raw[mid], item) > 0) {\n                hi = mid\n            } else {\n                lo = mid + 1\n            }\n        }\n\n        this.raw.splice(lo, 0, item)\n\n        return lo\n    }\n\n    // closest: return the closest value (right-hand side)\n    // meaning that raw[idx - 1] <= item <= raw[idx]\n    index(item: T, closest = false): number {\n        let lo = 0\n        let hi = this.raw.length\n\n        while (lo < hi) {\n            const mid = Math.floor((lo + hi) / 2)\n            const cmp = this.comparator(this.raw[mid], item)\n\n            if (cmp === 0) {\n                return mid\n            }\n            if (cmp > 0) {\n                hi = mid\n            } else {\n                lo = mid + 1\n            }\n        }\n\n        return closest ? lo : -1\n    }\n\n    remove(item: T): void {\n        const idx = this.index(item)\n        if (idx === -1) return\n\n        this.raw.splice(idx, 1)\n    }\n\n    includes(item: T): boolean {\n        return this.index(item) !== -1\n    }\n\n    find(item: T): T | null {\n        const ind = this.index(item)\n\n        return ind === -1 ? null : this.raw[ind]\n    }\n\n    clear(): void {\n        this.raw.length = 0\n    }\n}\n"]}

package/cjs/utils/string-session.d.ts

@@ -0,0 +1,11 @@
+import { TlReaderMap, TlWriterMap } from '@mtcute/tl-runtime';
+import { ITelegramStorage } from '../storage/index.js';
+export interface StringSessionData {
+    version: number;
+    testMode: boolean;
+    primaryDcs: ITelegramStorage.DcOptions;
+    self?: ITelegramStorage.SelfInfo | null;
+    authKey: Uint8Array;
+}
+export declare function writeStringSession(writerMap: TlWriterMap, data: StringSessionData): string;
+export declare function readStringSession(readerMap: TlReaderMap, data: string): StringSessionData;

package/cjs/utils/string-session.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readStringSession = exports.writeStringSession = void 0;
+const tl_runtime_1 = require("@mtcute/tl-runtime");
+const index_js_1 = require("../types/index.js");
+function writeStringSession(writerMap, data) {
+    const writer = tl_runtime_1.TlBinaryWriter.alloc(writerMap, 512);
+    const version = data.version;
+    if (version !== 1 && version !== 2) {
+        throw new index_js_1.MtArgumentError(`Unsupported string session version: ${version}`);
+    }
+    let flags = 0;
+    if (data.self) {
+        flags |= 1;
+    }
+    if (data.testMode) {
+        flags |= 2;
+    }
+    writer.uint8View[0] = version;
+    writer.pos += 1;
+    writer.int(flags);
+    writer.object(data.primaryDcs.main);
+    if (version >= 2 && data.primaryDcs.media !== data.primaryDcs.main) {
+        flags |= 4;
+        writer.object(data.primaryDcs.media);
+    }
+    if (data.self) {
+        writer.int53(data.self.userId);
+        writer.boolean(data.self.isBot);
+    }
+    writer.bytes(data.authKey);
+    return (0, tl_runtime_1.base64Encode)(writer.result(), true);
+}
+exports.writeStringSession = writeStringSession;
+function readStringSession(readerMap, data) {
+    const buf = (0, tl_runtime_1.base64DecodeToBuffer)(data, true);
+    const version = buf[0];
+    if (version !== 1 && version !== 2) {
+        throw new Error(`Invalid session string (version = ${version})`);
+    }
+    const reader = new tl_runtime_1.TlBinaryReader(readerMap, buf, 1);
+    const flags = reader.int();
+    const hasSelf = flags & 1;
+    const testMode = Boolean(flags & 2);
+    const hasMedia = version >= 2 && Boolean(flags & 4);
+    const primaryDc = reader.object();
+    const primaryMediaDc = hasMedia ? reader.object() : primaryDc;
+    if (primaryDc._ !== 'dcOption') {
+        throw new index_js_1.MtArgumentError(`Invalid session string (dc._ = ${primaryDc._})`);
+    }
+    let self = null;
+    if (hasSelf) {
+        const selfId = reader.int53();
+        const selfBot = reader.boolean();
+        self = {
+            userId: selfId,
+            isBot: selfBot,
+        };
+    }
+    const key = reader.bytes();
+    return {
+        version: 1,
+        testMode,
+        primaryDcs: {
+            main: primaryDc,
+            media: primaryMediaDc,
+        },
+        self,
+        authKey: key,
+    };
+}
+exports.readStringSession = readStringSession;
+//# sourceMappingURL=string-session.js.map

package/cjs/utils/string-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-session.js","sourceRoot":"","sources":["../../../src/utils/string-session.ts"],"names":[],"mappings":"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","sourcesContent":["import { tl } from '@mtcute/tl'\nimport {\n    base64DecodeToBuffer,\n    base64Encode,\n    TlBinaryReader,\n    TlBinaryWriter,\n    TlReaderMap,\n    TlWriterMap,\n} from '@mtcute/tl-runtime'\n\nimport { ITelegramStorage } from '../storage/index.js'\nimport { MtArgumentError } from '../types/index.js'\n\nexport interface StringSessionData {\n    version: number\n    testMode: boolean\n    primaryDcs: ITelegramStorage.DcOptions\n    self?: ITelegramStorage.SelfInfo | null\n    authKey: Uint8Array\n}\n\nexport function writeStringSession(writerMap: TlWriterMap, data: StringSessionData): string {\n    const writer = TlBinaryWriter.alloc(writerMap, 512)\n\n    const version = data.version\n\n    if (version !== 1 && version !== 2) {\n        throw new MtArgumentError(`Unsupported string session version: ${version}`)\n    }\n\n    let flags = 0\n\n    if (data.self) {\n        flags |= 1\n    }\n\n    if (data.testMode) {\n        flags |= 2\n    }\n\n    writer.uint8View[0] = version\n    writer.pos += 1\n\n    writer.int(flags)\n    writer.object(data.primaryDcs.main)\n\n    if (version >= 2 && data.primaryDcs.media !== data.primaryDcs.main) {\n        flags |= 4\n        writer.object(data.primaryDcs.media)\n    }\n\n    if (data.self) {\n        writer.int53(data.self.userId)\n        writer.boolean(data.self.isBot)\n    }\n\n    writer.bytes(data.authKey)\n\n    return base64Encode(writer.result(), true)\n}\n\nexport function readStringSession(readerMap: TlReaderMap, data: string): StringSessionData {\n    const buf = base64DecodeToBuffer(data, true)\n\n    const version = buf[0]\n\n    if (version !== 1 && version !== 2) {\n        throw new Error(`Invalid session string (version = ${version})`)\n    }\n\n    const reader = new TlBinaryReader(readerMap, buf, 1)\n\n    const flags = reader.int()\n    const hasSelf = flags & 1\n    const testMode = Boolean(flags & 2)\n    const hasMedia = version >= 2 && Boolean(flags & 4)\n\n    const primaryDc = reader.object() as tl.TypeDcOption\n    const primaryMediaDc = hasMedia ? (reader.object() as tl.TypeDcOption) : primaryDc\n\n    if (primaryDc._ !== 'dcOption') {\n        throw new MtArgumentError(`Invalid session string (dc._ = ${primaryDc._})`)\n    }\n\n    let self: ITelegramStorage.SelfInfo | null = null\n\n    if (hasSelf) {\n        const selfId = reader.int53()\n        const selfBot = reader.boolean()\n\n        self = {\n            userId: selfId,\n            isBot: selfBot,\n        }\n    }\n\n    const key = reader.bytes()\n\n    return {\n        version: 1,\n        testMode,\n        primaryDcs: {\n            main: primaryDc,\n            media: primaryMediaDc,\n        },\n        self,\n        authKey: key,\n    }\n}\n"]}

package/cjs/utils/tl-json.d.ts

@@ -0,0 +1,13 @@
+import { tl } from '@mtcute/tl';
+/**
+ * Convert a JS object to TL JSON
+ *
+ * @param obj  Object to be converted
+ */
+export declare function jsonToTlJson(obj: unknown): tl.TypeJSONValue;
+/**
+ * Convert TL JSON object to plain JS object
+ *
+ * @param obj  TL JSON object to convert
+ */
+export declare function tlJsonToJson(obj: tl.TypeJSONValue): unknown;

package/cjs/utils/tl-json.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tlJsonToJson = exports.jsonToTlJson = void 0;
+const errors_js_1 = require("../types/errors.js");
+/**
+ * Convert a JS object to TL JSON
+ *
+ * @param obj  Object to be converted
+ */
+function jsonToTlJson(obj) {
+    if (obj === null || obj === undefined)
+        return { _: 'jsonNull' };
+    if (typeof obj === 'boolean')
+        return { _: 'jsonBool', value: obj };
+    if (typeof obj === 'number')
+        return { _: 'jsonNumber', value: obj };
+    if (typeof obj === 'string')
+        return { _: 'jsonString', value: obj };
+    if (Array.isArray(obj)) {
+        return { _: 'jsonArray', value: obj.map(jsonToTlJson) };
+    }
+    if (typeof obj !== 'object') {
+        throw new errors_js_1.MtArgumentError(`Unsupported type: ${typeof obj}`);
+    }
+    const items = [];
+    Object.entries(obj).forEach(([key, value]) => {
+        items.push({
+            _: 'jsonObjectValue',
+            key,
+            value: jsonToTlJson(value),
+        });
+    });
+    return {
+        _: 'jsonObject',
+        value: items,
+    };
+}
+exports.jsonToTlJson = jsonToTlJson;
+/**
+ * Convert TL JSON object to plain JS object
+ *
+ * @param obj  TL JSON object to convert
+ */
+function tlJsonToJson(obj) {
+    switch (obj._) {
+        case 'jsonNull':
+            return null;
+        case 'jsonBool':
+        case 'jsonNumber':
+        case 'jsonString':
+            return obj.value;
+        case 'jsonArray':
+            return obj.value.map(tlJsonToJson);
+    }
+    const ret = {};
+    obj.value.forEach((item) => {
+        ret[item.key] = tlJsonToJson(item.value);
+    });
+    return ret;
+}
+exports.tlJsonToJson = tlJsonToJson;
+//# sourceMappingURL=tl-json.js.map

package/cjs/utils/tl-json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tl-json.js","sourceRoot":"","sources":["../../../src/utils/tl-json.ts"],"names":[],"mappings":";;;AAEA,kDAAoD;AAEpD;;;;GAIG;AAEH,SAAgB,YAAY,CAAC,GAAY;IACrC,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,CAAA;IAC/D,IAAI,OAAO,GAAG,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,EAAE,CAAA;IAClE,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,EAAE,CAAA;IACnE,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,EAAE,CAAA;IAEnE,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;QACpB,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAA;KAC1D;IAED,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE;QACzB,MAAM,IAAI,2BAAe,CAAC,qBAAqB,OAAO,GAAG,EAAE,CAAC,CAAA;KAC/D;IAED,MAAM,KAAK,GAA6B,EAAE,CAAA;IAE1C,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QACzC,KAAK,CAAC,IAAI,CAAC;YACP,CAAC,EAAE,iBAAiB;YACpB,GAAG;YACH,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC;SAC7B,CAAC,CAAA;IACN,CAAC,CAAC,CAAA;IAEF,OAAO;QACH,CAAC,EAAE,YAAY;QACf,KAAK,EAAE,KAAK;KACf,CAAA;AACL,CAAC;AA5BD,oCA4BC;AAED;;;;GAIG;AACH,SAAgB,YAAY,CAAC,GAAqB;IAC9C,QAAQ,GAAG,CAAC,CAAC,EAAE;QACX,KAAK,UAAU;YACX,OAAO,IAAI,CAAA;QACf,KAAK,UAAU,CAAC;QAChB,KAAK,YAAY,CAAC;QAClB,KAAK,YAAY;YACb,OAAO,GAAG,CAAC,KAAK,CAAA;QACpB,KAAK,WAAW;YACZ,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;KACzC;IAED,MAAM,GAAG,GAA4B,EAAE,CAAA;IAEvC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QACvB,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC5C,CAAC,CAAC,CAAA;IAEF,OAAO,GAAG,CAAA;AACd,CAAC;AAnBD,oCAmBC","sourcesContent":["import { tl } from '@mtcute/tl'\n\nimport { MtArgumentError } from '../types/errors.js'\n\n/**\n * Convert a JS object to TL JSON\n *\n * @param obj  Object to be converted\n */\n\nexport function jsonToTlJson(obj: unknown): tl.TypeJSONValue {\n    if (obj === null || obj === undefined) return { _: 'jsonNull' }\n    if (typeof obj === 'boolean') return { _: 'jsonBool', value: obj }\n    if (typeof obj === 'number') return { _: 'jsonNumber', value: obj }\n    if (typeof obj === 'string') return { _: 'jsonString', value: obj }\n\n    if (Array.isArray(obj)) {\n        return { _: 'jsonArray', value: obj.map(jsonToTlJson) }\n    }\n\n    if (typeof obj !== 'object') {\n        throw new MtArgumentError(`Unsupported type: ${typeof obj}`)\n    }\n\n    const items: tl.TypeJSONObjectValue[] = []\n\n    Object.entries(obj).forEach(([key, value]) => {\n        items.push({\n            _: 'jsonObjectValue',\n            key,\n            value: jsonToTlJson(value),\n        })\n    })\n\n    return {\n        _: 'jsonObject',\n        value: items,\n    }\n}\n\n/**\n * Convert TL JSON object to plain JS object\n *\n * @param obj  TL JSON object to convert\n */\nexport function tlJsonToJson(obj: tl.TypeJSONValue): unknown {\n    switch (obj._) {\n        case 'jsonNull':\n            return null\n        case 'jsonBool':\n        case 'jsonNumber':\n        case 'jsonString':\n            return obj.value\n        case 'jsonArray':\n            return obj.value.map(tlJsonToJson)\n    }\n\n    const ret: Record<string, unknown> = {}\n\n    obj.value.forEach((item) => {\n        ret[item.key] = tlJsonToJson(item.value)\n    })\n\n    return ret\n}\n"]}

package/cjs/utils/type-assertions.d.ts

@@ -0,0 +1,37 @@
+import { mtp, tl } from '@mtcute/tl';
+export declare function isPresent<T>(t: T | undefined | null | void): t is T;
+/**
+ * Returns a function that can be used to filter down objects
+ * to the ones that have a defined non-null value under the key `k`.
+ *
+ * @example
+ * ```ts
+ * const filesWithUrl = files.filter(file => file.url);
+ * files[0].url // In this case, TS might still treat this as undefined/null
+ *
+ * const filesWithUrl = files.filter(hasPresentKey("url"));
+ * files[0].url // TS will know that this is present
+ * ```
+ */
+export declare function hasPresentKey<K extends string | number | symbol>(k: K): <T, V>(a: T & { [k in K]?: V | null | undefined; }) => a is T & { [k_1 in K]: V; };
+/**
+ * Returns a function that can be used to filter down objects
+ * to the ones that have a specific value V under a key `k`.
+ *
+ * @example
+ * ```ts
+ * type File = { type: "image", imageUrl: string } | { type: "pdf", pdfUrl: string };
+ * const files: File[] = [];
+ *
+ * const imageFiles = files.filter(file => file.type === "image");
+ * files[0].type // In this case, TS will still treat it  as `"image" | "pdf"`
+ *
+ * const filesWithUrl = files.filter(hasValueKey("type", "image" as const));
+ * files[0].type // TS will now know that this is "image"
+ * files[0].imageUrl // TS will know this is present, because already it excluded the other union members.
+ * ```
+ */
+export declare function hasValueAtKey<const K extends string | number | symbol, const V>(k: K, v: V): <T>(a: T & { [k in K]: unknown; }) => a is T & { [k_1 in K]: V; };
+export declare function assertTypeIs<T extends tl.TlObject, K extends T['_']>(context: string, obj: T, expected: K): asserts obj is tl.FindByName<T, K>;
+export declare function assertTypeIsNot<T extends tl.TlObject, K extends T['_']>(context: string, obj: T, expectedNot: K): asserts obj is Exclude<T, tl.FindByName<T, K>>;
+export declare function mtpAssertTypeIs<T extends mtp.TlObject, K extends T['_']>(context: string, obj: T, expected: K): asserts obj is mtp.FindByName<T, K>;