@lynn123411/dsh-chat-translate 1.2.4 → 1.2.6

package/lib/types/client/translate/viewport-observer.d.ts

@@ -16,6 +16,12 @@ export interface ViewportObserverOptions {
 }
 export declare class StreamDebounceViewportObserver {
     private intersectionObserver;
+    /**
+     * Pending per-element streaming debounce timers. A Map (not a WeakMap)
+     * because disconnect() must enumerate and clear every pending timer: a
+     * WeakMap cannot be iterated, so a debounce armed just before the switch was
+     * turned off would still fire registerForViewport() afterwards.
+     */
     private streamingTimers;
     private pendingQueue;
     private batchFlushTimer;

package/lib/types/describe-error.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 把 fetch / 网络失败的可读原因展开成单行文本（宿主与客户端共用）。
+ *
+ * 背景：Node 18+ 与浏览器的 fetch 在网络层失败时只给一句 `TypeError: fetch failed`
+ * （浏览器是 `Failed to fetch`），真实原因藏在 `err.cause` 里——例如
+ * `connect ENETUNREACH 172.24.52.126:8081`、`other side closed [UND_ERR_SOCKET]`、
+ * `getaddrinfo ENOTFOUND`。只上报 `err.message` 会让「端点不可达 / 被代理断开」和
+ * 「插件自身出错」长得一模一样：用户只看到无信息量的 fetch failed，无从判断该改什么。
+ *
+ * 这里把 message 与 cause 链（含 AggregateError 的多地址失败）拼成 `A ← B ← C`。
+ */
+export declare function describeError(err: unknown): string;

package/lib/types/server/config.d.ts

@@ -1,4 +1,4 @@
-import type { PluginConfig, MaskedPluginConfig } from './types.ts';
+import type { PluginConfig } from './types.ts';
 import type { CredentialsReader } from './credentials.ts';
 /** Hard cap for the translation concurrency pool. */
 export declare const MAX_CONCURRENCY = 100;
@@ -37,12 +37,16 @@ export declare class ConfigManager {
     getConfig(): PluginConfig;
     /** Whether the AI channel has every required piece: baseUrl, model and key. */
     isAiConfigured(): boolean;
-    getMaskedConfig(): MaskedPluginConfig;
     onConfigChange(listener: (config: PluginConfig) => void): () => void;
     /**
      * Merge a partial update into the settings namespace. Values are sanitized
      * here (bounds, trimming) so the schema's own constraints act as a second
      * line of defence rather than the only one.
+     *
+     * @internal Test-only. No production path calls this: the host writes the
+     * settings namespace from the browser through the DSH settings service, and
+     * this facade is only driven by `scripts/test-*.mjs` (regression suite).
+     * Kept (with this marker) so those tests keep exercising the sanitizer.
      */
     updateConfig(partial: Partial<PluginConfig>): Promise<PluginConfig>;
 }

package/lib/types/server/credentials.d.ts

@@ -45,7 +45,13 @@ export declare class CredentialsReader implements KeyReader {
     refresh(): Promise<void>;
     /** Synchronous cached read — the hot translation path stays sync. */
     getApiKey(): string;
-    /** Status-only view for the settings UI (plaintext never crosses the wire). */
+    /**
+     * Status-only view of the ref (plaintext never crosses the wire).
+     *
+     * @internal Test-only. The settings UI reads key status through the
+     * `credentials` Remote API with its own client-side shape, so nothing in
+     * `src/` calls this host-side method; only `scripts/test-*.mjs` do.
+     */
     describe(): Promise<{
         configured: boolean;
         writable: boolean;

package/lib/types/server/types.d.ts

@@ -9,18 +9,6 @@ export interface PluginConfig {
     model: string;
     targetLang: string;
 }
-export interface MaskedPluginConfig {
-    enabled: boolean;
-    concurrency: number;
-    timeoutMs: number;
-    aiTimeoutMs: number;
-    aiEnabled: boolean;
-    bingEnabled: boolean;
-    baseUrl: string;
-    model: string;
-    targetLang: string;
-    aiConfigured: boolean;
-}
 export interface TranslateItemResult {
     original: string;
     translated: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lynn123411/dsh-chat-translate",
-  "version": "1.2.4",
+  "version": "1.2.6",
   "description": "Tool-call & think-summary translation with dual AI (OpenAI-compatible) + Bing channels for the DeepSeek Harness Web UI",
   "license": "MIT",
   "author": "lynn123411",
@@ -66,7 +66,8 @@
     "node": "^22.19 || >=24"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-home-paths": "0.1.3-alpha.2",
+    "@deepseek-ai/dsh-home-paths": "^0.1.5-rc.1",
+    "@deepseek-ai/schemastery": "^3.18.2",
     "@eslint/js": "^9.30.0",
     "@types/node": "^22.19.0",
     "@types/react": "^19.2.18",
@@ -74,10 +75,7 @@
     "jsdom": "^26.1.0",
     "typescript": "^6.0.0"
   },
-  "dependencies": {
-    "@deepseek-ai/schemastery": "^3.18.2"
-  },
   "peerDependencies": {
-    "@deepseek-ai/dsh-home-paths": "^0.1.3-alpha.2"
+    "@deepseek-ai/dsh-home-paths": "^0.1.5-rc.1"
   }
 }