@frontmcp/testing 0.5.0 → 0.6.0

package/src/platform/platform-client-info.d.ts

@@ -0,0 +1,97 @@
+/**
+ * @file platform-client-info.ts
+ * @description Client info, User-Agent mappings, and capabilities for each platform.
+ *
+ * These mappings enable platform detection in MCP servers via:
+ * - User-Agent header (most platforms)
+ * - Client capabilities (ext-apps via io.modelcontextprotocol/ui extension)
+ *
+ * @example
+ * ```typescript
+ * import { getPlatformClientInfo, getPlatformCapabilities } from '@frontmcp/testing';
+ *
+ * const client = McpTestClient.create({ baseUrl })
+ *   .withPlatform('ext-apps')  // Auto-sets clientInfo AND capabilities
+ *   .buildAndConnect();
+ * ```
+ */
+import type { TestPlatformType } from './platform-types';
+/**
+ * MCP Apps extension key used for ext-apps platform detection.
+ */
+export declare const MCP_APPS_EXTENSION_KEY: "io.modelcontextprotocol/ui";
+/**
+ * Client info for MCP initialization.
+ * Matches the Implementation type from @modelcontextprotocol/sdk.
+ */
+export interface TestClientInfo {
+    /** Client name (used for User-Agent header) */
+    name: string;
+    /** Client version */
+    version: string;
+}
+/**
+ * Get client info for a specific platform.
+ *
+ * These values are used to:
+ * 1. Set the clientInfo during MCP initialize
+ * 2. Generate the User-Agent header for platform detection
+ */
+export declare function getPlatformClientInfo(platform: TestPlatformType): TestClientInfo;
+/**
+ * Build User-Agent header string from client info.
+ *
+ * Format: "{name}/{version}"
+ *
+ * Examples:
+ * - "ChatGPT/1.0" (OpenAI)
+ * - "mcp-ext-apps/1.0" (ext-apps)
+ * - "claude-desktop/1.0" (Claude)
+ */
+export declare function buildUserAgent(clientInfo: TestClientInfo): string;
+/**
+ * Get the User-Agent string for a platform.
+ */
+export declare function getPlatformUserAgent(platform: TestPlatformType): string;
+/**
+ * Platform detection patterns for parsing User-Agent headers.
+ * These are the patterns that MCP servers use to detect platforms.
+ *
+ * Note: ext-apps is detected via capabilities, not User-Agent.
+ */
+export declare const PLATFORM_DETECTION_PATTERNS: Record<TestPlatformType, RegExp>;
+/**
+ * MCP Apps extension capability for ext-apps platform detection.
+ */
+export interface McpAppsExtension {
+    /** Supported MIME types */
+    mimeTypes?: string[];
+}
+/**
+ * Experimental capabilities for MCP clients.
+ */
+export interface ExperimentalCapabilities {
+    [MCP_APPS_EXTENSION_KEY]?: McpAppsExtension;
+    [key: string]: unknown;
+}
+/**
+ * Client capabilities sent during MCP initialization.
+ */
+export interface TestClientCapabilities {
+    sampling?: Record<string, unknown>;
+    experimental?: ExperimentalCapabilities;
+}
+/**
+ * Get client capabilities for a specific platform.
+ *
+ * Currently only ext-apps requires special capabilities:
+ * - ext-apps: Sets io.modelcontextprotocol/ui extension for platform detection
+ *
+ * @param platform - The platform type
+ * @returns Client capabilities to send during initialization
+ */
+export declare function getPlatformCapabilities(platform: TestPlatformType): TestClientCapabilities;
+/**
+ * Check if a platform requires capability-based detection (vs User-Agent).
+ */
+export declare function requiresCapabilityDetection(platform: TestPlatformType): boolean;

package/src/platform/platform-client-info.js

@@ -0,0 +1,155 @@
+"use strict";
+/**
+ * @file platform-client-info.ts
+ * @description Client info, User-Agent mappings, and capabilities for each platform.
+ *
+ * These mappings enable platform detection in MCP servers via:
+ * - User-Agent header (most platforms)
+ * - Client capabilities (ext-apps via io.modelcontextprotocol/ui extension)
+ *
+ * @example
+ * ```typescript
+ * import { getPlatformClientInfo, getPlatformCapabilities } from '@frontmcp/testing';
+ *
+ * const client = McpTestClient.create({ baseUrl })
+ *   .withPlatform('ext-apps')  // Auto-sets clientInfo AND capabilities
+ *   .buildAndConnect();
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PLATFORM_DETECTION_PATTERNS = exports.MCP_APPS_EXTENSION_KEY = void 0;
+exports.getPlatformClientInfo = getPlatformClientInfo;
+exports.buildUserAgent = buildUserAgent;
+exports.getPlatformUserAgent = getPlatformUserAgent;
+exports.getPlatformCapabilities = getPlatformCapabilities;
+exports.requiresCapabilityDetection = requiresCapabilityDetection;
+/**
+ * MCP Apps extension key used for ext-apps platform detection.
+ */
+exports.MCP_APPS_EXTENSION_KEY = 'io.modelcontextprotocol/ui';
+/**
+ * Get client info for a specific platform.
+ *
+ * These values are used to:
+ * 1. Set the clientInfo during MCP initialize
+ * 2. Generate the User-Agent header for platform detection
+ */
+function getPlatformClientInfo(platform) {
+    switch (platform) {
+        case 'openai':
+            return {
+                name: 'ChatGPT',
+                version: '1.0',
+            };
+        case 'ext-apps':
+            return {
+                name: 'mcp-ext-apps',
+                version: '1.0',
+            };
+        case 'claude':
+            return {
+                name: 'claude-desktop',
+                version: '1.0',
+            };
+        case 'cursor':
+            return {
+                name: 'cursor',
+                version: '1.0',
+            };
+        case 'continue':
+            return {
+                name: 'continue',
+                version: '1.0',
+            };
+        case 'cody':
+            return {
+                name: 'cody',
+                version: '1.0',
+            };
+        case 'gemini':
+            return {
+                name: 'gemini',
+                version: '1.0',
+            };
+        case 'generic-mcp':
+            return {
+                name: 'generic-mcp-client',
+                version: '1.0',
+            };
+        case 'unknown':
+        default:
+            return {
+                name: 'mcp-test-client',
+                version: '1.0',
+            };
+    }
+}
+/**
+ * Build User-Agent header string from client info.
+ *
+ * Format: "{name}/{version}"
+ *
+ * Examples:
+ * - "ChatGPT/1.0" (OpenAI)
+ * - "mcp-ext-apps/1.0" (ext-apps)
+ * - "claude-desktop/1.0" (Claude)
+ */
+function buildUserAgent(clientInfo) {
+    return `${clientInfo.name}/${clientInfo.version}`;
+}
+/**
+ * Get the User-Agent string for a platform.
+ */
+function getPlatformUserAgent(platform) {
+    return buildUserAgent(getPlatformClientInfo(platform));
+}
+/**
+ * Platform detection patterns for parsing User-Agent headers.
+ * These are the patterns that MCP servers use to detect platforms.
+ *
+ * Note: ext-apps is detected via capabilities, not User-Agent.
+ */
+exports.PLATFORM_DETECTION_PATTERNS = {
+    openai: /chatgpt/i,
+    'ext-apps': /mcp-ext-apps/i, // Note: Actual detection uses capabilities
+    claude: /claude|claude-desktop/i,
+    cursor: /cursor/i,
+    continue: /continue/i,
+    cody: /cody/i,
+    gemini: /gemini/i,
+    'generic-mcp': /generic-mcp/i,
+    unknown: /.*/, // Matches anything (fallback)
+};
+/**
+ * Get client capabilities for a specific platform.
+ *
+ * Currently only ext-apps requires special capabilities:
+ * - ext-apps: Sets io.modelcontextprotocol/ui extension for platform detection
+ *
+ * @param platform - The platform type
+ * @returns Client capabilities to send during initialization
+ */
+function getPlatformCapabilities(platform) {
+    const baseCapabilities = {
+        sampling: {},
+    };
+    // ext-apps requires the io.modelcontextprotocol/ui extension for detection
+    if (platform === 'ext-apps') {
+        return {
+            ...baseCapabilities,
+            experimental: {
+                [exports.MCP_APPS_EXTENSION_KEY]: {
+                    mimeTypes: ['text/html+mcp'],
+                },
+            },
+        };
+    }
+    return baseCapabilities;
+}
+/**
+ * Check if a platform requires capability-based detection (vs User-Agent).
+ */
+function requiresCapabilityDetection(platform) {
+    return platform === 'ext-apps';
+}
+//# sourceMappingURL=platform-client-info.js.map

package/src/platform/platform-client-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-client-info.js","sourceRoot":"","sources":["../../../src/platform/platform-client-info.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;;AA2BH,sDAiDC;AAYD,wCAEC;AAKD,oDAEC;AAyDD,0DAkBC;AAKD,kEAEC;AA/KD;;GAEG;AACU,QAAA,sBAAsB,GAAG,4BAAqC,CAAC;AAa5E;;;;;;GAMG;AACH,SAAgB,qBAAqB,CAAC,QAA0B;IAC9D,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,QAAQ;YACX,OAAO;gBACL,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;aACf,CAAC;QACJ,KAAK,UAAU;YACb,OAAO;gBACL,IAAI,EAAE,cAAc;gBACpB,OAAO,EAAE,KAAK;aACf,CAAC;QACJ,KAAK,QAAQ;YACX,OAAO;gBACL,IAAI,EAAE,gBAAgB;gBACtB,OAAO,EAAE,KAAK;aACf,CAAC;QACJ,KAAK,QAAQ;YACX,OAAO;gBACL,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,KAAK;aACf,CAAC;QACJ,KAAK,UAAU;YACb,OAAO;gBACL,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,KAAK;aACf,CAAC;QACJ,KAAK,MAAM;YACT,OAAO;gBACL,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,KAAK;aACf,CAAC;QACJ,KAAK,QAAQ;YACX,OAAO;gBACL,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,KAAK;aACf,CAAC;QACJ,KAAK,aAAa;YAChB,OAAO;gBACL,IAAI,EAAE,oBAAoB;gBAC1B,OAAO,EAAE,KAAK;aACf,CAAC;QACJ,KAAK,SAAS,CAAC;QACf;YACE,OAAO;gBACL,IAAI,EAAE,iBAAiB;gBACvB,OAAO,EAAE,KAAK;aACf,CAAC;IACN,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,cAAc,CAAC,UAA0B;IACvD,OAAO,GAAG,UAAU,CAAC,IAAI,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,SAAgB,oBAAoB,CAAC,QAA0B;IAC7D,OAAO,cAAc,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC,CAAC;AACzD,CAAC;AAED;;;;;GAKG;AACU,QAAA,2BAA2B,GAAqC;IAC3E,MAAM,EAAE,UAAU;IAClB,UAAU,EAAE,eAAe,EAAE,2CAA2C;IACxE,MAAM,EAAE,wBAAwB;IAChC,MAAM,EAAE,SAAS;IACjB,QAAQ,EAAE,WAAW;IACrB,IAAI,EAAE,OAAO;IACb,MAAM,EAAE,SAAS;IACjB,aAAa,EAAE,cAAc;IAC7B,OAAO,EAAE,IAAI,EAAE,8BAA8B;CAC9C,CAAC;AA8BF;;;;;;;;GAQG;AACH,SAAgB,uBAAuB,CAAC,QAA0B;IAChE,MAAM,gBAAgB,GAA2B;QAC/C,QAAQ,EAAE,EAAE;KACb,CAAC;IAEF,2EAA2E;IAC3E,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;QAC5B,OAAO;YACL,GAAG,gBAAgB;YACnB,YAAY,EAAE;gBACZ,CAAC,8BAAsB,CAAC,EAAE;oBACxB,SAAS,EAAE,CAAC,eAAe,CAAC;iBAC7B;aACF;SACF,CAAC;IACJ,CAAC;IAED,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,SAAgB,2BAA2B,CAAC,QAA0B;IACpE,OAAO,QAAQ,KAAK,UAAU,CAAC;AACjC,CAAC","sourcesContent":["/**\n * @file platform-client-info.ts\n * @description Client info, User-Agent mappings, and capabilities for each platform.\n *\n * These mappings enable platform detection in MCP servers via:\n * - User-Agent header (most platforms)\n * - Client capabilities (ext-apps via io.modelcontextprotocol/ui extension)\n *\n * @example\n * ```typescript\n * import { getPlatformClientInfo, getPlatformCapabilities } from '@frontmcp/testing';\n *\n * const client = McpTestClient.create({ baseUrl })\n *   .withPlatform('ext-apps')  // Auto-sets clientInfo AND capabilities\n *   .buildAndConnect();\n * ```\n */\n\nimport type { TestPlatformType } from './platform-types';\n\n/**\n * MCP Apps extension key used for ext-apps platform detection.\n */\nexport const MCP_APPS_EXTENSION_KEY = 'io.modelcontextprotocol/ui' as const;\n\n/**\n * Client info for MCP initialization.\n * Matches the Implementation type from @modelcontextprotocol/sdk.\n */\nexport interface TestClientInfo {\n  /** Client name (used for User-Agent header) */\n  name: string;\n  /** Client version */\n  version: string;\n}\n\n/**\n * Get client info for a specific platform.\n *\n * These values are used to:\n * 1. Set the clientInfo during MCP initialize\n * 2. Generate the User-Agent header for platform detection\n */\nexport function getPlatformClientInfo(platform: TestPlatformType): TestClientInfo {\n  switch (platform) {\n    case 'openai':\n      return {\n        name: 'ChatGPT',\n        version: '1.0',\n      };\n    case 'ext-apps':\n      return {\n        name: 'mcp-ext-apps',\n        version: '1.0',\n      };\n    case 'claude':\n      return {\n        name: 'claude-desktop',\n        version: '1.0',\n      };\n    case 'cursor':\n      return {\n        name: 'cursor',\n        version: '1.0',\n      };\n    case 'continue':\n      return {\n        name: 'continue',\n        version: '1.0',\n      };\n    case 'cody':\n      return {\n        name: 'cody',\n        version: '1.0',\n      };\n    case 'gemini':\n      return {\n        name: 'gemini',\n        version: '1.0',\n      };\n    case 'generic-mcp':\n      return {\n        name: 'generic-mcp-client',\n        version: '1.0',\n      };\n    case 'unknown':\n    default:\n      return {\n        name: 'mcp-test-client',\n        version: '1.0',\n      };\n  }\n}\n\n/**\n * Build User-Agent header string from client info.\n *\n * Format: \"{name}/{version}\"\n *\n * Examples:\n * - \"ChatGPT/1.0\" (OpenAI)\n * - \"mcp-ext-apps/1.0\" (ext-apps)\n * - \"claude-desktop/1.0\" (Claude)\n */\nexport function buildUserAgent(clientInfo: TestClientInfo): string {\n  return `${clientInfo.name}/${clientInfo.version}`;\n}\n\n/**\n * Get the User-Agent string for a platform.\n */\nexport function getPlatformUserAgent(platform: TestPlatformType): string {\n  return buildUserAgent(getPlatformClientInfo(platform));\n}\n\n/**\n * Platform detection patterns for parsing User-Agent headers.\n * These are the patterns that MCP servers use to detect platforms.\n *\n * Note: ext-apps is detected via capabilities, not User-Agent.\n */\nexport const PLATFORM_DETECTION_PATTERNS: Record<TestPlatformType, RegExp> = {\n  openai: /chatgpt/i,\n  'ext-apps': /mcp-ext-apps/i, // Note: Actual detection uses capabilities\n  claude: /claude|claude-desktop/i,\n  cursor: /cursor/i,\n  continue: /continue/i,\n  cody: /cody/i,\n  gemini: /gemini/i,\n  'generic-mcp': /generic-mcp/i,\n  unknown: /.*/, // Matches anything (fallback)\n};\n\n// ═══════════════════════════════════════════════════════════════════\n// PLATFORM CAPABILITIES\n// ═══════════════════════════════════════════════════════════════════\n\n/**\n * MCP Apps extension capability for ext-apps platform detection.\n */\nexport interface McpAppsExtension {\n  /** Supported MIME types */\n  mimeTypes?: string[];\n}\n\n/**\n * Experimental capabilities for MCP clients.\n */\nexport interface ExperimentalCapabilities {\n  [MCP_APPS_EXTENSION_KEY]?: McpAppsExtension;\n  [key: string]: unknown;\n}\n\n/**\n * Client capabilities sent during MCP initialization.\n */\nexport interface TestClientCapabilities {\n  sampling?: Record<string, unknown>;\n  experimental?: ExperimentalCapabilities;\n}\n\n/**\n * Get client capabilities for a specific platform.\n *\n * Currently only ext-apps requires special capabilities:\n * - ext-apps: Sets io.modelcontextprotocol/ui extension for platform detection\n *\n * @param platform - The platform type\n * @returns Client capabilities to send during initialization\n */\nexport function getPlatformCapabilities(platform: TestPlatformType): TestClientCapabilities {\n  const baseCapabilities: TestClientCapabilities = {\n    sampling: {},\n  };\n\n  // ext-apps requires the io.modelcontextprotocol/ui extension for detection\n  if (platform === 'ext-apps') {\n    return {\n      ...baseCapabilities,\n      experimental: {\n        [MCP_APPS_EXTENSION_KEY]: {\n          mimeTypes: ['text/html+mcp'],\n        },\n      },\n    };\n  }\n\n  return baseCapabilities;\n}\n\n/**\n * Check if a platform requires capability-based detection (vs User-Agent).\n */\nexport function requiresCapabilityDetection(platform: TestPlatformType): boolean {\n  return platform === 'ext-apps';\n}\n"]}

package/src/platform/platform-types.d.ts

@@ -0,0 +1,72 @@
+/**
+ * @file platform-types.ts
+ * @description Platform type definitions for E2E testing.
+ *
+ * These types mirror the AIPlatformType from @frontmcp/ui/adapters
+ * for use in testing without creating a hard dependency.
+ *
+ * @example
+ * ```typescript
+ * import { TestPlatformType } from '@frontmcp/testing';
+ *
+ * const platform: TestPlatformType = 'openai';
+ * ```
+ */
+/**
+ * Supported AI platform types for testing.
+ *
+ * - `openai`: OpenAI ChatGPT (uses openai/* meta keys)
+ * - `ext-apps`: MCP Apps per SEP-1865 (uses ui/* meta keys)
+ * - `claude`: Claude Desktop (uses frontmcp/* + ui/* keys)
+ * - `cursor`: Cursor IDE (uses frontmcp/* + ui/* keys)
+ * - `continue`: Continue Dev (uses frontmcp/* + ui/* keys)
+ * - `cody`: Sourcegraph Cody (uses frontmcp/* + ui/* keys)
+ * - `gemini`: Google Gemini (uses frontmcp/* + ui/* keys)
+ * - `generic-mcp`: Generic MCP client (uses frontmcp/* + ui/* keys)
+ * - `unknown`: Unknown platform (uses frontmcp/* + ui/* keys)
+ */
+export type TestPlatformType = 'openai' | 'ext-apps' | 'claude' | 'cursor' | 'continue' | 'cody' | 'gemini' | 'generic-mcp' | 'unknown';
+/**
+ * Platform meta namespace used for tool responses.
+ *
+ * - `openai`: Uses `openai/*` keys only
+ * - `ui`: Uses `ui/*` keys only (ext-apps per SEP-1865)
+ * - `frontmcp`: Uses `frontmcp/*` + `ui/*` keys for compatibility
+ */
+export type PlatformMetaNamespace = 'openai' | 'ui' | 'frontmcp';
+/**
+ * Get the meta namespace for a platform type.
+ */
+export declare function getPlatformMetaNamespace(platform: TestPlatformType): PlatformMetaNamespace;
+/**
+ * Get the expected MIME type for a platform.
+ *
+ * - OpenAI uses `text/html+skybridge`
+ * - All other platforms use `text/html+mcp`
+ */
+export declare function getPlatformMimeType(platform: TestPlatformType): string;
+/**
+ * Check if a platform uses OpenAI-specific meta keys.
+ */
+export declare function isOpenAIPlatform(platform: TestPlatformType): boolean;
+/**
+ * Check if a platform is ext-apps (SEP-1865 MCP Apps).
+ */
+export declare function isExtAppsPlatform(platform: TestPlatformType): boolean;
+/**
+ * Check if a platform uses FrontMCP meta keys (non-OpenAI, non-ext-apps).
+ */
+export declare function isFrontmcpPlatform(platform: TestPlatformType): boolean;
+/**
+ * Get all expected meta key prefixes for a platform's tools/list response.
+ */
+export declare function getToolsListMetaPrefixes(platform: TestPlatformType): string[];
+/**
+ * Get all expected meta key prefixes for a platform's tool/call response.
+ */
+export declare function getToolCallMetaPrefixes(platform: TestPlatformType): string[];
+/**
+ * Get forbidden meta key prefixes for a platform.
+ * These prefixes should NOT appear in responses for the given platform.
+ */
+export declare function getForbiddenMetaPrefixes(platform: TestPlatformType): string[];

package/src/platform/platform-types.js

@@ -0,0 +1,110 @@
+"use strict";
+/**
+ * @file platform-types.ts
+ * @description Platform type definitions for E2E testing.
+ *
+ * These types mirror the AIPlatformType from @frontmcp/ui/adapters
+ * for use in testing without creating a hard dependency.
+ *
+ * @example
+ * ```typescript
+ * import { TestPlatformType } from '@frontmcp/testing';
+ *
+ * const platform: TestPlatformType = 'openai';
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPlatformMetaNamespace = getPlatformMetaNamespace;
+exports.getPlatformMimeType = getPlatformMimeType;
+exports.isOpenAIPlatform = isOpenAIPlatform;
+exports.isExtAppsPlatform = isExtAppsPlatform;
+exports.isFrontmcpPlatform = isFrontmcpPlatform;
+exports.getToolsListMetaPrefixes = getToolsListMetaPrefixes;
+exports.getToolCallMetaPrefixes = getToolCallMetaPrefixes;
+exports.getForbiddenMetaPrefixes = getForbiddenMetaPrefixes;
+/**
+ * Get the meta namespace for a platform type.
+ */
+function getPlatformMetaNamespace(platform) {
+    switch (platform) {
+        case 'openai':
+            return 'openai';
+        case 'ext-apps':
+            return 'ui';
+        default:
+            return 'frontmcp';
+    }
+}
+/**
+ * Get the expected MIME type for a platform.
+ *
+ * - OpenAI uses `text/html+skybridge`
+ * - All other platforms use `text/html+mcp`
+ */
+function getPlatformMimeType(platform) {
+    return platform === 'openai' ? 'text/html+skybridge' : 'text/html+mcp';
+}
+/**
+ * Check if a platform uses OpenAI-specific meta keys.
+ */
+function isOpenAIPlatform(platform) {
+    return platform === 'openai';
+}
+/**
+ * Check if a platform is ext-apps (SEP-1865 MCP Apps).
+ */
+function isExtAppsPlatform(platform) {
+    return platform === 'ext-apps';
+}
+/**
+ * Check if a platform uses FrontMCP meta keys (non-OpenAI, non-ext-apps).
+ */
+function isFrontmcpPlatform(platform) {
+    return platform !== 'openai' && platform !== 'ext-apps';
+}
+/**
+ * Get all expected meta key prefixes for a platform's tools/list response.
+ */
+function getToolsListMetaPrefixes(platform) {
+    switch (platform) {
+        case 'openai':
+            return ['openai/'];
+        case 'ext-apps':
+            return ['ui/'];
+        default:
+            // Other platforms use frontmcp/* + ui/* for compatibility
+            return ['frontmcp/', 'ui/'];
+    }
+}
+/**
+ * Get all expected meta key prefixes for a platform's tool/call response.
+ */
+function getToolCallMetaPrefixes(platform) {
+    switch (platform) {
+        case 'openai':
+            return ['openai/'];
+        case 'ext-apps':
+            return ['ui/'];
+        default:
+            // Other platforms use frontmcp/* + ui/* for compatibility
+            return ['frontmcp/', 'ui/'];
+    }
+}
+/**
+ * Get forbidden meta key prefixes for a platform.
+ * These prefixes should NOT appear in responses for the given platform.
+ */
+function getForbiddenMetaPrefixes(platform) {
+    switch (platform) {
+        case 'openai':
+            // OpenAI should NOT have ui/* or frontmcp/* keys
+            return ['ui/', 'frontmcp/'];
+        case 'ext-apps':
+            // ext-apps should NOT have openai/* or frontmcp/* keys
+            return ['openai/', 'frontmcp/'];
+        default:
+            // Other platforms should NOT have openai/* keys
+            return ['openai/'];
+    }
+}
+//# sourceMappingURL=platform-types.js.map

package/src/platform/platform-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-types.js","sourceRoot":"","sources":["../../../src/platform/platform-types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;AAsCH,4DASC;AAQD,kDAEC;AAKD,4CAEC;AAKD,8CAEC;AAKD,gDAEC;AAKD,4DAUC;AAKD,0DAUC;AAMD,4DAYC;AA3FD;;GAEG;AACH,SAAgB,wBAAwB,CAAC,QAA0B;IACjE,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB,KAAK,UAAU;YACb,OAAO,IAAI,CAAC;QACd;YACE,OAAO,UAAU,CAAC;IACtB,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB,CAAC,QAA0B;IAC5D,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,eAAe,CAAC;AACzE,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,QAA0B;IACzD,OAAO,QAAQ,KAAK,QAAQ,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAAC,QAA0B;IAC1D,OAAO,QAAQ,KAAK,UAAU,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB,CAAC,QAA0B;IAC3D,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,UAAU,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,SAAgB,wBAAwB,CAAC,QAA0B;IACjE,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,QAAQ;YACX,OAAO,CAAC,SAAS,CAAC,CAAC;QACrB,KAAK,UAAU;YACb,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB;YACE,0DAA0D;YAC1D,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IAChC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,uBAAuB,CAAC,QAA0B;IAChE,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,QAAQ;YACX,OAAO,CAAC,SAAS,CAAC,CAAC;QACrB,KAAK,UAAU;YACb,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB;YACE,0DAA0D;YAC1D,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IAChC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAgB,wBAAwB,CAAC,QAA0B;IACjE,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,QAAQ;YACX,iDAAiD;YACjD,OAAO,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QAC9B,KAAK,UAAU;YACb,uDAAuD;YACvD,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QAClC;YACE,gDAAgD;YAChD,OAAO,CAAC,SAAS,CAAC,CAAC;IACvB,CAAC;AACH,CAAC","sourcesContent":["/**\n * @file platform-types.ts\n * @description Platform type definitions for E2E testing.\n *\n * These types mirror the AIPlatformType from @frontmcp/ui/adapters\n * for use in testing without creating a hard dependency.\n *\n * @example\n * ```typescript\n * import { TestPlatformType } from '@frontmcp/testing';\n *\n * const platform: TestPlatformType = 'openai';\n * ```\n */\n\n/**\n * Supported AI platform types for testing.\n *\n * - `openai`: OpenAI ChatGPT (uses openai/* meta keys)\n * - `ext-apps`: MCP Apps per SEP-1865 (uses ui/* meta keys)\n * - `claude`: Claude Desktop (uses frontmcp/* + ui/* keys)\n * - `cursor`: Cursor IDE (uses frontmcp/* + ui/* keys)\n * - `continue`: Continue Dev (uses frontmcp/* + ui/* keys)\n * - `cody`: Sourcegraph Cody (uses frontmcp/* + ui/* keys)\n * - `gemini`: Google Gemini (uses frontmcp/* + ui/* keys)\n * - `generic-mcp`: Generic MCP client (uses frontmcp/* + ui/* keys)\n * - `unknown`: Unknown platform (uses frontmcp/* + ui/* keys)\n */\nexport type TestPlatformType =\n  | 'openai'\n  | 'ext-apps'\n  | 'claude'\n  | 'cursor'\n  | 'continue'\n  | 'cody'\n  | 'gemini'\n  | 'generic-mcp'\n  | 'unknown';\n\n/**\n * Platform meta namespace used for tool responses.\n *\n * - `openai`: Uses `openai/*` keys only\n * - `ui`: Uses `ui/*` keys only (ext-apps per SEP-1865)\n * - `frontmcp`: Uses `frontmcp/*` + `ui/*` keys for compatibility\n */\nexport type PlatformMetaNamespace = 'openai' | 'ui' | 'frontmcp';\n\n/**\n * Get the meta namespace for a platform type.\n */\nexport function getPlatformMetaNamespace(platform: TestPlatformType): PlatformMetaNamespace {\n  switch (platform) {\n    case 'openai':\n      return 'openai';\n    case 'ext-apps':\n      return 'ui';\n    default:\n      return 'frontmcp';\n  }\n}\n\n/**\n * Get the expected MIME type for a platform.\n *\n * - OpenAI uses `text/html+skybridge`\n * - All other platforms use `text/html+mcp`\n */\nexport function getPlatformMimeType(platform: TestPlatformType): string {\n  return platform === 'openai' ? 'text/html+skybridge' : 'text/html+mcp';\n}\n\n/**\n * Check if a platform uses OpenAI-specific meta keys.\n */\nexport function isOpenAIPlatform(platform: TestPlatformType): boolean {\n  return platform === 'openai';\n}\n\n/**\n * Check if a platform is ext-apps (SEP-1865 MCP Apps).\n */\nexport function isExtAppsPlatform(platform: TestPlatformType): boolean {\n  return platform === 'ext-apps';\n}\n\n/**\n * Check if a platform uses FrontMCP meta keys (non-OpenAI, non-ext-apps).\n */\nexport function isFrontmcpPlatform(platform: TestPlatformType): boolean {\n  return platform !== 'openai' && platform !== 'ext-apps';\n}\n\n/**\n * Get all expected meta key prefixes for a platform's tools/list response.\n */\nexport function getToolsListMetaPrefixes(platform: TestPlatformType): string[] {\n  switch (platform) {\n    case 'openai':\n      return ['openai/'];\n    case 'ext-apps':\n      return ['ui/'];\n    default:\n      // Other platforms use frontmcp/* + ui/* for compatibility\n      return ['frontmcp/', 'ui/'];\n  }\n}\n\n/**\n * Get all expected meta key prefixes for a platform's tool/call response.\n */\nexport function getToolCallMetaPrefixes(platform: TestPlatformType): string[] {\n  switch (platform) {\n    case 'openai':\n      return ['openai/'];\n    case 'ext-apps':\n      return ['ui/'];\n    default:\n      // Other platforms use frontmcp/* + ui/* for compatibility\n      return ['frontmcp/', 'ui/'];\n  }\n}\n\n/**\n * Get forbidden meta key prefixes for a platform.\n * These prefixes should NOT appear in responses for the given platform.\n */\nexport function getForbiddenMetaPrefixes(platform: TestPlatformType): string[] {\n  switch (platform) {\n    case 'openai':\n      // OpenAI should NOT have ui/* or frontmcp/* keys\n      return ['ui/', 'frontmcp/'];\n    case 'ext-apps':\n      // ext-apps should NOT have openai/* or frontmcp/* keys\n      return ['openai/', 'frontmcp/'];\n    default:\n      // Other platforms should NOT have openai/* keys\n      return ['openai/'];\n  }\n}\n"]}

package/src/server/test-server.d.ts

@@ -91,6 +91,10 @@ export declare class TestServer {
      */
     clearLogs(): void;
     private startProcess;
+    /**
+     * Wait for server to be ready, but also detect early process exit
+     */
+    private waitForReadyWithExitDetection;
     private log;
 }
 /**

package/src/server/test-server.js

@@ -216,6 +216,10 @@ class TestServer {
         if (this.process.pid !== undefined) {
             this._info.pid = this.process.pid;
         }
+        // Track process exit for early failure detection
+        let processExited = false;
+        let exitCode = null;
+        let exitError = null;
         // Capture stdout
         this.process.stdout?.on('data', (data) => {
             const text = data.toString();
@@ -235,16 +239,67 @@ class TestServer {
         // Handle spawn errors to prevent unhandled error events
         this.process.on('error', (err) => {
             this.logs.push(`[SPAWN ERROR] ${err.message}`);
+            exitError = err;
             if (this.options.debug) {
                 console.error('[SERVER SPAWN ERROR]', err);
             }
         });
-        // Handle process exit - use once() to avoid memory leak from listener not being cleaned up
+        // Handle process exit - track early failures
         this.process.once('exit', (code) => {
+            processExited = true;
+            exitCode = code;
             this.log(`Server process exited with code ${code}`);
         });
-        // Wait for server to be ready
-        await this.waitForReady();
+        // Wait for server to be ready, but detect early process exit
+        await this.waitForReadyWithExitDetection(() => {
+            if (exitError) {
+                return { exited: true, error: exitError };
+            }
+            if (processExited) {
+                const recentLogs = this.logs.slice(-10).join('\n');
+                return {
+                    exited: true,
+                    error: new Error(`Server process exited unexpectedly with code ${exitCode}.\n\nRecent logs:\n${recentLogs}`),
+                };
+            }
+            return { exited: false };
+        });
+    }
+    /**
+     * Wait for server to be ready, but also detect early process exit
+     */
+    async waitForReadyWithExitDetection(checkExit) {
+        const timeoutMs = this.options.startupTimeout;
+        const deadline = Date.now() + timeoutMs;
+        const checkInterval = 100;
+        while (Date.now() < deadline) {
+            // Check if process has exited before continuing to poll
+            const exitStatus = checkExit();
+            if (exitStatus.exited) {
+                throw exitStatus.error ?? new Error('Server process exited unexpectedly');
+            }
+            try {
+                const response = await fetch(`${this._info.baseUrl}${this.options.healthCheckPath}`, {
+                    method: 'GET',
+                    signal: AbortSignal.timeout(1000),
+                });
+                if (response.ok || response.status === 404) {
+                    // 404 is okay - it means the server is running but might not have a health endpoint
+                    this.log('Server is ready');
+                    return;
+                }
+            }
+            catch {
+                // Server not ready yet
+            }
+            await sleep(checkInterval);
+        }
+        // Final check before throwing timeout error
+        const finalExitStatus = checkExit();
+        if (finalExitStatus.exited) {
+            throw finalExitStatus.error ?? new Error('Server process exited unexpectedly');
+        }
+        throw new Error(`Server did not become ready within ${timeoutMs}ms`);
     }
     log(message) {
         if (this.options.debug) {

package/src/server/test-server.js.map

@@ -1 +1 @@
-{"version":3,"file":"test-server.js","sourceRoot":"","sources":["../../../src/server/test-server.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @file test-server.ts\n * @description Test server management for E2E testing\n */\n\nimport { spawn, ChildProcess } from 'child_process';\n\n// ═══════════════════════════════════════════════════════════════════\n// TYPES\n// ═══════════════════════════════════════════════════════════════════\n\nexport interface TestServerOptions {\n  /** Port to run the server on (default: random available port) */\n  port?: number;\n  /** Command to start the server */\n  command?: string;\n  /** Working directory */\n  cwd?: string;\n  /** Environment variables */\n  env?: Record<string, string>;\n  /** Timeout for server startup in milliseconds (default: 30000) */\n  startupTimeout?: number;\n  /** Path to check for server readiness (default: /health) */\n  healthCheckPath?: string;\n  /** Enable debug logging */\n  debug?: boolean;\n}\n\nexport interface TestServerInfo {\n  /** Base URL of the server */\n  baseUrl: string;\n  /** Port the server is running on */\n  port: number;\n  /** Process ID (if available) */\n  pid?: number;\n}\n\n// ═══════════════════════════════════════════════════════════════════\n// TEST SERVER CLASS\n// ═══════════════════════════════════════════════════════════════════\n\n/**\n * Manages test server lifecycle for E2E testing\n *\n * @example\n * ```typescript\n * // Start a server with custom command\n * const server = await TestServer.start({\n *   command: 'node dist/main.js',\n *   port: 3003,\n *   cwd: './apps/my-server',\n * });\n *\n * // Or start an Nx project\n * const server = await TestServer.startNx('demo-public', { port: 3003 });\n *\n * // Use the server\n * console.log(server.info.baseUrl); // http://localhost:3003\n *\n * // Stop when done\n * await server.stop();\n * ```\n */\nexport class TestServer {\n  private process: ChildProcess | null = null;\n  private readonly options: Required<TestServerOptions>;\n  private _info: TestServerInfo;\n  private logs: string[] = [];\n\n  private constructor(options: TestServerOptions, port: number) {\n    this.options = {\n      port,\n      command: options.command ?? '',\n      cwd: options.cwd ?? process.cwd(),\n      env: options.env ?? {},\n      startupTimeout: options.startupTimeout ?? 30000,\n      healthCheckPath: options.healthCheckPath ?? '/health',\n      debug: options.debug ?? false,\n    };\n\n    this._info = {\n      baseUrl: `http://localhost:${port}`,\n      port,\n    };\n  }\n\n  /**\n   * Start a test server with custom command\n   */\n  static async start(options: TestServerOptions): Promise<TestServer> {\n    const port = options.port ?? (await findAvailablePort());\n    const server = new TestServer(options, port);\n    try {\n      await server.startProcess();\n    } catch (error) {\n      await server.stop(); // Clean up spawned process to prevent leaks\n      throw error;\n    }\n    return server;\n  }\n\n  /**\n   * Start an Nx project as test server\n   */\n  static async startNx(project: string, options: Partial<TestServerOptions> = {}): Promise<TestServer> {\n    // Validate project name contains only safe characters to prevent shell injection\n    if (!/^[\\w-]+$/.test(project)) {\n      throw new Error(\n        `Invalid project name: ${project}. Must contain only alphanumeric, underscore, and hyphen characters.`,\n      );\n    }\n\n    const port = options.port ?? (await findAvailablePort());\n\n    const serverOptions: TestServerOptions = {\n      ...options,\n      port,\n      command: `npx nx serve ${project} --port ${port}`,\n      cwd: options.cwd ?? process.cwd(),\n    };\n\n    const server = new TestServer(serverOptions, port);\n    try {\n      await server.startProcess();\n    } catch (error) {\n      await server.stop(); // Clean up spawned process to prevent leaks\n      throw error;\n    }\n    return server;\n  }\n\n  /**\n   * Create a test server connected to an already running server\n   */\n  static connect(baseUrl: string): TestServer {\n    const url = new URL(baseUrl);\n    const port = parseInt(url.port, 10) || (url.protocol === 'https:' ? 443 : 80);\n\n    const server = new TestServer(\n      {\n        command: '',\n        port,\n      },\n      port,\n    );\n\n    server._info = {\n      baseUrl: baseUrl.replace(/\\/$/, ''),\n      port,\n    };\n\n    return server;\n  }\n\n  /**\n   * Get server information\n   */\n  get info(): TestServerInfo {\n    return { ...this._info };\n  }\n\n  /**\n   * Stop the test server\n   */\n  async stop(): Promise<void> {\n    if (this.process) {\n      this.log('Stopping server...');\n\n      // Try graceful shutdown first\n      this.process.kill('SIGTERM');\n\n      // Wait for process to exit\n      const exitPromise = new Promise<void>((resolve) => {\n        if (this.process) {\n          this.process.once('exit', () => resolve());\n        } else {\n          resolve();\n        }\n      });\n\n      // Force kill after timeout (but still wait for actual exit)\n      const killTimeout = setTimeout(() => {\n        if (this.process) {\n          this.log('Force killing server after timeout...');\n          this.process.kill('SIGKILL');\n        }\n      }, 5000);\n\n      await exitPromise;\n      clearTimeout(killTimeout);\n      this.process = null;\n      this.log('Server stopped');\n    }\n  }\n\n  /**\n   * Wait for server to be ready\n   */\n  async waitForReady(timeout?: number): Promise<void> {\n    const timeoutMs = timeout ?? this.options.startupTimeout;\n    const deadline = Date.now() + timeoutMs;\n    const checkInterval = 100;\n\n    while (Date.now() < deadline) {\n      try {\n        const response = await fetch(`${this._info.baseUrl}${this.options.healthCheckPath}`, {\n          method: 'GET',\n          signal: AbortSignal.timeout(1000),\n        });\n\n        if (response.ok || response.status === 404) {\n          // 404 is okay - it means the server is running but might not have a health endpoint\n          this.log('Server is ready');\n          return;\n        }\n      } catch {\n        // Server not ready yet\n      }\n\n      await sleep(checkInterval);\n    }\n\n    throw new Error(`Server did not become ready within ${timeoutMs}ms`);\n  }\n\n  /**\n   * Restart the server\n   */\n  async restart(): Promise<void> {\n    await this.stop();\n    await this.startProcess();\n  }\n\n  /**\n   * Get captured server logs\n   */\n  getLogs(): string[] {\n    return [...this.logs];\n  }\n\n  /**\n   * Clear captured logs\n   */\n  clearLogs(): void {\n    this.logs = [];\n  }\n\n  // ═══════════════════════════════════════════════════════════════════\n  // PRIVATE METHODS\n  // ═══════════════════════════════════════════════════════════════════\n\n  private async startProcess(): Promise<void> {\n    if (!this.options.command) {\n      // No command means we're connecting to an existing server\n      await this.waitForReady();\n      return;\n    }\n\n    this.log(`Starting server: ${this.options.command}`);\n\n    const env = {\n      ...process.env,\n      ...this.options.env,\n      PORT: String(this.options.port),\n    };\n\n    // Use shell: true to handle complex commands with quoted arguments\n    // This avoids fragile command parsing with split(' ')\n    this.process = spawn(this.options.command, [], {\n      cwd: this.options.cwd,\n      env,\n      shell: true,\n      stdio: ['pipe', 'pipe', 'pipe'],\n    });\n\n    // pid can be undefined if spawn fails\n    if (this.process.pid !== undefined) {\n      this._info.pid = this.process.pid;\n    }\n\n    // Capture stdout\n    this.process.stdout?.on('data', (data: Buffer) => {\n      const text = data.toString();\n      this.logs.push(text);\n      if (this.options.debug) {\n        console.log('[SERVER]', text);\n      }\n    });\n\n    // Capture stderr\n    this.process.stderr?.on('data', (data: Buffer) => {\n      const text = data.toString();\n      this.logs.push(`[ERROR] ${text}`);\n      if (this.options.debug) {\n        console.error('[SERVER ERROR]', text);\n      }\n    });\n\n    // Handle spawn errors to prevent unhandled error events\n    this.process.on('error', (err) => {\n      this.logs.push(`[SPAWN ERROR] ${err.message}`);\n      if (this.options.debug) {\n        console.error('[SERVER SPAWN ERROR]', err);\n      }\n    });\n\n    // Handle process exit - use once() to avoid memory leak from listener not being cleaned up\n    this.process.once('exit', (code) => {\n      this.log(`Server process exited with code ${code}`);\n    });\n\n    // Wait for server to be ready\n    await this.waitForReady();\n  }\n\n  private log(message: string): void {\n    if (this.options.debug) {\n      console.log(`[TestServer] ${message}`);\n    }\n  }\n}\n\n// ═══════════════════════════════════════════════════════════════════\n// UTILITIES\n// ═══════════════════════════════════════════════════════════════════\n\n/**\n * Find an available port\n */\nexport async function findAvailablePort(): Promise<number> {\n  // Use a simple approach: try to create a server on port 0 to get an available port\n  const { createServer } = await import('net');\n\n  return new Promise((resolve, reject) => {\n    const server = createServer();\n\n    server.listen(0, () => {\n      const address = server.address();\n      if (address && typeof address !== 'string') {\n        const port = address.port;\n        server.close(() => resolve(port));\n      } else {\n        reject(new Error('Could not get port'));\n      }\n    });\n\n    server.on('error', reject);\n  });\n}\n\n/**\n * Sleep for specified milliseconds\n */\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n"]}
+{"version":3,"file":"test-server.js","sourceRoot":"","sources":["../../../src/server/test-server.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @file test-server.ts\n * @description Test server management for E2E testing\n */\n\nimport { spawn, ChildProcess } from 'child_process';\n\n// ═══════════════════════════════════════════════════════════════════\n// TYPES\n// ═══════════════════════════════════════════════════════════════════\n\nexport interface TestServerOptions {\n  /** Port to run the server on (default: random available port) */\n  port?: number;\n  /** Command to start the server */\n  command?: string;\n  /** Working directory */\n  cwd?: string;\n  /** Environment variables */\n  env?: Record<string, string>;\n  /** Timeout for server startup in milliseconds (default: 30000) */\n  startupTimeout?: number;\n  /** Path to check for server readiness (default: /health) */\n  healthCheckPath?: string;\n  /** Enable debug logging */\n  debug?: boolean;\n}\n\nexport interface TestServerInfo {\n  /** Base URL of the server */\n  baseUrl: string;\n  /** Port the server is running on */\n  port: number;\n  /** Process ID (if available) */\n  pid?: number;\n}\n\n// ═══════════════════════════════════════════════════════════════════\n// TEST SERVER CLASS\n// ═══════════════════════════════════════════════════════════════════\n\n/**\n * Manages test server lifecycle for E2E testing\n *\n * @example\n * ```typescript\n * // Start a server with custom command\n * const server = await TestServer.start({\n *   command: 'node dist/main.js',\n *   port: 3003,\n *   cwd: './apps/my-server',\n * });\n *\n * // Or start an Nx project\n * const server = await TestServer.startNx('demo-public', { port: 3003 });\n *\n * // Use the server\n * console.log(server.info.baseUrl); // http://localhost:3003\n *\n * // Stop when done\n * await server.stop();\n * ```\n */\nexport class TestServer {\n  private process: ChildProcess | null = null;\n  private readonly options: Required<TestServerOptions>;\n  private _info: TestServerInfo;\n  private logs: string[] = [];\n\n  private constructor(options: TestServerOptions, port: number) {\n    this.options = {\n      port,\n      command: options.command ?? '',\n      cwd: options.cwd ?? process.cwd(),\n      env: options.env ?? {},\n      startupTimeout: options.startupTimeout ?? 30000,\n      healthCheckPath: options.healthCheckPath ?? '/health',\n      debug: options.debug ?? false,\n    };\n\n    this._info = {\n      baseUrl: `http://localhost:${port}`,\n      port,\n    };\n  }\n\n  /**\n   * Start a test server with custom command\n   */\n  static async start(options: TestServerOptions): Promise<TestServer> {\n    const port = options.port ?? (await findAvailablePort());\n    const server = new TestServer(options, port);\n    try {\n      await server.startProcess();\n    } catch (error) {\n      await server.stop(); // Clean up spawned process to prevent leaks\n      throw error;\n    }\n    return server;\n  }\n\n  /**\n   * Start an Nx project as test server\n   */\n  static async startNx(project: string, options: Partial<TestServerOptions> = {}): Promise<TestServer> {\n    // Validate project name contains only safe characters to prevent shell injection\n    if (!/^[\\w-]+$/.test(project)) {\n      throw new Error(\n        `Invalid project name: ${project}. Must contain only alphanumeric, underscore, and hyphen characters.`,\n      );\n    }\n\n    const port = options.port ?? (await findAvailablePort());\n\n    const serverOptions: TestServerOptions = {\n      ...options,\n      port,\n      command: `npx nx serve ${project} --port ${port}`,\n      cwd: options.cwd ?? process.cwd(),\n    };\n\n    const server = new TestServer(serverOptions, port);\n    try {\n      await server.startProcess();\n    } catch (error) {\n      await server.stop(); // Clean up spawned process to prevent leaks\n      throw error;\n    }\n    return server;\n  }\n\n  /**\n   * Create a test server connected to an already running server\n   */\n  static connect(baseUrl: string): TestServer {\n    const url = new URL(baseUrl);\n    const port = parseInt(url.port, 10) || (url.protocol === 'https:' ? 443 : 80);\n\n    const server = new TestServer(\n      {\n        command: '',\n        port,\n      },\n      port,\n    );\n\n    server._info = {\n      baseUrl: baseUrl.replace(/\\/$/, ''),\n      port,\n    };\n\n    return server;\n  }\n\n  /**\n   * Get server information\n   */\n  get info(): TestServerInfo {\n    return { ...this._info };\n  }\n\n  /**\n   * Stop the test server\n   */\n  async stop(): Promise<void> {\n    if (this.process) {\n      this.log('Stopping server...');\n\n      // Try graceful shutdown first\n      this.process.kill('SIGTERM');\n\n      // Wait for process to exit\n      const exitPromise = new Promise<void>((resolve) => {\n        if (this.process) {\n          this.process.once('exit', () => resolve());\n        } else {\n          resolve();\n        }\n      });\n\n      // Force kill after timeout (but still wait for actual exit)\n      const killTimeout = setTimeout(() => {\n        if (this.process) {\n          this.log('Force killing server after timeout...');\n          this.process.kill('SIGKILL');\n        }\n      }, 5000);\n\n      await exitPromise;\n      clearTimeout(killTimeout);\n      this.process = null;\n      this.log('Server stopped');\n    }\n  }\n\n  /**\n   * Wait for server to be ready\n   */\n  async waitForReady(timeout?: number): Promise<void> {\n    const timeoutMs = timeout ?? this.options.startupTimeout;\n    const deadline = Date.now() + timeoutMs;\n    const checkInterval = 100;\n\n    while (Date.now() < deadline) {\n      try {\n        const response = await fetch(`${this._info.baseUrl}${this.options.healthCheckPath}`, {\n          method: 'GET',\n          signal: AbortSignal.timeout(1000),\n        });\n\n        if (response.ok || response.status === 404) {\n          // 404 is okay - it means the server is running but might not have a health endpoint\n          this.log('Server is ready');\n          return;\n        }\n      } catch {\n        // Server not ready yet\n      }\n\n      await sleep(checkInterval);\n    }\n\n    throw new Error(`Server did not become ready within ${timeoutMs}ms`);\n  }\n\n  /**\n   * Restart the server\n   */\n  async restart(): Promise<void> {\n    await this.stop();\n    await this.startProcess();\n  }\n\n  /**\n   * Get captured server logs\n   */\n  getLogs(): string[] {\n    return [...this.logs];\n  }\n\n  /**\n   * Clear captured logs\n   */\n  clearLogs(): void {\n    this.logs = [];\n  }\n\n  // ═══════════════════════════════════════════════════════════════════\n  // PRIVATE METHODS\n  // ═══════════════════════════════════════════════════════════════════\n\n  private async startProcess(): Promise<void> {\n    if (!this.options.command) {\n      // No command means we're connecting to an existing server\n      await this.waitForReady();\n      return;\n    }\n\n    this.log(`Starting server: ${this.options.command}`);\n\n    const env = {\n      ...process.env,\n      ...this.options.env,\n      PORT: String(this.options.port),\n    };\n\n    // Use shell: true to handle complex commands with quoted arguments\n    // This avoids fragile command parsing with split(' ')\n    this.process = spawn(this.options.command, [], {\n      cwd: this.options.cwd,\n      env,\n      shell: true,\n      stdio: ['pipe', 'pipe', 'pipe'],\n    });\n\n    // pid can be undefined if spawn fails\n    if (this.process.pid !== undefined) {\n      this._info.pid = this.process.pid;\n    }\n\n    // Track process exit for early failure detection\n    let processExited = false;\n    let exitCode: number | null = null;\n    let exitError: Error | null = null;\n\n    // Capture stdout\n    this.process.stdout?.on('data', (data: Buffer) => {\n      const text = data.toString();\n      this.logs.push(text);\n      if (this.options.debug) {\n        console.log('[SERVER]', text);\n      }\n    });\n\n    // Capture stderr\n    this.process.stderr?.on('data', (data: Buffer) => {\n      const text = data.toString();\n      this.logs.push(`[ERROR] ${text}`);\n      if (this.options.debug) {\n        console.error('[SERVER ERROR]', text);\n      }\n    });\n\n    // Handle spawn errors to prevent unhandled error events\n    this.process.on('error', (err) => {\n      this.logs.push(`[SPAWN ERROR] ${err.message}`);\n      exitError = err;\n      if (this.options.debug) {\n        console.error('[SERVER SPAWN ERROR]', err);\n      }\n    });\n\n    // Handle process exit - track early failures\n    this.process.once('exit', (code) => {\n      processExited = true;\n      exitCode = code;\n      this.log(`Server process exited with code ${code}`);\n    });\n\n    // Wait for server to be ready, but detect early process exit\n    await this.waitForReadyWithExitDetection(() => {\n      if (exitError) {\n        return { exited: true, error: exitError };\n      }\n      if (processExited) {\n        const recentLogs = this.logs.slice(-10).join('\\n');\n        return {\n          exited: true,\n          error: new Error(`Server process exited unexpectedly with code ${exitCode}.\\n\\nRecent logs:\\n${recentLogs}`),\n        };\n      }\n      return { exited: false };\n    });\n  }\n\n  /**\n   * Wait for server to be ready, but also detect early process exit\n   */\n  private async waitForReadyWithExitDetection(checkExit: () => { exited: boolean; error?: Error }): Promise<void> {\n    const timeoutMs = this.options.startupTimeout;\n    const deadline = Date.now() + timeoutMs;\n    const checkInterval = 100;\n\n    while (Date.now() < deadline) {\n      // Check if process has exited before continuing to poll\n      const exitStatus = checkExit();\n      if (exitStatus.exited) {\n        throw exitStatus.error ?? new Error('Server process exited unexpectedly');\n      }\n\n      try {\n        const response = await fetch(`${this._info.baseUrl}${this.options.healthCheckPath}`, {\n          method: 'GET',\n          signal: AbortSignal.timeout(1000),\n        });\n\n        if (response.ok || response.status === 404) {\n          // 404 is okay - it means the server is running but might not have a health endpoint\n          this.log('Server is ready');\n          return;\n        }\n      } catch {\n        // Server not ready yet\n      }\n\n      await sleep(checkInterval);\n    }\n\n    // Final check before throwing timeout error\n    const finalExitStatus = checkExit();\n    if (finalExitStatus.exited) {\n      throw finalExitStatus.error ?? new Error('Server process exited unexpectedly');\n    }\n\n    throw new Error(`Server did not become ready within ${timeoutMs}ms`);\n  }\n\n  private log(message: string): void {\n    if (this.options.debug) {\n      console.log(`[TestServer] ${message}`);\n    }\n  }\n}\n\n// ═══════════════════════════════════════════════════════════════════\n// UTILITIES\n// ═══════════════════════════════════════════════════════════════════\n\n/**\n * Find an available port\n */\nexport async function findAvailablePort(): Promise<number> {\n  // Use a simple approach: try to create a server on port 0 to get an available port\n  const { createServer } = await import('net');\n\n  return new Promise((resolve, reject) => {\n    const server = createServer();\n\n    server.listen(0, () => {\n      const address = server.address();\n      if (address && typeof address !== 'string') {\n        const port = address.port;\n        server.close(() => resolve(port));\n      } else {\n        reject(new Error('Could not get port'));\n      }\n    });\n\n    server.on('error', reject);\n  });\n}\n\n/**\n * Sleep for specified milliseconds\n */\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n"]}