mcp-from-openapi 2.1.0 → 2.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-from-openapi",
-  "version": "2.1.0",
+  "version": "2.1.2",
   "description": "Production-ready library for converting OpenAPI specifications into MCP tool definitions",
   "author": "AgentFront <info@agentfront.dev>",
   "license": "Apache-2.0",
@@ -30,18 +30,27 @@
   "engines": {
     "node": ">=18.0.0"
   },
-  "main": "./src/index.js",
-  "types": "./src/index.d.ts",
+  "type": "commonjs",
+  "main": "./index.js",
+  "module": "./esm/index.mjs",
+  "types": "./index.d.ts",
+  "sideEffects": false,
   "exports": {
     "./package.json": "./package.json",
     ".": {
-      "types": "./src/index.d.ts",
-      "import": "./src/index.js",
-      "default": "./src/index.js"
-    }
+      "require": {
+        "types": "./index.d.ts",
+        "default": "./index.js"
+      },
+      "import": {
+        "types": "./index.d.ts",
+        "default": "./esm/index.mjs"
+      }
+    },
+    "./esm": null
   },
   "dependencies": {
-    "@apidevtools/json-schema-ref-parser": "^11.5.4",
+    "@apidevtools/json-schema-ref-parser": "^11.9.3",
     "openapi-types": "^12.1.3",
     "yaml": "^2.8.1"
   },
@@ -52,6 +61,5 @@
     "@types/node": "^24.0.0",
     "typescript": "^5.0.0",
     "zod": "^4.0.0"
-  },
-  "type": "commonjs"
+  }
 }

package/src/errors.js

@@ -1,67 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SchemaError = exports.GenerationError = exports.ValidationError = exports.ParseError = exports.LoadError = exports.OpenAPIToolError = void 0;
-/**
- * Base error class for all library errors
- */
-class OpenAPIToolError extends Error {
-    context;
-    constructor(message, context) {
-        super(message);
-        this.name = this.constructor.name;
-        this.context = context;
-        // captureStackTrace is Node.js-specific, guard against non-Node environments
-        if (Error.captureStackTrace) {
-            Error.captureStackTrace(this, this.constructor);
-        }
-    }
-}
-exports.OpenAPIToolError = OpenAPIToolError;
-/**
- * Error thrown when loading an OpenAPI specification fails
- */
-class LoadError extends OpenAPIToolError {
-    constructor(message, context) {
-        super(message, context);
-    }
-}
-exports.LoadError = LoadError;
-/**
- * Error thrown when parsing an OpenAPI specification fails
- */
-class ParseError extends OpenAPIToolError {
-    constructor(message, context) {
-        super(message, context);
-    }
-}
-exports.ParseError = ParseError;
-/**
- * Error thrown when validating an OpenAPI specification fails
- */
-class ValidationError extends OpenAPIToolError {
-    errors;
-    constructor(message, context) {
-        super(message, context);
-        this.errors = context?.['errors'];
-    }
-}
-exports.ValidationError = ValidationError;
-/**
- * Error thrown when generating a tool fails
- */
-class GenerationError extends OpenAPIToolError {
-    constructor(message, context) {
-        super(message, context);
-    }
-}
-exports.GenerationError = GenerationError;
-/**
- * Error thrown when a schema is invalid
- */
-class SchemaError extends OpenAPIToolError {
-    constructor(message, context) {
-        super(message, context);
-    }
-}
-exports.SchemaError = SchemaError;
-//# sourceMappingURL=errors.js.map

package/src/errors.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,MAAa,gBAAiB,SAAQ,KAAK;IACzB,OAAO,CAAuB;IAE9C,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QAEvB,6EAA6E;QAC7E,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;CACF;AAbD,4CAaC;AAED;;GAEG;AACH,MAAa,SAAU,SAAQ,gBAAgB;IAC7C,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1B,CAAC;CACF;AAJD,8BAIC;AAED;;GAEG;AACH,MAAa,UAAW,SAAQ,gBAAgB;IAC9C,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1B,CAAC;CACF;AAJD,gCAIC;AAED;;GAEG;AACH,MAAa,eAAgB,SAAQ,gBAAgB;IACnC,MAAM,CAAS;IAE/B,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;CACF;AAPD,0CAOC;AAED;;GAEG;AACH,MAAa,eAAgB,SAAQ,gBAAgB;IACnD,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1B,CAAC;CACF;AAJD,0CAIC;AAED;;GAEG;AACH,MAAa,WAAY,SAAQ,gBAAgB;IAC/C,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1B,CAAC;CACF;AAJD,kCAIC","sourcesContent":["/**\n * Base error class for all library errors\n */\nexport class OpenAPIToolError extends Error {\n  public readonly context?: Record<string, any>;\n\n  constructor(message: string, context?: Record<string, any>) {\n    super(message);\n    this.name = this.constructor.name;\n    this.context = context;\n\n    // captureStackTrace is Node.js-specific, guard against non-Node environments\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, this.constructor);\n    }\n  }\n}\n\n/**\n * Error thrown when loading an OpenAPI specification fails\n */\nexport class LoadError extends OpenAPIToolError {\n  constructor(message: string, context?: Record<string, any>) {\n    super(message, context);\n  }\n}\n\n/**\n * Error thrown when parsing an OpenAPI specification fails\n */\nexport class ParseError extends OpenAPIToolError {\n  constructor(message: string, context?: Record<string, any>) {\n    super(message, context);\n  }\n}\n\n/**\n * Error thrown when validating an OpenAPI specification fails\n */\nexport class ValidationError extends OpenAPIToolError {\n  public readonly errors?: any[];\n\n  constructor(message: string, context?: Record<string, any>) {\n    super(message, context);\n    this.errors = context?.['errors'];\n  }\n}\n\n/**\n * Error thrown when generating a tool fails\n */\nexport class GenerationError extends OpenAPIToolError {\n  constructor(message: string, context?: Record<string, any>) {\n    super(message, context);\n  }\n}\n\n/**\n * Error thrown when a schema is invalid\n */\nexport class SchemaError extends OpenAPIToolError {\n  constructor(message: string, context?: Record<string, any>) {\n    super(message, context);\n  }\n}\n"]}

package/src/generator.js

@@ -1,381 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.OpenAPIToolGenerator = void 0;
-const tslib_1 = require("tslib");
-const yaml = tslib_1.__importStar(require("yaml"));
-const fs = tslib_1.__importStar(require("fs/promises"));
-const path = tslib_1.__importStar(require("path"));
-const json_schema_ref_parser_1 = tslib_1.__importDefault(require("@apidevtools/json-schema-ref-parser"));
-const types_1 = require("./types");
-const parameter_resolver_1 = require("./parameter-resolver");
-const response_builder_1 = require("./response-builder");
-const validator_1 = require("./validator");
-const errors_1 = require("./errors");
-/**
- * Main class for generating MCP tools from OpenAPI specifications
- */
-class OpenAPIToolGenerator {
-    document;
-    dereferencedDocument;
-    options;
-    /**
-     * Private constructor - use static factory methods to create instances
-     */
-    constructor(document, options = {}) {
-        this.document = document;
-        this.options = {
-            dereference: options.dereference ?? true,
-            baseUrl: options.baseUrl ?? '',
-            headers: options.headers ?? {},
-            timeout: options.timeout ?? 30000,
-            validate: options.validate ?? true,
-            followRedirects: options.followRedirects ?? true,
-        };
-    }
-    /**
-     * Create generator from a URL
-     */
-    static async fromURL(url, options = {}) {
-        try {
-            const controller = new AbortController();
-            const timeout = setTimeout(() => controller.abort(), options.timeout ?? 30000);
-            const response = await fetch(url, {
-                headers: options.headers,
-                signal: controller.signal,
-                redirect: options.followRedirects ?? true ? 'follow' : 'manual',
-            });
-            clearTimeout(timeout);
-            if (!response.ok) {
-                throw new errors_1.LoadError(`Failed to fetch OpenAPI spec from URL: ${response.status} ${response.statusText}`, {
-                    url,
-                    status: response.status,
-                });
-            }
-            const contentType = response.headers.get('content-type') || '';
-            const text = await response.text();
-            let document;
-            if (contentType.includes('yaml') || contentType.includes('yml') || url.match(/\.ya?ml$/i)) {
-                document = yaml.parse(text);
-            }
-            else {
-                document = JSON.parse(text);
-            }
-            return new OpenAPIToolGenerator(document, options);
-        }
-        catch (error) {
-            if (error instanceof errors_1.LoadError) {
-                throw error;
-            }
-            const errorMessage = error instanceof Error ? error.message : String(error);
-            throw new errors_1.LoadError(`Failed to load OpenAPI spec from URL: ${errorMessage}`, {
-                url,
-                originalError: error,
-            });
-        }
-    }
-    /**
-     * Create generator from a file path
-     */
-    static async fromFile(filePath, options = {}) {
-        try {
-            const absolutePath = path.isAbsolute(filePath) ? filePath : path.resolve(process.cwd(), filePath);
-            const content = await fs.readFile(absolutePath, 'utf-8');
-            const ext = path.extname(filePath).toLowerCase();
-            let document;
-            if (ext === '.yaml' || ext === '.yml') {
-                document = yaml.parse(content);
-            }
-            else if (ext === '.json') {
-                document = JSON.parse(content);
-            }
-            else {
-                // Try to parse as JSON first, then YAML
-                try {
-                    document = JSON.parse(content);
-                }
-                catch {
-                    document = yaml.parse(content);
-                }
-            }
-            return new OpenAPIToolGenerator(document, options);
-        }
-        catch (error) {
-            const errorMessage = error instanceof Error ? error.message : String(error);
-            throw new errors_1.LoadError(`Failed to load OpenAPI spec from file: ${errorMessage}`, {
-                filePath,
-                originalError: error,
-            });
-        }
-    }
-    /**
-     * Create generator from a YAML string
-     */
-    static async fromYAML(yamlString, options = {}) {
-        try {
-            const document = yaml.parse(yamlString);
-            return new OpenAPIToolGenerator(document, options);
-        }
-        catch (error) {
-            const errorMessage = error instanceof Error ? error.message : String(error);
-            throw new errors_1.ParseError(`Failed to parse YAML: ${errorMessage}`, {
-                originalError: error,
-            });
-        }
-    }
-    /**
-     * Create generator from a JSON object
-     */
-    static async fromJSON(json, options = {}) {
-        // Clone to avoid mutations
-        const document = JSON.parse(JSON.stringify(json));
-        return new OpenAPIToolGenerator(document, options);
-    }
-    /**
-     * Get the OpenAPI document
-     */
-    getDocument() {
-        return this.dereferencedDocument ?? this.document;
-    }
-    /**
-     * Validate the OpenAPI document
-     */
-    async validate() {
-        const validator = new validator_1.Validator();
-        return validator.validate(this.document);
-    }
-    /**
-     * Initialize the generator (dereference if needed)
-     */
-    async initialize() {
-        if (this.options.validate) {
-            const result = await this.validate();
-            if (!result.valid) {
-                throw new errors_1.ParseError('Invalid OpenAPI document', { errors: result.errors });
-            }
-        }
-        if (this.options.dereference && !this.dereferencedDocument) {
-            try {
-                this.dereferencedDocument = (await json_schema_ref_parser_1.default.dereference(JSON.parse(JSON.stringify(this.document))));
-            }
-            catch (error) {
-                const errorMessage = error instanceof Error ? error.message : String(error);
-                throw new errors_1.ParseError(`Failed to dereference OpenAPI document: ${errorMessage}`, {
-                    originalError: error,
-                });
-            }
-        }
-    }
-    /**
-     * Generate all tools from the OpenAPI specification
-     */
-    async generateTools(options = {}) {
-        await this.initialize();
-        const document = this.getDocument();
-        const tools = [];
-        if (!document.paths) {
-            return tools;
-        }
-        for (const [pathStr, pathItem] of Object.entries(document.paths)) {
-            if (!pathItem || '$ref' in pathItem)
-                continue;
-            const methods = ['get', 'post', 'put', 'patch', 'delete', 'head', 'options', 'trace'];
-            for (const method of methods) {
-                const operation = pathItem[method];
-                if (!operation)
-                    continue;
-                // Apply filters
-                if (!this.shouldIncludeOperation(operation, pathStr, method, options)) {
-                    continue;
-                }
-                try {
-                    const tool = await this.generateTool(pathStr, method, options);
-                    tools.push(tool);
-                }
-                catch (error) {
-                    const errorMessage = error instanceof Error ? error.message : String(error);
-                    console.warn(`Failed to generate tool for ${method.toUpperCase()} ${pathStr}:`, errorMessage);
-                }
-            }
-        }
-        return tools;
-    }
-    /**
-     * Generate a specific tool for a path and method
-     */
-    async generateTool(pathStr, method, options = {}) {
-        await this.initialize();
-        const document = this.getDocument();
-        if (!document.paths) {
-            throw new Error('No paths defined in OpenAPI document');
-        }
-        const pathItem = document.paths[pathStr];
-        const operation = pathItem?.[method.toLowerCase()];
-        if (!operation) {
-            throw new Error(`Operation not found: ${method.toUpperCase()} ${pathStr}`);
-        }
-        // Resolve parameters
-        const parameterResolver = new parameter_resolver_1.ParameterResolver(options.namingStrategy);
-        // Filter out ReferenceObjects from parameters
-        let pathParameters = undefined;
-        if (pathItem.parameters) {
-            pathParameters = pathItem.parameters.filter((p) => !(0, types_1.isReferenceObject)(p));
-        }
-        // Extract security requirements
-        let securityRequirements = undefined;
-        const securitySpec = operation.security ?? document.security;
-        if (securitySpec) {
-            securityRequirements = this.extractSecurityRequirements(securitySpec, document);
-        }
-        const { inputSchema, mapper } = parameterResolver.resolve(operation, pathParameters, securityRequirements, options.includeSecurityInInput);
-        // Build response schema
-        const responseBuilder = new response_builder_1.ResponseBuilder(options);
-        const outputSchema = responseBuilder.build(operation.responses);
-        // Generate tool name
-        const name = this.generateToolName(pathStr, method, operation.operationId, options);
-        // Generate description
-        const description = operation.summary || operation.description || `${method.toUpperCase()} ${pathStr}`;
-        // Extract metadata
-        const metadata = this.extractMetadata(pathStr, method, operation, document, outputSchema);
-        return {
-            name,
-            description,
-            inputSchema,
-            outputSchema,
-            mapper,
-            metadata,
-        };
-    }
-    /**
-     * Check if an operation should be included
-     */
-    shouldIncludeOperation(operation, path, method, options) {
-        // Check deprecated
-        if (operation.deprecated && !options.includeDeprecated) {
-            return false;
-        }
-        // Check operation ID filters
-        if (options.includeOperations && operation.operationId) {
-            if (!options.includeOperations.includes(operation.operationId)) {
-                return false;
-            }
-        }
-        if (options.excludeOperations && operation.operationId) {
-            if (options.excludeOperations.includes(operation.operationId)) {
-                return false;
-            }
-        }
-        // Custom filter
-        if (options.filterFn) {
-            return options.filterFn({
-                ...operation,
-                path,
-                method,
-            });
-        }
-        return true;
-    }
-    /**
-     * Generate a tool name
-     */
-    generateToolName(path, method, operationId, options = {}) {
-        if (options.namingStrategy?.toolNameGenerator) {
-            return options.namingStrategy.toolNameGenerator(path, method, operationId);
-        }
-        if (operationId) {
-            return operationId;
-        }
-        // Generate from path and method
-        const sanitized = path
-            .replace(/\{([^}]+)\}/g, 'By_$1')
-            .replace(/[^a-zA-Z0-9_]/g, '_')
-            .replace(/_+/g, '_')
-            .replace(/^_|_$/g, '');
-        return `${method}_${sanitized}`;
-    }
-    /**
-     * Extract metadata from operation
-     */
-    extractMetadata(path, method, operation, document, outputSchema) {
-        const metadata = {
-            path,
-            method,
-            operationId: operation.operationId,
-            operationSummary: operation.summary,
-            operationDescription: operation.description,
-            tags: operation.tags,
-            deprecated: operation.deprecated,
-        };
-        // Extract security requirements
-        if (operation.security || document.security) {
-            metadata.security = this.extractSecurityRequirements((operation.security ?? document.security), document);
-        }
-        // Extract servers
-        const servers = operation.servers ?? document.servers;
-        if (servers) {
-            metadata.servers = servers.map((server) => ({
-                url: this.options.baseUrl || server.url,
-                description: server.description,
-                variables: server.variables,
-            }));
-        }
-        else if (this.options.baseUrl) {
-            metadata.servers = [{ url: this.options.baseUrl }];
-        }
-        // Extract response status codes (preserve 0 for default responses)
-        const schemaObj = outputSchema;
-        if (schemaObj && Array.isArray(schemaObj['oneOf'])) {
-            const codes = schemaObj['oneOf']
-                .map((schema) => schema['x-status-code'])
-                .filter((code) => code !== undefined && code !== null);
-            if (codes.length > 0) {
-                metadata.responseStatusCodes = codes;
-            }
-        }
-        else if (schemaObj && schemaObj['x-status-code'] !== undefined && schemaObj['x-status-code'] !== null) {
-            metadata.responseStatusCodes = [schemaObj['x-status-code']];
-        }
-        // External docs
-        if (operation.externalDocs) {
-            metadata.externalDocs = operation.externalDocs;
-        }
-        // FrontMCP extension (x-frontmcp)
-        const operationWithExt = operation;
-        if (operationWithExt['x-frontmcp']) {
-            metadata.frontmcp = operationWithExt['x-frontmcp'];
-        }
-        return metadata;
-    }
-    /**
-     * Extract security requirements
-     */
-    extractSecurityRequirements(security, document) {
-        if (!security || !document.components?.securitySchemes) {
-            return [];
-        }
-        return security.flatMap((req) => Object.entries(req).map(([scheme, scopes]) => {
-            const securityScheme = document.components.securitySchemes[scheme];
-            // Skip if it's a reference object
-            if ((0, types_1.isReferenceObject)(securityScheme)) {
-                return { scheme, type: 'http', scopes };
-            }
-            const apiKeyIn = 'in' in securityScheme ? securityScheme.in : undefined;
-            const result = {
-                scheme,
-                type: securityScheme.type,
-                scopes,
-                name: 'name' in securityScheme ? securityScheme.name : undefined,
-                in: apiKeyIn && (apiKeyIn === 'query' || apiKeyIn === 'header' || apiKeyIn === 'cookie') ? apiKeyIn : undefined,
-            };
-            // Add HTTP-specific metadata
-            if (securityScheme.type === 'http') {
-                result.httpScheme = 'scheme' in securityScheme ? securityScheme.scheme : undefined;
-                result.bearerFormat = 'bearerFormat' in securityScheme ? securityScheme.bearerFormat : undefined;
-            }
-            // Add description if available
-            result.description = 'description' in securityScheme ? securityScheme.description : undefined;
-            return result;
-        }));
-    }
-}
-exports.OpenAPIToolGenerator = OpenAPIToolGenerator;
-//# sourceMappingURL=generator.js.map

package/src/generator.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../src/generator.ts"],"names":[],"mappings":"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","sourcesContent":["import * as yaml from 'yaml';\nimport * as fs from 'fs/promises';\nimport * as path from 'path';\nimport $RefParser from '@apidevtools/json-schema-ref-parser';\nimport type {\n  OpenAPIDocument,\n  LoadOptions,\n  GenerateOptions,\n  McpOpenAPITool,\n  ValidationResult,\n  HTTPMethod,\n  ParameterObject,\n  SecurityRequirement,\n  AuthType,\n  OperationObject,\n  OperationWithContext,\n  ToolMetadata,\n  ServerObject,\n} from './types';\nimport { isReferenceObject } from './types';\nimport { ParameterResolver } from './parameter-resolver';\nimport { ResponseBuilder } from './response-builder';\nimport { Validator } from './validator';\nimport { LoadError, ParseError } from './errors';\n\n/**\n * Main class for generating MCP tools from OpenAPI specifications\n */\nexport class OpenAPIToolGenerator {\n  private document: OpenAPIDocument;\n  private dereferencedDocument?: OpenAPIDocument;\n  private options: Required<LoadOptions>;\n\n  /**\n   * Private constructor - use static factory methods to create instances\n   */\n  private constructor(document: OpenAPIDocument, options: LoadOptions = {}) {\n    this.document = document;\n    this.options = {\n      dereference: options.dereference ?? true,\n      baseUrl: options.baseUrl ?? '',\n      headers: options.headers ?? {},\n      timeout: options.timeout ?? 30000,\n      validate: options.validate ?? true,\n      followRedirects: options.followRedirects ?? true,\n    };\n  }\n\n  /**\n   * Create generator from a URL\n   */\n  static async fromURL(url: string, options: LoadOptions = {}): Promise<OpenAPIToolGenerator> {\n    try {\n      const controller = new AbortController();\n      const timeout = setTimeout(() => controller.abort(), options.timeout ?? 30000);\n\n      const response = await fetch(url, {\n        headers: options.headers,\n        signal: controller.signal,\n        redirect: options.followRedirects ?? true ? 'follow' : 'manual',\n      });\n\n      clearTimeout(timeout);\n\n      if (!response.ok) {\n        throw new LoadError(`Failed to fetch OpenAPI spec from URL: ${response.status} ${response.statusText}`, {\n          url,\n          status: response.status,\n        });\n      }\n\n      const contentType = response.headers.get('content-type') || '';\n      const text = await response.text();\n\n      let document: OpenAPIDocument;\n      if (contentType.includes('yaml') || contentType.includes('yml') || url.match(/\\.ya?ml$/i)) {\n        document = yaml.parse(text);\n      } else {\n        document = JSON.parse(text);\n      }\n\n      return new OpenAPIToolGenerator(document, options);\n    } catch (error: unknown) {\n      if (error instanceof LoadError) {\n        throw error;\n      }\n      const errorMessage = error instanceof Error ? error.message : String(error);\n      throw new LoadError(`Failed to load OpenAPI spec from URL: ${errorMessage}`, {\n        url,\n        originalError: error,\n      });\n    }\n  }\n\n  /**\n   * Create generator from a file path\n   */\n  static async fromFile(filePath: string, options: LoadOptions = {}): Promise<OpenAPIToolGenerator> {\n    try {\n      const absolutePath = path.isAbsolute(filePath) ? filePath : path.resolve(process.cwd(), filePath);\n      const content = await fs.readFile(absolutePath, 'utf-8');\n      const ext = path.extname(filePath).toLowerCase();\n\n      let document: OpenAPIDocument;\n      if (ext === '.yaml' || ext === '.yml') {\n        document = yaml.parse(content);\n      } else if (ext === '.json') {\n        document = JSON.parse(content);\n      } else {\n        // Try to parse as JSON first, then YAML\n        try {\n          document = JSON.parse(content);\n        } catch {\n          document = yaml.parse(content);\n        }\n      }\n\n      return new OpenAPIToolGenerator(document, options);\n    } catch (error: unknown) {\n      const errorMessage = error instanceof Error ? error.message : String(error);\n      throw new LoadError(`Failed to load OpenAPI spec from file: ${errorMessage}`, {\n        filePath,\n        originalError: error,\n      });\n    }\n  }\n\n  /**\n   * Create generator from a YAML string\n   */\n  static async fromYAML(yamlString: string, options: LoadOptions = {}): Promise<OpenAPIToolGenerator> {\n    try {\n      const document = yaml.parse(yamlString);\n      return new OpenAPIToolGenerator(document, options);\n    } catch (error: unknown) {\n      const errorMessage = error instanceof Error ? error.message : String(error);\n      throw new ParseError(`Failed to parse YAML: ${errorMessage}`, {\n        originalError: error,\n      });\n    }\n  }\n\n  /**\n   * Create generator from a JSON object\n   */\n  static async fromJSON(json: object, options: LoadOptions = {}): Promise<OpenAPIToolGenerator> {\n    // Clone to avoid mutations\n    const document = JSON.parse(JSON.stringify(json));\n    return new OpenAPIToolGenerator(document, options);\n  }\n\n  /**\n   * Get the OpenAPI document\n   */\n  getDocument(): OpenAPIDocument {\n    return this.dereferencedDocument ?? this.document;\n  }\n\n  /**\n   * Validate the OpenAPI document\n   */\n  async validate(): Promise<ValidationResult> {\n    const validator = new Validator();\n    return validator.validate(this.document);\n  }\n\n  /**\n   * Initialize the generator (dereference if needed)\n   */\n  private async initialize(): Promise<void> {\n    if (this.options.validate) {\n      const result = await this.validate();\n      if (!result.valid) {\n        throw new ParseError('Invalid OpenAPI document', { errors: result.errors });\n      }\n    }\n\n    if (this.options.dereference && !this.dereferencedDocument) {\n      try {\n        this.dereferencedDocument = (await $RefParser.dereference(\n          JSON.parse(JSON.stringify(this.document)),\n        )) as OpenAPIDocument;\n      } catch (error: unknown) {\n        const errorMessage = error instanceof Error ? error.message : String(error);\n        throw new ParseError(`Failed to dereference OpenAPI document: ${errorMessage}`, {\n          originalError: error,\n        });\n      }\n    }\n  }\n\n  /**\n   * Generate all tools from the OpenAPI specification\n   */\n  async generateTools(options: GenerateOptions = {}): Promise<McpOpenAPITool[]> {\n    await this.initialize();\n\n    const document = this.getDocument();\n    const tools: McpOpenAPITool[] = [];\n\n    if (!document.paths) {\n      return tools;\n    }\n\n    for (const [pathStr, pathItem] of Object.entries(document.paths)) {\n      if (!pathItem || '$ref' in pathItem) continue;\n\n      const methods: HTTPMethod[] = ['get', 'post', 'put', 'patch', 'delete', 'head', 'options', 'trace'];\n\n      for (const method of methods) {\n        const operation = pathItem[method];\n        if (!operation) continue;\n\n        // Apply filters\n        if (!this.shouldIncludeOperation(operation, pathStr, method, options)) {\n          continue;\n        }\n\n        try {\n          const tool = await this.generateTool(pathStr, method, options);\n          tools.push(tool);\n        } catch (error: unknown) {\n          const errorMessage = error instanceof Error ? error.message : String(error);\n          console.warn(`Failed to generate tool for ${method.toUpperCase()} ${pathStr}:`, errorMessage);\n        }\n      }\n    }\n\n    return tools;\n  }\n\n  /**\n   * Generate a specific tool for a path and method\n   */\n  async generateTool(pathStr: string, method: string, options: GenerateOptions = {}): Promise<McpOpenAPITool> {\n    await this.initialize();\n\n    const document = this.getDocument();\n\n    if (!document.paths) {\n      throw new Error('No paths defined in OpenAPI document');\n    }\n\n    const pathItem = document.paths[pathStr];\n    const operation = pathItem?.[method.toLowerCase() as HTTPMethod];\n\n    if (!operation) {\n      throw new Error(`Operation not found: ${method.toUpperCase()} ${pathStr}`);\n    }\n\n    // Resolve parameters\n    const parameterResolver = new ParameterResolver(options.namingStrategy);\n\n    // Filter out ReferenceObjects from parameters\n    let pathParameters: ParameterObject[] | undefined = undefined;\n    if (pathItem.parameters) {\n      pathParameters = pathItem.parameters.filter(\n        (p): p is ParameterObject => !isReferenceObject(p),\n      ) as ParameterObject[];\n    }\n\n    // Extract security requirements\n    let securityRequirements: SecurityRequirement[] | undefined = undefined;\n    const securitySpec = operation.security ?? document.security;\n    if (securitySpec) {\n      securityRequirements = this.extractSecurityRequirements(securitySpec as Record<string, string[]>[], document);\n    }\n\n    const { inputSchema, mapper } = parameterResolver.resolve(\n      operation,\n      pathParameters,\n      securityRequirements,\n      options.includeSecurityInInput,\n    );\n\n    // Build response schema\n    const responseBuilder = new ResponseBuilder(options);\n    const outputSchema = responseBuilder.build(operation.responses);\n\n    // Generate tool name\n    const name = this.generateToolName(pathStr, method as HTTPMethod, operation.operationId, options);\n\n    // Generate description\n    const description = operation.summary || operation.description || `${method.toUpperCase()} ${pathStr}`;\n\n    // Extract metadata\n    const metadata = this.extractMetadata(pathStr, method as HTTPMethod, operation, document, outputSchema);\n\n    return {\n      name,\n      description,\n      inputSchema,\n      outputSchema,\n      mapper,\n      metadata,\n    };\n  }\n\n  /**\n   * Check if an operation should be included\n   */\n  private shouldIncludeOperation(\n    operation: OperationObject,\n    path: string,\n    method: string,\n    options: GenerateOptions,\n  ): boolean {\n    // Check deprecated\n    if (operation.deprecated && !options.includeDeprecated) {\n      return false;\n    }\n\n    // Check operation ID filters\n    if (options.includeOperations && operation.operationId) {\n      if (!options.includeOperations.includes(operation.operationId)) {\n        return false;\n      }\n    }\n\n    if (options.excludeOperations && operation.operationId) {\n      if (options.excludeOperations.includes(operation.operationId)) {\n        return false;\n      }\n    }\n\n    // Custom filter\n    if (options.filterFn) {\n      return options.filterFn({\n        ...operation,\n        path,\n        method,\n      } as OperationWithContext);\n    }\n\n    return true;\n  }\n\n  /**\n   * Generate a tool name\n   */\n  private generateToolName(\n    path: string,\n    method: HTTPMethod,\n    operationId?: string,\n    options: GenerateOptions = {},\n  ): string {\n    if (options.namingStrategy?.toolNameGenerator) {\n      return options.namingStrategy.toolNameGenerator(path, method, operationId);\n    }\n\n    if (operationId) {\n      return operationId;\n    }\n\n    // Generate from path and method\n    const sanitized = path\n      .replace(/\\{([^}]+)\\}/g, 'By_$1')\n      .replace(/[^a-zA-Z0-9_]/g, '_')\n      .replace(/_+/g, '_')\n      .replace(/^_|_$/g, '');\n\n    return `${method}_${sanitized}`;\n  }\n\n  /**\n   * Extract metadata from operation\n   */\n  private extractMetadata(\n    path: string,\n    method: HTTPMethod,\n    operation: OperationObject,\n    document: OpenAPIDocument,\n    outputSchema?: unknown,\n  ): ToolMetadata {\n    const metadata: ToolMetadata = {\n      path,\n      method,\n      operationId: operation.operationId,\n      operationSummary: operation.summary,\n      operationDescription: operation.description,\n      tags: operation.tags,\n      deprecated: operation.deprecated,\n    };\n\n    // Extract security requirements\n    if (operation.security || document.security) {\n      metadata.security = this.extractSecurityRequirements(\n        (operation.security ?? document.security) as Record<string, string[]>[],\n        document,\n      );\n    }\n\n    // Extract servers\n    const servers = (operation as { servers?: ServerObject[] }).servers ?? document.servers;\n    if (servers) {\n      metadata.servers = servers.map((server: ServerObject) => ({\n        url: this.options.baseUrl || server.url,\n        description: server.description,\n        variables: server.variables,\n      }));\n    } else if (this.options.baseUrl) {\n      metadata.servers = [{ url: this.options.baseUrl }];\n    }\n\n    // Extract response status codes (preserve 0 for default responses)\n    const schemaObj = outputSchema as Record<string, unknown> | undefined;\n    if (schemaObj && Array.isArray(schemaObj['oneOf'])) {\n      const codes = (schemaObj['oneOf'] as Record<string, unknown>[])\n        .map((schema) => schema['x-status-code'])\n        .filter((code): code is number => code !== undefined && code !== null);\n      if (codes.length > 0) {\n        metadata.responseStatusCodes = codes;\n      }\n    } else if (schemaObj && schemaObj['x-status-code'] !== undefined && schemaObj['x-status-code'] !== null) {\n      metadata.responseStatusCodes = [schemaObj['x-status-code'] as number];\n    }\n\n    // External docs\n    if (operation.externalDocs) {\n      metadata.externalDocs = operation.externalDocs;\n    }\n\n    // FrontMCP extension (x-frontmcp)\n    const operationWithExt = operation as Record<string, unknown>;\n    if (operationWithExt['x-frontmcp']) {\n      metadata.frontmcp = operationWithExt['x-frontmcp'] as ToolMetadata['frontmcp'];\n    }\n\n    return metadata;\n  }\n\n  /**\n   * Extract security requirements\n   */\n  private extractSecurityRequirements(\n    security: Record<string, string[]>[],\n    document: OpenAPIDocument,\n  ): SecurityRequirement[] {\n    if (!security || !document.components?.securitySchemes) {\n      return [];\n    }\n\n    return security.flatMap((req) =>\n      Object.entries(req).map(([scheme, scopes]): SecurityRequirement => {\n        const securityScheme = document.components!.securitySchemes![scheme];\n\n        // Skip if it's a reference object\n        if (isReferenceObject(securityScheme)) {\n          return { scheme, type: 'http', scopes };\n        }\n\n        const apiKeyIn = 'in' in securityScheme ? securityScheme.in : undefined;\n        const result: SecurityRequirement = {\n          scheme,\n          type: securityScheme.type as AuthType,\n          scopes,\n          name: 'name' in securityScheme ? securityScheme.name : undefined,\n          in:\n            apiKeyIn && (apiKeyIn === 'query' || apiKeyIn === 'header' || apiKeyIn === 'cookie') ? apiKeyIn : undefined,\n        };\n\n        // Add HTTP-specific metadata\n        if (securityScheme.type === 'http') {\n          result.httpScheme = 'scheme' in securityScheme ? securityScheme.scheme : undefined;\n          result.bearerFormat = 'bearerFormat' in securityScheme ? securityScheme.bearerFormat : undefined;\n        }\n\n        // Add description if available\n        result.description = 'description' in securityScheme ? securityScheme.description : undefined;\n\n        return result;\n      }),\n    );\n  }\n}\n"]}

package/src/index.js

@@ -1,30 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.toJsonSchema = exports.isReferenceObject = exports.SchemaError = exports.GenerationError = exports.ValidationError = exports.ParseError = exports.LoadError = exports.OpenAPIToolError = exports.createSecurityContext = exports.SecurityResolver = exports.Validator = exports.ResponseBuilder = exports.ParameterResolver = exports.SchemaBuilder = exports.OpenAPIToolGenerator = void 0;
-// Main exports
-var generator_1 = require("./generator");
-Object.defineProperty(exports, "OpenAPIToolGenerator", { enumerable: true, get: function () { return generator_1.OpenAPIToolGenerator; } });
-var schema_builder_1 = require("./schema-builder");
-Object.defineProperty(exports, "SchemaBuilder", { enumerable: true, get: function () { return schema_builder_1.SchemaBuilder; } });
-var parameter_resolver_1 = require("./parameter-resolver");
-Object.defineProperty(exports, "ParameterResolver", { enumerable: true, get: function () { return parameter_resolver_1.ParameterResolver; } });
-var response_builder_1 = require("./response-builder");
-Object.defineProperty(exports, "ResponseBuilder", { enumerable: true, get: function () { return response_builder_1.ResponseBuilder; } });
-var validator_1 = require("./validator");
-Object.defineProperty(exports, "Validator", { enumerable: true, get: function () { return validator_1.Validator; } });
-var security_resolver_1 = require("./security-resolver");
-Object.defineProperty(exports, "SecurityResolver", { enumerable: true, get: function () { return security_resolver_1.SecurityResolver; } });
-Object.defineProperty(exports, "createSecurityContext", { enumerable: true, get: function () { return security_resolver_1.createSecurityContext; } });
-// Error exports
-var errors_1 = require("./errors");
-Object.defineProperty(exports, "OpenAPIToolError", { enumerable: true, get: function () { return errors_1.OpenAPIToolError; } });
-Object.defineProperty(exports, "LoadError", { enumerable: true, get: function () { return errors_1.LoadError; } });
-Object.defineProperty(exports, "ParseError", { enumerable: true, get: function () { return errors_1.ParseError; } });
-Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return errors_1.ValidationError; } });
-Object.defineProperty(exports, "GenerationError", { enumerable: true, get: function () { return errors_1.GenerationError; } });
-Object.defineProperty(exports, "SchemaError", { enumerable: true, get: function () { return errors_1.SchemaError; } });
-// Utility exports
-var types_1 = require("./types");
-Object.defineProperty(exports, "isReferenceObject", { enumerable: true, get: function () { return types_1.isReferenceObject; } });
-Object.defineProperty(exports, "toJsonSchema", { enumerable: true, get: function () { return types_1.toJsonSchema; } });
-//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,eAAe;AACf,yCAAmD;AAA1C,iHAAA,oBAAoB,OAAA;AAC7B,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AACtB,2DAAyD;AAAhD,uHAAA,iBAAiB,OAAA;AAC1B,uDAAqD;AAA5C,mHAAA,eAAe,OAAA;AACxB,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAClB,yDAA8E;AAArE,qHAAA,gBAAgB,OAAA;AAAE,0HAAA,qBAAqB,OAAA;AAEhD,gBAAgB;AAChB,mCAAkH;AAAzG,0GAAA,gBAAgB,OAAA;AAAE,mGAAA,SAAS,OAAA;AAAE,oGAAA,UAAU,OAAA;AAAE,yGAAA,eAAe,OAAA;AAAE,yGAAA,eAAe,OAAA;AAAE,qGAAA,WAAW,OAAA;AAgE/F,kBAAkB;AAClB,iCAA0D;AAAjD,0GAAA,iBAAiB,OAAA;AAAE,qGAAA,YAAY,OAAA","sourcesContent":["// Main exports\nexport { OpenAPIToolGenerator } from './generator';\nexport { SchemaBuilder } from './schema-builder';\nexport { ParameterResolver } from './parameter-resolver';\nexport { ResponseBuilder } from './response-builder';\nexport { Validator } from './validator';\nexport { SecurityResolver, createSecurityContext } from './security-resolver';\n\n// Error exports\nexport { OpenAPIToolError, LoadError, ParseError, ValidationError, GenerationError, SchemaError } from './errors';\n\n// Type exports\nexport type {\n  // Main MCP types\n  McpOpenAPITool,\n  ParameterMapper,\n  ToolMetadata,\n  FrontMcpExtensionData,\n  SerializationInfo,\n  SecurityRequirement,\n  SecurityParameterInfo,\n  ServerInfo,\n\n  // Configuration types\n  LoadOptions,\n  GenerateOptions,\n  NamingStrategy,\n  OperationWithContext,\n\n  // Basic types\n  OpenAPIDocument,\n  OpenAPIVersion,\n  HTTPMethod,\n  ParameterLocation,\n  AuthType,\n\n  // Re-exported OpenAPI types (from openapi-types package)\n  OperationObject,\n  ParameterObject,\n  RequestBodyObject,\n  ResponseObject,\n  ResponsesObject,\n  MediaTypeObject,\n  HeaderObject,\n  ExampleObject,\n  PathItemObject,\n  PathsObject,\n  ServerObject,\n  SecuritySchemeObject,\n  ReferenceObject,\n  TagObject,\n  ExternalDocumentationObject,\n  ServerVariableObject,\n  EncodingObject,\n  SecurityRequirementObject,\n  SchemaObject,\n\n  // Validation types\n  ValidationResult,\n  ValidationErrorDetail,\n  ValidationWarning,\n} from './types';\n\n// Security resolver types\nexport type {\n  SecurityContext,\n  ResolvedSecurity,\n  DigestAuthCredentials,\n  ClientCertificate,\n  AWSCredentials,\n  SignatureData,\n} from './security-resolver';\n\n// Utility exports\nexport { isReferenceObject, toJsonSchema } from './types';\n"]}