JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 2
  • Score
    100M100P100Q58845F
  • License MIT

TDLib (Telegram Database library) bindings for Node.js

Package Exports

  • tglib

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (tglib) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

tglib

TDLib (Telegram Database library) bindings for Node.js

npm

Getting started

  1. Build the binary (https://github.com/tdlib/td#building)
  2. npm i -S tglib

APIs

tglib provide some useful methods that makes your Telegram app development easier.

Authorizing an user

const client = new Client({
  apiId: 'YOUR_API_ID',
  apiHash: 'YOUR_API_HASH',
  credentials: {
    type: 'user',
    value: 'YOUR_PHONE_NUMBER',
  },
})

Authorizing a bot

const client = new Client({
  apiId: 'YOUR_API_ID',
  apiHash: 'YOUR_API_HASH',
  credentials: {
    type: 'bot',
    value: 'YOUR_BOT_TOKEN',
  },
})

Low Level APIs

client.ready -> Promise

This promise is used for initializing tglib client and connect with Telegram.

await client.ready
client.on(event, callback) -> Void

This API is provided by tglib, you can use this API to attach an event listener for iterating updates.

client.on('_update', console.log.bind(console))
client.on('_error', console.error.bind(console))
client._send(query) -> Promise -> Object

This API is provided by TDLib, you can use this API to send asynchronous message to Telegram.

await client._send({
  '@type': 'sendMessage',
  'chat_id': -123456789,
  'input_message_content': {
    '@type': 'inputMessageText',
    'text': {
      '@type': 'formattedText',
      'text': '👻',
    },
  },
})
client._execute(query) -> Promise -> Object

This API is provided by TDLib, you can use this API to execute synchronous action to Telegram.

await client._execute({
  '@type': 'getTextEntities',
  'text': '@telegram /test_command https://telegram.org telegram.me',
})
client._destroy() -> Promise -> Void

This API is provided by TDLib, you can use this API to destroy the client.

await client._destroy()
client.fetch(query) -> Promise -> Object

This API is provided by tglib, you can use this API to send asynchronous message to Telegram and receive response.

const chats = await client.fetch({
  '@type': 'getChats',
  'offset_order': '9223372036854775807',
  'offset_chat_id': 0,
  'limit': 100,
})

High Level APIs

tglib provides a collection of APIs that designed for ease of use and handiness. These APIs are located under client.tg property.

client.tg.sendTextMessage(chatId, text, options = {}) -> Promise -> Void

This API is provided by tglib, you can use this API to send message to a chat. If the options argument is specified, the function will combine your options with its default.

await client.sendTextMessage('123456789', 'Hello *World*', {
  'parse_mode': 'markdown',
  'disable_notification': true,
  'clear_draft': false,
})

Requirements

  • TDLib binary

    If you planning to build TDLib for Windows, please see here for more information.

  • Node.js 10 preferred (minimum >= 9.0.0)

    Note: If you are using Node.js 9.x, you may encounter a warning message Warning: N-API is an experimental feature and could change at any time., this can be suppressed by upgrading to version 10.

License

tglib uses the same license as TDLib. See tdlib/td for more information.