traceperf 0.1.0

package/dist/utils/colors.d.ts

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

package/dist/utils/colors.js

@@ -0,0 +1,148 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.colorize = colorize;
+exports.bold = bold;
+exports.dim = dim;
+exports.underline = underline;
+exports.red = red;
+exports.green = green;
+exports.yellow = yellow;
+exports.blue = blue;
+exports.magenta = magenta;
+exports.cyan = cyan;
+exports.gray = gray;
+exports.supportsColor = supportsColor;
+const constants_1 = require("../core/constants");
+/**
+ * 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
+ */
+function colorize(text, color) {
+    return `${color}${text}${constants_1.COLORS.reset}`;
+}
+/**
+ * Apply bold formatting to a string
+ *
+ * @param text - The text to make bold
+ * @returns The bold string
+ */
+function bold(text) {
+    return `${constants_1.COLORS.bright}${text}${constants_1.COLORS.reset}`;
+}
+/**
+ * Apply dim formatting to a string
+ *
+ * @param text - The text to make dim
+ * @returns The dim string
+ */
+function dim(text) {
+    return `${constants_1.COLORS.dim}${text}${constants_1.COLORS.reset}`;
+}
+/**
+ * Apply underline formatting to a string
+ *
+ * @param text - The text to underline
+ * @returns The underlined string
+ */
+function underline(text) {
+    return `${constants_1.COLORS.underscore}${text}${constants_1.COLORS.reset}`;
+}
+/**
+ * Apply red color to a string
+ *
+ * @param text - The text to colorize
+ * @returns The red string
+ */
+function red(text) {
+    return colorize(text, constants_1.COLORS.fg.red);
+}
+/**
+ * Apply green color to a string
+ *
+ * @param text - The text to colorize
+ * @returns The green string
+ */
+function green(text) {
+    return colorize(text, constants_1.COLORS.fg.green);
+}
+/**
+ * Apply yellow color to a string
+ *
+ * @param text - The text to colorize
+ * @returns The yellow string
+ */
+function yellow(text) {
+    return colorize(text, constants_1.COLORS.fg.yellow);
+}
+/**
+ * Apply blue color to a string
+ *
+ * @param text - The text to colorize
+ * @returns The blue string
+ */
+function blue(text) {
+    return colorize(text, constants_1.COLORS.fg.blue);
+}
+/**
+ * Apply magenta color to a string
+ *
+ * @param text - The text to colorize
+ * @returns The magenta string
+ */
+function magenta(text) {
+    return colorize(text, constants_1.COLORS.fg.magenta);
+}
+/**
+ * Apply cyan color to a string
+ *
+ * @param text - The text to colorize
+ * @returns The cyan string
+ */
+function cyan(text) {
+    return colorize(text, constants_1.COLORS.fg.cyan);
+}
+/**
+ * Apply gray color to a string
+ *
+ * @param text - The text to colorize
+ * @returns The gray string
+ */
+function gray(text) {
+    return colorize(text, constants_1.COLORS.fg.gray);
+}
+/**
+ * Check if terminal supports colors
+ *
+ * @returns Whether the terminal supports colors
+ */
+function supportsColor() {
+    if (process.env.FORCE_COLOR === '0') {
+        return false;
+    }
+    if (process.env.FORCE_COLOR) {
+        return true;
+    }
+    if (process.platform === 'win32') {
+        return true;
+    }
+    if ('CI' in process.env) {
+        return true;
+    }
+    if (process.env.COLORTERM) {
+        return true;
+    }
+    if (process.env.TERM === 'dumb') {
+        return false;
+    }
+    if (process.stdout.isTTY) {
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=colors.js.map

package/dist/utils/colors.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,3 @@
+export * from './timing';
+export * from './stack';
+export * from './colors';

package/dist/utils/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("./timing"), exports);
+__exportStar(require("./stack"), exports);
+__exportStar(require("./colors"), exports);
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,0CAAwB;AACxB,2CAAyB"}

package/dist/utils/stack.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Utilities for managing call stacks and function tracking
+ */
+/**
+ * Extract the name of a function
+ *
+ * @param fn - The function to extract the name from
+ * @returns The function name or a placeholder if not available
+ */
+export declare function getFunctionName(fn: Function): string;
+/**
+ * Get the current call stack
+ *
+ * @returns An array of function names in the call stack
+ */
+export declare function getCallStack(): string[];
+/**
+ * CallStackManager - Manages a call stack for execution tracking
+ */
+export declare class CallStackManager {
+    private _stack;
+    /**
+     * Push a function name onto the call stack
+     *
+     * @param name - The function name
+     * @returns The current stack depth
+     */
+    push(name: string): number;
+    /**
+     * Pop a function name from the call stack
+     *
+     * @returns The popped function name or undefined if the stack is empty
+     */
+    pop(): string | undefined;
+    /**
+     * Get the current call stack
+     *
+     * @returns A copy of the current call stack
+     */
+    getStack(): string[];
+    /**
+     * Get the current stack depth
+     *
+     * @returns The current stack depth
+     */
+    getDepth(): number;
+    /**
+     * Clear the call stack
+     */
+    clear(): void;
+    /**
+     * Get the current function name (top of the stack)
+     *
+     * @returns The current function name or undefined if the stack is empty
+     */
+    getCurrentFunction(): string | undefined;
+    /**
+     * Get the parent function name
+     *
+     * @returns The parent function name or undefined if there is no parent
+     */
+    getParentFunction(): string | undefined;
+}

package/dist/utils/stack.js

@@ -0,0 +1,116 @@
+"use strict";
+/**
+ * Utilities for managing call stacks and function tracking
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CallStackManager = void 0;
+exports.getFunctionName = getFunctionName;
+exports.getCallStack = getCallStack;
+/**
+ * Extract the name of a function
+ *
+ * @param fn - The function to extract the name from
+ * @returns The function name or a placeholder if not available
+ */
+function getFunctionName(fn) {
+    if (fn.name) {
+        return fn.name;
+    }
+    // Try to extract name from function toString()
+    const fnStr = fn.toString();
+    const nameMatch = fnStr.match(/function\s+([^(]+)/);
+    if (nameMatch) {
+        return nameMatch[1].trim();
+    }
+    // For arrow functions or anonymous functions
+    const arrowMatch = fnStr.match(/^\s*(?:async\s+)?(?:\([^)]*\)|\w+)\s*=>/);
+    if (arrowMatch) {
+        return '<arrow function>';
+    }
+    return '<anonymous>';
+}
+/**
+ * Get the current call stack
+ *
+ * @returns An array of function names in the call stack
+ */
+function getCallStack() {
+    const stack = new Error().stack;
+    if (!stack) {
+        return [];
+    }
+    // Parse the stack trace
+    return stack
+        .split('\n')
+        .slice(2) // Skip the Error and this function
+        .map(line => {
+        const match = line.match(/at\s+([^\s]+)/);
+        return match ? match[1] : line.trim();
+    });
+}
+/**
+ * CallStackManager - Manages a call stack for execution tracking
+ */
+class CallStackManager {
+    constructor() {
+        this._stack = [];
+    }
+    /**
+     * Push a function name onto the call stack
+     *
+     * @param name - The function name
+     * @returns The current stack depth
+     */
+    push(name) {
+        this._stack.push(name);
+        return this._stack.length;
+    }
+    /**
+     * Pop a function name from the call stack
+     *
+     * @returns The popped function name or undefined if the stack is empty
+     */
+    pop() {
+        return this._stack.pop();
+    }
+    /**
+     * Get the current call stack
+     *
+     * @returns A copy of the current call stack
+     */
+    getStack() {
+        return [...this._stack];
+    }
+    /**
+     * Get the current stack depth
+     *
+     * @returns The current stack depth
+     */
+    getDepth() {
+        return this._stack.length;
+    }
+    /**
+     * Clear the call stack
+     */
+    clear() {
+        this._stack = [];
+    }
+    /**
+     * Get the current function name (top of the stack)
+     *
+     * @returns The current function name or undefined if the stack is empty
+     */
+    getCurrentFunction() {
+        return this._stack[this._stack.length - 1];
+    }
+    /**
+     * Get the parent function name
+     *
+     * @returns The parent function name or undefined if there is no parent
+     */
+    getParentFunction() {
+        return this._stack[this._stack.length - 2];
+    }
+}
+exports.CallStackManager = CallStackManager;
+//# sourceMappingURL=stack.js.map

package/dist/utils/stack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack.js","sourceRoot":"","sources":["../../src/utils/stack.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAQH,0CAmBC;AAOD,oCAcC;AA9CD;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,EAAY;IAC1C,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;QACZ,OAAO,EAAE,CAAC,IAAI,CAAC;IACjB,CAAC;IAED,+CAA+C;IAC/C,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;IAC5B,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACpD,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7B,CAAC;IAED,6CAA6C;IAC7C,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC1E,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;;;GAIG;AACH,SAAgB,YAAY;IAC1B,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC,KAAK,CAAC;IAChC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,wBAAwB;IACxB,OAAO,KAAK;SACT,KAAK,CAAC,IAAI,CAAC;SACX,KAAK,CAAC,CAAC,CAAC,CAAC,mCAAmC;SAC5C,GAAG,CAAC,IAAI,CAAC,EAAE;QACV,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAC1C,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACxC,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;GAEG;AACH,MAAa,gBAAgB;IAA7B;QACU,WAAM,GAAa,EAAE,CAAC;IAgEhC,CAAC;IA9DC;;;;;OAKG;IACI,IAAI,CAAC,IAAY;QACtB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACI,GAAG;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACI,QAAQ;QACb,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACI,QAAQ;QACb,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED;;OAEG;IACI,KAAK;QACV,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,CAAC;IAED;;;;OAIG;IACI,kBAAkB;QACvB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED;;;;OAIG;IACI,iBAAiB;QACtB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC7C,CAAC;CACF;AAjED,4CAiEC"}

package/dist/utils/timing.d.ts

@@ -0,0 +1,65 @@
+/**
+ * High-resolution timing utilities for performance tracking
+ */
+/**
+ * Get the current high-resolution time
+ *
+ * @returns The current high-resolution time
+ */
+export declare function getHighResTime(): [number, number];
+/**
+ * Calculate the duration between a start time and now
+ *
+ * @param startTime - The start time from getHighResTime()
+ * @returns The duration in milliseconds
+ */
+export declare function getDuration(startTime: [number, number]): number;
+/**
+ * Format a duration in milliseconds to a human-readable string
+ *
+ * @param duration - The duration in milliseconds
+ * @returns A formatted string (e.g., "1.23ms", "1.23s")
+ */
+export declare function formatDuration(duration: number): string;
+/**
+ * A simple timer class for measuring durations
+ */
+export declare class Timer {
+    private _startTime;
+    private _endTime;
+    private _label;
+    /**
+     * Create a new Timer instance
+     *
+     * @param label - A label for the timer
+     */
+    constructor(label: string);
+    /**
+     * Stop the timer
+     *
+     * @returns The duration in milliseconds
+     */
+    stop(): number;
+    /**
+     * Get the duration of the timer
+     *
+     * @returns The duration in milliseconds
+     */
+    getDuration(): number;
+    /**
+     * Get the label of the timer
+     *
+     * @returns The timer label
+     */
+    getLabel(): string;
+    /**
+     * Reset the timer
+     */
+    reset(): void;
+    /**
+     * Get a formatted string with the duration
+     *
+     * @returns A formatted string (e.g., "label: 1.23ms")
+     */
+    toString(): string;
+}

package/dist/utils/timing.js

@@ -0,0 +1,106 @@
+"use strict";
+/**
+ * High-resolution timing utilities for performance tracking
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Timer = void 0;
+exports.getHighResTime = getHighResTime;
+exports.getDuration = getDuration;
+exports.formatDuration = formatDuration;
+/**
+ * Get the current high-resolution time
+ *
+ * @returns The current high-resolution time
+ */
+function getHighResTime() {
+    return process.hrtime();
+}
+/**
+ * Calculate the duration between a start time and now
+ *
+ * @param startTime - The start time from getHighResTime()
+ * @returns The duration in milliseconds
+ */
+function getDuration(startTime) {
+    const [seconds, nanoseconds] = process.hrtime(startTime);
+    return seconds * 1000 + nanoseconds / 1000000;
+}
+/**
+ * Format a duration in milliseconds to a human-readable string
+ *
+ * @param duration - The duration in milliseconds
+ * @returns A formatted string (e.g., "1.23ms", "1.23s")
+ */
+function formatDuration(duration) {
+    if (duration < 1) {
+        return `${(duration * 1000).toFixed(2)}μs`;
+    }
+    else if (duration < 1000) {
+        return `${duration.toFixed(2)}ms`;
+    }
+    else {
+        return `${(duration / 1000).toFixed(2)}s`;
+    }
+}
+/**
+ * A simple timer class for measuring durations
+ */
+class Timer {
+    /**
+     * Create a new Timer instance
+     *
+     * @param label - A label for the timer
+     */
+    constructor(label) {
+        this._endTime = null;
+        this._startTime = getHighResTime();
+        this._label = label;
+    }
+    /**
+     * Stop the timer
+     *
+     * @returns The duration in milliseconds
+     */
+    stop() {
+        if (this._endTime === null) {
+            this._endTime = getHighResTime();
+        }
+        return this.getDuration();
+    }
+    /**
+     * Get the duration of the timer
+     *
+     * @returns The duration in milliseconds
+     */
+    getDuration() {
+        if (this._endTime === null) {
+            return getDuration(this._startTime);
+        }
+        return getDuration(this._startTime);
+    }
+    /**
+     * Get the label of the timer
+     *
+     * @returns The timer label
+     */
+    getLabel() {
+        return this._label;
+    }
+    /**
+     * Reset the timer
+     */
+    reset() {
+        this._startTime = getHighResTime();
+        this._endTime = null;
+    }
+    /**
+     * Get a formatted string with the duration
+     *
+     * @returns A formatted string (e.g., "label: 1.23ms")
+     */
+    toString() {
+        return `${this._label}: ${formatDuration(this.getDuration())}`;
+    }
+}
+exports.Timer = Timer;
+//# sourceMappingURL=timing.js.map

package/dist/utils/timing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.js","sourceRoot":"","sources":["../../src/utils/timing.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAOH,wCAEC;AAQD,kCAGC;AAQD,wCAQC;AAlCD;;;;GAIG;AACH,SAAgB,cAAc;IAC5B,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC;AAC1B,CAAC;AAED;;;;;GAKG;AACH,SAAgB,WAAW,CAAC,SAA2B;IACrD,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACzD,OAAO,OAAO,GAAG,IAAI,GAAG,WAAW,GAAG,OAAO,CAAC;AAChD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,QAAgB;IAC7C,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACjB,OAAO,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7C,CAAC;SAAM,IAAI,QAAQ,GAAG,IAAI,EAAE,CAAC;QAC3B,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IACpC,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAC5C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAa,KAAK;IAKhB;;;;OAIG;IACH,YAAY,KAAa;QARjB,aAAQ,GAA4B,IAAI,CAAC;QAS/C,IAAI,CAAC,UAAU,GAAG,cAAc,EAAE,CAAC;QACnC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED;;;;OAIG;IACI,IAAI;QACT,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YAC3B,IAAI,CAAC,QAAQ,GAAG,cAAc,EAAE,CAAC;QACnC,CAAC;QACD,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACI,WAAW;QAChB,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YAC3B,OAAO,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACtC,CAAC;IAED;;;;OAIG;IACI,QAAQ;QACb,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;OAEG;IACI,KAAK;QACV,IAAI,CAAC,UAAU,GAAG,cAAc,EAAE,CAAC;QACnC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACI,QAAQ;QACb,OAAO,GAAG,IAAI,CAAC,MAAM,KAAK,cAAc,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;IACjE,CAAC;CACF;AAhED,sBAgEC"}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "traceperf",
+  "version": "0.1.0",
+  "description": "Advanced console logging & performance tracking for Node.js",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "browser": "dist/browser.js",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "build:browser": "tsc -p tsconfig.browser.json",
+    "build:all": "npm run build && npm run build:browser",
+    "test": "jest",
+    "lint": "eslint src --ext .ts",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "prepare": "husky install",
+    "prepublishOnly": "npm run build:all",
+    "dev": "tsc --watch"
+  },
+  "keywords": [
+    "logging",
+    "performance",
+    "debugging",
+    "console",
+    "trace",
+    "profiling",
+    "bottleneck",
+    "execution-flow"
+  ],
+  "author": "Shubh Wadekar",
+  "license": "MIT",
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/thelastbackspace/traceperf.git"
+  },
+  "bugs": {
+    "url": "https://github.com/thelastbackspace/traceperf/issues"
+  },
+  "homepage": "https://github.com/thelastbackspace/traceperf#readme",
+  "devDependencies": {
+    "@types/jest": "^29.5.14",
+    "@types/node": "^22.13.10",
+    "@types/uuid": "^10.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.26.1",
+    "@typescript-eslint/parser": "^8.26.1",
+    "eslint": "^8.56.0",
+    "eslint-config-prettier": "^10.1.1",
+    "husky": "^9.1.7",
+    "jest": "^29.7.0",
+    "prettier": "^3.5.3",
+    "ts-jest": "^29.2.6",
+    "typescript": "^5.8.2"
+  },
+  "dependencies": {
+    "uuid": "^11.1.0"
+  }
+}