dsh-version-check 0.0.0-stage → 0.3.1

package/lib/versions.js

@@ -0,0 +1,100 @@
+// src/versions.ts
+const NUMERIC_IDENTIFIER = /^(?:0|[1-9]\d*)$/;
+const IDENTIFIER = /^[0-9A-Za-z-]+$/;
+const VERSION = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
+/**
+* 解析一个版本字符串。
+* @param text 版本字符串，允许 v 前缀与 build metadata。
+* @returns 非法输入返回 null。
+*/
+function parseVersion(text) {
+	if (typeof text !== "string") return null;
+	const match = VERSION.exec(text);
+	if (match === null) return null;
+	if (![
+		match[1],
+		match[2],
+		match[3]
+	].every((part) => NUMERIC_IDENTIFIER.test(part))) return null;
+	const prerelease = match[4] === void 0 ? [] : match[4].split(".");
+	for (const identifier of prerelease) {
+		if (!IDENTIFIER.test(identifier)) return null;
+		if (/^\d+$/.test(identifier) && !NUMERIC_IDENTIFIER.test(identifier)) return null;
+	}
+	return {
+		major: Number(match[1]),
+		minor: Number(match[2]),
+		patch: Number(match[3]),
+		prerelease
+	};
+}
+/**
+* 取一个可比较的版本对象；非法版本就地抛出。
+* @param text 版本字符串。
+* @param label 参数名称，仅用于错误信息。
+*/
+function requireVersion(text, label) {
+	const parsed = parseVersion(text);
+	if (parsed === null) throw new TypeError(`${label} 不是合法的版本号: ${String(text)}`);
+	return parsed;
+}
+/**
+* 比较两个 prerelease 标识符。
+* 两个数字按数值比较；数字小于非数字；非数字按 ASCII 字典序比较。
+*/
+function compareIdentifiers(left, right) {
+	const leftNumeric = /^\d+$/.test(left);
+	const rightNumeric = /^\d+$/.test(right);
+	if (leftNumeric && rightNumeric) {
+		const leftValue = Number(left);
+		const rightValue = Number(right);
+		if (leftValue === rightValue) return 0;
+		return leftValue < rightValue ? -1 : 1;
+	}
+	if (leftNumeric !== rightNumeric) return leftNumeric ? -1 : 1;
+	if (left === right) return 0;
+	return left < right ? -1 : 1;
+}
+/**
+* 按 semver 优先级比较两个版本号。
+* 有 prerelease 的版本小于同号正式版；prerelease 标识符逐个比较，
+* 前缀相同时更长的标识符列表更大。
+*/
+function compareVersions(a, b) {
+	const left = requireVersion(a, "a");
+	const right = requireVersion(b, "b");
+	for (const field of [
+		"major",
+		"minor",
+		"patch"
+	]) if (left[field] !== right[field]) return left[field] < right[field] ? -1 : 1;
+	const leftPrerelease = left.prerelease;
+	const rightPrerelease = right.prerelease;
+	if (leftPrerelease.length === 0 && rightPrerelease.length === 0) return 0;
+	if (leftPrerelease.length === 0) return 1;
+	if (rightPrerelease.length === 0) return -1;
+	const length = Math.min(leftPrerelease.length, rightPrerelease.length);
+	for (let index = 0; index < length; index += 1) {
+		const result = compareIdentifiers(leftPrerelease[index], rightPrerelease[index]);
+		if (result !== 0) return result;
+	}
+	if (leftPrerelease.length === rightPrerelease.length) return 0;
+	return leftPrerelease.length < rightPrerelease.length ? -1 : 1;
+}
+/**
+* 取版本号 prerelease 渠道，即第一个 prerelease 标识符。
+* @param version 版本字符串。
+* @returns 无 prerelease 或版本非法时返回 null。
+*/
+function prereleaseChannel(version) {
+	const parsed = parseVersion(version);
+	if (parsed === null || parsed.prerelease.length === 0) return null;
+	return parsed.prerelease[0];
+}
+/**
+* 判断字符串是否是一个合法版本号。
+*/
+function isValidVersion(text) {
+	return parseVersion(text) !== null;
+}
+export { compareVersions, isValidVersion, parseVersion, prereleaseChannel };

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "DSH Version Check",
+    "description": "Shows the installed DSH version at the sidebar foot, checks npm for a newer release, updates it or rolls the main program back to an earlier release with one click while restarting the service."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "DSH 版本检查",
+    "description": "在侧边栏底部显示 DSH 版本，从 npm 检查新版本，支持一键更新与把主程序回滚到更早版本，并自动重启服务。"
+  }
+}

package/package.json

@@ -1,6 +1,66 @@
 {
   "name": "dsh-version-check",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.3.1",
+  "description": "在 DSH Web 侧边栏底部显示 DSH 版本，从 npm 检查新版本，支持一键更新、把主程序回滚到更早的已发布版本，并在更新与回滚后自动重启服务；更新检查可在设置页里开关与调整。",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kerolt/dsh-version-check.git"
+  },
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": "./lib/client.js",
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "locale/*.json",
+    "icon.svg",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "version-check"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "check": "tsc -p tsconfig.json",
+    "prepack": "npm run build",
+    "pretest": "npm run build",
+    "test": "node --test test/*.test.ts",
+    "verify": "npm run build && npm run check && node --test test/*.test.ts"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "immediately": true,
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-sidebar",
+        "@deepseek-ai/dsh-client-ui-settings"
+      ]
+    }
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "~4.0.5",
+    "@deepseek-ai/dsh-host-webserver": "^0.2.1-rc.3",
+    "@types/node": "^24.19.2",
+    "tsdown": "^0.23.4",
+    "typescript": "^5.9.3"
+  }
+}