adonisjs-server-stats 1.5.4 → 1.6.2

package/dist/configure.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configure.d.ts","sourceRoot":"","sources":["../configure.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,SAAS,MAAM,mCAAmC,CAAA;AAE9D,wBAAsB,SAAS,CAAC,OAAO,EAAE,SAAS,iBAWjD"}
+{"version":3,"file":"configure.d.ts","sourceRoot":"","sources":["../configure.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,SAAS,MAAM,mCAAmC,CAAA;AAO9D,wBAAsB,SAAS,CAAC,OAAO,EAAE,SAAS,iBAWjD"}

package/dist/core/api-client.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Error thrown when the server responds with 401 or 403.
+ */
+export declare class UnauthorizedError extends Error {
+    readonly status: number;
+    constructor(status?: number);
+}
+/**
+ * Error thrown for non-OK responses that are not auth-related.
+ */
+export declare class ApiError extends Error {
+    readonly status: number;
+    readonly body: string;
+    constructor(status: number, body: string);
+}
+/**
+ * Configuration for {@link ApiClient}.
+ */
+export interface ApiClientConfig {
+    /** Base URL for all requests (e.g. `''` for same origin, or `'https://api.example.com'`). */
+    baseUrl: string;
+    /** Optional Bearer token. When provided, `credentials` is set to `'omit'`. */
+    authToken?: string;
+}
+/**
+ * Lightweight HTTP client for the server-stats API endpoints.
+ *
+ * Auth strategy:
+ * - If `authToken` is provided, sends `Authorization: Bearer <token>`
+ *   with `credentials: 'omit'` (no cookies).
+ * - Otherwise uses `credentials: 'include'` for cookie-based auth.
+ *
+ * All non-OK responses are thrown as typed errors:
+ * - 401 / 403 -> {@link UnauthorizedError}
+ * - Other non-OK -> {@link ApiError}
+ */
+export declare class ApiClient {
+    private baseUrl;
+    private authToken;
+    constructor(config: ApiClientConfig);
+    /**
+     * Perform a JSON fetch against the configured base URL.
+     *
+     * @param path - URL path appended to `baseUrl` (must start with `/`).
+     * @param init - Optional `RequestInit` overrides. Headers are merged.
+     * @returns Parsed JSON response body typed as `T`.
+     */
+    fetch<T>(path: string, init?: RequestInit): Promise<T>;
+    /**
+     * Perform a GET request.
+     *
+     * @param path   - URL path appended to `baseUrl`.
+     * @param query  - Optional query string (without leading `?`).
+     * @returns Parsed JSON response body typed as `T`.
+     */
+    get<T>(path: string, query?: string): Promise<T>;
+    /**
+     * Perform a POST request with an optional JSON body.
+     *
+     * @param path - URL path appended to `baseUrl`.
+     * @param body - Optional request body (will be JSON-serialized).
+     * @returns Parsed JSON response body typed as `T`.
+     */
+    post<T>(path: string, body?: unknown): Promise<T>;
+    /**
+     * Perform a DELETE request.
+     *
+     * @param path - URL path appended to `baseUrl`.
+     * @returns Parsed JSON response body typed as `T`.
+     */
+    delete<T>(path: string): Promise<T>;
+}
+//# sourceMappingURL=api-client.d.ts.map

package/dist/core/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../src/core/api-client.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,SAAgB,MAAM,EAAE,MAAM,CAAA;gBAElB,MAAM,GAAE,MAAY;CAKjC;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,MAAM,EAAE,MAAM,CAAA;IAC9B,SAAgB,IAAI,EAAE,MAAM,CAAA;gBAEhB,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAMzC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,6FAA6F;IAC7F,OAAO,EAAE,MAAM,CAAA;IACf,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,SAAS,CAAoB;gBAEzB,MAAM,EAAE,eAAe;IAMnC;;;;;;OAMG;IACG,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IA6B5D;;;;;;OAMG;IACG,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAKtD;;;;;;OAMG;IACG,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAavD;;;;;OAKG;IACG,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CAG1C"}

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

@@ -0,0 +1,109 @@
+export interface RedactedValue {
+    __redacted: true;
+    display: string;
+    value: string;
+}
+export type ConfigValue = string | number | boolean | null | undefined | RedactedValue | ConfigValue[] | {
+    [key: string]: ConfigValue;
+};
+export interface FlatEntry {
+    path: string;
+    value: ConfigValue;
+}
+export interface FormattedValue {
+    text: string;
+    color?: string;
+}
+/**
+ * Check whether a config value is a server-redacted object.
+ *
+ * Redacted objects have the shape `{ __redacted: true, display: string, value: string }`.
+ */
+export declare function isRedactedValue(val: ConfigValue): val is RedactedValue;
+/**
+ * Recursively flatten a nested config object into a list of dot-path entries.
+ *
+ * Objects are recursed into; arrays, redacted values, and primitives are
+ * treated as leaf entries.
+ *
+ * @param obj    - The config value to flatten.
+ * @param prefix - Dot-path prefix for keys (default `''`).
+ */
+export declare function flattenConfig(obj: ConfigValue, prefix?: string): FlatEntry[];
+/**
+ * Format a leaf config value for display, returning both text and an
+ * optional CSS color string.
+ *
+ * - `null` / `undefined` -> `"null"` (dim)
+ * - `boolean` -> `"true"` (green) / `"false"` (red)
+ * - `number` -> stringified (amber)
+ * - `array` -> comma-separated items in brackets (purple)
+ * - `object` -> JSON string (dim)
+ * - `string` -> as-is (no color)
+ */
+export declare function formatFlatValue(value: ConfigValue): FormattedValue;
+/**
+ * Count the number of leaf entries in a (possibly nested) config object.
+ *
+ * Primitives, arrays, and redacted objects each count as 1.
+ */
+export declare function countLeaves(obj: ConfigValue): number;
+/**
+ * Return the keys of top-level properties that are plain objects
+ * (i.e. collapsible sections in the config tree).
+ *
+ * Useful for "Expand All" / "Collapse All" functionality.
+ */
+export declare function collectTopLevelObjectKeys(obj: ConfigValue): string[];
+/**
+ * Check if a config entry's key or stringified value matches a search term.
+ *
+ * Matching is case-insensitive. Redacted values are matched against their
+ * display string.
+ *
+ * @param key        - The config key (or dot-path).
+ * @param value      - The config value.
+ * @param searchTerm - Lowercased search term.
+ */
+export declare function matchesConfigSearch(key: string, value: ConfigValue, searchTerm: string): boolean;
+/**
+ * Copy text to the clipboard and briefly show a checkmark on the button.
+ *
+ * This is a DOM-aware helper used by both React and Vue config viewers.
+ *
+ * @param text   - Text to copy.
+ * @param btnRef - The button element to animate (may be `null`).
+ * @param prefix - CSS class prefix (e.g. `"ss-dbg"` or `"ss-dash"`).
+ */
+export declare function copyWithFeedback(text: string, btnRef: HTMLButtonElement | null, prefix: string): void;
+/**
+ * Determine whether a config key (or full dot-path) should be redacted.
+ *
+ * Tokenises the key into individual words and checks each against a
+ * known set of sensitive terms. Case-insensitive.
+ *
+ * @example
+ * ```ts
+ * shouldRedact('stripe.secretKey')   // true  ("secret")
+ * shouldRedact('stripe.publishableKey') // true ("key")
+ * shouldRedact('database.password')  // true  ("password")
+ * shouldRedact('auth.token')         // true  ("auth", "token")
+ * shouldRedact('app.key')            // true  ("key")
+ * shouldRedact('app.name')           // false
+ * shouldRedact('keyboard.layout')    // false ("keyboard" is one word)
+ * shouldRedact('monkey.patch')       // false ("monkey" is one word)
+ * ```
+ */
+export declare function shouldRedact(key: string): boolean;
+/**
+ * Regex pattern matching common secret-like key names.
+ *
+ * @deprecated Use {@link shouldRedact} instead for accurate word-boundary
+ * aware matching that avoids false positives (e.g. "keyboard", "monkey").
+ *
+ * Kept for backward compatibility. The pattern now uses word-boundary
+ * assertions for "key" to reduce false positives, and includes additional
+ * sensitive terms (pass, pwd, encryption).
+ */
+export declare const REDACT_PATTERN: RegExp;
+//# sourceMappingURL=config-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config-utils.d.ts","sourceRoot":"","sources":["../../src/core/config-utils.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,IAAI,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,MAAM,WAAW,GACnB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,GACT,aAAa,GACb,WAAW,EAAE,GACb;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAAA;CAAE,CAAA;AAElC,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,WAAW,CAAA;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAMD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,GAAG,GAAG,IAAI,aAAa,CAOtE;AAMD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,GAAE,MAAW,GAAG,SAAS,EAAE,CAkBhF;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,cAAc,CAkBlE;AAMD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAepD;AAMD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,EAAE,CAuBpE;AAMD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAShG;AAMD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,iBAAiB,GAAG,IAAI,EAChC,MAAM,EAAE,MAAM,GACb,IAAI,CAgBN;AAsDD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAGjD;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,QAC2G,CAAA"}

package/dist/core/constants.d.ts

@@ -0,0 +1,11 @@
+/** Refresh interval for the overview section (ms). */
+export declare const OVERVIEW_REFRESH_MS = 5000;
+/** Refresh interval for other dashboard sections (ms). */
+export declare const SECTION_REFRESH_MS = 10000;
+/** Refresh interval for debug panel tabs (ms). */
+export declare const DEBUG_REFRESH_MS = 3000;
+/** Duration (ms) above which a query/request is considered slow. */
+export declare const SLOW_DURATION_MS = 100;
+/** Duration (ms) above which a query/request is considered very slow. */
+export declare const VERY_SLOW_DURATION_MS = 500;
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AAQA,sDAAsD;AACtD,eAAO,MAAM,mBAAmB,OAAO,CAAA;AAEvC,0DAA0D;AAC1D,eAAO,MAAM,kBAAkB,QAAQ,CAAA;AAEvC,kDAAkD;AAClD,eAAO,MAAM,gBAAgB,OAAO,CAAA;AAMpC,oEAAoE;AACpE,eAAO,MAAM,gBAAgB,MAAM,CAAA;AAEnC,yEAAyE;AACzE,eAAO,MAAM,qBAAqB,MAAM,CAAA"}

package/dist/core/dashboard-api.d.ts

@@ -0,0 +1,65 @@
+import { ApiClient } from './api-client.js';
+/**
+ * High-level API client for dashboard-specific operations.
+ *
+ * Wraps the low-level {@link ApiClient} with domain methods for
+ * chart data, grouped queries, job management, cache operations,
+ * and email previews.
+ */
+export declare class DashboardApi {
+    private client;
+    private basePath;
+    constructor(client: ApiClient, basePath: string);
+    /**
+     * Fetch data for a dashboard section, optionally with a query string.
+     *
+     * @param section     - Section identifier (e.g. `'overview'`, `'queries'`).
+     * @param queryString - Optional query string (without leading `?`).
+     */
+    fetchSection(section: string, queryString?: string): Promise<Record<string, unknown>>;
+    /**
+     * Fetch chart time-series data for the overview section.
+     *
+     * @param range - Time range identifier (e.g. `'1h'`, `'24h'`).
+     */
+    fetchChart(range: string): Promise<Record<string, unknown>>;
+    /**
+     * Fetch grouped/aggregated query patterns.
+     */
+    fetchGroupedQueries(): Promise<Record<string, unknown>[]>;
+    /**
+     * Run EXPLAIN on a specific query by ID.
+     *
+     * @param id - Query record ID.
+     */
+    explainQuery(id: number): Promise<Record<string, unknown>>;
+    /**
+     * Retry a failed job by ID.
+     *
+     * @param id - Job record ID.
+     */
+    retryJob(id: string): Promise<{
+        message: string;
+    }>;
+    /**
+     * Fetch the value of a specific cache key.
+     *
+     * @param key - Cache key (will be URI-encoded).
+     */
+    fetchCacheKey(key: string): Promise<Record<string, unknown>>;
+    /**
+     * Delete a cache entry by key.
+     *
+     * @param key - Cache key (will be URI-encoded).
+     */
+    deleteCacheKey(key: string): Promise<{
+        deleted: boolean;
+    }>;
+    /**
+     * Fetch the HTML preview for an email record.
+     *
+     * @param id - Email record ID.
+     */
+    fetchEmailPreview(id: number): Promise<string>;
+}
+//# sourceMappingURL=dashboard-api.d.ts.map

package/dist/core/dashboard-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-api.d.ts","sourceRoot":"","sources":["../../src/core/dashboard-api.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEhD;;;;;;GAMG;AACH,qBAAa,YAAY;IAErB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,QAAQ;gBADR,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,MAAM;IAG1B;;;;;OAKG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;IAMxD;;;;OAIG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM;IAM9B;;OAEG;IACG,mBAAmB;IAIzB;;;;OAIG;IACG,YAAY,CAAC,EAAE,EAAE,MAAM;IAI7B;;;;OAIG;IACG,QAAQ,CAAC,EAAE,EAAE,MAAM;iBACa,MAAM;;IAK5C;;;;OAIG;IACG,aAAa,CAAC,GAAG,EAAE,MAAM;IAM/B;;;;OAIG;IACG,cAAc,CAAC,GAAG,EAAE,MAAM;iBACM,OAAO;;IAQ7C;;;;OAIG;IACG,iBAAiB,CAAC,EAAE,EAAE,MAAM;CAGnC"}

package/dist/core/dashboard-data-controller.d.ts

@@ -0,0 +1,157 @@
+import { ApiClient } from './api-client.js';
+import { DashboardApi } from './dashboard-api.js';
+import { DashboardSection, PaginatedResponse } from './types.js';
+/**
+ * Callbacks invoked by the controller to push state changes into
+ * the host framework's reactivity layer.
+ */
+export interface DashboardDataCallbacks {
+    /** Called with the latest data payload (or `null` on reset). */
+    onData: (data: unknown) => void;
+    /** Called with pagination meta (or `null` when non-paginated). */
+    onPagination: (meta: PaginatedResponse<unknown>['meta'] | null) => void;
+    /** Called when the loading flag changes. */
+    onLoading: (loading: boolean) => void;
+    /** Called when an error occurs (or `null` to clear). */
+    onError: (error: Error | null) => void;
+    /** Called when an `UnauthorizedError` is detected. */
+    onUnauthorized: () => void;
+}
+/**
+ * Configuration supplied at construction time.
+ */
+export interface DashboardDataControllerConfig {
+    /** Base URL for API requests (e.g. `''` for same origin). */
+    baseUrl: string;
+    /** Dashboard API base path. Defaults to `'/__stats/api'`. */
+    endpoint: string;
+    /** Optional Bearer auth token. */
+    authToken?: string;
+    /** Initial dashboard section to fetch. */
+    section: DashboardSection;
+    /** Items per page. */
+    perPage: number;
+    /** Callbacks that bridge state changes into the host framework. */
+    callbacks: DashboardDataCallbacks;
+}
+/**
+ * Framework-agnostic controller for the dashboard data lifecycle.
+ *
+ * Encapsulates:
+ * - Query parameter building (with camelCase-to-snake_case sort conversion)
+ * - Silent vs non-silent fetch distinction
+ * - Paginated / non-paginated response detection
+ * - `UnauthorizedError` handling with timer cleanup
+ * - Section-aware auto-refresh intervals
+ * - `fetchId` race-condition guard
+ * - `explicitFetchPending` guard to prevent silent fetch races
+ * - Mutation (POST/DELETE) support
+ */
+export declare class DashboardDataController {
+    private client;
+    private api;
+    private callbacks;
+    private endpoint;
+    private perPage;
+    private section;
+    private page;
+    private search;
+    private sort;
+    private sortDir;
+    private filters;
+    private timeRange;
+    private timer;
+    /** Monotonically increasing fetch ID to discard stale responses. */
+    private fetchId;
+    /** Whether a non-silent (explicit) fetch is currently in-flight. */
+    private explicitFetchPending;
+    /** Whether we have successfully fetched data at least once. */
+    private hasFetched;
+    /** Whether the controller has been stopped (disposed). */
+    private stopped;
+    constructor(config: DashboardDataControllerConfig);
+    /**
+     * Start the controller: perform an initial fetch and begin auto-refresh.
+     */
+    start(): void;
+    /**
+     * Stop the controller: clear timers and mark as disposed.
+     * Outstanding in-flight responses will be discarded via fetchId.
+     */
+    stop(): void;
+    /**
+     * Perform a data fetch.
+     *
+     * @param silent - When `true`, errors are swallowed (keeps stale data)
+     *   and loading state is not modified.
+     */
+    fetch(silent?: boolean): Promise<void>;
+    /**
+     * Change the active section. Resets pagination, filters, sort, and
+     * performs a full (non-silent) fetch.
+     */
+    setSection(section: DashboardSection): void;
+    /**
+     * Navigate to a specific page. Triggers a non-silent fetch.
+     */
+    setPage(page: number): void;
+    /**
+     * Update the search query. Resets to page 1. Triggers a non-silent fetch.
+     */
+    setSearch(search: string): void;
+    /**
+     * Set a filter key-value pair. Resets to page 1. Triggers a non-silent fetch.
+     */
+    setFilter(key: string, value: string | number | boolean): void;
+    /**
+     * Update sort column and direction. Triggers a non-silent fetch.
+     *
+     * If the same column is passed without a direction, toggles asc/desc.
+     */
+    setSort(column: string, direction?: 'asc' | 'desc'): void;
+    /**
+     * Update the time range. Triggers a non-silent fetch.
+     */
+    setTimeRange(range: string): void;
+    /**
+     * Execute a mutation (POST/DELETE) against the dashboard API,
+     * then silently refresh the current data.
+     */
+    mutate(path: string, method?: 'post' | 'delete', body?: unknown): Promise<unknown>;
+    /**
+     * Bulk-update query parameters without triggering a fetch.
+     *
+     * Used by props-driven frameworks (React) where the host component
+     * controls pagination/search/sort state externally and passes it in
+     * as props on each render cycle.
+     */
+    configure(params: {
+        page?: number;
+        perPage?: number;
+        search?: string;
+        sort?: string;
+        sortDir?: 'asc' | 'desc';
+        filters?: Record<string, string>;
+        timeRange?: string;
+    }): void;
+    /**
+     * Whether data has been fetched at least once.
+     */
+    hasData(): boolean;
+    /**
+     * Handle an external signal (e.g. SSE refreshKey) by performing
+     * a silent refresh if data has already been fetched once.
+     */
+    handleRefreshSignal(): void;
+    /**
+     * Get the underlying `DashboardApi` instance for direct API calls.
+     */
+    getApi(): DashboardApi;
+    /**
+     * Get the underlying `ApiClient` instance.
+     */
+    getClient(): ApiClient;
+    private startRefreshTimer;
+    private stopRefreshTimer;
+}
+//# sourceMappingURL=dashboard-data-controller.d.ts.map

package/dist/core/dashboard-data-controller.d.ts.map

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

package/dist/core/debug-data-controller.d.ts

@@ -0,0 +1,89 @@
+import { UnauthorizedError } from './api-client.js';
+/**
+ * Callback configuration for {@link DebugDataController}.
+ *
+ * The controller itself holds no UI state — it communicates every
+ * state change through these callbacks so the framework wrapper
+ * (React hook / Vue composable) can update its own reactive state.
+ */
+export interface DebugDataControllerCallbacks<T = unknown> {
+    /** Called with the parsed JSON payload after a successful fetch. */
+    onData: (data: T) => void;
+    /** Called whenever the loading flag changes. */
+    onLoading: (loading: boolean) => void;
+    /** Called with an `Error` (or `null` to clear) on fetch failure. */
+    onError: (error: Error | null) => void;
+    /** Called when the server responds with 401/403. */
+    onUnauthorized: (error: UnauthorizedError) => void;
+}
+/**
+ * Configuration for {@link DebugDataController}.
+ */
+export interface DebugDataControllerConfig<T = unknown> extends DebugDataControllerCallbacks<T> {
+    /** Base URL for API requests (e.g. `''` for same-origin). */
+    baseUrl: string;
+    /** Debug API endpoint base path (default `'/admin/api/debug'`). */
+    endpoint?: string;
+    /** Optional Bearer token. */
+    authToken?: string;
+    /** Auto-refresh interval in ms (default {@link DEBUG_REFRESH_MS}). */
+    refreshInterval?: number;
+}
+/**
+ * Framework-agnostic controller that owns the debug-tab data
+ * fetching lifecycle: initial fetch, auto-refresh timer, fetchOnce
+ * cache, and `UnauthorizedError` handling.
+ *
+ * Designed to be instantiated once per component mount and driven
+ * by a thin framework wrapper that bridges the callbacks to the
+ * framework's reactive primitives.
+ */
+export declare class DebugDataController<T = unknown> {
+    private client;
+    private endpoint;
+    private refreshInterval;
+    private callbacks;
+    private timer;
+    private currentTab;
+    private fetchOnceCache;
+    constructor(config: DebugDataControllerConfig<T>);
+    /**
+     * Begin fetching data for `tab` and start the auto-refresh timer.
+     *
+     * If a timer is already running it will be stopped first.
+     */
+    start(tab: string): void;
+    /**
+     * Stop the auto-refresh timer.
+     */
+    stop(): void;
+    /**
+     * Switch to a different tab.
+     *
+     * Stops the current timer, resets loading/error state, and starts
+     * fetching for the new tab.
+     */
+    switchTab(tab: string): void;
+    /**
+     * Force an immediate re-fetch of the current tab (ignoring the
+     * fetchOnce cache).
+     */
+    refresh(): void;
+    /**
+     * Fetch a custom pane endpoint.  Optionally honours the fetchOnce
+     * cache so a pane that has already been loaded is not re-requested.
+     */
+    fetchCustomPane(panePath: string, fetchOnce?: boolean): Promise<void>;
+    /**
+     * Store a value in the fetchOnce cache for a given tab name.
+     * Subsequent `start()` / `switchTab()` calls for this tab will
+     * serve the cached value instead of hitting the network.
+     */
+    cacheForTab(tabName: string, data: unknown): void;
+    /**
+     * Clear all cached fetchOnce data.
+     */
+    clearCache(): void;
+    private fetchData;
+}
+//# sourceMappingURL=debug-data-controller.d.ts.map

package/dist/core/debug-data-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-data-controller.d.ts","sourceRoot":"","sources":["../../src/core/debug-data-controller.ts"],"names":[],"mappings":"AAUA,OAAO,EAAa,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAI9D;;;;;;GAMG;AACH,MAAM,WAAW,4BAA4B,CAAC,CAAC,GAAG,OAAO;IACvD,oEAAoE;IACpE,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAA;IACzB,gDAAgD;IAChD,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;IACrC,oEAAoE;IACpE,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,KAAK,IAAI,CAAA;IACtC,oDAAoD;IACpD,cAAc,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAA;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,4BAA4B,CAAC,CAAC,CAAC;IAC7F,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAA;IACf,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,sEAAsE;IACtE,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED;;;;;;;;GAQG;AACH,qBAAa,mBAAmB,CAAC,CAAC,GAAG,OAAO;IAC1C,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,SAAS,CAAiC;IAElD,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,UAAU,CAAsB;IACxC,OAAO,CAAC,cAAc,CAA8B;gBAExC,MAAM,EAAE,yBAAyB,CAAC,CAAC,CAAC;IAmBhD;;;;OAIG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IASxB;;OAEG;IACH,IAAI,IAAI,IAAI;IAOZ;;;;;OAKG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI5B;;;OAGG;IACH,OAAO,IAAI,IAAI;IAMf;;;OAGG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BlF;;;;OAIG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAIjD;;OAEG;IACH,UAAU,IAAI,IAAI;YAQJ,SAAS;CA6BxB"}

package/dist/core/feature-detect.d.ts

@@ -0,0 +1,67 @@
+import { ApiClient } from './api-client.js';
+import { FeatureFlags, FeatureConfig } from './types.js';
+/**
+ * Default flattened feature config used before the config endpoint responds.
+ *
+ * All features default to `false` so the UI starts in a minimal state
+ * and progressively enables sections as the server confirms support.
+ */
+export declare const DEFAULT_FEATURES: FeatureConfig;
+/**
+ * Fetch feature flags and configuration from the server.
+ *
+ * Calls `GET {debugEndpoint}/config` and returns the full
+ * {@link FeatureFlags} response, which tells the UI which
+ * sections to render and where to find endpoints.
+ *
+ * @param apiClient      - Configured {@link ApiClient} instance.
+ * @param debugEndpoint  - Base path for the debug API. Defaults to `'/admin/api/debug'`.
+ * @returns The parsed feature flags.
+ */
+export declare function fetchFeatures(apiClient: ApiClient, debugEndpoint?: string): Promise<FeatureFlags>;
+/**
+ * Convenience wrapper around {@link fetchFeatures} that accepts flat options
+ * instead of a pre-built {@link ApiClient}.
+ *
+ * Used by React / Vue hooks that pass simple option objects.
+ * Returns a flattened {@link FeatureConfig} for easy property access.
+ *
+ * @param options - Connection options (baseUrl, debugEndpoint, authToken).
+ * @returns The flattened feature config, or {@link DEFAULT_FEATURES} on error.
+ */
+export declare function detectFeatures(options: {
+    baseUrl?: string;
+    debugEndpoint?: string;
+    authToken?: string;
+}): Promise<FeatureConfig>;
+/**
+ * Determine which metric groups should be visible based on feature flags.
+ *
+ * Returns a `Set` of group identifiers that the stats bar should display.
+ * Groups include: `'process'`, `'memory'`, `'http'`, `'db'`, `'app'`, `'redis'`, `'queue'`, `'log'`.
+ *
+ * Accepts either a nested {@link FeatureFlags} or a flat {@link FeatureConfig}.
+ *
+ * @param features - The resolved feature flags (nested or flat).
+ * @returns A set of visible metric group names.
+ */
+export declare function getVisibleMetricGroups(features: FeatureFlags | FeatureConfig): Set<string>;
+/**
+ * Detect which metric groups should be visible based on the actual stats
+ * data received from the server.
+ *
+ * This is used as the primary mechanism for the stats bar to determine
+ * which groups to show, mirroring the old vanilla JS behavior where
+ * groups were displayed based on what data the server actually sends.
+ *
+ * Unlike {@link getVisibleMetricGroups} which relies on the debug config
+ * endpoint, this function inspects the stats payload directly. This
+ * ensures groups are shown even when the debug endpoint is unavailable
+ * or not configured (e.g. when `showDebug` is false).
+ *
+ * @param stats - The server stats snapshot (partial, since not all fields
+ *                may be present depending on configured collectors).
+ * @returns A set of visible metric group names.
+ */
+export declare function detectMetricGroupsFromStats(stats: Record<string, unknown>): Set<string>;
+//# sourceMappingURL=feature-detect.d.ts.map

package/dist/core/feature-detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-detect.d.ts","sourceRoot":"","sources":["../../src/core/feature-detect.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE3C,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAO7D;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,aAc9B,CAAA;AAuBD;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,SAAS,EACpB,aAAa,GAAE,MAA+B,GAC7C,OAAO,CAAC,YAAY,CAAC,CAGvB;AAED;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,GAAG,OAAO,CAAC,aAAa,CAAC,CASzB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,YAAY,GAAG,aAAa,GAAG,GAAG,CAAC,MAAM,CAAC,CAsB1F;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAiEvF"}