@weapp-vite/miniprogram-automator 1.0.5 → 1.1.1

package/README.md

@@ -7,13 +7,14 @@
 它同时服务于：
 
 - `weapp-ide-cli` 的自动化能力
-- 仓库内 WeChat DevTools 相关 e2e 测试
-- 需要直接连接微信开发者工具 WebSocket 协议的 Node 工具
+- 仓库内小程序开发者工具相关 e2e 测试
+- 需要直接连接小程序开发者工具自动化协议的 Node 工具
 
 ## 2. 特性
 
 - 对齐官方常见对象模型：`MiniProgram`、`Page`、`Element`、`Native`
 - 提供 `Launcher` 用于启动、连接和复用 DevTools 会话
+- 支持按平台选择自动化后端，默认微信，百度智能小程序提供轻量 TypeScript runtime
 - 支持截图、输入、滚动、点击、页面跳转等自动化操作
 - 默认输出现代 ESM 与完整类型声明
 - 内置二维码打印与解码辅助能力，便于配合登录、连接流程调试
@@ -25,7 +26,7 @@
 pnpm add -D @weapp-vite/miniprogram-automator
 ```
 
-> **注意**：运行前仍需要本机安装微信开发者工具，并开启服务端口。
+> **注意**：运行前仍需要本机安装对应平台的开发者工具，并开启自动化所需服务能力。
 
 ## 4. 快速开始
 
@@ -50,19 +51,52 @@ import { Launcher } from '@weapp-vite/miniprogram-automator'
 
 const launcher = new Launcher()
 const miniProgram = await launcher.launch({
+  platform: 'wechat',
   projectPath: './dist/build/mp-weixin',
 })
 
 await miniProgram.reLaunch('/pages/index/index')
 ```
 
-### 4.3 使用页面与元素对象
+### 4.3 启动百度智能小程序
+
+```ts
+import { Launcher } from '@weapp-vite/miniprogram-automator'
+
+const launcher = new Launcher()
+const smartProgram = await launcher.launch({
+  platform: 'swan',
+  cliPath: '/Applications/百度开发者工具.app/Contents/MacOS/cli',
+  projectPath: './dist/build/mp-baidu',
+})
+
+await smartProgram.reLaunch('/pages/index/index')
+```
+
+`platform: 'baidu'` 也会按百度智能小程序处理。
+
+如果需要使用百度智能小程序自动化的 runtime 能力，可以直接访问内置入口：
+
+```ts
+import { SmartappAutomator } from '@weapp-vite/miniprogram-automator'
+
+const devices = await SmartappAutomator.devices?.('simulator')
+const device = await SmartappAutomator.launch({
+  deviceType: 'simulator',
+  wsEndpoint: 'ws://127.0.0.1:9420',
+})
+
+await device.close()
+```
+
+### 4.4 使用页面与元素对象
 
 ```ts
 import { Launcher } from '@weapp-vite/miniprogram-automator'
 
 const launcher = new Launcher()
 const miniProgram = await launcher.launch({
+  platform: 'wechat',
   projectPath: './dist/build/mp-weixin',
 })
 

package/dist/index.d.mts

@@ -1,6 +1,37 @@
 import { EventEmitter } from "node:events";
 import WebSocket from "ws";
+import { Buffer } from "node:buffer";
 
+//#region src/smartapp/file.d.ts
+declare function mkdir(dir: string): Promise<void>;
+declare function rmdir(dir: string): Promise<void>;
+declare function wget(url: string, targetPath: string): Promise<void>;
+declare function changeProjectSwanJson(projectPath: string, values: Record<string, unknown>): Promise<void>;
+//#endregion
+//#region src/smartapp/image.d.ts
+declare function drawBorder(imageBuffer: Buffer): Promise<Buffer<ArrayBufferLike>>;
+declare function extract(imageBuffer: Buffer): Promise<Buffer<ArrayBufferLike>>;
+declare function border(imageBuffer: Buffer): Promise<Buffer<ArrayBufferLike>>;
+//#endregion
+//#region src/smartapp/log.d.ts
+/**
+ * @file 百度智能小程序自动化日志工具。
+ */
+interface SmartappLogger {
+  error: (message: string) => void;
+  info: (message: string) => void;
+  warn: (message: string) => void;
+}
+declare function set(_dir: string, label?: string): SmartappLogger;
+declare function get(label?: string): SmartappLogger;
+//#endregion
+//#region src/smartapp/time.d.ts
+/**
+ * @file 百度智能小程序自动化时间工具。
+ */
+declare function currentTimestamp(): number;
+declare function delay(ms: number): Promise<void>;
+//#endregion
 //#region src/Transport.d.ts
 /** Transport 的实现。 */
 declare class Transport extends EventEmitter {
@@ -268,23 +299,210 @@ declare class MiniProgram extends EventEmitter {
   private onExceptionThrown;
 }
 //#endregion
+//#region src/smartapp/types.d.ts
+type SmartappDeviceType = 'android' | 'iOS' | 'web' | 'devtools' | 'simulator';
+type SmartappConnectType = 'usb' | 'wifi' | 'newBaiduCloud' | 'mtpaas';
+interface SmartappLaunchOptions {
+  deviceType?: SmartappDeviceType;
+  connectType?: SmartappConnectType;
+  timeout?: number;
+  headless?: boolean;
+  mtpaas?: Record<string, unknown>;
+  devtoolsPath?: string;
+  cliPath?: string;
+  projectPath?: string;
+  swanCoreVersion?: string;
+  projectMinVersion?: string;
+  deviceId?: string;
+  browserPath?: string;
+  wdaProjPath?: string;
+  isRecord?: boolean;
+  containerInfo?: unknown;
+  cookies?: unknown;
+  coverage?: boolean;
+  webModel?: string;
+}
+interface SmartappDevicesResult {
+  [deviceId: string]: {
+    status: number;
+  };
+}
+interface SmartappDriver {
+  miniProgram?: MiniProgram;
+  close?: () => Promise<void> | void;
+  currentPagePath?: string;
+  source?: () => Promise<string>;
+  screenshot?: () => Promise<Buffer>;
+}
+interface QueryOptions {
+  loop?: number;
+  duration?: number;
+  retry?: number;
+}
+interface ScreenshotOptions {
+  path?: string;
+  compressionLevel?: number;
+}
+//#endregion
+//#region src/smartapp/Element.d.ts
+declare class SmartappElement {
+  private readonly element;
+  selectors: string;
+  index: number;
+  id: string;
+  tagName: string;
+  constructor(element: Element | null, selectors?: string, index?: number);
+  scrollIntoView(options?: {
+    wait?: number;
+  }): Promise<void>;
+  boundingBox(): Promise<any>;
+  tap(options?: {
+    count?: number;
+    wait?: number;
+  }): Promise<void>;
+  input(text: string, options?: {
+    wait?: number;
+  }): Promise<void>;
+  text(): Promise<any>;
+  value(): Promise<any>;
+  attribute(name: string): Promise<any>;
+  property(name: string): Promise<any>;
+  style(style: string): Promise<any>;
+  longpress(options?: {
+    duration?: number;
+  }): Promise<void>;
+  move(options?: {
+    wait?: number;
+  }): Promise<void>;
+  screenshot(options?: ScreenshotOptions): Promise<Buffer<ArrayBuffer>>;
+}
+//#endregion
+//#region src/smartapp/Page.d.ts
+declare class SmartappPage {
+  private readonly page;
+  path: string;
+  query: Record<string, unknown>;
+  uri: string;
+  constructor(page: Page | null, path?: string, query?: Record<string, unknown>);
+  data(path?: string): Promise<any>;
+  setData(data: Record<string, unknown>): Promise<void>;
+  callMethod(method: string, ...args: unknown[]): Promise<any>;
+}
+//#endregion
+//#region src/smartapp/App.d.ts
+declare class SmartappApp {
+  private readonly miniProgram;
+  appKey: string;
+  constructor(miniProgram: MiniProgram | null, appKey: string);
+  goto(path?: string, options?: {
+    retry?: number;
+    timeout?: number;
+  }): Promise<SmartappPage>;
+  screenshot(options?: ScreenshotOptions): Promise<any>;
+  currentPage(): Promise<SmartappPage>;
+  data(): Promise<any>;
+  tabs(): Promise<never[]>;
+  pages(): Promise<any>;
+  getSystemInfo(): Promise<any>;
+  source(): Promise<string>;
+  swan(method: string, ...args: unknown[]): Promise<any>;
+  getAbTestInfo(): Promise<{}>;
+  $(selectors: string, options?: QueryOptions): Promise<SmartappElement | null>;
+  $$(selectors: string, options?: QueryOptions): Promise<any>;
+  $x(_expression: string): Promise<never[]>;
+  close(): Promise<void>;
+}
+//#endregion
+//#region src/smartapp/Device.d.ts
+declare class SmartappDevice {
+  type: string;
+  connectType: string;
+  id: string;
+  private readonly driver;
+  constructor(type: string, connectType: string, id: string, driver?: SmartappDriver);
+  source(options?: {
+    path?: string;
+  }): Promise<string>;
+  screenshot(options?: ScreenshotOptions): Promise<Buffer<ArrayBufferLike>>;
+  launchSmartapp(_container: string, appKey: string, path?: string): Promise<SmartappApp>;
+  getScreenSize(): Promise<{
+    height: number;
+    width: number;
+  }>;
+  terminateApp(): Promise<void>;
+  launchApp(): Promise<void>;
+  reLaunchApp(): Promise<void>;
+  install(): Promise<void>;
+  uninstall(): Promise<void>;
+  newSmartapp(_container: string, appKey: string): Promise<SmartappApp>;
+  tap(): Promise<void>;
+  swipe(): Promise<void>;
+  longpress(): Promise<void>;
+  $x(): Promise<never[]>;
+  home(): Promise<void>;
+  enter(): Promise<void>;
+  back(): Promise<void>;
+  isInstall(): Promise<boolean>;
+  close(): Promise<void>;
+}
+//#endregion
+//#region src/smartapp/index.d.ts
+declare function launch(options?: SmartappLaunchOptions & {
+  wsEndpoint?: string;
+}): Promise<SmartappDevice>;
+declare function connect(options: Record<string, unknown>): Promise<SmartappDevice>;
+declare function devices(deviceType: string, _connectType?: string): Promise<SmartappDevicesResult>;
+//#endregion
+//#region src/platform.d.ts
+/**
+ * @file 小程序自动化平台适配定义。
+ */
+type MiniprogramAutomatorPlatform = 'wechat' | 'swan' | 'baidu';
+interface IExternalAutomatorModule {
+  launch: (options: Record<string, unknown>) => Promise<unknown>;
+  connect?: (options: Record<string, unknown>) => Promise<unknown>;
+  devices?: (deviceType: string, connectType?: string) => Promise<unknown>;
+  file?: unknown;
+  image?: unknown;
+  log?: unknown;
+  time?: unknown;
+}
+type NormalizedMiniprogramAutomatorPlatform = Exclude<MiniprogramAutomatorPlatform, 'baidu'>;
+declare function normalizePlatform(platform?: MiniprogramAutomatorPlatform): NormalizedMiniprogramAutomatorPlatform;
+//#endregion
 //#region src/Launcher.d.ts
 interface IConnectOptions {
   wsEndpoint: string;
+  platform?: MiniprogramAutomatorPlatform;
 }
 /** ILaunchOptions 的类型定义。 */
 interface ILaunchOptions {
+  platform?: MiniprogramAutomatorPlatform;
   cliPath?: string;
+  connectType?: string;
+  deviceId?: string;
+  deviceType?: string;
+  devtoolsPath?: string;
   timeout?: number;
   port?: number;
   account?: string;
   ticket?: string;
   projectConfig?: any;
-  projectPath: string;
+  projectPath?: string;
+  projectMinVersion?: string;
+  swanCoreVersion?: string;
   trustProject?: boolean;
   args?: string[];
+  browserPath?: string;
+  containerInfo?: unknown;
+  cookies?: unknown;
   cwd?: string;
+  headless?: boolean;
+  isRecord?: boolean;
+  mtpaas?: Record<string, unknown>;
   runtimeProvider?: 'devtools' | 'headless';
+  wdaProjPath?: string;
+  webModel?: string;
 }
 interface ILauncherSessionMetadata {
   port: number;
@@ -294,7 +512,7 @@ interface ILauncherSessionMetadata {
 /** Launcher 的实现。 */
 declare class Launcher {
   launch(options: ILaunchOptions): Promise<any>;
-  connect(options: IConnectOptions): Promise<MiniProgram>;
+  connect(options: IConnectOptions): Promise<unknown>;
   private extendProjectConfig;
   private connectTool;
   private resolveCliPath;
@@ -313,7 +531,7 @@ declare class Automator {
   SliderElement: typeof SliderElement;
   ContextElement: typeof ContextElement;
   private launcher;
-  connect(options: IConnectOptions): Promise<MiniProgram>;
+  connect(options: IConnectOptions): Promise<unknown>;
   launch(options: ILaunchOptions): Promise<any>;
 }
 //#endregion
@@ -327,4 +545,30 @@ declare function isPluginPath(p: string): boolean;
 /** extractPluginId 的方法封装。 */
 declare function extractPluginId(p: string): string;
 //#endregion
-export { Automator, Connection, ContextElement, CustomElement, Element, IConnectOptions, ILaunchOptions, ILauncherSessionMetadata, InputElement, Launcher, MiniProgram, MovableViewElement, Native, Page, ScrollViewElement, SliderElement, SwiperElement, SwitchElement, TextareaElement, Transport, decodeQrCode, extractPluginId, isPluginPath, printQrCode };
+//#region src/index.d.ts
+declare const SmartappAutomator: {
+  connect: typeof connect;
+  devices: typeof devices;
+  file: {
+    changeProjectSwanJson: typeof changeProjectSwanJson;
+    mkdir: typeof mkdir;
+    rmdir: typeof rmdir;
+    wget: typeof wget;
+  };
+  image: {
+    border: typeof border;
+    drawBorder: typeof drawBorder;
+    extract: typeof extract;
+  };
+  launch: typeof launch;
+  log: {
+    get: typeof get;
+    set: typeof set;
+  };
+  time: {
+    currentTimestamp: typeof currentTimestamp;
+    delay: typeof delay;
+  };
+};
+//#endregion
+export { Automator, Connection, ContextElement, CustomElement, Element, IConnectOptions, IExternalAutomatorModule, ILaunchOptions, ILauncherSessionMetadata, InputElement, Launcher, MiniProgram, MiniprogramAutomatorPlatform, MovableViewElement, Native, NormalizedMiniprogramAutomatorPlatform, Page, ScrollViewElement, SliderElement, SmartappAutomator, SwiperElement, SwitchElement, TextareaElement, Transport, decodeQrCode, extractPluginId, isPluginPath, normalizePlatform, printQrCode };

package/dist/index.mjs

@@ -4,10 +4,11 @@ import process from "node:process";
 import { spawn } from "node:child_process";
 import path from "node:path";
 import { EventEmitter } from "node:events";
-import debug from "debug";
+import { createDebug } from "obug";
 import WebSocket from "ws";
 import fs from "node:fs/promises";
 import { decodeQrCodeFromBase64, renderTerminalQrCode } from "@weapp-vite/qr";
+import { Buffer } from "node:buffer";
 //#region src/internal/compat/async.ts
 /**
 * @file 异步控制工具。
@@ -223,6 +224,8 @@ function toStr(value) {
 //#region src/Element.ts
 /** Element 的实现。 */
 var Element = class Element {
+	connection;
+	elementMap;
 	tagName = "";
 	nodeId;
 	videoId;
@@ -473,6 +476,7 @@ var ContextElement = class extends Element {
 //#region src/Transport.ts
 /** Transport 的实现。 */
 var Transport = class extends EventEmitter {
+	ws;
 	constructor(ws) {
 		super();
 		this.ws = ws;
@@ -495,11 +499,12 @@ var Transport = class extends EventEmitter {
 /**
 * @file 自动化协议连接实现。
 */
-const debugProtocol = debug("automator:protocol");
+const debugProtocol = createDebug("automator:protocol");
 const closeErrTip = "Connection closed, check if wechat web devTools is still running";
 const REQUEST_TIMEOUT = 3e4;
 /** Connection 的实现。 */
 var Connection = class Connection extends EventEmitter {
+	transport;
 	callbacks = /* @__PURE__ */ new Map();
 	constructor(transport) {
 		super();
@@ -577,15 +582,16 @@ var Connection = class Connection extends EventEmitter {
 //#endregion
 //#region src/headless.ts
 async function launchHeadlessAutomator(options) {
-	return await (await import("./launch-Didv0lMX.mjs")).launch({ projectPath: options.projectPath });
+	return await (await import("./launch-CDd9gHVW.mjs")).launch({ projectPath: options.projectPath });
 }
 //#endregion
 //#region package.json
-var version = "1.0.5";
+var version = "1.1.1";
 //#endregion
 //#region src/Native.ts
 /** Native 的实现。 */
 var Native = class extends EventEmitter {
+	connection;
 	constructor(connection) {
 		super();
 		this.connection = connection;
@@ -634,6 +640,7 @@ var Native = class extends EventEmitter {
 //#region src/Page.ts
 /** Page 的实现。 */
 var Page = class Page {
+	connection;
 	path = "";
 	query = {};
 	id;
@@ -809,6 +816,7 @@ function logChangeRouteDebug(message) {
 }
 /** MiniProgram 的实现。 */
 var MiniProgram = class extends EventEmitter {
+	connection;
 	appBindings = /* @__PURE__ */ new Map();
 	pageMap = /* @__PURE__ */ new Map();
 	nativeIns;
@@ -1041,7 +1049,8 @@ var MiniProgram = class extends EventEmitter {
 				logChangeRouteDebug(`poll-error method=${method} url=${url ?? "<none>"} error=${error instanceof Error ? error.message : String(error)}`);
 			}
 			try {
-				const stackTop = (await this.pageStack()).at(-1);
+				const stack = await this.pageStack();
+				const stackTop = stack[stack.length - 1];
 				if (stackTop) {
 					lastPage = stackTop;
 					logChangeRouteDebug(`stack method=${method} url=${url ?? "<none>"} current=${stackTop.path}`);
@@ -1081,6 +1090,425 @@ var MiniProgram = class extends EventEmitter {
 	};
 };
 //#endregion
+//#region src/platform.ts
+function normalizePlatform(platform = "wechat") {
+	return platform === "baidu" ? "swan" : platform;
+}
+//#endregion
+//#region src/smartapp/errors.ts
+/**
+* @file 百度智能小程序自动化错误定义。
+*/
+var SmartappUnsupportedError = class extends Error {
+	constructor(feature) {
+		super(`${feature} is not available in the lightweight TypeScript smartapp runtime.`);
+		this.name = "SmartappUnsupportedError";
+	}
+};
+function unsupported(feature) {
+	throw new SmartappUnsupportedError(feature);
+}
+//#endregion
+//#region src/smartapp/time.ts
+/**
+* @file 百度智能小程序自动化时间工具。
+*/
+function currentTimestamp() {
+	return Date.now();
+}
+async function delay(ms) {
+	await new Promise((resolve) => setTimeout(resolve, ms));
+}
+const time = {
+	currentTimestamp,
+	delay
+};
+//#endregion
+//#region src/smartapp/Element.ts
+function getCoreElementId(element, selectors, index) {
+	if (!element) return `${selectors}:${index}`;
+	const elementId = Reflect.get(element, "id");
+	return typeof elementId === "string" ? elementId : `${selectors}:${index}`;
+}
+function isInputCapableElement(element) {
+	return typeof Reflect.get(element, "input") === "function";
+}
+var SmartappElement = class {
+	element;
+	selectors;
+	index;
+	id;
+	tagName;
+	constructor(element, selectors = "", index = 0) {
+		this.element = element;
+		this.selectors = selectors;
+		this.index = index;
+		this.id = getCoreElementId(element, selectors, index);
+		this.tagName = element?.tagName || "";
+	}
+	async scrollIntoView(options = {}) {
+		await delay(options.wait ?? 1e3);
+	}
+	async boundingBox() {
+		if (!this.element) return null;
+		return await this.element.offset();
+	}
+	async tap(options = {}) {
+		const count = options.count ?? 1;
+		for (let index = 0; index < count; index++) await this.element?.tap();
+		await delay(options.wait ?? 1e3);
+	}
+	async input(text, options = {}) {
+		if (this.element) {
+			if (!isInputCapableElement(this.element)) throw new SmartappUnsupportedError(`element.input(${this.tagName || "unknown"})`);
+			await this.element.input(text);
+		}
+		await delay(options.wait ?? 1e3);
+	}
+	async text() {
+		return await this.element?.text();
+	}
+	async value() {
+		return await this.property("value");
+	}
+	async attribute(name) {
+		return await this.element?.attribute(name);
+	}
+	async property(name) {
+		return await this.element?.property(name);
+	}
+	async style(style) {
+		return await this.element?.property(style);
+	}
+	async longpress(options = {}) {
+		await this.element?.longpress();
+		await delay(options.duration ?? 0);
+	}
+	async move(options = {}) {
+		await delay(options.wait ?? 1e3);
+	}
+	async screenshot(options = {}) {
+		return Buffer.alloc(0);
+	}
+};
+//#endregion
+//#region src/smartapp/Page.ts
+var SmartappPage = class {
+	page;
+	path;
+	query;
+	uri;
+	constructor(page, path = "", query = {}) {
+		this.page = page;
+		this.path = page?.path || path;
+		this.query = page?.query || query;
+		const queryText = new URLSearchParams(this.query).toString();
+		this.uri = queryText ? `${this.path}?${queryText}` : this.path;
+	}
+	async data(path) {
+		return await this.page?.data(path);
+	}
+	async setData(data) {
+		await this.page?.setData(data);
+	}
+	async callMethod(method, ...args) {
+		return await this.page?.callMethod(method, ...args);
+	}
+};
+//#endregion
+//#region src/smartapp/App.ts
+var SmartappApp = class {
+	miniProgram;
+	appKey;
+	constructor(miniProgram, appKey) {
+		this.miniProgram = miniProgram;
+		this.appKey = appKey;
+	}
+	async goto(path = "", options = {}) {
+		const retry = options.retry ?? 0;
+		let lastError;
+		for (let count = 0; count <= retry; count++) try {
+			return new SmartappPage(await this.miniProgram?.reLaunch(path) || null, path);
+		} catch (error) {
+			lastError = error;
+		}
+		throw lastError;
+	}
+	async screenshot(options = {}) {
+		return await this.miniProgram?.screenshot(options);
+	}
+	async currentPage() {
+		return new SmartappPage(await this.miniProgram?.currentPage() || null);
+	}
+	async data() {
+		return await this.miniProgram?.callWxMethod("getSystemInfo", {});
+	}
+	async tabs() {
+		return [];
+	}
+	async pages() {
+		return await this.miniProgram?.pageStack();
+	}
+	async getSystemInfo() {
+		return await this.miniProgram?.callWxMethod("getSystemInfo", {});
+	}
+	async source() {
+		const page = await this.miniProgram?.currentPage();
+		return JSON.stringify(await page?.data());
+	}
+	async swan(method, ...args) {
+		return await this.miniProgram?.callWxMethod(method, ...args);
+	}
+	async getAbTestInfo() {
+		return {};
+	}
+	async $(selectors, options = {}) {
+		await delay(options.duration ?? 0);
+		const element = await (await this.miniProgram?.currentPage())?.$(selectors);
+		return element ? new SmartappElement(element, selectors, 0) : null;
+	}
+	async $$(selectors, options = {}) {
+		await delay(options.duration ?? 0);
+		return (await (await this.miniProgram?.currentPage())?.$$(selectors) || []).map((element, index) => new SmartappElement(element, selectors, index));
+	}
+	async $x(_expression) {
+		return [];
+	}
+	async close() {
+		this.miniProgram?.disconnect();
+	}
+};
+//#endregion
+//#region src/smartapp/Device.ts
+var SmartappDevice = class {
+	type;
+	connectType;
+	id;
+	driver;
+	constructor(type, connectType, id, driver = {}) {
+		this.type = type;
+		this.connectType = connectType;
+		this.id = id;
+		this.driver = driver;
+	}
+	async source(options = {}) {
+		if (this.driver.source) return await this.driver.source();
+		return "";
+	}
+	async screenshot(options = {}) {
+		if (this.driver.screenshot) return await this.driver.screenshot();
+		return Buffer.alloc(0);
+	}
+	async launchSmartapp(_container, appKey, path = "") {
+		const app = await this.newSmartapp(_container, appKey);
+		if (path) await app.goto(path);
+		return app;
+	}
+	async getScreenSize() {
+		return {
+			height: 0,
+			width: 0
+		};
+	}
+	async terminateApp() {
+		unsupported("device.terminateApp");
+	}
+	async launchApp() {
+		unsupported("device.launchApp");
+	}
+	async reLaunchApp() {
+		unsupported("device.reLaunchApp");
+	}
+	async install() {
+		unsupported("device.install");
+	}
+	async uninstall() {
+		unsupported("device.uninstall");
+	}
+	async newSmartapp(_container, appKey) {
+		return new SmartappApp(this.driver.miniProgram || null, appKey);
+	}
+	async tap() {
+		unsupported("device.tap");
+	}
+	async swipe() {
+		unsupported("device.swipe");
+	}
+	async longpress() {
+		unsupported("device.longpress");
+	}
+	async $x() {
+		return [];
+	}
+	async home() {
+		unsupported("device.home");
+	}
+	async enter() {
+		unsupported("device.enter");
+	}
+	async back() {
+		unsupported("device.back");
+	}
+	async isInstall() {
+		return false;
+	}
+	async close() {
+		await this.driver.close?.();
+		this.driver.miniProgram?.disconnect();
+	}
+};
+//#endregion
+//#region src/smartapp/file.ts
+/**
+* @file 百度智能小程序自动化文件工具。
+*/
+async function mkdir(dir) {
+	await fs.mkdir(dir, { recursive: true });
+}
+async function rmdir(dir) {
+	await fs.rm(dir, {
+		recursive: true,
+		force: true
+	});
+}
+async function wget(url, targetPath) {
+	const response = await fetch(url);
+	if (!response.ok) throw new Error(`Failed downloading ${url}: ${response.status} ${response.statusText}`);
+	await mkdir(path.dirname(targetPath));
+	const buffer = Buffer.from(await response.arrayBuffer());
+	await fs.writeFile(targetPath, buffer);
+}
+async function changeProjectSwanJson(projectPath, values) {
+	const swanJsonPath = path.resolve(projectPath, "project.swan.json");
+	const raw = await fs.readFile(swanJsonPath, "utf8");
+	const current = JSON.parse(raw);
+	await fs.writeFile(swanJsonPath, JSON.stringify({
+		...current,
+		...values
+	}, null, 2), "utf8");
+}
+const file = {
+	changeProjectSwanJson,
+	mkdir,
+	rmdir,
+	wget
+};
+//#endregion
+//#region src/smartapp/image.ts
+async function drawBorder(imageBuffer) {
+	return imageBuffer;
+}
+async function extract(imageBuffer) {
+	return imageBuffer;
+}
+async function border(imageBuffer) {
+	return imageBuffer;
+}
+const image = {
+	border,
+	drawBorder,
+	extract
+};
+//#endregion
+//#region src/smartapp/log.ts
+const rawConsole = console;
+const loggers = /* @__PURE__ */ new Map();
+function createLogger(label) {
+	return {
+		error: (message) => rawConsole.error(`[${label}] ${message}`),
+		info: (message) => rawConsole.info(`[${label}] ${message}`),
+		warn: (message) => rawConsole.warn(`[${label}] ${message}`)
+	};
+}
+function set(_dir, label = "smartapp-automator") {
+	const logger = createLogger(label);
+	loggers.set(label, logger);
+	return logger;
+}
+function get(label = "smartapp-automator") {
+	const logger = loggers.get(label);
+	if (!logger) return set("", label);
+	return logger;
+}
+const log = {
+	get,
+	set
+};
+//#endregion
+//#region src/smartapp/index.ts
+const DEFAULT_CONNECT_TYPE = "usb";
+function resolveDeviceType(deviceType) {
+	switch (deviceType) {
+		case "android":
+		case "iOS":
+		case "web":
+		case "devtools":
+		case "simulator": return deviceType;
+		default: return "simulator";
+	}
+}
+function resolveConnectType(connectType) {
+	switch (connectType) {
+		case "usb":
+		case "wifi":
+		case "newBaiduCloud":
+		case "mtpaas": return connectType;
+		default: return DEFAULT_CONNECT_TYPE;
+	}
+}
+async function connectMiniProgram(wsEndpoint) {
+	return new MiniProgram(await Connection.create(wsEndpoint));
+}
+async function launch(options = {}) {
+	const deviceType = resolveDeviceType(options.deviceType);
+	const connectType = resolveConnectType(options.connectType);
+	const deviceId = options.deviceId || `${deviceType}-${connectType}`;
+	if (deviceType === "simulator" || deviceType === "devtools") return new SmartappDevice("devtools", connectType, deviceId, { miniProgram: options.wsEndpoint ? await connectMiniProgram(options.wsEndpoint) : void 0 });
+	return new SmartappDevice(deviceType, connectType, deviceId);
+}
+async function connect(options) {
+	if (typeof options.wsEndpoint !== "string") throw new TypeError("wsEndpoint is required for smartapp runtime connection.");
+	return new SmartappDevice("devtools", DEFAULT_CONNECT_TYPE, "devtools-usb", { miniProgram: await connectMiniProgram(options.wsEndpoint) });
+}
+async function devices(deviceType, _connectType = DEFAULT_CONNECT_TYPE) {
+	const resolvedDeviceType = resolveDeviceType(deviceType);
+	if (resolvedDeviceType === "simulator" || resolvedDeviceType === "devtools") return { devtools: { status: 0 } };
+	return {};
+}
+const SmartappAutomator$1 = {
+	connect,
+	devices,
+	file,
+	image,
+	launch,
+	log,
+	time
+};
+//#endregion
+//#region src/SwanLauncher.ts
+const smartappAutomatorRuntime = SmartappAutomator$1;
+function toSmartappLaunchOptions(options) {
+	const { cliPath, platform: _platform, runtimeProvider: _runtimeProvider, ...rest } = options;
+	return {
+		deviceType: options.deviceType || "simulator",
+		...rest,
+		...cliPath ? { devtoolsPath: cliPath } : {}
+	};
+}
+var SwanLauncher = class {
+	automator;
+	constructor(automator = SmartappAutomator$1) {
+		this.automator = automator;
+	}
+	async launch(options) {
+		return await this.automator.launch(toSmartappLaunchOptions(options));
+	}
+	async connect(options) {
+		if (!this.automator.connect) throw new Error("smartapp-automator does not expose connect(). Please use launch() for Baidu smart program automation.");
+		return await this.automator.connect({ ...options });
+	}
+};
+//#endregion
 //#region src/Launcher.ts
 /**
 * @file 开发者工具启动与连接流程。
@@ -1137,7 +1565,11 @@ function resolveRuntimeProvider(options) {
 /** Launcher 的实现。 */
 var Launcher = class {
 	async launch(options) {
-		if (resolveRuntimeProvider(options) === "headless") return await launchHeadlessAutomator({ projectPath: options.projectPath });
+		if (normalizePlatform(options.platform) === "swan") return await new SwanLauncher().launch(options);
+		if (resolveRuntimeProvider(options) === "headless") {
+			if (!options.projectPath) throw new Error("projectPath is not provided");
+			return await launchHeadlessAutomator({ projectPath: options.projectPath });
+		}
 		patchNetListenToLoopback();
 		const { cliPath = await this.resolveCliPath(), timeout = DEFAULT_TIMEOUT, projectConfig = {}, ticket = "", cwd = "", account = "", trustProject = false } = options;
 		let { args = [], projectPath } = options;
@@ -1225,6 +1657,7 @@ var Launcher = class {
 		return resolvedMiniProgram;
 	}
 	async connect(options) {
+		if (normalizePlatform(options.platform) === "swan") return await new SwanLauncher().connect(options);
 		const miniProgram = await this.connectTool(options);
 		await miniProgram.checkVersion();
 		return miniProgram;
@@ -1281,5 +1714,6 @@ var Automator = class {
 /**
 * @file miniprogram-automator 对外导出入口。
 */
+const SmartappAutomator = smartappAutomatorRuntime;
 //#endregion
-export { Automator, Connection, ContextElement, CustomElement, Element, InputElement, Launcher, MiniProgram, MovableViewElement, Native, Page, ScrollViewElement, SliderElement, SwiperElement, SwitchElement, TextareaElement, Transport, decodeQrCode, extractPluginId, isPluginPath, printQrCode };
+export { Automator, Connection, ContextElement, CustomElement, Element, InputElement, Launcher, MiniProgram, MovableViewElement, Native, Page, ScrollViewElement, SliderElement, SmartappAutomator, SwiperElement, SwitchElement, TextareaElement, Transport, decodeQrCode, extractPluginId, isPluginPath, normalizePlatform, printQrCode };

package/dist/{launch-Didv0lMX.mjs → launch-CDd9gHVW.mjs}

@@ -4047,6 +4047,8 @@ function resolveComponentScopeId(scopeId) {
 	return scopeId;
 }
 var HeadlessTestingNodeHandle = class HeadlessTestingNodeHandle {
+	node;
+	interactions;
 	constructor(node, interactions) {
 		this.node = node;
 		this.interactions = interactions;
@@ -7720,6 +7722,9 @@ function createHeadlessSession(options) {
 const DEFAULT_WAIT_TIMEOUT$1 = 1e3;
 const DEFAULT_WAIT_INTERVAL$1 = 10;
 var HeadlessTestingPageHandle = class {
+	project;
+	page;
+	session;
 	constructor(project, page, session) {
 		this.project = project;
 		this.page = page;
@@ -7886,6 +7891,9 @@ async function pollUntil(check, errorMessage, options = {}) {
 //#endregion
 //#region ../../mpcore/packages/simulator/src/testing/sessionHandle/scope.ts
 var HeadlessTestingScopeHandle = class HeadlessTestingScopeHandle {
+	scopeId;
+	project;
+	session;
 	constructor(scopeId, project, session) {
 		this.scopeId = scopeId;
 		this.project = project;
@@ -7940,6 +7948,8 @@ var HeadlessTestingScopeHandle = class HeadlessTestingScopeHandle {
 //#endregion
 //#region ../../mpcore/packages/simulator/src/testing/sessionHandle/index.ts
 var HeadlessTestingSessionHandle = class {
+	project;
+	session;
 	constructor(project, session) {
 		this.project = project;
 		this.session = session;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@weapp-vite/miniprogram-automator",
   "type": "module",
-  "version": "1.0.5",
+  "version": "1.1.1",
   "description": "完全兼容微信 miniprogram-automator 的现代化替代实现",
   "author": "ice breaker <1324318532@qq.com>",
   "license": "MIT",
@@ -41,8 +41,8 @@
     "node": "^20.19.0 || >=22.12.0"
   },
   "dependencies": {
-    "debug": "^4.4.3",
-    "ws": "^8.18.3",
+    "obug": "^2.1.1",
+    "ws": "^8.20.1",
     "@weapp-vite/qr": "1.1.0"
   },
   "publishConfig": {