@frontmcp/testing 0.5.0

package/src/matchers/mcp-matchers.js

@@ -0,0 +1,391 @@
+"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 has text content, optionally containing specific text
+ */
+const toHaveTextContent = function (received, expectedText) {
+    const result = received;
+    if (typeof result !== 'object' || result === null || !('hasTextContent' in result)) {
+        return {
+            pass: false,
+            message: () => `Expected a ToolResultWrapper object with hasTextContent method`,
+        };
+    }
+    const hasText = result.hasTextContent();
+    const text = result.text();
+    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

package/src/matchers/mcp-matchers.js.map

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

package/src/playwright/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @file playwright/index.ts
+ * @description Playwright integration for OAuth flow testing (Future Phase)
+ *
+ * This module will provide Playwright-based testing utilities for:
+ * - OAuth consent flow testing
+ * - Login page interactions
+ * - Browser-based authentication flows
+ *
+ * @example
+ * ```typescript
+ * import { test, expect } from '@frontmcp/testing/playwright';
+ * import MyServer from './src/main';
+ *
+ * test.describe('OAuth Flow', () => {
+ *   test.use({
+ *     server: MyServer,
+ *     auth: { mode: 'orchestrated' }
+ *   });
+ *
+ *   test('completes OAuth flow', async ({ page, oauth }) => {
+ *     const { authorizeUrl } = await oauth.startFlow({ ... });
+ *     await page.goto(authorizeUrl);
+ *     // Test login and consent pages
+ *   });
+ * });
+ * ```
+ */
+export declare const playwrightIntegration: {
+    version: string;
+    status: string;
+    description: string;
+};
+export declare function test(_name: string, _fn: () => Promise<void>): void;
+export declare const expect: {
+    notImplemented: boolean;
+};

package/src/playwright/index.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * @file playwright/index.ts
+ * @description Playwright integration for OAuth flow testing (Future Phase)
+ *
+ * This module will provide Playwright-based testing utilities for:
+ * - OAuth consent flow testing
+ * - Login page interactions
+ * - Browser-based authentication flows
+ *
+ * @example
+ * ```typescript
+ * import { test, expect } from '@frontmcp/testing/playwright';
+ * import MyServer from './src/main';
+ *
+ * test.describe('OAuth Flow', () => {
+ *   test.use({
+ *     server: MyServer,
+ *     auth: { mode: 'orchestrated' }
+ *   });
+ *
+ *   test('completes OAuth flow', async ({ page, oauth }) => {
+ *     const { authorizeUrl } = await oauth.startFlow({ ... });
+ *     await page.goto(authorizeUrl);
+ *     // Test login and consent pages
+ *   });
+ * });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.expect = exports.playwrightIntegration = void 0;
+exports.test = test;
+// Placeholder exports - will be implemented in future phase
+exports.playwrightIntegration = {
+    version: '0.4.0',
+    status: 'planned',
+    description: 'Playwright integration for OAuth flow testing - coming in a future release',
+};
+// Export placeholder test function
+function test(_name, _fn) {
+    throw new Error('Playwright integration not yet implemented. ' +
+        'Use @frontmcp/testing for non-browser tests, ' +
+        'or wait for a future release that includes playwright support.');
+}
+// Export placeholder expect
+exports.expect = {
+    notImplemented: true,
+};
+//# sourceMappingURL=index.js.map

package/src/playwright/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/playwright/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;;;AAUH,oBAMC;AAdD,4DAA4D;AAC/C,QAAA,qBAAqB,GAAG;IACnC,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE,SAAS;IACjB,WAAW,EAAE,4EAA4E;CAC1F,CAAC;AAEF,mCAAmC;AACnC,SAAgB,IAAI,CAAC,KAAa,EAAE,GAAwB;IAC1D,MAAM,IAAI,KAAK,CACb,8CAA8C;QAC5C,+CAA+C;QAC/C,gEAAgE,CACnE,CAAC;AACJ,CAAC;AAED,4BAA4B;AACf,QAAA,MAAM,GAAG;IACpB,cAAc,EAAE,IAAI;CACrB,CAAC","sourcesContent":["/**\n * @file playwright/index.ts\n * @description Playwright integration for OAuth flow testing (Future Phase)\n *\n * This module will provide Playwright-based testing utilities for:\n * - OAuth consent flow testing\n * - Login page interactions\n * - Browser-based authentication flows\n *\n * @example\n * ```typescript\n * import { test, expect } from '@frontmcp/testing/playwright';\n * import MyServer from './src/main';\n *\n * test.describe('OAuth Flow', () => {\n *   test.use({\n *     server: MyServer,\n *     auth: { mode: 'orchestrated' }\n *   });\n *\n *   test('completes OAuth flow', async ({ page, oauth }) => {\n *     const { authorizeUrl } = await oauth.startFlow({ ... });\n *     await page.goto(authorizeUrl);\n *     // Test login and consent pages\n *   });\n * });\n * ```\n */\n\n// Placeholder exports - will be implemented in future phase\nexport const playwrightIntegration = {\n  version: '0.4.0',\n  status: 'planned',\n  description: 'Playwright integration for OAuth flow testing - coming in a future release',\n};\n\n// Export placeholder test function\nexport function test(_name: string, _fn: () => Promise<void>): void {\n  throw new Error(\n    'Playwright integration not yet implemented. ' +\n      'Use @frontmcp/testing for non-browser tests, ' +\n      'or wait for a future release that includes playwright support.',\n  );\n}\n\n// Export placeholder expect\nexport const expect = {\n  notImplemented: true,\n};\n"]}

package/src/server/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @file server/index.ts
+ * @description Test server management exports
+ */
+export { TestServer } from './test-server';
+export type { TestServerOptions, TestServerInfo } from './test-server';

package/src/server/index.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * @file server/index.ts
+ * @description Test server management exports
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TestServer = void 0;
+var test_server_1 = require("./test-server");
+Object.defineProperty(exports, "TestServer", { enumerable: true, get: function () { return test_server_1.TestServer; } });
+//# sourceMappingURL=index.js.map

package/src/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,6CAA2C;AAAlC,yGAAA,UAAU,OAAA","sourcesContent":["/**\n * @file server/index.ts\n * @description Test server management exports\n */\n\nexport { TestServer } from './test-server';\nexport type { TestServerOptions, TestServerInfo } from './test-server';\n"]}

package/src/server/test-server.d.ts

@@ -0,0 +1,99 @@
+/**
+ * @file test-server.ts
+ * @description Test server management for E2E testing
+ */
+export interface TestServerOptions {
+    /** Port to run the server on (default: random available port) */
+    port?: number;
+    /** Command to start the server */
+    command?: string;
+    /** Working directory */
+    cwd?: string;
+    /** Environment variables */
+    env?: Record<string, string>;
+    /** Timeout for server startup in milliseconds (default: 30000) */
+    startupTimeout?: number;
+    /** Path to check for server readiness (default: /health) */
+    healthCheckPath?: string;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+export interface TestServerInfo {
+    /** Base URL of the server */
+    baseUrl: string;
+    /** Port the server is running on */
+    port: number;
+    /** Process ID (if available) */
+    pid?: number;
+}
+/**
+ * Manages test server lifecycle for E2E testing
+ *
+ * @example
+ * ```typescript
+ * // Start a server with custom command
+ * const server = await TestServer.start({
+ *   command: 'node dist/main.js',
+ *   port: 3003,
+ *   cwd: './apps/my-server',
+ * });
+ *
+ * // Or start an Nx project
+ * const server = await TestServer.startNx('demo-public', { port: 3003 });
+ *
+ * // Use the server
+ * console.log(server.info.baseUrl); // http://localhost:3003
+ *
+ * // Stop when done
+ * await server.stop();
+ * ```
+ */
+export declare class TestServer {
+    private process;
+    private readonly options;
+    private _info;
+    private logs;
+    private constructor();
+    /**
+     * Start a test server with custom command
+     */
+    static start(options: TestServerOptions): Promise<TestServer>;
+    /**
+     * Start an Nx project as test server
+     */
+    static startNx(project: string, options?: Partial<TestServerOptions>): Promise<TestServer>;
+    /**
+     * Create a test server connected to an already running server
+     */
+    static connect(baseUrl: string): TestServer;
+    /**
+     * Get server information
+     */
+    get info(): TestServerInfo;
+    /**
+     * Stop the test server
+     */
+    stop(): Promise<void>;
+    /**
+     * Wait for server to be ready
+     */
+    waitForReady(timeout?: number): Promise<void>;
+    /**
+     * Restart the server
+     */
+    restart(): Promise<void>;
+    /**
+     * Get captured server logs
+     */
+    getLogs(): string[];
+    /**
+     * Clear captured logs
+     */
+    clearLogs(): void;
+    private startProcess;
+    private log;
+}
+/**
+ * Find an available port
+ */
+export declare function findAvailablePort(): Promise<number>;