feat(nest-profiler): rework the profiler UI into sidebar views with a configurable Summary

[fpasquet]

Summary

Reworks the profiler home page (GET /_profiler) into a navigable workspace and adds the missing Summary dashboard, implementing epic #146 in full.

• Two-column layout + sidebar views — the home page adopts the detail page's sticky left sidebar + right content pane. The active view is selected server-side from a ?view= query param (plain links, no client JS, consistent with the script-src 'self' CSP).
• Views — Summary (new default), Profiling (the existing per-entrypoint list sections and filters), and one entry per registered global-scope collector (Config, Routes, Schemas…), each built lazily only when active.
• Summary dashboard — aggregated overview of the recent window: total requests, median (p50) latency with p95 / p99, error rate + count, method / status-class / entrypoint-kind distributions, per performance-tag issue counts, slowest endpoints and recent errors. Computed on demand by a new SummaryService from a single bounded, index-only querySummaries read (never a full-store scan), memoized ~30s. Cards and rows link through to the Profiling filters.
• Enrichment — a throughput/latency time-series, a process-heap trend chart (moved here from the Profiling list), a performance-issues breakdown (for each tag, the affected endpoints with their entrypoint kind and mean duration, each linking to a representative profile), and a JSON export at GET /_profiler/summary.json.
• Extensible from any collector — any collector (built-in, package, or a user's custom one) can contribute a tile or table to the Summary via buildSummary(profiles, context?), returning a CollectorSummarySection with tiles and/or a custom EJS table. Contributions are isolated and priority-ordered. The query collectors ship a Database section (query count, average query time, a linked slowest-queries table) and @eleven-labs/nest-profiler-cache ships a Cache section (hit rate, hits, misses).
• Configurable — the summary module option sets the aggregation window (windowSize), cache TTL (cacheTtl), the per-table row cap (topN, default 5 — tables are labelled "Top N …" with a "View all →" link and show a time column), and how a failure is qualified (error). The error default stays 5xx-or-exception (so 4xx like 401/404 are not counted); it can override the HTTP status bound, toggle whether exceptions count, and add a classify predicate to qualify kinds without a status code (commands, GraphQL, RabbitMQ) from their own tags/attributes.
• Entrypoint-agnostic — HTTP requests group by their matched route (or method + URL); non-HTTP kinds (CLI commands, RabbitMQ messages, GraphQL operations) group by their own descriptor, so they get a meaningful label (CLI / RMQ / GQL) instead of a blank row.
• Storage — ProfileSummary gains an optional route and heapUsed; adapters gain an optional querySummaries(query) returning only lightweight summary rows (native on file + SQLite, in-memory fallback). New public exports include SummaryService, computeProfilerSummary, resolveErrorClassifier, defaultIsError, and the ProfilerSummary / CollectorSummarySection / SummaryContext / ProfilerErrorClassification / ProfileErrorInfo types.

Related issue

Closes #146

Checklist

• Tests were added or updated to cover the change
• Documentation was added or updated
• A changeset was added, or this PR does not affect published packages
• Breaking changes use a major changeset with a BREAKING: note

Breaking changes

• This PR includes breaking changes

Additive only — new optional fields/methods, options and exports; no public API removed. SQLite gains route / heap_used columns via idempotent migrations. The collector buildSummary gains an optional context argument (backward-compatible).

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
nest-profiler	Ready	Preview, Comment	Jul 13, 2026 9:15pm
nest-profiler-example	Ready	Preview, Comment	Jul 13, 2026 9:15pm