@goodandready/dsh-russian-lang 0.3.0 → 0.3.3

package/lib/index.js

@@ -1,15 +1,42 @@
+import crypto from 'node:crypto'
 import { registerPluginUpdater } from './plugin-updater.js'
 import { registerTranslator } from './translator.js'
-import { getCoreDictionaries, getPluginDictionaries, getZhRuMap } from './locales.js'
+import { getCoreDictionaries, getPluginDictionaries, getPluginDictionariesByNames, getAllDictionaries, getZhRuMap } from './locales.js'
 // dsh-russian-lang — серверная половина.
 //
 // Словари и переключатель живут в браузере (lib/client.js). Хосту переводить
 // нечего, но у выбора языка есть сохраняемая настройка: регистрируем её схему
-// в собственном namespace, чтобы запись переживала браузеры и машины через
+// в собственном namespace, чтобы запись переживала браузеры и машины череж
 // штатный механизм настроек DSH.
 import z from '@deepseek-ai/schemastery'
 import { SYSTEM_PROMPT_PRESETS } from './pure.js'
 
+
+const sendJsonWithEtag = (request, response, obj, maxAge = 300) => {
+  const body = Buffer.from(JSON.stringify(obj), 'utf-8')
+  const etag = '"' + crypto.createHash('md5').update(body).digest('hex') + '"'
+  const ifNoneMatch = request?.headers?.['if-none-match']
+  if (ifNoneMatch && (ifNoneMatch === etag || ifNoneMatch === '*' || ifNoneMatch === `W/${etag}`)) {
+    response.writeHead(304, {
+      'etag': etag,
+      'cache-control': `public, max-age=${maxAge}, must-revalidate`,
+    })
+    response.end()
+    return
+  }
+  response.writeHead(200, {
+    'content-type': 'application/json; charset=utf-8',
+    'etag': etag,
+    'cache-control': `public, max-age=${maxAge}, must-revalidate`,
+    'content-length': body.length,
+  })
+  if (request?.method === 'HEAD') {
+    response.end()
+  } else {
+    response.end(body)
+  }
+}
+
 export const name = '@goodandready/dsh-russian-lang'
 
 const RussianLangSettingsSchema = z.object({
@@ -36,7 +63,7 @@ export function apply(ctx) {
   })
 
   // #68: русский системный промпт агента (опционально). Регистрируем секцию
-  // промпта, которая задаёт стиль ответов по-русски, когда включён флаг
+  // промпта, которая задёт стиль ответов по-русски, когда включён флаг
   // russian-lang.agentPrompt. Секция — официальная точка расширения ядра.
   ctx.inject(['settings', 'systemPrompt'], (settingsCtx, prompt) => {
     const NS = 'russian-lang'
@@ -57,7 +84,7 @@ export function apply(ctx) {
     sync()
   })
 
-  // Web endpoints: One-click plugin updater, modular plugin dictionary serving, & translator gateway
+  // Web endpoints: One-click plugin updater, modular lazy-plugin dictionary serving, & translator gateway
   if (typeof ctx.inject === 'function') {
     ctx.inject(['webServer'], (wctx) => {
       try {
@@ -73,33 +100,80 @@ export function apply(ctx) {
           let ws = null
           try { ws = wctx?.webServer } catch (_) { ws = null }
 
-          let unregDict = () => {}
+          const unregsDict = []
           if (ws && typeof ws.register === 'function') {
-            unregDict = ws.register({
+            // 1. Core dictionary only (fast-boot, ~135 KB)
+            unregsDict.push(ws.register({
               kind: 'exact',
-              path: '/api/dsh-russian-lang/dict/all',
+              path: '/api/dsh-russian-lang/dict/core',
               handler: async (request, response) => {
                 try {
+                  if (request.method !== 'GET' && request.method !== 'HEAD') {
+                    response.writeHead(405, { allow: 'GET, HEAD', 'content-type': 'application/json; charset=utf-8' })
+                    response.end(JSON.stringify({ error: 'Method not allowed' }))
+                    return
+                  }
                   const core = getCoreDictionaries()
-                  const plugins = getPluginDictionaries()
                   const zhRu = getZhRuMap()
-                  response.writeHead(200, {
-                    'content-type': 'application/json; charset=utf-8',
-                    'cache-control': 'public, max-age=300',
-                  })
-                  response.end(JSON.stringify(Object.assign({}, core, plugins, { core, plugins, zhRu })))
+                  sendJsonWithEtag(request, response, { core, zhRu })
+                } catch (err) {
+                  response.writeHead(500, { 'content-type': 'application/json; charset=utf-8' })
+                  response.end(JSON.stringify({ error: String(err) }))
+                }
+              },
+            }))
+
+            // 2. On-demand plugins dictionary serving (query: ?names=p1,p2...)
+            unregsDict.push(ws.register({
+              kind: 'prefix',
+              path: '/api/dsh-russian-lang/dict/plugins',
+              handler: async (request, response) => {
+                try {
+                  if (request.method !== 'GET' && request.method !== 'HEAD') {
+                    response.writeHead(405, { allow: 'GET, HEAD', 'content-type': 'application/json; charset=utf-8' })
+                    response.end(JSON.stringify({ error: 'Method not allowed' }))
+                    return
+                  }
+                  const url = new URL(request.url, 'http://localhost')
+                  const namesParam = url.searchParams.get('names') || url.searchParams.get('list') || ''
+                  const names = namesParam ? namesParam.split(',').map((s) => s.trim()).filter(Boolean) : null
+                  const plugins = getPluginDictionariesByNames(names)
+                  sendJsonWithEtag(request, response, { plugins })
+                } catch (err) {
+                  response.writeHead(500, { 'content-type': 'application/json; charset=utf-8' })
+                  response.end(JSON.stringify({ error: String(err) }))
+                }
+              },
+            }))
+
+            // 3. Backward compatibility all-dictionaries endpoint
+            unregsDict.push(ws.register({
+              kind: 'exact',
+              path: '/api/dsh-russian-lang/dict/all',
+              handler: async (request, response) => {
+                try {
+                  if (request.method !== 'GET' && request.method !== 'HEAD') {
+                    response.writeHead(405, { allow: 'GET, HEAD', 'content-type': 'application/json; charset=utf-8' })
+                    response.end(JSON.stringify({ error: 'Method not allowed' }))
+                    return
+                  }
+                  const all = getAllDictionaries()
+                  const zhRu = getZhRuMap()
+                  sendJsonWithEtag(request, response, Object.assign({}, all, { core: getCoreDictionaries(), plugins: getPluginDictionaries(), zhRu }))
                 } catch (err) {
                   response.writeHead(500, { 'content-type': 'application/json; charset=utf-8' })
                   response.end(JSON.stringify({ error: String(err) }))
                 }
               },
-            })
+            }))
           }
 
           return () => {
             if (typeof unregUpdater === 'function') unregUpdater()
             if (typeof unregTranslator === 'function') unregTranslator()
-            if (typeof unregDict === 'function') unregDict()
+            for (const u of unregsDict) {
+              if (typeof u === 'function') u()
+            }
           }
         }
         if (typeof wctx.effect === 'function') wctx.effect(mount, 'russian-lang: web routes')