traceperf 0.1.4 → 0.2.0

package/dist/esm/trackers/execution.d.ts

@@ -1,36 +1,36 @@
 import { IExecutionTracker, ITrackOptions } from '../types';
 /**
- * Execution record for a function call
+ * A record of a function execution
  */
-interface ExecutionRecord {
+export interface ExecutionRecord {
     name: string;
     duration: number;
-    isSlow: boolean;
-    memoryUsage?: number;
-    level: number;
     startTime: [number, number];
     endTime?: [number, number];
+    isSlow: boolean;
+    level: number;
+    memoryUsage?: number;
+    memoryReleased?: number;
     children: ExecutionRecord[];
     parent?: ExecutionRecord;
 }
 /**
- * Execution tracker for tracking function calls and generating flow charts
+ * Execution tracker for performance monitoring
  */
 export declare class ExecutionTracker implements IExecutionTracker {
-    private _callStack;
     private _executions;
     private _currentExecution;
-    private _asciiGenerator;
     private _defaultThreshold;
+    private _callStack;
     private _globalScope;
+    private _trackedFunctions;
     /**
-     * Create a new ExecutionTracker instance
+     * Constructor
      *
-     * @param options - Tracker options
+     * @param options - Options for execution tracking
      */
     constructor(options?: {
         defaultThreshold?: number;
-        boxWidth?: number;
     });
     /**
      * Track the execution of a function
@@ -53,6 +53,19 @@ export declare class ExecutionTracker implements IExecutionTracker {
     createTrackable<T extends (...args: any[]) => any>(fn: T, options?: Omit<ITrackOptions, 'label'> & {
         label?: string;
     }): (...args: Parameters<T>) => ReturnType<T>;
+    /**
+     * Get all execution records
+     *
+     * @returns A list of execution records
+     */
+    getExecutions(): ExecutionRecord[];
+    /**
+     * Generate a human-friendly memory size string
+     *
+     * @param bytes - The size in bytes
+     * @returns A formatted string
+     */
+    formatMemorySize(bytes: number): string;
     /**
      * Get the current call stack
      *
@@ -66,28 +79,23 @@ export declare class ExecutionTracker implements IExecutionTracker {
      */
     generateFlowChart(): string;
     /**
-     * Prepare execution data for the ASCII generator
+     * Recursively print an execution tree
      *
-     * @param executions - The execution records to prepare
-     * @returns A list of execution data
+     * @param execution - The root execution
+     * @param result - The output string
+     * @returns The updated result string
      */
-    private prepareExecutionData;
+    private printExecutionTree;
     /**
-     * Add children to the result list
+     * Print a single execution with appropriate formatting
      *
-     * @param children - The children to add
-     * @param result - The result list
+     * @param execution - The execution to print
+     * @param result - The result string to append to
+     * @returns The updated result string
      */
-    private addChildrenToResult;
+    private printSingleExecution;
     /**
      * Clear all execution records
      */
     clear(): void;
-    /**
-     * Get all execution records
-     *
-     * @returns All execution records
-     */
-    getExecutions(): ExecutionRecord[];
 }
-export {};

package/dist/esm/trackers/execution.js

@@ -1,21 +1,20 @@
-import { CallStackManager, getFunctionName } from '../utils/stack';
+import { getFunctionName } from '../utils/stack';
 import { getHighResTime, getDuration } from '../utils/timing';
-import { AsciiArtGenerator } from '../formatters/ascii';
 /**
- * Execution tracker for tracking function calls and generating flow charts
+ * Execution tracker for performance monitoring
  */
 export class ExecutionTracker {
     /**
-     * Create a new ExecutionTracker instance
+     * Constructor
      *
-     * @param options - Tracker options
+     * @param options - Options for execution tracking
      */
     constructor(options = {}) {
         var _a;
         this._executions = [];
         this._currentExecution = null;
-        this._callStack = new CallStackManager();
-        this._asciiGenerator = new AsciiArtGenerator({ boxWidth: options.boxWidth });
+        this._callStack = [];
+        this._trackedFunctions = new Map();
         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 :
@@ -33,10 +32,18 @@ export class ExecutionTracker {
         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 includeMemory = (_b = options === null || options === void 0 ? void 0 : options.trackMemory) !== 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;
+        let startMemory;
+        if (includeMemory) {
+            try {
+                startMemory = process.memoryUsage();
+            }
+            catch (e) {
+                console.warn('Unable to track memory usage:', e);
+            }
+        }
         // Start timing
         const startTime = getHighResTime();
         // Add to call stack
@@ -77,7 +84,19 @@ export class ExecutionTracker {
             execution.isSlow = execution.duration > threshold;
             // Calculate memory usage
             if (includeMemory && startMemory !== undefined) {
-                execution.memoryUsage = process.memoryUsage().heapUsed - startMemory;
+                try {
+                    const endMemory = process.memoryUsage();
+                    // Calculate the memory difference, ensuring it's never negative
+                    const memoryDiff = endMemory.heapUsed - startMemory.heapUsed;
+                    execution.memoryUsage = Math.max(0, memoryDiff); // Ensure non-negative value
+                    // If memory decreased, store a separate field for better visualization
+                    if (memoryDiff < 0) {
+                        execution.memoryReleased = Math.abs(memoryDiff);
+                    }
+                }
+                catch (e) {
+                    console.warn('Error calculating memory usage:', e);
+                }
             }
             // Restore the previous current execution
             this._currentExecution = previousExecution;
@@ -96,14 +115,45 @@ export class ExecutionTracker {
      * @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), {
+        // Create a tracked version of the function using arrow function to preserve 'this'
+        const trackedFn = (...args) => {
+            return this.track(() => fn.apply(this, args), {
                 ...options,
                 label: fnName
             });
         };
+        // Store the original and tracked function
+        this._trackedFunctions.set(fn, trackedFn);
+        return trackedFn;
+    }
+    /**
+     * Get all execution records
+     *
+     * @returns A list of execution records
+     */
+    getExecutions() {
+        return [...this._executions];
+    }
+    /**
+     * Generate a human-friendly memory size string
+     *
+     * @param bytes - The size in bytes
+     * @returns A formatted string
+     */
+    formatMemorySize(bytes) {
+        if (bytes < 1024) {
+            return `${bytes.toFixed(2)}B`;
+        }
+        else if (bytes < 1024 * 1024) {
+            return `${(bytes / 1024).toFixed(2)}KB`;
+        }
+        else if (bytes < 1024 * 1024 * 1024) {
+            return `${(bytes / (1024 * 1024)).toFixed(2)}MB`;
+        }
+        else {
+            return `${(bytes / (1024 * 1024 * 1024)).toFixed(2)}GB`;
+        }
     }
     /**
      * Get the current call stack
@@ -111,7 +161,7 @@ export class ExecutionTracker {
      * @returns The current call stack
      */
     getCallStack() {
-        return this._callStack.getStack();
+        return [...this._callStack];
     }
     /**
      * Generate a visual representation of the execution flow
@@ -119,53 +169,50 @@ export class ExecutionTracker {
      * @returns ASCII flow chart of the execution
      */
     generateFlowChart() {
-        // Convert execution records to execution data for the ASCII generator
-        const executionData = this.prepareExecutionData(this._executions);
-        // Generate the flow chart
-        return this._asciiGenerator.generateFlowChart(executionData);
+        let result = '';
+        // Process each execution
+        this._executions.forEach(execution => {
+            result = this.printExecutionTree(execution, result);
+        });
+        return result;
     }
     /**
-     * Prepare execution data for the ASCII generator
+     * Recursively print an execution tree
      *
-     * @param executions - The execution records to prepare
-     * @returns A list of execution data
+     * @param execution - The root execution
+     * @param result - The output string
+     * @returns The updated result string
      */
-    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);
+    printExecutionTree(execution, result) {
+        // Print this execution
+        result = this.printSingleExecution(execution, result);
+        // Print children recursively
+        execution.children.forEach(child => {
+            result = this.printExecutionTree(child, result);
         });
         return result;
     }
     /**
-     * Add children to the result list
+     * Print a single execution with appropriate formatting
      *
-     * @param children - The children to add
-     * @param result - The result list
+     * @param execution - The execution to print
+     * @param result - The result string to append to
+     * @returns The updated result string
      */
-    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);
-        });
+    printSingleExecution(execution, result) {
+        const indent = '  '.repeat(execution.level);
+        const durationStr = execution.duration.toFixed(2);
+        const slowMarker = execution.isSlow ? ' [SLOW]' : '';
+        let memoryStr = '';
+        if (execution.memoryUsage !== undefined) {
+            memoryStr = ` [${this.formatMemorySize(execution.memoryUsage)}]`;
+        }
+        result += `${indent}→ ${execution.name} (${durationStr}ms)${slowMarker}${memoryStr}\n`;
+        // Add connector if this execution has children
+        if (execution.children.length > 0) {
+            result += `${indent}  |\n`;
+        }
+        return result;
     }
     /**
      * Clear all execution records
@@ -173,15 +220,7 @@ export class ExecutionTracker {
     clear() {
         this._executions = [];
         this._currentExecution = null;
-        this._callStack.clear();
-    }
-    /**
-     * Get all execution records
-     *
-     * @returns All execution records
-     */
-    getExecutions() {
-        return [...this._executions];
+        this._callStack = [];
     }
 }
 //# 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":"AACA,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAiB,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAiBvE;;GAEG;AACH,MAAM,OAAO,gBAAgB;IAQ3B;;;;OAIG;IACH,YAAY,UAA4D,EAAE;;QAXlE,gBAAW,GAAsB,EAAE,CAAC;QACpC,sBAAiB,GAA2B,IAAI,CAAC;QAWvD,IAAI,CAAC,UAAU,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACzC,IAAI,CAAC,eAAe,GAAG,IAAI,iBAAiB,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC7E,IAAI,CAAC,iBAAiB,GAAG,MAAA,OAAO,CAAC,gBAAgB,mCAAI,GAAG,CAAC,CAAC,KAAK;QAE/D,2EAA2E;QAC3E,IAAI,CAAC,YAAY,GAAG,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YACxC,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAE,MAAyC,CAAC,CAAC;gBAC5E,EAAyB,CAAC;IAChD,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAI,EAAW,EAAE,OAAuB;;QAClD,MAAM,MAAM,GAAG,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,KAAK,KAAI,eAAe,CAAC,EAAE,CAAC,CAAC;QACrD,MAAM,SAAS,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,SAAS,mCAAI,IAAI,CAAC,iBAAiB,CAAC;QAC/D,MAAM,aAAa,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,aAAa,mCAAI,IAAI,CAAC;QACrD,MAAM,oBAAoB,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,oBAAoB,mCAAI,IAAI,CAAC;QAEnE,oCAAoC;QACpC,MAAM,WAAW,GAAG,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;QAE/E,eAAe;QACf,MAAM,SAAS,GAAG,cAAc,EAAE,CAAC;QAEnC,oBAAoB;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAE3C,0BAA0B;QAC1B,MAAM,SAAS,GAAoB;YACjC,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,CAAC;YACX,MAAM,EAAE,KAAK;YACb,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,gBAAgB;YAClC,SAAS;YACT,QAAQ,EAAE,EAAE;SACb,CAAC;QAEF,gCAAgC;QAChC,IAAI,IAAI,CAAC,iBAAiB,IAAI,oBAAoB,EAAE,CAAC;YACnD,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,iBAAiB,CAAC;YAC1C,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAClD,CAAC;aAAM,CAAC;YACN,2BAA2B;YAC3B,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACnC,CAAC;QAED,sCAAsC;QACtC,MAAM,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,CAAC;QAEjD,oCAAoC;QACpC,IAAI,CAAC,iBAAiB,GAAG,SAAS,CAAC;QAEnC,IAAI,CAAC;YACH,uBAAuB;YACvB,OAAO,EAAE,EAAE,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,aAAa;YACb,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;YACjC,SAAS,CAAC,OAAO,GAAG,OAAO,CAAC;YAE5B,qBAAqB;YACrB,SAAS,CAAC,QAAQ,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;YAE5C,6BAA6B;YAC7B,SAAS,CAAC,MAAM,GAAG,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAC;YAElD,yBAAyB;YACzB,IAAI,aAAa,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;gBAC/C,SAAS,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,GAAG,WAAW,CAAC;YACvE,CAAC;YAED,yCAAyC;YACzC,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;YAE3C,yBAAyB;YACzB,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;IAED;;;;;;;;;OASG;IACI,eAAe,CACpB,EAAK,EACL,OAA2D;QAE3D,MAAM,IAAI,GAAG,IAAI,CAAC;QAClB,MAAM,MAAM,GAAG,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,KAAK,KAAI,EAAE,CAAC,IAAI,IAAI,WAAW,CAAC;QAExD,OAAO,UAAoB,GAAG,IAAmB;YAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE;gBAC5C,GAAG,OAAO;gBACV,KAAK,EAAE,MAAM;aACd,CAAkB,CAAC;QACtB,CAAC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACI,YAAY;QACjB,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;IACpC,CAAC;IAED;;;;OAIG;IACI,iBAAiB;QACtB,sEAAsE;QACtE,MAAM,aAAa,GAAG,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAElE,0BAA0B;QAC1B,OAAO,IAAI,CAAC,eAAe,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC;IAC/D,CAAC;IAED;;;;;OAKG;IACK,oBAAoB,CAAC,UAA6B;QACxD,MAAM,MAAM,GAAoB,EAAE,CAAC;QAEnC,8BAA8B;QAC9B,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE;YAC7B,yBAAyB;YACzB,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,SAAS,CAAC,IAAI;gBACpB,QAAQ,EAAE,SAAS,CAAC,QAAQ;gBAC5B,MAAM,EAAE,SAAS,CAAC,MAAM;gBACxB,WAAW,EAAE,SAAS,CAAC,WAAW;gBAClC,KAAK,EAAE,SAAS,CAAC,KAAK;aACvB,CAAC,CAAC;YAEH,2BAA2B;YAC3B,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACK,mBAAmB,CAAC,QAA2B,EAAE,MAAuB;QAC9E,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;YACvB,gBAAgB;YAChB,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,KAAK,EAAE,KAAK,CAAC,KAAK;aACnB,CAAC,CAAC;YAEH,gCAAgC;YAChC,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACI,KAAK;QACV,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;QACtB,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;QAC9B,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACI,aAAa;QAClB,OAAO,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;IAC/B,CAAC;CACF"}
+{"version":3,"file":"execution.js","sourceRoot":"","sources":["../../../src/trackers/execution.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAkB,MAAM,iBAAiB,CAAC;AAkB9E;;GAEG;AACH,MAAM,OAAO,gBAAgB;IAQ3B;;;;OAIG;IACH,YAAY,UAAyC,EAAE;;QAZ/C,gBAAW,GAAsB,EAAE,CAAC;QACpC,sBAAiB,GAA2B,IAAI,CAAC;QAEjD,eAAU,GAAa,EAAE,CAAC;QAE1B,sBAAiB,GAA4B,IAAI,GAAG,EAAE,CAAC;QAQ7D,IAAI,CAAC,iBAAiB,GAAG,MAAA,OAAO,CAAC,gBAAgB,mCAAI,GAAG,CAAC,CAAC,KAAK;QAE/D,2EAA2E;QAC3E,IAAI,CAAC,YAAY,GAAG,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YACxC,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAE,MAAyC,CAAC,CAAC;gBAC5E,EAAyB,CAAC;IAChD,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAI,EAAW,EAAE,OAAuB;;QAClD,MAAM,MAAM,GAAG,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,KAAK,KAAI,eAAe,CAAC,EAAE,CAAC,CAAC;QACrD,MAAM,SAAS,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,SAAS,mCAAI,IAAI,CAAC,iBAAiB,CAAC;QAC/D,MAAM,aAAa,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,WAAW,mCAAI,IAAI,CAAC;QACnD,MAAM,oBAAoB,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,oBAAoB,mCAAI,IAAI,CAAC;QAEnE,oCAAoC;QACpC,IAAI,WAA+F,CAAC;QACpG,IAAI,aAAa,EAAE,CAAC;YAClB,IAAI,CAAC;gBACH,WAAW,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;YACtC,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,CAAC,IAAI,CAAC,+BAA+B,EAAE,CAAC,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;QAED,eAAe;QACf,MAAM,SAAS,GAAG,cAAc,EAAE,CAAC;QAEnC,oBAAoB;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAE3C,0BAA0B;QAC1B,MAAM,SAAS,GAAoB;YACjC,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,CAAC;YACX,MAAM,EAAE,KAAK;YACb,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,gBAAgB;YAClC,SAAS;YACT,QAAQ,EAAE,EAAE;SACb,CAAC;QAEF,gCAAgC;QAChC,IAAI,IAAI,CAAC,iBAAiB,IAAI,oBAAoB,EAAE,CAAC;YACnD,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,iBAAiB,CAAC;YAC1C,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAClD,CAAC;aAAM,CAAC;YACN,2BAA2B;YAC3B,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACnC,CAAC;QAED,sCAAsC;QACtC,MAAM,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,CAAC;QAEjD,oCAAoC;QACpC,IAAI,CAAC,iBAAiB,GAAG,SAAS,CAAC;QAEnC,IAAI,CAAC;YACH,uBAAuB;YACvB,OAAO,EAAE,EAAE,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,aAAa;YACb,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;YACjC,SAAS,CAAC,OAAO,GAAG,OAAO,CAAC;YAE5B,qBAAqB;YACrB,SAAS,CAAC,QAAQ,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;YAE5C,6BAA6B;YAC7B,SAAS,CAAC,MAAM,GAAG,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAC;YAElD,yBAAyB;YACzB,IAAI,aAAa,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;gBAC/C,IAAI,CAAC;oBACH,MAAM,SAAS,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;oBACxC,gEAAgE;oBAChE,MAAM,UAAU,GAAG,SAAS,CAAC,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC;oBAC7D,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,4BAA4B;oBAE7E,uEAAuE;oBACvE,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;wBACnB,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;oBAClD,CAAC;gBACH,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,OAAO,CAAC,IAAI,CAAC,iCAAiC,EAAE,CAAC,CAAC,CAAC;gBACrD,CAAC;YACH,CAAC;YAED,yCAAyC;YACzC,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;YAE3C,yBAAyB;YACzB,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;IAED;;;;;;;;;OASG;IACI,eAAe,CACpB,EAAK,EACL,OAA2D;QAE3D,MAAM,MAAM,GAAG,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,KAAK,KAAI,EAAE,CAAC,IAAI,IAAI,WAAW,CAAC;QAExD,mFAAmF;QACnF,MAAM,SAAS,GAAG,CAAC,GAAG,IAAmB,EAAiB,EAAE;YAC1D,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE;gBAC5C,GAAG,OAAO;gBACV,KAAK,EAAE,MAAM;aACd,CAAkB,CAAC;QACtB,CAAC,CAAC;QAEF,0CAA0C;QAC1C,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,EAAE,SAAgC,CAAC,CAAC;QAEjE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;OAIG;IACI,aAAa;QAClB,OAAO,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;IAC/B,CAAC;IAED;;;;;OAKG;IACI,gBAAgB,CAAC,KAAa;QACnC,IAAI,KAAK,GAAG,IAAI,EAAE,CAAC;YACjB,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;QAChC,CAAC;aAAM,IAAI,KAAK,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;YAC/B,OAAO,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QAC1C,CAAC;aAAM,IAAI,KAAK,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;YACtC,OAAO,GAAG,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QAC1D,CAAC;IACH,CAAC;IAED;;;;OAIG;IACI,YAAY;QACjB,OAAO,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACI,iBAAiB;QACtB,IAAI,MAAM,GAAG,EAAE,CAAC;QAEhB,yBAAyB;QACzB,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE;YACnC,MAAM,GAAG,IAAI,CAAC,kBAAkB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;OAMG;IACK,kBAAkB,CAAC,SAA0B,EAAE,MAAc;QACnE,uBAAuB;QACvB,MAAM,GAAG,IAAI,CAAC,oBAAoB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAEtD,6BAA6B;QAC7B,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;YACjC,MAAM,GAAG,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;OAMG;IACK,oBAAoB,CAAC,SAA0B,EAAE,MAAc;QACrE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,WAAW,GAAG,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAClD,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QAErD,IAAI,SAAS,GAAG,EAAE,CAAC;QACnB,IAAI,SAAS,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACxC,SAAS,GAAG,KAAK,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC;QACnE,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,KAAK,SAAS,CAAC,IAAI,KAAK,WAAW,MAAM,UAAU,GAAG,SAAS,IAAI,CAAC;QAEvF,+CAA+C;QAC/C,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC;QAC7B,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACI,KAAK;QACV,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;QACtB,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;QAC9B,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;IACvB,CAAC;CACF"}

package/dist/esm/trackers/performance.d.ts

@@ -39,37 +39,23 @@ export declare class PerformanceMonitor implements IPerformanceMonitor {
     /**
      * Get memory usage information
      *
-     * @returns Memory usage in bytes
+     * @returns Memory usage object
      */
     getMemoryUsage(): {
         heapUsed: number;
         heapTotal: number;
         external: number;
         rss: number;
-    };
+    } | undefined;
     /**
-     * Get memory difference between two points
+     * Calculate memory difference between current and start memory
      *
-     * @param before - Memory usage before
-     * @param after - Memory usage after
-     * @returns Memory difference in bytes
+     * @param start - Starting memory usage snapshot
+     * @returns Memory difference or undefined
      */
-    getMemoryDiff(before: {
+    getMemoryDiff(start: {
         heapUsed: number;
-        heapTotal: number;
-        external: number;
-        rss: number;
-    }, after: {
-        heapUsed: number;
-        heapTotal: number;
-        external: number;
-        rss: number;
-    }): {
-        heapUsed: number;
-        heapTotal: number;
-        external: number;
-        rss: number;
-    };
+    }): number;
     /**
      * Generate a suggestion for a bottleneck
      *

package/dist/esm/trackers/performance.js

@@ -55,31 +55,37 @@ export class PerformanceMonitor {
     /**
      * Get memory usage information
      *
-     * @returns Memory usage in bytes
+     * @returns Memory usage object
      */
     getMemoryUsage() {
-        const memoryUsage = process.memoryUsage();
-        return {
-            heapUsed: memoryUsage.heapUsed,
-            heapTotal: memoryUsage.heapTotal,
-            external: memoryUsage.external,
-            rss: memoryUsage.rss,
-        };
+        try {
+            return process.memoryUsage();
+        }
+        catch (e) {
+            console.warn('Unable to track memory usage:', e);
+            return undefined;
+        }
     }
     /**
-     * Get memory difference between two points
+     * Calculate memory difference between current and start memory
      *
-     * @param before - Memory usage before
-     * @param after - Memory usage after
-     * @returns Memory difference in bytes
+     * @param start - Starting memory usage snapshot
+     * @returns Memory difference or undefined
      */
-    getMemoryDiff(before, after) {
-        return {
-            heapUsed: after.heapUsed - before.heapUsed,
-            heapTotal: after.heapTotal - before.heapTotal,
-            external: after.external - before.external,
-            rss: after.rss - before.rss,
-        };
+    getMemoryDiff(start) {
+        try {
+            const current = this.getMemoryUsage();
+            if (!current)
+                return 0;
+            const diff = current.heapUsed - start.heapUsed;
+            // Return zero instead of negative values
+            // Negative values usually indicate garbage collection, not actual memory release
+            return Math.max(0, diff);
+        }
+        catch (e) {
+            console.warn('Error calculating memory usage:', e);
+            return 0;
+        }
     }
     /**
      * Generate a suggestion for a bottleneck

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

@@ -1 +1 @@
-{"version":3,"file":"performance.js","sourceRoot":"","sources":["../../../src/trackers/performance.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,MAAM,MAAM,CAAC;AAEpC;;GAEG;AACH,MAAM,OAAO,kBAAkB;IAI7B;;;;OAIG;IACH,YAAY,UAAyC,EAAE;;QAR/C,YAAO,GAAkC,IAAI,GAAG,EAAE,CAAC;QASzD,IAAI,CAAC,iBAAiB,GAAG,MAAA,OAAO,CAAC,gBAAgB,mCAAI,GAAG,CAAC,CAAC,KAAK;IACjE,CAAC;IAED;;;;;OAKG;IACI,UAAU,CAAC,KAAa;QAC7B,MAAM,EAAE,GAAG,GAAG,KAAK,IAAI,MAAM,EAAE,EAAE,CAAC;QAClC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC;QACvC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;;;;OAMG;IACI,QAAQ,CAAC,EAAU;QACxB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC;QACnD,CAAC;QAED,MAAM,QAAQ,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAExB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;OAMG;IACI,YAAY,CAAC,QAAgB,EAAE,SAAkB;QACtD,MAAM,kBAAkB,GAAG,SAAS,aAAT,SAAS,cAAT,SAAS,GAAI,IAAI,CAAC,iBAAiB,CAAC;QAC/D,OAAO,QAAQ,GAAG,kBAAkB,CAAC;IACvC,CAAC;IAED;;;;OAIG;IACI,cAAc;QACnB,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QAC1C,OAAO;YACL,QAAQ,EAAE,WAAW,CAAC,QAAQ;YAC9B,SAAS,EAAE,WAAW,CAAC,SAAS;YAChC,QAAQ,EAAE,WAAW,CAAC,QAAQ;YAC9B,GAAG,EAAE,WAAW,CAAC,GAAG;SACrB,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACI,aAAa,CAClB,MAA8E,EAC9E,KAA6E;QAE7E,OAAO;YACL,QAAQ,EAAE,KAAK,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ;YAC1C,SAAS,EAAE,KAAK,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS;YAC7C,QAAQ,EAAE,KAAK,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ;YAC1C,GAAG,EAAE,KAAK,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG;SAC5B,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACI,kBAAkB,CACvB,YAAoB,EACpB,QAAgB,EAChB,WAAoB;QAEpB,qCAAqC;QACrC,IAAI,WAAW,IAAI,WAAW,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;YAClD,OAAO,2EAA2E,YAAY,EAAE,CAAC;QACnG,CAAC;QAED,IAAI,QAAQ,GAAG,IAAI,EAAE,CAAC;YACpB,OAAO,8DAA8D,YAAY,EAAE,CAAC;QACtF,CAAC;QAED,IAAI,QAAQ,GAAG,GAAG,EAAE,CAAC;YACnB,OAAO,qDAAqD,YAAY,EAAE,CAAC;QAC7E,CAAC;QAED,OAAO,4BAA4B,YAAY,gCAAgC,CAAC;IAClF,CAAC;CACF"}
+{"version":3,"file":"performance.js","sourceRoot":"","sources":["../../../src/trackers/performance.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,MAAM,MAAM,CAAC;AAEpC;;GAEG;AACH,MAAM,OAAO,kBAAkB;IAI7B;;;;OAIG;IACH,YAAY,UAAyC,EAAE;;QAR/C,YAAO,GAAkC,IAAI,GAAG,EAAE,CAAC;QASzD,IAAI,CAAC,iBAAiB,GAAG,MAAA,OAAO,CAAC,gBAAgB,mCAAI,GAAG,CAAC,CAAC,KAAK;IACjE,CAAC;IAED;;;;;OAKG;IACI,UAAU,CAAC,KAAa;QAC7B,MAAM,EAAE,GAAG,GAAG,KAAK,IAAI,MAAM,EAAE,EAAE,CAAC;QAClC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC;QACvC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;;;;OAMG;IACI,QAAQ,CAAC,EAAU;QACxB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC;QACnD,CAAC;QAED,MAAM,QAAQ,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAExB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;OAMG;IACI,YAAY,CAAC,QAAgB,EAAE,SAAkB;QACtD,MAAM,kBAAkB,GAAG,SAAS,aAAT,SAAS,cAAT,SAAS,GAAI,IAAI,CAAC,iBAAiB,CAAC;QAC/D,OAAO,QAAQ,GAAG,kBAAkB,CAAC;IACvC,CAAC;IAED;;;;OAIG;IACI,cAAc;QACnB,IAAI,CAAC;YACH,OAAO,OAAO,CAAC,WAAW,EAAE,CAAC;QAC/B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,+BAA+B,EAAE,CAAC,CAAC,CAAC;YACjD,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACI,aAAa,CAAC,KAA2B;QAC9C,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;YACtC,IAAI,CAAC,OAAO;gBAAE,OAAO,CAAC,CAAC;YAEvB,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;YAE/C,yCAAyC;YACzC,iFAAiF;YACjF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QAC3B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,iCAAiC,EAAE,CAAC,CAAC,CAAC;YACnD,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACI,kBAAkB,CACvB,YAAoB,EACpB,QAAgB,EAChB,WAAoB;QAEpB,qCAAqC;QACrC,IAAI,WAAW,IAAI,WAAW,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;YAClD,OAAO,2EAA2E,YAAY,EAAE,CAAC;QACnG,CAAC;QAED,IAAI,QAAQ,GAAG,IAAI,EAAE,CAAC;YACpB,OAAO,8DAA8D,YAAY,EAAE,CAAC;QACtF,CAAC;QAED,IAAI,QAAQ,GAAG,GAAG,EAAE,CAAC;YACnB,OAAO,qDAAqD,YAAY,EAAE,CAAC;QAC7E,CAAC;QAED,OAAO,4BAA4B,YAAY,gCAAgC,CAAC;IAClF,CAAC;CACF"}

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

@@ -55,9 +55,9 @@ export interface ITrackOptions {
      */
     threshold?: number;
     /**
-     * Whether to include memory usage tracking
+     * Whether to track memory usage
      */
-    includeMemory?: boolean;
+    trackMemory?: boolean;
     /**
      * Whether to suppress logging for this tracking
      */
@@ -71,6 +71,15 @@ export interface ITrackOptions {
      * @default true
      */
     enableNestedTracking?: boolean;
+    /**
+     * Tracking mode to use for this function
+     * Controls the level of detail and performance impact
+     */
+    trackingMode?: string;
+    /**
+     * Any other custom options
+     */
+    [key: string]: any;
 }
 /**
  * Logger configuration
@@ -125,4 +134,9 @@ export interface ILoggerConfig {
      * @default [CliFormatter]
      */
     formatters?: IFormatter[];
+    /**
+     * Tracking mode to use for performance monitoring
+     * Controls the level of detail and performance impact
+     */
+    trackingMode?: string;
 }

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

@@ -1,44 +1,42 @@
 export * from './config';
 export * from './logger';
 /**
- * Options for tracking function execution
+ * Interface for TracePerf configuration
+ */
+export interface ITracePerfConfig {
+    /** Tracking mode for balancing performance vs detail */
+    trackingMode?: string;
+    /** Whether to suppress console output */
+    silent?: boolean;
+    /** Whether to track memory usage */
+    trackMemory?: boolean;
+    /** Whether to enable nested function tracking */
+    enableNestedTracking?: boolean;
+    /** Minimum duration threshold in microseconds */
+    threshold?: number;
+    /** Sampling rate (0.0-1.0) for reducing overhead */
+    sampleRate?: number;
+}
+/**
+ * Interface for tracking options
  */
 export interface ITrackOptions {
-    /**
-     * Custom label for the function
-     */
+    /** Custom label for the tracked 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
-     */
+    /** Override default tracking mode */
+    trackingMode?: string;
+    /** Override default silent setting */
     silent?: boolean;
+    /** Override default memory tracking */
+    trackMemory?: boolean;
+    /** Override default nested tracking */
+    enableNestedTracking?: boolean;
+    /** Minimum duration threshold in microseconds */
+    threshold?: number;
+    /** Sampling rate (0.0-1.0) for reducing overhead */
+    sampleRate?: number;
+    /** Any other options */
+    [key: string]: any;
 }
 /**
  * Interface for execution trackers

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

@@ -127,12 +127,21 @@ export interface IPerformanceMonitor {
     /**
      * Get memory usage information
      *
-     * @returns Memory usage in bytes
+     * @returns Memory usage object or undefined if not available
      */
     getMemoryUsage(): {
         heapUsed: number;
         heapTotal: number;
         external: number;
         rss: number;
-    };
+    } | undefined;
+    /**
+     * Calculate memory difference between current and start memory
+     *
+     * @param start - Starting memory usage snapshot
+     * @returns Memory difference in bytes
+     */
+    getMemoryDiff(start: {
+        heapUsed: number;
+    }): number;
 }