react-telegram/packages/mtcute-adapter

@react-telegram/mtcute-adapter

MTCute adapter for React Telegram bots. This package provides the integration between React Telegram's core reconciler and the MTCute Telegram client library.

Installation

bun add @react-telegram/mtcute-adapter @react-telegram/core react

Usage

import React from 'react';
import { MtcuteAdapter } from '@react-telegram/mtcute-adapter';

const Bot = () => (
  <>
    <b>Hello from React Telegram!</b>
    <br />
    <br />
    <row>
      <button onClick={() => console.log('clicked!')}>Click me</button>
    </row>
  </>
);

async function main() {
  const adapter = new MtcuteAdapter({
    apiId: parseInt(process.env.API_ID!),
    apiHash: process.env.API_HASH!,
    botToken: process.env.BOT_TOKEN!
  });

  adapter.onCommand('start', () => <Bot />);
  
  await adapter.start(process.env.BOT_TOKEN!);
  console.log('Bot is running!');
}

main().catch(console.error);

Features

• Full React component support for Telegram messages
• Automatic message updates when state changes
• Button click handling
• Text input support with auto-delete option
• Command handling
• TypeScript support

API

MtcuteAdapter

const adapter = new MtcuteAdapter({
  apiId: number,
  apiHash: string,
  botToken: string,
  storage?: string // Default: '.mtcute'
});

Methods

• onCommand(command: string, handler: (ctx) => ReactElement) - Register a command handler
• start(botToken: string) - Start the bot
• sendReactMessage(chatId: number | string, app: ReactElement) - Send a React-powered message
• getClient() - Get the underlying MTCute client
• getDispatcher() - Get the MTCute dispatcher

License

MIT