adonisjs-server-stats 1.11.7 → 1.12.1

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

@@ -0,0 +1,77 @@
+/**
+ * A node in a PostgreSQL EXPLAIN (JSON) plan tree.
+ */
+export interface PlanNode {
+    'Node Type'?: string;
+    'Relation Name'?: string;
+    Alias?: string;
+    'Index Name'?: string;
+    'Startup Cost'?: number | null;
+    'Total Cost'?: number | null;
+    'Plan Rows'?: number | null;
+    'Plan Width'?: number | null;
+    Filter?: string;
+    'Index Cond'?: string;
+    'Hash Cond'?: string;
+    'Join Type'?: string;
+    'Sort Key'?: string | string[];
+    Plans?: PlanNode[];
+    [key: string]: unknown;
+}
+/**
+ * A flattened plan node for iteration-based rendering (no recursion needed
+ * in the template layer).
+ */
+export interface FlatPlanNode {
+    /** Nesting depth (0 = root). */
+    depth: number;
+    /** Node type label (e.g. `"Seq Scan"`, `"Hash Join"`). */
+    nodeType: string;
+    /** Relation (table) name, if any. */
+    relationName: string;
+    /** Alias for the relation, if different from `relationName`. */
+    alias: string;
+    /** Index name used, if any. */
+    indexName: string;
+    /** Human-readable metric strings (cost, rows, width, filters, etc.). */
+    metrics: string[];
+    /** Whether this is the root node (depth === 0). */
+    isRoot: boolean;
+}
+/**
+ * Extract human-readable metric strings from a plan node.
+ *
+ * Produces entries like `"cost=0.00..1.23"`, `"rows=100"`, `"width=50"`,
+ * `"filter: ..."`, etc.
+ */
+export declare function formatPlanNodeMetrics(node: PlanNode): string[];
+/**
+ * Recursively flatten a plan tree into an array of {@link FlatPlanNode}
+ * objects that any framework can render with simple iteration.
+ *
+ * @param node  - The root (or current) plan node.
+ * @param depth - Current nesting depth (default `0`).
+ */
+export declare function flattenPlanTree(node: PlanNode, depth?: number): FlatPlanNode[];
+/**
+ * Check whether an EXPLAIN result has a nested `Plan` structure (JSON
+ * format) as opposed to plain tabular rows.
+ *
+ * @param data - The first element of the EXPLAIN result array.
+ */
+export declare function hasNestedPlan(data: unknown): boolean;
+/**
+ * Extract column headers from plain (non-JSON) EXPLAIN rows.
+ *
+ * Returns the keys of the first row object, which serve as column headers
+ * for a simple table display.
+ *
+ * @param rows - Array of row objects from the EXPLAIN result.
+ */
+export declare function getExplainColumns(rows: Record<string, unknown>[]): string[];
+/**
+ * Format a cell value for display in an EXPLAIN result table.
+ *
+ * Returns `'-'` for `null` / `undefined` values.
+ */
+export declare function formatCellValue(value: unknown): string;

package/dist/core/index.d.ts

@@ -28,8 +28,14 @@ export { DebugDataController } from './debug-data-controller.js';
 export type { DebugDataControllerConfig, DebugDataControllerCallbacks, } from './debug-data-controller.js';
 export { LOG_LEVELS, resolveLogLevel, resolveLogMessage, resolveLogTimestamp, resolveLogRequestId, getLogLevelCssClass, filterLogsByLevel, getStructuredData, } from './log-utils.js';
 export type { LogEntry } from './log-utils.js';
-export { filterQueries, countDuplicateQueries, computeQuerySummary } from './query-utils.js';
-export type { QuerySummary } from './query-utils.js';
+export { filterQueries, countDuplicateQueries, computeQuerySummary, computeDashboardQuerySummary, normalizeDashboardQuery, buildSqlCounts, } from './query-utils.js';
+export type { QuerySummary, NormalizedQuery } from './query-utils.js';
+export { formatPlanNodeMetrics, flattenPlanTree, hasNestedPlan, getExplainColumns, formatCellValue, } from './explain-utils.js';
+export type { PlanNode, FlatPlanNode } from './explain-utils.js';
+export { getDebugPaneColumns, getDashboardListColumns, getDashboardGroupedColumns, } from './queries-columns.js';
+export type { QueriesColumnDef } from './queries-columns.js';
+export { QueriesController } from './queries-controller.js';
+export type { QueriesControllerState, ExplainResult, ExplainEntry, } from './queries-controller.js';
 export { JOB_STATUS_FILTERS, getJobStatusCssClass, getJobStatusBadgeColor, extractJobs, extractJobStats, } from './job-utils.js';
 export type { JobStatusFilter } from './job-utils.js';
 export { parseTraceSpans, parseTraceWarnings, resolveTraceField, normalizeTraceFields, } from './trace-utils.js';