adonisjs-server-stats 1.5.4 → 1.6.2

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

@@ -0,0 +1,71 @@
+/**
+ * Check whether a configuration key name likely contains a secret value.
+ *
+ * Matches common patterns like `password`, `secret`, `token`, `key`,
+ * `credential`, and `auth` (case-insensitive substring match).
+ */
+export declare function isSecretKey(key: string): boolean;
+/**
+ * Format a configuration value for display.
+ *
+ * - `null`/`undefined` -> `'-'`
+ * - Primitives -> `String(value)`
+ * - Arrays -> comma-joined or `'-'` if empty
+ * - Objects -> JSON stringified
+ */
+export declare function formatConfigVal(val: unknown): string;
+/**
+ * Human-readable display names for internal timer keys.
+ */
+export declare const TIMER_LABELS: Record<string, string>;
+/**
+ * Get a human-readable label for a timer key.
+ * Falls back to the raw key name if no label is defined.
+ */
+export declare function getTimerLabel(name: string): string;
+/**
+ * Human-readable display names for integration keys.
+ */
+export declare const INTEGRATION_LABELS: Record<string, string>;
+/**
+ * Get a human-readable label for an integration key.
+ * Falls back to the raw key name if no label is defined.
+ */
+export declare function getIntegrationLabel(name: string): string;
+/**
+ * Determine the display status string for an integration entry.
+ */
+export declare function getIntegrationStatus(info: {
+    active?: boolean;
+    available?: boolean;
+}): string;
+/**
+ * Determine the detail description for an integration entry.
+ */
+export declare function getIntegrationDetails(key: string, info: {
+    active?: boolean;
+    available?: boolean;
+    mode?: string;
+}): string;
+/**
+ * Format a collector's config object into a display-friendly array.
+ */
+export declare function formatCollectorConfig(config: Record<string, unknown>): Array<{
+    key: string;
+    value: string;
+    secret: boolean;
+}>;
+/**
+ * Compute the fill percentage of a buffer (0-100, clamped).
+ */
+export declare function fillPercent(current: number, max: number): number;
+/** Status strings that map to an "ok" visual indicator. */
+export declare const OK_STATUSES: string[];
+/** Status strings that map to an "error" visual indicator. */
+export declare const ERROR_STATUSES: string[];
+/**
+ * Classify a status string as 'ok', 'err', or neutral.
+ * Useful for mapping to CSS classes like `prefix-dot-ok` / `prefix-dot-err`.
+ */
+export declare function classifyStatus(status: string): 'ok' | 'err' | '';
+//# sourceMappingURL=internals-utils.d.ts.map

package/dist/core/internals-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internals-utils.d.ts","sourceRoot":"","sources":["../../src/core/internals-utils.ts"],"names":[],"mappings":"AAcA;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAGhD;AAMD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAUpD;AAMD;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAM/C,CAAA;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAMD;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMrD,CAAA;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD;AAMD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAI5F;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7D,MAAM,CAQR;AAMD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,CAMxD;AAMD;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAGhE;AAMD,2DAA2D;AAC3D,eAAO,MAAM,WAAW,UAA2D,CAAA;AAEnF,8DAA8D;AAC9D,eAAO,MAAM,cAAc,UAA6B,CAAA;AAExD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,KAAK,GAAG,EAAE,CAIhE"}

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

@@ -0,0 +1,45 @@
+import { JobStats } from './types.js';
+/**
+ * Available job status filter values (including the "show all" option).
+ */
+export declare const JOB_STATUS_FILTERS: readonly ["all", "active", "waiting", "delayed", "completed", "failed"];
+/**
+ * A single job status value (without the 'all' meta-filter).
+ */
+export type JobStatusFilter = (typeof JOB_STATUS_FILTERS)[number];
+/**
+ * Return the CSS class for a given job status in the debug panel.
+ *
+ * @param status  The job status string (e.g. `'completed'`, `'failed'`).
+ * @param prefix  CSS class prefix. Defaults to `'ss-dbg-job-status'`.
+ * @returns       The full CSS class string, e.g. `'ss-dbg-job-status-completed'`.
+ *                Falls back to `'ss-dbg-badge-muted'` for unknown statuses.
+ */
+export declare function getJobStatusCssClass(status: string, prefix?: string): string;
+/**
+ * Map a job status to a badge color name used in the dashboard UI.
+ *
+ * @param status  The job status string (e.g. `'active'`, `'failed'`).
+ * @returns       A color name string (e.g. `'blue'`, `'red'`, `'muted'`).
+ */
+export declare function getJobStatusBadgeColor(status: string): string;
+/**
+ * Extract the jobs array from a server response.
+ *
+ * Handles the following shapes:
+ * - `{ jobs: [...] }` — standard shape
+ * - `{ data: [...] }` — alternative shape
+ * - `[...]` — bare array
+ * - `null` / `undefined` — returns empty array
+ */
+export declare function extractJobs(data: unknown): Record<string, unknown>[];
+/**
+ * Extract the job stats (overview) from a server response.
+ *
+ * Handles the following shapes:
+ * - `{ stats: { active, waiting, ... } }`
+ * - `{ overview: { active, waiting, ... } }`
+ * - Returns `null` when no stats are available.
+ */
+export declare function extractJobStats(data: unknown): JobStats | null;
+//# sourceMappingURL=job-utils.d.ts.map

package/dist/core/job-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-utils.d.ts","sourceRoot":"","sources":["../../src/core/job-utils.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAa,QAAQ,EAAE,MAAM,YAAY,CAAA;AAErD;;GAEG;AACH,eAAO,MAAM,kBAAkB,yEAOrB,CAAA;AAEV;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAA;AAMjE;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,SAAsB,GAAG,MAAM,CAWzF;AAMD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAe7D;AAqBD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAKpE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,IAAI,CAI9D"}

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

@@ -0,0 +1,34 @@
+/**
+ * Generic log entry – the resolver functions only rely on dynamic property
+ * access, so a simple index-signature is sufficient.
+ */
+export interface LogEntry {
+    [key: string]: unknown;
+}
+/**
+ * Available log level filter values (including the "show all" option).
+ */
+export declare const LOG_LEVELS: readonly ["all", "error", "warn", "info", "debug"];
+/** Resolve the log level string from whichever field the backend provides. */
+export declare function resolveLogLevel(entry: LogEntry): string;
+/** Resolve the message from whichever field the backend provides. */
+export declare function resolveLogMessage(entry: LogEntry): string;
+/** Resolve the timestamp from whichever field the backend provides. */
+export declare function resolveLogTimestamp(entry: LogEntry): number | string;
+/** Resolve the request ID from whichever field the backend provides. */
+export declare function resolveLogRequestId(entry: LogEntry): string;
+/**
+ * Return the CSS class for a given log level.
+ *
+ * @param level  The resolved log level string (e.g. `'error'`, `'warn'`).
+ * @param prefix CSS class prefix. Defaults to `'ss-dbg-log-level'`.
+ */
+export declare function getLogLevelCssClass(level: string, prefix?: string): string;
+/**
+ * Filter an array of log entries by level.
+ *
+ * When `level` is `'all'` the original array is returned as-is.
+ * The `'error'` filter also includes `'fatal'` entries (matching React behaviour).
+ */
+export declare function filterLogsByLevel(logs: LogEntry[], level: string): LogEntry[];
+//# sourceMappingURL=log-utils.d.ts.map

package/dist/core/log-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-utils.d.ts","sourceRoot":"","sources":["../../src/core/log-utils.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,oDAAqD,CAAA;AAM5E,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAOvD;AAED,qEAAqE;AACrE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAEzD;AAED,uEAAuE;AACvE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAQpE;AAED,wEAAwE;AACxE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAW3D;AAMD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,SAAqB,GAAG,MAAM,CAgBtF;AAMD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,EAAE,CAO7E"}

package/dist/core/metrics.d.ts

@@ -0,0 +1,41 @@
+import { MetricDefinition } from './types.js';
+export type { MetricDefinition } from './types.js';
+/**
+ * All metric definitions in display order.
+ *
+ * Components iterate over this array to render each metric card.
+ * Metrics with a `show` predicate are conditionally hidden when
+ * the predicate returns `false` for the current stats snapshot.
+ */
+export declare const METRIC_DEFINITIONS: MetricDefinition[];
+/**
+ * Look up a metric definition by its ID.
+ *
+ * @param id - Metric identifier (e.g. `'cpu'`, `'memory'`).
+ * @returns The matching definition, or `undefined` if not found.
+ */
+export declare function getMetricById(id: string): MetricDefinition | undefined;
+/**
+ * Group metric definitions by their `group` field.
+ *
+ * Returns a `Map` where keys are group names and values are
+ * arrays of metrics in that group. Metrics without an explicit
+ * `group` default to `'core'`.
+ *
+ * The map iteration order matches first-seen order of groups
+ * in {@link METRIC_DEFINITIONS}.
+ *
+ * @returns A map of group name to metric definitions.
+ */
+export declare function getMetricsByGroup(): Map<string, MetricDefinition[]>;
+/**
+ * Maximum number of data points to keep in the sparkline history
+ * buffer per metric. Matches the Edge implementation.
+ */
+export declare const MAX_HISTORY = 60;
+/**
+ * Milliseconds after the last successful update before the connection
+ * is considered stale (amber dot indicator).
+ */
+export declare const STALE_MS = 10000;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/core/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/core/metrics.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,YAAY,CAAA;AAClE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAiBlD;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,EAAE,gBAAgB,EA4UhD,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAEtE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,IAAI,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAUnE;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,KAAK,CAAA;AAE7B;;;GAGG;AACH,eAAO,MAAM,QAAQ,QAAS,CAAA"}

package/dist/core/pagination.d.ts

@@ -0,0 +1,128 @@
+import { PaginationState, FilterState, SortState } from './types.js';
+/**
+ * Shape of a raw paginated API response before parsing.
+ */
+export interface RawPaginatedResponse {
+    data?: unknown[];
+    items?: unknown[];
+    total?: number;
+    page?: number;
+    perPage?: number;
+    limit?: number;
+    totalPages?: number;
+}
+/**
+ * Default number of items per page.
+ */
+export declare const DEFAULT_PER_PAGE = 50;
+/**
+ * Build a URL query string from pagination, filter, and sort state.
+ *
+ * @param pagination - Current pagination state.
+ * @param filters    - Optional filter state (search + key-value filters).
+ * @param sort       - Optional sort state.
+ * @returns A query string (without leading `?`), e.g. `"page=2&limit=50&search=foo"`.
+ */
+export declare function buildQueryString(pagination: Pick<PaginationState, 'page' | 'perPage'>, filters?: FilterState, sort?: SortState): string;
+/**
+ * Parse a paginated API response into typed data and pagination state.
+ *
+ * Expects the response to have the shape:
+ * ```json
+ * {
+ *   "data": [...],
+ *   "total": 100,
+ *   "page": 1,
+ *   "perPage": 50,
+ *   "totalPages": 2
+ * }
+ * ```
+ *
+ * Also supports the alternate shape used by some endpoints:
+ * ```json
+ * {
+ *   "items": [...],
+ *   "total": 100,
+ *   "page": 1
+ * }
+ * ```
+ *
+ * @param response - Raw API response object.
+ * @param perPage  - Items per page (used to compute `totalPages` if missing).
+ * @returns An object with `data` array and `pagination` state.
+ */
+export declare function parsePaginatedResponse<T>(response: RawPaginatedResponse, perPage?: number): {
+    data: T[];
+    pagination: PaginationState;
+};
+/**
+ * Create an initial pagination state.
+ *
+ * @param perPage - Items per page. Defaults to {@link DEFAULT_PER_PAGE}.
+ */
+export declare function createPaginationState(perPage?: number): PaginationState;
+/**
+ * Create an initial filter state.
+ */
+export declare function createFilterState(): FilterState;
+/**
+ * Create an initial sort state.
+ *
+ * @param field     - Default sort field.
+ * @param direction - Default sort direction.
+ */
+export declare function createSortState(field?: string, direction?: 'asc' | 'desc'): SortState;
+/**
+ * Build a URL query parameter string from dashboard hook options.
+ *
+ * Accepts the flat options shape used by React/Vue hooks and converts
+ * it to a query string compatible with the dashboard API.
+ *
+ * @param options - Dashboard hook options (page, perPage, search, sort, etc.).
+ * @returns A query string (without leading `?`).
+ */
+export declare function buildQueryParams(options: {
+    page?: number;
+    perPage?: number;
+    search?: string;
+    sort?: string;
+    sortDir?: 'asc' | 'desc';
+    filters?: Record<string, string>;
+    timeRange?: string;
+}): string;
+/**
+ * Computed pagination info for UI rendering.
+ *
+ * Provides `from`, `to`, `lastPage`, `hasPrev`, `hasNext` derived
+ * from the raw pagination state.
+ *
+ * @param state - Raw pagination state with page, perPage, total.
+ * @returns Computed pagination values.
+ */
+export declare function computePagination(state: {
+    page: number;
+    perPage: number;
+    total: number;
+}): {
+    page: number;
+    perPage: number;
+    total: number;
+    lastPage: number;
+    from: number;
+    to: number;
+    hasPrev: boolean;
+    hasNext: boolean;
+};
+/**
+ * Generate an array of page numbers (and ellipsis markers) for pagination UI.
+ *
+ * Always shows the first page, last page, and a window of pages around
+ * the current page. Gaps are represented by `'...'`.
+ *
+ * @param currentPage - The current page number (1-based).
+ * @param lastPage    - The total number of pages.
+ * @param window      - Number of pages to show on each side of current. Defaults to 2.
+ * @returns An array of page numbers and `'...'` markers.
+ */
+export declare function getPageNumbers(currentPage: number, lastPage: number, window?: number): (number | '...')[];
+//# sourceMappingURL=pagination.d.ts.map

package/dist/core/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/core/pagination.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAEzE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAA;IAChB,KAAK,CAAC,EAAE,OAAO,EAAE,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,KAAK,CAAA;AAElC;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC,EACrD,OAAO,CAAC,EAAE,WAAW,EACrB,IAAI,CAAC,EAAE,SAAS,GACf,MAAM,CAuBR;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EACtC,QAAQ,EAAE,oBAAoB,EAC9B,OAAO,GAAE,MAAyB,GACjC;IAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAAC,UAAU,EAAE,eAAe,CAAA;CAAE,CAgB5C;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,MAAyB,GAAG,eAAe,CAOzF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,WAAW,CAK/C;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,KAAK,GAAE,MAAa,EACpB,SAAS,GAAE,KAAK,GAAG,MAAe,GACjC,SAAS,CAEX;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IACxC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,GAAG,MAAM,CAkBT;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAC1F,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;CACjB,CAgBA;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,MAAU,GACjB,CAAC,MAAM,GAAG,KAAK,CAAC,EAAE,CA+BpB"}

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

@@ -0,0 +1,35 @@
+import { QueryRecord } from './types.js';
+/**
+ * Summary statistics computed over a set of queries.
+ */
+export interface QuerySummary {
+    /** Number of queries whose duration exceeds 100 ms. */
+    slowCount: number;
+    /** Number of unique SQL strings that appear more than once. */
+    dupCount: number;
+    /** Mean duration across all queries (0 when there are none). */
+    avgDuration: number;
+    /** Total number of queries considered. */
+    totalCount: number;
+}
+/**
+ * Filter queries by a search term.
+ *
+ * Matches case-insensitively against the `sql`, `model`, and `method`
+ * fields.  Returns the full array when the search string is empty.
+ */
+export declare function filterQueries(queries: QueryRecord[], search: string): QueryRecord[];
+/**
+ * Count how many times each SQL string appears in the list.
+ *
+ * The returned record maps each SQL string to its occurrence count.
+ */
+export declare function countDuplicateQueries(queries: QueryRecord[]): Record<string, number>;
+/**
+ * Compute high-level summary statistics for a set of queries.
+ *
+ * @param queries   – the full (unfiltered) query list
+ * @param dupCounts – the duplicate-count map returned by {@link countDuplicateQueries}
+ */
+export declare function computeQuerySummary(queries: QueryRecord[], dupCounts: Record<string, number>): QuerySummary;
+//# sourceMappingURL=query-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query-utils.d.ts","sourceRoot":"","sources":["../../src/core/query-utils.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAA;IACjB,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAA;IAChB,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAA;IACnB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,CASnF;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMpF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,WAAW,EAAE,EACtB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,YAAY,CAMd"}

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

@@ -0,0 +1,18 @@
+/**
+ * Lightweight column-resize utility for HTML tables.
+ *
+ * Works with any `<table>` element — call `initResizableColumns(table)` after
+ * the table is rendered in the DOM. Each `<th>` gets a thin drag handle on its
+ * right edge; dragging switches the table to `table-layout: fixed` and sets
+ * explicit pixel widths so columns resize cleanly.
+ *
+ * Shared across Edge JS, React, and Vue frontends.
+ */
+/**
+ * Attach drag-to-resize handles to every `<th>` in a table.
+ *
+ * @param table - The `<table>` DOM element.
+ * @returns A cleanup function that removes all handles and listeners.
+ */
+export declare function initResizableColumns(table: HTMLTableElement): () => void;
+//# sourceMappingURL=resizable-columns.d.ts.map

package/dist/core/resizable-columns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resizable-columns.d.ts","sourceRoot":"","sources":["../../src/core/resizable-columns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,IAAI,CA8DxE"}

package/dist/core/routes.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Maps debug panel tab IDs to their API endpoint paths.
+ * The 'timeline' tab maps to '/traces' on the server.
+ */
+export declare const DEBUG_TAB_PATHS: Record<string, string>;
+export declare function getDebugTabPath(tab: string): string;
+/**
+ * Maps dashboard section IDs to their API endpoint paths.
+ */
+export declare const DASHBOARD_SECTION_PATHS: Record<string, string>;
+export declare function getDashboardSectionPath(section: string): string;
+//# sourceMappingURL=routes.d.ts.map

package/dist/core/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/core/routes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAWlD,CAAA;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAY1D,CAAA;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE/D"}

package/dist/core/server-stats-controller.d.ts

@@ -0,0 +1,106 @@
+import { ServerStats } from './types.js';
+/**
+ * Connection mode reflecting the current transport.
+ */
+export type ConnectionMode = 'live' | 'polling' | 'disconnected';
+/**
+ * Configuration for {@link ServerStatsController}.
+ */
+export interface ServerStatsControllerConfig {
+    /** Base URL for API calls. Defaults to `''` (same origin). */
+    baseUrl?: string;
+    /** Stats endpoint path. Defaults to `'/admin/api/server-stats'`. */
+    endpoint?: string;
+    /** Transmit channel name. Defaults to `'admin/server-stats'`. */
+    channelName?: string;
+    /** Optional auth token for Bearer auth. */
+    authToken?: string;
+    /** Polling interval fallback in ms. Defaults to `3000`. */
+    pollInterval?: number;
+    /** Called with every new stats snapshot. */
+    onStatsUpdate?: (stats: ServerStats) => void;
+    /** Called when the SSE connection state changes. */
+    onConnectionChange?: (connected: boolean) => void;
+    /** Called when stale detection changes. */
+    onStaleChange?: (stale: boolean) => void;
+    /** Called when an error occurs. */
+    onError?: (error: Error | null) => void;
+    /** Called when the unauthorized state changes. */
+    onUnauthorizedChange?: (unauthorized: boolean) => void;
+    /** Called when the history buffer changes (new data pushed). */
+    onHistoryChange?: (history: Record<string, number[]>) => void;
+    /** Called when the SSE active state changes (separate from isConnected). */
+    onSseActiveChange?: (active: boolean) => void;
+    /** Called when the poll timer state changes (running or not). */
+    onPollActiveChange?: (active: boolean) => void;
+}
+/**
+ * Framework-agnostic controller that owns the entire SSE subscription +
+ * polling fallback lifecycle for server stats.
+ *
+ * React and Vue hooks create a thin wrapper around this class, bridging
+ * the callbacks to their respective reactivity primitives.
+ */
+export declare class ServerStatsController {
+    private readonly baseUrl;
+    private readonly endpoint;
+    private readonly channelName;
+    private readonly authToken;
+    private readonly pollInterval;
+    private readonly onStatsUpdate;
+    private readonly onConnectionChange;
+    private readonly onStaleChange;
+    private readonly onError;
+    private readonly onUnauthorizedChange;
+    private readonly onHistoryChange;
+    private readonly onSseActiveChange;
+    private readonly onPollActiveChange;
+    private readonly historyBuffer;
+    private client;
+    private sseHandle;
+    private pollTimer;
+    private staleTimer;
+    private lastSuccess;
+    private unauthorized;
+    private sseActive;
+    private isConnected;
+    private isStale;
+    constructor(config?: ServerStatsControllerConfig);
+    /**
+     * Start the SSE subscription + polling lifecycle.
+     *
+     * Safe to call multiple times (subsequent calls are no-ops).
+     */
+    start(): void;
+    /**
+     * Stop all timers and subscriptions. Call on unmount.
+     */
+    stop(): void;
+    /**
+     * Get the history array for a single metric key.
+     */
+    getHistory(key: string): number[];
+    /**
+     * Get the entire history map (all keys).
+     */
+    getAllHistory(): Record<string, number[]>;
+    /**
+     * Get the current connection mode.
+     */
+    getConnectionMode(): ConnectionMode;
+    /** Process incoming stats data from either SSE or polling. */
+    private processStats;
+    /** Poll the HTTP endpoint once. */
+    private poll;
+    /** Start the poll interval timer. */
+    private startPollInterval;
+    /** Stop the poll interval timer. */
+    private stopPolling;
+    /** Update SSE active state and notify. */
+    private setSseActive;
+    /** Update connected state and notify. */
+    private setConnected;
+    /** Update stale state and notify. */
+    private setStale;
+}
+//# sourceMappingURL=server-stats-controller.d.ts.map

package/dist/core/server-stats-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-stats-controller.d.ts","sourceRoot":"","sources":["../../src/core/server-stats-controller.ts"],"names":[],"mappings":"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"}

package/dist/core/sparkline.d.ts

@@ -0,0 +1,80 @@
+import { SparklineOptions } from './types.js';
+/**
+ * Generate an SVG polyline `points` attribute string from an array of values.
+ *
+ * The values are scaled to fit within the specified dimensions,
+ * normalizing against the min/max range of the data.
+ *
+ * @param values - Array of numeric data points (at least 2 required).
+ * @param width  - SVG viewBox width.
+ * @param height - SVG viewBox height.
+ * @param padding - Inner padding in pixels.
+ * @returns The `points` attribute value for an SVG `<polyline>`, or `null` if insufficient data.
+ */
+export declare function generateSparklinePoints(values: number[], width?: number, height?: number, padding?: number): string | null;
+/**
+ * Generate an SVG `<path>` `d` attribute for the filled area under the sparkline.
+ *
+ * The area path traces the sparkline from left to right, then drops
+ * down to the bottom-right corner, across to the bottom-left corner,
+ * and closes — suitable for use with a gradient fill.
+ *
+ * @param values - Array of numeric data points (at least 2 required).
+ * @param width  - SVG viewBox width.
+ * @param height - SVG viewBox height.
+ * @param padding - Inner padding in pixels.
+ * @returns The `d` attribute value for an SVG `<path>`, or `null` if insufficient data.
+ */
+export declare function generateSparklinePath(values: number[], width?: number, height?: number, padding?: number): string | null;
+/**
+ * Generate a unique ID for an SVG gradient definition.
+ *
+ * IDs are unique within the lifetime of the page (monotonic counter).
+ * Safe to use for multiple sparklines rendered on the same page.
+ *
+ * @returns A string like `"ss-grad-0"`, `"ss-grad-1"`, etc.
+ */
+export declare function generateGradientId(): string;
+/**
+ * Reset the gradient counter (useful for tests).
+ */
+export declare function resetGradientCounter(): void;
+/**
+ * Computed statistics for a data series.
+ */
+export interface SparklineStats {
+    min: number;
+    max: number;
+    avg: number;
+}
+/**
+ * Compute min, max, and average for a numeric data series.
+ *
+ * @param values - Array of numeric data points.
+ * @returns Statistics object, or `null` if the array is empty.
+ */
+export declare function computeStats(values: number[]): SparklineStats | null;
+/**
+ * All data needed to render a sparkline SVG in a component.
+ */
+export interface SparklineData {
+    /** Polyline `points` attribute. */
+    points: string;
+    /** Filled area `path` `d` attribute. */
+    areaPath: string;
+    /** Unique gradient ID for this sparkline. */
+    gradientId: string;
+    /** Resolved rendering options. */
+    options: Required<SparklineOptions>;
+    /** Computed statistics (min/max/avg). */
+    stats: SparklineStats | null;
+}
+/**
+ * Build all sparkline rendering data in one call.
+ *
+ * @param values  - Array of numeric data points.
+ * @param options - Optional rendering overrides.
+ * @returns Full sparkline data bundle, or `null` if insufficient data.
+ */
+export declare function buildSparklineData(values: number[], options?: SparklineOptions): SparklineData | null;
+//# sourceMappingURL=sparkline.d.ts.map

package/dist/core/sparkline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sparkline.d.ts","sourceRoot":"","sources":["../../src/core/sparkline.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAsBlD;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EAAE,EAChB,KAAK,GAAE,MAAuB,EAC9B,MAAM,GAAE,MAAwB,EAChC,OAAO,GAAE,MAAyB,GACjC,MAAM,GAAG,IAAI,CAgBf;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EAAE,EAChB,KAAK,GAAE,MAAuB,EAC9B,MAAM,GAAE,MAAwB,EAChC,OAAO,GAAE,MAAyB,GACjC,MAAM,GAAG,IAAI,CA4Bf;AAQD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAMD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;CACZ;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,cAAc,GAAG,IAAI,CAQpE;AAMD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAA;IACd,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAA;IAChB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAA;IAClB,kCAAkC;IAClC,OAAO,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAA;IACnC,yCAAyC;IACzC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAA;CAC7B;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,CAAC,EAAE,gBAAgB,GACzB,aAAa,GAAG,IAAI,CActB"}