traceperf 0.1.2 → 0.1.4

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,8 +22,7 @@ export declare class ExecutionTracker implements IExecutionTracker {
     private _currentExecution;
     private _asciiGenerator;
     private _defaultThreshold;
-    private _instrumentedFunctions;
-    private _isInstrumented;
+    private _globalScope;
     /**
      * Create a new ExecutionTracker instance
      *
@@ -42,12 +41,18 @@ export declare class ExecutionTracker implements IExecutionTracker {
      */
     track<T>(fn: () => T, options?: ITrackOptions): T;
     /**
-     * Instrument a function to track nested function calls
+     * Create a trackable version of a function
      *
-     * @param fn - The function to instrument
-     * @returns The instrumented 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
      */
-    private instrumentFunction;
+    createTrackable<T extends (...args: any[]) => any>(fn: T, options?: Omit<ITrackOptions, 'label'> & {
+        label?: string;
+    }): (...args: Parameters<T>) => ReturnType<T>;
     /**
      * Get the current call stack
      *

package/dist/trackers/execution.js

@@ -17,11 +17,13 @@ class ExecutionTracker {
         var _a;
         this._executions = [];
         this._currentExecution = null;
-        this._instrumentedFunctions = new Map();
-        this._isInstrumented = false;
         this._callStack = new stack_1.CallStackManager();
         this._asciiGenerator = new ascii_1.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
@@ -52,7 +54,7 @@ class ExecutionTracker {
             children: [],
         };
         // Set parent-child relationship
-        if (this._currentExecution) {
+        if (this._currentExecution && enableNestedTracking) {
             execution.parent = this._currentExecution;
             this._currentExecution.children.push(execution);
         }
@@ -64,20 +66,9 @@ class ExecutionTracker {
         const previousExecution = this._currentExecution;
         // Set this as the current execution
         this._currentExecution = execution;
-        // Flag to track if we're already instrumenting to avoid recursion
-        const wasInstrumented = this._isInstrumented;
         try {
-            // If this is the top-level call and nested tracking is enabled, instrument the function
-            if (enableNestedTracking && !wasInstrumented) {
-                this._isInstrumented = true;
-                // Instrument the function to track nested calls
-                const instrumentedFn = this.instrumentFunction(fn);
-                return instrumentedFn();
-            }
-            else {
-                // Execute the function normally
-                return fn();
-            }
+            // Execute the function
+            return fn();
         }
         finally {
             // End timing
@@ -95,44 +86,27 @@ class ExecutionTracker {
             this._currentExecution = previousExecution;
             // Remove from call stack
             this._callStack.pop();
-            // Reset instrumentation flag if this was the top-level call
-            if (!wasInstrumented) {
-                this._isInstrumented = false;
-            }
         }
     }
     /**
-     * Instrument a function to track nested function calls
+     * Create a trackable version of a function
      *
-     * @param fn - The function to instrument
-     * @returns The instrumented 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
      */
-    instrumentFunction(fn) {
-        // If we've already instrumented this function, return the instrumented version
-        if (this._instrumentedFunctions.has(fn)) {
-            return this._instrumentedFunctions.get(fn);
-        }
-        // Create a new instrumented function
-        const instrumentedFn = () => {
-            try {
-                // We can't actually modify the function at runtime to track nested calls
-                // in a generic way. The best we can do is execute the function and rely
-                // on the call stack for visualization.
-                //
-                // For proper nested function tracking, users should wrap each function
-                // they want to track with tracePerf.track() or use a more advanced
-                // instrumentation approach like aspect-oriented programming or
-                // code transformation.
-                return fn();
-            }
-            catch (error) {
-                // Re-throw any errors
-                throw error;
-            }
+    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
+            });
         };
-        // Cache the instrumented function
-        this._instrumentedFunctions.set(fn, instrumentedFn);
-        return instrumentedFn;
     }
     /**
      * Get the current call stack
@@ -203,7 +177,6 @@ class ExecutionTracker {
         this._executions = [];
         this._currentExecution = null;
         this._callStack.clear();
-        this._instrumentedFunctions.clear();
     }
     /**
      * Get all execution records

package/dist/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/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/types/index.d.ts

@@ -19,16 +19,66 @@ export interface ITrackOptions {
     /**
      * Whether to track nested function calls
      *
-     * Note: This option doesn't automatically track all nested function calls.
-     * It only enables the infrastructure for tracking nested calls, but you still
-     * need to manually track each nested function using one of the approaches
-     * described in the documentation.
+     * 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/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/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;
+}