Class BaseTelegramClient

constructor

• new BaseTelegramClient(params): BaseTelegramClient

• Parameters

  • params: BaseTelegramClientOptions

  Returns BaseTelegramClient

ReadonlyappConfig

Readonlycrypto

Readonlylog

Readonlymt

Readonlyparams

Readonlystorage

Optional Readonlyupdates

isConnected

• get isConnected(): boolean

• Returns boolean

stopSignal

• get stopSignal(): AbortSignal

• Returns AbortSignal

call

• call<T>(message, params?): Promise<RpcCallReturn[T["_"]]>

• Make an RPC call

  This method is still quite low-level and you shouldn't use this when using high-level API provided by @mtcute/client.

  Type Parameters

  • T extends RpcMethod

  Parameters

  • message: MustEqual<T, RpcMethod>

    RPC method to call
  • Optionalparams: RpcCallOptions

    Additional call parameters

  Returns Promise<RpcCallReturn[T["_"]]>

changePrimaryDc

• changePrimaryDc(dcId): Promise<void>

• Parameters

  • dcId: number

  Returns Promise<void>

close

• close(): Promise<void>

• Returns Promise<void>

computeNewPasswordHash

• computeNewPasswordHash(algo, password): Promise<Uint8Array>

• Parameters

  • algo: TypePasswordKdfAlgo
  • password: string

  Returns Promise<Uint8Array>

computeSrpParams

• computeSrpParams(request, password): Promise<RawInputCheckPasswordSRP>

• Parameters

  • request: RawPassword
  • password: string

  Returns Promise<RawInputCheckPasswordSRP>

connect

• connect(): Promise<void>

• Initialize the connection to the primary DC.

  You shouldn't usually call this method directly as it is called implicitly the first time you call call.

  Returns Promise<void>

emitError

• emitError(err): void

• Parameters

  • err: unknown

  Returns void

exportSession

• exportSession(): Promise<string>

• Export current session to a single LONG string, containing all the needed information.

  Warning! Anyone with this string will be able to authorize as you and do anything. Treat this as your password, and never give it away!

  In case you have accidentally leaked this string, make sure to revoke this session in account settings: "Privacy & Security" > "Active sessions" > find the one containing mtcute > Revoke, or, in case this is a bot, revoke bot token with @BotFather

  Returns Promise<string>

getApiCrenetials

• getApiCrenetials(): Promise<{
      hash: string;
      id: number;
  }>

• Returns Promise<{
      hash: string;
      id: number;
  }>

getMtprotoMessageId

• getMtprotoMessageId(): Promise<Long>

• Returns Promise<Long>

getPoolSize

• getPoolSize(kind, dcId?): Promise<number>

• Parameters

  • kind: ConnectionKind
  • OptionaldcId: number

  Returns Promise<number>

getPrimaryDcId

• getPrimaryDcId(): Promise<number>

• Returns Promise<number>

getServerUpdateHandler

• getServerUpdateHandler(): ServerUpdateHandler

• Returns ServerUpdateHandler

handleClientUpdate

• handleClientUpdate(updates, noDispatch?): void

• Parameters

  • updates: TypeUpdates
  • OptionalnoDispatch: boolean

  Returns void

importSession

• importSession(session, force?): Promise<void>

• Import the session from the given session string.

  Note that the session will only be imported in case the storage is missing authorization (i.e. does not contain auth key for the primary DC), otherwise it will be ignored (unless force).

  Parameters

  • session: string | StringSessionData

    Session string to import
  • force: boolean = false

    Whether to overwrite existing session

  Returns Promise<void>

notifyChannelClosed

• notifyChannelClosed(channelId): Promise<boolean>

• Parameters

  • channelId: number

  Returns Promise<boolean>

notifyChannelOpened

• notifyChannelOpened(channelId, pts?): Promise<boolean>

• Parameters

  • channelId: number
  • Optionalpts: number

  Returns Promise<boolean>

notifyLoggedIn

• notifyLoggedIn(auth): Promise<RawUser>

• Parameters

  • auth: RawUser | TypeAuthorization

  Returns Promise<RawUser>

notifyLoggedOut

• notifyLoggedOut(): Promise<void>

• Returns Promise<void>

onConnectionState

• onConnectionState(handler): void

• Parameters

  • handler: ((state: ConnectionState) => void)
    • • (state): void

      • Parameters

        • state: ConnectionState

        Returns void

  Returns void

onError

• onError(handler): void

• Register an error handler for the client

  Parameters

  • handler: ((err: unknown) => void)

    Error handler.

    • • (err): void

      • Parameters

        • err: unknown

        Returns void

  Returns void

onServerUpdate

• onServerUpdate(handler): void

• Parameters

  • handler: ServerUpdateHandler

  Returns void

onUpdate

• onUpdate(handler): void

• Parameters

  • handler: RawUpdateHandler

  Returns void

prepare

• prepare(): Promise<void>

• ADVANCED

  Do all the preparations, but don't connect just yet. Useful when you want to do some preparations before connecting, like setting up session.

  Call connect to actually connect.

  Returns Promise<void>

startUpdatesLoop

• startUpdatesLoop(): Promise<void>

• Returns Promise<void>

stopUpdatesLoop

• stopUpdatesLoop(): Promise<void>

• Returns Promise<void>