create-bunspace 0.3.0 → 0.3.1

package/templates/telegram-bot/core/src/handlers/info.ts

@@ -1,6 +1,6 @@
 import type { Context } from 'telegraf'
 import { infoLogger, badge, kv, colors, colorText } from '../middleware/logging.js'
-import { MessageBuilder } from '../utils/message-builder.js'
+import { TelegramMessageBuilder } from '@mks2508/telegram-message-builder'
 
 export async function handleGetInfo(ctx: Context): Promise<void> {
   const userId = ctx.from?.id ?? 'unknown'
@@ -17,16 +17,14 @@ export async function handleGetInfo(ctx: Context): Promise<void> {
   const from = ctx.from
   const chat = ctx.chat
 
-  const builder = MessageBuilder.markdown()
-
-  // Title
-  builder.title('📋 Your Information')
-  builder.newline()
+  const builder = TelegramMessageBuilder.text()
+    .title('📋 Your Information')
+    .newline()
 
   // User info
   if (from) {
     builder.section('👤 User Info:')
-    builder.line('User ID', String(from.id), { code: true })
+      .line('User ID', String(from.id), { code: true })
     if (from.username) builder.line('Username', `@${from.username}`)
     if (from.first_name) builder.line('First Name', from.first_name)
     if (from.last_name) builder.line('Last Name', from.last_name)
@@ -38,8 +36,8 @@ export async function handleGetInfo(ctx: Context): Promise<void> {
   // Chat info
   if (chat) {
     builder.section('💬 Chat Info:')
-    builder.line('Chat ID', String(chat.id), { code: true })
-    builder.line('Type', chat.type)
+      .line('Chat ID', String(chat.id), { code: true })
+      .line('Type', chat.type)
     if ('title' in chat && chat.title) builder.line('Title', chat.title)
     if ('username' in chat && chat.username) builder.line('Username', `@${chat.username}`)
     if (chat.type === 'supergroup' || chat.type === 'group') {
@@ -53,7 +51,7 @@ export async function handleGetInfo(ctx: Context): Promise<void> {
     const botMention = detectBotMention(msg as unknown as MaybeMessage, botUsername)
     if (botMention.isMentioned) {
       builder.section('🤖 Bot Mention:')
-      builder.line('Bot mentioned', 'Yes')
+        .line('Bot mentioned', 'Yes')
       if (botMention.type) builder.line('Mention type', botMention.type)
       if (botMention.replyToBot) builder.text('Replying to bot message')
       builder.newline()
@@ -64,7 +62,7 @@ export async function handleGetInfo(ctx: Context): Promise<void> {
   // Message/Topic info
   if (msg) {
     builder.section('📮 Message Info:')
-    builder.line('Message ID', String(msg.message_id))
+      .line('Message ID', String(msg.message_id))
     if ('reply_to_message' in msg && msg.reply_to_message) {
       const replyTo = msg.reply_to_message
       builder.line('Reply to message ID', String(replyTo.message_id))
@@ -75,31 +73,31 @@ export async function handleGetInfo(ctx: Context): Promise<void> {
   const threadId = getThreadId(msg as unknown as MaybeMessage)
   if (threadId) {
     builder.newline()
-    builder.section('🧵 Thread/Topic:')
-    builder.line('Thread ID', String(threadId), { code: true })
-    builder.text('This message is in a topic')
-    builder.newline()
+      .section('🧵 Thread/Topic:')
+      .line('Thread ID', String(threadId), { code: true })
+      .text('This message is in a topic')
+      .newline()
     infoLogger.info(`Message sent in thread ${threadId} by user ${userId}`)
   }
 
   // Configuration tips
   builder.newline()
-  builder.section('🔧 Configuration:')
-  builder.line('TG_CONTROL_CHAT_ID', String(chat?.id ?? 'N/A'), { code: true })
-  builder.line('TG_AUTHORIZED_USER_IDS', String(from?.id ?? 'N/A'))
+    .section('🔧 Configuration:')
+    .line('TG_CONTROL_CHAT_ID', String(chat?.id ?? 'N/A'), { code: true })
+    .line('TG_AUTHORIZED_USER_IDS', String(from?.id ?? 'N/A'))
   if (threadId) {
     builder.line('TG_CONTROL_TOPIC_ID', String(threadId), { code: true })
   }
 
   builder.newline()
-  builder.text('💡 Copy these values to your .env file')
-  builder.newline()
-  builder.newline()
-  builder.text('💡 Tip: In groups, you can also mention the bot with @username to get this info')
+    .text('💡 Copy these values to your .env file')
+    .newline()
+    .newline()
+    .text('💡 Tip: In groups, you can also mention the bot with @username to get this info')
 
   const message = builder.build()
   infoLogger.info(`Replying to user ${userId} with info`)
-  await ctx.reply(message, { parse_mode: builder.getParseMode() })
+  await ctx.reply(message.text || '', { parse_mode: (message.parse_mode || 'HTML') as any })
   infoLogger.success(`Info sent to user ${userId}`)
 }
 

package/templates/telegram-bot/core/src/handlers/logs.ts

@@ -2,7 +2,7 @@ import type { Context, Telegraf } from 'telegraf'
 import { getConfig, hasLoggingConfigured } from '../config/index.js'
 import { streamLogger, botLogger, badge, kv, colors, colorText } from '../middleware/logging.js'
 import { formatLogEntry } from '../utils/formatters.js'
-import { MessageBuilder } from '../utils/message-builder.js'
+import { TelegramMessageBuilder } from '@mks2508/telegram-message-builder'
 
 const LOG_BUFFER_SIZE = 10
 const LOG_BUFFER_TIMEOUT = 5000
@@ -103,9 +103,10 @@ export async function handleLogsCommand(ctx: Context): Promise<void> {
   const config = getConfig()
 
   if (!hasLoggingConfigured()) {
-    const builder = MessageBuilder.markdown()
+    const message = TelegramMessageBuilder.text()
       .text('❌ Logging is not configured. Set TG_LOG_CHAT_ID environment variable.')
-    ctx.reply(builder.build(), { parse_mode: builder.getParseMode() })
+      .build()
+    ctx.reply(message.text || '', { parse_mode: (message.parse_mode || 'HTML') as any })
     return
   }
 
@@ -120,8 +121,8 @@ export async function handleLogsCommand(ctx: Context): Promise<void> {
     })}`
   )
 
-  const builder = MessageBuilder.markdown()
-    .title('📝 Log Streaming Status:')
+  const builder = TelegramMessageBuilder.text()
+    .title('📝 Log Streaming Status')
     .newline()
     .line('Status', status, { code: true })
     .line('Chat ID', String(config.logChatId), { code: true })
@@ -129,5 +130,6 @@ export async function handleLogsCommand(ctx: Context): Promise<void> {
     builder.line('Topic ID', String(config.logTopicId), { code: true })
   }
 
-  ctx.reply(builder.build(), { parse_mode: builder.getParseMode() })
+  const message = builder.build()
+  ctx.reply(message.text || '', { parse_mode: (message.parse_mode || 'HTML') as any })
 }

package/templates/telegram-bot/core/src/index.ts

@@ -10,6 +10,10 @@ import { handleGetInfo } from './handlers/info.js'
 import { handleStop, handleRestart, handleMode, handleWebhook } from './handlers/control.js'
 import { handleLogsCommand, initializeLogStreamer } from './handlers/logs.js'
 import { handleExportConfig } from './handlers/config-export.js'
+import { handleTextDemo } from './handlers/demo-text.js'
+import { handleKeyboardDemo, handleKeyboardCallback } from './handlers/demo-keyboard.js'
+import { handleMediaDemo, handleMediaCallback } from './handlers/demo-media.js'
+import { handleFullDemo, handleFullDemoCallback } from './handlers/demo-full.js'
 import { auth } from './middleware/auth.js'
 import { initializeFileLogging } from './config/logging.js'
 
@@ -75,7 +79,12 @@ async function main(): Promise<void> {
         '/stats - Show statistics\n' +
         '/logs - Check log streaming status\n' +
         '/getinfo - Get your user/chat info for configuration\n' +
-        '/mode - Check or change bot mode',
+        '/mode - Check or change bot mode\n\n' +
+        '*🎨 Demo Commands (telegram-message-builder):*\n' +
+        '/textdemo - Text formatting showcase\n' +
+        '/keybdemo - Keyboard builder showcase\n' +
+        '/mediademo - Media types showcase\n' +
+        '/fulldemo - Complete feature demo',
       { parse_mode: 'Markdown' }
     )
     botManager.incrementMessages()
@@ -137,6 +146,16 @@ async function main(): Promise<void> {
 
   bot.command('logs', handleLogsCommand)
 
+  // Demo commands for telegram-message-builder showcase
+  bot.command('textdemo', handleTextDemo)
+  bot.command('keybdemo', handleKeyboardDemo)
+  bot.command('mediademo', handleMediaDemo)
+  bot.command('fulldemo', handleFullDemo)
+
+  // Callback handlers for demo keyboards
+  bot.action(/^(demo_yes|demo_no|demo_refresh|demo_search|full_demo_keyboard)$/, handleKeyboardCallback)
+  bot.action(/^(media_photo|media_video|media_document|media_audio|media_voice|full_demo_media)$/, handleMediaCallback)
+
   process.once('SIGINT', async () => {
     botLogger.info(`${badge('SHUTDOWN', 'pill')} ${colorText('SIGINT received', colors.warning)}`)
     await instanceManager.releaseLock()

package/templates/telegram-bot/core/src/utils/formatters.ts

@@ -1,13 +1,9 @@
 import { TimeConstants } from '../types/constants.js'
 import type { BotStatus } from '../types/bot.js'
-import { MessageBuilder, fmt, escapeText, type FormatType } from './message-builder.js'
+import { TelegramMessageBuilder, fmt } from '@mks2508/telegram-message-builder'
 
-// Re-export MessageBuilder utilities for convenience
-export { MessageBuilder, fmt, escapeText }
-export type { FormatType }
-
-// Default format mode for the bot (HTML is simpler and more reliable than MarkdownV2)
-export const DEFAULT_FORMAT_MODE: FormatType = 'html'
+// Re-export fmt from telegram-message-builder for convenience
+export { fmt }
 
 /**
  * Format uptime in human-readable format
@@ -45,41 +41,7 @@ export function formatMemory(memoryUsage: {
 }
 
 /**
- * Format health status message using MessageBuilder
- */
-export function formatHealthMessage(status: BotStatus): string {
-  return MessageBuilder.markdown()
-    .title('🏥 Bot Health Status')
-    .newline()
-    .line('Status', status.status.toUpperCase(), { bold: true })
-    .line('Mode', status.mode.toUpperCase())
-    .line('Uptime', formatUptime(status.uptime))
-    .newline()
-    .title('Memory Usage')
-    .text(formatMemory(status.memoryUsage))
-    .build()
-}
-
-/**
- * Format bot statistics using MessageBuilder
- */
-export function formatStats(stats: {
-  messagesProcessed: number
-  commandsExecuted: number
-  errorsEncountered: number
-}): string {
-  return MessageBuilder.markdown()
-    .title('📊 Bot Statistics')
-    .newline()
-    .section('Performance')
-    .line('Messages Processed', String(stats.messagesProcessed))
-    .line('Commands Executed', String(stats.commandsExecuted))
-    .line('Errors Encountered', String(stats.errorsEncountered))
-    .build()
-}
-
-/**
- * Format a log entry message
+ * Format a log entry message for Telegram
  */
 export function formatLogEntry(
   timestamp: string,
@@ -97,22 +59,5 @@ export function formatLogEntry(
 
   const emoji = levelEmoji[level as keyof typeof levelEmoji] || 'ℹ️'
 
-  return MessageBuilder.markdown()
-    .text(`${emoji} [${component}] `)
-    .text(message)
-    .newline()
-    .text(fmt.italic(timestamp))
-    .build()
-}
-
-/**
- * Format error message
- */
-export function formatError(error: Error | string): string {
-  const message = error instanceof Error ? error.message : String(error)
-  return MessageBuilder.markdown()
-    .text('❌ ')
-    .title('Error:')
-    .text(message)
-    .build()
+  return `${emoji} [${component}] ${message}\n${fmt.italic(timestamp)}`
 }

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

@@ -2,6 +2,8 @@
   "extends": "../tsconfig.json",
   "compilerOptions": {
     "rootDir": ".",
+    "outDir": "./dist",
+    "declarationDir": "./dist",
     "types": ["bun-types", "node"]
   },
   "include": ["src/**/*.ts"],

package/templates/telegram-bot/package.json

@@ -5,7 +5,7 @@
   "type": "module",
   "workspaces": [
     "core",
-    "apps/*"
+    "packages/*"
   ],
   "scripts": {
     "dev": "bun run --filter @mks2508/telegram-bot-core dev",
@@ -39,7 +39,8 @@
     "typescript": "^5"
   },
   "dependencies": {
-    "@flla/telegram-format": "^3.1.2",
+    "@mks2508/telegram-message-builder": "0.3.1",
+    "@mks2508/telegram-bot-utils": "workspace:*",
     "@inquirer/prompts": "^8.1.0",
     "chalk": "^5.6.2",
     "commander": "^14.0.2",

package/templates/telegram-bot/packages/utils/package.json

@@ -2,11 +2,22 @@
   "name": "@mks2508/telegram-bot-utils",
   "version": "0.1.0",
   "type": "module",
+  "scripts": {
+    "build": "rolldown --config rolldown.config.ts && tsgo --emitDeclarationOnly",
+    "dev": "bun run --watch src/index.ts",
+    "typecheck": "tsgo --noEmit"
+  },
   "exports": {
-    ".": "./src/index.ts"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
   },
   "dependencies": {
     "@mks2508/better-logger": "^4.0.0",
     "@mks2508/no-throw": "^0.1.0"
+  },
+  "devDependencies": {
+    "rolldown": "^1.0.0-beta.58"
   }
 }

package/templates/telegram-bot/packages/utils/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: ['@mks2508/better-logger', '@mks2508/no-throw'],
+});

package/templates/telegram-bot/packages/utils/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "rootDir": "./src",
+    "outDir": "./dist",
+    "declarationDir": "./dist"
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["node_modules", "dist"]
+}

package/templates/telegram-bot/tsconfig.json

@@ -8,7 +8,7 @@
     "moduleResolution": "bundler",
     "allowImportingTsExtensions": true,
     "verbatimModuleSyntax": true,
-    "noEmit": true,
+    "noEmit": false,
     "strict": true,
     "skipLibCheck": true,
     "noFallthroughCasesInSwitch": true,
@@ -16,7 +16,12 @@
     "noImplicitOverride": true,
     "noUnusedLocals": false,
     "noUnusedParameters": false,
-    "noPropertyAccessFromIndexSignature": false
+    "noPropertyAccessFromIndexSignature": false,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "outDir": "./dist",
+    "declarationDir": "./dist"
   },
   "exclude": ["node_modules", "**/node_modules", "**/dist"]
 }

package/templates/telegram-bot/core/src/utils/message-builder.ts

@@ -1,180 +0,0 @@
-import telegramFormat from '@flla/telegram-format'
-import type { Formatter } from '@flla/telegram-format'
-
-// Get the formatters from the main module
-const { html } = telegramFormat
-
-/**
- * MessageBuilder - Fluent API for building formatted Telegram messages
- *
- * Provides a consistent way to build messages without worrying about:
- * - Proper escaping of special characters
- * - Format consistency (Markdown vs HTML)
- * - Parse errors from malformed entities
- *
- * @example
- * ```typescript
- * const message = MessageBuilder.markdown()
- *   .title('User Information')
- *   .newline()
- *   .line('User ID', '123456', { code: true })
- *   .line('Username', '@john_doe')
- *   .build()
- * ```
- */
-export class MessageBuilder {
-  private parts: string[] = []
-  private listDepth = 0
-
-  private constructor(
-    private formatter: Formatter,
-    private parseModeValue: 'Markdown' | 'HTML' | 'MarkdownV2'
-  ) {}
-
-  /**
-   * Create an HTML message builder (default)
-   * HTML is simpler and more reliable than MarkdownV2
-   */
-  static markdown(): MessageBuilder {
-    return new MessageBuilder(html as unknown as Formatter, 'HTML')
-  }
-
-  /**
-   * Create an HTML message builder
-   */
-  static html(): MessageBuilder {
-    return new MessageBuilder(html as unknown as Formatter, 'HTML')
-  }
-
-  /**
-   * Add a title/heading (bold)
-   */
-  title(text: string): this {
-    this.parts.push(this.formatter.bold(text))
-    return this
-  }
-
-  /**
-   * Add a section heading (underline/italic)
-   */
-  section(text: string): this {
-    this.parts.push(this.formatter.underline(text))
-    return this
-  }
-
-  /**
-   * Add a key-value line
-   * @param key - The label/key
-   * @param value - The value
-   * @param opts - Options for formatting the value
-   */
-  line(key: string, value: string, opts?: { code?: boolean; bold?: boolean }): this {
-    let formattedValue = value
-    if (opts?.code) {
-      formattedValue = this.formatter.monospace(value)
-    } else if (opts?.bold) {
-      formattedValue = this.formatter.bold(value)
-    }
-    this.parts.push(`${key}: ${formattedValue}`)
-    return this
-  }
-
-  /**
-   * Add a code block
-   */
-  codeBlock(text: string, language?: string): this {
-    this.parts.push(this.formatter.monospaceBlock(text, language))
-    return this
-  }
-
-  /**
-   * Add a list item
-   */
-  listItem(text: string, depth: number = 0): this {
-    const indent = '  '.repeat(depth)
-    const bullet = this.listDepth > 0 ? '•' : `${this.listDepth + 1}.`
-    this.parts.push(`${indent}${bullet} ${text}`)
-    return this
-  }
-
-  /**
-   * Add a sublist (increase indentation)
-   */
-  startSublist(): this {
-    this.listDepth++
-    return this
-  }
-
-  /**
-   * End sublist (decrease indentation)
-   */
-  endSublist(): this {
-    if (this.listDepth > 0) this.listDepth--
-    return this
-  }
-
-  /**
-   * Add a newline
-   */
-  newline(): this {
-    this.parts.push('\n')
-    return this
-  }
-
-  /**
-   * Add raw text (escaped, no formatting)
-   */
-  text(text: string): this {
-    this.parts.push(this.formatter.escape(text))
-    return this
-  }
-
-  /**
-   * Add a horizontal rule (separator)
-   */
-  separator(): this {
-    this.parts.push(this.parseModeValue === 'HTML' ? '<hr>' : '---')
-    return this
-  }
-
-  /**
-   * Build the final message string
-   * @returns The formatted message ready to send
-   */
-  build(): string {
-    return this.parts.join('\n').trim()
-  }
-
-  /**
-   * Get the parse_mode for Telegraf
-   * Note: Telegraf accepts 'Markdown' for both Markdown and MarkdownV2
-   */
-  getParseMode(): 'Markdown' | 'HTML' {
-    return this.parseModeValue === 'MarkdownV2' ? 'Markdown' : this.parseModeValue
-  }
-}
-
-/**
- * Quick escape helper for raw text
- */
-export function escapeText(text: string): string {
-  const formatter = html as unknown as Formatter
-  return formatter.escape(text)
-}
-
-/**
- * Format mode type
- */
-export type FormatType = 'html'
-
-/**
- * Quick format helpers
- */
-export const fmt = {
-  bold: (text: string) => (html as unknown as Formatter).bold(text),
-  italic: (text: string) => (html as unknown as Formatter).italic(text),
-  underline: (text: string) => (html as unknown as Formatter).underline(text),
-  code: (text: string) => (html as unknown as Formatter).monospace(text),
-  link: (text: string, url: string) => (html as unknown as Formatter).url(text, url),
-  escape: (text: string) => (html as unknown as Formatter).escape(text),
-}