create-bunspace 0.2.5 → 0.3.1

package/dist/templates/telegram-bot/core/src/handlers/control.ts

@@ -2,6 +2,7 @@ import type { Context } from 'telegraf'
 import { updateConfig, getConfig } from '../config/index.js'
 import { botLogger, controlLogger, badge, kv, colors, colorText } from '../middleware/logging.js'
 import { botManager } from '../utils/bot-manager.js'
+import { TelegramMessageBuilder } from '@mks2508/telegram-message-builder'
 
 export async function handleStop(ctx: Context): Promise<void> {
   const userId = ctx.from?.id ?? 'unknown'
@@ -13,7 +14,10 @@ export async function handleStop(ctx: Context): Promise<void> {
     })}`
   )
 
-  ctx.reply('🛑 Shutting down bot...')
+  const message = TelegramMessageBuilder.text()
+    .text('🛑 Shutting down bot...')
+    .build()
+  ctx.reply(message.text || '', { parse_mode: (message.parse_mode || 'HTML') as any })
   process.exit(0)
 }
 
@@ -27,9 +31,17 @@ export async function handleRestart(ctx: Context): Promise<void> {
     })}`
   )
 
-  ctx.reply('🔄 Restarting bot...')
+  const message1 = TelegramMessageBuilder.text()
+    .text('🔄 Restarting bot...')
+    .build()
+  ctx.reply(message1.text || '', { parse_mode: (message1.parse_mode || 'HTML') as any })
+
   botManager.resetStats()
-  ctx.reply('✅ Bot stats reset. Restarting...')
+
+  const message2 = TelegramMessageBuilder.text()
+    .text('✅ Bot stats reset. Restarting...')
+    .build()
+  ctx.reply(message2.text || '', { parse_mode: (message2.parse_mode || 'HTML') as any })
   process.exit(0)
 }
 
@@ -40,22 +52,37 @@ export async function handleMode(ctx: Context): Promise<void> {
 
   if (!mode || (mode !== 'polling' && mode !== 'webhook')) {
     const config = getConfig()
-    ctx.reply(`📡 *Current Mode:* \`${config.mode}\`\n\nUsage: /mode <polling|webhook>`, {
-      parse_mode: 'Markdown',
-    })
+    const message = TelegramMessageBuilder.text()
+      .title('📡 Current Mode')
+      .newline()
+      .line('Mode', config.mode, { code: true })
+      .newline()
+      .text('Usage: /mode <polling|webhook>')
+      .build()
+
+    ctx.reply(message.text || '', { parse_mode: (message.parse_mode || 'HTML') as any })
     return
   }
 
   if (mode === 'webhook') {
     const config = getConfig()
     if (!config.webhookUrl) {
-      ctx.reply('❌ Webhook URL not configured. Set TG_WEBHOOK_URL environment variable.')
+      const message = TelegramMessageBuilder.text()
+        .text('❌ Webhook URL not configured. Set TG_WEBHOOK_URL environment variable.')
+        .build()
+      ctx.reply(message.text || '', { parse_mode: (message.parse_mode || 'HTML') as any })
       return
     }
   }
 
   updateConfig({ mode })
-  ctx.reply(`✅ Mode changed to: \`${mode}\``, { parse_mode: 'Markdown' })
+
+  const message = TelegramMessageBuilder.text()
+    .text('✅ Mode changed to:')
+    .line('Mode', mode, { code: true })
+    .build()
+
+  ctx.reply(message.text || '', { parse_mode: (message.parse_mode || 'HTML') as any })
 
   controlLogger.info(
     `${badge('MODE', 'rounded')} ${kv({
@@ -69,12 +96,20 @@ export async function handleWebhook(ctx: Context): Promise<void> {
   const config = getConfig()
 
   if (config.mode !== 'webhook') {
-    ctx.reply('❌ Bot is not in webhook mode. Use /mode webhook first.')
+    const message = TelegramMessageBuilder.text()
+      .text('❌ Bot is not in webhook mode. Use /mode webhook first.')
+      .build()
+    ctx.reply(message.text || '', { parse_mode: (message.parse_mode || 'HTML') as any })
     return
   }
 
-  const message = `🔗 *Webhook Configuration:*\n\nURL: \`${config.webhookUrl || 'Not set'}\``
-  ctx.reply(message, { parse_mode: 'Markdown' })
+  const message = TelegramMessageBuilder.text()
+    .title('🔗 Webhook Configuration')
+    .newline()
+    .line('URL', config.webhookUrl || 'Not set', { code: true })
+    .build()
+
+  ctx.reply(message.text || '', { parse_mode: (message.parse_mode || 'HTML') as any })
 
   controlLogger.info(
     `${badge('WEBHOOK', 'rounded')} ${kv({

package/dist/templates/telegram-bot/core/src/handlers/demo-full.ts

@@ -0,0 +1,58 @@
+import { TelegramMessageBuilder, TelegramKeyboardBuilder } from '@mks2508/telegram-message-builder'
+import type { Context } from 'telegraf'
+import { handleMediaDemo } from './demo-media.js'
+import { handleKeyboardDemo } from './demo-keyboard.js'
+
+export async function handleFullDemo(ctx: Context): Promise<void> {
+  const message = TelegramMessageBuilder.text()
+    .title('🚀 telegram-message-builder v0.3.0')
+    .newline()
+    .section('Features')
+    .listItem('✨ Fluent API for text formatting')
+    .listItem('⌨️ Inline and reply keyboards')
+    .listItem('📸 5 media types support')
+    .listItem('🎨 HTML, Markdown, MarkdownV2')
+    .listItem('🔒 Type-safe with TypeScript')
+    .listItem('📦 Zero runtime dependencies')
+    .newline()
+    .section('Installation')
+    .codeBlock('bun add @mks2508/telegram-message-builder', 'bash')
+    .newline()
+    .section('Quick Start')
+    .codeBlock(`import { TelegramMessageBuilder } from '@mks2508/telegram-message-builder'
+
+const message = TelegramMessageBuilder.text()
+  .title('Hello World')
+  .line('Status', 'Active', { bold: true })
+  .build()
+
+ctx.reply(message.text, { parse_mode: message.parse_mode })`, 'typescript')
+    .build()
+
+  const keyboard = TelegramKeyboardBuilder.inline()
+    .urlButton('📦 npm Package', 'https://www.npmjs.com/package/@mks2508/telegram-message-builder')
+    .urlButton('📖 GitHub', 'https://github.com/MKS2508/telegram-message-builder')
+    .row()
+    .callbackButton('📸 Media Demo', 'full_demo_media')
+    .callbackButton('⌨️ Keyboard Demo', 'full_demo_keyboard')
+    .buildMarkup()
+
+  await ctx.reply(message.text || '', {
+    parse_mode: (message.parse_mode || 'HTML') as any,
+    reply_markup: keyboard as any,
+  })
+}
+
+export async function handleFullDemoCallback(ctx: Context): Promise<void> {
+  const callbackData = (ctx.callbackQuery as any)?.data
+  await ctx.answerCbQuery()
+
+  switch (callbackData) {
+    case 'full_demo_media':
+      await handleMediaDemo(ctx)
+      break
+    case 'full_demo_keyboard':
+      await handleKeyboardDemo(ctx)
+      break
+  }
+}

package/dist/templates/telegram-bot/core/src/handlers/demo-keyboard.ts

@@ -0,0 +1,49 @@
+import { TelegramMessageBuilder, TelegramKeyboardBuilder } from '@mks2508/telegram-message-builder'
+import type { Context } from 'telegraf'
+
+export async function handleKeyboardDemo(ctx: Context): Promise<void> {
+  const message = TelegramMessageBuilder.text()
+    .title('⌨️ Keyboard Demo')
+    .newline()
+    .text('Try the buttons below:')
+    .build()
+
+  const keyboard = TelegramKeyboardBuilder.inline()
+    .urlButton('🌐 Visit Website', 'https://github.com/MKS2508/telegram-message-builder')
+    .callbackButton('✅ Yes', 'demo_yes')
+    .callbackButton('❌ No', 'demo_no')
+    .row()
+    .callbackButton('🔄 Refresh', 'demo_refresh')
+    .callbackButton('🔍 Search', 'demo_search')
+    .row()
+    .switchInlineQueryButton('🔍 Inline Query', 'query')
+    .buildMarkup()
+
+  await ctx.reply(message.text || '', {
+    parse_mode: (message.parse_mode || 'HTML') as any,
+    reply_markup: keyboard as any,
+  })
+}
+
+export async function handleKeyboardCallback(ctx: Context): Promise<void> {
+  const callbackData = (ctx.callbackQuery as any)?.data
+  let response = 'Unknown action'
+
+  switch (callbackData) {
+    case 'demo_yes':
+      response = '✅ You clicked YES!'
+      break
+    case 'demo_no':
+      response = '❌ You clicked NO!'
+      break
+    case 'demo_refresh':
+      response = '🔄 Content refreshed!'
+      break
+    case 'demo_search':
+      response = '🔍 Searching...'
+      break
+  }
+
+  await ctx.answerCbQuery(response)
+  await ctx.reply(response)
+}

package/dist/templates/telegram-bot/core/src/handlers/demo-media.ts

@@ -0,0 +1,163 @@
+import { TelegramMessageBuilder, TelegramMediaBuilder, TelegramKeyboardBuilder } from '@mks2508/telegram-message-builder'
+import type { Context } from 'telegraf'
+
+export async function handleMediaDemo(ctx: Context): Promise<void> {
+  const message = TelegramMessageBuilder.text()
+    .title('📸 Media Builder Demo')
+    .newline()
+    .text('Choose a media type to test:')
+    .listItem('Photo with caption')
+    .listItem('Video with options')
+    .listItem('Document with metadata')
+    .listItem('Audio with performer info')
+    .listItem('Voice message')
+    .build()
+
+  const keyboard = TelegramKeyboardBuilder.inline()
+    .callbackButton('📷 Photo', 'media_photo')
+    .callbackButton('🎥 Video', 'media_video')
+    .row()
+    .callbackButton('📄 Document', 'media_document')
+    .callbackButton('🎵 Audio', 'media_audio')
+    .row()
+    .callbackButton('🎤 Voice', 'media_voice')
+    .buildMarkup()
+
+  await ctx.reply(message.text || '', {
+    parse_mode: (message.parse_mode || 'HTML') as any,
+    reply_markup: keyboard as any,
+  })
+}
+
+export async function handleMediaCallback(ctx: Context): Promise<void> {
+  const callbackData = (ctx.callbackQuery as any)?.data
+  await ctx.answerCbQuery()
+
+  switch (callbackData) {
+    case 'media_photo':
+      await sendPhotoDemo(ctx)
+      break
+    case 'media_video':
+      await sendVideoDemo(ctx)
+      break
+    case 'media_document':
+      await sendDocumentDemo(ctx)
+      break
+    case 'media_audio':
+      await sendAudioDemo(ctx)
+      break
+    case 'media_voice':
+      await sendVoiceDemo(ctx)
+      break
+  }
+}
+
+async function sendPhotoDemo(ctx: Context): Promise<void> {
+  const photo = TelegramMediaBuilder.photo('https://picsum.photos/800/600')
+    .caption('📷 Photo Demo\n\nThis is a photo with caption formatting support!')
+    .setParseMode('html')
+    .build()
+
+  const media = typeof photo.media === 'string' ? photo.media : undefined
+
+  if (!media) {
+    await ctx.reply('❌ Media source must be a URL or file_id')
+    return
+  }
+
+  await ctx.replyWithPhoto(media, {
+    caption: photo.caption || undefined,
+    parse_mode: photo.parse_mode as any,
+  })
+}
+
+async function sendVideoDemo(ctx: Context): Promise<void> {
+  const video = TelegramMediaBuilder.video('https://sample-videos.com/video123/mp4/720/big_buck_bunny_720p_1mb.mp4')
+    .caption('🎥 Video Demo\n\nDuration: 10s\nResolution: 1280x720')
+    .duration(10)
+    .width(1280)
+    .height(720)
+    .enableStreaming()
+    .setParseMode('html')
+    .build()
+
+  const media = typeof video.media === 'string' ? video.media : undefined
+
+  if (!media) {
+    await ctx.reply('❌ Media source must be a URL or file_id')
+    return
+  }
+
+  await ctx.replyWithVideo(media, {
+    caption: video.caption || undefined,
+    parse_mode: video.parse_mode as any,
+    width: video.width as number,
+    height: video.height as number,
+    duration: video.duration as number,
+    supports_streaming: true,
+  })
+}
+
+async function sendDocumentDemo(ctx: Context): Promise<void> {
+  const doc = TelegramMediaBuilder.document('https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf')
+    .caption('📄 Document Demo\n\nThis is a PDF document with custom filename.')
+    .fileName('sample-document.pdf')
+    .mimeType('application/pdf')
+    .build()
+
+  const media = typeof doc.media === 'string' ? doc.media : undefined
+
+  if (!media) {
+    await ctx.reply('❌ Media source must be a URL or file_id')
+    return
+  }
+
+  await ctx.replyWithDocument(media, {
+    caption: doc.caption || undefined,
+    parse_mode: doc.parse_mode as any,
+  })
+}
+
+async function sendAudioDemo(ctx: Context): Promise<void> {
+  const audio = TelegramMediaBuilder.audio('https://www.soundhelix.com/examples/mp3/SoundHelix-Song-1.mp3')
+    .caption('🎵 Audio Demo\n\nArtist: Demo Artist\nTitle: Demo Song')
+    .performer('Demo Artist')
+    .title('Demo Song')
+    .duration(180)
+    .build()
+
+  const media = typeof audio.media === 'string' ? audio.media : undefined
+
+  if (!media) {
+    await ctx.reply('❌ Media source must be a URL or file_id')
+    return
+  }
+
+  await ctx.replyWithAudio(media, {
+    caption: audio.caption || undefined,
+    parse_mode: audio.parse_mode as any,
+    performer: audio.performer as string,
+    title: audio.title as string,
+    duration: audio.duration as number,
+  })
+}
+
+async function sendVoiceDemo(ctx: Context): Promise<void> {
+  const voice = TelegramMediaBuilder.voice('https://sample-videos.com/audio/mp3/crowd-cheering.mp3')
+    .caption('🎤 Voice Demo\n\nThis is a voice message.')
+    .duration(5)
+    .build()
+
+  const media = typeof voice.media === 'string' ? voice.media : undefined
+
+  if (!media) {
+    await ctx.reply('❌ Media source must be a URL or file_id')
+    return
+  }
+
+  await ctx.replyWithVoice(media, {
+    caption: voice.caption || undefined,
+    parse_mode: voice.parse_mode as any,
+    duration: voice.duration as number,
+  })
+}

package/dist/templates/telegram-bot/core/src/handlers/demo-text.ts

@@ -0,0 +1,27 @@
+import { TelegramMessageBuilder, fmt } from '@mks2508/telegram-message-builder'
+import type { Context } from 'telegraf'
+
+export async function handleTextDemo(ctx: Context): Promise<void> {
+  const message = TelegramMessageBuilder.text()
+    .title('🎨 Text Formatting Demo')
+    .newline()
+    .section('Inline Formatting')
+    .line('Bold', fmt.bold('This is bold text'))
+    .line('Italic', fmt.italic('This is italic text'))
+    .line('Code', fmt.code('const x = 1'))
+    .line('Link', fmt.link('Click here', 'https://example.com'))
+    .newline()
+    .section('Special Elements')
+    .line('Mention', fmt.mention(123456, 'Username'))
+    .line('Hashtag', fmt.hashtag('telegram'))
+    .newline()
+    .codeBlock(`console.log('Hello from telegram-message-builder!')`, 'javascript')
+    .newline()
+    .separator()
+    .listItem('Feature 1: Fluent API')
+    .listItem('Feature 2: Type-safe')
+    .listItem('Feature 3: Zero dependencies')
+    .build()
+
+  await ctx.reply(message.text || '', { parse_mode: (message.parse_mode || 'HTML') as any })
+}

package/dist/templates/telegram-bot/core/src/handlers/health.ts

@@ -1,6 +1,7 @@
 import type { Context } from 'telegraf'
 import { getConfig } from '../config/index.js'
-import { formatHealthMessage } from '../utils/formatters.js'
+import { formatUptime } from '../utils/formatters.js'
+import { TelegramMessageBuilder } from '@mks2508/telegram-message-builder'
 import { healthLogger, badge, kv, colors, colorText } from '../middleware/logging.js'
 
 export async function handleHealth(ctx: Context): Promise<void> {
@@ -17,15 +18,21 @@ export async function handleHealth(ctx: Context): Promise<void> {
   const uptime = Date.now() - (Date.now() - 10000)
   const memoryUsage = process.memoryUsage()
 
-  const message = formatHealthMessage({
-    status: 'running' as const,
-    mode: config.mode,
-    startTime: Date.now() - 10000,
-    uptime,
-    memoryUsage,
-  })
-
-  await ctx.reply(message, { parse_mode: 'Markdown' })
+  const mb = (bytes: number) => (bytes / 1024 / 1024).toFixed(2)
+
+  const message = TelegramMessageBuilder.text()
+    .title('🏥 Bot Health Status')
+    .newline()
+    .line('Status', 'RUNNING', { bold: true })
+    .line('Mode', config.mode.toUpperCase())
+    .line('Uptime', formatUptime(uptime))
+    .newline()
+    .section('Memory Usage')
+    .text(`RSS: ${mb(memoryUsage.rss)}MB`)
+    .text(`Heap: ${mb(memoryUsage.heapUsed)}/${mb(memoryUsage.heapTotal)}MB`)
+    .build()
+
+  await ctx.reply(message.text || '', { parse_mode: (message.parse_mode || 'HTML') as any })
 }
 
 export async function handleUptime(ctx: Context): Promise<void> {
@@ -39,18 +46,13 @@ export async function handleUptime(ctx: Context): Promise<void> {
   )
 
   const uptime = Date.now() - (Date.now() - 10000)
-  const days = Math.floor(uptime / 86400000)
-  const hours = Math.floor((uptime % 86400000) / 3600000)
-  const minutes = Math.floor((uptime % 3600000) / 60000)
-  const seconds = Math.floor((uptime % 60000) / 1000)
-
-  let formatted = ''
-  if (days > 0) formatted += `${days}d `
-  if (hours > 0) formatted += `${hours}h `
-  if (minutes > 0) formatted += `${minutes}m `
-  formatted += `${seconds}s`
-
-  await ctx.reply(`⏱️ *Uptime:*\n${formatted}`, { parse_mode: 'Markdown' })
+
+  const message = TelegramMessageBuilder.text()
+    .title('⏱️ Uptime:')
+    .text(formatUptime(uptime))
+    .build()
+
+  await ctx.reply(message.text || '', { parse_mode: (message.parse_mode || 'HTML') as any })
 }
 
 export async function handleStats(ctx: Context): Promise<void> {
@@ -65,19 +67,20 @@ export async function handleStats(ctx: Context): Promise<void> {
 
   const config = getConfig()
 
-  const message = `📊 *Bot Statistics*
-
-*Performance:*
-Messages Processed: 0
-Commands Executed: 0
-Errors Encountered: 0
-
-*Configuration:*
-Mode: ${config.mode.toUpperCase()}
-Log Level: ${config.logLevel.toUpperCase()}
-Logging Enabled: ${config.logChatId ? '✅' : '❌'}
-Control Enabled: ${config.controlChatId ? '✅' : '❌'}
-  `
-
-  await ctx.reply(message, { parse_mode: 'Markdown' })
+  const message = TelegramMessageBuilder.text()
+    .title('📊 Bot Statistics')
+    .newline()
+    .section('Performance')
+    .line('Messages Processed', '0')
+    .line('Commands Executed', '0')
+    .line('Errors Encountered', '0')
+    .newline()
+    .section('Configuration')
+    .line('Mode', config.mode.toUpperCase())
+    .line('Log Level', config.logLevel.toUpperCase())
+    .line('Logging Enabled', config.logChatId ? '✅' : '❌')
+    .line('Control Enabled', config.controlChatId ? '✅' : '❌')
+    .build()
+
+  await ctx.reply(message.text || '', { parse_mode: (message.parse_mode || 'HTML') as any })
 }