weixin-devtools-mcp 0.0.1 → 0.1.1

package/build/config/tool-profile.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 工具暴露配置
+ * 支持 profile 与类别开关，按需裁剪 ListTools 返回内容
+ */
+import type { ToolDefinition } from '../tools/ToolDefinition.js';
+import { ToolCategory } from '../tools/ToolDefinition.js';
+export type ToolsProfile = 'core' | 'full' | 'minimal';
+export interface ToolProfileConfig {
+    profile: ToolsProfile;
+    enabledCategories: ReadonlySet<ToolCategory>;
+    disabledCategories: ReadonlySet<ToolCategory>;
+}
+export interface ToolActivationResult {
+    activeTools: ToolDefinition[];
+    disabledTools: Map<string, ToolDefinition>;
+}
+interface ParseConfigOptions {
+    argv?: readonly string[];
+    env?: NodeJS.ProcessEnv;
+}
+/**
+ * 解析工具 profile 配置
+ */
+export declare function parseToolProfileConfig(options?: ParseConfigOptions): ToolProfileConfig;
+/**
+ * 根据 profile 与类别开关计算激活工具
+ */
+export declare function resolveToolsByProfile(tools: readonly ToolDefinition[], config: ToolProfileConfig): ToolActivationResult;
+export {};
+//# sourceMappingURL=tool-profile.d.ts.map

package/build/config/tool-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-profile.d.ts","sourceRoot":"","sources":["../../src/config/tool-profile.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAEvD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,YAAY,CAAC;IACtB,iBAAiB,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC;IAC7C,kBAAkB,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC5C;AAyCD,UAAU,kBAAkB;IAC1B,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAmDD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,iBAAiB,CAqBtF;AAcD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,SAAS,cAAc,EAAE,EAChC,MAAM,EAAE,iBAAiB,GACxB,oBAAoB,CA6BtB"}

package/build/config/tool-profile.js

@@ -0,0 +1,138 @@
+/**
+ * 工具暴露配置
+ * 支持 profile 与类别开关，按需裁剪 ListTools 返回内容
+ */
+import { ToolCategory } from '../tools/ToolDefinition.js';
+const DEFAULT_PROFILE = 'core';
+const VALID_CATEGORIES = new Set(Object.values(ToolCategory));
+const CORE_TOOL_NAMES = new Set([
+    'connect_devtools',
+    'reconnect_devtools',
+    'disconnect_devtools',
+    'get_connection_status',
+    'get_current_page',
+    'get_page_snapshot',
+    'query_selector',
+    'wait_for',
+    'click',
+    'input_text',
+    'get_value',
+    'set_form_control',
+    'assert_text',
+    'assert_attribute',
+    'assert_state',
+    'navigate_to',
+    'navigate_back',
+    'switch_tab',
+    'relaunch',
+    'evaluate_script',
+]);
+const MINIMAL_TOOL_NAMES = new Set([
+    'connect_devtools',
+    'get_connection_status',
+    'query_selector',
+    'wait_for',
+    'click',
+    'input_text',
+    'get_value',
+    'navigate_to',
+    'navigate_back',
+    'assert_text',
+]);
+function readCliOption(argv, optionName) {
+    const inlinePrefix = `--${optionName}=`;
+    for (let index = 0; index < argv.length; index += 1) {
+        const argument = argv[index];
+        if (argument.startsWith(inlinePrefix)) {
+            return argument.slice(inlinePrefix.length);
+        }
+        if (argument === `--${optionName}`) {
+            const next = argv[index + 1];
+            if (typeof next === 'string' && !next.startsWith('--')) {
+                return next;
+            }
+        }
+    }
+    return undefined;
+}
+function normalizeProfile(profileValue) {
+    const normalized = profileValue?.trim().toLowerCase();
+    if (normalized === 'full' || normalized === 'minimal' || normalized === 'core') {
+        return normalized;
+    }
+    return DEFAULT_PROFILE;
+}
+function parseCategoryList(rawValue) {
+    const categories = new Set();
+    if (!rawValue) {
+        return categories;
+    }
+    const parts = rawValue.split(',');
+    for (const part of parts) {
+        const normalized = part.trim().toLowerCase();
+        if (normalized.length === 0) {
+            continue;
+        }
+        if (VALID_CATEGORIES.has(normalized)) {
+            categories.add(normalized);
+        }
+    }
+    return categories;
+}
+/**
+ * 解析工具 profile 配置
+ */
+export function parseToolProfileConfig(options) {
+    const argv = options?.argv ?? process.argv.slice(2);
+    const env = options?.env ?? process.env;
+    const cliProfile = readCliOption(argv, 'tools-profile');
+    const envProfile = env.WEIXIN_MCP_TOOLS_PROFILE;
+    const profile = normalizeProfile(cliProfile ?? envProfile);
+    const cliEnabledCategories = readCliOption(argv, 'enable-categories');
+    const envEnabledCategories = env.WEIXIN_MCP_ENABLE_CATEGORIES;
+    const enabledCategories = parseCategoryList(cliEnabledCategories ?? envEnabledCategories);
+    const cliDisabledCategories = readCliOption(argv, 'disable-categories');
+    const envDisabledCategories = env.WEIXIN_MCP_DISABLE_CATEGORIES;
+    const disabledCategories = parseCategoryList(cliDisabledCategories ?? envDisabledCategories);
+    return {
+        profile,
+        enabledCategories,
+        disabledCategories,
+    };
+}
+function getBaseActiveNames(profile, tools) {
+    if (profile === 'full') {
+        return new Set(tools.map(tool => tool.name));
+    }
+    if (profile === 'minimal') {
+        return new Set(MINIMAL_TOOL_NAMES);
+    }
+    return new Set(CORE_TOOL_NAMES);
+}
+/**
+ * 根据 profile 与类别开关计算激活工具
+ */
+export function resolveToolsByProfile(tools, config) {
+    const activeNames = getBaseActiveNames(config.profile, tools);
+    for (const tool of tools) {
+        const toolCategory = tool.annotations?.category ?? ToolCategory.CORE;
+        if (config.enabledCategories.has(toolCategory)) {
+            activeNames.add(tool.name);
+        }
+    }
+    for (const tool of tools) {
+        const toolCategory = tool.annotations?.category ?? ToolCategory.CORE;
+        if (config.disabledCategories.has(toolCategory)) {
+            activeNames.delete(tool.name);
+        }
+    }
+    const activeTools = tools.filter(tool => activeNames.has(tool.name));
+    const disabledTools = new Map(tools
+        .filter(tool => !activeNames.has(tool.name))
+        .map(tool => [tool.name, tool]));
+    return {
+        activeTools,
+        disabledTools,
+    };
+}
+//# sourceMappingURL=tool-profile.js.map

package/build/config/tool-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-profile.js","sourceRoot":"","sources":["../../src/config/tool-profile.ts"],"names":[],"mappings":"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"}

package/build/connection/adapters.d.ts

@@ -0,0 +1,3 @@
+import type { AdapterConnectionResult, ConnectionStrategy, ResolvedConnectionRequest } from './types.js';
+export declare function executeConnectionStrategy(strategy: ConnectionStrategy, request: ResolvedConnectionRequest): Promise<AdapterConnectionResult>;
+//# sourceMappingURL=adapters.d.ts.map

package/build/connection/adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../src/connection/adapters.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,uBAAuB,EACvB,kBAAkB,EAClB,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAqLpB,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,uBAAuB,CAAC,CAoBlC"}

package/build/connection/adapters.js

@@ -0,0 +1,134 @@
+import automator from 'miniprogram-automator';
+import { connectDevtoolsEnhanced, detectIDEPort, } from '../tools.js';
+import { EnvironmentConnectionError, ProtocolConnectionError, SessionConflictConnectionError, } from './errors.js';
+function extractMessage(error) {
+    return error.message.toLowerCase();
+}
+function buildEnhancedOptions(request, mode) {
+    return {
+        projectPath: request.projectPath ?? '',
+        mode,
+        cliPath: request.cliPath,
+        autoPort: request.autoPort,
+        timeout: request.timeoutMs,
+        fallbackMode: request.fallback.length > 0,
+        healthCheck: false,
+        verbose: request.verbose,
+        autoAudits: request.autoAudits,
+    };
+}
+function ensurePagePath(pagePath) {
+    if (!pagePath) {
+        throw new ProtocolConnectionError('连接成功但当前页面路径为空', [
+            '请确认开发者工具中项目已成功打开',
+        ]);
+    }
+    return pagePath;
+}
+async function connectByEnhancedMode(request, strategy) {
+    try {
+        const result = await connectDevtoolsEnhanced(buildEnhancedOptions(request, strategy));
+        const endpoint = result.processInfo?.port
+            ? `ws://127.0.0.1:${result.processInfo.port}`
+            : null;
+        const pagePath = ensurePagePath(result.pagePath);
+        return {
+            strategyUsed: strategy,
+            endpoint,
+            miniProgram: result.miniProgram,
+            currentPage: result.currentPage,
+            pagePath,
+        };
+    }
+    catch (error) {
+        const baseError = error instanceof Error ? error : new Error(String(error));
+        const message = extractMessage(baseError);
+        if (message.includes('session') || message.includes('already') || message.includes('conflict')) {
+            throw new SessionConflictConnectionError(baseError.message, undefined, baseError);
+        }
+        throw new EnvironmentConnectionError(baseError.message, 'connect', ['检查 projectPath、cliPath 与微信开发者工具启动状态'], { strategy }, baseError);
+    }
+}
+async function connectByWsEndpoint(request, wsEndpoint, strategyUsed) {
+    try {
+        const miniProgram = await automator.connect({ wsEndpoint, timeout: request.timeoutMs });
+        const currentPage = await miniProgram.currentPage();
+        if (!currentPage) {
+            throw new ProtocolConnectionError('wsEndpoint 已连接但 currentPage 不可用', [
+                '确认目标 DevTools 实例已打开小程序项目',
+            ]);
+        }
+        const pagePath = ensurePagePath(await currentPage.path);
+        return {
+            strategyUsed,
+            endpoint: wsEndpoint,
+            miniProgram,
+            currentPage,
+            pagePath,
+        };
+    }
+    catch (error) {
+        const baseError = error instanceof Error ? error : new Error(String(error));
+        throw new ProtocolConnectionError(baseError.message, ['确认 wsEndpoint 可访问，且端点属于微信开发者工具自动化端口'], { wsEndpoint, strategy: strategyUsed }, baseError);
+    }
+}
+function parseWebSocketDebuggerUrl(payload) {
+    const endpoint = payload.webSocketDebuggerUrl ?? payload.websocketDebuggerUrl;
+    if (!endpoint) {
+        throw new EnvironmentConnectionError('browserUrl 未返回 webSocketDebuggerUrl', 'connect', ['确认目标地址支持 /json/version 并开启远程调试']);
+    }
+    return endpoint;
+}
+async function resolveWsEndpointByBrowserUrl(browserUrl, timeoutMs) {
+    const normalizedBase = browserUrl.endsWith('/') ? browserUrl.slice(0, -1) : browserUrl;
+    const versionUrl = `${normalizedBase}/json/version`;
+    let response;
+    try {
+        response = await fetch(versionUrl, {
+            signal: AbortSignal.timeout(timeoutMs),
+        });
+    }
+    catch (error) {
+        const baseError = error instanceof Error ? error : new Error(String(error));
+        throw new EnvironmentConnectionError(`请求 browserUrl 失败: ${baseError.message}`, 'connect', ['确认 browserUrl 可访问，例如 http://127.0.0.1:9222'], { browserUrl }, baseError);
+    }
+    if (!response.ok) {
+        throw new EnvironmentConnectionError(`browserUrl 返回非成功状态: ${response.status}`, 'connect', ['确认远程调试服务已开启并允许访问 /json/version'], { browserUrl, status: response.status });
+    }
+    const payload = await response.json();
+    return parseWebSocketDebuggerUrl(payload);
+}
+async function connectByBrowserUrl(request, browserUrl) {
+    const endpoint = await resolveWsEndpointByBrowserUrl(browserUrl, request.timeoutMs);
+    return connectByWsEndpoint(request, endpoint, 'browserUrl');
+}
+async function connectByDiscover(request) {
+    const port = await detectIDEPort(request.verbose);
+    if (port === null) {
+        throw new EnvironmentConnectionError('自动发现失败：未检测到可用的微信开发者工具自动化端口', 'startup', [
+            '先在微信开发者工具中开启自动化能力',
+            '改用 strategy=launch 并传入 projectPath',
+        ]);
+    }
+    const endpoint = `ws://127.0.0.1:${port}`;
+    return connectByWsEndpoint(request, endpoint, 'discover');
+}
+export async function executeConnectionStrategy(strategy, request) {
+    if (strategy === 'auto' || strategy === 'launch' || strategy === 'connect') {
+        return connectByEnhancedMode(request, strategy);
+    }
+    if (strategy === 'wsEndpoint') {
+        if (!request.wsEndpoint) {
+            throw new EnvironmentConnectionError('wsEndpoint 策略缺少 wsEndpoint 参数', 'resolve');
+        }
+        return connectByWsEndpoint(request, request.wsEndpoint, strategy);
+    }
+    if (strategy === 'browserUrl') {
+        if (!request.browserUrl) {
+            throw new EnvironmentConnectionError('browserUrl 策略缺少 browserUrl 参数', 'resolve');
+        }
+        return connectByBrowserUrl(request, request.browserUrl);
+    }
+    return connectByDiscover(request);
+}
+//# sourceMappingURL=adapters.js.map

package/build/connection/adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../../src/connection/adapters.ts"],"names":[],"mappings":"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"}

package/build/connection/errors.d.ts

@@ -0,0 +1,34 @@
+import type { ConnectionErrorSummary, ConnectionPhase, MetadataValue } from './types.js';
+export type ConnectionErrorCode = 'INVALID_ARGUMENT' | 'ENVIRONMENT' | 'SESSION_CONFLICT' | 'PROTOCOL' | 'HEALTH_CHECK_FAILED' | 'CONNECTION_FAILED' | 'DISCONNECTED';
+export interface ConnectionErrorOptions {
+    code: ConnectionErrorCode;
+    phase: ConnectionPhase;
+    suggestions?: string[];
+    metadata?: Record<string, MetadataValue>;
+    cause?: Error;
+}
+export declare class ConnectionError extends Error {
+    readonly code: ConnectionErrorCode;
+    readonly phase: ConnectionPhase;
+    readonly suggestions: string[];
+    readonly metadata?: Record<string, MetadataValue>;
+    constructor(message: string, options: ConnectionErrorOptions);
+    toSummary(): ConnectionErrorSummary;
+}
+export declare class ValidationConnectionError extends ConnectionError {
+    constructor(message: string, suggestions?: string[], metadata?: Record<string, MetadataValue>);
+}
+export declare class EnvironmentConnectionError extends ConnectionError {
+    constructor(message: string, phase: Extract<ConnectionPhase, 'startup' | 'connect' | 'resolve'>, suggestions?: string[], metadata?: Record<string, MetadataValue>, cause?: Error);
+}
+export declare class ProtocolConnectionError extends ConnectionError {
+    constructor(message: string, suggestions?: string[], metadata?: Record<string, MetadataValue>, cause?: Error);
+}
+export declare class SessionConflictConnectionError extends ConnectionError {
+    constructor(message: string, metadata?: Record<string, MetadataValue>, cause?: Error);
+}
+export declare class HealthCheckConnectionError extends ConnectionError {
+    constructor(message: string, metadata?: Record<string, MetadataValue>, cause?: Error);
+}
+export declare function normalizeConnectionError(error: Error | ConnectionError): ConnectionError;
+//# sourceMappingURL=errors.d.ts.map

package/build/connection/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/connection/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,eAAe,EACf,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,mBAAmB,GAC3B,kBAAkB,GAClB,aAAa,GACb,kBAAkB,GAClB,UAAU,GACV,qBAAqB,GACrB,mBAAmB,GACnB,cAAc,CAAC;AAEnB,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,KAAK,EAAE,eAAe,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACzC,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;gBAEtC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB;IAS5D,SAAS,IAAI,sBAAsB;CAUpC;AAED,qBAAa,yBAA0B,SAAQ,eAAe;gBAE1D,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,EAAE,EACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC;CAU3C;AAED,qBAAa,0BAA2B,SAAQ,eAAe;gBAE3D,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,CAAC,eAAe,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC,EAClE,WAAW,CAAC,EAAE,MAAM,EAAE,EACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EACxC,KAAK,CAAC,EAAE,KAAK;CAWhB;AAED,qBAAa,uBAAwB,SAAQ,eAAe;gBAExD,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,EAAE,EACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EACxC,KAAK,CAAC,EAAE,KAAK;CAWhB;AAED,qBAAa,8BAA+B,SAAQ,eAAe;gBACrD,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EAAE,KAAK,CAAC,EAAE,KAAK;CAarF;AAED,qBAAa,0BAA2B,SAAQ,eAAe;gBACjD,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EAAE,KAAK,CAAC,EAAE,KAAK;CAarF;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,eAAe,GAAG,eAAe,CAWxF"}

package/build/connection/errors.js

@@ -0,0 +1,101 @@
+export class ConnectionError extends Error {
+    code;
+    phase;
+    suggestions;
+    metadata;
+    constructor(message, options) {
+        super(message, options.cause ? { cause: options.cause } : undefined);
+        this.name = 'ConnectionError';
+        this.code = options.code;
+        this.phase = options.phase;
+        this.suggestions = options.suggestions ?? [];
+        this.metadata = options.metadata;
+    }
+    toSummary() {
+        return {
+            code: this.code,
+            phase: this.phase,
+            message: this.message,
+            suggestions: this.suggestions,
+            metadata: this.metadata,
+            timestamp: new Date().toISOString(),
+        };
+    }
+}
+export class ValidationConnectionError extends ConnectionError {
+    constructor(message, suggestions, metadata) {
+        super(message, {
+            code: 'INVALID_ARGUMENT',
+            phase: 'resolve',
+            suggestions,
+            metadata,
+        });
+        this.name = 'ValidationConnectionError';
+    }
+}
+export class EnvironmentConnectionError extends ConnectionError {
+    constructor(message, phase, suggestions, metadata, cause) {
+        super(message, {
+            code: 'ENVIRONMENT',
+            phase,
+            suggestions,
+            metadata,
+            cause,
+        });
+        this.name = 'EnvironmentConnectionError';
+    }
+}
+export class ProtocolConnectionError extends ConnectionError {
+    constructor(message, suggestions, metadata, cause) {
+        super(message, {
+            code: 'PROTOCOL',
+            phase: 'connect',
+            suggestions,
+            metadata,
+            cause,
+        });
+        this.name = 'ProtocolConnectionError';
+    }
+}
+export class SessionConflictConnectionError extends ConnectionError {
+    constructor(message, metadata, cause) {
+        super(message, {
+            code: 'SESSION_CONFLICT',
+            phase: 'startup',
+            suggestions: [
+                '关闭当前微信开发者工具窗口后重试',
+                '切换到 wsEndpoint 或 discover 策略复用现有会话',
+            ],
+            metadata,
+            cause,
+        });
+        this.name = 'SessionConflictConnectionError';
+    }
+}
+export class HealthCheckConnectionError extends ConnectionError {
+    constructor(message, metadata, cause) {
+        super(message, {
+            code: 'HEALTH_CHECK_FAILED',
+            phase: 'health_check',
+            suggestions: [
+                '检查开发者工具是否仍在运行',
+                '使用 reconnect_devtools 重新建立连接',
+            ],
+            metadata,
+            cause,
+        });
+        this.name = 'HealthCheckConnectionError';
+    }
+}
+export function normalizeConnectionError(error) {
+    if (error instanceof ConnectionError) {
+        return error;
+    }
+    return new ConnectionError(error.message, {
+        code: 'CONNECTION_FAILED',
+        phase: 'connect',
+        suggestions: ['请检查连接参数并重试'],
+        cause: error,
+    });
+}
+//# sourceMappingURL=errors.js.map

package/build/connection/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/connection/errors.ts"],"names":[],"mappings":"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"}

package/build/connection/health-probe.d.ts

@@ -0,0 +1,4 @@
+import type { MiniProgram } from 'miniprogram-automator';
+import type { ConnectionHealth } from './types.js';
+export declare function probeConnectionHealth(miniProgram: MiniProgram): Promise<ConnectionHealth>;
+//# sourceMappingURL=health-probe.d.ts.map

package/build/connection/health-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-probe.d.ts","sourceRoot":"","sources":["../../src/connection/health-probe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,KAAK,EACV,gBAAgB,EAGjB,MAAM,YAAY,CAAC;AAwCpB,wBAAsB,qBAAqB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA+B/F"}

package/build/connection/health-probe.js

@@ -0,0 +1,60 @@
+async function runCheck(name, execute) {
+    const start = Date.now();
+    try {
+        const result = await execute();
+        return {
+            name,
+            status: result.passed ? 'pass' : 'fail',
+            message: result.message,
+            durationMs: Date.now() - start,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            name,
+            status: 'fail',
+            message,
+            durationMs: Date.now() - start,
+        };
+    }
+}
+function resolveLevel(checks) {
+    const failures = checks.filter(check => check.status === 'fail').length;
+    if (failures === 0) {
+        return 'healthy';
+    }
+    const transportCheck = checks.find(check => check.name === 'transport');
+    if (!transportCheck || transportCheck.status === 'fail') {
+        return 'unhealthy';
+    }
+    return 'degraded';
+}
+export async function probeConnectionHealth(miniProgram) {
+    const checks = [];
+    checks.push(await runCheck('transport', async () => {
+        await miniProgram.evaluate(() => true);
+        return { passed: true, message: 'evaluate 调用成功' };
+    }));
+    let pagePath = '';
+    checks.push(await runCheck('session', async () => {
+        const page = await miniProgram.currentPage();
+        if (!page) {
+            return { passed: false, message: 'currentPage 为空' };
+        }
+        pagePath = await page.path;
+        return { passed: true, message: 'currentPage 可访问' };
+    }));
+    checks.push(await runCheck('page', async () => {
+        if (!pagePath) {
+            return { passed: false, message: '页面路径为空' };
+        }
+        return { passed: true, message: `当前页面: ${pagePath}` };
+    }));
+    return {
+        level: resolveLevel(checks),
+        checks,
+        checkedAt: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=health-probe.js.map

package/build/connection/health-probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-probe.js","sourceRoot":"","sources":["../../src/connection/health-probe.ts"],"names":[],"mappings":"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"}

package/build/connection/index.d.ts

@@ -0,0 +1,6 @@
+export { ConnectionManager } from './manager.js';
+export { probeConnectionHealth } from './health-probe.js';
+export { resolveConnectionPlan } from './resolver.js';
+export * from './errors.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/build/connection/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/connection/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/build/connection/index.js

@@ -0,0 +1,6 @@
+export { ConnectionManager } from './manager.js';
+export { probeConnectionHealth } from './health-probe.js';
+export { resolveConnectionPlan } from './resolver.js';
+export * from './errors.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/build/connection/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/connection/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/build/connection/manager.d.ts

@@ -0,0 +1,19 @@
+import type { MiniProgram, Page } from 'miniprogram-automator';
+import { type ConnectionConnectResult, type ConnectionErrorSummary, type ConnectionRequest, type ConnectionStatusSnapshot, type ResolvedConnectionRequest } from './types.js';
+interface StoredSession {
+    miniProgram: MiniProgram;
+    currentPage: Page;
+}
+export declare class ConnectionManager {
+    #private;
+    getSession(): StoredSession | null;
+    getStatusSnapshot(): ConnectionStatusSnapshot;
+    getLastRequest(): ResolvedConnectionRequest | null;
+    connect(request: ConnectionRequest): Promise<ConnectionConnectResult>;
+    reconnect(request?: ConnectionRequest): Promise<ConnectionConnectResult>;
+    disconnect(): Promise<ConnectionStatusSnapshot>;
+    refreshHealth(): Promise<ConnectionStatusSnapshot>;
+    markDisconnectedWithError(error: ConnectionErrorSummary): ConnectionStatusSnapshot;
+}
+export {};
+//# sourceMappingURL=manager.d.ts.map

package/build/connection/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/connection/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAW/D,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAE3B,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC/B,MAAM,YAAY,CAAC;AAKpB,UAAU,aAAa;IACrB,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,EAAE,IAAI,CAAC;CACnB;AAmBD,qBAAa,iBAAiB;;IAsN5B,UAAU,IAAI,aAAa,GAAG,IAAI;IAIlC,iBAAiB,IAAI,wBAAwB;IAI7C,cAAc,IAAI,yBAAyB,GAAG,IAAI;IAI5C,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAIrE,SAAS,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAIxE,UAAU,IAAI,OAAO,CAAC,wBAAwB,CAAC;IAI/C,aAAa,IAAI,OAAO,CAAC,wBAAwB,CAAC;IAIxD,yBAAyB,CAAC,KAAK,EAAE,sBAAsB,GAAG,wBAAwB;CAQnF"}