dsh-update-status 0.1.6 → 0.1.8

package/lib/index.d.ts

@@ -22,6 +22,23 @@ type ReleaseCompatibility = 'verified' | 'unverified' | 'incompatible';
  */
 type UpdateWarningKind = 'failure' | 'notice';
 type InstallKind = 'npm-global' | 'pnpm-global' | 'source-checkout' | 'unknown';
+/** Language-neutral warning facts; the browser renders them in its own locale. */
+type UpdateWarning = {
+  code: 'registry-unavailable';
+  detail: string;
+} | {
+  code: 'channel-unavailable';
+  channel: ReleaseChannel;
+} | {
+  code: 'version-incomparable';
+  currentVersion: string;
+  channel: ReleaseChannel;
+  selectedVersion: string;
+} | {
+  code: 'preview-unverified';
+  channel: ReleaseChannel;
+  version: string;
+};
 interface ChannelRelease {
   channel: ReleaseChannel;
   version: string | null;
@@ -39,9 +56,12 @@ interface UpdateStatus {
   hasUpdate: boolean;
   cached: boolean;
   checkedAt: string | null;
+  /** English fallback for older clients; current clients localize `warnings`. */
   warning: string | null;
   /** Severity of `warning`; absent from a Host older than the field. */
   warningKind?: UpdateWarningKind | null;
+  /** Structured warning facts; absent from a Host older than this field. */
+  warnings?: UpdateWarning[];
   installKind: InstallKind;
   upgradeCommand: string;
   releaseUrl: string;
@@ -80,7 +100,7 @@ interface UpdateStatusConfig {
  * input side takes, so the inferred schema type cannot be named by the emitted
  * `.d.ts` (TS2883) without stating the input side here.
  */
-declare const Config: z<UpdateStatusConfig, Record<string, unknown>>;
+export declare const Config: z<UpdateStatusConfig, Record<string, unknown>>;
 //#endregion
 //#region src/host/installation.d.ts
 interface InstallationInfo {
@@ -104,7 +124,7 @@ interface UpdateStatusServiceOptions {
   ttlMs?: number;
   releaseUrl?: string;
 }
-declare class UpdateStatusService {
+export declare class UpdateStatusService {
   private readonly installation;
   private readonly fetchLatest;
   private readonly now;
@@ -119,15 +139,14 @@ declare class UpdateStatusService {
   private refreshRelease;
   private statusAfterFailure;
   private statusFromCache;
-  /** No remote data at all: the registry read itself failed, never a notice. */
   private statusWithoutRemoteRelease;
 }
 //#endregion
 //#region src/index.d.ts
-declare const name = "dsh-update-status";
+export declare const name = "dsh-update-status";
 /** Connection supplies the authenticated transport; settings remains optional. */
-declare const inject: string[];
-type Config = UpdateStatusConfig;
-declare function apply(ctx: Context, config?: Config): void;
+export declare const inject: string[];
+export type Config = UpdateStatusConfig;
+export declare function apply(ctx: Context, config?: Config): void;
 //#endregion
-export { Config, type InstallKind, type UpdateStatus, UpdateStatusService, apply, inject, name };
+export type { InstallKind, UpdateStatus };

package/lib/index.js

@@ -12,7 +12,11 @@ const UPDATE_STATUS_CHANNEL = "/api";
 * release the registry reports stays `unverified` — the plugin never claims a
 * compatibility nobody checked.
 */
-const VERIFIED_DSH_VERSIONS = ["0.1.7-alpha.2", "0.1.7-rc.1"];
+const VERIFIED_DSH_VERSIONS = [
+	"0.1.7-alpha.2",
+	"0.1.7-rc.1",
+	"0.1.7-rc.2"
+];
 const RELEASE_CHANNELS = [
 	"latest",
 	"next",
@@ -124,8 +128,8 @@ function upgradeCommandFor(installKind, packageName = PACKAGE_NAME, channel = "l
 	switch (installKind) {
 		case "npm-global": return `npm install -g ${specifier}`;
 		case "pnpm-global": return `pnpm add -g ${specifier}`;
-		case "source-checkout": return "在 DSH checkout 中拉取代码、安装依赖并重新构建；插件不会从 GUI 原地替换";
-		default: return "请确认 dsh 安装方式后再升级；当前插件不会代为执行";
+		case "source-checkout": return "Update the DSH source checkout, install its dependencies, and rebuild it; this plugin cannot replace it in place from the GUI";
+		default: return "Confirm how DSH was installed before upgrading; this plugin cannot perform the upgrade for you";
 	}
 }
 /**
@@ -313,10 +317,20 @@ function boundedMessage(error) {
 	const trimmed = (error instanceof Error ? error.message : String(error)).replace(/\s+/g, " ").trim();
 	return trimmed === "" ? "unknown error" : trimmed.slice(0, 220);
 }
-function warningWith(base, addition) {
-	if (base === null || base === "") return addition;
-	if (addition === null || addition === "") return base;
-	return `${base} ${addition}`;
+function warningText(warning) {
+	switch (warning.code) {
+		case "registry-unavailable": return `Unable to check the npm registry: ${warning.detail}`;
+		case "channel-unavailable": return `The npm registry does not publish a ${warning.channel} channel.`;
+		case "version-incomparable": return `Unable to compare the current version ${warning.currentVersion} with ${warning.channel} channel version ${warning.selectedVersion} using SemVer.`;
+		case "preview-unverified": return `${warning.channel} is a preview channel; version ${warning.version} has not been verified as compatible with this plugin.`;
+	}
+}
+function warningFallback(warnings) {
+	return warnings.length === 0 ? null : warnings.map(warningText).join(" ");
+}
+function warningKindOf(warnings) {
+	if (warnings.length === 0) return null;
+	return warnings.every((warning) => warning.code === "preview-unverified") ? "notice" : "failure";
 }
 function dateOrNull(value) {
 	if (typeof value !== "string" || value === "") return null;
@@ -401,16 +415,16 @@ var UpdateStatusService = class {
 	async check(force = false, channel = "latest", cacheTtlMinutes) {
 		const ttlMs = isCacheTtlMinutes(cacheTtlMinutes) ? cacheTtlMinutes * 60 * 1e3 : this.ttlMs;
 		const cached = this.cache;
-		if (!force && cached !== void 0 && this.now() - cached.checkedAtMs < ttlMs) return this.statusFromCache(cached, channel, true, null);
+		if (!force && cached !== void 0 && this.now() - cached.checkedAtMs < ttlMs) return this.statusFromCache(cached, channel, true, []);
 		if (this.inFlight !== void 0) try {
-			return this.statusFromCache(await this.inFlight, channel, false, null);
+			return this.statusFromCache(await this.inFlight, channel, false, []);
 		} catch (error) {
 			return this.statusAfterFailure(channel, error);
 		}
 		const run = this.refreshRelease();
 		this.inFlight = run;
 		try {
-			return this.statusFromCache(await run, channel, false, null);
+			return this.statusFromCache(await run, channel, false, []);
 		} catch (error) {
 			return this.statusAfterFailure(channel, error);
 		} finally {
@@ -426,10 +440,13 @@ var UpdateStatusService = class {
 		return cache;
 	}
 	statusAfterFailure(channel, error) {
-		const warning = `无法检查 npm registry：${boundedMessage(error)}`;
-		return this.cache === void 0 ? this.statusWithoutRemoteRelease(channel, warning) : this.statusFromCache(this.cache, channel, true, warning);
+		const warnings = [{
+			code: "registry-unavailable",
+			detail: boundedMessage(error)
+		}];
+		return this.cache === void 0 ? this.statusWithoutRemoteRelease(channel, warnings) : this.statusFromCache(this.cache, channel, true, warnings);
 	}
-	statusFromCache(cache, channel, cached, initialWarning) {
+	statusFromCache(cache, channel, cached, initialWarnings) {
 		const selected = cache.release.channels.find((release) => release.channel === channel) ?? {
 			channel,
 			version: null,
@@ -437,19 +454,31 @@ var UpdateStatusService = class {
 			compatibility: "unverified"
 		};
 		const comparison = selected.version === null ? void 0 : compareSemver(this.installation.currentVersion, selected.version);
-		const missingWarning = selected.version === null ? `npm registry 未发布 ${channel} 通道。` : null;
-		const comparisonWarning = selected.version !== null && comparison === void 0 ? `无法按 SemVer 比较当前版本 ${this.installation.currentVersion} 与 ${channel} 通道版本 ${selected.version}。` : null;
-		const previewWarning = channel !== "latest" && selected.version !== null && selected.compatibility !== "verified" ? `${channel} 是预览通道，版本 ${selected.version} 尚未验证与本插件兼容。` : null;
-		const failureWarning = warningWith(warningWith(initialWarning, missingWarning), comparisonWarning);
-		const warning = warningWith(failureWarning, previewWarning);
+		const warnings = [...initialWarnings];
+		if (selected.version === null) warnings.push({
+			code: "channel-unavailable",
+			channel
+		});
+		if (selected.version !== null && comparison === void 0) warnings.push({
+			code: "version-incomparable",
+			currentVersion: this.installation.currentVersion,
+			channel,
+			selectedVersion: selected.version
+		});
+		if (channel !== "latest" && selected.version !== null && selected.compatibility !== "verified") warnings.push({
+			code: "preview-unverified",
+			channel,
+			version: selected.version
+		});
 		return {
 			currentVersion: this.installation.currentVersion,
 			latestVersion: selected.version,
 			hasUpdate: comparison !== void 0 && comparison < 0,
 			cached,
 			checkedAt: new Date(cache.checkedAtMs).toISOString(),
-			warning,
-			warningKind: warning === null ? null : failureWarning === null ? "notice" : "failure",
+			warning: warningFallback(warnings),
+			warningKind: warningKindOf(warnings),
+			warnings,
 			installKind: this.installation.installKind,
 			upgradeCommand: upgradeCommandFor(this.installation.installKind, this.installation.packageName || "@deepseek-ai/dsh", channel),
 			releaseUrl: this.releaseUrl,
@@ -461,16 +490,16 @@ var UpdateStatusService = class {
 			canApplyInPlace: false
 		};
 	}
-	/** No remote data at all: the registry read itself failed, never a notice. */
-	statusWithoutRemoteRelease(channel, warning) {
+	statusWithoutRemoteRelease(channel, warnings) {
 		return {
 			currentVersion: this.installation.currentVersion,
 			latestVersion: null,
 			hasUpdate: false,
 			cached: false,
 			checkedAt: null,
-			warning,
-			warningKind: "failure",
+			warning: warningFallback(warnings),
+			warningKind: warningKindOf(warnings),
+			warnings,
 			installKind: this.installation.installKind,
 			upgradeCommand: upgradeCommandFor(this.installation.installKind, this.installation.packageName || "@deepseek-ai/dsh", channel),
 			releaseUrl: this.releaseUrl,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-update-status",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Read-only DeepSeek Harness Web plugin that shows the running DSH version, discovers latest/next/alpha releases, warns about compatibility, and generates copy-only upgrade commands.",
   "type": "module",
   "main": "lib/index.js",
@@ -63,7 +63,8 @@
     "compatibility": {
       "dshReleases": {
         "0.1.7-alpha.2": "compatible",
-        "0.1.7-rc.1": "compatible"
+        "0.1.7-rc.1": "compatible",
+        "0.1.7-rc.2": "compatible"
       }
     }
   },
@@ -88,9 +89,9 @@
     "@types/node": "^26.2.0",
     "@types/react": "^18.3.31",
     "react": "^18.3.1",
-    "tsdown": "^0.22.14",
+    "tsdown": "^0.23.0",
     "typescript": "^7.0.2",
-    "vitest": "^4.1.11"
+    "vitest": "^5.0.1"
   },
   "scripts": {
     "build": "tsdown",