traceperf 0.2.1 → 1.3.0

package/dist/esm/trackers/execution.js

@@ -1,226 +0,0 @@
-import { getFunctionName } from '../utils/stack';
-import { getHighResTime, getDuration } from '../utils/timing';
-/**
- * Execution tracker for performance monitoring
- */
-export class ExecutionTracker {
-    /**
-     * Constructor
-     *
-     * @param options - Options for execution tracking
-     */
-    constructor(options = {}) {
-        var _a;
-        this._executions = [];
-        this._currentExecution = null;
-        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 :
-            typeof global !== 'undefined' ? global :
-                {};
-    }
-    /**
-     * 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(fn, options) {
-        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.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
-        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
-        const level = this._callStack.push(fnName);
-        // Create execution record
-        const execution = {
-            name: fnName,
-            duration: 0,
-            isSlow: false,
-            level: level - 1, // 0-based level
-            startTime,
-            children: [],
-        };
-        // Set parent-child relationship
-        if (this._currentExecution && enableNestedTracking) {
-            execution.parent = this._currentExecution;
-            this._currentExecution.children.push(execution);
-        }
-        else {
-            // This is a root execution
-            this._executions.push(execution);
-        }
-        // Save the previous current execution
-        const previousExecution = this._currentExecution;
-        // Set this as the current execution
-        this._currentExecution = execution;
-        try {
-            // Execute the function
-            return fn();
-        }
-        finally {
-            // End timing
-            const endTime = getHighResTime();
-            execution.endTime = endTime;
-            // Calculate duration
-            execution.duration = getDuration(startTime);
-            // Check if it's a bottleneck
-            execution.isSlow = execution.duration > threshold;
-            // Calculate memory usage
-            if (includeMemory && startMemory !== undefined) {
-                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;
-            // Remove from call stack
-            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 fnName = (options === null || options === void 0 ? void 0 : options.label) || fn.name || 'anonymous';
-        // 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
-     *
-     * @returns The current call stack
-     */
-    getCallStack() {
-        return [...this._callStack];
-    }
-    /**
-     * Generate a visual representation of the execution flow
-     *
-     * @returns ASCII flow chart of the execution
-     */
-    generateFlowChart() {
-        let result = '';
-        // Process each execution
-        this._executions.forEach(execution => {
-            result = this.printExecutionTree(execution, result);
-        });
-        return result;
-    }
-    /**
-     * Recursively print an execution tree
-     *
-     * @param execution - The root execution
-     * @param result - The output string
-     * @returns The updated result string
-     */
-    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;
-    }
-    /**
-     * Print a single execution with appropriate formatting
-     *
-     * @param execution - The execution to print
-     * @param result - The result string to append to
-     * @returns The updated result string
-     */
-    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
-     */
-    clear() {
-        this._executions = [];
-        this._currentExecution = null;
-        this._callStack = [];
-    }
-}
-//# sourceMappingURL=execution.js.map

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

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

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

@@ -1,2 +0,0 @@
-export * from './execution';
-export * from './performance';

package/dist/esm/trackers/index.js

@@ -1,3 +0,0 @@
-export * from './execution';
-export * from './performance';
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/trackers/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC"}

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

@@ -1,68 +0,0 @@
-import { IPerformanceMonitor } from '../types';
-/**
- * Performance monitor for tracking execution times and memory usage
- */
-export declare class PerformanceMonitor implements IPerformanceMonitor {
-    private _timers;
-    private _defaultThreshold;
-    /**
-     * Create a new PerformanceMonitor instance
-     *
-     * @param options - Monitor options
-     */
-    constructor(options?: {
-        defaultThreshold?: number;
-    });
-    /**
-     * Start timing an operation
-     *
-     * @param label - Label for the operation
-     * @returns A unique identifier for the timing operation
-     */
-    startTimer(label: string): string;
-    /**
-     * End timing an operation
-     *
-     * @param id - The identifier returned by startTimer
-     * @returns The duration in milliseconds
-     * @throws Error if the timer doesn't exist
-     */
-    endTimer(id: string): number;
-    /**
-     * Check if an operation exceeds the performance threshold
-     *
-     * @param duration - The duration in milliseconds
-     * @param threshold - The threshold to check against
-     * @returns Whether the operation is considered slow
-     */
-    isBottleneck(duration: number, threshold?: number): boolean;
-    /**
-     * Get memory usage information
-     *
-     * @returns Memory usage object
-     */
-    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 or undefined
-     */
-    getMemoryDiff(start: {
-        heapUsed: number;
-    }): number;
-    /**
-     * Generate a suggestion for a bottleneck
-     *
-     * @param functionName - The name of the function
-     * @param duration - The duration in milliseconds
-     * @param memoryUsage - Memory usage in bytes
-     * @returns A suggestion for improving performance
-     */
-    generateSuggestion(functionName: string, duration: number, memoryUsage?: number): string;
-}

package/dist/esm/trackers/performance.js

@@ -1,112 +0,0 @@
-import { getHighResTime, getDuration } from '../utils/timing';
-import { v4 as uuidv4 } from 'uuid';
-/**
- * Performance monitor for tracking execution times and memory usage
- */
-export class PerformanceMonitor {
-    /**
-     * Create a new PerformanceMonitor instance
-     *
-     * @param options - Monitor options
-     */
-    constructor(options = {}) {
-        var _a;
-        this._timers = new Map();
-        this._defaultThreshold = (_a = options.defaultThreshold) !== null && _a !== void 0 ? _a : 100; // ms
-    }
-    /**
-     * Start timing an operation
-     *
-     * @param label - Label for the operation
-     * @returns A unique identifier for the timing operation
-     */
-    startTimer(label) {
-        const id = `${label}-${uuidv4()}`;
-        this._timers.set(id, getHighResTime());
-        return id;
-    }
-    /**
-     * End timing an operation
-     *
-     * @param id - The identifier returned by startTimer
-     * @returns The duration in milliseconds
-     * @throws Error if the timer doesn't exist
-     */
-    endTimer(id) {
-        const startTime = this._timers.get(id);
-        if (!startTime) {
-            throw new Error(`Timer with id ${id} not found`);
-        }
-        const duration = getDuration(startTime);
-        this._timers.delete(id);
-        return duration;
-    }
-    /**
-     * Check if an operation exceeds the performance threshold
-     *
-     * @param duration - The duration in milliseconds
-     * @param threshold - The threshold to check against
-     * @returns Whether the operation is considered slow
-     */
-    isBottleneck(duration, threshold) {
-        const effectiveThreshold = threshold !== null && threshold !== void 0 ? threshold : this._defaultThreshold;
-        return duration > effectiveThreshold;
-    }
-    /**
-     * Get memory usage information
-     *
-     * @returns Memory usage object
-     */
-    getMemoryUsage() {
-        try {
-            return process.memoryUsage();
-        }
-        catch (e) {
-            console.warn('Unable to track memory usage:', e);
-            return undefined;
-        }
-    }
-    /**
-     * Calculate memory difference between current and start memory
-     *
-     * @param start - Starting memory usage snapshot
-     * @returns Memory difference or undefined
-     */
-    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
-     *
-     * @param functionName - The name of the function
-     * @param duration - The duration in milliseconds
-     * @param memoryUsage - Memory usage in bytes
-     * @returns A suggestion for improving performance
-     */
-    generateSuggestion(functionName, duration, memoryUsage) {
-        // Simple heuristic-based suggestions
-        if (memoryUsage && memoryUsage > 10 * 1024 * 1024) {
-            return `🛠 Potential Fix: Check for memory leaks or large object allocations in ${functionName}`;
-        }
-        if (duration > 1000) {
-            return `🛠 Potential Fix: Consider optimizing or adding caching to ${functionName}`;
-        }
-        if (duration > 500) {
-            return `🛠 Potential Fix: Look for blocking operations in ${functionName}`;
-        }
-        return `🛠 Potential Fix: Review ${functionName} for performance optimizations`;
-    }
-}
-//# sourceMappingURL=performance.js.map

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

@@ -1 +0,0 @@
-{"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

@@ -1,142 +0,0 @@
-/**
- * LogLevel - Defines the severity levels for logging
- */
-export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
-/**
- * LogMode - Defines the operational modes for the logger
- */
-export type LogMode = 'dev' | 'staging' | 'prod' | string;
-/**
- * Transport - Interface for log output destinations
- */
-export interface ITransport {
-    /**
-     * Write a log entry to the destination
-     *
-     * @param entry - The formatted log entry to write
-     */
-    write(entry: string): void;
-}
-/**
- * Formatter - Interface for log formatters
- */
-export interface IFormatter {
-    /**
-     * Format a log entry
-     *
-     * @param level - The log level
-     * @param message - The log message
-     * @param args - Additional arguments
-     * @param meta - Metadata for the log entry
-     * @returns The formatted log entry
-     */
-    format(level: LogLevel, message: string | object, args: any[], meta: LogMeta): string;
-}
-/**
- * LogMeta - Metadata for log entries
- */
-export interface LogMeta {
-    timestamp: Date;
-    level: LogLevel;
-    indentLevel: number;
-    [key: string]: any;
-}
-/**
- * TrackOptions - Options for function execution tracking
- */
-export interface ITrackOptions {
-    /**
-     * Custom label for the tracked function
-     */
-    label?: string;
-    /**
-     * Performance threshold in milliseconds
-     * Functions exceeding this threshold will be flagged as bottlenecks
-     */
-    threshold?: number;
-    /**
-     * Whether to track memory usage
-     */
-    trackMemory?: boolean;
-    /**
-     * 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;
-    /**
-     * 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
- */
-export interface ILoggerConfig {
-    /**
-     * Operational mode
-     *
-     * - dev: All logs are shown
-     * - staging: Only warn and error logs are shown
-     * - prod: Only error logs are shown
-     */
-    mode: LogMode;
-    /**
-     * Minimum log level to show
-     */
-    level: LogLevel;
-    /**
-     * Whether to colorize logs
-     */
-    colorize: boolean;
-    /**
-     * Whether to include timestamps in logs
-     */
-    timestamp: boolean;
-    /**
-     * Performance threshold in milliseconds
-     *
-     * Functions that take longer than this threshold will be marked as bottlenecks
-     */
-    performanceThreshold: number;
-    /**
-     * Indentation size for nested logs
-     */
-    indentSize: number;
-    /**
-     * Whether to automatically track nested function calls
-     *
-     * When enabled, TracePerf will automatically track nested function calls
-     * using a proxy-based approach.
-     *
-     * @default true
-     */
-    autoTracking?: boolean;
-    /**
-     * Log output destinations
-     * @default [ConsoleTransport]
-     */
-    transports?: ITransport[];
-    /**
-     * Log formatters
-     * @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/config.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=config.js.map

package/dist/esm/types/config.js.map

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