traceperf 0.1.1 → 0.1.4

package/dist/esm/trackers/execution.js

@@ -17,6 +17,10 @@ export class ExecutionTracker {
         this._callStack = new CallStackManager();
         this._asciiGenerator = new AsciiArtGenerator({ boxWidth: options.boxWidth });
         this._defaultThreshold = (_a = options.defaultThreshold) !== null && _a !== void 0 ? _a : 100; // ms
+        // Get a reference to the global scope (works in both Node.js and browsers)
+        this._globalScope = typeof window !== 'undefined' ? window :
+            typeof global !== 'undefined' ? global :
+                {};
     }
     /**
      * Track the execution of a function
@@ -26,10 +30,11 @@ export class ExecutionTracker {
      * @returns The return value of the tracked function
      */
     track(fn, options) {
-        var _a, _b;
+        var _a, _b, _c;
         const fnName = (options === null || options === void 0 ? void 0 : options.label) || getFunctionName(fn);
         const threshold = (_a = options === null || options === void 0 ? void 0 : options.threshold) !== null && _a !== void 0 ? _a : this._defaultThreshold;
         const includeMemory = (_b = options === null || options === void 0 ? void 0 : options.includeMemory) !== null && _b !== void 0 ? _b : true;
+        const enableNestedTracking = (_c = options === null || options === void 0 ? void 0 : options.enableNestedTracking) !== null && _c !== void 0 ? _c : true;
         // Get memory usage before execution
         const startMemory = includeMemory ? process.memoryUsage().heapUsed : undefined;
         // Start timing
@@ -46,7 +51,7 @@ export class ExecutionTracker {
             children: [],
         };
         // Set parent-child relationship
-        if (this._currentExecution) {
+        if (this._currentExecution && enableNestedTracking) {
             execution.parent = this._currentExecution;
             this._currentExecution.children.push(execution);
         }
@@ -80,6 +85,26 @@ export class ExecutionTracker {
             this._callStack.pop();
         }
     }
+    /**
+     * Create a trackable version of a function
+     *
+     * This is a helper method to create a tracked version of a function
+     * that can be used for nested function tracking.
+     *
+     * @param fn - The function to make trackable
+     * @param options - Options for tracking
+     * @returns A tracked version of the function
+     */
+    createTrackable(fn, options) {
+        const self = this;
+        const fnName = (options === null || options === void 0 ? void 0 : options.label) || fn.name || 'anonymous';
+        return function (...args) {
+            return self.track(() => fn.apply(this, args), {
+                ...options,
+                label: fnName
+            });
+        };
+    }
     /**
      * Get the current call stack
      *
@@ -95,9 +120,52 @@ export class ExecutionTracker {
      */
     generateFlowChart() {
         // Convert execution records to execution data for the ASCII generator
-        const flatExecutions = this.flattenExecutions(this._executions);
+        const executionData = this.prepareExecutionData(this._executions);
         // Generate the flow chart
-        return this._asciiGenerator.generateFlowChart(flatExecutions);
+        return this._asciiGenerator.generateFlowChart(executionData);
+    }
+    /**
+     * Prepare execution data for the ASCII generator
+     *
+     * @param executions - The execution records to prepare
+     * @returns A list of execution data
+     */
+    prepareExecutionData(executions) {
+        const result = [];
+        // Process each root execution
+        executions.forEach(execution => {
+            // Add the root execution
+            result.push({
+                name: execution.name,
+                duration: execution.duration,
+                isSlow: execution.isSlow,
+                memoryUsage: execution.memoryUsage,
+                level: execution.level,
+            });
+            // Add children recursively
+            this.addChildrenToResult(execution.children, result);
+        });
+        return result;
+    }
+    /**
+     * Add children to the result list
+     *
+     * @param children - The children to add
+     * @param result - The result list
+     */
+    addChildrenToResult(children, result) {
+        children.forEach(child => {
+            // Add the child
+            result.push({
+                name: child.name,
+                duration: child.duration,
+                isSlow: child.isSlow,
+                memoryUsage: child.memoryUsage,
+                level: child.level,
+            });
+            // Add grandchildren recursively
+            this.addChildrenToResult(child.children, result);
+        });
     }
     /**
      * Clear all execution records
@@ -115,29 +183,5 @@ export class ExecutionTracker {
     getExecutions() {
         return [...this._executions];
     }
-    /**
-     * Flatten the execution tree into a list
-     *
-     * @param executions - The execution records to flatten
-     * @returns A flat list of execution data
-     */
-    flattenExecutions(executions) {
-        const result = [];
-        // Helper function to recursively flatten the tree
-        const flatten = (record) => {
-            result.push({
-                name: record.name,
-                duration: record.duration,
-                isSlow: record.isSlow,
-                memoryUsage: record.memoryUsage,
-                level: record.level,
-            });
-            // Process children
-            record.children.forEach(child => flatten(child));
-        };
-        // Flatten each root execution
-        executions.forEach(execution => flatten(execution));
-        return result;
-    }
 }
 //# sourceMappingURL=execution.js.map

package/dist/esm/trackers/execution.js.map

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

package/dist/esm/types/config.d.ts

@@ -62,41 +62,59 @@ export interface ITrackOptions {
      * Whether to suppress logging for this tracking
      */
     silent?: boolean;
+    /**
+     * Whether to enable nested tracking
+     *
+     * When enabled, TracePerf will track nested function calls
+     * if they are also wrapped with track().
+     *
+     * @default true
+     */
+    enableNestedTracking?: boolean;
 }
 /**
- * LoggerConfig - Configuration options for the logger
+ * Logger configuration
  */
 export interface ILoggerConfig {
     /**
      * Operational mode
-     * @default 'dev'
+     *
+     * - dev: All logs are shown
+     * - staging: Only warn and error logs are shown
+     * - prod: Only error logs are shown
      */
-    mode?: LogMode;
+    mode: LogMode;
     /**
-     * Minimum log level to display
-     * @default 'debug'
+     * Minimum log level to show
      */
-    level?: LogLevel;
+    level: LogLevel;
     /**
-     * Whether to colorize output
-     * @default true
+     * Whether to colorize logs
      */
-    colorize?: boolean;
+    colorize: boolean;
     /**
      * Whether to include timestamps in logs
-     * @default true
      */
-    timestamp?: boolean;
+    timestamp: boolean;
+    /**
+     * Performance threshold in milliseconds
+     *
+     * Functions that take longer than this threshold will be marked as bottlenecks
+     */
+    performanceThreshold: number;
     /**
-     * Default performance threshold in milliseconds
-     * @default 100
+     * Indentation size for nested logs
      */
-    performanceThreshold?: number;
+    indentSize: number;
     /**
-     * Number of spaces for each indentation level
-     * @default 2
+     * Whether to automatically track nested function calls
+     *
+     * When enabled, TracePerf will automatically track nested function calls
+     * using a proxy-based approach.
+     *
+     * @default true
      */
-    indentSize?: number;
+    autoTracking?: boolean;
     /**
      * Log output destinations
      * @default [ConsoleTransport]

package/dist/esm/types/index.d.ts

@@ -1,2 +1,84 @@
 export * from './config';
 export * from './logger';
+/**
+ * Options for tracking function execution
+ */
+export interface ITrackOptions {
+    /**
+     * Custom label for the function
+     */
+    label?: string;
+    /**
+     * Performance threshold in milliseconds
+     */
+    threshold?: number;
+    /**
+     * Whether to include memory usage in the tracking
+     */
+    includeMemory?: boolean;
+    /**
+     * Whether to track nested function calls
+     *
+     * Note: With automatic tracking enabled, TracePerf will attempt to
+     * automatically detect and track nested function calls without requiring
+     * manual tracking of each function.
+     *
+     * @default true
+     */
+    enableNestedTracking?: boolean;
+    /**
+     * Whether to automatically track nested function calls
+     *
+     * When enabled, TracePerf will analyze the function source code to identify
+     * potential function calls and automatically track them.
+     *
+     * @default true
+     */
+    autoTracking?: boolean;
+    /**
+     * Whether to suppress logging
+     */
+    silent?: boolean;
+}
+/**
+ * Interface for execution trackers
+ */
+export interface IExecutionTracker {
+    /**
+     * Track the execution of a function
+     *
+     * @param fn - The function to track
+     * @param options - Options for tracking
+     * @returns The return value of the tracked function
+     */
+    track<T>(fn: () => T, options?: ITrackOptions): T;
+    /**
+     * Create a trackable version of a function
+     *
+     * This is a helper method to create a tracked version of a function
+     * that can be used for nested function tracking.
+     *
+     * @param fn - The function to make trackable
+     * @param options - Options for tracking
+     * @returns A tracked version of the function
+     */
+    createTrackable<T extends (...args: any[]) => any>(fn: T, options?: Omit<ITrackOptions, 'label'> & {
+        label?: string;
+    }): (...args: Parameters<T>) => ReturnType<T>;
+    /**
+     * Get the current call stack
+     *
+     * @returns The current call stack
+     */
+    getCallStack(): string[];
+    /**
+     * Generate a visual representation of the execution flow
+     *
+     * @returns ASCII flow chart of the execution
+     */
+    generateFlowChart(): string;
+    /**
+     * Clear all execution records
+     */
+    clear(): void;
+}

package/dist/esm/types/logger.d.ts

@@ -61,6 +61,17 @@ export interface ILogger {
      * @returns The return value of the tracked function
      */
     track<T>(fn: () => T, options?: ITrackOptions): T;
+    /**
+     * Create a trackable version of a function
+     *
+     * This is a helper method to create a tracked version of a function
+     * that can be used for nested function tracking.
+     *
+     * @param fn - The function to make trackable
+     * @param options - Options for tracking
+     * @returns A tracked version of the function
+     */
+    createTrackable<T extends (...args: any[]) => any>(fn: T, options?: any): (...args: Parameters<T>) => ReturnType<T>;
 }
 /**
  * IExecutionTracker - Interface for tracking function execution

package/dist/esm/utils/proxy-tracker.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Proxy-based function tracking utility
+ *
+ * This module provides utilities for automatically tracking nested function calls
+ * using JavaScript Proxies without modifying the original code structure.
+ */
+import { ITrackOptions } from '../types';
+/**
+ * Interface for a function that can track other functions
+ */
+export interface ITrackFunction {
+    <T>(fn: () => T, options?: ITrackOptions): T;
+}
+/**
+ * A tracking context that manages function tracking using proxies
+ */
+export declare class ProxyTracker {
+    private _trackFn;
+    private _originalFunctions;
+    private _trackedFunctions;
+    private _isEnabled;
+    /**
+     * Create a new ProxyTracker
+     *
+     * @param trackFn - The function to use for tracking
+     */
+    constructor(trackFn: ITrackFunction);
+    /**
+     * Enable or disable tracking
+     *
+     * @param enabled - Whether tracking is enabled
+     */
+    setEnabled(enabled: boolean): void;
+    /**
+     * Check if tracking is enabled
+     *
+     * @returns Whether tracking is enabled
+     */
+    isEnabled(): boolean;
+    /**
+     * Make a function trackable
+     *
+     * @param fn - The function to make trackable
+     * @param name - The name to use for tracking
+     * @returns A tracked version of the function
+     */
+    makeTrackable(fn: Function, name?: string): Function;
+    /**
+     * Create a proxy for an object to track all its methods
+     *
+     * @param obj - The object to proxy
+     * @param namespace - The namespace to use for tracking
+     * @returns A proxied version of the object
+     */
+    createProxy<T extends object>(obj: T, namespace?: string): T;
+    /**
+     * Track a module's exports
+     *
+     * @param moduleExports - The module's exports
+     * @param namespace - The namespace to use for tracking
+     * @returns A proxied version of the module's exports
+     */
+    trackModule<T extends object>(moduleExports: T, namespace: string): T;
+    /**
+     * Clear all tracked functions
+     */
+    clear(): void;
+}

package/dist/esm/utils/proxy-tracker.js

@@ -0,0 +1,127 @@
+/**
+ * Proxy-based function tracking utility
+ *
+ * This module provides utilities for automatically tracking nested function calls
+ * using JavaScript Proxies without modifying the original code structure.
+ */
+/**
+ * A tracking context that manages function tracking using proxies
+ */
+export class ProxyTracker {
+    /**
+     * Create a new ProxyTracker
+     *
+     * @param trackFn - The function to use for tracking
+     */
+    constructor(trackFn) {
+        this._originalFunctions = new Map();
+        this._trackedFunctions = new Map();
+        this._isEnabled = true;
+        this._trackFn = trackFn;
+    }
+    /**
+     * Enable or disable tracking
+     *
+     * @param enabled - Whether tracking is enabled
+     */
+    setEnabled(enabled) {
+        this._isEnabled = enabled;
+    }
+    /**
+     * Check if tracking is enabled
+     *
+     * @returns Whether tracking is enabled
+     */
+    isEnabled() {
+        return this._isEnabled;
+    }
+    /**
+     * Make a function trackable
+     *
+     * @param fn - The function to make trackable
+     * @param name - The name to use for tracking
+     * @returns A tracked version of the function
+     */
+    makeTrackable(fn, name) {
+        // If tracking is disabled, return the original function
+        if (!this._isEnabled) {
+            return fn;
+        }
+        // If we've already tracked this function, return the tracked version
+        if (this._trackedFunctions.has(fn)) {
+            return this._trackedFunctions.get(fn);
+        }
+        // Create a tracked version of the function
+        const self = this;
+        const trackedFn = function (...args) {
+            return self._trackFn(() => fn.apply(this, args), {
+                label: name || fn.name || 'anonymous'
+            });
+        };
+        // Store the tracked version
+        this._trackedFunctions.set(fn, trackedFn);
+        return trackedFn;
+    }
+    /**
+     * Create a proxy for an object to track all its methods
+     *
+     * @param obj - The object to proxy
+     * @param namespace - The namespace to use for tracking
+     * @returns A proxied version of the object
+     */
+    createProxy(obj, namespace = '') {
+        // If tracking is disabled, return the original object
+        if (!this._isEnabled) {
+            return obj;
+        }
+        const self = this;
+        return new Proxy(obj, {
+            get(target, prop, receiver) {
+                const value = Reflect.get(target, prop, receiver);
+                // If the property is a function, make it trackable
+                if (typeof value === 'function' && prop !== 'constructor') {
+                    const name = namespace
+                        ? `${namespace}.${String(prop)}`
+                        : String(prop);
+                    return self.makeTrackable(value, name);
+                }
+                // If the property is an object (but not a built-in), proxy it too
+                if (value &&
+                    typeof value === 'object' &&
+                    !Array.isArray(value) &&
+                    Object.getPrototypeOf(value) === Object.prototype) {
+                    const nestedNamespace = namespace
+                        ? `${namespace}.${String(prop)}`
+                        : String(prop);
+                    return self.createProxy(value, nestedNamespace);
+                }
+                return value;
+            },
+            apply(target, thisArg, args) {
+                // This handles the case when the proxy itself is called as a function
+                const name = namespace || target.name || 'anonymous';
+                return self._trackFn(() => Reflect.apply(target, thisArg, args), {
+                    label: name
+                });
+            }
+        });
+    }
+    /**
+     * Track a module's exports
+     *
+     * @param moduleExports - The module's exports
+     * @param namespace - The namespace to use for tracking
+     * @returns A proxied version of the module's exports
+     */
+    trackModule(moduleExports, namespace) {
+        return this.createProxy(moduleExports, namespace);
+    }
+    /**
+     * Clear all tracked functions
+     */
+    clear() {
+        this._trackedFunctions.clear();
+        this._originalFunctions.clear();
+    }
+}
+//# sourceMappingURL=proxy-tracker.js.map

package/dist/esm/utils/proxy-tracker.js.map

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

package/dist/trackers/execution.d.ts

@@ -22,6 +22,7 @@ export declare class ExecutionTracker implements IExecutionTracker {
     private _currentExecution;
     private _asciiGenerator;
     private _defaultThreshold;
+    private _globalScope;
     /**
      * Create a new ExecutionTracker instance
      *
@@ -39,6 +40,19 @@ export declare class ExecutionTracker implements IExecutionTracker {
      * @returns The return value of the tracked function
      */
     track<T>(fn: () => T, options?: ITrackOptions): T;
+    /**
+     * Create a trackable version of a function
+     *
+     * This is a helper method to create a tracked version of a function
+     * that can be used for nested function tracking.
+     *
+     * @param fn - The function to make trackable
+     * @param options - Options for tracking
+     * @returns A tracked version of the function
+     */
+    createTrackable<T extends (...args: any[]) => any>(fn: T, options?: Omit<ITrackOptions, 'label'> & {
+        label?: string;
+    }): (...args: Parameters<T>) => ReturnType<T>;
     /**
      * Get the current call stack
      *
@@ -51,6 +65,20 @@ export declare class ExecutionTracker implements IExecutionTracker {
      * @returns ASCII flow chart of the execution
      */
     generateFlowChart(): string;
+    /**
+     * Prepare execution data for the ASCII generator
+     *
+     * @param executions - The execution records to prepare
+     * @returns A list of execution data
+     */
+    private prepareExecutionData;
+    /**
+     * Add children to the result list
+     *
+     * @param children - The children to add
+     * @param result - The result list
+     */
+    private addChildrenToResult;
     /**
      * Clear all execution records
      */
@@ -61,12 +89,5 @@ export declare class ExecutionTracker implements IExecutionTracker {
      * @returns All execution records
      */
     getExecutions(): ExecutionRecord[];
-    /**
-     * Flatten the execution tree into a list
-     *
-     * @param executions - The execution records to flatten
-     * @returns A flat list of execution data
-     */
-    private flattenExecutions;
 }
 export {};