@weapp-vite/devtools-runtime 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 ice breaker
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,45 @@
+import { Element, MiniProgram, Page } from "@weapp-vite/miniprogram-automator";
+
+//#region src/index.d.ts
+interface MiniProgramEventMap {
+  console: (payload: unknown) => void;
+  exception: (payload: unknown) => void;
+}
+type AutomatorMiniProgram = InstanceType<typeof MiniProgram>;
+type AutomatorPage = InstanceType<typeof Page>;
+type AutomatorElement = InstanceType<typeof Element> & {
+  input?: (value: string) => Promise<void>;
+};
+interface DevtoolsRuntimeSessionOptions {
+  miniProgram?: AutomatorMiniProgram;
+  preferOpenedSession?: boolean;
+  projectPath: string;
+  sharedSession?: boolean;
+  timeout?: number;
+}
+interface DevtoolsRuntimeHooks {
+  connectMiniProgram: (options: DevtoolsRuntimeSessionOptions) => Promise<AutomatorMiniProgram>;
+  normalizeConnectionError?: (error: unknown) => unknown;
+}
+/**
+ * @description 获取指定项目的共享 automator 会话；若不存在则自动创建。
+ */
+declare function acquireSharedMiniProgram(hooks: DevtoolsRuntimeHooks, options: DevtoolsRuntimeSessionOptions): Promise<AutomatorMiniProgram>;
+/**
+ * @description 释放指定项目的共享会话引用；会话对象会继续缓存，直到显式关闭或重置。
+ */
+declare function releaseSharedMiniProgram(projectPath: string): void;
+/**
+ * @description 关闭并移除指定项目的共享 automator 会话。
+ */
+declare function closeSharedMiniProgram(projectPath: string): Promise<void>;
+/**
+ * @description 获取当前共享会话数量，供测试断言使用。
+ */
+declare function getSharedMiniProgramSessionCount(): number;
+/**
+ * @description 统一管理 automator 会话生命周期。
+ */
+declare function withMiniProgram<T>(hooks: DevtoolsRuntimeHooks, options: DevtoolsRuntimeSessionOptions, runner: (miniProgram: AutomatorMiniProgram) => Promise<T>): Promise<T>;
+//#endregion
+export { AutomatorElement, AutomatorMiniProgram, AutomatorPage, DevtoolsRuntimeHooks, DevtoolsRuntimeSessionOptions, MiniProgramEventMap, acquireSharedMiniProgram, closeSharedMiniProgram, getSharedMiniProgramSessionCount, releaseSharedMiniProgram, withMiniProgram };

package/dist/index.js

@@ -0,0 +1,79 @@
+//#region src/index.ts
+const sharedMiniProgramSessions = /* @__PURE__ */ new Map();
+function normalizeError(hooks, error) {
+	const normalized = hooks.normalizeConnectionError?.(error) ?? error;
+	return normalized instanceof Error ? normalized : new Error(String(normalized));
+}
+/**
+* @description 获取指定项目的共享 automator 会话；若不存在则自动创建。
+*/
+async function acquireSharedMiniProgram(hooks, options) {
+	const existing = sharedMiniProgramSessions.get(options.projectPath);
+	if (existing) {
+		existing.refs += 1;
+		return await existing.session;
+	}
+	const session = hooks.connectMiniProgram(options);
+	const entry = {
+		refs: 1,
+		session
+	};
+	sharedMiniProgramSessions.set(options.projectPath, entry);
+	try {
+		return await session;
+	} catch (error) {
+		sharedMiniProgramSessions.delete(options.projectPath);
+		throw normalizeError(hooks, error);
+	}
+}
+/**
+* @description 释放指定项目的共享会话引用；会话对象会继续缓存，直到显式关闭或重置。
+*/
+function releaseSharedMiniProgram(projectPath) {
+	const entry = sharedMiniProgramSessions.get(projectPath);
+	if (!entry) return;
+	entry.refs = Math.max(0, entry.refs - 1);
+}
+/**
+* @description 关闭并移除指定项目的共享 automator 会话。
+*/
+async function closeSharedMiniProgram(projectPath) {
+	const entry = sharedMiniProgramSessions.get(projectPath);
+	if (!entry) return;
+	sharedMiniProgramSessions.delete(projectPath);
+	(await entry.session.catch(() => null))?.disconnect();
+}
+/**
+* @description 获取当前共享会话数量，供测试断言使用。
+*/
+function getSharedMiniProgramSessionCount() {
+	return sharedMiniProgramSessions.size;
+}
+/**
+* @description 统一管理 automator 会话生命周期。
+*/
+async function withMiniProgram(hooks, options, runner) {
+	if (options.miniProgram) return await runner(options.miniProgram);
+	if (options.sharedSession) {
+		const miniProgram = await acquireSharedMiniProgram(hooks, options);
+		try {
+			return await runner(miniProgram);
+		} catch (error) {
+			await closeSharedMiniProgram(options.projectPath);
+			throw normalizeError(hooks, error);
+		} finally {
+			releaseSharedMiniProgram(options.projectPath);
+		}
+	}
+	let miniProgram = null;
+	try {
+		miniProgram = await hooks.connectMiniProgram(options);
+		return await runner(miniProgram);
+	} catch (error) {
+		throw normalizeError(hooks, error);
+	} finally {
+		if (miniProgram) await miniProgram.close();
+	}
+}
+//#endregion
+export { acquireSharedMiniProgram, closeSharedMiniProgram, getSharedMiniProgramSessionCount, releaseSharedMiniProgram, withMiniProgram };

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@weapp-vite/devtools-runtime",
+  "type": "module",
+  "version": "0.1.0",
+  "description": "Shared WeChat DevTools runtime automation helpers for weapp-vite packages",
+  "author": "ice breaker <1324318532@qq.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/weapp-vite/weapp-vite.git",
+    "directory": "packages/devtools-runtime"
+  },
+  "bugs": {
+    "url": "https://github.com/weapp-vite/weapp-vite/issues"
+  },
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "@weapp-vite/miniprogram-automator": "1.0.4"
+  },
+  "scripts": {
+    "dev": "tsdown -w --sourcemap",
+    "build": "tsdown",
+    "test": "vitest run",
+    "test:dev": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix"
+  }
+}