telelog-js

Envie logs e alertas para o Telegram em 60 segundos (Node/TypeScript).

Instalação

npm i telelog-js

Uso mínimo

import { sendTelegram } from "telelog-js";
await sendTelegram("deploy ok ✅");

Winston

import winston from "winston";
import { telegramWinstonTransport } from "telelog-js/winston";

const logger = winston.createLogger({
  transports: [telegramWinstonTransport()],
});
logger.warn("atenção");

Pino

import pino from "pino";
import { createPinoTransport } from "telelog-js/pino";

const logger = pino({}, createPinoTransport());
logger.info("olá");

Variáveis de ambiente

• TELEGRAM_BOT_TOKEN
• TELEGRAM_CHAT_ID ou TELEGRAM_CHAT_IDS (separados por vírgula)
• TELEGRAM_PARSE_MODE (opcional: MarkdownV2 ou HTML; padrão: texto puro)

CLI

telelog "mensagem"

Códigos de saída:

• 0: sucesso
• 1: falha de envio
• 2: uso incorreto ou configuração ausente

Comportamento

• Truncamento em 4096 caracteres com sufixo ....
• Retries (3), timeout (5s), backoff exponencial base 500ms com jitter ±20%.
• 429: respeita retry_after do Telegram.
• MarkdownV2/HTML: escape automático quando TELEGRAM_PARSE_MODE definido.

Segurança

Nunca commitar .env. Use .env.example como referência e secrets no CI/CD.

Requisitos

• Node >= 18.
• ESM: use arquivos .mjs ou defina "type": "module" no package.json.
  • Em projetos CommonJS, utilize import dinâmico: import('telelog-js').then(m => m.sendTelegram(...)).

Variáveis de ambiente e .env

• O pacote lê um arquivo .env do diretório atual (CWD), se existir.
• Variáveis já definidas no ambiente têm precedência e não são sobrescritas pelo .env.
• Necessárias:
  • TELEGRAM_BOT_TOKEN
  • TELEGRAM_CHAT_ID ou TELEGRAM_CHAT_IDS (múltiplos separados por vírgula)

Autor & Contato

• GitHub: https://github.com/ZarabaDev
• E-mail: [email protected]
• Site: https://zarabatech.com.br