adonisjs-server-stats 1.5.3 → 1.6.1

package/dist/src/data/data_access.js

@@ -0,0 +1,305 @@
+import { readFile, stat } from 'node:fs/promises';
+import { parseAndEnrich } from '../log_stream/log_stream_service.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Wrap a plain array in the standard {@link PaginatedResult} envelope.
+ *
+ * Applies optional client-side search filtering and pagination so that
+ * ring-buffer results match the same shape returned by the dashboard store.
+ */
+function wrapArray(items, opts, searchFn) {
+    let filtered = items;
+    // Client-side search
+    if (opts.search && searchFn) {
+        const term = opts.search.toLowerCase();
+        filtered = filtered.filter((item) => searchFn(item, term));
+    }
+    const total = filtered.length;
+    const page = opts.page ?? 1;
+    // When perPage is not specified, return all items (backward compat for debug panel)
+    const perPage = opts.perPage ?? (total || 1);
+    const lastPage = Math.max(1, Math.ceil(total / perPage));
+    const start = (page - 1) * perPage;
+    const data = filtered.slice(start, start + perPage);
+    return {
+        data,
+        meta: { total, page, perPage, lastPage },
+    };
+}
+/**
+ * Convert a flat {@link DashboardStore.PaginatedResult} to the nested
+ * `{ data, meta }` shape used by the unified API.
+ */
+function fromDashboardResult(result) {
+    return {
+        data: result.data,
+        meta: {
+            total: result.total,
+            page: result.page,
+            perPage: result.perPage,
+            lastPage: result.lastPage,
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// DataAccess
+// ---------------------------------------------------------------------------
+/**
+ * Thin abstraction layer that delegates reads to either the
+ * {@link DashboardStore} (SQLite persistence) or the {@link DebugStore}
+ * (in-memory ring buffers), depending on availability.
+ *
+ * This is intentionally *not* wired into the AdonisJS container yet
+ * -- that happens in Phase 3.
+ */
+export class DataAccess {
+    debugStore;
+    dashboardStore;
+    logPath;
+    constructor(debugStore, dashboardStore, logPath) {
+        this.debugStore = debugStore;
+        this.dashboardStore = dashboardStore;
+        this.logPath = logPath;
+    }
+    /** Whether SQLite persistence is available and initialised. */
+    get hasPersistence() {
+        return this.dashboardStore?.isReady() ?? false;
+    }
+    // =========================================================================
+    // Queries
+    // =========================================================================
+    async getQueries(opts = {}) {
+        if (this.hasPersistence && opts.source !== 'memory') {
+            const page = opts.page ?? 1;
+            const perPage = opts.perPage ?? 50;
+            const filters = {
+                search: opts.search,
+                ...opts.filters,
+            };
+            const result = await this.dashboardStore.getQueries(page, perPage, filters);
+            return fromDashboardResult(result);
+        }
+        const queries = this.debugStore.queries.getQueries();
+        return wrapArray(queries, opts, (q, term) => {
+            return (q.sql.toLowerCase().includes(term) ||
+                (q.model?.toLowerCase().includes(term) ?? false) ||
+                q.connection.toLowerCase().includes(term));
+        });
+    }
+    getQuerySummary() {
+        return this.debugStore.queries.getSummary();
+    }
+    // =========================================================================
+    // Events
+    // =========================================================================
+    async getEvents(opts = {}) {
+        if (this.hasPersistence && opts.source !== 'memory') {
+            const page = opts.page ?? 1;
+            const perPage = opts.perPage ?? 50;
+            const filters = {
+                search: opts.search,
+                ...opts.filters,
+            };
+            const result = await this.dashboardStore.getEvents(page, perPage, filters);
+            return fromDashboardResult(result);
+        }
+        const events = this.debugStore.events.getEvents();
+        return wrapArray(events, opts, (e, term) => {
+            return e.event.toLowerCase().includes(term);
+        });
+    }
+    // =========================================================================
+    // Emails
+    // =========================================================================
+    /**
+     * Paginated email list.
+     *
+     * HTML and text bodies are stripped from the list response to keep
+     * payloads lightweight. Use {@link getEmailPreview} for the full body.
+     */
+    async getEmails(opts = {}) {
+        if (this.hasPersistence && opts.source !== 'memory') {
+            const page = opts.page ?? 1;
+            const perPage = opts.perPage ?? 50;
+            const filters = {
+                search: opts.search,
+                ...opts.filters,
+            };
+            const result = await this.dashboardStore.getEmails(page, perPage, filters, true);
+            return fromDashboardResult(result);
+        }
+        const emails = this.debugStore.emails.getEmails();
+        // Strip html/text from list response
+        const stripped = emails.map(({ html: _html, text: _text, ...rest }) => rest);
+        return wrapArray(stripped, opts, (e, term) => {
+            return (e.from.toLowerCase().includes(term) ||
+                e.to.toLowerCase().includes(term) ||
+                e.subject.toLowerCase().includes(term));
+        });
+    }
+    /**
+     * Get email HTML body for preview (iframe rendering).
+     *
+     * Returns the full HTML body string, or falls back to the text body.
+     * Returns `null` when the email is not found.
+     */
+    async getEmailPreview(id, source) {
+        if (this.hasPersistence && source !== 'memory') {
+            return this.dashboardStore.getEmailHtml(id);
+        }
+        return this.debugStore.emails.getEmailHtml(id);
+    }
+    // =========================================================================
+    // Traces
+    // =========================================================================
+    /**
+     * Paginated trace list.
+     *
+     * Span arrays are stripped from the list response to keep payloads
+     * lightweight. Use {@link getTraceDetail} for the full span tree.
+     */
+    async getTraces(opts = {}) {
+        if (this.hasPersistence && opts.source !== 'memory') {
+            const page = opts.page ?? 1;
+            const perPage = opts.perPage ?? 50;
+            const filters = {
+                search: opts.search,
+                ...opts.filters,
+            };
+            const result = await this.dashboardStore.getTraces(page, perPage, filters);
+            return fromDashboardResult(result);
+        }
+        if (!this.debugStore.traces) {
+            return { data: [], meta: { total: 0, page: 1, perPage: opts.perPage ?? 50, lastPage: 1 } };
+        }
+        const traces = this.debugStore.traces.getTraces();
+        // Strip spans from list view, add warningCount
+        const list = traces.map(({ spans: _spans, warnings, ...rest }) => ({
+            ...rest,
+            warningCount: warnings.length,
+        }));
+        return wrapArray(list, opts, (t, term) => {
+            return t.method.toLowerCase().includes(term) || t.url.toLowerCase().includes(term);
+        });
+    }
+    /**
+     * Get a single trace with full span tree.
+     *
+     * Returns `null` when the trace is not found.
+     */
+    async getTraceDetail(id, source) {
+        if (this.hasPersistence && source !== 'memory') {
+            return this.dashboardStore.getTraceDetail(id);
+        }
+        if (!this.debugStore.traces)
+            return null;
+        return this.debugStore.traces.getTrace(id) ?? null;
+    }
+    // =========================================================================
+    // Routes
+    // =========================================================================
+    /**
+     * Get the registered route table.
+     *
+     * Routes are always read from the in-memory {@link DebugStore} because
+     * they are static boot-time data that is never persisted to SQLite.
+     */
+    getRoutes(search) {
+        let routes = this.debugStore.routes.getRoutes();
+        if (search) {
+            const term = search.toLowerCase();
+            routes = routes.filter((r) => {
+                const pattern = (r.pattern || '').toLowerCase();
+                const handler = (r.handler || '').toLowerCase();
+                const name = (r.name || '').toLowerCase();
+                const method = (r.method || '').toLowerCase();
+                return (pattern.includes(term) ||
+                    handler.includes(term) ||
+                    name.includes(term) ||
+                    method.includes(term));
+            });
+        }
+        const total = routes.length;
+        return {
+            data: routes,
+            meta: { total, page: 1, perPage: total || 1, lastPage: 1 },
+        };
+    }
+    // =========================================================================
+    // Logs
+    // =========================================================================
+    /**
+     * Paginated log entries.
+     *
+     * When the dashboard store is available, logs are read from SQLite with
+     * full server-side filtering. Otherwise, falls back to reading the last
+     * 256 KB of the application log file from the filesystem.
+     */
+    async getLogs(opts = {}) {
+        if (this.hasPersistence && opts.source !== 'memory') {
+            const page = opts.page ?? 1;
+            const perPage = opts.perPage ?? 50;
+            const filters = {
+                search: opts.search,
+                ...opts.filters,
+            };
+            const result = await this.dashboardStore.getLogs(page, perPage, filters);
+            return fromDashboardResult(result);
+        }
+        // Fallback: read from log file on disk (same approach as DebugController)
+        const entries = await this.readLogFile();
+        return wrapArray(entries, opts, (e, term) => {
+            const msg = String(e.msg ?? e.message ?? '').toLowerCase();
+            const levelName = String(e.levelName ?? '').toLowerCase();
+            return msg.includes(term) || levelName.includes(term);
+        });
+    }
+    // =========================================================================
+    // Private helpers
+    // =========================================================================
+    /**
+     * Read and parse the last 256 KB of the application log file.
+     *
+     * Returns an array of enriched log entry objects. If the log file
+     * does not exist or cannot be read, returns an empty array.
+     */
+    async readLogFile() {
+        if (!this.logPath)
+            return [];
+        try {
+            const stats = await stat(this.logPath);
+            const maxBytes = 256 * 1024;
+            let content;
+            if (stats.size > maxBytes) {
+                const { createReadStream } = await import('node:fs');
+                const stream = createReadStream(this.logPath, {
+                    start: stats.size - maxBytes,
+                    encoding: 'utf-8',
+                });
+                const chunks = [];
+                for await (const chunk of stream) {
+                    chunks.push(chunk);
+                }
+                content = chunks.join('');
+                // Skip first potentially incomplete line
+                const firstNewline = content.indexOf('\n');
+                if (firstNewline !== -1)
+                    content = content.slice(firstNewline + 1);
+            }
+            else {
+                content = await readFile(this.logPath, 'utf-8');
+            }
+            return content
+                .trim()
+                .split('\n')
+                .filter(Boolean)
+                .map((line) => parseAndEnrich(line))
+                .filter((entry) => entry !== null);
+        }
+        catch {
+            return [];
+        }
+    }
+}

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

@@ -0,0 +1,3 @@
+export { DataAccess } from './data_access.js';
+export type { ListOptions, PaginatedResult } from './data_access.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/data/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/src/data/index.js

@@ -0,0 +1 @@
+export { DataAccess } from './data_access.js';

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

@@ -20,7 +20,26 @@ export declare class DebugStore {
      * The callback receives the item type ('query' | 'event' | 'email' | 'trace').
      */
     onNewItem(cb: ((type: string) => void) | null): void;
-    start(emitter: any, router: any): Promise<void>;
+    /** Return buffer utilization stats for all debug collectors. */
+    getBufferStats(): {
+        queries: {
+            current: number;
+            max: number;
+        };
+        events: {
+            current: number;
+            max: number;
+        };
+        emails: {
+            current: number;
+            max: number;
+        };
+        traces: {
+            current: number;
+            max: number;
+        };
+    };
+    start(emitter: unknown, router: unknown): Promise<void>;
     stop(): void;
     /** Serialize all collector data to a JSON file (atomic write). */
     saveToDisk(filePath: string): Promise<void>;

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

@@ -1 +1 @@
-{"version":3,"file":"debug_store.d.ts","sourceRoot":"","sources":["../../../src/debug/debug_store.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAErD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAElD;;;GAGG;AACH,qBAAa,UAAU;IACrB,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAA;IAChC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAA;gBAE1B,MAAM,EAAE,gBAAgB;IAQpC;;;OAGG;IACH,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI;IAO9C,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAQrD,IAAI,IAAI,IAAI;IAOZ,kEAAkE;IAC5D,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBjD,uDAAuD;IACjD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAuBpD"}
+{"version":3,"file":"debug_store.d.ts","sourceRoot":"","sources":["../../../src/debug/debug_store.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAErD,OAAO,KAAK,EAAE,gBAAgB,EAAmB,MAAM,YAAY,CAAA;AAEnE;;;GAGG;AACH,qBAAa,UAAU;IACrB,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAA;IAChC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAA;gBAE1B,MAAM,EAAE,gBAAgB;IAQpC;;;OAGG;IACH,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI;IAOpD,gEAAgE;IAChE,cAAc,IAAI;QAChB,OAAO,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAA;QACzC,MAAM,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAA;QACxC,MAAM,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAA;QACxC,MAAM,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAA;KACzC;IASK,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAa7D,IAAI,IAAI,IAAI;IAOZ,kEAAkE;IAC5D,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBjD,uDAAuD;IACjD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAqCpD"}

package/dist/src/debug/debug_store.js

@@ -1,5 +1,6 @@
 import { writeFile, readFile, rename, mkdir } from 'node:fs/promises';
 import { dirname } from 'node:path';
+import { log, bold } from '../utils/logger.js';
 import { EmailCollector } from './email_collector.js';
 import { EventCollector } from './event_collector.js';
 import { QueryCollector } from './query_collector.js';
@@ -32,12 +33,26 @@ export class DebugStore {
         this.emails.onNewItem(cb ? () => cb('email') : null);
         this.traces?.onNewItem(cb ? () => cb('trace') : null);
     }
+    /** Return buffer utilization stats for all debug collectors. */
+    getBufferStats() {
+        return {
+            queries: this.queries.getBufferInfo(),
+            events: this.events.getBufferInfo(),
+            emails: this.emails.getBufferInfo(),
+            traces: this.traces?.getBufferInfo() ?? { current: 0, max: 0 },
+        };
+    }
     async start(emitter, router) {
-        await this.queries.start(emitter);
-        this.events.start(emitter);
-        await this.emails.start(emitter);
-        this.routes.inspect(router);
-        this.traces?.start(emitter);
+        // Runtime-check the emitter before passing to collectors.
+        // The container returns `unknown`; collectors guard internally too.
+        const e = emitter;
+        await this.queries.start(e);
+        this.events.start(e);
+        await this.emails.start(e);
+        if (router && typeof router.toJSON === 'function') {
+            this.routes.inspect(router);
+        }
+        this.traces?.start(e);
     }
     stop() {
         this.queries.stop();
@@ -67,21 +82,34 @@ export class DebugStore {
         try {
             raw = await readFile(filePath, 'utf-8');
         }
+        catch (error) {
+            if (error?.code !== 'ENOENT') {
+                log.warn(`Failed to read persisted debug data from ${bold(filePath)}: ${error?.message}`);
+            }
+            return;
+        }
+        let data;
+        try {
+            data = JSON.parse(raw);
+        }
         catch {
-            return; // file doesn't exist yet
+            log.warn(`Persisted debug data corrupted, resetting: ${bold(filePath)}`);
+            return;
         }
-        const data = JSON.parse(raw);
-        if (Array.isArray(data.queries) && data.queries.length > 0) {
-            this.queries.loadRecords(data.queries);
+        if (typeof data !== 'object' || data === null)
+            return;
+        const record = data;
+        if (Array.isArray(record.queries) && record.queries.length > 0) {
+            this.queries.loadRecords(record.queries);
         }
-        if (Array.isArray(data.events) && data.events.length > 0) {
-            this.events.loadRecords(data.events);
+        if (Array.isArray(record.events) && record.events.length > 0) {
+            this.events.loadRecords(record.events);
         }
-        if (Array.isArray(data.emails) && data.emails.length > 0) {
-            this.emails.loadRecords(data.emails);
+        if (Array.isArray(record.emails) && record.emails.length > 0) {
+            this.emails.loadRecords(record.emails);
         }
-        if (this.traces && Array.isArray(data.traces) && data.traces.length > 0) {
-            this.traces.loadRecords(data.traces);
+        if (this.traces && Array.isArray(record.traces) && record.traces.length > 0) {
+            this.traces.loadRecords(record.traces);
         }
     }
 }

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

@@ -1,4 +1,4 @@
-import type { EmailRecord } from './types.js';
+import type { EmailRecord, Emitter } from './types.js';
 /**
  * Listens to AdonisJS mail events and stores captured emails in a ring buffer.
  *
@@ -13,12 +13,16 @@ export declare class EmailCollector {
     private emitter;
     private handlers;
     constructor(maxEmails?: number);
-    start(emitter: any): Promise<void>;
+    start(emitter: Emitter): Promise<void>;
     stop(): void;
     getEmails(): EmailRecord[];
     getLatest(n?: number): EmailRecord[];
     getEmailHtml(id: number): string | null;
     getTotalCount(): number;
+    getBufferInfo(): {
+        current: number;
+        max: number;
+    };
     clear(): void;
     private buildRecord;
     /** Register a callback that fires whenever a new email is recorded. */

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

@@ -1 +1 @@
-{"version":3,"file":"email_collector.d.ts","sourceRoot":"","sources":["../../../src/debug/email_collector.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C;;;;;;;;GAQG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,OAAO,CAAY;IAC3B,OAAO,CAAC,QAAQ,CAAmD;gBAEvD,SAAS,GAAE,MAAY;IAI7B,KAAK,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAwDxC,IAAI,IAAI,IAAI;IAUZ,SAAS,IAAI,WAAW,EAAE;IAI1B,SAAS,CAAC,CAAC,GAAE,MAAY,GAAG,WAAW,EAAE;IAIzC,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAMvC,aAAa,IAAI,MAAM;IAIvB,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,WAAW;IAkBnB,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":"email_collector.d.ts","sourceRoot":"","sources":["../../../src/debug/email_collector.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAA8B,MAAM,YAAY,CAAA;AAElF;;;;;;;;GAQG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,QAAQ,CAA6D;gBAEjE,SAAS,GAAE,MAAY;IAI7B,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAwD5C,IAAI,IAAI,IAAI;IAUZ,SAAS,IAAI,WAAW,EAAE;IAI1B,SAAS,CAAC,CAAC,GAAE,MAAY,GAAG,WAAW,EAAE;IAIzC,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAMvC,aAAa,IAAI,MAAM;IAIvB,aAAa,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;IAIjD,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,WAAW;IAsBnB,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/email_collector.js

@@ -87,6 +87,9 @@ export class EmailCollector {
     getTotalCount() {
         return this.buffer.size();
     }
+    getBufferInfo() {
+        return { current: this.buffer.size(), max: this.buffer.getCapacity() };
+    }
     clear() {
         this.buffer.clear();
     }

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

@@ -1,4 +1,4 @@
-import type { EventRecord } from './types.js';
+import type { EventRecord, Emitter } from './types.js';
 /**
  * Wraps the AdonisJS emitter to log all events with timestamps.
  * Uses monkey-patching of emitter.emit to intercept all events.
@@ -8,13 +8,17 @@ export declare class EventCollector {
     private originalEmit;
     private emitter;
     constructor(maxEvents?: number);
-    start(emitter: any): void;
+    start(emitter: Emitter): void;
     stop(): void;
     private summarizeData;
     private safeReplacer;
     getEvents(): EventRecord[];
     getLatest(n?: number): EventRecord[];
     getTotalCount(): number;
+    getBufferInfo(): {
+        current: number;
+        max: number;
+    };
     clear(): void;
     /** Register a callback that fires whenever a new event is recorded. */
     onNewItem(cb: ((item: EventRecord) => void) | null): void;

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

@@ -1 +1 @@
-{"version":3,"file":"event_collector.d.ts","sourceRoot":"","sources":["../../../src/debug/event_collector.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,YAAY,CAAyC;IAC7D,OAAO,CAAC,OAAO,CAAY;gBAEf,SAAS,GAAE,MAAY;IAInC,KAAK,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI;IAmCzB,IAAI,IAAI,IAAI;IAQZ,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,YAAY;IAapB,SAAS,IAAI,WAAW,EAAE;IAI1B,SAAS,CAAC,CAAC,GAAE,MAAY,GAAG,WAAW,EAAE;IAIzC,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":"event_collector.d.ts","sourceRoot":"","sources":["../../../src/debug/event_collector.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEtD;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,OAAO,CAAuB;gBAE1B,SAAS,GAAE,MAAY;IAInC,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAkC7B,IAAI,IAAI,IAAI;IAQZ,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,YAAY;IAapB,SAAS,IAAI,WAAW,EAAE;IAI1B,SAAS,CAAC,CAAC,GAAE,MAAY,GAAG,WAAW,EAAE;IAIzC,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/event_collector.js

@@ -16,8 +16,7 @@ export class EventCollector {
             return;
         this.emitter = emitter;
         this.originalEmit = emitter.emit.bind(emitter);
-        const self = this;
-        emitter.emit = function (event, data) {
+        emitter.emit = (event, data) => {
             // Resolve event name: class-based events use the class name, string events are used as-is
             const eventName = typeof event === 'string' ? event : event?.name || 'unknown';
             // Skip internal/noisy events, mail events (handled by EmailCollector),
@@ -30,14 +29,14 @@ export class EventCollector {
                 eventName !== 'http:request_completed' &&
                 !isExcludedRequest()) {
                 const record = {
-                    id: self.buffer.getNextId(),
+                    id: this.buffer.getNextId(),
                     event: eventName,
-                    data: self.summarizeData(data),
+                    data: this.summarizeData(data),
                     timestamp: Date.now(),
                 };
-                self.buffer.push(record);
+                this.buffer.push(record);
             }
-            return self.originalEmit.call(emitter, event, data);
+            return this.originalEmit.call(emitter, event, data);
         };
     }
     stop() {
@@ -58,8 +57,10 @@ export class EventCollector {
             return json.length > 4096 ? json.slice(0, 4096) + '\n...' : json;
         }
         catch {
-            if (typeof data === 'object' && data.constructor?.name) {
-                return `[${data.constructor.name}]`;
+            if (typeof data === 'object' && data !== null) {
+                const ctorName = data.constructor?.name;
+                if (ctorName)
+                    return `[${ctorName}]`;
             }
             return typeof data;
         }
@@ -88,6 +89,9 @@ export class EventCollector {
     getTotalCount() {
         return this.buffer.size();
     }
+    getBufferInfo() {
+        return { current: this.buffer.size(), max: this.buffer.getCapacity() };
+    }
     clear() {
         this.buffer.clear();
     }

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

@@ -1,4 +1,4 @@
-import type { QueryRecord } from './types.js';
+import type { QueryRecord, Emitter } from './types.js';
 /**
  * Listens to Lucid's `db:query` event and stores queries in a ring buffer.
  *
@@ -11,7 +11,7 @@ export declare class QueryCollector {
     private emitter;
     private handler;
     constructor(maxQueries?: number, slowThresholdMs?: number);
-    start(emitter: any): Promise<void>;
+    start(emitter: Emitter): Promise<void>;
     stop(): void;
     getQueries(): QueryRecord[];
     getLatest(n?: number): QueryRecord[];
@@ -22,6 +22,10 @@ export declare class QueryCollector {
         avgDuration: number;
     };
     getTotalCount(): number;
+    getBufferInfo(): {
+        current: number;
+        max: number;
+    };
     clear(): void;
     /** Register a callback that fires whenever a new query is recorded. */
     onNewItem(cb: ((item: QueryRecord) => void) | null): void;

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

@@ -1 +1 @@
-{"version":3,"file":"query_collector.d.ts","sourceRoot":"","sources":["../../../src/debug/query_collector.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,OAAO,CAAY;IAC3B,OAAO,CAAC,OAAO,CAAqC;gBAExC,UAAU,GAAE,MAAY,EAAE,eAAe,GAAE,MAAY;IAK7D,KAAK,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAmCxC,IAAI,IAAI,IAAI;IAQZ,UAAU,IAAI,WAAW,EAAE;IAI3B,SAAS,CAAC,CAAC,GAAE,MAAY,GAAG,WAAW,EAAE;IAIzC,UAAU;;;;;;IAqBV,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":"query_collector.d.ts","sourceRoot":"","sources":["../../../src/debug/query_collector.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAgB,MAAM,YAAY,CAAA;AAEpE;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,OAAO,CAA8C;gBAEjD,UAAU,GAAE,MAAY,EAAE,eAAe,GAAE,MAAY;IAK7D,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAmC5C,IAAI,IAAI,IAAI;IAQZ,UAAU,IAAI,WAAW,EAAE;IAI3B,SAAS,CAAC,CAAC,GAAE,MAAY,GAAG,WAAW,EAAE;IAIzC,UAAU;;;;;;IAqBV,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/query_collector.js

@@ -80,6 +80,9 @@ export class QueryCollector {
     getTotalCount() {
         return this.buffer.size();
     }
+    getBufferInfo() {
+        return { current: this.buffer.size(), max: this.buffer.getCapacity() };
+    }
     clear() {
         this.buffer.clear();
     }

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

@@ -19,6 +19,7 @@ export declare class RingBuffer<T> {
     latest(n: number): T[];
     getNextId(): number;
     size(): number;
+    getCapacity(): number;
     clear(): void;
     /** Bulk-load items (e.g. from disk). Pushes each in order, respecting capacity. */
     load(items: T[]): void;

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

@@ -1 +1 @@
-{"version":3,"file":"ring_buffer.d.ts","sourceRoot":"","sources":["../../../src/debug/ring_buffer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,UAAU,CAAC,CAAC;IAOX,OAAO,CAAC,QAAQ;IAN5B,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,IAAI,CAAY;IACxB,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,YAAY,CAAmC;gBAEnC,QAAQ,EAAE,MAAM;IAIpC,oEAAoE;IACpE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI;IAI5C,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IASnB,2DAA2D;IAC3D,OAAO,IAAI,CAAC,EAAE;IAcd,sDAAsD;IACtD,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE;IAKtB,SAAS,IAAI,MAAM;IAInB,IAAI,IAAI,MAAM;IAId,KAAK,IAAI,IAAI;IAMb,mFAAmF;IACnF,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI;IAMtB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;CAG5B"}
+{"version":3,"file":"ring_buffer.d.ts","sourceRoot":"","sources":["../../../src/debug/ring_buffer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,UAAU,CAAC,CAAC;IAOX,OAAO,CAAC,QAAQ;IAN5B,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,IAAI,CAAY;IACxB,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,YAAY,CAAmC;gBAEnC,QAAQ,EAAE,MAAM;IAIpC,oEAAoE;IACpE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI;IAI5C,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IASnB,2DAA2D;IAC3D,OAAO,IAAI,CAAC,EAAE;IAcd,sDAAsD;IACtD,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE;IAKtB,SAAS,IAAI,MAAM;IAInB,IAAI,IAAI,MAAM;IAId,WAAW,IAAI,MAAM;IAIrB,KAAK,IAAI,IAAI;IAMb,mFAAmF;IACnF,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI;IAMtB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;CAG5B"}

package/dist/src/debug/ring_buffer.js

@@ -11,7 +11,7 @@ export class RingBuffer {
     pushCallback = null;
     constructor(capacity) {
         this.capacity = capacity;
-        this.buffer = new Array(capacity);
+        this.buffer = Array.from({ length: capacity });
     }
     /** Register a callback that fires whenever a new item is pushed. */
     onPush(cb) {
@@ -48,8 +48,11 @@ export class RingBuffer {
     size() {
         return this.count;
     }
+    getCapacity() {
+        return this.capacity;
+    }
     clear() {
-        this.buffer = new Array(this.capacity);
+        this.buffer = Array.from({ length: this.capacity });
         this.head = 0;
         this.count = 0;
     }

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[];