adonisjs-server-stats 1.4.0 → 1.5.2

package/README.md

@@ -19,16 +19,16 @@ Zero frontend dependencies. Zero build step. Just `@serverStats()` and go.
 
 **Debug toolbar** -- expandable panels for deep inspection:
 
-| Queries | Events |
-|---------|--------|
+| Queries                                                                                                                                                                  | Events                                                                                                                                                             |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | ![Queries panel showing SQL queries with duration and model info](https://raw.githubusercontent.com/simulieren/adonisjs-server-stats/main/screenshots/debug-queries.png) | ![Events panel showing application events with payload data](https://raw.githubusercontent.com/simulieren/adonisjs-server-stats/main/screenshots/debug-events.png) |
 
-| Routes | Logs |
-|--------|------|
+| Routes                                                                                                                                                            | Logs                                                                                                                                                              |
+| ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | ![Routes panel showing all registered routes with handlers](https://raw.githubusercontent.com/simulieren/adonisjs-server-stats/main/screenshots/debug-routes.png) | ![Logs panel with level filtering and request ID correlation](https://raw.githubusercontent.com/simulieren/adonisjs-server-stats/main/screenshots/debug-logs.png) |
 
-| Emails (custom pane) |
-|----------------------|
+| Emails (custom pane)                                                                                                                                           |
+| -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | ![Emails panel showing sent emails with delivery status](https://raw.githubusercontent.com/simulieren/adonisjs-server-stats/main/screenshots/debug-emails.png) |
 
 ## Features
@@ -74,9 +74,7 @@ providers: [
 
 ```ts
 // start/kernel.ts
-server.use([
-  () => import('adonisjs-server-stats/middleware'),
-])
+server.use([() => import('adonisjs-server-stats/middleware')])
 ```
 
 ### 3. Create config
@@ -87,11 +85,7 @@ import { defineConfig } from 'adonisjs-server-stats'
 import { processCollector, systemCollector, httpCollector } from 'adonisjs-server-stats/collectors'
 
 export default defineConfig({
-  collectors: [
-    processCollector(),
-    systemCollector(),
-    httpCollector(),
-  ],
+  collectors: [processCollector(), systemCollector(), httpCollector()],
 })
 ```
 
@@ -165,16 +159,13 @@ export default defineConfig({
 })
 ```
 
-### 4. Add a route
+### 4. Add routes
 
-```ts
-// start/routes.ts
-router
-  .get('/admin/api/server-stats', '#controllers/admin/server_stats_controller.index')
-  .use(middleware.superadmin()) // Replace with your own middleware
-```
+The package has three layers of functionality, each with its own routes:
+
+#### Stats bar API route (required)
 
-### 5. Create the controller
+The stats bar polls this endpoint for live metrics. Create a controller and route:
 
 ```ts
 // app/controllers/admin/server_stats_controller.ts
@@ -184,13 +175,154 @@ import type { StatsEngine } from 'adonisjs-server-stats'
 
 export default class ServerStatsController {
   async index({ response }: HttpContext) {
-    const engine = await app.container.make('server_stats.engine') as StatsEngine
+    const engine = (await app.container.make('server_stats.engine')) as StatsEngine
     return response.json(engine.getLatestStats())
   }
 }
 ```
 
-### 6. Render the stats bar
+```ts
+// start/routes.ts
+router
+  .get('/admin/api/server-stats', '#controllers/admin/server_stats_controller.index')
+  .use(middleware.superadmin())
+```
+
+> The route path must match `endpoint` in your config (default: `/admin/api/server-stats`).
+
+#### Debug toolbar routes (optional -- when `devToolbar.enabled: true`)
+
+The debug toolbar panels fetch data from these API endpoints. Create a controller and routes:
+
+```ts
+// app/controllers/admin/debug_controller.ts
+import app from '@adonisjs/core/services/app'
+import type { HttpContext } from '@adonisjs/core/http'
+import type { DebugStore } from 'adonisjs-server-stats/debug'
+
+export default class DebugController {
+  private async getStore(): Promise<DebugStore | null> {
+    try {
+      return (await app.container.make('debug.store')) as DebugStore
+    } catch {
+      return null
+    }
+  }
+
+  async queries({ response }: HttpContext) {
+    const store = await this.getStore()
+    if (!store) return response.notFound({ error: 'Debug toolbar not enabled' })
+    return response.json({ queries: store.queries.getLatest(500), summary: store.queries.getSummary() })
+  }
+
+  async events({ response }: HttpContext) {
+    const store = await this.getStore()
+    if (!store) return response.notFound({ error: 'Debug toolbar not enabled' })
+    return response.json({ events: store.events.getLatest(200), total: store.events.getTotalCount() })
+  }
+
+  async routes({ response }: HttpContext) {
+    const store = await this.getStore()
+    if (!store) return response.notFound({ error: 'Debug toolbar not enabled' })
+    return response.json({ routes: store.routes.getRoutes(), total: store.routes.getRouteCount() })
+  }
+
+  async logs({ response }: HttpContext) {
+    const store = await this.getStore()
+    if (!store) return response.notFound({ error: 'Debug toolbar not enabled' })
+    return response.json({ logs: store.logs.getLatest(500), total: store.logs.getTotalCount() })
+  }
+
+  async emails({ response }: HttpContext) {
+    const store = await this.getStore()
+    if (!store) return response.notFound({ error: 'Debug toolbar not enabled' })
+    const emails = store.emails.getLatest(100)
+    const stripped = emails.map(({ html, text, ...rest }) => rest)
+    return response.json({ emails: stripped, total: store.emails.getTotalCount() })
+  }
+
+  async emailPreview({ params, response }: HttpContext) {
+    const store = await this.getStore()
+    if (!store) return response.notFound({ error: 'Debug toolbar not enabled' })
+    const html = store.emails.getEmailHtml(Number(params.id))
+    if (!html) return response.notFound({ error: 'Email not found' })
+    return response.header('Content-Type', 'text/html; charset=utf-8').send(html)
+  }
+
+  async traces({ response }: HttpContext) {
+    const store = await this.getStore()
+    if (!store) return response.notFound({ error: 'Debug toolbar not enabled' })
+    if (!store.traces) return response.json({ traces: [], total: 0 })
+    const traces = store.traces.getLatest(100)
+    const list = traces.map(({ spans, warnings, ...rest }: any) => ({
+      ...rest,
+      warningCount: warnings.length,
+    }))
+    return response.json({ traces: list, total: store.traces.getTotalCount() })
+  }
+
+  async traceDetail({ params, response }: HttpContext) {
+    const store = await this.getStore()
+    if (!store) return response.notFound({ error: 'Debug toolbar not enabled' })
+    if (!store.traces) return response.notFound({ error: 'Tracing not enabled' })
+    const trace = store.traces.getTrace(Number(params.id))
+    if (!trace) return response.notFound({ error: 'Trace not found' })
+    return response.json(trace)
+  }
+}
+```
+
+```ts
+// start/routes.ts
+router
+  .group(() => {
+    router.get('queries', '#controllers/admin/debug_controller.queries')
+    router.get('events', '#controllers/admin/debug_controller.events')
+    router.get('routes', '#controllers/admin/debug_controller.routes')
+    router.get('logs', '#controllers/admin/debug_controller.logs')
+    router.get('emails', '#controllers/admin/debug_controller.emails')
+    router.get('emails/:id/preview', '#controllers/admin/debug_controller.emailPreview')
+    router.get('traces', '#controllers/admin/debug_controller.traces')
+    router.get('traces/:id', '#controllers/admin/debug_controller.traceDetail')
+  })
+  .prefix('/admin/api/debug')
+  .use(middleware.superadmin())
+```
+
+#### Dashboard routes (automatic -- when `devToolbar.dashboard: true`)
+
+The full-page dashboard at `/__stats` **registers its own routes automatically** -- no manual route setup needed. The following routes are created under the configured `dashboardPath` (default: `/__stats`):
+
+| Method | Path | Description |
+|--------|------|-------------|
+| GET | `/` | Dashboard page (HTML) |
+| GET | `/api/overview` | Overview metrics |
+| GET | `/api/overview/chart` | Time-series chart data |
+| GET | `/api/requests` | Paginated request history |
+| GET | `/api/requests/:id` | Request detail with queries/trace |
+| GET | `/api/queries` | Paginated query list |
+| GET | `/api/queries/grouped` | Queries grouped by normalized SQL |
+| GET | `/api/queries/:id/explain` | EXPLAIN plan for a query |
+| GET | `/api/events` | Paginated event list |
+| GET | `/api/routes` | Route table |
+| GET | `/api/logs` | Paginated log entries |
+| GET | `/api/emails` | Paginated email list |
+| GET | `/api/emails/:id/preview` | Email HTML preview |
+| GET | `/api/traces` | Paginated trace list |
+| GET | `/api/traces/:id` | Trace detail with spans |
+| GET | `/api/cache` | Cache stats and key listing |
+| GET | `/api/cache/:key` | Cache key detail |
+| GET | `/api/jobs` | Job queue overview |
+| GET | `/api/jobs/:id` | Job detail |
+| POST | `/api/jobs/:id/retry` | Retry a failed job |
+| GET | `/api/config` | App config (secrets redacted) |
+| GET | `/api/filters` | Saved filters |
+| POST | `/api/filters` | Create saved filter |
+| DELETE | `/api/filters/:id` | Delete saved filter |
+
+All dashboard routes are gated by the `shouldShow` callback if configured.
+
+### 5. Render the stats bar
 
 **Edge** (add before `</body>`):
 
@@ -204,36 +336,36 @@ export default class ServerStatsController {
 
 ### `ServerStatsConfig`
 
-| Option        | Type                   | Default                     | Description                                |
-|---------------|------------------------|-----------------------------|--------------------------------------------|
-| `intervalMs`  | `number`               | `3000`                      | Collection + broadcast interval (ms)       |
-| `transport`   | `'transmit' \| 'none'` | `'transmit'`                | SSE transport. `'none'` = poll-only.       |
-| `channelName` | `string`               | `'admin/server-stats'`      | Transmit channel name                      |
-| `endpoint`    | `string \| false`      | `'/admin/api/server-stats'` | HTTP endpoint. `false` to disable.         |
-| `collectors`  | `MetricCollector[]`    | `[]`                        | Array of collector instances                |
-| `skipInTest`  | `boolean`              | `true`                      | Skip collection during tests               |
-| `onStats`     | `(stats) => void`      | --                          | Callback after each collection tick        |
-| `shouldShow`  | `(ctx) => boolean`     | --                          | Per-request visibility guard               |
-| `devToolbar`  | `DevToolbarOptions`    | --                          | Dev toolbar configuration                  |
+| Option        | Type                   | Default                     | Description                          |
+| ------------- | ---------------------- | --------------------------- | ------------------------------------ |
+| `intervalMs`  | `number`               | `3000`                      | Collection + broadcast interval (ms) |
+| `transport`   | `'transmit' \| 'none'` | `'transmit'`                | SSE transport. `'none'` = poll-only. |
+| `channelName` | `string`               | `'admin/server-stats'`      | Transmit channel name                |
+| `endpoint`    | `string \| false`      | `'/admin/api/server-stats'` | HTTP endpoint. `false` to disable.   |
+| `collectors`  | `MetricCollector[]`    | `[]`                        | Array of collector instances         |
+| `skipInTest`  | `boolean`              | `true`                      | Skip collection during tests         |
+| `onStats`     | `(stats) => void`      | --                          | Callback after each collection tick  |
+| `shouldShow`  | `(ctx) => boolean`     | --                          | Per-request visibility guard         |
+| `devToolbar`  | `DevToolbarOptions`    | --                          | Dev toolbar configuration            |
 
 ### `DevToolbarOptions`
 
-| Option                 | Type            | Default | Description                                    |
-|------------------------|-----------------|---------|------------------------------------------------|
-| `enabled`              | `boolean`       | `false` | Enable the dev toolbar                         |
-| `maxQueries`           | `number`        | `500`   | Max SQL queries to buffer                      |
-| `maxEvents`            | `number`        | `200`   | Max events to buffer                           |
-| `maxEmails`            | `number`        | `100`   | Max emails to buffer                           |
-| `slowQueryThresholdMs` | `number`        | `100`   | Slow query threshold (ms)                      |
-| `persistDebugData`     | `boolean \| string` | `false` | Persist debug data to disk across restarts. `true` writes to `.adonisjs/server-stats/debug-data.json`, or pass a custom path. |
-| `tracing`              | `boolean`       | `false` | Enable per-request tracing with timeline visualization |
-| `maxTraces`            | `number`        | `200`   | Max request traces to buffer                   |
-| `dashboard`            | `boolean`       | `false` | Enable the full-page dashboard (requires `better-sqlite3`) |
-| `dashboardPath`        | `string`        | `'/__stats'` | URL path for the dashboard page           |
-| `retentionDays`        | `number`        | `7`     | Days to keep historical data in SQLite         |
-| `dbPath`               | `string`        | `'.adonisjs/server-stats/dashboard.sqlite3'` | Path to the SQLite database file (relative to app root) |
-| `excludeFromTracing`   | `string[]`      | `[]`    | URL prefixes to exclude from tracing and dashboard persistence. Requests still count toward HTTP metrics but won't appear in the timeline or be stored. The stats endpoint is always excluded automatically. |
-| `panes`                | `DebugPane[]`   | --      | Custom debug panel tabs                        |
+| Option                 | Type                | Default                                      | Description                                                                                                                                                                                                  |
+| ---------------------- | ------------------- | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `enabled`              | `boolean`           | `false`                                      | Enable the dev toolbar                                                                                                                                                                                       |
+| `maxQueries`           | `number`            | `500`                                        | Max SQL queries to buffer                                                                                                                                                                                    |
+| `maxEvents`            | `number`            | `200`                                        | Max events to buffer                                                                                                                                                                                         |
+| `maxEmails`            | `number`            | `100`                                        | Max emails to buffer                                                                                                                                                                                         |
+| `slowQueryThresholdMs` | `number`            | `100`                                        | Slow query threshold (ms)                                                                                                                                                                                    |
+| `persistDebugData`     | `boolean \| string` | `false`                                      | Persist debug data to disk across restarts. `true` writes to `.adonisjs/server-stats/debug-data.json`, or pass a custom path.                                                                                |
+| `tracing`              | `boolean`           | `false`                                      | Enable per-request tracing with timeline visualization                                                                                                                                                       |
+| `maxTraces`            | `number`            | `200`                                        | Max request traces to buffer                                                                                                                                                                                 |
+| `dashboard`            | `boolean`           | `false`                                      | Enable the full-page dashboard (requires `better-sqlite3`)                                                                                                                                                   |
+| `dashboardPath`        | `string`            | `'/__stats'`                                 | URL path for the dashboard page                                                                                                                                                                              |
+| `retentionDays`        | `number`            | `7`                                          | Days to keep historical data in SQLite                                                                                                                                                                       |
+| `dbPath`               | `string`            | `'.adonisjs/server-stats/dashboard.sqlite3'` | Path to the SQLite database file (relative to app root)                                                                                                                                                      |
+| `excludeFromTracing`   | `string[]`          | `['/admin/api/debug', '/admin/api/server-stats']`                                         | URL prefixes to exclude from tracing and dashboard persistence. Requests still count toward HTTP metrics but won't appear in the timeline or be stored. The stats endpoint is always excluded automatically. |
+| `panes`                | `DebugPane[]`       | --                                           | Custom debug panel tabs                                                                                                                                                                                      |
 
 ---
 
@@ -243,27 +375,27 @@ Each collector is a factory function that returns a `MetricCollector`. All colle
 
 ### Built-in Collectors
 
-| Collector                | Metrics                                                     | Options    | Peer Deps           |
-|--------------------------|-------------------------------------------------------------|------------|---------------------|
-| `processCollector()`     | CPU %, event loop lag, heap/RSS memory, uptime, Node version | none       | --                  |
-| `systemCollector()`      | OS load averages, system memory, system uptime               | none       | --                  |
-| `httpCollector(opts?)`   | Requests/sec, avg response time, error rate, active connections | optional | --                  |
-| `dbPoolCollector(opts?)` | Pool used/free/pending/max connections                       | optional   | `@adonisjs/lucid`   |
-| `redisCollector()`       | Status, memory, clients, keys, hit rate                      | none       | `@adonisjs/redis`   |
-| `queueCollector(opts)`   | Active/waiting/delayed/failed jobs, worker count             | **required** | `bullmq`          |
-| `logCollector(opts)`     | Errors/warnings/entries (5m window), entries/minute           | **required** | --                |
-| `appCollector()`         | Online users, pending webhooks, pending emails               | none       | `@adonisjs/lucid`   |
+| Collector                | Metrics                                                         | Options      | Peer Deps         |
+| ------------------------ | --------------------------------------------------------------- | ------------ | ----------------- |
+| `processCollector()`     | CPU %, event loop lag, heap/RSS memory, uptime, Node version    | none         | --                |
+| `systemCollector()`      | OS load averages, system memory, system uptime                  | none         | --                |
+| `httpCollector(opts?)`   | Requests/sec, avg response time, error rate, active connections | optional     | --                |
+| `dbPoolCollector(opts?)` | Pool used/free/pending/max connections                          | optional     | `@adonisjs/lucid` |
+| `redisCollector()`       | Status, memory, clients, keys, hit rate                         | none         | `@adonisjs/redis` |
+| `queueCollector(opts)`   | Active/waiting/delayed/failed jobs, worker count                | **required** | `bullmq`          |
+| `logCollector(opts)`     | Errors/warnings/entries (5m window), entries/minute             | **required** | --                |
+| `appCollector()`         | Online users, pending webhooks, pending emails                  | none         | `@adonisjs/lucid` |
 
 ### Collector Options
 
 ```ts
 httpCollector({
-  maxRecords: 10_000,  // Circular buffer size (default: 10,000)
-  windowMs: 60_000,    // Rolling window for rate calc (default: 60s)
+  maxRecords: 10_000, // Circular buffer size (default: 10,000)
+  windowMs: 60_000, // Rolling window for rate calc (default: 60s)
 })
 
 dbPoolCollector({
-  connectionName: 'postgres',  // Lucid connection name (default: 'postgres')
+  connectionName: 'postgres', // Lucid connection name (default: 'postgres')
 })
 
 queueCollector({
@@ -305,7 +437,7 @@ function diskCollector(): MetricCollector {
 export default defineConfig({
   collectors: [
     processCollector(),
-    diskCollector(),  // mix with built-in collectors
+    diskCollector(), // mix with built-in collectors
   ],
 })
 ```
@@ -369,6 +501,7 @@ The `@serverStats()` Edge tag renders a self-contained stats bar with inline HTM
 ```
 
 Features:
+
 - Polls the stats API at the configured interval
 - Color-coded thresholds (green/amber/red)
 - SVG sparkline charts with gradient fills
@@ -392,37 +525,32 @@ export default defineConfig({
     maxEvents: 200,
     maxEmails: 100,
     slowQueryThresholdMs: 100,
-    persistDebugData: true,  // or a custom path: 'custom/debug.json'
-    tracing: true,           // enable per-request timeline
+    persistDebugData: true, // or a custom path: 'custom/debug.json'
+    tracing: true, // enable per-request timeline
   },
 })
 ```
 
-Register the debug API routes:
-
-```ts
-// start/routes.ts
-router
-  .group(() => {
-    router.get('queries', '#controllers/admin/debug_controller.queries')
-    router.get('events', '#controllers/admin/debug_controller.events')
-    router.get('routes', '#controllers/admin/debug_controller.routes')
-    router.get('emails', '#controllers/admin/debug_controller.emails')
-    router.get('emails/:id/preview', '#controllers/admin/debug_controller.emailPreview')
-    router.get('traces', '#controllers/admin/debug_controller.traces')
-    router.get('traces/:id', '#controllers/admin/debug_controller.traceDetail')
-  })
-  .prefix('/admin/api/debug')
-  .use(middleware.admin())
-```
+Register the debug API routes (see [step 4](#4-add-routes) for the full controller and route setup).
 
 ### Built-in Emails Tab
 
 The debug toolbar captures all emails sent via AdonisJS mail (`mail:sending`, `mail:sent`, `mail:queued`, `queued:mail:error` events). Click any email row to preview its HTML in an iframe.
 
+> **Note:** Email previews are rendered in an iframe. If your app uses `@adonisjs/shield` with the default `X-Frame-Options: DENY` header, the preview will be blocked. Change it to `SAMEORIGIN` in your shield config:
+>
+> ```ts
+> // config/shield.ts
+> xFrame: {
+>   enabled: true,
+>   action: 'SAMEORIGIN',
+> },
+> ```
+
 ### Persistent Debug Data
 
 Enable `persistDebugData: true` to save queries, events, and emails to `.adonisjs/server-stats/debug-data.json`. You can also pass a custom path (relative to app root) like `persistDebugData: 'custom/debug.json'`. Data is:
+
 - **Loaded** on server startup (before collectors start)
 - **Flushed** every 30 seconds (handles crashes)
 - **Saved** on graceful shutdown
@@ -449,14 +577,14 @@ GET /organizations/create    286ms
 
 #### Span categories
 
-| Category | Color  | Auto-captured |
-|----------|--------|---------------|
-| DB       | Purple | `db:query` events |
+| Category | Color  | Auto-captured          |
+| -------- | ------ | ---------------------- |
+| DB       | Purple | `db:query` events      |
 | Request  | Blue   | Full request lifecycle |
-| Mail     | Green  | -- |
-| Event    | Amber  | -- |
-| View     | Cyan   | -- |
-| Custom   | Gray   | Via `trace()` helper |
+| Mail     | Green  | --                     |
+| Event    | Amber  | --                     |
+| View     | Cyan   | --                     |
+| Custom   | Gray   | Via `trace()` helper   |
 
 #### Custom spans
 
@@ -527,19 +655,19 @@ devToolbar: {
 
 #### Dashboard Sections
 
-| Section    | Description |
-|------------|-------------|
-| **Overview** | Performance cards (avg/p95 response time, req/min, error rate) with sparkline charts and configurable time ranges (1h/6h/24h/7d) |
-| **Requests** | Paginated request history with method, URL, status, duration. Click for detail view with associated queries and trace |
+| Section      | Description                                                                                                                                             |
+| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Overview** | Performance cards (avg/p95 response time, req/min, error rate) with sparkline charts and configurable time ranges (1h/6h/24h/7d)                        |
+| **Requests** | Paginated request history with method, URL, status, duration. Click for detail view with associated queries and trace                                   |
 | **Queries**  | All captured SQL queries with duration, model, connection. Grouped view shows query patterns by normalized SQL. EXPLAIN plan support for SELECT queries |
-| **Events**   | Application events captured from the AdonisJS emitter |
-| **Routes**   | Full route table with methods, patterns, handlers, and middleware stacks |
-| **Logs**     | Log history with level filtering, text search, and structured JSON field search (e.g. filter by `userId = 5`) |
-| **Emails**   | Email history with sender, recipient, subject, status. Click for HTML preview in iframe |
-| **Timeline** | Per-request waterfall timeline (requires `tracing: true`) |
-| **Cache**    | Redis key browser with SCAN-based listing, type-aware detail view, and server stats (requires `@adonisjs/redis`) |
-| **Jobs**     | Queue overview with job listing, detail, and retry for failed jobs (requires `@rlanz/bull-queue`) |
-| **Config**   | Sanitized view of app configuration and environment variables. Secrets are auto-redacted |
+| **Events**   | Application events captured from the AdonisJS emitter                                                                                                   |
+| **Routes**   | Full route table with methods, patterns, handlers, and middleware stacks                                                                                |
+| **Logs**     | Log history with level filtering, text search, and structured JSON field search (e.g. filter by `userId = 5`)                                           |
+| **Emails**   | Email history with sender, recipient, subject, status. Click for HTML preview in iframe                                                                 |
+| **Timeline** | Per-request waterfall timeline (requires `tracing: true`)                                                                                               |
+| **Cache**    | Redis key browser with SCAN-based listing, type-aware detail view, and server stats (requires `@adonisjs/redis`)                                        |
+| **Jobs**     | Queue overview with job listing, detail, and retry for failed jobs (requires `@rlanz/bull-queue`)                                                       |
+| **Config**   | Sanitized view of app configuration and environment variables. Secrets are auto-redacted                                                                |
 
 #### Access Control
 
@@ -562,12 +690,14 @@ When the dashboard is enabled, the debug panel gains link icons on query, event,
 #### Real-Time Updates
 
 The dashboard supports real-time updates via two mechanisms:
+
 - **Transmit (SSE)**: If `@adonisjs/transmit` is installed, the dashboard subscribes to `server-stats/dashboard` for live overview updates
 - **Polling fallback**: If Transmit is not available, the dashboard polls the API at a configurable interval
 
 #### Data Storage
 
 The dashboard uses a dedicated SQLite database (separate from your app's database) with 8 tables prefixed with `server_stats_`. The database is:
+
 - **Auto-migrated** on startup (no manual migration step)
 - **Self-contained** -- uses its own Knex connection, never touches your app's migration history
 - **Self-cleaning** -- old data is automatically purged based on `retentionDays`
@@ -640,40 +770,40 @@ async webhooks({ response }: HttpContext) {
 
 #### `DebugPane` Options
 
-| Option      | Type                | Default | Description                                  |
-|-------------|---------------------|---------|----------------------------------------------|
-| `id`        | `string`            | --      | Unique identifier (also default data key)    |
-| `label`     | `string`            | --      | Tab display name                             |
-| `endpoint`  | `string`            | --      | API endpoint URL                             |
-| `columns`   | `DebugPaneColumn[]` | --      | Column definitions                           |
-| `search`    | `{ placeholder }`   | --      | Enable search bar                            |
-| `dataKey`   | `string`            | `id`    | JSON key for data array (dot notation OK)    |
-| `fetchOnce` | `boolean`           | `false` | Cache after first fetch                      |
-| `clearable` | `boolean`           | `false` | Show Clear button                            |
+| Option      | Type                | Default | Description                               |
+| ----------- | ------------------- | ------- | ----------------------------------------- |
+| `id`        | `string`            | --      | Unique identifier (also default data key) |
+| `label`     | `string`            | --      | Tab display name                          |
+| `endpoint`  | `string`            | --      | API endpoint URL                          |
+| `columns`   | `DebugPaneColumn[]` | --      | Column definitions                        |
+| `search`    | `{ placeholder }`   | --      | Enable search bar                         |
+| `dataKey`   | `string`            | `id`    | JSON key for data array (dot notation OK) |
+| `fetchOnce` | `boolean`           | `false` | Cache after first fetch                   |
+| `clearable` | `boolean`           | `false` | Show Clear button                         |
 
 #### `DebugPaneColumn` Options
 
-| Option          | Type                     | Default  | Description                              |
-|-----------------|--------------------------|----------|------------------------------------------|
-| `key`           | `string`                 | --       | JSON field name                          |
-| `label`         | `string`                 | --       | Column header text                       |
-| `width`         | `string`                 | auto     | CSS width (e.g. `'60px'`)               |
-| `format`        | `DebugPaneFormatType`    | `'text'` | Cell format (see table below)            |
-| `searchable`    | `boolean`                | `false`  | Include in search filtering              |
-| `filterable`    | `boolean`                | `false`  | Click to set as search filter            |
-| `badgeColorMap` | `Record<string, string>` | --       | Value-to-color map for `badge` format    |
+| Option          | Type                     | Default  | Description                           |
+| --------------- | ------------------------ | -------- | ------------------------------------- |
+| `key`           | `string`                 | --       | JSON field name                       |
+| `label`         | `string`                 | --       | Column header text                    |
+| `width`         | `string`                 | auto     | CSS width (e.g. `'60px'`)             |
+| `format`        | `DebugPaneFormatType`    | `'text'` | Cell format (see table below)         |
+| `searchable`    | `boolean`                | `false`  | Include in search filtering           |
+| `filterable`    | `boolean`                | `false`  | Click to set as search filter         |
+| `badgeColorMap` | `Record<string, string>` | --       | Value-to-color map for `badge` format |
 
 #### Format Types
 
-| Format     | Renders As                             | Expected Input          |
-|------------|----------------------------------------|-------------------------|
-| `text`     | Escaped plain text                     | any                     |
-| `time`     | `HH:MM:SS.mmm`                        | Unix timestamp (ms)     |
-| `timeAgo`  | `3s ago`, `2m ago`                     | Unix timestamp (ms)     |
-| `duration` | `X.XXms` with color coding             | number (ms)             |
-| `method`   | HTTP method pill badge                 | `'GET'`, `'POST'`, etc. |
-| `json`     | Compact preview, click to expand       | object or array         |
-| `badge`    | Colored pill via `badgeColorMap`       | string                  |
+| Format     | Renders As                       | Expected Input          |
+| ---------- | -------------------------------- | ----------------------- |
+| `text`     | Escaped plain text               | any                     |
+| `time`     | `HH:MM:SS.mmm`                   | Unix timestamp (ms)     |
+| `timeAgo`  | `3s ago`, `2m ago`               | Unix timestamp (ms)     |
+| `duration` | `X.XXms` with color coding       | number (ms)             |
+| `method`   | HTTP method pill badge           | `'GET'`, `'POST'`, etc. |
+| `json`     | Compact preview, click to expand | object or array         |
+| `badge`    | Colored pill via `badgeColorMap` | string                  |
 
 Badge colors: `green`, `amber`, `red`, `blue`, `purple`, `muted`
 
@@ -704,6 +834,7 @@ Gauges are updated automatically on each collection tick.
 The log stream module watches a JSON log file and broadcasts new entries via Transmit (SSE).
 
 **Two purposes:**
+
 1. Provides error/warning counts to the stats bar via `logCollector()`
 2. Broadcasts individual log entries to a Transmit channel via `LogStreamProvider`
 
@@ -778,7 +909,6 @@ import type {
   QueueRedisConnection,
   LogCollectorOptions,
 } from 'adonisjs-server-stats/collectors'
-
 ```
 
 ---
@@ -787,16 +917,16 @@ import type {
 
 All integrations use lazy `import()` -- missing peer deps won't crash the app. The corresponding collector simply returns defaults.
 
-| Dependency                  | Required By                                    |
-|-----------------------------|------------------------------------------------|
-| `@adonisjs/core`            | Everything (required)                          |
-| `@adonisjs/lucid`           | `dbPoolCollector`, `appCollector`, dashboard    |
-| `@adonisjs/redis`           | `redisCollector`, dashboard cache inspector    |
-| `@adonisjs/transmit`        | Provider (SSE broadcast), dashboard real-time  |
-| `@julr/adonisjs-prometheus` | `serverStatsCollector`                         |
-| `bullmq`                    | `queueCollector`                               |
-| `better-sqlite3`            | Dashboard (`dashboard: true`)                  |
-| `edge.js`                   | Edge tag                                       |
+| Dependency                  | Required By                                   |
+| --------------------------- | --------------------------------------------- |
+| `@adonisjs/core`            | Everything (required)                         |
+| `@adonisjs/lucid`           | `dbPoolCollector`, `appCollector`, dashboard  |
+| `@adonisjs/redis`           | `redisCollector`, dashboard cache inspector   |
+| `@adonisjs/transmit`        | Provider (SSE broadcast), dashboard real-time |
+| `@julr/adonisjs-prometheus` | `serverStatsCollector`                        |
+| `bullmq`                    | `queueCollector`                              |
+| `better-sqlite3`            | Dashboard (`dashboard: true`)                 |
+| `edge.js`                   | Edge tag                                      |
 
 ## License
 

package/dist/configure.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configure.d.ts","sourceRoot":"","sources":["../configure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,mCAAmC,CAAA;AAI9D,wBAAsB,SAAS,CAAC,OAAO,EAAE,SAAS,iBAWjD"}
+{"version":3,"file":"configure.d.ts","sourceRoot":"","sources":["../configure.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,SAAS,MAAM,mCAAmC,CAAA;AAE9D,wBAAsB,SAAS,CAAC,OAAO,EAAE,SAAS,iBAWjD"}

package/dist/src/controller/debug_controller.d.ts

@@ -1,5 +1,5 @@
-import type { HttpContext } from "@adonisjs/core/http";
-import type { DebugStore } from "../debug/debug_store.js";
+import type { DebugStore } from '../debug/debug_store.js';
+import type { HttpContext } from '@adonisjs/core/http';
 export default class DebugController {
     private store;
     constructor(store: DebugStore);

package/dist/src/controller/debug_controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"debug_controller.d.ts","sourceRoot":"","sources":["../../../src/controller/debug_controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,MAAM,CAAC,OAAO,OAAO,eAAe;IACtB,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,UAAU;IAE/B,OAAO,CAAC,EAAE,QAAQ,EAAE,EAAE,WAAW;IAMjC,MAAM,CAAC,EAAE,QAAQ,EAAE,EAAE,WAAW;IAKhC,MAAM,CAAC,EAAE,QAAQ,EAAE,EAAE,WAAW;IAKhC,MAAM,CAAC,EAAE,QAAQ,EAAE,EAAE,WAAW;IAOhC,YAAY,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,WAAW;IAS9C,MAAM,CAAC,EAAE,QAAQ,EAAE,EAAE,WAAW;IAahC,WAAW,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,WAAW;CAWpD"}
+{"version":3,"file":"debug_controller.d.ts","sourceRoot":"","sources":["../../../src/controller/debug_controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAEtD,MAAM,CAAC,OAAO,OAAO,eAAe;IACtB,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,UAAU;IAE/B,OAAO,CAAC,EAAE,QAAQ,EAAE,EAAE,WAAW;IAMjC,MAAM,CAAC,EAAE,QAAQ,EAAE,EAAE,WAAW;IAKhC,MAAM,CAAC,EAAE,QAAQ,EAAE,EAAE,WAAW;IAKhC,MAAM,CAAC,EAAE,QAAQ,EAAE,EAAE,WAAW;IAOhC,YAAY,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,WAAW;IAS9C,MAAM,CAAC,EAAE,QAAQ,EAAE,EAAE,WAAW;IAahC,WAAW,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,WAAW;CAWpD"}

package/dist/src/controller/server_stats_controller.d.ts

@@ -1,5 +1,5 @@
-import type { HttpContext } from '@adonisjs/core/http';
 import type { StatsEngine } from '../engine/stats_engine.js';
+import type { HttpContext } from '@adonisjs/core/http';
 export default class ServerStatsController {
     private engine;
     constructor(engine: StatsEngine);

package/dist/src/controller/server_stats_controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server_stats_controller.d.ts","sourceRoot":"","sources":["../../../src/controller/server_stats_controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAE5D,MAAM,CAAC,OAAO,OAAO,qBAAqB;IAC5B,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAEjC,KAAK,CAAC,EAAE,QAAQ,EAAE,EAAE,WAAW;CAItC"}
+{"version":3,"file":"server_stats_controller.d.ts","sourceRoot":"","sources":["../../../src/controller/server_stats_controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAEtD,MAAM,CAAC,OAAO,OAAO,qBAAqB;IAC5B,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,WAAW;IAEjC,KAAK,CAAC,EAAE,QAAQ,EAAE,EAAE,WAAW;CAItC"}

package/dist/src/dashboard/chart_aggregator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chart_aggregator.d.ts","sourceRoot":"","sources":["../../../src/dashboard/chart_aggregator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAEhC;;;;;;;;;;GAUG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,EAAE,CAAM;IAChB,OAAO,CAAC,KAAK,CAA8C;gBAE/C,EAAE,EAAE,IAAI;IAIpB,KAAK,IAAI,IAAI;IAQb,IAAI,IAAI,IAAI;YAOE,SAAS;CA4DxB"}
+{"version":3,"file":"chart_aggregator.d.ts","sourceRoot":"","sources":["../../../src/dashboard/chart_aggregator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAEhC;;;;;;;;;;GAUG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,EAAE,CAAM;IAChB,OAAO,CAAC,KAAK,CAA8C;gBAE/C,EAAE,EAAE,IAAI;IAIpB,KAAK,IAAI,IAAI;IAQb,IAAI,IAAI,IAAI;YAOE,SAAS;CA0DxB"}