adonisjs-server-stats 1.5.4 → 1.6.2

package/dist/src/dashboard/integrations/queue_inspector.d.ts

@@ -1,4 +1,34 @@
 import type { ApplicationService } from '@adonisjs/core/types';
+/** Minimal interface for a BullMQ Job as accessed by the inspector. */
+interface BullMQJob {
+    id: string | number;
+    name: string;
+    data: Record<string, unknown> | null;
+    opts: Record<string, unknown>;
+    timestamp: number;
+    processedOn: number | null;
+    finishedOn: number | null;
+    failedReason: string | null;
+    stacktrace: string[];
+    returnvalue: unknown;
+    attemptsMade: number;
+    progress: number | object;
+    delay?: number;
+    getState(): Promise<string>;
+    retry(): Promise<void>;
+}
+/** Minimal interface for a BullMQ Queue as accessed by the inspector. */
+interface BullMQQueue {
+    getJobCounts(...statuses: string[]): Promise<Record<string, number>>;
+    getJobs(statuses: string[], start: number, end: number): Promise<(BullMQJob | null)[]>;
+    getJob(id: string): Promise<BullMQJob | null>;
+}
+/** Minimal interface for the @rlanz/bull-queue manager. */
+interface QueueManager {
+    get?(name: string): BullMQQueue | null;
+    getOrSet?(name: string): BullMQQueue;
+    getJobCounts?(...statuses: string[]): Promise<Record<string, number>>;
+}
 export interface QueueOverview {
     /** Total jobs currently being processed. */
     active: number;
@@ -16,12 +46,14 @@ export interface QueueOverview {
 export interface QueueJobSummary {
     /** Bull job ID. */
     id: string;
-    /** Job name / type. */
+    /** Human-readable job name (cleaned from file URLs). */
     name: string;
     /** Current job status. */
     status: 'active' | 'waiting' | 'delayed' | 'completed' | 'failed' | 'paused';
     /** Job payload (data). */
-    data: any;
+    data: Record<string, unknown> | null;
+    /** Alias for `data` — used by some frontends. */
+    payload: Record<string, unknown> | null;
     /** Number of attempts so far. */
     attempts: number;
     /** Maximum allowed attempts. */
@@ -32,6 +64,8 @@ export interface QueueJobSummary {
     failedReason: string | null;
     /** When the job was added (Unix timestamp ms). */
     createdAt: number;
+    /** Alias for `createdAt` — BullMQ compat. */
+    timestamp: number;
     /** When processing started (Unix timestamp ms), or null. */
     processedAt: number | null;
     /** When the job finished (Unix timestamp ms), or null. */
@@ -43,9 +77,9 @@ export interface QueueJobDetail extends QueueJobSummary {
     /** Full stack trace if the job failed. */
     stackTrace: string[];
     /** Return value from the job handler, if any. */
-    returnValue: any;
+    returnValue: unknown;
     /** Job options (delay, priority, repeat, etc.). */
-    opts: Record<string, any>;
+    opts: Record<string, unknown>;
 }
 export interface QueueJobListResult {
     /** Jobs for the requested page. */
@@ -63,7 +97,7 @@ type JobStatus = 'active' | 'waiting' | 'delayed' | 'completed' | 'failed' | 'pa
  */
 export declare class QueueInspector {
     private queueManager;
-    constructor(queueManager: any);
+    constructor(queueManager: QueueManager);
     /**
      * Detect whether `@rlanz/bull-queue` is available in the application container.
      */
@@ -75,11 +109,11 @@ export declare class QueueInspector {
     /**
      * List jobs filtered by status with pagination.
      *
-     * @param status   Job status to filter by.
+     * @param status   Job status to filter by, or `'all'` for every status.
      * @param page     Page number (1-based).
      * @param perPage  Jobs per page.
      */
-    listJobs(status?: JobStatus, page?: number, perPage?: number): Promise<QueueJobListResult>;
+    listJobs(status?: JobStatus | 'all', page?: number, perPage?: number): Promise<QueueJobListResult>;
     /**
      * Get full detail for a single job by ID.
      */
@@ -91,12 +125,23 @@ export declare class QueueInspector {
      */
     retryJob(id: string): Promise<boolean>;
     /**
-     * Get the underlying Bull Queue instance from the queue manager.
+     * Get the underlying BullMQ Queue instance from the queue manager.
      *
-     * `@rlanz/bull-queue` exposes the BullMQ Queue via `.queue` on the manager
-     * or via `.useQueue()`. We try both patterns for compatibility.
+     * `@rlanz/bull-queue` exposes queues via `.get(name)` or `.getOrSet(name)`.
      */
     private getQueue;
+    /**
+     * Infer a job's status from its internal fields (avoids async getState() call).
+     */
+    private inferStatus;
+    /**
+     * Extract a human-readable job name from a raw Bull job name.
+     *
+     * `@rlanz/bull-queue` often stores the full file URL as the job name
+     * (e.g. `file:///Users/…/app/jobs/send_email.ts`). We extract just
+     * the class-style name from the filename.
+     */
+    private static cleanJobName;
     /**
      * Format a Bull job into our summary shape.
      */

package/dist/src/dashboard/integrations/queue_inspector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queue_inspector.d.ts","sourceRoot":"","sources":["../../../../src/dashboard/integrations/queue_inspector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAM9D,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAA;IAEd,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAA;IAEf,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAA;IAEf,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAA;IAEjB,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAA;IAEd,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,mBAAmB;IACnB,EAAE,EAAE,MAAM,CAAA;IAEV,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAA;IAEZ,0BAA0B;IAC1B,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAA;IAE5E,0BAA0B;IAC1B,IAAI,EAAE,GAAG,CAAA;IAET,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAA;IAEhB,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAA;IAEnB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;IAEzB,gDAAgD;IAChD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAE3B,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAA;IAEjB,4DAA4D;IAC5D,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAE1B,0DAA0D;IAC1D,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IAEzB,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB;AAED,MAAM,WAAW,cAAe,SAAQ,eAAe;IACrD,0CAA0C;IAC1C,UAAU,EAAE,MAAM,EAAE,CAAA;IAEpB,iDAAiD;IACjD,WAAW,EAAE,GAAG,CAAA;IAEhB,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,mCAAmC;IACnC,IAAI,EAAE,eAAe,EAAE,CAAA;IAEvB,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAA;CACd;AAMD,KAAK,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAErF;;;;;;GAMG;AACH,qBAAa,cAAc;IACb,OAAO,CAAC,YAAY;gBAAZ,YAAY,EAAE,GAAG;IAErC;;OAEG;WACU,WAAW,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IASnE;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,aAAa,CAAC;IAoC3C;;;;;;OAMG;IACG,QAAQ,CACZ,MAAM,GAAE,SAAoB,EAC5B,IAAI,SAAI,EACR,OAAO,SAAK,GACX,OAAO,CAAC,kBAAkB,CAAC;IA0B9B;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAqBxD;;;;OAIG;IACG,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAsB5C;;;;;OAKG;IACH,OAAO,CAAC,QAAQ;IAuBhB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAoBzB"}
+{"version":3,"file":"queue_inspector.d.ts","sourceRoot":"","sources":["../../../../src/dashboard/integrations/queue_inspector.ts"],"names":[],"mappings":"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"}

package/dist/src/dashboard/integrations/queue_inspector.js

@@ -1,3 +1,4 @@
+const ALL_STATUSES = ['active', 'waiting', 'delayed', 'completed', 'failed', 'paused'];
 /**
  * Inspects Bull Queue jobs, counts, and allows retrying failed jobs.
  *
@@ -15,7 +16,7 @@ export class QueueInspector {
      */
     static async isAvailable(app) {
         try {
-            await app.container.make('queue');
+            await app.container.make('rlanz/queue');
             return true;
         }
         catch {
@@ -55,28 +56,34 @@ export class QueueInspector {
     /**
      * List jobs filtered by status with pagination.
      *
-     * @param status   Job status to filter by.
+     * @param status   Job status to filter by, or `'all'` for every status.
      * @param page     Page number (1-based).
      * @param perPage  Jobs per page.
      */
-    async listJobs(status = 'active', page = 1, perPage = 25) {
+    async listJobs(status = 'all', page = 1, perPage = 25) {
         try {
             const queue = this.getQueue();
             if (!queue)
                 return { jobs: [], total: 0 };
             const start = (page - 1) * perPage;
             const end = start + perPage - 1;
+            const statuses = status === 'all' ? ALL_STATUSES : [status];
             const [rawJobs, counts] = await Promise.all([
-                queue.getJobs([status], start, end),
-                queue.getJobCounts(status),
+                queue.getJobs(statuses, start, end),
+                queue.getJobCounts(...ALL_STATUSES),
             ]);
             const jobs = (rawJobs ?? [])
                 .filter((job) => job !== null && job !== undefined)
-                .map((job) => this.formatJobSummary(job, status));
-            return {
-                jobs,
-                total: counts[status] ?? 0,
-            };
+                .map((job) => {
+                const jobState = this.inferStatus(job) ?? (status === 'all' ? 'completed' : status);
+                return this.formatJobSummary(job, jobState);
+            });
+            // Sort by creation time descending (newest first)
+            jobs.sort((a, b) => b.createdAt - a.createdAt);
+            const total = status === 'all'
+                ? ALL_STATUSES.reduce((sum, s) => sum + (counts[s] ?? 0), 0)
+                : (counts[status] ?? 0);
+            return { jobs, total };
         }
         catch {
             return { jobs: [], total: 0 };
@@ -132,22 +139,21 @@ export class QueueInspector {
     // Private helpers
     // ---------------------------------------------------------------------------
     /**
-     * Get the underlying Bull Queue instance from the queue manager.
+     * Get the underlying BullMQ Queue instance from the queue manager.
      *
-     * `@rlanz/bull-queue` exposes the BullMQ Queue via `.queue` on the manager
-     * or via `.useQueue()`. We try both patterns for compatibility.
+     * `@rlanz/bull-queue` exposes queues via `.get(name)` or `.getOrSet(name)`.
      */
     getQueue() {
         try {
-            // @rlanz/bull-queue v3+ exposes queue directly
-            if (this.queueManager.queue) {
-                return this.queueManager.queue;
+            // @rlanz/bull-queue: .get(name) returns the BullMQ Queue instance
+            if (typeof this.queueManager.get === 'function') {
+                return this.queueManager.get('default') ?? null;
             }
-            // Try getting the default queue
-            if (typeof this.queueManager.useQueue === 'function') {
-                return this.queueManager.useQueue('default');
+            // Fallback: .getOrSet(name) lazily creates the queue if needed
+            if (typeof this.queueManager.getOrSet === 'function') {
+                return this.queueManager.getOrSet('default');
             }
-            // Fallback: the manager itself may be a Queue instance
+            // Last resort: the manager itself is already a Queue instance
             if (typeof this.queueManager.getJobCounts === 'function') {
                 return this.queueManager;
             }
@@ -157,23 +163,63 @@ export class QueueInspector {
             return null;
         }
     }
+    /**
+     * Infer a job's status from its internal fields (avoids async getState() call).
+     */
+    inferStatus(job) {
+        if (job.failedReason || job.stacktrace?.length)
+            return 'failed';
+        if (job.finishedOn)
+            return 'completed';
+        if (job.processedOn)
+            return 'active';
+        if (job.delay && job.delay > 0 && !job.processedOn)
+            return 'delayed';
+        return null;
+    }
+    /**
+     * Extract a human-readable job name from a raw Bull job name.
+     *
+     * `@rlanz/bull-queue` often stores the full file URL as the job name
+     * (e.g. `file:///Users/…/app/jobs/send_email.ts`). We extract just
+     * the class-style name from the filename.
+     */
+    static cleanJobName(raw) {
+        if (!raw || raw === '__default__')
+            return 'default';
+        // Strip file:// URLs down to the filename
+        if (raw.startsWith('file://') || raw.startsWith('/')) {
+            const filename = raw.split('/').pop() ?? raw;
+            // Remove extension and convert snake_case/kebab-case to PascalCase
+            const base = filename.replace(/\.(ts|js|mjs|cjs)$/, '');
+            return base
+                .split(/[-_]/)
+                .map((s) => s.charAt(0).toUpperCase() + s.slice(1))
+                .join('');
+        }
+        return raw;
+    }
     /**
      * Format a Bull job into our summary shape.
      */
     formatJobSummary(job, status) {
         const processedAt = job.processedOn ?? null;
         const finishedAt = job.finishedOn ?? null;
-        const duration = processedAt != null && finishedAt != null ? finishedAt - processedAt : null;
+        const duration = processedAt !== null && finishedAt !== null ? finishedAt - processedAt : null;
+        const createdAt = job.timestamp ?? 0;
+        const data = job.data ?? null;
         return {
             id: String(job.id),
-            name: job.name ?? 'unknown',
+            name: QueueInspector.cleanJobName(job.name ?? 'unknown'),
             status,
-            data: job.data ?? null,
+            data,
+            payload: data,
             attempts: job.attemptsMade ?? 0,
             maxAttempts: job.opts?.attempts ?? 1,
             progress: job.progress ?? 0,
             failedReason: job.failedReason ?? null,
-            createdAt: job.timestamp ?? 0,
+            createdAt,
+            timestamp: createdAt,
             processedAt,
             finishedAt,
             duration,

package/dist/src/dashboard/migrator.d.ts

@@ -5,6 +5,9 @@ import type { Knex } from 'knex';
  * Uses raw SQL (not Lucid migrations) so we never pollute the host
  * application's migration history.  Each `CREATE TABLE` / `CREATE INDEX`
  * uses `IF NOT EXISTS` so the function is idempotent.
+ *
+ * Yields to the event loop between each table so the server can
+ * continue processing HTTP requests during migration.
  */
 export declare function autoMigrate(db: Knex): Promise<void>;
 /**
@@ -13,6 +16,8 @@ export declare function autoMigrate(db: Knex): Promise<void>;
  * Foreign-key cascades on `server_stats_requests` handle the child
  * tables (queries, events, traces).  Standalone tables (logs, emails,
  * metrics, saved_filters) are pruned individually.
+ *
+ * Yields between each DELETE so the event loop stays responsive.
  */
 export declare function runRetentionCleanup(db: Knex, retentionDays: number): Promise<void>;
 //# sourceMappingURL=migrator.d.ts.map

package/dist/src/dashboard/migrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"migrator.d.ts","sourceRoot":"","sources":["../../../src/dashboard/migrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAEhC;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CA6IzD;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYxF"}
+{"version":3,"file":"migrator.d.ts","sourceRoot":"","sources":["../../../src/dashboard/migrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAahC;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAoJzD;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CAAC,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BxF"}

package/dist/src/dashboard/migrator.js

@@ -1,9 +1,22 @@
+/**
+ * Yield control back to the event loop so Node.js can process pending
+ * I/O (incoming HTTP requests, timers, etc.).
+ *
+ * `better-sqlite3` is fully synchronous — when Knex wraps it, each
+ * `await db.raw(...)` resolves via the microtask queue, never actually
+ * yielding to the I/O phase. Without explicit yields, 25+ sequential
+ * migration statements block the event loop for their entire duration.
+ */
+const yieldToEventLoop = () => new Promise((resolve) => setImmediate(resolve));
 /**
  * Auto-migrate all dashboard SQLite tables.
  *
  * Uses raw SQL (not Lucid migrations) so we never pollute the host
  * application's migration history.  Each `CREATE TABLE` / `CREATE INDEX`
  * uses `IF NOT EXISTS` so the function is idempotent.
+ *
+ * Yields to the event loop between each table so the server can
+ * continue processing HTTP requests during migration.
  */
 export async function autoMigrate(db) {
     // -- server_stats_requests --------------------------------------------------
@@ -21,6 +34,7 @@ export async function autoMigrate(db) {
   `);
     await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_requests_created ON server_stats_requests(created_at)`);
     await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_requests_url ON server_stats_requests(url)`);
+    await yieldToEventLoop();
     // -- server_stats_queries ---------------------------------------------------
     await db.raw(`
     CREATE TABLE IF NOT EXISTS server_stats_queries (
@@ -40,6 +54,7 @@ export async function autoMigrate(db) {
     await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_queries_created ON server_stats_queries(created_at)`);
     await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_queries_normalized ON server_stats_queries(sql_normalized)`);
     await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_queries_request ON server_stats_queries(request_id)`);
+    await yieldToEventLoop();
     // -- server_stats_events ----------------------------------------------------
     await db.raw(`
     CREATE TABLE IF NOT EXISTS server_stats_events (
@@ -51,6 +66,7 @@ export async function autoMigrate(db) {
     )
   `);
     await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_events_created ON server_stats_events(created_at)`);
+    await yieldToEventLoop();
     // -- server_stats_emails ----------------------------------------------------
     await db.raw(`
     CREATE TABLE IF NOT EXISTS server_stats_emails (
@@ -70,6 +86,7 @@ export async function autoMigrate(db) {
     )
   `);
     await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_emails_created ON server_stats_emails(created_at)`);
+    await yieldToEventLoop();
     // -- server_stats_logs ------------------------------------------------------
     await db.raw(`
     CREATE TABLE IF NOT EXISTS server_stats_logs (
@@ -84,6 +101,7 @@ export async function autoMigrate(db) {
     await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_logs_created ON server_stats_logs(created_at)`);
     await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_logs_level ON server_stats_logs(level)`);
     await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_logs_request ON server_stats_logs(request_id)`);
+    await yieldToEventLoop();
     // -- server_stats_traces ----------------------------------------------------
     await db.raw(`
     CREATE TABLE IF NOT EXISTS server_stats_traces (
@@ -100,6 +118,7 @@ export async function autoMigrate(db) {
     )
   `);
     await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_traces_created ON server_stats_traces(created_at)`);
+    await yieldToEventLoop();
     // -- server_stats_metrics ---------------------------------------------------
     await db.raw(`
     CREATE TABLE IF NOT EXISTS server_stats_metrics (
@@ -115,6 +134,7 @@ export async function autoMigrate(db) {
     )
   `);
     await db.raw(`CREATE INDEX IF NOT EXISTS idx_ss_metrics_bucket ON server_stats_metrics(bucket)`);
+    await yieldToEventLoop();
     // -- server_stats_saved_filters ---------------------------------------------
     await db.raw(`
     CREATE TABLE IF NOT EXISTS server_stats_saved_filters (
@@ -132,15 +152,30 @@ export async function autoMigrate(db) {
  * Foreign-key cascades on `server_stats_requests` handle the child
  * tables (queries, events, traces).  Standalone tables (logs, emails,
  * metrics, saved_filters) are pruned individually.
+ *
+ * Yields between each DELETE so the event loop stays responsive.
  */
 export async function runRetentionCleanup(db, retentionDays) {
-    const modifier = `-${retentionDays} days`;
-    // Cascade deletes queries, events, traces via FK ON DELETE CASCADE
-    await db.raw(`DELETE FROM server_stats_requests WHERE created_at < datetime('now', ?)`, [
-        modifier,
-    ]);
-    // Standalone tables
-    await db.raw(`DELETE FROM server_stats_logs WHERE created_at < datetime('now', ?)`, [modifier]);
-    await db.raw(`DELETE FROM server_stats_emails WHERE created_at < datetime('now', ?)`, [modifier]);
-    await db.raw(`DELETE FROM server_stats_metrics WHERE created_at < datetime('now', ?)`, [modifier]);
+    // Use string interpolation instead of parameterized bindings.
+    // Knex + better-sqlite3 can hang on parameterized db.raw() calls,
+    // while non-parameterized queries (used in migrations) work fine.
+    // Safe here — retentionDays is always a controlled integer.
+    const days = Math.max(1, Math.floor(retentionDays));
+    const cutoff = `datetime('now', '-${days} days')`;
+    try {
+        // Cascade deletes queries, events, traces via FK ON DELETE CASCADE
+        await db.raw(`DELETE FROM server_stats_requests WHERE created_at < ${cutoff}`);
+        await yieldToEventLoop();
+        // Standalone tables
+        await db.raw(`DELETE FROM server_stats_logs WHERE created_at < ${cutoff}`);
+        await yieldToEventLoop();
+        await db.raw(`DELETE FROM server_stats_emails WHERE created_at < ${cutoff}`);
+        await yieldToEventLoop();
+        await db.raw(`DELETE FROM server_stats_metrics WHERE created_at < ${cutoff}`);
+    }
+    catch (err) {
+        // Log but don't throw — retention cleanup failure shouldn't block init
+        const { log } = await import('../utils/logger.js');
+        log.warn(`dashboard: retention cleanup error — ${err?.message}`);
+    }
 }

package/dist/src/dashboard/models/stats_event.d.ts

@@ -7,7 +7,7 @@ export default class StatsEvent extends BaseModel {
     id: number;
     requestId: number | null;
     eventName: string;
-    data: any | null;
+    data: Record<string, unknown> | null;
     createdAt: string;
     request: BelongsTo<typeof StatsRequest>;
 }

package/dist/src/dashboard/models/stats_event.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stats_event.d.ts","sourceRoot":"","sources":["../../../../src/dashboard/models/stats_event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAqB,MAAM,qBAAqB,CAAA;AAElE,OAAO,YAAY,MAAM,oBAAoB,CAAA;AAE7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAA;AAEhE,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,SAAS;IAC/C,MAAM,CAAC,UAAU,SAAiB;IAClC,MAAM,CAAC,KAAK,SAAwB;IAG5B,EAAE,EAAE,MAAM,CAAA;IAGV,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IAGxB,SAAS,EAAE,MAAM,CAAA;IAOjB,IAAI,EAAE,GAAG,GAAG,IAAI,CAAA;IAGhB,SAAS,EAAE,MAAM,CAAA;IAGjB,OAAO,EAAE,SAAS,CAAC,OAAO,YAAY,CAAC,CAAA;CAChD"}
+{"version":3,"file":"stats_event.d.ts","sourceRoot":"","sources":["../../../../src/dashboard/models/stats_event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAqB,MAAM,qBAAqB,CAAA;AAElE,OAAO,YAAY,MAAM,oBAAoB,CAAA;AAE7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAA;AAEhE,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,SAAS;IAC/C,MAAM,CAAC,UAAU,SAAiB;IAClC,MAAM,CAAC,KAAK,SAAwB;IAG5B,EAAE,EAAE,MAAM,CAAA;IAGV,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IAGxB,SAAS,EAAE,MAAM,CAAA;IAOjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAGpC,SAAS,EAAE,MAAM,CAAA;IAGjB,OAAO,EAAE,SAAS,CAAC,OAAO,YAAY,CAAC,CAAA;CAChD"}

package/dist/src/dashboard/models/stats_log.d.ts

@@ -6,7 +6,7 @@ export default class StatsLog extends BaseModel {
     level: string;
     message: string;
     requestId: string | null;
-    data: any | null;
+    data: Record<string, unknown> | null;
     createdAt: string;
 }
 //# sourceMappingURL=stats_log.d.ts.map

package/dist/src/dashboard/models/stats_log.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stats_log.d.ts","sourceRoot":"","sources":["../../../../src/dashboard/models/stats_log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAU,MAAM,qBAAqB,CAAA;AAEvD,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,SAAS;IAC7C,MAAM,CAAC,UAAU,SAAiB;IAClC,MAAM,CAAC,KAAK,SAAsB;IAG1B,EAAE,EAAE,MAAM,CAAA;IAGV,KAAK,EAAE,MAAM,CAAA;IAGb,OAAO,EAAE,MAAM,CAAA;IAGf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IAOxB,IAAI,EAAE,GAAG,GAAG,IAAI,CAAA;IAGhB,SAAS,EAAE,MAAM,CAAA;CAC1B"}
+{"version":3,"file":"stats_log.d.ts","sourceRoot":"","sources":["../../../../src/dashboard/models/stats_log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAU,MAAM,qBAAqB,CAAA;AAEvD,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,SAAS;IAC7C,MAAM,CAAC,UAAU,SAAiB;IAClC,MAAM,CAAC,KAAK,SAAsB;IAG1B,EAAE,EAAE,MAAM,CAAA;IAGV,KAAK,EAAE,MAAM,CAAA;IAGb,OAAO,EAAE,MAAM,CAAA;IAGf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IAOxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAGpC,SAAS,EAAE,MAAM,CAAA;CAC1B"}

package/dist/src/dashboard/models/stats_query.d.ts

@@ -8,7 +8,7 @@ export default class StatsQuery extends BaseModel {
     requestId: number | null;
     sqlText: string;
     sqlNormalized: string;
-    bindings: any[] | null;
+    bindings: unknown[] | null;
     duration: number;
     method: string | null;
     model: string | null;

package/dist/src/dashboard/models/stats_query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stats_query.d.ts","sourceRoot":"","sources":["../../../../src/dashboard/models/stats_query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAqB,MAAM,qBAAqB,CAAA;AAElE,OAAO,YAAY,MAAM,oBAAoB,CAAA;AAE7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAA;AAEhE,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,SAAS;IAC/C,MAAM,CAAC,UAAU,SAAiB;IAClC,MAAM,CAAC,KAAK,SAAyB;IAG7B,EAAE,EAAE,MAAM,CAAA;IAGV,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IAGxB,OAAO,EAAE,MAAM,CAAA;IAGf,aAAa,EAAE,MAAM,CAAA;IAOrB,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;IAGtB,QAAQ,EAAE,MAAM,CAAA;IAGhB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAGrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAGpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IAGzB,aAAa,EAAE,MAAM,CAAA;IAGrB,SAAS,EAAE,MAAM,CAAA;IAGjB,OAAO,EAAE,SAAS,CAAC,OAAO,YAAY,CAAC,CAAA;CAChD"}
+{"version":3,"file":"stats_query.d.ts","sourceRoot":"","sources":["../../../../src/dashboard/models/stats_query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAqB,MAAM,qBAAqB,CAAA;AAElE,OAAO,YAAY,MAAM,oBAAoB,CAAA;AAE7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAA;AAEhE,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,SAAS;IAC/C,MAAM,CAAC,UAAU,SAAiB;IAClC,MAAM,CAAC,KAAK,SAAyB;IAG7B,EAAE,EAAE,MAAM,CAAA;IAGV,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IAGxB,OAAO,EAAE,MAAM,CAAA;IAGf,aAAa,EAAE,MAAM,CAAA;IAOrB,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAG1B,QAAQ,EAAE,MAAM,CAAA;IAGhB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAGrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAGpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IAGzB,aAAa,EAAE,MAAM,CAAA;IAGrB,SAAS,EAAE,MAAM,CAAA;IAGjB,OAAO,EAAE,SAAS,CAAC,OAAO,YAAY,CAAC,CAAA;CAChD"}

package/dist/src/dashboard/models/stats_saved_filter.d.ts

@@ -5,7 +5,7 @@ export default class StatsSavedFilter extends BaseModel {
     id: number;
     name: string;
     section: string;
-    filterConfig: Record<string, any>;
+    filterConfig: Record<string, unknown>;
     createdAt: string;
 }
 //# sourceMappingURL=stats_saved_filter.d.ts.map

package/dist/src/dashboard/models/stats_saved_filter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stats_saved_filter.d.ts","sourceRoot":"","sources":["../../../../src/dashboard/models/stats_saved_filter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAU,MAAM,qBAAqB,CAAA;AAEvD,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,SAAS;IACrD,MAAM,CAAC,UAAU,SAAiB;IAClC,MAAM,CAAC,KAAK,SAA+B;IAGnC,EAAE,EAAE,MAAM,CAAA;IAGV,IAAI,EAAE,MAAM,CAAA;IAGZ,OAAO,EAAE,MAAM,CAAA;IAOf,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAGjC,SAAS,EAAE,MAAM,CAAA;CAC1B"}
+{"version":3,"file":"stats_saved_filter.d.ts","sourceRoot":"","sources":["../../../../src/dashboard/models/stats_saved_filter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAU,MAAM,qBAAqB,CAAA;AAEvD,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,SAAS;IACrD,MAAM,CAAC,UAAU,SAAiB;IAClC,MAAM,CAAC,KAAK,SAA+B;IAGnC,EAAE,EAAE,MAAM,CAAA;IAGV,IAAI,EAAE,MAAM,CAAA;IAGZ,OAAO,EAAE,MAAM,CAAA;IAOf,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAGrC,SAAS,EAAE,MAAM,CAAA;CAC1B"}

package/dist/src/dashboard/models/stats_trace.d.ts

@@ -1,5 +1,6 @@
 import { BaseModel } from '@adonisjs/lucid/orm';
 import StatsRequest from './stats_request.js';
+import type { TraceSpan } from '../../debug/types.js';
 import type { BelongsTo } from '@adonisjs/lucid/types/relations';
 export default class StatsTrace extends BaseModel {
     static connection: string;
@@ -11,7 +12,7 @@ export default class StatsTrace extends BaseModel {
     statusCode: number;
     totalDuration: number;
     spanCount: number;
-    spans: any[];
+    spans: TraceSpan[];
     warnings: string[] | null;
     createdAt: string;
     request: BelongsTo<typeof StatsRequest>;

package/dist/src/dashboard/models/stats_trace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stats_trace.d.ts","sourceRoot":"","sources":["../../../../src/dashboard/models/stats_trace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAqB,MAAM,qBAAqB,CAAA;AAElE,OAAO,YAAY,MAAM,oBAAoB,CAAA;AAE7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAA;AAEhE,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,SAAS;IAC/C,MAAM,CAAC,UAAU,SAAiB;IAClC,MAAM,CAAC,KAAK,SAAwB;IAG5B,EAAE,EAAE,MAAM,CAAA;IAGV,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IAGxB,MAAM,EAAE,MAAM,CAAA;IAGd,GAAG,EAAE,MAAM,CAAA;IAGX,UAAU,EAAE,MAAM,CAAA;IAGlB,aAAa,EAAE,MAAM,CAAA;IAGrB,SAAS,EAAE,MAAM,CAAA;IAOjB,KAAK,EAAE,GAAG,EAAE,CAAA;IAOZ,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IAGzB,SAAS,EAAE,MAAM,CAAA;IAGjB,OAAO,EAAE,SAAS,CAAC,OAAO,YAAY,CAAC,CAAA;CAChD"}
+{"version":3,"file":"stats_trace.d.ts","sourceRoot":"","sources":["../../../../src/dashboard/models/stats_trace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAqB,MAAM,qBAAqB,CAAA;AAElE,OAAO,YAAY,MAAM,oBAAoB,CAAA;AAE7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAA;AAEhE,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,SAAS;IAC/C,MAAM,CAAC,UAAU,SAAiB;IAClC,MAAM,CAAC,KAAK,SAAwB;IAG5B,EAAE,EAAE,MAAM,CAAA;IAGV,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IAGxB,MAAM,EAAE,MAAM,CAAA;IAGd,GAAG,EAAE,MAAM,CAAA;IAGX,UAAU,EAAE,MAAM,CAAA;IAGlB,aAAa,EAAE,MAAM,CAAA;IAGrB,SAAS,EAAE,MAAM,CAAA;IAOjB,KAAK,EAAE,SAAS,EAAE,CAAA;IAOlB,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IAGzB,SAAS,EAAE,MAAM,CAAA;IAGjB,OAAO,EAAE,SAAS,CAAC,OAAO,YAAY,CAAC,CAAA;CAChD"}

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

@@ -0,0 +1,105 @@
+import type { DashboardStore } from '../dashboard/dashboard_store.js';
+import type { DebugStore } from '../debug/debug_store.js';
+import type { QueryRecord, EventRecord, TraceRecord, RouteRecord } from '../debug/types.js';
+export interface ListOptions {
+    page?: number;
+    perPage?: number;
+    search?: string;
+    sort?: string;
+    sortDir?: 'asc' | 'desc';
+    filters?: Record<string, unknown>;
+    /**
+     * Force the data source for this read.
+     *
+     * - `'memory'` — always read from ring buffers ({@link DebugStore}).
+     *   Use this for the debug panel, which expects camelCase field names
+     *   matching the {@link QueryRecord}/{@link EventRecord}/etc. interfaces.
+     * - `'auto'` (default) — use SQLite when available, fall back to memory.
+     */
+    source?: 'memory' | 'auto';
+}
+export interface PaginatedResult<T = Record<string, unknown>> {
+    data: T[];
+    meta: {
+        total: number;
+        page: number;
+        perPage: number;
+        lastPage: number;
+    };
+}
+/**
+ * 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 declare class DataAccess {
+    private debugStore;
+    private getDashboardStore;
+    private logPath?;
+    constructor(debugStore: DebugStore, dashboardStore: DashboardStore | null | (() => DashboardStore | null), logPath?: string);
+    /** Whether SQLite persistence is available and initialised. */
+    get hasPersistence(): boolean;
+    /** Resolve the dashboard store (may be null if not yet initialized). */
+    private get dashboardStore();
+    getQueries(opts?: ListOptions): Promise<PaginatedResult<QueryRecord>>;
+    getQuerySummary(): {
+        total: number;
+        slow: number;
+        duplicates: number;
+        avgDuration: number;
+    };
+    getEvents(opts?: ListOptions): Promise<PaginatedResult<EventRecord>>;
+    /**
+     * Paginated email list.
+     *
+     * HTML and text bodies are stripped from the list response to keep
+     * payloads lightweight. Use {@link getEmailPreview} for the full body.
+     */
+    getEmails(opts?: ListOptions): Promise<PaginatedResult>;
+    /**
+     * 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.
+     */
+    getEmailPreview(id: number, source?: 'memory' | 'auto'): Promise<string | null>;
+    /**
+     * Paginated trace list.
+     *
+     * Span arrays are stripped from the list response to keep payloads
+     * lightweight. Use {@link getTraceDetail} for the full span tree.
+     */
+    getTraces(opts?: ListOptions): Promise<PaginatedResult>;
+    /**
+     * Get a single trace with full span tree.
+     *
+     * Returns `null` when the trace is not found.
+     */
+    getTraceDetail(id: number, source?: 'memory' | 'auto'): Promise<TraceRecord | null>;
+    /**
+     * 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?: string): PaginatedResult<RouteRecord>;
+    /**
+     * 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.
+     */
+    getLogs(opts?: ListOptions): Promise<PaginatedResult>;
+    /**
+     * 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.
+     */
+    private readLogFile;
+}
+//# sourceMappingURL=data_access.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"data_access.d.ts","sourceRoot":"","sources":["../../../src/data/data_access.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,cAAc,EAMf,MAAM,iCAAiC,CAAA;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EAEX,WAAW,EACX,WAAW,EACZ,MAAM,mBAAmB,CAAA;AAM1B,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAEjC;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC1D,IAAI,EAAE,CAAC,EAAE,CAAA;IACT,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAA;QACb,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,MAAM,CAAA;QACf,QAAQ,EAAE,MAAM,CAAA;KACjB,CAAA;CACF;AAkED;;;;;;;GAOG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,UAAU,CAAY;IAC9B,OAAO,CAAC,iBAAiB,CAA6B;IACtD,OAAO,CAAC,OAAO,CAAC,CAAQ;gBAGtB,UAAU,EAAE,UAAU,EACtB,cAAc,EAAE,cAAc,GAAG,IAAI,GAAG,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC,EACrE,OAAO,CAAC,EAAE,MAAM;IAQlB,+DAA+D;IAC/D,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED,wEAAwE;IACxE,OAAO,KAAK,cAAc,GAEzB;IAMK,UAAU,CAAC,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;IAsB/E,eAAe,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE;IAQrF,SAAS,CAAC,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;IAsB9E;;;;;OAKG;IACG,SAAS,CAAC,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAwBjE;;;;;OAKG;IACG,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAYrF;;;;;OAKG;IACG,SAAS,CAAC,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IA4BjE;;;;OAIG;IACG,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAazF;;;;;OAKG;IACH,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,WAAW,CAAC;IA8BxD;;;;;;OAMG;IACG,OAAO,CAAC,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IAyB/D;;;;;OAKG;YACW,WAAW;CAoC1B"}