adonisjs-server-stats 1.6.2 → 1.6.11

package/dist/src/provider/server_stats_provider.js

@@ -5,7 +5,7 @@ import { StatsEngine } from '../engine/stats_engine.js';
 import { LogStreamService } from '../log_stream/log_stream_service.js';
 import { setShouldShow, setTraceCollector, setDashboardPath, setExcludedPrefixes, setOnRequestComplete, } from '../middleware/request_tracking_middleware.js';
 import { registerAllRoutes } from '../routes/register_routes.js';
-import { log, dim, bold } from '../utils/logger.js';
+import { log, dim, bold, setVerbose } from '../utils/logger.js';
 export default class ServerStatsProvider {
     app;
     intervalId = null;
@@ -52,6 +52,9 @@ export default class ServerStatsProvider {
             log.warn('no config found — is config/server_stats.ts set up?');
             return;
         }
+        // Re-apply verbose setting from resolved config so the logger
+        // respects it even if defineConfig() ran in a separate context.
+        setVerbose(config.verbose);
         log.info('booting...');
         // Wire up the per-request shouldShow callback
         if (config.shouldShow) {
@@ -403,7 +406,7 @@ export default class ServerStatsProvider {
                 const stats = await this.engine.collect();
                 if (transmit && config.channelName) {
                     ;
-                    transmit.broadcast(config.channelName, JSON.parse(JSON.stringify(stats)));
+                    transmit.broadcast(config.channelName, stats);
                 }
                 if (prometheusCollector) {
                     ;
@@ -614,43 +617,23 @@ export default class ServerStatsProvider {
         const debugStore = this.debugStore;
         const dashStore = this.dashboardStore;
         let lastQueryId = 0;
-        let lastEventId = 0;
-        let warnedPersistOnce = false;
         setOnRequestComplete(({ method, url, statusCode, duration, trace }) => {
             if (!dashStore.isReady())
                 return;
-            // Gather new queries since last request
-            const allQueries = debugStore.queries.getQueries();
-            const newQueries = allQueries.filter((q) => q.id > lastQueryId);
-            if (allQueries.length > 0) {
-                lastQueryId = allQueries[allQueries.length - 1].id;
+            // O(K) collection of new queries since last seen ID — avoids
+            // copying the entire 500-item ring buffer on every request.
+            const newQueries = debugStore.queries.getQueriesSince(lastQueryId);
+            if (newQueries.length > 0) {
+                lastQueryId = newQueries[newQueries.length - 1].id;
             }
-            // Gather new events since last request
-            const allEvents = debugStore.events.getEvents();
-            const newEvents = allEvents.filter((e) => e.id > lastEventId);
-            if (allEvents.length > 0) {
-                lastEventId = allEvents[allEvents.length - 1].id;
-            }
-            // Persist asynchronously (fire-and-forget)
-            dashStore
-                .persistRequest({
+            // Queue for batch persistence (flushed every 500ms)
+            dashStore.persistRequest({
                 method,
                 url,
                 statusCode,
                 duration,
                 queries: newQueries,
                 trace: trace ?? null,
-            })
-                .then((requestId) => {
-                if (requestId !== null && newEvents.length > 0) {
-                    return dashStore.recordEvents(requestId, newEvents);
-                }
-            })
-                .catch((err) => {
-                if (!warnedPersistOnce) {
-                    warnedPersistOnce = true;
-                    log.warn('failed to persist request data — ' + (err?.message || 'unknown error'));
-                }
             });
         });
         // ── Transmit streaming for real-time dashboard updates ────────
@@ -667,6 +650,9 @@ export default class ServerStatsProvider {
             if (!this.transmitChannels.includes(dashChannel)) {
                 this.transmitChannels.push(dashChannel);
             }
+            // Broadcast overview metrics every 30s (not 5s) to reduce SQLite
+            // pool pressure. Each broadcast runs 5+ sequential queries on the
+            // single-connection pool, blocking all dashboard API reads.
             this.dashboardBroadcastTimer = setInterval(async () => {
                 try {
                     if (!dashStore.isReady())
@@ -684,7 +670,7 @@ export default class ServerStatsProvider {
                 catch {
                     // Silently ignore
                 }
-            }, 5_000);
+            }, 30_000);
         }
     }
     /** Return diagnostics state for the Internals endpoint. */
@@ -699,7 +685,7 @@ export default class ServerStatsProvider {
                 },
                 dashboardBroadcast: {
                     active: this.dashboardBroadcastTimer !== null,
-                    intervalMs: 5000,
+                    intervalMs: 30_000,
                 },
                 debugBroadcast: {
                     active: this.debugBroadcastTimer !== null,

package/dist/src/stubs/config.stub

@@ -16,4 +16,7 @@ export default defineConfig({
 
   // Enable the full-page dashboard at /__stats
   // dashboard: true,
+
+  // Log detailed initialization steps (SQLite, migrations, routes, etc.)
+  // verbose: true,
 })

package/dist/src/types.d.ts

@@ -510,6 +510,16 @@ export interface ServerStatsConfig {
     dashboard?: boolean | DashboardConfig;
     /** Advanced options. */
     advanced?: AdvancedConfig;
+    /**
+     * Enable verbose logging during initialization.
+     *
+     * When `true`, the package logs detailed info messages about each
+     * boot step (SQLite init, migrations, route registration, etc.).
+     * When `false` (the default), only warnings are logged.
+     *
+     * @default false
+     */
+    verbose?: boolean;
 }
 /**
  * Fully resolved configuration with all defaults applied.
@@ -537,5 +547,7 @@ export interface ResolvedServerStatsConfig {
     devToolbar?: DevToolbarOptions;
     /** Optional access-control callback. */
     shouldShow?: (ctx: import('@adonisjs/core/http').HttpContext) => boolean;
+    /** Whether verbose informational logging is enabled. Always present after `defineConfig()`. */
+    verbose: boolean;
 }
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAEjD;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAMnD;;;;;;;;;GASG;AACH,MAAM,WAAW,WAAW;IAG1B,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAA;IAEnB,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAA;IAEd,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAA;IAEnB,0DAA0D;IAC1D,YAAY,EAAE,MAAM,CAAA;IAEpB;;;;;OAKG;IACH,MAAM,EAAE,MAAM,CAAA;IAEd;;;;;OAKG;IACH,UAAU,EAAE,MAAM,CAAA;IAElB;;;;;;;;;;;OAWG;IACH,YAAY,EAAE,MAAM,CAAA;IAEpB,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAA;IAIjB;;;;;OAKG;IACH,iBAAiB,EAAE,MAAM,CAAA;IAEzB;;;;;;;;OAQG;IACH,iBAAiB,EAAE,MAAM,CAAA;IAEzB;;;;;;;;;;OAUG;IACH,SAAS,EAAE,MAAM,CAAA;IAEjB,iDAAiD;IACjD,qBAAqB,EAAE,MAAM,CAAA;IAI7B,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAA;IAElB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAA;IAElB,iEAAiE;IACjE,aAAa,EAAE,MAAM,CAAA;IAErB,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAA;IAIjB,sDAAsD;IACtD,OAAO,EAAE,OAAO,CAAA;IAEhB,kDAAkD;IAClD,iBAAiB,EAAE,MAAM,CAAA;IAEzB,sDAAsD;IACtD,qBAAqB,EAAE,MAAM,CAAA;IAE7B,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAA;IAEtB;;;;;;;;;;OAUG;IACH,YAAY,EAAE,MAAM,CAAA;IAIpB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAA;IAEnB,0DAA0D;IAC1D,YAAY,EAAE,MAAM,CAAA;IAEpB,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAA;IAEpB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAA;IAEnB,gEAAgE;IAChE,gBAAgB,EAAE,MAAM,CAAA;IAIxB,8CAA8C;IAC9C,eAAe,EAAE,MAAM,CAAA;IAEvB,+CAA+C;IAC/C,eAAe,EAAE,MAAM,CAAA;IAEvB,gDAAgD;IAChD,gBAAgB,EAAE,MAAM,CAAA;IAExB,iDAAiD;IACjD,mBAAmB,EAAE,MAAM,CAAA;IAE3B,gDAAgD;IAChD,kBAAkB,EAAE,MAAM,CAAA;IAE1B,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAA;IAIpB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAA;IAEnB,wDAAwD;IACxD,eAAe,EAAE,MAAM,CAAA;IAEvB,0DAA0D;IAC1D,aAAa,EAAE,MAAM,CAAA;IAIrB,uEAAuE;IACvE,eAAe,EAAE,MAAM,CAAA;IAEvB,0DAA0D;IAC1D,iBAAiB,EAAE,MAAM,CAAA;IAEzB,4DAA4D;IAC5D,gBAAgB,EAAE,MAAM,CAAA;IAExB,gEAAgE;IAChE,mBAAmB,EAAE,MAAM,CAAA;CAC5B;AAMD;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,qEAAqE;IACrE,YAAY,EAAE,MAAM,CAAA;IAEpB,mDAAmD;IACnD,cAAc,EAAE,MAAM,CAAA;IAEtB,gDAAgD;IAChD,aAAa,EAAE,MAAM,CAAA;IAErB,oDAAoD;IACpD,gBAAgB,EAAE,MAAM,CAAA;CACzB;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,iBAAiB;IAChC,2DAA2D;IAC3D,OAAO,EAAE,OAAO,CAAA;IAEhB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAE7B;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,SAAS,EAAE,CAAA;IAEnB;;;;;;;;;OASG;IACH,gBAAgB,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;IAEnC;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IAEnB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;;;;;;;;;;;;;;;OAgBG;IACH,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAA;IAE7B;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAA;CAC5B;AAMD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,KAAK,CAAC,EAAE,SAAS,EAAE,CAAA;IACnB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAA;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAA;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAMD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;;;;OASG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;;;;;;;;;OAUG;IACH,SAAS,CAAC,EAAE,UAAU,GAAG,MAAM,CAAA;IAE/B;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IAEzB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,eAAe,EAAE,CAAA;IAEvC;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IAEpB;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,KAAK,IAAI,CAAA;IAE/C;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,iBAAiB,CAAA;IAE9B;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,qBAAqB,EAAE,WAAW,KAAK,OAAO,CAAA;IAMxE,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,gDAAgD;IAChD,aAAa,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IAC9B,kDAAkD;IAClD,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,qBAAqB,EAAE,WAAW,KAAK,OAAO,CAAA;IACvE,8EAA8E;IAC9E,OAAO,CAAC,EAAE,OAAO,GAAG,aAAa,CAAA;IACjC,qGAAqG;IACrG,SAAS,CAAC,EAAE,OAAO,GAAG,eAAe,CAAA;IACrC,wBAAwB;IACxB,QAAQ,CAAC,EAAE,cAAc,CAAA;IAEzB;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB;IACxC,kFAAkF;IAClF,UAAU,EAAE,MAAM,CAAA;IAElB,6DAA6D;IAC7D,SAAS,EAAE,UAAU,GAAG,MAAM,CAAA;IAE9B,oEAAoE;IACpE,WAAW,EAAE,MAAM,CAAA;IAEnB,uFAAuF;IACvF,QAAQ,EAAE,MAAM,GAAG,KAAK,CAAA;IAExB,2EAA2E;IAC3E,UAAU,EAAE,MAAM,GAAG,eAAe,EAAE,CAAA;IAEtC,8FAA8F;IAC9F,UAAU,EAAE,OAAO,CAAA;IAEnB,kCAAkC;IAClC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,KAAK,IAAI,CAAA;IAE/C,0CAA0C;IAC1C,UAAU,CAAC,EAAE,iBAAiB,CAAA;IAE9B,wCAAwC;IACxC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,qBAAqB,EAAE,WAAW,KAAK,OAAO,CAAA;IAExE,+FAA+F;IAC/F,OAAO,EAAE,OAAO,CAAA;CACjB"}

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

@@ -2,16 +2,18 @@ export declare const dim: (s: string) => string;
 export declare const bold: (s: string) => string;
 export declare const green: (s: string) => string;
 export declare const yellow: (s: string) => string;
+/** Enable or disable verbose informational logging. */
+export declare function setVerbose(enabled: boolean): void;
 export declare const log: {
-    /** Tagged info message. */
+    /** Tagged info message. Only logs when verbose mode is enabled. */
     info(message: string): void;
-    /** Tagged warning (yellow). */
+    /** Tagged warning (yellow). Always logs regardless of verbose setting. */
     warn(message: string): void;
-    /** Tagged info with a blank line before. */
+    /** Tagged info with a blank line before. Only logs when verbose mode is enabled. */
     section(message: string): void;
-    /** Bulleted list under a section heading. */
+    /** Bulleted list under a section heading. Only logs when verbose mode is enabled. */
     list(heading: string, items: string[]): void;
-    /** Multi-line block (for code examples, hints, etc). */
+    /** Multi-line block (for code examples, hints, etc). Only logs when verbose mode is enabled. */
     block(heading: string, lines: string[]): void;
 };
 //# sourceMappingURL=logger.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,GAAG,GAAI,GAAG,MAAM,WAAyB,CAAA;AACtD,eAAO,MAAM,IAAI,GAAI,GAAG,MAAM,WAAyB,CAAA;AACvD,eAAO,MAAM,KAAK,GAAI,GAAG,MAAM,WAA0B,CAAA;AACzD,eAAO,MAAM,MAAM,GAAI,GAAG,MAAM,WAA0B,CAAA;AAE1D,eAAO,MAAM,GAAG;IACd,2BAA2B;kBACb,MAAM;IAIpB,+BAA+B;kBACjB,MAAM;IAIpB,4CAA4C;qBAC3B,MAAM;IAIvB,6CAA6C;kBAC/B,MAAM,SAAS,MAAM,EAAE;IAMrC,wDAAwD;mBACzC,MAAM,SAAS,MAAM,EAAE;CAGvC,CAAA"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,GAAG,GAAI,GAAG,MAAM,WAAyB,CAAA;AACtD,eAAO,MAAM,IAAI,GAAI,GAAG,MAAM,WAAyB,CAAA;AACvD,eAAO,MAAM,KAAK,GAAI,GAAG,MAAM,WAA0B,CAAA;AACzD,eAAO,MAAM,MAAM,GAAI,GAAG,MAAM,WAA0B,CAAA;AAa1D,uDAAuD;AACvD,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,QAE1C;AAED,eAAO,MAAM,GAAG;IACd,mEAAmE;kBACrD,MAAM;IAKpB,0EAA0E;kBAC5D,MAAM;IAIpB,oFAAoF;qBACnE,MAAM;IAKvB,qFAAqF;kBACvE,MAAM,SAAS,MAAM,EAAE;IAOrC,gGAAgG;mBACjF,MAAM,SAAS,MAAM,EAAE;CAIvC,CAAA"}

package/dist/src/utils/logger.js

@@ -3,25 +3,47 @@ export const dim = (s) => `\x1b[2m${s}\x1b[0m`;
 export const bold = (s) => `\x1b[1m${s}\x1b[0m`;
 export const green = (s) => `\x1b[32m${s}\x1b[0m`;
 export const yellow = (s) => `\x1b[33m${s}\x1b[0m`;
+/**
+ * Whether verbose (informational) log output is enabled.
+ *
+ * When `false` (the default), `log.info`, `log.section`, `log.list`, and
+ * `log.block` are no-ops. `log.warn` always logs regardless of this flag.
+ *
+ * Call {@link setVerbose} to change this at runtime (typically once during
+ * provider boot, based on the user's `verbose` config option).
+ */
+let verbose = false;
+/** Enable or disable verbose informational logging. */
+export function setVerbose(enabled) {
+    verbose = enabled;
+}
 export const log = {
-    /** Tagged info message. */
+    /** Tagged info message. Only logs when verbose mode is enabled. */
     info(message) {
+        if (!verbose)
+            return;
         console.log(`${TAG} ${message}`);
     },
-    /** Tagged warning (yellow). */
+    /** Tagged warning (yellow). Always logs regardless of verbose setting. */
     warn(message) {
         console.warn(`${TAG} ${yellow(message)}`);
     },
-    /** Tagged info with a blank line before. */
+    /** Tagged info with a blank line before. Only logs when verbose mode is enabled. */
     section(message) {
+        if (!verbose)
+            return;
         console.log(`\n${TAG} ${message}`);
     },
-    /** Bulleted list under a section heading. */
+    /** Bulleted list under a section heading. Only logs when verbose mode is enabled. */
     list(heading, items) {
+        if (!verbose)
+            return;
         console.log(`\n${TAG} ${heading}\n` + items.map((item) => `  ${dim('→')} ${bold(item)}`).join('\n'));
     },
-    /** Multi-line block (for code examples, hints, etc). */
+    /** Multi-line block (for code examples, hints, etc). Only logs when verbose mode is enabled. */
     block(heading, lines) {
+        if (!verbose)
+            return;
         console.log(`\n${TAG} ${heading}\n` + lines.map((l) => `  ${l}`).join('\n'));
     },
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "adonisjs-server-stats",
-  "version": "1.6.2",
+  "version": "1.6.11",
   "description": "Real-time server monitoring for AdonisJS v6 applications",
   "keywords": [
     "adonisjs",
@@ -119,6 +119,7 @@
     "lint:fix": "oxlint --fix src/ configure.ts vite.config.*.ts vite-plugins/ --ignore-pattern 'src/edge/client/**' --ignore-pattern 'src/edge/client-vue/**'",
     "format": "oxfmt src/ configure.ts vite.config.*.ts vite-plugins/",
     "format:check": "oxfmt --check src/ configure.ts vite.config.*.ts vite-plugins/",
+    "test": "node --import tsx bin/test.ts",
     "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
@@ -126,6 +127,8 @@
     "@adonisjs/lucid": "^21.0.0",
     "@adonisjs/redis": "^9.0.0",
     "@adonisjs/transmit": "^1.0.0",
+    "@japa/assert": "^4.2.0",
+    "@japa/runner": "^5.3.0",
     "@julr/adonisjs-prometheus": "^1.4.0",
     "@preact/preset-vite": "^2.9.0",
     "@types/better-sqlite3": "^7.0.0",
@@ -142,6 +145,7 @@
     "preact": "^10.25.0",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
+    "tsx": "^4.21.0",
     "typescript": "^5.9.0",
     "vite": "^7.3.1",
     "vite-plugin-dts": "^4.5.4",
@@ -155,9 +159,9 @@
     "@adonisjs/transmit-client": "^1.0.0",
     "@julr/adonisjs-prometheus": "^1.4.0",
     "better-sqlite3": "^7.0.0 || ^11.0.0",
-    "knex": "^3.0.0",
     "bullmq": "^5.0.0",
     "edge.js": "^6.0.0",
+    "knex": "^3.0.0",
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0",
     "vue": "^3.3.0"