@epic-js/express-profiler 0.1.0

package/README.md

@@ -0,0 +1,30 @@
+# express-profiler
+
+Lightweight Express API profiler with route, middleware, DB, and external API timing.
+
+## Installation
+```bash
+npm install express-profiler
+```
+
+## Usage
+```js
+const express = require('express');
+const expressProfiler = require('express-profiler');
+const { wrapAsync } = require('express-profiler/wrappers');
+
+const app = express();
+app.use(expressProfiler());
+
+app.get('/users', async (req, res) => {
+  const users = await wrapAsync(async () => [{ id: 1, name: 'Alice' }], 'DB', req)();
+  res.send(users);
+});
+
+app.listen(3000);
+```
+
+## CLI Usage
+```
+express-profiler-cli logs.json
+```

package/cli.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+const fs = require('fs');
+
+const logs = JSON.parse(fs.readFileSync(process.argv[2], 'utf8'));
+logs.forEach(log => {
+  console.log(`${log.route} ${log.status} ${log.total.toFixed(1)}ms`);
+  Object.entries(log.timings).forEach(([k, v]) => console.log(`  ${k}: ${v.toFixed(1)}ms`));
+});

package/examples/express-app.js

@@ -0,0 +1,45 @@
+const express = require('express');
+const expressProfiler = require('../index');
+const { wrapAsync } = require('../wrappers');
+
+const app = express();
+
+// ----- Middleware example -----
+app.use((req, res, next) => {
+  const start = Date.now();
+  // Simulate middleware work
+  setTimeout(() => {
+    if (req._profiler) req._profiler.timings['customMiddleware'] = Date.now() - start;
+    next();
+  }, 50);
+});
+
+// Attach profiler
+app.use(expressProfiler());
+
+// ----- Fast route -----
+app.get('/users', async (req, res) => {
+  const users = await wrapAsync(async () => [{ id: 1, name: 'Alice' }], 'DB', req)();
+  res.send(users);
+});
+
+// ----- Slow route with multiple async tasks -----
+app.get('/slow', async (req, res) => {
+  const dbTask = wrapAsync(() => new Promise(r => setTimeout(r, 300)), 'DB', req);
+  const apiTask = wrapAsync(() => new Promise(r => setTimeout(r, 200)), 'External API', req);
+
+  await dbTask();
+  await apiTask();
+  res.send('Slow route done');
+});
+
+// ----- Route with nested async -----
+app.get('/nested', async (req, res) => {
+  await wrapAsync(async () => {
+    await wrapAsync(() => new Promise(r => setTimeout(r, 100)), 'Inner DB', req)();
+  }, 'Outer wrapper', req)();
+  res.send('Nested async done');
+});
+
+// ----- Start server -----
+app.listen(3000, () => console.log('Server running on http://localhost:3000'));

package/index.js

@@ -0,0 +1,21 @@
+const profiler = require('./profiler');
+
+module.exports = function expressProfiler(options = {}) {
+  return function (req, res, next) {
+    const start = process.hrtime.bigint();
+
+    req._profiler = { timings: {} };
+
+    res.on('finish', () => {
+      const end = process.hrtime.bigint();
+      const totalMs = Number(end - start) / 1e6;
+      req._profiler.totalMs = totalMs;
+
+      if (options.log !== false) {
+        console.log(profiler.format(req));
+      }
+    });
+
+    next();
+  };
+};

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@epic-js/express-profiler",
+  "version": "0.1.0",
+  "description": "Lightweight Express API profiler with route/middleware/async timing",
+  "main": "index.js",
+  "bin": {
+    "express-profiler-cli": "./cli.js"
+  },
+  "scripts": {
+    "start": "node examples/express-app.js"
+  },
+  "keywords": [
+    "express",
+    "profiler",
+    "api",
+    "middleware",
+    "performance",
+    "express-profiler",
+    "epicprofiler",
+    "epic profiler"
+  ],
+  "author": "Rajgowthaman Rajendran",
+  "license": "MIT",
+  "dependencies": {
+    "express": "^5.2.1"
+  }
+}

package/profiler.js

@@ -0,0 +1,11 @@
+function format(req) {
+  const route = req.method + ' ' + req.originalUrl;
+  const total = req._profiler.totalMs.toFixed(1);
+  const details = Object.entries(req._profiler.timings)
+    .map(([k, v]) => `  ${k}: ${v.toFixed(1)}ms`)
+    .join('\n');
+
+  return `${route} ${req.res.statusCode || 200} ${total}ms\n${details}`;
+}
+
+module.exports = { format };

package/wrappers.js

@@ -0,0 +1,16 @@
+function wrapAsync(fn, label, req) {
+  return async (...args) => {
+    const start = process.hrtime.bigint();
+    const result = await fn(...args);
+    const end = process.hrtime.bigint();
+
+    if (req && req._profiler) {
+      const ms = Number(end - start) / 1e6;
+      req._profiler.timings[label] = ms;
+    }
+
+    return result;
+  };
+}
+
+module.exports = { wrapAsync };