Telegram Bot

/**
 * Create and configure Telegram bot instance
 * Requires BOT_TOKEN environment variable
 */
const bot = new TeleBot({
  token: process.env.BOT_TOKEN
});

/**
 * Start the bot and begin listening for messages
 */
bot.start(): void;

import TeleBot from 'telebot';
import dotenv from 'dotenv';

dotenv.config();

// Initialize bot with token from environment
const bot = new TeleBot({
  token: process.env.BOT_TOKEN
});

// Start bot
bot.start();
console.log('Bot is running...');

/**
 * Update download statistics for a user
 * @param userId - Telegram user ID
 */
function updateUserStats(userId: number): void;

/**
 * Check if user can download (within daily limit)
 * @param userId - Telegram user ID
 * @returns Boolean indicating if user can download
 */
function canUserDownload(userId: number): boolean;

/** Maximum downloads allowed per user per day */
const MAX_DOWNLOADS_PER_DAY: number = 5;

/** User statistics storage */
const userStats: Map<number, UserStats>;

interface UserStats {
  /** Date of downloads (string format) */
  date: string;
  /** Number of downloads on this date */
  count: number;
}

// Check if user can download
const userId = 12345;
if (canUserDownload(userId)) {
  // Process download
  await handleTikTokUrl(msg, url);
  updateUserStats(userId);
} else {
  await bot.sendMessage(msg.chat.id, `You've reached the daily limit of ${MAX_DOWNLOADS_PER_DAY} downloads.`);
}

// Check user statistics
const stats = userStats.get(userId);
if (stats) {
  console.log(`User ${userId} has ${stats.count} downloads on ${stats.date}`);
}

/**
 * Handle start and help commands
 * Shows welcome message and usage instructions
 */
bot.on(['/start', '/help'], (msg) => void);

/**
 * Handle stats command
 * Shows user's download statistics for current day
 */
bot.on('/stats', (msg) => void);

/**
 * Handle text messages
 * Processes TikTok URLs automatically
 */
bot.on('text', async (msg) => void);

// User sends: /start
// Bot responds with:
`Welcome to TikTok Downloader Bot!

Commands:
/start or /help - Show this help message
/stats - Show your download statistics

To download a TikTok video, simply send the TikTok URL to the bot.

Note: You can download up to 5 videos per day.`

// User sends: /stats  
// Bot responds with:
`Today (2023-09-05) you've downloaded 3 videos.`
// or
`You haven't downloaded any videos today.`

/**
 * Download TikTok video with progress tracking and visual progress bar
 * @param url - TikTok video URL
 * @param outputPath - Local file path to save video
 * @returns Promise resolving when download completes
 * @throws Error if TikTok API fails or video unavailable
 */
async function downloadTikTokVideo(url: string, outputPath: string): Promise<void>;

/**
 * Complete workflow for processing TikTok URL from Telegram message
 * Includes rate limiting, download, upload, and cleanup
 * @param msg - Telegram message object containing user and chat info
 * @param url - Extracted TikTok URL to process
 * @returns Promise resolving when processing completes
 */
async function handleTikTokUrl(msg: TelegramMessage, url: string): Promise<void>;

// Complete workflow when user sends TikTok URL: https://vm.tiktok.com/ZSFxxxxxx/
// Bot automatically:
// 1. Checks user download limit (5 per day)
// 2. Sends "Processing..." reply message
// 3. Calls TiktokDL to get video metadata
// 4. Downloads video with progress bar using axios stream
// 5. Calls ReelsUpload with video filename and extracted caption
// 6. Sends success/failure message to user
// 7. Updates user statistics
// 8. Cleans up temporary files with fs.unlinkSync

// Internal download implementation
const outputPath = './download/video123.mp4';
try {
  const result = await TiktokDL(url);
  const video = result.result.video[0]; // First video URL
  const response = await axios({
    url: video,
    method: 'GET',
    responseType: 'stream'
  });
  
  // Progress bar setup
  const totalLength = response.headers['content-length'];
  const progressBar = new ProgressBar(progressTemplate, {
    width: 40,
    complete: '<',
    incomplete: '•',
    total: parseInt(totalLength)
  });
  
  await downloadTikTokVideo(url, outputPath);
} catch (error) {
  console.error('Download failed:', error);
}

/** Regular expression for detecting TikTok URLs in messages */
const tiktokRegex: RegExp = /https?:\/\/(?:m|www|vm|vt)?\.?tiktok\.com\/\S+/;

/** Configuration constants */
const MAX_DOWNLOADS_PER_DAY: number = 5;
const userStats: Map<number, UserStats>;

interface TelegramMessage {
  /** Message text content */
  text: string;
  /** Sender information */
  from: {
    id: number;
    // ... other Telegram user properties
  };
  /** Chat information */
  chat: {
    id: number;
    // ... other Telegram chat properties
  };
  /** Message ID for replies */
  message_id: number;
}

// Supported URL formats
const supportedUrls = [
  'https://www.tiktok.com/@user/video/123',
  'https://vm.tiktok.com/ZSFxxxxxx/',
  'https://vt.tiktok.com/ZSFxxxxxx/',
  'https://m.tiktok.com/v/123.html',
  'https://tiktok.com/@user/video/123'
];

// All formats are automatically detected and processed

/** Bot token from BotFather */
process.env.BOT_TOKEN: string;

// User exceeds daily limit
`You've reached the daily limit of 5 downloads.`

// General processing failure
`An error occurred: ${error.message}`

// TikTok API failures
// When TiktokDL returns error status
if (result.status === 'error') {
  // Handle specific TikTok API errors
}

// Facebook upload fails
`Upload failed: ${upload.message}`

// Specific upload error messages (in Indonesian)
"Video Gagal di publish!"           // "Video failed to publish!"
"INFO: Session tidak ditemukan..."  // "INFO: Session not found..."

// Download failures
"Error downloading video: ${error.message}"

// File system errors during cleanup
// fs.unlinkSync may throw if file doesn't exist or permissions issue
try {
  fs.unlinkSync(outputPath);
} catch (cleanupError) {
  // Non-critical cleanup failure
}