@frontmcp/testing 0.6.0 → 0.6.2

package/src/assertions/mcp-assertions.js

@@ -1,220 +0,0 @@
-"use strict";
-/**
- * @file mcp-assertions.ts
- * @description MCP-specific test assertions
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.McpAssertions = void 0;
-exports.containsTool = containsTool;
-exports.containsResource = containsResource;
-exports.containsResourceTemplate = containsResourceTemplate;
-exports.containsPrompt = containsPrompt;
-exports.isSuccessful = isSuccessful;
-exports.isError = isError;
-exports.hasTextContent = hasTextContent;
-exports.hasMimeType = hasMimeType;
-// ═══════════════════════════════════════════════════════════════════
-// ASSERTION FUNCTIONS
-// ═══════════════════════════════════════════════════════════════════
-/**
- * MCP-specific assertion helpers
- */
-exports.McpAssertions = {
-    /**
-     * Assert that an MCP response was successful and return the data
-     * @throws Error if response was not successful
-     */
-    assertSuccess(response, message) {
-        if (!response.success) {
-            const errorMsg = response.error?.message ?? 'Unknown error';
-            throw new Error(message ?? `Expected success but got error: ${errorMsg} (code: ${response.error?.code})`);
-        }
-        if (response.data === undefined) {
-            throw new Error(message ?? 'Expected data but got undefined');
-        }
-        return response.data;
-    },
-    /**
-     * Assert that an MCP response was an error
-     * @param expectedCode Optional expected error code
-     */
-    assertError(response, expectedCode) {
-        if (response.success) {
-            throw new Error('Expected error but got success');
-        }
-        if (!response.error) {
-            throw new Error('Expected error info but got undefined');
-        }
-        if (expectedCode !== undefined && response.error.code !== expectedCode) {
-            throw new Error(`Expected error code ${expectedCode} but got ${response.error.code}: ${response.error.message}`);
-        }
-        return response.error;
-    },
-    /**
-     * Assert that a tool call was successful (not isError)
-     */
-    assertToolSuccess(result) {
-        if ('raw' in result) {
-            // ToolResultWrapper
-            if (result.isError) {
-                throw new Error(`Tool call failed: ${result.error?.message ?? 'Unknown error'}`);
-            }
-        }
-        else {
-            // McpResponse<CallToolResult>
-            if (!result.success) {
-                throw new Error(`Tool call failed: ${result.error?.message ?? 'Unknown error'}`);
-            }
-            if (result.data?.isError) {
-                throw new Error('Tool returned isError=true');
-            }
-        }
-    },
-    /**
-     * Assert that a tool result has specific content type
-     */
-    assertToolContent(result, type) {
-        let content;
-        if ('raw' in result) {
-            content = result.raw.content;
-        }
-        else {
-            if (!result.success || !result.data) {
-                throw new Error('Tool call was not successful');
-            }
-            content = result.data.content;
-        }
-        const hasContent = content?.some((c) => c.type === type);
-        if (!hasContent) {
-            throw new Error(`Expected tool result to have ${type} content`);
-        }
-    },
-    /**
-     * Assert that a resource read was successful and return the text content
-     */
-    assertTextResource(response) {
-        if ('raw' in response) {
-            // ResourceContentWrapper
-            if (response.isError) {
-                throw new Error(`Resource read failed: ${response.error?.message ?? 'Unknown error'}`);
-            }
-            const text = response.text();
-            if (text === undefined) {
-                throw new Error('Expected text content but got undefined');
-            }
-            return text;
-        }
-        else {
-            // McpResponse<ReadResourceResult>
-            if (!response.success || !response.data) {
-                throw new Error(`Resource read failed: ${response.error?.message ?? 'Unknown error'}`);
-            }
-            const content = response.data.contents?.[0];
-            if (!content || !('text' in content)) {
-                throw new Error('Expected text content but got undefined');
-            }
-            return content.text;
-        }
-    },
-    /**
-     * Assert that tools array contains a tool with given name
-     */
-    assertContainsTool(tools, name) {
-        const tool = tools.find((t) => t.name === name);
-        if (!tool) {
-            const available = tools.map((t) => t.name).join(', ');
-            throw new Error(`Expected to find tool "${name}" but got: [${available}]`);
-        }
-        return tool;
-    },
-    /**
-     * Assert that resources array contains a resource with given URI
-     */
-    assertContainsResource(resources, uri) {
-        const resource = resources.find((r) => r.uri === uri);
-        if (!resource) {
-            const available = resources.map((r) => r.uri).join(', ');
-            throw new Error(`Expected to find resource "${uri}" but got: [${available}]`);
-        }
-        return resource;
-    },
-    /**
-     * Assert that resource templates array contains a template with given URI template
-     */
-    assertContainsResourceTemplate(templates, uriTemplate) {
-        const template = templates.find((t) => t.uriTemplate === uriTemplate);
-        if (!template) {
-            const available = templates.map((t) => t.uriTemplate).join(', ');
-            throw new Error(`Expected to find resource template "${uriTemplate}" but got: [${available}]`);
-        }
-        return template;
-    },
-    /**
-     * Assert that prompts array contains a prompt with given name
-     */
-    assertContainsPrompt(prompts, name) {
-        const prompt = prompts.find((p) => p.name === name);
-        if (!prompt) {
-            const available = prompts.map((p) => p.name).join(', ');
-            throw new Error(`Expected to find prompt "${name}" but got: [${available}]`);
-        }
-        return prompt;
-    },
-};
-// ═══════════════════════════════════════════════════════════════════
-// HELPER FUNCTIONS FOR CUSTOM MATCHERS
-// ═══════════════════════════════════════════════════════════════════
-/**
- * Check if tools array contains a tool with given name
- */
-function containsTool(tools, name) {
-    return tools.some((t) => t.name === name);
-}
-/**
- * Check if resources array contains a resource with given URI
- */
-function containsResource(resources, uri) {
-    return resources.some((r) => r.uri === uri);
-}
-/**
- * Check if resource templates array contains a template with given URI template
- */
-function containsResourceTemplate(templates, uriTemplate) {
-    return templates.some((t) => t.uriTemplate === uriTemplate);
-}
-/**
- * Check if prompts array contains a prompt with given name
- */
-function containsPrompt(prompts, name) {
-    return prompts.some((p) => p.name === name);
-}
-/**
- * Check if result is successful
- */
-function isSuccessful(result) {
-    return result.isSuccess;
-}
-/**
- * Check if result is an error
- */
-function isError(result, expectedCode) {
-    if (!result.isError)
-        return false;
-    if (expectedCode !== undefined) {
-        return result.error?.code === expectedCode;
-    }
-    return true;
-}
-/**
- * Check if result has text content
- */
-function hasTextContent(result) {
-    return result.hasTextContent();
-}
-/**
- * Check if resource has specific MIME type
- */
-function hasMimeType(result, mimeType) {
-    return result.hasMimeType(mimeType);
-}
-//# sourceMappingURL=mcp-assertions.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-assertions.js","sourceRoot":"","sources":["../../../src/assertions/mcp-assertions.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @file mcp-assertions.ts\n * @description MCP-specific test assertions\n */\n\nimport type { McpResponse, ToolResultWrapper, ResourceContentWrapper, McpErrorInfo } from '../client';\nimport type {\n  Tool,\n  Resource,\n  ResourceTemplate,\n  Prompt,\n  CallToolResult,\n  ReadResourceResult,\n} from '@modelcontextprotocol/sdk/types.js';\n\n// ═══════════════════════════════════════════════════════════════════\n// ASSERTION FUNCTIONS\n// ═══════════════════════════════════════════════════════════════════\n\n/**\n * MCP-specific assertion helpers\n */\nexport const McpAssertions = {\n  /**\n   * Assert that an MCP response was successful and return the data\n   * @throws Error if response was not successful\n   */\n  assertSuccess<T>(response: McpResponse<T>, message?: string): T {\n    if (!response.success) {\n      const errorMsg = response.error?.message ?? 'Unknown error';\n      throw new Error(message ?? `Expected success but got error: ${errorMsg} (code: ${response.error?.code})`);\n    }\n    if (response.data === undefined) {\n      throw new Error(message ?? 'Expected data but got undefined');\n    }\n    return response.data;\n  },\n\n  /**\n   * Assert that an MCP response was an error\n   * @param expectedCode Optional expected error code\n   */\n  assertError<T>(response: McpResponse<T>, expectedCode?: number): McpErrorInfo {\n    if (response.success) {\n      throw new Error('Expected error but got success');\n    }\n    if (!response.error) {\n      throw new Error('Expected error info but got undefined');\n    }\n    if (expectedCode !== undefined && response.error.code !== expectedCode) {\n      throw new Error(`Expected error code ${expectedCode} but got ${response.error.code}: ${response.error.message}`);\n    }\n    return response.error;\n  },\n\n  /**\n   * Assert that a tool call was successful (not isError)\n   */\n  assertToolSuccess(result: ToolResultWrapper | McpResponse<CallToolResult>): void {\n    if ('raw' in result) {\n      // ToolResultWrapper\n      if (result.isError) {\n        throw new Error(`Tool call failed: ${result.error?.message ?? 'Unknown error'}`);\n      }\n    } else {\n      // McpResponse<CallToolResult>\n      if (!result.success) {\n        throw new Error(`Tool call failed: ${result.error?.message ?? 'Unknown error'}`);\n      }\n      if (result.data?.isError) {\n        throw new Error('Tool returned isError=true');\n      }\n    }\n  },\n\n  /**\n   * Assert that a tool result has specific content type\n   */\n  assertToolContent(\n    result: ToolResultWrapper | McpResponse<CallToolResult>,\n    type: 'text' | 'image' | 'resource',\n  ): void {\n    let content: CallToolResult['content'];\n\n    if ('raw' in result) {\n      content = result.raw.content;\n    } else {\n      if (!result.success || !result.data) {\n        throw new Error('Tool call was not successful');\n      }\n      content = result.data.content;\n    }\n\n    const hasContent = content?.some((c) => c.type === type);\n    if (!hasContent) {\n      throw new Error(`Expected tool result to have ${type} content`);\n    }\n  },\n\n  /**\n   * Assert that a resource read was successful and return the text content\n   */\n  assertTextResource(response: ResourceContentWrapper | McpResponse<ReadResourceResult>): string {\n    if ('raw' in response) {\n      // ResourceContentWrapper\n      if (response.isError) {\n        throw new Error(`Resource read failed: ${response.error?.message ?? 'Unknown error'}`);\n      }\n      const text = response.text();\n      if (text === undefined) {\n        throw new Error('Expected text content but got undefined');\n      }\n      return text;\n    } else {\n      // McpResponse<ReadResourceResult>\n      if (!response.success || !response.data) {\n        throw new Error(`Resource read failed: ${response.error?.message ?? 'Unknown error'}`);\n      }\n      const content = response.data.contents?.[0];\n      if (!content || !('text' in content)) {\n        throw new Error('Expected text content but got undefined');\n      }\n      return content.text;\n    }\n  },\n\n  /**\n   * Assert that tools array contains a tool with given name\n   */\n  assertContainsTool(tools: Tool[], name: string): Tool {\n    const tool = tools.find((t) => t.name === name);\n    if (!tool) {\n      const available = tools.map((t) => t.name).join(', ');\n      throw new Error(`Expected to find tool \"${name}\" but got: [${available}]`);\n    }\n    return tool;\n  },\n\n  /**\n   * Assert that resources array contains a resource with given URI\n   */\n  assertContainsResource(resources: Resource[], uri: string): Resource {\n    const resource = resources.find((r) => r.uri === uri);\n    if (!resource) {\n      const available = resources.map((r) => r.uri).join(', ');\n      throw new Error(`Expected to find resource \"${uri}\" but got: [${available}]`);\n    }\n    return resource;\n  },\n\n  /**\n   * Assert that resource templates array contains a template with given URI template\n   */\n  assertContainsResourceTemplate(templates: ResourceTemplate[], uriTemplate: string): ResourceTemplate {\n    const template = templates.find((t) => t.uriTemplate === uriTemplate);\n    if (!template) {\n      const available = templates.map((t) => t.uriTemplate).join(', ');\n      throw new Error(`Expected to find resource template \"${uriTemplate}\" but got: [${available}]`);\n    }\n    return template;\n  },\n\n  /**\n   * Assert that prompts array contains a prompt with given name\n   */\n  assertContainsPrompt(prompts: Prompt[], name: string): Prompt {\n    const prompt = prompts.find((p) => p.name === name);\n    if (!prompt) {\n      const available = prompts.map((p) => p.name).join(', ');\n      throw new Error(`Expected to find prompt \"${name}\" but got: [${available}]`);\n    }\n    return prompt;\n  },\n};\n\n// ═══════════════════════════════════════════════════════════════════\n// HELPER FUNCTIONS FOR CUSTOM MATCHERS\n// ═══════════════════════════════════════════════════════════════════\n\n/**\n * Check if tools array contains a tool with given name\n */\nexport function containsTool(tools: Tool[], name: string): boolean {\n  return tools.some((t) => t.name === name);\n}\n\n/**\n * Check if resources array contains a resource with given URI\n */\nexport function containsResource(resources: Resource[], uri: string): boolean {\n  return resources.some((r) => r.uri === uri);\n}\n\n/**\n * Check if resource templates array contains a template with given URI template\n */\nexport function containsResourceTemplate(templates: ResourceTemplate[], uriTemplate: string): boolean {\n  return templates.some((t) => t.uriTemplate === uriTemplate);\n}\n\n/**\n * Check if prompts array contains a prompt with given name\n */\nexport function containsPrompt(prompts: Prompt[], name: string): boolean {\n  return prompts.some((p) => p.name === name);\n}\n\n/**\n * Check if result is successful\n */\nexport function isSuccessful(result: ToolResultWrapper | ResourceContentWrapper): boolean {\n  return result.isSuccess;\n}\n\n/**\n * Check if result is an error\n */\nexport function isError(result: ToolResultWrapper | ResourceContentWrapper, expectedCode?: number): boolean {\n  if (!result.isError) return false;\n  if (expectedCode !== undefined) {\n    return result.error?.code === expectedCode;\n  }\n  return true;\n}\n\n/**\n * Check if result has text content\n */\nexport function hasTextContent(result: ToolResultWrapper): boolean {\n  return result.hasTextContent();\n}\n\n/**\n * Check if resource has specific MIME type\n */\nexport function hasMimeType(result: ResourceContentWrapper, mimeType: string): boolean {\n  return result.hasMimeType(mimeType);\n}\n"]}

package/src/auth/auth-headers.js

@@ -1,62 +0,0 @@
-"use strict";
-/**
- * @file auth-headers.ts
- * @description Helper functions for building authentication headers
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AuthHeaders = void 0;
-/**
- * Helper functions for building authentication headers
- */
-exports.AuthHeaders = {
-    /**
-     * Create Authorization header with Bearer token
-     */
-    bearer(token) {
-        return {
-            Authorization: `Bearer ${token}`,
-        };
-    },
-    /**
-     * Create headers with no authentication
-     */
-    noAuth() {
-        return {};
-    },
-    /**
-     * Create full MCP request headers with auth and session
-     */
-    mcpRequest(token, sessionId) {
-        const headers = {
-            'Content-Type': 'application/json',
-            Accept: 'application/json',
-            Authorization: `Bearer ${token}`,
-        };
-        if (sessionId) {
-            headers['mcp-session-id'] = sessionId;
-        }
-        return headers;
-    },
-    /**
-     * Create headers for public mode (no auth required)
-     */
-    publicMode(sessionId) {
-        const headers = {
-            'Content-Type': 'application/json',
-            Accept: 'application/json',
-        };
-        if (sessionId) {
-            headers['mcp-session-id'] = sessionId;
-        }
-        return headers;
-    },
-    /**
-     * Create headers with custom auth header value
-     */
-    custom(headerName, headerValue) {
-        return {
-            [headerName]: headerValue,
-        };
-    },
-};
-//# sourceMappingURL=auth-headers.js.map

package/src/auth/auth-headers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"auth-headers.js","sourceRoot":"","sources":["../../../src/auth/auth-headers.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH;;GAEG;AACU,QAAA,WAAW,GAAG;IACzB;;OAEG;IACH,MAAM,CAAC,KAAa;QAClB,OAAO;YACL,aAAa,EAAE,UAAU,KAAK,EAAE;SACjC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,KAAa,EAAE,SAAkB;QAC1C,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,kBAAkB;YAClC,MAAM,EAAE,kBAAkB;YAC1B,aAAa,EAAE,UAAU,KAAK,EAAE;SACjC,CAAC;QAEF,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,CAAC,gBAAgB,CAAC,GAAG,SAAS,CAAC;QACxC,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,SAAkB;QAC3B,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,kBAAkB;YAClC,MAAM,EAAE,kBAAkB;SAC3B,CAAC;QAEF,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,CAAC,gBAAgB,CAAC,GAAG,SAAS,CAAC;QACxC,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,UAAkB,EAAE,WAAmB;QAC5C,OAAO;YACL,CAAC,UAAU,CAAC,EAAE,WAAW;SAC1B,CAAC;IACJ,CAAC;CACF,CAAC","sourcesContent":["/**\n * @file auth-headers.ts\n * @description Helper functions for building authentication headers\n */\n\n/**\n * Helper functions for building authentication headers\n */\nexport const AuthHeaders = {\n  /**\n   * Create Authorization header with Bearer token\n   */\n  bearer(token: string): Record<string, string> {\n    return {\n      Authorization: `Bearer ${token}`,\n    };\n  },\n\n  /**\n   * Create headers with no authentication\n   */\n  noAuth(): Record<string, string> {\n    return {};\n  },\n\n  /**\n   * Create full MCP request headers with auth and session\n   */\n  mcpRequest(token: string, sessionId?: string): Record<string, string> {\n    const headers: Record<string, string> = {\n      'Content-Type': 'application/json',\n      Accept: 'application/json',\n      Authorization: `Bearer ${token}`,\n    };\n\n    if (sessionId) {\n      headers['mcp-session-id'] = sessionId;\n    }\n\n    return headers;\n  },\n\n  /**\n   * Create headers for public mode (no auth required)\n   */\n  publicMode(sessionId?: string): Record<string, string> {\n    const headers: Record<string, string> = {\n      'Content-Type': 'application/json',\n      Accept: 'application/json',\n    };\n\n    if (sessionId) {\n      headers['mcp-session-id'] = sessionId;\n    }\n\n    return headers;\n  },\n\n  /**\n   * Create headers with custom auth header value\n   */\n  custom(headerName: string, headerValue: string): Record<string, string> {\n    return {\n      [headerName]: headerValue,\n    };\n  },\n};\n"]}

package/src/auth/index.js

@@ -1,15 +0,0 @@
-"use strict";
-/**
- * @file auth/index.ts
- * @description Auth testing utilities exports
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createTestUser = exports.TestUsers = exports.AuthHeaders = exports.TestTokenFactory = void 0;
-var token_factory_1 = require("./token-factory");
-Object.defineProperty(exports, "TestTokenFactory", { enumerable: true, get: function () { return token_factory_1.TestTokenFactory; } });
-var auth_headers_1 = require("./auth-headers");
-Object.defineProperty(exports, "AuthHeaders", { enumerable: true, get: function () { return auth_headers_1.AuthHeaders; } });
-var user_fixtures_1 = require("./user-fixtures");
-Object.defineProperty(exports, "TestUsers", { enumerable: true, get: function () { return user_fixtures_1.TestUsers; } });
-Object.defineProperty(exports, "createTestUser", { enumerable: true, get: function () { return user_fixtures_1.createTestUser; } });
-//# sourceMappingURL=index.js.map

package/src/auth/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/auth/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,iDAAmD;AAA1C,iHAAA,gBAAgB,OAAA;AAGzB,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AAEpB,iDAA4D;AAAnD,0GAAA,SAAS,OAAA;AAAE,+GAAA,cAAc,OAAA","sourcesContent":["/**\n * @file auth/index.ts\n * @description Auth testing utilities exports\n */\n\nexport { TestTokenFactory } from './token-factory';\nexport type { CreateTokenOptions, TokenFactoryOptions } from './token-factory';\n\nexport { AuthHeaders } from './auth-headers';\n\nexport { TestUsers, createTestUser } from './user-fixtures';\nexport type { TestUserFixture } from './user-fixtures';\n"]}

package/src/auth/mock-api-server.js

@@ -1,200 +0,0 @@
-"use strict";
-/**
- * @file mock-api-server.ts
- * @description Mock API server for testing OpenAPI adapter
- *
- * This module provides a mock HTTP server that serves:
- * - OpenAPI spec endpoint for adapter initialization
- * - Mock API responses for generated tools
- *
- * @example
- * ```typescript
- * import { MockAPIServer } from '@frontmcp/testing';
- *
- * const apiServer = new MockAPIServer({
- *   openApiSpec: { openapi: '3.0.0', ... },
- *   routes: [
- *     { method: 'GET', path: '/products', response: { body: [...] } },
- *   ],
- * });
- *
- * // Start the mock server
- * const info = await apiServer.start();
- *
- * // Configure your MCP server to use this mock
- * // OPENAPI_BASE_URL = info.baseUrl
- *
- * // Stop when done
- * await apiServer.stop();
- * ```
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MockAPIServer = void 0;
-const http_1 = require("http");
-// ═══════════════════════════════════════════════════════════════════
-// MOCK API SERVER
-// ═══════════════════════════════════════════════════════════════════
-/**
- * Mock API server for testing OpenAPI adapter
- *
- * Serves an OpenAPI spec and mock API responses so that MCP servers
- * can use the OpenAPI adapter without connecting to a real API.
- */
-class MockAPIServer {
-    options;
-    server = null;
-    _info = null;
-    routes;
-    constructor(options) {
-        this.options = options;
-        this.routes = options.routes ?? [];
-    }
-    /**
-     * Start the mock API server
-     */
-    async start() {
-        if (this.server) {
-            throw new Error('Mock API server is already running');
-        }
-        const port = this.options.port ?? 0; // 0 = random available port
-        return new Promise((resolve, reject) => {
-            this.server = (0, http_1.createServer)(this.handleRequest.bind(this));
-            this.server.on('error', (err) => {
-                this.log(`Server error: ${err.message}`);
-                reject(err);
-            });
-            this.server.listen(port, () => {
-                const address = this.server.address();
-                if (!address || typeof address === 'string') {
-                    reject(new Error('Failed to get server address'));
-                    return;
-                }
-                const actualPort = address.port;
-                this._info = {
-                    baseUrl: `http://localhost:${actualPort}`,
-                    port: actualPort,
-                    specUrl: `http://localhost:${actualPort}/openapi.json`,
-                };
-                this.log(`Mock API server started at ${this._info.baseUrl}`);
-                resolve(this._info);
-            });
-        });
-    }
-    /**
-     * Stop the mock API server
-     */
-    async stop() {
-        if (!this.server) {
-            return;
-        }
-        return new Promise((resolve, reject) => {
-            this.server.close((err) => {
-                if (err) {
-                    reject(err);
-                }
-                else {
-                    this.server = null;
-                    this._info = null;
-                    this.log('Mock API server stopped');
-                    resolve();
-                }
-            });
-        });
-    }
-    /**
-     * Get server info
-     */
-    get info() {
-        if (!this._info) {
-            throw new Error('Mock API server is not running');
-        }
-        return this._info;
-    }
-    /**
-     * Add a route dynamically
-     */
-    addRoute(route) {
-        this.routes.push(route);
-    }
-    /**
-     * Clear all routes
-     */
-    clearRoutes() {
-        this.routes = [];
-    }
-    // ═══════════════════════════════════════════════════════════════════
-    // PRIVATE
-    // ═══════════════════════════════════════════════════════════════════
-    async handleRequest(req, res) {
-        const url = req.url ?? '/';
-        const method = (req.method ?? 'GET').toUpperCase();
-        this.log(`${method} ${url}`);
-        // CORS headers
-        res.setHeader('Access-Control-Allow-Origin', '*');
-        res.setHeader('Access-Control-Allow-Methods', 'GET, POST, PUT, DELETE, PATCH, OPTIONS');
-        res.setHeader('Access-Control-Allow-Headers', 'Content-Type, Authorization');
-        if (method === 'OPTIONS') {
-            res.writeHead(204);
-            res.end();
-            return;
-        }
-        try {
-            // Serve OpenAPI spec
-            if (url === '/openapi.json' || url === '/openapi.yaml') {
-                res.writeHead(200, { 'Content-Type': 'application/json' });
-                res.end(JSON.stringify(this.options.openApiSpec));
-                this.log('Served OpenAPI spec');
-                return;
-            }
-            // Find matching route
-            const route = this.findRoute(method, url);
-            if (route) {
-                const status = route.response.status ?? 200;
-                const headers = {
-                    'Content-Type': 'application/json',
-                    ...route.response.headers,
-                };
-                res.writeHead(status, headers);
-                res.end(JSON.stringify(route.response.body));
-                this.log(`Matched route: ${method} ${route.path} -> ${status}`);
-                return;
-            }
-            // No matching route
-            res.writeHead(404, { 'Content-Type': 'application/json' });
-            res.end(JSON.stringify({ error: 'not_found', message: `No mock for ${method} ${url}` }));
-        }
-        catch (error) {
-            this.log(`Error handling request: ${error}`);
-            res.writeHead(500, { 'Content-Type': 'application/json' });
-            res.end(JSON.stringify({ error: 'server_error', message: 'Internal server error' }));
-        }
-    }
-    findRoute(method, url) {
-        // Strip query string
-        const path = url.split('?')[0];
-        return this.routes.find((route) => {
-            if (route.method !== method)
-                return false;
-            // Simple path matching (exact match or path params)
-            if (route.path === path)
-                return true;
-            // Handle path parameters like /products/:id
-            const routeParts = route.path.split('/');
-            const urlParts = path.split('/');
-            if (routeParts.length !== urlParts.length)
-                return false;
-            return routeParts.every((part, i) => {
-                if (part.startsWith(':'))
-                    return true; // Path parameter
-                return part === urlParts[i];
-            });
-        });
-    }
-    log(message) {
-        if (this.options.debug) {
-            console.log(`[MockAPIServer] ${message}`);
-        }
-    }
-}
-exports.MockAPIServer = MockAPIServer;
-//# sourceMappingURL=mock-api-server.js.map

package/src/auth/mock-api-server.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mock-api-server.js","sourceRoot":"","sources":["../../../src/auth/mock-api-server.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @file mock-api-server.ts\n * @description Mock API server for testing OpenAPI adapter\n *\n * This module provides a mock HTTP server that serves:\n * - OpenAPI spec endpoint for adapter initialization\n * - Mock API responses for generated tools\n *\n * @example\n * ```typescript\n * import { MockAPIServer } from '@frontmcp/testing';\n *\n * const apiServer = new MockAPIServer({\n *   openApiSpec: { openapi: '3.0.0', ... },\n *   routes: [\n *     { method: 'GET', path: '/products', response: { body: [...] } },\n *   ],\n * });\n *\n * // Start the mock server\n * const info = await apiServer.start();\n *\n * // Configure your MCP server to use this mock\n * // OPENAPI_BASE_URL = info.baseUrl\n *\n * // Stop when done\n * await apiServer.stop();\n * ```\n */\n\nimport { createServer, Server, IncomingMessage, ServerResponse } from 'http';\n\n// ═══════════════════════════════════════════════════════════════════\n// TYPES\n// ═══════════════════════════════════════════════════════════════════\n\nexport interface MockRoute {\n  /** HTTP method */\n  method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';\n  /** Path to match (e.g., '/products', '/products/:id') */\n  path: string;\n  /** Response to return */\n  response: MockResponse;\n}\n\nexport interface MockResponse {\n  /** HTTP status code (default: 200) */\n  status?: number;\n  /** Response headers */\n  headers?: Record<string, string>;\n  /** Response body (will be JSON serialized) */\n  body: unknown;\n}\n\nexport interface MockAPIServerOptions {\n  /** Port to listen on (default: random available port) */\n  port?: number;\n  /** OpenAPI spec to serve at /openapi.json */\n  openApiSpec: unknown;\n  /** Routes to mock */\n  routes?: MockRoute[];\n  /** Enable debug logging */\n  debug?: boolean;\n}\n\nexport interface MockAPIServerInfo {\n  /** Base URL of the server */\n  baseUrl: string;\n  /** Port the server is listening on */\n  port: number;\n  /** OpenAPI spec URL */\n  specUrl: string;\n}\n\n// ═══════════════════════════════════════════════════════════════════\n// MOCK API SERVER\n// ═══════════════════════════════════════════════════════════════════\n\n/**\n * Mock API server for testing OpenAPI adapter\n *\n * Serves an OpenAPI spec and mock API responses so that MCP servers\n * can use the OpenAPI adapter without connecting to a real API.\n */\nexport class MockAPIServer {\n  private readonly options: MockAPIServerOptions;\n  private server: Server | null = null;\n  private _info: MockAPIServerInfo | null = null;\n  private routes: MockRoute[];\n\n  constructor(options: MockAPIServerOptions) {\n    this.options = options;\n    this.routes = options.routes ?? [];\n  }\n\n  /**\n   * Start the mock API server\n   */\n  async start(): Promise<MockAPIServerInfo> {\n    if (this.server) {\n      throw new Error('Mock API server is already running');\n    }\n\n    const port = this.options.port ?? 0; // 0 = random available port\n\n    return new Promise((resolve, reject) => {\n      this.server = createServer(this.handleRequest.bind(this));\n\n      this.server.on('error', (err) => {\n        this.log(`Server error: ${err.message}`);\n        reject(err);\n      });\n\n      this.server.listen(port, () => {\n        const address = this.server!.address();\n        if (!address || typeof address === 'string') {\n          reject(new Error('Failed to get server address'));\n          return;\n        }\n\n        const actualPort = address.port;\n\n        this._info = {\n          baseUrl: `http://localhost:${actualPort}`,\n          port: actualPort,\n          specUrl: `http://localhost:${actualPort}/openapi.json`,\n        };\n\n        this.log(`Mock API server started at ${this._info.baseUrl}`);\n        resolve(this._info);\n      });\n    });\n  }\n\n  /**\n   * Stop the mock API server\n   */\n  async stop(): Promise<void> {\n    if (!this.server) {\n      return;\n    }\n\n    return new Promise((resolve, reject) => {\n      this.server!.close((err) => {\n        if (err) {\n          reject(err);\n        } else {\n          this.server = null;\n          this._info = null;\n          this.log('Mock API server stopped');\n          resolve();\n        }\n      });\n    });\n  }\n\n  /**\n   * Get server info\n   */\n  get info(): MockAPIServerInfo {\n    if (!this._info) {\n      throw new Error('Mock API server is not running');\n    }\n    return this._info;\n  }\n\n  /**\n   * Add a route dynamically\n   */\n  addRoute(route: MockRoute): void {\n    this.routes.push(route);\n  }\n\n  /**\n   * Clear all routes\n   */\n  clearRoutes(): void {\n    this.routes = [];\n  }\n\n  // ═══════════════════════════════════════════════════════════════════\n  // PRIVATE\n  // ═══════════════════════════════════════════════════════════════════\n\n  private async handleRequest(req: IncomingMessage, res: ServerResponse): Promise<void> {\n    const url = req.url ?? '/';\n    const method = (req.method ?? 'GET').toUpperCase();\n    this.log(`${method} ${url}`);\n\n    // CORS headers\n    res.setHeader('Access-Control-Allow-Origin', '*');\n    res.setHeader('Access-Control-Allow-Methods', 'GET, POST, PUT, DELETE, PATCH, OPTIONS');\n    res.setHeader('Access-Control-Allow-Headers', 'Content-Type, Authorization');\n\n    if (method === 'OPTIONS') {\n      res.writeHead(204);\n      res.end();\n      return;\n    }\n\n    try {\n      // Serve OpenAPI spec\n      if (url === '/openapi.json' || url === '/openapi.yaml') {\n        res.writeHead(200, { 'Content-Type': 'application/json' });\n        res.end(JSON.stringify(this.options.openApiSpec));\n        this.log('Served OpenAPI spec');\n        return;\n      }\n\n      // Find matching route\n      const route = this.findRoute(method, url);\n      if (route) {\n        const status = route.response.status ?? 200;\n        const headers = {\n          'Content-Type': 'application/json',\n          ...route.response.headers,\n        };\n        res.writeHead(status, headers);\n        res.end(JSON.stringify(route.response.body));\n        this.log(`Matched route: ${method} ${route.path} -> ${status}`);\n        return;\n      }\n\n      // No matching route\n      res.writeHead(404, { 'Content-Type': 'application/json' });\n      res.end(JSON.stringify({ error: 'not_found', message: `No mock for ${method} ${url}` }));\n    } catch (error) {\n      this.log(`Error handling request: ${error}`);\n      res.writeHead(500, { 'Content-Type': 'application/json' });\n      res.end(JSON.stringify({ error: 'server_error', message: 'Internal server error' }));\n    }\n  }\n\n  private findRoute(method: string, url: string): MockRoute | undefined {\n    // Strip query string\n    const path = url.split('?')[0];\n\n    return this.routes.find((route) => {\n      if (route.method !== method) return false;\n\n      // Simple path matching (exact match or path params)\n      if (route.path === path) return true;\n\n      // Handle path parameters like /products/:id\n      const routeParts = route.path.split('/');\n      const urlParts = path.split('/');\n\n      if (routeParts.length !== urlParts.length) return false;\n\n      return routeParts.every((part, i) => {\n        if (part.startsWith(':')) return true; // Path parameter\n        return part === urlParts[i];\n      });\n    });\n  }\n\n  private log(message: string): void {\n    if (this.options.debug) {\n      console.log(`[MockAPIServer] ${message}`);\n    }\n  }\n}\n"]}