adonisjs-server-stats 1.5.4 → 1.6.2

package/dist/src/engine/stats_engine.d.ts

@@ -1,5 +1,15 @@
 import type { MetricCollector } from '../collectors/collector.js';
 import type { MetricValue } from '../types.js';
+/**
+ * Health status for an individual collector.
+ */
+export interface CollectorHealth {
+    name: string;
+    label: string;
+    status: 'healthy' | 'errored' | 'stopped';
+    lastError: string | null;
+    lastErrorAt: number | null;
+}
 /**
  * Central orchestrator that runs all configured collectors in parallel
  * and merges their results into a single flat record.
@@ -17,6 +27,7 @@ import type { MetricValue } from '../types.js';
 export declare class StatsEngine {
     private collectors;
     private latestStats;
+    private collectorHealth;
     constructor(collectors: MetricCollector[]);
     /**
      * Initialize all collectors.
@@ -47,5 +58,12 @@ export declare class StatsEngine {
      * Returns an empty object if `collect()` has not been called yet.
      */
     getLatestStats(): Record<string, MetricValue>;
+    /** Returns health status for all collectors. */
+    getCollectorHealth(): CollectorHealth[];
+    /** Returns collector-specific configuration for all collectors. */
+    getCollectorConfigs(): Array<{
+        name: string;
+        config: Record<string, unknown>;
+    }>;
 }
 //# sourceMappingURL=stats_engine.d.ts.map

package/dist/src/engine/stats_engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stats_engine.d.ts","sourceRoot":"","sources":["../../../src/engine/stats_engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C;;;;;;;;;;;;;GAaG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,WAAW,CAAkC;gBAEzC,UAAU,EAAE,eAAe,EAAE;IAIzC;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;;;;OAKG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B;;;;;;;OAOG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAerD;;;;OAIG;IACH,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC;CAG9C"}
+{"version":3,"file":"stats_engine.d.ts","sourceRoot":"","sources":["../../../src/engine/stats_engine.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAA;IACzC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,WAAW,CAAkC;IACrD,OAAO,CAAC,eAAe,CAA0C;gBAErD,UAAU,EAAE,eAAe,EAAE;IAczC;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAa5B;;;;;OAKG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAU3B;;;;;;;OAOG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAgCrD;;;;OAIG;IACH,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC;IAI7C,gDAAgD;IAChD,kBAAkB,IAAI,eAAe,EAAE;IAIvC,mEAAmE;IACnE,mBAAmB,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;CAMhF"}

package/dist/src/engine/stats_engine.js

@@ -1,3 +1,4 @@
+import { log } from '../utils/logger.js';
 /**
  * Central orchestrator that runs all configured collectors in parallel
  * and merges their results into a single flat record.
@@ -15,8 +16,18 @@
 export class StatsEngine {
     collectors;
     latestStats = {};
+    collectorHealth = new Map();
     constructor(collectors) {
         this.collectors = collectors;
+        for (const collector of collectors) {
+            this.collectorHealth.set(collector.name, {
+                name: collector.name,
+                label: collector.label ?? collector.name,
+                status: 'healthy',
+                lastError: null,
+                lastErrorAt: null,
+            });
+        }
     }
     /**
      * Initialize all collectors.
@@ -28,6 +39,9 @@ export class StatsEngine {
         for (const collector of this.collectors) {
             await collector.start?.();
         }
+        if (this.collectors.length > 0) {
+            log.list('collectors started:', this.collectors.map((c) => c.label ?? c.name));
+        }
     }
     /**
      * Shut down all collectors.
@@ -39,6 +53,9 @@ export class StatsEngine {
         for (const collector of this.collectors) {
             await collector.stop?.();
         }
+        for (const health of this.collectorHealth.values()) {
+            health.status = 'stopped';
+        }
     }
     /**
      * Run all collectors in parallel, merge their results, and return
@@ -51,9 +68,24 @@ export class StatsEngine {
     async collect() {
         const results = await Promise.all(this.collectors.map(async (collector) => {
             try {
-                return await collector.collect();
+                const result = await collector.collect();
+                const health = this.collectorHealth.get(collector.name);
+                if (health) {
+                    health.status = 'healthy';
+                }
+                return result;
             }
-            catch {
+            catch (err) {
+                const health = this.collectorHealth.get(collector.name);
+                if (health) {
+                    const wasHealthy = health.status !== 'errored';
+                    health.status = 'errored';
+                    health.lastError = err.message;
+                    health.lastErrorAt = Date.now();
+                    if (wasHealthy) {
+                        log.warn(`collector "${collector.name}" threw during collect() — ${err.message}`);
+                    }
+                }
                 return {};
             }
         }));
@@ -68,4 +100,15 @@ export class StatsEngine {
     getLatestStats() {
         return this.latestStats;
     }
+    /** Returns health status for all collectors. */
+    getCollectorHealth() {
+        return Array.from(this.collectorHealth.values());
+    }
+    /** Returns collector-specific configuration for all collectors. */
+    getCollectorConfigs() {
+        return this.collectors.map((collector) => ({
+            name: collector.name,
+            config: collector.getConfig?.() ?? {},
+        }));
+    }
 }

package/dist/src/index.d.ts

@@ -4,7 +4,7 @@ export { RequestMetrics } from './engine/request_metrics.js';
 export { trace } from './debug/trace_collector.js';
 export { DashboardStore } from './dashboard/dashboard_store.js';
 export type { MetricCollector } from './collectors/collector.js';
-export type { MetricValue, ServerStats, ServerStatsConfig, LogStats, DevToolbarOptions, } from './types.js';
+export type { MetricValue, ServerStats, ServerStatsConfig, ResolvedServerStatsConfig, LogStats, DevToolbarOptions, ToolbarConfig, DashboardConfig, AdvancedConfig, } from './types.js';
 export type { DebugPane, DebugPaneColumn, DebugPaneFormatType, DebugPaneSearch, BadgeColor, QueryRecord, EventRecord, EmailRecord, RouteRecord, TraceSpan, TraceRecord, DevToolbarConfig, } from './debug/types.js';
 export type { RequestFilters, QueryFilters, EventFilters, EmailFilters, LogFilters, TraceFilters, PaginatedResult, } from './dashboard/dashboard_store.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAC5D,OAAO,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAA;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAC/D,YAAY,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAChE,YAAY,EACV,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,QAAQ,EACR,iBAAiB,GAClB,MAAM,YAAY,CAAA;AACnB,YAAY,EACV,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,UAAU,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,WAAW,EACX,SAAS,EACT,WAAW,EACX,gBAAgB,GACjB,MAAM,kBAAkB,CAAA;AACzB,YAAY,EACV,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,eAAe,GAChB,MAAM,gCAAgC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAC5D,OAAO,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAA;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAC/D,YAAY,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAChE,YAAY,EACV,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,yBAAyB,EACzB,QAAQ,EACR,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,cAAc,GACf,MAAM,YAAY,CAAA;AACnB,YAAY,EACV,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,UAAU,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,WAAW,EACX,SAAS,EACT,WAAW,EACX,gBAAgB,GACjB,MAAM,kBAAkB,CAAA;AACzB,YAAY,EACV,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,eAAe,GAChB,MAAM,gCAAgC,CAAA"}

package/dist/src/log_stream/log_stream_provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"log_stream_provider.d.ts","sourceRoot":"","sources":["../../../src/log_stream/log_stream_provider.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAE9D,MAAM,CAAC,OAAO,OAAO,iBAAiB;IAGxB,SAAS,CAAC,GAAG,EAAE,kBAAkB;IAF7C,OAAO,CAAC,OAAO,CAAgC;gBAEzB,GAAG,EAAE,kBAAkB;IAEvC,KAAK;IAwBL,QAAQ;CAGf"}
+{"version":3,"file":"log_stream_provider.d.ts","sourceRoot":"","sources":["../../../src/log_stream/log_stream_provider.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAO9D,MAAM,CAAC,OAAO,OAAO,iBAAiB;IAGxB,SAAS,CAAC,GAAG,EAAE,kBAAkB;IAF7C,OAAO,CAAC,OAAO,CAAgC;gBAEzB,GAAG,EAAE,kBAAkB;IAEvC,KAAK;IAwCL,QAAQ;CAGf"}

package/dist/src/log_stream/log_stream_provider.js

@@ -1,3 +1,5 @@
+import { getLogStreamService } from '../collectors/log_collector.js';
+import { log } from '../utils/logger.js';
 import { LogStreamService } from './log_stream_service.js';
 export default class LogStreamProvider {
     app;
@@ -10,21 +12,36 @@ export default class LogStreamProvider {
             return;
         let transmit;
         try {
-            transmit = await this.app.container.make('transmit');
+            transmit = (await this.app.container.make('transmit'));
         }
         catch {
+            log.info('@adonisjs/transmit not available — live log streaming disabled');
             return;
         }
-        const logPath = this.app.makePath('logs', 'adonisjs.log');
         const channelName = this.app.config.get('server_stats.logChannelName', 'admin/logs');
-        this.service = new LogStreamService(logPath, (entry) => {
+        const broadcast = (entry) => {
             try {
                 transmit.broadcast(channelName, JSON.parse(JSON.stringify(entry)));
             }
             catch {
                 // Silently ignore broadcast errors
             }
-        });
+        };
+        // If logCollector() is already hooked into Pino (zero-config),
+        // piggyback on its stream instead of creating a file poller.
+        const existing = getLogStreamService();
+        if (existing) {
+            const internal = existing;
+            const origOnEntry = internal.onEntry;
+            internal.onEntry = (entry) => {
+                origOnEntry?.(entry);
+                broadcast(entry);
+            };
+            return;
+        }
+        // Fallback: poll the log file directly
+        const logPath = this.app.makePath('logs', 'adonisjs.log');
+        this.service = new LogStreamService(logPath, broadcast);
         await this.service.start();
     }
     async shutdown() {

package/dist/src/log_stream/log_stream_service.d.ts

@@ -6,7 +6,14 @@ export declare class LogStreamService {
     private intervalId;
     private logPath;
     private onEntry?;
-    constructor(logPath: string, onEntry?: (entry: Record<string, unknown>) => void);
+    constructor(logPath?: string, onEntry?: (entry: Record<string, unknown>) => void);
+    /**
+     * Ingest a parsed log entry directly (no file needed).
+     *
+     * Used by the Pino stream interceptor to feed entries
+     * in real-time without file polling.
+     */
+    ingest(entry: Record<string, unknown>): void;
     getLogStats(): LogStats;
     start(): Promise<void>;
     stop(): void;

package/dist/src/log_stream/log_stream_service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"log_stream_service.d.ts","sourceRoot":"","sources":["../../../src/log_stream/log_stream_service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAkB3C,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAY3E;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,QAAQ,CAAI;IACpB,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,OAAO,CAAC,CAA0C;gBAE9C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI;IAK/E,WAAW,IAAI,QAAQ;IA2BjB,KAAK;IAYX,IAAI;YAOU,cAAc;CA4B7B"}
+{"version":3,"file":"log_stream_service.d.ts","sourceRoot":"","sources":["../../../src/log_stream/log_stream_service.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAoB3C,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAY3E;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,QAAQ,CAAI;IACpB,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,OAAO,CAAC,CAA0C;gBAE9C,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI;IAKhF;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAMrC,WAAW,IAAI,QAAQ;IA2BjB,KAAK;IAkBX,IAAI;YAOU,cAAc;CAiC7B"}

package/dist/src/log_stream/log_stream_service.js

@@ -1,4 +1,6 @@
 import { open, stat } from 'node:fs/promises';
+import { log } from '../utils/logger.js';
+let warnedPollFailure = false;
 const LEVEL_NAMES = {
     10: 'trace',
     20: 'debug',
@@ -30,9 +32,20 @@ export class LogStreamService {
     logPath;
     onEntry;
     constructor(logPath, onEntry) {
-        this.logPath = logPath;
+        this.logPath = logPath ?? null;
         this.onEntry = onEntry;
     }
+    /**
+     * Ingest a parsed log entry directly (no file needed).
+     *
+     * Used by the Pino stream interceptor to feed entries
+     * in real-time without file polling.
+     */
+    ingest(entry) {
+        const level = typeof entry.level === 'number' ? entry.level : 30;
+        this.recentEntries.push({ time: Date.now(), level });
+        this.onEntry?.(entry);
+    }
     getLogStats() {
         const now = Date.now();
         const cutoff = now - ROLLING_WINDOW_MS;
@@ -58,6 +71,10 @@ export class LogStreamService {
         };
     }
     async start() {
+        if (!this.logPath) {
+            // Stream-only mode — entries arrive via ingest(), no file polling
+            return;
+        }
         // Initialize with current file size so we only process new entries
         try {
             const stats = await stat(this.logPath);
@@ -67,6 +84,7 @@ export class LogStreamService {
             // File doesn't exist yet
         }
         this.intervalId = setInterval(() => this.pollNewEntries(), 2000);
+        log.info('log stream watching: ' + this.logPath);
     }
     stop() {
         if (this.intervalId) {
@@ -75,7 +93,10 @@ export class LogStreamService {
         }
     }
     async pollNewEntries() {
+        if (!this.logPath)
+            return;
         try {
+            warnedPollFailure = false;
             const stats = await stat(this.logPath);
             // File was truncated/rotated — reset
             if (stats.size < this.lastSize) {
@@ -96,8 +117,11 @@ export class LogStreamService {
                 }
             }
         }
-        catch {
-            // Silently ignore — file may not exist yet
+        catch (err) {
+            if (!warnedPollFailure) {
+                warnedPollFailure = true;
+                log.warn('log stream: cannot read log file — ' + err?.message);
+            }
         }
     }
 }

package/dist/src/middleware/request_tracking_middleware.d.ts

@@ -8,7 +8,7 @@ import type { NextFn } from '@adonisjs/core/types/http';
  * self-generated data.
  */
 export declare function isExcludedRequest(): boolean;
-export declare function setShouldShow(fn: ((ctx: any) => boolean) | null): void;
+export declare function setShouldShow(fn: ((ctx: HttpContext) => boolean) | null): void;
 export declare function setTraceCollector(collector: TraceCollector | null): void;
 export declare function setDashboardPath(path: string | null): void;
 export declare function setExcludedPrefixes(prefixes: string[]): void;

package/dist/src/middleware/request_tracking_middleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request_tracking_middleware.d.ts","sourceRoot":"","sources":["../../../src/middleware/request_tracking_middleware.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAA;AASvD;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAOD,wBAAgB,aAAa,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,IAAI,QAE/D;AAOD,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI,QAEjE;AAQD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,QAEnD;AASD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAErD;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,WAAW,CAAA;CACpB;AAQD,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,mBAAmB,KAAK,IAAI,CAAC,GAAG,IAAI,QAEpF;AAED,MAAM,CAAC,OAAO,OAAO,yBAAyB;IACtC,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM;CAuE5C"}
+{"version":3,"file":"request_tracking_middleware.d.ts","sourceRoot":"","sources":["../../../src/middleware/request_tracking_middleware.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAA;AAcvD;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAYD,wBAAgB,aAAa,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,GAAG,IAAI,QAEvE;AAOD,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI,QAEjE;AAQD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,QAEnD;AASD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAErD;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,WAAW,CAAA;CACpB;AAQD,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,mBAAmB,KAAK,IAAI,CAAC,GAAG,IAAI,QAEpF;AAED,MAAM,CAAC,OAAO,OAAO,yBAAyB;IACtC,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM;CAoF5C"}

package/dist/src/middleware/request_tracking_middleware.js

@@ -1,6 +1,7 @@
 import { AsyncLocalStorage } from 'node:async_hooks';
 import { performance } from 'node:perf_hooks';
 import { getRequestMetrics } from '../collectors/http_collector.js';
+import { log } from '../utils/logger.js';
 /**
  * AsyncLocalStorage that marks the current request as "excluded" from
  * debug collection. Checked by QueryCollector and EventCollector to
@@ -15,6 +16,10 @@ const excludedRequestAls = new AsyncLocalStorage();
 export function isExcludedRequest() {
     return excludedRequestAls.getStore() === true;
 }
+/**
+ * Warn-once guard for shouldShow callback failures.
+ */
+let warnedShouldShow = false;
 /**
  * Module-level `shouldShow` callback, set by the provider at boot.
  */
@@ -62,7 +67,14 @@ export default class RequestTrackingMiddleware {
             await next();
             return;
         }
+        // Gracefully handle the startup window before collectors initialize.
+        // The provider defers initialization via setImmediate, so early
+        // requests may arrive before httpCollector() has been called.
         const metrics = getRequestMetrics();
+        if (!metrics) {
+            await next();
+            return;
+        }
         const start = performance.now();
         metrics.incrementActiveConnections();
         // Share a lazy shouldShow evaluator with Edge for @serverStats() tag.
@@ -70,14 +82,18 @@ export default class RequestTrackingMiddleware {
         // runs BEFORE router middleware like initialize_auth_middleware and
         // silentAuth — so ctx.auth isn't populated yet. The function is called
         // at Edge render time (inside the controller), when auth is available.
-        if (shouldShowFn && typeof ctx.view?.share === 'function') {
-            ;
-            ctx.view.share({
+        const ctxView = ctx.view;
+        if (shouldShowFn && typeof ctxView?.share === 'function') {
+            ctxView.share({
                 __ssShowFn: () => {
                     try {
                         return shouldShowFn(ctx);
                     }
-                    catch {
+                    catch (err) {
+                        if (!warnedShouldShow) {
+                            warnedShouldShow = true;
+                            log.warn('shouldShow callback threw — stats bar will be hidden: ' + err?.message);
+                        }
                         return false;
                     }
                 },
@@ -86,8 +102,7 @@ export default class RequestTrackingMiddleware {
         // Skip tracing and dashboard persistence for the debug panel's own requests
         // (e.g. /admin/api/debug/*, /admin/api/server-stats) so they don't flood
         // the timeline. HTTP metrics (req/s, avg latency) are still recorded.
-        const skipTracing = excludedPrefixes.length > 0 &&
-            excludedPrefixes.some((prefix) => requestUrl.startsWith(prefix));
+        const skipTracing = excludedPrefixes.some((prefix) => requestUrl.startsWith(prefix));
         const runRequest = async () => {
             try {
                 await next();

package/dist/src/prometheus/prometheus_collector.d.ts

@@ -1,6 +1,7 @@
 import type { ServerStats } from '../types.js';
 import type { ConfigProvider } from '@adonisjs/core/types';
-export declare function serverStatsCollector(): ConfigProvider<any>;
+import type { Collector } from '@julr/adonisjs-prometheus/collectors/collector';
+export declare function serverStatsCollector(): ConfigProvider<Collector>;
 export declare const ServerStatsCollector: {
     instance: {
         update(stats: Partial<ServerStats>): void;

package/dist/src/prometheus/prometheus_collector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prometheus_collector.d.ts","sourceRoot":"","sources":["../../../src/prometheus/prometheus_collector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D,wBAAgB,oBAAoB,IAAI,cAAc,CAAC,GAAG,CAAC,CA6M1D;AAED,eAAO,MAAM,oBAAoB,EAAE;IACjC,QAAQ,EAAE;QAAE,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAA;CAG/D,CAAA"}
+{"version":3,"file":"prometheus_collector.d.ts","sourceRoot":"","sources":["../../../src/prometheus/prometheus_collector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gDAAgD,CAAA;AAI/E,wBAAgB,oBAAoB,IAAI,cAAc,CAAC,SAAS,CAAC,CA+MhE;AAED,eAAO,MAAM,oBAAoB,EAAE;IACjC,QAAQ,EAAE;QAAE,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAA;CAG/D,CAAA"}

package/dist/src/provider/server_stats_provider.d.ts

@@ -13,8 +13,18 @@ export default class ServerStatsProvider {
     private flushTimer;
     private statsController;
     private debugController;
+    private apiController;
+    private dashboardDepsAvailable;
+    private pinoHookActive;
+    private edgePluginActive;
+    private prometheusActive;
+    private transmitAvailable;
+    private transmitChannels;
+    private resolvedConfig;
+    private resolvedCollectors;
     constructor(app: ApplicationService);
     boot(): Promise<void>;
+    private initializeBoot;
     /**
      * Read start/kernel.ts and detect auth-related middleware in server.use()
      * or router.use() blocks. Returns import paths of problematic middleware.
@@ -22,7 +32,23 @@ export default class ServerStatsProvider {
      * Ignores initialize_auth_middleware (no DB query — just sets up ctx.auth).
      */
     private detectGlobalAuthMiddleware;
+    /**
+     * Hook into the AdonisJS logger's Pino stream to feed log entries
+     * directly into the LogStreamService — no file path needed.
+     *
+     * Uses `Symbol.for('pino.stream')` (documented Pino API) to access
+     * the underlying destination stream, then wraps its `write` method
+     * to tee entries into the log collector.
+     */
+    private hookPinoLogger;
     ready(): Promise<void>;
+    private initializeServerStats;
+    /**
+     * Set up the stats collection interval, transmit broadcasting,
+     * and Prometheus integration. Extracted from initializeServerStats
+     * so the ready log fires promptly.
+     */
+    private setupStatsInterval;
     private setupDevToolbar;
     /**
      * Initialize the full-page dashboard: SQLite store, controller,
@@ -32,6 +58,80 @@ export default class ServerStatsProvider {
      * This method creates the controller so those routes become functional.
      */
     private setupDashboard;
+    /** Return diagnostics state for the Internals endpoint. */
+    getDiagnostics(): {
+        timers: {
+            collectionInterval: {
+                active: boolean;
+                intervalMs: number;
+            };
+            dashboardBroadcast: {
+                active: boolean;
+                intervalMs: number;
+            };
+            debugBroadcast: {
+                active: boolean;
+                debounceMs: number;
+            };
+            persistFlush: {
+                active: boolean;
+                intervalMs: number;
+            };
+            retentionCleanup: {
+                active: boolean;
+                intervalMs: number;
+            };
+        };
+        transmit: {
+            available: boolean;
+            channels: string[];
+        };
+        integrations: {
+            prometheus: {
+                active: boolean;
+            };
+            pinoHook: {
+                active: boolean;
+                mode: string;
+            };
+            edgePlugin: {
+                active: boolean;
+            };
+            cacheInspector: {
+                available: boolean;
+            };
+            queueInspector: {
+                available: boolean;
+            };
+        };
+        config: {
+            intervalMs: number;
+            transport: "transmit" | "none";
+            channelName: string;
+            endpoint: string | false;
+            skipInTest: boolean;
+            hasOnStatsCallback: boolean;
+            hasShouldShowCallback: boolean;
+        };
+        devToolbar: {
+            enabled: boolean;
+            maxQueries: number;
+            maxEvents: number;
+            maxEmails: number;
+            maxTraces: number;
+            slowQueryThresholdMs: number;
+            tracing: boolean;
+            dashboard: boolean;
+            dashboardPath: string;
+            debugEndpoint: string;
+            retentionDays: number;
+            dbPath: string;
+            persistDebugData: string | boolean;
+            renderer: "preact" | "vue";
+            excludeFromTracing: string[];
+            customPaneCount: number;
+        };
+    };
     shutdown(): Promise<void>;
 }
 //# sourceMappingURL=server_stats_provider.d.ts.map

package/dist/src/provider/server_stats_provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server_stats_provider.d.ts","sourceRoot":"","sources":["../../../src/provider/server_stats_provider.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAE9D,MAAM,CAAC,OAAO,OAAO,mBAAmB;IAc1B,SAAS,CAAC,GAAG,EAAE,kBAAkB;IAb7C,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,mBAAmB,CAAmC;IAC9D,OAAO,CAAC,kBAAkB,CAAgC;IAC1D,OAAO,CAAC,uBAAuB,CAA8C;IAC7E,OAAO,CAAC,mBAAmB,CAA6C;IACxE,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,eAAe,CAAqC;IAC5D,OAAO,CAAC,eAAe,CAA+B;gBAEhC,GAAG,EAAE,kBAAkB;IAEvC,IAAI;IA4GV;;;;;OAKG;IACH,OAAO,CAAC,0BAA0B;IAmD5B,KAAK;YAuFG,eAAe;IAwF7B;;;;;;OAMG;YACW,cAAc;IAoGtB,QAAQ;CAwCf"}
+{"version":3,"file":"server_stats_provider.d.ts","sourceRoot":"","sources":["../../../src/provider/server_stats_provider.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAQ9D,MAAM,CAAC,OAAO,OAAO,mBAAmB;IA2B1B,SAAS,CAAC,GAAG,EAAE,kBAAkB;IA1B7C,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,mBAAmB,CAAmC;IAC9D,OAAO,CAAC,kBAAkB,CAAgC;IAC1D,OAAO,CAAC,uBAAuB,CAA8C;IAC7E,OAAO,CAAC,mBAAmB,CAA6C;IACxE,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,eAAe,CAAqC;IAC5D,OAAO,CAAC,eAAe,CAA+B;IACtD,OAAO,CAAC,aAAa,CAA6B;IAGlD,OAAO,CAAC,sBAAsB,CAAgB;IAG9C,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,gBAAgB,CAAiB;IACzC,OAAO,CAAC,gBAAgB,CAAiB;IACzC,OAAO,CAAC,iBAAiB,CAAiB;IAC1C,OAAO,CAAC,gBAAgB,CAAe;IACvC,OAAO,CAAC,cAAc,CAAyC;IAC/D,OAAO,CAAC,kBAAkB,CAAwB;gBAE5B,GAAG,EAAE,kBAAkB;IAEvC,IAAI;YAcI,cAAc;IA8I5B;;;;;OAKG;IACH,OAAO,CAAC,0BAA0B;IAmDlC;;;;;;;OAOG;YACW,cAAc;IAqCtB,KAAK;YAuBG,qBAAqB;IA6FnC;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;YA2DZ,eAAe;IA8G7B;;;;;;OAMG;YACW,cAAc;IA0L5B,2DAA2D;IAC3D,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA2ER,QAAQ;CAwCf"}