traceperf 0.1.5 → 0.2.1

package/dist/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/trackers/performance.js

@@ -58,31 +58,37 @@ 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/trackers/performance.js.map

@@ -1 +1 @@
-{"version":3,"file":"performance.js","sourceRoot":"","sources":["../../src/trackers/performance.ts"],"names":[],"mappings":";;;AACA,4CAA8D;AAC9D,+BAAoC;AAEpC;;GAEG;AACH,MAAa,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,IAAA,SAAM,GAAE,EAAE,CAAC;QAClC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,IAAA,uBAAc,GAAE,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,IAAA,oBAAW,EAAC,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;AAtHD,gDAsHC"}
+{"version":3,"file":"performance.js","sourceRoot":"","sources":["../../src/trackers/performance.ts"],"names":[],"mappings":";;;AACA,4CAA8D;AAC9D,+BAAoC;AAEpC;;GAEG;AACH,MAAa,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,IAAA,SAAM,GAAE,EAAE,CAAC;QAClC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,IAAA,uBAAc,GAAE,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,IAAA,oBAAW,EAAC,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;AAxHD,gDAwHC"}

package/dist/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/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/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;
 }

package/dist/types.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Module for defining common types used throughout the application
+ */
+/**
+ * Options for tracking function execution
+ */
+export interface ITrackOptions {
+    /**
+     * Custom label for the function
+     */
+    label?: string;
+    /**
+     * Threshold in milliseconds for slow function detection
+     */
+    threshold?: number;
+    /**
+     * Whether to include memory usage in the tracking
+     */
+    includeMemory?: boolean;
+    /**
+     * Whether to enable nested function tracking
+     * If true, functions called within the tracked function will also be tracked
+     * Default: true
+     */
+    enableNestedTracking?: 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
+     *
+     * @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.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Module for defining common types used throughout the application
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/utils/colors.js

@@ -24,6 +24,9 @@ const constants_1 = require("../core/constants");
  * @returns The colorized string
  */
 function colorize(text, color) {
+    if (typeof supportsColor === 'function' ? !supportsColor() : false) {
+        return text;
+    }
     return `${color}${text}${constants_1.COLORS.reset}`;
 }
 /**
@@ -33,6 +36,9 @@ function colorize(text, color) {
  * @returns The bold string
  */
 function bold(text) {
+    if (typeof supportsColor === 'function' ? !supportsColor() : false) {
+        return text;
+    }
     return `${constants_1.COLORS.bright}${text}${constants_1.COLORS.reset}`;
 }
 /**
@@ -42,6 +48,9 @@ function bold(text) {
  * @returns The dim string
  */
 function dim(text) {
+    if (typeof supportsColor === 'function' ? !supportsColor() : false) {
+        return text;
+    }
     return `${constants_1.COLORS.dim}${text}${constants_1.COLORS.reset}`;
 }
 /**
@@ -51,6 +60,9 @@ function dim(text) {
  * @returns The underlined string
  */
 function underline(text) {
+    if (typeof supportsColor === 'function' ? !supportsColor() : false) {
+        return text;
+    }
     return `${constants_1.COLORS.underscore}${text}${constants_1.COLORS.reset}`;
 }
 /**

package/dist/utils/colors.js.map

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

package/dist/utils/string.d.ts

@@ -0,0 +1,29 @@
+/**
+ * String utility functions
+ */
+/**
+ * Center a string with padding
+ *
+ * @param str - The string to center
+ * @param length - The total length of the returned string
+ * @param char - The character to use for padding (default: space)
+ * @returns The padded string
+ */
+export declare function padCenter(str: string, length: number, char?: string): string;
+/**
+ * Truncate a string to a specified length and add ellipsis if needed
+ *
+ * @param str - The string to truncate
+ * @param maxLength - The maximum length allowed
+ * @returns The truncated string
+ */
+export declare function truncate(str: string, maxLength: number): string;
+/**
+ * Ensure that the string is at least a certain length
+ *
+ * @param str - The string to pad
+ * @param length - The minimum length desired
+ * @param char - The character to use for padding (default: space)
+ * @returns The padded string
+ */
+export declare function padEnd(str: string, length: number, char?: string): string;

package/dist/utils/string.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * String utility functions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.padCenter = padCenter;
+exports.truncate = truncate;
+exports.padEnd = padEnd;
+/**
+ * Center a string with padding
+ *
+ * @param str - The string to center
+ * @param length - The total length of the returned string
+ * @param char - The character to use for padding (default: space)
+ * @returns The padded string
+ */
+function padCenter(str, length, char = ' ') {
+    if (str.length >= length)
+        return str;
+    const leftPadding = Math.floor((length - str.length) / 2);
+    const rightPadding = length - str.length - leftPadding;
+    return char.repeat(leftPadding) + str + char.repeat(rightPadding);
+}
+/**
+ * Truncate a string to a specified length and add ellipsis if needed
+ *
+ * @param str - The string to truncate
+ * @param maxLength - The maximum length allowed
+ * @returns The truncated string
+ */
+function truncate(str, maxLength) {
+    if (str.length <= maxLength)
+        return str;
+    const ellipsis = '...';
+    return str.substring(0, maxLength - ellipsis.length) + ellipsis;
+}
+/**
+ * Ensure that the string is at least a certain length
+ *
+ * @param str - The string to pad
+ * @param length - The minimum length desired
+ * @param char - The character to use for padding (default: space)
+ * @returns The padded string
+ */
+function padEnd(str, length, char = ' ') {
+    if (str.length >= length)
+        return str;
+    return str + char.repeat(length - str.length);
+}
+//# sourceMappingURL=string.js.map

package/dist/utils/string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.js","sourceRoot":"","sources":["../../src/utils/string.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAUH,8BAOC;AASD,4BAKC;AAUD,wBAIC;AA3CD;;;;;;;GAOG;AACH,SAAgB,SAAS,CAAC,GAAW,EAAE,MAAc,EAAE,OAAe,GAAG;IACvE,IAAI,GAAG,CAAC,MAAM,IAAI,MAAM;QAAE,OAAO,GAAG,CAAC;IAErC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,MAAM,YAAY,GAAG,MAAM,GAAG,GAAG,CAAC,MAAM,GAAG,WAAW,CAAC;IAEvD,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;AACpE,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,QAAQ,CAAC,GAAW,EAAE,SAAiB;IACrD,IAAI,GAAG,CAAC,MAAM,IAAI,SAAS;QAAE,OAAO,GAAG,CAAC;IAExC,MAAM,QAAQ,GAAG,KAAK,CAAC;IACvB,OAAO,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC;AAClE,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,MAAM,CAAC,GAAW,EAAE,MAAc,EAAE,OAAe,GAAG;IACpE,IAAI,GAAG,CAAC,MAAM,IAAI,MAAM;QAAE,OAAO,GAAG,CAAC;IAErC,OAAO,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;AAChD,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "traceperf",
-  "version": "0.1.5",
-  "description": "Advanced console logging & performance tracking for Node.js",
+  "version": "0.2.1",
+  "description": "High-performance function execution tracking and monitoring for Node.js",
   "main": "dist/index.js",
   "module": "dist/esm/index.js",
   "types": "dist/index.d.ts",
@@ -34,14 +34,17 @@
     "dev": "tsc --watch"
   },
   "keywords": [
-    "logging",
     "performance",
-    "debugging",
-    "console",
-    "trace",
     "profiling",
-    "bottleneck",
-    "execution-flow"
+    "monitoring",
+    "tracking",
+    "execution",
+    "function-tracing",
+    "memory-tracking",
+    "bottleneck-detection",
+    "sampling",
+    "debug",
+    "optimization"
   ],
   "author": "Shubh Wadekar",
   "license": "MIT",