swagger-parser-mcp-server 2.0.4 → 2.3.0

package/dist/transport/httpSnapshotServer.js

@@ -0,0 +1,216 @@
+import { readFile } from 'node:fs/promises';
+import { createServer } from 'node:http';
+import path from 'node:path';
+import { URL } from 'node:url';
+import { TOOL_NAMES } from './mcpToolRouter.js';
+function normalizePath(pathname) {
+    if (pathname === '/') {
+        return pathname;
+    }
+    return pathname.replace(/\/+$/, '');
+}
+function normalizeBasePath(basePath) {
+    if (!basePath.startsWith('/')) {
+        return `/${basePath}`;
+    }
+    return normalizePath(basePath);
+}
+function sendJson(response, statusCode, payload) {
+    response.statusCode = statusCode;
+    response.setHeader('content-type', 'application/json; charset=utf-8');
+    response.end(JSON.stringify(payload));
+}
+function sendText(response, statusCode, payload, contentType) {
+    response.statusCode = statusCode;
+    response.setHeader('content-type', contentType);
+    response.end(payload);
+}
+function uniqueStringValues(values) {
+    const deduped = [];
+    for (const value of values) {
+        if (!value) {
+            continue;
+        }
+        if (!deduped.includes(value)) {
+            deduped.push(value);
+        }
+    }
+    return deduped;
+}
+function resolveDashboardAssetPathCandidates(customAssetsDir) {
+    const cwdSourceDirectory = path.resolve(process.cwd(), 'src', 'web');
+    const cwdDistDirectory = path.resolve(process.cwd(), 'dist', 'web');
+    return uniqueStringValues([
+        customAssetsDir,
+        process.env.SNAPSHOT_DASHBOARD_ASSETS_DIR,
+        cwdSourceDirectory,
+        cwdDistDirectory,
+    ]);
+}
+const DASHBOARD_ROUTE_TO_ASSET = {
+    '/dashboard': 'dashboard.html',
+    '/dashboard.css': 'dashboard.css',
+    '/dashboard.js': 'dashboard.js',
+};
+const DASHBOARD_CONTENT_TYPE = {
+    '/dashboard': 'text/html; charset=utf-8',
+    '/dashboard.css': 'text/css; charset=utf-8',
+    '/dashboard.js': 'application/javascript; charset=utf-8',
+};
+function isDashboardAssetRoute(pathname) {
+    return pathname === '/dashboard' || pathname === '/dashboard.css' || pathname === '/dashboard.js';
+}
+function createDashboardAssetLoader(customAssetsDir) {
+    const cache = new Map();
+    const directories = resolveDashboardAssetPathCandidates(customAssetsDir);
+    return {
+        async load(route) {
+            const cached = cache.get(route);
+            if (cached) {
+                return { contentType: DASHBOARD_CONTENT_TYPE[route], body: cached };
+            }
+            const fileName = DASHBOARD_ROUTE_TO_ASSET[route];
+            const errors = [];
+            for (const directory of directories) {
+                const targetPath = path.join(directory, fileName);
+                try {
+                    const file = await readFile(targetPath, 'utf8');
+                    cache.set(route, file);
+                    return { contentType: DASHBOARD_CONTENT_TYPE[route], body: file };
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    errors.push(`${targetPath}: ${message}`);
+                }
+            }
+            throw new Error(`Failed to load dashboard asset "${fileName}". ${errors.join(' | ')}`);
+        },
+    };
+}
+async function executeTool(response, toolRouter, name, args) {
+    const result = await toolRouter.executeStructured(name, args);
+    if (result.ok) {
+        sendJson(response, result.statusCode, result.data);
+        return;
+    }
+    sendJson(response, result.statusCode, {
+        error: result.error.message,
+        code: result.error.code,
+    });
+}
+function parseListSnapshotsArgs(url) {
+    const limit = url.searchParams.get('limit');
+    if (limit === null) {
+        return {};
+    }
+    return {
+        limit: Number(limit),
+    };
+}
+function parseChangeHistoryArgs(url) {
+    const limit = url.searchParams.get('limit');
+    const path = url.searchParams.get('path');
+    const method = url.searchParams.get('method');
+    return {
+        ...(limit === null ? {} : { limit: Number(limit) }),
+        ...(path === null ? {} : { path }),
+        ...(method === null ? {} : { method }),
+    };
+}
+function parseSnapshotDiffArgs(url) {
+    return {
+        baselineSnapshotId: url.searchParams.get('baselineSnapshotId'),
+        targetSnapshotId: url.searchParams.get('targetSnapshotId'),
+    };
+}
+function parseEndpointDetailArgs(url) {
+    return {
+        baselineSnapshotId: url.searchParams.get('baselineSnapshotId'),
+        targetSnapshotId: url.searchParams.get('targetSnapshotId'),
+        path: url.searchParams.get('path'),
+        method: url.searchParams.get('method'),
+    };
+}
+async function handleRequest(request, response, toolRouter, basePath, assetLoader) {
+    const method = request.method ?? 'GET';
+    const parsedUrl = new URL(request.url ?? '/', 'http://localhost');
+    const path = normalizePath(parsedUrl.pathname);
+    const diffPath = `${basePath}/diff`;
+    const changeHistoryPath = `${basePath}/change-history`;
+    const endpointDetailPath = `${basePath}/endpoint-detail`;
+    const capturePath = `${basePath}/capture`;
+    if (method === 'GET' && path === '/health') {
+        sendJson(response, 200, { ok: true });
+        return;
+    }
+    if (method === 'GET' && path === '/') {
+        response.statusCode = 302;
+        response.setHeader('location', '/dashboard');
+        response.end();
+        return;
+    }
+    if (isDashboardAssetRoute(path)) {
+        if (method !== 'GET') {
+            sendJson(response, 405, { error: 'Method not allowed', code: 'METHOD_NOT_ALLOWED' });
+            return;
+        }
+        const asset = await assetLoader.load(path);
+        sendText(response, 200, asset.body, asset.contentType);
+        return;
+    }
+    if (path === capturePath) {
+        if (method !== 'POST') {
+            sendJson(response, 405, { error: 'Method not allowed', code: 'METHOD_NOT_ALLOWED' });
+            return;
+        }
+        await executeTool(response, toolRouter, TOOL_NAMES.CAPTURE_SNAPSHOT, {});
+        return;
+    }
+    if (path === basePath) {
+        if (method !== 'GET') {
+            sendJson(response, 405, { error: 'Method not allowed', code: 'METHOD_NOT_ALLOWED' });
+            return;
+        }
+        await executeTool(response, toolRouter, TOOL_NAMES.LIST_SNAPSHOTS, parseListSnapshotsArgs(parsedUrl));
+        return;
+    }
+    if (path === diffPath) {
+        if (method !== 'GET') {
+            sendJson(response, 405, { error: 'Method not allowed', code: 'METHOD_NOT_ALLOWED' });
+            return;
+        }
+        await executeTool(response, toolRouter, TOOL_NAMES.GET_SNAPSHOT_DIFF, parseSnapshotDiffArgs(parsedUrl));
+        return;
+    }
+    if (path === changeHistoryPath) {
+        if (method !== 'GET') {
+            sendJson(response, 405, { error: 'Method not allowed', code: 'METHOD_NOT_ALLOWED' });
+            return;
+        }
+        await executeTool(response, toolRouter, TOOL_NAMES.LIST_ENDPOINT_CHANGE_HISTORY, parseChangeHistoryArgs(parsedUrl));
+        return;
+    }
+    if (path === endpointDetailPath) {
+        if (method !== 'GET') {
+            sendJson(response, 405, { error: 'Method not allowed', code: 'METHOD_NOT_ALLOWED' });
+            return;
+        }
+        await executeTool(response, toolRouter, TOOL_NAMES.GET_ENDPOINT_DIFF_DETAIL, parseEndpointDetailArgs(parsedUrl));
+        return;
+    }
+    sendJson(response, 404, { error: 'Not found', code: 'NOT_FOUND' });
+}
+export function createHttpSnapshotServer(deps) {
+    const basePath = normalizeBasePath(deps.basePath ?? '/api/snapshots');
+    const assetLoader = createDashboardAssetLoader(deps.dashboardAssetsDir);
+    return createServer((request, response) => {
+        handleRequest(request, response, deps.toolRouter, basePath, assetLoader).catch(error => {
+            const message = error instanceof Error ? error.message : 'Unknown error occurred';
+            sendJson(response, 500, {
+                error: message,
+                code: 'INTERNAL_ERROR',
+            });
+        });
+    });
+}
+//# sourceMappingURL=httpSnapshotServer.js.map

package/dist/transport/httpSnapshotServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpSnapshotServer.js","sourceRoot":"","sources":["../../src/transport/httpSnapshotServer.ts"],"names":[],"mappings":"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"}

package/dist/transport/mcpToolRouter.d.ts

@@ -0,0 +1,81 @@
+import { RuntimeEnvironment } from '../domain/contracts/runtimeEnvironmentContract.js';
+import { EndpointChangeHistoryEvent, EndpointDiffDetailInput, EndpointDiffDetailResult, SnapshotCaptureBootstrapResult, SnapshotCaptureResult, SnapshotListItem, SnapshotReplayInput } from '../application/snapshot/snapshotCaptureService.js';
+import { snapshotDiffResultSchema } from '../domain/contracts/snapshotDiffContract.js';
+import { OpenAPIDocument } from '../utils/types.js';
+export declare const TOOL_NAMES: {
+    readonly LOAD_SWAGGER: "load_swagger";
+    readonly GET_CONTROLLERS: "get_controllers";
+    readonly GET_PATHS_BY_CONTROLLER: "get_paths_by_controller";
+    readonly GET_PATH_DETAILS: "get_path_details";
+    readonly RESOLVE_SCHEMA: "resolve_schema";
+    readonly CAPTURE_SNAPSHOT: "capture_snapshot";
+    readonly LIST_SNAPSHOTS: "list_snapshots";
+    readonly LIST_ENDPOINT_CHANGE_HISTORY: "list_endpoint_change_history";
+    readonly GET_SNAPSHOT_DIFF: "get_snapshot_diff";
+    readonly GET_ENDPOINT_DIFF_DETAIL: "get_endpoint_diff_detail";
+};
+export type ToolName = (typeof TOOL_NAMES)[keyof typeof TOOL_NAMES];
+export type ToolResponse = {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+};
+export type StructuredToolError = {
+    code: string;
+    message: string;
+};
+export type StructuredToolSuccess = {
+    ok: true;
+    statusCode: 200;
+    data: unknown;
+};
+export type StructuredToolFailure = {
+    ok: false;
+    statusCode: number;
+    error: StructuredToolError;
+};
+export type StructuredToolResult = StructuredToolSuccess | StructuredToolFailure;
+interface SnapshotServicePort {
+    capture(env: RuntimeEnvironment | NodeJS.ProcessEnv): Promise<SnapshotCaptureResult>;
+    bootstrap(env: RuntimeEnvironment | NodeJS.ProcessEnv): Promise<SnapshotCaptureBootstrapResult>;
+    listSnapshotsBySource(sourceId: string, limit?: number): Promise<SnapshotListItem[]>;
+    listEndpointChangeHistory(input: {
+        sourceId: string;
+        limit?: number;
+        path?: string;
+        method?: EndpointChangeHistoryEvent['method'];
+    }): Promise<EndpointChangeHistoryEvent[]>;
+    replayDiff(input: SnapshotReplayInput): Promise<ReturnType<typeof snapshotDiffResultSchema.parse>>;
+    getEndpointDiffDetail(input: EndpointDiffDetailInput): Promise<EndpointDiffDetailResult>;
+}
+interface SnapshotRuntimePort {
+    environment: RuntimeEnvironment;
+    service: SnapshotServicePort;
+}
+type RuntimeProvider = () => Promise<SnapshotRuntimePort>;
+interface SwaggerCachePort {
+    load(url: string): Promise<OpenAPIDocument>;
+    getOrLoad(url: string): Promise<OpenAPIDocument>;
+}
+interface SchemaResolverPort {
+    resolveRef(ref: string, swagger: OpenAPIDocument): unknown;
+    resolveSchemaReference(schema: unknown, swagger: OpenAPIDocument): unknown;
+}
+export interface McpToolRouterDeps {
+    swaggerCache: SwaggerCachePort;
+    schemaResolver: SchemaResolverPort;
+    runtimeProvider: RuntimeProvider;
+}
+export interface McpToolRouter {
+    listTools(): Array<{
+        name: ToolName;
+        description: string;
+        inputSchema: object;
+    }>;
+    execute(name: string, args: unknown): Promise<ToolResponse>;
+    executeStructured(name: string, args: unknown): Promise<StructuredToolResult>;
+}
+export declare function createMcpToolRouter(deps: McpToolRouterDeps): McpToolRouter;
+export {};
+//# sourceMappingURL=mcpToolRouter.d.ts.map

package/dist/transport/mcpToolRouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpToolRouter.d.ts","sourceRoot":"","sources":["../../src/transport/mcpToolRouter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AACvF,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,EACxB,8BAA8B,EAC9B,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,mDAAmD,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,6CAA6C,CAAC;AAgBvF,OAAO,EAEL,eAAe,EAOhB,MAAM,mBAAmB,CAAC;AAE3B,eAAO,MAAM,UAAU;;;;;;;;;;;CAWb,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAIpE,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,EAAE,EAAE,IAAI,CAAC;IACT,UAAU,EAAE,GAAG,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,EAAE,EAAE,KAAK,CAAC;IACV,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,mBAAmB,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,qBAAqB,GAAG,qBAAqB,CAAC;AAUjF,UAAU,mBAAmB;IAC3B,OAAO,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAAC,UAAU,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACrF,SAAS,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAAC,UAAU,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAAC;IAChG,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IACrF,yBAAyB,CAAC,KAAK,EAAE;QAC/B,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,0BAA0B,CAAC,QAAQ,CAAC,CAAC;KAC/C,GAAG,OAAO,CAAC,0BAA0B,EAAE,CAAC,CAAC;IAC1C,UAAU,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,wBAAwB,CAAC,KAAK,CAAC,CAAC,CAAC;IACnG,qBAAqB,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;CAC1F;AAED,UAAU,mBAAmB;IAC3B,WAAW,EAAE,kBAAkB,CAAC;IAChC,OAAO,EAAE,mBAAmB,CAAC;CAC9B;AAED,KAAK,eAAe,GAAG,MAAM,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAE1D,UAAU,gBAAgB;IACxB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC5C,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAClD;AAED,UAAU,kBAAkB;IAC1B,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC;IAC3D,sBAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC;CAC5E;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,gBAAgB,CAAC;IAC/B,cAAc,EAAE,kBAAkB,CAAC;IACnC,eAAe,EAAE,eAAe,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjF,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC5D,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAC/E;AA6ZD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,aAAa,CA+C1E"}