weixin-devtools-mcp 0.0.1 → 0.1.1

package/build/connection/manager.js

@@ -0,0 +1,227 @@
+import { executeConnectionStrategy } from './adapters.js';
+import { HealthCheckConnectionError, ValidationConnectionError, normalizeConnectionError, } from './errors.js';
+import { probeConnectionHealth } from './health-probe.js';
+import { resolveConnectionPlan } from './resolver.js';
+import { createDisconnectedStatus, } from './types.js';
+const DISCONNECT_SETTLE_DELAY_MS = 200;
+const RECONNECT_DELAY_MS = 300;
+function createConnectionId() {
+    return `conn_${Date.now()}_${Math.random().toString(36).slice(2, 10)}`;
+}
+function cloneStatus(status) {
+    return {
+        ...status,
+        health: status.health
+            ? {
+                ...status.health,
+                checks: status.health.checks.map(check => ({ ...check })),
+            }
+            : null,
+        lastError: status.lastError ? { ...status.lastError } : null,
+    };
+}
+export class ConnectionManager {
+    #session = null;
+    #status = createDisconnectedStatus();
+    #lastRequest = null;
+    #lifecycleQueue = Promise.resolve();
+    #enqueueLifecycleOperation(operation) {
+        const task = this.#lifecycleQueue.then(operation, operation);
+        this.#lifecycleQueue = task.then(() => undefined, () => undefined);
+        return task;
+    }
+    async #cleanupMiniProgram(miniProgram) {
+        try {
+            await miniProgram.disconnect();
+        }
+        catch {
+            // 忽略断连异常，始终收敛本地状态
+        }
+        await new Promise(resolve => setTimeout(resolve, DISCONNECT_SETTLE_DELAY_MS));
+    }
+    async #cleanupCurrentSession(options) {
+        const activeSession = this.#session;
+        this.#session = null;
+        if (activeSession?.miniProgram) {
+            await this.#cleanupMiniProgram(activeSession.miniProgram);
+        }
+        this.#status = {
+            ...createDisconnectedStatus(),
+            lastError: options?.lastError ?? null,
+        };
+        if (options?.clearLastRequest) {
+            this.#lastRequest = null;
+        }
+        return this.getStatusSnapshot();
+    }
+    async #connectInternal(request) {
+        const plan = resolveConnectionPlan(request);
+        // 单活语义：新建连接前先清理已有会话
+        await this.#cleanupCurrentSession();
+        this.#status = {
+            ...createDisconnectedStatus(),
+            state: 'connecting',
+            connected: false,
+            strategyUsed: null,
+            endpoint: null,
+            lastError: null,
+        };
+        const startedAt = Date.now();
+        const warnings = [];
+        let latestError = null;
+        for (const strategy of plan.attempts) {
+            const attemptStartedAt = Date.now();
+            let attemptSession = null;
+            try {
+                const adapterResult = await executeConnectionStrategy(strategy, plan.request);
+                attemptSession = {
+                    miniProgram: adapterResult.miniProgram,
+                    currentPage: adapterResult.currentPage,
+                };
+                const connectMs = Date.now() - attemptStartedAt;
+                const healthStart = Date.now();
+                const health = plan.request.healthCheck
+                    ? await probeConnectionHealth(adapterResult.miniProgram)
+                    : {
+                        level: 'healthy',
+                        checks: [],
+                        checkedAt: new Date().toISOString(),
+                    };
+                if (health.level === 'unhealthy') {
+                    throw new HealthCheckConnectionError('连接后健康检查失败', {
+                        strategy,
+                        endpoint: adapterResult.endpoint,
+                    });
+                }
+                const connectionId = createConnectionId();
+                const totalMs = Date.now() - startedAt;
+                const healthMs = Date.now() - healthStart;
+                const pagePath = adapterResult.pagePath;
+                const status = health.level === 'healthy' ? 'connected' : 'degraded';
+                this.#session = attemptSession;
+                attemptSession = null;
+                this.#lastRequest = {
+                    ...plan.request,
+                    strategy,
+                    fallback: plan.request.fallback.filter(item => item !== strategy),
+                };
+                this.#status = {
+                    connectionId,
+                    state: status,
+                    strategyUsed: adapterResult.strategyUsed,
+                    endpoint: adapterResult.endpoint,
+                    connected: true,
+                    hasCurrentPage: pagePath.length > 0,
+                    pagePath,
+                    health,
+                    lastError: null,
+                    lastConnectedAt: new Date().toISOString(),
+                    lastHealthCheckAt: health.checkedAt,
+                };
+                return {
+                    ...adapterResult,
+                    connectionId,
+                    health,
+                    status,
+                    timing: {
+                        totalMs,
+                        connectMs,
+                        healthMs,
+                    },
+                    warnings,
+                };
+            }
+            catch (error) {
+                if (attemptSession?.miniProgram) {
+                    await this.#cleanupMiniProgram(attemptSession.miniProgram);
+                    attemptSession = null;
+                }
+                latestError = normalizeConnectionError(error instanceof Error ? error : new Error(String(error)));
+                warnings.push(`[${strategy}] ${latestError.message}`);
+            }
+        }
+        if (!latestError) {
+            latestError = new ValidationConnectionError('未执行任何连接尝试');
+        }
+        await this.#cleanupCurrentSession({
+            lastError: latestError.toSummary(),
+        });
+        throw latestError;
+    }
+    async #reconnectInternal(request) {
+        const baseRequest = request ?? this.#lastRequest;
+        if (!baseRequest) {
+            throw new ValidationConnectionError('没有可用于重连的历史连接参数', ['调用 reconnect_devtools 时显式传入连接参数']);
+        }
+        await this.#disconnectInternal();
+        await new Promise(resolve => setTimeout(resolve, RECONNECT_DELAY_MS));
+        return this.#connectInternal(baseRequest);
+    }
+    async #disconnectInternal() {
+        return this.#cleanupCurrentSession();
+    }
+    async #refreshHealthInternal() {
+        if (!this.#session) {
+            this.#status = createDisconnectedStatus();
+            return this.getStatusSnapshot();
+        }
+        const health = await probeConnectionHealth(this.#session.miniProgram);
+        const levelToState = {
+            healthy: 'connected',
+            degraded: 'degraded',
+            unhealthy: 'disconnected',
+        };
+        if (health.level === 'unhealthy') {
+            return this.#cleanupCurrentSession({
+                lastError: {
+                    code: 'HEALTH_CHECK_FAILED',
+                    phase: 'health_check',
+                    message: '连接健康检查失败，已自动断开连接',
+                    suggestions: ['调用 connect_devtools 或 reconnect_devtools 重新建立连接'],
+                    timestamp: new Date().toISOString(),
+                },
+            });
+        }
+        const pagePath = this.#session.currentPage ? await this.#session.currentPage.path : null;
+        this.#status = {
+            ...this.#status,
+            state: levelToState[health.level],
+            connected: true,
+            hasCurrentPage: !!pagePath,
+            pagePath,
+            health,
+            lastHealthCheckAt: health.checkedAt,
+        };
+        return this.getStatusSnapshot();
+    }
+    getSession() {
+        return this.#session;
+    }
+    getStatusSnapshot() {
+        return cloneStatus(this.#status);
+    }
+    getLastRequest() {
+        return this.#lastRequest ? { ...this.#lastRequest, fallback: [...this.#lastRequest.fallback] } : null;
+    }
+    async connect(request) {
+        return this.#enqueueLifecycleOperation(() => this.#connectInternal(request));
+    }
+    async reconnect(request) {
+        return this.#enqueueLifecycleOperation(() => this.#reconnectInternal(request));
+    }
+    async disconnect() {
+        return this.#enqueueLifecycleOperation(() => this.#disconnectInternal());
+    }
+    async refreshHealth() {
+        return this.#enqueueLifecycleOperation(() => this.#refreshHealthInternal());
+    }
+    markDisconnectedWithError(error) {
+        this.#session = null;
+        this.#status = {
+            ...createDisconnectedStatus(),
+            lastError: error,
+        };
+        return this.getStatusSnapshot();
+    }
+}
+//# sourceMappingURL=manager.js.map

package/build/connection/manager.js.map

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

package/build/connection/resolver.d.ts

@@ -0,0 +1,3 @@
+import type { ConnectionRequest, ResolvedConnectionPlan } from './types.js';
+export declare function resolveConnectionPlan(rawRequest: ConnectionRequest): ResolvedConnectionPlan;
+//# sourceMappingURL=resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/connection/resolver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,iBAAiB,EAEjB,sBAAsB,EAEvB,MAAM,YAAY,CAAC;AAkHpB,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,iBAAiB,GAAG,sBAAsB,CA4B3F"}

package/build/connection/resolver.js

@@ -0,0 +1,99 @@
+import { ValidationConnectionError } from './errors.js';
+const DEFAULT_TIMEOUT_MS = 45_000;
+const DEFAULT_FALLBACK_FOR_LAUNCH = ['connect'];
+const DEFAULT_FALLBACK_FOR_CONNECT = ['launch'];
+const DEFAULT_FALLBACK_FOR_ENDPOINT = ['discover', 'launch', 'connect'];
+function uniqueStrategies(strategies) {
+    const result = [];
+    for (const strategy of strategies) {
+        if (!result.includes(strategy)) {
+            result.push(strategy);
+        }
+    }
+    return result;
+}
+function resolvePrimaryStrategy(request) {
+    if (request.strategy) {
+        return request.strategy;
+    }
+    if (request.wsEndpoint) {
+        return 'wsEndpoint';
+    }
+    if (request.browserUrl) {
+        return 'browserUrl';
+    }
+    if (request.autoDiscover) {
+        return 'discover';
+    }
+    return 'auto';
+}
+function resolveFallbackStrategies(primary, request) {
+    if (request.fallback && request.fallback.length > 0) {
+        return request.fallback.filter(strategy => strategy !== primary);
+    }
+    if (primary === 'launch') {
+        return [...DEFAULT_FALLBACK_FOR_LAUNCH];
+    }
+    if (primary === 'connect') {
+        return [...DEFAULT_FALLBACK_FOR_CONNECT];
+    }
+    if (primary === 'wsEndpoint' || primary === 'browserUrl') {
+        return [...DEFAULT_FALLBACK_FOR_ENDPOINT];
+    }
+    if (primary === 'discover') {
+        const fallback = [];
+        if (request.projectPath) {
+            fallback.push('launch', 'connect');
+        }
+        return fallback;
+    }
+    if (primary === 'auto') {
+        return request.projectPath ? ['launch', 'connect'] : ['discover'];
+    }
+    return [];
+}
+function validateRequest(request) {
+    if (request.wsHeaders !== undefined) {
+        throw new ValidationConnectionError('当前连接链路不支持 wsHeaders 参数', ['请移除 wsHeaders 参数后重试'], { strategy: request.strategy });
+    }
+    if (request.strategy === 'launch' || request.strategy === 'connect') {
+        if (!request.projectPath) {
+            throw new ValidationConnectionError(`${request.strategy} 策略要求提供 projectPath`, ['为 connect_devtools 传入 projectPath'], { strategy: request.strategy });
+        }
+    }
+    if (request.strategy === 'wsEndpoint' && !request.wsEndpoint) {
+        throw new ValidationConnectionError('wsEndpoint 策略要求提供 wsEndpoint', ['设置 wsEndpoint，例如 ws://127.0.0.1:9420']);
+    }
+    if (request.strategy === 'browserUrl' && !request.browserUrl) {
+        throw new ValidationConnectionError('browserUrl 策略要求提供 browserUrl', ['设置 browserUrl，例如 http://127.0.0.1:9222']);
+    }
+    if (request.timeoutMs <= 0) {
+        throw new ValidationConnectionError('timeoutMs 必须是正数', ['设置一个大于 0 的超时时间'], { timeoutMs: request.timeoutMs });
+    }
+}
+export function resolveConnectionPlan(rawRequest) {
+    const strategy = resolvePrimaryStrategy(rawRequest);
+    const fallback = uniqueStrategies(resolveFallbackStrategies(strategy, rawRequest));
+    const request = {
+        strategy,
+        projectPath: rawRequest.projectPath,
+        cliPath: rawRequest.cliPath,
+        autoPort: rawRequest.autoPort,
+        browserUrl: rawRequest.browserUrl,
+        wsEndpoint: rawRequest.wsEndpoint,
+        wsHeaders: rawRequest.wsHeaders,
+        timeoutMs: rawRequest.timeoutMs ?? DEFAULT_TIMEOUT_MS,
+        fallback,
+        healthCheck: rawRequest.healthCheck ?? true,
+        verbose: rawRequest.verbose ?? false,
+        autoAudits: rawRequest.autoAudits,
+        autoDiscover: rawRequest.autoDiscover ?? true,
+    };
+    validateRequest(request);
+    const attempts = uniqueStrategies([request.strategy, ...request.fallback]);
+    return {
+        request,
+        attempts,
+    };
+}
+//# sourceMappingURL=resolver.js.map

package/build/connection/resolver.js.map

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

package/build/connection/types.d.ts

@@ -0,0 +1,95 @@
+import type { MiniProgram, Page } from 'miniprogram-automator';
+export type ConnectionState = 'disconnected' | 'connecting' | 'connected' | 'degraded';
+export type ConnectionStrategy = 'auto' | 'launch' | 'connect' | 'wsEndpoint' | 'browserUrl' | 'discover';
+export type ConnectionPhase = 'resolve' | 'startup' | 'connect' | 'health_check' | 'disconnect';
+export type MetadataValue = string | number | boolean | null;
+export interface ConnectionErrorSummary {
+    code: string;
+    phase: ConnectionPhase;
+    message: string;
+    suggestions: string[];
+    metadata?: Record<string, MetadataValue>;
+    timestamp: string;
+}
+export interface ConnectionRequest {
+    strategy?: ConnectionStrategy;
+    projectPath?: string;
+    cliPath?: string;
+    autoPort?: number;
+    browserUrl?: string;
+    wsEndpoint?: string;
+    wsHeaders?: Record<string, string>;
+    timeoutMs?: number;
+    fallback?: ConnectionStrategy[];
+    healthCheck?: boolean;
+    verbose?: boolean;
+    autoAudits?: boolean;
+    autoDiscover?: boolean;
+}
+export interface ResolvedConnectionRequest {
+    strategy: ConnectionStrategy;
+    projectPath?: string;
+    cliPath?: string;
+    autoPort?: number;
+    browserUrl?: string;
+    wsEndpoint?: string;
+    wsHeaders?: Record<string, string>;
+    timeoutMs: number;
+    fallback: ConnectionStrategy[];
+    healthCheck: boolean;
+    verbose: boolean;
+    autoAudits?: boolean;
+    autoDiscover: boolean;
+}
+export interface ResolvedConnectionPlan {
+    request: ResolvedConnectionRequest;
+    attempts: ConnectionStrategy[];
+}
+export type HealthCheckName = 'transport' | 'session' | 'page';
+export type HealthCheckStatus = 'pass' | 'fail';
+export interface HealthCheckItem {
+    name: HealthCheckName;
+    status: HealthCheckStatus;
+    message: string;
+    durationMs: number;
+}
+export type HealthLevel = 'healthy' | 'degraded' | 'unhealthy';
+export interface ConnectionHealth {
+    level: HealthLevel;
+    checks: HealthCheckItem[];
+    checkedAt: string;
+}
+export interface AdapterConnectionResult {
+    strategyUsed: ConnectionStrategy;
+    endpoint: string | null;
+    miniProgram: MiniProgram;
+    currentPage: Page;
+    pagePath: string;
+}
+export interface ConnectionTiming {
+    totalMs: number;
+    connectMs: number;
+    healthMs: number;
+}
+export interface ConnectionConnectResult extends AdapterConnectionResult {
+    connectionId: string;
+    health: ConnectionHealth;
+    status: Extract<ConnectionState, 'connected' | 'degraded'>;
+    timing: ConnectionTiming;
+    warnings: string[];
+}
+export interface ConnectionStatusSnapshot {
+    connectionId: string | null;
+    state: ConnectionState;
+    strategyUsed: ConnectionStrategy | null;
+    endpoint: string | null;
+    connected: boolean;
+    hasCurrentPage: boolean;
+    pagePath: string | null;
+    health: ConnectionHealth | null;
+    lastError: ConnectionErrorSummary | null;
+    lastConnectedAt: string | null;
+    lastHealthCheckAt: string | null;
+}
+export declare function createDisconnectedStatus(): ConnectionStatusSnapshot;
+//# sourceMappingURL=types.d.ts.map

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

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

package/build/connection/types.js

@@ -0,0 +1,16 @@
+export function createDisconnectedStatus() {
+    return {
+        connectionId: null,
+        state: 'disconnected',
+        strategyUsed: null,
+        endpoint: null,
+        connected: false,
+        hasCurrentPage: false,
+        pagePath: null,
+        health: null,
+        lastError: null,
+        lastConnectedAt: null,
+        lastHealthCheckAt: null,
+    };
+}
+//# sourceMappingURL=types.js.map

package/build/connection/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/connection/types.ts"],"names":[],"mappings":"AAyHA,MAAM,UAAU,wBAAwB;IACtC,OAAO;QACL,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,cAAc;QACrB,YAAY,EAAE,IAAI;QAClB,QAAQ,EAAE,IAAI;QACd,SAAS,EAAE,KAAK;QAChB,cAAc,EAAE,KAAK;QACrB,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,IAAI;QACf,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,IAAI;KACxB,CAAC;AACJ,CAAC"}

package/build/core/assertion.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 断言验证核心逻辑
+ * 从 src/tools.ts 提取
+ */
+import type { ElementMapInfo, AssertResult, ExistenceAssertOptions, StateAssertOptions, ContentAssertOptions } from './types.js';
+/**
+ * 断言元素存在性
+ */
+export declare function assertElementExists(page: any, options: ExistenceAssertOptions): Promise<AssertResult>;
+/**
+ * 断言元素可见性
+ */
+export declare function assertElementVisible(page: any, elementMap: Map<string, ElementMapInfo>, options: StateAssertOptions): Promise<AssertResult>;
+/**
+ * 断言元素文本内容
+ */
+export declare function assertElementText(page: any, elementMap: Map<string, ElementMapInfo>, options: ContentAssertOptions): Promise<AssertResult>;
+/**
+ * 断言元素属性
+ */
+export declare function assertElementAttribute(page: any, elementMap: Map<string, ElementMapInfo>, options: ContentAssertOptions): Promise<AssertResult>;
+//# sourceMappingURL=assertion.d.ts.map

package/build/core/assertion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertion.d.ts","sourceRoot":"","sources":["../../src/core/assertion.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAIpB;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,GAAG,EACT,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,YAAY,CAAC,CA4DvB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,GAAG,EACT,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,EACvC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAmFvB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,GAAG,EACT,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,EACvC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,YAAY,CAAC,CAuGvB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,GAAG,EACT,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,EACvC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,YAAY,CAAC,CAkFvB"}