traceperf 0.1.0

package/dist/formatters/ascii.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AsciiArtGenerator = void 0;
+const constants_1 = require("../core/constants");
+const timing_1 = require("../utils/timing");
+/**
+ * ASCII art generator for execution flow charts
+ */
+class AsciiArtGenerator {
+    /**
+     * Create a new AsciiArtGenerator instance
+     *
+     * @param options - Generator options
+     */
+    constructor(options = {}) {
+        var _a;
+        this._boxWidth = (_a = options.boxWidth) !== null && _a !== void 0 ? _a : 30;
+    }
+    /**
+     * Generate a flow chart for a sequence of function executions
+     *
+     * @param executions - Array of execution data
+     * @returns ASCII art flow chart
+     */
+    generateFlowChart(executions) {
+        let chart = '';
+        for (let i = 0; i < executions.length; i++) {
+            const execution = executions[i];
+            // Generate box for function
+            chart += this.generateFunctionBox(execution);
+            // Add arrow to next function if not the last one
+            if (i < executions.length - 1) {
+                chart += this.generateArrow(executions[i + 1].level - execution.level);
+            }
+        }
+        return chart;
+    }
+    /**
+     * Generate a box for a function execution
+     *
+     * @param execution - The execution data
+     * @returns ASCII art box
+     */
+    generateFunctionBox(execution) {
+        const { name, duration, isSlow, memoryUsage } = execution;
+        // Calculate padding for the function name
+        const nameLength = name.length;
+        const padding = Math.max(0, this._boxWidth - nameLength - 2);
+        const leftPadding = Math.floor(padding / 2);
+        const rightPadding = padding - leftPadding;
+        // Generate the box
+        let box = '';
+        // Top border
+        box += constants_1.BOX_CHARS.topLeft + constants_1.BOX_CHARS.horizontal.repeat(this._boxWidth) + constants_1.BOX_CHARS.topRight + '\n';
+        // Function name
+        box += constants_1.BOX_CHARS.vertical + ' '.repeat(leftPadding) + name + ' '.repeat(rightPadding) + constants_1.BOX_CHARS.vertical;
+        // Performance metrics
+        box += `  ${constants_1.PERFORMANCE_ICONS.timer}  ${(0, timing_1.formatDuration)(duration)}`;
+        if (isSlow) {
+            box += ` ${constants_1.PERFORMANCE_ICONS.slow} SLOW`;
+        }
+        if (memoryUsage !== undefined) {
+            box += ` ${constants_1.PERFORMANCE_ICONS.memory} ${this.formatMemory(memoryUsage)}`;
+        }
+        box += '\n';
+        // Bottom border
+        box += constants_1.BOX_CHARS.bottomLeft + constants_1.BOX_CHARS.horizontal.repeat(this._boxWidth) + constants_1.BOX_CHARS.bottomRight + '\n';
+        return box;
+    }
+    /**
+     * Generate an arrow between function boxes
+     *
+     * @param levelDiff - Difference in nesting level
+     * @returns ASCII art arrow
+     */
+    generateArrow(levelDiff) {
+        let arrow = '';
+        // Indent based on level difference
+        const indent = '  '.repeat(Math.max(0, levelDiff));
+        // Vertical line
+        arrow += indent + ' '.repeat(this._boxWidth / 2) + constants_1.BOX_CHARS.vertical + '\n';
+        // Arrow
+        arrow += indent + ' '.repeat(this._boxWidth / 2) + constants_1.BOX_CHARS.downArrow + '\n';
+        return arrow;
+    }
+    /**
+     * Format memory usage in a human-readable format
+     *
+     * @param bytes - Memory usage in bytes
+     * @returns Formatted memory usage
+     */
+    formatMemory(bytes) {
+        const units = ['B', 'KB', 'MB', 'GB'];
+        let size = bytes;
+        let unitIndex = 0;
+        while (size >= 1024 && unitIndex < units.length - 1) {
+            size /= 1024;
+            unitIndex++;
+        }
+        return `${size.toFixed(2)}${units[unitIndex]}`;
+    }
+}
+exports.AsciiArtGenerator = AsciiArtGenerator;
+//# sourceMappingURL=ascii.js.map

package/dist/formatters/ascii.js.map

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

package/dist/formatters/cli.d.ts

@@ -0,0 +1,50 @@
+import { IFormatter, LogLevel, LogMeta } from '../types';
+/**
+ * CLI formatter for console output
+ * Formats log entries with colors, icons, and indentation
+ */
+export declare class CliFormatter implements IFormatter {
+    private _colorEnabled;
+    private _indentSize;
+    /**
+     * Create a new CliFormatter instance
+     *
+     * @param options - Formatter options
+     */
+    constructor(options?: {
+        colorEnabled?: boolean;
+        indentSize?: number;
+    });
+    /**
+     * Format a log entry for CLI output
+     *
+     * @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;
+    /**
+     * Format a timestamp
+     *
+     * @param date - The date to format
+     * @returns The formatted timestamp
+     */
+    private formatTimestamp;
+    /**
+     * Format a log level
+     *
+     * @param level - The log level
+     * @returns The formatted log level
+     */
+    private formatLevel;
+    /**
+     * Format a message and its arguments
+     *
+     * @param message - The message to format
+     * @param args - Additional arguments
+     * @returns The formatted message
+     */
+    private formatMessage;
+}

package/dist/formatters/cli.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CliFormatter = void 0;
+const constants_1 = require("../core/constants");
+const colors_1 = require("../utils/colors");
+/**
+ * CLI formatter for console output
+ * Formats log entries with colors, icons, and indentation
+ */
+class CliFormatter {
+    /**
+     * Create a new CliFormatter instance
+     *
+     * @param options - Formatter options
+     */
+    constructor(options = {}) {
+        var _a, _b;
+        this._colorEnabled = (_a = options.colorEnabled) !== null && _a !== void 0 ? _a : (0, colors_1.supportsColor)();
+        this._indentSize = (_b = options.indentSize) !== null && _b !== void 0 ? _b : 2;
+    }
+    /**
+     * Format a log entry for CLI output
+     *
+     * @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, message, args, meta) {
+        const timestamp = this.formatTimestamp(meta.timestamp);
+        const levelStr = this.formatLevel(level);
+        const indent = ' '.repeat(meta.indentLevel * this._indentSize);
+        const formattedMessage = this.formatMessage(message, args);
+        return `${timestamp} ${levelStr} ${indent}${formattedMessage}`;
+    }
+    /**
+     * Format a timestamp
+     *
+     * @param date - The date to format
+     * @returns The formatted timestamp
+     */
+    formatTimestamp(date) {
+        const timeStr = date.toISOString().replace(/T/, ' ').replace(/\..+/, '');
+        return this._colorEnabled ? (0, colors_1.dim)(`[${timeStr}]`) : `[${timeStr}]`;
+    }
+    /**
+     * Format a log level
+     *
+     * @param level - The log level
+     * @returns The formatted log level
+     */
+    formatLevel(level) {
+        const icon = constants_1.LEVEL_ICONS[level];
+        const text = level.toUpperCase();
+        if (this._colorEnabled) {
+            return (0, colors_1.colorize)(`${icon} ${text}`, constants_1.LEVEL_COLORS[level]);
+        }
+        return `${icon} ${text}`;
+    }
+    /**
+     * Format a message and its arguments
+     *
+     * @param message - The message to format
+     * @param args - Additional arguments
+     * @returns The formatted message
+     */
+    formatMessage(message, args) {
+        let formattedMessage;
+        if (typeof message === 'string') {
+            formattedMessage = message;
+        }
+        else {
+            try {
+                formattedMessage = JSON.stringify(message, null, 2);
+            }
+            catch (error) {
+                formattedMessage = String(message);
+            }
+        }
+        // Format additional arguments
+        if (args.length > 0) {
+            const formattedArgs = args.map(arg => {
+                if (typeof arg === 'object' && arg !== null) {
+                    try {
+                        return JSON.stringify(arg, null, 2);
+                    }
+                    catch (error) {
+                        return String(arg);
+                    }
+                }
+                return String(arg);
+            }).join(' ');
+            formattedMessage = `${formattedMessage} ${formattedArgs}`;
+        }
+        return formattedMessage;
+    }
+}
+exports.CliFormatter = CliFormatter;
+//# sourceMappingURL=cli.js.map

package/dist/formatters/cli.js.map

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

package/dist/formatters/index.d.ts

@@ -0,0 +1,3 @@
+export * from './cli';
+export * from './json';
+export * from './ascii';

package/dist/formatters/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./cli"), exports);
+__exportStar(require("./json"), exports);
+__exportStar(require("./ascii"), exports);
+//# sourceMappingURL=index.js.map

package/dist/formatters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/formatters/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wCAAsB;AACtB,yCAAuB;AACvB,0CAAwB"}

package/dist/formatters/json.d.ts

@@ -0,0 +1,45 @@
+import { IFormatter, LogLevel, LogMeta } from '../types';
+/**
+ * JSON formatter for structured output
+ * Formats log entries as JSON objects
+ */
+export declare class JsonFormatter implements IFormatter {
+    /**
+     * Format a log entry as JSON
+     *
+     * @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 as a JSON string
+     */
+    format(level: LogLevel, message: string | object, args: any[], meta: LogMeta): string;
+    /**
+     * Format a message for JSON output
+     *
+     * @param message - The message to format
+     * @returns The formatted message
+     */
+    private formatMessage;
+    /**
+     * Format arguments for JSON output
+     *
+     * @param args - The arguments to format
+     * @returns The formatted arguments
+     */
+    private formatArgs;
+    /**
+     * Sanitize an object for JSON serialization
+     *
+     * @param obj - The object to sanitize
+     * @returns A sanitized version of the object
+     */
+    private sanitizeObject;
+    /**
+     * Extract additional metadata from the log meta object
+     *
+     * @param meta - The log metadata
+     * @returns Additional metadata as an object
+     */
+    private extractExtraMeta;
+}

package/dist/formatters/json.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JsonFormatter = void 0;
+/**
+ * JSON formatter for structured output
+ * Formats log entries as JSON objects
+ */
+class JsonFormatter {
+    /**
+     * Format a log entry as JSON
+     *
+     * @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 as a JSON string
+     */
+    format(level, message, args, meta) {
+        const logEntry = {
+            timestamp: meta.timestamp.toISOString(),
+            level,
+            indentLevel: meta.indentLevel,
+            message: this.formatMessage(message),
+            args: this.formatArgs(args),
+            ...this.extractExtraMeta(meta),
+        };
+        return JSON.stringify(logEntry);
+    }
+    /**
+     * Format a message for JSON output
+     *
+     * @param message - The message to format
+     * @returns The formatted message
+     */
+    formatMessage(message) {
+        if (typeof message === 'string') {
+            return message;
+        }
+        return this.sanitizeObject(message);
+    }
+    /**
+     * Format arguments for JSON output
+     *
+     * @param args - The arguments to format
+     * @returns The formatted arguments
+     */
+    formatArgs(args) {
+        return args.map(arg => {
+            if (typeof arg === 'object' && arg !== null) {
+                return this.sanitizeObject(arg);
+            }
+            return arg;
+        });
+    }
+    /**
+     * Sanitize an object for JSON serialization
+     *
+     * @param obj - The object to sanitize
+     * @returns A sanitized version of the object
+     */
+    sanitizeObject(obj) {
+        try {
+            // Use JSON.parse(JSON.stringify()) to remove non-serializable values
+            return JSON.parse(JSON.stringify(obj));
+        }
+        catch (error) {
+            // If serialization fails, return a simplified object
+            return { value: String(obj) };
+        }
+    }
+    /**
+     * Extract additional metadata from the log meta object
+     *
+     * @param meta - The log metadata
+     * @returns Additional metadata as an object
+     */
+    extractExtraMeta(meta) {
+        const result = {};
+        // Copy all properties except the standard ones
+        Object.keys(meta).forEach(key => {
+            if (!['timestamp', 'level', 'indentLevel'].includes(key)) {
+                result[key] = meta[key];
+            }
+        });
+        return result;
+    }
+}
+exports.JsonFormatter = JsonFormatter;
+//# sourceMappingURL=json.js.map

package/dist/formatters/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/formatters/json.ts"],"names":[],"mappings":";;;AAEA;;;GAGG;AACH,MAAa,aAAa;IACxB;;;;;;;;OAQG;IACI,MAAM,CAAC,KAAe,EAAE,OAAwB,EAAE,IAAW,EAAE,IAAa;QACjF,MAAM,QAAQ,GAAG;YACf,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE;YACvC,KAAK;YACL,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;YACpC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAC3B,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC;SAC/B,CAAC;QAEF,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED;;;;;OAKG;IACK,aAAa,CAAC,OAAwB;QAC5C,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,OAAO,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED;;;;;OAKG;IACK,UAAU,CAAC,IAAW;QAC5B,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;YACpB,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;gBAC5C,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;YAClC,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACK,cAAc,CAAC,GAAW;QAChC,IAAI,CAAC;YACH,qEAAqE;YACrE,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,qDAAqD;YACrD,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QAChC,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACK,gBAAgB,CAAC,IAAa;QACpC,MAAM,MAAM,GAAwB,EAAE,CAAC;QAEvC,+CAA+C;QAC/C,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;YAC9B,IAAI,CAAC,CAAC,WAAW,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACzD,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAtFD,sCAsFC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+import { Logger } from './core/logger';
+import { ILoggerConfig } from './types';
+declare const defaultLogger: Logger;
+export default defaultLogger;
+export declare function createLogger(config?: Partial<ILoggerConfig>): Logger;
+export * from './types';
+export * from './core';
+export * from './formatters';
+export * from './trackers';
+export * from './utils';

package/dist/index.js

@@ -0,0 +1,33 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLogger = createLogger;
+const logger_1 = require("./core/logger");
+// Create a singleton instance of the logger
+const defaultLogger = new logger_1.Logger();
+// Export the singleton instance as the default export
+exports.default = defaultLogger;
+// Export a function to create a new logger instance
+function createLogger(config = {}) {
+    return new logger_1.Logger(config);
+}
+// Export types and classes for advanced usage
+__exportStar(require("./types"), exports);
+__exportStar(require("./core"), exports);
+__exportStar(require("./formatters"), exports);
+__exportStar(require("./trackers"), exports);
+__exportStar(require("./utils"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAUA,oCAEC;AAZD,0CAAuC;AAGvC,4CAA4C;AAC5C,MAAM,aAAa,GAAG,IAAI,eAAM,EAAE,CAAC;AAEnC,sDAAsD;AACtD,kBAAe,aAAa,CAAC;AAE7B,oDAAoD;AACpD,SAAgB,YAAY,CAAC,SAAiC,EAAE;IAC9D,OAAO,IAAI,eAAM,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,8CAA8C;AAC9C,0CAAwB;AACxB,yCAAuB;AACvB,+CAA6B;AAC7B,6CAA2B;AAC3B,0CAAwB"}

package/dist/trackers/execution.d.ts

@@ -0,0 +1,72 @@
+import { IExecutionTracker, ITrackOptions } from '../types';
+/**
+ * Execution record for a function call
+ */
+interface ExecutionRecord {
+    name: string;
+    duration: number;
+    isSlow: boolean;
+    memoryUsage?: number;
+    level: number;
+    startTime: [number, number];
+    endTime?: [number, number];
+    children: ExecutionRecord[];
+    parent?: ExecutionRecord;
+}
+/**
+ * Execution tracker for tracking function calls and generating flow charts
+ */
+export declare class ExecutionTracker implements IExecutionTracker {
+    private _callStack;
+    private _executions;
+    private _currentExecution;
+    private _asciiGenerator;
+    private _defaultThreshold;
+    /**
+     * Create a new ExecutionTracker instance
+     *
+     * @param options - Tracker options
+     */
+    constructor(options?: {
+        defaultThreshold?: number;
+        boxWidth?: number;
+    });
+    /**
+     * 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;
+    /**
+     * Clear all execution records
+     */
+    clear(): void;
+    /**
+     * Get all execution records
+     *
+     * @returns All execution records
+     */
+    getExecutions(): ExecutionRecord[];
+    /**
+     * Flatten the execution tree into a list
+     *
+     * @param executions - The execution records to flatten
+     * @returns A flat list of execution data
+     */
+    private flattenExecutions;
+}
+export {};