@napuketto/loader 0.0.14 → 0.0.15

package/dist/host/self-host.cjs

@@ -25,6 +25,7 @@ let node_path = require("node:path");
 let node_process = require("node:process");
 node_process = __toESM(node_process, 1);
 let node_os = require("node:os");
+let zod = require("zod");
 let node_readline = require("node:readline");
 //#region src/instance-lock.ts
 /**
@@ -459,20 +460,156 @@ function errorCodeOf(err) {
 	}
 	return "UNKNOWN";
 }
-//#endregion
-//#region src/host/ipc/ipc-types.ts
-/** 消息类型集合（解码校验用）。 */
-const IPC_MESSAGE_TYPES = /* @__PURE__ */ new Set([
-	"status",
-	"login",
-	"qr",
-	"event",
-	"result",
-	"log",
-	"ping",
-	"pong",
-	"action",
-	"control"
+/** 引导阶段（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/host/ipc/ipc-sender.ts
@@ -615,22 +752,18 @@ function attachIpcServices(actions, services) {
 /**
 * ipc-codec.ts：IPC 消息编解码（JSON 行协议，与 koishi 插件侧 src/ipc/codec.ts 对齐）。
 *
-* 每行一条 JSON 消息，`\n` 结尾。解码宽松：非法行 / 空行 / v 不匹配 /
-* 未知 type → null，调用方忽略，不崩通道。
+* 每行一条 JSON 消息，`\n` 结尾。解码用 IpcMessageSchema.safeParse 校验：
+* 非法行 / 空行 / v 不匹配 / type 未知 / payload 形状非法 → null，调用方忽略，
+* 不崩通道。
 */
-/** 类型守卫：v 匹配 + type 合法。 */
-function isIpcMessage(value) {
-	if (typeof value !== "object" || value === null) return false;
-	const record = value;
-	return record["v"] === 1 && typeof record["type"] === "string" && IPC_MESSAGE_TYPES.has(record["type"]);
-}
-/** 解码一行 JSON；非法行/空行返回 null。 */
+/** 解码一行 JSON；非法行/空行/形状不合法返回 null。 */
 function decodeIpcMessage(line) {
 	const trimmed = line.trim();
 	if (trimmed === "") return null;
 	try {
 		const parsed = JSON.parse(trimmed);
-		return isIpcMessage(parsed) ? parsed : null;
+		const result = IpcMessageSchema.safeParse(parsed);
+		return result.success ? result.data : null;
 	} catch {
 		return null;
 	}

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 根治「多实例抢数据目录锁挂起」）
@@ -909,6 +1075,17 @@ async function ensureQqFiles(options = {}) {
 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;