adonisjs-server-stats 1.10.3 → 1.11.0

package/dist/core/field-resolvers.d.ts

@@ -0,0 +1,64 @@
+type Row = Record<string, unknown>;
+/**
+ * Resolve a field value from a row, trying multiple candidate key names.
+ * Returns the first truthy value found, or the fallback.
+ */
+export declare function resolveField<T>(row: Row, ...keys: string[]): T | undefined;
+/**
+ * Resolve a timestamp field. Tries `createdAt`, `created_at`, `timestamp`.
+ */
+export declare function resolveTimestamp(row: Row): string | number | undefined;
+/**
+ * Resolve a timestamp for jobs. Tries `timestamp`, `createdAt`, `processedAt`, `created_at`.
+ */
+export declare function resolveJobTimestamp(row: Row): string | number | undefined;
+/**
+ * Resolve HTTP status code. Tries `statusCode`, `status_code`.
+ */
+export declare function resolveStatusCode(row: Row): number | undefined;
+/**
+ * Resolve request duration. Tries `total_duration`, `totalDuration`, `duration`.
+ */
+export declare function resolveDuration(row: Row): number;
+/**
+ * Resolve span count. Tries `span_count`, `spanCount`.
+ */
+export declare function resolveSpanCount(row: Row): number;
+/**
+ * Resolve warning count. Tries `warning_count`, `warningCount`.
+ */
+export declare function resolveWarningCount(row: Row): number;
+/**
+ * Resolve email "from" address. Tries `from_addr`, `from`.
+ */
+export declare function resolveFromAddr(row: Row): string;
+/**
+ * Resolve email "to" address. Tries `to_addr`, `to`.
+ */
+export declare function resolveToAddr(row: Row): string;
+/**
+ * Resolve email CC address. Tries `cc`, `cc_addr`.
+ */
+export declare function resolveCcAddr(row: Row): string;
+/**
+ * Resolve attachment count. Tries `attachment_count`, `attachmentCount`.
+ */
+export declare function resolveAttachmentCount(row: Row): number;
+/**
+ * Resolve event name. Tries `event_name`, `eventName`, `event`.
+ */
+export declare function resolveEventName(row: Row): string;
+/**
+ * Resolve SQL method. Tries `method`, `sql_method`.
+ */
+export declare function resolveSqlMethod(row: Row): string;
+/**
+ * Resolve normalized SQL text. Tries `sqlNormalized`, `normalizedSql`, `sql_normalized`, `sql`.
+ */
+export declare function resolveNormalizedSql(row: Row): string;
+/**
+ * Resolve overview metric with snake_case fallback. Returns the camelCase
+ * value if present, otherwise converts the snake_case raw value to a number.
+ */
+export declare function resolveMetric(metrics: Row, camelKey: string, snakeKey: string): number;
+export {};

package/dist/core/formatters.d.ts

@@ -144,6 +144,21 @@ export declare function statusColor(statusCode: number): ThresholdColor;
  * @param ms - Duration in milliseconds.
  */
 export declare function durationSeverity(ms: number): 'normal' | 'slow' | 'very-slow';
+/**
+ * Return a CSS severity class for a duration value.
+ *
+ * Combines {@link durationSeverity} with a CSS-prefix to produce the
+ * appropriate class name.  Returns an empty string for normal durations.
+ *
+ * Examples (with default prefix `'ss-dash'`):
+ * - `> 500ms` -> `'ss-dash-very-slow'`
+ * - `> 100ms` -> `'ss-dash-slow'`
+ * - Otherwise -> `''`
+ *
+ * @param ms     - Duration in milliseconds.
+ * @param prefix - CSS class prefix (default `'ss-dash'`).
+ */
+export declare function durationClassName(ms: number, prefix?: string): string;
 /**
  * Truncate a request ID to a short preview.
  *

package/dist/core/index.d.ts

@@ -6,7 +6,7 @@ export type { ServerStats, MetricValue, ServerStatsConfig, ResolvedServerStatsCo
 export { getTheme, setTheme, toggleTheme, onThemeChange } from './theme.js';
 export { generateSparklinePoints, generateSparklinePath, generateGradientId, computeStats, buildSparklineData, } from './sparkline.js';
 export type { SparklineStats, SparklineData } from './sparkline.js';
-export { formatUptime, formatBytes, formatMb, formatCount, formatDuration, formatTime, timeAgo, formatStatNum, getThresholdColor, getThresholdColorInverse, getRatioColor, compactPreview, statusColor, durationSeverity, shortReqId, THRESHOLD_CSS_CLASS, THRESHOLD_HEX_FALLBACK, THRESHOLD_CSS_VAR, formatTtl, formatCacheSize, } from './formatters.js';
+export { formatUptime, formatBytes, formatMb, formatCount, formatDuration, formatTime, timeAgo, formatStatNum, getThresholdColor, getThresholdColorInverse, getRatioColor, compactPreview, statusColor, durationSeverity, durationClassName, shortReqId, THRESHOLD_CSS_CLASS, THRESHOLD_HEX_FALLBACK, THRESHOLD_CSS_VAR, formatTtl, formatCacheSize, } from './formatters.js';
 export { DEFAULT_PER_PAGE, buildQueryString, buildQueryParams, computePagination, parsePaginatedResponse, createPaginationState, createFilterState, createSortState, getPageNumbers, } from './pagination.js';
 export type { RawPaginatedResponse } from './pagination.js';
 export { fetchFeatures, detectFeatures, DEFAULT_FEATURES, getVisibleMetricGroups, detectMetricGroupsFromStats, } from './feature-detect.js';