@mtcute/core 0.5.0 → 0.7.0

package/cjs/highlevel/types/misc/sticker-set.js

@@ -0,0 +1,220 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StickerSet = exports.normalizeInputStickerSet = void 0;
+const errors_js_1 = require("../../../types/errors.js");
+const long_utils_js_1 = require("../../../utils/long-utils.js");
+const index_js_1 = require("../../utils/index.js");
+const memoize_js_1 = require("../../utils/memoize.js");
+const errors_js_2 = require("../errors.js");
+const document_utils_js_1 = require("../media/document-utils.js");
+const index_js_2 = require("../media/index.js");
+function normalizeInputStickerSet(input) {
+    if (typeof input === 'string') {
+        return {
+            _: 'inputStickerSetShortName',
+            shortName: input,
+        };
+    }
+    if ('_' in input)
+        return input;
+    if (input instanceof StickerSet)
+        return input.inputStickerSet;
+    if ('dice' in input) {
+        return {
+            _: 'inputStickerSetDice',
+            emoticon: input.dice,
+        };
+    }
+    switch (input.system) {
+        case 'animated':
+            return { _: 'inputStickerSetAnimatedEmoji' };
+        case 'animated_animations':
+            return { _: 'inputStickerSetAnimatedEmojiAnimations' };
+        case 'premium_gifts':
+            return { _: 'inputStickerSetPremiumGifts' };
+        case 'generic_animations':
+            return { _: 'inputStickerSetEmojiGenericAnimations' };
+        case 'default_statuses':
+            return { _: 'inputStickerSetEmojiDefaultStatuses' };
+        case 'default_topic_icons':
+            return { _: 'inputStickerSetEmojiDefaultTopicIcons' };
+        case 'default_channel_statuses':
+            return { _: 'inputStickerSetEmojiChannelDefaultStatuses' };
+    }
+}
+exports.normalizeInputStickerSet = normalizeInputStickerSet;
+/**
+ * A sticker set (aka sticker pack)
+ */
+class StickerSet {
+    constructor(raw) {
+        if (raw._ === 'messages.stickerSet') {
+            this.full = raw;
+            this.brief = raw.set;
+        }
+        else if (raw._ === 'stickerSet') {
+            this.brief = raw;
+        }
+        else {
+            throw new errors_js_1.MtTypeAssertionError('StickerSet', 'messages.stickerSet | stickerSet', raw._);
+        }
+        this.isFull = raw._ === 'messages.stickerSet';
+    }
+    /**
+     * Whether this sticker set was archived
+     * (due to too many saved stickers in the current account)
+     */
+    get isArchived() {
+        return this.brief.archived;
+    }
+    /**
+     * Whether this stickerset is official
+     */
+    get isOfficial() {
+        return this.brief.official;
+    }
+    /**
+     * Type of the stickers in this set
+     */
+    get type() {
+        if (this.brief.masks) {
+            return 'mask';
+        }
+        if (this.brief.emojis) {
+            return 'emoji';
+        }
+        return 'sticker';
+    }
+    /**
+     * Source file type of the stickers in this set
+     */
+    get sourceType() {
+        if (this.brief.animated) {
+            return 'animated';
+        }
+        if (this.brief.videos) {
+            return 'video';
+        }
+        return 'static';
+    }
+    /**
+     * Date when this sticker set was installed
+     */
+    get installedDate() {
+        return this.brief.installedDate ? new Date(this.brief.installedDate * 1000) : null;
+    }
+    /**
+     * Number of stickers in this sticker set
+     */
+    get count() {
+        return this.brief.count;
+    }
+    /**
+     * Input sticker set to be used in other API methods
+     */
+    get inputStickerSet() {
+        return {
+            _: 'inputStickerSetID',
+            id: this.brief.id,
+            accessHash: this.brief.accessHash,
+        };
+    }
+    /**
+     * Title of the sticker set
+     */
+    get title() {
+        return this.brief.title;
+    }
+    /**
+     * Short name of sticker set to use in `tg://addstickers?set=short_name`
+     * or `https://t.me/addstickers/short_name`
+     */
+    get shortName() {
+        return this.brief.shortName;
+    }
+    /**
+     * List of stickers inside this sticker set
+     *
+     * @throws MtEmptyError
+     *     In case this object does not contain info about stickers (i.e. {@link isFull} = false)
+     */
+    get stickers() {
+        if (!this.isFull)
+            throw new errors_js_2.MtEmptyError();
+        const stickers = [];
+        const index = new long_utils_js_1.LongMap();
+        this.full.documents.forEach((doc) => {
+            const sticker = (0, document_utils_js_1.parseDocument)(doc);
+            if (!(sticker instanceof index_js_2.Sticker)) {
+                throw new errors_js_1.MtTypeAssertionError('full.documents', 'Sticker', sticker.mimeType);
+            }
+            const info = {
+                alt: sticker.emoji,
+                emoji: '',
+                sticker,
+            };
+            stickers.push(info);
+            index.set(doc.id, info);
+        });
+        this.full.packs.forEach((pack) => {
+            pack.documents.forEach((id) => {
+                const item = index.get(id);
+                if (item) {
+                    item.emoji += pack.emoticon;
+                }
+            });
+        });
+        return stickers;
+    }
+    /**
+     * Available sticker set thumbnails.
+     *
+     * Returns empty array if not available
+     * (i.e. first sticker should be used as thumbnail)
+     */
+    get thumbnails() {
+        return this.brief.thumbs?.map((sz) => new index_js_2.Thumbnail(this.brief, sz)) ?? [];
+    }
+    /**
+     * Get a sticker set thumbnail by its type.
+     *
+     * Thumbnail types are described in the
+     * [Telegram docs](https://core.telegram.org/api/files#image-thumbnail-types),
+     * and are also available as static members of {@link Thumbnail} for convenience.
+     *
+     * @param type  Thumbnail type
+     */
+    getThumbnail(type) {
+        return this.thumbnails.find((it) => it.type === type) ?? null;
+    }
+    /**
+     * Find stickers given their emoji.
+     *
+     * @param emoji  Emoji to search for
+     * @throws MtEmptyError
+     *     In case this object does not contain info about stickers (i.e. {@link isFull} = false)
+     */
+    getStickersByEmoji(emoji) {
+        return this.stickers.filter((it) => it.alt === emoji || it.emoji.includes(emoji));
+    }
+    _getInputDocument(idx) {
+        if (!this.full)
+            throw new errors_js_2.MtEmptyError();
+        if (idx < 0)
+            idx = this.full.documents.length + idx;
+        const doc = this.full.documents[idx];
+        if (!doc) {
+            throw new RangeError(`Sticker set does not have sticker ${idx}`);
+        }
+        return {
+            _: 'inputDocument',
+            id: doc.id,
+            accessHash: doc.accessHash,
+            fileReference: doc.fileReference,
+        };
+    }
+}
+exports.StickerSet = StickerSet;
+(0, memoize_js_1.memoizeGetters)(StickerSet, ['thumbnails', 'stickers']);
+(0, index_js_1.makeInspectable)(StickerSet, ['isFull']);
+//# sourceMappingURL=sticker-set.js.map

package/cjs/highlevel/types/misc/sticker-set.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sticker-set.js","sourceRoot":"","sources":["../../../../../src/highlevel/types/misc/sticker-set.ts"],"names":[],"mappings":"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","sourcesContent":["import { tl } from '@mtcute/tl'\n\nimport { MtTypeAssertionError } from '../../../types/errors.js'\nimport { LongMap } from '../../../utils/long-utils.js'\nimport { makeInspectable } from '../../utils/index.js'\nimport { memoizeGetters } from '../../utils/memoize.js'\nimport { MtEmptyError } from '../errors.js'\nimport { InputFileLike } from '../files/index.js'\nimport { parseDocument } from '../media/document-utils.js'\nimport { MaskPosition, Sticker, StickerSourceType, StickerType, Thumbnail } from '../media/index.js'\n\n/**\n * Input sticker set.\n * Can be one of:\n *   - Raw TL object\n *   - Sticker set short name\n *   - {@link StickerSet} object\n *   - `{ dice: \"<emoji>\" }` (e.g. `{ dice: \"🎲\" }`) - Used for fetching animated dice stickers\n *   - `{ system: string }` - for system stickersets:\n *      - `\"animated\"` - Animated emojis stickerset\n *      - `\"animated_animations\"` - Animated emoji reaction stickerset\n *         (contains animations to play when a user clicks on a given animated emoji)\n *      - `\"premium_gifts\"` - Stickers to show when receiving a gifted Telegram Premium subscription,\n *      - `\"generic_animations\"` - Generic animation stickerset containing animations to play\n *         when reacting to messages using a normal emoji without a custom animation\n *      - `\"default_statuses\"` - Default custom emoji status stickerset\n *      - `\"default_topic_icons\"` - Default custom emoji stickerset for forum topic icons\n *      - `\"default_channel_statuses\"` - Default custom emoji status stickerset for channels\n */\nexport type InputStickerSet =\n    | tl.TypeInputStickerSet\n    | { dice: string }\n    | {\n          system:\n              | 'animated'\n              | 'animated_animations'\n              | 'premium_gifts'\n              | 'generic_animations'\n              | 'default_statuses'\n              | 'default_topic_icons'\n              | 'default_channel_statuses'\n      }\n    | StickerSet\n    | string\n\nexport function normalizeInputStickerSet(input: InputStickerSet): tl.TypeInputStickerSet {\n    if (typeof input === 'string') {\n        return {\n            _: 'inputStickerSetShortName',\n            shortName: input,\n        }\n    }\n    if ('_' in input) return input\n    if (input instanceof StickerSet) return input.inputStickerSet\n\n    if ('dice' in input) {\n        return {\n            _: 'inputStickerSetDice',\n            emoticon: input.dice,\n        }\n    }\n\n    switch (input.system) {\n        case 'animated':\n            return { _: 'inputStickerSetAnimatedEmoji' }\n        case 'animated_animations':\n            return { _: 'inputStickerSetAnimatedEmojiAnimations' }\n        case 'premium_gifts':\n            return { _: 'inputStickerSetPremiumGifts' }\n        case 'generic_animations':\n            return { _: 'inputStickerSetEmojiGenericAnimations' }\n        case 'default_statuses':\n            return { _: 'inputStickerSetEmojiDefaultStatuses' }\n        case 'default_topic_icons':\n            return { _: 'inputStickerSetEmojiDefaultTopicIcons' }\n        case 'default_channel_statuses':\n            return { _: 'inputStickerSetEmojiChannelDefaultStatuses' }\n    }\n}\n\n/**\n * Information about one sticker inside the set\n */\nexport interface StickerInfo {\n    /**\n     * Primary alt emoji that is displayed in dialogs list\n     */\n    readonly alt: string\n\n    /**\n     * One or more emojis representing this sticker\n     */\n    readonly emoji: string\n\n    /**\n     * Document with the actual sticker\n     */\n    readonly sticker: Sticker\n}\n\n/**\n * A sticker set (aka sticker pack)\n */\nexport class StickerSet {\n    readonly brief: tl.RawStickerSet\n    readonly full?: tl.messages.RawStickerSet\n\n    /**\n     * Whether this object contains information about stickers inside the set\n     */\n    readonly isFull: boolean\n\n    constructor(raw: tl.TypeStickerSet | tl.messages.TypeStickerSet) {\n        if (raw._ === 'messages.stickerSet') {\n            this.full = raw\n            this.brief = raw.set\n        } else if (raw._ === 'stickerSet') {\n            this.brief = raw\n        } else {\n            throw new MtTypeAssertionError('StickerSet', 'messages.stickerSet | stickerSet', raw._)\n        }\n\n        this.isFull = raw._ === 'messages.stickerSet'\n    }\n\n    /**\n     * Whether this sticker set was archived\n     * (due to too many saved stickers in the current account)\n     */\n    get isArchived(): boolean {\n        return this.brief.archived!\n    }\n\n    /**\n     * Whether this stickerset is official\n     */\n    get isOfficial(): boolean {\n        return this.brief.official!\n    }\n\n    /**\n     * Type of the stickers in this set\n     */\n    get type(): StickerType {\n        if (this.brief.masks) {\n            return 'mask'\n        }\n\n        if (this.brief.emojis) {\n            return 'emoji'\n        }\n\n        return 'sticker'\n    }\n\n    /**\n     * Source file type of the stickers in this set\n     */\n    get sourceType(): StickerSourceType {\n        if (this.brief.animated) {\n            return 'animated'\n        }\n\n        if (this.brief.videos) {\n            return 'video'\n        }\n\n        return 'static'\n    }\n\n    /**\n     * Date when this sticker set was installed\n     */\n    get installedDate(): Date | null {\n        return this.brief.installedDate ? new Date(this.brief.installedDate * 1000) : null\n    }\n\n    /**\n     * Number of stickers in this sticker set\n     */\n    get count(): number {\n        return this.brief.count\n    }\n\n    /**\n     * Input sticker set to be used in other API methods\n     */\n    get inputStickerSet(): tl.TypeInputStickerSet {\n        return {\n            _: 'inputStickerSetID',\n            id: this.brief.id,\n            accessHash: this.brief.accessHash,\n        }\n    }\n\n    /**\n     * Title of the sticker set\n     */\n    get title(): string {\n        return this.brief.title\n    }\n\n    /**\n     * Short name of sticker set to use in `tg://addstickers?set=short_name`\n     * or `https://t.me/addstickers/short_name`\n     */\n    get shortName(): string {\n        return this.brief.shortName\n    }\n\n    /**\n     * List of stickers inside this sticker set\n     *\n     * @throws MtEmptyError\n     *     In case this object does not contain info about stickers (i.e. {@link isFull} = false)\n     */\n    get stickers(): ReadonlyArray<StickerInfo> {\n        if (!this.isFull) throw new MtEmptyError()\n\n        const stickers: StickerInfo[] = []\n        const index = new LongMap<tl.Mutable<StickerInfo>>()\n\n        this.full!.documents.forEach((doc) => {\n            const sticker = parseDocument(doc as tl.RawDocument)\n\n            if (!(sticker instanceof Sticker)) {\n                throw new MtTypeAssertionError('full.documents', 'Sticker', sticker.mimeType)\n            }\n\n            const info: tl.Mutable<StickerInfo> = {\n                alt: sticker.emoji,\n                emoji: '', // populated later\n                sticker,\n            }\n            stickers.push(info)\n            index.set(doc.id, info)\n        })\n\n        this.full!.packs.forEach((pack) => {\n            pack.documents.forEach((id) => {\n                const item = index.get(id)\n\n                if (item) {\n                    item.emoji += pack.emoticon\n                }\n            })\n        })\n\n        return stickers\n    }\n\n    /**\n     * Available sticker set thumbnails.\n     *\n     * Returns empty array if not available\n     * (i.e. first sticker should be used as thumbnail)\n     */\n    get thumbnails(): ReadonlyArray<Thumbnail> {\n        return this.brief.thumbs?.map((sz) => new Thumbnail(this.brief, sz)) ?? []\n    }\n\n    /**\n     * Get a sticker set thumbnail by its type.\n     *\n     * Thumbnail types are described in the\n     * [Telegram docs](https://core.telegram.org/api/files#image-thumbnail-types),\n     * and are also available as static members of {@link Thumbnail} for convenience.\n     *\n     * @param type  Thumbnail type\n     */\n    getThumbnail(type: string): Thumbnail | null {\n        return this.thumbnails.find((it) => it.type === type) ?? null\n    }\n\n    /**\n     * Find stickers given their emoji.\n     *\n     * @param emoji  Emoji to search for\n     * @throws MtEmptyError\n     *     In case this object does not contain info about stickers (i.e. {@link isFull} = false)\n     */\n    getStickersByEmoji(emoji: string): StickerInfo[] {\n        return this.stickers.filter((it) => it.alt === emoji || it.emoji.includes(emoji))\n    }\n\n    private _getInputDocument(idx: number): tl.TypeInputDocument {\n        if (!this.full) throw new MtEmptyError()\n\n        if (idx < 0) idx = this.full.documents.length + idx\n        const doc = this.full.documents[idx] as tl.RawDocument\n\n        if (!doc) {\n            throw new RangeError(`Sticker set does not have sticker ${idx}`)\n        }\n\n        return {\n            _: 'inputDocument',\n            id: doc.id,\n            accessHash: doc.accessHash,\n            fileReference: doc.fileReference,\n        }\n    }\n}\n\nmemoizeGetters(StickerSet, ['thumbnails', 'stickers'])\nmakeInspectable(StickerSet, ['isFull'])\n\nexport interface InputStickerSetItem {\n    /**\n     * File containing the sticker.\n     *\n     * For normal stickers: must be a `.png` or `.webp` file\n     * up to 512kb, having both dimensions `<=512px`, and having\n     * one of the dimensions `==512px`\n     *\n     * For animated stickers: must be a `.tgs` file\n     * up to 64kb, having canvas dimensions exactly\n     * `512x512`px, duration no more than 3 seconds\n     * and animated at 60fps ([source](https://core.telegram.org/animated_stickers#technical-requirements))\n     */\n    file: InputFileLike\n\n    /**\n     * One or more emojis that represent this sticker\n     */\n    emojis: string\n\n    /**\n     * In case this is a mask sticker,\n     * position of the mask\n     */\n    maskPosition?: MaskPosition\n}\n"]}

package/cjs/highlevel/types/misc/takeout-session.d.ts

@@ -0,0 +1,49 @@
+import { tl } from '@mtcute/tl';
+import { RpcCallOptions } from '../../../network/network-manager.js';
+import { MustEqual } from '../../../types/utils.js';
+import { ITelegramClient } from '../../client.types.js';
+/**
+ * Account takeout session
+ */
+export declare class TakeoutSession {
+    readonly client: ITelegramClient;
+    /**
+     * Takeout session id
+     */
+    readonly id: tl.Long;
+    constructor(client: ITelegramClient, session: tl.account.RawTakeout);
+    /**
+     * Make an API call using this takeout session
+     *
+     * This method just wraps the query into `invokeWithTakeout`
+     * and passes the control down to {@link TelegramClient.call}.
+     *
+     * @param message  RPC method to call
+     * @param params  Additional call parameters
+     */
+    call<T extends tl.RpcMethod>(message: MustEqual<T, tl.RpcMethod>, params?: RpcCallOptions): Promise<tl.RpcCallReturn[T['_']]>;
+    /**
+     * Create a proxy over {@link TelegramClient}
+     * that will use this takeout session to call methods.
+     *
+     * You can optionally provide a function to check if some
+     * RPC method should be called via a takeout session or directly,
+     * otherwise all methods are called through the takeout session.
+     *
+     * > **Note**: This will return a `Proxy` object that
+     * > overrides `call` method. Using this method requires
+     * > that your target environment supports `Proxy` and `Reflect` APIs
+     *
+     * @param predicate
+     *     Function that given the RPC call should determine whether
+     *     that call should be called via takeout session or not.
+     *     Returning `true` will use takeout session, `false` will not.
+     */
+    createProxy(predicate?: (obj: tl.TlObject) => boolean): ITelegramClient;
+    /**
+     * Finish account takeout session
+     *
+     * @param success  Whether the data was successfully exported
+     */
+    finish(success?: boolean): Promise<void>;
+}

package/cjs/highlevel/types/misc/takeout-session.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TakeoutSession = void 0;
+const type_assertions_js_1 = require("../../../utils/type-assertions.js");
+const index_js_1 = require("../../utils/index.js");
+/**
+ * Account takeout session
+ */
+class TakeoutSession {
+    constructor(client, session) {
+        this.client = client;
+        this.id = session.id;
+    }
+    /**
+     * Make an API call using this takeout session
+     *
+     * This method just wraps the query into `invokeWithTakeout`
+     * and passes the control down to {@link TelegramClient.call}.
+     *
+     * @param message  RPC method to call
+     * @param params  Additional call parameters
+     */
+    async call(message, params) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+        return this.client.call({
+            _: 'invokeWithTakeout',
+            takeoutId: this.id,
+            query: message,
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        }, params);
+    }
+    /**
+     * Create a proxy over {@link TelegramClient}
+     * that will use this takeout session to call methods.
+     *
+     * You can optionally provide a function to check if some
+     * RPC method should be called via a takeout session or directly,
+     * otherwise all methods are called through the takeout session.
+     *
+     * > **Note**: This will return a `Proxy` object that
+     * > overrides `call` method. Using this method requires
+     * > that your target environment supports `Proxy` and `Reflect` APIs
+     *
+     * @param predicate
+     *     Function that given the RPC call should determine whether
+     *     that call should be called via takeout session or not.
+     *     Returning `true` will use takeout session, `false` will not.
+     */
+    createProxy(predicate) {
+        const boundCall = predicate ?
+            (obj, params) => {
+                if (predicate(obj)) {
+                    return this.call(obj, params);
+                }
+                return this.client.call(obj, params);
+            } :
+            this.call.bind(this);
+        return new Proxy(this.client, {
+            get(target, prop, receiver) {
+                if (prop === 'call')
+                    return boundCall;
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+                return Reflect.get(target, prop, receiver);
+            },
+        });
+    }
+    /**
+     * Finish account takeout session
+     *
+     * @param success  Whether the data was successfully exported
+     */
+    async finish(success = true) {
+        const r = await this.call({
+            _: 'account.finishTakeoutSession',
+            success,
+        });
+        (0, type_assertions_js_1.assertTrue)('account.finishTakeoutSession', r);
+    }
+}
+exports.TakeoutSession = TakeoutSession;
+(0, index_js_1.makeInspectable)(TakeoutSession);
+//# sourceMappingURL=takeout-session.js.map

package/cjs/highlevel/types/misc/takeout-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"takeout-session.js","sourceRoot":"","sources":["../../../../../src/highlevel/types/misc/takeout-session.ts"],"names":[],"mappings":";;;AAIA,0EAA8D;AAE9D,mDAAsD;AAEtD;;GAEG;AACH,MAAa,cAAc;IAMvB,YACa,MAAuB,EAChC,OAA8B;QADrB,WAAM,GAAN,MAAM,CAAiB;QAGhC,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,CAAA;IACxB,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,IAAI,CACN,OAAmC,EACnC,MAAuB;QAEvB,+DAA+D;QAC/D,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CACnB;YACI,CAAC,EAAE,mBAAmB;YACtB,SAAS,EAAE,IAAI,CAAC,EAAE;YAClB,KAAK,EAAE,OAAO;YACd,8DAA8D;SAC1D,EACR,MAAM,CACT,CAAA;IACL,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,WAAW,CAAC,SAAyC;QACjD,MAAM,SAAS,GAA2B,SAAS,CAAC,CAAC;YACjD,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;gBACZ,IAAI,SAAS,CAAC,GAAG,CAAC,EAAE;oBAChB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;iBAChC;gBAED,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;YACxC,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAExB,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE;YAC1B,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ;gBACtB,IAAI,IAAI,KAAK,MAAM;oBAAE,OAAO,SAAS,CAAA;gBAErC,+DAA+D;gBAC/D,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAA;YAC9C,CAAC;SACJ,CAAC,CAAA;IACN,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,OAAO,GAAG,IAAI;QACvB,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC;YACtB,CAAC,EAAE,8BAA8B;YACjC,OAAO;SACV,CAAC,CAAA;QAEF,IAAA,+BAAU,EAAC,8BAA8B,EAAE,CAAC,CAAC,CAAA;IACjD,CAAC;CACJ;AAzFD,wCAyFC;AAED,IAAA,0BAAe,EAAC,cAAc,CAAC,CAAA","sourcesContent":["import { tl } from '@mtcute/tl'\n\nimport { RpcCallOptions } from '../../../network/network-manager.js'\nimport { MustEqual } from '../../../types/utils.js'\nimport { assertTrue } from '../../../utils/type-assertions.js'\nimport { ITelegramClient } from '../../client.types.js'\nimport { makeInspectable } from '../../utils/index.js'\n\n/**\n * Account takeout session\n */\nexport class TakeoutSession {\n    /**\n     * Takeout session id\n     */\n    readonly id: tl.Long\n\n    constructor(\n        readonly client: ITelegramClient,\n        session: tl.account.RawTakeout,\n    ) {\n        this.id = session.id\n    }\n\n    /**\n     * Make an API call using this takeout session\n     *\n     * This method just wraps the query into `invokeWithTakeout`\n     * and passes the control down to {@link TelegramClient.call}.\n     *\n     * @param message  RPC method to call\n     * @param params  Additional call parameters\n     */\n    async call<T extends tl.RpcMethod>(\n        message: MustEqual<T, tl.RpcMethod>,\n        params?: RpcCallOptions,\n    ): Promise<tl.RpcCallReturn[T['_']]> {\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n        return this.client.call(\n            {\n                _: 'invokeWithTakeout',\n                takeoutId: this.id,\n                query: message,\n                // eslint-disable-next-line @typescript-eslint/no-explicit-any\n            } as any,\n            params,\n        )\n    }\n\n    /**\n     * Create a proxy over {@link TelegramClient}\n     * that will use this takeout session to call methods.\n     *\n     * You can optionally provide a function to check if some\n     * RPC method should be called via a takeout session or directly,\n     * otherwise all methods are called through the takeout session.\n     *\n     * > **Note**: This will return a `Proxy` object that\n     * > overrides `call` method. Using this method requires\n     * > that your target environment supports `Proxy` and `Reflect` APIs\n     *\n     * @param predicate\n     *     Function that given the RPC call should determine whether\n     *     that call should be called via takeout session or not.\n     *     Returning `true` will use takeout session, `false` will not.\n     */\n    createProxy(predicate?: (obj: tl.TlObject) => boolean): ITelegramClient {\n        const boundCall: TakeoutSession['call'] = predicate ?\n            (obj, params) => {\n                if (predicate(obj)) {\n                    return this.call(obj, params)\n                }\n\n                return this.client.call(obj, params)\n            } :\n            this.call.bind(this)\n\n        return new Proxy(this.client, {\n            get(target, prop, receiver) {\n                if (prop === 'call') return boundCall\n\n                // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n                return Reflect.get(target, prop, receiver)\n            },\n        })\n    }\n\n    /**\n     * Finish account takeout session\n     *\n     * @param success  Whether the data was successfully exported\n     */\n    async finish(success = true): Promise<void> {\n        const r = await this.call({\n            _: 'account.finishTakeoutSession',\n            success,\n        })\n\n        assertTrue('account.finishTakeoutSession', r)\n    }\n}\n\nmakeInspectable(TakeoutSession)\n"]}

package/cjs/highlevel/types/peers/chat-colors.d.ts

@@ -0,0 +1,25 @@
+import { tl } from '@mtcute/tl';
+/**
+ * Information about colors of a chat
+ */
+export declare class ChatColors {
+    private readonly _peerId;
+    readonly raw?: tl.RawPeerColor | undefined;
+    constructor(_peerId: number, raw?: tl.RawPeerColor | undefined);
+    /**
+     * Color ID
+     *
+     * Note that this value is **not** an RGB color representation. Instead, it is
+     * a number which should be used to pick a color from a predefined
+     * list of colors:
+     *  - `0-6` are the default colors used by Telegram clients:
+     *    `red, orange, purple, green, sea, blue, pink`
+     *  - `>= 7` are returned by `help.getAppConfig`.
+     */
+    get color(): number;
+    /**
+     * ID of the emoji that should be used as a background pattern
+     * when rendering the color
+     */
+    get backgroundEmojiId(): tl.Long | null;
+}

package/cjs/highlevel/types/peers/chat-colors.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChatColors = void 0;
+const inspectable_js_1 = require("../../utils/inspectable.js");
+/**
+ * Information about colors of a chat
+ */
+class ChatColors {
+    constructor(_peerId, raw) {
+        this._peerId = _peerId;
+        this.raw = raw;
+    }
+    /**
+     * Color ID
+     *
+     * Note that this value is **not** an RGB color representation. Instead, it is
+     * a number which should be used to pick a color from a predefined
+     * list of colors:
+     *  - `0-6` are the default colors used by Telegram clients:
+     *    `red, orange, purple, green, sea, blue, pink`
+     *  - `>= 7` are returned by `help.getAppConfig`.
+     */
+    get color() {
+        return this.raw?.color ?? this._peerId % 7;
+    }
+    /**
+     * ID of the emoji that should be used as a background pattern
+     * when rendering the color
+     */
+    get backgroundEmojiId() {
+        return this.raw?.backgroundEmojiId ?? null;
+    }
+}
+exports.ChatColors = ChatColors;
+(0, inspectable_js_1.makeInspectable)(ChatColors);
+//# sourceMappingURL=chat-colors.js.map

package/cjs/highlevel/types/peers/chat-colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-colors.js","sourceRoot":"","sources":["../../../../../src/highlevel/types/peers/chat-colors.ts"],"names":[],"mappings":";;;AAEA,+DAA4D;AAE5D;;GAEG;AACH,MAAa,UAAU;IACnB,YACqB,OAAe,EACvB,GAAqB;QADb,YAAO,GAAP,OAAO,CAAQ;QACvB,QAAG,GAAH,GAAG,CAAkB;IAC/B,CAAC;IAEJ;;;;;;;;;OASG;IACH,IAAI,KAAK;QACL,OAAO,IAAI,CAAC,GAAG,EAAE,KAAK,IAAI,IAAI,CAAC,OAAO,GAAG,CAAC,CAAA;IAC9C,CAAC;IAED;;;OAGG;IACH,IAAI,iBAAiB;QACjB,OAAO,IAAI,CAAC,GAAG,EAAE,iBAAiB,IAAI,IAAI,CAAA;IAC9C,CAAC;CACJ;AA3BD,gCA2BC;AAED,IAAA,gCAAe,EAAC,UAAU,CAAC,CAAA","sourcesContent":["import { tl } from '@mtcute/tl'\n\nimport { makeInspectable } from '../../utils/inspectable.js'\n\n/**\n * Information about colors of a chat\n */\nexport class ChatColors {\n    constructor(\n        private readonly _peerId: number,\n        readonly raw?: tl.RawPeerColor,\n    ) {}\n\n    /**\n     * Color ID\n     *\n     * Note that this value is **not** an RGB color representation. Instead, it is\n     * a number which should be used to pick a color from a predefined\n     * list of colors:\n     *  - `0-6` are the default colors used by Telegram clients:\n     *    `red, orange, purple, green, sea, blue, pink`\n     *  - `>= 7` are returned by `help.getAppConfig`.\n     */\n    get color(): number {\n        return this.raw?.color ?? this._peerId % 7\n    }\n\n    /**\n     * ID of the emoji that should be used as a background pattern\n     * when rendering the color\n     */\n    get backgroundEmojiId(): tl.Long | null {\n        return this.raw?.backgroundEmojiId ?? null\n    }\n}\n\nmakeInspectable(ChatColors)\n"]}