function-trace 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import type { TraceOptions, TraceStats } from "./types/index.js";
+export declare function trace<F extends (...args: any[]) => any>(fn: F, options?: TraceOptions): F & {
+    stats: TraceStats;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEjE,wBAAgB,KAAK,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACnD,EAAE,EAAE,CAAC,EACL,OAAO,GAAE,YAAiB,GAC3B,CAAC,GAAG;IAAE,KAAK,EAAE,UAAU,CAAA;CAAE,CAsD3B"}

package/dist/index.js

@@ -0,0 +1,47 @@
+export function trace(fn, options = {}) {
+    const { log = false, maxHistory = 50 } = options;
+    const stats = { calls: 0, errors: 0, lastTime: 0, history: [] };
+    const wrapped = ((...args) => {
+        const start = performance.now ? performance.now() : Date.now();
+        stats.calls += 1;
+        try {
+            const result = fn(...args);
+            if (result instanceof Promise) {
+                return result
+                    .then((res) => {
+                    const end = performance.now
+                        ? performance.now()
+                        : Date.now();
+                    stats.lastTime = end - start;
+                    stats.history.push(stats.lastTime);
+                    if (stats.history.length > maxHistory)
+                        stats.history.shift();
+                    if (log)
+                        console.log(`[func-trace] ${fn.name || 'anonymous'} executed in ${stats.lastTime.toFixed(2)}ms`);
+                    return res;
+                })
+                    .catch((err) => {
+                    stats.errors += 1;
+                    throw err;
+                });
+            }
+            else {
+                const end = performance.now ? performance.now() : Date.now();
+                stats.lastTime = end - start;
+                stats.history.push(stats.lastTime);
+                if (stats.history.length > maxHistory)
+                    stats.history.shift();
+                if (log)
+                    console.log(`[func-trace] ${fn.name || 'anonymous'} executed in ${stats.lastTime.toFixed(2)}ms`);
+                return result;
+            }
+        }
+        catch (err) {
+            stats.errors += 1;
+            throw err;
+        }
+    });
+    wrapped.stats = stats;
+    return wrapped;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,KAAK,CACjB,EAAK,EACL,UAAwB,EAAE;IAE1B,MAAM,EAAE,GAAG,GAAG,KAAK,EAAE,UAAU,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IACjD,MAAM,KAAK,GAAe,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAE5E,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,IAAmB,EAAE,EAAE;QACxC,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QAC/D,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;QAEjB,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;YAE3B,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;gBAC5B,OAAO,MAAM;qBACR,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;oBACV,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG;wBACvB,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE;wBACnB,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;oBACjB,KAAK,CAAC,QAAQ,GAAG,GAAG,GAAG,KAAK,CAAC;oBAC7B,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;oBACnC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,UAAU;wBACjC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;oBAC1B,IAAI,GAAG;wBACH,OAAO,CAAC,GAAG,CACP,gBACI,EAAE,CAAC,IAAI,IAAI,WACf,gBAAgB,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAChD,CAAC;oBACN,OAAO,GAAG,CAAC;gBACf,CAAC,CAAC;qBACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;oBACX,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;oBAClB,MAAM,GAAG,CAAC;gBACd,CAAC,CAAC,CAAC;YACX,CAAC;iBAAM,CAAC;gBACJ,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;gBAC7D,KAAK,CAAC,QAAQ,GAAG,GAAG,GAAG,KAAK,CAAC;gBAC7B,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;gBACnC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,UAAU;oBAAE,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;gBAC7D,IAAI,GAAG;oBACH,OAAO,CAAC,GAAG,CACP,gBACI,EAAE,CAAC,IAAI,IAAI,WACf,gBAAgB,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAChD,CAAC;gBACN,OAAO,MAAM,CAAC;YAClB,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;YAClB,MAAM,GAAG,CAAC;QACd,CAAC;IACL,CAAC,CAA8B,CAAC;IAEhC,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;IACtB,OAAO,OAAO,CAAC;AACnB,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,15 @@
+export interface TraceOptions {
+    log?: boolean;
+    maxHistory?: number;
+    color?: boolean;
+}
+export interface TraceStats {
+    calls: number;
+    errors: number;
+    lastTime: number;
+    history: number[];
+}
+export declare function trace<F extends (...args: any[]) => any>(fn: F, options?: TraceOptions): F & {
+    stats: TraceStats;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IACzB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;CACrB;AAGD,wBAAgB,KAAK,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACnD,EAAE,EAAE,CAAC,EACL,OAAO,GAAE,YAAiB,GAC3B,CAAC,GAAG;IAAE,KAAK,EAAE,UAAU,CAAA;CAAE,CAgE3B"}

package/dist/src/index.js

@@ -0,0 +1,57 @@
+export function trace(fn, options = {}) {
+    const { log = false, maxHistory = 50, color = true } = options;
+    const stats = { calls: 0, errors: 0, lastTime: 0, history: [] };
+    const wrapped = ((...args) => {
+        const start = performance.now ? performance.now() : Date.now();
+        stats.calls += 1;
+        try {
+            const result = fn(...args);
+            if (result instanceof Promise) {
+                return result
+                    .then((res) => {
+                    const end = performance.now
+                        ? performance.now()
+                        : Date.now();
+                    stats.lastTime = end - start;
+                    stats.history.push(stats.lastTime);
+                    if (stats.history.length > maxHistory)
+                        stats.history.shift();
+                    if (log) {
+                        const bold = '\x1b[1m';
+                        const cyan = '\x1b[36m';
+                        const reset = '\x1b[0m';
+                        const prefix = color ? `${bold}${cyan}[function-trace]${reset}` : '[function-trace]';
+                        console.log(`${prefix} ${fn.name || 'anonymous'} executed in ${stats.lastTime.toFixed(2)}ms`);
+                    }
+                    return res;
+                })
+                    .catch((err) => {
+                    stats.errors += 1;
+                    throw err;
+                });
+            }
+            else {
+                const end = performance.now ? performance.now() : Date.now();
+                stats.lastTime = end - start;
+                stats.history.push(stats.lastTime);
+                if (stats.history.length > maxHistory)
+                    stats.history.shift();
+                if (log) {
+                    const bold = '\x1b[1m';
+                    const cyan = '\x1b[36m';
+                    const reset = '\x1b[0m';
+                    const prefix = color ? `${bold}${cyan}[function-trace]${reset}` : '[function-trace]';
+                    console.log(`${prefix} ${fn.name || 'anonymous'} executed in ${stats.lastTime.toFixed(2)}ms`);
+                }
+                return result;
+            }
+        }
+        catch (err) {
+            stats.errors += 1;
+            throw err;
+        }
+    });
+    wrapped.stats = stats;
+    return wrapped;
+}
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

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

package/dist/src/types/index.d.ts

@@ -0,0 +1,11 @@
+export interface TraceOptions {
+    log?: boolean;
+    maxHistory?: number;
+}
+export interface TraceStats {
+    calls: number;
+    errors: number;
+    lastTime: number;
+    history: number[];
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/src/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IACzB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;CACrB"}

package/dist/src/types/index.js

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

package/dist/src/types/index.js.map

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

package/dist/tests/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/tests/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../tests/index.ts"],"names":[],"mappings":""}

package/dist/tests/index.js

@@ -0,0 +1,27 @@
+import { trace } from "../src/index.js";
+console.log("Running func-trace tests...");
+const sum = () => {
+    return 1 + 2 + 3 + 4 + 5;
+};
+const tracedSum = trace(sum, { log: true });
+tracedSum();
+tracedSum();
+tracedSum();
+console.log("Sum stats:", tracedSum.stats);
+console.log("----");
+// Sync function
+const multiply = trace((a, b) => a * b, { log: true });
+multiply(3, 4);
+// Async function
+const fetchTodo = trace(async (id) => {
+    const res = await fetch(`https://jsonplaceholder.typicode.com/todos/${id}`);
+    return res.json();
+}, { log: true });
+await fetchTodo(1);
+// Inspect stats
+console.log(fetchTodo.stats);
+console.log("----");
+console.log("Multiply result:", multiply(5, 6));
+console.log("Multiply stats:");
+console.log(multiply.stats);
+//# sourceMappingURL=index.js.map

package/dist/tests/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../tests/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAExC,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;AAC3C,MAAM,GAAG,GAAG,GAAG,EAAE;IACb,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC,CAAA;AAED,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;AAC5C,SAAS,EAAE,CAAC;AACZ,SAAS,EAAE,CAAC;AACZ,SAAS,EAAE,CAAC;AAEZ,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;AAC3C,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACpB,gBAAgB;AAChB,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;AACvD,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAEf,iBAAiB;AACjB,MAAM,SAAS,GAAG,KAAK,CACnB,KAAK,EAAE,EAAU,EAAE,EAAE;IACjB,MAAM,GAAG,GAAG,MAAM,KAAK,CACnB,8CAA8C,EAAE,EAAE,CACrD,CAAC;IACF,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC,EACD,EAAE,GAAG,EAAE,IAAI,EAAE,CAChB,CAAC;AAEF,MAAM,SAAS,CAAC,CAAC,CAAC,CAAC;AAEnB,gBAAgB;AAChB,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC7B,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAGpB,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAChD,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;AAC/B,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,11 @@
+export interface TraceOptions {
+    log?: boolean;
+    maxHistory?: number;
+}
+export interface TraceStats {
+    calls: number;
+    errors: number;
+    lastTime: number;
+    history: number[];
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IACzB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;CACrB"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# 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":""}

package/package.json

@@ -0,0 +1,35 @@
+{
+    "name": "function-trace",
+    "version": "0.1.0",
+    "description": "Tiny universal function profiler/logger for full-stack developers",
+    "type": "module",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "files": [
+        "dist"
+    ],
+    "scripts": {
+        "build": "tsc",
+        "prepublishOnly": "npm run build",
+        "test": "npm run build && node dist/tests/index.js"
+    },
+    "keywords": [
+        "trace",
+        "profiler",
+        "logger",
+        "performance",
+        "async",
+        "typescript"
+    ],
+    "license": "MIT",
+    "author": {
+        "name": "Masum Billah",
+        "email": "dev.billah@gmail.com",
+        "url": "https://masum-billah.vercel.app"
+    },
+    "devDependencies": {
+        "ts-node": "^10.9.2",
+        "tsup": "^7.0.0",
+        "typescript": "^5.0.0"
+    }
+}

package/readme.md

@@ -0,0 +1,237 @@
+# function-trace
+
+> A tiny universal function profiler and logger for full-stack developers. Trace execution time, monitor function calls, and track errors with zero configuration.
+
+![MIT License](https://img.shields.io/badge/License-MIT-blue.svg)
+![Version](https://img.shields.io/badge/Version-0.1.0-success.svg)
+![TypeScript](https://img.shields.io/badge/TypeScript-5-blue.svg)
+
+## Features
+
+✨ **Lightweight** - Minimal overhead, perfect for production  
+⚡ **Universal** - Works with sync and async functions  
+📊 **Performance Tracking** - Automatic execution time measurement  
+📈 **Statistics** - Built-in call counts, error tracking, and history  
+🎨 **Beautiful Output** - Color-coded console logging  
+📦 **Zero Dependencies** - Pure TypeScript, no external packages  
+🔧 **Type-Safe** - Full TypeScript support with proper type inference  
+
+## Installation
+
+```bash
+npm install function-trace
+```
+
+## Quick Start
+
+### Basic Usage
+
+```typescript
+import { trace } from 'function-trace';
+
+// Wrap any function with trace
+const add = trace((a: number, b: number) => a + b, { log: true });
+
+const result = add(5, 3);
+// Output: [function-trace] anonymous executed in 0.05ms
+
+console.log(add.stats); // { calls: 1, errors: 0, lastTime: 0.05, history: [0.05] }
+```
+
+### Synchronous Functions
+
+```typescript
+import { trace } from 'function-trace';
+
+const sum = () => {
+    return 1 + 2 + 3 + 4 + 5;
+};
+
+const tracedSum = trace(sum, { log: true });
+
+tracedSum(); // [function-trace] sum executed in 0.02ms
+tracedSum(); // [function-trace] sum executed in 0.01ms
+tracedSum(); // [function-trace] sum executed in 0.02ms
+
+console.log(tracedSum.stats);
+// {
+//   calls: 3,
+//   errors: 0,
+//   lastTime: 0.02,
+//   history: [0.02, 0.01, 0.02]
+// }
+```
+
+### Asynchronous Functions
+
+```typescript
+import { trace } from 'function-trace';
+
+const fetchTodo = trace(
+    async (id: number) => {
+        const res = await fetch(
+            `https://jsonplaceholder.typicode.com/todos/${id}`
+        );
+        return res.json();
+    },
+    { log: true }
+);
+
+await fetchTodo(1);
+// [function-trace] fetchTodo executed in 145.32ms
+
+console.log(fetchTodo.stats);
+// {
+//   calls: 1,
+//   errors: 0,
+//   lastTime: 145.32,
+//   history: [145.32]
+// }
+```
+
+### Named Functions
+
+```typescript
+import { trace } from 'function-trace';
+
+const multiply = (a: number, b: number) => a * b;
+const tracedMultiply = trace(multiply, { log: true });
+
+tracedMultiply(3, 4);
+// [function-trace] multiply executed in 0.03ms
+```
+
+## API Reference
+
+### `trace<F>(fn: F, options?: TraceOptions): F & { stats: TraceStats }`
+
+Wraps a function with performance tracking and returns the wrapped function with stats.
+
+#### Parameters
+
+- **fn** - The function to trace (sync or async)
+- **options** - Configuration object (optional)
+
+#### Options
+
+```typescript
+interface TraceOptions {
+    log?: boolean;           // Enable console logging (default: false)
+    maxHistory?: number;     // Number of execution times to keep (default: 50)
+    color?: boolean;         // Enable colored output (default: true)
+}
+```
+
+#### Return Value
+
+The wrapped function with attached `stats` property:
+
+```typescript
+interface TraceStats {
+    calls: number;      // Total number of calls
+    errors: number;     // Total number of errors
+    lastTime: number;   // Last execution time in ms
+    history: number[];  // Array of last N execution times
+}
+```
+
+## Production Examples
+
+### Database Query Monitoring
+
+```typescript
+import { trace } from 'function-trace';
+
+const getUserById = trace(
+    async (userId: string) => {
+        // Your database query
+        const user = await db.users.findById(userId);
+        return user;
+    },
+    { log: true, maxHistory: 100 }
+);
+
+// Monitor performance over time
+async function handleRequest(userId: string) {
+    const user = await getUserById(userId);
+    
+    // Check if query is getting slower
+    const avgTime = 
+        getUserById.stats.history.reduce((a, b) => a + b, 0) / 
+        getUserById.stats.history.length;
+    
+    if (avgTime > 100) {
+        console.warn('Database query is getting slow');
+    }
+    
+    return user;
+}
+```
+
+### API Endpoint Monitoring
+
+```typescript
+import { trace } from 'function-trace';
+
+const apiCall = trace(
+    async (url: string) => {
+        const response = await fetch(url);
+        return response.json();
+    },
+    { log: true, maxHistory: 200 }
+);
+
+// Track API performance
+console.log(`Total API calls: ${apiCall.stats.calls}`);
+console.log(`Failed calls: ${apiCall.stats.errors}`);
+console.log(`Last response time: ${apiCall.stats.lastTime}ms`);
+```
+
+### Function Performance Alerts
+
+```typescript
+import { trace } from 'function-trace';
+
+const criticalOperation = trace(
+    async () => {
+        // Some critical operation
+    },
+    { log: true, maxHistory: 50 }
+);
+
+async function executeWithAlert() {
+    await criticalOperation();
+    
+    const avgTime = 
+        criticalOperation.stats.history.reduce((a, b) => a + b, 0) / 
+        criticalOperation.stats.history.length;
+    
+    if (avgTime > 1000) {
+        // Send alert to monitoring service
+        console.error('⚠️ Operation exceeded SLA threshold');
+    }
+}
+```
+
+## Best Practices
+
+1. **Enable logging in development** - Use `log: true` during development for instant feedback
+2. **Disable logging in production** - Set `log: false` for performance-critical paths
+3. **Adjust history size** - Use `maxHistory` based on your monitoring needs
+4. **Track errors** - Use `stats.errors` to identify failing operations
+5. **Analyze history** - Review `history` array for performance trends
+
+## Performance Considerations
+
+- Minimal overhead (~0.05ms per call)
+- Memory efficient with configurable history size
+- No garbage collection pressure with bounded history array
+- Suitable for high-frequency function calls
+
+## License
+
+MIT © [Masum Billah](https://masum-billah.vercel.app)
+
+## Contributing
+
+Contributions are welcome! Feel free to submit a Pull Request.