adonisjs-server-stats 1.5.4 → 1.6.2

package/dist/src/debug/route_inspector.d.ts

@@ -1,4 +1,4 @@
-import type { RouteRecord } from './types.js';
+import type { RouteRecord, Router } from './types.js';
 /**
  * Reads the router's route table at boot time and caches it.
  * Static data computed once — routes don't change after boot.
@@ -9,7 +9,7 @@ export declare class RouteInspector {
      * Inspect the router and cache all routes.
      * Call this in the provider's `ready()` hook.
      */
-    inspect(router: any): void;
+    inspect(router: Router): void;
     private resolveHandler;
     private resolveMiddleware;
     getRoutes(): RouteRecord[];

package/dist/src/debug/route_inspector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route_inspector.d.ts","sourceRoot":"","sources":["../../../src/debug/route_inspector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAoB;IAElC;;;OAGG;IACH,OAAO,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI;IAoC1B,OAAO,CAAC,cAAc;IAoBtB,OAAO,CAAC,iBAAiB;IA2BzB,SAAS,IAAI,WAAW,EAAE;IAI1B,aAAa,IAAI,MAAM;CAGxB"}
+{"version":3,"file":"route_inspector.d.ts","sourceRoot":"","sources":["../../../src/debug/route_inspector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAiD,MAAM,YAAY,CAAA;AAEpG;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAoB;IAElC;;;OAGG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAsC7B,OAAO,CAAC,cAAc;IAsBtB,OAAO,CAAC,iBAAiB;IA2BzB,SAAS,IAAI,WAAW,EAAE;IAI1B,aAAa,IAAI,MAAM;CAGxB"}

package/dist/src/debug/route_inspector.js

@@ -1,3 +1,4 @@
+import { log } from '../utils/logger.js';
 /**
  * Reads the router's route table at boot time and caches it.
  * Static data computed once — routes don't change after boot.
@@ -36,8 +37,8 @@ export class RouteInspector {
                 }
             }
         }
-        catch {
-            // Router not available or incompatible — empty route list
+        catch (err) {
+            log.warn(`route inspector: could not read routes — ${err?.message || 'unknown error'}`);
         }
     }
     resolveHandler(handler) {
@@ -66,7 +67,7 @@ export class RouteInspector {
             return [];
         // AdonisJS v6 middleware is a Middleware instance from @poppinss/middleware.
         // Call .all() to get the Set of middleware items.
-        const items = typeof middleware.all === 'function'
+        const items = !Array.isArray(middleware) && typeof middleware.all === 'function'
             ? middleware.all()
             : Array.isArray(middleware)
                 ? middleware

package/dist/src/debug/trace_collector.d.ts

@@ -1,4 +1,4 @@
-import type { TraceSpan, TraceRecord } from './types.js';
+import type { TraceSpan, TraceRecord, Emitter } from './types.js';
 /**
  * Wrap an async function in a traced span.
  *
@@ -33,17 +33,21 @@ export declare class TraceCollector {
     /** Finish the current trace and save it to the ring buffer. Returns the record, or null if no context. */
     finishTrace(method: string, url: string, statusCode: number): TraceRecord | null;
     /** Add a span to the current trace (if active). */
-    addSpan(label: string, category: TraceSpan['category'], startOffset: number, duration: number, metadata?: Record<string, any>): void;
+    addSpan(label: string, category: TraceSpan['category'], startOffset: number, duration: number, metadata?: Record<string, unknown>): void;
     /** Wrap a function in a traced span with automatic nesting. */
     span<T>(label: string, category: TraceSpan['category'], fn: () => Promise<T>): Promise<T>;
     /** Hook into db:query events and console.warn to auto-create spans. */
-    start(emitter: any): void;
+    start(emitter: Emitter): void;
     /** Unhook event listeners and restore console.warn. */
     stop(): void;
     getTraces(): TraceRecord[];
     getLatest(n: number): TraceRecord[];
     getTrace(id: number): TraceRecord | undefined;
     getTotalCount(): number;
+    getBufferInfo(): {
+        current: number;
+        max: number;
+    };
     clear(): void;
     /** Register a callback that fires whenever a new trace is recorded. */
     onNewItem(cb: ((item: TraceRecord) => void) | null): void;

package/dist/src/debug/trace_collector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trace_collector.d.ts","sourceRoot":"","sources":["../../../src/debug/trace_collector.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAmBxD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAG9E;AAED;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,GAAG,CAAwC;IACnD,OAAO,CAAC,OAAO,CAAY;IAC3B,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,mBAAmB,CAAmC;gBAElD,SAAS,GAAE,MAAY;IAKnC,qDAAqD;IACrD,UAAU,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAWxD,0GAA0G;IAC1G,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAsBhF,mDAAmD;IACnD,OAAO,CACL,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,SAAS,CAAC,UAAU,CAAC,EAC/B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC7B,IAAI;IAeP,+DAA+D;IACzD,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAyB/F,uEAAuE;IACvE,KAAK,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI;IAsCzB,uDAAuD;IACvD,IAAI,IAAI,IAAI;IAaZ,SAAS,IAAI,WAAW,EAAE;IAI1B,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE;IAInC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI7C,aAAa,IAAI,MAAM;IAIvB,KAAK,IAAI,IAAI;IAIb,uEAAuE;IACvE,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI;IAIzD,0EAA0E;IAC1E,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI;CAK1C"}
+{"version":3,"file":"trace_collector.d.ts","sourceRoot":"","sources":["../../../src/debug/trace_collector.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAgB,MAAM,YAAY,CAAA;AAmB/E;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAG9E;AAED;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,GAAG,CAAwC;IACnD,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,SAAS,CAA8C;IAC/D,OAAO,CAAC,mBAAmB,CAAmC;gBAElD,SAAS,GAAE,MAAY;IAKnC,qDAAqD;IACrD,UAAU,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAWxD,0GAA0G;IAC1G,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAsBhF,mDAAmD;IACnD,OAAO,CACL,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,SAAS,CAAC,UAAU,CAAC,EAC/B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,IAAI;IAeP,+DAA+D;IACzD,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAyB/F,uEAAuE;IACvE,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAqC7B,uDAAuD;IACvD,IAAI,IAAI,IAAI;IAaZ,SAAS,IAAI,WAAW,EAAE;IAI1B,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE;IAInC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI7C,aAAa,IAAI,MAAM;IAIvB,aAAa,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;IAIjD,KAAK,IAAI,IAAI;IAIb,uEAAuE;IACvE,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI;IAIzD,0EAA0E;IAC1E,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI;CAK1C"}

package/dist/src/debug/trace_collector.js

@@ -40,7 +40,7 @@ export class TraceCollector {
     originalConsoleWarn = null;
     constructor(maxTraces = 200) {
         this.buffer = new RingBuffer(maxTraces);
-        globalTraceCollector = this;
+        globalTraceCollector = this; // eslint-disable-line @typescript-eslint/no-this-alias
     }
     /** Start a new trace context for an HTTP request. */
     startTrace(callback) {
@@ -137,13 +137,12 @@ export class TraceCollector {
         }
         // Intercept console.warn to capture warnings per-request
         this.originalConsoleWarn = console.warn;
-        const self = this;
-        console.warn = function (...args) {
-            const ctx = self.als.getStore();
+        console.warn = (...args) => {
+            const ctx = this.als.getStore();
             if (ctx) {
                 ctx.warnings.push(args.map(String).join(' '));
             }
-            self.originalConsoleWarn.apply(console, args);
+            this.originalConsoleWarn.apply(console, args);
         };
     }
     /** Unhook event listeners and restore console.warn. */
@@ -171,6 +170,9 @@ export class TraceCollector {
     getTotalCount() {
         return this.buffer.size();
     }
+    getBufferInfo() {
+        return { current: this.buffer.size(), max: this.buffer.getCapacity() };
+    }
     clear() {
         this.buffer.clear();
     }

package/dist/src/debug/types.d.ts

@@ -1,3 +1,108 @@
+/** Callback type for emitter event handlers. */
+export type EmitterHandler = (...args: any[]) => void;
+/**
+ * Minimal interface for the AdonisJS event emitter.
+ *
+ * Only the methods actually used by the debug collectors are declared,
+ * keeping the coupling to the framework as loose as possible.
+ *
+ * The handler parameter uses `any[]` because the AdonisJS emitter
+ * dispatches different payload shapes per event and the subscriber
+ * signatures vary accordingly (contravariance).
+ */
+export interface Emitter {
+    on(event: string, handler: EmitterHandler): void;
+    off(event: string, handler: EmitterHandler): void;
+    emit(event: string | ((...args: unknown[]) => unknown), data?: unknown): unknown;
+}
+/**
+ * Minimal interface for the AdonisJS router.
+ *
+ * The `toJSON()` method returns a domain-keyed map of route arrays.
+ */
+export interface Router {
+    toJSON(): Record<string, RouteNode[]>;
+}
+/**
+ * A single route entry as returned by `router.toJSON()`.
+ */
+export interface RouteNode {
+    methods?: string[];
+    pattern?: string;
+    name?: string | null;
+    handler?: string | ((...args: unknown[]) => unknown) | RouteHandler;
+    middleware?: MiddlewareStore | MiddlewareItem[];
+}
+/**
+ * AdonisJS route handler — can be a string, a function, or a lazy-import
+ * descriptor with a `reference` property.
+ */
+export interface RouteHandler {
+    reference?: string | string[];
+    name?: string;
+}
+/**
+ * AdonisJS middleware store attached to a route.
+ *
+ * In v6 this is a `@poppinss/middleware` instance exposing `.all()`.
+ */
+export interface MiddlewareStore {
+    all?(): Iterable<MiddlewareItem>;
+}
+/**
+ * A single middleware item — can be a string name, a function, or an
+ * object with `name` and optional `args`.
+ */
+export interface MiddlewareItem {
+    name?: string;
+    args?: unknown[];
+}
+/**
+ * Payload shape of the `db:query` event emitted by Lucid.
+ */
+export interface DbQueryEvent {
+    sql?: string;
+    bindings?: unknown[];
+    duration?: number | [seconds: number, nanoseconds: number];
+    method?: string;
+    model?: string | null;
+    connection?: string;
+    inTransaction?: boolean;
+}
+/**
+ * Payload shape of AdonisJS mail events (`mail:sending`, `mail:sent`,
+ * `mail:queued`, `queued:mail:error`).
+ */
+export interface MailEventData {
+    message?: MailMessage;
+    mailerName?: string;
+    mailer?: string;
+    response?: {
+        messageId?: string;
+    };
+    messageId?: string;
+    from?: unknown;
+    to?: unknown;
+    cc?: unknown;
+    bcc?: unknown;
+    subject?: string;
+    html?: string | null;
+    text?: string | null;
+    attachments?: unknown[];
+}
+/**
+ * The nested `message` object inside a mail event payload.
+ */
+export interface MailMessage {
+    from?: unknown;
+    to?: unknown;
+    cc?: unknown;
+    bcc?: unknown;
+    subject?: string;
+    html?: string | null;
+    text?: string | null;
+    attachments?: unknown[];
+}
 /**
  * A captured SQL query from the `db:query` event.
  *
@@ -10,7 +115,7 @@ export interface QueryRecord {
     /** The SQL query string (may contain `?` placeholders). */
     sql: string;
     /** Bound parameter values for the query placeholders. */
-    bindings: any[];
+    bindings: unknown[];
     /** Query execution time in **milliseconds**. */
     duration: number;
     /** Knex query method (e.g. `'select'`, `'insert'`, `'raw'`). */
@@ -116,7 +221,7 @@ export interface TraceSpan {
     /** Span duration in milliseconds. */
     duration: number;
     /** Optional metadata (query bindings, status code, etc.). */
-    metadata?: Record<string, any>;
+    metadata?: Record<string, unknown>;
 }
 /**
  * A complete trace for a single HTTP request.

package/dist/src/debug/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/debug/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/debug/types.ts"],"names":[],"mappings":"AAIA,gDAAgD;AAEhD,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;AAErD;;;;;;;;;GASG;AACH,MAAM,WAAW,OAAO;IACtB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAAA;IAChD,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAAA;IACjD,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAA;CACjF;AAED;;;;GAIG;AACH,MAAM,WAAW,MAAM;IACrB,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAA;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,GAAG,YAAY,CAAA;IACnE,UAAU,CAAC,EAAE,eAAe,GAAG,cAAc,EAAE,CAAA;CAChD;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,IAAI,QAAQ,CAAC,cAAc,CAAC,CAAA;CACjC;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,OAAO,EAAE,CAAA;CACjB;AAMD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,CAAA;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,WAAW,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACjC,SAAS,CAAC,EAAE,MAAM,CAAA;IAGlB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,EAAE,CAAC,EAAE,OAAO,CAAA;IACZ,EAAE,CAAC,EAAE,OAAO,CAAA;IACZ,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,WAAW,CAAC,EAAE,OAAO,EAAE,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,EAAE,CAAC,EAAE,OAAO,CAAA;IACZ,EAAE,CAAC,EAAE,OAAO,CAAA;IACZ,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,WAAW,CAAC,EAAE,OAAO,EAAE,CAAA;CACxB;AAMD;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAA;IAEV,2DAA2D;IAC3D,GAAG,EAAE,MAAM,CAAA;IAEX,yDAAyD;IACzD,QAAQ,EAAE,OAAO,EAAE,CAAA;IAEnB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAA;IAEhB,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAA;IAEd,wEAAwE;IACxE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAEpB,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAA;IAElB,mDAAmD;IACnD,aAAa,EAAE,OAAO,CAAA;IAEtB,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAA;IAEV,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAA;IAEb,oEAAoE;IACpE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAEnB,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAA;IAEV,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAA;IAEZ,2CAA2C;IAC3C,EAAE,EAAE,MAAM,CAAA;IAEV,wCAAwC;IACxC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IAEjB,yCAAyC;IACzC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAElB,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAA;IAEf,oDAAoD;IACpD,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAEnB,kCAAkC;IAClC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAEnB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAA;IAEd,+BAA+B;IAC/B,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAA;IAEhD,8DAA8D;IAC9D,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IAExB,kCAAkC;IAClC,eAAe,EAAE,MAAM,CAAA;IAEvB,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAA;IAEd,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAA;IAEf,oDAAoD;IACpD,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAEnB,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAA;IAEf;;;;OAIG;IACH,UAAU,EAAE,MAAM,EAAE,CAAA;CACrB;AAMD;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAA;IAEV,sDAAsD;IACtD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IAEvB,gFAAgF;IAChF,KAAK,EAAE,MAAM,CAAA;IAEb,8DAA8D;IAC9D,QAAQ,EAAE,SAAS,GAAG,YAAY,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAA;IAEhF,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAA;IAEnB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAA;IAEhB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAA;IAEV,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAA;IAEd,0CAA0C;IAC1C,GAAG,EAAE,MAAM,CAAA;IAEX,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAA;IAElB,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAA;IAErB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAA;IAEjB,8CAA8C;IAC9C,KAAK,EAAE,SAAS,EAAE,CAAA;IAElB,gEAAgE;IAChE,QAAQ,EAAE,MAAM,EAAE,CAAA;IAElB,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAA;CAClB;AAMD;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,OAAO,EAAE,OAAO,CAAA;IAEhB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAA;IAElB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAA;IAEjB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAA;IAEjB,0DAA0D;IAC1D,oBAAoB,EAAE,MAAM,CAAA;IAE5B,mEAAmE;IACnE,gBAAgB,EAAE,OAAO,GAAG,MAAM,CAAA;IAElC,8CAA8C;IAC9C,OAAO,EAAE,OAAO,CAAA;IAEhB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAA;IAEjB,kDAAkD;IAClD,SAAS,EAAE,OAAO,CAAA;IAElB,4CAA4C;IAC5C,aAAa,EAAE,MAAM,CAAA;IAErB,gEAAgE;IAChE,aAAa,EAAE,MAAM,CAAA;IAErB,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAA;IAEd,qDAAqD;IACrD,aAAa,EAAE,MAAM,CAAA;CACtB;AAMD;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;AAEhF;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,mBAAmB,GAC3B,MAAM,GACN,MAAM,GACN,SAAS,GACT,UAAU,GACV,QAAQ,GACR,MAAM,GACN,OAAO,CAAA;AAEX;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,eAAe;IAC9B,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAA;IAEX,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAA;IAEb;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;;;OAIG;IACH,MAAM,CAAC,EAAE,mBAAmB,CAAA;IAE5B;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IAEpB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IAEpB;;;;;;;;;;;;;;OAcG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAA;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,SAAS;IACxB;;;;;OAKG;IACH,EAAE,EAAE,MAAM,CAAA;IAEV,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAA;IAEb,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAA;IAEhB;;;OAGG;IACH,OAAO,EAAE,eAAe,EAAE,CAAA;IAE1B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,eAAe,CAAA;IAExB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IAEnB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB"}

package/dist/src/debug/types.js

@@ -1,4 +1,4 @@
 // ---------------------------------------------------------------------------
-// Debug data records
+// AdonisJS framework abstractions
 // ---------------------------------------------------------------------------
 export {};

package/dist/src/define_config.d.ts

@@ -1,24 +1,68 @@
-import type { ServerStatsConfig } from './types.js';
+import type { ResolvedServerStatsConfig, ServerStatsConfig } from './types.js';
 /**
  * Define the server stats configuration with full type safety.
  *
+ * All top-level fields are optional. Sensible defaults are applied
+ * for any omitted fields:
+ *
+ * | Field         | Default                        |
+ * |---------------|--------------------------------|
+ * | `intervalMs`  | `3000`                         |
+ * | `transport`   | `'transmit'`                   |
+ * | `channelName` | `'admin/server-stats'`         |
+ * | `endpoint`    | `'/admin/api/server-stats'`    |
+ * | `collectors`  | `'auto'`                       |
+ * | `skipInTest`  | `true`                         |
+ *
+ * New simplified aliases (Phase 1) are also supported. When both the
+ * old name and its alias are provided, the **new name takes precedence**.
+ *
+ * | Alias            | Resolves to      |
+ * |------------------|------------------|
+ * | `pollInterval`   | `intervalMs`     |
+ * | `realtime`       | `transport`      |
+ * | `statsEndpoint`  | `endpoint`       |
+ * | `authorize`      | `shouldShow`     |
+ * | `toolbar`        | `devToolbar`     |
+ * | `dashboard`      | `devToolbar`     |
+ * | `advanced`       | various          |
+ *
  * This is the main entry point for configuring `adonisjs-server-stats`.
  * Call it in `config/server_stats.ts` and export the result as default.
  *
  * @example
  * ```ts
- * // config/server_stats.ts
+ * // config/server_stats.ts — minimal (all defaults)
+ * import { defineConfig } from 'adonisjs-server-stats'
+ *
+ * export default defineConfig({})
+ * ```
+ *
+ * @example
+ * ```ts
+ * // config/server_stats.ts — explicit collectors
  * import { defineConfig } from 'adonisjs-server-stats'
  * import { processCollector, httpCollector } from 'adonisjs-server-stats/collectors'
  *
  * export default defineConfig({
  *   intervalMs: 3000,
  *   transport: 'transmit',
- *   channelName: 'admin/server-stats',
- *   endpoint: '/admin/api/server-stats',
  *   collectors: [processCollector(), httpCollector()],
  * })
  * ```
+ *
+ * @example
+ * ```ts
+ * // config/server_stats.ts — new simplified aliases
+ * import { defineConfig } from 'adonisjs-server-stats'
+ *
+ * export default defineConfig({
+ *   pollInterval: 3000,
+ *   realtime: true,
+ *   toolbar: true,
+ *   dashboard: true,
+ * })
+ * ```
  */
-export declare function defineConfig(config: ServerStatsConfig): ServerStatsConfig;
+export declare function defineConfig(config: ServerStatsConfig): ResolvedServerStatsConfig;
 //# sourceMappingURL=define_config.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"define_config.d.ts","sourceRoot":"","sources":["../../src/define_config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAEnD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,CAEzE"}
+{"version":3,"file":"define_config.d.ts","sourceRoot":"","sources":["../../src/define_config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAqB,yBAAyB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AA4RjG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,iBAAiB,GAAG,yBAAyB,CA0CjF"}