@napuketto/loader 0.0.13 → 0.0.15

package/dist/index.mjs

@@ -1,3 +1,4 @@
+import { z } from "zod";
 import { createWriteStream, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
 import process$1 from "node:process";
@@ -6,6 +7,171 @@ import { fileURLToPath } from "node:url";
 import { chmod, copyFile, mkdir, readdir, rm } from "node:fs/promises";
 import { createHash } from "node:crypto";
 import { get } from "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 = z.enum([
+	"booting",
+	"dlopening",
+	"logging",
+	"sessioning",
+	"ready",
+	"failed"
+]);
+/** 结构化日志级别（pino level）。 */
+const IpcLogLevelSchema = z.enum([
+	"trace",
+	"debug",
+	"info",
+	"warn",
+	"error",
+	"fatal"
+]);
+/** 登录状态（与 kernel LoginState 结构等价）。 */
+const LoginStateSchema = z.enum([
+	"idle",
+	"waiting_scan",
+	"scanned",
+	"logged_in",
+	"failed"
+]);
+/** selfInfo（与 kernel SelfInfo 结构等价）。 */
+const SelfInfoSchema = z.object({
+	uin: z.string(),
+	uid: z.string(),
+	nick: z.string()
+});
+/** status 消息 payload。 */
+const IpcStatusPayloadSchema = z.object({
+	phase: IpcBootPhaseSchema,
+	message: z.string().optional(),
+	error: z.object({
+		code: z.string(),
+		message: z.string()
+	}).optional()
+});
+/** login 消息 payload。 */
+const IpcLoginPayloadSchema = z.object({
+	state: LoginStateSchema,
+	selfInfo: SelfInfoSchema.optional(),
+	/** 失败原因（state=failed 时；如「登录超时，请刷新页面重试」）。 */
+	message: z.string().optional()
+});
+/** event 消息 payload（kernel 事件通道形状，翻译层按 service/name 断言具体类型）。 */
+const IpcEventPayloadSchema = z.object({
+	service: z.string(),
+	name: z.string(),
+	args: z.array(z.unknown())
+});
+/** log 消息 payload。 */
+const IpcLogPayloadSchema = z.object({
+	level: IpcLogLevelSchema,
+	message: z.string()
+});
+/** 动作响应 payload（result 消息）。 */
+const IpcResultPayloadSchema = z.union([z.object({
+	ok: z.literal(true),
+	value: z.unknown().optional()
+}), z.object({
+	ok: z.literal(false),
+	error: z.object({
+		code: z.string(),
+		message: z.string()
+	})
+})]);
+/** 动作请求 payload（action 消息）。 */
+const IpcActionPayloadSchema = z.object({
+	action: z.string(),
+	params: z.record(z.string(), z.unknown()).optional()
+});
+/** 控制指令 payload（control 消息，父→子）。 */
+const IpcControlPayloadSchema = z.union([
+	z.object({ command: z.literal("stop") }),
+	z.object({ command: z.literal("restart") }),
+	z.object({
+		command: z.literal("login"),
+		uin: z.string().optional(),
+		qr: z.boolean().optional()
+	})
+]);
+const IpcStatusMessageSchema = z.object({
+	v: z.literal(1),
+	type: z.literal("status"),
+	payload: IpcStatusPayloadSchema
+});
+const IpcLoginMessageSchema = z.object({
+	v: z.literal(1),
+	type: z.literal("login"),
+	payload: IpcLoginPayloadSchema
+});
+const IpcQrMessageSchema = z.object({
+	v: z.literal(1),
+	type: z.literal("qr"),
+	payload: z.object({
+		pngBase64: z.string(),
+		qrcodeUrl: z.string()
+	})
+});
+const IpcEventMessageSchema = z.object({
+	v: z.literal(1),
+	type: z.literal("event"),
+	payload: IpcEventPayloadSchema
+});
+const IpcResultMessageSchema = z.object({
+	v: z.literal(1),
+	type: z.literal("result"),
+	id: z.number(),
+	payload: IpcResultPayloadSchema
+});
+const IpcLogMessageSchema = z.object({
+	v: z.literal(1),
+	type: z.literal("log"),
+	payload: IpcLogPayloadSchema
+});
+const IpcPingMessageSchema = z.object({
+	v: z.literal(1),
+	type: z.literal("ping")
+});
+const IpcPongMessageSchema = z.object({
+	v: z.literal(1),
+	type: z.literal("pong")
+});
+const IpcActionMessageSchema = z.object({
+	v: z.literal(1),
+	type: z.literal("action"),
+	id: z.number(),
+	payload: IpcActionPayloadSchema
+});
+const IpcControlMessageSchema = z.object({
+	v: z.literal(1),
+	type: z.literal("control"),
+	payload: IpcControlPayloadSchema
+});
+/** IPC 消息判别联合（协议边界，运行时经 safeParse 校验）。 */
+const IpcMessageSchema = 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 根治「多实例抢数据目录锁挂起」）
@@ -110,6 +276,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 ?? process$1.env["NAPKETTO_DATA"];
+	if (explicit !== void 0 && explicit !== "") return resolve(explicit);
+	const projectRoot = findProjectRoot(process$1.cwd()) ?? process$1.cwd();
+	return join(projectRoot, ".napuketto");
+}
+/** 向上探测项目根（含 pnpm-workspace.yaml 或 package.json 的目录）。 */
+function findProjectRoot(start) {
+	let dir = resolve(start);
+	for (;;) {
+		if (existsSync(join(dir, "pnpm-workspace.yaml")) || existsSync(join(dir, "package.json"))) return dir;
+		const parent = dirname(dir);
+		if (parent === dir) return null;
+		dir = parent;
+	}
+}
+//#endregion
 //#region src/qq-download.ts
 /**
 * qq-download.ts：QQ 官方安装包下载器（P1）。
@@ -233,8 +427,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 = process$1.env["NAPUTO_7Z_PATH"];
@@ -242,8 +436,9 @@ function findSevenZip() {
 		exe: envPath,
 		source: "环境变量 NAPUTO_7Z_PATH"
 	};
-	if (process$1.platform === "win32") {
-		const bundled = join(dirname(fileURLToPath(import.meta.url)), "..", "assets", "7zip", "7z.exe");
+	if (process$1.platform === "win32" || process$1.platform === "linux") {
+		const exeName = process$1.platform === "win32" ? "7z.exe" : "7zz";
+		const bundled = join(dirname(fileURLToPath(import.meta.url)), "..", "assets", "7zip", exeName);
 		if (existsSync(bundled)) return {
 			exe: bundled,
 			source: "内置资产 assets/7zip"
@@ -386,23 +581,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 ?? process$1.env["NAPKETTO_DATA"];
-	if (explicit !== void 0 && explicit !== "") return resolve(explicit);
-	const projectRoot = findProjectRoot$1(process$1.cwd()) ?? process$1.cwd();
-	return join(projectRoot, ".napuketto");
-}
-/** 向上探测项目根（含 pnpm-workspace.yaml 或 package.json 的目录）。 */
-function findProjectRoot$1(start) {
-	let dir = resolve(start);
-	for (;;) {
-		if (existsSync(join(dir, "pnpm-workspace.yaml")) || existsSync(join(dir, "package.json"))) return dir;
-		const parent = dirname(dir);
-		if (parent === dir) return null;
-		dir = parent;
-	}
-}
 //#endregion
 //#region src/wine.ts
 /**
@@ -656,8 +834,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 映射用，模块级常量）。 */
@@ -751,7 +929,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({
@@ -778,17 +956,25 @@ function linuxSevenZipUrl() {
 	return process$1.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 = join(dirname(fileURLToPath(import.meta.url)), "..", "assets", "7zip", "7zz");
+	if (existsSync(bundled)) {
+		await chmod(bundled, 493).catch(() => {});
+		return {
+			exe: bundled,
+			source: "内置资产 assets/7zip"
+		};
+	}
+	const dataRoot = resolveDataRoot(options.dataRoot);
 	const cacheDir = join(dataRoot, "runtime", "7zip");
 	const exe = join(cacheDir, "7zz");
 	if (existsSync(exe)) return {
@@ -828,7 +1014,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 = join(dataRoot, QQ_FILES_DIR_NAME);
 	mkdirSync(cacheRoot, { recursive: true });
 	const existing = tryResolveCached(dataRoot);
@@ -861,27 +1047,7 @@ async function ensureQqFiles(options = {}) {
 		});
 	}
 }
-/**
-* 轻量数据根解析（loader 侧，避免新增 kernel 依赖；P2 若需完整语义再切换）。
-* 优先级：显式参数 > NAPKETTO_DATA > 项目根/.napuketto > cwd 兜底。
-*/
-function resolveDataRootLight(dataRoot) {
-	const explicit = dataRoot ?? process$1.env["NAPKETTO_DATA"];
-	if (explicit !== void 0 && explicit !== "") return resolve(explicit);
-	const projectRoot = findProjectRoot(process$1.cwd()) ?? process$1.cwd();
-	return join(projectRoot, ".napuketto");
-}
-/** 向上探测项目根（含 pnpm-workspace.yaml 或 package.json 的目录）。 */
-function findProjectRoot(start) {
-	let dir = resolve(start);
-	for (;;) {
-		if (existsSync(join(dir, "pnpm-workspace.yaml")) || existsSync(join(dir, "package.json"))) return dir;
-		const parent = dirname(dir);
-		if (parent === dir) return null;
-		dir = parent;
-	}
-}
 //#endregion
-export { DownloadError, ENV, INSTANCE_LOCK_FILE, QQ_FILES_DIR_NAME, QqReleasesError, WIN_NODE_DIR_NAME, acquireInstanceLock, buildSpawnCommand, checkInstanceLock, clearCacheVersion, defaultStubDir, downloadFile, ensureLinuxSevenZip, ensureQqFiles, ensureWinNode, extractInstaller, extractWrapperFiles, findSevenZip, isLinux, latestRelease, launchSelfHost, linuxSevenZipUrl, loadQqReleases, locateQqPath, nodeZipUrl, registerLockCleanup, releaseInstanceLock, resolveDownloadUrl, resolveQqFiles, resolveQqInstall, toWinePath, wineBinary };
+export { DownloadError, ENV, INSTANCE_LOCK_FILE, IPC_VERSION, IpcActionPayloadSchema, IpcBootPhaseSchema, IpcControlPayloadSchema, IpcEventPayloadSchema, IpcLogLevelSchema, IpcLogPayloadSchema, IpcLoginPayloadSchema, IpcMessageSchema, IpcResultPayloadSchema, IpcStatusPayloadSchema, QQ_FILES_DIR_NAME, QqReleasesError, WIN_NODE_DIR_NAME, acquireInstanceLock, buildSpawnCommand, checkInstanceLock, clearCacheVersion, defaultStubDir, downloadFile, ensureLinuxSevenZip, ensureQqFiles, ensureWinNode, extractInstaller, extractWrapperFiles, findSevenZip, isLinux, latestRelease, launchSelfHost, linuxSevenZipUrl, loadQqReleases, locateQqPath, nodeZipUrl, registerLockCleanup, releaseInstanceLock, resolveDownloadUrl, resolveQqFiles, resolveQqInstall, toWinePath, wineBinary };
 
 //# sourceMappingURL=index.mjs.map