@frontmcp/testing 0.5.0 → 0.6.0

package/src/example-tools/tool-configs.d.ts

@@ -0,0 +1,170 @@
+/**
+ * @file tool-configs.ts
+ * @description Shared tool configurations for platform E2E testing.
+ *
+ * These configurations provide consistent test fixtures for validating
+ * platform-specific meta key behavior across E2E test projects.
+ *
+ * @example Usage in E2E tool implementation
+ * ```typescript
+ * import { Tool, ToolContext } from '@frontmcp/sdk';
+ * import { BASIC_UI_TOOL_CONFIG, FULL_UI_TOOL_CONFIG } from '@frontmcp/testing';
+ *
+ * @Tool({
+ *   name: BASIC_UI_TOOL_CONFIG.name,
+ *   description: BASIC_UI_TOOL_CONFIG.description,
+ *   ui: BASIC_UI_TOOL_CONFIG.ui,
+ * })
+ * export class BasicUITool extends ToolContext<typeof inputSchema, typeof outputSchema> {
+ *   async execute(input) {
+ *     return { message: `Hello, ${input.name}!`, timestamp: Date.now() };
+ *   }
+ * }
+ * ```
+ */
+import { z } from 'zod';
+/**
+ * Input schema for the basic UI tool.
+ */
+export declare const basicUIToolInputSchema: z.ZodObject<{
+    name: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Output schema for the basic UI tool.
+ */
+export declare const basicUIToolOutputSchema: z.ZodObject<{
+    message: z.ZodString;
+    timestamp: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Basic UI tool configuration with minimal UI config.
+ * Use this for testing that platform-specific meta keys are correctly applied.
+ */
+export declare const BASIC_UI_TOOL_CONFIG: {
+    readonly name: "platform-test-basic";
+    readonly description: "Basic UI tool for platform testing";
+    readonly inputSchema: z.ZodObject<{
+        name: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    }, z.core.$strip>;
+    readonly outputSchema: z.ZodObject<{
+        message: z.ZodString;
+        timestamp: z.ZodNumber;
+    }, z.core.$strip>;
+    readonly ui: {
+        /**
+         * Simple template that displays the output.
+         * Works with all platforms.
+         */
+        readonly template: string;
+    };
+};
+/**
+ * Input schema for the full UI tool.
+ */
+export declare const fullUIToolInputSchema: z.ZodObject<{
+    name: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    count: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>;
+/**
+ * Output schema for the full UI tool.
+ */
+export declare const fullUIToolOutputSchema: z.ZodObject<{
+    message: z.ZodString;
+    count: z.ZodNumber;
+    items: z.ZodArray<z.ZodString>;
+    timestamp: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Full UI tool configuration with all UI options.
+ * Use this for testing comprehensive platform-specific meta key behavior.
+ */
+export declare const FULL_UI_TOOL_CONFIG: {
+    readonly name: "platform-test-full";
+    readonly description: "Full UI tool with all options for comprehensive platform testing";
+    readonly inputSchema: z.ZodObject<{
+        name: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        count: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.core.$strip>;
+    readonly outputSchema: z.ZodObject<{
+        message: z.ZodString;
+        count: z.ZodNumber;
+        items: z.ZodArray<z.ZodString>;
+        timestamp: z.ZodNumber;
+    }, z.core.$strip>;
+    readonly ui: {
+        /**
+         * Template with more complex UI elements.
+         */
+        readonly template: string;
+        /**
+         * Widget is accessible for callback invocations.
+         */
+        readonly widgetAccessible: true;
+        /**
+         * Invocation status messages for OpenAI.
+         */
+        readonly invocationStatus: {
+            readonly invoking: "Processing request...";
+            readonly invoked: "Request completed";
+        };
+        /**
+         * Content Security Policy configuration.
+         */
+        readonly csp: {
+            readonly connectDomains: readonly ["https://api.example.com"];
+            readonly resourceDomains: readonly ["https://cdn.example.com"];
+        };
+        /**
+         * Display mode for the widget.
+         */
+        readonly displayMode: "inline";
+        /**
+         * Prefers border around the widget.
+         */
+        readonly prefersBorder: true;
+        /**
+         * Custom sandbox domain.
+         */
+        readonly sandboxDomain: "sandbox.example.com";
+    };
+};
+/**
+ * Generate output for the basic UI tool.
+ */
+export declare function generateBasicUIToolOutput(input: z.infer<typeof basicUIToolInputSchema>): {
+    message: string;
+    timestamp: number;
+};
+/**
+ * Generate output for the full UI tool.
+ */
+export declare function generateFullUIToolOutput(input: z.infer<typeof fullUIToolInputSchema>): {
+    message: string;
+    count: number;
+    items: string[];
+    timestamp: number;
+};
+/**
+ * Expected meta keys for OpenAI platform in tools/list response.
+ */
+export declare const EXPECTED_OPENAI_TOOLS_LIST_META_KEYS: readonly ["openai/outputTemplate", "openai/resultCanProduceWidget", "openai/widgetAccessible"];
+/**
+ * Expected meta keys for OpenAI platform in tools/call response.
+ */
+export declare const EXPECTED_OPENAI_TOOL_CALL_META_KEYS: readonly ["openai/html", "openai/mimeType", "openai/type"];
+/**
+ * Expected meta keys for ext-apps platform in tools/list response (SEP-1865).
+ */
+export declare const EXPECTED_EXTAPPS_TOOLS_LIST_META_KEYS: readonly ["ui/resourceUri", "ui/mimeType", "ui/cdn", "ui/type"];
+/**
+ * Expected meta keys for ext-apps platform in tools/call response (SEP-1865).
+ */
+export declare const EXPECTED_EXTAPPS_TOOL_CALL_META_KEYS: readonly ["ui/html", "ui/mimeType", "ui/type"];
+/**
+ * Expected meta keys for FrontMCP platforms in tools/list response (Claude, Cursor, etc.).
+ */
+export declare const EXPECTED_FRONTMCP_TOOLS_LIST_META_KEYS: readonly ["frontmcp/outputTemplate", "frontmcp/resultCanProduceWidget", "ui/cdn", "ui/type"];
+/**
+ * Expected meta keys for FrontMCP platforms in tools/call response (Claude, Cursor, etc.).
+ */
+export declare const EXPECTED_FRONTMCP_TOOL_CALL_META_KEYS: readonly ["frontmcp/html", "frontmcp/mimeType", "ui/html", "ui/mimeType"];

package/src/example-tools/tool-configs.js

@@ -0,0 +1,222 @@
+"use strict";
+/**
+ * @file tool-configs.ts
+ * @description Shared tool configurations for platform E2E testing.
+ *
+ * These configurations provide consistent test fixtures for validating
+ * platform-specific meta key behavior across E2E test projects.
+ *
+ * @example Usage in E2E tool implementation
+ * ```typescript
+ * import { Tool, ToolContext } from '@frontmcp/sdk';
+ * import { BASIC_UI_TOOL_CONFIG, FULL_UI_TOOL_CONFIG } from '@frontmcp/testing';
+ *
+ * @Tool({
+ *   name: BASIC_UI_TOOL_CONFIG.name,
+ *   description: BASIC_UI_TOOL_CONFIG.description,
+ *   ui: BASIC_UI_TOOL_CONFIG.ui,
+ * })
+ * export class BasicUITool extends ToolContext<typeof inputSchema, typeof outputSchema> {
+ *   async execute(input) {
+ *     return { message: `Hello, ${input.name}!`, timestamp: Date.now() };
+ *   }
+ * }
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EXPECTED_FRONTMCP_TOOL_CALL_META_KEYS = exports.EXPECTED_FRONTMCP_TOOLS_LIST_META_KEYS = exports.EXPECTED_EXTAPPS_TOOL_CALL_META_KEYS = exports.EXPECTED_EXTAPPS_TOOLS_LIST_META_KEYS = exports.EXPECTED_OPENAI_TOOL_CALL_META_KEYS = exports.EXPECTED_OPENAI_TOOLS_LIST_META_KEYS = exports.FULL_UI_TOOL_CONFIG = exports.fullUIToolOutputSchema = exports.fullUIToolInputSchema = exports.BASIC_UI_TOOL_CONFIG = exports.basicUIToolOutputSchema = exports.basicUIToolInputSchema = void 0;
+exports.generateBasicUIToolOutput = generateBasicUIToolOutput;
+exports.generateFullUIToolOutput = generateFullUIToolOutput;
+const zod_1 = require("zod");
+// ═══════════════════════════════════════════════════════════════════
+// BASIC UI TOOL CONFIG
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * Input schema for the basic UI tool.
+ */
+exports.basicUIToolInputSchema = zod_1.z.object({
+    name: zod_1.z.string().optional().default('World'),
+});
+/**
+ * Output schema for the basic UI tool.
+ */
+exports.basicUIToolOutputSchema = zod_1.z.object({
+    message: zod_1.z.string(),
+    timestamp: zod_1.z.number(),
+});
+/**
+ * Basic UI tool configuration with minimal UI config.
+ * Use this for testing that platform-specific meta keys are correctly applied.
+ */
+exports.BASIC_UI_TOOL_CONFIG = {
+    name: 'platform-test-basic',
+    description: 'Basic UI tool for platform testing',
+    inputSchema: exports.basicUIToolInputSchema,
+    outputSchema: exports.basicUIToolOutputSchema,
+    ui: {
+        /**
+         * Simple template that displays the output.
+         * Works with all platforms.
+         */
+        template: `
+<div class="platform-test-basic">
+  <h1>Platform Test - Basic</h1>
+  <p>Message: {output.message}</p>
+  <p>Timestamp: {output.timestamp}</p>
+</div>
+    `.trim(),
+    },
+};
+// ═══════════════════════════════════════════════════════════════════
+// FULL UI TOOL CONFIG
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * Input schema for the full UI tool.
+ */
+exports.fullUIToolInputSchema = zod_1.z.object({
+    name: zod_1.z.string().optional().default('World'),
+    count: zod_1.z.number().optional().default(1),
+});
+/**
+ * Output schema for the full UI tool.
+ */
+exports.fullUIToolOutputSchema = zod_1.z.object({
+    message: zod_1.z.string(),
+    count: zod_1.z.number(),
+    items: zod_1.z.array(zod_1.z.string()),
+    timestamp: zod_1.z.number(),
+});
+/**
+ * Full UI tool configuration with all UI options.
+ * Use this for testing comprehensive platform-specific meta key behavior.
+ */
+exports.FULL_UI_TOOL_CONFIG = {
+    name: 'platform-test-full',
+    description: 'Full UI tool with all options for comprehensive platform testing',
+    inputSchema: exports.fullUIToolInputSchema,
+    outputSchema: exports.fullUIToolOutputSchema,
+    ui: {
+        /**
+         * Template with more complex UI elements.
+         */
+        template: `
+<div class="platform-test-full">
+  <h1>Platform Test - Full</h1>
+  <div class="message-box">
+    <strong>Message:</strong> {output.message}
+  </div>
+  <div class="count-box">
+    <strong>Count:</strong> {output.count}
+  </div>
+  <div class="items-list">
+    <strong>Items:</strong>
+    <ul>
+      {output.items.map(item => <li key={item}>{item}</li>)}
+    </ul>
+  </div>
+  <footer>
+    <small>Generated at: {new Date(output.timestamp).toISOString()}</small>
+  </footer>
+</div>
+    `.trim(),
+        /**
+         * Widget is accessible for callback invocations.
+         */
+        widgetAccessible: true,
+        /**
+         * Invocation status messages for OpenAI.
+         */
+        invocationStatus: {
+            invoking: 'Processing request...',
+            invoked: 'Request completed',
+        },
+        /**
+         * Content Security Policy configuration.
+         */
+        csp: {
+            connectDomains: ['https://api.example.com'],
+            resourceDomains: ['https://cdn.example.com'],
+        },
+        /**
+         * Display mode for the widget.
+         */
+        displayMode: 'inline',
+        /**
+         * Prefers border around the widget.
+         */
+        prefersBorder: true,
+        /**
+         * Custom sandbox domain.
+         */
+        sandboxDomain: 'sandbox.example.com',
+    },
+};
+// ═══════════════════════════════════════════════════════════════════
+// TOOL EXECUTION HELPERS
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * Generate output for the basic UI tool.
+ */
+function generateBasicUIToolOutput(input) {
+    return {
+        message: `Hello, ${input.name}!`,
+        timestamp: Date.now(),
+    };
+}
+/**
+ * Generate output for the full UI tool.
+ */
+function generateFullUIToolOutput(input) {
+    const items = [];
+    for (let i = 1; i <= input.count; i++) {
+        items.push(`Item ${i}`);
+    }
+    return {
+        message: `Hello, ${input.name}! You requested ${input.count} item(s).`,
+        count: input.count,
+        items,
+        timestamp: Date.now(),
+    };
+}
+// ═══════════════════════════════════════════════════════════════════
+// EXPECTED META KEYS
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * Expected meta keys for OpenAI platform in tools/list response.
+ */
+exports.EXPECTED_OPENAI_TOOLS_LIST_META_KEYS = [
+    'openai/outputTemplate',
+    'openai/resultCanProduceWidget',
+    'openai/widgetAccessible',
+];
+/**
+ * Expected meta keys for OpenAI platform in tools/call response.
+ */
+exports.EXPECTED_OPENAI_TOOL_CALL_META_KEYS = ['openai/html', 'openai/mimeType', 'openai/type'];
+/**
+ * Expected meta keys for ext-apps platform in tools/list response (SEP-1865).
+ */
+exports.EXPECTED_EXTAPPS_TOOLS_LIST_META_KEYS = ['ui/resourceUri', 'ui/mimeType', 'ui/cdn', 'ui/type'];
+/**
+ * Expected meta keys for ext-apps platform in tools/call response (SEP-1865).
+ */
+exports.EXPECTED_EXTAPPS_TOOL_CALL_META_KEYS = ['ui/html', 'ui/mimeType', 'ui/type'];
+/**
+ * Expected meta keys for FrontMCP platforms in tools/list response (Claude, Cursor, etc.).
+ */
+exports.EXPECTED_FRONTMCP_TOOLS_LIST_META_KEYS = [
+    'frontmcp/outputTemplate',
+    'frontmcp/resultCanProduceWidget',
+    'ui/cdn',
+    'ui/type',
+];
+/**
+ * Expected meta keys for FrontMCP platforms in tools/call response (Claude, Cursor, etc.).
+ */
+exports.EXPECTED_FRONTMCP_TOOL_CALL_META_KEYS = [
+    'frontmcp/html',
+    'frontmcp/mimeType',
+    'ui/html',
+    'ui/mimeType',
+];
+//# sourceMappingURL=tool-configs.js.map

package/src/example-tools/tool-configs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-configs.js","sourceRoot":"","sources":["../../../src/example-tools/tool-configs.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @file tool-configs.ts\n * @description Shared tool configurations for platform E2E testing.\n *\n * These configurations provide consistent test fixtures for validating\n * platform-specific meta key behavior across E2E test projects.\n *\n * @example Usage in E2E tool implementation\n * ```typescript\n * import { Tool, ToolContext } from '@frontmcp/sdk';\n * import { BASIC_UI_TOOL_CONFIG, FULL_UI_TOOL_CONFIG } from '@frontmcp/testing';\n *\n * @Tool({\n *   name: BASIC_UI_TOOL_CONFIG.name,\n *   description: BASIC_UI_TOOL_CONFIG.description,\n *   ui: BASIC_UI_TOOL_CONFIG.ui,\n * })\n * export class BasicUITool extends ToolContext<typeof inputSchema, typeof outputSchema> {\n *   async execute(input) {\n *     return { message: `Hello, ${input.name}!`, timestamp: Date.now() };\n *   }\n * }\n * ```\n */\n\nimport { z } from 'zod';\n\n// ═══════════════════════════════════════════════════════════════════\n// BASIC UI TOOL CONFIG\n// ═══════════════════════════════════════════════════════════════════\n\n/**\n * Input schema for the basic UI tool.\n */\nexport const basicUIToolInputSchema = z.object({\n  name: z.string().optional().default('World'),\n});\n\n/**\n * Output schema for the basic UI tool.\n */\nexport const basicUIToolOutputSchema = z.object({\n  message: z.string(),\n  timestamp: z.number(),\n});\n\n/**\n * Basic UI tool configuration with minimal UI config.\n * Use this for testing that platform-specific meta keys are correctly applied.\n */\nexport const BASIC_UI_TOOL_CONFIG = {\n  name: 'platform-test-basic',\n  description: 'Basic UI tool for platform testing',\n  inputSchema: basicUIToolInputSchema,\n  outputSchema: basicUIToolOutputSchema,\n  ui: {\n    /**\n     * Simple template that displays the output.\n     * Works with all platforms.\n     */\n    template: `\n<div class=\"platform-test-basic\">\n  <h1>Platform Test - Basic</h1>\n  <p>Message: {output.message}</p>\n  <p>Timestamp: {output.timestamp}</p>\n</div>\n    `.trim(),\n  },\n} as const;\n\n// ═══════════════════════════════════════════════════════════════════\n// FULL UI TOOL CONFIG\n// ═══════════════════════════════════════════════════════════════════\n\n/**\n * Input schema for the full UI tool.\n */\nexport const fullUIToolInputSchema = z.object({\n  name: z.string().optional().default('World'),\n  count: z.number().optional().default(1),\n});\n\n/**\n * Output schema for the full UI tool.\n */\nexport const fullUIToolOutputSchema = z.object({\n  message: z.string(),\n  count: z.number(),\n  items: z.array(z.string()),\n  timestamp: z.number(),\n});\n\n/**\n * Full UI tool configuration with all UI options.\n * Use this for testing comprehensive platform-specific meta key behavior.\n */\nexport const FULL_UI_TOOL_CONFIG = {\n  name: 'platform-test-full',\n  description: 'Full UI tool with all options for comprehensive platform testing',\n  inputSchema: fullUIToolInputSchema,\n  outputSchema: fullUIToolOutputSchema,\n  ui: {\n    /**\n     * Template with more complex UI elements.\n     */\n    template: `\n<div class=\"platform-test-full\">\n  <h1>Platform Test - Full</h1>\n  <div class=\"message-box\">\n    <strong>Message:</strong> {output.message}\n  </div>\n  <div class=\"count-box\">\n    <strong>Count:</strong> {output.count}\n  </div>\n  <div class=\"items-list\">\n    <strong>Items:</strong>\n    <ul>\n      {output.items.map(item => <li key={item}>{item}</li>)}\n    </ul>\n  </div>\n  <footer>\n    <small>Generated at: {new Date(output.timestamp).toISOString()}</small>\n  </footer>\n</div>\n    `.trim(),\n    /**\n     * Widget is accessible for callback invocations.\n     */\n    widgetAccessible: true,\n    /**\n     * Invocation status messages for OpenAI.\n     */\n    invocationStatus: {\n      invoking: 'Processing request...',\n      invoked: 'Request completed',\n    },\n    /**\n     * Content Security Policy configuration.\n     */\n    csp: {\n      connectDomains: ['https://api.example.com'],\n      resourceDomains: ['https://cdn.example.com'],\n    },\n    /**\n     * Display mode for the widget.\n     */\n    displayMode: 'inline' as const,\n    /**\n     * Prefers border around the widget.\n     */\n    prefersBorder: true,\n    /**\n     * Custom sandbox domain.\n     */\n    sandboxDomain: 'sandbox.example.com',\n  },\n} as const;\n\n// ═══════════════════════════════════════════════════════════════════\n// TOOL EXECUTION HELPERS\n// ═══════════════════════════════════════════════════════════════════\n\n/**\n * Generate output for the basic UI tool.\n */\nexport function generateBasicUIToolOutput(input: z.infer<typeof basicUIToolInputSchema>) {\n  return {\n    message: `Hello, ${input.name}!`,\n    timestamp: Date.now(),\n  };\n}\n\n/**\n * Generate output for the full UI tool.\n */\nexport function generateFullUIToolOutput(input: z.infer<typeof fullUIToolInputSchema>) {\n  const items: string[] = [];\n  for (let i = 1; i <= input.count; i++) {\n    items.push(`Item ${i}`);\n  }\n  return {\n    message: `Hello, ${input.name}! You requested ${input.count} item(s).`,\n    count: input.count,\n    items,\n    timestamp: Date.now(),\n  };\n}\n\n// ═══════════════════════════════════════════════════════════════════\n// EXPECTED META KEYS\n// ═══════════════════════════════════════════════════════════════════\n\n/**\n * Expected meta keys for OpenAI platform in tools/list response.\n */\nexport const EXPECTED_OPENAI_TOOLS_LIST_META_KEYS = [\n  'openai/outputTemplate',\n  'openai/resultCanProduceWidget',\n  'openai/widgetAccessible',\n] as const;\n\n/**\n * Expected meta keys for OpenAI platform in tools/call response.\n */\nexport const EXPECTED_OPENAI_TOOL_CALL_META_KEYS = ['openai/html', 'openai/mimeType', 'openai/type'] as const;\n\n/**\n * Expected meta keys for ext-apps platform in tools/list response (SEP-1865).\n */\nexport const EXPECTED_EXTAPPS_TOOLS_LIST_META_KEYS = ['ui/resourceUri', 'ui/mimeType', 'ui/cdn', 'ui/type'] as const;\n\n/**\n * Expected meta keys for ext-apps platform in tools/call response (SEP-1865).\n */\nexport const EXPECTED_EXTAPPS_TOOL_CALL_META_KEYS = ['ui/html', 'ui/mimeType', 'ui/type'] as const;\n\n/**\n * Expected meta keys for FrontMCP platforms in tools/list response (Claude, Cursor, etc.).\n */\nexport const EXPECTED_FRONTMCP_TOOLS_LIST_META_KEYS = [\n  'frontmcp/outputTemplate',\n  'frontmcp/resultCanProduceWidget',\n  'ui/cdn',\n  'ui/type',\n] as const;\n\n/**\n * Expected meta keys for FrontMCP platforms in tools/call response (Claude, Cursor, etc.).\n */\nexport const EXPECTED_FRONTMCP_TOOL_CALL_META_KEYS = [\n  'frontmcp/html',\n  'frontmcp/mimeType',\n  'ui/html',\n  'ui/mimeType',\n] as const;\n"]}

package/src/expect.d.ts

@@ -17,29 +17,30 @@
  * ```
  */
 import { expect as jestExpect } from '@jest/globals';
+import type { Matchers } from 'expect';
 import type { McpMatchers } from './matchers/matcher-types';
 /**
  * Extended Jest matchers interface that includes MCP matchers
  */
-type McpExpectMatchers<R = void> = jest.Matchers<R> & McpMatchers<R> & {
+type McpExpectMatchers<R extends void | Promise<void>, T = unknown> = Matchers<R, T> & McpMatchers<R> & {
     /**
      * Inverts the matchers that follow
      */
-    not: jest.Matchers<R> & McpMatchers<R>;
+    not: Matchers<R, T> & McpMatchers<R>;
     /**
      * Used to access matchers that are resolved asynchronously
      */
-    resolves: jest.Matchers<Promise<R>> & McpMatchers<Promise<R>>;
+    resolves: Matchers<Promise<void>, T> & McpMatchers<Promise<void>>;
     /**
      * Used to access matchers that are rejected asynchronously
      */
-    rejects: jest.Matchers<Promise<R>> & McpMatchers<Promise<R>>;
+    rejects: Matchers<Promise<void>, T> & McpMatchers<Promise<void>>;
 };
 /**
  * Extended expect interface with MCP matchers
  */
 interface McpExpect {
-    <T = unknown>(actual: T): McpExpectMatchers<T>;
+    <T = unknown>(actual: T): McpExpectMatchers<void, T>;
     anything(): ReturnType<typeof jestExpect.anything>;
     any(classType: unknown): ReturnType<typeof jestExpect.any>;
     arrayContaining<E = unknown>(arr: readonly E[]): ReturnType<typeof jestExpect.arrayContaining>;

package/src/expect.js.map

@@ -1 +1 @@
-{"version":3,"file":"expect.js","sourceRoot":"","sources":["../../src/expect.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;AAEH,2CAAqD;AAoDrD;;;;;;GAMG;AACU,QAAA,MAAM,GAAG,gBAAkC,CAAC","sourcesContent":["/**\n * @file expect.ts\n * @description Pre-typed expect export with MCP custom matchers\n *\n * This is the Playwright-style approach - instead of relying on global type\n * augmentation (which can be fragile across monorepos and path mappings),\n * we export a properly typed expect function that includes all MCP matchers.\n *\n * @example\n * ```typescript\n * import { test, expect } from '@frontmcp/testing';\n *\n * test('tools are available', async ({ mcp }) => {\n *   const tools = await mcp.tools.list();\n *   expect(tools).toContainTool('my-tool'); // Properly typed!\n * });\n * ```\n */\n\nimport { expect as jestExpect } from '@jest/globals';\nimport type { McpMatchers } from './matchers/matcher-types';\n\n/**\n * Extended Jest matchers interface that includes MCP matchers\n */\ntype McpExpectMatchers<R = void> = jest.Matchers<R> &\n  McpMatchers<R> & {\n    /**\n     * Inverts the matchers that follow\n     */\n    not: jest.Matchers<R> & McpMatchers<R>;\n\n    /**\n     * Used to access matchers that are resolved asynchronously\n     */\n    resolves: jest.Matchers<Promise<R>> & McpMatchers<Promise<R>>;\n\n    /**\n     * Used to access matchers that are rejected asynchronously\n     */\n    rejects: jest.Matchers<Promise<R>> & McpMatchers<Promise<R>>;\n  };\n\n/**\n * Extended expect interface with MCP matchers\n */\ninterface McpExpect {\n  <T = unknown>(actual: T): McpExpectMatchers<T>;\n\n  // Asymmetric matchers\n  anything(): ReturnType<typeof jestExpect.anything>;\n  any(classType: unknown): ReturnType<typeof jestExpect.any>;\n  arrayContaining<E = unknown>(arr: readonly E[]): ReturnType<typeof jestExpect.arrayContaining>;\n  objectContaining<E = Record<string, unknown>>(obj: E): ReturnType<typeof jestExpect.objectContaining>;\n  stringContaining(str: string): ReturnType<typeof jestExpect.stringContaining>;\n  stringMatching(str: string | RegExp): ReturnType<typeof jestExpect.stringMatching>;\n\n  // expect.not\n  not: {\n    arrayContaining<E = unknown>(arr: readonly E[]): ReturnType<typeof jestExpect.not.arrayContaining>;\n    objectContaining<E = Record<string, unknown>>(obj: E): ReturnType<typeof jestExpect.not.objectContaining>;\n    stringContaining(str: string): ReturnType<typeof jestExpect.not.stringContaining>;\n    stringMatching(str: string | RegExp): ReturnType<typeof jestExpect.not.stringMatching>;\n  };\n\n  // Utilities\n  extend(matchers: Record<string, unknown>): void;\n  assertions(num: number): void;\n  hasAssertions(): void;\n}\n\n/**\n * Pre-typed expect with MCP custom matchers included\n *\n * This approach (similar to Playwright's) provides type safety without\n * relying on global TypeScript namespace augmentation, which can be\n * problematic in monorepo setups with path mappings.\n */\nexport const expect = jestExpect as unknown as McpExpect;\n"]}
+{"version":3,"file":"expect.js","sourceRoot":"","sources":["../../src/expect.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;AAEH,2CAAqD;AAqDrD;;;;;;GAMG;AACU,QAAA,MAAM,GAAG,gBAAkC,CAAC","sourcesContent":["/**\n * @file expect.ts\n * @description Pre-typed expect export with MCP custom matchers\n *\n * This is the Playwright-style approach - instead of relying on global type\n * augmentation (which can be fragile across monorepos and path mappings),\n * we export a properly typed expect function that includes all MCP matchers.\n *\n * @example\n * ```typescript\n * import { test, expect } from '@frontmcp/testing';\n *\n * test('tools are available', async ({ mcp }) => {\n *   const tools = await mcp.tools.list();\n *   expect(tools).toContainTool('my-tool'); // Properly typed!\n * });\n * ```\n */\n\nimport { expect as jestExpect } from '@jest/globals';\nimport type { Matchers } from 'expect';\nimport type { McpMatchers } from './matchers/matcher-types';\n\n/**\n * Extended Jest matchers interface that includes MCP matchers\n */\ntype McpExpectMatchers<R extends void | Promise<void>, T = unknown> = Matchers<R, T> &\n  McpMatchers<R> & {\n    /**\n     * Inverts the matchers that follow\n     */\n    not: Matchers<R, T> & McpMatchers<R>;\n\n    /**\n     * Used to access matchers that are resolved asynchronously\n     */\n    resolves: Matchers<Promise<void>, T> & McpMatchers<Promise<void>>;\n\n    /**\n     * Used to access matchers that are rejected asynchronously\n     */\n    rejects: Matchers<Promise<void>, T> & McpMatchers<Promise<void>>;\n  };\n\n/**\n * Extended expect interface with MCP matchers\n */\ninterface McpExpect {\n  <T = unknown>(actual: T): McpExpectMatchers<void, T>;\n\n  // Asymmetric matchers\n  anything(): ReturnType<typeof jestExpect.anything>;\n  any(classType: unknown): ReturnType<typeof jestExpect.any>;\n  arrayContaining<E = unknown>(arr: readonly E[]): ReturnType<typeof jestExpect.arrayContaining>;\n  objectContaining<E = Record<string, unknown>>(obj: E): ReturnType<typeof jestExpect.objectContaining>;\n  stringContaining(str: string): ReturnType<typeof jestExpect.stringContaining>;\n  stringMatching(str: string | RegExp): ReturnType<typeof jestExpect.stringMatching>;\n\n  // expect.not\n  not: {\n    arrayContaining<E = unknown>(arr: readonly E[]): ReturnType<typeof jestExpect.not.arrayContaining>;\n    objectContaining<E = Record<string, unknown>>(obj: E): ReturnType<typeof jestExpect.not.objectContaining>;\n    stringContaining(str: string): ReturnType<typeof jestExpect.not.stringContaining>;\n    stringMatching(str: string | RegExp): ReturnType<typeof jestExpect.not.stringMatching>;\n  };\n\n  // Utilities\n  extend(matchers: Record<string, unknown>): void;\n  assertions(num: number): void;\n  hasAssertions(): void;\n}\n\n/**\n * Pre-typed expect with MCP custom matchers included\n *\n * This approach (similar to Playwright's) provides type safety without\n * relying on global TypeScript namespace augmentation, which can be\n * problematic in monorepo setups with path mappings.\n */\nexport const expect = jestExpect as unknown as McpExpect;\n"]}

package/src/fixtures/fixture-types.d.ts

@@ -3,6 +3,7 @@
  * @description Type definitions for test fixtures
  */
 import type { McpTestClient } from '../client/mcp-test-client';
+import type { McpTestClientBuilder } from '../client/mcp-test-client.builder';
 import type { JWK } from 'jose';
 /**
  * Configuration passed to test.use()
@@ -122,7 +123,25 @@ export interface ServerFixture {
     createClient(options?: {
         transport?: 'sse' | 'streamable-http';
         token?: string;
+        clientInfo?: {
+            name: string;
+            version: string;
+        };
     }): Promise<McpTestClient>;
+    /**
+     * Create a client builder for full customization.
+     * Use this when you need to set platform-specific capabilities.
+     *
+     * @example
+     * ```typescript
+     * const client = await server
+     *   .createClientBuilder()
+     *   .withTransport('streamable-http')
+     *   .withPlatform('ext-apps')  // Auto-sets clientInfo AND capabilities
+     *   .buildAndConnect();
+     * ```
+     */
+    createClientBuilder(): McpTestClientBuilder;
     /**
      * Restart the server
      */

package/src/fixtures/fixture-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"fixture-types.js","sourceRoot":"","sources":["../../../src/fixtures/fixture-types.ts"],"names":[],"mappings":";AAAA;;;GAGG","sourcesContent":["/**\n * @file fixture-types.ts\n * @description Type definitions for test fixtures\n */\n\nimport type { McpTestClient } from '../client/mcp-test-client';\nimport type { JWK } from 'jose';\n\n// ═══════════════════════════════════════════════════════════════════\n// TEST CONFIGURATION\n// ═══════════════════════════════════════════════════════════════════\n\n/**\n * Configuration passed to test.use()\n */\nexport interface TestConfig {\n  /** Server entry file path (e.g., './src/main.ts') */\n  server?: string;\n  /** Port to run server on (default: auto-select available port) */\n  port?: number;\n  /** Transport type (default: 'streamable-http') */\n  transport?: 'sse' | 'streamable-http';\n  /** Auth configuration for the server */\n  auth?: {\n    mode?: 'public' | 'orchestrated';\n    type?: 'local' | 'remote';\n  };\n  /**\n   * Enable public mode for the test client.\n   * When true, no Authorization header is sent and anonymous token is not requested.\n   * Use this for testing servers configured with `auth: { mode: 'public' }`.\n   */\n  publicMode?: boolean;\n  /** Server log level */\n  logLevel?: 'debug' | 'info' | 'warn' | 'error';\n  /** Environment variables to pass to the server */\n  env?: Record<string, string>;\n  /** Startup timeout in ms (default: 30000) */\n  startupTimeout?: number;\n  /** Base URL for connecting to an external/already running server */\n  baseUrl?: string;\n}\n\n// ═══════════════════════════════════════════════════════════════════\n// FIXTURE TYPES\n// ═══════════════════════════════════════════════════════════════════\n\n/**\n * Fixtures available in test functions\n */\nexport interface TestFixtures {\n  /** Auto-connected MCP client */\n  mcp: McpTestClient;\n  /** Token factory for auth testing */\n  auth: AuthFixture;\n  /** Server control */\n  server: ServerFixture;\n}\n\n/**\n * Auth fixture for creating and managing test tokens\n */\nexport interface AuthFixture {\n  /**\n   * Create a JWT token with the specified claims\n   */\n  createToken(options: {\n    sub: string;\n    scopes?: string[];\n    email?: string;\n    name?: string;\n    claims?: Record<string, unknown>;\n    expiresIn?: number;\n  }): Promise<string>;\n\n  /**\n   * Create an expired token (for testing token expiration)\n   */\n  createExpiredToken(options: { sub: string }): Promise<string>;\n\n  /**\n   * Create a token with an invalid signature (for testing signature validation)\n   */\n  createInvalidToken(options: { sub: string }): string;\n\n  /**\n   * Pre-built test users with common permission sets\n   */\n  users: {\n    admin: TestUser;\n    user: TestUser;\n    readOnly: TestUser;\n  };\n\n  /**\n   * Get the public JWKS for verifying tokens\n   */\n  getJwks(): Promise<{ keys: JWK[] }>;\n\n  /**\n   * Get the issuer URL\n   */\n  getIssuer(): string;\n\n  /**\n   * Get the audience\n   */\n  getAudience(): string;\n}\n\n/**\n * Pre-defined test user\n */\nexport interface TestUser {\n  sub: string;\n  scopes: string[];\n  email?: string;\n  name?: string;\n}\n\n/**\n * Server fixture for controlling the test server\n */\nexport interface ServerFixture {\n  /**\n   * Server information\n   */\n  info: {\n    baseUrl: string;\n    port: number;\n    pid?: number;\n  };\n\n  /**\n   * Create an additional MCP client connected to this server\n   */\n  createClient(options?: { transport?: 'sse' | 'streamable-http'; token?: string }): Promise<McpTestClient>;\n\n  /**\n   * Restart the server\n   */\n  restart(): Promise<void>;\n\n  /**\n   * Get captured server logs\n   */\n  getLogs(): string[];\n\n  /**\n   * Clear captured server logs\n   */\n  clearLogs(): void;\n}\n\n// ═══════════════════════════════════════════════════════════════════\n// TEST FUNCTION TYPE\n// ═══════════════════════════════════════════════════════════════════\n\n/**\n * Test function that receives fixtures\n */\nexport type TestFn = (fixtures: TestFixtures) => Promise<void> | void;\n\n/**\n * Enhanced test function with fixture support\n */\nexport interface TestWithFixtures {\n  (name: string, fn: TestFn): void;\n\n  /** Configure fixtures for this test file/suite */\n  use(config: TestConfig): void;\n\n  /** Create a describe block */\n  describe: typeof describe;\n\n  /** Run before all tests in the file */\n  beforeAll: typeof beforeAll;\n\n  /** Run before each test */\n  beforeEach: typeof beforeEach;\n\n  /** Run after each test */\n  afterEach: typeof afterEach;\n\n  /** Run after all tests in the file */\n  afterAll: typeof afterAll;\n\n  /** Skip a test */\n  skip(name: string, fn: TestFn): void;\n\n  /** Run only this test */\n  only(name: string, fn: TestFn): void;\n\n  /** Mark test as todo (not implemented) */\n  todo(name: string): void;\n}\n"]}
+{"version":3,"file":"fixture-types.js","sourceRoot":"","sources":["../../../src/fixtures/fixture-types.ts"],"names":[],"mappings":";AAAA;;;GAGG","sourcesContent":["/**\n * @file fixture-types.ts\n * @description Type definitions for test fixtures\n */\n\nimport type { McpTestClient } from '../client/mcp-test-client';\nimport type { McpTestClientBuilder } from '../client/mcp-test-client.builder';\nimport type { JWK } from 'jose';\n\n// ═══════════════════════════════════════════════════════════════════\n// TEST CONFIGURATION\n// ═══════════════════════════════════════════════════════════════════\n\n/**\n * Configuration passed to test.use()\n */\nexport interface TestConfig {\n  /** Server entry file path (e.g., './src/main.ts') */\n  server?: string;\n  /** Port to run server on (default: auto-select available port) */\n  port?: number;\n  /** Transport type (default: 'streamable-http') */\n  transport?: 'sse' | 'streamable-http';\n  /** Auth configuration for the server */\n  auth?: {\n    mode?: 'public' | 'orchestrated';\n    type?: 'local' | 'remote';\n  };\n  /**\n   * Enable public mode for the test client.\n   * When true, no Authorization header is sent and anonymous token is not requested.\n   * Use this for testing servers configured with `auth: { mode: 'public' }`.\n   */\n  publicMode?: boolean;\n  /** Server log level */\n  logLevel?: 'debug' | 'info' | 'warn' | 'error';\n  /** Environment variables to pass to the server */\n  env?: Record<string, string>;\n  /** Startup timeout in ms (default: 30000) */\n  startupTimeout?: number;\n  /** Base URL for connecting to an external/already running server */\n  baseUrl?: string;\n}\n\n// ═══════════════════════════════════════════════════════════════════\n// FIXTURE TYPES\n// ═══════════════════════════════════════════════════════════════════\n\n/**\n * Fixtures available in test functions\n */\nexport interface TestFixtures {\n  /** Auto-connected MCP client */\n  mcp: McpTestClient;\n  /** Token factory for auth testing */\n  auth: AuthFixture;\n  /** Server control */\n  server: ServerFixture;\n}\n\n/**\n * Auth fixture for creating and managing test tokens\n */\nexport interface AuthFixture {\n  /**\n   * Create a JWT token with the specified claims\n   */\n  createToken(options: {\n    sub: string;\n    scopes?: string[];\n    email?: string;\n    name?: string;\n    claims?: Record<string, unknown>;\n    expiresIn?: number;\n  }): Promise<string>;\n\n  /**\n   * Create an expired token (for testing token expiration)\n   */\n  createExpiredToken(options: { sub: string }): Promise<string>;\n\n  /**\n   * Create a token with an invalid signature (for testing signature validation)\n   */\n  createInvalidToken(options: { sub: string }): string;\n\n  /**\n   * Pre-built test users with common permission sets\n   */\n  users: {\n    admin: TestUser;\n    user: TestUser;\n    readOnly: TestUser;\n  };\n\n  /**\n   * Get the public JWKS for verifying tokens\n   */\n  getJwks(): Promise<{ keys: JWK[] }>;\n\n  /**\n   * Get the issuer URL\n   */\n  getIssuer(): string;\n\n  /**\n   * Get the audience\n   */\n  getAudience(): string;\n}\n\n/**\n * Pre-defined test user\n */\nexport interface TestUser {\n  sub: string;\n  scopes: string[];\n  email?: string;\n  name?: string;\n}\n\n/**\n * Server fixture for controlling the test server\n */\nexport interface ServerFixture {\n  /**\n   * Server information\n   */\n  info: {\n    baseUrl: string;\n    port: number;\n    pid?: number;\n  };\n\n  /**\n   * Create an additional MCP client connected to this server\n   */\n  createClient(options?: {\n    transport?: 'sse' | 'streamable-http';\n    token?: string;\n    clientInfo?: { name: string; version: string };\n  }): Promise<McpTestClient>;\n\n  /**\n   * Create a client builder for full customization.\n   * Use this when you need to set platform-specific capabilities.\n   *\n   * @example\n   * ```typescript\n   * const client = await server\n   *   .createClientBuilder()\n   *   .withTransport('streamable-http')\n   *   .withPlatform('ext-apps')  // Auto-sets clientInfo AND capabilities\n   *   .buildAndConnect();\n   * ```\n   */\n  createClientBuilder(): McpTestClientBuilder;\n\n  /**\n   * Restart the server\n   */\n  restart(): Promise<void>;\n\n  /**\n   * Get captured server logs\n   */\n  getLogs(): string[];\n\n  /**\n   * Clear captured server logs\n   */\n  clearLogs(): void;\n}\n\n// ═══════════════════════════════════════════════════════════════════\n// TEST FUNCTION TYPE\n// ═══════════════════════════════════════════════════════════════════\n\n/**\n * Test function that receives fixtures\n */\nexport type TestFn = (fixtures: TestFixtures) => Promise<void> | void;\n\n/**\n * Enhanced test function with fixture support\n */\nexport interface TestWithFixtures {\n  (name: string, fn: TestFn): void;\n\n  /** Configure fixtures for this test file/suite */\n  use(config: TestConfig): void;\n\n  /** Create a describe block */\n  describe: typeof describe;\n\n  /** Run before all tests in the file */\n  beforeAll: typeof beforeAll;\n\n  /** Run before each test */\n  beforeEach: typeof beforeEach;\n\n  /** Run after each test */\n  afterEach: typeof afterEach;\n\n  /** Run after all tests in the file */\n  afterAll: typeof afterAll;\n\n  /** Skip a test */\n  skip(name: string, fn: TestFn): void;\n\n  /** Run only this test */\n  only(name: string, fn: TestFn): void;\n\n  /** Mark test as todo (not implemented) */\n  todo(name: string): void;\n}\n"]}

package/src/fixtures/test-fixture.d.ts

@@ -30,8 +30,10 @@ declare function initializeSharedResources(): Promise<void>;
 declare function createTestFixtures(): Promise<TestFixtures>;
 /**
  * Clean up fixtures after a single test
+ * @param fixtures - The test fixtures to clean up
+ * @param testFailed - Whether the test failed (to output server logs)
  */
-declare function cleanupTestFixtures(fixtures: TestFixtures): Promise<void>;
+declare function cleanupTestFixtures(fixtures: TestFixtures, _testFailed?: boolean): Promise<void>;
 /**
  * Clean up shared resources after all tests in a file
  */

package/src/fixtures/test-fixture.js

@@ -27,6 +27,7 @@ exports.cleanupTestFixtures = cleanupTestFixtures;
 exports.initializeSharedResources = initializeSharedResources;
 exports.cleanupSharedResources = cleanupSharedResources;
 const mcp_test_client_1 = require("../client/mcp-test-client");
+const mcp_test_client_builder_1 = require("../client/mcp-test-client.builder");
 const token_factory_1 = require("../auth/token-factory");
 const test_server_1 = require("../server/test-server");
 // ═══════════════════════════════════════════════════════════════════
@@ -98,8 +99,10 @@ async function createTestFixtures() {
 }
 /**
  * Clean up fixtures after a single test
+ * @param fixtures - The test fixtures to clean up
+ * @param testFailed - Whether the test failed (to output server logs)
  */
-async function cleanupTestFixtures(fixtures) {
+async function cleanupTestFixtures(fixtures, _testFailed = false) {
     // Disconnect client
     if (fixtures.mcp.isConnected()) {
         await fixtures.mcp.disconnect();
@@ -174,12 +177,25 @@ function createServerFixture(server) {
     return {
         info: server.info,
         createClient: async (opts) => {
+            // Inherit publicMode from current config when creating additional clients
+            // This ensures all clients connect to a public server correctly
             return mcp_test_client_1.McpTestClient.create({
                 baseUrl: server.info.baseUrl,
                 transport: opts?.transport ?? 'streamable-http',
                 auth: opts?.token ? { token: opts.token } : undefined,
+                clientInfo: opts?.clientInfo,
+                publicMode: currentConfig.publicMode,
             }).buildAndConnect();
         },
+        createClientBuilder: () => {
+            // Return a pre-configured builder with the server's base URL and publicMode
+            // This allows full customization including platform-specific capabilities
+            const builder = new mcp_test_client_builder_1.McpTestClientBuilder({
+                baseUrl: server.info.baseUrl,
+                publicMode: currentConfig.publicMode,
+            });
+            return builder;
+        },
         restart: () => server.restart(),
         getLogs: () => server.getLogs(),
         clearLogs: () => server.clearLogs(),
@@ -205,11 +221,16 @@ function resolveServerCommand(server) {
 function testWithFixtures(name, fn) {
     it(name, async () => {
         const fixtures = await createTestFixtures();
+        let testFailed = false;
         try {
             await fn(fixtures);
         }
+        catch (error) {
+            testFailed = true;
+            throw error;
+        }
         finally {
-            await cleanupTestFixtures(fixtures);
+            await cleanupTestFixtures(fixtures, testFailed);
         }
     });
 }
@@ -231,11 +252,16 @@ function use(config) {
 function skip(name, fn) {
     it.skip(name, async () => {
         const fixtures = await createTestFixtures();
+        let testFailed = false;
         try {
             await fn(fixtures);
         }
+        catch (error) {
+            testFailed = true;
+            throw error;
+        }
         finally {
-            await cleanupTestFixtures(fixtures);
+            await cleanupTestFixtures(fixtures, testFailed);
         }
     });
 }
@@ -245,11 +271,16 @@ function skip(name, fn) {
 function only(name, fn) {
     it.only(name, async () => {
         const fixtures = await createTestFixtures();
+        let testFailed = false;
         try {
             await fn(fixtures);
         }
+        catch (error) {
+            testFailed = true;
+            throw error;
+        }
         finally {
-            await cleanupTestFixtures(fixtures);
+            await cleanupTestFixtures(fixtures, testFailed);
         }
     });
 }