mcp-from-openapi 0.0.1 → 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,45 @@
+# Changelog
+
+## [1.0.0] - 2025-11-21
+
+### Features
+
+- Production-ready library for converting OpenAPI specifications into MCP tool definitions
+- OpenAPI 3.0+ and Swagger 2.0 support
+- Comprehensive operation parsing:
+  - RESTful endpoint detection (GET, POST, PUT, PATCH, DELETE, etc.)
+  - Path parameter extraction and validation
+  - Query parameter handling
+  - Request body schema conversion
+  - Response schema parsing
+- Advanced OpenAPI features:
+  - Reference resolution ($ref) across the entire specification
+  - Security scheme detection and configuration
+  - Parameter conflict resolution
+  - Operation naming controls and customization
+- Request mapper generation:
+  - Automatic parameter mapping from MCP tool inputs to HTTP requests
+  - Type-safe parameter handling
+  - Support for different parameter locations (path, query, header, cookie)
+  - Request body transformation
+- Tool metadata generation:
+  - Descriptive tool names from operation IDs
+  - Documentation from OpenAPI descriptions
+  - Schema validation rules
+- Multiple input formats:
+  - JSON OpenAPI specifications
+  - YAML OpenAPI specifications
+  - Inline specification objects
+  - URL references to remote specifications
+- Type-safe TypeScript implementation
+- Node.js 18+ compatibility
+
+### Documentation
+
+- Complete API reference
+- OpenAPI conversion examples
+- Integration guides for MCP servers
+- Best practices for tool generation
+
+This is the first official release of `mcp-from-openapi`, extracted from the FrontMCP framework to be published as a
+standalone, reusable library for the community.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-from-openapi",
-  "version": "0.0.1",
+  "version": "1.0.0",
   "description": "Production-ready library for converting OpenAPI specifications into MCP tool definitions",
   "author": "AgentFront <info@agentfront.dev>",
   "license": "Apache-2.0",
@@ -26,6 +26,9 @@
     "url": "https://github.com/agentfront/frontmcp/issues"
   },
   "homepage": "https://github.com/agentfront/frontmcp/blob/main/libs/mcp-from-openapi/README.md",
+  "engines": {
+    "node": ">=18.0.0"
+  },
   "main": "./src/index.js",
   "types": "./src/index.d.ts",
   "exports": {
@@ -38,7 +41,7 @@
   },
   "dependencies": {
     "@apidevtools/json-schema-ref-parser": "^11.5.4",
-    "json-schema": "^0.4.0",
+    "@types/json-schema": "^7.0.15",
     "openapi-types": "^12.1.3",
     "yaml": "^2.8.1"
   },

package/src/errors.js

@@ -9,7 +9,10 @@ class OpenAPIToolError extends Error {
         super(message);
         this.name = this.constructor.name;
         this.context = context;
-        Error.captureStackTrace(this, this.constructor);
+        // captureStackTrace is Node.js-specific, guard against non-Node environments
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
     }
 }
 exports.OpenAPIToolError = OpenAPIToolError;

package/src/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,MAAa,gBAAiB,SAAQ,KAAK;IAGzC,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;QACvB,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;CACF;AATD,4CASC;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;IAGnD,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    Error.captureStackTrace(this, this.constructor);\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"]}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,MAAa,gBAAiB,SAAQ,KAAK;IAGzC,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;IAGnD,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

@@ -43,10 +43,7 @@ class OpenAPIToolGenerator {
             });
             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,
-                });
+                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();
@@ -216,7 +213,13 @@ class OpenAPIToolGenerator {
         if (pathItem.parameters) {
             pathParameters = pathItem.parameters.filter((p) => !(0, types_1.isReferenceObject)(p));
         }
-        const { inputSchema, mapper } = parameterResolver.resolve(operation, pathParameters);
+        // 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);
@@ -259,7 +262,7 @@ class OpenAPIToolGenerator {
             return options.filterFn({
                 ...operation,
                 path,
-                method,
+                method
             });
         }
         return true;
@@ -308,11 +311,18 @@ class OpenAPIToolGenerator {
         else if (this.options.baseUrl) {
             metadata.servers = [{ url: this.options.baseUrl }];
         }
-        // Extract response status codes
-        if (outputSchema && outputSchema.oneOf) {
-            metadata.responseStatusCodes = outputSchema.oneOf.map((schema) => schema['x-status-code']).filter(Boolean);
+        // Extract response status codes (preserve 0 for default responses)
+        if (outputSchema && Array.isArray(outputSchema.oneOf)) {
+            const codes = outputSchema.oneOf
+                .map((schema) => schema['x-status-code'])
+                .filter((code) => code !== undefined && code !== null);
+            if (codes.length > 0) {
+                metadata.responseStatusCodes = codes;
+            }
         }
-        else if (outputSchema?.['x-status-code']) {
+        else if (outputSchema &&
+            outputSchema['x-status-code'] !== undefined &&
+            outputSchema['x-status-code'] !== null) {
             metadata.responseStatusCodes = [outputSchema['x-status-code']];
         }
         // External docs
@@ -332,15 +342,26 @@ class OpenAPIToolGenerator {
             const securityScheme = document.components.securitySchemes[scheme];
             // Skip if it's a reference object
             if ((0, types_1.isReferenceObject)(securityScheme)) {
-                return { scheme, type: 'unknown', scopes };
+                return { scheme, type: 'http', scopes };
             }
-            return {
+            const apiKeyIn = 'in' in securityScheme ? securityScheme.in : undefined;
+            const result = {
                 scheme,
                 type: securityScheme.type,
                 scopes,
                 name: 'name' in securityScheme ? securityScheme.name : undefined,
-                in: 'in' in securityScheme ? securityScheme.in : 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;
         }));
     }
 }

package/src/generator.js.map

@@ -1 +1 @@
-{"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} 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: any) {\n          console.warn(`Failed to generate tool for ${method.toUpperCase()} ${pathStr}:`, error.message);\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    const { inputSchema, mapper } = parameterResolver.resolve(operation, pathParameters);\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(operation: any, path: string, method: string, options: GenerateOptions): 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 any);\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: any,\n    document: OpenAPIDocument,\n    outputSchema?: any,\n  ): any {\n    const metadata: any = {\n      path,\n      method,\n      operationId: operation.operationId,\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(operation.security ?? document.security, document);\n    }\n\n    // Extract servers\n    if (operation.servers || document.servers) {\n      metadata.servers = (operation.servers ?? document.servers).map((server: any) => ({\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\n    if (outputSchema && outputSchema.oneOf) {\n      metadata.responseStatusCodes = outputSchema.oneOf.map((schema: any) => schema['x-status-code']).filter(Boolean);\n    } else if (outputSchema?.['x-status-code']) {\n      metadata.responseStatusCodes = [outputSchema['x-status-code']];\n    }\n\n    // External docs\n    if (operation.externalDocs) {\n      metadata.externalDocs = operation.externalDocs;\n    }\n\n    return metadata;\n  }\n\n  /**\n   * Extract security requirements\n   */\n  private extractSecurityRequirements(security: Record<string, string[]>[], document: OpenAPIDocument): any[] {\n    if (!security || !document.components?.securitySchemes) {\n      return [];\n    }\n\n    return security.flatMap((req) =>\n      Object.entries(req).map(([scheme, scopes]) => {\n        const securityScheme = document.components!.securitySchemes![scheme];\n\n        // Skip if it's a reference object\n        if (isReferenceObject(securityScheme)) {\n          return { scheme, type: 'unknown' as any, scopes };\n        }\n\n        return {\n          scheme,\n          type: securityScheme.type,\n          scopes,\n          name: 'name' in securityScheme ? securityScheme.name : undefined,\n          in: 'in' in securityScheme ? securityScheme.in : undefined,\n        };\n      }),\n    );\n  }\n}\n"]}
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../src/generator.ts"],"names":[],"mappings":";;;;AAAA,mDAA6B;AAC7B,wDAAkC;AAClC,mDAA6B;AAC7B,yGAA6D;AAa7D,mCAA4C;AAC5C,6DAAyD;AACzD,yDAAqD;AACrD,2CAAwC;AACxC,qCAAiD;AAEjD;;GAEG;AACH,MAAa,oBAAoB;IAK/B;;OAEG;IACH,YAAoB,QAAyB,EAAE,UAAuB,EAAE;QACtE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG;YACb,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,IAAI;YACxC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;YAC9B,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;YAC9B,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,KAAK;YACjC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI;YAClC,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,IAAI;SACjD,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,CAClB,GAAW,EACX,UAAuB,EAAE;QAEzB,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;YACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC;YAE/E,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAChC,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,QAAQ,EAAE,OAAO,CAAC,eAAe,IAAI,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ;aAChE,CAAC,CAAC;YAEH,YAAY,CAAC,OAAO,CAAC,CAAC;YAEtB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,kBAAS,CACjB,0CAA0C,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,EAClF,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CACjC,CAAC;YACJ,CAAC;YAED,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;YAC/D,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YAEnC,IAAI,QAAyB,CAAC;YAC9B,IAAI,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC1F,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC9B,CAAC;iBAAM,CAAC;gBACN,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC9B,CAAC;YAED,OAAO,IAAI,oBAAoB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,KAAK,YAAY,kBAAS,EAAE,CAAC;gBAC/B,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5E,MAAM,IAAI,kBAAS,CAAC,yCAAyC,YAAY,EAAE,EAAE;gBAC3E,GAAG;gBACH,aAAa,EAAE,KAAK;aACrB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,QAAQ,CACnB,QAAgB,EAChB,UAAuB,EAAE;QAEzB,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;YAClG,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACzD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;YAEjD,IAAI,QAAyB,CAAC;YAC9B,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;gBACtC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACjC,CAAC;iBAAM,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;gBAC3B,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACjC,CAAC;iBAAM,CAAC;gBACN,wCAAwC;gBACxC,IAAI,CAAC;oBACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACjC,CAAC;gBAAC,MAAM,CAAC;oBACP,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACjC,CAAC;YACH,CAAC;YAED,OAAO,IAAI,oBAAoB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5E,MAAM,IAAI,kBAAS,CAAC,0CAA0C,YAAY,EAAE,EAAE;gBAC5E,QAAQ;gBACR,aAAa,EAAE,KAAK;aACrB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,QAAQ,CACnB,UAAkB,EAClB,UAAuB,EAAE;QAEzB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YACxC,OAAO,IAAI,oBAAoB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5E,MAAM,IAAI,mBAAU,CAAC,yBAAyB,YAAY,EAAE,EAAE;gBAC5D,aAAa,EAAE,KAAK;aACrB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,QAAQ,CACnB,IAAY,EACZ,UAAuB,EAAE;QAEzB,2BAA2B;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QAClD,OAAO,IAAI,oBAAoB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,oBAAoB,IAAI,IAAI,CAAC,QAAQ,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ;QACZ,MAAM,SAAS,GAAG,IAAI,qBAAS,EAAE,CAAC;QAClC,OAAO,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,UAAU;QACtB,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;YACrC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;gBAClB,MAAM,IAAI,mBAAU,CAAC,0BAA0B,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;YAC9E,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC3D,IAAI,CAAC;gBACH,IAAI,CAAC,oBAAoB,GAAG,CAAC,MAAM,gCAAU,CAAC,WAAW,CACvD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAC1C,CAAoB,CAAC;YACxB,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACxB,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC5E,MAAM,IAAI,mBAAU,CAAC,2CAA2C,YAAY,EAAE,EAAE;oBAC9E,aAAa,EAAE,KAAK;iBACrB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,UAA2B,EAAE;QAC/C,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QAExB,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,KAAK,GAAqB,EAAE,CAAC;QAEnC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;YACpB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,KAAK,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACjE,IAAI,CAAC,QAAQ,IAAI,MAAM,IAAI,QAAQ;gBAAE,SAAS;YAE9C,MAAM,OAAO,GAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;YAEpG,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;gBACnC,IAAI,CAAC,SAAS;oBAAE,SAAS;gBAEzB,gBAAgB;gBAChB,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;oBACtE,SAAS;gBACX,CAAC;gBAED,IAAI,CAAC;oBACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;oBAC/D,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACnB,CAAC;gBAAC,OAAO,KAAU,EAAE,CAAC;oBACpB,OAAO,CAAC,IAAI,CAAC,+BAA+B,MAAM,CAAC,WAAW,EAAE,IAAI,OAAO,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;gBACjG,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAChB,OAAe,EACf,MAAc,EACd,UAA2B,EAAE;QAE7B,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QAExB,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAEpC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACzC,MAAM,SAAS,GAAG,QAAQ,EAAE,CAAC,MAAM,CAAC,WAAW,EAAgB,CAAC,CAAC;QAEjE,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,wBAAwB,MAAM,CAAC,WAAW,EAAE,IAAI,OAAO,EAAE,CAAC,CAAC;QAC7E,CAAC;QAED,qBAAqB;QACrB,MAAM,iBAAiB,GAAG,IAAI,sCAAiB,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QAExE,8CAA8C;QAC9C,IAAI,cAAc,GAAkC,SAAS,CAAC;QAC9D,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;YACxB,cAAc,GAAG,QAAQ,CAAC,UAAU,CAAC,MAAM,CACzC,CAAC,CAAC,EAAwB,EAAE,CAAC,CAAC,IAAA,yBAAiB,EAAC,CAAC,CAAC,CAC9B,CAAC;QACzB,CAAC;QAED,gCAAgC;QAChC,IAAI,oBAAoB,GAAsC,SAAS,CAAC;QACxE,MAAM,YAAY,GAAG,SAAS,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAAC;QAC7D,IAAI,YAAY,EAAE,CAAC;YACjB,oBAAoB,GAAG,IAAI,CAAC,2BAA2B,CACrD,YAA0C,EAC1C,QAAQ,CACT,CAAC;QACJ,CAAC;QAED,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,iBAAiB,CAAC,OAAO,CACvD,SAAS,EACT,cAAc,EACd,oBAAoB,EACpB,OAAO,CAAC,sBAAsB,CAC/B,CAAC;QAEF,wBAAwB;QACxB,MAAM,eAAe,GAAG,IAAI,kCAAe,CAAC,OAAO,CAAC,CAAC;QACrD,MAAM,YAAY,GAAG,eAAe,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAEhE,qBAAqB;QACrB,MAAM,IAAI,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAoB,EAAE,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAElG,uBAAuB;QACvB,MAAM,WAAW,GAAG,SAAS,CAAC,OAAO,IAAI,SAAS,CAAC,WAAW,IAAI,GAAG,MAAM,CAAC,WAAW,EAAE,IAAI,OAAO,EAAE,CAAC;QAEvG,mBAAmB;QACnB,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,MAAoB,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;QAExG,OAAO;YACL,IAAI;YACJ,WAAW;YACX,WAAW;YACX,YAAY;YACZ,MAAM;YACN,QAAQ;SACT,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,sBAAsB,CAC5B,SAAc,EACd,IAAY,EACZ,MAAc,EACd,OAAwB;QAExB,mBAAmB;QACnB,IAAI,SAAS,CAAC,UAAU,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC;YACvD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,6BAA6B;QAC7B,IAAI,OAAO,CAAC,iBAAiB,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC;YACvD,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC/D,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,IAAI,OAAO,CAAC,iBAAiB,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC;YACvD,IAAI,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC9D,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,gBAAgB;QAChB,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,OAAO,OAAO,CAAC,QAAQ,CAAC;gBACtB,GAAG,SAAS;gBACZ,IAAI;gBACJ,MAAM;aACA,CAAC,CAAC;QACZ,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACK,gBAAgB,CACtB,IAAY,EACZ,MAAkB,EAClB,WAAoB,EACpB,UAA2B,EAAE;QAE7B,IAAI,OAAO,CAAC,cAAc,EAAE,iBAAiB,EAAE,CAAC;YAC9C,OAAO,OAAO,CAAC,cAAc,CAAC,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAC7E,CAAC;QAED,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,WAAW,CAAC;QACrB,CAAC;QAED,gCAAgC;QAChC,MAAM,SAAS,GAAG,IAAI;aACnB,OAAO,CAAC,cAAc,EAAE,OAAO,CAAC;aAChC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC;aAC9B,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;aACnB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAEzB,OAAO,GAAG,MAAM,IAAI,SAAS,EAAE,CAAC;IAClC,CAAC;IAED;;OAEG;IACK,eAAe,CACrB,IAAY,EACZ,MAAkB,EAClB,SAAc,EACd,QAAyB,EACzB,YAAkB;QAElB,MAAM,QAAQ,GAAQ;YACpB,IAAI;YACJ,MAAM;YACN,WAAW,EAAE,SAAS,CAAC,WAAW;YAClC,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,UAAU,EAAE,SAAS,CAAC,UAAU;SACjC,CAAC;QAEF,gCAAgC;QAChC,IAAI,SAAS,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;YAC5C,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAC,2BAA2B,CAClD,SAAS,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,EACvC,QAAQ,CACT,CAAC;QACJ,CAAC;QAED,kBAAkB;QAClB,IAAI,SAAS,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YAC1C,QAAQ,CAAC,OAAO,GAAG,CAAC,SAAS,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,MAAW,EAAE,EAAE,CAAC,CAAC;gBAC/E,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,MAAM,CAAC,GAAG;gBACvC,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,SAAS,EAAE,MAAM,CAAC,SAAS;aAC5B,CAAC,CAAC,CAAC;QACN,CAAC;aAAM,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YAChC,QAAQ,CAAC,OAAO,GAAG,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QACrD,CAAC;QAED,mEAAmE;QACnE,IAAI,YAAY,IAAI,KAAK,CAAC,OAAO,CAAE,YAAoB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/D,MAAM,KAAK,GAAI,YAAoB,CAAC,KAAK;iBACtC,GAAG,CAAC,CAAC,MAAW,EAAE,EAAE,CAAE,MAAc,CAAC,eAAe,CAAC,CAAC;iBACtD,MAAM,CAAC,CAAC,IAAa,EAAE,EAAE,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC;YAClE,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrB,QAAQ,CAAC,mBAAmB,GAAG,KAAK,CAAC;YACvC,CAAC;QACH,CAAC;aAAM,IACL,YAAY;YACX,YAAoB,CAAC,eAAe,CAAC,KAAK,SAAS;YACnD,YAAoB,CAAC,eAAe,CAAC,KAAK,IAAI,EAC/C,CAAC;YACD,QAAQ,CAAC,mBAAmB,GAAG,CAAE,YAAoB,CAAC,eAAe,CAAC,CAAC,CAAC;QAC1E,CAAC;QAED,gBAAgB;QAChB,IAAI,SAAS,CAAC,YAAY,EAAE,CAAC;YAC3B,QAAQ,CAAC,YAAY,GAAG,SAAS,CAAC,YAAY,CAAC;QACjD,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACK,2BAA2B,CACjC,QAAoC,EACpC,QAAyB;QAEzB,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,eAAe,EAAE,CAAC;YACvD,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAC9B,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAuB,EAAE;YAChE,MAAM,cAAc,GAAG,QAAQ,CAAC,UAAW,CAAC,eAAgB,CAAC,MAAM,CAAC,CAAC;YAErE,kCAAkC;YAClC,IAAI,IAAA,yBAAiB,EAAC,cAAc,CAAC,EAAE,CAAC;gBACtC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;YAC1C,CAAC;YAED,MAAM,QAAQ,GAAG,IAAI,IAAI,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;YACxE,MAAM,MAAM,GAAwB;gBAClC,MAAM;gBACN,IAAI,EAAE,cAAc,CAAC,IAAgB;gBACrC,MAAM;gBACN,IAAI,EAAE,MAAM,IAAI,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;gBAChE,EAAE,EAAE,QAAQ,IAAI,CAAC,QAAQ,KAAK,OAAO,IAAI,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,QAAQ,CAAC;oBACtF,CAAC,CAAC,QAAQ;oBACV,CAAC,CAAC,SAAS;aACd,CAAC;YAEF,6BAA6B;YAC7B,IAAI,cAAc,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACnC,MAAM,CAAC,UAAU,GAAG,QAAQ,IAAI,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;gBACnF,MAAM,CAAC,YAAY,GAAG,cAAc,IAAI,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;YACnG,CAAC;YAED,+BAA+B;YAC/B,MAAM,CAAC,WAAW,GAAG,aAAa,IAAI,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;YAE9F,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;CACF;AA3cD,oDA2cC","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  SecuritySchemeObject,\n  AuthType,\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(\n    url: string,\n    options: LoadOptions = {}\n  ): 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(\n          `Failed to fetch OpenAPI spec from URL: ${response.status} ${response.statusText}`,\n          { url, 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(\n    filePath: string,\n    options: LoadOptions = {}\n  ): 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(\n    yamlString: string,\n    options: LoadOptions = {}\n  ): 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(\n    json: object,\n    options: LoadOptions = {}\n  ): 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: any) {\n          console.warn(`Failed to generate tool for ${method.toUpperCase()} ${pathStr}:`, error.message);\n        }\n      }\n    }\n\n    return tools;\n  }\n\n  /**\n   * Generate a specific tool for a path and method\n   */\n  async generateTool(\n    pathStr: string,\n    method: string,\n    options: GenerateOptions = {}\n  ): 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(\n        securitySpec as Record<string, string[]>[],\n        document\n      );\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: any,\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 any);\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: any,\n    document: OpenAPIDocument,\n    outputSchema?: any\n  ): any {\n    const metadata: any = {\n      path,\n      method,\n      operationId: operation.operationId,\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,\n        document\n      );\n    }\n\n    // Extract servers\n    if (operation.servers || document.servers) {\n      metadata.servers = (operation.servers ?? document.servers).map((server: any) => ({\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    if (outputSchema && Array.isArray((outputSchema as any).oneOf)) {\n      const codes = (outputSchema as any).oneOf\n        .map((schema: any) => (schema as any)['x-status-code'])\n        .filter((code: unknown) => code !== undefined && code !== null);\n      if (codes.length > 0) {\n        metadata.responseStatusCodes = codes;\n      }\n    } else if (\n      outputSchema &&\n      (outputSchema as any)['x-status-code'] !== undefined &&\n      (outputSchema as any)['x-status-code'] !== null\n    ) {\n      metadata.responseStatusCodes = [(outputSchema as any)['x-status-code']];\n    }\n\n    // External docs\n    if (operation.externalDocs) {\n      metadata.externalDocs = operation.externalDocs;\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: apiKeyIn && (apiKeyIn === 'query' || apiKeyIn === 'header' || apiKeyIn === 'cookie')\n            ? apiKeyIn\n            : 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.d.ts

@@ -3,6 +3,8 @@ export { SchemaBuilder } from './schema-builder';
 export { ParameterResolver } from './parameter-resolver';
 export { ResponseBuilder } from './response-builder';
 export { Validator } from './validator';
+export { SecurityResolver, createSecurityContext } from './security-resolver';
 export { OpenAPIToolError, LoadError, ParseError, ValidationError, GenerationError, SchemaError, } from './errors';
-export type { McpOpenAPITool, ParameterMapper, ToolMetadata, SerializationInfo, SecurityRequirement, ServerInfo, LoadOptions, GenerateOptions, NamingStrategy, OperationWithContext, OpenAPIDocument, OpenAPIVersion, HTTPMethod, ParameterLocation, AuthType, OperationObject, ParameterObject, RequestBodyObject, ResponseObject, ResponsesObject, MediaTypeObject, HeaderObject, ExampleObject, PathItemObject, PathsObject, ServerObject, SecuritySchemeObject, ReferenceObject, TagObject, ExternalDocumentationObject, ServerVariableObject, EncodingObject, SecurityRequirementObject, SchemaObject, ValidationResult, ValidationErrorDetail, ValidationWarning, } from './types';
+export type { McpOpenAPITool, ParameterMapper, ToolMetadata, SerializationInfo, SecurityRequirement, SecurityParameterInfo, ServerInfo, LoadOptions, GenerateOptions, NamingStrategy, OperationWithContext, OpenAPIDocument, OpenAPIVersion, HTTPMethod, ParameterLocation, AuthType, OperationObject, ParameterObject, RequestBodyObject, ResponseObject, ResponsesObject, MediaTypeObject, HeaderObject, ExampleObject, PathItemObject, PathsObject, ServerObject, SecuritySchemeObject, ReferenceObject, TagObject, ExternalDocumentationObject, ServerVariableObject, EncodingObject, SecurityRequirementObject, SchemaObject, ValidationResult, ValidationErrorDetail, ValidationWarning, } from './types';
+export type { SecurityContext, ResolvedSecurity, DigestAuthCredentials, ClientCertificate, AWSCredentials, SignatureData, } from './security-resolver';
 export { isReferenceObject, toJSONSchema7 } from './types';

package/src/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toJSONSchema7 = exports.isReferenceObject = exports.SchemaError = exports.GenerationError = exports.ValidationError = exports.ParseError = exports.LoadError = exports.OpenAPIToolError = exports.Validator = exports.ResponseBuilder = exports.ParameterResolver = exports.SchemaBuilder = exports.OpenAPIToolGenerator = void 0;
+exports.toJSONSchema7 = 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; } });
@@ -12,6 +12,9 @@ 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; } });

package/src/index.js.map

@@ -1 +1 @@
-{"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;AAElB,gBAAgB;AAChB,mCAOkB;AANhB,0GAAA,gBAAgB,OAAA;AAChB,mGAAA,SAAS,OAAA;AACT,oGAAA,UAAU,OAAA;AACV,yGAAA,eAAe,OAAA;AACf,yGAAA,eAAe,OAAA;AACf,qGAAA,WAAW,OAAA;AAqDb,kBAAkB;AAClB,iCAA2D;AAAlD,0GAAA,iBAAiB,OAAA;AAAE,sGAAA,aAAa,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';\n\n// Error exports\nexport {\n  OpenAPIToolError,\n  LoadError,\n  ParseError,\n  ValidationError,\n  GenerationError,\n  SchemaError,\n} from './errors';\n\n// Type exports\nexport type {\n  // Main MCP types\n  McpOpenAPITool,\n  ParameterMapper,\n  ToolMetadata,\n  SerializationInfo,\n  SecurityRequirement,\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// Utility exports\nexport { isReferenceObject, toJSONSchema7 } from './types';\n"]}
+{"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,mCAOkB;AANhB,0GAAA,gBAAgB,OAAA;AAChB,mGAAA,SAAS,OAAA;AACT,oGAAA,UAAU,OAAA;AACV,yGAAA,eAAe,OAAA;AACf,yGAAA,eAAe,OAAA;AACf,qGAAA,WAAW,OAAA;AAgEb,kBAAkB;AAClB,iCAA2D;AAAlD,0GAAA,iBAAiB,OAAA;AAAE,sGAAA,aAAa,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 {\n  OpenAPIToolError,\n  LoadError,\n  ParseError,\n  ValidationError,\n  GenerationError,\n  SchemaError,\n} from './errors';\n\n// Type exports\nexport type {\n  // Main MCP types\n  McpOpenAPITool,\n  ParameterMapper,\n  ToolMetadata,\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, toJSONSchema7 } from './types';\n"]}

package/src/parameter-resolver.d.ts

@@ -1,5 +1,5 @@
 import type { JSONSchema7 } from 'json-schema';
-import type { ParameterMapper, ParameterObject, NamingStrategy } from './types';
+import type { ParameterMapper, ParameterObject, NamingStrategy, SecurityRequirement } from './types';
 /**
  * Resolves parameters and handles naming conflicts
  */
@@ -13,7 +13,7 @@ export declare class ParameterResolver {
     /**
      * Resolve all parameters for an operation
      */
-    resolve(operation: any, pathParameters?: ParameterObject[]): {
+    resolve(operation: any, pathParameters?: ParameterObject[], securityRequirements?: SecurityRequirement[], includeSecurityInInput?: boolean): {
         inputSchema: JSONSchema7;
         mapper: ParameterMapper[];
     };
@@ -29,4 +29,8 @@ export declare class ParameterResolver {
      * Select the most appropriate content type
      */
     private selectContentType;
+    /**
+     * Process security requirements and add to mapper/inputSchema
+     */
+    private processSecurityRequirements;
 }

package/src/parameter-resolver.js

@@ -27,7 +27,7 @@ class ParameterResolver {
     /**
      * Resolve all parameters for an operation
      */
-    resolve(operation, pathParameters) {
+    resolve(operation, pathParameters, securityRequirements, includeSecurityInInput) {
         const allParameters = [
             ...(pathParameters ?? []),
             ...(operation.parameters ?? []),
@@ -104,6 +104,10 @@ class ParameterResolver {
                 });
             }
         }
+        // Process security requirements
+        if (securityRequirements && securityRequirements.length > 0) {
+            this.processSecurityRequirements(securityRequirements, properties, required, mapper, includeSecurityInInput ?? false);
+        }
         const inputSchema = {
             type: 'object',
             properties,
@@ -126,7 +130,7 @@ class ParameterResolver {
             for (const [propName, propSchema] of Object.entries(jsonSchema.properties)) {
                 const fullName = prefix ? `${prefix}.${propName}` : propName;
                 const isRequired = required && requiredFields.has(propName);
-                if (typeof propSchema === 'object' && !('$ref' in propSchema)) {
+                if (typeof propSchema === 'object') {
                     const info = {
                         name: fullName,
                         location: 'body',
@@ -206,6 +210,87 @@ class ParameterResolver {
         }
         return firstKey;
     }
+    /**
+     * Process security requirements and add to mapper/inputSchema
+     */
+    processSecurityRequirements(securityRequirements, properties, required, mapper, includeInInput) {
+        for (const secReq of securityRequirements) {
+            const { scheme, type, name: apiKeyName, in: apiKeyIn, scopes } = secReq;
+            // Build security parameter info
+            const securityInfo = {
+                scheme,
+                type,
+                scopes,
+            };
+            // Determine parameter details based on security type
+            let inputKey;
+            let headerKey;
+            let paramLocation;
+            let description;
+            let schema;
+            if (type === 'http') {
+                // HTTP auth (bearer, basic, etc.)
+                inputKey = scheme;
+                headerKey = 'Authorization';
+                paramLocation = 'header';
+                const httpScheme = 'httpScheme' in secReq && secReq.httpScheme ? secReq.httpScheme : 'bearer';
+                const bearerFormat = 'bearerFormat' in secReq ? secReq.bearerFormat : undefined;
+                securityInfo.httpScheme = httpScheme;
+                if (bearerFormat) {
+                    securityInfo.bearerFormat = bearerFormat;
+                }
+                description = `${httpScheme.charAt(0).toUpperCase()}${httpScheme.slice(1)} authentication token`;
+                if (bearerFormat) {
+                    description += ` (${bearerFormat})`;
+                }
+                schema = {
+                    type: 'string',
+                    description,
+                };
+            }
+            else if (type === 'apiKey') {
+                // API Key auth
+                inputKey = scheme;
+                headerKey = apiKeyName || 'X-API-Key';
+                paramLocation = (apiKeyIn || 'header');
+                securityInfo.apiKeyName = apiKeyName;
+                securityInfo.apiKeyIn = apiKeyIn;
+                description = `API key for ${scheme}`;
+                schema = {
+                    type: 'string',
+                    description,
+                };
+            }
+            else if (type === 'oauth2' || type === 'openIdConnect') {
+                // OAuth2 / OpenID Connect
+                inputKey = scheme;
+                headerKey = 'Authorization';
+                paramLocation = 'header';
+                description = `OAuth2 access token${scopes && scopes.length > 0 ? ` (scopes: ${scopes.join(', ')})` : ''}`;
+                schema = {
+                    type: 'string',
+                    description,
+                };
+            }
+            else {
+                // Unknown type, skip
+                continue;
+            }
+            // Add to mapper (always)
+            mapper.push({
+                inputKey,
+                type: paramLocation,
+                key: headerKey,
+                required: true,
+                security: securityInfo,
+            });
+            // Add to inputSchema (only if includeInInput is true)
+            if (includeInInput) {
+                properties[inputKey] = schema;
+                required.push(inputKey);
+            }
+        }
+    }
 }
 exports.ParameterResolver = ParameterResolver;
 //# sourceMappingURL=parameter-resolver.js.map

package/src/parameter-resolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"parameter-resolver.js","sourceRoot":"","sources":["../../src/parameter-resolver.ts"],"names":[],"mappings":";;;AAUA,mCAAwC;AAExC;;GAEG;AACH,MAAa,iBAAiB;IAG5B,YAAY,cAA+B;QACzC,IAAI,CAAC,cAAc,GAAG,cAAc,IAAI;YACtC,gBAAgB,EAAE,IAAI,CAAC,uBAAuB;SAC/C,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,uBAAuB,CAC7B,SAAiB,EACjB,QAA2B,EAC3B,KAAa;QAEb,MAAM,cAAc,GAAG;YACrB,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,OAAO;YACd,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,MAAM;SACb,CAAC,QAAQ,CAAC,CAAC;QAEZ,OAAO,GAAG,cAAc,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACtF,CAAC;IAED;;OAEG;IACH,OAAO,CACL,SAAc,EACd,cAAkC;QAKlC,MAAM,aAAa,GAAsB;YACvC,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC;YACzB,GAAG,CAAC,SAAS,CAAC,UAAU,IAAI,EAAE,CAAC;SAChC,CAAC;QAEF,MAAM,WAAW,GAAG,SAAS,CAAC,WAA4C,CAAC;QAE3E,mDAAmD;QACnD,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAA2B,CAAC;QAE5D,8BAA8B;QAC9B,aAAa,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YAC9B,MAAM,IAAI,GAAkB;gBAC1B,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,QAAQ,EAAE,KAAK,CAAC,EAAuB;gBACvC,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,MAAM,CAAC;gBACjD,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC1C,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,aAAa,EAAE,KAAK,CAAC,aAAa;gBAClC,UAAU,EAAE,KAAK,CAAC,UAAU;aAC7B,CAAC;YAEF,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACvC,CAAC;YACD,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QAEH,uBAAuB;QACvB,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC;YACzB,MAAM,WAAW,GAAG,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAChE,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YAEnD,IAAI,SAAS,EAAE,MAAM,EAAE,CAAC;gBACtB,IAAI,CAAC,qBAAqB,CACxB,SAAS,CAAC,MAAM,EAChB,gBAAgB,EAChB,WAAW,CAAC,QAAQ,IAAI,KAAK,EAC7B,WAAW,CACZ,CAAC;YACJ,CAAC;QACH,CAAC;QAED,8CAA8C;QAC9C,MAAM,UAAU,GAAgC,EAAE,CAAC;QACnD,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAsB,EAAE,CAAC;QAErC,KAAK,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,gBAAgB,CAAC,OAAO,EAAE,EAAE,CAAC;YAChE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACxB,cAAc;gBACd,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;gBACxB,MAAM,QAAQ,GAAG,YAAY,CAAC;gBAE9B,UAAU,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;gBACxD,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;oBACnB,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC1B,CAAC;gBAED,MAAM,CAAC,IAAI,CAAC;oBACV,QAAQ;oBACR,IAAI,EAAE,KAAK,CAAC,QAAQ;oBACpB,GAAG,EAAE,YAAY;oBACjB,QAAQ,EAAE,KAAK,CAAC,QAAQ;oBACxB,KAAK,EAAE,KAAK,CAAC,KAAK;oBAClB,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,aAAa,EAAE,KAAK,CAAC,aAAa;iBACnC,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,6BAA6B;gBAC7B,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;oBAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,gBAAgB,CACnD,YAAY,EACZ,KAAK,CAAC,QAAQ,EACd,KAAK,CACN,CAAC;oBAEF,UAAU,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;oBACxD,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;wBACnB,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;oBAC1B,CAAC;oBAED,MAAM,CAAC,IAAI,CAAC;wBACV,QAAQ;wBACR,IAAI,EAAE,KAAK,CAAC,QAAQ;wBACpB,GAAG,EAAE,YAAY;wBACjB,QAAQ,EAAE,KAAK,CAAC,QAAQ;wBACxB,KAAK,EAAE,KAAK,CAAC,KAAK;wBAClB,OAAO,EAAE,KAAK,CAAC,OAAO;wBACtB,aAAa,EAAE,KAAK,CAAC,aAAa;qBACnC,CAAC,CAAC;gBACL,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,MAAM,WAAW,GAAgB;YAC/B,IAAI,EAAE,QAAQ;YACd,UAAU;YACV,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC;YACxC,oBAAoB,EAAE,KAAK;SAC5B,CAAC;QAEF,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IACjC,CAAC;IAED;;OAEG;IACK,qBAAqB,CAC3B,MAAsC,EACtC,gBAA8C,EAC9C,QAAiB,EACjB,WAAmB,EACnB,MAAM,GAAG,EAAE;QAEX,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,OAAO;QAElD,wCAAwC;QACxC,MAAM,UAAU,GAAG,IAAA,qBAAa,EAAC,MAAM,CAAC,CAAC;QAEzC,wBAAwB;QACxB,IAAI,UAAU,CAAC,IAAI,KAAK,QAAQ,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC;YAC1D,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;YAE1D,KAAK,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC3E,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;gBAC7D,MAAM,UAAU,GAAG,QAAQ,IAAI,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBAE5D,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,IAAI,UAAU,CAAC,EAAE,CAAC;oBAC9D,MAAM,IAAI,GAAkB;wBAC1B,IAAI,EAAE,QAAQ;wBACd,QAAQ,EAAE,MAAM;wBAChB,QAAQ,EAAE,UAAU;wBACpB,MAAM,EAAE,UAAyB;wBACjC,WAAW,EAAG,UAAkB,CAAC,WAAW;wBAC5C,aAAa,EAAE;4BACb,WAAW;yBACZ;qBACF,CAAC;oBAEF,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;wBACpC,gBAAgB,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;oBACrC,CAAC;oBACD,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC7C,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,wEAAwE;YACxE,MAAM,aAAa,GAAG,MAAM,IAAI,MAAM,CAAC;YACvC,MAAM,IAAI,GAAkB;gBAC1B,IAAI,EAAE,aAAa;gBACnB,QAAQ,EAAE,MAAM;gBAChB,QAAQ;gBACR,MAAM;gBACN,aAAa,EAAE;oBACb,WAAW;iBACZ;aACF,CAAC;YAEF,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;gBACzC,gBAAgB,CAAC,GAAG,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;YAC1C,CAAC;YACD,gBAAgB,CAAC,GAAG,CAAC,aAAa,CAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED;;OAEG;IACK,oBAAoB,CAAC,KAAoB;QAC/C,MAAM,MAAM,GAAgB,IAAA,qBAAa,EAAC,KAAK,CAAC,MAAa,CAAC,CAAC;QAE/D,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;QACzC,CAAC;QAED,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YACrB,MAAM,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;QAC9B,CAAC;QAED,yBAAyB;QACxB,MAAc,CAAC,sBAAsB,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC;QACzD,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YACf,MAAc,CAAC,mBAAmB,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC;QACrD,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC/B,MAAc,CAAC,qBAAqB,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC;QACzD,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,iBAAiB,CAAC,OAA4B;QACpD,mBAAmB;QACnB,MAAM,WAAW,GAAG;YAClB,kBAAkB;YAClB,mCAAmC;YACnC,qBAAqB;YACrB,iBAAiB;YACjB,YAAY;SACb,CAAC;QAEF,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC/B,IAAI,OAAO,CAAC,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAC;QACjC,CAAC;QAED,8BAA8B;QAC9B,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AAhQD,8CAgQC","sourcesContent":["import type { JSONSchema7 } from 'json-schema';\nimport type {\n  ParameterMapper,\n  ParameterObject,\n  RequestBodyObject,\n  NamingStrategy,\n  ParameterLocation,\n  SchemaObject,\n  ReferenceObject,\n} from './types';\nimport { toJSONSchema7 } from './types';\n\n/**\n * Resolves parameters and handles naming conflicts\n */\nexport class ParameterResolver {\n  private namingStrategy: NamingStrategy;\n\n  constructor(namingStrategy?: NamingStrategy) {\n    this.namingStrategy = namingStrategy ?? {\n      conflictResolver: this.defaultConflictResolver,\n    };\n  }\n\n  /**\n   * Default conflict resolver: prefix with location\n   */\n  private defaultConflictResolver(\n    paramName: string,\n    location: ParameterLocation,\n    index: number\n  ): string {\n    const locationPrefix = {\n      path: 'path',\n      query: 'query',\n      header: 'header',\n      cookie: 'cookie',\n      body: 'body',\n    }[location];\n\n    return `${locationPrefix}${paramName.charAt(0).toUpperCase()}${paramName.slice(1)}`;\n  }\n\n  /**\n   * Resolve all parameters for an operation\n   */\n  resolve(\n    operation: any,\n    pathParameters?: ParameterObject[]\n  ): {\n    inputSchema: JSONSchema7;\n    mapper: ParameterMapper[];\n  } {\n    const allParameters: ParameterObject[] = [\n      ...(pathParameters ?? []),\n      ...(operation.parameters ?? []),\n    ];\n\n    const requestBody = operation.requestBody as RequestBodyObject | undefined;\n\n    // Collect all parameter names and detect conflicts\n    const parametersByName = new Map<string, ParameterInfo[]>();\n\n    // Process standard parameters\n    allParameters.forEach((param) => {\n      const info: ParameterInfo = {\n        name: param.name,\n        location: param.in as ParameterLocation,\n        required: param.required ?? (param.in === 'path'),\n        schema: param.schema ?? { type: 'string' },\n        description: param.description,\n        style: param.style,\n        explode: param.explode,\n        allowReserved: param.allowReserved,\n        deprecated: param.deprecated,\n      };\n\n      if (!parametersByName.has(param.name)) {\n        parametersByName.set(param.name, []);\n      }\n      parametersByName.get(param.name)!.push(info);\n    });\n\n    // Process request body\n    if (requestBody?.content) {\n      const contentType = this.selectContentType(requestBody.content);\n      const mediaType = requestBody.content[contentType];\n\n      if (mediaType?.schema) {\n        this.extractBodyParameters(\n          mediaType.schema,\n          parametersByName,\n          requestBody.required ?? false,\n          contentType\n        );\n      }\n    }\n\n    // Resolve conflicts and build schema + mapper\n    const properties: Record<string, JSONSchema7> = {};\n    const required: string[] = [];\n    const mapper: ParameterMapper[] = [];\n\n    for (const [originalName, params] of parametersByName.entries()) {\n      if (params.length === 1) {\n        // No conflict\n        const param = params[0];\n        const inputKey = originalName;\n\n        properties[inputKey] = this.buildParameterSchema(param);\n        if (param.required) {\n          required.push(inputKey);\n        }\n\n        mapper.push({\n          inputKey,\n          type: param.location,\n          key: originalName,\n          required: param.required,\n          style: param.style,\n          explode: param.explode,\n          serialization: param.serialization,\n        });\n      } else {\n        // Conflict - need to resolve\n        params.forEach((param, index) => {\n          const inputKey = this.namingStrategy.conflictResolver(\n            originalName,\n            param.location,\n            index\n          );\n\n          properties[inputKey] = this.buildParameterSchema(param);\n          if (param.required) {\n            required.push(inputKey);\n          }\n\n          mapper.push({\n            inputKey,\n            type: param.location,\n            key: originalName,\n            required: param.required,\n            style: param.style,\n            explode: param.explode,\n            serialization: param.serialization,\n          });\n        });\n      }\n    }\n\n    const inputSchema: JSONSchema7 = {\n      type: 'object',\n      properties,\n      ...(required.length > 0 && { required }),\n      additionalProperties: false,\n    };\n\n    return { inputSchema, mapper };\n  }\n\n  /**\n   * Extract parameters from request body schema\n   */\n  private extractBodyParameters(\n    schema: SchemaObject | ReferenceObject,\n    parametersByName: Map<string, ParameterInfo[]>,\n    required: boolean,\n    contentType: string,\n    prefix = ''\n  ): void {\n    if (!schema || typeof schema !== 'object') return;\n\n    // Convert to JSONSchema7 for processing\n    const jsonSchema = toJSONSchema7(schema);\n\n    // Handle object schemas\n    if (jsonSchema.type === 'object' && jsonSchema.properties) {\n      const requiredFields = new Set(jsonSchema.required ?? []);\n\n      for (const [propName, propSchema] of Object.entries(jsonSchema.properties)) {\n        const fullName = prefix ? `${prefix}.${propName}` : propName;\n        const isRequired = required && requiredFields.has(propName);\n\n        if (typeof propSchema === 'object' && !('$ref' in propSchema)) {\n          const info: ParameterInfo = {\n            name: fullName,\n            location: 'body',\n            required: isRequired,\n            schema: propSchema as JSONSchema7,\n            description: (propSchema as any).description,\n            serialization: {\n              contentType,\n            },\n          };\n\n          if (!parametersByName.has(fullName)) {\n            parametersByName.set(fullName, []);\n          }\n          parametersByName.get(fullName)!.push(info);\n        }\n      }\n    } else {\n      // For non-object bodies (arrays, primitives), treat as single parameter\n      const bodyParamName = prefix || 'body';\n      const info: ParameterInfo = {\n        name: bodyParamName,\n        location: 'body',\n        required,\n        schema,\n        serialization: {\n          contentType,\n        },\n      };\n\n      if (!parametersByName.has(bodyParamName)) {\n        parametersByName.set(bodyParamName, []);\n      }\n      parametersByName.get(bodyParamName)!.push(info);\n    }\n  }\n\n  /**\n   * Build JSON Schema for a parameter\n   */\n  private buildParameterSchema(param: ParameterInfo): JSONSchema7 {\n    const schema: JSONSchema7 = toJSONSchema7(param.schema as any);\n\n    if (param.description) {\n      schema.description = param.description;\n    }\n\n    if (param.deprecated) {\n      schema['deprecated'] = true;\n    }\n\n    // Add parameter metadata\n    (schema as any)['x-parameter-location'] = param.location;\n    if (param.style) {\n      (schema as any)['x-parameter-style'] = param.style;\n    }\n    if (param.explode !== undefined) {\n      (schema as any)['x-parameter-explode'] = param.explode;\n    }\n\n    return schema;\n  }\n\n  /**\n   * Select the most appropriate content type\n   */\n  private selectContentType(content: Record<string, any>): string {\n    // Preference order\n    const preferences = [\n      'application/json',\n      'application/x-www-form-urlencoded',\n      'multipart/form-data',\n      'application/xml',\n      'text/plain',\n    ];\n\n    for (const pref of preferences) {\n      if (content[pref]) return pref;\n    }\n\n    // Fallback to first available\n    const firstKey = Object.keys(content)[0];\n    if (!firstKey) {\n      throw new Error('No content type available in request body');\n    }\n    return firstKey;\n  }\n}\n\n/**\n * Internal parameter info structure\n */\ninterface ParameterInfo {\n  name: string;\n  location: ParameterLocation;\n  required: boolean;\n  schema: SchemaObject | ReferenceObject | JSONSchema7;\n  description?: string;\n  style?: string;\n  explode?: boolean;\n  allowReserved?: boolean;\n  deprecated?: boolean;\n  serialization?: {\n    contentType?: string;\n    encoding?: Record<string, any>;\n  };\n}\n"]}
+{"version":3,"file":"parameter-resolver.js","sourceRoot":"","sources":["../../src/parameter-resolver.ts"],"names":[],"mappings":";;;AAaA,mCAA2D;AAE3D;;GAEG;AACH,MAAa,iBAAiB;IAG5B,YAAY,cAA+B;QACzC,IAAI,CAAC,cAAc,GAAG,cAAc,IAAI;YACtC,gBAAgB,EAAE,IAAI,CAAC,uBAAuB;SAC/C,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,uBAAuB,CAC7B,SAAiB,EACjB,QAA2B,EAC3B,KAAa;QAEb,MAAM,cAAc,GAAG;YACrB,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,OAAO;YACd,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,MAAM;SACb,CAAC,QAAQ,CAAC,CAAC;QAEZ,OAAO,GAAG,cAAc,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACtF,CAAC;IAED;;OAEG;IACH,OAAO,CACL,SAAc,EACd,cAAkC,EAClC,oBAA4C,EAC5C,sBAAgC;QAKhC,MAAM,aAAa,GAAsB;YACvC,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC;YACzB,GAAG,CAAC,SAAS,CAAC,UAAU,IAAI,EAAE,CAAC;SAChC,CAAC;QAEF,MAAM,WAAW,GAAG,SAAS,CAAC,WAA4C,CAAC;QAE3E,mDAAmD;QACnD,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAA2B,CAAC;QAE5D,8BAA8B;QAC9B,aAAa,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YAC9B,MAAM,IAAI,GAAkB;gBAC1B,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,QAAQ,EAAE,KAAK,CAAC,EAAuB;gBACvC,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,MAAM,CAAC;gBACjD,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC1C,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,aAAa,EAAE,KAAK,CAAC,aAAa;gBAClC,UAAU,EAAE,KAAK,CAAC,UAAU;aAC7B,CAAC;YAEF,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACvC,CAAC;YACD,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QAEH,uBAAuB;QACvB,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC;YACzB,MAAM,WAAW,GAAG,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAChE,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YAEnD,IAAI,SAAS,EAAE,MAAM,EAAE,CAAC;gBACtB,IAAI,CAAC,qBAAqB,CACxB,SAAS,CAAC,MAAM,EAChB,gBAAgB,EAChB,WAAW,CAAC,QAAQ,IAAI,KAAK,EAC7B,WAAW,CACZ,CAAC;YACJ,CAAC;QACH,CAAC;QAED,8CAA8C;QAC9C,MAAM,UAAU,GAAgC,EAAE,CAAC;QACnD,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAsB,EAAE,CAAC;QAErC,KAAK,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,gBAAgB,CAAC,OAAO,EAAE,EAAE,CAAC;YAChE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACxB,cAAc;gBACd,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;gBACxB,MAAM,QAAQ,GAAG,YAAY,CAAC;gBAE9B,UAAU,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;gBACxD,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;oBACnB,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC1B,CAAC;gBAED,MAAM,CAAC,IAAI,CAAC;oBACV,QAAQ;oBACR,IAAI,EAAE,KAAK,CAAC,QAAQ;oBACpB,GAAG,EAAE,YAAY;oBACjB,QAAQ,EAAE,KAAK,CAAC,QAAQ;oBACxB,KAAK,EAAE,KAAK,CAAC,KAAK;oBAClB,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,aAAa,EAAE,KAAK,CAAC,aAAa;iBACnC,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,6BAA6B;gBAC7B,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;oBAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,gBAAgB,CACnD,YAAY,EACZ,KAAK,CAAC,QAAQ,EACd,KAAK,CACN,CAAC;oBAEF,UAAU,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;oBACxD,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;wBACnB,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;oBAC1B,CAAC;oBAED,MAAM,CAAC,IAAI,CAAC;wBACV,QAAQ;wBACR,IAAI,EAAE,KAAK,CAAC,QAAQ;wBACpB,GAAG,EAAE,YAAY;wBACjB,QAAQ,EAAE,KAAK,CAAC,QAAQ;wBACxB,KAAK,EAAE,KAAK,CAAC,KAAK;wBAClB,OAAO,EAAE,KAAK,CAAC,OAAO;wBACtB,aAAa,EAAE,KAAK,CAAC,aAAa;qBACnC,CAAC,CAAC;gBACL,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,gCAAgC;QAChC,IAAI,oBAAoB,IAAI,oBAAoB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5D,IAAI,CAAC,2BAA2B,CAC9B,oBAAoB,EACpB,UAAU,EACV,QAAQ,EACR,MAAM,EACN,sBAAsB,IAAI,KAAK,CAChC,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAgB;YAC/B,IAAI,EAAE,QAAQ;YACd,UAAU;YACV,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC;YACxC,oBAAoB,EAAE,KAAK;SAC5B,CAAC;QAEF,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IACjC,CAAC;IAED;;OAEG;IACK,qBAAqB,CAC3B,MAAsC,EACtC,gBAA8C,EAC9C,QAAiB,EACjB,WAAmB,EACnB,MAAM,GAAG,EAAE;QAEX,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,OAAO;QAElD,wCAAwC;QACxC,MAAM,UAAU,GAAG,IAAA,qBAAa,EAAC,MAAM,CAAC,CAAC;QAEzC,wBAAwB;QACxB,IAAI,UAAU,CAAC,IAAI,KAAK,QAAQ,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC;YAC1D,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;YAE1D,KAAK,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC3E,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;gBAC7D,MAAM,UAAU,GAAG,QAAQ,IAAI,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBAE5D,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;oBACnC,MAAM,IAAI,GAAkB;wBAC1B,IAAI,EAAE,QAAQ;wBACd,QAAQ,EAAE,MAAM;wBAChB,QAAQ,EAAE,UAAU;wBACpB,MAAM,EAAE,UAAyB;wBACjC,WAAW,EAAG,UAAkB,CAAC,WAAW;wBAC5C,aAAa,EAAE;4BACb,WAAW;yBACZ;qBACF,CAAC;oBAEF,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;wBACpC,gBAAgB,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;oBACrC,CAAC;oBACD,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC7C,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,wEAAwE;YACxE,MAAM,aAAa,GAAG,MAAM,IAAI,MAAM,CAAC;YACvC,MAAM,IAAI,GAAkB;gBAC1B,IAAI,EAAE,aAAa;gBACnB,QAAQ,EAAE,MAAM;gBAChB,QAAQ;gBACR,MAAM;gBACN,aAAa,EAAE;oBACb,WAAW;iBACZ;aACF,CAAC;YAEF,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;gBACzC,gBAAgB,CAAC,GAAG,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;YAC1C,CAAC;YACD,gBAAgB,CAAC,GAAG,CAAC,aAAa,CAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED;;OAEG;IACK,oBAAoB,CAAC,KAAoB;QAC/C,MAAM,MAAM,GAAgB,IAAA,qBAAa,EAAC,KAAK,CAAC,MAAa,CAAC,CAAC;QAE/D,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;QACzC,CAAC;QAED,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YACrB,MAAM,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;QAC9B,CAAC;QAED,yBAAyB;QACxB,MAAc,CAAC,sBAAsB,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC;QACzD,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YACf,MAAc,CAAC,mBAAmB,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC;QACrD,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC/B,MAAc,CAAC,qBAAqB,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC;QACzD,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,iBAAiB,CAAC,OAA4B;QACpD,mBAAmB;QACnB,MAAM,WAAW,GAAG;YAClB,kBAAkB;YAClB,mCAAmC;YACnC,qBAAqB;YACrB,iBAAiB;YACjB,YAAY;SACb,CAAC;QAEF,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC/B,IAAI,OAAO,CAAC,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAC;QACjC,CAAC;QAED,8BAA8B;QAC9B,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACK,2BAA2B,CACjC,oBAA2C,EAC3C,UAAuC,EACvC,QAAkB,EAClB,MAAyB,EACzB,cAAuB;QAEvB,KAAK,MAAM,MAAM,IAAI,oBAAoB,EAAE,CAAC;YAC1C,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;YAExE,gCAAgC;YAChC,MAAM,YAAY,GAA0B;gBAC1C,MAAM;gBACN,IAAI;gBACJ,MAAM;aACP,CAAC;YAEF,qDAAqD;YACrD,IAAI,QAAgB,CAAC;YACrB,IAAI,SAAiB,CAAC;YACtB,IAAI,aAAgC,CAAC;YACrC,IAAI,WAAmB,CAAC;YACxB,IAAI,MAAmB,CAAC;YAExB,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;gBACpB,kCAAkC;gBAClC,QAAQ,GAAG,MAAM,CAAC;gBAClB,SAAS,GAAG,eAAe,CAAC;gBAC5B,aAAa,GAAG,QAAQ,CAAC;gBAEzB,MAAM,UAAU,GAAG,YAAY,IAAI,MAAM,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC;gBAC9F,MAAM,YAAY,GAAG,cAAc,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;gBAEhF,YAAY,CAAC,UAAU,GAAG,UAAU,CAAC;gBACrC,IAAI,YAAY,EAAE,CAAC;oBACjB,YAAY,CAAC,YAAY,GAAG,YAAY,CAAC;gBAC3C,CAAC;gBAED,WAAW,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,uBAAuB,CAAC;gBACjG,IAAI,YAAY,EAAE,CAAC;oBACjB,WAAW,IAAI,KAAK,YAAY,GAAG,CAAC;gBACtC,CAAC;gBAED,MAAM,GAAG;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW;iBACZ,CAAC;YACJ,CAAC;iBAAM,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC7B,eAAe;gBACf,QAAQ,GAAG,MAAM,CAAC;gBAClB,SAAS,GAAG,UAAU,IAAI,WAAW,CAAC;gBACtC,aAAa,GAAG,CAAC,QAAQ,IAAI,QAAQ,CAAsB,CAAC;gBAE5D,YAAY,CAAC,UAAU,GAAG,UAAU,CAAC;gBACrC,YAAY,CAAC,QAAQ,GAAG,QAAQ,CAAC;gBAEjC,WAAW,GAAG,eAAe,MAAM,EAAE,CAAC;gBACtC,MAAM,GAAG;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW;iBACZ,CAAC;YACJ,CAAC;iBAAM,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,eAAe,EAAE,CAAC;gBACzD,0BAA0B;gBAC1B,QAAQ,GAAG,MAAM,CAAC;gBAClB,SAAS,GAAG,eAAe,CAAC;gBAC5B,aAAa,GAAG,QAAQ,CAAC;gBAEzB,WAAW,GAAG,sBAAsB,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;gBAC3G,MAAM,GAAG;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW;iBACZ,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,qBAAqB;gBACrB,SAAS;YACX,CAAC;YAED,yBAAyB;YACzB,MAAM,CAAC,IAAI,CAAC;gBACV,QAAQ;gBACR,IAAI,EAAE,aAAa;gBACnB,GAAG,EAAE,SAAS;gBACd,QAAQ,EAAE,IAAI;gBACd,QAAQ,EAAE,YAAY;aACvB,CAAC,CAAC;YAEH,sDAAsD;YACtD,IAAI,cAAc,EAAE,CAAC;gBACnB,UAAU,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC;gBAC9B,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;CACF;AA9WD,8CA8WC","sourcesContent":["import type { JSONSchema7 } from 'json-schema';\nimport type {\n  ParameterMapper,\n  ParameterObject,\n  RequestBodyObject,\n  NamingStrategy,\n  ParameterLocation,\n  SchemaObject,\n  ReferenceObject,\n  SecurityRequirement,\n  SecurityParameterInfo,\n  SecuritySchemeObject,\n} from './types';\nimport { toJSONSchema7, isReferenceObject } from './types';\n\n/**\n * Resolves parameters and handles naming conflicts\n */\nexport class ParameterResolver {\n  private namingStrategy: NamingStrategy;\n\n  constructor(namingStrategy?: NamingStrategy) {\n    this.namingStrategy = namingStrategy ?? {\n      conflictResolver: this.defaultConflictResolver,\n    };\n  }\n\n  /**\n   * Default conflict resolver: prefix with location\n   */\n  private defaultConflictResolver(\n    paramName: string,\n    location: ParameterLocation,\n    index: number\n  ): string {\n    const locationPrefix = {\n      path: 'path',\n      query: 'query',\n      header: 'header',\n      cookie: 'cookie',\n      body: 'body',\n    }[location];\n\n    return `${locationPrefix}${paramName.charAt(0).toUpperCase()}${paramName.slice(1)}`;\n  }\n\n  /**\n   * Resolve all parameters for an operation\n   */\n  resolve(\n    operation: any,\n    pathParameters?: ParameterObject[],\n    securityRequirements?: SecurityRequirement[],\n    includeSecurityInInput?: boolean\n  ): {\n    inputSchema: JSONSchema7;\n    mapper: ParameterMapper[];\n  } {\n    const allParameters: ParameterObject[] = [\n      ...(pathParameters ?? []),\n      ...(operation.parameters ?? []),\n    ];\n\n    const requestBody = operation.requestBody as RequestBodyObject | undefined;\n\n    // Collect all parameter names and detect conflicts\n    const parametersByName = new Map<string, ParameterInfo[]>();\n\n    // Process standard parameters\n    allParameters.forEach((param) => {\n      const info: ParameterInfo = {\n        name: param.name,\n        location: param.in as ParameterLocation,\n        required: param.required ?? (param.in === 'path'),\n        schema: param.schema ?? { type: 'string' },\n        description: param.description,\n        style: param.style,\n        explode: param.explode,\n        allowReserved: param.allowReserved,\n        deprecated: param.deprecated,\n      };\n\n      if (!parametersByName.has(param.name)) {\n        parametersByName.set(param.name, []);\n      }\n      parametersByName.get(param.name)!.push(info);\n    });\n\n    // Process request body\n    if (requestBody?.content) {\n      const contentType = this.selectContentType(requestBody.content);\n      const mediaType = requestBody.content[contentType];\n\n      if (mediaType?.schema) {\n        this.extractBodyParameters(\n          mediaType.schema,\n          parametersByName,\n          requestBody.required ?? false,\n          contentType\n        );\n      }\n    }\n\n    // Resolve conflicts and build schema + mapper\n    const properties: Record<string, JSONSchema7> = {};\n    const required: string[] = [];\n    const mapper: ParameterMapper[] = [];\n\n    for (const [originalName, params] of parametersByName.entries()) {\n      if (params.length === 1) {\n        // No conflict\n        const param = params[0];\n        const inputKey = originalName;\n\n        properties[inputKey] = this.buildParameterSchema(param);\n        if (param.required) {\n          required.push(inputKey);\n        }\n\n        mapper.push({\n          inputKey,\n          type: param.location,\n          key: originalName,\n          required: param.required,\n          style: param.style,\n          explode: param.explode,\n          serialization: param.serialization,\n        });\n      } else {\n        // Conflict - need to resolve\n        params.forEach((param, index) => {\n          const inputKey = this.namingStrategy.conflictResolver(\n            originalName,\n            param.location,\n            index\n          );\n\n          properties[inputKey] = this.buildParameterSchema(param);\n          if (param.required) {\n            required.push(inputKey);\n          }\n\n          mapper.push({\n            inputKey,\n            type: param.location,\n            key: originalName,\n            required: param.required,\n            style: param.style,\n            explode: param.explode,\n            serialization: param.serialization,\n          });\n        });\n      }\n    }\n\n    // Process security requirements\n    if (securityRequirements && securityRequirements.length > 0) {\n      this.processSecurityRequirements(\n        securityRequirements,\n        properties,\n        required,\n        mapper,\n        includeSecurityInInput ?? false\n      );\n    }\n\n    const inputSchema: JSONSchema7 = {\n      type: 'object',\n      properties,\n      ...(required.length > 0 && { required }),\n      additionalProperties: false,\n    };\n\n    return { inputSchema, mapper };\n  }\n\n  /**\n   * Extract parameters from request body schema\n   */\n  private extractBodyParameters(\n    schema: SchemaObject | ReferenceObject,\n    parametersByName: Map<string, ParameterInfo[]>,\n    required: boolean,\n    contentType: string,\n    prefix = ''\n  ): void {\n    if (!schema || typeof schema !== 'object') return;\n\n    // Convert to JSONSchema7 for processing\n    const jsonSchema = toJSONSchema7(schema);\n\n    // Handle object schemas\n    if (jsonSchema.type === 'object' && jsonSchema.properties) {\n      const requiredFields = new Set(jsonSchema.required ?? []);\n\n      for (const [propName, propSchema] of Object.entries(jsonSchema.properties)) {\n        const fullName = prefix ? `${prefix}.${propName}` : propName;\n        const isRequired = required && requiredFields.has(propName);\n\n        if (typeof propSchema === 'object') {\n          const info: ParameterInfo = {\n            name: fullName,\n            location: 'body',\n            required: isRequired,\n            schema: propSchema as JSONSchema7,\n            description: (propSchema as any).description,\n            serialization: {\n              contentType,\n            },\n          };\n\n          if (!parametersByName.has(fullName)) {\n            parametersByName.set(fullName, []);\n          }\n          parametersByName.get(fullName)!.push(info);\n        }\n      }\n    } else {\n      // For non-object bodies (arrays, primitives), treat as single parameter\n      const bodyParamName = prefix || 'body';\n      const info: ParameterInfo = {\n        name: bodyParamName,\n        location: 'body',\n        required,\n        schema,\n        serialization: {\n          contentType,\n        },\n      };\n\n      if (!parametersByName.has(bodyParamName)) {\n        parametersByName.set(bodyParamName, []);\n      }\n      parametersByName.get(bodyParamName)!.push(info);\n    }\n  }\n\n  /**\n   * Build JSON Schema for a parameter\n   */\n  private buildParameterSchema(param: ParameterInfo): JSONSchema7 {\n    const schema: JSONSchema7 = toJSONSchema7(param.schema as any);\n\n    if (param.description) {\n      schema.description = param.description;\n    }\n\n    if (param.deprecated) {\n      schema['deprecated'] = true;\n    }\n\n    // Add parameter metadata\n    (schema as any)['x-parameter-location'] = param.location;\n    if (param.style) {\n      (schema as any)['x-parameter-style'] = param.style;\n    }\n    if (param.explode !== undefined) {\n      (schema as any)['x-parameter-explode'] = param.explode;\n    }\n\n    return schema;\n  }\n\n  /**\n   * Select the most appropriate content type\n   */\n  private selectContentType(content: Record<string, any>): string {\n    // Preference order\n    const preferences = [\n      'application/json',\n      'application/x-www-form-urlencoded',\n      'multipart/form-data',\n      'application/xml',\n      'text/plain',\n    ];\n\n    for (const pref of preferences) {\n      if (content[pref]) return pref;\n    }\n\n    // Fallback to first available\n    const firstKey = Object.keys(content)[0];\n    if (!firstKey) {\n      throw new Error('No content type available in request body');\n    }\n    return firstKey;\n  }\n\n  /**\n   * Process security requirements and add to mapper/inputSchema\n   */\n  private processSecurityRequirements(\n    securityRequirements: SecurityRequirement[],\n    properties: Record<string, JSONSchema7>,\n    required: string[],\n    mapper: ParameterMapper[],\n    includeInInput: boolean\n  ): void {\n    for (const secReq of securityRequirements) {\n      const { scheme, type, name: apiKeyName, in: apiKeyIn, scopes } = secReq;\n\n      // Build security parameter info\n      const securityInfo: SecurityParameterInfo = {\n        scheme,\n        type,\n        scopes,\n      };\n\n      // Determine parameter details based on security type\n      let inputKey: string;\n      let headerKey: string;\n      let paramLocation: ParameterLocation;\n      let description: string;\n      let schema: JSONSchema7;\n\n      if (type === 'http') {\n        // HTTP auth (bearer, basic, etc.)\n        inputKey = scheme;\n        headerKey = 'Authorization';\n        paramLocation = 'header';\n\n        const httpScheme = 'httpScheme' in secReq && secReq.httpScheme ? secReq.httpScheme : 'bearer';\n        const bearerFormat = 'bearerFormat' in secReq ? secReq.bearerFormat : undefined;\n\n        securityInfo.httpScheme = httpScheme;\n        if (bearerFormat) {\n          securityInfo.bearerFormat = bearerFormat;\n        }\n\n        description = `${httpScheme.charAt(0).toUpperCase()}${httpScheme.slice(1)} authentication token`;\n        if (bearerFormat) {\n          description += ` (${bearerFormat})`;\n        }\n\n        schema = {\n          type: 'string',\n          description,\n        };\n      } else if (type === 'apiKey') {\n        // API Key auth\n        inputKey = scheme;\n        headerKey = apiKeyName || 'X-API-Key';\n        paramLocation = (apiKeyIn || 'header') as ParameterLocation;\n\n        securityInfo.apiKeyName = apiKeyName;\n        securityInfo.apiKeyIn = apiKeyIn;\n\n        description = `API key for ${scheme}`;\n        schema = {\n          type: 'string',\n          description,\n        };\n      } else if (type === 'oauth2' || type === 'openIdConnect') {\n        // OAuth2 / OpenID Connect\n        inputKey = scheme;\n        headerKey = 'Authorization';\n        paramLocation = 'header';\n\n        description = `OAuth2 access token${scopes && scopes.length > 0 ? ` (scopes: ${scopes.join(', ')})` : ''}`;\n        schema = {\n          type: 'string',\n          description,\n        };\n      } else {\n        // Unknown type, skip\n        continue;\n      }\n\n      // Add to mapper (always)\n      mapper.push({\n        inputKey,\n        type: paramLocation,\n        key: headerKey,\n        required: true,\n        security: securityInfo,\n      });\n\n      // Add to inputSchema (only if includeInInput is true)\n      if (includeInInput) {\n        properties[inputKey] = schema;\n        required.push(inputKey);\n      }\n    }\n  }\n}\n\n/**\n * Internal parameter info structure\n */\ninterface ParameterInfo {\n  name: string;\n  location: ParameterLocation;\n  required: boolean;\n  schema: SchemaObject | ReferenceObject | JSONSchema7;\n  description?: string;\n  style?: string;\n  explode?: boolean;\n  allowReserved?: boolean;\n  deprecated?: boolean;\n  serialization?: {\n    contentType?: string;\n    encoding?: Record<string, any>;\n  };\n}\n"]}

package/src/schema-builder.d.ts

@@ -24,14 +24,6 @@ export declare class SchemaBuilder {
      * Add description to schema
      */
     static withDescription(schema: JSONSchema7, description: string): JSONSchema7;
-    /**
-     * Mark schema as required
-     */
-    static required(schema: JSONSchema7): JSONSchema7;
-    /**
-     * Mark schema as optional
-     */
-    static optional(schema: JSONSchema7): JSONSchema7;
     /**
      * Add example to schema
      */