tdlib-native

Quality Package Template

Why use this package?

• Fast. TDLib is a fastest way to interact with Telegram on NodeJS. It's written in C++ with optimized network stack and caching.

  API Type	Package	Method	Time
  TDLib	tdl	getChat	21ms
  Telegram API	telegram (gram.js)	messages.getChats	40ms
  Telegram Bot API	telegraf	getChat	30ms

• TS friendly. Unlike tdl this package declarations use dictionary for methods instead of intersection type, making editor hints load almost immediate.

• Secure. The library has only 1 dependency - node-addon-api for building TDLib addon

📦 Installation

• Using npm

  npm i tdlib-native
  

• Using Yarn

  yarn add tdlib-native
  

• Using pnpm

  pnpm add tdlib-native
  

⚙️ Usage

This is raw wrapper of TDLib. It does not (yet) provide any mechanisms for authentication

import { Client } from "tdlib-native";
import { TDLibAddon } from "tdlib-native/addon";

async function init() {
  // Loading addon
  const adapter = await TDLibAddon.create();
  const client = new Client(adapter);

  // Start polling responses from TDLib
  client.start();

  // Call any tdlib method
  await client.api.setLogVerbosityLevel({ new_verbosity_level: 0 });


  // Pause receiving updates. Will freeze method all running API calls
  client.pause();
  // Resume pause
  client.start();


  // Destroy
  client.destroy();
}