@goodandready/dsh-messenger-gateway 0.3.21 → 0.4.0

package/lib/alerts.js

@@ -1,64 +1,105 @@
-import { escapeHtml } from './telegram-format.js'
-import { normalizeThreadId } from './topics.js'
-
-export function formatAlertMessage(type, payload = {}) {
-  const timestamp = new Date().toLocaleTimeString()
-
-  if (type === 'pairing') {
-    const { userId, username, code } = payload
-    const userStr = username ? `@${username} (id: <code>${userId}</code>)` : `id: <code>${userId}</code>`
-    return [
-      `🔐 <b>[Pairing Request]</b> <i>(${timestamp})</i>`,
-      '',
-      `User: ${userStr}`,
-      `Pairing Code: <code>${code}</code>`,
-      '',
-      `To approve, send to bot:`,
-      `<code>/pair ${code}</code>`,
-    ].join('\n')
-  }
-
-  if (type === 'error') {
-    const { message, code, sessionId, chatId, threadId } = payload
-    const location = chatId ? `Chat: <code>${chatId}</code>${threadId ? ` / thread <code>${threadId}</code>` : ''}` : ''
-    const sess = sessionId ? `Session: <code>${sessionId}</code>` : ''
-    const meta = [location, sess].filter(Boolean).join('\n')
-
-    return [
-      `🚨 <b>[Gateway Error]</b> <i>(${timestamp})</i>`,
-      meta ? `\n${meta}` : '',
-      `Error code: <b>${escapeHtml(String(code || 'error'))}</b>`,
-      `<code>${escapeHtml(String(message || 'unknown error'))}</code>`,
-    ].filter(Boolean).join('\n')
-  }
-
-  if (type === 'status') {
-    const { title, details } = payload
-    return [
-      `⚡ <b>[Gateway: ${escapeHtml(title || 'Status')}]</b> <i>(${timestamp})</i>`,
-      details ? `\n${escapeHtml(details)}` : '',
-    ].filter(Boolean).join('\n')
-  }
-
-  return `🔔 <b>[Alert: ${type}]</b> <i>(${timestamp})</i>\n${escapeHtml(JSON.stringify(payload))}`
-}
-
-export function resolveAlertTarget(gateway) {
-  const alertsCfg = gateway?.config?.telegram?.alerts
-  if (!alertsCfg || alertsCfg.enabled === false) return null
-
-  // If a named home is specified
-  if (alertsCfg.home) {
-    const home = gateway.resolveHomeTarget('telegram', alertsCfg.home)
-    if (home) return home
-  }
-
-  const chatId = alertsCfg.chatId
-  if (!chatId) return null
-
-  return {
-    platform: 'telegram',
-    chatId,
-    threadId: normalizeThreadId(alertsCfg.threadId),
-  }
+import { escapeHtml } from './telegram-format.js'
+import { normalizeThreadId } from './topics.js'
+import { t } from './locales/index.js'
+
+export function formatAlertMessage(type, payload = {}) {
+  const timestamp = new Date().toLocaleTimeString()
+
+  if (type === 'pairing') {
+    const { userId, username, code } = payload
+    const userStr = username ? `@${username} (id: <code>${userId}</code>)` : `id: <code>${userId}</code>`
+    return [
+      `🔐 <b>[Pairing Request]</b> <i>(${timestamp})</i>`,
+      '',
+      `User: ${userStr}`,
+      `Pairing Code: <code>${code}</code>`,
+      '',
+      `To approve, send to bot:`,
+      `<code>/pair ${code}</code>`,
+    ].join('\n')
+  }
+
+  if (type === 'error') {
+    const { message, code, sessionId, chatId, threadId } = payload
+    const location = chatId ? `Chat: <code>${chatId}</code>${threadId ? ` / thread <code>${threadId}</code>` : ''}` : ''
+    const sess = sessionId ? `Session: <code>${sessionId}</code>` : ''
+    const meta = [location, sess].filter(Boolean).join('\n')
+
+    return [
+      `🚨 <b>[Gateway Error]</b> <i>(${timestamp})</i>`,
+      meta ? `\n${meta}` : '',
+      `Error code: <b>${escapeHtml(String(code || 'error'))}</b>`,
+      `<code>${escapeHtml(String(message || 'unknown error'))}</code>`,
+    ].filter(Boolean).join('\n')
+  }
+
+  if (type === 'status') {
+    const { title, details } = payload
+    return [
+      `⚡ <b>[Gateway: ${escapeHtml(title || 'Status')}]</b> <i>(${timestamp})</i>`,
+      details ? `\n${escapeHtml(details)}` : '',
+    ].filter(Boolean).join('\n')
+  }
+
+  return `🔔 <b>[Alert: ${type}]</b> <i>(${timestamp})</i>\n${escapeHtml(JSON.stringify(payload))}`
+}
+
+export function resolveAlertTarget(gateway) {
+  const alertsCfg = gateway?.config?.telegram?.alerts
+  if (!alertsCfg || alertsCfg.enabled === false) return null
+
+  // If a named home is specified
+  if (alertsCfg.home) {
+    const home = gateway.resolveHomeTarget('telegram', alertsCfg.home)
+    if (home) return home
+  }
+
+  const chatId = alertsCfg.chatId
+  if (!chatId) return null
+
+  return {
+    platform: 'telegram',
+    chatId,
+    threadId: normalizeThreadId(alertsCfg.threadId),
+  }
+}
+
+export async function handleSetAlertCommand(gw, input, locale) {
+  const { reply, userId, chatId, threadId = 0 } = input
+  if (!gw.isUserAllowed(userId)) return reply(t('msg.not_allowed', {}, locale))
+  const nextTg = {
+    ...gw.tg(),
+    alerts: {
+      ...(gw.tg().alerts || {}),
+      enabled: true,
+      chatId,
+      threadId: threadId || 0,
+    },
+  }
+  gw.config.telegram = nextTg
+  try { await gw.hooks?.persistHomes?.(nextTg) } catch (err) { gw.logger?.warn?.('persistHomes error:', err?.message || err) }
+  return reply(`🔔 This chat assigned as alert channel (chat: ${chatId}${threadId ? `, topic: ${threadId}` : ''}).`)
+}
+
+export async function handleAlertCommand(gw, input, parts) {
+  const { reply, userId } = input
+  const sub = parts[1]?.toLowerCase()
+  if (sub === 'test') {
+    const target = resolveAlertTarget(gw)
+    if (!target) return reply('Alert channel not configured. Configure: /setalert')
+    await gw.sendAlert('status', { title: 'Test Alert', details: `Sent by user ID ${userId}` })
+    return reply('Test alert sent to alert channel.')
+  }
+  const target = resolveAlertTarget(gw)
+  const alertsCfg = gw.tg().alerts || {}
+  return reply([
+    '🔔 <b>Alert Channel:</b>',
+    `Status: ${alertsCfg.enabled ? 'enabled' : 'disabled'}`,
+    `Chat: ${target ? `${target.chatId}${target.threadId ? ` (topic: ${target.threadId})` : ''}` : '(not assigned)'}`,
+    `Events: ${(alertsCfg.events || ['error', 'pairing']).join(', ')}`,
+    '',
+    'Commands:',
+    '/setalert — assign current chat as alert channel',
+    '/alert test — send test alert',
+  ].join('\n'))
 }

package/lib/api-health.js

@@ -0,0 +1,38 @@
+export class ApiHealthTracker {
+  constructor(options = {}) {
+    this.logger = options.logger || console
+    this.degradedThreshold = Number(options.degradedThreshold) || 3
+    this.warnThreshold = Number(options.warnThreshold) || 5
+    this.consecutiveFailures = 0
+    this.lastError = null
+  }
+
+  recordFailure(op, err) {
+    this.consecutiveFailures++
+    this.lastError = {
+      op,
+      message: err?.message || String(err),
+      time: Date.now(),
+    }
+    this.logger?.debug?.(`dsh-messenger-gateway: Telegram API ${op} failed (${this.consecutiveFailures} consecutive):`, err?.message || err)
+    if (this.consecutiveFailures >= this.warnThreshold && this.consecutiveFailures % this.warnThreshold === 0) {
+      this.logger?.warn?.(`dsh-messenger-gateway: Telegram API experiencing repeated failures (${this.consecutiveFailures} in a row). Last op: ${op}, error: ${err?.message || err}`)
+    }
+  }
+
+  recordSuccess() {
+    this.consecutiveFailures = 0
+  }
+
+  isDegraded() {
+    return this.consecutiveFailures >= this.degradedThreshold
+  }
+
+  getSnapshot() {
+    return {
+      degraded: this.isDegraded(),
+      consecutiveFailures: this.consecutiveFailures,
+      lastError: this.lastError,
+    }
+  }
+}

package/lib/artifacts.js

@@ -1,118 +1,118 @@
-export function extractMermaidDiagrams(text) {
-  if (!text || typeof text !== 'string') return []
-  const regex = /```mermaid\s*\n([\s\S]*?)```/gi
-  const diagrams = []
-  let match
-  while ((match = regex.exec(text)) !== null) {
-    diagrams.push({
-      fullMatch: match[0],
-      code: match[1].trim(),
-      index: match.index,
-    })
-  }
-  return diagrams
-}
-
-export function escapeSvgXml(str = '') {
-  return String(str)
-    .replace(/&/g, '&')
-    .replace(/</g, '&lt;')
-    .replace(/>/g, '&gt;')
-    .replace(/"/g, '&quot;')
-    .replace(/'/g, '&apos;')
-}
-
-export function generateDiagramSvg(code, title = 'Mermaid Diagram') {
-  const lines = code.split('\n').slice(0, 30)
-  const lineSpans = lines.map((line, i) => {
-    const escaped = escapeSvgXml(line)
-    return `<tspan x="24" dy="${i === 0 ? '0' : '1.4em'}">${escaped}</tspan>`
-  }).join('')
-
-  const height = Math.max(160, Math.min(800, lines.length * 24 + 100))
-  const safeTitle = escapeSvgXml(title)
-
-  return `<?xml version="1.0" encoding="UTF-8"?>
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 800 ${height}" width="800" height="${height}">
-  <defs>
-    <linearGradient id="bg" x1="0%" y1="0%" x2="100%" y2="100%">
-      <stop offset="0%" stop-color="#1e1e2e"/>
-      <stop offset="100%" stop-color="#181825"/>
-    </linearGradient>
-  </defs>
-  <rect width="100%" height="100%" rx="12" fill="url(#bg)" stroke="#313244" stroke-width="2"/>
-  <circle cx="28" cy="28" r="6" fill="#f38ba8" />
-  <circle cx="48" cy="28" r="6" fill="#f9e2af" />
-  <circle cx="68" cy="28" r="6" fill="#a6e3a1" />
-  <text x="96" y="32" fill="#cdd6f4" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, monospace" font-size="14" font-weight="600">${safeTitle}</text>
-  <line x1="16" y1="48" x2="784" y2="48" stroke="#313244" stroke-width="1"/>
-  <text x="24" y="76" fill="#a6adc8" font-family="'JetBrains Mono', 'Fira Code', monospace" font-size="13" xml:space="preserve">
-    ${lineSpans}
-  </text>
-</svg>`
-}
-
-export function formatMarkdownTables(text) {
-  if (!text || typeof text !== 'string') return text
-  const tableRegex = /((?:^|\n)\|[^\n]+\|\n\|[\s\-:|]+\|\n(?:\|[^\n]+\|\n?)+)/g
-
-  return text.replace(tableRegex, (match) => {
-    const rawLines = match.trim().split('\n')
-    if (rawLines.length < 3) return match
-
-    const rows = rawLines.map((line) => {
-      const cells = line.split('|').slice(1, -1).map((c) => c.trim())
-      return cells
-    })
-
-    const colCount = Math.max(...rows.map((r) => r.length))
-    const colWidths = Array(colCount).fill(0)
-
-    rows.forEach((row, rowIdx) => {
-      if (rowIdx === 1) return
-      row.forEach((cell, colIdx) => {
-        colWidths[colIdx] = Math.max(colWidths[colIdx] || 0, cell.length)
-      })
-    })
-
-    const formattedRows = rows.map((row, rowIdx) => {
-      if (rowIdx === 1) {
-        return colWidths.map((w) => '-'.repeat(Math.max(w, 3))).join(' | ')
-      }
-      return row.map((cell, colIdx) => cell.padEnd(colWidths[colIdx] || 3)).join(' | ')
-    })
-
-    const alignedTable = formattedRows.join('\n')
-    return `\n\`\`\`\n${alignedTable}\n\`\`\`\n`
-  })
-}
-
-export function processDiagramsAndTables(rawText, options = {}) {
-  const { artifactPreviews = true } = options
-  let text = String(rawText || '')
-  const files = []
-
-  if (artifactPreviews) {
-    const diagrams = extractMermaidDiagrams(text)
-    if (diagrams.length > 0) {
-      let diagramIndex = 1
-      for (const diag of diagrams) {
-        const svgContent = generateDiagramSvg(diag.code, `Diagram ${diagramIndex}`)
-        const base64 = Buffer.from(svgContent, 'utf-8').toString('base64')
-        files.push({
-          name: `diagram-${diagramIndex}.svg`,
-          mime: 'image/svg+xml',
-          kind: 'document',
-          dataBase64: base64,
-          bytes: Buffer.from(svgContent, 'utf-8'),
-        })
-
-        text = text.replace(diag.fullMatch, `\n📊 <b>[Diagram ${diagramIndex}: see attachment]</b>\n`)
-        diagramIndex++
-      }
-    }
-    text = formatMarkdownTables(text)
-  }
-
-  return { text, files, diagramsCount: files.length }
-}
+export function extractMermaidDiagrams(text) {
+  if (!text || typeof text !== 'string') return []
+  const regex = /```mermaid\s*\n([\s\S]*?)```/gi
+  const diagrams = []
+  let match
+  while ((match = regex.exec(text)) !== null) {
+    diagrams.push({
+      fullMatch: match[0],
+      code: match[1].trim(),
+      index: match.index,
+    })
+  }
+  return diagrams
+}
+
+export function escapeSvgXml(str = '') {
+  return String(str)
+    .replace(/&/g, '&amp;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;')
+    .replace(/'/g, '&apos;')
+}
+
+export function generateDiagramSvg(code, title = 'Mermaid Diagram') {
+  const lines = code.split('\n').slice(0, 30)
+  const lineSpans = lines.map((line, i) => {
+    const escaped = escapeSvgXml(line)
+    return `<tspan x="24" dy="${i === 0 ? '0' : '1.4em'}">${escaped}</tspan>`
+  }).join('')
+
+  const height = Math.max(160, Math.min(800, lines.length * 24 + 100))
+  const safeTitle = escapeSvgXml(title)
+
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 800 ${height}" width="800" height="${height}">
+  <defs>
+    <linearGradient id="bg" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#1e1e2e"/>
+      <stop offset="100%" stop-color="#181825"/>
+    </linearGradient>
+  </defs>
+  <rect width="100%" height="100%" rx="12" fill="url(#bg)" stroke="#313244" stroke-width="2"/>
+  <circle cx="28" cy="28" r="6" fill="#f38ba8" />
+  <circle cx="48" cy="28" r="6" fill="#f9e2af" />
+  <circle cx="68" cy="28" r="6" fill="#a6e3a1" />
+  <text x="96" y="32" fill="#cdd6f4" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, monospace" font-size="14" font-weight="600">${safeTitle}</text>
+  <line x1="16" y1="48" x2="784" y2="48" stroke="#313244" stroke-width="1"/>
+  <text x="24" y="76" fill="#a6adc8" font-family="'JetBrains Mono', 'Fira Code', monospace" font-size="13" xml:space="preserve">
+    ${lineSpans}
+  </text>
+</svg>`
+}
+
+export function formatMarkdownTables(text) {
+  if (!text || typeof text !== 'string') return text
+  const tableRegex = /((?:^|\n)\|[^\n]+\|\n\|[\s\-:|]+\|\n(?:\|[^\n]+\|\n?)+)/g
+
+  return text.replace(tableRegex, (match) => {
+    const rawLines = match.trim().split('\n')
+    if (rawLines.length < 3) return match
+
+    const rows = rawLines.map((line) => {
+      const cells = line.split('|').slice(1, -1).map((c) => c.trim())
+      return cells
+    })
+
+    const colCount = Math.max(...rows.map((r) => r.length))
+    const colWidths = Array(colCount).fill(0)
+
+    rows.forEach((row, rowIdx) => {
+      if (rowIdx === 1) return
+      row.forEach((cell, colIdx) => {
+        colWidths[colIdx] = Math.max(colWidths[colIdx] || 0, cell.length)
+      })
+    })
+
+    const formattedRows = rows.map((row, rowIdx) => {
+      if (rowIdx === 1) {
+        return colWidths.map((w) => '-'.repeat(Math.max(w, 3))).join(' | ')
+      }
+      return row.map((cell, colIdx) => cell.padEnd(colWidths[colIdx] || 3)).join(' | ')
+    })
+
+    const alignedTable = formattedRows.join('\n')
+    return `\n\`\`\`\n${alignedTable}\n\`\`\`\n`
+  })
+}
+
+export function processDiagramsAndTables(rawText, options = {}) {
+  const { artifactPreviews = true } = options
+  let text = String(rawText || '')
+  const files = []
+
+  if (artifactPreviews) {
+    const diagrams = extractMermaidDiagrams(text)
+    if (diagrams.length > 0) {
+      let diagramIndex = 1
+      for (const diag of diagrams) {
+        const svgContent = generateDiagramSvg(diag.code, `Diagram ${diagramIndex}`)
+        const base64 = Buffer.from(svgContent, 'utf-8').toString('base64')
+        files.push({
+          name: `diagram-${diagramIndex}.svg`,
+          mime: 'image/svg+xml',
+          kind: 'document',
+          dataBase64: base64,
+          bytes: Buffer.from(svgContent, 'utf-8'),
+        })
+
+        text = text.replace(diag.fullMatch, `\n📊 <b>[Diagram ${diagramIndex}: see attachment]</b>\n`)
+        diagramIndex++
+      }
+    }
+    text = formatMarkdownTables(text)
+  }
+
+  return { text, files, diagramsCount: files.length }
+}