@frontmcp/testing 0.5.0

package/src/http-mock/http-mock.js

@@ -0,0 +1,544 @@
+"use strict";
+/**
+ * @file http-mock.ts
+ * @description HTTP request mocking implementation for offline MCP server testing
+ *
+ * This module intercepts fetch() and XMLHttpRequest calls, allowing tools to be
+ * tested without making real HTTP requests.
+ *
+ * @example
+ * ```typescript
+ * import { httpMock } from '@frontmcp/testing';
+ *
+ * // Enable HTTP mocking
+ * const interceptor = httpMock.interceptor();
+ *
+ * // Mock a GET request
+ * interceptor.get('https://api.example.com/users', {
+ *   body: [{ id: 1, name: 'John' }],
+ * });
+ *
+ * // Mock a POST request with pattern matching
+ * interceptor.post(/api\.example\.com\/users/, {
+ *   status: 201,
+ *   body: { id: 2, name: 'Jane' },
+ * });
+ *
+ * // Now run your MCP server test - HTTP calls will be intercepted
+ * const result = await mcp.tools.call('fetch-users', {});
+ *
+ * // Verify all mocks were used
+ * interceptor.assertDone();
+ *
+ * // Restore original fetch
+ * interceptor.restore();
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.httpResponse = exports.httpMock = void 0;
+// ═══════════════════════════════════════════════════════════════════
+// GLOBAL STATE
+// ═══════════════════════════════════════════════════════════════════
+/** Original fetch function */
+let originalFetch = null;
+/** Whether mocking is enabled */
+let mockingEnabled = false;
+/** All active interceptors */
+const activeInterceptors = [];
+class HttpInterceptorImpl {
+    mocks = [];
+    _allowPassthrough = false;
+    _isActive = true;
+    mock(definition) {
+        const entry = {
+            definition,
+            callCount: 0,
+            calls: [],
+            remainingUses: definition.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],
+            waitForCalls: async (count, timeoutMs = 5000) => {
+                const deadline = Date.now() + timeoutMs;
+                while (Date.now() < deadline) {
+                    if (entry.callCount >= count) {
+                        return entry.calls.slice(0, count);
+                    }
+                    await sleep(50);
+                }
+                throw new Error(`Timeout waiting for ${count} calls, got ${entry.callCount}`);
+            },
+        };
+    }
+    get(url, response) {
+        return this.mock({
+            match: { url, method: 'GET' },
+            response: normalizeResponse(response),
+        });
+    }
+    post(url, response) {
+        return this.mock({
+            match: { url, method: 'POST' },
+            response: normalizeResponse(response),
+        });
+    }
+    put(url, response) {
+        return this.mock({
+            match: { url, method: 'PUT' },
+            response: normalizeResponse(response),
+        });
+    }
+    delete(url, response) {
+        return this.mock({
+            match: { url, method: 'DELETE' },
+            response: normalizeResponse(response),
+        });
+    }
+    any(url, response) {
+        return this.mock({
+            match: { url },
+            response: normalizeResponse(response),
+        });
+    }
+    clear() {
+        this.mocks = [];
+    }
+    pending() {
+        return this.mocks.filter((m) => m.remainingUses > 0).map((m) => m.definition);
+    }
+    isDone() {
+        return this.mocks.every((m) => m.remainingUses <= 0 || m.definition.times === undefined);
+    }
+    assertDone() {
+        const pending = this.pending().filter((m) => m.times !== undefined);
+        if (pending.length > 0) {
+            const descriptions = pending.map((m) => {
+                const url = m.match.url instanceof RegExp ? m.match.url.toString() : m.match.url;
+                return `  - ${m.match.method ?? 'ANY'} ${url}`;
+            });
+            throw new Error(`Unused HTTP mocks:\n${descriptions.join('\n')}`);
+        }
+    }
+    allowPassthrough(allow) {
+        this._allowPassthrough = allow;
+    }
+    restore() {
+        this._isActive = false;
+        const index = activeInterceptors.indexOf(this);
+        if (index !== -1) {
+            activeInterceptors.splice(index, 1);
+        }
+    }
+    // Internal methods
+    isActive() {
+        return this._isActive;
+    }
+    canPassthrough() {
+        return this._allowPassthrough;
+    }
+    /**
+     * Try to match a request against mocks in this scope
+     */
+    async matchRequest(info) {
+        if (!this._isActive)
+            return null;
+        for (const entry of this.mocks) {
+            if (entry.remainingUses <= 0)
+                continue;
+            if (this.requestMatches(info, entry.definition.match)) {
+                // Found a match
+                entry.callCount++;
+                entry.calls.push(info);
+                entry.remainingUses--;
+                // Get response
+                let mockResponse;
+                if (typeof entry.definition.response === 'function') {
+                    mockResponse = await entry.definition.response(info);
+                }
+                else {
+                    mockResponse = entry.definition.response;
+                }
+                // Apply delay
+                if (mockResponse.delay && mockResponse.delay > 0) {
+                    await sleep(mockResponse.delay);
+                }
+                return createMockResponse(mockResponse);
+            }
+        }
+        return null;
+    }
+    requestMatches(info, matcher) {
+        // Check URL
+        if (!this.urlMatches(info.url, matcher.url)) {
+            return false;
+        }
+        // Check method
+        if (matcher.method) {
+            const methods = Array.isArray(matcher.method) ? matcher.method : [matcher.method];
+            if (!methods.includes(info.method)) {
+                return false;
+            }
+        }
+        // Check headers
+        if (matcher.headers) {
+            for (const [key, expected] of Object.entries(matcher.headers)) {
+                const actual = info.headers[key.toLowerCase()];
+                if (!actual)
+                    return false;
+                if (expected instanceof RegExp) {
+                    if (!expected.test(actual))
+                        return false;
+                }
+                else if (actual !== expected) {
+                    return false;
+                }
+            }
+        }
+        // Check body
+        if (matcher.body !== undefined) {
+            if (!this.bodyMatches(info.body, matcher.body)) {
+                return false;
+            }
+        }
+        return true;
+    }
+    urlMatches(url, matcher) {
+        if (typeof matcher === 'string') {
+            // Exact match or contains
+            return url === matcher || url.includes(matcher);
+        }
+        else if (matcher instanceof RegExp) {
+            return matcher.test(url);
+        }
+        else {
+            return matcher(url);
+        }
+    }
+    bodyMatches(actual, expected) {
+        if (typeof expected === 'function') {
+            return expected(actual);
+        }
+        if (typeof expected === 'string') {
+            const actualStr = typeof actual === 'string' ? actual : JSON.stringify(actual);
+            return actualStr === expected || actualStr.includes(expected);
+        }
+        if (expected instanceof RegExp) {
+            const actualStr = typeof actual === 'string' ? actual : JSON.stringify(actual);
+            return expected.test(actualStr);
+        }
+        // Object comparison - check that all expected keys match
+        if (typeof actual !== 'object' || actual === null) {
+            return false;
+        }
+        for (const [key, value] of Object.entries(expected)) {
+            const actualValue = actual[key];
+            if (typeof value === 'object' && value !== null) {
+                if (!this.bodyMatches(actualValue, value)) {
+                    return false;
+                }
+            }
+            else if (actualValue !== value) {
+                return false;
+            }
+        }
+        return true;
+    }
+}
+// ═══════════════════════════════════════════════════════════════════
+// FETCH INTERCEPTOR
+// ═══════════════════════════════════════════════════════════════════
+async function interceptedFetch(input, init) {
+    // Build request info
+    const url = typeof input === 'string' ? input : input instanceof URL ? input.toString() : input.url;
+    const method = (init?.method ?? 'GET').toUpperCase();
+    // Parse headers
+    const headers = {};
+    if (init?.headers) {
+        if (init.headers instanceof Headers) {
+            init.headers.forEach((value, key) => {
+                headers[key.toLowerCase()] = value;
+            });
+        }
+        else if (Array.isArray(init.headers)) {
+            for (const [key, value] of init.headers) {
+                headers[key.toLowerCase()] = value;
+            }
+        }
+        else {
+            for (const [key, value] of Object.entries(init.headers)) {
+                headers[key.toLowerCase()] = value;
+            }
+        }
+    }
+    // Parse body
+    let body;
+    let rawBody;
+    if (init?.body) {
+        if (typeof init.body === 'string') {
+            rawBody = init.body;
+            try {
+                body = JSON.parse(init.body);
+            }
+            catch {
+                body = init.body;
+            }
+        }
+        else if (init.body instanceof ArrayBuffer || init.body instanceof Uint8Array) {
+            rawBody = new TextDecoder().decode(init.body);
+            try {
+                body = JSON.parse(rawBody);
+            }
+            catch {
+                body = rawBody;
+            }
+        }
+        else {
+            body = init.body;
+        }
+    }
+    const requestInfo = {
+        url,
+        method,
+        headers,
+        body,
+        rawBody,
+    };
+    // Try to match against active interceptors (in reverse order - last added first)
+    for (let i = activeInterceptors.length - 1; i >= 0; i--) {
+        const interceptor = activeInterceptors[i];
+        if (!interceptor.isActive())
+            continue;
+        const mockResponse = await interceptor.matchRequest(requestInfo);
+        if (mockResponse) {
+            return mockResponse;
+        }
+    }
+    // No match found - check if passthrough is allowed
+    for (const interceptor of activeInterceptors) {
+        if (interceptor.isActive() && interceptor.canPassthrough()) {
+            // Passthrough to real fetch
+            if (originalFetch) {
+                return originalFetch(input, init);
+            }
+        }
+    }
+    // No match and no passthrough - throw error
+    throw new Error(`No HTTP mock found for ${method} ${url}\n` +
+        `Add a mock using httpMock.interceptor().${method.toLowerCase()}('${url}', { body: ... })`);
+}
+// ═══════════════════════════════════════════════════════════════════
+// HELPERS
+// ═══════════════════════════════════════════════════════════════════
+function normalizeResponse(response) {
+    // If it looks like a plain object (response body), wrap it
+    if (!('status' in response) && !('body' in response) && !('headers' in response)) {
+        return { body: response };
+    }
+    return response;
+}
+function createMockResponse(mock) {
+    // Check for network error - throw instead of returning Response
+    // This simulates real network failures where fetch rejects
+    const mockAny = mock;
+    if (mockAny._throwError) {
+        const body = mock.body;
+        const message = body && typeof body === 'object' && 'message' in body ? String(body['message']) : 'Network error';
+        throw new TypeError(`fetch failed: ${message}`);
+    }
+    const status = mock.status ?? 200;
+    const statusText = mock.statusText ?? 'OK';
+    // Build headers
+    const headers = new Headers(mock.headers ?? {});
+    // Build body
+    let body = null;
+    if (mock.body !== undefined) {
+        if (typeof mock.body === 'string') {
+            body = mock.body;
+            if (!headers.has('content-type')) {
+                headers.set('content-type', 'text/plain');
+            }
+        }
+        else if (mock.body instanceof ArrayBuffer) {
+            body = mock.body;
+        }
+        else if (Buffer.isBuffer(mock.body)) {
+            // Convert Buffer to ArrayBuffer for Response compatibility
+            body = new Uint8Array(mock.body).buffer;
+        }
+        else {
+            body = JSON.stringify(mock.body);
+            if (!headers.has('content-type')) {
+                headers.set('content-type', 'application/json');
+            }
+        }
+    }
+    return new Response(body, { status, statusText, headers });
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+// ═══════════════════════════════════════════════════════════════════
+// MANAGER IMPLEMENTATION
+// ═══════════════════════════════════════════════════════════════════
+class HttpMockManagerImpl {
+    interceptor() {
+        // Auto-enable mocking when creating an interceptor
+        if (!mockingEnabled) {
+            this.enable();
+        }
+        const interceptor = new HttpInterceptorImpl();
+        activeInterceptors.push(interceptor);
+        return interceptor;
+    }
+    enable() {
+        if (mockingEnabled)
+            return;
+        // Store original fetch
+        if (typeof globalThis.fetch === 'function') {
+            originalFetch = globalThis.fetch;
+            globalThis.fetch = interceptedFetch;
+        }
+        mockingEnabled = true;
+    }
+    disable() {
+        if (!mockingEnabled)
+            return;
+        // Restore original fetch
+        if (originalFetch) {
+            globalThis.fetch = originalFetch;
+            originalFetch = null;
+        }
+        // Clear all interceptors
+        activeInterceptors.length = 0;
+        mockingEnabled = false;
+    }
+    isEnabled() {
+        return mockingEnabled;
+    }
+    clearAll() {
+        for (const interceptor of activeInterceptors) {
+            interceptor.clear();
+        }
+        activeInterceptors.length = 0;
+    }
+}
+// ═══════════════════════════════════════════════════════════════════
+// EXPORTS
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * Global HTTP mock manager
+ *
+ * @example
+ * ```typescript
+ * import { httpMock } from '@frontmcp/testing';
+ *
+ * // Create an HTTP interceptor
+ * const interceptor = httpMock.interceptor();
+ *
+ * // Mock requests
+ * interceptor.get('https://api.example.com/data', { id: 1, name: 'Test' });
+ *
+ * // Run tests...
+ *
+ * // Clean up
+ * interceptor.restore();
+ * ```
+ */
+exports.httpMock = new HttpMockManagerImpl();
+/**
+ * Helper to create mock responses
+ */
+exports.httpResponse = {
+    /** Create a JSON response */
+    json(data, status = 200) {
+        return {
+            status,
+            headers: { 'content-type': 'application/json' },
+            body: data,
+        };
+    },
+    /** Create a text response */
+    text(data, status = 200) {
+        return {
+            status,
+            headers: { 'content-type': 'text/plain' },
+            body: data,
+        };
+    },
+    /** Create an HTML response */
+    html(data, status = 200) {
+        return {
+            status,
+            headers: { 'content-type': 'text/html' },
+            body: data,
+        };
+    },
+    /** Create an error response */
+    error(status, message) {
+        return {
+            status,
+            statusText: message ?? getStatusText(status),
+            body: message ? { error: message } : undefined,
+        };
+    },
+    /** Create a 404 Not Found response */
+    notFound(message = 'Not Found') {
+        return exports.httpResponse.error(404, message);
+    },
+    /** Create a 500 Internal Server Error response */
+    serverError(message = 'Internal Server Error') {
+        return exports.httpResponse.error(500, message);
+    },
+    /** Create a 401 Unauthorized response */
+    unauthorized(message = 'Unauthorized') {
+        return exports.httpResponse.error(401, message);
+    },
+    /** Create a 403 Forbidden response */
+    forbidden(message = 'Forbidden') {
+        return exports.httpResponse.error(403, message);
+    },
+    /**
+     * Create a network error that causes fetch to reject
+     * This simulates real network failures where fetch throws instead of returning a Response
+     */
+    networkError(message = 'Network error') {
+        return {
+            status: 0,
+            body: { _networkError: true, message },
+            // Mark this as a network error for the interceptor to throw
+            _throwError: true,
+        };
+    },
+    /** Create a delayed response */
+    delayed(data, delayMs, status = 200) {
+        return {
+            status,
+            body: data,
+            delay: delayMs,
+        };
+    },
+};
+function getStatusText(status) {
+    const texts = {
+        200: 'OK',
+        201: 'Created',
+        204: 'No Content',
+        400: 'Bad Request',
+        401: 'Unauthorized',
+        403: 'Forbidden',
+        404: 'Not Found',
+        500: 'Internal Server Error',
+        502: 'Bad Gateway',
+        503: 'Service Unavailable',
+    };
+    return texts[status] ?? 'Unknown';
+}
+//# sourceMappingURL=http-mock.js.map

package/src/http-mock/http-mock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-mock.js","sourceRoot":"","sources":["../../../src/http-mock/http-mock.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @file http-mock.ts\n * @description HTTP request mocking implementation for offline MCP server testing\n *\n * This module intercepts fetch() and XMLHttpRequest calls, allowing tools to be\n * tested without making real HTTP requests.\n *\n * @example\n * ```typescript\n * import { httpMock } from '@frontmcp/testing';\n *\n * // Enable HTTP mocking\n * const interceptor = httpMock.interceptor();\n *\n * // Mock a GET request\n * interceptor.get('https://api.example.com/users', {\n *   body: [{ id: 1, name: 'John' }],\n * });\n *\n * // Mock a POST request with pattern matching\n * interceptor.post(/api\\.example\\.com\\/users/, {\n *   status: 201,\n *   body: { id: 2, name: 'Jane' },\n * });\n *\n * // Now run your MCP server test - HTTP calls will be intercepted\n * const result = await mcp.tools.call('fetch-users', {});\n *\n * // Verify all mocks were used\n * interceptor.assertDone();\n *\n * // Restore original fetch\n * interceptor.restore();\n * ```\n */\n\nimport type {\n  HttpMethod,\n  HttpRequestMatcher,\n  HttpMockResponse,\n  HttpMockDefinition,\n  HttpRequestInfo,\n  HttpMockHandle,\n  HttpInterceptor,\n  HttpMockManager,\n} from './http-mock.types';\n\n// ═══════════════════════════════════════════════════════════════════\n// GLOBAL STATE\n// ═══════════════════════════════════════════════════════════════════\n\n/** Original fetch function */\nlet originalFetch: typeof globalThis.fetch | null = null;\n\n/** Whether mocking is enabled */\nlet mockingEnabled = false;\n\n/** All active interceptors */\nconst activeInterceptors: HttpInterceptorImpl[] = [];\n\n// ═══════════════════════════════════════════════════════════════════\n// HTTP INTERCEPTOR IMPLEMENTATION\n// ═══════════════════════════════════════════════════════════════════\n\ninterface MockEntry {\n  definition: HttpMockDefinition;\n  callCount: number;\n  calls: HttpRequestInfo[];\n  remainingUses: number;\n}\n\nclass HttpInterceptorImpl implements HttpInterceptor {\n  private mocks: MockEntry[] = [];\n  private _allowPassthrough = false;\n  private _isActive = true;\n\n  mock(definition: HttpMockDefinition): HttpMockHandle {\n    const entry: MockEntry = {\n      definition,\n      callCount: 0,\n      calls: [],\n      remainingUses: definition.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      waitForCalls: async (count: number, timeoutMs = 5000) => {\n        const deadline = Date.now() + timeoutMs;\n        while (Date.now() < deadline) {\n          if (entry.callCount >= count) {\n            return entry.calls.slice(0, count);\n          }\n          await sleep(50);\n        }\n        throw new Error(`Timeout waiting for ${count} calls, got ${entry.callCount}`);\n      },\n    };\n  }\n\n  get(url: string | RegExp, response: HttpMockResponse | Record<string, unknown>): HttpMockHandle {\n    return this.mock({\n      match: { url, method: 'GET' },\n      response: normalizeResponse(response),\n    });\n  }\n\n  post(url: string | RegExp, response: HttpMockResponse | Record<string, unknown>): HttpMockHandle {\n    return this.mock({\n      match: { url, method: 'POST' },\n      response: normalizeResponse(response),\n    });\n  }\n\n  put(url: string | RegExp, response: HttpMockResponse | Record<string, unknown>): HttpMockHandle {\n    return this.mock({\n      match: { url, method: 'PUT' },\n      response: normalizeResponse(response),\n    });\n  }\n\n  delete(url: string | RegExp, response: HttpMockResponse | Record<string, unknown>): HttpMockHandle {\n    return this.mock({\n      match: { url, method: 'DELETE' },\n      response: normalizeResponse(response),\n    });\n  }\n\n  any(url: string | RegExp, response: HttpMockResponse | Record<string, unknown>): HttpMockHandle {\n    return this.mock({\n      match: { url },\n      response: normalizeResponse(response),\n    });\n  }\n\n  clear(): void {\n    this.mocks = [];\n  }\n\n  pending(): HttpMockDefinition[] {\n    return this.mocks.filter((m) => m.remainingUses > 0).map((m) => m.definition);\n  }\n\n  isDone(): boolean {\n    return this.mocks.every((m) => m.remainingUses <= 0 || m.definition.times === undefined);\n  }\n\n  assertDone(): void {\n    const pending = this.pending().filter((m) => m.times !== undefined);\n    if (pending.length > 0) {\n      const descriptions = pending.map((m) => {\n        const url = m.match.url instanceof RegExp ? m.match.url.toString() : m.match.url;\n        return `  - ${m.match.method ?? 'ANY'} ${url}`;\n      });\n      throw new Error(`Unused HTTP mocks:\\n${descriptions.join('\\n')}`);\n    }\n  }\n\n  allowPassthrough(allow: boolean): void {\n    this._allowPassthrough = allow;\n  }\n\n  restore(): void {\n    this._isActive = false;\n    const index = activeInterceptors.indexOf(this);\n    if (index !== -1) {\n      activeInterceptors.splice(index, 1);\n    }\n  }\n\n  // Internal methods\n\n  isActive(): boolean {\n    return this._isActive;\n  }\n\n  canPassthrough(): boolean {\n    return this._allowPassthrough;\n  }\n\n  /**\n   * Try to match a request against mocks in this scope\n   */\n  async matchRequest(info: HttpRequestInfo): Promise<Response | null> {\n    if (!this._isActive) return null;\n\n    for (const entry of this.mocks) {\n      if (entry.remainingUses <= 0) continue;\n\n      if (this.requestMatches(info, entry.definition.match)) {\n        // Found a match\n        entry.callCount++;\n        entry.calls.push(info);\n        entry.remainingUses--;\n\n        // Get response\n        let mockResponse: HttpMockResponse;\n        if (typeof entry.definition.response === 'function') {\n          mockResponse = await entry.definition.response(info);\n        } else {\n          mockResponse = entry.definition.response;\n        }\n\n        // Apply delay\n        if (mockResponse.delay && mockResponse.delay > 0) {\n          await sleep(mockResponse.delay);\n        }\n\n        return createMockResponse(mockResponse);\n      }\n    }\n\n    return null;\n  }\n\n  private requestMatches(info: HttpRequestInfo, matcher: HttpRequestMatcher): boolean {\n    // Check URL\n    if (!this.urlMatches(info.url, matcher.url)) {\n      return false;\n    }\n\n    // Check method\n    if (matcher.method) {\n      const methods = Array.isArray(matcher.method) ? matcher.method : [matcher.method];\n      if (!methods.includes(info.method)) {\n        return false;\n      }\n    }\n\n    // Check headers\n    if (matcher.headers) {\n      for (const [key, expected] of Object.entries(matcher.headers)) {\n        const actual = info.headers[key.toLowerCase()];\n        if (!actual) return false;\n        if (expected instanceof RegExp) {\n          if (!expected.test(actual)) return false;\n        } else if (actual !== expected) {\n          return false;\n        }\n      }\n    }\n\n    // Check body\n    if (matcher.body !== undefined) {\n      if (!this.bodyMatches(info.body, matcher.body)) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n\n  private urlMatches(url: string, matcher: string | RegExp | ((url: string) => boolean)): boolean {\n    if (typeof matcher === 'string') {\n      // Exact match or contains\n      return url === matcher || url.includes(matcher);\n    } else if (matcher instanceof RegExp) {\n      return matcher.test(url);\n    } else {\n      return matcher(url);\n    }\n  }\n\n  private bodyMatches(\n    actual: unknown,\n    expected: string | RegExp | Record<string, unknown> | ((body: unknown) => boolean),\n  ): boolean {\n    if (typeof expected === 'function') {\n      return expected(actual);\n    }\n\n    if (typeof expected === 'string') {\n      const actualStr = typeof actual === 'string' ? actual : JSON.stringify(actual);\n      return actualStr === expected || actualStr.includes(expected);\n    }\n\n    if (expected instanceof RegExp) {\n      const actualStr = typeof actual === 'string' ? actual : JSON.stringify(actual);\n      return expected.test(actualStr);\n    }\n\n    // Object comparison - check that all expected keys match\n    if (typeof actual !== 'object' || actual === null) {\n      return false;\n    }\n\n    for (const [key, value] of Object.entries(expected)) {\n      const actualValue = (actual as Record<string, unknown>)[key];\n      if (typeof value === 'object' && value !== null) {\n        if (!this.bodyMatches(actualValue, value 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// FETCH INTERCEPTOR\n// ═══════════════════════════════════════════════════════════════════\n\nasync function interceptedFetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response> {\n  // Build request info\n  const url = typeof input === 'string' ? input : input instanceof URL ? input.toString() : input.url;\n  const method = ((init?.method ?? 'GET') as HttpMethod).toUpperCase() as HttpMethod;\n\n  // Parse headers\n  const headers: Record<string, string> = {};\n  if (init?.headers) {\n    if (init.headers instanceof Headers) {\n      init.headers.forEach((value, key) => {\n        headers[key.toLowerCase()] = value;\n      });\n    } else if (Array.isArray(init.headers)) {\n      for (const [key, value] of init.headers) {\n        headers[key.toLowerCase()] = value;\n      }\n    } else {\n      for (const [key, value] of Object.entries(init.headers)) {\n        headers[key.toLowerCase()] = value;\n      }\n    }\n  }\n\n  // Parse body\n  let body: unknown;\n  let rawBody: string | undefined;\n  if (init?.body) {\n    if (typeof init.body === 'string') {\n      rawBody = init.body;\n      try {\n        body = JSON.parse(init.body);\n      } catch {\n        body = init.body;\n      }\n    } else if (init.body instanceof ArrayBuffer || init.body instanceof Uint8Array) {\n      rawBody = new TextDecoder().decode(init.body);\n      try {\n        body = JSON.parse(rawBody);\n      } catch {\n        body = rawBody;\n      }\n    } else {\n      body = init.body;\n    }\n  }\n\n  const requestInfo: HttpRequestInfo = {\n    url,\n    method,\n    headers,\n    body,\n    rawBody,\n  };\n\n  // Try to match against active interceptors (in reverse order - last added first)\n  for (let i = activeInterceptors.length - 1; i >= 0; i--) {\n    const interceptor = activeInterceptors[i];\n    if (!interceptor.isActive()) continue;\n\n    const mockResponse = await interceptor.matchRequest(requestInfo);\n    if (mockResponse) {\n      return mockResponse;\n    }\n  }\n\n  // No match found - check if passthrough is allowed\n  for (const interceptor of activeInterceptors) {\n    if (interceptor.isActive() && interceptor.canPassthrough()) {\n      // Passthrough to real fetch\n      if (originalFetch) {\n        return originalFetch(input, init);\n      }\n    }\n  }\n\n  // No match and no passthrough - throw error\n  throw new Error(\n    `No HTTP mock found for ${method} ${url}\\n` +\n      `Add a mock using httpMock.interceptor().${method.toLowerCase()}('${url}', { body: ... })`,\n  );\n}\n\n// ═══════════════════════════════════════════════════════════════════\n// HELPERS\n// ═══════════════════════════════════════════════════════════════════\n\nfunction normalizeResponse(response: HttpMockResponse | Record<string, unknown>): HttpMockResponse {\n  // If it looks like a plain object (response body), wrap it\n  if (!('status' in response) && !('body' in response) && !('headers' in response)) {\n    return { body: response as Record<string, unknown> };\n  }\n  return response as HttpMockResponse;\n}\n\nfunction createMockResponse(mock: HttpMockResponse): Response {\n  // Check for network error - throw instead of returning Response\n  // This simulates real network failures where fetch rejects\n  const mockAny = mock as HttpMockResponse & { _throwError?: boolean };\n  if (mockAny._throwError) {\n    const body = mock.body as Record<string, unknown> | undefined;\n    const message = body && typeof body === 'object' && 'message' in body ? String(body['message']) : 'Network error';\n    throw new TypeError(`fetch failed: ${message}`);\n  }\n\n  const status = mock.status ?? 200;\n  const statusText = mock.statusText ?? 'OK';\n\n  // Build headers\n  const headers = new Headers(mock.headers ?? {});\n\n  // Build body\n  let body: BodyInit | null = null;\n  if (mock.body !== undefined) {\n    if (typeof mock.body === 'string') {\n      body = mock.body;\n      if (!headers.has('content-type')) {\n        headers.set('content-type', 'text/plain');\n      }\n    } else if (mock.body instanceof ArrayBuffer) {\n      body = mock.body;\n    } else if (Buffer.isBuffer(mock.body)) {\n      // Convert Buffer to ArrayBuffer for Response compatibility\n      body = new Uint8Array(mock.body).buffer;\n    } else {\n      body = JSON.stringify(mock.body);\n      if (!headers.has('content-type')) {\n        headers.set('content-type', 'application/json');\n      }\n    }\n  }\n\n  return new Response(body, { status, statusText, headers });\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n// ═══════════════════════════════════════════════════════════════════\n// MANAGER IMPLEMENTATION\n// ═══════════════════════════════════════════════════════════════════\n\nclass HttpMockManagerImpl implements HttpMockManager {\n  interceptor(): HttpInterceptor {\n    // Auto-enable mocking when creating an interceptor\n    if (!mockingEnabled) {\n      this.enable();\n    }\n\n    const interceptor = new HttpInterceptorImpl();\n    activeInterceptors.push(interceptor);\n    return interceptor;\n  }\n\n  enable(): void {\n    if (mockingEnabled) return;\n\n    // Store original fetch\n    if (typeof globalThis.fetch === 'function') {\n      originalFetch = globalThis.fetch;\n      globalThis.fetch = interceptedFetch;\n    }\n\n    mockingEnabled = true;\n  }\n\n  disable(): void {\n    if (!mockingEnabled) return;\n\n    // Restore original fetch\n    if (originalFetch) {\n      globalThis.fetch = originalFetch;\n      originalFetch = null;\n    }\n\n    // Clear all interceptors\n    activeInterceptors.length = 0;\n    mockingEnabled = false;\n  }\n\n  isEnabled(): boolean {\n    return mockingEnabled;\n  }\n\n  clearAll(): void {\n    for (const interceptor of activeInterceptors) {\n      interceptor.clear();\n    }\n    activeInterceptors.length = 0;\n  }\n}\n\n// ═══════════════════════════════════════════════════════════════════\n// EXPORTS\n// ═══════════════════════════════════════════════════════════════════\n\n/**\n * Global HTTP mock manager\n *\n * @example\n * ```typescript\n * import { httpMock } from '@frontmcp/testing';\n *\n * // Create an HTTP interceptor\n * const interceptor = httpMock.interceptor();\n *\n * // Mock requests\n * interceptor.get('https://api.example.com/data', { id: 1, name: 'Test' });\n *\n * // Run tests...\n *\n * // Clean up\n * interceptor.restore();\n * ```\n */\nexport const httpMock: HttpMockManager = new HttpMockManagerImpl();\n\n/**\n * Helper to create mock responses\n */\nexport const httpResponse = {\n  /** Create a JSON response */\n  json<T>(data: T, status = 200): HttpMockResponse {\n    return {\n      status,\n      headers: { 'content-type': 'application/json' },\n      body: data as Record<string, unknown>,\n    };\n  },\n\n  /** Create a text response */\n  text(data: string, status = 200): HttpMockResponse {\n    return {\n      status,\n      headers: { 'content-type': 'text/plain' },\n      body: data,\n    };\n  },\n\n  /** Create an HTML response */\n  html(data: string, status = 200): HttpMockResponse {\n    return {\n      status,\n      headers: { 'content-type': 'text/html' },\n      body: data,\n    };\n  },\n\n  /** Create an error response */\n  error(status: number, message?: string): HttpMockResponse {\n    return {\n      status,\n      statusText: message ?? getStatusText(status),\n      body: message ? { error: message } : undefined,\n    };\n  },\n\n  /** Create a 404 Not Found response */\n  notFound(message = 'Not Found'): HttpMockResponse {\n    return httpResponse.error(404, message);\n  },\n\n  /** Create a 500 Internal Server Error response */\n  serverError(message = 'Internal Server Error'): HttpMockResponse {\n    return httpResponse.error(500, message);\n  },\n\n  /** Create a 401 Unauthorized response */\n  unauthorized(message = 'Unauthorized'): HttpMockResponse {\n    return httpResponse.error(401, message);\n  },\n\n  /** Create a 403 Forbidden response */\n  forbidden(message = 'Forbidden'): HttpMockResponse {\n    return httpResponse.error(403, message);\n  },\n\n  /**\n   * Create a network error that causes fetch to reject\n   * This simulates real network failures where fetch throws instead of returning a Response\n   */\n  networkError(message = 'Network error'): HttpMockResponse {\n    return {\n      status: 0,\n      body: { _networkError: true, message },\n      // Mark this as a network error for the interceptor to throw\n      _throwError: true,\n    } as HttpMockResponse;\n  },\n\n  /** Create a delayed response */\n  delayed<T>(data: T, delayMs: number, status = 200): HttpMockResponse {\n    return {\n      status,\n      body: data as Record<string, unknown>,\n      delay: delayMs,\n    };\n  },\n};\n\nfunction getStatusText(status: number): string {\n  const texts: Record<number, string> = {\n    200: 'OK',\n    201: 'Created',\n    204: 'No Content',\n    400: 'Bad Request',\n    401: 'Unauthorized',\n    403: 'Forbidden',\n    404: 'Not Found',\n    500: 'Internal Server Error',\n    502: 'Bad Gateway',\n    503: 'Service Unavailable',\n  };\n  return texts[status] ?? 'Unknown';\n}\n"]}