@mtcute/core 0.5.0 → 0.7.0

package/esm/highlevel/utils/file-utils.js

@@ -0,0 +1,110 @@
+import { hexDecodeToBuffer, utf8EncodeToBuffer } from '@mtcute/tl-runtime';
+import { MtArgumentError } from '../../types/errors.js';
+import { concatBuffers } from '../../utils/buffer-utils.js';
+/**
+ * Given file size, determine the appropriate chunk size (in KB)
+ * for upload/download operations.
+ */
+export function determinePartSize(fileSize) {
+    if (fileSize <= 262078465)
+        return 128; // 200 MB
+    if (fileSize <= 786432000)
+        return 256; // 750 MB
+    if (fileSize <= 2097152000)
+        return 512; // 2000 MB
+    throw new MtArgumentError('File is too large');
+}
+/**
+ * Returns `true` if all bytes in `buf` are printable ASCII characters
+ */
+export function isProbablyPlainText(buf) {
+    return !buf.some((it) => !(((it >= 0x20 && it < 0x7f) || // printable ascii range
+        it === 0x0d || // CR
+        it === 0x0a || // LF
+        it === 0x09) // Tab
+    ));
+}
+// from https://github.com/telegramdesktop/tdesktop/blob/bec39d89e19670eb436dc794a8f20b657cb87c71/Telegram/SourceFiles/ui/image/image.cpp#L225
+const JPEG_HEADER = hexDecodeToBuffer('ffd8ffe000104a46494600010100000100010000ffdb004300281c1e231e1928' +
+    '2321232d2b28303c64413c37373c7b585d4964918099968f808c8aa0b4e6c3a0aad' +
+    'aad8a8cc8ffcbdaeef5ffffff9bc1fffffffaffe6fdfff8ffdb0043012b2d2d3c35' +
+    '3c76414176f8a58ca5f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f' +
+    '8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8ffc0001108000000' +
+    '0003012200021101031101ffc4001f0000010501010101010100000000000000000' +
+    '102030405060708090a0bffc400b5100002010303020403050504040000017d0102' +
+    '0300041105122131410613516107227114328191a1082342b1c11552d1f02433627' +
+    '282090a161718191a25262728292a3435363738393a434445464748494a53545556' +
+    '5758595a636465666768696a737475767778797a838485868788898a92939495969' +
+    '798999aa2a3a4a5a6a7a8a9aab2b3b4b5b6b7b8b9bac2c3c4c5c6c7c8c9cad2d3d4' +
+    'd5d6d7d8d9dae1e2e3e4e5e6e7e8e9eaf1f2f3f4f5f6f7f8f9faffc4001f0100030' +
+    '101010101010101010000000000000102030405060708090a0bffc400b511000201' +
+    '0204040304070504040001027700010203110405213106124151076171132232810' +
+    '8144291a1b1c109233352f0156272d10a162434e125f11718191a262728292a3536' +
+    '3738393a434445464748494a535455565758595a636465666768696a73747576777' +
+    '8797a82838485868788898a92939495969798999aa2a3a4a5a6a7a8a9aab2b3b4b5' +
+    'b6b7b8b9bac2c3c4c5c6c7c8c9cad2d3d4d5d6d7d8d9dae2e3e4e5e6e7e8e9eaf2f' +
+    '3f4f5f6f7f8f9faffda000c03010002110311003f00');
+const JPEG_FOOTER = new Uint8Array([0xff, 0xd9]);
+/**
+ * Convert stripped JPEG (from `photoStrippedSize`) to full JPEG
+ */
+export function strippedPhotoToJpg(stripped) {
+    if (stripped.length < 3 || stripped[0] !== 1) {
+        throw new MtArgumentError('Invalid stripped JPEG');
+    }
+    const result = concatBuffers([JPEG_HEADER, stripped.slice(3), JPEG_FOOTER]);
+    result[164] = stripped[1];
+    result[166] = stripped[2];
+    return result;
+}
+const SVG_LOOKUP = 'AACAAAAHAAALMAAAQASTAVAAAZaacaaaahaaalmaaaqastava.az0123456789-,';
+/**
+ * Inflate compressed preview SVG path to full SVG path
+ * @param encoded
+ */
+export function inflateSvgPath(encoded) {
+    let path = 'M';
+    const len = encoded.length;
+    for (let i = 0; i < len; i++) {
+        const num = encoded[i];
+        if (num >= 192) {
+            // 128 + 64
+            path += SVG_LOOKUP[num - 192];
+        }
+        else {
+            if (num >= 128) {
+                path += ',';
+            }
+            else if (num >= 64) {
+                path += '-';
+            }
+            path += num & 63;
+        }
+    }
+    path += 'z';
+    return path;
+}
+/**
+ * Convert SVG path to SVG file
+ * @param path
+ */
+export function svgPathToFile(path) {
+    return utf8EncodeToBuffer('<?xml version="1.0" encoding="utf-8"?>' +
+        '<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"' +
+        'viewBox="0 0 512 512" xml:space="preserve">' +
+        '<path d="' +
+        path +
+        '"/>' +
+        '</svg>');
+}
+/**
+ * Get file name from file path
+ *
+ * @param path  File path
+ */
+export function extractFileName(path) {
+    if (path.startsWith('file:'))
+        path = path.slice(5);
+    return path.split(/[\\/]/).pop();
+}
+//# sourceMappingURL=file-utils.js.map

package/esm/highlevel/utils/file-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-utils.js","sourceRoot":"","sources":["../../../../src/highlevel/utils/file-utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { hexDecodeToBuffer, utf8EncodeToBuffer } from '@mtcute/tl-runtime'\n\nimport { MtArgumentError } from '../../types/errors.js'\nimport { concatBuffers } from '../../utils/buffer-utils.js'\n\n/**\n * Given file size, determine the appropriate chunk size (in KB)\n * for upload/download operations.\n */\nexport function determinePartSize(fileSize: number): number {\n    if (fileSize <= 262078465) return 128 // 200 MB\n    if (fileSize <= 786432000) return 256 // 750 MB\n    if (fileSize <= 2097152000) return 512 // 2000 MB\n\n    throw new MtArgumentError('File is too large')\n}\n\n/**\n * Returns `true` if all bytes in `buf` are printable ASCII characters\n */\nexport function isProbablyPlainText(buf: Uint8Array): boolean {\n    return !buf.some(\n        (it) =>\n            !(\n                (\n                    (it >= 0x20 && it < 0x7f) || // printable ascii range\n                    it === 0x0d || // CR\n                    it === 0x0a || // LF\n                    it === 0x09\n                ) // Tab\n            ),\n    )\n}\n\n// from https://github.com/telegramdesktop/tdesktop/blob/bec39d89e19670eb436dc794a8f20b657cb87c71/Telegram/SourceFiles/ui/image/image.cpp#L225\nconst JPEG_HEADER = hexDecodeToBuffer(\n    'ffd8ffe000104a46494600010100000100010000ffdb004300281c1e231e1928' +\n        '2321232d2b28303c64413c37373c7b585d4964918099968f808c8aa0b4e6c3a0aad' +\n        'aad8a8cc8ffcbdaeef5ffffff9bc1fffffffaffe6fdfff8ffdb0043012b2d2d3c35' +\n        '3c76414176f8a58ca5f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f' +\n        '8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8ffc0001108000000' +\n        '0003012200021101031101ffc4001f0000010501010101010100000000000000000' +\n        '102030405060708090a0bffc400b5100002010303020403050504040000017d0102' +\n        '0300041105122131410613516107227114328191a1082342b1c11552d1f02433627' +\n        '282090a161718191a25262728292a3435363738393a434445464748494a53545556' +\n        '5758595a636465666768696a737475767778797a838485868788898a92939495969' +\n        '798999aa2a3a4a5a6a7a8a9aab2b3b4b5b6b7b8b9bac2c3c4c5c6c7c8c9cad2d3d4' +\n        'd5d6d7d8d9dae1e2e3e4e5e6e7e8e9eaf1f2f3f4f5f6f7f8f9faffc4001f0100030' +\n        '101010101010101010000000000000102030405060708090a0bffc400b511000201' +\n        '0204040304070504040001027700010203110405213106124151076171132232810' +\n        '8144291a1b1c109233352f0156272d10a162434e125f11718191a262728292a3536' +\n        '3738393a434445464748494a535455565758595a636465666768696a73747576777' +\n        '8797a82838485868788898a92939495969798999aa2a3a4a5a6a7a8a9aab2b3b4b5' +\n        'b6b7b8b9bac2c3c4c5c6c7c8c9cad2d3d4d5d6d7d8d9dae2e3e4e5e6e7e8e9eaf2f' +\n        '3f4f5f6f7f8f9faffda000c03010002110311003f00',\n)\nconst JPEG_FOOTER = new Uint8Array([0xff, 0xd9])\n\n/**\n * Convert stripped JPEG (from `photoStrippedSize`) to full JPEG\n */\nexport function strippedPhotoToJpg(stripped: Uint8Array): Uint8Array {\n    if (stripped.length < 3 || stripped[0] !== 1) {\n        throw new MtArgumentError('Invalid stripped JPEG')\n    }\n\n    const result = concatBuffers([JPEG_HEADER, stripped.slice(3), JPEG_FOOTER])\n    result[164] = stripped[1]\n    result[166] = stripped[2]\n\n    return result\n}\n\nconst SVG_LOOKUP = 'AACAAAAHAAALMAAAQASTAVAAAZaacaaaahaaalmaaaqastava.az0123456789-,'\n\n/**\n * Inflate compressed preview SVG path to full SVG path\n * @param encoded\n */\nexport function inflateSvgPath(encoded: Uint8Array): string {\n    let path = 'M'\n    const len = encoded.length\n\n    for (let i = 0; i < len; i++) {\n        const num = encoded[i]\n\n        if (num >= 192) {\n            // 128 + 64\n            path += SVG_LOOKUP[num - 192]\n        } else {\n            if (num >= 128) {\n                path += ','\n            } else if (num >= 64) {\n                path += '-'\n            }\n\n            path += num & 63\n        }\n    }\n\n    path += 'z'\n\n    return path\n}\n\n/**\n * Convert SVG path to SVG file\n * @param path\n */\nexport function svgPathToFile(path: string): Uint8Array {\n    return utf8EncodeToBuffer(\n        '<?xml version=\"1.0\" encoding=\"utf-8\"?>' +\n            '<svg version=\"1.1\" xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\"' +\n            'viewBox=\"0 0 512 512\" xml:space=\"preserve\">' +\n            '<path d=\"' +\n            path +\n            '\"/>' +\n            '</svg>',\n    )\n}\n\n/**\n * Get file name from file path\n *\n * @param path  File path\n */\nexport function extractFileName(path: string): string {\n    if (path.startsWith('file:')) path = path.slice(5)\n\n    return path.split(/[\\\\/]/).pop()!\n}\n"]}

package/esm/highlevel/utils/file-utils.test.d.ts

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

package/esm/highlevel/utils/file-utils.test.js

@@ -0,0 +1,124 @@
+import { describe, expect, it } from 'vitest';
+import { hexDecodeToBuffer, hexEncode, utf8Decode, utf8EncodeToBuffer } from '@mtcute/tl-runtime';
+import { extractFileName, inflateSvgPath, isProbablyPlainText, strippedPhotoToJpg, svgPathToFile, } from './file-utils.js';
+describe('isProbablyPlainText', () => {
+    it('should return true for buffers only containing printable ascii', () => {
+        expect(isProbablyPlainText(utf8EncodeToBuffer('hello this is some ascii text'))).to.be.true;
+        expect(isProbablyPlainText(utf8EncodeToBuffer('hello this is some ascii text\nwith unix new lines'))).to.be.true;
+        expect(isProbablyPlainText(utf8EncodeToBuffer('hello this is some ascii text\r\nwith windows new lines'))).to.be
+            .true;
+        expect(isProbablyPlainText(utf8EncodeToBuffer('hello this is some ascii text\n\twith unix new lines and tabs')))
+            .to.be.true;
+        expect(isProbablyPlainText(utf8EncodeToBuffer('hello this is some ascii text\r\n\twith windows new lines and tabs'))).to.be.true;
+    });
+    it('should return false for buffers containing some binary data', () => {
+        expect(isProbablyPlainText(utf8EncodeToBuffer('hello this is cedilla: ç'))).to.be.false;
+        expect(isProbablyPlainText(utf8EncodeToBuffer('hello this is some ascii text with emojis 🌸'))).to.be.false;
+        // random strings of 16 bytes
+        expect(isProbablyPlainText(hexDecodeToBuffer('717f80f08eb9d88c3931712c0e2be32f'))).to.be.false;
+        expect(isProbablyPlainText(hexDecodeToBuffer('20e8e218e54254c813b261432b0330d7'))).to.be.false;
+    });
+});
+describe('extractFileName', () => {
+    it('should extract file name from a path', () => {
+        expect(extractFileName('file.txt')).toEqual('file.txt');
+        expect(extractFileName('/home/user/file.txt')).toEqual('file.txt');
+        expect(extractFileName('C:\\Users\\user\\file.txt')).toEqual('file.txt');
+    });
+    it('should skip file: prefix', () => {
+        expect(extractFileName('file:file.txt')).toEqual('file.txt');
+        expect(extractFileName('file:/home/user/file.txt')).toEqual('file.txt');
+        expect(extractFileName('file:C:\\Users\\user\\file.txt')).toEqual('file.txt');
+    });
+});
+describe('svgPathToFile', () => {
+    it('should convert SVG path to a file', () => {
+        const path = 'M 0 0 L 100 0 L 100 100 L 0 100 L 0 0 Z';
+        expect(utf8Decode(svgPathToFile(path))).toMatchInlineSnapshot('"<?xml version=\\"1.0\\" encoding=\\"utf-8\\"?><svg version=\\"1.1\\" xmlns=\\"http://www.w3.org/2000/svg\\" xmlns:xlink=\\"http://www.w3.org/1999/xlink\\"viewBox=\\"0 0 512 512\\" xml:space=\\"preserve\\"><path d=\\"M 0 0 L 100 0 L 100 100 L 0 100 L 0 0 Z\\"/></svg>"');
+    });
+});
+describe('inflateSvgPath', () => {
+    const data = hexDecodeToBuffer('1a05b302dc5f4446068649064247424a6a4c704550535b5e665e5e4c044a024c' +
+        '074e06414d80588863935fad74be4704854684518b528581904695498b488b56' +
+        '965c85438d8191818543894a8f4d834188818a4284498454895d9a6f86074708' +
+        '8d0146089283a281b48bbfa386078a04880390098490949997ab828a4b984a9d' +
+        '8490b395aa9949845c485d4a42434b4a4a46848a8792859d4186468c48938182' +
+        '91a293ac859781af848701818989928b9c849086a785b880816c8071817c814c' +
+        '0080520081');
+    const path = 'M265,512c-31-4-66,6-96-2-7-2-10-42-12-48-5-16-19-27-30' +
+        '-38-30-30-124-102-127-146-1-13,0-24,8-35,19-31,45-52,62-74,5-6,4-17,11-18,' +
+        '5,1,16-6,21-9,11-8,11-22,22-28,5-3,13,1,17,1,5-3,9-10,15-13,3-1,8,1,10-2,4' +
+        '-9,4-20,9-29,26-47,67-78,131-68,18,3,34,1,52,11,63,35,67,104,83,169,4,16,20,' +
+        '25,23,43,2,10-11,24-10,29,4,16,51,21,42,25-9,4-28-8-29-10-2-3-11-10-10-6,4,10,' +
+        '7,18,5,29-1,6-6,12-8,19,1,2,17,34,19,44,5,23,1,47,4,71,1,9,9,18,11,28,4,16,6,39,' +
+        '5,56,0,1-44,0-49,1-60,1-120,0-180,1z';
+    it('should correctly inflate svg path', () => {
+        expect(inflateSvgPath(data)).toEqual(path);
+    });
+});
+describe('strippedPhotoToJpg', () => {
+    // strippedThumb of @Channel_Bot
+    const dataPfp = hexDecodeToBuffer('010808b1f2f95fed673451457033ad1f');
+    // photoStrippedSize of a random image
+    const dataPicture = hexDecodeToBuffer('012728b532aacce4b302d8c1099c74a634718675cb6381f73d3ffd557667d9b5' +
+        '816f4c28ce69aa58a863238cf62a334590f999042234cbe1986d03eefe14c68e' +
+        '32847cc00ce709ea7ffad577773f78fe54d6c927f78c3db14ac1ccca91a2ef4f' +
+        '9d89dd9e53e9455c456072646618e840a28b20bb223275e463b55769b07e4cf1' +
+        'c52cedfbb03d38aab9e718356909b2733c839cf5a72dc3646ee6a4bb882c2ac0' +
+        '70a31c554c1d81f0403eb4d598b5350b8680b03c628aab09ff0044707b1a2a5a' +
+        '012e016420753cd25b491ac603a723bd14517ba28b46788c5e613f27d2a9cb32' +
+        'ceca2353807bd14525b831e6175deccde991eb45145508');
+    it('should inflate stripped jpeg (from profile picture)', () => {
+        expect(hexEncode(strippedPhotoToJpg(dataPfp))).toMatchInlineSnapshot('"ffd8ffe000104a46494600010100000100010000ffdb004300281c1e231e192' +
+            '82321232d2b28303c64413c37373c7b585d4964918099968f808c8aa0b4e6c3a' +
+            '0aadaad8a8cc8ffcbdaeef5ffffff9bc1fffffffaffe6fdfff8ffdb0043012b2' +
+            'd2d3c353c76414176f8a58ca5f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f' +
+            '8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8ffc' +
+            '00011080008000803012200021101031101ffc4001f000001050101010101010' +
+            '0000000000000000102030405060708090a0bffc400b51000020103030204030' +
+            '50504040000017d01020300041105122131410613516107227114328191a1082' +
+            '342b1c11552d1f02433627282090a161718191a25262728292a3435363738393' +
+            'a434445464748494a535455565758595a636465666768696a737475767778797' +
+            'a838485868788898a92939495969798999aa2a3a4a5a6a7a8a9aab2b3b4b5b6b' +
+            '7b8b9bac2c3c4c5c6c7c8c9cad2d3d4d5d6d7d8d9dae1e2e3e4e5e6e7e8e9eaf' +
+            '1f2f3f4f5f6f7f8f9faffc4001f0100030101010101010101010000000000000' +
+            '102030405060708090a0bffc400b511000201020404030407050404000102770' +
+            '00102031104052131061241510761711322328108144291a1b1c109233352f01' +
+            '56272d10a162434e125f11718191a262728292a35363738393a4344454647484' +
+            '94a535455565758595a636465666768696a737475767778797a8283848586878' +
+            '8898a92939495969798999aa2a3a4a5a6a7a8a9aab2b3b4b5b6b7b8b9bac2c3c' +
+            '4c5c6c7c8c9cad2d3d4d5d6d7d8d9dae2e3e4e5e6e7e8e9eaf2f3f4f5f6f7f8f' +
+            '9faffda000c03010002110311003f00b1f2f95fed673451457033ad1fffd9"');
+    });
+    it('should inflate stripped jpeg (from a picture)', () => {
+        expect(hexEncode(strippedPhotoToJpg(dataPicture))).toMatchInlineSnapshot('"ffd8ffe000104a46494600010100000100010000ffdb004300281c1e231e192' +
+            '82321232d2b28303c64413c37373c7b585d4964918099968f808c8aa0b4e6c3a' +
+            '0aadaad8a8cc8ffcbdaeef5ffffff9bc1fffffffaffe6fdfff8ffdb0043012b2' +
+            'd2d3c353c76414176f8a58ca5f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f' +
+            '8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8ffc' +
+            '00011080027002803012200021101031101ffc4001f000001050101010101010' +
+            '0000000000000000102030405060708090a0bffc400b51000020103030204030' +
+            '50504040000017d01020300041105122131410613516107227114328191a1082' +
+            '342b1c11552d1f02433627282090a161718191a25262728292a3435363738393' +
+            'a434445464748494a535455565758595a636465666768696a737475767778797' +
+            'a838485868788898a92939495969798999aa2a3a4a5a6a7a8a9aab2b3b4b5b6b' +
+            '7b8b9bac2c3c4c5c6c7c8c9cad2d3d4d5d6d7d8d9dae1e2e3e4e5e6e7e8e9eaf' +
+            '1f2f3f4f5f6f7f8f9faffc4001f0100030101010101010101010000000000000' +
+            '102030405060708090a0bffc400b511000201020404030407050404000102770' +
+            '00102031104052131061241510761711322328108144291a1b1c109233352f01' +
+            '56272d10a162434e125f11718191a262728292a35363738393a4344454647484' +
+            '94a535455565758595a636465666768696a737475767778797a8283848586878' +
+            '8898a92939495969798999aa2a3a4a5a6a7a8a9aab2b3b4b5b6b7b8b9bac2c3c' +
+            '4c5c6c7c8c9cad2d3d4d5d6d7d8d9dae2e3e4e5e6e7e8e9eaf2f3f4f5f6f7f8f' +
+            '9faffda000c03010002110311003f00b532aacce4b302d8c1099c74a63471867' +
+            '5cb6381f73d3ffd557667d9b5816f4c28ce69aa58a863238cf62a334590f9990' +
+            '42234cbe1986d03eefe14c68e32847cc00ce709ea7ffad577773f78fe54d6c92' +
+            '7f78c3db14ac1ccca91a2ef4f9d89dd9e53e9455c456072646618e840a28b20b' +
+            'b223275e463b55769b07e4cf1c52cedfbb03d38aab9e718356909b2733c839cf' +
+            '5a72dc3646ee6a4bb882c2ac070a31c554c1d81f0403eb4d598b5350b8680b03' +
+            'c628aab09ff0044707b1a2a5a012e016420753cd25b491ac603a723bd14517ba' +
+            '28b46788c5e613f27d2a9cb32ceca2353807bd14525b831e6175deccde991eb4' +
+            '5145508ffd9"');
+    });
+});
+//# sourceMappingURL=file-utils.test.js.map

package/esm/highlevel/utils/file-utils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-utils.test.js","sourceRoot":"","sources":["../../../../src/highlevel/utils/file-utils.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it } from 'vitest'\n\nimport { hexDecodeToBuffer, hexEncode, utf8Decode, utf8EncodeToBuffer } from '@mtcute/tl-runtime'\n\nimport {\n    extractFileName,\n    inflateSvgPath,\n    isProbablyPlainText,\n    strippedPhotoToJpg,\n    svgPathToFile,\n} from './file-utils.js'\n\ndescribe('isProbablyPlainText', () => {\n    it('should return true for buffers only containing printable ascii', () => {\n        expect(isProbablyPlainText(utf8EncodeToBuffer('hello this is some ascii text'))).to.be.true\n        expect(isProbablyPlainText(utf8EncodeToBuffer('hello this is some ascii text\\nwith unix new lines'))).to.be.true\n        expect(isProbablyPlainText(utf8EncodeToBuffer('hello this is some ascii text\\r\\nwith windows new lines'))).to.be\n            .true\n        expect(isProbablyPlainText(utf8EncodeToBuffer('hello this is some ascii text\\n\\twith unix new lines and tabs')))\n            .to.be.true\n        expect(\n            isProbablyPlainText(\n                utf8EncodeToBuffer('hello this is some ascii text\\r\\n\\twith windows new lines and tabs'),\n            ),\n        ).to.be.true\n    })\n\n    it('should return false for buffers containing some binary data', () => {\n        expect(isProbablyPlainText(utf8EncodeToBuffer('hello this is cedilla: ç'))).to.be.false\n        expect(isProbablyPlainText(utf8EncodeToBuffer('hello this is some ascii text with emojis 🌸'))).to.be.false\n\n        // random strings of 16 bytes\n        expect(isProbablyPlainText(hexDecodeToBuffer('717f80f08eb9d88c3931712c0e2be32f'))).to.be.false\n        expect(isProbablyPlainText(hexDecodeToBuffer('20e8e218e54254c813b261432b0330d7'))).to.be.false\n    })\n})\n\ndescribe('extractFileName', () => {\n    it('should extract file name from a path', () => {\n        expect(extractFileName('file.txt')).toEqual('file.txt')\n        expect(extractFileName('/home/user/file.txt')).toEqual('file.txt')\n        expect(extractFileName('C:\\\\Users\\\\user\\\\file.txt')).toEqual('file.txt')\n    })\n\n    it('should skip file: prefix', () => {\n        expect(extractFileName('file:file.txt')).toEqual('file.txt')\n        expect(extractFileName('file:/home/user/file.txt')).toEqual('file.txt')\n        expect(extractFileName('file:C:\\\\Users\\\\user\\\\file.txt')).toEqual('file.txt')\n    })\n})\n\ndescribe('svgPathToFile', () => {\n    it('should convert SVG path to a file', () => {\n        const path = 'M 0 0 L 100 0 L 100 100 L 0 100 L 0 0 Z'\n\n        expect(utf8Decode(svgPathToFile(path))).toMatchInlineSnapshot(\n            '\"<?xml version=\\\\\"1.0\\\\\" encoding=\\\\\"utf-8\\\\\"?><svg version=\\\\\"1.1\\\\\" xmlns=\\\\\"http://www.w3.org/2000/svg\\\\\" xmlns:xlink=\\\\\"http://www.w3.org/1999/xlink\\\\\"viewBox=\\\\\"0 0 512 512\\\\\" xml:space=\\\\\"preserve\\\\\"><path d=\\\\\"M 0 0 L 100 0 L 100 100 L 0 100 L 0 0 Z\\\\\"/></svg>\"',\n        )\n    })\n})\n\ndescribe('inflateSvgPath', () => {\n    const data = hexDecodeToBuffer(\n        '1a05b302dc5f4446068649064247424a6a4c704550535b5e665e5e4c044a024c' +\n            '074e06414d80588863935fad74be4704854684518b528581904695498b488b56' +\n            '965c85438d8191818543894a8f4d834188818a4284498454895d9a6f86074708' +\n            '8d0146089283a281b48bbfa386078a04880390098490949997ab828a4b984a9d' +\n            '8490b395aa9949845c485d4a42434b4a4a46848a8792859d4186468c48938182' +\n            '91a293ac859781af848701818989928b9c849086a785b880816c8071817c814c' +\n            '0080520081',\n    )\n    const path =\n        'M265,512c-31-4-66,6-96-2-7-2-10-42-12-48-5-16-19-27-30' +\n        '-38-30-30-124-102-127-146-1-13,0-24,8-35,19-31,45-52,62-74,5-6,4-17,11-18,' +\n        '5,1,16-6,21-9,11-8,11-22,22-28,5-3,13,1,17,1,5-3,9-10,15-13,3-1,8,1,10-2,4' +\n        '-9,4-20,9-29,26-47,67-78,131-68,18,3,34,1,52,11,63,35,67,104,83,169,4,16,20,' +\n        '25,23,43,2,10-11,24-10,29,4,16,51,21,42,25-9,4-28-8-29-10-2-3-11-10-10-6,4,10,' +\n        '7,18,5,29-1,6-6,12-8,19,1,2,17,34,19,44,5,23,1,47,4,71,1,9,9,18,11,28,4,16,6,39,' +\n        '5,56,0,1-44,0-49,1-60,1-120,0-180,1z'\n\n    it('should correctly inflate svg path', () => {\n        expect(inflateSvgPath(data)).toEqual(path)\n    })\n})\n\ndescribe('strippedPhotoToJpg', () => {\n    // strippedThumb of @Channel_Bot\n    const dataPfp = hexDecodeToBuffer('010808b1f2f95fed673451457033ad1f')\n    // photoStrippedSize of a random image\n    const dataPicture = hexDecodeToBuffer(\n        '012728b532aacce4b302d8c1099c74a634718675cb6381f73d3ffd557667d9b5' +\n            '816f4c28ce69aa58a863238cf62a334590f999042234cbe1986d03eefe14c68e' +\n            '32847cc00ce709ea7ffad577773f78fe54d6c927f78c3db14ac1ccca91a2ef4f' +\n            '9d89dd9e53e9455c456072646618e840a28b20bb223275e463b55769b07e4cf1' +\n            'c52cedfbb03d38aab9e718356909b2733c839cf5a72dc3646ee6a4bb882c2ac0' +\n            '70a31c554c1d81f0403eb4d598b5350b8680b03c628aab09ff0044707b1a2a5a' +\n            '012e016420753cd25b491ac603a723bd14517ba28b46788c5e613f27d2a9cb32' +\n            'ceca2353807bd14525b831e6175deccde991eb45145508',\n    )\n\n    it('should inflate stripped jpeg (from profile picture)', () => {\n        expect(hexEncode(strippedPhotoToJpg(dataPfp))).toMatchInlineSnapshot(\n            '\"ffd8ffe000104a46494600010100000100010000ffdb004300281c1e231e192' +\n                '82321232d2b28303c64413c37373c7b585d4964918099968f808c8aa0b4e6c3a' +\n                '0aadaad8a8cc8ffcbdaeef5ffffff9bc1fffffffaffe6fdfff8ffdb0043012b2' +\n                'd2d3c353c76414176f8a58ca5f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f' +\n                '8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8ffc' +\n                '00011080008000803012200021101031101ffc4001f000001050101010101010' +\n                '0000000000000000102030405060708090a0bffc400b51000020103030204030' +\n                '50504040000017d01020300041105122131410613516107227114328191a1082' +\n                '342b1c11552d1f02433627282090a161718191a25262728292a3435363738393' +\n                'a434445464748494a535455565758595a636465666768696a737475767778797' +\n                'a838485868788898a92939495969798999aa2a3a4a5a6a7a8a9aab2b3b4b5b6b' +\n                '7b8b9bac2c3c4c5c6c7c8c9cad2d3d4d5d6d7d8d9dae1e2e3e4e5e6e7e8e9eaf' +\n                '1f2f3f4f5f6f7f8f9faffc4001f0100030101010101010101010000000000000' +\n                '102030405060708090a0bffc400b511000201020404030407050404000102770' +\n                '00102031104052131061241510761711322328108144291a1b1c109233352f01' +\n                '56272d10a162434e125f11718191a262728292a35363738393a4344454647484' +\n                '94a535455565758595a636465666768696a737475767778797a8283848586878' +\n                '8898a92939495969798999aa2a3a4a5a6a7a8a9aab2b3b4b5b6b7b8b9bac2c3c' +\n                '4c5c6c7c8c9cad2d3d4d5d6d7d8d9dae2e3e4e5e6e7e8e9eaf2f3f4f5f6f7f8f' +\n                '9faffda000c03010002110311003f00b1f2f95fed673451457033ad1fffd9\"',\n        )\n    })\n\n    it('should inflate stripped jpeg (from a picture)', () => {\n        expect(hexEncode(strippedPhotoToJpg(dataPicture))).toMatchInlineSnapshot(\n            '\"ffd8ffe000104a46494600010100000100010000ffdb004300281c1e231e192' +\n                '82321232d2b28303c64413c37373c7b585d4964918099968f808c8aa0b4e6c3a' +\n                '0aadaad8a8cc8ffcbdaeef5ffffff9bc1fffffffaffe6fdfff8ffdb0043012b2' +\n                'd2d3c353c76414176f8a58ca5f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f' +\n                '8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8f8ffc' +\n                '00011080027002803012200021101031101ffc4001f000001050101010101010' +\n                '0000000000000000102030405060708090a0bffc400b51000020103030204030' +\n                '50504040000017d01020300041105122131410613516107227114328191a1082' +\n                '342b1c11552d1f02433627282090a161718191a25262728292a3435363738393' +\n                'a434445464748494a535455565758595a636465666768696a737475767778797' +\n                'a838485868788898a92939495969798999aa2a3a4a5a6a7a8a9aab2b3b4b5b6b' +\n                '7b8b9bac2c3c4c5c6c7c8c9cad2d3d4d5d6d7d8d9dae1e2e3e4e5e6e7e8e9eaf' +\n                '1f2f3f4f5f6f7f8f9faffc4001f0100030101010101010101010000000000000' +\n                '102030405060708090a0bffc400b511000201020404030407050404000102770' +\n                '00102031104052131061241510761711322328108144291a1b1c109233352f01' +\n                '56272d10a162434e125f11718191a262728292a35363738393a4344454647484' +\n                '94a535455565758595a636465666768696a737475767778797a8283848586878' +\n                '8898a92939495969798999aa2a3a4a5a6a7a8a9aab2b3b4b5b6b7b8b9bac2c3c' +\n                '4c5c6c7c8c9cad2d3d4d5d6d7d8d9dae2e3e4e5e6e7e8e9eaf2f3f4f5f6f7f8f' +\n                '9faffda000c03010002110311003f00b532aacce4b302d8c1099c74a63471867' +\n                '5cb6381f73d3ffd557667d9b5816f4c28ce69aa58a863238cf62a334590f9990' +\n                '42234cbe1986d03eefe14c68e32847cc00ce709ea7ffad577773f78fe54d6c92' +\n                '7f78c3db14ac1ccca91a2ef4f9d89dd9e53e9455c456072646618e840a28b20b' +\n                'b223275e463b55769b07e4cf1c52cedfbb03d38aab9e718356909b2733c839cf' +\n                '5a72dc3646ee6a4bb882c2ac070a31c554c1d81f0403eb4d598b5350b8680b03' +\n                'c628aab09ff0044707b1a2a5a012e016420753cd25b491ac603a723bd14517ba' +\n                '28b46788c5e613f27d2a9cb32ceca2353807bd14525b831e6175deccde991eb4' +\n                '5145508ffd9\"',\n        )\n    })\n})\n"]}

package/esm/highlevel/utils/index.d.ts

@@ -0,0 +1,8 @@
+export * from './file-utils.js';
+export * from './inline-utils.js';
+export * from './inspectable.js';
+export * from './misc-utils.js';
+export * from './peer-utils.js';
+export * from './rps-meter.js';
+export * from './stream-utils.js';
+export * from './voice-utils.js';

package/esm/highlevel/utils/index.js

@@ -0,0 +1,10 @@
+// todo: merge this with the main utils dir
+export * from './file-utils.js';
+export * from './inline-utils.js';
+export * from './inspectable.js';
+export * from './misc-utils.js';
+export * from './peer-utils.js';
+export * from './rps-meter.js';
+export * from './stream-utils.js';
+export * from './voice-utils.js';
+//# sourceMappingURL=index.js.map

package/esm/highlevel/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/highlevel/utils/index.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAE3C,cAAc,iBAAiB,CAAA;AAC/B,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA","sourcesContent":["// todo: merge this with the main utils dir\n\nexport * from './file-utils.js'\nexport * from './inline-utils.js'\nexport * from './inspectable.js'\nexport * from './misc-utils.js'\nexport * from './peer-utils.js'\nexport * from './rps-meter.js'\nexport * from './stream-utils.js'\nexport * from './voice-utils.js'\n"]}

package/esm/highlevel/utils/inline-utils.d.ts

@@ -0,0 +1,14 @@
+import { tl } from '@mtcute/tl';
+/**
+ * Parse TDLib style inline message ID
+ *
+ * @param id  Inline message ID
+ */
+export declare function parseInlineMessageId(id: string): tl.TypeInputBotInlineMessageID;
+/**
+ * Generate TDLib style inline message ID
+ *
+ * @param id  Inline message ID object
+ */
+export declare function encodeInlineMessageId(id: tl.TypeInputBotInlineMessageID): string;
+export declare function normalizeInlineId(id: string | tl.TypeInputBotInlineMessageID): tl.TypeInputBotInlineMessageID;

package/esm/highlevel/utils/inline-utils.js

@@ -0,0 +1,59 @@
+import { base64DecodeToBuffer, base64Encode, TlBinaryReader, TlBinaryWriter } from '@mtcute/tl-runtime';
+import { assertNever } from '../../types/utils.js';
+/**
+ * Parse TDLib style inline message ID
+ *
+ * @param id  Inline message ID
+ */
+export function parseInlineMessageId(id) {
+    const buf = base64DecodeToBuffer(id, true);
+    const reader = TlBinaryReader.manual(buf);
+    if (buf.length === 20) {
+        return {
+            _: 'inputBotInlineMessageID',
+            dcId: reader.int(),
+            id: reader.long(),
+            accessHash: reader.long(),
+        };
+    }
+    return {
+        _: 'inputBotInlineMessageID64',
+        dcId: reader.int(),
+        ownerId: reader.long(),
+        id: reader.int(),
+        accessHash: reader.long(),
+    };
+}
+/**
+ * Generate TDLib style inline message ID
+ *
+ * @param id  Inline message ID object
+ */
+export function encodeInlineMessageId(id) {
+    let writer;
+    switch (id._) {
+        case 'inputBotInlineMessageID':
+            writer = TlBinaryWriter.manual(20);
+            writer.int(id.dcId);
+            writer.long(id.id);
+            writer.long(id.accessHash);
+            break;
+        case 'inputBotInlineMessageID64':
+            writer = TlBinaryWriter.manual(24);
+            writer.int(id.dcId);
+            writer.long(id.ownerId);
+            writer.int(id.id);
+            writer.long(id.accessHash);
+            break;
+        default:
+            assertNever(id);
+    }
+    return base64Encode(writer.result(), true);
+}
+export function normalizeInlineId(id) {
+    if (typeof id === 'string') {
+        return parseInlineMessageId(id);
+    }
+    return id;
+}
+//# sourceMappingURL=inline-utils.js.map

package/esm/highlevel/utils/inline-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inline-utils.js","sourceRoot":"","sources":["../../../../src/highlevel/utils/inline-utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAEvG,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAElD;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,EAAU;IAC3C,MAAM,GAAG,GAAG,oBAAoB,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;IAC1C,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IAEzC,IAAI,GAAG,CAAC,MAAM,KAAK,EAAE,EAAE;QACnB,OAAO;YACH,CAAC,EAAE,yBAAyB;YAC5B,IAAI,EAAE,MAAM,CAAC,GAAG,EAAE;YAClB,EAAE,EAAE,MAAM,CAAC,IAAI,EAAE;YACjB,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE;SAC5B,CAAA;KACJ;IAED,OAAO;QACH,CAAC,EAAE,2BAA2B;QAC9B,IAAI,EAAE,MAAM,CAAC,GAAG,EAAE;QAClB,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE;QACtB,EAAE,EAAE,MAAM,CAAC,GAAG,EAAE;QAChB,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE;KAC5B,CAAA;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,EAAkC;IACpE,IAAI,MAAsB,CAAA;IAE1B,QAAQ,EAAE,CAAC,CAAC,EAAE;QACV,KAAK,yBAAyB;YAC1B,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;YAClC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAA;YACnB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;YAClB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,CAAA;YAC1B,MAAK;QACT,KAAK,2BAA2B;YAC5B,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;YAClC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAA;YACnB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,CAAA;YACvB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;YACjB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,CAAA;YAC1B,MAAK;QACT;YACI,WAAW,CAAC,EAAE,CAAC,CAAA;KACtB;IAED,OAAO,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,CAAA;AAC9C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,EAA2C;IACzE,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE;QACxB,OAAO,oBAAoB,CAAC,EAAE,CAAC,CAAA;KAClC;IAED,OAAO,EAAE,CAAA;AACb,CAAC","sourcesContent":["import { tl } from '@mtcute/tl'\nimport { base64DecodeToBuffer, base64Encode, TlBinaryReader, TlBinaryWriter } from '@mtcute/tl-runtime'\n\nimport { assertNever } from '../../types/utils.js'\n\n/**\n * Parse TDLib style inline message ID\n *\n * @param id  Inline message ID\n */\nexport function parseInlineMessageId(id: string): tl.TypeInputBotInlineMessageID {\n    const buf = base64DecodeToBuffer(id, true)\n    const reader = TlBinaryReader.manual(buf)\n\n    if (buf.length === 20) {\n        return {\n            _: 'inputBotInlineMessageID',\n            dcId: reader.int(),\n            id: reader.long(),\n            accessHash: reader.long(),\n        }\n    }\n\n    return {\n        _: 'inputBotInlineMessageID64',\n        dcId: reader.int(),\n        ownerId: reader.long(),\n        id: reader.int(),\n        accessHash: reader.long(),\n    }\n}\n\n/**\n * Generate TDLib style inline message ID\n *\n * @param id  Inline message ID object\n */\nexport function encodeInlineMessageId(id: tl.TypeInputBotInlineMessageID): string {\n    let writer: TlBinaryWriter\n\n    switch (id._) {\n        case 'inputBotInlineMessageID':\n            writer = TlBinaryWriter.manual(20)\n            writer.int(id.dcId)\n            writer.long(id.id)\n            writer.long(id.accessHash)\n            break\n        case 'inputBotInlineMessageID64':\n            writer = TlBinaryWriter.manual(24)\n            writer.int(id.dcId)\n            writer.long(id.ownerId)\n            writer.int(id.id)\n            writer.long(id.accessHash)\n            break\n        default:\n            assertNever(id)\n    }\n\n    return base64Encode(writer.result(), true)\n}\n\nexport function normalizeInlineId(id: string | tl.TypeInputBotInlineMessageID) {\n    if (typeof id === 'string') {\n        return parseInlineMessageId(id)\n    }\n\n    return id\n}\n"]}

package/esm/highlevel/utils/inline-utils.test.d.ts

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

package/esm/highlevel/utils/inline-utils.test.js

@@ -0,0 +1,42 @@
+import Long from 'long';
+import { describe, expect, it } from 'vitest';
+import { encodeInlineMessageId, normalizeInlineId, parseInlineMessageId } from './inline-utils.js';
+describe('inline message id', () => {
+    it('should encode and decode legacy inline message id', () => {
+        const id = {
+            _: 'inputBotInlineMessageID',
+            dcId: 1,
+            id: Long.fromBits(123, 456),
+            accessHash: Long.fromBits(789, 999),
+        };
+        const encoded = encodeInlineMessageId(id);
+        const parsed = parseInlineMessageId(encoded);
+        expect(encoded).toEqual('AQAAAHsAAADIAQAAFQMAAOcDAAA');
+        expect(parsed).toEqual(id);
+    });
+    it('should encode and decode 64-bit inline message id', () => {
+        const id = {
+            _: 'inputBotInlineMessageID64',
+            dcId: 1,
+            ownerId: Long.fromBits(123, 456),
+            id: 666,
+            accessHash: Long.fromBits(789, 999),
+        };
+        const encoded = encodeInlineMessageId(id);
+        const parsed = parseInlineMessageId(encoded);
+        expect(encoded).toEqual('AQAAAHsAAADIAQAAmgIAABUDAADnAwAA');
+        expect(parsed).toEqual(id);
+    });
+    it('should normalize to tl object', () => {
+        const id = {
+            _: 'inputBotInlineMessageID64',
+            dcId: 1,
+            ownerId: Long.fromBits(123, 456),
+            id: 666,
+            accessHash: Long.fromBits(789, 999),
+        };
+        expect(normalizeInlineId('AQAAAHsAAADIAQAAmgIAABUDAADnAwAA')).toEqual(id);
+        expect(normalizeInlineId(id)).toBe(id);
+    });
+});
+//# sourceMappingURL=inline-utils.test.js.map

package/esm/highlevel/utils/inline-utils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inline-utils.test.js","sourceRoot":"","sources":["../../../../src/highlevel/utils/inline-utils.test.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAA;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAI7C,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAElG,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QACzD,MAAM,EAAE,GAAkC;YACtC,CAAC,EAAE,yBAAyB;YAC5B,IAAI,EAAE,CAAC;YACP,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;YAC3B,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;SACtC,CAAA;QACD,MAAM,OAAO,GAAG,qBAAqB,CAAC,EAAE,CAAC,CAAA;QACzC,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAA;QAE5C,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAA;QACtD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAC9B,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QACzD,MAAM,EAAE,GAAoC;YACxC,CAAC,EAAE,2BAA2B;YAC9B,IAAI,EAAE,CAAC;YACP,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;YAChC,EAAE,EAAE,GAAG;YACP,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;SACtC,CAAA;QACD,MAAM,OAAO,GAAG,qBAAqB,CAAC,EAAE,CAAC,CAAA;QACzC,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAA;QAE5C,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,kCAAkC,CAAC,CAAA;QAC3D,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAC9B,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACrC,MAAM,EAAE,GAAoC;YACxC,CAAC,EAAE,2BAA2B;YAC9B,IAAI,EAAE,CAAC;YACP,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;YAChC,EAAE,EAAE,GAAG;YACP,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;SACtC,CAAA;QAED,MAAM,CAAC,iBAAiB,CAAC,kCAAkC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;QACzE,MAAM,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAC1C,CAAC,CAAC,CAAA;AACN,CAAC,CAAC,CAAA","sourcesContent":["import Long from 'long'\nimport { describe, expect, it } from 'vitest'\n\nimport { tl } from '@mtcute/tl'\n\nimport { encodeInlineMessageId, normalizeInlineId, parseInlineMessageId } from './inline-utils.js'\n\ndescribe('inline message id', () => {\n    it('should encode and decode legacy inline message id', () => {\n        const id: tl.RawInputBotInlineMessageID = {\n            _: 'inputBotInlineMessageID',\n            dcId: 1,\n            id: Long.fromBits(123, 456),\n            accessHash: Long.fromBits(789, 999),\n        }\n        const encoded = encodeInlineMessageId(id)\n        const parsed = parseInlineMessageId(encoded)\n\n        expect(encoded).toEqual('AQAAAHsAAADIAQAAFQMAAOcDAAA')\n        expect(parsed).toEqual(id)\n    })\n\n    it('should encode and decode 64-bit inline message id', () => {\n        const id: tl.RawInputBotInlineMessageID64 = {\n            _: 'inputBotInlineMessageID64',\n            dcId: 1,\n            ownerId: Long.fromBits(123, 456),\n            id: 666,\n            accessHash: Long.fromBits(789, 999),\n        }\n        const encoded = encodeInlineMessageId(id)\n        const parsed = parseInlineMessageId(encoded)\n\n        expect(encoded).toEqual('AQAAAHsAAADIAQAAmgIAABUDAADnAwAA')\n        expect(parsed).toEqual(id)\n    })\n\n    it('should normalize to tl object', () => {\n        const id: tl.RawInputBotInlineMessageID64 = {\n            _: 'inputBotInlineMessageID64',\n            dcId: 1,\n            ownerId: Long.fromBits(123, 456),\n            id: 666,\n            accessHash: Long.fromBits(789, 999),\n        }\n\n        expect(normalizeInlineId('AQAAAHsAAADIAQAAmgIAABUDAADnAwAA')).toEqual(id)\n        expect(normalizeInlineId(id)).toBe(id)\n    })\n})\n"]}

package/esm/highlevel/utils/inspectable.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Small helper function that adds `toJSON` and `util.custom.inspect`
+ * methods to a given class based on its getters
+ *
+ * > **Note**: This means that all getters must be pure!
+ * > (getter that caches after its first invocation is also
+ * > considered pure in this case)
+ */
+export declare function makeInspectable<T>(obj: new (...args: any[]) => T, props?: (keyof T)[], hide?: (keyof T)[]): void;

package/esm/highlevel/utils/inspectable.js

@@ -0,0 +1,61 @@
+/* eslint-disable @typescript-eslint/no-explicit-any,@typescript-eslint/no-unsafe-assignment */
+/* eslint-disable @typescript-eslint/no-unsafe-call,@typescript-eslint/no-unsafe-argument */
+import { base64Encode } from '@mtcute/tl-runtime';
+const customInspectSymbol = Symbol.for('nodejs.util.inspect.custom');
+// get all property names. unlike Object.getOwnPropertyNames,
+// also gets inherited property names
+function getAllGettersNames(obj) {
+    const getters = [];
+    do {
+        Object.getOwnPropertyNames(obj).forEach((prop) => {
+            if (prop !== '__proto__' &&
+                Object.getOwnPropertyDescriptor(obj, prop)?.get &&
+                !getters.includes(prop)) {
+                getters.push(prop);
+            }
+        });
+    } while ((obj = Object.getPrototypeOf(obj)));
+    return getters;
+}
+/**
+ * Small helper function that adds `toJSON` and `util.custom.inspect`
+ * methods to a given class based on its getters
+ *
+ * > **Note**: This means that all getters must be pure!
+ * > (getter that caches after its first invocation is also
+ * > considered pure in this case)
+ */
+export function makeInspectable(obj, props, hide) {
+    const getters = props ? props : [];
+    for (const key of getAllGettersNames(obj.prototype)) {
+        if (!hide || !hide.includes(key))
+            getters.push(key);
+    }
+    // dirty hack to set name for inspect result
+    // eslint-disable-next-line @typescript-eslint/no-implied-eval
+    const proto = new Function(`return function ${obj.name}(){}`)().prototype;
+    obj.prototype.toJSON = function () {
+        const ret = Object.create(proto);
+        getters.forEach((it) => {
+            try {
+                let val = this[it];
+                if (val && typeof val === 'object') {
+                    if (val instanceof Uint8Array) {
+                        val = base64Encode(val);
+                    }
+                    else if (typeof val.toJSON === 'function') {
+                        val = val.toJSON(true);
+                    }
+                }
+                ret[it] = val;
+            }
+            catch (e) {
+                ret[it] = 'Error: ' + e.message;
+            }
+        });
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+        return ret;
+    };
+    obj.prototype[customInspectSymbol] = obj.prototype.toJSON;
+}
+//# sourceMappingURL=inspectable.js.map

package/esm/highlevel/utils/inspectable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspectable.js","sourceRoot":"","sources":["../../../../src/highlevel/utils/inspectable.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,4FAA4F;AAE5F,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,MAAM,mBAAmB,GAAG,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAA;AAEpE,6DAA6D;AAC7D,qCAAqC;AACrC,SAAS,kBAAkB,CAAI,GAAM;IACjC,MAAM,OAAO,GAAgB,EAAE,CAAA;IAE/B,GAAG;QACC,MAAM,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;YAC7C,IACI,IAAI,KAAK,WAAW;gBACpB,MAAM,CAAC,wBAAwB,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG;gBAC/C,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAW,CAAC,EAChC;gBACE,OAAO,CAAC,IAAI,CAAC,IAAW,CAAC,CAAA;aAC5B;QACL,CAAC,CAAC,CAAA;KACL,QAAQ,CAAC,GAAG,GAAG,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,EAAC;IAE5C,OAAO,OAAO,CAAA;AAClB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAI,GAA8B,EAAE,KAAmB,EAAE,IAAkB;IACtG,MAAM,OAAO,GAAgB,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;IAE/C,KAAK,MAAM,GAAG,IAAI,kBAAkB,CAAI,GAAG,CAAC,SAAS,CAAC,EAAE;QACpD,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;KACtD;IAED,4CAA4C;IAC5C,8DAA8D;IAC9D,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,mBAAmB,GAAG,CAAC,IAAI,MAAM,CAAC,EAAE,CAAC,SAAS,CAAA;IAEzE,GAAG,CAAC,SAAS,CAAC,MAAM,GAAG;QACnB,MAAM,GAAG,GAAQ,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QACrC,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE;YACnB,IAAI;gBACA,IAAI,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,CAAA;gBAElB,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE;oBAChC,IAAI,GAAG,YAAY,UAAU,EAAE;wBAC3B,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,CAAA;qBAC1B;yBAAM,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,UAAU,EAAE;wBACzC,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;qBACzB;iBACJ;gBACD,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAA;aAChB;YAAC,OAAO,CAAM,EAAE;gBACb,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC,OAAO,CAAA;aAClC;QACL,CAAC,CAAC,CAAA;QAEF,+DAA+D;QAC/D,OAAO,GAAG,CAAA;IACd,CAAC,CAAA;IACD,GAAG,CAAC,SAAS,CAAC,mBAAmB,CAAC,GAAG,GAAG,CAAC,SAAS,CAAC,MAAM,CAAA;AAC7D,CAAC","sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any,@typescript-eslint/no-unsafe-assignment */\n/* eslint-disable @typescript-eslint/no-unsafe-call,@typescript-eslint/no-unsafe-argument */\n\nimport { base64Encode } from '@mtcute/tl-runtime'\n\nconst customInspectSymbol = Symbol.for('nodejs.util.inspect.custom')\n\n// get all property names. unlike Object.getOwnPropertyNames,\n// also gets inherited property names\nfunction getAllGettersNames<T>(obj: T): (keyof T)[] {\n    const getters: (keyof T)[] = []\n\n    do {\n        Object.getOwnPropertyNames(obj).forEach((prop) => {\n            if (\n                prop !== '__proto__' &&\n                Object.getOwnPropertyDescriptor(obj, prop)?.get &&\n                !getters.includes(prop as any)\n            ) {\n                getters.push(prop as any)\n            }\n        })\n    } while ((obj = Object.getPrototypeOf(obj)))\n\n    return getters\n}\n\n/**\n * Small helper function that adds `toJSON` and `util.custom.inspect`\n * methods to a given class based on its getters\n *\n * > **Note**: This means that all getters must be pure!\n * > (getter that caches after its first invocation is also\n * > considered pure in this case)\n */\nexport function makeInspectable<T>(obj: new (...args: any[]) => T, props?: (keyof T)[], hide?: (keyof T)[]): void {\n    const getters: (keyof T)[] = props ? props : []\n\n    for (const key of getAllGettersNames<T>(obj.prototype)) {\n        if (!hide || !hide.includes(key)) getters.push(key)\n    }\n\n    // dirty hack to set name for inspect result\n    // eslint-disable-next-line @typescript-eslint/no-implied-eval\n    const proto = new Function(`return function ${obj.name}(){}`)().prototype\n\n    obj.prototype.toJSON = function () {\n        const ret: any = Object.create(proto)\n        getters.forEach((it) => {\n            try {\n                let val = this[it]\n\n                if (val && typeof val === 'object') {\n                    if (val instanceof Uint8Array) {\n                        val = base64Encode(val)\n                    } else if (typeof val.toJSON === 'function') {\n                        val = val.toJSON(true)\n                    }\n                }\n                ret[it] = val\n            } catch (e: any) {\n                ret[it] = 'Error: ' + e.message\n            }\n        })\n\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n        return ret\n    }\n    obj.prototype[customInspectSymbol] = obj.prototype.toJSON\n}\n"]}

package/esm/highlevel/utils/inspectable.test.d.ts

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

package/esm/highlevel/utils/inspectable.test.js

@@ -0,0 +1,95 @@
+import { describe, expect, it, vi } from 'vitest';
+import { makeInspectable } from './inspectable.js';
+describe('makeInspectable', () => {
+    // eslint-disable-next-line
+    const inspect = (obj) => obj.toJSON();
+    it('should make all getters inspectable', () => {
+        class Foo {
+            get foo() {
+                return 1;
+            }
+            get bar() {
+                return 2;
+            }
+        }
+        makeInspectable(Foo);
+        expect(inspect(new Foo())).toEqual({ foo: 1, bar: 2 });
+    });
+    it('should use nested classes toJSON', () => {
+        class Inner {
+            constructor() {
+                this.toJSON = vi.fn().mockReturnValue(42);
+            }
+        }
+        const inner = new Inner();
+        class Foo {
+            get foo() {
+                return inner;
+            }
+        }
+        makeInspectable(Foo);
+        expect(inspect(new Foo())).toEqual({ foo: 42 });
+        expect(inner.toJSON).toHaveBeenCalledTimes(1);
+    });
+    it('should not inspect fields', () => {
+        class Foo {
+            constructor() {
+                this.bar = 2;
+            }
+            get foo() {
+                return 1;
+            }
+        }
+        makeInspectable(Foo);
+        expect(inspect(new Foo())).toEqual({ foo: 1 });
+    });
+    it('should inspect fields if specified', () => {
+        class Foo {
+            constructor() {
+                this.bar = 1;
+                this.baz = 2;
+            }
+        }
+        makeInspectable(Foo, ['bar']);
+        expect(inspect(new Foo())).toEqual({ bar: 1 });
+    });
+    it('should hide getters if specified', () => {
+        class Foo {
+            get foo() {
+                return 1;
+            }
+            get bar() {
+                return 2;
+            }
+        }
+        makeInspectable(Foo, undefined, ['foo']);
+        expect(inspect(new Foo())).toEqual({ bar: 2 });
+    });
+    it('should handle errors', () => {
+        class Foo {
+            get foo() {
+                return 1;
+            }
+            get bar() {
+                throw new Error('whatever');
+            }
+        }
+        makeInspectable(Foo);
+        expect(inspect(new Foo())).toEqual({
+            foo: 1,
+            bar: 'Error: whatever',
+        });
+    });
+    it('should handle Uint8Arrays', () => {
+        class Foo {
+            get foo() {
+                return new Uint8Array([1, 2, 3]);
+            }
+        }
+        makeInspectable(Foo);
+        expect(inspect(new Foo())).toEqual({
+            foo: 'AQID',
+        });
+    });
+});
+//# sourceMappingURL=inspectable.test.js.map