@napuketto/loader 0.0.13 → 0.0.15

package/dist/index.cjs

@@ -21,6 +21,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	enumerable: true
 }) : target, mod));
 //#endregion
+let zod = require("zod");
 let node_fs = require("node:fs");
 let node_path = require("node:path");
 let node_process = require("node:process");
@@ -30,6 +31,171 @@ let node_url = require("node:url");
 let node_fs_promises = require("node:fs/promises");
 let node_crypto = require("node:crypto");
 let node_https = require("node:https");
+//#region src/host/ipc/ipc-types.ts
+/**
+* ipc-types.ts：IPC 协议消息（koishi 插件 ↔ self-host 子进程，单一来源）。
+*
+* 协议契约（koishi 插件 design.md §5.6）：`{ v, type, id?, payload }` JSON 行。
+* 用 zod v4 定义单一 schema，两侧（loader host + koishi 插件）import 同一份：
+* 类型经 z.infer 派生、运行时经 safeParse 校验，消除「两份手写 types.ts」漂移。
+*
+* 领域字段（LoginState / SelfInfo / QrCodeData）与 kernel 同名类型结构等价，
+* 在协议边界内联为 zod schema（kernel 不依赖 zod，故不在 kernel 定义）。
+*/
+/** IPC 协议版本（解码校验）。 */
+const IPC_VERSION = 1;
+/** 引导阶段（status 消息）。 */
+const IpcBootPhaseSchema = zod.z.enum([
+	"booting",
+	"dlopening",
+	"logging",
+	"sessioning",
+	"ready",
+	"failed"
+]);
+/** 结构化日志级别（pino level）。 */
+const IpcLogLevelSchema = zod.z.enum([
+	"trace",
+	"debug",
+	"info",
+	"warn",
+	"error",
+	"fatal"
+]);
+/** 登录状态（与 kernel LoginState 结构等价）。 */
+const LoginStateSchema = zod.z.enum([
+	"idle",
+	"waiting_scan",
+	"scanned",
+	"logged_in",
+	"failed"
+]);
+/** selfInfo（与 kernel SelfInfo 结构等价）。 */
+const SelfInfoSchema = zod.z.object({
+	uin: zod.z.string(),
+	uid: zod.z.string(),
+	nick: zod.z.string()
+});
+/** status 消息 payload。 */
+const IpcStatusPayloadSchema = zod.z.object({
+	phase: IpcBootPhaseSchema,
+	message: zod.z.string().optional(),
+	error: zod.z.object({
+		code: zod.z.string(),
+		message: zod.z.string()
+	}).optional()
+});
+/** login 消息 payload。 */
+const IpcLoginPayloadSchema = zod.z.object({
+	state: LoginStateSchema,
+	selfInfo: SelfInfoSchema.optional(),
+	/** 失败原因（state=failed 时；如「登录超时，请刷新页面重试」）。 */
+	message: zod.z.string().optional()
+});
+/** event 消息 payload（kernel 事件通道形状，翻译层按 service/name 断言具体类型）。 */
+const IpcEventPayloadSchema = zod.z.object({
+	service: zod.z.string(),
+	name: zod.z.string(),
+	args: zod.z.array(zod.z.unknown())
+});
+/** log 消息 payload。 */
+const IpcLogPayloadSchema = zod.z.object({
+	level: IpcLogLevelSchema,
+	message: zod.z.string()
+});
+/** 动作响应 payload（result 消息）。 */
+const IpcResultPayloadSchema = zod.z.union([zod.z.object({
+	ok: zod.z.literal(true),
+	value: zod.z.unknown().optional()
+}), zod.z.object({
+	ok: zod.z.literal(false),
+	error: zod.z.object({
+		code: zod.z.string(),
+		message: zod.z.string()
+	})
+})]);
+/** 动作请求 payload（action 消息）。 */
+const IpcActionPayloadSchema = zod.z.object({
+	action: zod.z.string(),
+	params: zod.z.record(zod.z.string(), zod.z.unknown()).optional()
+});
+/** 控制指令 payload（control 消息，父→子）。 */
+const IpcControlPayloadSchema = zod.z.union([
+	zod.z.object({ command: zod.z.literal("stop") }),
+	zod.z.object({ command: zod.z.literal("restart") }),
+	zod.z.object({
+		command: zod.z.literal("login"),
+		uin: zod.z.string().optional(),
+		qr: zod.z.boolean().optional()
+	})
+]);
+const IpcStatusMessageSchema = zod.z.object({
+	v: zod.z.literal(1),
+	type: zod.z.literal("status"),
+	payload: IpcStatusPayloadSchema
+});
+const IpcLoginMessageSchema = zod.z.object({
+	v: zod.z.literal(1),
+	type: zod.z.literal("login"),
+	payload: IpcLoginPayloadSchema
+});
+const IpcQrMessageSchema = zod.z.object({
+	v: zod.z.literal(1),
+	type: zod.z.literal("qr"),
+	payload: zod.z.object({
+		pngBase64: zod.z.string(),
+		qrcodeUrl: zod.z.string()
+	})
+});
+const IpcEventMessageSchema = zod.z.object({
+	v: zod.z.literal(1),
+	type: zod.z.literal("event"),
+	payload: IpcEventPayloadSchema
+});
+const IpcResultMessageSchema = zod.z.object({
+	v: zod.z.literal(1),
+	type: zod.z.literal("result"),
+	id: zod.z.number(),
+	payload: IpcResultPayloadSchema
+});
+const IpcLogMessageSchema = zod.z.object({
+	v: zod.z.literal(1),
+	type: zod.z.literal("log"),
+	payload: IpcLogPayloadSchema
+});
+const IpcPingMessageSchema = zod.z.object({
+	v: zod.z.literal(1),
+	type: zod.z.literal("ping")
+});
+const IpcPongMessageSchema = zod.z.object({
+	v: zod.z.literal(1),
+	type: zod.z.literal("pong")
+});
+const IpcActionMessageSchema = zod.z.object({
+	v: zod.z.literal(1),
+	type: zod.z.literal("action"),
+	id: zod.z.number(),
+	payload: IpcActionPayloadSchema
+});
+const IpcControlMessageSchema = zod.z.object({
+	v: zod.z.literal(1),
+	type: zod.z.literal("control"),
+	payload: IpcControlPayloadSchema
+});
+/** IPC 消息判别联合（协议边界，运行时经 safeParse 校验）。 */
+const IpcMessageSchema = zod.z.discriminatedUnion("type", [
+	IpcStatusMessageSchema,
+	IpcLoginMessageSchema,
+	IpcQrMessageSchema,
+	IpcEventMessageSchema,
+	IpcResultMessageSchema,
+	IpcLogMessageSchema,
+	IpcPingMessageSchema,
+	IpcPongMessageSchema,
+	IpcActionMessageSchema,
+	IpcControlMessageSchema
+]);
+//#endregion
 //#region src/instance-lock.ts
 /**
 * instance-lock.ts：单实例锁（2026-08-07 根治「多实例抢数据目录锁挂起」）
@@ -134,6 +300,34 @@ function registerLockCleanup(dataDir) {
 	});
 }
 //#endregion
+//#region src/data-root.ts
+/**
+* data-root.ts：轻量数据根解析（loader 侧，避免新增 kernel 依赖）。
+*
+* 从 locate-qq.ts / win-node.ts 抽出的同构逻辑（2026-08 消重：两处
+* 22 行重复 resolveDataRoot + findProjectRoot）。
+*
+* 优先级：显式参数 > NAPKETTO_DATA > 项目根/.napuketto > cwd 兜底。
+* P2 若需完整语义（同 kernel resolveDataRoot）再切换。
+*/
+/** 解析数据根（NAPKETTO_DATA 显式 > 项目根/.napuketto > cwd 兜底）。 */
+function resolveDataRoot(dataRoot) {
+	const explicit = dataRoot ?? node_process.default.env["NAPKETTO_DATA"];
+	if (explicit !== void 0 && explicit !== "") return (0, node_path.resolve)(explicit);
+	const projectRoot = findProjectRoot(node_process.default.cwd()) ?? node_process.default.cwd();
+	return (0, node_path.join)(projectRoot, ".napuketto");
+}
+/** 向上探测项目根（含 pnpm-workspace.yaml 或 package.json 的目录）。 */
+function findProjectRoot(start) {
+	let dir = (0, node_path.resolve)(start);
+	for (;;) {
+		if ((0, node_fs.existsSync)((0, node_path.join)(dir, "pnpm-workspace.yaml")) || (0, node_fs.existsSync)((0, node_path.join)(dir, "package.json"))) return dir;
+		const parent = (0, node_path.dirname)(dir);
+		if (parent === dir) return null;
+		dir = parent;
+	}
+}
+//#endregion
 //#region src/qq-download.ts
 /**
 * qq-download.ts：QQ 官方安装包下载器（P1）。
@@ -257,8 +451,8 @@ async function downloadFile(options) {
 const EXTRACT_EXTENSIONS = /* @__PURE__ */ new Set([".node", ".dll"]);
 /**
 * 探测 7z 可执行文件：
-*   NAPUTO_7Z_PATH 环境变量 > 内置资产（assets/7zip/7z.exe，Windows）> 系统 PATH 7z。
-* Linux 上用 p7zip 提供的 7z 命令（系统 PATH）。
+*   NAPUTO_7Z_PATH 环境变量 > 内置资产（Windows assets/7zip/7z.exe、Linux
+*   assets/7zip/7zz——2026-08-14 治本，静态二进制已打进发布包）> 系统 PATH 7z。
 */
 function findSevenZip() {
 	const envPath = node_process.default.env["NAPUTO_7Z_PATH"];
@@ -266,8 +460,9 @@ function findSevenZip() {
 		exe: envPath,
 		source: "环境变量 NAPUTO_7Z_PATH"
 	};
-	if (node_process.default.platform === "win32") {
-		const bundled = (0, node_path.join)((0, node_path.dirname)((0, node_url.fileURLToPath)(require("url").pathToFileURL(__filename).href)), "..", "assets", "7zip", "7z.exe");
+	if (node_process.default.platform === "win32" || node_process.default.platform === "linux") {
+		const exeName = node_process.default.platform === "win32" ? "7z.exe" : "7zz";
+		const bundled = (0, node_path.join)((0, node_path.dirname)((0, node_url.fileURLToPath)(require("url").pathToFileURL(__filename).href)), "..", "assets", "7zip", exeName);
 		if ((0, node_fs.existsSync)(bundled)) return {
 			exe: bundled,
 			source: "内置资产 assets/7zip"
@@ -410,23 +605,6 @@ async function unzipNode(zipPath, cacheDir) {
 }
 /** 默认 Windows node 版本（latest v24，LTS 线；可被环境变量/参数覆盖）。 */
 const DEFAULT_WIN_NODE_VERSION = "v24.16.0";
-/** 轻量数据根解析（与 locate-qq 内同构，避免循环依赖）。 */
-function resolveDataRoot(dataRoot) {
-	const explicit = dataRoot ?? node_process.default.env["NAPKETTO_DATA"];
-	if (explicit !== void 0 && explicit !== "") return (0, node_path.resolve)(explicit);
-	const projectRoot = findProjectRoot$1(node_process.default.cwd()) ?? node_process.default.cwd();
-	return (0, node_path.join)(projectRoot, ".napuketto");
-}
-/** 向上探测项目根（含 pnpm-workspace.yaml 或 package.json 的目录）。 */
-function findProjectRoot$1(start) {
-	let dir = (0, node_path.resolve)(start);
-	for (;;) {
-		if ((0, node_fs.existsSync)((0, node_path.join)(dir, "pnpm-workspace.yaml")) || (0, node_fs.existsSync)((0, node_path.join)(dir, "package.json"))) return dir;
-		const parent = (0, node_path.dirname)(dir);
-		if (parent === dir) return null;
-		dir = parent;
-	}
-}
 //#endregion
 //#region src/wine.ts
 /**
@@ -680,8 +858,8 @@ function resolveDownloadUrl(release) {
 */
 /** 数据根下 QQ 文件缓存目录名（<数据根>/qq-files/<版本>/，P1 下载解包产物）。 */
 const QQ_FILES_DIR_NAME = "qq-files";
-/** 7-Zip 官方 Linux 版版本号（tar.xz 文件名组成部分，2026-08-14 起自动下载）。 */
-const SEVEN_ZIP_LINUX_VERSION = "2409";
+/** 7-Zip 官方 Linux 版版本号（tar.xz 文件名组成部分；兜底下载用，内置资产优先）。 */
+const SEVEN_ZIP_LINUX_VERSION = "2501";
 /** 注册表 UninstallString 查询（QQ 官方安装路径）。 */
 const REG_QUERY_RE = /"([^"]+)"/;
 /** Windows 盘符路径正则（`C:/...` / `C:\...`，wslMappedPath 映射用，模块级常量）。 */
@@ -775,7 +953,7 @@ async function resolveQqFiles(options = {}) {
 	try {
 		return resolveQqInstall();
 	} catch {}
-	const dataRoot = resolveDataRootLight(options.dataRoot);
+	const dataRoot = resolveDataRoot(options.dataRoot);
 	const cached = tryResolveCached(dataRoot);
 	if (cached !== null) return cached;
 	if (options.autoDownload !== false) return ensureQqFiles({
@@ -802,17 +980,25 @@ function linuxSevenZipUrl() {
 	return node_process.default.env["NAPUTO_7Z_URL"] ?? `https://www.7-zip.org/a/7z${SEVEN_ZIP_LINUX_VERSION}-linux-x64.tar.xz`;
 }
 /**
-* 确保 Linux 7zz 就绪（2026-08-14 生产修复）：自动下载 7-Zip 官方 Linux 版。
+* 确保 Linux 7zz 就绪（治本：内置资产优先，下载兜底）。
 *
-* 背景：内置 assets/7zip 的 7z.exe 是 Windows PE（Linux 不可用），此前 Linux 依赖
-* 系统 p7zip-full——生产环境未安装 → `7z 解包失败: No such file or directory`。
-* 7zz 是 7-Zip 完整版（支持 NSIS 解包，同 7z.exe 能力），官方静态二进制，
-* 免 root 免系统包，下载到 <数据根>/runtime/7zip/7zz（与 win-node 同模式）。
+* 优先级：内置资产 assets/7zip/7zz（2026-08-14 治本——与 Windows 7z.exe 同模式，
+* 7zz 静态二进制已打进发布包，LGPL 合规可分发，零运行时下载）> 数据根缓存
+* runtime/7zip/7zz（历史下载产物复用）> 官网下载（兜底，NAPUTO_7Z_URL 可覆盖）。
 *
-* 幂等：缓存已存在直接返回；tar -xJf 解压（Linux 自带 tar；需 xz-utils）。
+* 背景：7-Zip 官网只保留最新版 tar.xz，硬编码旧版本号（如 2409）会被删档 404，
+* 运行时下载既脆弱又依赖外网。内置资产彻底消灭该依赖。
 */
 async function ensureLinuxSevenZip(options = {}) {
-	const dataRoot = resolveDataRootLight(options.dataRoot);
+	const bundled = (0, node_path.join)((0, node_path.dirname)((0, node_url.fileURLToPath)(require("url").pathToFileURL(__filename).href)), "..", "assets", "7zip", "7zz");
+	if ((0, node_fs.existsSync)(bundled)) {
+		await (0, node_fs_promises.chmod)(bundled, 493).catch(() => {});
+		return {
+			exe: bundled,
+			source: "内置资产 assets/7zip"
+		};
+	}
+	const dataRoot = resolveDataRoot(options.dataRoot);
 	const cacheDir = (0, node_path.join)(dataRoot, "runtime", "7zip");
 	const exe = (0, node_path.join)(cacheDir, "7zz");
 	if ((0, node_fs.existsSync)(exe)) return {
@@ -852,7 +1038,7 @@ async function ensureLinuxSevenZip(options = {}) {
 * → 7z 解包 → 提取 wrapper.node/QQNT.dll → 缓存。返回缓存版本 QqInstallInfo。
 */
 async function ensureQqFiles(options = {}) {
-	const dataRoot = resolveDataRootLight(options.dataRoot);
+	const dataRoot = resolveDataRoot(options.dataRoot);
 	const cacheRoot = (0, node_path.join)(dataRoot, QQ_FILES_DIR_NAME);
 	(0, node_fs.mkdirSync)(cacheRoot, { recursive: true });
 	const existing = tryResolveCached(dataRoot);
@@ -885,30 +1071,21 @@ async function ensureQqFiles(options = {}) {
 		});
 	}
 }
-/**
-* 轻量数据根解析（loader 侧，避免新增 kernel 依赖；P2 若需完整语义再切换）。
-* 优先级：显式参数 > NAPKETTO_DATA > 项目根/.napuketto > cwd 兜底。
-*/
-function resolveDataRootLight(dataRoot) {
-	const explicit = dataRoot ?? node_process.default.env["NAPKETTO_DATA"];
-	if (explicit !== void 0 && explicit !== "") return (0, node_path.resolve)(explicit);
-	const projectRoot = findProjectRoot(node_process.default.cwd()) ?? node_process.default.cwd();
-	return (0, node_path.join)(projectRoot, ".napuketto");
-}
-/** 向上探测项目根（含 pnpm-workspace.yaml 或 package.json 的目录）。 */
-function findProjectRoot(start) {
-	let dir = (0, node_path.resolve)(start);
-	for (;;) {
-		if ((0, node_fs.existsSync)((0, node_path.join)(dir, "pnpm-workspace.yaml")) || (0, node_fs.existsSync)((0, node_path.join)(dir, "package.json"))) return dir;
-		const parent = (0, node_path.dirname)(dir);
-		if (parent === dir) return null;
-		dir = parent;
-	}
-}
 //#endregion
 exports.DownloadError = DownloadError;
 exports.ENV = ENV;
 exports.INSTANCE_LOCK_FILE = INSTANCE_LOCK_FILE;
+exports.IPC_VERSION = IPC_VERSION;
+exports.IpcActionPayloadSchema = IpcActionPayloadSchema;
+exports.IpcBootPhaseSchema = IpcBootPhaseSchema;
+exports.IpcControlPayloadSchema = IpcControlPayloadSchema;
+exports.IpcEventPayloadSchema = IpcEventPayloadSchema;
+exports.IpcLogLevelSchema = IpcLogLevelSchema;
+exports.IpcLogPayloadSchema = IpcLogPayloadSchema;
+exports.IpcLoginPayloadSchema = IpcLoginPayloadSchema;
+exports.IpcMessageSchema = IpcMessageSchema;
+exports.IpcResultPayloadSchema = IpcResultPayloadSchema;
+exports.IpcStatusPayloadSchema = IpcStatusPayloadSchema;
 exports.QQ_FILES_DIR_NAME = QQ_FILES_DIR_NAME;
 exports.QqReleasesError = QqReleasesError;
 exports.WIN_NODE_DIR_NAME = WIN_NODE_DIR_NAME;