@mweinbach/apple-docs-mcp 1.0.0

package/dist/tools/get-documentation-updates.js

@@ -0,0 +1,244 @@
+import { updatesCache, generateUrlCacheKey } from '../utils/cache.js';
+import { APPLE_URLS } from '../utils/constants.js';
+import { httpClient } from '../utils/http-client.js';
+import { logger } from '../utils/logger.js';
+/**
+ * Handle get documentation updates
+ */
+export async function handleGetDocumentationUpdates(category = 'all', technology, year, searchQuery, includeBeta = true, limit = 50) {
+    try {
+        logger.info('Fetching documentation updates...');
+        // Generate cache key
+        const cacheKey = generateUrlCacheKey('documentation-updates', {
+            category,
+            technology,
+            year,
+            searchQuery,
+            includeBeta,
+            limit,
+        });
+        // Try to get from cache first
+        const cachedResult = updatesCache.get(cacheKey);
+        if (cachedResult) {
+            logger.debug('Updates cache hit');
+            return cachedResult;
+        }
+        // Fetch both updates data files
+        const [updatesData, updatesIndex] = await Promise.all([
+            httpClient.getJson(APPLE_URLS.UPDATES_JSON),
+            httpClient.getJson(APPLE_URLS.UPDATES_INDEX_JSON),
+        ]);
+        // Parse and filter updates
+        const updates = parseUpdates(updatesData, updatesIndex);
+        const filteredUpdates = applyUpdatesFilters(updates, {
+            category,
+            technology,
+            year,
+            searchQuery,
+            includeBeta,
+            limit,
+        });
+        // Format output
+        const result = formatUpdatesList(filteredUpdates);
+        // Cache the result
+        updatesCache.set(cacheKey, result);
+        return result;
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : JSON.stringify(error);
+        logger.error('Error fetching documentation updates:', error);
+        return `Error: Failed to fetch documentation updates: ${errorMessage}`;
+    }
+}
+/**
+ * Parse updates data
+ */
+function parseUpdates(updatesData, updatesIndex) {
+    const updates = [];
+    // Process main updates sections
+    if (updatesData.topicSections) {
+        updatesData.topicSections.forEach(section => {
+            const sectionCategory = getSectionCategory(section.title);
+            section.identifiers.forEach(identifier => {
+                const reference = updatesData.references[identifier];
+                if (reference) {
+                    const updateItem = {
+                        title: reference.title,
+                        url: reference.url ? `https://developer.apple.com${reference.url}` : '',
+                        description: reference.abstract?.[0]?.text ?? '',
+                        category: sectionCategory,
+                        type: reference.kind ?? 'update',
+                        identifier,
+                        images: reference.images,
+                    };
+                    // Extract year from WWDC titles
+                    if (sectionCategory === 'wwdc' && reference.title) {
+                        const yearMatch = reference.title.match(/WWDC(\d{2,4})/);
+                        if (yearMatch) {
+                            updateItem.year = yearMatch[1].length === 2 ? `20${yearMatch[1]}` : yearMatch[1];
+                        }
+                    }
+                    updates.push(updateItem);
+                }
+            });
+        });
+    }
+    // Process index data for additional details and beta information
+    if (updatesIndex.interfaceLanguages?.swift) {
+        processIndexSection(updatesIndex.interfaceLanguages.swift, updates);
+    }
+    return updates;
+}
+/**
+ * Process index section recursively
+ */
+function processIndexSection(sections, updates) {
+    sections.forEach(section => {
+        // Find corresponding update item
+        const matchingUpdate = updates.find(u => u.url.includes(section.path) ||
+            u.title === section.title);
+        if (matchingUpdate) {
+            matchingUpdate.beta = section.beta ?? false;
+            matchingUpdate.technology = extractTechnologyFromPath(section.path);
+        }
+        // Process children
+        if (section.children) {
+            processIndexSection(section.children, updates);
+        }
+    });
+}
+/**
+ * Get section category
+ */
+function getSectionCategory(title) {
+    const lowerTitle = title.toLowerCase();
+    if (lowerTitle.includes('wwdc')) {
+        return 'wwdc';
+    }
+    if (lowerTitle.includes('release notes')) {
+        return 'release-notes';
+    }
+    if (lowerTitle.includes('technology')) {
+        return 'technology';
+    }
+    return 'other';
+}
+/**
+ * Extract technology from path
+ */
+function extractTechnologyFromPath(path) {
+    const match = path.match(/\/documentation\/updates\/([^/]+)/i);
+    if (match?.[1]) {
+        // Convert to proper case
+        return match[1].replace(/-/g, ' ')
+            .split(' ')
+            .map(word => word.charAt(0).toUpperCase() + word.slice(1))
+            .join(' ');
+    }
+    return undefined;
+}
+/**
+ * Apply filters to updates
+ */
+function applyUpdatesFilters(updates, filters) {
+    let filtered = [...updates];
+    // Category filter
+    if (filters.category && filters.category !== 'all') {
+        filtered = filtered.filter(update => update.category === filters.category);
+    }
+    // Technology filter
+    if (filters.technology) {
+        const techLower = filters.technology.toLowerCase();
+        filtered = filtered.filter(update => (update.technology?.toLowerCase().includes(techLower)) ||
+            update.title.toLowerCase().includes(techLower) ||
+            update.description.toLowerCase().includes(techLower));
+    }
+    // Year filter (for WWDC)
+    if (filters.year) {
+        filtered = filtered.filter(update => update.year === filters.year);
+    }
+    // Search query filter
+    if (filters.searchQuery) {
+        const queryLower = filters.searchQuery.toLowerCase();
+        filtered = filtered.filter(update => update.title.toLowerCase().includes(queryLower) ||
+            update.description.toLowerCase().includes(queryLower));
+    }
+    // Beta filter
+    if (!filters.includeBeta) {
+        filtered = filtered.filter(update => !update.beta);
+    }
+    // Apply limit
+    if (filters.limit && filters.limit > 0) {
+        filtered = filtered.slice(0, filters.limit);
+    }
+    return filtered;
+}
+/**
+ * Format updates list
+ */
+function formatUpdatesList(updates) {
+    if (updates.length === 0) {
+        return 'No documentation updates found matching the specified criteria.';
+    }
+    let content = '# Apple Developer Documentation Updates\n\n';
+    // Group by category
+    const grouped = updates.reduce((acc, update) => {
+        const category = update.category;
+        if (!acc[category]) {
+            acc[category] = [];
+        }
+        acc[category].push(update);
+        return acc;
+    }, {});
+    // Format each category
+    const categoryTitles = {
+        'wwdc': 'WWDC',
+        'technology': 'Technology Updates',
+        'release-notes': 'Release Notes',
+        'other': 'Other Updates',
+    };
+    Object.entries(grouped).forEach(([category, items]) => {
+        content += `## ${categoryTitles[category] ?? category}\n\n`;
+        // Add WWDC-specific suggestion
+        if (category === 'wwdc' && items.length > 0) {
+            content += '> **💡 Tip:** For comprehensive WWDC video content with full transcripts and code examples, use the dedicated WWDC tools:\n';
+            content += '> - `list_wwdc_videos` - Browse videos by year, topic, or code availability\n';
+            content += '> - `search_wwdc_content` - Search through video transcripts and code\n';
+            content += '> - `browse_wwdc_topics` - Explore videos by topic categories\n\n';
+        }
+        items.forEach(item => {
+            // Build title with badges
+            let titleLine = `### [${item.title}](${item.url})`;
+            const badges = [];
+            if (item.beta) {
+                badges.push('Beta');
+            }
+            if (item.images?.some(img => img.identifier === 'new.svg')) {
+                badges.push('New');
+            }
+            if (badges.length > 0) {
+                titleLine += ` *${badges.join(' | ')}*`;
+            }
+            content += titleLine + '\n';
+            // Add description
+            if (item.description) {
+                content += `${item.description}\n`;
+            }
+            // Add metadata
+            const metadata = [];
+            if (item.technology && item.category !== 'technology') {
+                metadata.push(`Technology: ${item.technology}`);
+            }
+            if (item.year && item.category === 'wwdc') {
+                metadata.push(`Year: ${item.year}`);
+            }
+            if (metadata.length > 0) {
+                content += `*${metadata.join(' | ')}*\n`;
+            }
+            content += '\n';
+        });
+    });
+    content += '\n---\n\n[View all updates on Apple Developer](https://developer.apple.com/documentation/updates)';
+    return content;
+}
+//# sourceMappingURL=get-documentation-updates.js.map

package/dist/tools/get-documentation-updates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-documentation-updates.js","sourceRoot":"","sources":["../../src/tools/get-documentation-updates.ts"],"names":[],"mappings":"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"}

package/dist/tools/get-platform-compatibility.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 获取平台兼容性分析
+ */
+export declare function handleGetPlatformCompatibility(apiUrl: string, compareMode?: string, includeRelated?: boolean): Promise<string>;
+//# sourceMappingURL=get-platform-compatibility.d.ts.map

package/dist/tools/get-platform-compatibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-platform-compatibility.d.ts","sourceRoot":"","sources":["../../src/tools/get-platform-compatibility.ts"],"names":[],"mappings":"AA4CA;;GAEG;AACH,wBAAsB,8BAA8B,CAClD,MAAM,EAAE,MAAM,EACd,WAAW,GAAE,MAAiB,EAC9B,cAAc,GAAE,OAAe,GAC9B,OAAO,CAAC,MAAM,CAAC,CAcjB"}

package/dist/tools/get-platform-compatibility.js

@@ -0,0 +1,205 @@
+import { convertToJsonApiUrl } from '../utils/url-converter.js';
+import { httpClient } from '../utils/http-client.js';
+import { logger } from '../utils/logger.js';
+import { PROCESSING_LIMITS } from '../utils/constants.js';
+/**
+ * 获取平台兼容性分析
+ */
+export async function handleGetPlatformCompatibility(apiUrl, compareMode = 'single', includeRelated = false) {
+    try {
+        logger.info(`Analyzing platform compatibility for: ${apiUrl}`);
+        if (compareMode === 'framework') {
+            return await analyzeFrameworkCompatibility(apiUrl, includeRelated);
+        }
+        else {
+            return await analyzeSingleApiCompatibility(apiUrl, includeRelated);
+        }
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return `Error: Failed to analyze platform compatibility: ${errorMessage}`;
+    }
+}
+/**
+ * 分析单个API的平台兼容性
+ */
+async function analyzeSingleApiCompatibility(apiUrl, includeRelated) {
+    const jsonApiUrl = convertToJsonApiUrl(apiUrl);
+    if (!jsonApiUrl) {
+        throw new Error('Invalid Apple Developer Documentation URL');
+    }
+    const data = await httpClient.getJson(jsonApiUrl);
+    if (!data.metadata?.platforms) {
+        return `No platform information available for: ${apiUrl}`;
+    }
+    const analysis = analyzeCompatibility(data.metadata.title || 'Unknown API', apiUrl, data.metadata.platforms);
+    let result = formatCompatibilityAnalysis(analysis);
+    // 如果需要包含相关API的兼容性信息
+    if (includeRelated && data.topicSections) {
+        const relatedAnalyses = await analyzeRelatedCompatibility(data, 3); // 限制3个相关API
+        if (relatedAnalyses.length > 0) {
+            result += '\n\n## Related APIs Compatibility\n\n';
+            for (const relatedAnalysis of relatedAnalyses) {
+                result += formatCompatibilityAnalysis(relatedAnalysis, true) + '\n';
+            }
+        }
+    }
+    return result;
+}
+/**
+ * 分析框架的平台兼容性
+ */
+async function analyzeFrameworkCompatibility(frameworkUrl, includeRelated) {
+    // 这里可以扩展为分析整个框架的兼容性
+    // 暂时使用单API分析作为基础
+    return await analyzeSingleApiCompatibility(frameworkUrl, includeRelated || true);
+}
+/**
+ * 分析相关API的兼容性
+ */
+async function analyzeRelatedCompatibility(data, maxRelated = 3) {
+    const analyses = [];
+    if (!data.topicSections || !data.references) {
+        return analyses;
+    }
+    let count = 0;
+    for (const section of data.topicSections) {
+        if (count >= maxRelated) {
+            break;
+        }
+        for (const identifier of section.identifiers.slice(0, PROCESSING_LIMITS.MAX_PLATFORM_COMPATIBILITY_ITEMS)) { // 每个section最多2个
+            if (count >= maxRelated) {
+                break;
+            }
+            const ref = data.references[identifier];
+            if (ref?.url) {
+                try {
+                    const relatedUrl = `https://developer.apple.com${ref.url}`;
+                    const relatedJsonUrl = convertToJsonApiUrl(relatedUrl);
+                    if (!relatedJsonUrl) {
+                        logger.warn(`Failed to convert URL: ${relatedUrl}`);
+                        continue;
+                    }
+                    const relatedData = await httpClient.getJson(relatedJsonUrl);
+                    if (relatedData.metadata?.platforms) {
+                        const analysis = analyzeCompatibility(ref.title || 'Unknown', relatedUrl, relatedData.metadata.platforms);
+                        analyses.push(analysis);
+                        count++;
+                    }
+                }
+                catch (error) {
+                    // 忽略单个相关API的错误
+                    logger.error(`Failed to fetch related API ${identifier}:`, error);
+                }
+            }
+        }
+    }
+    return analyses;
+}
+/**
+ * 分析兼容性数据
+ */
+function analyzeCompatibility(apiName, apiUrl, platforms) {
+    const supportedPlatforms = [];
+    const betaPlatforms = [];
+    const deprecatedPlatforms = [];
+    const minVersions = {};
+    for (const platform of platforms) {
+        supportedPlatforms.push(platform.name);
+        if (platform.beta) {
+            betaPlatforms.push(platform.name);
+        }
+        if (platform.deprecated) {
+            deprecatedPlatforms.push(platform.name);
+        }
+        if (platform.introducedAt) {
+            minVersions[platform.name] = platform.introducedAt;
+        }
+    }
+    return {
+        apiName,
+        apiUrl,
+        platforms,
+        supportedPlatforms,
+        betaPlatforms,
+        deprecatedPlatforms,
+        minVersions,
+        crossPlatformSupport: supportedPlatforms.length > 1,
+    };
+}
+/**
+ * 格式化兼容性分析结果
+ */
+function formatCompatibilityAnalysis(analysis, isRelated = false) {
+    const prefix = isRelated ? '### ' : '# ';
+    let content = `${prefix}Platform Compatibility: ${analysis.apiName}\n\n`;
+    if (!isRelated) {
+        content += `**API:** [${analysis.apiUrl}](${analysis.apiUrl})\n\n`;
+    }
+    // 平台支持概览
+    content += '## Platform Support Summary\n\n';
+    content += `**Supported Platforms:** ${analysis.supportedPlatforms.join(', ')}\n`;
+    content += `**Cross-Platform:** ${analysis.crossPlatformSupport ? 'Yes' : 'No'}\n`;
+    if (analysis.betaPlatforms.length > 0) {
+        content += `**Beta Platforms:** ${analysis.betaPlatforms.join(', ')}\n`;
+    }
+    if (analysis.deprecatedPlatforms.length > 0) {
+        content += `**Deprecated Platforms:** ${analysis.deprecatedPlatforms.join(', ')}\n`;
+    }
+    content += '\n';
+    // 详细平台信息
+    content += '## Detailed Platform Information\n\n';
+    for (const platform of analysis.platforms) {
+        content += `**${platform.name}**\n`;
+        if (platform.introducedAt) {
+            content += `- Introduced: ${platform.introducedAt}\n`;
+        }
+        if (platform.deprecatedAt) {
+            content += `- Deprecated: ${platform.deprecatedAt}\n`;
+        }
+        if (platform.obsoletedAt) {
+            content += `- Obsoleted: ${platform.obsoletedAt}\n`;
+        }
+        const status = [];
+        if (platform.beta) {
+            status.push('Beta');
+        }
+        if (platform.deprecated) {
+            status.push('Deprecated');
+        }
+        if (platform.unavailable) {
+            status.push('Unavailable');
+        }
+        if (status.length > 0) {
+            content += `- Status: ${status.join(', ')}\n`;
+        }
+        if (platform.message) {
+            content += `- Note: ${platform.message}\n`;
+        }
+        content += '\n';
+    }
+    // 兼容性建议
+    content += '## Compatibility Recommendations\n\n';
+    if (analysis.crossPlatformSupport) {
+        content += `✅ **Cross-platform compatible** - This API works across ${analysis.supportedPlatforms.length} platforms\n\n`;
+    }
+    else {
+        content += `⚠️ **Platform-specific** - This API is only available on ${analysis.supportedPlatforms[0]}\n\n`;
+    }
+    if (analysis.betaPlatforms.length > 0) {
+        content += '🚧 **Beta platforms** - Some platforms are in beta, expect changes\n\n';
+    }
+    if (analysis.deprecatedPlatforms.length > 0) {
+        content += '⚠️ **Deprecated platforms** - Consider migration plans for deprecated platforms\n\n';
+    }
+    // 最低版本要求
+    if (Object.keys(analysis.minVersions).length > 0) {
+        content += '## Minimum Version Requirements\n\n';
+        for (const [platform, version] of Object.entries(analysis.minVersions)) {
+            content += `- **${platform}:** ${version}+\n`;
+        }
+        content += '\n';
+    }
+    return content;
+}
+//# sourceMappingURL=get-platform-compatibility.js.map

package/dist/tools/get-platform-compatibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-platform-compatibility.js","sourceRoot":"","sources":["../../src/tools/get-platform-compatibility.ts"],"names":[],"mappings":"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"}

package/dist/tools/get-related-apis.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 获取相关API
+ */
+export declare function handleGetRelatedApis(apiUrl: string, includeInherited?: boolean, includeConformance?: boolean, includeSeeAlso?: boolean): Promise<string>;
+//# sourceMappingURL=get-related-apis.d.ts.map

package/dist/tools/get-related-apis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-related-apis.d.ts","sourceRoot":"","sources":["../../src/tools/get-related-apis.ts"],"names":[],"mappings":"AAsCA;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,gBAAgB,GAAE,OAAc,EAChC,kBAAkB,GAAE,OAAc,EAClC,cAAc,GAAE,OAAc,GAC7B,OAAO,CAAC,MAAM,CAAC,CA0EjB"}

package/dist/tools/get-related-apis.js

@@ -0,0 +1,155 @@
+import { convertToJsonApiUrl } from '../utils/url-converter.js';
+import { httpClient } from '../utils/http-client.js';
+import { logger } from '../utils/logger.js';
+import { PROCESSING_LIMITS } from '../utils/constants.js';
+/**
+ * 获取相关API
+ */
+export async function handleGetRelatedApis(apiUrl, includeInherited = true, includeConformance = true, includeSeeAlso = true) {
+    try {
+        logger.info(`Fetching related APIs for: ${apiUrl}`);
+        // 将网页URL转换为JSON API URL
+        const jsonApiUrl = convertToJsonApiUrl(apiUrl);
+        if (!jsonApiUrl) {
+            throw new Error('Invalid Apple Developer Documentation URL');
+        }
+        const data = await httpClient.getJson(jsonApiUrl);
+        // 收集所有相关API
+        const relatedApis = [];
+        // 处理关系部分（继承、一致性等）
+        if (data.relationshipsSections) {
+            for (const section of data.relationshipsSections) {
+                const shouldInclude = (includeInherited && (section.type === 'inheritsFrom' || section.type === 'inheritedBy')) ||
+                    (includeConformance && (section.type === 'conformsTo' || section.type === 'conformingTypes'));
+                if (shouldInclude && section.identifiers) {
+                    for (const identifier of section.identifiers) {
+                        const api = extractApiFromIdentifier(identifier, section.title, data.references);
+                        if (api) {
+                            relatedApis.push(api);
+                        }
+                    }
+                }
+            }
+        }
+        // 处理"另请参阅"部分
+        if (includeSeeAlso && data.seeAlsoSections) {
+            for (const section of data.seeAlsoSections) {
+                if (section.identifiers) {
+                    for (const identifier of section.identifiers) {
+                        const api = extractApiFromIdentifier(identifier, `See Also: ${section.title}`, data.references);
+                        if (api) {
+                            relatedApis.push(api);
+                        }
+                    }
+                }
+            }
+        }
+        // 处理主题部分的相关API
+        if (data.topicSections) {
+            for (const section of data.topicSections) {
+                if (section.identifiers && section.identifiers.length > 0) {
+                    // 只取前3个，避免过多
+                    const limitedIdentifiers = section.identifiers.slice(0, PROCESSING_LIMITS.MAX_RELATED_APIS_PER_SECTION);
+                    for (const identifier of limitedIdentifiers) {
+                        const api = extractApiFromIdentifier(identifier, `Related: ${section.title}`, data.references);
+                        if (api) {
+                            relatedApis.push(api);
+                        }
+                    }
+                }
+            }
+        }
+        // 去重
+        const uniqueApis = deduplicateApis(relatedApis);
+        // 格式化输出
+        return formatRelatedApis(apiUrl, uniqueApis);
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return `Error: Failed to get related APIs: ${errorMessage}`;
+    }
+}
+/**
+ * 从标识符提取API信息
+ */
+function extractApiFromIdentifier(identifier, relationship, references) {
+    // 先从references中查找
+    if (references?.[identifier]) {
+        const ref = references[identifier];
+        return {
+            title: ref.title || 'Unknown',
+            url: ref.url ? `https://developer.apple.com${ref.url}` : '#',
+            identifier,
+            type: ref.kind || ref.type || 'unknown',
+            relationship,
+            abstract: ref.abstract ? ref.abstract.map((a) => a.text || '').join(' ').trim() : undefined,
+        };
+    }
+    // 如果references中没有，尝试解析标识符
+    if (identifier.startsWith('doc://')) {
+        const parts = identifier.split('/');
+        const apiName = parts[parts.length - 1] || 'Unknown';
+        const pathPart = identifier.replace(/^doc:\/\/[^\/]+\/documentation\//, '');
+        return {
+            title: apiName,
+            url: `https://developer.apple.com/documentation/${pathPart}`,
+            identifier,
+            type: 'symbol',
+            relationship,
+        };
+    }
+    return null;
+}
+/**
+ * 去重API列表
+ */
+function deduplicateApis(apis) {
+    const seen = new Set();
+    return apis.filter(api => {
+        if (seen.has(api.identifier)) {
+            return false;
+        }
+        seen.add(api.identifier);
+        return true;
+    });
+}
+/**
+ * 格式化相关API输出
+ */
+function formatRelatedApis(originalUrl, relatedApis) {
+    if (relatedApis.length === 0) {
+        return `No related APIs found for: ${originalUrl}`;
+    }
+    const apiName = new URL(originalUrl).pathname.split('/').pop() || 'API';
+    let content = `# Related APIs for ${apiName}\n\n`;
+    content += `**Source:** [${originalUrl}](${originalUrl})\n\n`;
+    content += `**Found ${relatedApis.length} related APIs:**\n\n`;
+    // 按关系类型分组
+    const groupedApis = groupApisByRelationship(relatedApis);
+    for (const [relationship, apis] of Object.entries(groupedApis)) {
+        content += `## ${relationship}\n\n`;
+        for (const api of apis) {
+            content += `### [${api.title}](${api.url})\n`;
+            if (api.abstract) {
+                content += `${api.abstract}\n\n`;
+            }
+            content += `*Type: ${api.type}*\n\n`;
+        }
+    }
+    content += `---\n\n*Total: ${relatedApis.length} related APIs*`;
+    return content;
+}
+/**
+ * 按关系类型分组API
+ */
+function groupApisByRelationship(apis) {
+    const groups = {};
+    for (const api of apis) {
+        if (!groups[api.relationship]) {
+            groups[api.relationship] = [];
+        }
+        groups[api.relationship].push(api);
+    }
+    return groups;
+}
+//# sourceMappingURL=get-related-apis.js.map

package/dist/tools/get-related-apis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-related-apis.js","sourceRoot":"","sources":["../../src/tools/get-related-apis.ts"],"names":[],"mappings":"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"}