@marktrue/dsh-mobile-remote 3.2.3-rc.1 → 3.2.4-alpha.1-app

package/lib/npm-update-source.js

@@ -1,226 +0,0 @@
-import { execFile } from "node:child_process";
-import { appCarrierAlias, appCarrierVersion } from "./app-carrier.js";
-import { parseVersion } from "./plugin-update.js";
-import { shellOptions } from "./tool-process.js";
-
-const SRI_PATTERN = /^sha(?:256|384|512)-[A-Za-z0-9+/]+={0,2}$/;
-
-/**
- * Stable package follows latest; 预发布跟随其自身的通道（alpha / rc）。
- * 例：3.2.2-alpha.15 查 alpha，3.2.2-rc.1 查 rc；绝不把预发布塞给 latest。
- */
-export function npmUpdateChannel(localVersion) {
-	const parsed = parseVersion(localVersion);
-	if (!parsed) return { ok: false, reason: "npm-local-version-invalid" };
-	if (parsed.prerelease.length === 0) return { ok: true, channel: "latest" };
-	const channel = parsed.prerelease[0];
-	if (channel === "alpha" || channel === "rc") return { ok: true, channel };
-	return { ok: false, reason: "npm-prerelease-channel-unsupported" };
-}
-
-function packageIntegrity(pkg) {
-	const value = pkg?.dist?.integrity;
-	return typeof value === "string" && SRI_PATTERN.test(value) ? value : "";
-}
-
-/**
- * `npm view <pkg> dist-tags --json` prints the tag map itself
- * (`{"latest":"...","alpha":"..."}`), while some adapters/tests hand back the
- * whole packument field (`{"dist-tags":{...}}`). Accept both so the check never
- * fails merely because of the projection shape.
- */
-function distTagMap(tags) {
-	if (!tags || typeof tags !== "object" || Array.isArray(tags)) return null;
-	const nested = tags["dist-tags"];
-	if (nested && typeof nested === "object" && !Array.isArray(nested)) return nested;
-	return tags;
-}
-
-/** 检查日志只放包名/版本/稳定原因码；绝不写 registry URL、凭据或 npm stderr。 */
-export const NPM_CHECK_LOG_LIMIT = 40;
-const CHECK_LOG_LINE_LIMIT = 240;
-
-function checkRecorder(log) {
-	if (!Array.isArray(log)) return () => {};
-	return (line) => {
-		const text = String(line ?? "").trim();
-		if (text === "") return;
-		log.push(text.length > CHECK_LOG_LINE_LIMIT ? `${text.slice(0, CHECK_LOG_LINE_LIMIT)}…` : text);
-		if (log.length > NPM_CHECK_LOG_LIMIT) log.splice(0, log.length - NPM_CHECK_LOG_LIMIT);
-	};
-}
-
-/**
- * Resolve an immutable plugin/carrier pair from NPM metadata only.
- * `packageView(spec)` is the host NPM adapter; tests inject a deterministic registry.
- * This function never downloads a tarball and never returns registry URLs or raw metadata.
- * `log` (optional array) receives sanitized, bounded diagnostic lines for the settings UI.
- */
-export async function resolveNpmUpdateCandidate({ packageName, localVersion, packageView, log } = {}) {
-	const record = checkRecorder(log);
-	if (typeof packageName !== "string" || packageName.trim() === "") {
-		record(`包名无效：${String(packageName ?? "")}`);
-		return { ok: false, reason: "npm-package-name-invalid" };
-	}
-	if (typeof packageView !== "function") {
-		record(`找不到 npm 元数据适配器（${packageName}）`);
-		return { ok: false, reason: "npm-client-unavailable" };
-	}
-	const channel = npmUpdateChannel(localVersion);
-	if (!channel.ok) {
-		record(`# 本机版本 ${String(localVersion || "未知")} 无法确定 NPM 通道：${channel.reason}`);
-		return channel;
-	}
-	record(`# 本机版本 ${String(localVersion || "未知")} · NPM 通道 ${channel.channel}`);
-
-	let tags;
-	record(`$ npm view ${packageName} dist-tags --json`);
-	try {
-		tags = await packageView(packageName);
-	} catch (error) {
-		const reason = viewFailureReason(error);
-		record(`→ 失败：${reason}`);
-		return { ok: false, reason };
-	}
-	const candidateVersion = distTagMap(tags)?.[channel.channel];
-	if (typeof candidateVersion !== "string" || !parseVersion(candidateVersion)) {
-		record(`→ 缺少 ${channel.channel} 标签`);
-		return { ok: false, reason: "npm-channel-version-missing", channel: channel.channel };
-	}
-	record(`→ ${channel.channel}=${candidateVersion}`);
-
-	let plugin;
-	record(`$ npm view ${packageName}@${candidateVersion} --json`);
-	try {
-		plugin = await packageView(`${packageName}@${candidateVersion}`);
-	} catch (error) {
-		record(`→ 失败：${viewFailureReason(error)}`);
-		return { ok: false, reason: "npm-plugin-metadata-unavailable" };
-	}
-	if (!plugin || plugin.version !== candidateVersion) {
-		record(`→ 版本不符：${String(plugin?.version ?? "缺失")} ≠ ${candidateVersion}`);
-		return { ok: false, reason: "npm-plugin-version-mismatch" };
-	}
-	const pluginIntegrity = packageIntegrity(plugin);
-	if (!pluginIntegrity) {
-		record(`→ 元数据缺少 dist.integrity`);
-		return { ok: false, reason: "npm-plugin-integrity-missing" };
-	}
-	record(`→ 插件 v${candidateVersion}`);
-
-	const carrierVersion = appCarrierVersion(candidateVersion);
-	const alias = appCarrierAlias(packageName);
-	const expectedAliasSpec = `npm:${packageName}@${carrierVersion}`;
-	if (plugin.optionalDependencies?.[alias] !== expectedAliasSpec) {
-		record(`→ 载体别名不匹配：${String(plugin.optionalDependencies?.[alias] ?? "缺失")}（期望 ${expectedAliasSpec}）`);
-		return { ok: false, reason: "npm-carrier-alias-mismatch" };
-	}
-
-	let carrier;
-	record(`$ npm view ${packageName}@${carrierVersion} --json`);
-	try {
-		carrier = await packageView(`${packageName}@${carrierVersion}`);
-	} catch (error) {
-		record(`→ 失败：${viewFailureReason(error)}`);
-		return { ok: false, reason: "npm-carrier-metadata-unavailable" };
-	}
-	if (!carrier || carrier.version !== carrierVersion) {
-		record(`→ 版本不符：${String(carrier?.version ?? "缺失")} ≠ ${carrierVersion}`);
-		return { ok: false, reason: "npm-carrier-version-mismatch" };
-	}
-	const carrierIntegrity = packageIntegrity(carrier);
-	if (!carrierIntegrity) {
-		record(`→ 元数据缺少 dist.integrity`);
-		return { ok: false, reason: "npm-carrier-integrity-missing" };
-	}
-
-	const appVersion = typeof carrier.appVersion === "string" ? carrier.appVersion : null;
-	if (appVersion !== null) {
-		const parsedApp = parseVersion(appVersion);
-		const parsedPlugin = parseVersion(candidateVersion);
-		if (!parsedApp || parsedApp.build === null) {
-			record(`→ App 版本格式无效：${appVersion}`);
-			return { ok: false, reason: "npm-app-version-invalid" };
-		}
-		if (parsedApp.version !== parsedPlugin.version) {
-			record(`→ App 版本配对不符：${appVersion} ↔ 插件 ${candidateVersion}`);
-			return { ok: false, reason: "npm-app-version-pairing-mismatch" };
-		}
-	}
-	const contentSha256 = typeof carrier.pluginContentSha256 === "string" ? carrier.pluginContentSha256.toLowerCase() : "";
-	if (contentSha256 !== "" && !/^[0-9a-f]{64}$/.test(contentSha256)) {
-		record(`→ 插件内容标识格式无效（${carrierVersion}）`);
-		return { ok: false, reason: "npm-plugin-content-sha256-invalid" };
-	}
-
-	record(`→ 载体 v${carrierVersion} · App build ${appVersion ?? "缺失（需预检）"}`);
-
-	return {
-		ok: true,
-		channel: channel.channel,
-		plugin: {
-			name: packageName,
-			version: candidateVersion,
-			integrity: pluginIntegrity,
-			contentSha256,
-		},
-		carrier: {
-			name: packageName,
-			version: carrierVersion,
-			integrity: carrierIntegrity,
-			appVersion,
-			pluginContentSha256: contentSha256,
-			legacyMetadataMissing: appVersion === null,
-		},
-	};
-}
-
-export function runNpmView(args, { cwd = process.cwd(), timeoutMs = 20_000, execFileImpl = execFile, platform = process.platform } = {}) {
-	return new Promise((resolve) => {
-		execFileImpl("npm", args, {
-			cwd,
-			env: process.env,
-			timeout: timeoutMs,
-			maxBuffer: 1024 * 1024,
-			windowsHide: true,
-			// Windows 上 npm 是 npm.cmd，必须经 shell 解析；POSIX 直接 spawn。
-			...shellOptions(platform),
-		}, (error, stdout, stderr) => {
-			if (error) {
-				// npm stderr may contain private registry URLs; expose only a stable source error.
-				// 区分「找不到 npm 客户端」与「registry 不可用」，便于界面给出可执行提示：
-				// Windows shell 找不到 .cmd 时 cmd 会报「不是内部或外部命令」而不是 ENOENT。
-				const stderrText = String(stderr ?? "");
-				const clientMissing = error?.code === "ENOENT" || /not recognized|不是内部或外部命令|command not found/i.test(stderrText);
-				resolve({ ok: false, error: clientMissing ? "npm-client-unavailable" : "npm-view-failed" });
-				return;
-			}
-			resolve({ ok: true, stdout: String(stdout ?? "") });
-		});
-	});
-}
-
-/** 检查失败原因：npm 客户端缺失是环境问题，不应伪装成 registry 故障。 */
-function viewFailureReason(error) {
-	return error?.message === "npm-client-unavailable" ? "npm-client-unavailable" : "npm-registry-unavailable";
-}
-
-/**
- * Host-side npm view adapter. It deliberately supplies no --registry argument so npm
- * applies the DSH process's project/user config, including scoped registry and credentials.
- */
-export function createNpmPackageView({ packageName, cwd, run = runNpmView, platform = process.platform } = {}) {
-	return async (spec) => {
-		if (typeof spec !== "string" || spec === "") throw new Error("npm-package-spec-invalid");
-		const args = spec === packageName
-			? ["view", packageName, "dist-tags", "--json"]
-			: ["view", spec, "--json"];
-		const result = await run(args, { cwd, platform });
-		if (!result?.ok) throw new Error(result?.error ?? "npm-view-failed");
-		try {
-			return JSON.parse(result.stdout);
-		} catch {
-			throw new Error("npm-view-json-invalid");
-		}
-	};
-}

package/lib/plugin-content-digest.js

@@ -1,80 +0,0 @@
-#!/usr/bin/env node
-// 插件内容标识（CONTEXT「内容标识」）：对插件自身的 `package.json` + `lib/**` 做规范化哈希。
-//
-// 为什么要它：manifest 的 `sha256` 是 **tgz 压缩包的字节哈希**，运行中的插件无法从已解开的
-// 目录里复算；而「同一个版本号、不同内容」是真实存在的形态（上游 v3.2.0 与本仓库 develop
-// 的插件版本号都是 3.2.0）。所以另给一个**内容哈希**，让发布侧（打包前）、产物侧
-// （tgz 解包）与运行侧（已安装副本）三处都能算出同一个值。
-//
-// 规范（改动即需升 CONTENT_DIGEST_VERSION，否则同一算法下新旧值不可比）：
-//   1. 参与文件：顶层 `package.json` + 递归 `lib/**`；
-//      排除 `node_modules` 与以 `.` 开头的条目；
-//   2. 路径一律用 `/` 分隔、按字节序升序排列，保证与文件系统枚举顺序无关；
-//   3. 每个文件先把 CRLF 归一为 LF 再哈希（Windows 检出与 Linux 打包必须得到同一个值），
-//      按字节（latin1 往返）处理，避免 UTF-8 解码改变内容；
-//   4. 文本形式为 `plugin-content-digest/v1\n` + 每行 `<相对路径> <文件哈希>\n`，
-//      再取整段的 sha256 作为内容标识。
-import { createHash } from "node:crypto";
-import { readFileSync, readdirSync, statSync } from "node:fs";
-import { join } from "node:path";
-
-/** 内容标识算法的版本；算法本身变化时必须递增。 */
-export const CONTENT_DIGEST_VERSION = 1;
-/** 参与哈希的顶层文件。 */
-const TOP_FILES = ["package.json"];
-/** 参与哈希的目录（递归）。 */
-const TOP_DIRS = ["lib"];
-
-/** CRLF → LF 的字节级归一（不经 UTF-8 解码，二进制内容也能安全往返）。 */
-export function normalizeLineEndings(buf) {
-	return Buffer.from(buf.toString("binary").replace(/\r\n/g, "\n"), "binary");
-}
-
-/** 收集参与哈希的相对路径，按字节序升序。 */
-function collectRelPaths(root) {
-	const found = [];
-	for (const f of TOP_FILES) {
-		try {
-			if (statSync(join(root, f)).isFile()) found.push(f);
-		} catch {
-			// 缺失即不参与（发布侧会在别处报"必需文件缺失"）
-		}
-	}
-	const walk = (rel) => {
-		let entries;
-		try {
-			entries = readdirSync(join(root, rel), { withFileTypes: true });
-		} catch {
-			return;
-		}
-		for (const e of entries) {
-			if (e.name === "node_modules" || e.name.startsWith(".")) continue;
-			const child = `${rel}/${e.name}`;
-			if (e.isDirectory()) walk(child);
-			else if (e.isFile()) found.push(child);
-		}
-	};
-	for (const d of TOP_DIRS) walk(d);
-	return found.sort();
-}
-
-/**
- * 计算插件内容标识。
- * @param {string} root 插件根目录（含 `package.json` 与 `lib/`）
- * @returns {string} 64 位小写 hex
- */
-export function pluginContentDigest(root) {
-	const h = createHash("sha256");
-	h.update(`plugin-content-digest/v${CONTENT_DIGEST_VERSION}\n`);
-	for (const rel of collectRelPaths(root)) {
-		const bytes = normalizeLineEndings(readFileSync(join(root, rel)));
-		const fileHash = createHash("sha256").update(bytes).digest("hex");
-		h.update(`${rel} ${fileHash}\n`);
-	}
-	return h.digest("hex");
-}
-
-/** 参与哈希的相对路径清单（诊断与测试用；与 pluginContentDigest 的输入完全一致）。 */
-export function pluginContentFiles(root) {
-	return collectRelPaths(root);
-}