@frontmcp/testing 0.7.2 → 0.8.1

package/interceptor/interceptor-chain.d.ts

@@ -4,6 +4,7 @@
  */
 import type { JsonRpcRequest, JsonRpcResponse } from '../transport/transport.interface';
 import type { InterceptorChain, RequestInterceptor, ResponseInterceptor, InterceptorContext, MockRegistry } from './interceptor.types';
+export type { InterceptorResult, ResponseInterceptorResult } from './interceptor.types';
 /**
  * Default implementation of InterceptorChain
  */

package/interceptor/interceptor-chain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interceptor-chain.d.ts","sourceRoot":"","sources":["../../src/interceptor/interceptor-chain.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACxF,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAIlB,YAAY,EACb,MAAM,qBAAqB,CAAC;AAG7B;;GAEG;AACH,qBAAa,uBAAwB,YAAW,gBAAgB;IAC9D,OAAO,EAAE,kBAAkB,EAAE,CAAM;IACnC,QAAQ,EAAE,mBAAmB,EAAE,CAAM;IACrC,KAAK,EAAE,YAAY,CAAC;;IAMpB;;OAEG;IACH,qBAAqB,CAAC,WAAW,EAAE,kBAAkB,GAAG,MAAM,IAAI;IAUlE;;OAEG;IACH,sBAAsB,CAAC,WAAW,EAAE,mBAAmB,GAAG,MAAM,IAAI;IAUpE;;;;;;OAMG;IACG,cAAc,CAClB,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,GAC/B,OAAO,CACN;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,OAAO,EAAE,cAAc,CAAA;KAAE,GAC7C;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,eAAe,CAAA;KAAE,GAC3C;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAClC;IAyDD;;OAEG;IACG,eAAe,CACnB,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,eAAe,EACzB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,eAAe,CAAC;IA0B3B;;OAEG;IACH,KAAK,IAAI,IAAI;CAKd;AASD;;GAEG;AACH,eAAO,MAAM,YAAY;IACvB;;OAEG;mBACW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,GAAiB,kBAAkB;IAO1F;;OAEG;cACO,MAAM,GAAG,kBAAkB;IAOrC;;OAEG;wBACiB,CAAC,GAAG,EAAE,kBAAkB,KAAK,OAAO,SAAS,KAAK,GAAG,MAAM,GAAG,kBAAkB;IAUpG;;OAEG;yBACkB,MAAM,YAAY,CAAC,OAAO,EAAE,cAAc,KAAK,cAAc,GAAG,kBAAkB;IASvG;;OAEG;2BACmB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,GAAiB,mBAAmB;IAQnG;;OAEG;2BACoB,MAAM,YAAY,CAAC,QAAQ,EAAE,eAAe,KAAK,eAAe,GAAG,mBAAmB;CAQ9G,CAAC"}
+{"version":3,"file":"interceptor-chain.d.ts","sourceRoot":"","sources":["../../src/interceptor/interceptor-chain.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACxF,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAElB,YAAY,EACb,MAAM,qBAAqB,CAAC;AAI7B,YAAY,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAExF;;GAEG;AACH,qBAAa,uBAAwB,YAAW,gBAAgB;IAC9D,OAAO,EAAE,kBAAkB,EAAE,CAAM;IACnC,QAAQ,EAAE,mBAAmB,EAAE,CAAM;IACrC,KAAK,EAAE,YAAY,CAAC;;IAMpB;;OAEG;IACH,qBAAqB,CAAC,WAAW,EAAE,kBAAkB,GAAG,MAAM,IAAI;IAUlE;;OAEG;IACH,sBAAsB,CAAC,WAAW,EAAE,mBAAmB,GAAG,MAAM,IAAI;IAUpE;;;;;;OAMG;IACG,cAAc,CAClB,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,GAC/B,OAAO,CACN;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,OAAO,EAAE,cAAc,CAAA;KAAE,GAC7C;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,eAAe,CAAA;KAAE,GAC3C;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAClC;IAyDD;;OAEG;IACG,eAAe,CACnB,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,eAAe,EACzB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,eAAe,CAAC;IA0B3B;;OAEG;IACH,KAAK,IAAI,IAAI;CAKd;AASD;;GAEG;AACH,eAAO,MAAM,YAAY;IACvB;;OAEG;mBACW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,GAAiB,kBAAkB;IAO1F;;OAEG;cACO,MAAM,GAAG,kBAAkB;IAOrC;;OAEG;wBACiB,CAAC,GAAG,EAAE,kBAAkB,KAAK,OAAO,SAAS,KAAK,GAAG,MAAM,GAAG,kBAAkB;IAUpG;;OAEG;yBACkB,MAAM,YAAY,CAAC,OAAO,EAAE,cAAc,KAAK,cAAc,GAAG,kBAAkB;IASvG;;OAEG;2BACmB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,GAAiB,mBAAmB;IAQnG;;OAEG;2BACoB,MAAM,YAAY,CAAC,QAAQ,EAAE,eAAe,KAAK,eAAe,GAAG,mBAAmB;CAQ9G,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frontmcp/testing",
-  "version": "0.7.2",
+  "version": "0.8.1",
   "description": "E2E testing framework for FrontMCP servers - MCP client, auth mocks, Playwright integration",
   "author": "AgentFront <info@agentfront.dev>",
   "homepage": "https://docs.agentfront.dev",
@@ -87,8 +87,8 @@
     "./esm": null
   },
   "peerDependencies": {
-    "@frontmcp/sdk": "0.7.2",
-    "@frontmcp/ui": "0.7.2",
+    "@frontmcp/sdk": "0.8.1",
+    "@frontmcp/ui": "0.8.1",
     "@playwright/test": "^1.40.0",
     "jest": "^29.0.0",
     "@jest/globals": "^29.0.0"
@@ -111,7 +111,8 @@
     "node": ">=22.0.0"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "1.25.1",
+    "@frontmcp/utils": "0.8.1",
+    "@modelcontextprotocol/sdk": "1.25.3",
     "jose": "^6.0.11",
     "tslib": "^2.3.0"
   },

package/perf/baseline-store.d.ts

@@ -0,0 +1,67 @@
+/**
+ * @file baseline-store.ts
+ * @description Baseline storage for performance regression testing
+ *
+ * Baselines are stored as GitHub release comments and local JSON files.
+ * The storage format uses special markers for parsing:
+ *
+ * <!-- PERF_BASELINE_START -->
+ * ```json
+ * { ... baseline data ... }
+ * ```
+ * <!-- PERF_BASELINE_END -->
+ */
+import type { PerfBaseline, TestBaseline, PerfMeasurement } from './types';
+/**
+ * Manages performance baselines stored in local files or GitHub releases.
+ */
+export declare class BaselineStore {
+    private baseline;
+    private readonly baselinePath;
+    constructor(baselinePath?: string);
+    /**
+     * Load baseline from local file.
+     */
+    load(): Promise<PerfBaseline | null>;
+    /**
+     * Save baseline to local file.
+     */
+    save(baseline: PerfBaseline): Promise<void>;
+    /**
+     * Get a test baseline by ID.
+     */
+    getTestBaseline(testId: string): TestBaseline | null;
+    /**
+     * Check if baseline is loaded.
+     */
+    isLoaded(): boolean;
+    /**
+     * Get the loaded baseline.
+     */
+    getBaseline(): PerfBaseline | null;
+    /**
+     * Create a baseline from measurements.
+     */
+    static createFromMeasurements(measurements: PerfMeasurement[], release: string, commitHash?: string): PerfBaseline;
+}
+/**
+ * Parse baseline JSON from a release comment body.
+ */
+export declare function parseBaselineFromComment(commentBody: string): PerfBaseline | null;
+/**
+ * Format baseline as a GitHub release comment.
+ */
+export declare function formatBaselineAsComment(baseline: PerfBaseline): string;
+/**
+ * Build the GitHub API URL for release comments.
+ */
+export declare function buildReleaseCommentsUrl(owner: string, repo: string, releaseId: number): string;
+/**
+ * Get the global baseline store instance.
+ */
+export declare function getBaselineStore(baselinePath?: string): BaselineStore;
+/**
+ * Reset the global baseline store.
+ */
+export declare function resetBaselineStore(): void;
+//# sourceMappingURL=baseline-store.d.ts.map

package/perf/baseline-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseline-store.d.ts","sourceRoot":"","sources":["../../src/perf/baseline-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAkB,eAAe,EAAE,MAAM,SAAS,CAAC;AAc3F;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,YAAY,GAAE,MAA8B;IAIxD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAc1C;;OAEG;IACG,IAAI,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjD;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAOpD;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACH,WAAW,IAAI,YAAY,GAAG,IAAI;IAIlC;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAAC,YAAY,EAAE,eAAe,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,YAAY;CA0CnH;AAMD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAqBjF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAetE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE9F;AAyDD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,aAAa,CAKrE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}

package/perf/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @file index.ts
+ * @description Barrel exports for performance testing module
+ *
+ * @example Basic Usage
+ * ```typescript
+ * import { perfTest, expect } from '@frontmcp/testing';
+ *
+ * perfTest.describe('Cache Performance', () => {
+ *   perfTest.use({
+ *     server: 'apps/e2e/demo-e2e-cache/src/main.ts',
+ *     project: 'demo-e2e-cache',
+ *     publicMode: true,
+ *   });
+ *
+ *   perfTest('cache operations memory overhead', async ({ mcp, perf }) => {
+ *     await perf.baseline();
+ *
+ *     for (let i = 0; i < 100; i++) {
+ *       await mcp.tools.call('expensive-operation', { operationId: `test-${i}` });
+ *     }
+ *
+ *     perf.assertThresholds({ maxHeapDelta: 10 * 1024 * 1024 }); // 10MB
+ *   });
+ *
+ *   perfTest('no memory leak on repeated cache hits', async ({ mcp, perf }) => {
+ *     const result = await perf.checkLeak(
+ *       () => mcp.tools.call('expensive-operation', { operationId: 'leak-test' }),
+ *       { iterations: 50, threshold: 5 * 1024 * 1024 }
+ *     );
+ *     expect(result.hasLeak).toBe(false);
+ *   });
+ * });
+ * ```
+ */
+export type { MemoryMetrics, CpuMetrics, PerfSnapshot, PerfMeasurement, PerfIssue, PerfThresholds, LeakDetectionOptions, LeakDetectionResult, IntervalMeasurement, MemoryGraphPoint, ParallelTestClient, WorkerStats, ParallelLeakDetectionOptions, ParallelLeakDetectionResult, MetricBaseline, TestBaseline, PerfBaseline, RegressionConfig, MetricRegression, RegressionResult, PerfTestSummary, ProjectSummary, PerfReport, PerfFixtures, PerfTestFixtures, PerfTestConfig, } from './types';
+export { MetricsCollector, isGcAvailable, forceGc, forceFullGc, formatBytes, formatMicroseconds, formatDuration, getGlobalCollector, resetGlobalCollector, } from './metrics-collector';
+export { LeakDetector, assertNoLeak, createLeakDetector } from './leak-detector';
+export { createPerfFixtures, PerfFixturesImpl, addGlobalMeasurement, getGlobalMeasurements, clearGlobalMeasurements, getMeasurementsForProject, } from './perf-fixtures';
+export { perfTest, type PerfTestFn, type PerfTestWithFixtures } from './perf-test';
+export { BaselineStore, parseBaselineFromComment, formatBaselineAsComment, buildReleaseCommentsUrl, getBaselineStore, resetBaselineStore, } from './baseline-store';
+export { RegressionDetector, summarizeRegressions, filterByStatus, getMostSevereMetric, getRegressionDetector, resetRegressionDetector, } from './regression-detector';
+export { ReportGenerator, saveReports, createReportGenerator } from './report-generator';
+//# sourceMappingURL=index.d.ts.map

package/perf/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/perf/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAMH,YAAY,EAEV,aAAa,EACb,UAAU,EACV,YAAY,EAGZ,eAAe,EACf,SAAS,EACT,cAAc,EAGd,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAGhB,kBAAkB,EAClB,WAAW,EACX,4BAA4B,EAC5B,2BAA2B,EAG3B,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAGhB,eAAe,EACf,cAAc,EACd,UAAU,EAGV,YAAY,EACZ,gBAAgB,EAChB,cAAc,GACf,MAAM,SAAS,CAAC;AAMjB,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,OAAO,EACP,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAM7B,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAMjF,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,iBAAiB,CAAC;AAMzB,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAMnF,OAAO,EACL,aAAa,EACb,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAM1B,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAM/B,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC"}