express-performance-toolkit 1.0.0 → 2.0.0

package/dist/store.js

@@ -1,63 +1,156 @@
 "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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MetricsStore = void 0;
+const perf_hooks_1 = require("perf_hooks");
+const analyzer_1 = require("./analyzer");
+const v8 = __importStar(require("v8"));
 /**
  * In-memory metrics store — shared state between all middleware components.
  * Uses a ring buffer for request logs and counters for aggregate stats.
  */
 class MetricsStore {
     constructor(options = {}) {
+        this.maxRoutes = 200; // Cap unique routes to prevent memory leaks
+        this.blockedEvents = [];
         this.maxLogs = options.maxLogs || 1000;
         this.logs = [];
         this.stats = {
             totalRequests: 0,
             totalResponseTime: 0,
             slowRequests: 0,
+            highQueryRequests: 0,
+            rateLimitHits: 0,
             cacheHits: 0,
             cacheMisses: 0,
+            totalBytesSent: 0,
             cacheSize: 0,
             statusCodes: {},
             routes: {},
             startTime: Date.now(),
         };
+        this.histogram = (0, perf_hooks_1.monitorEventLoopDelay)({ resolution: 10 });
+        this.histogram.enable();
     }
     /** Add a request log entry to the ring buffer. */
-    addLog(entry) {
-        this.logs.push({
-            ...entry,
-            timestamp: entry.timestamp || Date.now(),
-        });
+    recordLog(log) {
+        this.logs.push(log);
         // Ring buffer — drop oldest entries when full
         if (this.logs.length > this.maxLogs) {
             this.logs.shift();
         }
         // Update aggregate stats
         this.stats.totalRequests++;
-        this.stats.totalResponseTime += entry.responseTime || 0;
+        this.stats.totalResponseTime += log.responseTime || 0;
         // Track status codes
-        const code = entry.statusCode || 0;
-        this.stats.statusCodes[code] = (this.stats.statusCodes[code] || 0) + 1;
+        this.stats.totalBytesSent += log.bytesSent;
         // Track per-route stats
-        const routeKey = `${entry.method} ${entry.path}`;
+        // Use normalized path (routePattern) if available, fallback to actual path
+        const routeKey = `${log.method} ${log.routePattern || log.path}`;
         if (!this.stats.routes[routeKey]) {
-            this.stats.routes[routeKey] = {
-                count: 0,
-                totalTime: 0,
-                slowCount: 0,
-                avgTime: 0,
-            };
+            // Prevent unbounded growth of the routes map
+            if (Object.keys(this.stats.routes).length >= this.maxRoutes) {
+                // Fallback to a catch-all for excessive new routes
+                const othersKey = `${log.method} [Other]`;
+                if (!this.stats.routes[othersKey]) {
+                    this.stats.routes[othersKey] = this.createNewRouteStats();
+                }
+                this.updateRouteStats(this.stats.routes[othersKey], log);
+            }
+            else {
+                this.stats.routes[routeKey] = this.createNewRouteStats();
+                this.updateRouteStats(this.stats.routes[routeKey], log);
+            }
+        }
+        else {
+            this.updateRouteStats(this.stats.routes[routeKey], log);
         }
-        const route = this.stats.routes[routeKey];
+        const code = log.statusCode;
+        this.stats.statusCodes[code] = (this.stats.statusCodes[code] || 0) + 1;
+    }
+    createNewRouteStats() {
+        return {
+            count: 0,
+            totalTime: 0,
+            slowCount: 0,
+            highQueryCount: 0,
+            rateLimitHits: 0,
+            avgTime: 0,
+            totalBytes: 0,
+            avgSize: 0,
+        };
+    }
+    updateRouteStats(route, log) {
         route.count++;
-        route.totalTime += entry.responseTime || 0;
+        route.totalTime += log.responseTime;
+        route.totalBytes += log.bytesSent;
         route.avgTime = Math.round(route.totalTime / route.count);
-        if (entry.slow) {
+        route.avgSize = Math.round(route.totalBytes / route.count);
+        if (log.slow) {
+            this.stats.slowRequests++;
             route.slowCount++;
         }
+        if (log.highQueries) {
+            this.stats.highQueryRequests++;
+            route.highQueryCount++;
+        }
     }
     recordSlowRequest() {
         this.stats.slowRequests++;
     }
+    recordRateLimitHit(routeKey, ip, method, path) {
+        this.stats.rateLimitHits++;
+        // Track blocked event details
+        this.blockedEvents.push({
+            ip,
+            path,
+            method,
+            timestamp: Date.now(),
+        });
+        // Keep only last 100 blocked events
+        if (this.blockedEvents.length > 100) {
+            this.blockedEvents.shift();
+        }
+        if (!this.stats.routes[routeKey]) {
+            if (Object.keys(this.stats.routes).length >= this.maxRoutes) {
+                return; // Don't track rate limits for new routes if at capacity
+            }
+            this.stats.routes[routeKey] = this.createNewRouteStats();
+        }
+        this.stats.routes[routeKey].rateLimitHits++;
+    }
     recordCacheHit() {
         this.stats.cacheHits++;
     }
@@ -67,28 +160,51 @@ class MetricsStore {
     setCacheSize(size) {
         this.stats.cacheSize = size;
     }
+    calculateCacheHitRate() {
+        const cacheTotal = this.stats.cacheHits + this.stats.cacheMisses;
+        return cacheTotal > 0
+            ? Math.round((this.stats.cacheHits / cacheTotal) * 100)
+            : 0;
+    }
     /** Get all metrics data for the dashboard. */
     getMetrics() {
         const avgResponseTime = this.stats.totalRequests > 0
             ? Math.round(this.stats.totalResponseTime / this.stats.totalRequests)
             : 0;
-        const cacheTotal = this.stats.cacheHits + this.stats.cacheMisses;
-        const cacheHitRate = cacheTotal > 0
-            ? Math.round((this.stats.cacheHits / cacheTotal) * 100)
-            : 0;
-        return {
+        const mem = process.memoryUsage();
+        const heapStats = v8.getHeapStatistics();
+        const metrics = {
             uptime: Date.now() - this.stats.startTime,
             totalRequests: this.stats.totalRequests,
             avgResponseTime,
             slowRequests: this.stats.slowRequests,
+            highQueryRequests: this.stats.highQueryRequests,
+            rateLimitHits: this.stats.rateLimitHits,
             cacheHits: this.stats.cacheHits,
             cacheMisses: this.stats.cacheMisses,
-            cacheHitRate,
-            cacheSize: this.stats.cacheSize,
+            cacheHitRate: this.calculateCacheHitRate(),
+            cacheSize: 0, // Will be populated in index.ts if cache is enabled
+            totalBytesSent: this.stats.totalBytesSent,
+            avgResponseSize: this.stats.totalRequests > 0
+                ? Math.round(this.stats.totalBytesSent / this.stats.totalRequests)
+                : 0,
+            insights: [], // Placeholder, filled below
+            eventLoopLag: Math.round(this.histogram.mean / 1e6),
+            memoryUsage: {
+                rss: mem.rss,
+                heapTotal: mem.heapTotal,
+                heapUsed: mem.heapUsed,
+                heapLimit: heapStats.heap_size_limit,
+                external: mem.external,
+            },
             statusCodes: { ...this.stats.statusCodes },
             routes: { ...this.stats.routes },
             recentLogs: this.logs.slice(-100),
+            blockedEvents: [...this.blockedEvents],
         };
+        // Generate insights
+        metrics.insights = (0, analyzer_1.analyzeMetrics)(metrics);
+        return metrics;
     }
     /** Reset all metrics. */
     reset() {
@@ -96,12 +212,18 @@ class MetricsStore {
         this.stats.totalRequests = 0;
         this.stats.totalResponseTime = 0;
         this.stats.slowRequests = 0;
+        this.stats.highQueryRequests = 0;
+        this.stats.rateLimitHits = 0;
         this.stats.cacheHits = 0;
         this.stats.cacheMisses = 0;
         this.stats.cacheSize = 0;
         this.stats.statusCodes = {};
         this.stats.routes = {};
         this.stats.startTime = Date.now();
+        this.blockedEvents = [];
+        this.histogram.disable();
+        this.histogram = (0, perf_hooks_1.monitorEventLoopDelay)({ resolution: 10 });
+        this.histogram.enable();
     }
 }
 exports.MetricsStore = MetricsStore;

package/dist/store.js.map

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

package/dist/types.d.ts

@@ -37,6 +37,12 @@ export interface LoggerOptions {
     slowThreshold?: number;
     /** Log to console (default: true) */
     console?: boolean;
+    /** Log to file path (optional) */
+    file?: string;
+    /** Enable automatic daily log rotation (appends YYYY-MM-DD to filename) (default: false) */
+    rotation?: boolean;
+    /** Delete log files older than this many days (default: 7). Requires rotation: true */
+    maxDays?: number;
     /** Custom log formatter */
     formatter?: (entry: LogEntry) => string;
 }
@@ -46,11 +52,35 @@ export interface QueryHelperOptions {
     /** Warn if more than this many queries per request (default: 10) */
     threshold?: number;
 }
+export interface DashboardAuthOptions {
+    /** Admin username (default: 'admin') */
+    username?: string;
+    /** Admin password (default: 'perf-toolkit') */
+    password?: string;
+    /** Secret key for session cookie (default: 'toolkit-secret') */
+    secret?: string;
+}
 export interface DashboardOptions {
     /** Enable dashboard (default: true) */
     enabled?: boolean;
     /** Dashboard mount path (default: '/__perf') */
     path?: string;
+    /** Authentication settings. If provided, user must login to see dashboard. */
+    auth?: DashboardAuthOptions;
+}
+export interface RateLimitOptions {
+    /** Enable rate limiting (default: false) */
+    enabled?: boolean;
+    /** Time window in milliseconds (default: 60000 - 1 minute) */
+    windowMs?: number;
+    /** Maximum number of requests per windowMs (default: 100) */
+    max?: number;
+    /** Response status code (default: 429) */
+    statusCode?: number;
+    /** Response message string or object */
+    message?: string | object;
+    /** URL patterns to exclude from rate limiting (e.g. ['/__perf*']) */
+    exclude?: (string | RegExp)[];
 }
 export interface ToolkitOptions {
     /** Cache configuration — pass true for defaults or an object to customize */
@@ -63,40 +93,102 @@ export interface ToolkitOptions {
     queryHelper?: boolean | QueryHelperOptions;
     /** Performance dashboard */
     dashboard?: boolean | DashboardOptions;
+    /** Rate limiting */
+    rateLimit?: boolean | RateLimitOptions;
     /** Max log entries to keep in memory (default: 1000) */
     maxLogs?: number;
 }
 export interface LogEntry {
     method: string;
     path: string;
+    routePattern?: string;
     statusCode: number;
     responseTime: number;
     timestamp: number;
+    bytesSent: number;
     slow: boolean;
     cached: boolean;
     queryCount?: number;
+    highQueries?: boolean;
     contentLength?: number;
     userAgent?: string;
     ip?: string;
 }
+export interface BlockedEvent {
+    ip: string;
+    path: string;
+    timestamp: number;
+    method: string;
+}
 export interface RouteStats {
     count: number;
     totalTime: number;
     slowCount: number;
+    highQueryCount: number;
+    rateLimitHits: number;
     avgTime: number;
+    totalBytes: number;
+    avgSize: number;
+}
+export interface Insight {
+    type: "info" | "warning" | "error";
+    title: string;
+    message: string;
+    action?: string;
+}
+export interface MetricSnapshot {
+    uptime: number;
+    totalRequests: number;
+    avgResponseTime: number;
+    slowRequests: number;
+    highQueryRequests: number;
+    rateLimitHits: number;
+    cacheHits: number;
+    cacheMisses: number;
+    cacheHitRate: number;
+    cacheSize: number;
+    totalBytesSent: number;
+    avgResponseSize: number;
+    insights: Insight[];
+    eventLoopLag: number;
+    memoryUsage: {
+        rss: number;
+        heapTotal: number;
+        heapUsed: number;
+        heapLimit: number;
+        external: number;
+    };
+    statusCodes: Record<number, number>;
+    routes: Record<string, RouteStats>;
+    recentLogs: LogEntry[];
+    blockedEvents: BlockedEvent[];
 }
 export interface Metrics {
     uptime: number;
     totalRequests: number;
     avgResponseTime: number;
     slowRequests: number;
+    highQueryRequests: number;
+    rateLimitHits: number;
     cacheHits: number;
     cacheMisses: number;
     cacheHitRate: number;
     cacheSize: number;
+    totalBytesSent: number;
+    avgResponseSize: number;
+    insights: Insight[];
+    eventLoopLag: number;
+    memoryUsage: {
+        rss: number;
+        heapTotal: number;
+        heapUsed: number;
+        heapLimit: number;
+        external: number;
+    };
     statusCodes: Record<number, number>;
     routes: Record<string, RouteStats>;
     recentLogs: LogEntry[];
+    blockedEvents: BlockedEvent[];
 }
 export interface CacheEntry {
     body: string | Buffer;
@@ -127,6 +219,7 @@ declare global {
             perfToolkit?: {
                 startTime: number;
                 queryCount: number;
+                highQueries?: boolean;
                 trackQuery: (label?: string) => void;
             };
         }

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAI1D,MAAM,WAAW,YAAY;IAC3B,qCAAqC;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iDAAiD;IACjD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC9B,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,kDAAkD;IAClD,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,yCAAyC;IACzC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,MAAM,CAAC;CACzC;AAED,MAAM,WAAW,kBAAkB;IACjC,6CAA6C;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,uCAAuC;IACvC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,6EAA6E;IAC7E,KAAK,CAAC,EAAE,OAAO,GAAG,YAAY,CAAC;IAC/B,sEAAsE;IACtE,WAAW,CAAC,EAAE,OAAO,GAAG,kBAAkB,CAAC;IAC3C,mEAAmE;IACnE,eAAe,CAAC,EAAE,OAAO,GAAG,aAAa,CAAC;IAC1C,gCAAgC;IAChC,WAAW,CAAC,EAAE,OAAO,GAAG,kBAAkB,CAAC;IAC3C,4BAA4B;IAC5B,SAAS,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAAC;IACvC,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnC,UAAU,EAAE,QAAQ,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,KAAK,EAAE,CAAC,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,UAAU;IAC1C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC/C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAC9D,KAAK,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;IACxD,KAAK,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAClE,OAAO,EAAE,YAAY,CAAC;CACvB;AAID,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,OAAO,CAAC;QAChB,UAAU,OAAO;YACf,WAAW,CAAC,EAAE;gBACZ,SAAS,EAAE,MAAM,CAAC;gBAClB,UAAU,EAAE,MAAM,CAAC;gBACnB,UAAU,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;aACtC,CAAC;SACH;KACF;CACF"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/example/server.ts

@@ -1,5 +1,5 @@
-import express, { Request, Response } from 'express';
-import { performanceToolkit } from '../src/index';
+import express, { Request, Response } from "express";
+import { performanceToolkit } from "../src/index";
 
 const app = express();
 const PORT = 3000;
@@ -7,18 +7,26 @@ const PORT = 3000;
 // ── Initialize Performance Toolkit ──────────────────────────
 const toolkit = performanceToolkit({
   cache: {
-    ttl: 30000,       // 30s cache TTL
+    ttl: 30000, // 30s cache TTL
     maxSize: 50,
-    exclude: ['/api/random', '/__perf'],
+    exclude: ["/api/random", "/__perf"],
   },
   compression: true,
   logSlowRequests: {
-    slowThreshold: 500,  // Flag requests > 500ms as slow
+    slowThreshold: 500, // Flag requests > 500ms as slow
     console: true,
+    file: "logs/performance.log", // Log all requests to this file
+    rotation: true, // Automatically rotate daily
+    maxDays: 7, // Keep 7 days of logs
   },
   queryHelper: {
     threshold: 5,
   },
+  rateLimit: {
+    enabled: true,
+    windowMs: 2 * 60 * 1000, // 2 minutes window
+    max: 10, // 10 requests per window
+  },
   dashboard: true,
 });
 
@@ -26,47 +34,64 @@ const toolkit = performanceToolkit({
 app.use(toolkit.middleware);
 
 // Mount the dashboard
-app.use('/__perf', toolkit.dashboardRouter);
+app.use("/__perf", toolkit.dashboardRouter);
 
 // ── Sample API Routes ───────────────────────────────────────
 
 // Fast route — should be cached after first hit
-app.get('/api/users', (_req: Request, res: Response) => {
+app.get("/api/users", (_req: Request, res: Response) => {
   const users = [
-    { id: 1, name: 'Alice Johnson', email: 'alice@example.com', role: 'admin' },
-    { id: 2, name: 'Bob Smith', email: 'bob@example.com', role: 'user' },
-    { id: 3, name: 'Charlie Brown', email: 'charlie@example.com', role: 'user' },
-    { id: 4, name: 'Diana Prince', email: 'diana@example.com', role: 'moderator' },
-    { id: 5, name: 'Eve Wilson', email: 'eve@example.com', role: 'user' },
+    { id: 1, name: "Alice Johnson", email: "alice@example.com", role: "admin" },
+    { id: 2, name: "Bob Smith", email: "bob@example.com", role: "user" },
+    {
+      id: 3,
+      name: "Charlie Brown",
+      email: "charlie@example.com",
+      role: "user",
+    },
+    {
+      id: 4,
+      name: "Diana Prince",
+      email: "diana@example.com",
+      role: "moderator",
+    },
+    { id: 5, name: "Eve Wilson", email: "eve@example.com", role: "user" },
   ];
   res.json({ users, count: users.length });
 });
 
 // Slow route — simulates a 1.5s delay (triggers slow detection)
-app.get('/api/slow', (_req: Request, res: Response) => {
+app.get("/api/slow", (_req: Request, res: Response) => {
   setTimeout(() => {
     res.json({
-      message: 'This response was intentionally delayed',
-      processingTime: '1500ms',
+      message: "This response was intentionally delayed",
+      processingTime: "1500ms",
     });
   }, 1500);
 });
 
+// Mock brute-force endpoint
+app.get("/api/bruteforce", (_req: Request, res: Response) => {
+  res.json({
+    message: "Try hammering this endpoint! See rate limit in action.",
+  });
+});
+
 // Medium-speed route
-app.get('/api/products', (_req: Request, res: Response) => {
+app.get("/api/products", (_req: Request, res: Response) => {
   setTimeout(() => {
     res.json({
       products: [
-        { id: 1, name: 'Laptop Pro', price: 1299.99, stock: 25 },
-        { id: 2, name: 'Wireless Mouse', price: 29.99, stock: 150 },
-        { id: 3, name: 'USB-C Hub', price: 49.99, stock: 75 },
+        { id: 1, name: "Laptop Pro", price: 1299.99, stock: 25 },
+        { id: 2, name: "Wireless Mouse", price: 29.99, stock: 150 },
+        { id: 3, name: "USB-C Hub", price: 49.99, stock: 75 },
       ],
     });
   }, 300);
 });
 
 // Random data — excluded from cache
-app.get('/api/random', (_req: Request, res: Response) => {
+app.get("/api/random", (_req: Request, res: Response) => {
   res.json({
     value: Math.random(),
     timestamp: Date.now(),
@@ -74,7 +99,7 @@ app.get('/api/random', (_req: Request, res: Response) => {
 });
 
 // Route demonstrating query tracking
-app.get('/api/posts', (req: Request, res: Response) => {
+app.get("/api/posts", (req: Request, res: Response) => {
   // Simulate multiple DB queries (potential N+1)
   const posts = [];
   for (let i = 0; i < 12; i++) {
@@ -89,38 +114,44 @@ app.get('/api/posts', (req: Request, res: Response) => {
 });
 
 // POST route — not cached
-app.post('/api/users', express.json(), (req: Request, res: Response) => {
+app.post("/api/users", express.json(), (req: Request, res: Response) => {
   res.status(201).json({
-    message: 'User created',
+    message: "User created",
     user: req.body,
   });
 });
 
 // Error route
-app.get('/api/error', (_req: Request, _res: Response) => {
-  throw new Error('Something went wrong!');
+app.get("/api/error", (_req: Request, _res: Response) => {
+  throw new Error("Something went wrong!");
 });
 
 // Error handler
-app.use((err: Error, _req: Request, res: Response, _next: express.NextFunction) => {
-  console.error(err.stack);
-  res.status(500).json({ error: err.message });
-});
+app.use(
+  (err: Error, _req: Request, res: Response, _next: express.NextFunction) => {
+    console.error(err.stack);
+    res.status(500).json({ error: err.message });
+  },
+);
 
 // ── Start Server ────────────────────────────────────────────
 app.listen(PORT, () => {
-  console.log('');
-  console.log('  ⚡ Express Performance Toolkit — Example Server');
-  console.log('  ────────────────────────────────────────────────');
+  console.log("");
+  console.log("  ⚡ Express Performance Toolkit — Example Server");
+  console.log("  ────────────────────────────────────────────────");
   console.log(`  🚀 Server:    http://localhost:${PORT}`);
   console.log(`  📊 Dashboard: http://localhost:${PORT}/__perf`);
-  console.log('');
-  console.log('  Try these endpoints:');
+  console.log("");
+  console.log("  Try these endpoints:");
   console.log(`    GET  http://localhost:${PORT}/api/users     (fast, cached)`);
-  console.log(`    GET  http://localhost:${PORT}/api/slow      (slow, triggers alert)`);
+  console.log(
+    `    GET  http://localhost:${PORT}/api/slow      (slow, triggers alert)`,
+  );
   console.log(`    GET  http://localhost:${PORT}/api/products  (medium speed)`);
   console.log(`    GET  http://localhost:${PORT}/api/random    (not cached)`);
-  console.log(`    GET  http://localhost:${PORT}/api/posts     (N+1 query warning)`);
+  console.log(
+    `    GET  http://localhost:${PORT}/api/posts     (N+1 query warning)`,
+  );
   console.log(`    POST http://localhost:${PORT}/api/users     (not cached)`);
-  console.log('');
+  console.log("");
 });