@plyaz/api 1.0.1 → 1.1.0

package/dist/api/debugger/UnifiedDebugger.d.ts

@@ -0,0 +1,444 @@
+/**
+ * UnifiedDebugger - Centralized debugging and conflict tracking system
+ *
+ * This class consolidates all debugging functionality, eliminates duplication,
+ * and provides comprehensive conflict detection throughout the API package.
+ *
+ * IMPORTANT: This works WITH the existing event system, not replacing it!
+ * All existing event factories and handlers continue to work unchanged.
+ *
+ * @module debugger/UnifiedDebugger
+ */
+import type { DebuggerConfigSource, DebugInfo, ConfigConflict, PerformanceImpact, UnifiedOperationType, NetworkInfo, NetworkClientHints, ActiveOverride, HeaderTransformation, TrackingResult, TrackingOptions, NetworkOverrideParams, DebugReport, HeaderStage, TrackableConfig } from '@plyaz/types/api';
+import { NETWORK_QUALITY } from '@plyaz/types/api';
+import { analyzeConfigImpact } from './factories/performance';
+import { analyzeConflictPatterns } from './factories/conflict';
+import { createHistorySummary, analyzeHistoryPatterns } from './factories/history';
+/**
+ * Unified debugger that consolidates ALL debugging functionality
+ * Single source of truth for all tracking, conflict detection, and event emission
+ *
+ * IMPORTANT: NO WRAPPER FUNCTIONS - Use this class directly!
+ * IMPORTANT: Uses existing event factories for emissions
+ */
+export declare class UnifiedDebugger {
+    private static instance;
+    private configTracker;
+    private headerPipeline;
+    private networkOverrides;
+    private history;
+    private conflictHistory;
+    private performanceMetrics;
+    private lastPresetChange?;
+    private lastDebugInfo;
+    private lastNetworkInfo?;
+    private lastNetworkQuality?;
+    private lastClientHints?;
+    private currentRequestId?;
+    private debugFactory?;
+    private networkFactory?;
+    private headerFactory?;
+    private enabled;
+    private performanceMode;
+    private trackAllProperties;
+    private trackingConfig;
+    private maxHistorySize;
+    private maxConflicts;
+    private readonly MAX_HISTORY_SIZE;
+    private readonly HISTORY_CLEANUP_SIZE;
+    private readonly MAX_CONFLICT_HISTORY;
+    /**
+     * Private constructor for singleton pattern
+     */
+    private constructor();
+    /**
+     * Get debug factory (lazy initialization)
+     */
+    private getDebugFactory;
+    /**
+     * Get network factory (lazy initialization)
+     */
+    private getNetworkFactory;
+    /**
+     * Get header factory (lazy initialization)
+     */
+    private getHeaderFactory;
+    /**
+     * Get singleton instance
+     * ALWAYS use this directly - NO WRAPPER FUNCTIONS!
+     */
+    static getInstance(): UnifiedDebugger;
+    /**
+     * Internal method to process an event operation without checking the queue
+     * Made public for use by QueueManager
+     */
+    processEventOperation(operation: UnifiedOperationType, event: string, metadata: Record<string, unknown>): void;
+    /**
+     * Centralized error handling for debugger operations
+     * Uses ApiPackageError instead of silent failures
+     */
+    private handleDebuggerError;
+    /**
+     * Safe tracking helper that handles errors properly
+     * Centralizes the try-catch pattern used throughout the codebase
+     */
+    private safeTrack;
+    /**
+     * Process a single property change
+     */
+    private processPropertyChange;
+    /**
+     * Emit config change events
+     */
+    private emitConfigEvents;
+    /**
+     * Track any configuration change
+     * Combines tracking, conflict detection, and event emission in ONE pass
+     *
+     * @param config - Configuration to track
+     * @param source - Source of the configuration
+     * @param options - Additional tracking options
+     * @returns Tracking result with changes and conflicts
+     */
+    trackConfigChange(config: TrackableConfig, source: DebuggerConfigSource, options?: TrackingOptions): TrackingResult;
+    /**
+     * Track header transformation pipeline
+     * Single method for ALL header tracking
+     *
+     * @param stage - Stage of header transformation
+     * @param headers - Headers being transformed
+     * @param source - Source of the transformation
+     * @param metadata - Additional metadata
+     */
+    trackHeaderTransformation(stage: HeaderStage, headers: Record<string, string>, source: DebuggerConfigSource, metadata?: Record<string, unknown>): void;
+    /**
+     * Track network-based configuration override
+     * Combines network and config tracking
+     *
+     * @param params - Network override parameters
+     */
+    trackNetworkOverride(params: NetworkOverrideParams): void;
+    /**
+     * Generate comprehensive debug report with advanced analysis
+     * This includes compliance, security, performance, and trend analysis
+     */
+    generateComprehensiveReport(): Promise<DebugReport>;
+    /**
+     * Log comprehensive report to console
+     */
+    logComprehensiveReport(): Promise<void>;
+    /**
+     * Get debug report (alias for generateDebugReport for API consistency)
+     */
+    getDebugReport(): DebugReport;
+    /**
+     * Generate basic debug report using factory
+     * For comprehensive report with advanced analysis, use generateComprehensiveReport()
+     */
+    generateDebugReport(): DebugReport;
+    /**
+     * Generate debug info using factory pattern
+     */
+    generateDebugInfo(networkInfo?: NetworkInfo, networkQuality?: NETWORK_QUALITY, clientHints?: NetworkClientHints): DebugInfo;
+    /**
+     * Get current debug info
+     */
+    getDebugInfo(networkInfo?: NetworkInfo, networkQuality?: NETWORK_QUALITY, clientHints?: NetworkClientHints): DebugInfo | null;
+    /**
+     * Update debug info
+     */
+    updateDebugInfo(debugInfo: DebugInfo): void;
+    /**
+     * Set performance mode
+     */
+    setPerformanceMode(mode: 'full' | 'minimal' | 'off'): void;
+    /**
+     * Set tracking configuration from API config
+     */
+    setTrackingConfig(config: {
+        skipHistory?: boolean;
+        historySize?: number;
+        maxConflicts?: number;
+    }): void;
+    /**
+     * Set maximum history size
+     */
+    setHistorySize(size: number): void;
+    /**
+     * Set maximum conflicts to track
+     */
+    setMaxConflicts(max: number): void;
+    /**
+     * Get current tracking configuration
+     */
+    getTrackingConfig(): {
+        enabled: boolean;
+        performanceMode: 'full' | 'minimal' | 'off';
+        historySize: number;
+        maxConflicts: number;
+    };
+    /**
+     * Clear all debug data
+     */
+    clear(): void;
+    /**
+     * Clear header pipeline
+     */
+    clearHeaderPipeline(): void;
+    /**
+     * Start tracking for a new request
+     */
+    startRequest(requestId?: string): string;
+    /**
+     * Get header transformation summary
+     */
+    getHeaderSummary(): {
+        transformations: HeaderTransformation[];
+        summary: Record<string, unknown>;
+    };
+    /**
+     * Get active overrides as array
+     */
+    getActiveOverrides(): ActiveOverride[];
+    /**
+     * Get recent conflicts
+     */
+    getRecentConflicts(limit?: number): ConfigConflict[];
+    /**
+     * Track comprehensive configuration changes
+     * Supports multiple change types including presets, overrides, and restorations
+     */
+    trackChange(options: {
+        changeType: 'override' | 'restore' | 'preset_change' | 'user_preference' | 'auto_optimization';
+        preset?: string;
+        changes: Array<{
+            property: string;
+            previousValue: unknown;
+            newValue: unknown;
+        }>;
+        trigger: string;
+        networkConditions: {
+            quality: NETWORK_QUALITY;
+            info?: NetworkInfo;
+            isDataSaver?: boolean;
+        };
+        timestamp?: number;
+    }): void;
+    /**
+     * Track restoration of a network configuration override
+     */
+    trackRestore(property: string, restoredValue: unknown, options: {
+        networkInfo: NetworkInfo;
+        networkQuality: NETWORK_QUALITY;
+        trigger: string;
+    }): void;
+    /**
+     * Track preset changes
+     */
+    trackPresetChange(presetId: string, changes: Array<{
+        property: string;
+        previousValue: unknown;
+        newValue: unknown;
+        source: DebuggerConfigSource;
+    }>, options: {
+        networkInfo: NetworkInfo;
+        networkQuality: NETWORK_QUALITY;
+        trigger: string;
+    }): void;
+    /**
+     * Run performance benchmark for API operations
+     */
+    runPerformanceBenchmark(name: string, operation: () => Promise<void>, iterations?: number): Promise<{
+        name: string;
+        opsPerSecond: number;
+        avgDuration: number;
+        memoryPerOp?: number;
+        rating: 'excellent' | 'good' | 'fair' | 'poor';
+    }>;
+    /**
+     * Analyze performance impact of current configuration
+     * Now uses factory function for consistent calculation
+     */
+    analyzePerformanceImpact(networkInfo: NetworkInfo, networkQuality: NETWORK_QUALITY): PerformanceImpact;
+    /**
+  
+    /**
+     * Get performance metrics
+     */
+    getPerformanceMetrics(networkInfo?: NetworkInfo, networkQuality?: NETWORK_QUALITY): PerformanceImpact;
+    /**
+     * Log network configuration report
+     * Stores network context and triggers comprehensive report
+     */
+    logNetworkConfigReport(networkInfo: NetworkInfo, networkQuality: NETWORK_QUALITY, clientHints?: NetworkClientHints): Promise<void>;
+    /**
+     * Get comprehensive preset change report
+     */
+    getPresetChangeReport(): string | null;
+    /**
+     * Analyze performance impact of preset changes
+     */
+    private analyzePresetImpact;
+    /**
+     * Get enhanced network statistics
+     */
+    getNetworkStats(): {
+        totalOverrides: number;
+        activeOverrides: number;
+        totalChanges: number;
+        networkEvents: number;
+        historySize: number;
+        mostOverriddenProperty: string | null;
+        averageOverrideDuration: number;
+    };
+    /**
+     * Get human-readable precedence explanation
+     */
+    private getPrecedenceReason;
+    /**
+     * Compare precedence between two sources
+     */
+    private comparePrecedence;
+    /**
+     * Detect header conflicts between transformations
+     */
+    private detectHeaderConflicts;
+    /**
+     * Detect changes between header sets
+     */
+    private detectHeaderChanges;
+    /**
+     * Calculate performance impact of network override
+     */
+    private calculatePerformanceImpact;
+    /**
+     * Add entry to history with auto-cleanup using factory
+     */
+    private addToHistory;
+    /**
+     * Analyze performance metrics
+     * Uses createPerformanceAnalysis factory
+     */
+    /**
+     * Log conflicts to console (alias for backward compatibility)
+     */
+    logConflicts(): Promise<void>;
+    /**
+     * Log debug information to console
+     * Always uses comprehensive report from ComprehensiveDebugReport module
+     */
+    logToConsole(): Promise<void>;
+    /**
+     * Enable or disable debugging
+     */
+    setEnabled(enabled?: boolean): void;
+    /**
+     * Get current enabled state
+     */
+    getEnabled(): boolean;
+    /**
+     * Configure property tracking mode
+     * @param trackAll - If true, tracks all properties. If false, only tracks TRACKED_PROPERTIES
+     */
+    setPropertyTrackingMode(trackAll: boolean): void;
+    /**
+     * Enable network config debugging
+     */
+    enableNetworkDebug(): void;
+    /**
+     * Disable network config debugging
+     */
+    disableNetworkDebug(): void;
+    /**
+     * Clear network debug data
+     */
+    clearNetworkData(): void;
+    /**
+     * Track network configuration override (comprehensive)
+     */
+    trackNetworkConfigOverride(config: {
+        property: string;
+        originalValue: unknown;
+        overrideValue: unknown;
+        reason: string;
+        source?: DebuggerConfigSource;
+        networkInfo?: NetworkInfo;
+        networkQuality?: NETWORK_QUALITY;
+        trigger?: string;
+        temporary?: boolean;
+        duration?: number;
+    }): void;
+    /**
+     * Track configuration with conflict detection
+     * Alias for backward compatibility
+     */
+    track(config: TrackableConfig, source: DebuggerConfigSource): void;
+    /**
+     * Track event emitter operations for comprehensive event system monitoring
+     */
+    trackEventOperation(operation: UnifiedOperationType, event: string, metadata?: {
+        source?: 'pubsub' | 'eventManager' | 'clientEventManager' | 'factory' | 'config';
+        module?: string;
+        listenerCount?: number;
+        totalEvents?: number;
+        totalListeners?: number;
+        eventPattern?: {
+            isWildcard: boolean;
+            namespace: string | null;
+            scope: string | null;
+        };
+        operationMetadata?: Record<string, unknown>;
+        performance?: {
+            operationDuration?: number;
+            memoryUsage?: number;
+        };
+    }): void;
+    /**
+     * Get all conflicts
+     * Uses mergeConflicts factory to properly merge and deduplicate conflicts
+     */
+    getConflicts(): ConfigConflict[];
+    /**
+     * Analyze conflict patterns
+     * Uses analyzeConflictPatterns factory for detailed analysis
+     */
+    analyzeConflicts(): ReturnType<typeof analyzeConflictPatterns>;
+    /**
+     * Analyze configuration impact on performance
+     * Uses analyzeConfigImpact factory
+     */
+    analyzeConfigurationImpact(): ReturnType<typeof analyzeConfigImpact>;
+    /**
+     * Get current network context
+     * Returns the last stored network information for use in reports
+     */
+    getCurrentNetworkContext(): {
+        networkInfo?: NetworkInfo;
+        networkQuality?: NETWORK_QUALITY;
+        clientHints?: NetworkClientHints;
+    };
+    /**
+     * Get network context (alias for getCurrentNetworkContext)
+     */
+    getNetworkContext(): {
+        networkInfo?: NetworkInfo;
+        networkQuality?: NETWORK_QUALITY;
+        clientHints?: NetworkClientHints;
+    };
+    /**
+     * Enable/disable warnings
+     */
+    setWarnings(enabled: boolean): void;
+    /**
+     * Get history summary
+     * Uses createHistorySummary factory
+     */
+    getHistorySummary(): ReturnType<typeof createHistorySummary>;
+    /**
+     * Analyze history patterns
+     * Uses analyzeHistoryPatterns factory
+     */
+    analyzeHistory(): ReturnType<typeof analyzeHistoryPatterns>;
+}
+export declare const getUnifiedDebugger: () => UnifiedDebugger;
+//# sourceMappingURL=UnifiedDebugger.d.ts.map

package/dist/api/debugger/UnifiedDebugger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnifiedDebugger.d.ts","sourceRoot":"","sources":["../../../src/api/debugger/UnifiedDebugger.ts"],"names":[],"mappings":"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"}

package/dist/api/debugger/factories/conflict.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Conflict Detection Factory
+ *
+ * Factory functions for detecting and analyzing configuration conflicts
+ */
+import type { ConfigConflict, DebuggerConfigSource, TrackedValue } from '@plyaz/types/api';
+/**
+ * Detect conflicts between configuration values
+ */
+export declare function detectConflicts(params: {
+    existingConfigs: Map<string, TrackedValue>;
+    newConfig: Record<string, unknown>;
+    source: DebuggerConfigSource;
+}): ConfigConflict[];
+/**
+ * Create a configuration conflict
+ */
+export declare function createConflict(params: {
+    property: string;
+    previousValue: unknown;
+    newValue: unknown;
+    previousSource: string;
+    newSource: string;
+    timestamp?: number;
+    resolution?: string;
+    reason?: string;
+}): ConfigConflict;
+/**
+ * Determine the reason for precedence between sources
+ */
+export declare function determinePrecedenceReason(previousSource: string, newSource: string): string;
+/**
+ * Resolve which source wins in a conflict
+ */
+export declare function resolveConflict(previousSource: string, newSource: string): string;
+/**
+ * Analyze conflict patterns
+ */
+export declare function analyzeConflictPatterns(conflicts: ConfigConflict[]): {
+    mostConflictedProperties: Array<{
+        property: string;
+        count: number;
+    }>;
+    conflictingSources: Array<{
+        source: string;
+        count: number;
+    }>;
+    resolutionPatterns: Array<{
+        pattern: string;
+        count: number;
+    }>;
+    recommendations: string[];
+};
+/**
+ * Merge conflicts and remove duplicates
+ */
+export declare function mergeConflicts(existing: ConfigConflict[], newConflicts: ConfigConflict[]): ConfigConflict[];
+//# sourceMappingURL=conflict.d.ts.map

package/dist/api/debugger/factories/conflict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflict.d.ts","sourceRoot":"","sources":["../../../../src/api/debugger/factories/conflict.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAQ3F;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE;IACtC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC3C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,EAAE,oBAAoB,CAAC;CAC9B,GAAG,cAAc,EAAE,CAsBnB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,cAAc,CAyBjB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAsC3F;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CA2CjF;AAoED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG;IACpE,wBAAwB,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrE,kBAAkB,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7D,kBAAkB,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9D,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B,CA2BA;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,cAAc,EAAE,EAC1B,YAAY,EAAE,cAAc,EAAE,GAC7B,cAAc,EAAE,CAkBlB"}

package/dist/api/debugger/factories/eventTracking.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Event Tracking Factory
+ *
+ * Factory functions for tracking event emitter operations throughout the API system.
+ * Provides comprehensive tracking for pubsub operations, event manager changes,
+ * and config override impacts on the event system.
+ */
+import type { UnifiedDebugger } from '../UnifiedDebugger';
+import type { EventTrackingMetadata, EventOperation, EventTrackingSummary, HeaderEventAnalysis, NetworkEventAnalysis, ConfigEventAnalysis, FactoryEventAnalysis, PubSubEventAnalysis, DEBUGGER_CONFIG_SOURCES } from '@plyaz/types/api';
+/**
+ * Create event tracking metadata for pubsub operations
+ * Uses namespace constants for consistent event naming
+ */
+export declare function createPubSubEventTracking(operation: EventOperation, event: string, metadata?: Partial<EventTrackingMetadata['operationMetadata']>): EventTrackingMetadata;
+/**
+ * Create event tracking metadata for event manager operations
+ */
+export declare function createEventManagerTracking(operation: EventOperation, module: string, metadata?: Partial<EventTrackingMetadata['operationMetadata']>): EventTrackingMetadata;
+/**
+ * Create event tracking metadata for client event manager operations
+ */
+export declare function createClientEventManagerTracking(operation: EventOperation, strategy: string, metadata?: Partial<EventTrackingMetadata['operationMetadata']>): EventTrackingMetadata;
+/**
+ * Create event tracking metadata for config updates
+ */
+export declare function createConfigUpdateTracking(operation: EventOperation, configSource: (typeof DEBUGGER_CONFIG_SOURCES)[keyof typeof DEBUGGER_CONFIG_SOURCES], impactedEvents: string[], metadata?: Partial<EventTrackingMetadata['operationMetadata']>): EventTrackingMetadata;
+/**
+ * Create event tracking metadata for factory lifecycle operations
+ */
+export declare function createFactoryLifecycleTracking(operation: EventOperation, factoryType: string, metadata?: Partial<EventTrackingMetadata['operationMetadata']>): EventTrackingMetadata;
+/**
+ * Event tracking functions that can be used by the UnifiedDebugger
+ */
+export declare class EventTrackingFactory {
+    private debugerInstance;
+    private trackingData;
+    constructor(debugerInstance: UnifiedDebugger);
+    /**
+     * Track an event operation
+     */
+    trackEventOperation(metadata: EventTrackingMetadata): void;
+    /**
+     * Track pubsub operation
+     */
+    trackPubSubOperation(operation: EventOperation, event: string, metadata?: Partial<EventTrackingMetadata['operationMetadata']>): void;
+    /**
+     * Track event manager operation
+     */
+    trackEventManagerOperation(operation: EventOperation, module: string, metadata?: Partial<EventTrackingMetadata['operationMetadata']>): void;
+    /**
+     * Track client event manager operation
+     */
+    trackClientEventManagerOperation(operation: EventOperation, strategy: string, metadata?: Partial<EventTrackingMetadata['operationMetadata']>): void;
+    /**
+     * Track config update impact on events
+     */
+    trackConfigUpdateImpact(operation: EventOperation, configSource: (typeof DEBUGGER_CONFIG_SOURCES)[keyof typeof DEBUGGER_CONFIG_SOURCES], impactedEvents: string[], metadata?: Partial<EventTrackingMetadata['operationMetadata']>): void;
+    /**
+     * Track factory lifecycle
+     */
+    trackFactoryLifecycle(operation: EventOperation, factoryType: string, metadata?: Partial<EventTrackingMetadata['operationMetadata']>): void;
+    /**
+     * Get event tracking summary
+     */
+    getEventTrackingSummary(): EventTrackingSummary;
+    /**
+     * Clear tracking data
+     */
+    clearTrackingData(): void;
+    /**
+     * Get raw tracking data
+     */
+    getTrackingData(): EventTrackingMetadata[];
+    /**
+     * Analyze Header Events
+     * Provides insights into header-related events and patterns
+     */
+    analyzeHeaderEvents(): HeaderEventAnalysis;
+    /**
+     * Analyze Network Events
+     * Provides insights into network-related events and quality changes
+     */
+    analyzeNetworkEvents(): NetworkEventAnalysis;
+    /**
+     * Analyze Config Events
+     * Provides insights into configuration changes and conflicts
+     */
+    analyzeConfigEvents(): ConfigEventAnalysis;
+    /**
+     * Analyze Factory Events
+     * Provides insights into factory lifecycle and registration patterns
+     */
+    analyzeFactoryEvents(): FactoryEventAnalysis;
+    /**
+     * Analyze PubSub Events
+     * Provides insights into event emitter operations and listener patterns
+     */
+    analyzePubSubEvents(): PubSubEventAnalysis;
+    /**
+     * Analyze all available events from tracked data
+     * Returns real event data instead of hardcoded mocks
+     */
+    analyzeAvailableEvents(): Array<{
+        sourceType: 'createApiClient' | 'config' | 'updateConfig' | 'factory' | 'pubsub' | 'manual' | 'eventManager' | 'clientEventManager';
+        events: Array<{
+            name: string;
+            category: string;
+            scope: string;
+            initialized: boolean;
+            usage: 'active' | 'passive' | 'never-used';
+            lastEmitted?: number;
+            emitCount?: number;
+        }>;
+        initializationSource: string;
+        recommendedEvents: string[];
+    }>;
+    /**
+     * Helper to get category from event name
+     */
+    private getCategoryFromEvent;
+    /**
+     * Get recommended events based on scope
+     */
+    private getRecommendedEvents;
+}
+//# sourceMappingURL=eventTracking.d.ts.map

package/dist/api/debugger/factories/eventTracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventTracking.d.ts","sourceRoot":"","sources":["../../../../src/api/debugger/factories/eventTracking.ts"],"names":[],"mappings":"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"}