@addme/telegram-logger

A simple Telegram logger for Node.js and TypeScript projects.
Send structured notifications (error, info, success) directly to your Telegram chat.

Features

• Send error, info, and success messages to Telegram.
• Includes type, date/time, environment, and message.
• Built for TypeScript and Node.js.
• Easy to integrate.

Environment Variables

Create a .env file in your project root:

TELEGRAM_BOT_TOKEN=your-telegram-bot-token
TELEGRAM_CHAT_ID=your-chat-id
NODE_ENV=production

• TELEGRAM_BOT_TOKEN – your Telegram bot token
• TELEGRAM_CHAT_ID – the ID of the chat where messages will be sent
• NODE_ENV – optional, defaults to development

Usage (TypeScript)

import { TelegramLogger } from "@addme/telegram-logger";

// Create a logger instance
const logger = new TelegramLogger();

// Send messages
logger.error("Database connection failed!");
logger.info("Background job started");
logger.success("User registration completed!");

API

new TelegramLogger(options?)

Creates a new Telegram logger instance.

interface TelegramLoggerOptions {
  botToken?: string;
  chatId?: string;
  environment?: string;
}

• botToken – optional, defaults to process.env.TELEGRAM_BOT_TOKEN
• chatId – optional, defaults to process.env.TELEGRAM_CHAT_ID
• environment – optional, defaults to process.env.NODE_ENV

Methods

• logger.error(message: string) – send an error message
• logger.info(message: string) – send an info message
• logger.success(message: string) – send a success message

Example Telegram Output

❌ Notification
Type: ERROR
Date: 10/02/2025, 14:30:00
Environment: production
Message: Database connection failed!

License

MIT © addme