@frontmcp/testing 0.5.0

package/src/interceptor/interceptor-chain.js

@@ -0,0 +1,207 @@
+"use strict";
+/**
+ * @file interceptor-chain.ts
+ * @description Interceptor chain for request/response interception
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.interceptors = exports.DefaultInterceptorChain = void 0;
+const mock_registry_1 = require("./mock-registry");
+/**
+ * Default implementation of InterceptorChain
+ */
+class DefaultInterceptorChain {
+    request = [];
+    response = [];
+    mocks;
+    constructor() {
+        this.mocks = new mock_registry_1.DefaultMockRegistry();
+    }
+    /**
+     * Add a request interceptor
+     */
+    addRequestInterceptor(interceptor) {
+        this.request.push(interceptor);
+        return () => {
+            const index = this.request.indexOf(interceptor);
+            if (index !== -1) {
+                this.request.splice(index, 1);
+            }
+        };
+    }
+    /**
+     * Add a response interceptor
+     */
+    addResponseInterceptor(interceptor) {
+        this.response.push(interceptor);
+        return () => {
+            const index = this.response.indexOf(interceptor);
+            if (index !== -1) {
+                this.response.splice(index, 1);
+            }
+        };
+    }
+    /**
+     * Process a request through the interceptor chain
+     * Returns either:
+     * - { type: 'continue', request } - continue with (possibly modified) request
+     * - { type: 'mock', response } - return mock response immediately
+     * - { type: 'error', error } - throw error
+     */
+    async processRequest(request, meta) {
+        let currentRequest = request;
+        // 1. Check mocks first
+        const mockDef = this.mocks.match(request);
+        if (mockDef) {
+            // Apply delay if specified
+            if (mockDef.delay && mockDef.delay > 0) {
+                await sleep(mockDef.delay);
+            }
+            // Get mock response
+            let mockResponse;
+            if (typeof mockDef.response === 'function') {
+                mockResponse = await mockDef.response(request);
+            }
+            else {
+                mockResponse = mockDef.response;
+            }
+            // Ensure the response ID matches the request ID
+            return {
+                type: 'mock',
+                response: { ...mockResponse, id: request.id ?? mockResponse.id },
+            };
+        }
+        // 2. Run request interceptors
+        for (const interceptor of this.request) {
+            const ctx = {
+                request: currentRequest,
+                meta,
+            };
+            const result = await interceptor(ctx);
+            switch (result.action) {
+                case 'passthrough':
+                    // Continue with current request
+                    break;
+                case 'modify':
+                    // Use modified request
+                    currentRequest = result.request;
+                    break;
+                case 'mock':
+                    // Return mock response immediately
+                    return {
+                        type: 'mock',
+                        response: { ...result.response, id: request.id ?? result.response.id },
+                    };
+                case 'error':
+                    return { type: 'error', error: result.error };
+            }
+        }
+        return { type: 'continue', request: currentRequest };
+    }
+    /**
+     * Process a response through the interceptor chain
+     */
+    async processResponse(request, response, durationMs) {
+        let currentResponse = response;
+        for (const interceptor of this.response) {
+            const ctx = {
+                request,
+                response: currentResponse,
+                durationMs,
+            };
+            const result = await interceptor(ctx);
+            switch (result.action) {
+                case 'passthrough':
+                    // Continue with current response
+                    break;
+                case 'modify':
+                    // Use modified response
+                    currentResponse = result.response;
+                    break;
+            }
+        }
+        return currentResponse;
+    }
+    /**
+     * Clear all interceptors and mocks
+     */
+    clear() {
+        this.request = [];
+        this.response = [];
+        this.mocks.clear();
+    }
+}
+exports.DefaultInterceptorChain = DefaultInterceptorChain;
+/**
+ * Sleep helper
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Convenience interceptor creators
+ */
+exports.interceptors = {
+    /**
+     * Create an interceptor that logs all requests
+     */
+    logger(logFn = console.log) {
+        return (ctx) => {
+            logFn(`[MCP Request] ${ctx.request.method}`, ctx.request.params);
+            return { action: 'passthrough' };
+        };
+    },
+    /**
+     * Create an interceptor that adds latency to all requests
+     */
+    delay(ms) {
+        return async () => {
+            await sleep(ms);
+            return { action: 'passthrough' };
+        };
+    },
+    /**
+     * Create an interceptor that fails requests matching a condition
+     */
+    failWhen(condition, error) {
+        return (ctx) => {
+            if (condition(ctx)) {
+                const err = typeof error === 'string' ? new Error(error) : error;
+                return { action: 'error', error: err };
+            }
+            return { action: 'passthrough' };
+        };
+    },
+    /**
+     * Create an interceptor that modifies specific methods
+     */
+    modifyMethod(method, modifier) {
+        return (ctx) => {
+            if (ctx.request.method === method) {
+                return { action: 'modify', request: modifier(ctx.request) };
+            }
+            return { action: 'passthrough' };
+        };
+    },
+    /**
+     * Create a response interceptor that logs responses
+     */
+    responseLogger(logFn = console.log) {
+        return (ctx) => {
+            const status = ctx.response.error ? 'ERROR' : 'OK';
+            logFn(`[MCP Response] ${ctx.request.method} ${status} (${ctx.durationMs}ms)`, ctx.response);
+            return { action: 'passthrough' };
+        };
+    },
+    /**
+     * Create a response interceptor that modifies specific responses
+     */
+    modifyResponse(method, modifier) {
+        return (ctx) => {
+            if (ctx.request.method === method) {
+                return { action: 'modify', response: modifier(ctx.response) };
+            }
+            return { action: 'passthrough' };
+        };
+    },
+};
+//# sourceMappingURL=interceptor-chain.js.map

package/src/interceptor/interceptor-chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interceptor-chain.js","sourceRoot":"","sources":["../../../src/interceptor/interceptor-chain.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @file interceptor-chain.ts\n * @description Interceptor chain for request/response interception\n */\n\nimport type { JsonRpcRequest, JsonRpcResponse } from '../transport/transport.interface';\nimport type {\n  InterceptorChain,\n  RequestInterceptor,\n  ResponseInterceptor,\n  InterceptorContext,\n  InterceptorResult,\n  ResponseInterceptorContext,\n  ResponseInterceptorResult,\n  MockRegistry,\n} from './interceptor.types';\nimport { DefaultMockRegistry } from './mock-registry';\n\n/**\n * Default implementation of InterceptorChain\n */\nexport class DefaultInterceptorChain implements InterceptorChain {\n  request: RequestInterceptor[] = [];\n  response: ResponseInterceptor[] = [];\n  mocks: MockRegistry;\n\n  constructor() {\n    this.mocks = new DefaultMockRegistry();\n  }\n\n  /**\n   * Add a request interceptor\n   */\n  addRequestInterceptor(interceptor: RequestInterceptor): () => void {\n    this.request.push(interceptor);\n    return () => {\n      const index = this.request.indexOf(interceptor);\n      if (index !== -1) {\n        this.request.splice(index, 1);\n      }\n    };\n  }\n\n  /**\n   * Add a response interceptor\n   */\n  addResponseInterceptor(interceptor: ResponseInterceptor): () => void {\n    this.response.push(interceptor);\n    return () => {\n      const index = this.response.indexOf(interceptor);\n      if (index !== -1) {\n        this.response.splice(index, 1);\n      }\n    };\n  }\n\n  /**\n   * Process a request through the interceptor chain\n   * Returns either:\n   * - { type: 'continue', request } - continue with (possibly modified) request\n   * - { type: 'mock', response } - return mock response immediately\n   * - { type: 'error', error } - throw error\n   */\n  async processRequest(\n    request: JsonRpcRequest,\n    meta: InterceptorContext['meta'],\n  ): Promise<\n    | { type: 'continue'; request: JsonRpcRequest }\n    | { type: 'mock'; response: JsonRpcResponse }\n    | { type: 'error'; error: Error }\n  > {\n    let currentRequest = request;\n\n    // 1. Check mocks first\n    const mockDef = this.mocks.match(request);\n    if (mockDef) {\n      // Apply delay if specified\n      if (mockDef.delay && mockDef.delay > 0) {\n        await sleep(mockDef.delay);\n      }\n\n      // Get mock response\n      let mockResponse: JsonRpcResponse;\n      if (typeof mockDef.response === 'function') {\n        mockResponse = await mockDef.response(request);\n      } else {\n        mockResponse = mockDef.response;\n      }\n\n      // Ensure the response ID matches the request ID\n      return {\n        type: 'mock',\n        response: { ...mockResponse, id: request.id ?? mockResponse.id },\n      };\n    }\n\n    // 2. Run request interceptors\n    for (const interceptor of this.request) {\n      const ctx: InterceptorContext = {\n        request: currentRequest,\n        meta,\n      };\n\n      const result = await interceptor(ctx);\n\n      switch (result.action) {\n        case 'passthrough':\n          // Continue with current request\n          break;\n        case 'modify':\n          // Use modified request\n          currentRequest = result.request;\n          break;\n        case 'mock':\n          // Return mock response immediately\n          return {\n            type: 'mock',\n            response: { ...result.response, id: request.id ?? result.response.id },\n          };\n        case 'error':\n          return { type: 'error', error: result.error };\n      }\n    }\n\n    return { type: 'continue', request: currentRequest };\n  }\n\n  /**\n   * Process a response through the interceptor chain\n   */\n  async processResponse(\n    request: JsonRpcRequest,\n    response: JsonRpcResponse,\n    durationMs: number,\n  ): Promise<JsonRpcResponse> {\n    let currentResponse = response;\n\n    for (const interceptor of this.response) {\n      const ctx: ResponseInterceptorContext = {\n        request,\n        response: currentResponse,\n        durationMs,\n      };\n\n      const result = await interceptor(ctx);\n\n      switch (result.action) {\n        case 'passthrough':\n          // Continue with current response\n          break;\n        case 'modify':\n          // Use modified response\n          currentResponse = result.response;\n          break;\n      }\n    }\n\n    return currentResponse;\n  }\n\n  /**\n   * Clear all interceptors and mocks\n   */\n  clear(): void {\n    this.request = [];\n    this.response = [];\n    this.mocks.clear();\n  }\n}\n\n/**\n * Sleep helper\n */\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n/**\n * Convenience interceptor creators\n */\nexport const interceptors = {\n  /**\n   * Create an interceptor that logs all requests\n   */\n  logger(logFn: (message: string, data?: unknown) => void = console.log): RequestInterceptor {\n    return (ctx) => {\n      logFn(`[MCP Request] ${ctx.request.method}`, ctx.request.params);\n      return { action: 'passthrough' };\n    };\n  },\n\n  /**\n   * Create an interceptor that adds latency to all requests\n   */\n  delay(ms: number): RequestInterceptor {\n    return async () => {\n      await sleep(ms);\n      return { action: 'passthrough' };\n    };\n  },\n\n  /**\n   * Create an interceptor that fails requests matching a condition\n   */\n  failWhen(condition: (ctx: InterceptorContext) => boolean, error: Error | string): RequestInterceptor {\n    return (ctx) => {\n      if (condition(ctx)) {\n        const err = typeof error === 'string' ? new Error(error) : error;\n        return { action: 'error', error: err };\n      }\n      return { action: 'passthrough' };\n    };\n  },\n\n  /**\n   * Create an interceptor that modifies specific methods\n   */\n  modifyMethod(method: string, modifier: (request: JsonRpcRequest) => JsonRpcRequest): RequestInterceptor {\n    return (ctx) => {\n      if (ctx.request.method === method) {\n        return { action: 'modify', request: modifier(ctx.request) };\n      }\n      return { action: 'passthrough' };\n    };\n  },\n\n  /**\n   * Create a response interceptor that logs responses\n   */\n  responseLogger(logFn: (message: string, data?: unknown) => void = console.log): ResponseInterceptor {\n    return (ctx) => {\n      const status = ctx.response.error ? 'ERROR' : 'OK';\n      logFn(`[MCP Response] ${ctx.request.method} ${status} (${ctx.durationMs}ms)`, ctx.response);\n      return { action: 'passthrough' };\n    };\n  },\n\n  /**\n   * Create a response interceptor that modifies specific responses\n   */\n  modifyResponse(method: string, modifier: (response: JsonRpcResponse) => JsonRpcResponse): ResponseInterceptor {\n    return (ctx) => {\n      if (ctx.request.method === method) {\n        return { action: 'modify', response: modifier(ctx.response) };\n      }\n      return { action: 'passthrough' };\n    };\n  },\n};\n"]}

package/src/interceptor/interceptor.types.d.ts

@@ -0,0 +1,131 @@
+/**
+ * @file interceptor.types.ts
+ * @description Types for request/response interception and mocking
+ */
+import type { JsonRpcRequest, JsonRpcResponse } from '../transport/transport.interface';
+/**
+ * Interceptor context passed to handler functions
+ */
+export interface InterceptorContext {
+    /** The original request */
+    request: JsonRpcRequest;
+    /** Request metadata */
+    meta: {
+        /** Timestamp when request was made */
+        timestamp: Date;
+        /** Transport type being used */
+        transport: string;
+        /** Session ID if available */
+        sessionId?: string;
+    };
+}
+/**
+ * Result of an interceptor - can modify, mock, or pass through
+ */
+export type InterceptorResult = {
+    action: 'passthrough';
+} | {
+    action: 'modify';
+    request: JsonRpcRequest;
+} | {
+    action: 'mock';
+    response: JsonRpcResponse;
+} | {
+    action: 'error';
+    error: Error;
+};
+/**
+ * Function signature for request interceptors
+ */
+export type RequestInterceptor = (ctx: InterceptorContext) => InterceptorResult | Promise<InterceptorResult>;
+/**
+ * Response interceptor context
+ */
+export interface ResponseInterceptorContext {
+    /** The original request */
+    request: JsonRpcRequest;
+    /** The response from the server */
+    response: JsonRpcResponse;
+    /** Duration of the request in ms */
+    durationMs: number;
+}
+/**
+ * Response interceptor result
+ */
+export type ResponseInterceptorResult = {
+    action: 'passthrough';
+} | {
+    action: 'modify';
+    response: JsonRpcResponse;
+};
+/**
+ * Function signature for response interceptors
+ */
+export type ResponseInterceptor = (ctx: ResponseInterceptorContext) => ResponseInterceptorResult | Promise<ResponseInterceptorResult>;
+/**
+ * Mock definition for a specific method
+ */
+export interface MockDefinition {
+    /** Method name to mock (e.g., 'tools/call', 'resources/read') */
+    method: string;
+    /** Optional matcher for params - if provided, only matches when params match */
+    params?: Record<string, unknown> | ((params: Record<string, unknown>) => boolean);
+    /** The mock response to return */
+    response: JsonRpcResponse | ((request: JsonRpcRequest) => JsonRpcResponse | Promise<JsonRpcResponse>);
+    /** Number of times this mock should be used (default: Infinity) */
+    times?: number;
+    /** Delay in ms before returning the response (simulates latency) */
+    delay?: number;
+}
+/**
+ * Mock registry for managing active mocks
+ */
+export interface MockRegistry {
+    /** Add a mock */
+    add(mock: MockDefinition): MockHandle;
+    /** Remove all mocks */
+    clear(): void;
+    /** Get all active mocks */
+    getAll(): MockDefinition[];
+    /** Check if a request matches any mock */
+    match(request: JsonRpcRequest): MockDefinition | undefined;
+}
+/**
+ * Handle returned when adding a mock - allows removal
+ */
+export interface MockHandle {
+    /** Remove this specific mock */
+    remove(): void;
+    /** Check how many times this mock was called */
+    callCount(): number;
+    /** Get all calls made to this mock */
+    calls(): JsonRpcRequest[];
+}
+/**
+ * Interceptor chain configuration
+ */
+export interface InterceptorChain {
+    /** Request interceptors (run before request) */
+    request: RequestInterceptor[];
+    /** Response interceptors (run after response) */
+    response: ResponseInterceptor[];
+    /** Mock registry */
+    mocks: MockRegistry;
+    /**
+     * Process a request through the interceptor chain
+     */
+    processRequest(request: JsonRpcRequest, meta: InterceptorContext['meta']): Promise<{
+        type: 'continue';
+        request: JsonRpcRequest;
+    } | {
+        type: 'mock';
+        response: JsonRpcResponse;
+    } | {
+        type: 'error';
+        error: Error;
+    }>;
+    /**
+     * Process a response through the interceptor chain
+     */
+    processResponse(request: JsonRpcRequest, response: JsonRpcResponse, durationMs: number): Promise<JsonRpcResponse>;
+}

package/src/interceptor/interceptor.types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * @file interceptor.types.ts
+ * @description Types for request/response interception and mocking
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=interceptor.types.js.map

package/src/interceptor/interceptor.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interceptor.types.js","sourceRoot":"","sources":["../../../src/interceptor/interceptor.types.ts"],"names":[],"mappings":";AAAA;;;GAGG","sourcesContent":["/**\n * @file interceptor.types.ts\n * @description Types for request/response interception and mocking\n */\n\nimport type { JsonRpcRequest, JsonRpcResponse } from '../transport/transport.interface';\n\n/**\n * Interceptor context passed to handler functions\n */\nexport interface InterceptorContext {\n  /** The original request */\n  request: JsonRpcRequest;\n  /** Request metadata */\n  meta: {\n    /** Timestamp when request was made */\n    timestamp: Date;\n    /** Transport type being used */\n    transport: string;\n    /** Session ID if available */\n    sessionId?: string;\n  };\n}\n\n/**\n * Result of an interceptor - can modify, mock, or pass through\n */\nexport type InterceptorResult =\n  | { action: 'passthrough' }\n  | { action: 'modify'; request: JsonRpcRequest }\n  | { action: 'mock'; response: JsonRpcResponse }\n  | { action: 'error'; error: Error };\n\n/**\n * Function signature for request interceptors\n */\nexport type RequestInterceptor = (ctx: InterceptorContext) => InterceptorResult | Promise<InterceptorResult>;\n\n/**\n * Response interceptor context\n */\nexport interface ResponseInterceptorContext {\n  /** The original request */\n  request: JsonRpcRequest;\n  /** The response from the server */\n  response: JsonRpcResponse;\n  /** Duration of the request in ms */\n  durationMs: number;\n}\n\n/**\n * Response interceptor result\n */\nexport type ResponseInterceptorResult = { action: 'passthrough' } | { action: 'modify'; response: JsonRpcResponse };\n\n/**\n * Function signature for response interceptors\n */\nexport type ResponseInterceptor = (\n  ctx: ResponseInterceptorContext,\n) => ResponseInterceptorResult | Promise<ResponseInterceptorResult>;\n\n/**\n * Mock definition for a specific method\n */\nexport interface MockDefinition {\n  /** Method name to mock (e.g., 'tools/call', 'resources/read') */\n  method: string;\n  /** Optional matcher for params - if provided, only matches when params match */\n  params?: Record<string, unknown> | ((params: Record<string, unknown>) => boolean);\n  /** The mock response to return */\n  response: JsonRpcResponse | ((request: JsonRpcRequest) => JsonRpcResponse | Promise<JsonRpcResponse>);\n  /** Number of times this mock should be used (default: Infinity) */\n  times?: number;\n  /** Delay in ms before returning the response (simulates latency) */\n  delay?: number;\n}\n\n/**\n * Mock registry for managing active mocks\n */\nexport interface MockRegistry {\n  /** Add a mock */\n  add(mock: MockDefinition): MockHandle;\n  /** Remove all mocks */\n  clear(): void;\n  /** Get all active mocks */\n  getAll(): MockDefinition[];\n  /** Check if a request matches any mock */\n  match(request: JsonRpcRequest): MockDefinition | undefined;\n}\n\n/**\n * Handle returned when adding a mock - allows removal\n */\nexport interface MockHandle {\n  /** Remove this specific mock */\n  remove(): void;\n  /** Check how many times this mock was called */\n  callCount(): number;\n  /** Get all calls made to this mock */\n  calls(): JsonRpcRequest[];\n}\n\n/**\n * Interceptor chain configuration\n */\nexport interface InterceptorChain {\n  /** Request interceptors (run before request) */\n  request: RequestInterceptor[];\n  /** Response interceptors (run after response) */\n  response: ResponseInterceptor[];\n  /** Mock registry */\n  mocks: MockRegistry;\n\n  /**\n   * Process a request through the interceptor chain\n   */\n  processRequest(\n    request: JsonRpcRequest,\n    meta: InterceptorContext['meta'],\n  ): Promise<\n    | { type: 'continue'; request: JsonRpcRequest }\n    | { type: 'mock'; response: JsonRpcResponse }\n    | { type: 'error'; error: Error }\n  >;\n\n  /**\n   * Process a response through the interceptor chain\n   */\n  processResponse(request: JsonRpcRequest, response: JsonRpcResponse, durationMs: number): Promise<JsonRpcResponse>;\n}\n"]}

package/src/interceptor/mock-registry.d.ts

@@ -0,0 +1,82 @@
+/**
+ * @file mock-registry.ts
+ * @description Registry for managing request mocks
+ */
+import type { JsonRpcRequest, JsonRpcResponse } from '../transport/transport.interface';
+import type { MockDefinition, MockRegistry, MockHandle } from './interceptor.types';
+/**
+ * Default implementation of MockRegistry
+ */
+export declare class DefaultMockRegistry implements MockRegistry {
+    private mocks;
+    add(mock: MockDefinition): MockHandle;
+    clear(): void;
+    getAll(): MockDefinition[];
+    match(request: JsonRpcRequest): MockDefinition | undefined;
+    /**
+     * Check if request params match the mock params definition
+     */
+    private paramsMatch;
+}
+/**
+ * Helper to create mock responses
+ */
+export declare const mockResponse: {
+    /**
+     * Create a successful JSON-RPC response
+     */
+    success<T>(result: T, id?: string | number): JsonRpcResponse;
+    /**
+     * Create an error JSON-RPC response
+     */
+    error(code: number, message: string, data?: unknown, id?: string | number | null): JsonRpcResponse;
+    /**
+     * Create a tool result response
+     */
+    toolResult(content: Array<{
+        type: "text";
+        text: string;
+    } | {
+        type: "image";
+        data: string;
+        mimeType: string;
+    }>, id?: string | number): JsonRpcResponse;
+    /**
+     * Create a tools/list response
+     */
+    toolsList(tools: Array<{
+        name: string;
+        description?: string;
+        inputSchema?: Record<string, unknown>;
+    }>, id?: string | number): JsonRpcResponse;
+    /**
+     * Create a resources/list response
+     */
+    resourcesList(resources: Array<{
+        uri: string;
+        name?: string;
+        description?: string;
+        mimeType?: string;
+    }>, id?: string | number): JsonRpcResponse;
+    /**
+     * Create a resources/read response
+     */
+    resourceRead(contents: Array<{
+        uri: string;
+        text?: string;
+        blob?: string;
+        mimeType?: string;
+    }>, id?: string | number): JsonRpcResponse;
+    /**
+     * Common MCP errors
+     */
+    errors: {
+        methodNotFound: (method: string, id?: string | number | null) => JsonRpcResponse;
+        invalidParams: (message: string, id?: string | number | null) => JsonRpcResponse;
+        internalError: (message: string, id?: string | number | null) => JsonRpcResponse;
+        resourceNotFound: (uri: string, id?: string | number | null) => JsonRpcResponse;
+        toolNotFound: (name: string, id?: string | number | null) => JsonRpcResponse;
+        unauthorized: (id?: string | number | null) => JsonRpcResponse;
+        forbidden: (id?: string | number | null) => JsonRpcResponse;
+    };
+};

package/src/interceptor/mock-registry.js

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

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

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