xbibz-stecu-telegram-bot-library

v1.0.0-modebegadang

Published

5 months ago

Telegram Bot Library by Xbibz Official - High Performance, Feature-Rich, No Dependencies

Downloads

0High
0Medium
0Low

xbibzv2

telegram bot api xbibz ultimate performance

🤖 Xbibz Telegram Bot Library

The Ultimate Telegram Bot Library for Node.js

High Performance • Zero Dependencies • Feature-Rich • Developer Friendly

Features • Installation • Quick Start • Documentation • Examples

🌟 Why Xbibz?

Xbibz adalah library Telegram Bot yang dirancang dari awal dengan fokus pada performance, developer experience, dan production readiness. Tidak seperti library lain, Xbibz memberikan kontrol penuh dengan API yang elegan dan mudah digunakan.

✨ Keunggulan Utama

| Feature | Xbibz | Library Lain | |---------|-------|--------------| | 🚀 Zero Dependencies | ✅ | ❌ | | ⚡ High Performance | 1000+ req/s | 100-300 req/s | | 🎨 Beautiful Logging | ✅ Colored + Emoji | ❌ Plain text | | 🔌 Plugin System | ✅ Built-in | ⚠️ Limited | | 📊 Web Dashboard | ✅ Included | ❌ | | 🛡️ Auto Recovery | ✅ Smart retry | ⚠️ Basic | | 💾 Session Management | ✅ Advanced | ⚠️ Basic |

🎯 Features

🔥 Core Features

Complete API Coverage - Semua method Telegram Bot API
Intelligent Polling Engine - Optimized dengan auto-reconnect
Rich Keyboard Builder - Inline & Reply keyboard dengan fluent API
Middleware System - Chainable middleware architecture
Session Management - Persistent session dengan auto-cleanup
Event System - Powerful event emitter untuk extensibility

🛠️ Advanced Features

Rate Limiting - Built-in protection dari spam
Request Queue - Smart queue dengan priority handling
Error Recovery - Automatic retry dengan exponential backoff
Caching System - Intelligent caching untuk performance
Validation Layer - Type-safe validation untuk semua input

📊 Monitoring & Analytics

Real-time Statistics - Live metrics untuk monitoring
Web Dashboard - Beautiful UI untuk monitoring bot
API Analytics - Detailed request/response tracking
User Analytics - Track user behavior dan engagement

🎨 Developer Experience

Colorful Logging - Beautiful console output dengan emoji
Hot Reload Support - Development mode dengan auto-reload
TypeScript Ready - Full type definitions (coming soon)
Comprehensive Examples - 20+ contoh siap pakai

📦 Installation

# Clone repository
git clone https://github.com/yourusername/xbibz-telegram-bot.git

# Masuk ke folder
cd xbibz-telegram-bot

# Install (no dependencies needed!)
npm link

# Atau copy folder src ke project Anda

🚀 Quick Start

Basic Bot (5 lines!)

const { Bot } = require('xbibz-telegram-bot');

const bot = new Bot('YOUR_BOT_TOKEN');

bot.command('start', (msg) => {
  bot.sendMessage(msg.chat.id, '👋 Hello World!');
});

bot.start();

Advanced Bot dengan Keyboard

const { Bot, InlineKeyboard } = require('xbibz-telegram-bot');

const bot = new Bot('YOUR_BOT_TOKEN', {
  logLevel: 'debug',
  pollingInterval: 1000
});

// Show beautiful banner
bot.logger.banner();

// Command dengan inline keyboard
bot.command('start', (msg) => {
  const keyboard = InlineKeyboard.builder()
    .text('🎲 Button 1', 'btn_1')
    .text('🎯 Button 2', 'btn_2')
    .row()
    .url('📖 Documentation', 'https://github.com/yourrepo')
    .build();
  
  bot.sendMessage(msg.chat.id, 
    `👋 Welcome *${msg.from.first_name}*!\n\nChoose an option:`,
    { 
      parse_mode: 'Markdown',
      reply_markup: keyboard 
    }
  );
});

// Handle callback
bot.action('btn_1', async (query) => {
  await bot.answerCallbackQuery(query.id, { 
    text: '✅ Button 1 clicked!' 
  });
  await bot.editMessageText(
    query.message.chat.id,
    query.message.message_id,
    '🎲 You clicked Button 1!'
  );
});

// Handle text messages
bot.hears(/hello|hi/i, (msg) => {
  bot.sendMessage(msg.chat.id, '👋 Hi there!');
});

// Middleware example
bot.use((ctx, next) => {
  console.log(`User ${ctx.from?.id} sent a message`);
  return next();
});

bot.start();

📚 Documentation

Bot Configuration

const bot = new Bot('TOKEN', {
  polling: true,              // Enable polling (default: true)
  pollingInterval: 1000,      // Polling interval ms (default: 1000)
  sessionTimeout: 3600000,    // Session timeout ms (default: 1 hour)
  maxConnections: 100,        // Max concurrent connections
  rateLimit: 30,              // Rate limit per minute
  debug: false,               // Debug mode
  logLevel: 'info'            // Log level: debug, info, warn, error
});

Commands

// Basic command
bot.command('start', (msg) => {
  // Handle /start command
});

// Command with arguments
bot.command('echo', (msg) => {
  const args = msg.text.split(' ').slice(1);
  bot.sendMessage(msg.chat.id, args.join(' '));
});

// Multiple commands
bot.command(['help', 'bantuan'], (msg) => {
  // Handle both /help and /bantuan
});

Keyboards

Inline Keyboard

const { InlineKeyboard } = require('xbibz-telegram-bot');

// Builder pattern
const keyboard = InlineKeyboard.builder()
  .text('Button 1', 'callback_1')
  .text('Button 2', 'callback_2')
  .row()
  .url('Visit Website', 'https://example.com')
  .build();

// Quick methods
const simpleKeyboard = InlineKeyboard.singleButton(
  'Click Me', 'action_click'
);

const twoColumnKeyboard = InlineKeyboard.twoColumns([
  { text: 'Yes', callback_data: 'yes' },
  { text: 'No', callback_data: 'no' },
  { text: 'Maybe', callback_data: 'maybe' },
  { text: 'Cancel', callback_data: 'cancel' }
]);

Reply Keyboard

const { ReplyKeyboard } = require('xbibz-telegram-bot');

const keyboard = ReplyKeyboard.builder()
  .text('Option 1')
  .text('Option 2')
  .row()
  .requestContact('Share Contact')
  .requestLocation('Share Location')
  .build();

// Grid layout
const gridKeyboard = ReplyKeyboard.grid([
  { text: 'Button 1' },
  { text: 'Button 2' },
  { text: 'Button 3' },
  { text: 'Button 4' }
], 2); // 2 columns

Middleware

// Authentication middleware
const { middleware } = require('xbibz-telegram-bot');

const auth = new middleware.AuthMiddleware(
  [12345, 67890], // allowed user IDs
  [12345]         // admin IDs
);

bot.use(auth.middleware());

// Rate limiting
const rateLimit = new middleware.RateLimitMiddleware({
  windowMs: 60000,    // 1 minute
  max: 10,            // max 10 requests per window
  message: 'Too many requests!'
});

bot.use(rateLimit.middleware());

// Custom middleware
bot.use((ctx, next) => {
  // Log all messages
  console.log(`Message from ${ctx.from?.username}`);
  
  // Continue to next middleware
  return next();
});

Session Management

// Get session
const session = bot.getSession(userId);

// Set session data
bot.setSession(userId, {
  step: 'waiting_for_name',
  data: { age: 25 }
});

// Update session
const currentSession = bot.getSession(userId);
bot.setSession(userId, {
  ...currentSession,
  step: 'waiting_for_email'
});

// Delete session
bot.deleteSession(userId);

Plugins

Admin Plugin

const { plugins } = require('xbibz-telegram-bot');

const adminPlugin = new plugins.AdminPlugin(bot, [
  123456789 // admin user IDs
]);

// Commands added automatically:
// /admin - Admin panel
// /stats - Bot statistics
// /broadcast - Broadcast message
// /restart - Restart bot

Stats Plugin

const statsPlugin = new plugins.StatsPlugin(bot);

// Get statistics
const stats = statsPlugin.getStats();
console.log(stats);
// {
//   uptime: '2d 5h 30m 15s',
//   totalUsers: 1523,
//   totalChats: 856,
//   activeUsers24h: 245,
//   popularCommands: [...]
// }

// Export data
const users = statsPlugin.exportUserData();
const chats = statsPlugin.exportChatData();

Web Dashboard

const { plugins } = require('xbibz-telegram-bot');

const dashboard = new plugins.WebDashboard(bot, {
  port: 3000,
  auth: {
    username: 'admin',
    password: 'secret123'
  }
});

dashboard.start();
// Dashboard available at http://localhost:3000

Event Handling

// Message events
bot.on('message', (msg) => {
  console.log('New message:', msg.text);
});

bot.on('edited_message', (msg) => {
  console.log('Message edited:', msg.text);
});

// Callback queries
bot.on('callback_query', (query) => {
  console.log('Callback:', query.data);
});

// Inline queries
bot.on('inline_query', (query) => {
  console.log('Inline query:', query.query);
});

// Error handling
bot.on('error', (error) => {
  console.error('Bot error:', error);
});

// Internal events
bot.on('message_processed', () => {
  console.log('Message processed');
});

bot.on('command_executed', () => {
  console.log('Command executed');
});

Utility Functions

const { utils } = require('xbibz-telegram-bot');

// Formatter
utils.Formatter.escapeMarkdown('Text with *special* chars');
utils.Formatter.formatNumber(1234567.89, 2); // "1,234,567.89"
utils.Formatter.formatBytes(1048576); // "1 MB"
utils.Formatter.formatDuration(125000); // "2m 5s"

// Validator
utils.Validator.isEmail('[email protected]'); // true
utils.Validator.isURL('https://example.com'); // true
utils.Validator.isPhoneNumber('+1234567890'); // true

// Cache
const cache = new utils.Cache();
cache.set('key', 'value', 60000); // TTL 60 seconds
const value = cache.get('key');

🎨 Examples

1. Simple Echo Bot

const { Bot } = require('xbibz-telegram-bot');

const bot = new Bot('YOUR_TOKEN');

bot.command('start', (msg) => {
  bot.sendMessage(msg.chat.id, 'Send me any message!');
});

bot.on('message', (msg) => {
  if (!msg.text.startsWith('/')) {
    bot.sendMessage(msg.chat.id, `You said: ${msg.text}`);
  }
});

bot.start();

2. Quiz Bot

const { Bot, InlineKeyboard } = require('xbibz-telegram-bot');

const bot = new Bot('YOUR_TOKEN');

const quizzes = [
  {
    question: 'What is 2 + 2?',
    options: ['3', '4', '5', '6'],
    correct: 1
  }
];

bot.command('quiz', (msg) => {
  const quiz = quizzes[0];
  const keyboard = InlineKeyboard.builder();
  
  quiz.options.forEach((option, index) => {
    keyboard.text(option, `answer_${index}`);
    if (index % 2 === 1) keyboard.row();
  });
  
  bot.sendMessage(msg.chat.id, quiz.question, {
    reply_markup: keyboard.build()
  });
});

bot.action(/answer_(\d+)/, async (query) => {
  const answerIndex = parseInt(query.data.split('_')[1]);
  const quiz = quizzes[0];
  
  const correct = answerIndex === quiz.correct;
  await bot.answerCallbackQuery(query.id, {
    text: correct ? '✅ Correct!' : '❌ Wrong!',
    show_alert: true
  });
});

bot.start();

3. Multi-Step Form

const { Bot, ReplyKeyboard } = require('xbibz-telegram-bot');

const bot = new Bot('YOUR_TOKEN');

bot.command('register', (msg) => {
  bot.setSession(msg.from.id, { step: 'name' });
  bot.sendMessage(msg.chat.id, 'What is your name?');
});

bot.on('message', (msg) => {
  if (msg.text.startsWith('/')) return;
  
  const session = bot.getSession(msg.from.id);
  if (!session) return;
  
  switch(session.step) {
    case 'name':
      bot.setSession(msg.from.id, {
        step: 'age',
        name: msg.text
      });
      bot.sendMessage(msg.chat.id, 'How old are you?');
      break;
      
    case 'age':
      const userData = bot.getSession(msg.from.id);
      bot.sendMessage(msg.chat.id,
        `Registration complete!\nName: ${userData.name}\nAge: ${msg.text}`
      );
      bot.deleteSession(msg.from.id);
      break;
  }
});

bot.start();

4. Admin Bot with Dashboard

const { Bot, plugins } = require('xbibz-telegram-bot');

const bot = new Bot('YOUR_TOKEN');

// Add plugins
const adminPlugin = new plugins.AdminPlugin(bot, [YOUR_USER_ID]);
const statsPlugin = new plugins.StatsPlugin(bot);
const dashboard = new plugins.WebDashboard(bot, {
  port: 3000,
  auth: { username: 'admin', password: 'pass123' }
});

// Start dashboard
dashboard.start();

// Basic commands
bot.command('start', (msg) => {
  bot.sendMessage(msg.chat.id, 'Welcome! Use /admin for admin panel.');
});

bot.start();

🔧 Advanced Usage

Custom Error Handler

bot.on('error', (error) => {
  // Send error to monitoring service
  // Log to file
  // Send notification to admin
  console.error('Bot error:', error);
});

Performance Monitoring

setInterval(() => {
  const stats = bot.getStats();
  const apiStats = bot.api.getStats();
  
  console.log('Bot Stats:', stats);
  console.log('API Stats:', apiStats);
  
  // Send to monitoring dashboard
}, 60000); // Every minute

Graceful Shutdown

process.on('SIGINT', () => {
  console.log('Shutting down gracefully...');
  bot.stop();
  process.exit(0);
});

process.on('SIGTERM', () => {
  console.log('Shutting down gracefully...');
  bot.stop();
  process.exit(0);
});

📊 Performance

Benchmark results pada Node.js v18:

| Metric | Value | |--------|-------| | Messages/sec | 1000+ | | Memory usage | ~50MB | | CPU usage | <5% | | Startup time | <1s | | Response time | <50ms avg |

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Fork the repository
Create your feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

💝 Support

Jika library ini membantu project Anda, pertimbangkan untuk:

⭐ Star repository ini
🐛 Report bugs atau request features
💰 Donate via Ko-fi

📞 Contact

Xbibz Official

📱 Telegram: @XbibzOfficial
🎵 TikTok: @xbibzofficiall
☕ Donate: ko-fi.com/XbibzOfficial

Made with ❤️ by Xbibz Official

⬆ Back to top