truss-api-mcp 1.0.0

package/dist/lib/openapi-parser.js

@@ -0,0 +1,390 @@
+import * as yaml from 'js-yaml';
+const HTTP_METHODS = ['get', 'post', 'put', 'patch', 'delete', 'head', 'options'];
+/**
+ * Parse an OpenAPI 3.x or Swagger 2.0 spec from JSON or YAML string.
+ */
+export function parseOpenApiSpec(input) {
+    let doc;
+    // Try JSON first, then YAML
+    try {
+        doc = JSON.parse(input);
+    }
+    catch {
+        try {
+            doc = yaml.load(input);
+        }
+        catch (yamlErr) {
+            throw new Error(`Failed to parse spec as JSON or YAML: ${yamlErr instanceof Error ? yamlErr.message : String(yamlErr)}`);
+        }
+    }
+    if (!doc || typeof doc !== 'object') {
+        throw new Error('Spec must be a valid JSON or YAML object');
+    }
+    // Detect version
+    const isSwagger2 = typeof doc.swagger === 'string' && doc.swagger.startsWith('2.');
+    const isOpenApi3 = typeof doc.openapi === 'string' && doc.openapi.startsWith('3.');
+    if (!isSwagger2 && !isOpenApi3) {
+        throw new Error('Unsupported spec: must be OpenAPI 3.x or Swagger 2.0');
+    }
+    // Build a flat definitions map for $ref resolution
+    const definitions = buildDefinitions(doc);
+    const info = extractInfo(doc);
+    const servers = isOpenApi3 ? extractServers(doc) : extractSwagger2Servers(doc);
+    const endpoints = extractEndpoints(doc, definitions, isSwagger2);
+    return { info, servers, endpoints };
+}
+// ── Info ────────────────────────────────────────────────────────────
+function extractInfo(doc) {
+    const info = (doc.info ?? {});
+    return {
+        title: String(info.title ?? 'Untitled API'),
+        version: String(info.version ?? '0.0.0'),
+        description: info.description ? String(info.description) : undefined,
+    };
+}
+// ── Servers ─────────────────────────────────────────────────────────
+function extractServers(doc) {
+    const servers = doc.servers;
+    if (!Array.isArray(servers) || servers.length === 0)
+        return undefined;
+    return servers.map((s) => ({
+        url: String(s.url ?? ''),
+        description: s.description ? String(s.description) : undefined,
+    }));
+}
+function extractSwagger2Servers(doc) {
+    const host = doc.host;
+    const basePath = doc.basePath ?? '';
+    const schemes = doc.schemes ?? ['https'];
+    if (!host)
+        return undefined;
+    return schemes.map((scheme) => ({ url: `${scheme}://${host}${basePath}` }));
+}
+// ── Definitions / Components ────────────────────────────────────────
+function buildDefinitions(doc) {
+    const defs = new Map();
+    // OpenAPI 3.x components/schemas
+    const components = doc.components;
+    if (components?.schemas && typeof components.schemas === 'object') {
+        for (const [name, schema] of Object.entries(components.schemas)) {
+            defs.set(`#/components/schemas/${name}`, schema);
+        }
+    }
+    // Swagger 2.0 definitions
+    const definitions = doc.definitions;
+    if (definitions && typeof definitions === 'object') {
+        for (const [name, schema] of Object.entries(definitions)) {
+            defs.set(`#/definitions/${name}`, schema);
+        }
+    }
+    return defs;
+}
+function resolveRef(schema, defs, depth = 0) {
+    if (depth > 20)
+        return schema; // prevent infinite recursion
+    if (schema.$ref) {
+        const resolved = defs.get(schema.$ref);
+        if (resolved)
+            return resolveRef(resolved, defs, depth + 1);
+        // Unresolvable ref — return a stub
+        return { type: 'object', description: `Unresolved: ${schema.$ref}` };
+    }
+    return schema;
+}
+// ── Endpoints ───────────────────────────────────────────────────────
+function extractEndpoints(doc, defs, isSwagger2) {
+    const paths = doc.paths;
+    if (!paths)
+        return [];
+    const endpoints = [];
+    for (const [path, pathItem] of Object.entries(paths)) {
+        if (!pathItem || typeof pathItem !== 'object')
+            continue;
+        // Path-level parameters
+        const pathParams = (pathItem.parameters ?? []);
+        for (const method of HTTP_METHODS) {
+            const operation = pathItem[method];
+            if (!operation)
+                continue;
+            const operationParams = (operation.parameters ?? []);
+            const allParams = [...pathParams, ...operationParams];
+            const parameters = extractParameters(allParams, defs, isSwagger2);
+            const requestBody = isSwagger2
+                ? extractSwagger2Body(allParams, defs)
+                : extractRequestBody(operation, defs);
+            const responses = extractResponses(operation, defs, isSwagger2);
+            const tags = Array.isArray(operation.tags) ? operation.tags.map(String) : undefined;
+            endpoints.push({
+                method: method.toUpperCase(),
+                path,
+                summary: String(operation.summary ?? operation.description ?? ''),
+                operationId: operation.operationId ? String(operation.operationId) : undefined,
+                parameters,
+                requestBody: requestBody ?? undefined,
+                responses,
+                tags,
+            });
+        }
+    }
+    return endpoints;
+}
+function extractParameters(params, defs, isSwagger2) {
+    return params
+        .filter((p) => {
+        // Skip body params in Swagger 2 — handled separately
+        if (isSwagger2 && p.in === 'body')
+            return false;
+        return p.in === 'query' || p.in === 'path' || p.in === 'header' || p.in === 'cookie';
+    })
+        .map((p) => {
+        let schema;
+        if (p.schema) {
+            schema = resolveRef(p.schema, defs);
+        }
+        else if (isSwagger2 && p.type) {
+            schema = { type: String(p.type) };
+        }
+        return {
+            name: String(p.name ?? ''),
+            in: p.in,
+            required: Boolean(p.required),
+            description: p.description ? String(p.description) : undefined,
+            schema,
+        };
+    });
+}
+function extractRequestBody(operation, defs) {
+    const rb = operation.requestBody;
+    if (!rb)
+        return null;
+    const content = rb.content;
+    if (!content)
+        return null;
+    // Prefer application/json
+    const jsonContent = content['application/json'] ?? content[Object.keys(content)[0]];
+    if (!jsonContent?.schema)
+        return null;
+    return resolveRef(jsonContent.schema, defs);
+}
+function extractSwagger2Body(params, defs) {
+    const bodyParam = params.find((p) => p.in === 'body');
+    if (!bodyParam?.schema)
+        return null;
+    return resolveRef(bodyParam.schema, defs);
+}
+function extractResponses(operation, defs, isSwagger2) {
+    const responses = operation.responses;
+    if (!responses)
+        return [];
+    return Object.entries(responses).map(([status, resp]) => {
+        let schema;
+        if (isSwagger2) {
+            if (resp.schema) {
+                schema = resolveRef(resp.schema, defs);
+            }
+        }
+        else {
+            const content = resp.content;
+            if (content) {
+                const jsonContent = content['application/json'] ?? content[Object.keys(content)[0]];
+                if (jsonContent?.schema) {
+                    schema = resolveRef(jsonContent.schema, defs);
+                }
+            }
+        }
+        return {
+            status,
+            description: String(resp.description ?? ''),
+            schema,
+        };
+    });
+}
+/**
+ * Auto-generate an OpenAPI 3.0 spec from a set of request/response examples.
+ */
+export function generateOpenApiFromExamples(examples) {
+    // Group examples by path pattern
+    const endpointMap = new Map();
+    for (const ex of examples) {
+        let urlPath;
+        try {
+            const parsed = new URL(ex.url);
+            urlPath = parsed.pathname;
+        }
+        catch {
+            urlPath = ex.url;
+        }
+        // Normalize numeric segments to path params
+        const normalized = urlPath.replace(/\/(\d+)/g, '/{id}');
+        const key = `${ex.method.toUpperCase()} ${normalized}`;
+        if (!endpointMap.has(key))
+            endpointMap.set(key, []);
+        endpointMap.get(key).push(ex);
+    }
+    // Extract base URL from first example
+    let baseUrl = '';
+    try {
+        const parsed = new URL(examples[0].url);
+        baseUrl = `${parsed.protocol}//${parsed.host}`;
+    }
+    catch {
+        baseUrl = 'http://localhost:3000';
+    }
+    // Build paths
+    const paths = {};
+    for (const [key, exs] of endpointMap) {
+        const [method, path] = key.split(' ', 2);
+        if (!paths[path])
+            paths[path] = {};
+        const example = exs[0];
+        const methodLower = method.toLowerCase();
+        // Infer path parameters
+        const pathParams = [];
+        const paramMatches = path.match(/\{(\w+)\}/g);
+        if (paramMatches) {
+            for (const match of paramMatches) {
+                const name = match.replace(/[{}]/g, '');
+                pathParams.push({
+                    name,
+                    in: 'path',
+                    required: true,
+                    schema: { type: 'integer' },
+                });
+            }
+        }
+        // Infer query parameters from URL
+        const queryParams = [];
+        try {
+            const parsed = new URL(example.url);
+            for (const [qname, qvalue] of parsed.searchParams) {
+                queryParams.push({
+                    name: qname,
+                    in: 'query',
+                    required: false,
+                    schema: { type: inferJsonType(qvalue) },
+                    example: qvalue,
+                });
+            }
+        }
+        catch {
+            // ignore
+        }
+        const operation = {
+            summary: `${method} ${path}`,
+            operationId: `${methodLower}${path.replace(/[/{}\-]/g, '_').replace(/_+/g, '_').replace(/^_|_$/g, '')}`,
+            parameters: [...pathParams, ...queryParams],
+            responses: {},
+        };
+        // Request body
+        if (example.request_body !== undefined && example.request_body !== null) {
+            operation.requestBody = {
+                required: true,
+                content: {
+                    'application/json': {
+                        schema: inferSchema(example.request_body),
+                        example: example.request_body,
+                    },
+                },
+            };
+        }
+        // Responses — collect all unique status codes
+        const statusCodes = new Set(exs.map((e) => e.status));
+        const responses = {};
+        for (const status of statusCodes) {
+            const statusExample = exs.find((e) => e.status === status);
+            responses[String(status)] = {
+                description: describeStatus(status),
+                content: statusExample?.response_body !== undefined
+                    ? {
+                        'application/json': {
+                            schema: inferSchema(statusExample.response_body),
+                            example: statusExample.response_body,
+                        },
+                    }
+                    : undefined,
+            };
+        }
+        operation.responses = responses;
+        paths[path][methodLower] = operation;
+    }
+    const spec = {
+        openapi: '3.0.3',
+        info: {
+            title: 'Auto-Generated API',
+            version: '1.0.0',
+            description: `Generated from ${examples.length} example request(s)`,
+        },
+        servers: [{ url: baseUrl }],
+        paths,
+    };
+    return yaml.dump(spec, { lineWidth: 120, noRefs: true, sortKeys: false });
+}
+function inferJsonType(value) {
+    if (value === null || value === undefined)
+        return 'string';
+    if (typeof value === 'number' || (typeof value === 'string' && !isNaN(Number(value)) && value !== '')) {
+        return Number.isInteger(Number(value)) ? 'integer' : 'number';
+    }
+    if (typeof value === 'boolean' || value === 'true' || value === 'false')
+        return 'boolean';
+    if (Array.isArray(value))
+        return 'array';
+    if (typeof value === 'object')
+        return 'object';
+    return 'string';
+}
+function inferSchema(value) {
+    if (value === null || value === undefined) {
+        return { type: 'string', nullable: true };
+    }
+    if (typeof value === 'string') {
+        const schema = { type: 'string' };
+        if (/^\d{4}-\d{2}-\d{2}/.test(value))
+            schema.format = 'date-time';
+        if (/^[^@]+@[^@]+\.[^@]+$/.test(value))
+            schema.format = 'email';
+        if (/^https?:\/\//.test(value))
+            schema.format = 'uri';
+        return schema;
+    }
+    if (typeof value === 'number') {
+        return Number.isInteger(value) ? { type: 'integer' } : { type: 'number' };
+    }
+    if (typeof value === 'boolean') {
+        return { type: 'boolean' };
+    }
+    if (Array.isArray(value)) {
+        return {
+            type: 'array',
+            items: value.length > 0 ? inferSchema(value[0]) : { type: 'string' },
+        };
+    }
+    if (typeof value === 'object') {
+        const properties = {};
+        const required = [];
+        for (const [k, v] of Object.entries(value)) {
+            properties[k] = inferSchema(v);
+            if (v !== null && v !== undefined)
+                required.push(k);
+        }
+        return { type: 'object', properties, required: required.length > 0 ? required : undefined };
+    }
+    return { type: 'string' };
+}
+function describeStatus(status) {
+    const descriptions = {
+        200: 'Successful response',
+        201: 'Resource created',
+        204: 'No content',
+        400: 'Bad request',
+        401: 'Unauthorized',
+        403: 'Forbidden',
+        404: 'Not found',
+        409: 'Conflict',
+        422: 'Unprocessable entity',
+        429: 'Too many requests',
+        500: 'Internal server error',
+    };
+    return descriptions[status] ?? `HTTP ${status}`;
+}
+//# sourceMappingURL=openapi-parser.js.map

package/dist/lib/openapi-parser.js.map

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

package/dist/lib/schema-validator.d.ts

@@ -0,0 +1,15 @@
+import type { JsonSchema, ValidationResult } from '../types.js';
+/**
+ * Validate a value against a JSON Schema (draft-07 subset).
+ * Supports: type, properties, required, items, enum, minimum, maximum,
+ * minLength, maxLength, pattern, additionalProperties, oneOf, anyOf, allOf, nullable.
+ */
+export declare function validateSchema(value: unknown, schema: JsonSchema, path?: string): ValidationResult;
+/**
+ * Validate an HTTP response against expected status and optional schema.
+ */
+export declare function validateResponse(response: {
+    status: number;
+    body: unknown;
+}, expectedStatus: number, expectedSchema?: JsonSchema): ValidationResult;
+//# sourceMappingURL=schema-validator.d.ts.map

package/dist/lib/schema-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-validator.d.ts","sourceRoot":"","sources":["../../src/lib/schema-validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAmB,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEjF;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,UAAU,EAClB,IAAI,SAAM,GACT,gBAAgB,CAIlB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,EAC3C,cAAc,EAAE,MAAM,EACtB,cAAc,CAAC,EAAE,UAAU,GAC1B,gBAAgB,CAkBlB"}

package/dist/lib/schema-validator.js

@@ -0,0 +1,206 @@
+/**
+ * Validate a value against a JSON Schema (draft-07 subset).
+ * Supports: type, properties, required, items, enum, minimum, maximum,
+ * minLength, maxLength, pattern, additionalProperties, oneOf, anyOf, allOf, nullable.
+ */
+export function validateSchema(value, schema, path = '$') {
+    const errors = [];
+    validate(value, schema, path, errors);
+    return { valid: errors.length === 0, errors };
+}
+/**
+ * Validate an HTTP response against expected status and optional schema.
+ */
+export function validateResponse(response, expectedStatus, expectedSchema) {
+    const errors = [];
+    if (response.status !== expectedStatus) {
+        errors.push({
+            path: '$.status',
+            message: `Expected status ${expectedStatus}, got ${response.status}`,
+            expected: String(expectedStatus),
+            actual: String(response.status),
+        });
+    }
+    if (expectedSchema) {
+        const bodyResult = validateSchema(response.body, expectedSchema, '$.body');
+        errors.push(...bodyResult.errors);
+    }
+    return { valid: errors.length === 0, errors };
+}
+// ── Internal Validation ─────────────────────────────────────────────
+function validate(value, schema, path, errors) {
+    // Handle nullable
+    if (schema.nullable && (value === null || value === undefined)) {
+        return;
+    }
+    // allOf: all must match
+    if (schema.allOf) {
+        for (const sub of schema.allOf) {
+            validate(value, sub, path, errors);
+        }
+        return;
+    }
+    // anyOf: at least one must match
+    if (schema.anyOf) {
+        const anyErrors = [];
+        for (const sub of schema.anyOf) {
+            const subErrors = [];
+            validate(value, sub, path, subErrors);
+            if (subErrors.length === 0)
+                return; // matched
+            anyErrors.push(subErrors);
+        }
+        errors.push({
+            path,
+            message: `Value does not match any of the ${schema.anyOf.length} schemas in anyOf`,
+        });
+        return;
+    }
+    // oneOf: exactly one must match
+    if (schema.oneOf) {
+        let matchCount = 0;
+        for (const sub of schema.oneOf) {
+            const subErrors = [];
+            validate(value, sub, path, subErrors);
+            if (subErrors.length === 0)
+                matchCount++;
+        }
+        if (matchCount !== 1) {
+            errors.push({
+                path,
+                message: `Value must match exactly one schema in oneOf, but matched ${matchCount}`,
+            });
+        }
+        return;
+    }
+    // enum
+    if (schema.enum) {
+        if (!schema.enum.some((e) => JSON.stringify(e) === JSON.stringify(value))) {
+            errors.push({
+                path,
+                message: `Value must be one of: ${schema.enum.map((e) => JSON.stringify(e)).join(', ')}`,
+                actual: JSON.stringify(value),
+            });
+        }
+        return;
+    }
+    // type checking
+    if (schema.type) {
+        const types = Array.isArray(schema.type) ? schema.type : [schema.type];
+        const actualType = getJsonType(value);
+        if (!types.includes(actualType)) {
+            // Allow integer to match number
+            if (!(actualType === 'integer' && types.includes('number'))) {
+                // Allow null if nullable
+                if (!(actualType === 'null' && schema.nullable)) {
+                    errors.push({
+                        path,
+                        message: `Expected type ${types.join('|')}, got ${actualType}`,
+                        expected: types.join('|'),
+                        actual: actualType,
+                    });
+                    return;
+                }
+            }
+        }
+    }
+    // string validations
+    if (typeof value === 'string') {
+        if (schema.minLength !== undefined && value.length < schema.minLength) {
+            errors.push({
+                path,
+                message: `String length ${value.length} is less than minimum ${schema.minLength}`,
+            });
+        }
+        if (schema.maxLength !== undefined && value.length > schema.maxLength) {
+            errors.push({
+                path,
+                message: `String length ${value.length} exceeds maximum ${schema.maxLength}`,
+            });
+        }
+        if (schema.pattern) {
+            try {
+                if (!new RegExp(schema.pattern).test(value)) {
+                    errors.push({
+                        path,
+                        message: `String does not match pattern: ${schema.pattern}`,
+                    });
+                }
+            }
+            catch {
+                // Invalid regex — skip validation
+            }
+        }
+    }
+    // number validations
+    if (typeof value === 'number') {
+        if (schema.minimum !== undefined && value < schema.minimum) {
+            errors.push({
+                path,
+                message: `Value ${value} is less than minimum ${schema.minimum}`,
+            });
+        }
+        if (schema.maximum !== undefined && value > schema.maximum) {
+            errors.push({
+                path,
+                message: `Value ${value} exceeds maximum ${schema.maximum}`,
+            });
+        }
+    }
+    // object validations
+    if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+        const obj = value;
+        // required
+        if (schema.required) {
+            for (const req of schema.required) {
+                if (!(req in obj)) {
+                    errors.push({
+                        path: `${path}.${req}`,
+                        message: `Missing required property: ${req}`,
+                    });
+                }
+            }
+        }
+        // properties
+        if (schema.properties) {
+            for (const [key, propSchema] of Object.entries(schema.properties)) {
+                if (key in obj) {
+                    validate(obj[key], propSchema, `${path}.${key}`, errors);
+                }
+            }
+        }
+        // additionalProperties
+        if (schema.additionalProperties === false && schema.properties) {
+            const allowed = new Set(Object.keys(schema.properties));
+            for (const key of Object.keys(obj)) {
+                if (!allowed.has(key)) {
+                    errors.push({
+                        path: `${path}.${key}`,
+                        message: `Additional property not allowed: ${key}`,
+                    });
+                }
+            }
+        }
+    }
+    // array validations
+    if (Array.isArray(value)) {
+        if (schema.items) {
+            for (let i = 0; i < value.length; i++) {
+                validate(value[i], schema.items, `${path}[${i}]`, errors);
+            }
+        }
+    }
+}
+function getJsonType(value) {
+    if (value === null)
+        return 'null';
+    if (value === undefined)
+        return 'null';
+    if (Array.isArray(value))
+        return 'array';
+    if (typeof value === 'number') {
+        return Number.isInteger(value) ? 'integer' : 'number';
+    }
+    return typeof value; // 'string', 'boolean', 'object'
+}
+//# sourceMappingURL=schema-validator.js.map

package/dist/lib/schema-validator.js.map

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

package/dist/tools/compare-specs.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerCompareSpecs(server: McpServer): void;
+//# sourceMappingURL=compare-specs.d.ts.map

package/dist/tools/compare-specs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare-specs.d.ts","sourceRoot":"","sources":["../../src/tools/compare-specs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA4D5D"}