nestjs-profiler 1.0.21 → 1.0.24

package/README.md

@@ -4,19 +4,27 @@
   <img src="https://raw.githubusercontent.com/MohammedRaslan/Nest-JS-Profiler/refs/heads/main/libs/nestjs-profiler/src/assets/logo.png" width="400" alt="NestJS Profiler Logo" />
 </p>
 
-A NestJS module for profiling HTTP requests, database queries, and cache operations. Inspired by Symfony Profiler, it provides a web-based dashboard to inspect request duration, executed queries, log messages, and explain plans for slow queries.
+A NestJS module for profiling HTTP requests, database queries, cache operations, outbound HTTP calls, and application logs. Inspired by Symfony Profiler, it provides a web-based dashboard to inspect everything that happens inside a request — from DB queries to downstream API calls — in real time.
 
 ## Features
 
-- **HTTP Request Tracing**: Tracks method, URL, controller handler, duration, and status code.
-- **Database Profiling**:
-  - **PostgreSQL**: Captures queries executed via `pg` (compatible with TypeORM, MikroORM, raw pg). Supports **Auto-Explain** to running `EXPLAIN` or `EXPLAIN ANALYZE` on slow queries.
-  - **MongoDB**: Profiles MongoDB commands and queries.
-  - **MySQL**: Profiles MySQL queries.
-- **Cache Profiling**: Tracks cache operations (get, set, del) when using `@nestjs/cache-manager`.
-- **Logger Profiling**: Captures application logs associated with the request context.
-- **Web UI**: Built-in lightweight dashboard at `/__profiler` to view traces.
-- **Zero Hard Dependencies**: Core functionality works out of the box; database drivers are optional peer dependencies.
+- **HTTP Request Tracing** — Tracks method, URL, controller handler, duration, status code, headers, and request body.
+- **Database Profiling**
+  - **PostgreSQL** — Captures all queries via `pg` (compatible with TypeORM, MikroORM, raw pg). Supports **Auto-Explain** to run `EXPLAIN` or `EXPLAIN ANALYZE` on slow queries automatically.
+  - **MongoDB** — Profiles MongoDB commands and queries.
+  - **MySQL** — Profiles MySQL queries.
+  - **N+1 Detection** — Automatically flags repeated identical queries within the same request.
+  - **Slow Query Tagging** — Tags queries exceeding 100ms.
+  - **Sequential Scan Detection** — Tags queries using a Seq Scan from the explain plan.
+- **Outbound HTTP Tracking** — Captures every outbound `http`/`https` call made during a request: URL, method, status code, duration, and headers. Works automatically with axios, node-fetch, and any library built on Node's `http`/`https` modules. Enabled by default — no configuration required.
+- **Cache Profiling** — Tracks cache operations (get, set, del, reset) and hit/miss ratio when using `@nestjs/cache-manager`.
+- **Log Profiling** — Captures application logs associated with each request context.
+- **Live Logs Terminal** — Real-time streaming log viewer at `/__profiler/view/logs/live` via Server-Sent Events. Supports level filtering, search, pause/resume, and auto-scroll.
+- **Summary Dashboard** — Aggregate statistics: avg/p95 duration, error rate, cache hit rate, top slow endpoints, top slow queries, and recent errors.
+- **Entity Explorer** — Lists all registered TypeORM/MikroORM entities and their columns.
+- **Route Explorer** — Lists all registered routes with their controllers and handlers.
+- **Web UI** — Built-in dashboard at `/__profiler` with no external dependencies.
+- **Zero Hard Dependencies** — Core functionality works out of the box; database drivers are optional peer dependencies.
 
 ## Installation
 
@@ -26,7 +34,7 @@ npm install nestjs-profiler
 
 ### Peer Dependencies (Optional)
 
-Install the dependencies relevant to your project:
+Install only the dependencies relevant to your project:
 
 ```bash
 # For PostgreSQL
@@ -44,48 +52,54 @@ npm install @nestjs/cache-manager cache-manager
 
 ## Configuration
 
-Import `ProfilerModule` in your root `AppModule`.
+Import `ProfilerModule` in your root `AppModule`:
 
 ```typescript
 import { Module } from '@nestjs/common';
 import { ProfilerModule } from 'nestjs-profiler';
+import * as pg from 'pg';
 
 @Module({
   imports: [
     ProfilerModule.forRoot({
       // Global enable/disable (default: true)
+      // Recommended: disable in production
       enabled: process.env.NODE_ENV !== 'production',
 
-      // PostgreSQL Profiling
+      // ── Database ─────────────────────────────────────────────────
+      // PostgreSQL — pass the pg driver instance
+      pgDriver: pg,
       collectQueries: true,
+
+      // Auto-Explain for slow queries
       explain: {
         enabled: true,
-        thresholdMs: 50, // Only explain queries taking > 50ms
-        analyze: false, // If true, runs EXPLAIN ANALYZE (execution!)
+        thresholdMs: 50,   // Only explain queries taking > 50ms
+        analyze: false,    // true = EXPLAIN ANALYZE (actually executes!)
       },
-      // Add pgDriver
-      pgDriver: pg,
-
-      // Add mysql2 driver for MySQL profiling
-      mysqlDriver: mysql2,
 
-      // Add mongodb driver for MongoDB profiling
-      mongoDriver: mongodb,
-
-      // MongoDB Profiling (default: true)
+      // MongoDB — pass the mongodb driver instance
+      mongoDriver: require('mongodb'),
       collectMongo: true,
 
-      // MySQL Profiling (default: true)
+      // MySQL — pass the mysql2 driver instance
+      mysqlDriver: require('mysql2'),
       collectMysql: true,
 
-      // Cache Profiling (default: true)
-      collectCache: true,
+      // ── Outbound HTTP ─────────────────────────────────────────────
+      // Tracks all outbound http/https calls made during each request.
+      // Enabled by default — set false to disable.
+      collectHttp: true,
+
+      // ── Cache ─────────────────────────────────────────────────────
+      collectCache: true,   // requires @nestjs/cache-manager
 
-      // Log Profiling (default: true)
+      // ── Logs ──────────────────────────────────────────────────────
       collectLogs: true,
 
-      // Storage backend (default: InMemory)
-      // You can implement custom storage by passing an object implementing ProfilerStorage
+      // ── Storage ───────────────────────────────────────────────────
+      // Default: in-memory (last 100 requests).
+      // Pass a custom object implementing ProfilerStorage for persistence.
       storage: 'memory',
     }),
   ],
@@ -93,14 +107,24 @@ import { ProfilerModule } from 'nestjs-profiler';
 export class AppModule {}
 ```
 
+### Default behaviour
+
+| Option | Default | Notes |
+|---|---|---|
+| `enabled` | `true` | Set `false` or tie to `NODE_ENV` |
+| `collectHttp` | `true` | Patches `http`/`https` automatically |
+| `collectLogs` | `true` | |
+| `collectQueries` | `true` | Requires `pgDriver` / `mongoDriver` / `mysqlDriver` |
+| `collectCache` | `true` | Requires `@nestjs/cache-manager` |
+| `explain.enabled` | `false` | Opt-in only |
+
 ## Usage
 
 ### 1. Initialize Explorers (Optional but Recommended)
 
-To enable the **Entity Explorer** and **Route Explorer** features in the dashboard, initialize the profiler in your `main.ts` file right after creating the application.
+To enable the **Entity Explorer** and **Route Explorer**, call `initialize` in `main.ts` after creating the app:
 
 ```typescript
-// main.ts
 import { NestFactory } from '@nestjs/core';
 import { AppModule } from './app.module';
 import { ProfilerModule } from 'nestjs-profiler';
@@ -108,7 +132,6 @@ import { ProfilerModule } from 'nestjs-profiler';
 async function bootstrap() {
   const app = await NestFactory.create(AppModule);
 
-  // Initialize Profiler Explorers
   ProfilerModule.initialize(app);
 
   await app.listen(3000);
@@ -118,16 +141,68 @@ bootstrap();
 
 ### 2. Accessing the Dashboard
 
-Once configured, start your application. The profiler automatically intercepts requests and queries.
+Once configured, start your application. The profiler automatically intercepts all requests.
+
+Navigate to `http://localhost:3000/__profiler`.
+
+#### Dashboard Pages
+
+| Path | Description |
+|---|---|
+| `/__profiler` | Request list — all captured requests |
+| `/__profiler/view/summary` | Aggregate stats: avg/p95 duration, error rate, top slow endpoints |
+| `/__profiler/view/queries` | All database queries across requests, sorted by duration |
+| `/__profiler/view/http-calls` | All outbound HTTP calls across requests, sorted by duration |
+| `/__profiler/view/logs` | Paginated application logs |
+| `/__profiler/view/logs/live` | Live streaming terminal — real-time log output |
+| `/__profiler/view/cache` | Cache operations with hit/miss breakdown |
+| `/__profiler/view/entities` | Registered database entities |
+| `/__profiler/view/routes` | All registered application routes |
+| `/__profiler/:id` | Full detail view for a single request |
+
+### 3. Outbound HTTP Tracking
+
+Outbound HTTP tracking is **enabled by default**. Any `http.request`, `https.request`, `http.get`, or `https.get` call made during a request is automatically captured — including calls made via axios, node-fetch, and similar libraries.
 
-Navigate to `http://localhost:3000/__profiler` (or your app's port).
+Each captured call records:
 
-### 3. JSON API
+- Method and full URL
+- HTTP vs HTTPS protocol
+- Response status code
+- Duration in ms
+- Request and response headers (Authorization/Cookie values are automatically redacted)
+- Error message if the call failed
+
+You can view outbound calls for a specific request in the request detail view, or browse all calls across all requests at `/__profiler/view/http-calls`.
+
+To disable:
+
+```typescript
+ProfilerModule.forRoot({ collectHttp: false })
+```
+
+### 4. JSON API
+
+Retrieve profile data programmatically:
+
+- `GET /__profiler/json` — List all captured requests
+- `GET /__profiler/:id/json` — Details for a specific request
+
+## Global Prefix
+
+If your app uses a global prefix (e.g. `/api`), exclude the profiler routes:
+
+```typescript
+app.setGlobalPrefix('api', {
+  exclude: [{ path: '__profiler/(.*)', method: RequestMethod.ALL }],
+});
+```
 
-You can also retrieve profile data programmatically:
+## Important Notes
 
-- `GET /__profiler/json` - List recent requests
-- `GET /__profiler/:id/json` - Get details for a specific request
+- The profiler is designed for **development and debugging only**. Do not enable in production — it adds request overhead and exposes internal application data.
+- The default in-memory storage holds the last 100 requests. Older profiles are evicted automatically.
+- Outbound HTTP tracking patches `http`/`https` at the Node.js module level. The patch is applied once on module init and is safe for hot-reload (double-patch is guarded).
 
 ## License
 

package/collectors/http-collector.d.ts

@@ -0,0 +1,12 @@
+import { OnModuleInit } from '@nestjs/common';
+import type { ProfilerOptions } from '../common/profiler-options.interface';
+import { ProfilerService } from '../services/profiler.service';
+export declare class HttpCollector implements OnModuleInit {
+    private readonly profiler;
+    private readonly options;
+    private readonly logger;
+    constructor(profiler: ProfilerService, options: ProfilerOptions);
+    onModuleInit(): void;
+    private patchModule;
+    private sanitiseHeaders;
+}

package/collectors/http-collector.js

@@ -0,0 +1,132 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var HttpCollector_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpCollector = void 0;
+const common_1 = require("@nestjs/common");
+const profiler_service_1 = require("../services/profiler.service");
+const PROFILER_INTERNAL_HEADER = 'x-profiler-internal';
+let HttpCollector = HttpCollector_1 = class HttpCollector {
+    constructor(profiler, options) {
+        this.profiler = profiler;
+        this.options = options;
+        this.logger = new common_1.Logger(HttpCollector_1.name);
+    }
+    onModuleInit() {
+        if (this.options.collectHttp === false)
+            return;
+        const httpMod = require('http');
+        const httpsMod = require('https');
+        this.patchModule(httpMod, 'http');
+        this.patchModule(httpsMod, 'https');
+        this.logger.log('HTTP/HTTPS outbound request tracking enabled');
+    }
+    patchModule(mod, protocol) {
+        if (mod.__profilerPatched)
+            return;
+        mod.__profilerPatched = true;
+        const self = this;
+        const originalRequest = mod.request.bind(mod);
+        const originalGet = mod.get.bind(mod);
+        mod.request = function (...args) {
+            const startTime = Date.now();
+            let method = 'GET';
+            let host = '';
+            let path = '/';
+            let fullUrl = '';
+            let reqHeaders = {};
+            try {
+                const first = args[0];
+                if (typeof first === 'string' || first instanceof URL) {
+                    const u = typeof first === 'string' ? new URL(first) : first;
+                    host = u.hostname + (u.port ? `:${u.port}` : '');
+                    path = u.pathname + u.search;
+                    fullUrl = u.toString();
+                    const opts = (args[1] && typeof args[1] === 'object' && typeof args[1] !== 'function') ? args[1] : {};
+                    method = (opts?.method || 'GET').toUpperCase();
+                    reqHeaders = opts?.headers || {};
+                }
+                else if (first && typeof first === 'object') {
+                    method = (first.method || 'GET').toUpperCase();
+                    host = first.hostname || first.host || 'localhost';
+                    if (first.port && !String(host).includes(':'))
+                        host += `:${first.port}`;
+                    path = first.path || '/';
+                    const defaultPort = protocol === 'https' ? 443 : 80;
+                    const portStr = first.port && first.port !== defaultPort ? `:${first.port}` : '';
+                    fullUrl = `${protocol}://${first.hostname || first.host || 'localhost'}${portStr}${path}`;
+                    reqHeaders = first.headers || {};
+                }
+            }
+            catch (_) { }
+            if (reqHeaders[PROFILER_INTERNAL_HEADER] || fullUrl.includes('/__profiler')) {
+                return originalRequest(...args);
+            }
+            const profile = self.profiler.getCurrentProfile();
+            const req = originalRequest(...args);
+            if (profile) {
+                const httpCall = {
+                    method,
+                    url: fullUrl,
+                    host,
+                    path,
+                    protocol,
+                    startTime,
+                    duration: 0,
+                    requestHeaders: self.sanitiseHeaders(reqHeaders),
+                };
+                req.on('response', (res) => {
+                    httpCall.statusCode = res.statusCode;
+                    httpCall.responseHeaders = self.sanitiseHeaders(res.headers);
+                    res.on('end', () => {
+                        httpCall.duration = Date.now() - startTime;
+                        self.profiler.addHttpCall(httpCall);
+                    });
+                    res.resume();
+                });
+                req.on('error', (err) => {
+                    httpCall.duration = Date.now() - startTime;
+                    httpCall.error = err.message;
+                    self.profiler.addHttpCall(httpCall);
+                });
+            }
+            return req;
+        };
+        mod.get = function (...args) {
+            const req = mod.request(...args);
+            req.end();
+            return req;
+        };
+    }
+    sanitiseHeaders(headers) {
+        const result = {};
+        for (const [k, v] of Object.entries(headers || {})) {
+            const lower = k.toLowerCase();
+            if (lower === 'authorization' || lower === 'cookie' || lower === 'set-cookie') {
+                result[k] = '[redacted]';
+            }
+            else {
+                result[k] = Array.isArray(v) ? v.join(', ') : String(v ?? '');
+            }
+        }
+        return result;
+    }
+};
+exports.HttpCollector = HttpCollector;
+exports.HttpCollector = HttpCollector = HttpCollector_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(1, (0, common_1.Inject)('PROFILER_OPTIONS')),
+    __metadata("design:paramtypes", [profiler_service_1.ProfilerService, Object])
+], HttpCollector);
+//# sourceMappingURL=http-collector.js.map

package/collectors/http-collector.js.map

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

package/collectors/log-collector.d.ts

@@ -7,6 +7,8 @@ export declare class LogCollector implements OnModuleInit {
     private logger;
     constructor(profiler: ProfilerService, options: ProfilerOptions);
     onModuleInit(): void;
+    private stripAnsi;
+    private detectLevel;
+    private parseNestLog;
     private patchProcessStream;
-    private capture;
 }

package/collectors/log-collector.js

@@ -30,6 +30,29 @@ let LogCollector = LogCollector_1 = class LogCollector {
         this.patchProcessStream('stderr');
         this.logger.log('LogCollector initialized: Patching process.stdout/stderr');
     }
+    stripAnsi(str) {
+        return str.replace(/\x1b\[[0-9;]*m/g, '').replace(/\x1b\[[0-9;]*[A-Za-z]/g, '');
+    }
+    detectLevel(raw, fallback) {
+        if (raw.includes('\x1b[31m'))
+            return 'error';
+        if (raw.includes('\x1b[33m'))
+            return 'warn';
+        if (raw.includes('\x1b[95m'))
+            return 'debug';
+        if (raw.includes('\x1b[96m'))
+            return 'verbose';
+        if (raw.includes('\x1b[32m'))
+            return 'log';
+        return fallback;
+    }
+    parseNestLog(clean) {
+        const match = clean.match(/^\[Nest\]\s+\d+\s+-\s+[\d/,: APM]+\s+\w+\s+\[([^\]]+)\]\s+(.+)$/s);
+        if (match)
+            return { context: match[1], message: match[2].trim() };
+        const prefixStripped = clean.replace(/^\[Nest\]\s+\d+\s+-\s+[\d/,: APM]+\s+\w+\s+/, '').trim();
+        return { message: prefixStripped || clean };
+    }
     patchProcessStream(streamName) {
         const stream = process[streamName];
         const originalWrite = stream.write;
@@ -37,25 +60,23 @@ let LogCollector = LogCollector_1 = class LogCollector {
         stream.write = function (chunk, encodingOrCb, cb) {
             const result = originalWrite.apply(this, arguments);
             try {
-                const msg = chunk.toString();
-                if (msg.includes('[LogCollector]'))
+                const raw = chunk.toString();
+                if (raw.includes('[LogCollector]'))
+                    return result;
+                const level = self.detectLevel(raw, streamName === 'stderr' ? 'error' : 'log');
+                const clean = self.stripAnsi(raw).trim();
+                if (!clean)
                     return result;
-                self.capture(streamName === 'stderr' ? 'error' : 'log', msg);
+                const { context, message } = self.parseNestLog(clean);
+                if (!message)
+                    return result;
+                self.profiler.addLog({ level, message, context, timestamp: Date.now() });
             }
             catch (e) {
             }
             return result;
         };
     }
-    capture(level, message) {
-        if (!message.trim())
-            return;
-        this.profiler.addLog({
-            level,
-            message: message.trim(),
-            timestamp: Date.now()
-        });
-    }
 };
 exports.LogCollector = LogCollector;
 exports.LogCollector = LogCollector = LogCollector_1 = __decorate([

package/collectors/log-collector.js.map

@@ -1 +1 @@
-{"version":3,"file":"log-collector.js","sourceRoot":"","sources":["../../../libs/nestjs-profiler/src/collectors/log-collector.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyF;AACzF,mEAA+D;AAIxD,IAAM,YAAY,oBAAlB,MAAM,YAAY;IAGrB,YACY,QAAyB,EACL,OAAgC;QADpD,aAAQ,GAAR,QAAQ,CAAiB;QACG,YAAO,GAAP,OAAO,CAAiB;QAJxD,WAAM,GAAG,IAAI,eAAM,CAAC,cAAY,CAAC,IAAI,CAAC,CAAC;IAK3C,CAAC;IAEL,YAAY;QACR,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,KAAK,KAAK,EAAE,CAAC;YACrC,OAAO;QACX,CAAC;QAED,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QAClC,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,0DAA0D,CAAC,CAAC;IAChF,CAAC;IAEO,kBAAkB,CAAC,UAA+B;QACtD,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QACnC,MAAM,aAAa,GAAG,MAAM,CAAC,KAAK,CAAC;QACnC,MAAM,IAAI,GAAG,IAAI,CAAC;QAElB,MAAM,CAAC,KAAK,GAAG,UACX,KAA0B,EAC1B,YAAuD,EACvD,EAA0B;YAE1B,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,SAAgB,CAAC,CAAC;YAE3D,IAAI,CAAC;gBACD,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAC7B,IAAI,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC;oBAAE,OAAO,MAAM,CAAC;gBAElD,IAAI,CAAC,OAAO,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YACjE,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;YACb,CAAC;YAED,OAAO,MAAM,CAAC;QAClB,CAAC,CAAC;IACN,CAAC;IAEO,OAAO,CAAC,KAAa,EAAE,OAAe;QAC1C,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE;YAAE,OAAO;QAE5B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;YACjB,KAAK;YACL,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE;YACvB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACxB,CAAC,CAAC;IACP,CAAC;CACJ,CAAA;AAnDY,oCAAY;uBAAZ,YAAY;IADxB,IAAA,mBAAU,GAAE;IAMJ,WAAA,IAAA,eAAM,EAAC,kBAAkB,CAAC,CAAA;qCADT,kCAAe;GAJ5B,YAAY,CAmDxB"}
+{"version":3,"file":"log-collector.js","sourceRoot":"","sources":["../../../libs/nestjs-profiler/src/collectors/log-collector.ts"],"names":[],"mappings":"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"}

package/common/profiler-options.interface.d.ts

@@ -16,5 +16,6 @@ export interface ProfilerOptions {
     collectMongo?: boolean;
     collectCache?: boolean;
     collectMysql?: boolean;
+    collectHttp?: boolean;
     explain?: ProfilerExplainOptions;
 }

package/common/profiler.model.d.ts

@@ -31,6 +31,19 @@ export interface CacheProfile {
     startTime: number;
     value?: any;
 }
+export interface HttpCallProfile {
+    method: string;
+    url: string;
+    host: string;
+    path: string;
+    statusCode?: number;
+    duration: number;
+    startTime: number;
+    requestHeaders?: Record<string, string>;
+    responseHeaders?: Record<string, string>;
+    error?: string;
+    protocol: 'http' | 'https';
+}
 export interface RequestProfile {
     id: string;
     method: string;
@@ -52,6 +65,7 @@ export interface RequestProfile {
     queries: QueryProfile[];
     logs: LogProfile[];
     cache?: CacheProfile[];
+    httpCalls?: HttpCallProfile[];
     timestamp: number;
     requestHeaders?: Record<string, any>;
     requestBody?: any;

package/controllers/profiler.controller.d.ts

@@ -24,11 +24,15 @@ export declare class ProfilerController {
     }>;
     detail(id: string, res: Response): Promise<void>;
     detailJson(id: string): Promise<import("..").RequestProfile>;
+    summary(res: Response): Promise<void>;
     listQueries(res: Response): Promise<void>;
     listLogs(res: Response, page?: number): Promise<void>;
     listEntities(res: Response): Promise<void>;
     listRoutes(res: Response): Promise<void>;
     listCache(res: Response): Promise<void>;
+    listHttpCalls(res: Response): Promise<void>;
+    liveLogsPage(res: Response): Promise<void>;
+    liveLogsStream(res: Response): void;
     serveAsset(file: string, res: Response): Promise<void>;
     serveJs(file: string, res: Response): Promise<void>;
 }

package/controllers/profiler.controller.js

@@ -80,6 +80,13 @@ let ProfilerController = class ProfilerController {
             throw new common_1.NotFoundException('Profile not found');
         return profile;
     }
+    async summary(res) {
+        const stats = await this.profilerService.getSummaryStats();
+        const content = this.templateBuilder.buildSummaryPage(stats);
+        const html = this.viewService.renderWithLayout('Summary', content, 'summary');
+        res.header('Content-Type', 'text/html');
+        res.send(html);
+    }
     async listQueries(res) {
         const queries = await this.profilerService.getQueriesList();
         const content = this.templateBuilder.buildQueriesList(queries);
@@ -115,6 +122,57 @@ let ProfilerController = class ProfilerController {
         res.header('Content-Type', 'text/html');
         res.send(html);
     }
+    async listHttpCalls(res) {
+        const calls = await this.profilerService.getHttpCallsList();
+        const content = this.templateBuilder.buildHttpCallsList(calls);
+        const html = this.viewService.renderWithLayout('Outbound HTTP', content, 'http-calls');
+        res.header('Content-Type', 'text/html');
+        res.send(html);
+    }
+    async liveLogsPage(res) {
+        const html = this.viewService.renderWithLayout('Live Logs', this.templateBuilder.buildLiveLogsPage(), 'live-logs');
+        res.header('Content-Type', 'text/html');
+        res.send(html);
+    }
+    liveLogsStream(res) {
+        res.setHeader('Content-Type', 'text/event-stream');
+        res.setHeader('Cache-Control', 'no-cache');
+        res.setHeader('Connection', 'keep-alive');
+        res.setHeader('X-Accel-Buffering', 'no');
+        res.flushHeaders();
+        this.profilerService.logEmitter.setMaxListeners(this.profilerService.logEmitter.getMaxListeners() + 1);
+        res.write(`data: ${JSON.stringify({ level: 'system', message: 'Stream connected', timestamp: Date.now() })}\n\n`);
+        let batch = [];
+        let batchTimer = null;
+        const flush = () => {
+            batchTimer = null;
+            if (batch.length === 0 || res.writableEnded)
+                return;
+            const payload = batch.splice(0);
+            res.write(`data: ${JSON.stringify(payload)}\n\n`);
+            if (typeof res.flush === 'function')
+                res.flush();
+        };
+        const onLog = (log) => {
+            if (res.writableEnded)
+                return;
+            batch.push(log);
+            if (!batchTimer)
+                batchTimer = setTimeout(flush, 50);
+        };
+        const heartbeat = setInterval(() => {
+            if (!res.writableEnded)
+                res.write(': heartbeat\n\n');
+        }, 15_000);
+        this.profilerService.logEmitter.on('log', onLog);
+        res.on('close', () => {
+            clearInterval(heartbeat);
+            if (batchTimer)
+                clearTimeout(batchTimer);
+            this.profilerService.logEmitter.off('log', onLog);
+            this.profilerService.logEmitter.setMaxListeners(Math.max(1, this.profilerService.logEmitter.getMaxListeners() - 1));
+        });
+    }
     async serveAsset(file, res) {
         const fs = require('fs');
         const path = require('path');
@@ -191,6 +249,13 @@ __decorate([
     __metadata("design:paramtypes", [String]),
     __metadata("design:returntype", Promise)
 ], ProfilerController.prototype, "detailJson", null);
+__decorate([
+    (0, common_1.Get)('view/summary'),
+    __param(0, (0, common_1.Res)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], ProfilerController.prototype, "summary", null);
 __decorate([
     (0, common_1.Get)('view/queries'),
     __param(0, (0, common_1.Res)()),
@@ -227,6 +292,27 @@ __decorate([
     __metadata("design:paramtypes", [Object]),
     __metadata("design:returntype", Promise)
 ], ProfilerController.prototype, "listCache", null);
+__decorate([
+    (0, common_1.Get)('view/http-calls'),
+    __param(0, (0, common_1.Res)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], ProfilerController.prototype, "listHttpCalls", null);
+__decorate([
+    (0, common_1.Get)('view/logs/live'),
+    __param(0, (0, common_1.Res)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], ProfilerController.prototype, "liveLogsPage", null);
+__decorate([
+    (0, common_1.Get)('logs/stream'),
+    __param(0, (0, common_1.Res)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", void 0)
+], ProfilerController.prototype, "liveLogsStream", null);
 __decorate([
     (0, common_1.Get)('assets/:file'),
     __param(0, (0, common_1.Param)('file')),