traceperf 0.2.1 → 1.3.0

package/dist/trackers/performance.js

@@ -1,116 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PerformanceMonitor = void 0;
-const timing_1 = require("../utils/timing");
-const uuid_1 = require("uuid");
-/**
- * Performance monitor for tracking execution times and memory usage
- */
-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}-${(0, uuid_1.v4)()}`;
-        this._timers.set(id, (0, timing_1.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 = (0, timing_1.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`;
-    }
-}
-exports.PerformanceMonitor = PerformanceMonitor;
-//# sourceMappingURL=performance.js.map

package/dist/trackers/performance.js.map

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

@@ -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/types/config.js.map

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

package/dist/types/logger.d.ts

@@ -1,147 +0,0 @@
-import { LogMode, ITrackOptions } from './config';
-/**
- * ILogger - Interface for the main logger functionality
- */
-export interface ILogger {
-    /**
-     * Log an informational message
-     *
-     * @param message - The message to log
-     * @param args - Additional arguments to include in the log
-     */
-    info(message: string | object, ...args: any[]): void;
-    /**
-     * Log a warning message
-     *
-     * @param message - The message to log
-     * @param args - Additional arguments to include in the log
-     */
-    warn(message: string | object, ...args: any[]): void;
-    /**
-     * Log an error message
-     *
-     * @param message - The message to log
-     * @param args - Additional arguments to include in the log
-     */
-    error(message: string | object, ...args: any[]): void;
-    /**
-     * Log a debug message
-     *
-     * @param message - The message to log
-     * @param args - Additional arguments to include in the log
-     */
-    debug(message: string | object, ...args: any[]): void;
-    /**
-     * Start a new log group with the given label
-     *
-     * @param label - The label for the group
-     */
-    group(label: string): void;
-    /**
-     * End the current log group
-     */
-    groupEnd(): void;
-    /**
-     * Set the operational mode for the logger
-     *
-     * @param mode - The mode to set
-     */
-    setMode(mode: LogMode): void;
-    /**
-     * Get the current operational mode
-     *
-     * @returns The current mode
-     */
-    getMode(): LogMode;
-    /**
-     * Track the execution of a function and log performance metrics
-     *
-     * @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?: any): (...args: Parameters<T>) => ReturnType<T>;
-}
-/**
- * IExecutionTracker - Interface for tracking function execution
- */
-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;
-    /**
-     * 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;
-}
-/**
- * IPerformanceMonitor - Interface for monitoring performance
- */
-export interface IPerformanceMonitor {
-    /**
-     * 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
-     */
-    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 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/logger.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=logger.js.map

package/dist/types/logger.js.map

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

package/dist/types.d.ts

@@ -1,65 +0,0 @@
-/**
- * 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

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

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

package/dist/utils/colors.d.ts

@@ -1,87 +0,0 @@
-/**
- * Utilities for working with terminal colors
- */
-/**
- * Apply color to a string
- *
- * @param text - The text to colorize
- * @param color - The color to apply
- * @returns The colorized string
- */
-export declare function colorize(text: string, color: string): string;
-/**
- * Apply bold formatting to a string
- *
- * @param text - The text to make bold
- * @returns The bold string
- */
-export declare function bold(text: string): string;
-/**
- * Apply dim formatting to a string
- *
- * @param text - The text to make dim
- * @returns The dim string
- */
-export declare function dim(text: string): string;
-/**
- * Apply underline formatting to a string
- *
- * @param text - The text to underline
- * @returns The underlined string
- */
-export declare function underline(text: string): string;
-/**
- * Apply red color to a string
- *
- * @param text - The text to colorize
- * @returns The red string
- */
-export declare function red(text: string): string;
-/**
- * Apply green color to a string
- *
- * @param text - The text to colorize
- * @returns The green string
- */
-export declare function green(text: string): string;
-/**
- * Apply yellow color to a string
- *
- * @param text - The text to colorize
- * @returns The yellow string
- */
-export declare function yellow(text: string): string;
-/**
- * Apply blue color to a string
- *
- * @param text - The text to colorize
- * @returns The blue string
- */
-export declare function blue(text: string): string;
-/**
- * Apply magenta color to a string
- *
- * @param text - The text to colorize
- * @returns The magenta string
- */
-export declare function magenta(text: string): string;
-/**
- * Apply cyan color to a string
- *
- * @param text - The text to colorize
- * @returns The cyan string
- */
-export declare function cyan(text: string): string;
-/**
- * Apply gray color to a string
- *
- * @param text - The text to colorize
- * @returns The gray string
- */
-export declare function gray(text: string): string;
-/**
- * Check if terminal supports colors
- *
- * @returns Whether the terminal supports colors
- */
-export declare function supportsColor(): boolean;