adonisjs-server-stats 1.11.6 → 1.12.0

package/dist/core/queries-columns.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Describes a single column in a queries table.
+ */
+export interface QueriesColumnDef {
+    /** Field key used to look up the value from a row. */
+    key: string;
+    /** Header label displayed in the `<th>`. */
+    label: string;
+    /** Optional fixed width (CSS value). */
+    width?: string;
+    /** Whether the column supports click-to-sort. */
+    sortable?: boolean;
+    /**
+     * Semantic type hint that the rendering layer can use to pick the
+     * appropriate cell formatter / component.
+     */
+    type?: 'sql' | 'duration' | 'method' | 'model' | 'time' | 'index' | 'connection' | 'explain';
+}
+/**
+ * Return the 6 columns used in the debug-pane queries tab.
+ *
+ * Columns: #, SQL, Duration, Method, Model, Time.
+ */
+export declare function getDebugPaneColumns(): QueriesColumnDef[];
+/**
+ * Return the columns used in the dashboard list view.
+ *
+ * Columns: #, SQL, Duration, Method, Model, Connection, Time, and
+ * optionally an Explain button column.
+ *
+ * @param opts.showExplain - Whether to include the Explain button column
+ *                           (default `true`).
+ */
+export declare function getDashboardListColumns(opts?: {
+    showExplain?: boolean;
+}): QueriesColumnDef[];
+/**
+ * Return the columns used in the dashboard grouped view.
+ *
+ * Columns: SQL (Pattern), Count, Avg, Min, Max, Total, % Time.
+ */
+export declare function getDashboardGroupedColumns(): QueriesColumnDef[];

package/dist/core/queries-controller.d.ts

@@ -0,0 +1,94 @@
+import { PlanNode } from './explain-utils.js';
+/**
+ * Result of an EXPLAIN query.
+ */
+export interface ExplainResult {
+    /** Parsed plan nodes (JSON EXPLAIN format). */
+    plan?: PlanNode[];
+    /** Raw row objects (plain EXPLAIN format). */
+    rows?: Record<string, unknown>[];
+    /** Error message from the server. */
+    error?: string;
+    /** Additional message from the server. */
+    message?: string;
+}
+/**
+ * Per-query EXPLAIN loading / result state.
+ */
+export interface ExplainEntry {
+    loading: boolean;
+    result?: ExplainResult;
+    error?: string;
+}
+/**
+ * Complete state shape managed by {@link QueriesController}.
+ */
+export interface QueriesControllerState {
+    /** Current view mode: individual queries or grouped patterns. */
+    viewMode: 'list' | 'grouped';
+    /** Active sort column and direction. */
+    sort: {
+        key: string;
+        dir: 'asc' | 'desc';
+    };
+    /** Set of expanded row IDs (for SQL expand/collapse). */
+    expandedIds: Set<number | string>;
+    /** EXPLAIN state keyed by query ID. */
+    explainData: Map<number, ExplainEntry>;
+    /** Current search / filter string. */
+    search: string;
+}
+/**
+ * A framework-agnostic headless controller that manages pure state for
+ * the queries panel.
+ *
+ * Every mutation method returns the updated state object so that
+ * framework wrappers can trigger a re-render.
+ */
+export declare class QueriesController {
+    state: QueriesControllerState;
+    constructor(initialViewMode?: 'list' | 'grouped');
+    /**
+     * Switch between list and grouped view.
+     *
+     * Resets sort, expanded IDs, EXPLAIN data, and search.
+     */
+    setViewMode(mode: 'list' | 'grouped'): QueriesControllerState;
+    /**
+     * Toggle sort on a column. If the column is already sorted, flips
+     * direction; otherwise sorts descending on the new column.
+     */
+    toggleSort(key: string): QueriesControllerState;
+    /**
+     * Toggle the expanded state of a row by its ID.
+     */
+    toggleExpand(id: number | string): QueriesControllerState;
+    /**
+     * Check whether a row is currently expanded.
+     */
+    isExpanded(id: number | string): boolean;
+    /**
+     * Update the search string.
+     */
+    setSearch(search: string): QueriesControllerState;
+    /**
+     * Mark a query as loading its EXPLAIN plan.
+     */
+    startExplain(queryId: number): void;
+    /**
+     * Store a successful EXPLAIN result for a query.
+     */
+    completeExplain(queryId: number, result: ExplainResult): void;
+    /**
+     * Store an EXPLAIN error for a query.
+     */
+    failExplain(queryId: number, error: string): void;
+    /**
+     * Clear all EXPLAIN data.
+     */
+    clearExplain(): void;
+    /**
+     * Get the current EXPLAIN state for a specific query.
+     */
+    getExplainState(queryId: number): ExplainEntry | undefined;
+}

package/dist/core/query-utils.d.ts

@@ -12,6 +12,23 @@ export interface QuerySummary {
     /** Total number of queries considered. */
     totalCount: number;
 }
+/**
+ * A normalized query record with consistent camelCase field names.
+ *
+ * Used to convert untyped API responses (which may use snake_case) into
+ * a clean typed object.
+ */
+export interface NormalizedQuery {
+    id: number | string;
+    sql: string;
+    sqlNormalized: string;
+    duration: number;
+    method: string;
+    model: string;
+    connection: string;
+    timestamp: string | number;
+    inTransaction: boolean;
+}
 /**
  * Filter queries by a search term.
  *
@@ -32,3 +49,35 @@ export declare function countDuplicateQueries(queries: QueryRecord[]): Record<st
  * @param dupCounts – the duplicate-count map returned by {@link countDuplicateQueries}
  */
 export declare function computeQuerySummary(queries: QueryRecord[], dupCounts: Record<string, number>): QuerySummary;
+/**
+ * Compute summary statistics from untyped dashboard API query records.
+ *
+ * Uses field-resolvers to extract duration values from `Record<string, unknown>`
+ * rows, making it work with both snake_case and camelCase API responses.
+ *
+ * @param queries - Untyped query rows from the dashboard API.
+ * @param meta    - Optional pagination meta with the total count.
+ */
+export declare function computeDashboardQuerySummary(queries: Record<string, unknown>[], meta?: {
+    total?: number;
+}): QuerySummary;
+/**
+ * Normalize an untyped dashboard API query row to a clean typed object.
+ *
+ * Handles both snake_case and camelCase field names using field-resolvers.
+ *
+ * @param row - An untyped row from the dashboard queries API.
+ */
+export declare function normalizeDashboardQuery(row: Record<string, unknown>): NormalizedQuery;
+/**
+ * Build a map counting how many times each SQL pattern appears.
+ *
+ * Works with both typed `QueryRecord[]` and untyped dashboard rows.
+ * Uses `sqlNormalized` (or `sql` as fallback) as the grouping key.
+ *
+ * @param queries - Array of query objects with at least `sqlNormalized` or `sql`.
+ */
+export declare function buildSqlCounts(queries: Array<{
+    sqlNormalized?: string;
+    sql?: string;
+} | Record<string, unknown>>): Map<string, number>;

package/dist/core/types-diagnostics.d.ts

@@ -69,6 +69,8 @@ export interface DiagnosticsResponse {
         available?: boolean;
         mode?: string;
     }>;
+    /** Lucid connections that have debug: true. Empty means no query events will be emitted. */
+    lucidDebugConnections?: string[];
     storage: {
         ready: boolean;
         dbPath: string;

package/dist/react/{CacheSection-BYN53kYO.js → CacheSection-DZFOiOYH.js}

@@ -1,7 +1,7 @@
 import { jsxs as o, jsx as t } from "react/jsx-runtime";
 import { useState as c, useCallback as k } from "react";
 import { formatCacheSize as x, formatTtl as D } from "adonisjs-server-stats/core";
-import { a as N, J as V } from "./index-DwDK-4oX.js";
+import { a as N, J as V } from "./index-CAUHa8QX.js";
 import { C as L } from "./CacheStatsBar-CRodCOeP.js";
 import { D as F } from "./DataTable-YyShr5B-.js";
 import { F as T } from "./FilterBar-CQ7bD669.js";

package/dist/react/{CacheTab-DOhuK05d.js → CacheTab-D8js5o69.js}

@@ -2,7 +2,7 @@ import { jsx as e, jsxs as t } from "react/jsx-runtime";
 import { useState as u, useMemo as T, useCallback as z } from "react";
 import { formatTtl as K, formatCacheSize as L } from "adonisjs-server-stats/core";
 import { u as R } from "./useDashboardApiBase-Bi36pJ2L.js";
-import { u as $, J as j } from "./index-DwDK-4oX.js";
+import { u as $, J as j } from "./index-CAUHa8QX.js";
 import { u as A } from "./useResizableTable-CNJmACdt.js";
 import { C as F } from "./CacheStatsBar-CRodCOeP.js";
 import { F as D } from "./FilterBar-CQ7bD669.js";

package/dist/react/{ConfigSection-B9EHh4Rp.js → ConfigSection-DoJmvNkF.js}

@@ -1,5 +1,5 @@
 import { jsx as t } from "react/jsx-runtime";
-import { a as i } from "./index-DwDK-4oX.js";
+import { a as i } from "./index-CAUHa8QX.js";
 import { C as n } from "./ConfigContent-CnsEI4j3.js";
 function m({ options: o = {} }) {
   const { data: a, isLoading: s } = i("config", o);

package/dist/react/{ConfigTab-C8kriE2b.js → ConfigTab-CDvljuBF.js}

@@ -1,6 +1,6 @@
 import { jsxs as i, jsx as n } from "react/jsx-runtime";
 import { u as f } from "./useDashboardApiBase-Bi36pJ2L.js";
-import { u as m } from "./index-DwDK-4oX.js";
+import { u as m } from "./index-CAUHa8QX.js";
 import { C as d } from "./ConfigContent-CnsEI4j3.js";
 function b({ options: r, dashboardPath: o }) {
   const { resolvedOptions: a } = f(o, r), { data: e, isLoading: t, error: s } = m("config", a);

package/dist/react/{CustomPaneTab-CvzQS_Wh.js → CustomPaneTab-Db9eIQ-9.js}

@@ -1,7 +1,7 @@
 import { jsxs as l, jsx as r } from "react/jsx-runtime";
 import { useState as w, useMemo as f } from "react";
 import { compactPreview as k, formatDuration as x, durationClassName as M } from "adonisjs-server-stats/core";
-import { u as L, B as A, M as B } from "./index-DwDK-4oX.js";
+import { u as L, B as A, M as B } from "./index-CAUHa8QX.js";
 import { T as b } from "./TimeAgoCell-o3KigGfM.js";
 import { u as D } from "./useResizableTable-CNJmACdt.js";
 import { F as P } from "./FilterBar-CQ7bD669.js";

package/dist/react/{EmailsSection-BJyFJf7A.js → EmailsSection-D7oxvAjA.js}

@@ -2,7 +2,7 @@ import { jsx as s, jsxs as y, Fragment as P } from "react/jsx-runtime";
 import { useState as l, useEffect as T, useCallback as j } from "react";
 import { resolveCcAddr as N, resolveToAddr as f, resolveFromAddr as b, resolveAttachmentCount as F, resolveTimestamp as _ } from "adonisjs-server-stats/core";
 import { T as $ } from "./TimeAgoCell-o3KigGfM.js";
-import { a as D } from "./index-DwDK-4oX.js";
+import { a as D } from "./index-CAUHa8QX.js";
 import { D as E } from "./DataTable-YyShr5B-.js";
 import { F as O } from "./FilterBar-CQ7bD669.js";
 import { E as B } from "./EmailPreviewOverlay-BmXOAvqG.js";

package/dist/react/{EmailsTab-Ch8jp10B.js → EmailsTab-BITuGTQm.js}

@@ -2,7 +2,7 @@ import { jsx as e, jsxs as r } from "react/jsx-runtime";
 import { useState as c, useMemo as f, useCallback as w } from "react";
 import { resolveTimestamp as k } from "adonisjs-server-stats/core";
 import { T as E } from "./TimeAgoCell-o3KigGfM.js";
-import { u as S } from "./index-DwDK-4oX.js";
+import { u as S } from "./index-CAUHa8QX.js";
 import { u as j } from "./useResizableTable-CNJmACdt.js";
 import { F as q } from "./FilterBar-CQ7bD669.js";
 import { E as $ } from "./EmailPreviewOverlay-BmXOAvqG.js";

package/dist/react/{EventsSection-DJPwHeT8.js → EventsSection-7mDZv70I.js}

@@ -2,7 +2,7 @@ import { jsxs as i, jsx as e, Fragment as g } from "react/jsx-runtime";
 import { useState as m, useEffect as f } from "react";
 import { resolveEventName as y, resolveTimestamp as u } from "adonisjs-server-stats/core";
 import { T as w } from "./TimeAgoCell-o3KigGfM.js";
-import { a as b, J as N } from "./index-DwDK-4oX.js";
+import { a as b, J as N } from "./index-CAUHa8QX.js";
 import { D as x } from "./DataTable-YyShr5B-.js";
 import { F as P } from "./FilterBar-CQ7bD669.js";
 import { P as k } from "./Pagination-BkmzUDY8.js";

package/dist/react/{EventsTab-B-FoehXC.js → EventsTab-DF13BChE.js}

@@ -2,7 +2,7 @@ import { jsx as e, jsxs as t } from "react/jsx-runtime";
 import { useState as p, useMemo as u } from "react";
 import { resolveTimestamp as g } from "adonisjs-server-stats/core";
 import { T as b } from "./TimeAgoCell-o3KigGfM.js";
-import { u as f, J as v } from "./index-DwDK-4oX.js";
+import { u as f, J as v } from "./index-CAUHa8QX.js";
 import { u as w } from "./useResizableTable-CNJmACdt.js";
 import { F as y } from "./FilterBar-CQ7bD669.js";
 function E({ options: c }) {