openapi-mcp-generator/dist/utils/url.js

Generates MCP server code from OpenAPI specifications

/**
 * 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 function determineBaseUrl(api, cmdLineBaseUrl) {
    // Command line option takes precedence
    if (cmdLineBaseUrl) {
        return normalizeUrl(cmdLineBaseUrl);
    }
    // Single server in OpenAPI spec
    if (api.servers && api.servers.length === 1 && api.servers[0].url) {
        return normalizeUrl(api.servers[0].url);
    }
    // Multiple servers - use first one with warning
    if (api.servers && api.servers.length > 1) {
        console.warn(`Multiple servers found. Using first: "${api.servers[0].url}". Use --base-url to override.`);
        return normalizeUrl(api.servers[0].url);
    }
    // No server information available
    return null;
}
/**
 * Normalizes a URL by removing trailing slashes
 *
 * @param url URL to normalize
 * @returns Normalized URL
 */
export function normalizeUrl(url) {
    return url.replace(/\/$/, '');
}
/**
 * Joins URL segments handling slashes correctly
 *
 * @param baseUrl Base URL
 * @param path Path to append
 * @returns Joined URL
 */
export function joinUrl(baseUrl, path) {
    if (!baseUrl)
        return path;
    if (!path)
        return baseUrl;
    const normalizedBase = normalizeUrl(baseUrl);
    const normalizedPath = path.startsWith('/') ? path : `/${path}`;
    return `${normalizedBase}${normalizedPath}`;
}
/**
 * Builds a URL with query parameters
 *
 * @param baseUrl Base URL
 * @param queryParams Query parameters
 * @returns URL with query parameters
 */
export function buildUrlWithQuery(baseUrl, queryParams) {
    if (!Object.keys(queryParams).length)
        return baseUrl;
    const url = new URL(baseUrl.startsWith('http')
        ? baseUrl
        : `http://localhost${baseUrl.startsWith('/') ? '' : '/'}${baseUrl}`);
    for (const [key, value] of Object.entries(queryParams)) {
        if (Array.isArray(value)) {
            value.forEach((item) => url.searchParams.append(key, String(item)));
        }
        else {
            url.searchParams.append(key, String(value));
        }
    }
    // Remove http://localhost if we added it
    return baseUrl.startsWith('http') ? url.toString() : url.pathname + url.search;
}
/**
 * Extracts path parameters from a URL template
 *
 * @param urlTemplate URL template with {param} placeholders
 * @returns Array of parameter names
 */
export function extractPathParams(urlTemplate) {
    const paramRegex = /{([^}]+)}/g;
    const params = [];
    let match;
    while ((match = paramRegex.exec(urlTemplate)) !== null) {
        params.push(match[1]);
    }
    return params;
}
//# sourceMappingURL=url.js.map