traceperf 0.1.0

package/dist/trackers/execution.js

@@ -0,0 +1,147 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExecutionTracker = void 0;
+const stack_1 = require("../utils/stack");
+const timing_1 = require("../utils/timing");
+const ascii_1 = require("../formatters/ascii");
+/**
+ * Execution tracker for tracking function calls and generating flow charts
+ */
+class ExecutionTracker {
+    /**
+     * Create a new ExecutionTracker instance
+     *
+     * @param options - Tracker options
+     */
+    constructor(options = {}) {
+        var _a;
+        this._executions = [];
+        this._currentExecution = null;
+        this._callStack = new stack_1.CallStackManager();
+        this._asciiGenerator = new ascii_1.AsciiArtGenerator({ boxWidth: options.boxWidth });
+        this._defaultThreshold = (_a = options.defaultThreshold) !== null && _a !== void 0 ? _a : 100; // ms
+    }
+    /**
+     * 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;
+        const fnName = (options === null || options === void 0 ? void 0 : options.label) || (0, stack_1.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;
+        // Get memory usage before execution
+        const startMemory = includeMemory ? process.memoryUsage().heapUsed : undefined;
+        // Start timing
+        const startTime = (0, timing_1.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) {
+            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 = (0, timing_1.getHighResTime)();
+            execution.endTime = endTime;
+            // Calculate duration
+            execution.duration = (0, timing_1.getDuration)(startTime);
+            // Check if it's a bottleneck
+            execution.isSlow = execution.duration > threshold;
+            // Calculate memory usage
+            if (includeMemory && startMemory !== undefined) {
+                execution.memoryUsage = process.memoryUsage().heapUsed - startMemory;
+            }
+            // Restore the previous current execution
+            this._currentExecution = previousExecution;
+            // Remove from call stack
+            this._callStack.pop();
+        }
+    }
+    /**
+     * Get the current call stack
+     *
+     * @returns The current call stack
+     */
+    getCallStack() {
+        return this._callStack.getStack();
+    }
+    /**
+     * Generate a visual representation of the execution flow
+     *
+     * @returns ASCII flow chart of the execution
+     */
+    generateFlowChart() {
+        // Convert execution records to execution data for the ASCII generator
+        const flatExecutions = this.flattenExecutions(this._executions);
+        // Generate the flow chart
+        return this._asciiGenerator.generateFlowChart(flatExecutions);
+    }
+    /**
+     * Clear all execution records
+     */
+    clear() {
+        this._executions = [];
+        this._currentExecution = null;
+        this._callStack.clear();
+    }
+    /**
+     * Get all execution records
+     *
+     * @returns All execution records
+     */
+    getExecutions() {
+        return [...this._executions];
+    }
+    /**
+     * Flatten the execution tree into a list
+     *
+     * @param executions - The execution records to flatten
+     * @returns A flat list of execution data
+     */
+    flattenExecutions(executions) {
+        const result = [];
+        // Helper function to recursively flatten the tree
+        const flatten = (record) => {
+            result.push({
+                name: record.name,
+                duration: record.duration,
+                isSlow: record.isSlow,
+                memoryUsage: record.memoryUsage,
+                level: record.level,
+            });
+            // Process children
+            record.children.forEach(child => flatten(child));
+        };
+        // Flatten each root execution
+        executions.forEach(execution => flatten(execution));
+        return result;
+    }
+}
+exports.ExecutionTracker = ExecutionTracker;
+//# sourceMappingURL=execution.js.map

package/dist/trackers/execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.js","sourceRoot":"","sources":["../../src/trackers/execution.ts"],"names":[],"mappings":";;;AACA,0CAAmE;AACnE,4CAA8D;AAC9D,+CAAuE;AAiBvE;;GAEG;AACH,MAAa,gBAAgB;IAO3B;;;;OAIG;IACH,YAAY,UAA4D,EAAE;;QAVlE,gBAAW,GAAsB,EAAE,CAAC;QACpC,sBAAiB,GAA2B,IAAI,CAAC;QAUvD,IAAI,CAAC,UAAU,GAAG,IAAI,wBAAgB,EAAE,CAAC;QACzC,IAAI,CAAC,eAAe,GAAG,IAAI,yBAAiB,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC7E,IAAI,CAAC,iBAAiB,GAAG,MAAA,OAAO,CAAC,gBAAgB,mCAAI,GAAG,CAAC,CAAC,KAAK;IACjE,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAI,EAAW,EAAE,OAAuB;;QAClD,MAAM,MAAM,GAAG,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,KAAK,KAAI,IAAA,uBAAe,EAAC,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;QAErD,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,IAAA,uBAAc,GAAE,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,EAAE,CAAC;YAC3B,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,IAAA,uBAAc,GAAE,CAAC;YACjC,SAAS,CAAC,OAAO,GAAG,OAAO,CAAC;YAE5B,qBAAqB;YACrB,SAAS,CAAC,QAAQ,GAAG,IAAA,oBAAW,EAAC,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;;;;OAIG;IACI,YAAY;QACjB,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;IACpC,CAAC;IAED;;;;OAIG;IACI,iBAAiB;QACtB,sEAAsE;QACtE,MAAM,cAAc,GAAG,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAEhE,0BAA0B;QAC1B,OAAO,IAAI,CAAC,eAAe,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;IAChE,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;IAED;;;;;OAKG;IACK,iBAAiB,CAAC,UAA6B;QACrD,MAAM,MAAM,GAAoB,EAAE,CAAC;QAEnC,kDAAkD;QAClD,MAAM,OAAO,GAAG,CAAC,MAAuB,EAAQ,EAAE;YAChD,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB,CAAC,CAAC;YAEH,mBAAmB;YACnB,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QACnD,CAAC,CAAC;QAEF,8BAA8B;QAC9B,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;QAEpD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AA/JD,4CA+JC"}

package/dist/trackers/index.d.ts

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

package/dist/trackers/index.js

@@ -0,0 +1,19 @@
+"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("./execution"), exports);
+__exportStar(require("./performance"), exports);
+//# sourceMappingURL=index.js.map

package/dist/trackers/index.js.map

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

package/dist/trackers/performance.d.ts

@@ -0,0 +1,82 @@
+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 in bytes
+     */
+    getMemoryUsage(): {
+        heapUsed: number;
+        heapTotal: number;
+        external: number;
+        rss: number;
+    };
+    /**
+     * Get memory difference between two points
+     *
+     * @param before - Memory usage before
+     * @param after - Memory usage after
+     * @returns Memory difference in bytes
+     */
+    getMemoryDiff(before: {
+        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;
+    };
+    /**
+     * 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/trackers/performance.js

@@ -0,0 +1,110 @@
+"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 in bytes
+     */
+    getMemoryUsage() {
+        const memoryUsage = process.memoryUsage();
+        return {
+            heapUsed: memoryUsage.heapUsed,
+            heapTotal: memoryUsage.heapTotal,
+            external: memoryUsage.external,
+            rss: memoryUsage.rss,
+        };
+    }
+    /**
+     * Get memory difference between two points
+     *
+     * @param before - Memory usage before
+     * @param after - Memory usage after
+     * @returns Memory difference in bytes
+     */
+    getMemoryDiff(before, after) {
+        return {
+            heapUsed: after.heapUsed - before.heapUsed,
+            heapTotal: after.heapTotal - before.heapTotal,
+            external: after.external - before.external,
+            rss: after.rss - before.rss,
+        };
+    }
+    /**
+     * 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

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

package/dist/types/config.d.ts

@@ -0,0 +1,110 @@
+/**
+ * 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 include memory usage tracking
+     */
+    includeMemory?: boolean;
+    /**
+     * Whether to suppress logging for this tracking
+     */
+    silent?: boolean;
+}
+/**
+ * LoggerConfig - Configuration options for the logger
+ */
+export interface ILoggerConfig {
+    /**
+     * Operational mode
+     * @default 'dev'
+     */
+    mode?: LogMode;
+    /**
+     * Minimum log level to display
+     * @default 'debug'
+     */
+    level?: LogLevel;
+    /**
+     * Whether to colorize output
+     * @default true
+     */
+    colorize?: boolean;
+    /**
+     * Whether to include timestamps in logs
+     * @default true
+     */
+    timestamp?: boolean;
+    /**
+     * Default performance threshold in milliseconds
+     * @default 100
+     */
+    performanceThreshold?: number;
+    /**
+     * Number of spaces for each indentation level
+     * @default 2
+     */
+    indentSize?: number;
+    /**
+     * Log output destinations
+     * @default [ConsoleTransport]
+     */
+    transports?: ITransport[];
+    /**
+     * Log formatters
+     * @default [CliFormatter]
+     */
+    formatters?: IFormatter[];
+}

package/dist/types/config.js

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

package/dist/types/config.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from './config';
+export * from './logger';

package/dist/types/index.js

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

package/dist/types/index.js.map

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

package/dist/types/logger.d.ts

@@ -0,0 +1,127 @@
+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;
+}
+/**
+ * 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 in bytes
+     */
+    getMemoryUsage(): {
+        heapUsed: number;
+        heapTotal: number;
+        external: number;
+        rss: number;
+    };
+}

package/dist/types/logger.js

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

package/dist/types/logger.js.map

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