nestjs-profiler 1.0.25 → 1.0.26

package/README.md

@@ -4,7 +4,7 @@
   <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, cache operations, outbound HTTP calls, application logs, package health, and code quality. 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.
+A NestJS module for profiling HTTP requests, database queries, cache operations, outbound HTTP calls, application logs, package health, code quality, and event tracking. 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
 
@@ -22,9 +22,11 @@ A NestJS module for profiling HTTP requests, database queries, cache operations,
 - **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.
+- **Route Explorer** — Lists all registered routes with their controllers, handlers, HTTP methods, and full path. Each route expands to show path parameters, query parameters, request headers, and body DTOs — including the DTO class name, all decorated properties, and their TypeScript types. Source file paths are shown with a one-click copy button.
+- **Dashboard Authentication** — Optional login wall protecting all `/__profiler` routes. When enabled, an HMAC-signed token is stored in the browser's `localStorage` with a 24-hour TTL. Credentials are defined in `ProfilerModule.forRoot()` — no separate auth server required.
 - **Package Health** — Runs `npm audit` and `npm outdated` to surface known vulnerabilities and stale dependencies. Results are cached for 5 minutes. Works with npm, yarn, and pnpm. If the registry is unreachable, outdated packages are still shown with an inline warning.
 - **Code Quality** — Runs ESLint and TypeScript compiler checks (`tsc --noEmit`) against your source code. Issues are displayed grouped by file or by rule, with direct links to ESLint rule docs and TypeScript error references. Auto-fixable issues are flagged. File paths are copyable with one click.
+- **Event Tracking** — Automatically intercepts every `EventEmitter2` emission and builds a cascading tree showing which service fired each event, which listeners handled it (with individual timings), and any child events emitted from inside a listener. No instrumentation required — works automatically when `@nestjs/event-emitter` is installed.
 - **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.
 
@@ -103,6 +105,16 @@ import * as pg from 'pg';
       // Default: in-memory (last 100 requests).
       // Pass a custom object implementing ProfilerStorage for persistence.
       storage: 'memory',
+
+      // ── Dashboard Auth ────────────────────────────────────────────
+      // Disabled by default. When enabled, all /__profiler routes
+      // require login. username + password are both required when
+      // enabled — a TypeScript type error is raised if either is missing.
+      auth: {
+        enabled: true,
+        username: 'admin',
+        password: 'supersecret',
+      },
     }),
   ],
 })
@@ -119,6 +131,8 @@ export class AppModule {}
 | `collectQueries` | `true` | Requires `pgDriver` / `mongoDriver` / `mysqlDriver` |
 | `collectCache` | `true` | Requires `@nestjs/cache-manager` |
 | `explain.enabled` | `false` | Opt-in only |
+| Event Tracking | automatic | Active when `@nestjs/event-emitter` is detected |
+| `auth.enabled` | `false` | When `true`, `username` and `password` are required |
 
 ## Usage
 
@@ -163,9 +177,40 @@ Navigate to `http://localhost:3000/__profiler`.
 | `/__profiler/view/routes` | All registered application routes |
 | `/__profiler/view/health` | Package vulnerabilities and outdated dependency report |
 | `/__profiler/view/code-quality` | ESLint and TypeScript static analysis report |
+| `/__profiler/view/events` | Event tracking — cascading tree of all `EventEmitter2` emissions |
 | `/__profiler/:id` | Full detail view for a single request |
 
-### 3. Outbound HTTP Tracking
+### 3. Dashboard Authentication
+
+By default the profiler dashboard is open to anyone who can reach the server. For shared or remote environments you can enable a login wall:
+
+```typescript
+ProfilerModule.forRoot({
+  auth: {
+    enabled: true,
+    username: 'admin',
+    password: 'supersecret',
+  },
+})
+```
+
+TypeScript enforces that `username` and `password` are both present when `enabled: true` — setting `enabled: true` without credentials is a compile-time error.
+
+**How it works:**
+
+When auth is enabled, every `/__profiler` page runs a blocking script before rendering. If no valid token is found in `localStorage`, the browser is immediately redirected to `/__profiler/login`. After a successful login the token is stored in `localStorage.__profiler_auth` and is valid for 24 hours, after which the user is redirected to the login page again.
+
+Token generation uses HMAC-SHA256 keyed on the password, so tokens are invalidated automatically if the password changes.
+
+| Route | Description |
+|---|---|
+| `GET /__profiler/login` | Login page |
+| `POST /__profiler/api/login` | JSON login endpoint — returns `{ token, expiresAt }` |
+| `GET /__profiler/logout` | Clears the token and redirects to the login page |
+
+> **Note:** Auth is enforced client-side via `localStorage`. It is intended to prevent casual access in shared dev/staging environments, not as a security boundary for sensitive data. Do not expose the profiler on a public network regardless of this setting.
+
+### 4. 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.
 
@@ -186,7 +231,7 @@ To disable:
 ProfilerModule.forRoot({ collectHttp: false })
 ```
 
-### 4. Package Health
+### 5. Package Health
 
 The Health tab runs `npm audit` and `npm outdated` from your project root and displays the results in a searchable UI.
 
@@ -203,7 +248,7 @@ GET /__profiler/api/health           # cached result (5 min TTL)
 GET /__profiler/api/health?force=true  # force fresh scan
 ```
 
-### 5. Code Quality
+### 6. Code Quality
 
 The Code Quality tab runs static analysis tools against your source code and surfaces every issue without AI or external services.
 
@@ -229,7 +274,76 @@ GET /__profiler/api/code-quality             # cached result (5 min TTL)
 GET /__profiler/api/code-quality?force=true  # force fresh scan
 ```
 
-### 6. JSON API
+### 7. Event Tracking
+
+The Event Tracking tab captures every `EventEmitter2` emission across your application and renders it as a cascading tree — no instrumentation required.
+
+**What it captures:**
+
+- The event name and a JSON preview of the payload
+- Which service or function fired the event (resolved from the call stack)
+- Each listener that handled the event, with individual execution times and pass/fail status
+- Child events emitted from inside a listener, forming a full cascade tree
+- The depth of each event in the chain (root = 0, emitted by a listener = 1, etc.)
+- Whether the event was fired synchronously (`emit`) or asynchronously (`emitAsync`)
+- Any errors thrown by a listener
+
+**Example chain visualised:**
+
+```
+🔔 order.created  (async)  ⬆ OrderService.createOrder  145ms
+  ✓ onOrderCreated [InventoryListener]   45ms
+  ✓ onOrderCreated [InvoiceListener]     80ms
+  ✓ onOrderCreated [AuditListener]        5ms
+    └── 🔔 inventory.reserved  (async)  ⬆ InventoryListener.onOrderCreated  23ms
+          ✓ onInventoryReserved [NotificationListener]  20ms
+          ✓ onInventoryReserved [AuditListener]          3ms
+    └── 🔔 invoice.created  (async)  ⬆ InvoiceListener.onOrderCreated  4ms
+          ✓ onInvoiceCreated [AuditListener]   3ms
+```
+
+**Requirements:** `@nestjs/event-emitter` must be installed and `EventEmitterModule.forRoot()` must be imported in your `AppModule`. The profiler detects it automatically — no configuration needed.
+
+The page has an **Auto-refresh** toggle that polls every 3 seconds, making it easy to watch events flow in real time as you hit your endpoints.
+
+Results are not cached — each refresh fetches the latest events from the in-memory ring buffer (last 500 events).
+
+#### JSON endpoint
+
+```
+GET /__profiler/api/events   # all captured events (flat array, newest first)
+```
+
+### 8. Route Explorer
+
+The Route Explorer (`/__profiler/view/routes`) lists every registered route in your application. Routes are grouped by controller and displayed in an expandable accordion. Call `ProfilerModule.initialize(app)` in `main.ts` to populate it (see section 1).
+
+**Per-route information:**
+
+Each route row shows the HTTP method badge and the full path (including any global prefix). Expanding a row reveals:
+
+- **Path parameters** — parameters from the URL pattern (`:id`, `:userId`, etc.), detected either from `@Param('name')` decorators or by scanning the path template directly.
+- **Query parameters** — parameters decorated with `@Query()`, with their TypeScript type.
+- **Headers** — parameters decorated with `@Headers()`, with their TypeScript type.
+- **Request body** — the DTO class name from `@Body()`, with an expanded table of all decorated properties and their types. Properties are discovered via `reflect-metadata` — any class using `class-validator`, `@ApiProperty`, or any other property decorator will have its fields listed automatically.
+- **Source file** — the `.ts` file path of the DTO class, with a one-click copy button, making it easy to jump to the type definition from the profiler.
+
+**Example — what gets surfaced:**
+
+```
+POST /api/v1/orders/:storeId
+  Path params   storeId       string
+  Query params  includeVat    boolean
+  Body (DTO)    CreateOrderDto
+                  items       array
+                  couponCode  string
+                  metadata    object
+                src/orders/dto/create-order.dto.ts  [copy]
+```
+
+The explorer performs a best-effort scan using `reflect-metadata`. It works with TypeScript's `emitDecoratorMetadata: true` (standard for NestJS projects) and does not require OpenAPI/Swagger to be installed.
+
+### 9. JSON API
 
 Retrieve profile data programmatically:
 

package/collectors/event-collector.d.ts

@@ -0,0 +1,18 @@
+import { OnModuleInit } from '@nestjs/common';
+import { ProfilerService } from '../services/profiler.service';
+export declare class EventCollector implements OnModuleInit {
+    private readonly profilerService;
+    private readonly eventEmitter?;
+    private resolvedListenerNames;
+    private readonly listenerRegistrationCounters;
+    constructor(profilerService: ProfilerService, eventEmitter?: any | undefined);
+    setListenerNames(map: Map<string, Array<{
+        name: string;
+        file: string;
+    }>>): void;
+    onModuleInit(): void;
+    private patchEmitter;
+    private buildProfile;
+    private serializePayload;
+    private getCallerLocation;
+}

package/collectors/event-collector.js

@@ -0,0 +1,254 @@
+"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 __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 __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;
+    };
+})();
+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); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventCollector = void 0;
+const common_1 = require("@nestjs/common");
+const async_hooks_1 = require("async_hooks");
+const crypto = __importStar(require("crypto"));
+const profiler_service_1 = require("../services/profiler.service");
+function resolveEE2Token() {
+    try {
+        const resolved = require.resolve('@nestjs/event-emitter', {
+            paths: [process.cwd()],
+        });
+        return require(resolved).EventEmitter2;
+    }
+    catch {
+        try {
+            return require('@nestjs/event-emitter').EventEmitter2;
+        }
+        catch {
+            return Symbol('PROFILER_NO_EVENT_EMITTER');
+        }
+    }
+}
+const EE2_TOKEN = resolveEE2Token();
+const eventALS = new async_hooks_1.AsyncLocalStorage();
+let EventCollector = class EventCollector {
+    constructor(profilerService, eventEmitter) {
+        this.profilerService = profilerService;
+        this.eventEmitter = eventEmitter;
+        this.resolvedListenerNames = new Map();
+        this.listenerRegistrationCounters = new Map();
+    }
+    setListenerNames(map) {
+        this.resolvedListenerNames = map;
+    }
+    onModuleInit() {
+        if (this.eventEmitter) {
+            this.patchEmitter(this.eventEmitter);
+        }
+    }
+    patchEmitter(emitter) {
+        if (emitter.__profilerPatched)
+            return;
+        emitter.__profilerPatched = true;
+        const self = this;
+        const makeWrappedListener = (fn, eventName, listenerIndex) => {
+            const eagerName = (fn.name || '')
+                .replace(/^bound /, '')
+                .replace(/^async /, '')
+                .trim();
+            return async function profilerListener(...args) {
+                const resolvedInfo = self.resolvedListenerNames.get(eventName)?.[listenerIndex];
+                const listenerName = resolvedInfo?.name || eagerName || `handler-${listenerIndex + 1}`;
+                const listenerFile = resolvedInfo?.file || '';
+                const trace = {
+                    name: listenerName,
+                    file: listenerFile,
+                    startTime: Date.now(),
+                    duration: 0,
+                    status: 'success',
+                };
+                try {
+                    const result = await fn(...args);
+                    trace.duration = Date.now() - trace.startTime;
+                    self.profilerService.addListenerTrace(eventALS.getStore()?.eventId, trace);
+                    return result;
+                }
+                catch (e) {
+                    trace.duration = Date.now() - trace.startTime;
+                    trace.status = 'error';
+                    trace.error = e?.message ?? String(e);
+                    self.profilerService.addListenerTrace(eventALS.getStore()?.eventId, trace);
+                    throw e;
+                }
+            };
+        };
+        const origOn = emitter.on.bind(emitter);
+        const origOnce = emitter.once.bind(emitter);
+        const origPrepend = emitter.prependListener
+            ? emitter.prependListener.bind(emitter)
+            : null;
+        emitter.on = function (event, fn, options) {
+            const idx = self.listenerRegistrationCounters.get(String(event)) ?? 0;
+            self.listenerRegistrationCounters.set(String(event), idx + 1);
+            return origOn(event, makeWrappedListener(fn, String(event), idx), options);
+        };
+        emitter.addListener = emitter.on;
+        emitter.once = function (event, fn, options) {
+            const idx = self.listenerRegistrationCounters.get(String(event)) ?? 0;
+            self.listenerRegistrationCounters.set(String(event), idx + 1);
+            return origOnce(event, makeWrappedListener(fn, String(event), idx), options);
+        };
+        if (origPrepend) {
+            emitter.prependListener = function (event, fn, options) {
+                const idx = self.listenerRegistrationCounters.get(String(event)) ?? 0;
+                self.listenerRegistrationCounters.set(String(event), idx + 1);
+                return origPrepend(event, makeWrappedListener(fn, String(event), idx), options);
+            };
+        }
+        const origEmit = emitter.emit.bind(emitter);
+        emitter.emit = function (event, ...args) {
+            if (typeof event !== 'string')
+                return origEmit(event, ...args);
+            const profile = self.buildProfile(event, args, false);
+            return eventALS.run({ eventId: profile.id, depth: profile.depth }, () => {
+                try {
+                    const result = origEmit(event, ...args);
+                    self.profilerService.finalizeEvent(profile.id, 'success');
+                    return result;
+                }
+                catch (e) {
+                    self.profilerService.finalizeEvent(profile.id, 'error', e?.message);
+                    throw e;
+                }
+            });
+        };
+        const origEmitAsync = emitter.emitAsync?.bind(emitter);
+        if (origEmitAsync) {
+            emitter.emitAsync = async function (event, ...args) {
+                if (typeof event !== 'string')
+                    return origEmitAsync(event, ...args);
+                const profile = self.buildProfile(event, args, true);
+                return eventALS.run({ eventId: profile.id, depth: profile.depth }, async () => {
+                    try {
+                        const result = await origEmitAsync(event, ...args);
+                        self.profilerService.finalizeEvent(profile.id, 'success');
+                        return result;
+                    }
+                    catch (e) {
+                        self.profilerService.finalizeEvent(profile.id, 'error', e?.message);
+                        throw e;
+                    }
+                });
+            };
+        }
+    }
+    buildProfile(eventName, args, isAsync) {
+        const parent = eventALS.getStore();
+        const depth = parent ? parent.depth + 1 : 0;
+        const profile = {
+            id: crypto.randomUUID(),
+            eventName,
+            payloadPreview: this.serializePayload(args[0]),
+            emittedAt: Date.now(),
+            isAsync,
+            ...this.getCallerLocation(),
+            listeners: [],
+            totalDuration: 0,
+            status: 'pending',
+            parentEventId: parent?.eventId,
+            requestId: this.profilerService.getCurrentRequestId(),
+            depth,
+            childEventIds: [],
+        };
+        if (parent?.eventId) {
+            this.profilerService.linkChildEvent(parent.eventId, profile.id);
+        }
+        this.profilerService.addEvent(profile);
+        return profile;
+    }
+    serializePayload(payload) {
+        try {
+            const str = JSON.stringify(payload);
+            if (!str)
+                return '';
+            return str.length > 200 ? str.slice(0, 200) + '…' : str;
+        }
+        catch {
+            return '[unserializable]';
+        }
+    }
+    getCallerLocation() {
+        const lines = (new Error().stack ?? '').split('\n').slice(1);
+        const skip = [
+            'event-collector',
+            'EventCollector',
+            'profilerListener',
+            'AsyncLocalStorage',
+            'node:',
+            'eventemitter2',
+            'node_modules/@nestjs/event-emitter',
+        ];
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (skip.some((s) => trimmed.includes(s)))
+                continue;
+            const m = trimmed.match(/^at (.+?)\s+\((.+?):(\d+):\d+\)/);
+            if (m) {
+                const name = m[1];
+                if (!name.startsWith('Object.') && name !== 'Function') {
+                    return { emitterLocation: name, emitterFile: `${m[2]}:${m[3]}` };
+                }
+            }
+            const anon = trimmed.match(/^at (.+?):(\d+):\d+$/);
+            if (anon && !anon[1].startsWith('node:')) {
+                return { emitterLocation: anon[1], emitterFile: `${anon[1]}:${anon[2]}` };
+            }
+        }
+        return { emitterLocation: 'unknown', emitterFile: '' };
+    }
+};
+exports.EventCollector = EventCollector;
+exports.EventCollector = EventCollector = __decorate([
+    (0, common_1.Injectable)(),
+    __param(1, (0, common_1.Optional)()),
+    __param(1, (0, common_1.Inject)(EE2_TOKEN)),
+    __metadata("design:paramtypes", [profiler_service_1.ProfilerService, Object])
+], EventCollector);
+//# sourceMappingURL=event-collector.js.map

package/collectors/event-collector.js.map

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

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

@@ -5,6 +5,13 @@ export interface ProfilerExplainOptions {
     thresholdMs?: number;
 }
 export type ProfilerStorageType = 'memory' | ProfilerStorage;
+export type ProfilerAuth = {
+    enabled: false;
+} | {
+    enabled: true;
+    username: string;
+    password: string;
+};
 export interface ProfilerOptions {
     enabled?: boolean;
     storage?: ProfilerStorageType;
@@ -18,4 +25,5 @@ export interface ProfilerOptions {
     collectMysql?: boolean;
     collectHttp?: boolean;
     explain?: ProfilerExplainOptions;
+    auth?: ProfilerAuth;
 }

package/common/profiler.model.d.ts

@@ -44,6 +44,31 @@ export interface HttpCallProfile {
     error?: string;
     protocol: 'http' | 'https';
 }
+export interface EventListenerTrace {
+    name: string;
+    duration: number;
+    startTime: number;
+    status: 'success' | 'error';
+    error?: string;
+    file?: string;
+}
+export interface EventProfile {
+    id: string;
+    eventName: string;
+    payloadPreview: string;
+    emittedAt: number;
+    isAsync: boolean;
+    emitterLocation: string;
+    emitterFile: string;
+    listeners: EventListenerTrace[];
+    totalDuration: number;
+    status: 'pending' | 'success' | 'error';
+    error?: string;
+    parentEventId?: string;
+    requestId?: string;
+    depth: number;
+    childEventIds: string[];
+}
 export interface RequestProfile {
     id: string;
     method: string;

package/controllers/profiler.controller.d.ts

@@ -6,6 +6,7 @@ import { EntityExplorerService } from '../services/entity-explorer.service';
 import { RouteExplorerService } from '../services/route-explorer.service';
 import { HealthService } from '../services/health.service';
 import { CodeQualityService } from '../services/code-quality.service';
+import { ProfilerOptions } from '../common/profiler-options.interface';
 export declare class ProfilerController {
     private readonly profilerService;
     private readonly viewService;
@@ -14,7 +15,10 @@ export declare class ProfilerController {
     private readonly routeExplorer;
     private readonly healthService;
     private readonly codeQualityService;
-    constructor(profilerService: ProfilerService, viewService: ViewService, templateBuilder: TemplateBuilderService, entityExplorer: EntityExplorerService, routeExplorer: RouteExplorerService, healthService: HealthService, codeQualityService: CodeQualityService);
+    private readonly profilerOptions;
+    constructor(profilerService: ProfilerService, viewService: ViewService, templateBuilder: TemplateBuilderService, entityExplorer: EntityExplorerService, routeExplorer: RouteExplorerService, healthService: HealthService, codeQualityService: CodeQualityService, profilerOptions: ProfilerOptions);
+    private get authEnabled();
+    private renderLayout;
     dashboard(res: Response): Promise<void>;
     requestsList(res: Response): Promise<void>;
     listJson(): Promise<import("..").RequestProfile[]>;
@@ -27,6 +31,12 @@ export declare class ProfilerController {
         message: string;
         tip: string;
     }>;
+    loginPage(res: Response, returnTo?: string): Promise<void>;
+    apiLogin(res: Response, body: {
+        username?: string;
+        password?: string;
+    }): Promise<void>;
+    logout(res: Response): Promise<void>;
     detail(id: string, res: Response): Promise<void>;
     detailJson(id: string): Promise<import("..").RequestProfile>;
     summary(res: Response): Promise<void>;
@@ -40,6 +50,8 @@ export declare class ProfilerController {
     healthAudit(force?: string): Promise<import("../services/health.service").HealthReport>;
     codeQualityPage(res: Response): Promise<void>;
     codeQualityAudit(force?: string): Promise<import("../services/code-quality.service").CodeQualityReport>;
+    eventsPage(res: Response): Promise<void>;
+    eventsApi(): Promise<import("..").EventProfile[]>;
     liveLogsPage(res: Response): Promise<void>;
     liveLogsStream(res: Response): void;
     serveAsset(file: string, res: Response): Promise<void>;