@frontmcp/testing 0.5.0

package/jest-preset.js

@@ -0,0 +1,61 @@
+/**
+ * @file jest-preset.js
+ * @description Jest preset for @frontmcp/testing
+ *
+ * Usage in jest.config.ts or jest.e2e.config.ts:
+ * ```typescript
+ * export default {
+ *   preset: '@frontmcp/testing/jest-preset',
+ *   // Your additional config...
+ * };
+ * ```
+ */
+
+module.exports = {
+  // Use Node.js environment for E2E tests
+  testEnvironment: 'node',
+
+  // Transform TypeScript files
+  transform: {
+    '^.+\\.tsx?$': [
+      'ts-jest',
+      {
+        useESM: false,
+        tsconfig: {
+          // Allow importing .js extensions for ESM compatibility
+          moduleResolution: 'node',
+        },
+      },
+    ],
+  },
+
+  // File extensions to consider
+  moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json', 'node'],
+
+  // Default test timeout (30 seconds for E2E)
+  testTimeout: 30000,
+
+  // Setup files that run after Jest is initialized
+  // Path resolves to the compiled output when used from node_modules/@frontmcp/testing
+  setupFilesAfterEnv: [require.resolve('@frontmcp/testing/setup')],
+
+  // Test file patterns for E2E tests
+  testMatch: ['**/*.e2e.ts', '**/*.e2e.js', '**/e2e/**/*.test.ts', '**/e2e/**/*.test.js'],
+
+  // Module name mapping for path aliases
+  // Note: These point to dist/src/ since the package exports declare dist/src/index.js
+  moduleNameMapper: {
+    // Map @frontmcp/testing to the installed package
+    '^@frontmcp/testing$': '<rootDir>/node_modules/@frontmcp/testing/dist/src/index.js',
+    '^@frontmcp/testing/(.*)$': '<rootDir>/node_modules/@frontmcp/testing/dist/src/$1',
+  },
+
+  // Ignore patterns
+  testPathIgnorePatterns: ['/node_modules/', '/dist/'],
+
+  // Coverage settings (optional, disabled by default for E2E)
+  collectCoverage: false,
+
+  // Verbose output
+  verbose: true,
+};

package/package.json

@@ -0,0 +1,94 @@
+{
+  "name": "@frontmcp/testing",
+  "version": "0.5.0",
+  "description": "E2E testing framework for FrontMCP servers - MCP client, auth mocks, Playwright integration",
+  "author": "AgentFront <info@agentfront.dev>",
+  "homepage": "https://docs.agentfront.dev",
+  "license": "Apache-2.0",
+  "keywords": [
+    "mcp",
+    "testing",
+    "e2e",
+    "integration-testing",
+    "mcp-client",
+    "playwright",
+    "agentfront",
+    "frontmcp",
+    "framework",
+    "typescript"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/agentfront/frontmcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/agentfront/frontmcp/issues"
+  },
+  "main": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./src/index.d.ts",
+      "import": "./src/index.js",
+      "default": "./src/index.js"
+    },
+    "./setup": {
+      "types": "./src/setup.d.ts",
+      "import": "./src/setup.js",
+      "default": "./src/setup.js"
+    },
+    "./jest-preset": {
+      "default": "./jest-preset.js"
+    },
+    "./fixtures": {
+      "types": "./src/fixtures/index.d.ts",
+      "import": "./src/fixtures/index.js",
+      "default": "./src/fixtures/index.js"
+    },
+    "./matchers": {
+      "types": "./src/matchers/index.d.ts",
+      "import": "./src/matchers/index.js",
+      "default": "./src/matchers/index.js"
+    },
+    "./playwright": {
+      "types": "./src/playwright/index.d.ts",
+      "import": "./src/playwright/index.js",
+      "default": "./src/playwright/index.js"
+    }
+  },
+  "peerDependencies": {
+    "@frontmcp/sdk": "0.5.0",
+    "@frontmcp/ui": "0.5.0",
+    "@playwright/test": "^1.40.0",
+    "jest": "^29.0.0",
+    "@jest/globals": "^29.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@frontmcp/ui": {
+      "optional": true
+    },
+    "@playwright/test": {
+      "optional": true
+    },
+    "jest": {
+      "optional": true
+    },
+    "@jest/globals": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "1.23.0",
+    "jose": "^6.0.11",
+    "tslib": "^2.3.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.14",
+    "typescript": "^5.9.3"
+  },
+  "type": "commonjs"
+}

package/src/assertions/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @file assertions/index.ts
+ * @description MCP assertions exports
+ */
+export { McpAssertions, containsTool, containsResource, containsResourceTemplate, containsPrompt, isSuccessful, isError, hasTextContent, hasMimeType, } from './mcp-assertions';

package/src/assertions/index.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * @file assertions/index.ts
+ * @description MCP assertions exports
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasMimeType = exports.hasTextContent = exports.isError = exports.isSuccessful = exports.containsPrompt = exports.containsResourceTemplate = exports.containsResource = exports.containsTool = exports.McpAssertions = void 0;
+var mcp_assertions_1 = require("./mcp-assertions");
+Object.defineProperty(exports, "McpAssertions", { enumerable: true, get: function () { return mcp_assertions_1.McpAssertions; } });
+Object.defineProperty(exports, "containsTool", { enumerable: true, get: function () { return mcp_assertions_1.containsTool; } });
+Object.defineProperty(exports, "containsResource", { enumerable: true, get: function () { return mcp_assertions_1.containsResource; } });
+Object.defineProperty(exports, "containsResourceTemplate", { enumerable: true, get: function () { return mcp_assertions_1.containsResourceTemplate; } });
+Object.defineProperty(exports, "containsPrompt", { enumerable: true, get: function () { return mcp_assertions_1.containsPrompt; } });
+Object.defineProperty(exports, "isSuccessful", { enumerable: true, get: function () { return mcp_assertions_1.isSuccessful; } });
+Object.defineProperty(exports, "isError", { enumerable: true, get: function () { return mcp_assertions_1.isError; } });
+Object.defineProperty(exports, "hasTextContent", { enumerable: true, get: function () { return mcp_assertions_1.hasTextContent; } });
+Object.defineProperty(exports, "hasMimeType", { enumerable: true, get: function () { return mcp_assertions_1.hasMimeType; } });
+//# sourceMappingURL=index.js.map

package/src/assertions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/assertions/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,mDAU0B;AATxB,+GAAA,aAAa,OAAA;AACb,8GAAA,YAAY,OAAA;AACZ,kHAAA,gBAAgB,OAAA;AAChB,0HAAA,wBAAwB,OAAA;AACxB,gHAAA,cAAc,OAAA;AACd,8GAAA,YAAY,OAAA;AACZ,yGAAA,OAAO,OAAA;AACP,gHAAA,cAAc,OAAA;AACd,6GAAA,WAAW,OAAA","sourcesContent":["/**\n * @file assertions/index.ts\n * @description MCP assertions exports\n */\n\nexport {\n  McpAssertions,\n  containsTool,\n  containsResource,\n  containsResourceTemplate,\n  containsPrompt,\n  isSuccessful,\n  isError,\n  hasTextContent,\n  hasMimeType,\n} from './mcp-assertions';\n"]}

package/src/assertions/mcp-assertions.d.ts

@@ -0,0 +1,81 @@
+/**
+ * @file mcp-assertions.ts
+ * @description MCP-specific test assertions
+ */
+import type { McpResponse, ToolResultWrapper, ResourceContentWrapper, McpErrorInfo } from '../client';
+import type { Tool, Resource, ResourceTemplate, Prompt, CallToolResult, ReadResourceResult } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * MCP-specific assertion helpers
+ */
+export declare const McpAssertions: {
+    /**
+     * Assert that an MCP response was successful and return the data
+     * @throws Error if response was not successful
+     */
+    assertSuccess<T>(response: McpResponse<T>, message?: string): T;
+    /**
+     * Assert that an MCP response was an error
+     * @param expectedCode Optional expected error code
+     */
+    assertError<T>(response: McpResponse<T>, expectedCode?: number): McpErrorInfo;
+    /**
+     * Assert that a tool call was successful (not isError)
+     */
+    assertToolSuccess(result: ToolResultWrapper | McpResponse<CallToolResult>): void;
+    /**
+     * Assert that a tool result has specific content type
+     */
+    assertToolContent(result: ToolResultWrapper | McpResponse<CallToolResult>, type: "text" | "image" | "resource"): void;
+    /**
+     * Assert that a resource read was successful and return the text content
+     */
+    assertTextResource(response: ResourceContentWrapper | McpResponse<ReadResourceResult>): string;
+    /**
+     * Assert that tools array contains a tool with given name
+     */
+    assertContainsTool(tools: Tool[], name: string): Tool;
+    /**
+     * Assert that resources array contains a resource with given URI
+     */
+    assertContainsResource(resources: Resource[], uri: string): Resource;
+    /**
+     * Assert that resource templates array contains a template with given URI template
+     */
+    assertContainsResourceTemplate(templates: ResourceTemplate[], uriTemplate: string): ResourceTemplate;
+    /**
+     * Assert that prompts array contains a prompt with given name
+     */
+    assertContainsPrompt(prompts: Prompt[], name: string): Prompt;
+};
+/**
+ * Check if tools array contains a tool with given name
+ */
+export declare function containsTool(tools: Tool[], name: string): boolean;
+/**
+ * Check if resources array contains a resource with given URI
+ */
+export declare function containsResource(resources: Resource[], uri: string): boolean;
+/**
+ * Check if resource templates array contains a template with given URI template
+ */
+export declare function containsResourceTemplate(templates: ResourceTemplate[], uriTemplate: string): boolean;
+/**
+ * Check if prompts array contains a prompt with given name
+ */
+export declare function containsPrompt(prompts: Prompt[], name: string): boolean;
+/**
+ * Check if result is successful
+ */
+export declare function isSuccessful(result: ToolResultWrapper | ResourceContentWrapper): boolean;
+/**
+ * Check if result is an error
+ */
+export declare function isError(result: ToolResultWrapper | ResourceContentWrapper, expectedCode?: number): boolean;
+/**
+ * Check if result has text content
+ */
+export declare function hasTextContent(result: ToolResultWrapper): boolean;
+/**
+ * Check if resource has specific MIME type
+ */
+export declare function hasMimeType(result: ResourceContentWrapper, mimeType: string): boolean;

package/src/assertions/mcp-assertions.js

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

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

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

package/src/auth/auth-headers.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @file auth-headers.ts
+ * @description Helper functions for building authentication headers
+ */
+/**
+ * Helper functions for building authentication headers
+ */
+export declare const AuthHeaders: {
+    /**
+     * Create Authorization header with Bearer token
+     */
+    bearer(token: string): Record<string, string>;
+    /**
+     * Create headers with no authentication
+     */
+    noAuth(): Record<string, string>;
+    /**
+     * Create full MCP request headers with auth and session
+     */
+    mcpRequest(token: string, sessionId?: string): Record<string, string>;
+    /**
+     * Create headers for public mode (no auth required)
+     */
+    publicMode(sessionId?: string): Record<string, string>;
+    /**
+     * Create headers with custom auth header value
+     */
+    custom(headerName: string, headerValue: string): Record<string, string>;
+};

package/src/auth/auth-headers.js

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

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

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

package/src/auth/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @file auth/index.ts
+ * @description Auth testing utilities exports
+ */
+export { TestTokenFactory } from './token-factory';
+export type { CreateTokenOptions, TokenFactoryOptions } from './token-factory';
+export { AuthHeaders } from './auth-headers';
+export { TestUsers, createTestUser } from './user-fixtures';
+export type { TestUserFixture } from './user-fixtures';

package/src/auth/index.js

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

package/src/auth/index.js.map

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