weapp-ide-cli 6.2.0 → 6.3.0

package/dist/automator-session-VOB03glx.js

@@ -0,0 +1,186 @@
+import { M as logger } from "./automatorProject-DjYLqMj6.js";
+import { E as promptWechatIdeLoginRetry, M as i18nText, P as resolveAutomatorSessionOptions, c as getAutomatorProtocolTimeoutMethod, d as isAutomatorProtocolTimeoutError, f as isAutomatorWsConnectError, i as resolveProjectAutomatorPort, l as isAutomatorLoginError, m as isDevtoolsHttpPortError, n as launchAutomator, p as isDevtoolsExtensionContextInvalidatedError, s as formatAutomatorLoginError, t as connectOpenedAutomator, u as isAutomatorPortInUseError, y as createWechatIdeLoginRequiredExitError } from "./automator-BOe32upt.js";
+import { acquireSharedMiniProgram, closeOwnedSharedMiniProgram, closeSharedMiniProgram, getSharedMiniProgramSessionCount, releaseSharedMiniProgram, withMiniProgram } from "@weapp-vite/devtools-runtime";
+import { OperationLifecycle } from "@weapp-vite/miniprogram-automator/operation";
+//#region src/cli/run-login-executor.ts
+/** 命令、登录提示和有限重试共用一个 deadline，取消信号由执行边界传入 I/O。 */
+async function runRetryableCommand(options) {
+	return await new OperationLifecycle(options.timeout ?? 3e4, "IDE command", options.signal).run(async (scope) => {
+		const maxAttempts = options.maxAttempts ?? 3;
+		for (let retryCount = 0;; retryCount += 1) {
+			scope.attempt();
+			const result = await scope.step(() => options.execute(scope), {
+				stage: "execute",
+				waitForExit: true,
+				disposeLate: options.disposeLate
+			});
+			if (!options.isRetryableResult(result)) return result;
+			const cause = options.createCancelError(result);
+			scope.recordFailure(cause);
+			if (retryCount + 1 >= maxAttempts) throw cause;
+			const action = await scope.step(() => options.promptRetry(result, retryCount, scope), {
+				stage: "login-retry",
+				waitForExit: true
+			});
+			if (options.shouldRetry(action)) {
+				scope.throwIfAborted();
+				options.onRetry?.();
+				continue;
+			}
+			options.onCancel?.(result);
+			throw cause;
+		}
+	});
+}
+//#endregion
+//#region src/cli/automator-session.ts
+function unwrapAutomatorConnectionError(result) {
+	return result.kind === "retryable" ? result.error : result.value;
+}
+async function launchFreshAutomator(options) {
+	const shouldUseProjectPort = !options.port && !options.sessionId;
+	return await launchAutomator({
+		...options,
+		...shouldUseProjectPort ? {
+			persistAsDefaultSession: true,
+			port: resolveProjectAutomatorPort(options.projectPath)
+		} : {}
+	});
+}
+function normalizeMiniProgramConnectionError(error, background = false) {
+	const diagnostics = background ? {
+		error: (message) => logger.debug(message),
+		warn: (message) => logger.debug(message)
+	} : logger;
+	if (isAutomatorLoginError(error)) {
+		diagnostics.error(i18nText("检测到微信开发者工具登录状态失效，请先登录后重试。", "Wechat DevTools login has expired. Please login and retry."));
+		diagnostics.warn(formatAutomatorLoginError(error));
+		return new Error("DEVTOOLS_LOGIN_REQUIRED", { cause: error });
+	}
+	if (isDevtoolsHttpPortError(error)) {
+		diagnostics.error(i18nText("无法连接到微信开发者工具，请确保已开启 HTTP 服务端口。", "Cannot connect to Wechat DevTools. Please ensure HTTP service port is enabled."));
+		diagnostics.warn(i18nText("请在微信开发者工具中：设置 -> 安全设置 -> 开启服务端口", "Please enable service port in Wechat DevTools: Settings -> Security -> Service Port"));
+		return new Error("DEVTOOLS_HTTP_PORT_ERROR", { cause: error });
+	}
+	if (isDevtoolsExtensionContextInvalidatedError(error)) {
+		diagnostics.error(i18nText("微信开发者工具自动化上下文尚未就绪，通常是刚启动或正在重载。", "Wechat DevTools automation context is not ready yet, usually because the IDE has just started or is still reloading."));
+		diagnostics.warn(i18nText("请稍后重试；若持续失败，关闭多余的开发者工具窗口后重试。", "Please retry shortly. If it keeps failing, close extra DevTools windows and try again."));
+		return new Error("DEVTOOLS_EXTENSION_CONTEXT_INVALIDATED", { cause: error });
+	}
+	if (isAutomatorWsConnectError(error) || isAutomatorPortInUseError(error)) {
+		diagnostics.error(i18nText("无法连接到当前项目的微信开发者工具自动化 websocket。", "Cannot connect to the Wechat DevTools automation websocket for the current project."));
+		diagnostics.warn(i18nText("请确认当前打开的是目标项目；若之前跑过其他 e2e / screenshot 任务，关闭多余的微信开发者工具窗口，或结束残留的 `wechatwebdevtools cli auto --project ...` 进程后重试。", "Please confirm the current DevTools window is the target project. If you recently ran other e2e / screenshot tasks, close extra windows or stop stale `wechatwebdevtools cli auto --project ...` processes and retry."));
+		return new Error("DEVTOOLS_WS_CONNECT_ERROR", { cause: error });
+	}
+	if (isAutomatorProtocolTimeoutError(error)) {
+		const method = getAutomatorProtocolTimeoutMethod(error) ?? "unknown";
+		diagnostics.error(i18nText(`微信开发者工具在协议调用 ${method} 上超时，未按预期返回结果。`, `Wechat DevTools timed out while executing protocol method ${method} and did not return a result.`));
+		diagnostics.warn(i18nText("这通常表示当前 DevTools 自动化会话已卡住、窗口不在目标项目、或当前 DevTools 版本对该协议调用无响应。请重开目标项目窗口后重试；若仍复现，优先记录当前 DevTools 版本与协议方法名继续排查。", "This usually means the current DevTools automation session is stuck, the window is not on the target project, or the current DevTools version is not responding to that protocol method. Reopen the target project window and retry. If it still reproduces, record the current DevTools version and protocol method name for follow-up debugging."));
+		return new Error("DEVTOOLS_PROTOCOL_TIMEOUT", { cause: error });
+	}
+	return error instanceof Error ? error : new Error(String(error));
+}
+/**
+* @description 建立 automator 会话，并统一处理常见连接错误提示。
+*/
+async function connectMiniProgramWithDiagnostics(options, background) {
+	options = await resolveAutomatorSessionOptions(options);
+	const result = await runRetryableCommand({
+		timeout: options.timeout,
+		signal: options.signal,
+		disposeLate: (result) => {
+			if (result.kind === "result") return result.value.disconnect();
+		},
+		createCancelError: (result) => createWechatIdeLoginRequiredExitError(unwrapAutomatorConnectionError(result), "cancelled"),
+		execute: async (operation) => {
+			const operationOptions = () => ({
+				...options,
+				timeout: operation.remainingMs(),
+				signal: operation.signal
+			});
+			if (options.runtimeProvider === "headless" || options.preferOpenedSession === false && options.openedOnly !== true) try {
+				return {
+					kind: "result",
+					value: await launchFreshAutomator(operationOptions())
+				};
+			} catch (error) {
+				if (!isAutomatorLoginError(error)) throw normalizeMiniProgramConnectionError(error, background);
+				return {
+					error,
+					kind: "retryable"
+				};
+			}
+			try {
+				return {
+					kind: "result",
+					value: await connectOpenedAutomator(operationOptions())
+				};
+			} catch (error) {
+				const normalizedOpenSessionError = normalizeMiniProgramConnectionError(error, background);
+				if (options.openedOnly || options.preferOpenedSession !== false && Boolean(options.port || options.sessionId)) throw normalizedOpenSessionError;
+				if (normalizedOpenSessionError instanceof Error && ("code" in normalizedOpenSessionError && normalizedOpenSessionError.code === "WECHAT_DEVTOOLS_HOST_IDENTITY_MISMATCH" || normalizedOpenSessionError.message === "DEVTOOLS_PROTOCOL_TIMEOUT" || normalizedOpenSessionError.message.startsWith("DEVTOOLS_INSTALLATION_MISMATCH") || normalizedOpenSessionError.message.startsWith("DEVTOOLS_PORT_IDENTITY"))) throw normalizedOpenSessionError;
+				try {
+					return {
+						kind: "result",
+						value: await launchFreshAutomator(operationOptions())
+					};
+				} catch (launchError) {
+					if (!isAutomatorLoginError(launchError)) throw normalizeMiniProgramConnectionError(launchError, background);
+					return {
+						error: launchError,
+						kind: "retryable"
+					};
+				}
+			}
+		},
+		isRetryableResult: (result) => result.kind === "retryable",
+		onRetry: () => {
+			logger.info(i18nText("正在重试连接微信开发者工具...", "Retrying to connect Wechat DevTools..."));
+		},
+		promptRetry: async (result, _retryCount, operation) => await promptWechatIdeLoginRetry({
+			error: unwrapAutomatorConnectionError(result),
+			retryTimeoutMs: operation.remainingMs(),
+			signal: operation.signal,
+			logger,
+			promptOpenIdeLogin: true
+		}),
+		shouldRetry: (action) => action === "retry"
+	});
+	if (result.kind === "retryable") throw createWechatIdeLoginRequiredExitError(result.error);
+	return result.value;
+}
+/** 建立交互式会话，并报告最终连接错误。 */
+async function connectMiniProgram(options) {
+	return await connectMiniProgramWithDiagnostics(options, false);
+}
+/** 后台日志桥接的连接探针，不在每次可恢复失败时输出终局错误。 */
+async function connectConsoleMiniProgram(options) {
+	return await connectMiniProgramWithDiagnostics(options, true);
+}
+/** 为后台日志桥接保留共享会话所有权和诊断级别。 */
+async function acquireConsoleMiniProgram(options) {
+	return await acquireSharedMiniProgram({
+		resolveSessionOptions: resolveAutomatorSessionOptions,
+		connectMiniProgram: connectConsoleMiniProgram,
+		normalizeConnectionError: (error) => normalizeMiniProgramConnectionError(error, true)
+	}, options);
+}
+const runtimeHooks = {
+	resolveSessionOptions: resolveAutomatorSessionOptions,
+	connectMiniProgram,
+	normalizeConnectionError: normalizeMiniProgramConnectionError
+};
+/**
+* @description 获取指定项目的共享 automator 会话；若不存在则自动创建。
+*/
+async function acquireSharedMiniProgram$1(options) {
+	return await acquireSharedMiniProgram(runtimeHooks, options);
+}
+/**
+* @description 统一管理 automator 会话生命周期。
+*/
+async function withMiniProgram$1(options, runner) {
+	return await withMiniProgram(runtimeHooks, options, runner);
+}
+//#endregion
+export { connectConsoleMiniProgram as a, releaseSharedMiniProgram as c, closeSharedMiniProgram as i, withMiniProgram$1 as l, acquireSharedMiniProgram$1 as n, connectMiniProgram as o, closeOwnedSharedMiniProgram as r, getSharedMiniProgramSessionCount as s, acquireConsoleMiniProgram as t, runRetryableCommand as u };