@kimsungwhee/apple-docs-mcp/dist/utils/url-converter.js

MCP server for Apple Developer Documentation - Search iOS/macOS/SwiftUI/UIKit docs, WWDC videos, Swift/Objective-C APIs & code examples in Claude, Cursor & AI assistants

/**
 * URL conversion utilities for Apple Developer Documentation
 */
/**
 * Convert a web URL to a JSON API URL
 * @param webUrl The web URL to convert
 * @returns The corresponding JSON API URL
 */
export function convertToJsonApiUrl(webUrl) {
    try {
        // Remove trailing slash if present
        if (webUrl.endsWith('/')) {
            webUrl = webUrl.slice(0, -1);
        }
        // Extract the path from the URL
        const urlObj = new URL(webUrl);
        // Check if it's an Apple Developer URL
        if (urlObj.hostname !== 'developer.apple.com') {
            return null;
        }
        let path = urlObj.pathname;
        // For documentation URLs, format for the JSON API
        if (path.includes('/documentation/')) {
            // Remove /documentation/ prefix
            path = path.replace('/documentation/', '');
            // Convert to JSON API URL format
            return `https://developer.apple.com/tutorials/data/documentation/${path}.json`;
        }
        // For tutorial URLs, try to format for the JSON API
        if (path.includes('/tutorials/')) {
            // Try to convert tutorials URL to JSON API format
            // Remove /tutorials/ prefix and add .json
            const tutorialPath = path.replace('/tutorials/', '');
            return `https://developer.apple.com/tutorials/data/${tutorialPath}.json`;
        }
        // If not a recognized URL format, return the original URL
        return webUrl;
    }
    catch {
        return null;
    }
}
/**
 * Validate if URL is from Apple Developer domain
 * @param url The URL to validate
 * @returns True if valid Apple Developer URL
 */
export function isValidAppleDeveloperUrl(url) {
    try {
        const urlObj = new URL(url);
        return urlObj.hostname === 'developer.apple.com';
    }
    catch {
        return false;
    }
}
/**
 * Extract API name from URL
 * @param url The URL to extract name from
 * @returns The API name
 */
export function extractApiNameFromUrl(url) {
    try {
        return new URL(url).pathname.split('/').pop() || 'Unknown API';
    }
    catch {
        return 'Unknown API';
    }
}
//# sourceMappingURL=url-converter.js.map