@goodandready/dsh-tts 0.4.28 → 0.4.30

package/lib/client.js

@@ -51,6 +51,31 @@ window.__ModuleLoader__.load({
     }
 
 
+        function clientFetch(url, options) {
+      const opts = options || {}
+      const timeoutMs = Number(opts.timeoutMs) > 0 ? Number(opts.timeoutMs) : 15000
+      const controller = new AbortController()
+      const timer = setTimeout(() => controller.abort(), timeoutMs)
+
+      if (opts.signal) {
+        if (opts.signal.aborted) controller.abort()
+        else opts.signal.addEventListener('abort', () => controller.abort(), { once: true })
+      }
+
+      const fetchOpts = Object.assign({}, opts, { signal: controller.signal })
+      delete fetchOpts.timeoutMs
+
+      return fetch(url, fetchOpts).finally(() => clearTimeout(timer))
+    }
+
+    function getModelHint(provider, t) {
+      if (typeof t === 'function') {
+        const loc = t('modelHint_' + provider)
+        if (loc && !loc.startsWith('modelHint_')) return loc
+      }
+      return MODEL_HINT[provider] || ''
+    }
+
     function createErrorBoundary() {
       if (!React || typeof React.Component !== 'function') {
         return function NoopBoundary(props) { return (props && props.children) || null }
@@ -74,7 +99,7 @@ window.__ModuleLoader__.load({
                 className: 'dts-alert dts-alert-err',
                 style: { margin: '12px 0', padding: '14px', borderRadius: '8px' },
               },
-              React.createElement('div', { style: { fontWeight: 600, marginBottom: '6px' } }, '⚠️ TTS UI Error:'),
+              React.createElement('div', { style: { fontWeight: 600, marginBottom: '6px' } }, (typeof fallbackDockText === 'function' ? fallbackDockText('ttsUiError') : '⚠️ TTS UI Error:')),
               React.createElement('div', { style: { fontSize: '12px', wordBreak: 'break-all' } }, String((this.state.error && this.state.error.message) || this.state.error)),
               React.createElement(
                 'button',
@@ -114,12 +139,12 @@ window.__ModuleLoader__.load({
       '.dts-body{border-top:1px solid var(--dsw-alias-border-l2);margin:0 16px;padding:12px 0}' +
       '.dts-field{display:flex;flex-direction:column;gap:6px;padding:6px 0;font-size:13px;color:var(--dsw-alias-label-primary)}' +
       '.dts-input{height:34px;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-primary);border-radius:8px;padding:0 10px;font-size:13px;box-sizing:border-box}' +
-      '.dts-input:focus{outline:none;border-color:var(--dsw-alias-state-brand-primary)}' +
+      '.dts-input:focus{outline:none;border-color:var(--dsw-alias-brand-primary, #6366f1)}' +
       '.dts-foot{border-top:1px solid var(--dsw-alias-border-l2);display:flex;justify-content:flex-end;align-items:center;gap:10px;padding:14px 0 4px}' +
       '.dts-save{appearance:none;font:inherit;cursor:pointer;border:1px solid transparent;border-radius:8px;padding:6px 16px;font-size:13px;font-weight:500;background:var(--dsw-alias-label-primary);color:var(--dsw-alias-bg-layer-3);transition:all .15s ease}' +
       '.dts-save:hover:not(:disabled){opacity:0.88}' +
       '.dts-btn{appearance:none;font:inherit;cursor:pointer;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;padding:6px 12px;font-size:13px;background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-primary);font-weight:500;display:inline-flex;align-items:center;justify-content:center;gap:6px;transition:all .15s ease}' +
-      '.dts-btn:hover:not(:disabled){background:var(--dsw-alias-bg-layer-4, var(--dsw-alias-bg-layer-2));border-color:var(--dsw-alias-label-dimmed, var(--dsw-alias-border-l2))}' +
+      '.dts-btn:hover:not(:disabled){background:var(--dsw-alias-bg-layer-3, var(--dsw-alias-bg-layer-2));border-color:var(--dsw-alias-label-dimmed, var(--dsw-alias-border-l2))}' +
       '.dts-btn-danger{color:var(--dsw-alias-state-error-primary);border-color:color-mix(in srgb, var(--dsw-alias-state-error-primary) 30%, transparent)}' +
       '.dts-btn-danger:hover:not(:disabled){background:color-mix(in srgb, var(--dsw-alias-state-error-primary) 12%, transparent);border-color:color-mix(in srgb, var(--dsw-alias-state-error-primary) 50%, transparent)}' +
       '.dts-entry{display:flex;flex-direction:column;gap:8px;padding:12px;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;background:var(--dsw-alias-bg-layer-2)}' +
@@ -127,18 +152,18 @@ window.__ModuleLoader__.load({
       '.dts-row .dts-model{flex:1;min-width:120px}' +
       '.dts-row .dts-key{flex:1;min-width:180px}' +
       '.dts-mini{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-primary);border-radius:6px;width:28px;height:28px;cursor:pointer;flex:none;display:inline-flex;align-items:center;justify-content:center;font-size:13px;transition:all .15s ease}' +
-      '.dts-mini:hover:not(:disabled){background:var(--dsw-alias-bg-layer-4, var(--dsw-alias-bg-layer-2))}' +
+      '.dts-mini:hover:not(:disabled){background:var(--dsw-alias-bg-layer-3, var(--dsw-alias-bg-layer-2))}' +
       '.dts-ok{font-size:12px;color:var(--dsw-alias-state-success-primary);font-weight:500}' +
       '.dts-bad{font-size:12px;color:var(--dsw-alias-state-error-primary);font-weight:500}' +
       '.dts-badge{font-size:11px;padding:3px 8px;border-radius:999px;border:1px solid var(--dsw-alias-border-l2);color:var(--dsw-alias-label-secondary);white-space:nowrap;display:inline-flex;align-items:center;gap:4px;font-weight:500}' +
       '.dts-badge-on{color:var(--dsw-alias-state-success-primary);border-color:var(--dsw-alias-state-success-primary);background:color-mix(in srgb, var(--dsw-alias-state-success-primary) 8%, transparent)}' +
-      '.dts-badge-warn{color:var(--dsw-alias-state-warning-primary);border-color:var(--dsw-alias-state-warning-primary);background:color-mix(in srgb, var(--dsw-alias-state-warning-primary) 8%, transparent)}' +
+      '.dts-badge-warn{color:var(--dsw-alias-state-warn-primary, #f59e0b);border-color:var(--dsw-alias-state-warn-primary, #f59e0b);background:color-mix(in srgb, var(--dsw-alias-state-warn-primary, #f59e0b) 8%, transparent)}' +
       '.dts-badge-bad{color:var(--dsw-alias-state-error-primary);border-color:var(--dsw-alias-state-error-primary);background:color-mix(in srgb, var(--dsw-alias-state-error-primary) 8%, transparent)}' +
       '.dts-link{background:none;border:none;color:var(--dsw-alias-label-secondary);cursor:pointer;font-size:12px;padding:0;text-decoration:underline}' +
       '.dts-link:hover:not(:disabled){color:var(--dsw-alias-label-primary)}' +
       '.dts-alert{padding:10px 14px;border-radius:8px;font-size:13px}' +
       '.dts-alert-err{background:color-mix(in srgb, var(--dsw-alias-state-error-primary) 10%, transparent);color:var(--dsw-alias-state-error-primary);border:1px solid color-mix(in srgb, var(--dsw-alias-state-error-primary) 20%, transparent)}' +
-      '.dts-alert-warn{background:color-mix(in srgb, var(--dsw-alias-state-warning-primary) 10%, transparent);color:var(--dsw-alias-state-warning-primary);border:1px solid color-mix(in srgb, var(--dsw-alias-state-warning-primary) 20%, transparent)}' +
+      '.dts-alert-warn{background:color-mix(in srgb, var(--dsw-alias-state-warn-primary, #f59e0b) 10%, transparent);color:var(--dsw-alias-state-warn-primary, #f59e0b);border:1px solid color-mix(in srgb, var(--dsw-alias-state-warn-primary, #f59e0b) 20%, transparent)}' +
       '.dts-alert-ok{background:color-mix(in srgb, var(--dsw-alias-state-success-primary) 10%, transparent);color:var(--dsw-alias-state-success-primary);border:1px solid color-mix(in srgb, var(--dsw-alias-state-success-primary) 20%, transparent)}' +
       '.dts-grow{flex:1;min-width:100px}'
 
@@ -165,7 +190,16 @@ window.__ModuleLoader__.load({
       }
     }
 
+        let clearGestureListeners = null
+    function removeGestureListeners() {
+      if (typeof clearGestureListeners === 'function') {
+        clearGestureListeners()
+        clearGestureListeners = null
+      }
+    }
+
     function unlockAudio() {
+      removeGestureListeners()
       try {
         const AC = window.AudioContext || window.webkitAudioContext
         if (AC) {
@@ -330,16 +364,21 @@ window.__ModuleLoader__.load({
               player.busy = false
               playerChanged()
               if (typeof window !== 'undefined') {
+                removeGestureListeners()
                 const onUserGesture = () => {
-                  window.removeEventListener('click', onUserGesture)
-                  window.removeEventListener('keydown', onUserGesture)
-                  window.removeEventListener('touchstart', onUserGesture)
+                  removeGestureListeners()
                   unlockAudio()
                 }
                 window.addEventListener('click', onUserGesture, { once: true })
                 window.addEventListener('keydown', onUserGesture, { once: true })
                 window.addEventListener('touchstart', onUserGesture, { once: true })
+                clearGestureListeners = () => {
+                  window.removeEventListener('click', onUserGesture)
+                  window.removeEventListener('keydown', onUserGesture)
+                  window.removeEventListener('touchstart', onUserGesture)
+                }
               }
+              resolve()
               return
             }
             done()
@@ -370,6 +409,9 @@ window.__ModuleLoader__.load({
     }
 
     function stopPlayback() {
+      removeGestureListeners()
+      player.blocked = false
+      setAutoplayBlocked(false)
       for (const item of player.queue) {
         if (item && item.prepared && item.prepared.url) {
           try { URL.revokeObjectURL(item.prepared.url) } catch { /* already revoked */ }
@@ -402,16 +444,22 @@ window.__ModuleLoader__.load({
     }
 
     function skipCurrent() {
+      try {
+        if (typeof window !== 'undefined' && window.speechSynthesis) {
+          window.speechSynthesis.cancel()
+        }
+      } catch (_err) { /* no speechSynthesis */ }
       if (player.audio) {
         try {
           player.audio.pause()
           player.audio.currentTime = 0
-        } catch { /* ignore pause error */ }
+        } catch (_err) { /* ignore pause error */ }
       }
       if (currentAudioResolve) {
         currentAudioResolve()
       } else {
         player.audio = null
+        player.busy = false
         playerChanged()
         if (player.queue.length) drainQueue()
       }
@@ -469,13 +517,13 @@ window.__ModuleLoader__.load({
           if (player.enabled === false) return
           player.queue.push(item)
           drainQueue()
-        } catch {}
+        } catch (_err) { /* ignore malformed chime payload */ }
       }
 
       const connect = () => {
         if (sseDisposed) return
         if (activeSse) {
-          try { activeSse.close() } catch {}
+          try { activeSse.close() } catch (_err) { /* active sse already closed */ }
           activeSse = null
         }
         try {
@@ -486,7 +534,7 @@ window.__ModuleLoader__.load({
           es.addEventListener('chime', onChime)
           es.onerror = () => {
             if (activeSse === es) {
-              try { es.close() } catch {}
+              try { es.close() } catch (_err) { /* eventsource already closed */ }
               activeSse = null
             }
             if (sseDisposed) return
@@ -504,7 +552,7 @@ window.__ModuleLoader__.load({
         sseDisposed = true
         if (activeSseTimer) clearTimeout(activeSseTimer)
         if (activeSse) {
-          try { activeSse.close() } catch {}
+          try { activeSse.close() } catch (_err) { /* active sse already closed on dispose */ }
           activeSse = null
         }
       }
@@ -512,7 +560,7 @@ window.__ModuleLoader__.load({
 
     async function pollPending() {
       try {
-        const st = await fetch('/dsh-tts/status', { cache: 'no-store' })
+        const st = await clientFetch('/dsh-tts/status', { cache: 'no-store', timeoutMs: 8000 })
         if (!st.ok) return
         const meta = await st.json()
         player.enabled = !!(meta && meta.speakReplies)
@@ -521,7 +569,7 @@ window.__ModuleLoader__.load({
         if (meta && meta.roles) player.roles = meta.roles
         if (meta && typeof meta.bargeIn === 'boolean') player.bargeIn = meta.bargeIn
         if (!player.enabled) return
-        const res = await fetch('/dsh-tts/pending?after=' + encodeURIComponent(player.after || ''), { cache: 'no-store' })
+        const res = await clientFetch('/dsh-tts/pending?after=' + encodeURIComponent(player.after || ''), { cache: 'no-store', timeoutMs: 8000 })
         if (!res.ok) return
         const data = await res.json()
         const items = data && Array.isArray(data.items) ? data.items : []
@@ -577,10 +625,11 @@ window.__ModuleLoader__.load({
     function playStandalone(text) {
       if (!text) return
       stopPlayback()
-      fetch('/dsh-tts/speak', {
+      clientFetch('/dsh-tts/speak', {
         method: 'POST',
         headers: { 'Content-Type': 'application/json' },
         body: JSON.stringify({ text }),
+        timeoutMs: 15000,
       })
         .then((r) => r.json())
         .then((d) => {
@@ -592,15 +641,18 @@ window.__ModuleLoader__.load({
             audioBase64: d.audioBase64,
           })
         })
-        .catch(() => {})
+        .catch((err) => {
+          console.warn('[dsh-tts] playStandalone fetch failed:', err)
+        })
     }
 
     function previewSpeech(provider, model, voice, text) {
       stopPlayback()
-      return fetch('/dsh-tts/preview', {
+      return clientFetch('/dsh-tts/preview', {
         method: 'POST',
         headers: { 'Content-Type': 'application/json' },
         body: JSON.stringify({ provider, model, voice, text }),
+        timeoutMs: 15000,
       })
         .then((r) => r.json())
         .then((d) => {
@@ -626,10 +678,11 @@ window.__ModuleLoader__.load({
         if (list && list.items && list.items.length) phrase = list.items[0]
       }
       if (!phrase) return
-      fetch('/dsh-tts/speak', {
+      clientFetch('/dsh-tts/speak', {
         method: 'POST',
         headers: { 'Content-Type': 'application/json' },
         body: JSON.stringify({ text: phrase }),
+        timeoutMs: 15000,
       })
         .then((r) => r.json())
         .then((d) => {
@@ -655,6 +708,25 @@ window.__ModuleLoader__.load({
       return (map && map[provider]) || { configured: false, writable: true, ref: '' }
     }
     const en = {
+      'ttsUiError': '⚠️ TTS UI Error:',
+      'modelHint_openai': 'provider default',
+      'modelHint_elevenlabs': 'provider default',
+      'modelHint_google': 'provider default',
+      'modelHint_azure': 'region voice name',
+      'modelHint_groq': 'provider default',
+      'modelHint_deepgram': 'provider default (English-only voices)',
+      'modelHint_openrouter': 'provider/model id',
+      'modelHint_siliconflow': 'model id (e.g. FunAudioLLM/CosyVoice2-0.5B)',
+      'modelHint_deepinfra': 'model id (e.g. hexgrad/Kokoro-82M)',
+      'modelHint_fireworks': 'model id (e.g. kokoro)',
+      'modelHint_mimo': 'model id (e.g. mimo-v2.5-tts)',
+      'modelHint_custom': 'custom model',
+      'modelHint_minimax': 'model id',
+      'modelHint_edge': 'BCP-47 voice, e.g. en-US-AriaNeural',
+      'modelHint_piper': 'path to .onnx',
+      'modelHint_espeak': 'language code, e.g. en',
+      'modelHint_kokoro': 'not bundled — offline neural runtime unavailable',
+      'modelHint_f5': 'not bundled — offline neural runtime unavailable',
       'dockLabel': 'Speech',
       'dockPause': 'Pause',
       'dockResume': 'Resume speech',
@@ -862,6 +934,25 @@ window.__ModuleLoader__.load({
     }
 
     const zh = {
+      'ttsUiError': '⚠️ TTS 界面错误：',
+      'modelHint_openai': '服务商默认',
+      'modelHint_elevenlabs': '服务商默认',
+      'modelHint_google': '服务商默认',
+      'modelHint_azure': '区域语音名称',
+      'modelHint_groq': '服务商默认',
+      'modelHint_deepgram': '服务商默认 (仅英语语音)',
+      'modelHint_openrouter': '服务商/模型 ID',
+      'modelHint_siliconflow': '模型 ID (如 FunAudioLLM/CosyVoice2-0.5B)',
+      'modelHint_deepinfra': '模型 ID (如 hexgrad/Kokoro-82M)',
+      'modelHint_fireworks': '模型 ID (如 kokoro)',
+      'modelHint_mimo': '模型 ID (如 mimo-v2.5-tts)',
+      'modelHint_custom': '自定义模型',
+      'modelHint_minimax': '模型 ID',
+      'modelHint_edge': 'BCP-47 语音名称，如 en-US-AriaNeural',
+      'modelHint_piper': '.onnx 模型文件路径',
+      'modelHint_espeak': '语言代码，如 en',
+      'modelHint_kokoro': '未内置 — 离线神经语音运行时不可用',
+      'modelHint_f5': '未内置 — 离线神经语音运行时不可用',
       'dockLabel': '语音朗读',
       'dockPause': '暂停朗读',
       'dockResume': '继续朗读',
@@ -1100,7 +1191,7 @@ window.__ModuleLoader__.load({
               }, PROVIDERS.map((p) => React.createElement('option', { key: p, value: p }, p))),
               React.createElement('input', {
                 className: 'dts-model dts-input', value: row.model || '', disabled: !props.writable,
-                placeholder: MODEL_HINT[row.provider] || '', onChange: (e) => change(i, { model: e.target.value }),
+                placeholder: (typeof getModelHint === 'function' ? getModelHint(row.provider, t) : (MODEL_HINT[row.provider] || '')), onChange: (e) => change(i, { model: e.target.value }),
               }),
               React.createElement('input', {
                 className: 'dts-model dts-input', value: row.voice || '', disabled: !props.writable,
@@ -1150,8 +1241,8 @@ window.__ModuleLoader__.load({
       const [models, setModels] = React.useState({})
 
       const loadStatus = React.useCallback(() => {
-        if (typeof fetch === 'undefined') return
-        fetch('/dsh-tts/models/status')
+        if (typeof clientFetch === 'undefined' && typeof fetch === 'undefined') return
+        clientFetch('/dsh-tts/models/status', { timeoutMs: 8000 })
           .then((r) => r.json())
           .then((d) => { if (d && d.ok && d.models) setModels(d.models) })
           .catch(() => {}) // status poll best-effort
@@ -1167,11 +1258,14 @@ window.__ModuleLoader__.load({
         if (typeof window !== 'undefined' && window.confirm) {
           if (!window.confirm(t('confirmDeleteModel'))) return
         }
-        fetch('/dsh-tts/models/delete', {
+        clientFetch('/dsh-tts/models/delete', {
           method: 'DELETE',
           headers: { 'content-type': 'application/json' },
           body: JSON.stringify({ engine }),
-        }).then(() => loadStatus()).catch(() => {})
+          timeoutMs: 10000,
+        }).then(() => loadStatus()).catch((err) => {
+          console.warn('[dsh-tts] model delete failed:', err)
+        })
       }
 
       const kokoro = models.kokoro || { installed: false, downloading: false, progress: 0 }
@@ -1411,7 +1505,7 @@ window.__ModuleLoader__.load({
           style: {
             padding: '10px 14px',
             borderRadius: '8px',
-            border: '1px solid var(--dsw-alias-state-warning-primary)',
+            border: '1px solid var(--dsw-alias-state-warn-primary, #f59e0b)',
             background: 'var(--dsw-alias-bg-layer-2)',
             display: 'flex',
             flexDirection: 'column',
@@ -1419,7 +1513,7 @@ window.__ModuleLoader__.load({
             fontSize: '13px',
           },
         },
-          React.createElement('span', { style: { fontWeight: 600, color: 'var(--dsw-alias-state-warning-primary)' } },
+          React.createElement('span', { style: { fontWeight: 600, color: 'var(--dsw-alias-state-warn-primary, #f59e0b)' } },
             '⚠️ ' + t('voiceNotInstalledTitle')
           ),
           React.createElement('span', { className: 'dts-sub' },
@@ -1453,7 +1547,7 @@ window.__ModuleLoader__.load({
           style: {
             padding: '10px 14px',
             borderRadius: '8px',
-            border: '1px solid var(--dsw-alias-state-warning-primary)',
+            border: '1px solid var(--dsw-alias-state-warn-primary, #f59e0b)',
             background: 'var(--dsw-alias-bg-layer-2)',
             display: 'flex',
             flexDirection: 'column',
@@ -1461,7 +1555,7 @@ window.__ModuleLoader__.load({
             fontSize: '13px',
           },
         },
-          React.createElement('span', { style: { fontWeight: 600, color: 'var(--dsw-alias-state-warning-primary)' } },
+          React.createElement('span', { style: { fontWeight: 600, color: 'var(--dsw-alias-state-warn-primary, #f59e0b)' } },
             '⚠️ ' + t('messengerNotInstalledTitle')
           ),
           React.createElement('span', { className: 'dts-sub' },
@@ -1496,8 +1590,9 @@ window.__ModuleLoader__.load({
         setLoading(true)
         setMsg(null)
         try {
-          const res = await fetch('/api/dsh-tts/update', {
+          const res = await clientFetch('/api/dsh-tts/update', {
             headers: { 'x-dsh-plugin-update': '1' },
+            timeoutMs: 10000,
           })
           if (!res.ok) throw new Error('HTTP ' + res.status)
           const data = await res.json()
@@ -1513,12 +1608,13 @@ window.__ModuleLoader__.load({
         setUpdating(true)
         setMsg(null)
         try {
-          const res = await fetch('/api/dsh-tts/update', {
+          const res = await clientFetch('/api/dsh-tts/update', {
             method: 'POST',
             headers: {
               'x-dsh-plugin-update': '1',
               'content-type': 'application/json',
             },
+            timeoutMs: 60000,
           })
           const data = await res.json()
           if (!res.ok) throw new Error((data && (data.error || data.message)) || 'HTTP ' + res.status)
@@ -1562,7 +1658,7 @@ window.__ModuleLoader__.load({
                   {
                     type: 'button',
                     className: 'dts-btn',
-                    style: { borderColor: 'var(--dsw-alias-state-warning-primary)', color: 'var(--dsw-alias-state-warning-primary)' },
+                    style: { borderColor: 'var(--dsw-alias-state-warn-primary, #f59e0b)', color: 'var(--dsw-alias-state-warn-primary, #f59e0b)' },
                     onClick: onUpdateNow,
                     disabled: updating || loading,
                   },
@@ -1592,11 +1688,11 @@ window.__ModuleLoader__.load({
       const t = props.t || ((key) => key)
       const [data, setData] = React.useState(null)
       const loadStats = () => {
-        fetch('/dsh-tts/stats', { cache: 'no-store' }).then((r) => r.json()).then(setData).catch(() => {})
+        clientFetch('/dsh-tts/stats', { cache: 'no-store', timeoutMs: 8000 }).then((r) => r.json()).then(setData).catch((err) => console.warn('[dsh-tts] loadStats failed:', err))
       }
       React.useEffect(() => { loadStats() }, [])
       const reset = () => {
-        fetch('/dsh-tts/stats', { method: 'DELETE' }).then(loadStats).catch(() => {})
+        clientFetch('/dsh-tts/stats', { method: 'DELETE', timeoutMs: 8000 }).then(loadStats).catch((err) => console.warn('[dsh-tts] resetStats failed:', err))
       }
       return React.createElement('div', { className: 'dts-block' },
         React.createElement('span', { className: 'dts-sub' }, data
@@ -1668,6 +1764,7 @@ window.__ModuleLoader__.load({
     // looks like a working empty form.
       // Snapshot status contract (#163):
       // Without valid scope, or when loading/unavailable, editing is disabled.
+      const [revision, setRevision] = React.useState(null)
       const ready = !!scope && !!snap && snap.status === 'ready'
       const writable = ready && snap.writable !== false
 
@@ -1675,23 +1772,24 @@ window.__ModuleLoader__.load({
         const cfg = data && data.config ? data.config : {}
         setDraft(JSON.parse(JSON.stringify(cfg)))
         setCredentials(data && data.credentials ? data.credentials : {})
+        if (data && data.revision !== undefined) setRevision(data.revision)
         player.enabled = !!cfg.speakReplies
       }
 
       React.useEffect(() => {
         let alive = true
-        fetch('/dsh-tts/config', { cache: 'no-store' }).then((res) => res.json()).then((data) => {
+        clientFetch('/dsh-tts/config', { cache: 'no-store', timeoutMs: 8000 }).then((res) => res.json()).then((data) => {
           if (!alive) return
           applyPayload(data)
         }).catch((e) => { if (alive) setErr(String(e && e.message ? e.message : e)) })
 
-        fetch('/dsh-tts/integrations', { cache: 'no-store' }).then((res) => res.json()).then((data) => {
+        clientFetch('/dsh-tts/integrations', { cache: 'no-store', timeoutMs: 8000 }).then((res) => res.json()).then((data) => {
           if (!alive) return
-          if (data && data.ok) setIntegrations(data)
+          if (data && data.ok) setIntegrations(data.integrations || data)
         }).catch(() => {})
 
         const loadTelemetry = () => {
-          fetch('/dsh-tts/stats', { cache: 'no-store' }).then((res) => res.json()).then((st) => {
+          clientFetch('/dsh-tts/stats', { cache: 'no-store', timeoutMs: 8000 }).then((res) => res.json()).then((st) => {
             if (!alive || !st) return
             setTelemetry((prev) => Object.assign({}, prev, {
               cacheHits: st.cacheHits || 0,
@@ -1702,7 +1800,7 @@ window.__ModuleLoader__.load({
           }).catch(() => {
             if (alive) setTelemetry((prev) => Object.assign({}, prev, { online: false }))
           })
-          fetch('/dsh-tts/status', { cache: 'no-store' }).then((res) => res.json()).then((st) => {
+          clientFetch('/dsh-tts/status', { cache: 'no-store', timeoutMs: 8000 }).then((res) => res.json()).then((st) => {
             if (!alive || !st) return
             setTelemetry((prev) => Object.assign({}, prev, {
               sseClients: st.sseClients || 0,
@@ -1733,10 +1831,11 @@ window.__ModuleLoader__.load({
         const value = String(raw != null ? raw : ((keyDrafts && keyDrafts[provider]) || '')).trim()
         if (!value) return
         setErr('')
-        const res = await fetch('/dsh-tts/credential', {
+        const res = await clientFetch('/dsh-tts/credential', {
           method: 'PUT',
           headers: { 'Content-Type': 'application/json' },
           body: JSON.stringify({ provider: provider, value: value }),
+          timeoutMs: 10000,
         })
         const data = await res.json().catch(() => ({ /* parse error */ }))
         if (!res.ok) throw new Error((data && data.error && data.error.message) || ('HTTP ' + res.status))
@@ -1747,10 +1846,11 @@ window.__ModuleLoader__.load({
       const clearKey = async (provider) => {
         setErr('')
         try {
-          const res = await fetch('/dsh-tts/credential', {
+          const res = await clientFetch('/dsh-tts/credential', {
             method: 'DELETE',
             headers: { 'Content-Type': 'application/json' },
             body: JSON.stringify({ provider: provider }),
+            timeoutMs: 10000,
           })
           const data = await res.json().catch(() => ({ /* parse error */ }))
           if (!res.ok) throw new Error((data && data.error && data.error.message) || ('HTTP ' + res.status))
@@ -1768,10 +1868,15 @@ window.__ModuleLoader__.load({
             const v = String(keyDrafts[p] || '').trim()
             if (v) keys[p] = v
           })
-          const res = await fetch('/dsh-tts/config', {
+          const bodyPayload = Object.assign({}, draft, { keys: keys })
+          if (revision !== null && revision !== undefined) {
+            bodyPayload.revision = revision
+          }
+          const res = await clientFetch('/dsh-tts/config', {
             method: 'PUT',
             headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify(Object.assign({}, draft, { keys: keys })),
+            body: JSON.stringify(bodyPayload),
+            timeoutMs: 10000,
           })
           const data = await res.json().catch(() => ({ /* parse error */ }))
           if (!res.ok) throw new Error((data && data.error && data.error.message) || ('HTTP ' + res.status))
@@ -1787,7 +1892,7 @@ window.__ModuleLoader__.load({
 
       const clearCacheNow = async () => {
         setErr('')
-        const res = await fetch('/dsh-tts/cache', { method: 'DELETE' })
+        const res = await clientFetch('/dsh-tts/cache', { method: 'DELETE', timeoutMs: 10000 })
         if (!res.ok) throw new Error('HTTP ' + res.status)
         setSaved(true); setTimeout(() => setSaved(false), 2000)
       }
@@ -1885,12 +1990,12 @@ window.__ModuleLoader__.load({
         React.createElement(VoiceDuplexEditor, {
           t: t, writable: writable, draft: draft,
           boolField: boolField, setTop: setTop,
-          installed: !!(integrations && integrations.voice && integrations.voice.installed),
+          installed: !!(integrations && (integrations.voice?.installed ?? integrations.integrations?.voice?.installed ?? integrations.voiceInstalled)),
         }),
         React.createElement(MessengerIntegrationEditor, {
           t: t, writable: writable, draft: draft,
           boolField: boolField, setTop: setTop,
-          installed: !!(integrations && integrations.messenger && integrations.messenger.installed),
+          installed: !!(integrations && (integrations.messenger?.installed ?? integrations.integrations?.messenger?.installed ?? integrations.messengerInstalled)),
         }),
         React.createElement('div', { className: 'dts-block' },
           React.createElement('div', { className: 'dts-h' }, t('pronTitle')),

package/lib/engines/manager.js

@@ -11,12 +11,12 @@ export const MODEL_SPECS = {
     files: [
       {
         name: 'kokoro-v0_19.onnx',
-        url: 'https://huggingface.co/hexgrad/Kokoro-82M/resolve/main/kokoro-v0_19.onnx',
+        url: 'https://huggingface.co/hexgrad/Kokoro-82M/resolve/f905c3175b9f7a77d4c1b9be894ff99ff7e9a8f2/kokoro-v0_19.onnx',
         minBytes: 1024,
       },
       {
         name: 'voices.json',
-        url: 'https://huggingface.co/hexgrad/Kokoro-82M/resolve/main/voices.json',
+        url: 'https://huggingface.co/hexgrad/Kokoro-82M/resolve/f905c3175b9f7a77d4c1b9be894ff99ff7e9a8f2/voices.json',
         minBytes: 1024,
       },
     ],
@@ -45,13 +45,26 @@ export function createModelManager({ root = process.env.DSH_HOME || path.join(os
     return path.join(baseDir, engineId)
   }
 
-  async function checkFileExists(filePath, minBytes = 1024) {
-    try {
-      const st = await fs.promises.stat(filePath)
-      return st.isFile() && st.size >= minBytes
-    } catch {
+  async function validateFileIntegrity(filePath, minBytes = 1024) {
+  try {
+    const st = await fs.promises.stat(filePath)
+    if (!st.isFile() || st.size < minBytes) return false
+    const fd = await fs.promises.open(filePath, 'r')
+    const buf = Buffer.alloc(Math.min(st.size, 1024))
+    await fd.read(buf, 0, buf.length, 0)
+    await fd.close()
+    const str = buf.toString('utf8').trim().toLowerCase()
+    if (str.startsWith('<!doctype') || str.startsWith('<html') || str.startsWith('<head') || str.includes('<html')) {
       return false
     }
+    return true
+  } catch (_err) {
+    return false
+  }
+}
+
+  async function checkFileExists(filePath, minBytes = 1024) {
+    return await validateFileIntegrity(filePath, minBytes)
   }
 
   async function getDirSize(dirPath) {
@@ -236,6 +249,10 @@ export function createModelManager({ root = process.env.DSH_HOME || path.join(os
           if (st.size < minExpected) {
             throw new Error(`File ${f.name} truncated: got ${st.size} bytes, expected at least ${minExpected}`)
           }
+          const valid = await validateFileIntegrity(tmpFile, minExpected)
+          if (!valid) {
+            throw new Error(`File ${f.name} failed integrity check: invalid format or HTML error`)
+          }
 
           await fs.promises.rename(tmpFile, targetFile)
           const idx = createdTmpFiles.indexOf(tmpFile)
@@ -255,7 +272,9 @@ export function createModelManager({ root = process.env.DSH_HOME || path.join(os
         lastErrors.set(engineId, { message: sanitized, failedAt: Date.now() })
         throw err
       } finally {
-        activeDownloads.delete(engineId)
+        if (activeDownloads.get(engineId) === downloadState) {
+          activeDownloads.delete(engineId)
+        }
       }
     }
 
@@ -269,7 +288,16 @@ export function createModelManager({ root = process.env.DSH_HOME || path.join(os
     const active = activeDownloads.get(engineId)
     if (active && active.controller) {
       active.controller.abort()
-      activeDownloads.delete(engineId)
+      if (active.promise) {
+        try {
+          await active.promise
+        } catch (_err) {
+          // aborted download rejected as expected
+        }
+      }
+      if (activeDownloads.get(engineId) === active) {
+        activeDownloads.delete(engineId)
+      }
       lastErrors.delete(engineId)
       return true
     }