adonisjs-server-stats 1.4.0 → 1.5.2

package/dist/src/edge/plugin.d.ts

@@ -1,4 +1,4 @@
-import type { ServerStatsConfig } from "../types.js";
+import type { ServerStatsConfig } from '../types.js';
 /**
  * Edge plugin that registers the `@serverStats()` tag.
  *

package/dist/src/edge/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/edge/plugin.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AA0BrD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,iBAAiB,IACrD,MAAM,GAAG,UAoIlB"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/edge/plugin.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAKpD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,iBAAiB,IACrD,MAAM,GAAG,UAmHlB"}

package/dist/src/edge/plugin.js

@@ -1,26 +1,10 @@
-import { readFileSync } from "node:fs";
-import { createRequire } from "node:module";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-import { Template } from "edge.js";
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { Template } from 'edge.js';
+import { loadTransmitClient } from '../utils/transmit_client.js';
 const DIR = dirname(fileURLToPath(import.meta.url));
-const read = (rel) => readFileSync(join(DIR, rel), "utf-8");
-/**
- * Try to locate and read the @adonisjs/transmit-client build file.
- * Returns the file contents wrapped to expose `window.Transmit`, or
- * an empty string if the package is not installed.
- */
-function loadTransmitClient() {
-    try {
-        const req = createRequire(join(process.cwd(), "package.json"));
-        const clientPath = req.resolve("@adonisjs/transmit-client/build/index.js");
-        const src = readFileSync(clientPath, "utf-8");
-        return `(function(){var __exports={};(function(){${src.replace(/^export\s*\{[^}]*\}\s*;?\s*$/m, "")}\n__exports.Transmit=Transmit;})();window.Transmit=__exports.Transmit;})()`;
-    }
-    catch {
-        return "";
-    }
-}
+const read = (rel) => readFileSync(join(DIR, rel), 'utf-8');
 /**
  * Edge plugin that registers the `@serverStats()` tag.
  *
@@ -43,64 +27,62 @@ function loadTransmitClient() {
 export function edgePluginServerStats(config) {
     return (edge) => {
         // Mount Edge views under the `ss` disk (needed for @include resolution)
-        edge.mount("ss", join(DIR, "views"));
+        edge.mount('ss', join(DIR, 'views'));
         // Read client assets once at boot
-        const css = read("client/stats-bar.css");
-        const js = read("client/stats-bar.js");
-        const endpoint = typeof config.endpoint === "string"
-            ? config.endpoint
-            : "/admin/api/server-stats";
+        const css = read('client/stats-bar.css');
+        const js = read('client/stats-bar.js');
+        const endpoint = typeof config.endpoint === 'string' ? config.endpoint : '/admin/api/server-stats';
         const intervalMs = config.intervalMs || 3000;
         const showDebug = !!config.devToolbar?.enabled;
         // Badge groups for the Edge template
         const groups = [
             // Process
             [
-                { id: "node", label: "NODE" },
-                { id: "up", label: "UP" },
-                { id: "cpu", label: "CPU" },
-                { id: "evt", label: "EVT" },
+                { id: 'node', label: 'NODE' },
+                { id: 'up', label: 'UP' },
+                { id: 'cpu', label: 'CPU' },
+                { id: 'evt', label: 'EVT' },
             ],
             // Memory
             [
-                { id: "mem", label: "HEAP" },
-                { id: "rss", label: "RSS" },
-                { id: "sys", label: "SYS" },
+                { id: 'mem', label: 'HEAP' },
+                { id: 'rss', label: 'RSS' },
+                { id: 'sys', label: 'SYS' },
             ],
             // HTTP
             [
-                { id: "rps", label: "REQ/s" },
-                { id: "avg", label: "AVG" },
-                { id: "err", label: "ERR" },
-                { id: "conn", label: "CONN" },
+                { id: 'rps', label: 'REQ/s' },
+                { id: 'avg', label: 'AVG' },
+                { id: 'err', label: 'ERR' },
+                { id: 'conn', label: 'CONN' },
             ],
             // DB
-            [{ id: "db", label: "DB" }],
+            [{ id: 'db', label: 'DB' }],
             // Redis
             [
-                { id: "redis", label: "REDIS" },
-                { id: "rmem", label: "MEM" },
-                { id: "rkeys", label: "KEYS" },
-                { id: "rhit", label: "HIT" },
+                { id: 'redis', label: 'REDIS' },
+                { id: 'rmem', label: 'MEM' },
+                { id: 'rkeys', label: 'KEYS' },
+                { id: 'rhit', label: 'HIT' },
             ],
             // Queue
             [
-                { id: "q", label: "Q" },
-                { id: "workers", label: "WORKERS" },
+                { id: 'q', label: 'Q' },
+                { id: 'workers', label: 'WORKERS' },
             ],
             // App
             [
-                { id: "users", label: "USERS" },
-                { id: "hooks", label: "HOOKS" },
-                { id: "mail", label: "MAIL" },
+                { id: 'users', label: 'USERS' },
+                { id: 'hooks', label: 'HOOKS' },
+                { id: 'mail', label: 'MAIL' },
             ],
             // Logs
             [
-                { id: "logerr", label: "LOG ERR" },
-                { id: "lograte", label: "LOG/m" },
+                { id: 'logerr', label: 'LOG ERR' },
+                { id: 'lograte', label: 'LOG/m' },
             ],
             // Debug (conditional)
-            ...(showDebug ? [[{ id: "dbg-queries", label: "QRY" }]] : []),
+            ...(showDebug ? [[{ id: 'dbg-queries', label: 'QRY' }]] : []),
         ];
         const state = {
             css,
@@ -111,25 +93,25 @@ export function edgePluginServerStats(config) {
             groups,
         };
         if (showDebug) {
-            state.debugCss = read("client/debug-panel.css");
-            state.debugJs = read("client/debug-panel.js");
-            state.logsEndpoint = "/admin/api/debug/logs";
+            state.debugCss = read('client/debug-panel.css');
+            state.debugJs = read('client/debug-panel.js');
+            state.logsEndpoint = '/admin/api/debug/logs';
             state.customPanes = config.devToolbar?.panes || [];
             state.showTracing = !!config.devToolbar?.tracing;
             state.dashboardPath = config.devToolbar?.dashboard
-                ? (config.devToolbar.dashboardPath || '/__stats')
+                ? config.devToolbar.dashboardPath || '/__stats'
                 : null;
-            state.transmitClient = loadTransmitClient();
+            state.transmitClient = loadTransmitClient(join(process.cwd(), 'package.json'));
         }
         // Pre-render via Template directly — bypasses edge.createRenderer() which
         // would re-run #executePlugins and cause infinite recursion.
         const template = new Template(edge.compiler, edge.globals, {}, edge.processor);
-        const html = template.render("ss::stats-bar", state);
+        const html = template.render('ss::stats-bar', state);
         const escaped = JSON.stringify(html);
         // Track whether shouldShow is configured (controls render-time guard)
         const hasShouldShow = !!config.shouldShow;
         edge.registerTag({
-            tagName: "serverStats",
+            tagName: 'serverStats',
             block: false,
             seekable: true,
             compile(_parser, buffer, token) {

package/dist/src/edge/views/stats-bar.edge

@@ -5,7 +5,7 @@
 <div id="ss-bar" class="ss-bar" data-endpoint="{{ endpoint }}" data-interval="{{ intervalMs }}">
   <div class="ss-bar-left">
     @if(showDebug)
-      <button type="button" id="ss-dbg-wrench" class="ss-dbg-btn" title="Open debug panel">🔍</button>
+      <button type="button" id="ss-dbg-wrench" class="ss-dbg-btn" title="Open debug panel">🔍 Open debug panel</button>
     @end
     <div id="ss-dot" class="ss-dot"></div>
   </div>

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, LogStats, DevToolbarOptions, } 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,EAAE,WAAW,EAAE,WAAW,EAAE,iBAAiB,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC1G,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,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"}

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

@@ -1,7 +1,7 @@
-import type { HttpContext } from "@adonisjs/core/http";
-import type { NextFn } from "@adonisjs/core/types/http";
-import type { TraceCollector } from "../debug/trace_collector.js";
-import type { TraceRecord } from "../debug/types.js";
+import type { TraceCollector } from '../debug/trace_collector.js';
+import type { TraceRecord } from '../debug/types.js';
+import type { HttpContext } from '@adonisjs/core/http';
+import type { NextFn } from '@adonisjs/core/types/http';
 /**
  * Returns true if the current async context is inside an excluded request
  * (e.g. a debug panel polling request). Used by collectors to skip

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,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AASrD;;;;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,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAQD,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,mBAAmB,KAAK,IAAI,CAAC,GAAG,IAAI,QAGjD;AAED,MAAM,CAAC,OAAO,OAAO,yBAAyB;IACtC,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM;CAsE5C"}
+{"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"}

package/dist/src/middleware/request_tracking_middleware.js

@@ -1,6 +1,6 @@
-import { AsyncLocalStorage } from "node:async_hooks";
-import { performance } from "node:perf_hooks";
-import { getRequestMetrics } from "../collectors/http_collector.js";
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { performance } from 'node:perf_hooks';
+import { getRequestMetrics } from '../collectors/http_collector.js';
 /**
  * AsyncLocalStorage that marks the current request as "excluded" from
  * debug collection. Checked by QueryCollector and EventCollector to
@@ -70,7 +70,8 @@ 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") {
+        if (shouldShowFn && typeof ctx.view?.share === 'function') {
+            ;
             ctx.view.share({
                 __ssShowFn: () => {
                     try {
@@ -85,8 +86,8 @@ 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.length > 0 &&
+            excludedPrefixes.some((prefix) => requestUrl.startsWith(prefix));
         const runRequest = async () => {
             try {
                 await next();

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

@@ -1,5 +1,5 @@
-import type { ConfigProvider } from '@adonisjs/core/types';
 import type { ServerStats } from '../types.js';
+import type { ConfigProvider } from '@adonisjs/core/types';
 export declare function serverStatsCollector(): ConfigProvider<any>;
 export declare const ServerStatsCollector: {
     instance: {

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,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C,wBAAgB,oBAAoB,IAAI,cAAc,CAAC,GAAG,CAAC,CA4M1D;AAED,eAAO,MAAM,oBAAoB,EAAE;IAAE,QAAQ,EAAE;QAAE,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAA;CAElG,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;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"}

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

@@ -1,4 +1,4 @@
-import type { ApplicationService } from "@adonisjs/core/types";
+import type { ApplicationService } from '@adonisjs/core/types';
 export default class ServerStatsProvider {
     protected app: ApplicationService;
     private intervalId;

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":"AAaA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAK/D,MAAM,CAAC,OAAO,OAAO,mBAAmB;IAY1B,SAAS,CAAC,GAAG,EAAE,kBAAkB;IAX7C,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,mBAAmB,CAAoC;IAC/D,OAAO,CAAC,kBAAkB,CAAiC;IAC3D,OAAO,CAAC,uBAAuB,CAA+C;IAC9E,OAAO,CAAC,mBAAmB,CAA8C;IACzE,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,UAAU,CAA+C;gBAE3C,GAAG,EAAE,kBAAkB;IAEvC,IAAI;IAuCJ,KAAK;YAoFG,eAAe;IAqF7B;;;;;;OAMG;YACW,cAAc;IA4GtB,QAAQ;CAwCf"}
+{"version":3,"file":"server_stats_provider.d.ts","sourceRoot":"","sources":["../../../src/provider/server_stats_provider.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAE9D,MAAM,CAAC,OAAO,OAAO,mBAAmB;IAY1B,SAAS,CAAC,GAAG,EAAE,kBAAkB;IAX7C,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;gBAE1C,GAAG,EAAE,kBAAkB;IAEvC,IAAI;IAkCJ,KAAK;YA+EG,eAAe;IAmF7B;;;;;;OAMG;YACW,cAAc;IAoGtB,QAAQ;CAwCf"}

package/dist/src/provider/server_stats_provider.js

@@ -1,9 +1,9 @@
-import { StatsEngine } from "../engine/stats_engine.js";
-import { DebugStore } from "../debug/debug_store.js";
-import { DashboardStore } from "../dashboard/dashboard_store.js";
-import { LogStreamService } from "../log_stream/log_stream_service.js";
-import { setShouldShow, setTraceCollector, setDashboardPath, setExcludedPrefixes, setOnRequestComplete, } from "../middleware/request_tracking_middleware.js";
-import { registerDashboardRoutes } from "../dashboard/dashboard_routes.js";
+import { registerDashboardRoutes } from '../dashboard/dashboard_routes.js';
+import { DashboardStore } from '../dashboard/dashboard_store.js';
+import { DebugStore } from '../debug/debug_store.js';
+import { StatsEngine } from '../engine/stats_engine.js';
+import { LogStreamService } from '../log_stream/log_stream_service.js';
+import { setShouldShow, setTraceCollector, setDashboardPath, setExcludedPrefixes, setOnRequestComplete, } from '../middleware/request_tracking_middleware.js';
 export default class ServerStatsProvider {
     app;
     intervalId = null;
@@ -20,7 +20,7 @@ export default class ServerStatsProvider {
         this.app = app;
     }
     async boot() {
-        const config = this.app.config.get("server_stats");
+        const config = this.app.config.get('server_stats');
         if (!config)
             return;
         // Wire up the per-request shouldShow callback
@@ -32,7 +32,7 @@ export default class ServerStatsProvider {
         const toolbarConfig = config.devToolbar;
         if (toolbarConfig?.enabled && toolbarConfig.dashboard && !this.app.inProduction) {
             try {
-                const router = await this.app.container.make("router");
+                const router = await this.app.container.make('router');
                 const dashPath = toolbarConfig.dashboardPath ?? '/__stats';
                 registerDashboardRoutes(router, dashPath, () => this.dashboardController, config.shouldShow);
             }
@@ -43,8 +43,8 @@ export default class ServerStatsProvider {
         if (!this.app.usingEdgeJS)
             return;
         try {
-            const edge = await import("edge.js");
-            const { edgePluginServerStats } = await import("../edge/plugin.js");
+            const edge = await import('edge.js');
+            const { edgePluginServerStats } = await import('../edge/plugin.js');
             edge.default.use(edgePluginServerStats(config));
         }
         catch {
@@ -52,14 +52,13 @@ export default class ServerStatsProvider {
         }
     }
     async ready() {
-        const config = this.app.config.get("server_stats");
+        const config = this.app.config.get('server_stats');
         if (!config)
             return;
         if (this.app.inTest && config.skipInTest !== false)
             return;
         this.engine = new StatsEngine(config.collectors);
-        // Bind engine to container so the controller can access it
-        this.app.container.singleton("server_stats.engine", () => this.engine);
+        this.app.container.singleton('server_stats.engine', () => this.engine);
         await this.engine.start();
         // Dev toolbar setup
         const toolbarConfig = config.devToolbar;
@@ -80,7 +79,8 @@ export default class ServerStatsProvider {
             });
             // Exclude the stats endpoint and user-specified prefixes from tracing
             // so the debug panel's own polling doesn't flood the timeline
-            const prefixes = [...(toolbarConfig.excludeFromTracing ?? [])];
+            const defaultExcludes = ['/admin/api/debug', '/admin/api/server-stats'];
+            const prefixes = [...(toolbarConfig.excludeFromTracing ?? defaultExcludes)];
             if (typeof config.endpoint === 'string') {
                 prefixes.push(config.endpoint);
             }
@@ -89,9 +89,9 @@ export default class ServerStatsProvider {
             }
         }
         let transmit = null;
-        if (config.transport === "transmit") {
+        if (config.transport === 'transmit') {
             try {
-                transmit = await this.app.container.make("transmit");
+                transmit = await this.app.container.make('transmit');
             }
             catch {
                 // Transmit not installed — skip broadcasting
@@ -99,7 +99,7 @@ export default class ServerStatsProvider {
         }
         let prometheusCollector = null;
         try {
-            const mod = await import("../prometheus/prometheus_collector.js");
+            const mod = await import('../prometheus/prometheus_collector.js');
             prometheusCollector = mod.ServerStatsCollector.instance;
         }
         catch {
@@ -123,19 +123,19 @@ export default class ServerStatsProvider {
     }
     async setupDevToolbar(toolbarConfig) {
         this.debugStore = new DebugStore(toolbarConfig);
-        // Bind debug store to container
-        this.app.container.singleton("debug.store", () => this.debugStore);
+        this.app.container.singleton('debug.store', () => this.debugStore);
         // Load persisted data before starting collectors
         if (toolbarConfig.persistDebugData) {
-            this.persistPath = typeof toolbarConfig.persistDebugData === 'string'
-                ? this.app.makePath(toolbarConfig.persistDebugData)
-                : this.app.makePath('.adonisjs', 'server-stats', 'debug-data.json');
+            this.persistPath =
+                typeof toolbarConfig.persistDebugData === 'string'
+                    ? this.app.makePath(toolbarConfig.persistDebugData)
+                    : this.app.makePath('.adonisjs', 'server-stats', 'debug-data.json');
             await this.debugStore.loadFromDisk(this.persistPath);
         }
         // Get the emitter
         let emitter = null;
         try {
-            emitter = await this.app.container.make("emitter");
+            emitter = await this.app.container.make('emitter');
         }
         catch {
             // Emitter not available
@@ -143,7 +143,7 @@ export default class ServerStatsProvider {
         // Get the router
         let router = null;
         try {
-            router = await this.app.container.make("router");
+            router = await this.app.container.make('router');
         }
         catch {
             // Router not available
@@ -167,13 +167,13 @@ export default class ServerStatsProvider {
         // ── Transmit broadcasting for debug panel live updates ────────
         let debugTransmit = null;
         try {
-            debugTransmit = await this.app.container.make("transmit");
+            debugTransmit = await this.app.container.make('transmit');
         }
         catch {
             // Transmit not installed — debug panel will use polling
         }
         if (debugTransmit) {
-            const debugChannel = "server-stats/debug";
+            const debugChannel = 'server-stats/debug';
             const pendingTypes = new Set();
             this.debugStore.onNewItem((type) => {
                 // Debounce: coalesce rapid events into a single broadcast
@@ -224,14 +224,15 @@ export default class ServerStatsProvider {
             throw err;
         }
         // Bind to container
-        this.app.container.singleton("dashboard.store", () => this.dashboardStore);
+        ;
+        this.app.container.singleton('dashboard.store', () => this.dashboardStore);
         // Set dashboard path in middleware for self-exclusion
         setDashboardPath(toolbarConfig.dashboardPath);
         // Create the controller — this makes the routes registered in boot() functional
-        const DashboardControllerClass = (await import("../dashboard/dashboard_controller.js")).default;
+        const DashboardControllerClass = (await import('../dashboard/dashboard_controller.js')).default;
         this.dashboardController = new DashboardControllerClass(this.dashboardStore, this.debugStore, this.app);
         // ── Log piping ────────────────────────────────────────────────
-        const logPath = this.app.makePath("logs", "adonisjs.log");
+        const logPath = this.app.makePath('logs', 'adonisjs.log');
         this.dashboardLogStream = new LogStreamService(logPath, (entry) => {
             this.dashboardStore?.recordLog(entry);
         });
@@ -271,18 +272,18 @@ export default class ServerStatsProvider {
         // ── Transmit streaming for real-time dashboard updates ────────
         let transmit = null;
         try {
-            transmit = await this.app.container.make("transmit");
+            transmit = await this.app.container.make('transmit');
         }
         catch {
             // Transmit not installed — skip real-time updates
         }
         if (transmit) {
-            const dashChannel = "server-stats/dashboard";
+            const dashChannel = 'server-stats/dashboard';
             this.dashboardBroadcastTimer = setInterval(async () => {
                 try {
                     if (!dashStore.isReady())
                         return;
-                    const overview = await dashStore.getOverviewMetrics("1h");
+                    const overview = await dashStore.getOverviewMetrics('1h');
                     transmit.broadcast(dashChannel, overview);
                 }
                 catch {

package/dist/src/types.d.ts

@@ -281,10 +281,10 @@ export interface DevToolbarOptions {
      *
      * @example
      * ```ts
-     * excludeFromTracing: ['/admin/api/debug']
+     * excludeFromTracing: ['/admin/api/debug', '/admin/api/server-stats']
      * ```
      *
-     * @default []
+     * @default ['/admin/api/debug', '/admin/api/server-stats']
      */
     excludeFromTracing?: string[];
 }

package/dist/src/utils/json_helpers.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Shared JSON parsing utilities with safe fallbacks.
+ */
+/** Safely parse a JSON string, returning the original value on failure. */
+export declare function safeParseJson(value: any): any;
+/** Safely parse a JSON string expected to be an array, returning [] on failure. */
+export declare function safeParseJsonArray(value: any): any[];
+//# sourceMappingURL=json_helpers.d.ts.map

package/dist/src/utils/json_helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json_helpers.d.ts","sourceRoot":"","sources":["../../../src/utils/json_helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG,CAQ7C;AAED,mFAAmF;AACnF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG,EAAE,CAGpD"}

package/dist/src/utils/json_helpers.js

@@ -0,0 +1,21 @@
+/**
+ * Shared JSON parsing utilities with safe fallbacks.
+ */
+/** Safely parse a JSON string, returning the original value on failure. */
+export function safeParseJson(value) {
+    if (value === null || value === undefined)
+        return null;
+    if (typeof value !== 'string')
+        return value;
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return value;
+    }
+}
+/** Safely parse a JSON string expected to be an array, returning [] on failure. */
+export function safeParseJsonArray(value) {
+    const parsed = safeParseJson(value);
+    return Array.isArray(parsed) ? parsed : [];
+}

package/dist/src/utils/mail_helpers.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Shared email address extraction utilities.
+ */
+/**
+ * Normalize various AdonisJS mail address formats to a comma-separated string.
+ *
+ * Handles:
+ * - A string: `"user@example.com"`
+ * - An object: `{ address: "user@example.com", name: "User" }`
+ * - An array of strings or objects
+ */
+export declare function extractAddresses(value: any): string;
+//# sourceMappingURL=mail_helpers.d.ts.map

package/dist/src/utils/mail_helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail_helpers.d.ts","sourceRoot":"","sources":["../../../src/utils/mail_helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,CAWnD"}

package/dist/src/utils/mail_helpers.js

@@ -0,0 +1,26 @@
+/**
+ * Shared email address extraction utilities.
+ */
+/**
+ * Normalize various AdonisJS mail address formats to a comma-separated string.
+ *
+ * Handles:
+ * - A string: `"user@example.com"`
+ * - An object: `{ address: "user@example.com", name: "User" }`
+ * - An array of strings or objects
+ */
+export function extractAddresses(value) {
+    if (!value)
+        return '';
+    if (typeof value === 'string')
+        return value;
+    if (Array.isArray(value)) {
+        return value
+            .map((v) => (typeof v === 'string' ? v : v?.address || ''))
+            .filter(Boolean)
+            .join(', ');
+    }
+    if (typeof value === 'object' && value.address)
+        return value.address;
+    return '';
+}

package/dist/src/utils/math_helpers.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Shared math utilities used across dashboard, collectors, and chart aggregator.
+ */
+/** Round a number to 2 decimal places. */
+export declare function round(n: number): number;
+/** Clamp a value between min and max. */
+export declare function clamp(value: number, min: number, max: number): number;
+//# sourceMappingURL=math_helpers.d.ts.map

package/dist/src/utils/math_helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math_helpers.d.ts","sourceRoot":"","sources":["../../../src/utils/math_helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,0CAA0C;AAC1C,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEvC;AAED,yCAAyC;AACzC,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAErE"}

package/dist/src/utils/math_helpers.js

@@ -0,0 +1,11 @@
+/**
+ * Shared math utilities used across dashboard, collectors, and chart aggregator.
+ */
+/** Round a number to 2 decimal places. */
+export function round(n) {
+    return Math.round(n * 100) / 100;
+}
+/** Clamp a value between min and max. */
+export function clamp(value, min, max) {
+    return Math.max(min, Math.min(max, value));
+}

package/dist/src/utils/time_helpers.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Shared time/range utilities for dashboard store, controller, and chart aggregator.
+ */
+/** Convert a range string (e.g. '1h', '7d') to total minutes. */
+export declare function rangeToMinutes(range: string): number;
+/** Convert a range string to a SQLite-compatible datetime cutoff. */
+export declare function rangeToCutoff(range: string): string;
+/** Convert a Date to a SQLite-compatible datetime string (YYYY-MM-DD HH:MM:SS). */
+export declare function toSqliteTimestamp(date: Date): string;
+/** Round a bucket timestamp string down to the nearest N minutes. */
+export declare function roundBucket(bucket: string, minutes: number): string;
+//# sourceMappingURL=time_helpers.d.ts.map

package/dist/src/utils/time_helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time_helpers.d.ts","sourceRoot":"","sources":["../../../src/utils/time_helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,qEAAqE;AACrE,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED,mFAAmF;AACnF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAEpD;AAED,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAKnE"}