@metamask/client-mcp-core 0.1.0

package/dist/mcp-server/test-utils/mock-factories.d.cts

@@ -0,0 +1,89 @@
+/**
+ * Shared mock factory utilities for unit testing.
+ *
+ * Provides factory functions that return fresh mock instances following MetaMask testing guidelines:
+ * - Each factory call returns NEW object instances (test isolation)
+ * - Each factory creates fresh vi.fn() mocks (never reused)
+ * - Factories accept options for customization
+ * - Sensible defaults so most tests need no options
+ */
+import type { ExtensionState } from "../../capabilities/types.cjs";
+import type { KnowledgeStore } from "../knowledge-store.cjs";
+import type { TrackedPage, SessionLaunchResult } from "../session-manager.cjs";
+import type { SessionState } from "../types/session.cjs";
+import type { SessionMetadata } from "../types/step-record.cjs";
+/**
+ * Options for customizing mock session manager behavior
+ */
+export type MockSessionManagerOptions = {
+    hasActive?: boolean;
+    sessionId?: string;
+    sessionState?: SessionState;
+    sessionMetadata?: SessionMetadata;
+    launchResult?: SessionLaunchResult;
+    trackedPages?: TrackedPage[];
+    extensionState?: ExtensionState;
+    refMap?: Map<string, string>;
+    environmentMode?: 'e2e' | 'prod';
+};
+/**
+ * Options for customizing mock knowledge store behavior
+ */
+export type MockKnowledgeStoreOptions = {
+    lastSteps?: Record<string, unknown>[];
+    searchResults?: Record<string, unknown>[];
+    sessionSummary?: Record<string, unknown>;
+    sessions?: Record<string, unknown>[];
+};
+/**
+ * Create a fresh mock ISessionManager instance.
+ *
+ * Each call returns a NEW object with fresh vi.fn() mocks.
+ * Follows the pattern from session-manager.test.ts:15-48.
+ *
+ * @param options - Customize mock behavior
+ * @returns Fresh ISessionManager mock
+ */
+export declare function createMockSessionManager(options?: MockSessionManagerOptions): {
+    hasActiveSession: import("vitest").Mock<(...args: any[]) => any>;
+    getSessionId: import("vitest").Mock<(...args: any[]) => any>;
+    getSessionState: import("vitest").Mock<(...args: any[]) => any>;
+    getSessionMetadata: import("vitest").Mock<(...args: any[]) => any>;
+    launch: import("vitest").Mock<(...args: any[]) => any>;
+    cleanup: import("vitest").Mock<(...args: any[]) => any>;
+    getPage: import("vitest").Mock<(...args: any[]) => any>;
+    setActivePage: import("vitest").Mock<(...args: any[]) => any>;
+    getTrackedPages: import("vitest").Mock<(...args: any[]) => any>;
+    classifyPageRole: import("vitest").Mock<(...args: any[]) => any>;
+    getContext: import("vitest").Mock<(...args: any[]) => any>;
+    getExtensionState: import("vitest").Mock<(...args: any[]) => any>;
+    setRefMap: import("vitest").Mock<(...args: any[]) => any>;
+    getRefMap: import("vitest").Mock<(...args: any[]) => any>;
+    clearRefMap: import("vitest").Mock<(...args: any[]) => any>;
+    resolveA11yRef: import("vitest").Mock<(...args: any[]) => any>;
+    navigateToHome: import("vitest").Mock<(...args: any[]) => any>;
+    navigateToSettings: import("vitest").Mock<(...args: any[]) => any>;
+    navigateToUrl: import("vitest").Mock<(...args: any[]) => any>;
+    navigateToNotification: import("vitest").Mock<(...args: any[]) => any>;
+    waitForNotificationPage: import("vitest").Mock<(...args: any[]) => any>;
+    screenshot: import("vitest").Mock<(...args: any[]) => any>;
+    getBuildCapability: import("vitest").Mock<(...args: any[]) => any>;
+    getFixtureCapability: import("vitest").Mock<(...args: any[]) => any>;
+    getChainCapability: import("vitest").Mock<(...args: any[]) => any>;
+    getContractSeedingCapability: import("vitest").Mock<(...args: any[]) => any>;
+    getStateSnapshotCapability: import("vitest").Mock<(...args: any[]) => any>;
+    getEnvironmentMode: import("vitest").Mock<(...args: any[]) => any>;
+    setContext: import("vitest").Mock<(...args: any[]) => any>;
+    getContextInfo: import("vitest").Mock<(...args: any[]) => any>;
+};
+/**
+ * Create a fresh mock KnowledgeStore instance.
+ *
+ * Returns an in-memory mock with sensible defaults.
+ * Each call creates fresh vi.fn() mocks.
+ *
+ * @param options - Customize mock behavior
+ * @returns Fresh KnowledgeStore mock
+ */
+export declare function createMockKnowledgeStore(options?: MockKnowledgeStoreOptions): Partial<KnowledgeStore>;
+//# sourceMappingURL=mock-factories.d.cts.map

package/dist/mcp-server/test-utils/mock-factories.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-factories.d.cts","sourceRoot":"","sources":["../../../src/mcp-server/test-utils/mock-factories.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,qCAAoC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,+BAA8B;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,+BAA8B;AAC9E,OAAO,KAAK,EAAE,YAAY,EAAE,6BAA4B;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,iCAAgC;AAE/D;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;IAC7B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,eAAe,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CAClC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CACtC,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,yBAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6FxC;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,cAAc,CAAC,CAgBzB"}

package/dist/mcp-server/test-utils/mock-factories.d.mts

@@ -0,0 +1,89 @@
+/**
+ * Shared mock factory utilities for unit testing.
+ *
+ * Provides factory functions that return fresh mock instances following MetaMask testing guidelines:
+ * - Each factory call returns NEW object instances (test isolation)
+ * - Each factory creates fresh vi.fn() mocks (never reused)
+ * - Factories accept options for customization
+ * - Sensible defaults so most tests need no options
+ */
+import type { ExtensionState } from "../../capabilities/types.mjs";
+import type { KnowledgeStore } from "../knowledge-store.mjs";
+import type { TrackedPage, SessionLaunchResult } from "../session-manager.mjs";
+import type { SessionState } from "../types/session.mjs";
+import type { SessionMetadata } from "../types/step-record.mjs";
+/**
+ * Options for customizing mock session manager behavior
+ */
+export type MockSessionManagerOptions = {
+    hasActive?: boolean;
+    sessionId?: string;
+    sessionState?: SessionState;
+    sessionMetadata?: SessionMetadata;
+    launchResult?: SessionLaunchResult;
+    trackedPages?: TrackedPage[];
+    extensionState?: ExtensionState;
+    refMap?: Map<string, string>;
+    environmentMode?: 'e2e' | 'prod';
+};
+/**
+ * Options for customizing mock knowledge store behavior
+ */
+export type MockKnowledgeStoreOptions = {
+    lastSteps?: Record<string, unknown>[];
+    searchResults?: Record<string, unknown>[];
+    sessionSummary?: Record<string, unknown>;
+    sessions?: Record<string, unknown>[];
+};
+/**
+ * Create a fresh mock ISessionManager instance.
+ *
+ * Each call returns a NEW object with fresh vi.fn() mocks.
+ * Follows the pattern from session-manager.test.ts:15-48.
+ *
+ * @param options - Customize mock behavior
+ * @returns Fresh ISessionManager mock
+ */
+export declare function createMockSessionManager(options?: MockSessionManagerOptions): {
+    hasActiveSession: import("vitest").Mock<(...args: any[]) => any>;
+    getSessionId: import("vitest").Mock<(...args: any[]) => any>;
+    getSessionState: import("vitest").Mock<(...args: any[]) => any>;
+    getSessionMetadata: import("vitest").Mock<(...args: any[]) => any>;
+    launch: import("vitest").Mock<(...args: any[]) => any>;
+    cleanup: import("vitest").Mock<(...args: any[]) => any>;
+    getPage: import("vitest").Mock<(...args: any[]) => any>;
+    setActivePage: import("vitest").Mock<(...args: any[]) => any>;
+    getTrackedPages: import("vitest").Mock<(...args: any[]) => any>;
+    classifyPageRole: import("vitest").Mock<(...args: any[]) => any>;
+    getContext: import("vitest").Mock<(...args: any[]) => any>;
+    getExtensionState: import("vitest").Mock<(...args: any[]) => any>;
+    setRefMap: import("vitest").Mock<(...args: any[]) => any>;
+    getRefMap: import("vitest").Mock<(...args: any[]) => any>;
+    clearRefMap: import("vitest").Mock<(...args: any[]) => any>;
+    resolveA11yRef: import("vitest").Mock<(...args: any[]) => any>;
+    navigateToHome: import("vitest").Mock<(...args: any[]) => any>;
+    navigateToSettings: import("vitest").Mock<(...args: any[]) => any>;
+    navigateToUrl: import("vitest").Mock<(...args: any[]) => any>;
+    navigateToNotification: import("vitest").Mock<(...args: any[]) => any>;
+    waitForNotificationPage: import("vitest").Mock<(...args: any[]) => any>;
+    screenshot: import("vitest").Mock<(...args: any[]) => any>;
+    getBuildCapability: import("vitest").Mock<(...args: any[]) => any>;
+    getFixtureCapability: import("vitest").Mock<(...args: any[]) => any>;
+    getChainCapability: import("vitest").Mock<(...args: any[]) => any>;
+    getContractSeedingCapability: import("vitest").Mock<(...args: any[]) => any>;
+    getStateSnapshotCapability: import("vitest").Mock<(...args: any[]) => any>;
+    getEnvironmentMode: import("vitest").Mock<(...args: any[]) => any>;
+    setContext: import("vitest").Mock<(...args: any[]) => any>;
+    getContextInfo: import("vitest").Mock<(...args: any[]) => any>;
+};
+/**
+ * Create a fresh mock KnowledgeStore instance.
+ *
+ * Returns an in-memory mock with sensible defaults.
+ * Each call creates fresh vi.fn() mocks.
+ *
+ * @param options - Customize mock behavior
+ * @returns Fresh KnowledgeStore mock
+ */
+export declare function createMockKnowledgeStore(options?: MockKnowledgeStoreOptions): Partial<KnowledgeStore>;
+//# sourceMappingURL=mock-factories.d.mts.map

package/dist/mcp-server/test-utils/mock-factories.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-factories.d.mts","sourceRoot":"","sources":["../../../src/mcp-server/test-utils/mock-factories.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,qCAAoC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,+BAA8B;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,+BAA8B;AAC9E,OAAO,KAAK,EAAE,YAAY,EAAE,6BAA4B;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,iCAAgC;AAE/D;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;IAC7B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,eAAe,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CAClC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CACtC,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,yBAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6FxC;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,cAAc,CAAC,CAgBzB"}

package/dist/mcp-server/test-utils/mock-factories.mjs

@@ -0,0 +1,125 @@
+/**
+ * Shared mock factory utilities for unit testing.
+ *
+ * Provides factory functions that return fresh mock instances following MetaMask testing guidelines:
+ * - Each factory call returns NEW object instances (test isolation)
+ * - Each factory creates fresh vi.fn() mocks (never reused)
+ * - Factories accept options for customization
+ * - Sensible defaults so most tests need no options
+ */
+import { vi } from "vitest";
+/**
+ * Create a fresh mock ISessionManager instance.
+ *
+ * Each call returns a NEW object with fresh vi.fn() mocks.
+ * Follows the pattern from session-manager.test.ts:15-48.
+ *
+ * @param options - Customize mock behavior
+ * @returns Fresh ISessionManager mock
+ */
+export function createMockSessionManager(options = {}) {
+    return {
+        // Session Lifecycle
+        hasActiveSession: vi.fn().mockReturnValue(options.hasActive ?? false),
+        getSessionId: vi.fn().mockReturnValue(options.sessionId ?? undefined),
+        getSessionState: vi.fn().mockReturnValue(options.sessionState ?? undefined),
+        getSessionMetadata: vi
+            .fn()
+            .mockReturnValue(options.sessionMetadata ?? undefined),
+        launch: vi.fn().mockResolvedValue(options.launchResult ?? {
+            sessionId: 'test-session-123',
+            extensionId: 'ext-123',
+            state: {
+                isLoaded: true,
+                currentUrl: 'chrome-extension://ext-123/home.html',
+                extensionId: 'ext-123',
+                isUnlocked: false,
+                currentScreen: 'home',
+                accountAddress: null,
+                networkName: null,
+                chainId: null,
+                balance: null,
+            },
+        }),
+        cleanup: vi.fn().mockResolvedValue(true),
+        // Page Management
+        getPage: vi.fn(),
+        setActivePage: vi.fn(),
+        getTrackedPages: vi.fn().mockReturnValue(options.trackedPages ?? []),
+        classifyPageRole: vi.fn().mockReturnValue('extension'),
+        getContext: vi.fn(),
+        // Extension State
+        getExtensionState: vi.fn().mockResolvedValue(options.extensionState ?? {
+            isLoaded: true,
+            currentUrl: 'chrome-extension://ext-123/home.html',
+            extensionId: 'ext-123',
+            isUnlocked: false,
+            currentScreen: 'home',
+            accountAddress: null,
+            networkName: null,
+            chainId: null,
+            balance: null,
+        }),
+        // A11y Reference Map
+        setRefMap: vi.fn(),
+        getRefMap: vi.fn().mockReturnValue(options.refMap ?? new Map()),
+        clearRefMap: vi.fn(),
+        resolveA11yRef: vi.fn(),
+        // Navigation
+        navigateToHome: vi.fn().mockResolvedValue(undefined),
+        navigateToSettings: vi.fn().mockResolvedValue(undefined),
+        navigateToUrl: vi.fn(),
+        navigateToNotification: vi.fn(),
+        waitForNotificationPage: vi.fn(),
+        // Screenshots
+        screenshot: vi.fn().mockResolvedValue({
+            path: '/path/to/screenshot.png',
+            width: 1280,
+            height: 720,
+        }),
+        // Capabilities
+        getBuildCapability: vi.fn().mockReturnValue(undefined),
+        getFixtureCapability: vi.fn().mockReturnValue(undefined),
+        getChainCapability: vi.fn().mockReturnValue(undefined),
+        getContractSeedingCapability: vi.fn().mockReturnValue(undefined),
+        getStateSnapshotCapability: vi.fn().mockReturnValue(undefined),
+        // Environment
+        getEnvironmentMode: vi
+            .fn()
+            .mockReturnValue(options.environmentMode ?? 'e2e'),
+        // Context
+        setContext: vi.fn().mockReturnValue(undefined),
+        getContextInfo: vi.fn().mockReturnValue({
+            currentContext: options.environmentMode ?? 'e2e',
+            hasActiveSession: options.hasActive ?? false,
+            sessionId: options.sessionId ?? null,
+            capabilities: { available: [] },
+            canSwitchContext: !(options.hasActive ?? false),
+        }),
+    };
+}
+/**
+ * Create a fresh mock KnowledgeStore instance.
+ *
+ * Returns an in-memory mock with sensible defaults.
+ * Each call creates fresh vi.fn() mocks.
+ *
+ * @param options - Customize mock behavior
+ * @returns Fresh KnowledgeStore mock
+ */
+export function createMockKnowledgeStore(options = {}) {
+    return {
+        recordStep: vi.fn().mockResolvedValue(undefined),
+        getLastSteps: vi.fn().mockResolvedValue(options.lastSteps ?? []),
+        searchSteps: vi.fn().mockResolvedValue(options.searchResults ?? []),
+        summarizeSession: vi.fn().mockResolvedValue(options.sessionSummary ?? {
+            sessionId: 'test-session-123',
+            stepCount: 0,
+            recipe: [],
+        }),
+        listSessions: vi.fn().mockResolvedValue(options.sessions ?? []),
+        generatePriorKnowledge: vi.fn().mockResolvedValue(undefined),
+        writeSessionMetadata: vi.fn().mockResolvedValue('test-session-123'),
+    };
+}
+//# sourceMappingURL=mock-factories.mjs.map

package/dist/mcp-server/test-utils/mock-factories.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-factories.mjs","sourceRoot":"","sources":["../../../src/mcp-server/test-utils/mock-factories.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Shared mock factory utilities for unit testing.\n *\n * Provides factory functions that return fresh mock instances following MetaMask testing guidelines:\n * - Each factory call returns NEW object instances (test isolation)\n * - Each factory creates fresh vi.fn() mocks (never reused)\n * - Factories accept options for customization\n * - Sensible defaults so most tests need no options\n */\n\nimport { vi } from 'vitest';\n\nimport type { ExtensionState } from '../../capabilities/types.js';\nimport type { KnowledgeStore } from '../knowledge-store.js';\nimport type { TrackedPage, SessionLaunchResult } from '../session-manager.js';\nimport type { SessionState } from '../types/session.js';\nimport type { SessionMetadata } from '../types/step-record.js';\n\n/**\n * Options for customizing mock session manager behavior\n */\nexport type MockSessionManagerOptions = {\n  hasActive?: boolean;\n  sessionId?: string;\n  sessionState?: SessionState;\n  sessionMetadata?: SessionMetadata;\n  launchResult?: SessionLaunchResult;\n  trackedPages?: TrackedPage[];\n  extensionState?: ExtensionState;\n  refMap?: Map<string, string>;\n  environmentMode?: 'e2e' | 'prod';\n};\n\n/**\n * Options for customizing mock knowledge store behavior\n */\nexport type MockKnowledgeStoreOptions = {\n  lastSteps?: Record<string, unknown>[];\n  searchResults?: Record<string, unknown>[];\n  sessionSummary?: Record<string, unknown>;\n  sessions?: Record<string, unknown>[];\n};\n\n/**\n * Create a fresh mock ISessionManager instance.\n *\n * Each call returns a NEW object with fresh vi.fn() mocks.\n * Follows the pattern from session-manager.test.ts:15-48.\n *\n * @param options - Customize mock behavior\n * @returns Fresh ISessionManager mock\n */\nexport function createMockSessionManager(\n  options: MockSessionManagerOptions = {},\n) {\n  return {\n    // Session Lifecycle\n    hasActiveSession: vi.fn().mockReturnValue(options.hasActive ?? false),\n    getSessionId: vi.fn().mockReturnValue(options.sessionId ?? undefined),\n    getSessionState: vi.fn().mockReturnValue(options.sessionState ?? undefined),\n    getSessionMetadata: vi\n      .fn()\n      .mockReturnValue(options.sessionMetadata ?? undefined),\n    launch: vi.fn().mockResolvedValue(\n      options.launchResult ?? {\n        sessionId: 'test-session-123',\n        extensionId: 'ext-123',\n        state: {\n          isLoaded: true,\n          currentUrl: 'chrome-extension://ext-123/home.html',\n          extensionId: 'ext-123',\n          isUnlocked: false,\n          currentScreen: 'home',\n          accountAddress: null,\n          networkName: null,\n          chainId: null,\n          balance: null,\n        },\n      },\n    ),\n    cleanup: vi.fn().mockResolvedValue(true),\n\n    // Page Management\n    getPage: vi.fn(),\n    setActivePage: vi.fn(),\n    getTrackedPages: vi.fn().mockReturnValue(options.trackedPages ?? []),\n    classifyPageRole: vi.fn().mockReturnValue('extension'),\n    getContext: vi.fn(),\n\n    // Extension State\n    getExtensionState: vi.fn().mockResolvedValue(\n      options.extensionState ?? {\n        isLoaded: true,\n        currentUrl: 'chrome-extension://ext-123/home.html',\n        extensionId: 'ext-123',\n        isUnlocked: false,\n        currentScreen: 'home',\n        accountAddress: null,\n        networkName: null,\n        chainId: null,\n        balance: null,\n      },\n    ),\n\n    // A11y Reference Map\n    setRefMap: vi.fn(),\n    getRefMap: vi.fn().mockReturnValue(options.refMap ?? new Map()),\n    clearRefMap: vi.fn(),\n    resolveA11yRef: vi.fn(),\n\n    // Navigation\n    navigateToHome: vi.fn().mockResolvedValue(undefined),\n    navigateToSettings: vi.fn().mockResolvedValue(undefined),\n    navigateToUrl: vi.fn(),\n    navigateToNotification: vi.fn(),\n    waitForNotificationPage: vi.fn(),\n\n    // Screenshots\n    screenshot: vi.fn().mockResolvedValue({\n      path: '/path/to/screenshot.png',\n      width: 1280,\n      height: 720,\n    }),\n\n    // Capabilities\n    getBuildCapability: vi.fn().mockReturnValue(undefined),\n    getFixtureCapability: vi.fn().mockReturnValue(undefined),\n    getChainCapability: vi.fn().mockReturnValue(undefined),\n    getContractSeedingCapability: vi.fn().mockReturnValue(undefined),\n    getStateSnapshotCapability: vi.fn().mockReturnValue(undefined),\n\n    // Environment\n    getEnvironmentMode: vi\n      .fn()\n      .mockReturnValue(options.environmentMode ?? 'e2e'),\n\n    // Context\n    setContext: vi.fn().mockReturnValue(undefined),\n    getContextInfo: vi.fn().mockReturnValue({\n      currentContext: options.environmentMode ?? 'e2e',\n      hasActiveSession: options.hasActive ?? false,\n      sessionId: options.sessionId ?? null,\n      capabilities: { available: [] },\n      canSwitchContext: !(options.hasActive ?? false),\n    }),\n  };\n}\n\n/**\n * Create a fresh mock KnowledgeStore instance.\n *\n * Returns an in-memory mock with sensible defaults.\n * Each call creates fresh vi.fn() mocks.\n *\n * @param options - Customize mock behavior\n * @returns Fresh KnowledgeStore mock\n */\nexport function createMockKnowledgeStore(\n  options: MockKnowledgeStoreOptions = {},\n): Partial<KnowledgeStore> {\n  return {\n    recordStep: vi.fn().mockResolvedValue(undefined),\n    getLastSteps: vi.fn().mockResolvedValue(options.lastSteps ?? []),\n    searchSteps: vi.fn().mockResolvedValue(options.searchResults ?? []),\n    summarizeSession: vi.fn().mockResolvedValue(\n      options.sessionSummary ?? {\n        sessionId: 'test-session-123',\n        stepCount: 0,\n        recipe: [],\n      },\n    ),\n    listSessions: vi.fn().mockResolvedValue(options.sessions ?? []),\n    generatePriorKnowledge: vi.fn().mockResolvedValue(undefined),\n    writeSessionMetadata: vi.fn().mockResolvedValue('test-session-123'),\n  };\n}\n"]}

package/dist/mcp-server/test-utils/mock-playwright.cjs

@@ -0,0 +1,205 @@
+"use strict";
+/**
+ * Playwright mock factories for unit testing.
+ *
+ * Provides factory functions that return fresh mock Playwright objects:
+ * - createMockPage() - Mock Playwright Page with all used methods
+ * - createMockLocator() - Mock Playwright Locator with chainable methods
+ * - createMockBrowserContext() - Mock BrowserContext
+ *
+ * Each factory call returns NEW instances with fresh vi.fn() mocks.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMockLocator = createMockLocator;
+exports.createMockPage = createMockPage;
+exports.createMockBrowserContext = createMockBrowserContext;
+const vitest_1 = require("vitest");
+/**
+ * Create a fresh mock Playwright Locator instance.
+ *
+ * Includes all methods used in tool handlers:
+ * - click() - async mock
+ * - fill(text) - async mock
+ * - isVisible() - async mock
+ * - getAttribute(name) - async mock
+ * - textContent() - async mock
+ * - all() - async mock
+ * - first() - returns mock locator
+ * - nth(index) - returns mock locator
+ *
+ * Methods are chainable where appropriate.
+ *
+ * @param options - Customize mock behavior
+ * @returns Fresh Locator mock
+ */
+function createMockLocator(options = {}) {
+    const mockLocator = {
+        click: vitest_1.vi.fn().mockResolvedValue(options.clickMock?.() ?? undefined),
+        fill: vitest_1.vi.fn().mockResolvedValue(options.fillMock?.('') ?? undefined),
+        isVisible: vitest_1.vi.fn().mockResolvedValue(options.isVisibleMock?.() ?? true),
+        getAttribute: vitest_1.vi
+            .fn()
+            .mockResolvedValue(options.getAttributeMock?.('') ?? null),
+        textContent: vitest_1.vi.fn().mockResolvedValue(options.textContentMock?.() ?? null),
+        all: vitest_1.vi.fn().mockResolvedValue(options.allMock?.() ?? []),
+        clear: vitest_1.vi.fn().mockResolvedValue(undefined),
+        check: vitest_1.vi.fn().mockResolvedValue(undefined),
+        uncheck: vitest_1.vi.fn().mockResolvedValue(undefined),
+        hover: vitest_1.vi.fn().mockResolvedValue(undefined),
+        focus: vitest_1.vi.fn().mockResolvedValue(undefined),
+        blur: vitest_1.vi.fn().mockResolvedValue(undefined),
+        type: vitest_1.vi.fn().mockResolvedValue(undefined),
+        press: vitest_1.vi.fn().mockResolvedValue(undefined),
+        selectOption: vitest_1.vi.fn().mockResolvedValue([]),
+        selectText: vitest_1.vi.fn().mockResolvedValue(undefined),
+        setInputFiles: vitest_1.vi.fn().mockResolvedValue(undefined),
+        setChecked: vitest_1.vi.fn().mockResolvedValue(undefined),
+        dragTo: vitest_1.vi.fn().mockResolvedValue(undefined),
+        screenshot: vitest_1.vi.fn().mockResolvedValue(Buffer.from('')),
+        scrollIntoViewIfNeeded: vitest_1.vi.fn().mockResolvedValue(undefined),
+        waitFor: vitest_1.vi.fn().mockResolvedValue(undefined),
+        evaluate: vitest_1.vi.fn().mockResolvedValue(undefined),
+        evaluateAll: vitest_1.vi.fn().mockResolvedValue([]),
+        evaluateHandle: vitest_1.vi.fn().mockResolvedValue({}),
+        count: vitest_1.vi.fn().mockResolvedValue(1),
+        boundingBox: vitest_1.vi.fn().mockResolvedValue(null),
+        elementHandle: vitest_1.vi.fn().mockResolvedValue(null),
+        elementHandles: vitest_1.vi.fn().mockResolvedValue([]),
+        isChecked: vitest_1.vi.fn().mockResolvedValue(false),
+        isDisabled: vitest_1.vi.fn().mockResolvedValue(false),
+        isEditable: vitest_1.vi.fn().mockResolvedValue(true),
+        isEnabled: vitest_1.vi.fn().mockResolvedValue(true),
+        innerHTML: vitest_1.vi.fn().mockResolvedValue(''),
+        inputValue: vitest_1.vi.fn().mockResolvedValue(''),
+        page: vitest_1.vi.fn(),
+        first: vitest_1.vi.fn().mockReturnValue(options.firstMock?.() ?? {}),
+        nth: vitest_1.vi.fn().mockReturnValue(options.nthMock?.(0) ?? {}),
+    };
+    return mockLocator;
+}
+/**
+ * Create a fresh mock Playwright Page instance.
+ *
+ * Includes all methods used in tool handlers:
+ * - locator(selector) - returns mock locator
+ * - waitForLoadState() - async mock
+ * - url() - returns string
+ * - context() - returns mock context
+ * - screenshot(options) - async mock
+ *
+ * @param options - Customize mock behavior
+ * @returns Fresh Page mock
+ */
+function createMockPage(options = {}) {
+    const mockLocator = options.locatorMock ?? createMockLocator();
+    const page = {
+        locator: vitest_1.vi.fn().mockReturnValue(mockLocator),
+        waitForLoadState: vitest_1.vi.fn().mockResolvedValue(undefined),
+        url: vitest_1.vi.fn().mockReturnValue(options.url ?? 'about:blank'),
+        screenshot: vitest_1.vi.fn().mockResolvedValue({
+            buffer: Buffer.from(''),
+            path: '/path/to/screenshot.png',
+        }),
+        goto: vitest_1.vi.fn().mockResolvedValue(null),
+        close: vitest_1.vi.fn().mockResolvedValue(undefined),
+        isClosed: vitest_1.vi.fn().mockReturnValue(false),
+        evaluate: vitest_1.vi.fn().mockResolvedValue(undefined),
+        evaluateHandle: vitest_1.vi.fn().mockResolvedValue({}),
+        getByTestId: vitest_1.vi.fn().mockReturnValue(mockLocator),
+        getByRole: vitest_1.vi.fn().mockReturnValue(mockLocator),
+        getByLabel: vitest_1.vi.fn().mockReturnValue(mockLocator),
+        getByPlaceholder: vitest_1.vi.fn().mockReturnValue(mockLocator),
+        getByText: vitest_1.vi.fn().mockReturnValue(mockLocator),
+        getByAltText: vitest_1.vi.fn().mockReturnValue(mockLocator),
+        getByTitle: vitest_1.vi.fn().mockReturnValue(mockLocator),
+        frameLocator: vitest_1.vi.fn().mockReturnValue(mockLocator),
+        waitForFunction: vitest_1.vi.fn().mockResolvedValue(null),
+        waitForNavigation: vitest_1.vi.fn().mockResolvedValue(null),
+        waitForURL: vitest_1.vi.fn().mockResolvedValue(undefined),
+        waitForSelector: vitest_1.vi.fn().mockResolvedValue(mockLocator),
+        title: vitest_1.vi.fn().mockResolvedValue(''),
+        content: vitest_1.vi.fn().mockResolvedValue(''),
+        reload: vitest_1.vi.fn().mockResolvedValue(null),
+        goBack: vitest_1.vi.fn().mockResolvedValue(null),
+        goForward: vitest_1.vi.fn().mockResolvedValue(null),
+        bringToFront: vitest_1.vi.fn().mockResolvedValue(undefined),
+        focus: vitest_1.vi.fn().mockResolvedValue(undefined),
+        viewportSize: vitest_1.vi.fn().mockReturnValue({ width: 1280, height: 720 }),
+        setViewportSize: vitest_1.vi.fn().mockResolvedValue(undefined),
+        emulateMedia: vitest_1.vi.fn().mockResolvedValue(undefined),
+        setExtraHTTPHeaders: vitest_1.vi.fn().mockResolvedValue(undefined),
+        addInitScript: vitest_1.vi.fn().mockResolvedValue(undefined),
+        exposeFunction: vitest_1.vi.fn().mockResolvedValue(undefined),
+        exposeBinding: vitest_1.vi.fn().mockResolvedValue(undefined),
+        removeExposedBindings: vitest_1.vi.fn().mockResolvedValue(undefined),
+        pause: vitest_1.vi.fn().mockResolvedValue(undefined),
+        pdf: vitest_1.vi.fn().mockResolvedValue(Buffer.from('')),
+        accessibility: {
+            snapshot: vitest_1.vi.fn().mockResolvedValue(null),
+        },
+        keyboard: {
+            press: vitest_1.vi.fn().mockResolvedValue(undefined),
+            type: vitest_1.vi.fn().mockResolvedValue(undefined),
+            down: vitest_1.vi.fn().mockResolvedValue(undefined),
+            up: vitest_1.vi.fn().mockResolvedValue(undefined),
+            insertText: vitest_1.vi.fn().mockResolvedValue(undefined),
+        },
+        mouse: {
+            move: vitest_1.vi.fn().mockResolvedValue(undefined),
+            click: vitest_1.vi.fn().mockResolvedValue(undefined),
+            dblclick: vitest_1.vi.fn().mockResolvedValue(undefined),
+            down: vitest_1.vi.fn().mockResolvedValue(undefined),
+            up: vitest_1.vi.fn().mockResolvedValue(undefined),
+            wheel: vitest_1.vi.fn().mockResolvedValue(undefined),
+        },
+        touchscreen: {
+            tap: vitest_1.vi.fn().mockResolvedValue(undefined),
+        },
+        context: vitest_1.vi.fn(),
+        page: vitest_1.vi.fn(),
+    };
+    page.context.mockReturnValue({
+        pages: vitest_1.vi.fn().mockReturnValue([]),
+        newPage: vitest_1.vi.fn().mockResolvedValue({}),
+        close: vitest_1.vi.fn().mockResolvedValue(undefined),
+    });
+    page.page.mockReturnValue(page);
+    return page;
+}
+/**
+ * Create a fresh mock Playwright BrowserContext instance.
+ *
+ * @param options - Customize mock behavior
+ * @returns Fresh BrowserContext mock
+ */
+function createMockBrowserContext(options = {}) {
+    const context = {
+        pages: vitest_1.vi.fn().mockReturnValue(options.pages ?? []),
+        newPage: vitest_1.vi.fn(),
+        close: vitest_1.vi.fn().mockResolvedValue(undefined),
+        browser: vitest_1.vi.fn().mockReturnValue(null),
+        addCookies: vitest_1.vi.fn().mockResolvedValue(undefined),
+        addInitScript: vitest_1.vi.fn().mockResolvedValue(undefined),
+        clearCookies: vitest_1.vi.fn().mockResolvedValue(undefined),
+        cookies: vitest_1.vi.fn().mockResolvedValue([]),
+        exposeBinding: vitest_1.vi.fn().mockResolvedValue(undefined),
+        exposeFunction: vitest_1.vi.fn().mockResolvedValue(undefined),
+        grantPermissions: vitest_1.vi.fn().mockResolvedValue(undefined),
+        revokePermissions: vitest_1.vi.fn().mockResolvedValue(undefined),
+        setExtraHTTPHeaders: vitest_1.vi.fn().mockResolvedValue(undefined),
+        setGeolocation: vitest_1.vi.fn().mockResolvedValue(undefined),
+        setOffline: vitest_1.vi.fn().mockResolvedValue(undefined),
+        waitForEvent: vitest_1.vi.fn().mockResolvedValue(null),
+        tracing: {
+            start: vitest_1.vi.fn().mockResolvedValue(undefined),
+            stop: vitest_1.vi.fn().mockResolvedValue(Buffer.from('')),
+        },
+    };
+    context.newPage.mockResolvedValue({
+        locator: vitest_1.vi.fn().mockReturnValue({}),
+        url: vitest_1.vi.fn().mockReturnValue('about:blank'),
+        close: vitest_1.vi.fn().mockResolvedValue(undefined),
+    });
+    return context;
+}
+//# sourceMappingURL=mock-playwright.cjs.map

package/dist/mcp-server/test-utils/mock-playwright.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-playwright.cjs","sourceRoot":"","sources":["../../../src/mcp-server/test-utils/mock-playwright.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Playwright mock factories for unit testing.\n *\n * Provides factory functions that return fresh mock Playwright objects:\n * - createMockPage() - Mock Playwright Page with all used methods\n * - createMockLocator() - Mock Playwright Locator with chainable methods\n * - createMockBrowserContext() - Mock BrowserContext\n *\n * Each factory call returns NEW instances with fresh vi.fn() mocks.\n */\n\nimport type { Page, Locator, BrowserContext } from '@playwright/test';\nimport { vi } from 'vitest';\n\nexport type MockPageOptions = {\n  url?: string;\n  locatorMock?: Locator;\n};\n\nexport type MockLocatorOptions = {\n  clickMock?: () => Promise<void>;\n  fillMock?: (text: string) => Promise<void>;\n  isVisibleMock?: () => Promise<boolean>;\n  getAttributeMock?: (name: string) => Promise<string | null>;\n  textContentMock?: () => Promise<string | null>;\n  allMock?: () => Promise<Locator[]>;\n  firstMock?: () => Locator;\n  nthMock?: (index: number) => Locator;\n};\n\nexport type MockBrowserContextOptions = {\n  pages?: Page[];\n};\n\n/**\n * Create a fresh mock Playwright Locator instance.\n *\n * Includes all methods used in tool handlers:\n * - click() - async mock\n * - fill(text) - async mock\n * - isVisible() - async mock\n * - getAttribute(name) - async mock\n * - textContent() - async mock\n * - all() - async mock\n * - first() - returns mock locator\n * - nth(index) - returns mock locator\n *\n * Methods are chainable where appropriate.\n *\n * @param options - Customize mock behavior\n * @returns Fresh Locator mock\n */\nexport function createMockLocator(options: MockLocatorOptions = {}): Locator {\n  const mockLocator: any = {\n    click: vi.fn().mockResolvedValue(options.clickMock?.() ?? undefined),\n    fill: vi.fn().mockResolvedValue(options.fillMock?.('') ?? undefined),\n    isVisible: vi.fn().mockResolvedValue(options.isVisibleMock?.() ?? true),\n    getAttribute: vi\n      .fn()\n      .mockResolvedValue(options.getAttributeMock?.('') ?? null),\n    textContent: vi.fn().mockResolvedValue(options.textContentMock?.() ?? null),\n    all: vi.fn().mockResolvedValue(options.allMock?.() ?? []),\n    clear: vi.fn().mockResolvedValue(undefined),\n    check: vi.fn().mockResolvedValue(undefined),\n    uncheck: vi.fn().mockResolvedValue(undefined),\n    hover: vi.fn().mockResolvedValue(undefined),\n    focus: vi.fn().mockResolvedValue(undefined),\n    blur: vi.fn().mockResolvedValue(undefined),\n    type: vi.fn().mockResolvedValue(undefined),\n    press: vi.fn().mockResolvedValue(undefined),\n    selectOption: vi.fn().mockResolvedValue([]),\n    selectText: vi.fn().mockResolvedValue(undefined),\n    setInputFiles: vi.fn().mockResolvedValue(undefined),\n    setChecked: vi.fn().mockResolvedValue(undefined),\n    dragTo: vi.fn().mockResolvedValue(undefined),\n    screenshot: vi.fn().mockResolvedValue(Buffer.from('')),\n    scrollIntoViewIfNeeded: vi.fn().mockResolvedValue(undefined),\n    waitFor: vi.fn().mockResolvedValue(undefined),\n    evaluate: vi.fn().mockResolvedValue(undefined),\n    evaluateAll: vi.fn().mockResolvedValue([]),\n    evaluateHandle: vi.fn().mockResolvedValue({}),\n    count: vi.fn().mockResolvedValue(1),\n    boundingBox: vi.fn().mockResolvedValue(null),\n    elementHandle: vi.fn().mockResolvedValue(null),\n    elementHandles: vi.fn().mockResolvedValue([]),\n    isChecked: vi.fn().mockResolvedValue(false),\n    isDisabled: vi.fn().mockResolvedValue(false),\n    isEditable: vi.fn().mockResolvedValue(true),\n    isEnabled: vi.fn().mockResolvedValue(true),\n    innerHTML: vi.fn().mockResolvedValue(''),\n    inputValue: vi.fn().mockResolvedValue(''),\n    page: vi.fn(),\n    first: vi.fn().mockReturnValue(options.firstMock?.() ?? {}),\n    nth: vi.fn().mockReturnValue(options.nthMock?.(0) ?? {}),\n  };\n\n  return mockLocator as Locator;\n}\n\n/**\n * Create a fresh mock Playwright Page instance.\n *\n * Includes all methods used in tool handlers:\n * - locator(selector) - returns mock locator\n * - waitForLoadState() - async mock\n * - url() - returns string\n * - context() - returns mock context\n * - screenshot(options) - async mock\n *\n * @param options - Customize mock behavior\n * @returns Fresh Page mock\n */\nexport function createMockPage(options: MockPageOptions = {}): Page {\n  const mockLocator = options.locatorMock ?? createMockLocator();\n\n  const page: any = {\n    locator: vi.fn().mockReturnValue(mockLocator),\n    waitForLoadState: vi.fn().mockResolvedValue(undefined),\n    url: vi.fn().mockReturnValue(options.url ?? 'about:blank'),\n    screenshot: vi.fn().mockResolvedValue({\n      buffer: Buffer.from(''),\n      path: '/path/to/screenshot.png',\n    }),\n    goto: vi.fn().mockResolvedValue(null),\n    close: vi.fn().mockResolvedValue(undefined),\n    isClosed: vi.fn().mockReturnValue(false),\n    evaluate: vi.fn().mockResolvedValue(undefined),\n    evaluateHandle: vi.fn().mockResolvedValue({}),\n    getByTestId: vi.fn().mockReturnValue(mockLocator),\n    getByRole: vi.fn().mockReturnValue(mockLocator),\n    getByLabel: vi.fn().mockReturnValue(mockLocator),\n    getByPlaceholder: vi.fn().mockReturnValue(mockLocator),\n    getByText: vi.fn().mockReturnValue(mockLocator),\n    getByAltText: vi.fn().mockReturnValue(mockLocator),\n    getByTitle: vi.fn().mockReturnValue(mockLocator),\n    frameLocator: vi.fn().mockReturnValue(mockLocator),\n    waitForFunction: vi.fn().mockResolvedValue(null),\n    waitForNavigation: vi.fn().mockResolvedValue(null),\n    waitForURL: vi.fn().mockResolvedValue(undefined),\n    waitForSelector: vi.fn().mockResolvedValue(mockLocator),\n    title: vi.fn().mockResolvedValue(''),\n    content: vi.fn().mockResolvedValue(''),\n    reload: vi.fn().mockResolvedValue(null),\n    goBack: vi.fn().mockResolvedValue(null),\n    goForward: vi.fn().mockResolvedValue(null),\n    bringToFront: vi.fn().mockResolvedValue(undefined),\n    focus: vi.fn().mockResolvedValue(undefined),\n    viewportSize: vi.fn().mockReturnValue({ width: 1280, height: 720 }),\n    setViewportSize: vi.fn().mockResolvedValue(undefined),\n    emulateMedia: vi.fn().mockResolvedValue(undefined),\n    setExtraHTTPHeaders: vi.fn().mockResolvedValue(undefined),\n    addInitScript: vi.fn().mockResolvedValue(undefined),\n    exposeFunction: vi.fn().mockResolvedValue(undefined),\n    exposeBinding: vi.fn().mockResolvedValue(undefined),\n    removeExposedBindings: vi.fn().mockResolvedValue(undefined),\n    pause: vi.fn().mockResolvedValue(undefined),\n    pdf: vi.fn().mockResolvedValue(Buffer.from('')),\n    accessibility: {\n      snapshot: vi.fn().mockResolvedValue(null),\n    },\n    keyboard: {\n      press: vi.fn().mockResolvedValue(undefined),\n      type: vi.fn().mockResolvedValue(undefined),\n      down: vi.fn().mockResolvedValue(undefined),\n      up: vi.fn().mockResolvedValue(undefined),\n      insertText: vi.fn().mockResolvedValue(undefined),\n    },\n    mouse: {\n      move: vi.fn().mockResolvedValue(undefined),\n      click: vi.fn().mockResolvedValue(undefined),\n      dblclick: vi.fn().mockResolvedValue(undefined),\n      down: vi.fn().mockResolvedValue(undefined),\n      up: vi.fn().mockResolvedValue(undefined),\n      wheel: vi.fn().mockResolvedValue(undefined),\n    },\n    touchscreen: {\n      tap: vi.fn().mockResolvedValue(undefined),\n    },\n    context: vi.fn(),\n    page: vi.fn(),\n  };\n\n  page.context.mockReturnValue({\n    pages: vi.fn().mockReturnValue([]),\n    newPage: vi.fn().mockResolvedValue({}),\n    close: vi.fn().mockResolvedValue(undefined),\n  });\n  page.page.mockReturnValue(page);\n\n  return page as Page;\n}\n\n/**\n * Create a fresh mock Playwright BrowserContext instance.\n *\n * @param options - Customize mock behavior\n * @returns Fresh BrowserContext mock\n */\nexport function createMockBrowserContext(\n  options: MockBrowserContextOptions = {},\n): Partial<BrowserContext> {\n  const context: any = {\n    pages: vi.fn().mockReturnValue(options.pages ?? []),\n    newPage: vi.fn(),\n    close: vi.fn().mockResolvedValue(undefined),\n    browser: vi.fn().mockReturnValue(null),\n    addCookies: vi.fn().mockResolvedValue(undefined),\n    addInitScript: vi.fn().mockResolvedValue(undefined),\n    clearCookies: vi.fn().mockResolvedValue(undefined),\n    cookies: vi.fn().mockResolvedValue([]),\n    exposeBinding: vi.fn().mockResolvedValue(undefined),\n    exposeFunction: vi.fn().mockResolvedValue(undefined),\n    grantPermissions: vi.fn().mockResolvedValue(undefined),\n    revokePermissions: vi.fn().mockResolvedValue(undefined),\n    setExtraHTTPHeaders: vi.fn().mockResolvedValue(undefined),\n    setGeolocation: vi.fn().mockResolvedValue(undefined),\n    setOffline: vi.fn().mockResolvedValue(undefined),\n    waitForEvent: vi.fn().mockResolvedValue(null),\n    tracing: {\n      start: vi.fn().mockResolvedValue(undefined),\n      stop: vi.fn().mockResolvedValue(Buffer.from('')),\n    },\n  };\n\n  context.newPage.mockResolvedValue({\n    locator: vi.fn().mockReturnValue({}),\n    url: vi.fn().mockReturnValue('about:blank'),\n    close: vi.fn().mockResolvedValue(undefined),\n  });\n\n  return context as Partial<BrowserContext>;\n}\n"]}

package/dist/mcp-server/test-utils/mock-playwright.d.cts

@@ -0,0 +1,69 @@
+/**
+ * Playwright mock factories for unit testing.
+ *
+ * Provides factory functions that return fresh mock Playwright objects:
+ * - createMockPage() - Mock Playwright Page with all used methods
+ * - createMockLocator() - Mock Playwright Locator with chainable methods
+ * - createMockBrowserContext() - Mock BrowserContext
+ *
+ * Each factory call returns NEW instances with fresh vi.fn() mocks.
+ */
+import type { Page, Locator, BrowserContext } from "@playwright/test";
+export type MockPageOptions = {
+    url?: string;
+    locatorMock?: Locator;
+};
+export type MockLocatorOptions = {
+    clickMock?: () => Promise<void>;
+    fillMock?: (text: string) => Promise<void>;
+    isVisibleMock?: () => Promise<boolean>;
+    getAttributeMock?: (name: string) => Promise<string | null>;
+    textContentMock?: () => Promise<string | null>;
+    allMock?: () => Promise<Locator[]>;
+    firstMock?: () => Locator;
+    nthMock?: (index: number) => Locator;
+};
+export type MockBrowserContextOptions = {
+    pages?: Page[];
+};
+/**
+ * Create a fresh mock Playwright Locator instance.
+ *
+ * Includes all methods used in tool handlers:
+ * - click() - async mock
+ * - fill(text) - async mock
+ * - isVisible() - async mock
+ * - getAttribute(name) - async mock
+ * - textContent() - async mock
+ * - all() - async mock
+ * - first() - returns mock locator
+ * - nth(index) - returns mock locator
+ *
+ * Methods are chainable where appropriate.
+ *
+ * @param options - Customize mock behavior
+ * @returns Fresh Locator mock
+ */
+export declare function createMockLocator(options?: MockLocatorOptions): Locator;
+/**
+ * Create a fresh mock Playwright Page instance.
+ *
+ * Includes all methods used in tool handlers:
+ * - locator(selector) - returns mock locator
+ * - waitForLoadState() - async mock
+ * - url() - returns string
+ * - context() - returns mock context
+ * - screenshot(options) - async mock
+ *
+ * @param options - Customize mock behavior
+ * @returns Fresh Page mock
+ */
+export declare function createMockPage(options?: MockPageOptions): Page;
+/**
+ * Create a fresh mock Playwright BrowserContext instance.
+ *
+ * @param options - Customize mock behavior
+ * @returns Fresh BrowserContext mock
+ */
+export declare function createMockBrowserContext(options?: MockBrowserContextOptions): Partial<BrowserContext>;
+//# sourceMappingURL=mock-playwright.d.cts.map

package/dist/mcp-server/test-utils/mock-playwright.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-playwright.d.cts","sourceRoot":"","sources":["../../../src/mcp-server/test-utils/mock-playwright.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,EAAE,yBAAyB;AAGtE,MAAM,MAAM,eAAe,GAAG;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC5D,eAAe,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC;IAC1B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;CAChB,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CA6C3E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,eAAoB,GAAG,IAAI,CA8ElE;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,cAAc,CAAC,CA+BzB"}