openapi-mcp-generator/dist/utils/url.d.ts

Generates MCP server code from OpenAPI specifications

/**
 * URL handling utilities for OpenAPI to MCP generator
 */
import { OpenAPIV3 } from 'openapi-types';
/**
 * Determines the base URL from the OpenAPI document or CLI options
 *
 * @param api OpenAPI document
 * @param cmdLineBaseUrl Optional base URL from command line options
 * @returns The determined base URL or null if none is available
 */
export declare function determineBaseUrl(api: OpenAPIV3.Document, cmdLineBaseUrl?: string): string | null;
/**
 * Normalizes a URL by removing trailing slashes
 *
 * @param url URL to normalize
 * @returns Normalized URL
 */
export declare function normalizeUrl(url: string): string;
/**
 * Joins URL segments handling slashes correctly
 *
 * @param baseUrl Base URL
 * @param path Path to append
 * @returns Joined URL
 */
export declare function joinUrl(baseUrl: string, path: string): string;
/**
 * Builds a URL with query parameters
 *
 * @param baseUrl Base URL
 * @param queryParams Query parameters
 * @returns URL with query parameters
 */
export declare function buildUrlWithQuery(baseUrl: string, queryParams: Record<string, any>): string;
/**
 * Extracts path parameters from a URL template
 *
 * @param urlTemplate URL template with {param} placeholders
 * @returns Array of parameter names
 */
export declare function extractPathParams(urlTemplate: string): string[];