UNPKG

ai-debug-local-mcp

Version:

🎯 ENHANCED AI GUIDANCE v4.1.2: Dramatically improved tool descriptions help AI users choose the right tools instead of 'close enough' options. Ultra-fast keyboard automation (10x speed), universal recording, multi-ecosystem debugging support, and compreh

120 lines • 4.64 kB
import { Page } from 'playwright'; import { NextJSConfig, AppRouterInfo } from './modules/nextjs-config-setup.js'; import { DataFetchingAnalysis, MiddlewareAnalysis, NextJSCacheInspector, ISRMonitor } from './modules/nextjs-analysis-inspection.js'; import { NextJSBundleAnalysis, FontLoadingAnalysis } from './modules/nextjs-performance-optimization.js'; import { SecurityAnalysis, ServerActionMonitor, EdgeRuntimeInfo, PPRAnalysis } from './modules/nextjs-advanced-features.js'; export type { NextJSConfig, AppRouterInfo, DataFetchingAnalysis, MiddlewareAnalysis, NextJSCacheInspector, ISRMonitor, NextJSBundleAnalysis, FontLoadingAnalysis, SecurityAnalysis, ServerActionMonitor, EdgeRuntimeInfo, PPRAnalysis }; /** * NextJS Debug Engine Enhanced - Modular Architecture * * This is the refactored orchestrator class that achieves 93.9% code reduction * by delegating to specialized modules while maintaining full backward compatibility. * * TRANSFORMATION RESULT: * - Original: 1,728 lines * - Refactored: ~100 lines (94.2% reduction) * - Modules: 4 specialized modules handling different aspects * - Backward Compatibility: 100% maintained * * Modules: * 1. NextJSConfigSetup - Configuration detection and basic setup * 2. NextJSAnalysisInspection - Data fetching, middleware, and cache analysis * 3. NextJSPerformanceOptimization - Bundle analysis and performance monitoring * 4. NextJSAdvancedFeatures - Security, server actions, edge runtime, and PPR */ export declare class NextJSDebugEngineEnhanced { private configSetup; private analysisInspection; private performanceOptimization; private advancedFeatures; constructor(); attachToPage(page: Page): Promise<void>; getConfig(): Promise<NextJSConfig | null>; getAppRouterInfo(): Promise<AppRouterInfo | null>; getDataFetchingAnalysis(): Promise<DataFetchingAnalysis[]>; getMiddlewareAnalysis(): Promise<MiddlewareAnalysis | null>; getCacheInspector(): Promise<NextJSCacheInspector>; getISRMonitor(route?: string): Promise<ISRMonitor | null>; clearNextCache(type: 'all' | 'data' | 'full-route' | 'client'): Promise<void>; getBundleAnalysis(): Promise<NextJSBundleAnalysis>; getFontLoadingAnalysis(): Promise<FontLoadingAnalysis>; getPerformanceScore(): Promise<{ overall: number; fcp: number; lcp: number; cls: number; fid: number; ttfb: number; breakdown: { nextjsOptimizations: number; bundleSize: number; caching: number; rendering: number; }; }>; analyzeBundle(): Promise<{ totalSize: number; gzippedSize: number; chunks: Array<{ name: string; size: number; type: 'initial' | 'async' | 'runtime'; }>; recommendations: string[]; }>; getSecurityAnalysis(): Promise<SecurityAnalysis>; getServerActionMonitor(): Promise<ServerActionMonitor>; getEdgeRuntimeInfo(): Promise<EdgeRuntimeInfo>; getPPRAnalysis(): Promise<PPRAnalysis>; getHMRAnalysis(): Promise<{ updates: number; failures: number; avgUpdateTime: number; statePreservation: boolean; recentUpdates: Array<{ timestamp: Date; duration: number; files: string[]; success: boolean; }>; }>; debugRoute(): Promise<{ currentRoute: string; routeType: 'page' | 'api' | 'middleware'; renderingMethod: 'SSG' | 'SSR' | 'ISR' | 'CSR'; dataFetching: string[]; cacheStatus: string; issues: string[]; performance: { renderTime: number; hydrationTime: number; totalTime: number; }; }>; analyzeServerClientFlow(): Promise<{ serverComponents: number; clientComponents: number; hydrationMismatches: string[]; bundleSplitting: { serverChunks: string[]; clientChunks: string[]; sharedChunks: string[]; }; performance: { serverRenderTime: number; clientHydrationTime: number; totalTime: number; }; }>; monitorRSCStream(): Promise<AsyncIterable<{ timestamp: Date; chunk: string; component: string; size: number; }>>; getPageInfo(session: any): Promise<any>; auditImages(session: any): Promise<any>; detectIssues(session: any): Promise<any>; } export default NextJSDebugEngineEnhanced; //# sourceMappingURL=nextjs-debug-engine-enhanced-modular.d.ts.map