@mtcute/core 0.28.2 → 0.29.1

package/client.cjs

@@ -60,7 +60,6 @@ const getCreatorAfterLeave = require("./highlevel/methods/chats/get-creator-afte
 const getFullChat = require("./highlevel/methods/chats/get-full-chat.cjs");
 const getFullUser = require("./highlevel/methods/chats/get-full-user.cjs");
 const getMessageAuthor = require("./highlevel/methods/chats/get-message-author.cjs");
-const getNearbyChats = require("./highlevel/methods/chats/get-nearby-chats.cjs");
 const getPeer = require("./highlevel/methods/chats/get-peer.cjs");
 const getPeers = require("./highlevel/methods/chats/get-peers.cjs");
 const getSimilarChannels = require("./highlevel/methods/chats/get-similar-channels.cjs");
@@ -620,9 +619,6 @@ TelegramClient.prototype.getFullUser = function(...args) {
 TelegramClient.prototype.getMessageAuthor = function(...args) {
   return getMessageAuthor.getMessageAuthor(this._client, ...args);
 };
-TelegramClient.prototype.getNearbyChats = function(...args) {
-  return getNearbyChats.getNearbyChats(this._client, ...args);
-};
 TelegramClient.prototype.getPeer = function(...args) {
   return getPeer.getPeer(this._client, ...args);
 };

package/client.js

@@ -53,7 +53,6 @@ import { getCreatorAfterLeave } from "./highlevel/methods/chats/get-creator-afte
 import { getFullChat } from "./highlevel/methods/chats/get-full-chat.js";
 import { getFullUser } from "./highlevel/methods/chats/get-full-user.js";
 import { getMessageAuthor } from "./highlevel/methods/chats/get-message-author.js";
-import { getNearbyChats } from "./highlevel/methods/chats/get-nearby-chats.js";
 import { getPeer } from "./highlevel/methods/chats/get-peer.js";
 import { getPeers } from "./highlevel/methods/chats/get-peers.js";
 import { getSimilarChannels } from "./highlevel/methods/chats/get-similar-channels.js";
@@ -613,9 +612,6 @@ TelegramClient.prototype.getFullUser = function(...args) {
 TelegramClient.prototype.getMessageAuthor = function(...args) {
   return getMessageAuthor(this._client, ...args);
 };
-TelegramClient.prototype.getNearbyChats = function(...args) {
-  return getNearbyChats(this._client, ...args);
-};
 TelegramClient.prototype.getPeer = function(...args) {
   return getPeer(this._client, ...args);
 };

package/highlevel/base.cjs

@@ -6,23 +6,21 @@ if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WAR
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const utils = require("@fuman/utils");
-const tl = require("@mtcute/tl");
 const client = require("../network/client.cjs");
-const errorReporting = require("../utils/error-reporting.cjs");
 const functionUtils = require("../utils/function-utils.cjs");
 const logger = require("../utils/logger.cjs");
+const miscUtils = require("../utils/misc-utils.cjs");
 const typeAssertions = require("../utils/type-assertions.cjs");
 require("@mtcute/tl-runtime");
-require("@mtcute/tl/binary/reader.js");
-require("@mtcute/tl/binary/writer.js");
 const appConfigManager = require("./managers/app-config-manager.cjs");
 const timers = require("./managers/timers.cjs");
 const storage = require("./storage/storage.cjs");
 const manager = require("./updates/manager.cjs");
 const stringSession = require("./utils/string-session.cjs");
 const password = require("../utils/crypto/password.cjs");
+const innerTl = require("../tl/inner-tl.cjs");
 function makeRpcError(raw, stack, method) {
-  const error = tl.tl.RpcError.fromTl(raw);
+  const error = innerTl.RpcError.fromTl(raw);
   error.stack = `RpcError (${error.code} ${error.text}): ${error.message}
     at ${method}
 ${stack.split("\n").slice(2).join("\n")}`;
@@ -34,7 +32,7 @@ class BaseTelegramClient {
     this.log = this.params.logger ?? new logger.LogManager("client", params.platform);
     this.platform = this.params.platform;
     this.mt = new client.MtClient({
-      ...this.params,
+      ...miscUtils.dropUndefined(this.params),
       logger: this.log.create("mtproto"),
       onError: (err) => {
         if (this.onError.length > 0) {
@@ -62,9 +60,14 @@ class BaseTelegramClient {
     this.crypto = this.mt.crypto;
     this.storage = new storage.TelegramStorageManager(this.mt.storage, {
       provider: this.params.storage,
-      ...this.params.storageOptions
+      ...miscUtils.dropUndefined(this.params.storageOptions)
+    });
+    this.timers = new timers.TimersManager(async (spec, abortSignal) => {
+      await this.call(spec.request, {
+        abortSignal,
+        ...spec.options
+      });
     });
-    this.timers = new timers.TimersManager();
     this.timers.onError((err) => this.onError.emit(utils.unknownToError(err)));
   }
   updates;
@@ -186,9 +189,6 @@ class BaseTelegramClient {
     const res = await this.mt.call(message, params);
     if (typeAssertions.isTlRpcError(res)) {
       const error = makeRpcError(res, new Error().stack ?? "", message._);
-      if (error.unknown && this.params.enableErrorReporting) {
-        errorReporting.reportUnknownError(this.log, error, message._);
-      }
       throw error;
     }
     await this.storage.peers.updatePeersFrom(res);

package/highlevel/base.d.cts

@@ -10,7 +10,7 @@ import { ITelegramStorageProvider } from './storage/provider.js';
 import { TelegramStorageManagerExtraOptions, TelegramStorageManager } from './storage/storage.js';
 import { RawUpdateInfo, UpdatesManagerParams } from './updates/types.js';
 import { Emitter } from '@fuman/utils';
-import { tl } from '@mtcute/tl';
+import { tl } from '../tl/index.js';
 import { AppConfigManager } from './managers/app-config-manager.js';
 import { TimersManager } from './managers/timers.js';
 import { UpdatesManager } from './updates/manager.js';

package/highlevel/base.d.ts

@@ -10,7 +10,7 @@ import { ITelegramStorageProvider } from './storage/provider.js';
 import { TelegramStorageManagerExtraOptions, TelegramStorageManager } from './storage/storage.js';
 import { RawUpdateInfo, UpdatesManagerParams } from './updates/types.js';
 import { Emitter } from '@fuman/utils';
-import { tl } from '@mtcute/tl';
+import { tl } from '../tl/index.js';
 import { AppConfigManager } from './managers/app-config-manager.js';
 import { TimersManager } from './managers/timers.js';
 import { UpdatesManager } from './updates/manager.js';

package/highlevel/base.js

@@ -1,21 +1,19 @@
 import { unknownToError, Emitter } from "@fuman/utils";
-import { tl } from "@mtcute/tl";
 import { MtClient } from "../network/client.js";
-import { reportUnknownError } from "../utils/error-reporting.js";
 import { asyncResettable } from "../utils/function-utils.js";
 import { LogManager } from "../utils/logger.js";
+import { dropUndefined } from "../utils/misc-utils.js";
 import { isTlRpcError } from "../utils/type-assertions.js";
 import "@mtcute/tl-runtime";
-import "@mtcute/tl/binary/reader.js";
-import "@mtcute/tl/binary/writer.js";
 import { AppConfigManager } from "./managers/app-config-manager.js";
 import { TimersManager } from "./managers/timers.js";
 import { TelegramStorageManager } from "./storage/storage.js";
 import { UpdatesManager } from "./updates/manager.js";
 import { readStringSession, writeStringSession } from "./utils/string-session.js";
 import { computeSrpParams, computeNewPasswordHash } from "../utils/crypto/password.js";
+import { RpcError } from "../tl/inner-tl.js";
 function makeRpcError(raw, stack, method) {
-  const error = tl.RpcError.fromTl(raw);
+  const error = RpcError.fromTl(raw);
   error.stack = `RpcError (${error.code} ${error.text}): ${error.message}
     at ${method}
 ${stack.split("\n").slice(2).join("\n")}`;
@@ -27,7 +25,7 @@ class BaseTelegramClient {
     this.log = this.params.logger ?? new LogManager("client", params.platform);
     this.platform = this.params.platform;
     this.mt = new MtClient({
-      ...this.params,
+      ...dropUndefined(this.params),
       logger: this.log.create("mtproto"),
       onError: (err) => {
         if (this.onError.length > 0) {
@@ -55,9 +53,14 @@ class BaseTelegramClient {
     this.crypto = this.mt.crypto;
     this.storage = new TelegramStorageManager(this.mt.storage, {
       provider: this.params.storage,
-      ...this.params.storageOptions
+      ...dropUndefined(this.params.storageOptions)
+    });
+    this.timers = new TimersManager(async (spec, abortSignal) => {
+      await this.call(spec.request, {
+        abortSignal,
+        ...spec.options
+      });
     });
-    this.timers = new TimersManager();
     this.timers.onError((err) => this.onError.emit(unknownToError(err)));
   }
   updates;
@@ -179,9 +182,6 @@ class BaseTelegramClient {
     const res = await this.mt.call(message, params);
     if (isTlRpcError(res)) {
       const error = makeRpcError(res, new Error().stack ?? "", message._);
-      if (error.unknown && this.params.enableErrorReporting) {
-        reportUnknownError(this.log, error, message._);
-      }
       throw error;
     }
     await this.storage.peers.updatePeersFrom(res);

package/highlevel/client.d.cts

@@ -1,6 +1,6 @@
-import { tl } from '@mtcute/tl';
 import { default as Long } from 'long';
 import { RpcCallOptions } from '../network/index.js';
+import { tl } from '../tl/index.js';
 import { MaybeArray, MaybePromise, PartialExcept, PartialOnly } from '../types/index.js';
 import { BaseTelegramClientOptions } from './base.js';
 import { ITelegramClient } from './client.types.js';
@@ -1304,15 +1304,6 @@ export interface TelegramClient extends ITelegramClient {
      */
     getFullUser(userId: InputPeerLike): Promise<FullUser>;
     getMessageAuthor(message: InputMessageId): Promise<User>;
-    /**
-     * Get nearby chats
-     *
-     * **Available**: 👤 users only
-     *
-     * @param latitude  Latitude of the location
-     * @param longitude  Longitude of the location
-     */
-    getNearbyChats(latitude: number, longitude: number): Promise<Chat[]>;
     /** Shorthand for {@link getChat} and {@link getUser} depending on the type of the peer */
     getPeer(peer: InputPeerLike): Promise<Peer>;
     /**
@@ -3165,7 +3156,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Edit message text, media, reply markup and schedule date.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param chatId  ID of the chat, its username, phone or `"me"` or `"self"`
      * @param message  Message or its ID
@@ -3918,7 +3909,7 @@ export interface TelegramClient extends ITelegramClient {
      * To add a caption to the group, add caption to the first
      * media in the group and don't add caption for any other.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param chatId  ID of the chat, its username, phone or `"me"` or `"self"`
      * @param medias  Medias contained in the message.
@@ -3947,7 +3938,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Send a single media (a photo or a document-based media)
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param chatId  ID of the chat, its username, phone or `"me"` or `"self"`
      * @param media
@@ -4074,7 +4065,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Send a text message
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param chatId  ID of the chat, its username, phone or `"me"` or `"self"`
      * @param text  Text of the message
@@ -4108,7 +4099,7 @@ export interface TelegramClient extends ITelegramClient {
      *
      * If you need a continuous typing status, use {@link setTyping} instead.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param chatId  Chat ID
      * @param [status='typing']  Typing status
@@ -4647,13 +4638,13 @@ export interface TelegramClient extends ITelegramClient {
      */
     deleteStickerFromSet(sticker: InputDocumentId): Promise<StickerSet>;
     /**
-     * Get custom emoji stickers by their IDs
+     * Get custom emoji stickers by their IDs, or `null` if not available/found.
      *
      * **Available**: 👤 users only
      *
      * @param ids  IDs of the stickers (as defined in {@link MessageEntity.emojiId})
      */
-    getCustomEmojis(ids: tl.Long[]): Promise<Sticker[]>;
+    getCustomEmojis(ids: tl.Long[]): Promise<(Sticker | null)[]>;
     /**
      * Given one or more messages, extract all unique custom emojis from it and fetch them
      * **Available**: ✅ both users and bots
@@ -5205,7 +5196,7 @@ export interface TelegramClient extends ITelegramClient {
      * @param photoId  ID of the photo to fetch
      * @param params
      */
-    getProfilePhoto(userId: InputPeerLike, photoId: tl.Long): Promise<Photo>;
+    getProfilePhoto(userId: InputPeerLike, photoId: tl.Long): Promise<Photo | null>;
     /**
      * Get a list of profile pictures of a user
      *

package/highlevel/client.d.ts

@@ -1,6 +1,6 @@
-import { tl } from '@mtcute/tl';
 import { default as Long } from 'long';
 import { RpcCallOptions } from '../network/index.js';
+import { tl } from '../tl/index.js';
 import { MaybeArray, MaybePromise, PartialExcept, PartialOnly } from '../types/index.js';
 import { BaseTelegramClientOptions } from './base.js';
 import { ITelegramClient } from './client.types.js';
@@ -1304,15 +1304,6 @@ export interface TelegramClient extends ITelegramClient {
      */
     getFullUser(userId: InputPeerLike): Promise<FullUser>;
     getMessageAuthor(message: InputMessageId): Promise<User>;
-    /**
-     * Get nearby chats
-     *
-     * **Available**: 👤 users only
-     *
-     * @param latitude  Latitude of the location
-     * @param longitude  Longitude of the location
-     */
-    getNearbyChats(latitude: number, longitude: number): Promise<Chat[]>;
     /** Shorthand for {@link getChat} and {@link getUser} depending on the type of the peer */
     getPeer(peer: InputPeerLike): Promise<Peer>;
     /**
@@ -3165,7 +3156,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Edit message text, media, reply markup and schedule date.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param chatId  ID of the chat, its username, phone or `"me"` or `"self"`
      * @param message  Message or its ID
@@ -3918,7 +3909,7 @@ export interface TelegramClient extends ITelegramClient {
      * To add a caption to the group, add caption to the first
      * media in the group and don't add caption for any other.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param chatId  ID of the chat, its username, phone or `"me"` or `"self"`
      * @param medias  Medias contained in the message.
@@ -3947,7 +3938,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Send a single media (a photo or a document-based media)
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param chatId  ID of the chat, its username, phone or `"me"` or `"self"`
      * @param media
@@ -4074,7 +4065,7 @@ export interface TelegramClient extends ITelegramClient {
     /**
      * Send a text message
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param chatId  ID of the chat, its username, phone or `"me"` or `"self"`
      * @param text  Text of the message
@@ -4108,7 +4099,7 @@ export interface TelegramClient extends ITelegramClient {
      *
      * If you need a continuous typing status, use {@link setTyping} instead.
      *
-     * **Available**: ✅ both users and bots
+     * **Available**: 👤 users only
      *
      * @param chatId  Chat ID
      * @param [status='typing']  Typing status
@@ -4647,13 +4638,13 @@ export interface TelegramClient extends ITelegramClient {
      */
     deleteStickerFromSet(sticker: InputDocumentId): Promise<StickerSet>;
     /**
-     * Get custom emoji stickers by their IDs
+     * Get custom emoji stickers by their IDs, or `null` if not available/found.
      *
      * **Available**: 👤 users only
      *
      * @param ids  IDs of the stickers (as defined in {@link MessageEntity.emojiId})
      */
-    getCustomEmojis(ids: tl.Long[]): Promise<Sticker[]>;
+    getCustomEmojis(ids: tl.Long[]): Promise<(Sticker | null)[]>;
     /**
      * Given one or more messages, extract all unique custom emojis from it and fetch them
      * **Available**: ✅ both users and bots
@@ -5205,7 +5196,7 @@ export interface TelegramClient extends ITelegramClient {
      * @param photoId  ID of the photo to fetch
      * @param params
      */
-    getProfilePhoto(userId: InputPeerLike, photoId: tl.Long): Promise<Photo>;
+    getProfilePhoto(userId: InputPeerLike, photoId: tl.Long): Promise<Photo | null>;
     /**
      * Get a list of profile pictures of a user
      *

package/highlevel/client.types.d.cts

@@ -1,7 +1,7 @@
 import { Emitter } from '@fuman/utils';
-import { tl } from '@mtcute/tl';
 import { default as Long } from 'long';
 import { ConnectionKind, RpcCallOptions } from '../network/index.js';
+import { tl } from '../tl/index.js';
 import { ICorePlatform } from '../types/platform.js';
 import { MustEqual, PublicPart } from '../types/utils.js';
 import { Logger } from '../utils/logger.js';
@@ -31,7 +31,7 @@ export interface ITelegramClient {
     /** App config manager */
     readonly appConfig: PublicPart<AppConfigManager>;
     /** Timers manager */
-    readonly timers: Pick<TimersManager, 'create' | 'cancel' | 'exists'>;
+    readonly timers: Pick<TimersManager, 'upsert' | 'cancel' | 'exists'>;
     /** Signal that will be aborted when the client is destroyed */
     readonly stopSignal: AbortSignal;
     /** Platform used by the client */
@@ -62,6 +62,9 @@ export interface ITelegramClient {
      *
      * This will terminate any connections to the Telegram servers,
      * free all the resources, and make the client no longer usable
+     *
+     * > **Note**: the above is not true for worker ports, which instead only closes the port connection itself.
+     * > To destroy the underlying client, use `unsafeForceDestroy()`.
      */
     destroy(): Promise<void>;
     /** Notify the client that the user has logged in */

package/highlevel/client.types.d.ts

@@ -1,7 +1,7 @@
 import { Emitter } from '@fuman/utils';
-import { tl } from '@mtcute/tl';
 import { default as Long } from 'long';
 import { ConnectionKind, RpcCallOptions } from '../network/index.js';
+import { tl } from '../tl/index.js';
 import { ICorePlatform } from '../types/platform.js';
 import { MustEqual, PublicPart } from '../types/utils.js';
 import { Logger } from '../utils/logger.js';
@@ -31,7 +31,7 @@ export interface ITelegramClient {
     /** App config manager */
     readonly appConfig: PublicPart<AppConfigManager>;
     /** Timers manager */
-    readonly timers: Pick<TimersManager, 'create' | 'cancel' | 'exists'>;
+    readonly timers: Pick<TimersManager, 'upsert' | 'cancel' | 'exists'>;
     /** Signal that will be aborted when the client is destroyed */
     readonly stopSignal: AbortSignal;
     /** Platform used by the client */
@@ -62,6 +62,9 @@ export interface ITelegramClient {
      *
      * This will terminate any connections to the Telegram servers,
      * free all the resources, and make the client no longer usable
+     *
+     * > **Note**: the above is not true for worker ports, which instead only closes the port connection itself.
+     * > To destroy the underlying client, use `unsafeForceDestroy()`.
      */
     destroy(): Promise<void>;
     /** Notify the client that the user has logged in */

package/highlevel/managers/timers.cjs

@@ -7,37 +7,57 @@ if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WAR
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const utils = require("@fuman/utils");
 class TimersManager {
+  constructor(_executeRpc) {
+    this._executeRpc = _executeRpc;
+  }
   _timers = /* @__PURE__ */ new Map();
   _errorHandler;
-  constructor() {
-  }
-  exists(key) {
+  // These methods are async for API parity with worker-backed clients,
+  // where keepalive state is owned by the shared client/worker and accessed over RPC.
+  async exists(key) {
     return this._timers.has(key);
   }
-  create(key, handler, interval, startNow = false) {
-    if (this._timers.has(key)) {
-      return;
+  async upsert(spec) {
+    this.upsertOwned("local", spec);
+  }
+  async cancel(key) {
+    this._cancel(key);
+  }
+  upsertOwned(ownerId, spec) {
+    this._cancel(spec.key);
+    const timer = new utils.AsyncInterval(
+      (abortSignal) => this._executeRpc(spec, abortSignal),
+      spec.interval
+    );
+    if (this._errorHandler) {
+      timer.onError(this._errorHandler);
     }
-    const timer = new utils.AsyncInterval(handler, interval);
-    if (this._errorHandler) timer.onError(this._errorHandler);
-    this._timers.set(key, timer);
-    if (startNow) timer.startNow();
+    this._timers.set(spec.key, {
+      ownerId,
+      timer
+    });
+    if (spec.startNow) timer.startNow();
     else timer.start();
   }
-  cancel(key) {
-    const timer = this._timers.get(key);
-    if (!timer) return;
-    timer.stop();
-    this._timers.delete(key);
+  clearOwner(ownerId) {
+    for (const [key, timer] of Array.from(this._timers.entries())) {
+      if (timer.ownerId !== ownerId) continue;
+      this._cancel(key);
+    }
   }
   onError(handler) {
     this._errorHandler = handler;
   }
   destroy() {
-    for (const timer of this._timers.values()) {
-      timer.stop();
+    for (const key of Array.from(this._timers.keys())) {
+      this._cancel(key);
     }
-    this._timers.clear();
+  }
+  _cancel(key) {
+    const timer = this._timers.get(key);
+    if (!timer) return;
+    timer.timer.stop();
+    this._timers.delete(key);
   }
 }
 exports.TimersManager = TimersManager;

package/highlevel/managers/timers.d.cts

@@ -1,10 +1,24 @@
+import { RpcCallOptions } from '../../network/network-manager.js';
+import { tl } from '../../tl/index.js';
+export interface RpcTimerSpec {
+    kind: 'rpc';
+    key: string;
+    interval: number;
+    request: tl.RpcMethod;
+    options?: Omit<RpcCallOptions, 'abortSignal' | 'manager'>;
+    startNow?: boolean;
+}
 export declare class TimersManager {
+    private readonly _executeRpc;
     private _timers;
     private _errorHandler?;
-    constructor();
-    exists(key: string): boolean;
-    create(key: string, handler: (abortSignal: AbortSignal) => Promise<void>, interval: number, startNow?: boolean): void;
-    cancel(key: string): void;
+    constructor(_executeRpc: (spec: RpcTimerSpec, abortSignal: AbortSignal) => Promise<void>);
+    exists(key: string): Promise<boolean>;
+    upsert(spec: RpcTimerSpec): Promise<void>;
+    cancel(key: string): Promise<void>;
+    upsertOwned(ownerId: string, spec: RpcTimerSpec): void;
+    clearOwner(ownerId: string): void;
     onError(handler: (err: unknown) => void): void;
     destroy(): void;
+    private _cancel;
 }

package/highlevel/managers/timers.d.ts

@@ -1,10 +1,24 @@
+import { RpcCallOptions } from '../../network/network-manager.js';
+import { tl } from '../../tl/index.js';
+export interface RpcTimerSpec {
+    kind: 'rpc';
+    key: string;
+    interval: number;
+    request: tl.RpcMethod;
+    options?: Omit<RpcCallOptions, 'abortSignal' | 'manager'>;
+    startNow?: boolean;
+}
 export declare class TimersManager {
+    private readonly _executeRpc;
     private _timers;
     private _errorHandler?;
-    constructor();
-    exists(key: string): boolean;
-    create(key: string, handler: (abortSignal: AbortSignal) => Promise<void>, interval: number, startNow?: boolean): void;
-    cancel(key: string): void;
+    constructor(_executeRpc: (spec: RpcTimerSpec, abortSignal: AbortSignal) => Promise<void>);
+    exists(key: string): Promise<boolean>;
+    upsert(spec: RpcTimerSpec): Promise<void>;
+    cancel(key: string): Promise<void>;
+    upsertOwned(ownerId: string, spec: RpcTimerSpec): void;
+    clearOwner(ownerId: string): void;
     onError(handler: (err: unknown) => void): void;
     destroy(): void;
+    private _cancel;
 }

package/highlevel/managers/timers.js

@@ -1,36 +1,56 @@
 import { AsyncInterval } from "@fuman/utils";
 class TimersManager {
+  constructor(_executeRpc) {
+    this._executeRpc = _executeRpc;
+  }
   _timers = /* @__PURE__ */ new Map();
   _errorHandler;
-  constructor() {
-  }
-  exists(key) {
+  // These methods are async for API parity with worker-backed clients,
+  // where keepalive state is owned by the shared client/worker and accessed over RPC.
+  async exists(key) {
     return this._timers.has(key);
   }
-  create(key, handler, interval, startNow = false) {
-    if (this._timers.has(key)) {
-      return;
+  async upsert(spec) {
+    this.upsertOwned("local", spec);
+  }
+  async cancel(key) {
+    this._cancel(key);
+  }
+  upsertOwned(ownerId, spec) {
+    this._cancel(spec.key);
+    const timer = new AsyncInterval(
+      (abortSignal) => this._executeRpc(spec, abortSignal),
+      spec.interval
+    );
+    if (this._errorHandler) {
+      timer.onError(this._errorHandler);
     }
-    const timer = new AsyncInterval(handler, interval);
-    if (this._errorHandler) timer.onError(this._errorHandler);
-    this._timers.set(key, timer);
-    if (startNow) timer.startNow();
+    this._timers.set(spec.key, {
+      ownerId,
+      timer
+    });
+    if (spec.startNow) timer.startNow();
     else timer.start();
   }
-  cancel(key) {
-    const timer = this._timers.get(key);
-    if (!timer) return;
-    timer.stop();
-    this._timers.delete(key);
+  clearOwner(ownerId) {
+    for (const [key, timer] of Array.from(this._timers.entries())) {
+      if (timer.ownerId !== ownerId) continue;
+      this._cancel(key);
+    }
   }
   onError(handler) {
     this._errorHandler = handler;
   }
   destroy() {
-    for (const timer of this._timers.values()) {
-      timer.stop();
+    for (const key of Array.from(this._timers.keys())) {
+      this._cancel(key);
     }
-    this._timers.clear();
+  }
+  _cancel(key) {
+    const timer = this._timers.get(key);
+    if (!timer) return;
+    timer.timer.stop();
+    this._timers.delete(key);
   }
 }
 export {

package/highlevel/managers/timers.test.d.cts

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

package/highlevel/managers/timers.test.d.ts

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

package/highlevel/methods/auth/check-password.d.cts

@@ -1,4 +1,4 @@
-import { tl } from '@mtcute/tl';
+import { tl } from '../../../tl/index.js';
 import { ITelegramClient } from '../../client.types.js';
 import { User } from '../../types/index.js';
 /**

package/highlevel/methods/auth/check-password.d.ts

@@ -1,4 +1,4 @@
-import { tl } from '@mtcute/tl';
+import { tl } from '../../../tl/index.js';
 import { ITelegramClient } from '../../client.types.js';
 import { User } from '../../types/index.js';
 /**