express-performance-toolkit 1.0.0

package/README.md

@@ -0,0 +1,217 @@
+# ⚡ Express Performance Toolkit
+
+A powerful, all-in-one Express middleware that automatically optimizes your app with **request caching**, **response compression**, **slow API detection**, **query optimization helpers**, and a stunning **real-time performance dashboard**.
+
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue)](https://www.typescriptlang.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](./LICENSE)
+
+---
+
+## ✨ Features
+
+- 🚀 **Request Caching** — In-memory LRU cache with TTL (+ optional Redis adapter)
+- 🗜️ **Response Compression** — Gzip/deflate with configurable thresholds
+- 🔥 **Slow API Detection** — Flag & log requests exceeding response time thresholds
+- 🔍 **Query Optimization** — N+1 query detection with `req.perfToolkit.trackQuery()`
+- 📊 **Real-time Dashboard** — Beautiful dark-themed dashboard at `/__perf`
+- 📝 **Structured Logging** — Per-request timing, status codes, cache status
+- 🎯 **Fully Typed** — Written in TypeScript with complete type definitions
+
+---
+
+## 📦 Installation
+
+```bash
+npm install express-performance-toolkit
+```
+
+---
+
+## 🚀 Quick Start
+
+```typescript
+import express from 'express';
+import { performanceToolkit } from 'express-performance-toolkit';
+
+const app = express();
+
+const toolkit = performanceToolkit({
+  cache: true,
+  logSlowRequests: true,
+  dashboard: true,
+});
+
+// Apply the composable middleware
+app.use(toolkit.middleware);
+
+// Mount the performance dashboard
+app.use('/__perf', toolkit.dashboardRouter);
+
+app.get('/api/users', (req, res) => {
+  res.json({ users: [{ id: 1, name: 'Alice' }] });
+});
+
+app.listen(3000, () => {
+  console.log('Server running on http://localhost:3000');
+  console.log('Dashboard at http://localhost:3000/__perf');
+});
+```
+
+---
+
+## ⚙️ Configuration
+
+```typescript
+const toolkit = performanceToolkit({
+  // Cache — boolean or CacheOptions
+  cache: {
+    ttl: 60000,           // Cache TTL in ms (default: 60000)
+    maxSize: 100,         // Max LRU entries (default: 100)
+    methods: ['GET'],     // HTTP methods to cache (default: ['GET'])
+    exclude: ['/health', /^\/admin/], // URL patterns to skip
+    redis: {              // Optional Redis adapter (requires ioredis)
+      host: 'localhost',
+      port: 6379,
+    },
+  },
+
+  // Compression — boolean or CompressionOptions
+  compression: {
+    threshold: 1024,      // Min response size to compress (default: 1024 bytes)
+    level: 6,             // Compression level 1-9 (default: 6)
+  },
+
+  // Logger / Slow Detection — boolean or LoggerOptions
+  logSlowRequests: {
+    slowThreshold: 1000,  // Flag requests slower than this (default: 1000ms)
+    console: true,        // Log to console (default: true)
+    formatter: (entry) => `${entry.method} ${entry.path} ${entry.responseTime}ms`,
+  },
+
+  // Query Helper — boolean or QueryHelperOptions
+  queryHelper: {
+    threshold: 10,        // Warn after this many queries/request (default: 10)
+  },
+
+  // Dashboard — boolean or DashboardOptions
+  dashboard: {
+    path: '/__perf',      // Dashboard mount path (default: '/__perf')
+  },
+
+  maxLogs: 1000,          // Max log entries in memory (default: 1000)
+});
+```
+
+---
+
+## 📊 Dashboard
+
+Access the performance dashboard at `http://localhost:3000/__perf`:
+
+- **Real-time stats** — Total requests, avg response time, slow request count
+- **Cache performance** — Hit/miss ratio donut chart
+- **Status code breakdown** — Visual bar chart
+- **Slowest routes** — Table of routes sorted by average response time
+- **Request log** — Filterable log with timing, cache status, and 🔥 slow flags
+
+### Dashboard API
+
+```
+GET  /__perf              → Dashboard HTML
+GET  /__perf/api/metrics  → JSON metrics snapshot
+POST /__perf/api/reset    → Reset all metrics
+```
+
+---
+
+## 🔍 Query Tracking
+
+Track database queries per request to detect N+1 patterns:
+
+```typescript
+app.get('/api/posts', async (req, res) => {
+  const posts = await db.getPosts();
+
+  for (const post of posts) {
+    req.perfToolkit?.trackQuery(`SELECT comments WHERE post_id=${post.id}`);
+    post.comments = await db.getComments(post.id);
+  }
+
+  res.json(posts);
+});
+// Console: ⚠️  N+1 Alert: GET /api/posts has made 10+ queries
+```
+
+---
+
+## 🏗️ Programmatic API
+
+```typescript
+const toolkit = performanceToolkit({ cache: true });
+
+// Access metrics programmatically
+const metrics = toolkit.getMetrics();
+console.log(metrics.totalRequests, metrics.avgResponseTime);
+
+// Reset metrics
+toolkit.resetMetrics();
+
+// Manual cache control
+toolkit.cache?.clear();
+toolkit.cache?.delete('GET:/api/users');
+```
+
+---
+
+## 🧪 Running Tests
+
+```bash
+npm test
+```
+
+---
+
+## 🏃 Running the Example
+
+```bash
+npx ts-node example/server.ts
+```
+
+Then visit:
+- `http://localhost:3000/api/users` — fast, cached response
+- `http://localhost:3000/api/slow` — triggers slow request alert
+- `http://localhost:3000/__perf` — performance dashboard
+
+---
+
+## 📁 Project Structure
+
+```
+express-performance-toolkit/
+├── src/
+│   ├── index.ts              # Main entrypoint & performanceToolkit()
+│   ├── types.ts              # TypeScript interfaces
+│   ├── store.ts              # Metrics store (ring buffer + counters)
+│   ├── cache.ts              # LRU cache + Redis adapter
+│   ├── compression.ts        # Compression middleware wrapper
+│   ├── logger.ts             # Request timing & slow detection
+│   ├── queryHelper.ts        # N+1 query detection
+│   └── dashboard/
+│       ├── dashboardRouter.ts # Dashboard Express router
+│       └── dashboard.html     # Dashboard UI
+├── tests/
+│   ├── cache.test.ts
+│   ├── store.test.ts
+│   └── integration.test.ts
+├── example/
+│   └── server.ts             # Example Express app
+├── package.json
+├── tsconfig.json
+└── jest.config.js
+```
+
+---
+
+## 📄 License
+
+MIT

package/dist/cache.d.ts

@@ -0,0 +1,25 @@
+import { CacheOptions, CacheEntry, CacheAdapter, CacheMiddleware } from "./types";
+import { MetricsStore } from "./store";
+/**
+ * In-memory LRU cache with TTL support.
+ */
+export declare class LRUCache<T = CacheEntry> implements CacheAdapter<T> {
+    private maxSize;
+    private ttl;
+    private cache;
+    constructor(options?: {
+        maxSize?: number;
+        ttl?: number;
+    });
+    get(key: string): T | null;
+    set(key: string, value: T): void;
+    has(key: string): boolean;
+    delete(key: string): boolean;
+    clear(): void;
+    get size(): number;
+}
+/**
+ * Create cache middleware.
+ */
+export declare function createCacheMiddleware(options?: CacheOptions, store?: MetricsStore): CacheMiddleware;
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AACA,OAAO,EACL,YAAY,EACZ,UAAU,EACV,YAAY,EAEZ,eAAe,EAChB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC;;GAEG;AACH,qBAAa,QAAQ,CAAC,CAAC,GAAG,UAAU,CAAE,YAAW,YAAY,CAAC,CAAC,CAAC;IAC9D,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,KAAK,CAAgC;gBAEjC,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAO;IAM5D,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAgB1B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAehC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AA6CD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,GAAE,YAAiB,EAC1B,KAAK,CAAC,EAAE,YAAY,GACnB,eAAe,CA0GjB"}

package/dist/cache.js

@@ -0,0 +1,182 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LRUCache = void 0;
+exports.createCacheMiddleware = createCacheMiddleware;
+/**
+ * In-memory LRU cache with TTL support.
+ */
+class LRUCache {
+    constructor(options = {}) {
+        this.maxSize = options.maxSize || 100;
+        this.ttl = options.ttl || 60000;
+        this.cache = new Map();
+    }
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry)
+            return null;
+        // Check TTL
+        if (Date.now() - entry.createdAt > this.ttl) {
+            this.cache.delete(key);
+            return null;
+        }
+        // Move to end (most recently used)
+        this.cache.delete(key);
+        this.cache.set(key, entry);
+        return entry.value;
+    }
+    set(key, value) {
+        // Remove oldest if at capacity
+        if (this.cache.size >= this.maxSize && !this.cache.has(key)) {
+            const firstKey = this.cache.keys().next().value;
+            if (firstKey !== undefined) {
+                this.cache.delete(firstKey);
+            }
+        }
+        this.cache.set(key, {
+            value,
+            createdAt: Date.now(),
+        });
+    }
+    has(key) {
+        return this.get(key) !== null;
+    }
+    delete(key) {
+        return this.cache.delete(key);
+    }
+    clear() {
+        this.cache.clear();
+    }
+    get size() {
+        return this.cache.size;
+    }
+}
+exports.LRUCache = LRUCache;
+/**
+ * Create a Redis cache adapter (requires ioredis as peer dependency).
+ */
+function createRedisAdapter(redisConfig) {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const Redis = require("ioredis");
+        const client = new Redis(redisConfig);
+        const prefix = redisConfig.prefix || "ept:";
+        const ttl = redisConfig.ttl || 60;
+        return {
+            async get(key) {
+                const data = await client.get(`${prefix}${key}`);
+                return data ? JSON.parse(data) : null;
+            },
+            async set(key, value) {
+                await client.setex(`${prefix}${key}`, ttl, JSON.stringify(value));
+            },
+            async has(key) {
+                return (await client.exists(`${prefix}${key}`)) === 1;
+            },
+            async delete(key) {
+                await client.del(`${prefix}${key}`);
+            },
+            async clear() {
+                const keys = await client.keys(`${prefix}*`);
+                if (keys.length > 0)
+                    await client.del(...keys);
+            },
+            get size() {
+                return -1; // Cannot easily get size from Redis
+            },
+        };
+    }
+    catch {
+        console.warn("[express-performance-toolkit] ioredis not installed. Falling back to in-memory cache.");
+        return null;
+    }
+}
+/**
+ * Create cache middleware.
+ */
+function createCacheMiddleware(options = {}, store) {
+    const { ttl = 60000, maxSize = 100, exclude = [], redis = null, methods = ["GET"], } = options;
+    let cacheAdapter;
+    if (redis) {
+        const redisAdapter = createRedisAdapter({
+            ...redis,
+            ttl: Math.ceil(ttl / 1000),
+        });
+        cacheAdapter = redisAdapter || new LRUCache({ maxSize, ttl });
+    }
+    else {
+        cacheAdapter = new LRUCache({ maxSize, ttl });
+    }
+    function shouldExclude(url) {
+        return exclude.some((pattern) => {
+            if (pattern instanceof RegExp)
+                return pattern.test(url);
+            return url.includes(pattern);
+        });
+    }
+    function getCacheKey(req) {
+        return `${req.method}:${req.originalUrl || req.url}`;
+    }
+    const handler = async (req, res, next) => {
+        // Only cache specified methods
+        if (!methods.includes(req.method)) {
+            return next();
+        }
+        // Check exclusion patterns
+        const url = req.originalUrl || req.url;
+        if (shouldExclude(url)) {
+            return next();
+        }
+        const key = getCacheKey(req);
+        try {
+            const cached = await cacheAdapter.get(key);
+            if (cached) {
+                if (store)
+                    store.recordCacheHit();
+                const entry = cached;
+                res.set("X-Cache", "HIT");
+                res.set("Content-Type", entry.contentType || "application/json");
+                res.status(entry.statusCode || 200).send(entry.body);
+                return;
+            }
+        }
+        catch {
+            // Cache read failed — continue to handler
+        }
+        if (store)
+            store.recordCacheMiss();
+        res.set("X-Cache", "MISS");
+        // Intercept response to cache it
+        const originalSend = res.send.bind(res);
+        res.send = function (body) {
+            // Only cache successful responses
+            if (res.statusCode >= 200 && res.statusCode < 400) {
+                const entry = {
+                    body: body,
+                    statusCode: res.statusCode,
+                    contentType: res.get("Content-Type"),
+                };
+                try {
+                    cacheAdapter.set(key, entry);
+                    if (store &&
+                        typeof cacheAdapter.size === "number" &&
+                        cacheAdapter.size >= 0) {
+                        store.setCacheSize(cacheAdapter.size);
+                    }
+                }
+                catch {
+                    // Cache write failed — ignore
+                }
+            }
+            return originalSend(body);
+        };
+        next();
+    };
+    // Build the CacheMiddleware with attached control methods
+    const middleware = handler;
+    middleware.clear = () => cacheAdapter.clear();
+    middleware.delete = (key) => cacheAdapter.delete(key);
+    middleware.adapter = cacheAdapter;
+    return middleware;
+}
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

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

package/dist/compression.d.ts

@@ -0,0 +1,7 @@
+import { Request, Response, NextFunction } from 'express';
+import { CompressionOptions } from './types';
+/**
+ * Create compression middleware with sensible defaults.
+ */
+export declare function createCompressionMiddleware(options?: CompressionOptions): (req: Request, res: Response, next: NextFunction) => void;
+//# sourceMappingURL=compression.d.ts.map

package/dist/compression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compression.d.ts","sourceRoot":"","sources":["../src/compression.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAE7C;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,GAAE,kBAAuB,GAC/B,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,KAAK,IAAI,CAe3D"}

package/dist/compression.js

@@ -0,0 +1,26 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCompressionMiddleware = createCompressionMiddleware;
+const compression_1 = __importDefault(require("compression"));
+/**
+ * Create compression middleware with sensible defaults.
+ */
+function createCompressionMiddleware(options = {}) {
+    const { threshold = 1024, level = 6 } = options;
+    return (0, compression_1.default)({
+        threshold,
+        level,
+        filter: (req, res) => {
+            // Don't compress if the client didn't request it
+            if (req.headers['x-no-compression']) {
+                return false;
+            }
+            // Use compression's default filter
+            return compression_1.default.filter(req, res);
+        },
+    });
+}
+//# sourceMappingURL=compression.js.map

package/dist/compression.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compression.js","sourceRoot":"","sources":["../src/compression.ts"],"names":[],"mappings":";;;;;AAOA,kEAiBC;AAvBD,8DAAgD;AAGhD;;GAEG;AACH,SAAgB,2BAA2B,CACzC,UAA8B,EAAE;IAEhC,MAAM,EAAE,SAAS,GAAG,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC;IAEhD,OAAO,IAAA,qBAAqB,EAAC;QAC3B,SAAS;QACT,KAAK;QACL,MAAM,EAAE,CAAC,GAAY,EAAE,GAAa,EAAW,EAAE;YAC/C,iDAAiD;YACjD,IAAI,GAAG,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,CAAC;gBACpC,OAAO,KAAK,CAAC;YACf,CAAC;YACD,mCAAmC;YACnC,OAAO,qBAAqB,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAChD,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}