@napuketto/kernel 0.0.8 → 0.0.10

package/dist/index.mjs

@@ -2590,6 +2590,8 @@ function startupSessionStart(ctx) {
 /** 二维码过期错误码（errType=1 errCode=3，实测）。 */
 const QR_EXPIRED_ERR_TYPE = 1;
 const QR_EXPIRED_ERR_CODE = 3;
+/** 登录超时提示（参考项目文案，前端 failed 态展示）。 */
+const QR_LOGIN_TIMEOUT_MESSAGE = "登录超时，请刷新页面重试";
 /** 二维码过期判定。 */
 function isQrCodeExpired(errType, errCode) {
 	return errType === QR_EXPIRED_ERR_TYPE && errCode === QR_EXPIRED_ERR_CODE;
@@ -2604,10 +2606,17 @@ var QrLoginSession = class {
 	self = null;
 	qrCodeHandlers = /* @__PURE__ */ new Set();
 	stateHandlers = /* @__PURE__ */ new Set();
-	constructor(loginService) {
+	/** 超时定时器（refresh 后启动，登录成功/失败/stop 清理）。 */
+	timeoutTimer = null;
+	/** 失败原因（超时等，failed 态透出给上层提示文案）。 */
+	failureReasonValue = null;
+	/** 超时上限（毫秒，默认 QR_LOGIN_TIMEOUT_MS）。 */
+	timeoutMs;
+	constructor(loginService, options = {}) {
 		const svc = loginService;
 		if (svc === null || typeof svc.addKernelLoginListener !== "function") throw kernelError("loginService 无效（缺 addKernelLoginListener）", "INVALID_STATE");
 		this.loginService = svc;
+		this.timeoutMs = options.timeoutMs ?? 12e4;
 	}
 	/** 当前状态。 */
 	get currentState() {
@@ -2617,6 +2626,10 @@ var QrLoginSession = class {
 	get selfInfo() {
 		return this.self;
 	}
+	/** 失败原因（超时等；failed 态透出给上层提示文案）。 */
+	get failureReason() {
+		return this.failureReasonValue;
+	}
 	/** 订阅二维码（png base64 + url）。返回退订函数。 */
 	onQrCode(cb) {
 		this.qrCodeHandlers.add(cb);
@@ -2632,15 +2645,19 @@ var QrLoginSession = class {
 		if (this.state !== "idle") return;
 		this.listenerId = this.loginService.addKernelLoginListener(this.buildListener());
 		this.loginService.connect();
-		if (opts.quickUin !== void 0 && opts.quickUin !== "") this.loginService.quickLoginWithUin(opts.quickUin).catch(() => {
+		if (opts.quickUin !== void 0 && opts.quickUin !== "") this.loginService.quickLoginWithUin(opts.quickUin).then((result) => {
+			if (result.loginErrorInfo.errMsg !== "") this.refresh();
+		}).catch(() => {
 			this.refresh();
 		});
 		else this.refresh();
 	}
-	/** 刷新二维码（手动 / 过期自动）。 */
+	/** 刷新二维码（手动 / 过期自动）。每次出码重启超时计时。 */
 	refresh() {
+		this.failureReasonValue = null;
 		this.setState("waiting_scan");
 		this.loginService.getQRCodePicture();
+		this.restartTimeout();
 	}
 	/** 构建登录监听（普通 JS 对象，NAPI 反射）。 */
 	buildListener() {
@@ -2659,6 +2676,7 @@ var QrLoginSession = class {
 			this.setState("scanned");
 		};
 		listener.onQRCodeLoginSucceed = (result) => {
+			this.clearTimeoutTimer();
 			this.self = {
 				uin: result.uin,
 				uid: result.uid,
@@ -2671,20 +2689,41 @@ var QrLoginSession = class {
 				this.refresh();
 				return;
 			}
+			this.clearTimeoutTimer();
+			this.failureReasonValue = null;
 			this.setState("failed");
 		};
 		listener.onLoginFailed = () => {
+			this.clearTimeoutTimer();
+			this.failureReasonValue = null;
 			this.setState("failed");
 		};
 		return listener;
 	}
 	/** 停止：注销监听（登录成功后调用，防重复回调）。 */
 	stop() {
+		this.clearTimeoutTimer();
 		if (this.listenerId !== null) {
 			this.loginService.removeKernelLoginListener(this.listenerId);
 			this.listenerId = null;
 		}
 	}
+	/** 重启超时计时器：超时未登录 → failed + 超时提示。 */
+	restartTimeout() {
+		this.clearTimeoutTimer();
+		this.timeoutTimer = setTimeout(() => {
+			this.timeoutTimer = null;
+			this.failureReasonValue = QR_LOGIN_TIMEOUT_MESSAGE;
+			this.setState("failed");
+		}, this.timeoutMs);
+	}
+	/** 清理超时计时器（幂等）。 */
+	clearTimeoutTimer() {
+		if (this.timeoutTimer !== null) {
+			clearTimeout(this.timeoutTimer);
+			this.timeoutTimer = null;
+		}
+	}
 	setState(next) {
 		this.state = next;
 		for (const cb of this.stateHandlers) cb(next);
@@ -3169,6 +3208,8 @@ function getOrCreateLoginService(exports) {
 var NapukettoCore = class NapukettoCore {
 	/** 装配根（协议层 / apis / cache 的消费入口）。 */
 	ctx;
+	/** QR 登录会话句柄（登录期间非空；登录终态后清空）。refreshQr() 据此可达。 */
+	qrSession = null;
 	/** 由 create() 装配，不直接 new。 */
 	constructor(ctx) {
 		this.ctx = ctx;
@@ -3267,25 +3308,37 @@ var NapukettoCore = class NapukettoCore {
 		if (this.ctx.wrapper === null) throw kernelError("wrapper 未装配，无法设置 session", "INVALID_STATE");
 		this.ctx.wrapper.session = session;
 	}
+	/**
+	* 手动刷新二维码（QR 登录期间可用）。返回是否成功触发（false = 当前不在扫码态）。
+	* koishi 前端「刷新二维码」按钮经 loader IPC `login.refreshQr` 动作直达。
+	*/
+	refreshQr() {
+		if (this.qrSession === null) return false;
+		this.qrSession.refresh();
+		return true;
+	}
 	/** QR 登录：QrLoginSession 状态机 + 二维码写缓存目录（无 UI，cli 可打印路径）。 */
 	async loginByQr(opts) {
 		const { wrapper } = this.ctx;
 		if (wrapper === null || wrapper.loginService === null) throw kernelError("wrapper/loginService 不可用，无法 QR 登录", "INVALID_STATE");
 		const session = new QrLoginSession(wrapper.loginService);
+		this.qrSession = session;
 		const qrPath = opts.qrCodePath ?? this.ctx.paths.file("cache", "qrcode.png");
 		this.subscribeQrProgress(session, opts, qrPath);
-		const startOpts = {};
-		if (opts.quickUin !== void 0) startOpts.quickUin = opts.quickUin;
-		session.start(startOpts);
-		await waitQrLoggedIn(session);
-		const self = session.selfInfo;
-		if (self === null) throw kernelError("QR 登录成功但 selfInfo 为空", "INVALID_STATE");
-		session.stop();
-		return {
-			uin: self.uin,
-			uid: self.uid,
-			nick: self.nick
-		};
+		try {
+			session.start();
+			await waitQrLoggedIn(session);
+			const self = session.selfInfo;
+			if (self === null) throw kernelError("QR 登录成功但 selfInfo 为空", "INVALID_STATE");
+			return {
+				uin: self.uin,
+				uid: self.uid,
+				nick: self.nick
+			};
+		} finally {
+			session.stop();
+			this.qrSession = null;
+		}
 	}
 	/** 订阅 QR 进度：二维码写盘 + 状态机经 onLoginProgress 转发。 */
 	subscribeQrProgress(session, opts, qrPath) {
@@ -3299,7 +3352,11 @@ var NapukettoCore = class NapukettoCore {
 		});
 		session.onStateChange((state) => {
 			this.ctx.logger.info({ state }, "QR 登录状态");
-			opts.onLoginProgress?.({ state });
+			const message = state === "failed" ? session.failureReason ?? void 0 : void 0;
+			opts.onLoginProgress?.({
+				state,
+				...message !== void 0 ? { message } : {}
+			});
 		});
 	}
 	/** 停止：日志收尾（资源清理留给 P2 常驻管理）。 */