@mtcute/core 0.6.0 → 0.7.0

package/cjs/highlevel/types/updates/user-typing-update.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserTypingUpdate = void 0;
+const utils_js_1 = require("../../../types/utils.js");
+const peer_utils_js_1 = require("../../../utils/peer-utils.js");
+const index_js_1 = require("../../utils/index.js");
+/**
+ * User's typing status has changed.
+ *
+ * This update is valid for 6 seconds.
+ */
+class UserTypingUpdate {
+    constructor(raw) {
+        this.raw = raw;
+    }
+    /**
+     * ID of the user whose typing status changed
+     */
+    get userId() {
+        return this.raw._ === 'updateUserTyping' ? this.raw.userId : (0, peer_utils_js_1.getBarePeerId)(this.raw.fromId);
+    }
+    /**
+     * Marked ID of the chat where the user is typing,
+     *
+     * If the user is typing in PMs, this will
+     * equal to {@link userId}
+     */
+    get chatId() {
+        switch (this.raw._) {
+            case 'updateUserTyping':
+                return this.raw.userId;
+            case 'updateChatUserTyping':
+                return -this.raw.chatId;
+            case 'updateChannelUserTyping':
+                return (0, peer_utils_js_1.toggleChannelIdMark)(this.raw.channelId);
+        }
+    }
+    /**
+     * Type of the chat where this event has occurred
+     */
+    get chatType() {
+        switch (this.raw._) {
+            case 'updateUserTyping':
+                return 'user';
+            case 'updateChatUserTyping':
+                return 'chat';
+            case 'updateChannelUserTyping':
+                return 'channel';
+        }
+    }
+    /**
+     * Current typing status
+     */
+    get status() {
+        switch (this.raw.action._) {
+            case 'sendMessageTypingAction':
+                return 'typing';
+            case 'sendMessageCancelAction':
+                return 'cancel';
+            case 'sendMessageRecordVideoAction':
+                return 'record_video';
+            case 'sendMessageUploadVideoAction':
+                return 'upload_video';
+            case 'sendMessageRecordAudioAction':
+                return 'record_voice';
+            case 'sendMessageUploadAudioAction':
+                return 'upload_voice';
+            case 'sendMessageUploadPhotoAction':
+                return 'upload_photo';
+            case 'sendMessageUploadDocumentAction':
+                return 'upload_document';
+            case 'sendMessageGeoLocationAction':
+                return 'geo';
+            case 'sendMessageGamePlayAction':
+                return 'game';
+            case 'sendMessageChooseContactAction':
+                return 'contact';
+            case 'sendMessageRecordRoundAction':
+                return 'record_round';
+            case 'sendMessageUploadRoundAction':
+                return 'upload_round';
+            case 'speakingInGroupCallAction':
+                return 'speak_call';
+            case 'sendMessageHistoryImportAction':
+                return 'history_import';
+            case 'sendMessageChooseStickerAction':
+                return 'sticker';
+            case 'sendMessageEmojiInteraction':
+                return 'interaction';
+            case 'sendMessageEmojiInteractionSeen':
+                return 'interaction_seen';
+            default:
+                (0, utils_js_1.assertNever)(this.raw.action);
+        }
+    }
+}
+exports.UserTypingUpdate = UserTypingUpdate;
+(0, index_js_1.makeInspectable)(UserTypingUpdate);
+//# sourceMappingURL=user-typing-update.js.map

package/cjs/highlevel/types/updates/user-typing-update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-typing-update.js","sourceRoot":"","sources":["../../../../../src/highlevel/types/updates/user-typing-update.ts"],"names":[],"mappings":";;;AAGA,sDAAqD;AACrD,gEAAiF;AACjF,mDAAsD;AAGtD;;;;GAIG;AACH,MAAa,gBAAgB;IACzB,YAAqB,GAAwF;QAAxF,QAAG,GAAH,GAAG,CAAqF;IAAG,CAAC;IAEjH;;OAEG;IACH,IAAI,MAAM;QACN,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAA,6BAAa,EAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IAC/F,CAAC;IAED;;;;;OAKG;IACH,IAAI,MAAM;QACN,QAAQ,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE;YAChB,KAAK,kBAAkB;gBACnB,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAA;YAC1B,KAAK,sBAAsB;gBACvB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAA;YAC3B,KAAK,yBAAyB;gBAC1B,OAAO,IAAA,mCAAmB,EAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;SACrD;IACL,CAAC;IAED;;OAEG;IACH,IAAI,QAAQ;QACR,QAAQ,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE;YAChB,KAAK,kBAAkB;gBACnB,OAAO,MAAM,CAAA;YACjB,KAAK,sBAAsB;gBACvB,OAAO,MAAM,CAAA;YACjB,KAAK,yBAAyB;gBAC1B,OAAO,SAAS,CAAA;SACvB;IACL,CAAC;IAED;;OAEG;IACH,IAAI,MAAM;QACN,QAAQ,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE;YACvB,KAAK,yBAAyB;gBAC1B,OAAO,QAAQ,CAAA;YACnB,KAAK,yBAAyB;gBAC1B,OAAO,QAAQ,CAAA;YACnB,KAAK,8BAA8B;gBAC/B,OAAO,cAAc,CAAA;YACzB,KAAK,8BAA8B;gBAC/B,OAAO,cAAc,CAAA;YACzB,KAAK,8BAA8B;gBAC/B,OAAO,cAAc,CAAA;YACzB,KAAK,8BAA8B;gBAC/B,OAAO,cAAc,CAAA;YACzB,KAAK,8BAA8B;gBAC/B,OAAO,cAAc,CAAA;YACzB,KAAK,iCAAiC;gBAClC,OAAO,iBAAiB,CAAA;YAC5B,KAAK,8BAA8B;gBAC/B,OAAO,KAAK,CAAA;YAChB,KAAK,2BAA2B;gBAC5B,OAAO,MAAM,CAAA;YACjB,KAAK,gCAAgC;gBACjC,OAAO,SAAS,CAAA;YACpB,KAAK,8BAA8B;gBAC/B,OAAO,cAAc,CAAA;YACzB,KAAK,8BAA8B;gBAC/B,OAAO,cAAc,CAAA;YACzB,KAAK,2BAA2B;gBAC5B,OAAO,YAAY,CAAA;YACvB,KAAK,gCAAgC;gBACjC,OAAO,gBAAgB,CAAA;YAC3B,KAAK,gCAAgC;gBACjC,OAAO,SAAS,CAAA;YACpB,KAAK,6BAA6B;gBAC9B,OAAO,aAAa,CAAA;YACxB,KAAK,iCAAiC;gBAClC,OAAO,kBAAkB,CAAA;YAC7B;gBACI,IAAA,sBAAW,EAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;SACnC;IACL,CAAC;CACJ;AAtFD,4CAsFC;AAED,IAAA,0BAAe,EAAC,gBAAgB,CAAC,CAAA","sourcesContent":["import { tl } from '@mtcute/tl'\n\nimport { BasicPeerType } from '../../../types/peers.js'\nimport { assertNever } from '../../../types/utils.js'\nimport { getBarePeerId, toggleChannelIdMark } from '../../../utils/peer-utils.js'\nimport { makeInspectable } from '../../utils/index.js'\nimport { TypingStatus } from '../peers/index.js'\n\n/**\n * User's typing status has changed.\n *\n * This update is valid for 6 seconds.\n */\nexport class UserTypingUpdate {\n    constructor(readonly raw: tl.RawUpdateUserTyping | tl.RawUpdateChatUserTyping | tl.RawUpdateChannelUserTyping) {}\n\n    /**\n     * ID of the user whose typing status changed\n     */\n    get userId(): number {\n        return this.raw._ === 'updateUserTyping' ? this.raw.userId : getBarePeerId(this.raw.fromId)\n    }\n\n    /**\n     * Marked ID of the chat where the user is typing,\n     *\n     * If the user is typing in PMs, this will\n     * equal to {@link userId}\n     */\n    get chatId(): number {\n        switch (this.raw._) {\n            case 'updateUserTyping':\n                return this.raw.userId\n            case 'updateChatUserTyping':\n                return -this.raw.chatId\n            case 'updateChannelUserTyping':\n                return toggleChannelIdMark(this.raw.channelId)\n        }\n    }\n\n    /**\n     * Type of the chat where this event has occurred\n     */\n    get chatType(): BasicPeerType {\n        switch (this.raw._) {\n            case 'updateUserTyping':\n                return 'user'\n            case 'updateChatUserTyping':\n                return 'chat'\n            case 'updateChannelUserTyping':\n                return 'channel'\n        }\n    }\n\n    /**\n     * Current typing status\n     */\n    get status(): TypingStatus {\n        switch (this.raw.action._) {\n            case 'sendMessageTypingAction':\n                return 'typing'\n            case 'sendMessageCancelAction':\n                return 'cancel'\n            case 'sendMessageRecordVideoAction':\n                return 'record_video'\n            case 'sendMessageUploadVideoAction':\n                return 'upload_video'\n            case 'sendMessageRecordAudioAction':\n                return 'record_voice'\n            case 'sendMessageUploadAudioAction':\n                return 'upload_voice'\n            case 'sendMessageUploadPhotoAction':\n                return 'upload_photo'\n            case 'sendMessageUploadDocumentAction':\n                return 'upload_document'\n            case 'sendMessageGeoLocationAction':\n                return 'geo'\n            case 'sendMessageGamePlayAction':\n                return 'game'\n            case 'sendMessageChooseContactAction':\n                return 'contact'\n            case 'sendMessageRecordRoundAction':\n                return 'record_round'\n            case 'sendMessageUploadRoundAction':\n                return 'upload_round'\n            case 'speakingInGroupCallAction':\n                return 'speak_call'\n            case 'sendMessageHistoryImportAction':\n                return 'history_import'\n            case 'sendMessageChooseStickerAction':\n                return 'sticker'\n            case 'sendMessageEmojiInteraction':\n                return 'interaction'\n            case 'sendMessageEmojiInteractionSeen':\n                return 'interaction_seen'\n            default:\n                assertNever(this.raw.action)\n        }\n    }\n}\n\nmakeInspectable(UserTypingUpdate)\n"]}

package/cjs/highlevel/types/utils.d.ts

@@ -0,0 +1,12 @@
+import { MaybePromise } from '../../types/utils.js';
+export type MaybeDynamic<T> = MaybePromise<T> | (() => MaybePromise<T>);
+export type ArrayWithTotal<T> = T[] & {
+    total: number;
+};
+export type ArrayPaginated<T, Offset> = T[] & {
+    total: number;
+    next?: Offset;
+};
+export type ParametersSkip1<T> = T extends (a: any, ...args: infer P) => any ? P : never;
+export type ParametersSkip2<T> = T extends (a: any, b: any, ...args: infer P) => any ? P : never;
+export type ParametersSkip3<T> = T extends (a: any, b: any, c: any, ...args: infer P) => any ? P : never;

package/cjs/highlevel/types/utils.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=utils.js.map

package/cjs/highlevel/types/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/highlevel/types/utils.ts"],"names":[],"mappings":"","sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\nimport { MaybePromise } from '../../types/utils.js'\n\nexport type MaybeDynamic<T> = MaybePromise<T> | (() => MaybePromise<T>)\n\nexport type ArrayWithTotal<T> = T[] & { total: number }\nexport type ArrayPaginated<T, Offset> = T[] & { total: number; next?: Offset }\n\nexport type ParametersSkip1<T> = T extends (a: any, ...args: infer P) => any ? P : never\nexport type ParametersSkip2<T> = T extends (a: any, b: any, ...args: infer P) => any ? P : never\nexport type ParametersSkip3<T> = T extends (a: any, b: any, c: any, ...args: infer P) => any ? P : never\n"]}

package/cjs/highlevel/updates/index.d.ts

@@ -0,0 +1,2 @@
+export * from './manager.js';
+export * from './types.js';

package/cjs/highlevel/updates/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./manager.js"), exports);
+// export * from './parsed.js' todo
+__exportStar(require("./types.js"), exports);
+//# sourceMappingURL=index.js.map

package/cjs/highlevel/updates/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/highlevel/updates/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA4B;AAC5B,mCAAmC;AACnC,6CAA0B","sourcesContent":["export * from './manager.js'\n// export * from './parsed.js' todo\nexport * from './types.js'\n"]}

package/cjs/highlevel/updates/manager.d.ts

@@ -0,0 +1,120 @@
+/// <reference types="node" resolution-mode="require"/>
+import { tl } from '@mtcute/tl';
+import { AsyncLock, ConditionVariable, Deque, EarlyTimer, SortedLinkedList } from '../../utils/index.js';
+import { BaseTelegramClient } from '../base.js';
+import { CurrentUserInfo } from '../storage/service/current-user.js';
+import { PeersIndex } from '../types/peers/peers-index.js';
+import { PendingUpdate, PendingUpdateContainer, RawUpdateHandler, UpdatesManagerParams } from './types.js';
+export declare class UpdatesManager {
+    readonly client: BaseTelegramClient;
+    readonly params: UpdatesManagerParams;
+    updatesLoopActive: boolean;
+    updatesLoopCv: ConditionVariable;
+    postponedTimer: EarlyTimer;
+    hasTimedoutPostponed: boolean;
+    pendingUpdateContainers: SortedLinkedList<PendingUpdateContainer>;
+    pendingPtsUpdates: SortedLinkedList<PendingUpdate>;
+    pendingPtsUpdatesPostponed: SortedLinkedList<PendingUpdate>;
+    pendingQtsUpdates: SortedLinkedList<PendingUpdate>;
+    pendingQtsUpdatesPostponed: SortedLinkedList<PendingUpdate>;
+    pendingUnorderedUpdates: Deque<PendingUpdate>;
+    noDispatchEnabled: boolean;
+    noDispatchMsg: Map<number, Set<number>>;
+    noDispatchPts: Map<number, Set<number>>;
+    noDispatchQts: Set<number>;
+    lock: AsyncLock;
+    pts?: number;
+    qts?: number;
+    date?: number;
+    seq?: number;
+    oldPts?: number;
+    oldQts?: number;
+    oldDate?: number;
+    oldSeq?: number;
+    selfChanged: boolean;
+    catchUpChannels: boolean;
+    catchUpOnStart: boolean;
+    cpts: Map<number, number>;
+    cptsMod: Map<number, number>;
+    channelDiffTimeouts: Map<number, NodeJS.Timeout>;
+    channelsOpened: Map<number, number>;
+    log: import("../../utils/logger.js").Logger;
+    private _handler;
+    auth?: CurrentUserInfo | null;
+    keepAliveInterval?: NodeJS.Timeout;
+    constructor(client: BaseTelegramClient, params?: UpdatesManagerParams);
+    setHandler(handler: RawUpdateHandler): void;
+    destroy(): void;
+    notifyLoggedIn(self: CurrentUserInfo): void;
+    notifyLoggedOut(): void;
+    prepare(): Promise<void>;
+    private _onKeepAlive;
+    /**
+     * Start updates loop.
+     *
+     * You must first call {@link enableUpdatesProcessing} to use this method.
+     *
+     * It is recommended to use this method in callback to {@link start},
+     * or otherwise make sure the user is logged in.
+     *
+     * > **Note**: If you are using {@link UpdatesManagerParams.catchUp} option,
+     * > catching up will be done in background, you can't await it.
+     */
+    startLoop(): Promise<void>;
+    /**
+     * **ADVANCED**
+     *
+     * Manually stop updates loop.
+     * Usually done automatically when stopping the client with {@link close}
+     */
+    stopLoop(): void;
+    /**
+     * Catch up with the server by loading missed updates.
+     *
+     * > **Note**: In case the storage was not properly
+     * > closed the last time, "catching up" might
+     * > result in duplicate updates.
+     */
+    catchUp(): void;
+    handleClientUpdate(update: tl.TypeUpdates, noDispatch?: boolean): void;
+    handleUpdate(update: tl.TypeUpdates): void;
+    /**
+     * **ADVANCED**
+     *
+     * Notify the updates manager that some channel was "opened".
+     * Channel difference for "opened" channels will be fetched on a regular basis.
+     * This is a low-level method, prefer using {@link openChat} instead.
+     *
+     * Channel must be resolve-able with `resolvePeer` method (i.e. be in cache);
+     * base chat PTS must either be passed (e.g. from {@link Dialog}), or cached in storage.
+     *
+     * @param channelId  Bare ID of the channel
+     * @param pts  PTS of the channel, if known (e.g. from {@link Dialog})
+     * @returns `true` if the channel was opened for the first time, `false` if it is already opened
+     */
+    notifyChannelOpened(channelId: number, pts?: number): boolean;
+    /**
+     * **ADVANCED**
+     *
+     * Notify the updates manager that some channel was "closed".
+     * Basically the opposite of {@link notifyChannelOpened}.
+     * This is a low-level method, prefer using {@link closeChat} instead.
+     *
+     * @param channelId  Bare channel ID
+     * @returns `true` if the chat was closed for the last time, `false` otherwise
+     */
+    notifyChannelClosed(channelId: number): boolean;
+    _fetchUpdatesState(): Promise<void>;
+    _loadUpdatesStorage(): Promise<void>;
+    _saveUpdatesStorage(save?: boolean): Promise<void>;
+    _addToNoDispatchIndex(updates?: tl.TypeUpdates): void;
+    _fetchMissingPeers(upd: tl.TypeUpdate, peers: PeersIndex, allowMissing?: boolean): Promise<Set<number>>;
+    _storeMessageReferences(msg: tl.TypeMessage): Promise<void>;
+    _fetchChannelDifference(channelId: number, fallbackPts?: number): Promise<boolean>;
+    _fetchChannelDifferenceLater(requestedDiff: Map<number, Promise<void>>, channelId: number, fallbackPts?: number): void;
+    _fetchChannelDifferenceViaUpdate(channelId: number, pts?: number): void;
+    _fetchDifference(requestedDiff: Map<number, Promise<void>>): Promise<void>;
+    _fetchDifferenceLater(requestedDiff: Map<number, Promise<void>>): void;
+    _onUpdate(pending: PendingUpdate, requestedDiff: Map<number, Promise<void>>, postponed?: boolean, unordered?: boolean): Promise<void>;
+    _loop(): Promise<void>;
+}