@applift/core 0.5.0 → 0.7.0

package/dist/plugins/index.d.mts

@@ -1,4 +1,4 @@
-import { i as QypubPlugin } from "../plugin-CTt0LO8c.mjs";
+import { E as FrameworkContext, O as UpdateProvider, _ as AppliftPlugin, a as knownFrameworkAdapters, c as nativeHarmonyAdapter, d as nativeIosFramework, f as rnAdapter, g as tauriFramework, h as tauriAdapter, i as flutterFramework, l as nativeHarmonyFramework, m as suggestFramework, n as electronFramework, o as nativeAndroidAdapter, p as rnFramework, r as flutterAdapter, s as nativeAndroidFramework, t as electronAdapter, u as nativeIosAdapter, w as DeliveryJudgement } from "../frameworks-D83HVg8t.mjs";
 //#region src/plugins/dingtalk-notify.d.ts
 interface DingtalkNotifyOptions {
   webhook: string;
@@ -6,6 +6,77 @@ interface DingtalkNotifyOptions {
   secret?: string;
   atMobiles?: string[];
 }
-export declare function dingtalkNotify(options: DingtalkNotifyOptions): QypubPlugin;
+export declare function dingtalkNotify(options: DingtalkNotifyOptions): AppliftPlugin;
 //#endregion
-export type { DingtalkNotifyOptions };
+//#region src/plugins/pushy-cli.d.ts
+interface CliResult {
+  code: number;
+  stdout: string;
+  stderr: string;
+}
+type CliRunner = (args: string[], opts?: {
+  cwd?: string;
+}) => Promise<CliResult>;
+/** 默认 runner：spawn 全局 pushy，超时 10 分钟（bundle/upload 含网络大文件传输） */
+export declare function spawnPushy(args: string[], opts?: {
+  cwd?: string;
+}): Promise<CliResult>;
+interface PushyCli {
+  /** 构建热更包，返回 ppk 路径 */
+  bundle(platform: string, cwd?: string): Promise<string>;
+  /** 发布热更版本（publish），返回版本 id */
+  publish(input: {
+    appId: number;
+    ppk: string;
+    platform: string;
+    name: string;
+    description?: string;
+    packageVersion: string;
+    rollout?: number;
+  }): Promise<{
+    versionId: number;
+  }>;
+  /** 上传原生基线（基线版本号由服务端从包内读取） */
+  uploadApp(appId: number, appFile: string): Promise<{
+    packageId: number;
+    version: string;
+  }>;
+  /** 版本重绑（promote 语义：测试通道版本重绑正式原生版本 + 灰度） */
+  rebind(input: {
+    appId: number;
+    versionId: number;
+    packageVersion: string;
+    rollout?: number;
+  }): Promise<void>;
+  /** 版本列表（取号与状态展示用） */
+  versions(appId: number): Promise<Array<{
+    id: number;
+    hash: string;
+    name: string;
+  }>>;
+}
+export declare function createPushyCli(runner?: CliRunner): PushyCli;
+//#endregion
+//#region src/plugins/rn-update.d.ts
+interface RnUpdateOptions {
+  /** 各平台的 app 记录号（如 harmony: 34166）；未声明的平台不启用热更 */
+  harmony?: number;
+  android?: number;
+  ios?: number;
+  /** 补丁目录（patch-package 约定默认 patches/，项目可覆盖） */
+  patchDir?: string;
+  /** 正式发布默认灰度比例 */
+  defaultRollout?: number;
+}
+/**
+ * 判定引擎：diff 能否走热更。
+ * 五形态完备性：新原生实体必现于 原生目录/依赖(原生包)/补丁/构建配置/JS——前四判原生，纯 JS 判热更，其余灰区。
+ */
+export declare function judgeDelivery(diff: string[], ctx: FrameworkContext, opts: RnUpdateOptions): DeliveryJudgement;
+/** provider 构造（cli 注入点：测试 mock / 将来直连 API） */
+export declare function makeRnUpdateProvider(opts: RnUpdateOptions, cli?: PushyCli): UpdateProvider;
+/** rnUpdate 插件工厂：注册完整 provider（判定 + 测试发布 + promote）+ 原生发版自动基线。
+ *  cli 注入点：测试 mock / 将来进程内直连 API。 */
+export declare function rnUpdate(opts?: RnUpdateOptions, cli?: PushyCli): AppliftPlugin;
+//#endregion
+export { type CliResult, type CliRunner, type DingtalkNotifyOptions, type PushyCli, type RnUpdateOptions, electronAdapter, electronFramework, flutterAdapter, flutterFramework, knownFrameworkAdapters, nativeAndroidAdapter, nativeAndroidFramework, nativeHarmonyAdapter, nativeHarmonyFramework, nativeIosAdapter, nativeIosFramework, rnAdapter, rnFramework, suggestFramework, tauriAdapter, tauriFramework };

package/dist/plugins/index.mjs

@@ -1,4 +1,8 @@
+import { _ as suggestFramework, a as electronFramework, c as knownFrameworkAdapters, d as nativeHarmonyAdapter, f as nativeHarmonyFramework, g as rnFramework, h as rnAdapter, i as electronAdapter, l as nativeAndroidAdapter, m as nativeIosFramework, o as flutterAdapter, p as nativeIosAdapter, r as redactText, s as flutterFramework, t as readProjectVersions, u as nativeAndroidFramework, v as tauriAdapter, y as tauriFramework } from "../project-4_orxby_.mjs";
+import fs from "node:fs";
+import path from "node:path";
 import { createHmac } from "node:crypto";
+import { spawn, spawnSync } from "node:child_process";
 //#region src/plugins/dingtalk-notify.ts
 /**
 * 官方示例插件 —— 钉钉机器人通知。
@@ -13,7 +17,7 @@ function dingtalkNotify(options) {
 		async notify(summary) {
 			const title = summary.submit.length === 0 ? "applift stage 草稿（未提审）" : "applift 发布结果";
 			const lines = [title];
-			for (const e of [...summary.stage, ...summary.submit]) lines.push(`- ${e.label}: ${e.ok ? "✅ 成功" : `❌ ${e.stageError ?? e.submitError ?? "失败"}`}`);
+			for (const e of [...summary.stage, ...summary.submit]) lines.push(`- ${e.label}: ${e.ok ? "✅ 成功" : `❌ ${redactText(e.stageError ?? e.submitError ?? "失败")}`}`);
 			const body = {
 				msgtype: "markdown",
 				markdown: {
@@ -41,4 +45,435 @@ function dingtalkNotify(options) {
 	};
 }
 //#endregion
-export { dingtalkNotify };
+//#region src/plugins/pushy-cli.ts
+/**
+* 不 require 其内部 lib（无公开契约）；cresc/自建服务的差异在服务端 URL，CLI 参数面一致。
+* 输出解析正则按 react-native-update-cli 2.22.9 实测文案编写（源码 i18n 硬编码：pushy 恒中文、cresc 恒英文，
+* 不随系统 locale）；CLI 升级改文案会显式抛错而非静默，升级后请跑 pushy-cli.test.ts 的真实输出回归。
+* cresc 二进制输出为英文，本封装不适用——换 cresc 应另写 provider 插件而非复用本封装。
+*/
+/** 默认 runner：spawn 全局 pushy，超时 10 分钟（bundle/upload 含网络大文件传输） */
+function spawnPushy(args, opts) {
+	return new Promise((resolve, reject) => {
+		const child = spawn("pushy", args, { cwd: opts?.cwd });
+		let stdout = "";
+		let stderr = "";
+		const timer = setTimeout(() => child.kill("SIGKILL"), 6e5);
+		child.stdout?.on("data", (d) => stdout += d.toString());
+		child.stderr?.on("data", (d) => stderr += d.toString());
+		child.on("error", (e) => {
+			clearTimeout(timer);
+			reject(/* @__PURE__ */ new Error(`pushy 命令不可用（react-native-update-cli 未全局安装？）：${e.message}`));
+		});
+		child.on("close", (code) => {
+			clearTimeout(timer);
+			resolve({
+				code: code ?? 1,
+				stdout,
+				stderr
+			});
+		});
+	});
+}
+function fail(cmd, r) {
+	throw new Error(`pushy ${cmd} 失败（exit ${r.code}）：${(r.stderr || r.stdout).trim()}`);
+}
+function createPushyCli(runner = spawnPushy) {
+	return {
+		async bundle(platform, cwd) {
+			const r = await runner([
+				"bundle",
+				"--platform",
+				platform,
+				"--no-interactive"
+			], { cwd });
+			if (r.code !== 0) fail("bundle", r);
+			const m = r.stdout.match(/已生成\s+(\S+\.ppk)/);
+			if (!m) throw new Error(`pushy bundle 输出未含 ppk 路径：${r.stdout.trim()}`);
+			return m[1];
+		},
+		async publish(input) {
+			const args = [
+				"publish",
+				input.ppk,
+				"--platform",
+				input.platform,
+				"--appId",
+				String(input.appId),
+				"--name",
+				input.name,
+				"--packageVersion",
+				input.packageVersion
+			];
+			if (input.description) args.push("--description", input.description);
+			if (input.rollout !== void 0) args.push("--rollout", String(input.rollout));
+			args.push("--no-interactive");
+			const r = await runner(args);
+			if (r.code !== 0) fail("publish", r);
+			const m = (r.stdout + r.stderr).match(/已成功上传新热更包（id:\s*(\d+)）/);
+			if (!m) throw new Error(`pushy publish 输出未含版本 id：${r.stdout.trim()}`);
+			return { versionId: Number(m[1]) };
+		},
+		async uploadApp(appId, appFile) {
+			const r = await runner([
+				"uploadApp",
+				appFile,
+				"--appId",
+				String(appId)
+			]);
+			if (r.code !== 0) fail("uploadApp", r);
+			const m = (r.stdout + r.stderr).match(/已成功上传app原生包（id:\s*(\d+),\s*version:\s*([\d.]+)[^）]*）/);
+			if (!m) throw new Error(`pushy uploadApp 输出未含原生包信息：${(r.stdout + r.stderr).trim()}`);
+			return {
+				packageId: Number(m[1]),
+				version: m[2]
+			};
+		},
+		async rebind(input) {
+			const args = [
+				"update",
+				"--versionId",
+				String(input.versionId),
+				"--appId",
+				String(input.appId),
+				"--packageVersion",
+				input.packageVersion
+			];
+			if (input.rollout !== void 0) args.push("--rollout", String(input.rollout));
+			args.push("--no-interactive");
+			const r = await runner(args);
+			if (r.code !== 0) fail("update", r);
+		},
+		async versions(appId) {
+			const r = await runner([
+				"versions",
+				"--appId",
+				String(appId),
+				"--no-interactive"
+			]);
+			if (r.code !== 0) fail("versions", r);
+			const out = [];
+			for (const m of r.stdout.matchAll(/^(\d+)\)\s+(\S+)\s+(\S+)/gm)) out.push({
+				id: Number(m[1]),
+				hash: m[2],
+				name: m[3]
+			});
+			return out;
+		}
+	};
+}
+//#endregion
+//#region src/plugins/rn-update.ts
+/**
+* rn-update 插件：react-native-update（pushy/cresc/自建服务端）的 applift UpdateProvider 实现。
+* 判定引擎为纯函数（五形态完备性见测试头注释）；发布链路 = ppk 构建 / 测试通道 / promote / 原生基线。
+*/
+/** 项目原生目录：任一命中即必须原生发版 */
+const NATIVE_DIRS = [
+	"harmony/",
+	"ios/",
+	"android/"
+];
+/** 根级构建/身份配置：改变产物生成方式或应用标识，保守判原生 */
+const NATIVE_ROOT_FILES = /* @__PURE__ */ new Set([
+	"app.json",
+	"react-native.config.js",
+	"react-native.config.cjs",
+	"metro.config.js",
+	"metro.config.cjs",
+	"metro.config.ts",
+	"babel.config.js",
+	"babel.config.cjs"
+]);
+function classifyPath(file, opts) {
+	if (NATIVE_DIRS.some((d) => file.startsWith(d))) return {
+		kind: "native",
+		rule: "原生目录"
+	};
+	const patchDir = opts.patchDir ?? "patches";
+	if (file.startsWith(`${patchDir}/`)) return {
+		kind: "native",
+		rule: `补丁目录（${patchDir}/）`
+	};
+	if (NATIVE_ROOT_FILES.has(file)) return {
+		kind: "native",
+		rule: "构建/身份配置"
+	};
+	if (file === "package.json") return {
+		kind: "dep-analysis",
+		rule: "依赖变更"
+	};
+	if (file === "package-lock.json") return {
+		kind: "uncertain",
+		rule: "lockfile 变更（依赖树内部变化）"
+	};
+	if (file.startsWith("src/")) return {
+		kind: "js",
+		rule: "JS 层"
+	};
+	return {
+		kind: "uncertain",
+		rule: "未知路径（灰区）"
+	};
+}
+/** 读取 package.json 的依赖集合（deps + devDeps 的 name→range 映射） */
+function readDeps(file) {
+	try {
+		const pkg = JSON.parse(fs.readFileSync(file, "utf8"));
+		return {
+			...pkg.dependencies,
+			...pkg.devDependencies
+		};
+	} catch {
+		return {};
+	}
+}
+/** node_modules 原生信号检测：true=含原生实现；false=纯 JS；null=无法检测（包未安装） */
+function hasNativeSignal(cwd, name) {
+	if (name.startsWith("@react-native-ohos/")) return true;
+	const root = path.join(cwd, "node_modules", name);
+	const pkgFile = path.join(root, "package.json");
+	try {
+		const pkg = JSON.parse(fs.readFileSync(pkgFile, "utf8"));
+		if ("react-native" in pkg || "harmony" in pkg) return true;
+	} catch {
+		return null;
+	}
+	if (fs.readdirSync(root, { withFileTypes: true }).some((e) => e.isFile() && e.name.endsWith(".podspec"))) return true;
+	return fs.existsSync(path.join(root, "android", "build.gradle"));
+}
+/** 锚点..当前的 package.json 依赖对比：返回变更包名列表（无锚点返回 null） */
+function changedPackages(cwd, anchor) {
+	if (!anchor) return null;
+	const old = readDepsFromGit(cwd, anchor);
+	const cur = readDeps(path.join(cwd, "package.json"));
+	if (old === null) return null;
+	const changed = [];
+	for (const [name, range] of Object.entries(cur)) if (!(name in old) || old[name] !== range) changed.push(name);
+	for (const name of Object.keys(old)) if (!(name in cur)) changed.push(name);
+	return changed;
+}
+function readDepsFromGit(cwd, ref) {
+	const r = spawnSync("git", ["show", `${ref}:package.json`], {
+		cwd,
+		encoding: "utf8"
+	});
+	if (r.status !== 0) return null;
+	try {
+		const pkg = JSON.parse(r.stdout);
+		return {
+			...pkg.dependencies,
+			...pkg.devDependencies
+		};
+	} catch {
+		return null;
+	}
+}
+/**
+* 判定引擎：diff 能否走热更。
+* 五形态完备性：新原生实体必现于 原生目录/依赖(原生包)/补丁/构建配置/JS——前四判原生，纯 JS 判热更，其余灰区。
+*/
+function judgeDelivery(diff, ctx, opts) {
+	const evidence = [];
+	let hasNative = false;
+	let hasUncertain = false;
+	let hasJs = false;
+	if (diff.length === 0) return {
+		recommendation: "uncertain",
+		confidence: "low",
+		evidence: [{
+			path: "（无 diff）",
+			rule: "锚点缺失或无变更",
+			note: "无锚点 tag 时无法判定，请人工确认"
+		}]
+	};
+	for (const file of diff) {
+		const verdict = classifyPath(file, opts);
+		if (verdict.kind === "dep-analysis") {
+			const changed = changedPackages(ctx.cwd, ctx.anchor);
+			if (changed === null) {
+				evidence.push({
+					path: file,
+					rule: "依赖变更（无锚点）",
+					note: "无法对比，请人工确认"
+				});
+				hasUncertain = true;
+				continue;
+			}
+			if (changed.length === 0) {
+				evidence.push({
+					path: file,
+					rule: "构建/身份配置",
+					note: "依赖未变（仅元数据），保守判原生"
+				});
+				hasNative = true;
+				continue;
+			}
+			const signals = changed.map((n) => ({
+				name: n,
+				signal: hasNativeSignal(ctx.cwd, n)
+			}));
+			const nativePkgs = signals.filter((s) => s.signal === true).map((s) => s.name);
+			const unknownPkgs = signals.filter((s) => s.signal === null).map((s) => s.name);
+			const jsOnly = signals.filter((s) => s.signal === false).map((s) => s.name);
+			if (nativePkgs.length > 0) {
+				evidence.push({
+					path: file,
+					rule: "依赖变更（含原生包）",
+					note: `原生：${nativePkgs.join(", ")}`
+				});
+				hasNative = true;
+			} else if (unknownPkgs.length > 0) {
+				evidence.push({
+					path: file,
+					rule: "依赖变更（未安装，无法检测）",
+					note: `请先安装依赖再判定：${unknownPkgs.join(", ")}`
+				});
+				hasUncertain = true;
+			} else {
+				evidence.push({
+					path: file,
+					rule: "依赖变更（纯 JS 包）",
+					note: `纯 JS：${jsOnly.join(", ")}`
+				});
+				hasJs = true;
+			}
+			continue;
+		}
+		evidence.push({
+			path: file,
+			rule: verdict.rule,
+			note: verdict.note ?? ""
+		});
+		if (verdict.kind === "native") hasNative = true;
+		else if (verdict.kind === "uncertain") hasUncertain = true;
+		else hasJs = true;
+	}
+	if (hasNative) return {
+		recommendation: "native",
+		confidence: "high",
+		evidence
+	};
+	if (hasUncertain) return {
+		recommendation: "uncertain",
+		confidence: "medium",
+		evidence
+	};
+	return {
+		recommendation: "ota",
+		confidence: hasJs ? "high" : "low",
+		evidence
+	};
+}
+/** pushy 官方测试包约定：与正式同源码、仅版本号偏移（major+1000，如 1.6.0→1001.6.0） */
+const TEST_VERSION_OFFSET = 1e3;
+/** 生成测试包偏移版本号（major+1000）；非数字开头版本号无法偏移，显式报错 */
+function testPackageVersion(versionName) {
+	const m = /^(\d+)(\..+)?$/.exec(versionName);
+	if (!m) throw new Error(`versionName「${versionName}」非 X.Y.Z 形态，无法按 major+${TEST_VERSION_OFFSET} 生成测试包偏移版本`);
+	return `${Number(m[1]) + TEST_VERSION_OFFSET}${m[2] ?? ""}`;
+}
+function platformAppId(opts, platform) {
+	const id = opts[platform];
+	if (typeof id !== "number") throw new Error(`平台 ${platform} 未配置热更 app 记录：rnUpdate({ ${platform}: <appId> })（在 applift.config.ts 的插件参数里声明）`);
+	return id;
+}
+/** 当前 versionName（readProjectVersions 按 framework 定位工程文件） */
+function currentVersionName(ctx) {
+	const v = readProjectVersions(ctx.cwd, ctx.framework).find((x) => x.platform === ctx.platform);
+	if (!v?.versionName) throw new Error(`未读到平台 ${ctx.platform} 的 versionName（readProjectVersions 无该平台版本文件）`);
+	return v.versionName;
+}
+/** 服务端取号：该 versionName 下已有热更名 {ver}-patch.N 的最大 N → next = N+1（首版 N=0 → 1） */
+function nextPatchNumber(names, versionName) {
+	const re = new RegExp(`^${versionName.replace(/\./g, "\\.")}-patch\\.(\\d+)$`);
+	let max = 0;
+	for (const { name } of names) {
+		const m = name.match(re);
+		if (m) max = Math.max(max, Number(m[1]));
+	}
+	return max + 1;
+}
+/** provider 构造（cli 注入点：测试 mock / 将来直连 API） */
+function makeRnUpdateProvider(opts, cli = createPushyCli()) {
+	return {
+		id: "rn-update",
+		frameworks: ["rn"],
+		platforms: [
+			"harmony",
+			"android",
+			"ios"
+		].filter((k) => typeof opts[k] === "number"),
+		judge: (diff, ctx) => judgeDelivery(diff, ctx, opts),
+		async publishToTest(ctx) {
+			const appId = platformAppId(opts, ctx.platform);
+			const versionName = currentVersionName(ctx);
+			const name = `${versionName}-patch.${nextPatchNumber(await cli.versions(appId), versionName)}`;
+			const ppk = await cli.bundle(ctx.platform, ctx.cwd);
+			return {
+				versionName: name,
+				versionId: (await cli.publish({
+					appId,
+					ppk,
+					platform: ctx.platform,
+					name,
+					description: ctx.note,
+					packageVersion: testPackageVersion(versionName)
+				})).versionId
+			};
+		},
+		async promoteToProd(ctx) {
+			const appId = platformAppId(opts, ctx.platform);
+			const versionName = currentVersionName(ctx);
+			const existing = await cli.versions(appId);
+			const latest = existing.map((v) => {
+				const m = v.name.match(new RegExp(`^${versionName.replace(/\./g, "\\.")}-patch\\.(\\d+)$`));
+				return m ? {
+					...v,
+					n: Number(m[1])
+				} : null;
+			}).filter((x) => x !== null).sort((a, b) => b.n - a.n)[0];
+			if (!latest) {
+				const patchNames = existing.map((v) => v.name).filter((n) => /-patch\.\d+$/.test(n)).slice(0, 5);
+				throw new Error(`测试通道没有 ${versionName}-patch.N 热更版本可供 promote${patchNames.length > 0 ? `（现存：${patchNames.join(", ")}${existing.length > 5 ? " …" : ""}）` : ""}：先 applift beta 发布测试热更并验证`);
+			}
+			const rollout = ctx.rollout ?? opts.defaultRollout;
+			await cli.rebind({
+				appId,
+				versionId: latest.id,
+				packageVersion: versionName,
+				rollout
+			});
+			return {
+				versionName: latest.name,
+				...rollout !== void 0 ? { rollout } : {}
+			};
+		}
+	};
+}
+/** 渠道 → 平台映射（热更已接入的平台；基线上传按此路由） */
+const CHANNEL_PLATFORM = { agc: "harmony" };
+/** rnUpdate 插件工厂：注册完整 provider（判定 + 测试发布 + promote）+ 原生发版自动基线。
+*  cli 注入点：测试 mock / 将来进程内直连 API。 */
+function rnUpdate(opts = {}, cli = createPushyCli()) {
+	const provider = makeRnUpdateProvider(opts, cli);
+	return {
+		name: "rn-update",
+		"update:register"(providers) {
+			providers.push(provider);
+		},
+		async "stage:after"(result) {
+			const platform = CHANNEL_PLATFORM[result.channel];
+			if (!result.ok || !platform || !result.artifactPath) return;
+			const appId = opts[platform];
+			if (typeof appId !== "number") return;
+			try {
+				await cli.uploadApp(appId, result.artifactPath);
+			} catch (e) {
+				process.stderr.write(`⚠ pushy 基线上传失败（请人工补传）：${e.message}\n`);
+			}
+		}
+	};
+}
+//#endregion
+export { createPushyCli, dingtalkNotify, electronAdapter, electronFramework, flutterAdapter, flutterFramework, judgeDelivery, knownFrameworkAdapters, makeRnUpdateProvider, nativeAndroidAdapter, nativeAndroidFramework, nativeHarmonyAdapter, nativeHarmonyFramework, nativeIosAdapter, nativeIosFramework, rnAdapter, rnFramework, rnUpdate, spawnPushy, suggestFramework, tauriAdapter, tauriFramework };