adonisjs-server-stats 1.17.0 → 1.18.1

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

@@ -3,6 +3,7 @@ export declare function parseAndEnrich(line: string): Record<string, unknown> |
 export declare class LogStreamService {
     private recentEntries;
     private static readonly MAX_RECENT_ENTRIES;
+    private static readonly MAX_POLL_BYTES;
     private lastSize;
     private intervalId;
     private logPath;
@@ -16,8 +17,12 @@ export declare class LogStreamService {
      * in real-time without file polling.
      */
     ingest(entry: Record<string, unknown>): void;
+    /** Record a timestamp, capping the array to prevent unbounded growth under high log volume. */
+    private pushRecent;
     getLogStats(): LogStats;
     start(): Promise<void>;
     stop(): void;
+    /** Reset the once-per-streak failure flag after a fully successful poll. */
+    private markPollHealthy;
     private pollNewEntries;
 }

package/dist/src/log_stream/log_stream_service.js

@@ -27,6 +27,7 @@ export function parseAndEnrich(line) {
 export class LogStreamService {
     recentEntries = [];
     static MAX_RECENT_ENTRIES = 10_000;
+    static MAX_POLL_BYTES = 4 * 1024 * 1024;
     lastSize = 0;
     intervalId = null;
     logPath;
@@ -44,12 +45,15 @@ export class LogStreamService {
      */
     ingest(entry) {
         const level = typeof entry.level === 'number' ? entry.level : 30;
-        // Cap the array to prevent unbounded growth under high log volume
+        this.pushRecent(Date.now(), level);
+        this.onEntry?.(entry);
+    }
+    /** Record a timestamp, capping the array to prevent unbounded growth under high log volume. */
+    pushRecent(time, level) {
         if (this.recentEntries.length >= LogStreamService.MAX_RECENT_ENTRIES) {
             this.recentEntries.splice(0, Math.floor(LogStreamService.MAX_RECENT_ENTRIES / 4));
         }
-        this.recentEntries.push({ time: Date.now(), level });
-        this.onEntry?.(entry);
+        this.recentEntries.push({ time, level });
     }
     getLogStats() {
         const now = Date.now();
@@ -102,36 +106,57 @@ export class LogStreamService {
             this.intervalId = null;
         }
     }
+    /** Reset the once-per-streak failure flag after a fully successful poll. */
+    markPollHealthy() {
+        if (this.warnedPollFailure) {
+            this.warnedPollFailure = false;
+            log.info('log stream: log file is readable again — resuming');
+        }
+    }
     async pollNewEntries() {
         if (!this.logPath)
             return;
         try {
-            this.warnedPollFailure = false;
             const stats = await stat(this.logPath);
             // File was truncated/rotated — reset
             if (stats.size < this.lastSize) {
                 this.lastSize = 0;
             }
-            if (stats.size <= this.lastSize)
+            if (stats.size <= this.lastSize) {
+                this.markPollHealthy();
                 return;
-            const newBytes = stats.size - this.lastSize;
+            }
+            // Cap each read so a rotation reset or burst can never allocate the
+            // whole backlog in one buffer; skip ahead and read only the tail.
+            // A partial first line after skipping fails JSON.parse and is dropped.
+            const readFrom = Math.max(this.lastSize, stats.size - LogStreamService.MAX_POLL_BYTES);
+            const newBytes = stats.size - readFrom;
             const buffer = Buffer.alloc(newBytes);
             const fd = await open(this.logPath, 'r');
-            await fd.read(buffer, 0, newBytes, this.lastSize).finally(() => fd.close());
+            await fd.read(buffer, 0, newBytes, readFrom).finally(() => fd.close());
             this.lastSize = stats.size;
+            this.markPollHealthy();
             for (const line of buffer.toString('utf-8').trim().split('\n')) {
                 const entry = parseAndEnrich(line);
                 if (entry) {
                     const level = typeof entry.level === 'number' ? entry.level : 30;
                     const time = typeof entry.time === 'number' ? entry.time : Date.now();
-                    this.recentEntries.push({ time, level });
+                    this.pushRecent(time, level);
                     this.onEntry?.(entry);
                 }
             }
         }
         catch (err) {
-            if (!this.warnedPollFailure) {
-                this.warnedPollFailure = true;
+            if (this.warnedPollFailure)
+                return;
+            this.warnedPollFailure = true;
+            // A missing file is a normal state for the fallback poller — the file
+            // appears once the app writes its first log line. Anything else
+            // (permissions, a directory in the way) deserves a real warning.
+            if (err?.code === 'ENOENT') {
+                log.info('log stream: log file not found (will keep watching) — ' + this.logPath);
+            }
+            else {
                 log.warn('log stream: cannot read log file — ' + err?.message);
             }
         }

package/dist/src/provider/dashboard_setup.js

@@ -62,6 +62,7 @@ const TOOLBAR_DEFAULTS = {
     dashboard: false,
     dashboardPath: '/__stats',
     retentionDays: 7,
+    maxDbSizeMb: 500,
     dbPath: '.adonisjs/server-stats/dashboard.sqlite3',
     debugEndpoint: '/admin/api/debug',
 };
@@ -110,6 +111,18 @@ function resolveRetentionDays(ctx, explicit) {
         return explicit;
     return ctx?.inProduction ? PRODUCTION_RETENTION_DAYS : TOOLBAR_DEFAULTS.retentionDays;
 }
+/**
+ * Resolve the database size cap. Order: `production.maxDbSizeMb` when in
+ * production, then whatever `dashboard` set, then the 500 MB default.
+ */
+function resolveMaxDbSizeMb(ctx, explicit) {
+    const fromProduction = ctx?.inProduction ? ctx.production?.maxDbSizeMb : undefined;
+    if (fromProduction !== undefined)
+        return fromProduction;
+    if (explicit !== undefined)
+        return explicit;
+    return TOOLBAR_DEFAULTS.maxDbSizeMb;
+}
 /**
  * Resolve a partial DevToolbarConfig by filling in all defaults.
  *
@@ -125,6 +138,7 @@ export function resolveToolbarConfig(partial, ctx) {
     return {
         ...merged,
         retentionDays: resolveRetentionDays(ctx, partial.retentionDays),
+        maxDbSizeMb: resolveMaxDbSizeMb(ctx, partial.maxDbSizeMb),
         capture: resolveCapture(ctx, merged.tracing),
     };
 }

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

@@ -47,6 +47,7 @@ interface DiagnosticsToolbar {
     dashboard?: boolean;
     dashboardPath?: string;
     retentionDays?: number;
+    maxDbSizeMb?: number;
     dbPath?: string;
     persistDebugData?: boolean | string;
     debugEndpoint?: string;
@@ -118,6 +119,7 @@ export declare function buildDiagnostics(input: DiagnosticsInput): {
         tracing: boolean;
         dashboard: boolean;
         retentionDays: number;
+        maxDbSizeMb: number;
         persistDebugData: string | boolean;
         renderer: string;
         excludeFromTracing: string[];

package/dist/src/provider/diagnostics.js

@@ -85,6 +85,7 @@ function pickToolbarFeatures(tb) {
         tracing: tb.tracing ?? true,
         dashboard: tb.dashboard ?? false,
         retentionDays: tb.retentionDays ?? 7,
+        maxDbSizeMb: tb.maxDbSizeMb ?? 500,
         persistDebugData: tb.persistDebugData ?? false,
         renderer: tb.renderer ?? 'preact',
         excludeFromTracing: tb.excludeFromTracing ?? [],

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

@@ -132,6 +132,7 @@ export default class ServerStatsProvider {
             tracing: boolean;
             dashboard: boolean;
             retentionDays: number;
+            maxDbSizeMb: number;
             persistDebugData: string | boolean;
             renderer: string;
             excludeFromTracing: string[];

package/dist/src/stubs/config.stub

@@ -17,6 +17,10 @@ export default defineConfig({
   // Enable the full-page dashboard at /__stats
   // dashboard: true,
 
+  // History window and disk budget for persisted stats. When the database
+  // outgrows the size cap the oldest records are pruned regardless of age.
+  // dashboard: { retentionDays: 7, maxDbSizeMb: 500 },
+
   // Log detailed initialization steps (SQLite, migrations, routes, etc.)
   // verbose: true,
 

package/dist/src/types.d.ts

@@ -263,6 +263,15 @@ export interface DevToolbarOptions {
      * @default 7
      */
     retentionDays?: number;
+    /**
+     * Size cap in MB for the SQLite database's live data. When exceeded,
+     * the hourly cleanup deletes the oldest records — regardless of age —
+     * until usage drops below the cap, effectively shortening the retention
+     * window when write volume outruns `retentionDays`. Set to `0` to
+     * disable the cap.
+     * @default 500
+     */
+    maxDbSizeMb?: number;
     /**
      * Path to the SQLite database file for historical persistence.
      * Relative to app root.
@@ -434,6 +443,17 @@ export interface DashboardConfig {
      * @default 7
      */
     retentionDays?: number;
+    /**
+     * Size cap in MB for the SQLite database's live data.
+     *
+     * When exceeded, the cleanup deletes the oldest records — regardless
+     * of age — until usage drops below the cap. This bounds disk usage
+     * when write volume (tracing, verbose query logging) outruns what
+     * `retentionDays` alone would keep small. Set to `0` to disable.
+     *
+     * @default 500
+     */
+    maxDbSizeMb?: number;
 }
 /**
  * Access-control callback signature.
@@ -515,13 +535,21 @@ export interface ProductionConfig {
     capture?: CaptureConfig;
     /**
      * How many days of history to keep in SQLite, overriding the usual default
-     * of 7. Retention deletes rows hourly but never runs `VACUUM`, so the
-     * database file reuses pages rather than shrinking — watch actual size via
-     * the dashboard's storage panel.
+     * of 7. Retention deletes rows hourly and returns freed pages to the OS
+     * incrementally — watch actual size via the dashboard's storage panel.
      *
      * @default 3
      */
     retentionDays?: number;
+    /**
+     * Size cap in MB for the SQLite database's live data in production,
+     * overriding the usual default. When exceeded, the hourly cleanup deletes
+     * the oldest records — regardless of age — until usage drops below the
+     * cap. Set to `0` to disable.
+     *
+     * @default 500
+     */
+    maxDbSizeMb?: number;
 }
 /**
  * Advanced options that most users never need to touch.

package/dist/vue/{CacheSection-Bm0goqX6.js → CacheSection-z2TQRez9.js}

@@ -1,5 +1,5 @@
 import { defineComponent as L, inject as y, ref as h, onMounted as x, computed as w, onUnmounted as F, openBlock as l, createElementBlock as n, createElementVNode as e, toDisplayString as c, createCommentVNode as z, createVNode as N, unref as p, Fragment as U, renderList as B, withModifiers as M, createBlock as H } from "vue";
-import { u as I } from "./index-DUsImuIN.js";
+import { u as I } from "./index-BfPAAjL5.js";
 import { u as j } from "./useResizableTable-BoivAevK.js";
 import { DashboardApi as q, formatCacheSize as P, formatTtl as G } from "adonisjs-server-stats/core";
 import { u as J } from "./useApiClient-BQQ9CF-q.js";

package/dist/vue/{ConfigSection-BrYslIMN.js → ConfigSection-CFEaig69.js}

@@ -1,5 +1,5 @@
 import { defineComponent as nt, inject as L, ref as h, computed as k, openBlock as r, createElementBlock as c, createElementVNode as n, normalizeClass as a, createCommentVNode as g, Fragment as x, toDisplayString as u, unref as d, renderList as E, normalizeStyle as j } from "vue";
-import { u as lt } from "./index-DUsImuIN.js";
+import { u as lt } from "./index-BfPAAjL5.js";
 import { isRedactedValue as p, flattenConfig as O, countLeaves as ot, collectTopLevelObjectKeys as st, copyWithFeedback as at, formatFlatValue as rt } from "adonisjs-server-stats/core";
 const ct = { style: { position: "relative", flex: 1 } }, ut = ["value"], it = ["onClick"], pt = { key: 0 }, dt = ["onClick"], vt = { key: 0 }, ft = { style: { padding: "4px 16px", fontSize: "10px", color: "var(--ss-muted)" } }, yt = ["onClick"], gt = ["title"], bt = ["title"], ht = ["onClick"], $t = {
   key: 1,

package/dist/vue/{EmailsSection-B8N5vaWA.js → EmailsSection-CYohBo62.js}

@@ -1,6 +1,6 @@
 import { defineComponent as B, inject as f, ref as w, computed as g, onUnmounted as D, openBlock as s, createElementBlock as n, createElementVNode as t, Fragment as m, createTextVNode as d, toDisplayString as i, createCommentVNode as _, normalizeClass as k, createVNode as R, unref as r, renderList as U, createBlock as z } from "vue";
 import { formatTime as L, timeAgo as M } from "adonisjs-server-stats/core";
-import { u as q } from "./index-DUsImuIN.js";
+import { u as q } from "./index-BfPAAjL5.js";
 import { u as H } from "./useResizableTable-BoivAevK.js";
 import { _ as I } from "./FilterBar.vue_vue_type_script_setup_true_lang-ClJ37hhT.js";
 import { _ as K } from "./PaginationControls.vue_vue_type_script_setup_true_lang-CuN7g_8Z.js";

package/dist/vue/{EventsSection-D2Y_xt0m.js → EventsSection-B_TuVrGj.js}

@@ -1,6 +1,6 @@
 import { defineComponent as E, inject as i, ref as p, computed as P, openBlock as s, createElementBlock as l, createVNode as v, unref as a, Fragment as h, createElementVNode as e, renderList as T, toDisplayString as c, createBlock as C, createCommentVNode as D } from "vue";
 import { formatTime as S, timeAgo as V } from "adonisjs-server-stats/core";
-import { u as $ } from "./index-DUsImuIN.js";
+import { u as $ } from "./index-BfPAAjL5.js";
 import { u as A } from "./useResizableTable-BoivAevK.js";
 import { _ as B } from "./FilterBar.vue_vue_type_script_setup_true_lang-ClJ37hhT.js";
 import { _ as R } from "./PaginationControls.vue_vue_type_script_setup_true_lang-CuN7g_8Z.js";