@napuketto/loader 0.0.13 → 0.0.15

package/assets/7zip/License-linux.txt

@@ -0,0 +1,144 @@
+  7-Zip for Linux and macOS
+  ~~~~~~~~~~~~~~~~~~~~~~~~~
+  License for use and distribution
+  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+  7-Zip Copyright (C) 1999-2025 Igor Pavlov.
+
+  The licenses for 7zz and 7zzs files are:
+
+         - The "GNU LGPL" as main license for most of the code
+         - The "GNU LGPL" with "unRAR license restriction" for some code
+         - The "BSD 3-clause License" for some code
+         - The "BSD 2-clause License" for some code
+
+  Redistributions in binary form must reproduce related license information from this file.
+
+  Note:
+    You can use 7-Zip on any computer, including a computer in a commercial
+    organization. You don't need to register or pay for 7-Zip.
+
+
+GNU LGPL information
+--------------------
+
+    This library is free software; you can redistribute it and/or
+    modify it under the terms of the GNU Lesser General Public
+    License as published by the Free Software Foundation; either
+    version 2.1 of the License, or (at your option) any later version.
+
+    This library is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+    Lesser General Public License for more details.
+
+    You can receive a copy of the GNU Lesser General Public License from
+    http://www.gnu.org/
+
+
+
+
+BSD 3-clause License in 7-Zip code
+----------------------------------
+
+  The "BSD 3-clause License" is used for the following code in 7z.dll
+    1) LZFSE data decompression.
+       That code was derived from the code in the "LZFSE compression library" developed by Apple Inc,
+       that also uses the "BSD 3-clause License".
+    2) ZSTD data decompression.
+       that code was developed using original zstd decoder code as reference code.
+       The original zstd decoder code was developed by Facebook Inc,
+       that also uses the "BSD 3-clause License".
+
+  Copyright (c) 2015-2016, Apple Inc. All rights reserved.
+  Copyright (c) Facebook, Inc. All rights reserved.
+  Copyright (c) 2023-2024 Igor Pavlov.
+
+Text of the "BSD 3-clause License"
+----------------------------------
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its contributors may
+   be used to endorse or promote products derived from this software without
+   specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+---
+
+
+
+
+BSD 2-clause License in 7-Zip code
+----------------------------------
+
+  The "BSD 2-clause License" is used for the XXH64 code in 7-Zip.
+
+  XXH64 code in 7-Zip was derived from the original XXH64 code developed by Yann Collet.
+
+  Copyright (c) 2012-2021 Yann Collet.
+  Copyright (c) 2023-2024 Igor Pavlov.
+
+Text of the "BSD 2-clause License"
+----------------------------------
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+---
+
+
+
+
+unRAR license restriction
+-------------------------
+
+The decompression engine for RAR archives was developed using source
+code of unRAR program.
+All copyrights to original unRAR code are owned by Alexander Roshal.
+
+The license for original unRAR code has the following restriction:
+
+  The unRAR sources cannot be used to re-create the RAR compression algorithm,
+  which is proprietary. Distribution of modified unRAR sources in separate form
+  or as a part of other software is permitted, provided that it is clearly
+  stated in the documentation and source comments that the code may
+  not be used to develop a RAR (WinRAR) compatible archiver.
+
+--

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,29 +752,39 @@ 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;
 	}
 }
+//#endregion
+//#region src/host/ipc/ipc-server.ts
+/**
+* ipc-server.ts：IPC 服务端（self-host 子进程侧）。
+*
+* 职责（design.md §5.6 / §7）：
+*  - stdin readline 收 action / control / ping
+*  - action → 动作表执行 → result 响应（请求 id 匹配）
+*  - control stop/restart → 退出回调（默认 process.exit(0)，由驱动层重启）
+*  - ping → 自动回 pong
+*  - 心跳：定期发 ping（koishi 插件探活）
+*/
+/** 心跳间隔（毫秒）。 */
+const HEARTBEAT_INTERVAL_MS = 15e3;
 /** 启动 IPC 服务端（stdin 接收 + 心跳）。返回停止函数。 */
 function startIpcServer(options) {
-	const heartbeatMs = options.heartbeatMs ?? 15e3;
+	const heartbeatMs = options.heartbeatMs ?? HEARTBEAT_INTERVAL_MS;
 	const onExit = options.onExit ?? (() => process.exit(0));
 	const rl = (0, node_readline.createInterface)({
 		input: process.stdin,