@frontmcp/testing 0.5.0

package/src/expect.js.map

@@ -0,0 +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"]}

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

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

package/src/fixtures/fixture-types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * @file fixture-types.ts
+ * @description Type definitions for test fixtures
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=fixture-types.js.map

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

@@ -0,0 +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"]}

package/src/fixtures/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @file index.ts
+ * @description Barrel exports for test fixtures
+ */
+export { test } from './test-fixture';
+export type { TestConfig, TestFixtures, AuthFixture, ServerFixture, TestFn, TestWithFixtures, TestUser, } from './fixture-types';
+export { createTestFixtures, cleanupTestFixtures, initializeSharedResources, cleanupSharedResources, } from './test-fixture';

package/src/fixtures/index.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * @file index.ts
+ * @description Barrel exports for test fixtures
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cleanupSharedResources = exports.initializeSharedResources = exports.cleanupTestFixtures = exports.createTestFixtures = exports.test = void 0;
+var test_fixture_1 = require("./test-fixture");
+Object.defineProperty(exports, "test", { enumerable: true, get: function () { return test_fixture_1.test; } });
+// Advanced exports for custom setups
+var test_fixture_2 = require("./test-fixture");
+Object.defineProperty(exports, "createTestFixtures", { enumerable: true, get: function () { return test_fixture_2.createTestFixtures; } });
+Object.defineProperty(exports, "cleanupTestFixtures", { enumerable: true, get: function () { return test_fixture_2.cleanupTestFixtures; } });
+Object.defineProperty(exports, "initializeSharedResources", { enumerable: true, get: function () { return test_fixture_2.initializeSharedResources; } });
+Object.defineProperty(exports, "cleanupSharedResources", { enumerable: true, get: function () { return test_fixture_2.cleanupSharedResources; } });
+//# sourceMappingURL=index.js.map

package/src/fixtures/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/fixtures/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,+CAAsC;AAA7B,oGAAA,IAAI,OAAA;AAWb,qCAAqC;AACrC,+CAKwB;AAJtB,kHAAA,kBAAkB,OAAA;AAClB,mHAAA,mBAAmB,OAAA;AACnB,yHAAA,yBAAyB,OAAA;AACzB,sHAAA,sBAAsB,OAAA","sourcesContent":["/**\n * @file index.ts\n * @description Barrel exports for test fixtures\n */\n\nexport { test } from './test-fixture';\nexport type {\n  TestConfig,\n  TestFixtures,\n  AuthFixture,\n  ServerFixture,\n  TestFn,\n  TestWithFixtures,\n  TestUser,\n} from './fixture-types';\n\n// Advanced exports for custom setups\nexport {\n  createTestFixtures,\n  cleanupTestFixtures,\n  initializeSharedResources,\n  cleanupSharedResources,\n} from './test-fixture';\n"]}

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

@@ -0,0 +1,41 @@
+/**
+ * @file test-fixture.ts
+ * @description Jest-based fixture system for MCP testing
+ *
+ * Provides a Playwright-like fixture API for testing FrontMCP servers:
+ *
+ * @example
+ * ```typescript
+ * import { test, expect } from '@frontmcp/testing';
+ *
+ * test.use({
+ *   server: './src/main.ts',
+ *   port: 3003,
+ * });
+ *
+ * test('server exposes tools', async ({ mcp }) => {
+ *   const tools = await mcp.tools.list();
+ *   expect(tools).toContainTool('my-tool');
+ * });
+ * ```
+ */
+import type { TestFixtures, TestWithFixtures } from './fixture-types';
+/**
+ * Initialize shared resources (server, token factory) once per test file
+ */
+declare function initializeSharedResources(): Promise<void>;
+/**
+ * Create fixtures for a single test
+ */
+declare function createTestFixtures(): Promise<TestFixtures>;
+/**
+ * Clean up fixtures after a single test
+ */
+declare function cleanupTestFixtures(fixtures: TestFixtures): Promise<void>;
+/**
+ * Clean up shared resources after all tests in a file
+ */
+declare function cleanupSharedResources(): Promise<void>;
+declare const test: TestWithFixtures;
+export { test };
+export { createTestFixtures, cleanupTestFixtures, initializeSharedResources, cleanupSharedResources };

package/src/fixtures/test-fixture.js

@@ -0,0 +1,280 @@
+"use strict";
+/**
+ * @file test-fixture.ts
+ * @description Jest-based fixture system for MCP testing
+ *
+ * Provides a Playwright-like fixture API for testing FrontMCP servers:
+ *
+ * @example
+ * ```typescript
+ * import { test, expect } from '@frontmcp/testing';
+ *
+ * test.use({
+ *   server: './src/main.ts',
+ *   port: 3003,
+ * });
+ *
+ * test('server exposes tools', async ({ mcp }) => {
+ *   const tools = await mcp.tools.list();
+ *   expect(tools).toContainTool('my-tool');
+ * });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.test = void 0;
+exports.createTestFixtures = createTestFixtures;
+exports.cleanupTestFixtures = cleanupTestFixtures;
+exports.initializeSharedResources = initializeSharedResources;
+exports.cleanupSharedResources = cleanupSharedResources;
+const mcp_test_client_1 = require("../client/mcp-test-client");
+const token_factory_1 = require("../auth/token-factory");
+const test_server_1 = require("../server/test-server");
+// ═══════════════════════════════════════════════════════════════════
+// GLOBAL STATE
+// ═══════════════════════════════════════════════════════════════════
+/** Current test configuration (set via test.use()) */
+let currentConfig = {};
+/** Server instance (shared across tests in a file) */
+let serverInstance = null;
+/** Token factory instance (shared across tests in a file) */
+let tokenFactory = null;
+/** Track if server was started by us (vs external) */
+let serverStartedByUs = false;
+// ═══════════════════════════════════════════════════════════════════
+// FIXTURE SETUP/TEARDOWN
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * Initialize shared resources (server, token factory) once per test file
+ */
+async function initializeSharedResources() {
+    // Create token factory if not exists
+    if (!tokenFactory) {
+        tokenFactory = new token_factory_1.TestTokenFactory();
+    }
+    // Start or connect to server if not exists
+    if (!serverInstance) {
+        if (currentConfig.baseUrl) {
+            // Connect to existing external server
+            serverInstance = test_server_1.TestServer.connect(currentConfig.baseUrl);
+            serverStartedByUs = false;
+        }
+        else if (currentConfig.server) {
+            // Start new server
+            serverInstance = await test_server_1.TestServer.start({
+                port: currentConfig.port,
+                command: resolveServerCommand(currentConfig.server),
+                env: currentConfig.env,
+                startupTimeout: currentConfig.startupTimeout ?? 30000,
+                debug: currentConfig.logLevel === 'debug',
+            });
+            serverStartedByUs = true;
+        }
+        else {
+            throw new Error('test.use() requires either "server" (entry file path) or "baseUrl" (for external server) option');
+        }
+    }
+}
+/**
+ * Create fixtures for a single test
+ */
+async function createTestFixtures() {
+    // Ensure shared resources are initialized
+    await initializeSharedResources();
+    // Create MCP client for this test
+    // Pass publicMode if configured to skip authentication
+    const clientInstance = await mcp_test_client_1.McpTestClient.create({
+        baseUrl: serverInstance.info.baseUrl,
+        transport: currentConfig.transport ?? 'streamable-http',
+        publicMode: currentConfig.publicMode,
+    }).buildAndConnect();
+    // Build fixtures
+    const auth = createAuthFixture(tokenFactory);
+    const server = createServerFixture(serverInstance);
+    return {
+        mcp: clientInstance,
+        auth,
+        server,
+    };
+}
+/**
+ * Clean up fixtures after a single test
+ */
+async function cleanupTestFixtures(fixtures) {
+    // Disconnect client
+    if (fixtures.mcp.isConnected()) {
+        await fixtures.mcp.disconnect();
+    }
+}
+/**
+ * Clean up shared resources after all tests in a file
+ */
+async function cleanupSharedResources() {
+    // Only stop server if we started it
+    if (serverInstance && serverStartedByUs) {
+        await serverInstance.stop();
+    }
+    serverInstance = null;
+    tokenFactory = null;
+    serverStartedByUs = false;
+}
+// ═══════════════════════════════════════════════════════════════════
+// FIXTURE FACTORIES
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * Create the auth fixture from token factory
+ */
+function createAuthFixture(factory) {
+    const users = {
+        admin: {
+            sub: 'admin-001',
+            scopes: ['admin:*', 'read', 'write', 'delete'],
+            email: 'admin@test.local',
+            name: 'Test Admin',
+        },
+        user: {
+            sub: 'user-001',
+            scopes: ['read', 'write'],
+            email: 'user@test.local',
+            name: 'Test User',
+        },
+        readOnly: {
+            sub: 'readonly-001',
+            scopes: ['read'],
+            email: 'readonly@test.local',
+            name: 'Read Only User',
+        },
+    };
+    return {
+        createToken: (opts) => factory.createTestToken({
+            sub: opts.sub,
+            scopes: opts.scopes,
+            claims: {
+                email: opts.email,
+                name: opts.name,
+                ...opts.claims,
+            },
+            exp: opts.expiresIn,
+        }),
+        createExpiredToken: (opts) => factory.createExpiredToken(opts),
+        createInvalidToken: (opts) => factory.createTokenWithInvalidSignature(opts),
+        users: {
+            admin: users['admin'],
+            user: users['user'],
+            readOnly: users['readOnly'],
+        },
+        getJwks: () => factory.getPublicJwks(),
+        getIssuer: () => factory.getIssuer(),
+        getAudience: () => factory.getAudience(),
+    };
+}
+/**
+ * Create the server fixture from test server
+ */
+function createServerFixture(server) {
+    return {
+        info: server.info,
+        createClient: async (opts) => {
+            return mcp_test_client_1.McpTestClient.create({
+                baseUrl: server.info.baseUrl,
+                transport: opts?.transport ?? 'streamable-http',
+                auth: opts?.token ? { token: opts.token } : undefined,
+            }).buildAndConnect();
+        },
+        restart: () => server.restart(),
+        getLogs: () => server.getLogs(),
+        clearLogs: () => server.clearLogs(),
+    };
+}
+/**
+ * Resolve server entry to a command
+ */
+function resolveServerCommand(server) {
+    // If it's already a command (contains spaces), use as-is
+    if (server.includes(' ')) {
+        return server;
+    }
+    // Otherwise, run with tsx
+    return `npx tsx ${server}`;
+}
+// ═══════════════════════════════════════════════════════════════════
+// TEST FUNCTION WITH FIXTURES
+// ═══════════════════════════════════════════════════════════════════
+/**
+ * Enhanced test function that provides fixtures
+ */
+function testWithFixtures(name, fn) {
+    it(name, async () => {
+        const fixtures = await createTestFixtures();
+        try {
+            await fn(fixtures);
+        }
+        finally {
+            await cleanupTestFixtures(fixtures);
+        }
+    });
+}
+/**
+ * Configure test fixtures for the current test file/suite
+ */
+function use(config) {
+    // Merge with existing config
+    currentConfig = { ...currentConfig, ...config };
+    // Register cleanup hook if not already done
+    // This ensures server is stopped after all tests in the file
+    afterAll(async () => {
+        await cleanupSharedResources();
+    });
+}
+/**
+ * Skip a test
+ */
+function skip(name, fn) {
+    it.skip(name, async () => {
+        const fixtures = await createTestFixtures();
+        try {
+            await fn(fixtures);
+        }
+        finally {
+            await cleanupTestFixtures(fixtures);
+        }
+    });
+}
+/**
+ * Run only this test
+ */
+function only(name, fn) {
+    it.only(name, async () => {
+        const fixtures = await createTestFixtures();
+        try {
+            await fn(fixtures);
+        }
+        finally {
+            await cleanupTestFixtures(fixtures);
+        }
+    });
+}
+/**
+ * Mark test as todo
+ */
+function todo(name) {
+    it.todo(name);
+}
+// ═══════════════════════════════════════════════════════════════════
+// ATTACH STATIC METHODS
+// ═══════════════════════════════════════════════════════════════════
+// Cast to the full interface type
+const test = testWithFixtures;
+exports.test = test;
+// Attach configuration method
+test.use = use;
+// Attach Jest lifecycle methods
+test.describe = describe;
+test.beforeAll = beforeAll;
+test.beforeEach = beforeEach;
+test.afterEach = afterEach;
+test.afterAll = afterAll;
+// Attach test modifiers
+test.skip = skip;
+test.only = only;
+test.todo = todo;
+//# sourceMappingURL=test-fixture.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"test-fixture.js","sourceRoot":"","sources":["../../../src/fixtures/test-fixture.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @file test-fixture.ts\n * @description Jest-based fixture system for MCP testing\n *\n * Provides a Playwright-like fixture API for testing FrontMCP servers:\n *\n * @example\n * ```typescript\n * import { test, expect } from '@frontmcp/testing';\n *\n * test.use({\n *   server: './src/main.ts',\n *   port: 3003,\n * });\n *\n * test('server exposes tools', async ({ mcp }) => {\n *   const tools = await mcp.tools.list();\n *   expect(tools).toContainTool('my-tool');\n * });\n * ```\n */\n\nimport { McpTestClient } from '../client/mcp-test-client';\nimport { TestTokenFactory } from '../auth/token-factory';\nimport { TestServer } from '../server/test-server';\nimport type {\n  TestConfig,\n  TestFixtures,\n  AuthFixture,\n  ServerFixture,\n  TestFn,\n  TestWithFixtures,\n  TestUser,\n} from './fixture-types';\n\n// ═══════════════════════════════════════════════════════════════════\n// GLOBAL STATE\n// ═══════════════════════════════════════════════════════════════════\n\n/** Current test configuration (set via test.use()) */\nlet currentConfig: TestConfig = {};\n\n/** Server instance (shared across tests in a file) */\nlet serverInstance: TestServer | null = null;\n\n/** Token factory instance (shared across tests in a file) */\nlet tokenFactory: TestTokenFactory | null = null;\n\n/** Track if server was started by us (vs external) */\nlet serverStartedByUs = false;\n\n// ═══════════════════════════════════════════════════════════════════\n// FIXTURE SETUP/TEARDOWN\n// ═══════════════════════════════════════════════════════════════════\n\n/**\n * Initialize shared resources (server, token factory) once per test file\n */\nasync function initializeSharedResources(): Promise<void> {\n  // Create token factory if not exists\n  if (!tokenFactory) {\n    tokenFactory = new TestTokenFactory();\n  }\n\n  // Start or connect to server if not exists\n  if (!serverInstance) {\n    if (currentConfig.baseUrl) {\n      // Connect to existing external server\n      serverInstance = TestServer.connect(currentConfig.baseUrl);\n      serverStartedByUs = false;\n    } else if (currentConfig.server) {\n      // Start new server\n      serverInstance = await TestServer.start({\n        port: currentConfig.port,\n        command: resolveServerCommand(currentConfig.server),\n        env: currentConfig.env,\n        startupTimeout: currentConfig.startupTimeout ?? 30000,\n        debug: currentConfig.logLevel === 'debug',\n      });\n      serverStartedByUs = true;\n    } else {\n      throw new Error(\n        'test.use() requires either \"server\" (entry file path) or \"baseUrl\" (for external server) option',\n      );\n    }\n  }\n}\n\n/**\n * Create fixtures for a single test\n */\nasync function createTestFixtures(): Promise<TestFixtures> {\n  // Ensure shared resources are initialized\n  await initializeSharedResources();\n\n  // Create MCP client for this test\n  // Pass publicMode if configured to skip authentication\n  const clientInstance = await McpTestClient.create({\n    baseUrl: serverInstance!.info.baseUrl,\n    transport: currentConfig.transport ?? 'streamable-http',\n    publicMode: currentConfig.publicMode,\n  }).buildAndConnect();\n\n  // Build fixtures\n  const auth = createAuthFixture(tokenFactory!);\n  const server = createServerFixture(serverInstance!);\n\n  return {\n    mcp: clientInstance,\n    auth,\n    server,\n  };\n}\n\n/**\n * Clean up fixtures after a single test\n */\nasync function cleanupTestFixtures(fixtures: TestFixtures): Promise<void> {\n  // Disconnect client\n  if (fixtures.mcp.isConnected()) {\n    await fixtures.mcp.disconnect();\n  }\n}\n\n/**\n * Clean up shared resources after all tests in a file\n */\nasync function cleanupSharedResources(): Promise<void> {\n  // Only stop server if we started it\n  if (serverInstance && serverStartedByUs) {\n    await serverInstance.stop();\n  }\n  serverInstance = null;\n  tokenFactory = null;\n  serverStartedByUs = false;\n}\n\n// ═══════════════════════════════════════════════════════════════════\n// FIXTURE FACTORIES\n// ═══════════════════════════════════════════════════════════════════\n\n/**\n * Create the auth fixture from token factory\n */\nfunction createAuthFixture(factory: TestTokenFactory): AuthFixture {\n  const users: Record<string, TestUser> = {\n    admin: {\n      sub: 'admin-001',\n      scopes: ['admin:*', 'read', 'write', 'delete'],\n      email: 'admin@test.local',\n      name: 'Test Admin',\n    },\n    user: {\n      sub: 'user-001',\n      scopes: ['read', 'write'],\n      email: 'user@test.local',\n      name: 'Test User',\n    },\n    readOnly: {\n      sub: 'readonly-001',\n      scopes: ['read'],\n      email: 'readonly@test.local',\n      name: 'Read Only User',\n    },\n  };\n\n  return {\n    createToken: (opts) =>\n      factory.createTestToken({\n        sub: opts.sub,\n        scopes: opts.scopes,\n        claims: {\n          email: opts.email,\n          name: opts.name,\n          ...opts.claims,\n        },\n        exp: opts.expiresIn,\n      }),\n\n    createExpiredToken: (opts) => factory.createExpiredToken(opts),\n\n    createInvalidToken: (opts) => factory.createTokenWithInvalidSignature(opts),\n\n    users: {\n      admin: users['admin'],\n      user: users['user'],\n      readOnly: users['readOnly'],\n    },\n\n    getJwks: () => factory.getPublicJwks(),\n\n    getIssuer: () => factory.getIssuer(),\n\n    getAudience: () => factory.getAudience(),\n  };\n}\n\n/**\n * Create the server fixture from test server\n */\nfunction createServerFixture(server: TestServer): ServerFixture {\n  return {\n    info: server.info,\n\n    createClient: async (opts) => {\n      return McpTestClient.create({\n        baseUrl: server.info.baseUrl,\n        transport: opts?.transport ?? 'streamable-http',\n        auth: opts?.token ? { token: opts.token } : undefined,\n      }).buildAndConnect();\n    },\n\n    restart: () => server.restart(),\n\n    getLogs: () => server.getLogs(),\n\n    clearLogs: () => server.clearLogs(),\n  };\n}\n\n/**\n * Resolve server entry to a command\n */\nfunction resolveServerCommand(server: string): string {\n  // If it's already a command (contains spaces), use as-is\n  if (server.includes(' ')) {\n    return server;\n  }\n  // Otherwise, run with tsx\n  return `npx tsx ${server}`;\n}\n\n// ═══════════════════════════════════════════════════════════════════\n// TEST FUNCTION WITH FIXTURES\n// ═══════════════════════════════════════════════════════════════════\n\n/**\n * Enhanced test function that provides fixtures\n */\nfunction testWithFixtures(name: string, fn: TestFn): void {\n  it(name, async () => {\n    const fixtures = await createTestFixtures();\n    try {\n      await fn(fixtures);\n    } finally {\n      await cleanupTestFixtures(fixtures);\n    }\n  });\n}\n\n/**\n * Configure test fixtures for the current test file/suite\n */\nfunction use(config: TestConfig): void {\n  // Merge with existing config\n  currentConfig = { ...currentConfig, ...config };\n\n  // Register cleanup hook if not already done\n  // This ensures server is stopped after all tests in the file\n  afterAll(async () => {\n    await cleanupSharedResources();\n  });\n}\n\n/**\n * Skip a test\n */\nfunction skip(name: string, fn: TestFn): void {\n  it.skip(name, async () => {\n    const fixtures = await createTestFixtures();\n    try {\n      await fn(fixtures);\n    } finally {\n      await cleanupTestFixtures(fixtures);\n    }\n  });\n}\n\n/**\n * Run only this test\n */\nfunction only(name: string, fn: TestFn): void {\n  it.only(name, async () => {\n    const fixtures = await createTestFixtures();\n    try {\n      await fn(fixtures);\n    } finally {\n      await cleanupTestFixtures(fixtures);\n    }\n  });\n}\n\n/**\n * Mark test as todo\n */\nfunction todo(name: string): void {\n  it.todo(name);\n}\n\n// ═══════════════════════════════════════════════════════════════════\n// ATTACH STATIC METHODS\n// ═══════════════════════════════════════════════════════════════════\n\n// Cast to the full interface type\nconst test = testWithFixtures as TestWithFixtures;\n\n// Attach configuration method\ntest.use = use;\n\n// Attach Jest lifecycle methods\ntest.describe = describe;\ntest.beforeAll = beforeAll;\ntest.beforeEach = beforeEach;\ntest.afterEach = afterEach;\ntest.afterAll = afterAll;\n\n// Attach test modifiers\ntest.skip = skip;\ntest.only = only;\ntest.todo = todo;\n\n// ═══════════════════════════════════════════════════════════════════\n// EXPORTS\n// ═══════════════════════════════════════════════════════════════════\n\nexport { test };\n\n// Also export for advanced use cases\nexport { createTestFixtures, cleanupTestFixtures, initializeSharedResources, cleanupSharedResources };\n"]}

package/src/http-mock/http-mock.d.ts

@@ -0,0 +1,84 @@
+/**
+ * @file http-mock.ts
+ * @description HTTP request mocking implementation for offline MCP server testing
+ *
+ * This module intercepts fetch() and XMLHttpRequest calls, allowing tools to be
+ * tested without making real HTTP requests.
+ *
+ * @example
+ * ```typescript
+ * import { httpMock } from '@frontmcp/testing';
+ *
+ * // Enable HTTP mocking
+ * const interceptor = httpMock.interceptor();
+ *
+ * // Mock a GET request
+ * interceptor.get('https://api.example.com/users', {
+ *   body: [{ id: 1, name: 'John' }],
+ * });
+ *
+ * // Mock a POST request with pattern matching
+ * interceptor.post(/api\.example\.com\/users/, {
+ *   status: 201,
+ *   body: { id: 2, name: 'Jane' },
+ * });
+ *
+ * // Now run your MCP server test - HTTP calls will be intercepted
+ * const result = await mcp.tools.call('fetch-users', {});
+ *
+ * // Verify all mocks were used
+ * interceptor.assertDone();
+ *
+ * // Restore original fetch
+ * interceptor.restore();
+ * ```
+ */
+import type { HttpMockResponse, HttpMockManager } from './http-mock.types';
+/**
+ * Global HTTP mock manager
+ *
+ * @example
+ * ```typescript
+ * import { httpMock } from '@frontmcp/testing';
+ *
+ * // Create an HTTP interceptor
+ * const interceptor = httpMock.interceptor();
+ *
+ * // Mock requests
+ * interceptor.get('https://api.example.com/data', { id: 1, name: 'Test' });
+ *
+ * // Run tests...
+ *
+ * // Clean up
+ * interceptor.restore();
+ * ```
+ */
+export declare const httpMock: HttpMockManager;
+/**
+ * Helper to create mock responses
+ */
+export declare const httpResponse: {
+    /** Create a JSON response */
+    json<T>(data: T, status?: number): HttpMockResponse;
+    /** Create a text response */
+    text(data: string, status?: number): HttpMockResponse;
+    /** Create an HTML response */
+    html(data: string, status?: number): HttpMockResponse;
+    /** Create an error response */
+    error(status: number, message?: string): HttpMockResponse;
+    /** Create a 404 Not Found response */
+    notFound(message?: string): HttpMockResponse;
+    /** Create a 500 Internal Server Error response */
+    serverError(message?: string): HttpMockResponse;
+    /** Create a 401 Unauthorized response */
+    unauthorized(message?: string): HttpMockResponse;
+    /** Create a 403 Forbidden response */
+    forbidden(message?: string): HttpMockResponse;
+    /**
+     * Create a network error that causes fetch to reject
+     * This simulates real network failures where fetch throws instead of returning a Response
+     */
+    networkError(message?: string): HttpMockResponse;
+    /** Create a delayed response */
+    delayed<T>(data: T, delayMs: number, status?: number): HttpMockResponse;
+};