adonisjs-server-stats 1.5.4 → 1.6.2

package/dist/src/routes/access_middleware.d.ts

@@ -1,8 +1,9 @@
+import type { HttpContext } from '@adonisjs/core/http';
 /**
  * Create a middleware function that gates access using the shouldShow callback.
  * Returns 403 if the callback returns false.
  *
  * Shared by stats, debug, and dashboard route registrars.
  */
-export declare function createAccessMiddleware(shouldShow: (ctx: any) => boolean): (ctx: any, next: () => Promise<void>) => Promise<any>;
+export declare function createAccessMiddleware(shouldShow: (ctx: HttpContext) => boolean): (ctx: HttpContext, next: () => Promise<void>) => Promise<void>;
 //# sourceMappingURL=access_middleware.d.ts.map

package/dist/src/routes/access_middleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"access_middleware.d.ts","sourceRoot":"","sources":["../../../src/routes/access_middleware.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,IACxD,KAAK,GAAG,EAAE,MAAM,MAAM,OAAO,CAAC,IAAI,CAAC,kBAUlD"}
+{"version":3,"file":"access_middleware.d.ts","sourceRoot":"","sources":["../../../src/routes/access_middleware.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAItD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,IAChE,KAAK,WAAW,EAAE,MAAM,MAAM,OAAO,CAAC,IAAI,CAAC,mBAgB1D"}

package/dist/src/routes/access_middleware.js

@@ -1,3 +1,5 @@
+import { log } from '../utils/logger.js';
+let warnedShouldShow = false;
 /**
  * Create a middleware function that gates access using the shouldShow callback.
  * Returns 403 if the callback returns false.
@@ -11,7 +13,11 @@ export function createAccessMiddleware(shouldShow) {
                 return ctx.response.forbidden({ error: 'Access denied' });
             }
         }
-        catch {
+        catch (err) {
+            if (!warnedShouldShow) {
+                warnedShouldShow = true;
+                log.warn('shouldShow callback threw in route guard — returning 403: ' + err?.message);
+            }
             return ctx.response.forbidden({ error: 'Access denied' });
         }
         await next();

package/dist/src/routes/index.d.ts

@@ -0,0 +1,4 @@
+export { registerAllRoutes } from './register_routes.js';
+export type { RegisterRoutesOptions } from './register_routes.js';
+export type { AdonisRoute, AdonisRouter } from './router_types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/routes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/routes/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AACxD,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AACjE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/src/routes/index.js

@@ -0,0 +1 @@
+export { registerAllRoutes } from './register_routes.js';

package/dist/src/routes/register_routes.d.ts

@@ -0,0 +1,103 @@
+import type { ApiController } from '../controller/api_controller.js';
+import type DebugController from '../controller/debug_controller.js';
+import type ServerStatsController from '../controller/server_stats_controller.js';
+import type DashboardController from '../dashboard/dashboard_controller.js';
+import type { AdonisRouter } from './router_types.js';
+import type { HttpContext } from '@adonisjs/core/http';
+/**
+ * Options for the unified route registration function.
+ *
+ * Brings together stats, debug, and dashboard route registration
+ * into a single call with all required dependencies declared upfront.
+ */
+export interface RegisterRoutesOptions {
+    /** The AdonisJS router instance. */
+    router: AdonisRouter;
+    /**
+     * The unified API controller that serves all data resource endpoints
+     * (queries, events, emails, traces, routes, logs).
+     *
+     * Pass `null` during early boot — routes will return 503 until the
+     * controller is wired up.
+     */
+    getApiController: () => ApiController | null;
+    /**
+     * Lazy getter for the stats bar controller.
+     *
+     * The controller is created during `ready()`, but routes are
+     * registered during `boot()`, so a lazy getter is required.
+     */
+    getStatsController: () => ServerStatsController | null;
+    /**
+     * Lazy getter for the debug controller.
+     *
+     * Handles non-data debug endpoints: `/config` and `/diagnostics`.
+     */
+    getDebugController: () => DebugController | null;
+    /**
+     * Lazy getter for the dashboard controller.
+     *
+     * Handles dashboard-specific endpoints that are **not** data
+     * resources: page rendering, overview, requests, cache, jobs,
+     * config, saved filters, grouped queries, and query explain.
+     */
+    getDashboardController: () => DashboardController | null;
+    /**
+     * Stats polling endpoint path (e.g. `'/admin/api/server-stats'`).
+     *
+     * Set to `false` to skip registering the stats endpoint entirely.
+     */
+    statsEndpoint?: string | false;
+    /**
+     * Base path for debug panel API routes (e.g. `'/admin/api/debug'`).
+     *
+     * When omitted, debug routes are **not** registered.
+     */
+    debugEndpoint?: string;
+    /**
+     * Base path for the full-page dashboard (e.g. `'/__stats'`).
+     *
+     * When omitted, dashboard routes are **not** registered.
+     */
+    dashboardPath?: string;
+    /**
+     * Optional access-control callback applied to **all** registered
+     * routes as middleware. When it returns `false`, the request
+     * receives a 403 Forbidden response.
+     */
+    shouldShow?: (ctx: HttpContext) => boolean;
+}
+/**
+ * Register all server-stats routes in a single call.
+ *
+ * This is the unified replacement for the three separate registrars:
+ *
+ * - `registerStatsRoutes`     — stats bar polling endpoint
+ * - `registerDebugRoutes`     — debug panel API endpoints
+ * - `registerDashboardRoutes` — full-page dashboard endpoints
+ *
+ * **Data resource** endpoints (queries, events, emails, traces, routes,
+ * logs) are routed through the unified {@link ApiController} so that
+ * both the debug panel and the dashboard read from the same handler.
+ *
+ * **Non-data** endpoints (stats polling, config, diagnostics, overview,
+ * requests, cache, jobs, saved filters, grouped queries, query explain,
+ * and the dashboard HTML page) continue to use their original controllers.
+ *
+ * @example
+ * ```ts
+ * registerAllRoutes({
+ *   router,
+ *   getApiController: () => apiController,
+ *   getStatsController: () => statsController,
+ *   getDebugController: () => debugController,
+ *   getDashboardController: () => dashboardController,
+ *   statsEndpoint: '/admin/api/server-stats',
+ *   debugEndpoint: '/admin/api/debug',
+ *   dashboardPath: '/__stats',
+ *   shouldShow: (ctx) => ctx.auth?.user?.role === 'admin',
+ * })
+ * ```
+ */
+export declare function registerAllRoutes(options: RegisterRoutesOptions): void;
+//# sourceMappingURL=register_routes.d.ts.map

package/dist/src/routes/register_routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register_routes.d.ts","sourceRoot":"","sources":["../../../src/routes/register_routes.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAA;AACpE,OAAO,KAAK,eAAe,MAAM,mCAAmC,CAAA;AACpE,OAAO,KAAK,qBAAqB,MAAM,0CAA0C,CAAA;AACjF,OAAO,KAAK,mBAAmB,MAAM,sCAAsC,CAAA;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAMtD;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,oCAAoC;IACpC,MAAM,EAAE,YAAY,CAAA;IAEpB;;;;;;OAMG;IACH,gBAAgB,EAAE,MAAM,aAAa,GAAG,IAAI,CAAA;IAE5C;;;;;OAKG;IACH,kBAAkB,EAAE,MAAM,qBAAqB,GAAG,IAAI,CAAA;IAEtD;;;;OAIG;IACH,kBAAkB,EAAE,MAAM,eAAe,GAAG,IAAI,CAAA;IAEhD;;;;;;OAMG;IACH,sBAAsB,EAAE,MAAM,mBAAmB,GAAG,IAAI,CAAA;IAExD;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IAE9B;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAA;CAC3C;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CA6ZtE"}

package/dist/src/routes/register_routes.js

@@ -0,0 +1,356 @@
+import { createAccessMiddleware } from './access_middleware.js';
+// ---------------------------------------------------------------------------
+// Registration
+// ---------------------------------------------------------------------------
+/**
+ * Register all server-stats routes in a single call.
+ *
+ * This is the unified replacement for the three separate registrars:
+ *
+ * - `registerStatsRoutes`     — stats bar polling endpoint
+ * - `registerDebugRoutes`     — debug panel API endpoints
+ * - `registerDashboardRoutes` — full-page dashboard endpoints
+ *
+ * **Data resource** endpoints (queries, events, emails, traces, routes,
+ * logs) are routed through the unified {@link ApiController} so that
+ * both the debug panel and the dashboard read from the same handler.
+ *
+ * **Non-data** endpoints (stats polling, config, diagnostics, overview,
+ * requests, cache, jobs, saved filters, grouped queries, query explain,
+ * and the dashboard HTML page) continue to use their original controllers.
+ *
+ * @example
+ * ```ts
+ * registerAllRoutes({
+ *   router,
+ *   getApiController: () => apiController,
+ *   getStatsController: () => statsController,
+ *   getDebugController: () => debugController,
+ *   getDashboardController: () => dashboardController,
+ *   statsEndpoint: '/admin/api/server-stats',
+ *   debugEndpoint: '/admin/api/debug',
+ *   dashboardPath: '/__stats',
+ *   shouldShow: (ctx) => ctx.auth?.user?.role === 'admin',
+ * })
+ * ```
+ */
+export function registerAllRoutes(options) {
+    const { router, getApiController, getStatsController, getDebugController, getDashboardController, statsEndpoint, debugEndpoint, dashboardPath, shouldShow, } = options;
+    const middleware = shouldShow ? [createAccessMiddleware(shouldShow)] : [];
+    // =========================================================================
+    // Stats polling endpoint
+    // =========================================================================
+    if (typeof statsEndpoint === 'string') {
+        router
+            .get(statsEndpoint, async (ctx) => {
+            const controller = getStatsController();
+            if (!controller) {
+                return ctx.response.serviceUnavailable({
+                    error: 'Stats engine is starting up, please retry',
+                });
+            }
+            return controller.index(ctx);
+        })
+            .as('server-stats.api')
+            .use(middleware);
+    }
+    // =========================================================================
+    // Debug panel API routes
+    // =========================================================================
+    if (debugEndpoint) {
+        const base = debugEndpoint.replace(/\/+$/, '');
+        /**
+         * Bind a debug controller method with lazy initialization and
+         * 503 fallback when the controller is not yet ready.
+         */
+        const bindDebug = (method) => {
+            return async (ctx) => {
+                const controller = getDebugController();
+                if (!controller) {
+                    return ctx.response.serviceUnavailable({
+                        error: 'Debug toolbar is starting up, please retry',
+                    });
+                }
+                return controller[method].call(controller, ctx);
+            };
+        };
+        /**
+         * Wrap an ApiController method as an HTTP handler with lazy
+         * initialization and 503 fallback.
+         */
+        const bindApi = (fn) => {
+            return async (ctx) => {
+                const api = getApiController();
+                if (!api) {
+                    return ctx.response.serviceUnavailable({
+                        error: 'Debug toolbar is starting up, please retry',
+                    });
+                }
+                return fn(api, ctx);
+            };
+        };
+        router
+            .group(() => {
+            // Non-data endpoints — stay with DebugController
+            router.get('/config', bindDebug('config')).as('server-stats.debug.config');
+            router.get('/diagnostics', bindDebug('diagnostics')).as('server-stats.debug.diagnostics');
+            // Data endpoints — unified through ApiController
+            // Debug panel always reads from ring buffers (source: 'memory')
+            // because SQLite column names (snake_case) differ from the
+            // camelCase QueryRecord/EventRecord/etc. shapes the frontend expects.
+            router
+                .get('/queries', bindApi(async (api, ctx) => {
+                const queries = await api.getQueries({ source: 'memory' });
+                const summary = api.getQuerySummary();
+                return ctx.response.json({ queries: queries.data, summary });
+            }))
+                .as('server-stats.debug.queries');
+            router
+                .get('/events', bindApi(async (api, ctx) => {
+                const result = await api.getEvents({ source: 'memory' });
+                return ctx.response.json({ events: result.data, total: result.meta.total });
+            }))
+                .as('server-stats.debug.events');
+            router
+                .get('/routes', bindApi((api, ctx) => {
+                const result = api.getRoutes();
+                return ctx.response.json({ routes: result.data, total: result.meta.total });
+            }))
+                .as('server-stats.debug.routes');
+            router
+                .get('/logs', bindApi(async (api, ctx) => {
+                const result = await api.getLogs({ source: 'memory' });
+                return ctx.response.json(result.data);
+            }))
+                .as('server-stats.debug.logs');
+            router
+                .get('/emails', bindApi(async (api, ctx) => {
+                const result = await api.getEmails({ source: 'memory' });
+                return ctx.response.json({ emails: result.data, total: result.meta.total });
+            }))
+                .as('server-stats.debug.emails');
+            router
+                .get('/emails/:id/preview', bindApi(async (api, ctx) => {
+                const id = Number(ctx.params.id);
+                const html = await api.getEmailPreview(id, 'memory');
+                if (!html) {
+                    return ctx.response.notFound({ error: 'Email not found' });
+                }
+                return ctx.response.header('Content-Type', 'text/html; charset=utf-8').send(html);
+            }))
+                .as('server-stats.debug.emailPreview');
+            router
+                .get('/traces', bindApi(async (api, ctx) => {
+                const result = await api.getTraces({ source: 'memory' });
+                return ctx.response.json({ traces: result.data, total: result.meta.total });
+            }))
+                .as('server-stats.debug.traces');
+            router
+                .get('/traces/:id', bindApi(async (api, ctx) => {
+                const id = Number(ctx.params.id);
+                const trace = await api.getTraceDetail(id, 'memory');
+                if (!trace) {
+                    return ctx.response.notFound({ error: 'Trace not found' });
+                }
+                return ctx.response.json(trace);
+            }))
+                .as('server-stats.debug.traceDetail');
+        })
+            .prefix(base)
+            .use(middleware);
+    }
+    // =========================================================================
+    // Dashboard routes
+    // =========================================================================
+    if (dashboardPath) {
+        const base = dashboardPath.replace(/\/+$/, '');
+        /**
+         * Bind a dashboard controller method with lazy initialization
+         * and 503 fallback.
+         */
+        const bindDash = (method) => {
+            return async (ctx) => {
+                const controller = getDashboardController();
+                if (!controller) {
+                    return ctx.response.serviceUnavailable({
+                        error: 'Dashboard is starting up, please retry',
+                    });
+                }
+                return controller[method].call(controller, ctx);
+            };
+        };
+        /**
+         * Wrap an ApiController method as a dashboard HTTP handler with
+         * lazy initialization and 503 fallback.
+         */
+        const bindApi = (fn) => {
+            return async (ctx) => {
+                const api = getApiController();
+                if (!api) {
+                    return ctx.response.serviceUnavailable({
+                        error: 'Dashboard is starting up, please retry',
+                    });
+                }
+                return fn(api, ctx);
+            };
+        };
+        router
+            .group(() => {
+            // ── Page ────────────────────────────────────────────────────
+            router.get('/', bindDash('page')).as('server-stats.dashboard');
+            // ── Overview (dashboard-only) ───────────────────────────────
+            router.get('/api/overview', bindDash('overview')).as('server-stats.overview');
+            router
+                .get('/api/overview/chart', bindDash('overviewChart'))
+                .as('server-stats.overview.chart');
+            // ── Requests (dashboard-only) ───────────────────────────────
+            router.get('/api/requests', bindDash('requests')).as('server-stats.requests');
+            router.get('/api/requests/:id', bindDash('requestDetail')).as('server-stats.requests.show');
+            // ── Queries — unified data via ApiController ────────────────
+            router
+                .get('/api/queries', bindApi(async (api, ctx) => {
+                const qs = ctx.request.qs();
+                const result = await api.getQueries({
+                    page: Number(qs.page) || 1,
+                    perPage: Number(qs.perPage) || 25,
+                    search: qs.search || undefined,
+                    filters: {
+                        durationMin: qs.duration_min ? Number(qs.duration_min) : undefined,
+                        model: qs.model || undefined,
+                        method: qs.method || undefined,
+                        connection: qs.connection || undefined,
+                    },
+                });
+                return ctx.response.json(result);
+            }))
+                .as('server-stats.queries');
+            // Grouped queries and explain stay on DashboardController
+            router
+                .get('/api/queries/grouped', bindDash('queriesGrouped'))
+                .as('server-stats.queries.grouped');
+            router
+                .get('/api/queries/:id/explain', bindDash('queryExplain'))
+                .as('server-stats.queries.explain');
+            // ── Events — unified data via ApiController ─────────────────
+            router
+                .get('/api/events', bindApi(async (api, ctx) => {
+                const qs = ctx.request.qs();
+                const result = await api.getEvents({
+                    page: Number(qs.page) || 1,
+                    perPage: Number(qs.perPage) || 25,
+                    search: qs.search || undefined,
+                    filters: {
+                        eventName: qs.event_name || undefined,
+                    },
+                });
+                return ctx.response.json(result);
+            }))
+                .as('server-stats.events');
+            // ── Routes — unified data via ApiController ─────────────────
+            router
+                .get('/api/routes', bindApi((api, ctx) => {
+                const qs = ctx.request.qs();
+                const result = api.getRoutes(qs.search || undefined);
+                return ctx.response.json(result);
+            }))
+                .as('server-stats.routes');
+            // ── Logs — unified data via ApiController ───────────────────
+            router
+                .get('/api/logs', bindApi(async (api, ctx) => {
+                const qs = ctx.request.qs();
+                const result = await api.getLogs({
+                    page: Number(qs.page) || 1,
+                    perPage: Number(qs.perPage) || 50,
+                    search: qs.message || qs.search || undefined,
+                    filters: {
+                        level: qs.level || undefined,
+                        requestId: qs.request_id || qs.requestId || undefined,
+                    },
+                });
+                return ctx.response.json(result);
+            }))
+                .as('server-stats.logs');
+            // ── Emails — unified data via ApiController ─────────────────
+            router
+                .get('/api/emails', bindApi(async (api, ctx) => {
+                const qs = ctx.request.qs();
+                const result = await api.getEmails({
+                    page: Number(qs.page) || 1,
+                    perPage: Number(qs.perPage) || 25,
+                    search: qs.search || undefined,
+                    filters: {
+                        from: qs.from || undefined,
+                        to: qs.to || undefined,
+                        subject: qs.subject || undefined,
+                        status: qs.status || undefined,
+                        mailer: qs.mailer || undefined,
+                    },
+                });
+                return ctx.response.json(result);
+            }))
+                .as('server-stats.emails');
+            router
+                .get('/api/emails/:id/preview', bindApi(async (api, ctx) => {
+                const id = Number(ctx.params.id);
+                const html = await api.getEmailPreview(id);
+                if (!html) {
+                    return ctx.response.notFound({ error: 'Email not found' });
+                }
+                return ctx.response.header('Content-Type', 'text/html; charset=utf-8').send(html);
+            }))
+                .as('server-stats.emails.preview');
+            // ── Traces — unified data via ApiController ─────────────────
+            router
+                .get('/api/traces', bindApi(async (api, ctx) => {
+                const qs = ctx.request.qs();
+                const result = await api.getTraces({
+                    page: Number(qs.page) || 1,
+                    perPage: Number(qs.perPage) || 25,
+                    search: qs.search || undefined,
+                    filters: {
+                        method: qs.method ? qs.method.toUpperCase() : undefined,
+                        url: qs.url || undefined,
+                        statusMin: qs.status_min ? Number(qs.status_min) : undefined,
+                        statusMax: qs.status_max ? Number(qs.status_max) : undefined,
+                    },
+                });
+                return ctx.response.json(result);
+            }))
+                .as('server-stats.traces');
+            router
+                .get('/api/traces/:id', bindApi(async (api, ctx) => {
+                const id = Number(ctx.params.id);
+                const trace = await api.getTraceDetail(id);
+                if (!trace) {
+                    return ctx.response.notFound({ error: 'Trace not found' });
+                }
+                return ctx.response.json(trace);
+            }))
+                .as('server-stats.traces.show');
+            // ── Cache (dashboard-only) ──────────────────────────────────
+            router.get('/api/cache', bindDash('cacheStats')).as('server-stats.cache');
+            router
+                .get('/api/cache/:key', bindDash('cacheKey'))
+                .as('server-stats.cache.show')
+                .where('key', /.*/);
+            router
+                .delete('/api/cache/:key', bindDash('cacheKeyDelete'))
+                .as('server-stats.cache.delete')
+                .where('key', /.*/);
+            // ── Jobs / Queue (dashboard-only) ───────────────────────────
+            router.get('/api/jobs', bindDash('jobs')).as('server-stats.jobs');
+            router.get('/api/jobs/:id', bindDash('jobDetail')).as('server-stats.jobs.show');
+            router.post('/api/jobs/:id/retry', bindDash('jobRetry')).as('server-stats.jobs.retry');
+            // ── Config (dashboard-only) ─────────────────────────────────
+            router.get('/api/config', bindDash('config')).as('server-stats.config');
+            // ── Saved Filters (dashboard-only) ──────────────────────────
+            router.get('/api/filters', bindDash('savedFilters')).as('server-stats.filters');
+            router.post('/api/filters', bindDash('createSavedFilter')).as('server-stats.filters.create');
+            router
+                .delete('/api/filters/:id', bindDash('deleteSavedFilter'))
+                .as('server-stats.filters.delete');
+        })
+            .prefix(base)
+            .use(middleware);
+    }
+}

package/dist/src/routes/router_types.d.ts

@@ -0,0 +1,29 @@
+import type { HttpContext } from '@adonisjs/core/http';
+/**
+ * Minimal interface for an AdonisJS route returned by `router.get()` etc.
+ *
+ * Covers all chaining patterns used across stats, debug, and dashboard
+ * route files: `.as()`, `.where()`, and `.use()`.
+ */
+export interface AdonisRoute {
+    as(name: string): AdonisRoute;
+    where(key: string, matcher: RegExp): AdonisRoute;
+    use(middleware: unknown[]): void;
+}
+/**
+ * Minimal interface for the AdonisJS router used in route registration.
+ *
+ * Covers every HTTP method and grouping pattern used by
+ * `registerStatsRoutes`, `registerDebugRoutes`, and `registerDashboardRoutes`.
+ */
+export interface AdonisRouter {
+    get(pattern: string, handler: (ctx: HttpContext) => unknown): AdonisRoute;
+    post(pattern: string, handler: (ctx: HttpContext) => unknown): AdonisRoute;
+    delete(pattern: string, handler: (ctx: HttpContext) => unknown): AdonisRoute;
+    group(callback: () => void): {
+        prefix(path: string): {
+            use(middleware: unknown[]): void;
+        };
+    };
+}
+//# sourceMappingURL=router_types.d.ts.map

package/dist/src/routes/router_types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router_types.d.ts","sourceRoot":"","sources":["../../../src/routes/router_types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAEtD;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAA;IAC7B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,CAAA;IAChD,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;CACjC;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,GAAG,WAAW,CAAA;IACzE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,GAAG,WAAW,CAAA;IAC1E,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,GAAG,WAAW,CAAA;IAC5E,KAAK,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG;QAAE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG;YAAE,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;SAAE,CAAA;KAAE,CAAA;CAC5F"}

package/dist/src/routes/router_types.js

@@ -0,0 +1 @@
+export {};

package/dist/src/stubs/config.stub

@@ -1,39 +1,19 @@
 {{{
   exports({ to: app.configPath('server_stats.ts') })
 }}}
-import env from '#start/env'
 import { defineConfig } from 'adonisjs-server-stats'
-import {
-  processCollector,
-  systemCollector,
-  httpCollector,
-  dbPoolCollector,
-  redisCollector,
-  queueCollector,
-  logCollector,
-  appCollector,
-} from 'adonisjs-server-stats/collectors'
 
 export default defineConfig({
-  intervalMs: 3000,
-  transport: 'transmit',
-  channelName: 'admin/server-stats',
-  endpoint: '/admin/api/server-stats',
-  collectors: [
-    processCollector(),
-    systemCollector(),
-    httpCollector({ maxRecords: 10_000 }),
-    dbPoolCollector({ connectionName: 'postgres' }),
-    redisCollector(),
-    queueCollector({
-      queueName: 'default',
-      connection: {
-        host: env.get('QUEUE_REDIS_HOST'),
-        port: env.get('QUEUE_REDIS_PORT'),
-        password: env.get('QUEUE_REDIS_PASSWORD'),
-      },
-    }),
-    logCollector({ logPath: 'logs/adonisjs.log' }),
-    appCollector(),
-  ],
+  // Auto-detects installed packages and enables matching collectors.
+  // Override with a specific array if needed.
+  // collectors: 'auto',
+
+  // Who can see the stats bar, debug toolbar, and dashboard.
+  // authorize: (ctx) => ctx.auth?.user?.role === 'admin',
+
+  // Enable the debug toolbar (SQL queries, events, emails, logs)
+  // toolbar: true,
+
+  // Enable the full-page dashboard at /__stats
+  // dashboard: true,
 })