@frontmcp/testing 0.6.1 → 0.6.3

package/src/interceptor/mock-registry.js

@@ -1,189 +0,0 @@
-"use strict";
-/**
- * @file mock-registry.ts
- * @description Registry for managing request mocks
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.mockResponse = exports.DefaultMockRegistry = void 0;
-/**
- * Default implementation of MockRegistry
- */
-class DefaultMockRegistry {
-    mocks = [];
-    add(mock) {
-        const entry = {
-            definition: mock,
-            callCount: 0,
-            calls: [],
-            remainingUses: mock.times ?? Infinity,
-        };
-        this.mocks.push(entry);
-        return {
-            remove: () => {
-                const index = this.mocks.indexOf(entry);
-                if (index !== -1) {
-                    this.mocks.splice(index, 1);
-                }
-            },
-            callCount: () => entry.callCount,
-            calls: () => [...entry.calls],
-        };
-    }
-    clear() {
-        this.mocks = [];
-    }
-    getAll() {
-        return this.mocks.map((e) => e.definition);
-    }
-    match(request) {
-        for (const entry of this.mocks) {
-            if (entry.remainingUses <= 0)
-                continue;
-            const { definition } = entry;
-            // Check method match
-            if (definition.method !== request.method)
-                continue;
-            // Check params match if specified
-            if (definition.params !== undefined) {
-                const params = request.params ?? {};
-                if (typeof definition.params === 'function') {
-                    // Custom matcher function
-                    if (!definition.params(params))
-                        continue;
-                }
-                else {
-                    // Object deep equality check
-                    if (!this.paramsMatch(definition.params, params))
-                        continue;
-                }
-            }
-            // Found a match - update tracking
-            entry.callCount++;
-            entry.calls.push(request);
-            entry.remainingUses--;
-            return definition;
-        }
-        return undefined;
-    }
-    /**
-     * Check if request params match the mock params definition
-     */
-    paramsMatch(expected, actual) {
-        for (const [key, value] of Object.entries(expected)) {
-            if (!(key in actual))
-                return false;
-            const actualValue = actual[key];
-            // Handle arrays explicitly
-            if (Array.isArray(value)) {
-                if (!Array.isArray(actualValue))
-                    return false;
-                if (value.length !== actualValue.length)
-                    return false;
-                for (let i = 0; i < value.length; i++) {
-                    const expectedItem = value[i];
-                    const actualItem = actualValue[i];
-                    if (typeof expectedItem === 'object' && expectedItem !== null) {
-                        if (typeof actualItem !== 'object' || actualItem === null)
-                            return false;
-                        if (!this.paramsMatch(expectedItem, actualItem)) {
-                            return false;
-                        }
-                    }
-                    else if (actualItem !== expectedItem) {
-                        return false;
-                    }
-                }
-            }
-            else if (typeof value === 'object' && value !== null) {
-                if (typeof actualValue !== 'object' || actualValue === null)
-                    return false;
-                if (!this.paramsMatch(value, actualValue)) {
-                    return false;
-                }
-            }
-            else if (actualValue !== value) {
-                return false;
-            }
-        }
-        return true;
-    }
-}
-exports.DefaultMockRegistry = DefaultMockRegistry;
-/**
- * Helper to create mock responses
- */
-exports.mockResponse = {
-    /**
-     * Create a successful JSON-RPC response
-     */
-    success(result, id = 1) {
-        return {
-            jsonrpc: '2.0',
-            id,
-            result,
-        };
-    },
-    /**
-     * Create an error JSON-RPC response
-     */
-    error(code, message, data, id = 1) {
-        return {
-            jsonrpc: '2.0',
-            id,
-            error: { code, message, data },
-        };
-    },
-    /**
-     * Create a tool result response
-     */
-    toolResult(content, id = 1) {
-        return {
-            jsonrpc: '2.0',
-            id,
-            result: { content },
-        };
-    },
-    /**
-     * Create a tools/list response
-     */
-    toolsList(tools, id = 1) {
-        return {
-            jsonrpc: '2.0',
-            id,
-            result: { tools },
-        };
-    },
-    /**
-     * Create a resources/list response
-     */
-    resourcesList(resources, id = 1) {
-        return {
-            jsonrpc: '2.0',
-            id,
-            result: { resources },
-        };
-    },
-    /**
-     * Create a resources/read response
-     */
-    resourceRead(contents, id = 1) {
-        return {
-            jsonrpc: '2.0',
-            id,
-            result: { contents },
-        };
-    },
-    /**
-     * Common MCP errors
-     */
-    errors: {
-        methodNotFound: (method, id = 1) => exports.mockResponse.error(-32601, `Method not found: ${method}`, undefined, id),
-        invalidParams: (message, id = 1) => exports.mockResponse.error(-32602, message, undefined, id),
-        internalError: (message, id = 1) => exports.mockResponse.error(-32603, message, undefined, id),
-        resourceNotFound: (uri, id = 1) => exports.mockResponse.error(-32002, `Resource not found: ${uri}`, { uri }, id),
-        toolNotFound: (name, id = 1) => exports.mockResponse.error(-32601, `Tool not found: ${name}`, { name }, id),
-        unauthorized: (id = 1) => exports.mockResponse.error(-32001, 'Unauthorized', undefined, id),
-        forbidden: (id = 1) => exports.mockResponse.error(-32003, 'Forbidden', undefined, id),
-    },
-};
-//# sourceMappingURL=mock-registry.js.map

package/src/interceptor/mock-registry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mock-registry.js","sourceRoot":"","sources":["../../../src/interceptor/mock-registry.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @file mock-registry.ts\n * @description Registry for managing request mocks\n */\n\nimport type { JsonRpcRequest, JsonRpcResponse } from '../transport/transport.interface';\nimport type { MockDefinition, MockRegistry, MockHandle } from './interceptor.types';\n\n/**\n * Internal mock entry with tracking\n */\ninterface MockEntry {\n  definition: MockDefinition;\n  callCount: number;\n  calls: JsonRpcRequest[];\n  remainingUses: number;\n}\n\n/**\n * Default implementation of MockRegistry\n */\nexport class DefaultMockRegistry implements MockRegistry {\n  private mocks: MockEntry[] = [];\n\n  add(mock: MockDefinition): MockHandle {\n    const entry: MockEntry = {\n      definition: mock,\n      callCount: 0,\n      calls: [],\n      remainingUses: mock.times ?? Infinity,\n    };\n\n    this.mocks.push(entry);\n\n    return {\n      remove: () => {\n        const index = this.mocks.indexOf(entry);\n        if (index !== -1) {\n          this.mocks.splice(index, 1);\n        }\n      },\n      callCount: () => entry.callCount,\n      calls: () => [...entry.calls],\n    };\n  }\n\n  clear(): void {\n    this.mocks = [];\n  }\n\n  getAll(): MockDefinition[] {\n    return this.mocks.map((e) => e.definition);\n  }\n\n  match(request: JsonRpcRequest): MockDefinition | undefined {\n    for (const entry of this.mocks) {\n      if (entry.remainingUses <= 0) continue;\n\n      const { definition } = entry;\n\n      // Check method match\n      if (definition.method !== request.method) continue;\n\n      // Check params match if specified\n      if (definition.params !== undefined) {\n        const params = request.params ?? {};\n\n        if (typeof definition.params === 'function') {\n          // Custom matcher function\n          if (!definition.params(params)) continue;\n        } else {\n          // Object deep equality check\n          if (!this.paramsMatch(definition.params, params)) continue;\n        }\n      }\n\n      // Found a match - update tracking\n      entry.callCount++;\n      entry.calls.push(request);\n      entry.remainingUses--;\n\n      return definition;\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Check if request params match the mock params definition\n   */\n  private paramsMatch(expected: Record<string, unknown>, actual: Record<string, unknown>): boolean {\n    for (const [key, value] of Object.entries(expected)) {\n      if (!(key in actual)) return false;\n\n      const actualValue = actual[key];\n\n      // Handle arrays explicitly\n      if (Array.isArray(value)) {\n        if (!Array.isArray(actualValue)) return false;\n        if (value.length !== actualValue.length) return false;\n        for (let i = 0; i < value.length; i++) {\n          const expectedItem = value[i];\n          const actualItem = actualValue[i];\n          if (typeof expectedItem === 'object' && expectedItem !== null) {\n            if (typeof actualItem !== 'object' || actualItem === null) return false;\n            if (!this.paramsMatch(expectedItem as Record<string, unknown>, actualItem as Record<string, unknown>)) {\n              return false;\n            }\n          } else if (actualItem !== expectedItem) {\n            return false;\n          }\n        }\n      } else if (typeof value === 'object' && value !== null) {\n        if (typeof actualValue !== 'object' || actualValue === null) return false;\n        if (!this.paramsMatch(value as Record<string, unknown>, actualValue as Record<string, unknown>)) {\n          return false;\n        }\n      } else if (actualValue !== value) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n}\n\n/**\n * Helper to create mock responses\n */\nexport const mockResponse = {\n  /**\n   * Create a successful JSON-RPC response\n   */\n  success<T>(result: T, id: string | number = 1): JsonRpcResponse {\n    return {\n      jsonrpc: '2.0',\n      id,\n      result,\n    };\n  },\n\n  /**\n   * Create an error JSON-RPC response\n   */\n  error(code: number, message: string, data?: unknown, id: string | number | null = 1): JsonRpcResponse {\n    return {\n      jsonrpc: '2.0',\n      id,\n      error: { code, message, data },\n    };\n  },\n\n  /**\n   * Create a tool result response\n   */\n  toolResult(\n    content: Array<{ type: 'text'; text: string } | { type: 'image'; data: string; mimeType: string }>,\n    id: string | number = 1,\n  ): JsonRpcResponse {\n    return {\n      jsonrpc: '2.0',\n      id,\n      result: { content },\n    };\n  },\n\n  /**\n   * Create a tools/list response\n   */\n  toolsList(\n    tools: Array<{ name: string; description?: string; inputSchema?: Record<string, unknown> }>,\n    id: string | number = 1,\n  ): JsonRpcResponse {\n    return {\n      jsonrpc: '2.0',\n      id,\n      result: { tools },\n    };\n  },\n\n  /**\n   * Create a resources/list response\n   */\n  resourcesList(\n    resources: Array<{ uri: string; name?: string; description?: string; mimeType?: string }>,\n    id: string | number = 1,\n  ): JsonRpcResponse {\n    return {\n      jsonrpc: '2.0',\n      id,\n      result: { resources },\n    };\n  },\n\n  /**\n   * Create a resources/read response\n   */\n  resourceRead(\n    contents: Array<{ uri: string; text?: string; blob?: string; mimeType?: string }>,\n    id: string | number = 1,\n  ): JsonRpcResponse {\n    return {\n      jsonrpc: '2.0',\n      id,\n      result: { contents },\n    };\n  },\n\n  /**\n   * Common MCP errors\n   */\n  errors: {\n    methodNotFound: (method: string, id: string | number | null = 1) =>\n      mockResponse.error(-32601, `Method not found: ${method}`, undefined, id),\n\n    invalidParams: (message: string, id: string | number | null = 1) =>\n      mockResponse.error(-32602, message, undefined, id),\n\n    internalError: (message: string, id: string | number | null = 1) =>\n      mockResponse.error(-32603, message, undefined, id),\n\n    resourceNotFound: (uri: string, id: string | number | null = 1) =>\n      mockResponse.error(-32002, `Resource not found: ${uri}`, { uri }, id),\n\n    toolNotFound: (name: string, id: string | number | null = 1) =>\n      mockResponse.error(-32601, `Tool not found: ${name}`, { name }, id),\n\n    unauthorized: (id: string | number | null = 1) => mockResponse.error(-32001, 'Unauthorized', undefined, id),\n\n    forbidden: (id: string | number | null = 1) => mockResponse.error(-32003, 'Forbidden', undefined, id),\n  },\n};\n"]}

package/src/matchers/index.js

@@ -1,12 +0,0 @@
-"use strict";
-/**
- * @file index.ts
- * @description Barrel exports for MCP Jest matchers
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.mcpMatchers = void 0;
-var mcp_matchers_1 = require("./mcp-matchers");
-Object.defineProperty(exports, "mcpMatchers", { enumerable: true, get: function () { return mcp_matchers_1.mcpMatchers; } });
-// Import the type augmentation to make TypeScript aware of the matchers
-require("./matcher-types");
-//# sourceMappingURL=index.js.map

package/src/matchers/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/matchers/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AAKpB,wEAAwE;AACxE,2BAAyB","sourcesContent":["/**\n * @file index.ts\n * @description Barrel exports for MCP Jest matchers\n */\n\nexport { mcpMatchers } from './mcp-matchers';\n\n// Re-export types for convenience\nexport type { McpMatchers } from './matcher-types';\n\n// Import the type augmentation to make TypeScript aware of the matchers\nimport './matcher-types';\n"]}

package/src/matchers/matcher-types.js

@@ -1,10 +0,0 @@
-"use strict";
-/**
- * @file matcher-types.ts
- * @description TypeScript declarations for custom MCP Jest matchers
- *
- * This file extends Jest's expect interface with MCP-specific matchers.
- * Import this file or ensure it's included in your tsconfig to get type checking.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=matcher-types.js.map

package/src/matchers/matcher-types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"matcher-types.js","sourceRoot":"","sources":["../../../src/matchers/matcher-types.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG","sourcesContent":["/**\n * @file matcher-types.ts\n * @description TypeScript declarations for custom MCP Jest matchers\n *\n * This file extends Jest's expect interface with MCP-specific matchers.\n * Import this file or ensure it's included in your tsconfig to get type checking.\n */\n\n// Note: These imports are used for documentation/JSDoc purposes in the interface comments\n// The actual runtime types are in mcp-matchers.ts\n\n/**\n * Custom MCP matchers for Jest\n */\nexport interface McpMatchers<R = unknown> {\n  // ═══════════════════════════════════════════════════════════════════\n  // TOOL MATCHERS\n  // ═══════════════════════════════════════════════════════════════════\n\n  /**\n   * Check if tools array contains a tool with the given name\n   * @param toolName - The name of the tool to find\n   *\n   * @example\n   * ```typescript\n   * const tools = await mcp.tools.list();\n   * expect(tools).toContainTool('my-tool');\n   * ```\n   */\n  toContainTool(toolName: string): R;\n\n  /**\n   * Check if result is successful (not an error)\n   *\n   * @example\n   * ```typescript\n   * const result = await mcp.tools.call('my-tool', {});\n   * expect(result).toBeSuccessful();\n   * ```\n   */\n  toBeSuccessful(): R;\n\n  /**\n   * Check if result is an error, optionally with a specific error code\n   * @param expectedCode - Optional specific MCP error code to match\n   *\n   * @example\n   * ```typescript\n   * const result = await mcp.tools.call('unknown-tool', {});\n   * expect(result).toBeError();\n   * expect(result).toBeError(-32601); // Method not found\n   * ```\n   */\n  toBeError(expectedCode?: number): R;\n\n  /**\n   * Check if tool result has text content, optionally containing specific text\n   * @param expectedText - Optional text that should be contained in the result\n   *\n   * @example\n   * ```typescript\n   * const result = await mcp.tools.call('my-tool', {});\n   * expect(result).toHaveTextContent();\n   * expect(result).toHaveTextContent('success');\n   * ```\n   */\n  toHaveTextContent(expectedText?: string): R;\n\n  /**\n   * Check if tool result has image content\n   *\n   * @example\n   * ```typescript\n   * const result = await mcp.tools.call('generate-image', {});\n   * expect(result).toHaveImageContent();\n   * ```\n   */\n  toHaveImageContent(): R;\n\n  /**\n   * Check if tool result has resource content\n   *\n   * @example\n   * ```typescript\n   * const result = await mcp.tools.call('create-file', {});\n   * expect(result).toHaveResourceContent();\n   * ```\n   */\n  toHaveResourceContent(): R;\n\n  // ═══════════════════════════════════════════════════════════════════\n  // RESOURCE MATCHERS\n  // ═══════════════════════════════════════════════════════════════════\n\n  /**\n   * Check if resources array contains a resource with the given URI\n   * @param uri - The URI of the resource to find\n   *\n   * @example\n   * ```typescript\n   * const resources = await mcp.resources.list();\n   * expect(resources).toContainResource('notes://all');\n   * ```\n   */\n  toContainResource(uri: string): R;\n\n  /**\n   * Check if resource templates array contains a template with the given URI template\n   * @param uriTemplate - The URI template to find\n   *\n   * @example\n   * ```typescript\n   * const templates = await mcp.resources.listTemplates();\n   * expect(templates).toContainResourceTemplate('notes://note/{id}');\n   * ```\n   */\n  toContainResourceTemplate(uriTemplate: string): R;\n\n  /**\n   * Check if resource content has a specific MIME type\n   * @param mimeType - The expected MIME type\n   *\n   * @example\n   * ```typescript\n   * const content = await mcp.resources.read('notes://all');\n   * expect(content).toHaveMimeType('application/json');\n   * ```\n   */\n  toHaveMimeType(mimeType: string): R;\n\n  // ═══════════════════════════════════════════════════════════════════\n  // PROMPT MATCHERS\n  // ═══════════════════════════════════════════════════════════════════\n\n  /**\n   * Check if prompts array contains a prompt with the given name\n   * @param name - The name of the prompt to find\n   *\n   * @example\n   * ```typescript\n   * const prompts = await mcp.prompts.list();\n   * expect(prompts).toContainPrompt('summarize');\n   * ```\n   */\n  toContainPrompt(name: string): R;\n\n  /**\n   * Check if prompt result has a specific number of messages\n   * @param count - The expected number of messages\n   *\n   * @example\n   * ```typescript\n   * const result = await mcp.prompts.get('summarize', {});\n   * expect(result).toHaveMessages(2);\n   * ```\n   */\n  toHaveMessages(count: number): R;\n\n  // ═══════════════════════════════════════════════════════════════════\n  // PROTOCOL MATCHERS\n  // ═══════════════════════════════════════════════════════════════════\n\n  /**\n   * Check if response is valid JSON-RPC 2.0\n   *\n   * @example\n   * ```typescript\n   * const response = await mcp.raw.request({ ... });\n   * expect(response).toBeValidJsonRpc();\n   * ```\n   */\n  toBeValidJsonRpc(): R;\n\n  /**\n   * Check if JSON-RPC response has a result\n   *\n   * @example\n   * ```typescript\n   * const response = await mcp.raw.request({ ... });\n   * expect(response).toHaveResult();\n   * ```\n   */\n  toHaveResult(): R;\n\n  /**\n   * Check if JSON-RPC response has an error\n   *\n   * @example\n   * ```typescript\n   * const response = await mcp.raw.request({ method: 'unknown' });\n   * expect(response).toHaveError();\n   * ```\n   */\n  toHaveError(): R;\n\n  /**\n   * Check if JSON-RPC response has a specific error code\n   * @param code - The expected JSON-RPC error code\n   *\n   * @example\n   * ```typescript\n   * const response = await mcp.raw.request({ method: 'unknown' });\n   * expect(response).toHaveErrorCode(-32601);\n   * ```\n   */\n  toHaveErrorCode(code: number): R;\n\n  // ═══════════════════════════════════════════════════════════════════\n  // UI MATCHERS\n  // ═══════════════════════════════════════════════════════════════════\n\n  /**\n   * Check if tool result has rendered HTML in _meta['ui/html'].\n   * Fails if the HTML is the mdx-fallback (escaped raw content).\n   *\n   * @example\n   * ```typescript\n   * const result = await mcp.tools.call('get_weather', { location: 'London' });\n   * expect(result).toHaveRenderedHtml();\n   * ```\n   */\n  toHaveRenderedHtml(): R;\n\n  /**\n   * Check if HTML contains a specific HTML element tag.\n   * @param tag - The HTML tag name to look for (e.g., 'div', 'h1', 'span')\n   *\n   * @example\n   * ```typescript\n   * expect(result).toContainHtmlElement('div');\n   * expect(result).toContainHtmlElement('h1');\n   * ```\n   */\n  toContainHtmlElement(tag: string): R;\n\n  /**\n   * Check if a bound value from tool output appears in the rendered HTML.\n   * @param value - The value to look for (string or number)\n   *\n   * @example\n   * ```typescript\n   * const output = result.json();\n   * expect(result).toContainBoundValue(output.location);\n   * expect(result).toContainBoundValue(output.temperature);\n   * ```\n   */\n  toContainBoundValue(value: string | number): R;\n\n  /**\n   * Check if HTML is XSS-safe (no script tags, event handlers, or javascript: URIs).\n   *\n   * @example\n   * ```typescript\n   * expect(result).toBeXssSafe();\n   * ```\n   */\n  toBeXssSafe(): R;\n\n  /**\n   * Check if tool result has widget metadata (ui/resourceUri).\n   *\n   * @example\n   * ```typescript\n   * expect(result).toHaveWidgetMetadata();\n   * ```\n   */\n  toHaveWidgetMetadata(): R;\n\n  /**\n   * Check if HTML has a specific CSS class.\n   * @param className - The CSS class name to look for\n   *\n   * @example\n   * ```typescript\n   * expect(result).toHaveCssClass('weather-card');\n   * ```\n   */\n  toHaveCssClass(className: string): R;\n\n  /**\n   * Check that HTML does NOT contain specific content (useful for fallback checks).\n   * @param content - The content that should NOT be in the HTML\n   *\n   * @example\n   * ```typescript\n   * expect(result).toNotContainRawContent('mdx-fallback');\n   * expect(result).toNotContainRawContent('<Alert'); // Custom component should be rendered\n   * ```\n   */\n  toNotContainRawContent(content: string): R;\n\n  /**\n   * Check if HTML has proper structure (not just escaped text).\n   *\n   * @example\n   * ```typescript\n   * expect(result).toHaveProperHtmlStructure();\n   * ```\n   */\n  toHaveProperHtmlStructure(): R;\n}\n\n// ═══════════════════════════════════════════════════════════════════\n// JEST TYPE AUGMENTATION\n// ═══════════════════════════════════════════════════════════════════\n\n/* eslint-disable @typescript-eslint/no-namespace, @typescript-eslint/no-empty-interface */\n\ndeclare global {\n  namespace jest {\n    // Extend expect matchers\n    interface Matchers<R> extends McpMatchers<R> {}\n\n    // Extend asymmetric matchers (for expect.toContainTool etc.)\n    interface Expect extends McpMatchers<void> {}\n\n    // Extend inverse matchers (for expect.not.toContainTool etc.)\n    interface InverseAsymmetricMatchers extends McpMatchers<void> {}\n  }\n}\n/* eslint-enable @typescript-eslint/no-namespace, @typescript-eslint/no-empty-interface */\n\n// This export is needed to make this a module\nexport {};\n"]}

package/src/matchers/mcp-matchers.js

@@ -1,395 +0,0 @@
-"use strict";
-/**
- * @file mcp-matchers.ts
- * @description Custom Jest matchers for MCP testing
- *
- * @example
- * ```typescript
- * import { test, expect } from '@frontmcp/testing';
- *
- * test('tools work', async ({ mcp }) => {
- *   const tools = await mcp.tools.list();
- *   expect(tools).toContainTool('my-tool');
- *
- *   const result = await mcp.tools.call('my-tool', {});
- *   expect(result).toBeSuccessful();
- *   expect(result).toHaveTextContent();
- * });
- * ```
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.mcpMatchers = void 0;
-const ui_matchers_1 = require("../ui/ui-matchers");
-// ═══════════════════════════════════════════════════════════════════
-// TOOL MATCHERS
-// ═══════════════════════════════════════════════════════════════════
-/**
- * Check if tools array contains a tool with the given name
- */
-const toContainTool = function (received, toolName) {
-    const tools = received;
-    if (!Array.isArray(tools)) {
-        return {
-            pass: false,
-            message: () => `Expected an array of tools, but received ${typeof received}`,
-        };
-    }
-    const pass = tools.some((t) => t.name === toolName);
-    const availableTools = tools.map((t) => t.name).join(', ');
-    return {
-        pass,
-        message: () => pass
-            ? `Expected tools not to contain "${toolName}"`
-            : `Expected tools to contain "${toolName}", but got: [${availableTools}]`,
-    };
-};
-/**
- * Check if result is successful (not an error)
- */
-const toBeSuccessful = function (received) {
-    const result = received;
-    if (typeof result !== 'object' || result === null || !('isSuccess' in result)) {
-        return {
-            pass: false,
-            message: () => `Expected a result wrapper object with isSuccess property`,
-        };
-    }
-    const pass = result.isSuccess;
-    return {
-        pass,
-        message: () => pass
-            ? 'Expected result not to be successful'
-            : `Expected result to be successful, but got error: ${result.error?.message ?? 'unknown error'}`,
-    };
-};
-/**
- * Check if result is an error, optionally with a specific error code
- */
-const toBeError = function (received, expectedCode) {
-    const result = received;
-    if (typeof result !== 'object' || result === null || !('isError' in result)) {
-        return {
-            pass: false,
-            message: () => `Expected a result wrapper object with isError property`,
-        };
-    }
-    let pass = result.isError;
-    if (pass && expectedCode !== undefined) {
-        pass = result.error?.code === expectedCode;
-    }
-    return {
-        pass,
-        message: () => {
-            if (!result.isError) {
-                return 'Expected result to be an error, but it was successful';
-            }
-            if (expectedCode !== undefined && result.error?.code !== expectedCode) {
-                return `Expected error code ${expectedCode}, but got ${result.error?.code}`;
-            }
-            return 'Expected result not to be an error';
-        },
-    };
-};
-/**
- * Check if tool result or resource content has text content, optionally containing specific text
- * Works with both ToolResultWrapper and ResourceContentWrapper
- */
-const toHaveTextContent = function (received, expectedText) {
-    const result = received;
-    // Check if it's a valid wrapper object with text() method
-    if (typeof result !== 'object' || result === null || !('text' in result)) {
-        return {
-            pass: false,
-            message: () => `Expected a ToolResultWrapper or ResourceContentWrapper object with text method`,
-        };
-    }
-    // Get text content - works for both wrapper types
-    const text = result.text();
-    // Check if has text content - ToolResultWrapper has hasTextContent, ResourceContentWrapper uses text() !== undefined
-    const hasText = 'hasTextContent' in result ? result.hasTextContent() : text !== undefined;
-    let pass = hasText;
-    if (pass && expectedText !== undefined) {
-        pass = text?.includes(expectedText) ?? false;
-    }
-    return {
-        pass,
-        message: () => {
-            if (!hasText) {
-                return 'Expected result to have text content';
-            }
-            if (expectedText !== undefined && !text?.includes(expectedText)) {
-                return `Expected text to contain "${expectedText}", but got: "${text}"`;
-            }
-            return 'Expected result not to have text content';
-        },
-    };
-};
-/**
- * Check if tool result has image content
- */
-const toHaveImageContent = function (received) {
-    const result = received;
-    if (typeof result !== 'object' || result === null || !('hasImageContent' in result)) {
-        return {
-            pass: false,
-            message: () => `Expected a ToolResultWrapper object with hasImageContent method`,
-        };
-    }
-    const pass = result.hasImageContent();
-    return {
-        pass,
-        message: () => (pass ? 'Expected result not to have image content' : 'Expected result to have image content'),
-    };
-};
-/**
- * Check if tool result has resource content
- */
-const toHaveResourceContent = function (received) {
-    const result = received;
-    if (typeof result !== 'object' || result === null || !('hasResourceContent' in result)) {
-        return {
-            pass: false,
-            message: () => `Expected a ToolResultWrapper object with hasResourceContent method`,
-        };
-    }
-    const pass = result.hasResourceContent();
-    return {
-        pass,
-        message: () => (pass ? 'Expected result not to have resource content' : 'Expected result to have resource content'),
-    };
-};
-// ═══════════════════════════════════════════════════════════════════
-// RESOURCE MATCHERS
-// ═══════════════════════════════════════════════════════════════════
-/**
- * Check if resources array contains a resource with the given URI
- */
-const toContainResource = function (received, uri) {
-    const resources = received;
-    if (!Array.isArray(resources)) {
-        return {
-            pass: false,
-            message: () => `Expected an array of resources, but received ${typeof received}`,
-        };
-    }
-    const pass = resources.some((r) => r.uri === uri);
-    const availableUris = resources.map((r) => r.uri).join(', ');
-    return {
-        pass,
-        message: () => pass
-            ? `Expected resources not to contain "${uri}"`
-            : `Expected resources to contain "${uri}", but got: [${availableUris}]`,
-    };
-};
-/**
- * Check if resource templates array contains a template with the given URI template
- */
-const toContainResourceTemplate = function (received, uriTemplate) {
-    const templates = received;
-    if (!Array.isArray(templates)) {
-        return {
-            pass: false,
-            message: () => `Expected an array of resource templates, but received ${typeof received}`,
-        };
-    }
-    const pass = templates.some((t) => t.uriTemplate === uriTemplate);
-    const availableTemplates = templates.map((t) => t.uriTemplate).join(', ');
-    return {
-        pass,
-        message: () => pass
-            ? `Expected templates not to contain "${uriTemplate}"`
-            : `Expected templates to contain "${uriTemplate}", but got: [${availableTemplates}]`,
-    };
-};
-/**
- * Check if resource content has a specific MIME type
- */
-const toHaveMimeType = function (received, mimeType) {
-    const result = received;
-    if (typeof result !== 'object' || result === null || !('hasMimeType' in result)) {
-        return {
-            pass: false,
-            message: () => `Expected a ResourceContentWrapper object with hasMimeType method`,
-        };
-    }
-    const pass = result.hasMimeType(mimeType);
-    const actualMimeType = result.mimeType();
-    return {
-        pass,
-        message: () => pass
-            ? `Expected content not to have MIME type "${mimeType}"`
-            : `Expected MIME type "${mimeType}", but got "${actualMimeType}"`,
-    };
-};
-// ═══════════════════════════════════════════════════════════════════
-// PROMPT MATCHERS
-// ═══════════════════════════════════════════════════════════════════
-/**
- * Check if prompts array contains a prompt with the given name
- */
-const toContainPrompt = function (received, name) {
-    const prompts = received;
-    if (!Array.isArray(prompts)) {
-        return {
-            pass: false,
-            message: () => `Expected an array of prompts, but received ${typeof received}`,
-        };
-    }
-    const pass = prompts.some((p) => p.name === name);
-    const availablePrompts = prompts.map((p) => p.name).join(', ');
-    return {
-        pass,
-        message: () => pass
-            ? `Expected prompts not to contain "${name}"`
-            : `Expected prompts to contain "${name}", but got: [${availablePrompts}]`,
-    };
-};
-/**
- * Check if prompt result has a specific number of messages
- */
-const toHaveMessages = function (received, count) {
-    const result = received;
-    if (typeof result !== 'object' || result === null || !('messages' in result)) {
-        return {
-            pass: false,
-            message: () => `Expected a PromptResultWrapper object with messages property`,
-        };
-    }
-    const actualCount = result.messages?.length ?? 0;
-    const pass = actualCount === count;
-    return {
-        pass,
-        message: () => pass
-            ? `Expected prompt not to have ${count} messages`
-            : `Expected prompt to have ${count} messages, but got ${actualCount}`,
-    };
-};
-// ═══════════════════════════════════════════════════════════════════
-// PROTOCOL MATCHERS
-// ═══════════════════════════════════════════════════════════════════
-/**
- * Check if response is valid JSON-RPC 2.0
- * A valid JSON-RPC 2.0 response must have:
- * - jsonrpc: "2.0"
- * - id (matching the request, can be null for notifications)
- * - Either result OR error (but not both)
- */
-const toBeValidJsonRpc = function (received) {
-    const response = received;
-    if (typeof response !== 'object' || response === null) {
-        return {
-            pass: false,
-            message: () => `Expected an object, but received ${typeof received}`,
-        };
-    }
-    const hasJsonRpc = response['jsonrpc'] === '2.0';
-    const hasId = 'id' in response;
-    const hasResult = 'result' in response;
-    const hasError = 'error' in response;
-    const hasExactlyOneResultOrError = (hasResult || hasError) && !(hasResult && hasError);
-    const pass = hasJsonRpc && hasId && hasExactlyOneResultOrError;
-    return {
-        pass,
-        message: () => {
-            if (pass) {
-                return 'Expected response not to be valid JSON-RPC';
-            }
-            const issues = [];
-            if (!hasJsonRpc)
-                issues.push('missing or invalid "jsonrpc": "2.0"');
-            if (!hasId)
-                issues.push('missing "id" field');
-            if (!hasExactlyOneResultOrError) {
-                if (!hasResult && !hasError)
-                    issues.push('missing "result" or "error"');
-                else
-                    issues.push('cannot have both "result" and "error"');
-            }
-            return `Expected valid JSON-RPC 2.0 response: ${issues.join(', ')}`;
-        },
-    };
-};
-/**
- * Check if JSON-RPC response has a result
- */
-const toHaveResult = function (received) {
-    const response = received;
-    if (typeof response !== 'object' || response === null) {
-        return {
-            pass: false,
-            message: () => `Expected an object, but received ${typeof received}`,
-        };
-    }
-    const pass = 'result' in response;
-    return {
-        pass,
-        message: () => (pass ? 'Expected response not to have result' : 'Expected response to have result'),
-    };
-};
-/**
- * Check if JSON-RPC response has an error
- */
-const toHaveError = function (received) {
-    const response = received;
-    if (typeof response !== 'object' || response === null) {
-        return {
-            pass: false,
-            message: () => `Expected an object, but received ${typeof received}`,
-        };
-    }
-    const pass = 'error' in response;
-    return {
-        pass,
-        message: () => (pass ? 'Expected response not to have error' : 'Expected response to have error'),
-    };
-};
-/**
- * Check if JSON-RPC response has a specific error code
- */
-const toHaveErrorCode = function (received, code) {
-    const response = received;
-    if (typeof response !== 'object' || response === null) {
-        return {
-            pass: false,
-            message: () => `Expected an object, but received ${typeof received}`,
-        };
-    }
-    const actualCode = response.error?.code;
-    const pass = actualCode === code;
-    return {
-        pass,
-        message: () => pass
-            ? `Expected response not to have error code ${code}`
-            : `Expected error code ${code}, but got ${actualCode ?? 'no error'}`,
-    };
-};
-// ═══════════════════════════════════════════════════════════════════
-// EXPORTS
-// ═══════════════════════════════════════════════════════════════════
-/**
- * All MCP matchers as an object for expect.extend()
- */
-exports.mcpMatchers = {
-    // Tool matchers
-    toContainTool,
-    toBeSuccessful,
-    toBeError,
-    toHaveTextContent,
-    toHaveImageContent,
-    toHaveResourceContent,
-    // Resource matchers
-    toContainResource,
-    toContainResourceTemplate,
-    toHaveMimeType,
-    // Prompt matchers
-    toContainPrompt,
-    toHaveMessages,
-    // Protocol matchers
-    toBeValidJsonRpc,
-    toHaveResult,
-    toHaveError,
-    toHaveErrorCode,
-    // UI matchers (for testing tool UI responses)
-    ...ui_matchers_1.uiMatchers,
-};
-//# sourceMappingURL=mcp-matchers.js.map