create-bunspace 0.3.0 → 0.3.1

package/dist/templates/monorepo/apps/example/package.json

@@ -5,7 +5,7 @@
   "type": "module",
   "scripts": {
     "dev": "bun --watch src/index.ts",
-    "build": "bun build src/index.ts --outdir ./dist",
+    "build": "bun build src/index.ts --outdir ./dist --sourcemap && tsgo --emitDeclarationOnly",
     "typecheck": "tsgo --noEmit",
     "start": "bun run dist/index.js"
   },

package/dist/templates/monorepo/core/packages/utils/rolldown.config.ts

@@ -11,6 +11,16 @@ export default defineConfig([
     },
     external: ['@mks2508/better-logger', '@mks2508/no-throw'],
   },
+  {
+    input: './src/index.ts',
+    output: {
+      file: './dist/index.cjs',
+      format: 'cjs',
+      exports: 'named',
+      sourcemap: true,
+    },
+    external: ['@mks2508/better-logger', '@mks2508/no-throw'],
+  },
   {
     input: './src/logger.ts',
     output: {
@@ -21,6 +31,16 @@ export default defineConfig([
     },
     external: ['@mks2508/better-logger'],
   },
+  {
+    input: './src/logger.ts',
+    output: {
+      file: './dist/logger.cjs',
+      format: 'cjs',
+      exports: 'named',
+      sourcemap: true,
+    },
+    external: ['@mks2508/better-logger'],
+  },
   {
     input: './src/result.ts',
     output: {
@@ -31,4 +51,14 @@ export default defineConfig([
     },
     external: ['@mks2508/no-throw'],
   },
+  {
+    input: './src/result.ts',
+    output: {
+      file: './dist/result.cjs',
+      format: 'cjs',
+      exports: 'named',
+      sourcemap: true,
+    },
+    external: ['@mks2508/no-throw'],
+  },
 ]);

package/dist/templates/monorepo/tsconfig.json

@@ -29,7 +29,9 @@
     "declaration": true,
     "declarationMap": true,
     "sourceMap": true,
-    "removeComments": false
+    "removeComments": false,
+    "outDir": "./dist",
+    "declarationDir": "./dist"
   },
   "exclude": ["node_modules", "dist", "**/*.test.ts", "**/*.spec.ts"]
 }

package/dist/templates/telegram-bot/bun.lock

@@ -1,11 +1,13 @@
 {
   "lockfileVersion": 1,
+  "configVersion": 0,
   "workspaces": {
     "": {
       "name": "mks-telegram-bot",
       "dependencies": {
-        "@flla/telegram-format": "^3.1.2",
         "@inquirer/prompts": "^8.1.0",
+        "@mks2508/telegram-bot-utils": "workspace:*",
+        "@mks2508/telegram-message-builder": "0.3.1",
         "chalk": "^5.6.2",
         "commander": "^14.0.2",
         "dotenv": "^17.2.3",
@@ -27,25 +29,11 @@
       "version": "0.1.0",
       "dependencies": {
         "@mks2508/telegram-bot-utils": "workspace:*",
+        "@mks2508/telegram-message-builder": "0.3.1",
         "telegraf": "^4.16.3",
         "zod": "^3.24.0",
       },
     },
-    "packages/bootstrapper": {
-      "name": "@mks2508/bootstrapper",
-      "version": "0.1.0",
-      "dependencies": {
-        "@inquirer/prompts": "^8.1.0",
-        "@mks2508/better-logger": "^4.0.0",
-        "big-integer": "^1.6.52",
-        "telegraf": "^4.16.3",
-        "telegram": "^2.26.22",
-      },
-      "devDependencies": {
-        "@types/node": "^20",
-        "typescript": "^5",
-      },
-    },
     "packages/utils": {
       "name": "@mks2508/telegram-bot-utils",
       "version": "0.1.0",
@@ -58,8 +46,6 @@
   "packages": {
     "@cryptography/aes": ["@cryptography/aes@0.1.1", "", {}, "sha512-PcYz4FDGblO6tM2kSC+VzhhK62vml6k6/YAkiWtyPvrgJVfnDRoHGDtKn5UiaRRUrvUTTocBpvc2rRgTCqxjsg=="],
 
-    "@flla/telegram-format": ["@flla/telegram-format@3.1.2", "", {}, "sha512-pmBcT0f2ay77WlVq0EX3KseFp07IXU7QYahsY/Halx4/YnsM70qYeLRBoKysukU/l0ZQ2u15xu9rMECm9ov2+A=="],
-
     "@inquirer/ansi": ["@inquirer/ansi@2.0.2", "", {}, "sha512-SYLX05PwJVnW+WVegZt1T4Ip1qba1ik+pNJPDiqvk6zS5Y/i8PhRzLpGEtVd7sW0G8cMtkD8t4AZYhQwm8vnww=="],
 
     "@inquirer/checkbox": ["@inquirer/checkbox@5.0.3", "", { "dependencies": { "@inquirer/ansi": "^2.0.2", "@inquirer/core": "^11.1.0", "@inquirer/figures": "^2.0.2", "@inquirer/type": "^4.0.2" }, "peerDependencies": { "@types/node": ">=18" }, "optionalPeers": ["@types/node"] }, "sha512-xtQP2eXMFlOcAhZ4ReKP2KZvDIBb1AnCfZ81wWXG3DXLVH0f0g4obE0XDPH+ukAEMRcZT0kdX2AS1jrWGXbpxw=="],
@@ -98,14 +84,14 @@
 
     "@mks2508/better-logger": ["@mks2508/better-logger@4.0.0", "", { "dependencies": { "chalk": "^5.6.2" } }, "sha512-39PYkAKg7kC0ncPjcN5zAwTsLIS+iXoL4294gl3Cm4OAI6sAT7YJ+RccD42Ve5ybRC/TGgJnD0AUH5M26w0pWA=="],
 
-    "@mks2508/bootstrapper": ["@mks2508/bootstrapper@workspace:packages/bootstrapper"],
-
     "@mks2508/no-throw": ["@mks2508/no-throw@0.1.0", "", {}, "sha512-/CI8FqiO3oLw66XIQ07mw13b6PDNh1vit0cGzUBLq5MfJUTKDU0yaKFE0l9CqSpe6xv4n4+z4RWEytP5xePKZQ=="],
 
     "@mks2508/telegram-bot-core": ["@mks2508/telegram-bot-core@workspace:core"],
 
     "@mks2508/telegram-bot-utils": ["@mks2508/telegram-bot-utils@workspace:packages/utils"],
 
+    "@mks2508/telegram-message-builder": ["@mks2508/telegram-message-builder@0.3.1", "", {}, "sha512-i/BdbxVq13l8XzCUq8jMkFfYjrTXiCdErpzo9tEazLLqqEucAm2aY9HE5i8U+15mEWeSV4D6I9gfU8a5dSn1Cw=="],
+
     "@oxlint/darwin-arm64": ["@oxlint/darwin-arm64@1.38.0", "", { "os": "darwin", "cpu": "arm64" }, "sha512-9rN3047QTyA4i73FKikDUBdczRcLtOsIwZ5TsEx5Q7jr5nBjolhYQOFQf9QdhBLdInxw1iX4+lgdMCf1g74zjg=="],
 
     "@oxlint/darwin-x64": ["@oxlint/darwin-x64@1.38.0", "", { "os": "darwin", "cpu": "x64" }, "sha512-Y1UHW4KOlg5NvyrSn/bVBQP8/LRuid7Pnu+BWGbAVVsFcK0b565YgMSO3Eu9nU3w8ke91dr7NFpUmS+bVkdkbw=="],

package/dist/templates/telegram-bot/core/package.json

@@ -3,13 +3,24 @@
   "version": "0.1.0",
   "type": "module",
   "scripts": {
+    "build": "rolldown --config rolldown.config.ts && tsgo --emitDeclarationOnly",
     "dev": "bun run --watch src/index.ts",
     "start": "bun run src/index.ts",
     "typecheck": "tsgo --noEmit"
   },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
   "dependencies": {
     "@mks2508/telegram-bot-utils": "workspace:*",
+    "@mks2508/telegram-message-builder": "0.3.1",
     "telegraf": "^4.16.3",
     "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "rolldown": "^1.0.0-beta.58"
   }
 }

package/dist/templates/telegram-bot/core/rolldown.config.ts

@@ -0,0 +1,11 @@
+import { defineConfig } from 'rolldown';
+
+export default defineConfig({
+  input: './src/index.ts',
+  output: {
+    file: './dist/index.js',
+    format: 'esm',
+    sourcemap: true,
+  },
+  external: ['grammy', 'telegraf', '@mks2508/telegram-bot-utils', '@mks2508/telegram-message-builder', 'zod'],
+});

package/dist/templates/telegram-bot/core/src/config/logging.ts

@@ -54,9 +54,7 @@ let fileHandlersInitialized = false
  *   fileLogLevels: ['error', 'critical']
  * })
  */
-export function initializeFileLogging(
-  config: Partial<FileLoggingConfig> = {}
-): void {
+export function initializeFileLogging(config: Partial<FileLoggingConfig> = {}): void {
   // Setup logger with debug/logLevel options
   const appConfig = getConfig()
   setupLogger({ debug: appConfig.debug, logLevel: appConfig.logLevel })

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

@@ -2,7 +2,7 @@ import type { Context } from 'telegraf'
 import { badge, kv, colors, colorText } from '../middleware/logging.js'
 import { getConfig } from '../config/index.js'
 import { configLogger } from '@mks2508/telegram-bot-utils'
-import { MessageBuilder } from '../utils/message-builder.js'
+import { TelegramMessageBuilder } from '@mks2508/telegram-message-builder'
 
 const collectedTopics = new Map<number, string>()
 
@@ -19,14 +19,14 @@ export async function handleExportConfig(ctx: Context): Promise<void> {
   )
 
   const config = getConfig()
-  const builder = MessageBuilder.markdown()
+  const builder = TelegramMessageBuilder.text()
 
   // Title
   builder.title('🔧 Current Configuration')
   builder.newline()
 
   // Environment
-  builder.section('Environment:')
+  builder.section('Environment')
   builder.line('TG_ENV', config.environment, { code: true })
   builder.line('TG_INSTANCE_NAME', config.instanceName, { code: true })
   builder.line('TG_MODE', config.mode, { code: true })
@@ -35,13 +35,13 @@ export async function handleExportConfig(ctx: Context): Promise<void> {
   // Bot Token (masked)
   if (config.botToken) {
     const masked = config.botToken.slice(0, 6) + '...' + config.botToken.slice(-6)
-    builder.section('Bot:')
+    builder.section('Bot')
     builder.line('TG_BOT_TOKEN', masked, { code: true })
     builder.newline()
   }
 
   // Control
-  builder.section('Control Commands:')
+  builder.section('Control Commands')
   if (config.controlChatId) {
     builder.line('TG_CONTROL_CHAT_ID', String(config.controlChatId), { code: true })
   } else {
@@ -61,7 +61,7 @@ export async function handleExportConfig(ctx: Context): Promise<void> {
   }
 
   // Logging
-  builder.section('Logging:')
+  builder.section('Logging')
   if (config.logChatId) {
     builder.line('TG_LOG_CHAT_ID', String(config.logChatId), { code: true })
   } else {
@@ -77,7 +77,7 @@ export async function handleExportConfig(ctx: Context): Promise<void> {
 
   // Webhook
   if (config.mode === 'webhook') {
-    builder.section('Webhook:')
+    builder.section('Webhook')
     builder.line('TG_WEBHOOK_URL', config.webhookUrl || 'not_set', { code: true })
     builder.line('TG_WEBHOOK_SECRET', config.webhookSecret || 'not_set', { code: true })
     builder.newline()
@@ -89,13 +89,14 @@ export async function handleExportConfig(ctx: Context): Promise<void> {
   builder.newline()
 
   // Instructions
-  builder.section('📋 Quick Setup:')
+  builder.section('📋 Quick Setup')
   builder.listItem('Create topics: General, Control, Logs')
   builder.listItem('Mention @bot_username in each topic')
   builder.listItem('Use /getinfo to get Thread IDs')
   builder.listItem('Update .env with the IDs')
 
-  await ctx.reply(builder.build(), { parse_mode: builder.getParseMode() })
+  const message = builder.build()
+  await ctx.reply(message.text || '', { parse_mode: (message.parse_mode || 'HTML') as any })
   configLogger.success(`Config exported for user ${userId}`)
 }
 

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

@@ -2,7 +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 { MessageBuilder } from '../utils/message-builder.js'
+import { TelegramMessageBuilder } from '@mks2508/telegram-message-builder'
 
 export async function handleStop(ctx: Context): Promise<void> {
   const userId = ctx.from?.id ?? 'unknown'
@@ -14,8 +14,10 @@ export async function handleStop(ctx: Context): Promise<void> {
     })}`
   )
 
-  const message = MessageBuilder.markdown().text('🛑 Shutting down bot...').build()
-  ctx.reply(message, { parse_mode: 'Markdown' })
+  const message = TelegramMessageBuilder.text()
+    .text('🛑 Shutting down bot...')
+    .build()
+  ctx.reply(message.text || '', { parse_mode: (message.parse_mode || 'HTML') as any })
   process.exit(0)
 }
 
@@ -29,15 +31,17 @@ export async function handleRestart(ctx: Context): Promise<void> {
     })}`
   )
 
-  const builder1 = MessageBuilder.markdown()
-  builder1.text('🔄 Restarting bot...')
-  ctx.reply(builder1.build(), { parse_mode: builder1.getParseMode() })
+  const message1 = TelegramMessageBuilder.text()
+    .text('🔄 Restarting bot...')
+    .build()
+  ctx.reply(message1.text || '', { parse_mode: (message1.parse_mode || 'HTML') as any })
 
   botManager.resetStats()
 
-  const builder2 = MessageBuilder.markdown()
-  builder2.text('✅ Bot stats reset. Restarting...')
-  ctx.reply(builder2.build(), { parse_mode: builder2.getParseMode() })
+  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)
 }
 
@@ -48,34 +52,37 @@ export async function handleMode(ctx: Context): Promise<void> {
 
   if (!mode || (mode !== 'polling' && mode !== 'webhook')) {
     const config = getConfig()
-    const builder = MessageBuilder.markdown()
-      .title('📡 Current Mode:')
+    const message = TelegramMessageBuilder.text()
+      .title('📡 Current Mode')
       .newline()
       .line('Mode', config.mode, { code: true })
       .newline()
       .text('Usage: /mode <polling|webhook>')
+      .build()
 
-    ctx.reply(builder.build(), { parse_mode: builder.getParseMode() })
+    ctx.reply(message.text || '', { parse_mode: (message.parse_mode || 'HTML') as any })
     return
   }
 
   if (mode === 'webhook') {
     const config = getConfig()
     if (!config.webhookUrl) {
-      const builder = MessageBuilder.markdown()
+      const message = TelegramMessageBuilder.text()
         .text('❌ Webhook URL not configured. Set TG_WEBHOOK_URL environment variable.')
-      ctx.reply(builder.build(), { parse_mode: builder.getParseMode() })
+        .build()
+      ctx.reply(message.text || '', { parse_mode: (message.parse_mode || 'HTML') as any })
       return
     }
   }
 
   updateConfig({ mode })
 
-  const builder = MessageBuilder.markdown()
+  const message = TelegramMessageBuilder.text()
     .text('✅ Mode changed to:')
     .line('Mode', mode, { code: true })
+    .build()
 
-  ctx.reply(builder.build(), { parse_mode: builder.getParseMode() })
+  ctx.reply(message.text || '', { parse_mode: (message.parse_mode || 'HTML') as any })
 
   controlLogger.info(
     `${badge('MODE', 'rounded')} ${kv({
@@ -89,18 +96,20 @@ export async function handleWebhook(ctx: Context): Promise<void> {
   const config = getConfig()
 
   if (config.mode !== 'webhook') {
-    const builder = MessageBuilder.markdown()
+    const message = TelegramMessageBuilder.text()
       .text('❌ Bot is not in webhook mode. Use /mode webhook first.')
-    ctx.reply(builder.build(), { parse_mode: builder.getParseMode() })
+      .build()
+    ctx.reply(message.text || '', { parse_mode: (message.parse_mode || 'HTML') as any })
     return
   }
 
-  const builder = MessageBuilder.markdown()
-    .title('🔗 Webhook Configuration:')
+  const message = TelegramMessageBuilder.text()
+    .title('🔗 Webhook Configuration')
     .newline()
     .line('URL', config.webhookUrl || 'Not set', { code: true })
+    .build()
 
-  ctx.reply(builder.build(), { parse_mode: builder.getParseMode() })
+  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,
+  })
+}