@kimsungwhee/apple-docs-mcp/dist/utils/preloader.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

/**
 * Framework preloader for performance optimization
 */
import { searchFrameworkSymbols } from '../tools/search-framework-symbols.js';
import { indexCache } from './cache.js';
import { logger } from './logger.js';
import { normalizeFrameworkName, getFrameworksByCategory } from './framework-mapper.js';
/**
 * Popular frameworks to preload (using normalized names)
 */
const POPULAR_FRAMEWORKS = [
    ...getFrameworksByCategory('UI'), // SwiftUI, UIKit, etc.
    ...getFrameworksByCategory('Foundation'), // Foundation, Combine, Swift
    ...getFrameworksByCategory('Data').slice(0, 2), // Core Data, CloudKit
    ...getFrameworksByCategory('Graphics').slice(0, 2), // Core Graphics, Metal
    ...getFrameworksByCategory('Games').slice(0, 3), // ARKit, SceneKit, SpriteKit
].map(f => f.toLowerCase());
/**
 * Preload popular framework indexes
 */
export async function preloadPopularFrameworks() {
    logger.info('Starting framework preload...');
    const preloadPromises = POPULAR_FRAMEWORKS.map(async (framework) => {
        try {
            // Check if already cached
            const cacheKey = `framework-index-${framework}`;
            if (indexCache.has(cacheKey)) {
                logger.debug(`Framework ${framework} already cached, skipping...`);
                return;
            }
            // Load framework index with minimal results
            logger.info(`Preloading framework: ${framework}`);
            await searchFrameworkSymbols(framework, 'all', undefined, 'swift', 1);
            logger.info(`Successfully preloaded: ${framework}`);
        }
        catch (error) {
            logger.error(`Failed to preload ${framework}:`, error);
        }
    });
    await Promise.all(preloadPromises);
    logger.info('Framework preload completed');
}
/**
 * Preload specific frameworks based on user patterns
 */
export async function preloadFrameworksByUsage(recentFrameworks) {
    // Normalize framework names and filter out popular ones
    const frameworksToPreload = recentFrameworks
        .map(f => normalizeFrameworkName(f))
        .filter(f => f && !POPULAR_FRAMEWORKS.includes(f.toLowerCase()))
        .map(f => f.toLowerCase());
    if (frameworksToPreload.length === 0) {
        return;
    }
    logger.info(`Preloading ${frameworksToPreload.length} user-specific frameworks...`);
    const preloadPromises = frameworksToPreload.map(async (framework) => {
        try {
            await searchFrameworkSymbols(framework, 'all', undefined, 'swift', 1);
            logger.info(`Preloaded user framework: ${framework}`);
        }
        catch (error) {
            logger.error(`Failed to preload user framework ${framework}:`, error);
        }
    });
    await Promise.all(preloadPromises);
}
/**
 * Get preload statistics
 */
export function getPreloadStats() {
    const stats = indexCache.getStats();
    const preloadedFrameworks = POPULAR_FRAMEWORKS.filter(framework => {
        const cacheKey = `framework-index-${framework}`;
        return indexCache.has(cacheKey);
    });
    return {
        preloadedFrameworks,
        totalCached: stats.size,
        cacheHitRate: stats.hitRate,
    };
}
//# sourceMappingURL=preloader.js.map