@mweinbach/apple-docs-mcp 1.0.0

package/dist/tools/wwdc/topics-extractor.js

@@ -0,0 +1,146 @@
+/**
+ * WWDC video topic classification extractor
+ */
+import { JSDOM } from 'jsdom';
+import { httpClient } from '../../utils/http-client.js';
+import { logger } from '../../utils/logger.js';
+import { WWDC_URLS } from '../../utils/constants.js';
+/**
+ * Extract all topic categories
+ */
+export async function extractAllTopics() {
+    const url = WWDC_URLS.TOPICS;
+    logger.info('Extracting topic categories list...');
+    try {
+        const response = await httpClient.get(url);
+        const html = await response.text();
+        const dom = new JSDOM(html);
+        const document = dom.window.document;
+        const topics = [];
+        // Find topic links - look for both /videos/topics/xxx and /videos/xxx/ formats
+        const topicLinks = document.querySelectorAll('a[href*="/videos/"]');
+        topicLinks.forEach((link) => {
+            const href = link.getAttribute('href') || '';
+            // Look for topic links in different formats
+            const match = href.match(/\/videos\/topics\/([a-z-]+)/) ||
+                href.match(/\/videos\/([a-z-]+)\/?$/);
+            if (match && !href.includes('/play/')) {
+                const id = match[1];
+                // Skip non-topic links
+                if (id === 'all-videos' || id === 'collections' || id === 'about' ||
+                    id === 'wwdc' || /^\d+$/.test(id)) {
+                    return;
+                }
+                // Extract name from heading or link text
+                const heading = link.querySelector('h3, h4') || link;
+                const name = heading.textContent?.trim() || '';
+                if (!name) {
+                    return;
+                }
+                // Extract video count if available
+                let videoCount = 0; // Default to 0
+                const countElement = link.querySelector('p');
+                if (countElement) {
+                    const countMatch = countElement.textContent?.match(/(\d+)\s*videos?/i);
+                    if (countMatch) {
+                        videoCount = parseInt(countMatch[1]);
+                    }
+                }
+                topics.push({
+                    id,
+                    name,
+                    url: `${WWDC_URLS.BASE.replace('/videos', '')}${href}`,
+                    videoCount,
+                });
+            }
+        });
+        // Remove duplicates
+        const uniqueTopics = Array.from(new Map(topics.map(t => [t.id, t])).values());
+        // Sort alphabetically by name
+        uniqueTopics.sort((a, b) => a.name.localeCompare(b.name));
+        logger.info(`Found ${uniqueTopics.length} topic categories`);
+        return uniqueTopics;
+    }
+    catch (error) {
+        logger.error('Failed to extract topic categories:', error);
+        throw new Error(`Failed to extract topics: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Extract all videos for a specific topic
+ */
+export async function extractTopicVideos(topicId) {
+    const url = WWDC_URLS.getTopicUrl(topicId);
+    logger.info(`Extracting video list for topic ${topicId}...`);
+    try {
+        const response = await httpClient.get(url);
+        const html = await response.text();
+        const dom = new JSDOM(html);
+        const document = dom.window.document;
+        const videos = [];
+        // Find video cards
+        const videoCards = document.querySelectorAll('a[href*="/videos/play/"]');
+        videoCards.forEach((card) => {
+            const href = card.getAttribute('href') || '';
+            const match = href.match(/\/videos\/play\/wwdc(\d{4})\/(\d+)\//);
+            if (match) {
+                const year = match[1];
+                const id = match[2];
+                // Extract title
+                const titleEl = card.querySelector('h4, .title, [class*="title"]');
+                const title = titleEl?.textContent?.trim() || '';
+                // Extract duration
+                const durationEl = card.querySelector('.video-duration, [class*="duration"], time');
+                const duration = durationEl?.textContent?.trim() || '';
+                // Extract description
+                const descEl = card.querySelector('p, .description, [class*="description"]');
+                const description = descEl?.textContent?.trim();
+                // Extract thumbnail
+                const imgEl = card.querySelector('img');
+                const thumbnail = imgEl?.getAttribute('src') || imgEl?.getAttribute('data-src') || undefined;
+                if (title) {
+                    videos.push({
+                        id,
+                        year,
+                        title,
+                        duration,
+                        description,
+                        thumbnail,
+                        url: `${WWDC_URLS.BASE.replace('/videos', '')}${href}`,
+                    });
+                }
+            }
+        });
+        logger.info(`Found ${videos.length} videos`);
+        return videos;
+    }
+    catch (error) {
+        logger.error(`Failed to extract videos for topic ${topicId}:`, error);
+        throw error;
+    }
+}
+/**
+ * Standard topic mapping (ensures consistency)
+ */
+export const TOPIC_ID_TO_NAME = {
+    'accessibility-inclusion': 'Accessibility & Inclusion',
+    'app-services': 'App Services',
+    'app-store-distribution-marketing': 'App Store, Distribution & Marketing',
+    'audio-video': 'Audio & Video',
+    'business-education': 'Business & Education',
+    'design': 'Design',
+    'developer-tools': 'Developer Tools',
+    'essentials': 'Essentials',
+    'graphics-games': 'Graphics & Games',
+    'health-fitness': 'Health & Fitness',
+    'maps-location': 'Maps & Location',
+    'machine-learning-ai': 'Machine Learning & AI',
+    'photos-camera': 'Photos & Camera',
+    'privacy-security': 'Privacy & Security',
+    'safari-web': 'Safari & Web',
+    'spatial-computing': 'Spatial Computing',
+    'swift': 'Swift',
+    'swiftui-ui-frameworks': 'SwiftUI & UI Frameworks',
+    'system-services': 'System Services',
+};
+//# sourceMappingURL=topics-extractor.js.map

package/dist/tools/wwdc/topics-extractor.js.map

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

package/dist/tools/wwdc/video-list-extractor.d.ts

@@ -0,0 +1,13 @@
+/**
+ * WWDC video list extractor
+ */
+import type { VideoListItem } from '../../types/wwdc.js';
+/**
+ * Extract all WWDC video list for specified year
+ */
+export declare function extractVideoList(year: string): Promise<VideoListItem[]>;
+/**
+ * Get all supported WWDC years
+ */
+export declare function getAvailableYears(): Promise<string[]>;
+//# sourceMappingURL=video-list-extractor.d.ts.map

package/dist/tools/wwdc/video-list-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-list-extractor.d.ts","sourceRoot":"","sources":["../../../src/tools/wwdc/video-list-extractor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CA6D7E;AAqKD;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAuC3D"}

package/dist/tools/wwdc/video-list-extractor.js

@@ -0,0 +1,238 @@
+/**
+ * WWDC video list extractor
+ */
+import { JSDOM } from 'jsdom';
+import { httpClient } from '../../utils/http-client.js';
+import { logger } from '../../utils/logger.js';
+import { WWDC_URLS } from '../../utils/constants.js';
+/**
+ * Extract all WWDC video list for specified year
+ */
+export async function extractVideoList(year) {
+    const url = WWDC_URLS.getYearUrl(year);
+    logger.info(`Extracting video list for WWDC${year} from ${url}`);
+    try {
+        const response = await httpClient.get(url);
+        const html = await response.text();
+        const dom = new JSDOM(html);
+        const document = dom.window.document;
+        const uniqueVideos = new Map();
+        // Find all video cards
+        const videoElements = document.querySelectorAll('.video-card, .collection-item, article[data-video-id], a[href*="/videos/play/"]');
+        videoElements.forEach(element => {
+            const video = extractVideoFromElement(element, year);
+            if (video && !uniqueVideos.has(video.id)) {
+                uniqueVideos.set(video.id, video);
+            }
+        });
+        // If first method found nothing, try alternative selectors
+        if (uniqueVideos.size === 0) {
+            logger.warn('No videos found with primary selectors, trying alternative method');
+            // Find all video links
+            const videoLinks = document.querySelectorAll(`a[href*="/videos/play/wwdc${year}/"]`);
+            videoLinks.forEach(link => {
+                const href = link.getAttribute('href') || '';
+                const match = href.match(/\/videos\/play\/wwdc\d+\/(\d+)\/?/);
+                if (match) {
+                    const id = match[1];
+                    if (!uniqueVideos.has(id)) {
+                        const title = extractTitleFromLink(link);
+                        const url = WWDC_URLS.getVideoUrl(year, id);
+                        uniqueVideos.set(id, {
+                            id,
+                            url,
+                            title,
+                            duration: extractDurationFromLink(link),
+                            thumbnail: extractThumbnailFromLink(link),
+                        });
+                    }
+                }
+            });
+        }
+        const videos = Array.from(uniqueVideos.values());
+        logger.info(`Found ${videos.length} videos for WWDC${year}`);
+        return videos;
+    }
+    catch (error) {
+        logger.error(`Failed to extract video list for WWDC${year}:`, error);
+        throw new Error(`Failed to extract video list for WWDC${year}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Extract video information from element
+ */
+function extractVideoFromElement(element, year) {
+    // Extract video ID
+    let id = null;
+    // Get from data attribute
+    id = element.getAttribute('data-video-id');
+    // Get from link
+    if (!id) {
+        const link = element.querySelector('a[href*="/videos/play/"]') || element;
+        const href = link.getAttribute('href') || '';
+        const match = href.match(/\/videos\/play\/wwdc\d+\/(\d+)\/?/);
+        if (match) {
+            id = match[1];
+        }
+    }
+    if (!id) {
+        return null;
+    }
+    // Extract title
+    const title = extractTitle(element);
+    // Build URL
+    const url = WWDC_URLS.getVideoUrl(year, id);
+    // Extract duration
+    const duration = extractDuration(element);
+    // Extract thumbnail
+    const thumbnail = extractThumbnail(element);
+    return {
+        id,
+        url,
+        title,
+        duration,
+        thumbnail,
+    };
+}
+/**
+ * Extract title
+ */
+function extractTitle(element) {
+    const selectors = [
+        '.video-title',
+        '.item-title',
+        'h2',
+        'h3',
+        'h4',
+        '[itemprop="name"]',
+    ];
+    for (const selector of selectors) {
+        const titleElement = element.querySelector(selector);
+        if (titleElement?.textContent) {
+            return titleElement.textContent.trim();
+        }
+    }
+    // Get from image alt attribute
+    const img = element.querySelector('img[alt]');
+    if (img) {
+        const alt = img.getAttribute('alt') || '';
+        if (alt && !alt.toLowerCase().includes('thumbnail')) {
+            return alt.trim();
+        }
+    }
+    return 'Untitled';
+}
+/**
+ * Extract title from link element
+ */
+function extractTitleFromLink(link) {
+    // Try to get from link text
+    const linkText = link.textContent?.trim();
+    if (linkText && linkText.length > 3) {
+        return linkText;
+    }
+    // Try to get from parent element
+    const parent = link.parentElement;
+    if (parent) {
+        return extractTitle(parent);
+    }
+    // Try to get from adjacent element
+    const nextSibling = link.nextElementSibling;
+    if (nextSibling?.textContent) {
+        return nextSibling.textContent.trim();
+    }
+    return 'Untitled';
+}
+/**
+ * Extract duration
+ */
+function extractDuration(element) {
+    const selectors = [
+        '.video-duration',
+        '.duration',
+        '.time',
+        '[itemprop="duration"]',
+    ];
+    for (const selector of selectors) {
+        const durationElement = element.querySelector(selector);
+        if (durationElement?.textContent) {
+            const duration = durationElement.textContent.trim();
+            // Validate if it's time format
+            if (/\d+:\d+/.test(duration)) {
+                return duration;
+            }
+        }
+    }
+    return '';
+}
+/**
+ * Extract duration from link element
+ */
+function extractDurationFromLink(link) {
+    const parent = link.closest('.video-card, .collection-item, article');
+    if (parent) {
+        return extractDuration(parent);
+    }
+    return '';
+}
+/**
+ * Extract thumbnail
+ */
+function extractThumbnail(element) {
+    const img = element.querySelector('img[src*="devimages"], img.thumbnail, img.video-thumbnail');
+    if (img) {
+        const src = img.getAttribute('src') || '';
+        if (src) {
+            return src.startsWith('http') ? src : `${WWDC_URLS.BASE.replace('/videos', '')}${src}`;
+        }
+    }
+    return '';
+}
+/**
+ * Extract thumbnail from link element
+ */
+function extractThumbnailFromLink(link) {
+    const parent = link.closest('.video-card, .collection-item, article');
+    if (parent) {
+        return extractThumbnail(parent);
+    }
+    return '';
+}
+/**
+ * Get all supported WWDC years
+ */
+export async function getAvailableYears() {
+    const url = WWDC_URLS.BASE;
+    logger.info('Fetching available WWDC years');
+    try {
+        const response = await httpClient.get(url);
+        const html = await response.text();
+        const dom = new JSDOM(html);
+        const document = dom.window.document;
+        const years = [];
+        // Find all WWDC links
+        const wwdcLinks = document.querySelectorAll('a[href*="/videos/wwdc"]');
+        wwdcLinks.forEach(link => {
+            const href = link.getAttribute('href') || '';
+            const match = href.match(/wwdc(\d{2,4})/);
+            if (match) {
+                const year = match[1];
+                // Convert 2-digit year to 4-digit
+                const fullYear = year.length === 2 ? `20${year}` : year;
+                if (!years.includes(fullYear)) {
+                    years.push(fullYear);
+                }
+            }
+        });
+        // Sort by year in descending order
+        years.sort((a, b) => parseInt(b) - parseInt(a));
+        logger.info(`Found ${years.length} WWDC years: ${years.join(', ')}`);
+        return years;
+    }
+    catch (error) {
+        logger.error('Failed to fetch available years:', error);
+        // Return known years as fallback
+        return ['2025', '2024', '2023', '2022', '2021', '2020'];
+    }
+}
+//# sourceMappingURL=video-list-extractor.js.map

package/dist/tools/wwdc/video-list-extractor.js.map

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

package/dist/tools/wwdc/wwdc-handlers.d.ts

@@ -0,0 +1,32 @@
+/**
+ * WWDC Video MCP Tool Handlers
+ */
+/**
+ * List WWDC videos
+ */
+export declare function handleListWWDCVideos(year?: string, topic?: string, hasCode?: boolean, limit?: number): Promise<string>;
+/**
+ * Search WWDC content
+ */
+export declare function handleSearchWWDCContent(query: string, searchIn?: 'transcript' | 'code' | 'both', year?: string, language?: string, limit?: number): Promise<string>;
+/**
+ * Get WWDC video details
+ */
+export declare function handleGetWWDCVideo(year: string, videoId: string, includeTranscript?: boolean, includeCode?: boolean): Promise<string>;
+/**
+ * Get WWDC code examples
+ */
+export declare function handleGetWWDCCodeExamples(framework?: string, topic?: string, year?: string, language?: string, limit?: number): Promise<string>;
+/**
+ * Browse WWDC topics
+ */
+export declare function handleBrowseWWDCTopics(topicId?: string, includeVideos?: boolean, year?: string, limit?: number): Promise<string>;
+/**
+ * Find related WWDC videos
+ */
+export declare function handleFindRelatedWWDCVideos(videoId: string, year: string, includeExplicitRelated?: boolean, includeTopicRelated?: boolean, includeYearRelated?: boolean, limit?: number): Promise<string>;
+/**
+ * List all available WWDC years
+ */
+export declare function handleListWWDCYears(): Promise<string>;
+//# sourceMappingURL=wwdc-handlers.d.ts.map

package/dist/tools/wwdc/wwdc-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wwdc-handlers.d.ts","sourceRoot":"","sources":["../../../src/tools/wwdc/wwdc-handlers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAiCH;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,CAAC,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,OAAO,EACjB,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,MAAM,CAAC,CAwFjB;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,YAAY,GAAG,MAAM,GAAG,MAAe,EACjD,IAAI,CAAC,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,EACjB,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,MAAM,CAAC,CAoFjB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,iBAAiB,GAAE,OAAc,EACjC,WAAW,GAAE,OAAc,GAC1B,OAAO,CAAC,MAAM,CAAC,CAYjB;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,SAAS,CAAC,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,EACjB,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,MAAM,CAAC,CAqGjB;AA2VD;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,CAAC,EAAE,MAAM,EAChB,aAAa,GAAE,OAAc,EAC7B,IAAI,CAAC,EAAE,MAAM,EACb,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,MAAM,CAAC,CAqGjB;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,sBAAsB,GAAE,OAAc,EACtC,mBAAmB,GAAE,OAAc,EACnC,kBAAkB,GAAE,OAAe,EACnC,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,MAAM,CAAC,CA6JjB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC,CA0C3D"}