@mweinbach/apple-docs-mcp 1.0.0

package/dist/tools/doc-formatter.js

@@ -0,0 +1,208 @@
+/**
+ * Document formatting utilities
+ */
+/**
+ * Format document header with title and status
+ */
+export function formatDocumentHeader(jsonData) {
+    let content = '';
+    // Add title with status information
+    const title = jsonData.metadata?.title ?? jsonData.title ?? 'Documentation';
+    const statusInfo = [];
+    // Check for beta/deprecated status
+    const isBeta = jsonData.metadata?.platforms?.some((p) => p.beta) ?? false;
+    const isDeprecated = jsonData.metadata?.platforms?.some((p) => p.deprecated) ?? false;
+    if (isBeta) {
+        statusInfo.push('**Beta**');
+    }
+    if (isDeprecated) {
+        statusInfo.push('**Deprecated**');
+    }
+    const statusText = statusInfo.length > 0 ? ` (${statusInfo.join(', ')})` : '';
+    content += `# ${title}${statusText}\n\n`;
+    // Add role/type information with symbol kind
+    if (jsonData.metadata?.roleHeading) {
+        let roleInfo = `**${jsonData.metadata.roleHeading}**`;
+        if (jsonData.metadata?.symbolKind) {
+            roleInfo += ` (${jsonData.metadata.symbolKind})`;
+        }
+        content += `${roleInfo}\n\n`;
+    }
+    return content;
+}
+/**
+ * Format document abstract
+ */
+export function formatDocumentAbstract(jsonData) {
+    if (!jsonData.abstract || !Array.isArray(jsonData.abstract)) {
+        return '';
+    }
+    const abstractText = jsonData.abstract
+        .map((item) => item?.text ?? '')
+        .join(' ')
+        .trim();
+    return abstractText ? `${abstractText}\n\n` : '';
+}
+/**
+ * Format platform availability section
+ */
+export function formatPlatformAvailability(jsonData) {
+    if (!jsonData.metadata?.platforms || !Array.isArray(jsonData.metadata.platforms)) {
+        return '';
+    }
+    let content = '## Platform Availability\n\n';
+    jsonData.metadata.platforms.forEach((platform) => {
+        content += formatPlatformLine(platform);
+    });
+    return content + '\n';
+}
+/**
+ * Format a single platform line
+ */
+function formatPlatformLine(platform) {
+    const platformStatus = [];
+    if (platform.beta) {
+        platformStatus.push('Beta');
+    }
+    if (platform.deprecated) {
+        platformStatus.push('Deprecated');
+    }
+    if (platform.unavailable) {
+        platformStatus.push('Unavailable');
+    }
+    let platformLine = `- **${platform.name}** ${platform.introducedAt ?? 'Unknown'}+`;
+    if (platform.deprecatedAt) {
+        platformLine += ` | Deprecated in ${platform.deprecatedAt}`;
+    }
+    if (platform.obsoletedAt) {
+        platformLine += ` | Obsoleted in ${platform.obsoletedAt}`;
+    }
+    if (platformStatus.length > 0) {
+        platformLine += ` | Status: ${platformStatus.join(', ')}`;
+    }
+    return `${platformLine}\n`;
+}
+/**
+ * Format See Also section
+ */
+export function formatSeeAlsoSection(jsonData) {
+    if (!jsonData.seeAlsoSections || !Array.isArray(jsonData.seeAlsoSections)) {
+        return '';
+    }
+    let content = '## See Also\n\n';
+    jsonData.seeAlsoSections.forEach((seeAlso) => {
+        if (seeAlso.title && seeAlso.identifiers) {
+            content += `### ${seeAlso.title}\n\n`;
+            content += formatSeeAlsoIdentifiers(seeAlso.identifiers);
+        }
+    });
+    return content;
+}
+/**
+ * Format See Also identifiers
+ */
+function formatSeeAlsoIdentifiers(identifiers) {
+    let content = '';
+    identifiers.forEach((identifier) => {
+        const apiName = identifier.split('/').pop() ?? identifier;
+        const apiPath = identifier.replace('doc://com.apple.SwiftUI/documentation/', '');
+        const apiUrl = `https://developer.apple.com/documentation/${apiPath}`;
+        content += `- [\`${apiName}\`](${apiUrl})\n`;
+    });
+    return content + '\n';
+}
+/**
+ * Check if document is a specific API
+ */
+export function isSpecificAPIDocument(jsonData) {
+    return jsonData.primaryContentSections?.some((section) => section?.kind === 'declarations') ?? false;
+}
+/**
+ * Format results in compact mode (titles + URLs only)
+ * Reduces token usage significantly for discovery operations
+ */
+export function formatCompactResults(results, header) {
+    if (results.length === 0) {
+        return header ? `${header}\n\nNo results found.` : 'No results found.';
+    }
+    let content = header ? `${header}\n\n` : '';
+    content += `Found ${results.length} results:\n\n`;
+    results.forEach((result, index) => {
+        content += `${index + 1}. [${result.title}](${result.url})`;
+        const metadata = [];
+        if (result.type)
+            metadata.push(result.type);
+        if (result.framework)
+            metadata.push(result.framework);
+        if (result.year)
+            metadata.push(result.year);
+        if (metadata.length > 0) {
+            content += ` - ${metadata.join(' | ')}`;
+        }
+        content += '\n';
+    });
+    return content;
+}
+/**
+ * Format WWDC videos in compact mode
+ */
+export function formatCompactVideos(videos, header) {
+    if (videos.length === 0) {
+        return header ? `${header}\n\nNo videos found.` : 'No videos found.';
+    }
+    let content = header ? `${header}\n\n` : '';
+    content += `Found ${videos.length} videos:\n\n`;
+    videos.forEach((video, index) => {
+        content += `${index + 1}. [${video.title}](${video.url})`;
+        const metadata = [];
+        if (video.year)
+            metadata.push(`WWDC${video.year}`);
+        if (video.hasCode)
+            metadata.push('Code');
+        if (video.hasTranscript)
+            metadata.push('Transcript');
+        if (metadata.length > 0) {
+            content += ` - ${metadata.join(' | ')}`;
+        }
+        content += '\n';
+    });
+    return content;
+}
+/**
+ * Format technologies in compact mode
+ */
+export function formatCompactTechnologies(technologies, header) {
+    if (technologies.length === 0) {
+        return header ? `${header}\n\nNo technologies found.` : 'No technologies found.';
+    }
+    let content = header ? `${header}\n\n` : '';
+    content += `Found ${technologies.length} technologies:\n\n`;
+    technologies.forEach((tech, index) => {
+        const betaMarker = tech.beta ? ' [Beta]' : '';
+        content += `${index + 1}. [${tech.title}](${tech.url})${betaMarker}`;
+        if (tech.category) {
+            content += ` - ${tech.category}`;
+        }
+        content += '\n';
+    });
+    return content;
+}
+/**
+ * Format code examples in compact mode
+ */
+export function formatCompactCodeExamples(examples, header) {
+    if (examples.length === 0) {
+        return header ? `${header}\n\nNo code examples found.` : 'No code examples found.';
+    }
+    let content = header ? `${header}\n\n` : '';
+    content += `Found ${examples.length} code examples:\n\n`;
+    examples.forEach((example, index) => {
+        content += `${index + 1}. ${example.title || 'Code Example'} [${example.language}] - [${example.videoTitle}](${example.videoUrl})`;
+        if (example.year) {
+            content += ` (WWDC${example.year})`;
+        }
+        content += '\n';
+    });
+    return content;
+}
+//# sourceMappingURL=doc-formatter.js.map

package/dist/tools/doc-formatter.js.map

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

package/dist/tools/find-similar-apis.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 查找相似API
+ */
+export declare function handleFindSimilarApis(apiUrl: string, searchDepth?: string, filterByCategory?: string, includeAlternatives?: boolean): Promise<string>;
+//# sourceMappingURL=find-similar-apis.d.ts.map

package/dist/tools/find-similar-apis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-similar-apis.d.ts","sourceRoot":"","sources":["../../src/tools/find-similar-apis.ts"],"names":[],"mappings":"AA4CA;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,WAAW,GAAE,MAAiB,EAC9B,gBAAgB,CAAC,EAAE,MAAM,EACzB,mBAAmB,GAAE,OAAc,GAClC,OAAO,CAAC,MAAM,CAAC,CAwEjB"}

package/dist/tools/find-similar-apis.js

@@ -0,0 +1,275 @@
+import { convertToJsonApiUrl } from '../utils/url-converter.js';
+import { httpClient } from '../utils/http-client.js';
+import { logger } from '../utils/logger.js';
+import { PROCESSING_LIMITS, SEARCH_DEPTH_LIMITS } from '../utils/constants.js';
+/**
+ * 查找相似API
+ */
+export async function handleFindSimilarApis(apiUrl, searchDepth = 'medium', filterByCategory, includeAlternatives = true) {
+    try {
+        logger.info(`Finding similar APIs for: ${apiUrl}`);
+        const jsonApiUrl = convertToJsonApiUrl(apiUrl);
+        // Check if conversion failed
+        if (!jsonApiUrl) {
+            throw new Error('Invalid Apple Developer Documentation URL');
+        }
+        const response = await httpClient.getJson(jsonApiUrl);
+        // Handle response structure - check if data is wrapped
+        let data;
+        let references;
+        if (response.data) {
+            // Response has a data property, extract it
+            data = response.data;
+            references = response.references || data.references;
+        }
+        else {
+            // Response is the data itself
+            data = response;
+            references = data.references;
+        }
+        // 收集相似API
+        const similarApis = [];
+        // 1. 从"另请参阅"部分收集
+        if (data.seeAlsoSections) {
+            const seeAlsoApis = extractSeeAlsoApis(data.seeAlsoSections, references, filterByCategory);
+            similarApis.push(...seeAlsoApis);
+        }
+        // 2. 从主题部分收集（medium 和 deep 模式）
+        if (searchDepth === 'medium' || searchDepth === 'deep') {
+            if (data.topicSections && includeAlternatives) {
+                const topicApis = extractTopicApis(data.topicSections, references, filterByCategory);
+                similarApis.push(...topicApis);
+            }
+        }
+        // 3. 深度搜索相关API（deep 模式）
+        if (searchDepth === 'deep') {
+            const deepApis = await extractDeepRelatedApis(similarApis.slice(0, PROCESSING_LIMITS.MAX_SIMILAR_APIS_FOR_DEEP_SEARCH)); // 限制前3个
+            similarApis.push(...deepApis);
+        }
+        // 去重和评分
+        const uniqueApis = deduplicateAndScore(similarApis);
+        // 按相似度排序
+        uniqueApis.sort((a, b) => b.confidence - a.confidence);
+        // 限制结果数量
+        const maxResults = SEARCH_DEPTH_LIMITS[searchDepth] || SEARCH_DEPTH_LIMITS.medium;
+        const limitedApis = uniqueApis.slice(0, maxResults);
+        // Get the title from data
+        const title = data.title || data.metadata?.title || data.identifier?.split('/').pop() || 'API';
+        return formatSimilarApis(apiUrl, limitedApis, title, data);
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        if (errorMessage.includes('Invalid Apple Developer Documentation URL')) {
+            throw error;
+        }
+        throw new Error(errorMessage);
+    }
+}
+/**
+ * 从"另请参阅"部分提取API
+ */
+function extractSeeAlsoApis(seeAlsoSections, references, filterByCategory) {
+    const apis = [];
+    for (const section of seeAlsoSections) {
+        // 过滤分类
+        if (filterByCategory && !section.title.toLowerCase().includes(filterByCategory.toLowerCase())) {
+            continue;
+        }
+        for (const identifier of section.identifiers) {
+            const api = createSimilarApi(identifier, section.title, 'See Also', 8, // 高相似度
+            references);
+            if (api) {
+                apis.push(api);
+            }
+        }
+    }
+    return apis;
+}
+/**
+ * 从主题部分提取API
+ */
+function extractTopicApis(topicSections, references, filterByCategory) {
+    const apis = [];
+    for (const section of topicSections) {
+        // 过滤分类
+        if (filterByCategory && !section.title.toLowerCase().includes(filterByCategory.toLowerCase())) {
+            continue;
+        }
+        // 限制每个主题的API数量
+        const limitedIdentifiers = section.identifiers.slice(0, PROCESSING_LIMITS.MAX_TOPIC_IDENTIFIERS);
+        for (const identifier of limitedIdentifiers) {
+            const api = createSimilarApi(identifier, section.title, 'Topic Group', 6, // 中等相似度
+            references);
+            if (api) {
+                apis.push(api);
+            }
+        }
+    }
+    return apis;
+}
+/**
+ * 深度搜索相关API
+ */
+async function extractDeepRelatedApis(seedApis) {
+    const deepApis = [];
+    for (const seedApi of seedApis) {
+        try {
+            const jsonApiUrl = convertToJsonApiUrl(seedApi.url);
+            if (!jsonApiUrl) {
+                logger.warn(`Failed to convert URL: ${seedApi.url}`);
+                continue;
+            }
+            const response = await httpClient.getJson(jsonApiUrl);
+            // Handle response structure
+            let data;
+            let references;
+            if (response.data) {
+                data = response.data;
+                references = response.references || data.references;
+            }
+            else {
+                data = response;
+                references = data.references;
+            }
+            // 只从"另请参阅"部分获取，避免过度扩展
+            if (data.seeAlsoSections) {
+                const relatedApis = extractSeeAlsoApis(data.seeAlsoSections, references);
+                // 降低相似度评分
+                relatedApis.forEach(api => {
+                    api.confidence = Math.max(api.confidence - 2, 3);
+                    api.similarityType = 'Deep Related';
+                });
+                deepApis.push(...relatedApis);
+            }
+        }
+        catch (error) {
+            logger.error(`Failed to fetch deep related API ${seedApi.url}:`, error);
+        }
+    }
+    return deepApis;
+}
+/**
+ * 创建相似API对象
+ */
+function createSimilarApi(identifier, category, similarityType, confidence, references) {
+    if (references?.[identifier]) {
+        const ref = references[identifier];
+        return {
+            title: ref.title || 'Unknown',
+            url: ref.url ? `https://developer.apple.com${ref.url}` : '#',
+            identifier,
+            abstract: ref.abstract ? ref.abstract.map((a) => a.text || '').join(' ').trim() : undefined,
+            category,
+            similarityType,
+            symbolKind: ref.kind || ref.symbolKind,
+            platforms: ref.platforms ? ref.platforms.map((p) => p.name) : undefined,
+            confidence,
+        };
+    }
+    // 如果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,
+            category,
+            similarityType,
+            confidence: confidence - 1, // 略降相似度
+        };
+    }
+    return null;
+}
+/**
+ * 去重和评分
+ */
+function deduplicateAndScore(apis) {
+    const apiMap = new Map();
+    for (const api of apis) {
+        const existing = apiMap.get(api.identifier);
+        if (existing) {
+            // 如果已存在，保留评分更高的
+            if (api.confidence > existing.confidence) {
+                apiMap.set(api.identifier, api);
+            }
+        }
+        else {
+            apiMap.set(api.identifier, api);
+        }
+    }
+    return Array.from(apiMap.values());
+}
+/**
+ * 格式化相似API结果
+ */
+function formatSimilarApis(originalUrl, similarApis, originalApiName, originalData) {
+    const apiName = originalApiName || new URL(originalUrl).pathname.split('/').pop() || 'API';
+    let content = `# Similar APIs to ${apiName}\n\n`;
+    if (similarApis.length === 0) {
+        content += 'No similar APIs found';
+        return content;
+    }
+    // Add metadata about the original API if available
+    if (originalData?.metadata) {
+        const roleHeading = originalData.metadata.roleHeading || '';
+        const platforms = originalData.metadata.platforms?.map(p => `${p.name} ${p.introducedAt || ''}+`).join(', ') || '';
+        if (roleHeading || platforms) {
+            content += `${roleHeading}${platforms ? ' · ' + platforms : ''}\n\n`;
+        }
+    }
+    content += `**Source:** [${originalUrl}](${originalUrl})\n\n`;
+    content += `**Found ${similarApis.length} similar APIs (sorted by relevance):**\n\n`;
+    // Group by category instead of similarity type for better organization
+    const groupedByCategory = new Map();
+    for (const api of similarApis) {
+        const key = `${api.similarityType}: ${api.category}`;
+        if (!groupedByCategory.has(key)) {
+            groupedByCategory.set(key, []);
+        }
+        groupedByCategory.get(key).push(api);
+    }
+    for (const [categoryKey, apis] of groupedByCategory) {
+        content += `## ${categoryKey}\n\n`;
+        for (const api of apis) {
+            content += formatSingleSimilarApi(api);
+        }
+    }
+    // 相似度分析
+    content += '## Similarity Analysis\n\n';
+    const avgConfidence = similarApis.reduce((sum, api) => sum + api.confidence, 0) / similarApis.length;
+    content += `**Average Similarity:** ${avgConfidence.toFixed(1)}/10\n`;
+    const highConfidenceApis = similarApis.filter(api => api.confidence >= 7);
+    if (highConfidenceApis.length > 0) {
+        content += `**Highly Similar APIs:** ${highConfidenceApis.length}\n`;
+    }
+    const categories = [...new Set(similarApis.map(api => api.category))];
+    content += `**Categories:** ${categories.join(', ')}\n\n`;
+    content += `---\n\n*Total: ${similarApis.length} similar APIs found*`;
+    return content;
+}
+/**
+ * 格式化单个相似API
+ */
+function formatSingleSimilarApi(api) {
+    let content = `### [${api.title}](${api.url})\n`;
+    if (api.abstract) {
+        content += `${api.abstract}\n\n`;
+    }
+    // 添加元数据
+    const metadata = [`Similarity: ${api.confidence}/10`];
+    if (api.symbolKind) {
+        metadata.push(`Type: ${api.symbolKind}`);
+    }
+    if (api.category !== api.similarityType) {
+        metadata.push(`Category: ${api.category}`);
+    }
+    content += `*${metadata.join(' | ')}*\n\n`;
+    // 添加平台信息
+    if (api.platforms && api.platforms.length > 0) {
+        content += `**Platforms:** ${api.platforms.join(', ')}\n\n`;
+    }
+    return content;
+}
+//# sourceMappingURL=find-similar-apis.js.map

package/dist/tools/find-similar-apis.js.map

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

package/dist/tools/get-documentation-updates.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Handle get documentation updates
+ */
+export declare function handleGetDocumentationUpdates(category?: string, technology?: string, year?: string, searchQuery?: string, includeBeta?: boolean, limit?: number): Promise<string>;
+//# sourceMappingURL=get-documentation-updates.d.ts.map

package/dist/tools/get-documentation-updates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-documentation-updates.d.ts","sourceRoot":"","sources":["../../src/tools/get-documentation-updates.ts"],"names":[],"mappings":"AA0CA;;GAEG;AACH,wBAAsB,6BAA6B,CACjD,QAAQ,GAAE,MAAc,EACxB,UAAU,CAAC,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,EACpB,WAAW,GAAE,OAAc,EAC3B,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,MAAM,CAAC,CAmDjB"}