React Native TDLib

⚠️ Note: This library is currently under development, and contributions are welcome! If you'd like to help improve the library, feel free to submit issues or pull requests.

react-native-tdlib is a React Native bridge for the TDLib (Telegram Database Library) that allows developers to interact with Telegram's API seamlessly in their React Native applications.

Installation

npm install react-native-tdlib
# or
yarn add react-native-tdlib

Available Methods

The library provides the following methods for interacting with Telegram's TDLib. These are grouped into Base API and High-Level API for easier understanding.

High-Level API

These methods simplify common tasks and abstract away low-level details.

Method	Description
startTdLib	Starts the TDLib service with required parameters.
login	Initiates login with a phone number.
verifyPhoneNumber	Verifies a phone number using an OTP code.
verifyPassword	Verifies the account password for two-factor authentication.
getAuthorizationState	Fetches the current authorization state.
getProfile	Retrieves the profile information of the logged-in user.
logout	Logs out of the current session.

Base API (Not recommended)

These methods offer low-level access to TDLib's functionalities.

Method	Description
td_json_client_create	Creates a new TDLib client instance.
td_json_client_execute	Synchronously executes a TDLib request.
td_json_client_send	Sends a TDLib request asynchronously.
td_json_client_receive	Receives a TDLib response with a timeout.

Example Usage

High-Level API Example

// Start TDLib
await TdLib.startTdLib({
  api_id: 123456,
  api_hash: 'your_api_hash'
});

// Login with phone number
await TdLib.login({
  countrycode: '+1',
  phoneNumber: '1234567890'
});

// Verify phone number
await TdLib.verifyPhoneNumber('12345'); // Replace with the OTP you received

// Verify password (Optional)
await TdLib.verifyPassword('password');

// Get current profile
const profile = await TdLib.getProfile();
console.log(profile);

Base API Example

const tdLibParameters = {
    '@type': 'setTdlibParameters',
    parameters: {
        database_directory: 'tdlib',
        use_message_database: true,
        use_secret_chats: true,
        api_id: 123456, // Replace with your API ID
        api_hash: 'your_api_hash', // Replace with your API Hash
        system_language_code: 'en',
        device_model: 'React Native',
        system_version: '1.0',
        application_version: '1.0',
        enable_storage_optimizer: true,
    },
};

// Send TDLib parameters
TdLib.td_json_client_send(tdLibParameters);

Features

Direct communication with TDLib for Telegram API interactions.
Cross-platform support for iOS and Android.
Easy-to-use methods for common TDLib operations, such as setting parameters, sending requests, and receiving updates.

📝 TODO

[ ] Move Prebuilt Library out of Repository
[ ] Complete Android Method Implementations
[ ] Improve Documentation
[ ] Make a list of methods to implement

Example Project

This repository includes an example directory with a fully functional React Native project that demonstrates how to use the library. You can explore the example project to see how the library is integrated and used.

Running the Example

Clone the repository:

git clone https://github.com/vladlenskiy/react-native-tdlib.git
cd react-native-tdlib/example

Install dependencies:

npm install
# or
yarn install

Run the app:

npx react-native run-android   # For Android
npx react-native run-ios       # For iOS