@slbdn/mcp-tester 1.0.2 → 1.1.0

package/dist/utils/errors.js

@@ -1,4 +1,26 @@
+/**
+ * Error classes for MCPClient operations.
+ *
+ * All errors include a descriptive message, error code, and proper stack trace.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await client.callTool({ name: 'invalid-tool', arguments: {} });
+ * } catch (error) {
+ *   if (error instanceof MCPServerError) {
+ *     console.error(`Server error: ${error.message}`);
+ *   } else if (error instanceof MCPTimeoutError) {
+ *     console.error(`Timeout after ${error.timeout}ms`);
+ *   }
+ * }
+ * ```
+ */
+/**
+ * Base error class for all MCP client errors.
+ */
 export class MCPClientError extends Error {
+    /** Error code for programmatic error handling. */
     code;
     constructor(message, code = 'MCP_CLIENT_ERROR') {
         super(message);
@@ -7,7 +29,11 @@ export class MCPClientError extends Error {
         Error.captureStackTrace(this, MCPClientError);
     }
 }
+/**
+ * Error thrown when a request times out.
+ */
 export class MCPTimeoutError extends MCPClientError {
+    /** The timeout value in milliseconds. */
     timeout;
     constructor(message, timeout) {
         super(message, 'MCP_TIMEOUT_ERROR');
@@ -16,6 +42,9 @@ export class MCPTimeoutError extends MCPClientError {
         Error.captureStackTrace(this, MCPTimeoutError);
     }
 }
+/**
+ * Error thrown when the client fails to connect to the MCP server.
+ */
 export class MCPConnectionError extends MCPClientError {
     constructor(message) {
         super(message, 'MCP_CONNECTION_ERROR');
@@ -23,6 +52,9 @@ export class MCPConnectionError extends MCPClientError {
         Error.captureStackTrace(this, MCPConnectionError);
     }
 }
+/**
+ * Error thrown when a client method is called before start().
+ */
 export class MCPNotStartedError extends MCPClientError {
     constructor() {
         super('Client not started. Call start() before using client methods.', 'MCP_NOT_STARTED');
@@ -30,6 +62,9 @@ export class MCPNotStartedError extends MCPClientError {
         Error.captureStackTrace(this, MCPNotStartedError);
     }
 }
+/**
+ * Error thrown when start() is called on an already-started client.
+ */
 export class MCPAlreadyStartedError extends MCPClientError {
     constructor() {
         super('Client already started. Call stop() before starting again.', 'MCP_ALREADY_STARTED');
@@ -37,6 +72,9 @@ export class MCPAlreadyStartedError extends MCPClientError {
         Error.captureStackTrace(this, MCPAlreadyStartedError);
     }
 }
+/**
+ * Error thrown when the MCP server returns an error response.
+ */
 export class MCPServerError extends MCPClientError {
     constructor(message) {
         super(message, 'MCP_SERVER_ERROR');

package/dist/utils/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvB,IAAI,CAAS;IAE7B,YAAY,OAAe,EAAE,OAAe,kBAAkB;QAC5D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IAChD,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,cAAc;IACjC,OAAO,CAAS;IAEhC,YAAY,OAAe,EAAE,OAAe;QAC1C,KAAK,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IACjD,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,cAAc;IACpD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,sBAAsB,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;IACpD,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,cAAc;IACpD;QACE,KAAK,CAAC,+DAA+D,EAAE,iBAAiB,CAAC,CAAC;QAC1F,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;IACpD,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,cAAc;IACxD;QACE,KAAK,CAAC,4DAA4D,EAAE,qBAAqB,CAAC,CAAC;QAC3F,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,sBAAsB,CAAC,CAAC;IACxD,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,cAAc;IAChD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IAChD,CAAC;CACF"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,kDAAkD;IAClC,IAAI,CAAS;IAE7B,YAAY,OAAe,EAAE,OAAe,kBAAkB;QAC5D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IAChD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,cAAc;IACjD,yCAAyC;IACzB,OAAO,CAAS;IAEhC,YAAY,OAAe,EAAE,OAAe;QAC1C,KAAK,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IACjD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,cAAc;IACpD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,sBAAsB,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;IACpD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,cAAc;IACpD;QACE,KAAK,CAAC,+DAA+D,EAAE,iBAAiB,CAAC,CAAC;QAC1F,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;IACpD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,sBAAuB,SAAQ,cAAc;IACxD;QACE,KAAK,CAAC,4DAA4D,EAAE,qBAAqB,CAAC,CAAC;QAC3F,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,sBAAsB,CAAC,CAAC;IACxD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,cAAc;IAChD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IAChD,CAAC;CACF"}

package/dist/utils/logger.d.ts

@@ -1,14 +1,60 @@
+/**
+ * Logging utilities for MCP client.
+ *
+ * Provides configurable logging with multiple output levels and formats.
+ */
+/**
+ * Supported log levels in order of verbosity.
+ */
 export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'none';
+/**
+ * Options for configuring a Logger instance.
+ */
 export interface LoggerOptions {
+    /**
+     * Minimum log level to output.
+     * @defaultValue "info"
+     */
     level?: LogLevel;
+    /**
+     * Prefix added to all log messages.
+     */
     prefix?: string;
 }
+/**
+ * Logger interface for logging messages.
+ */
 export interface Logger {
+    /**
+     * Log a debug message.
+     * @param args - Message arguments to log
+     */
     debug(...args: unknown[]): void;
+    /**
+     * Log an info message.
+     * @param args - Message arguments to log
+     */
     info(...args: unknown[]): void;
+    /**
+     * Log a warning message.
+     * @param args - Message arguments to log
+     */
     warn(...args: unknown[]): void;
+    /**
+     * Log an error message.
+     * @param args - Message arguments to log
+     */
     error(...args: unknown[]): void;
 }
+/**
+ * Logger implementation that outputs to stderr.
+ *
+ * @example
+ * ```typescript
+ * const logger = new ConsoleLogger({ level: 'debug', prefix: 'MyApp' });
+ * logger.info('Starting...'); // [MyApp] INFO: Starting...
+ * ```
+ */
 export declare class ConsoleLogger implements Logger {
     private level;
     private prefix;
@@ -20,6 +66,17 @@ export declare class ConsoleLogger implements Logger {
     warn(...args: unknown[]): void;
     error(...args: unknown[]): void;
 }
+/**
+ * No-op logger that discards all log messages.
+ *
+ * Use this when you don't want any logging output.
+ *
+ * @example
+ * ```typescript
+ * const logger = new NoOpLogger();
+ * logger.info('This will be ignored');
+ * ```
+ */
 export declare class NoOpLogger implements Logger {
     debug(): void;
     info(): void;

package/dist/utils/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAEpE,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChC,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CACjC;AAUD,qBAAa,aAAc,YAAW,MAAM;IAC1C,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,GAAE,aAAkB;IAKvC,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,MAAM;IAKd,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM9B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM9B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;CAKhC;AAED,qBAAa,UAAW,YAAW,MAAM;IACvC,KAAK,IAAI,IAAI;IACb,IAAI,IAAI,IAAI;IACZ,IAAI,IAAI,IAAI;IACZ,KAAK,IAAI,IAAI;CACd"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB;;;OAGG;IACH,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChC;;;OAGG;IACH,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B;;;OAGG;IACH,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B;;;OAGG;IACH,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CACjC;AAUD;;;;;;;;GAQG;AACH,qBAAa,aAAc,YAAW,MAAM;IAC1C,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,GAAE,aAAkB;IAKvC,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,MAAM;IAKd,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAO/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAO9B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAO9B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;CAMhC;AAED;;;;;;;;;;GAUG;AACH,qBAAa,UAAW,YAAW,MAAM;IACvC,KAAK,IAAI,IAAI;IACb,IAAI,IAAI,IAAI;IACZ,IAAI,IAAI,IAAI;IACZ,KAAK,IAAI,IAAI;CACd"}

package/dist/utils/logger.js

@@ -1,3 +1,8 @@
+/**
+ * Logging utilities for MCP client.
+ *
+ * Provides configurable logging with multiple output levels and formats.
+ */
 const LOG_LEVELS = {
     debug: 0,
     info: 1,
@@ -5,6 +10,15 @@ const LOG_LEVELS = {
     error: 3,
     none: 99,
 };
+/**
+ * Logger implementation that outputs to stderr.
+ *
+ * @example
+ * ```typescript
+ * const logger = new ConsoleLogger({ level: 'debug', prefix: 'MyApp' });
+ * logger.info('Starting...'); // [MyApp] INFO: Starting...
+ * ```
+ */
 export class ConsoleLogger {
     level;
     prefix;
@@ -21,25 +35,40 @@ export class ConsoleLogger {
     }
     debug(...args) {
         if (this.shouldLog('debug')) {
-            console.debug(...this.format('debug', args));
+            // eslint-disable-next-line no-console
+            console.error(...this.format('debug', args));
         }
     }
     info(...args) {
         if (this.shouldLog('info')) {
-            console.info(...this.format('info', args));
+            // eslint-disable-next-line no-console
+            console.error(...this.format('info', args));
         }
     }
     warn(...args) {
         if (this.shouldLog('warn')) {
-            console.warn(...this.format('warn', args));
+            // eslint-disable-next-line no-console
+            console.error(...this.format('warn', args));
         }
     }
     error(...args) {
         if (this.shouldLog('error')) {
+            // eslint-disable-next-line no-console
             console.error(...this.format('error', args));
         }
     }
 }
+/**
+ * No-op logger that discards all log messages.
+ *
+ * Use this when you don't want any logging output.
+ *
+ * @example
+ * ```typescript
+ * const logger = new NoOpLogger();
+ * logger.info('This will be ignored');
+ * ```
+ */
 export class NoOpLogger {
     debug() { }
     info() { }

package/dist/utils/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,GAA6B;IAC3C,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,EAAE;CACT,CAAC;AAEF,MAAM,OAAO,aAAa;IAChB,KAAK,CAAS;IACd,MAAM,CAAS;IAEvB,YAAY,UAAyB,EAAE;QACrC,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;IACrC,CAAC;IAEO,SAAS,CAAC,YAAsB;QACtC,OAAO,UAAU,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC;IAChD,CAAC;IAEO,MAAM,CAAC,KAAe,EAAE,IAAe;QAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,OAAO,CAAC,GAAG,MAAM,GAAG,KAAK,CAAC,WAAW,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,GAAG,IAAe;QACtB,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,IAAI,CAAC,GAAG,IAAe;QACrB,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,IAAI,CAAC,GAAG,IAAe;QACrB,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,IAAe;QACtB,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;CACF;AAED,MAAM,OAAO,UAAU;IACrB,KAAK,KAAU,CAAC;IAChB,IAAI,KAAU,CAAC;IACf,IAAI,KAAU,CAAC;IACf,KAAK,KAAU,CAAC;CACjB"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAgDH,MAAM,UAAU,GAA6B;IAC3C,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,EAAE;CACT,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,OAAO,aAAa;IAChB,KAAK,CAAS;IACd,MAAM,CAAS;IAEvB,YAAY,UAAyB,EAAE;QACrC,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;IACrC,CAAC;IAEO,SAAS,CAAC,YAAsB;QACtC,OAAO,UAAU,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC;IAChD,CAAC;IAEO,MAAM,CAAC,KAAe,EAAE,IAAe;QAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,OAAO,CAAC,GAAG,MAAM,GAAG,KAAK,CAAC,WAAW,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,GAAG,IAAe;QACtB,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,sCAAsC;YACtC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,IAAI,CAAC,GAAG,IAAe;QACrB,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,sCAAsC;YACtC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,IAAI,CAAC,GAAG,IAAe;QACrB,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,sCAAsC;YACtC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,IAAe;QACtB,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,sCAAsC;YACtC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;CACF;AAED;;;;;;;;;;GAUG;AACH,MAAM,OAAO,UAAU;IACrB,KAAK,KAAU,CAAC;IAChB,IAAI,KAAU,CAAC;IACf,IAAI,KAAU,CAAC;IACf,KAAK,KAAU,CAAC;CACjB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@slbdn/mcp-tester",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "description": "Minimal MCP client implementation for CI/CD testing of MCP servers",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -9,16 +9,27 @@
   "files": [
     "dist/client",
     "dist/utils",
+    "dist/cli",
     "dist/index.js",
     "dist/index.d.ts",
     "dist/index.d.ts.map",
     "dist/index.js.map",
+    "dist/assert.js",
+    "dist/assert.d.ts",
+    "dist/assert.d.ts.map",
+    "dist/assert.js.map",
+    "dist/matchers.js",
+    "dist/matchers.d.ts",
+    "dist/matchers.d.ts.map",
+    "dist/matchers.js.map",
+    "vitest.d.ts",
     "LICENSE",
     "README.md",
     "CHANGELOG.md"
   ],
   "scripts": {
     "build": "tsc",
+    "docs": "typedoc",
     "test": "jest",
     "test:watch": "jest --watch",
     "test:coverage": "jest --coverage",
@@ -27,20 +38,32 @@
     "format:check": "prettier --check \"src/**/*.ts\"",
     "audit": "npm audit",
     "audit:fix": "npm audit fix",
-    "prepublishOnly": "npm run build",
+    "prepublishOnly": "npm run build && npm run docs",
     "release:patch": "npm version patch && npm run build",
     "release:minor": "npm version minor && npm run build",
     "release:major": "npm version major && npm run build",
     "release:prerelease": "npm version prerelease && npm run build",
     "release:commit": "git add package.json CHANGELOG.md && git commit -m \"chore: release $(node -p \"require('./package.json').version\")\"",
-    "prepare": "husky"
+    "prepare": "husky || true"
+  },
+  "bin": {
+    "mcp-tester": "dist/cli/index.js"
   },
   "keywords": [
     "mcp",
     "model-context-protocol",
+    "mcp-tester",
+    "mcp-client",
     "testing",
+    "test",
     "jest",
-    "ci-cd"
+    "vitest",
+    "assert",
+    "matchers",
+    "ci-cd",
+    "cli",
+    "typescript",
+    "esm"
   ],
   "author": "Slobodan Ivkovic",
   "license": "MIT",
@@ -53,9 +76,11 @@
   },
   "homepage": "https://github.com/islobodan/mcp-tester#readme",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.29.0"
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "commander": "^14.0.3"
   },
   "devDependencies": {
+    "@modelcontextprotocol/server-everything": "^2026.1.26",
     "@types/jest": "^29.5.0",
     "@types/node": "^20.0.0",
     "@typescript-eslint/eslint-plugin": "^8.58.0",
@@ -66,6 +91,8 @@
     "lint-staged": "^16.4.0",
     "prettier": "^3.8.1",
     "ts-jest": "^29.4.9",
+    "typedoc": "^0.28.19",
+    "typedoc-plugin-markdown": "^4.11.0",
     "typescript": "^5.3.0"
   },
   "engines": {

package/vitest.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Vitest type declarations for MCP Tester custom matchers.
+ *
+ * Add this file to your tsconfig.json includes or reference it
+ * in your Vitest setup file to get type-safe matcher autocompletion.
+ *
+ * Usage (in vitest.d.ts or your setup file):
+ *   /// <reference types="@slbdn/mcp-tester/vitest" />
+ *
+ * Or add to tsconfig.json:
+ *   "include": ["node_modules/@slbdn/mcp-tester/vitest.d.ts"]
+ *
+ * Then in your Vitest setup:
+ *   import { setupVitestMatchers } from '@slbdn/mcp-tester';
+ *   beforeAll(() => setupVitestMatchers());
+ */
+
+import 'vitest';
+
+declare module 'vitest' {
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars
+  interface Matchers<R = void, T = unknown> {
+    // Collection matchers
+    toHaveTool(toolName: string): R;
+    toHaveResource(uri: string): R;
+    toHavePrompt(promptName: string): R;
+    toHaveToolWithSchema(toolName: string): R;
+    toHaveToolCount(count: number): R;
+    toHaveResourceCount(count: number): R;
+    toHavePromptCount(count: number): R;
+    toHaveResourceByName(name: string): R;
+    toHavePromptWithArgs(promptName: string): R;
+
+    // Tool result matchers
+    toReturnText(expected?: string): R;
+    toReturnTextContaining(substring: string): R;
+    toReturnError(): R;
+    toReturnOk(): R;
+    toReturnJson(expected: unknown): R;
+    toReturnContentCount(count: number): R;
+    toReturnImage(): R;
+
+    // Resource result matchers
+    toReturnResourceText(expected?: string): R;
+    toReturnResourceTextContaining(substring: string): R;
+
+    // Prompt result matchers
+    toReturnPromptTextContaining(substring: string): R;
+    toReturnPromptMessageCount(count: number): R;
+  }
+}